@glissade/cli 0.9.0 → 0.9.1

package/dist/cli.js

@@ -61,6 +61,8 @@ 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)
+                   (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)
 
 dev options:
@@ -189,6 +191,7 @@ async function main() {
 			...frameRange ? { frameRange } : {},
 			...formatFlag === "png-seq" ? { format: "png-seq" } : {},
 			...flags.get("chapters") === "vtt" ? { chapters: "vtt" } : {},
+			...flags.has("chapters-kind") ? { chapterKinds: new Set(flags.get("chapters-kind").split(",").map((s) => s.trim()).filter(Boolean)) } : {},
 			...flags.has("trace") ? { trace: flags.get("trace") } : {},
 			...flags.has("state") ? { state: flags.get("state") } : {},
 			...flags.has("force") ? { force: true } : {},

package/dist/cues.js

@@ -28,20 +28,31 @@ function vttTime(seconds) {
 	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)}`;
 }
+/** The cue kinds that become WebVTT chapters by default (the YouTube use case). */
+const DEFAULT_CHAPTER_KINDS = new Set(["chapter"]);
 /**
-* 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).
+* WebVTT chapters from cues. Only cues whose `kind` is in `kinds` (default just
+* `'chapter'`) become chapters — ad-break / plain `cue` markers stay out of the
+* chapter list (they remain in `cues.json` for machines), so the VTT pastes
+* straight into a YouTube description. Each chapter runs until its duration or
+* the next chapter; the cue text is the human `title` (falling back to `name`),
+* never the machine `kind`. When the earliest chapter starts after 0, a `00:00`
+* "Intro" chapter is auto-anchored (valid WebVTT, and YouTube needs a 0:00 start).
+*
+* Author note — YouTube's chapter rules are author-side, not enforced here:
+* it needs the FIRST chapter at exactly 0:00 (the auto-anchor handles this, but
+* a tiny first chapter from a lead-in will read oddly — pin chapter 1 to t=0
+* instead) and EVERY chapter to be >= 10s (fold a too-short beat into its
+* neighbour). cues.json is unaffected; only the human-pasted VTT cares.
 */
-function cuesToVtt(cues, totalDuration) {
-	const anchored = cues.length > 0 && cues[0].t > 0 ? [{
+function cuesToVtt(cues, totalDuration, kinds = DEFAULT_CHAPTER_KINDS) {
+	const chapters = cues.filter((c) => kinds.has(c.kind));
+	const anchored = chapters.length > 0 && chapters[0].t > 0 ? [{
 		t: 0,
 		kind: "chapter",
 		name: "Intro",
 		title: "Intro"
-	}, ...cues] : cues;
+	}, ...chapters] : chapters;
 	let out = "WEBVTT\n\n";
 	anchored.forEach((c, i) => {
 		const end = c.duration !== void 0 ? c.t + c.duration : anchored[i + 1]?.t ?? totalDuration;
@@ -54,7 +65,7 @@ function cuesToVtt(cues, totalDuration) {
 * `<stem>.chapters.vtt`, next to the render output. Deterministic. Returns the
 * paths written.
 */
-function writeCueSidecars(outPath, markers, totalDuration, chaptersVtt) {
+function writeCueSidecars(outPath, markers, totalDuration, chaptersVtt, chapterKinds = DEFAULT_CHAPTER_KINDS) {
 	const cues = collectCues(markers);
 	if (cues.length === 0) return [];
 	const isFile = /\.(mp4|webm)$/i.test(outPath);
@@ -66,7 +77,7 @@ function writeCueSidecars(outPath, markers, totalDuration, chaptersVtt) {
 	written.push(jsonPath);
 	if (chaptersVtt) {
 		const vttPath = join(dir, `${prefix}chapters.vtt`);
-		writeFileSync(vttPath, cuesToVtt(cues, totalDuration));
+		writeFileSync(vttPath, cuesToVtt(cues, totalDuration, chapterKinds));
 		written.push(vttPath);
 	}
 	return written;

package/dist/index.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';
+  /** cue kinds that become VTT chapters (default just 'chapter'); cues.json keeps all kinds. */
+  chapterKinds?: ReadonlySet<string>;
   /** --strict: font validation throws on an unregistered family / missing glyph (§3.6). Default dev-warn. */
   strictFonts?: boolean;
   onProgress?: (frame: number, total: number) => void;

package/dist/render.js

@@ -126,7 +126,7 @@ async function render(opts) {
 		process.stderr.write(`captions: ${srt}, ${vtt}\n`);
 	};
 	const emitCues = (target) => {
-		const written = writeCueSidecars(target, compiled.markers, duration, opts.chapters === "vtt");
+		const written = writeCueSidecars(target, compiled.markers, duration, opts.chapters === "vtt", opts.chapterKinds);
 		if (written.length) process.stderr.write(`cues: ${written.join(", ")}\n`);
 	};
 	if (!isVideo) {

package/package.json

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