@nodetool-ai/blender-nodes 0.8.1

package/dist/nodes/export-model.js

@@ -0,0 +1,127 @@
+/**
+ * `nodetool.blender.ExportModel` — glTF scene → FBX, OBJ, or USD file.
+ *
+ * Stage 3: the `export_model` op over `LocalBlenderRunner` (D8). Takes a
+ * `Model3DRef` and returns an `AssetRef`, never a `Model3DRef`: FBX, OBJ,
+ * and USD are not glTF documents, and the `model_3d` socket keeps meaning
+ * glTF everywhere. The node persists the export through
+ * `context.createAsset` and returns `{ type: "asset", uri, asset_id,
+ * metadata: { format, mime } }`. GLB is deliberately not a format here:
+ * `PrepareForEngine` and `FormatConverter` already produce a `Model3DRef`
+ * for it.
+ *
+ * Every failure rethrows with the node name prefixed. An abort through
+ * `context.signal` passes through unwrapped so the node rejects with the
+ * abort reason and no partial output.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseNode, prop } from "@nodetool-ai/node-sdk";
+import { resolveModelBytes } from "@nodetool-ai/nodes-utils";
+import { isRecord, isString } from "@nodetool-ai/protocol";
+import { BlenderJobError } from "../runner.js";
+import { runBlenderJob } from "../run-job.js";
+import { runBlenderNodeStep } from "./blender-error.js";
+import { DEFAULT_MODEL_3D } from "./defaults.js";
+import { blenderProgressHandler } from "./progress.js";
+const NODE_NAME = "nodetool.blender.ExportModel";
+const FORMAT_FILES = {
+    fbx: { file: "model.fbx", mime: "application/octet-stream" },
+    obj: { file: "model.obj", mime: "text/plain" },
+    usd: { file: "model.usd", mime: "application/octet-stream" }
+};
+const EXPORT_FORMATS = ["fbx", "obj", "usd"];
+/** The format a user typed, or null when it names no exporter. */
+function toExportFormat(value) {
+    const normalized = value.toLowerCase();
+    return EXPORT_FORMATS.find((format) => format === normalized) ?? null;
+}
+/** Blender ran past its wall clock: point at the knob that fixes it. */
+function timeoutMessage(timeoutMs) {
+    return (`${NODE_NAME}: Blender export timed out after ${timeoutMs}ms. ` +
+        `Decimate the scene first, or raise the timeout.`);
+}
+export class ExportModelNode extends BaseNode {
+    static nodeType = "nodetool.blender.ExportModel";
+    static title = "Export 3D Model With Blender";
+    static description = "Export a 3D model (GLB/glTF) to FBX, OBJ, or USD with Blender, persisted as a stored asset.\n    3d, mesh, model, export, fbx, obj, usd, file, blender\n\n    Use cases:\n    - Hand a generated mesh to a game engine as FBX\n    - Export an OBJ for tools without glTF support\n    - Export USD for pipelines built on it";
+    static metadataOutputTypes = {
+        file: "asset"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    async process(context) {
+        const bytes = await resolveModelBytes(this.model, context);
+        if (bytes.length === 0) {
+            throw new Error(`${NODE_NAME}: model input is empty — connect a 3D model (GLB)`);
+        }
+        const requested = this.format ?? "fbx";
+        const format = toExportFormat(requested);
+        if (format === null) {
+            throw new BlenderJobError("bad_job", `${NODE_NAME}: unknown export format "${requested}" — choose fbx, obj, or usd.`);
+        }
+        const target = FORMAT_FILES[format];
+        if (!context) {
+            throw new BlenderJobError("bad_job", `${NODE_NAME}: exporting needs a processing context with createAsset.`);
+        }
+        const timeoutMs = Math.max(1, Number(this.timeout ?? 600)) * 1000;
+        return runBlenderNodeStep({
+            nodeName: NODE_NAME,
+            timeoutMessage: timeoutMessage(timeoutMs),
+            signal: context.signal
+        }, async () => {
+            const result = await runBlenderJob(context, bytes, { op: "export_model", params: { format } }, { file: target.file }, {
+                timeoutMs,
+                signal: context.signal,
+                onProgress: blenderProgressHandler(context, this.__node_id)
+            });
+            const raw = result.outputs["file"];
+            if (!raw || raw.length === 0) {
+                throw new BlenderJobError("missing_output", "Blender produced no export bytes.");
+            }
+            const created = await context.createAsset({
+                name: target.file,
+                contentType: target.mime,
+                content: raw
+            });
+            const assetId = isRecord(created) && isString(created["id"]) ? created["id"] : null;
+            if (assetId === null) {
+                throw new BlenderJobError("bad_result", "The export asset was created without an id.");
+            }
+            return {
+                file: {
+                    type: "asset",
+                    uri: `asset://${assetId}`,
+                    asset_id: assetId,
+                    metadata: { format, mime: target.mime }
+                }
+            };
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to export (GLB or glTF with embedded buffers)"
+    })
+], ExportModelNode.prototype, "model", void 0);
+__decorate([
+    prop({
+        type: "enum",
+        default: "fbx",
+        title: "Format",
+        description: "Export format: fbx, obj, or usd (OBJ is geometry-only, no .mtl; GLB stays a Model3DRef — see Prepare For Engine)",
+        values: ["fbx", "obj", "usd"]
+    })
+], ExportModelNode.prototype, "format", void 0);
+__decorate([
+    prop({ type: "int", default: 600, title: "Timeout", description: "Maximum export time in seconds", min: 1, max: 3600 })
+], ExportModelNode.prototype, "timeout", void 0);
+export const BLENDER_EXPORT_NODES = [ExportModelNode];
+//# sourceMappingURL=export-model.js.map

package/dist/nodes/export-model.js.map

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

package/dist/nodes/prepare-for-engine.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `nodetool.blender.PrepareForEngine` — glTF mesh → game-engine GLB + LODs.
+ *
+ * Stage 3: the `prepare_for_engine` op over `LocalBlenderRunner` (D8). Takes
+ * a `Model3DRef`, decimates every mesh toward `target_faces`, optionally
+ * unwraps and bakes (`ao`, `normal`, or both) into the materials, then
+ * returns the prepared model as an inline `model_3d` ref (GLB, like every
+ * other `model_3d` socket) plus `lod_count` LODs at halving face targets.
+ * Downstream save nodes decide persistence.
+ *
+ * Every failure rethrows with the node name prefixed. An abort through
+ * `context.signal` passes through unwrapped so the node rejects with the
+ * abort reason and no partial output.
+ */
+import { BaseNode } from "@nodetool-ai/node-sdk";
+import type { ModelBytesRefLike } from "@nodetool-ai/nodes-utils";
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { BakeMode } from "../job.js";
+/** An inline `model_3d` ref carrying GLB bytes, like `RenderToImage`'s image. */
+interface InlineModel3DRef {
+    type: string;
+    uri: string;
+    asset_id: null;
+    data: string;
+}
+/** Output handles PrepareForEngineNode.process() emits. */
+type PrepareForEngineNodeOutputs = {
+    model: InlineModel3DRef;
+    lods: InlineModel3DRef[];
+};
+export declare class PrepareForEngineNode extends BaseNode {
+    static readonly nodeType = "nodetool.blender.PrepareForEngine";
+    static readonly title = "Prepare 3D Model For Engine";
+    static readonly description = "Prepare a 3D model (GLB/glTF) for a game engine with Blender: decimate to a face budget, unwrap UVs, bake AO and normal maps, and emit LODs at halving face counts.\n    3d, mesh, decimate, unwrap, bake, lod, glb, game, engine, blender\n\n    Use cases:\n    - Shrink a generated mesh to a face budget for a game engine\n    - Bake AO and normal maps into the materials\n    - Emit LODs alongside the prepared model";
+    static readonly metadataOutputTypes: {
+        model: string;
+        lods: string;
+    };
+    static readonly inlineFields: never[];
+    static readonly inputFields: string[];
+    model: ModelBytesRefLike;
+    target_faces: number;
+    unwrap: boolean;
+    bake: BakeMode;
+    bake_resolution: number;
+    lod_count: number;
+    timeout: number;
+    process(context?: ProcessingContext): Promise<PrepareForEngineNodeOutputs>;
+}
+export declare const BLENDER_PREPARE_NODES: readonly [typeof PrepareForEngineNode];
+export {};
+//# sourceMappingURL=prepare-for-engine.d.ts.map

package/dist/nodes/prepare-for-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-for-engine.d.ts","sourceRoot":"","sources":["../../src/nodes/prepare-for-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAS1C,iFAAiF;AACjF,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,IAAI,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2DAA2D;AAC3D,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,gBAAgB,EAAE,CAAC;CAC1B,CAAC;AAcF,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,MAAM,CAAC,QAAQ,CAAC,QAAQ,uCAAuC;IAC/D,MAAM,CAAC,QAAQ,CAAC,KAAK,iCAAiC;IACtD,MAAM,CAAC,QAAQ,CAAC,WAAW,oaACwY;IACna,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,KAAK;QACL,IAAI;MACJ;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAa;IAQhC,KAAK,EAAE,iBAAiB,CAAC;IAGzB,YAAY,EAAE,MAAM,CAAC;IAGrB,MAAM,EAAE,OAAO,CAAC;IAShB,IAAI,EAAE,QAAQ,CAAC;IAGf,eAAe,EAAE,MAAM,CAAC;IAGxB,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAwE/E;CACF;AAED,eAAO,MAAM,qBAAqB,wCAAkC,CAAC"}

package/dist/nodes/prepare-for-engine.js

@@ -0,0 +1,127 @@
+/**
+ * `nodetool.blender.PrepareForEngine` — glTF mesh → game-engine GLB + LODs.
+ *
+ * Stage 3: the `prepare_for_engine` op over `LocalBlenderRunner` (D8). Takes
+ * a `Model3DRef`, decimates every mesh toward `target_faces`, optionally
+ * unwraps and bakes (`ao`, `normal`, or both) into the materials, then
+ * returns the prepared model as an inline `model_3d` ref (GLB, like every
+ * other `model_3d` socket) plus `lod_count` LODs at halving face targets.
+ * Downstream save nodes decide persistence.
+ *
+ * Every failure rethrows with the node name prefixed. An abort through
+ * `context.signal` passes through unwrapped so the node rejects with the
+ * abort reason and no partial output.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseNode, prop } from "@nodetool-ai/node-sdk";
+import { bytesToBase64, resolveModelBytes } from "@nodetool-ai/nodes-utils";
+import { BlenderJobError } from "../runner.js";
+import { runBlenderJob } from "../run-job.js";
+import { runBlenderNodeStep } from "./blender-error.js";
+import { DEFAULT_MODEL_3D } from "./defaults.js";
+import { blenderProgressHandler } from "./progress.js";
+const NODE_NAME = "nodetool.blender.PrepareForEngine";
+function modelRef(bytes) {
+    return { type: "model_3d", uri: "", asset_id: null, data: bytesToBase64(bytes) };
+}
+/** Blender ran past its wall clock: point at the knob that fixes it. */
+function timeoutMessage(timeoutMs) {
+    return (`${NODE_NAME}: Blender mesh preparation timed out after ${timeoutMs}ms. ` +
+        `Lower the bake resolution, decimate first, or raise the timeout.`);
+}
+export class PrepareForEngineNode extends BaseNode {
+    static nodeType = "nodetool.blender.PrepareForEngine";
+    static title = "Prepare 3D Model For Engine";
+    static description = "Prepare a 3D model (GLB/glTF) for a game engine with Blender: decimate to a face budget, unwrap UVs, bake AO and normal maps, and emit LODs at halving face counts.\n    3d, mesh, decimate, unwrap, bake, lod, glb, game, engine, blender\n\n    Use cases:\n    - Shrink a generated mesh to a face budget for a game engine\n    - Bake AO and normal maps into the materials\n    - Emit LODs alongside the prepared model";
+    static metadataOutputTypes = {
+        model: "model_3d",
+        lods: "list[model_3d]"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    async process(context) {
+        const bytes = await resolveModelBytes(this.model, context);
+        if (bytes.length === 0) {
+            throw new Error(`${NODE_NAME}: model input is empty — connect a 3D model (GLB)`);
+        }
+        const lodCount = Math.min(8, Math.max(0, Math.round(Number(this.lod_count ?? 0))));
+        const outputs = {};
+        outputs["model"] = "model.glb";
+        for (let index = 1; index <= lodCount; index++) {
+            outputs[`lod_${index}`] = `lod_${index}.glb`;
+        }
+        const timeoutMs = Math.max(1, Number(this.timeout ?? 600)) * 1000;
+        return runBlenderNodeStep({
+            nodeName: NODE_NAME,
+            timeoutMessage: timeoutMessage(timeoutMs),
+            signal: context?.signal
+        }, async () => {
+            const result = await runBlenderJob(context, bytes, {
+                op: "prepare_for_engine",
+                params: {
+                    target_faces: Math.min(1000000, Math.max(1, Math.round(Number(this.target_faces ?? 5000)))),
+                    unwrap: this.unwrap !== false,
+                    bake: this.bake ?? "none",
+                    bake_resolution: Math.min(4096, Math.max(16, Math.round(Number(this.bake_resolution ?? 1024)))),
+                    lod_count: lodCount
+                }
+            }, outputs, {
+                timeoutMs,
+                signal: context?.signal,
+                onProgress: blenderProgressHandler(context, this.__node_id)
+            });
+            const model = result.outputs["model"];
+            if (!model || model.length === 0) {
+                throw new BlenderJobError("missing_output", "Blender produced no model bytes.");
+            }
+            const lods = [];
+            for (let index = 1; index <= lodCount; index++) {
+                const raw = result.outputs[`lod_${index}`];
+                if (!raw || raw.length === 0) {
+                    throw new BlenderJobError("missing_output", `Blender produced no bytes for LOD ${index}.`);
+                }
+                lods.push(modelRef(raw));
+            }
+            return { model: modelRef(model), lods };
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to prepare (GLB or glTF with embedded buffers)"
+    })
+], PrepareForEngineNode.prototype, "model", void 0);
+__decorate([
+    prop({ type: "int", default: 5000, title: "Target Faces", description: "Face budget every mesh is decimated toward; meshes already under it are left alone", min: 1, max: 1000000 })
+], PrepareForEngineNode.prototype, "target_faces", void 0);
+__decorate([
+    prop({ type: "bool", default: true, title: "Unwrap", description: "UV-unwrap every mesh (smart project) before baking; baking projects missing UVs anyway" })
+], PrepareForEngineNode.prototype, "unwrap", void 0);
+__decorate([
+    prop({
+        type: "enum",
+        default: "none",
+        title: "Bake",
+        description: "Maps to bake into the materials at Bake Resolution: none, ao (occlusion multiplied into base color), normal (tangent-space normal map), or both",
+        values: ["none", "ao", "normal", "both"]
+    })
+], PrepareForEngineNode.prototype, "bake", void 0);
+__decorate([
+    prop({ type: "int", default: 1024, title: "Bake Resolution", description: "Width and height in pixels of each baked map", min: 16, max: 4096 })
+], PrepareForEngineNode.prototype, "bake_resolution", void 0);
+__decorate([
+    prop({ type: "int", default: 0, title: "LOD Count", description: "How many LODs to emit alongside the model, at halving face targets (LOD 1 is half the prepared faces, LOD 2 a quarter, and so on)", min: 0, max: 8 })
+], PrepareForEngineNode.prototype, "lod_count", void 0);
+__decorate([
+    prop({ type: "int", default: 600, title: "Timeout", description: "Maximum preparation time in seconds", min: 1, max: 3600 })
+], PrepareForEngineNode.prototype, "timeout", void 0);
+export const BLENDER_PREPARE_NODES = [PrepareForEngineNode];
+//# sourceMappingURL=prepare-for-engine.js.map

package/dist/nodes/prepare-for-engine.js.map

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

package/dist/nodes/progress.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Blender `Fra:` progress as `node_progress` messages (D6).
+ *
+ * `LocalBlenderRunner` turns the op's `Fra:<n>` stderr lines into
+ * `onProgress` calls; this binds them to `context.postMessage`, the way the
+ * ComfyUI node reports progress. Returns undefined without a context, so
+ * context-free node tests stay silent.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+export declare function blenderProgressHandler(context: ProcessingContext | undefined, nodeId: string): ((frame: number, total: number) => void) | undefined;
+//# sourceMappingURL=progress.d.ts.map

package/dist/nodes/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/nodes/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,GACb,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAUtD"}

package/dist/nodes/progress.js

@@ -0,0 +1,21 @@
+/**
+ * Blender `Fra:` progress as `node_progress` messages (D6).
+ *
+ * `LocalBlenderRunner` turns the op's `Fra:<n>` stderr lines into
+ * `onProgress` calls; this binds them to `context.postMessage`, the way the
+ * ComfyUI node reports progress. Returns undefined without a context, so
+ * context-free node tests stay silent.
+ */
+export function blenderProgressHandler(context, nodeId) {
+    if (!context)
+        return undefined;
+    return (frame, total) => {
+        context.postMessage({
+            type: "node_progress",
+            node_id: nodeId,
+            progress: frame,
+            total
+        });
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/nodes/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/nodes/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,UAAU,sBAAsB,CACpC,OAAsC,EACtC,MAAc;IAEd,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE;QACtC,OAAO,CAAC,WAAW,CAAC;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,KAAK;YACf,KAAK;SACN,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/nodes/render-animation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `nodetool.blender.RenderAnimation` — glTF scene + camera → video via Blender.
+ *
+ * Stage 2: the `render_animation` op over `LocalBlenderRunner` (D8). Takes
+ * a `Model3DRef`, builds the versioned `BlenderJob` for the frame range at
+ * `fps`, and returns an inline video ref like the video nodes, so
+ * downstream save nodes decide persistence. The scene fps is set to `fps`
+ * before import, so a glTF animation timestamp `t` seconds lands on frame
+ * `round(t * fps)`; with no glTF animation under `camera_mode: orbit` the
+ * orbit turns `orbit_degrees` across the range. Video comes from Blender's
+ * own FFMPEG writer (MPEG-4, H.264, `yuv420p`), and per-frame `Fra:`
+ * progress reaches the run as `node_progress` messages.
+ *
+ * Every failure rethrows with the node name prefixed. An abort through
+ * `context.signal` passes through unwrapped so the node rejects with the
+ * abort reason and no partial output.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { CameraMode } from "../job.js";
+import { BlenderRenderBase } from "./render-base.js";
+/** Output handle RenderAnimationNode.process() emits. */
+type RenderAnimationNodeOutputs = {
+    video: {
+        type: string;
+        uri: string;
+        asset_id: null;
+        data: string;
+    };
+};
+export declare class RenderAnimationNode extends BlenderRenderBase {
+    static readonly nodeType = "nodetool.blender.RenderAnimation";
+    static readonly title = "Render 3D Animation With Blender";
+    static readonly description = "Render a 3D model (GLB/glTF) to a video with Blender: glTF animations play on their timeline, or the orbit camera sweeps across the frame range.\n    3d, render, animation, video, camera, orbit, blender, eevee, cycles\n\n    Use cases:\n    - Turn an animated 3D model into a video\n    - Sweep the camera around a static scene for a turntable clip\n    - Feed camera-consistent frames into video models";
+    static readonly metadataOutputTypes: {
+        video: string;
+    };
+    static readonly inlineFields: never[];
+    static readonly inputFields: string[];
+    camera_mode: CameraMode;
+    width: number;
+    height: number;
+    transparent: boolean;
+    frame_start: number;
+    frame_end: number;
+    fps: number;
+    orbit_degrees: number;
+    timeout: number;
+    process(context?: ProcessingContext): Promise<RenderAnimationNodeOutputs>;
+}
+export declare const BLENDER_ANIMATION_NODES: readonly [typeof RenderAnimationNode];
+export {};
+//# sourceMappingURL=render-animation.d.ts.map

package/dist/nodes/render-animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-animation.d.ts","sourceRoot":"","sources":["../../src/nodes/render-animation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,yDAAyD;AACzD,KAAK,0BAA0B,GAAG;IAChC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC;AAUF,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,MAAM,CAAC,QAAQ,CAAC,QAAQ,sCAAsC;IAC9D,MAAM,CAAC,QAAQ,CAAC,KAAK,sCAAsC;IAC3D,MAAM,CAAC,QAAQ,CAAC,WAAW,yZAC6X;IACxZ,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,KAAK;MACL;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAa;IAahC,WAAW,EAAE,UAAU,CAAC;IAGxB,KAAK,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,OAAO,CAAC;IAGrB,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,MAAM,CAAC;IAGlB,GAAG,EAAE,MAAM,CAAC;IAGZ,aAAa,EAAE,MAAM,CAAC;IAGtB,OAAO,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA2E9E;CACF;AAED,eAAO,MAAM,uBAAuB,uCAAiC,CAAC"}

package/dist/nodes/render-animation.js

@@ -0,0 +1,136 @@
+/**
+ * `nodetool.blender.RenderAnimation` — glTF scene + camera → video via Blender.
+ *
+ * Stage 2: the `render_animation` op over `LocalBlenderRunner` (D8). Takes
+ * a `Model3DRef`, builds the versioned `BlenderJob` for the frame range at
+ * `fps`, and returns an inline video ref like the video nodes, so
+ * downstream save nodes decide persistence. The scene fps is set to `fps`
+ * before import, so a glTF animation timestamp `t` seconds lands on frame
+ * `round(t * fps)`; with no glTF animation under `camera_mode: orbit` the
+ * orbit turns `orbit_degrees` across the range. Video comes from Blender's
+ * own FFMPEG writer (MPEG-4, H.264, `yuv420p`), and per-frame `Fra:`
+ * progress reaches the run as `node_progress` messages.
+ *
+ * Every failure rethrows with the node name prefixed. An abort through
+ * `context.signal` passes through unwrapped so the node rejects with the
+ * abort reason and no partial output.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { prop } from "@nodetool-ai/node-sdk";
+import { bytesToBase64, resolveModelBytes } from "@nodetool-ai/nodes-utils";
+import { BlenderJobError } from "../runner.js";
+import { runBlenderJob } from "../run-job.js";
+import { runBlenderNodeStep } from "./blender-error.js";
+import { blenderProgressHandler } from "./progress.js";
+import { BlenderRenderBase } from "./render-base.js";
+const NODE_NAME = "nodetool.blender.RenderAnimation";
+/** Blender ran past its wall clock: point at the two knobs that fix it. */
+function timeoutMessage(timeoutMs) {
+    return (`${NODE_NAME}: Blender animation render timed out after ${timeoutMs}ms. ` +
+        `Lower the samples, use EEVEE, shorten the range, or raise the timeout.`);
+}
+export class RenderAnimationNode extends BlenderRenderBase {
+    static nodeType = "nodetool.blender.RenderAnimation";
+    static title = "Render 3D Animation With Blender";
+    static description = "Render a 3D model (GLB/glTF) to a video with Blender: glTF animations play on their timeline, or the orbit camera sweeps across the frame range.\n    3d, render, animation, video, camera, orbit, blender, eevee, cycles\n\n    Use cases:\n    - Turn an animated 3D model into a video\n    - Sweep the camera around a static scene for a turntable clip\n    - Feed camera-consistent frames into video models";
+    static metadataOutputTypes = {
+        video: "video"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    async process(context) {
+        const bytes = await resolveModelBytes(this.model, context);
+        if (bytes.length === 0) {
+            throw new Error(`${NODE_NAME}: model input is empty — connect a 3D model (GLB)`);
+        }
+        const frameStart = Math.max(0, Math.round(Number(this.frame_start ?? 1)));
+        const frameEnd = Math.max(frameStart, Math.round(Number(this.frame_end ?? 24)));
+        const timeoutMs = Math.max(1, Number(this.timeout ?? 600)) * 1000;
+        return runBlenderNodeStep({
+            nodeName: NODE_NAME,
+            timeoutMessage: timeoutMessage(timeoutMs),
+            signal: context?.signal
+        }, async () => {
+            const result = await runBlenderJob(context, bytes, {
+                op: "render_animation",
+                params: {
+                    camera_mode: this.camera_mode ?? "auto",
+                    azimuth: Number(this.azimuth ?? 45),
+                    elevation: Number(this.elevation ?? 25),
+                    fov: Number(this.fov ?? 35),
+                    zoom: Number(this.zoom ?? 1),
+                    lighting: this.lighting ?? "studio",
+                    light_intensity: Number(this.light_intensity ?? 1),
+                    background_color: String(this.background_color ?? "#808080"),
+                    transparent: this.transparent === true,
+                    engine: this.engine ?? "eevee",
+                    samples: Math.max(1, Math.round(Number(this.samples ?? 16))),
+                    denoise: this.denoise !== false,
+                    resolution_percentage: Math.max(1, Math.round(Number(this.resolution_percentage ?? 100))),
+                    width: Math.max(1, Math.round(Number(this.width ?? 1024))),
+                    height: Math.max(1, Math.round(Number(this.height ?? 1024))),
+                    frame_start: frameStart,
+                    frame_end: frameEnd,
+                    fps: Math.max(1, Math.round(Number(this.fps ?? 24))),
+                    orbit_degrees: Number(this.orbit_degrees ?? 360)
+                }
+            }, { video: "anim.mp4" }, {
+                timeoutMs,
+                signal: context?.signal,
+                onProgress: blenderProgressHandler(context, this.__node_id)
+            });
+            const mp4 = result.outputs["video"];
+            if (!mp4 || mp4.length === 0) {
+                throw new BlenderJobError("missing_output", "Blender produced no video bytes.");
+            }
+            return {
+                video: {
+                    type: "video",
+                    uri: "",
+                    asset_id: null,
+                    data: bytesToBase64(mp4)
+                }
+            };
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "enum",
+        default: "auto",
+        title: "Camera Mode",
+        description: "Whose camera renders: auto (the scene's first camera when the model has one, else an orbit camera), scene (the scene's first camera; an error when the model has none), or orbit (always an orbit camera from the props below; with no glTF animation it sweeps orbit_degrees across the range)",
+        values: ["auto", "scene", "orbit"]
+    })
+], RenderAnimationNode.prototype, "camera_mode", void 0);
+__decorate([
+    prop({ type: "int", default: 1024, title: "Width", description: "Output video width in pixels", min: 16, max: 4096 })
+], RenderAnimationNode.prototype, "width", void 0);
+__decorate([
+    prop({ type: "int", default: 1024, title: "Height", description: "Output video height in pixels", min: 16, max: 4096 })
+], RenderAnimationNode.prototype, "height", void 0);
+__decorate([
+    prop({ type: "bool", default: false, title: "Transparent", description: "Render on a transparent background (video alpha; container support varies)" })
+], RenderAnimationNode.prototype, "transparent", void 0);
+__decorate([
+    prop({ type: "int", default: 1, title: "Frame Start", description: "First frame in the glTF timeline (timestamp t seconds lands on round(t * fps))", min: 0, max: 100000 })
+], RenderAnimationNode.prototype, "frame_start", void 0);
+__decorate([
+    prop({ type: "int", default: 24, title: "Frame End", description: "Last frame rendered, inclusive", min: 0, max: 100000 })
+], RenderAnimationNode.prototype, "frame_end", void 0);
+__decorate([
+    prop({ type: "int", default: 24, title: "FPS", description: "Scene frames per second; glTF animation timestamps map onto this timeline", min: 1, max: 120 })
+], RenderAnimationNode.prototype, "fps", void 0);
+__decorate([
+    prop({ type: "float", default: 360, title: "Orbit Degrees", description: "Camera sweep in degrees across the range when the model has no animation and Camera Mode is orbit", min: -1080, max: 1080 })
+], RenderAnimationNode.prototype, "orbit_degrees", void 0);
+__decorate([
+    prop({ type: "int", default: 600, title: "Timeout", description: "Maximum render time in seconds", min: 1, max: 3600 })
+], RenderAnimationNode.prototype, "timeout", void 0);
+export const BLENDER_ANIMATION_NODES = [RenderAnimationNode];
+//# sourceMappingURL=render-animation.js.map

package/dist/nodes/render-animation.js.map

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

package/dist/nodes/render-base.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared props for the three Blender render nodes (`RenderImage`,
+ * `RenderPasses`, `RenderAnimation`).
+ *
+ * The camera, lighting, and engine block is identical across the three
+ * nodes, so it lives here once. Per-node wording stays on the node:
+ * `RenderAnimation` re-declares `camera_mode`, `width`, `height`, and
+ * `transparent` with its own descriptions, which override these through
+ * the prototype chain (`collectDeclaredProps` merges base-first, so an
+ * override keeps its base position and the prop order never changes).
+ * `timeout` also stays per node: it is last everywhere, and inheriting it
+ * would move it before `RenderPasses`' `passes`/`depth_format`.
+ */
+import { BaseNode } from "@nodetool-ai/node-sdk";
+import type { ModelBytesRefLike } from "@nodetool-ai/nodes-utils";
+import type { BlenderEngine, CameraMode, LightingPreset } from "../job.js";
+export declare abstract class BlenderRenderBase extends BaseNode {
+    model: ModelBytesRefLike;
+    camera_mode: CameraMode;
+    width: number;
+    height: number;
+    azimuth: number;
+    elevation: number;
+    fov: number;
+    zoom: number;
+    lighting: LightingPreset;
+    light_intensity: number;
+    background_color: string;
+    transparent: boolean;
+    engine: BlenderEngine;
+    samples: number;
+    denoise: boolean;
+    resolution_percentage: number;
+}
+//# sourceMappingURL=render-base.d.ts.map

package/dist/nodes/render-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-base.d.ts","sourceRoot":"","sources":["../../src/nodes/render-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACf,MAAM,WAAW,CAAC;AAGnB,8BAAsB,iBAAkB,SAAQ,QAAQ;IAO9C,KAAK,EAAE,iBAAiB,CAAC;IAUzB,WAAW,EAAE,UAAU,CAAC;IAGxB,KAAK,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAGlB,GAAG,EAAE,MAAM,CAAC;IAGZ,IAAI,EAAE,MAAM,CAAC;IASb,QAAQ,EAAE,cAAc,CAAC;IAGzB,eAAe,EAAE,MAAM,CAAC;IAGxB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,WAAW,EAAE,OAAO,CAAC;IASrB,MAAM,EAAE,aAAa,CAAC;IAGtB,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,OAAO,CAAC;IAGjB,qBAAqB,EAAE,MAAM,CAAC;CACvC"}