@glissade/cli 0.44.0 → 0.45.0-pre.1

package/dist/cli.js

@@ -25,7 +25,8 @@ const KNOWN_BOOLEAN_FLAGS = new Set([
 	"watch",
 	"write",
 	"keep-voice",
-	"help"
+	"help",
+	"lottie"
 ]);
 function parseArgs(argv) {
 	const positional = [];
@@ -80,6 +81,7 @@ const USAGE = `usage:
   gs verify-determinism <scene-module> [--shards <n>] [--against <frames.manifest>] [--range a..b] [--bisect] [--emit <p>]
   gs dev <scene-module> [--record] [--port <n>]
   gs import <lottie.json|asset.svg> [--out <dir>] [--allow-degraded]
+  gs export --lottie <scene-module> --out <file.json> [--width <n>] [--height <n>] [--fps <n>]
   gs narrate <scene-module|script.narration.json> [--provider <id>] [--align <id>] [--force]
   gs narration-lint <scene-module|script.narration.timing.json> [--json] [--fix] [--max-cps <n>]
   gs sfx <scene-module|script.sfx.json> [--verbose]
@@ -168,6 +170,15 @@ import options (.json = Lottie; .svg = static SVG → a scene that defers to @gl
   --out <dir>          output directory for the generated scene module (default: .)
   --allow-degraded     (Lottie only) downgrade degradable rejections (expressions, merge-paths modes != 1) to warnings
 
+export options (--lottie: a glissade scene → a Lottie/bodymovin .json — the inverse of gs import):
+  --out <file.json>    output Lottie document (required)
+  --width <n>          document width in px (default: the scene size)
+  --height <n>         document height in px (default: the scene size)
+  --fps <n>            frame rate (default: the timeline fps, else 60). cubicBezier/hold eases round-trip
+                       exactly; named eases / springs / expr tracks are sampled to dense linear keys.
+                       MVP: Group / Rect / Circle / Path with a solid fill (+ optional stroke); Text,
+                       gradient/mesh paint, and images are dropped with a warning
+
 measure-loudness options (the explicit publish-loudness measure step; commits *.loudness.json):
   --profile <id>   youtube (default) | shorts (both -14 LUFS) | podcast (-16) | broadcast/ebu (-23); all cap at -1 dBTP
                    measures the final mix (ebur128) and commits a deterministic peak-clamped gain; render applies it
@@ -196,7 +207,7 @@ async function main() {
 		process.stdout.write(`${describe().version}\n`);
 		return;
 	}
-	if (command !== "render" && command !== "diff" && command !== "verify-determinism" && command !== "dev" && command !== "import" && command !== "narrate" && command !== "narration-lint" && command !== "sfx" && command !== "prepare" && command !== "measure-loudness" && command !== "fonts" && command !== "cache" && command !== "mcp" && command !== "build" && command !== "describe" && command !== "migrate" && command !== "repin" && command !== "master" && command !== "localize" && command !== "types") {
+	if (command !== "render" && command !== "diff" && command !== "verify-determinism" && command !== "dev" && command !== "import" && command !== "export" && command !== "narrate" && command !== "narration-lint" && command !== "sfx" && command !== "prepare" && command !== "measure-loudness" && command !== "fonts" && command !== "cache" && command !== "mcp" && command !== "build" && command !== "describe" && command !== "migrate" && command !== "repin" && command !== "master" && command !== "localize" && command !== "types") {
 		console.error(USAGE);
 		process.exit(command === void 0 || command === "help" || command === "--help" ? 0 : 1);
 	}
@@ -607,6 +618,35 @@ async function main() {
 		}
 		return;
 	}
+	if (command === "export") {
+		if (!flags.has("lottie")) fail(`gs export currently supports only --lottie\n  gs export --lottie <scene-module> --out <file.json> [--width <n>] [--height <n>] [--fps <n>]`);
+		const out = flags.get("out");
+		if (!out) fail(`gs export needs --out <file.json>\n${USAGE}`);
+		const dim = (name) => {
+			const raw = flags.get(name);
+			if (raw === void 0 || raw === "") return void 0;
+			const n = Number(raw);
+			if (!Number.isFinite(n) || n <= 0) fail(`--${name} must be a positive number, got '${raw}'`);
+			return n;
+		};
+		const width = dim("width");
+		const height = dim("height");
+		const { exportCommand } = await import("./export.js").then((n) => n.n);
+		try {
+			const result = await exportCommand({
+				input: modulePath,
+				out,
+				...width !== void 0 ? { width } : {},
+				...height !== void 0 ? { height } : {},
+				...flags.get("fps") ? { fps: parseFpsOrFail(flags.get("fps")) } : {}
+			});
+			for (const w of result.warnings) process.stderr.write(`gs export: warning: ${w}\n`);
+			process.stderr.write(`gs export: wrote ${result.out}\n`);
+		} catch (err) {
+			fail(err instanceof Error ? err.message : String(err));
+		}
+		return;
+	}
 	if (command === "dev") {
 		const { dev } = await import("./dev.js").then((n) => n.n);
 		const portFlag = flags.get("port");

package/dist/export.js

@@ -0,0 +1,35 @@
+import { t as __exportAll } from "./rolldown-runtime.js";
+import { o as loadSceneModule } from "./render.js";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { exportLottie } from "@glissade/lottie";
+//#region src/export.ts
+/**
+* gs export --lottie (the inverse of `gs import`): a glissade scene module → a
+* Lottie/bodymovin .json. Loads the SceneModule (the node tree + Timeline), runs
+* the pure `@glissade/lottie` exporter, and writes the document. Scope-out /
+* degrade notes surface as warnings (mirroring `gs import`).
+*/
+var export_exports = /* @__PURE__ */ __exportAll({ exportCommand: () => exportCommand });
+async function exportCommand(opts) {
+	const mod = await loadSceneModule(opts.input);
+	const scene = mod.createScene();
+	const width = opts.width ?? scene.size.w;
+	const height = opts.height ?? scene.size.h;
+	const warnings = [];
+	const doc = exportLottie(mod, {
+		width,
+		height,
+		...opts.fps !== void 0 ? { fps: opts.fps } : {},
+		onWarn: (w) => warnings.push(w)
+	});
+	const outAbs = resolve(opts.out);
+	mkdirSync(dirname(outAbs), { recursive: true });
+	writeFileSync(outAbs, `${JSON.stringify(doc, null, 2)}\n`);
+	return {
+		out: outAbs,
+		warnings
+	};
+}
+//#endregion
+export { export_exports as n, exportCommand as t };

package/dist/index.d.ts

@@ -573,6 +573,28 @@ interface ImportCommandResult {
 }
 declare function importCommand(opts: ImportOptions): Promise<ImportCommandResult>;
 //#endregion
+//#region src/export.d.ts
+/**
+ * gs export --lottie (the inverse of `gs import`): a glissade scene module → a
+ * Lottie/bodymovin .json. Loads the SceneModule (the node tree + Timeline), runs
+ * the pure `@glissade/lottie` exporter, and writes the document. Scope-out /
+ * degrade notes surface as warnings (mirroring `gs import`).
+ */
+interface ExportOptions {
+  /** Scene module path. */
+  input: string;
+  /** Output .json file. */
+  out: string;
+  width?: number;
+  height?: number;
+  fps?: number;
+}
+interface ExportCommandResult {
+  out: string;
+  warnings: string[];
+}
+declare function exportCommand(opts: ExportOptions): Promise<ExportCommandResult>;
+//#endregion
 //#region src/diff.d.ts
 interface DiffOptions {
   modulePath: string;
@@ -814,4 +836,4 @@ declare function cacheVerifyCommand(opts: CacheVerifyOptions): Promise<CacheVeri
 /** The @glissade/cli package version (the glissade VERSION for the cache key). */
 declare function glissadeVersion(): string;
 //#endregion
-export { AudioMixError, type AudioMixPlan, type CacheKeyContext, type CacheMode, type CacheVerifyOptions, type CacheVerifyResult, type CaptionProbe, type CommittedLimiter, DEFAULT_CACHE_MAX_SIZE, DEFAULT_FPS, DEFAULT_FRAMES, DEFAULT_MAX_GR_DB, DEFAULT_PROFILE_ID, type DevOptions, type DevServer, type Diagnostic, type DiffOptions, type DiffResult, type EncoderChoice, FfmpegVideoFrameSource, FrameCache, FrameCacheError, type FrameCacheOptions, type ImportCommandResult, type ImportOptions, LOUDNESS_SCHEMA_VERSION, type LintOptions, type LintRule, LocaleArgsError, LoudnessError, type LoudnessMeasurement, MachineExportError, type MachineRenderFlags, type MasterConfig, MasterError, type MasterLimiter, type MasterMemberResult, type MasterPlan, type MasterResult, type MeasureLoudnessOptions, type MeasureLoudnessResult, type MemberMeasure, type MemberPlan, type NarrationLintOptions, type NarrationLintResult, NoEncoderError, PUBLISH_PROFILES, type PublishProfile, type RenderOptions, type RenderShardedArgs, type RepinFrame, type RepinOptions, type RepinResult, type RepinStatus, SceneModuleError, ShardError, type ShardRange, type VideoInfo, VideoProbeError, applyMixGainDb, atempoChain, availableEncoders, buildCaptionProbe, buildMixWav, cacheVerifyCommand, capsId, clearFrameCache, collectAudioClips, computeGainDb, computeMixHash, dev, diffCommand, evaluateAt, ffmpegAvailable, fixDiff, formatTable, frameCacheKey, gainExpression, glissadeVersion, hasErrors, importCommand, lintNarration, lintTimingPathFor, loadSceneModule, localeOutPath, loudnessPathFor, masterAfChain, masterCommand, measureFile, measureLoudnessCommand, narrationLintCommand, normalizeMasterConfig, parseCacheMaxSize, parseEncoderList, parseLocalesList, parseLoudnormJson, peakClampBinds, pickEncoder, planAudioMix, planFinalAudio, planMaster, probeEntryHeader, probeVideo, readLoudness, render, renderLocales, renderSharded, repinCommand, resolveAssetPath, resolveLoudnessGainDb, resolveProfile, resolveRenderDoc, sceneHasGpuNodes, snapshotAt, splitFrameRange };
+export { AudioMixError, type AudioMixPlan, type CacheKeyContext, type CacheMode, type CacheVerifyOptions, type CacheVerifyResult, type CaptionProbe, type CommittedLimiter, DEFAULT_CACHE_MAX_SIZE, DEFAULT_FPS, DEFAULT_FRAMES, DEFAULT_MAX_GR_DB, DEFAULT_PROFILE_ID, type DevOptions, type DevServer, type Diagnostic, type DiffOptions, type DiffResult, type EncoderChoice, type ExportOptions as ExportCommandOptions, type ExportCommandResult, FfmpegVideoFrameSource, FrameCache, FrameCacheError, type FrameCacheOptions, type ImportCommandResult, type ImportOptions, LOUDNESS_SCHEMA_VERSION, type LintOptions, type LintRule, LocaleArgsError, LoudnessError, type LoudnessMeasurement, MachineExportError, type MachineRenderFlags, type MasterConfig, MasterError, type MasterLimiter, type MasterMemberResult, type MasterPlan, type MasterResult, type MeasureLoudnessOptions, type MeasureLoudnessResult, type MemberMeasure, type MemberPlan, type NarrationLintOptions, type NarrationLintResult, NoEncoderError, PUBLISH_PROFILES, type PublishProfile, type RenderOptions, type RenderShardedArgs, type RepinFrame, type RepinOptions, type RepinResult, type RepinStatus, SceneModuleError, ShardError, type ShardRange, type VideoInfo, VideoProbeError, applyMixGainDb, atempoChain, availableEncoders, buildCaptionProbe, buildMixWav, cacheVerifyCommand, capsId, clearFrameCache, collectAudioClips, computeGainDb, computeMixHash, dev, diffCommand, evaluateAt, exportCommand, ffmpegAvailable, fixDiff, formatTable, frameCacheKey, gainExpression, glissadeVersion, hasErrors, importCommand, lintNarration, lintTimingPathFor, loadSceneModule, localeOutPath, loudnessPathFor, masterAfChain, masterCommand, measureFile, measureLoudnessCommand, narrationLintCommand, normalizeMasterConfig, parseCacheMaxSize, parseEncoderList, parseLocalesList, parseLoudnormJson, peakClampBinds, pickEncoder, planAudioMix, planFinalAudio, planMaster, probeEntryHeader, probeVideo, readLoudness, render, renderLocales, renderSharded, repinCommand, resolveAssetPath, resolveLoudnessGainDb, resolveProfile, resolveRenderDoc, sceneHasGpuNodes, snapshotAt, splitFrameRange };

package/dist/index.js

@@ -9,9 +9,10 @@ import { a as gainExpression, n as applyMixGainDb, o as planAudioMix, r as atemp
 import { r as resolveRenderDoc, t as MachineExportError } from "./machines.js";
 import { t as dev } from "./dev.js";
 import { t as importCommand } from "./import.js";
+import { t as exportCommand } from "./export.js";
 import { i as snapshotAt, r as evaluateAt, t as diffCommand } from "./diff.js";
 import { n as DEFAULT_FRAMES, r as repinCommand, t as DEFAULT_FPS } from "./repin.js";
 import { a as fixDiff, c as lintNarration, n as lintTimingPathFor, o as formatTable, r as narrationLintCommand, s as hasErrors, t as buildCaptionProbe } from "./narrationLintCommand.js";
 import { a as clearFrameCache, c as parseCacheMaxSize, i as capsId, l as probeEntryHeader, n as FrameCache, o as frameCacheKey, r as FrameCacheError, t as DEFAULT_CACHE_MAX_SIZE } from "./frameCache.js";
 import { t as cacheVerifyCommand } from "./cacheVerify.js";
-export { AudioMixError, DEFAULT_CACHE_MAX_SIZE, DEFAULT_FPS, DEFAULT_FRAMES, DEFAULT_MAX_GR_DB, DEFAULT_PROFILE_ID, FfmpegVideoFrameSource, FrameCache, FrameCacheError, LOUDNESS_SCHEMA_VERSION, LocaleArgsError, LoudnessError, MachineExportError, MasterError, NoEncoderError, PUBLISH_PROFILES, SceneModuleError, ShardError, VideoProbeError, applyMixGainDb, atempoChain, availableEncoders, buildCaptionProbe, buildMixWav, cacheVerifyCommand, capsId, clearFrameCache, collectAudioClips, computeGainDb, computeMixHash, dev, diffCommand, evaluateAt, ffmpegAvailable, fixDiff, formatTable, frameCacheKey, gainExpression, glissadeVersion, hasErrors, importCommand, lintNarration, lintTimingPathFor, loadSceneModule, localeOutPath, loudnessPathFor, masterAfChain, masterCommand, measureFile, measureLoudnessCommand, narrationLintCommand, normalizeMasterConfig, parseCacheMaxSize, parseEncoderList, parseLocalesList, parseLoudnormJson, peakClampBinds, pickEncoder, planAudioMix, planFinalAudio, planMaster, probeEntryHeader, probeVideo, readLoudness, render, renderLocales, renderSharded, repinCommand, resolveAssetPath, resolveLoudnessGainDb, resolveProfile, resolveRenderDoc, sceneHasGpuNodes, snapshotAt, splitFrameRange };
+export { AudioMixError, DEFAULT_CACHE_MAX_SIZE, DEFAULT_FPS, DEFAULT_FRAMES, DEFAULT_MAX_GR_DB, DEFAULT_PROFILE_ID, FfmpegVideoFrameSource, FrameCache, FrameCacheError, LOUDNESS_SCHEMA_VERSION, LocaleArgsError, LoudnessError, MachineExportError, MasterError, NoEncoderError, PUBLISH_PROFILES, SceneModuleError, ShardError, VideoProbeError, applyMixGainDb, atempoChain, availableEncoders, buildCaptionProbe, buildMixWav, cacheVerifyCommand, capsId, clearFrameCache, collectAudioClips, computeGainDb, computeMixHash, dev, diffCommand, evaluateAt, exportCommand, ffmpegAvailable, fixDiff, formatTable, frameCacheKey, gainExpression, glissadeVersion, hasErrors, importCommand, lintNarration, lintTimingPathFor, loadSceneModule, localeOutPath, loudnessPathFor, masterAfChain, masterCommand, measureFile, measureLoudnessCommand, narrationLintCommand, normalizeMasterConfig, parseCacheMaxSize, parseEncoderList, parseLocalesList, parseLoudnormJson, peakClampBinds, pickEncoder, planAudioMix, planFinalAudio, planMaster, probeEntryHeader, probeVideo, readLoudness, render, renderLocales, renderSharded, repinCommand, resolveAssetPath, resolveLoudnessGainDb, resolveProfile, resolveRenderDoc, sceneHasGpuNodes, snapshotAt, splitFrameRange };

package/package.json

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