@flighthq/scene3d 0.2.1-next.840.857425c

package/dist/billboard.d.ts

@@ -0,0 +1,8 @@
+import type { Billboard, BillboardMode, BillboardRuntime, Kind, Material, MeshGeometry, NodeSignals, Node3D } from '@flighthq/types';
+export { BillboardKind } from '@flighthq/types';
+export declare function createBillboard(geometry: MeshGeometry, materials: (Material | null)[], mode?: BillboardMode, kind?: Kind, obj?: Readonly<Partial<Pick<Billboard, 'enabled' | 'name'>>>): Billboard;
+export declare function enableBillboardSignals(source: Billboard): NodeSignals;
+export declare function getBillboardRuntime(source: Readonly<Billboard>): BillboardRuntime;
+export declare function getBillboardSignals(source: Billboard): NodeSignals | null;
+export declare function isBillboard(source: Readonly<Node3D>): source is Billboard;
+//# sourceMappingURL=billboard.d.ts.map

package/dist/billboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billboard.d.ts","sourceRoot":"","sources":["../src/billboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,MAAM,EACP,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAehD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EAC9B,IAAI,GAAE,aAAsB,EAC5B,IAAI,GAAE,IAAoB,EAC1B,GAAG,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAC3D,SAAS,CAMX;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAErE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,gBAAgB,CAEjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,IAAI,CAEzE;AAKD,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,SAAS,CAGzE"}

package/dist/billboard.js

@@ -0,0 +1,41 @@
+import { enableNodeSignals, getNodeSignals } from '@flighthq/node';
+import { BillboardKind } from '@flighthq/types';
+import { createNode3D, getNode3DRuntime } from './sceneNode';
+export { BillboardKind } from '@flighthq/types';
+// Allocates a camera-facing Billboard node: a Node3D (so it shares the scene hierarchy with mesh
+// and group nodes) carrying `geometry`, one `materials` entry per geometry subset (positional; a
+// missing or null slot resolves to DefaultMaterialKind at draw time), and a facing `mode`. Because a
+// Billboard carries geometry it is structurally a drawable leaf (isMesh) and is drawn by the same
+// per-material mesh renderers as a Mesh on every backend — the only billboard-specific step is the
+// per-frame facing pass (orientBillboardToCamera / orientScene3DBillboardsToCamera), which rewrites
+// the node's transform so its local axes face the camera before drawing.
+//
+// Facing convention: the geometry is authored in the local XY plane facing local +Z. The facing pass
+// orients local +X to screen-right, local +Y to screen-up, and local +Z toward the camera. `geometry`
+// and `materials` are stored by reference, not copied. The node starts with an identity localMatrix
+// (unit scale at the origin) until placed and oriented; its authored position and scale are the world
+// translation and scale the facing pass preserves.
+export function createBillboard(geometry, materials, mode = 'full', kind = BillboardKind, obj) {
+    const billboard = createNode3D(kind, obj);
+    billboard.geometry = geometry;
+    billboard.materials = materials;
+    billboard.mode = mode;
+    return billboard;
+}
+export function enableBillboardSignals(source) {
+    return enableNodeSignals(source);
+}
+export function getBillboardRuntime(source) {
+    return getNode3DRuntime(source);
+}
+export function getBillboardSignals(source) {
+    return getNodeSignals(source);
+}
+// A node is a Billboard — a camera-facing drawable — when it carries both geometry (making it a
+// drawable leaf) and a facing `mode`. Structural, so it holds for Billboards created with a custom
+// kind, not just BillboardKind, and distinguishes a Billboard from a plain Mesh (geometry, no mode).
+export function isBillboard(source) {
+    const candidate = source;
+    return candidate.geometry != null && candidate.mode != null;
+}
+//# sourceMappingURL=billboard.js.map

