Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

34.1 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { useAtom, useAtomValue } from "jotai";
import { atomWithStorage } from "jotai/utils";
import {
  ArrowLeftIcon,
  BetweenHorizontalStartIcon,
  BracesIcon,
  CopyMinusIcon,
  DownloadIcon,
  ExternalLinkIcon,
  FilePlus2Icon,
  FolderPlusIcon,
  FolderRootIcon,
  ListTreeIcon,
  PlaySquareIcon,
  UploadIcon,
  ViewIcon,
  XIcon,
} from "lucide-react";
import React, { Suspense, use, useRef, useState } from "react";
import {
  type DragPreviewProps,
  type NodeApi,
  type NodeRendererProps,
  Tree,
  type TreeApi,
} from "react-arborist";
import { createPortal } from "react-dom";
import useEvent from "react-use-event-hook";
import {
  FILE_ICON,
  FILE_ICON_COLOR,
  type FileIconType,
  guessFileIconType,
} from "@/components/editor/file-tree/file-icons";
import {
  DeleteMenuItem,
  DuplicateMenuItem,
  FileActionsDropdown,
  RenameMenuItem,
} from "@/components/editor/file-tree/file-operations";
import { FileNameInput } from "@/components/editor/file-tree/file-name-input";
import {
  MENU_ITEM_ICON_CLASS,
  RefreshIconButton,
  TreeChevron,
  VisibilityToggleButton,
} from "@/components/editor/file-tree/tree-actions";
import { MarimoIcon, MarimoPlusIcon } from "@/components/icons/marimo-icons";
import { Spinner } from "@/components/icons/spinner";
import { useImperativeModal } from "@/components/modal/ImperativeModal";
import { AlertDialogDestructiveAction } from "@/components/ui/alert-dialog";
import { Button } from "@/components/ui/button";
import {
  DropdownMenuItem,
  DropdownMenuSeparator,
} from "@/components/ui/dropdown-menu";
import { Tooltip } from "@/components/ui/tooltip";
import { SearchInput } from "@/components/ui/input";
import { toast } from "@/components/ui/use-toast";
import { useCellActions } from "@/core/cells/actions";
import { useLastFocusedCellId } from "@/core/cells/focus";
import { disableFileDownloadsAtom } from "@/core/config/config";
import { useRequestClient } from "@/core/network/requests";
import { isWasm } from "@/core/wasm/utils";
import { useAsyncData } from "@/hooks/useAsyncData";
import { useFileSearch } from "./use-file-search";
import { useHoverExpand } from "./use-hover-expand";
import { ErrorBanner } from "@/plugins/impl/common/error-banner";
import { cn } from "@/utils/cn";
import { copyToClipboard } from "@/utils/copy";
import { openNotebook } from "@/utils/links";
import type { FilePath } from "@/utils/paths";
import { makeDuplicateName } from "@/utils/pathUtils";
import { jotaiJsonStorage } from "@/utils/storage/jotai";
import { useTreeDndManager } from "./dnd-wrapper";
import { downloadFile } from "./download";
import { FileViewer } from "./file-viewer";
import { FileSearchResults } from "./file-search-results";
import { FileBrowserRow } from "./file-browser-row";
import type { FileTreeNode, RequestingTree } from "./requesting-tree";
import { openStateAtom, treeAtom } from "./state";
import { PYTHON_CODE_FOR_FILE_TYPE } from "./types";
import {
  FILE_EXPLORER_DIRECTORY_PATH_ATTRIBUTE,
  useFileExplorerUpload,
} from "./upload";

const hiddenFilesState = atomWithStorage(
  "marimo:showHiddenFiles",
  true,
  jotaiJsonStorage,
  {
    getOnInit: true,
  },
);

interface FileExplorerContextValue {
  tree: RequestingTree;
  uploadFiles: (destinationPath: FilePath) => void;
  externalDropDestinationPath: FilePath | null;
}

const RequestingTreeContext =
  React.createContext<FileExplorerContextValue | null>(null);

