@bendyline/squisq-video-react 2.2.10 → 2.3.0

package/dist/components/index.d.ts

@@ -1,10 +1,12 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, MediaProvider } from '@bendyline/squisq/schemas';
-import { a as VideoExportConfig, e as VideoOutputFormat } from '../useVideoExport-raCbwbwb.js';
+import { b as VideoExportConfig, f as VideoOutputFormat } from '../useVideoExport-B2eVCvTX.js';
+export { CoverImageExportFormat, CoverImageExportModal, CoverImageExportModalProps, coverImageFilename, validateCoverImageDimensions } from '../cover-image/index.js';
 import '@bendyline/squisq/markdown';
+import '@bendyline/squisq/doc';
 import '@bendyline/squisq-video';
 import '@bendyline/squisq-react';
-import '../mainThreadEncoder-BgcFyYvO.js';
+import '../mainThreadEncoder-BVCLjlfj.js';
 
 interface VideoExportModalProps {
     /** The document to export */

package/dist/components/index.js

@@ -1,11 +1,20 @@
 import {
   VideoExportButton,
   VideoExportModal
-} from "../chunk-ERG6OLLO.js";
-import "../chunk-GLOLS2CQ.js";
-import "../chunk-2XACUF6E.js";
-import "../chunk-MEPETH5V.js";
+} from "../chunk-CRXJOZSH.js";
+import {
+  CoverImageExportModal,
+  coverImageFilename,
+  validateCoverImageDimensions
+} from "../chunk-NTRCMTCF.js";
+import "../chunk-U3RSDWQL.js";
+import "../chunk-YTEDBL6F.js";
+import "../chunk-32QCPFXE.js";
+import "../chunk-5MFQMJ5Z.js";
 export {
+  CoverImageExportModal,
   VideoExportButton,
-  VideoExportModal
+  VideoExportModal,
+  coverImageFilename,
+  validateCoverImageDimensions
 };

package/dist/cover-image/index.d.ts

@@ -0,0 +1,23 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Doc, MediaProvider, Theme } from '@bendyline/squisq/schemas';
+import { CoverSlideTemplate } from '@bendyline/squisq/doc';
+
+type CoverImageExportFormat = 'png' | 'jpeg' | 'webp';
+interface CoverImageExportModalProps {
+    doc: Doc;
+    mediaProvider?: MediaProvider | null;
+    theme?: Theme;
+    coverSlideTemplate?: CoverSlideTemplate;
+    defaultWidth?: number;
+    defaultHeight?: number;
+    defaultFileName?: string;
+    colorScheme?: 'light' | 'dark';
+    /** Optional host save flow. Return false when the user cancels. */
+    saveOutput?: (blob: Blob, filename: string) => boolean | void | Promise<boolean | void>;
+    onClose: () => void;
+}
+declare function validateCoverImageDimensions(width: number, height: number): string | null;
+declare function coverImageFilename(requestedName: string | undefined, format: CoverImageExportFormat): string;
+declare function CoverImageExportModal({ doc, mediaProvider, theme, coverSlideTemplate, defaultWidth, defaultHeight, defaultFileName, colorScheme, saveOutput, onClose, }: CoverImageExportModalProps): react_jsx_runtime.JSX.Element;
+
+export { type CoverImageExportFormat, CoverImageExportModal, type CoverImageExportModalProps, coverImageFilename, validateCoverImageDimensions };

package/dist/cover-image/index.js

@@ -0,0 +1,11 @@
+import {
+  CoverImageExportModal,
+  coverImageFilename,
+  validateCoverImageDimensions
+} from "../chunk-NTRCMTCF.js";
+import "../chunk-YTEDBL6F.js";
+export {
+  CoverImageExportModal,
+  coverImageFilename,
+  validateCoverImageDimensions
+};

package/dist/encoder/index.d.ts

