@nodetool-ai/blender-nodes 0.8.1

package/dist/bake.js

@@ -0,0 +1,209 @@
+/**
+ * The timeline's 3D bake: a sampled Blender render muxed into one video
+ * (design §D6).
+ *
+ * The caller hands over one model time and one camera per output frame — the
+ * evaluated clip, with its in point, speed, time remap, animation speed and
+ * camera curves already applied — and gets back an MP4 the clip can play as
+ * an ordinary video layer. Blender renders a still per entry rather than a
+ * frame range, because a trimmed, sped-up, reversed or looped clip is not a
+ * run of consecutive scene frames.
+ *
+ * The mux is ffmpeg and not Blender's own writer, which is what
+ * `render_animation`'s video mode uses. Two reasons: one sequence feeds both
+ * bake formats, and Blender cannot write VP9 with an alpha channel. ffmpeg is
+ * therefore a host binary this path needs and the video mode does not; a
+ * machine without it fails here with the binary named.
+ */
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { runHostBinary } from "@nodetool-ai/runtime";
+import { runBlenderJob } from "./run-job.js";
+import { BlenderJobError } from "./runner.js";
+/**
+ * Ceiling on the frames one bake asks for. Every frame is a declared output
+ * the runner reads into memory, so this is the bound on that, not a limit on
+ * clip length in the abstract: two minutes at 30 fps.
+ */
+export const MAX_BAKE_FRAMES = 3600;
+/**
+ * How a bake is encoded: opaque to MP4/H.264 `yuv420p`, transparent to WebM
+ * VP9 `yuva420p` (design §D6).
+ *
+ * The alpha pair is the one `resolveTimelineOutput({ format: "webm", alpha:
+ * true })` already declares for a timeline render, copied rather than imported
+ * because `@nodetool-ai/blender-nodes` does not depend on
+ * `@nodetool-ai/video-nodes` and a bake needs four strings from it, not a
+ * package. `packages/agents/tests/timeline-bake-format.test.ts` depends on both
+ * and fails when the two drift.
+ */
+export function bakeVideoFormat(alpha) {
+    if (alpha) {
+        return {
+            extension: "webm",
+            mimeType: "video/webm",
+            // VP9 is the only WebM video codec with an alpha plane, which is why the
+            // format pins the codec instead of taking an override.
+            encoderArgs: ["-c:v", "libvpx-vp9", "-pix_fmt", "yuva420p"]
+        };
+    }
+    return {
+        extension: "mp4",
+        mimeType: "video/mp4",
+        encoderArgs: ["-c:v", "libx264", "-pix_fmt", "yuv420p"]
+    };
+}
+/** Six-digit frame names, so the outputs sort the way they play. */
+function frameName(index) {
+    return `frame_${String(index + 1).padStart(6, "0")}`;
+}
+/**
+ * The `frame_*` outputs a sampled job declares: one per entry, in play order.
+ * The op writes the file each name carries and reports the names back.
+ */
+export function bakeFrameOutputs(count) {
+    const outputs = {};
+    for (let i = 0; i < count; i += 1) {
+        outputs[frameName(i)] = `${frameName(i)}.png`;
+    }
+    return outputs;
+}
+function assertRequest(request) {
+    const count = request.frameTimes.length;
+    if (count === 0) {
+        throw new BlenderJobError("bad_job", "A 3D bake needs at least one frame; the clip resolved to none.");
+    }
+    if (count > MAX_BAKE_FRAMES) {
+        throw new BlenderJobError("bad_job", `A 3D bake of ${count} frames is above the ${MAX_BAKE_FRAMES}-frame cap. ` +
+            `Shorten the clip or lower the sequence fps.`);
+    }
+    if (request.cameras.length !== count) {
+        throw new BlenderJobError("bad_job", `A 3D bake carries ${request.cameras.length} cameras for ${count} frames.`);
+    }
+}
+/** The sampled `render_animation` params for one bake. */
+export function bakeRenderAnimationParams(request) {
+    const first = request.cameras[0];
+    if (!first) {
+        throw new BlenderJobError("bad_job", "A 3D bake carries no camera.");
+    }
+    const params = {
+        ...first,
+        width: Math.max(1, Math.round(request.width)),
+        height: Math.max(1, Math.round(request.height)),
+        // The sampled path renders stills and never reads the range, but the
+        // runner's progress arithmetic does: `Fra:n` counts entries, so the range
+        // is the entry count.
+        frame_start: 1,
+        frame_end: request.frameTimes.length,
+        fps: Math.max(1, Math.round(request.fps)),
+        orbit_degrees: 0,
+        frame_times: [...request.frameTimes],
+        cameras: [...request.cameras]
+    };
+    if (request.animationName !== undefined) {
+        params.animation_name = request.animationName;
+    }
+    return params;
+}
+/** Render the sequence. Frames come back in play order. */
+export async function renderModel3DBakeFrames(context, modelBytes, request, options) {
+    assertRequest(request);
+    const count = request.frameTimes.length;
+    const outputs = bakeFrameOutputs(count);
+    const result = await runBlenderJob(context, modelBytes, { op: "render_animation", params: bakeRenderAnimationParams(request) }, outputs, {
+        timeoutMs: options.timeoutMs,
+        signal: options.signal,
+        onProgress: options.onProgress,
+        // Every frame is one declared output, so the default ceiling on
+        // declared outputs is the ceiling on a bake's length. The frame cap
+        // above is the bound that matters here.
+        maxOutputCount: MAX_BAKE_FRAMES
+    });
+    const frames = [];
+    for (let i = 0; i < count; i += 1) {
+        const bytes = result.outputs[frameName(i)];
+        if (!bytes || bytes.length === 0) {
+            throw new BlenderJobError("missing_output", `Blender produced no pixels for bake frame ${i + 1} of ${count}.`);
+        }
+        frames.push(bytes);
+    }
+    return { frames, stats: result.stats };
+}
+/**
+ * The ffmpeg call that turns the numbered PNGs into one video.
+ *
+ * Pure, because the arguments are the whole difference between the two bakes
+ * and a test should not need ffmpeg to read them.
+ */
+export function bakeMuxArgs(format, fps, output) {
+    const rate = String(Math.max(1, Math.round(fps)));
+    return [
+        "-y",
+        "-framerate",
+        rate,
+        "-start_number",
+        "1",
+        "-i",
+        "frame_%06d.png",
+        ...format.encoderArgs,
+        // Every timeline decoder seeks this video, and a seek lands on the
+        // preceding keyframe: one per second keeps a scrub inside a frame or two
+        // of where it was asked for.
+        "-g",
+        rate,
+        // MP4 keeps its index at the front so a decoder can seek before the whole
+        // file has arrived; WebM has no such flag and needs none.
+        ...(format.extension === "mp4" ? ["-movflags", "+faststart"] : []),
+        output
+    ];
+}
+/**
+ * Mux a PNG sequence into one video through ffmpeg's image2 demuxer.
+ *
+ * The frames are written under the workspace's scratch directory rather than
+ * piped: image2 reads a numbered pattern, and the same files reach either
+ * encoder unchanged — an alpha bake differs only in the arguments
+ * {@link bakeVideoFormat} names, because the PNGs already carry the channel.
+ */
+export async function muxPngSequenceToVideo(context, frames, fps, format, options) {
+    const workspace = context.workspace;
+    if (!workspace) {
+        throw new BlenderJobError("bad_job", "A 3D bake needs a processing context with a workspace to mux through.");
+    }
+    const cwd = await mkdtemp(path.join(await workspace.scratchDir(), "nodetool-bake-"));
+    try {
+        for (const [index, bytes] of frames.entries()) {
+            await writeFile(path.join(cwd, `${frameName(index)}.png`), bytes);
+        }
+        const output = `bake.${format.extension}`;
+        const argv = bakeMuxArgs(format, fps, output);
+        const result = await runHostBinary("ffmpeg", argv, {
+            cwd,
+            timeoutMs: options.timeoutMs,
+            signal: options.signal,
+            artifactPath: output
+        });
+        if (result.exitCode !== 0) {
+            throw new BlenderJobError("render_failed", `ffmpeg could not mux the bake (exit ${result.exitCode}): ${result.stderr.slice(-2000)}`);
+        }
+        return new Uint8Array(await readFile(path.join(cwd, output)));
+    }
+    finally {
+        await rm(cwd, { recursive: true, force: true });
+    }
+}
+/**
+ * Render the sampled sequence and mux it: the whole bake (§D6).
+ *
+ * Whether it carries alpha is read off the frames' own camera rather than
+ * taken as a second field: `transparent` is what Blender rendered the film
+ * under, so a separate flag could only ever disagree with the pixels.
+ */
+export async function bakeModel3DClipToVideo(context, modelBytes, request, options) {
+    const format = bakeVideoFormat(request.cameras[0]?.transparent === true);
+    const { frames, stats } = await renderModel3DBakeFrames(context, modelBytes, request, options);
+    const video = await muxPngSequenceToVideo(context, frames, request.fps, format, options);
+    return { video, format, stats };
+}
+//# sourceMappingURL=bake.js.map

