@bendyline/docblocks-react 2.7.0 → 2.7.2

package/dist/export/index.d.ts

@@ -54,13 +54,19 @@ 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. Layered: built-in defaults → the
- * user's last-chosen options → the workspace default theme → the document's
- * own theme (wins). "Set a theme, then export" therefore pre-selects that
- * theme instead of whatever was picked for an unrelated previous document,
- * and documents without a theme export in their folder's default.
+ * 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;
 
@@ -82,6 +88,11 @@ declare function runExport(markdown: string, selectedFile: string | null, option
 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;
     /**
@@ -110,7 +121,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, actionLabel, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
+declare function ExportDialog({ initial, documentThemes, exporting, error, destination, 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;

package/dist/export/index.js

@@ -3,16 +3,16 @@ import {
 } from "../chunk-KWG6UP5O.js";
 import {
   runExport
-} from "../chunk-BCQZTWE5.js";
+} from "../chunk-HRWEGPTY.js";
 import {
   createImageSaveOutput
 } from "../chunk-UONFWKJ7.js";
 import {
   buildExportFilename
-} from "../chunk-UG4G7PJ4.js";
+} from "../chunk-5O5YTOXG.js";
 import {
   ExportDialog
-} from "../chunk-SGQKTKDX.js";
+} from "../chunk-Y5OE3HJC.js";
 import "../chunk-YBEYTVU2.js";
 import {
   DEFAULT_OPTIONS,
@@ -21,7 +21,7 @@ import {
   loadLastExportOptions,
   resolveExportDialogInitial,
   saveExportOptions
-} from "../chunk-X437UAF7.js";
+} from "../chunk-6MSHXQNB.js";
 import "../chunk-56KO2LYN.js";
 export {
   DEFAULT_OPTIONS,

package/dist/index.d.ts

@@ -6,8 +6,8 @@ import { CodeBlockCopyHandler } from '@bendyline/squisq-react';
 import { FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 import { PrunePolicy, SaveVersionResult, DocumentVersionManager } from '@bendyline/squisq/versions';
 import { DocBlocksHostAiAPI, DocBlocksHostSpeechAPI } from '@bendyline/docblocks/host';
-import { T as ThemePreference, A as AccentColor, I as InterfaceFontPreference, q as WriteCanvasPreferences, P as ProofingPreferences } from './Settings-DuXk6baH.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-DuXk6baH.js';
+import { T as ThemePreference, A as AccentColor, I as InterfaceFontPreference, q as WriteCanvasPreferences, P as ProofingPreferences } from './Settings-RDYvDDI0.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-RDYvDDI0.js';
 import { SharedDocumentMode } from '@bendyline/docblocks/share';
 import { MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
@@ -311,12 +311,20 @@ interface DocBlocksShellProps {
     theme?: EditorColorScheme | 'auto';
     /** Optional logo image URL for the app menu. */
     logoUrl?: string;
+    /** The app-menu logo drawn for dark appearances (see AppMenu). */
+    logoDarkUrl?: string;
     /** Version and surface label included in prefilled issue reports, e.g. `1.1.2 web`. */
     issueReportVersion?: string;
     /** ISO build date shown in About, e.g. `2026-07-15`. */
     appBuildDate?: string;
     /** Self-hosted ffmpeg.wasm core. Supplying it enables Animated GIF export. */
     ffmpegWasm?: FfmpegWasmLoadConfig;
+    /**
+     * URL of the self-hosted pdf.js worker (`pdfjs-dist/legacy/build/
+     * pdf.worker.min.mjs`, the version Squisq's formats package pins).
+     * Importing a PDF fails without it.
+     */
+    pdfWorkerSrc?: string;
     /**
      * Optional spreadsheet calculation backend. DocBlocks surfaces normally
      * pass the lazy IronCalc factory from the `calculation` package subpath;
@@ -405,7 +413,7 @@ interface DocBlocksShellProps {
      */
     offlineReady?: boolean;
 }
