@aura3d/engine 1.0.0

package/dist/scene/SceneNode.d.ts

@@ -0,0 +1,42 @@
+import { Bounds3 } from "./Bounds.js";
+import type { Renderable } from "./Renderable.js";
+import { TransformNode } from "./TransformNode.js";
+export interface SceneNodeOptions {
+    id?: string;
+    name?: string;
+}
+export interface AddChildOptions {
+    preserveWorldTransform?: boolean;
+}
+export interface DisposeNodeOptions {
+    recursive?: boolean;
+}
+export declare class SceneNode {
+    readonly id: string;
+    name: string;
+    visible: boolean;
+    layerMask: number;
+    renderOrder: number;
+    disposed: boolean;
+    userData: Record<string, unknown>;
+    renderable?: Renderable;
+    readonly transform: TransformNode;
+    localBounds: Bounds3 | null;
+    worldBounds: Bounds3;
+    readonly children: SceneNode[];
+    parent: SceneNode | null;
+    constructor(options?: SceneNodeOptions);
+    addChild(child: SceneNode, options?: AddChildOptions): this;
+    removeChild(child: SceneNode): boolean;
+    removeFromParent(): boolean;
+    isAncestorOf(candidate: SceneNode): boolean;
+    traverse(visitor: (node: SceneNode) => void): void;
+    updateWorldTransform(force?: boolean): void;
+    updateWorldBounds(): Bounds3;
+    setLocalBounds(bounds: Bounds3 | null): this;
+    dispose(options?: DisposeNodeOptions): void;
+    markWorldDirty(): void;
+    protected assertAlive(): void;
+}
+export declare function assertCanParent(parent: SceneNode, child: SceneNode): void;
+//# sourceMappingURL=SceneNode.d.ts.map

package/dist/scene/SceneNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneNode.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneNode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,UAAQ;IACf,SAAS,SAAK;IACd,WAAW,SAAK;IAChB,QAAQ,UAAS;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,SAAS,gBAAuB;IACzC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAQ;IACnC,WAAW,UAAiB;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAM;IACpC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAEpB,OAAO,GAAE,gBAAqB;IAM1C,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAe/D,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAUtC,gBAAgB,IAAI,OAAO;IAI3B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAS3C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAKlD,oBAAoB,CAAC,KAAK,UAAQ,GAAG,IAAI;IAKzC,iBAAiB,IAAI,OAAO;IAO5B,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAO5C,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAmB/C,cAAc,IAAI,IAAI;IAOtB,SAAS,CAAC,WAAW,IAAI,IAAI;CAG9B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAGzE"}

package/dist/scene/SceneNode.js