export const FileExplorer: React.FC<{
  height: number;
  externalDropDestinationPath?: FilePath | null;
}> = ({ height, externalDropDestinationPath = null }) => {
  const treeRef = useRef<TreeApi<FileTreeNode>>(null);
  const searchTreeRef = useRef<TreeApi<FileTreeNode>>(null);
  const searchRef = useRef<HTMLInputElement>(null);
  const [query, setQuery] = useState("");
  const [revealId, setRevealId] = useState<string | null>(null);
  const dndManager = useTreeDndManager();
  const [tree] = useAtom(treeAtom);
  const [data, setData] = useState<FileTreeNode[]>([]);
  const [openFile, setOpenFile] = useState<FileTreeNode | null>(null);
  const [selectedFolder, setSelectedFolder] = useState<{
    id: string;
    path: FilePath;
  } | null>(null);
  const [showHiddenFiles, setShowHiddenFiles] =
    useAtom<boolean>(hiddenFilesState);
  const search = useFileSearch({ query: query.trim(), tree, showHiddenFiles });
  // Keep external state to remember which folders are open when this
  // component is unmounted.
  const [openState, setOpenState] = useAtom(openStateAtom);

  const refreshUploadDestination = useEvent((destinationPath: FilePath) => {
    return tree.refreshPath(destinationPath);
  });

  const uploadDestinationRef = useRef<FilePath>("" as FilePath);
  const { getInputProps: getUploadInputProps, open: openUploadPicker } =
    useFileExplorerUpload({
      noClick: true,
      noDrag: true,
      noKeyboard: true,
      destinationPath: () => uploadDestinationRef.current,
      getDestinationLabel: (path) => getUploadDestinationLabel(tree, path),
      refreshDestination: refreshUploadDestination,
    });
  const handleUploadFiles = useEvent((destinationPath: FilePath) => {
    uploadDestinationRef.current = destinationPath;
    openUploadPicker();
  });

  const { openPrompt, openConfirm } = useImperativeModal();
  const { isPending, error } = useAsyncData(() => tree.initialize(setData), []);

  const handleRefresh = useEvent(async () => {
    await tree.refreshAll(Object.keys(openState).filter((id) => openState[id]));
    search.refetch();
  });

  const handleHiddenFilesToggle = useEvent(() => {
    const newValue = !showHiddenFiles;
    setShowHiddenFiles(newValue);
  });

  const handleCreateFolder = useEvent(async () => {
    openPrompt({
      title: "Folder name",
      onConfirm: async (name) => {
        tree.createFolder(name, selectedFolder?.id ?? null);
      },
    });
  });

  const handleCreateFile = useEvent(async () => {
    openPrompt({
      title: "File name",
      onConfirm: async (name) => {
        tree.createFile({ name, parentId: selectedFolder?.id ?? null });
      },
    });
  });

  const handleCreateNotebook = useEvent(async () => {
    openPrompt({
      title: "Notebook name",
      onConfirm: async (name) => {
        tree.createFile({
          name,
          parentId: selectedFolder?.id ?? null,
          type: "notebook",
        });
      },
    });
  });

  const handleCollapseAll = useEvent(() => {
    treeRef.current?.closeAll();
    setOpenState({});
  });

  const visibleData = React.useMemo(
    () => filterHiddenTree(data, showHiddenFiles),
    [data, showHiddenFiles],
  );
  const selectedFolderId = selectedFolder?.id;
  const selectedFolderVisible = React.useMemo(
    () =>
      selectedFolderId === undefined ||
      treeContainsId(visibleData, selectedFolderId),
    [visibleData, selectedFolderId],
  );
  if (!selectedFolderVisible) {
    setSelectedFolder(null);
  }
  const contextValue = React.useMemo<FileExplorerContextValue>(
    () => ({
      tree,
      uploadFiles: handleUploadFiles,
      externalDropDestinationPath,
    }),
    [tree, handleUploadFiles, externalDropDestinationPath],
  );

  React.useEffect(() => {
    if (revealId && !openFile) {
      const activeTree = query.trim() ? searchTreeRef.current : treeRef.current;
      activeTree?.openParents(revealId);
      activeTree?.select(revealId);
      const node = activeTree?.get(revealId);
      if (node?.data.isDirectory) {
        node.open();
      }
      setRevealId(null);
    }
  }, [revealId, query, openFile, data]);

  const handleReveal = async (node: FileTreeNode) => {
    if (!node.isDirectory) {
      setOpenFile(node);
      return;
    }
    if (await tree.reveal(node)) {
      setQuery("");
      setRevealId(node.id);
    }
  };

  const handleTreeKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
    if ((event.ctrlKey || event.metaKey) && event.key === "f") {
      event.preventDefault();
      event.stopPropagation();
      searchRef.current?.focus();
      searchRef.current?.select();
      return;
    }
    if (event.key === "Escape" && query) {
      event.preventDefault();
      event.stopPropagation();
      setQuery("");
      searchRef.current?.focus();
      return;
    }
    const role =
      event.target instanceof Element
        ? event.target.getAttribute("role")
        : null;
    if (event.key === "Tab" && event.target instanceof HTMLElement) {
      if (!event.shiftKey && role === "treeitem") {
        const action = event.target.querySelector<HTMLButtonElement>(
          '[data-file-tree-action="open"]',
        );
        if (action) {
          event.preventDefault();
          event.stopPropagation();
          action.focus();
          return;
        }
      } else if (
        event.shiftKey &&
        event.target.dataset.fileTreeAction === "open"
      ) {
        event.preventDefault();
        event.stopPropagation();
        event.target.closest<HTMLElement>('[role="treeitem"]')?.focus();
        return;
      }
    }
    if (query.trim() || (role !== "treeitem" && role !== "tree")) {
      return;
    }
    const node = treeRef.current?.focusedNode;
    if (!node || treeRef.current?.isEditing) {
      return;
    }
    if (event.key === "Enter") {
      event.preventDefault();
      event.stopPropagation();
      if (node.data.isDirectory) {
        node.toggle();
      } else {
        node.activate();
      }
    } else if (event.key === "F2" && !node.data.isRoot) {
      event.preventDefault();
      event.stopPropagation();
      node.edit();
    } else if (event.key === "Delete" || event.key === "Backspace") {
      event.preventDefault();
      event.stopPropagation();
      if (!node.data.isRoot) {
        void node.tree.delete(node.id);
      }
    }
  };

  if (isPending) {
    return <Spinner size="medium" centered={true} />;
  }

  if (error) {
    return <ErrorBanner error={error} />;
  }

  const preview = openFile ? (
    <>
      <div className="flex items-center pl-1 pr-3 shrink-0 border-b justify-between">
        <Button
          autoFocus={true}
          aria-label="Back to files"
          onClick={() => {
            setRevealId(openFile.id);
            setOpenFile(null);
          }}
          data-testid="file-explorer-back-button"
          variant="text"
          size="xs"
          className="mb-0"
        >
          <ArrowLeftIcon size={16} />
        </Button>
        <span className="font-bold">{openFile.name}</span>
      </div>
      <Suspense>
        <FileViewer
          onOpenNotebook={
            tree.isPrimaryNode(openFile)
              ? (evt) => {
                  const path = tree.getPrimaryRelativePath(
                    openFile.path as FilePath,
                  );
                  if (path !== null) {
                    openMarimoNotebook(evt, path);
                  }
                }
              : undefined
          }
          file={openFile}
        />
      </Suspense>
    </>
  ) : null;

  return (
    <>
      {preview}
      <div hidden={!!openFile} onKeyDownCapture={handleTreeKeyDown}>
        <input
          data-testid="file-explorer-upload-input"
          {...getUploadInputProps()}
        />
        <div>
          <Toolbar
            onRefresh={handleRefresh}
            onHidden={handleHiddenFilesToggle}
            showHiddenFiles={showHiddenFiles}
            onCreateFile={handleCreateFile}
            onCreateNotebook={handleCreateNotebook}
            onCreateFolder={handleCreateFolder}
            onCollapseAll={handleCollapseAll}
            uploadDestinationPath={
              selectedFolder?.path ?? tree.getPrimaryRootPath()
            }
            uploadDestinationLabel={getUploadDestinationLabel(
              tree,
              selectedFolder?.path ?? tree.getPrimaryRootPath(),
            )}
            onUpload={handleUploadFiles}
          />
          <div className="relative -mt-1">
            <SearchInput
              ref={searchRef}
              className="rounded-none pr-6 focus-visible:outline-1 focus-visible:outline-ring/50"
              clearable={false}
              aria-label="Search files and folders"
              placeholder="Search"
              title="Search names in all configured roots, up to 20 folders deep. Generated directories such as node_modules and .git are excluded."
              value={query}
              onChange={(event) => setQuery(event.target.value)}
              onKeyDown={(event) => {
                const activeTree = query.trim()
                  ? searchTreeRef.current
                  : treeRef.current;
                if (event.key === "ArrowDown") {
                  event.preventDefault();
                  activeTree?.focus(activeTree.firstNode);
                } else if (event.key === "Enter" && query.trim()) {
                  event.preventDefault();
                  activeTree?.firstNode?.activate();
                }
              }}
            />
            {query && (
              <Button
                variant="text"
                size="icon"
                className="absolute right-3 top-1/2 h-5 w-5 -translate-y-1/2"
                aria-label="Clear search"
                onClick={() => {
                  setQuery("");
                  searchRef.current?.focus();
                }}
              >
                <XIcon className="h-3 w-3" />
              </Button>
            )}
          </div>
        </div>
        <div hidden={!query.trim()}>
          <FileSearchResults
            treeRef={searchTreeRef}
            search={search}
            height={Math.max(0, height - 63)}
            onReveal={handleReveal}
          />
        </div>
        <div hidden={!!query.trim()} className="relative">
          <RequestingTreeContext value={contextValue}>
            <Tree<FileTreeNode>
              width="100%"
              ref={treeRef}
              height={Math.max(0, height - 63)}
              className="h-full"
              data={visibleData}
              childrenAccessor={(node) =>
                node.isDirectory ? node.children : null
              }
              selectionFollowsFocus={true}
              rowClassName="outline-none focus-visible:ring-1 focus-visible:ring-inset focus-visible:ring-ring"
              renderRow={FileBrowserRow}
              renderDragPreview={(props) => (
                <FileDragPreview {...props} tree={treeRef.current} />
              )}
              disableEdit={(node) => node.isRoot}
              initialOpenState={openState}
              openByDefault={false}
              // Use shared DnD manager to prevent "Cannot have two HTML5 backends" error
              dndManager={dndManager}
              // Hide the drop cursor
              renderCursor={() => null}
              // Disable dropping files into files
              disableDrag={(node) => node.isRoot}
              disableDrop={({ parentNode, dragNodes }) =>
                dragNodes.some((node) => node.data.isRoot) ||
                (parentNode ? !parentNode.data.isDirectory : false)
              }
              onDelete={async ({ ids }) => {
                openConfirm({
                  title: "Delete file",
                  description:
                    "Are you sure you want to delete the selected file or folder?",
                  confirmAction: (
                    <AlertDialogDestructiveAction
                      onClick={async () => {
                        for (const id of ids) {
                          await tree.delete(id);
                        }
                      }}
                    >
                      Delete
                    </AlertDialogDestructiveAction>
                  ),
                });
              }}
              onRename={async ({ id, name }) => {
                await tree.rename(id, name);
              }}
              onMove={async ({ dragIds, parentId }) => {
                await tree.move(dragIds, parentId);
              }}
              onSelect={(nodes) => {
                const first = nodes[0];
                if (!first) {
                  setSelectedFolder(null);
                  return;
                }
                if (first.data.isDirectory) {
                  setSelectedFolder({
                    id: first.id,
                    path: first.data.path as FilePath,
                  });
                  return;
                }
                setSelectedFolder(null);
              }}
              onActivate={(node) => {
                if (!node.data.isDirectory) {
                  setOpenFile(node.data);
                }
              }}
              onToggle={async (id) => {
                const isOpen =
                  treeRef.current?.isOpen(id) ?? !(openState[id] ?? false);
                if (!isOpen) {
                  setOpenState((previous) => ({ ...previous, [id]: false }));
                  return;
                }
                const loaded = await tree.expand(id);
                if (!loaded) {
                  treeRef.current?.close(id);
                }
                const remainsOpen =
                  loaded && (treeRef.current?.isOpen(id) ?? false);
                setOpenState((previous) => ({
                  ...previous,
                  [id]: remainsOpen,
                }));
              }}
              padding={15}
              rowHeight={30}
              indent={INDENT_STEP}
              overscanCount={8}
              // Disable multi-selection
              disableMultiSelection={true}
            >
              {Node}
            </Tree>
          </RequestingTreeContext>
          {!visibleData.length && (
            <p
              role="status"
              className="absolute top-2 left-3 text-sm text-muted-foreground"
            >
              No visible files.
            </p>
          )}
        </div>
      </div>
    </>
  );
};