package/dist/billboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billboard.js","sourceRoot":"","sources":["../src/billboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAWnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,iGAAiG;AACjG,iGAAiG;AACjG,qGAAqG;AACrG,kGAAkG;AAClG,mGAAmG;AACnG,oGAAoG;AACpG,yEAAyE;AACzE,EAAE;AACF,qGAAqG;AACrG,sGAAsG;AACtG,oGAAoG;AACpG,sGAAsG;AACtG,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAC7B,QAAsB,EACtB,SAA8B,EAC9B,OAAsB,MAAM,EAC5B,OAAa,aAAa,EAC1B,GAA4D;IAE5D,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAc,CAAC;IACvD,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC;IACtB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,gGAAgG;AAChG,mGAAmG;AACnG,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,MAAM,SAAS,GAAG,MAA4B,CAAC;IAC/C,OAAO,SAAS,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC;AAC9D,CAAC"}

package/dist/billboardCamera.d.ts

@@ -0,0 +1,4 @@
+import type { Billboard, Camera3D, Node3D } from '@flighthq/types';
+export declare function orientBillboardToCamera(billboard: Billboard, camera: Readonly<Camera3D>): void;
+export declare function orientScene3DBillboardsToCamera(scene: Readonly<Node3D>, camera: Readonly<Camera3D>): void;
+//# sourceMappingURL=billboardCamera.d.ts.map

package/dist/billboardCamera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billboardCamera.d.ts","sourceRoot":"","sources":["../src/billboardCamera.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAiB,QAAQ,EAAW,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAc3F,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAG9F;AAOD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAGzG"}

package/dist/billboardCamera.js

