@bendyline/squisq-cli 2.1.0 → 2.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bendyline LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,15 @@
+# Third-Party Notices for @bendyline/squisq-cli
+
+This notice applies to the `@bendyline/squisq-cli` npm package.
+Squisq-authored code is licensed under the MIT license in `LICENSE`.
+Third-party components remain under their respective license terms.
+
+## Runtime dependencies
+
+| Package         | Version | License    | Repository                              |
+| --------------- | ------- | ---------- | --------------------------------------- |
+| commander       | 12.1.0  | MIT        | https://github.com/tj/commander.js      |
+| playwright-core | 1.58.2  | Apache-2.0 | https://github.com/microsoft/playwright |
+
+Copyright and complete license texts for these dependencies are included in
+their respective npm distributions and source repositories.

package/README.md

@@ -40,6 +40,7 @@ squisq convert input.md --theme cinematic --transform magazine --formats pptx
 | `-o, --output <file>` | **Single** output file; format inferred from its extension (cannot combine with `--formats`)                | —             |
 | `-d, --output-dir`    | Output directory (multi-format mode)                                                                        | same as input |
 | `-f, --formats`       | Comma-separated: `docx`, `pptx`, `pdf`, `html`, `htmlzip`, `epub`, `dbk`, `md`, `xlsx`, `csv`, `mp4`, `gif` | default set   |
+| `--overwrite`         | Replace existing output files (otherwise the run refuses and exits non-zero)                                | off           |
 | `-t, --theme`         | Squisq theme id — built-in or a custom theme inlined in the doc's frontmatter                               | none          |
 | `--transform`         | Transform style applied before export (e.g. `documentary`, `magazine`, `minimal`)                           | none          |
 | `--no-auto-templates` | Disable content-aware template auto-picking for unannotated headings                                        | (auto on)     |
@@ -48,6 +49,8 @@ squisq convert input.md --theme cinematic --transform magazine --formats pptx
 
 Notes:
 
+- **Existing files are never overwritten by default.** A bare `convert report.md` writes several files next to the input; if any already exists the run refuses up front (before converting anything) and exits 1. Pass `--overwrite` to replace them. The flag is `--overwrite`, not `-f`, because `-f` is `--formats`. There is no prompt — this stays scriptable.
+- **An unknown `--formats` id is a hard error.** `-f docx,pfd` fails with `Unknown format: "pfd" (did you mean "pdf"?)` and produces nothing, rather than warning and exiting 0 with the PDF silently missing.
 - `html` produces a single self-contained file with the standalone player inlined (static mode); `htmlzip` produces a `<name>.html.zip` archive with external assets and optional audio.
 - `epub` embeds images from the input container and, when the doc has narration segments, generates EPUB 3 Media Overlays.
 - `xlsx` export is tables-only; `csv` export emits the first table; `mp4` and `gif` require the render toolchain (see Install).
@@ -83,9 +86,16 @@ squisq video doc.json -o out.mp4
 | `-t, --theme`                      | Squisq theme id to apply                                             | none                      |
 | `--transform`                      | Transform style to apply before rendering                            | none                      |
 | `--cover-preroll`                  | Seconds of cover-slide pre-roll before the story starts              | 2                         |
-| `--width` / `--height`             | Dimension overrides in pixels                                        | MP4 1080p; GIF 960×540    |
+| `--width` / `--height`             | Dimension overrides in pixels — **must be even**                     | MP4 1080p; GIF 960×540    |
+| `--overwrite`                      | Replace an existing output file (otherwise refuse and exit non-zero) | off                       |
 | `--no-auto-templates`              | Disable content-aware template auto-picking for unannotated headings | (auto on)                 |
 
+Notes:
+
+- **Dimensions must be even.** `--width 851` is rejected immediately — before the document is read or a browser launches — with `Video width must be an even number of pixels (got 851) … Use 850 or 852.` Odd values are rejected rather than rounded, so a render never silently ships at a size you did not ask for. The rule is the same for MP4 and GIF, and matches browser export.
+- **An existing output file is never overwritten by default.** The check runs before rendering, so a colliding path costs you a second rather than a full capture. Pass `--overwrite` to replace.
+- FFmpeg failures report the one relevant line (e.g. `[libx264] width not divisible by 2 (851x480) (exit code 1)`) rather than dumping the whole command line and stderr buffer.
+
 ### `squisq doctor`
 
 Preflight the video toolchain: reports the resolved ffmpeg path, version, and which source it came from (`SQUISQ_FFMPEG` env / `PATH` / `ffmpeg-static`) with an install hint when missing, attempts a headless Chromium launch, and reports the Node version.