const INDENT_STEP = 15;

interface ToolbarProps {
  onRefresh: () => void;
  onHidden: () => void;
  showHiddenFiles: boolean;
  onCreateFile: () => void;
  onCreateNotebook: () => void;
  onCreateFolder: () => void;
  onCollapseAll: () => void;
  uploadDestinationPath: FilePath;
  uploadDestinationLabel: string;
  onUpload: (destinationPath: FilePath) => void;
}

const Toolbar = ({
  onRefresh,
  onHidden,
  showHiddenFiles,
  onCreateFile,
  onCreateNotebook,
  onCreateFolder,
  onCollapseAll,
  uploadDestinationPath,
  uploadDestinationLabel,
  onUpload,
}: ToolbarProps) => {
  const uploadLabel = `Upload files to ${uploadDestinationLabel}`;

  return (
    <div className="flex items-center justify-end px-2 shrink-0">
      <Tooltip content="Add notebook">
        <Button
          data-testid="file-explorer-add-notebook-button"
          onClick={onCreateNotebook}
          variant="text"
          size="xs"
        >
          <MarimoPlusIcon size={16} />
        </Button>
      </Tooltip>
      <Tooltip content="Add file">
        <Button
          data-testid="file-explorer-add-file-button"
          onClick={onCreateFile}
          variant="text"
          size="xs"
        >
          <FilePlus2Icon size={16} />
        </Button>
      </Tooltip>
      <Tooltip content="Add folder">
        <Button
          data-testid="file-explorer-add-folder-button"
          onClick={onCreateFolder}
          variant="text"
          size="xs"
        >
          <FolderPlusIcon size={16} />
        </Button>
      </Tooltip>
      <Tooltip content={uploadLabel}>
        <Button
          data-testid="file-explorer-upload-button"
          aria-label={uploadLabel}
          onClick={() => onUpload(uploadDestinationPath)}
          variant="text"
          size="xs"
        >
          <UploadIcon size={16} />
        </Button>
      </Tooltip>
      <RefreshIconButton
        data-testid="file-explorer-refresh-button"
        onClick={onRefresh}
      />
      <VisibilityToggleButton
        data-testid="file-explorer-hidden-files-button"
        isVisible={showHiddenFiles}
        onToggle={onHidden}
        showTooltip="Show hidden files"
        hideTooltip="Hide hidden files"
      />
      <Tooltip content="Collapse all folders">
        <Button
          data-testid="file-explorer-collapse-button"
          onClick={onCollapseAll}
          variant="text"
          size="xs"
        >
          <CopyMinusIcon size={16} />
        </Button>
      </Tooltip>
    </div>
  );
};