@@ -0,0 +1,238 @@
+import { copyMatrix4, createMatrix4, createQuaternion, createVector3, decomposeMatrix4, inverseMatrix4, multiplyMatrix4, } from '@flighthq/geometry';
+import { getNodeParent, getNodeWorldMatrix4, setNodeLocalMatrix4 } from '@flighthq/node';
+import { isBillboard } from './billboard';
+import { getNode3DRuntime } from './sceneNode';
+// Orients a single Billboard to face `camera`, rewriting its localMatrix so that after the scene's
+// world transforms resolve, the billboard's world axes face the camera per its `mode`. The
+// billboard's world position and world scale are preserved (read from its current world matrix); only
+// the rotation is replaced. The result is backend-agnostic: the billboard then draws through the same
+// per-material mesh renderers as any Mesh, on every backend, with no billboard-specific draw path.
+//
+// Call once per frame per billboard after the camera's view matrix is set and before drawing. For a
+// whole subtree, orientScene3DBillboardsToCamera walks and orients every Billboard in one pass, deriving
+// the camera basis a single time.
+export function orientBillboardToCamera(billboard, camera) {
+    setBillboardCameraBasis(camera);
+    applyBillboardFacing(billboard);
+}
+// Orients every Billboard in the subtree rooted at `scene` to face `camera` in one pass. Non-billboard
+// nodes are skipped (but still traversed, so billboards nested under group/mesh nodes are found). The
+// camera basis is derived once and reused across every billboard. Parents are oriented before their
+// descendants (top-down), so a billboard nested under another billboard sees its parent's updated
+// transform.
+export function orientScene3DBillboardsToCamera(scene, camera) {
+    setBillboardCameraBasis(camera);
+    orientBillboardSubtree(scene);
+}
+// Rewrites `billboard.localMatrix` from the module-scratch camera basis (set by setBillboardCameraBasis)
+// so the billboard's world transform faces the camera. Reads the billboard's current world matrix for
+// its world position and scale, builds the facing world matrix, then converts it back through the
+// parent's inverse world transform into a local matrix (identity parent when the billboard is a root).
+function applyBillboardFacing(billboard) {
+    const world = getNodeWorldMatrix4(billboard);
+    decomposeMatrix4(_position, _rotationScratch, _scale, world);
+    writeBillboardFacingMatrix(_facingWorld, billboard.mode);
+    const parent = getNodeParent(billboard);
+    if (parent === null) {
+        copyMatrix4(_localScratch, _facingWorld);
+    }
+    else {
+        const parentWorld = getNodeWorldMatrix4(parent);
+        if (inverseMatrix4(_inverseParentWorld, parentWorld)) {
+            multiplyMatrix4(_localScratch, _inverseParentWorld, _facingWorld);
+        }
+        else {
+            // Degenerate (non-invertible) parent world: fall back to treating the facing matrix as local.
+            copyMatrix4(_localScratch, _facingWorld);
+        }
+    }
+    // A billboard orients by a computed matrix, not TRS, so author it directly (leaves the node detached).
+    setNodeLocalMatrix4(billboard, _localScratch);
+}
+function orientBillboardSubtree(node) {
+    if (isBillboard(node)) {
+        applyBillboardFacing(node);
+    }
+    const children = getNode3DRuntime(node).children;
+    if (children !== null) {
+        for (let i = 0; i < children.length; i++) {
+            orientBillboardSubtree(children[i]);
+        }
+    }
+}
+// Derives the camera's world-space eye position and orthonormal right/up/back basis from its view
+// matrix (view is world->view; its inverse is the camera's world transform) into module scratch. The
+// basis vectors are normalized so a camera with a scaled view still yields a rotation-only billboard
+// basis. `_back` is the camera's +Z world axis (toward the viewer), which is the facing normal a
+// screen-aligned billboard adopts.
+function setBillboardCameraBasis(camera) {
+    inverseMatrix4(_cameraWorld, camera.view);
+    const m = _cameraWorld.m;
+    _cameraEyeX = m[12];
+    _cameraEyeY = m[13];
+    _cameraEyeZ = m[14];
+    _cameraRightX = m[0];
+    _cameraRightY = m[1];
+    _cameraRightZ = m[2];
+    _cameraUpX = m[4];
+    _cameraUpY = m[5];
+    _cameraUpZ = m[6];
+    _cameraBackX = m[8];
+    _cameraBackY = m[9];
+    _cameraBackZ = m[10];
+    const rl = Math.hypot(_cameraRightX, _cameraRightY, _cameraRightZ) || 1;
+    _cameraRightX /= rl;
+    _cameraRightY /= rl;
+    _cameraRightZ /= rl;
+    const ul = Math.hypot(_cameraUpX, _cameraUpY, _cameraUpZ) || 1;
+    _cameraUpX /= ul;
+    _cameraUpY /= ul;
+    _cameraUpZ /= ul;
+    const bl = Math.hypot(_cameraBackX, _cameraBackY, _cameraBackZ) || 1;
+    _cameraBackX /= bl;
+    _cameraBackY /= bl;
+    _cameraBackZ /= bl;
+}
+// Writes a camera-facing world matrix into `out` from the module-scratch camera basis, the billboard's
+// world position (`_position`) and scale (`_scale`), and its facing `mode`. Local +X maps to the
+// billboard's right axis, +Y to its up axis, and +Z to its facing normal (toward the camera):
+//   - 'full'         spherical: normal points at the camera eye, up derived from the camera's up.
+//   - 'axisY'        cylindrical: yaws about world +Y to face the camera horizontally, staying upright.
+//   - 'screenAligned' planar: adopts the camera's right/up/back basis, so every billboard is coplanar
+//                     with the view plane regardless of position.
+function writeBillboardFacingMatrix(out, mode) {
+    const px = _position.x;
+    const py = _position.y;
+    const pz = _position.z;
+    const sx = _scale.x;
+    const sy = _scale.y;
+    const sz = _scale.z;
+    let rx;
+    let ry;
+    let rz;
+    let ux;
+    let uy;
+    let uz;
+    let nx;
+    let ny;
+    let nz;
+    if (mode === 'screenAligned') {
+        rx = _cameraRightX;
+        ry = _cameraRightY;
+        rz = _cameraRightZ;
+        ux = _cameraUpX;
+        uy = _cameraUpY;
+        uz = _cameraUpZ;
+        nx = _cameraBackX;
+        ny = _cameraBackY;
+        nz = _cameraBackZ;
+    }
+    else if (mode === 'axisY') {
+        // Face the camera horizontally: normal is the eye direction projected onto the world XZ plane,
+        // up is locked to world +Y so the billboard never tilts.
+        let dx = _cameraEyeX - px;
+        let dz = _cameraEyeZ - pz;
+        let dl = Math.hypot(dx, dz);
+        if (dl < FACING_EPSILON) {
+            // Camera3D is directly above/below: fall back to the camera back-axis projected onto XZ.
+            dx = _cameraBackX;
+            dz = _cameraBackZ;
+            dl = Math.hypot(dx, dz);
+            if (dl < FACING_EPSILON) {
+                dx = 0;
+                dz = 1;
+                dl = 1;
+            }
+        }
+        nx = dx / dl;
+        ny = 0;
+        nz = dz / dl;
+        // right = up x normal = (0,1,0) x (nx,0,nz) = (nz, 0, -nx).
+        rx = nz;
+        ry = 0;
+        rz = -nx;
+        ux = 0;
+        uy = 1;
+        uz = 0;
+    }
+    else {
+        // 'full' spherical: normal points from the billboard toward the camera eye.
+        let dnx = _cameraEyeX - px;
+        let dny = _cameraEyeY - py;
+        let dnz = _cameraEyeZ - pz;
+        let dnl = Math.hypot(dnx, dny, dnz);
+        if (dnl < FACING_EPSILON) {
+            dnx = _cameraBackX;
+            dny = _cameraBackY;
+            dnz = _cameraBackZ;
+            dnl = Math.hypot(dnx, dny, dnz) || 1;
+        }
+        nx = dnx / dnl;
+        ny = dny / dnl;
+        nz = dnz / dnl;
+        // right = normalize(cameraUp x normal).
+        rx = _cameraUpY * nz - _cameraUpZ * ny;
+        ry = _cameraUpZ * nx - _cameraUpX * nz;
+        rz = _cameraUpX * ny - _cameraUpY * nx;
+        let rl = Math.hypot(rx, ry, rz);
+        if (rl < FACING_EPSILON) {
+            // cameraUp parallel to normal: derive right from the camera right axis, orthogonalized to normal.
+            const d = _cameraRightX * nx + _cameraRightY * ny + _cameraRightZ * nz;
+            rx = _cameraRightX - d * nx;
+            ry = _cameraRightY - d * ny;
+            rz = _cameraRightZ - d * nz;
+            rl = Math.hypot(rx, ry, rz);
+            if (rl < FACING_EPSILON) {
+                rx = 1;
+                ry = 0;
+                rz = 0;
+                rl = 1;
+            }
+        }
+        rx /= rl;
+        ry /= rl;
+        rz /= rl;
+        // up = normal x right (already orthonormal).
+        ux = ny * rz - nz * ry;
+        uy = nz * rx - nx * rz;
+        uz = nx * ry - ny * rx;
+    }
+    const m = out.m;
+    m[0] = rx * sx;
+    m[1] = ry * sx;
+    m[2] = rz * sx;
+    m[3] = 0;
+    m[4] = ux * sy;
+    m[5] = uy * sy;
+    m[6] = uz * sy;
+    m[7] = 0;
+    m[8] = nx * sz;
+    m[9] = ny * sz;
+    m[10] = nz * sz;
+    m[11] = 0;
+    m[12] = px;
+    m[13] = py;
+    m[14] = pz;
+    m[15] = 1;
+}
+const FACING_EPSILON = 1e-6;
+const _cameraWorld = createMatrix4();
+const _inverseParentWorld = createMatrix4();
+const _facingWorld = createMatrix4();
+const _localScratch = createMatrix4();
+const _position = createVector3();
+const _scale = createVector3();
+const _rotationScratch = createQuaternion(0, 0, 0, 1);
+let _cameraEyeX = 0;
+let _cameraEyeY = 0;
+let _cameraEyeZ = 0;
+let _cameraRightX = 1;
+let _cameraRightY = 0;
+let _cameraRightZ = 0;
+let _cameraUpX = 0;
+let _cameraUpY = 1;
+let _cameraUpZ = 0;
+let _cameraBackX = 0;
+let _cameraBackY = 0;
+let _cameraBackZ = 1;
+//# sourceMappingURL=billboardCamera.js.map

