@bendyline/docblocks-react 2.7.2 → 2.7.4

package/dist/index.js

@@ -1,3 +1,6 @@
+import {
+  ProgressivePlayer
+} from "./chunk-2IYBBFQX.js";
 import {
   BackupIcon,
   FolderIcon,
@@ -14,13 +17,10 @@ import {
 } from "./chunk-DICE7VBJ.js";
 import {
   useConfirmDialog
-} from "./chunk-6B7G33D5.js";
+} from "./chunk-KBUHWZCF.js";
 import {
   createSpeechInputProvider
 } from "./chunk-KBDZDFPU.js";
-import {
-  ProgressivePlayer
-} from "./chunk-2IYBBFQX.js";
 import {
   sharedDocumentFilename
 } from "./chunk-SPUPWCSI.js";
@@ -51,7 +51,7 @@ import {
 } from "./chunk-KWG6UP5O.js";
 import {
   runExport
-} from "./chunk-HRWEGPTY.js";
+} from "./chunk-7CSBRAMT.js";
 import {
   createImageSaveOutput
 } from "./chunk-UONFWKJ7.js";
@@ -87,7 +87,7 @@ import {
   saveProofingPreferences,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-BLUEZG7T.js";
+} from "./chunk-FBPCURCS.js";
 import {
   FindButton,
   focusFindInput,
@@ -99,14 +99,19 @@ import {
   isApplePlatform,
   matchShortcut,
   shortcutLabel
-} from "./chunk-K7XJDJUJ.js";
-import "./chunk-SSB43524.js";
-import "./chunk-NAH52736.js";
+} from "./chunk-ACQF63SB.js";
+import "./chunk-PNZFIIWW.js";
+import {
+  buildIssueReportUrl,
+  displayBuildDate,
+  localDateStamp,
+  openExternalUrl
+} 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
@@ -114,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
@@ -134,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);
 }
@@ -162,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) => {
@@ -184,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) {
@@ -232,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());
@@ -299,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) => {
@@ -347,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;
@@ -361,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;
@@ -537,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,
@@ -783,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);
@@ -1029,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,
@@ -1081,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",
@@ -1712,6 +1790,7 @@ import {
   FsError as FsError3,
   SQUISQ_RUNTIME_DIRECTORY_NAME,
   getFileSystemProviderV2 as getFileSystemProviderV23,
+  findWikiArticle,
   parseWorkspacePath as parseWorkspacePath3
 } from "@bendyline/docblocks/filesystem";
 import {
@@ -2144,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()) {
@@ -2156,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 } : {}
@@ -2166,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
     };
   }
@@ -2176,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)
     },
