@nodetool-ai/video-nodes 0.8.1

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

@@ -0,0 +1,177 @@
+/**
+ * Shared three.js render core for `nodetool.model3d.RenderToImage` and for
+ * the timeline's `model3d` clips.
+ *
+ * A **session** loads a GLB once and draws many frames from it
+ * (`createModel3DRenderSession`); `renderGlbToPng` is the one-frame case.
+ * Turning bytes into pixels needs a WebGL context on an `OffscreenCanvas`,
+ * so the same module runs in two hosts:
+ *
+ * - the in-browser workflow runner and the timeline preview (main thread or
+ *   worker), importing this file directly;
+ * - a headless Chromium page on the Node backend, via the esbuild bundle
+ *   `dist/render3d-page.js` (entry: `render3d-page.ts`).
+ *
+ * Editor-only clutter (grid, axes, gizmos) never exists here — the scene is
+ * built fresh from the model plus the requested lights and nothing else.
+ */
+export type LightingPreset = "studio" | "soft" | "flat";
+/**
+ * The 3D half of a timeline clip's style.
+ *
+ * These three interfaces are declared here, not imported, because
+ * `@nodetool-ai/timeline` is pure document logic and this file is the GPU
+ * side: the bundle that ships to a headless Chromium page must not pull the
+ * document package in. They are structurally identical to the
+ * `ClipModel3DCamera` / `ClipModel3DAnimation` / `ClipModel3DStyle` of
+ * `packages/timeline/src/types.ts`, so a caller assigns one to the other
+ * without a conversion.
+ */
+export type Model3DCameraMode = "orbit" | "scene";
+export interface ClipModel3DCamera {
+    /** `orbit` frames the model's bounding sphere; `scene` uses a glTF camera. */
+    mode: Model3DCameraMode;
+    /** Horizontal orbit angle around the model, degrees. 0 looks down -Z. */
+    azimuthDeg: number;
+    /** Vertical angle above the horizon, degrees. */
+    elevationDeg: number;
+    /** Vertical field of view, degrees. */
+    fovDeg: number;
+    /** Distance multiplier on the auto-framed fit: >1 closer. */
+    zoom: number;
+    /** Look-at offset from the bounding-sphere center, world units. */
+    targetOffset?: [number, number, number];
+    /** `scene` mode: the glTF camera's name; the first camera when absent. */
+    sceneCameraName?: string;
+}
+export interface ClipModel3DAnimation {
+    /** glTF animation name; every animation plays when absent. */
+    clipName?: string;
+    loop: boolean;
+    /** Playback multiplier on top of the clip's own speed / time remap. */
+    speed: number;
+}
+export interface ClipModel3DStyle {
+    camera: ClipModel3DCamera;
+    animation: ClipModel3DAnimation;
+    lighting: LightingPreset;
+    lightIntensity: number;
+    background: {
+        transparent: true;
+    } | {
+        transparent: false;
+        color: string;
+    };
+    /** A Blender render of this clip at a given style. */
+    bake?: {
+        assetId: string;
+        dependencyHash: string;
+    };
+}
+export interface Render3DOptions {
+    /** Output image width in pixels. */
+    width: number;
+    /** Output image height in pixels. */
+    height: number;
+    /** Horizontal orbit angle around the model, degrees. 0 looks down -Z. */
+    azimuthDeg: number;
+    /** Vertical angle above the horizon, degrees. 90 is straight down. */
+    elevationDeg: number;
+    /** Vertical field of view, degrees. */
+    fovDeg: number;
+    /** Camera distance multiplier on the auto-framed fit: >1 closer, <1 farther. */
+    zoom: number;
+    lighting: LightingPreset;
+    /** Multiplier applied to every light in the preset. */
+    lightIntensity: number;
+    /** CSS color for the background; ignored when `transparent` is true. */
+    backgroundColor: string;
+    transparent: boolean;
+}
+export interface Model3DRenderFrame {
+    timeSec: number;
+    /** Already folded with the animated camera channels. */
+    camera: ClipModel3DCamera;
+    width: number;
+    height: number;
+}
+export interface Model3DRenderSession {
+    /** Names of the glTF's animations and cameras, for the inspector and the validator. */
+    readonly animations: readonly string[];
+    readonly cameras: readonly string[];
+    /** Draws one frame into the session's canvas and returns it. */
+    render(frame: Model3DRenderFrame): OffscreenCanvas;
+    dispose(): void;
+}
+/**
+ * Everything a session fixes at creation. Two layers share a session only
+ * when these are equal, so the key of every pool and every headless group is
+ * `assetId` plus this object, never `assetId` alone.
+ */
+export interface Model3DSessionOptions {
+    lighting: ClipModel3DStyle["lighting"];
+    lightIntensity: number;
+    background: ClipModel3DStyle["background"];
+    animation: ClipModel3DAnimation;
+}
+interface CameraFraming {
+    /** Distance from the bounding-sphere center to the camera. */
+    distance: number;
+    near: number;
+    far: number;
+}
+/**
+ * Distance that fits a bounding sphere of `radius` fully into a camera with
+ * the given vertical fov and aspect, then applies `zoom` (>1 moves closer).
+ * Pure math, exported for tests.
+ */
+export declare function computeFraming(radius: number, fovDeg: number, aspect: number, zoom: number): CameraFraming;
+/** Spherical → cartesian offset for the orbit camera. Exported for tests. */
+export declare function orbitOffset(azimuthDeg: number, elevationDeg: number, distance: number): {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Map a clip-local animation time onto the mixer's time.
+ *
+ * With `loop` on the time wraps at `duration`; off, it clamps to the last
+ * frame. A model with no animation (`duration` 0, or a non-finite duration)
+ * has one pose, so every time maps to 0. Pure, exported for tests.
+ */
+export declare function mixerTimeFor(t: number, duration: number, loop: boolean): number;
+/**
+ * The animation clips `animation.clipName` selects: the named one, or every
+ * clip when the name is absent. Pure, exported for tests.
+ */
+export declare function selectAnimationClips<T extends {
+    name: string;
+}>(clips: readonly T[], clipName?: string): T[];
+/**
+ * The glTF camera `camera.sceneCameraName` selects, or the first one when the
+ * name is absent. Pure, exported for tests.
+ */
+export declare function selectSceneCamera<T extends {
+    name: string;
+}>(cameras: readonly T[], sceneCameraName?: string): T;
+/** The session options a one-shot `Render3DOptions` describes. */
+export declare function sessionOptionsFromRender3DOptions(options: Render3DOptions): Model3DSessionOptions;
+/** The single frame a one-shot `Render3DOptions` describes. */
+export declare function renderFrameFromRender3DOptions(options: Render3DOptions): Model3DRenderFrame;
+/**
+ * Load a model once and draw frames from it. Must run in a browser context
+ * (window or worker) with WebGL and `OffscreenCanvas`.
+ *
+ * Every option here is fixed for the session's life: a style edit that
+ * touches one of them disposes the session and creates a new one, because a
+ * mixer whose actions were rebuilt mid-session is the same picture as a fresh
+ * one and harder to prove.
+ */
+export declare function createModel3DRenderSession(glb: Uint8Array, options: Model3DSessionOptions): Promise<Model3DRenderSession>;
+/**
+ * Render GLB (or embedded-buffer glTF JSON) bytes to PNG bytes. Must run in a
+ * browser context (window or worker) with WebGL and `OffscreenCanvas`.
+ */
+export declare function renderGlbToPng(glb: Uint8Array, options: Render3DOptions): Promise<Uint8Array>;
+export {};
+//# sourceMappingURL=render3d-core.d.ts.map

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

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

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

@@ -0,0 +1,366 @@
+/// <reference lib="dom" />
+/**
+ * Shared three.js render core for `nodetool.model3d.RenderToImage` and for
+ * the timeline's `model3d` clips.
+ *
+ * A **session** loads a GLB once and draws many frames from it
+ * (`createModel3DRenderSession`); `renderGlbToPng` is the one-frame case.
+ * Turning bytes into pixels needs a WebGL context on an `OffscreenCanvas`,
+ * so the same module runs in two hosts:
+ *
+ * - the in-browser workflow runner and the timeline preview (main thread or
+ *   worker), importing this file directly;
+ * - a headless Chromium page on the Node backend, via the esbuild bundle
+ *   `dist/render3d-page.js` (entry: `render3d-page.ts`).
+ *
+ * Editor-only clutter (grid, axes, gizmos) never exists here — the scene is
+ * built fresh from the model plus the requested lights and nothing else.
+ */
+import * as THREE from "three";
+import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
+import { MeshoptDecoder } from "meshoptimizer";
+/**
+ * Distance that fits a bounding sphere of `radius` fully into a camera with
+ * the given vertical fov and aspect, then applies `zoom` (>1 moves closer).
+ * Pure math, exported for tests.
+ */
+export function computeFraming(radius, fovDeg, aspect, zoom) {
+    const safeRadius = Math.max(radius, 1e-6);
+    const vFov = (Math.max(fovDeg, 1) * Math.PI) / 180;
+    const hFov = 2 * Math.atan(Math.tan(vFov / 2) * Math.max(aspect, 1e-6));
+    const fitV = safeRadius / Math.sin(vFov / 2);
+    const fitH = safeRadius / Math.sin(hFov / 2);
+    const distance = Math.max(fitV, fitH) / Math.max(zoom, 1e-3);
+    return {
+        distance,
+        near: Math.max(distance - safeRadius * 4, distance / 100, 1e-4),
+        far: distance + safeRadius * 10
+    };
+}
+/** Spherical → cartesian offset for the orbit camera. Exported for tests. */
+export function orbitOffset(azimuthDeg, elevationDeg, distance) {
+    const az = (azimuthDeg * Math.PI) / 180;
+    const el = (Math.min(Math.max(elevationDeg, -89.9), 89.9) * Math.PI) / 180;
+    return {
+        x: distance * Math.cos(el) * Math.sin(az),
+        y: distance * Math.sin(el),
+        z: distance * Math.cos(el) * Math.cos(az)
+    };
+}
+/**
+ * Map a clip-local animation time onto the mixer's time.
+ *
+ * With `loop` on the time wraps at `duration`; off, it clamps to the last
+ * frame. A model with no animation (`duration` 0, or a non-finite duration)
+ * has one pose, so every time maps to 0. Pure, exported for tests.
+ */
+export function mixerTimeFor(t, duration, loop) {
+    if (!Number.isFinite(t))
+        return 0;
+    if (!Number.isFinite(duration) || duration <= 0)
+        return 0;
+    if (!loop)
+        return Math.min(Math.max(t, 0), duration);
+    return ((t % duration) + duration) % duration;
+}
+/**
+ * The animation clips `animation.clipName` selects: the named one, or every
+ * clip when the name is absent. Pure, exported for tests.
+ */
+export function selectAnimationClips(clips, clipName) {
+    if (clipName === undefined || clipName === "")
+        return [...clips];
+    const found = clips.filter((clip) => clip.name === clipName);
+    if (found.length > 0)
+        return found;
+    throw new Error(clips.length === 0
+        ? `Model3D render: animation "${clipName}" is not in this model — it has no animations`
+        : `Model3D render: animation "${clipName}" is not in this model — available animations: ${clips
+            .map((clip) => clip.name)
+            .join(", ")}`);
+}
+/**
+ * The glTF camera `camera.sceneCameraName` selects, or the first one when the
+ * name is absent. Pure, exported for tests.
+ */
+export function selectSceneCamera(cameras, sceneCameraName) {
+    if (cameras.length === 0) {
+        throw new Error("Model3D render: camera mode is \"scene\" but this model has no cameras — use orbit mode");
+    }
+    if (sceneCameraName === undefined || sceneCameraName === "") {
+        return cameras[0];
+    }
+    const found = cameras.find((camera) => camera.name === sceneCameraName);
+    if (found)
+        return found;
+    throw new Error(`Model3D render: camera "${sceneCameraName}" is not in this model — available cameras: ${cameras
+        .map((camera) => camera.name)
+        .join(", ")}`);
+}
+/**
+ * Build the preset's lights into `scene`. Key/fill/rim ride along with the
+ * camera azimuth so the visible side of the model is always lit, whatever
+ * angle the user picked — `aim` is what puts them there.
+ */
+function createLightRig(scene, preset, intensity) {
+    const scaled = (base) => base * intensity;
+    const directionals = [];
+    let hemisphere = null;
+    const placeDirectional = (color, lightIntensity, direction) => {
+        const light = new THREE.DirectionalLight(color, lightIntensity);
+        scene.add(light);
+        scene.add(light.target);
+        directionals.push({ light, direction });
+    };
+    switch (preset) {
+        case "studio": {
+            scene.add(new THREE.AmbientLight(0xffffff, scaled(0.5)));
+            placeDirectional(0xffffff, scaled(2.2), (toCamera, side, up) => toCamera
+                .clone()
+                .add(side.clone().multiplyScalar(0.8))
+                .add(up.clone().multiplyScalar(0.9)));
+            placeDirectional(0xffffff, scaled(0.8), (toCamera, side, up) => toCamera
+                .clone()
+                .sub(side.clone().multiplyScalar(1.1))
+                .add(up.clone().multiplyScalar(0.2)));
+            placeDirectional(0xffffff, scaled(1.4), (toCamera, _side, up) => toCamera.clone().negate().add(up.clone().multiplyScalar(1.2)));
+            break;
+        }
+        case "soft": {
+            hemisphere = new THREE.HemisphereLight(0xffffff, 0x555566, scaled(1.6));
+            scene.add(hemisphere);
+            placeDirectional(0xffffff, scaled(0.9), (toCamera, _side, up) => toCamera.clone().add(up));
+            break;
+        }
+        case "flat":
+            scene.add(new THREE.AmbientLight(0xffffff, scaled(3)));
+            break;
+    }
+    return {
+        aim(cameraPosition, target) {
+            const toCamera = cameraPosition.clone().sub(target).normalize();
+            const up = new THREE.Vector3(0, 1, 0);
+            const side = new THREE.Vector3().crossVectors(up, toCamera).normalize();
+            if (side.lengthSq() < 1e-6)
+                side.set(1, 0, 0);
+            for (const entry of directionals) {
+                entry.light.position
+                    .copy(target)
+                    .add(entry.direction(toCamera, side, up));
+                entry.light.target.position.copy(target);
+            }
+            if (hemisphere)
+                hemisphere.position.copy(target).add(up);
+        }
+    };
+}
+function disposeMaterial(material) {
+    for (const value of Object.values(material)) {
+        if (value instanceof THREE.Texture)
+            value.dispose();
+    }
+    material.dispose();
+}
+function disposeScene(scene) {
+    scene.traverse((object) => {
+        const mesh = object;
+        if (mesh.geometry)
+            mesh.geometry.dispose();
+        const material = mesh.material;
+        if (Array.isArray(material)) {
+            material.forEach(disposeMaterial);
+        }
+        else if (material) {
+            disposeMaterial(material);
+        }
+    });
+}
+function toArrayBuffer(bytes) {
+    // GLTFLoader wants an ArrayBuffer that starts at offset 0.
+    return bytes.buffer instanceof ArrayBuffer &&
+        bytes.byteOffset === 0 &&
+        bytes.byteLength === bytes.buffer.byteLength
+        ? bytes.buffer
+        : bytes.slice().buffer;
+}
+/** The session options a one-shot `Render3DOptions` describes. */
+export function sessionOptionsFromRender3DOptions(options) {
+    return {
+        lighting: options.lighting,
+        lightIntensity: options.lightIntensity,
+        background: options.transparent
+            ? { transparent: true }
+            : { transparent: false, color: options.backgroundColor },
+        animation: { loop: false, speed: 1 }
+    };
+}
+/** The single frame a one-shot `Render3DOptions` describes. */
+export function renderFrameFromRender3DOptions(options) {
+    return {
+        timeSec: 0,
+        width: options.width,
+        height: options.height,
+        camera: {
+            mode: "orbit",
+            azimuthDeg: options.azimuthDeg,
+            elevationDeg: options.elevationDeg,
+            fovDeg: options.fovDeg,
+            zoom: options.zoom
+        }
+    };
+}
+/**
+ * Load a model once and draw frames from it. Must run in a browser context
+ * (window or worker) with WebGL and `OffscreenCanvas`.
+ *
+ * Every option here is fixed for the session's life: a style edit that
+ * touches one of them disposes the session and creates a new one, because a
+ * mixer whose actions were rebuilt mid-session is the same picture as a fresh
+ * one and harder to prove.
+ */
+export async function createModel3DRenderSession(glb, options) {
+    if (typeof OffscreenCanvas === "undefined") {
+        throw new Error("RenderToImage needs a browser context with OffscreenCanvas support");
+    }
+    const loader = new GLTFLoader();
+    await MeshoptDecoder.ready;
+    loader.setMeshoptDecoder(MeshoptDecoder);
+    const gltf = await loader.parseAsync(toArrayBuffer(glb), "");
+    const scene = new THREE.Scene();
+    scene.add(gltf.scene);
+    // Resolve the world matrix before measuring, or the box is stale.
+    scene.updateMatrixWorld(true);
+    const box = new THREE.Box3().setFromObject(gltf.scene);
+    if (box.isEmpty()) {
+        disposeScene(scene);
+        throw new Error("RenderToImage: the model contains no visible geometry");
+    }
+    // The framing sphere is the model's rest pose, so a camera does not drift
+    // as the animation moves the geometry.
+    const sphere = box.getBoundingSphere(new THREE.Sphere());
+    const sceneCameras = gltf.cameras;
+    const selected = selectAnimationClips(gltf.animations, options.animation.clipName);
+    const duration = selected.reduce((longest, clip) => Math.max(longest, clip.duration), 0);
+    const loop = options.animation.loop;
+    const mixer = selected.length > 0 ? new THREE.AnimationMixer(gltf.scene) : null;
+    const actions = [];
+    if (mixer) {
+        for (const clip of selected) {
+            const action = mixer.clipAction(clip);
+            if (loop) {
+                action.setLoop(THREE.LoopRepeat, Infinity);
+            }
+            else {
+                // LoopOnce holds the last frame at exactly `duration`; LoopRepeat
+                // would wrap it back to 0 there.
+                action.setLoop(THREE.LoopOnce, 1);
+                action.clampWhenFinished = true;
+            }
+            action.play();
+            actions.push(action);
+        }
+    }
+    const rig = createLightRig(scene, options.lighting, options.lightIntensity);
+    if (!options.background.transparent) {
+        scene.background = new THREE.Color(options.background.color);
+    }
+    const canvas = new OffscreenCanvas(1, 1);
+    const renderer = new THREE.WebGLRenderer({
+        canvas,
+        antialias: true,
+        alpha: true,
+        preserveDrawingBuffer: true
+    });
+    renderer.toneMapping = THREE.NeutralToneMapping;
+    renderer.outputColorSpace = THREE.SRGBColorSpace;
+    if (options.background.transparent) {
+        renderer.setClearColor(0x000000, 0);
+    }
+    const orbitCamera = new THREE.PerspectiveCamera();
+    const target = new THREE.Vector3();
+    const eye = new THREE.Vector3();
+    let disposed = false;
+    return {
+        animations: gltf.animations.map((clip) => clip.name),
+        cameras: sceneCameras.map((camera) => camera.name),
+        render(frame) {
+            if (disposed) {
+                throw new Error("Model3D render: this session is already disposed");
+            }
+            const width = Math.max(1, Math.round(frame.width));
+            const height = Math.max(1, Math.round(frame.height));
+            const aspect = width / height;
+            if (mixer) {
+                // Reset before every frame so a render depends only on its own time:
+                // a scrub backwards, or one past a non-looping clip's end, draws the
+                // same picture whatever was drawn before it.
+                for (const action of actions)
+                    action.reset();
+                mixer.setTime(mixerTimeFor(frame.timeSec, duration, loop));
+            }
+            scene.updateMatrixWorld(true);
+            target.copy(sphere.center);
+            if (frame.camera.targetOffset) {
+                target.x += frame.camera.targetOffset[0];
+                target.y += frame.camera.targetOffset[1];
+                target.z += frame.camera.targetOffset[2];
+            }
+            let camera;
+            if (frame.camera.mode === "scene") {
+                const sceneCamera = selectSceneCamera(sceneCameras, frame.camera.sceneCameraName);
+                if (sceneCamera instanceof THREE.PerspectiveCamera) {
+                    sceneCamera.aspect = aspect;
+                    sceneCamera.updateProjectionMatrix();
+                }
+                sceneCamera.getWorldPosition(eye);
+                camera = sceneCamera;
+            }
+            else {
+                const framing = computeFraming(sphere.radius, frame.camera.fovDeg, aspect, frame.camera.zoom);
+                const offset = orbitOffset(frame.camera.azimuthDeg, frame.camera.elevationDeg, framing.distance);
+                orbitCamera.fov = frame.camera.fovDeg;
+                orbitCamera.aspect = aspect;
+                orbitCamera.near = framing.near;
+                orbitCamera.far = framing.far;
+                orbitCamera.updateProjectionMatrix();
+                orbitCamera.position.set(target.x + offset.x, target.y + offset.y, target.z + offset.z);
+                orbitCamera.lookAt(target);
+                orbitCamera.updateMatrixWorld(true);
+                eye.copy(orbitCamera.position);
+                camera = orbitCamera;
+            }
+            rig.aim(eye, target);
+            renderer.setSize(width, height, false);
+            renderer.render(scene, camera);
+            return canvas;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            if (mixer) {
+                mixer.stopAllAction();
+                mixer.uncacheRoot(gltf.scene);
+            }
+            disposeScene(scene);
+            renderer.dispose();
+            renderer.forceContextLoss();
+        }
+    };
+}
+/**
+ * Render GLB (or embedded-buffer glTF JSON) bytes to PNG bytes. Must run in a
+ * browser context (window or worker) with WebGL and `OffscreenCanvas`.
+ */
+export async function renderGlbToPng(glb, options) {
+    const session = await createModel3DRenderSession(glb, sessionOptionsFromRender3DOptions(options));
+    try {
+        const canvas = session.render(renderFrameFromRender3DOptions(options));
+        const blob = await canvas.convertToBlob({ type: "image/png" });
+        return new Uint8Array(await blob.arrayBuffer());
+    }
+    finally {
+        session.dispose();
+    }
+}
+//# sourceMappingURL=render3d-core.js.map

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

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

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

@@ -0,0 +1,75 @@
+/**
+ * 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 { type Model3DRenderFrame, type Model3DSessionOptions, type Render3DOptions } from "./render3d-core.js";
+interface RuntimeEvaluateResult {
+    result?: {
+        type?: string;
+        value?: unknown;
+    };
+    exceptionDetails?: {
+        text?: string;
+        exception?: {
+            description?: string;
+            value?: unknown;
+        };
+    };
+}
+interface CdpClient {
+    Runtime: {
+        /** CDP commands with no return parameters resolve to an empty object. */
+        enable(): Promise<object>;
+        evaluate(params: {
+            expression: string;
+            awaitPromise?: boolean;
+            returnByValue?: boolean;
+        }): Promise<RuntimeEvaluateResult>;
+    };
+    close(): Promise<void>;
+}
+/**
+ * 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 declare function connectCdp(port: number, { timeoutMs, retryMs }?: {
+    retryMs?: number | undefined;
+    timeoutMs?: number | undefined;
+}): Promise<CdpClient>;
+/**
+ * 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 declare function launchChromeWithRetry<T>(launch: () => Promise<T>, retryDelayMs?: number): Promise<T>;
+/**
+ * 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 declare function renderGlbFramesHeadless(glb: Uint8Array, options: Model3DSessionOptions, frames: readonly Model3DRenderFrame[]): Promise<Uint8Array[]>;
+/** Render GLB bytes to PNG bytes: the one-frame case of the above. */
+export declare function renderGlbHeadless(glb: Uint8Array, options: Render3DOptions): Promise<Uint8Array>;
+export {};
+//# sourceMappingURL=render3d-headless.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render3d-headless.d.ts","sourceRoot":"","sources":["../../../src/nodes/model3d/render3d-headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AA0B5B,UAAU,qBAAqB;IAC7B,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,gBAAgB,CAAC,EAAE;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACvD,CAAC;CACH;AAED,UAAU,SAAS;IACjB,OAAO,EAAE;QACP,yEAAyE;QACzE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,CAAC,EAAE,OAAO,CAAC;YACvB,aAAa,CAAC,EAAE,OAAO,CAAC;SACzB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACpC,CAAC;IACF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyDD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,SAAkC,EAAE,OAA8B,EAAE;;;CAAK,GAC1E,OAAO,CAAC,SAAS,CAAC,CA2BpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,YAAY,SAAQ,GACnB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC,CAgEvB;AAED,sEAAsE;AACtE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,UAAU,CAAC,CAOrB"}