@@ -0,0 +1,126 @@
+import { ValidationError } from "../core/index.js";
+import { Bounds3 } from "./Bounds.js";
+import { cloneMat4, invertMat4, multiplyMat4 } from "./MathTypes.js";
+import { TransformNode } from "./TransformNode.js";
+let nextSceneNodeId = 1;
+export class SceneNode {
+    id;
+    name;
+    visible = true;
+    layerMask = 1;
+    renderOrder = 0;
+    disposed = false;
+    userData = {};
+    renderable;
+    transform = new TransformNode();
+    localBounds = null;
+    worldBounds = new Bounds3();
+    children = [];
+    parent = null;
+    constructor(options = {}) {
+        this.id = options.id ?? `node-${nextSceneNodeId++}`;
+        this.name = options.name ?? this.id;
+        this.transform.onDirty(() => this.markWorldDirty());
+    }
+    addChild(child, options = {}) {
+        this.assertAlive();
+        child.assertAlive();
+        assertCanParent(this, child);
+        if (child.parent === this)
+            return this;
+        const preservedWorld = options.preserveWorldTransform ? cloneMat4(child.transform.worldMatrix) : undefined;
+        if (preservedWorld)
+            this.updateWorldTransform();
+        child.parent?.removeChild(child);
+        this.children.push(child);
+        child.parent = this;
+        if (preservedWorld)
+            child.transform.setFromLocalMatrix(multiplyMat4(invertMat4(this.transform.worldMatrix), preservedWorld));
+        child.markWorldDirty();
+        return this;
+    }
+    removeChild(child) {
+        this.assertAlive();
+        const index = this.children.indexOf(child);
+        if (index < 0)
+            return false;
+        this.children.splice(index, 1);
+        child.parent = null;
+        child.markWorldDirty();
+        return true;
+    }
+    removeFromParent() {
+        return this.parent?.removeChild(this) ?? false;
+    }
+    isAncestorOf(candidate) {
+        let current = candidate.parent;
+        while (current) {
+            if (current === this)
+                return true;
+            current = current.parent;
+        }
+        return false;
+    }
+    traverse(visitor) {
+        visitor(this);
+        for (const child of [...this.children])
+            child.traverse(visitor);
+    }
+    updateWorldTransform(force = false) {
+        const changed = this.transform.updateWorld(this.parent?.transform.worldMatrix, force);
+        for (const child of this.children)
+            child.updateWorldTransform(force || changed);
+    }
+    updateWorldBounds() {
+        let bounds = this.localBounds ? this.localBounds.transform(this.transform.worldMatrix) : new Bounds3();
+        for (const child of this.children)
+            bounds = bounds.union(child.updateWorldBounds());
+        this.worldBounds = bounds;
+        return this.worldBounds;
+    }
+    setLocalBounds(bounds) {
+        this.assertAlive();
+        this.localBounds = bounds?.clone() ?? null;
+        this.worldBounds = this.localBounds ? this.localBounds.transform(this.transform.worldMatrix) : new Bounds3();
+        return this;
+    }
+    dispose(options = {}) {
+        if (this.disposed)
+            return;
+        const recursive = options.recursive ?? true;
+        const children = [...this.children];
+        if (recursive) {
+            for (const child of children)
+                child.dispose(options);
+        }
+        else {
+            for (const child of children)
+                child.parent = null;
+        }
+        this.children.length = 0;
+        this.parent?.removeChild(this);
+        this.parent = null;
+        this.renderable = undefined;
+        this.localBounds = null;
+        this.userData = {};
+        this.visible = false;
+        this.disposed = true;
+    }
+    markWorldDirty() {
+        for (const child of this.children) {
+            child.transform.markDirty();
+            child.markWorldDirty();
+        }
+    }
+    assertAlive() {
+        if (this.disposed)
+            throw new ValidationError("DISPOSED_SCENE_NODE", `Scene node ${this.name} is disposed.`);
+    }
+}
+export function assertCanParent(parent, child) {
+    if (parent === child)
+        throw new ValidationError("SCENE_SELF_PARENT", "A scene node cannot be parented to itself.");
+    if (child.isAncestorOf(parent))
+        throw new ValidationError("SCENE_HIERARCHY_CYCLE", "Scene hierarchy cycle rejected.");
+}
+//# sourceMappingURL=SceneNode.js.map

package/dist/scene/SceneNode.js.map

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

package/dist/scene/SceneQuery.d.ts

@@ -0,0 +1,16 @@
+import { Bounds3 } from "./Bounds.js";
+import { Renderable } from "./Renderable.js";
+import { SceneNode } from "./SceneNode.js";
+export interface SceneQueryOptions {
+    name?: string | RegExp;
+    visible?: boolean;
+    layerMask?: number;
+    type?: "camera" | "light" | "node";
+    bounds?: Bounds3;
+}
+export declare function queryScene(root: SceneNode, options: SceneQueryOptions): SceneNode[];
+export declare function collectRenderables(root: SceneNode): {
+    node: SceneNode;
+    renderable: Renderable;
+}[];
+//# sourceMappingURL=SceneQuery.d.ts.map

package/dist/scene/SceneQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneQuery.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAenF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,EAAE,CAOjG"}

package/dist/scene/SceneQuery.js

