@bendyline/squisq-cli 1.2.1 → 2.0.0

package/dist/chunk-JEE26SZS.js

@@ -0,0 +1,668 @@
+#!/usr/bin/env node
+import {
+  GIF_EXPORT_DEFAULTS
+} from "./chunk-VM3ZFP3J.js";
+
+// src/api.ts
+import { resolveMediaSchedule } from "@bendyline/squisq/schemas";
+import { flattenBlocks } from "@bendyline/squisq/doc";
+import { ffmpegGifOutputArgs, generateRenderHtml } from "@bendyline/squisq-video";
+import { resolveDimensions } from "@bendyline/squisq-video";
+import { convert as formatsConvert } from "@bendyline/squisq-formats";
+
+// src/util/detectFfmpeg.ts
+import { execFile } from "child_process";
+function run(command, args) {
+  return new Promise((resolve) => {
+    execFile(command, args, { timeout: 5e3 }, (err, stdout) => {
+      if (err || !stdout.trim()) {
+        resolve(null);
+        return;
+      }
+      resolve(stdout.trim());
+    });
+  });
+}
+async function getFfmpegVersion(path) {
+  const out = await run(path, ["-version"]);
+  return out ? out.split("\n")[0].trim() : null;
+}
+async function detectFfmpegDetailed() {
+  const envPath = process.env.SQUISQ_FFMPEG;
+  if (envPath) {
+    const version = await getFfmpegVersion(envPath);
+    if (!version) {
+      throw new Error(
+        `SQUISQ_FFMPEG is set to "${envPath}" but running "${envPath} -version" failed. Fix the path or unset SQUISQ_FFMPEG.`
+      );
+    }
+    return { path: envPath, source: "env" };
+  }
+  const command = process.platform === "win32" ? "where" : "which";
+  const found = await run(command, ["ffmpeg"]);
+  if (found) {
+    return { path: found.split("\n")[0].trim(), source: "path" };
+  }
+  try {
+    const specifier = "ffmpeg-static";
+    const mod = await import(specifier);
+    const candidate = typeof mod === "string" ? mod : typeof mod.default === "string" ? mod.default : null;
+    if (candidate) {
+      return { path: candidate, source: "ffmpeg-static" };
+    }
+  } catch {
+  }
+  return null;
+}
+
+// src/util/audioMix.ts
+import { computeAudioTimeline } from "@bendyline/squisq-video";
+async function buildMixedAudioTrack(doc, container, ffmpegPath, coverPreRoll) {
+  const timeline = computeAudioTimeline(doc, coverPreRoll);
+  if (timeline.length === 0) return null;
+  const bytesBySrc = /* @__PURE__ */ new Map();
+  const readSrc = async (src) => {
+    if (bytesBySrc.has(src)) return bytesBySrc.get(src);
+    const data = await container.readFile(src);
+    bytesBySrc.set(src, data ?? null);
+    return data ?? null;
+  };
+  const usable = [];
+  for (const clip of timeline) {
+    const buffer = await readSrc(clip.src);
+    if (buffer) usable.push({ clip, buffer });
+  }
+  if (usable.length === 0) return null;
+  return mixTimelineClips(ffmpegPath, usable);
+}
+async function mixTimelineClips(ffmpegPath, usable) {
+  const { writeFile, readFile: readFile3, mkdir, rm: rm2 } = await import("fs/promises");
+  const { join: join3 } = await import("path");
+  const { tmpdir: tmpdir2 } = await import("os");
+  const { randomBytes: randomBytes2 } = await import("crypto");
+  const { execFile: execFile2 } = await import("child_process");
+  const workDir = join3(tmpdir2(), `squisq-audio-mix-${randomBytes2(8).toString("hex")}`);
+  await mkdir(workDir, { recursive: true });
+  const ms = (s) => Math.max(0, Math.round(s * 1e3));
+  try {
+    const inputs = [];
+    const filters = [];
+    const labels = [];
+    for (const { clip, buffer } of usable) {
+      const p = join3(workDir, `clip-${inputs.length}.mp3`);
+      await writeFile(p, new Uint8Array(buffer));
+      const i = inputs.push(p) - 1;
+      const delayMs = ms(clip.startSec);
+      const start = Math.max(0, clip.sourceInSec);
+      const end = start + Math.max(0, clip.durationSec);
+      filters.push(
+        `[${i}:a]atrim=start=${start}:end=${end},asetpts=PTS-STARTPTS,adelay=${delayMs}|${delayMs}[a${i}]`
+      );
+      labels.push(`[a${i}]`);
+    }
+    const graph = `${filters.join(";")};${labels.join("")}amix=inputs=${labels.length}:normalize=0:dropout_transition=0[aout]`;
+    const outputPath = join3(workDir, "mixed.mp3");
+    const args = ["-y"];
+    for (const p of inputs) args.push("-i", p);
+    args.push(
+      "-filter_complex",
+      graph,
+      "-map",
+      "[aout]",
+      "-c:a",
+      "libmp3lame",
+      "-b:a",
+      "192k",
+      outputPath
+    );
+    await new Promise((resolve, reject) => {
+      execFile2(ffmpegPath, args, { timeout: 18e4 }, (err) => {
+        if (err) reject(new Error(`ffmpeg audio mix failed: ${err.message}`));
+        else resolve();
+      });
+    });
+    const data = await readFile3(outputPath);
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+  } finally {
+    await rm2(workDir, { recursive: true, force: true });
+  }
+}
+
+// src/util/coverPreRoll.ts
+function resolveAppliedCoverPreRoll(requestedSeconds, hasCover) {
+  if (!Number.isFinite(requestedSeconds) || requestedSeconds < 0) {
+    throw new Error("Cover pre-roll must be a finite number of seconds greater than or equal to 0");
+  }
+  return hasCover ? requestedSeconds : 0;
+}
+
+// src/registry.ts
+import { randomBytes } from "crypto";
+import { readFile, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { defaultRegistry } from "@bendyline/squisq-formats";
+var MP4_DEFAULTS = {
+  fps: 30,
+  quality: "normal",
+  orientation: "landscape",
+  coverPreRoll: 0,
+  animationsEnabled: true
+};
+var GIF_DEFAULTS = {
+  fps: 10,
+  orientation: "landscape",
+  width: 960,
+  height: 540,
+  coverPreRoll: 0,
+  animationsEnabled: false,
+  loop: 0,
+  maxColors: 256,
+  dither: "sierra2_4a"
+};
+function mp4Format() {
+  return {
+    id: "mp4",
+    label: "MP4 Video",
+    mimeType: "video/mp4",
+    extensions: [".mp4"],
+    async exportDoc(input, options) {
+      const mp4Opts = options.formatOptions?.mp4 ?? {};
+      const fps = typeof mp4Opts.fps === "number" ? mp4Opts.fps : MP4_DEFAULTS.fps;
+      const quality = typeof mp4Opts.quality === "string" ? mp4Opts.quality : MP4_DEFAULTS.quality;
+      const orientation = typeof mp4Opts.orientation === "string" ? mp4Opts.orientation : MP4_DEFAULTS.orientation;
+      const coverPreRoll = typeof mp4Opts.coverPreRoll === "number" ? mp4Opts.coverPreRoll : MP4_DEFAULTS.coverPreRoll;
+      const animationsEnabled = typeof mp4Opts.animationsEnabled === "boolean" ? mp4Opts.animationsEnabled : MP4_DEFAULTS.animationsEnabled;
+      const outputPath = join(tmpdir(), `squisq-mp4-${randomBytes(8).toString("hex")}.mp4`);
+      try {
+        const { renderDocToMp4: renderDocToMp42 } = await import("./api-6KN3F6IQ.js");
+        await renderDocToMp42(input.doc, input.container, {
+          outputPath,
+          fps,
+          quality,
+          orientation,
+          width: mp4Opts.width,
+          height: mp4Opts.height,
+          captionStyle: mp4Opts.captionStyle,
+          coverPreRoll,
+          animationsEnabled
+        });
+        const data = await readFile(outputPath);
+        const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+        return { bytes, mimeType: "video/mp4", suggestedFilename: "", warnings: [] };
+      } finally {
+        await rm(outputPath, { force: true });
+      }
+    }
+  };
+}
+function gifFormat() {
+  return {
+    id: "gif",
+    label: "Animated GIF",
+    mimeType: "image/gif",
+    extensions: [".gif"],
+    async exportDoc(input, options) {
+      const gifOpts = options.formatOptions?.gif ?? {};
+      const orientation = typeof gifOpts.orientation === "string" ? gifOpts.orientation : GIF_DEFAULTS.orientation;
+      const portrait = orientation === "portrait";
+      const defaultWidth = portrait ? GIF_DEFAULTS.height : GIF_DEFAULTS.width;
+      const defaultHeight = portrait ? GIF_DEFAULTS.width : GIF_DEFAULTS.height;
+      const outputPath = join(tmpdir(), `squisq-gif-${randomBytes(8).toString("hex")}.gif`);
+      try {
+        const { renderDocToGif: renderDocToGif2 } = await import("./api-6KN3F6IQ.js");
+        const result = await renderDocToGif2(input.doc, input.container, {
+          outputPath,
+          fps: typeof gifOpts.fps === "number" ? gifOpts.fps : GIF_DEFAULTS.fps,
+          orientation,
+          width: typeof gifOpts.width === "number" ? gifOpts.width : defaultWidth,
+          height: typeof gifOpts.height === "number" ? gifOpts.height : defaultHeight,
+          captionStyle: gifOpts.captionStyle,
+          coverPreRoll: typeof gifOpts.coverPreRoll === "number" ? gifOpts.coverPreRoll : GIF_DEFAULTS.coverPreRoll,
+          animationsEnabled: typeof gifOpts.animationsEnabled === "boolean" ? gifOpts.animationsEnabled : GIF_DEFAULTS.animationsEnabled,
+          loop: typeof gifOpts.loop === "number" ? gifOpts.loop : GIF_DEFAULTS.loop,
+          maxColors: typeof gifOpts.maxColors === "number" ? gifOpts.maxColors : GIF_DEFAULTS.maxColors,
+          dither: gifOpts.dither ?? GIF_DEFAULTS.dither,
+          bayerScale: gifOpts.bayerScale
+        });
+        const data = await readFile(outputPath);
+        const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+        return {
+          bytes,
+          mimeType: "image/gif",
+          suggestedFilename: "",
+          warnings: result.warnings
+        };
+      } finally {
+        await rm(outputPath, { force: true });
+      }
+    }
+  };
+}
+function createCliRegistry() {
+  const registry = defaultRegistry();
+  registry.register(mp4Format());
+  registry.register(gifFormat());
+  return registry;
+}
+
+// src/api.ts
+import { MemoryContentContainer as MemoryContentContainer2 } from "@bendyline/squisq/storage";
+
+// src/util/readInput.ts
+import { readFile as readFile2, readdir, stat } from "fs/promises";
+import { join as join2, extname } from "path";
+import { parseMarkdown, stringifyMarkdown } from "@bendyline/squisq/markdown";
+import { markdownToDoc, resolveAudioMapping } from "@bendyline/squisq/doc";
+import { MemoryContentContainer } from "@bendyline/squisq/storage";
+import { zipToContainer } from "@bendyline/squisq-formats/container";
+import { defaultRegistry as defaultRegistry2 } from "@bendyline/squisq-formats";
+var MIME_TYPES = {
+  ".md": "text/markdown",
+  ".txt": "text/plain",
+  ".json": "application/json",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".ogg": "audio/ogg",
+  ".mp4": "video/mp4",
+  ".webm": "video/webm"
+};
+var IMPORTER_EXTS = [".docx", ".pptx", ".pdf", ".xlsx", ".csv", ".html", ".htm"];
+function mimeFromExt(filePath) {
+  return MIME_TYPES[extname(filePath).toLowerCase()] ?? "application/octet-stream";
+}
+async function walkDir(root, prefix = "") {
+  const entries = await readdir(root, { withFileTypes: true });
+  const paths = [];
+  for (const entry of entries) {
+    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      paths.push(...await walkDir(join2(root, entry.name), relPath));
+    } else if (entry.isFile()) {
+      paths.push(relPath);
+    }
+  }
+  return paths;
+}
+async function readInput(inputPath, options) {
+  const result = await readInputRaw(inputPath, options);
+  const doc = await resolveAudioMapping(result.doc, result.container);
+  return doc === result.doc ? result : { ...result, doc };
+}
+async function readInputRaw(inputPath, options) {
+  const info = await stat(inputPath);
+  if (info.isDirectory()) {
+    return readFolder(inputPath);
+  }
+  const ext = extname(inputPath).toLowerCase();
+  if (ext === ".zip" || ext === ".dbk") {
+    return readContainer(inputPath);
+  }
+  if (ext === ".json") {
+    return readDocJsonFile(inputPath);
+  }
+  if (IMPORTER_EXTS.includes(ext)) {
+    const def = defaultRegistry2().byExtension(ext);
+    if (def && (def.importContainer || def.importDoc)) {
+      return readViaImporter(inputPath, def, options);
+    }
+  }
+  return readMarkdownFile(inputPath);
+}
+async function readArrayBuffer(filePath) {
+  const data = await readFile2(filePath);
+  return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+}
+async function readMarkdownFile(filePath) {
+  const content = await readFile2(filePath, "utf-8");
+  const container = new MemoryContentContainer();
+  await container.writeDocument(content);
+  const markdownDoc = parseMarkdown(content);
+  return { doc: markdownToDoc(markdownDoc), container, markdownDoc, sourceFormat: "md" };
+}
+async function readDocJsonFile(filePath) {
+  const content = await readFile2(filePath, "utf-8");
+  const doc = JSON.parse(content);
+  const container = new MemoryContentContainer();
+  return { doc, container, sourceFormat: "json" };
+}
+async function readViaImporter(filePath, def, options) {
+  const buffer = await readArrayBuffer(filePath);
+  const convertOptions = {
+    formatOptions: {
+      [def.id]: {
+        inferTheme: options?.inferTheme !== false,
+        inferLayouts: options?.inferLayouts !== false
+      }
+    }
+  };
+  let container;
+  let markdownDoc;
+  if (def.importContainer) {
+    container = await def.importContainer(buffer, convertOptions);
+    const text = await container.readDocument();
+    markdownDoc = text ? parseMarkdown(text) : { type: "document", children: [] };
+  } else {
+    markdownDoc = await def.importDoc(buffer, convertOptions);
+    const mem = new MemoryContentContainer();
+    await mem.writeDocument(stringifyMarkdown(markdownDoc));
+    container = mem;
+  }
+  return { doc: markdownToDoc(markdownDoc), container, markdownDoc, sourceFormat: def.id };
+}
+var DOC_JSON_NAMES = ["doc.json", "story.json"];
+async function resolveContainer(container, sourceFormat, missingMessage) {
+  for (const name of DOC_JSON_NAMES) {
+    const jsonData = await container.readFile(name);
+    if (jsonData) {
+      const doc = JSON.parse(new TextDecoder().decode(jsonData));
+      return { doc, container, sourceFormat };
+    }
+  }
+  const markdown = await container.readDocument();
+  if (!markdown) {
+    throw new Error(missingMessage);
+  }
+  const markdownDoc = parseMarkdown(markdown);
+  return { doc: markdownToDoc(markdownDoc), container, markdownDoc, sourceFormat };
+}
+async function readContainer(filePath) {
+  const container = await zipToContainer(await readArrayBuffer(filePath));
+  return resolveContainer(
+    container,
+    "dbk",
+    `No markdown document or doc.json found in container: ${filePath}`
+  );
+}
+async function readFolder(dirPath) {
+  const container = new MemoryContentContainer();
+  const files = await walkDir(dirPath);
+  for (const relPath of files) {
+    const absPath = join2(dirPath, relPath);
+    const data = await readFile2(absPath);
+    await container.writeFile(
+      relPath,
+      new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
+      mimeFromExt(relPath)
+    );
+  }
+  return resolveContainer(
+    container,
+    "folder",
+    `No markdown document or doc.json found in folder: ${dirPath}`
+  );
+}
+
+// src/api.ts
+import { ConversionError } from "@bendyline/squisq-formats";
+async function convert(source, to, options = {}) {
+  return formatsConvert(source, to, {
+    registry: createCliRegistry(),
+    resolvePlayerScript: () => import("@bendyline/squisq-react/standalone-source").then((m) => m.PLAYER_BUNDLE),
+    ...options
+  });
+}
+async function captureDocFrames(doc, container, options) {
+  const { fps, width, height, captionStyle, coverPreRoll, animationsEnabled, onProgress } = options;
+  resolveAppliedCoverPreRoll(coverPreRoll, true);
+  const ffmpegPath = (await detectFfmpegDetailed())?.path ?? null;
+  if (!ffmpegPath) {
+    throw new Error(
+      "ffmpeg is required but not found in PATH.\nInstall it with:\n  macOS:   brew install ffmpeg\n  Ubuntu:  sudo apt install ffmpeg\n  Windows: winget install ffmpeg\nOr: npm install ffmpeg-static, or set SQUISQ_FFMPEG to an ffmpeg binary."
+    );
+  }
+  onProgress?.("collecting media", 0);
+  const { collectImagePaths } = await import("@bendyline/squisq-formats/html");
+  const images = /* @__PURE__ */ new Map();
+  for (const imgPath of collectImagePaths(doc)) {
+    const data = await container.readFile(imgPath);
+    if (data) images.set(imgPath, data);
+  }
+  const audio = /* @__PURE__ */ new Map();
+  for (const seg of doc.audio?.segments ?? []) {
+    const data = await container.readFile(seg.src);
+    if (data) {
+      audio.set(seg.src, data);
+      audio.set(seg.name, data);
+    }
+  }
+  const mediaSrcs = new Set(resolveMediaSchedule(doc).map((clip) => clip.src));
+  for (const block of flattenBlocks(doc.blocks)) {
+    for (const layer of block.layers ?? []) {
+      if (layer.type === "video") mediaSrcs.add(layer.content.src);
+    }
+  }
+  for (const src of mediaSrcs) {
+    if (images.has(src)) continue;
+    const data = await container.readFile(src);
+    if (data) images.set(src, data);
+  }
+  onProgress?.("generating render HTML", 10);
+  const { PLAYER_BUNDLE } = await import("@bendyline/squisq-react/standalone-source");
+  const renderHtml = generateRenderHtml(doc, {
+    playerScript: PLAYER_BUNDLE,
+    images,
+    audio: audio.size > 0 ? audio : void 0,
+    width,
+    height,
+    captionStyle,
+    animationsEnabled
+  });
+  onProgress?.("launching browser", 15);
+  const { chromium } = await import("playwright-core");
+  let browser;
+  try {
+    browser = await chromium.launch({ headless: true });
+  } catch (err) {
+    const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+    throw new Error(
+      `Playwright Chromium is not installed. Run: npx playwright install chromium
+(launch failed: ${detail})`
+    );
+  }
+  const page = await browser.newPage({ viewport: { width, height } });
+  const pageErrors = [];
+  page.on("pageerror", (err) => pageErrors.push(err.message));
+  let renderAPI = null;
+  try {
+    await page.setContent(renderHtml, { waitUntil: "load" });
+    await page.waitForTimeout(500);
+    try {
+      await page.waitForFunction(
+        () => {
+          const root = document.getElementById("squisq-root");
+          const player = window.SquisqPlayer;
+          return root ? player?.getHandle(root)?.getRenderAPI() != null : false;
+        },
+        { timeout: 15e3 }
+      );
+    } catch {
+      const errorDetail = pageErrors.length ? `
+Page errors:
+  ${pageErrors.join("\n  ")}` : "\nNo page errors captured \u2014 the player may have failed to mount.";
+      throw new Error(
+        `The standalone player failed to boot in headless Chromium. Render API did not initialize within 15 seconds.${errorDetail}`
+      );
+    }
+    renderAPI = await page.evaluateHandle(() => {
+      const root = document.getElementById("squisq-root");
+      const player = window.SquisqPlayer;
+      const api = root ? player?.getHandle(root)?.getRenderAPI() : null;
+      if (!api) throw new Error("Squisq render API disappeared after initialization.");
+      return api;
+    });
+    const docDuration = await renderAPI.evaluate((api) => api.getDuration());
+    if (docDuration <= 0) throw new Error("Document has zero duration \u2014 nothing to render");
+    const hasCover = coverPreRoll > 0 ? await renderAPI.evaluate((api) => api.hasCoverBlock()) : false;
+    const appliedCoverPreRoll = resolveAppliedCoverPreRoll(coverPreRoll, hasCover);
+    const storyFrameCount = Math.ceil(docDuration * fps);
+    const preRollFrameCount = Math.ceil(appliedCoverPreRoll * fps);
+    const totalFrames = preRollFrameCount + storyFrameCount;
+    const frames = [];
+    onProgress?.("capturing frames", 20);
+    if (preRollFrameCount > 0) {
+      await renderAPI.evaluate((api) => api.showCover());
+      await page.waitForTimeout(100);
+      const coverFrame = new Uint8Array(await page.screenshot({ type: "png" }));
+      for (let i = 0; i < preRollFrameCount; i++) frames.push(coverFrame);
+      await renderAPI.evaluate((api) => api.hideCover());
+    }
+    const frameInterval = 1 / fps;
+    for (let i = 0; i < storyFrameCount; i++) {
+      const time = i * frameInterval;
+      await renderAPI.evaluate((api, t) => api.seekTo(t), time);
+      frames.push(new Uint8Array(await page.screenshot({ type: "png" })));
+      if (i % Math.max(1, Math.floor(fps / 2)) === 0 || i === storyFrameCount - 1) {
+        onProgress?.("capturing frames", 20 + Math.round(frames.length / totalFrames * 60));
+      }
+    }
+    return {
+      frames,
+      totalDuration: docDuration + appliedCoverPreRoll,
+      appliedCoverPreRoll,
+      ffmpegPath
+    };
+  } finally {
+    await renderAPI?.dispose();
+    await browser.close();
+  }
+}
+async function renderDocToMp4(doc, container, options) {
+  const fps = options.fps ?? 30;
+  const quality = options.quality ?? "normal";
+  const orientation = options.orientation ?? "landscape";
+  const dimensions = resolveDimensions({
+    orientation,
+    width: options.width,
+    height: options.height,
+    fps,
+    quality
+  });
+  const capture = await captureDocFrames(doc, container, {
+    fps,
+    width: dimensions.width,
+    height: dimensions.height,
+    captionStyle: options.captionStyle,
+    coverPreRoll: options.coverPreRoll ?? 0,
+    animationsEnabled: options.animationsEnabled ?? true,
+    onProgress: options.onProgress
+  });
+  options.onProgress?.("encoding video", 80);
+  const encodingAudio = await buildMixedAudioTrack(
+    doc,
+    container,
+    capture.ffmpegPath,
+    capture.appliedCoverPreRoll
+  );
+  const { framesToMp4Native: framesToMp4Native2 } = await import("./nativeEncoder-WHUIQZLL.js");
+  await framesToMp4Native2(capture.ffmpegPath, capture.frames, encodingAudio, options.outputPath, {
+    fps,
+    quality,
+    orientation,
+    width: dimensions.width,
+    height: dimensions.height,
+    onProgress: (percent, phase) => options.onProgress?.(`encoding: ${phase}`, 80 + Math.round(percent * 0.2))
+  });
+  options.onProgress?.("done", 100);
+  return {
+    duration: capture.totalDuration,
+    frameCount: capture.frames.length,
+    outputPath: options.outputPath
+  };
+}
+async function renderDocToGif(doc, container, options) {
+  const fps = options.fps ?? GIF_EXPORT_DEFAULTS.fps;
+  if (!Number.isFinite(fps) || fps <= 0 || fps > 100) {
+    throw new RangeError("GIF FPS must be a finite number between 1 and 100.");
+  }
+  const orientation = options.orientation ?? "landscape";
+  const portrait = orientation === "portrait";
+  const width = options.width ?? (portrait ? GIF_EXPORT_DEFAULTS.height : GIF_EXPORT_DEFAULTS.width);
+  const height = options.height ?? (portrait ? GIF_EXPORT_DEFAULTS.width : GIF_EXPORT_DEFAULTS.height);
+  resolveDimensions({ orientation, width, height, fps });
+  ffmpegGifOutputArgs({
+    width,
+    height,
+    loop: options.loop ?? GIF_EXPORT_DEFAULTS.loop,
+    maxColors: options.maxColors ?? GIF_EXPORT_DEFAULTS.maxColors,
+    dither: options.dither ?? GIF_EXPORT_DEFAULTS.dither,
+    bayerScale: options.bayerScale
+  });
+  const capture = await captureDocFrames(doc, container, {
+    fps,
+    width,
+    height,
+    captionStyle: options.captionStyle,
+    coverPreRoll: options.coverPreRoll ?? 0,
+    animationsEnabled: options.animationsEnabled ?? false,
+    onProgress: options.onProgress
+  });
+  options.onProgress?.("encoding GIF", 80);
+  const { framesToGifNative: framesToGifNative2 } = await import("./nativeEncoder-WHUIQZLL.js");
+  await framesToGifNative2(capture.ffmpegPath, capture.frames, options.outputPath, {
+    fps,
+    orientation,
+    width,
+    height,
+    loop: options.loop,
+    maxColors: options.maxColors,
+    dither: options.dither,
+    bayerScale: options.bayerScale,
+    onProgress: (percent, phase) => options.onProgress?.(`encoding: ${phase}`, 80 + Math.round(percent * 0.2))
+  });
+  options.onProgress?.("done", 100);
+  const hasAudio = (doc.audio?.segments?.length ?? 0) > 0 || resolveMediaSchedule(doc).some((clip) => clip.kind === "audio");
+  return {
+    duration: capture.totalDuration,
+    frameCount: capture.frames.length,
+    outputPath: options.outputPath,
+    warnings: hasAudio ? ["Animated GIF does not support audio; audio tracks were omitted."] : []
+  };
+}
+async function extractThumbnails(options) {
+  const { videoPath, outputDir, slug, sizes, force } = options;
+  const { existsSync } = await import("fs");
+  const { join: join3 } = await import("path");
+  const { execFile: execFile2 } = await import("child_process");
+  const ffmpegPath = (await detectFfmpegDetailed())?.path ?? null;
+  if (!ffmpegPath) {
+    throw new Error(
+      "ffmpeg is required for thumbnail extraction but not found in PATH.\nInstall it with:\n  macOS:   brew install ffmpeg\n  Ubuntu:  sudo apt install ffmpeg\n  Windows: winget install ffmpeg"
+    );
+  }
+  for (const thumb of sizes) {
+    const outputPath = join3(outputDir, `${slug}-${thumb.width}x${thumb.height}.jpg`);
+    if (!force && existsSync(outputPath)) continue;
+    await new Promise((resolve, reject) => {
+      execFile2(
+        ffmpegPath,
+        ["-y", "-i", videoPath, "-vf", thumb.filter, "-frames:v", "1", "-q:v", "2", outputPath],
+        { timeout: 3e4 },
+        (err) => {
+          if (err) reject(new Error(`Thumbnail extraction failed (${thumb.name}): ${err.message}`));
+          else resolve();
+        }
+      );
+    });
+  }
+}
+
+export {
+  readInput,
+  getFfmpegVersion,
+  detectFfmpegDetailed,
+  convert,
+  renderDocToMp4,
+  renderDocToGif,
+  extractThumbnails,
+  MemoryContentContainer2 as MemoryContentContainer,
+  ConversionError,
+  createCliRegistry
+};
+//# sourceMappingURL=chunk-JEE26SZS.js.map