@@ -2411,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}`);
@@ -2443,6 +2536,7 @@ function isInternalDrag(dataTransfer) {
 }
 function FileExplorer({
   provider,
+  loading = false,
   metadataRefreshKey,
   activeFilePath,
   sortMode,
@@ -2874,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",
@@ -3155,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",
@@ -3169,7 +3263,7 @@ function FileExplorer({
             ]
           }
         ),
-        tree.loading ? /* @__PURE__ */ jsx5("div", { className: "db-tree", role: "status", "aria-live": "polite", children: /* @__PURE__ */ jsx5("div", { className: "db-tree-loading", children: "Loading..." }) }) : filterVisibleFileEntries(tree.entries).length === 0 ? /* @__PURE__ */ jsx5("div", { className: "db-tree", children: /* @__PURE__ */ jsx5("div", { className: "db-tree-empty", children: "No files yet" }) }) : /* @__PURE__ */ jsx5(
+        tree.loading || loading ? /* @__PURE__ */ jsx5("div", { className: "db-tree", role: "status", "aria-live": "polite", children: /* @__PURE__ */ jsx5("div", { className: "db-tree-loading", children: "Loading..." }) }) : filterVisibleFileEntries(tree.entries).length === 0 ? /* @__PURE__ */ jsx5("div", { className: "db-tree", children: /* @__PURE__ */ jsx5("div", { className: "db-tree-empty", children: "No files yet" }) }) : /* @__PURE__ */ jsx5(
           "div",
           {
             ref: treeRef,
@@ -3236,6 +3330,7 @@ function WorkspacePicker({
   onCloneRepository,
   onRemoveWorkspace,
   refreshKey,
+  loading = false,
   className
 }) {
   const [workspaces, setWorkspaces] = useState5([]);
@@ -3392,7 +3487,7 @@ function WorkspacePicker({
     }
   }, [newWorkspaceName, newWorkspacePending, onSelect, refresh, workspaces]);
   const activeWs = workspaces.find((w) => w.id === activeWorkspaceId);
-  const activeWorkspaceName = activeWs?.name ?? "No workspace";
+  const activeWorkspaceName = activeWs?.name ?? (loading ? "Loading\u2026" : "No workspace");
   return /* @__PURE__ */ jsxs5("div", { ref: pickerRef, className: `db-workspace-picker ${className ?? ""}`, children: [
     /* @__PURE__ */ jsxs5(
       "button",
@@ -3679,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,
@@ -3708,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
@@ -4034,17 +4133,6 @@ function SpeechSettingsControls({ speech }) {
   ] });
 }
 
-// src/local-date.ts
-function localDateStamp(date) {
-  const pad = (value) => String(value).padStart(2, "0");
-  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
-}
-function displayBuildDate(value) {
-  if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return value;
-  const instant = new Date(value);
-  return Number.isNaN(instant.getTime()) ? value : localDateStamp(instant);
-}
-
 // src/AppMenu/AppMenu.tsx
 import { Fragment as Fragment5, jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function formatBytes(bytes) {
@@ -4081,6 +4169,7 @@ function AppMenu({
   onVersioningPreferenceChange,
   onOpenWorkspaceSettings,
   onDownloadAllWorkspaces,
+  onRestoreBackup,
   onShowKeyboardShortcuts,
   onKeepBrowserData,
   onInstallApp,
@@ -4099,7 +4188,8 @@ function AppMenu({
     if (settingsRequest > 0) setShowSettings(true);
   }, [settingsRequest]);
   const [requestingPersistentStorage, setRequestingPersistentStorage] = useState7(false);
-  const moreInformationUrl = MORE_INFORMATION_URLS[getHostEnvironment()?.surface ?? "web"] ?? MORE_INFORMATION_URLS.web;
+  const surface = getHostEnvironment()?.surface ?? "web";
+  const moreInformationUrl = MORE_INFORMATION_URLS[surface] ?? MORE_INFORMATION_URLS.web;
   const containerRef = useRef8(null);
   const { menuRef, triggerRef, handleMenuKeyDown, handleTriggerKeyDown, closeMenu } = useMenuKeyboard(isOpen, setIsOpen);
   const [storageEstimate, setStorageEstimate] = useState7(null);
@@ -4214,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",
               {
@@ -4225,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",
               {
@@ -4400,22 +4500,6 @@ function AppMenu({
         /* @__PURE__ */ jsx8("strong", { children: "DocBlocks" }),
         " is a local-first Markdown document editor. Your files stay under your control."
       ] }),
-      /* @__PURE__ */ jsxs7("aside", { className: "db-about-beta", children: [
-        /* @__PURE__ */ jsx8("strong", { children: "Beta Software." }),
-        " We're still working through initial hiccups and issues. Please bear with us, make sure you keep backups, and",
-        " ",
-        /* @__PURE__ */ jsx8(
-          "a",
-          {
-            href: "https://github.com/bendyline/docblocks/issues/new",
-            target: "_blank",
-            rel: "noopener noreferrer",
-            children: "open issues"
-          }
-        ),
-        " ",
-        "where you find them. Thanks!"
-      ] }),
       appVersion && /* @__PURE__ */ jsxs7("p", { className: "db-about-version", children: [
         /* @__PURE__ */ jsx8("span", { children: "Version" }),
         /* @__PURE__ */ jsx8("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
@@ -4434,6 +4518,12 @@ function AppMenu({
         /* @__PURE__ */ jsx8("a", { href: "https://bendyline.com", target: "_blank", rel: "noopener noreferrer", children: "Bendyline" }),
         "."
       ] }),
+      surface === "web" && /* @__PURE__ */ jsxs7("p", { children: [
+        "See our free desktop apps at",
+        " ",
+        /* @__PURE__ */ jsx8("a", { href: MORE_INFORMATION_URLS.electron, target: "_blank", rel: "noopener noreferrer", children: "docblocks.com/desktop" }),
+        "."
+      ] }),
       /* @__PURE__ */ jsxs7("p", { className: "db-dialog-links", children: [
         /* @__PURE__ */ jsx8("a", { href: moreInformationUrl, target: "_blank", rel: "noopener noreferrer", children: "More information..." }),
         /* @__PURE__ */ jsx8(
@@ -4486,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";
@@ -5008,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-2FEIHNMW.js").then((module) => ({
+  () => import("./ExportToolbarControls-HOV424TO.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -5578,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 };
@@ -5601,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;
@@ -5615,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++) {
@@ -5630,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,
@@ -5640,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);
 }
@@ -5673,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);
 }
@@ -6050,37 +6219,8 @@ function resolveShellTheme({
   return osTheme;
 }
 
-// src/DocBlocksShell/issue-report.ts
-var NEW_ISSUE_URL = "https://github.com/bendyline/docblocks/issues/new";
-var VERSION_VALUE_LIMIT = 128;
-var USER_AGENT_VALUE_LIMIT = 512;
-function normalizeEnvironmentValue(value, fallback, limit) {
-  const normalized = value.replace(/[\r\n]+/g, " ").trim().slice(0, limit);
-  return normalized || fallback;
-}
-function buildIssueReportUrl(environment) {
-  const body = [
-    "## Description",
-    "",
-    "<!-- What happened, and what did you expect? -->",
-    "",
-    "## Environment",
-    "",
-    `- Date: ${localDateStamp(environment.reportedAt)}`,
-    `- DocBlocks: ${normalizeEnvironmentValue(environment.version, "unknown", VERSION_VALUE_LIMIT)}`,
-    `- User agent: ${normalizeEnvironmentValue(
-      environment.userAgent,
-      "unavailable",
-      USER_AGENT_VALUE_LIMIT
-    )}`
-  ].join("\n");
-  const url = new URL(NEW_ISSUE_URL);
-  url.searchParams.set("body", body);
-  return url.href;
-}
-
 // 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;
@@ -6101,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 {
@@ -6733,6 +6873,104 @@ function UpdateAvailableNotice({
   ] });
 }
 
+// src/DocBlocksShell/WelcomeScreen.tsx
+import { jsx as jsx17, jsxs as jsxs15 } from "react/jsx-runtime";
+var WELCOME_HEADLINE = "The Markdown editor that turns one file into anything.";
+var WELCOME_SUMMARY = "Write the way you normally would, then share the same file as a PDF, a Word document, a slide deck, or a video.";
+var WELCOME_PRIVACY_NOTE = "No account, and your documents stay on this device.";
+var DOCBLOCKS_APPS_URL = "https://docblocks.com/desktop/";
+function WelcomeScreen({
+  onCreateDocument,
+  onTour,
+  onDismiss,
+  offerApps = false
+}) {
+  return /* @__PURE__ */ jsxs15("section", { className: "db-welcome-gateway", "aria-labelledby": "db-welcome-gateway-title", children: [
+    /* @__PURE__ */ jsx17(
+      "button",
+      {
+        type: "button",
+        className: "db-welcome-gateway-dismiss",
+        onClick: onDismiss,
+        "aria-label": "Dismiss welcome",
+        title: "Dismiss",
+        children: "\xD7"
+      }
+    ),
+    /* @__PURE__ */ jsxs15("div", { className: "db-welcome-gateway-body", children: [
+      /* @__PURE__ */ jsxs15("div", { className: "db-welcome-gateway-copy", children: [
+        /* @__PURE__ */ jsx17("p", { className: "db-welcome-gateway-eyebrow", children: "Welcome to DocBlocks" }),
+        /* @__PURE__ */ jsx17("h1", { id: "db-welcome-gateway-title", children: WELCOME_HEADLINE }),
+        /* @__PURE__ */ jsx17("p", { children: WELCOME_SUMMARY }),
+        /* @__PURE__ */ jsx17("p", { className: "db-welcome-gateway-note", children: WELCOME_PRIVACY_NOTE }),
+        /* @__PURE__ */ jsxs15("div", { className: "db-welcome-gateway-actions", children: [
+          /* @__PURE__ */ jsx17("button", { type: "button", className: "db-welcome-gateway-primary", onClick: onCreateDocument, children: "Create a document" }),
+          /* @__PURE__ */ jsx17("button", { type: "button", className: "db-welcome-gateway-cta", onClick: onTour, children: "Tour the welcome document" }),
+          offerApps && /* @__PURE__ */ jsx17(
+            "a",
+            {
+              className: "db-welcome-gateway-apps",
+              href: DOCBLOCKS_APPS_URL,
+              target: "_blank",
+              rel: "noopener noreferrer",
+              children: "Check out the DocBlocks apps"
+            }
+          )
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx17(WelcomeLoop, {})
+    ] })
+  ] });
+}
+function WelcomeLoop() {
+  return /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop", "aria-hidden": "true", children: [
+    /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop-source", children: [
+      /* @__PURE__ */ jsx17("span", { className: "db-welcome-loop-file", children: "Lisbon.md" }),
+      /* @__PURE__ */ jsxs15("code", { children: [
+        /* @__PURE__ */ jsx17("span", { className: "db-welcome-loop-mark", children: "# " }),
+        "Lisbon in three days",
+        "\n",
+        "Trams, tiles, and pastries.",
+        "\n\n",
+        /* @__PURE__ */ jsx17("span", { className: "db-welcome-loop-mark", children: "## " }),
+        "Day one",
+        "\n",
+        /* @__PURE__ */ jsx17("span", { className: "db-welcome-loop-mark", children: "- " }),
+        "Ride Tram 28",
+        "\n",
+        /* @__PURE__ */ jsx17("span", { className: "db-welcome-loop-mark", children: "- " }),
+        "Sunset at Gra\xE7a"
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx17("div", { className: "db-welcome-loop-arrow", children: "\u2192" }),
+    /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop-stage", children: [
+      /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop-frame db-welcome-loop-frame--page", children: [
+        /* @__PURE__ */ jsx17("strong", { children: "Lisbon in three days" }),
+        /* @__PURE__ */ jsx17("span", { children: "Trams, tiles, and pastries." }),
+        /* @__PURE__ */ jsx17("em", { children: "Day one" }),
+        /* @__PURE__ */ jsx17("span", { children: "\u2022 Ride Tram 28" }),
+        /* @__PURE__ */ jsx17("span", { children: "\u2022 Sunset at Gra\xE7a" })
+      ] }),
+      /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop-frame db-welcome-loop-frame--slide", children: [
+        /* @__PURE__ */ jsx17("strong", { children: "Lisbon in three days" }),
+        /* @__PURE__ */ jsx17("span", { children: "Trams, tiles, and pastries." })
+      ] }),
+      /* @__PURE__ */ jsxs15("div", { className: "db-welcome-loop-frame db-welcome-loop-frame--video", children: [
+        /* @__PURE__ */ jsx17("em", { children: "Day one" }),
+        /* @__PURE__ */ jsx17("span", { children: "\u2022 Ride Tram 28" }),
+        /* @__PURE__ */ jsx17("span", { children: "\u2022 Sunset at Gra\xE7a" }),
+        /* @__PURE__ */ jsx17("i", { className: "db-welcome-loop-play", children: "\u25B6" }),
+        /* @__PURE__ */ jsx17("i", { className: "db-welcome-loop-progress" })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs15("ol", { className: "db-welcome-loop-labels", children: [
+      /* @__PURE__ */ jsx17("li", { children: "PDF" }),
+      /* @__PURE__ */ jsx17("li", { children: "Slides" }),
+      /* @__PURE__ */ jsx17("li", { children: "Video" })
+    ] })
+  ] });
+}
+
 // src/DocBlocksShell/useDocumentLinkProvider.ts
 import { useCallback as useCallback16 } from "react";
 
@@ -6797,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",
@@ -6827,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(() => {
@@ -6890,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;
@@ -6909,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();
@@ -7015,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.");
   }
@@ -7107,7 +7345,15 @@ function createNativeFileActions(entry, workspaceId, host) {
 
 // src/DocBlocksShell/welcome-document.ts
 import { DEFAULT_WORKSPACE_ID } from "@bendyline/docblocks/workspace";
-var WELCOME_DOCUMENT_PATH = "/aboutDocBlocks.md";
+var WELCOME_DOCUMENT_PATH = "/Welcome.md";
+var WELCOME_DOCUMENT_NAMES = /* @__PURE__ */ new Set([
+  "welcome.md",
+  // Seeded as `aboutDocBlocks.md` through 2.7 (`aboutDocblocks.md` before that).
+  "aboutdocblocks.md"
+]);
+function isWelcomeDocumentPath(path) {
+  return WELCOME_DOCUMENT_NAMES.has(path.replace(/^\//, "").toLowerCase());
+}
 function isAppDefaultWorkspace(workspaceId, hostDefaultWorkspaceIds) {
   return hostDefaultWorkspaceIds ? hostDefaultWorkspaceIds.has(workspaceId) : workspaceId === DEFAULT_WORKSPACE_ID;
 }
@@ -7117,126 +7363,57 @@ var WELCOME_DOCUMENT_CONTENT = [
   "squisq-cover-slide: false",
   "---",
   "",
-  '# DocBlocks {[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.",
-  "",
-  "## Start with three small moves {[list]}",
-  "",
-  "1. Choose **New file** in the file pane and give your document a name, such as `my-first-document.md`. On a small screen, open the file pane first.",
-  "2. Add a heading and a few sentences in **Write**, then switch to **Source** to see the Markdown behind them. Both views edit the same document.",
-  "3. Try a Document, Page, Slideshow, or Video preview, then open **Export and share** to make a PDF, Word document, or another supported file.",
-  "",
-  '## Choose your DocBlocks app {[twoColumn header="The same Markdown, wherever you work" left="Web|Start in a browser, with no account. Install the web app when your browser offers it." right="Desktop|Download for macOS (Apple silicon), Windows, or Linux. Work directly in your folders."]}',
+  '# Welcome to DocBlocks {[title subtitle="Write once. Share it as a document, a deck, or a video."]}',
   "",
-  "Choose the **Web app** to start writing in your browser, or **Desktop** for everyday work in local folders on macOS (Apple silicon), Windows, and Linux. Use **VS Code** for documents beside your code, and the **CLI and MCP server** for automation. The links at the end of this guide lead to downloads and setup instructions.",
+  "This is an ordinary document, so go ahead and change it. Click anywhere and type; DocBlocks saves as you go.",
   "",
-  "## Get started on desktop {[list]}",
+  "## Write the way you already do {[list]}",
   "",
-  "- Download the installer for your computer from the **Desktop app** link at the end of this guide. macOS builds support Apple silicon.",
-  "- Launch DocBlocks and choose **Open a folder** to work in a folder you own. Your Markdown and media stay in that folder.",
-  "- Open an existing document or create a new file. Edits save automatically; check any save or conflict message before closing.",
-  "- Use the same Write, Source, preview, and export workflow as the web app, with native menus and file opening.",
+  "- Type to add text, and use the toolbar for headings, lists, and bold or italic text.",
+  "- Choose **Insert** in the toolbar to add a table, a checklist, a chart, a diagram, or a picture.",
+  "- Choose **Source** to see the Markdown text behind this page. Both views edit the same document.",
   "",
-  "## Use the web app on this device {[list]}",
-  "",
-  "- Open DocBlocks in your browser and start in a browser workspace. In supported browsers, you can also open a local folder.",
-  "- Choose **Install DocBlocks\u2026** in the app menu when offered. The installed web app keeps using the same browser storage.",
-  "- Once the app has finished downloading for offline use, you can keep editing without a connection.",
-  "- Use **Back up all workspaces** in the app menu to keep a backup before clearing browser data or moving to a new device.",
-  "",
-  "## Work inside VS Code {[content]}",
-  "",
-  "Install the DocBlocks extension, then open a `.md` file in your project. If it opens as plain text, right-click it and choose **Open in DocBlocks**. VS Code supplies the file explorer, tabs, saving, and source control; DocBlocks supplies the visual editor, Markdown source, previews, and export. Follow the extension guide below to get started.",
-  "",
-  "## On a phone or tablet {[content]}",
-  "",
-  "Use the web app on your phone or tablet today. Native apps for iPhone, iPad, and Android are in preview, with store distribution pending. Preview builds offer an **On this device** workspace, picked folders, and system sharing. Keep an exported copy of important work: uninstalling a native app removes its private device workspace.",
-  "",
-  '## Automate with the CLI and MCP {[twoColumn header="For repeatable document work" left="CLI|Install @bendyline/docblocks-cli with npm, then run docblocks --help. Build, preview, and convert files from your terminal." right="MCP|Connect the local server to an agent. Convert and preview documents, then deliberately save the resulting artifacts."]}',
-  "",
-  "With a supported version of `Node.js` installed, run `npm install -g @bendyline/docblocks-cli`, then `docblocks --help`. The CLI builds, previews, and converts files from your terminal. Its local MCP server gives agents document tools with explicitly allowed file access. Follow the CLI and MCP guide below for requirements and configuration.",
-  "",
-  "## One source, four ways to publish {[diagram]}",
+  "## One document, many ways to share it {[diagram]}",
   "",
   "```diagram",
