@bendyline/squisq-video 1.2.1 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @bendyline/squisq-video
 
-Headless video rendering foundation for Squisq documents. Generates self-contained render HTML for frame capture and encodes frames to MP4 via ffmpeg.wasm. Browser-pure — works in Node.js and the browser with no native dependencies.
+Video and animated-GIF rendering foundation for Squisq documents. Its pure timeline, quality, palette, and render-HTML helpers work in Node.js and browsers; `framesToMp4Wasm` encodes frames in browser runtimes without native dependencies.
 
 Part of the [Squisq](https://github.com/bendyline/squisq) monorepo.
 
@@ -15,15 +15,18 @@ npm install @bendyline/squisq-video
 
 ## What's Inside
 
-| Export                                                                                                          | Description                                                                                                     |
-| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `generateRenderHtml(doc, options)`                                                                              | Self-contained HTML page with embedded media for headless frame capture                                         |
-| `framesToMp4Wasm(frames, audio, options)`                                                                       | Encode PNG frames (+ optional audio) to MP4 via ffmpeg.wasm                                                     |
-| `computeAudioTimeline(doc, coverPreRoll?)`                                                                      | Flatten a doc's narration + timed media into absolute-timed audio clips (browser export and CLI mix share this) |
-| `bitrateForQuality(quality, width, height)`                                                                     | Target H.264 bitrate (`w*h*bitsPerPixel`) — the single source of truth for WebCodecs bitrate                    |
-| `QUALITY_PRESETS`, `ORIENTATION_DIMENSIONS`, `resolveDimensions`                                                | Quality/dimension presets and helpers                                                                           |
-| `VideoExportOptions`, `VideoQuality`, `VideoOrientation`, `QualityPreset`, `EncoderResult`, `AudioTimelineClip` | Shared types                                                                                                    |
-| `fetchFile`                                                                                                     | Re-export of `@ffmpeg/util`'s `fetchFile` for preparing audio bytes                                             |
+| Export                                                                                                  | Description                                                                                                     |
+| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `generateRenderHtml(doc, options)`                                                                      | Self-contained HTML page with embedded media for headless frame capture                                         |
+| `framesToMp4Wasm(frames, audio, options)`                                                               | Encode PNG frames (+ optional audio) to MP4 via ffmpeg.wasm                                                     |
+| `computeAudioTimeline(doc, coverPreRoll?)`                                                              | Flatten a doc's narration + timed media into absolute-timed audio clips (browser export and CLI mix share this) |
+| `bitrateForQuality(quality, width, height)`                                                             | Target H.264 bitrate (`w*h*bitsPerPixel`) — the single source of truth for WebCodecs bitrate                    |
+| `ffmpegVideoQualityArgs`, `audioBitrateArg`, `ffmpegAudioMuxArgs`                                       | Shared FFmpeg flags; audio muxing pads short narration so it cannot truncate the video                          |
+| `ffmpegGifFilterGraph`, `ffmpegGifOutputArgs`                                                           | Shared global-palette GIF filters and muxer flags used by native and browser exporters                          |
+| `QUALITY_PRESETS`, `ORIENTATION_DIMENSIONS`, `resolveDimensions`                                        | Quality/dimension presets and helpers                                                                           |
+| `validateVideoExportOptions(options)`                                                                   | Fail-fast runtime validation for FPS, dimensions, quality, and orientation                                      |
+| `VideoExportOptions`, `VideoQuality`, `VideoOrientation`, `GifDither`, `QualityPreset`, `EncoderResult` | Shared video and GIF types                                                                                      |
+| `fetchFile`                                                                                             | Re-export of `@ffmpeg/util`'s `fetchFile` for preparing audio bytes                                             |
 
 This package is the shared foundation under [@bendyline/squisq-video-react](https://www.npmjs.com/package/@bendyline/squisq-video-react) (in-browser export UI) and [@bendyline/squisq-cli](https://www.npmjs.com/package/@bendyline/squisq-cli) (`squisq video`, which pairs the render HTML with Playwright capture and native ffmpeg encoding).
 
@@ -31,7 +34,10 @@ This package is the shared foundation under [@bendyline/squisq-video-react](http
 
 ### Generate Render HTML
 
-Create a self-contained HTML page that mounts the standalone Squisq player in render mode, with all images and audio embedded as base64 data URIs. The page exposes `window.seekTo(time)` and `window.getDuration()` so a headless browser (Playwright, Puppeteer) can step through frames and screenshot each one:
+Create a self-contained HTML page that mounts the standalone Squisq player in render mode, with all images and audio embedded as base64 data URIs. A headless browser (Playwright, Puppeteer) obtains the player-specific handle with `SquisqPlayer.getHandle(root)` and uses its render API to step through frames and screenshot each one:
+
+Render methods are deliberately instance-scoped; generated pages do not expose
+legacy top-level `window.seekTo` or `window.getDuration` functions.
 
 ```ts
 import { generateRenderHtml } from '@bendyline/squisq-video';
@@ -60,13 +66,18 @@ const { data, duration } = await framesToMp4Wasm(
     quality: 'normal', // 'draft' | 'normal' | 'high' (default 'normal')
     orientation: 'landscape', // 'landscape' | 'portrait' (default 'landscape')
     // width / height override the orientation defaults
+    // Optional for offline/CSP-controlled hosting:
+    ffmpegWasm: {
+      coreURL: '/vendor/ffmpeg-core.js',
+      wasmURL: '/vendor/ffmpeg-core.wasm',
+    },
     onProgress: (percent, phase) => console.log(`${phase}: ${percent}%`),
   },
 );
 // data: Uint8Array of MP4 bytes; duration: seconds (frames.length / fps)
 ```
 
-Encoding is H.264 (`libx264`, `yuv420p`) with optional AAC audio; frames are scaled/padded to the target dimensions preserving aspect ratio. ffmpeg.wasm needs `SharedArrayBuffer` — in browsers that means COOP/COEP headers; Node 18+ works out of the box.
+Encoding is H.264 (`libx264`, `yuv420p`) with optional AAC audio; frames are scaled/padded to the target dimensions preserving aspect ratio. ffmpeg.wasm needs `SharedArrayBuffer`, which normally means serving COOP/COEP headers. `framesToMp4Wasm` is browser-only; Node callers can use `framesToMp4Native` or `framesToMp4NativeBytes` from `@bendyline/squisq-cli/api`.
 
 ### Schedule a Doc's Audio
 

package/dist/index.d.ts

@@ -18,6 +18,13 @@ export { fetchFile } from '@ffmpeg/util';
 type VideoQuality = 'draft' | 'normal' | 'high';
 /** Viewport orientation for video output. */
 type VideoOrientation = 'landscape' | 'portrait';
+/** Optional URLs for self-hosting or pinning ffmpeg.wasm runtime assets. */
+interface FfmpegWasmLoadConfig {
+    coreURL?: string;
+    wasmURL?: string;
+    workerURL?: string;
+    classWorkerURL?: string;
+}
 /** Encoding preset parameters mapped from VideoQuality. */
 interface QualityPreset {
     /** FFmpeg -preset value (ultrafast, medium, slow) */
@@ -64,6 +71,8 @@ interface VideoExportOptions {
     quality?: VideoQuality;
     /** Viewport orientation (default: 'landscape') */
     orientation?: VideoOrientation;
+    /** Optional self-hosted ffmpeg.wasm assets for offline/CSP-controlled use. */
+    ffmpegWasm?: FfmpegWasmLoadConfig;
     /**
      * Progress callback. Called during encoding with completion percentage and phase description.
      * @param percent - 0-100 completion percentage
@@ -78,6 +87,8 @@ interface EncoderResult {
     /** Video duration in seconds */
     duration: number;
 }
+/** Fail fast with actionable errors before launching an encoder or browser. */
+declare function validateVideoExportOptions(options: VideoExportOptions): void;
 /**
  * Resolve dimensions from options, applying orientation defaults.
  */
@@ -135,9 +146,9 @@ declare function computeAudioTimeline(doc: Doc, coverPreRoll?: number): AudioTim
  * Generates a self-contained HTML document that loads the SquisqPlayer standalone
  * bundle in renderMode, embedding all images and audio as base64 data URIs.
  *
- * The generated page exposes `window.seekTo(time)`, `window.getDuration()`, etc.
- * via the SquisqRenderAPI, enabling Playwright (or any headless browser) to step
- * through frames and capture screenshots.
+ * The generated page mounts one standalone player whose instance handle is
+ * available through `SquisqPlayer.getHandle(root)`. Headless callers use that
+ * handle's render API to step through frames and capture screenshots.
  *
  * Browser-pure: uses only btoa() and Uint8Array — no Node.js APIs.
  */
@@ -161,12 +172,17 @@ interface RenderHtmlOptions {
     height?: number;
     /** Caption style for the rendered video. Omit for no captions. */
     captionStyle?: 'standard' | 'social';
+    /**
+     * Whether Squisq layer animations and block transitions are rendered.
+     * Defaults to true. Embedded/timed media and document timing are unaffected.
+     */
+    animationsEnabled?: boolean;
 }
 /**
  * Generate a self-contained HTML document for headless video frame capture.
  *
- * The page mounts the SquisqPlayer in renderMode, which exposes the
- * SquisqRenderAPI on `window` (seekTo, getDuration, getCaptions, etc.).
+ * The page mounts the SquisqPlayer in renderMode. Call
+ * `SquisqPlayer.getHandle(root)` to obtain this instance's render API.
  *
  * @param doc - The Doc to render
  * @param options - Render HTML options including player script and media
@@ -186,6 +202,24 @@ declare function generateRenderHtml(doc: Doc, options: RenderHtmlOptions): strin
  * exercise directly).
  */
 
+/** Dithering algorithms intentionally exposed by Squisq's GIF encoder. */
+type GifDither = 'bayer' | 'sierra2_4a' | 'none';
+/** Options for the shared palette-based animated GIF filter graph. */
+interface GifFilterOptions {
+    width: number;
+    height: number;
+    /** Palette size, from 2 through GIF's maximum of 256. */
+    maxColors?: number;
+    /** Palette dithering algorithm (default: `sierra2_4a`). */
+    dither?: GifDither;
+    /** Ordered Bayer strength, used only when `dither` is `bayer` (0-5). */
+    bayerScale?: number;
+}
+/** Options for GIF muxing in addition to the palette filter graph. */
+interface GifOutputOptions extends GifFilterOptions {
+    /** Number of repeats; 0 loops forever and -1 disables looping. */
+    loop?: number;
+}
 /**
  * H.264 speed/quality flags (`-preset`, `-crf`) for a quality level.
  * @example ffmpegVideoQualityArgs('high') // ['-preset', 'slow', '-crf', '18']
@@ -196,13 +230,31 @@ declare function ffmpegVideoQualityArgs(quality: VideoQuality): string[];
  * @example audioBitrateArg('high') // '192k'
  */
 declare function audioBitrateArg(quality: VideoQuality): string;
+/**
+ * AAC muxing flags that preserve the complete video timeline.
+ *
+ * `-shortest` by itself truncates video whenever narration ends early. Padding
+ * the audio stream first makes the video stream the shortest input instead, so
+ * audio longer than the video is trimmed while shorter audio becomes silence.
+ */
+declare function ffmpegAudioMuxArgs(bitrate: string | number): string[];
+/**
+ * Build a high-quality, compression-friendly GIF palette filter graph.
+ *
+ * A single palette is derived from the parts of the frame that change, while
+ * `diff_mode=rectangle` keeps error diffusion inside the changed rectangle so
+ * static slide backgrounds remain byte-stable and compress efficiently.
+ */
+declare function ffmpegGifFilterGraph(options: GifFilterOptions): string;
+/** Build the output-side FFmpeg arguments for an animated GIF. */
+declare function ffmpegGifOutputArgs(options: GifOutputOptions): string[];
 
 /**
  * WASM Video Encoder
  *
  * Encodes PNG frame screenshots into an MP4 video using ffmpeg.wasm.
- * Browser-pure — no Node.js APIs. Works in any environment with SharedArrayBuffer
- * support (browsers with COOP/COEP headers, or Node 18+).
+ * Browser-pure — no Node.js APIs. The encoder requires a browser runtime with
+ * SharedArrayBuffer support (normally supplied via COOP/COEP headers).
  *
  * Uses @ffmpeg/ffmpeg for H.264 encoding and optional AAC audio muxing.
  */
@@ -217,4 +269,4 @@ declare function audioBitrateArg(quality: VideoQuality): string;
  */
 declare function framesToMp4Wasm(frames: Uint8Array[], audio: Uint8Array | null, options?: VideoExportOptions): Promise<EncoderResult>;
 
-export { type AudioTimelineClip, type EncoderResult, ORIENTATION_DIMENSIONS, QUALITY_PRESETS, type QualityPreset, type RenderHtmlOptions, type VideoExportOptions, type VideoOrientation, type VideoQuality, audioBitrateArg, bitrateForQuality, computeAudioTimeline, ffmpegVideoQualityArgs, framesToMp4Wasm, generateRenderHtml, resolveDimensions };
+export { type AudioTimelineClip, type EncoderResult, type FfmpegWasmLoadConfig, type GifDither, type GifFilterOptions, type GifOutputOptions, ORIENTATION_DIMENSIONS, QUALITY_PRESETS, type QualityPreset, type RenderHtmlOptions, type VideoExportOptions, type VideoOrientation, type VideoQuality, audioBitrateArg, bitrateForQuality, computeAudioTimeline, ffmpegAudioMuxArgs, ffmpegGifFilterGraph, ffmpegGifOutputArgs, ffmpegVideoQualityArgs, framesToMp4Wasm, generateRenderHtml, resolveDimensions, validateVideoExportOptions };

package/dist/index.js

@@ -12,7 +12,27 @@ var ORIENTATION_DIMENSIONS = {
   landscape: { width: 1920, height: 1080 },
   portrait: { width: 1080, height: 1920 }
 };
+function validateVideoExportOptions(options) {
+  if (options.fps !== void 0 && (!Number.isFinite(options.fps) || options.fps <= 0 || options.fps > 120)) {
+    throw new RangeError("Video FPS must be a finite number between 1 and 120.");
+  }
+  for (const [label, value] of [
+    ["width", options.width],
+    ["height", options.height]
+  ]) {
+    if (value !== void 0 && (!Number.isSafeInteger(value) || value <= 0)) {
+      throw new RangeError(`Video ${label} must be a positive integer.`);
+    }
+  }
+  if (options.quality !== void 0 && !Object.prototype.hasOwnProperty.call(QUALITY_PRESETS, options.quality)) {
+    throw new RangeError(`Unknown video quality: ${String(options.quality)}.`);
+  }
+  if (options.orientation !== void 0 && !Object.prototype.hasOwnProperty.call(ORIENTATION_DIMENSIONS, options.orientation)) {
+    throw new RangeError(`Unknown video orientation: ${String(options.orientation)}.`);
+  }
+}
 function resolveDimensions(options) {
+  validateVideoExportOptions(options);
   const orientation = options.orientation ?? "landscape";
   const defaults = ORIENTATION_DIMENSIONS[orientation];
   return {
@@ -83,7 +103,15 @@ function escapeHtml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 function generateRenderHtml(doc, options) {
-  const { playerScript, images, audio, width = 1920, height = 1080, captionStyle } = options;
+  const {
+    playerScript,
+    images,
+    audio,
+    width = 1920,
+    height = 1080,
+    captionStyle,
+    animationsEnabled = true
+  } = options;
   const imageMap = {};
   if (images) {
     for (const [path, buffer] of images.entries()) {
@@ -121,13 +149,15 @@ html,body{margin:0;padding:0;width:${width}px;height:${height}px;overflow:hidden
   var doc = JSON.parse(${JSON.stringify(docJson)});
   var images = JSON.parse(${JSON.stringify(imageMapJson)});
   var audio = ${audioMapJson === "null" ? "null" : "JSON.parse(" + JSON.stringify(audioMapJson) + ")"};
-  SquisqPlayer.mount(document.getElementById("squisq-root"), doc, {
+  var root = document.getElementById("squisq-root");
+  SquisqPlayer.mount(root, doc, {
     mode: "slideshow",
     images: images,
     audio: audio,
     autoPlay: false,
     basePath: ".",
-    renderMode: true${captionStyle ? `,
+    renderMode: true,
+    animationsEnabled: ${JSON.stringify(animationsEnabled)}${captionStyle ? `,
     captionStyle: ${JSON.stringify(captionStyle)}` : ""}
   });
 })();
@@ -145,9 +175,51 @@ function audioBitrateArg(quality) {
   const preset = QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal;
   return `${preset.audioBitrate / 1e3}k`;
 }
+function ffmpegAudioMuxArgs(bitrate) {
+  return ["-c:a", "aac", "-b:a", String(bitrate), "-af", "apad", "-shortest"];
+}
+function ffmpegGifFilterGraph(options) {
+  const { width, height } = options;
+  const maxColors = options.maxColors ?? 256;
+  const dither = options.dither ?? "sierra2_4a";
+  const bayerScale = options.bayerScale ?? 3;
+  for (const [label, value] of [
+    ["width", width],
+    ["height", height]
+  ]) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      throw new RangeError(`GIF ${label} must be a positive integer.`);
+    }
+  }
+  if (!Number.isSafeInteger(maxColors) || maxColors < 2 || maxColors > 256) {
+    throw new RangeError("GIF maxColors must be an integer between 2 and 256.");
+  }
+  if (!["bayer", "sierra2_4a", "none"].includes(dither)) {
+    throw new RangeError(`Unknown GIF dither: ${String(dither)}.`);
+  }
+  if (!Number.isSafeInteger(bayerScale) || bayerScale < 0 || bayerScale > 5) {
+    throw new RangeError("GIF bayerScale must be an integer between 0 and 5.");
+  }
+  const ditherArgs = dither === "bayer" ? `dither=bayer:bayer_scale=${bayerScale}` : `dither=${dither}`;
+  return `[0:v]scale=${width}:${height}:force_original_aspect_ratio=decrease:flags=lanczos,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2:black,split[gif_frames][gif_palette_source];[gif_palette_source]palettegen=stats_mode=diff:max_colors=${maxColors}:reserve_transparent=0[gif_palette];[gif_frames][gif_palette]paletteuse=${ditherArgs}:diff_mode=rectangle[gif_out]`;
+}
+function ffmpegGifOutputArgs(options) {
+  const loop = options.loop ?? 0;
+  if (!Number.isSafeInteger(loop) || loop < -1 || loop > 65535) {
+    throw new RangeError("GIF loop must be an integer between -1 and 65535.");
+  }
+  return [
+    "-filter_complex",
+    ffmpegGifFilterGraph(options),
+    "-map",
+    "[gif_out]",
+    "-an",
+    "-loop",
+    String(loop)
+  ];
+}
 
 // src/wasmEncoder.ts
-import { FFmpeg } from "@ffmpeg/ffmpeg";
 import { fetchFile } from "@ffmpeg/util";
 async function framesToMp4Wasm(frames, audio, options = {}) {
   const fps = options.fps ?? 30;
@@ -157,61 +229,74 @@ async function framesToMp4Wasm(frames, audio, options = {}) {
   if (frames.length === 0) {
     throw new Error("No frames provided for encoding");
   }
+  const runtime = globalThis;
+  if (runtime.process?.versions?.node && typeof window === "undefined") {
+    throw new Error(
+      "framesToMp4Wasm is browser-only. In Node.js, use framesToMp4Native or framesToMp4NativeBytes from @bendyline/squisq-cli/api."
+    );
+  }
   const duration = frames.length / fps;
+  const { FFmpeg } = await import("@ffmpeg/ffmpeg");
   const ffmpeg = new FFmpeg();
-  ffmpeg.on("progress", ({ progress }) => {
-    if (onProgress) {
-      const percent = Math.round(progress * 100);
-      onProgress(Math.min(percent, 99), "encoding");
+  try {
+    ffmpeg.on("progress", ({ progress }) => {
+      if (onProgress) {
+        const percent = Math.round(progress * 100);
+        onProgress(Math.min(percent, 99), "encoding");
+      }
+    });
+    await ffmpeg.load(options.ffmpegWasm);
+    onProgress?.(0, "writing frames");
+    const padLen = String(frames.length).length;
+    for (let i = 0; i < frames.length; i++) {
+      const name = `frame-${String(i + 1).padStart(padLen, "0")}.png`;
+      await ffmpeg.writeFile(name, frames[i]);
+      if (onProgress && i % 10 === 0) {
+        onProgress(Math.round(i / frames.length * 40), "writing frames");
+      }
     }
-  });
-  await ffmpeg.load();
-  onProgress?.(0, "writing frames");
-  const padLen = String(frames.length).length;
-  for (let i = 0; i < frames.length; i++) {
-    const name = `frame-${String(i + 1).padStart(padLen, "0")}.png`;
-    await ffmpeg.writeFile(name, frames[i]);
-    if (onProgress && i % 10 === 0) {
-      onProgress(Math.round(i / frames.length * 40), "writing frames");
+    if (audio) {
+      await ffmpeg.writeFile("audio-input", audio);
     }
+    onProgress?.(40, "encoding");
+    const padPattern = `frame-%0${padLen}d.png`;
+    const args = ["-y", "-framerate", String(fps), "-i", padPattern];
+    if (audio) {
+      args.push("-i", "audio-input");
+    }
+    args.push(
+      "-c:v",
+      "libx264",
+      ...ffmpegVideoQualityArgs(quality),
+      "-pix_fmt",
+      "yuv420p",
+      "-vf",
+      `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2`
+    );
+    if (audio) {
+      args.push(...ffmpegAudioMuxArgs(audioBitrateArg(quality)));
+    }
+    args.push("output.mp4");
+    const exitCode = await ffmpeg.exec(args);
+    if (exitCode !== 0) {
+      throw new Error(`ffmpeg.wasm failed with exit code ${exitCode}`);
+    }
+    onProgress?.(95, "reading output");
+    const data = await ffmpeg.readFile("output.mp4");
+    for (let i = 0; i < frames.length; i++) {
+      const name = `frame-${String(i + 1).padStart(padLen, "0")}.png`;
+      await ffmpeg.deleteFile(name);
+    }
+    if (audio) {
+      await ffmpeg.deleteFile("audio-input");
+    }
+    await ffmpeg.deleteFile("output.mp4");
+    onProgress?.(100, "done");
+    const outputData = data instanceof Uint8Array ? data : new TextEncoder().encode(data);
+    return { data: outputData, duration };
+  } finally {
+    ffmpeg.terminate();
   }
-  if (audio) {
-    await ffmpeg.writeFile("audio-input", audio);
-  }
-  onProgress?.(40, "encoding");
-  const padPattern = `frame-%0${padLen}d.png`;
-  const args = ["-y", "-framerate", String(fps), "-i", padPattern];
-  if (audio) {
-    args.push("-i", "audio-input");
-  }
-  args.push(
-    "-c:v",
-    "libx264",
-    ...ffmpegVideoQualityArgs(quality),
-    "-pix_fmt",
-    "yuv420p",
-    "-vf",
-    `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2`
-  );
-  if (audio) {
-    args.push("-c:a", "aac", "-b:a", audioBitrateArg(quality), "-shortest");
-  }
-  args.push("output.mp4");
-  await ffmpeg.exec(args);
-  onProgress?.(95, "reading output");
-  const data = await ffmpeg.readFile("output.mp4");
-  for (let i = 0; i < frames.length; i++) {
-    const name = `frame-${String(i + 1).padStart(padLen, "0")}.png`;
-    await ffmpeg.deleteFile(name);
-  }
-  if (audio) {
-    await ffmpeg.deleteFile("audio-input");
-  }
-  await ffmpeg.deleteFile("output.mp4");
-  ffmpeg.terminate();
-  onProgress?.(100, "done");
-  const outputData = data instanceof Uint8Array ? data : new TextEncoder().encode(data);
-  return { data: outputData, duration };
 }
 export {
   ORIENTATION_DIMENSIONS,
@@ -220,9 +305,13 @@ export {
   bitrateForQuality,
   computeAudioTimeline,
   fetchFile,
+  ffmpegAudioMuxArgs,
+  ffmpegGifFilterGraph,
+  ffmpegGifOutputArgs,
   ffmpegVideoQualityArgs,
   framesToMp4Wasm,
   generateRenderHtml,
-  resolveDimensions
+  resolveDimensions,
+  validateVideoExportOptions
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/audioTimeline.ts","../src/renderHtml.ts","../src/ffmpegArgs.ts","../src/wasmEncoder.ts"],"sourcesContent":["/**\n * Video Export Types\n *\n * Shared type definitions for video encoding and render HTML generation.\n * Used by both the browser-based encoder and the CLI native encoder.\n */\n\n/**\n * Video quality preset.\n * Controls the H.264 encoding speed/quality trade-off and constant rate factor.\n *\n * - draft:  ultrafast preset, CRF 28 — fast encode, lower quality (~1-2 Mbps)\n * - normal: medium preset, CRF 23 — balanced (~3-5 Mbps)\n * - high:   slow preset, CRF 18 — best quality, slowest (~8-12 Mbps)\n */\nexport type VideoQuality = 'draft' | 'normal' | 'high';\n\n/** Viewport orientation for video output. */\nexport type VideoOrientation = 'landscape' | 'portrait';\n\n/** Encoding preset parameters mapped from VideoQuality. */\nexport interface QualityPreset {\n  /** FFmpeg -preset value (ultrafast, medium, slow) */\n  preset: string;\n  /** FFmpeg -crf value (lower = higher quality, 0-51 range) */\n  crf: number;\n  /**\n   * Bits per pixel for WebCodecs bitrate targeting.\n   * Target bitrate = width * height * bitsPerPixel (see {@link bitrateForQuality}).\n   * These values reproduce the historical per-quality formula exactly:\n   * the old code used a `width * height * 4` baseline, halved for draft and\n   * doubled for high — i.e. 2 / 4 / 8 bits per pixel.\n   */\n  bitsPerPixel: number;\n  /** Target AAC audio bitrate in bits/sec for muxed audio tracks. */\n  audioBitrate: number;\n}\n\n/** Quality preset lookup — shared between wasm and native encoders. */\nexport const QUALITY_PRESETS: Record<VideoQuality, QualityPreset> = {\n  draft: { preset: 'ultrafast', crf: 28, bitsPerPixel: 2, audioBitrate: 96_000 },\n  normal: { preset: 'medium', crf: 23, bitsPerPixel: 4, audioBitrate: 128_000 },\n  high: { preset: 'slow', crf: 18, bitsPerPixel: 8, audioBitrate: 192_000 },\n};\n\n/**\n * Target H.264 bitrate (bits/sec) for a given quality at a given resolution.\n *\n * Computes `width * height * preset.bitsPerPixel`. With bitsPerPixel of\n * 2 / 4 / 8 (draft / normal / high) this is numerically identical to the\n * legacy formula (`width * height * 4` baseline, ×0.5 for draft, ×2 for high)\n * that previously lived in both the main-thread and worker WebCodecs encoders.\n * The single source of truth now lives here so every encode path agrees.\n */\nexport function bitrateForQuality(q: VideoQuality, width: number, height: number): number {\n  const preset = QUALITY_PRESETS[q] ?? QUALITY_PRESETS.normal;\n  return Math.round(width * height * preset.bitsPerPixel);\n}\n\n/** Viewport dimensions for each orientation. */\nexport const ORIENTATION_DIMENSIONS: Record<VideoOrientation, { width: number; height: number }> = {\n  landscape: { width: 1920, height: 1080 },\n  portrait: { width: 1080, height: 1920 },\n};\n\n/** Options for video export encoding. */\nexport interface VideoExportOptions {\n  /** Frames per second (default: 30) */\n  fps?: number;\n  /** Video width in pixels (default: based on orientation) */\n  width?: number;\n  /** Video height in pixels (default: based on orientation) */\n  height?: number;\n  /** Encoding quality preset (default: 'normal') */\n  quality?: VideoQuality;\n  /** Viewport orientation (default: 'landscape') */\n  orientation?: VideoOrientation;\n  /**\n   * Progress callback. Called during encoding with completion percentage and phase description.\n   * @param percent - 0-100 completion percentage\n   * @param phase - Human-readable description of current phase (e.g., 'encoding', 'muxing')\n   */\n  onProgress?: (percent: number, phase: string) => void;\n}\n\n/** Result from the wasm encoder. */\nexport interface EncoderResult {\n  /** MP4 file bytes */\n  data: Uint8Array;\n  /** Video duration in seconds */\n  duration: number;\n}\n\n/**\n * Resolve dimensions from options, applying orientation defaults.\n */\nexport function resolveDimensions(options: VideoExportOptions): {\n  width: number;\n  height: number;\n} {\n  const orientation = options.orientation ?? 'landscape';\n  const defaults = ORIENTATION_DIMENSIONS[orientation];\n  return {\n    width: options.width ?? defaults.width,\n    height: options.height ?? defaults.height,\n  };\n}\n","/**\n * audioTimeline — Pure scheduling of a doc's audio onto the export timeline.\n *\n * Browser-pure and Node-testable: turns a {@link Doc} into a flat list of\n * absolute-timed {@link AudioTimelineClip}s. This is the single source of\n * truth the browser MP4 export uses to place audio, and it deliberately\n * replicates the exact schedule math the CLI mix path uses so both agree:\n *\n *  - Narration segments (`doc.audio.segments[]`) are laid **sequentially**,\n *    each starting where the previous one ended — mirroring the CLI, which\n *    concatenates the segment files in order.\n *  - Timed media clips (`block.media` + `doc.documentMedia`) are placed at\n *    their **absolute** doc-timeline positions via the shared\n *    `resolveMediaSchedule()` helper (the same one the CLI calls), honouring\n *    each clip's trim window (`sourceIn` / `absoluteEnd - absoluteStart`).\n *  - Every start time is shifted by `coverPreRoll` so a cover pre-roll padding\n *    (silent leading frames) keeps audio in sync.\n */\n\nimport type { Doc } from '@bendyline/squisq/schemas';\nimport { resolveMediaSchedule } from '@bendyline/squisq/schemas';\n\n/** One audio source placed on the absolute export timeline. */\nexport interface AudioTimelineClip {\n  /** Source path (mp3/webm/mp4/…), relative to the doc's media dir. */\n  src: string;\n  /** Absolute second on the export timeline where this clip starts. */\n  startSec: number;\n  /** In-point within the source file to begin playback from. */\n  sourceInSec: number;\n  /** Played length in seconds (the trimmed window of the source). */\n  durationSec: number;\n}\n\n/**\n * Flatten a doc's narration + timed-media audio into absolute-timed clips.\n *\n * Pure — depends only on `doc` (and reuses `resolveMediaSchedule` from core so\n * the browser export and the CLI mix never drift). Returns `[]` for a doc with\n * no audio at all.\n *\n * @param doc - The document to schedule audio for.\n * @param coverPreRoll - Leading silent padding (seconds) added ahead of every\n *   clip, matching the cover-slide pre-roll frames. Default 0.\n */\nexport function computeAudioTimeline(doc: Doc, coverPreRoll = 0): AudioTimelineClip[] {\n  const preRoll = coverPreRoll > 0 ? coverPreRoll : 0;\n  const clips: AudioTimelineClip[] = [];\n\n  // ── Narration: laid sequentially (matches the CLI's ordered concat). ──\n  let cursor = 0;\n  for (const seg of doc.audio?.segments ?? []) {\n    const durationSec = Math.max(0, seg.duration);\n    if (durationSec > 0 && seg.src) {\n      clips.push({ src: seg.src, startSec: cursor + preRoll, sourceInSec: 0, durationSec });\n    }\n    cursor += durationSec;\n  }\n\n  // ── Timed media clips: absolute positions from the shared schedule. ──\n  for (const clip of resolveMediaSchedule(doc)) {\n    if (clip.kind !== 'audio') continue;\n    const durationSec = Math.max(0, clip.absoluteEnd - clip.absoluteStart);\n    if (durationSec <= 0 || !clip.src) continue;\n    clips.push({\n      src: clip.src,\n      startSec: clip.absoluteStart + preRoll,\n      sourceInSec: clip.sourceIn,\n      durationSec,\n    });\n  }\n\n  return clips;\n}\n","/**\n * Render HTML Generation for Video Frame Capture\n *\n * Generates a self-contained HTML document that loads the SquisqPlayer standalone\n * bundle in renderMode, embedding all images and audio as base64 data URIs.\n *\n * The generated page exposes `window.seekTo(time)`, `window.getDuration()`, etc.\n * via the SquisqRenderAPI, enabling Playwright (or any headless browser) to step\n * through frames and capture screenshots.\n *\n * Browser-pure: uses only btoa() and Uint8Array — no Node.js APIs.\n */\n\nimport type { Doc } from '@bendyline/squisq/schemas';\n\n// ── Types ──────────────────────────────────────────────────────────\n\nexport interface RenderHtmlOptions {\n  /** The IIFE player bundle source code (from PLAYER_BUNDLE) */\n  playerScript: string;\n\n  /**\n   * Map of relative image paths (as they appear in the Doc) to binary data.\n   * Converted to base64 data URIs and embedded in the HTML.\n   */\n  images?: Map<string, ArrayBuffer>;\n\n  /**\n   * Map of audio segment names/paths to binary audio data.\n   * Converted to base64 data URIs and embedded in the HTML.\n   */\n  audio?: Map<string, ArrayBuffer>;\n\n  /** Viewport width in CSS pixels (default: 1920) */\n  width?: number;\n\n  /** Viewport height in CSS pixels (default: 1080) */\n  height?: number;\n\n  /** Caption style for the rendered video. Omit for no captions. */\n  captionStyle?: 'standard' | 'social';\n}\n\n// ── MIME Detection ─────────────────────────────────────────────────\n\nconst MIME_MAP: Record<string, string> = {\n  jpg: 'image/jpeg',\n  jpeg: 'image/jpeg',\n  png: 'image/png',\n  gif: 'image/gif',\n  webp: 'image/webp',\n  svg: 'image/svg+xml',\n  bmp: 'image/bmp',\n  avif: 'image/avif',\n  mp3: 'audio/mpeg',\n  wav: 'audio/wav',\n  ogg: 'audio/ogg',\n  mp4: 'video/mp4',\n  webm: 'video/webm',\n};\n\nfunction inferMimeType(filename: string): string {\n  const ext = filename.split('.').pop()?.toLowerCase() ?? '';\n  return MIME_MAP[ext] ?? 'application/octet-stream';\n}\n\n// ── Base64 Encoding (browser-pure) ────────────────────────────────\n\n/**\n * Convert an ArrayBuffer to a base64 data URI.\n * Uses only standard Web APIs (Uint8Array + btoa).\n */\nfunction arrayBufferToDataUrl(buffer: ArrayBuffer, mimeType: string): string {\n  const bytes = new Uint8Array(buffer);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return `data:${mimeType};base64,${btoa(binary)}`;\n}\n\n// ── Escaping ───────────────────────────────────────────────────────\n\n/**\n * Prevent `</script>` from prematurely closing the script tag.\n */\nfunction escapeForScript(str: string): string {\n  return str.replace(/<\\/(script)/gi, '<\\\\/$1');\n}\n\n/** Escape HTML special characters. */\nfunction escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\n// ── HTML Generation ────────────────────────────────────────────────\n\n/**\n * Generate a self-contained HTML document for headless video frame capture.\n *\n * The page mounts the SquisqPlayer in renderMode, which exposes the\n * SquisqRenderAPI on `window` (seekTo, getDuration, getCaptions, etc.).\n *\n * @param doc - The Doc to render\n * @param options - Render HTML options including player script and media\n * @returns Complete HTML string ready to be loaded in a headless browser\n */\nexport function generateRenderHtml(doc: Doc, options: RenderHtmlOptions): string {\n  const { playerScript, images, audio, width = 1920, height = 1080, captionStyle } = options;\n\n  // Build base64 image map\n  const imageMap: Record<string, string> = {};\n  if (images) {\n    for (const [path, buffer] of images.entries()) {\n      imageMap[path] = arrayBufferToDataUrl(buffer, inferMimeType(path));\n    }\n  }\n\n  // Build base64 audio map\n  const audioMap: Record<string, string> = {};\n  let hasAudio = false;\n  if (audio) {\n    for (const [name, buffer] of audio.entries()) {\n      audioMap[name] = arrayBufferToDataUrl(buffer, inferMimeType(name));\n      hasAudio = true;\n    }\n  }\n\n  const docJson = escapeForScript(JSON.stringify(doc));\n  const imageMapJson = escapeForScript(JSON.stringify(imageMap));\n  const audioMapJson = hasAudio ? escapeForScript(JSON.stringify(audioMap)) : 'null';\n\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=${width}, height=${height}\">\n<title>${escapeHtml('Squisq Video Render')}</title>\n<style>\n*,*::before,*::after{box-sizing:border-box}\nhtml,body{margin:0;padding:0;width:${width}px;height:${height}px;overflow:hidden;background:#000}\n#squisq-root{width:${width}px;height:${height}px;display:flex;align-items:center;justify-content:center}\n</style>\n</head>\n<body>\n<div id=\"squisq-root\"></div>\n<script>${escapeForScript(playerScript)}</script>\n<script>\n(function(){\n  var doc = JSON.parse(${JSON.stringify(docJson)});\n  var images = JSON.parse(${JSON.stringify(imageMapJson)});\n  var audio = ${audioMapJson === 'null' ? 'null' : 'JSON.parse(' + JSON.stringify(audioMapJson) + ')'};\n  SquisqPlayer.mount(document.getElementById(\"squisq-root\"), doc, {\n    mode: \"slideshow\",\n    images: images,\n    audio: audio,\n    autoPlay: false,\n    basePath: \".\",\n    renderMode: true${captionStyle ? `,\\n    captionStyle: ${JSON.stringify(captionStyle)}` : ''}\n  });\n})();\n</script>\n</body>\n</html>`;\n}\n","/**\n * FFmpeg argument builders — the single source of truth for translating a\n * {@link VideoQuality} into ffmpeg CLI flags. Shared verbatim by every\n * ffmpeg-based encode path: the wasm encoder ({@link ./wasmEncoder}), the\n * video-react fallback worker, and the CLI native encoder. Deriving these\n * from {@link QUALITY_PRESETS} keeps the browser and CLI byte-for-byte aligned.\n *\n * Pure, dependency-free, and unit-testable in isolation (the actual ffmpeg\n * invocations live behind wasm/child-process boundaries that are awkward to\n * exercise directly).\n */\n\nimport { QUALITY_PRESETS, type VideoQuality } from './types.js';\n\n/**\n * H.264 speed/quality flags (`-preset`, `-crf`) for a quality level.\n * @example ffmpegVideoQualityArgs('high') // ['-preset', 'slow', '-crf', '18']\n */\nexport function ffmpegVideoQualityArgs(quality: VideoQuality): string[] {\n  const preset = QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal;\n  return ['-preset', preset.preset, '-crf', String(preset.crf)];\n}\n\n/**\n * AAC audio-bitrate flag value in ffmpeg's `k` shorthand for a quality level.\n * @example audioBitrateArg('high') // '192k'\n */\nexport function audioBitrateArg(quality: VideoQuality): string {\n  const preset = QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal;\n  return `${preset.audioBitrate / 1000}k`;\n}\n","/**\n * WASM Video Encoder\n *\n * Encodes PNG frame screenshots into an MP4 video using ffmpeg.wasm.\n * Browser-pure — no Node.js APIs. Works in any environment with SharedArrayBuffer\n * support (browsers with COOP/COEP headers, or Node 18+).\n *\n * Uses @ffmpeg/ffmpeg for H.264 encoding and optional AAC audio muxing.\n */\n\nimport { FFmpeg } from '@ffmpeg/ffmpeg';\nimport { fetchFile } from '@ffmpeg/util';\n\nimport type { VideoExportOptions, EncoderResult } from './types.js';\nimport { resolveDimensions } from './types.js';\nimport { ffmpegVideoQualityArgs, audioBitrateArg } from './ffmpegArgs.js';\n\n/**\n * Encode an array of PNG frame screenshots into an MP4 video.\n *\n * @param frames - Array of PNG image bytes (one per frame, in order)\n * @param audio - Optional WAV/MP3/AAC audio bytes to mux into the video\n * @param options - Encoding options (fps, quality, dimensions, progress)\n * @returns Encoded MP4 data and duration metadata\n */\nexport async function framesToMp4Wasm(\n  frames: Uint8Array[],\n  audio: Uint8Array | null,\n  options: VideoExportOptions = {},\n): Promise<EncoderResult> {\n  const fps = options.fps ?? 30;\n  const quality = options.quality ?? 'normal';\n  const { width, height } = resolveDimensions(options);\n  const onProgress = options.onProgress;\n\n  if (frames.length === 0) {\n    throw new Error('No frames provided for encoding');\n  }\n\n  const duration = frames.length / fps;\n\n  // Initialize ffmpeg.wasm\n  const ffmpeg = new FFmpeg();\n\n  ffmpeg.on('progress', ({ progress }) => {\n    if (onProgress) {\n      const percent = Math.round(progress * 100);\n      onProgress(Math.min(percent, 99), 'encoding');\n    }\n  });\n\n  await ffmpeg.load();\n\n  onProgress?.(0, 'writing frames');\n\n  // Write frame PNGs to virtual filesystem\n  const padLen = String(frames.length).length;\n  for (let i = 0; i < frames.length; i++) {\n    const name = `frame-${String(i + 1).padStart(padLen, '0')}.png`;\n    await ffmpeg.writeFile(name, frames[i]);\n\n    // Report frame-write progress (0-40% of total)\n    if (onProgress && i % 10 === 0) {\n      onProgress(Math.round((i / frames.length) * 40), 'writing frames');\n    }\n  }\n\n  // Write audio if provided\n  if (audio) {\n    await ffmpeg.writeFile('audio-input', audio);\n  }\n\n  onProgress?.(40, 'encoding');\n\n  // Build ffmpeg command\n  const padPattern = `frame-%0${padLen}d.png`;\n  const args = ['-y', '-framerate', String(fps), '-i', padPattern];\n\n  // Add audio input\n  if (audio) {\n    args.push('-i', 'audio-input');\n  }\n\n  // Video encoding settings\n  args.push(\n    '-c:v',\n    'libx264',\n    ...ffmpegVideoQualityArgs(quality),\n    '-pix_fmt',\n    'yuv420p',\n    '-vf',\n    `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2`,\n  );\n\n  // Audio encoding\n  if (audio) {\n    args.push('-c:a', 'aac', '-b:a', audioBitrateArg(quality), '-shortest');\n  }\n\n  args.push('output.mp4');\n\n  // Run encoding\n  await ffmpeg.exec(args);\n\n  onProgress?.(95, 'reading output');\n\n  // Read the output file\n  const data = await ffmpeg.readFile('output.mp4');\n\n  // Cleanup virtual filesystem\n  for (let i = 0; i < frames.length; i++) {\n    const name = `frame-${String(i + 1).padStart(padLen, '0')}.png`;\n    await ffmpeg.deleteFile(name);\n  }\n  if (audio) {\n    await ffmpeg.deleteFile('audio-input');\n  }\n  await ffmpeg.deleteFile('output.mp4');\n\n  ffmpeg.terminate();\n\n  onProgress?.(100, 'done');\n\n  // ffmpeg.readFile returns Uint8Array for binary files\n  const outputData = data instanceof Uint8Array ? data : new TextEncoder().encode(data as string);\n\n  return { data: outputData, duration };\n}\n\n// Re-export fetchFile for convenience — consumers may need it to prepare audio bytes\nexport { fetchFile };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/audioTimeline.ts","../src/renderHtml.ts","../src/ffmpegArgs.ts","../src/wasmEncoder.ts"],"sourcesContent":["/**\n * Video Export Types\n *\n * Shared type definitions for video encoding and render HTML generation.\n * Used by both the browser-based encoder and the CLI native encoder.\n */\n\n/**\n * Video quality preset.\n * Controls the H.264 encoding speed/quality trade-off and constant rate factor.\n *\n * - draft:  ultrafast preset, CRF 28 — fast encode, lower quality (~1-2 Mbps)\n * - normal: medium preset, CRF 23 — balanced (~3-5 Mbps)\n * - high:   slow preset, CRF 18 — best quality, slowest (~8-12 Mbps)\n */\nexport type VideoQuality = 'draft' | 'normal' | 'high';\n\n/** Viewport orientation for video output. */\nexport type VideoOrientation = 'landscape' | 'portrait';\n\n/** Optional URLs for self-hosting or pinning ffmpeg.wasm runtime assets. */\nexport interface FfmpegWasmLoadConfig {\n  coreURL?: string;\n  wasmURL?: string;\n  workerURL?: string;\n  classWorkerURL?: string;\n}\n\n/** Encoding preset parameters mapped from VideoQuality. */\nexport interface QualityPreset {\n  /** FFmpeg -preset value (ultrafast, medium, slow) */\n  preset: string;\n  /** FFmpeg -crf value (lower = higher quality, 0-51 range) */\n  crf: number;\n  /**\n   * Bits per pixel for WebCodecs bitrate targeting.\n   * Target bitrate = width * height * bitsPerPixel (see {@link bitrateForQuality}).\n   * These values reproduce the historical per-quality formula exactly:\n   * the old code used a `width * height * 4` baseline, halved for draft and\n   * doubled for high — i.e. 2 / 4 / 8 bits per pixel.\n   */\n  bitsPerPixel: number;\n  /** Target AAC audio bitrate in bits/sec for muxed audio tracks. */\n  audioBitrate: number;\n}\n\n/** Quality preset lookup — shared between wasm and native encoders. */\nexport const QUALITY_PRESETS: Record<VideoQuality, QualityPreset> = {\n  draft: { preset: 'ultrafast', crf: 28, bitsPerPixel: 2, audioBitrate: 96_000 },\n  normal: { preset: 'medium', crf: 23, bitsPerPixel: 4, audioBitrate: 128_000 },\n  high: { preset: 'slow', crf: 18, bitsPerPixel: 8, audioBitrate: 192_000 },\n};\n\n/**\n * Target H.264 bitrate (bits/sec) for a given quality at a given resolution.\n *\n * Computes `width * height * preset.bitsPerPixel`. With bitsPerPixel of\n * 2 / 4 / 8 (draft / normal / high) this is numerically identical to the\n * legacy formula (`width * height * 4` baseline, ×0.5 for draft, ×2 for high)\n * that previously lived in both the main-thread and worker WebCodecs encoders.\n * The single source of truth now lives here so every encode path agrees.\n */\nexport function bitrateForQuality(q: VideoQuality, width: number, height: number): number {\n  const preset = QUALITY_PRESETS[q] ?? QUALITY_PRESETS.normal;\n  return Math.round(width * height * preset.bitsPerPixel);\n}\n\n/** Viewport dimensions for each orientation. */\nexport const ORIENTATION_DIMENSIONS: Record<VideoOrientation, { width: number; height: number }> = {\n  landscape: { width: 1920, height: 1080 },\n  portrait: { width: 1080, height: 1920 },\n};\n\n/** Options for video export encoding. */\nexport interface VideoExportOptions {\n  /** Frames per second (default: 30) */\n  fps?: number;\n  /** Video width in pixels (default: based on orientation) */\n  width?: number;\n  /** Video height in pixels (default: based on orientation) */\n  height?: number;\n  /** Encoding quality preset (default: 'normal') */\n  quality?: VideoQuality;\n  /** Viewport orientation (default: 'landscape') */\n  orientation?: VideoOrientation;\n  /** Optional self-hosted ffmpeg.wasm assets for offline/CSP-controlled use. */\n  ffmpegWasm?: FfmpegWasmLoadConfig;\n  /**\n   * Progress callback. Called during encoding with completion percentage and phase description.\n   * @param percent - 0-100 completion percentage\n   * @param phase - Human-readable description of current phase (e.g., 'encoding', 'muxing')\n   */\n  onProgress?: (percent: number, phase: string) => void;\n}\n\n/** Result from the wasm encoder. */\nexport interface EncoderResult {\n  /** MP4 file bytes */\n  data: Uint8Array;\n  /** Video duration in seconds */\n  duration: number;\n}\n\n/** Fail fast with actionable errors before launching an encoder or browser. */\nexport function validateVideoExportOptions(options: VideoExportOptions): void {\n  if (\n    options.fps !== undefined &&\n    (!Number.isFinite(options.fps) || options.fps <= 0 || options.fps > 120)\n  ) {\n    throw new RangeError('Video FPS must be a finite number between 1 and 120.');\n  }\n  for (const [label, value] of [\n    ['width', options.width],\n    ['height', options.height],\n  ] as const) {\n    if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {\n      throw new RangeError(`Video ${label} must be a positive integer.`);\n    }\n  }\n  if (\n    options.quality !== undefined &&\n    !Object.prototype.hasOwnProperty.call(QUALITY_PRESETS, options.quality)\n  ) {\n    throw new RangeError(`Unknown video quality: ${String(options.quality)}.`);\n  }\n  if (\n    options.orientation !== undefined &&\n    !Object.prototype.hasOwnProperty.call(ORIENTATION_DIMENSIONS, options.orientation)\n  ) {\n    throw new RangeError(`Unknown video orientation: ${String(options.orientation)}.`);\n  }\n}\n\n/**\n * Resolve dimensions from options, applying orientation defaults.\n */\nexport function resolveDimensions(options: VideoExportOptions): {\n  width: number;\n  height: number;\n} {\n  validateVideoExportOptions(options);\n  const orientation = options.orientation ?? 'landscape';\n  const defaults = ORIENTATION_DIMENSIONS[orientation];\n  return {\n    width: options.width ?? defaults.width,\n    height: options.height ?? defaults.height,\n  };\n}\n","/**\n * audioTimeline — Pure scheduling of a doc's audio onto the export timeline.\n *\n * Browser-pure and Node-testable: turns a {@link Doc} into a flat list of\n * absolute-timed {@link AudioTimelineClip}s. This is the single source of\n * truth the browser MP4 export uses to place audio, and it deliberately\n * replicates the exact schedule math the CLI mix path uses so both agree:\n *\n *  - Narration segments (`doc.audio.segments[]`) are laid **sequentially**,\n *    each starting where the previous one ended — mirroring the CLI, which\n *    concatenates the segment files in order.\n *  - Timed media clips (`block.media` + `doc.documentMedia`) are placed at\n *    their **absolute** doc-timeline positions via the shared\n *    `resolveMediaSchedule()` helper (the same one the CLI calls), honouring\n *    each clip's trim window (`sourceIn` / `absoluteEnd - absoluteStart`).\n *  - Every start time is shifted by `coverPreRoll` so a cover pre-roll padding\n *    (silent leading frames) keeps audio in sync.\n */\n\nimport type { Doc } from '@bendyline/squisq/schemas';\nimport { resolveMediaSchedule } from '@bendyline/squisq/schemas';\n\n/** One audio source placed on the absolute export timeline. */\nexport interface AudioTimelineClip {\n  /** Source path (mp3/webm/mp4/…), relative to the doc's media dir. */\n  src: string;\n  /** Absolute second on the export timeline where this clip starts. */\n  startSec: number;\n  /** In-point within the source file to begin playback from. */\n  sourceInSec: number;\n  /** Played length in seconds (the trimmed window of the source). */\n  durationSec: number;\n}\n\n/**\n * Flatten a doc's narration + timed-media audio into absolute-timed clips.\n *\n * Pure — depends only on `doc` (and reuses `resolveMediaSchedule` from core so\n * the browser export and the CLI mix never drift). Returns `[]` for a doc with\n * no audio at all.\n *\n * @param doc - The document to schedule audio for.\n * @param coverPreRoll - Leading silent padding (seconds) added ahead of every\n *   clip, matching the cover-slide pre-roll frames. Default 0.\n */\nexport function computeAudioTimeline(doc: Doc, coverPreRoll = 0): AudioTimelineClip[] {\n  const preRoll = coverPreRoll > 0 ? coverPreRoll : 0;\n  const clips: AudioTimelineClip[] = [];\n\n  // ── Narration: laid sequentially (matches the CLI's ordered concat). ──\n  let cursor = 0;\n  for (const seg of doc.audio?.segments ?? []) {\n    const durationSec = Math.max(0, seg.duration);\n    if (durationSec > 0 && seg.src) {\n      clips.push({ src: seg.src, startSec: cursor + preRoll, sourceInSec: 0, durationSec });\n    }\n    cursor += durationSec;\n  }\n\n  // ── Timed media clips: absolute positions from the shared schedule. ──\n  for (const clip of resolveMediaSchedule(doc)) {\n    if (clip.kind !== 'audio') continue;\n    const durationSec = Math.max(0, clip.absoluteEnd - clip.absoluteStart);\n    if (durationSec <= 0 || !clip.src) continue;\n    clips.push({\n      src: clip.src,\n      startSec: clip.absoluteStart + preRoll,\n      sourceInSec: clip.sourceIn,\n      durationSec,\n    });\n  }\n\n  return clips;\n}\n","/**\n * Render HTML Generation for Video Frame Capture\n *\n * Generates a self-contained HTML document that loads the SquisqPlayer standalone\n * bundle in renderMode, embedding all images and audio as base64 data URIs.\n *\n * The generated page mounts one standalone player whose instance handle is\n * available through `SquisqPlayer.getHandle(root)`. Headless callers use that\n * handle's render API to step through frames and capture screenshots.\n *\n * Browser-pure: uses only btoa() and Uint8Array — no Node.js APIs.\n */\n\nimport type { Doc } from '@bendyline/squisq/schemas';\n\n// ── Types ──────────────────────────────────────────────────────────\n\nexport interface RenderHtmlOptions {\n  /** The IIFE player bundle source code (from PLAYER_BUNDLE) */\n  playerScript: string;\n\n  /**\n   * Map of relative image paths (as they appear in the Doc) to binary data.\n   * Converted to base64 data URIs and embedded in the HTML.\n   */\n  images?: Map<string, ArrayBuffer>;\n\n  /**\n   * Map of audio segment names/paths to binary audio data.\n   * Converted to base64 data URIs and embedded in the HTML.\n   */\n  audio?: Map<string, ArrayBuffer>;\n\n  /** Viewport width in CSS pixels (default: 1920) */\n  width?: number;\n\n  /** Viewport height in CSS pixels (default: 1080) */\n  height?: number;\n\n  /** Caption style for the rendered video. Omit for no captions. */\n  captionStyle?: 'standard' | 'social';\n\n  /**\n   * Whether Squisq layer animations and block transitions are rendered.\n   * Defaults to true. Embedded/timed media and document timing are unaffected.\n   */\n  animationsEnabled?: boolean;\n}\n\n// ── MIME Detection ─────────────────────────────────────────────────\n\nconst MIME_MAP: Record<string, string> = {\n  jpg: 'image/jpeg',\n  jpeg: 'image/jpeg',\n  png: 'image/png',\n  gif: 'image/gif',\n  webp: 'image/webp',\n  svg: 'image/svg+xml',\n  bmp: 'image/bmp',\n  avif: 'image/avif',\n  mp3: 'audio/mpeg',\n  wav: 'audio/wav',\n  ogg: 'audio/ogg',\n  mp4: 'video/mp4',\n  webm: 'video/webm',\n};\n\nfunction inferMimeType(filename: string): string {\n  const ext = filename.split('.').pop()?.toLowerCase() ?? '';\n  return MIME_MAP[ext] ?? 'application/octet-stream';\n}\n\n// ── Base64 Encoding (browser-pure) ────────────────────────────────\n\n/**\n * Convert an ArrayBuffer to a base64 data URI.\n * Uses only standard Web APIs (Uint8Array + btoa).\n */\nfunction arrayBufferToDataUrl(buffer: ArrayBuffer, mimeType: string): string {\n  const bytes = new Uint8Array(buffer);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return `data:${mimeType};base64,${btoa(binary)}`;\n}\n\n// ── Escaping ───────────────────────────────────────────────────────\n\n/**\n * Prevent `</script>` from prematurely closing the script tag.\n */\nfunction escapeForScript(str: string): string {\n  return str.replace(/<\\/(script)/gi, '<\\\\/$1');\n}\n\n/** Escape HTML special characters. */\nfunction escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\n// ── HTML Generation ────────────────────────────────────────────────\n\n/**\n * Generate a self-contained HTML document for headless video frame capture.\n *\n * The page mounts the SquisqPlayer in renderMode. Call\n * `SquisqPlayer.getHandle(root)` to obtain this instance's render API.\n *\n * @param doc - The Doc to render\n * @param options - Render HTML options including player script and media\n * @returns Complete HTML string ready to be loaded in a headless browser\n */\nexport function generateRenderHtml(doc: Doc, options: RenderHtmlOptions): string {\n  const {\n    playerScript,\n    images,\n    audio,\n    width = 1920,\n    height = 1080,\n    captionStyle,\n    animationsEnabled = true,\n  } = options;\n\n  // Build base64 image map\n  const imageMap: Record<string, string> = {};\n  if (images) {\n    for (const [path, buffer] of images.entries()) {\n      imageMap[path] = arrayBufferToDataUrl(buffer, inferMimeType(path));\n    }\n  }\n\n  // Build base64 audio map\n  const audioMap: Record<string, string> = {};\n  let hasAudio = false;\n  if (audio) {\n    for (const [name, buffer] of audio.entries()) {\n      audioMap[name] = arrayBufferToDataUrl(buffer, inferMimeType(name));\n      hasAudio = true;\n    }\n  }\n\n  const docJson = escapeForScript(JSON.stringify(doc));\n  const imageMapJson = escapeForScript(JSON.stringify(imageMap));\n  const audioMapJson = hasAudio ? escapeForScript(JSON.stringify(audioMap)) : 'null';\n\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=${width}, height=${height}\">\n<title>${escapeHtml('Squisq Video Render')}</title>\n<style>\n*,*::before,*::after{box-sizing:border-box}\nhtml,body{margin:0;padding:0;width:${width}px;height:${height}px;overflow:hidden;background:#000}\n#squisq-root{width:${width}px;height:${height}px;display:flex;align-items:center;justify-content:center}\n</style>\n</head>\n<body>\n<div id=\"squisq-root\"></div>\n<script>${escapeForScript(playerScript)}</script>\n<script>\n(function(){\n  var doc = JSON.parse(${JSON.stringify(docJson)});\n  var images = JSON.parse(${JSON.stringify(imageMapJson)});\n  var audio = ${audioMapJson === 'null' ? 'null' : 'JSON.parse(' + JSON.stringify(audioMapJson) + ')'};\n  var root = document.getElementById(\"squisq-root\");\n  SquisqPlayer.mount(root, doc, {\n    mode: \"slideshow\",\n    images: images,\n    audio: audio,\n    autoPlay: false,\n    basePath: \".\",\n    renderMode: true,\n    animationsEnabled: ${JSON.stringify(animationsEnabled)}${captionStyle ? `,\\n    captionStyle: ${JSON.stringify(captionStyle)}` : ''}\n  });\n})();\n</script>\n</body>\n</html>`;\n}\n","/**\n * FFmpeg argument builders — the single source of truth for translating a\n * {@link VideoQuality} into ffmpeg CLI flags. Shared verbatim by every\n * ffmpeg-based encode path: the wasm encoder ({@link ./wasmEncoder}), the\n * video-react fallback worker, and the CLI native encoder. Deriving these\n * from {@link QUALITY_PRESETS} keeps the browser and CLI byte-for-byte aligned.\n *\n * Pure, dependency-free, and unit-testable in isolation (the actual ffmpeg\n * invocations live behind wasm/child-process boundaries that are awkward to\n * exercise directly).\n */\n\nimport { QUALITY_PRESETS, type VideoQuality } from './types.js';\n\n/** Dithering algorithms intentionally exposed by Squisq's GIF encoder. */\nexport type GifDither = 'bayer' | 'sierra2_4a' | 'none';\n\n/** Options for the shared palette-based animated GIF filter graph. */\nexport interface GifFilterOptions {\n  width: number;\n  height: number;\n  /** Palette size, from 2 through GIF's maximum of 256. */\n  maxColors?: number;\n  /** Palette dithering algorithm (default: `sierra2_4a`). */\n  dither?: GifDither;\n  /** Ordered Bayer strength, used only when `dither` is `bayer` (0-5). */\n  bayerScale?: number;\n}\n\n/** Options for GIF muxing in addition to the palette filter graph. */\nexport interface GifOutputOptions extends GifFilterOptions {\n  /** Number of repeats; 0 loops forever and -1 disables looping. */\n  loop?: number;\n}\n\n/**\n * H.264 speed/quality flags (`-preset`, `-crf`) for a quality level.\n * @example ffmpegVideoQualityArgs('high') // ['-preset', 'slow', '-crf', '18']\n */\nexport function ffmpegVideoQualityArgs(quality: VideoQuality): string[] {\n  const preset = QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal;\n  return ['-preset', preset.preset, '-crf', String(preset.crf)];\n}\n\n/**\n * AAC audio-bitrate flag value in ffmpeg's `k` shorthand for a quality level.\n * @example audioBitrateArg('high') // '192k'\n */\nexport function audioBitrateArg(quality: VideoQuality): string {\n  const preset = QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal;\n  return `${preset.audioBitrate / 1000}k`;\n}\n\n/**\n * AAC muxing flags that preserve the complete video timeline.\n *\n * `-shortest` by itself truncates video whenever narration ends early. Padding\n * the audio stream first makes the video stream the shortest input instead, so\n * audio longer than the video is trimmed while shorter audio becomes silence.\n */\nexport function ffmpegAudioMuxArgs(bitrate: string | number): string[] {\n  return ['-c:a', 'aac', '-b:a', String(bitrate), '-af', 'apad', '-shortest'];\n}\n\n/**\n * Build a high-quality, compression-friendly GIF palette filter graph.\n *\n * A single palette is derived from the parts of the frame that change, while\n * `diff_mode=rectangle` keeps error diffusion inside the changed rectangle so\n * static slide backgrounds remain byte-stable and compress efficiently.\n */\nexport function ffmpegGifFilterGraph(options: GifFilterOptions): string {\n  const { width, height } = options;\n  const maxColors = options.maxColors ?? 256;\n  const dither = options.dither ?? 'sierra2_4a';\n  const bayerScale = options.bayerScale ?? 3;\n\n  for (const [label, value] of [\n    ['width', width],\n    ['height', height],\n  ] as const) {\n    if (!Number.isSafeInteger(value) || value <= 0) {\n      throw new RangeError(`GIF ${label} must be a positive integer.`);\n    }\n  }\n  if (!Number.isSafeInteger(maxColors) || maxColors < 2 || maxColors > 256) {\n    throw new RangeError('GIF maxColors must be an integer between 2 and 256.');\n  }\n  if (!['bayer', 'sierra2_4a', 'none'].includes(dither)) {\n    throw new RangeError(`Unknown GIF dither: ${String(dither)}.`);\n  }\n  if (!Number.isSafeInteger(bayerScale) || bayerScale < 0 || bayerScale > 5) {\n    throw new RangeError('GIF bayerScale must be an integer between 0 and 5.');\n  }\n\n  const ditherArgs =\n    dither === 'bayer' ? `dither=bayer:bayer_scale=${bayerScale}` : `dither=${dither}`;\n  return (\n    `[0:v]scale=${width}:${height}:force_original_aspect_ratio=decrease:flags=lanczos,` +\n    `pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2:black,split[gif_frames][gif_palette_source];` +\n    `[gif_palette_source]palettegen=stats_mode=diff:max_colors=${maxColors}:reserve_transparent=0[gif_palette];` +\n    `[gif_frames][gif_palette]paletteuse=${ditherArgs}:diff_mode=rectangle[gif_out]`\n  );\n}\n\n/** Build the output-side FFmpeg arguments for an animated GIF. */\nexport function ffmpegGifOutputArgs(options: GifOutputOptions): string[] {\n  const loop = options.loop ?? 0;\n  if (!Number.isSafeInteger(loop) || loop < -1 || loop > 65_535) {\n    throw new RangeError('GIF loop must be an integer between -1 and 65535.');\n  }\n  return [\n    '-filter_complex',\n    ffmpegGifFilterGraph(options),\n    '-map',\n    '[gif_out]',\n    '-an',\n    '-loop',\n    String(loop),\n  ];\n}\n","/**\n * WASM Video Encoder\n *\n * Encodes PNG frame screenshots into an MP4 video using ffmpeg.wasm.\n * Browser-pure — no Node.js APIs. The encoder requires a browser runtime with\n * SharedArrayBuffer support (normally supplied via COOP/COEP headers).\n *\n * Uses @ffmpeg/ffmpeg for H.264 encoding and optional AAC audio muxing.\n */\n\nimport { fetchFile } from '@ffmpeg/util';\n\nimport type { VideoExportOptions, EncoderResult } from './types.js';\nimport { resolveDimensions } from './types.js';\nimport { ffmpegVideoQualityArgs, audioBitrateArg, ffmpegAudioMuxArgs } from './ffmpegArgs.js';\n\n/**\n * Encode an array of PNG frame screenshots into an MP4 video.\n *\n * @param frames - Array of PNG image bytes (one per frame, in order)\n * @param audio - Optional WAV/MP3/AAC audio bytes to mux into the video\n * @param options - Encoding options (fps, quality, dimensions, progress)\n * @returns Encoded MP4 data and duration metadata\n */\nexport async function framesToMp4Wasm(\n  frames: Uint8Array[],\n  audio: Uint8Array | null,\n  options: VideoExportOptions = {},\n): Promise<EncoderResult> {\n  const fps = options.fps ?? 30;\n  const quality = options.quality ?? 'normal';\n  const { width, height } = resolveDimensions(options);\n  const onProgress = options.onProgress;\n\n  if (frames.length === 0) {\n    throw new Error('No frames provided for encoding');\n  }\n\n  const runtime = globalThis as typeof globalThis & {\n    process?: { versions?: { node?: string } };\n  };\n  if (runtime.process?.versions?.node && typeof window === 'undefined') {\n    throw new Error(\n      'framesToMp4Wasm is browser-only. In Node.js, use framesToMp4Native or framesToMp4NativeBytes from @bendyline/squisq-cli/api.',\n    );\n  }\n\n  const duration = frames.length / fps;\n\n  // Initialize ffmpeg.wasm\n  const { FFmpeg } = await import('@ffmpeg/ffmpeg');\n  const ffmpeg = new FFmpeg();\n  try {\n    ffmpeg.on('progress', ({ progress }) => {\n      if (onProgress) {\n        const percent = Math.round(progress * 100);\n        onProgress(Math.min(percent, 99), 'encoding');\n      }\n    });\n\n    await ffmpeg.load(options.ffmpegWasm);\n\n    onProgress?.(0, 'writing frames');\n\n    // Write frame PNGs to virtual filesystem\n    const padLen = String(frames.length).length;\n    for (let i = 0; i < frames.length; i++) {\n      const name = `frame-${String(i + 1).padStart(padLen, '0')}.png`;\n      await ffmpeg.writeFile(name, frames[i]);\n\n      // Report frame-write progress (0-40% of total)\n      if (onProgress && i % 10 === 0) {\n        onProgress(Math.round((i / frames.length) * 40), 'writing frames');\n      }\n    }\n\n    // Write audio if provided\n    if (audio) {\n      await ffmpeg.writeFile('audio-input', audio);\n    }\n\n    onProgress?.(40, 'encoding');\n\n    // Build ffmpeg command\n    const padPattern = `frame-%0${padLen}d.png`;\n    const args = ['-y', '-framerate', String(fps), '-i', padPattern];\n\n    // Add audio input\n    if (audio) {\n      args.push('-i', 'audio-input');\n    }\n\n    // Video encoding settings\n    args.push(\n      '-c:v',\n      'libx264',\n      ...ffmpegVideoQualityArgs(quality),\n      '-pix_fmt',\n      'yuv420p',\n      '-vf',\n      `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2`,\n    );\n\n    // Audio encoding\n    if (audio) {\n      args.push(...ffmpegAudioMuxArgs(audioBitrateArg(quality)));\n    }\n\n    args.push('output.mp4');\n\n    // Run encoding\n    const exitCode = await ffmpeg.exec(args);\n    if (exitCode !== 0) {\n      throw new Error(`ffmpeg.wasm failed with exit code ${exitCode}`);\n    }\n\n    onProgress?.(95, 'reading output');\n\n    // Read the output file\n    const data = await ffmpeg.readFile('output.mp4');\n\n    // Cleanup virtual filesystem\n    for (let i = 0; i < frames.length; i++) {\n      const name = `frame-${String(i + 1).padStart(padLen, '0')}.png`;\n      await ffmpeg.deleteFile(name);\n    }\n    if (audio) {\n      await ffmpeg.deleteFile('audio-input');\n    }\n    await ffmpeg.deleteFile('output.mp4');\n\n    onProgress?.(100, 'done');\n\n    // ffmpeg.readFile returns Uint8Array for binary files\n    const outputData = data instanceof Uint8Array ? data : new TextEncoder().encode(data as string);\n\n    return { data: outputData, duration };\n  } finally {\n    ffmpeg.terminate();\n  }\n}\n\n// Re-export fetchFile for convenience — consumers may need it to prepare audio bytes\nexport { fetchFile };\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bendyline/squisq-video",
-  "version": "1.2.1",
-  "description": "Video encoding and render HTML generation for Squisq documents — browser-pure, works in Node and browser",
+  "version": "2.0.0",
+  "description": "Cross-runtime video and animated-GIF helpers with browser-based ffmpeg.wasm encoding for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
   "repository": {
@@ -14,6 +14,7 @@
     "squisq",
     "video",
     "mp4",
+    "gif",
     "ffmpeg",
     "wasm",
     "export"
@@ -40,7 +41,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "1.5.1",
+    "@bendyline/squisq": "2.0.0",
     "@ffmpeg/ffmpeg": "0.12.15",
     "@ffmpeg/util": "0.12.2"
   },