package/dist/bake.js.map

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

package/dist/blender-binary.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Blender executable discovery (D3).
+ *
+ * Order: `BLENDER_PATH`, then `blender` on PATH, then the well-known
+ * locations for macOS, Linux, and Windows. The first candidate whose
+ * `--version` runs wins. Below the 5.2 floor throws `BlenderVersionError`
+ * naming both versions; nothing found throws `HostBinaryMissingError`.
+ *
+ * The result is cached per process and invalidated when `BLENDER_PATH`
+ * changes, so tests pointing `BLENDER_PATH` at a fake re-resolve.
+ */
+/**
+ * Minimum supported Blender version: 5.2 LTS. The ops use
+ * `scene.compositing_node_group` and `image_settings.media_type`, neither of
+ * which exists on 4.2, so the 4.2 floor the design first named was never
+ * runnable. See the Revision note under A1 in
+ * `docs/blender-headless-integration-design.md`.
+ */
+export declare const BLENDER_MIN_VERSION: readonly [number, number, number];
+export interface BlenderBinary {
+    path: string;
+    version: [number, number, number];
+}
+export declare class BlenderVersionError extends Error {
+    readonly found: string;
+    readonly minimum: string;
+    constructor(found: string);
+}
+/**
+ * Resolve the Blender executable per D3. Cached per process; the cache is
+ * invalidated when `BLENDER_PATH` changes.
+ */
+export declare function resolveBlenderBinary(options?: {
+    configuredPath?: string | null;
+}): Promise<BlenderBinary>;
+/** Forget the cached resolution. Tests use this after mutating the environment. */
+export declare function resetBlenderBinaryCache(): void;
+//# sourceMappingURL=blender-binary.d.ts.map