-  "+------------+",
-  "|  Markdown  |",
-  "+-----+------+",
-  "      |",
-  "  +---+------+------------+-----------+",
-  "  |          |            |           |",
-  "  v          v            v           v",
-  "+-------+ +---------+ +------------+ +-------+",
-  "| Pages | |Documents| | Slideshows | | Video |",
-  "+-------+ +---------+ +------------+ +-------+",
+  "              +-----------------+",
+  "              |  Your document  |",
+  "              +--------+--------+",
+  "                       |",
+  "    +-----------+------+-----+------------+",
+  "    |           |            |            |",
+  "    v           v            v            v",
+  "+-------+  +--------+  +----------+  +---------+",
+  "|  PDF  |  |  Word  |  |  Slides  |  |  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.",
-  "",
-  "## Try the optional desktop tools {[list]}",
-  "",
-  "- **AI assistance** can help rewrite, review, and illustrate a document. In **Settings \u2192 AI assistance**, turn on **Use AI features** and choose an available model. AI is off by default; model downloads start only when you request them.",
-  "- **Dictation and read aloud** run on your computer. Where available, open **Settings \u2192 Speech** to download a dictation model or narration voices, then use the microphone or read-aloud controls.",
-  "- These tools depend on the app, device, and installed models. Writing, previewing, and exporting work without setting them up.",
-  "",
-  "## 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** puts a Markdown copy in a link that opens straight into a Document, Page, Slideshow, or Video 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 sharing with a fixed page layout.",
-  "- 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**.",
+  "## Present it or send it {[content]}",
   "",
-  "## Local-first is concrete, not decorative {[quote]}",
+  "Each heading starts a new slide, so this document is already a slideshow. Choose **Slideshow** at the top to see it, or **Export** to save it as a PDF, a Word document, a PowerPoint deck, an e-book, a web page, or a video.",
   "",
-  "> 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.",
+  "## Your documents stay yours {[factCard]}",
   "",
-  "## Agents get document tools, not a blank check {[factCard]}",
+  "There is no account to create. Your documents stay on this device as plain text files that other apps can open too. Choose **Back up** at the bottom of the file list to keep a copy somewhere safe.",
   "",
-  "The local MCP server converts plain text or Markdown directly and can optionally inspect, preview, or compare documents. Results remain temporary session artifacts until they are deliberately saved, and filesystem access begins with explicit roots rather than assumed authority.",
+  "## Make your own {[list]}",
   "",
-  "## Take your documents to another app {[content]}",
+  "1. Choose **New File** above the file list and give it a name.",
+  "2. Write a heading and a few sentences.",
+  "3. Choose **Slideshow** to present it, or **Export** to share it.",
   "",
