@glissade/cli 0.12.0 → 0.13.0-pre.0

package/dist/cli.js

@@ -1,22 +1,27 @@
 #!/usr/bin/env node
 import { c as render, o as parseFrameRange } from "./render.js";
 import { n as parseCaptionsMode } from "./captions.js";
-//#region src/cli.ts
+//#region src/args.ts
 /**
-* gs — the glissade CLI (DESIGN.md §5.7).
-*   gs render <scene-module> [--out <dir|file.mp4|file.webm>] [--fps N] [--range a..b]
+* Tiny positional/flag argv parser for the `gs` CLI. Extracted from cli.ts so it
+* is unit-testable without importing the CLI entry point (which runs main() on
+* import).
 */
-function fail(msg) {
-	console.error(`gs: ${msg}`);
-	process.exit(1);
-}
-function parseCaptionsModeOrFail(raw) {
-	try {
-		return parseCaptionsMode(raw);
-	} catch (err) {
-		fail(err instanceof Error ? err.message : String(err));
-	}
-}
+const KNOWN_BOOLEAN_FLAGS = new Set([
+	"record",
+	"force",
+	"strict",
+	"cache",
+	"json",
+	"fix",
+	"no-warnings",
+	"lossless-intermediate",
+	"allow-gpu-shards",
+	"verbose",
+	"allow-degraded",
+	"bisect",
+	"watch"
+]);
 function parseArgs(argv) {
 	const positional = [];
 	const flags = /* @__PURE__ */ new Map();
@@ -26,11 +31,12 @@ function parseArgs(argv) {
 			const eq = a.indexOf("=");
 			if (eq >= 0) flags.set(a.slice(2, eq), a.slice(eq + 1));
 			else {
+				const name = a.slice(2);
 				const next = argv[i + 1];
-				if (next !== void 0 && !next.startsWith("--")) {
-					flags.set(a.slice(2), next);
+				if (!KNOWN_BOOLEAN_FLAGS.has(name) && next !== void 0 && !next.startsWith("--")) {
+					flags.set(name, next);
 					i++;
-				} else flags.set(a.slice(2), "");
+				} else flags.set(name, "");
 			}
 		} else positional.push(a);
 	}
@@ -39,6 +45,23 @@ function parseArgs(argv) {
 		flags
 	};
 }
