@bendyline/docblocks-react 2.7.2 → 2.7.3

package/dist/index.js

@@ -1,3 +1,6 @@
+import {
+  ProgressivePlayer
+} from "./chunk-2IYBBFQX.js";
 import {
   BackupIcon,
   FolderIcon,
@@ -18,9 +21,6 @@ import {
 import {
   createSpeechInputProvider
 } from "./chunk-KBDZDFPU.js";
-import {
-  ProgressivePlayer
-} from "./chunk-2IYBBFQX.js";
 import {
   sharedDocumentFilename
 } from "./chunk-SPUPWCSI.js";
@@ -51,7 +51,7 @@ import {
 } from "./chunk-KWG6UP5O.js";
 import {
   runExport
-} from "./chunk-HRWEGPTY.js";
+} from "./chunk-6PA7QBZT.js";
 import {
   createImageSaveOutput
 } from "./chunk-UONFWKJ7.js";
@@ -87,7 +87,7 @@ import {
   saveProofingPreferences,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-BLUEZG7T.js";
+} from "./chunk-ZMCQO57Q.js";
 import {
   FindButton,
   focusFindInput,
@@ -99,9 +99,14 @@ import {
   isApplePlatform,
   matchShortcut,
   shortcutLabel
-} from "./chunk-K7XJDJUJ.js";
-import "./chunk-SSB43524.js";
-import "./chunk-NAH52736.js";
+} from "./chunk-ACQF63SB.js";
+import "./chunk-EOU2JWAQ.js";
+import {
+  buildIssueReportUrl,
+  displayBuildDate,
+  localDateStamp,
+  openExternalUrl
+} from "./chunk-YPIVCCTB.js";
 import "./chunk-K4I3NJFL.js";
 import {
   ExportDialog
@@ -2443,6 +2448,7 @@ function isInternalDrag(dataTransfer) {
 }
 function FileExplorer({
   provider,
+  loading = false,
   metadataRefreshKey,
   activeFilePath,
   sortMode,
@@ -3169,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,
@@ -3236,6 +3242,7 @@ function WorkspacePicker({
   onCloneRepository,
   onRemoveWorkspace,
   refreshKey,
+  loading = false,
   className
 }) {
   const [workspaces, setWorkspaces] = useState5([]);
@@ -3392,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",
@@ -4034,17 +4041,6 @@ function SpeechSettingsControls({ speech }) {
   ] });
 }
 
-// src/local-date.ts
-function localDateStamp(date) {
-  const pad = (value) => String(value).padStart(2, "0");
-  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
-}
-function displayBuildDate(value) {
-  if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return value;
-  const instant = new Date(value);
-  return Number.isNaN(instant.getTime()) ? value : localDateStamp(instant);
-}
-
 // src/AppMenu/AppMenu.tsx
 import { Fragment as Fragment5, jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 function formatBytes(bytes) {
@@ -4099,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);
@@ -4400,22 +4397,6 @@ function AppMenu({
         /* @__PURE__ */ jsx8("strong", { children: "DocBlocks" }),
         " is a local-first Markdown document editor. Your files stay under your control."
       ] }),
-      /* @__PURE__ */ jsxs7("aside", { className: "db-about-beta", children: [
-        /* @__PURE__ */ jsx8("strong", { children: "Beta Software." }),
-        " We're still working through initial hiccups and issues. Please bear with us, make sure you keep backups, and",
-        " ",
-        /* @__PURE__ */ jsx8(
-          "a",
-          {
-            href: "https://github.com/bendyline/docblocks/issues/new",
-            target: "_blank",
-            rel: "noopener noreferrer",
-            children: "open issues"
-          }
-        ),
-        " ",
-        "where you find them. Thanks!"
-      ] }),
       appVersion && /* @__PURE__ */ jsxs7("p", { className: "db-about-version", children: [
         /* @__PURE__ */ jsx8("span", { children: "Version" }),
         /* @__PURE__ */ jsx8("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
@@ -4434,6 +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(
@@ -5008,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-2FEIHNMW.js").then((module) => ({
+  () => import("./ExportToolbarControls-A2YBKUUD.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -6050,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: ${localDateStamp(environment.reportedAt)}`,
-    `- DocBlocks: ${normalizeEnvironmentValue(environment.version, "unknown", VERSION_VALUE_LIMIT)}`,
-    `- User agent: ${normalizeEnvironmentValue(
-      environment.userAgent,
-      "unavailable",
-      USER_AGENT_VALUE_LIMIT
-    )}`
-  ].join("\n");
-  const url = new URL(NEW_ISSUE_URL);
-  url.searchParams.set("body", body);
-  return url.href;
-}
-
 // src/DocBlocksShell/last-state.ts
 import { tryParseWorkspacePath as tryParseWorkspacePath2 } from "@bendyline/docblocks/filesystem";
 var LAST_STATE_KEY = "docblocks:lastState";
@@ -6733,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";
 
@@ -7107,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;
 }
@@ -7117,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.",
-  "",
-  '## 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."]}',
-  "",
-  "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.",
+  '# Welcome to DocBlocks {[title subtitle="Write once. Share it as a document, a deck, or a video."]}',
   "",
-  "## Get started on desktop {[list]}",
+  "This is an ordinary document, so go ahead and change it. Click anywhere and type; DocBlocks saves as you go.",
   "",
-  "- 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.",
+  "## Write the way you already do {[list]}",
   "",
-  "## Use the web app on this device {[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.",
   "",
-  "- Open DocBlocks in your browser and start in a browser workspace. In supported browsers, you can also open a local folder.",
-  "- Choose **Install DocBlocks\u2026** in the app menu when offered. The installed web app keeps using the same browser storage.",
-  "- Once the app has finished downloading for offline use, you can keep editing without a connection.",
-  "- Use **Back up all workspaces** in the app menu to keep a backup before clearing browser data or moving to a new device.",
-  "",
-  "## Work inside VS Code {[content]}",
-  "",
-  "Install the DocBlocks extension, then open a `.md` file in your project. If it opens as plain text, right-click it and choose **Open in DocBlocks**. VS Code supplies the file explorer, tabs, saving, and source control; DocBlocks supplies the visual editor, Markdown source, previews, and export. Follow the extension guide below to get started.",
-  "",
-  "## On a phone or tablet {[content]}",
-  "",
-  "Use the web app on your phone or tablet today. Native apps for iPhone, iPad, and Android are in preview, with store distribution pending. Preview builds offer an **On this device** workspace, picked folders, and system sharing. Keep an exported copy of important work: uninstalling a native app removes its private device workspace.",
-  "",
-  '## Automate with the CLI and MCP {[twoColumn header="For repeatable document work" left="CLI|Install @bendyline/docblocks-cli with npm, then run docblocks --help. Build, preview, and convert files from your terminal." right="MCP|Connect the local server to an agent. Convert and preview documents, then deliberately save the resulting artifacts."]}',
-  "",
-  "With a supported version of `Node.js` installed, run `npm install -g @bendyline/docblocks-cli`, then `docblocks --help`. The CLI builds, previews, and converts files from your terminal. Its local MCP server gives agents document tools with explicitly allowed file access. Follow the CLI and MCP guide below for requirements and configuration.",
-  "",
-  "## One source, four ways to publish {[diagram]}",
+  "## One document, many ways to share it {[diagram]}",
   "",
   "```diagram",
-  "+------------+",
-  "|  Markdown  |",
-  "+-----+------+",
-  "      |",
-  "  +---+------+------------+-----------+",
-  "  |          |            |           |",
-  "  v          v            v           v",
-  "+-------+ +---------+ +------------+ +-------+",
-  "| Pages | |Documents| | Slideshows | | Video |",
-  "+-------+ +---------+ +------------+ +-------+",
+  "              +-----------------+",
+  "              |  Your document  |",
+  "              +--------+--------+",
+  "                       |",
+  "    +-----------+------+-----+------------+",
+  "    |           |            |            |",
+  "    v           v            v            v",
+  "+-------+  +--------+  +----------+  +---------+",
+  "|  PDF  |  |  Word  |  |  Slides  |  |  Video  |",
+  "+-------+  +--------+  +----------+  +---------+",
   "```",
   "",
-  "## Write visually, then look under the hood whenever you like {[content]}",
-  "",
-  "Use the rich editor for headings, lists, tables, links, images, media, and everyday formatting. Switch to raw Markdown for exact control. Add themes, transform styles, and squiggly-square section annotations when a passage deserves its own visual treatment. The readable `.md` source stays at the center of the workflow.",
+  "## Present it or send it {[content]}",
   "",
-  "## Preview the finished idea before you export it {[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.",
   "",
-  "- **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.",
+  "## Your documents stay yours {[factCard]}",
   "",
-  "## Try the optional desktop tools {[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.",
   "",
-  "- **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.",
+  "## Make your own {[list]}",
   "",
-  "## The quiet conveniences are there, too {[list]}",
+  "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.",
   "",
-  "- **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.",
+  "## Go further {[list]}",
   "",
-  "## Export without rebuilding the document {[list]}",
-  "",
-  "- Create **Word documents and PDFs** for review, printing, and sharing with a fixed page layout.",
-  "- Create **PowerPoint decks** from the same annotated sections you preview as a slideshow.",
-  "- Publish **HTML pages, packaged HTML, and EPUB e-books**.",
-  "- Keep portable **Markdown or DBK bundles** with their media assets.",
-  "- Use the linked CLI registry for **spreadsheets, MP4 video, animated GIF, batch conversion, and more**.",
-  "",
-  "## Local-first is concrete, not decorative {[quote]}",
-  "",
-  "> Your browser workspace stays on this device. Native folders are opened only when you choose them. Your Markdown remains useful in DocBlocks, Git, a terminal, another editor, or an AI-assisted workflow.",
-  "",
-  "## Agents get document tools, not a blank check {[factCard]}",
-  "",
-  "The local MCP server 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 jsx17, jsxs as jsxs15 } from "react/jsx-runtime";
+import { Fragment as Fragment11, jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
 var editorShellModulePromise = null;
 function loadEditorShell() {
   editorShellModulePromise ?? (editorShellModulePromise = (async () => {
@@ -7254,7 +7249,7 @@ var QuickOpenDialog = lazy2(
   () => import("./QuickOpenDialog-2KK4SEBU.js").then((m) => ({ default: m.QuickOpenDialog }))
 );
 var KeyboardShortcutsDialog = lazy2(
-  () => import("./KeyboardShortcutsDialog-NOD4P25G.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
+  () => import("./KeyboardShortcutsDialog-G5OBDTNR.js").then((m) => ({ default: m.KeyboardShortcutsDialog }))
 );
 var WorkspaceSearchPanel = lazy2(
   () => import("./WorkspaceSearchPanel-J6BKEZQJ.js").then((m) => ({
@@ -7268,22 +7263,22 @@ 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-ITNP5SDO.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
   }))
 );
@@ -7565,7 +7560,7 @@ async function createHostProviderFromWorkspace(ws) {
 var DESKTOP_TOOLBAR_WRAP_WIDTH = 900;
 var WEB_TOOLBAR_WRAP_WIDTH = 700;
 function FolderGlyph() {
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7574,12 +7569,12 @@ function FolderGlyph() {
       strokeWidth: "1.5",
       strokeLinejoin: "round",
       "aria-hidden": "true",
-      children: /* @__PURE__ */ jsx17("path", { d: "M3 7a1 1 0 0 1 1-1h5l2 2h9a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7z" })
+      children: /* @__PURE__ */ jsx18("path", { d: "M3 7a1 1 0 0 1 1-1h5l2 2h9a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7z" })
     }
   );
 }
 function FileGlyph() {
-  return /* @__PURE__ */ jsxs15(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 24 24",
@@ -7589,14 +7584,14 @@ function FileGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx17("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
-        /* @__PURE__ */ jsx17("path", { d: "M14 3v5h5" })
+        /* @__PURE__ */ jsx18("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }),
+        /* @__PURE__ */ jsx18("path", { d: "M14 3v5h5" })
       ]
     }
   );
 }
 function CollapseSidebarGlyph() {
-  return /* @__PURE__ */ jsxs15(
+  return /* @__PURE__ */ jsxs16(
     "svg",
     {
       viewBox: "0 0 64 64",
@@ -7607,9 +7602,9 @@ function CollapseSidebarGlyph() {
       strokeLinejoin: "round",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx17("rect", { x: "7", y: "10", width: "50", height: "44", rx: "6" }),
-        /* @__PURE__ */ jsx17("path", { d: "M24 10v44" }),
-        /* @__PURE__ */ jsx17("path", { d: "m17 25-7 7 7 7" })
+        /* @__PURE__ */ jsx18("rect", { x: "7", y: "10", width: "50", height: "44", rx: "6" }),
+        /* @__PURE__ */ jsx18("path", { d: "M24 10v44" }),
+        /* @__PURE__ */ jsx18("path", { d: "m17 25-7 7 7 7" })
       ]
     }
   );
@@ -7841,6 +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(() => {
@@ -8194,7 +8190,6 @@ function DocBlocksShell({
     } : null,
     [documentSnapshot.frozen, documentSnapshot.generation, documentSnapshot.targetKey]
   );
-  const [editorPresentationEpoch, setEditorPresentationEpoch] = useState23(0);
   const [editorGeneration, setEditorGeneration] = useState23(documentSnapshot.generation);
   useEffect29(() => {
     const sync = () => setEditorGeneration(documentSession.getSnapshot().generation);
@@ -8208,7 +8203,7 @@ function DocBlocksShell({
   useEffect29(() => {
     setOutsideInPdfWorker(pdfWorkerSrc2);
   }, [pdfWorkerSrc2]);
-  const editorKey = `${editorGeneration}:${editorPresentationEpoch}`;
+  const editorKey = String(editorGeneration);
   const editorPlaceholder = useMemo6(() => {
     void editorKey;
     return pickEmptyDocumentPrompt();
@@ -8228,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(), []);
@@ -8536,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) {
@@ -8543,7 +8548,7 @@ function DocBlocksShell({
         }
       }
     },
-    [openFromIds]
+    [openFromIds, closeWelcomeGateway]
   );
   const openSharedDocument = useCallback18(
     async (payload, navigationRequestId) => {
@@ -8585,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;
@@ -8620,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]
@@ -8635,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;
@@ -9882,14 +9882,20 @@ function DocBlocksShell({
       "new-folder": () => void handleNewFolder(),
       shortcuts: openKeyboardShortcuts,
       "toggle-sidebar": () => {
+        if (canRestoreSplitView) {
+          updateSidebarPreference("pinned");
+          return;
+        }
         if (singlePane) {
           setMobileShowEditor((showingEditor) => !showingEditor);
           return;
         }
-        updateSidebarPreference(sidebarPreference === "collapsed" ? "pinned" : "collapsed");
+        updateSidebarPreference("collapsed");
+        setMobileShowEditor(true);
       },
       "focus-files": () => {
         if (singlePane) setMobileShowEditor(false);
+        setSidebarView("files");
         window.requestAnimationFrame(() => {
           const tree = document.querySelector(".db-tree");
           const target = tree?.querySelector('.db-tree-row[tabindex="0"]') ?? tree?.querySelector(".db-tree-row");
@@ -9919,7 +9925,7 @@ function DocBlocksShell({
       openKeyboardShortcuts,
       singlePane,
       mobileShowEditor,
-      sidebarPreference,
+      canRestoreSplitView,
       updateSidebarPreference
     ]
   );
@@ -10256,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 () => {
@@ -10796,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;
           }
         );
@@ -10807,7 +10802,7 @@ function DocBlocksShell({
         );
       });
     });
-  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast]);
+  }, [openFromIds, openTransient, workspaceAuthorityBarrier, showToast, closeWelcomeGateway]);
   const openTransientFromHandle = useCallback18(
     async (handle) => {
       const name = handle.name;
@@ -11110,7 +11105,7 @@ function DocBlocksShell({
       transitionAwayFromDocument
     ]
   );
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18(
     "div",
     {
       ref: shellRef,
@@ -11119,10 +11114,10 @@ function DocBlocksShell({
       "data-accent": accentColor,
       "data-interface-font": interfaceFont === "fixed" ? "fixed" : void 0,
       "data-document-status": documentSnapshot.status,
-      children: /* @__PURE__ */ jsxs15(GitContext.Provider, { value: git, children: [
+      children: /* @__PURE__ */ jsxs16(GitContext.Provider, { value: git, children: [
         promptDialog,
         confirmDialog,
-        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+        quickOpenOpen && activeWorkspaceId && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
           QuickOpenDialog,
           {
             index: workspaceIndex.index,
@@ -11136,8 +11131,8 @@ function DocBlocksShell({
             onClose: () => setQuickOpenOpen(false)
           }
         ) }),
-        shortcutsOpen && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(KeyboardShortcutsDialog, { onClose: () => setShortcutsOpen(false) }) }),
-        newDocumentDialogOpen && /* @__PURE__ */ jsx17(
+        shortcutsOpen && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(KeyboardShortcutsDialog, { onClose: () => setShortcutsOpen(false) }) }),
+        newDocumentDialogOpen && /* @__PURE__ */ jsx18(
           NewDocumentDialog,
           {
             initialFormat: defaultNewFileFormat,
@@ -11147,8 +11142,8 @@ function DocBlocksShell({
             }
           }
         ),
-        workspaceStartupError && /* @__PURE__ */ jsx17("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
-        saveToast && /* @__PURE__ */ jsx17(
+        workspaceStartupError && /* @__PURE__ */ jsx18("div", { className: "db-save-toast db-save-toast--error", role: "alert", "aria-live": "assertive", children: workspaceStartupError }),
+        saveToast && /* @__PURE__ */ jsx18(
           "div",
           {
             className: "db-save-toast db-save-toast--" + saveToast.kind,
@@ -11157,12 +11152,12 @@ function DocBlocksShell({
             children: saveToast.message
           }
         ),
-        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx17("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
-        documentSnapshot.conflict && /* @__PURE__ */ jsxs15("div", { className: "db-document-conflict", role: "alert", children: [
-          /* @__PURE__ */ jsx17("span", { children: documentSnapshot.conflict.recoveredDraft ? "A recovery draft from a previous session differs from the saved file. The saved file may be newer. Choose which version to use." : "This document changed outside DocBlocks. Your unsaved version is still intact." }),
-          /* @__PURE__ */ jsx17("div", { className: "db-document-conflict-actions", children: /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => setShowConflictComparison(true), children: "Compare versions" }) })
+        offlineReadyToast && !saveToast && /* @__PURE__ */ jsx18("div", { className: "db-save-toast db-save-toast--success", role: "status", "aria-live": "polite", children: "DocBlocks is ready to work offline." }),
+        documentSnapshot.conflict && /* @__PURE__ */ jsxs16("div", { className: "db-document-conflict", role: "alert", children: [
+          /* @__PURE__ */ jsx18("span", { children: documentSnapshot.conflict.recoveredDraft ? "A recovery draft from a previous session differs from the saved file. The saved file may be newer. Choose which version to use." : "This document changed outside DocBlocks. Your unsaved version is still intact." }),
+          /* @__PURE__ */ jsx18("div", { className: "db-document-conflict-actions", children: /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => setShowConflictComparison(true), children: "Compare versions" }) })
         ] }),
-        documentSnapshot.conflict && showConflictComparison && /* @__PURE__ */ jsx17(Suspense2, { fallback: /* @__PURE__ */ jsx17("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx17(
+        documentSnapshot.conflict && showConflictComparison && /* @__PURE__ */ jsx18(Suspense2, { fallback: /* @__PURE__ */ jsx18("div", { role: "status", children: "Loading version comparison\u2026" }), children: /* @__PURE__ */ jsx18(
           DocumentConflictDialog,
           {
             conflict: documentSnapshot.conflict,
@@ -11172,14 +11167,14 @@ function DocBlocksShell({
             onClose: () => setShowConflictComparison(false)
           }
         ) }),
-        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs15("div", { className: "db-storage-full-banner", role: "alert", children: [
-          /* @__PURE__ */ jsx17("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
-          /* @__PURE__ */ jsxs15("div", { className: "db-storage-full-banner-actions", children: [
-            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Back up all workspaces" }),
-            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
+        storageFull && !documentSnapshot.conflict && /* @__PURE__ */ jsxs16("div", { className: "db-storage-full-banner", role: "alert", children: [
+          /* @__PURE__ */ jsx18("span", { children: "Browser storage is full -- changes can\u2019t be saved. Free up space or back up your work now." }),
+          /* @__PURE__ */ jsxs16("div", { className: "db-storage-full-banner-actions", children: [
+            /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleDownloadAllWorkspaces(), children: "Back up all workspaces" }),
+            /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => setStorageFull(false), children: "Dismiss" })
           ] })
         ] }),
-        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx17(
+        workspaceSettingsOpen && activeWorkspaceDescriptor && /* @__PURE__ */ jsx18(
           WorkspaceSettingsDialog,
           {
             workspace: activeWorkspaceDescriptor,
@@ -11192,8 +11187,8 @@ function DocBlocksShell({
             onClose: () => setWorkspaceSettingsOpen(false)
           }
         ),
-        /* @__PURE__ */ jsxs15("div", { className: "db-shell-panes", ref: panesRef, children: [
-          /* @__PURE__ */ jsxs15(
+        /* @__PURE__ */ jsxs16("div", { className: "db-shell-panes", ref: panesRef, children: [
+          /* @__PURE__ */ jsxs16(
             "aside",
             {
               ref: sidebarRef,
@@ -11201,8 +11196,8 @@ function DocBlocksShell({
               "aria-label": "Workspace and files",
               style: singlePane ? void 0 : { width: `${sidebarWidth}px` },
               children: [
-                /* @__PURE__ */ jsxs15("div", { className: "db-shell-sidebar-header", children: [
-                  /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsxs16("div", { className: "db-shell-sidebar-header", children: [
+                  /* @__PURE__ */ jsx18(
                     AppMenu,
                     {
                       logoUrl,
@@ -11236,10 +11231,11 @@ function DocBlocksShell({
                       settingsRequest
                     }
                   ),
-                  /* @__PURE__ */ jsx17(
+                  /* @__PURE__ */ jsx18(
                     WorkspacePicker,
                     {
                       activeWorkspaceId,
+                      loading: workspaceStarting,
                       refreshKey: descriptorRefreshKey,
                       onSelect: handleWorkspaceSelect,
                       onOpenFolder: handleOpenFolder,
@@ -11247,7 +11243,7 @@ function DocBlocksShell({
                       onRemoveWorkspace: (workspace) => void handleRemoveWorkspace(workspace.id)
                     }
                   ),
-                  /* @__PURE__ */ jsx17(
+                  /* @__PURE__ */ jsx18(
                     WorkspaceSettingsButton,
                     {
                       onSettings: handleOpenWorkspaceSettings,
@@ -11258,28 +11254,29 @@ function DocBlocksShell({
                       }
                     }
                   ),
-                  canRestoreSplitView && /* @__PURE__ */ jsx17(
+                  canRestoreSplitView && /* @__PURE__ */ jsx18(
                     "button",
                     {
                       className: "db-restore-split",
                       onClick: () => updateSidebarPreference("pinned"),
                       "aria-label": "Restore split view",
                       title: "Restore split view",
-                      children: /* @__PURE__ */ jsx17(SplitViewIcon, {})
+                      children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                     }
                   ),
-                  /* @__PURE__ */ jsx17("span", { className: "db-window-drag-grip", "aria-hidden": true })
+                  /* @__PURE__ */ jsx18("span", { className: "db-window-drag-grip", "aria-hidden": true })
                 ] }),
-                git.available && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                git.available && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   GitUI,
                   {
                     onOpenFile: (path) => void handleSelect(path, "file"),
                     onWorkspaceCloned: handleWorkspaceCloned
                   }
                 ) }),
-                /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsx18(
                   FileExplorer,
                   {
+                    loading: workspaceStarting,
                     className: sidebarView === "search" ? "db-sidebar-view--hidden" : void 0,
                     onShowSearch: canBrowseWorkspace ? openWorkspaceSearch : void 0,
                     searchShortcutLabel: searchShortcut,
@@ -11311,7 +11308,7 @@ function DocBlocksShell({
                   },
                   explorerKey
                 ),
-                searchMounted && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                searchMounted && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                   WorkspaceSearchPanel,
                   {
                     index: workspaceIndex.index,
@@ -11322,41 +11319,38 @@ function DocBlocksShell({
                     onShowFiles: () => setSidebarView("files")
                   }
                 ) }),
-                singlePane && showWelcomeGateway && /* @__PURE__ */ jsxs15("section", { className: "db-mobile-first-run", "aria-labelledby": "db-mobile-first-run-title", children: [
-                  /* @__PURE__ */ jsx17("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
-                  /* @__PURE__ */ jsx17("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
-                  /* @__PURE__ */ jsx17("p", { children: "Write visually, keep plain Markdown underneath, and export the same document in useful formats. Keep your documents in the workspace you choose." }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-mobile-first-run-actions", children: [
-                    /* @__PURE__ */ jsx17(
+                singlePane && showWelcomeGateway && /* @__PURE__ */ jsxs16("section", { className: "db-mobile-first-run", "aria-labelledby": "db-mobile-first-run-title", children: [
+                  /* @__PURE__ */ jsx18("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
+                  /* @__PURE__ */ jsx18("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
+                  /* @__PURE__ */ jsxs16("p", { children: [
+                    WELCOME_SUMMARY,
+                    " ",
+                    WELCOME_PRIVACY_NOTE
+                  ] }),
+                  /* @__PURE__ */ jsxs16("div", { className: "db-mobile-first-run-actions", children: [
+                    /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleNewFile(), children: "Create a document" }),
+                    /* @__PURE__ */ jsx18(
                       "button",
                       {
                         type: "button",
+                        className: "db-mobile-first-run-secondary",
                         onClick: () => {
                           closeWelcomeGateway();
                           setMobileShowEditor(true);
                         },
                         children: "Tour the welcome document"
                       }
-                    ),
-                    /* @__PURE__ */ jsx17(
-                      "button",
-                      {
-                        type: "button",
-                        className: "db-mobile-first-run-secondary",
-                        onClick: () => void handleNewFile(),
-                        children: "Create a document"
-                      }
                     )
                   ] })
                 ] }),
-                git.available && git.pendingGrant && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(GitGrantNotice, {}) }),
-                /* @__PURE__ */ jsxs15("div", { className: "db-shell-sidebar-footer", children: [
-                  /* @__PURE__ */ jsx17("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx17("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx17("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
-                  showBrowserStorageWarning && /* @__PURE__ */ jsx17(Fragment11, { children: /* @__PURE__ */ jsxs15(
+                git.available && git.pendingGrant && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(GitGrantNotice, {}) }),
+                /* @__PURE__ */ jsxs16("div", { className: "db-shell-sidebar-footer", children: [
+                  /* @__PURE__ */ jsx18("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx18("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
+                  /* @__PURE__ */ jsx18("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
+                  showBrowserStorageWarning && /* @__PURE__ */ jsx18(Fragment11, { children: /* @__PURE__ */ jsxs16(
                     "button",
                     {
                       type: "button",
@@ -11365,20 +11359,20 @@ function DocBlocksShell({
                       "aria-label": "Back up all workspaces",
                       title: "Browsers can clear site data. Download a backup of every workspace.",
                       children: [
-                        /* @__PURE__ */ jsx17(BackupIcon, {}),
+                        /* @__PURE__ */ jsx18(BackupIcon, {}),
                         "Back up"
                       ]
                     }
                   ) })
                 ] }),
-                /* @__PURE__ */ jsxs15("div", { className: "db-sidebar-collapse-preview", "aria-hidden": "true", children: [
-                  /* @__PURE__ */ jsx17("span", { className: "db-sidebar-collapse-preview-icon", children: /* @__PURE__ */ jsx17(CollapseSidebarGlyph, {}) }),
-                  /* @__PURE__ */ jsx17("span", { className: "db-sidebar-collapse-preview-label", children: "Release to hide files" })
+                /* @__PURE__ */ jsxs16("div", { className: "db-sidebar-collapse-preview", "aria-hidden": "true", children: [
+                  /* @__PURE__ */ jsx18("span", { className: "db-sidebar-collapse-preview-icon", children: /* @__PURE__ */ jsx18(CollapseSidebarGlyph, {}) }),
+                  /* @__PURE__ */ jsx18("span", { className: "db-sidebar-collapse-preview-label", children: "Release to hide files" })
                 ] })
               ]
             }
           ),
-          !singlePane && /* @__PURE__ */ jsx17(
+          !singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-sidebar-resizer",
@@ -11388,7 +11382,7 @@ function DocBlocksShell({
               onPointerDown: handleResizerPointerDown
             }
           ),
-          singlePane && /* @__PURE__ */ jsx17(
+          singlePane && /* @__PURE__ */ jsx18(
             "div",
             {
               className: "db-shell-scrim",
@@ -11396,7 +11390,7 @@ function DocBlocksShell({
               onPointerDown: () => setMobileShowEditor(true)
             }
           ),
-          /* @__PURE__ */ jsxs15(
+          /* @__PURE__ */ jsxs16(
             "main",
             {
               ref: editorAreaRef,
@@ -11407,8 +11401,8 @@ function DocBlocksShell({
                 editorDropActive ? "db-shell-editor-area--drop-active" : ""
               ].filter(Boolean).join(" "),
               children: [
-                selectedFile && mediaProvider ? /* @__PURE__ */ jsxs15(Fragment11, { children: [
-                  selectedManagedOutput === "catalog-html" ? /* @__PURE__ */ jsx17(
+                /* @__PURE__ */ jsxs16("div", { ref: welcomeCoveredRef, className: "db-shell-editor-content", children: [
+                  selectedFile && mediaProvider ? /* @__PURE__ */ jsx18(Fragment11, { children: selectedManagedOutput === "catalog-html" ? /* @__PURE__ */ jsx18(
                     GeneratedCatalogPage,
                     {
                       html: editorContent,
@@ -11416,17 +11410,17 @@ function DocBlocksShell({
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0
                     }
-                  ) : /* @__PURE__ */ jsx17(
+                  ) : /* @__PURE__ */ jsx18(
                     GeneratedFileFrame,
                     {
                       kind: selectedManagedOutput,
                       onOpenSettings: activeWorkspaceDescriptor ? handleOpenWorkspaceSettings : void 0,
                       onBack: singlePane ? openDrawer : void 0,
-                      children: /* @__PURE__ */ jsx17(
+                      children: /* @__PURE__ */ jsx18(
                         Suspense2,
                         {
-                          fallback: /* @__PURE__ */ jsx17("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
-                          children: editorGenerationSettled && mediaProviderCurrent && /* @__PURE__ */ jsx17(EditorErrorBoundary, { resetKey: `${selectedFile}-${editorKey}`, children: /* @__PURE__ */ jsx17(
+                          fallback: /* @__PURE__ */ jsx18("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
+                          children: editorGenerationSettled && mediaProviderCurrent && /* @__PURE__ */ jsx18(EditorErrorBoundary, { resetKey: `${selectedFile}-${editorKey}`, children: /* @__PURE__ */ jsx18(
                             EditorShell,
                             {
                               initialMarkdown: editorContent,
@@ -11476,19 +11470,19 @@ function DocBlocksShell({
                               versioningAutoSaveIdleMs,
                               onSaveVersion,
                               statusBarSlotRight,
-                              sidePanelSlot: ai && aiPanel && selectedImage === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: aiPanel === "review" ? /* @__PURE__ */ jsx17(AiReviewPanel, { ai, onClose: () => setAiPanel(null) }) : /* @__PURE__ */ jsx17(AiIllustratePanel, { ai, onClose: () => setAiPanel(null) }) }) : void 0,
-                              toolbarSlotLeft: singlePane ? /* @__PURE__ */ jsx17(
+                              sidePanelSlot: ai && aiPanel && selectedImage === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: aiPanel === "review" ? /* @__PURE__ */ jsx18(AiReviewPanel, { ai, onClose: () => setAiPanel(null) }) : /* @__PURE__ */ jsx18(AiIllustratePanel, { ai, onClose: () => setAiPanel(null) }) }) : void 0,
+                              toolbarSlotLeft: singlePane ? /* @__PURE__ */ jsx18(
                                 "button",
                                 {
                                   className: "db-mobile-back",
                                   onClick: () => setMobileShowEditor(false),
                                   "aria-label": "Show file list",
-                                  children: /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) })
+                                  children: /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) })
                                 }
                               ) : void 0,
-                              summarizationDesigner: selectedImage === void 0 && selectedManagedOutput === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? (onClose) => /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(PresentationMaker, { ai: ai ?? void 0, onClose }) }) : void 0,
-                              toolbarSlotRight: /* @__PURE__ */ jsxs15(Fragment11, { children: [
-                                canFind && /* @__PURE__ */ jsx17(
+                              summarizationDesigner: selectedImage === void 0 && selectedManagedOutput === void 0 && (selectedOutsideIn === null || selectedOutsideInEditingEnabled) ? (onClose) => /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(PresentationMaker, { ai: ai ?? void 0, onClose }) }) : void 0,
+                              toolbarSlotRight: /* @__PURE__ */ jsxs16(Fragment11, { children: [
+                                canFind && /* @__PURE__ */ jsx18(
                                   FindButton,
                                   {
                                     active: findMode,
@@ -11496,7 +11490,7 @@ function DocBlocksShell({
                                     shortcutLabel: findShortcut
                                   }
                                 ),
-                                ai && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(
+                                ai && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(
                                   AiToolbarControl,
                                   {
                                     ai,
@@ -11505,8 +11499,8 @@ function DocBlocksShell({
                                     onOpenPanel: setAiPanel
                                   }
                                 ) }),
-                                speech && /* @__PURE__ */ jsxs15(Suspense2, { fallback: null, children: [
-                                  /* @__PURE__ */ jsx17(
+                                speech && /* @__PURE__ */ jsxs16(Suspense2, { fallback: null, children: [
+                                  /* @__PURE__ */ jsx18(
                                     TextFromNarration,
                                     {
                                       speech,
@@ -11516,27 +11510,27 @@ function DocBlocksShell({
                                       onOpenSettings: openSettings
                                     }
                                   ),
-                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx17(
+                                  hostSupports2("speechOutput") ? /* @__PURE__ */ jsx18(
                                     SpeechToolbarControl,
                                     {
                                       speech,
                                       onOpenSettings: openSettings,
                                       readOnly: selectedImage !== void 0 || selectedOutsideIn !== null && !selectedOutsideInEditingEnabled
                                     }
-                                  ) : /* @__PURE__ */ jsx17(SpeechMenuBridge, {})
+                                  ) : /* @__PURE__ */ jsx18(SpeechMenuBridge, {})
                                 ] }),
-                                canRestoreSplitView && /* @__PURE__ */ jsx17(
+                                canRestoreSplitView && /* @__PURE__ */ jsx18(
                                   "button",
                                   {
                                     className: "db-restore-split",
                                     onClick: () => updateSidebarPreference("pinned"),
                                     "aria-label": "Restore split view",
                                     title: "Restore split view",
-                                    children: /* @__PURE__ */ jsx17(SplitViewIcon, {})
+                                    children: /* @__PURE__ */ jsx18(SplitViewIcon, {})
                                   }
                                 ),
-                                git.repo && /* @__PURE__ */ jsx17(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx17(GitToolbarControl, { selectedFile }) }),
-                                /* @__PURE__ */ jsx17(
+                                git.repo && /* @__PURE__ */ jsx18(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx18(GitToolbarControl, { selectedFile }) }),
+                                /* @__PURE__ */ jsx18(
                                   ExportToolbarControls,
                                   {
                                     selectedFile,
@@ -11560,87 +11554,77 @@ function DocBlocksShell({
                         }
                       )
                     }
-                  ),
-                  showWelcomeGateway && !singlePane && /* @__PURE__ */ jsxs15("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
-                    /* @__PURE__ */ jsxs15("span", { className: "db-welcome-gateway-text", children: [
-                      "You\u2019re watching this welcome doc in ",
-                      /* @__PURE__ */ jsx17("strong", { children: "Slideshow" }),
-                      " ",
-                      "view\u2014it\u2019s a regular Markdown file, and so is everything you\u2019ll write."
+                  ) }) : selectedFolder ? /* @__PURE__ */ jsxs16("div", { className: "db-folder-view", children: [
+                    singlePane && /* @__PURE__ */ jsxs16("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      "Back to files"
                     ] }),
-                    /* @__PURE__ */ jsx17("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
-                    /* @__PURE__ */ jsx17(
-                      "button",
+                    /* @__PURE__ */ jsxs16("div", { className: "db-folder-view-header", children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      /* @__PURE__ */ jsx18("span", { className: "db-folder-view-path", children: selectedFolder })
+                    ] }),
+                    visibleFolderEntries.length === 0 ? /* @__PURE__ */ jsx18("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx18("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs16(
+                      "li",
                       {
-                        className: "db-welcome-gateway-dismiss",
-                        onClick: closeWelcomeGateway,
-                        "aria-label": "Dismiss welcome tip",
-                        title: "Dismiss",
-                        children: "\xD7"
-                      }
-                    )
-                  ] })
-                ] }) : selectedFolder ? /* @__PURE__ */ jsxs15("div", { className: "db-folder-view", children: [
-                  singlePane && /* @__PURE__ */ jsxs15("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-folder-view-header", children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-folder-view-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    /* @__PURE__ */ jsx17("span", { className: "db-folder-view-path", children: selectedFolder })
+                        className: "db-folder-view-item",
+                        onClick: () => handleSelect(entry.path, entry.kind),
+                        children: [
+                          /* @__PURE__ */ jsx18("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx18(FolderGlyph, {}) : /* @__PURE__ */ jsx18(FileGlyph, {}) }),
+                          entry.name
+                        ]
+                      },
+                      entry.path
+                    )) })
+                  ] }) : /* @__PURE__ */ jsxs16("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
+                    singlePane && /* @__PURE__ */ jsxs16("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx18(FolderGlyph, {}) }),
+                      "Back to files"
+                    ] }),
+                    /* @__PURE__ */ jsxs16("div", { className: "db-workspace-empty-content", children: [
+                      /* @__PURE__ */ jsx18("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(FileGlyph, {}) }),
+                      /* @__PURE__ */ jsx18("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
+                      /* @__PURE__ */ jsx18("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
+                      /* @__PURE__ */ jsxs16("div", { className: "db-workspace-empty-actions", children: [
+                        /* @__PURE__ */ jsx18("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
+                        /* @__PURE__ */ jsx18(
+                          "button",
+                          {
+                            type: "button",
+                            className: "db-workspace-empty-secondary",
+                            onClick: () => void handleNewFolder(),
+                            children: "New folder"
+                          }
+                        ),
+                        (hostSupports2("workspaceFolderPicker") || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx18(
+                          "button",
+                          {
+                            type: "button",
+                            className: "db-workspace-empty-secondary",
+                            onClick: () => void handleOpenFolder(),
+                            children: "Open a folder"
+                          }
+                        )
+                      ] }),
+                      /* @__PURE__ */ jsx18("p", { className: "db-workspace-empty-hint", children: "Use the sidebar backup action to keep a portable copy of this workspace." })
+                    ] })
                   ] }),
-                  visibleFolderEntries.length === 0 ? /* @__PURE__ */ jsx17("p", { className: "db-folder-view-empty", children: "This folder is empty." }) : /* @__PURE__ */ jsx17("ul", { className: "db-folder-view-list", children: visibleFolderEntries.map((entry) => /* @__PURE__ */ jsxs15(
-                    "li",
+                  /* @__PURE__ */ jsx18(
+                    UpdateAvailableNotice,
                     {
-                      className: "db-folder-view-item",
-                      onClick: () => handleSelect(entry.path, entry.kind),
-                      children: [
-                        /* @__PURE__ */ jsx17("span", { className: "db-folder-view-item-icon", children: entry.kind === "directory" ? /* @__PURE__ */ jsx17(FolderGlyph, {}) : /* @__PURE__ */ jsx17(FileGlyph, {}) }),
-                        entry.name
-                      ]
-                    },
-                    entry.path
-                  )) })
-                ] }) : /* @__PURE__ */ jsxs15("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
-                  singlePane && /* @__PURE__ */ jsxs15("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx17(FolderGlyph, {}) }),
-                    "Back to files"
-                  ] }),
-                  /* @__PURE__ */ jsxs15("div", { className: "db-workspace-empty-content", children: [
-                    /* @__PURE__ */ jsx17("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(FileGlyph, {}) }),
-                    /* @__PURE__ */ jsx17("h1", { children: activeWorkspaceDescriptor?.name ?? "Workspace" }),
-                    /* @__PURE__ */ jsx17("p", { children: "Choose a Markdown document from the sidebar, or create a new one." }),
-                    /* @__PURE__ */ jsxs15("div", { className: "db-workspace-empty-actions", children: [
-                      /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void handleNewFile(), children: "New document" }),
-                      /* @__PURE__ */ jsx17(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleNewFolder(),
-                          children: "New folder"
-                        }
-                      ),
-                      (hostSupports2("workspaceFolderPicker") || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx17(
-                        "button",
-                        {
-                          type: "button",
-                          className: "db-workspace-empty-secondary",
-                          onClick: () => void handleOpenFolder(),
-                          children: "Open a folder"
-                        }
-                      )
-                    ] }),
-                    /* @__PURE__ */ jsx17("p", { className: "db-workspace-empty-hint", children: "Use the sidebar backup action to keep a portable copy of this workspace." })
-                  ] })
+                      available: updateAvailable,
+                      onApplyUpdate,
+                      blocked: documentSnapshot.conflict !== null || storageFull,
+                      statusBarVisible: updateStatusBarVisible
+                    }
+                  )
                 ] }),
-                /* @__PURE__ */ jsx17(
-                  UpdateAvailableNotice,
+                welcomeScreenShown && /* @__PURE__ */ jsx18(
+                  WelcomeScreen,
                   {
-                    available: updateAvailable,
-                    onApplyUpdate,
-                    blocked: documentSnapshot.conflict !== null || storageFull,
-                    statusBarVisible: updateStatusBarVisible
+                    onCreateDocument: handleNewFile,
+                    onTour: handleTourWelcome,
+                    onDismiss: handleTourWelcome,
+                    offerApps: hostEnvironment === null
                   }
                 )
               ]