@bendyline/docblocks-react 2.7.6 → 2.7.8

package/dist/{chunk-VJPGZCFS.js → chunk-UYJCL6OW.js}

@@ -19,6 +19,7 @@ function dismissTopmostDialog() {
 
 // src/components/Dialog.tsx
 import { useCallback, useEffect, useId, useRef } from "react";
+import { createPortal } from "react-dom";
 import { jsx, jsxs } from "react/jsx-runtime";
 function Dialog({
   title,
@@ -57,7 +58,7 @@ function Dialog({
       const dialog = dialogRef.current;
       if (!dialog) return;
       const focusable = [...dialog.querySelectorAll(FOCUSABLE_SELECTOR)].filter(
-        (element) => !element.hasAttribute("disabled") && element.getAttribute("aria-hidden") !== "true"
+        (element) => !element.hasAttribute("disabled") && element.getAttribute("aria-hidden") !== "true" && element.closest("[hidden]") === null
       );
       if (focusable.length === 0) {
         e.preventDefault();
@@ -96,7 +97,7 @@ function Dialog({
   const bodyClasses = ["db-dialog-body", bodyClassName].filter(Boolean).join(" ");
   const footerClasses = ["db-dialog-footer", footerClassName].filter(Boolean).join(" ");
   const overlayClassName = placement === "top" ? "db-dialog-overlay db-dialog-overlay--top" : "db-dialog-overlay";
-  return /* @__PURE__ */ jsx("div", { className: overlayClassName, onClick: handleBackdropClick, children: /* @__PURE__ */ jsxs(
+  const overlay = /* @__PURE__ */ jsx("div", { className: overlayClassName, onClick: handleBackdropClick, children: /* @__PURE__ */ jsxs(
     "div",
     {
       ref: dialogRef,
@@ -128,6 +129,7 @@ function Dialog({
       ]
     }
   ) });
+  return typeof document === "undefined" ? overlay : createPortal(overlay, document.body);
 }
 var FOCUSABLE_SELECTOR = [
   "a[href]",

package/dist/{chunk-GFK4TCKN.js → chunk-WDNE5TI3.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-6MSHXQNB.js";
 import {
   Dialog
-} from "./chunk-VJPGZCFS.js";
+} from "./chunk-UYJCL6OW.js";
 
 // src/Export/ExportDialog.tsx
 import { useState, useCallback, useEffect, useMemo } from "react";
@@ -84,6 +84,7 @@ function ExportDialog({
   documentThemes,
   exporting,
   error,
+  errorAction,
   destination,
   openAfterSave,
   onExport,
@@ -343,13 +344,26 @@ function ExportDialog({
             }
           )
         ] }),
-        /* @__PURE__ */ jsxs("p", { className: "db-export-more-formats", children: [
-          "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" }),
-          "."
+        /* @__PURE__ */ jsxs("details", { className: "db-export-more-formats", children: [
+          /* @__PURE__ */ jsx("summary", { children: "More formats and automation" }),
+          /* @__PURE__ */ jsxs("p", { children: [
+            "Need spreadsheets, portable bundles, or batch exports?",
+            " ",
+            /* @__PURE__ */ jsx("a", { href: "https://docblocks.com/cli/", target: "_blank", rel: "noopener noreferrer", children: "Explore the DocBlocks CLI" }),
+            "."
+          ] })
         ] }),
-        error && /* @__PURE__ */ jsx("p", { className: "db-export-error", role: "alert", children: error })
+        error && /* @__PURE__ */ jsx("p", { className: "db-export-error", role: "alert", children: error }),
+        error && errorAction && /* @__PURE__ */ jsx("div", { className: "db-export-error-action", children: /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "db-export-btn db-export-btn--secondary",
+            onClick: errorAction.onClick,
+            disabled: exporting,
+            children: errorAction.label
+          }
+        ) })
       ]
     }
   );

package/dist/{chunk-KBUHWZCF.js → chunk-YX275NPE.js}

@@ -1,6 +1,6 @@
 import {
   Dialog
-} from "./chunk-VJPGZCFS.js";
+} from "./chunk-UYJCL6OW.js";
 
 // src/components/useConfirmDialog.ts
 import React2, { useCallback as useCallback2, useEffect, useRef as useRef2, useState } from "react";

package/dist/editor.js

@@ -13,10 +13,10 @@ import {
 } from "./chunk-ACQF63SB.js";
 import {
   PresentationMaker
-} from "./chunk-PRUEYW3G.js";
-import "./chunk-T42BH6YX.js";
+} from "./chunk-BGA5UVKL.js";
+import "./chunk-CXLXGFG2.js";
 import "./chunk-K4I3NJFL.js";
-import "./chunk-VJPGZCFS.js";
+import "./chunk-UYJCL6OW.js";
 export {
   EMPTY_DOCUMENT_PROMPTS,
   FindButton,

package/dist/export/index.d.ts

@@ -1,168 +1,22 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as _bendyline_squisq_formats_pptx from '@bendyline/squisq-formats/pptx';
-import { ContentContainer } from '@bendyline/squisq/storage';
-import { DiagramRasterizer } from '@bendyline/squisq-formats/diagrams';
+export { I as CoverImageSaveAdapter, a as CoverImageSaveOutput, D as DEFAULT_OPTIONS, I as DashboardImageSaveAdapter, a as DashboardImageSaveOutput, j as ExportBehavior, E as ExportBlobSaver, k as ExportConverterOverrides, b as ExportDestinationControl, c as ExportDialog, d as ExportDialogProps, m as ExportErrorAction, e as ExportFormat, f as ExportOptions, n as ExportResult, F as FORMAT_EXTENSIONS, o as FORMAT_LABELS, H as HtmlBundle, g as HtmlStyle, I as ImageSaveAdapter, a as ImageSaveOutput, h as buildExportFilename, i as createCoverImageSaveOutput, i as createDashboardImageSaveOutput, i as createImageSaveOutput, l as loadLastExportOptions, p as resolveExportDialogInitial, r as runExport, s as saveExportOptions, u as updateExportTargetExtension } from '../image-save-D18dJrUr.js';
+import '@bendyline/squisq-formats/pptx';
+import '@bendyline/squisq/storage';
+import '@bendyline/squisq-formats/diagrams';
+import 'react/jsx-runtime';
 
 /**
- * Export option types and localStorage persistence for quick-export.
- */
-type ExportFormat = 'docx' | 'pdf' | 'pptx' | 'epub' | 'md' | 'html';
-/** Visual style for HTML export. */
-type HtmlStyle = 
-/** Render via SquisqPlayer (themed, embeds player bundle). */
-'rendered'
-/** Plain semantic HTML — small, no JS, no playback. */
- | 'plain';
-/** Packaging for HTML export. */
-type HtmlBundle = 
-/** Single self-contained .html file (images base64-embedded). */
-'single'
-/** ZIP containing index.html + asset files. */
- | 'zip';
-interface ExportOptions {
-    format: ExportFormat;
-    themeId: string;
-    /** Transform style for PPTX; an empty string explicitly disables transforms. */
-    transformStyle: string;
-    /** Only applies to PDF */
-    pageSize: 'letter' | 'a4';
-    /** HTML rendering style. Only applies to format=html. */
-    htmlStyle: HtmlStyle;
-    /** HTML bundle layout. Only applies to format=html. */
-    htmlBundle: HtmlBundle;
-    /**
-     * Recursive HTML bundle: walk relative `.md` links from the entry
-     * document, render every reachable sibling/child page, and rewrite
-     * cross-doc links from `.md` → `.html`. The output is a ZIP
-     * regardless of `htmlBundle` because multi-doc output needs a
-     * directory tree. Supported for both plain (`markdownDocsToPlainHtmlBundle`)
-     * and rendered (`markdownDocsToHtmlBundle`) HTML styles. Only
-     * meaningful when `format === 'html'`.
-     */
-    includeLinkedDocs: boolean;
-    /**
-     * Rename the entry page from `<basename>.html` to `index.html` so the
-     * export drops straight into a static-site host that expects an
-     * `index.html` landing page. For recursive bundles, cross-doc links
-     * targeting the entry also rewrite to `index.html` so siblings don't
-     * 404. For a single-doc HTML download, this just renames the file.
-     * Only meaningful when `format === 'html'`.
-     */
-    entryAsIndex: boolean;
-}
-declare const FORMAT_LABELS: Record<ExportFormat, string>;
-declare const FORMAT_EXTENSIONS: Record<ExportFormat, string>;
-declare const DEFAULT_OPTIONS: ExportOptions;
-/**
- * Options that populate the export dialog: the user's last-chosen options
- * (else the built-in defaults) for format, page size and the rest, but always
- * the theme the editor previews this document in -- its own theme, else the
- * workspace default, else Standard. The last export's theme belonged to some
- * other document; carrying it over made the export differ from the preview.
- */
-declare function resolveExportDialogInitial(lastOptions: ExportOptions | null, docThemeId: string | null | undefined, workspaceThemeId?: string | null): ExportOptions;
-/** A theme as the export dialog's Theme select lists it. */
-interface ExportThemeSummary {
-    id: string;
-    name: string;
-    description?: string;
-}
-declare function loadLastExportOptions(): ExportOptions | null;
-declare function saveExportOptions(options: ExportOptions): void;
-
-declare function buildExportFilename(selectedFile: string | null, options: ExportOptions): string;
-
-type ExportBlobSaver = (blob: Blob, filename: string) => Promise<void> | void;
-/** Host-provided converters that must be loaded before an export begins. */
-interface ExportConverterOverrides {
-    docToPptx?: (typeof _bendyline_squisq_formats_pptx)['docToPptx'];
-    /**
-     * Draws diagrams as pictures. Defaults to Squisq's browser renderer; tests
-     * pass a stand-in because drawing needs a real canvas.
-     */
-    diagramRenderer?: DiagramRasterizer;
-}
-/** What an export reports beyond the saved file. */
-interface ExportResult {
-    /**
-     * What the user should know about the file that was saved, such as
-     * characters PDF export had to replace. Empty when nothing was lost.
-     */
-    readonly warnings: readonly string[];
-}
-/** Run the export and trigger a download. */
-declare function runExport(markdown: string, selectedFile: string | null, options: ExportOptions, mediaContainer?: ContentContainer | null, saveBlob?: ExportBlobSaver, converterOverrides?: ExportConverterOverrides): Promise<ExportResult>;
-
-interface OpenAfterSaveControl {
-    checked: boolean;
-    onChange: (checked: boolean) => void;
-}
-
-interface ExportDialogProps {
-    /** Initial options (pre-populated from last export). */
-    initial: ExportOptions;
-    /**
-     * Themes the document defines in its own frontmatter. Listed ahead of the
-     * built-ins so a document using one exports in the theme it previews in.
-     */
-    documentThemes?: readonly ExportThemeSummary[];
-    /** Whether the export is currently running. */
-    exporting: boolean;
-    /**
-     * Message from a failed export attempt. Rendered in the dialog, which
-     * stays open so the user can adjust options and retry — a failure must
-     * never look like a success.
-     */
-    error?: string | null;
-    /** Optional host-provided destination path control. */
-    destination?: ExportDestinationControl;
-    /** Present only when the host can open saved exports. */
-    openAfterSave?: OpenAfterSaveControl;
-    /** Called when the user confirms the export. */
-    onExport: (options: ExportOptions) => void;
-    /** Called whenever the currently selected options change. */
-    onOptionsChange?: (options: ExportOptions) => void;
-    /** Host-aware label for the final save action. Defaults to "Export". */
-    actionLabel?: (options: ExportOptions) => string;
-    /** Called when the dialog is dismissed. */
-    onClose: () => void;
-}
-interface ExportDestinationControl {
-    value: string;
-    /** Enables host-validated edits. Omit to render the destination as read-only. */
-    onChange?: (value: string, options: ExportOptions) => void;
-    onPick: (options: ExportOptions) => void | Promise<void>;
-    hint?: string;
-    /** A host-supplied validation error for the current destination value. */
-    error?: string | null;
-}
-declare function ExportDialog({ initial, documentThemes, exporting, error, destination, openAfterSave, onExport, onOptionsChange, actionLabel, 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;
-
-/**
- * Host persistence for Squisq's rendered-output exporters.
+ * PDF export stopped before anything was saved because the PDF fonts would
+ * replace some of the document's characters (CJK text and most emoji). The
+ * user can save it anyway with the replacements, or pick a format that keeps
+ * every character.
  *
- * Squisq renders the cover image, the Dashboard image, and exported video in
- * the browser and hands the host a finished blob; DocBlocks owns where that
- * blob lands. The exporters share one save-output contract upstream
- * (`DashboardImageSaveOutput` is an alias of `CoverImageSaveOutput`, and the
- * video dialog's `saveOutput` has the same shape), so they share one adapter
- * here rather than identical copies.
+ * Kept out of `run-export.ts` so the export controls can recognise it without
+ * loading the export pipeline.
  */
-/** Host persistence shape required by the editor's rendered-output exporters. */
-interface ImageSaveAdapter<TTarget> {
-    pickTarget(filename: string, currentTarget?: TTarget | null): Promise<TTarget | null>;
-    saveBlob(blob: Blob, filename: string, target?: TTarget | null): Promise<TTarget | null>;
+declare class PdfReplacementsError extends Error {
+    /** Squisq's account of what would be replaced, for the message. */
+    readonly replacements: readonly string[];
+    constructor(replacements: readonly string[]);
 }
-type ImageSaveOutput = (blob: Blob, filename: string) => Promise<boolean | void>;
-/**
- * Adapt DocBlocks' two-step host destination flow to Squisq's rendered output
- * callback. The picker stays host-owned, and cancellation is reported as
- * `false` so the export dialog remains open without showing an error. Squisq
- * shows a failure's message verbatim, so it arrives without IPC internals.
- */
-declare function createImageSaveOutput<TTarget>(adapter: ImageSaveAdapter<TTarget>): ImageSaveOutput;
 
-export { type ImageSaveAdapter as CoverImageSaveAdapter, type ImageSaveOutput as CoverImageSaveOutput, DEFAULT_OPTIONS, type ImageSaveAdapter as DashboardImageSaveAdapter, type ImageSaveOutput as DashboardImageSaveOutput, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, type ExportResult, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, type ImageSaveAdapter, type ImageSaveOutput, buildExportFilename, createImageSaveOutput as createCoverImageSaveOutput, createImageSaveOutput as createDashboardImageSaveOutput, createImageSaveOutput, loadLastExportOptions, resolveExportDialogInitial, runExport, saveExportOptions, updateExportTargetExtension };
+export { PdfReplacementsError };

package/dist/export/index.js

@@ -3,16 +3,17 @@ import {
 } from "../chunk-KWG6UP5O.js";
 import {
   runExport
-} from "../chunk-7CSBRAMT.js";
+} from "../chunk-F7TR5EKX.js";
 import {
   createImageSaveOutput
 } from "../chunk-UONFWKJ7.js";
 import {
+  PdfReplacementsError,
   buildExportFilename
-} from "../chunk-5O5YTOXG.js";
+} from "../chunk-5YMULR6A.js";
 import {
   ExportDialog
-} from "../chunk-GFK4TCKN.js";
+} from "../chunk-WDNE5TI3.js";
 import "../chunk-H3BK5MK6.js";
 import {
   DEFAULT_OPTIONS,
@@ -22,12 +23,13 @@ import {
   resolveExportDialogInitial,
   saveExportOptions
 } from "../chunk-6MSHXQNB.js";
-import "../chunk-VJPGZCFS.js";
+import "../chunk-UYJCL6OW.js";
 export {
   DEFAULT_OPTIONS,
   ExportDialog,
   FORMAT_EXTENSIONS,
   FORMAT_LABELS,
+  PdfReplacementsError,
   buildExportFilename,
   createImageSaveOutput as createCoverImageSaveOutput,
   createImageSaveOutput as createDashboardImageSaveOutput,

package/dist/image-save-D18dJrUr.d.ts

@@ -0,0 +1,182 @@
+import * as _bendyline_squisq_formats_pptx from '@bendyline/squisq-formats/pptx';
+import { ContentContainer } from '@bendyline/squisq/storage';
+import { DiagramRasterizer } from '@bendyline/squisq-formats/diagrams';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Export option types and localStorage persistence for quick-export.
+ */
+type ExportFormat = 'docx' | 'pdf' | 'pptx' | 'epub' | 'md' | 'html';
+/** Visual style for HTML export. */
+type HtmlStyle = 
+/** Render via SquisqPlayer (themed, embeds player bundle). */
+'rendered'
+/** Plain semantic HTML — small, no JS, no playback. */
+ | 'plain';
+/** Packaging for HTML export. */
+type HtmlBundle = 
+/** Single self-contained .html file (images base64-embedded). */
+'single'
+/** ZIP containing index.html + asset files. */
+ | 'zip';
+interface ExportOptions {
+    format: ExportFormat;
+    themeId: string;
+    /** Transform style for PPTX; an empty string explicitly disables transforms. */
+    transformStyle: string;
+    /** Only applies to PDF */
+    pageSize: 'letter' | 'a4';
+    /** HTML rendering style. Only applies to format=html. */
+    htmlStyle: HtmlStyle;
+    /** HTML bundle layout. Only applies to format=html. */
+    htmlBundle: HtmlBundle;
+    /**
+     * Recursive HTML bundle: walk relative `.md` links from the entry
+     * document, render every reachable sibling/child page, and rewrite
+     * cross-doc links from `.md` → `.html`. The output is a ZIP
+     * regardless of `htmlBundle` because multi-doc output needs a
+     * directory tree. Supported for both plain (`markdownDocsToPlainHtmlBundle`)
+     * and rendered (`markdownDocsToHtmlBundle`) HTML styles. Only
+     * meaningful when `format === 'html'`.
+     */
+    includeLinkedDocs: boolean;
+    /**
+     * Rename the entry page from `<basename>.html` to `index.html` so the
+     * export drops straight into a static-site host that expects an
+     * `index.html` landing page. For recursive bundles, cross-doc links
+     * targeting the entry also rewrite to `index.html` so siblings don't
+     * 404. For a single-doc HTML download, this just renames the file.
+     * Only meaningful when `format === 'html'`.
+     */
+    entryAsIndex: boolean;
+}
+declare const FORMAT_LABELS: Record<ExportFormat, string>;
+declare const FORMAT_EXTENSIONS: Record<ExportFormat, string>;
+declare const DEFAULT_OPTIONS: ExportOptions;
+/**
+ * Options that populate the export dialog: the user's last-chosen options
+ * (else the built-in defaults) for format, page size and the rest, but always
+ * the theme the editor previews this document in -- its own theme, else the
+ * workspace default, else Standard. The last export's theme belonged to some
+ * other document; carrying it over made the export differ from the preview.
+ */
+declare function resolveExportDialogInitial(lastOptions: ExportOptions | null, docThemeId: string | null | undefined, workspaceThemeId?: string | null): ExportOptions;
+/** A theme as the export dialog's Theme select lists it. */
+interface ExportThemeSummary {
+    id: string;
+    name: string;
+    description?: string;
+}
+declare function loadLastExportOptions(): ExportOptions | null;
+declare function saveExportOptions(options: ExportOptions): void;
+
+declare function buildExportFilename(selectedFile: string | null, options: ExportOptions): string;
+
+type ExportBlobSaver = (blob: Blob, filename: string) => Promise<void> | void;
+/** Host-provided converters that must be loaded before an export begins. */
+interface ExportConverterOverrides {
+    docToPptx?: (typeof _bendyline_squisq_formats_pptx)['docToPptx'];
+    /**
+     * Draws diagrams as pictures. Defaults to Squisq's browser renderer; tests
+     * pass a stand-in because drawing needs a real canvas.
+     */
+    diagramRenderer?: DiagramRasterizer;
+}
+/** What an export reports beyond the saved file. */
+interface ExportResult {
+    /**
+     * What the user should know about the file that was saved, such as
+     * characters PDF export had to replace. Empty when nothing was lost.
+     */
+    readonly warnings: readonly string[];
+}
+/** Choices the user made for this one export, as opposed to its saved options. */
+interface ExportBehavior {
+    /**
+     * Save a PDF even though its fonts replace some characters. Without it,
+     * such an export throws `PdfReplacementsError` before saving anything.
+     */
+    allowPdfReplacements?: boolean;
+}
+/** Run the export and trigger a download. */
+declare function runExport(markdown: string, selectedFile: string | null, options: ExportOptions, mediaContainer?: ContentContainer | null, saveBlob?: ExportBlobSaver, converterOverrides?: ExportConverterOverrides, behavior?: ExportBehavior): Promise<ExportResult>;
+
+interface OpenAfterSaveControl {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+
+interface ExportDialogProps {
+    /** Initial options (pre-populated from last export). */
+    initial: ExportOptions;
+    /**
+     * Themes the document defines in its own frontmatter. Listed ahead of the
+     * built-ins so a document using one exports in the theme it previews in.
+     */
+    documentThemes?: readonly ExportThemeSummary[];
+    /** Whether the export is currently running. */
+    exporting: boolean;
+    /**
+     * Message from a failed export attempt. Rendered in the dialog, which
+     * stays open so the user can adjust options and retry — a failure must
+     * never look like a success.
+     */
+    error?: string | null;
+    /** A way past the error, shown under it, such as saving a PDF with replacements. */
+    errorAction?: ExportErrorAction | null;
+    /** Optional host-provided destination path control. */
+    destination?: ExportDestinationControl;
+    /** Present only when the host can open saved exports. */
+    openAfterSave?: OpenAfterSaveControl;
+    /** Called when the user confirms the export. */
+    onExport: (options: ExportOptions) => void;
+    /** Called whenever the currently selected options change. */
+    onOptionsChange?: (options: ExportOptions) => void;
+    /** Host-aware label for the final save action. Defaults to "Export". */
+    actionLabel?: (options: ExportOptions) => string;
+    /** Called when the dialog is dismissed. */
+    onClose: () => void;
+}
+interface ExportErrorAction {
+    label: string;
+    onClick: () => void;
+}
+interface ExportDestinationControl {
+    value: string;
+    /** Enables host-validated edits. Omit to render the destination as read-only. */
+    onChange?: (value: string, options: ExportOptions) => void;
+    onPick: (options: ExportOptions) => void | Promise<void>;
+    hint?: string;
+    /** A host-supplied validation error for the current destination value. */
+    error?: string | null;
+}
+declare function ExportDialog({ initial, documentThemes, exporting, error, errorAction, destination, openAfterSave, onExport, onOptionsChange, actionLabel, 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;
+
+/**
+ * Host persistence for Squisq's rendered-output exporters.
+ *
+ * Squisq renders the cover image, the Dashboard image, and exported video in
+ * the browser and hands the host a finished blob; DocBlocks owns where that
+ * blob lands. The exporters share one save-output contract upstream
+ * (`DashboardImageSaveOutput` is an alias of `CoverImageSaveOutput`, and the
+ * video dialog's `saveOutput` has the same shape), so they share one adapter
+ * here rather than identical copies.
+ */
+/** Host persistence shape required by the editor's rendered-output exporters. */
+interface ImageSaveAdapter<TTarget> {
+    pickTarget(filename: string, currentTarget?: TTarget | null): Promise<TTarget | null>;
+    saveBlob(blob: Blob, filename: string, target?: TTarget | null): Promise<TTarget | null>;
+}
+type ImageSaveOutput = (blob: Blob, filename: string) => Promise<boolean | void>;
+/**
+ * Adapt DocBlocks' two-step host destination flow to Squisq's rendered output
+ * callback. The picker stays host-owned, and cancellation is reported as
+ * `false` so the export dialog remains open without showing an error. Squisq
+ * shows a failure's message verbatim, so it arrives without IPC internals.
+ */
+declare function createImageSaveOutput<TTarget>(adapter: ImageSaveAdapter<TTarget>): ImageSaveOutput;
+
+export { DEFAULT_OPTIONS as D, type ExportBlobSaver as E, FORMAT_EXTENSIONS as F, type HtmlBundle as H, type ImageSaveAdapter as I, type ImageSaveOutput as a, type ExportDestinationControl as b, ExportDialog as c, type ExportDialogProps as d, type ExportFormat as e, type ExportOptions as f, type HtmlStyle as g, buildExportFilename as h, createImageSaveOutput as i, type ExportBehavior as j, type ExportConverterOverrides as k, loadLastExportOptions as l, type ExportErrorAction as m, type ExportResult as n, FORMAT_LABELS as o, resolveExportDialogInitial as p, runExport as r, saveExportOptions as s, updateExportTargetExtension as u };

package/dist/index.d.ts

@@ -6,15 +6,15 @@ import { CodeBlockCopyHandler } from '@bendyline/squisq-react';
 import { FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 import { PrunePolicy, SaveVersionResult, DocumentVersionManager } from '@bendyline/squisq/versions';
 import { DocBlocksHostAiAPI, DocBlocksHostSpeechAPI, DocBlocksHostMenuAPI } from '@bendyline/docblocks/host';
-import { T as ThemePreference, A as AccentColor, I as InterfaceFontPreference, q as WriteCanvasPreferences, P as ProofingPreferences } from './Settings-CfhY489G.js';
-export { a as AccentColorSettings, b as AccentColorSettingsProps, c as AiSettingsControls, d as AiSettingsControlsProps, D as DEFAULT_INTERFACE_FONT, e as DEFAULT_PROOFING_PREFERENCES, f as DEFAULT_WRITE_CANVAS_FONT_SCHEME, g as InterfaceFontSettings, h as InterfaceFontSettingsProps, i as ProofingSettingsControls, j as ProofingSettingsControlsProps, S as SettingsDialog, k as SettingsDialogProps, l as ThemeSettings, m as ThemeSettingsProps, W as WRITE_CANVAS_FONT_SCHEMES, n as WriteCanvasFontScheme, o as WriteCanvasFontSchemeGroup, p as WriteCanvasFontSchemeOption, r as WriteCanvasSettingsControls, s as WriteCanvasSettingsControlsProps, t as loadInterfaceFont, u as loadProofingPreferences, v as resolveWriteCanvasFonts, w as saveInterfaceFont, x as saveProofingPreferences } from './Settings-CfhY489G.js';
+import { T as ThemePreference, A as AccentColor, I as InterfaceFontPreference, W as WriteCanvasPreferences, P as ProofingPreferences } from './Settings-ButIB78y.js';
+export { a as AccentColorSettings, b as AccentColorSettingsProps, c as AiSettingsControls, d as AiSettingsControlsProps, D as DEFAULT_INTERFACE_FONT, e as DEFAULT_PROOFING_PREFERENCES, f as DEFAULT_WRITE_CANVAS_FONT_SCHEME, g as InterfaceFontSettings, h as InterfaceFontSettingsProps, i as ProofingSettingsControls, j as ProofingSettingsControlsProps, S as SettingsDialog, k as SettingsDialogProps, l as SettingsSection, m as ThemeSettings, n as ThemeSettingsProps, o as WRITE_CANVAS_FONT_SCHEMES, p as WriteCanvasFontScheme, q as WriteCanvasFontSchemeGroup, r as WriteCanvasFontSchemeOption, s as WriteCanvasSettingsControls, t as WriteCanvasSettingsControlsProps, u as loadInterfaceFont, v as loadProofingPreferences, w as resolveWriteCanvasFonts, x as saveInterfaceFont, y as saveProofingPreferences } from './Settings-ButIB78y.js';
 import { SharedDocumentMode } from '@bendyline/docblocks/share';
 import { MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { VideoExportModalProps } from '@bendyline/squisq-video-react';
 import { MediaEditRenderManager } from '@bendyline/squisq-video-react/media-edit';
-import { ExportBlobSaver } from './export/index.js';
-export { CoverImageSaveAdapter, CoverImageSaveOutput, DEFAULT_OPTIONS, CoverImageSaveAdapter as DashboardImageSaveAdapter, CoverImageSaveOutput as DashboardImageSaveOutput, ExportDestinationControl, ExportDialog, ExportDialogProps, ExportFormat, ExportOptions, HtmlBundle, HtmlStyle, CoverImageSaveAdapter as ImageSaveAdapter, CoverImageSaveOutput as ImageSaveOutput, buildExportFilename, createCoverImageSaveOutput, createCoverImageSaveOutput as createDashboardImageSaveOutput, createCoverImageSaveOutput as createImageSaveOutput, loadLastExportOptions, runExport, updateExportTargetExtension } from './export/index.js';
+import { E as ExportBlobSaver } from './image-save-D18dJrUr.js';
+export { I as CoverImageSaveAdapter, a as CoverImageSaveOutput, D as DEFAULT_OPTIONS, I as DashboardImageSaveAdapter, a as DashboardImageSaveOutput, b as ExportDestinationControl, c as ExportDialog, d as ExportDialogProps, e as ExportFormat, f as ExportOptions, H as HtmlBundle, g as HtmlStyle, I as ImageSaveAdapter, a as ImageSaveOutput, h as buildExportFilename, i as createCoverImageSaveOutput, i as createDashboardImageSaveOutput, i as createImageSaveOutput, l as loadLastExportOptions, r as runExport, u as updateExportTargetExtension } from './image-save-D18dJrUr.js';
 import { DocumentSession, DocumentSessionSnapshot } from '@bendyline/docblocks/document';
 import 'react';
 import '@bendyline/squisq-formats/pptx';
@@ -443,6 +443,8 @@ declare function DocBlocksShell({ theme: hostTheme, logoUrl, logoDarkUrl, issueR
 
 type VersioningPreference = 'on' | 'browser-only' | 'off';
 
+type AppSettingsSection = 'appearance' | 'ai' | 'dictation' | 'narration' | 'device';
+
 interface AppMenuProps {
     /** Optional logo image URL to display instead of the text label. */
     logoUrl?: string;
@@ -497,9 +499,9 @@ interface AppMenuProps {
      */
     onInstallApp?: () => void | Promise<void>;
     /**
-     * Async origin storage usage/quota for the Settings "Storage" section
+     * Async origin storage usage/quota for the Settings "Storage" group
      * (fetched when the dialog opens). When omitted — Electron, or browsers
-     * without `navigator.storage.estimate` — the section is hidden.
+     * without `navigator.storage.estimate` — the group is hidden.
      */
     getStorageEstimate?: () => Promise<{
         usage: number;
@@ -520,19 +522,21 @@ interface AppMenuProps {
      */
     ai?: DocBlocksHostAiAPI;
     /**
-     * The host's speech API. When present, Settings offers a Speech section for
-     * dictation and narration models; when omitted the section is hidden.
+     * The host's speech API. When present, Settings offers Dictation and
+     * Narration sections for the engines it has; when omitted both are hidden.
      */
     speech?: DocBlocksHostSpeechAPI;
     /**
      * The host's menu API, when it offers the opt-in tray / menu bar icon
-     * (`hostSupports('trayIcon')`). When omitted the section is hidden.
+     * (`hostSupports('trayIcon')`). When omitted the setting is hidden.
      */
     tray?: DocBlocksHostMenuAPI;
     /** Opens Settings whenever it changes to a new non-zero value. */
     settingsRequest?: number;
+    /** The section `settingsRequest` opens on; otherwise the last one shown. */
+    settingsRequestSection?: AppSettingsSection;
 }
-declare function AppMenu({ logoUrl, logoDarkUrl, themePreference, onThemeChange, accentColor, onAccentColorChange, interfaceFont, onInterfaceFontChange, writeCanvasSettings, onWriteCanvasSettingsChange, proofingPreferences, onProofingPreferencesChange, versioningPreference, onVersioningPreferenceChange, onOpenWorkspaceSettings, onDownloadAllWorkspaces, onRestoreBackup, onShowKeyboardShortcuts, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, appVersion, appBuildDate, ai, speech, tray, settingsRequest, }: AppMenuProps): react_jsx_runtime.JSX.Element;
+declare function AppMenu({ logoUrl, logoDarkUrl, themePreference, onThemeChange, accentColor, onAccentColorChange, interfaceFont, onInterfaceFontChange, writeCanvasSettings, onWriteCanvasSettingsChange, proofingPreferences, onProofingPreferencesChange, versioningPreference, onVersioningPreferenceChange, onOpenWorkspaceSettings, onDownloadAllWorkspaces, onRestoreBackup, onShowKeyboardShortcuts, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, appVersion, appBuildDate, ai, speech, tray, settingsRequest, settingsRequestSection, }: AppMenuProps): react_jsx_runtime.JSX.Element;
 
 interface ExportToolbarControlsProps {
     /** Currently selected file path — used to derive the download filename. */
@@ -612,4 +616,4 @@ interface UseDocumentSessionResult {
  */
 declare function useDocumentSession(autoSaveDelayMs?: number): UseDocumentSessionResult;
 
-export { AccentColor, AppMenu, type AppMenuProps, DocBlocksShell, type DocBlocksShellProps, ExportBlobSaver, type ExportDestinationAdapter, type ExportDestinationTarget, ExportToolbarControls, type ExportToolbarControlsProps, FileExplorer, type FileExplorerProps, type FileExplorerSortMode, type FileTreeActions, type FileTreeChange, type FileTreeMutationHandler, FileTreeNode, type FileTreeNodeProps, type FileTreeReadIssue, type FileTreeState, InterfaceFontPreference, type NewFileFormat, ProofingPreferences, ThemePreference, type UseDocumentSessionResult, WorkspacePicker, type WorkspacePickerProps, WriteCanvasPreferences, useDocumentSession, useFileTree };
+export { AccentColor, AppMenu, type AppMenuProps, type AppSettingsSection, DocBlocksShell, type DocBlocksShellProps, ExportBlobSaver, type ExportDestinationAdapter, type ExportDestinationTarget, ExportToolbarControls, type ExportToolbarControlsProps, FileExplorer, type FileExplorerProps, type FileExplorerSortMode, type FileTreeActions, type FileTreeChange, type FileTreeMutationHandler, FileTreeNode, type FileTreeNodeProps, type FileTreeReadIssue, type FileTreeState, InterfaceFontPreference, type NewFileFormat, ProofingPreferences, ThemePreference, type UseDocumentSessionResult, WorkspacePicker, type WorkspacePickerProps, WriteCanvasPreferences, useDocumentSession, useFileTree };