@@ -238,7 +248,7 @@ await extractThumbnails({
 - `MemoryContentContainer` (re-export from `@bendyline/squisq/storage`)
 - `VideoQuality`, `VideoOrientation` types (re-exports from `@bendyline/squisq-video`)
 
-See the full [API Reference](../../docs/API.md#bendylinesquisq-cli) for all types and options.
+See the full [API Reference](https://github.com/bendyline/squisq/blob/main/docs/API.md#bendylinesquisq-cli) for all types and options.
 
 ## Related Packages
 

package/dist/{api-LE75OSRQ.js → api-5SX73ZKT.js}

@@ -11,14 +11,14 @@ import {
   readInput,
   renderDocToGif,
   renderDocToMp4
-} from "./chunk-FVFK4ZJU.js";
+} from "./chunk-GYHQHKO5.js";
 import {
   GIF_EXPORT_DEFAULTS,
   framesToGifNative,
   framesToGifNativeBytes,
   framesToMp4Native,
   framesToMp4NativeBytes
-} from "./chunk-JDHONKFZ.js";
+} from "./chunk-GGVASRPG.js";
 export {
   CapturedFrameBudgetError,
   ConversionError,
@@ -37,4 +37,3 @@ export {
   renderDocToGif,
   renderDocToMp4
 };
-//# sourceMappingURL=api-LE75OSRQ.js.map

package/dist/api.js

@@ -5,7 +5,7 @@ import {
   framesToMp4Native,
   framesToMp4NativeBytes,
   runFfmpeg
-} from "./chunk-OEN2RADG.js";
+} from "./chunk-Z3BHD4AF.js";
 
 // src/api.ts
 import { resolveMediaSchedule } from "@bendyline/squisq/schemas";
@@ -231,6 +231,45 @@ function resolveAppliedCoverPreRoll(requestedSeconds, hasCover) {
   return hasCover ? requestedSeconds : 0;
 }
 
+// src/util/mediaBudget.ts
+var MAX_RENDER_MEDIA_FILE_BYTES = 64 * 1024 * 1024;
+var MAX_RENDER_MEDIA_TOTAL_BYTES = 256 * 1024 * 1024;
+var MAX_RENDER_MEDIA_FILES = 256;
+function mib(bytes) {
+  return `${Math.round(bytes / (1024 * 1024))} MB`;
+}
+function createMediaBudget() {
+  let totalBytes = 0;
+  let fileCount = 0;
+  return {
+    get totalBytes() {
+      return totalBytes;
+    },
+    get fileCount() {
+      return fileCount;
+    },
+    admit(path, data) {
+      if (data.byteLength > MAX_RENDER_MEDIA_FILE_BYTES) {
+        throw new Error(
+          `Media file "${path}" is ${mib(data.byteLength)}, which exceeds the ${mib(MAX_RENDER_MEDIA_FILE_BYTES)} per-file limit for video rendering. Re-encode or shorten the asset.`
+        );
+      }
+      if (fileCount + 1 > MAX_RENDER_MEDIA_FILES) {
+        throw new Error(
+          `Document references more than ${MAX_RENDER_MEDIA_FILES} media files, which exceeds the limit for video rendering (adding "${path}").`
+        );
+      }
+      if (totalBytes + data.byteLength > MAX_RENDER_MEDIA_TOTAL_BYTES) {
+        throw new Error(
+          `Total embedded media exceeds the ${mib(MAX_RENDER_MEDIA_TOTAL_BYTES)} limit for video rendering (adding "${path}" would reach ${mib(totalBytes + data.byteLength)}). Reduce the document's media.`
+        );
+      }
+      totalBytes += data.byteLength;
+      fileCount += 1;
+    }
+  };
+}
+
 // src/registry.ts
 import { randomBytes } from "crypto";
 import { readFile, rm } from "fs/promises";
@@ -462,9 +501,67 @@ async function readMarkdownFile(filePath, signal) {
   const markdownDoc = parseMarkdown(content);
   return { doc: markdownToDoc(markdownDoc), container, markdownDoc, sourceFormat: "md" };
 }
+function parseDocJson(content, source) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`${source} is not valid JSON: ${detail}`);
+  }
+  const fail = (detail) => {
+    throw new Error(`${source} is not a valid squisq Doc: ${detail}`);
+  };
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    fail(`expected a JSON object, got ${Array.isArray(parsed) ? "an array" : typeof parsed}`);
+  }
+  const doc = parsed;
+  if (!Array.isArray(doc.blocks)) {
+    fail(`"blocks" must be an array${doc.blocks === void 0 ? " (field is missing)" : ""}`);
+  }
+  for (const [index, block] of doc.blocks.entries()) {
+    if (typeof block !== "object" || block === null || Array.isArray(block)) {
+      fail(`"blocks[${index}]" must be an object`);
+    }
+  }
+  if (doc.duration !== void 0 && !isFiniteNumber(doc.duration)) {
+    fail(`"duration" must be a finite number, got ${describe(doc.duration)}`);
+  }
+  if (doc.audio !== void 0) {
+    if (typeof doc.audio !== "object" || doc.audio === null || Array.isArray(doc.audio)) {
+      fail('"audio" must be an object');
+    }
+    const segments = doc.audio.segments;
+    if (segments !== void 0) {
+      if (!Array.isArray(segments)) fail('"audio.segments" must be an array');
+      for (const [index, segment] of segments.entries()) {
+        if (typeof segment !== "object" || segment === null) {
+          fail(`"audio.segments[${index}]" must be an object`);
+        }
+        if (!isFiniteNumber(segment.duration)) {
+          fail(
+            `"audio.segments[${index}].duration" must be a finite number, got ${describe(segment.duration)}`
+          );
+        }
+      }
+    }
+  }
+  return {
+    ...doc,
+    audio: doc.audio ?? { segments: [] }
+  };
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function describe(value) {
+  if (typeof value === "number") return Number.isNaN(value) ? "NaN" : String(value);
+  if (typeof value === "string") return JSON.stringify(value);
+  return value === null ? "null" : typeof value;
+}
 async function readDocJsonFile(filePath, signal) {
   const content = await readUtf8File(filePath, signal);
-  const doc = JSON.parse(content);
+  const doc = parseDocJson(content, filePath);
   const container = new MemoryContentContainer();
   return { doc, container, sourceFormat: "json" };
 }