package/dist/billboardCamera.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './billboard';
+export * from './billboardCamera';
+export * from './mesh';
+export * from './prepareScene3DMorph';
+export * from './scene';
+export * from './sceneAnimation';
+export * from './sceneDocument';
+export * from './sceneMaterial';
+export * from './sceneNode';
+export * from './sceneNodeAppearance';
+export * from './sceneNodeBounds';
+export * from './sceneNodeCulling';
+export * from './sceneNodeDispose';
+export * from './sceneNodeTransform';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './billboard';
+export * from './billboardCamera';
+export * from './mesh';
+export * from './prepareScene3DMorph';
+export * from './scene';
+export * from './sceneAnimation';
+export * from './sceneDocument';
+export * from './sceneMaterial';
+export * from './sceneNode';
+export * from './sceneNodeAppearance';
+export * from './sceneNodeBounds';
+export * from './sceneNodeCulling';
+export * from './sceneNodeDispose';
+export * from './sceneNodeTransform';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/mesh.d.ts

@@ -0,0 +1,10 @@
+import type { Kind, Material, Mesh, MeshDeformer, MeshGeometry, MeshRuntime, NodeSignals } from '@flighthq/types';
+export { MeshKind } from '@flighthq/types';
+export declare function cloneMesh(source: Readonly<Mesh>): Mesh;
+export declare function createMesh(geometry: MeshGeometry, materials: (Material | null)[], kind?: Kind, obj?: Readonly<Partial<Pick<Mesh, 'enabled' | 'name'>>>): Mesh;
+export declare function enableMeshSignals(source: Mesh): NodeSignals;
+export declare function getMeshDeformer(source: Readonly<Mesh>): MeshDeformer;
+export declare function getMeshRuntime(source: Readonly<Mesh>): MeshRuntime;
+export declare function getMeshSignals(source: Mesh): NodeSignals | null;
+export declare function isMesh(source: any): source is Mesh;
+//# sourceMappingURL=mesh.d.ts.map

