@glissade/narrate 0.11.0 → 0.12.0-pre.1

package/dist/index.d.ts

@@ -11,6 +11,13 @@ interface NarrationSegment {
   rate?: number;
   /** silence after THIS segment (s); overrides the script default */
   gapAfter?: number;
+  /**
+   * Anchor budget (s): the longest this segment's spoken beat may run before
+   * `gs narration-lint` flags it (a re-narrate that overran its allotted beat).
+   * Committed with the script — versioned data, gated by CI. A script-level
+   * `budgets` entry keyed by this id is equivalent; a per-segment `maxSec` wins.
+   */
+  maxSec?: number;
 }
 /** What the music bed does across a pause window. */
 type BedMode = /** hold the current (ducked) level across the pause — no swell, the default */
@@ -60,6 +67,13 @@ interface NarrationScript {
   captionSplit?: {
     maxChars: number;
   };
+  /**
+   * Anchor budgets (s): per-id ceilings on a segment's (or pause's) beat length,
+   * checked by `gs narration-lint` (Tier-1, can fail CI). Committed with the
+   * script and persisted into the timing manifest so the lint reads them from
+   * the committed JSON. A segment's own `maxSec` wins over an entry here.
+   */
+  budgets?: Record<string, number>;
   /** spoken segments and explicit pause beats, in playback order */
   segments: NarrationElement[];
 }
@@ -78,6 +92,8 @@ interface TimedSegment {
   file: string;
   /** present only when the provider supplies word timestamps */
   words?: TimedWord[];
+  /** anchor budget (s) carried from the script's per-segment `maxSec`; lint reads it here */
+  maxSec?: number;
 }
 /** A resolved pause window in the committed manifest. */
 interface TimedPause {
@@ -98,6 +114,12 @@ interface NarrationTiming {
   captionSplit?: {
     maxChars: number;
   };
+  /**
+   * Anchor budgets (s) carried from the script — per id, segments + pauses.
+   * `gs narration-lint` reads them from the committed manifest (Tier-1). A
+   * segment's own `maxSec` (on the TimedSegment) wins over an entry here.
+   */
+  budgets?: Record<string, number>;
 }
 declare class NarrationError extends Error {
   constructor(message: string);

package/dist/providers.js

@@ -642,7 +642,8 @@ async function synthesizeScript(scriptPath, opts = {}) {
 			text: seg.text,
 			start: cursor,
 			duration,
-			file: entry.file
+			file: entry.file,
+			...seg.maxSec !== void 0 ? { maxSec: seg.maxSec } : {}
 		};
 		if (words) timed.words = words.map((w) => ({
 			word: w.word,
@@ -664,7 +665,8 @@ async function synthesizeScript(scriptPath, opts = {}) {
 		totalDuration: ends.length > 0 ? Math.max(...ends) : 0,
 		segments,
 		...pauses.length > 0 ? { pauses } : {},
-		...raw.captionSplit ? { captionSplit: raw.captionSplit } : {}
+		...raw.captionSplit ? { captionSplit: raw.captionSplit } : {},
+		...raw.budgets && Object.keys(raw.budgets).length > 0 ? { budgets: raw.budgets } : {}
 	};
 	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.11.0",
+  "version": "0.12.0-pre.1",
   "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/scene": "0.11.0",
-    "@glissade/core": "0.11.0"
+    "@glissade/core": "0.12.0-pre.1",
+    "@glissade/scene": "0.12.0-pre.1"
   },
   "peerDependencies": {
     "kokoro-js": "^1.2.0"