-declare function DocBlocksShell({ theme: hostTheme, logoUrl, issueReportVersion, appBuildDate, ffmpegWasm, calcEngineFactory, proofing, proofingDefaultEnabled, proofingIgnoreStore, homeDocumentTitle, homeDocumentPath, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, versioningRef, updateAvailable, onApplyUpdate, statusBarSlotRight, workspaceIndex: workspaceIndexMode, showCodeCopyButton, onCopyCode, allowRecording, allowPresentationWindow, allowPresentationFullscreen, offlineReady, }: DocBlocksShellProps): react_jsx_runtime.JSX.Element;
+declare function DocBlocksShell({ theme: hostTheme, logoUrl, logoDarkUrl, issueReportVersion, appBuildDate, ffmpegWasm, pdfWorkerSrc, calcEngineFactory, proofing, proofingDefaultEnabled, proofingIgnoreStore, homeDocumentTitle, homeDocumentPath, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, versioningRef, updateAvailable, onApplyUpdate, statusBarSlotRight, workspaceIndex: workspaceIndexMode, showCodeCopyButton, onCopyCode, allowRecording, allowPresentationWindow, allowPresentationFullscreen, offlineReady, }: DocBlocksShellProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Versioning preferences — global default + per-workspace resolution.
@@ -428,6 +436,11 @@ type VersioningPreference = 'on' | 'browser-only' | 'off';
 interface AppMenuProps {
     /** Optional logo image URL to display instead of the text label. */
     logoUrl?: string;
+    /**
+     * The logo drawn for dark appearances. Without it, the light logo is
+     * inverted in dark mode, which suits only a flat black-on-transparent mark.
+     */
+    logoDarkUrl?: string;
     /** Current theme preference. */
     themePreference?: ThemePreference;
     /** Called when the user changes the theme preference. */
@@ -454,10 +467,12 @@ interface AppMenuProps {
     /** Opens the active workspace's own settings (`.docblocks/workspace.json`). */
     onOpenWorkspaceSettings?: () => void;
     /**
-     * Called when the user clicks "Download all workspaces". When omitted,
+     * Called when the user clicks "Back up all workspaces". When omitted,
      * the menu item is hidden.
      */
     onDownloadAllWorkspaces?: () => void | Promise<void>;
+    /** Opens the keyboard-shortcut sheet. When omitted, the menu item is hidden. */
+    onShowKeyboardShortcuts?: () => void;
     /**
      * Called when the user asks the browser to keep origin storage persistent.
      * When omitted, the menu item is hidden.
@@ -482,7 +497,10 @@ interface AppMenuProps {
     storagePersistent?: boolean;
     /** Human-readable version/build and delivery surface shown in About. */
     appVersion?: string;
-    /** ISO build date shown in About. */
+    /**
+     * Build date shown in About: an ISO timestamp, shown as the viewer's local
+     * day, or a bare `YYYY-MM-DD`, shown as given.
+     */
     appBuildDate?: string;
     /**
      * The host's AI API. When present, Settings offers an AI section; when
@@ -497,7 +515,7 @@ interface AppMenuProps {
     /** Opens Settings whenever it changes to a new non-zero value. */
     settingsRequest?: number;
 }
-declare function AppMenu({ logoUrl, themePreference, onThemeChange, accentColor, onAccentColorChange, interfaceFont, onInterfaceFontChange, writeCanvasSettings, onWriteCanvasSettingsChange, proofingPreferences, onProofingPreferencesChange, versioningPreference, onVersioningPreferenceChange, onOpenWorkspaceSettings, onDownloadAllWorkspaces, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, appVersion, appBuildDate, ai, speech, 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, onShowKeyboardShortcuts, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, appVersion, appBuildDate, ai, speech, settingsRequest, }: AppMenuProps): react_jsx_runtime.JSX.Element;
 
 interface ExportToolbarControlsProps {
     /** Currently selected file path — used to derive the download filename. */