+//#endregion
+//#region src/cli.ts
+/**
+* gs — the glissade CLI (DESIGN.md §5.7).
+*   gs render <scene-module> [--out <dir|file.mp4|file.webm>] [--fps N] [--range a..b]
+*/
+function fail(msg) {
+	console.error(`gs: ${msg}`);
+	process.exit(1);
+}
+function parseCaptionsModeOrFail(raw) {
+	try {
+		return parseCaptionsMode(raw);
+	} catch (err) {
+		fail(err instanceof Error ? err.message : String(err));
+	}
+}
 const USAGE = `usage:
   gs render <scene-module> [options]
   gs diff <scene-module> --at <t> --against <baseline.dl.json|.png>
@@ -66,7 +89,7 @@ render options:
   --lossless-intermediate  render shards as FFV1 + one final encode — the guaranteed byte-correct join
                    (auto-enabled when the encoder can't honor precise boundary keyframes, e.g. mpeg4/openh264)
   --allow-gpu-shards  permit sharding a scene with GPU/shader nodes (output is not reproducible across shards; §3.7)
-  --cache [<dir>]  persistent whole-frame raster cache in <dir> (default .gscache; §3.5). OFF by default — opting in
+  --cache[=<dir>]  persistent whole-frame raster cache in <dir> (default .gscache; §3.5). OFF by default — opting in
                    never changes output, only speed. A hit serves a stored frame byte-identical to a cold render.
                    WINS: repeated renders + the UNCHANGED-PREFIX of a single-segment edit. Does NOT win a re-narrate —
                    that shifts every frame's timing, so every DisplayList changes and every frame MISSES. Shards share

package/dist/index.d.ts

@@ -688,6 +688,13 @@ interface LintOptions {
   caption?: CaptionProbe;
   /** include Tier-2 (warn-only) diagnostics; default true */
   warnings?: boolean;
+  /**
+   * Caller-supplied caption mode (e.g. the render config is burning captions).
+   * MAY escalate caption-fit to Tier-1 — but the committed script's own
+   * `captionMode` (on the timing manifest) is the authoritative signal and
+   * takes precedence. Omit to defer entirely to the manifest.
+   */
+  captionMode?: 'burn' | 'sidecar';
 }
 /**
  * Lint the committed narration timing. Pure: same inputs (timing + the probe's

package/dist/loudness.js

@@ -41,6 +41,7 @@ var loudness_exports = /* @__PURE__ */ __exportAll({
 	PUBLISH_PROFILES: () => PUBLISH_PROFILES,
 	computeGainDb: () => computeGainDb,
 	computeMixHash: () => computeMixHash,
+	floorGain2: () => floorGain2,
 	loudnessPathFor: () => loudnessPathFor,
 	measureFile: () => measureFile,
 	measureLoudnessCommand: () => measureLoudnessCommand,
@@ -240,7 +241,7 @@ async function measureLoudnessCommand(opts) {
 			inputI: round2(inputI),
 			inputTp: round2(inputTp),
 			inputLra: round2(inputLra),
-			gain: round2(gain),
+			gain: floorGain2(gain),
 			mixHash
 		};
 		const loudnessPath = loudnessPathFor(opts.modulePath);
@@ -260,5 +261,6 @@ async function measureLoudnessCommand(opts) {
 	}
 }
 const round2 = (v) => Math.round(v * 100) / 100;
+const floorGain2 = (v) => Math.floor(v * 100) / 100;
 //#endregion
 export { computeGainDb as a, loudness_exports as c, parseLoudnormJson as d, peakClampBinds as f, PUBLISH_PROFILES as i, measureFile as l, resolveProfile as m, LOUDNESS_SCHEMA_VERSION as n, computeMixHash as o, readLoudness as p, LoudnessError as r, loudnessPathFor as s, DEFAULT_PROFILE_ID as t, measureLoudnessCommand as u };

package/dist/narrationLintCommand.js

@@ -99,17 +99,24 @@ function lintNarration(timing, opts = {}) {
 	};
 	for (const s of timing.segments) checkBudget(s.id, s.duration, s.maxSec ?? budgets[s.id]);
 	for (const p of timing.pauses ?? []) checkBudget(p.id, p.duration, budgets[p.id]);
-	if (opts.caption) {
+	const burnDeclared = (timing.captionMode ?? opts.captionMode) === "burn";
+	const linesDeclared = timing.captionMaxLines !== void 0;
+	const captionEscalated = burnDeclared || linesDeclared;
+	const captionTier = captionEscalated ? 1 : 2;
+	const runCaptionFit = captionEscalated || warnings;
+	const nudge = " — caption-fit is warn-only until you declare maxLines or captionMode:\"burn\" in the script";
+	const withNudge = (msg) => captionEscalated ? msg : msg + nudge;
+	if (opts.caption && runCaptionFit) {
 		const probe = opts.caption;
 		for (const c of cues) {
 			const id = cueId(c, perSeg.get(c.segId) ?? 1);
 			const { lines, bottomY } = probe.measure(c.text);
 			if (lines > probe.maxLines) out.push({
 				rule: "caption-fit",
-				tier: 1,
-				severity: "error",
+				tier: captionTier,
+				severity: captionEscalated ? "error" : "warn",
 				id,
-				message: `caption wraps to ${lines} lines, over maxLines ${probe.maxLines}`,
+				message: withNudge(`caption wraps to ${lines} lines, over maxLines ${probe.maxLines}`),
 				detail: {
 					lines,
 					maxLines: probe.maxLines,
@@ -118,10 +125,10 @@ function lintNarration(timing, opts = {}) {
 			});
 			else if (bottomY > probe.sceneH + 1e-6) out.push({
 				rule: "caption-fit",
-				tier: 1,
-				severity: "error",
+				tier: captionTier,
+				severity: captionEscalated ? "error" : "warn",
 				id,
-				message: `caption overflows the frame: its lowest line ends at y=${bottomY.toFixed(0)} of ${probe.sceneH}`,
+				message: withNudge(`caption overflows the frame: its lowest line ends at y=${bottomY.toFixed(0)} of ${probe.sceneH}`),
 				detail: {
 					bottomY: round(bottomY),
 					sceneH: probe.sceneH,

package/dist/verifyDeterminism.js

@@ -129,6 +129,11 @@ function parseManifest(json) {
 */
 function compareManifests(a, b) {
 	if (a.backend !== b.backend) throw new VerifyDeterminismError(`cross-backend byte-compare rejected: '${a.backend}' vs '${b.backend}'. Byte-equality is a Skia↔Skia (cross-machine/shard) guarantee only; browser↔Skia is perceptual (SSIM) parity, never byte-identity (§5.5 item 6).`);
+	if (a.fps !== b.fps || a.size.w !== b.size.w || a.size.h !== b.size.h) return {
+		ok: false,
+		compared: 0,
+		reason: `incomparable: baseline fps/size differs (a: ${a.fps}fps ${a.size.w}x${a.size.h} vs b: ${b.fps}fps ${b.size.w}x${b.size.h}). Same frame index = different wall-clock time when fps differs; a different size yields an incomparable RGBA hash. Re-render the baseline at the same fps/size.`
+	};
 	const byFrameB = new Map(b.frames.map((e) => [e.frame, e]));
 	let compared = 0;
 	let absent = 0;
@@ -144,6 +149,7 @@ function compareManifests(a, b) {
 		let node;
 		let groupFallback;
 		for (const [id, ha] of Object.entries(ea.nodes)) {
+			if (!(id in eb.nodes)) continue;
 			if (eb.nodes[id] === ha) continue;
 			if (groups.has(id)) {
 				groupFallback ??= id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/cli",
-  "version": "0.12.0",
+  "version": "0.13.0-pre.0",
   "description": "glissade CLI: headless rendering via backend-skia (+ FFmpeg mux).",
   "license": "Apache-2.0",
   "engines": {
@@ -23,15 +23,15 @@
     "@napi-rs/canvas": "^0.1.65",
     "esbuild": "^0.28.0",
     "jiti": "^2.4.2",
-    "@glissade/backend-skia": "0.12.0",
-    "@glissade/core": "0.12.0",
-    "@glissade/interact": "0.12.0",
-    "@glissade/lottie": "0.12.0",
-    "@glissade/svg": "0.12.0",
-    "@glissade/narrate": "0.12.0",
-    "@glissade/player": "0.12.0",
-    "@glissade/scene": "0.12.0",
-    "@glissade/sfx": "0.12.0"
+    "@glissade/backend-skia": "0.13.0-pre.0",
+    "@glissade/core": "0.13.0-pre.0",
+    "@glissade/interact": "0.13.0-pre.0",
+    "@glissade/lottie": "0.13.0-pre.0",
+    "@glissade/svg": "0.13.0-pre.0",
+    "@glissade/narrate": "0.13.0-pre.0",
+    "@glissade/player": "0.13.0-pre.0",
+    "@glissade/scene": "0.13.0-pre.0",
+    "@glissade/sfx": "0.13.0-pre.0"
   },
   "repository": {
     "type": "git",