onda-engine 0.1.0

package/dist/render.d.ts

@@ -0,0 +1,42 @@
+import { ReactElement } from 'react';
+
+type Backend = 'auto' | 'vello' | 'cpu';
+type Encoder = 'auto' | 'videotoolbox' | 'nvenc' | 'qsv' | 'libx264';
+interface RenderProgress {
+    renderedFrames: number;
+    totalFrames: number;
+}
+interface RenderToFileOptions {
+    /** Output path — `.mp4` (or `.gif`). */
+    output: string;
+    /** Rendering backend. Default `'auto'` (Vello/GPU if available, else CPU). */
+    backend?: Backend;
+    /** H.264 encoder for mp4. Default `'auto'` (probes for hardware, else libx264). */
+    encoder?: Encoder;
+    /** Called once per rendered frame. */
+    onProgress?: (progress: RenderProgress) => void;
+    /** Path to the `onda` binary. Default: `$ONDA_BIN`, else `onda` on PATH. */
+    ondaBin?: string;
+    /** Spatial supersampling factor (1–4, default 1 = off): the CLI renders each
+     *  frame at N× resolution then box-downscales to native, area-averaging away the
+     *  minification aliasing detailed images shimmer with under motion. N=2 is the
+     *  sweet spot (matches the image decoder's 2× headroom). Costs ~N² render time. */
+    superSample?: number;
+}
+interface RenderStillOptions {
+    /** Output path — `.png`. */
+    output: string;
+    /** Which frame to render. Default `0`. */
+    frame?: number;
+    backend?: Backend;
+    ondaBin?: string;
+}
+/**
+ * Render a composition to a video file. Generates every frame's scene graph
+ * in-process, then hands it to the `onda` CLI to rasterize + encode.
+ */
+declare function renderToFile(composition: ReactElement, options: RenderToFileOptions): Promise<void>;
+/** Render a single frame to a PNG (e.g. a poster frame or a vision check). */
+declare function renderStillToFile(composition: ReactElement, options: RenderStillOptions): Promise<void>;
+
+export { type Backend, type Encoder, type RenderProgress, type RenderStillOptions, type RenderToFileOptions, renderStillToFile, renderToFile };

package/dist/render.js

