@glissade/cli 0.5.0-pre.5 → 0.5.0-pre.6

package/dist/cli.js

@@ -45,6 +45,7 @@ const USAGE = `usage:
   gs import <lottie.json> [--out <dir>] [--allow-degraded]
   gs narrate <scene-module|script.narration.json> [--provider <id>] [--align <id>] [--force]
   gs sfx <scene-module|script.sfx.json> [--verbose]
+  gs prepare <scene-module>  [--provider <id>] [--align <id>] [--force]
 
 render options:
   --out <path>     output directory for a PNG sequence, or .mp4/.webm (needs ffmpeg). default: ./out
@@ -73,7 +74,7 @@ narrate options (the explicit TTS prepare step; render itself stays offline):
 `;
 async function main() {
 	const [command, ...rest] = process.argv.slice(2);
-	if (command !== "render" && command !== "dev" && command !== "import" && command !== "narrate" && command !== "sfx") {
+	if (command !== "render" && command !== "dev" && command !== "import" && command !== "narrate" && command !== "sfx" && command !== "prepare") {
 		console.error(USAGE);
 		process.exit(command === void 0 || command === "help" || command === "--help" ? 0 : 1);
 	}
@@ -100,6 +101,21 @@ async function main() {
 		}
 		return;
 	}
+	if (command === "prepare") {
+		const { prepareCommand } = await import("./prepare.js");
+		try {
+			const result = await prepareCommand({
+				input: modulePath,
+				...flags.has("provider") ? { provider: flags.get("provider") } : {},
+				...flags.has("align") ? { aligner: flags.get("align") } : {},
+				...flags.has("force") ? { force: true } : {}
+			});
+			process.stderr.write(`gs prepare: ${result.notes.join("; ") || "nothing to prepare"}\n`);
+		} catch (err) {
+			fail(err instanceof Error ? err.message : String(err));
+		}
+		return;
+	}
 	if (command === "sfx") {
 		const { prepareSfx, sfxScriptPathFor } = await import("./sfx.js");
 		try {

package/dist/prepare.js

@@ -0,0 +1,50 @@
+import { r as loadSceneModule } from "./render.js";
+import { narrateCommand } from "./narrate.js";
+import { prepareSfx, sfxScriptPathFor } from "./sfx.js";
+import { existsSync } from "node:fs";
+//#region src/prepare.ts
+/**
+* gs prepare — materialize ALL of a scene's committed audio assets in one step:
+* the narration manifest (gs narrate), the sfx manifest + cache (gs sfx), and
+* any in-code sfx caches the scene writes at module/timeline-build time. The
+* last is flushed simply by IMPORTING the scene module (its top-level
+* renderSfxAssets+writeFileSync run then) — evaluate() is a pure read that
+* writes nothing, so prepare never calls it. After prepare, gs render is a pure
+* read of committed files.
+*/
+const sibling = (input, ext) => input.replace(/\.[jt]sx?$/, "") + ext;
+async function prepareCommand(opts) {
+	const notes = [];
+	let narrationTimingPath = null;
+	let sfx = null;
+	if (opts.input.endsWith(".narration.json") || existsSync(sibling(opts.input, ".narration.json"))) {
+		const r = await narrateCommand({
+			input: opts.input,
+			...opts.provider !== void 0 ? { provider: opts.provider } : {},
+			...opts.aligner !== void 0 ? { aligner: opts.aligner } : {},
+			...opts.force !== void 0 ? { force: opts.force } : {}
+		});
+		narrationTimingPath = r.timingPath;
+		notes.push(`narration → ${r.timingPath}`);
+	}
+	if (opts.input.endsWith(".sfx.json") || existsSync(sibling(opts.input, ".sfx.json"))) {
+		sfx = prepareSfx(sfxScriptPathFor(opts.input));
+		notes.push(`sfx ${sfx.clipCount} ${sfx.clipCount === 1 ? "hit" : "hits"} → ${sfx.timingPath}`);
+	}
+	let loaded = false;
+	if (!opts.input.endsWith(".json")) try {
+		await loadSceneModule(opts.input);
+		loaded = true;
+		notes.push("flushed in-code caches (scene module imported)");
+	} catch (err) {
+		notes.push(`scene import skipped (${err instanceof Error ? err.message : String(err)})`);
+	}
+	return {
+		narrationTimingPath,
+		sfx,
+		loaded,
+		notes
+	};
+}
+//#endregion
+export { prepareCommand };

package/package.json

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