import type { ContextMenuItem as TreeContextMenuItem, ContextMenuOpenContext as TreeContextMenuOpenContext, } from "@pierre/trees"; import type { EnvironmentId, ProjectEntry } from "@t3tools/contracts"; import { FileTree, useFileTree, useFileTreeSearch, useFileTreeSelector } from "@pierre/trees/react"; import { serializeComposerFileLink } from "@t3tools/shared/composerTrigger"; import { ChevronsDownUpIcon, ChevronsUpDownIcon, RotateCw } from "lucide-react"; import { useEffect, useMemo, useRef } from "react"; import { Button } from "~/components/ui/button"; import { InputGroup, InputGroupInput } from "~/components/ui/input-group"; import { toastManager } from "~/components/ui/toast"; import { Tooltip, TooltipPopup, TooltipTrigger } from "~/components/ui/tooltip"; import { useComposerHandleContext } from "~/composerHandleContext"; import { writeTextToClipboard } from "~/hooks/useCopyToClipboard"; import { useTheme } from "~/hooks/useTheme"; import { useWorkspaceMutationRefresh } from "~/hooks/useWorkspaceMutationRefresh"; import { cn } from "~/lib/utils"; import { readLocalApi } from "~/localApi"; import { T3_PIERRE_ICONS } from "~/pierre-icons"; import { PIERRE_TREE_UNSAFE_CSS, pierreTreeStyle } from "~/pierre-tree-theme"; import { createFileTreeDragMentionController } from "./fileTreeDragMention"; import { areAllDirectoriesExpanded, setAllDirectoriesExpanded } from "./fileTreeExpansion"; import { buildFileTreePathUpdates } from "./fileTreePathReconciliation"; import { useProjectEntriesQuery } from "./projectFilesQueryState"; interface FileBrowserPanelProps { environmentId: EnvironmentId; cwd: string; projectName: string; /** File currently open in the preview pane; revealed and selected in the tree. */ selectedPath: string | null; /** Bumped when the same path should be revealed again (e.g. re-opened from search). */ selectedPathRevealId: number; onOpenFile: (relativePath: string) => void; onRefreshSelectedFile?: () => void; workspaceMutationId: string | null; } function treePath(entry: ProjectEntry): string { return entry.kind === "directory" ? `${entry.path}/` : entry.path; } function RefreshFilesButton(props: { isPending: boolean; onRefresh: () => void }) { return ( } > {props.isPending ? "Refreshing…" : "Refresh files"} ); } function FileSearchField(props: { ariaLabel: string; name: string; onClose: () => void; onValueChange: (value: string) => void; value: string; }) { return ( props.onValueChange(event.target.value)} onKeyDown={(event) => { if (event.key !== "Escape") return; props.onClose(); event.currentTarget.blur(); }} /> ); } export default function FileBrowserPanel({ environmentId, cwd, projectName, selectedPath, selectedPathRevealId, onOpenFile, onRefreshSelectedFile, workspaceMutationId, }: FileBrowserPanelProps) { const { resolvedTheme } = useTheme(); const composerRef = useComposerHandleContext(); const entriesQuery = useProjectEntriesQuery(environmentId, cwd); const entries = entriesQuery.data?.entries ?? []; const entryKinds = useMemo( () => new Map(entries.map((entry) => [entry.path, entry.kind] as const)), [entries], ); const entryKindsRef = useRef>(entryKinds); const treePaths = useMemo(() => entries.map(treePath), [entries]); const directoryPaths = useMemo( () => entries.filter((entry) => entry.kind === "directory").map(treePath), [entries], ); const previousTreePathsRef = useRef(null); const syncingSelectionRef = useRef(false); const treeSelectionPathRef = useRef(null); const handledRevealRef = useRef<{ path: string; revealId: number } | null>(null); // The tree renders rows in shadow DOM and its anchor rect is unreliable, so // capture the right-click position ourselves; contextmenu is a composed // event, so a capture-phase listener sees it with viewport coordinates. const contextMenuPointerRef = useRef<{ x: number; y: number; at: number } | null>(null); useEffect(() => { const capturePointer = (event: MouseEvent) => { contextMenuPointerRef.current = { x: event.clientX, y: event.clientY, at: event.timeStamp }; }; document.addEventListener("contextmenu", capturePointer, true); return () => document.removeEventListener("contextmenu", capturePointer, true); }, []); const showEntryContextMenu = async ( item: TreeContextMenuItem, context: TreeContextMenuOpenContext, ) => { const api = readLocalApi(); if (!api) { context.close(); return; } const relativePath = item.path.replace(/\/$/, ""); const mention = serializeComposerFileLink(relativePath); const pointer = contextMenuPointerRef.current; const pointerIsFresh = pointer !== null && performance.now() - pointer.at < 1000; const anchorRect = context.anchorElement.getBoundingClientRect(); const position = pointerIsFresh ? { x: pointer.x, y: pointer.y } : { x: anchorRect.left, y: anchorRect.bottom }; try { const clicked = await api.contextMenu.show( [ { id: "copy-mention", label: "Copy mention" }, { id: "add-to-chat", label: "Add to chat" }, ], position, ); if (clicked === "copy-mention") { try { await writeTextToClipboard(mention); toastManager.add({ type: "success", title: "Mention copied", description: relativePath }); } catch (error) { toastManager.add({ type: "error", title: "Failed to copy mention", description: error instanceof Error ? error.message : "An error occurred.", }); } return; } if (clicked === "add-to-chat") { const composer = composerRef?.current; if (!composer) { toastManager.add({ type: "error", title: "Unable to add to chat", description: "Open a chat for this project and try again.", }); return; } const inserted = composer.insertTextAtEnd(`${mention} `, { ensureLeadingBoundary: true }); if (!inserted) { toastManager.add({ type: "error", title: "Unable to add to chat", description: "The chat isn't ready to accept input right now.", }); } } } finally { context.close(); } }; const showEntryContextMenuRef = useRef(showEntryContextMenu); useEffect(() => { showEntryContextMenuRef.current = showEntryContextMenu; }); const treeModelRef = useRef["model"] | null>(null); const dragMention = useMemo( () => createFileTreeDragMentionController({ deselect: (path) => treeModelRef.current?.getItem(path)?.deselect(), }), [], ); const { model } = useFileTree({ composition: { contextMenu: { triggerMode: "right-click", onOpen: (item, context) => { void showEntryContextMenuRef.current(item, context); }, }, }, // Rows only need to be draggable so entries can be dropped into the chat // composer; rearranging files inside the tree stays off. dragAndDrop: { canDrop: () => false }, density: "compact", fileTreeSearchMode: "hide-non-matches", flattenEmptyDirectories: true, initialExpansion: 1, icons: T3_PIERRE_ICONS, onSelectionChange: (selectedPaths) => { // The drag controller's selection cache must track every change, // including reveal-driven ones, or drags act on a stale selection. dragMention.handleSelectionChange(selectedPaths); // Selection changes driven by the reveal sync below are echoes of an // already-open file, not a request to open it again. if (syncingSelectionRef.current) return; // Starting a drag selects the dragged row; that selection is a side // effect of the gesture, not a request to open the file. if (dragMention.isDragInProgress()) { return; } const selectedPath = selectedPaths.at(-1)?.replace(/\/$/, ""); if (selectedPath && entryKindsRef.current.get(selectedPath) === "file") { treeSelectionPathRef.current = selectedPath; onOpenFile(selectedPath); } }, paths: [], search: false, unsafeCSS: PIERRE_TREE_UNSAFE_CSS, }); const search = useFileTreeSearch(model); const allDirectoriesExpanded = useFileTreeSelector(model, (currentModel) => areAllDirectoriesExpanded(currentModel, directoryPaths), ); const toggleAllDirectories = () => { setAllDirectoriesExpanded(model, directoryPaths, !allDirectoriesExpanded); }; const handleSearchValueChange = (value: string) => { if (value.trim().length === 0) { search.close(); return; } search.setValue(value); }; const handleRefresh = () => { entriesQuery.refresh(); onRefreshSelectedFile?.(); }; useWorkspaceMutationRefresh({ mutationId: workspaceMutationId, refresh: entriesQuery.refresh, resourceKey: `files:${environmentId}:${cwd}`, }); useEffect(() => { if (entriesQuery.data === null) return; if (previousTreePathsRef.current === treePaths) return; entryKindsRef.current = entryKinds; const previousTreePaths = previousTreePathsRef.current; previousTreePathsRef.current = treePaths; if (previousTreePaths === null) { model.resetPaths(treePaths); return; } const updates = buildFileTreePathUpdates(previousTreePaths, treePaths); if (updates.length > 0) model.batch(updates); }, [entriesQuery.data, entryKinds, model, treePaths]); useEffect(() => { if (!selectedPath) { handledRevealRef.current = null; return; } const revealRequest = { path: selectedPath, revealId: selectedPathRevealId }; const handledReveal = handledRevealRef.current; // Entry refreshes rebuild treePaths while the same preview stays open. // Replaying a handled reveal would close an active tree search and steal focus. if ( handledReveal?.path === revealRequest.path && handledReveal.revealId === revealRequest.revealId ) { return; } if (entryKinds.get(selectedPath) !== "file") return; const selectedItem = model.getItem(selectedPath); if (!selectedItem) return; // A selection that originated inside the tree (clicking a row, possibly // in an active tree search) is already visible; re-revealing it would // close the search and clobber the user's context. Only sync external // opens (file picker, content search, chat links). const selectedInTree = model .getSelectedPaths() .some((path) => path.replace(/\/$/, "") === selectedPath); if (selectedInTree && treeSelectionPathRef.current === selectedPath) { treeSelectionPathRef.current = null; handledRevealRef.current = revealRequest; return; } treeSelectionPathRef.current = null; handledRevealRef.current = revealRequest; syncingSelectionRef.current = true; model.closeSearch(); for (const path of model.getSelectedPaths()) { model.getItem(path)?.deselect(); } // Directory rows are registered with a trailing slash (see treePath), so // ancestor lookups must use the same form to expand them. const segments = selectedPath.split("/"); let ancestorPath = ""; for (const segment of segments.slice(0, -1)) { ancestorPath = ancestorPath ? `${ancestorPath}/${segment}` : segment; const item = model.getItem(`${ancestorPath}/`) ?? model.getItem(ancestorPath); if (item && "expand" in item) item.expand(); } selectedItem.select(); model.scrollToPath(selectedPath, { focus: true, offset: "center" }); queueMicrotask(() => { syncingSelectionRef.current = false; }); }, [entryKinds, model, selectedPath, selectedPathRevealId, treePaths]); // Tag tree drags with the composer mention payload. The row is read from // the composed event path (the tree's shadow root is open), so this does // not depend on running after the tree's own dragstart handler; the drag // data store is writable for every dragstart listener in the dispatch. // The capture phase runs before the tree's own dragstart handler selects // the dragged row, so the drag flag is up before that selection emits. const panelRef = useRef(null); useEffect(() => { treeModelRef.current = model; }, [model]); useEffect(() => { const panel = panelRef.current; if (panel === null) { return; } const handleDragStart = (event: DragEvent) => dragMention.handleDragStart(event); const handleDragEnd = () => dragMention.handleDragEnd(); panel.addEventListener("dragstart", handleDragStart, true); panel.addEventListener("dragend", handleDragEnd); return () => { panel.removeEventListener("dragstart", handleDragStart, true); panel.removeEventListener("dragend", handleDragEnd); }; }, [dragMention]); return ( {directoryPaths.length > 0 ? ( } > {allDirectoriesExpanded ? ( ) : ( )} {allDirectoriesExpanded ? "Collapse all folders" : "Expand all folders"} ) : null} {entriesQuery.error && entriesQuery.data === null ? ( {entriesQuery.error} ) : ( )} ); }