@bendyline/docblocks-react 2.2.0 → 2.2.2

package/dist/index.js

@@ -13,27 +13,34 @@ 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-3CZ27FOA.js";
+} from "./chunk-MHTQORMH.js";
 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 })
-        ] }),
-        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" })
+          newItemError && /* @__PURE__ */ jsx4("div", { id: NEW_ITEM_ERROR_ID, className: "db-tree-error", role: "alert", children: newItemError })
         ] }),
-        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";
@@ -1704,7 +2300,7 @@ import {
   DocumentCommitConflictError,
   DocumentSessionConflictError
 } from "@bendyline/docblocks/document";
-import { isElectronHost as isElectronHost2, getDocBlocksHost } from "@bendyline/docblocks/host";
+import { isElectronHost as isElectronHost3, getDocBlocksHost } from "@bendyline/docblocks/host";
 import {
   parseSharedDocumentHash
 } from "@bendyline/docblocks/share";
@@ -1722,8 +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 { Fragment as Fragment3, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+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 jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function formatBytes(bytes) {
   if (!Number.isFinite(bytes) || bytes < 0) return "\u2014";
   let value = bytes;
@@ -1753,13 +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 menuRef = useRef5(null);
-  const [storageEstimate, setStorageEstimate] = useState5(null);
-  useEffect5(() => {
+  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 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) => {
@@ -1771,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();
@@ -1794,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,
@@ -1813,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" : ""}`,
@@ -1824,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",
@@ -1914,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",
@@ -1935,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",
@@ -1948,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",
@@ -1963,31 +2582,49 @@ 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."
       ] }),
-      appVersion && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
-        /* @__PURE__ */ jsx5("span", { children: "Version" }),
-        /* @__PURE__ */ jsx5("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
+      /* @__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__ */ jsx6(
+          "a",
+          {
+            href: "https://github.com/bendyline/docblocks/issues/new",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: "open issues"
+          }
+        ),
+        " ",
+        "where you find them. Thanks!"
+      ] }),
+      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(
+      /* @__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",
@@ -1996,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",
@@ -2006,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",
@@ -2016,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",
@@ -2026,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",
@@ -2042,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"
+            }
+          )
+        ]
+      }
+    )
   ] });
 }
 
@@ -2157,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",
@@ -2176,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",
@@ -2204,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",
@@ -2217,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",
@@ -2235,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())
@@ -2258,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-C46GMPKC.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);
@@ -2307,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(
@@ -2321,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);
     };
@@ -2354,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;
@@ -2381,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;
@@ -2416,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({
@@ -2438,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);
@@ -2471,7 +3127,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     },
     [gitApi, repositoryId, refresh, routeError]
   );
-  const commit = useCallback8(
+  const commit = useCallback9(
     (message, paths) => runAction(
       "commit",
       "commit",
@@ -2480,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",
@@ -2489,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",
@@ -2504,7 +3160,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     ),
     [runAction]
   );
-  const switchBranch = useCallback8(
+  const switchBranch = useCallback9(
     (name) => runAction(
       "branch",
       "branch",
@@ -2513,7 +3169,7 @@ function useGit(provider, requestedWorkspaceId, theme) {
     ),
     [runAction]
   );
-  const openOnRemote = useCallback8(
+  const openOnRemote = useCallback9(
     (filePath) => {
       if (!remoteWeb || !host) return;
       let url = remoteWeb.webUrl;
@@ -2525,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);
@@ -2643,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)",
@@ -2667,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 = () => {
@@ -2719,6 +3375,63 @@ async function decodeDbkWorkspace(bytes, options) {
   return snapshot;
 }
 
+// src/DocBlocksShell/editor-link-navigation.ts
+import { HOST_WIRE_LIMITS, isBoundedString, parseExternalHttpUrl } from "@bendyline/docblocks/host";
+var URI_SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+var MARKDOWN_EXTENSION = /\.(?:md|markdown|mdown)$/iu;
+function resolveShellEditorLinkTarget(href, documentPath) {
+  if (!isBoundedString(href, HOST_WIRE_LIMITS.urlCharacters, 1)) return null;
+  if (href.startsWith("#")) return { kind: "fragment" };
+  const externalUrl = parseExternalHttpUrl(href);
+  if (externalUrl) return { kind: "external", url: externalUrl };
+  if (documentPath === null || href.startsWith("//") || URI_SCHEME.test(href)) return null;
+  const splitAt = href.search(/[?#]/u);
+  const encodedPath = splitAt === -1 ? href : href.slice(0, splitAt);
+  if (!encodedPath) return null;
+  let decodedPath;
+  try {
+    decodedPath = decodeURIComponent(encodedPath);
+  } catch {
+    return null;
+  }
+  if (decodedPath.includes("\\") || hasControlCharacter(decodedPath)) return null;
+  const documentSegments = normalizeDocumentPath(documentPath);
+  if (!documentSegments) return null;
+  const targetSegments = decodedPath.startsWith("/") ? [] : documentSegments.slice(0, -1);
+  for (const segment of decodedPath.split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === "..") {
+      if (targetSegments.length === 0) return null;
+      targetSegments.pop();
+      continue;
+    }
+    if (segment.length > 255) return null;
+    targetSegments.push(segment);
+  }
+  const path = targetSegments.join("/");
+  if (!path || path.length > HOST_WIRE_LIMITS.pathCharacters || !MARKDOWN_EXTENSION.test(path)) {
+    return null;
+  }
+  return { kind: "workspace", path };
+}
+function normalizeDocumentPath(path) {
+  if (!isBoundedString(path, HOST_WIRE_LIMITS.pathCharacters, 1)) return null;
+  const segments = [];
+  for (const segment of path.replace(/\\/g, "/").split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === ".." || segment.length > 255 || hasControlCharacter(segment)) return null;
+    segments.push(segment);
+  }
+  return segments.length > 0 ? segments : null;
+}
+function hasControlCharacter(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    const code = value.charCodeAt(index);
+    if (code <= 31 || code === 127) return true;
+  }
+  return false;
+}
+
 // src/DocBlocksShell/import-files.ts
 import { FsError as FsError3 } from "@bendyline/docblocks/filesystem";
 
@@ -2869,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",
@@ -2906,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,
@@ -2931,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 };
@@ -2950,7 +3663,7 @@ function usePromptDialog() {
     }),
     [settlePending]
   );
-  useEffect11(() => {
+  useEffect12(() => {
     return () => settlePending(null);
   }, [settlePending]);
   const promptDialog = pending ? React2.createElement(PromptDialog, {
@@ -2963,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,
@@ -2995,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 };
@@ -3021,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, {
@@ -3084,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;
@@ -3105,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 {
@@ -3205,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,
@@ -3214,11 +3927,11 @@ function UpdateAvailableNotice({
   blocked = false,
   statusBarVisible
 }) {
-  const [promptOpen, setPromptOpen] = useState13(true);
+  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",
@@ -3231,19 +3944,27 @@ function UpdateAvailableNotice({
         title: "A new version of DocBlocks is available",
         children: "Update available"
       }
-    ),
-    promptVisible && /* @__PURE__ */ jsxs10("div", { id: UPDATE_PROMPT_ID, className: "db-update-banner", 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" })
-      ] })
-    ] })
+    ),
+    promptVisible && /* @__PURE__ */ jsxs11(
+      "div",
+      {
+        id: UPDATE_PROMPT_ID,
+        className: `db-update-banner${statusBarVisible ? "" : " db-update-banner--floating"}`,
+        role: "alert",
+        children: [
+          /* @__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" })
+          ] })
+        ]
+      }
+    )
   ] });
 }
 
 // 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 {
@@ -3425,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();
@@ -3434,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;
@@ -3549,8 +4270,93 @@ async function copyTransientWorkspaceContents(source, destination) {
   }
 }
 
+// src/DocBlocksShell/welcome-document.ts
+var WELCOME_DOCUMENT_PATH = "/aboutDocBlocks.md";
+var WELCOME_DOCUMENT_CONTENT = [
+  "---",
+  "squisq-theme: warm-earth",
+  "squisq-cover-slide: false",
+  "---",
+  "",
+  '# DocBlocks: one Markdown file, many finished forms {[title subtitle="Local-first writing for pages, documents, slideshows, and video"]}',
+  "",
+  "Write in plain Markdown. Shape it visually. Keep it portable.",
+  "",
+  "## A document editor that never asks you to stop owning the document {[factCard]}",
+  "",
+  "DocBlocks pairs a friendly visual writing surface with the durable source format you already know. There is no account to create, no proprietary document to rescue later, and no requirement to send your work to a hosted editor.",
+  "",
+  "## One source, four ways to publish {[diagram]}",
+  "",
+  "```diagram",
+  "+------------+",
+  "|  Markdown  |",
+  "+-----+------+",
+  "      |",
+  "  +---+------+------------+-----------+",
+  "  |          |            |           |",
+  "  v          v            v           v",
+  "+-------+ +---------+ +------------+ +-------+",
+  "| Pages | |Documents| | Slideshows | | Video |",
+  "+-------+ +---------+ +------------+ +-------+",
+  "```",
+  "",
+  "## Write visually, then look under the hood whenever you like {[content]}",
+  "",
+  "Use the rich editor for headings, lists, tables, links, images, media, and everyday formatting. Switch to raw Markdown for exact control. Add themes, transform styles, and squiggly-square section annotations when a passage deserves its own visual treatment. The readable `.md` source stays at the center of the workflow.",
+  "",
+  "## Preview the finished idea before you export it {[list]}",
+  "",
+  "- **Document** \u2014 Read the work as a polished, continuous document.",
+  "- **Page** \u2014 See how it behaves as a web page.",
+  "- **Slideshow** \u2014 Step through headings as designed presentation blocks.",
+  "- **Video** \u2014 Rehearse timing, motion, narration, and media in a player-ready view.",
+  "",
+  '## Local or installed: choose the workspace that fits {[twoColumn header="Work where your files make sense" left="Web|Browser-local workspaces or folders you explicitly grant" right="Desktop|Real folders, native menus, file opening, and updates"]}',
+  "",
+  '## In the project or in the pipeline {[twoColumn header="The same Markdown keeps moving" left="VS Code|Rich editing beside tabs, source control, and the project tree" right="CLI + MCP|Build, serve, convert, render, inspect, validate, and automate"]}',
+  "",
+  "## The quiet conveniences are there, too {[list]}",
+  "",
+  "- **Workspaces and file navigation** keep related documents organized without hiding their source.",
+  "- **Automatic saving** protects the active revision while still surfacing conflicts or save errors.",
+  "- **Optional version history** keeps plain sibling revisions when you want a trail of changes.",
+  "- **Copy-by-link sharing** creates a bounded Markdown copy that can open directly in a chosen Play view.",
+  "- **Offline-ready, local-first storage** keeps browser work on this device and native work inside folders you choose.",
+  "",
+  "## Export without rebuilding the document {[list]}",
+  "",
+  "- Create **Word documents and PDFs** for review, printing, and fixed-layout sharing.",
+  "- Create **PowerPoint decks** from the same annotated sections you preview as a slideshow.",
+  "- Publish **HTML pages, packaged HTML, and EPUB e-books**.",
+  "- Keep portable **Markdown or DBK bundles** with their media assets.",
+  "- Use the linked CLI registry for **spreadsheets, MP4 video, animated GIF, batch conversion, and more**.",
+  "",
+  "## Local-first is concrete, not decorative {[quote]}",
+  "",
+  "> Your browser workspace stays on this device. Native folders are opened only when you choose them. Your Markdown remains useful in DocBlocks, Git, a terminal, another editor, or an AI-assisted workflow.",
+  "",
+  "## Agents get document tools, not a blank check {[factCard]}",
+  "",
+  "The local MCP server can inspect, validate, preview, compare, and convert documents. Results remain temporary session artifacts until they are deliberately saved, and filesystem access begins with explicit roots rather than assumed authority.",
+  "",
+  "## Start with three small moves {[list]}",
+  "",
+  "1. Create a document with **New file** in the file pane.",
+  "2. Write visually or in Markdown source; switch views whenever it helps.",
+  "3. Open **Play** or **Export** when the idea is ready to become something else.",
+  "",
+  "## Explore DocBlocks {[list]}",
+  "",
+  "- [Desktop app](https://docblocks.com/desktop/) \u2014 macOS, Windows, and Linux.",
+  "- [VS Code extension](https://docblocks.com/vscode/) \u2014 rich Markdown editing inside a workspace.",
+  "- [CLI and MCP server](https://docblocks.com/cli/) \u2014 conversion, rendering, and agent workflows.",
+  "- [Supported formats](https://docblocks.com/formats/) \u2014 current import and export directions.",
+  "- [Documentation](https://docblocks.com/docs/) \u2014 guides for using and extending DocBlocks."
+].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 () => {
@@ -3562,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)",
@@ -3639,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);
@@ -3713,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) {
@@ -3798,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);
@@ -3810,7 +4642,7 @@ function useIsMobile(breakpoint = 768) {
   return isMobile;
 }
 function FolderGlyph() {
-  return /* @__PURE__ */ jsx12(
+  return /* @__PURE__ */ jsx13(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -3819,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",
@@ -3834,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" })
       ]
     }
   );
@@ -3856,67 +4688,77 @@ 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(() => {
-    if (isElectronHost2() || typeof document === "undefined") return;
+  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 = !isElectronHost2();
-  const appVersion = isElectronHost2() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web";
+  const showBrowserStorageWarning = !isElectronHost3();
+  const appVersion = isElectronHost3() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web";
   const issueReportUrl = buildIssueReportUrl({
     reportedAt: /* @__PURE__ */ new Date(),
     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,
@@ -3925,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 };
@@ -3982,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);
@@ -4005,16 +4847,100 @@ 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;
     }
     let cancelled = false;
-    const electron = isElectronHost2();
+    const electron = isElectronHost3();
     void listWorkspaces2().then((workspaces) => {
       if (cancelled) return;
       setTransientMoveDestinations(
@@ -4031,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 });
@@ -4054,10 +4980,10 @@ function DocBlocksShell({
     },
     [activeWorkspaceDescriptor]
   );
-  const [selectedFile, setSelectedFile] = useState14(null);
+  const [selectedFile, setSelectedFile] = useState15(null);
   useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath);
   const exportDestinationAdapter = useMemo3(() => {
-    if (!isElectronHost2() || !activeWorkspaceId || !selectedFile) return void 0;
+    if (!isElectronHost3() || !activeWorkspaceId || !selectedFile) return void 0;
     const documentId = JSON.stringify([activeWorkspaceId, selectedFile]);
     const host = getDocBlocksHost().exports;
     return {
@@ -4066,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(
@@ -4077,28 +5007,28 @@ 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);
       const originKind = transient?.descriptor.origin?.kind;
       const needsElectronHost = originKind === "loose-file" || originKind === "dbk";
-      if (!transient?.descriptor.origin || needsElectronHost && !isElectronHost2()) {
+      if (!transient?.descriptor.origin || needsElectronHost && !isElectronHost3()) {
         return {
           key: baseTarget.key,
           async commit(request) {
@@ -4258,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;
@@ -4346,7 +5276,7 @@ function DocBlocksShell({
     },
     [createDocumentTarget, documentSession, pushHash]
   );
-  const adoptTransientWorkspace = useCallback14(
+  const adoptTransientWorkspace = useCallback15(
     async (options) => {
       const descriptor = {
         id: options.id,
@@ -4375,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");
@@ -4403,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;
@@ -4426,39 +5356,8 @@ function DocBlocksShell({
         return;
       }
       if (entries.length > 0) return;
-      const welcomePath = "/aboutDocBlocks.md";
-      const welcomeContent = [
-        "# DocBlocks: the local-first Markdown editor",
-        "",
-        "Your markdown can do anything.",
-        "",
-        "DocBlocks is a free, local-first Markdown editor for creating, organizing, and publishing documents without sending your writing to a server. What you write here can become a Word or PDF document, a slide deck, a web page, or a video.",
-        "",
-        "Simple to write. Beautiful wherever it goes.",
-        "",
-        "## Features",
-        "",
-        "- **Rich Markdown editing** \u2014 Write visually or switch to raw Markdown source at any time. Section annotations can change how individual blocks are presented.",
-        "- **Workspaces** \u2014 Organize documents into separate browser workspaces or folders on your device.",
-        "- **Useful everywhere** \u2014 Export Word, PowerPoint, PDF, HTML, and Markdown in the app, with EPUB and additional formats available through the CLI.",
-        "- **Playback and video** \u2014 Preview a document as a rich presentation and export it as an MP4 video.",
-        "- **Private by default** \u2014 No ads, accounts, or tracking. Your browser workspace stays on this device.",
-        "",
-        "## Getting Started",
-        "",
-        "1. Create a document with the **New file** button in the file pane.",
-        "2. Start writing in Markdown \u2014 the editor supports headings, lists, links, images, and more.",
-        "3. Your work is saved automatically.",
-        "",
-        "Built with [squisq](https://github.com/bendyline/squisq) by [Bendyline](https://bendyline.com).",
-        "",
-        "## Explore DocBlocks",
-        "",
-        "- [Desktop app](https://docblocks.com/desktop/) for macOS, Windows, and Linux",
-        "- [VS Code extension](https://docblocks.com/vscode/) for rich editing inside your workspace",
-        "- [CLI and MCP server](https://docblocks.com/cli/) for conversion and agent workflows",
-        "- [Supported formats](https://docblocks.com/formats/) and [documentation](https://docblocks.com/docs/)"
-      ].join("\n");
+      const welcomePath = WELCOME_DOCUMENT_PATH;
+      const welcomeContent = WELCOME_DOCUMENT_CONTENT;
       let seededContent = welcomeContent;
       try {
         await writeProviderText(fs, welcomePath, welcomeContent, "create");
@@ -4484,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);
@@ -4505,12 +5404,12 @@ 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;
     void (async () => {
-      const electron = isElectronHost2();
+      const electron = isElectronHost3();
       let workspaceIdRemap = {};
       if (electron) {
         try {
@@ -4702,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 = () => {
@@ -4744,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;
@@ -4757,8 +5656,8 @@ function DocBlocksShell({
       cancelled = true;
     };
   }, [showBrowserStorageWarning]);
-  useEffect14(() => {
-    if (isElectronHost2() || typeof window === "undefined") return;
+  useEffect15(() => {
+    if (isElectronHost3() || typeof window === "undefined") return;
     const onBeforeInstallPrompt = (e) => {
       e.preventDefault();
       setInstallPromptEvent(e);
@@ -4780,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;
@@ -4790,7 +5689,7 @@ function DocBlocksShell({
     } catch {
     }
   }, [installPromptEvent]);
-  useEffect14(() => {
+  useEffect15(() => {
     const handler = (e) => {
       const target = e.target.closest?.("[data-view]");
       if (target) {
@@ -4806,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;
@@ -4828,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;
@@ -4863,7 +5762,7 @@ function DocBlocksShell({
     }).catch(() => {
     });
   }, [showBrowserStorageWarning, browserStoragePersistent, documentSnapshot.status]);
-  useEffect14(() => {
+  useEffect15(() => {
     if (!provider || !selectedFile) {
       mediaContainerRef.current = null;
       versionsContainerRef.current = null;
@@ -4887,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) => {
@@ -4905,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;
@@ -4965,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 {
@@ -4984,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 {
@@ -5007,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");
@@ -5020,7 +5919,7 @@ function DocBlocksShell({
       });
     }
   }, [documentSession]);
-  useEffect14(() => {
+  useEffect15(() => {
     const needsWarning = ["dirty", "saving", "error", "conflict"].includes(documentSnapshot.status);
     if (!documentSnapshot.targetKey) return;
     const flushBestEffort = () => {
@@ -5046,8 +5945,8 @@ function DocBlocksShell({
       document.removeEventListener("visibilitychange", onVisibilityChange);
     };
   }, [documentSession, documentSnapshot.status, documentSnapshot.targetKey]);
-  useEffect14(() => {
-    if (!isElectronHost2()) return;
+  useEffect15(() => {
+    if (!isElectronHost3()) return;
     const lifecycle = getDocBlocksHost().lifecycle;
     const stopPrepare = lifecycle.onPrepareClose(async (request) => {
       preparedCloseRequestRef.current = request.requestId;
@@ -5073,7 +5972,7 @@ function DocBlocksShell({
       stopCancel();
     };
   }, [documentSession]);
-  const handleWorkspaceSelect = useCallback14(
+  const handleWorkspaceSelect = useCallback15(
     async (ws) => {
       const requestId = ++navigationRequestRef.current;
       await touchWorkspace2(ws.id);
@@ -5105,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.");
@@ -5161,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");
@@ -5177,7 +6259,7 @@ function DocBlocksShell({
         void touchWorkspace2(destination.id).catch(() => void 0);
         if (sourceTargetKey) pendingDbkConflictsRef.current.delete(sourceTargetKey);
         const origin = transient.descriptor.origin;
-        if (isElectronHost2() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
+        if (isElectronHost3() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
           try {
             await getDocBlocksHost().external.revoke(origin.resourceId);
           } catch {
@@ -5211,10 +6293,10 @@ function DocBlocksShell({
       transientMoveDestinations
     ]
   );
-  const handleOpenFolder = useCallback14(async () => {
+  const handleOpenFolder = useCallback15(async () => {
     const requestId = ++navigationRequestRef.current;
     try {
-      if (isElectronHost2()) {
+      if (isElectronHost3()) {
         const info = await getDocBlocksHost().workspaces.pickFolder();
         if (!info) return;
         if (requestId !== navigationRequestRef.current) return;
@@ -5257,7 +6339,7 @@ function DocBlocksShell({
     } catch {
     }
   }, [pushHash, transitionAwayFromDocument]);
-  const handleWorkspaceCloned = useCallback14(
+  const handleWorkspaceCloned = useCallback15(
     (info) => {
       const requestId = ++navigationRequestRef.current;
       void (async () => {
@@ -5286,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",
@@ -5352,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",
@@ -5398,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);
@@ -5414,15 +6496,15 @@ function DocBlocksShell({
     );
     void handleNewFile();
   }, [provider, handleNewFile]);
-  const handleRevealWorkspace = useCallback14(async () => {
-    if (!isElectronHost2() || !activeWorkspaceId) return;
+  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(() => {
-    if (!isElectronHost2()) return;
+  useEffect15(() => {
+    if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onMenuCommand((cmd) => {
       switch (cmd) {
@@ -5485,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;
@@ -5542,7 +6624,57 @@ function DocBlocksShell({
       showToast
     ]
   );
-  const handleTreeMutation = useCallback14(
+  const handleEditorLinkClick = useCallback15(
+    (href) => {
+      const target = resolveShellEditorLinkTarget(href, selectedFile);
+      if (!target) {
+        showToast(
+          "error",
+          "DocBlocks only opens HTTP(S) links or Markdown files inside this workspace."
+        );
+        return true;
+      }
+      if (target.kind === "fragment") return false;
+      if (target.kind === "external") {
+        if (isElectronHost3()) {
+          void getDocBlocksHost().shell.openExternal(target.url).catch((error) => {
+            showToast(
+              "error",
+              error instanceof Error ? error.message : "Could not open the external link."
+            );
+          });
+        } else if (typeof window !== "undefined") {
+          try {
+            window.open(target.url, "_blank", "noopener,noreferrer");
+          } catch (error) {
+            showToast(
+              "error",
+              error instanceof Error ? error.message : "Could not open the external link."
+            );
+          }
+        }
+        return true;
+      }
+      void (async () => {
+        if (!provider) return;
+        try {
+          if (!await providerEntryExists(provider, target.path)) {
+            showToast("error", "The linked Markdown file was not found in this workspace.");
+            return;
+          }
+          await handleSelect(target.path, "file");
+        } catch (error) {
+          showToast(
+            "error",
+            error instanceof Error ? error.message : "Could not open the linked Markdown file."
+          );
+        }
+      })();
+      return true;
+    },
+    [handleSelect, provider, selectedFile, showToast]
+  );
+  const handleTreeMutation = useCallback15(
     async (change, mutate) => {
       if (!provider || !activeWorkspaceId || !selectedFile) {
         await mutate();
@@ -5566,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) {
@@ -5590,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) {
@@ -5602,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";
@@ -5629,7 +6974,7 @@ function DocBlocksShell({
     },
     []
   );
-  const handleImportFiles = useCallback14(
+  const handleImportFiles = useCallback15(
     async (files) => {
       if (!provider) return;
       const result = await importDroppedFiles(files, provider, {
@@ -5641,7 +6986,7 @@ function DocBlocksShell({
     },
     [provider, persistImportedMedia, showToast]
   );
-  const handleEditorChange = useCallback14(
+  const handleEditorChange = useCallback15(
     (source) => {
       if (!editorSessionScope) return;
       try {
@@ -5651,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;
@@ -5663,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();
@@ -5740,8 +7088,8 @@ function DocBlocksShell({
     },
     [adoptTransientWorkspace]
   );
-  useEffect14(() => {
-    if (!isElectronHost2()) return;
+  useEffect15(() => {
+    if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onOpenRequest((req) => {
       const requestId = ++navigationRequestRef.current;
@@ -5764,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);
@@ -5806,8 +7154,8 @@ function DocBlocksShell({
     },
     [adoptTransientWorkspace]
   );
-  useEffect14(() => {
-    if (isElectronHost2() || typeof window === "undefined") return;
+  useEffect15(() => {
+    if (isElectronHost3() || typeof window === "undefined") return;
     const launchQueue = window.launchQueue;
     if (!launchQueue) return;
     launchQueue.setConsumer((params) => {
@@ -5822,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");
@@ -5845,14 +7193,14 @@ 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([
         import("@bendyline/squisq/storage"),
         import("@bendyline/squisq-formats/container")
       ]);
-      const electron = isElectronHost2();
+      const electron = isElectronHost3();
       const all = await listWorkspaces2();
       const candidates = all.filter(
         (w) => electron ? w.type === "electron-native" || w.type === "transient" : w.type !== "electron-native"
@@ -5924,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") {
@@ -5961,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;
@@ -5973,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";
@@ -5994,7 +7342,7 @@ function DocBlocksShell({
       }
     } else if (ws?.type === "transient") {
       const origin = ws.origin;
-      if (isElectronHost2() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
+      if (isElectronHost3() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
         try {
           await getDocBlocksHost().external.revoke(origin.resourceId);
         } catch {
@@ -6006,8 +7354,13 @@ 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 = isElectronHost2();
+    const electron = isElectronHost3();
     const remaining = (await listWorkspaces2()).filter(
       (w) => electron ? w.type === "electron-native" : w.type !== "electron-native"
     );
@@ -6039,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,
@@ -6060,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,
@@ -6084,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,
@@ -6093,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,
@@ -6115,7 +7475,7 @@ function DocBlocksShell({
                       appBuildDate
                     }
                   ),
-                  /* @__PURE__ */ jsx12(
+                  /* @__PURE__ */ jsx13(
                     WorkspacePicker,
                     {
                       activeWorkspaceId,
@@ -6125,7 +7485,7 @@ function DocBlocksShell({
                       onCloneRepository: git.available ? () => git.openDialog({ kind: "clone" }) : void 0
                     }
                   ),
-                  /* @__PURE__ */ jsx12(
+                  /* @__PURE__ */ jsx13(
                     WorkspaceSettingsButton,
                     {
                       onSettings: handleOpenWorkspaceSettings,
@@ -6134,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,
@@ -6175,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",
@@ -6196,7 +7557,7 @@ function DocBlocksShell({
                             children: "Tour the welcome document"
                           }
                         ),
-                        /* @__PURE__ */ jsx12(
+                        /* @__PURE__ */ jsx13(
                           "button",
                           {
                             type: "button",
@@ -6209,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"
                       }
                     )
                   ] })
@@ -6232,7 +7593,7 @@ function DocBlocksShell({
               ]
             }
           ),
-          !effectiveCompact && /* @__PURE__ */ jsx12(
+          !effectiveCompact && /* @__PURE__ */ jsx13(
             "div",
             {
               className: "db-shell-sidebar-resizer",
@@ -6242,7 +7603,7 @@ function DocBlocksShell({
               onPointerDown: handleResizerPointerDown
             }
           ),
-          (!effectiveCompact || mobileShowEditor) && /* @__PURE__ */ jsxs11(
+          (!effectiveCompact || mobileShowEditor) && /* @__PURE__ */ jsxs12(
             "main",
             {
               "aria-label": "Document editor",
@@ -6255,21 +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,
@@ -6283,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,
@@ -6322,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",
@@ -6341,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",
@@ -6382,7 +7746,7 @@ function DocBlocksShell({
                           children: "New folder"
                         }
                       ),
-                      (isElectronHost2() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx12(
+                      (isElectronHost3() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx13(
                         "button",
                         {
                           type: "button",
@@ -6392,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,
@@ -6416,6 +7780,7 @@ export {
   AccentColorSettings,
   AppMenu,
   DEFAULT_OPTIONS,
+  DEFAULT_WRITE_CANVAS_FONT_SCHEME,
   DocBlocksShell,
   ExportDialog,
   ExportToolbarControls,
@@ -6423,10 +7788,12 @@ export {
   FileTreeNode,
   SettingsDialog,
   ThemeSettings,
+  WRITE_CANVAS_FONT_SCHEMES,
   WorkspacePicker,
   WriteCanvasSettingsControls,
   buildExportFilename,
   loadLastExportOptions,
+  resolveWriteCanvasFonts,
   runExport,
   updateExportTargetExtension,
   useDocumentSession,