@bendyline/docblocks-react 2.7.1 → 2.7.3

package/dist/index.js

@@ -1,4 +1,8 @@
 import {
+  ProgressivePlayer
+} from "./chunk-2IYBBFQX.js";
+import {
+  BackupIcon,
   FolderIcon,
   MoreIcon,
   NewFileIcon,
@@ -10,16 +14,13 @@ import {
   SortByNameIcon,
   SplitViewIcon,
   WorkspaceIcon
-} from "./chunk-EA4BO6E4.js";
+} from "./chunk-DICE7VBJ.js";
 import {
   useConfirmDialog
 } from "./chunk-6B7G33D5.js";
 import {
   createSpeechInputProvider
 } from "./chunk-KBDZDFPU.js";
-import {
-  ProgressivePlayer
-} from "./chunk-2IYBBFQX.js";
 import {
   sharedDocumentFilename
 } from "./chunk-SPUPWCSI.js";
@@ -50,13 +51,13 @@ import {
 } from "./chunk-KWG6UP5O.js";
 import {
   runExport
-} from "./chunk-BCQZTWE5.js";
+} from "./chunk-6PA7QBZT.js";
 import {
   createImageSaveOutput
 } from "./chunk-UONFWKJ7.js";
 import {
   buildExportFilename
-} from "./chunk-UG4G7PJ4.js";
+} from "./chunk-5O5YTOXG.js";
 import {
   createLocalProofingIgnoreStore
 } from "./chunk-DUKTAKB4.js";