package/dist/mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.d.ts","sourceRoot":"","sources":["../src/mesh.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKlH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAY3C,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAgBtD;AAOD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EAC9B,IAAI,GAAE,IAAe,EACrB,GAAG,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GACtD,IAAI,CAKN;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,CAE3D;AAQD,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAIpE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAElE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,IAAI,CAE/D;AAKD,wBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,IAAI,CAGlD"}

package/dist/mesh.js

@@ -0,0 +1,75 @@
+import { cloneMeshGeometryForDeformation } from '@flighthq/mesh';
+import { enableNodeSignals, getNodeLocalMatrix4, getNodeSignals, isNodeLocalMatrix4Detached, setNodeLocalMatrix4, setNodeTransform3D, } from '@flighthq/node';
+import { MeshDeformerMorph, MeshDeformerNone, MeshDeformerSkeletal, MeshKind } from '@flighthq/types';
+import { createNode3D, getNode3DRuntime } from './sceneNode';
+export { MeshKind } from '@flighthq/types';
+// Clones a Mesh node: a new node carrying a COPY of the source's transform. Rigid clones share their
+// geometry; a mesh carrying morph or skin gets a restored, runtime-independent geometry because CPU
+// deformation writes vertices in place. Morph targets remain shared immutable data while the live
+// weight array is copied. Skin/skeleton pose is still shared explicitly; callers wanting an
+// independent rig clone its joint hierarchy and Skeleton3D separately. `alpha`, `enabled`, `name`,
+// and `kind` are copied. Only the mesh node itself is cloned;
+// its children are not (a Mesh is a drawable leaf — clone each node you need explicitly). There is
+// no general cloneNode3D: not every node kind can be duplicated (some own GPU/native resources
+// or runtime bindings that cannot alias), so cloning is a per-type capability, defined here where
+// it is well-formed.
+export function cloneMesh(source) {
+    const hasDeformation = source.skin != null || source.morph != null;
+    const geometry = hasDeformation ? cloneMeshGeometryForDeformation(source.geometry) : source.geometry;
+    const clone = createMesh(geometry, source.materials.slice(), source.kind, {
+        enabled: source.enabled,
+        name: source.name,
+    });
+    clone.alpha = source.alpha;
+    // Copy the authored TRS; if the source authored its matrix directly, carry that detached matrix too.
+    setNodeTransform3D(clone, source);
+    if (isNodeLocalMatrix4Detached(source))
+        setNodeLocalMatrix4(clone, getNodeLocalMatrix4(source));
+    if (source.skin != null)
+        clone.skin = source.skin;
+    if (source.morph != null) {
+        clone.morph = { targets: source.morph.targets, weights: new Float32Array(source.morph.weights) };
+    }
+    return clone;
+}
+// Allocates a renderable Mesh node: a Node3D (so it shares the scene hierarchy with group nodes
+// and other meshes) carrying `geometry` and one `materials` entry per geometry subset (indexed
+// positionally; a missing or null slot resolves to DefaultMaterialKind at draw time). The node has
+// an identity localMatrix — its model matrix once placed in the hierarchy — and no children.
+// `geometry` and `materials` are stored by reference, not copied.
+export function createMesh(geometry, materials, kind = MeshKind, obj) {
+    const mesh = createNode3D(kind, obj);
+    mesh.geometry = geometry;
+    mesh.materials = materials;
+    return mesh;
+}
+export function enableMeshSignals(source) {
+    return enableNodeSignals(source);
+}
+// The deformer a mesh runs each frame, derived from which deform field is populated: 'skeletal' when
+// it carries a skin, 'morph' when it carries a morph target set, 'none' when neither (rigid). A mesh
+// carrying both (corrective morph over skinning) reports 'skeletal' — the skin is the outer deform,
+// applied over the morph-blended base (see updateMeshMorph then updateMeshSkin) — so this single tag
+// names the outermost deform for a renderer or bounds pass; query mesh.skin/mesh.morph directly for the
+// composed case. Renderers branch on this rather than duplicating the field checks.
+export function getMeshDeformer(source) {
+    if (source.skin != null)
+        return MeshDeformerSkeletal;
+    if (source.morph != null)
+        return MeshDeformerMorph;
+    return MeshDeformerNone;
+}
+export function getMeshRuntime(source) {
+    return getNode3DRuntime(source);
+}
+export function getMeshSignals(source) {
+    return getNodeSignals(source);
+}
+// A node is a Mesh — a drawable leaf, not a transform-only group — when it carries geometry.
+// Robust across custom kinds (a Mesh need not use MeshKind), so the scene render pass discriminates
+// by this rather than by kind symbol.
+export function isMesh(source) {
+    // eslint-disable-line
+    return source.geometry != null;
+}
+//# sourceMappingURL=mesh.js.map

