@nodetool-ai/video-nodes 0.8.1

package/dist/nodes/timeline/contactSheet.js.map

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

package/dist/nodes/timeline/outputFormats.d.ts

@@ -0,0 +1,69 @@
+/**
+ * What a timeline render is written as, and which of those carry alpha.
+ *
+ * The table is pure so the refusals can be tested without ffmpeg: picking a
+ * format is a decision about the container, the encoder, the pixel format and
+ * whether transparency survives, and all four have to agree. `mp4` is the one
+ * that cannot agree — H.264 in MP4 has no alpha plane any player reads — so
+ * asking for it with `alpha` is refused here rather than encoded opaque and
+ * handed back as if it had worked.
+ */
+import { type ResolvedMotionBlur } from "@nodetool-ai/timeline/render";
+/** Containers `RenderTimeline` can write. */
+export declare const TIMELINE_OUTPUT_FORMATS: readonly ["mp4", "webm", "mov", "png_sequence"];
+export type TimelineOutputFormat = (typeof TIMELINE_OUTPUT_FORMATS)[number];
+/** The formats whose pixels keep a transparency channel. */
+export declare const ALPHA_OUTPUT_FORMATS: readonly TimelineOutputFormat[];
+/** Thrown when the requested format cannot carry the requested alpha. */
+export declare class AlphaFormatError extends Error {
+    readonly format: TimelineOutputFormat;
+    constructor(format: TimelineOutputFormat);
+}
+/** Thrown when this ffmpeg build lacks the encoder the format needs. */
+export declare class MissingEncoderError extends Error {
+    readonly encoder: string;
+    constructor(encoder: string, format: TimelineOutputFormat);
+}
+/** Everything downstream of the format choice, resolved once. */
+export interface ResolvedTimelineOutput {
+    /**
+     * Motion blur for this render, already clamped (D10). One sample is blur off,
+     * which is what a request that names neither field resolves to.
+     */
+    motionBlur: ResolvedMotionBlur;
+    format: TimelineOutputFormat;
+    /** Whether the frames are composited over a transparent ground. */
+    alpha: boolean;
+    /** File extension of the rendered artifact, without the dot. */
+    extension: string;
+    /** What `videoRef`/`documentRef` reports as the artifact's format. */
+    mimeType: string;
+    /**
+     * ffmpeg output arguments for the frame encoder — codec, profile and pixel
+     * format. Empty for `png_sequence`, which never reaches ffmpeg.
+     */
+    encoderArgs: string[];
+    /** The ffmpeg encoder that must exist, probed before the render starts. */
+    requiredEncoder: string | null;
+    /** Audio codec for the mux pass; null when the format carries no audio. */
+    audioCodec: string | null;
+}
+export interface TimelineOutputRequest {
+    format?: string | null;
+    /**
+     * Sub-frame instants to average into each frame, and how far the shutter
+     * opens in degrees of the frame. Out-of-range values clamp rather than
+     * refusing the render; absent is blur off.
+     */
+    motionBlurSamples?: number | null;
+    shutterAngle?: number | null;
+    alpha?: boolean;
+    /** Override the container's default video encoder. */
+    videoCodec?: string | null;
+    /** Target video bitrate in bits per second; 0 or absent leaves it to ffmpeg. */
+    bitrate?: number | null;
+}
+/** Narrow a caller's string to a format, or say what the choices are. */
+export declare function parseOutputFormat(raw: string | null | undefined): TimelineOutputFormat;
+export declare function resolveTimelineOutput(request?: TimelineOutputRequest): ResolvedTimelineOutput;
+//# sourceMappingURL=outputFormats.d.ts.map