-  "DocBlocks does not automatically sync workspaces between apps or devices. Open the same folder in Desktop or VS Code, or export Markdown and its media to move your work. A DBK bundle keeps documents and media together for another DocBlocks app. A share link contains a snapshot; later edits do not update that copy.",
+  "## Go further {[list]}",
   "",
-  "## Explore DocBlocks {[list]}",
-  "",
-  "- [Desktop app](https://docblocks.com/desktop/) \u2014 downloads and first steps for macOS (Apple silicon), Windows, and Linux.",
-  "- [Web app](https://docblocks.com/web/) \u2014 browser storage, installation, and offline use.",
-  "- [Mobile preview](https://docblocks.com/docs/#mobile-preview) \u2014 iPhone, iPad, and Android status and build guide.",
-  "- [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 compare the apps and follow the getting-started guides.",
+  "- [Get the desktop app](https://docblocks.com/desktop/) to work in folders on your computer.",
+  "- [Add DocBlocks to VS Code](https://docblocks.com/vscode/) to edit documents beside your code.",
+  "- [Read the guides](https://docblocks.com/docs/) for everything else.",
   // End with a newline, as the Write view saves every document. Without it,
   // merely opening the welcome document in Write rewrote the file.
   ""
 ].join("\n");
 
 // src/DocBlocksShell/DocBlocksShell.tsx