package/dist/mesh.js.map

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

package/dist/prepareScene3DMorph.d.ts

@@ -0,0 +1,3 @@
+import type { NodeAny } from '@flighthq/types';
+export declare function prepareScene3DMorph(scene: Readonly<NodeAny>): void;
+//# sourceMappingURL=prepareScene3DMorph.d.ts.map

package/dist/prepareScene3DMorph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareScene3DMorph.d.ts","sourceRoot":"","sources":["../src/prepareScene3DMorph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAkBrD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAclE"}

package/dist/prepareScene3DMorph.js

@@ -0,0 +1,34 @@
+import { updateMeshMorph } from '@flighthq/mesh';
+import { getNodeRuntime } from '@flighthq/node';
+// Blends every enabled morphed mesh in the subtree rooted at `scene` for the current weights — the
+// per-frame morph-prep pass. Call it BEFORE prepareScene3DRender: the morph writes into geometry.vertices
+// and bumps the version, so the render prepare pass then culls against the freshly-morphed bounds (via
+// ensureMeshGeometryBounds) and the GL backend re-uploads the deformed buffer.
+//
+// For morph there is no separate GPU deform, so this render-prep pass IS the CPU blend — unlike skin,
+// where the GPU poses in-shader and prepare only readies the palette + a posed-bounds slot. That is why
+// a morphed mesh needs no deformedLocalBounds slot: the blend writes real vertices, so the geometry's
+// own bounds already describe its current pose. updateMeshMorph is itself dirty-gated, so a settled
+// morph over a whole scene costs one weight-vector compare per mesh and no reblend.
+//
+// This lives in @flighthq/scene3d, not @flighthq/skeleton3d, so a morph-only app (e.g. an MD2 model) never
+// imports the skinning package to animate blend shapes — the skin pass (prepareScene3DSkinning) is a
+// separate call a skinned app makes, and the two deformers' consumers stay independent. The walk needs
+// only @flighthq/node + @flighthq/mesh (both already scene dependencies). A scene with no morphed meshes
+// may skip this call; it is a no-op for non-morphed meshes, and disabled subtrees are skipped whole.
+export function prepareScene3DMorph(scene) {
+    if (!scene.enabled)
+        return;
+    // Structural mesh test (carries geometry), so it holds for meshes created with a custom kind — the
+    // same discrimination the render walk uses.
+    const mesh = scene;
+    if (mesh.geometry != null)
+        updateMeshMorph(mesh);
+    const children = getNodeRuntime(scene).children;
+    if (children !== null) {
+        for (let i = 0; i < children.length; i++) {
+            prepareScene3DMorph(children[i]);
+        }
+    }
+}
+//# sourceMappingURL=prepareScene3DMorph.js.map