@@ -1,4 +1,4 @@
-export { E as EncoderConfig, a as EncoderFrameSource, M as MainThreadEncoder, c as createEncoder, s as supportsWebCodecs, b as supportsWebCodecsH264 } from '../mainThreadEncoder-BgcFyYvO.js';
+export { E as EncoderConfig, a as EncoderFrameSource, M as MainThreadEncoder, c as createEncoder, s as supportsWebCodecs, b as supportsWebCodecsH264 } from '../mainThreadEncoder-BVCLjlfj.js';
 export { FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 
 /**

package/dist/encoder/index.js

@@ -3,8 +3,8 @@ import {
   supportsWebCodecs,
   supportsWebCodecsAac,
   supportsWebCodecsH264
-} from "../chunk-2XACUF6E.js";
-import "../chunk-MEPETH5V.js";
+} from "../chunk-32QCPFXE.js";
+import "../chunk-5MFQMJ5Z.js";
 export {
   createEncoder,
   supportsWebCodecs,

package/dist/hooks/index.d.ts

@@ -1,21 +1,10 @@
-export { D as DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS, R as ResolvedVideoExportCover, U as UseVideoExportOptions, V as VideoAudioPolicy, a as VideoExportConfig, b as VideoExportFramePreview, c as VideoExportResult, d as VideoExportState, e as VideoOutputFormat, r as resolveVideoExportCover, u as useVideoExport } from '../useVideoExport-raCbwbwb.js';
-import { Doc } from '@bendyline/squisq/schemas';
+export { D as DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS, R as ResolvedVideoExportCover, U as UseVideoExportOptions, V as VideoAudioPolicy, a as VideoCoverFramePlan, b as VideoExportConfig, c as VideoExportFramePreview, d as VideoExportResult, e as VideoExportState, f as VideoOutputFormat, r as resolveVideoCoverFramePlan, g as resolveVideoExportCover, u as useVideoExport } from '../useVideoExport-B2eVCvTX.js';
+import * as _bendyline_squisq_doc from '@bendyline/squisq/doc';
+import { Doc, MediaProvider } from '@bendyline/squisq/schemas';
 import { RenderHtmlOptions } from '@bendyline/squisq-video';
 import { CaptionMode } from '@bendyline/squisq-react';
 import '@bendyline/squisq/markdown';
-import '../mainThreadEncoder-BgcFyYvO.js';
-
-/**
- * useFrameCapture — Hidden div + html2canvas frame capture.
- *
- * Mounts a DocPlayer in renderMode inside a hidden div (same document),
- * then captures individual frames by seeking the player and rendering
- * the DOM to a canvas via html2canvas.
- *
- * Uses React directly — no script injection, no iframes, no eval.
- *
- * Returns either a reusable canvas or an ImageBitmap snapshot for a Worker.
- */
+import '../mainThreadEncoder-BVCLjlfj.js';
 
 interface FrameCaptureOptions {
     /**
@@ -28,6 +17,10 @@ interface FrameCaptureOptions {
 interface FrameCaptureRenderOptions extends Omit<RenderHtmlOptions, 'playerScript'> {
     /** Whether the hidden player should materialize its managed cover. */
     showCoverSlide?: boolean;
+    /** Visual template used to materialize the managed cover. */
+    coverSlideTemplate?: _bendyline_squisq_doc.CoverSlideTemplate;
+    /** Existing provider to use for media resolution. It remains caller-owned. */
+    mediaProvider?: MediaProvider;
 }
 interface FrameCaptureHandle {
     /** Initialize the hidden player. Returns the video duration in seconds. */

package/dist/hooks/index.js

@@ -1,13 +1,17 @@
 import {
   DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS,
+  resolveVideoCoverFramePlan,
   resolveVideoExportCover,
-  useFrameCapture,
   useVideoExport
-} from "../chunk-GLOLS2CQ.js";
-import "../chunk-2XACUF6E.js";
-import "../chunk-MEPETH5V.js";
+} from "../chunk-U3RSDWQL.js";
+import {
+  useFrameCapture
+} from "../chunk-YTEDBL6F.js";
+import "../chunk-32QCPFXE.js";
+import "../chunk-5MFQMJ5Z.js";
 export {
   DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS,
+  resolveVideoCoverFramePlan,
   resolveVideoExportCover,
   useFrameCapture,
   useVideoExport

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export { VideoExportButton, VideoExportButtonProps, VideoExportModal, VideoExportModalProps, VideoExportPalette } from './components/index.js';
-export { D as DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS, R as ResolvedVideoExportCover, U as UseVideoExportOptions, V as VideoAudioPolicy, a as VideoExportConfig, b as VideoExportFramePreview, c as VideoExportResult, d as VideoExportState, e as VideoOutputFormat, r as resolveVideoExportCover, u as useVideoExport } from './useVideoExport-raCbwbwb.js';
+export { CoverImageExportFormat, CoverImageExportModal, CoverImageExportModalProps, coverImageFilename, validateCoverImageDimensions } from './cover-image/index.js';
+export { D as DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS, R as ResolvedVideoExportCover, U as UseVideoExportOptions, V as VideoAudioPolicy, a as VideoCoverFramePlan, b as VideoExportConfig, c as VideoExportFramePreview, d as VideoExportResult, e as VideoExportState, f as VideoOutputFormat, r as resolveVideoCoverFramePlan, g as resolveVideoExportCover, u as useVideoExport } from './useVideoExport-B2eVCvTX.js';
 export { FrameCaptureHandle, FrameCaptureOptions, FrameCaptureRenderOptions, useFrameCapture } from './hooks/index.js';
-export { E as EncoderConfig, a as EncoderFrameSource, M as MainThreadEncoder, c as createEncoder, s as supportsWebCodecs, b as supportsWebCodecsH264 } from './mainThreadEncoder-BgcFyYvO.js';
+export { E as EncoderConfig, a as EncoderFrameSource, M as MainThreadEncoder, c as createEncoder, s as supportsWebCodecs, b as supportsWebCodecsH264 } from './mainThreadEncoder-BVCLjlfj.js';
 export { FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 export { supportsWebCodecsAac } from './encoder/index.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';
+import '@bendyline/squisq/doc';
 import '@bendyline/squisq/markdown';
 import '@bendyline/squisq-react';

package/dist/index.js

@@ -1,29 +1,41 @@
 import {
   VideoExportButton,
   VideoExportModal
-} from "./chunk-ERG6OLLO.js";
+} from "./chunk-CRXJOZSH.js";
+import {
+  CoverImageExportModal,
+  coverImageFilename,
+  validateCoverImageDimensions
+} from "./chunk-NTRCMTCF.js";
 import {
   DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS,
+  resolveVideoCoverFramePlan,
   resolveVideoExportCover,
-  useFrameCapture,
   useVideoExport
-} from "./chunk-GLOLS2CQ.js";
+} from "./chunk-U3RSDWQL.js";
+import {
+  useFrameCapture
+} from "./chunk-YTEDBL6F.js";
 import {
   createEncoder,
   supportsWebCodecs,
   supportsWebCodecsAac,
   supportsWebCodecsH264
-} from "./chunk-2XACUF6E.js";
-import "./chunk-MEPETH5V.js";
+} from "./chunk-32QCPFXE.js";
+import "./chunk-5MFQMJ5Z.js";
 export {
+  CoverImageExportModal,
   DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS,
   VideoExportButton,
   VideoExportModal,
+  coverImageFilename,
   createEncoder,
+  resolveVideoCoverFramePlan,
   resolveVideoExportCover,
   supportsWebCodecs,
   supportsWebCodecsAac,
   supportsWebCodecsH264,
   useFrameCapture,
-  useVideoExport
+  useVideoExport,
+  validateCoverImageDimensions
 };

