Python
// The rail's preview notification must be edge-triggered: a new onPreviewChange
// identity (App re-renders whenever the nav toggles) must NOT replay "open" while
// the viewer sits open — that re-collapsed a sidebar the user had just expanded
// (owner-hit 2026-08-21).
import { act, render } from "@testing-library/react";
import { describe, expect, it, vi } from "vitest";
import { RightRail } from "./RightRail";
import { OPEN_ARTIFACT_EVENT } from "./Markdown";
vi.mock("../api", async () => {
const actual: any = await vi.importActual("../api");
return {
...actual,
getArtifacts: vi.fn().mockResolvedValue([]),
getRoots: vi.fn().mockResolvedValue([]),
getJournalCases: vi.fn().mockResolvedValue([]),
readArtifact: vi.fn().mockResolvedValue({ ok: true, path: "r.md", kind: "markdown", content: "x" }),
revealArtifact: vi.fn().mockResolvedValue({ ok: true }),
};
});
function rail(onPreviewChange: (open: boolean) => void) {
return (
<RightRail
active
sessionId="s1"
refreshKey={0}
toolNames={[]}
todo={[]}
running={false}
onPreviewChange={onPreviewChange}
/>
);
}
describe("RightRail preview notification", () => {
it("fires only on open/close transitions, not on callback identity changes", async () => {
const first = vi.fn();
const { rerender } = render(rail(first));
await act(async () => {});
expect(first).not.toHaveBeenCalled(); // closed at mount: no "closed" replay either
// Open the viewer via a transcript chip event.
await act(async () => {
window.dispatchEvent(
new CustomEvent(OPEN_ARTIFACT_EVENT, { detail: { path: "r.md" } }),
);
});
expect(first).toHaveBeenCalledTimes(1);
expect(first).toHaveBeenLastCalledWith(true);
// App re-renders with a NEW callback identity (e.g. the user expanded the nav).
const second = vi.fn();
rerender(rail(second));
await act(async () => {});
// The viewer never transitioned, so the new callback must not be told "open".
expect(second).not.toHaveBeenCalled();
});
});