aigpu 0.3.1

package/dist/scene/tree/node.js

@@ -0,0 +1,220 @@
+import { sceneCycleError, sceneValueError } from "./errors.js";
+import { composeTrs, copyMat4, identityMat4, invertAffineMat4, multiplyMat4, quatFromEuler, quatLookAt, transformDirection, transformPoint, } from "./math.js";
+const UP = new Float32Array([0, 1, 0]);
+const TMP_EYE = new Float32Array(3);
+const TMP_TARGET = new Float32Array(3);
+const TMP_UP = new Float32Array(3);
+const TMP_PARENT_INVERSE = new Float32Array(16);
+/**
+ * Base scene-tree node: a TRS transform with parent/children links. Mutation goes through
+ * `set()` so world matrices are recomputed lazily and only for dirty subtrees; the exposed
+ * arrays keep a stable identity and are updated in place.
+ */
+export class SceneNode {
+    kind;
+    label;
+    visible = true;
+    #position = new Float32Array(3);
+    #quaternion = new Float32Array([0, 0, 0, 1]);
+    #scale = new Float32Array([1, 1, 1]);
+    #localMatrix = identityMat4(new Float32Array(16));
+    #worldMatrix = identityMat4(new Float32Array(16));
+    #worldPosition = new Float32Array(3);
+    #localDirty = false;
+    #worldDirty = false;
+    #parent = null;
+    #children = [];
+    _worldVersion = 0;
+    constructor(kind, options = {}) {
+        this.kind = kind;
+        this.label = options.label;
+        // Non-virtual application: subclass `set()` overrides touch subclass fields that are
+        // not installed yet while the base constructor runs.
+        this.#applyTransform(options);
+        if (options.children)
+            this.add(...options.children);
+    }
+    /** Updates transform components in place; unspecified components are left untouched. */
+    set(values) {
+        this.#applyTransform(values);
+        return this;
+    }
+    #applyTransform(values) {
+        const where = `${this.label ?? this.kind}.set`;
+        let transformTouched = false;
+        if (values.position !== undefined) {
+            writeVec3(this.#position, values.position, "position", where);
+            transformTouched = true;
+        }
+        if (values.quaternion !== undefined) {
+            if (values.quaternion.length !== 4)
+                throw sceneValueError(where, "quaternion", "an array of 4 numbers (x, y, z, w)");
+            this.#quaternion[0] = values.quaternion[0];
+            this.#quaternion[1] = values.quaternion[1];
+            this.#quaternion[2] = values.quaternion[2];
+            this.#quaternion[3] = values.quaternion[3];
+            transformTouched = true;
+        }
+        else if (values.rotation !== undefined) {
+            if (values.rotation.length !== 3)
+                throw sceneValueError(where, "rotation", "an array of 3 Euler angles in radians");
+            quatFromEuler(this.#quaternion, values.rotation[0], values.rotation[1], values.rotation[2]);
+            transformTouched = true;
+        }
+        if (values.scale !== undefined) {
+            if (typeof values.scale === "number") {
+                this.#scale.fill(values.scale);
+            }
+            else {
+                writeVec3(this.#scale, values.scale, "scale", where);
+            }
+            transformTouched = true;
+        }
+        if (values.visible !== undefined)
+            this.visible = values.visible;
+        if (values.label !== undefined)
+            this.label = values.label;
+        if (transformTouched)
+            this.#markTransformDirty();
+    }
+    /**
+     * Rotates the node so its -Z axis points at a world-space target.
+     *
+     * The whole computation runs in parent space (the target and up hint are pulled through
+     * the parent's affine inverse), which stays exact under non-uniform parent scale: an
+     * affine map sends the parent-space ray through the target to the world-space ray through
+     * the world target. Extracting a scale-stripped parent rotation instead — as an earlier
+     * version did — skews the forward vector whenever the parent scale is anisotropic.
+     */
+    lookAt(target, up = UP) {
+        const where = `${this.label ?? this.kind}.lookAt`;
+        writeVec3(TMP_TARGET, target, "target", where);
+        writeVec3(TMP_UP, up, "up", where);
+        TMP_EYE.set(this.#position);
+        const parent = this.#parent;
+        if (parent) {
+            invertAffineMat4(TMP_PARENT_INVERSE, parent.worldMatrix);
+            transformPoint(TMP_TARGET, TMP_PARENT_INVERSE, TMP_TARGET);
+            transformDirection(TMP_UP, TMP_PARENT_INVERSE, TMP_UP);
+        }
+        quatLookAt(this.#quaternion, TMP_EYE, TMP_TARGET, TMP_UP);
+        this.#markTransformDirty();
+        return this;
+    }
+    /** Adds children, reparenting them if needed. Throws `AIGPU-SCENE-CYCLE` on cycles. */
+    add(...nodes) {
+        const where = `${this.label ?? this.kind}.add`;
+        for (const node of nodes) {
+            for (let ancestor = this; ancestor; ancestor = ancestor.#parent) {
+                if (ancestor === node)
+                    throw sceneCycleError(where, node.label ?? node.kind);
+            }
+            if (node.#parent)
+                node.#parent.#removeChild(node);
+            node.#parent = this;
+            this.#children.push(node);
+            node.#markWorldDirty();
+        }
+        return this;
+    }
+    /** Removes direct children; nodes that are not children are ignored. */
+    remove(...nodes) {
+        for (const node of nodes) {
+            if (node.#parent === this)
+                this.#removeChild(node);
+        }
+        return this;
+    }
+    /** Detaches this node from its parent, keeping its local transform. */
+    removeFromParent() {
+        if (this.#parent)
+            this.#parent.#removeChild(this);
+        return this;
+    }
+    /** Depth-first visit of this node and all descendants. */
+    traverse(visit) {
+        visit(this);
+        for (const child of this.#children)
+            child.traverse(visit);
+    }
+    get parent() {
+        return this.#parent;
+    }
+    get children() {
+        return this.#children;
+    }
+    /** Local position. Stable array identity; mutate via `set()`. */
+    get position() {
+        return this.#position;
+    }
+    /** Local rotation quaternion (x, y, z, w). Stable array identity; mutate via `set()`. */
+    get quaternion() {
+        return this.#quaternion;
+    }
+    /** Local scale. Stable array identity; mutate via `set()`. */
+    get scale() {
+        return this.#scale;
+    }
+    /** Column-major local TRS matrix, recomputed lazily. Stable array identity. */
+    get localMatrix() {
+        if (this.#localDirty) {
+            composeTrs(this.#localMatrix, this.#position, this.#quaternion, this.#scale);
+            this.#localDirty = false;
+        }
+        return this.#localMatrix;
+    }
+    /** Column-major world matrix, recomputed lazily for dirty subtrees. Stable array identity. */
+    get worldMatrix() {
+        if (this.#worldDirty || this.#localDirty) {
+            const local = this.localMatrix;
+            const parent = this.#parent;
+            if (parent) {
+                multiplyMat4(this.#worldMatrix, parent.worldMatrix, local);
+            }
+            else {
+                copyMat4(this.#worldMatrix, local);
+            }
+            this.#worldDirty = false;
+            this._worldVersion++;
+        }
+        return this.#worldMatrix;
+    }
+    /** World-space position derived from `worldMatrix`. Stable array identity. */
+    get worldPosition() {
+        const world = this.worldMatrix;
+        this.#worldPosition[0] = world[12];
+        this.#worldPosition[1] = world[13];
+        this.#worldPosition[2] = world[14];
+        return this.#worldPosition;
+    }
+    #markTransformDirty() {
+        this.#localDirty = true;
+        this.#markWorldDirty(true);
+    }
+    #markWorldDirty(force = false) {
+        if (this.#worldDirty && !force)
+            return;
+        this.#worldDirty = true;
+        for (const child of this.#children)
+            child.#markWorldDirty();
+    }
+    #removeChild(node) {
+        const index = this.#children.indexOf(node);
+        if (index >= 0)
+            this.#children.splice(index, 1);
+        node.#parent = null;
+        node.#markWorldDirty(true);
+    }
+}
+/** Creates a plain transform node used to group children. */
+export function group(options = {}) {
+    return new SceneNode("group", options);
+}
+function writeVec3(out, value, name, where) {
+    if (value.length !== 3)
+        throw sceneValueError(where, name, "an array of 3 numbers");
+    out[0] = value[0];
+    out[1] = value[1];
+    out[2] = value[2];
+}
+//# sourceMappingURL=node.js.map

package/dist/scene/tree/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/scene/tree/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,GAEf,MAAM,WAAW,CAAC;AAiCnB,MAAM,EAAE,GAAiB,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;AACpC,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;AACvC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,kBAAkB,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACX,IAAI,CAAgB;IAC7B,KAAK,CAAqB;IAC1B,OAAO,GAAG,IAAI,CAAC;IAEf,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,WAAW,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,YAAY,GAAG,YAAY,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,YAAY,GAAG,YAAY,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,cAAc,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IACrC,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,GAAG,KAAK,CAAC;IACpB,OAAO,GAAqB,IAAI,CAAC;IACjC,SAAS,GAAgB,EAAE,CAAC;IAClB,aAAa,GAAG,CAAC,CAAC;IAE5B,YAAY,IAAmB,EAAE,UAAuB,EAAE;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,qFAAqF;QACrF,qDAAqD;QACrD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,OAAO,CAAC,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,wFAAwF;IACxF,GAAG,CAAC,MAA2B;QAC7B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,MAA2B;QACzC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC;QAC/C,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9D,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,oCAAoC,CAAC,CAAC;YACrH,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5C,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,uCAAuC,CAAC,CAAC;YACpH,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;YAC/F,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;YACD,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAChE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1D,IAAI,gBAAgB;YAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAgB,EAAE,KAAe,EAAE;QACxC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;QAClD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/C,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,MAAM,EAAE,CAAC;YACX,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YACzD,cAAc,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAAC;YAC3D,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uFAAuF;IACvF,GAAG,CAAC,GAAG,KAAkB;QACvB,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,IAAI,QAAQ,GAAqB,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAClF,IAAI,QAAQ,KAAK,IAAI;oBAAE,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,GAAG,KAAkB;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,gBAAgB;QACd,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,QAAQ,CAAC,KAAgC;QACvC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iEAAiE;IACjE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,yFAAyF;IACzF,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,8DAA8D;IAC9D,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,+EAA+E;IAC/E,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7E,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,8FAA8F;IAC9F,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,8EAA8E;IAC9E,IAAI,aAAa;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAE,CAAC;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,mBAAmB;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe,CAAC,KAAK,GAAG,KAAK;QAC3B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK;YAAE,OAAO;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,eAAe,EAAE,CAAC;IAC9D,CAAC;IAED,YAAY,CAAC,IAAe;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,IAAI,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,UAAU,KAAK,CAAC,UAAuB,EAAE;IAC7C,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,GAAiB,EAAE,KAAe,EAAE,IAAY,EAAE,KAAa;IAChF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACpF,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC"}

package/dist/scene/tree/orbit-controls.d.ts

@@ -0,0 +1,69 @@
+import type { SceneNode, Vec3Like } from "./node.ts";
+/**
+ * Structural event-target contract so controls work with an `HTMLCanvasElement` without
+ * requiring DOM types, and with mocks in Node tests. Listener parameters are intentionally
+ * loose (`any`) so the DOM's overloaded `addEventListener` stays assignable.
+ */
+export interface OrbitControlsElement {
+    addEventListener(type: string, listener: (event: any) => void, options?: {
+        passive?: boolean;
+    } | boolean): void;
+    removeEventListener(type: string, listener: (event: any) => void): void;
+    setPointerCapture?(pointerId: number): void;
+    releasePointerCapture?(pointerId: number): void;
+}
+export interface OrbitControlsOptions {
+    /** Pointer/wheel event source (usually the canvas). Omit for programmatic-only control. */
+    readonly element?: OrbitControlsElement;
+    /** World-space point the camera orbits and looks at. Defaults to `[0, 0, 0]`. */
+    readonly target?: Vec3Like;
+    /** Easing time constant in seconds (~63% convergence). `0` applies input immediately. */
+    readonly damping?: number;
+    /** Drag sensitivity in radians per pixel. */
+    readonly rotateSpeed?: number;
+    /** Wheel zoom sensitivity multiplier. */
+    readonly zoomSpeed?: number;
+    readonly distance?: {
+        readonly min?: number;
+        readonly max?: number;
+    };
+    /** Pitch limits in radians. Defaults keep the camera off the poles. */
+    readonly pitch?: {
+        readonly min?: number;
+        readonly max?: number;
+    };
+    readonly label?: string;
+}
+export interface OrbitControlsValues {
+    readonly yaw?: number;
+    readonly pitch?: number;
+    readonly distance?: number;
+    readonly target?: Vec3Like;
+}
+/**
+ * Shared drag-orbit + wheel-zoom controls around a target point. Input adjusts goal values;
+ * `update(deltaTime)` eases the current state toward them and writes the node's transform,
+ * so it composes with `frame.loop` and on-demand rendering alike.
+ */
+export declare class OrbitControls {
+    #private;
+    readonly label: string | undefined;
+    constructor(node: SceneNode, options?: OrbitControlsOptions);
+    /** Jumps yaw/pitch/distance/target immediately (both current state and goal). */
+    set(values: OrbitControlsValues): this;
+    /**
+     * Eases toward the goal state and writes the node transform. Returns true when the node
+     * moved — useful to skip re-rendering static frames.
+     */
+    update(deltaTime?: number): boolean;
+    get yaw(): number;
+    get pitch(): number;
+    get distance(): number;
+    /** Orbit target. Stable array identity; mutate via `set()`. */
+    get target(): Float32Array;
+    /** Removes event listeners. The node keeps its last transform. */
+    dispose(): void;
+}
+/** Creates drag-orbit + wheel-zoom controls that drive a camera (or any node). */
+export declare function orbitControls(node: SceneNode, options?: OrbitControlsOptions): OrbitControls;
+//# sourceMappingURL=orbit-controls.d.ts.map

package/dist/scene/tree/orbit-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit-controls.d.ts","sourceRoot":"","sources":["../../../src/scene/tree/orbit-controls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAcrD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IAEnC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,GAAG,IAAI,CAAC;IAChH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACxE,iBAAiB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,qBAAqB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;CAC5B;AAOD;;;;GAIG;AACH,qBAAa,aAAa;;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAsDvB,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB;IAqC/D,iFAAiF;IACjF,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IActC;;;OAGG;IACH,MAAM,CAAC,SAAS,SAAqB,GAAG,OAAO;IA0C/C,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,+DAA+D;IAC/D,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,kEAAkE;IAClE,OAAO,IAAI,IAAI;CA6BhB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAEhG"}

package/dist/scene/tree/orbit-controls.js

@@ -0,0 +1,226 @@
+import { sceneValueError } from "./errors.js";
+import { invertAffineMat4, transformPoint } from "./math.js";
+const MAX_PITCH_DEFAULT = Math.PI / 2 - 0.01;
+const EPSILON = 1e-6;
+const DEFAULT_DELTA_TIME = 1 / 60;
+const TMP_PARENT_INVERSE = new Float32Array(16);
+/**
+ * Shared drag-orbit + wheel-zoom controls around a target point. Input adjusts goal values;
+ * `update(deltaTime)` eases the current state toward them and writes the node's transform,
+ * so it composes with `frame.loop` and on-demand rendering alike.
+ */
+export class OrbitControls {
+    label;
+    #node;
+    #element;
+    #target = new Float32Array(3);
+    #localTarget = new Float32Array(3);
+    #yaw = 0;
+    #pitch = 0;
+    #distance = 1;
+    #goalYaw = 0;
+    #goalPitch = 0;
+    #goalDistance = 1;
+    #damping;
+    #rotateSpeed;
+    #zoomSpeed;
+    #minDistance;
+    #maxDistance;
+    #minPitch;
+    #maxPitch;
+    #dragging = false;
+    #lastX = 0;
+    #lastY = 0;
+    #applied = false;
+    #disposed = false;
+    #onPointerDown = (event) => {
+        if (event.button !== 0)
+            return;
+        this.#dragging = true;
+        this.#lastX = event.clientX;
+        this.#lastY = event.clientY;
+        this.#element?.setPointerCapture?.(event.pointerId);
+    };
+    #onPointerMove = (event) => {
+        if (!this.#dragging)
+            return;
+        const dx = event.clientX - this.#lastX;
+        const dy = event.clientY - this.#lastY;
+        this.#lastX = event.clientX;
+        this.#lastY = event.clientY;
+        this.#goalYaw -= dx * this.#rotateSpeed;
+        this.#goalPitch = clamp(this.#goalPitch + dy * this.#rotateSpeed, this.#minPitch, this.#maxPitch);
+    };
+    #onPointerUp = (event) => {
+        this.#dragging = false;
+        this.#element?.releasePointerCapture?.(event.pointerId);
+    };
+    #onWheel = (event) => {
+        event.preventDefault();
+        const factor = Math.exp(event.deltaY * 0.001 * this.#zoomSpeed);
+        this.#goalDistance = clamp(this.#goalDistance * factor, this.#minDistance, this.#maxDistance);
+    };
+    constructor(node, options = {}) {
+        this.#node = node;
+        this.label = options.label;
+        this.#damping = options.damping ?? 0.1;
+        this.#rotateSpeed = options.rotateSpeed ?? 0.005;
+        this.#zoomSpeed = options.zoomSpeed ?? 1;
+        this.#minDistance = options.distance?.min ?? EPSILON;
+        this.#maxDistance = options.distance?.max ?? Infinity;
+        this.#minPitch = options.pitch?.min ?? -MAX_PITCH_DEFAULT;
+        this.#maxPitch = options.pitch?.max ?? MAX_PITCH_DEFAULT;
+        if (options.target !== undefined)
+            writeVec3(this.#target, options.target, "target", this.label ?? "orbitControls");
+        // Derive the initial spherical pose from the node's current position. Both operands
+        // live in the node's parent space, so the world target is pulled into it first.
+        const target = this.#targetInNodeSpace();
+        const ox = node.position[0] - target[0];
+        const oy = node.position[1] - target[1];
+        const oz = node.position[2] - target[2];
+        const length = Math.hypot(ox, oy, oz);
+        this.#distance = clamp(length > 0 ? length : 1, this.#minDistance, this.#maxDistance);
+        this.#yaw = length > 0 ? Math.atan2(ox, oz) : 0;
+        this.#pitch = length > 0 ? clamp(Math.asin(oy / length), this.#minPitch, this.#maxPitch) : 0;
+        this.#goalYaw = this.#yaw;
+        this.#goalPitch = this.#pitch;
+        this.#goalDistance = this.#distance;
+        const element = options.element;
+        if (element) {
+            this.#element = element;
+            element.addEventListener("pointerdown", this.#onPointerDown);
+            element.addEventListener("pointermove", this.#onPointerMove);
+            element.addEventListener("pointerup", this.#onPointerUp);
+            element.addEventListener("pointercancel", this.#onPointerUp);
+            element.addEventListener("wheel", this.#onWheel, { passive: false });
+        }
+    }
+    /** Jumps yaw/pitch/distance/target immediately (both current state and goal). */
+    set(values) {
+        const where = this.#where("set");
+        // Validate everything up front: a NaN that reaches the state can never be eased out.
+        if (values.yaw !== undefined)
+            requireFinite(where, "yaw", values.yaw);
+        if (values.pitch !== undefined)
+            requireFinite(where, "pitch", values.pitch);
+        if (values.distance !== undefined)
+            requireFinite(where, "distance", values.distance);
+        if (values.target !== undefined)
+            writeVec3(this.#target, values.target, "target", where);
+        if (values.yaw !== undefined)
+            this.#yaw = this.#goalYaw = values.yaw;
+        if (values.pitch !== undefined)
+            this.#pitch = this.#goalPitch = clamp(values.pitch, this.#minPitch, this.#maxPitch);
+        if (values.distance !== undefined)
+            this.#distance = this.#goalDistance = clamp(values.distance, this.#minDistance, this.#maxDistance);
+        this.#applied = false;
+        return this;
+    }
+    /**
+     * Eases toward the goal state and writes the node transform. Returns true when the node
+     * moved — useful to skip re-rendering static frames.
+     */
+    update(deltaTime = DEFAULT_DELTA_TIME) {
+        // A non-finite dt (the classic first-frame `performance.now()` delta) would otherwise
+        // write NaN into yaw/pitch/distance permanently: NaN < EPSILON is false, so the snap
+        // rescue below never fires and the state can never recover.
+        const dt = Number.isFinite(deltaTime) ? Math.max(deltaTime, 0) : DEFAULT_DELTA_TIME;
+        const position = this.#node.position;
+        const gap = Math.max(Math.abs(this.#goalYaw - this.#yaw), Math.abs(this.#goalPitch - this.#pitch), Math.abs(this.#goalDistance - this.#distance));
+        const settled = gap < EPSILON && this.#applied;
+        if (!settled) {
+            const t = this.#damping > 0 ? 1 - Math.exp(-dt / this.#damping) : 1;
+            this.#yaw += (this.#goalYaw - this.#yaw) * t;
+            this.#pitch += (this.#goalPitch - this.#pitch) * t;
+            this.#distance += (this.#goalDistance - this.#distance) * t;
+            if (gap < EPSILON) {
+                this.#yaw = this.#goalYaw;
+                this.#pitch = this.#goalPitch;
+                this.#distance = this.#goalDistance;
+            }
+        }
+        const cosPitch = Math.cos(this.#pitch);
+        // `node.position` is parent-local, so the orbit is built around the target expressed in
+        // that same space; `lookAt()` takes the world target (it does its own parent transform).
+        const target = this.#targetInNodeSpace();
+        const x = target[0] + Math.sin(this.#yaw) * cosPitch * this.#distance;
+        const y = target[1] + Math.sin(this.#pitch) * this.#distance;
+        const z = target[2] + Math.cos(this.#yaw) * cosPitch * this.#distance;
+        // A settled state still has to be re-applied when the rig above the node moved, which
+        // changes where the world target sits in parent space. `position` holds exactly what a
+        // previous write rounded to, so `fround` compares without a tolerance.
+        if (settled && Math.fround(x) === position[0] && Math.fround(y) === position[1] && Math.fround(z) === position[2]) {
+            return false;
+        }
+        this.#node.set({ position: [x, y, z] });
+        this.#node.lookAt(this.#target);
+        this.#applied = true;
+        return true;
+    }
+    get yaw() {
+        return this.#yaw;
+    }
+    get pitch() {
+        return this.#pitch;
+    }
+    get distance() {
+        return this.#distance;
+    }
+    /** Orbit target. Stable array identity; mutate via `set()`. */
+    get target() {
+        return this.#target;
+    }
+    /** Removes event listeners. The node keeps its last transform. */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        const element = this.#element;
+        if (element) {
+            element.removeEventListener("pointerdown", this.#onPointerDown);
+            element.removeEventListener("pointermove", this.#onPointerMove);
+            element.removeEventListener("pointerup", this.#onPointerUp);
+            element.removeEventListener("pointercancel", this.#onPointerUp);
+            element.removeEventListener("wheel", this.#onWheel);
+        }
+        this.#element = undefined;
+    }
+    #where(method) {
+        return `${this.label ?? "orbitControls"}.${method}`;
+    }
+    /**
+     * The world-space target expressed in the node's parent space, which is the space
+     * `node.position` lives in. Recomputed per call because the rig above the node may move
+     * between frames. Returns the world target unchanged for unparented nodes.
+     */
+    #targetInNodeSpace() {
+        const parent = this.#node.parent;
+        if (!parent)
+            return this.#target;
+        invertAffineMat4(TMP_PARENT_INVERSE, parent.worldMatrix);
+        return transformPoint(this.#localTarget, TMP_PARENT_INVERSE, this.#target);
+    }
+}
+/** Creates drag-orbit + wheel-zoom controls that drive a camera (or any node). */
+export function orbitControls(node, options = {}) {
+    return new OrbitControls(node, options);
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function requireFinite(where, name, value) {
+    if (!Number.isFinite(value))
+        throw sceneValueError(where, name, "a finite number");
+}
+function writeVec3(out, value, name, where) {
+    if (value.length !== 3)
+        throw sceneValueError(where, name, "an array of 3 numbers");
+    for (let i = 0; i < 3; i++) {
+        if (!Number.isFinite(value[i]))
+            throw sceneValueError(where, name, "an array of 3 finite numbers");
+    }
+    out[0] = value[0];
+    out[1] = value[1];
+    out[2] = value[2];
+}
+//# sourceMappingURL=orbit-controls.js.map

package/dist/scene/tree/orbit-controls.js.map

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

package/dist/scene.d.ts

@@ -0,0 +1,21 @@
+export { box, capsule, cone, cylinder, disk, dodecahedron, fullscreenQuad, icosahedron, icosphere, octahedron, plane, ring, sphere, tetrahedron, torus, } from "./scene/geometry.ts";
+export { geometries } from "./scene/geometries.ts";
+export type { BoxOptions, CapsuleOptions, ConeOptions, CylinderOptions, DiskOptions, FullscreenQuadOptions, GeometryKind, IcosphereOptions, PlaneOptions, PolyhedronOptions, RingOptions, SceneGeometry, SceneGeometryOfKind, SphereOptions, TorusOptions, } from "./scene/geometry.ts";
+export { degToRad, srgb } from "./scene/geometry-src/index.ts";
+export { OrthographicCamera, orthographicCamera, PerspectiveCamera, perspectiveCamera } from "./scene/camera.ts";
+export type { Camera, CameraVec3, OrthographicCameraOptions, OrthographicCameraValues, PerspectiveCameraOptions, PerspectiveCameraValues, SceneCamera, } from "./scene/camera.ts";
+export { orbit } from "./scene/orbit.ts";
+export type { Mat4, OrbitOptions } from "./scene/orbit.ts";
+/** Three-component vector type accepted by low-level scene camera helpers. */
+export type { Vec3 } from "./scene/geometry-src/index.ts";
+export type { Geometry, GeometryAttributeOverride, GeometryAttributes, GeometryBuffer, GeometryBufferOptions, GeometryData, GeometryOptions, GeometrySlice, GeometrySliceOptions } from "./scene/geometry-descriptor.ts";
+export { group, SceneNode } from "./scene/tree/node.ts";
+export type { NodeOptions, NodeTransformValues, QuatLike, SceneNodeKind, Vec3Like } from "./scene/tree/node.ts";
+export { mesh, MeshNode, scene } from "./scene/tree/mesh-node.ts";
+export { LambertMaterial, lambertMaterial, NormalMaterial, normalMaterial, SceneMaterial, ShaderMaterial, shaderMaterial, UnlitMaterial, unlitMaterial, } from "./scene/tree/material.ts";
+export type { ColorMaterialOptions, ColorMaterialValues, MaterialBlend, SceneMaterialKind, ShaderMaterialOptions } from "./scene/tree/material.ts";
+export { AmbientLight, ambientLight, DirectionalLight, directionalLight } from "./scene/tree/light.ts";
+export type { AmbientLightOptions, AmbientLightValues, DirectionalLightOptions, DirectionalLightValues } from "./scene/tree/light.ts";
+export { OrbitControls, orbitControls } from "./scene/tree/orbit-controls.ts";
+export type { OrbitControlsElement, OrbitControlsOptions, OrbitControlsValues } from "./scene/tree/orbit-controls.ts";
+//# 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":"AAAA,OAAO,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,IAAI,EACJ,MAAM,EACN,WAAW,EACX,KAAK,GACN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjH,YAAY,EACV,MAAM,EACN,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,8EAA8E;AAC9E,YAAY,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACzN,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACnJ,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvG,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtI,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/scene.js

@@ -0,0 +1,11 @@
+export { box, capsule, cone, cylinder, disk, dodecahedron, fullscreenQuad, icosahedron, icosphere, octahedron, plane, ring, sphere, tetrahedron, torus, } from "./scene/geometry.js";
+export { geometries } from "./scene/geometries.js";
+export { degToRad, srgb } from "./scene/geometry-src/index.js";
+export { OrthographicCamera, orthographicCamera, PerspectiveCamera, perspectiveCamera } from "./scene/camera.js";
+export { orbit } from "./scene/orbit.js";
+export { group, SceneNode } from "./scene/tree/node.js";
+export { mesh, MeshNode, scene } from "./scene/tree/mesh-node.js";
+export { LambertMaterial, lambertMaterial, NormalMaterial, normalMaterial, SceneMaterial, ShaderMaterial, shaderMaterial, UnlitMaterial, unlitMaterial, } from "./scene/tree/material.js";
+export { AmbientLight, ambientLight, DirectionalLight, directionalLight } from "./scene/tree/light.js";
+export { OrbitControls, orbitControls } from "./scene/tree/orbit-controls.js";
+//# 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,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,IAAI,EACJ,MAAM,EACN,WAAW,EACX,KAAK,GACN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAkBnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUjH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKzC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/set-core.d.ts

@@ -0,0 +1,50 @@
+import { type Device } from "@aigpu/core";
+import type { BindingInfo, Reflection } from "@aigpu/wgsl/reflect-source";
+import { type BindGroupCache, type BindGroupIdentityPart } from "./bind-cache.ts";
+export type SetBag = Record<string, unknown>;
+export type BindingOwnership = "lib" | "user";
+export interface SetCoreOptions {
+    readonly device: Device;
+    readonly label: string;
+    readonly drawId: number;
+    readonly reflection: Reflection;
+    readonly bindGroupLayouts: ReadonlyMap<number, GPUBindGroupLayout>;
+    readonly cache: BindGroupCache;
+    readonly onIdentityChange?: (change: BindingIdentityChange) => void;
+}
+export interface BindingIdentityChange {
+    readonly group: number;
+    readonly binding: number;
+    readonly bindingName: string;
+    readonly bindingKind: string;
+    readonly previousIdentity?: string;
+    readonly newIdentity: string;
+}
+/** Ring-1 set() engine: latches ownership, validates completeness, and returns cached bind groups. */
+export interface SetCore {
+    readonly groups: readonly number[];
+    set(values: SetBag): readonly BindingIdentityChange[];
+    claimGroup(group: number, bindGroup: GPUBindGroup, expectedLayout: GPUBindGroupLayout): string | undefined;
+    layout(group: number): GPUBindGroupLayout;
+    bindGroups(): readonly {
+        readonly group: number;
+        readonly bindGroup: GPUBindGroup;
+        readonly offsets: readonly number[];
+        readonly claimValidation?: {
+            readonly label: string;
+            readonly group: number;
+        };
+    }[];
+    bindingState(name: string): BindingState | undefined;
+}
+export interface BindingState {
+    readonly info: BindingInfo;
+    readonly ownership: BindingOwnership;
+    readonly resource: GPUBindingResource;
+    readonly identity: BindGroupIdentityPart;
+}
+/** Creates the per-Draw binding state machine used by Effect/Draw.set(). */
+export declare function createSetCore(options: SetCoreOptions): SetCore;
+export { bindGroupLayoutEntriesForGroup, bindGroupLayoutsForReflection, pipelineLayoutFor } from "./set-layouts.ts";
+export { writeLayoutValue } from "./set-packing.ts";
+//# sourceMappingURL=set-core.d.ts.map