@bendyline/docblocks-react 2.1.0 → 2.1.1

package/dist/export/index.d.ts

@@ -1,10 +1,11 @@
 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';
 
 /**
  * Export option types and localStorage persistence for quick-export.
  */
-type ExportFormat = 'docx' | 'pdf' | 'pptx' | 'md' | 'html';
+type ExportFormat = 'docx' | 'pdf' | 'pptx' | 'epub' | 'md' | 'html';
 /** Visual style for HTML export. */
 type HtmlStyle = 
 /** Render via SquisqPlayer (themed, embeds player bundle). */
@@ -54,14 +55,14 @@ declare const DEFAULT_OPTIONS: ExportOptions;
 declare function loadLastExportOptions(): ExportOptions | null;
 declare function saveExportOptions(options: ExportOptions): void;
 
-/**
- * Execute an export using @bendyline/squisq-formats.
- */
-
 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'];
+}
 declare function buildExportFilename(selectedFile: string | null, options: ExportOptions): string;
 /** Run the export and trigger a download. */
-declare function runExport(markdown: string, selectedFile: string | null, options: ExportOptions, mediaContainer?: ContentContainer | null, saveBlob?: ExportBlobSaver): Promise<void>;
+declare function runExport(markdown: string, selectedFile: string | null, options: ExportOptions, mediaContainer?: ContentContainer | null, saveBlob?: ExportBlobSaver, converterOverrides?: ExportConverterOverrides): Promise<void>;
 
 interface ExportDialogProps {
     /** Initial options (pre-populated from last export). */
@@ -80,14 +81,23 @@ 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;
 }
 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, exporting, error, destination, onExport, onOptionsChange, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