@@ -0,0 +1,37 @@
+import { Bounds3 } from "./Bounds.js";
+import { Camera } from "./Camera.js";
+import { Light } from "./Light.js";
+import { Renderable } from "./Renderable.js";
+import { SceneNode } from "./SceneNode.js";
+export function queryScene(root, options) {
+    const result = [];
+    root.traverse((node) => {
+        if (options.visible !== undefined && node.visible !== options.visible)
+            return;
+        if (options.layerMask !== undefined && (node.layerMask & options.layerMask) === 0)
+            return;
+        if (options.name !== undefined) {
+            const matches = typeof options.name === "string" ? node.name === options.name : options.name.test(node.name);
+            if (!matches)
+                return;
+        }
+        if (options.type === "camera" && !(node instanceof Camera))
+            return;
+        if (options.type === "light" && !(node instanceof Light))
+            return;
+        if (options.bounds && !node.worldBounds.intersects(options.bounds))
+            return;
+        result.push(node);
+    });
+    return result;
+}
+export function collectRenderables(root) {
+    const result = [];
+    root.traverse((node) => {
+        const maybe = node.renderable;
+        if (maybe && node.visible)
+            result.push({ node, renderable: maybe });
+    });
+    return result;
+}
+//# sourceMappingURL=SceneQuery.js.map

package/dist/scene/SceneQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneQuery.js","sourceRoot":"","sources":["../../../../packages/scene/src/SceneQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAU3C,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,OAA0B;IACpE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YAAE,OAAO;QAC9E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAC1F,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7G,IAAI,CAAC,OAAO;gBAAE,OAAO;QACvB,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,YAAY,MAAM,CAAC;YAAE,OAAO;QACnE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO;QACjE,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO;QAC3E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scene/SceneSerializer.d.ts

