@glissade/cli 0.12.0-pre.1 → 0.12.1

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/cli",
-  "version": "0.12.0-pre.1",
+  "version": "0.12.1",
   "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-pre.1",
-    "@glissade/core": "0.12.0-pre.1",
-    "@glissade/interact": "0.12.0-pre.1",
-    "@glissade/lottie": "0.12.0-pre.1",
-    "@glissade/svg": "0.12.0-pre.1",
-    "@glissade/narrate": "0.12.0-pre.1",
-    "@glissade/player": "0.12.0-pre.1",
-    "@glissade/scene": "0.12.0-pre.1",
-    "@glissade/sfx": "0.12.0-pre.1"
+    "@glissade/backend-skia": "0.12.1",
+    "@glissade/core": "0.12.1",
+    "@glissade/interact": "0.12.1",
+    "@glissade/lottie": "0.12.1",
+    "@glissade/svg": "0.12.1",
+    "@glissade/narrate": "0.12.1",
+    "@glissade/player": "0.12.1",
+    "@glissade/scene": "0.12.1",
+    "@glissade/sfx": "0.12.1"
   },
   "repository": {
     "type": "git",