@@ -508,7 +605,7 @@ async function resolveContainer(container, sourceFormat, missingMessage, signal)
     const jsonData = await container.readFile(name);
     throwIfAborted(signal);
     if (jsonData) {
-      const doc = JSON.parse(new TextDecoder().decode(jsonData));
+      const doc = parseDocJson(new TextDecoder().decode(jsonData), name);
       return { doc, container, sourceFormat };
     }
   }
@@ -595,12 +692,16 @@ async function captureDocFrames(doc, container, options) {
   signal?.throwIfAborted();
   const { collectImagePaths } = await import("@bendyline/squisq-formats/html");
   signal?.throwIfAborted();
+  const budget = createMediaBudget();
   const images = /* @__PURE__ */ new Map();
   for (const imgPath of collectImagePaths(doc)) {
     signal?.throwIfAborted();
     const data = await container.readFile(imgPath);
     signal?.throwIfAborted();
-    if (data) images.set(imgPath, data);
+    if (data) {
+      budget.admit(imgPath, data);
+      images.set(imgPath, data);
+    }
   }
   const audio = /* @__PURE__ */ new Map();
   for (const seg of doc.audio?.segments ?? []) {
@@ -608,6 +709,7 @@ async function captureDocFrames(doc, container, options) {
     const data = await container.readFile(seg.src);
     signal?.throwIfAborted();
     if (data) {
+      budget.admit(seg.src, data);
       audio.set(seg.src, data);
       audio.set(seg.name, data);
     }
@@ -623,7 +725,10 @@ async function captureDocFrames(doc, container, options) {
     if (images.has(src)) continue;
     const data = await container.readFile(src);
     signal?.throwIfAborted();
-    if (data) images.set(src, data);
+    if (data) {
+      budget.admit(src, data);
+      images.set(src, data);
+    }
   }
   onProgress?.("generating render HTML", 10);
   signal?.throwIfAborted();
@@ -667,6 +772,11 @@ async function captureDocFrames(doc, container, options) {
     const page = await browser.newPage({ viewport: { width, height } });
     const pageErrors = [];
     page.on("pageerror", (err) => pageErrors.push(err.message));
+    await page.route("**/*", async (route) => {
+      const url = route.request().url();
+      if (/^(?:about:|blob:|data:)/i.test(url)) await route.continue();
+      else await route.abort("blockedbyclient");
+    });
     signal?.throwIfAborted();
     await page.setContent(renderHtml, { waitUntil: "load" });
     signal?.throwIfAborted();
@@ -784,7 +894,7 @@ async function renderDocToMp4(doc, container, options) {
       options.signal
     );
     options.signal?.throwIfAborted();
-    const { framesToMp4Native: framesToMp4Native2 } = await import("./nativeEncoder-ET3HUSOE.js");
+    const { framesToMp4Native: framesToMp4Native2 } = await import("./nativeEncoder-RZ3T4Z6S.js");
     await framesToMp4Native2(capture.ffmpegPath, capture.frames, encodingAudio, options.outputPath, {
       fps,
       quality,
@@ -839,7 +949,7 @@ async function renderDocToGif(doc, container, options) {
   try {
     options.onProgress?.("encoding GIF", 80);
     options.signal?.throwIfAborted();
-    const { framesToGifNative: framesToGifNative2 } = await import("./nativeEncoder-ET3HUSOE.js");
+    const { framesToGifNative: framesToGifNative2 } = await import("./nativeEncoder-RZ3T4Z6S.js");
     await framesToGifNative2(capture.ffmpegPath, capture.frames, options.outputPath, {
       fps,
       orientation,
@@ -925,4 +1035,3 @@ export {
   renderDocToGif,
   renderDocToMp4
 };
-//# sourceMappingURL=api.js.map

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

@@ -15,18 +15,47 @@ import {
 
 // src/util/runFfmpeg.ts
 import { execFile } from "child_process";
+var FFMPEG_NOISE = /^(?:ffmpeg version |\s{2}(?:built with|configuration:|lib[a-z0-9]+\s+\d)|frame=|size=|video:|Press \[q\]|\s*Stream mapping:|\s*Metadata:|\s*Duration:|Input #|Output #|\s{4})/;
+var FFMPEG_ERRORISH = /error|invalid|failed|not divisible|no such file|permission denied|unable to|unrecognized|does not contain|conversion failed/i;
+function lastMeaningfulFfmpegLine(stderr) {
+  const lines = stderr.split(/\r?\n/).map((line) => line.replace(/ @ 0x[0-9a-f]+/gi, "").trimEnd()).filter((line) => line.trim().length > 0 && !FFMPEG_NOISE.test(line));
+  if (lines.length === 0) return null;
+  const errorish = lines.find((line) => FFMPEG_ERRORISH.test(line));
+  return (errorish ?? lines[lines.length - 1]).trim();
+}
+function describeFfmpegFailure(err, stderr, timeoutMs) {
+  if (err.code === "ENOENT") {
+    return "the ffmpeg binary could not be started (ENOENT). Run `squisq doctor` to check your FFmpeg installation.";
+  }
+  const detail = lastMeaningfulFfmpegLine(stderr);
+  if (err.killed) {
+    const seconds = Math.round(timeoutMs / 1e3);
+    return `it timed out after ${seconds}s${detail ? ` (last output: ${detail})` : ""}.`;
+  }
+  const exit = typeof err.code === "number" ? ` (exit code ${err.code})` : "";
+  return detail ? `${detail}${exit}` : `ffmpeg exited unsuccessfully${exit}.`;
+}
 async function runFfmpeg(command, args, options) {
   options.signal?.throwIfAborted();
   await new Promise((resolve, reject) => {
-    execFile(command, [...args], { timeout: options.timeoutMs, signal: options.signal }, (err) => {
-      if (options.signal?.aborted) {
-        reject(options.signal.reason);
-      } else if (err) {
-        reject(new Error(`${options.failureMessage}: ${err.message}`));
-      } else {
-        resolve();
+    execFile(
+      command,
+      [...args],
+      { timeout: options.timeoutMs, signal: options.signal },
+      (err, _stdout, stderr) => {
+        if (options.signal?.aborted) {
+          reject(options.signal.reason);
+        } else if (err) {
+          reject(
+            new Error(
+              `${options.failureMessage}: ${describeFfmpegFailure(err, stderr ?? "", options.timeoutMs)}`
+            )
+          );
+        } else {
+          resolve();
+        }
       }
-    });
+    );
   });
   options.signal?.throwIfAborted();
 }
@@ -207,4 +236,3 @@ export {
   framesToGifNative,
   framesToGifNativeBytes
 };
-//# sourceMappingURL=chunk-JDHONKFZ.js.map

package/dist/{chunk-FVFK4ZJU.js → chunk-GYHQHKO5.js}

@@ -2,7 +2,7 @@
 import {
   GIF_EXPORT_DEFAULTS,
   runFfmpeg
-} from "./chunk-JDHONKFZ.js";
+} from "./chunk-GGVASRPG.js";
 
 // src/api.ts
 import { resolveMediaSchedule } from "@bendyline/squisq/schemas";
@@ -228,6 +228,45 @@ function resolveAppliedCoverPreRoll(requestedSeconds, hasCover) {
   return hasCover ? requestedSeconds : 0;
 }
 
+// src/util/mediaBudget.ts
+var MAX_RENDER_MEDIA_FILE_BYTES = 64 * 1024 * 1024;
+var MAX_RENDER_MEDIA_TOTAL_BYTES = 256 * 1024 * 1024;
+var MAX_RENDER_MEDIA_FILES = 256;
+function mib(bytes) {
+  return `${Math.round(bytes / (1024 * 1024))} MB`;
+}
+function createMediaBudget() {
+  let totalBytes = 0;
+  let fileCount = 0;
+  return {
+    get totalBytes() {
+      return totalBytes;
+    },
+    get fileCount() {
+      return fileCount;
+    },
+    admit(path, data) {
+      if (data.byteLength > MAX_RENDER_MEDIA_FILE_BYTES) {
+        throw new Error(
+          `Media file "${path}" is ${mib(data.byteLength)}, which exceeds the ${mib(MAX_RENDER_MEDIA_FILE_BYTES)} per-file limit for video rendering. Re-encode or shorten the asset.`
+        );
+      }
+      if (fileCount + 1 > MAX_RENDER_MEDIA_FILES) {
+        throw new Error(
+          `Document references more than ${MAX_RENDER_MEDIA_FILES} media files, which exceeds the limit for video rendering (adding "${path}").`
+        );
+      }
+      if (totalBytes + data.byteLength > MAX_RENDER_MEDIA_TOTAL_BYTES) {
+        throw new Error(
+          `Total embedded media exceeds the ${mib(MAX_RENDER_MEDIA_TOTAL_BYTES)} limit for video rendering (adding "${path}" would reach ${mib(totalBytes + data.byteLength)}). Reduce the document's media.`
+        );
+      }
+      totalBytes += data.byteLength;
+      fileCount += 1;
+    }
+  };
+}
+
 // src/registry.ts
 import { randomBytes } from "crypto";
 import { readFile, rm } from "fs/promises";
@@ -268,7 +307,7 @@ function mp4Format() {
       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-LE75OSRQ.js");
+        const { renderDocToMp4: renderDocToMp42 } = await import("./api-5SX73ZKT.js");
         await renderDocToMp42(input.doc, input.container, {
           outputPath,
           fps,
@@ -308,7 +347,7 @@ function gifFormat() {
       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-LE75OSRQ.js");
+        const { renderDocToGif: renderDocToGif2 } = await import("./api-5SX73ZKT.js");
         const result = await renderDocToGif2(input.doc, input.container, {
           outputPath,
           fps: typeof gifOpts.fps === "number" ? gifOpts.fps : GIF_DEFAULTS.fps,
@@ -459,9 +498,67 @@ async function readMarkdownFile(filePath, signal) {
   const markdownDoc = parseMarkdown(content);
   return { doc: markdownToDoc(markdownDoc), container, markdownDoc, sourceFormat: "md" };
 }
+function parseDocJson(content, source) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`${source} is not valid JSON: ${detail}`);
+  }
+  const fail = (detail) => {
+    throw new Error(`${source} is not a valid squisq Doc: ${detail}`);
+  };
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    fail(`expected a JSON object, got ${Array.isArray(parsed) ? "an array" : typeof parsed}`);
+  }
+  const doc = parsed;
+  if (!Array.isArray(doc.blocks)) {
+    fail(`"blocks" must be an array${doc.blocks === void 0 ? " (field is missing)" : ""}`);
+  }
+  for (const [index, block] of doc.blocks.entries()) {
+    if (typeof block !== "object" || block === null || Array.isArray(block)) {
+      fail(`"blocks[${index}]" must be an object`);
+    }
+  }
+  if (doc.duration !== void 0 && !isFiniteNumber(doc.duration)) {
+    fail(`"duration" must be a finite number, got ${describe(doc.duration)}`);
+  }
+  if (doc.audio !== void 0) {
+    if (typeof doc.audio !== "object" || doc.audio === null || Array.isArray(doc.audio)) {
+      fail('"audio" must be an object');
+    }
+    const segments = doc.audio.segments;
+    if (segments !== void 0) {
+      if (!Array.isArray(segments)) fail('"audio.segments" must be an array');
+      for (const [index, segment] of segments.entries()) {
+        if (typeof segment !== "object" || segment === null) {
+          fail(`"audio.segments[${index}]" must be an object`);
+        }
+        if (!isFiniteNumber(segment.duration)) {
+          fail(
+            `"audio.segments[${index}].duration" must be a finite number, got ${describe(segment.duration)}`
+          );
+        }
+      }
+    }
+  }
+  return {
+    ...doc,
+    audio: doc.audio ?? { segments: [] }
+  };
+}
+function isFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+function describe(value) {
+  if (typeof value === "number") return Number.isNaN(value) ? "NaN" : String(value);
+  if (typeof value === "string") return JSON.stringify(value);
+  return value === null ? "null" : typeof value;
+}
 async function readDocJsonFile(filePath, signal) {
   const content = await readUtf8File(filePath, signal);
-  const doc = JSON.parse(content);
+  const doc = parseDocJson(content, filePath);
   const container = new MemoryContentContainer();
   return { doc, container, sourceFormat: "json" };
 }
@@ -505,7 +602,7 @@ async function resolveContainer(container, sourceFormat, missingMessage, signal)
     const jsonData = await container.readFile(name);
     throwIfAborted(signal);
     if (jsonData) {
-      const doc = JSON.parse(new TextDecoder().decode(jsonData));
+      const doc = parseDocJson(new TextDecoder().decode(jsonData), name);
       return { doc, container, sourceFormat };
     }
   }
@@ -592,12 +689,16 @@ async function captureDocFrames(doc, container, options) {
   signal?.throwIfAborted();
   const { collectImagePaths } = await import("@bendyline/squisq-formats/html");
   signal?.throwIfAborted();
+  const budget = createMediaBudget();
   const images = /* @__PURE__ */ new Map();
   for (const imgPath of collectImagePaths(doc)) {
     signal?.throwIfAborted();
     const data = await container.readFile(imgPath);
     signal?.throwIfAborted();
-    if (data) images.set(imgPath, data);
+    if (data) {
+      budget.admit(imgPath, data);
+      images.set(imgPath, data);
+    }
   }
   const audio = /* @__PURE__ */ new Map();
   for (const seg of doc.audio?.segments ?? []) {
@@ -605,6 +706,7 @@ async function captureDocFrames(doc, container, options) {
     const data = await container.readFile(seg.src);
     signal?.throwIfAborted();
     if (data) {
+      budget.admit(seg.src, data);
       audio.set(seg.src, data);
       audio.set(seg.name, data);
     }
@@ -620,7 +722,10 @@ async function captureDocFrames(doc, container, options) {
     if (images.has(src)) continue;
     const data = await container.readFile(src);
     signal?.throwIfAborted();
-    if (data) images.set(src, data);
+    if (data) {
+      budget.admit(src, data);
+      images.set(src, data);
+    }
   }
   onProgress?.("generating render HTML", 10);
   signal?.throwIfAborted();
@@ -664,6 +769,11 @@ async function captureDocFrames(doc, container, options) {
     const page = await browser.newPage({ viewport: { width, height } });
     const pageErrors = [];
     page.on("pageerror", (err) => pageErrors.push(err.message));
+    await page.route("**/*", async (route) => {
+      const url = route.request().url();
+      if (/^(?:about:|blob:|data:)/i.test(url)) await route.continue();
+      else await route.abort("blockedbyclient");
+    });
     signal?.throwIfAborted();
     await page.setContent(renderHtml, { waitUntil: "load" });
     signal?.throwIfAborted();
@@ -781,7 +891,7 @@ async function renderDocToMp4(doc, container, options) {
       options.signal
     );
     options.signal?.throwIfAborted();
-    const { framesToMp4Native: framesToMp4Native2 } = await import("./nativeEncoder-LRPK2YV5.js");
+    const { framesToMp4Native: framesToMp4Native2 } = await import("./nativeEncoder-PMVSFLMN.js");
     await framesToMp4Native2(capture.ffmpegPath, capture.frames, encodingAudio, options.outputPath, {
       fps,
       quality,
@@ -836,7 +946,7 @@ async function renderDocToGif(doc, container, options) {
   try {
     options.onProgress?.("encoding GIF", 80);
     options.signal?.throwIfAborted();
-    const { framesToGifNative: framesToGifNative2 } = await import("./nativeEncoder-LRPK2YV5.js");
+    const { framesToGifNative: framesToGifNative2 } = await import("./nativeEncoder-PMVSFLMN.js");
     await framesToGifNative2(capture.ffmpegPath, capture.frames, options.outputPath, {
       fps,
       orientation,
@@ -920,4 +1030,3 @@ export {
   ConversionError,
   createCliRegistry
 };
-//# sourceMappingURL=chunk-FVFK4ZJU.js.map

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

@@ -13,18 +13,47 @@ import {
 
 // src/util/runFfmpeg.ts
 import { execFile } from "child_process";
+var FFMPEG_NOISE = /^(?:ffmpeg version |\s{2}(?:built with|configuration:|lib[a-z0-9]+\s+\d)|frame=|size=|video:|Press \[q\]|\s*Stream mapping:|\s*Metadata:|\s*Duration:|Input #|Output #|\s{4})/;
+var FFMPEG_ERRORISH = /error|invalid|failed|not divisible|no such file|permission denied|unable to|unrecognized|does not contain|conversion failed/i;
+function lastMeaningfulFfmpegLine(stderr) {
+  const lines = stderr.split(/\r?\n/).map((line) => line.replace(/ @ 0x[0-9a-f]+/gi, "").trimEnd()).filter((line) => line.trim().length > 0 && !FFMPEG_NOISE.test(line));
+  if (lines.length === 0) return null;
+  const errorish = lines.find((line) => FFMPEG_ERRORISH.test(line));
+  return (errorish ?? lines[lines.length - 1]).trim();
+}
+function describeFfmpegFailure(err, stderr, timeoutMs) {
+  if (err.code === "ENOENT") {
+    return "the ffmpeg binary could not be started (ENOENT). Run `squisq doctor` to check your FFmpeg installation.";
+  }
+  const detail = lastMeaningfulFfmpegLine(stderr);
+  if (err.killed) {
+    const seconds = Math.round(timeoutMs / 1e3);
+    return `it timed out after ${seconds}s${detail ? ` (last output: ${detail})` : ""}.`;
+  }
+  const exit = typeof err.code === "number" ? ` (exit code ${err.code})` : "";
+  return detail ? `${detail}${exit}` : `ffmpeg exited unsuccessfully${exit}.`;
+}
 async function runFfmpeg(command, args, options) {
   options.signal?.throwIfAborted();
   await new Promise((resolve, reject) => {
-    execFile(command, [...args], { timeout: options.timeoutMs, signal: options.signal }, (err) => {
-      if (options.signal?.aborted) {
-        reject(options.signal.reason);
-      } else if (err) {
-        reject(new Error(`${options.failureMessage}: ${err.message}`));
-      } else {
-        resolve();
+    execFile(
+      command,
+      [...args],
+      { timeout: options.timeoutMs, signal: options.signal },
+      (err, _stdout, stderr) => {
+        if (options.signal?.aborted) {
+          reject(options.signal.reason);
+        } else if (err) {
+          reject(
+            new Error(
+              `${options.failureMessage}: ${describeFfmpegFailure(err, stderr ?? "", options.timeoutMs)}`
+            )
+          );
+        } else {
+          resolve();
+        }
       }
-    });
+    );
   });
   options.signal?.throwIfAborted();
 }
@@ -205,4 +234,3 @@ export {
   framesToGifNative,
   framesToGifNativeBytes
 };
-//# sourceMappingURL=chunk-OEN2RADG.js.map