@bendyline/squisq-cli 2.8.9 → 2.8.11

package/dist/{chunk-Z3BHD4AF.js → chunk-RQSP3OPR.js}

@@ -141,7 +141,7 @@ async function framesToMp4Native(ffmpegPath, frames, audio, outputPath, options
     }
     args.push(outputPath);
     await runFfmpeg(ffmpegPath, args, {
-      timeoutMs: 6e5,
+      timeoutMs: Math.max(6e5, frames.length * 250),
       failureMessage: "ffmpeg failed",
       signal: options.signal
     });
@@ -227,6 +227,7 @@ async function framesToGifNativeBytes(ffmpegPath, frames, options = {}) {
 }
 
 export {
+  lastMeaningfulFfmpegLine,
   runFfmpeg,
   GIF_EXPORT_DEFAULTS,
   framesToMp4Native,

package/dist/{chunk-GGVASRPG.js → chunk-Y5XKUWJ5.js}

@@ -143,7 +143,7 @@ async function framesToMp4Native(ffmpegPath, frames, audio, outputPath, options
     }
     args.push(outputPath);
     await runFfmpeg(ffmpegPath, args, {
-      timeoutMs: 6e5,
+      timeoutMs: Math.max(6e5, frames.length * 250),
       failureMessage: "ffmpeg failed",
       signal: options.signal
     });
@@ -229,6 +229,7 @@ async function framesToGifNativeBytes(ffmpegPath, frames, options = {}) {
 }
 
 export {
+  lastMeaningfulFfmpegLine,
   runFfmpeg,
   GIF_EXPORT_DEFAULTS,
   framesToMp4Native,

package/dist/index.js

@@ -9,8 +9,8 @@ import {
   renderDocToDashboardPng,
   renderDocToGif,
   renderDocToMp4
-} from "./chunk-XD2ICI5G.js";
-import "./chunk-GGVASRPG.js";
+} from "./chunk-6MZC4YQV.js";
+import "./chunk-Y5XKUWJ5.js";
 
 // src/index.ts
 import { createRequire } from "module";
@@ -319,8 +319,11 @@ import { validateVideoExportOptions } from "@bendyline/squisq-video";
 var VALID_QUALITIES = ["draft", "normal", "high"];
 var VALID_ORIENTATIONS = ["landscape", "portrait"];
 var VALID_CAPTIONS = ["off", "standard", "social"];
+var VALID_MOTION = ["calm", "documentary", "vibrant"];
 var VALID_FORMATS2 = ["mp4", "gif"];
 var VALID_GIF_DITHERS = ["bayer", "sierra2_4a", "none"];
+var VALID_FRAME_TRANSPORTS = ["pipe", "memory"];
+var VALID_CAPTURE_FORMATS = ["png", "jpeg"];
 function registerVideoCommand(program2) {
   program2.command("video").description("Render a squisq document to MP4 video or animated GIF").argument("<input>", "Path to .md/.json file, .zip/.dbk container, or folder").argument("[output]", "Output .mp4 or .gif path (default: <input>.<format>)").option("-o, --output <path>", "Output .mp4 or .gif path (format inferred from extension)").option("--format <format>", `Output format: ${VALID_FORMATS2.join(", ")} (default: mp4)`).option("--fps <number>", "Frames per second (default: 30 for MP4, 10 for GIF)").option(
     "--quality <level>",
@@ -336,13 +339,28 @@ function registerVideoCommand(program2) {
     "--no-auto-templates",
     "Disable content-aware template auto-picking for unannotated headings"
   ).option("-t, --theme <id>", "Squisq theme ID to apply (e.g., documentary, cinematic, bold)").option(
+    "--motion <profile>",
+    `Motion profile: ${VALID_MOTION.join(", ")} (default: the doc's, then the theme's)`
+  ).option(
     "--transform <style>",
     "Transform style to apply before rendering (e.g., documentary, magazine, minimal)"
   ).option(
     "--cover-preroll <seconds>",
     "Seconds of cover-slide pre-roll before the story starts (default: 2)",
     "2"
-  ).option("--width <pixels>", "Override video width (must be even for MP4)").option("--height <pixels>", "Override video height (must be even for MP4)").option("--overwrite", "Replace an existing output file (default: refuse and exit non-zero)").option("--animations", "Enable slide animations/transitions (GIF default: disabled)").option("--no-animations", "Disable slide animations/transitions").option("--loop <count>", "GIF repeat count: 0 forever, -1 no loop (default: 0)").option("--max-colors <count>", "GIF palette size from 2 to 256 (default: 256)").option(
+  ).option("--width <pixels>", "Override video width (must be even for MP4)").option("--height <pixels>", "Override video height (must be even for MP4)").option("--overwrite", "Replace an existing output file (default: refuse and exit non-zero)").option(
+    "--frame-transport <mode>",
+    `MP4 frame delivery: ${VALID_FRAME_TRANSPORTS.join(", ")} (default: pipe, streams frames to ffmpeg)`
+  ).option(
+    "--capture-format <format>",
+    `MP4 still format captured per frame: ${VALID_CAPTURE_FORMATS.join(", ")} (default: png for high quality, jpeg otherwise)`
+  ).option(
+    "--frames-dir <dir>",
+    "MP4 only: spool every captured frame here and keep it after the render"
+  ).option(
+    "--resume",
+    "MP4 only: reuse frames an identical earlier render spooled into --frames-dir"
+  ).option("--animations", "Enable slide animations/transitions (GIF default: disabled)").option("--no-animations", "Disable slide animations/transitions").option("--loop <count>", "GIF repeat count: 0 forever, -1 no loop (default: 0)").option("--max-colors <count>", "GIF palette size from 2 to 256 (default: 256)").option(
     "--dither <algorithm>",
     `GIF dithering: ${VALID_GIF_DITHERS.join(", ")} (default: sierra2_4a)`
   ).option("--bayer-scale <number>", "GIF Bayer dither strength from 0 to 5 (default: 3)").action(async (inputPath, outputArg, opts) => {
@@ -401,10 +419,37 @@ async function runVideo(inputPath, opts) {
   if (!VALID_CAPTIONS.includes(captions)) {
     throw new Error(`Invalid captions "${captions}". Valid: ${VALID_CAPTIONS.join(", ")}`);
   }
+  const motion = opts.motion;
+  if (motion !== void 0 && !VALID_MOTION.includes(motion)) {
+    throw new Error(`Invalid motion "${motion}". Valid: ${VALID_MOTION.join(", ")}`);
+  }
   const coverPreRoll = Number(opts.coverPreroll ?? "2");
   if (!Number.isFinite(coverPreRoll) || coverPreRoll < 0) {
     throw new Error("Cover pre-roll must be a number of seconds >= 0");
   }
+  if (outputFormat === "gif" && (opts.frameTransport || opts.captureFormat || opts.framesDir || opts.resume)) {
+    throw new Error(
+      "--frame-transport, --capture-format, --frames-dir, and --resume only apply to MP4 output"
+    );
+  }
+  const frameTransport = opts.frameTransport ?? "pipe";
+  if (!VALID_FRAME_TRANSPORTS.includes(frameTransport)) {
+    throw new Error(
+      `Invalid frame transport "${frameTransport}". Valid: ${VALID_FRAME_TRANSPORTS.join(", ")}`
+    );
+  }
+  const captureFormat = opts.captureFormat;
+  if (captureFormat !== void 0 && !VALID_CAPTURE_FORMATS.includes(captureFormat)) {
+    throw new Error(
+      `Invalid capture format "${captureFormat}". Valid: ${VALID_CAPTURE_FORMATS.join(", ")}`
+    );
+  }
+  if (opts.resume && !opts.framesDir) {
+    throw new Error("--resume requires --frames-dir");
+  }
+  if ((opts.framesDir || captureFormat) && frameTransport !== "pipe") {
+    throw new Error("--frames-dir and --capture-format require --frame-transport pipe");
+  }
   const animationsEnabled = opts.animations ?? outputFormat === "mp4";
   const loop = opts.loop === void 0 ? 0 : Number(opts.loop);
   const maxColors = opts.maxColors === void 0 ? 256 : Number(opts.maxColors);
@@ -461,8 +506,8 @@ async function runVideo(inputPath, opts) {
   if (opts.theme) {
     doc = { ...doc, themeId: opts.theme };
   }
-  const motionLabel = animationsEnabled ? "animations on" : "animations off";
-  const qualityLabel = outputFormat === "mp4" ? `, quality: ${quality}` : "";
+  const motionLabel = animationsEnabled ? `animations on${motion ? ` (${motion})` : ""}` : "animations off";
+  const qualityLabel = outputFormat === "mp4" ? `, quality: ${quality}, transport: ${frameTransport}` : "";
   console.error(
     `Rendering ${outputFormat.toUpperCase()}: ${fps} fps${qualityLabel}, orientation: ${orientation}, captions: ${captions}, ${motionLabel}`
   );
@@ -473,6 +518,7 @@ async function runVideo(inputPath, opts) {
     width,
     height,
     captionStyle: captions,
+    motion,
     coverPreRoll,
     animationsEnabled,
     onProgress: (phase, percent) => writeProgress(phase, percent, 100)
@@ -485,15 +531,20 @@ async function runVideo(inputPath, opts) {
     bayerScale
   }) : await renderDocToMp4(doc, container, {
     ...sharedRenderOptions,
-    quality
+    quality,
+    frameTransport,
+    captureFormat,
+    framesDir: opts.framesDir ? resolve2(opts.framesDir) : void 0,
+    resume: opts.resume
   });
   clearProgress();
   const warnings = "warnings" in result2 && Array.isArray(result2.warnings) ? result2.warnings : [];
   for (const warning of warnings) {
     console.error(`  \u26A0 ${warning}`);
   }
+  const reused = "reusedFrameCount" in result2 && result2.reusedFrameCount ? `, ${result2.reusedFrameCount} reused from ${opts.framesDir}` : "";
   console.error(
-    `  \u2713 ${outputPath} (${result2.duration.toFixed(1)}s, ${result2.frameCount} frames)`
+    `  \u2713 ${outputPath} (${result2.duration.toFixed(1)}s, ${result2.frameCount} frames${reused})`
   );
   console.error("Done.");
 }

package/dist/{nativeEncoder-PMVSFLMN.js → nativeEncoder-RILHXTXI.js}

@@ -5,7 +5,7 @@ import {
   framesToGifNativeBytes,
   framesToMp4Native,
   framesToMp4NativeBytes
-} from "./chunk-GGVASRPG.js";
+} from "./chunk-Y5XKUWJ5.js";
 export {
   GIF_EXPORT_DEFAULTS,
   framesToGifNative,

package/dist/{nativeEncoder-RZ3T4Z6S.js → nativeEncoder-T43J5UMP.js}

@@ -4,7 +4,7 @@ import {
   framesToGifNativeBytes,
   framesToMp4Native,
   framesToMp4NativeBytes
-} from "./chunk-Z3BHD4AF.js";
+} from "./chunk-RQSP3OPR.js";
 export {
   GIF_EXPORT_DEFAULTS,
   framesToGifNative,