@bendyline/docblocks-react 2.7.3 → 2.7.4

package/dist/index.js

@@ -17,7 +17,7 @@ import {
 } from "./chunk-DICE7VBJ.js";
 import {
   useConfirmDialog
-} from "./chunk-6B7G33D5.js";
+} from "./chunk-KBUHWZCF.js";
 import {
   createSpeechInputProvider
 } from "./chunk-KBDZDFPU.js";
@@ -51,7 +51,7 @@ import {
 } from "./chunk-KWG6UP5O.js";
 import {
   runExport
-} from "./chunk-6PA7QBZT.js";
+} from "./chunk-7CSBRAMT.js";
 import {
   createImageSaveOutput
 } from "./chunk-UONFWKJ7.js";
@@ -87,7 +87,7 @@ import {
   saveProofingPreferences,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-ZMCQO57Q.js";
+} from "./chunk-FBPCURCS.js";
 import {
   FindButton,
   focusFindInput,
@@ -100,18 +100,18 @@ import {
   matchShortcut,
   shortcutLabel
 } from "./chunk-ACQF63SB.js";
-import "./chunk-EOU2JWAQ.js";
+import "./chunk-PNZFIIWW.js";
 import {
   buildIssueReportUrl,
   displayBuildDate,
   localDateStamp,
   openExternalUrl
-} from "./chunk-YPIVCCTB.js";
+} from "./chunk-7V34VUK6.js";
 import "./chunk-K4I3NJFL.js";
 import {
   ExportDialog
-} from "./chunk-Y5OE3HJC.js";
-import "./chunk-YBEYTVU2.js";
+} from "./chunk-GFK4TCKN.js";
+import "./chunk-H3BK5MK6.js";
 import {
   DEFAULT_OPTIONS,
   loadLastExportOptions
@@ -119,13 +119,14 @@ import {
 import {
   Dialog,
   dismissTopmostDialog
-} from "./chunk-56KO2LYN.js";
+} from "./chunk-VJPGZCFS.js";
 
 // src/FileExplorer/FileExplorer.tsx
 import { useCallback as useCallback5, useEffect as useEffect5, useMemo, useRef as useRef5, useState as useState4 } from "react";
 import {
   isFileSystemMoveStateError,
-  parseWorkspacePath as parseWorkspacePath4
+  parseWorkspacePath as parseWorkspacePath4,
+  tryParseWorkspacePath as tryParseWorkspacePath2
 } from "@bendyline/docblocks/filesystem";
 
 // src/FileExplorer/useFileTree.ts
@@ -139,6 +140,7 @@ import {
   workspacePathDirname
 } from "@bendyline/docblocks/filesystem";
 var DIRECTORY_NOT_FOUND_RETRY_DELAYS_MS = Object.freeze([40, 120]);
+var AUTO_RETRY_DELAYS_MS = Object.freeze([1e3, 4e3, 15e3]);
 function normalisePath(path) {
   return parseWorkspacePath(path);
 }
@@ -167,10 +169,13 @@ function sameEntry(left, right) {
   if (left.kind !== right.kind || left.name !== right.name || left.path !== right.path)
     return false;
   if (left.kind === "file" && right.kind === "file") {
-    return left.lastModified === right.lastModified;
+    return left.lastModified === right.lastModified && left.readIssue?.code === right.readIssue?.code && left.readIssue?.message === right.readIssue?.message;
   }
   return true;
 }
+function hasUnreadableFile(entries) {
+  return entries.some((entry) => entry.kind === "file" && entry.readIssue !== void 0);
+}
 function reconcileEntries(current, incoming) {
   const currentByPath = new Map(current.map((entry) => [entry.path, entry]));
   const reconciled = incoming.map((entry) => {
@@ -189,7 +194,8 @@ async function readProviderDirectory(provider, path) {
       kind: entry.kind,
       name: entry.name,
       path: entry.path,
-      ...entry.kind === "file" ? { lastModified: entry.lastModified } : {}
+      ...entry.kind === "file" ? { lastModified: entry.lastModified } : {},
+      ...entry.kind === "file" && entry.readIssue ? { readIssue: entry.readIssue } : {}
     }));
   };
   for (let attempt = 0; ; attempt += 1) {
@@ -237,64 +243,111 @@ function useFileTree(provider, metadataRefreshKey, metadataRefreshPath) {
   providerRef.current = provider;
   const directoryRequestSequenceRef = useRef(0);
   const directoryRequestsRef = useRef(/* @__PURE__ */ new Map());
+  const autoRetriesRef = useRef(/* @__PURE__ */ new Map());
+  const autoRetryLoadRef = useRef(async () => void 0);
   const reportRootIssue = useCallback((caught) => {
     setRootIssue(readIssue(caught, ""));
   }, []);
-  const loadRoot = useCallback(async (showLoading = true) => {
-    const sourceProvider = providerRef.current;
-    if (!sourceProvider) {
-      setEntries([]);
-      setLoading(false);
-      return;
-    }
-    const requestId = ++directoryRequestSequenceRef.current;
-    directoryRequestsRef.current.set("", requestId);
-    const isCurrent = () => providerRef.current === sourceProvider && directoryRequestsRef.current.get("") === requestId;
-    if (showLoading) setLoading(true);
-    try {
-      const root = await readProviderDirectory(sourceProvider, "");
-      if (!isCurrent()) return;
-      setEntries((current) => reconcileEntries(current, root));
-      setRootIssue(null);
-    } catch (caught) {
-      if (isCurrent()) setRootIssue(readIssue(caught, ""));
-    } finally {
-      if (isCurrent()) setLoading(false);
-    }
+  const cancelAutoRetry = useCallback((directoryPath) => {
+    const state = autoRetriesRef.current.get(directoryPath);
+    if (state?.timer) clearTimeout(state.timer);
+    autoRetriesRef.current.delete(directoryPath);
   }, []);
-  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 current = prev.get(canonical) ?? [];
-        const reconciled = reconcileEntries(current, children);
-        if (prev.has(canonical) && reconciled === current) return prev;
-        const next = new Map(prev);
-        next.set(canonical, reconciled);
-        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;
-      });
+  const cancelAllAutoRetries = useCallback(() => {
+    for (const state of autoRetriesRef.current.values()) {
+      if (state.timer) clearTimeout(state.timer);
     }
+    autoRetriesRef.current.clear();
   }, []);
+  const settleAutoRetry = useCallback(
+    (directoryPath, needsRetry) => {
+      if (!needsRetry) {
+        cancelAutoRetry(directoryPath);
+        return;
+      }
+      const current = autoRetriesRef.current.get(directoryPath);
+      if (current?.timer) return;
+      const attempts = current?.attempts ?? 0;
+      const delay = AUTO_RETRY_DELAYS_MS[attempts];
+      if (delay === void 0) return;
+      const next = { attempts: attempts + 1, timer: null };
+      next.timer = setTimeout(() => {
+        next.timer = null;
+        void autoRetryLoadRef.current(directoryPath);
+      }, delay);
+      autoRetriesRef.current.set(directoryPath, next);
+    },
+    [cancelAutoRetry]
+  );
+  const loadRoot = useCallback(
+    async (showLoading = true) => {
+      const sourceProvider = providerRef.current;
+      if (!sourceProvider) {
+        setEntries([]);
+        setLoading(false);
+        return;
+      }
+      const requestId = ++directoryRequestSequenceRef.current;
+      directoryRequestsRef.current.set("", requestId);
+      const isCurrent = () => providerRef.current === sourceProvider && directoryRequestsRef.current.get("") === requestId;
+      if (showLoading) setLoading(true);
+      try {
+        const root = await readProviderDirectory(sourceProvider, "");
+        if (!isCurrent()) return;
+        setEntries((current) => reconcileEntries(current, root));
+        setRootIssue(null);
+        settleAutoRetry("", hasUnreadableFile(root));
+      } catch (caught) {
+        if (isCurrent()) {
+          const issue = readIssue(caught, "");
+          setRootIssue(issue);
+          settleAutoRetry("", issue.retryable);
+        }
+      } finally {
+        if (isCurrent()) setLoading(false);
+      }
+    },
+    [settleAutoRetry]
+  );
+  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 current = prev.get(canonical) ?? [];
+          const reconciled = reconcileEntries(current, children);
+          if (prev.has(canonical) && reconciled === current) return prev;
+          const next = new Map(prev);
+          next.set(canonical, reconciled);
+          return next;
+        });
+        setChildIssues((prev) => {
+          if (!prev.has(canonical)) return prev;
+          const next = new Map(prev);
+          next.delete(canonical);
+          return next;
+        });
+        settleAutoRetry(canonical, hasUnreadableFile(children));
+      } catch (caught) {
+        if (!isCurrent()) return;
+        const issue = readIssue(caught, dirPath);
+        setChildIssues((prev) => {
+          const next = new Map(prev);
+          next.set(canonical, issue);
+          return next;
+        });
+        settleAutoRetry(canonical, issue.retryable);
+      }
+    },
+    [settleAutoRetry]
+  );
   useEffect(() => {
     setEntries([]);
     setExpanded(/* @__PURE__ */ new Set());
@@ -304,8 +357,10 @@ function useFileTree(provider, metadataRefreshKey, metadataRefreshPath) {
     setSelectedKind(null);
     setRootIssue(null);
     directoryRequestsRef.current.clear();
+    cancelAllAutoRetries();
     void loadRoot();
-  }, [provider, loadRoot]);
+    return cancelAllAutoRetries;
+  }, [provider, loadRoot, cancelAllAutoRetries]);
   const toggleExpand = useCallback(
     (path) => {
       setExpanded((prev) => {
@@ -352,10 +407,12 @@ function useFileTree(provider, metadataRefreshKey, metadataRefreshPath) {
   }, [loadRoot, loadChildren, expanded]);
   const retryDirectory = useCallback(
     async (path) => {
-      if (normalisePath(path) === "") await loadRoot();
+      const canonical = normalisePath(path);
+      cancelAutoRetry(canonical);
+      if (canonical === "") await loadRoot();
       else await loadChildren(path);
     },
-    [loadRoot, loadChildren]
+    [loadRoot, loadChildren, cancelAutoRetry]
   );
   const refreshRef = useRef(refresh);
   refreshRef.current = refresh;
@@ -366,6 +423,7 @@ function useFileTree(provider, metadataRefreshKey, metadataRefreshPath) {
     },
     [loadChildren, loadRoot]
   );
+  autoRetryLoadRef.current = refreshDirectory;
   const previousMetadataRefreshKeyRef = useRef(metadataRefreshKey);
   useEffect(() => {
     if (Object.is(previousMetadataRefreshKeyRef.current, metadataRefreshKey)) return;
@@ -542,12 +600,13 @@ function useFileTree(provider, metadataRefreshKey, metadataRefreshPath) {
       setExpanded(nextExpanded);
       setChildEntries(/* @__PURE__ */ new Map());
       setChildIssues(/* @__PURE__ */ new Map());
+      cancelAllAutoRetries();
       await loadRoot();
       for (const dirPath of nextExpanded) {
         await loadChildren(dirPath);
       }
     },
-    [selectedPath, entries, childEntries, expanded, loadRoot, loadChildren]
+    [selectedPath, entries, childEntries, expanded, loadRoot, loadChildren, cancelAllAutoRetries]
   );
   return {
     entries,
@@ -788,6 +847,11 @@ function FileTreeNode({
 }) {
   const [renaming, setRenaming] = useState2(false);
   const [renameValue, setRenameValue] = useState2(entry.name);
+  const readIssue2 = entry.kind === "file" ? entry.readIssue : void 0;
+  const rowStatus = [
+    badge?.label,
+    readIssue2 ? `could not be read: ${readIssue2.message}` : void 0
+  ].filter((part) => part !== void 0);
   const [showContext, setShowContext] = useState2(false);
   const [contextPos, setContextPos] = useState2({ x: 0, y: 0 });
   const [actionError, setActionError] = useState2(null);
@@ -1034,7 +1098,7 @@ function FileTreeNode({
         "data-path": entry.path,
         "aria-expanded": isDir ? expanded : void 0,
         "aria-selected": selected,
-        "aria-label": badge ? `${entry.name}, ${badge.label}` : void 0,
+        "aria-label": rowStatus.length > 0 ? `${entry.name}, ${rowStatus.join(", ")}` : void 0,
         "aria-level": depth + 1,
         "aria-posinset": posInSet,
         "aria-setsize": setSize,
@@ -1086,6 +1150,15 @@ function FileTreeNode({
           ) : /* @__PURE__ */ jsxs(Fragment, { children: [
             /* @__PURE__ */ jsx2("span", { className: "db-tree-label", children: displayFileName(entry.name) }),
             badge && /* @__PURE__ */ jsx2("span", { className: `db-git-badge db-git-badge--${badge.kind}`, "aria-hidden": "true", children: badge.glyph }),
+            readIssue2 && /* @__PURE__ */ jsx2(
+              "span",
+              {
+                className: "db-tree-read-issue",
+                title: `Could not read this file: ${readIssue2.message}`,
+                "aria-hidden": "true",
+                children: "!"
+              }
+            ),
             entry.kind === "file" && entry.lastModified && /* @__PURE__ */ jsx2(LastModifiedTime, { value: entry.lastModified }),
             /* @__PURE__ */ jsx2(
               "button",
@@ -1717,6 +1790,7 @@ import {
   FsError as FsError3,
   SQUISQ_RUNTIME_DIRECTORY_NAME,
   getFileSystemProviderV2 as getFileSystemProviderV23,
+  findWikiArticle,
   parseWorkspacePath as parseWorkspacePath3
 } from "@bendyline/docblocks/filesystem";
 import {
@@ -2149,10 +2223,7 @@ async function writeRuntimeIfNeeded(provider, runtimePath) {
   if (current !== PLAYER_BUNDLE) await writeProviderText(provider, runtimePath, PLAYER_BUNDLE);
 }
 async function renderPlainOutsideInHtml(provider, layout, markdown, themeId) {
-  const [{ parseMarkdown }, { markdownDocToPlainHtml }] = await Promise.all([
-    import("@bendyline/squisq/markdown"),
-    import("@bendyline/squisq-formats/html")
-  ]);
+  const { markdownDocToPlainHtml } = await import("@bendyline/squisq-formats/html");
   const container = new FileSystemContentContainer(provider, layout.companionDirectory);
   const images = /* @__PURE__ */ new Map();
   for (const entry of await container.listFiles()) {
@@ -2161,7 +2232,7 @@ async function renderPlainOutsideInHtml(provider, layout, markdown, themeId) {
     images.set(`./${entry.path}`, outputPath);
   }
   return new TextEncoder().encode(
-    markdownDocToPlainHtml(parseMarkdown(markdown), {
+    markdownDocToPlainHtml(markdown, {
       title: layout.stem,
       images: images.size > 0 ? images : void 0,
       ...themeId ? { themeId } : {}
@@ -2171,9 +2242,22 @@ async function renderPlainOutsideInHtml(provider, layout, markdown, themeId) {
 async function prepareOutsideInRender(provider, layout, markdown, render) {
   const themeId = await resolveFallbackRenderTheme(markdown, render);
   const htmlOutput = layout.format === "html" ? await readOutsideInHtmlOutput(markdown) : null;
+  let renderedSource = markdown;
+  if (layout.format === "html") {
+    const { parseMarkdown, resolveWikiLinks } = await import("@bendyline/squisq/markdown");
+    renderedSource = await resolveWikiLinks(parseMarkdown(markdown), async (target) => {
+      const article = await findWikiArticle(provider, layout.targetPath, target, ".html");
+      return article.exists ? article.relativePath.split("/").map(encodeURIComponent).join("/") : null;
+    });
+  }
   if (htmlOutput === "static") {
     return {
-      bytes: await renderPlainOutsideInHtml(provider, layout, markdown, themeId),
+      bytes: await renderPlainOutsideInHtml(
+        provider,
+        layout,
+        renderedSource,
+        themeId
+      ),
       runtimePath: null
     };
   }
@@ -2181,7 +2265,7 @@ async function prepareOutsideInRender(provider, layout, markdown, render) {
   const outputDirectory = dirname(layout.targetPath);
   const rendered = await renderOutsideInDocument(
     {
-      markdown,
+      markdown: renderedSource,
       targetPath: layout.targetPath,
       container: new FileSystemContentContainer(provider, layout.companionDirectory)
     },
@@ -2416,6 +2500,10 @@ var NEW_ITEM_HINT_ID = "db-new-item-hint";
 function normalisePath2(path) {
   return parseWorkspacePath4(path);
 }
+function readIssueText(issue) {
+  const failingPath = tryParseWorkspacePath2(issue.path);
+  return failingPath && failingPath !== issue.directoryPath ? `${failingPath}: ${issue.message}` : issue.message;
+}
 function hasEquivalentPath2(paths, path) {
   const canonical = normalisePath2(path);
   return paths.has(path) || paths.has(canonical) || canonical !== "" && paths.has(`/${canonical}`);
@@ -2880,7 +2968,7 @@ function FileExplorer({
                 role: "alert",
                 "data-directory-path": childIssue.directoryPath,
                 children: [
-                  /* @__PURE__ */ jsx5("span", { children: childIssue.message }),
+                  /* @__PURE__ */ jsx5("span", { children: readIssueText(childIssue) }),
                   " ",
                   /* @__PURE__ */ jsx5(
                     "button",
@@ -3161,7 +3249,7 @@ function FileExplorer({
             role: "alert",
             "data-directory-path": tree.rootIssue.directoryPath,
             children: [
-              /* @__PURE__ */ jsx5("span", { children: tree.rootIssue.message }),
+              /* @__PURE__ */ jsx5("span", { children: readIssueText(tree.rootIssue) }),
               " ",
               /* @__PURE__ */ jsx5(
                 "button",
@@ -3686,13 +3774,15 @@ import {
   FileSystemContentContainer as FileSystemContentContainer2,
   createFileMediaProvider,
   decodeUtf8Text,
-  FsError as FsError5,
-  getFileSystemProviderV2 as getFileSystemProviderV210,
+  FsError as FsError6,
+  getFileSystemProviderV2 as getFileSystemProviderV211,
   isQuotaExceededError,
   moveFileSystemEntry as moveFileSystemEntry2,
   rewriteCompanionReferences,
   parseWorkspacePath as parseWorkspacePath8,
-  workspacePathContains
+  workspacePathContains,
+  findWikiArticle as findWikiArticle2,
+  suggestWikiArticles
 } from "@bendyline/docblocks/filesystem";
 import {
   createFileSystemDocumentTarget as createFileSystemDocumentTarget2,
@@ -3715,12 +3805,14 @@ import {
   getWorkspace,
   listWorkspaces as listWorkspaces2,
   reconcileElectronWorkspaceDescriptors,
-  removeWorkspace,
-  saveWorkspace as saveWorkspace2,
+  removeWorkspace as removeWorkspace2,
+  saveWorkspace as saveWorkspace3,
   touchWorkspace as touchWorkspace2,
   registerTransientWorkspace,
   getTransientWorkspace,
-  unregisterTransientWorkspace
+  unregisterTransientWorkspace,
+  appendWorkspaceBackup,
+  finishWorkspaceBackup
 } from "@bendyline/docblocks/workspace";
 
 // src/AppMenu/AppMenu.tsx
@@ -4077,6 +4169,7 @@ function AppMenu({
   onVersioningPreferenceChange,
   onOpenWorkspaceSettings,
   onDownloadAllWorkspaces,
+  onRestoreBackup,
   onShowKeyboardShortcuts,
   onKeepBrowserData,
   onInstallApp,
@@ -4211,7 +4304,7 @@ function AppMenu({
                 children: "Install DocBlocks\u2026"
               }
             ),
-            (onDownloadAllWorkspaces || onKeepBrowserData) && /* @__PURE__ */ jsx8("div", { className: "db-app-menu-divider" }),
+            (onDownloadAllWorkspaces || onRestoreBackup || onKeepBrowserData) && /* @__PURE__ */ jsx8("div", { className: "db-app-menu-divider" }),
             onDownloadAllWorkspaces && /* @__PURE__ */ jsx8(
               "button",
               {
@@ -4222,6 +4315,16 @@ function AppMenu({
                 children: "Back up all workspaces"
               }
             ),
+            onRestoreBackup && /* @__PURE__ */ jsx8(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(onRestoreBackup),
+                children: "Restore backup\u2026"
+              }
+            ),
             onKeepBrowserData && /* @__PURE__ */ jsx8(
               "button",
               {
@@ -4473,6 +4576,59 @@ function AppMenu({
   ] });
 }
 
+// src/DocBlocksShell/restore-backup.ts
+import {
+  readWorkspaceBackup,
+  restoreWorkspaceBackup,
+  WORKSPACE_BACKUP_LIMITS,
+  saveWorkspace as saveWorkspace2,
+  removeWorkspace
+} from "@bendyline/docblocks/workspace";
+async function restoreBrowserBackup(file) {
+  if (file.size > 256 * 1024 * 1024) throw new Error("Backup ZIPs must be smaller than 256 MiB.");
+  const { zipToContainer } = await import("@bendyline/squisq-formats/container");
+  const container = await zipToContainer(await file.arrayBuffer(), WORKSPACE_BACKUP_LIMITS);
+  const workspaces = await readWorkspaceBackup(
+    container,
+    file.name.replace(/\.zip$/i, "") || "Workspace"
+  );
+  const { IndexedDBFileSystemProvider, deleteIndexedDBWorkspaceData } = await import("@bendyline/docblocks/filesystem/indexeddb");
+  const staged = [];
+  try {
+    for (const workspace of workspaces) {
+      const descriptor = {
+        id: `restored-${crypto.randomUUID()}`,
+        name: `${workspace.name.slice(0, 1013)} (restored)`,
+        type: "indexeddb",
+        lastOpened: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      const provider = new IndexedDBFileSystemProvider(descriptor.id, descriptor.name).v2;
+      staged.push({ descriptor, provider });
+      await restoreWorkspaceBackup(workspace, provider);
+    }
+    for (const { descriptor } of staged) await saveWorkspace2(descriptor);
+    return staged.map(({ descriptor }) => descriptor);
+  } catch (error) {
+    const failures = [error];
+    for (const { descriptor, provider } of staged) {
+      try {
+        await provider.dispose();
+        await removeWorkspace(descriptor.id);
+        await deleteIndexedDBWorkspaceData(descriptor.id);
+      } catch (cleanupError) {
+        failures.push(cleanupError);
+      }
+    }
+    if (failures.length > 1)
+      throw new Error(
+        `Restore failed; temporary workspace cleanup also failed. ${failures.map((failure) => failure instanceof Error ? failure.message : String(failure)).join("; ")}`
+      );
+    throw error;
+  } finally {
+    for (const { provider } of staged) await provider.dispose();
+  }
+}
+
 // src/WorkspacePicker/WorkspaceSettingsButton.tsx
 import { useState as useState8, useCallback as useCallback9, useRef as useRef9, useEffect as useEffect9 } from "react";
 import { jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
@@ -4995,7 +5151,7 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx12 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-A2YBKUUD.js").then((module) => ({
+  () => import("./ExportToolbarControls-HOV424TO.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -5565,7 +5721,7 @@ function resolveShellEditorLinkTarget(href, documentPath) {
     targetSegments.push(segment);
   }
   const path = targetSegments.join("/");
-  if (!path || path.length > HOST_WIRE_LIMITS2.pathCharacters || !isMarkdownFileName(path)) {
+  if (!path || path.length > HOST_WIRE_LIMITS2.pathCharacters || !isMarkdownFileName(path) && !/\.html?$/i.test(path)) {
     return null;
   }
   return { kind: "workspace", path };
@@ -5588,10 +5744,36 @@ function hasControlCharacter(value) {
   return false;
 }
 
-// src/DocBlocksShell/import-files.ts
+// src/DocBlocksShell/wiki-articles.ts
 import {
+  ensureWikiArticle,
+  wikiArticleExists,
   FsError as FsError4,
-  getFileSystemProviderV2 as getFileSystemProviderV27,
+  getFileSystemProviderV2 as getFileSystemProviderV27
+} from "@bendyline/docblocks/filesystem";
+function wikiArticleExtension(format) {
+  return newFileHtmlOutput(format) ? ".html" : ".md";
+}
+async function ensureShellWikiArticle(provider, path, format, render) {
+  if (!/\.html?$/i.test(path)) return ensureWikiArticle(provider, path);
+  if (await wikiArticleExists(provider, path)) return false;
+  if (!getFileSystemProviderV27(provider)) {
+    throw new FsError4("not-supported", "This workspace cannot create articles safely.");
+  }
+  try {
+    await createNewOutsideInDocument(provider, path, newFileHtmlOutput(format), render);
+    return true;
+  } catch (error) {
+    if (error instanceof FsError4 && (error.code === "already-exists" || error.code === "conflict") && await wikiArticleExists(provider, path))
+      return false;
+    throw error;
+  }
+}
+
+// src/DocBlocksShell/import-files.ts
+import {
+  FsError as FsError5,
+  getFileSystemProviderV2 as getFileSystemProviderV28,
   parseWorkspacePath as parseWorkspacePath6
 } from "@bendyline/docblocks/filesystem";
 var MAX_NAME_ATTEMPTS = 100;
@@ -5602,7 +5784,7 @@ function withCopySuffix(path, n) {
   return `${path.slice(0, dot)} (${n})${path.slice(dot)}`;
 }
 function isAlreadyExists(error) {
-  return error instanceof FsError4 && error.code === "already-exists";
+  return error instanceof FsError5 && error.code === "already-exists";
 }
 async function claimAvailablePath(provider, desiredPath) {
   for (let attempt = 1; attempt <= MAX_NAME_ATTEMPTS; attempt++) {
@@ -5617,7 +5799,7 @@ async function claimAvailablePath(provider, desiredPath) {
   throw new Error(`Too many documents are already named like \u201C${desiredPath}\u201D.`);
 }
 async function writeProviderBytes(provider, path, data, mode) {
-  const providerV2 = getFileSystemProviderV27(provider);
+  const providerV2 = getFileSystemProviderV28(provider);
   if (providerV2) {
     await providerV2.writeFile(parseWorkspacePath6(path), data, {
       mode,
@@ -5627,7 +5809,7 @@ async function writeProviderBytes(provider, path, data, mode) {
     return;
   }
   if (mode === "create" && await providerEntryExists(provider, path)) {
-    throw new FsError4("already-exists", "File already exists.", { operation: "write", path });
+    throw new FsError5("already-exists", "File already exists.", { operation: "write", path });
   }
   await provider.writeBinary(path, data);
 }
@@ -5660,7 +5842,7 @@ function directoriesUnder(files, root) {
   return [...directories].sort((a, b) => b.split("/").length - a.split("/").length);
 }
 async function removeIfEmptyDirectory(provider, path) {
-  const providerV2 = getFileSystemProviderV27(provider);
+  const providerV2 = getFileSystemProviderV28(provider);
   if (!providerV2) return;
   await providerV2.remove(parseWorkspacePath6(path), { recursive: false, missing: "ignore" }).catch(() => void 0);
 }
@@ -6038,7 +6220,7 @@ function resolveShellTheme({
 }
 
 // src/DocBlocksShell/last-state.ts
-import { tryParseWorkspacePath as tryParseWorkspacePath2 } from "@bendyline/docblocks/filesystem";
+import { tryParseWorkspacePath as tryParseWorkspacePath3 } from "@bendyline/docblocks/filesystem";
 var LAST_STATE_KEY = "docblocks:lastState";
 var MAX_WORKSPACE_ID_CHARACTERS = 256;
 var MAX_WORKSPACE_PATH_CHARACTERS = 4096;
@@ -6059,7 +6241,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 = tryParseWorkspacePath2(record.filePath);
+  const parsedPath = tryParseWorkspacePath3(record.filePath);
   if (!parsedPath) return null;
   if (typeof record.view !== "string" || !EDITOR_VIEWS.has(record.view)) return null;
   return {
@@ -6853,7 +7035,7 @@ function useDocumentLinkProvider(index, selectedFile, ensureIndex) {
 
 // src/WorkspaceIndex/useWorkspaceIndex.ts
 import { useCallback as useCallback17, useEffect as useEffect28, useMemo as useMemo5, useRef as useRef18, useState as useState22, useSyncExternalStore as useSyncExternalStore4 } from "react";
-import { getFileSystemProviderV2 as getFileSystemProviderV28 } from "@bendyline/docblocks/filesystem";
+import { getFileSystemProviderV2 as getFileSystemProviderV29 } from "@bendyline/docblocks/filesystem";
 import { maybeGetDocBlocksHost as maybeGetDocBlocksHost3 } from "@bendyline/docblocks/host";
 var IDLE_WORKSPACE_INDEX_STATUS = Object.freeze({
   phase: "idle",
@@ -6883,7 +7065,7 @@ function whenIdle(callback) {
   return () => clearTimeout(handle);
 }
 function useWorkspaceIndex(provider, workspaceId, mode = "eager") {
-  const providerV2 = provider && mode !== "off" ? getFileSystemProviderV28(provider) : null;
+  const providerV2 = provider && mode !== "off" ? getFileSystemProviderV29(provider) : null;
   const [index, setIndex] = useState22(null);
   const startRequestedRef = useRef18(false);
   useEffect28(() => {
@@ -6946,7 +7128,7 @@ function useWorkspaceIndex(provider, workspaceId, mode = "eager") {
 }
 
 // src/WorkspaceIndex/recent-documents.ts
-import { tryParseWorkspacePath as tryParseWorkspacePath3 } from "@bendyline/docblocks/filesystem";
+import { tryParseWorkspacePath as tryParseWorkspacePath4 } from "@bendyline/docblocks/filesystem";
 var RECENT_DOCUMENTS_STORAGE_KEY = "docblocks:recentDocuments:v1";
 var MAX_PATHS_PER_WORKSPACE = 50;
 var MAX_WORKSPACES = 50;
@@ -6965,7 +7147,7 @@ function defaultStorage() {
 }
 function canonicalPath(path) {
   if (path.length === 0 || path.length > MAX_PATH_LENGTH) return null;
-  return tryParseWorkspacePath3(path) || null;
+  return tryParseWorkspacePath4(path) || null;
 }
 function parseRecentDocuments(value) {
   const parsed = /* @__PURE__ */ new Map();
@@ -7071,14 +7253,14 @@ var WorkspaceAuthorityBarrier = class {
 
 // src/DocBlocksShell/transient-workspace-move.ts
 import {
-  getFileSystemProviderV2 as getFileSystemProviderV29
+  getFileSystemProviderV2 as getFileSystemProviderV210
 } from "@bendyline/docblocks/filesystem";
 function pathDepth(path) {
   return path ? path.split("/").length : 0;
 }
 async function copyTransientWorkspaceContents(source, destination) {
-  const sourceV2 = getFileSystemProviderV29(source);
-  const destinationV2 = getFileSystemProviderV29(destination);
+  const sourceV2 = getFileSystemProviderV210(source);
+  const destinationV2 = getFileSystemProviderV210(destination);
   if (!sourceV2 || !destinationV2) {
     throw new Error("Moving a temporary document requires a current workspace provider.");
   }
@@ -7243,13 +7425,13 @@ function loadEditorShell() {
   return editorShellModulePromise;
 }
 var EditorShell = lazy2(loadEditorShell);
-var DocumentConflictDialog = lazy2(() => import("./DocumentConflictDialog-5LRVIGXS.js"));
-var GitUI = lazy2(() => import("./GitUI-RCWUZVS6.js").then((m) => ({ default: m.GitUI })));
+var DocumentConflictDialog = lazy2(() => import("./DocumentConflictDialog-DZ2BV2IH.js"));
+var GitUI = lazy2(() => import("./GitUI-F3CNBURE.js").then((m) => ({ default: m.GitUI })));
 var QuickOpenDialog = lazy2(
-  () => import("./QuickOpenDialog-2KK4SEBU.js").then((m) => ({ default: m.QuickOpenDialog }))
+  () => import("./QuickOpenDialog-ENVFGIHS.js").then((m) => ({ default: m.QuickOpenDialog }))
 );
 var KeyboardShortcutsDialog = lazy2(
-  () => import("./KeyboardShortcutsDialog-G5OBDTNR.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
+  () => import("./KeyboardShortcutsDialog-HVKDFP5Z.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
 );
 var WorkspaceSearchPanel = lazy2(
   () => import("./WorkspaceSearchPanel-J6BKEZQJ.js").then((m) => ({
@@ -7263,37 +7445,37 @@ var GitToolbarControl = lazy2(
   () => import("./GitToolbarControl-B7KG4MFP.js").then((m) => ({ default: m.GitToolbarControl }))
 );
 var AiToolbarControl = lazy2(
-  () => import("./AiEditorAssistant-YLJ5OZK2.js").then((module) => ({
+  () => import("./AiEditorAssistant-4HFFGVU4.js").then((module) => ({
     default: module.AiToolbarControl
   }))
 );
 var PresentationMaker = lazy2(
-  () => import("./PresentationMaker-P2JP6UUX.js").then((module) => ({
+  () => import("./PresentationMaker-MUMFAXEI.js").then((module) => ({
     default: module.PresentationMaker
   }))
 );
 var AiReviewPanel = lazy2(
-  () => import("./AiEditorAssistant-YLJ5OZK2.js").then((module) => ({
+  () => import("./AiEditorAssistant-4HFFGVU4.js").then((module) => ({
     default: module.AiReviewPanel
   }))
 );
 var AiIllustratePanel = lazy2(
-  () => import("./AiDiagrams-QE3LVYFK.js").then((module) => ({
+  () => import("./AiDiagrams-QZMJNGDT.js").then((module) => ({
     default: module.AiIllustratePanel
   }))
 );
 var TextFromNarration = lazy2(
-  () => import("./TextFromNarration-NITJQ4IB.js").then((module) => ({
+  () => import("./TextFromNarration-EYOMW2IW.js").then((module) => ({
     default: module.TextFromNarration
   }))
 );
 var SpeechToolbarControl = lazy2(
-  () => import("./SpeechToolbarControl-CLU7RB2G.js").then((module) => ({
+  () => import("./SpeechToolbarControl-KNI2C4JJ.js").then((module) => ({
     default: module.SpeechToolbarControl
   }))
 );
 var SpeechMenuBridge = lazy2(
-  () => import("./SpeechToolbarControl-CLU7RB2G.js").then((module) => ({
+  () => import("./SpeechToolbarControl-KNI2C4JJ.js").then((module) => ({
     default: module.SpeechMenuBridge
   }))
 );
@@ -7434,19 +7616,19 @@ function pathContains(parentPath2, candidatePath) {
   return workspacePathContains(parseWorkspacePath8(parentPath2), parseWorkspacePath8(candidatePath));
 }
 async function readProviderDirectory2(provider, path) {
-  const providerV2 = getFileSystemProviderV210(provider);
+  const providerV2 = getFileSystemProviderV211(provider);
   if (!providerV2) return provider.readDirectory(path);
   const entries = await providerV2.readDirectory(parseWorkspacePath8(path));
   return entries.map((entry) => ({ kind: entry.kind, name: entry.name, path: entry.path }));
 }
 async function readProviderText(provider, path) {
-  const providerV2 = getFileSystemProviderV210(provider);
+  const providerV2 = getFileSystemProviderV211(provider);
   if (!providerV2) return provider.readFile(path);
   const file = await providerV2.readFile(parseWorkspacePath8(path));
   return file ? decodeUtf8Text(file.data, { label: "The document", path: parseWorkspacePath8(path) }) : null;
 }
 async function pinnedProviderFileExists(provider, path) {
-  const providerV2 = getFileSystemProviderV210(provider);
+  const providerV2 = getFileSystemProviderV211(provider);
   if (!providerV2) return provider.exists(path);
   const entry = await providerV2.stat(parseWorkspacePath8(path));
   if (!entry) return false;
@@ -7454,7 +7636,7 @@ async function pinnedProviderFileExists(provider, path) {
   return true;
 }
 async function removePinnedProviderFile(provider, path) {
-  const providerV2 = getFileSystemProviderV210(provider);
+  const providerV2 = getFileSystemProviderV211(provider);
   if (providerV2) {
     const canonical = parseWorkspacePath8(path);
     const entry = await providerV2.stat(canonical);
@@ -7472,7 +7654,7 @@ async function removePinnedProviderFile(provider, path) {
   return true;
 }
 async function readStableFileSnapshot(provider, path) {
-  const providerV2 = getFileSystemProviderV210(provider);
+  const providerV2 = getFileSystemProviderV211(provider);
   if (providerV2) {
     const read2 = await providerV2.readFile(parseWorkspacePath8(path));
     return {
@@ -7516,7 +7698,7 @@ async function ensureHandleWritePermission(handle) {
   }
 }
 async function copyProviderToContainer(src, container, pathPrefix) {
-  const providerV2 = getFileSystemProviderV210(src);
+  const providerV2 = getFileSystemProviderV211(src);
   if (providerV2) {
     const snapshot = await providerV2.snapshot();
     for (const entry of snapshot.entries) {
@@ -7859,7 +8041,7 @@ function DocBlocksShell({
   const effectiveProofingIgnoreStore = proofingIgnoreStore === void 0 ? defaultProofingIgnoreStore : proofingIgnoreStore;
   useEffect29(() => {
     if (!provider || getTransientWorkspace(provider.id)) return;
-    const providerV2 = getFileSystemProviderV210(provider);
+    const providerV2 = getFileSystemProviderV211(provider);
     return providerV2 ? retainFileSystemProvider(providerV2) : void 0;
   }, [provider]);
   const [descriptorRefreshKey, setDescriptorRefreshKey] = useState23(0);
@@ -7947,7 +8129,7 @@ function DocBlocksShell({
     void scan();
     const scanOnFocus = () => void scan();
     window.addEventListener("focus", scanOnFocus);
-    const providerV2 = getFileSystemProviderV210(provider);
+    const providerV2 = getFileSystemProviderV211(provider);
     const subscription = providerV2?.capabilities.watch ? providerV2.watch(
       (event) => {
         if (event.type !== "modified") void scan();
@@ -8056,7 +8238,7 @@ function DocBlocksShell({
       if (descriptor && descriptor.versioningOverride !== void 0) {
         const moved = { ...descriptor };
         delete moved.versioningOverride;
-        await saveWorkspace2(moved);
+        await saveWorkspace3(moved);
         setDescriptorRefreshKey((k) => k + 1);
       }
     },
@@ -8153,7 +8335,13 @@ function DocBlocksShell({
         return {
           resolveTarget: (filename) => resolveTarget(documentId, filename),
           pickTarget: (filename, currentTarget) => pickTarget(documentId, filename, currentTarget?.grantId ?? null),
-          saveBlob: (blob, filename, target) => saveBlobToHost(exports, documentId, blob, filename, target?.grantId ?? null)
+          saveBlob: (blob, filename, target) => saveBlobToHost(exports, documentId, blob, filename, target?.grantId ?? null),
+          ...hostSupports2("openSavedExports") && exports.openSaved ? {
+            openSaved: async (target) => {
+              if (!target.grantId) throw new Error("The saved export has no native target.");
+              await exports.openSaved(documentId, target.grantId);
+            }
+          } : {}
         };
       }
     }
@@ -8212,7 +8400,7 @@ function DocBlocksShell({
   const workspaceOutputsResult = workspaceOutputs.status.result;
   useEffect29(() => {
     if (!workspaceOutputsResult?.outputs.some((output) => output.created)) return;
-    if (provider && getFileSystemProviderV210(provider)?.capabilities.watch) return;
+    if (provider && getFileSystemProviderV211(provider)?.capabilities.watch) return;
     setExplorerKey((key) => key + 1);
   }, [provider, workspaceOutputsResult]);
   const [fileExplorerSortMode, setFileExplorerSortMode] = useState23(loadFileExplorerSortMode);
@@ -8515,7 +8703,7 @@ function DocBlocksShell({
         }
         return fsProvider;
       } finally {
-        if (!transient && !adopted) await getFileSystemProviderV210(fsProvider)?.dispose();
+        if (!transient && !adopted) await getFileSystemProviderV211(fsProvider)?.dispose();
       }
     },
     [adoptSelectedDocument, createDocumentTarget, documentSession, pushHash]
@@ -8567,7 +8755,7 @@ function DocBlocksShell({
           )
         });
       } catch (error) {
-        await getFileSystemProviderV210(mem)?.dispose();
+        await getFileSystemProviderV211(mem)?.dispose();
         throw error;
       }
       return adoptTransientWorkspace({
@@ -8613,7 +8801,7 @@ function DocBlocksShell({
       try {
         await writeProviderText(fs, welcomePath, welcomeContent, "create");
       } catch (error) {
-        if (!(error instanceof FsError5 && error.code === "already-exists")) throw error;
+        if (!(error instanceof FsError6 && error.code === "already-exists")) throw error;
         const existing = await readProviderText(fs, welcomePath);
         if (existing === null) throw error;
         seededContent = existing;
@@ -8669,8 +8857,8 @@ function DocBlocksShell({
             getDocBlocksHost().env.platform,
             (/* @__PURE__ */ new Date()).toISOString()
           );
-          for (const id of reconciliation.removeIds) await removeWorkspace(id);
-          for (const workspace of reconciliation.upsert) await saveWorkspace2(workspace);
+          for (const id of reconciliation.removeIds) await removeWorkspace2(id);
+          for (const workspace of reconciliation.upsert) await saveWorkspace3(workspace);
           workspaceIdRemap = reconciliation.idRemap;
           for (const workspace of hostWorkspaces) {
             if (workspace.isDefault === true) defaultHostWorkspaceIds.add(workspace.id);
@@ -8763,12 +8951,12 @@ function DocBlocksShell({
           const p = await createHostProviderFromWorkspace(ws);
           if (!p) continue;
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           await touchWorkspace2(ws.id);
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           fsProvider = p;
@@ -8777,12 +8965,12 @@ function DocBlocksShell({
           const restored = await (await loadNativeFileSystem()).restoreNativeFolder(ws.id);
           if (restored) {
             if (!isCurrent()) {
-              await getFileSystemProviderV210(restored)?.dispose();
+              await getFileSystemProviderV211(restored)?.dispose();
               return;
             }
             await touchWorkspace2(ws.id);
             if (!isCurrent()) {
-              await getFileSystemProviderV210(restored)?.dispose();
+              await getFileSystemProviderV211(restored)?.dispose();
               return;
             }
             fsProvider = restored;
@@ -8791,12 +8979,12 @@ function DocBlocksShell({
         } else {
           const p = await createIndexedDbFileSystemProvider(ws.id, ws.name);
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           await touchWorkspace2(ws.id);
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           fsProvider = p;
@@ -8814,11 +9002,11 @@ function DocBlocksShell({
             rootPath: info.rootPath,
             lastOpened: (/* @__PURE__ */ new Date()).toISOString()
           };
-          await saveWorkspace2(descriptor);
+          await saveWorkspace3(descriptor);
           if (!isCurrent()) return;
           const p = await createHostFileSystemProvider(info.id, info.name, info.rootPath);
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           fsProvider = p;
@@ -8827,7 +9015,7 @@ function DocBlocksShell({
           if (!isCurrent()) return;
           const p = await createIndexedDbFileSystemProvider(defaultWs.id, defaultWs.name);
           if (!isCurrent()) {
-            await getFileSystemProviderV210(p)?.dispose();
+            await getFileSystemProviderV211(p)?.dispose();
             return;
           }
           fsProvider = p;
@@ -8848,7 +9036,7 @@ function DocBlocksShell({
         setActiveWorkspaceId(fsProvider.id);
         adopted = true;
       } finally {
-        if (!adopted) await getFileSystemProviderV210(fsProvider)?.dispose();
+        if (!adopted) await getFileSystemProviderV211(fsProvider)?.dispose();
       }
     })().catch(() => {
       if (isCurrent()) {
@@ -9101,7 +9289,7 @@ function DocBlocksShell({
   }, [selectedFile, selectedManagedOutput, workspaceOutputsResult]);
   useEffect29(() => {
     if (!provider) return;
-    const providerV2 = getFileSystemProviderV210(provider);
+    const providerV2 = getFileSystemProviderV211(provider);
     const lifecycle = maybeGetDocBlocksHost4()?.lifecycle;
     if (!providerV2 || !providerV2.capabilities.watch && !lifecycle?.onResume && !managedOutputRefreshToken)
       return;
@@ -9499,7 +9687,7 @@ function DocBlocksShell({
       } finally {
         if (nextProvider && ownsNextProvider && !adoptedNextProvider) {
           try {
-            await getFileSystemProviderV210(nextProvider)?.dispose();
+            await getFileSystemProviderV211(nextProvider)?.dispose();
           } catch {
           }
         }
@@ -9605,14 +9793,14 @@ function DocBlocksShell({
           }
         }
         try {
-          await removeWorkspace(activeWorkspaceId);
+          await removeWorkspace2(activeWorkspaceId);
         } catch {
         }
         setDescriptorRefreshKey((key) => key + 1);
       } catch (error) {
         if (destinationProvider && !adoptedDestination) {
           try {
-            await getFileSystemProviderV210(destinationProvider)?.dispose();
+            await getFileSystemProviderV211(destinationProvider)?.dispose();
           } catch {
           }
         }
@@ -9647,7 +9835,7 @@ function DocBlocksShell({
           rootPath: info.rootPath,
           lastOpened: (/* @__PURE__ */ new Date()).toISOString()
         };
-        await saveWorkspace2(descriptor2);
+        await saveWorkspace3(descriptor2);
         if (requestId !== navigationRequestRef.current) return;
         const provider2 = await createHostFileSystemProvider(info.id, info.name, info.rootPath);
         if (!await transitionAwayFromDocument(requestId)) return;
@@ -9667,7 +9855,7 @@ function DocBlocksShell({
         type: "native",
         lastOpened: (/* @__PURE__ */ new Date()).toISOString()
       };
-      await saveWorkspace2(descriptor);
+      await saveWorkspace3(descriptor);
       if (requestId !== navigationRequestRef.current) return;
       if (!await transitionAwayFromDocument(requestId)) return;
       setProvider(nativeProvider);
@@ -9690,7 +9878,7 @@ function DocBlocksShell({
           rootPath: info.rootPath,
           lastOpened: (/* @__PURE__ */ new Date()).toISOString()
         };
-        await saveWorkspace2(descriptor);
+        await saveWorkspace3(descriptor);
         if (requestId !== navigationRequestRef.current) return;
         const cloneProvider = await createHostFileSystemProvider(info.id, info.name, info.rootPath);
         if (!await transitionAwayFromDocument(requestId)) return;
@@ -9718,12 +9906,12 @@ function DocBlocksShell({
           if (requestId !== navigationRequestRef.current) return null;
           if (format === "markdown") {
             const content = "# " + filename.replace(/\.[^.]+$/, "") + "\n";
-            const providerV2 = getFileSystemProviderV210(provider);
+            const providerV2 = getFileSystemProviderV211(provider);
             if (providerV2) {
               try {
                 await writeProviderText(provider, path, content, "create");
               } catch (error) {
-                if (error instanceof FsError5 && error.code === "already-exists") {
+                if (error instanceof FsError6 && error.code === "already-exists") {
                   throw new Error("A document with that name already exists.");
                 }
                 throw error;
@@ -9822,7 +10010,7 @@ function DocBlocksShell({
     }
     const path = `/${folderName}`;
     try {
-      const providerV2 = getFileSystemProviderV210(provider);
+      const providerV2 = getFileSystemProviderV211(provider);
       if (providerV2) {
         await providerV2.createDirectory(parseWorkspacePath8(path), { mode: "create" });
       } else {
@@ -9832,7 +10020,7 @@ function DocBlocksShell({
         await provider.createDirectory(path);
       }
     } catch (error) {
-      const message = error instanceof FsError5 && error.code === "already-exists" ? "A file or folder with that name already exists." : error instanceof Error ? error.message : "Could not create the folder.";
+      const message = error instanceof FsError6 && error.code === "already-exists" ? "A file or folder with that name already exists." : error instanceof Error ? error.message : "Could not create the folder.";
       showToast("error", message);
       return;
     }
@@ -10058,7 +10246,7 @@ function DocBlocksShell({
     });
   }, [handleNewFile, handleOpenFolder, handleRevealWorkspace, acknowledge, openFind]);
   const handleSelect = useCallback18(
-    async (path, kind) => {
+    async (path, kind, createWikiArticle = false) => {
       if (!provider || !activeWorkspaceId) return;
       const requestId = ++navigationRequestRef.current;
       if (kind === "directory") {
@@ -10075,6 +10263,17 @@ function DocBlocksShell({
         try {
           const transitioned = await documentSession.transitionWithLoad(async () => {
             if (requestId !== navigationRequestRef.current) return null;
+            if (createWikiArticle) {
+              if (await ensureShellWikiArticle(
+                provider,
+                parseWorkspacePath8(path),
+                defaultNewFileFormat,
+                outsideInRenderRef.current
+              )) {
+                notifyWorkspaceChanged(activeWorkspaceId, path);
+              }
+              if (requestId !== navigationRequestRef.current) return null;
+            }
             openedDocument = await loadEditableShellDocument(
               provider,
               path,
@@ -10126,9 +10325,72 @@ function DocBlocksShell({
       documentSession,
       notifyWorkspaceChanged,
       transitionAwayFromDocument,
-      showToast
+      showToast,
+      defaultNewFileFormat
     ]
   );
+  const wikiNavigationRef = useRef19(handleSelect);
+  wikiNavigationRef.current = handleSelect;
+  const wikiLinks = useMemo6(() => {
+    if (!provider || !selectedFile || !activeWorkspaceId) return null;
+    const source = selectedFile;
+    const extension = wikiArticleExtension(defaultNewFileFormat);
+    const lookups = /* @__PURE__ */ new Map();
+    let queue = Promise.resolve();
+    const lookup = (target) => {
+      let result = lookups.get(target);
+      if (!result) {
+        result = queue.then(() => findWikiArticle2(provider, source, target, extension));
+        queue = result.then(
+          () => void 0,
+          () => void 0
+        );
+        lookups.set(target, result);
+      }
+      return result;
+    };
+    return {
+      async suggest(query) {
+        const index = workspaceIndex.index;
+        if (!index) return [];
+        workspaceIndex.ensure();
+        await index.whenListed({ timeoutMs: 5e3 });
+        return suggestWikiArticles(
+          index.getFiles(),
+          index.getDirectories(),
+          source,
+          query,
+          extension
+        );
+      },
+      async exists(target) {
+        return (await lookup(target)).exists;
+      },
+      async resolve(target) {
+        const article = await lookup(target);
+        if (!article.exists) return null;
+        const href = selectedSourceFile !== selectedFile ? `/${article.path}` : article.relativePath;
+        return href.split("/").map(encodeURIComponent).join("/");
+      },
+      async open(target, { create }) {
+        const requestId = navigationRequestRef.current;
+        const navigate = wikiNavigationRef.current;
+        const { path } = await lookup(target);
+        if (requestId !== navigationRequestRef.current || navigate !== wikiNavigationRef.current)
+          return;
+        await navigate(path, "file", create);
+      }
+    };
+  }, [
+    provider,
+    selectedFile,
+    selectedSourceFile,
+    activeWorkspaceId,
+    defaultNewFileFormat,
+    workspaceIndex.index,
+    workspaceIndex.ensure,
+    workspaceIndex.status.generation
+  ]);
   const handleEnableOutsideInEditing = useCallback18(
     async (path) => {
       if (!provider || !activeWorkspaceId) {
@@ -10256,7 +10518,7 @@ function DocBlocksShell({
       if (!target) {
         showToast(
           "error",
-          "DocBlocks only opens HTTP(S) links or Markdown files inside this workspace."
+          "DocBlocks only opens HTTP(S) links or Markdown and HTML files inside this workspace."
         );
         return true;
       }
@@ -10274,14 +10536,14 @@ function DocBlocksShell({
         if (!provider) return;
         try {
           if (!await providerEntryExists(provider, target.path)) {
-            showToast("error", "The linked Markdown file was not found in this workspace.");
+            showToast("error", "The linked document 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."
+            error instanceof Error ? error.message : "Could not open the linked document."
           );
         }
       })();
@@ -10555,7 +10817,7 @@ function DocBlocksShell({
       } finally {
         if (access.owned) {
           try {
-            await getFileSystemProviderV210(access.provider)?.dispose();
+            await getFileSystemProviderV211(access.provider)?.dispose();
           } catch {
           }
         }
@@ -10624,7 +10886,7 @@ function DocBlocksShell({
       } finally {
         if (access.owned) {
           try {
-            await getFileSystemProviderV210(access.provider)?.dispose();
+            await getFileSystemProviderV211(access.provider)?.dispose();
           } catch {
           }
         }
@@ -10642,32 +10904,73 @@ function DocBlocksShell({
       showToast
     ]
   );
+  const restoreInputRef = useRef19(null);
+  const restoreInProgress = useRef19(false);
+  const handleRestoreBackup = useCallback18(
+    async (file) => {
+      if (restoreInProgress.current) {
+        showToast("error", "A backup is already being restored. Please wait.");
+        return;
+      }
+      restoreInProgress.current = true;
+      try {
+        await documentSession.flush("backup");
+        const restored = await restoreBrowserBackup(file);
+        setDescriptorRefreshKey((key) => key + 1);
+        if (restored[0]) await handleWorkspaceSelect(restored[0]);
+        showToast(
+          "success",
+          `Restored ${restored.length} workspace(s) as new copies. Your existing workspaces are unchanged.`
+        );
+      } catch (error) {
+        showToast(
+          "error",
+          `Could not restore ${file.name}: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
+      } finally {
+        restoreInProgress.current = false;
+      }
+    },
+    [documentSession, handleWorkspaceSelect, showToast]
+  );
+  const importOrRestore = useCallback18(
+    async (files) => {
+      const backups = hostSupports2("nativeWorkspaces") ? [] : files.filter((file) => /\.zip$/i.test(file.name));
+      const documents = files.filter((file) => !backups.includes(file));
+      const result = provider ? await importDroppedFiles(documents, provider) : null;
+      for (const file of backups) await handleRestoreBackup(file);
+      return result;
+    },
+    [handleRestoreBackup, provider]
+  );
   const handleImportFiles = useCallback18(
     async (files) => {
       if (!provider) return;
-      const result = await importDroppedFiles(files, provider);
+      const result = await importOrRestore(files);
+      if (!result) return;
       notifyWorkspaceChanged(activeWorkspaceId);
       setExplorerKey((k) => k + 1);
       const summary = summariseImport(result);
       if (summary) showToast(summary.kind, summary.message);
     },
-    [activeWorkspaceId, notifyWorkspaceChanged, provider, showToast]
+    [activeWorkspaceId, notifyWorkspaceChanged, provider, showToast, importOrRestore]
   );
   const handleImportFilesToEditor = useCallback18(
     async (files) => {
       if (!provider) return;
-      const result = await importDroppedFiles(files, provider);
+      const result = await importOrRestore(files);
+      if (!result) return;
       notifyWorkspaceChanged(activeWorkspaceId);
       setExplorerKey((k) => k + 1);
       const summary = summariseImport(result);
       if (summary) showToast(summary.kind, summary.message);
       const imported = result.imported;
-      if (imported.length === 1 && result.failed.length === 0) {
+      if (imported.length === 1 && result.failed.length === 0 && !files.some((file) => /\.zip$/i.test(file.name))) {
         const only = imported[0];
         if (only) void handleSelect(only.path, "file");
       }
     },
-    [activeWorkspaceId, notifyWorkspaceChanged, provider, showToast, handleSelect]
+    [activeWorkspaceId, notifyWorkspaceChanged, provider, showToast, handleSelect, importOrRestore]
   );
   const editorDropActive = useEditorFileDrop(
     editorAreaRef,
@@ -10695,7 +10998,7 @@ function DocBlocksShell({
       confirmLabel: "Rename"
     });
     if (!newName || newName === ws.name) return;
-    await saveWorkspace2({ ...ws, name: newName });
+    await saveWorkspace3({ ...ws, name: newName });
     setPinnedDocuments(
       (current) => renamePinnedDocumentWorkspace(current, activeWorkspaceId, newName)
     );
@@ -10721,7 +11024,7 @@ function DocBlocksShell({
         throw error;
       }
       if (!isCurrent()) {
-        await getFileSystemProviderV210(mem)?.dispose();
+        await getFileSystemProviderV211(mem)?.dispose();
         await revokeAbandonedResource();
         return;
       }
@@ -10769,7 +11072,7 @@ function DocBlocksShell({
       } finally {
         try {
           if (!adoptionStarted) {
-            await getFileSystemProviderV210(mem)?.dispose();
+            await getFileSystemProviderV211(mem)?.dispose();
           }
         } finally {
           if (!opened) await revokeAbandonedResource();
@@ -10840,7 +11143,7 @@ function DocBlocksShell({
           push: true
         });
       } finally {
-        if (!adoptionStarted) await getFileSystemProviderV210(mem)?.dispose();
+        if (!adoptionStarted) await getFileSystemProviderV211(mem)?.dispose();
       }
     },
     [adoptTransientWorkspace]
@@ -10870,8 +11173,11 @@ function DocBlocksShell({
         import("@bendyline/squisq-formats/container")
       ]);
       const container = new MemoryContentContainer();
-      await copyProviderToContainer(provider, container, "");
-      const blob = await containerToZip(container);
+      const source = getFileSystemProviderV211(provider);
+      if (!source) throw new Error("This workspace does not support complete backups.");
+      const workspaces = await appendWorkspaceBackup(container, source, []);
+      await finishWorkspaceBackup(container, workspaces);
+      const blob = await containerToZip(container, { compression: "STORE" });
       const url = URL.createObjectURL(blob);
       const a = document.createElement("a");
       a.href = url;
@@ -10880,8 +11186,7 @@ function DocBlocksShell({
       a.click();
       URL.revokeObjectURL(url);
     } catch (err) {
-      console.error("Failed to download workspace", err);
-      showToast("error", "Failed to download workspace. See console for details.");
+      showToast("error", err instanceof Error ? err.message : "Failed to download workspace.");
     }
   }, [provider, documentSession, showToast]);
   const handleDownloadAllWorkspaces = useCallback18(async () => {
@@ -10901,7 +11206,7 @@ function DocBlocksShell({
         return;
       }
       const container = new MemoryContentContainer();
-      const usedFolders = /* @__PURE__ */ new Set();
+      let backupWorkspaces = [];
       const skipped = [];
       for (const ws of candidates) {
         let p = null;
@@ -10927,24 +11232,20 @@ function DocBlocksShell({
           skipped.push(ws.name);
           continue;
         }
-        const base = (ws.name || "workspace").replace(/[^a-z0-9_\- ]/gi, "_").trim() || "workspace";
-        let folder = base;
-        let suffix = 2;
-        while (usedFolders.has(folder)) {
-          folder = `${base} (${suffix++})`;
-        }
-        usedFolders.add(folder);
         try {
-          await copyProviderToContainer(p, container, folder);
+          const source = getFileSystemProviderV211(p);
+          if (!source) throw new Error("This workspace does not support complete backups.");
+          backupWorkspaces = await appendWorkspaceBackup(container, source, backupWorkspaces);
         } finally {
-          if (ownsProvider) await getFileSystemProviderV210(p)?.dispose();
+          if (ownsProvider) await getFileSystemProviderV211(p)?.dispose();
         }
       }
-      if (usedFolders.size === 0) {
+      if (backupWorkspaces.length === 0) {
         showToast("error", "No workspaces could be opened for download.");
         return;
       }
-      const blob = await containerToZip(container);
+      await finishWorkspaceBackup(container, backupWorkspaces);
+      const blob = await containerToZip(container, { compression: "STORE" });
       const url = URL.createObjectURL(blob);
       const a = document.createElement("a");
       a.href = url;
@@ -10954,12 +11255,11 @@ function DocBlocksShell({
       if (skipped.length > 0) {
         await acknowledge({
           title: "Some workspaces were skipped",
-          message: `Downloaded ${usedFolders.size} workspace(s). Skipped ${skipped.length} that require re-granting access: ${skipped.join(", ")}.`
+          message: `Downloaded ${backupWorkspaces.length} workspace(s). Skipped ${skipped.length} that require re-granting access: ${skipped.join(", ")}.`
         });
       }
     } catch (err) {
-      console.error("Failed to download all workspaces", err);
-      showToast("error", "Failed to download all workspaces. See console for details.");
+      showToast("error", err instanceof Error ? err.message : "Failed to download all workspaces.");
     }
   }, [documentSession, acknowledge, showToast]);
   const handleKeepBrowserData = useCallback18(async () => {
@@ -11050,7 +11350,7 @@ function DocBlocksShell({
       } else if (ws?.type === "indexeddb") {
         await (await loadIndexedDbFileSystem()).deleteIndexedDBWorkspaceData(workspaceId);
       }
-      await removeWorkspace(workspaceId);
+      await removeWorkspace2(workspaceId);
       forgetRecentDocuments(workspaceId);
       for (const document2 of pinnedDocuments) {
         if (document2.workspaceId === workspaceId) {
@@ -11078,7 +11378,7 @@ function DocBlocksShell({
           rootPath: info.rootPath,
           lastOpened: (/* @__PURE__ */ new Date()).toISOString()
         };
-        await saveWorkspace2(descriptor);
+        await saveWorkspace3(descriptor);
         const p = await createHostFileSystemProvider(info.id, info.name, info.rootPath);
         setProvider(p);
         setActiveWorkspaceId(info.id);
@@ -11219,6 +11519,7 @@ function DocBlocksShell({
                       onVersioningPreferenceChange: handleVersioningPreferenceChange,
                       onOpenWorkspaceSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onDownloadAllWorkspaces: handleDownloadAllWorkspaces,
+                      onRestoreBackup: hostSupports2("nativeWorkspaces") ? void 0 : () => restoreInputRef.current?.click(),
                       onShowKeyboardShortcuts: singlePane ? void 0 : openKeyboardShortcuts,
                       onKeepBrowserData: showBrowserStorageWarning && !browserStoragePersistent ? handleKeepBrowserData : void 0,
                       onInstallApp: installPromptEvent ? handleInstallApp : void 0,
@@ -11231,6 +11532,21 @@ function DocBlocksShell({
                       settingsRequest
                     }
                   ),
+                  /* @__PURE__ */ jsx18(
+                    "input",
+                    {
+                      ref: restoreInputRef,
+                      type: "file",
+                      accept: ".zip,application/zip",
+                      "aria-label": "Restore workspace backup",
+                      hidden: true,
+                      onChange: (event) => {
+                        const file = event.currentTarget.files?.[0];
+                        event.currentTarget.value = "";
+                        if (file) void handleRestoreBackup(file);
+                      }
+                    }
+                  ),
                   /* @__PURE__ */ jsx18(
                     WorkspacePicker,
                     {
@@ -11437,6 +11753,7 @@ function DocBlocksShell({
                               saveDashboardImageOutput: saveRenderedImageOutput,
                               onChange: handleEditorChange,
                               onLinkClick: handleEditorLinkClick,
+                              wikiLinks,
                               colorScheme: resolvedTheme,
                               defaultThemeId: workspaceDefaultThemeId,
                               defaultThemeLabel: "Workspace default",