@bendyline/docblocks-react 2.2.0 → 2.2.1

package/dist/{ExportDialog-VYATD5UC.js → ExportDialog-HPFPXELL.js}

@@ -1,6 +1,6 @@
 import {
   ExportDialog
-} from "./chunk-3CZ27FOA.js";
+} from "./chunk-MHTQORMH.js";
 import "./chunk-YBEYTVU2.js";
 import "./chunk-LG6HAWCK.js";
 import "./chunk-EBWYGTN7.js";

package/dist/{ExportToolbarControls-C46GMPKC.js → ExportToolbarControls-2VB43ITO.js}

@@ -26,7 +26,7 @@ import { getThemeSummaries } from "@bendyline/squisq/schemas";
 import { parseMarkdown } from "@bendyline/squisq/markdown";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var ExportDialog = lazy(
-  () => import("./ExportDialog-VYATD5UC.js").then((module) => ({ default: module.ExportDialog }))
+  () => import("./ExportDialog-HPFPXELL.js").then((module) => ({ default: module.ExportDialog }))
 );
 var ShareDialog = lazy(
   () => import("./ShareDialog-PAMOQQFB.js").then((module) => ({ default: module.ShareDialog }))
@@ -225,10 +225,6 @@ function ExportToolbarControls({
     },
     [markdownSource, videoModules]
   );
-  const handleOpenAnimatedGifFromDialog = useCallback(() => {
-    setDialogOpen(false);
-    void handleOpenVideoModal("gif");
-  }, [handleOpenVideoModal]);
   const handleCloseVideoModal = useCallback(() => {
     setVideoModalOpen(false);
     setVideoDoc(null);
@@ -438,7 +434,6 @@ function ExportToolbarControls({
         } : void 0,
         onExport: handleExport,
         onOptionsChange: destinationAdapter ? handleOptionsChange : void 0,
-        onAnimatedGifExport: showAnimatedGifExport ? handleOpenAnimatedGifFromDialog : void 0,
         onClose: handleCloseDialog
       }
     ) }),

package/dist/{chunk-3CZ27FOA.js → chunk-MHTQORMH.js}

@@ -76,7 +76,6 @@ function ExportDialog({
   destination,
   onExport,
   onOptionsChange,
-  onAnimatedGifExport,
   onClose
 }) {
   const [format, setFormat] = useState(initial.format);
@@ -327,23 +326,8 @@ function ExportDialog({
             }
           )
         ] }),
