@bendyline/docblocks-react 2.1.0 → 2.1.2

package/dist/index.js

@@ -6,7 +6,10 @@ import {
   conflictedPaths,
   isFileDirty,
   useGitContext
-} from "./chunk-5A4KEWKT.js";
+} from "./chunk-HFYPTTCH.js";
+import {
+  updateExportTargetExtension
+} from "./chunk-BI7NVU6T.js";
 import {
   AccentColorSettings,
   DB_CHROME_COLORS,
@@ -20,25 +23,25 @@ import {
   saveAccentColor,
   saveThemePreference,
   saveWriteCanvasPreferences
-} from "./chunk-FEWQUQML.js";
+} from "./chunk-3QSZY74C.js";
 import {
   pickEmptyDocumentPrompt
-} from "./chunk-VHDP4IPL.js";
+} from "./chunk-BPGEBGAN.js";
 import {
   ExportDialog
-} from "./chunk-UNYZQXWR.js";
+} from "./chunk-3CZ27FOA.js";
 import {
   buildExportFilename,
   runExport
-} from "./chunk-ZI56BNB7.js";
-import "./chunk-4XXSWN3T.js";
+} from "./chunk-GHQ4X7KM.js";
+import "./chunk-YBEYTVU2.js";
 import {
   Dialog
-} from "./chunk-FMGTHSTX.js";
+} from "./chunk-LG6HAWCK.js";
 import {
   DEFAULT_OPTIONS,
   loadLastExportOptions
-} from "./chunk-DD4VFJQI.js";
+} from "./chunk-EBWYGTN7.js";
 
 // src/FileExplorer/FileExplorer.tsx
 import { useCallback as useCallback3, useEffect as useEffect3, useMemo, useRef as useRef3, useState as useState3 } from "react";
@@ -218,13 +221,19 @@ function useFileTree(provider) {
         }
       })();
     };
-    const subscription = providerV2.watch(requestRefresh, {
-      onError: (caught) => {
-        if (disposed) return;
-        reportError(caught);
+    const subscription = providerV2.watch(
+      (event) => {
+        if (event.type === "modified") return;
         requestRefresh();
+      },
+      {
+        onError: (caught) => {
+          if (disposed) return;
+          reportError(caught);
+          requestRefresh();
+        }
       }
-    });
+    );
     void subscription.ready.catch((caught) => {
       if (!disposed) reportError(caught);
     });
@@ -1291,11 +1300,11 @@ function FileExplorer({
                 disabled: newItemCreationPending,
                 onClick: () => {
                   setNewItemError(null);
-                  setNewItemType("file");
+                  setNewItemType("directory");
                 },
-                title: "New File",
-                "aria-label": "New File",
-                children: /* @__PURE__ */ jsx3(NewFileIcon, {})
+                title: "New Folder",
+                "aria-label": "New Folder",
+                children: /* @__PURE__ */ jsx3(NewFolderIcon, {})
               }
             ),
             /* @__PURE__ */ jsx3(
@@ -1305,11 +1314,11 @@ function FileExplorer({
                 disabled: newItemCreationPending,
                 onClick: () => {
                   setNewItemError(null);
-                  setNewItemType("directory");
+                  setNewItemType("file");
                 },
-                title: "New Folder",
-                "aria-label": "New Folder",
-                children: /* @__PURE__ */ jsx3(NewFolderIcon, {})
+                title: "New File",
+                "aria-label": "New File",
+                children: /* @__PURE__ */ jsx3(NewFileIcon, {})
               }
             )
           ] })
