@bendyline/docblocks-react 2.2.1 → 2.2.2

package/dist/index.js

@@ -13,20 +13,24 @@ import {
 import {
   AccentColorSettings,
   DB_CHROME_COLORS,
+  DEFAULT_WRITE_CANVAS_FONT_SCHEME,
   DEFAULT_WRITE_CANVAS_PREFERENCES,
   SettingsDialog,
   ThemeSettings,
+  WRITE_CANVAS_FONT_SCHEMES,
   WriteCanvasSettingsControls,
   loadAccentColor,
   loadThemePreference,
   loadWriteCanvasPreferences,
+  resolveWriteCanvasFonts,
   saveAccentColor,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-3QSZY74C.js";
+} from "./chunk-VRRL6VTD.js";
 import {
-  pickEmptyDocumentPrompt
-} from "./chunk-BPGEBGAN.js";
+  pickEmptyDocumentPrompt,
+  useResponsivePreviewViewportPreset
+} from "./chunk-JDJVRDOP.js";
 import {
   ExportDialog
 } from "./chunk-MHTQORMH.js";
@@ -34,6 +38,9 @@ import {
   buildExportFilename,
   runExport
 } from "./chunk-GHQ4X7KM.js";
+import {
+  useMenuKeyboard
+} from "./chunk-MRUK56JS.js";
 import "./chunk-YBEYTVU2.js";
 import {
   Dialog
@@ -44,7 +51,7 @@ import {
 } from "./chunk-EBWYGTN7.js";
 
 // src/FileExplorer/FileExplorer.tsx
-import { useCallback as useCallback3, useEffect as useEffect3, useMemo, useRef as useRef3, useState as useState3 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect4, useMemo, useRef as useRef4, useState as useState4 } from "react";
 import {
   isFileSystemMoveStateError,
   parseWorkspacePath as parseWorkspacePath2
@@ -54,10 +61,12 @@ import {
 import { useState, useCallback, useEffect, useRef } from "react";
 import {
   FsError,
+  fsErrorFromUnknown,
   getFileSystemProviderV2,
   moveFileSystemEntry,
   parseWorkspacePath
 } from "@bendyline/docblocks/filesystem";
+var DIRECTORY_NOT_FOUND_RETRY_DELAYS_MS = Object.freeze([40, 120]);
 function normalisePath(path) {
   return parseWorkspacePath(path);
 }
@@ -83,10 +92,44 @@ function hasEquivalentPath(paths, path) {
   return equivalentPathKeys(path).some((candidate) => paths.has(candidate));
 }
 async function readProviderDirectory(provider, path) {
-  const providerV2 = getFileSystemProviderV2(provider);
-  if (!providerV2) return provider.readDirectory(path);
-  const entries = await providerV2.readDirectory(parseWorkspacePath(path));
-  return entries.map((entry) => ({ kind: entry.kind, name: entry.name, path: entry.path }));
+  const canonical = parseWorkspacePath(path);
+  const readOnce = async () => {
+    const providerV2 = getFileSystemProviderV2(provider);
+    if (!providerV2) return provider.readDirectory(path);
+    const entries = await providerV2.readDirectory(canonical);
+    return entries.map((entry) => ({ kind: entry.kind, name: entry.name, path: entry.path }));
+  };
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      return await readOnce();
+    } catch (caught) {
+      const error = directoryReadError(caught, canonical);
+      const retryDelay = DIRECTORY_NOT_FOUND_RETRY_DELAYS_MS[attempt];
+      if (error.code !== "not-found" || retryDelay === void 0) throw error;
+      await new Promise((resolve) => setTimeout(resolve, retryDelay));
+    }
+  }
+}
+function directoryReadError(caught, requestedPath) {
+  const error = fsErrorFromUnknown(caught, { operation: "list", path: requestedPath });
+  if (error.path !== null) return error;
+  return new FsError(error.code, error.message, {
+    operation: error.operation ?? "list",
+    path: requestedPath,
+    destinationPath: error.destinationPath ?? void 0,
+    retryable: error.retryable
+  });
+}
+function readIssue(caught, directoryPath) {
+  const canonical = parseWorkspacePath(directoryPath);
+  const error = directoryReadError(caught, canonical);
+  return Object.freeze({
+    directoryPath: canonical,
+    path: error.path ?? canonical,
+    code: error.code,
+    message: error.message,
+    retryable: error.retryable || error.code === "not-found"
+  });
 }
 function useFileTree(provider) {
   const [entries, setEntries] = useState([]);
@@ -94,12 +137,15 @@ function useFileTree(provider) {
   const [selectedPath, setSelectedPath] = useState(null);
   const [selectedKind, setSelectedKind] = useState(null);
   const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
+  const [rootIssue, setRootIssue] = useState(null);
+  const [childIssues, setChildIssues] = useState(/* @__PURE__ */ new Map());
   const [childEntries, setChildEntries] = useState(/* @__PURE__ */ new Map());
   const providerRef = useRef(provider);
   providerRef.current = provider;
-  const reportError = useCallback((caught) => {
-    setError(caught instanceof Error ? caught.message : "Unable to read this workspace.");
+  const directoryRequestSequenceRef = useRef(0);
+  const directoryRequestsRef = useRef(/* @__PURE__ */ new Map());
+  const reportRootIssue = useCallback((caught) => {
+    setRootIssue(readIssue(caught, ""));
   }, []);
   const loadRoot = useCallback(async () => {
     const sourceProvider = providerRef.current;
@@ -108,43 +154,60 @@ function useFileTree(provider) {
       setLoading(false);
       return;
     }
+    const requestId = ++directoryRequestSequenceRef.current;
+    directoryRequestsRef.current.set("", requestId);
+    const isCurrent = () => providerRef.current === sourceProvider && directoryRequestsRef.current.get("") === requestId;
     setLoading(true);
-    setError(null);
     try {
       const root = await readProviderDirectory(sourceProvider, "");
-      if (providerRef.current !== sourceProvider) return;
+      if (!isCurrent()) return;
       setEntries(root);
+      setRootIssue(null);
     } catch (caught) {
-      if (providerRef.current === sourceProvider) reportError(caught);
+      if (isCurrent()) setRootIssue(readIssue(caught, ""));
     } finally {
-      if (providerRef.current === sourceProvider) setLoading(false);
+      if (isCurrent()) setLoading(false);
     }
-  }, [reportError]);
-  const loadChildren = useCallback(
-    async (dirPath) => {
-      const sourceProvider = providerRef.current;
-      if (!sourceProvider) return;
-      try {
-        const children = await readProviderDirectory(sourceProvider, dirPath);
-        if (providerRef.current !== sourceProvider) return;
-        setChildEntries((prev) => {
-          const next = new Map(prev);
-          next.set(dirPath, children);
-          return next;
-        });
-      } catch (caught) {
-        if (providerRef.current === sourceProvider) reportError(caught);
-      }
-    },
-    [reportError]
-  );
+  }, []);
+  const loadChildren = useCallback(async (dirPath) => {
+    const sourceProvider = providerRef.current;
+    if (!sourceProvider) return;
+    const canonical = normalisePath(dirPath);
+    const requestId = ++directoryRequestSequenceRef.current;
+    directoryRequestsRef.current.set(canonical, requestId);
+    const isCurrent = () => providerRef.current === sourceProvider && directoryRequestsRef.current.get(canonical) === requestId;
+    try {
+      const children = await readProviderDirectory(sourceProvider, dirPath);
+      if (!isCurrent()) return;
+      setChildEntries((prev) => {
+        const next = new Map(prev);
+        next.set(canonical, children);
+        return next;
+      });
+      setChildIssues((prev) => {
+        if (!prev.has(canonical)) return prev;
+        const next = new Map(prev);
+        next.delete(canonical);
+        return next;
+      });
+    } catch (caught) {
+      if (!isCurrent()) return;
+      setChildIssues((prev) => {
+        const next = new Map(prev);
+        next.set(canonical, readIssue(caught, dirPath));
+        return next;
+      });
+    }
+  }, []);
   useEffect(() => {
     setEntries([]);
     setExpanded(/* @__PURE__ */ new Set());
     setChildEntries(/* @__PURE__ */ new Map());
+    setChildIssues(/* @__PURE__ */ new Map());
     setSelectedPath(null);
     setSelectedKind(null);
-    setError(null);
+    setRootIssue(null);
+    directoryRequestsRef.current.clear();
     void loadRoot();
   }, [provider, loadRoot]);
   const toggleExpand = useCallback(
@@ -191,6 +254,13 @@ function useFileTree(provider) {
       await loadChildren(dirPath);
     }
   }, [loadRoot, loadChildren, expanded]);
+  const retryDirectory = useCallback(
+    async (path) => {
+      if (normalisePath(path) === "") await loadRoot();
+      else await loadChildren(path);
+    },
+    [loadRoot, loadChildren]
+  );
   const refreshRef = useRef(refresh);
   refreshRef.current = refresh;
   useEffect(() => {
@@ -214,7 +284,7 @@ function useFileTree(provider) {
             await refreshRef.current();
           } while (refreshAgain && !disposed);
         } catch (caught) {
-          reportError(caught);
+          reportRootIssue(caught);
         } finally {
           refreshing = false;
           if (refreshAgain && !disposed) requestRefresh();
@@ -229,23 +299,25 @@ function useFileTree(provider) {
       {
         onError: (caught) => {
           if (disposed) return;
-          reportError(caught);
+          reportRootIssue(caught);
           requestRefresh();
         }
       }
     );
     void subscription.ready.catch((caught) => {
-      if (!disposed) reportError(caught);
+      if (!disposed) reportRootIssue(caught);
     });
     return () => {
       disposed = true;
       void subscription.dispose();
     };
-  }, [provider, reportError]);
+  }, [provider, reportRootIssue]);
   useEffect(() => {
     if (!provider) return;
+    const providerV2 = getFileSystemProviderV2(provider);
+    if (providerV2?.capabilities.watch) return;
     const refreshOnFocus = () => {
-      void refreshRef.current().catch(reportError);
+      void refreshRef.current().catch(reportRootIssue);
     };
     const refreshOnVisibility = () => {
       if (document.visibilityState === "visible") refreshOnFocus();
@@ -256,7 +328,7 @@ function useFileTree(provider) {
       window.removeEventListener("focus", refreshOnFocus);
       document.removeEventListener("visibilitychange", refreshOnVisibility);
     };
-  }, [provider, reportError]);
+  }, [provider, reportRootIssue]);
   const createFile = useCallback(
     async (path, content = "") => {
       if (!providerRef.current) return;
@@ -331,6 +403,7 @@ function useFileTree(provider) {
       );
       setExpanded(nextExpanded);
       setChildEntries(/* @__PURE__ */ new Map());
+      setChildIssues(/* @__PURE__ */ new Map());
       await loadRoot();
       for (const dirPath of nextExpanded) {
         await loadChildren(dirPath);
@@ -344,7 +417,10 @@ function useFileTree(provider) {
     selectedPath,
     selectedKind,
     loading,
-    error,
+    error: rootIssue?.message ?? null,
+    rootIssue,
+    childIssues,
+    childEntries,
     toggleExpand,
     select,
     reveal,
@@ -353,8 +429,7 @@ function useFileTree(provider) {
     deleteEntry,
     renameEntry,
     refresh,
-    // Expose child entries for rendering
-    ...{ childEntries }
+    retryDirectory
   };
 }
 
@@ -379,6 +454,9 @@ function FolderIcon() {
 function MoreIcon() {
   return /* @__PURE__ */ jsx(FontAwesomeIcon, { icon: "fa-solid fa-ellipsis" });
 }
+function PinIcon() {
+  return /* @__PURE__ */ jsx(FontAwesomeIcon, { icon: "fa-solid fa-thumbtack" });
+}
 function WorkspaceIcon() {
   return /* @__PURE__ */ jsx(FontAwesomeIcon, { icon: "fa-solid fa-gear" });
 }
@@ -425,6 +503,8 @@ function FileTreeNode({
   confirmDelete = defaultConfirmDelete,
   onDelete,
   onRename,
+  pinned = false,
+  onTogglePin,
   draggable = false,
   dragging = false,
   dropTarget = false,
@@ -432,7 +512,8 @@ function FileTreeNode({
   onDragEnd,
   onDragOverEntry,
   onDropEntry,
-  renderChildren
+  renderChildren,
+  childError
 }) {
   const [renaming, setRenaming] = useState2(false);
   const [renameValue, setRenameValue] = useState2(entry.name);
@@ -445,8 +526,10 @@ function FileTreeNode({
   const rowRef = useRef2(null);
   const keyboardMenuRef = useRef2(false);
   const renameSubmittedRef = useRef2(false);
+  const returnFocusAfterRenameRef = useRef2(false);
   const isDir = entry.kind === "directory";
-  const icon = isDir ? expanded ? "\u25BE" : "\u25B8" : "\xA0\xA0";
+  const icon = expanded ? "\u25BE" : "\u25B8";
+  const nestedFileInset = !isDir && depth > 0 ? 8 : 0;
   const handleClick = useCallback2(() => {
     if (isDir) {
       onToggle(entry.path);
@@ -537,22 +620,27 @@ function FileTreeNode({
   }, [entry.name, closeMenu]);
   const handleRenameCancel = useCallback2(() => {
     renameSubmittedRef.current = true;
+    returnFocusAfterRenameRef.current = true;
     setRenaming(false);
   }, []);
-  const handleRenameSubmit = useCallback2(async () => {
-    if (renameSubmittedRef.current) return;
-    renameSubmittedRef.current = true;
-    if (renameValue && renameValue !== entry.name) {
-      const parentPath2 = entry.path.includes("/") ? entry.path.slice(0, entry.path.lastIndexOf("/")) : "";
-      const newPath = parentPath2 ? `${parentPath2}/${renameValue}` : renameValue;
-      try {
-        await onRename(entry.path, newPath, entry.kind);
-      } catch (caught) {
-        setActionError(caught instanceof Error ? caught.message : "Unable to rename this entry.");
+  const handleRenameSubmit = useCallback2(
+    async (returnFocus = false) => {
+      if (renameSubmittedRef.current) return;
+      renameSubmittedRef.current = true;
+      returnFocusAfterRenameRef.current = returnFocus;
+      setRenaming(false);
+      if (renameValue && renameValue !== entry.name) {
+        const parentPath2 = entry.path.includes("/") ? entry.path.slice(0, entry.path.lastIndexOf("/")) : "";
+        const newPath = parentPath2 ? `${parentPath2}/${renameValue}` : renameValue;
+        try {
+          await onRename(entry.path, newPath, entry.kind);
+        } catch (caught) {
+          setActionError(caught instanceof Error ? caught.message : "Unable to rename this entry.");
+        }
       }
-    }
-    setRenaming(false);
-  }, [renameValue, entry.name, entry.path, entry.kind, onRename]);
+    },
+    [renameValue, entry.name, entry.path, entry.kind, onRename]
+  );
   const handleDeleteClick = useCallback2(async () => {
     closeMenu(false);
     setActionError(null);
@@ -566,6 +654,17 @@ function FileTreeNode({
       setActionError(caught instanceof Error ? caught.message : "Unable to delete this entry.");
     }
   }, [entry.name, entry.path, entry.kind, confirmDelete, onDelete, closeMenu]);
+  const handleTogglePin = useCallback2(async () => {
+    closeMenu(false);
+    setActionError(null);
+    try {
+      await onTogglePin?.(entry.path);
+    } catch (caught) {
+      setActionError(
+        caught instanceof Error ? caught.message : `Unable to ${pinned ? "unpin" : "pin"} this file.`
+      );
+    }
+  }, [closeMenu, entry.path, onTogglePin, pinned]);
   useEffect2(() => {
     if (!showContext) return;
     function handleClose(e) {
@@ -591,6 +690,11 @@ function FileTreeNode({
       inputRef.current.select();
     }
   }, [renaming]);
+  useEffect2(() => {
+    if (renaming || !returnFocusAfterRenameRef.current) return;
+    returnFocusAfterRenameRef.current = false;
+    rowRef.current?.focus({ preventScroll: true });
+  }, [renaming]);
   useEffect2(() => {
     if (!showContext || !keyboardMenuRef.current) return;
     focusMenuItem(0);
@@ -622,7 +726,7 @@ function FileTreeNode({
       {
         ref: rowRef,
         className: `db-tree-row ${selected ? "db-tree-row--selected" : ""} ${dragging ? "db-tree-row--dragging" : ""} ${dropTarget ? "db-tree-row--drop-target" : ""}`,
-        style: { paddingLeft: depth * 16 + 4 },
+        style: { paddingLeft: depth * 12 + 4 + nestedFileInset },
         onClick: handleClick,
         onContextMenu: handleContextMenu,
         draggable: draggable && !renaming,
@@ -665,7 +769,7 @@ function FileTreeNode({
           }
         },
         children: [
-          /* @__PURE__ */ jsx2("span", { className: "db-tree-icon", children: icon }),
+          (isDir || depth === 0) && /* @__PURE__ */ jsx2("span", { className: "db-tree-icon", children: isDir ? icon : null }),
           renaming ? /* @__PURE__ */ jsx2(
             "input",
             {
@@ -678,7 +782,7 @@ function FileTreeNode({
                 if (e.key !== "Enter" && e.key !== "Escape") return;
                 e.preventDefault();
                 e.stopPropagation();
-                if (e.key === "Enter") void handleRenameSubmit();
+                if (e.key === "Enter") void handleRenameSubmit(true);
                 else handleRenameCancel();
               },
               onClick: (e) => e.stopPropagation()
@@ -697,6 +801,7 @@ function FileTreeNode({
                 "aria-haspopup": "menu",
                 "aria-expanded": showContext,
                 "aria-keyshortcuts": "Shift+F10",
+                title: "More actions (Shift+F10)",
                 tabIndex: -1,
                 children: /* @__PURE__ */ jsx2(MoreIcon, {})
               }
@@ -728,6 +833,17 @@ function FileTreeNode({
                 children: "Rename"
               }
             ),
+            !isDir && onTogglePin && /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-tree-context-item",
+                onClick: () => void handleTogglePin(),
+                children: pinned ? "Unpin" : "Pin"
+              }
+            ),
             gitActions && (gitActions.viewChanges || gitActions.fileHistory) && /* @__PURE__ */ jsxs2(Fragment, { children: [
               /* @__PURE__ */ jsx2("div", { className: "db-tree-context-divider", role: "separator" }),
               gitActions.viewChanges && /* @__PURE__ */ jsx2(
@@ -790,7 +906,8 @@ function FileTreeNode({
       ),
       document.body
     ),
-    isDir && expanded && renderChildren && /* @__PURE__ */ jsx2("div", { className: "db-tree-children", role: "group", children: renderChildren(entry.path) })
+    isDir && expanded && renderChildren && /* @__PURE__ */ jsx2("div", { className: "db-tree-children", role: "group", children: renderChildren(entry.path) }),
+    isDir && expanded && childError
   ] });
 }
 
@@ -854,8 +971,409 @@ function treeKeyAction(rows, activePath, key) {
   }
 }
 
-// src/FileExplorer/FileExplorer.tsx
+// src/FileExplorer/PinnedDocuments.tsx
+import { useCallback as useCallback3, useEffect as useEffect3, useId, useLayoutEffect as useLayoutEffect2, useRef as useRef3, useState as useState3 } from "react";
+import { createPortal as createPortal2 } from "react-dom";
+
+// src/DocBlocksShell/pinned-documents.ts
+import { tryParseWorkspacePath } from "@bendyline/docblocks/filesystem";
+var PINNED_DOCUMENTS_STORAGE_KEY = "docblocks-pinned-documents-v1";
+var MAX_PINNED_DOCUMENTS = 100;
+var MAX_WORKSPACE_ID_LENGTH = 256;
+var MAX_WORKSPACE_NAME_LENGTH = 256;
+var MAX_DOCUMENT_PATH_LENGTH = 4096;
+function resolvePinnedDocumentStorage() {
+  try {
+    const candidate = Reflect.get(globalThis, "localStorage");
+    if (typeof candidate !== "object" || candidate === null || typeof Reflect.get(candidate, "getItem") !== "function" || typeof Reflect.get(candidate, "setItem") !== "function") {
+      return null;
+    }
+    return candidate;
+  } catch {
+    return null;
+  }
+}
+function pinnedDocumentKey(document2) {
+  const path = tryParseWorkspacePath(document2.path);
+  return `${document2.workspaceId}\0${path ?? document2.path}`;
+}
+function pinnedDocumentName(document2) {
+  const canonical = tryParseWorkspacePath(document2.path);
+  const path = canonical ?? document2.path;
+  return path.slice(path.lastIndexOf("/") + 1);
+}
+function pinnedDocumentDisplayPath(document2) {
+  return `${document2.workspaceName}/${document2.path}`;
+}
+function missingPinnedDocumentMessage(document2) {
+  return `${pinnedDocumentName(document2)} is no longer at ${pinnedDocumentDisplayPath(document2)}. Unpin this file?`;
+}
+function parsePinnedDocument(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+  const record = value;
+  const keys = Object.keys(record);
+  if (keys.some((key) => key !== "workspaceId" && key !== "workspaceName" && key !== "path") || typeof record.workspaceId !== "string" || record.workspaceId.length === 0 || record.workspaceId.length > MAX_WORKSPACE_ID_LENGTH || typeof record.workspaceName !== "string" || record.workspaceName.length === 0 || record.workspaceName.length > MAX_WORKSPACE_NAME_LENGTH || typeof record.path !== "string" || record.path.length === 0 || record.path.length > MAX_DOCUMENT_PATH_LENGTH) {
+    return null;
+  }
+  const path = tryParseWorkspacePath(record.path);
+  if (!path) return null;
+  return {
+    workspaceId: record.workspaceId,
+    workspaceName: record.workspaceName,
+    path
+  };
+}
+function parsePinnedDocuments(value) {
+  if (!Array.isArray(value)) return [];
+  const parsed = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const valueItem of value.slice(0, MAX_PINNED_DOCUMENTS)) {
+    const document2 = parsePinnedDocument(valueItem);
+    if (!document2) continue;
+    const key = pinnedDocumentKey(document2);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    parsed.push(document2);
+  }
+  return parsed;
+}
+function loadPinnedDocuments(storage = resolvePinnedDocumentStorage()) {
+  if (!storage) return [];
+  try {
+    const raw = storage.getItem(PINNED_DOCUMENTS_STORAGE_KEY);
+    return raw === null ? [] : parsePinnedDocuments(JSON.parse(raw));
+  } catch {
+    return [];
+  }
+}
+function savePinnedDocuments(documents, storage = resolvePinnedDocumentStorage()) {
+  if (!storage) return;
+  try {
+    storage.setItem(PINNED_DOCUMENTS_STORAGE_KEY, JSON.stringify(parsePinnedDocuments(documents)));
+  } catch {
+  }
+}
+function togglePinnedDocument(documents, candidate) {
+  const parsed = parsePinnedDocument(candidate);
+  if (!parsed) return [...documents];
+  const key = pinnedDocumentKey(parsed);
+  if (documents.some((document2) => pinnedDocumentKey(document2) === key)) {
+    return documents.filter((document2) => pinnedDocumentKey(document2) !== key);
+  }
+  return [parsed, ...documents].slice(0, MAX_PINNED_DOCUMENTS);
+}
+function removePinnedDocument(documents, target) {
+  const key = pinnedDocumentKey(target);
+  return documents.filter((document2) => pinnedDocumentKey(document2) !== key);
+}
+function relocatePinnedDocuments(documents, workspaceId, oldPath, newPath) {
+  const oldCanonical = tryParseWorkspacePath(oldPath);
+  const newCanonical = tryParseWorkspacePath(newPath);
+  if (!oldCanonical || !newCanonical) return [...documents];
+  return parsePinnedDocuments(
+    documents.map((document2) => {
+      if (document2.workspaceId !== workspaceId) return document2;
+      if (document2.path === oldCanonical) return { ...document2, path: newCanonical };
+      if (!document2.path.startsWith(`${oldCanonical}/`)) return document2;
+      return {
+        ...document2,
+        path: `${newCanonical}${document2.path.slice(oldCanonical.length)}`
+      };
+    })
+  );
+}
+function renamePinnedDocumentWorkspace(documents, workspaceId, workspaceName) {
+  return documents.map(
+    (document2) => document2.workspaceId === workspaceId ? { ...document2, workspaceName } : document2
+  );
+}
+function movePinnedDocumentsToWorkspace(documents, sourceWorkspaceId, destination) {
+  return parsePinnedDocuments(
+    documents.map(
+      (document2) => document2.workspaceId === sourceWorkspaceId ? { ...document2, ...destination } : document2
+    )
+  );
+}
+
+// src/FileExplorer/PinnedDocuments.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function displayName(document2) {
+  const name = pinnedDocumentName(document2);
+  return name.endsWith(".md") ? name.slice(0, -3) : name;
+}
+function PinnedDocumentRow({
+  document: pinnedDocument,
+  selected,
+  onSelect,
+  onUnpin,
+  onRename,
+  onDelete
+}) {
+  const [showContext, setShowContext] = useState3(false);
+  const [contextPos, setContextPos] = useState3({ x: 0, y: 0 });
+  const [actionError, setActionError] = useState3(null);
+  const contextRef = useRef3(null);
+  const selectRef = useRef3(null);
+  const keyboardMenuRef = useRef3(false);
+  const missing = pinnedDocument.availability === "missing";
+  const name = pinnedDocumentName(pinnedDocument);
+  const displayPath = pinnedDocumentDisplayPath(pinnedDocument);
+  const hasActions = Boolean(onUnpin || onRename || onDelete);
+  const closeMenu = useCallback3((returnFocus) => {
+    setShowContext(false);
+    keyboardMenuRef.current = false;
+    if (returnFocus) selectRef.current?.focus({ preventScroll: true });
+  }, []);
+  const openMenuAt = useCallback3((x, y, keyboard) => {
+    keyboardMenuRef.current = keyboard;
+    setContextPos({ x, y });
+    setShowContext(true);
+  }, []);
+  const handleContextMenu = useCallback3(
+    (event) => {
+      if (!hasActions) return;
+      event.preventDefault();
+      event.stopPropagation();
+      openMenuAt(event.clientX, event.clientY, false);
+    },
+    [hasActions, openMenuAt]
+  );
+  const handleMoreClick = useCallback3(
+    (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      const rect = event.currentTarget.getBoundingClientRect();
+      openMenuAt(rect.right, rect.bottom, false);
+    },
+    [openMenuAt]
+  );
+  const openMenuByKeyboard = useCallback3(() => {
+    if (!hasActions) return;
+    const rect = selectRef.current?.getBoundingClientRect();
+    openMenuAt(rect ? rect.left + 16 : 0, rect ? rect.bottom : 0, true);
+  }, [hasActions, openMenuAt]);
+  const menuItems = useCallback3(
+    () => [...contextRef.current?.querySelectorAll('[role="menuitem"]') ?? []],
+    []
+  );
+  const focusMenuItem = useCallback3(
+    (index) => {
+      const items = menuItems();
+      if (items.length === 0) return;
+      const target = items[(index % items.length + items.length) % items.length];
+      target?.focus({ preventScroll: true });
+    },
+    [menuItems]
+  );
+  const handleMenuKeyDown = useCallback3(
+    (event) => {
+      if (event.key === "Escape" || event.key === "Tab") {
+        event.preventDefault();
+        event.stopPropagation();
+        closeMenu(true);
+        return;
+      }
+      const items = menuItems();
+      const current = items.indexOf(document.activeElement);
+      switch (event.key) {
+        case "ArrowDown":
+          event.preventDefault();
+          focusMenuItem(current + 1);
+          break;
+        case "ArrowUp":
+          event.preventDefault();
+          focusMenuItem(current - 1);
+          break;
+        case "Home":
+          event.preventDefault();
+          focusMenuItem(0);
+          break;
+        case "End":
+          event.preventDefault();
+          focusMenuItem(items.length - 1);
+          break;
+        default:
+          break;
+      }
+    },
+    [closeMenu, focusMenuItem, menuItems]
+  );
+  const runAction = useCallback3(
+    async (action, fallbackMessage) => {
+      closeMenu(false);
+      setActionError(null);
+      if (!action) return;
+      try {
+        await action(pinnedDocument);
+      } catch (caught) {
+        setActionError(caught instanceof Error ? caught.message : fallbackMessage);
+      }
+    },
+    [closeMenu, pinnedDocument]
+  );
+  useEffect3(() => {
+    if (!showContext) return;
+    function handleOutsideAction(event) {
+      if (!contextRef.current?.contains(event.target)) setShowContext(false);
+    }
+    function handleScroll() {
+      setShowContext(false);
+    }
+    document.addEventListener("click", handleOutsideAction, true);
+    document.addEventListener("contextmenu", handleOutsideAction, true);
+    document.addEventListener("scroll", handleScroll, { capture: true, once: true });
+    return () => {
+      document.removeEventListener("click", handleOutsideAction, true);
+      document.removeEventListener("contextmenu", handleOutsideAction, true);
+      document.removeEventListener("scroll", handleScroll, true);
+    };
+  }, [showContext]);
+  useEffect3(() => {
+    if (showContext && keyboardMenuRef.current) focusMenuItem(0);
+  }, [focusMenuItem, showContext]);
+  useLayoutEffect2(() => {
+    if (!showContext || !contextRef.current) return;
+    const rect = contextRef.current.getBoundingClientRect();
+    setContextPos((current) => ({
+      x: Math.max(4, Math.min(current.x, window.innerWidth - rect.width - 4)),
+      y: Math.max(4, Math.min(current.y, window.innerHeight - rect.height - 4))
+    }));
+  }, [showContext]);
+  return /* @__PURE__ */ jsxs3("div", { className: `db-pinned-document-row${selected ? " db-pinned-document-row--selected" : ""}`, children: [
+    /* @__PURE__ */ jsx3(
+      "button",
+      {
+        ref: selectRef,
+        type: "button",
+        className: "db-pinned-document",
+        "aria-current": selected ? "page" : void 0,
+        "aria-label": `${name}, ${displayPath}${missing ? ", missing" : ""}`,
+        "aria-keyshortcuts": hasActions ? "Shift+F10" : void 0,
+        title: displayPath,
+        onClick: () => void onSelect(pinnedDocument),
+        onContextMenu: handleContextMenu,
+        onKeyDown: (event) => {
+          if (event.key === "ContextMenu" || event.key === "F10" && event.shiftKey) {
+            event.preventDefault();
+            openMenuByKeyboard();
+          }
+        },
+        children: /* @__PURE__ */ jsxs3("span", { className: "db-pinned-document-heading", children: [
+          /* @__PURE__ */ jsx3("span", { className: "db-pinned-document-name", children: displayName(pinnedDocument) }),
+          missing && /* @__PURE__ */ jsx3("span", { className: "db-pinned-document-missing", children: "(missing)" })
+        ] })
+      }
+    ),
+    hasActions && /* @__PURE__ */ jsx3(
+      "button",
+      {
+        type: "button",
+        className: `db-pinned-document-more${showContext ? " db-pinned-document-more--active" : ""}`,
+        "aria-label": `More actions for ${name}`,
+        "aria-haspopup": "menu",
+        "aria-expanded": showContext,
+        title: "More actions",
+        onClick: handleMoreClick,
+        onContextMenu: handleMoreClick,
+        children: /* @__PURE__ */ jsx3(MoreIcon, {})
+      }
+    ),
+    actionError && /* @__PURE__ */ jsx3("div", { className: "db-tree-error db-pinned-document-error", role: "alert", children: actionError }),
+    showContext && createPortal2(
+      /* @__PURE__ */ jsxs3(
+        "div",
+        {
+          ref: contextRef,
+          className: "db-tree-context",
+          style: { left: contextPos.x, top: contextPos.y },
+          role: "menu",
+          "aria-label": `Actions for ${name}`,
+          onKeyDown: handleMenuKeyDown,
+          children: [
+            onRename && /* @__PURE__ */ jsx3(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-tree-context-item",
+                onClick: () => void runAction(onRename, "Unable to rename this document."),
+                children: "Rename"
+              }
+            ),
+            onUnpin && /* @__PURE__ */ jsx3(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-tree-context-item",
+                onClick: () => void runAction(onUnpin, "Unable to unpin this document."),
+                children: "Unpin"
+              }
+            ),
+            onDelete && (onRename || onUnpin) && /* @__PURE__ */ jsx3("div", { className: "db-tree-context-divider", role: "separator" }),
+            onDelete && /* @__PURE__ */ jsx3(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-tree-context-item db-tree-context-item--danger",
+                onClick: () => void runAction(onDelete, "Unable to delete this document."),
+                children: "Delete"
+              }
+            )
+          ]
+        }
+      ),
+      document.body
+    )
+  ] });
+}
+function PinnedDocuments({
+  documents,
+  activeWorkspaceId,
+  activeFilePath,
+  onSelect,
+  onUnpin,
+  onRename,
+  onDelete
+}) {
+  const titleId = useId();
+  if (documents.length === 0) return null;
+  return /* @__PURE__ */ jsxs3("section", { className: "db-pinned-documents", "aria-labelledby": titleId, children: [
+    /* @__PURE__ */ jsxs3("h2", { id: titleId, className: "db-explorer-title db-pinned-documents-title", children: [
+      /* @__PURE__ */ jsx3(PinIcon, {}),
+      /* @__PURE__ */ jsx3("span", { children: "Pinned" })
+    ] }),
+    /* @__PURE__ */ jsx3("div", { className: "db-pinned-document-list", children: documents.map((document2) => /* @__PURE__ */ jsx3(
+      PinnedDocumentRow,
+      {
+        document: document2,
+        selected: document2.workspaceId === activeWorkspaceId && document2.path === activeFilePath?.replace(/^\/+|\/+$/g, ""),
+        onSelect,
+        onUnpin,
+        onRename,
+        onDelete
+      },
+      `${document2.workspaceId}\0${document2.path}`
+    )) })
+  ] });
+}
+
+// src/FileExplorer/entry-visibility.ts
+function isHiddenFileEntry(entry) {
+  const name = entry.path.replace(/^\/+/, "").split("/").pop() ?? "";
+  if (name.startsWith(".")) return true;
+  return entry.kind === "directory" && name.endsWith("_files");
+}
+function filterVisibleFileEntries(entries) {
+  return entries.filter((entry) => !isHiddenFileEntry(entry));
+}
+
+// src/FileExplorer/FileExplorer.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".txt", ".md", ".docx", ".pdf", ".dbk", ".zip"]);
 var INTERNAL_DRAG_TYPE = "application/x-docblocks-entry";
 var NEW_ITEM_ERROR_ID = "db-new-item-error";
@@ -892,17 +1410,17 @@ function canMoveTo(entry, directoryPath) {
 function isInternalDrag(dataTransfer) {
   return Array.from(dataTransfer.types).includes(INTERNAL_DRAG_TYPE);
 }
-function isHiddenEntry(entry) {
-  const name = entry.path.replace(/^\/+/, "").split("/").pop() ?? "";
-  if (name.startsWith(".")) return true;
-  return entry.kind === "directory" && name.endsWith("_files");
-}
-function filterVisible(entries) {
-  return entries.filter((e) => !isHiddenEntry(e));
-}
 function FileExplorer({
   provider,
   activeFilePath,
+  activeWorkspaceId,
+  pinnedDocuments = [],
+  pinnedPaths = [],
+  onPinnedDocumentSelect,
+  onPinnedDocumentUnpin,
+  onPinnedDocumentRename,
+  onPinnedDocumentDelete,
+  onTogglePin,
   onSelect,
   onTreeMutation,
   onTreeChange,
@@ -913,33 +1431,37 @@ function FileExplorer({
   className
 }) {
   const tree = useFileTree(provider);
-  const { childEntries } = tree;
+  const { childEntries, childIssues } = tree;
   const { reveal } = tree;
   const git = useGitContext();
-  const [newItemName, setNewItemName] = useState3("");
-  const [newItemType, setNewItemType] = useState3(null);
-  const [newItemCreationPending, setNewItemCreationPending] = useState3(false);
-  const newItemCreationPendingRef = useRef3(false);
-  const [newItemError, setNewItemError] = useState3(null);
-  const [dragOver, setDragOver] = useState3(false);
-  const [draggedEntry, setDraggedEntry] = useState3(null);
-  const [dropTarget, setDropTarget] = useState3(null);
-  const [moveError, setMoveError] = useState3(null);
-  const [movePanelOpen, setMovePanelOpen] = useState3(false);
-  const [moveDestinationId, setMoveDestinationId] = useState3(moveDestinations[0]?.id ?? "");
-  const [movingToWorkspace, setMovingToWorkspace] = useState3(false);
-  const [moveWorkspaceError, setMoveWorkspaceError] = useState3(null);
-  const dragCounter = useRef3(0);
-  const [activePath, setActivePath] = useState3(null);
-  const treeRef = useRef3(null);
-  useEffect3(() => {
+  const pinnedPathSet = useMemo(
+    () => new Set(pinnedPaths.map((path) => normalisePath2(path))),
+    [pinnedPaths]
+  );
+  const [newItemName, setNewItemName] = useState4("");
+  const [newItemType, setNewItemType] = useState4(null);
+  const [newItemCreationPending, setNewItemCreationPending] = useState4(false);
+  const newItemCreationPendingRef = useRef4(false);
+  const [newItemError, setNewItemError] = useState4(null);
+  const [dragOver, setDragOver] = useState4(false);
+  const [draggedEntry, setDraggedEntry] = useState4(null);
+  const [dropTarget, setDropTarget] = useState4(null);
+  const [moveError, setMoveError] = useState4(null);
+  const [movePanelOpen, setMovePanelOpen] = useState4(false);
+  const [moveDestinationId, setMoveDestinationId] = useState4(moveDestinations[0]?.id ?? "");
+  const [movingToWorkspace, setMovingToWorkspace] = useState4(false);
+  const [moveWorkspaceError, setMoveWorkspaceError] = useState4(null);
+  const dragCounter = useRef4(0);
+  const [activePath, setActivePath] = useState4(null);
+  const treeRef = useRef4(null);
+  useEffect4(() => {
     if (moveDestinations.some((destination) => destination.id === moveDestinationId)) return;
     setMoveDestinationId(moveDestinations[0]?.id ?? "");
   }, [moveDestinationId, moveDestinations]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (activeFilePath) reveal(activeFilePath, "file");
   }, [activeFilePath, provider, reveal]);
-  const hasSupported = useCallback3((dt) => {
+  const hasSupported = useCallback4((dt) => {
     for (const item of Array.from(dt.items)) {
       if (item.kind !== "file") continue;
       const name = item.getAsFile?.()?.name;
@@ -949,7 +1471,7 @@ function FileExplorer({
     }
     return dt.items.length > 0;
   }, []);
-  const handleDragEnter = useCallback3(
+  const handleDragEnter = useCallback4(
     (e) => {
       if (isInternalDrag(e.dataTransfer)) return;
       e.preventDefault();
@@ -958,12 +1480,12 @@ function FileExplorer({
     },
     [hasSupported, dragCounter]
   );
-  const handleDragOver = useCallback3((e) => {
+  const handleDragOver = useCallback4((e) => {
     if (isInternalDrag(e.dataTransfer)) return;
     e.preventDefault();
     e.dataTransfer.dropEffect = "copy";
   }, []);
-  const handleDragLeave = useCallback3(
+  const handleDragLeave = useCallback4(
     (e) => {
       if (isInternalDrag(e.dataTransfer)) return;
       e.preventDefault();
@@ -975,7 +1497,7 @@ function FileExplorer({
     },
     [dragCounter]
   );
-  const handleDrop = useCallback3(
+  const handleDrop = useCallback4(
     (e) => {
       if (isInternalDrag(e.dataTransfer)) return;
       e.preventDefault();
@@ -989,7 +1511,7 @@ function FileExplorer({
     },
     [onImportFiles]
   );
-  const handleSelect = useCallback3(
+  const handleSelect = useCallback4(
     (path) => {
       const findKind = (p) => {
         for (const e of tree.entries) {
@@ -1008,7 +1530,7 @@ function FileExplorer({
     },
     [tree, onSelect, childEntries]
   );
-  const handleNewItemSubmit = useCallback3(async () => {
+  const handleNewItemSubmit = useCallback4(async () => {
     if (newItemCreationPendingRef.current) return;
     if (!newItemName.trim()) {
       setNewItemType(null);
@@ -1041,7 +1563,7 @@ function FileExplorer({
     setNewItemType(null);
     onTreeChange?.({ type: "create", path: createdPath });
   }, [newItemName, newItemType, tree, onTreeChange]);
-  const handleMoveToWorkspace = useCallback3(async () => {
+  const handleMoveToWorkspace = useCallback4(async () => {
     if (!onMoveToWorkspace || !moveDestinationId || movingToWorkspace) return;
     setMovingToWorkspace(true);
     setMoveWorkspaceError(null);
@@ -1055,7 +1577,7 @@ function FileExplorer({
       setMovingToWorkspace(false);
     }
   }, [moveDestinationId, movingToWorkspace, onMoveToWorkspace]);
-  const runTreeMutation = useCallback3(
+  const runTreeMutation = useCallback4(
     async (change, mutate) => {
       if (onTreeMutation) await onTreeMutation(change, mutate);
       else await mutate();
@@ -1063,14 +1585,14 @@ function FileExplorer({
     },
     [onTreeMutation, onTreeChange]
   );
-  const handleDelete = useCallback3(
+  const handleDelete = useCallback4(
     async (path, kind) => {
       const change = { type: "delete", path, kind };
       await runTreeMutation(change, () => tree.deleteEntry(path));
     },
     [tree, runTreeMutation]
   );
-  const handleRename = useCallback3(
+  const handleRename = useCallback4(
     async (oldPath, newPath, kind) => {
       setMoveError(null);
       const change = { type: "move", oldPath, newPath, kind };
@@ -1086,7 +1608,7 @@ function FileExplorer({
     },
     [tree, runTreeMutation, onTreeChange]
   );
-  const handleMove = useCallback3(
+  const handleMove = useCallback4(
     async (entry, directoryPath) => {
       if (!canMoveTo(entry, directoryPath)) return;
       const newPath = pathInDirectory(entry, directoryPath);
@@ -1097,18 +1619,18 @@ function FileExplorer({
     },
     [handleRename, tree]
   );
-  const handleInternalDragStart = useCallback3((e, entry) => {
+  const handleInternalDragStart = useCallback4((e, entry) => {
     e.dataTransfer.effectAllowed = "move";
     e.dataTransfer.setData(INTERNAL_DRAG_TYPE, entry.path);
     e.dataTransfer.setData("text/plain", entry.path);
     setDraggedEntry(entry);
     setMoveError(null);
   }, []);
-  const handleInternalDragEnd = useCallback3(() => {
+  const handleInternalDragEnd = useCallback4(() => {
     setDraggedEntry(null);
     setDropTarget(null);
   }, []);
-  const handleEntryDragOver = useCallback3(
+  const handleEntryDragOver = useCallback4(
     (e, entry) => {
       if (!isInternalDrag(e.dataTransfer)) return;
       e.stopPropagation();
@@ -1123,7 +1645,7 @@ function FileExplorer({
     },
     [draggedEntry]
   );
-  const handleEntryDrop = useCallback3(
+  const handleEntryDrop = useCallback4(
     (e, entry) => {
       if (!isInternalDrag(e.dataTransfer)) return;
       e.preventDefault();
@@ -1135,7 +1657,7 @@ function FileExplorer({
     },
     [draggedEntry, handleMove]
   );
-  const handleRootDragOver = useCallback3(
+  const handleRootDragOver = useCallback4(
     (e) => {
       if (!isInternalDrag(e.dataTransfer) || !draggedEntry) return;
       e.preventDefault();
@@ -1146,7 +1668,7 @@ function FileExplorer({
     },
     [draggedEntry]
   );
-  const handleRootDrop = useCallback3(
+  const handleRootDrop = useCallback4(
     (e) => {
       if (!isInternalDrag(e.dataTransfer)) return;
       e.preventDefault();
@@ -1156,7 +1678,7 @@ function FileExplorer({
     },
     [draggedEntry, handleMove]
   );
-  const badgeFor = useCallback3(
+  const badgeFor = useCallback4(
     (entry) => {
       if (!git?.repo) return void 0;
       const key = entry.path.startsWith("/") ? entry.path : `/${entry.path}`;
@@ -1166,7 +1688,7 @@ function FileExplorer({
     },
     [git]
   );
-  const gitActionsFor = useCallback3(
+  const gitActionsFor = useCallback4(
     (entry) => {
       if (!git?.repo || entry.kind !== "file") return void 0;
       const path = entry.path.startsWith("/") ? entry.path : `/${entry.path}`;
@@ -1183,7 +1705,7 @@ function FileExplorer({
       roots: tree.entries,
       childrenOf: (dirPath) => getEquivalentPathValue(childEntries, dirPath) ?? [],
       isExpanded: (dirPath) => hasEquivalentPath2(tree.expanded, dirPath),
-      isVisible: (entry) => !isHiddenEntry(entry)
+      isVisible: (entry) => !isHiddenFileEntry(entry)
     }),
     [tree.entries, tree.expanded, childEntries]
   );
@@ -1193,7 +1715,7 @@ function FileExplorer({
     return visibleRows.find((row) => normalisePath2(row.path) === target)?.path ?? null;
   }, [visibleRows, tree.selectedPath]);
   const activeRowPath = resolveActiveRow(visibleRows, activePath, selectedRowPath);
-  const focusRow = useCallback3((path) => {
+  const focusRow = useCallback4((path) => {
     const rows = treeRef.current?.querySelectorAll('[role="treeitem"]');
     for (const row of rows ?? []) {
       if (row.dataset.path === path) {
@@ -1202,7 +1724,7 @@ function FileExplorer({
       }
     }
   }, []);
-  const handleTreeKeyDown = useCallback3(
+  const handleTreeKeyDown = useCallback4(
     (e) => {
       const target = e.target;
       if (!target.classList?.contains("db-tree-row")) return;
@@ -1227,41 +1749,67 @@ function FileExplorer({
     },
     [visibleRows, activeRowPath, focusRow, tree]
   );
-  const renderEntries = useCallback3(
+  const renderEntries = useCallback4(
     (entries, depth) => {
-      const visible = filterVisible(entries);
-      return visible.map((entry, index) => /* @__PURE__ */ jsx3(
-        FileTreeNode,
-        {
-          entry,
-          depth,
-          focusable: entry.path === activeRowPath,
-          posInSet: index + 1,
-          setSize: visible.length,
-          onRowFocus: setActivePath,
-          expanded: hasEquivalentPath2(tree.expanded, entry.path),
-          selected: tree.selectedPath !== null && normalisePath2(tree.selectedPath) === normalisePath2(entry.path),
-          badge: badgeFor(entry),
-          gitActions: gitActionsFor(entry),
-          onToggle: tree.toggleExpand,
-          onSelect: handleSelect,
-          confirmDelete,
-          onDelete: handleDelete,
-          onRename: handleRename,
-          draggable: true,
-          dragging: draggedEntry?.path === entry.path,
-          dropTarget: dropTarget === entry.path,
-          onDragStart: handleInternalDragStart,
-          onDragEnd: handleInternalDragEnd,
-          onDragOverEntry: handleEntryDragOver,
-          onDropEntry: handleEntryDrop,
-          renderChildren: (dirPath) => {
-            const children = getEquivalentPathValue(childEntries, dirPath) ?? [];
-            return renderEntries(children, depth + 1);
-          }
-        },
-        entry.path
-      ));
+      const visible = filterVisibleFileEntries(entries);
+      return visible.map((entry, index) => {
+        const childIssue = entry.kind === "directory" ? getEquivalentPathValue(childIssues, entry.path) : void 0;
+        return /* @__PURE__ */ jsx4(
+          FileTreeNode,
+          {
+            entry,
+            depth,
+            focusable: entry.path === activeRowPath,
+            posInSet: index + 1,
+            setSize: visible.length,
+            onRowFocus: setActivePath,
+            expanded: hasEquivalentPath2(tree.expanded, entry.path),
+            selected: tree.selectedPath !== null && normalisePath2(tree.selectedPath) === normalisePath2(entry.path),
+            badge: badgeFor(entry),
+            gitActions: gitActionsFor(entry),
+            onToggle: tree.toggleExpand,
+            onSelect: handleSelect,
+            confirmDelete,
+            onDelete: handleDelete,
+            onRename: handleRename,
+            pinned: entry.kind === "file" && pinnedPathSet.has(normalisePath2(entry.path)),
+            onTogglePin: entry.kind === "file" ? onTogglePin : void 0,
+            draggable: true,
+            dragging: draggedEntry?.path === entry.path,
+            dropTarget: dropTarget === entry.path,
+            onDragStart: handleInternalDragStart,
+            onDragEnd: handleInternalDragEnd,
+            onDragOverEntry: handleEntryDragOver,
+            onDropEntry: handleEntryDrop,
+            renderChildren: (dirPath) => {
+              const children = getEquivalentPathValue(childEntries, dirPath) ?? [];
+              return renderEntries(children, depth + 1);
+            },
+            childError: childIssue ? /* @__PURE__ */ jsxs4(
+              "div",
+              {
+                className: "db-tree-error db-tree-error--child",
+                role: "alert",
+                "data-directory-path": childIssue.directoryPath,
+                children: [
+                  /* @__PURE__ */ jsx4("span", { children: childIssue.message }),
+                  " ",
+                  /* @__PURE__ */ jsx4(
+                    "button",
+                    {
+                      type: "button",
+                      className: "db-tree-error-retry",
+                      onClick: () => void tree.retryDirectory(childIssue.directoryPath),
+                      children: "Retry folder"
+                    }
+                  )
+                ]
+              }
+            ) : void 0
+          },
+          entry.path
+        );
+      });
     },
     [
       tree,
@@ -1270,6 +1818,7 @@ function FileExplorer({
       handleDelete,
       handleRename,
       childEntries,
+      childIssues,
       badgeFor,
       gitActionsFor,
       draggedEntry,
@@ -1278,10 +1827,12 @@ function FileExplorer({
       handleInternalDragEnd,
       handleEntryDragOver,
       handleEntryDrop,
-      activeRowPath
+      activeRowPath,
+      pinnedPathSet,
+      onTogglePin
     ]
   );
-  return /* @__PURE__ */ jsxs3(
+  return /* @__PURE__ */ jsxs4(
     "div",
     {
       className: `db-file-explorer ${dragOver ? "db-file-explorer--drop-active" : ""} ${className ?? ""}`,
@@ -1290,10 +1841,22 @@ function FileExplorer({
       onDragLeave: handleDragLeave,
       onDrop: handleDrop,
       children: [
-        /* @__PURE__ */ jsxs3("div", { className: "db-explorer-toolbar", children: [
-          /* @__PURE__ */ jsx3("span", { className: "db-explorer-title", children: "Files" }),
-          /* @__PURE__ */ jsxs3("div", { className: "db-explorer-actions", children: [
-            /* @__PURE__ */ jsx3(
+        onPinnedDocumentSelect && /* @__PURE__ */ jsx4(
+          PinnedDocuments,
+          {
+            documents: pinnedDocuments,
+            activeWorkspaceId,
+            activeFilePath,
+            onSelect: onPinnedDocumentSelect,
+            onUnpin: onPinnedDocumentUnpin,
+            onRename: onPinnedDocumentRename,
+            onDelete: onPinnedDocumentDelete
+          }
+        ),
+        /* @__PURE__ */ jsxs4("div", { className: "db-explorer-toolbar", children: [
+          /* @__PURE__ */ jsx4("span", { className: "db-explorer-title", children: "Files" }),
+          /* @__PURE__ */ jsxs4("div", { className: "db-explorer-actions", children: [
+            /* @__PURE__ */ jsx4(
               "button",
               {
                 className: "db-explorer-btn",
@@ -1304,10 +1867,10 @@ function FileExplorer({
                 },
                 title: "New Folder",
                 "aria-label": "New Folder",
-                children: /* @__PURE__ */ jsx3(NewFolderIcon, {})
+                children: /* @__PURE__ */ jsx4(NewFolderIcon, {})
               }
             ),
-            /* @__PURE__ */ jsx3(
+            /* @__PURE__ */ jsx4(
               "button",
               {
                 className: "db-explorer-btn",
@@ -1318,12 +1881,12 @@ function FileExplorer({
                 },
                 title: "New File",
                 "aria-label": "New File",
-                children: /* @__PURE__ */ jsx3(NewFileIcon, {})
+                children: /* @__PURE__ */ jsx4(NewFileIcon, {})
               }
             )
           ] })
         ] }),
-        onMoveToWorkspace && /* @__PURE__ */ jsx3("div", { className: "db-transient-move", children: !movePanelOpen ? /* @__PURE__ */ jsx3(
+        onMoveToWorkspace && /* @__PURE__ */ jsx4("div", { className: "db-transient-move", children: !movePanelOpen ? /* @__PURE__ */ jsx4(
           "button",
           {
             type: "button",
@@ -1334,7 +1897,7 @@ function FileExplorer({
             },
             children: "Move this into a workspace"
           }
-        ) : /* @__PURE__ */ jsxs3(
+        ) : /* @__PURE__ */ jsxs4(
           "form",
           {
             className: "db-transient-move-form",
@@ -1344,8 +1907,8 @@ function FileExplorer({
               void handleMoveToWorkspace();
             },
             children: [
-              /* @__PURE__ */ jsx3("label", { className: "db-transient-move-label", htmlFor: "db-transient-move-destination", children: "Move this document into" }),
-              /* @__PURE__ */ jsx3(
+              /* @__PURE__ */ jsx4("label", { className: "db-transient-move-label", htmlFor: "db-transient-move-destination", children: "Move this document into" }),
+              /* @__PURE__ */ jsx4(
                 "select",
                 {
                   id: "db-transient-move-destination",
@@ -1356,13 +1919,13 @@ function FileExplorer({
                     setMoveDestinationId(event.currentTarget.value);
                     setMoveWorkspaceError(null);
                   },
-                  children: moveDestinations.map((destination) => /* @__PURE__ */ jsx3("option", { value: destination.id, children: destination.name }, destination.id))
+                  children: moveDestinations.map((destination) => /* @__PURE__ */ jsx4("option", { value: destination.id, children: destination.name }, destination.id))
                 }
               ),
-              moveDestinations.length === 0 && /* @__PURE__ */ jsx3("p", { className: "db-transient-move-hint", children: "Open or create another workspace first." }),
-              moveWorkspaceError && /* @__PURE__ */ jsx3("div", { className: "db-transient-move-error", role: "alert", children: moveWorkspaceError }),
-              /* @__PURE__ */ jsxs3("div", { className: "db-transient-move-actions", children: [
-                /* @__PURE__ */ jsx3(
+              moveDestinations.length === 0 && /* @__PURE__ */ jsx4("p", { className: "db-transient-move-hint", children: "Open or create another workspace first." }),
+              moveWorkspaceError && /* @__PURE__ */ jsx4("div", { className: "db-transient-move-error", role: "alert", children: moveWorkspaceError }),
+              /* @__PURE__ */ jsxs4("div", { className: "db-transient-move-actions", children: [
+                /* @__PURE__ */ jsx4(
                   "button",
                   {
                     type: "button",
@@ -1375,7 +1938,7 @@ function FileExplorer({
                     children: "Cancel"
                   }
                 ),
-                /* @__PURE__ */ jsx3(
+                /* @__PURE__ */ jsx4(
                   "button",
                   {
                     type: "submit",
@@ -1388,8 +1951,8 @@ function FileExplorer({
             ]
           }
         ) }),
-        newItemType && /* @__PURE__ */ jsxs3("div", { className: "db-new-item", children: [
-          /* @__PURE__ */ jsxs3(
+        newItemType && /* @__PURE__ */ jsxs4("div", { className: "db-new-item", children: [
+          /* @__PURE__ */ jsxs4(
             "form",
             {
               className: "db-new-item-row",
@@ -1399,7 +1962,7 @@ function FileExplorer({
                 void handleNewItemSubmit();
               },
               children: [
-                /* @__PURE__ */ jsx3(
+                /* @__PURE__ */ jsx4(
                   "input",
                   {
                     className: "db-new-item-input",
@@ -1423,20 +1986,36 @@ function FileExplorer({
                     autoFocus: true
                   }
                 ),
-                newItemType === "file" && /* @__PURE__ */ jsx3("span", { className: "db-new-item-suffix", children: ".md" }),
-                /* @__PURE__ */ jsx3("button", { type: "submit", className: "db-new-item-add", disabled: newItemCreationPending, children: newItemCreationPending ? "Adding\u2026" : "Add" })
+                newItemType === "file" && /* @__PURE__ */ jsx4("span", { className: "db-new-item-suffix", children: ".md" }),
+                /* @__PURE__ */ jsx4("button", { type: "submit", className: "db-new-item-add", disabled: newItemCreationPending, children: newItemCreationPending ? "Adding\u2026" : "Add" })
               ]
             }
           ),
-          newItemError && /* @__PURE__ */ jsx3("div", { id: NEW_ITEM_ERROR_ID, className: "db-tree-error", role: "alert", children: newItemError })
+          newItemError && /* @__PURE__ */ jsx4("div", { id: NEW_ITEM_ERROR_ID, className: "db-tree-error", role: "alert", children: newItemError })
         ] }),
-        moveError && /* @__PURE__ */ jsx3("div", { className: "db-tree-error", role: "alert", children: moveError }),
-        tree.error && /* @__PURE__ */ jsxs3("div", { className: "db-tree-error", role: "alert", children: [
-          /* @__PURE__ */ jsx3("span", { children: tree.error }),
-          " ",
-          /* @__PURE__ */ jsx3("button", { type: "button", className: "db-tree-error-retry", onClick: () => void tree.refresh(), children: "Retry" })
-        ] }),
-        tree.loading ? /* @__PURE__ */ jsx3("div", { className: "db-tree", role: "status", "aria-live": "polite", children: /* @__PURE__ */ jsx3("div", { className: "db-tree-loading", children: "Loading..." }) }) : filterVisible(tree.entries).length === 0 ? /* @__PURE__ */ jsx3("div", { className: "db-tree", children: /* @__PURE__ */ jsx3("div", { className: "db-tree-empty", children: "No files yet" }) }) : /* @__PURE__ */ jsx3(
+        moveError && /* @__PURE__ */ jsx4("div", { className: "db-tree-error", role: "alert", children: moveError }),
+        tree.rootIssue && /* @__PURE__ */ jsxs4(
+          "div",
+          {
+            className: "db-tree-error",
+            role: "alert",
+            "data-directory-path": tree.rootIssue.directoryPath,
+            children: [
+              /* @__PURE__ */ jsx4("span", { children: tree.rootIssue.message }),
+              " ",
+              /* @__PURE__ */ jsx4(
+                "button",
+                {
+                  type: "button",
+                  className: "db-tree-error-retry",
+                  onClick: () => void tree.retryDirectory(""),
+                  children: "Retry"
+                }
+              )
+            ]
+          }
+        ),
+        tree.loading ? /* @__PURE__ */ jsx4("div", { className: "db-tree", role: "status", "aria-live": "polite", children: /* @__PURE__ */ jsx4("div", { className: "db-tree-loading", children: "Loading..." }) }) : filterVisibleFileEntries(tree.entries).length === 0 ? /* @__PURE__ */ jsx4("div", { className: "db-tree", children: /* @__PURE__ */ jsx4("div", { className: "db-tree-empty", children: "No files yet" }) }) : /* @__PURE__ */ jsx4(
           "div",
           {
             ref: treeRef,
@@ -1455,17 +2034,17 @@ function FileExplorer({
 }
 
 // src/WorkspacePicker/WorkspacePicker.tsx
-import { Fragment as Fragment2, useState as useState4, useEffect as useEffect4, useCallback as useCallback4, useRef as useRef4 } from "react";
+import { Fragment as Fragment2, useState as useState5, useEffect as useEffect5, useCallback as useCallback5, useRef as useRef5 } from "react";
 import { listWorkspaces, saveWorkspace, touchWorkspace } from "@bendyline/docblocks/workspace";
 import { isElectronHost } from "@bendyline/docblocks/host";
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function isNativeFileSystemSupported() {
   return typeof globalThis !== "undefined" && typeof globalThis.showDirectoryPicker === "function";
 }
 function WorkspacePath({ path }) {
-  return path.split(/([\\/])/).map((segment, index) => /* @__PURE__ */ jsxs4(Fragment2, { children: [
+  return path.split(/([\\/])/).map((segment, index) => /* @__PURE__ */ jsxs5(Fragment2, { children: [
     segment,
-    (segment === "\\" || segment === "/") && /* @__PURE__ */ jsx4("wbr", {})
+    (segment === "\\" || segment === "/") && /* @__PURE__ */ jsx5("wbr", {})
   ] }, index));
 }
 function WorkspacePicker({
@@ -1476,35 +2055,50 @@ function WorkspacePicker({
   refreshKey,
   className
 }) {
-  const [workspaces, setWorkspaces] = useState4([]);
-  const [isOpen, setIsOpen] = useState4(false);
-  const [creatingNew, setCreatingNew] = useState4(false);
-  const [newWorkspaceName, setNewWorkspaceName] = useState4("");
-  const [newWorkspaceError, setNewWorkspaceError] = useState4(null);
-  const [newWorkspacePending, setNewWorkspacePending] = useState4(false);
-  const pickerRef = useRef4(null);
-  useEffect4(() => {
+  const [workspaces, setWorkspaces] = useState5([]);
+  const [isOpen, setIsOpen] = useState5(false);
+  const [creatingNew, setCreatingNew] = useState5(false);
+  const [newWorkspaceName, setNewWorkspaceName] = useState5("");
+  const [newWorkspaceError, setNewWorkspaceError] = useState5(null);
+  const [newWorkspacePending, setNewWorkspacePending] = useState5(false);
+  const pickerRef = useRef5(null);
+  const triggerRef = useRef5(null);
+  const closeDropdown = useCallback5((returnFocus) => {
+    setIsOpen(false);
+    setCreatingNew(false);
+    setNewWorkspaceError(null);
+    if (returnFocus) triggerRef.current?.focus({ preventScroll: true });
+  }, []);
+  useEffect5(() => {
     if (!isOpen) return;
     function handleOutsideClick(e) {
       if (pickerRef.current && !pickerRef.current.contains(e.target)) {
-        setIsOpen(false);
-        setCreatingNew(false);
-        setNewWorkspaceError(null);
+        closeDropdown(false);
       }
     }
+    function handleKeyDown(e) {
+      if (e.key !== "Escape" || e.defaultPrevented) return;
+      e.preventDefault();
+      e.stopPropagation();
+      closeDropdown(true);
+    }
     document.addEventListener("mousedown", handleOutsideClick);
-    return () => document.removeEventListener("mousedown", handleOutsideClick);
-  }, [isOpen]);
+    document.addEventListener("keydown", handleKeyDown);
+    return () => {
+      document.removeEventListener("mousedown", handleOutsideClick);
+      document.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [closeDropdown, isOpen]);
   const electron = isElectronHost();
-  const refresh = useCallback4(async () => {
+  const refresh = useCallback5(async () => {
     const list = await listWorkspaces();
     const filtered = electron ? list.filter((w) => w.type === "electron-native" || w.type === "transient") : list.filter((w) => w.type !== "electron-native");
     setWorkspaces(filtered);
   }, [electron]);
-  useEffect4(() => {
+  useEffect5(() => {
     refresh();
   }, [refresh, activeWorkspaceId, refreshKey]);
-  const handleSelect = useCallback4(
+  const handleSelect = useCallback5(
     async (ws) => {
       await touchWorkspace(ws.id);
       onSelect(ws);
@@ -1512,7 +2106,7 @@ function WorkspacePicker({
     },
     [onSelect]
   );
-  const handleStartCreateNew = useCallback4(() => {
+  const handleStartCreateNew = useCallback5(() => {
     const existingNames = new Set(workspaces.map((workspace) => workspace.name.toLowerCase()));
     let suffix = workspaces.length + 1;
     while (existingNames.has(`workspace ${suffix}`.toLowerCase())) suffix += 1;
@@ -1520,12 +2114,12 @@ function WorkspacePicker({
     setNewWorkspaceError(null);
     setCreatingNew(true);
   }, [workspaces]);
-  const handleCancelCreateNew = useCallback4(() => {
+  const handleCancelCreateNew = useCallback5(() => {
     setCreatingNew(false);
     setNewWorkspaceName("");
     setNewWorkspaceError(null);
   }, []);
-  const handleCreateNew = useCallback4(async () => {
+  const handleCreateNew = useCallback5(async () => {
     if (newWorkspacePending) return;
     const name = newWorkspaceName.trim();
     if (!name) {
@@ -1564,10 +2158,11 @@ function WorkspacePicker({
   }, [newWorkspaceName, newWorkspacePending, onSelect, refresh, workspaces]);
   const activeWs = workspaces.find((w) => w.id === activeWorkspaceId);
   const activeWorkspaceName = activeWs?.name ?? "No workspace";
-  return /* @__PURE__ */ jsxs4("div", { ref: pickerRef, className: `db-workspace-picker ${className ?? ""}`, children: [
-    /* @__PURE__ */ jsxs4(
+  return /* @__PURE__ */ jsxs5("div", { ref: pickerRef, className: `db-workspace-picker ${className ?? ""}`, children: [
+    /* @__PURE__ */ jsxs5(
       "button",
       {
+        ref: triggerRef,
         className: "db-workspace-picker-btn",
         onClick: () => {
           const nextOpen = !isOpen;
@@ -1576,10 +2171,11 @@ function WorkspacePicker({
         },
         title: "Switch workspace",
         "aria-label": `Switch workspace, current: ${activeWorkspaceName}`,
+        "aria-expanded": isOpen,
         children: [
-          /* @__PURE__ */ jsx4("span", { className: "db-workspace-picker-label", children: activeWorkspaceName }),
-          /* @__PURE__ */ jsx4("span", { className: "db-workspace-picker-compact-icon", children: /* @__PURE__ */ jsx4(FolderIcon, {}) }),
-          /* @__PURE__ */ jsx4(
+          /* @__PURE__ */ jsx5("span", { className: "db-workspace-picker-label", children: activeWorkspaceName }),
+          /* @__PURE__ */ jsx5("span", { className: "db-workspace-picker-compact-icon", children: /* @__PURE__ */ jsx5(FolderIcon, {}) }),
+          /* @__PURE__ */ jsx5(
             "span",
             {
               className: `db-workspace-picker-caret${isOpen ? " db-workspace-picker-caret--open" : ""}`,
@@ -1589,24 +2185,24 @@ function WorkspacePicker({
         ]
       }
     ),
-    isOpen && /* @__PURE__ */ jsxs4("div", { className: "db-workspace-dropdown", children: [
-      workspaces.map((ws) => /* @__PURE__ */ jsx4(
+    isOpen && /* @__PURE__ */ jsxs5("div", { className: "db-workspace-dropdown", children: [
+      workspaces.map((ws) => /* @__PURE__ */ jsx5(
         "button",
         {
           className: `db-workspace-dropdown-item ${ws.id === activeWorkspaceId ? "db-workspace-dropdown-item--active" : ""}`,
           onClick: () => handleSelect(ws),
-          children: /* @__PURE__ */ jsxs4("span", { className: "db-workspace-details", children: [
-            /* @__PURE__ */ jsxs4("span", { className: "db-workspace-heading", children: [
-              /* @__PURE__ */ jsx4("span", { children: ws.name }),
-              (ws.type === "native" || ws.type === "electron-native") && /* @__PURE__ */ jsx4("span", { className: "db-workspace-type", children: "(folder)" })
+          children: /* @__PURE__ */ jsxs5("span", { className: "db-workspace-details", children: [
+            /* @__PURE__ */ jsxs5("span", { className: "db-workspace-heading", children: [
+              /* @__PURE__ */ jsx5("span", { children: ws.name }),
+              (ws.type === "native" || ws.type === "electron-native") && /* @__PURE__ */ jsx5("span", { className: "db-workspace-type", children: "(folder)" })
             ] }),
-            ws.rootPath && /* @__PURE__ */ jsx4("span", { className: "db-workspace-path", title: ws.rootPath, children: /* @__PURE__ */ jsx4(WorkspacePath, { path: ws.rootPath }) })
+            ws.rootPath && /* @__PURE__ */ jsx5("span", { className: "db-workspace-path", title: ws.rootPath, children: /* @__PURE__ */ jsx5(WorkspacePath, { path: ws.rootPath }) })
           ] })
         },
         ws.id
       )),
-      /* @__PURE__ */ jsx4("div", { className: "db-workspace-dropdown-divider" }),
-      !electron && (creatingNew ? /* @__PURE__ */ jsxs4(
+      /* @__PURE__ */ jsx5("div", { className: "db-workspace-dropdown-divider" }),
+      !electron && (creatingNew ? /* @__PURE__ */ jsxs5(
         "form",
         {
           className: "db-workspace-create",
@@ -1616,8 +2212,8 @@ function WorkspacePicker({
             void handleCreateNew();
           },
           children: [
-            /* @__PURE__ */ jsx4("label", { className: "db-workspace-create-label", htmlFor: "db-new-workspace-name", children: "Workspace name" }),
-            /* @__PURE__ */ jsx4(
+            /* @__PURE__ */ jsx5("label", { className: "db-workspace-create-label", htmlFor: "db-new-workspace-name", children: "Workspace name" }),
+            /* @__PURE__ */ jsx5(
               "input",
               {
                 id: "db-new-workspace-name",
@@ -1637,9 +2233,9 @@ function WorkspacePicker({
                 }
               }
             ),
-            newWorkspaceError && /* @__PURE__ */ jsx4("p", { id: "db-new-workspace-error", className: "db-workspace-create-error", role: "alert", children: newWorkspaceError }),
-            /* @__PURE__ */ jsxs4("div", { className: "db-workspace-create-actions", children: [
-              /* @__PURE__ */ jsx4(
+            newWorkspaceError && /* @__PURE__ */ jsx5("p", { id: "db-new-workspace-error", className: "db-workspace-create-error", role: "alert", children: newWorkspaceError }),
+            /* @__PURE__ */ jsxs5("div", { className: "db-workspace-create-actions", children: [
+              /* @__PURE__ */ jsx5(
                 "button",
                 {
                   type: "button",
@@ -1649,15 +2245,15 @@ function WorkspacePicker({
                   children: "Cancel"
                 }
               ),
-              /* @__PURE__ */ jsx4("button", { type: "submit", disabled: newWorkspacePending, children: newWorkspacePending ? "Creating\xE2\u20AC\xA6" : "Create" })
+              /* @__PURE__ */ jsx5("button", { type: "submit", disabled: newWorkspacePending, children: newWorkspacePending ? "Creating\xE2\u20AC\xA6" : "Create" })
             ] })
           ]
         }
-      ) : /* @__PURE__ */ jsx4("button", { className: "db-workspace-dropdown-item", onClick: handleStartCreateNew, children: /* @__PURE__ */ jsxs4("span", { className: "db-workspace-dropdown-action-label", children: [
-        /* @__PURE__ */ jsx4(NewFolderIcon, {}),
-        /* @__PURE__ */ jsx4("span", { children: "New Workspace" })
+      ) : /* @__PURE__ */ jsx5("button", { className: "db-workspace-dropdown-item", onClick: handleStartCreateNew, children: /* @__PURE__ */ jsxs5("span", { className: "db-workspace-dropdown-action-label", children: [
+        /* @__PURE__ */ jsx5(NewFolderIcon, {}),
+        /* @__PURE__ */ jsx5("span", { children: "New Workspace" })
       ] }) })),
-      (electron || isNativeFileSystemSupported()) && /* @__PURE__ */ jsx4(
+      (electron || isNativeFileSystemSupported()) && /* @__PURE__ */ jsx5(
         "button",
         {
           className: "db-workspace-dropdown-item",
@@ -1668,7 +2264,7 @@ function WorkspacePicker({
           children: "Open Folder..."
         }
       ),
-      onCloneRepository && /* @__PURE__ */ jsx4(
+      onCloneRepository && /* @__PURE__ */ jsx5(
         "button",
         {
           className: "db-workspace-dropdown-item",
@@ -1684,8 +2280,7 @@ function WorkspacePicker({
 }
 
 // src/DocBlocksShell/DocBlocksShell.tsx
-import { useState as useState14, useCallback as useCallback14, useEffect as useEffect14, useRef as useRef14, useMemo as useMemo3, lazy as lazy2, Suspense as Suspense2 } from "react";
-import { MediaContext } from "@bendyline/squisq-react";
+import { useState as useState15, useCallback as useCallback15, useEffect as useEffect15, useRef as useRef15, useMemo as useMemo3, lazy as lazy2, Suspense as Suspense2 } from "react";
 import {
   DocumentVersionManager
 } from "@bendyline/squisq/versions";
@@ -1696,6 +2291,7 @@ import {
   FsError as FsError5,
   getFileSystemProviderV2 as getFileSystemProviderV25,
   isQuotaExceededError,
+  moveFileSystemEntry as moveFileSystemEntry2,
   parseWorkspacePath as parseWorkspacePath5,
   workspacePathContains
 } from "@bendyline/docblocks/filesystem";
@@ -1722,9 +2318,9 @@ import {
 } from "@bendyline/docblocks/workspace";
 
 // src/AppMenu/AppMenu.tsx
-import { useState as useState5, useCallback as useCallback5, useRef as useRef5, useEffect as useEffect5 } from "react";
+import { useState as useState6, useCallback as useCallback6, useRef as useRef6, useEffect as useEffect6 } from "react";
 import { isElectronHost as isElectronHost2 } from "@bendyline/docblocks/host";
-import { Fragment as Fragment3, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function formatBytes(bytes) {
   if (!Number.isFinite(bytes) || bytes < 0) return "\u2014";
   let value = bytes;
@@ -1754,14 +2350,15 @@ function AppMenu({
   appVersion,
   appBuildDate
 }) {
-  const [isOpen, setIsOpen] = useState5(false);
-  const [showAbout, setShowAbout] = useState5(false);
-  const [showSettings, setShowSettings] = useState5(false);
-  const [requestingPersistentStorage, setRequestingPersistentStorage] = useState5(false);
+  const [isOpen, setIsOpen] = useState6(false);
+  const [showAbout, setShowAbout] = useState6(false);
+  const [showSettings, setShowSettings] = useState6(false);
+  const [requestingPersistentStorage, setRequestingPersistentStorage] = useState6(false);
   const moreInformationUrl = isElectronHost2() ? "https://docblocks.com/desktop/" : "https://docblocks.com/web/";
-  const menuRef = useRef5(null);
-  const [storageEstimate, setStorageEstimate] = useState5(null);
-  useEffect5(() => {
+  const containerRef = useRef6(null);
+  const { menuRef, triggerRef, handleMenuKeyDown, handleTriggerKeyDown, closeMenu } = useMenuKeyboard(isOpen, setIsOpen);
+  const [storageEstimate, setStorageEstimate] = useState6(null);
+  useEffect6(() => {
     if (!showSettings || !getStorageEstimate) return;
     let cancelled = false;
     getStorageEstimate().then((estimate) => {
@@ -1773,22 +2370,26 @@ function AppMenu({
       cancelled = true;
     };
   }, [showSettings, getStorageEstimate]);
-  useEffect5(() => {
+  useEffect6(() => {
     if (!isOpen) return;
     function handleOutsideClick(e) {
-      if (menuRef.current && !menuRef.current.contains(e.target)) {
-        setIsOpen(false);
+      if (containerRef.current && !containerRef.current.contains(e.target)) {
+        closeMenu(false);
       }
     }
     document.addEventListener("mousedown", handleOutsideClick);
     return () => document.removeEventListener("mousedown", handleOutsideClick);
-  }, [isOpen]);
-  const handleAction = useCallback5((action) => {
-    setIsOpen(false);
-    action();
-  }, []);
-  const handleKeepBrowserDataFromSettings = useCallback5(async () => {
+  }, [closeMenu, isOpen]);
+  const handleAction = useCallback6(
+    (action) => {
+      closeMenu(false);
+      action();
+    },
+    [closeMenu]
+  );
+  const handleKeepBrowserDataFromSettings = useCallback6(async () => {
     if (!onKeepBrowserData || requestingPersistentStorage) return;
+    setShowSettings(false);
     setRequestingPersistentStorage(true);
     try {
       await onKeepBrowserData();
@@ -1796,17 +2397,19 @@ function AppMenu({
       setRequestingPersistentStorage(false);
     }
   }, [onKeepBrowserData, requestingPersistentStorage]);
-  return /* @__PURE__ */ jsxs5(Fragment3, { children: [
-    /* @__PURE__ */ jsxs5("div", { ref: menuRef, className: "db-app-menu", children: [
-      /* @__PURE__ */ jsxs5(
+  return /* @__PURE__ */ jsxs6(Fragment3, { children: [
+    /* @__PURE__ */ jsxs6("div", { ref: containerRef, className: "db-app-menu", children: [
+      /* @__PURE__ */ jsxs6(
         "button",
         {
+          ref: triggerRef,
           className: "db-app-menu-btn",
           onClick: () => setIsOpen(!isOpen),
+          onKeyDown: handleTriggerKeyDown,
           "aria-expanded": isOpen,
-          "aria-haspopup": "true",
+          "aria-haspopup": "menu",
           children: [
-            logoUrl ? /* @__PURE__ */ jsx5(
+            logoUrl ? /* @__PURE__ */ jsx6(
               "img",
               {
                 src: logoUrl,
@@ -1815,8 +2418,8 @@ function AppMenu({
                 width: 1266,
                 height: 544
               }
-            ) : /* @__PURE__ */ jsx5("span", { className: "db-app-menu-label", children: "docblocks" }),
-            /* @__PURE__ */ jsx5(
+            ) : /* @__PURE__ */ jsx6("span", { className: "db-app-menu-label", children: "docblocks" }),
+            /* @__PURE__ */ jsx6(
               "span",
               {
                 className: `db-app-menu-caret${isOpen ? " db-app-menu-caret--open" : ""}`,
@@ -1826,86 +2429,100 @@ function AppMenu({
           ]
         }
       ),
-      isOpen && /* @__PURE__ */ jsxs5("div", { className: "db-app-menu-dropdown", role: "menu", children: [
-        /* @__PURE__ */ jsx5(
-          "button",
-          {
-            className: "db-app-menu-item",
-            role: "menuitem",
-            onClick: () => handleAction(() => setShowSettings(true)),
-            children: "Settings"
-          }
-        ),
-        onInstallApp && /* @__PURE__ */ jsx5(
-          "button",
-          {
-            className: "db-app-menu-item",
-            role: "menuitem",
-            onClick: () => handleAction(() => void onInstallApp()),
-            children: "Install DocBlocks\u2026"
-          }
-        ),
-        onKeepBrowserData && /* @__PURE__ */ jsx5(
-          "button",
-          {
-            className: "db-app-menu-item",
-            role: "menuitem",
-            onClick: () => handleAction(() => setShowSettings(true)),
-            children: "Storage protection\u2026"
-          }
-        ),
-        onDownloadAllWorkspaces && /* @__PURE__ */ jsx5(
-          "button",
-          {
-            className: "db-app-menu-item",
-            role: "menuitem",
-            onClick: () => handleAction(() => void onDownloadAllWorkspaces()),
-            children: "Download all workspaces"
-          }
-        ),
-        /* @__PURE__ */ jsx5("div", { className: "db-app-menu-divider" }),
-        /* @__PURE__ */ jsx5(
-          "button",
-          {
-            className: "db-app-menu-item",
-            role: "menuitem",
-            onClick: () => handleAction(() => setShowAbout(true)),
-            children: "About"
-          }
-        )
-      ] })
+      isOpen && /* @__PURE__ */ jsxs6(
+        "div",
+        {
+          ref: menuRef,
+          className: "db-app-menu-dropdown",
+          role: "menu",
+          onKeyDown: handleMenuKeyDown,
+          children: [
+            /* @__PURE__ */ jsx6(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => setShowSettings(true)),
+                children: "Settings"
+              }
+            ),
+            onInstallApp && /* @__PURE__ */ jsx6(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => void onInstallApp()),
+                children: "Install DocBlocks\u2026"
+              }
+            ),
+            onKeepBrowserData && /* @__PURE__ */ jsx6(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => void handleKeepBrowserDataFromSettings()),
+                children: "Protect data from browser cleanup"
+              }
+            ),
+            onDownloadAllWorkspaces && /* @__PURE__ */ jsx6(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => void onDownloadAllWorkspaces()),
+                children: "Download all workspaces"
+              }
+            ),
+            /* @__PURE__ */ jsx6("div", { className: "db-app-menu-divider" }),
+            /* @__PURE__ */ jsx6(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => setShowAbout(true)),
+                children: "About"
+              }
+            )
+          ]
+        }
+      )
     ] }),
-    showSettings && /* @__PURE__ */ jsxs5(SettingsDialog, { onClose: () => setShowSettings(false), children: [
-      /* @__PURE__ */ jsx5(
+    showSettings && /* @__PURE__ */ jsxs6(SettingsDialog, { onClose: () => setShowSettings(false), children: [
+      /* @__PURE__ */ jsx6(
         ThemeSettings,
         {
           value: themePreference,
           onChange: (preference) => onThemeChange?.(preference)
         }
       ),
-      /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx6(
         AccentColorSettings,
         {
           value: accentColor,
           onChange: (color) => onAccentColorChange?.(color)
         }
       ),
-      /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx6(
         WriteCanvasSettingsControls,
         {
           value: writeCanvasSettings,
           onChange: (settings) => onWriteCanvasSettingsChange?.(settings)
         }
       ),
-      getStorageEstimate && /* @__PURE__ */ jsxs5("fieldset", { className: "db-settings-fieldset", children: [
-        /* @__PURE__ */ jsx5("legend", { className: "db-settings-legend", children: "Storage" }),
-        /* @__PURE__ */ jsx5("p", { className: "db-settings-hint", children: storageEstimate ? `DocBlocks documents and app data are using ${formatBytes(
+      getStorageEstimate && /* @__PURE__ */ jsxs6("fieldset", { className: "db-settings-fieldset", children: [
+        /* @__PURE__ */ jsx6("legend", { className: "db-settings-legend", children: "Storage" }),
+        /* @__PURE__ */ jsx6("p", { className: "db-settings-hint", children: storageEstimate ? `DocBlocks documents and app data are using ${formatBytes(
           storageEstimate.usage
         )} of the ${formatBytes(
           storageEstimate.quota
         )} this browser allows for the site.` : "Storage usage is not available in this browser." }),
-        storagePersistent !== void 0 && /* @__PURE__ */ jsx5("p", { className: "db-settings-hint", children: storagePersistent ? "Protected from routine browser cleanup on this device." : "Browsers may clear site data under storage pressure unless protection is granted." }),
-        onKeepBrowserData && /* @__PURE__ */ jsx5(
+        storagePersistent !== void 0 && /* @__PURE__ */ jsx6("p", { className: "db-settings-hint", children: storagePersistent ? "Protected from routine browser cleanup on this device." : "Browsers may clear site data under storage pressure unless protection is granted." }),
+        onKeepBrowserData && /* @__PURE__ */ jsx6(
           "button",
           {
             type: "button",
@@ -1916,16 +2533,16 @@ function AppMenu({
           }
         )
       ] }),
-      onVersioningPreferenceChange && /* @__PURE__ */ jsxs5("fieldset", { className: "db-settings-fieldset", children: [
-        /* @__PURE__ */ jsx5("legend", { className: "db-settings-legend", children: "Version history" }),
-        /* @__PURE__ */ jsxs5("p", { className: "db-settings-hint", children: [
+      onVersioningPreferenceChange && /* @__PURE__ */ jsxs6("fieldset", { className: "db-settings-fieldset", children: [
+        /* @__PURE__ */ jsx6("legend", { className: "db-settings-legend", children: "Version history" }),
+        /* @__PURE__ */ jsxs6("p", { className: "db-settings-hint", children: [
           "When on, DocBlocks keeps prior revisions of each document inside a sibling",
           " ",
-          /* @__PURE__ */ jsx5("code", { children: "<name>_files/.versions/" }),
+          /* @__PURE__ */ jsx6("code", { children: "<name>_files/.versions/" }),
           " folder. Individual workspaces can override this default in their own settings."
         ] }),
-        /* @__PURE__ */ jsxs5("label", { className: "db-settings-radio", children: [
-          /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsxs6("label", { className: "db-settings-radio", children: [
+          /* @__PURE__ */ jsx6(
             "input",
             {
               type: "radio",
@@ -1937,8 +2554,8 @@ function AppMenu({
           ),
           "On for all workspaces"
         ] }),
-        /* @__PURE__ */ jsxs5("label", { className: "db-settings-radio", children: [
-          /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsxs6("label", { className: "db-settings-radio", children: [
+          /* @__PURE__ */ jsx6(
             "input",
             {
               type: "radio",
@@ -1950,8 +2567,8 @@ function AppMenu({
           ),
           "On in browser workspaces, off for local folders"
         ] }),
-        /* @__PURE__ */ jsxs5("label", { className: "db-settings-radio", children: [
-          /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsxs6("label", { className: "db-settings-radio", children: [
+          /* @__PURE__ */ jsx6(
             "input",
             {
               type: "radio",
@@ -1965,16 +2582,16 @@ function AppMenu({
         ] })
       ] })
     ] }),
-    showAbout && /* @__PURE__ */ jsxs5(Dialog, { title: "About DocBlocks", onClose: () => setShowAbout(false), children: [
-      /* @__PURE__ */ jsxs5("p", { children: [
-        /* @__PURE__ */ jsx5("strong", { children: "DocBlocks" }),
+    showAbout && /* @__PURE__ */ jsxs6(Dialog, { title: "About DocBlocks", onClose: () => setShowAbout(false), children: [
+      /* @__PURE__ */ jsxs6("p", { children: [
+        /* @__PURE__ */ jsx6("strong", { children: "DocBlocks" }),
         " is a local-first Markdown document editor. Your files stay under your control."
       ] }),
-      /* @__PURE__ */ jsxs5("aside", { className: "db-about-beta", children: [
-        /* @__PURE__ */ jsx5("strong", { children: "Beta Software." }),
+      /* @__PURE__ */ jsxs6("aside", { className: "db-about-beta", children: [
+        /* @__PURE__ */ jsx6("strong", { children: "Beta Software." }),
         " We're still working through initial hiccups and issues. Please bear with us, make sure you keep backups, and",
         " ",
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks/issues/new",
@@ -1986,28 +2603,28 @@ function AppMenu({
         " ",
         "where you find them. Thanks!"
       ] }),
-      appVersion && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
-        /* @__PURE__ */ jsx5("span", { children: "Version" }),
-        /* @__PURE__ */ jsx5("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
+      appVersion && /* @__PURE__ */ jsxs6("p", { className: "db-about-version", children: [
+        /* @__PURE__ */ jsx6("span", { children: "Version" }),
+        /* @__PURE__ */ jsx6("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
       ] }),
-      appBuildDate && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
-        /* @__PURE__ */ jsx5("span", { children: "Build" }),
-        /* @__PURE__ */ jsx5("time", { dateTime: appBuildDate, children: appBuildDate })
+      appBuildDate && /* @__PURE__ */ jsxs6("p", { className: "db-about-version", children: [
+        /* @__PURE__ */ jsx6("span", { children: "Build" }),
+        /* @__PURE__ */ jsx6("time", { dateTime: appBuildDate, children: appBuildDate })
       ] }),
-      /* @__PURE__ */ jsxs5("p", { children: [
+      /* @__PURE__ */ jsxs6("p", { children: [
         "Built with",
         " ",
-        /* @__PURE__ */ jsx5("a", { href: "https://github.com/bendyline/squisq", target: "_blank", rel: "noopener noreferrer", children: "squisq" }),
+        /* @__PURE__ */ jsx6("a", { href: "https://github.com/bendyline/squisq", target: "_blank", rel: "noopener noreferrer", children: "squisq" }),
         " ",
         "by",
         " ",
-        /* @__PURE__ */ jsx5("a", { href: "https://bendyline.com", target: "_blank", rel: "noopener noreferrer", children: "Bendyline" }),
+        /* @__PURE__ */ jsx6("a", { href: "https://bendyline.com", target: "_blank", rel: "noopener noreferrer", children: "Bendyline" }),
         "."
       ] }),
-      /* @__PURE__ */ jsxs5("p", { className: "db-dialog-links", children: [
-        /* @__PURE__ */ jsx5("a", { href: moreInformationUrl, target: "_blank", rel: "noopener noreferrer", children: "More information..." }),
-        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
-        /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsxs6("p", { className: "db-dialog-links", children: [
+        /* @__PURE__ */ jsx6("a", { href: moreInformationUrl, target: "_blank", rel: "noopener noreferrer", children: "More information..." }),
+        /* @__PURE__ */ jsx6("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks",
@@ -2016,8 +2633,8 @@ function AppMenu({
             children: "GitHub"
           }
         ),
-        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx6("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks/releases",
@@ -2026,8 +2643,8 @@ function AppMenu({
             children: "Release notes"
           }
         ),
-        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx6("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks/issues",
@@ -2036,8 +2653,8 @@ function AppMenu({
             children: "Support"
           }
         ),
-        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx6("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks/blob/main/LICENSE",
@@ -2046,8 +2663,8 @@ function AppMenu({
             children: "License (MIT)"
           }
         ),
-        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx6("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx6(
           "a",
           {
             href: "https://github.com/bendyline/docblocks/blob/main/NOTICE.md",
@@ -2062,82 +2679,101 @@ function AppMenu({
 }
 
 // src/WorkspacePicker/WorkspaceSettingsButton.tsx
-import { useState as useState6, useCallback as useCallback6, useRef as useRef6, useEffect as useEffect6 } from "react";
-import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+import { useState as useState7, useCallback as useCallback7, useRef as useRef7, useEffect as useEffect7 } from "react";
+import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 function WorkspaceSettingsButton({
   onSettings,
   onRename,
   onDownload,
   onRemove
 }) {
-  const [isOpen, setIsOpen] = useState6(false);
-  const ref = useRef6(null);
-  useEffect6(() => {
+  const [isOpen, setIsOpen] = useState7(false);
+  const containerRef = useRef7(null);
+  const { menuRef, triggerRef, handleMenuKeyDown, handleTriggerKeyDown, closeMenu } = useMenuKeyboard(isOpen, setIsOpen);
+  useEffect7(() => {
     if (!isOpen) return;
     function handleOutsideClick(e) {
-      if (ref.current && !ref.current.contains(e.target)) {
-        setIsOpen(false);
+      if (containerRef.current && !containerRef.current.contains(e.target)) {
+        closeMenu(false);
       }
     }
     document.addEventListener("mousedown", handleOutsideClick);
     return () => document.removeEventListener("mousedown", handleOutsideClick);
-  }, [isOpen]);
-  const handleAction = useCallback6((action) => {
-    setIsOpen(false);
-    action();
-  }, []);
-  return /* @__PURE__ */ jsxs6("div", { ref, className: "db-ws-settings", children: [
-    /* @__PURE__ */ jsx6(
+  }, [closeMenu, isOpen]);
+  const handleAction = useCallback7(
+    (action) => {
+      closeMenu(false);
+      action();
+    },
+    [closeMenu]
+  );
+  return /* @__PURE__ */ jsxs7("div", { ref: containerRef, className: "db-ws-settings", children: [
+    /* @__PURE__ */ jsx7(
       "button",
       {
+        ref: triggerRef,
         className: "db-ws-settings-btn",
         onClick: () => setIsOpen(!isOpen),
+        onKeyDown: handleTriggerKeyDown,
         "aria-expanded": isOpen,
-        "aria-haspopup": "true",
+        "aria-haspopup": "menu",
         "aria-label": "Workspace settings",
         title: "Workspace settings",
-        children: /* @__PURE__ */ jsx6(WorkspaceIcon, {})
+        children: /* @__PURE__ */ jsx7(WorkspaceIcon, {})
       }
     ),
-    isOpen && /* @__PURE__ */ jsxs6("div", { className: "db-ws-settings-dropdown", role: "menu", children: [
-      /* @__PURE__ */ jsx6(
-        "button",
-        {
-          className: "db-ws-settings-item",
-          role: "menuitem",
-          onClick: () => handleAction(onSettings),
-          children: "Workspace settings\u2026"
-        }
-      ),
-      /* @__PURE__ */ jsx6(
-        "button",
-        {
-          className: "db-ws-settings-item",
-          role: "menuitem",
-          onClick: () => handleAction(onRename),
-          children: "Rename workspace"
-        }
-      ),
-      /* @__PURE__ */ jsx6(
-        "button",
-        {
-          className: "db-ws-settings-item",
-          role: "menuitem",
-          onClick: () => handleAction(onDownload),
-          children: "Download workspace"
-        }
-      ),
-      /* @__PURE__ */ jsx6("div", { className: "db-ws-settings-divider" }),
-      /* @__PURE__ */ jsx6(
-        "button",
-        {
-          className: "db-ws-settings-item db-ws-settings-item--danger",
-          role: "menuitem",
-          onClick: () => handleAction(onRemove),
-          children: "Remove workspace"
-        }
-      )
-    ] })
+    isOpen && /* @__PURE__ */ jsxs7(
+      "div",
+      {
+        ref: menuRef,
+        className: "db-ws-settings-dropdown",
+        role: "menu",
+        onKeyDown: handleMenuKeyDown,
+        children: [
+          /* @__PURE__ */ jsx7(
+            "button",
+            {
+              className: "db-ws-settings-item",
+              role: "menuitem",
+              tabIndex: -1,
+              onClick: () => handleAction(onSettings),
+              children: "Workspace settings\u2026"
+            }
+          ),
+          /* @__PURE__ */ jsx7(
+            "button",
+            {
+              className: "db-ws-settings-item",
+              role: "menuitem",
+              tabIndex: -1,
+              onClick: () => handleAction(onRename),
+              children: "Rename workspace"
+            }
+          ),
+          /* @__PURE__ */ jsx7(
+            "button",
+            {
+              className: "db-ws-settings-item",
+              role: "menuitem",
+              tabIndex: -1,
+              onClick: () => handleAction(onDownload),
+              children: "Download workspace"
+            }
+          ),
+          /* @__PURE__ */ jsx7("div", { className: "db-ws-settings-divider" }),
+          /* @__PURE__ */ jsx7(
+            "button",
+            {
+              className: "db-ws-settings-item db-ws-settings-item--danger",
+              role: "menuitem",
+              tabIndex: -1,
+              onClick: () => handleAction(onRemove),
+              children: "Remove workspace"
+            }
+          )
+        ]
+      }
+    )
   ] });
 }
 
@@ -2177,7 +2813,7 @@ function resolveVersioningEnabled(workspace, globalPref) {
 }
 
 // src/WorkspacePicker/WorkspaceSettingsDialog.tsx
-import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
 var VERSIONING_LABELS = {
   on: "on",
   "browser-only": "on for browser workspaces, off for local folders",
@@ -2196,23 +2832,23 @@ function WorkspaceSettingsDialog({
     globalVersioningPreference
   );
   const inheritLabel = `Inherit default \u2014 currently ${VERSIONING_LABELS[globalVersioningPreference]} (${inheritedEnabled ? "on" : "off"} for this workspace)`;
-  return /* @__PURE__ */ jsxs7(Dialog, { title: "Workspace settings", onClose, children: [
-    /* @__PURE__ */ jsxs7("p", { className: "db-settings-hint", children: [
-      /* @__PURE__ */ jsx7("strong", { children: workspace.name }),
+  return /* @__PURE__ */ jsxs8(Dialog, { title: "Workspace settings", onClose, children: [
+    /* @__PURE__ */ jsxs8("p", { className: "db-settings-hint", children: [
+      /* @__PURE__ */ jsx8("strong", { children: workspace.name }),
       " \xB7",
       " ",
       isLocal ? "Local folder workspace" : "Browser workspace"
     ] }),
-    /* @__PURE__ */ jsxs7("fieldset", { className: "db-settings-fieldset", children: [
-      /* @__PURE__ */ jsx7("legend", { className: "db-settings-legend", children: "Version history" }),
-      /* @__PURE__ */ jsxs7("p", { className: "db-settings-hint", children: [
+    /* @__PURE__ */ jsxs8("fieldset", { className: "db-settings-fieldset", children: [
+      /* @__PURE__ */ jsx8("legend", { className: "db-settings-legend", children: "Version history" }),
+      /* @__PURE__ */ jsxs8("p", { className: "db-settings-hint", children: [
         "Controls whether DocBlocks keeps prior revisions in",
         " ",
-        /* @__PURE__ */ jsx7("code", { children: "<name>_files/.versions/" }),
+        /* @__PURE__ */ jsx8("code", { children: "<name>_files/.versions/" }),
         " for documents in this workspace."
       ] }),
-      /* @__PURE__ */ jsxs7("label", { className: "db-settings-radio", children: [
-        /* @__PURE__ */ jsx7(
+      /* @__PURE__ */ jsxs8("label", { className: "db-settings-radio", children: [
+        /* @__PURE__ */ jsx8(
           "input",
           {
             type: "radio",
@@ -2224,8 +2860,8 @@ function WorkspaceSettingsDialog({
         ),
         inheritLabel
       ] }),
-      /* @__PURE__ */ jsxs7("label", { className: "db-settings-radio", children: [
-        /* @__PURE__ */ jsx7(
+      /* @__PURE__ */ jsxs8("label", { className: "db-settings-radio", children: [
+        /* @__PURE__ */ jsx8(
           "input",
           {
             type: "radio",
@@ -2237,8 +2873,8 @@ function WorkspaceSettingsDialog({
         ),
         "On for this workspace"
       ] }),
-      /* @__PURE__ */ jsxs7("label", { className: "db-settings-radio", children: [
-        /* @__PURE__ */ jsx7(
+      /* @__PURE__ */ jsxs8("label", { className: "db-settings-radio", children: [
+        /* @__PURE__ */ jsx8(
           "input",
           {
             type: "radio",
@@ -2255,14 +2891,14 @@ function WorkspaceSettingsDialog({
 }
 
 // src/hooks/useDocumentSession.ts
-import { useState as useState7, useSyncExternalStore } from "react";
+import { useState as useState8, useSyncExternalStore } from "react";
 import {
   DocumentRecoveryJournal,
   DocumentSession,
   getDefaultDocumentRecoveryStorage
 } from "@bendyline/docblocks/document";
 function useDocumentSession(autoSaveDelayMs = 500) {
-  const [session] = useState7(
+  const [session] = useState8(
     () => new DocumentSession({
       autoSaveDelayMs,
       recoveryJournal: new DocumentRecoveryJournal(getDefaultDocumentRecoveryStorage())
@@ -2278,38 +2914,38 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 
 // src/Export/DeferredExportToolbarControls.tsx
 import { lazy, Suspense } from "react";
-import { jsx as jsx8 } from "react/jsx-runtime";
+import { jsx as jsx9 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-2VB43ITO.js").then((module) => ({
+  () => import("./ExportToolbarControls-773QRE4R.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
 function ExportToolbarControls(props) {
-  return /* @__PURE__ */ jsx8(Suspense, { fallback: null, children: /* @__PURE__ */ jsx8(ExportToolbarControlsImplementation, { ...props }) });
+  return /* @__PURE__ */ jsx9(Suspense, { fallback: null, children: /* @__PURE__ */ jsx9(ExportToolbarControlsImplementation, { ...props }) });
 }
 
 // src/Git/useGit.ts
-import { useCallback as useCallback8, useEffect as useEffect8, useMemo as useMemo2, useRef as useRef8, useState as useState9 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect9, useMemo as useMemo2, useRef as useRef9, useState as useState10 } from "react";
 import { maybeGetDocBlocksHost } from "@bendyline/docblocks/host";
 
 // src/Git/useGitStatus.ts
-import { useCallback as useCallback7, useEffect as useEffect7, useRef as useRef7, useState as useState8 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect8, useRef as useRef8, useState as useState9 } from "react";
 var SCHEDULE_REFRESH_MS = 1500;
 function statusKey(status) {
   return JSON.stringify(status);
 }
 function useGitStatus(gitApi, repositoryId, enabled) {
-  const [status, setStatus] = useState8(null);
-  const lastKeyRef = useRef7(null);
-  const timerRef = useRef7(null);
-  const generationRef = useRef7(0);
-  const apply = useCallback7((next) => {
+  const [status, setStatus] = useState9(null);
+  const lastKeyRef = useRef8(null);
+  const timerRef = useRef8(null);
+  const generationRef = useRef8(0);
+  const apply = useCallback8((next) => {
     const key = statusKey(next);
     if (key === lastKeyRef.current) return;
     lastKeyRef.current = key;
     setStatus(next);
   }, []);
-  useEffect7(() => {
+  useEffect8(() => {
     generationRef.current += 1;
     if (timerRef.current) {
       clearTimeout(timerRef.current);
@@ -2327,7 +2963,7 @@ function useGitStatus(gitApi, repositoryId, enabled) {
       unsubscribe();
     };
   }, [gitApi, repositoryId, enabled, apply]);
-  const refresh = useCallback7(() => {
+  const refresh = useCallback8(() => {
     if (!gitApi || !repositoryId || !enabled) return;
     const generation = generationRef.current;
     void gitApi.status(repositoryId).then(
@@ -2341,14 +2977,14 @@ function useGitStatus(gitApi, repositoryId, enabled) {
       () => void 0
     );
   }, [gitApi, repositoryId, enabled, apply]);
-  const scheduleRefresh = useCallback7(() => {
+  const scheduleRefresh = useCallback8(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     timerRef.current = setTimeout(() => {
       timerRef.current = null;
       refresh();
     }, SCHEDULE_REFRESH_MS);
   }, [refresh]);
-  useEffect7(() => {
+  useEffect8(() => {
     return () => {
       if (timerRef.current) clearTimeout(timerRef.current);
     };
@@ -2374,8 +3010,8 @@ function useGit(provider, requestedWorkspaceId, theme) {
   const host = maybeGetDocBlocksHost();
   const gitApi = host?.git ?? null;
   const workspaceId = gitApi ? requestedWorkspaceId : null;
-  const [capabilities, setCapabilities] = useState9(null);
-  useEffect8(() => {
+  const [capabilities, setCapabilities] = useState10(null);
+  useEffect9(() => {
     if (!gitApi) return;
     let cancelled = false;
     let timer = null;
@@ -2401,9 +3037,9 @@ function useGit(provider, requestedWorkspaceId, theme) {
     };
   }, [gitApi]);
   const available = gitApi !== null && capabilities?.gitAvailable === true;
-  const [repo, setRepo] = useState9(null);
-  const [remoteWeb, setRemoteWeb] = useState9(null);
-  useEffect8(() => {
+  const [repo, setRepo] = useState10(null);
+  const [remoteWeb, setRemoteWeb] = useState10(null);
+  useEffect9(() => {
     setRepo(null);
     setRemoteWeb(null);
     if (!gitApi || !workspaceId || !available) return;
@@ -2436,15 +3072,15 @@ function useGit(provider, requestedWorkspaceId, theme) {
   const isRepo = repositoryId !== null;
   const { status, refresh, scheduleRefresh } = useGitStatus(gitApi, repositoryId, isRepo);
   const badges = useMemo2(() => buildBadgeMap(status?.changes ?? []), [status]);
-  const [busy, setBusy] = useState9(null);
-  const [lastResult, setLastResult] = useState9(null);
-  const [dialog, setDialog] = useState9({ kind: "none" });
-  const openDialog = useCallback8((next) => {
+  const [busy, setBusy] = useState10(null);
+  const [lastResult, setLastResult] = useState10(null);
+  const [dialog, setDialog] = useState10({ kind: "none" });
+  const openDialog = useCallback9((next) => {
     setLastResult(null);
     setDialog(next);
   }, []);
-  const closeDialog = useCallback8(() => setDialog({ kind: "none" }), []);
-  const routeError = useCallback8(
+  const closeDialog = useCallback9(() => setDialog({ kind: "none" }), []);
+  const routeError = useCallback9(
     (operation, error) => {
       if (error.code === "auth-failed") {
         setDialog({
@@ -2458,11 +3094,11 @@ function useGit(provider, requestedWorkspaceId, theme) {
     },
     []
   );
-  const statusRef = useRef8(status);
-  useEffect8(() => {
+  const statusRef = useRef9(status);
+  useEffect9(() => {
     statusRef.current = status;
   }, [status]);
-  const runAction = useCallback8(
+  const runAction = useCallback9(
     async (kind, operation, action, successMessage) => {
       if (!gitApi || !repositoryId) return false;
       setBusy(kind);
@@ -2491,7 +3127,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     },
     [gitApi, repositoryId, refresh, routeError]
   );
-  const commit = useCallback8(
+  const commit = useCallback9(
     (message, paths) => runAction(
       "commit",
       "commit",
@@ -2500,7 +3136,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     ),
     [runAction]
   );
-  const push = useCallback8(async () => {
+  const push = useCallback9(async () => {
     const setUpstream = statusRef.current?.upstream === null;
     await runAction(
       "push",
@@ -2509,13 +3145,13 @@ function useGit(provider, requestedWorkspaceId, theme) {
       setUpstream ? "Branch published" : "Pushed"
     );
   }, [runAction]);
-  const pull = useCallback8(async () => {
+  const pull = useCallback9(async () => {
     await runAction("pull", "pull", (api, repository) => api.pull(repository), "Pulled");
   }, [runAction]);
-  const fetchRemote = useCallback8(async () => {
+  const fetchRemote = useCallback9(async () => {
     await runAction("fetch", "fetch", (api, repository) => api.fetch(repository), "Fetched");
   }, [runAction]);
-  const createBranch = useCallback8(
+  const createBranch = useCallback9(
     (name) => runAction(
       "branch",
       "branch",
@@ -2524,7 +3160,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     ),
     [runAction]
   );
-  const switchBranch = useCallback8(
+  const switchBranch = useCallback9(
     (name) => runAction(
       "branch",
       "branch",
@@ -2533,7 +3169,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     ),
     [runAction]
   );
-  const openOnRemote = useCallback8(
+  const openOnRemote = useCallback9(
     (filePath) => {
       if (!remoteWeb || !host) return;
       let url = remoteWeb.webUrl;
@@ -2545,7 +3181,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     },
     [remoteWeb, host]
   );
-  const createPullRequest = useCallback8(async () => {
+  const createPullRequest = useCallback9(async () => {
     if (!gitApi || !repositoryId) return;
     setBusy("pr");
     setLastResult(null);
@@ -2663,7 +3299,7 @@ function retainFileSystemProvider(provider) {
 }
 
 // src/DocBlocksShell/document-title.ts
-import { useEffect as useEffect9 } from "react";
+import { useEffect as useEffect10 } from "react";
 var APP_TITLE = "DocBlocks";
 var INSTALLED_DISPLAY_QUERIES = [
   "(display-mode: window-controls-overlay)",
@@ -2687,7 +3323,7 @@ function titleForSelectedFile(selectedFile, homeDocumentTitle = APP_TITLE, homeD
   return includeAppName ? `${name} - ${APP_TITLE}` : name;
 }
 function useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath) {
-  useEffect9(() => {
+  useEffect10(() => {
     if (typeof document === "undefined") return;
     const displayQueries = typeof globalThis.matchMedia === "function" ? INSTALLED_DISPLAY_QUERIES.map((query) => globalThis.matchMedia(query)) : [];
     const updateTitle = () => {
@@ -2946,33 +3582,33 @@ function summariseImport(result) {
 }
 
 // src/components/usePromptDialog.ts
-import React2, { useCallback as useCallback10, useEffect as useEffect11, useRef as useRef10, useState as useState11 } from "react";
+import React2, { useCallback as useCallback11, useEffect as useEffect12, useRef as useRef11, useState as useState12 } from "react";
 
 // src/components/PromptDialog.tsx
-import { useCallback as useCallback9, useEffect as useEffect10, useId, useRef as useRef9, useState as useState10 } from "react";
-import { Fragment as Fragment4, jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
+import { useCallback as useCallback10, useEffect as useEffect11, useId as useId2, useRef as useRef10, useState as useState11 } from "react";
+import { Fragment as Fragment4, jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
 function PromptDialog({ request, onSettle }) {
-  const [value, setValue] = useState10(request.initialValue ?? "");
-  const inputRef = useRef9(null);
-  const inputId = useId();
-  const cancel = useCallback9(() => onSettle(null), [onSettle]);
-  const submit = useCallback9(() => {
+  const [value, setValue] = useState11(request.initialValue ?? "");
+  const inputRef = useRef10(null);
+  const inputId = useId2();
+  const cancel = useCallback10(() => onSettle(null), [onSettle]);
+  const submit = useCallback10(() => {
     if (value.trim() === "") return;
     onSettle(value);
   }, [onSettle, value]);
-  useEffect10(() => {
+  useEffect11(() => {
     inputRef.current?.select();
   }, []);
-  return /* @__PURE__ */ jsx9(
+  return /* @__PURE__ */ jsx10(
     Dialog,
     {
       title: request.title,
       onClose: cancel,
       initialFocusRef: inputRef,
       closeOnBackdrop: false,
-      footer: /* @__PURE__ */ jsxs8(Fragment4, { children: [
-        /* @__PURE__ */ jsx9("button", { type: "button", className: "db-git-secondary-btn", onClick: cancel, children: "Cancel" }),
-        /* @__PURE__ */ jsx9(
+      footer: /* @__PURE__ */ jsxs9(Fragment4, { children: [
+        /* @__PURE__ */ jsx10("button", { type: "button", className: "db-git-secondary-btn", onClick: cancel, children: "Cancel" }),
+        /* @__PURE__ */ jsx10(
           "button",
           {
             type: "button",
@@ -2983,9 +3619,9 @@ function PromptDialog({ request, onSettle }) {
           }
         )
       ] }),
-      children: /* @__PURE__ */ jsxs8("div", { className: "db-git-form-row", children: [
-        /* @__PURE__ */ jsx9("label", { className: "db-git-form-label", htmlFor: inputId, children: request.label }),
-        /* @__PURE__ */ jsx9(
+      children: /* @__PURE__ */ jsxs9("div", { className: "db-git-form-row", children: [
+        /* @__PURE__ */ jsx10("label", { className: "db-git-form-label", htmlFor: inputId, children: request.label }),
+        /* @__PURE__ */ jsx10(
           "input",
           {
             id: inputId,
@@ -3008,17 +3644,17 @@ function PromptDialog({ request, onSettle }) {
 
 // src/components/usePromptDialog.ts
 function usePromptDialog() {
-  const [pending, setPending] = useState11(null);
-  const pendingRef = useRef10(null);
-  const nextIdRef = useRef10(0);
-  const settlePending = useCallback10((value) => {
+  const [pending, setPending] = useState12(null);
+  const pendingRef = useRef11(null);
+  const nextIdRef = useRef11(0);
+  const settlePending = useCallback11((value) => {
     const current = pendingRef.current;
     if (!current) return;
     pendingRef.current = null;
     setPending((open) => open?.id === current.id ? null : open);
     current.settle(value);
   }, []);
-  const prompt = useCallback10(
+  const prompt = useCallback11(
     (request) => new Promise((resolve) => {
       settlePending(null);
       const next = { id: ++nextIdRef.current, request, settle: resolve };
@@ -3027,7 +3663,7 @@ function usePromptDialog() {
     }),
     [settlePending]
   );
-  useEffect11(() => {
+  useEffect12(() => {
     return () => settlePending(null);
   }, [settlePending]);
   const promptDialog = pending ? React2.createElement(PromptDialog, {
@@ -3040,28 +3676,28 @@ function usePromptDialog() {
 }
 
 // src/components/useConfirmDialog.ts
-import React4, { useCallback as useCallback12, useEffect as useEffect12, useRef as useRef12, useState as useState12 } from "react";
+import React4, { useCallback as useCallback13, useEffect as useEffect13, useRef as useRef13, useState as useState13 } from "react";
 
 // src/components/ConfirmDialog.tsx
-import { useCallback as useCallback11, useRef as useRef11 } from "react";
-import { Fragment as Fragment5, jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
+import { useCallback as useCallback12, useRef as useRef12 } from "react";
+import { Fragment as Fragment5, jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 function ConfirmDialog({ request, onSettle }) {
   const acknowledge = request.kind === "acknowledge";
   const destructive = request.kind === "confirm" && request.destructive === true;
-  const cancelRef = useRef11(null);
-  const confirmRef = useRef11(null);
-  const accept = useCallback11(() => onSettle(true), [onSettle]);
-  const reject = useCallback11(() => onSettle(false), [onSettle]);
+  const cancelRef = useRef12(null);
+  const confirmRef = useRef12(null);
+  const accept = useCallback12(() => onSettle(true), [onSettle]);
+  const reject = useCallback12(() => onSettle(false), [onSettle]);
   const close = acknowledge ? accept : reject;
-  return /* @__PURE__ */ jsx10(
+  return /* @__PURE__ */ jsx11(
     Dialog,
     {
       title: request.title,
       onClose: close,
       initialFocusRef: destructive ? cancelRef : confirmRef,
-      footer: /* @__PURE__ */ jsxs9(Fragment5, { children: [
-        !acknowledge && /* @__PURE__ */ jsx10("button", { ref: cancelRef, type: "button", className: "db-git-secondary-btn", onClick: reject, children: request.cancelLabel ?? "Cancel" }),
-        /* @__PURE__ */ jsx10(
+      footer: /* @__PURE__ */ jsxs10(Fragment5, { children: [
+        !acknowledge && /* @__PURE__ */ jsx11("button", { ref: cancelRef, type: "button", className: "db-git-secondary-btn", onClick: reject, children: request.cancelLabel ?? "Cancel" }),
+        /* @__PURE__ */ jsx11(
           "button",
           {
             ref: confirmRef,
@@ -3072,24 +3708,24 @@ function ConfirmDialog({ request, onSettle }) {
           }
         )
       ] }),
-      children: /* @__PURE__ */ jsx10("p", { className: "db-dialog-message", children: request.message })
+      children: /* @__PURE__ */ jsx11("p", { className: "db-dialog-message", children: request.message })
     }
   );
 }
 
 // src/components/useConfirmDialog.ts
 function useConfirmDialog() {
-  const [pending, setPending] = useState12(null);
-  const pendingRef = useRef12(null);
-  const nextIdRef = useRef12(0);
-  const settlePending = useCallback12((value) => {
+  const [pending, setPending] = useState13(null);
+  const pendingRef = useRef13(null);
+  const nextIdRef = useRef13(0);
+  const settlePending = useCallback13((value) => {
     const current = pendingRef.current;
     if (!current) return;
     pendingRef.current = null;
     setPending((open2) => open2?.id === current.id ? null : open2);
     current.settle(value);
   }, []);
-  const open = useCallback12(
+  const open = useCallback13(
     (request) => new Promise((resolve) => {
       settlePending(false);
       const next = { id: ++nextIdRef.current, request, settle: resolve };
@@ -3098,17 +3734,17 @@ function useConfirmDialog() {
     }),
     [settlePending]
   );
-  const confirm = useCallback12(
+  const confirm = useCallback13(
     (request) => open({ kind: "confirm", ...request }),
     [open]
   );
-  const acknowledge = useCallback12(
+  const acknowledge = useCallback13(
     async (request) => {
       await open({ kind: "acknowledge", ...request });
     },
     [open]
   );
-  useEffect12(() => {
+  useEffect13(() => {
     return () => settlePending(false);
   }, [settlePending]);
   const confirmDialog = pending ? React4.createElement(ConfirmDialog, {
@@ -3161,7 +3797,7 @@ function buildIssueReportUrl(environment) {
 }
 
 // src/DocBlocksShell/last-state.ts
-import { tryParseWorkspacePath } from "@bendyline/docblocks/filesystem";
+import { tryParseWorkspacePath as tryParseWorkspacePath2 } from "@bendyline/docblocks/filesystem";
 var LAST_STATE_KEY = "docblocks:lastState";
 var MAX_WORKSPACE_ID_CHARACTERS = 256;
 var MAX_WORKSPACE_PATH_CHARACTERS = 4096;
@@ -3182,7 +3818,7 @@ function parseLastState(value) {
   if (!hasExactKeys(record, ["workspaceId", "filePath", "view"])) return null;
   if (!isBoundedText(record.workspaceId, MAX_WORKSPACE_ID_CHARACTERS)) return null;
   if (!isBoundedText(record.filePath, MAX_WORKSPACE_PATH_CHARACTERS)) return null;
-  const parsedPath = tryParseWorkspacePath(record.filePath);
+  const parsedPath = tryParseWorkspacePath2(record.filePath);
   if (!parsedPath) return null;
   if (typeof record.view !== "string" || !EDITOR_VIEWS.has(record.view)) return null;
   return {
@@ -3282,8 +3918,8 @@ function saveViewPreferences(preferences) {
 }
 
 // src/DocBlocksShell/UpdateAvailableNotice.tsx
-import { useState as useState13 } from "react";
-import { Fragment as Fragment6, jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+import { useState as useState14 } from "react";
+import { Fragment as Fragment6, jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 var UPDATE_PROMPT_ID = "db-update-available-prompt";
 function UpdateAvailableNotice({
   available,
@@ -3291,11 +3927,11 @@ function UpdateAvailableNotice({
   blocked = false,
   statusBarVisible
 }) {
-  const [promptOpen, setPromptOpen] = useState13(false);
+  const [promptOpen, setPromptOpen] = useState14(false);
   if (!available || !onApplyUpdate) return null;
   const promptVisible = promptOpen && !blocked;
-  return /* @__PURE__ */ jsxs10(Fragment6, { children: [
-    /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsxs11(Fragment6, { children: [
+    /* @__PURE__ */ jsx12(
       "button",
       {
         type: "button",
@@ -3309,17 +3945,17 @@ function UpdateAvailableNotice({
         children: "Update available"
       }
     ),
-    promptVisible && /* @__PURE__ */ jsxs10(
+    promptVisible && /* @__PURE__ */ jsxs11(
       "div",
       {
         id: UPDATE_PROMPT_ID,
         className: `db-update-banner${statusBarVisible ? "" : " db-update-banner--floating"}`,
         role: "alert",
         children: [
-          /* @__PURE__ */ jsx11("span", { children: "A new version of DocBlocks is available. Reload to update the editor and site pages." }),
-          /* @__PURE__ */ jsxs10("div", { className: "db-update-banner-actions", children: [
-            /* @__PURE__ */ jsx11("button", { type: "button", onClick: onApplyUpdate, disabled: blocked, children: "Reload" }),
-            /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => setPromptOpen(false), children: "Later" })
+          /* @__PURE__ */ jsx12("span", { children: "A new version of DocBlocks is available. Reload to update the editor and site pages." }),
+          /* @__PURE__ */ jsxs11("div", { className: "db-update-banner-actions", children: [
+            /* @__PURE__ */ jsx12("button", { type: "button", onClick: onApplyUpdate, disabled: blocked, children: "Reload" }),
+            /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => setPromptOpen(false), children: "Later" })
           ] })
         ]
       }
@@ -3328,7 +3964,7 @@ function UpdateAvailableNotice({
 }
 
 // src/DocBlocksShell/useDocumentLinkProvider.ts
-import { useCallback as useCallback13, useEffect as useEffect13, useRef as useRef13 } from "react";
+import { useCallback as useCallback14, useEffect as useEffect14, useRef as useRef14 } from "react";
 
 // src/DocBlocksShell/document-links.ts
 import {
@@ -3510,8 +4146,8 @@ function createDocumentLinkCandidates(entries, selectedFile, query) {
 
 // src/DocBlocksShell/useDocumentLinkProvider.ts
 function useDocumentLinkProvider(provider, selectedFile, epoch = 0) {
-  const cacheRef = useRef13(null);
-  useEffect13(
+  const cacheRef = useRef14(null);
+  useEffect14(
     () => () => {
       if (cacheRef.current?.provider !== provider || cacheRef.current.epoch !== epoch) return;
       cacheRef.current.controller.abort();
@@ -3519,7 +4155,7 @@ function useDocumentLinkProvider(provider, selectedFile, epoch = 0) {
     },
     [provider, epoch]
   );
-  return useCallback13(
+  return useCallback14(
     async (query) => {
       if (!provider || !selectedFile) return [];
       let cache = cacheRef.current;
@@ -3720,7 +4356,7 @@ var WELCOME_DOCUMENT_CONTENT = [
 ].join("\n");
 
 // src/DocBlocksShell/DocBlocksShell.tsx
-import { Fragment as Fragment7, jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
+import { Fragment as Fragment7, jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 var editorShellModulePromise = null;
 function loadEditorShell() {
   editorShellModulePromise ?? (editorShellModulePromise = (async () => {
@@ -3732,9 +4368,9 @@ function loadEditorShell() {
   return editorShellModulePromise;
 }
 var EditorShell = lazy2(loadEditorShell);
-var GitUI = lazy2(() => import("./GitUI-GMH3PAYL.js").then((m) => ({ default: m.GitUI })));
+var GitUI = lazy2(() => import("./GitUI-CAKFVKWY.js").then((m) => ({ default: m.GitUI })));
 var GitToolbarControl = lazy2(
-  () => import("./GitToolbarControl-FW3BZFXV.js").then((m) => ({ default: m.GitToolbarControl }))
+  () => import("./GitToolbarControl-VJVK2B4X.js").then((m) => ({ default: m.GitToolbarControl }))
 );
 var DOCBLOCKS_VIDEO_EXPORT_PALETTE = Object.freeze({
   overlay: "rgba(0, 0, 0, 0.72)",
@@ -3809,10 +4445,10 @@ function isMemoryWorkspaceProvider(provider) {
   return typeof candidate.captureContents === "function" && typeof candidate.replaceContents === "function" && typeof candidate.treeVersion === "number";
 }
 function useOsTheme() {
-  const [dark, setDark] = useState14(
+  const [dark, setDark] = useState15(
     () => typeof window !== "undefined" && window.matchMedia("(prefers-color-scheme: dark)").matches
   );
-  useEffect14(() => {
+  useEffect15(() => {
     const mq = window.matchMedia("(prefers-color-scheme: dark)");
     const handler = (e) => setDark(e.matches);
     mq.addEventListener("change", handler);
@@ -3883,6 +4519,32 @@ async function readProviderText(provider, path) {
   const file = await providerV2.readFile(parseWorkspacePath5(path));
   return file ? decodeUtf8Text(file.data, { label: "The document", path: parseWorkspacePath5(path) }) : null;
 }
+async function pinnedProviderFileExists(provider, path) {
+  const providerV2 = getFileSystemProviderV25(provider);
+  if (!providerV2) return provider.exists(path);
+  const entry = await providerV2.stat(parseWorkspacePath5(path));
+  if (!entry) return false;
+  if (entry.kind !== "file") throw new Error("The pinned path is no longer a document.");
+  return true;
+}
+async function removePinnedProviderFile(provider, path) {
+  const providerV2 = getFileSystemProviderV25(provider);
+  if (providerV2) {
+    const canonical = parseWorkspacePath5(path);
+    const entry = await providerV2.stat(canonical);
+    if (!entry) return false;
+    if (entry.kind !== "file") throw new Error("The pinned path is no longer a document.");
+    await providerV2.remove(canonical, {
+      recursive: false,
+      missing: "error",
+      expectedVersion: entry.version
+    });
+    return true;
+  }
+  if (!await provider.exists(path)) return false;
+  await provider.delete(path);
+  return true;
+}
 async function readStableFileSnapshot(provider, path) {
   const providerV2 = getFileSystemProviderV25(provider);
   if (providerV2) {
@@ -3968,10 +4630,10 @@ async function createElectronProviderFromWorkspace(ws) {
   return createElectronFileSystemProvider(ws.id, ws.name, ws.rootPath);
 }
 function useIsMobile(breakpoint = 768) {
-  const [isMobile, setIsMobile] = useState14(
+  const [isMobile, setIsMobile] = useState15(
     () => typeof window !== "undefined" && window.matchMedia(`(max-width: ${breakpoint}px)`).matches
   );
-  useEffect14(() => {
+  useEffect15(() => {
     const mq = window.matchMedia(`(max-width: ${breakpoint}px)`);
     const handler = (e) => setIsMobile(e.matches);
     mq.addEventListener("change", handler);
@@ -3980,7 +4642,7 @@ function useIsMobile(breakpoint = 768) {
   return isMobile;
 }
 function FolderGlyph() {
-  return /* @__PURE__ */ jsx12(
+  return /* @__PURE__ */ jsx13(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -3989,12 +4651,12 @@ function FolderGlyph() {
       strokeWidth: "1.5",
       strokeLinejoin: "round",
       "aria-hidden": "true",
-      children: /* @__PURE__ */ jsx12("path", { d: "M3 7a1 1 0 0 1 1-1h5l2 2h9a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7z" })
+      children: /* @__PURE__ */ jsx13("path", { d: "M3 7a1 1 0 0 1 1-1h5l2 2h9a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7z" })
     }
   );
 }
 function FileGlyph() {
-  return /* @__PURE__ */ jsxs11(
+  return /* @__PURE__ */ jsxs12(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -4004,8 +4666,8 @@ function FileGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx12("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
-        /* @__PURE__ */ jsx12("path", { d: "M14 3v5h5" })
+        /* @__PURE__ */ jsx13("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
+        /* @__PURE__ */ jsx13("path", { d: "M14 3v5h5" })
       ]
     }
   );
@@ -4026,48 +4688,58 @@ function DocBlocksShell({
   versioningRef,
   updateAvailable = false,
   onApplyUpdate,
+  statusBarSlotRight,
   offlineReady = false
 }) {
   const osTheme = useOsTheme();
-  const [themePreference, setThemePreference] = useState14(loadThemePreference);
-  const [accentColor, setAccentColor] = useState14(loadAccentColor);
-  const [writeCanvasSettings, setWriteCanvasSettings] = useState14(
+  const [themePreference, setThemePreference] = useState15(loadThemePreference);
+  const [accentColor, setAccentColor] = useState15(loadAccentColor);
+  const [writeCanvasSettings, setWriteCanvasSettings] = useState15(
     loadWriteCanvasPreferences
   );
+  const editorWriteCanvasSettings = useMemo3(
+    () => ({
+      textSize: writeCanvasSettings.textSize,
+      lineSpacing: writeCanvasSettings.lineSpacing,
+      ...resolveWriteCanvasFonts(writeCanvasSettings.fontScheme)
+    }),
+    [writeCanvasSettings]
+  );
   const resolvedTheme = resolveShellTheme({ preference: themePreference, hostTheme, osTheme });
-  const handleThemeChange = useCallback14((pref) => {
+  const handleThemeChange = useCallback15((pref) => {
     setThemePreference(pref);
     saveThemePreference(pref);
   }, []);
-  useEffect14(() => {
+  useEffect15(() => {
     if (isElectronHost3() || typeof document === "undefined") return;
     const metas = document.querySelectorAll('meta[name="theme-color"]');
     metas.forEach((meta) => {
       meta.content = DB_CHROME_COLORS[resolvedTheme];
     });
   }, [resolvedTheme]);
-  const handleAccentColorChange = useCallback14((color) => {
+  const handleAccentColorChange = useCallback15((color) => {
     setAccentColor(color);
     saveAccentColor(color);
   }, []);
-  const handleWriteCanvasSettingsChange = useCallback14((settings) => {
+  const handleWriteCanvasSettingsChange = useCallback15((settings) => {
     setWriteCanvasSettings(settings);
     saveWriteCanvasPreferences(settings);
   }, []);
-  const [viewPreferences, setViewPreferences] = useState14(loadViewPreferences);
-  const handleViewPreferencesChange = useCallback14((prefs) => {
+  const [viewPreferences, setViewPreferences] = useState15(loadViewPreferences);
+  const handleViewPreferencesChange = useCallback15((prefs) => {
     setViewPreferences(prefs);
     saveViewPreferences(prefs);
   }, []);
   const isMobile = useIsMobile();
-  const [mobileShowEditor, setMobileShowEditor] = useState14(
+  const defaultPreviewViewportPreset = useResponsivePreviewViewportPreset();
+  const [mobileShowEditor, setMobileShowEditor] = useState15(
     () => isMobile && isWelcomeGatewayDismissed()
   );
-  useEffect14(() => {
+  useEffect15(() => {
     if (isMobile) void loadEditorShell();
   }, [isMobile]);
-  const [sidebarWidth, setSidebarWidth] = useState14(loadSidebarWidth);
-  const [compactLayout, setCompactLayout] = useState14(false);
+  const [sidebarWidth, setSidebarWidth] = useState15(loadSidebarWidth);
+  const [compactLayout, setCompactLayout] = useState15(false);
   const effectiveCompact = isMobile || compactLayout;
   const showBrowserStorageWarning = !isElectronHost3();
   const appVersion = isElectronHost3() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web";
@@ -4076,17 +4748,17 @@ function DocBlocksShell({
     version: appVersion,
     userAgent: typeof navigator === "undefined" ? "" : navigator.userAgent
   });
-  const [browserStoragePersistent, setBrowserStoragePersistent] = useState14(false);
-  const [saveToast, setSaveToast] = useState14(null);
-  const saveToastTimerRef = useRef14(null);
-  const showToast = useCallback14((kind, message) => {
+  const [browserStoragePersistent, setBrowserStoragePersistent] = useState15(false);
+  const [saveToast, setSaveToast] = useState15(null);
+  const saveToastTimerRef = useRef15(null);
+  const showToast = useCallback15((kind, message) => {
     setSaveToast({ kind, message });
     if (saveToastTimerRef.current) clearTimeout(saveToastTimerRef.current);
     saveToastTimerRef.current = setTimeout(() => setSaveToast(null), 3e3);
   }, []);
   const { prompt: promptForText, promptDialog } = usePromptDialog();
   const { confirm: confirmAction, acknowledge, confirmDialog } = useConfirmDialog();
-  const confirmDeleteEntry = useCallback14(
+  const confirmDeleteEntry = useCallback15(
     (message) => confirmAction({
       title: "Delete",
       message,
@@ -4095,12 +4767,12 @@ function DocBlocksShell({
     }),
     [confirmAction]
   );
-  const [installPromptEvent, setInstallPromptEvent] = useState14(
+  const [installPromptEvent, setInstallPromptEvent] = useState15(
     null
   );
-  const sidebarRef = useRef14(null);
-  const dragStateRef = useRef14(null);
-  const handleResizerPointerDown = useCallback14(
+  const sidebarRef = useRef15(null);
+  const dragStateRef = useRef15(null);
+  const handleResizerPointerDown = useCallback15(
     (e) => {
       if (e.button !== 0) return;
       dragStateRef.current = { startX: e.clientX, startWidth: sidebarWidth };
@@ -4152,17 +4824,17 @@ function DocBlocksShell({
     },
     [sidebarWidth]
   );
-  const [provider, setProvider] = useState14(null);
-  const [workspaceStartupError, setWorkspaceStartupError] = useState14(null);
-  const [activeWorkspaceId, setActiveWorkspaceId] = useState14(null);
-  const [activeWorkspaceDescriptor, setActiveWorkspaceDescriptor] = useState14(null);
-  useEffect14(() => {
+  const [provider, setProvider] = useState15(null);
+  const [workspaceStartupError, setWorkspaceStartupError] = useState15(null);
+  const [activeWorkspaceId, setActiveWorkspaceId] = useState15(null);
+  const [activeWorkspaceDescriptor, setActiveWorkspaceDescriptor] = useState15(null);
+  useEffect15(() => {
     if (!provider || getTransientWorkspace(provider.id)) return;
     const providerV2 = getFileSystemProviderV25(provider);
     return providerV2 ? retainFileSystemProvider(providerV2) : void 0;
   }, [provider]);
-  const [descriptorRefreshKey, setDescriptorRefreshKey] = useState14(0);
-  useEffect14(() => {
+  const [descriptorRefreshKey, setDescriptorRefreshKey] = useState15(0);
+  useEffect15(() => {
     let cancelled = false;
     if (!activeWorkspaceId) {
       setActiveWorkspaceDescriptor(null);
@@ -4175,10 +4847,94 @@ function DocBlocksShell({
       cancelled = true;
     };
   }, [activeWorkspaceId, descriptorRefreshKey]);
-  const [transientMoveDestinations, setTransientMoveDestinations] = useState14(
+  const [pinnedDocuments, setPinnedDocuments] = useState15(loadPinnedDocuments);
+  const [pinnedDocumentAvailability, setPinnedDocumentAvailability] = useState15(() => /* @__PURE__ */ new Map());
+  useEffect15(() => {
+    savePinnedDocuments(pinnedDocuments);
+  }, [pinnedDocuments]);
+  useEffect15(() => {
+    if (!isElectronHost3()) return;
+    getDocBlocksHost().menu.setPinnedDocuments(
+      pinnedDocuments.map((document2) => ({
+        workspaceId: document2.workspaceId,
+        workspaceName: document2.workspaceName,
+        path: document2.path
+      }))
+    );
+  }, [pinnedDocuments]);
+  const setPinnedAvailability = useCallback15(
+    (document2, availability) => {
+      const key = pinnedDocumentKey(document2);
+      setPinnedDocumentAvailability((current) => {
+        if (current.get(key) === availability) return current;
+        const next = new Map(current);
+        next.set(key, availability);
+        return next;
+      });
+    },
+    []
+  );
+  const pinnedDocumentItems = useMemo3(
+    () => pinnedDocuments.map((document2) => ({
+      ...document2,
+      availability: pinnedDocumentAvailability.get(pinnedDocumentKey(document2)) ?? "unknown"
+    })),
+    [pinnedDocumentAvailability, pinnedDocuments]
+  );
+  useEffect15(() => {
+    if (!provider || !activeWorkspaceId) return;
+    const activePins = pinnedDocuments.filter(
+      (document2) => document2.workspaceId === activeWorkspaceId
+    );
+    if (activePins.length === 0) return;
+    let cancelled = false;
+    let scanning = false;
+    let scanAgain = false;
+    const scan = async () => {
+      if (scanning) {
+        scanAgain = true;
+        return;
+      }
+      scanning = true;
+      try {
+        do {
+          scanAgain = false;
+          await Promise.all(
+            activePins.map(async (document2) => {
+              try {
+                const exists = await providerEntryExists(provider, document2.path);
+                if (!cancelled) setPinnedAvailability(document2, exists ? "available" : "missing");
+              } catch {
+                if (!cancelled) setPinnedAvailability(document2, "unknown");
+              }
+            })
+          );
+        } while (scanAgain && !cancelled);
+      } finally {
+        scanning = false;
+      }
+    };
+    void scan();
+    const scanOnFocus = () => void scan();
+    window.addEventListener("focus", scanOnFocus);
+    const providerV2 = getFileSystemProviderV25(provider);
+    const subscription = providerV2?.capabilities.watch ? providerV2.watch(
+      (event) => {
+        if (event.type !== "modified") void scan();
+      },
+      { onError: () => void 0 }
+    ) : null;
+    void subscription?.ready.catch(() => void 0);
+    return () => {
+      cancelled = true;
+      window.removeEventListener("focus", scanOnFocus);
+      void subscription?.dispose();
+    };
+  }, [activeWorkspaceId, pinnedDocuments, provider, setPinnedAvailability]);
+  const [transientMoveDestinations, setTransientMoveDestinations] = useState15(
     []
   );
-  useEffect14(() => {
+  useEffect15(() => {
     if (activeWorkspaceDescriptor?.type !== "transient") {
       setTransientMoveDestinations([]);
       return;
@@ -4201,21 +4957,21 @@ function DocBlocksShell({
   }, [activeWorkspaceDescriptor]);
   const gitWorkspaceId = provider && activeWorkspaceDescriptor?.id === activeWorkspaceId && provider.id === activeWorkspaceId && activeWorkspaceDescriptor.type === "electron-native" ? activeWorkspaceDescriptor.id : null;
   const git = useGit(provider, gitWorkspaceId, resolvedTheme);
-  const gitRef = useRef14(git);
+  const gitRef = useRef15(git);
   gitRef.current = git;
   const { scheduleRefresh: gitScheduleRefresh } = git;
-  const [workspaceSettingsOpen, setWorkspaceSettingsOpen] = useState14(false);
-  const [versioningPreference, setVersioningPreference] = useState14(loadVersioningPreference);
-  const handleVersioningPreferenceChange = useCallback14((pref) => {
+  const [workspaceSettingsOpen, setWorkspaceSettingsOpen] = useState15(false);
+  const [versioningPreference, setVersioningPreference] = useState15(loadVersioningPreference);
+  const handleVersioningPreferenceChange = useCallback15((pref) => {
     setVersioningPreference(pref);
     saveVersioningPreference(pref);
   }, []);
   const effectiveVersioning = allowVersioning && resolveVersioningEnabled(activeWorkspaceDescriptor, versioningPreference);
-  const handleOpenWorkspaceSettings = useCallback14(() => {
+  const handleOpenWorkspaceSettings = useCallback15(() => {
     if (!activeWorkspaceDescriptor) return;
     setWorkspaceSettingsOpen(true);
   }, [activeWorkspaceDescriptor]);
-  const handleWorkspaceVersioningOverrideChange = useCallback14(
+  const handleWorkspaceVersioningOverrideChange = useCallback15(
     async (override) => {
       if (!activeWorkspaceDescriptor) return;
       await saveWorkspace2({ ...activeWorkspaceDescriptor, versioningOverride: override });
@@ -4224,7 +4980,7 @@ function DocBlocksShell({
     },
     [activeWorkspaceDescriptor]
   );
-  const [selectedFile, setSelectedFile] = useState14(null);
+  const [selectedFile, setSelectedFile] = useState15(null);
   useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath);
   const exportDestinationAdapter = useMemo3(() => {
     if (!isElectronHost3() || !activeWorkspaceId || !selectedFile) return void 0;
@@ -4236,8 +4992,12 @@ function DocBlocksShell({
       saveBlob: async (blob, filename, target) => host.save(documentId, filename, target?.grantId ?? null, await blob.arrayBuffer())
     };
   }, [activeWorkspaceId, selectedFile]);
-  const [selectedFolder, setSelectedFolder] = useState14(null);
-  const [folderEntries, setFolderEntries] = useState14([]);
+  const [selectedFolder, setSelectedFolder] = useState15(null);
+  const [folderEntries, setFolderEntries] = useState15([]);
+  const visibleFolderEntries = useMemo3(
+    () => filterVisibleFileEntries(folderEntries),
+    [folderEntries]
+  );
   const { session: documentSession, snapshot: documentSnapshot } = useDocumentSession(500);
   const editorContent = documentSnapshot.content;
   const editorSessionScope = useMemo3(
@@ -4247,22 +5007,22 @@ function DocBlocksShell({
     } : null,
     [documentSnapshot.frozen, documentSnapshot.generation, documentSnapshot.targetKey]
   );
-  const [editorPresentationEpoch, setEditorPresentationEpoch] = useState14(0);
+  const [editorPresentationEpoch, setEditorPresentationEpoch] = useState15(0);
   const editorKey = `${documentSnapshot.generation}:${editorPresentationEpoch}`;
   const editorPlaceholder = useMemo3(() => {
     void editorKey;
     return pickEmptyDocumentPrompt();
   }, [editorKey]);
-  const [explorerKey, setExplorerKey] = useState14(0);
-  const [documentLinkEpoch, setDocumentLinkEpoch] = useState14(0);
-  const [initialView, setInitialView] = useState14("wysiwyg");
-  const [initialSharedMode, setInitialSharedMode] = useState14(null);
-  const [showWelcomeGateway, setShowWelcomeGateway] = useState14(false);
-  const navigationRequestRef = useRef14(0);
+  const [explorerKey, setExplorerKey] = useState15(0);
+  const [documentLinkEpoch, setDocumentLinkEpoch] = useState15(0);
+  const [initialView, setInitialView] = useState15("wysiwyg");
+  const [initialSharedMode, setInitialSharedMode] = useState15(null);
+  const [showWelcomeGateway, setShowWelcomeGateway] = useState15(false);
+  const navigationRequestRef = useRef15(0);
   const workspaceAuthorityBarrier = useMemo3(() => new WorkspaceAuthorityBarrier(), []);
-  const preparedCloseRequestRef = useRef14(null);
-  const pendingDbkConflictsRef = useRef14(/* @__PURE__ */ new Map());
-  const createDocumentTarget = useCallback14(
+  const preparedCloseRequestRef = useRef15(null);
+  const pendingDbkConflictsRef = useRef15(/* @__PURE__ */ new Map());
+  const createDocumentTarget = useCallback15(
     (fsProvider, workspaceId, filePath) => {
       const transient = getTransientWorkspace(workspaceId);
       const baseTarget = createFileSystemDocumentTarget(fsProvider, filePath);
@@ -4428,18 +5188,18 @@ function DocBlocksShell({
     },
     [gitScheduleRefresh]
   );
-  const mediaContainerRef = useRef14(null);
-  const [mediaProvider, setMediaProvider] = useState14(null);
-  const [mediaEpoch, setMediaEpoch] = useState14(0);
-  const versionsContainerRef = useRef14(null);
-  const [versionsContainer, setVersionsContainer] = useState14(null);
-  const pushHash = useCallback14((wsId, filePath) => {
+  const mediaContainerRef = useRef15(null);
+  const [mediaProvider, setMediaProvider] = useState15(null);
+  const [mediaEpoch, setMediaEpoch] = useState15(0);
+  const versionsContainerRef = useRef15(null);
+  const [versionsContainer, setVersionsContainer] = useState15(null);
+  const pushHash = useCallback15((wsId, filePath) => {
     const hash = buildHash(wsId, filePath);
     if (window.location.hash !== hash) {
       window.history.pushState(null, "", hash);
     }
   }, []);
-  const openFromIds = useCallback14(
+  const openFromIds = useCallback15(
     async (wsId, filePath, push, view, navigationRequestId, sharedMode = null) => {
       const requestId = navigationRequestId ?? ++navigationRequestRef.current;
       if (requestId !== navigationRequestRef.current) return null;
@@ -4516,7 +5276,7 @@ function DocBlocksShell({
     },
     [createDocumentTarget, documentSession, pushHash]
   );
-  const adoptTransientWorkspace = useCallback14(
+  const adoptTransientWorkspace = useCallback15(
     async (options) => {
       const descriptor = {
         id: options.id,
@@ -4545,7 +5305,7 @@ function DocBlocksShell({
     },
     [openFromIds]
   );
-  const openSharedDocument = useCallback14(
+  const openSharedDocument = useCallback15(
     async (payload, navigationRequestId) => {
       const id = `transient-shared-${navigationRequestId}`;
       const mem = await createMemoryFileSystemProvider(id, "Shared document");
@@ -4573,7 +5333,7 @@ function DocBlocksShell({
     },
     [adoptTransientWorkspace]
   );
-  const seedWelcomeFile = useCallback14(
+  const seedWelcomeFile = useCallback15(
     async (fs, navigationRequestId) => {
       const isCurrent = () => navigationRequestId === void 0 || navigationRequestId === navigationRequestRef.current;
       if (!isCurrent()) return;
@@ -4623,19 +5383,19 @@ function DocBlocksShell({
     },
     [createDocumentTarget, documentSession, pushHash]
   );
-  const startupOpenFromIdsRef = useRef14(openFromIds);
+  const startupOpenFromIdsRef = useRef15(openFromIds);
   startupOpenFromIdsRef.current = openFromIds;
-  const startupOpenSharedDocumentRef = useRef14(openSharedDocument);
+  const startupOpenSharedDocumentRef = useRef15(openSharedDocument);
   startupOpenSharedDocumentRef.current = openSharedDocument;
-  const startupSeedWelcomeFileRef = useRef14(seedWelcomeFile);
+  const startupSeedWelcomeFileRef = useRef15(seedWelcomeFile);
   startupSeedWelcomeFileRef.current = seedWelcomeFile;
-  const closeWelcomeGateway = useCallback14(() => {
+  const closeWelcomeGateway = useCallback15(() => {
     setShowWelcomeGateway((showing) => {
       if (showing) markWelcomeGatewayDismissed();
       return false;
     });
   }, []);
-  const handleStartWriting = useCallback14(() => {
+  const handleStartWriting = useCallback15(() => {
     closeWelcomeGateway();
     setInitialView("wysiwyg");
     setInitialSharedMode(null);
@@ -4644,7 +5404,7 @@ function DocBlocksShell({
       saveLastState({ workspaceId: activeWorkspaceId, filePath: selectedFile, view: "wysiwyg" });
     }
   }, [closeWelcomeGateway, activeWorkspaceId, selectedFile]);
-  useEffect14(() => {
+  useEffect15(() => {
     const requestId = ++navigationRequestRef.current;
     let cancelled = false;
     const isCurrent = () => !cancelled && requestId === navigationRequestRef.current;
@@ -4841,7 +5601,7 @@ function DocBlocksShell({
       if (navigationRequestRef.current === requestId) navigationRequestRef.current += 1;
     };
   }, [pushHash, workspaceAuthorityBarrier]);
-  useEffect14(() => {
+  useEffect15(() => {
     const onPopState = () => {
       const requestedHash = window.location.hash;
       const restoreCurrentHash = () => {
@@ -4883,7 +5643,7 @@ function DocBlocksShell({
     window.addEventListener("popstate", onPopState);
     return () => window.removeEventListener("popstate", onPopState);
   }, [activeWorkspaceId, openFromIds, openSharedDocument, selectedFile, showToast]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!showBrowserStorageWarning || typeof navigator === "undefined") return;
     const storage = navigator.storage;
     if (!storage || typeof storage.persisted !== "function") return;
@@ -4896,7 +5656,7 @@ function DocBlocksShell({
       cancelled = true;
     };
   }, [showBrowserStorageWarning]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (isElectronHost3() || typeof window === "undefined") return;
     const onBeforeInstallPrompt = (e) => {
       e.preventDefault();
@@ -4919,7 +5679,7 @@ function DocBlocksShell({
       window.removeEventListener("appinstalled", onAppInstalled);
     };
   }, []);
-  const handleInstallApp = useCallback14(async () => {
+  const handleInstallApp = useCallback15(async () => {
     const promptEvent = installPromptEvent;
     setInstallPromptEvent(null);
     if (!promptEvent) return;
@@ -4929,7 +5689,7 @@ function DocBlocksShell({
     } catch {
     }
   }, [installPromptEvent]);
-  useEffect14(() => {
+  useEffect15(() => {
     const handler = (e) => {
       const target = e.target.closest?.("[data-view]");
       if (target) {
@@ -4945,7 +5705,7 @@ function DocBlocksShell({
     window.addEventListener("click", handler, true);
     return () => window.removeEventListener("click", handler, true);
   }, [activeWorkspaceId, selectedFile, closeWelcomeGateway]);
-  useEffect14(() => {
+  useEffect15(() => {
     const onKey = (e) => {
       const sKey = e.key === "s" || e.key === "S";
       const accel = e.ctrlKey || e.metaKey;
@@ -4967,30 +5727,30 @@ function DocBlocksShell({
     window.addEventListener("keydown", onKey, true);
     return () => window.removeEventListener("keydown", onKey, true);
   }, [documentSession, showToast]);
-  useEffect14(() => {
+  useEffect15(() => {
     return () => {
       if (saveToastTimerRef.current) clearTimeout(saveToastTimerRef.current);
     };
   }, []);
-  const [offlineReadyToast, setOfflineReadyToast] = useState14(false);
-  const offlineReadyAnnouncedRef = useRef14(false);
-  useEffect14(() => {
+  const [offlineReadyToast, setOfflineReadyToast] = useState15(false);
+  const offlineReadyAnnouncedRef = useRef15(false);
+  useEffect15(() => {
     if (!offlineReady || offlineReadyAnnouncedRef.current) return;
     offlineReadyAnnouncedRef.current = true;
     setOfflineReadyToast(true);
     const timer = setTimeout(() => setOfflineReadyToast(false), 3e3);
     return () => clearTimeout(timer);
   }, [offlineReady]);
-  const [storageFull, setStorageFull] = useState14(false);
-  useEffect14(() => {
+  const [storageFull, setStorageFull] = useState15(false);
+  useEffect15(() => {
     if (documentSnapshot.error && isQuotaExceededError(documentSnapshot.error)) {
       setStorageFull(true);
     } else if (documentSnapshot.status === "saved") {
       setStorageFull(false);
     }
   }, [documentSnapshot.error, documentSnapshot.status]);
-  const autoPersistRequestedRef = useRef14(false);
-  useEffect14(() => {
+  const autoPersistRequestedRef = useRef15(false);
+  useEffect15(() => {
     if (!showBrowserStorageWarning || browserStoragePersistent) return;
     if (autoPersistRequestedRef.current) return;
     if (documentSnapshot.status !== "saved") return;
@@ -5002,7 +5762,7 @@ function DocBlocksShell({
     }).catch(() => {
     });
   }, [showBrowserStorageWarning, browserStoragePersistent, documentSnapshot.status]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!provider || !selectedFile) {
       mediaContainerRef.current = null;
       versionsContainerRef.current = null;
@@ -5026,7 +5786,7 @@ function DocBlocksShell({
     };
   }, [provider, selectedFile, mediaEpoch]);
   const documentLinkProvider = useDocumentLinkProvider(provider, selectedFile, documentLinkEpoch);
-  useEffect14(() => {
+  useEffect15(() => {
     const ref = versioningRef;
     if (!ref) return;
     const assign = (mgr2) => {
@@ -5044,7 +5804,7 @@ function DocBlocksShell({
     assign(mgr);
     return () => assign(null);
   }, [versioningRef, effectiveVersioning, versionBasename, selectedFile, versionsContainer]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!provider) return;
     const providerV2 = getFileSystemProviderV25(provider);
     if (!providerV2?.capabilities.watch) return;
@@ -5104,7 +5864,7 @@ function DocBlocksShell({
       void subscription.dispose();
     };
   }, [provider, selectedFile, documentSession, documentSnapshot.targetKey]);
-  const transitionAwayFromDocument = useCallback14(
+  const transitionAwayFromDocument = useCallback15(
     async (requestId) => {
       if (requestId !== navigationRequestRef.current) return false;
       try {
@@ -5123,7 +5883,7 @@ function DocBlocksShell({
     },
     [documentSession, showToast]
   );
-  const handleUseExternalDocument = useCallback14(async () => {
+  const handleUseExternalDocument = useCallback15(async () => {
     const conflictKey = documentSession.getSnapshot().conflict?.targetKey;
     const pendingDbk = conflictKey ? pendingDbkConflictsRef.current.get(conflictKey) : void 0;
     try {
@@ -5146,7 +5906,7 @@ function DocBlocksShell({
       });
     }
   }, [activeWorkspaceId, documentSession, pushHash]);
-  const handleKeepLocalDocument = useCallback14(async () => {
+  const handleKeepLocalDocument = useCallback15(async () => {
     const conflictKey = documentSession.getSnapshot().conflict?.targetKey;
     try {
       await documentSession.resolveConflict("use-local");
@@ -5159,7 +5919,7 @@ function DocBlocksShell({
       });
     }
   }, [documentSession]);
-  useEffect14(() => {
+  useEffect15(() => {
     const needsWarning = ["dirty", "saving", "error", "conflict"].includes(documentSnapshot.status);
     if (!documentSnapshot.targetKey) return;
     const flushBestEffort = () => {
@@ -5185,7 +5945,7 @@ function DocBlocksShell({
       document.removeEventListener("visibilitychange", onVisibilityChange);
     };
   }, [documentSession, documentSnapshot.status, documentSnapshot.targetKey]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!isElectronHost3()) return;
     const lifecycle = getDocBlocksHost().lifecycle;
     const stopPrepare = lifecycle.onPrepareClose(async (request) => {
@@ -5212,7 +5972,7 @@ function DocBlocksShell({
       stopCancel();
     };
   }, [documentSession]);
-  const handleWorkspaceSelect = useCallback14(
+  const handleWorkspaceSelect = useCallback15(
     async (ws) => {
       const requestId = ++navigationRequestRef.current;
       await touchWorkspace2(ws.id);
@@ -5244,7 +6004,184 @@ function DocBlocksShell({
     },
     [pushHash, transitionAwayFromDocument]
   );
-  const handleMoveTransientWorkspace = useCallback14(
+  const unpinDocument = useCallback15((document2) => {
+    const key = pinnedDocumentKey(document2);
+    setPinnedDocuments((current) => removePinnedDocument(current, document2));
+    setPinnedDocumentAvailability((current) => {
+      if (!current.has(key)) return current;
+      const next = new Map(current);
+      next.delete(key);
+      return next;
+    });
+  }, []);
+  const confirmMissingPinnedDocument = useCallback15(
+    async (document2) => {
+      setPinnedAvailability(document2, "missing");
+      const shouldUnpin = await confirmAction({
+        title: "File not found",
+        message: missingPinnedDocumentMessage(document2),
+        confirmLabel: "OK",
+        cancelLabel: "Cancel"
+      });
+      if (shouldUnpin) unpinDocument(document2);
+    },
+    [confirmAction, setPinnedAvailability, unpinDocument]
+  );
+  const handleTogglePin = useCallback15(
+    (path) => {
+      if (!activeWorkspaceId || !provider) return;
+      const canonicalPath = parseWorkspacePath5(path);
+      if (!canonicalPath) return;
+      const document2 = {
+        workspaceId: activeWorkspaceId,
+        workspaceName: activeWorkspaceDescriptor?.name ?? provider.label,
+        path: canonicalPath
+      };
+      const alreadyPinned = pinnedDocuments.some(
+        (candidate) => pinnedDocumentKey(candidate) === pinnedDocumentKey(document2)
+      );
+      setPinnedDocuments((current) => togglePinnedDocument(current, document2));
+      if (alreadyPinned) {
+        setPinnedDocumentAvailability((current) => {
+          const key = pinnedDocumentKey(document2);
+          if (!current.has(key)) return current;
+          const next = new Map(current);
+          next.delete(key);
+          return next;
+        });
+      } else {
+        setPinnedAvailability(document2, "available");
+      }
+    },
+    [
+      activeWorkspaceDescriptor?.name,
+      activeWorkspaceId,
+      pinnedDocuments,
+      provider,
+      setPinnedAvailability
+    ]
+  );
+  const activeWorkspacePinnedPaths = useMemo3(
+    () => pinnedDocuments.filter((document2) => document2.workspaceId === activeWorkspaceId).map((document2) => document2.path),
+    [activeWorkspaceId, pinnedDocuments]
+  );
+  const handlePinnedDocumentSelect = useCallback15(
+    async (document2) => {
+      const requestId = ++navigationRequestRef.current;
+      const workspace = await getWorkspace(document2.workspaceId);
+      if (requestId !== navigationRequestRef.current) return;
+      if (!workspace) {
+        await confirmMissingPinnedDocument(document2);
+        return;
+      }
+      let nextProvider = activeWorkspaceId === workspace.id ? provider : null;
+      let ownsNextProvider = false;
+      let adoptedNextProvider = nextProvider !== null;
+      try {
+        if (!nextProvider) {
+          const transient = getTransientWorkspace(workspace.id);
+          if (transient) {
+            nextProvider = transient.provider;
+          } else if (workspace.type === "electron-native") {
+            nextProvider = isElectronHost3() ? await createElectronProviderFromWorkspace(workspace) : null;
+            ownsNextProvider = nextProvider !== null;
+          } else if (workspace.type === "native") {
+            nextProvider = await (await loadNativeFileSystem()).restoreNativeFolder(workspace.id);
+            ownsNextProvider = nextProvider !== null;
+          } else {
+            nextProvider = await createIndexedDbFileSystemProvider(workspace.id, workspace.name);
+            ownsNextProvider = true;
+          }
+        }
+        if (requestId !== navigationRequestRef.current) return;
+        if (!nextProvider) {
+          setPinnedAvailability(document2, "unknown");
+          showToast(
+            "error",
+            `DocBlocks could not open \u201C${workspace.name}\u201D. Open that workspace and grant access, then try again.`
+          );
+          return;
+        }
+        const openedProvider = nextProvider;
+        let exists;
+        try {
+          exists = await providerEntryExists(openedProvider, document2.path);
+        } catch (error) {
+          setPinnedAvailability(document2, "unknown");
+          showToast(
+            "error",
+            error instanceof Error ? error.message : "Could not check the pinned document."
+          );
+          return;
+        }
+        if (requestId !== navigationRequestRef.current) return;
+        if (!exists) {
+          await confirmMissingPinnedDocument(document2);
+          return;
+        }
+        let disappearedDuringRead = false;
+        const transitioned = await documentSession.transitionWithLoad(async () => {
+          if (requestId !== navigationRequestRef.current) return null;
+          const content = await readProviderText(openedProvider, document2.path);
+          if (content === null) {
+            disappearedDuringRead = true;
+            return null;
+          }
+          if (requestId !== navigationRequestRef.current) return null;
+          return {
+            target: createDocumentTarget(openedProvider, workspace.id, document2.path),
+            content
+          };
+        });
+        if (!transitioned) {
+          if (disappearedDuringRead) await confirmMissingPinnedDocument(document2);
+          return;
+        }
+        if (requestId !== navigationRequestRef.current) return;
+        adoptedNextProvider = true;
+        setProvider(openedProvider);
+        setActiveWorkspaceId(workspace.id);
+        setActiveWorkspaceDescriptor(workspace);
+        setSelectedFile(document2.path);
+        setSelectedFolder(null);
+        setFolderEntries([]);
+        setInitialView("wysiwyg");
+        setInitialSharedMode(null);
+        setExplorerKey((key) => key + 1);
+        setPinnedAvailability(document2, "available");
+        closeWelcomeGateway();
+        pushHash(workspace.id, document2.path);
+        saveLastState({ workspaceId: workspace.id, filePath: document2.path, view: "wysiwyg" });
+        if (effectiveCompact) setMobileShowEditor(true);
+        void touchWorkspace2(workspace.id).catch(() => void 0);
+      } catch (error) {
+        showToast(
+          "error",
+          error instanceof Error ? error.message : "Could not open the pinned document."
+        );
+      } finally {
+        if (nextProvider && ownsNextProvider && !adoptedNextProvider) {
+          try {
+            await getFileSystemProviderV25(nextProvider)?.dispose();
+          } catch {
+          }
+        }
+      }
+    },
+    [
+      activeWorkspaceId,
+      closeWelcomeGateway,
+      confirmMissingPinnedDocument,
+      createDocumentTarget,
+      documentSession,
+      effectiveCompact,
+      provider,
+      pushHash,
+      setPinnedAvailability,
+      showToast
+    ]
+  );
+  const handleMoveTransientWorkspace = useCallback15(
     async (destinationWorkspaceId) => {
       if (!activeWorkspaceId || !provider || !selectedFile) {
         throw new Error("Select the temporary document before moving it.");
@@ -5300,6 +6237,12 @@ function DocBlocksShell({
         setActiveWorkspaceId(destination.id);
         setActiveWorkspaceDescriptor(destination);
         setSelectedFile(selectedFile);
+        setPinnedDocuments(
+          (current) => movePinnedDocumentsToWorkspace(current, activeWorkspaceId, {
+            workspaceId: destination.id,
+            workspaceName: destination.name
+          })
+        );
         setSelectedFolder(null);
         setFolderEntries([]);
         setInitialView("wysiwyg");
@@ -5350,7 +6293,7 @@ function DocBlocksShell({
       transientMoveDestinations
     ]
   );
-  const handleOpenFolder = useCallback14(async () => {
+  const handleOpenFolder = useCallback15(async () => {
     const requestId = ++navigationRequestRef.current;
     try {
       if (isElectronHost3()) {
@@ -5396,7 +6339,7 @@ function DocBlocksShell({
     } catch {
     }
   }, [pushHash, transitionAwayFromDocument]);
-  const handleWorkspaceCloned = useCallback14(
+  const handleWorkspaceCloned = useCallback15(
     (info) => {
       const requestId = ++navigationRequestRef.current;
       void (async () => {
@@ -5425,7 +6368,7 @@ function DocBlocksShell({
     },
     [pushHash, transitionAwayFromDocument]
   );
-  const handleNewFile = useCallback14(async () => {
+  const handleNewFile = useCallback15(async () => {
     if (!provider) return;
     const name = await promptForText({
       title: "New document",
@@ -5491,7 +6434,7 @@ function DocBlocksShell({
     promptForText,
     showToast
   ]);
-  const handleNewFolder = useCallback14(async () => {
+  const handleNewFolder = useCallback15(async () => {
     if (!provider) return;
     const name = await promptForText({
       title: "New folder",
@@ -5537,8 +6480,8 @@ function DocBlocksShell({
     pushHash,
     effectiveCompact
   ]);
-  const actionNewHandledRef = useRef14(false);
-  useEffect14(() => {
+  const actionNewHandledRef = useRef15(false);
+  useEffect15(() => {
     if (!provider || actionNewHandledRef.current) return;
     if (typeof window === "undefined") return;
     const params = new URLSearchParams(window.location.search);
@@ -5553,14 +6496,14 @@ function DocBlocksShell({
     );
     void handleNewFile();
   }, [provider, handleNewFile]);
-  const handleRevealWorkspace = useCallback14(async () => {
+  const handleRevealWorkspace = useCallback15(async () => {
     if (!isElectronHost3() || !activeWorkspaceId) return;
     const ws = await getWorkspace(activeWorkspaceId);
     if (ws?.type === "electron-native" && ws.rootPath) {
       await getDocBlocksHost().shell.revealInFolder(ws.id);
     }
   }, [activeWorkspaceId]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onMenuCommand((cmd) => {
@@ -5624,7 +6567,7 @@ function DocBlocksShell({
       }
     });
   }, [handleNewFile, handleOpenFolder, handleRevealWorkspace, acknowledge]);
-  const handleSelect = useCallback14(
+  const handleSelect = useCallback15(
     async (path, kind) => {
       if (!provider || !activeWorkspaceId) return;
       const requestId = ++navigationRequestRef.current;
@@ -5681,7 +6624,7 @@ function DocBlocksShell({
       showToast
     ]
   );
-  const handleEditorLinkClick = useCallback14(
+  const handleEditorLinkClick = useCallback15(
     (href) => {
       const target = resolveShellEditorLinkTarget(href, selectedFile);
       if (!target) {
@@ -5731,7 +6674,7 @@ function DocBlocksShell({
     },
     [handleSelect, provider, selectedFile, showToast]
   );
-  const handleTreeMutation = useCallback14(
+  const handleTreeMutation = useCallback15(
     async (change, mutate) => {
       if (!provider || !activeWorkspaceId || !selectedFile) {
         await mutate();
@@ -5755,11 +6698,16 @@ function DocBlocksShell({
     },
     [provider, activeWorkspaceId, selectedFile, documentSession, createDocumentTarget]
   );
-  const handleTreeChange = useCallback14(
+  const handleTreeChange = useCallback15(
     async (change) => {
       if (!provider) return;
       setDocumentLinkEpoch((epoch) => epoch + 1);
       if (change?.type === "move" && change.oldPath && change.newPath) {
+        if (activeWorkspaceId) {
+          setPinnedDocuments(
+            (current) => relocatePinnedDocuments(current, activeWorkspaceId, change.oldPath, change.newPath)
+          );
+        }
         const nextFile = selectedFile ? relocateProviderPath(selectedFile, change.oldPath, change.newPath) : null;
         const nextFolder = selectedFolder ? relocateProviderPath(selectedFolder, change.oldPath, change.newPath) : null;
         if (nextFile !== selectedFile) {
@@ -5779,6 +6727,13 @@ function DocBlocksShell({
         if (nextFolder) setFolderEntries(await readProviderDirectory2(provider, nextFolder));
         return;
       }
+      if (change?.type === "delete" && activeWorkspaceId) {
+        for (const document2 of pinnedDocuments) {
+          if (document2.workspaceId === activeWorkspaceId && pathContains(change.path, document2.path)) {
+            setPinnedAvailability(document2, "missing");
+          }
+        }
+      }
       if (selectedFile) {
         const exists = await providerEntryExists(provider, selectedFile);
         if (!exists) {
@@ -5791,9 +6746,210 @@ function DocBlocksShell({
         setFolderEntries(entries);
       }
     },
-    [provider, selectedFile, selectedFolder, activeWorkspaceId, pushHash]
+    [
+      provider,
+      selectedFile,
+      selectedFolder,
+      activeWorkspaceId,
+      pinnedDocuments,
+      pushHash,
+      setPinnedAvailability
+    ]
+  );
+  const acquirePinnedDocumentProvider = useCallback15(
+    async (document2) => {
+      const workspace = await getWorkspace(document2.workspaceId);
+      if (!workspace) return { kind: "missing-workspace" };
+      if (activeWorkspaceId === workspace.id && provider) {
+        return { kind: "ready", workspace, provider, owned: false };
+      }
+      const transient = getTransientWorkspace(workspace.id);
+      if (transient) {
+        return { kind: "ready", workspace, provider: transient.provider, owned: false };
+      }
+      let pinnedProvider = null;
+      if (workspace.type === "electron-native") {
+        pinnedProvider = isElectronHost3() ? await createElectronProviderFromWorkspace(workspace) : null;
+      } else if (workspace.type === "native") {
+        pinnedProvider = await (await loadNativeFileSystem()).restoreNativeFolder(workspace.id);
+      } else {
+        pinnedProvider = await createIndexedDbFileSystemProvider(workspace.id, workspace.name);
+      }
+      if (!pinnedProvider) return { kind: "unavailable", workspace };
+      return { kind: "ready", workspace, provider: pinnedProvider, owned: true };
+    },
+    [activeWorkspaceId, provider]
+  );
+  const markRelocatedPinnedDocument = useCallback15((document2, newPath) => {
+    const relocated = {
+      workspaceId: document2.workspaceId,
+      workspaceName: document2.workspaceName,
+      path: newPath
+    };
+    setPinnedDocuments(
+      (current) => relocatePinnedDocuments(current, document2.workspaceId, document2.path, newPath)
+    );
+    setPinnedDocumentAvailability((current) => {
+      const oldKey = pinnedDocumentKey(document2);
+      const nextKey = pinnedDocumentKey(relocated);
+      const next = new Map(current);
+      next.delete(oldKey);
+      next.set(nextKey, "available");
+      return next;
+    });
+  }, []);
+  const handlePinnedDocumentRename = useCallback15(
+    async (document2) => {
+      if (document2.availability === "missing") {
+        await confirmMissingPinnedDocument(document2);
+        return;
+      }
+      const oldName = basenameOf(document2.path);
+      const response = await promptForText({
+        title: "Rename document",
+        label: "Document name",
+        initialValue: oldName,
+        confirmLabel: "Rename"
+      });
+      if (response === null) return;
+      const newName = response.trim();
+      if (!newName || /[\\/]/.test(newName)) {
+        showToast("error", "Use a document name without slashes.");
+        return;
+      }
+      const parent = dirnameOf(document2.path);
+      let newPath;
+      try {
+        newPath = parseWorkspacePath5(parent ? `${parent}/${newName}` : newName);
+      } catch {
+        showToast("error", "Use a valid document name.");
+        return;
+      }
+      if (newPath === document2.path) return;
+      const access = await acquirePinnedDocumentProvider(document2);
+      if (access.kind === "missing-workspace") {
+        await confirmMissingPinnedDocument(document2);
+        return;
+      }
+      if (access.kind === "unavailable") {
+        setPinnedAvailability(document2, "unknown");
+        showToast(
+          "error",
+          `DocBlocks could not open "${access.workspace.name}". Open that workspace and grant access, then try again.`
+        );
+        return;
+      }
+      try {
+        if (!await pinnedProviderFileExists(access.provider, document2.path)) {
+          await confirmMissingPinnedDocument(document2);
+          return;
+        }
+        const change = {
+          type: "move",
+          oldPath: document2.path,
+          newPath,
+          kind: "file"
+        };
+        const mutate = () => moveFileSystemEntry2(access.provider, document2.path, newPath, "file");
+        if (access.provider === provider && access.workspace.id === activeWorkspaceId) {
+          await handleTreeMutation(change, mutate);
+          await handleTreeChange(change);
+          setExplorerKey((key) => key + 1);
+        } else {
+          await mutate();
+        }
+        markRelocatedPinnedDocument(document2, newPath);
+      } finally {
+        if (access.owned) {
+          try {
+            await getFileSystemProviderV25(access.provider)?.dispose();
+          } catch {
+          }
+        }
+      }
+    },
+    [
+      acquirePinnedDocumentProvider,
+      activeWorkspaceId,
+      confirmMissingPinnedDocument,
+      handleTreeChange,
+      handleTreeMutation,
+      markRelocatedPinnedDocument,
+      promptForText,
+      provider,
+      setPinnedAvailability,
+      showToast
+    ]
+  );
+  const handlePinnedDocumentDelete = useCallback15(
+    async (document2) => {
+      if (document2.availability === "missing") {
+        await confirmMissingPinnedDocument(document2);
+        return;
+      }
+      const access = await acquirePinnedDocumentProvider(document2);
+      if (access.kind === "missing-workspace") {
+        await confirmMissingPinnedDocument(document2);
+        return;
+      }
+      if (access.kind === "unavailable") {
+        setPinnedAvailability(document2, "unknown");
+        showToast(
+          "error",
+          `DocBlocks could not open "${access.workspace.name}". Open that workspace and grant access, then try again.`
+        );
+        return;
+      }
+      try {
+        if (!await pinnedProviderFileExists(access.provider, document2.path)) {
+          await confirmMissingPinnedDocument(document2);
+          return;
+        }
+        if (!await confirmDeleteEntry(
+          `Delete the document "${basenameOf(document2.path)}"? This cannot be undone.`
+        )) {
+          return;
+        }
+        const change = {
+          type: "delete",
+          path: document2.path,
+          kind: "file"
+        };
+        const mutate = async () => {
+          if (!await removePinnedProviderFile(access.provider, document2.path)) {
+            throw new Error("The document disappeared before it could be deleted.");
+          }
+        };
+        if (access.provider === provider && access.workspace.id === activeWorkspaceId) {
+          await handleTreeMutation(change, mutate);
+          await handleTreeChange(change);
+          setExplorerKey((key) => key + 1);
+        } else {
+          await mutate();
+        }
+        setPinnedAvailability(document2, "missing");
+      } finally {
+        if (access.owned) {
+          try {
+            await getFileSystemProviderV25(access.provider)?.dispose();
+          } catch {
+          }
+        }
+      }
+    },
+    [
+      acquirePinnedDocumentProvider,
+      activeWorkspaceId,
+      confirmDeleteEntry,
+      confirmMissingPinnedDocument,
+      handleTreeChange,
+      handleTreeMutation,
+      provider,
+      setPinnedAvailability,
+      showToast
+    ]
   );
-  const persistImportedMedia = useCallback14(
+  const persistImportedMedia = useCallback15(
     async (source, target, importedMarkdownPath) => {
       const parentDir = dirnameOf(importedMarkdownPath);
       const folder = basenameOf(importedMarkdownPath).replace(/\.[^.]+$/, "") + "_files";
@@ -5818,7 +6974,7 @@ function DocBlocksShell({
     },
     []
   );
-  const handleImportFiles = useCallback14(
+  const handleImportFiles = useCallback15(
     async (files) => {
       if (!provider) return;
       const result = await importDroppedFiles(files, provider, {
@@ -5830,7 +6986,7 @@ function DocBlocksShell({
     },
     [provider, persistImportedMedia, showToast]
   );
-  const handleEditorChange = useCallback14(
+  const handleEditorChange = useCallback15(
     (source) => {
       if (!editorSessionScope) return;
       try {
@@ -5840,7 +6996,7 @@ function DocBlocksShell({
     },
     [documentSession, editorSessionScope]
   );
-  const handleRenameWorkspace = useCallback14(async () => {
+  const handleRenameWorkspace = useCallback15(async () => {
     if (!activeWorkspaceId) return;
     const ws = await getWorkspace(activeWorkspaceId);
     if (!ws) return;
@@ -5852,9 +7008,12 @@ function DocBlocksShell({
     });
     if (!newName || newName === ws.name) return;
     await saveWorkspace2({ ...ws, name: newName });
+    setPinnedDocuments(
+      (current) => renamePinnedDocumentWorkspace(current, activeWorkspaceId, newName)
+    );
     setDescriptorRefreshKey((key) => key + 1);
   }, [activeWorkspaceId, promptForText]);
-  const openTransient = useCallback14(
+  const openTransient = useCallback15(
     async (req, navigationRequestId) => {
       const isCurrent = () => navigationRequestId === navigationRequestRef.current;
       const host = getDocBlocksHost();
@@ -5929,7 +7088,7 @@ function DocBlocksShell({
     },
     [adoptTransientWorkspace]
   );
-  useEffect14(() => {
+  useEffect15(() => {
     if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onOpenRequest((req) => {
@@ -5953,7 +7112,7 @@ function DocBlocksShell({
       });
     });
   }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast]);
-  const openTransientFromHandle = useCallback14(
+  const openTransientFromHandle = useCallback15(
     async (handle) => {
       const name = handle.name;
       const isBundle = /\.(dbk|zip)$/i.test(name);
@@ -5995,7 +7154,7 @@ function DocBlocksShell({
     },
     [adoptTransientWorkspace]
   );
-  useEffect14(() => {
+  useEffect15(() => {
     if (isElectronHost3() || typeof window === "undefined") return;
     const launchQueue = window.launchQueue;
     if (!launchQueue) return;
@@ -6011,7 +7170,7 @@ function DocBlocksShell({
     });
   }, [openTransientFromHandle, showToast]);
   const updateStatusBarVisible = viewPreferences.showStatusBar === true && selectedFile !== null && mediaProvider !== null;
-  const handleDownloadWorkspace = useCallback14(async () => {
+  const handleDownloadWorkspace = useCallback15(async () => {
     if (!provider) return;
     try {
       await documentSession.flush("backup");
@@ -6034,7 +7193,7 @@ function DocBlocksShell({
       showToast("error", "Failed to download workspace. See console for details.");
     }
   }, [provider, documentSession, showToast]);
-  const handleDownloadAllWorkspaces = useCallback14(async () => {
+  const handleDownloadAllWorkspaces = useCallback15(async () => {
     try {
       await documentSession.flush("backup");
       const [{ MemoryContentContainer }, { containerToZip }] = await Promise.all([
@@ -6113,7 +7272,7 @@ function DocBlocksShell({
       showToast("error", "Failed to download all workspaces. See console for details.");
     }
   }, [documentSession, acknowledge, showToast]);
-  const handleKeepBrowserData = useCallback14(async () => {
+  const handleKeepBrowserData = useCallback15(async () => {
     if (typeof navigator === "undefined") return;
     const storage = navigator.storage;
     if (!storage || typeof storage.persist !== "function") {
@@ -6150,7 +7309,7 @@ function DocBlocksShell({
       });
     }
   }, [acknowledge, showToast]);
-  const getBrowserStorageEstimate = useCallback14(async () => {
+  const getBrowserStorageEstimate = useCallback15(async () => {
     if (typeof navigator === "undefined") return null;
     const storage = navigator.storage;
     if (!storage || typeof storage.estimate !== "function") return null;
@@ -6162,7 +7321,7 @@ function DocBlocksShell({
       return null;
     }
   }, []);
-  const handleRemoveWorkspace = useCallback14(async () => {
+  const handleRemoveWorkspace = useCallback15(async () => {
     if (!activeWorkspaceId) return;
     const ws = await getWorkspace(activeWorkspaceId);
     const destroysDocuments = ws?.type === "indexeddb";
@@ -6195,6 +7354,11 @@ function DocBlocksShell({
       await (await loadIndexedDbFileSystem()).deleteIndexedDBWorkspaceData(activeWorkspaceId);
     }
     await removeWorkspace(activeWorkspaceId);
+    for (const document2 of pinnedDocuments) {
+      if (document2.workspaceId === activeWorkspaceId) {
+        setPinnedAvailability(document2, "missing");
+      }
+    }
     if (requestId !== navigationRequestRef.current) return;
     const electron = isElectronHost3();
     const remaining = (await listWorkspaces2()).filter(
@@ -6228,19 +7392,26 @@ function DocBlocksShell({
       setSelectedFolder(null);
       setFolderEntries([]);
     }
-  }, [activeWorkspaceId, handleWorkspaceSelect, transitionAwayFromDocument, confirmAction]);
-  return /* @__PURE__ */ jsx12(
+  }, [
+    activeWorkspaceId,
+    confirmAction,
+    handleWorkspaceSelect,
+    pinnedDocuments,
+    setPinnedAvailability,
+    transitionAwayFromDocument
+  ]);
+  return /* @__PURE__ */ jsx13(
     "div",
     {
       className: `db-shell${effectiveCompact ? " db-shell--mobile" : ""}`,
       "data-theme": resolvedTheme,
       "data-accent": accentColor,
       "data-document-status": documentSnapshot.status,
-      children: /* @__PURE__ */ jsxs11(GitContext.Provider, { value: git, children: [
+      children: /* @__PURE__ */ jsxs12(GitContext.Provider, { value: git, children: [
         promptDialog,
         confirmDialog,
-        workspaceStartupError && /* @__PURE__ */ jsx12("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
-        saveToast && /* @__PURE__ */ jsx12(
+        workspaceStartupError && /* @__PURE__ */ jsx13("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
+        saveToast && /* @__PURE__ */ jsx13(
           "div",
           {
             className: "db-save-toast db-save-toast--" + saveToast.kind,
@@ -6249,22 +7420,22 @@ function DocBlocksShell({
             children: saveToast.message
           }
         ),
-        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx12("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
-        documentSnapshot.conflict && /* @__PURE__ */ jsxs11("div", { className: "db-document-conflict", role: "alert", children: [
-          /* @__PURE__ */ jsx12("span", { children: "This document changed outside DocBlocks. Your unsaved version is still intact." }),
-          /* @__PURE__ */ jsxs11("div", { className: "db-document-conflict-actions", children: [
-            /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void handleKeepLocalDocument(), children: "Keep mine" }),
-            /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void handleUseExternalDocument(), children: "Reload external" })
+        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx13("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
+        documentSnapshot.conflict && /* @__PURE__ */ jsxs12("div", { className: "db-document-conflict", role: "alert", children: [
+          /* @__PURE__ */ jsx13("span", { children: "This document changed outside DocBlocks. Your unsaved version is still intact." }),
+          /* @__PURE__ */ jsxs12("div", { className: "db-document-conflict-actions", children: [
+            /* @__PURE__ */ jsx13("button", { type: "button", onClick: () => void handleKeepLocalDocument(), children: "Keep mine" }),
+            /* @__PURE__ */ jsx13("button", { type: "button", onClick: () => void handleUseExternalDocument(), children: "Reload external" })
           ] })
         ] }),
-        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs11("div", { className: "db-storage-full-banner", role: "alert", children: [
-          /* @__PURE__ */ jsx12("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
-          /* @__PURE__ */ jsxs11("div", { className: "db-storage-full-banner-actions", children: [
-            /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Download all workspaces" }),
-            /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
+        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs12("div", { className: "db-storage-full-banner", role: "alert", children: [
+          /* @__PURE__ */ jsx13("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
+          /* @__PURE__ */ jsxs12("div", { className: "db-storage-full-banner-actions", children: [
+            /* @__PURE__ */ jsx13("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Download all workspaces" }),
+            /* @__PURE__ */ jsx13("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
           ] })
         ] }),
-        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx12(
+        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx13(
           WorkspaceSettingsDialog,
           {
             workspace: activeWorkspaceDescriptor,
@@ -6273,8 +7444,8 @@ function DocBlocksShell({
             onClose: () => setWorkspaceSettingsOpen(false)
           }
         ),
-        /* @__PURE__ */ jsxs11("div", { style: { display: "flex", flex: 1, overflow: "hidden" }, children: [
-          (!effectiveCompact || !mobileShowEditor) && /* @__PURE__ */ jsxs11(
+        /* @__PURE__ */ jsxs12("div", { style: { display: "flex", flex: 1, overflow: "hidden" }, children: [
+          (!effectiveCompact || !mobileShowEditor) && /* @__PURE__ */ jsxs12(
             "aside",
             {
               ref: sidebarRef,
@@ -6282,8 +7453,8 @@ function DocBlocksShell({
               "aria-label": "Workspace and files",
               style: effectiveCompact ? void 0 : { width: `${sidebarWidth}px` },
               children: [
-                /* @__PURE__ */ jsxs11("div", { className: "db-shell-sidebar-header", children: [
-                  /* @__PURE__ */ jsx12(
+                /* @__PURE__ */ jsxs12("div", { className: "db-shell-sidebar-header", children: [
+                  /* @__PURE__ */ jsx13(
                     AppMenu,
                     {
                       logoUrl,
@@ -6304,7 +7475,7 @@ function DocBlocksShell({
                       appBuildDate
                     }
                   ),
-                  /* @__PURE__ */ jsx12(
+                  /* @__PURE__ */ jsx13(
                     WorkspacePicker,
                     {
                       activeWorkspaceId,
@@ -6314,7 +7485,7 @@ function DocBlocksShell({
                       onCloneRepository: git.available ? () => git.openDialog({ kind: "clone" }) : void 0
                     }
                   ),
-                  /* @__PURE__ */ jsx12(
+                  /* @__PURE__ */ jsx13(
                     WorkspaceSettingsButton,
                     {
                       onSettings: handleOpenWorkspaceSettings,
@@ -6323,37 +7494,38 @@ function DocBlocksShell({
                       onRemove: handleRemoveWorkspace
                     }
                   ),
-                  compactLayout && !isMobile && /* @__PURE__ */ jsx12(
+                  compactLayout && !isMobile && /* @__PURE__ */ jsx13(
                     "button",
                     {
                       className: "db-restore-split",
                       onClick: () => setCompactLayout(false),
                       "aria-label": "Restore split view",
                       title: "Restore split view",
-                      children: /* @__PURE__ */ jsx12(SplitViewIcon, {})
+                      children: /* @__PURE__ */ jsx13(SplitViewIcon, {})
                     }
                   ),
-                  /* @__PURE__ */ jsx12(
-                    "span",
-                    {
-                      className: "db-window-drag-grip",
-                      "data-tooltip": "Click and drag here to move your window around.",
-                      "aria-hidden": true
-                    }
-                  )
+                  /* @__PURE__ */ jsx13("span", { className: "db-window-drag-grip", "aria-hidden": true })
                 ] }),
-                git.available && /* @__PURE__ */ jsx12(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx12(
+                git.available && /* @__PURE__ */ jsx13(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx13(
                   GitUI,
                   {
                     onOpenFile: (path) => void handleSelect(path, "file"),
                     onWorkspaceCloned: handleWorkspaceCloned
                   }
                 ) }),
-                /* @__PURE__ */ jsx12(
+                /* @__PURE__ */ jsx13(
                   FileExplorer,
                   {
                     provider,
+                    activeWorkspaceId,
                     activeFilePath: selectedFile,
+                    pinnedDocuments: pinnedDocumentItems,
+                    pinnedPaths: activeWorkspacePinnedPaths,
+                    onPinnedDocumentSelect: (document2) => void handlePinnedDocumentSelect(document2),
+                    onPinnedDocumentUnpin: unpinDocument,
+                    onPinnedDocumentRename: handlePinnedDocumentRename,
+                    onPinnedDocumentDelete: handlePinnedDocumentDelete,
+                    onTogglePin: handleTogglePin,
                     onSelect: handleSelect,
                     onTreeMutation: handleTreeMutation,
                     onTreeChange: handleTreeChange,
@@ -6364,17 +7536,17 @@ function DocBlocksShell({
                   },
                   explorerKey
                 ),
-                isMobile && showWelcomeGateway && /* @__PURE__ */ jsxs11(
+                isMobile && showWelcomeGateway && /* @__PURE__ */ jsxs12(
                   "section",
                   {
                     className: "db-mobile-first-run",
                     "aria-labelledby": "db-mobile-first-run-title",
                     children: [
-                      /* @__PURE__ */ jsx12("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
-                      /* @__PURE__ */ jsx12("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
-                      /* @__PURE__ */ jsx12("p", { children: "Write visually, keep plain Markdown underneath, and export the same document in useful formats. Your browser workspace stays on this device." }),
-                      /* @__PURE__ */ jsxs11("div", { className: "db-mobile-first-run-actions", children: [
-                        /* @__PURE__ */ jsx12(
+                      /* @__PURE__ */ jsx13("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
+                      /* @__PURE__ */ jsx13("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
+                      /* @__PURE__ */ jsx13("p", { children: "Write visually, keep plain Markdown underneath, and export the same document in useful formats. Your browser workspace stays on this device." }),
+                      /* @__PURE__ */ jsxs12("div", { className: "db-mobile-first-run-actions", children: [
+                        /* @__PURE__ */ jsx13(
                           "button",
                           {
                             type: "button",
@@ -6385,7 +7557,7 @@ function DocBlocksShell({
                             children: "Tour the welcome document"
                           }
                         ),
-                        /* @__PURE__ */ jsx12(
+                        /* @__PURE__ */ jsx13(
                           "button",
                           {
                             type: "button",
@@ -6398,22 +7570,22 @@ function DocBlocksShell({
                     ]
                   }
                 ),
-                /* @__PURE__ */ jsxs11("div", { className: "db-shell-sidebar-footer", children: [
-                  /* @__PURE__ */ jsx12("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
-                  /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx12("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
-                  /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx12("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
-                  showBrowserStorageWarning && /* @__PURE__ */ jsxs11(Fragment7, { children: [
-                    /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                    /* @__PURE__ */ jsx12(
+                /* @__PURE__ */ jsxs12("div", { className: "db-shell-sidebar-footer", children: [
+                  /* @__PURE__ */ jsx13("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
+                  /* @__PURE__ */ jsx13("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx13("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
+                  /* @__PURE__ */ jsx13("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx13("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
+                  showBrowserStorageWarning && /* @__PURE__ */ jsxs12(Fragment7, { children: [
+                    /* @__PURE__ */ jsx13("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                    /* @__PURE__ */ jsx13(
                       "button",
                       {
                         type: "button",
                         className: "db-shell-sidebar-footer-action",
                         onClick: () => void handleDownloadAllWorkspaces(),
-                        title: "Browser docs can get auto-removed. Download all workspaces.",
-                        children: "Backup browser docs frequently"
+                        title: "Browser documents can be removed automatically. Download all workspaces now.",
+                        children: "Back up browser docs"
                       }
                     )
                   ] })
@@ -6421,7 +7593,7 @@ function DocBlocksShell({
               ]
             }
           ),
-          !effectiveCompact && /* @__PURE__ */ jsx12(
+          !effectiveCompact && /* @__PURE__ */ jsx13(
             "div",
             {
               className: "db-shell-sidebar-resizer",
@@ -6431,7 +7603,7 @@ function DocBlocksShell({
               onPointerDown: handleResizerPointerDown
             }
           ),
-          (!effectiveCompact || mobileShowEditor) && /* @__PURE__ */ jsxs11(
+          (!effectiveCompact || mobileShowEditor) && /* @__PURE__ */ jsxs12(
             "main",
             {
               "aria-label": "Document editor",
@@ -6444,22 +7616,23 @@ function DocBlocksShell({
                 position: "relative"
               },
               children: [
-                selectedFile && mediaProvider ? /* @__PURE__ */ jsxs11(MediaContext.Provider, { value: mediaProvider, children: [
-                  /* @__PURE__ */ jsx12(
+                selectedFile && mediaProvider ? /* @__PURE__ */ jsxs12(Fragment7, { children: [
+                  /* @__PURE__ */ jsx13(
                     Suspense2,
                     {
-                      fallback: /* @__PURE__ */ jsx12("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
-                      children: /* @__PURE__ */ jsx12(
+                      fallback: /* @__PURE__ */ jsx13("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
+                      children: /* @__PURE__ */ jsx13(
                         EditorShell,
                         {
                           initialMarkdown: editorContent,
                           initialView,
+                          defaultViewportPreset: defaultPreviewViewportPreset,
                           articleId: selectedFile,
                           fileName: selectedFile,
                           onChange: handleEditorChange,
                           onLinkClick: handleEditorLinkClick,
                           colorScheme: resolvedTheme,
-                          writeCanvasSettings,
+                          writeCanvasSettings: editorWriteCanvasSettings,
                           height: "100%",
                           placeholder: editorPlaceholder,
                           outlineWidth: 280,
@@ -6473,28 +7646,29 @@ function DocBlocksShell({
                           versioningPrunePolicy,
                           versioningAutoSaveIdleMs,
                           onSaveVersion,
-                          toolbarSlotLeft: effectiveCompact ? /* @__PURE__ */ jsx12(
+                          statusBarSlotRight,
+                          toolbarSlotLeft: effectiveCompact ? /* @__PURE__ */ jsx13(
                             "button",
                             {
                               className: "db-mobile-back",
                               onClick: () => setMobileShowEditor(false),
                               "aria-label": "Show file list",
-                              children: /* @__PURE__ */ jsx12("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx12(FolderGlyph, {}) })
+                              children: /* @__PURE__ */ jsx13("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx13(FolderGlyph, {}) })
                             }
                           ) : void 0,
-                          toolbarSlotRight: /* @__PURE__ */ jsxs11(Fragment7, { children: [
-                            compactLayout && !isMobile && /* @__PURE__ */ jsx12(
+                          toolbarSlotRight: /* @__PURE__ */ jsxs12(Fragment7, { children: [
+                            compactLayout && !isMobile && /* @__PURE__ */ jsx13(
                               "button",
                               {
                                 className: "db-restore-split",
                                 onClick: () => setCompactLayout(false),
                                 "aria-label": "Restore split view",
                                 title: "Restore split view",
-                                children: /* @__PURE__ */ jsx12(SplitViewIcon, {})
+                                children: /* @__PURE__ */ jsx13(SplitViewIcon, {})
                               }
                             ),
-                            git.repo && /* @__PURE__ */ jsx12(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx12(GitToolbarControl, { selectedFile }) }),
-                            /* @__PURE__ */ jsx12(
+                            git.repo && /* @__PURE__ */ jsx13(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx13(GitToolbarControl, { selectedFile }) }),
+                            /* @__PURE__ */ jsx13(
                               ExportToolbarControls,
                               {
                                 selectedFile,
@@ -6512,15 +7686,15 @@ function DocBlocksShell({
                       )
                     }
                   ),
-                  showWelcomeGateway && !isMobile && /* @__PURE__ */ jsxs11("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
-                    /* @__PURE__ */ jsxs11("span", { className: "db-welcome-gateway-text", children: [
+                  showWelcomeGateway && !isMobile && /* @__PURE__ */ jsxs12("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
+                    /* @__PURE__ */ jsxs12("span", { className: "db-welcome-gateway-text", children: [
                       "You\u2019re watching this welcome doc in ",
-                      /* @__PURE__ */ jsx12("strong", { children: "Slideshow" }),
+                      /* @__PURE__ */ jsx13("strong", { children: "Slideshow" }),
                       " ",
                       "view\u2014 it\u2019s a regular markdown file, and so is everything you\u2019ll write."
                     ] }),
-                    /* @__PURE__ */ jsx12("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
-                    /* @__PURE__ */ jsx12(
+                    /* @__PURE__ */ jsx13("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
+                    /* @__PURE__ */ jsx13(
                       "button",
                       {
                         className: "db-welcome-gateway-dismiss",
@@ -6531,39 +7705,39 @@ function DocBlocksShell({
                       }
                     )
                   ] })
-                ] }) : selectedFolder ? /* @__PURE__ */ jsxs11("div", { className: "db-folder-view", children: [
-                  effectiveCompact && /* @__PURE__ */ jsxs11("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx12("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx12(FolderGlyph, {}) }),
+                ] }) : selectedFolder ? /* @__PURE__ */ jsxs12("div", { className: "db-folder-view", children: [
+                  effectiveCompact && /* @__PURE__ */ jsxs12("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                    /* @__PURE__ */ jsx13("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx13(FolderGlyph, {}) }),
                     "Back to files"
                   ] }),
-                  /* @__PURE__ */ jsxs11("div", { className: "db-folder-view-header", children: [
-                    /* @__PURE__ */ jsx12("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx12(FolderGlyph, {}) }),
-                    /* @__PURE__ */ jsx12("span", { className: "db-folder-view-path", children: selectedFolder })
+                  /* @__PURE__ */ jsxs12("div", { className: "db-folder-view-header", children: [
+                    /* @__PURE__ */ jsx13("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx13(FolderGlyph, {}) }),
+                    /* @__PURE__ */ jsx13("span", { className: "db-folder-view-path", children: selectedFolder })
                   ] }),
-                  folderEntries.length === 0 ? /* @__PURE__ */ jsx12("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx12("ul", { className: "db-folder-view-list", children: folderEntries.map((entry) => /* @__PURE__ */ jsxs11(
+                  visibleFolderEntries.length === 0 ? /* @__PURE__ */ jsx13("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx13("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs12(
                     "li",
                     {
                       className: "db-folder-view-item",
                       onClick: () => handleSelect(entry.path, entry.kind),
                       children: [
-                        /* @__PURE__ */ jsx12("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx12(FolderGlyph, {}) : /* @__PURE__ */ jsx12(FileGlyph, {}) }),
+                        /* @__PURE__ */ jsx13("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx13(FolderGlyph, {}) : /* @__PURE__ */ jsx13(FileGlyph, {}) }),
                         entry.name
                       ]
                     },
                     entry.path
                   )) })
-                ] }) : /* @__PURE__ */ jsxs11("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
-                  effectiveCompact && /* @__PURE__ */ jsxs11("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx12("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx12(FolderGlyph, {}) }),
+                ] }) : /* @__PURE__ */ jsxs12("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
+                  effectiveCompact && /* @__PURE__ */ jsxs12("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                    /* @__PURE__ */ jsx13("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx13(FolderGlyph, {}) }),
                     "Back to files"
                   ] }),
-                  /* @__PURE__ */ jsxs11("div", { className: "db-workspace-empty-content", children: [
-                    /* @__PURE__ */ jsx12("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx12(FileGlyph, {}) }),
-                    /* @__PURE__ */ jsx12("h1", { children: activeWorkspaceDescriptor?.name ? `${activeWorkspaceDescriptor.name} is ready` : "Your workspace is ready" }),
-                    /* @__PURE__ */ jsx12("p", { children: "Create your first Markdown document, or open a folder you already use." }),
-                    /* @__PURE__ */ jsxs11("div", { className: "db-workspace-empty-actions", children: [
-                      /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void handleNewFile(), children: "Create your first document" }),
-                      /* @__PURE__ */ jsx12(
+                  /* @__PURE__ */ jsxs12("div", { className: "db-workspace-empty-content", children: [
+                    /* @__PURE__ */ jsx13("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx13(FileGlyph, {}) }),
+                    /* @__PURE__ */ jsx13("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
+                    /* @__PURE__ */ jsx13("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
+                    /* @__PURE__ */ jsxs12("div", { className: "db-workspace-empty-actions", children: [
+                      /* @__PURE__ */ jsx13("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
+                      /* @__PURE__ */ jsx13(
                         "button",
                         {
                           type: "button",
@@ -6572,7 +7746,7 @@ function DocBlocksShell({
                           children: "New folder"
                         }
                       ),
-                      (isElectronHost3() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx12(
+                      (isElectronHost3() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx13(
                         "button",
                         {
                           type: "button",
@@ -6582,10 +7756,10 @@ function DocBlocksShell({
                         }
                       )
                     ] }),
-                    /* @__PURE__ */ jsx12("p", { className: "db-workspace-empty-hint", children: "Browser workspaces stay on this device. Use the sidebar backup action to keep a portable copy." })
+                    /* @__PURE__ */ jsx13("p", { className: "db-workspace-empty-hint", children: "Browser workspaces stay on this device. Use the sidebar backup action to keep a portable copy." })
                   ] })
                 ] }),
-                /* @__PURE__ */ jsx12(
+                /* @__PURE__ */ jsx13(
                   UpdateAvailableNotice,
                   {
                     available: updateAvailable,
@@ -6606,6 +7780,7 @@ export {
   AccentColorSettings,
   AppMenu,
   DEFAULT_OPTIONS,
+  DEFAULT_WRITE_CANVAS_FONT_SCHEME,
   DocBlocksShell,
   ExportDialog,
   ExportToolbarControls,
@@ -6613,10 +7788,12 @@ export {
   FileTreeNode,
   SettingsDialog,
   ThemeSettings,
+  WRITE_CANVAS_FONT_SCHEMES,
   WorkspacePicker,
   WriteCanvasSettingsControls,
   buildExportFilename,
   loadLastExportOptions,
+  resolveWriteCanvasFonts,
   runExport,
   updateExportTargetExtension,
   useDocumentSession,