const Show = ({
  node,
  onOpenMarimoFile,
}: {
  node: NodeApi<FileTreeNode>;
  onOpenMarimoFile: (
    evt: Pick<Event, "stopPropagation" | "preventDefault">,
  ) => void;
}) => {
  const label = (
    <span className="flex-1 overflow-hidden text-ellipsis">
      {node.data.name}
      {node.data.isMarimoFile && node.data.isPrimaryRoot && !isWasm() && (
        <button
          type="button"
          aria-label={`Open notebook ${node.data.name}`}
          data-testid="file-explorer-open-marimo-button"
          data-file-tree-action="open"
          onKeyDown={(event) => {
            if (event.key !== "Tab") {
              event.stopPropagation();
            }
          }}
          className={cn(
            "shrink-0 ml-2 text-sm hidden group-hover:inline group-focus-within:inline hover:underline",
            node.isFocused && "inline",
          )}
          onClick={onOpenMarimoFile}
        >
          open <ExternalLinkIcon className="inline ml-1" size={12} />
        </button>
      )}
    </span>
  );

  return node.data.isRoot ? (
    <Tooltip content={node.data.path}>{label}</Tooltip>
  ) : (
    label
  );
};

const Node = ({ node, style, dragHandle }: NodeRendererProps<FileTreeNode>) => {
  const { openFile } = useRequestClient();
  const disableFileDownloads = useAtomValue(disableFileDownloadsAtom);

  const fileType: FileIconType = node.data.isDirectory
    ? "directory"
    : guessFileIconType(node.data.name);

  const Icon = FILE_ICON[fileType];
  const { openPrompt } = useImperativeModal();
  const { createCell } = useCellActions();
  const lastFocusedCellId = useLastFocusedCellId();

  const handleInsertCode = (code: string) => {
    createCell({ after: lastFocusedCellId, code });
  };

  const fileExplorer = use(RequestingTreeContext);
  const tree = fileExplorer?.tree;
  const isExternalDropTarget =
    node.data.isDirectory &&
    fileExplorer?.externalDropDestinationPath === node.data.path;
  useHoverExpand(node, isExternalDropTarget);

  const handleOpenMarimoFile = async (
    evt: Pick<Event, "stopPropagation" | "preventDefault">,
  ) => {
    const path = tree?.getPrimaryRelativePath(node.data.path as FilePath);
    if (path !== null && path !== undefined) {
      openMarimoNotebook(evt, path);
    }
  };

  const handleDeleteFile = async (evt: Event) => {
    evt.stopPropagation();
    evt.preventDefault();
    await node.tree.delete(node.id);
  };

  const handleCreateFolder = useEvent(async () => {
    // If not expanded, then expand
    node.open();
    openPrompt({
      title: "Folder name",
      onConfirm: async (name) => {
        tree?.createFolder(name, node.id);
      },
    });
  });

  const handleCreateFile = useEvent(async () => {
    node.open();
    openPrompt({
      title: "File name",
      onConfirm: async (name) => {
        tree?.createFile({ name, parentId: node.id });
      },
    });
  });

  const handleCreateNotebook = useEvent(async () => {
    node.open();
    openPrompt({
      title: "Notebook name",
      onConfirm: async (name) => {
        tree?.createFile({ name, parentId: node.id, type: "notebook" });
      },
    });
  });

  const handleDuplicate = useEvent(async () => {
    if (!tree) {
      return;
    }
    await tree.copy(node.id, makeDuplicateName(node.data.name));
  });

  return (
    <div
      style={style}
      ref={dragHandle}
      {...(node.data.isDirectory
        ? { [FILE_EXPLORER_DIRECTORY_PATH_ATTRIBUTE]: node.data.path }
        : {})}
      className={cn(
        "relative flex h-full items-center cursor-pointer ml-1 text-muted-foreground whitespace-nowrap group",
      )}
      draggable={!node.data.isRoot}
      onClick={() => {
        if (node.data.isDirectory) {
          node.toggle();
        }
      }}
      onDoubleClick={(event) => {
        event.stopPropagation();
        if (!node.data.isDirectory) {
          node.activate();
        }
      }}
    >
      {Array.from({ length: node.level }, (_, level) => (
        <span
          key={level}
          aria-hidden="true"
          className="pointer-events-none absolute inset-y-0 border-l border-border"
          style={{ left: level * INDENT_STEP + 8 }}
        />
      ))}
      <FolderArrow node={node} />
      <span
        className={cn(
          "flex items-center pl-1 py-1 cursor-pointer hover:bg-accent/50 hover:text-accent-foreground rounded-l flex-1 overflow-hidden group",
          node.willReceiveDrop &&
            node.tree.canDrop() &&
            node.data.isDirectory &&
            "bg-primary/15 hover:bg-primary/15 text-accent-foreground",
          node.isSelected &&
            "bg-accent/60 hover:bg-accent/60 text-accent-foreground",
          isExternalDropTarget &&
            "bg-primary/15 hover:bg-primary/15 text-accent-foreground",
        )}
      >
        {node.data.isRoot ? (
          <FolderRootIcon
            className="w-4 h-4 shrink-0 mr-2 text-primary"
            strokeWidth={1.5}
          />
        ) : node.data.isMarimoFile ? (
          <MarimoIcon className="w-4 h-4 shrink-0 mr-2" strokeWidth={1.5} />
        ) : (
          <Icon
            className={cn("w-4 h-4 shrink-0 mr-2", FILE_ICON_COLOR[fileType])}
            strokeWidth={1.5}
          />
        )}
        {node.isEditing ? (
          <FileNameInput node={node} />
        ) : (
          <Show node={node} onOpenMarimoFile={handleOpenMarimoFile} />
        )}
        <FileActionsDropdown
          testId="file-explorer-more-button"
          iconClassName="w-5 h-5"
        >
          {!node.data.isDirectory && (
            <DropdownMenuItem
              onSelect={() => node.activate()}
              data-testid="file-explorer-open-file-menu-item"
            >
              <ViewIcon className={MENU_ITEM_ICON_CLASS} />
              Open file
            </DropdownMenuItem>
          )}
          {!node.data.isDirectory && !isWasm() && (
            <DropdownMenuItem
              onSelect={() => {
                openFile({ path: node.data.path });
              }}
              data-testid="file-explorer-open-external-menu-item"
            >
              <ExternalLinkIcon className={MENU_ITEM_ICON_CLASS} />
              Open file in external editor
            </DropdownMenuItem>
          )}
          {node.data.isDirectory && (
            <>
              <DropdownMenuItem
                onSelect={() => handleCreateNotebook()}
                data-testid="file-explorer-create-notebook-menu-item"
              >
                <MarimoPlusIcon className={MENU_ITEM_ICON_CLASS} />
                Create notebook
              </DropdownMenuItem>
              <DropdownMenuItem
                onSelect={() => handleCreateFile()}
                data-testid="file-explorer-create-file-menu-item"
              >
                <FilePlus2Icon className={MENU_ITEM_ICON_CLASS} />
                Create file
              </DropdownMenuItem>
              <DropdownMenuItem
                onSelect={() => handleCreateFolder()}
                data-testid="file-explorer-create-folder-menu-item"
              >
                <FolderPlusIcon className={MENU_ITEM_ICON_CLASS} />
                Create folder
              </DropdownMenuItem>
              <DropdownMenuItem
                onSelect={() =>
                  fileExplorer?.uploadFiles(node.data.path as FilePath)
                }
                data-testid="file-explorer-upload-files-menu-item"
              >
                <UploadIcon className={MENU_ITEM_ICON_CLASS} />
                Upload files here
              </DropdownMenuItem>
              <DropdownMenuSeparator />
            </>
          )}
          {!node.data.isRoot && (
            <>
              <RenameMenuItem
                onSelect={() => node.edit()}
                testId="file-explorer-rename-menu-item"
              />
              <DuplicateMenuItem
                onSelect={handleDuplicate}
                testId="file-explorer-duplicate-menu-item"
              />
            </>
          )}
          <DropdownMenuItem
            onSelect={async () => {
              await copyToClipboard(node.data.path);
              toast({ title: "Copied to clipboard" });
            }}
            data-testid="file-explorer-copy-path-menu-item"
          >
            <ListTreeIcon className={MENU_ITEM_ICON_CLASS} />
            Copy path
          </DropdownMenuItem>
          {tree && node.data.isPrimaryRoot && !node.data.isRoot && (
            <DropdownMenuItem
              onSelect={async () => {
                const path = tree.getPrimaryRelativePath(
                  node.data.path as FilePath,
                );
                if (path !== null) {
                  await copyToClipboard(path);
                  toast({ title: "Copied to clipboard" });
                }
              }}
              data-testid="file-explorer-copy-relative-path-menu-item"
            >
              <ListTreeIcon className={MENU_ITEM_ICON_CLASS} />
              Copy relative path
            </DropdownMenuItem>
          )}
          {!node.data.isRoot && (
            <>
              <DropdownMenuSeparator />
              <DropdownMenuItem
                onSelect={() => {
                  const { path } = node.data;
                  const pythonCode = PYTHON_CODE_FOR_FILE_TYPE[fileType](path);
                  handleInsertCode(pythonCode);
                }}
                data-testid="file-explorer-insert-snippet-menu-item"
              >
                <BetweenHorizontalStartIcon className={MENU_ITEM_ICON_CLASS} />
                Insert snippet for reading file
              </DropdownMenuItem>
              <DropdownMenuItem
                onSelect={async () => {
                  toast({
                    title: "Copied to clipboard",
                    description:
                      "Code to open the file has been copied to your clipboard. You can also drag and drop this file into the editor",
                  });
                  const { path } = node.data;
                  const pythonCode = PYTHON_CODE_FOR_FILE_TYPE[fileType](path);
                  await copyToClipboard(pythonCode);
                }}
                data-testid="file-explorer-copy-snippet-menu-item"
              >
                <BracesIcon className={MENU_ITEM_ICON_CLASS} />
                Copy snippet for reading file
              </DropdownMenuItem>
            </>
          )}
          {node.data.isMarimoFile && node.data.isPrimaryRoot && !isWasm() && (
            <>
              <DropdownMenuSeparator />
              <DropdownMenuItem
                onSelect={handleOpenMarimoFile}
                data-testid="file-explorer-open-notebook-menu-item"
              >
                <PlaySquareIcon className={MENU_ITEM_ICON_CLASS} />
                Open notebook
              </DropdownMenuItem>
            </>
          )}
          {!node.data.isDirectory && !disableFileDownloads && (
            <>
              <DropdownMenuSeparator />
              <DropdownMenuItem
                onSelect={async () => {
                  await downloadFile(node.data.path, node.data.name);
                }}
                data-testid="file-explorer-download-menu-item"
              >
                <DownloadIcon className={MENU_ITEM_ICON_CLASS} />
                Download
              </DropdownMenuItem>
            </>
          )}
          {!node.data.isRoot && (
            <>
              <DropdownMenuSeparator />
              <DeleteMenuItem
                onSelect={handleDeleteFile}
                testId="file-explorer-delete-menu-item"
              />
            </>
          )}
        </FileActionsDropdown>
      </span>
    </div>
  );
};