-import { Fragment as Fragment11, jsx as jsx17, jsxs as jsxs15 } from "react/jsx-runtime";
+import { Fragment as Fragment11, jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
 var editorShellModulePromise = null;
 function loadEditorShell() {
   editorShellModulePromise ?? (editorShellModulePromise = (async () => {
@@ -7248,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-NOD4P25G.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
+  () => import("./KeyboardShortcutsDialog-HVKDFP5Z.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
 );
 var WorkspaceSearchPanel = lazy2(
   () => import("./WorkspaceSearchPanel-J6BKEZQJ.js").then((m) => ({
@@ -7268,37 +7445,37 @@ var GitToolbarControl = lazy2(
   () => import("./GitToolbarControl-B7KG4MFP.js").then((m) => ({ default: m.GitToolbarControl }))
 );
 var AiToolbarControl = lazy2(
-  () => import("./AiEditorAssistant-GN2KXKZD.js").then((module) => ({
+  () => import("./AiEditorAssistant-4HFFGVU4.js").then((module) => ({
     default: module.AiToolbarControl
   }))
 );
 var PresentationMaker = lazy2(
-  () => import("./PresentationMaker-ITNP5SDO.js").then((module) => ({
+  () => import("./PresentationMaker-MUMFAXEI.js").then((module) => ({
     default: module.PresentationMaker
   }))
 );
 var AiReviewPanel = lazy2(
-  () => import("./AiEditorAssistant-GN2KXKZD.js").then((module) => ({
+  () => import("./AiEditorAssistant-4HFFGVU4.js").then((module) => ({
     default: module.AiReviewPanel
   }))
 );
 var AiIllustratePanel = lazy2(
-  () => import("./AiDiagrams-LFV4YU6W.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
   }))
 );
@@ -7439,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;
@@ -7459,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);
@@ -7477,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 {
@@ -7521,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) {
@@ -7565,7 +7742,7 @@ async function createHostProviderFromWorkspace(ws) {
 var DESKTOP_TOOLBAR_WRAP_WIDTH = 900;
 var WEB_TOOLBAR_WRAP_WIDTH = 700;
 function FolderGlyph() {
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7574,12 +7751,12 @@ function FolderGlyph() {
       strokeWidth: "1.5",
       strokeLinejoin: "round",
       "aria-hidden": "true",
-      children: /* @__PURE__ */ jsx17("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__ */ jsx18("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__ */ jsxs15(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7589,14 +7766,14 @@ function FileGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx17("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
-        /* @__PURE__ */ jsx17("path", { d: "M14 3v5h5" })
+        /* @__PURE__ */ jsx18("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
+        /* @__PURE__ */ jsx18("path", { d: "M14 3v5h5" })
       ]
     }
   );
 }
 function CollapseSidebarGlyph() {
-  return /* @__PURE__ */ jsxs15(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 64 64",
@@ -7607,9 +7784,9 @@ function CollapseSidebarGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx17("rect", { x: "7", y: "10", width: "50", height: "44", rx: "6" }),
-        /* @__PURE__ */ jsx17("path", { d: "M24 10v44" }),
-        /* @__PURE__ */ jsx17("path", { d: "m17 25-7 7 7 7" })
+        /* @__PURE__ */ jsx18("rect", { x: "7", y: "10", width: "50", height: "44", rx: "6" }),
+        /* @__PURE__ */ jsx18("path", { d: "M24 10v44" }),
+        /* @__PURE__ */ jsx18("path", { d: "m17 25-7 7 7 7" })
       ]
     }
   );
@@ -7841,6 +8018,7 @@ function DocBlocksShell({
   );
   const [provider, setProvider] = useState23(null);
   const [workspaceStartupError, setWorkspaceStartupError] = useState23(null);
+  const workspaceStarting = provider === null && workspaceStartupError === null;
   const [activeWorkspaceId, setActiveWorkspaceId] = useState23(null);
   const [defaultNewFileFormat, setDefaultNewFileFormat] = useState23(DEFAULT_NEW_FILE_FORMAT);
   useEffect29(() => {
@@ -7863,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);
@@ -7951,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();
@@ -8060,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);
       }
     },
@@ -8157,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);
+            }
+          } : {}
         };
       }
     }
@@ -8194,7 +8378,6 @@ function DocBlocksShell({
     } : null,
     [documentSnapshot.frozen, documentSnapshot.generation, documentSnapshot.targetKey]
   );
-  const [editorPresentationEpoch, setEditorPresentationEpoch] = useState23(0);
   const [editorGeneration, setEditorGeneration] = useState23(documentSnapshot.generation);
   useEffect29(() => {
     const sync = () => setEditorGeneration(documentSession.getSnapshot().generation);
@@ -8208,7 +8391,7 @@ function DocBlocksShell({
   useEffect29(() => {
     setOutsideInPdfWorker(pdfWorkerSrc2);
   }, [pdfWorkerSrc2]);
-  const editorKey = `${editorGeneration}:${editorPresentationEpoch}`;
+  const editorKey = String(editorGeneration);
   const editorPlaceholder = useMemo6(() => {
     void editorKey;
     return pickEmptyDocumentPrompt();
@@ -8217,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);
@@ -8228,6 +8411,15 @@ function DocBlocksShell({
   const [initialView, setInitialView] = useState23("wysiwyg");
   const [initialSharedMode, setInitialSharedMode] = useState23(null);
   const [showWelcomeGateway, setShowWelcomeGateway] = useState23(false);
+  const welcomeScreenShown = showWelcomeGateway && !singlePane;
+  const welcomeCoveredRef = useRef19(null);
+  useInert(welcomeCoveredRef, welcomeScreenShown);
+  const closeWelcomeGateway = useCallback18(() => {
+    setShowWelcomeGateway((showing) => {
+      if (showing) markWelcomeGatewayDismissed();
+      return false;
+    });
+  }, []);
   const [aiPanel, setAiPanel] = useState23(null);
   const navigationRequestRef = useRef19(0);
   const workspaceAuthorityBarrier = useMemo6(() => new WorkspaceAuthorityBarrier(), []);
@@ -8511,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]
@@ -8536,6 +8728,7 @@ function DocBlocksShell({
           options.navigationRequestId,
           options.sharedMode ?? null
         ) !== null;
+        if (opened) closeWelcomeGateway();
         return opened;
       } finally {
         if (!opened && getTransientWorkspace(options.id)?.provider === options.provider) {
@@ -8543,7 +8736,7 @@ function DocBlocksShell({
         }
       }
     },
-    [openFromIds]
+    [openFromIds, closeWelcomeGateway]
   );
   const openSharedDocument = useCallback18(
     async (payload, navigationRequestId) => {
@@ -8562,7 +8755,7 @@ function DocBlocksShell({
           )
         });
       } catch (error) {
-        await getFileSystemProviderV210(mem)?.dispose();
+        await getFileSystemProviderV211(mem)?.dispose();
         throw error;
       }
       return adoptTransientWorkspace({
@@ -8585,18 +8778,18 @@ function DocBlocksShell({
       const entries = await readProviderDirectory2(fs, "/");
       if (!isCurrent()) return;
       const visibleEntries = filterVisibleFileEntries(entries);
-      if (visibleEntries.length === 1 && visibleEntries[0].kind === "file" && visibleEntries[0].path.replace(/^\//, "").toLowerCase() === "aboutdocblocks.md") {
+      if (visibleEntries.length === 1 && visibleEntries[0].kind === "file" && isWelcomeDocumentPath(visibleEntries[0].path)) {
         const aboutPath = visibleEntries[0].path;
         const content = await readProviderText(fs, aboutPath);
         if (content !== null && isCurrent()) {
           await documentSession.transitionTo(createDocumentTarget(fs, fs.id, aboutPath), content);
           if (!isCurrent()) return;
           adoptRegularDocument(aboutPath);
-          setInitialView("preview");
+          setInitialView("wysiwyg");
           setInitialSharedMode(null);
           setExplorerKey((k) => k + 1);
           pushHash(fs.id, aboutPath);
-          saveLastState({ workspaceId: fs.id, filePath: aboutPath, view: "preview" });
+          saveLastState({ workspaceId: fs.id, filePath: aboutPath, view: "wysiwyg" });
           if (!isWelcomeGatewayDismissed()) setShowWelcomeGateway(true);
         }
         return;
@@ -8608,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;
@@ -8620,11 +8813,11 @@ function DocBlocksShell({
       );
       if (!isCurrent()) return;
       adoptRegularDocument(welcomePath);
-      setInitialView("preview");
+      setInitialView("wysiwyg");
       setInitialSharedMode(null);
       setExplorerKey((k) => k + 1);
       pushHash(fs.id, welcomePath);
-      saveLastState({ workspaceId: fs.id, filePath: welcomePath, view: "preview" });
+      saveLastState({ workspaceId: fs.id, filePath: welcomePath, view: "wysiwyg" });
       if (!isWelcomeGatewayDismissed()) setShowWelcomeGateway(true);
     },
     [adoptRegularDocument, createDocumentTarget, documentSession, pushHash]
@@ -8635,21 +8828,16 @@ function DocBlocksShell({
   startupOpenSharedDocumentRef.current = openSharedDocument;
   const startupSeedWelcomeFileRef = useRef19(seedWelcomeFile);
   startupSeedWelcomeFileRef.current = seedWelcomeFile;
-  const closeWelcomeGateway = useCallback18(() => {
-    setShowWelcomeGateway((showing) => {
-      if (showing) markWelcomeGatewayDismissed();
-      return false;
-    });
-  }, []);
-  const handleStartWriting = useCallback18(() => {
+  const [focusAfterWelcome, setFocusAfterWelcome] = useState23(false);
+  const handleTourWelcome = useCallback18(() => {
     closeWelcomeGateway();
-    setInitialView("wysiwyg");
-    setInitialSharedMode(null);
-    setEditorPresentationEpoch((epoch) => epoch + 1);
-    if (activeWorkspaceId && selectedFile) {
-      saveLastState({ workspaceId: activeWorkspaceId, filePath: selectedFile, view: "wysiwyg" });
-    }
-  }, [closeWelcomeGateway, activeWorkspaceId, selectedFile]);
+    setFocusAfterWelcome(true);
+  }, [closeWelcomeGateway]);
+  useEffect29(() => {
+    if (!focusAfterWelcome || welcomeScreenShown) return;
+    setFocusAfterWelcome(false);
+    editorAreaRef.current?.querySelector('[contenteditable="true"]')?.focus({ preventScroll: true });
+  }, [focusAfterWelcome, welcomeScreenShown]);
   useEffect29(() => {
     const requestId = ++navigationRequestRef.current;
     let cancelled = false;
@@ -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;
     }
@@ -9882,14 +10070,20 @@ function DocBlocksShell({
       "new-folder": () => void handleNewFolder(),
       shortcuts: openKeyboardShortcuts,
       "toggle-sidebar": () => {
+        if (canRestoreSplitView) {
+          updateSidebarPreference("pinned");
+          return;
+        }
         if (singlePane) {
           setMobileShowEditor((showingEditor) => !showingEditor);
           return;
         }
-        updateSidebarPreference(sidebarPreference === "collapsed" ? "pinned" : "collapsed");
+        updateSidebarPreference("collapsed");
+        setMobileShowEditor(true);
       },
       "focus-files": () => {
         if (singlePane) setMobileShowEditor(false);
+        setSidebarView("files");
         window.requestAnimationFrame(() => {
           const tree = document.querySelector(".db-tree");
           const target = tree?.querySelector('.db-tree-row[tabindex="0"]') ?? tree?.querySelector(".db-tree-row");
@@ -9919,7 +10113,7 @@ function DocBlocksShell({
       openKeyboardShortcuts,
       singlePane,
       mobileShowEditor,
-      sidebarPreference,
+      canRestoreSplitView,
       updateSidebarPreference
     ]
   );
@@ -10052,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") {
@@ -10069,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,
@@ -10120,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) {
@@ -10250,44 +10518,32 @@ 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;
       }
       if (target.kind === "fragment") return false;
       if (target.kind === "external") {
-        const shell = maybeGetDocBlocksHost4()?.shell;
-        if (hostSupports2("externalNavigation") && shell?.openExternal) {
-          void 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."
-            );
-          }
-        }
+        void openExternalUrl(target.url).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.");
+            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."
           );
         }
       })();
@@ -10561,7 +10817,7 @@ function DocBlocksShell({
       } finally {
         if (access.owned) {
           try {
-            await getFileSystemProviderV210(access.provider)?.dispose();
+            await getFileSystemProviderV211(access.provider)?.dispose();
           } catch {
           }
         }
@@ -10630,7 +10886,7 @@ function DocBlocksShell({
       } finally {
         if (access.owned) {
           try {
-            await getFileSystemProviderV210(access.provider)?.dispose();
+            await getFileSystemProviderV211(access.provider)?.dispose();
           } catch {
           }
         }
@@ -10648,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,
@@ -10701,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)
     );
@@ -10727,7 +11024,7 @@ function DocBlocksShell({
         throw error;
       }
       if (!isCurrent()) {
-        await getFileSystemProviderV210(mem)?.dispose();
+        await getFileSystemProviderV211(mem)?.dispose();
         await revokeAbandonedResource();
         return;
       }
@@ -10775,7 +11072,7 @@ function DocBlocksShell({
       } finally {
         try {
           if (!adoptionStarted) {
-            await getFileSystemProviderV210(mem)?.dispose();
+            await getFileSystemProviderV211(mem)?.dispose();
           }
         } finally {
           if (!opened) await revokeAbandonedResource();
@@ -10796,6 +11093,7 @@ function DocBlocksShell({
             if (!opened && requestId === navigationRequestRef.current) {
               throw new Error("The requested workspace file is no longer available.");
             }
+            if (opened) closeWelcomeGateway();
             return opened;
           }
         );
@@ -10807,7 +11105,7 @@ function DocBlocksShell({
         );
       });
     });
-  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast]);
+  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast, closeWelcomeGateway]);
   const openTransientFromHandle = useCallback18(
     async (handle) => {
       const name = handle.name;
@@ -10845,7 +11143,7 @@ function DocBlocksShell({
           push: true
         });
       } finally {
-        if (!adoptionStarted) await getFileSystemProviderV210(mem)?.dispose();
+        if (!adoptionStarted) await getFileSystemProviderV211(mem)?.dispose();
       }
     },
     [adoptTransientWorkspace]
@@ -10875,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;
@@ -10885,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 () => {
@@ -10906,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;
@@ -10932,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;
@@ -10959,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 () => {
@@ -11055,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) {
@@ -11083,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);
@@ -11110,7 +11405,7 @@ function DocBlocksShell({
       transitionAwayFromDocument
     ]
   );
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18(
     "div",
     {
       ref: shellRef,
@@ -11119,10 +11414,10 @@ function DocBlocksShell({
       "data-accent": accentColor,
       "data-interface-font": interfaceFont === "fixed" ? "fixed" : void 0,
       "data-document-status": documentSnapshot.status,
-      children: /* @__PURE__ */ jsxs15(GitContext.Provider, { value: git, children: [
+      children: /* @__PURE__ */ jsxs16(GitContext.Provider, { value: git, children: [
         promptDialog,
         confirmDialog,
-        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
           QuickOpenDialog,
           {
             index: workspaceIndex.index,
@@ -11136,8 +11431,8 @@ function DocBlocksShell({
             onClose: () => setQuickOpenOpen(false)
           }
         ) }),
-        shortcutsOpen && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(KeyboardShortcutsDialog, { onClose: () => setShortcutsOpen(false) }) }),
-        newDocumentDialogOpen && /* @__PURE__ */ jsx17(
+        shortcutsOpen && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(KeyboardShortcutsDialog, { onClose: () => setShortcutsOpen(false) }) }),
+        newDocumentDialogOpen && /* @__PURE__ */ jsx18(
           NewDocumentDialog,
           {
             initialFormat: defaultNewFileFormat,
@@ -11147,8 +11442,8 @@ function DocBlocksShell({
             }
           }
         ),
-        workspaceStartupError && /* @__PURE__ */ jsx17("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
-        saveToast && /* @__PURE__ */ jsx17(
+        workspaceStartupError && /* @__PURE__ */ jsx18("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
+        saveToast && /* @__PURE__ */ jsx18(
           "div",
           {
             className: "db-save-toast db-save-toast--" + saveToast.kind,
@@ -11157,12 +11452,12 @@ function DocBlocksShell({
             children: saveToast.message
           }
         ),
-        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx17("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
-        documentSnapshot.conflict && /* @__PURE__ */ jsxs15("div", { className: "db-document-conflict", role: "alert", children: [
-          /* @__PURE__ */ jsx17("span", { children: documentSnapshot.conflict.recoveredDraft ? "A recovery draft from a previous session differs from the saved file. The saved file may be newer. Choose which version to use." : "This document changed outside DocBlocks. Your unsaved version is still intact." }),
-          /* @__PURE__ */ jsx17("div", { className: "db-document-conflict-actions", children: /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => setShowConflictComparison(true), children: "Compare versions" }) })
+        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx18("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
+        documentSnapshot.conflict && /* @__PURE__ */ jsxs16("div", { className: "db-document-conflict", role: "alert", children: [
+          /* @__PURE__ */ jsx18("span", { children: documentSnapshot.conflict.recoveredDraft ? "A recovery draft from a previous session differs from the saved file. The saved file may be newer. Choose which version to use." : "This document changed outside DocBlocks. Your unsaved version is still intact." }),
+          /* @__PURE__ */ jsx18("div", { className: "db-document-conflict-actions", children: /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => setShowConflictComparison(true), children: "Compare versions" }) })
         ] }),
-        documentSnapshot.conflict && showConflictComparison && /* @__PURE__ */ jsx17(Suspense2, { fallback: /* @__PURE__ */ jsx17("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx17(
+        documentSnapshot.conflict && showConflictComparison && /* @__PURE__ */ jsx18(Suspense2, { fallback: /* @__PURE__ */ jsx18("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx18(
           DocumentConflictDialog,
           {
             conflict: documentSnapshot.conflict,
@@ -11172,14 +11467,14 @@ function DocBlocksShell({
             onClose: () => setShowConflictComparison(false)
           }
         ) }),
-        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs15("div", { className: "db-storage-full-banner", role: "alert", children: [
-          /* @__PURE__ */ jsx17("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
-          /* @__PURE__ */ jsxs15("div", { className: "db-storage-full-banner-actions", children: [
-            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Back up all workspaces" }),
-            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
+        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs16("div", { className: "db-storage-full-banner", role: "alert", children: [
+          /* @__PURE__ */ jsx18("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
+          /* @__PURE__ */ jsxs16("div", { className: "db-storage-full-banner-actions", children: [
+            /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Back up all workspaces" }),
+            /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
           ] })
         ] }),
-        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx17(
+        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx18(
           WorkspaceSettingsDialog,
           {
             workspace: activeWorkspaceDescriptor,
@@ -11192,8 +11487,8 @@ function DocBlocksShell({
             onClose: () => setWorkspaceSettingsOpen(false)
           }
         ),
-        /* @__PURE__ */ jsxs15("div", { className: "db-shell-panes", ref: panesRef, children: [
-          /* @__PURE__ */ jsxs15(
+        /* @__PURE__ */ jsxs16("div", { className: "db-shell-panes", ref: panesRef, children: [
+          /* @__PURE__ */ jsxs16(
             "aside",
             {
               ref: sidebarRef,
@@ -11201,8 +11496,8 @@ function DocBlocksShell({
               "aria-label": "Workspace and files",
               style: singlePane ? void 0 : { width: `${sidebarWidth}px` },
               children: [
-                /* @__PURE__ */ jsxs15("div", { className: "db-shell-sidebar-header", children: [
-                  /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsxs16("div", { className: "db-shell-sidebar-header", children: [
+                  /* @__PURE__ */ jsx18(
                     AppMenu,
                     {
                       logoUrl,
@@ -11224,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,
@@ -11236,10 +11532,26 @@ function DocBlocksShell({
                       settingsRequest
                     }
                   ),
-                  /* @__PURE__ */ jsx17(
+                  /* @__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,
                     {
                       activeWorkspaceId,
+                      loading: workspaceStarting,
                       refreshKey: descriptorRefreshKey,
                       onSelect: handleWorkspaceSelect,
                       onOpenFolder: handleOpenFolder,
@@ -11247,7 +11559,7 @@ function DocBlocksShell({
                       onRemoveWorkspace: (workspace) => void handleRemoveWorkspace(workspace.id)
                     }
                   ),
-                  /* @__PURE__ */ jsx17(
+                  /* @__PURE__ */ jsx18(
                     WorkspaceSettingsButton,
                     {
                       onSettings: handleOpenWorkspaceSettings,
@@ -11258,28 +11570,29 @@ function DocBlocksShell({
                       }
                     }
                   ),
-                  canRestoreSplitView && /* @__PURE__ */ jsx17(
+                  canRestoreSplitView && /* @__PURE__ */ jsx18(
                     "button",
                     {
                       className: "db-restore-split",
                       onClick: () => updateSidebarPreference("pinned"),
                       "aria-label": "Restore split view",
                       title: "Restore split view",
-                      children: /* @__PURE__ */ jsx17(SplitViewIcon, {})
+                      children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                     }
                   ),
-                  /* @__PURE__ */ jsx17("span", { className: "db-window-drag-grip", "aria-hidden": true })
+                  /* @__PURE__ */ jsx18("span", { className: "db-window-drag-grip", "aria-hidden": true })
                 ] }),
-                git.available && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                git.available && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   GitUI,
                   {
                     onOpenFile: (path) => void handleSelect(path, "file"),
                     onWorkspaceCloned: handleWorkspaceCloned
                   }
                 ) }),
-                /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsx18(
                   FileExplorer,
                   {
+                    loading: workspaceStarting,
                     className: sidebarView === "search" ? "db-sidebar-view--hidden" : void 0,
                     onShowSearch: canBrowseWorkspace ? openWorkspaceSearch : void 0,
                     searchShortcutLabel: searchShortcut,
@@ -11311,7 +11624,7 @@ function DocBlocksShell({
                   },
                   explorerKey
                 ),
-                searchMounted && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                searchMounted && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   WorkspaceSearchPanel,
                   {
                     index: workspaceIndex.index,
@@ -11322,41 +11635,38 @@ function DocBlocksShell({
                     onShowFiles: () => setSidebarView("files")
                   }
                 ) }),
-                singlePane && showWelcomeGateway && /* @__PURE__ */ jsxs15("section", { className: "db-mobile-first-run", "aria-labelledby": "db-mobile-first-run-title", children: [
-                  /* @__PURE__ */ jsx17("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
-                  /* @__PURE__ */ jsx17("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
-                  /* @__PURE__ */ jsx17("p", { children: "Write visually, keep plain Markdown underneath, and export the same document in useful formats. Keep your documents in the workspace you choose." }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-mobile-first-run-actions", children: [
-                    /* @__PURE__ */ jsx17(
+                singlePane && showWelcomeGateway && /* @__PURE__ */ jsxs16("section", { className: "db-mobile-first-run", "aria-labelledby": "db-mobile-first-run-title", children: [
+                  /* @__PURE__ */ jsx18("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
+                  /* @__PURE__ */ jsx18("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
+                  /* @__PURE__ */ jsxs16("p", { children: [
+                    WELCOME_SUMMARY,
+                    " ",
+                    WELCOME_PRIVACY_NOTE
+                  ] }),
+                  /* @__PURE__ */ jsxs16("div", { className: "db-mobile-first-run-actions", children: [
+                    /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleNewFile(), children: "Create a document" }),
+                    /* @__PURE__ */ jsx18(
                       "button",
                       {
                         type: "button",
+                        className: "db-mobile-first-run-secondary",
                         onClick: () => {
                           closeWelcomeGateway();
                           setMobileShowEditor(true);
                         },
                         children: "Tour the welcome document"
                       }
-                    ),
-                    /* @__PURE__ */ jsx17(
-                      "button",
-                      {
-                        type: "button",
-                        className: "db-mobile-first-run-secondary",
-                        onClick: () => void handleNewFile(),
-                        children: "Create a document"
-                      }
                     )
                   ] })
                 ] }),
-                git.available && git.pendingGrant && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(GitGrantNotice, {}) }),
-                /* @__PURE__ */ jsxs15("div", { className: "db-shell-sidebar-footer", children: [
-                  /* @__PURE__ */ jsx17("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx17("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx17("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
-                  showBrowserStorageWarning && /* @__PURE__ */ jsx17(Fragment11, { children: /* @__PURE__ */ jsxs15(
+                git.available && git.pendingGrant && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(GitGrantNotice, {}) }),
+                /* @__PURE__ */ jsxs16("div", { className: "db-shell-sidebar-footer", children: [
+                  /* @__PURE__ */ jsx18("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx18("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx18("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
+                  showBrowserStorageWarning && /* @__PURE__ */ jsx18(Fragment11, { children: /* @__PURE__ */ jsxs16(
                     "button",
                     {
                       type: "button",
@@ -11365,20 +11675,20 @@ function DocBlocksShell({
                       "aria-label": "Back up all workspaces",
                       title: "Browsers can clear site data. Download a backup of every workspace.",
                       children: [
-                        /* @__PURE__ */ jsx17(BackupIcon, {}),
+                        /* @__PURE__ */ jsx18(BackupIcon, {}),
                         "Back up"
                       ]
                     }
                   ) })
                 ] }),
-                /* @__PURE__ */ jsxs15("div", { className: "db-sidebar-collapse-preview", "aria-hidden": "true", children: [
-                  /* @__PURE__ */ jsx17("span", { className: "db-sidebar-collapse-preview-icon", children: /* @__PURE__ */ jsx17(CollapseSidebarGlyph, {}) }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-sidebar-collapse-preview-label", children: "Release to hide files" })
+                /* @__PURE__ */ jsxs16("div", { className: "db-sidebar-collapse-preview", "aria-hidden": "true", children: [
+                  /* @__PURE__ */ jsx18("span", { className: "db-sidebar-collapse-preview-icon", children: /* @__PURE__ */ jsx18(CollapseSidebarGlyph, {}) }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-sidebar-collapse-preview-label", children: "Release to hide files" })
                 ] })
               ]
             }
           ),
-          !singlePane && /* @__PURE__ */ jsx17(
+          !singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-sidebar-resizer",
@@ -11388,7 +11698,7 @@ function DocBlocksShell({
               onPointerDown: handleResizerPointerDown
             }
           ),
-          singlePane && /* @__PURE__ */ jsx17(
+          singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-scrim",
@@ -11396,7 +11706,7 @@ function DocBlocksShell({
               onPointerDown: () => setMobileShowEditor(true)
             }
           ),
-          /* @__PURE__ */ jsxs15(
+          /* @__PURE__ */ jsxs16(
             "main",
             {
               ref: editorAreaRef,
@@ -11407,8 +11717,8 @@ function DocBlocksShell({
                 editorDropActive ? "db-shell-editor-area--drop-active" : ""
               ].filter(Boolean).join(" "),
               children: [
-                selectedFile && mediaProvider ? /* @__PURE__ */ jsxs15(Fragment11, { children: [
-                  selectedManagedOutput === "catalog-html" ? /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsxs16("div", { ref: welcomeCoveredRef, className: "db-shell-editor-content", children: [
+                  selectedFile && mediaProvider ? /* @__PURE__ */ jsx18(Fragment11, { children: selectedManagedOutput === "catalog-html" ? /* @__PURE__ */ jsx18(
                     GeneratedCatalogPage,
                     {
                       html: editorContent,
@@ -11416,17 +11726,17 @@ function DocBlocksShell({
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0
                     }
-                  ) : /* @__PURE__ */ jsx17(
+                  ) : /* @__PURE__ */ jsx18(
                     GeneratedFileFrame,
                     {
                       kind: selectedManagedOutput,
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0,
-                      children: /* @__PURE__ */ jsx17(
+                      children: /* @__PURE__ */ jsx18(
                         Suspense2,
                         {
-                          fallback: /* @__PURE__ */ jsx17("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
-                          children: editorGenerationSettled && mediaProviderCurrent && /* @__PURE__ */ jsx17(EditorErrorBoundary, { resetKey: `${selectedFile}-${editorKey}`, children: /* @__PURE__ */ jsx17(
+                          fallback: /* @__PURE__ */ jsx18("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
+                          children: editorGenerationSettled && mediaProviderCurrent && /* @__PURE__ */ jsx18(EditorErrorBoundary, { resetKey: `${selectedFile}-${editorKey}`, children: /* @__PURE__ */ jsx18(
                             EditorShell,
                             {
                               initialMarkdown: editorContent,
@@ -11443,6 +11753,7 @@ function DocBlocksShell({
                               saveDashboardImageOutput: saveRenderedImageOutput,
                               onChange: handleEditorChange,
                               onLinkClick: handleEditorLinkClick,
+                              wikiLinks,
                               colorScheme: resolvedTheme,
                               defaultThemeId: workspaceDefaultThemeId,
                               defaultThemeLabel: "Workspace default",
@@ -11476,19 +11787,19 @@ function DocBlocksShell({
                               versioningAutoSaveIdleMs,
                               onSaveVersion,
                               statusBarSlotRight,
-                              sidePanelSlot: ai && aiPanel && selectedImage === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: aiPanel === "review" ? /* @__PURE__ */ jsx17(AiReviewPanel, { ai, onClose: () => setAiPanel(null) }) : /* @__PURE__ */ jsx17(AiIllustratePanel, { ai, onClose: () => setAiPanel(null) }) }) : void 0,
-                              toolbarSlotLeft: singlePane ? /* @__PURE__ */ jsx17(
+                              sidePanelSlot: ai && aiPanel && selectedImage === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: aiPanel === "review" ? /* @__PURE__ */ jsx18(AiReviewPanel, { ai, onClose: () => setAiPanel(null) }) : /* @__PURE__ */ jsx18(AiIllustratePanel, { ai, onClose: () => setAiPanel(null) }) }) : void 0,
+                              toolbarSlotLeft: singlePane ? /* @__PURE__ */ jsx18(
                                 "button",
                                 {
                                   className: "db-mobile-back",
                                   onClick: () => setMobileShowEditor(false),
                                   "aria-label": "Show file list",
-                                  children: /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) })
+                                  children: /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) })
                                 }
                               ) : void 0,
-                              summarizationDesigner: selectedImage === void 0 && selectedManagedOutput === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? (onClose) => /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(PresentationMaker, { ai: ai ?? void 0, onClose }) }) : void 0,
-                              toolbarSlotRight: /* @__PURE__ */ jsxs15(Fragment11, { children: [
-                                canFind && /* @__PURE__ */ jsx17(
+                              summarizationDesigner: selectedImage === void 0 && selectedManagedOutput === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? (onClose) => /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(PresentationMaker, { ai: ai ?? void 0, onClose }) }) : void 0,
+                              toolbarSlotRight: /* @__PURE__ */ jsxs16(Fragment11, { children: [
+                                canFind && /* @__PURE__ */ jsx18(
                                   FindButton,
                                   {
                                     active: findMode,
@@ -11496,7 +11807,7 @@ function DocBlocksShell({
                                     shortcutLabel: findShortcut
                                   }
                                 ),
-                                ai && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                                ai && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                                   AiToolbarControl,
                                   {
                                     ai,
@@ -11505,8 +11816,8 @@ function DocBlocksShell({
                                     onOpenPanel: setAiPanel
                                   }
                                 ) }),
-                                speech && /* @__PURE__ */ jsxs15(Suspense2, { fallback: null, children: [
-                                  /* @__PURE__ */ jsx17(
+                                speech && /* @__PURE__ */ jsxs16(Suspense2, { fallback: null, children: [
+                                  /* @__PURE__ */ jsx18(
                                     TextFromNarration,
                                     {
                                       speech,
@@ -11516,27 +11827,27 @@ function DocBlocksShell({
                                       onOpenSettings: openSettings
                                     }
                                   ),
-                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx17(
+                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx18(
                                     SpeechToolbarControl,
                                     {
                                       speech,
                                       onOpenSettings: openSettings,
                                       readOnly: selectedImage !== void 0 || selectedOutsideIn !== null && !selectedOutsideInEditingEnabled
                                     }
-                                  ) : /* @__PURE__ */ jsx17(SpeechMenuBridge, {})
+                                  ) : /* @__PURE__ */ jsx18(SpeechMenuBridge, {})
                                 ] }),
-                                canRestoreSplitView && /* @__PURE__ */ jsx17(
+                                canRestoreSplitView && /* @__PURE__ */ jsx18(
                                   "button",
                                   {
                                     className: "db-restore-split",
                                     onClick: () => updateSidebarPreference("pinned"),
                                     "aria-label": "Restore split view",
                                     title: "Restore split view",
-                                    children: /* @__PURE__ */ jsx17(SplitViewIcon, {})
+                                    children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                                   }
                                 ),
-                                git.repo && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(GitToolbarControl, { selectedFile }) }),
-                                /* @__PURE__ */ jsx17(
+                                git.repo && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(GitToolbarControl, { selectedFile }) }),
+                                /* @__PURE__ */ jsx18(
                                   ExportToolbarControls,
                                   {
                                     selectedFile,
@@ -11560,87 +11871,77 @@ function DocBlocksShell({
                         }
                       )
                     }
-                  ),
-                  showWelcomeGateway && !singlePane && /* @__PURE__ */ jsxs15("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
-                    /* @__PURE__ */ jsxs15("span", { className: "db-welcome-gateway-text", children: [
-                      "You\u2019re watching this welcome doc in ",
-                      /* @__PURE__ */ jsx17("strong", { children: "Slideshow" }),
-                      " ",
-                      "view\u2014it\u2019s a regular Markdown file, and so is everything you\u2019ll write."
+                  ) }) : selectedFolder ? /* @__PURE__ */ jsxs16("div", { className: "db-folder-view", children: [
+                    singlePane && /* @__PURE__ */ jsxs16("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      "Back to files"
                     ] }),
-                    /* @__PURE__ */ jsx17("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
-                    /* @__PURE__ */ jsx17(
-                      "button",
+                    /* @__PURE__ */ jsxs16("div", { className: "db-folder-view-header", children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      /* @__PURE__ */ jsx18("span", { className: "db-folder-view-path", children: selectedFolder })
+                    ] }),
+                    visibleFolderEntries.length === 0 ? /* @__PURE__ */ jsx18("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx18("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs16(
+                      "li",
                       {
-                        className: "db-welcome-gateway-dismiss",
-                        onClick: closeWelcomeGateway,
-                        "aria-label": "Dismiss welcome tip",
-                        title: "Dismiss",
-                        children: "\xD7"
-                      }
-                    )
-                  ] })
-                ] }) : selectedFolder ? /* @__PURE__ */ jsxs15("div", { className: "db-folder-view", children: [
-                  singlePane && /* @__PURE__ */ jsxs15("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-folder-view-header", children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    /* @__PURE__ */ jsx17("span", { className: "db-folder-view-path", children: selectedFolder })
+                        className: "db-folder-view-item",
+                        onClick: () => handleSelect(entry.path, entry.kind),
+                        children: [
+                          /* @__PURE__ */ jsx18("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx18(FolderGlyph, {}) : /* @__PURE__ */ jsx18(FileGlyph, {}) }),
+                          entry.name
+                        ]
+                      },
+                      entry.path
+                    )) })
+                  ] }) : /* @__PURE__ */ jsxs16("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
+                    singlePane && /* @__PURE__ */ jsxs16("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      "Back to files"
+                    ] }),
+                    /* @__PURE__ */ jsxs16("div", { className: "db-workspace-empty-content", children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(FileGlyph, {}) }),
+                      /* @__PURE__ */ jsx18("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
+                      /* @__PURE__ */ jsx18("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
+                      /* @__PURE__ */ jsxs16("div", { className: "db-workspace-empty-actions", children: [
+                        /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
+                        /* @__PURE__ */ jsx18(
+                          "button",
+                          {
+                            type: "button",
+                            className: "db-workspace-empty-secondary",
+                            onClick: () => void handleNewFolder(),
+                            children: "New folder"
+                          }
+                        ),
+                        (hostSupports2("workspaceFolderPicker") || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx18(
+                          "button",
+                          {
+                            type: "button",
+                            className: "db-workspace-empty-secondary",
+                            onClick: () => void handleOpenFolder(),
+                            children: "Open a folder"
+                          }
+                        )
+                      ] }),
+                      /* @__PURE__ */ jsx18("p", { className: "db-workspace-empty-hint", children: "Use the sidebar backup action to keep a portable copy of this workspace." })
+                    ] })
                   ] }),
-                  visibleFolderEntries.length === 0 ? /* @__PURE__ */ jsx17("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx17("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs15(
-                    "li",
+                  /* @__PURE__ */ jsx18(
+                    UpdateAvailableNotice,
                     {
-                      className: "db-folder-view-item",
-                      onClick: () => handleSelect(entry.path, entry.kind),
-                      children: [
-                        /* @__PURE__ */ jsx17("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx17(FolderGlyph, {}) : /* @__PURE__ */ jsx17(FileGlyph, {}) }),
-                        entry.name
-                      ]
-                    },
-                    entry.path
-                  )) })
-                ] }) : /* @__PURE__ */ jsxs15("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
-                  singlePane && /* @__PURE__ */ jsxs15("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-workspace-empty-content", children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(FileGlyph, {}) }),
-                    /* @__PURE__ */ jsx17("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
-                    /* @__PURE__ */ jsx17("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
-                    /* @__PURE__ */ jsxs15("div", { className: "db-workspace-empty-actions", children: [
-                      /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
-                      /* @__PURE__ */ jsx17(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleNewFolder(),
-                          children: "New folder"
-                        }
-                      ),
-                      (hostSupports2("workspaceFolderPicker") || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx17(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleOpenFolder(),
-                          children: "Open a folder"
-                        }
-                      )
-                    ] }),
-                    /* @__PURE__ */ jsx17("p", { className: "db-workspace-empty-hint", children: "Use the sidebar backup action to keep a portable copy of this workspace." })
-                  ] })
+                      available: updateAvailable,
+                      onApplyUpdate,
+                      blocked: documentSnapshot.conflict !== null || storageFull,
+                      statusBarVisible: updateStatusBarVisible
+                    }
+                  )
                 ] }),
-                /* @__PURE__ */ jsx17(
-                  UpdateAvailableNotice,
+                welcomeScreenShown && /* @__PURE__ */ jsx18(
+                  WelcomeScreen,
                   {
-                    available: updateAvailable,
-                    onApplyUpdate,
-                    blocked: documentSnapshot.conflict !== null || storageFull,
-                    statusBarVisible: updateStatusBarVisible
+                    onCreateDocument: handleNewFile,
+                    onTour: handleTourWelcome,
+                    onDismiss: handleTourWelcome,
+                    offerApps: hostEnvironment === null
                   }
                 )
               ]