@@ -86,28 +87,35 @@ import {
   saveProofingPreferences,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-W55E6TE2.js";
+} from "./chunk-ZMCQO57Q.js";
 import {
   FindButton,
-  findShortcutLabel,
   focusFindInput,
-  isApplePlatform,
-  matchShortcut,
   pickEmptyDocumentPrompt,
-  shortcutLabel,
   useResponsivePreviewViewportPreset
-} from "./chunk-G4MFB3IO.js";
-import "./chunk-EPOLZNFD.js";
-import "./chunk-NAH52736.js";
+} from "./chunk-VG434562.js";
+import {
+  findShortcutLabel,
+  isApplePlatform,
+  matchShortcut,
+  shortcutLabel
+} from "./chunk-ACQF63SB.js";
+import "./chunk-EOU2JWAQ.js";
+import {
+  buildIssueReportUrl,
+  displayBuildDate,
+  localDateStamp,
+  openExternalUrl
+} from "./chunk-YPIVCCTB.js";
 import "./chunk-K4I3NJFL.js";
 import {
   ExportDialog
-} from "./chunk-BD54Z5XP.js";
+} from "./chunk-Y5OE3HJC.js";
 import "./chunk-YBEYTVU2.js";
 import {
   DEFAULT_OPTIONS,
   loadLastExportOptions
-} from "./chunk-X437UAF7.js";
+} from "./chunk-6MSHXQNB.js";
 import {
   Dialog,
   dismissTopmostDialog
@@ -1765,8 +1773,19 @@ import {
 } from "@bendyline/docblocks/workspace-settings";
 var UPDATE_FROM_MARKDOWN_KEY = "squisq-updatefrommarkdown";
 var HTML_OUTPUT_KEY = "squisq-html-output";
+var pdfWorkerSrc = null;
+var configuredPdfWorkerSrc = null;
+function setOutsideInPdfWorker(src) {
+  pdfWorkerSrc = src ?? null;
+}
 async function loadOutsideInModule() {
-  return await import("@bendyline/squisq-formats/outside-in");
+  const outsideIn = await import("@bendyline/squisq-formats/outside-in");
+  if (pdfWorkerSrc && pdfWorkerSrc !== configuredPdfWorkerSrc) {
+    const { configurePdfWorker } = await import("@bendyline/squisq-formats/pdf");
+    configurePdfWorker(pdfWorkerSrc);
+    configuredPdfWorkerSrc = pdfWorkerSrc;
+  }
+  return outsideIn;
 }
 async function readOutsideInMetadata(source) {
   const { readOutsideInMetadata: readMetadata } = await loadOutsideInModule();
@@ -2357,6 +2376,17 @@ function newFileName(name, format) {
   const stem = name.trim().replace(SELECTABLE_FILE_EXTENSION, "");
   return stem ? `${stem}${NEW_FILE_EXTENSIONS[format]}` : null;
 }
+var SAVED_AS = {
+  docx: "Word document",
+  xlsx: "Excel workbook",
+  pdf: "PDF",
+  "web-interactive": "web page",
+  "web-static": "web page"
+};
+function newFileFormatHint(format) {
+  if (format === "markdown") return null;
+  return `You write in Markdown; each save updates the ${SAVED_AS[format]}.`;
+}
 function newFileHtmlOutput(format) {
   if (format === "web-static") return "static";
   if (format === "web-interactive") return "interactive";
@@ -2367,13 +2397,11 @@ function newFileHtmlOutput(format) {
 import { Fragment as Fragment2, jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 function NewFileFormatOptions() {
   return /* @__PURE__ */ jsxs3(Fragment2, { children: [
-    /* @__PURE__ */ jsxs3("optgroup", { label: "Document", children: [
-      /* @__PURE__ */ jsx4("option", { value: "markdown", children: "Markdown (.md)" }),
+    /* @__PURE__ */ jsx4("option", { value: "markdown", children: "Markdown (.md)" }),
+    /* @__PURE__ */ jsxs3("optgroup", { label: "Written in Markdown, saved as", children: [
       /* @__PURE__ */ jsx4("option", { value: "docx", children: "Word document (.docx)" }),
       /* @__PURE__ */ jsx4("option", { value: "xlsx", children: "Excel workbook (.xlsx)" }),
-      /* @__PURE__ */ jsx4("option", { value: "pdf", children: "PDF document (.pdf)" })
-    ] }),
-    /* @__PURE__ */ jsxs3("optgroup", { label: "Web page", children: [
+      /* @__PURE__ */ jsx4("option", { value: "pdf", children: "PDF (.pdf)" }),
       /* @__PURE__ */ jsx4("option", { value: "web-interactive", children: "Web page \u2014 Interactive (.html)" }),
       /* @__PURE__ */ jsx4("option", { value: "web-static", children: "Web page \u2014 Static (.html)" })
     ] })
@@ -2384,6 +2412,7 @@ function NewFileFormatOptions() {
 import { jsx as jsx5, jsxs as jsxs4 } from "react/jsx-runtime";
 var INTERNAL_DRAG_TYPE = "application/x-docblocks-entry";
 var NEW_ITEM_ERROR_ID = "db-new-item-error";
+var NEW_ITEM_HINT_ID = "db-new-item-hint";
 function normalisePath2(path) {
   return parseWorkspacePath4(path);
 }
@@ -2419,6 +2448,7 @@ function isInternalDrag(dataTransfer) {
 }
 function FileExplorer({
   provider,
+  loading = false,
   metadataRefreshKey,
   activeFilePath,
   sortMode,
@@ -3105,6 +3135,7 @@ function FileExplorer({
                     {
                       className: "db-new-item-format",
                       "aria-label": "New file type",
+                      "aria-describedby": newFileFormatHint(newFileFormat) ? NEW_ITEM_HINT_ID : void 0,
                       value: newFileFormat,
                       disabled: newItemCreationPending,
                       onChange: (event) => {
@@ -3119,6 +3150,7 @@ function FileExplorer({
               ]
             }
           ),
+          newItemType === "file" && newFileFormatHint(newFileFormat) && /* @__PURE__ */ jsx5("p", { id: NEW_ITEM_HINT_ID, className: "db-new-item-hint", children: newFileFormatHint(newFileFormat) }),
           newItemError && /* @__PURE__ */ jsx5("div", { id: NEW_ITEM_ERROR_ID, className: "db-tree-error", role: "alert", children: newItemError })
         ] }),
         moveError && /* @__PURE__ */ jsx5("div", { className: "db-tree-error", role: "alert", children: moveError }),
@@ -3143,7 +3175,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,
@@ -3210,6 +3242,7 @@ function WorkspacePicker({
   onCloneRepository,
   onRemoveWorkspace,
   refreshKey,
+  loading = false,
   className
 }) {
   const [workspaces, setWorkspaces] = useState5([]);
@@ -3366,7 +3399,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",
@@ -3636,7 +3669,16 @@ async function prepareHostLifecycle(session, request) {
 }
 
 // src/DocBlocksShell/DocBlocksShell.tsx
-import { useState as useState23, useCallback as useCallback18, useEffect as useEffect29, useRef as useRef19, useMemo as useMemo6, lazy as lazy2, Suspense as Suspense2 } from "react";
+import {
+  useState as useState23,
+  useCallback as useCallback18,
+  useEffect as useEffect29,
+  useLayoutEffect as useLayoutEffect4,
+  useRef as useRef19,
+  useMemo as useMemo6,
+  lazy as lazy2,
+  Suspense as Suspense2
+} from "react";
 import {
   DocumentVersionManager
 } from "@bendyline/squisq/versions";
@@ -3703,6 +3745,14 @@ function readinessSentence(readiness, ready) {
   return readiness.state === "ready" ? ready : readiness.reason ?? "";
 }
 var PREVIEW_TEXT = "This is how I sound when I read your documents aloud.";
+function unreachable(cause) {
+  const detail = cause instanceof Error ? cause.message : void 0;
+  return {
+    code: "unknown",
+    message: "DocBlocks could not check speech on this computer.",
+    ...detail ? { detail } : {}
+  };
+}
 function SpeechSettingsControls({ speech }) {
   const [status, setStatus] = useState6(null);
   const [catalog, setCatalog] = useState6(null);
@@ -3717,11 +3767,15 @@ function SpeechSettingsControls({ speech }) {
   const voiceId = useId2();
   const speedId = useId2();
   const refresh = useCallback7(async () => {
-    const [nextStatus, nextCatalog] = await Promise.all([speech.status(), speech.catalog()]);
-    if (!mounted.current) return;
-    setStatus(nextStatus);
-    if (nextCatalog.ok) setCatalog(nextCatalog.value);
-    else setFailure(nextCatalog.error);
+    try {
+      const [nextStatus, nextCatalog] = await Promise.all([speech.status(), speech.catalog()]);
+      if (!mounted.current) return;
+      setStatus(nextStatus);
+      if (nextCatalog.ok) setCatalog(nextCatalog.value);
+      else setFailure(nextCatalog.error);
+    } catch (cause) {
+      if (mounted.current) setFailure(unreachable(cause));
+    }
   }, [speech]);
   const stopPreview = useCallback7(() => {
     preview.current?.handle.cancel();
@@ -3739,9 +3793,14 @@ function SpeechSettingsControls({ speech }) {
       });
     });
     void refresh();
-    void speech.getPreferences().then((initial) => {
-      if (mounted.current) setPreferences(initial);
-    });
+    void speech.getPreferences().then(
+      (initial) => {
+        if (mounted.current) setPreferences(initial);
+      },
+      (cause) => {
+        if (mounted.current) setFailure(unreachable(cause));
+      }
+    );
     return () => {
       mounted.current = false;
       installHandle.current?.cancel();
@@ -3813,7 +3872,13 @@ function SpeechSettingsControls({ speech }) {
       setPreviewing(false);
     });
   }, [speech, stopPreview]);
-  if (!status || !catalog || !preferences) return null;
+  if (!status || !catalog || !preferences) {
+    if (!failure) return null;
+    return /* @__PURE__ */ jsxs6("fieldset", { className: "db-settings-fieldset", children: [
+      /* @__PURE__ */ jsx7("legend", { className: "db-settings-legend", children: "Speech" }),
+      /* @__PURE__ */ jsx7("p", { className: "db-settings-hint db-settings-ai-error", role: "alert", children: failure.message })
+    ] });
+  }
   const sttModels = catalog.models.filter((model) => model.kind === "stt");
   const ttsModel = catalog.models.find((model) => model.kind === "tts") ?? null;
   const installedStt = sttModels.filter((model) => model.installed);
@@ -3989,6 +4054,7 @@ function formatBytes(bytes) {
   }
   return `${value >= 100 || unit === "B" ? Math.round(value) : value.toFixed(1)} ${unit}`;
 }
+var DOCUMENTATION_URL = "https://docblocks.com/docs/";
 var MORE_INFORMATION_URLS = Object.freeze({
   electron: "https://docblocks.com/desktop/",
   capacitor: "https://docblocks.com/web/",
@@ -3996,9 +4062,10 @@ var MORE_INFORMATION_URLS = Object.freeze({
 });
 function AppMenu({
   logoUrl,
+  logoDarkUrl,
   themePreference = "auto",
   onThemeChange,
-  accentColor = "brown",
+  accentColor = "rust",
   onAccentColorChange,
   interfaceFont = "system",
   onInterfaceFontChange,
@@ -4010,6 +4077,7 @@ function AppMenu({
   onVersioningPreferenceChange,
   onOpenWorkspaceSettings,
   onDownloadAllWorkspaces,
+  onShowKeyboardShortcuts,
   onKeepBrowserData,
   onInstallApp,
   getStorageEstimate,
@@ -4027,7 +4095,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);
@@ -4082,16 +4151,28 @@ function AppMenu({
           "aria-expanded": isOpen,
           "aria-haspopup": "menu",
           children: [
-            logoUrl ? /* @__PURE__ */ jsx8(
-              "img",
-              {
-                src: logoUrl,
-                alt: "DocBlocks",
-                className: "db-app-menu-logo",
-                width: 1266,
-                height: 544
-              }
-            ) : /* @__PURE__ */ jsx8("span", { className: "db-app-menu-label", children: "docblocks" }),
+            logoUrl ? /* @__PURE__ */ jsxs7(Fragment5, { children: [
+              /* @__PURE__ */ jsx8(
+                "img",
+                {
+                  src: logoUrl,
+                  alt: "DocBlocks",
+                  className: `db-app-menu-logo ${logoDarkUrl ? "db-app-menu-logo--light" : "db-app-menu-logo--invert"}`,
+                  width: 557,
+                  height: 242
+                }
+              ),
+              logoDarkUrl && /* @__PURE__ */ jsx8(
+                "img",
+                {
+                  src: logoDarkUrl,
+                  alt: "DocBlocks",
+                  className: "db-app-menu-logo db-app-menu-logo--dark",
+                  width: 557,
+                  height: 242
+                }
+              )
+            ] }) : /* @__PURE__ */ jsx8("span", { className: "db-app-menu-label", children: "docblocks" }),
             /* @__PURE__ */ jsx8(
               "span",
               {
@@ -4130,6 +4211,17 @@ function AppMenu({
                 children: "Install DocBlocks\u2026"
               }
             ),
+            (onDownloadAllWorkspaces || onKeepBrowserData) && /* @__PURE__ */ jsx8("div", { className: "db-app-menu-divider" }),
+            onDownloadAllWorkspaces && /* @__PURE__ */ jsx8(
+              "button",
+              {
+                className: "db-app-menu-item",
+                role: "menuitem",
+                tabIndex: -1,
+                onClick: () => handleAction(() => void onDownloadAllWorkspaces()),
+                children: "Back up all workspaces"
+              }
+            ),
             onKeepBrowserData && /* @__PURE__ */ jsx8(
               "button",
               {
@@ -4140,17 +4232,34 @@ function AppMenu({
                 children: "Protect data from browser cleanup"
               }
             ),
-            onDownloadAllWorkspaces && /* @__PURE__ */ jsx8(
+            /* @__PURE__ */ jsx8("div", { className: "db-app-menu-divider" }),
+            onShowKeyboardShortcuts && /* @__PURE__ */ jsxs7(
               "button",
+              {
+                className: "db-app-menu-item db-app-menu-item--with-shortcut",
+                role: "menuitem",
+                tabIndex: -1,
+                "aria-keyshortcuts": "F1",
+                onClick: () => handleAction(onShowKeyboardShortcuts),
+                children: [
+                  "Keyboard shortcuts",
+                  /* @__PURE__ */ jsx8("span", { className: "db-app-menu-shortcut", "aria-hidden": "true", children: "F1" })
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx8(
+              "a",
               {
                 className: "db-app-menu-item",
                 role: "menuitem",
                 tabIndex: -1,
-                onClick: () => handleAction(() => void onDownloadAllWorkspaces()),
-                children: "Download all workspaces"
+                href: DOCUMENTATION_URL,
+                target: "_blank",
+                rel: "noopener noreferrer",
+                onClick: () => closeMenu(false),
+                children: "Documentation"
               }
             ),
-            /* @__PURE__ */ jsx8("div", { className: "db-app-menu-divider" }),
             /* @__PURE__ */ jsx8(
               "button",
               {
@@ -4288,29 +4397,13 @@ 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 })
       ] }),
       appBuildDate && /* @__PURE__ */ jsxs7("p", { className: "db-about-version", children: [
         /* @__PURE__ */ jsx8("span", { children: "Build" }),
-        /* @__PURE__ */ jsx8("time", { dateTime: appBuildDate, children: appBuildDate })
+        /* @__PURE__ */ jsx8("time", { dateTime: appBuildDate, children: displayBuildDate(appBuildDate) })
       ] }),
       /* @__PURE__ */ jsxs7("p", { children: [
         "Built with",
@@ -4322,6 +4415,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(
@@ -4453,7 +4552,7 @@ function WorkspaceSettingsButton({
               role: "menuitem",
               tabIndex: -1,
               onClick: () => handleAction(onDownload),
-              children: "Download workspace"
+              children: "Back up this workspace"
             }
           ),
           /* @__PURE__ */ jsx9("div", { className: "db-ws-settings-divider" }),
@@ -4896,7 +4995,7 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx12 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-MUM6HM3K.js").then((module) => ({
+  () => import("./ExportToolbarControls-A2YBKUUD.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -5547,14 +5646,34 @@ async function claimOutsideInTarget(provider, desiredPath) {
   }
   throw new Error(`Too many documents are already named like \u201C${desiredPath}\u201D.`);
 }
+function directoriesUnder(files, root) {
+  const directories = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    if (!file.startsWith(`${root}/`)) continue;
+    for (let dir = file.slice(0, file.lastIndexOf("/")); dir.length >= root.length; ) {
+      directories.add(dir);
+      const slash = dir.lastIndexOf("/");
+      if (slash < 0) break;
+      dir = dir.slice(0, slash);
+    }
+  }
+  return [...directories].sort((a, b) => b.split("/").length - a.split("/").length);
+}
+async function removeIfEmptyDirectory(provider, path) {
+  const providerV2 = getFileSystemProviderV27(provider);
+  if (!providerV2) return;
+  await providerV2.remove(parseWorkspacePath6(path), { recursive: false, missing: "ignore" }).catch(() => void 0);
+}
 async function importOutsideInFile(file, provider) {
   const claim = await claimOutsideInTarget(provider, file.name);
   const created = [claim.path];
+  const companionDirectory = resolveOutsideInLayout2(claim.path)?.companionDirectory ?? null;
   try {
     const sourceBytes = await file.arrayBuffer();
     const layout = resolveOutsideInLayout2(claim.path);
     if (!layout) throw new Error(`Outside-in editing does not support \u201C${claim.path}\u201D.`);
-    const imported = await (isOutsideInDataFormat(layout.format) ? importOutsideInDataSidecar({ data: sourceBytes, targetPath: claim.path }) : importOutsideInDocument({ data: sourceBytes, targetPath: claim.path }));
+    const conversionBytes = sourceBytes.slice(0);
+    const imported = await (isOutsideInDataFormat(layout.format) ? importOutsideInDataSidecar({ data: conversionBytes, targetPath: claim.path }) : importOutsideInDocument({ data: conversionBytes, targetPath: claim.path }));
     for (const entry of await imported.container.listFiles()) {
       if (/\.md$/i.test(entry.path)) continue;
       const data = await imported.container.readFile(entry.path);
@@ -5568,9 +5687,14 @@ async function importOutsideInFile(file, provider) {
     await writeProviderBytes(provider, claim.path, sourceBytes, "upsert");
     return claim;
   } catch (error) {
-    for (const path of created.reverse()) {
+    for (const path of [...created].reverse()) {
       await removeProviderEntry(provider, path).catch(() => void 0);
     }
+    if (companionDirectory) {
+      for (const directory of directoriesUnder(created, companionDirectory)) {
+        await removeIfEmptyDirectory(provider, directory);
+      }
+    }
     throw error;
   }
 }
@@ -5762,6 +5886,8 @@ function NewDocumentDialog({
   const inputRef = useRef15(null);
   const nameId = useId4();
   const formatId = useId4();
+  const hintId = useId4();
+  const hint = newFileFormatHint(format);
   const filename = newFileName(name, format);
   const cancel = useCallback15(() => onSettle(null), [onSettle]);
   const submit = useCallback15(() => {
@@ -5814,16 +5940,44 @@ function NewDocumentDialog({
           {
             id: formatId,
             className: "db-git-form-input",
+            "aria-describedby": hint ? hintId : void 0,
             value: format,
             onChange: (e) => setFormat(e.target.value),
             children: /* @__PURE__ */ jsx14(NewFileFormatOptions, {})
           }
-        )
+        ),
+        hint && /* @__PURE__ */ jsx14("p", { id: hintId, className: "db-new-document-hint", children: hint })
       ] })
     }
   );
 }
 
+// src/DocBlocksShell/EditorErrorBoundary.tsx
+import { Component } from "react";
+import { jsx as jsx15, jsxs as jsxs13 } from "react/jsx-runtime";
+var EditorErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null, resetKey: this.props.resetKey };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  static getDerivedStateFromProps(props, state) {
+    return props.resetKey === state.resetKey ? null : { error: null, resetKey: props.resetKey };
+  }
+  render() {
+    const { error } = this.state;
+    if (!error) return this.props.children;
+    return /* @__PURE__ */ jsx15("div", { className: "db-shell-empty db-shell-empty--workspace", role: "alert", children: /* @__PURE__ */ jsxs13("div", { className: "db-workspace-empty-content", children: [
+      /* @__PURE__ */ jsx15("h1", { children: "This document couldn\u2019t be displayed" }),
+      /* @__PURE__ */ jsx15("p", { children: "The editor ran into a problem drawing it. The document itself is unaffected." }),
+      /* @__PURE__ */ jsx15("div", { className: "db-workspace-empty-actions", children: /* @__PURE__ */ jsx15("button", { type: "button", onClick: () => this.setState({ error: null }), children: "Try again" }) }),
+      /* @__PURE__ */ jsx15("p", { className: "db-workspace-empty-hint", children: error.message })
+    ] }) });
+  }
+};
+
 // src/preferences/new-file-format.ts
 var STORAGE_KEY2 = "docblocks:lastNewFileFormat";
 var MAX_REMEMBERED_WORKSPACES = 200;
@@ -5883,35 +6037,6 @@ 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: ${environment.reportedAt.toISOString().slice(0, 10)}`,
-    `- 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";
 var LAST_STATE_KEY = "docblocks:lastState";
@@ -6317,11 +6442,11 @@ function useInterfaceFontAttribute(preference) {
   useEffect24(() => {
     if (typeof document === "undefined") return;
     const root = document.documentElement;
-    if (preference !== "fixed") {
+    if (preference !== "system") {
       root.removeAttribute(INTERFACE_FONT_ATTRIBUTE);
       return;
     }
-    root.setAttribute(INTERFACE_FONT_ATTRIBUTE, "fixed");
+    root.setAttribute(INTERFACE_FONT_ATTRIBUTE, "system");
     return () => root.removeAttribute(INTERFACE_FONT_ATTRIBUTE);
   }, [preference]);
 }
@@ -6510,7 +6635,7 @@ function useShellShortcuts(handlers, layoutMode) {
 
 // src/DocBlocksShell/UpdateAvailableNotice.tsx
 import { useState as useState21 } from "react";
-import { Fragment as Fragment10, jsx as jsx15, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Fragment as Fragment10, jsx as jsx16, jsxs as jsxs14 } from "react/jsx-runtime";
 var UPDATE_PROMPT_ID = "db-update-available-prompt";
 function UpdateAvailableNotice({
   available,
@@ -6522,8 +6647,8 @@ function UpdateAvailableNotice({
   const [applying, setApplying] = useState21(false);
   if (!available || !onApplyUpdate) return null;
   const promptVisible = promptOpen && !blocked;
-  return /* @__PURE__ */ jsxs13(Fragment10, { children: [
-    /* @__PURE__ */ jsx15(
+  return /* @__PURE__ */ jsxs14(Fragment10, { children: [
+    /* @__PURE__ */ jsx16(
       "button",
       {
         type: "button",
@@ -6537,16 +6662,16 @@ function UpdateAvailableNotice({
         children: "Update available"
       }
     ),
-    promptVisible && /* @__PURE__ */ jsxs13(
+    promptVisible && /* @__PURE__ */ jsxs14(
       "div",
       {
         id: UPDATE_PROMPT_ID,
         className: `db-update-banner${statusBarVisible ? "" : " db-update-banner--floating"}`,
         role: "alert",
         children: [
-          /* @__PURE__ */ jsx15("span", { children: "A new version of DocBlocks is available. Reload to update the editor and site pages." }),
-          /* @__PURE__ */ jsxs13("div", { className: "db-update-banner-actions", children: [
-            /* @__PURE__ */ jsx15(
+          /* @__PURE__ */ jsx16("span", { children: "A new version of DocBlocks is available. Reload to update the editor and site pages." }),
+          /* @__PURE__ */ jsxs14("div", { className: "db-update-banner-actions", children: [
+            /* @__PURE__ */ jsx16(
               "button",
               {
                 type: "button",
@@ -6558,7 +6683,7 @@ function UpdateAvailableNotice({
                 children: applying ? "Updating\u2026" : "Reload"
               }
             ),
-            /* @__PURE__ */ jsx15("button", { type: "button", onClick: () => setPromptOpen(false), disabled: applying, children: "Later" })
+            /* @__PURE__ */ jsx16("button", { type: "button", onClick: () => setPromptOpen(false), disabled: applying, children: "Later" })
           ] })
         ]
       }
@@ -6566,6 +6691,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";
 
@@ -6940,7 +7163,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;
 }
@@ -6950,126 +7181,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.",
+  '# Welcome to DocBlocks {[title subtitle="Write once. Share it as a document, a deck, or a video."]}',
   "",
-  '## 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."]}',
+  "This is an ordinary document, so go ahead and change it. Click anywhere and type; DocBlocks saves as you go.",
   "",
-  "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.",
+  "## Write the way you already do {[list]}",
   "",
-  "## Get started on desktop {[list]}",
+  "- 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.",
   "",
-  "- 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.",
-  "",
-  "## 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 **Download 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.",
+  "## Present it or send it {[content]}",
   "",
-  "## The quiet conveniences are there, too {[list]}",
+  "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.",
   "",
-  "- **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.",
+  "## Your documents stay yours {[factCard]}",
   "",
-  "## Export without rebuilding the document {[list]}",
+  "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.",
   "",
-  "- 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**.",
+  "## Make your own {[list]}",
   "",
-  "## Local-first is concrete, not decorative {[quote]}",
+  "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.",
   "",
-  "> 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.",
+  "## Go further {[list]}",
   "",
-  "## Agents get document tools, not a blank check {[factCard]}",
-  "",
-  "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.",
-  "",
-  "## Take your documents to another app {[content]}",
-  "",
-  "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.",
-  "",
-  "## 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 jsx16, jsxs as jsxs14 } 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 () => {
@@ -7086,8 +7248,11 @@ var GitUI = lazy2(() => import("./GitUI-RCWUZVS6.js").then((m) => ({ default: m.
 var QuickOpenDialog = lazy2(
   () => import("./QuickOpenDialog-2KK4SEBU.js").then((m) => ({ default: m.QuickOpenDialog }))
 );
+var KeyboardShortcutsDialog = lazy2(
+  () => import("./KeyboardShortcutsDialog-G5OBDTNR.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
+);
 var WorkspaceSearchPanel = lazy2(
-  () => import("./WorkspaceSearchPanel-BKZJRPMY.js").then((m) => ({
+  () => import("./WorkspaceSearchPanel-J6BKEZQJ.js").then((m) => ({
     default: m.WorkspaceSearchPanel
   }))
 );
@@ -7098,43 +7263,44 @@ var GitToolbarControl = lazy2(
   () => import("./GitToolbarControl-B7KG4MFP.js").then((m) => ({ default: m.GitToolbarControl }))
 );
 var AiToolbarControl = lazy2(
-  () => import("./AiEditorAssistant-GN2KXKZD.js").then((module) => ({
+  () => import("./AiEditorAssistant-YLJ5OZK2.js").then((module) => ({
     default: module.AiToolbarControl
   }))
 );
 var PresentationMaker = lazy2(
-  () => import("./PresentationMaker-W2JIBHRN.js").then((module) => ({
+  () => import("./PresentationMaker-P2JP6UUX.js").then((module) => ({
     default: module.PresentationMaker
   }))
 );
 var AiReviewPanel = lazy2(
-  () => import("./AiEditorAssistant-GN2KXKZD.js").then((module) => ({
+  () => import("./AiEditorAssistant-YLJ5OZK2.js").then((module) => ({
     default: module.AiReviewPanel
   }))
 );
 var AiIllustratePanel = lazy2(
-  () => import("./AiDiagrams-LFV4YU6W.js").then((module) => ({
+  () => import("./AiDiagrams-QE3LVYFK.js").then((module) => ({
     default: module.AiIllustratePanel
   }))
 );
 var TextFromNarration = lazy2(
-  () => import("./TextFromNarration-XYRAB6O2.js").then((module) => ({
+  () => import("./TextFromNarration-NITJQ4IB.js").then((module) => ({
     default: module.TextFromNarration
   }))
 );
 var SpeechToolbarControl = lazy2(
-  () => import("./SpeechToolbarControl-OSQS7NVY.js").then((module) => ({
+  () => import("./SpeechToolbarControl-CLU7RB2G.js").then((module) => ({
     default: module.SpeechToolbarControl
   }))
 );
 var SpeechMenuBridge = lazy2(
-  () => import("./SpeechToolbarControl-OSQS7NVY.js").then((module) => ({
+  () => import("./SpeechToolbarControl-CLU7RB2G.js").then((module) => ({
     default: module.SpeechMenuBridge
   }))
 );
 var DOCBLOCKS_VIDEO_EXPORT_PALETTE = Object.freeze({
   overlay: "rgba(0, 0, 0, 0.72)",
-  surface: "var(--db-bg)",
+  // A dialog floats over the chrome, so it takes the raised surface.
+  surface: "var(--db-bg-raised)",
   control: "var(--db-bg-subtle)",
   border: "var(--db-border-strong)",
   text: "var(--db-text)",
@@ -7394,7 +7560,7 @@ async function createHostProviderFromWorkspace(ws) {
 var DESKTOP_TOOLBAR_WRAP_WIDTH = 900;
 var WEB_TOOLBAR_WRAP_WIDTH = 700;
 function FolderGlyph() {
-  return /* @__PURE__ */ jsx16(
+  return /* @__PURE__ */ jsx18(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7403,12 +7569,12 @@ function FolderGlyph() {
       strokeWidth: "1.5",
       strokeLinejoin: "round",
       "aria-hidden": "true",
-      children: /* @__PURE__ */ jsx16("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__ */ jsxs14(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7418,14 +7584,14 @@ function FileGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx16("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
-        /* @__PURE__ */ jsx16("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__ */ jsxs14(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 64 64",
@@ -7436,9 +7602,9 @@ function CollapseSidebarGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx16("rect", { x: "7", y: "10", width: "50", height: "44", rx: "6" }),
-        /* @__PURE__ */ jsx16("path", { d: "M24 10v44" }),
-        /* @__PURE__ */ jsx16("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" })
       ]
     }
   );
@@ -7446,9 +7612,11 @@ function CollapseSidebarGlyph() {
 function DocBlocksShell({
   theme: hostTheme = "auto",
   logoUrl,
+  logoDarkUrl,
   issueReportVersion,
   appBuildDate,
   ffmpegWasm,
+  pdfWorkerSrc: pdfWorkerSrc2,
   calcEngineFactory,
   proofing,
   proofingDefaultEnabled,
@@ -7668,6 +7836,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(() => {
@@ -7918,6 +8087,8 @@ function DocBlocksShell({
   const findShortcut = useMemo6(findShortcutLabel, []);
   const searchShortcut = useMemo6(() => shortcutLabel("workspace-search", isApplePlatform()), []);
   const [quickOpenOpen, setQuickOpenOpen] = useState23(false);
+  const [shortcutsOpen, setShortcutsOpen] = useState23(false);
+  const openKeyboardShortcuts = useCallback18(() => setShortcutsOpen(true), []);
   const [quickOpenFocusRequest, setQuickOpenFocusRequest] = useState23(0);
   const [sidebarView, setSidebarView] = useState23("files");
   const [searchMounted, setSearchMounted] = useState23(false);
@@ -8019,8 +8190,20 @@ function DocBlocksShell({
     } : null,
     [documentSnapshot.frozen, documentSnapshot.generation, documentSnapshot.targetKey]
   );
-  const [editorPresentationEpoch, setEditorPresentationEpoch] = useState23(0);
-  const editorKey = `${documentSnapshot.generation}:${editorPresentationEpoch}`;
+  const [editorGeneration, setEditorGeneration] = useState23(documentSnapshot.generation);
+  useEffect29(() => {
+    const sync = () => setEditorGeneration(documentSession.getSnapshot().generation);
+    const unsubscribe = documentSession.subscribe(sync);
+    sync();
+    return () => {
+      unsubscribe();
+    };
+  }, [documentSession]);
+  const editorGenerationSettled = editorGeneration === documentSnapshot.generation;
+  useEffect29(() => {
+    setOutsideInPdfWorker(pdfWorkerSrc2);
+  }, [pdfWorkerSrc2]);
+  const editorKey = String(editorGeneration);
   const editorPlaceholder = useMemo6(() => {
     void editorKey;
     return pickEmptyDocumentPrompt();
@@ -8040,6 +8223,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(), []);
@@ -8230,6 +8422,8 @@ function DocBlocksShell({
   );
   const mediaContainerRef = useRef19(null);
   const [mediaProvider, setMediaProvider] = useState23(null);
+  const [mediaProviderScope, setMediaProviderScope] = useState23(null);
+  const mediaProviderCurrent = mediaProviderScope !== null && mediaProviderScope.provider === provider && mediaProviderScope.file === selectedFile && mediaProviderScope.outsideIn === selectedOutsideIn;
   const [mediaEpoch, setMediaEpoch] = useState23(0);
   const versionsContainerRef = useRef19(null);
   const [versionsContainer, setVersionsContainer] = useState23(null);
@@ -8346,6 +8540,7 @@ function DocBlocksShell({
           options.navigationRequestId,
           options.sharedMode ?? null
         ) !== null;
+        if (opened) closeWelcomeGateway();
         return opened;
       } finally {
         if (!opened && getTransientWorkspace(options.id)?.provider === options.provider) {
@@ -8353,7 +8548,7 @@ function DocBlocksShell({
         }
       }
     },
-    [openFromIds]
+    [openFromIds, closeWelcomeGateway]
   );
   const openSharedDocument = useCallback18(
     async (payload, navigationRequestId) => {
@@ -8395,18 +8590,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;
@@ -8430,11 +8625,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]
@@ -8445,21 +8640,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;
@@ -8824,14 +9014,16 @@ function DocBlocksShell({
     }).catch(() => {
     });
   }, [showBrowserStorageWarning, browserStoragePersistent, documentSnapshot.status]);
-  useEffect29(() => {
+  useLayoutEffect4(() => {
     if (!provider || !selectedFile) {
       mediaContainerRef.current = null;
       versionsContainerRef.current = null;
       setMediaProvider(null);
+      setMediaProviderScope(null);
       setVersionsContainer(null);
       return;
     }
+    setMediaProviderScope({ provider, file: selectedFile, outsideIn: selectedOutsideIn });
     if (selectedOutsideIn) {
       const container2 = createOutsideInContentContainer(provider, selectedOutsideIn);
       const mp2 = createMediaProviderFromContainer(container2);
@@ -9688,15 +9880,22 @@ function DocBlocksShell({
       ...canBrowseWorkspace ? { "quick-open": openQuickOpen, "workspace-search": openWorkspaceSearch } : {},
       "new-document": () => void handleNewFile(),
       "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");
@@ -9723,9 +9922,10 @@ function DocBlocksShell({
       saveActiveDocument,
       handleNewFile,
       handleNewFolder,
+      openKeyboardShortcuts,
       singlePane,
       mobileShowEditor,
-      sidebarPreference,
+      canRestoreSplitView,
       updateSidebarPreference
     ]
   );
@@ -10062,24 +10262,12 @@ function DocBlocksShell({
       }
       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 () => {
@@ -10602,6 +10790,7 @@ function DocBlocksShell({
             if (!opened && requestId === navigationRequestRef.current) {
               throw new Error("The requested workspace file is no longer available.");
             }
+            if (opened) closeWelcomeGateway();
             return opened;
           }
         );
@@ -10613,7 +10802,7 @@ function DocBlocksShell({
         );
       });
     });
-  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast]);
+  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast, closeWelcomeGateway]);
   const openTransientFromHandle = useCallback18(
     async (handle) => {
       const name = handle.name;
@@ -10759,8 +10948,7 @@ function DocBlocksShell({
       const url = URL.createObjectURL(blob);
       const a = document.createElement("a");
       a.href = url;
-      const stamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      a.download = `docblocks-workspaces-${stamp}.zip`;
+      a.download = `docblocks-workspaces-${localDateStamp(/* @__PURE__ */ new Date())}.zip`;
       a.click();
       URL.revokeObjectURL(url);
       if (skipped.length > 0) {
@@ -10780,7 +10968,7 @@ function DocBlocksShell({
     if (!storage || typeof storage.persist !== "function") {
       await acknowledge({
         title: "Persistent storage unavailable",
-        message: "This browser does not support persistent storage requests. Please back up browser docs frequently."
+        message: "This browser does not support persistent storage requests. Use Back up all workspaces regularly."
       });
       return;
     }
@@ -10796,18 +10984,18 @@ function DocBlocksShell({
         setBrowserStoragePersistent(true);
         await acknowledge({
           title: "Storage will be kept for longer",
-          message: "This browser will try to keep DocBlocks data for longer. Please still back up browser docs frequently."
+          message: "This browser will try to keep DocBlocks data for longer. Keep using Back up all workspaces regularly."
         });
       } else {
         await acknowledge({
           title: "Storage request declined",
-          message: "The browser did not grant permanent storage for DocBlocks. Please try again in a day or two. Meanwhile, please back up browser documents frequently."
+          message: "The browser did not grant permanent storage for DocBlocks. Please try again in a day or two. Meanwhile, use Back up all workspaces regularly."
         });
       }
     } catch {
       await acknowledge({
         title: "Storage request failed",
-        message: "DocBlocks could not request persistent browser storage. Please back up browser docs frequently."
+        message: "DocBlocks could not request persistent browser storage. Use Back up all workspaces regularly."
       });
     }
   }, [acknowledge, showToast]);
@@ -10917,7 +11105,7 @@ function DocBlocksShell({
       transitionAwayFromDocument
     ]
   );
-  return /* @__PURE__ */ jsx16(
+  return /* @__PURE__ */ jsx18(
     "div",
     {
       ref: shellRef,
@@ -10926,10 +11114,10 @@ function DocBlocksShell({
       "data-accent": accentColor,
       "data-interface-font": interfaceFont === "fixed" ? "fixed" : void 0,
       "data-document-status": documentSnapshot.status,
-      children: /* @__PURE__ */ jsxs14(GitContext.Provider, { value: git, children: [
+      children: /* @__PURE__ */ jsxs16(GitContext.Provider, { value: git, children: [
         promptDialog,
         confirmDialog,
-        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(
+        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
           QuickOpenDialog,
           {
             index: workspaceIndex.index,
@@ -10943,7 +11131,8 @@ function DocBlocksShell({
             onClose: () => setQuickOpenOpen(false)
           }
         ) }),
-        newDocumentDialogOpen && /* @__PURE__ */ jsx16(
+        shortcutsOpen && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(KeyboardShortcutsDialog, { onClose: () => setShortcutsOpen(false) }) }),
+        newDocumentDialogOpen && /* @__PURE__ */ jsx18(
           NewDocumentDialog,
           {
             initialFormat: defaultNewFileFormat,
@@ -10953,8 +11142,8 @@ function DocBlocksShell({
             }
           }
         ),
-        workspaceStartupError && /* @__PURE__ */ jsx16("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
-        saveToast && /* @__PURE__ */ jsx16(
+        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,
@@ -10963,12 +11152,12 @@ function DocBlocksShell({
             children: saveToast.message
           }
         ),
-        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx16("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
-        documentSnapshot.conflict && /* @__PURE__ */ jsxs14("div", { className: "db-document-conflict", role: "alert", children: [
-          /* @__PURE__ */ jsx16("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__ */ jsx16("div", { className: "db-document-conflict-actions", children: /* @__PURE__ */ jsx16("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__ */ jsx16(Suspense2, { fallback: /* @__PURE__ */ jsx16("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx16(
+        documentSnapshot.conflict && showConflictComparison && /* @__PURE__ */ jsx18(Suspense2, { fallback: /* @__PURE__ */ jsx18("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx18(
           DocumentConflictDialog,
           {
             conflict: documentSnapshot.conflict,
@@ -10978,14 +11167,14 @@ function DocBlocksShell({
             onClose: () => setShowConflictComparison(false)
           }
         ) }),
-        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs14("div", { className: "db-storage-full-banner", role: "alert", children: [
-          /* @__PURE__ */ jsx16("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
-          /* @__PURE__ */ jsxs14("div", { className: "db-storage-full-banner-actions", children: [
-            /* @__PURE__ */ jsx16("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Download all workspaces" }),
-            /* @__PURE__ */ jsx16("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__ */ jsx16(
+        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx18(
           WorkspaceSettingsDialog,
           {
             workspace: activeWorkspaceDescriptor,
@@ -10998,8 +11187,8 @@ function DocBlocksShell({
             onClose: () => setWorkspaceSettingsOpen(false)
           }
         ),
-        /* @__PURE__ */ jsxs14("div", { className: "db-shell-panes", ref: panesRef, children: [
-          /* @__PURE__ */ jsxs14(
+        /* @__PURE__ */ jsxs16("div", { className: "db-shell-panes", ref: panesRef, children: [
+          /* @__PURE__ */ jsxs16(
             "aside",
             {
               ref: sidebarRef,
@@ -11007,11 +11196,12 @@ function DocBlocksShell({
               "aria-label": "Workspace and files",
               style: singlePane ? void 0 : { width: `${sidebarWidth}px` },
               children: [
-                /* @__PURE__ */ jsxs14("div", { className: "db-shell-sidebar-header", children: [
-                  /* @__PURE__ */ jsx16(
+                /* @__PURE__ */ jsxs16("div", { className: "db-shell-sidebar-header", children: [
+                  /* @__PURE__ */ jsx18(
                     AppMenu,
                     {
                       logoUrl,
+                      logoDarkUrl,
                       themePreference,
                       onThemeChange: handleThemeChange,
                       accentColor,
@@ -11029,6 +11219,7 @@ function DocBlocksShell({
                       onVersioningPreferenceChange: handleVersioningPreferenceChange,
                       onOpenWorkspaceSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onDownloadAllWorkspaces: handleDownloadAllWorkspaces,
+                      onShowKeyboardShortcuts: singlePane ? void 0 : openKeyboardShortcuts,
                       onKeepBrowserData: showBrowserStorageWarning && !browserStoragePersistent ? handleKeepBrowserData : void 0,
                       onInstallApp: installPromptEvent ? handleInstallApp : void 0,
                       getStorageEstimate: showBrowserStorageWarning ? getBrowserStorageEstimate : void 0,
@@ -11040,10 +11231,11 @@ function DocBlocksShell({
                       settingsRequest
                     }
                   ),
-                  /* @__PURE__ */ jsx16(
+                  /* @__PURE__ */ jsx18(
                     WorkspacePicker,
                     {
                       activeWorkspaceId,
+                      loading: workspaceStarting,
                       refreshKey: descriptorRefreshKey,
                       onSelect: handleWorkspaceSelect,
                       onOpenFolder: handleOpenFolder,
@@ -11051,7 +11243,7 @@ function DocBlocksShell({
                       onRemoveWorkspace: (workspace) => void handleRemoveWorkspace(workspace.id)
                     }
                   ),
-                  /* @__PURE__ */ jsx16(
+                  /* @__PURE__ */ jsx18(
                     WorkspaceSettingsButton,
                     {
                       onSettings: handleOpenWorkspaceSettings,
@@ -11062,28 +11254,29 @@ function DocBlocksShell({
                       }
                     }
                   ),
-                  canRestoreSplitView && /* @__PURE__ */ jsx16(
+                  canRestoreSplitView && /* @__PURE__ */ jsx18(
                     "button",
                     {
                       className: "db-restore-split",
                       onClick: () => updateSidebarPreference("pinned"),
                       "aria-label": "Restore split view",
                       title: "Restore split view",
-                      children: /* @__PURE__ */ jsx16(SplitViewIcon, {})
+                      children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                     }
                   ),
-                  /* @__PURE__ */ jsx16("span", { className: "db-window-drag-grip", "aria-hidden": true })
+                  /* @__PURE__ */ jsx18("span", { className: "db-window-drag-grip", "aria-hidden": true })
                 ] }),
-                git.available && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(
+                git.available && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   GitUI,
                   {
                     onOpenFile: (path) => void handleSelect(path, "file"),
                     onWorkspaceCloned: handleWorkspaceCloned
                   }
                 ) }),
-                /* @__PURE__ */ jsx16(
+                /* @__PURE__ */ jsx18(
                   FileExplorer,
                   {
+                    loading: workspaceStarting,
                     className: sidebarView === "search" ? "db-sidebar-view--hidden" : void 0,
                     onShowSearch: canBrowseWorkspace ? openWorkspaceSearch : void 0,
                     searchShortcutLabel: searchShortcut,
@@ -11115,7 +11308,7 @@ function DocBlocksShell({
                   },
                   explorerKey
                 ),
-                searchMounted && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(
+                searchMounted && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   WorkspaceSearchPanel,
                   {
                     index: workspaceIndex.index,
@@ -11126,62 +11319,60 @@ function DocBlocksShell({
                     onShowFiles: () => setSidebarView("files")
                   }
                 ) }),
-                singlePane && showWelcomeGateway && /* @__PURE__ */ jsxs14("section", { className: "db-mobile-first-run", "aria-labelledby": "db-mobile-first-run-title", children: [
-                  /* @__PURE__ */ jsx16("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
-                  /* @__PURE__ */ jsx16("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
-                  /* @__PURE__ */ jsx16("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__ */ jsxs14("div", { className: "db-mobile-first-run-actions", children: [
-                    /* @__PURE__ */ jsx16(
+                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__ */ jsx16(
-                      "button",
-                      {
-                        type: "button",
-                        className: "db-mobile-first-run-secondary",
-                        onClick: () => void handleNewFile(),
-                        children: "Create a document"
-                      }
                     )
                   ] })
                 ] }),
-                git.available && git.pendingGrant && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(GitGrantNotice, {}) }),
-                /* @__PURE__ */ jsxs14("div", { className: "db-shell-sidebar-footer", children: [
-                  /* @__PURE__ */ jsx16("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
-                  /* @__PURE__ */ jsx16("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx16("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
-                  /* @__PURE__ */ jsx16("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx16("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
-                  showBrowserStorageWarning && /* @__PURE__ */ jsxs14(Fragment11, { children: [
-                    /* @__PURE__ */ jsx16("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                    /* @__PURE__ */ jsx16(
-                      "button",
-                      {
-                        type: "button",
-                        className: "db-shell-sidebar-footer-action",
-                        onClick: () => void handleDownloadAllWorkspaces(),
-                        title: "Browser documents can be removed automatically. Download all workspaces now.",
-                        children: "Back up browser docs"
-                      }
-                    )
-                  ] })
+                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",
+                      className: "db-shell-sidebar-footer-action",
+                      onClick: () => void handleDownloadAllWorkspaces(),
+                      "aria-label": "Back up all workspaces",
+                      title: "Browsers can clear site data. Download a backup of every workspace.",
+                      children: [
+                        /* @__PURE__ */ jsx18(BackupIcon, {}),
+                        "Back up"
+                      ]
+                    }
+                  ) })
                 ] }),
-                /* @__PURE__ */ jsxs14("div", { className: "db-sidebar-collapse-preview", "aria-hidden": "true", children: [
-                  /* @__PURE__ */ jsx16("span", { className: "db-sidebar-collapse-preview-icon", children: /* @__PURE__ */ jsx16(CollapseSidebarGlyph, {}) }),
-                  /* @__PURE__ */ jsx16("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__ */ jsx16(
+          !singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-sidebar-resizer",
@@ -11191,7 +11382,7 @@ function DocBlocksShell({
               onPointerDown: handleResizerPointerDown
             }
           ),
-          singlePane && /* @__PURE__ */ jsx16(
+          singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-scrim",
@@ -11199,7 +11390,7 @@ function DocBlocksShell({
               onPointerDown: () => setMobileShowEditor(true)
             }
           ),
-          /* @__PURE__ */ jsxs14(
+          /* @__PURE__ */ jsxs16(
             "main",
             {
               ref: editorAreaRef,
@@ -11210,8 +11401,8 @@ function DocBlocksShell({
                 editorDropActive ? "db-shell-editor-area--drop-active" : ""
               ].filter(Boolean).join(" "),
               children: [
-                selectedFile && mediaProvider ? /* @__PURE__ */ jsxs14(Fragment11, { children: [
-                  selectedManagedOutput === "catalog-html" ? /* @__PURE__ */ jsx16(
+                /* @__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,
@@ -11219,17 +11410,17 @@ function DocBlocksShell({
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0
                     }
-                  ) : /* @__PURE__ */ jsx16(
+                  ) : /* @__PURE__ */ jsx18(
                     GeneratedFileFrame,
                     {
                       kind: selectedManagedOutput,
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0,
-                      children: /* @__PURE__ */ jsx16(
+                      children: /* @__PURE__ */ jsx18(
                         Suspense2,
                         {
-                          fallback: /* @__PURE__ */ jsx16("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
-                          children: /* @__PURE__ */ jsx16(
+                          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,
@@ -11247,6 +11438,8 @@ function DocBlocksShell({
                               onChange: handleEditorChange,
                               onLinkClick: handleEditorLinkClick,
                               colorScheme: resolvedTheme,
+                              defaultThemeId: workspaceDefaultThemeId,
+                              defaultThemeLabel: "Workspace default",
                               writeCanvasSettings: editorWriteCanvasSettings,
                               height: "100%",
                               placeholder: editorPlaceholder,
@@ -11277,19 +11470,19 @@ function DocBlocksShell({
                               versioningAutoSaveIdleMs,
                               onSaveVersion,
                               statusBarSlotRight,
-                              sidePanelSlot: ai && aiPanel && selectedImage === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: aiPanel === "review" ? /* @__PURE__ */ jsx16(AiReviewPanel, { ai, onClose: () => setAiPanel(null) }) : /* @__PURE__ */ jsx16(AiIllustratePanel, { ai, onClose: () => setAiPanel(null) }) }) : void 0,
-                              toolbarSlotLeft: singlePane ? /* @__PURE__ */ jsx16(
+                              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__ */ jsx16("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx16(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__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(PresentationMaker, { ai: ai ?? void 0, onClose }) }) : void 0,
-                              toolbarSlotRight: /* @__PURE__ */ jsxs14(Fragment11, { children: [
-                                canFind && /* @__PURE__ */ jsx16(
+                              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,
@@ -11297,7 +11490,7 @@ function DocBlocksShell({
                                     shortcutLabel: findShortcut
                                   }
                                 ),
-                                ai && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(
+                                ai && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                                   AiToolbarControl,
                                   {
                                     ai,
@@ -11306,8 +11499,8 @@ function DocBlocksShell({
                                     onOpenPanel: setAiPanel
                                   }
                                 ) }),
-                                speech && /* @__PURE__ */ jsxs14(Suspense2, { fallback: null, children: [
-                                  /* @__PURE__ */ jsx16(
+                                speech && /* @__PURE__ */ jsxs16(Suspense2, { fallback: null, children: [
+                                  /* @__PURE__ */ jsx18(
                                     TextFromNarration,
                                     {
                                       speech,
@@ -11317,27 +11510,27 @@ function DocBlocksShell({
                                       onOpenSettings: openSettings
                                     }
                                   ),
-                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx16(
+                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx18(
                                     SpeechToolbarControl,
                                     {
                                       speech,
                                       onOpenSettings: openSettings,
                                       readOnly: selectedImage !== void 0 || selectedOutsideIn !== null && !selectedOutsideInEditingEnabled
                                     }
-                                  ) : /* @__PURE__ */ jsx16(SpeechMenuBridge, {})
+                                  ) : /* @__PURE__ */ jsx18(SpeechMenuBridge, {})
                                 ] }),
-                                canRestoreSplitView && /* @__PURE__ */ jsx16(
+                                canRestoreSplitView && /* @__PURE__ */ jsx18(
                                   "button",
                                   {
                                     className: "db-restore-split",
                                     onClick: () => updateSidebarPreference("pinned"),
                                     "aria-label": "Restore split view",
                                     title: "Restore split view",
-                                    children: /* @__PURE__ */ jsx16(SplitViewIcon, {})
+                                    children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                                   }
                                 ),
-                                git.repo && /* @__PURE__ */ jsx16(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx16(GitToolbarControl, { selectedFile }) }),
-                                /* @__PURE__ */ jsx16(
+                                git.repo && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(GitToolbarControl, { selectedFile }) }),
+                                /* @__PURE__ */ jsx18(
                                   ExportToolbarControls,
                                   {
                                     selectedFile,
@@ -11357,91 +11550,81 @@ function DocBlocksShell({
                               ] })
                             },
                             `${selectedFile}-${editorKey}`
-                          )
+                          ) })
                         }
                       )
                     }
-                  ),
-                  showWelcomeGateway && !singlePane && /* @__PURE__ */ jsxs14("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
-                    /* @__PURE__ */ jsxs14("span", { className: "db-welcome-gateway-text", children: [
-                      "You\u2019re watching this welcome doc in ",
-                      /* @__PURE__ */ jsx16("strong", { children: "Slideshow" }),
-                      " ",
-                      "view\u2014 it\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__ */ jsx16("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
-                    /* @__PURE__ */ jsx16(
-                      "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__ */ jsxs14("div", { className: "db-folder-view", children: [
-                  singlePane && /* @__PURE__ */ jsxs14("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx16("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx16(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs14("div", { className: "db-folder-view-header", children: [
-                    /* @__PURE__ */ jsx16("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx16(FolderGlyph, {}) }),
-                    /* @__PURE__ */ jsx16("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__ */ jsx16("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx16("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs14(
-                    "li",
+                  /* @__PURE__ */ jsx18(
+                    UpdateAvailableNotice,
                     {
-                      className: "db-folder-view-item",
-                      onClick: () => handleSelect(entry.path, entry.kind),
-                      children: [
-                        /* @__PURE__ */ jsx16("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx16(FolderGlyph, {}) : /* @__PURE__ */ jsx16(FileGlyph, {}) }),
-                        entry.name
-                      ]
-                    },
-                    entry.path
-                  )) })
-                ] }) : /* @__PURE__ */ jsxs14("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
-                  singlePane && /* @__PURE__ */ jsxs14("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx16("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx16(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs14("div", { className: "db-workspace-empty-content", children: [
-                    /* @__PURE__ */ jsx16("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx16(FileGlyph, {}) }),
-                    /* @__PURE__ */ jsx16("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
-                    /* @__PURE__ */ jsx16("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
-                    /* @__PURE__ */ jsxs14("div", { className: "db-workspace-empty-actions", children: [
-                      /* @__PURE__ */ jsx16("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
-                      /* @__PURE__ */ jsx16(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleNewFolder(),
-                          children: "New folder"
-                        }
-                      ),
-                      (hostSupports2("workspaceFolderPicker") || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx16(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleOpenFolder(),
-                          children: "Open a folder"
-                        }
-                      )
-                    ] }),
-                    /* @__PURE__ */ jsx16("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__ */ jsx16(
-                  UpdateAvailableNotice,
+                welcomeScreenShown && /* @__PURE__ */ jsx18(
+                  WelcomeScreen,
                   {
-                    available: updateAvailable,
-                    onApplyUpdate,
-                    blocked: documentSnapshot.conflict !== null || storageFull,
-                    statusBarVisible: updateStatusBarVisible
+                    onCreateDocument: handleNewFile,
+                    onTour: handleTourWelcome,
+                    onDismiss: handleTourWelcome,
+                    offerApps: hostEnvironment === null
                   }
                 )
               ]