@depths/waves 0.2.0 → 0.3.0

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   WavesEngine,
   __wavesVersion,
   getPromptPayload
-} from "./chunk-7QPNRHMW.mjs";
+} from "./chunk-QP54QRAP.mjs";
 import {
   VideoIRv2AuthoringSchema,
   WavesRenderError,
@@ -11,7 +11,7 @@ import {
   globalRegistry,
   registerBuiltInComponents,
   zodSchemaToJsonSchema
-} from "./chunk-PKLHVWMD.mjs";
+} from "./chunk-YYS6AVTN.mjs";
 
 // src/cli.ts
 import fs from "fs/promises";
@@ -42,7 +42,7 @@ function parseArgs(argv) {
       const hasInlineValue = eq >= 0;
       const inlineValue = hasInlineValue ? arg.slice(eq + 1) : void 0;
       const next = argv[i + 1];
-      const isBoolean = key === "help" || key === "pretty" || key === "includeInternal";
+      const isBoolean = key === "help" || key === "pretty" || key === "includeInternal" || key === "debugBounds" || key === "debugLabels";
       if (isBoolean) {
         flags[key] = true;
         continue;
@@ -87,6 +87,7 @@ Commands:
   write-ir    Write a starter IR JSON file
   validate    Validate an IR JSON file
   render      Render MP4 from an IR JSON file
+  stills      Render PNG/JPEG/WebP still frames from an IR JSON file
 
 Options:
   -h, --help       Show help
@@ -123,6 +124,10 @@ async function importRegistrationModules(modules) {
 function stringifyJSON(value, pretty) {
   return JSON.stringify(value, null, pretty ? 2 : 0) + "\n";
 }
+function parseImageFormat(raw) {
+  if (raw === "png" || raw === "jpeg" || raw === "webp") return raw;
+  return null;
+}
 async function main(argv = process.argv.slice(2)) {
   const parsed = parseArgs(argv);
   if (parsed.flags.version) {
@@ -472,15 +477,19 @@ async function main(argv = process.argv.slice(2)) {
     const crfRaw = getFlagString(parsed.flags, "crf");
     const concurrencyRaw = getFlagString(parsed.flags, "concurrency");
     const publicDir = getFlagString(parsed.flags, "publicDir");
+    const debugBounds = Boolean(parsed.flags.debugBounds);
+    const debugLabels = Boolean(parsed.flags.debugLabels);
     const crf = crfRaw ? Number(crfRaw) : void 0;
     const concurrency = concurrencyRaw ? /^[0-9]+$/.test(concurrencyRaw) ? Number(concurrencyRaw) : concurrencyRaw : void 0;
     const engine = new WavesEngine(globalRegistry, new IRValidator(globalRegistry));
     try {
+      const inputProps = debugBounds || debugLabels ? { __wavesDebugBounds: debugBounds, __wavesDebugLabels: debugLabels } : void 0;
       const opts = { outputPath, registrationModules };
       if (publicDir) opts.publicDir = publicDir;
       if (codec) opts.codec = codec;
       if (Number.isFinite(crf ?? Number.NaN)) opts.crf = crf;
       if (concurrency !== void 0) opts.concurrency = concurrency;
+      if (inputProps) opts.inputProps = inputProps;
       await engine.render(json, opts);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -495,6 +504,84 @@ async function main(argv = process.argv.slice(2)) {
 `);
     return EXIT_OK;
   }
+  if (parsed.command === "stills") {
+    const inputPath = getFlagString(parsed.flags, "in");
+    const outDir = getFlagString(parsed.flags, "outDir") ?? getFlagString(parsed.flags, "out");
+    if (!inputPath) {
+      process.stderr.write("Missing required --in <path>\n");
+      return EXIT_USAGE;
+    }
+    if (!outDir) {
+      process.stderr.write("Missing required --outDir <dir>\n");
+      return EXIT_USAGE;
+    }
+    let raw;
+    try {
+      raw = await fs.readFile(inputPath, "utf-8");
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Failed to read ${inputPath}: ${message}
+`);
+      return EXIT_IO;
+    }
+    let json;
+    try {
+      json = JSON.parse(raw);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Invalid JSON: ${message}
+`);
+      return EXIT_VALIDATE;
+    }
+    const framesRaw = getFlagString(parsed.flags, "frames") ?? "0";
+    const frames = framesRaw.split(/[,\s]+/g).map((v) => v.trim()).filter(Boolean).map((v) => Number(v)).filter((n) => Number.isFinite(n));
+    if (frames.length === 0) {
+      process.stderr.write('Invalid --frames (expected comma-separated frame numbers, e.g. "0,30,60")\n');
+      return EXIT_USAGE;
+    }
+    const imageFormatRaw = (getFlagString(parsed.flags, "imageFormat") ?? "png").toLowerCase();
+    const imageFormat = parseImageFormat(imageFormatRaw);
+    if (!imageFormat) {
+      process.stderr.write(`Invalid --imageFormat: ${imageFormatRaw} (expected png|jpeg|webp)
+`);
+      return EXIT_USAGE;
+    }
+    const scaleRaw = getFlagString(parsed.flags, "scale");
+    const jpegQualityRaw = getFlagString(parsed.flags, "jpegQuality");
+    const publicDir = getFlagString(parsed.flags, "publicDir");
+    const debugBounds = Boolean(parsed.flags.debugBounds);
+    const debugLabels = Boolean(parsed.flags.debugLabels);
+    const scale = scaleRaw ? Number(scaleRaw) : void 0;
+    const jpegQuality = jpegQualityRaw ? Number(jpegQualityRaw) : void 0;
+    const engine = new WavesEngine(globalRegistry, new IRValidator(globalRegistry));
+    try {
+      const inputProps = debugBounds || debugLabels ? { __wavesDebugBounds: debugBounds, __wavesDebugLabels: debugLabels } : void 0;
+      const opts = {
+        outputDir: outDir,
+        frames,
+        imageFormat,
+        registrationModules
+      };
+      if (publicDir) opts.publicDir = publicDir;
+      if (Number.isFinite(scale ?? Number.NaN)) opts.scale = scale;
+      if (Number.isFinite(jpegQuality ?? Number.NaN)) opts.jpegQuality = jpegQuality;
+      if (inputProps) opts.inputProps = inputProps;
+      const written = await engine.renderStills(json, opts);
+      for (const p of written) {
+        process.stderr.write(`Wrote ${p}
+`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const context = err instanceof WavesRenderError ? err.context : void 0;
+      const payload = context ? stringifyJSON({ error: message, context }, pretty) : null;
+      process.stderr.write(`stills failed: ${message}
+`);
+      if (payload) process.stderr.write(payload);
+      return EXIT_RENDER;
+    }
+    return EXIT_OK;
+  }
   process.stderr.write(`Unknown command: ${parsed.command}
 `);
   process.stderr.write(`Run: waves --help

package/dist/index.d.mts

@@ -46,12 +46,25 @@ interface RenderOptions {
     publicDir?: string;
     rootDir?: string;
     registrationModules?: string[];
+    inputProps?: Record<string, unknown>;
+}
+interface RenderStillsOptions {
+    outputDir: string;
+    frames: number[];
+    imageFormat?: 'png' | 'jpeg' | 'webp';
+    jpegQuality?: number;
+    scale?: number;
+    publicDir?: string;
+    rootDir?: string;
+    registrationModules?: string[];
+    inputProps?: Record<string, unknown>;
 }
 declare class WavesEngine {
     private readonly registry;
     private readonly validator;
     constructor(registry: ComponentRegistry, validator: IRValidator);
     render(ir: unknown, options: RenderOptions): Promise<void>;
+    renderStills(ir: unknown, options: RenderStillsOptions): Promise<string[]>;
 }
 
 declare class WavesError extends Error {

package/dist/index.d.ts

@@ -46,12 +46,25 @@ interface RenderOptions {
     publicDir?: string;
     rootDir?: string;
     registrationModules?: string[];
+    inputProps?: Record<string, unknown>;
+}
+interface RenderStillsOptions {
+    outputDir: string;
+    frames: number[];
+    imageFormat?: 'png' | 'jpeg' | 'webp';
+    jpegQuality?: number;
+    scale?: number;
+    publicDir?: string;
+    rootDir?: string;
+    registrationModules?: string[];
+    inputProps?: Record<string, unknown>;
 }
 declare class WavesEngine {
     private readonly registry;
     private readonly validator;
     constructor(registry: ComponentRegistry, validator: IRValidator);
     render(ir: unknown, options: RenderOptions): Promise<void>;
+    renderStills(ir: unknown, options: RenderStillsOptions): Promise<string[]>;
 }
 
 declare class WavesError extends Error {