@glissade/narrate 0.12.0 → 0.13.0-pre.0

package/dist/index.d.ts

@@ -74,6 +74,23 @@ interface NarrationScript {
    * the committed JSON. A segment's own `maxSec` wins over an entry here.
    */
   budgets?: Record<string, number>;
+  /**
+   * How captions are delivered. `'burn'` = baked into the video frame (a fixed
+   * box that CANNOT scroll) — declaring it ESCALATES `gs narration-lint`'s
+   * caption-fit rule to Tier-1 (a hard, CI-failing error), because an overflow
+   * is unrecoverable at play time. `'sidecar'` = player-wrapped .srt/.vtt with
+   * no fixed box; caption-fit stays Tier-2 (warn-only). Omitted → sidecar
+   * semantics (warn-only) so a project that never declared intent exits 0.
+   * The signal lives HERE, in the committed script (it travels with the content),
+   * not behind a CLI flag (which drifts in CI config). Persisted into the manifest.
+   */
+  captionMode?: 'burn' | 'sidecar';
+  /**
+   * A per-script caption-fit budget: the max wrapped lines a caption may use.
+   * Declaring it is an explicit caption-fit INTENT, so — like `captionMode:'burn'`
+   * — it ESCALATES caption-fit to Tier-1 (CI-failing). Persisted into the manifest.
+   */
+  captionMaxLines?: number;
   /** spoken segments and explicit pause beats, in playback order */
   segments: NarrationElement[];
 }
@@ -120,6 +137,18 @@ interface NarrationTiming {
    * segment's own `maxSec` (on the TimedSegment) wins over an entry here.
    */
   budgets?: Record<string, number>;
+  /**
+   * Caption delivery mode carried from the script. `'burn'` escalates
+   * `gs narration-lint`'s caption-fit rule to Tier-1 (CI-failing); `'sidecar'`
+   * / omitted keeps it Tier-2 (warn-only). Persisted so the lint reads intent
+   * from the committed manifest, no CLI flag.
+   */
+  captionMode?: 'burn' | 'sidecar';
+  /**
+   * Per-script caption-fit budget (max wrapped lines) carried from the script.
+   * Its presence ESCALATES caption-fit to Tier-1, like `captionMode:'burn'`.
+   */
+  captionMaxLines?: number;
 }
 declare class NarrationError extends Error {
   constructor(message: string);

package/dist/providers.js

@@ -332,8 +332,9 @@ function kokoroProvider(opts = {}) {
 			return Promise.resolve(`kokoro-js ${version} ${basename(modelId)} dtype=${dtype}`);
 		},
 		synthesize: async (req) => {
-			const tts = await getModel();
 			const voice = req.voice ?? opts.voice ?? KOKORO_DEFAULT_VOICE;
+			if (voice.startsWith("zf_") || voice.startsWith("zm_")) throw new NarrationError("kokoro Chinese voices (z*) need misaki[zh] g2p (pinyin+jieba), which is not wired — kokoro-js routes zh through espeak-ng cmn (mismatched phonemes → garbled). Use --provider piper for Chinese. (tracked: card 24vKUw2HVC6D)");
+			const tts = await getModel();
 			const genOpts = req.rate !== void 0 && req.rate > 0 ? {
 				voice,
 				speed: req.rate
@@ -666,7 +667,9 @@ async function synthesizeScript(scriptPath, opts = {}) {
 		segments,
 		...pauses.length > 0 ? { pauses } : {},
 		...raw.captionSplit ? { captionSplit: raw.captionSplit } : {},
-		...raw.budgets && Object.keys(raw.budgets).length > 0 ? { budgets: raw.budgets } : {}
+		...raw.budgets && Object.keys(raw.budgets).length > 0 ? { budgets: raw.budgets } : {},
+		...raw.captionMode !== void 0 ? { captionMode: raw.captionMode } : {},
+		...raw.captionMaxLines !== void 0 ? { captionMaxLines: raw.captionMaxLines } : {}
 	};
 	const timingPath = `${base}.narration.timing.json`;
 	writeFileSync(timingPath, JSON.stringify(timing, null, 2) + "\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/narrate",
-  "version": "0.12.0",
+  "version": "0.13.0-pre.0",
   "description": "glissade narration + captions: TTS at prepare time (gs narrate), deterministic caching, narration-anchored timeline beats, and captions as plain tracks. Render stays offline.",
   "license": "Apache-2.0",
   "engines": {
@@ -22,8 +22,8 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/core": "0.12.0",
-    "@glissade/scene": "0.12.0"
+    "@glissade/core": "0.13.0-pre.0",
+    "@glissade/scene": "0.13.0-pre.0"
   },
   "peerDependencies": {
     "kokoro-js": "^1.2.0"