@nodetool-ai/video-nodes 0.8.1

package/dist/nodes/model3d/render3d-headless.js

@@ -0,0 +1,190 @@
+/**
+ * Node-side driver for `nodetool.model3d.RenderToImage`.
+ *
+ * The backend has no WebGL, so it launches a headless Chromium, injects the
+ * self-contained render bundle (`dist/render3d-page.js`, built by
+ * `scripts/bundle-render3d-page.mjs`), and calls `__nodetoolRenderGlbFrames`
+ * over CDP. SwiftShader flags keep WebGL working on GPU-less servers.
+ *
+ * Chrome discovery follows the automation nodes: `CHROME_PATH` when set,
+ * otherwise chrome-launcher's platform search. Everything here is
+ * lazy-imported so merely registering the node never requires Chrome.
+ */
+import { readFile } from "node:fs/promises";
+import { resolvePackageAssetPath } from "@nodetool-ai/config";
+import { renderFrameFromRender3DOptions, sessionOptionsFromRender3DOptions } from "./render3d-core.js";
+import { isNonEmptyString } from "@nodetool-ai/node-sdk";
+/** Budget for the first frame, which pays the model load and the GL warm-up. */
+const RENDER_TIMEOUT_MS = 120_000;
+/** Added to the budget for every frame after the first. */
+const EXTRA_FRAME_TIMEOUT_MS = 30_000;
+/** How long to keep trying to attach to the debug port before giving up. */
+const CDP_CONNECT_TIMEOUT_MS = 10_000;
+/** Gap between attach attempts. */
+const CDP_CONNECT_RETRY_MS = 100;
+const CHROME_FLAGS = [
+    "--headless=new",
+    "--no-sandbox",
+    "--disable-setuid-sandbox",
+    "--disable-dev-shm-usage",
+    // Software WebGL: ANGLE on SwiftShader, explicitly allowed (Chrome 137+
+    // refuses software WebGL in headless without the unsafe opt-in).
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--hide-scrollbars",
+    "--mute-audio"
+];
+let bundlePromise = null;
+/** Load (and cache) the self-contained render page bundle. */
+async function loadRenderBundle() {
+    if (!bundlePromise) {
+        bundlePromise = (async () => {
+            const path = resolvePackageAssetPath({ pkg: "@nodetool-ai/video-nodes", path: "render3d-page.js" }, import.meta.url);
+            return readFile(path, "utf-8");
+        })().catch((err) => {
+            bundlePromise = null;
+            throw err;
+        });
+    }
+    return bundlePromise;
+}
+function throwOnException(result, stage) {
+    if (!result.exceptionDetails)
+        return;
+    const exception = result.exceptionDetails.exception;
+    const detail = exception?.description ??
+        (exception?.value !== undefined ? String(exception.value) : undefined) ??
+        result.exceptionDetails.text ??
+        "unknown error";
+    throw new Error(`RenderToImage (${stage}): ${detail}`);
+}
+async function withTimeout(promise, label, timeoutMs) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`RenderToImage: ${label} timed out after ${timeoutMs}ms`)), timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Attach to a freshly launched Chrome's debug port, retrying while it refuses.
+ *
+ * `chrome-launcher` resolves as soon as the port accepts a TCP connection, but
+ * `chrome-remote-interface` then issues an HTTP request to `/json/list` that a
+ * still-initializing Chrome refuses outright. A single attempt loses that race
+ * on a loaded machine — it turned up as an `ECONNREFUSED` on CI while several
+ * other Chrome-driving suites were running — so poll until the endpoint is
+ * actually serving.
+ *
+ * Exported for tests.
+ */
+export async function connectCdp(port, { timeoutMs = CDP_CONNECT_TIMEOUT_MS, retryMs = CDP_CONNECT_RETRY_MS } = {}) {
+    const CDP = (await import("chrome-remote-interface")).default;
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    for (;;) {
+        try {
+            // SAFETY: `CdpClient` is the `Runtime.enable`/`Runtime.evaluate`/`close`
+            // subset this renderer drives; chrome-remote-interface types every
+            // domain dynamically.
+            return (await CDP({ port }));
+        }
+        catch (err) {
+            lastError = err;
+            // Stop once another wait would take us past the deadline, so the loop
+            // never overruns the budget it was given.
+            if (Date.now() + retryMs >= deadline)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, retryMs));
+        }
+    }
+    const detail = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error(`RenderToImage: could not attach to headless Chrome on port ${port} ` +
+        `within ${timeoutMs}ms: ${detail}`, { cause: lastError });
+}
+/**
+ * Launch Chrome, retrying once after a beat. `chrome-launcher` rejects with
+ * its port poll's raw error (an `ECONNREFUSED`) when Chromium is too slow to
+ * open its debug port on a loaded machine — the same transient race the CDP
+ * attach retry above covers, one step earlier. A machine that cannot run
+ * Chrome at all fails the same way twice and the second error propagates.
+ *
+ * Exported for tests.
+ */
+export async function launchChromeWithRetry(launch, retryDelayMs = 1_000) {
+    try {
+        return await launch();
+    }
+    catch {
+        // The first failure leaves any half-started Chrome behind; a fresh launch
+        // picks a fresh port, so the two never contend.
+        await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+        return await launch();
+    }
+}
+/**
+ * Render one session's worth of frames in a fresh headless Chromium: one
+ * launch, one model load, one PNG per frame. One Chrome per call keeps the
+ * node stateless; launch cost (~1s) is negligible next to a typical
+ * workflow's model-generation steps.
+ */
+export async function renderGlbFramesHeadless(glb, options, frames) {
+    if (frames.length === 0)
+        return [];
+    const bundle = await loadRenderBundle();
+    const { launch } = await import("chrome-launcher");
+    const chrome = await launchChromeWithRetry(() => launch({
+        chromeFlags: CHROME_FLAGS,
+        chromePath: process.env.CHROME_PATH || undefined
+    }));
+    let client = null;
+    try {
+        client = await connectCdp(chrome.port);
+        await client.Runtime.enable();
+        const injected = await client.Runtime.evaluate({ expression: bundle });
+        throwOnException(injected, "inject bundle");
+        const glbBase64 = Buffer.from(glb).toString("base64");
+        const call = await withTimeout(client.Runtime.evaluate({
+            expression: `globalThis.__nodetoolRenderGlbFrames(${JSON.stringify(glbBase64)}, ${JSON.stringify(JSON.stringify(options))}, ${JSON.stringify(JSON.stringify(frames))})`,
+            awaitPromise: true,
+            returnByValue: true
+        }), "render", RENDER_TIMEOUT_MS + EXTRA_FRAME_TIMEOUT_MS * (frames.length - 1));
+        throwOnException(call, "render");
+        const pngsBase64 = call.result?.value;
+        if (!Array.isArray(pngsBase64) || pngsBase64.length !== frames.length) {
+            throw new Error(`RenderToImage: headless render returned ${Array.isArray(pngsBase64) ? pngsBase64.length : "no"} images for ${frames.length} frames`);
+        }
+        return pngsBase64.map((png) => {
+            if (!isNonEmptyString(png)) {
+                throw new Error("RenderToImage: headless render returned no image data");
+            }
+            return new Uint8Array(Buffer.from(png, "base64"));
+        });
+    }
+    finally {
+        if (client) {
+            try {
+                await client.close();
+            }
+            catch {
+                // Chrome is being killed right after; a failed CDP close is harmless.
+            }
+        }
+        try {
+            await chrome.kill();
+        }
+        catch {
+            // Process may already be gone.
+        }
+    }
+}
+/** Render GLB bytes to PNG bytes: the one-frame case of the above. */
+export async function renderGlbHeadless(glb, options) {
+    const [png] = await renderGlbFramesHeadless(glb, sessionOptionsFromRender3DOptions(options), [renderFrameFromRender3DOptions(options)]);
+    return png;
+}
+//# sourceMappingURL=render3d-headless.js.map

