@glissade/cli 0.7.0 → 0.8.0-pre.1

package/dist/cli.js

@@ -60,6 +60,7 @@ render options:
   --narration <m>  auto (default): mix the voice from a sibling *.narration.timing.json | off
   --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)
 
 dev options:
   --record         add a Record button; writes .trace.json sidecars next to the module
@@ -185,6 +186,7 @@ async function main() {
 			...frame !== void 0 ? { frame } : {},
 			...frameRange ? { frameRange } : {},
 			...formatFlag === "png-seq" ? { format: "png-seq" } : {},
+			...flags.get("chapters") === "vtt" ? { chapters: "vtt" } : {},
 			...flags.has("trace") ? { trace: flags.get("trace") } : {},
 			...flags.has("state") ? { state: flags.get("state") } : {},
 			...flags.has("force") ? { force: true } : {},

package/dist/cues.js

@@ -0,0 +1,75 @@
+import { writeFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+//#region src/cues.ts
+/**
+* Composer cue signaling (§ad-break): cue markers (those carrying a `data.kind`)
+* are emitted at render as a deterministic `<stem>.cues.json` sidecar so a
+* downstream NLE / ad-insertion pipeline has machine-readable break points, and
+* optionally as WebVTT chapters. Mirrors the captions sidecar plumbing.
+*/
+/** Cue markers (those carrying a string `data.kind`) → a sorted cue list. */
+function collectCues(markers) {
+	const cues = [];
+	for (const m of markers) {
+		const data = m.data;
+		if (!data || typeof data !== "object" || typeof data.kind !== "string") continue;
+		cues.push({
+			t: m.t,
+			kind: data.kind,
+			name: m.name,
+			...typeof data.title === "string" ? { title: data.title } : {},
+			...typeof data.duration === "number" ? { duration: data.duration } : {}
+		});
+	}
+	return cues.sort((a, b) => a.t - b.t);
+}
+function vttTime(seconds) {
+	const ms = Math.round(seconds * 1e3);
+	const p = (n, w = 2) => String(n).padStart(w, "0");
+	return `${p(Math.floor(ms / 36e5))}:${p(Math.floor(ms % 36e5 / 6e4))}:${p(Math.floor(ms % 6e4 / 1e3))}.${p(ms % 1e3, 3)}`;
+}
+/**
+* WebVTT chapters from cues; each runs until its duration or the next cue. The
+* cue text is the human `title` (falling back to `name`), not the machine
+* `kind`. When the earliest cue starts after 0, a `00:00` "Intro" chapter is
+* auto-anchored — both valid WebVTT and required for YouTube description
+* chapters (which read the cue text as the title and need a 0:00 start).
+*/
+function cuesToVtt(cues, totalDuration) {
+	const anchored = cues.length > 0 && cues[0].t > 0 ? [{
+		t: 0,
+		kind: "chapter",
+		name: "Intro",
+		title: "Intro"
+	}, ...cues] : cues;
+	let out = "WEBVTT\n\n";
+	anchored.forEach((c, i) => {
+		const end = c.duration !== void 0 ? c.t + c.duration : anchored[i + 1]?.t ?? totalDuration;
+		out += `${c.name}\n${vttTime(c.t)} --> ${vttTime(end)}\n${c.title ?? c.name}\n\n`;
+	});
+	return out;
+}
+/**
+* Write `<stem>.cues.json` (always, when cues exist) and, when `chaptersVtt`,
+* `<stem>.chapters.vtt`, next to the render output. Deterministic. Returns the
+* paths written.
+*/
+function writeCueSidecars(outPath, markers, totalDuration, chaptersVtt) {
+	const cues = collectCues(markers);
+	if (cues.length === 0) return [];
+	const isFile = /\.(mp4|webm)$/i.test(outPath);
+	const dir = isFile ? dirname(outPath) : outPath;
+	const prefix = isFile ? `${basename(outPath).replace(/\.(mp4|webm)$/i, "")}.` : "";
+	const written = [];
+	const jsonPath = join(dir, `${prefix}cues.json`);
+	writeFileSync(jsonPath, JSON.stringify({ cues }, null, 2) + "\n");
+	written.push(jsonPath);
+	if (chaptersVtt) {
+		const vttPath = join(dir, `${prefix}chapters.vtt`);
+		writeFileSync(vttPath, cuesToVtt(cues, totalDuration));
+		written.push(vttPath);
+	}
+	return written;
+}
+//#endregion
+export { writeCueSidecars };

package/dist/index.d.ts

@@ -30,6 +30,8 @@ interface RenderOptions {
   narration?: 'auto' | 'off';
   /** auto (default): mix effect hits from a sibling *.sfx.timing.json. */
   sfx?: 'auto' | 'off';
+  /** also write WebVTT chapters from cue markers ('vtt'); cues.json is always written when cues exist. */
+  chapters?: 'vtt' | 'off';
   onProgress?: (frame: number, total: number) => void;
 }
 declare class SceneModuleError extends Error {

package/dist/render.js

@@ -52,6 +52,7 @@ async function render(opts) {
 	const fps = opts.fps ?? doc.fps ?? 60;
 	const captionsMode = opts.captions ?? "burn";
 	const { hideCaptionsDoc, timingPathFor, writeCaptionSidecars } = await import("./captions.js").then((n) => n.t);
+	const { writeCueSidecars } = await import("./cues.js");
 	if (captionsMode !== "burn" && scene.resolveTarget("captions/opacity") !== void 0) doc = hideCaptionsDoc(doc);
 	const { compileTimeline } = await import("@glissade/core");
 	const compiled = compileTimeline(doc);
@@ -114,6 +115,10 @@ async function render(opts) {
 		const { srt, vtt } = writeCaptionSidecars(timingPath, target);
 		process.stderr.write(`captions: ${srt}, ${vtt}\n`);
 	};
+	const emitCues = (target) => {
+		const written = writeCueSidecars(target, compiled.markers, duration, opts.chapters === "vtt");
+		if (written.length) process.stderr.write(`cues: ${written.join(", ")}\n`);
+	};
 	if (!isVideo) {
 		if (singleFile) return {
 			frames: 1,
@@ -121,6 +126,7 @@ async function render(opts) {
 		};
 		if (compiled.audio.length > 0) process.stderr.write("note: PNG-sequence output ignores timeline audio; render to .mp4/.webm to mix it\n");
 		emitSidecars(framesDir);
+		emitCues(framesDir);
 		return {
 			frames: total,
 			out: framesDir
@@ -129,6 +135,7 @@ async function render(opts) {
 	const outAbs = resolve(opts.out);
 	mkdirSync(dirname(outAbs), { recursive: true });
 	emitSidecars(outAbs);
+	emitCues(outAbs);
 	const isWebm = /\.webm$/i.test(outAbs);
 	const container = isWebm ? "webm" : "mp4";
 	const { pickEncoder } = await import("./encoders.js").then((n) => n.r);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/cli",
-  "version": "0.7.0",
+  "version": "0.8.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.7.0",
-    "@glissade/core": "0.7.0",
-    "@glissade/interact": "0.7.0",
-    "@glissade/lottie": "0.7.0",
-    "@glissade/svg": "0.7.0",
-    "@glissade/narrate": "0.7.0",
-    "@glissade/player": "0.7.0",
-    "@glissade/scene": "0.7.0",
-    "@glissade/sfx": "0.7.0"
+    "@glissade/backend-skia": "0.8.0-pre.1",
+    "@glissade/core": "0.8.0-pre.1",
+    "@glissade/interact": "0.8.0-pre.1",
+    "@glissade/lottie": "0.8.0-pre.1",
+    "@glissade/svg": "0.8.0-pre.1",
+    "@glissade/narrate": "0.8.0-pre.1",
+    "@glissade/player": "0.8.0-pre.1",
+    "@glissade/scene": "0.8.0-pre.1",
+    "@glissade/sfx": "0.8.0-pre.1"
   },
   "repository": {
     "type": "git",