@glissade/cli 0.8.1 → 0.9.0-pre.1

package/dist/cli.js

@@ -61,6 +61,7 @@ render options:
   --music <m>      auto (default): mix a sibling *.music.timing.json bed, ducked under narration | off
   --sfx <m>        auto (default): mix effect hits from a sibling *.sfx.timing.json | off
   --chapters <m>   vtt: also write WebVTT chapters from cue markers (cues.json is always written when cues exist)
+  --strict         fail on an unregistered font family or an uncovered glyph (§3.6; default: warn)
 
 dev options:
   --record         add a Record button; writes .trace.json sidecars next to the module
@@ -191,6 +192,7 @@ async function main() {
 			...flags.has("trace") ? { trace: flags.get("trace") } : {},
 			...flags.has("state") ? { state: flags.get("state") } : {},
 			...flags.has("force") ? { force: true } : {},
+			...flags.has("strict") ? { strictFonts: true } : {},
 			captions: parseCaptionsModeOrFail(flags.get("captions")),
 			narration: flags.get("narration") === "off" ? "off" : "auto",
 			music: flags.get("music") === "off" ? "off" : "auto",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Scene, SceneModule, VideoFrameSource } from "@glissade/scene";
 import { AudioClip, Key, Timeline } from "@glissade/core";
+import { Scene, SceneModule, VideoFrameSource } from "@glissade/scene";
 import { Image } from "@napi-rs/canvas";
 
 //#region src/render.d.ts
@@ -32,6 +32,8 @@ interface RenderOptions {
   sfx?: 'auto' | 'off';
   /** also write WebVTT chapters from cue markers ('vtt'); cues.json is always written when cues exist. */
   chapters?: 'vtt' | 'off';
+  /** --strict: font validation throws on an unregistered family / missing glyph (§3.6). Default dev-warn. */
+  strictFonts?: boolean;
   onProgress?: (frame: number, total: number) => void;
 }
 declare class SceneModuleError extends Error {

package/dist/machines.js

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime.js";
 import { readFileSync } from "node:fs";
-import "@glissade/scene";
 import { compileTimeline, timeline } from "@glissade/core";
+import "@glissade/scene";
 import { bakeTrace, createMachine } from "@glissade/interact";
 //#region src/machines.ts
 /**

package/dist/render.js

@@ -3,8 +3,10 @@ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { readFile } from "node:fs/promises";
 import { createJiti } from "jiti";
-import { evaluate, withDeterminismGuards } from "@glissade/scene";
+import { buildFontRegistry } from "@glissade/core";
+import { evaluate, validateSceneFonts, withDeterminismGuards } from "@glissade/scene";
 import { SkiaBackend } from "@glissade/backend-skia";
 //#region src/render.ts
 /**
@@ -81,22 +83,30 @@ async function render(opts) {
 		await loadYogaLayoutEngine();
 	}
 	const videoSources = [];
-	for (const [assetId, ref] of Object.entries(doc.assets ?? {})) {
-		const { resolveAssetPath } = await import("./audioMix.js").then((n) => n.r);
-		if (ref.kind === "font") {
-			const { GlobalFonts } = await import("@napi-rs/canvas");
-			GlobalFonts.registerFromPath(resolveAssetPath(ref.url, opts.modulePath), assetId);
-		} else if (ref.kind === "image") {
-			const { loadImage } = await import("@napi-rs/canvas");
-			backend.setImageAsset(assetId, await loadImage(resolveAssetPath(ref.url, opts.modulePath)));
-		} else if (ref.kind === "video") {
-			if (!ffmpegAvailable()) throw new Error(`video asset '${assetId}' needs FFmpeg on PATH for frame extraction (§5.4)`);
-			const { FfmpegVideoFrameSource } = await import("./videoSource.js").then((n) => n.i);
-			const source = new FfmpegVideoFrameSource(resolveAssetPath(ref.url, opts.modulePath));
-			await source.warm(0, source.duration);
-			backend.setVideoAsset(assetId, source);
-			videoSources.push(source);
+	const { resolveAssetPath: resolveAsset } = await import("./audioMix.js").then((n) => n.r);
+	const fontRegistry = buildFontRegistry(doc.assets);
+	if (fontRegistry.faces().length > 0) {
+		const { GlobalFonts } = await import("@napi-rs/canvas");
+		for (const face of fontRegistry.faces()) GlobalFonts.registerFromPath(resolveAsset(face.url, opts.modulePath), face.family);
+	}
+	await validateSceneFonts(scene, doc, async (url) => {
+		try {
+			const buf = await readFile(resolveAsset(url, opts.modulePath));
+			return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+		} catch {
+			return;
 		}
+	}, { mode: opts.strictFonts ? "strict" : "dev" });
+	for (const [assetId, ref] of Object.entries(doc.assets ?? {})) if (ref.kind === "font") {} else if (ref.kind === "image") {
+		const { loadImage } = await import("@napi-rs/canvas");
+		backend.setImageAsset(assetId, await loadImage(resolveAsset(ref.url, opts.modulePath)));
+	} else if (ref.kind === "video") {
+		if (!ffmpegAvailable()) throw new Error(`video asset '${assetId}' needs FFmpeg on PATH for frame extraction (§5.4)`);
+		const { FfmpegVideoFrameSource } = await import("./videoSource.js").then((n) => n.i);
+		const source = new FfmpegVideoFrameSource(resolveAsset(ref.url, opts.modulePath));
+		await source.warm(0, source.duration);
+		backend.setVideoAsset(assetId, source);
+		videoSources.push(source);
 	}
 	for (let f = firstFrame; f <= lastFrame; f++) {
 		backend.render(withDeterminismGuards("throw", () => evaluate(scene, doc, f / fps)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/cli",
-  "version": "0.8.1",
+  "version": "0.9.0-pre.1",
   "description": "glissade CLI: headless rendering via backend-skia (+ FFmpeg mux).",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,15 +20,15 @@
     "@napi-rs/canvas": "^0.1.65",
     "esbuild": "^0.28.0",
     "jiti": "^2.4.2",
-    "@glissade/backend-skia": "0.8.1",
-    "@glissade/core": "0.8.1",
-    "@glissade/interact": "0.8.1",
-    "@glissade/lottie": "0.8.1",
-    "@glissade/svg": "0.8.1",
-    "@glissade/narrate": "0.8.1",
-    "@glissade/player": "0.8.1",
-    "@glissade/scene": "0.8.1",
-    "@glissade/sfx": "0.8.1"
+    "@glissade/backend-skia": "0.9.0-pre.1",
+    "@glissade/core": "0.9.0-pre.1",
+    "@glissade/interact": "0.9.0-pre.1",
+    "@glissade/lottie": "0.9.0-pre.1",
+    "@glissade/svg": "0.9.0-pre.1",
+    "@glissade/narrate": "0.9.0-pre.1",
+    "@glissade/player": "0.9.0-pre.1",
+    "@glissade/scene": "0.9.0-pre.1",
+    "@glissade/sfx": "0.9.0-pre.1"
   },
   "repository": {
     "type": "git",