package/dist/nodes/timeline/outputFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputFormats.d.ts","sourceRoot":"","sources":["../../../src/nodes/timeline/outputFormats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAC;AAEtC,6CAA6C;AAC7C,eAAO,MAAM,uBAAuB,YAClC,KAAK,EACL,MAAM,EACN,KAAK,EACL,cAAc,CACN,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,EAAE,SAAS,oBAAoB,EAI/D,CAAC;AAEF,yEAAyE;AACzE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAEtC,YAAY,MAAM,EAAE,oBAAoB,EAOvC;CACF;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAQxD;CACF;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,CAUtF;AAiCD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,qBAA0B,GAClC,sBAAsB,CA4FxB"}

package/dist/nodes/timeline/outputFormats.js

@@ -0,0 +1,173 @@
+/**
+ * What a timeline render is written as, and which of those carry alpha.
+ *
+ * The table is pure so the refusals can be tested without ffmpeg: picking a
+ * format is a decision about the container, the encoder, the pixel format and
+ * whether transparency survives, and all four have to agree. `mp4` is the one
+ * that cannot agree — H.264 in MP4 has no alpha plane any player reads — so
+ * asking for it with `alpha` is refused here rather than encoded opaque and
+ * handed back as if it had worked.
+ */
+import { resolveMotionBlur } from "@nodetool-ai/timeline/render";
+/** Containers `RenderTimeline` can write. */
+export const TIMELINE_OUTPUT_FORMATS = [
+    "mp4",
+    "webm",
+    "mov",
+    "png_sequence"
+];
+/** The formats whose pixels keep a transparency channel. */
+export const ALPHA_OUTPUT_FORMATS = [
+    "webm",
+    "mov",
+    "png_sequence"
+];
+/** Thrown when the requested format cannot carry the requested alpha. */
+export class AlphaFormatError extends Error {
+    format;
+    constructor(format) {
+        super(`The "${format}" format has no alpha channel. Render with transparency ` +
+            `as one of: ${ALPHA_OUTPUT_FORMATS.join(", ")}.`);
+        this.name = "AlphaFormatError";
+        this.format = format;
+    }
+}
+/** Thrown when this ffmpeg build lacks the encoder the format needs. */
+export class MissingEncoderError extends Error {
+    encoder;
+    constructor(encoder, format) {
+        super(`This ffmpeg build has no "${encoder}" encoder, which the "${format}" ` +
+            "format needs. Install an ffmpeg built with it, or render to another " +
+            "format.");
+        this.name = "MissingEncoderError";
+        this.encoder = encoder;
+    }
+}
+/** Narrow a caller's string to a format, or say what the choices are. */
+export function parseOutputFormat(raw) {
+    const value = (raw ?? "mp4").trim().toLowerCase();
+    const found = TIMELINE_OUTPUT_FORMATS.find((f) => f === value);
+    if (!found) {
+        throw new Error(`Unknown render format "${raw}". Choose one of: ` +
+            `${TIMELINE_OUTPUT_FORMATS.join(", ")}.`);
+    }
+    return found;
+}
+/**
+ * Resolve a format request into the container, encoder and pixel format that
+ * carry it. Throws {@link AlphaFormatError} when the pair cannot exist.
+ *
+ * ProRes 4444 is the alpha-carrying profile (`-profile:v 4444`); without alpha
+ * the render drops to 422 HQ, which is half the data for the same picture.
+ * VP9 is the only WebM video codec with an alpha plane, so `webm` pins it
+ * rather than taking a `videoCodec` override that would silently lose alpha.
+ */
+/**
+ * Convert to BT.709 and say so in the file.
+ *
+ * The compositor hands ffmpeg sRGB RGBA. Told only a `-pix_fmt`, ffmpeg picks
+ * the BT.601 matrix (its default for an untagged input) and writes no colour
+ * metadata, so a player that assumes BT.709 for HD — which is every player —
+ * shows greens and reds that are not the ones the editor previewed. The scaler
+ * does the conversion; the three tags record it, since an untagged file is
+ * guessed at all over again by the next tool that reads it. Limited range is
+ * what a YUV video carries and what a player expects.
+ */
+const BT709_ARGS = [
+    "-vf",
+    "scale=out_color_matrix=bt709:out_range=tv",
+    "-colorspace",
+    "bt709",
+    "-color_primaries",
+    "bt709",
+    "-color_trc",
+    "bt709"
+];
+export function resolveTimelineOutput(request = {}) {
+    const format = parseOutputFormat(request.format);
+    const alpha = request.alpha === true;
+    const motionBlur = resolveMotionBlur({
+        samplesPerFrame: request.motionBlurSamples ?? undefined,
+        shutterAngle: request.shutterAngle ?? undefined
+    });
+    if (alpha && !ALPHA_OUTPUT_FORMATS.includes(format)) {
+        throw new AlphaFormatError(format);
+    }
+    const bitrateArgs = typeof request.bitrate === "number" && request.bitrate > 0
+        ? ["-b:v", String(Math.round(request.bitrate))]
+        : [];
+    const override = request.videoCodec?.trim();
+    if (format === "png_sequence") {
+        return {
+            format,
+            alpha,
+            motionBlur,
+            extension: "zip",
+            mimeType: "application/zip",
+            encoderArgs: [],
+            requiredEncoder: null,
+            audioCodec: null
+        };
+    }
+    if (format === "webm") {
+        return {
+            format,
+            alpha,
+            motionBlur,
+            extension: "webm",
+            mimeType: "video/webm",
+            encoderArgs: [
+                "-c:v",
+                "libvpx-vp9",
+                "-pix_fmt",
+                alpha ? "yuva420p" : "yuv420p",
+                ...BT709_ARGS,
+                ...bitrateArgs
+            ],
+            requiredEncoder: "libvpx-vp9",
+            // WebM carries Opus and Vorbis; AAC is not a legal Matroska/WebM track.
+            audioCodec: "libopus"
+        };
+    }
+    if (format === "mov") {
+        return {
+            format,
+            alpha,
+            motionBlur,
+            extension: "mov",
+            mimeType: "video/quicktime",
+            encoderArgs: [
+                "-c:v",
+                "prores_ks",
+                "-profile:v",
+                alpha ? "4444" : "3",
+                "-pix_fmt",
+                alpha ? "yuva444p10le" : "yuv422p10le",
+                ...BT709_ARGS,
+                ...bitrateArgs
+            ],
+            requiredEncoder: "prores_ks",
+            audioCodec: "aac"
+        };
+    }
+    const codec = override && override.length > 0 ? override : "libx264";
+    return {
+        format,
+        alpha: false,
+        motionBlur,
+        extension: "mp4",
+        mimeType: "video/mp4",
+        encoderArgs: [
+            "-c:v",
+            codec,
+            ...(codec === "libx264" ? ["-preset", "veryfast"] : []),
+            "-pix_fmt",
+            "yuv420p",
+            ...BT709_ARGS,
+            ...bitrateArgs
+        ],
+        requiredEncoder: codec,
+        audioCodec: "aac"
+    };
+}
+//# sourceMappingURL=outputFormats.js.map

