@bendyline/docblocks-react 2.3.4 → 2.5.0

package/dist/{ExportToolbarControls-N3TCL5DD.js → ExportToolbarControls-BUVJCSMV.js}

@@ -39,7 +39,7 @@ var ExportDialog = lazy(
   () => import("./ExportDialog-VBWHFJ2R.js").then((module) => ({ default: module.ExportDialog }))
 );
 var ShareDialog = lazy(
-  () => import("./ShareDialog-PAMOQQFB.js").then((module) => ({ default: module.ShareDialog }))
+  () => import("./ShareDialog-4OX3UPJ4.js").then((module) => ({ default: module.ShareDialog }))
 );
 var runExportModulePromise = null;
 function loadRunExportModule() {

package/dist/{ShareDialog-PAMOQQFB.js → ShareDialog-4OX3UPJ4.js}

@@ -7,7 +7,7 @@ import {
   SHARED_DOCUMENT_LIMITS,
   createSharedDocumentUrl
 } from "@bendyline/docblocks/share";
-var PUBLIC_DOCBLOCKS_SHARE_URL = "https://bendyline.github.io/docblocks/";
+var PUBLIC_DOCBLOCKS_SHARE_URL = "https://docblocks.com/";
 function resolveSharedDocumentBaseUrl(currentUrl) {
   try {
     const current = new URL(currentUrl);
@@ -45,6 +45,45 @@ async function createSharedDocumentArchive(markdown, selectedFile) {
 function buildSharedDocumentUrl(baseUrl, archive, mode) {
   return createSharedDocumentUrl(resolveSharedDocumentBaseUrl(baseUrl), archive, mode);
 }
+function buildSharedDocumentQrUrl(archive, mode) {
+  const url = createSharedDocumentUrl(PUBLIC_DOCBLOCKS_SHARE_URL, archive, mode);
+  if (url.length > SHARED_DOCUMENT_LIMITS.qrUrlCharacters) {
+    throw new Error(
+      "This document is too large for a reliable QR code (maximum " + SHARED_DOCUMENT_LIMITS.qrUrlCharacters.toLocaleString() + " URL characters). Copy the share link instead."
+    );
+  }
+  return url;
+}
+function sharedDocumentQrFilename(selectedFile) {
+  return sharedDocumentFilename(selectedFile).replace(/\.md$/iu, "-qr.png");
+}
+
+// src/Export/share-qr.ts
+import QRCode from "qrcode";
+async function renderSharedDocumentQrPng(url) {
+  return QRCode.toDataURL(url, {
+    type: "image/png",
+    errorCorrectionLevel: "M",
+    margin: 4,
+    width: 1024,
+    color: {
+      dark: "#111111ff",
+      light: "#ffffffff"
+    }
+  });
+}
+function qrPngDataUrlToBlob(dataUrl) {
+  const prefix = "data:image/png;base64,";
+  if (!dataUrl.startsWith(prefix)) {
+    throw new Error("The QR code renderer returned an unsupported image format.");
+  }
+  const binary = atob(dataUrl.slice(prefix.length));
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) {
+    bytes[index] = binary.charCodeAt(index);
+  }
+  return new Blob([bytes], { type: "image/png" });
+}
 
 // src/Export/ShareDialog.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -56,11 +95,19 @@ var MODES = [
   { value: "document", label: "Document" },
   { value: "narrate", label: "Narrate" }
 ];
-function ShareDialog({ markdown, selectedFile, baseUrl, onClose }) {
+function ShareDialog({
+  markdown,
+  selectedFile,
+  baseUrl,
+  onClose
+}) {
   const [mode, setMode] = useState("");
   const [archive, setArchive] = useState(null);
   const [archiveError, setArchiveError] = useState(null);
   const [copyStatus, setCopyStatus] = useState("idle");
+  const [qrDataUrl, setQrDataUrl] = useState(null);
+  const [qrRenderError, setQrRenderError] = useState(null);
+  const [qrCopyStatus, setQrCopyStatus] = useState("idle");
   const linkRef = useRef(null);
   useEffect(() => {
     let cancelled = false;
@@ -90,6 +137,36 @@ function ShareDialog({ markdown, selectedFile, baseUrl, onClose }) {
       };
     }
   }, [archive, archiveError, baseUrl, mode]);
+  const qrLinkResult = useMemo(() => {
+    if (!archive) return { url: "", error: archiveError };
+    try {
+      return { url: buildSharedDocumentQrUrl(archive, mode || null), error: null };
+    } catch (error) {
+      return {
+        url: "",
+        error: error instanceof Error ? error.message : "DocBlocks could not create the QR code."
+      };
+    }
+  }, [archive, archiveError, mode]);
+  useEffect(() => {
+    let cancelled = false;
+    setQrDataUrl(null);
+    setQrRenderError(null);
+    setQrCopyStatus("idle");
+    if (!qrLinkResult.url) return;
+    void renderSharedDocumentQrPng(qrLinkResult.url).then((dataUrl) => {
+      if (!cancelled) setQrDataUrl(dataUrl);
+    }).catch((error) => {
+      if (!cancelled) {
+        setQrRenderError(
+          error instanceof Error ? error.message : "DocBlocks could not render the QR code."
+        );
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [qrLinkResult.url]);
   useEffect(() => setCopyStatus("idle"), [linkResult.url]);
   useEffect(() => {
     const handleKeyDown = (event) => {
@@ -117,7 +194,31 @@ function ShareDialog({ markdown, selectedFile, baseUrl, onClose }) {
       setCopyStatus("failed");
     }
   }, [linkResult.url]);
+  const copyQrImage = useCallback(async () => {
+    if (!qrDataUrl) return;
+    try {
+      if (!navigator.clipboard?.write || typeof ClipboardItem === "undefined") {
+        throw new Error("Image clipboard access is unavailable.");
+      }
+      const png = qrPngDataUrlToBlob(qrDataUrl);
+      await navigator.clipboard.write([new ClipboardItem({ "image/png": png })]);
+      setQrCopyStatus("copied");
+    } catch {
+      setQrCopyStatus("failed");
+    }
+  }, [qrDataUrl]);
+  const saveQrImage = useCallback(() => {
+    if (!qrDataUrl) return;
+    const download = document.createElement("a");
+    download.href = qrDataUrl;
+    download.download = sharedDocumentQrFilename(selectedFile);
+    download.style.display = "none";
+    document.body.append(download);
+    download.click();
+    download.remove();
+  }, [qrDataUrl, selectedFile]);
   const isLong = linkResult.url.length > SHARED_DOCUMENT_LIMITS2.portableUrlCharacters;
+  const qrError = qrLinkResult.error ?? qrRenderError;
   return /* @__PURE__ */ jsx(
     "div",
     {
@@ -134,7 +235,7 @@ function ShareDialog({ markdown, selectedFile, baseUrl, onClose }) {
           "aria-labelledby": "db-share-dialog-title",
           children: [
             /* @__PURE__ */ jsxs("div", { className: "db-dialog-header", children: [
-              /* @__PURE__ */ jsx("h2", { className: "db-dialog-title", id: "db-share-dialog-title", children: "Share document via URL" }),
+              /* @__PURE__ */ jsx("h2", { className: "db-dialog-title", id: "db-share-dialog-title", children: "Share document" }),
               /* @__PURE__ */ jsx("button", { className: "db-dialog-close", type: "button", onClick: onClose, "aria-label": "Close", children: "\xD7" })
             ] }),
             /* @__PURE__ */ jsxs("div", { className: "db-dialog-body", children: [
@@ -178,6 +279,52 @@ function ShareDialog({ markdown, selectedFile, baseUrl, onClose }) {
                   }
                 )
               ] }),
+              /* @__PURE__ */ jsxs("section", { className: "db-share-qr", "aria-labelledby": "db-share-qr-title", children: [
+                /* @__PURE__ */ jsxs("div", { className: "db-share-qr-heading", children: [
+                  /* @__PURE__ */ jsxs("div", { children: [
+                    /* @__PURE__ */ jsx("h3", { id: "db-share-qr-title", children: "QR code" }),
+                    /* @__PURE__ */ jsx("span", { className: "db-export-hint", children: "A self-contained docblocks.com link. No document content is uploaded." })
+                  ] }),
+                  /* @__PURE__ */ jsxs("div", { className: "db-share-qr-actions", children: [
+                    /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        className: "db-export-btn db-export-btn--secondary",
+                        type: "button",
+                        onClick: () => void copyQrImage(),
+                        disabled: !qrDataUrl,
+                        children: qrCopyStatus === "copied" ? "Copied QR" : qrCopyStatus === "failed" ? "Copy unavailable" : "Copy QR image"
+                      }
+                    ),
+                    /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        className: "db-export-btn db-export-btn--secondary",
+                        type: "button",
+                        onClick: saveQrImage,
+                        disabled: !qrDataUrl,
+                        children: "Save QR PNG"
+                      }
+                    )
+                  ] })
+                ] }),
+                qrDataUrl ? /* @__PURE__ */ jsx(
+                  "img",
+                  {
+                    className: "db-share-qr-image",
+                    src: qrDataUrl,
+                    alt: "QR code for this shared DocBlocks document"
+                  }
+                ) : /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: `db-share-qr-placeholder${qrError ? " db-share-qr-placeholder--error" : ""}`,
+                    role: qrError ? "note" : "status",
+                    children: qrError ?? "Rendering QR code..."
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "db-export-hint db-share-qr-status", "aria-live": "polite", children: qrCopyStatus === "failed" ? "This browser could not copy the PNG. Save it instead." : qrDataUrl ? `${qrLinkResult.url.length.toLocaleString()} of ${SHARED_DOCUMENT_LIMITS2.qrUrlCharacters.toLocaleString()} supported QR characters.` : "" })
+              ] }),
               /* @__PURE__ */ jsx("p", { className: "db-share-temporary-note", children: "Opening the link creates a temporary workspace. Changes there do not alter this document or the link." })
             ] }),
             /* @__PURE__ */ jsxs("div", { className: "db-export-footer", children: [

package/dist/{chunk-BI7NVU6T.js → chunk-FNSRCCBC.js}

@@ -1,3 +1,12 @@
+// src/Export/image-save.ts
+function createImageSaveOutput(adapter) {
+  return async (blob, filename) => {
+    const target = await adapter.pickTarget(filename, null);
+    if (!target) return false;
+    return await adapter.saveBlob(blob, filename, target) !== null;
+  };
+}
+
 // src/Export/export-destination.ts
 function updateExportTargetExtension(targetPath, suggestedFilename) {
   const nextExtension = extensionOf(suggestedFilename);
@@ -27,5 +36,6 @@ function firstSuffixIndex(value) {
 }
 
 export {
+  createImageSaveOutput,
   updateExportTargetExtension
 };

package/dist/export/index.d.ts

@@ -101,4 +101,26 @@ declare function ExportDialog({ initial, exporting, error, destination, onExport
 /** Keep a user-edited target name while switching the selected export format. */
 declare function updateExportTargetExtension(targetPath: string, suggestedFilename: string): string;
 
-export { DEFAULT_OPTIONS, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, buildExportFilename, loadLastExportOptions, runExport, saveExportOptions, updateExportTargetExtension };
+/**
+ * Host persistence for the editor's raster-image exporters.
+ *
+ * Squisq renders both the cover image and the Dashboard image in the
+ * browser and hands the host a finished blob; DocBlocks owns where that
+ * blob lands. The two exporters share one contract upstream
+ * (`DashboardImageSaveOutput` is an alias of `CoverImageSaveOutput`), so
+ * they share one adapter here rather than two identical copies.
+ */
+/** Host persistence shape required by the editor's image exporters. */
+interface ImageSaveAdapter<TTarget> {
+    pickTarget(filename: string, currentTarget?: TTarget | null): Promise<TTarget | null>;
+    saveBlob(blob: Blob, filename: string, target?: TTarget | null): Promise<TTarget | null>;
+}
+type ImageSaveOutput = (blob: Blob, filename: string) => Promise<boolean | void>;
+/**
+ * Adapt DocBlocks' two-step host destination flow to Squisq's rendered image
+ * output callback. The picker stays host-owned, and cancellation is reported
+ * as `false` so the export dialog remains open without showing an error.
+ */
+declare function createImageSaveOutput<TTarget>(adapter: ImageSaveAdapter<TTarget>): ImageSaveOutput;
+
+export { type ImageSaveAdapter as CoverImageSaveAdapter, type ImageSaveOutput as CoverImageSaveOutput, DEFAULT_OPTIONS, type ImageSaveAdapter as DashboardImageSaveAdapter, type ImageSaveOutput as DashboardImageSaveOutput, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, type ImageSaveAdapter, type ImageSaveOutput, buildExportFilename, createImageSaveOutput as createCoverImageSaveOutput, createImageSaveOutput as createDashboardImageSaveOutput, createImageSaveOutput, loadLastExportOptions, runExport, saveExportOptions, updateExportTargetExtension };

package/dist/export/index.js

@@ -1,6 +1,7 @@
 import {
+  createImageSaveOutput,
   updateExportTargetExtension
-} from "../chunk-BI7NVU6T.js";
+} from "../chunk-FNSRCCBC.js";
 import {
   ExportDialog
 } from "../chunk-SIIEGOHY.js";
@@ -25,6 +26,9 @@ export {
   FORMAT_EXTENSIONS,
   FORMAT_LABELS,
   buildExportFilename,
+  createImageSaveOutput as createCoverImageSaveOutput,
+  createImageSaveOutput as createDashboardImageSaveOutput,
+  createImageSaveOutput,
   loadLastExportOptions,
   runExport,
   saveExportOptions,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { FileSystemProvider, FileSystemEntry, FsErrorCode } from '@bendyline/docblocks/filesystem';
+import { FileSystemEntry, FileSystemProvider, FsErrorCode } from '@bendyline/docblocks/filesystem';
 import { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
 import { EditorColorScheme } from '@bendyline/squisq-editor-react';
 import { CodeBlockCopyHandler } from '@bendyline/squisq-react';
@@ -12,11 +12,79 @@ import { MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { VideoExportModalProps } from '@bendyline/squisq-video-react';
 import { ExportBlobSaver } from './export/index.js';
-export { DEFAULT_OPTIONS, ExportDestinationControl, ExportDialog, ExportDialogProps, ExportFormat, ExportOptions, HtmlBundle, HtmlStyle, buildExportFilename, loadLastExportOptions, runExport, updateExportTargetExtension } from './export/index.js';
+export { CoverImageSaveAdapter, CoverImageSaveOutput, DEFAULT_OPTIONS, CoverImageSaveAdapter as DashboardImageSaveAdapter, CoverImageSaveOutput as DashboardImageSaveOutput, ExportDestinationControl, ExportDialog, ExportDialogProps, ExportFormat, ExportOptions, HtmlBundle, HtmlStyle, CoverImageSaveAdapter as ImageSaveAdapter, CoverImageSaveOutput as ImageSaveOutput, buildExportFilename, createCoverImageSaveOutput, createCoverImageSaveOutput as createDashboardImageSaveOutput, createCoverImageSaveOutput as createImageSaveOutput, loadLastExportOptions, runExport, updateExportTargetExtension } from './export/index.js';
 import { DocumentSession, DocumentSessionSnapshot } from '@bendyline/docblocks/document';
 import 'react';
 import '@bendyline/squisq-formats/pptx';
 
+/** Git decoration for a row — precomputed by FileExplorer so this node stays context-free. */
+interface FileTreeNodeBadge {
+    kind: string;
+    glyph: string;
+    label: string;
+}
+/** Git context-menu actions, prebound to this entry's path. */
+interface FileTreeNodeGitActions {
+    viewChanges?: () => void;
+    fileHistory?: () => void;
+    openOnRemote?: () => void;
+}
+/** Host-owned row action shown in both pointer and keyboard menus. */
+interface FileTreeNodeAction {
+    label: string;
+    onSelect: () => void | Promise<void>;
+    disabled?: boolean;
+}
+interface FileTreeNodeProps {
+    entry: FileSystemEntry;
+    depth: number;
+    expanded: boolean;
+    selected: boolean;
+    badge?: FileTreeNodeBadge;
+    gitActions?: FileTreeNodeGitActions;
+    actions?: readonly FileTreeNodeAction[];
+    children?: FileSystemEntry[];
+    /**
+     * Roving tabindex: true only for the tree's single tab stop. Defaults to
+     * true so a node rendered on its own is still reachable.
+     */
+    focusable?: boolean;
+    /** 1-based position among siblings, for aria-posinset. */
+    posInSet?: number;
+    /** Number of siblings, for aria-setsize. */
+    setSize?: number;
+    /** The row took focus (click or arrow key) — move the roving tab stop. */
+    onRowFocus?: (path: string) => void;
+    onToggle: (path: string) => void;
+    onSelect: (path: string) => void;
+    /**
+     * Ask the user to confirm an irreversible delete. Resolve `false` to abort.
+     *
+     * Optional so a standalone `<FileTreeNode>` still asks before destroying
+     * something; hosts that have their own dialog (as `<DocBlocksShell>` does)
+     * pass it here so the prompt matches the product instead of being a native
+     * browser/Electron dialog.
+     */
+    confirmDelete?: (message: string) => boolean | Promise<boolean>;
+    onDelete: (path: string, kind: 'file' | 'directory') => Promise<void>;
+    onRename: (oldPath: string, newPath: string, kind: 'file' | 'directory') => Promise<void>;
+    /** Whether this document is present in the shell's cross-workspace pin list. */
+    pinned?: boolean;
+    /** Pin or unpin this file. Omitted for directories and standalone trees. */
+    onTogglePin?: (path: string) => void | Promise<void>;
+    draggable?: boolean;
+    dragging?: boolean;
+    dropTarget?: boolean;
+    onDragStart?: (event: React.DragEvent, entry: FileSystemEntry) => void;
+    onDragEnd?: () => void;
+    onDragOverEntry?: (event: React.DragEvent, entry: FileSystemEntry) => void;
+    onDropEntry?: (event: React.DragEvent, entry: FileSystemEntry) => void;
+    renderChildren?: (dirPath: string) => React.ReactNode;
+    /** Path-scoped directory loading failure, rendered outside the ARIA tree group. */
+    childError?: React.ReactNode;
+}
+declare function FileTreeNode({ entry, depth, expanded, selected, badge, gitActions, actions, focusable, posInSet, setSize, onRowFocus, onToggle, onSelect, confirmDelete, onDelete, onRename, pinned, onTogglePin, draggable, dragging, dropTarget, onDragStart, onDragEnd, onDragOverEntry, onDropEntry, renderChildren, childError, }: FileTreeNodeProps): react_jsx_runtime.JSX.Element;
+
 interface PinnedDocument {
     readonly workspaceId: string;
     readonly workspaceName: string;
@@ -78,6 +146,10 @@ interface FileExplorerProps {
     onTogglePin?: (path: string) => void | Promise<void>;
     /** Called when any entry is selected (file or directory). */
     onSelect?: (path: string, kind: 'file' | 'directory') => void;
+    /** Opens the active native workspace root in the platform file manager. */
+    onOpenWorkspaceFolder?: () => void;
+    /** Host-owned context actions for an entry. */
+    actionsForEntry?: (entry: FileSystemEntry) => readonly FileTreeNodeAction[];
     /**
      * Wraps destructive tree mutations so the active document session can
      * flush, cancel, or retarget itself before storage changes.
@@ -100,68 +172,7 @@ interface FileExplorerProps {
     /** Optional className for the root element. */
     className?: string;
 }
-declare function FileExplorer({ provider, metadataRefreshKey, activeFilePath, sortMode, onSortModeChange, activeWorkspaceId, pinnedDocuments, pinnedPaths, onPinnedDocumentSelect, onPinnedDocumentUnpin, onPinnedDocumentRename, onPinnedDocumentDelete, onTogglePin, onSelect, onTreeMutation, onTreeChange, onImportFiles, confirmDelete, moveDestinations, onMoveToWorkspace, className, }: FileExplorerProps): react_jsx_runtime.JSX.Element;
-
-/** Git decoration for a row — precomputed by FileExplorer so this node stays context-free. */
-interface FileTreeNodeBadge {
-    kind: string;
-    glyph: string;
-    label: string;
-}
-/** Git context-menu actions, prebound to this entry's path. */
-interface FileTreeNodeGitActions {
-    viewChanges?: () => void;
-    fileHistory?: () => void;
-    openOnRemote?: () => void;
-}
-interface FileTreeNodeProps {
-    entry: FileSystemEntry;
-    depth: number;
-    expanded: boolean;
-    selected: boolean;
-    badge?: FileTreeNodeBadge;
-    gitActions?: FileTreeNodeGitActions;
-    children?: FileSystemEntry[];
-    /**
-     * Roving tabindex: true only for the tree's single tab stop. Defaults to
-     * true so a node rendered on its own is still reachable.
-     */
-    focusable?: boolean;
-    /** 1-based position among siblings, for aria-posinset. */
-    posInSet?: number;
-    /** Number of siblings, for aria-setsize. */
-    setSize?: number;
-    /** The row took focus (click or arrow key) — move the roving tab stop. */
-    onRowFocus?: (path: string) => void;
-    onToggle: (path: string) => void;
-    onSelect: (path: string) => void;
-    /**
-     * Ask the user to confirm an irreversible delete. Resolve `false` to abort.
-     *
-     * Optional so a standalone `<FileTreeNode>` still asks before destroying
-     * something; hosts that have their own dialog (as `<DocBlocksShell>` does)
-     * pass it here so the prompt matches the product instead of being a native
-     * browser/Electron dialog.
-     */
-    confirmDelete?: (message: string) => boolean | Promise<boolean>;
-    onDelete: (path: string, kind: 'file' | 'directory') => Promise<void>;
-    onRename: (oldPath: string, newPath: string, kind: 'file' | 'directory') => Promise<void>;
-    /** Whether this document is present in the shell's cross-workspace pin list. */
-    pinned?: boolean;
-    /** Pin or unpin this file. Omitted for directories and standalone trees. */
-    onTogglePin?: (path: string) => void | Promise<void>;
-    draggable?: boolean;
-    dragging?: boolean;
-    dropTarget?: boolean;
-    onDragStart?: (event: React.DragEvent, entry: FileSystemEntry) => void;
-    onDragEnd?: () => void;
-    onDragOverEntry?: (event: React.DragEvent, entry: FileSystemEntry) => void;
-    onDropEntry?: (event: React.DragEvent, entry: FileSystemEntry) => void;
-    renderChildren?: (dirPath: string) => React.ReactNode;
-    /** Path-scoped directory loading failure, rendered outside the ARIA tree group. */
-    childError?: React.ReactNode;
-}
-declare function FileTreeNode({ entry, depth, expanded, selected, badge, gitActions, focusable, posInSet, setSize, onRowFocus, onToggle, onSelect, confirmDelete, onDelete, onRename, pinned, onTogglePin, draggable, dragging, dropTarget, onDragStart, onDragEnd, onDragOverEntry, onDropEntry, renderChildren, childError, }: FileTreeNodeProps): react_jsx_runtime.JSX.Element;
+declare function FileExplorer({ provider, metadataRefreshKey, activeFilePath, sortMode, onSortModeChange, activeWorkspaceId, pinnedDocuments, pinnedPaths, onPinnedDocumentSelect, onPinnedDocumentUnpin, onPinnedDocumentRename, onPinnedDocumentDelete, onTogglePin, onSelect, onOpenWorkspaceFolder, actionsForEntry, onTreeMutation, onTreeChange, onImportFiles, confirmDelete, moveDestinations, onMoveToWorkspace, className, }: FileExplorerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * useFileTree — hook that reads from a FileSystemProvider,