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

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>;
@@ -124,6 +130,10 @@ interface CaptionStyle {
   /** bottom inset as a fraction of scene height; defaults 0.10 (landscape) / 0.18 (portrait) */
   bottomInsetFrac?: number;
   lineHeight?: number;
+  /** lines a caption may use before it auto-shrinks to fit; default 2 */
+  maxLines?: number;
+  /** floor for auto-shrink, as a fraction of the base font size; default 0.7 */
+  minScale?: number;
 }
 /**
  * Bottom-centered captions inside the platform-safe area: portrait scenes

package/dist/index.js

@@ -1,5 +1,5 @@
 import { key, track } from "@glissade/core";
-import { Text, glow } from "@glissade/scene";
+import { Text, breakLines, estimatingMeasurer, glow, quantize } from "@glissade/scene";
 //#region src/index.ts
 /**
 * @glissade/narrate — narration + captions, the PURE side. TTS happens only
@@ -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";
@@ -93,18 +99,47 @@ function captionTrack(timing, opts = {}) {
 function captionNode(size, style = {}) {
 	const portrait = size.h > size.w;
 	const inset = style.bottomInsetFrac ?? (portrait ? .18 : .1);
-	return new Text({
+	const baseFont = style.fontSize ?? Math.round(Math.min(size.w, size.h) * (portrait ? .052 : .06));
+	const fontFamily = style.fontFamily ?? "sans-serif";
+	const width = Math.round(size.w * (style.widthFrac ?? .82));
+	const lineHeight = style.lineHeight ?? 1.3;
+	const maxLines = Math.max(1, style.maxLines ?? 2);
+	const minFont = Math.max(1, Math.round(baseFont * (style.minScale ?? .7)));
+	const bottomY = Math.round(size.h * (1 - inset));
+	const node = new Text({
 		id: "captions",
 		text: "",
 		align: "center",
-		fontSize: style.fontSize ?? Math.round(Math.min(size.w, size.h) * (portrait ? .052 : .06)),
+		fontSize: baseFont,
 		...style.fontFamily !== void 0 ? { fontFamily: style.fontFamily } : {},
 		fill: style.fill ?? "#ffffff",
-		width: Math.round(size.w * (style.widthFrac ?? .82)),
-		lineHeight: style.lineHeight ?? 1.3,
-		position: [size.w / 2, Math.round(size.h * (1 - inset))],
+		width,
+		lineHeight,
+		position: [size.w / 2, bottomY],
 		filters: style.filters ?? glow("#000000cc", 3, 1)
 	});
+	const lineCountAt = (font, m) => {
+		const t = node.text();
+		if (!t) return 0;
+		return breakLines(t, {
+			family: fontFamily,
+			size: font,
+			weight: node.fontWeight
+		}, width > 0 ? width : void 0, m).length;
+	};
+	node.fontSize.bindSource(() => {
+		const m = node.measurerSource?.() ?? estimatingMeasurer;
+		let font = baseFont;
+		while (font > minFont && lineCountAt(font, m) > maxLines) font -= 1;
+		return font;
+	});
+	node.position.bindSource(() => {
+		const m = node.measurerSource?.() ?? estimatingMeasurer;
+		const lines = Math.max(1, lineCountAt(node.fontSize(), m));
+		const step = quantize(node.fontSize() * lineHeight);
+		return [size.w / 2, bottomY - (lines - 1) * step];
+	});
+	return node;
 }
 /**
 * The bed-ducking envelope every narrated video needs: duck windows are the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/narrate",
-  "version": "0.5.0-pre.3",
+  "version": "0.5.0-pre.5",
   "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.5",
+    "@glissade/scene": "0.5.0-pre.5"
   },
   "repository": {
     "type": "git",