@glissade/narrate 0.5.0-pre.3 → 0.5.0-pre.4

package/dist/index.d.ts

@@ -97,6 +97,12 @@ interface NarrationAnchors {
   duration(id: string): number;
   /** start + offset — a sub-beat inside a segment or pause window */
   at(id: string, offset?: number): number;
+  /**
+   * Assert every id exists in the manifest — a build-time fast-fail that lists
+   * ALL unknown ids at once (vs. discovering stale refs one render at a time
+   * after rewiring). Returns the anchors, so chain it: `narration(t).require([...])`.
+   */
+  require(ids: readonly string[]): NarrationAnchors;
   readonly totalDuration: number;
   /** '<id>.start' / '<id>.end' labels (segments + pauses) — merge into the timeline for studio visibility */
   labels(): Record<string, number>;

package/dist/index.js

@@ -39,11 +39,16 @@ function narration(timing) {
 		if (!b) throw new NarrationError(`no narration beat '${id}' (have: ${[...byId.keys()].join(", ")})`);
 		return b;
 	};
-	return {
+	const anchors = {
 		start: (id) => beat(id).start,
 		end: (id) => beat(id).start + beat(id).duration,
 		duration: (id) => beat(id).duration,
 		at: (id, offset = 0) => beat(id).start + offset,
+		require: (ids) => {
+			const missing = ids.filter((id) => !byId.has(id));
+			if (missing.length > 0) throw new NarrationError(`narration references unknown id${missing.length > 1 ? "s" : ""} ${missing.map((m) => `'${m}'`).join(", ")} — have: ${[...byId.keys()].join(", ")}`);
+			return anchors;
+		},
 		totalDuration: timing.totalDuration,
 		labels: () => {
 			const out = {};
@@ -69,6 +74,7 @@ function narration(timing) {
 			return out;
 		}
 	};
+	return anchors;
 }
 function captionTrack(timing, opts = {}) {
 	const target = opts.target ?? "captions/text";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/narrate",
-  "version": "0.5.0-pre.3",
+  "version": "0.5.0-pre.4",
   "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",
   "type": "module",
@@ -19,8 +19,8 @@
     "dist"
   ],
   "dependencies": {
-    "@glissade/core": "0.5.0-pre.3",
-    "@glissade/scene": "0.5.0-pre.3"
+    "@glissade/core": "0.5.0-pre.4",
+    "@glissade/scene": "0.5.0-pre.4"
   },
   "repository": {
     "type": "git",