package/dist/{mainThreadEncoder-BgcFyYvO.d.ts → mainThreadEncoder-BVCLjlfj.d.ts}

@@ -31,6 +31,13 @@ interface EncoderConfig {
         numberOfChannels: number;
         sampleRate: number;
     };
+    /**
+     * Allow the muxer to spill settled output bytes into Blob storage so a long
+     * export does not hold the whole MP4 in JS memory. Only valid when the
+     * caller will finalize via {@link MainThreadEncoder.finalizeBlob} — byte
+     * consumers (GIF transcode, ffmpeg audio muxing) must leave this off.
+     */
+    spillOutputToBlob?: boolean;
 }
 type EncoderFrameSource = ImageBitmap | HTMLCanvasElement;
 interface MainThreadEncoder {
@@ -44,6 +51,8 @@ interface MainThreadEncoder {
     addAudioChunk?(chunk: EncodedAudioChunk, meta?: EncodedAudioChunkMetadata): void;
     /** Flush pending frames and finalize the MP4. Returns the MP4 ArrayBuffer. */
     finalize(): Promise<ArrayBuffer>;
+    /** Finalize directly into a Blob, avoiding a second full-file allocation. */
+    finalizeBlob?(): Promise<Blob>;
     /** Close the encoder without producing output (e.g., on cancel). */
     close(): void;
 }

package/dist/{useVideoExport-raCbwbwb.d.ts → useVideoExport-B2eVCvTX.d.ts}

@@ -1,8 +1,9 @@
 import { MediaProvider, Theme, VideoPresentation, VideoPipSize, VideoPipShape, VideoPipPosition, Doc } from '@bendyline/squisq/schemas';
 import { ResourcePolicy } from '@bendyline/squisq/markdown';
+import { CoverSlidePlayback } from '@bendyline/squisq/doc';
 import { VideoQuality, VideoOrientation, FfmpegWasmLoadConfig } from '@bendyline/squisq-video';
 import { CaptionMode } from '@bendyline/squisq-react';
-import { a as EncoderFrameSource } from './mainThreadEncoder-BgcFyYvO.js';
+import { a as EncoderFrameSource } from './mainThreadEncoder-BVCLjlfj.js';
 
 /**
  * useVideoExport — Main orchestration hook for browser video export.
@@ -21,7 +22,7 @@ import { a as EncoderFrameSource } from './mainThreadEncoder-BgcFyYvO.js';
  *   <button onClick={() => startExport(doc, options)}>Export</button>
  */
 
-declare const DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS = 2;
+declare const DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS: number;
 type VideoExportState = 'idle' | 'preparing' | 'capturing' | 'encoding' | 'complete' | 'error';
 /** Browser export container format. */
 type VideoOutputFormat = 'mp4' | 'gif';
@@ -76,7 +77,17 @@ interface VideoExportConfig {
     pipPosition?: VideoPipPosition;
     /** Managed-cover visibility override. Omitted values resolve from Doc frontmatter. */
     showCoverSlide?: boolean;
-    /** Seconds to hold an enabled managed cover before story frame zero (default: 2). */
+    /**
+     * Seconds to show an enabled managed cover. Omitted values resolve from Doc
+     * frontmatter, then fall back to 2 seconds.
+     */
+    coverDuration?: number;
+    /** Whether the story advances under the cover or starts after it. */
+    coverPlayback?: CoverSlidePlayback;
+    /**
+     * @deprecated Use `coverDuration` plus `coverPlayback: 'preroll'`.
+     * Seconds to hold an enabled managed cover before story frame zero.
+     */
     coverPreRoll?: number;
     /** Player IIFE bundle (unused in browser export, kept for CLI/Playwright path) */
     playerScript?: string;
@@ -85,10 +96,23 @@ interface VideoExportConfig {
 }
 interface ResolvedVideoExportCover {
     showCoverSlide: boolean;
+    coverDuration: number;
+    coverPlayback: CoverSlidePlayback;
+    /** Audio/story offset introduced by preroll mode. */
     coverPreRoll: number;
 }
 /** Resolve the cover segment shared by browser MP4/GIF capture. */
-declare function resolveVideoExportCover(doc: Doc, config?: Pick<VideoExportConfig, 'showCoverSlide' | 'coverPreRoll'>): ResolvedVideoExportCover;
+declare function resolveVideoExportCover(doc: Doc, config?: Pick<VideoExportConfig, 'showCoverSlide' | 'coverDuration' | 'coverPlayback' | 'coverPreRoll'>): ResolvedVideoExportCover;
+interface VideoCoverFramePlan {
+    coverFrameCount: number;
+    storyFrameCount: number;
+    totalFrames: number;
+    totalDuration: number;
+    audioOffset: number;
+    captureTimeForFrame: (frameIndex: number) => number;
+}
+/** Build the exact frame/audio schedule for overlay and preroll cover timing. */
+declare function resolveVideoCoverFramePlan(docDuration: number, fps: number, cover: ResolvedVideoExportCover): VideoCoverFramePlan;
 interface VideoExportResult {
     /** Current export state */
     state: VideoExportState;
@@ -160,4 +184,4 @@ interface UseVideoExportOptions {
 }
 declare function useVideoExport(options?: UseVideoExportOptions): VideoExportResult;
 
-export { DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS as D, type ResolvedVideoExportCover as R, type UseVideoExportOptions as U, type VideoAudioPolicy as V, type VideoExportConfig as a, type VideoExportFramePreview as b, type VideoExportResult as c, type VideoExportState as d, type VideoOutputFormat as e, resolveVideoExportCover as r, useVideoExport as u };
+export { DEFAULT_VIDEO_COVER_PRE_ROLL_SECONDS as D, type ResolvedVideoExportCover as R, type UseVideoExportOptions as U, type VideoAudioPolicy as V, type VideoCoverFramePlan as a, type VideoExportConfig as b, type VideoExportFramePreview as c, type VideoExportResult as d, type VideoExportState as e, type VideoOutputFormat as f, resolveVideoExportCover as g, resolveVideoCoverFramePlan as r, useVideoExport as u };

package/dist/workers/encode.worker.js

@@ -3,7 +3,7 @@ import {
   createMp4Muxer,
   resolveWebCodecsQueueLimit,
   shouldEncodeFfmpegBatch
-} from "../chunk-MEPETH5V.js";
+} from "../chunk-5MFQMJ5Z.js";
 
 // src/workers/encode.worker.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-video-react",
-  "version": "2.2.10",
+  "version": "2.3.0",
   "description": "React components for browser-based MP4 and animated-GIF export of Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -38,6 +38,10 @@
       "types": "./dist/components/index.d.ts",
       "import": "./dist/components/index.js"
     },
+    "./cover-image": {
+      "types": "./dist/cover-image/index.d.ts",
+      "import": "./dist/cover-image/index.js"
+    },
     "./hooks": {
       "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js"
@@ -65,9 +69,9 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.4.4",
-    "@bendyline/squisq-video": "2.2.8",
-    "@bendyline/squisq-react": "2.4.6",
+    "@bendyline/squisq": "2.5.0",
+    "@bendyline/squisq-video": "2.2.9",
+    "@bendyline/squisq-react": "2.5.0",
     "@ffmpeg/core": "0.12.9",
     "@ffmpeg/ffmpeg": "0.12.15",
     "@ffmpeg/util": "0.12.2",