import { BUILT_IN_BROWSER_PROFILES, DEFAULT_BROWSER_PROFILE_ID, DEFAULT_PREVIEW_APPEARANCE, DEFAULT_PREVIEW_ZOOM_FACTOR, EnvironmentId, FILL_PREVIEW_VIEWPORT, ThreadId, } from "@t3tools/contracts"; import { act, Profiler } from "react"; import { renderToStaticMarkup } from "react-dom/server"; import { beforeEach, describe, expect, it, vi } from "vite-plus/test"; const mocks = vi.hoisted(() => ({ navigate: vi.fn(async (_tabId: string, _url: string): Promise => undefined), rememberPreviewUrl: vi.fn(), readPreparedConnection: vi.fn(() => ({ httpBaseUrl: "http://172.25.85.75:3773" })), submittedUrl: null as ((url: string) => void) | null, emptyStateUrl: null as ((url: string) => void) | null, togglePictureInPicture: null as (() => void) | null, toggleNativePictureInPicture: null as (() => void) | null, pictureInPicturePressed: false, miniPlayerTabId: null as string | null, openMiniPlayer: vi.fn(), closeMiniPlayer: vi.fn(), closeRightPanel: vi.fn(), openPictureInPicture: vi.fn(async (_tabId: string): Promise => undefined), closePictureInPicture: vi.fn(async (_tabId: string): Promise => undefined), pickElement: vi.fn(), capturePreviewAnnotationScreenshot: vi.fn(), addPreviewAnnotation: vi.fn(), addImage: vi.fn(), toggleAnnotation: null as (() => void) | null, pictureInPicture: false, showEmptyState: false, loading: false, recordVisitForThread: vi.fn(), })); const EMPTY_HISTORY: never[] = []; const STUB_BROWSER_DEFAULTS = { viewport: FILL_PREVIEW_VIEWPORT, zoomFactor: DEFAULT_PREVIEW_ZOOM_FACTOR, appearance: DEFAULT_PREVIEW_APPEARANCE, autoShowFloatingPreview: true, profiles: BUILT_IN_BROWSER_PROFILES, profileId: DEFAULT_BROWSER_PROFILE_ID, }; vi.mock("~/browserHistoryStore", () => ({ recordVisitForThread: mocks.recordVisitForThread, setTitleForThreadUrl: vi.fn(), removeUrlForThread: vi.fn(), BROWSER_HISTORY_MAX_ENTRIES_PER_PROJECT: 50, useThreadRecentHistory: () => EMPTY_HISTORY, })); vi.mock("~/state/session", async (importOriginal) => ({ ...(await importOriginal()), readPreparedConnection: mocks.readPreparedConnection, })); // Stubbed at the direct dependency rather than letting the real module pull in // `useSettings` -> `state/server`, which would drag the whole settings and // connection graph into a test that only cares about the browser chrome. vi.mock("~/browser/browserDefaults", () => ({ useBrowserDefaults: () => STUB_BROWSER_DEFAULTS, getBrowserDefaults: () => STUB_BROWSER_DEFAULTS, browserDefaultOpenViewport: () => FILL_PREVIEW_VIEWPORT, browserDefaultOpenProfileId: () => DEFAULT_BROWSER_PROFILE_ID, browserDefaultTabState: () => ({ zoomFactor: DEFAULT_PREVIEW_ZOOM_FACTOR, colorScheme: DEFAULT_PREVIEW_APPEARANCE, }), browserResponsiveViewportForToggle: () => ({ _tag: "freeform" as const, width: 1024, height: 768, }), })); vi.mock("~/composerDraftStore", () => ({ useComposerDraftStore: ( select: (store: { addPreviewAnnotation: () => void; addImage: () => void }) => unknown, ) => select({ addPreviewAnnotation: mocks.addPreviewAnnotation, addImage: mocks.addImage, }), })); vi.mock("~/lib/previewAnnotation", () => ({ capturePreviewAnnotationScreenshot: mocks.capturePreviewAnnotationScreenshot, })); vi.mock("~/localApi", () => ({ ensureLocalApi: vi.fn(), })); vi.mock("~/previewStateStore", () => ({ rememberPreviewUrl: mocks.rememberPreviewUrl, updatePreviewServerSnapshot: vi.fn(), useThreadPreviewState: () => ({ activeTabId: "tab-1", desktopByTabId: { "tab-1": { hasWebContents: true, canGoBack: false, canGoForward: false, loading: mocks.loading, zoomFactor: 1, pictureInPicture: mocks.pictureInPicture, colorScheme: "system", audioMuted: false, audible: false, controller: "none", }, }, recentlySeenUrls: [], sessions: mocks.showEmptyState ? {} : { "tab-1": { threadId: "thread-1", tabId: "tab-1", navStatus: { _tag: "Success", url: "http://example.com/", title: "Example", }, canGoBack: false, canGoForward: false, updatedAt: "2026-07-13T00:00:00.000Z", }, }, }), })); vi.mock("~/state/environments", () => ({ useEnvironment: () => ({ label: "WSL" }), useEnvironmentHttpBaseUrl: () => "http://172.25.85.75:3773", })); vi.mock("~/state/preview", () => ({ previewEnvironment: { open: {}, resize: {} }, })); vi.mock("~/state/use-atom-command", () => ({ useAtomCommand: () => vi.fn(), })); vi.mock("~/browser/browserRecording", () => ({ findActiveBrowserRecordingRuntimeTabId: vi.fn(() => null), isBrowserRecordingStartCancelledError: vi.fn(() => false), startBrowserRecording: vi.fn(), stopBrowserRecording: vi.fn(), useActiveBrowserRecordingTabIds: () => new Set(), })); vi.mock("~/browser/browserSurfaceStore", () => ({ useBrowserSurfaceStore: ( select: (state: { byTabId: Record }) => unknown, ) => select({ byTabId: {} }), })); vi.mock("~/previewMiniPlayerStore", () => { const usePreviewMiniPlayerStore = Object.assign( (select: (state: unknown) => unknown) => select({ byThreadKey: mocks.miniPlayerTabId ? { "environment-1:thread-1": { tabId: mocks.miniPlayerTabId, position: null, }, } : {}, }), { getState: () => ({ open: mocks.openMiniPlayer, close: mocks.closeMiniPlayer, }), }, ); return { selectThreadPreviewMiniPlayer: ( byThreadKey: Record, ) => byThreadKey["environment-1:thread-1"] ?? null, usePreviewMiniPlayerStore, }; }); vi.mock("~/rightPanelStore", () => ({ useRightPanelStore: { getState: () => ({ close: mocks.closeRightPanel }), }, })); vi.mock("~/components/ui/toast", () => ({ stackedThreadToast: vi.fn(), toastManager: { add: vi.fn() }, })); vi.mock("./previewBridge", () => ({ previewBridge: { navigate: mocks.navigate, pickElement: mocks.pickElement, pictureInPicture: { open: mocks.openPictureInPicture, close: mocks.closePictureInPicture, }, }, })); vi.mock("./PreviewChromeRow", () => ({ PreviewChromeRow: (props: { onSubmit: (url: string) => void; onPickElement?: () => void; onPictureInPicture?: () => void; pictureInPicture?: boolean; trailingActions?: { props: { onNativePictureInPicture?: () => void }; }; }) => { mocks.submittedUrl = props.onSubmit; mocks.toggleAnnotation = props.onPickElement ?? null; mocks.togglePictureInPicture = props.onPictureInPicture ?? null; mocks.toggleNativePictureInPicture = props.trailingActions?.props.onNativePictureInPicture ?? null; mocks.pictureInPicturePressed = props.pictureInPicture ?? false; return null; }, })); vi.mock("./PreviewEmptyState", () => ({ PreviewEmptyState: (props: { onOpenUrl: (url: string) => void }) => { mocks.emptyStateUrl = props.onOpenUrl; return null; }, })); vi.mock("./PreviewMoreMenu", () => ({ PreviewMoreMenu: (props: { onNativePictureInPicture: () => void }) => { mocks.toggleNativePictureInPicture = props.onNativePictureInPicture; return null; }, })); vi.mock("./PreviewUnreachable", () => ({ PreviewUnreachable: () => null })); vi.mock("./ZoomIndicator", () => ({ ZoomIndicator: () => null })); vi.mock("./AgentBrowserCursor", () => ({ AgentBrowserCursor: () => null })); vi.mock("~/browser/BrowserSurfaceSlot", () => ({ BrowserSurfaceSlot: () => null })); vi.mock("./usePreviewSession", () => ({ usePreviewSession: vi.fn() })); import { PreviewView } from "./PreviewView"; import { toastManager } from "~/components/ui/toast"; import { previewRuntimeTabId } from "~/browser/previewRuntimeTabId"; const TEST_THREAD_REF = { environmentId: EnvironmentId.make("environment-1"), threadId: ThreadId.make("thread-1"), } as const; const TEST_RUNTIME_TAB_ID = previewRuntimeTabId(TEST_THREAD_REF, null, "tab-1"); // ReactDOM needs a host, but this unit suite intentionally has no DOM dependency. class TestNode { parentNode: TestNode | null = null; childNodes: TestNode[] = []; readonly nodeName: string; readonly tagName: string; readonly namespaceURI = "http://www.w3.org/1999/xhtml"; readonly style = {}; constructor( name: string, readonly ownerDocument: TestNode | null = null, readonly nodeType = 1, ) { this.nodeName = name.toUpperCase(); this.tagName = this.nodeName; } set textContent(_value: string) { this.childNodes = []; } appendChild(child: TestNode) { child.parentNode = this; this.childNodes.push(child); return child; } removeChild(child: TestNode) { this.childNodes.splice(this.childNodes.indexOf(child), 1); child.parentNode = null; return child; } createElement(name: string) { return new TestNode(name, this); } addEventListener() {} removeEventListener() {} setAttribute() {} } function installTestDom() { const document = new TestNode("#document", null, 9); const window = { document, HTMLIFrameElement: TestNode, setInterval: globalThis.setInterval, clearInterval: globalThis.clearInterval, setTimeout: globalThis.setTimeout, clearTimeout: globalThis.clearTimeout, addEventListener() {}, removeEventListener() {}, }; vi.stubGlobal("document", document); vi.stubGlobal("window", window); vi.stubGlobal("HTMLIFrameElement", window.HTMLIFrameElement); vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true); return document; } describe("PreviewView navigation", () => { beforeEach(() => { mocks.navigate.mockClear(); mocks.rememberPreviewUrl.mockClear(); mocks.readPreparedConnection.mockClear(); mocks.submittedUrl = null; mocks.emptyStateUrl = null; mocks.togglePictureInPicture = null; mocks.toggleNativePictureInPicture = null; mocks.pictureInPicturePressed = false; mocks.miniPlayerTabId = null; mocks.openMiniPlayer.mockClear(); mocks.closeMiniPlayer.mockClear(); mocks.closeRightPanel.mockClear(); mocks.openPictureInPicture.mockClear(); mocks.closePictureInPicture.mockClear(); mocks.pickElement.mockReset(); mocks.capturePreviewAnnotationScreenshot.mockReset(); mocks.capturePreviewAnnotationScreenshot.mockResolvedValue({ status: "none" }); mocks.addPreviewAnnotation.mockClear(); vi.mocked(toastManager.add).mockClear(); mocks.addImage.mockClear(); mocks.toggleAnnotation = null; mocks.pictureInPicture = false; mocks.showEmptyState = false; mocks.loading = false; mocks.recordVisitForThread.mockClear(); }); it("does not rerender while loading time passes", async () => { vi.useFakeTimers(); mocks.loading = true; const document = installTestDom(); const { createRoot } = await import("react-dom/client"); const root = createRoot(document.createElement("div") as unknown as Element); const onRender = vi.fn(); try { await act(() => { root.render( , ); }); const initialRenderCount = onRender.mock.calls.length; await act(() => vi.advanceTimersByTimeAsync(1_000)); expect(onRender).toHaveBeenCalledTimes(initialRenderCount); } finally { await act(() => root.unmount()); vi.useRealTimers(); vi.unstubAllGlobals(); } }); it.each([ [ "https://localhost:8000/dashboard?mode=test#top", "https://localhost:8000/dashboard?mode=test#top", ], ["localhost:5173/app", "http://localhost:5173/app"], ])("preserves a direct localhost URL in a WSL environment", async (submitted, expected) => { renderToStaticMarkup( , ); expect(mocks.submittedUrl).not.toBeNull(); mocks.submittedUrl?.(submitted); await vi.waitFor(() => expect(mocks.navigate).toHaveBeenCalledWith(TEST_RUNTIME_TAB_ID, expected), ); expect(mocks.rememberPreviewUrl).toHaveBeenCalledWith( { environmentId: "environment-1", threadId: "thread-1", }, expected, ); }); it("records a history visit with the normalized requested url on submit", async () => { renderToStaticMarkup( , ); mocks.submittedUrl?.("localhost:3000/admin"); await vi.waitFor(() => { expect(mocks.recordVisitForThread).toHaveBeenCalledWith( expect.objectContaining({ threadId: expect.anything() }), "http://localhost:3000/admin", ); }); }); it("maps an empty-state localhost server onto the WSL host", async () => { mocks.showEmptyState = true; renderToStaticMarkup( , ); expect(mocks.emptyStateUrl).not.toBeNull(); mocks.emptyStateUrl?.("http://localhost:5173/app?mode=test#top"); await vi.waitFor(() => expect(mocks.navigate).toHaveBeenCalledWith( TEST_RUNTIME_TAB_ID, "http://172.25.85.75:5173/app?mode=test#top", ), ); expect(mocks.rememberPreviewUrl).toHaveBeenCalledWith( { environmentId: "environment-1", threadId: "thread-1", }, "http://172.25.85.75:5173/app?mode=test#top", ); await vi.waitFor(() => expect(mocks.recordVisitForThread).toHaveBeenCalledWith( expect.objectContaining({ threadId: expect.anything() }), "http://localhost:5173/app?mode=test#top", ), ); }); it("opens and closes a thread-scoped floating preview for the active tab", async () => { const props = { threadRef: { environmentId: EnvironmentId.make("environment-1"), threadId: ThreadId.make("thread-1"), }, tabId: "tab-1", visible: true, } as const; renderToStaticMarkup(); expect(mocks.pictureInPicturePressed).toBe(false); mocks.togglePictureInPicture?.(); expect(mocks.openMiniPlayer).toHaveBeenCalledWith(props.threadRef, "tab-1"); expect(mocks.closeRightPanel).toHaveBeenCalledWith(props.threadRef); mocks.miniPlayerTabId = "tab-1"; renderToStaticMarkup(); expect(mocks.pictureInPicturePressed).toBe(true); mocks.togglePictureInPicture?.(); expect(mocks.closeMiniPlayer).toHaveBeenCalledWith(props.threadRef); }); it("keeps the native preview window as a secondary action", async () => { const props = { threadRef: { environmentId: EnvironmentId.make("environment-1"), threadId: ThreadId.make("thread-1"), }, tabId: "tab-1", visible: true, } as const; renderToStaticMarkup(); mocks.toggleNativePictureInPicture?.(); await vi.waitFor(() => expect(mocks.openPictureInPicture).toHaveBeenCalledWith(TEST_RUNTIME_TAB_ID), ); mocks.pictureInPicture = true; renderToStaticMarkup(); mocks.toggleNativePictureInPicture?.(); await vi.waitFor(() => expect(mocks.closePictureInPicture).toHaveBeenCalledWith(TEST_RUNTIME_TAB_ID), ); }); it("forwards Cmd/Ctrl+Enter annotations to the composer send path", async () => { const annotation = { id: "annotation-1", pageUrl: "https://example.com/dashboard", pageTitle: "Dashboard", comment: "Tighten this spacing", elements: [], regions: [], strokes: [], styleChanges: [], screenshot: null, createdAt: "2026-07-27T00:00:00.000Z", }; const onSendAnnotation = vi.fn(); mocks.pickElement.mockResolvedValue({ annotation, submission: "send" }); renderToStaticMarkup( , ); mocks.toggleAnnotation?.(); await vi.waitFor(() => expect(onSendAnnotation).toHaveBeenCalledWith(annotation, null)); expect(mocks.addPreviewAnnotation).toHaveBeenCalledWith(TEST_THREAD_REF, annotation); }); it("warns when main dropped the crop before handing over the pick", async () => { const annotation = { id: "annotation-3", pageUrl: "https://example.com/dashboard", pageTitle: "Dashboard", comment: "Tighten this spacing", elements: [], regions: [], strokes: [], styleChanges: [], screenshot: null, createdAt: "2026-07-27T00:00:00.000Z", }; const onSendAnnotation = vi.fn(); mocks.pickElement.mockResolvedValue({ annotation, submission: "send", screenshotFailed: true }); renderToStaticMarkup( , ); mocks.toggleAnnotation?.(); await vi.waitFor(() => expect(onSendAnnotation).toHaveBeenCalledWith(annotation, null)); // A null screenshot alone looks like a comment-only pick; the flag is what // separates "no crop requested" from "crop lost to a timeout". expect(toastManager.add).toHaveBeenCalledTimes(1); }); it("still sends when the picked element's crop cannot be captured", async () => { const annotation = { id: "annotation-2", pageUrl: "https://example.com/dashboard", pageTitle: "Dashboard", comment: "Tighten this spacing", elements: [], regions: [], strokes: [], styleChanges: [], screenshot: { dataUrl: "data:image/png;base64,c2NyZWVuc2hvdA==", width: 10, height: 10, cropRect: { x: 0, y: 0, width: 10, height: 10 }, }, createdAt: "2026-07-27T00:00:00.000Z", }; const onSendAnnotation = vi.fn(); mocks.pickElement.mockResolvedValue({ annotation, submission: "send" }); mocks.capturePreviewAnnotationScreenshot.mockResolvedValue({ status: "failed" }); renderToStaticMarkup( , ); mocks.toggleAnnotation?.(); // The forwarded and stored annotation both drop the screenshot, so the // prompt does not claim a crop that was never attached. const sent = { ...annotation, screenshot: null }; await vi.waitFor(() => expect(onSendAnnotation).toHaveBeenCalledWith(sent, null)); expect(mocks.addPreviewAnnotation).toHaveBeenCalledWith(TEST_THREAD_REF, sent); expect(mocks.addImage).not.toHaveBeenCalled(); }); });