@smoove/renderer 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shemi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @smoove/renderer
+
+Headless video renderer for [smoove](https://smoove.dev) — turn a
+`Composition` into an MP4 or WebM file from Node.
+
+`renderComposition` walks the frame clock the same way the player does,
+rasterizes each frame with [skia-canvas](https://skia-canvas.org), and
+encodes the result with [Mediabunny](https://mediabunny.dev) in a single
+in-process pass: no ffmpeg binary, no temp files. The composition you
+preview in the browser is the file you ship.
+
+## Install
+
+```sh
+pnpm add konva @smoove/core @smoove/renderer
+```
+
+`konva` and `@smoove/core` are peer dependencies
+(`@smoove/transitions` is an optional peer). Node-only.
+
+## Quick example
+
+Import the `register` entry first — it installs the skia backend and the
+Node media factories. Do this before you build the composition:
+
+```ts
+import "@smoove/renderer/register";
+import { Composition, interpolate, Rect, Sequence } from "@smoove/core";
+import { renderComposition } from "@smoove/renderer";
+
+const comp = new Composition({ id: "out", fps: 60, durationInFrames: 120, width: 1280, height: 720 });
+
+const main = new Sequence({ from: 0, durationInFrames: 120 });
+const box = new Rect({ x: 0, y: 320, width: 80, height: 80, fill: "#ffd166" });
+main.add(box);
+main.register((f) => box.x(interpolate(f, [0, 119], [0, 1200])));
+comp.add(main);
+
+await renderComposition(comp, { output: "out.mp4" });
+```
+
+Only `output` is required; everything else falls back to the composition's
+own settings. Options include `resolution`, `fit`, `quality` presets,
+`fps`, a frame `range`, `format` (`"mp4"` or `"webm"`), `mute`, `fonts`,
+`onProgress`, and an `AbortSignal`. Single frames and raw frame streams are
+also supported.
+
+To render WebGL shader transitions headlessly, import `@smoove/renderer/gl`
+before building the composition.
+
+## Docs
+
+Full documentation lives at [smoove.dev](https://smoove.dev).
+
+## License
+
+MIT

package/dist/audio-mix.d.ts

@@ -0,0 +1,14 @@
+import type { AudioClip } from "./types.js";
+/**
+ * Decode every {@link AudioClip} and mix it into one interleaved stereo f32 PCM
+ * timeline at {@link AUDIO_SAMPLE_RATE}. Replaces the ffmpeg
+ * `atrim/atempo/volume/adelay/amix` filtergraph: each clip is decoded with a
+ * Mediabunny {@link AudioSampleSink}, resampled for its playback rate + source
+ * rate, gain-shaped by its volume envelope, delayed to its start frame, and
+ * summed. The result is fed to the encoder as {@link AudioSample}s.
+ *
+ * Returns `null` when nothing decodes to audible PCM (so the caller can skip the
+ * audio track entirely).
+ */
+export declare function mixAudio(clips: AudioClip[], fps: number, totalSeconds: number, fromFrame?: number): Promise<Float32Array | null>;
+//# sourceMappingURL=audio-mix.d.ts.map

package/dist/audio-mix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.d.ts","sourceRoot":"","sources":["../src/audio-mix.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAAE,EAClB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,SAAS,SAAI,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAiB9B"}

package/dist/audio-mix.js

@@ -0,0 +1,127 @@
+import { ALL_FORMATS, AudioSampleSink, Input } from "mediabunny";
+import { AUDIO_CHANNELS, AUDIO_SAMPLE_RATE } from "./encode.js";
+import { makeInputSource } from "./media-input-source.js";
+/**
+ * Decode every {@link AudioClip} and mix it into one interleaved stereo f32 PCM
+ * timeline at {@link AUDIO_SAMPLE_RATE}. Replaces the ffmpeg
+ * `atrim/atempo/volume/adelay/amix` filtergraph: each clip is decoded with a
+ * Mediabunny {@link AudioSampleSink}, resampled for its playback rate + source
+ * rate, gain-shaped by its volume envelope, delayed to its start frame, and
+ * summed. The result is fed to the encoder as {@link AudioSample}s.
+ *
+ * Returns `null` when nothing decodes to audible PCM (so the caller can skip the
+ * audio track entirely).
+ */
+export async function mixAudio(clips, fps, totalSeconds, fromFrame = 0) {
+    if (clips.length === 0)
+        return null;
+    const totalFrames = Math.ceil(totalSeconds * AUDIO_SAMPLE_RATE);
+    const mix = new Float32Array(totalFrames * AUDIO_CHANNELS);
+    let mixed = 0;
+    for (const clip of clips) {
+        mixed += await mixClip(mix, totalFrames, clip, fps, fromFrame);
+    }
+    if (mixed === 0)
+        return null;
+    // Sum can exceed unity when clips overlap; clamp so the encoder gets valid PCM.
+    for (let i = 0; i < mix.length; i++) {
+        const v = mix[i];
+        mix[i] = v > 1 ? 1 : v < -1 ? -1 : v;
+    }
+    return mix;
+}
+/** Decode one clip and add it into `mix`. Returns the number of frames written. */
+async function mixClip(mix, totalFrames, clip, fps, fromFrame) {
+    const compDurSec = (clip.endFrame - clip.startFrame + 1) / fps;
+    const srcDurSec = compDurSec * clip.playbackRate;
+    const startSec = (clip.startFrame - fromFrame) / fps;
+    const input = new Input({ formats: ALL_FORMATS, source: makeInputSource(clip.src) });
+    try {
+        const track = await input.getPrimaryAudioTrack();
+        if (!track || !(await track.canDecode()))
+            return 0;
+        const sink = new AudioSampleSink(track);
+        // Decode the consumed source region into contiguous per-channel buffers.
+        const parts = [];
+        let srcChannels = 0;
+        let srcRate = 0;
+        for await (const s of sink.samples(clip.mediaInSeconds, clip.mediaInSeconds + srcDurSec)) {
+            srcChannels = s.numberOfChannels;
+            srcRate = s.sampleRate;
+            const buf = new Float32Array(s.allocationSize({ planeIndex: 0, format: "f32" }) / 4);
+            s.copyTo(buf, { planeIndex: 0, format: "f32" });
+            parts.push({ ts: s.timestamp, data: buf, frames: s.numberOfFrames });
+            s.close();
+        }
+        if (parts.length === 0 || srcChannels === 0)
+            return 0;
+        const totalSrc = parts.reduce((n, p) => n + p.frames, 0);
+        const chans = Array.from({ length: srcChannels }, () => new Float32Array(totalSrc));
+        let w = 0;
+        for (const p of parts) {
+            for (let i = 0; i < p.frames; i++) {
+                const base = i * srcChannels;
+                for (let c = 0; c < srcChannels; c++)
+                    chans[c][w + i] = p.data[base + c];
+            }
+            w += p.frames;
+        }
+        const origin = parts[0].ts;
+        const left = chans[0];
+        const right = (srcChannels > 1 ? chans[1] : chans[0]);
+        const outStart = Math.round(startSec * AUDIO_SAMPLE_RATE);
+        const outLen = Math.round(compDurSec * AUDIO_SAMPLE_RATE);
+        let written = 0;
+        for (let i = 0; i < outLen; i++) {
+            const outIdx = outStart + i;
+            if (outIdx < 0 || outIdx >= totalFrames)
+                continue;
+            const compRel = i / AUDIO_SAMPLE_RATE;
+            const srcAbs = clip.mediaInSeconds + compRel * clip.playbackRate;
+            const pos = (srcAbs - origin) * srcRate;
+            const i0 = Math.floor(pos);
+            if (i0 < 0 || i0 >= totalSrc)
+                continue;
+            const frac = pos - i0;
+            const vol = evalVolume(clip.volume, compRel);
+            const li = outIdx * 2;
+            mix[li] = mix[li] + sampleAt(left, i0, frac, totalSrc) * vol;
+            mix[li + 1] = mix[li + 1] + sampleAt(right, i0, frac, totalSrc) * vol;
+            written++;
+        }
+        return written;
+    }
+    finally {
+        input.dispose();
+    }
+}
+/** Linear interpolation between frame `i0` and `i0+1`, holding the last frame. */
+function sampleAt(buf, i0, frac, len) {
+    const a = buf[i0];
+    if (i0 + 1 >= len || frac === 0)
+        return a;
+    const b = buf[i0 + 1];
+    return a + (b - a) * frac;
+}
+/** Evaluate a constant level or piecewise-linear envelope at clip-relative time `t` (seconds). */
+function evalVolume(volume, t) {
+    if (typeof volume === "number")
+        return volume;
+    if (volume.length === 0)
+        return 1;
+    if (volume.length === 1)
+        return volume[0].volume;
+    const first = volume[0];
+    if (t <= first.time)
+        return first.volume;
+    for (let i = 1; i < volume.length; i++) {
+        const b = volume[i];
+        if (t <= b.time) {
+            const a = volume[i - 1];
+            const span = b.time - a.time || 1;
+            return a.volume + ((b.volume - a.volume) * (t - a.time)) / span;
+        }
+    }
+    return volume[volume.length - 1].volume;
+}
+//# sourceMappingURL=audio-mix.js.map

package/dist/audio-mix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-mix.js","sourceRoot":"","sources":["../src/audio-mix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAkB,EAClB,GAAW,EACX,YAAoB,EACpB,SAAS,GAAG,CAAC;IAEb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC,CAAC;IAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7B,gFAAgF;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAW,CAAC;QAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,OAAO,CACpB,GAAiB,EACjB,WAAmB,EACnB,IAAe,EACf,GAAW,EACX,SAAiB;IAEjB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC/D,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC;IACjD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;IAErD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QAExC,yEAAyE;QACzE,MAAM,KAAK,GAAyD,EAAE,CAAC;QACvE,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;YACzF,WAAW,GAAG,CAAC,CAAC,gBAAgB,CAAC;YACjC,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACrF,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YACrE,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAmB,KAAK,CAAC,IAAI,CACtC,EAAE,MAAM,EAAE,WAAW,EAAE,EACvB,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CACjC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC;gBAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE;oBACjC,KAAK,CAAC,CAAC,CAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAW,CAAC;YACnE,CAAC;YACD,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,GAAI,KAAK,CAAC,CAAC,CAAoB,CAAC,EAAE,CAAC;QAE/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAiB,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAiB,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAAC;QAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,WAAW;gBAAE,SAAS;YAClD,MAAM,OAAO,GAAG,CAAC,GAAG,iBAAiB,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,GAAG,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;YACjE,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC;YACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,QAAQ;gBAAE,SAAS;YACvC,MAAM,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;YACtB,GAAG,CAAC,EAAE,CAAC,GAAI,GAAG,CAAC,EAAE,CAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC;YACzE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAI,GAAG,CAAC,EAAE,GAAG,CAAC,CAAY,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC;YAClF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,SAAS,QAAQ,CAAC,GAAiB,EAAE,EAAU,EAAE,IAAY,EAAE,GAAW;IACxE,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAW,CAAC;IAC5B,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAW,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,kGAAkG;AAClG,SAAS,UAAU,CAAC,MAAiC,EAAE,CAAS;IAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAQ,MAAM,CAAC,CAAC,CAAoB,CAAC,MAAM,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;IAC1C,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAmB,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAmB,CAAC;YAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAQ,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAoB,CAAC,MAAM,CAAC;AAC9D,CAAC"}

package/dist/audio-source-null.d.ts

@@ -0,0 +1,25 @@
+import type { AudioSource, AudioSourceFactory } from "@smoove/core";
+/**
+ * No-op {@link AudioSource} for server rendering. Audio is not decoded by the
+ * node during frame rendering — `RenderingAudioDriver` only records timing/volume
+ * metadata per frame (collected via `comp.getAudioAssets()`), which the
+ * {@link mixAudio} pass later decodes (via Mediabunny) and mixes into the muxed
+ * track. This source exists only so the `Audio` node can be constructed in Node
+ * without touching `document`.
+ */
+export declare class NullAudioSource implements AudioSource {
+    readonly duration = 0;
+    readonly currentTime = 0;
+    readonly isReady = true;
+    load(): Promise<void>;
+    seek(): Promise<void>;
+    play(): Promise<void>;
+    pause(): void;
+    setMuted(): void;
+    setVolume(): void;
+    setPlaybackRate(): void;
+    onReady(): () => void;
+    destroy(): void;
+}
+export declare const nullAudioSourceFactory: AudioSourceFactory;
+//# sourceMappingURL=audio-source-null.d.ts.map

package/dist/audio-source-null.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-source-null.d.ts","sourceRoot":"","sources":["../src/audio-source-null.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,QAAQ,KAAK;IACtB,QAAQ,CAAC,WAAW,KAAK;IACzB,QAAQ,CAAC,OAAO,QAAQ;IAElB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,KAAK,IAAI,IAAI;IACb,QAAQ,IAAI,IAAI;IAChB,SAAS,IAAI,IAAI;IACjB,eAAe,IAAI,IAAI;IACvB,OAAO,IAAI,MAAM,IAAI;IAGrB,OAAO,IAAI,IAAI;CAChB;AAED,eAAO,MAAM,sBAAsB,EAAE,kBAAgD,CAAC"}

package/dist/audio-source-null.js

@@ -0,0 +1,26 @@
+/**
+ * No-op {@link AudioSource} for server rendering. Audio is not decoded by the
+ * node during frame rendering — `RenderingAudioDriver` only records timing/volume
+ * metadata per frame (collected via `comp.getAudioAssets()`), which the
+ * {@link mixAudio} pass later decodes (via Mediabunny) and mixes into the muxed
+ * track. This source exists only so the `Audio` node can be constructed in Node
+ * without touching `document`.
+ */
+export class NullAudioSource {
+    duration = 0;
+    currentTime = 0;
+    isReady = true;
+    async load() { }
+    async seek() { }
+    async play() { }
+    pause() { }
+    setMuted() { }
+    setVolume() { }
+    setPlaybackRate() { }
+    onReady() {
+        return () => { };
+    }
+    destroy() { }
+}
+export const nullAudioSourceFactory = () => new NullAudioSource();
+//# sourceMappingURL=audio-source-null.js.map

package/dist/audio-source-null.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-source-null.js","sourceRoot":"","sources":["../src/audio-source-null.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACjB,QAAQ,GAAG,CAAC,CAAC;IACb,WAAW,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,IAAI,CAAC;IAExB,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,KAAU,CAAC;IAChB,QAAQ,KAAU,CAAC;IACnB,SAAS,KAAU,CAAC;IACpB,eAAe,KAAU,CAAC;IAC1B,OAAO;QACL,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAU,CAAC;CACnB;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAuB,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC"}

package/dist/audio-track.d.ts

@@ -0,0 +1,17 @@
+import type { Composition } from "@smoove/core";
+import type { AudioClip, VolumeKeyframe } from "./types.js";
+/**
+ * Coalesce the per-frame audio samples collected during a render
+ * (`comp.getAudioAssets()`) into clips. Samples are grouped by source id,
+ * muted/silent ones dropped, then split into runs of consecutive frames — each
+ * run becomes one {@link AudioClip} the {@link mixAudio} pass decodes and mixes.
+ */
+export declare function collectAudioTrack(comp: Composition, fps: number): AudioClip[];
+/**
+ * Reduce a dense per-frame volume curve to its breakpoints (Ramer–Douglas–
+ * Peucker on vertical error). A linear ramp collapses to two points, a constant
+ * run to two — keeping the volume envelope evaluated by the mixer compact while
+ * preserving the shape. `eps` is the max allowed volume error (0..1).
+ */
+export declare function simplifyEnvelope(kfs: VolumeKeyframe[], eps?: number): VolumeKeyframe[];
+//# sourceMappingURL=audio-track.d.ts.map

package/dist/audio-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-track.d.ts","sourceRoot":"","sources":["../src/audio-track.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CA4B7E;AAwBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,GAAG,SAAQ,GAAG,cAAc,EAAE,CA4BrF"}

package/dist/audio-track.js

@@ -0,0 +1,91 @@
+/**
+ * Coalesce the per-frame audio samples collected during a render
+ * (`comp.getAudioAssets()`) into clips. Samples are grouped by source id,
+ * muted/silent ones dropped, then split into runs of consecutive frames — each
+ * run becomes one {@link AudioClip} the {@link mixAudio} pass decodes and mixes.
+ */
+export function collectAudioTrack(comp, fps) {
+    const audible = comp.getAudioAssets().filter((a) => !a.muted && a.volume > 0);
+    const byId = new Map();
+    for (const a of audible) {
+        const arr = byId.get(a.id);
+        if (arr)
+            arr.push(a);
+        else
+            byId.set(a.id, [a]);
+    }
+    const clips = [];
+    for (const [id, group] of byId) {
+        group.sort((x, y) => x.frame - y.frame);
+        let run = [];
+        let prevFrame = Number.NaN;
+        for (const a of group) {
+            if (run.length > 0 && a.frame !== prevFrame + 1) {
+                clips.push(makeClip(id, run, fps));
+                run = [];
+            }
+            run.push(a);
+            prevFrame = a.frame;
+        }
+        if (run.length > 0)
+            clips.push(makeClip(id, run, fps));
+    }
+    clips.sort((a, b) => a.startFrame - b.startFrame);
+    return clips;
+}
+function makeClip(id, run, fps) {
+    const first = run[0];
+    const last = run[run.length - 1];
+    const startFrame = first.frame;
+    const baseVolume = first.volume;
+    const varies = run.some((r) => Math.abs(r.volume - baseVolume) > 1e-6);
+    const volume = varies
+        ? simplifyEnvelope(run.map((r) => ({ time: (r.frame - startFrame) / fps, volume: r.volume })))
+        : baseVolume;
+    return {
+        id,
+        src: first.src,
+        startFrame,
+        endFrame: last.frame,
+        mediaInSeconds: first.mediaTime,
+        playbackRate: first.playbackRate,
+        volume,
+    };
+}
+/**
+ * Reduce a dense per-frame volume curve to its breakpoints (Ramer–Douglas–
+ * Peucker on vertical error). A linear ramp collapses to two points, a constant
+ * run to two — keeping the volume envelope evaluated by the mixer compact while
+ * preserving the shape. `eps` is the max allowed volume error (0..1).
+ */
+export function simplifyEnvelope(kfs, eps = 0.015) {
+    if (kfs.length <= 2)
+        return kfs;
+    const keep = new Uint8Array(kfs.length);
+    keep[0] = 1;
+    keep[kfs.length - 1] = 1;
+    const stack = [[0, kfs.length - 1]];
+    while (stack.length > 0) {
+        const [lo, hi] = stack.pop();
+        const a = kfs[lo];
+        const b = kfs[hi];
+        const span = b.time - a.time || 1;
+        let maxErr = -1;
+        let idx = -1;
+        for (let i = lo + 1; i < hi; i++) {
+            const p = kfs[i];
+            const lineV = a.volume + ((b.volume - a.volume) * (p.time - a.time)) / span;
+            const err = Math.abs(p.volume - lineV);
+            if (err > maxErr) {
+                maxErr = err;
+                idx = i;
+            }
+        }
+        if (maxErr > eps && idx >= 0) {
+            keep[idx] = 1;
+            stack.push([lo, idx], [idx, hi]);
+        }
+    }
+    return kfs.filter((_, i) => keep[i] === 1);
+}
+//# sourceMappingURL=audio-track.js.map

package/dist/audio-track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-track.js","sourceRoot":"","sources":["../src/audio-track.ts"],"names":[],"mappings":"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"}

package/dist/encode.d.ts

@@ -0,0 +1,45 @@
+import type { Writable } from "node:stream";
+import type { QualityConfig } from "./types.js";
+/** Output PCM format the audio mixer produces and the encoder consumes. */
+export declare const AUDIO_SAMPLE_RATE = 48000;
+export declare const AUDIO_CHANNELS = 2;
+export type EncodeTarget = {
+    kind: "file";
+    path: string;
+}
+/** A node stream to pipe a fragmented container into (for `renderToStream`). */
+ | {
+    kind: "stream";
+    writable: Writable;
+};
+export interface EncoderOptions {
+    width: number;
+    height: number;
+    fps: number;
+    format: "mp4" | "webm";
+    quality: QualityConfig;
+    hasAudio: boolean;
+    target: EncodeTarget;
+}
+/**
+ * Single-pass video+audio encoder built on Mediabunny's {@link Output}. Replaces
+ * the old two-pass ffmpeg flow (raw-RGBA pipe → temp file → mux): video frames
+ * are added as {@link VideoSample}s, mixed audio as {@link AudioSample}s, and one
+ * `finalize()` muxes the container — no temp files, no child processes.
+ */
+export declare class MediabunnyEncoder {
+    private readonly _output;
+    private readonly _video;
+    private readonly _audio;
+    private readonly _width;
+    private readonly _height;
+    constructor(opts: EncoderOptions);
+    start(): Promise<void>;
+    /** Add one RGBA frame (`width*height*4` bytes) at `timestamp` seconds. */
+    addFrame(rgba: Uint8Array, timestamp: number, duration: number): Promise<void>;
+    /** Add a chunk of interleaved f32 PCM ({@link AUDIO_CHANNELS} @ {@link AUDIO_SAMPLE_RATE}). */
+    addAudioChunk(data: Float32Array, timestamp: number): Promise<void>;
+    finalize(): Promise<void>;
+    cancel(): Promise<void>;
+}
+//# sourceMappingURL=encode.d.ts.map

package/dist/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAa5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAChC,gFAAgF;GAC9E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,cAAc;IAmChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,0EAA0E;IACpE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepF,+FAA+F;IACzF,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxB"}

package/dist/encode.js

@@ -0,0 +1,105 @@
+import { AppendOnlyStreamTarget, AudioSample, AudioSampleSource, FilePathTarget, Mp4OutputFormat, Output, VideoSample, VideoSampleSource, WebMOutputFormat, } from "mediabunny";
+/** Output PCM format the audio mixer produces and the encoder consumes. */
+export const AUDIO_SAMPLE_RATE = 48_000;
+export const AUDIO_CHANNELS = 2;
+/**
+ * Single-pass video+audio encoder built on Mediabunny's {@link Output}. Replaces
+ * the old two-pass ffmpeg flow (raw-RGBA pipe → temp file → mux): video frames
+ * are added as {@link VideoSample}s, mixed audio as {@link AudioSample}s, and one
+ * `finalize()` muxes the container — no temp files, no child processes.
+ */
+export class MediabunnyEncoder {
+    _output;
+    _video;
+    _audio;
+    _width;
+    _height;
+    constructor(opts) {
+        this._width = opts.width;
+        this._height = opts.height;
+        const streaming = opts.target.kind === "stream";
+        const target = opts.target.kind === "file"
+            ? new FilePathTarget(opts.target.path)
+            : new AppendOnlyStreamTarget(nodeWritableToWeb(opts.target.writable));
+        // Streaming wants a sequential, fragmented container; files get an
+        // in-memory fast-start so the moov atom lands up front (web-playable).
+        const format = opts.format === "webm"
+            ? new WebMOutputFormat()
+            : new Mp4OutputFormat({ fastStart: streaming ? "fragmented" : "in-memory" });
+        this._output = new Output({ format, target });
+        const videoCodec = opts.format === "webm" ? "vp9" : "avc";
+        this._video = new VideoSampleSource({ codec: videoCodec, bitrate: opts.quality.videoBitrate });
+        this._output.addVideoTrack(this._video, { frameRate: opts.fps });
+        if (opts.hasAudio) {
+            const audioCodec = opts.format === "webm" ? "opus" : "aac";
+            this._audio = new AudioSampleSource({
+                codec: audioCodec,
+                bitrate: opts.quality.audioBitrate,
+            });
+            this._output.addAudioTrack(this._audio);
+        }
+        else {
+            this._audio = null;
+        }
+    }
+    start() {
+        return this._output.start();
+    }
+    /** Add one RGBA frame (`width*height*4` bytes) at `timestamp` seconds. */
+    async addFrame(rgba, timestamp, duration) {
+        const sample = new VideoSample(rgba, {
+            format: "RGBA",
+            codedWidth: this._width,
+            codedHeight: this._height,
+            timestamp,
+            duration,
+        });
+        try {
+            await this._video.add(sample);
+        }
+        finally {
+            sample.close();
+        }
+    }
+    /** Add a chunk of interleaved f32 PCM ({@link AUDIO_CHANNELS} @ {@link AUDIO_SAMPLE_RATE}). */
+    async addAudioChunk(data, timestamp) {
+        if (!this._audio)
+            return;
+        const sample = new AudioSample({
+            data,
+            format: "f32",
+            numberOfChannels: AUDIO_CHANNELS,
+            sampleRate: AUDIO_SAMPLE_RATE,
+            timestamp,
+        });
+        try {
+            await this._audio.add(sample);
+        }
+        finally {
+            sample.close();
+        }
+    }
+    finalize() {
+        return this._output.finalize();
+    }
+    cancel() {
+        return this._output.cancel();
+    }
+}
+/** Bridge a node {@link Writable} to a web {@link WritableStream} for streaming targets. */
+function nodeWritableToWeb(node) {
+    return new WritableStream({
+        write(chunk) {
+            return new Promise((resolve, reject) => {
+                node.write(chunk, (err) => (err ? reject(err) : resolve()));
+            });
+        },
+        close() {
+            node.end();
+        },
+        abort(reason) {
+            node.destroy(reason instanceof Error ? reason : new Error(String(reason)));
+        },
+    });
+}
+//# sourceMappingURL=encode.js.map

package/dist/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../src/encode.ts"],"names":[],"mappings":"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"}

package/dist/font-loader.d.ts

@@ -0,0 +1,11 @@
+import type { FontLoader } from "@smoove/core";
+/** Default on-disk cache for fonts fetched from remote URLs. */
+export declare const DEFAULT_FONT_CACHE_DIR: string;
+/**
+ * Build a {@link FontLoader} backed by skia-canvas `FontLibrary`. Downloads
+ * remote font URLs into `cacheDir` (default {@link DEFAULT_FONT_CACHE_DIR}) and
+ * registers each face once. Installed by `setupServerRendering` so scene-declared
+ * `Font` nodes work headlessly without a DOM `@font-face`.
+ */
+export declare function makeSkiaFontLoader(cacheDir?: string): FontLoader;
+//# sourceMappingURL=font-loader.d.ts.map

package/dist/font-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-loader.d.ts","sourceRoot":"","sources":["../src/font-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAsB,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnE,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,QAAsC,CAAC;AA6B1E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAA+B,GAAG,UAAU,CAQxF"}

package/dist/font-loader.js

@@ -0,0 +1,52 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { FontLibrary } from "skia-canvas";
+/** Default on-disk cache for fonts fetched from remote URLs. */
+export const DEFAULT_FONT_CACHE_DIR = path.join(tmpdir(), "smoove-fonts");
+// Process-level dedup of FontLibrary.use() calls. skia accumulates faces into a
+// family (and is first-wins per weight/style slot), so re-registering the same
+// face is wasted work — track what we've already installed.
+const registered = new Set();
+function isRemote(src) {
+    return /^https?:\/\//i.test(src);
+}
+/**
+ * Resolve a face `src` to a local file path skia-canvas can load. Local paths
+ * pass through; remote URLs are downloaded once into `cacheDir` (keyed by a hash
+ * of the URL) and reused on subsequent frames and process runs.
+ */
+async function resolveToLocalPath(src, cacheDir) {
+    if (!isRemote(src))
+        return src;
+    const ext = path.extname(new URL(src).pathname) || ".font";
+    const file = path.join(cacheDir, `${createHash("sha256").update(src).digest("hex")}${ext}`);
+    if (existsSync(file))
+        return file;
+    const res = await fetch(src);
+    if (!res.ok)
+        throw new Error(`font fetch failed (${res.status}) for ${src}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    await mkdir(cacheDir, { recursive: true });
+    await writeFile(file, buf);
+    return file;
+}
+/**
+ * Build a {@link FontLoader} backed by skia-canvas `FontLibrary`. Downloads
+ * remote font URLs into `cacheDir` (default {@link DEFAULT_FONT_CACHE_DIR}) and
+ * registers each face once. Installed by `setupServerRendering` so scene-declared
+ * `Font` nodes work headlessly without a DOM `@font-face`.
+ */
+export function makeSkiaFontLoader(cacheDir = DEFAULT_FONT_CACHE_DIR) {
+    return async (family, face) => {
+        const localPath = await resolveToLocalPath(face.src, cacheDir);
+        const key = `${family}|${face.weight}|${face.style}|${localPath}`;
+        if (registered.has(key))
+            return;
+        registered.add(key);
+        FontLibrary.use(family, [localPath]);
+    };
+}
+//# sourceMappingURL=font-loader.js.map