+declare function ExportDialog({ initial, exporting, error, destination, onExport, onOptionsChange, onAnimatedGifExport, 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;
 
-export { DEFAULT_OPTIONS, type ExportBlobSaver, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, buildExportFilename, loadLastExportOptions, runExport, saveExportOptions };
+export { DEFAULT_OPTIONS, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, buildExportFilename, loadLastExportOptions, runExport, saveExportOptions, updateExportTargetExtension };

package/dist/export/index.js

@@ -1,19 +1,22 @@
+import {
+  updateExportTargetExtension
+} from "../chunk-BI7NVU6T.js";
 import {
   ExportDialog
-} from "../chunk-UNYZQXWR.js";
+} from "../chunk-3CZ27FOA.js";
 import {
   buildExportFilename,
   runExport
-} from "../chunk-ZI56BNB7.js";
-import "../chunk-4XXSWN3T.js";
-import "../chunk-FMGTHSTX.js";
+} from "../chunk-GHQ4X7KM.js";
+import "../chunk-YBEYTVU2.js";
+import "../chunk-LG6HAWCK.js";
 import {
   DEFAULT_OPTIONS,
   FORMAT_EXTENSIONS,
   FORMAT_LABELS,
   loadLastExportOptions,
   saveExportOptions
-} from "../chunk-DD4VFJQI.js";
+} from "../chunk-EBWYGTN7.js";
 export {
   DEFAULT_OPTIONS,
   ExportDialog,
@@ -22,6 +25,6 @@ export {
   buildExportFilename,
   loadLastExportOptions,
   runExport,
-  saveExportOptions
+  saveExportOptions,
+  updateExportTargetExtension
 };
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FileSystemProvider, FileSystemEntry } from '@bendyline/docblocks/filesystem';
 import { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
 import { EditorColorScheme } from '@bendyline/squisq-editor-react';
+import { FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 import { PrunePolicy, SaveVersionResult, DocumentVersionManager } from '@bendyline/squisq/versions';
 import { ThemePreference, AccentColor, WriteCanvasPreferences } from './settings/index.js';
 export { AccentColorSettings, AccentColorSettingsProps, SettingsDialog, SettingsDialogProps, ThemeSettings, ThemeSettingsProps, WriteCanvasSettingsControls, WriteCanvasSettingsControlsProps } from './settings/index.js';
@@ -9,9 +10,10 @@ import { SharedDocumentMode } from '@bendyline/docblocks/share';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { VideoExportModalProps } from '@bendyline/squisq-video-react';
 import { ExportBlobSaver } from './export/index.js';
-export { DEFAULT_OPTIONS, ExportDestinationControl, ExportDialog, ExportDialogProps, ExportFormat, ExportOptions, HtmlBundle, HtmlStyle, buildExportFilename, loadLastExportOptions, runExport } from './export/index.js';
+export { DEFAULT_OPTIONS, ExportDestinationControl, ExportDialog, ExportDialogProps, ExportFormat, ExportOptions, HtmlBundle, HtmlStyle, buildExportFilename, loadLastExportOptions, runExport, updateExportTargetExtension } from './export/index.js';
 import { DocumentSession, DocumentSessionSnapshot } from '@bendyline/docblocks/document';
 import 'react';
+import '@bendyline/squisq-formats/pptx';
 
 type FileTreeChange = {
     type: 'create';
@@ -187,6 +189,10 @@ interface DocBlocksShellProps {
     logoUrl?: 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;
     /** Stable host title used before a document opens and for the optional home document. */
     homeDocumentTitle?: string;
     /** Document path that represents the host's indexable home experience. */
@@ -224,7 +230,7 @@ interface DocBlocksShellProps {
      */
     offlineReady?: boolean;
 }
-declare function DocBlocksShell({ theme: hostTheme, logoUrl, issueReportVersion, homeDocumentTitle, homeDocumentPath, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, versioningRef, updateAvailable, onApplyUpdate, offlineReady, }: DocBlocksShellProps): react_jsx_runtime.JSX.Element;
+declare function DocBlocksShell({ theme: hostTheme, logoUrl, issueReportVersion, appBuildDate, ffmpegWasm, homeDocumentTitle, homeDocumentPath, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, versioningRef, updateAvailable, onApplyUpdate, offlineReady, }: DocBlocksShellProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Versioning preferences — global default + per-workspace resolution.
@@ -287,8 +293,12 @@ interface AppMenuProps {
     } | null>;
     /** Whether the browser has marked origin storage persistent (Settings display). */
     storagePersistent?: boolean;
+    /** Human-readable version/build and delivery surface shown in About. */
+    appVersion?: string;
+    /** ISO build date shown in About. */
+    appBuildDate?: string;
 }
-declare function AppMenu({ logoUrl, themePreference, onThemeChange, accentColor, onAccentColorChange, writeCanvasSettings, onWriteCanvasSettingsChange, versioningPreference, onVersioningPreferenceChange, onDownloadAllWorkspaces, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, }: AppMenuProps): react_jsx_runtime.JSX.Element;
+declare function AppMenu({ logoUrl, themePreference, onThemeChange, accentColor, onAccentColorChange, writeCanvasSettings, onWriteCanvasSettingsChange, versioningPreference, onVersioningPreferenceChange, onDownloadAllWorkspaces, onKeepBrowserData, onInstallApp, getStorageEstimate, storagePersistent, appVersion, appBuildDate, }: AppMenuProps): react_jsx_runtime.JSX.Element;
 
 interface ExportToolbarControlsProps {
     /** Currently selected file path — used to derive the download filename. */
@@ -303,6 +313,8 @@ interface ExportToolbarControlsProps {
     trigger?: 'menu' | 'button';
     /** Whether to show video export in the overflow menu. */
     showVideoExport?: boolean;
+    /** Self-hosted ffmpeg.wasm core. Supplying it enables Animated GIF export. */
+    ffmpegWasm?: FfmpegWasmLoadConfig;
     /** Resolved host color scheme for the video export dialog. */
     colorScheme?: 'light' | 'dark';
     /** Host palette overrides for the video export dialog and progress UI. */
@@ -327,9 +339,6 @@ interface ExportDestinationAdapter {
 /** Public toolbar control with its editor-coupled implementation deferred. */
 declare function ExportToolbarControls(props: ExportToolbarControlsProps): 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;
-
 interface UseDocumentSessionResult {
     /** Stable controller for the lifetime of the mounted shell/panel. */
     session: DocumentSession;
@@ -345,4 +354,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 FileTreeChange, type FileTreeMutationHandler, FileTreeNode, type FileTreeNodeProps, ThemePreference, type UseDocumentSessionResult, WorkspacePicker, type WorkspacePickerProps, WriteCanvasPreferences, updateExportTargetExtension, useDocumentSession, useFileTree };
+export { AccentColor, AppMenu, type AppMenuProps, DocBlocksShell, type DocBlocksShellProps, ExportBlobSaver, type ExportDestinationAdapter, type ExportDestinationTarget, ExportToolbarControls, type ExportToolbarControlsProps, FileExplorer, type FileExplorerProps, type FileTreeChange, type FileTreeMutationHandler, FileTreeNode, type FileTreeNodeProps, ThemePreference, type UseDocumentSessionResult, WorkspacePicker, type WorkspacePickerProps, WriteCanvasPreferences, useDocumentSession, useFileTree };