-        onAnimatedGifExport && /* @__PURE__ */ jsxs("div", { className: "db-export-field", children: [
-          /* @__PURE__ */ jsx("span", { className: "db-export-label", children: "Animated media" }),
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              className: "db-export-btn db-export-btn--secondary",
-              onClick: onAnimatedGifExport,
-              children: "Animated GIF..."
-            }
-          ),
-          /* @__PURE__ */ jsx("span", { className: "db-export-hint", children: "Opens timing, orientation, captions, looping, and color controls." })
-        ] }),
         /* @__PURE__ */ jsxs("p", { className: "db-export-more-formats", children: [
-          "Need spreadsheets, ",
-          onAnimatedGifExport ? "" : "animated media, ",
-          "portable bundles, or automation?",
+          "Need spreadsheets, animated media, portable bundles, or automation?",
           " ",
           /* @__PURE__ */ jsx("a", { href: "https://docblocks.com/cli/", target: "_blank", rel: "noopener noreferrer", children: "More formats with the DocBlocks CLI" }),
           "."

package/dist/export/index.d.ts

@@ -81,8 +81,6 @@ interface ExportDialogProps {
     onExport: (options: ExportOptions) => void;
     /** Called whenever the currently selected options change. */
     onOptionsChange?: (options: ExportOptions) => void;
-    /** Opens the richer animated-GIF export flow when the host supports ffmpeg.wasm. */
-    onAnimatedGifExport?: () => void;
     /** Called when the dialog is dismissed. */
     onClose: () => void;
 }
@@ -95,7 +93,7 @@ interface ExportDestinationControl {
     /** A host-supplied validation error for the current destination value. */
     error?: string | null;
 }
-declare function ExportDialog({ initial, exporting, error, destination, onExport, onOptionsChange, onAnimatedGifExport, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
+declare function ExportDialog({ initial, exporting, error, destination, onExport, onOptionsChange, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
 
 /** Keep a user-edited target name while switching the selected export format. */
 declare function updateExportTargetExtension(targetPath: string, suggestedFilename: string): string;

package/dist/export/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-BI7NVU6T.js";
 import {
   ExportDialog
-} from "../chunk-3CZ27FOA.js";
+} from "../chunk-MHTQORMH.js";
 import {
   buildExportFilename,
   runExport

package/dist/index.d.ts

@@ -219,7 +219,7 @@ interface DocBlocksShellProps {
     /**
      * True when a new deploy is waiting (browser PWA hosts: a fresh service
      * worker finished installing). The shell shows an "Update available"
-     * status-bar notice that opens a Reload/Later prompt.
+     * status-bar notice; clicking it opens a nearby Reload/Later prompt.
      */
     updateAvailable?: boolean;
     /** Activates the waiting update and reloads onto the new version. */

package/dist/index.js

@@ -29,7 +29,7 @@ import {
 } from "./chunk-BPGEBGAN.js";
 import {
   ExportDialog
-} from "./chunk-3CZ27FOA.js";
+} from "./chunk-MHTQORMH.js";
 import {
   buildExportFilename,
   runExport
@@ -1704,7 +1704,7 @@ import {
   DocumentCommitConflictError,
   DocumentSessionConflictError
 } from "@bendyline/docblocks/document";
-import { isElectronHost as isElectronHost2, getDocBlocksHost } from "@bendyline/docblocks/host";
+import { isElectronHost as isElectronHost3, getDocBlocksHost } from "@bendyline/docblocks/host";
 import {
   parseSharedDocumentHash
 } from "@bendyline/docblocks/share";
@@ -1723,6 +1723,7 @@ import {
 
 // src/AppMenu/AppMenu.tsx
 import { useState as useState5, useCallback as useCallback5, useRef as useRef5, useEffect as useEffect5 } from "react";
+import { isElectronHost as isElectronHost2 } from "@bendyline/docblocks/host";
 import { Fragment as Fragment3, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function formatBytes(bytes) {
   if (!Number.isFinite(bytes) || bytes < 0) return "\u2014";
@@ -1757,6 +1758,7 @@ function AppMenu({
   const [showAbout, setShowAbout] = useState5(false);
   const [showSettings, setShowSettings] = useState5(false);
   const [requestingPersistentStorage, setRequestingPersistentStorage] = useState5(false);
+  const moreInformationUrl = isElectronHost2() ? "https://docblocks.com/desktop/" : "https://docblocks.com/web/";
   const menuRef = useRef5(null);
   const [storageEstimate, setStorageEstimate] = useState5(null);
   useEffect5(() => {
@@ -1968,6 +1970,22 @@ function AppMenu({
         /* @__PURE__ */ jsx5("strong", { children: "DocBlocks" }),
         " is a local-first Markdown document editor. Your files stay under your control."
       ] }),
+      /* @__PURE__ */ jsxs5("aside", { className: "db-about-beta", children: [
+        /* @__PURE__ */ jsx5("strong", { children: "Beta Software." }),
+        " We're still working through initial hiccups and issues. Please bear with us, make sure you keep backups, and",
+        " ",
+        /* @__PURE__ */ jsx5(
+          "a",
+          {
+            href: "https://github.com/bendyline/docblocks/issues/new",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: "open issues"
+          }
+        ),
+        " ",
+        "where you find them. Thanks!"
+      ] }),
       appVersion && /* @__PURE__ */ jsxs5("p", { className: "db-about-version", children: [
         /* @__PURE__ */ jsx5("span", { children: "Version" }),
         /* @__PURE__ */ jsx5("code", { "aria-label": `DocBlocks version ${appVersion}`, children: appVersion })
@@ -1987,6 +2005,8 @@ function AppMenu({
         "."
       ] }),
       /* @__PURE__ */ jsxs5("p", { className: "db-dialog-links", children: [
+        /* @__PURE__ */ jsx5("a", { href: moreInformationUrl, target: "_blank", rel: "noopener noreferrer", children: "More information..." }),
+        /* @__PURE__ */ jsx5("span", { className: "db-dialog-sep", children: "\xB7" }),
         /* @__PURE__ */ jsx5(
           "a",
           {
@@ -2260,7 +2280,7 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx8 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-C46GMPKC.js").then((module) => ({
+  () => import("./ExportToolbarControls-2VB43ITO.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -2719,6 +2739,63 @@ async function decodeDbkWorkspace(bytes, options) {
   return snapshot;
 }
 
+// src/DocBlocksShell/editor-link-navigation.ts
+import { HOST_WIRE_LIMITS, isBoundedString, parseExternalHttpUrl } from "@bendyline/docblocks/host";
+var URI_SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+var MARKDOWN_EXTENSION = /\.(?:md|markdown|mdown)$/iu;
+function resolveShellEditorLinkTarget(href, documentPath) {
+  if (!isBoundedString(href, HOST_WIRE_LIMITS.urlCharacters, 1)) return null;
+  if (href.startsWith("#")) return { kind: "fragment" };
+  const externalUrl = parseExternalHttpUrl(href);
+  if (externalUrl) return { kind: "external", url: externalUrl };
+  if (documentPath === null || href.startsWith("//") || URI_SCHEME.test(href)) return null;
+  const splitAt = href.search(/[?#]/u);
+  const encodedPath = splitAt === -1 ? href : href.slice(0, splitAt);
+  if (!encodedPath) return null;
+  let decodedPath;
+  try {
+    decodedPath = decodeURIComponent(encodedPath);
+  } catch {
+    return null;
+  }
+  if (decodedPath.includes("\\") || hasControlCharacter(decodedPath)) return null;
+  const documentSegments = normalizeDocumentPath(documentPath);
+  if (!documentSegments) return null;
+  const targetSegments = decodedPath.startsWith("/") ? [] : documentSegments.slice(0, -1);
+  for (const segment of decodedPath.split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === "..") {
+      if (targetSegments.length === 0) return null;
+      targetSegments.pop();
+      continue;
+    }
+    if (segment.length > 255) return null;
+    targetSegments.push(segment);
+  }
+  const path = targetSegments.join("/");
+  if (!path || path.length > HOST_WIRE_LIMITS.pathCharacters || !MARKDOWN_EXTENSION.test(path)) {
+    return null;
+  }
+  return { kind: "workspace", path };
+}
+function normalizeDocumentPath(path) {
+  if (!isBoundedString(path, HOST_WIRE_LIMITS.pathCharacters, 1)) return null;
+  const segments = [];
+  for (const segment of path.replace(/\\/g, "/").split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === ".." || segment.length > 255 || hasControlCharacter(segment)) return null;
+    segments.push(segment);
+  }
+  return segments.length > 0 ? segments : null;
+}
+function hasControlCharacter(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    const code = value.charCodeAt(index);
+    if (code <= 31 || code === 127) return true;
+  }
+  return false;
+}
+
 // src/DocBlocksShell/import-files.ts
 import { FsError as FsError3 } from "@bendyline/docblocks/filesystem";
 
@@ -3214,7 +3291,7 @@ function UpdateAvailableNotice({
   blocked = false,
   statusBarVisible
 }) {
-  const [promptOpen, setPromptOpen] = useState13(true);
+  const [promptOpen, setPromptOpen] = useState13(false);
   if (!available || !onApplyUpdate) return null;
   const promptVisible = promptOpen && !blocked;
   return /* @__PURE__ */ jsxs10(Fragment6, { children: [
@@ -3232,13 +3309,21 @@ function UpdateAvailableNotice({
         children: "Update available"
       }
     ),
-    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. Reload to update the editor and site pages." }),
-      /* @__PURE__ */ jsxs10("div", { className: "db-update-banner-actions", children: [
-        /* @__PURE__ */ jsx11("button", { type: "button", onClick: onApplyUpdate, disabled: blocked, children: "Reload" }),
-        /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => setPromptOpen(false), children: "Later" })
-      ] })
-    ] })
+    promptVisible && /* @__PURE__ */ jsxs10(
+      "div",
+      {
+        id: UPDATE_PROMPT_ID,
+        className: `db-update-banner${statusBarVisible ? "" : " db-update-banner--floating"}`,
+        role: "alert",
+        children: [
+          /* @__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, disabled: blocked, children: "Reload" }),
+            /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => setPromptOpen(false), children: "Later" })
+          ] })
+        ]
+      }
+    )
   ] });
 }
 
@@ -3549,6 +3634,91 @@ async function copyTransientWorkspaceContents(source, destination) {
   }
 }
 
+// src/DocBlocksShell/welcome-document.ts
+var WELCOME_DOCUMENT_PATH = "/aboutDocBlocks.md";
+var WELCOME_DOCUMENT_CONTENT = [
+  "---",
+  "squisq-theme: warm-earth",
+  "squisq-cover-slide: false",
+  "---",
+  "",
+  '# DocBlocks: one Markdown file, many finished forms {[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.",
+  "",
+  "## One source, four ways to publish {[diagram]}",
+  "",
+  "```diagram",
+  "+------------+",
+  "|  Markdown  |",
+  "+-----+------+",
+  "      |",
+  "  +---+------+------------+-----------+",
+  "  |          |            |           |",
+  "  v          v            v           v",
+  "+-------+ +---------+ +------------+ +-------+",
+  "| Pages | |Documents| | Slideshows | | Video |",
+  "+-------+ +---------+ +------------+ +-------+",
+  "```",
+  "",
+  "## Write visually, then look under the hood whenever you like {[content]}",
+  "",
+  "Use the rich editor for headings, lists, tables, links, images, media, and everyday formatting. Switch to raw Markdown for exact control. Add themes, transform styles, and squiggly-square section annotations when a passage deserves its own visual treatment. The readable `.md` source stays at the center of the workflow.",
+  "",
+  "## Preview the finished idea before you export it {[list]}",
+  "",
+  "- **Document** \u2014 Read the work as a polished, continuous document.",
+  "- **Page** \u2014 See how it behaves as a web page.",
+  "- **Slideshow** \u2014 Step through headings as designed presentation blocks.",
+  "- **Video** \u2014 Rehearse timing, motion, narration, and media in a player-ready view.",
+  "",
+  '## Local or installed: choose the workspace that fits {[twoColumn header="Work where your files make sense" left="Web|Browser-local workspaces or folders you explicitly grant" right="Desktop|Real folders, native menus, file opening, and updates"]}',
+  "",
+  '## In the project or in the pipeline {[twoColumn header="The same Markdown keeps moving" left="VS Code|Rich editing beside tabs, source control, and the project tree" right="CLI + MCP|Build, serve, convert, render, inspect, validate, and automate"]}',
+  "",
+  "## The quiet conveniences are there, too {[list]}",
+  "",
+  "- **Workspaces and file navigation** keep related documents organized without hiding their source.",
+  "- **Automatic saving** protects the active revision while still surfacing conflicts or save errors.",
+  "- **Optional version history** keeps plain sibling revisions when you want a trail of changes.",
+  "- **Copy-by-link sharing** creates a bounded Markdown copy that can open directly in a chosen Play view.",
+  "- **Offline-ready, local-first storage** keeps browser work on this device and native work inside folders you choose.",
+  "",
+  "## Export without rebuilding the document {[list]}",
+  "",
+  "- Create **Word documents and PDFs** for review, printing, and fixed-layout sharing.",
+  "- 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 can inspect, validate, preview, compare, and convert documents. Results remain temporary session artifacts until they are deliberately saved, and filesystem access begins with explicit roots rather than assumed authority.",
+  "",
+  "## Start with three small moves {[list]}",
+  "",
+  "1. Create a document with **New file** in the file pane.",
+  "2. Write visually or in Markdown source; switch views whenever it helps.",
+  "3. Open **Play** or **Export** when the idea is ready to become something else.",
+  "",
+  "## Explore DocBlocks {[list]}",
+  "",
+  "- [Desktop app](https://docblocks.com/desktop/) \u2014 macOS, Windows, and Linux.",
+  "- [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 guides for using and extending DocBlocks."
+].join("\n");
+
 // src/DocBlocksShell/DocBlocksShell.tsx
 import { Fragment as Fragment7, jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 var editorShellModulePromise = null;
@@ -3870,7 +4040,7 @@ function DocBlocksShell({
     saveThemePreference(pref);
   }, []);
   useEffect14(() => {
-    if (isElectronHost2() || typeof document === "undefined") return;
+    if (isElectronHost3() || typeof document === "undefined") return;
     const metas = document.querySelectorAll('meta[name="theme-color"]');
     metas.forEach((meta) => {
       meta.content = DB_CHROME_COLORS[resolvedTheme];
@@ -3899,8 +4069,8 @@ function DocBlocksShell({
   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 showBrowserStorageWarning = !isElectronHost3();
+  const appVersion = isElectronHost3() ? `${getDocBlocksHost().env.appVersion} desktop` : issueReportVersion ?? "web";
   const issueReportUrl = buildIssueReportUrl({
     reportedAt: /* @__PURE__ */ new Date(),
     version: appVersion,
@@ -4014,7 +4184,7 @@ function DocBlocksShell({
       return;
     }
     let cancelled = false;
-    const electron = isElectronHost2();
+    const electron = isElectronHost3();
     void listWorkspaces2().then((workspaces) => {
       if (cancelled) return;
       setTransientMoveDestinations(
@@ -4057,7 +4227,7 @@ function DocBlocksShell({
   const [selectedFile, setSelectedFile] = useState14(null);
   useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath);
   const exportDestinationAdapter = useMemo3(() => {
-    if (!isElectronHost2() || !activeWorkspaceId || !selectedFile) return void 0;
+    if (!isElectronHost3() || !activeWorkspaceId || !selectedFile) return void 0;
     const documentId = JSON.stringify([activeWorkspaceId, selectedFile]);
     const host = getDocBlocksHost().exports;
     return {
@@ -4098,7 +4268,7 @@ function DocBlocksShell({
       const baseTarget = createFileSystemDocumentTarget(fsProvider, filePath);
       const originKind = transient?.descriptor.origin?.kind;
       const needsElectronHost = originKind === "loose-file" || originKind === "dbk";
-      if (!transient?.descriptor.origin || needsElectronHost && !isElectronHost2()) {
+      if (!transient?.descriptor.origin || needsElectronHost && !isElectronHost3()) {
         return {
           key: baseTarget.key,
           async commit(request) {
@@ -4426,39 +4596,8 @@ function DocBlocksShell({
         return;
       }
       if (entries.length > 0) return;
-      const welcomePath = "/aboutDocBlocks.md";
-      const welcomeContent = [
-        "# DocBlocks: the local-first Markdown editor",
-        "",
-        "Your markdown can do anything.",
-        "",
-        "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** \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 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 with [squisq](https://github.com/bendyline/squisq) by [Bendyline](https://bendyline.com).",
-        "",
-        "## Explore DocBlocks",
-        "",
-        "- [Desktop app](https://docblocks.com/desktop/) for macOS, Windows, and Linux",
-        "- [VS Code extension](https://docblocks.com/vscode/) for rich editing inside your workspace",
-        "- [CLI and MCP server](https://docblocks.com/cli/) for conversion and agent workflows",
-        "- [Supported formats](https://docblocks.com/formats/) and [documentation](https://docblocks.com/docs/)"
-      ].join("\n");
+      const welcomePath = WELCOME_DOCUMENT_PATH;
+      const welcomeContent = WELCOME_DOCUMENT_CONTENT;
       let seededContent = welcomeContent;
       try {
         await writeProviderText(fs, welcomePath, welcomeContent, "create");
@@ -4510,7 +4649,7 @@ function DocBlocksShell({
     let cancelled = false;
     const isCurrent = () => !cancelled && requestId === navigationRequestRef.current;
     void (async () => {
-      const electron = isElectronHost2();
+      const electron = isElectronHost3();
       let workspaceIdRemap = {};
       if (electron) {
         try {
@@ -4758,7 +4897,7 @@ function DocBlocksShell({
     };
   }, [showBrowserStorageWarning]);
   useEffect14(() => {
-    if (isElectronHost2() || typeof window === "undefined") return;
+    if (isElectronHost3() || typeof window === "undefined") return;
     const onBeforeInstallPrompt = (e) => {
       e.preventDefault();
       setInstallPromptEvent(e);
@@ -5047,7 +5186,7 @@ function DocBlocksShell({
     };
   }, [documentSession, documentSnapshot.status, documentSnapshot.targetKey]);
   useEffect14(() => {
-    if (!isElectronHost2()) return;
+    if (!isElectronHost3()) return;
     const lifecycle = getDocBlocksHost().lifecycle;
     const stopPrepare = lifecycle.onPrepareClose(async (request) => {
       preparedCloseRequestRef.current = request.requestId;
@@ -5177,7 +5316,7 @@ function DocBlocksShell({
         void touchWorkspace2(destination.id).catch(() => void 0);
         if (sourceTargetKey) pendingDbkConflictsRef.current.delete(sourceTargetKey);
         const origin = transient.descriptor.origin;
-        if (isElectronHost2() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
+        if (isElectronHost3() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
           try {
             await getDocBlocksHost().external.revoke(origin.resourceId);
           } catch {
@@ -5214,7 +5353,7 @@ function DocBlocksShell({
   const handleOpenFolder = useCallback14(async () => {
     const requestId = ++navigationRequestRef.current;
     try {
-      if (isElectronHost2()) {
+      if (isElectronHost3()) {
         const info = await getDocBlocksHost().workspaces.pickFolder();
         if (!info) return;
         if (requestId !== navigationRequestRef.current) return;
@@ -5415,14 +5554,14 @@ function DocBlocksShell({
     void handleNewFile();
   }, [provider, handleNewFile]);
   const handleRevealWorkspace = useCallback14(async () => {
-    if (!isElectronHost2() || !activeWorkspaceId) return;
+    if (!isElectronHost3() || !activeWorkspaceId) return;
     const ws = await getWorkspace(activeWorkspaceId);
     if (ws?.type === "electron-native" && ws.rootPath) {
       await getDocBlocksHost().shell.revealInFolder(ws.id);
     }
   }, [activeWorkspaceId]);
   useEffect14(() => {
-    if (!isElectronHost2()) return;
+    if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onMenuCommand((cmd) => {
       switch (cmd) {
@@ -5542,6 +5681,56 @@ function DocBlocksShell({
       showToast
     ]
   );
+  const handleEditorLinkClick = useCallback14(
+    (href) => {
+      const target = resolveShellEditorLinkTarget(href, selectedFile);
+      if (!target) {
+        showToast(
+          "error",
+          "DocBlocks only opens HTTP(S) links or Markdown files inside this workspace."
+        );
+        return true;
+      }
+      if (target.kind === "fragment") return false;
+      if (target.kind === "external") {
+        if (isElectronHost3()) {
+          void getDocBlocksHost().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."
+            );
+          }
+        }
+        return true;
+      }
+      void (async () => {
+        if (!provider) return;
+        try {
+          if (!await providerEntryExists(provider, target.path)) {
+            showToast("error", "The linked Markdown file was not found in this workspace.");
+            return;
+          }
+          await handleSelect(target.path, "file");
+        } catch (error) {
+          showToast(
+            "error",
+            error instanceof Error ? error.message : "Could not open the linked Markdown file."
+          );
+        }
+      })();
+      return true;
+    },
+    [handleSelect, provider, selectedFile, showToast]
+  );
   const handleTreeMutation = useCallback14(
     async (change, mutate) => {
       if (!provider || !activeWorkspaceId || !selectedFile) {
@@ -5741,7 +5930,7 @@ function DocBlocksShell({
     [adoptTransientWorkspace]
   );
   useEffect14(() => {
-    if (!isElectronHost2()) return;
+    if (!isElectronHost3()) return;
     const host = getDocBlocksHost();
     return host.onOpenRequest((req) => {
       const requestId = ++navigationRequestRef.current;
@@ -5807,7 +5996,7 @@ function DocBlocksShell({
     [adoptTransientWorkspace]
   );
   useEffect14(() => {
-    if (isElectronHost2() || typeof window === "undefined") return;
+    if (isElectronHost3() || typeof window === "undefined") return;
     const launchQueue = window.launchQueue;
     if (!launchQueue) return;
     launchQueue.setConsumer((params) => {
@@ -5852,7 +6041,7 @@ function DocBlocksShell({
         import("@bendyline/squisq/storage"),
         import("@bendyline/squisq-formats/container")
       ]);
-      const electron = isElectronHost2();
+      const electron = isElectronHost3();
       const all = await listWorkspaces2();
       const candidates = all.filter(
         (w) => electron ? w.type === "electron-native" || w.type === "transient" : w.type !== "electron-native"
@@ -5994,7 +6183,7 @@ function DocBlocksShell({
       }
     } else if (ws?.type === "transient") {
       const origin = ws.origin;
-      if (isElectronHost2() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
+      if (isElectronHost3() && origin && (origin.kind === "loose-file" || origin.kind === "dbk")) {
         try {
           await getDocBlocksHost().external.revoke(origin.resourceId);
         } catch {
@@ -6007,7 +6196,7 @@ function DocBlocksShell({
     }
     await removeWorkspace(activeWorkspaceId);
     if (requestId !== navigationRequestRef.current) return;
-    const electron = isElectronHost2();
+    const electron = isElectronHost3();
     const remaining = (await listWorkspaces2()).filter(
       (w) => electron ? w.type === "electron-native" : w.type !== "electron-native"
     );
@@ -6268,6 +6457,7 @@ function DocBlocksShell({
                           articleId: selectedFile,
                           fileName: selectedFile,
                           onChange: handleEditorChange,
+                          onLinkClick: handleEditorLinkClick,
                           colorScheme: resolvedTheme,
                           writeCanvasSettings,
                           height: "100%",
@@ -6382,7 +6572,7 @@ function DocBlocksShell({
                           children: "New folder"
                         }
                       ),
-                      (isElectronHost2() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx12(
+                      (isElectronHost3() || typeof globalThis.showDirectoryPicker === "function") && /* @__PURE__ */ jsx12(
                         "button",
                         {
                           type: "button",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks-react",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "React components for DocBlocks — file explorer, workspace picker, and editor shell",
   "license": "MIT",
   "author": "Bendyline",
@@ -65,21 +65,21 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/docblocks": "2.2.0",
-    "@bendyline/squisq": "2.3.2",
-    "@bendyline/squisq-editor-react": "2.3.3",
-    "@bendyline/squisq-formats": "2.3.2",
-    "@bendyline/squisq-react": "2.3.2",
-    "@bendyline/squisq-video": "2.2.2",
-    "@bendyline/squisq-video-react": "2.2.2"
+    "@bendyline/docblocks": "2.2.1",
+    "@bendyline/squisq": "2.3.3",
+    "@bendyline/squisq-editor-react": "2.3.4",
+    "@bendyline/squisq-formats": "2.3.3",
+    "@bendyline/squisq-react": "2.3.3",
+    "@bendyline/squisq-video": "2.2.3",
+    "@bendyline/squisq-video-react": "2.2.3"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "20.9.0",
     "@types/react": "18.3.28",
     "@types/react-dom": "18.3.7",
     "happy-dom": "20.9.0",
-    "monaco-editor": "0.50.0",
     "mocha": "11.3.0",
+    "monaco-editor": "0.50.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "tsup": "8.5.1",

package/src/styles/docblocks.css

@@ -1600,6 +1600,21 @@ body.db-resizing-sidebar * {
   gap: 6px;
 }
 
+.db-about-beta {
+  margin-bottom: 10px;
+  padding: 10px 12px;
+  border: 1px solid var(--db-accent);
+  border-radius: 6px;
+  background: var(--db-accent-soft-08);
+  color: var(--db-text-secondary);
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.db-about-beta strong {
+  color: var(--db-accent-deep);
+}
+
 .db-about-version {
   display: flex;
   align-items: center;
@@ -4335,24 +4350,26 @@ html:has(.db-shell[data-theme='dark'])
   box-shadow: 0 2px 8px var(--db-shadow);
 }
 
-/* The expanded Reload/Later prompt uses the same top-center card pattern as
-   the document-conflict card, accent-toned instead of warning. */
+/* The expanded Reload/Later prompt sits just above its status-bar trigger. */
 .db-update-banner {
-  position: fixed;
-  top: 16px;
-  left: 50%;
+  position: absolute;
+  right: 8px;
+  bottom: 30px;
   z-index: 210;
   display: flex;
   gap: 16px;
   align-items: center;
-  max-width: min(720px, calc(100vw - 32px));
+  max-width: min(720px, calc(100% - 16px));
   padding: 10px 12px;
   color: var(--db-text);
   background: var(--db-bg-elevated, var(--db-bg));
   border: 1px solid var(--db-accent);
   border-radius: 8px;
   box-shadow: 0 6px 20px var(--db-shadow);
-  transform: translateX(-50%);
+}
+
+.db-update-banner--floating {
+  bottom: 48px;
 }
 
 .db-update-banner-actions {
@@ -5033,15 +5050,15 @@ button.db-git-file-row:hover {
     padding-bottom: 2px;
   }
 
-  /* The native 32px caption band leaves the labels slightly above its visual
-     center. Move only the text down; the tab hit area and active underline
-     stay anchored to the titlebar edges. */
+  /* Keep the compact labels on the same visual center as the action glyphs.
+     Move only the text; the tab hit area and active underline stay anchored
+     to the titlebar edges. */
   .db-shell .squisq-toolbar-view-tab-label {
-    transform: translateY(4px);
+    transform: translateY(1px);
   }
 
   .db-shell .squisq-use-mode-trigger {
-    padding-bottom: 7px;
+    padding-bottom: 10px;
   }
 
   /* The 32px caption row leaves little room around Squisq's 28px action