package/dist/nodes/model3d/render3d-headless.js.map

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

package/dist/nodes/model3d/render3d-page.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Headless-page entry for `nodetool.model3d.RenderToImage` and for the
+ * timeline's `model3d` layers.
+ *
+ * esbuild bundles this file (plus three.js) into `dist/render3d-page.js`
+ * (see `scripts/bundle-render3d-page.mjs`). The Node-side driver
+ * (`render3d-headless.ts`) evaluates the bundle in a blank headless-Chromium
+ * page, then calls `__nodetoolRenderGlbFrames` over CDP — one session, one
+ * PNG per requested frame. Every argument and result is base64 or JSON text,
+ * the only data shapes that survive `Runtime.evaluate` round-trips.
+ */
+declare global {
+    var __nodetoolRenderGlbFrames: ((glbBase64: string, optionsJson: string, framesJson: string) => Promise<string[]>) | undefined;
+}
+export {};
+//# sourceMappingURL=render3d-page.d.ts.map

package/dist/nodes/model3d/render3d-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render3d-page.d.ts","sourceRoot":"","sources":["../../../src/nodes/model3d/render3d-page.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AA2BH,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,yBAAyB,EACzB,CAAC,CACC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GACvB,SAAS,CAAC;CACf"}

package/dist/nodes/model3d/render3d-page.js