@@ -0,0 +1,59 @@
+import { Scene } from "./Scene.js";
+import type { SerializedSceneMetadata } from "./SceneMetadata.js";
+export interface SerializedSceneNode {
+    id: string;
+    name: string;
+    visible: boolean;
+    layerMask: number;
+    kind: "node" | "perspectiveCamera" | "orthographicCamera" | "directionalLight" | "pointLight" | "spotLight";
+    transform: {
+        position: [number, number, number];
+        rotation: [number, number, number, number];
+        scale: [number, number, number];
+    };
+    renderable?: {
+        geometry: string;
+        material: string;
+        layerMask: number;
+        castShadow: boolean;
+        receiveShadow: boolean;
+        morphWeights?: readonly number[];
+        instanceTransforms?: readonly number[];
+        instanceColors?: readonly number[];
+    };
+    camera?: {
+        fovYRadians?: number;
+        aspect?: number;
+        left?: number;
+        right?: number;
+        bottom?: number;
+        top?: number;
+        near: number;
+        far: number;
+        zoom?: number;
+        resizeMode?: "fit-vertical" | "fit-horizontal" | "preserve-frustum";
+        viewport: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+    light?: {
+        color: [number, number, number];
+        intensity: number;
+        castsShadow: boolean;
+        range?: number;
+        angle?: number;
+        penumbra?: number;
+    };
+    children: SerializedSceneNode[];
+}
+export interface SerializedScene {
+    version: 1;
+    metadata?: SerializedSceneMetadata;
+    root: SerializedSceneNode;
+}
+export declare function serializeScene(scene: Scene): SerializedScene;
+export declare function deserializeScene(serialized: SerializedScene): Scene;
+//# sourceMappingURL=SceneSerializer.d.ts.map

package/dist/scene/SceneSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneSerializer.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SceneSerializer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAIlE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,YAAY,GAAG,WAAW,CAAC;IAC5G,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACvC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;QACpE,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,KAAK,CAUnE"}

package/dist/scene/SceneSerializer.js

@@ -0,0 +1,127 @@
+import { ValidationError } from "../core/index.js";
+import { DirectionalLight } from "./DirectionalLight.js";
+import { OrthographicCamera } from "./OrthographicCamera.js";
+import { PerspectiveCamera } from "./PerspectiveCamera.js";
+import { PointLight } from "./PointLight.js";
+import { Renderable } from "./Renderable.js";
+import { Scene } from "./Scene.js";
+import { SceneNode } from "./SceneNode.js";
+import { SpotLight } from "./SpotLight.js";
+export function serializeScene(scene) {
+    return {
+        version: 1,
+        ...(scene.metadata.isEmpty ? {} : { metadata: scene.metadata.toJSON() }),
+        root: serializeNode(scene.root)
+    };
+}
+export function deserializeScene(serialized) {
+    if (serialized.version !== 1)
+        throw new ValidationError("SCENE_VERSION", `Unsupported scene version: ${serialized.version}`);
+    const scene = new Scene();
+    if (serialized.metadata)
+        scene.metadata.replace(serialized.metadata);
+    for (const child of serialized.root.children) {
+        const node = deserializeNode(child);
+        scene.root.addChild(node);
+        scene.registerSubtree(node);
+    }
+    return scene;
+}
+function serializeNode(node) {
+    const renderable = node.renderable;
+    return {
+        id: node.id,
+        name: node.name,
+        visible: node.visible,
+        layerMask: node.layerMask,
+        kind: node instanceof PerspectiveCamera ? "perspectiveCamera" : node instanceof OrthographicCamera ? "orthographicCamera" : node instanceof DirectionalLight ? "directionalLight" : node instanceof PointLight ? "pointLight" : node instanceof SpotLight ? "spotLight" : "node",
+        transform: {
+            position: [...node.transform.position],
+            rotation: [...node.transform.rotation],
+            scale: [...node.transform.scale]
+        },
+        renderable: renderable ? {
+            geometry: renderable.geometry,
+            material: renderable.material,
+            layerMask: renderable.layerMask,
+            castShadow: renderable.castShadow,
+            receiveShadow: renderable.receiveShadow,
+            ...(renderable.morphWeights.length > 0 ? { morphWeights: [...renderable.morphWeights] } : {}),
+            ...(renderable.instanceTransforms ? { instanceTransforms: [...renderable.instanceTransforms] } : {}),
+            ...(renderable.instanceColors ? { instanceColors: [...renderable.instanceColors] } : {})
+        } : undefined,
+        camera: serializeCamera(node),
+        light: serializeLight(node),
+        children: node.children.map(serializeNode)
+    };
+}
+function deserializeNode(data) {
+    const node = data.kind === "perspectiveCamera" ? new PerspectiveCamera({ id: data.id, name: data.name, fovYRadians: data.camera?.fovYRadians, aspect: data.camera?.aspect, near: data.camera?.near, far: data.camera?.far }) :
+        data.kind === "orthographicCamera" ? new OrthographicCamera({ id: data.id, name: data.name, left: data.camera?.left, right: data.camera?.right, bottom: data.camera?.bottom, top: data.camera?.top, near: data.camera?.near, far: data.camera?.far, zoom: data.camera?.zoom, resizeMode: data.camera?.resizeMode }) :
+            data.kind === "directionalLight" ? new DirectionalLight(data.name, data.id) :
+                data.kind === "pointLight" ? new PointLight(data.name, data.id) :
+                    data.kind === "spotLight" ? new SpotLight(data.name, data.id) :
+                        new SceneNode({ id: data.id, name: data.name });
+    node.visible = data.visible;
+    node.layerMask = data.layerMask;
+    node.transform.setPosition(...data.transform.position);
+    node.transform.setRotation(...data.transform.rotation);
+    node.transform.setScale(...data.transform.scale);
+    if (data.camera && (node instanceof PerspectiveCamera || node instanceof OrthographicCamera))
+        node.setViewport(data.camera.viewport);
+    if (data.light && (node instanceof DirectionalLight || node instanceof PointLight || node instanceof SpotLight)) {
+        node.color = [...data.light.color];
+        node.intensity = data.light.intensity;
+        node.castsShadow = data.light.castsShadow;
+    }
+    if (data.light?.range !== undefined && (node instanceof PointLight || node instanceof SpotLight))
+        node.range = data.light.range;
+    if (data.light?.angle !== undefined && node instanceof SpotLight)
+        node.angle = data.light.angle;
+    if (data.light?.penumbra !== undefined && node instanceof SpotLight)
+        node.penumbra = data.light.penumbra;
+    if (data.renderable)
+        node.renderable = new Renderable(data.renderable);
+    for (const child of data.children)
+        node.addChild(deserializeNode(child));
+    return node;
+}
+function serializeCamera(node) {
+    if (node instanceof PerspectiveCamera) {
+        return {
+            fovYRadians: node.fovYRadians,
+            aspect: node.aspect,
+            near: node.near,
+            far: node.far,
+            viewport: { ...node.viewport }
+        };
+    }
+    if (node instanceof OrthographicCamera) {
+        return {
+            left: node.left,
+            right: node.right,
+            bottom: node.bottom,
+            top: node.top,
+            near: node.near,
+            far: node.far,
+            zoom: node.zoom,
+            resizeMode: node.resizeMode,
+            viewport: { ...node.viewport }
+        };
+    }
+    return undefined;
+}
+function serializeLight(node) {
+    if (node instanceof DirectionalLight || node instanceof PointLight || node instanceof SpotLight) {
+        const color = Array.isArray(node.color) ? [...node.color] : [node.color.x, node.color.y, node.color.z];
+        return {
+            color,
+            intensity: node.intensity,
+            castsShadow: node.castsShadow,
+            ...(node instanceof PointLight || node instanceof SpotLight ? { range: node.range } : {}),
+            ...(node instanceof SpotLight ? { angle: node.angle, penumbra: node.penumbra } : {})
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=SceneSerializer.js.map

package/dist/scene/SceneSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneSerializer.js","sourceRoot":"","sources":["../../../../packages/scene/src/SceneSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAqD3C,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACxE,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAA2B;IAC1D,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,8BAA8B,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7H,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,IAAI,UAAU,CAAC,QAAQ;QAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,YAAY,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,YAAY,kBAAkB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,YAAY,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QAChR,SAAS,EAAE;YACT,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACjC;QACD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;YACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpG,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzF,CAAC,CAAC,CAAC,SAAS;QACb,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC;QAC7B,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAyB;IAChD,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACjN,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YACrT,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7E,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;oBACjE,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;wBAC/D,IAAI,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAChC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,YAAY,iBAAiB,IAAI,IAAI,YAAY,kBAAkB,CAAC;QAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,YAAY,gBAAgB,IAAI,IAAI,YAAY,UAAU,IAAI,IAAI,YAAY,SAAS,CAAC,EAAE,CAAC;QAChH,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAM,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAM,CAAC,WAAW,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,YAAY,UAAU,IAAI,IAAI,YAAY,SAAS,CAAC;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAChI,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,IAAI,IAAI,YAAY,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAChG,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS,IAAI,IAAI,YAAY,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IACzG,IAAI,IAAI,CAAC,UAAU;QAAE,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,IAAe;IACtC,IAAI,IAAI,YAAY,iBAAiB,EAAE,CAAC;QACtC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;SAC/B,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,YAAY,kBAAkB,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;SAC/B,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,IAAe;IACrC,IAAI,IAAI,YAAY,gBAAgB,IAAI,IAAI,YAAY,UAAU,IAAI,IAAI,YAAY,SAAS,EAAE,CAAC;QAChG,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAA6B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAA6B,CAAC;QAC/J,OAAO;YACL,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,YAAY,UAAU,IAAI,IAAI,YAAY,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,GAAG,CAAC,IAAI,YAAY,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/scene/SpotLight.d.ts

@@ -0,0 +1,14 @@
+import { Light } from "./Light.js";
+export declare class SpotLight extends Light {
+    private currentAngle;
+    private currentPenumbra;
+    private currentRange;
+    constructor(name?: string, id?: string);
+    get angle(): number;
+    set angle(value: number);
+    get penumbra(): number;
+    set penumbra(value: number);
+    get range(): number;
+    set range(value: number);
+}
+//# sourceMappingURL=SpotLight.d.ts.map

package/dist/scene/SpotLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpotLight.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/SpotLight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAM;gBAEd,IAAI,SAAc,EAAE,EAAE,CAAC,EAAE,MAAM;IAI3C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAGzB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;CACF"}

package/dist/scene/SpotLight.js

@@ -0,0 +1,35 @@
+import { ValidationError } from "../core/index.js";
+import { Light } from "./Light.js";
+export class SpotLight extends Light {
+    currentAngle = Math.PI / 4;
+    currentPenumbra = 0;
+    currentRange = 10;
+    constructor(name = "SpotLight", id) {
+        super("spot", name, id);
+    }
+    get angle() {
+        return this.currentAngle;
+    }
+    set angle(value) {
+        if (!(value > 0 && value < Math.PI / 2))
+            throw new ValidationError("SPOT_LIGHT_ANGLE", "Spot light angle must be within (0, PI / 2).");
+        this.currentAngle = value;
+    }
+    get penumbra() {
+        return this.currentPenumbra;
+    }
+    set penumbra(value) {
+        if (!(value >= 0 && value <= 1))
+            throw new ValidationError("SPOT_LIGHT_PENUMBRA", "Spot light penumbra must be within [0, 1].");
+        this.currentPenumbra = value;
+    }
+    get range() {
+        return this.currentRange;
+    }
+    set range(value) {
+        if (!(value > 0) || !Number.isFinite(value))
+            throw new ValidationError("SPOT_LIGHT_RANGE", "Spot light range must be positive.");
+        this.currentRange = value;
+    }
+}
+//# sourceMappingURL=SpotLight.js.map

package/dist/scene/SpotLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpotLight.js","sourceRoot":"","sources":["../../../../packages/scene/src/SpotLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC1B,YAAY,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3B,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAG,EAAE,CAAC;IAE1B,YAAY,IAAI,GAAG,WAAW,EAAE,EAAW;QACzC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,8CAA8C,CAAC,CAAC;QACvI,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAa;QACxB,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,4CAA4C,CAAC,CAAC;QAChI,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAC;QACjI,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;CACF"}

package/dist/scene/TransformNode.d.ts

@@ -0,0 +1,26 @@
+import { type Mat4, type Quat, type Vec3 } from "./MathTypes.js";
+export declare class TransformNode {
+    private dirty;
+    private readonly dirtyListeners;
+    matrixAutoUpdate: boolean;
+    readonly position: Vec3;
+    readonly rotation: Quat;
+    readonly scale: Vec3;
+    localMatrix: Mat4;
+    worldMatrix: Mat4;
+    inverseWorldMatrix: Mat4;
+    setPosition(x: number, y: number, z: number): this;
+    setRotation(x: number, y: number, z: number, w: number): this;
+    setScale(x: number, y: number, z: number): this;
+    setFromLocalMatrix(matrix: Mat4): this;
+    setLocalMatrix(matrix: Mat4, options?: {
+        readonly decompose?: boolean;
+        readonly matrixAutoUpdate?: boolean;
+    }): this;
+    setMatrixAutoUpdate(enabled: boolean): this;
+    markDirty(): this;
+    onDirty(listener: () => void): () => void;
+    isDirty(): boolean;
+    updateWorld(parentWorld?: Mat4, force?: boolean): boolean;
+}
+//# sourceMappingURL=TransformNode.d.ts.map

package/dist/scene/TransformNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformNode.d.ts","sourceRoot":"","sources":["../../../../packages/scene/src/TransformNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AAExB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,gBAAgB,UAAQ;IACxB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAa;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAgB;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAa;IACjC,WAAW,EAAE,IAAI,CAAkB;IACnC,WAAW,EAAE,IAAI,CAAkB;IACnC,kBAAkB,EAAE,IAAI,CAAkB;IAE1C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAOlD,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAS7D,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAetC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAoBvH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK3C,SAAS,IAAI,IAAI;IAQjB,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKzC,OAAO,IAAI,OAAO;IAIlB,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,UAAQ,GAAG,OAAO;CAWxD"}

package/dist/scene/TransformNode.js

@@ -0,0 +1,98 @@
+import { cloneMat4, composeMat4, decomposeMat4, identityMat4, invertMat4, multiplyMat4, normalizeQuat } from "./MathTypes.js";
+export class TransformNode {
+    dirty = true;
+    dirtyListeners = new Set();
+    matrixAutoUpdate = true;
+    position = [0, 0, 0];
+    rotation = [0, 0, 0, 1];
+    scale = [1, 1, 1];
+    localMatrix = identityMat4();
+    worldMatrix = identityMat4();
+    inverseWorldMatrix = identityMat4();
+    setPosition(x, y, z) {
+        this.position[0] = x;
+        this.position[1] = y;
+        this.position[2] = z;
+        return this.markDirty();
+    }
+    setRotation(x, y, z, w) {
+        const normalized = normalizeQuat([x, y, z, w]);
+        this.rotation[0] = normalized[0];
+        this.rotation[1] = normalized[1];
+        this.rotation[2] = normalized[2];
+        this.rotation[3] = normalized[3];
+        return this.markDirty();
+    }
+    setScale(x, y, z) {
+        this.scale[0] = x;
+        this.scale[1] = y;
+        this.scale[2] = z;
+        return this.markDirty();
+    }
+    setFromLocalMatrix(matrix) {
+        const decomposed = decomposeMat4(matrix);
+        this.position[0] = decomposed.position[0];
+        this.position[1] = decomposed.position[1];
+        this.position[2] = decomposed.position[2];
+        this.rotation[0] = decomposed.rotation[0];
+        this.rotation[1] = decomposed.rotation[1];
+        this.rotation[2] = decomposed.rotation[2];
+        this.rotation[3] = decomposed.rotation[3];
+        this.scale[0] = decomposed.scale[0];
+        this.scale[1] = decomposed.scale[1];
+        this.scale[2] = decomposed.scale[2];
+        return this.markDirty();
+    }
+    setLocalMatrix(matrix, options = {}) {
+        if (!matrix.every(Number.isFinite))
+            throw new Error("Transform local matrix must contain finite values.");
+        this.localMatrix = cloneMat4(matrix);
+        this.matrixAutoUpdate = options.matrixAutoUpdate ?? false;
+        if (options.decompose ?? true) {
+            const decomposed = decomposeMat4(matrix);
+            this.position[0] = decomposed.position[0];
+            this.position[1] = decomposed.position[1];
+            this.position[2] = decomposed.position[2];
+            this.rotation[0] = decomposed.rotation[0];
+            this.rotation[1] = decomposed.rotation[1];
+            this.rotation[2] = decomposed.rotation[2];
+            this.rotation[3] = decomposed.rotation[3];
+            this.scale[0] = decomposed.scale[0];
+            this.scale[1] = decomposed.scale[1];
+            this.scale[2] = decomposed.scale[2];
+        }
+        return this.markDirty();
+    }
+    setMatrixAutoUpdate(enabled) {
+        this.matrixAutoUpdate = enabled;
+        return this.markDirty();
+    }
+    markDirty() {
+        if (!this.dirty) {
+            this.dirty = true;
+            for (const listener of [...this.dirtyListeners])
+                listener();
+        }
+        return this;
+    }
+    onDirty(listener) {
+        this.dirtyListeners.add(listener);
+        return () => this.dirtyListeners.delete(listener);
+    }
+    isDirty() {
+        return this.dirty;
+    }
+    updateWorld(parentWorld, force = false) {
+        const shouldUpdate = force || this.dirty;
+        if (!shouldUpdate)
+            return false;
+        if (this.matrixAutoUpdate) {
+            this.localMatrix = composeMat4(this.position, this.rotation, this.scale);
+        }
+        this.worldMatrix = parentWorld ? multiplyMat4(parentWorld, this.localMatrix) : cloneMat4(this.localMatrix);
+        this.inverseWorldMatrix = invertMat4(this.worldMatrix);
+        this.dirty = false;
+        return true;
+    }
+}
+//# sourceMappingURL=TransformNode.js.map