const FolderArrow = ({ node }: { node: NodeApi<FileTreeNode> }) => {
  if (!node.data.isDirectory) {
    return <span className="w-4 h-4 shrink-0" />;
  }

  if (node.data.loadState === "loading") {
    return (
      <span
        role="status"
        aria-label={`Loading ${node.data.name}`}
        className="w-4 h-4 shrink-0"
      >
        <Spinner size="small" />
      </span>
    );
  }

  return <TreeChevron isExpanded={node.isOpen} className="w-4 h-4" />;
};

function openMarimoNotebook(
  event: Pick<Event, "stopPropagation" | "preventDefault">,
  path: string,
) {
  event.stopPropagation();
  event.preventDefault();
  openNotebook(path);
}

export function getUploadDestinationLabel(
  tree: RequestingTree,
  destinationPath: FilePath,
): string {
  return tree.getDisplayPath(destinationPath);
}

export function filterHiddenTree(
  list: FileTreeNode[],
  showHidden: boolean,
): FileTreeNode[] {
  if (showHidden) {
    return list;
  }

  const out: FileTreeNode[] = [];
  for (const item of list) {
    if (!item.isRoot && isDirectoryOrFileHidden(item.name)) {
      continue;
    }
    let next = item;
    if (item.children) {
      const kids = filterHiddenTree(item.children, showHidden);
      if (kids !== item.children) {
        next = { ...item, children: kids };
      }
    }
    out.push(next);
  }
  return out;
}