@@ -0,0 +1,51 @@
+/// <reference lib="dom" />
+/**
+ * Headless-page entry for `nodetool.model3d.RenderToImage` and for the
+ * timeline's `model3d` layers.
+ *
+ * esbuild bundles this file (plus three.js) into `dist/render3d-page.js`
+ * (see `scripts/bundle-render3d-page.mjs`). The Node-side driver
+ * (`render3d-headless.ts`) evaluates the bundle in a blank headless-Chromium
+ * page, then calls `__nodetoolRenderGlbFrames` over CDP — one session, one
+ * PNG per requested frame. Every argument and result is base64 or JSON text,
+ * the only data shapes that survive `Runtime.evaluate` round-trips.
+ */
+import { createModel3DRenderSession } from "./render3d-core.js";
+function base64ToBytes(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+function bytesToBase64(bytes) {
+    // Chunked to stay clear of argument-count limits on large images.
+    const chunkSize = 0x8000;
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += chunkSize) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
+    }
+    return btoa(binary);
+}
+globalThis.__nodetoolRenderGlbFrames = async (glbBase64, optionsJson, framesJson) => {
+    const options = JSON.parse(optionsJson);
+    const frames = JSON.parse(framesJson);
+    const session = await createModel3DRenderSession(base64ToBytes(glbBase64), options);
+    try {
+        const pngs = [];
+        for (const frame of frames) {
+            // Serial on purpose: one canvas and one WebGL context per session, so a
+            // frame has to be encoded before the next one overwrites it.
+            const blob = await session
+                .render(frame)
+                .convertToBlob({ type: "image/png" });
+            pngs.push(bytesToBase64(new Uint8Array(await blob.arrayBuffer())));
+        }
+        return pngs;
+    }
+    finally {
+        session.dispose();
+    }
+};
+//# sourceMappingURL=render3d-page.js.map

package/dist/nodes/model3d/render3d-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render3d-page.js","sourceRoot":"","sources":["../../../src/nodes/model3d/render3d-page.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B;;;;;;;;;;GAUG;AAEH,OAAO,EACL,0BAA0B,EAG3B,MAAM,oBAAoB,CAAC;AAE5B,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAiB;IACtC,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC;IACzB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAYD,UAAU,CAAC,yBAAyB,GAAG,KAAK,EAC1C,SAAiB,EACjB,WAAmB,EACnB,UAAkB,EACC,EAAE;IACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA0B,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAyB,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAC9C,aAAa,CAAC,SAAS,CAAC,EACxB,OAAO,CACR,CAAC;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,wEAAwE;YACxE,6DAA6D;YAC7D,MAAM,IAAI,GAAG,MAAM,OAAO;iBACvB,MAAM,CAAC,KAAK,CAAC;iBACb,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;AACH,CAAC,CAAC"}

package/dist/nodes/model3d/transforms.d.ts