@@ -0,0 +1,113 @@
+import { spawn } from 'child_process';
+import { mkdtemp, writeFile, rm } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { runEngineWarmers, motionBlurConfig, renderFramesJSON, renderFrame, registeredFonts } from 'onda-engine/react';
+
+// ../render/src/index.ts
+var resolveBin = (override) => override ?? process.env.ONDA_BIN ?? "onda";
+async function fontArgs(dir) {
+  const fonts = registeredFonts();
+  const args = [];
+  for (let i = 0; i < fonts.length; i++) {
+    const fontPath = join(dir, `font-${i}.ttf`);
+    await writeFile(fontPath, fonts[i]);
+    args.push("--font", fontPath);
+  }
+  return args;
+}
+async function renderToFile(composition, options) {
+  const { output, backend = "auto", encoder = "auto", onProgress, ondaBin, superSample } = options;
+  await runEngineWarmers();
+  const motionBlur = motionBlurConfig(composition);
+  const framesJson = renderFramesJSON(composition);
+  const dir = await mkdtemp(join(tmpdir(), "onda-render-"));
+  const framesPath = join(dir, "frames.json");
+  try {
+    await writeFile(framesPath, framesJson);
+    await runOnda(
+      resolveBin(ondaBin),
+      [
+        "export-frames",
+        framesPath,
+        output,
+        "--backend",
+        backend,
+        "--encoder",
+        encoder,
+        "--progress",
+        ...motionBlur ? ["--motion-blur", String(motionBlur.samples)] : [],
+        ...superSample && superSample > 1 ? ["--supersample", String(Math.min(4, Math.round(superSample)))] : [],
+        ...await fontArgs(dir)
+      ],
+      onProgress
+    );
+  } finally {
+    await rm(dir, { recursive: true, force: true });
+  }
+}
+async function renderStillToFile(composition, options) {
+  const { output, frame = 0, backend = "auto", ondaBin } = options;
+  await runEngineWarmers();
+  const sceneJson = JSON.stringify(renderFrame(composition, frame));
+  const dir = await mkdtemp(join(tmpdir(), "onda-still-"));
+  const scenePath = join(dir, "scene.json");
+  try {
+    await writeFile(scenePath, sceneJson);
+    await runOnda(resolveBin(ondaBin), [
+      "render",
+      scenePath,
+      output,
+      "--backend",
+      backend,
+      ...await fontArgs(dir)
+    ]);
+  } finally {
+    await rm(dir, { recursive: true, force: true });
+  }
+}
+function runOnda(bin, args, onProgress) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let stderr = "";
+    let buffer = "";
+    child.stdout?.on("data", (chunk) => {
+      buffer += chunk.toString();
+      let nl = buffer.indexOf("\n");
+      while (nl !== -1) {
+        const line = buffer.slice(0, nl);
+        buffer = buffer.slice(nl + 1);
+        const match = line.match(/^\[onda-progress\](\{.*\})/);
+        if (match?.[1] && onProgress) {
+          try {
+            const p = JSON.parse(match[1]);
+            onProgress({ renderedFrames: p.frame, totalFrames: p.total });
+          } catch {
+          }
+        }
+        nl = buffer.indexOf("\n");
+      }
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on(
+      "error",
+      (err) => reject(
+        new Error(`failed to launch onda ('${bin}' \u2014 installed and on PATH?): ${err.message}`)
+      )
+    );
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`onda exited with code ${code}${stderr ? `: ${stderr.trim()}` : ""}`));
+    });
+  });
+}
+//! `@onda-engine/render` — render `@onda-engine/react` compositions to a file via the ONDA
+//! engine. The no-Chromium equivalent of Remotion's `renderMedia`: the scene
+//! graph is generated in-process (`renderFramesJSON`) and handed to the `onda`
+//! CLI, which rasterizes on the GPU (Vello) and encodes with ffmpeg.
+
+export { renderStillToFile, renderToFile };
+//# sourceMappingURL=render.js.map
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../render/src/index.ts"],"names":[],"mappings":"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","file":"render.js","sourcesContent":["//! `@onda-engine/render` — render `@onda-engine/react` compositions to a file via the ONDA\n//! engine. The no-Chromium equivalent of Remotion's `renderMedia`: the scene\n//! graph is generated in-process (`renderFramesJSON`) and handed to the `onda`\n//! CLI, which rasterizes on the GPU (Vello) and encodes with ffmpeg.\n\nimport { spawn } from 'node:child_process'\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport {\n  motionBlurConfig,\n  registeredFonts,\n  renderFrame,\n  renderFramesJSON,\n  runEngineWarmers,\n} from '@onda-engine/react'\nimport type { ReactElement } from 'react'\n\nexport type Backend = 'auto' | 'vello' | 'cpu'\nexport type Encoder = 'auto' | 'videotoolbox' | 'nvenc' | 'qsv' | 'libx264'\n\nexport interface RenderProgress {\n  renderedFrames: number\n  totalFrames: number\n}\n\nexport interface RenderToFileOptions {\n  /** Output path — `.mp4` (or `.gif`). */\n  output: string\n  /** Rendering backend. Default `'auto'` (Vello/GPU if available, else CPU). */\n  backend?: Backend\n  /** H.264 encoder for mp4. Default `'auto'` (probes for hardware, else libx264). */\n  encoder?: Encoder\n  /** Called once per rendered frame. */\n  onProgress?: (progress: RenderProgress) => void\n  /** Path to the `onda` binary. Default: `$ONDA_BIN`, else `onda` on PATH. */\n  ondaBin?: string\n  /** Spatial supersampling factor (1–4, default 1 = off): the CLI renders each\n   *  frame at N× resolution then box-downscales to native, area-averaging away the\n   *  minification aliasing detailed images shimmer with under motion. N=2 is the\n   *  sweet spot (matches the image decoder's 2× headroom). Costs ~N² render time. */\n  superSample?: number\n}\n\nexport interface RenderStillOptions {\n  /** Output path — `.png`. */\n  output: string\n  /** Which frame to render. Default `0`. */\n  frame?: number\n  backend?: Backend\n  ondaBin?: string\n}\n\nconst resolveBin = (override?: string): string => override ?? process.env.ONDA_BIN ?? 'onda'\n\n/** Materialize any fonts the composition declared via `loadFont` into `dir` and\n *  return the `--font <path>` CLI args, so the renderer draws with the SAME bytes\n *  the author-time measurement used (single-source — no manual `--font`). Empty\n *  when no custom font was registered. Call AFTER rendering, so fonts declared\n *  during the render are included. */\nasync function fontArgs(dir: string): Promise<string[]> {\n  const fonts = registeredFonts()\n  const args: string[] = []\n  for (let i = 0; i < fonts.length; i++) {\n    const fontPath = join(dir, `font-${i}.ttf`)\n    await writeFile(fontPath, fonts[i] as Uint8Array)\n    args.push('--font', fontPath)\n  }\n  return args\n}\n\n/**\n * Render a composition to a video file. Generates every frame's scene graph\n * in-process, then hands it to the `onda` CLI to rasterize + encode.\n */\nexport async function renderToFile(\n  composition: ReactElement,\n  options: RenderToFileOptions,\n): Promise<void> {\n  const { output, backend = 'auto', encoder = 'auto', onProgress, ondaBin, superSample } = options\n  // Warm async engine assets (e.g. wasm text measurement) before the sync render,\n  // so components bake real values into the frames instead of estimates.\n  await runEngineWarmers()\n  // `renderFramesJSON` already expands each frame to its motion-blur sub-frames; the\n  // CLI averages each group of K back into one frame, so pass the matching K.\n  const motionBlur = motionBlurConfig(composition)\n  const framesJson = renderFramesJSON(composition)\n  const dir = await mkdtemp(join(tmpdir(), 'onda-render-'))\n  const framesPath = join(dir, 'frames.json')\n  try {\n    await writeFile(framesPath, framesJson)\n    await runOnda(\n      resolveBin(ondaBin),\n      [\n        'export-frames',\n        framesPath,\n        output,\n        '--backend',\n        backend,\n        '--encoder',\n        encoder,\n        '--progress',\n        ...(motionBlur ? ['--motion-blur', String(motionBlur.samples)] : []),\n        ...(superSample && superSample > 1\n          ? ['--supersample', String(Math.min(4, Math.round(superSample)))]\n          : []),\n        ...(await fontArgs(dir)),\n      ],\n      onProgress,\n    )\n  } finally {\n    await rm(dir, { recursive: true, force: true })\n  }\n}\n\n/** Render a single frame to a PNG (e.g. a poster frame or a vision check). */\nexport async function renderStillToFile(\n  composition: ReactElement,\n  options: RenderStillOptions,\n): Promise<void> {\n  const { output, frame = 0, backend = 'auto', ondaBin } = options\n  await runEngineWarmers()\n  const sceneJson = JSON.stringify(renderFrame(composition, frame))\n  const dir = await mkdtemp(join(tmpdir(), 'onda-still-'))\n  const scenePath = join(dir, 'scene.json')\n  try {\n    await writeFile(scenePath, sceneJson)\n    await runOnda(resolveBin(ondaBin), [\n      'render',\n      scenePath,\n      output,\n      '--backend',\n      backend,\n      ...(await fontArgs(dir)),\n    ])\n  } finally {\n    await rm(dir, { recursive: true, force: true })\n  }\n}\n\n/** Spawn the `onda` CLI, stream `[onda-progress]` lines to `onProgress`, and\n *  resolve on a clean exit (reject with stderr otherwise). */\nfunction runOnda(\n  bin: string,\n  args: string[],\n  onProgress?: (progress: RenderProgress) => void,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'pipe'] })\n    let stderr = ''\n    let buffer = ''\n    child.stdout?.on('data', (chunk: Buffer) => {\n      buffer += chunk.toString()\n      let nl = buffer.indexOf('\\n')\n      while (nl !== -1) {\n        const line = buffer.slice(0, nl)\n        buffer = buffer.slice(nl + 1)\n        const match = line.match(/^\\[onda-progress\\](\\{.*\\})/)\n        if (match?.[1] && onProgress) {\n          try {\n            const p = JSON.parse(match[1]) as { frame: number; total: number }\n            onProgress({ renderedFrames: p.frame, totalFrames: p.total })\n          } catch {\n            // ignore a malformed progress line\n          }\n        }\n        nl = buffer.indexOf('\\n')\n      }\n    })\n    child.stderr?.on('data', (chunk: Buffer) => {\n      stderr += chunk.toString()\n    })\n    child.on('error', (err) =>\n      reject(\n        new Error(`failed to launch onda ('${bin}' — installed and on PATH?): ${err.message}`),\n      ),\n    )\n    child.on('close', (code) => {\n      if (code === 0) resolve()\n      else reject(new Error(`onda exited with code ${code}${stderr ? `: ${stderr.trim()}` : ''}`))\n    })\n  })\n}\n"]}