package/dist/prepareScene3DMorph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareScene3DMorph.js","sourceRoot":"","sources":["../src/prepareScene3DMorph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,mGAAmG;AACnG,0GAA0G;AAC1G,uGAAuG;AACvG,+EAA+E;AAC/E,EAAE;AACF,sGAAsG;AACtG,wGAAwG;AACxG,sGAAsG;AACtG,oGAAoG;AACpG,oFAAoF;AACpF,EAAE;AACF,2GAA2G;AAC3G,qGAAqG;AACrG,uGAAuG;AACvG,yGAAyG;AACzG,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO;IAE3B,mGAAmG;IACnG,4CAA4C;IAC5C,MAAM,IAAI,GAAG,KAAwB,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI;QAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;IAChD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/scene.d.ts

@@ -0,0 +1,3 @@
+import type { Scene3D, Node3D } from '@flighthq/types';
+export declare function createScene3D(obj?: Readonly<Partial<Pick<Node3D, 'enabled' | 'name'>>>): Scene3D;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAUvD,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAGhG"}

package/dist/scene.js

@@ -0,0 +1,12 @@
+import { createEntity } from '@flighthq/entity';
+import { Node3DKind } from '@flighthq/types';
+import { createNode3D } from './sceneNode';
+// Re-export the Scene3D document type so `@flighthq/scene3d` stays its import site.
+// Allocates a Scene3D: a 3D content document Entity that owns a `root` Node3D (allocated here), not a node in
+// the graph. Composes createEntity for the runtime slot; `animations`/`metadata` start empty and the importers
+// (`createScene3DFrom*`) fill them. `obj` configures the root node (`enabled`/`name`).
+export function createScene3D(obj) {
+    const root = createNode3D(Node3DKind, obj);
+    return createEntity({ animations: {}, metadata: null, root });
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,oFAAoF;AAEpF,8GAA8G;AAC9G,+GAA+G;AAC/G,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,GAAyD;IACrF,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAY,CAAC;AAC3E,CAAC"}

package/dist/sceneAnimation.d.ts

@@ -0,0 +1,3 @@
+import type { AnimationClip } from '@flighthq/types';
+export declare function applyAnimationClipToScene3D(clip: Readonly<AnimationClip>, time: number): void;
+//# sourceMappingURL=sceneAnimation.d.ts.map

package/dist/sceneAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneAnimation.d.ts","sourceRoot":"","sources":["../src/sceneAnimation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAWnF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAwB7F"}

package/dist/sceneAnimation.js

@@ -0,0 +1,43 @@
+import { sampleAnimationTrack } from '@flighthq/animation';
+import { setQuaternion, setVector3 } from '@flighthq/geometry';
+import { invalidateNodeLocalTransform } from '@flighthq/node';
+// Samples every channel of `clip` at `time` and applies it to its target's sink — the 3D binding layer
+// over the target-free @flighthq/animation core (the core samples values; this maps a channel's opaque
+// `targetRef`, a Scene3DAnimationTarget `{ node, path }`, onto the sink). TRS paths drive the node's
+// transform: Translation/Scale consume a Vector3 (3 components), Rotation a unit quaternion (4). The
+// Weights path drives the target Mesh's morph-target weight array (Mesh.morph.weights): the channel is
+// sampled straight into that array (its width = the mesh's target count), and updateMeshMorph then
+// blends the geometry from it. A Weights channel whose target node carries no morph is skipped.
+// Channels whose targetRef is not a Scene3DAnimationTarget are skipped. This is the deformer split — one
+// clip/animator/clock, only the sink differs (transform for TRS, weight array for morph).
+export function applyAnimationClipToScene3D(clip, time) {
+    const channels = clip.channels;
+    for (let i = 0; i < channels.length; i++) {
+        const channel = channels[i];
+        const target = channel.targetRef;
+        if (target === null || typeof target !== 'object' || target.node === undefined)
+            continue;
+        if (target.path === 'Weights') {
+            const morph = target.node.morph;
+            if (morph == null)
+                continue;
+            // Sample straight into the live weight array — its length is the track's component width.
+            sampleAnimationTrack(morph.weights, channel.track, time);
+            continue;
+        }
+        sampleAnimationTrack(_scratch, channel.track, time);
+        const node = target.node;
+        if (target.path === 'Translation') {
+            setVector3(node.position, _scratch[0], _scratch[1], _scratch[2]);
+        }
+        else if (target.path === 'Scale') {
+            setVector3(node.scale, _scratch[0], _scratch[1], _scratch[2]);
+        }
+        else {
+            setQuaternion(node.rotation, _scratch[0], _scratch[1], _scratch[2], _scratch[3]);
+        }
+        invalidateNodeLocalTransform(node);
+    }
+}
+const _scratch = [0, 0, 0, 0];
+//# sourceMappingURL=sceneAnimation.js.map

package/dist/sceneAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneAnimation.js","sourceRoot":"","sources":["../src/sceneAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAG9D,uGAAuG;AACvG,uGAAuG;AACvG,qGAAqG;AACrG,qGAAqG;AACrG,uGAAuG;AACvG,mGAAmG;AACnG,gGAAgG;AAChG,yGAAyG;AACzG,0FAA0F;AAC1F,MAAM,UAAU,2BAA2B,CAAC,IAA6B,EAAE,IAAY;IACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,SAA0C,CAAC;QAClE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACzF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAI,MAAM,CAAC,IAAa,CAAC,KAAK,CAAC;YAC1C,IAAI,KAAK,IAAI,IAAI;gBAAE,SAAS;YAC5B,0FAA0F;YAC1F,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QACD,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/sceneDocument.d.ts

@@ -0,0 +1,4 @@
+import type { Scene3D, Scene3DDocument } from '@flighthq/types';
+export declare function createScene3DFromDocument(document: Readonly<Scene3DDocument>, sceneIndex?: number): Scene3D;
+export declare function createScene3DsFromDocument(document: Readonly<Scene3DDocument>): Scene3D[];
+//# sourceMappingURL=sceneDocument.d.ts.map

package/dist/sceneDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneDocument.d.ts","sourceRoot":"","sources":["../src/sceneDocument.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAIV,OAAO,EAEP,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AAmBzB,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU,SAAI,GAAG,OAAO,CAYtG;AAKD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,OAAO,EAAE,CAkBzF"}