@@ -0,0 +1,56 @@
+import { GlbTransformNode } from "./base.js";
+import type { Model3DRefLike } from "./types.js";
+export declare class Transform3DNode extends GlbTransformNode {
+    static readonly nodeType = "nodetool.model3d.Transform3D";
+    static readonly title = "Transform 3D";
+    static readonly description = "Apply translation, rotation, and scaling to a 3D model.\n    3d, mesh, model, transform, translate, rotate, scale, move\n\n    Use cases:\n    - Position models in 3D space\n    - Scale models to specific dimensions\n    - Rotate models for proper orientation";
+    static readonly metadataOutputTypes: {
+        output: string;
+    };
+    static readonly inlineFields: never[];
+    static readonly inputFields: string[];
+    model: Model3DRefLike;
+    translate_x: number;
+    translate_y: number;
+    translate_z: number;
+    rotate_x: number;
+    rotate_y: number;
+    rotate_z: number;
+    scale_x: number;
+    scale_y: number;
+    scale_z: number;
+    uniform_scale: number;
+    protected transform(bytes: Uint8Array): Uint8Array | null;
+}
+export declare class CenterMeshNode extends GlbTransformNode {
+    static readonly nodeType = "nodetool.model3d.CenterMesh";
+    static readonly title = "Center Mesh";
+    static readonly description = "Center a mesh at the origin.\n    3d, mesh, model, center, origin, align\n\n    Use cases:\n    - Center models for consistent positioning\n    - Prepare models for rotation\n    - Align multiple models";
+    static readonly metadataOutputTypes: {
+        output: string;
+    };
+    static readonly inlineFields: never[];
+    static readonly inputFields: string[];
+    model: Model3DRefLike;
+    use_centroid: boolean;
+    protected transform(bytes: Uint8Array): Uint8Array | null;
+}
+export declare class NormalizeModel3DNode extends GlbTransformNode {
+    static readonly nodeType = "nodetool.model3d.NormalizeModel3D";
+    static readonly title = "Normalize Model 3D";
+    static readonly description = "Normalize a 3D model with explicit axis cleanup, centering, optional uniform scaling, and optional ground placement.\n    3d, mesh, model, normalize, center, scale, orient, ground\n\n    Current limits:\n    - First honest pass supports GLB geometry cleanup only\n    - Axis normalization is explicit (`keep`, `z_to_y`, `y_to_z`), not auto-detected\n\n    Use cases:\n    - Standardize imported GLB orientation\n    - Fit meshes into a predictable size box\n    - Center models before downstream processing\n    - Place meshes onto a chosen ground axis";
+    static readonly metadataOutputTypes: {
+        output: string;
+    };
+    static readonly inlineFields: never[];
+    static readonly inputFields: string[];
+    model: Model3DRefLike;
+    center_mode: "bounds" | "centroid" | "none";
+    axis_preset: "keep" | "z_to_y" | "y_to_z";
+    scale_to_size: boolean;
+    target_size: number;
+    place_on_ground: boolean;
+    ground_axis: "y" | "z";
+    protected transform(bytes: Uint8Array): Uint8Array | null;
+}
+//# sourceMappingURL=transforms.d.ts.map

package/dist/nodes/model3d/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../../src/nodes/model3d/transforms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,kCAAkC;IAC1D,MAAM,CAAC,QAAQ,CAAC,KAAK,kBAAkB;IACvC,MAAM,CAAC,QAAQ,CAAC,WAAW,yQAC6O;IACxQ,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,MAAM;MACN;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAa;IAQhC,KAAK,EAAE,cAAc,CAAC;IAGtB,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,MAAM,CAAC;IAGpB,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAGhB,aAAa,EAAE,MAAM,CAAC;IAE9B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAaxD;CACF;AAED,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,MAAM,CAAC,QAAQ,CAAC,QAAQ,iCAAiC;IACzD,MAAM,CAAC,QAAQ,CAAC,KAAK,iBAAiB;IACtC,MAAM,CAAC,QAAQ,CAAC,WAAW,gNACoL;IAC/M,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,MAAM;MACN;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAa;IAQhC,KAAK,EAAE,cAAc,CAAC;IAQtB,YAAY,EAAE,OAAO,CAAC;IAE9B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAExD;CACF;AAED,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,QAAQ,CAAC,QAAQ,uCAAuC;IAC/D,MAAM,CAAC,QAAQ,CAAC,KAAK,wBAAwB;IAC7C,MAAM,CAAC,QAAQ,CAAC,WAAW,8iBACkhB;IAC7iB,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,MAAM;MACN;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAM;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAa;IAQhC,KAAK,EAAE,cAAc,CAAC;IAGtB,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAG5C,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAG1C,aAAa,EAAE,OAAO,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IAGpB,eAAe,EAAE,OAAO,CAAC;IAGzB,WAAW,EAAE,GAAG,GAAG,GAAG,CAAC;IAE/B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CASxD;CACF"}

