import React, { act } from "react"; import { render, screen, cleanup, fireEvent, waitFor } from "@testing-library/react"; import { afterEach, describe, expect, it, vi } from "vitest"; import type { FileTreeNode } from "@/lib/types/backend"; vi.mock("@/components/toast-provider", () => ({ useToast: () => ({ toast: vi.fn() }), })); // No `react-i18next` stub: `vitest.setup.ts` bootstraps a real i18next instance // from the shipped catalogs, so these assertions exercise the copy a user // actually sees. A key-echoing stub silently turns every migrated label into a // raw `ns:key` and the assertions then only prove the stub works. import { FileContextMenu, TreeNodeName, useFileRename } from "./file-context-menu"; const FILE_NODE: FileTreeNode = { name: "README.md", path: "README.md", is_dir: false, size: 0 }; const DIR_NODE: FileTreeNode = { name: "src", path: "src", is_dir: true, size: 0 }; const RENAME_ROW = "rename-row"; const FOCUS_ANCHOR = "focus-anchor"; const BULK_TREE: FileTreeNode = { name: "root", path: "", is_dir: true, size: 0, children: [ { name: "a.txt", path: "a.txt", is_dir: false, size: 1 }, { name: "b.txt", path: "b.txt", is_dir: false, size: 1 }, ], }; afterEach(() => { cleanup(); vi.useRealTimers(); }); function openMenu(triggerTestId: string) { const trigger = screen.getByTestId(triggerTestId); fireEvent.contextMenu(trigger); } function BulkDeleteHarness({ onDeleteFile }: { onDeleteFile: (path: string) => Promise }) { const [tree, setTree] = React.useState(BULK_TREE); return ( <> {}} selectedCount={2} selectedPaths={new Set(["a.txt", "b.txt"])} >
row
{tree?.children?.map((child) => child.path).join(",")} ); } function RenameHarness() { const [tree, setTree] = React.useState(FILE_NODE); const rename = useFileRename(FILE_NODE, tree, setTree, vi.fn().mockResolvedValue(true)); return (
); } // `FileContextMenuSurface` defers `onStartRename` to `onCloseAutoFocus` and calls // `preventDefault()` there so Radix does not pull focus back to the trigger and // steal it from the freshly mounted input. Both halves of that are only correct // if the deferral is scoped to a *pending* rename: any other menu item, and any // dismissal, must leave Radix's default focus restoration alone and must never // enter edit mode. A pending flag that outlives its close is the failure mode. // The anchor stands in for whatever held focus when the user opened the menu. // Radix restores focus to it on close, so asserting against it distinguishes a // real restoration from focus falling back to `document.body`. function PendingRenameHarness({ onStartRename }: { onStartRename: () => void }) { const [tree, setTree] = React.useState(FILE_NODE); return ( <>
row
); } describe("FileContextMenu rename", () => { it("does not start rename when a different menu item is selected", async () => { const onStartRename = vi.fn(); render(); openMenu(RENAME_ROW); fireEvent.click(screen.getByText("Download")); await waitFor(() => expect(screen.queryByText("Download")).toBeNull()); expect(onStartRename).not.toHaveBeenCalled(); expect(screen.queryByRole("textbox")).toBeNull(); }); it("does not start rename when the menu is dismissed without a selection", async () => { const onStartRename = vi.fn(); render(); openMenu(RENAME_ROW); fireEvent.keyDown(document, { key: "Escape" }); await waitFor(() => expect(screen.queryByText("Rename")).toBeNull()); expect(onStartRename).not.toHaveBeenCalled(); }); it("does not replay a consumed rename on the next menu close", async () => { const onStartRename = vi.fn(); render(); openMenu(RENAME_ROW); fireEvent.click(screen.getByText("Rename")); await waitFor(() => expect(onStartRename).toHaveBeenCalledTimes(1)); // Reopening and dismissing must not re-fire the rename the previous close // already consumed. openMenu(RENAME_ROW); fireEvent.keyDown(document, { key: "Escape" }); await waitFor(() => expect(screen.queryByText("Rename")).toBeNull()); expect(onStartRename).toHaveBeenCalledTimes(1); }); // The three tests above prove `onStartRename` stays unfired, which is only // half of the contract. `preventDefault()` suppresses Radix's focus // restoration, and hoisting it above the pending-rename guard would keep every // assertion above green while silently dropping the user back on // `document.body` after Download or Escape. These two pin the other half. it("restores focus to the opener when a different menu item is selected", async () => { render(); const anchor = screen.getByTestId(FOCUS_ANCHOR); anchor.focus(); openMenu(RENAME_ROW); fireEvent.click(screen.getByText("Download")); await waitFor(() => expect(document.activeElement).toBe(anchor)); }); it("restores focus to the opener when the menu is dismissed without a selection", async () => { render(); const anchor = screen.getByTestId(FOCUS_ANCHOR); anchor.focus(); openMenu(RENAME_ROW); fireEvent.keyDown(document, { key: "Escape" }); await waitFor(() => expect(document.activeElement).toBe(anchor)); }); it("starts rename after the menu closes and immediately focuses the selected filename", async () => { vi.useFakeTimers(); render(); openMenu(RENAME_ROW); fireEvent.click(screen.getByText("Rename")); await act(async () => { await vi.advanceTimersByTimeAsync(0); }); const input = screen.getByRole("textbox"); expect(document.activeElement).toBe(input); expect((input as HTMLInputElement).selectionStart).toBe(0); expect((input as HTMLInputElement).selectionEnd).toBe(FILE_NODE.name.length); }); }); describe("FileContextMenu Download item", () => { it("shows a Download item for a file when onDownloadFile is provided", () => { const onDownloadFile = vi.fn().mockResolvedValue(true); render( {}} onDownloadFile={onDownloadFile} onStartRename={() => {}} >
row
, ); openMenu("file-row"); const item = screen.getByText("Download"); expect(item).toBeTruthy(); }); it("calls onDownloadFile with the node path when Download is selected", () => { const onDownloadFile = vi.fn().mockResolvedValue(true); render( {}} onDownloadFile={onDownloadFile} onStartRename={() => {}} >
row
, ); openMenu("file-row"); fireEvent.click(screen.getByText("Download")); expect(onDownloadFile).toHaveBeenCalledWith("README.md"); }); it("does not show a Download item for directories", () => { const onDownloadFile = vi.fn().mockResolvedValue(true); render( {}} onDeleteFile={vi.fn().mockResolvedValue(true)} onDownloadFile={onDownloadFile} onStartRename={() => {}} >
row
, ); openMenu("dir-row"); expect(screen.queryByText("Download")).toBeNull(); }); it("does not show a Download item when a bulk selection is active", () => { const onDownloadFile = vi.fn().mockResolvedValue(true); render( {}} onDeleteFile={vi.fn().mockResolvedValue(true)} onDownloadFile={onDownloadFile} onStartRename={() => {}} selectedCount={3} selectedPaths={new Set(["a", "b", "c"])} >
row
, ); openMenu("file-row"); expect(screen.queryByText("Download")).toBeNull(); }); }); describe("FileContextMenu chat context item", () => { it.each([ ["file", FILE_NODE], ["directory", DIR_NODE], ] as const)("shows and selects Add to chat context for a single %s", (_kind, node) => { const onAddToChatContext = vi.fn(); render( {}} onAddToChatContext={onAddToChatContext} onStartRename={() => {}} >
row
, ); openMenu("file-row"); const item = screen.getByTestId("file-context-add-to-chat"); fireEvent.click(item); expect(onAddToChatContext).toHaveBeenCalledTimes(1); expect(onAddToChatContext).toHaveBeenCalledWith(node); }); it("hides Add to chat context for bulk selections", () => { render( {}} onDeleteFile={vi.fn().mockResolvedValue(true)} onAddToChatContext={vi.fn()} onStartRename={() => {}} selectedCount={2} selectedPaths={new Set(["README.md", "src"])} >
row
, ); openMenu("file-row"); expect(screen.queryByTestId("file-context-add-to-chat")).toBeNull(); }); }); describe("FileContextMenu bulk deletion", () => { it("keeps failed paths visible after a partial deletion failure", async () => { const onDeleteFile = vi.fn(async (path: string) => path === "a.txt"); render(); openMenu("bulk-row"); fireEvent.click(screen.getByText("Delete 2 items")); fireEvent.click(screen.getByRole("button", { name: "Delete" })); await waitFor(() => expect(onDeleteFile).toHaveBeenCalledTimes(2)); await waitFor(() => expect(screen.getByTestId("tree-paths").textContent).toBe("b.txt")); expect(screen.getByTestId("tree-paths").textContent).not.toContain("a.txt"); }); });