@stigmer/react 3.35.0 → 3.37.0

package/src/workspace/__tests__/WorkspaceSurface.test.tsx

@@ -1,531 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { render, screen, cleanup, fireEvent, within } from "@testing-library/react";
-import { forwardRef } from "react";
-
-// ---------------------------------------------------------------------------
-// WorkspaceSurface composes the activity rail (Explorer / Search), a resizable
-// sidebar, and the read-only editor. The explorer tree, search, and viewer are
-// exercised by their own suites; here we mock them as probes and prove the
-// surface's own composition — rail switching, the editor tabs/toolbar, collapse,
-// breadcrumbs, and that the active file (+ its change) reaches a chrome-less
-// FileViewer.
-// ---------------------------------------------------------------------------
-
-type CapturedProps = Record<string, unknown>;
-
-const viewerProps: CapturedProps[] = [];
-vi.mock("../FileViewer", () => ({
-  FileViewer: forwardRef((props: CapturedProps, _ref) => {
-    viewerProps.push(props);
-    return <div data-testid="viewer-probe" />;
-  }),
-}));
-
-vi.mock("../ExplorerTree", () => ({
-  ExplorerTree: () => <div data-testid="explorer-probe" />,
-}));
-
-vi.mock("../WorkspaceFileSearch", () => ({
-  WorkspaceFileSearch: () => <div data-testid="search-probe" />,
-}));
-
-vi.mock("../WorkspaceContentSearch", () => ({
-  WorkspaceContentSearch: () => <div data-testid="content-search-probe" />,
-}));
-
-import { WorkspaceSurface } from "../WorkspaceSurface";
-import { virtualEntryId } from "../../internal/store/index.js";
-import type { WorkspaceEntry } from "../useWorkspaceEntries";
-import type { WorkspaceFileLister } from "../WorkspaceFileLister";
-import type { WorkspaceFileReader } from "../WorkspaceFileReader";
-import type { WorkspaceContentSearcher } from "../WorkspaceContentSearcher";
-
-const gitEntry: WorkspaceEntry = {
-  id: "e1",
-  name: "acme/app",
-  type: "git",
-  gitUrl: "https://github.com/acme/app.git",
-  gitBranch: "main",
-} as WorkspaceEntry;
-
-const lister: WorkspaceFileLister = vi.fn(async () => []) as unknown as WorkspaceFileLister;
-const reader: WorkspaceFileReader = vi.fn(async () => null) as unknown as WorkspaceFileReader;
-const searcher: WorkspaceContentSearcher = vi.fn(async () => ({
-  matches: [],
-  truncated: false,
-})) as unknown as WorkspaceContentSearcher;
-
-function renderSurface(overrides: Partial<React.ComponentProps<typeof WorkspaceSurface>> = {}) {
-  const onOpenFile = vi.fn();
-  const onActivateEditor = vi.fn();
-  const onPinEditor = vi.fn();
-  const onCloseEditor = vi.fn();
-  const onCollapse = vi.fn();
-  render(
-    <WorkspaceSurface
-      entries={[gitEntry]}
-      lister={lister}
-      reader={reader}
-      editors={[{ entryId: "e1", path: "src/main.go", preview: false }]}
-      selectedFile={{ entryId: "e1", path: "src/main.go" }}
-      onOpenFile={onOpenFile}
-      onActivateEditor={onActivateEditor}
-      onPinEditor={onPinEditor}
-      onCloseEditor={onCloseEditor}
-      onCollapse={onCollapse}
-      {...overrides}
-    />,
-  );
-  return { onOpenFile, onActivateEditor, onPinEditor, onCloseEditor, onCollapse };
-}
-
-beforeEach(() => {
-  viewerProps.length = 0;
-});
-afterEach(() => {
-  cleanup();
-  vi.clearAllMocks();
-});
-
-describe("WorkspaceSurface", () => {
-  it("renders the activity rail with Explorer selected by default", () => {
-    renderSurface();
-    const explorer = screen.getByRole("radio", { name: "Explorer" });
-    const search = screen.getByRole("radio", { name: "Search" });
-    expect(explorer.getAttribute("aria-checked")).toBe("true");
-    expect(search.getAttribute("aria-checked")).toBe("false");
-    // Explorer view: the explorer tree renders; the search surface does not.
-    expect(screen.getByTestId("explorer-probe")).toBeTruthy();
-    expect(screen.queryByTestId("search-probe")).toBeNull();
-  });
-
-  it("switches to the search surface when Search is selected", () => {
-    renderSurface();
-    fireEvent.click(screen.getByRole("radio", { name: "Search" }));
-    expect(screen.getByTestId("search-probe")).toBeTruthy();
-    expect(screen.queryByTestId("explorer-probe")).toBeNull();
-  });
-
-  it("shows only filename search (no Name|Text toggle) when no content searcher is injected", () => {
-    renderSurface();
-    fireEvent.click(screen.getByRole("radio", { name: "Search" }));
-    expect(screen.queryByRole("radiogroup", { name: "Search mode" })).toBeNull();
-    expect(screen.getByTestId("search-probe")).toBeTruthy();
-    expect(screen.queryByTestId("content-search-probe")).toBeNull();
-  });
-
-  it("offers a Name|Text toggle when a content searcher is injected, routing Text to content search", () => {
-    renderSurface({ searcher });
-    fireEvent.click(screen.getByRole("radio", { name: "Search" }));
-
-    const toggle = screen.getByRole("radiogroup", { name: "Search mode" });
-    expect(toggle).toBeTruthy();
-    // Filename search is the default mode.
-    expect(screen.getByTestId("search-probe")).toBeTruthy();
-    expect(screen.queryByTestId("content-search-probe")).toBeNull();
-
-    // Switching to Text routes to the content-search surface.
-    fireEvent.click(within(toggle).getByRole("radio", { name: "Text" }));
-    expect(screen.getByTestId("content-search-probe")).toBeTruthy();
-    expect(screen.queryByTestId("search-probe")).toBeNull();
-  });
-
-  it("hands the open file (and its change) to a chrome-less FileViewer", () => {
-    const change = { path: "src/main.go" } as never;
-    renderSurface({ change });
-    const props = viewerProps.at(-1);
-    expect(props?.selectedFile).toEqual({ entryId: "e1", path: "src/main.go" });
-    expect(props?.showHeader).toBe(false);
-    expect(props?.change).toBe(change);
-  });
-
-  it("forwards a jump-to-line reveal to the FileViewer", () => {
-    const reveal = { line: 12, nonce: 3 };
-    renderSurface({ reveal });
-    expect(viewerProps.at(-1)?.reveal).toBe(reveal);
-  });
-
-  it("shows the open file as a tab", () => {
-    renderSurface();
-    const tab = screen.getByRole("tab", { name: /main\.go/ });
-    expect(tab).toBeTruthy();
-    expect(tab.getAttribute("aria-selected")).toBe("true");
-  });
-
-  it("associates the active tab with the single editor tabpanel", () => {
-    renderSurface();
-    const tab = screen.getByRole("tab", { name: /main\.go/ });
-    const panel = screen.getByRole("tabpanel");
-    const panelId = panel.getAttribute("id");
-    expect(panelId).toBeTruthy();
-    expect(tab.getAttribute("id")).toBeTruthy();
-    // Tab -> panel and panel -> active tab, both directions wired.
-    expect(tab.getAttribute("aria-controls")).toBe(panelId);
-    expect(panel.getAttribute("aria-labelledby")).toBe(tab.getAttribute("id"));
-  });
-
-  it("renders no tabpanel when no editor is open (nothing to label)", () => {
-    renderSurface({ selectedFile: null, editors: [] });
-    expect(screen.queryByRole("tabpanel")).toBeNull();
-  });
-
-  it("collapses back to chat when the toolbar control is clicked", () => {
-    const { onCollapse } = renderSurface();
-    fireEvent.click(screen.getByRole("button", { name: "Back to chat" }));
-    expect(onCollapse).toHaveBeenCalledTimes(1);
-  });
-
-  it("shows an empty editor when no file is selected", () => {
-    renderSurface({ selectedFile: null, editors: [] });
-    expect(viewerProps.length).toBe(0);
-    expect(screen.getByText("Select a file to view its contents.")).toBeTruthy();
-  });
-});
-
-// ---------------------------------------------------------------------------
-// Host-injected rail views (extraViews) — the unified-panel extension seam
-// ---------------------------------------------------------------------------
-
-const configView = {
-  id: "configure",
-  label: "Config",
-  icon: <span data-testid="config-icon" />,
-  content: <div data-testid="config-probe" />,
-};
-
-const changesView = {
-  id: "changes",
-  label: "Changes",
-  icon: <span />,
-  badge: 3,
-  content: <div data-testid="changes-probe" />,
-};
-
-describe("WorkspaceSurface extraViews", () => {
-  it("renders injected views in the rail after the built-ins", () => {
-    renderSurface({ extraViews: [configView, changesView] });
-    // Rail names live in accessible labels (hover rides the house tooltip;
-    // native titles are banned, stigmer-cloud#268).
-    const radios = screen.getAllByRole("radio");
-    expect(radios.map((r) => r.getAttribute("aria-label"))).toEqual([
-      "Explorer",
-      "Search",
-      "Config",
-      "Changes (3)", // the badge count folds into the accessible name
-    ]);
-    expect(radios.every((r) => r.getAttribute("title") === null)).toBe(true);
-  });
-
-  it("shows a count badge on a rail view and folds it into the accessible name", () => {
-    renderSurface({ extraViews: [changesView] });
-    const changes = screen.getByRole("radio", { name: "Changes (3)" });
-    expect(changes.textContent).toContain("3");
-  });
-
-  it("renders an extra view's content in the sidebar (with heading) when selected, keeping the editor area", () => {
-    renderSurface({ extraViews: [configView] });
-    fireEvent.click(screen.getByRole("radio", { name: "Config" }));
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-    expect(screen.queryByTestId("explorer-probe")).toBeNull();
-    // Sidebar heading + the editor area (file tab) both present.
-    expect(screen.getByText("Config")).toBeTruthy();
-    expect(screen.getByRole("tab", { name: /main\.go/ })).toBeTruthy();
-  });
-
-  it("hands a fitted view a bare slot — no sidebar heading, no padded scroll wrapper", () => {
-    // A fitted view (the workflow Inspect facet) owns its header, tab strip,
-    // and scroll; the shared envelope would double the header and nest
-    // scroll containers.
-    const fittedView = {
-      id: "inspect",
-      label: "Inspect",
-      icon: <span />,
-      fitted: true,
-      content: <div data-testid="fitted-probe" />,
-    };
-    renderSurface({ extraViews: [fittedView] });
-    fireEvent.click(screen.getByRole("radio", { name: "Inspect" }));
-
-    const probe = screen.getByTestId("fitted-probe");
-    // No SidebarHeader (the rail button carries the label as a title
-    // attribute, not text — so any "Inspect" text would be the heading).
-    expect(screen.queryByText("Inspect")).toBeNull();
-    // The content's wrapper is the bare sidebar column, not the padded
-    // scroll envelope the default path applies.
-    expect(probe.parentElement!.className).not.toContain("stg:overflow-y-auto");
-    expect(probe.parentElement!.className).not.toContain("stg:px-3");
-  });
-
-  it("keeps the shared envelope (heading + padded scroll) for unfitted views", () => {
-    renderSurface({ extraViews: [configView] });
-    fireEvent.click(screen.getByRole("radio", { name: "Config" }));
-    const probe = screen.getByTestId("config-probe");
-    expect(probe.parentElement!.className).toContain("stg:overflow-y-auto");
-    expect(screen.getByText("Config")).toBeTruthy();
-  });
-
-  it("supports controlled view selection via view/onViewChange", () => {
-    const onViewChange = vi.fn();
-    renderSurface({
-      extraViews: [configView],
-      view: "configure",
-      onViewChange,
-    });
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-    fireEvent.click(screen.getByRole("radio", { name: "Search" }));
-    expect(onViewChange).toHaveBeenCalledWith("search");
-    // Controlled: the view does not change until the owner re-renders.
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-  });
-
-  it("falls back to the explorer when the active view id no longer exists", () => {
-    // e.g. a contextual view (Inspect) that disappeared while active.
-    renderSurface({ extraViews: [], view: "inspect" });
-    expect(screen.getByTestId("explorer-probe")).toBeTruthy();
-    expect(
-      screen.getByRole("radio", { name: "Explorer" }).getAttribute("aria-checked"),
-    ).toBe("true");
-  });
-
-  it("moves across built-in and injected views with arrow keys", () => {
-    renderSurface({ extraViews: [configView] });
-    const search = screen.getByRole("radio", { name: "Search" });
-    fireEvent.click(search);
-    fireEvent.keyDown(search, { key: "ArrowDown" });
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-  });
-
-  it("reaches an injected view beyond the second by keyboard (focus follows selection)", () => {
-    // Regression guard: the old handler moved selection but never DOM focus, so
-    // focus stayed pinned on the entered button and every view past the second
-    // (Config, Changes, …) was keyboard-unreachable. Each arrow must advance
-    // focus so the next arrow computes from the new position.
-    renderSurface({ extraViews: [configView, changesView] });
-    const explorer = screen.getByRole("radio", { name: "Explorer" });
-    explorer.focus();
-    expect(document.activeElement).toBe(explorer);
-
-    // Step 1: Explorer -> Search, focus moves with the selection.
-    fireEvent.keyDown(document.activeElement!, { key: "ArrowDown" });
-    const search = screen.getByRole("radio", { name: "Search" });
-    expect(document.activeElement).toBe(search);
-    expect(search.getAttribute("aria-checked")).toBe("true");
-
-    // Step 2: Search -> Config. The step the old code could not make.
-    fireEvent.keyDown(document.activeElement!, { key: "ArrowDown" });
-    const config = screen.getByRole("radio", { name: "Config" });
-    expect(document.activeElement).toBe(config);
-    expect(config.getAttribute("aria-checked")).toBe("true");
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-  });
-
-  it("jumps to the last and first rail views with End and Home", () => {
-    renderSurface({ extraViews: [configView, changesView] });
-    const explorer = screen.getByRole("radio", { name: "Explorer" });
-    explorer.focus();
-
-    fireEvent.keyDown(document.activeElement!, { key: "End" });
-    const changes = screen.getByRole("radio", { name: "Changes (3)" });
-    expect(document.activeElement).toBe(changes);
-    expect(changes.getAttribute("aria-checked")).toBe("true");
-
-    fireEvent.keyDown(document.activeElement!, { key: "Home" });
-    const explorerAgain = screen.getByRole("radio", { name: "Explorer" });
-    expect(document.activeElement).toBe(explorerAgain);
-    expect(explorerAgain.getAttribute("aria-checked")).toBe("true");
-  });
-
-  it("moves focus with selection in the Name|Text search-mode toggle", () => {
-    renderSurface({ searcher });
-    fireEvent.click(screen.getByRole("radio", { name: "Search" }));
-    const toggle = screen.getByRole("radiogroup", { name: "Search mode" });
-    const name = within(toggle).getByRole("radio", { name: "Name" });
-    name.focus();
-
-    fireEvent.keyDown(document.activeElement!, { key: "ArrowRight" });
-    const text = within(toggle).getByRole("radio", { name: "Text" });
-    expect(document.activeElement).toBe(text);
-    expect(text.getAttribute("aria-checked")).toBe("true");
-  });
-});
-
-// ---------------------------------------------------------------------------
-// builtInViews opt-in (DD-011) — hosts without a workspace file source scope
-// the rail to their injected facets (the workflow execution panel today).
-// ---------------------------------------------------------------------------
-
-describe("WorkspaceSurface builtInViews", () => {
-  it("offers Explorer and Search by default (backward-compatible)", () => {
-    renderSurface();
-    expect(screen.getByRole("radio", { name: "Explorer" })).toBeTruthy();
-    expect(screen.getByRole("radio", { name: "Search" })).toBeTruthy();
-  });
-
-  it("renders a facet-only rail with builtInViews={[]}", () => {
-    renderSurface({ builtInViews: [], extraViews: [configView] });
-    expect(screen.queryByRole("radio", { name: "Explorer" })).toBeNull();
-    expect(screen.queryByRole("radio", { name: "Search" })).toBeNull();
-    expect(screen.getByRole("radio", { name: "Config" })).toBeTruthy();
-  });
-
-  it("falls back to the first injected view — never a hidden built-in — for a stale view id", () => {
-    // A hardcoded "files" fallback would strand a facet-only host on a view
-    // its rail doesn't render (blank sidebar).
-    renderSurface({
-      builtInViews: [],
-      extraViews: [configView],
-      view: "inspect",
-    });
-    expect(screen.getByTestId("config-probe")).toBeTruthy();
-    expect(
-      screen.getByRole("radio", { name: "Config" }).getAttribute("aria-checked"),
-    ).toBe("true");
-    expect(screen.queryByTestId("explorer-probe")).toBeNull();
-  });
-
-  it("can offer a subset of built-ins", () => {
-    renderSurface({ builtInViews: ["files"] });
-    expect(screen.getByRole("radio", { name: "Explorer" })).toBeTruthy();
-    expect(screen.queryByRole("radio", { name: "Search" })).toBeNull();
-  });
-});
-
-// ---------------------------------------------------------------------------
-// Host-injected virtual documents — editor tabs that are not workspace files
-// (the session's plan.md today). Same open/pin/close semantics as file tabs;
-// only the body rendering diverges.
-// ---------------------------------------------------------------------------
-
-const PLAN_ENTRY_ID = virtualEntryId("plan");
-
-const planDocument = {
-  entryId: PLAN_ENTRY_ID,
-  path: "plan.md",
-  content: <div data-testid="plan-doc-probe" />,
-};
-
-describe("WorkspaceSurface virtualDocuments", () => {
-  it("renders the virtual document's content — no FileViewer, no breadcrumbs", () => {
-    renderSurface({
-      virtualDocuments: [planDocument],
-      editors: [{ entryId: PLAN_ENTRY_ID, path: "plan.md", preview: false }],
-      selectedFile: { entryId: PLAN_ENTRY_ID, path: "plan.md" },
-    });
-    expect(screen.getByTestId("plan-doc-probe")).toBeTruthy();
-    expect(viewerProps.length).toBe(0);
-    expect(screen.queryByRole("navigation", { name: "File location" })).toBeNull();
-  });
-
-  it("shows the virtual document as an ordinary tab (basename label)", () => {
-    renderSurface({
-      virtualDocuments: [planDocument],
-      editors: [
-        { entryId: "e1", path: "src/main.go", preview: false },
-        { entryId: PLAN_ENTRY_ID, path: "plan.md", preview: false },
-      ],
-      selectedFile: { entryId: PLAN_ENTRY_ID, path: "plan.md" },
-    });
-    const tab = screen.getByRole("tab", { name: /plan\.md/ });
-    expect(tab.getAttribute("aria-selected")).toBe("true");
-  });
-
-  it("keeps file tabs on the FileViewer path while a virtual document is injected", () => {
-    renderSurface({
-      virtualDocuments: [planDocument],
-      editors: [
-        { entryId: "e1", path: "src/main.go", preview: false },
-        { entryId: PLAN_ENTRY_ID, path: "plan.md", preview: false },
-      ],
-      selectedFile: { entryId: "e1", path: "src/main.go" },
-    });
-    expect(screen.queryByTestId("plan-doc-probe")).toBeNull();
-    expect(viewerProps.at(-1)?.selectedFile).toEqual({
-      entryId: "e1",
-      path: "src/main.go",
-    });
-  });
-
-  it("a virtual entry id can never alias a real file of the same path", () => {
-    // The NUL-namespaced id is the collision guard: a workspace file named
-    // plan.md under a real entry must not hijack the virtual document body.
-    renderSurface({
-      virtualDocuments: [planDocument],
-      editors: [{ entryId: "e1", path: "plan.md", preview: false }],
-      selectedFile: { entryId: "e1", path: "plan.md" },
-    });
-    expect(screen.queryByTestId("plan-doc-probe")).toBeNull();
-    expect(viewerProps.at(-1)?.selectedFile).toEqual({
-      entryId: "e1",
-      path: "plan.md",
-    });
-  });
-
-  it("scrolls the document body vertically only — wide content reflows, never a sideways scrollbar", () => {
-    renderSurface({
-      virtualDocuments: [planDocument],
-      editors: [{ entryId: PLAN_ENTRY_ID, path: "plan.md", preview: false }],
-      selectedFile: { entryId: PLAN_ENTRY_ID, path: "plan.md" },
-    });
-    const body = screen.getByTestId("plan-doc-probe").parentElement!;
-    expect(body.className).toContain("stg:overflow-y-auto");
-    // overflow-y alone computes overflow-x to auto; the explicit hidden +
-    // min-w-0 pair is what forces documents to reflow at narrow widths.
-    expect(body.className).toContain("stg:overflow-x-hidden");
-    expect(body.className).toContain("stg:min-w-0");
-  });
-
-  it("mounts ONLY the active virtual document — inactive tabs stay unmounted", () => {
-    // Load-bearing for streaming documents (the workflow's agent-execution
-    // transcripts): an inactive tab's content must not exist in the tree at
-    // all, so its fetch/stream hooks never run (DD-LIVE-006 — only the
-    // visible surface streams). A hidden-but-mounted body would keep every
-    // open transcript's subscription alive.
-    const mounts: string[] = [];
-    function Probe({ id }: { readonly id: string }) {
-      mounts.push(id);
-      return <div data-testid={`doc-${id}`} />;
-    }
-    const TRANSCRIPT_ENTRY_ID = virtualEntryId("agentexec");
-    renderSurface({
-      virtualDocuments: [
-        {
-          entryId: TRANSCRIPT_ENTRY_ID,
-          path: "aex_1/first-call",
-          content: <Probe id="first" />,
-        },
-        {
-          entryId: TRANSCRIPT_ENTRY_ID,
-          path: "aex_2/second-call",
-          content: <Probe id="second" />,
-        },
-      ],
-      editors: [
-        { entryId: TRANSCRIPT_ENTRY_ID, path: "aex_1/first-call", preview: false },
-        { entryId: TRANSCRIPT_ENTRY_ID, path: "aex_2/second-call", preview: false },
-      ],
-      selectedFile: { entryId: TRANSCRIPT_ENTRY_ID, path: "aex_2/second-call" },
-    });
-
-    expect(screen.getByTestId("doc-second")).toBeTruthy();
-    expect(screen.queryByTestId("doc-first")).toBeNull();
-    expect(mounts).not.toContain("first");
-  });
-});
-
-// ---------------------------------------------------------------------------
-// Workspace entry management in the Explorer sidebar
-// ---------------------------------------------------------------------------
-
-describe("WorkspaceSurface entry management", () => {
-  it("renders an Add Folder footer action when onAddLocalFolder is provided", () => {
-    const onAddLocalFolder = vi.fn();
-    renderSurface({ onAddLocalFolder });
-    fireEvent.click(screen.getByRole("button", { name: "Add Folder" }));
-    expect(onAddLocalFolder).toHaveBeenCalledTimes(1);
-  });
-
-  it("omits the Add Folder action without the callback (web has no native picker)", () => {
-    renderSurface();
-    expect(screen.queryByRole("button", { name: "Add Folder" })).toBeNull();
-  });
-});

