@bendyline/squisq-video 2.2.1 → 2.2.2

package/README.md

@@ -22,7 +22,7 @@ npm install @bendyline/squisq-video
 | `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                          |
+| `ffmpegGifFilterGraph`, `ffmpegGifOutputArgs`, `ffmpegGifPalette*` helpers                              | Shared global-palette GIF filters, including bounded two-pass palette generation/application                    |
 | `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                                                                                      |

package/dist/index.d.ts

@@ -296,6 +296,12 @@ declare function audioBitrateArg(quality: VideoQuality): string;
  * audio longer than the video is trimmed while shorter audio becomes silence.
  */
 declare function ffmpegAudioMuxArgs(bitrate: string | number): string[];
+/** First pass of the bounded-memory GIF workflow: video -> one palette image. */
+declare function ffmpegGifPaletteGenerationFilter(options: GifFilterOptions): string;
+/** Second pass of the bounded-memory GIF workflow: video + palette -> GIF frames. */
+declare function ffmpegGifPaletteApplicationGraph(options: GifFilterOptions): string;
+/** Output arguments for the second, two-input pass of GIF encoding. */
+declare function ffmpegGifPaletteApplicationArgs(options: GifOutputOptions): string[];
 /**
  * Build a high-quality, compression-friendly GIF palette filter graph.
  *
@@ -327,4 +333,4 @@ declare function ffmpegGifOutputArgs(options: GifOutputOptions): string[];
  */
 declare function framesToMp4Wasm(frames: Uint8Array[], audio: Uint8Array | null, options?: VideoExportOptions): Promise<EncoderResult>;
 
-export { type AudioTimelineClip, type EncoderResult, FFMPEG_WASM_SETUP_HINT, 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, resolveFfmpegWasmLoad, validateVideoExportOptions };
+export { type AudioTimelineClip, type EncoderResult, FFMPEG_WASM_SETUP_HINT, 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, ffmpegGifPaletteApplicationArgs, ffmpegGifPaletteApplicationGraph, ffmpegGifPaletteGenerationFilter, ffmpegVideoQualityArgs, framesToMp4Wasm, generateRenderHtml, resolveDimensions, resolveFfmpegWasmLoad, validateVideoExportOptions };

package/dist/index.js

@@ -205,7 +205,7 @@ function audioBitrateArg(quality) {
 function ffmpegAudioMuxArgs(bitrate) {
   return ["-c:a", "aac", "-b:a", String(bitrate), "-af", "apad", "-shortest"];
 }
-function ffmpegGifFilterGraph(options) {
+function resolveGifFilterOptions(options) {
   const { width, height } = options;
   const maxColors = options.maxColors ?? 256;
   const dither = options.dither ?? "sierra2_4a";
@@ -227,14 +227,49 @@ function ffmpegGifFilterGraph(options) {
   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]`;
+  return {
+    width,
+    height,
+    maxColors,
+    ditherArgs: dither === "bayer" ? `dither=bayer:bayer_scale=${bayerScale}` : `dither=${dither}`
+  };
 }
-function ffmpegGifOutputArgs(options) {
+function gifScaleFilter({ width, height }) {
+  return `scale=${width}:${height}:force_original_aspect_ratio=decrease:flags=lanczos,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2:black`;
+}
+function ffmpegGifPaletteGenerationFilter(options) {
+  const resolved = resolveGifFilterOptions(options);
+  return `${gifScaleFilter(resolved)},palettegen=stats_mode=diff:max_colors=${resolved.maxColors}:reserve_transparent=0`;
+}
+function ffmpegGifPaletteApplicationGraph(options) {
+  const resolved = resolveGifFilterOptions(options);
+  return `[0:v]${gifScaleFilter(resolved)}[gif_frames];[gif_frames][1:v]paletteuse=${resolved.ditherArgs}:diff_mode=rectangle[gif_out]`;
+}
+function ffmpegGifPaletteApplicationArgs(options) {
+  const loop = resolveGifLoop(options);
+  return [
+    "-filter_complex",
+    ffmpegGifPaletteApplicationGraph(options),
+    "-map",
+    "[gif_out]",
+    "-an",
+    "-loop",
+    String(loop)
+  ];
+}
+function ffmpegGifFilterGraph(options) {
+  const resolved = resolveGifFilterOptions(options);
+  return `[0:v]${gifScaleFilter(resolved)},split[gif_frames][gif_palette_source];[gif_palette_source]palettegen=stats_mode=diff:max_colors=${resolved.maxColors}:reserve_transparent=0[gif_palette];[gif_frames][gif_palette]paletteuse=${resolved.ditherArgs}:diff_mode=rectangle[gif_out]`;
+}
+function resolveGifLoop(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 loop;
+}
+function ffmpegGifOutputArgs(options) {
+  const loop = resolveGifLoop(options);
   return [
     "-filter_complex",
     ffmpegGifFilterGraph(options),
@@ -337,6 +372,9 @@ export {
   ffmpegAudioMuxArgs,
   ffmpegGifFilterGraph,
   ffmpegGifOutputArgs,
+  ffmpegGifPaletteApplicationArgs,
+  ffmpegGifPaletteApplicationGraph,
+  ffmpegGifPaletteGenerationFilter,
   ffmpegVideoQualityArgs,
   framesToMp4Wasm,
   generateRenderHtml,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-video",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Cross-runtime video and animated-GIF helpers with browser-based ffmpeg.wasm encoding for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -48,7 +48,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.3.1",
+    "@bendyline/squisq": "2.3.2",
     "@ffmpeg/ffmpeg": "0.12.15",
     "@ffmpeg/util": "0.12.2"
   },