export function isDirectoryOrFileHidden(filename: string): boolean {
  if (filename.startsWith(".")) {
    return true;
  }
  return false;
}

function treeContainsId(list: FileTreeNode[], id: string): boolean {
  return list.some(
    (item) =>
      item.id === id ||
      (item.children ? treeContainsId(item.children, id) : false),
  );
}

function FileDragPreview({
  mouse,
  id,
  isDragging,
  tree,
}: DragPreviewProps & { tree: TreeApi<FileTreeNode> | null }) {
  const node = tree?.get(id);
  if (!isDragging || !mouse || !node) {
    return null;
  }
  const fileType = node.data.isDirectory
    ? "directory"
    : guessFileIconType(node.data.name);
  const Icon = FILE_ICON[fileType];
  return createPortal(
    <div
      className="pointer-events-none fixed left-0 top-0 z-[1000] opacity-[0.85]"
      style={{
        transform: `translate3d(${mouse.x + 12}px, ${mouse.y + 12}px, 0)`,
      }}
    >
      <div className="flex max-w-72 items-center gap-2 rounded-md border border-border bg-popover px-3 py-2 text-sm text-popover-foreground shadow-md">
        <Icon className={cn("h-4 w-4 shrink-0", FILE_ICON_COLOR[fileType])} />
        <span className="truncate">{node.data.name}</span>
      </div>
    </div>,
    document.body,
  );
}