package/src/workspace/__tests__/a11y/harness.tsx

@@ -1,20 +0,0 @@
-// The workspace panel's audit setup over the shared a11y harness
-// (`src/__tests__/helpers/a11y-audit.tsx`, the canonical statement of the
-// audit policy and its rationale). Only what is the workspace's own lives
-// here: the listing-cache reset between scenarios.
-
-import { resetAudit } from "../../../__tests__/helpers/a11y-audit.js";
-import { __clearWorkspaceListingCache } from "../../workspaceListingCache.js";
-
-export { COLOR_MODES, auditA11y, renderAudited } from "../../../__tests__/helpers/a11y-audit.js";
-export type { ColorMode } from "../../../__tests__/helpers/a11y-audit.js";
-
-/**
- * Reset cross-test state. The listing cache is module-level (keyed by entry id),
- * so without this a scenario could take a prior scenario's cached listing —
- * masking the truncation banner or leaking a stale tree. Call in `afterEach`.
- */
-export function resetWorkspaceAudit(): void {
-  resetAudit();
-  __clearWorkspaceListingCache();
-}

package/src/workspace/__tests__/a11y/mock-capabilities.ts

@@ -1,138 +0,0 @@
-// In-memory workspace capabilities for the browser-mode accessibility audit
-// (DD-22). These mirror the shapes a real host injects (DD-004) — a GitHub
-// lister/reader on web, a Tauri walker on desktop — but serve a tiny fixed
-// tree so the Session 18 hardened surfaces render deterministically, with no
-// network, backend, or token. Fixtures render REAL component output only; they
-// introduce no Tailwind utility classes of their own, so the prebuilt
-// `dist/styles.css` (generated by `@source` scanning over SDK source) covers
-// every class in the audited DOM.
-
-import { create } from "@bufbuild/protobuf";
-import {
-  FileChangeSchema,
-  FileContentSchema,
-  type FileChange,
-} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
-import {
-  FileChangeCaptureLevel,
-  FileChangeType,
-} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import type { WorkspaceEntry } from "../../useWorkspaceEntries.js";
-import type {
-  WorkspaceFileEntry,
-  WorkspaceFileLister,
-} from "../../WorkspaceFileLister.js";
-import type {
-  WorkspaceFileContent,
-  WorkspaceFileReader,
-} from "../../WorkspaceFileReader.js";
-import type { WorkspaceContentSearcher } from "../../WorkspaceContentSearcher.js";
-
-/** A git entry whose listing is a normal (non-truncated) multi-level tree. */
-export const EXPLORER_ENTRY: WorkspaceEntry = {
-  id: "a11y-explorer",
-  name: "acme/app",
-  type: "git",
-  gitUrl: "https://github.com/acme/app.git",
-  gitBranch: "main",
-};
-
-/** A git entry whose listing is capped, exercising the truncation banner. */
-export const TRUNCATED_ENTRY: WorkspaceEntry = {
-  id: "a11y-truncated",
-  name: "acme/monorepo",
-  type: "git",
-  gitUrl: "https://github.com/acme/monorepo.git",
-  gitBranch: "main",
-};
-
-/** The file opened by the viewer audits (present in {@link EXPLORER_ENTRY}). */
-export const OPEN_FILE_PATH = "src/index.ts";
-
-const OPEN_FILE_TEXT = [
-  "export interface Greeting {",
-  "  readonly message: string;",
-  "}",
-  "",
-  "export function greet(name: string): Greeting {",
-  "  return { message: `Hello, ${name}!` };",
-  "}",
-  "",
-].join("\n");
-
-const EXPLORER_LISTING: readonly WorkspaceFileEntry[] = [
-  { path: "src", isDirectory: true },
-  { path: "src/index.ts", isDirectory: false },
-  { path: "src/lib", isDirectory: true },
-  { path: "src/lib/format.ts", isDirectory: false },
-  { path: "src/lib/logo.png", isDirectory: false },
-  { path: "README.md", isDirectory: false },
-  { path: "package.json", isDirectory: false },
-];
-
-const TRUNCATED_LISTING: readonly WorkspaceFileEntry[] = [
-  { path: "src", isDirectory: true },
-  { path: "src/a.ts", isDirectory: false },
-  { path: "src/b.ts", isDirectory: false },
-  // The lister's advisory notice — the cache collapses this into the single
-  // `truncated` banner the audit asserts is accessible (DD-11).
-  { path: "Listing truncated — repository too large.", isDirectory: false, notice: true },
-];
-
-/** Lister serving the fixed tree, keyed by entry id. */
-export const mockLister: WorkspaceFileLister = async (entry) => {
-  if (entry.id === TRUNCATED_ENTRY.id) return [...TRUNCATED_LISTING];
-  if (entry.id === EXPLORER_ENTRY.id) return [...EXPLORER_LISTING];
-  return [];
-};
-
-const TEXT_CONTENT: WorkspaceFileContent = {
-  text: OPEN_FILE_TEXT,
-  isBinary: false,
-  size: OPEN_FILE_TEXT.length,
-  encoding: "utf-8",
-};
-
-const BINARY_CONTENT: WorkspaceFileContent = {
-  text: null,
-  isBinary: true,
-  size: 2048,
-  encoding: "base64",
-};
-
-/** Reader returning text for source files and a binary sentinel for the png. */
-export const mockReader: WorkspaceFileReader = async (_entry, path) => {
-  if (path.endsWith(".png")) return BINARY_CONTENT;
-  return TEXT_CONTENT;
-};
-
-/** Content searcher returning a couple of deterministic line hits. */
-export const mockSearcher: WorkspaceContentSearcher = async (entry, query) => {
-  if (entry.id !== EXPLORER_ENTRY.id) return null;
-  return {
-    matches: [
-      { path: "src/index.ts", line: 5, preview: `export function ${query}(name: string): Greeting {` },
-      { path: "src/lib/format.ts", line: 2, preview: `  // ${query} helper` },
-    ],
-    truncated: false,
-  };
-};
-
-/**
- * An inline (non-offloaded) MODIFY change for the open file, so the diff pane
- * resolves its before/after text synchronously — `useFileChangeContent` issues
- * no artifact fetch for inline sides, so the audit needs no live backend.
- */
-export function fileChangeForOpenFile(): FileChange {
-  return create(FileChangeSchema, {
-    path: OPEN_FILE_PATH,
-    changeType: FileChangeType.MODIFY,
-    captureLevel: FileChangeCaptureLevel.WHOLE_FILE,
-    before: create(FileContentSchema, {
-      body: { case: "inline", value: "export function greet(name: string) {\n  return name;\n}\n" },
-    }),
-    after: create(FileContentSchema, {
-      body: { case: "inline", value: OPEN_FILE_TEXT },
-    }),
-  });
-}