package/dist/blender-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blender-binary.d.ts","sourceRoot":"","sources":["../src/blender-binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAa,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,YAAY,KAAK,EAAE,MAAM,EASxB;CACF;AAoHD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAClD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,OAAO,CAAC,aAAa,CAAC,CAoB9B;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/blender-binary.js

@@ -0,0 +1,169 @@
+/**
+ * Blender executable discovery (D3).
+ *
+ * Order: `BLENDER_PATH`, then `blender` on PATH, then the well-known
+ * locations for macOS, Linux, and Windows. The first candidate whose
+ * `--version` runs wins. Below the 5.2 floor throws `BlenderVersionError`
+ * naming both versions; nothing found throws `HostBinaryMissingError`.
+ *
+ * The result is cached per process and invalidated when `BLENDER_PATH`
+ * changes, so tests pointing `BLENDER_PATH` at a fake re-resolve.
+ */
+import { execFile } from "node:child_process";
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { HostBinaryMissingError } from "@nodetool-ai/runtime";
+const execFileAsync = promisify(execFile);
+/**
+ * Minimum supported Blender version: 5.2 LTS. The ops use
+ * `scene.compositing_node_group` and `image_settings.media_type`, neither of
+ * which exists on 4.2, so the 4.2 floor the design first named was never
+ * runnable. See the Revision note under A1 in
+ * `docs/blender-headless-integration-design.md`.
+ */
+export const BLENDER_MIN_VERSION = [5, 2, 0];
+export class BlenderVersionError extends Error {
+    found;
+    minimum;
+    constructor(found) {
+        const minimum = BLENDER_MIN_VERSION.join(".");
+        super(`Blender ${found} is too old: NodeTool needs Blender ${minimum} or newer. ` +
+            `Install a newer Blender or point BLENDER_PATH at one.`);
+        this.name = "BlenderVersionError";
+        this.found = found;
+        this.minimum = minimum;
+    }
+}
+function isAtLeast(version, floor) {
+    for (let i = 0; i < 3; i++) {
+        if (version[i] > floor[i])
+            return true;
+        if (version[i] < floor[i])
+            return false;
+    }
+    return true;
+}
+function parseVersion(output) {
+    const match = /Blender\s+(\d+)\.(\d+)\.(\d+)/.exec(output);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+async function probe(candidate) {
+    try {
+        const { stdout, stderr } = await execFileAsync(candidate, ["--version"], {
+            timeout: 15000,
+            windowsHide: true
+        });
+        const version = parseVersion(`${stdout}\n${stderr}`);
+        if (!version) {
+            return {
+                binary: null,
+                failure: {
+                    candidate,
+                    detail: firstLine(`${stdout}\n${stderr}`)
+                }
+            };
+        }
+        return { binary: { path: candidate, version }, failure: null };
+    }
+    catch (err) {
+        return {
+            binary: null,
+            failure: {
+                candidate,
+                detail: firstLine(err instanceof Error ? (err.message ?? String(err)) : String(err))
+            }
+        };
+    }
+}
+function firstLine(text) {
+    const line = text.split("\n", 1)[0] ?? "";
+    return line.length > 200 ? `${line.slice(0, 200)}…` : line;
+}
+async function windowsCandidates() {
+    const roots = [
+        process.env["ProgramFiles"],
+        process.env["ProgramFiles(x86)"]
+    ].filter((root) => root !== undefined && root !== "");
+    const found = [];
+    for (const root of roots) {
+        const base = path.join(root, "Blender Foundation");
+        let entries;
+        try {
+            entries = await readdir(base);
+        }
+        catch {
+            // No Blender install under this root.
+            continue;
+        }
+        for (const entry of entries.sort().reverse()) {
+            if (!entry.startsWith("Blender"))
+                continue;
+            found.push(path.join(base, entry, "blender.exe"));
+        }
+    }
+    return found;
+}
+async function candidates() {
+    const list = [];
+    const envPath = process.env["BLENDER_PATH"];
+    if (envPath !== undefined && envPath !== "")
+        list.push(envPath);
+    list.push("blender");
+    if (process.platform === "darwin") {
+        list.push("/Applications/Blender.app/Contents/MacOS/Blender");
+    }
+    else if (process.platform === "win32") {
+        list.push(...(await windowsCandidates()));
+    }
+    else {
+        list.push("/usr/bin/blender", "/snap/bin/blender");
+    }
+    return list;
+}
+let cached = null;
+function missingError(failures, configuredPath) {
+    const err = new HostBinaryMissingError("blender");
+    const envPath = process.env["BLENDER_PATH"];
+    const probeNote = failures
+        .filter((f) => f.candidate === envPath || f.candidate === configuredPath)
+        .map((f) => ` BLENDER_PATH=${JSON.stringify(f.candidate)} failed: ${f.detail}`)
+        .join("");
+    err.message =
+        `blender was not found. Install Blender 5.2 or newer and add it to PATH, ` +
+            `or set BLENDER_PATH to the Blender executable.${probeNote}`;
+    return err;
+}
+/**
+ * Resolve the Blender executable per D3. Cached per process; the cache is
+ * invalidated when `BLENDER_PATH` changes.
+ */
+export async function resolveBlenderBinary(options = {}) {
+    const blenderPathEnv = options.configuredPath ?? process.env["BLENDER_PATH"];
+    if (cached && cached.blenderPathEnv === blenderPathEnv)
+        return cached.binary;
+    const failures = [];
+    const candidateList = options.configuredPath
+        ? [options.configuredPath, ...(await candidates())]
+        : await candidates();
+    for (const candidate of candidateList) {
+        const { binary, failure } = await probe(candidate);
+        if (binary) {
+            if (!isAtLeast(binary.version, BLENDER_MIN_VERSION)) {
+                throw new BlenderVersionError(binary.version.join("."));
+            }
+            cached = { blenderPathEnv, binary };
+            return binary;
+        }
+        if (failure)
+            failures.push(failure);
+    }
+    throw missingError(failures, options.configuredPath);
+}
+/** Forget the cached resolution. Tests use this after mutating the environment. */
+export function resetBlenderBinaryCache() {
+    cached = null;
+}
+//# sourceMappingURL=blender-binary.js.map

package/dist/blender-binary.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@nodetool-ai/blender-nodes` — Blender headless integration (Stage 3).
+ *
+ * Binary discovery, the versioned job contract, the runner interface with
+ * its local implementation, the thin `runBlenderJob` entry point, and the
+ * `nodetool.blender.*` nodes. `BLENDER_NODES` is registered in
+ * `@nodetool-ai/base-nodes` alongside the other node arrays.
+ */
+export { BLENDER_RENDER_NODES } from "./nodes/render-image.js";
+export { RenderImageNode } from "./nodes/render-image.js";
+export { BLENDER_PASSES_NODES } from "./nodes/render-passes.js";
+export { RenderPassesNode } from "./nodes/render-passes.js";
+export { BLENDER_ANIMATION_NODES } from "./nodes/render-animation.js";
+export { BLENDER_BAKE_NODES } from "./nodes/bake-timeline-clip.js";
+export { BakeTimelineClipNode } from "./nodes/bake-timeline-clip.js";
+export { RenderAnimationNode } from "./nodes/render-animation.js";
+export { BLENDER_PREPARE_NODES } from "./nodes/prepare-for-engine.js";
+export { PrepareForEngineNode } from "./nodes/prepare-for-engine.js";
+export { BLENDER_EXPORT_NODES } from "./nodes/export-model.js";
+export { ExportModelNode } from "./nodes/export-model.js";
+export type { BlenderBinary } from "./blender-binary.js";
+export { BlenderVersionError, resolveBlenderBinary, resetBlenderBinaryCache, BLENDER_MIN_VERSION } from "./blender-binary.js";
+export { BLENDER_JOB_VERSION, jobFileNameSchema, blenderResultSchema } from "./job.js";
+export type { BakeCameraParams, BakeMode, BlenderEngine, BlenderJob, BlenderOp, BlenderResult, BlenderResultStats, CameraMode, CameraParams, DepthFormat, ExportFormat, ExportModelParams, LightingPreset, PrepareForEngineParams, RenderAnimationParams, RenderImageParams, RenderPass, RenderPassesParams } from "./job.js";
+export { BlenderJobError, LocalBlenderRunner, WorkerBlenderRunner, resolveOpScriptDir, MAX_OUTPUT_BYTES, MAX_TOTAL_OUTPUT_BYTES, MAX_OUTPUT_COUNT } from "./runner.js";
+export type { BlenderJobErrorCode, WorkerBlenderRunnerOptions, BlenderRunner, BlenderRunOptions, BlenderRunResult } from "./runner.js";
+export { bakeFrameOutputs, bakeModel3DClipToVideo, bakeMuxArgs, bakeRenderAnimationParams, bakeVideoFormat, muxPngSequenceToVideo, renderModel3DBakeFrames, MAX_BAKE_FRAMES } from "./bake.js";
+export type { BakeVideoFormat, Model3DBakeOptions, Model3DBakeRequest, Model3DBakeResult } from "./bake.js";
+export { resolveBlenderRunner, runBlenderJob, __setBlenderRunnerForTesting, BLENDER_MODEL_INPUT_FILE } from "./run-job.js";
+export declare const BLENDER_NODES: (typeof import("./nodes/render-image.js").RenderImageNode | typeof import("./nodes/render-passes.js").RenderPassesNode | typeof import("./nodes/render-animation.js").RenderAnimationNode | typeof import("./nodes/bake-timeline-clip.js").BakeTimelineClipNode | typeof import("./nodes/prepare-for-engine.js").PrepareForEngineNode | typeof import("./nodes/export-model.js").ExportModelNode)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAStB,eAAO,MAAM,aAAa,qYAOzB,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * `@nodetool-ai/blender-nodes` — Blender headless integration (Stage 3).
+ *
+ * Binary discovery, the versioned job contract, the runner interface with
+ * its local implementation, the thin `runBlenderJob` entry point, and the
+ * `nodetool.blender.*` nodes. `BLENDER_NODES` is registered in
+ * `@nodetool-ai/base-nodes` alongside the other node arrays.
+ */
+export { BLENDER_RENDER_NODES } from "./nodes/render-image.js";
+export { RenderImageNode } from "./nodes/render-image.js";
+export { BLENDER_PASSES_NODES } from "./nodes/render-passes.js";
+export { RenderPassesNode } from "./nodes/render-passes.js";
+export { BLENDER_ANIMATION_NODES } from "./nodes/render-animation.js";
+export { BLENDER_BAKE_NODES } from "./nodes/bake-timeline-clip.js";
+export { BakeTimelineClipNode } from "./nodes/bake-timeline-clip.js";
+export { RenderAnimationNode } from "./nodes/render-animation.js";
+export { BLENDER_PREPARE_NODES } from "./nodes/prepare-for-engine.js";
+export { PrepareForEngineNode } from "./nodes/prepare-for-engine.js";
+export { BLENDER_EXPORT_NODES } from "./nodes/export-model.js";
+export { ExportModelNode } from "./nodes/export-model.js";
+export { BlenderVersionError, resolveBlenderBinary, resetBlenderBinaryCache, BLENDER_MIN_VERSION } from "./blender-binary.js";
+export { BLENDER_JOB_VERSION, jobFileNameSchema, blenderResultSchema } from "./job.js";
+export { BlenderJobError, LocalBlenderRunner, WorkerBlenderRunner, resolveOpScriptDir, MAX_OUTPUT_BYTES, MAX_TOTAL_OUTPUT_BYTES, MAX_OUTPUT_COUNT } from "./runner.js";
+export { bakeFrameOutputs, bakeModel3DClipToVideo, bakeMuxArgs, bakeRenderAnimationParams, bakeVideoFormat, muxPngSequenceToVideo, renderModel3DBakeFrames, MAX_BAKE_FRAMES } from "./bake.js";
+export { resolveBlenderRunner, runBlenderJob, __setBlenderRunnerForTesting, BLENDER_MODEL_INPUT_FILE } from "./run-job.js";
+import { BLENDER_RENDER_NODES } from "./nodes/render-image.js";
+import { BLENDER_PASSES_NODES } from "./nodes/render-passes.js";
+import { BLENDER_ANIMATION_NODES } from "./nodes/render-animation.js";
+import { BLENDER_BAKE_NODES } from "./nodes/bake-timeline-clip.js";
+import { BLENDER_PREPARE_NODES } from "./nodes/prepare-for-engine.js";
+import { BLENDER_EXPORT_NODES } from "./nodes/export-model.js";
+export const BLENDER_NODES = [
+    ...BLENDER_RENDER_NODES,
+    ...BLENDER_PASSES_NODES,
+    ...BLENDER_ANIMATION_NODES,
+    ...BLENDER_BAKE_NODES,
+    ...BLENDER_PREPARE_NODES,
+    ...BLENDER_EXPORT_NODES
+];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAqBlB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAQrB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EAChB,MAAM,WAAW,CAAC;AAOnB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,GAAG,uBAAuB;IAC1B,GAAG,kBAAkB;IACrB,GAAG,qBAAqB;IACxB,GAAG,oBAAoB;CACxB,CAAC"}