package/dist/nodes/model3d/transforms.js

@@ -0,0 +1,148 @@
+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 { GlbTransformNode } from "./base.js";
+import { DEFAULT_MODEL_3D } from "./defaults.js";
+import { centerGlb, normalizeGlb, transformGlb } from "./mesh-ops.js";
+export class Transform3DNode extends GlbTransformNode {
+    static nodeType = "nodetool.model3d.Transform3D";
+    static title = "Transform 3D";
+    static description = "Apply translation, rotation, and scaling to a 3D model.\n    3d, mesh, model, transform, translate, rotate, scale, move\n\n    Use cases:\n    - Position models in 3D space\n    - Scale models to specific dimensions\n    - Rotate models for proper orientation";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    transform(bytes) {
+        return transformGlb(bytes, {
+            translateX: this.translate_x,
+            translateY: this.translate_y,
+            translateZ: this.translate_z,
+            rotateXDeg: this.rotate_x,
+            rotateYDeg: this.rotate_y,
+            rotateZDeg: this.rotate_z,
+            scaleX: this.scale_x,
+            scaleY: this.scale_y,
+            scaleZ: this.scale_z,
+            uniformScale: this.uniform_scale
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to transform"
+    })
+], Transform3DNode.prototype, "model", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Translate X", description: "Translation along X axis" })
+], Transform3DNode.prototype, "translate_x", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Translate Y", description: "Translation along Y axis" })
+], Transform3DNode.prototype, "translate_y", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Translate Z", description: "Translation along Z axis" })
+], Transform3DNode.prototype, "translate_z", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Rotate X", description: "Rotation around X axis in degrees", min: -360, max: 360 })
+], Transform3DNode.prototype, "rotate_x", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Rotate Y", description: "Rotation around Y axis in degrees", min: -360, max: 360 })
+], Transform3DNode.prototype, "rotate_y", void 0);
+__decorate([
+    prop({ type: "float", default: 0, title: "Rotate Z", description: "Rotation around Z axis in degrees", min: -360, max: 360 })
+], Transform3DNode.prototype, "rotate_z", void 0);
+__decorate([
+    prop({ type: "float", default: 1, title: "Scale X", description: "Scale factor along X axis" })
+], Transform3DNode.prototype, "scale_x", void 0);
+__decorate([
+    prop({ type: "float", default: 1, title: "Scale Y", description: "Scale factor along Y axis" })
+], Transform3DNode.prototype, "scale_y", void 0);
+__decorate([
+    prop({ type: "float", default: 1, title: "Scale Z", description: "Scale factor along Z axis" })
+], Transform3DNode.prototype, "scale_z", void 0);
+__decorate([
+    prop({ type: "float", default: 1, title: "Uniform Scale", description: "Uniform scale factor (applied after axis scales)" })
+], Transform3DNode.prototype, "uniform_scale", void 0);
+export class CenterMeshNode extends GlbTransformNode {
+    static nodeType = "nodetool.model3d.CenterMesh";
+    static title = "Center Mesh";
+    static description = "Center a mesh at the origin.\n    3d, mesh, model, center, origin, align\n\n    Use cases:\n    - Center models for consistent positioning\n    - Prepare models for rotation\n    - Align multiple models";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    transform(bytes) {
+        return centerGlb(bytes, { useCentroid: this.use_centroid });
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to center"
+    })
+], CenterMeshNode.prototype, "model", void 0);
+__decorate([
+    prop({
+        type: "bool",
+        default: true,
+        title: "Use Centroid",
+        description: "Use geometric centroid (True) or bounding box center (False)"
+    })
+], CenterMeshNode.prototype, "use_centroid", void 0);
+export class NormalizeModel3DNode extends GlbTransformNode {
+    static nodeType = "nodetool.model3d.NormalizeModel3D";
+    static title = "Normalize Model 3D";
+    static description = "Normalize a 3D model with explicit axis cleanup, centering, optional uniform scaling, and optional ground placement.\n    3d, mesh, model, normalize, center, scale, orient, ground\n\n    Current limits:\n    - First honest pass supports GLB geometry cleanup only\n    - Axis normalization is explicit (`keep`, `z_to_y`, `y_to_z`), not auto-detected\n\n    Use cases:\n    - Standardize imported GLB orientation\n    - Fit meshes into a predictable size box\n    - Center models before downstream processing\n    - Place meshes onto a chosen ground axis";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    static inlineFields = [];
+    static inputFields = ["model"];
+    transform(bytes) {
+        return normalizeGlb(bytes, {
+            centerMode: this.center_mode,
+            axisPreset: this.axis_preset,
+            scaleToSize: this.scale_to_size,
+            targetSize: this.target_size,
+            placeOnGround: this.place_on_ground,
+            groundAxis: this.ground_axis
+        });
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to normalize"
+    })
+], NormalizeModel3DNode.prototype, "model", void 0);
+__decorate([
+    prop({ type: "enum", default: "bounds", title: "Center Mode", description: "How to center the model before optional scaling", values: ["bounds", "centroid", "none"] })
+], NormalizeModel3DNode.prototype, "center_mode", void 0);
+__decorate([
+    prop({ type: "enum", default: "keep", title: "Axis Preset", description: "Explicit orientation normalization preset", values: ["keep", "z_to_y", "y_to_z"] })
+], NormalizeModel3DNode.prototype, "axis_preset", void 0);
+__decorate([
+    prop({ type: "bool", default: true, title: "Scale To Size", description: "Scale the model uniformly so its longest bounds dimension matches the target size" })
+], NormalizeModel3DNode.prototype, "scale_to_size", void 0);
+__decorate([
+    prop({ type: "float", default: 1, title: "Target Size", description: "Longest bounds dimension after optional uniform scaling", min: 0.0001 })
+], NormalizeModel3DNode.prototype, "target_size", void 0);
+__decorate([
+    prop({ type: "bool", default: true, title: "Place On Ground", description: "Translate the mesh so the chosen ground axis minimum becomes zero" })
+], NormalizeModel3DNode.prototype, "place_on_ground", void 0);
+__decorate([
+    prop({ type: "enum", default: "y", title: "Ground Axis", description: "Axis treated as the up/ground direction for placement", values: ["y", "z"] })
+], NormalizeModel3DNode.prototype, "ground_axis", void 0);
+//# sourceMappingURL=transforms.js.map