package/dist/nodes/timeline/outputFormats.js.map

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

package/dist/nodes/timeline/pngSequence.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The `png_sequence` output: one PNG per composited frame, streamed into a
+ * single zip alongside a `manifest.json`.
+ *
+ * PNG is the only format here that carries straight alpha with no chroma
+ * subsampling, which is what makes it the reference an alpha render is checked
+ * against. The frames go through `@napi-rs/canvas` rather than ffmpeg — the
+ * compositor already hands over RGBA8, so an ffmpeg round trip would only add a
+ * process per frame and a second colour conversion.
+ *
+ * The zip is written entry by entry with no compression: a PNG is already
+ * deflate-compressed, so a second pass costs CPU and saves nothing. Writing as
+ * it goes is what keeps a thousand-frame render off the heap — only the frame
+ * being encoded is in memory.
+ */
+import type { FrameEncoder } from "./rawFrames.js";
+/** What a reader needs to turn the entries back into a sequence. */
+export interface PngSequenceManifest {
+    format: "png_sequence";
+    fps: number;
+    width: number;
+    height: number;
+    /** Frames written, which is also the number of `frame_*.png` entries. */
+    count: number;
+    /** Whether the frames carry a transparency channel. */
+    alpha: boolean;
+    /** `printf`-style pattern of the entry names, for ffmpeg's image2 demuxer. */
+    pattern: string;
+}
+/** Encode straight-alpha RGBA8 pixels as PNG bytes. */
+export declare function encodeRgbaPng(rgba: Uint8Array, width: number, height: number): Buffer;
+/**
+ * Open a {@link FrameEncoder} that writes each frame as a PNG into the zip at
+ * `outPath`, and closes with a `manifest.json` naming the rate, the size and
+ * the frame count.
+ */
+export declare function openPngSequenceEncoder(opts: {
+    outPath: string;
+    width: number;
+    height: number;
+    fps: number;
+    alpha: boolean;
+}): FrameEncoder;
+//# sourceMappingURL=pngSequence.d.ts.map

