@glissade/cli 0.14.0-pre.0 → 0.14.0

package/dist/cli.js

@@ -17,6 +17,7 @@ const KNOWN_BOOLEAN_FLAGS = new Set([
 	"no-warnings",
 	"lossless-intermediate",
 	"allow-gpu-shards",
+	"allow-system-fonts",
 	"verbose",
 	"allow-degraded",
 	"bisect",
@@ -110,6 +111,8 @@ render options:
                    (YouTube needs the 1st chapter at 0:00 — auto-anchored — and each chapter >= 10s; author cue ts accordingly)
   --chapters-kind <k[,k]>  cue kinds that become VTT chapters (default: chapter); cues.json keeps all kinds
   --strict         fail on an unregistered font family or an uncovered glyph (§3.6; default: warn)
+  --allow-system-fonts  exempt true-OS-installed families from the unregistered-family check (host-dependent;
+                   off by default, IGNORED under --strict so the strict verdict stays host-independent; §3.6)
   --locale <code>  resolve the scene against messages.<code>.json (node-id text + free-standing t() keys) and prefer
                    the <base>.<code>.narration.timing.json sibling (0.14). No --locale resolves the BASE files
 
@@ -456,6 +459,7 @@ async function main() {
 			...flags.has("state") ? { state: flags.get("state") } : {},
 			...flags.has("force") ? { force: true } : {},
 			...flags.has("strict") ? { strictFonts: true } : {},
+			...flags.has("allow-system-fonts") ? { allowSystemFonts: true } : {},
 			...workers !== void 0 ? { workers } : {},
 			...flags.has("lossless-intermediate") ? { losslessIntermediate: true } : {},
 			...flags.has("allow-gpu-shards") ? { allowGpuShards: true } : {},

package/dist/index.d.ts

@@ -168,6 +168,14 @@ interface RenderOptions {
   chapterKinds?: ReadonlySet<string>;
   /** --strict: font validation throws on an unregistered family / missing glyph (§3.6). Default dev-warn. */
   strictFonts?: boolean;
+  /**
+   * --allow-system-fonts (§3.6, 0.14 FIX 6): exempt true-OS-installed families
+   * (the host `GlobalFonts.families` catalog) from the unregistered-family check.
+   * OFF by default — the exempt set is otherwise just the families glissade
+   * registered from `doc.assets`, so the verdict is host-independent. IGNORED
+   * under --strict (strict stays host-independent regardless of this flag).
+   */
+  allowSystemFonts?: boolean;
   /**
    * --workers N (§5.6): split the frame range into N contiguous sub-ranges, render
    * each in a separate `gs` child process, and join the shard videos. Ignored for
@@ -209,6 +217,17 @@ interface RenderOptions {
   locale?: string;
   onProgress?: (frame: number, total: number) => void;
 }
+/**
+ * Build the case-folded set of families EXEMPT from the §3.6 unregistered-family
+ * check (FIX 6, 0.14). Seeded from the families glissade actually registered out
+ * of `doc.assets` (`registered`, already lower-cased) — NEVER the true-OS
+ * `GlobalFonts.families` catalog, which is host-dependent (3 families on a clean
+ * Linux CI box, hundreds on a dev macOS) and would make the --strict PASS/FAIL
+ * verdict depend on the host. The true-OS `osCatalog` is folded in ONLY when
+ * `allowSystemFonts` is set AND `strict` is false — so --strict stays host-
+ * independent regardless of the flag. Pure: no I/O, no host queries.
+ */
+
 declare class SceneModuleError extends Error {
   constructor(modulePath: string, detail: string);
 }

package/dist/locale.js

@@ -9,6 +9,18 @@ import { dirname, join } from "node:path";
 * resolves the BASE files (`messages.json` is NOT consulted, the base narration
 * sibling is used) → byte-identical to today. Every locale is opt-in.
 */
+/** Strip a scene module's `.ts`/`.tsx`/`.js`/`.jsx` extension → the file stem. */
+function moduleStem(modulePath) {
+	return modulePath.replace(/\.[jt]sx?$/, "");
+}
+/**
+* The locale-tagged NARRATION timing sibling suffix. A `--locale xx` render
+* prefers `<base>.xx.narration.timing.json` over the base
+* `<base>.narration.timing.json`. DEFAULT convention — the maintainer is
+* confirming the exact suffix with the ai-training consumer; changing it is a
+* one-line edit HERE. `%s` is the locale code.
+*/
+const LOCALE_NARRATION_SUFFIX = ".%s.narration.timing.json";
 /**
 * The per-locale message table filename, resolved RELATIVE to the scene module
 * directory: `messages.<locale>.json`. DEFAULT convention; one-line change.
@@ -26,5 +38,30 @@ function loadMessageTable(modulePath, locale) {
 	if (!existsSync(file)) return void 0;
 	return JSON.parse(readFileSync(file, "utf8"));
 }
+/**
+* The locale-tagged narration timing sibling path for a module, or `undefined`
+* when no `locale` is requested. The render path prefers this sibling when it
+* exists, falling back to the base sibling otherwise (so a locale that reuses
+* the base narration still renders).
+*/
+function localeNarrationPathFor(modulePath, locale) {
+	return moduleStem(modulePath) + LOCALE_NARRATION_SUFFIX.replace("%s", locale);
+}
+/**
+* A declared `--locale <code>` resolved to NEITHER a `messages.<code>.json` nor a
+* `<base>.<code>.narration.timing.json` sibling — the locale has no assets at
+* all, so a render would silently fall back to the BASE artifact (wrong-language
+* output, exit 0, no warning). Render hard-throws this instead.
+*
+* (A narration-only locale legitimately has no messages file, and a
+* messages-only locale legitimately reuses the base narration — so this fires
+* only when BOTH are absent.)
+*/
+var UnknownLocaleError = class extends Error {
+	constructor(locale, messagesPath, narrationPath) {
+		super(`--locale '${locale}': no locale assets found — neither a message table nor a narration sibling resolves. Looked for '${messagesPath}' and '${narrationPath}'. Add one of those files, or drop --locale to render the base language.`);
+		this.name = "UnknownLocaleError";
+	}
+};
 //#endregion
-export { loadMessageTable };
+export { UnknownLocaleError, loadMessageTable, localeNarrationPathFor, messagesFileFor };

package/dist/render.js

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime.js";
 import { spawnSync } from "node:child_process";
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, 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 { buildFontRegistry } from "@glissade/core";
-import { evaluate, validateSceneFonts, withDeterminismGuards } from "@glissade/scene";
+import { collectLocalizedTextUsages, evaluate, validateSceneFonts, withDeterminismGuards } from "@glissade/scene";
 import { SkiaBackend } from "@glissade/backend-skia";
 //#region src/assetValidation.ts
 /**
@@ -70,6 +70,7 @@ function validateAssetReferences(refs, declaredIds) {
 */
 var render_exports = /* @__PURE__ */ __exportAll({
 	SceneModuleError: () => SceneModuleError,
+	buildFontExemptSet: () => buildFontExemptSet,
 	buildMixWav: () => buildMixWav,
 	collectAudioClips: () => collectAudioClips,
 	collectMixAudioInputs: () => collectMixAudioInputs,
@@ -80,6 +81,21 @@ var render_exports = /* @__PURE__ */ __exportAll({
 	render: () => render,
 	resolveLoudnessGainDb: () => resolveLoudnessGainDb
 });
+/**
+* Build the case-folded set of families EXEMPT from the §3.6 unregistered-family
+* check (FIX 6, 0.14). Seeded from the families glissade actually registered out
+* of `doc.assets` (`registered`, already lower-cased) — NEVER the true-OS
+* `GlobalFonts.families` catalog, which is host-dependent (3 families on a clean
+* Linux CI box, hundreds on a dev macOS) and would make the --strict PASS/FAIL
+* verdict depend on the host. The true-OS `osCatalog` is folded in ONLY when
+* `allowSystemFonts` is set AND `strict` is false — so --strict stays host-
+* independent regardless of the flag. Pure: no I/O, no host queries.
+*/
+function buildFontExemptSet(registered, opts) {
+	const exempt = new Set(registered);
+	if (opts.allowSystemFonts && !opts.strict) for (const f of opts.osCatalog) exempt.add(f);
+	return exempt;
+}
 var SceneModuleError = class extends Error {
 	constructor(modulePath, detail) {
 		super(`${modulePath}: ${detail}\nA scene module default-exports { createScene(): Scene, timeline: Timeline } (SceneModule).`);
@@ -123,11 +139,16 @@ async function render(opts) {
 		...opts.force !== void 0 ? { force: opts.force } : {}
 	});
 	if (opts.locale !== void 0 && opts.locale !== "") {
-		const { loadMessageTable } = await import("./locale.js");
+		const { loadMessageTable, messagesFileFor, localeNarrationPathFor, UnknownLocaleError } = await import("./locale.js");
 		const table = loadMessageTable(opts.modulePath, opts.locale);
+		const narrationPath = localeNarrationPathFor(opts.modulePath, opts.locale);
+		if (!table && !existsSync(narrationPath)) throw new UnknownLocaleError(opts.locale, messagesFileFor(opts.modulePath, opts.locale), narrationPath);
 		if (table) {
-			const { localize } = await import("@glissade/core/i18n");
-			doc = localize(doc, table, { locale: opts.locale });
+			const { localize, getConsumedMessageIds } = await import("@glissade/core/i18n");
+			doc = localize(doc, table, {
+				locale: opts.locale,
+				consumedIds: getConsumedMessageIds()
+			});
 		}
 	}
 	const fps = opts.fps ?? doc.fps ?? 60;
@@ -185,11 +206,13 @@ async function render(opts) {
 	const { createHash } = await import("node:crypto");
 	const assetDigests = /* @__PURE__ */ new Map();
 	const digestBytes = (bytes) => createHash("sha256").update(bytes).digest("hex");
+	const registeredFamilies = /* @__PURE__ */ new Set();
 	const fontRegistry = buildFontRegistry(doc.assets);
 	if (fontRegistry.faces().length > 0) {
 		const { GlobalFonts } = await import("@napi-rs/canvas");
 		let ingest;
 		for (const face of fontRegistry.faces()) {
+			registeredFamilies.add(face.family.toLowerCase());
 			const path = resolveAsset(face.url, opts.modulePath);
 			if (/\.woff2?$/i.test(face.url)) {
 				ingest ??= await import("@glissade/core/font-ingest");
@@ -206,8 +229,13 @@ async function render(opts) {
 			}
 		}
 	}
-	const { GlobalFonts: GlobalFontsForValidation } = await import("@napi-rs/canvas");
-	const osFamilies = new Set(GlobalFontsForValidation.families.map((f) => f.family.toLowerCase()));
+	const osCatalog = !!opts.allowSystemFonts && !opts.strictFonts ? new Set((await import("@napi-rs/canvas")).GlobalFonts.families.map((f) => f.family.toLowerCase())) : /* @__PURE__ */ new Set();
+	const osFamilies = buildFontExemptSet(registeredFamilies, {
+		allowSystemFonts: !!opts.allowSystemFonts,
+		strict: !!opts.strictFonts,
+		osCatalog
+	});
+	const localizedUsages = opts.locale !== void 0 && opts.locale !== "" ? collectLocalizedTextUsages(scene, doc) : [];
 	await validateSceneFonts(scene, doc, async (url) => {
 		try {
 			const buf = await readFile(resolveAsset(url, opts.modulePath));
@@ -217,7 +245,8 @@ async function render(opts) {
 		}
 	}, {
 		mode: opts.strictFonts ? "strict" : "dev",
-		osFamilies
+		osFamilies,
+		extraUsages: localizedUsages
 	});
 	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");

package/dist/shards.js

@@ -149,7 +149,8 @@ async function renderSharded(a) {
 				...opts.trace !== void 0 ? ["--trace", opts.trace] : [],
 				...opts.state !== void 0 ? ["--state", opts.state] : [],
 				...opts.force ? ["--force"] : [],
-				...opts.strictFonts ? ["--strict"] : []
+				...opts.strictFonts ? ["--strict"] : [],
+				...opts.allowSystemFonts ? ["--allow-system-fonts"] : []
 			];
 			const child = spawnSync(process.execPath, childArgs, { stdio: [
 				"ignore",

package/package.json

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