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

package/dist/index.d.ts

@@ -130,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
@@ -99,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.4",
+  "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.4",
-    "@glissade/scene": "0.5.0-pre.4"
+    "@glissade/core": "0.5.0-pre.5",
+    "@glissade/scene": "0.5.0-pre.5"
   },
   "repository": {
     "type": "git",