package/dist/nodes/timeline/pngSequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pngSequence.d.ts","sourceRoot":"","sources":["../../../src/nodes/timeline/pngSequence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAeR;AA2HD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CAkCf"}

package/dist/nodes/timeline/pngSequence.js

@@ -0,0 +1,172 @@
+/**
+ * The `png_sequence` output: one PNG per composited frame, streamed into a
+ * single zip alongside a `manifest.json`.
+ *
+ * PNG is the only format here that carries straight alpha with no chroma
+ * subsampling, which is what makes it the reference an alpha render is checked
+ * against. The frames go through `@napi-rs/canvas` rather than ffmpeg — the
+ * compositor already hands over RGBA8, so an ffmpeg round trip would only add a
+ * process per frame and a second colour conversion.
+ *
+ * The zip is written entry by entry with no compression: a PNG is already
+ * deflate-compressed, so a second pass costs CPU and saves nothing. Writing as
+ * it goes is what keeps a thousand-frame render off the heap — only the frame
+ * being encoded is in memory.
+ */
+import { createCanvas } from "@napi-rs/canvas";
+import { createWriteStream } from "node:fs";
+import { crc32 } from "node:zlib";
+/** Encode straight-alpha RGBA8 pixels as PNG bytes. */
+export function encodeRgbaPng(rgba, width, height) {
+    const expected = width * height * 4;
+    if (rgba.length < expected) {
+        throw new Error(`PNG encode got ${rgba.length} bytes for a ${width}x${height} frame (expected ${expected})`);
+    }
+    const canvas = createCanvas(width, height);
+    const ctx = canvas.getContext("2d");
+    const image = ctx.createImageData(width, height);
+    image.data.set(rgba.subarray(0, expected));
+    // `putImageData` is defined on straight alpha and bypasses compositing, so
+    // the pixels land exactly as the compositor un-premultiplied them.
+    ctx.putImageData(image, 0, 0);
+    return canvas.toBuffer("image/png");
+}
+/** Six-digit frame name, so the entries sort the way they play. */
+function frameName(index) {
+    return `frame_${String(index + 1).padStart(6, "0")}.png`;
+}
+/**
+ * Store-only zip writer.
+ *
+ * Stored entries need the CRC and the size before the data, and both are known
+ * per frame, so nothing has to be buffered to the end but the central
+ * directory. ZIP64 is not implemented: an archive that would cross 4 GiB is
+ * refused by name rather than written with truncated offsets that no reader
+ * would open.
+ */
+const ZIP_MAX_BYTES = 0xffffffff;
+class StoredZipWriter {
+    stream;
+    entries = [];
+    offset = 0;
+    pending = Promise.resolve();
+    constructor(stream) {
+        this.stream = stream;
+    }
+    add(name, data) {
+        const nameBytes = Buffer.from(name, "utf8");
+        const entry = {
+            name: nameBytes,
+            crc: crc32(data),
+            size: data.length,
+            offset: this.offset
+        };
+        const header = Buffer.alloc(30 + nameBytes.length);
+        header.writeUInt32LE(0x04034b50, 0);
+        header.writeUInt16LE(20, 4); // version needed
+        header.writeUInt16LE(0, 6); // flags
+        header.writeUInt16LE(0, 8); // method: stored
+        header.writeUInt16LE(0, 10); // mod time
+        header.writeUInt16LE(0x0021, 12); // mod date: 1980-01-01, a fixed stamp
+        header.writeUInt32LE(entry.crc, 14);
+        header.writeUInt32LE(entry.size, 18);
+        header.writeUInt32LE(entry.size, 22);
+        header.writeUInt16LE(nameBytes.length, 26);
+        header.writeUInt16LE(0, 28); // extra length
+        nameBytes.copy(header, 30);
+        this.write(header);
+        this.write(data);
+        this.offset += header.length + data.length;
+        if (this.offset > ZIP_MAX_BYTES) {
+            throw new Error("The PNG sequence exceeds the 4 GiB a zip archive can address. " +
+                "Render a shorter range, a smaller frame, or a video format.");
+        }
+        this.entries.push(entry);
+    }
+    async finish() {
+        const parts = [];
+        for (const entry of this.entries) {
+            const record = Buffer.alloc(46 + entry.name.length);
+            record.writeUInt32LE(0x02014b50, 0);
+            record.writeUInt16LE(20, 4); // version made by
+            record.writeUInt16LE(20, 6); // version needed
+            record.writeUInt16LE(0, 8);
+            record.writeUInt16LE(0, 10);
+            record.writeUInt16LE(0, 12);
+            record.writeUInt16LE(0x0021, 14);
+            record.writeUInt32LE(entry.crc, 16);
+            record.writeUInt32LE(entry.size, 20);
+            record.writeUInt32LE(entry.size, 24);
+            record.writeUInt16LE(entry.name.length, 28);
+            record.writeUInt16LE(0, 30); // extra
+            record.writeUInt16LE(0, 32); // comment
+            record.writeUInt16LE(0, 34); // disk
+            record.writeUInt16LE(0, 36); // internal attrs
+            record.writeUInt32LE(0, 38); // external attrs
+            record.writeUInt32LE(entry.offset, 42);
+            entry.name.copy(record, 46);
+            parts.push(record);
+        }
+        const central = Buffer.concat(parts);
+        const end = Buffer.alloc(22);
+        end.writeUInt32LE(0x06054b50, 0);
+        end.writeUInt16LE(0, 4);
+        end.writeUInt16LE(0, 6);
+        end.writeUInt16LE(this.entries.length, 8);
+        end.writeUInt16LE(this.entries.length, 10);
+        end.writeUInt32LE(central.length, 12);
+        end.writeUInt32LE(this.offset, 16);
+        end.writeUInt16LE(0, 20);
+        this.write(central);
+        this.write(end);
+        await this.pending;
+        await new Promise((resolve, reject) => {
+            this.stream.end(() => resolve());
+            this.stream.once("error", reject);
+        });
+    }
+    /** Queue a chunk, keeping the backpressure wait off the caller's hot path. */
+    write(chunk) {
+        this.pending = this.pending.then(() => new Promise((resolve, reject) => {
+            this.stream.write(chunk, (error) => error ? reject(error) : resolve());
+        }));
+    }
+}
+/**
+ * Open a {@link FrameEncoder} that writes each frame as a PNG into the zip at
+ * `outPath`, and closes with a `manifest.json` naming the rate, the size and
+ * the frame count.
+ */
+export function openPngSequenceEncoder(opts) {
+    const { outPath, width, height, fps, alpha } = opts;
+    const stream = createWriteStream(outPath);
+    const zip = new StoredZipWriter(stream);
+    let count = 0;
+    let aborted = false;
+    return {
+        async write(rgba) {
+            if (aborted)
+                return;
+            zip.add(frameName(count), encodeRgbaPng(rgba, width, height));
+            count += 1;
+        },
+        async finish() {
+            const manifest = {
+                format: "png_sequence",
+                fps,
+                width,
+                height,
+                count,
+                alpha,
+                pattern: "frame_%06d.png"
+            };
+            zip.add("manifest.json", Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`, "utf8"));
+            await zip.finish();
+        },
+        abort() {
+            aborted = true;
+            stream.destroy();
+        }
+    };
+}
+//# sourceMappingURL=pngSequence.js.map

package/dist/nodes/timeline/pngSequence.js.map

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

package/dist/nodes/timeline/rasterizers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Server-side rasterization of the layer kinds that have no media behind them:
+ * captions, text clips and shapes.
+ *
+ * The drawing rules come from `@nodetool-ai/timeline/render` — the same ones
+ * the editor's preview and its in-browser export use — applied to a
+ * `@napi-rs/canvas` surface instead of an `OffscreenCanvas`. Output is
+ * straight-alpha RGBA at frame resolution, ready to hand to the compositor.
+ *
+ * The bundled faces are registered here, with the same library and the same
+ * files the agent's frame preview registers, so a title renders identically on
+ * both Node hosts (D8).
+ */
+import type { ClipMask, ClipShapeStyle, ClipTextStyle } from "@nodetool-ai/timeline";
+import type { ResolvedCaption, TextRenderStagger } from "@nodetool-ai/timeline/render";
+import type { RawImage } from "./rawFrames.js";
+/** A rasterized layer plus the signature that identifies its pixels. */
+interface RasterResult extends RawImage {
+    /** Changes exactly when the pixels do — the compositor's upload key. */
+    version: string;
+}
+/**
+ * Draws through the shared rules and caches by content signature, so a title
+ * that holds still for 300 frames is rasterized once.
+ */
+export declare class NodeRasterizer {
+    private readonly width;
+    private readonly height;
+    private readonly cache;
+    constructor(width: number, height: number);
+    caption(caption: ResolvedCaption): RasterResult | null;
+    /**
+     * A clip mask's coverage, at the size of the layer it cuts rather than the
+     * frame — the mask is authored in the layer's own normalized space, and the
+     * GPU compositor applies it to the source texture before placing it.
+     *
+     * Null when the mask names a kind this build cannot rasterize or path data
+     * that does not parse; the layer then draws unmasked and the validator
+     * reports `mask_path_invalid`.
+     */
+    mask(mask: ClipMask, width: number, height: number): RasterResult | null;
+    shape(style: ClipShapeStyle): RasterResult | null;
+    text(style: ClipTextStyle, stagger?: TextRenderStagger | null): RasterResult | null;
+    private render;
+}
+export {};
+//# sourceMappingURL=rasterizers.d.ts.map

package/dist/nodes/timeline/rasterizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterizers.d.ts","sourceRoot":"","sources":["../../../src/nodes/timeline/rasterizers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,eAAe,EACf,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AAetC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,wEAAwE;AACxE,UAAU,YAAa,SAAQ,QAAQ;IACrC,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAEzD,YACmB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAMhC;IAED,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI,CAMrD;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAYvE;IAED,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAKhD;IAED,IAAI,CACF,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACjC,YAAY,GAAG,IAAI,CA4BrB;IAED,OAAO,CAAC,MAAM;CA+Bf"}

package/dist/nodes/timeline/rasterizers.js

@@ -0,0 +1,103 @@
+/**
+ * Server-side rasterization of the layer kinds that have no media behind them:
+ * captions, text clips and shapes.
+ *
+ * The drawing rules come from `@nodetool-ai/timeline/render` — the same ones
+ * the editor's preview and its in-browser export use — applied to a
+ * `@napi-rs/canvas` surface instead of an `OffscreenCanvas`. Output is
+ * straight-alpha RGBA at frame resolution, ready to hand to the compositor.
+ *
+ * The bundled faces are registered here, with the same library and the same
+ * files the agent's frame preview registers, so a title renders identically on
+ * both Node hosts (D8).
+ */
+import { createCanvas } from "@napi-rs/canvas";
+import { registerBundledFonts } from "@nodetool-ai/timeline/fonts/node";
+import { captionSignature, createStaggerScratch, drawCaption, drawMask, drawShape, drawStaggeredText, drawText, maskSignature, shapeStyleSignature, staggerPhase, textStyleSignature } from "@nodetool-ai/timeline/render";
+const MAX_CACHE_ENTRIES = 32;
+/**
+ * Draws through the shared rules and caches by content signature, so a title
+ * that holds still for 300 frames is rasterized once.
+ */
+export class NodeRasterizer {
+    width;
+    height;
+    cache = new Map();
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+        // Before any glyph is drawn, and once per process. A render whose fonts
+        // are registered later bakes the fallback face into the frames already
+        // encoded, which no re-render of the tail can undo.
+        registerBundledFonts();
+    }
+    caption(caption) {
+        if (caption.words.length === 0)
+            return null;
+        return this.render(`caption|${captionSignature(caption, this.width, this.height)}`, (ctx) => drawCaption(ctx, caption, this.width, this.height));
+    }
+    /**
+     * A clip mask's coverage, at the size of the layer it cuts rather than the
+     * frame — the mask is authored in the layer's own normalized space, and the
+     * GPU compositor applies it to the source texture before placing it.
+     *
+     * Null when the mask names a kind this build cannot rasterize or path data
+     * that does not parse; the layer then draws unmasked and the validator
+     * reports `mask_path_invalid`.
+     */
+    mask(mask, width, height) {
+        let painted = true;
+        const result = this.render(`mask|${maskSignature(mask, width, height)}`, (ctx) => {
+            painted = drawMask(ctx, mask, width, height);
+        }, true, width, height);
+        return painted ? result : null;
+    }
+    shape(style) {
+        return this.render(`shape|${shapeStyleSignature(style, this.width, this.height)}`, (ctx) => drawShape(ctx, style, this.width, this.height));
+    }
+    text(style, stagger) {
+        if (!style.text)
+            return null;
+        const base = `text|${textStyleSignature(style, this.width, this.height)}`;
+        if (!stagger) {
+            return this.render(base, (ctx) => drawText(ctx, style, this.width, this.height));
+        }
+        const phase = staggerPhase(stagger);
+        // Mid-stagger the raster changes every frame, so it is keyed by time and
+        // never reused; a held frame outside the animation window caches by phase.
+        const key = phase === "active"
+            ? `${base}|stg:${stagger.localMs}`
+            : `${base}|stg:${phase}`;
+        return this.render(key, (ctx) => drawStaggeredText(ctx, style, this.width, this.height, stagger, createStaggerScratch()), phase !== "active");
+    }
+    render(key, draw, cacheable = true, atWidth = this.width, atHeight = this.height) {
+        if (atWidth <= 0 || atHeight <= 0)
+            return null;
+        if (cacheable) {
+            const hit = this.cache.get(key);
+            if (hit)
+                return hit;
+        }
+        const canvas = createCanvas(atWidth, atHeight);
+        const ctx = canvas.getContext("2d");
+        // SAFETY: `RasterContext2D` is the subset of the 2D canvas API the
+        // drawing helpers use, and a skia canvas context provides all of it.
+        draw(ctx);
+        const result = {
+            rgba: new Uint8Array(ctx.getImageData(0, 0, atWidth, atHeight).data),
+            width: atWidth,
+            height: atHeight,
+            version: key
+        };
+        if (!cacheable)
+            return result;
+        if (this.cache.size >= MAX_CACHE_ENTRIES) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined)
+                this.cache.delete(oldest);
+        }
+        this.cache.set(key, result);
+        return result;
+    }
+}
+//# sourceMappingURL=rasterizers.js.map