@@ -1469,12 +1478,18 @@ function WorkspacePicker({
 }) {
   const [workspaces, setWorkspaces] = useState4([]);
   const [isOpen, setIsOpen] = useState4(false);
+  const [creatingNew, setCreatingNew] = useState4(false);
+  const [newWorkspaceName, setNewWorkspaceName] = useState4("");
+  const [newWorkspaceError, setNewWorkspaceError] = useState4(null);
+  const [newWorkspacePending, setNewWorkspacePending] = useState4(false);
   const pickerRef = useRef4(null);
   useEffect4(() => {
     if (!isOpen) return;
     function handleOutsideClick(e) {
       if (pickerRef.current && !pickerRef.current.contains(e.target)) {
         setIsOpen(false);
+        setCreatingNew(false);
+        setNewWorkspaceError(null);
       }
     }
     document.addEventListener("mousedown", handleOutsideClick);
@@ -1497,8 +1512,34 @@ function WorkspacePicker({
     },
     [onSelect]
   );
+  const handleStartCreateNew = useCallback4(() => {
+    const existingNames = new Set(workspaces.map((workspace) => workspace.name.toLowerCase()));
+    let suffix = workspaces.length + 1;
+    while (existingNames.has(`workspace ${suffix}`.toLowerCase())) suffix += 1;
+    setNewWorkspaceName(`Workspace ${suffix}`);
+    setNewWorkspaceError(null);
+    setCreatingNew(true);
+  }, [workspaces]);
+  const handleCancelCreateNew = useCallback4(() => {
+    setCreatingNew(false);
+    setNewWorkspaceName("");
+    setNewWorkspaceError(null);
+  }, []);
   const handleCreateNew = useCallback4(async () => {
-    const name = `Workspace ${workspaces.length + 1}`;
+    if (newWorkspacePending) return;
+    const name = newWorkspaceName.trim();
+    if (!name) {
+      setNewWorkspaceError("Enter a workspace name.");
+      return;
+    }
+    if (name.length > 80) {
+      setNewWorkspaceError("Workspace names must be 80 characters or fewer.");
+      return;
+    }
+    if (workspaces.some((workspace) => workspace.name.toLowerCase() === name.toLowerCase())) {
+      setNewWorkspaceError("A workspace with that name already exists.");
+      return;
+    }
     const id = `ws-${Date.now()}`;
     const descriptor = {
       id,
@@ -1506,11 +1547,21 @@ function WorkspacePicker({
       type: "indexeddb",
       lastOpened: (/* @__PURE__ */ new Date()).toISOString()
     };
-    await saveWorkspace(descriptor);
-    await refresh();
-    onSelect(descriptor);
-    setIsOpen(false);
-  }, [workspaces.length, onSelect, refresh]);
+    setNewWorkspacePending(true);
+    setNewWorkspaceError(null);
+    try {
+      await saveWorkspace(descriptor);
+      await refresh();
+      onSelect(descriptor);
+      setCreatingNew(false);
+      setNewWorkspaceName("");
+      setIsOpen(false);
+    } catch {
+      setNewWorkspaceError("The workspace could not be created. Try again.");
+    } finally {
+      setNewWorkspacePending(false);
+    }
+  }, [newWorkspaceName, newWorkspacePending, onSelect, refresh, workspaces]);
   const activeWs = workspaces.find((w) => w.id === activeWorkspaceId);
   const activeWorkspaceName = activeWs?.name ?? "No workspace";
   return /* @__PURE__ */ jsxs4("div", { ref: pickerRef, className: `db-workspace-picker ${className ?? ""}`, children: [
@@ -1518,7 +1569,11 @@ function WorkspacePicker({
       "button",
       {
         className: "db-workspace-picker-btn",
-        onClick: () => setIsOpen(!isOpen),
+        onClick: () => {
+          const nextOpen = !isOpen;
+          setIsOpen(nextOpen);
+          if (!nextOpen) handleCancelCreateNew();
+        },
         title: "Switch workspace",
         "aria-label": `Switch workspace, current: ${activeWorkspaceName}`,
         children: [
@@ -1551,10 +1606,57 @@ function WorkspacePicker({
         ws.id
       )),
       /* @__PURE__ */ jsx4("div", { className: "db-workspace-dropdown-divider" }),
-      !electron && /* @__PURE__ */ jsx4("button", { className: "db-workspace-dropdown-item", onClick: handleCreateNew, children: /* @__PURE__ */ jsxs4("span", { className: "db-workspace-dropdown-action-label", children: [
+      !electron && (creatingNew ? /* @__PURE__ */ jsxs4(
+        "form",
+        {
+          className: "db-workspace-create",
+          "aria-busy": newWorkspacePending,
+          onSubmit: (event) => {
+            event.preventDefault();
+            void handleCreateNew();
+          },
+          children: [
+            /* @__PURE__ */ jsx4("label", { className: "db-workspace-create-label", htmlFor: "db-new-workspace-name", children: "Workspace name" }),
+            /* @__PURE__ */ jsx4(
+              "input",
+              {
+                id: "db-new-workspace-name",
+                className: "db-workspace-create-input",
+                value: newWorkspaceName,
+                maxLength: 80,
+                disabled: newWorkspacePending,
+                "aria-invalid": newWorkspaceError !== null,
+                "aria-describedby": newWorkspaceError ? "db-new-workspace-error" : void 0,
+                autoFocus: true,
+                onChange: (event) => {
+                  setNewWorkspaceName(event.target.value);
+                  setNewWorkspaceError(null);
+                },
+                onKeyDown: (event) => {
+                  if (event.key === "Escape") handleCancelCreateNew();
+                }
+              }
+            ),
+            newWorkspaceError && /* @__PURE__ */ jsx4("p", { id: "db-new-workspace-error", className: "db-workspace-create-error", role: "alert", children: newWorkspaceError }),
+            /* @__PURE__ */ jsxs4("div", { className: "db-workspace-create-actions", children: [
+              /* @__PURE__ */ jsx4(
+                "button",
+                {
+                  type: "button",
+                  className: "db-workspace-create-cancel",
+                  disabled: newWorkspacePending,
+                  onClick: handleCancelCreateNew,
+                  children: "Cancel"
+                }
+              ),
+              /* @__PURE__ */ jsx4("button", { type: "submit", disabled: newWorkspacePending, children: newWorkspacePending ? "Creating\xE2\u20AC\xA6" : "Create" })
+            ] })
+          ]
+        }
+      ) : /* @__PURE__ */ jsx4("button", { className: "db-workspace-dropdown-item", onClick: handleStartCreateNew, children: /* @__PURE__ */ jsxs4("span", { className: "db-workspace-dropdown-action-label", children: [
         /* @__PURE__ */ jsx4(NewFolderIcon, {}),
         /* @__PURE__ */ jsx4("span", { children: "New Workspace" })
-      ] }) }),
+      ] }) })),
       (electron || isNativeFileSystemSupported()) && /* @__PURE__ */ jsx4(
         "button",
         {
@@ -1583,7 +1685,6 @@ function WorkspacePicker({
 
 // src/DocBlocksShell/DocBlocksShell.tsx
 import { useState as useState14, useCallback as useCallback14, useEffect as useEffect14, useRef as useRef14, useMemo as useMemo3, lazy as lazy2, Suspense as Suspense2 } from "react";
-import "@bendyline/squisq-editor-react/styles";
 import { MediaContext } from "@bendyline/squisq-react";
 import {
   DocumentVersionManager
@@ -1648,7 +1749,9 @@ function AppMenu({
   onKeepBrowserData,
   onInstallApp,
   getStorageEstimate,
-  storagePersistent
+  storagePersistent,
+  appVersion,
+  appBuildDate
 }) {
   const [isOpen, setIsOpen] = useState5(false);
   const [showAbout, setShowAbout] = useState5(false);
@@ -1745,8 +1848,8 @@ function AppMenu({
           {
             className: "db-app-menu-item",
             role: "menuitem",
-            onClick: () => handleAction(() => void onKeepBrowserData()),
-            children: "Keep data in browser for longer"
+            onClick: () => handleAction(() => setShowSettings(true)),
+            children: "Storage protection\u2026"
           }
         ),
         onDownloadAllWorkspaces && /* @__PURE__ */ jsx5(
@@ -1799,7 +1902,7 @@ function AppMenu({
         )} of the ${formatBytes(
           storageEstimate.quota
         )} this browser allows for the site.` : "Storage usage is not available in this browser." }),
-        storagePersistent !== void 0 && /* @__PURE__ */ jsx5("p", { className: "db-settings-hint", children: storagePersistent ? "Data is marked persistent, so the browser will avoid evicting it." : "Data is not yet marked persistent." }),
+        storagePersistent !== void 0 && /* @__PURE__ */ jsx5("p", { className: "db-settings-hint", children: storagePersistent ? "Protected from routine browser cleanup on this device." : "Browsers may clear site data under storage pressure unless protection is granted." }),
         onKeepBrowserData && /* @__PURE__ */ jsx5(
           "button",
           {
@@ -1807,7 +1910,7 @@ function AppMenu({
             className: "db-settings-action",
             disabled: requestingPersistentStorage,
             onClick: () => void handleKeepBrowserDataFromSettings(),
-            children: requestingPersistentStorage ? "Requesting persistent storage\u2026" : "Keep data in browser for longer"
+            children: requestingPersistentStorage ? "Requesting storage protection\u2026" : "Protect data from browser cleanup"
           }
         )
       ] }),
@@ -1863,7 +1966,15 @@ function AppMenu({
     showAbout && /* @__PURE__ */ jsxs5(Dialog, { title: "About DocBlocks", onClose: () => setShowAbout(false), children: [
       /* @__PURE__ */ jsxs5("p", { children: [
         /* @__PURE__ */ jsx5("strong", { children: "DocBlocks" }),
-        " is a markdown document editor that runs entirely in your browser. Your files stay on your device."
+        " is a local-first Markdown document editor. Your files stay under your control."
+      ] }),
+      appVersion && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
+        /* @__PURE__ */ jsx5("span", { children: "Version" }),
+        /* @__PURE__ */ jsx5("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
+      ] }),
+      appBuildDate && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
+        /* @__PURE__ */ jsx5("span", { children: "Build" }),
+        /* @__PURE__ */ jsx5("time", { dateTime: appBuildDate, children: appBuildDate })
       ] }),
       /* @__PURE__ */ jsxs5("p", { children: [
         "Built with",
@@ -1886,6 +1997,26 @@ function AppMenu({
           }
         ),
         /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx5(
+          "a",
+          {
+            href: "https://github.com/bendyline/docblocks/releases",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: "Release notes"
+          }
+        ),
+        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
+        /* @__PURE__ */ jsx5(
+          "a",
+          {
+            href: "https://github.com/bendyline/docblocks/issues",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: "Support"
+          }
+        ),
+        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
         /* @__PURE__ */ jsx5(
           "a",
           {
@@ -2129,7 +2260,7 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx8 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-GHAOJMH6.js").then((module) => ({
+  () => import("./ExportToolbarControls-C46GMPKC.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -2514,17 +2645,45 @@ function retainFileSystemProvider(provider) {
 // src/DocBlocksShell/document-title.ts
 import { useEffect as useEffect9 } from "react";
 var APP_TITLE = "DocBlocks";
-function titleForSelectedFile(selectedFile, homeDocumentTitle = APP_TITLE, homeDocumentPath) {
-  if (!selectedFile || selectedFile === homeDocumentPath) return homeDocumentTitle;
+var INSTALLED_DISPLAY_QUERIES = [
+  "(display-mode: window-controls-overlay)",
+  "(display-mode: standalone)"
+];
+function unbrandedHomeTitle(homeDocumentTitle) {
+  if (homeDocumentTitle === APP_TITLE) return "";
+  for (const separator of [" \u2014 ", " - ", ": ", " | "]) {
+    const prefix = `${APP_TITLE}${separator}`;
+    if (homeDocumentTitle.startsWith(prefix)) return homeDocumentTitle.slice(prefix.length);
+  }
+  return homeDocumentTitle;
+}
+function titleForSelectedFile(selectedFile, homeDocumentTitle = APP_TITLE, homeDocumentPath, includeAppName = true) {
+  if (!selectedFile || selectedFile === homeDocumentPath) {
+    return includeAppName ? homeDocumentTitle : unbrandedHomeTitle(homeDocumentTitle);
+  }
   const filename = selectedFile.replace(/^\/+/, "").split("/").pop();
   const name = filename?.replace(/\.[^.]+$/, "");
-  return name ? `${name} - ${APP_TITLE}` : APP_TITLE;
+  if (!name) return includeAppName ? APP_TITLE : "";
+  return includeAppName ? `${name} - ${APP_TITLE}` : name;
 }
 function useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath) {
   useEffect9(() => {
-    if (typeof document !== "undefined") {
-      document.title = titleForSelectedFile(selectedFile, homeDocumentTitle, homeDocumentPath);
-    }
+    if (typeof document === "undefined") return;
+    const displayQueries = typeof globalThis.matchMedia === "function" ? INSTALLED_DISPLAY_QUERIES.map((query) => globalThis.matchMedia(query)) : [];
+    const updateTitle = () => {
+      const includeAppName = !displayQueries.some((query) => query.matches);
+      document.title = titleForSelectedFile(
+        selectedFile,
+        homeDocumentTitle,
+        homeDocumentPath,
+        includeAppName
+      );
+    };
+    updateTitle();
+    for (const query of displayQueries) query.addEventListener("change", updateTitle);
+    return () => {
+      for (const query of displayQueries) query.removeEventListener("change", updateTitle);
+    };
   }, [homeDocumentPath, homeDocumentTitle, selectedFile]);
 }
 
@@ -3055,7 +3214,7 @@ function UpdateAvailableNotice({
   blocked = false,
   statusBarVisible
 }) {
-  const [promptOpen, setPromptOpen] = useState13(false);
+  const [promptOpen, setPromptOpen] = useState13(true);
   if (!available || !onApplyUpdate) return null;
   const promptVisible = promptOpen && !blocked;
   return /* @__PURE__ */ jsxs10(Fragment6, { children: [
@@ -3074,9 +3233,9 @@ function UpdateAvailableNotice({
       }
     ),
     promptVisible && /* @__PURE__ */ jsxs10("div", { id: UPDATE_PROMPT_ID, className: "db-update-banner", role: "alert", children: [
-      /* @__PURE__ */ jsx11("span", { children: "A new version of DocBlocks is available." }),
+      /* @__PURE__ */ jsx11("span", { children: "A new version of DocBlocks is available. Reload to update the editor and site pages." }),
       /* @__PURE__ */ jsxs10("div", { className: "db-update-banner-actions", children: [
-        /* @__PURE__ */ jsx11("button", { type: "button", onClick: onApplyUpdate, children: "Reload" }),
+        /* @__PURE__ */ jsx11("button", { type: "button", onClick: onApplyUpdate, disabled: blocked, children: "Reload" }),
         /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => setPromptOpen(false), children: "Later" })
       ] })
     ] })
@@ -3392,14 +3551,20 @@ async function copyTransientWorkspaceContents(source, destination) {
 
 // src/DocBlocksShell/DocBlocksShell.tsx
 import { Fragment as Fragment7, jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
-var EditorShell = lazy2(async () => {
-  const workersReady = globalThis.docBlocksMonacoWorkersReady;
-  await workersReady?.catch(() => void 0);
-  return import("./LazyEditorShell-EF2BWRXU.js");
-});
-var GitUI = lazy2(() => import("./GitUI-VHOBQY43.js").then((m) => ({ default: m.GitUI })));
+var editorShellModulePromise = null;
+function loadEditorShell() {
+  editorShellModulePromise ?? (editorShellModulePromise = (async () => {
+    const workersReady = globalThis.docBlocksMonacoWorkersReady;
+    const editorReady = import("./LazyEditorShell-LU4QFPDX.js");
+    const [editorModule] = await Promise.all([editorReady, workersReady?.catch(() => void 0)]);
+    return editorModule;
+  })());
+  return editorShellModulePromise;
+}
+var EditorShell = lazy2(loadEditorShell);
+var GitUI = lazy2(() => import("./GitUI-GMH3PAYL.js").then((m) => ({ default: m.GitUI })));
 var GitToolbarControl = lazy2(
-  () => import("./GitToolbarControl-GNMRVKWQ.js").then((m) => ({ default: m.GitToolbarControl }))
+  () => import("./GitToolbarControl-FW3BZFXV.js").then((m) => ({ default: m.GitToolbarControl }))
 );
 var DOCBLOCKS_VIDEO_EXPORT_PALETTE = Object.freeze({
   overlay: "rgba(0, 0, 0, 0.72)",
@@ -3679,6 +3844,8 @@ function DocBlocksShell({
   theme: hostTheme = "auto",
   logoUrl,
   issueReportVersion,
+  appBuildDate,
+  ffmpegWasm,
   homeDocumentTitle,
   homeDocumentPath,
   allowVersioning = true,
@@ -3723,14 +3890,20 @@ function DocBlocksShell({
     saveViewPreferences(prefs);
   }, []);
   const isMobile = useIsMobile();
-  const [mobileShowEditor, setMobileShowEditor] = useState14(false);
+  const [mobileShowEditor, setMobileShowEditor] = useState14(
+    () => isMobile && isWelcomeGatewayDismissed()
+  );
+  useEffect14(() => {
+    if (isMobile) void loadEditorShell();
+  }, [isMobile]);
   const [sidebarWidth, setSidebarWidth] = useState14(loadSidebarWidth);
   const [compactLayout, setCompactLayout] = useState14(false);
   const effectiveCompact = isMobile || compactLayout;
   const showBrowserStorageWarning = !isElectronHost2();
+  const appVersion = isElectronHost2() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web";
   const issueReportUrl = buildIssueReportUrl({
     reportedAt: /* @__PURE__ */ new Date(),
-    version: isElectronHost2() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web",
+    version: appVersion,
     userAgent: typeof navigator === "undefined" ? "" : navigator.userAgent
   });
   const [browserStoragePersistent, setBrowserStoragePersistent] = useState14(false);
@@ -4259,25 +4432,25 @@ function DocBlocksShell({
         "",
         "Your markdown can do anything.",
         "",
-        "DocBlocks is a free browser-based markdown document editor that lets you create, organize, and manage your documents right in the browser. What you write here can become a Word or PDF doc, a slide deck, an e-book, or a video.",
+        "DocBlocks is a free, local-first Markdown editor for creating, organizing, and publishing documents without sending your writing to a server. What you write here can become a Word or PDF document, a slide deck, a web page, or a video.",
         "",
         "Simple to write. Beautiful wherever it goes.",
         "",
         "## Features",
         "",
-        "- **Rich Markdown Editing** -- Write in a visual editor or switch to raw markdown source anytime. Use section annotations to change the visualization for blocks of content.",
-        "- **Workspaces** -- Organize your documents into separate workspaces in the browser or on your device.",
-        "- **Useful Everywhere** -- Your content is usable across multiple formats -- Microsoft Word .docx, PowerPoint, PDF, HTML, EPUB e-books, and Markdown.",
-        "- **Playback & Video** -- Preview your documents as rich visual presentations and export them as MP4 video",
-        "- **No BS** -- Free, no ads, no accounts, no tracking - everything runs locally in your browser",
+        "- **Rich Markdown editing** \u2014 Write visually or switch to raw Markdown source at any time. Section annotations can change how individual blocks are presented.",
+        "- **Workspaces** \u2014 Organize documents into separate browser workspaces or folders on your device.",
+        "- **Useful everywhere** \u2014 Export Word, PowerPoint, PDF, HTML, and Markdown in the app, with EPUB and additional formats available through the CLI.",
+        "- **Playback and video** \u2014 Preview a document as a rich presentation and export it as an MP4 video.",
+        "- **Private by default** \u2014 No ads, accounts, or tracking. Your browser workspace stays on this device.",
         "",
         "## Getting Started",
         "",
-        "1. Create a new file using the **New File** button in the sidebar",
-        "2. Start writing in markdown -- the editor supports headings, lists, links, images, and more",
-        "3. Your work is saved automatically",
+        "1. Create a document with the **New file** button in the file pane.",
+        "2. Start writing in Markdown \u2014 the editor supports headings, lists, links, images, and more.",
+        "3. Your work is saved automatically.",
         "",
-        "Built on [Squiggly Square markdown extensions](https://github.com/bendyline/squisq) by [Bendyline](https://bendyline.com).",
+        "Built with [squisq](https://github.com/bendyline/squisq) by [Bendyline](https://bendyline.com).",
         "",
         "## Explore DocBlocks",
         "",
@@ -5179,6 +5352,52 @@ function DocBlocksShell({
     promptForText,
     showToast
   ]);
+  const handleNewFolder = useCallback14(async () => {
+    if (!provider) return;
+    const name = await promptForText({
+      title: "New folder",
+      label: "Folder name",
+      initialValue: "Untitled folder",
+      confirmLabel: "Create"
+    });
+    if (!name) return;
+    const folderName = name.trim();
+    if (!folderName || /[\\/]/.test(folderName)) {
+      showToast("error", "Use a folder name without slashes.");
+      return;
+    }
+    const path = `/${folderName}`;
+    try {
+      const providerV2 = getFileSystemProviderV25(provider);
+      if (providerV2) {
+        await providerV2.createDirectory(parseWorkspacePath5(path), { mode: "create" });
+      } else {
+        if (await providerEntryExists(provider, path)) {
+          throw new Error("A file or folder with that name already exists.");
+        }
+        await provider.createDirectory(path);
+      }
+    } catch (error) {
+      const message = error instanceof FsError5 && error.code === "already-exists" ? "A file or folder with that name already exists." : error instanceof Error ? error.message : "Could not create the folder.";
+      showToast("error", message);
+      return;
+    }
+    setSelectedFile(null);
+    setSelectedFolder(path);
+    setFolderEntries([]);
+    setExplorerKey((key) => key + 1);
+    closeWelcomeGateway();
+    if (activeWorkspaceId) pushHash(activeWorkspaceId, null);
+    if (effectiveCompact) setMobileShowEditor(true);
+  }, [
+    provider,
+    promptForText,
+    showToast,
+    closeWelcomeGateway,
+    activeWorkspaceId,
+    pushHash,
+    effectiveCompact
+  ]);
   const actionNewHandledRef = useRef14(false);
   useEffect14(() => {
     if (!provider || actionNewHandledRef.current) return;
@@ -5867,10 +6086,11 @@ function DocBlocksShell({
         ),
         /* @__PURE__ */ jsxs11("div", { style: { display: "flex", flex: 1, overflow: "hidden" }, children: [
           (!effectiveCompact || !mobileShowEditor) && /* @__PURE__ */ jsxs11(
-            "div",
+            "aside",
             {
               ref: sidebarRef,
               className: "db-shell-sidebar",
+              "aria-label": "Workspace and files",
               style: effectiveCompact ? void 0 : { width: `${sidebarWidth}px` },
               children: [
                 /* @__PURE__ */ jsxs11("div", { className: "db-shell-sidebar-header", children: [
@@ -5890,7 +6110,9 @@ function DocBlocksShell({
                       onKeepBrowserData: showBrowserStorageWarning && !browserStoragePersistent ? handleKeepBrowserData : void 0,
                       onInstallApp: installPromptEvent ? handleInstallApp : void 0,
                       getStorageEstimate: showBrowserStorageWarning ? getBrowserStorageEstimate : void 0,
-                      storagePersistent: showBrowserStorageWarning ? browserStoragePersistent : void 0
+                      storagePersistent: showBrowserStorageWarning ? browserStoragePersistent : void 0,
+                      appVersion,
+                      appBuildDate
                     }
                   ),
                   /* @__PURE__ */ jsx12(
@@ -5945,12 +6167,46 @@ function DocBlocksShell({
                   },
                   explorerKey
                 ),
+                isMobile && showWelcomeGateway && /* @__PURE__ */ jsxs11(
+                  "section",
+                  {
+                    className: "db-mobile-first-run",
+                    "aria-labelledby": "db-mobile-first-run-title",
+                    children: [
+                      /* @__PURE__ */ jsx12("p", { className: "db-mobile-first-run-eyebrow", children: "Local-first Markdown editor" }),
+                      /* @__PURE__ */ jsx12("h1", { id: "db-mobile-first-run-title", children: "Welcome to DocBlocks" }),
+                      /* @__PURE__ */ jsx12("p", { children: "Write visually, keep plain Markdown underneath, and export the same document in useful formats. Your browser workspace stays on this device." }),
+                      /* @__PURE__ */ jsxs11("div", { className: "db-mobile-first-run-actions", children: [
+                        /* @__PURE__ */ jsx12(
+                          "button",
+                          {
+                            type: "button",
+                            onClick: () => {
+                              closeWelcomeGateway();
+                              setMobileShowEditor(true);
+                            },
+                            children: "Tour the welcome document"
+                          }
+                        ),
+                        /* @__PURE__ */ jsx12(
+                          "button",
+                          {
+                            type: "button",
+                            className: "db-mobile-first-run-secondary",
+                            onClick: () => void handleNewFile(),
+                            children: "Create a document"
+                          }
+                        )
+                      ] })
+                    ]
+                  }
+                ),
                 /* @__PURE__ */ jsxs11("div", { className: "db-shell-sidebar-footer", children: [
                   /* @__PURE__ */ jsx12("a", { href: "https://docblocks.com/docs/", target: "_blank", rel: "noopener noreferrer", children: "Docs" }),
                   /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
                   /* @__PURE__ */ jsx12("a", { href: "https://docblocks.com/terms/", target: "_blank", rel: "noopener noreferrer", children: "Terms" }),
                   /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
-                  /* @__PURE__ */ jsx12("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Issues" }),
+                  /* @__PURE__ */ jsx12("a", { href: issueReportUrl, target: "_blank", rel: "noopener noreferrer", children: "Report issue" }),
                   showBrowserStorageWarning && /* @__PURE__ */ jsxs11(Fragment7, { children: [
                     /* @__PURE__ */ jsx12("span", { className: "db-shell-sidebar-footer-separator", "aria-hidden": "true", children: "\u2022" }),
                     /* @__PURE__ */ jsx12(
@@ -5981,6 +6237,7 @@ function DocBlocksShell({
           (!effectiveCompact || mobileShowEditor) && /* @__PURE__ */ jsxs11(
             "main",
             {
+              "aria-label": "Document editor",
               className: updateAvailable && onApplyUpdate && updateStatusBarVisible ? "db-shell-editor-area db-shell-editor-area--has-update" : "db-shell-editor-area",
               style: {
                 flex: 1,
@@ -5994,7 +6251,7 @@ function DocBlocksShell({
                   /* @__PURE__ */ jsx12(
                     Suspense2,
                     {
-                      fallback: /* @__PURE__ */ jsx12("div", { className: "db-shell-empty", role: "status", children: "Loading editor\u2026" }),
+                      fallback: /* @__PURE__ */ jsx12("div", { className: "db-shell-empty", role: "status", children: "Loading your document\u2026" }),
                       children: /* @__PURE__ */ jsx12(
                         EditorShell,
                         {
@@ -6047,6 +6304,7 @@ function DocBlocksShell({
                                 destinationAdapter: exportDestinationAdapter,
                                 colorScheme: resolvedTheme,
                                 videoExportPalette: DOCBLOCKS_VIDEO_EXPORT_PALETTE,
+                                ffmpegWasm,
                                 initialSharedMode
                               }
                             )
@@ -6056,11 +6314,12 @@ function DocBlocksShell({
                       )
                     }
                   ),
-                  showWelcomeGateway && /* @__PURE__ */ jsxs11("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
+                  showWelcomeGateway && !isMobile && /* @__PURE__ */ jsxs11("div", { className: "db-welcome-gateway", role: "note", "aria-label": "Welcome tip", children: [
                     /* @__PURE__ */ jsxs11("span", { className: "db-welcome-gateway-text", children: [
                       "You\u2019re watching this welcome doc in ",
                       /* @__PURE__ */ jsx12("strong", { children: "Slideshow" }),
-                      " view -- it\u2019s a regular markdown file, and so is everything you\u2019ll write."
+                      " ",
+                      "view\u2014 it\u2019s a regular markdown file, and so is everything you\u2019ll write."
                     ] }),
                     /* @__PURE__ */ jsx12("button", { className: "db-welcome-gateway-cta", onClick: handleStartWriting, children: "Start writing" }),
                     /* @__PURE__ */ jsx12(
@@ -6095,12 +6354,38 @@ function DocBlocksShell({
                     },
                     entry.path
                   )) })
-                ] }) : /* @__PURE__ */ jsxs11("div", { className: "db-shell-empty", children: [
+                ] }) : /* @__PURE__ */ jsxs11("div", { className: "db-shell-empty db-shell-empty--workspace", children: [
                   effectiveCompact && /* @__PURE__ */ jsxs11("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [
                     /* @__PURE__ */ jsx12("span", { className: "db-mobile-files-icon", children: /* @__PURE__ */ jsx12(FolderGlyph, {}) }),
                     "Back to files"
                   ] }),
-                  /* @__PURE__ */ jsx12("p", { children: "Select a file to start editing, or create a new one." })
+                  /* @__PURE__ */ jsxs11("div", { className: "db-workspace-empty-content", children: [
+                    /* @__PURE__ */ jsx12("span", { className: "db-workspace-empty-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx12(FileGlyph, {}) }),
+                    /* @__PURE__ */ jsx12("h1", { children: activeWorkspaceDescriptor?.name ? `${activeWorkspaceDescriptor.name} is ready` : "Your workspace is ready" }),
+                    /* @__PURE__ */ jsx12("p", { children: "Create your first Markdown document, or open a folder you already use." }),
+                    /* @__PURE__ */ jsxs11("div", { className: "db-workspace-empty-actions", children: [
+                      /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void handleNewFile(), children: "Create your first document" }),
+                      /* @__PURE__ */ jsx12(
+                        "button",
+                        {
+                          type: "button",
+                          className: "db-workspace-empty-secondary",
+                          onClick: () => void handleNewFolder(),
+                          children: "New folder"
+                        }
+                      ),
+                      (isElectronHost2() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx12(
+                        "button",
+                        {
+                          type: "button",
+                          className: "db-workspace-empty-secondary",
+                          onClick: () => void handleOpenFolder(),
+                          children: "Open a folder"
+                        }
+                      )
+                    ] }),
+                    /* @__PURE__ */ jsx12("p", { className: "db-workspace-empty-hint", children: "Browser workspaces stay on this device. Use the sidebar backup action to keep a portable copy." })
+                  ] })
                 ] }),
                 /* @__PURE__ */ jsx12(
                   UpdateAvailableNotice,
@@ -6119,34 +6404,6 @@ function DocBlocksShell({
     }
   );
 }
-
-// src/Export/export-destination.ts
-function updateExportTargetExtension(targetPath, suggestedFilename) {
-  const nextExtension = extensionOf(suggestedFilename);
-  if (!nextExtension) return targetPath;
-  if (!targetPath.trim()) return suggestedFilename;
-  const suffixIndex = firstSuffixIndex(targetPath);
-  const pathPart = suffixIndex === -1 ? targetPath : targetPath.slice(0, suffixIndex);
-  const suffix = suffixIndex === -1 ? "" : targetPath.slice(suffixIndex);
-  const separatorIndex = Math.max(pathPart.lastIndexOf("/"), pathPart.lastIndexOf("\\"));
-  const dotIndex = pathPart.lastIndexOf(".");
-  const stem = dotIndex > separatorIndex ? pathPart.slice(0, dotIndex) : pathPart;
-  return `${stem}${nextExtension}${suffix}`;
-}
-function extensionOf(value) {
-  const suffixIndex = firstSuffixIndex(value);
-  const pathPart = suffixIndex === -1 ? value : value.slice(0, suffixIndex);
-  const separatorIndex = Math.max(pathPart.lastIndexOf("/"), pathPart.lastIndexOf("\\"));
-  const dotIndex = pathPart.lastIndexOf(".");
-  return dotIndex > separatorIndex ? pathPart.slice(dotIndex) : "";
-}
-function firstSuffixIndex(value) {
-  const query = value.indexOf("?");
-  const fragment = value.indexOf("#");
-  if (query === -1) return fragment;
-  if (fragment === -1) return query;
-  return Math.min(query, fragment);
-}
 export {
   AccentColorSettings,
   AppMenu,
@@ -6167,4 +6424,3 @@ export {
   useDocumentSession,
   useFileTree
 };
-//# sourceMappingURL=index.js.map