package/dist/nodes/model3d/transforms.js.map

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

package/dist/nodes/model3d/types.d.ts

@@ -0,0 +1,82 @@
+export type Model3DRefLike = {
+    uri?: string;
+    data?: Uint8Array | string;
+    format?: string;
+    vertices?: number;
+    faces?: number;
+};
+export type ImageRefLike = {
+    data?: Uint8Array | string;
+    uri?: string;
+};
+export type JsonResources = Record<string, Uint8Array>;
+export type JsonResourceRef = {
+    uri?: string;
+};
+export type Model3DMetadata = {
+    uri: string;
+    format: string;
+    size_bytes: number;
+    vertices: number;
+    faces: number;
+    vertex_count: number;
+    face_count: number;
+    mesh_count: number;
+    primitive_count: number;
+    bounds_min: number[];
+    bounds_max: number[];
+    is_watertight: boolean;
+    center_of_mass: number[] | null;
+    volume: number | null;
+    surface_area: number | null;
+};
+export type ManifoldMeshLike = {
+    numProp: number;
+    triVerts: Uint32Array;
+    vertProperties: Float32Array;
+};
+export type ManifoldInstance = {
+    add(other: ManifoldInstance): ManifoldInstance;
+    subtract(other: ManifoldInstance): ManifoldInstance;
+    intersect(other: ManifoldInstance): ManifoldInstance;
+    getMesh(): ManifoldMeshLike;
+    delete(): void;
+};
+export type ManifoldApi = {
+    setup(): void;
+    Manifold: {
+        ofMesh(mesh: ManifoldMeshLike): ManifoldInstance;
+    };
+};
+export interface GltfAccessor {
+    bufferView: number;
+    byteOffset?: number;
+    componentType: number;
+    count: number;
+    type: string;
+    min?: number[];
+    max?: number[];
+}
+export interface GltfBufferView {
+    buffer: number;
+    byteOffset?: number;
+    byteLength: number;
+    byteStride?: number;
+}
+interface GltfPrimitive {
+    attributes: Record<string, number>;
+    indices?: number;
+    mode?: number;
+}
+interface GltfMesh {
+    primitives: GltfPrimitive[];
+    [key: string]: unknown;
+}
+export interface GltfJson {
+    accessors?: GltfAccessor[];
+    bufferViews?: GltfBufferView[];
+    meshes?: GltfMesh[];
+    [key: string]: unknown;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/nodes/model3d/types.d.ts.map

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

package/dist/nodes/model3d/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/nodes/model3d/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nodes/model3d/types.ts"],"names":[],"mappings":""}

package/dist/nodes/model3d/utils.d.ts

@@ -0,0 +1,46 @@
+import type { JsonResourceRef, JsonResources, Model3DRefLike } from "./types.js";
+export declare function toBytes(data: Uint8Array | string | undefined): Uint8Array;
+export declare function modelBytes(model: unknown): Uint8Array;
+export declare function modelRefToBytes(model: unknown, context?: {
+    storage?: {
+        retrieve(uri: string): Promise<Uint8Array | null>;
+    } | null;
+}): Promise<Uint8Array>;
+/**
+ * Resolve an image-ref-shaped value (`{uri, data, asset_id, ...}`) to raw
+ * image bytes. Accepts inline `data` (base64 string or Uint8Array), a
+ * `data:` URI, or — given a `ProcessingContext` — a storage URI / file://
+ * URI / http(s) URL.
+ *
+ * Throws when nothing resolvable is present so the caller can surface a
+ * clear "missing image" error rather than silently sending zero bytes.
+ */
+export declare function imageRefToBytes(ref: unknown, context?: {
+    storage?: {
+        retrieve(uri: string): Promise<Uint8Array | null>;
+    } | null;
+}): Promise<Uint8Array>;
+export declare function modelRef(data: Uint8Array, extras?: Record<string, unknown>): {
+    type: string;
+    asset_id: null;
+    metadata: null;
+    data: string;
+};
+export declare function filePath(uriOrPath: string): string;
+export declare function dateName(name: string): string;
+export declare function extFormat(filename: string): string;
+export declare function pad4(length: number): number;
+export declare function replaceExtension(uriOrPath: string, format: string): string;
+export declare function modelFormat(model: Model3DRefLike): string;
+export declare function mimeTypeForResource(uri: string): string;
+export declare function bytesToDataUri(bytes: Uint8Array, uri: string): string;
+export declare function embedJsonResourceUris(refs: JsonResourceRef[] | undefined, resources: JsonResources): void;
+export declare function passthroughModel(model: Model3DRefLike): {
+    output: {
+        type: string;
+        asset_id: null;
+        metadata: null;
+        data: string;
+    };
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/nodes/model3d/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/nodes/model3d/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAIzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAGrD;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;KACnD,GAAG,IAAI,CAAC;CACV,GACA,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;KACnD,GAAG,IAAI,CAAC;CACV,GACA,OAAO,CAAC,UAAU,CAAC,CAgDrB;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;EASrC;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAKzD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EAAE,GAAG,SAAS,EACnC,SAAS,EAAE,aAAa,GACvB,IAAI,CAON;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc;IAGlD,MAAM;;;;;;EAKT"}