@iwsdk/core 0.1.0

package/dist/scene-understanding/scene-understanding-system.js

@@ -0,0 +1,342 @@
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import { Types } from 'elics';
+import '../ecs/component-registry.js';
+import '../runtime/three.js';
+import { XRAnchor } from './anchor.js';
+import { XRMesh } from './mesh.js';
+import { XRPlane } from './plane.js';
+import { Group, Matrix4, Mesh, Vector3, BoxGeometry, MeshBasicMaterial, BufferGeometry, BufferAttribute } from 'three';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Manages WebXR scene understanding features including plane detection, mesh detection, and anchoring.
+ *
+ * @remarks
+ * - Automatically detects and visualizes real‑world planes and meshes in AR/VR environments.
+ * - Creates entities with {@link XRPlane} components for detected planes (floors, walls, ceilings).
+ * - Creates entities with {@link XRMesh} components for detected 3D geometry.
+ * - Supports anchoring objects to real‑world positions using {@link XRAnchor} components.
+ * - Requires WebXR session features: 'plane‑detection', 'mesh‑detection', 'anchor' when using the related features.
+ * - Automatically manages entity lifecycle as real‑world geometry changes.
+ * - Provides optional visual feedback with wireframe meshes for detected geometry.
+ * - Objects with {@link XRAnchor} are automatically attached to a stable world‑anchored group.
+ *
+ * @example Basic scene understanding setup
+ * ```ts
+ * // WebXR session must request required features
+ * World.create(document.getElementById('scene-container'), {
+ *   assets,
+ *   xr: {
+ *     sessionMode: SessionMode.ImmersiveAR,
+ *     features: { planeDetection: true, meshDetection: true, anchors: true },
+ *   }
+ * })
+ *
+ * // Add to your world to enable scene understanding
+ * world.addSystem(SceneUnderstandingSystem)
+ *
+
+ * ```
+ *
+ * @example Create an anchored object
+ * ```ts
+ * const cube = world.createTransformEntity(cubeObject)
+ * cube.addComponent(XRAnchor) // Will be anchored to real-world position
+ * ```
+ *
+ * @example React to detected planes
+ * ```ts
+ * // Planes are automatically created as entities with XRPlane component
+ * system.query({ required: [XRPlane] }).subscribe('qualify', (entity) => {
+ *   const plane = entity.getValue(XRPlane, '_plane')
+ *   console.log('New plane detected:', plane.orientation)
+ * })
+ * ```
+ *
+ * @category Scene Understanding
+ * @see {@link XRPlane}
+ * @see {@link XRMesh}
+ * @see {@link XRAnchor}
+ */
+class SceneUnderstandingSystem extends createSystem({
+    planeEntities: { required: [XRPlane] },
+    meshEntities: { required: [XRMesh] },
+    anchoredEntities: { required: [XRAnchor] },
+}, {
+    showWireFrame: { type: Types.Boolean, default: false },
+}) {
+    constructor() {
+        super(...arguments);
+        this.anchorRequested = false;
+        this.currentPlanes = new Map();
+        this.currentMeshes = new Map();
+        this.anchoredGroup = new Group();
+        this.matrixBuffer = new Matrix4();
+    }
+    init() {
+        this.xrManager.addEventListener('sessionstart', async () => {
+            this.updateEnabledFeatures(this.xrManager.getSession());
+            // Temporarily disabling initiateRoomCapture API call due to the anhor wiping issue.
+            // const planes = this.xrManager.getFrame()?.detectedPlanes;
+            // const meshes = this.xrManager.getFrame()?.detectedMeshes;
+            // if (
+            // 	(!planes || planes.size === 0) &&
+            // 	(!meshes || meshes.size === 0) &&
+            // 	(this.planeFeatureEnabled || this.meshFeatureEnabled)
+            // ) {
+            // 	await this.xrManager.getSession()?.initiateRoomCapture();
+            // }
+        });
+        this.scene.add(this.anchoredGroup);
+        this.config.showWireFrame.subscribe((value) => {
+            this.queries.planeEntities.entities.forEach((planeEntity) => {
+                const planeObject = planeEntity.object3D;
+                if (planeObject instanceof Mesh) {
+                    planeObject.material.visible = value;
+                }
+            });
+            this.queries.meshEntities.entities.forEach((meshEntity) => {
+                const meshObject = meshEntity.object3D;
+                if (meshObject instanceof Mesh) {
+                    meshObject.material.visible = value;
+                }
+            });
+        });
+    }
+    update(_delta, _time) {
+        var _a;
+        const frame = this.xrFrame;
+        const planes = frame === null || frame === void 0 ? void 0 : frame.detectedPlanes;
+        const meshes = frame === null || frame === void 0 ? void 0 : frame.detectedMeshes;
+        const referenceSpace = this.xrManager.getReferenceSpace();
+        if (this.planeFeatureEnabled) {
+            this.updatePlanes(planes, referenceSpace);
+        }
+        if (this.meshFeatureEnabled) {
+            this.updateMeshes(meshes, referenceSpace);
+        }
+        if (this.anchorFeatureEnabled &&
+            this.xrAnchor === undefined &&
+            !this.anchorRequested) {
+            this.createAnchor(referenceSpace);
+        }
+        if (this.xrAnchor && referenceSpace) {
+            this.updateAnchoredObject();
+            const pose = (_a = this.xrManager
+                .getFrame()) === null || _a === void 0 ? void 0 : _a.getPose(this.xrAnchor.anchorSpace, referenceSpace);
+            if (pose) {
+                new Matrix4()
+                    .fromArray(pose.transform.matrix)
+                    .decompose(this.anchoredGroup.position, this.anchoredGroup.quaternion, new Vector3());
+            }
+        }
+    }
+    updatePlanes(planes, referenceSpace) {
+        this.currentPlanes.clear();
+        this.queries.planeEntities.entities.forEach((planeEntity) => {
+            if (planes === null || planes === void 0 ? void 0 : planes.has(planeEntity.getValue(XRPlane, '_plane'))) {
+                this.currentPlanes.set(planeEntity.getValue(XRPlane, '_plane'), planeEntity);
+            }
+            else {
+                planeEntity.destroy();
+            }
+        });
+        if (planes) {
+            planes.forEach((plane) => {
+                var _a;
+                if (referenceSpace != null) {
+                    const pose = this.xrManager
+                        .getFrame()
+                        .getPose(plane.planeSpace, referenceSpace);
+                    if (!pose) {
+                        return;
+                    }
+                    this.matrixBuffer.fromArray(pose.transform.matrix);
+                    const polygon = plane.polygon;
+                    let minX = Number.MAX_SAFE_INTEGER;
+                    let maxX = Number.MIN_SAFE_INTEGER;
+                    let minZ = Number.MAX_SAFE_INTEGER;
+                    let maxZ = Number.MIN_SAFE_INTEGER;
+                    for (const point of polygon) {
+                        minX = Math.min(minX, point.x);
+                        maxX = Math.max(maxX, point.x);
+                        minZ = Math.min(minZ, point.z);
+                        maxZ = Math.max(maxZ, point.z);
+                    }
+                    const width = maxX - minX;
+                    const height = maxZ - minZ;
+                    const geometry = new BoxGeometry(width, 0.01, height);
+                    const material = new MeshBasicMaterial({
+                        color: 0xffffff * Math.random(),
+                        wireframe: true,
+                        visible: this.config.showWireFrame.value,
+                    });
+                    if (this.currentPlanes.has(plane) === false) {
+                        const mesh = new Mesh(geometry, material);
+                        mesh.position.setFromMatrixPosition(this.matrixBuffer);
+                        mesh.quaternion.setFromRotationMatrix(this.matrixBuffer);
+                        const planeEntity = this.world.createTransformEntity(mesh);
+                        planeEntity.addComponent(XRPlane, {
+                            _plane: plane,
+                        });
+                    }
+                    else {
+                        const planeObject = (_a = this.currentPlanes.get(plane)) === null || _a === void 0 ? void 0 : _a.object3D;
+                        planeObject === null || planeObject === void 0 ? void 0 : planeObject.position.setFromMatrixPosition(this.matrixBuffer);
+                        planeObject === null || planeObject === void 0 ? void 0 : planeObject.quaternion.setFromRotationMatrix(this.matrixBuffer);
+                    }
+                }
+            });
+        }
+    }
+    updateMeshes(meshes, referenceSpace) {
+        this.currentMeshes.clear();
+        this.queries.meshEntities.entities.forEach((meshEntity) => {
+            if (meshes === null || meshes === void 0 ? void 0 : meshes.has(meshEntity.getValue(XRMesh, '_mesh'))) {
+                this.currentMeshes.set(meshEntity.getValue(XRMesh, '_mesh'), meshEntity);
+            }
+            else {
+                meshEntity.destroy();
+            }
+        });
+        if (meshes) {
+            meshes.forEach((mesh) => {
+                var _a;
+                if (referenceSpace != null) {
+                    const pose = this.xrManager
+                        .getFrame()
+                        .getPose(mesh.meshSpace, referenceSpace);
+                    if (!pose) {
+                        return;
+                    }
+                    this.matrixBuffer.fromArray(pose.transform.matrix);
+                    const geometry = new BufferGeometry();
+                    geometry.setAttribute('position', new BufferAttribute(mesh.vertices, 3));
+                    geometry.setIndex(new BufferAttribute(mesh.indices, 1));
+                    const material = new MeshBasicMaterial({
+                        color: 0xffffff * Math.random(),
+                        wireframe: true,
+                        visible: this.config.showWireFrame.value,
+                    });
+                    if (this.currentMeshes.has(mesh) === false) {
+                        const threeMesh = new Mesh(geometry, material);
+                        const meshEntity = this.world.createTransformEntity(threeMesh);
+                        threeMesh.position.setFromMatrixPosition(this.matrixBuffer);
+                        threeMesh.quaternion.setFromRotationMatrix(this.matrixBuffer);
+                        if (mesh.semanticLabel === 'global mesh') {
+                            meshEntity.addComponent(XRMesh, {
+                                _mesh: mesh,
+                                isBounded3D: false,
+                            });
+                        }
+                        else {
+                            const { minEntry, maxEntry } = this.findMinMaxEntries(this.flatToVec3Array(mesh.vertices));
+                            meshEntity.addComponent(XRMesh, {
+                                _mesh: mesh,
+                                isBounded3D: true,
+                                semanticLabel: mesh.semanticLabel,
+                                min: [minEntry.x, minEntry.y, minEntry.z],
+                                max: [maxEntry.x, maxEntry.y, maxEntry.z],
+                                dimensions: [
+                                    maxEntry.x - minEntry.x,
+                                    maxEntry.y - minEntry.y,
+                                    maxEntry.z - minEntry.z,
+                                ],
+                            });
+                        }
+                    }
+                    else {
+                        const meshObject = (_a = this.currentMeshes.get(mesh)) === null || _a === void 0 ? void 0 : _a.object3D;
+                        meshObject === null || meshObject === void 0 ? void 0 : meshObject.position.setFromMatrixPosition(this.matrixBuffer);
+                        meshObject === null || meshObject === void 0 ? void 0 : meshObject.quaternion.setFromRotationMatrix(this.matrixBuffer);
+                    }
+                }
+            });
+        }
+    }
+    updateEnabledFeatures(xrSession) {
+        if (!xrSession) {
+            console.log('Warning: xrSession is null when trying to query enabled features. Scene understanding  features are disabled.');
+            return;
+        }
+        const enabledFeatures = xrSession.enabledFeatures;
+        this.planeFeatureEnabled = enabledFeatures === null || enabledFeatures === void 0 ? void 0 : enabledFeatures.includes('plane-detection');
+        this.meshFeatureEnabled = enabledFeatures === null || enabledFeatures === void 0 ? void 0 : enabledFeatures.includes('mesh-detection');
+        this.anchorFeatureEnabled = enabledFeatures === null || enabledFeatures === void 0 ? void 0 : enabledFeatures.includes('anchor');
+        if (!this.planeFeatureEnabled) {
+            console.log('Warning: plane-detection feature not enabled for WebXR session. Partial Scene Understanding features are disabled.');
+        }
+        if (!this.meshFeatureEnabled) {
+            console.log('Warning: mesh-detection feature not enabled for WebXR session. Partial Scene Understanding features are disabled.');
+        }
+        if (!this.anchorFeatureEnabled) {
+            console.log('Warning: anchor feature not enabled for WebXR session. Partial Scene Understanding features are disabled.');
+        }
+    }
+    async createAnchor(referenceSpace) {
+        const frame = this.xrManager.getFrame();
+        if (!frame.createAnchor) {
+            throw 'XRFrame.createAnchor is undefined';
+        }
+        if (!referenceSpace) {
+            throw 'renderer.xr.getReferenceSpace() returned null';
+        }
+        this.anchorRequested = true;
+        this.xrAnchor = await frame.createAnchor(new XRRigidTransform(), referenceSpace);
+        if (!this.xrAnchor) {
+            this.anchorRequested = false;
+            throw 'XRAnchor creation failed';
+        }
+    }
+    updateAnchoredObject() {
+        this.queries.anchoredEntities.entities.forEach((entity) => {
+            const object = entity.object3D;
+            if (object && !entity.getValue(XRAnchor, 'attached')) {
+                this.anchoredGroup.attach(object);
+                entity.setValue(XRAnchor, 'attached', true);
+            }
+        });
+    }
+    flatToVec3Array(arr) {
+        if (!arr || arr.length % 3 !== 0) {
+            throw new Error('Array length must be a multiple of 3.');
+        }
+        const result = [];
+        for (let i = 0; i < arr.length; i += 3) {
+            const obj = {
+                x: arr[i],
+                y: arr[i + 1],
+                z: arr[i + 2],
+            };
+            result.push(obj);
+        }
+        return result;
+    }
+    findMinMaxEntries(arr) {
+        let minEntry = arr[0];
+        let maxEntry = arr[0];
+        let minSum = arr[0].x + arr[0].y + arr[0].z;
+        let maxSum = arr[0].x + arr[0].y + arr[0].z;
+        for (let i = 1; i < arr.length; i++) {
+            const currentSum = arr[i].x + arr[i].y + arr[i].z;
+            if (currentSum < minSum) {
+                minSum = currentSum;
+                minEntry = arr[i];
+            }
+            if (currentSum > maxSum) {
+                maxSum = currentSum;
+                maxEntry = arr[i];
+            }
+        }
+        return { minEntry, maxEntry };
+    }
+}
+
+export { SceneUnderstandingSystem };
+//# sourceMappingURL=scene-understanding-system.js.map

package/dist/scene-understanding/scene-understanding-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-understanding-system.js","sources":["../../src/scene-understanding/scene-understanding-system.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAAA;;;;;AAKG;AAiBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDG;AACG,MAAO,wBAAyB,SAAQ,YAAY,CACxD;AACE,IAAA,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;AACtC,IAAA,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;AACpC,IAAA,gBAAgB,EAAE,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE;CAC3C,EACD;IACE,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;CACvD,CACF,CAAA;AATD,IAAA,WAAA,GAAA;;QAaU,IAAA,CAAA,eAAe,GAAY,KAAK;AAEhC,QAAA,IAAA,CAAA,aAAa,GAAG,IAAI,GAAG,EAAmB;AAC1C,QAAA,IAAA,CAAA,aAAa,GAAG,IAAI,GAAG,EAAkB;AACzC,QAAA,IAAA,CAAA,aAAa,GAAU,IAAI,KAAK,EAAE;AAElC,QAAA,IAAA,CAAA,YAAY,GAAG,IAAI,OAAO,EAAE;IA6TtC;IA3TE,IAAI,GAAA;QACF,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,cAAc,EAAE,YAAW;YACzD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;;;;;;;;;;;AAYzD,QAAA,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC;QAElC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,KAAI;AAC5C,YAAA,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,KAAI;AAC1D,gBAAA,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ;AACxC,gBAAA,IAAI,WAAW,YAAY,IAAI,EAAE;AAC/B,oBAAA,WAAW,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK;gBACtC;AACF,YAAA,CAAC,CAAC;AAEF,YAAA,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,UAAU,KAAI;AACxD,gBAAA,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ;AACtC,gBAAA,IAAI,UAAU,YAAY,IAAI,EAAE;AAC9B,oBAAA,UAAU,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK;gBACrC;AACF,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;IACJ;IAEA,MAAM,CAAC,MAAc,EAAE,KAAa,EAAA;;AAClC,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;QAC1B,MAAM,MAAM,GAAG,KAAK,KAAA,IAAA,IAAL,KAAK,KAAA,MAAA,GAAA,MAAA,GAAL,KAAK,CAAE,cAAc;QACpC,MAAM,MAAM,GAAG,KAAK,KAAA,IAAA,IAAL,KAAK,KAAA,MAAA,GAAA,MAAA,GAAL,KAAK,CAAE,cAAc;QACpC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE;AAEzD,QAAA,IAAI,IAAI,CAAC,mBAAmB,EAAE;AAC5B,YAAA,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC;QAC3C;AAEA,QAAA,IAAI,IAAI,CAAC,kBAAkB,EAAE;AAC3B,YAAA,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC;QAC3C;QAEA,IACE,IAAI,CAAC,oBAAoB;YACzB,IAAI,CAAC,QAAQ,KAAK,SAAS;AAC3B,YAAA,CAAC,IAAI,CAAC,eAAe,EACrB;AACA,YAAA,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;QACnC;AAEA,QAAA,IAAI,IAAI,CAAC,QAAQ,IAAI,cAAc,EAAE;YACnC,IAAI,CAAC,oBAAoB,EAAE;AAC3B,YAAA,MAAM,IAAI,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC;AACf,iBAAA,QAAQ,EAAE,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CACT,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;YACtD,IAAI,IAAI,EAAE;AACR,gBAAA,IAAI,OAAO;AACR,qBAAA,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM;AAC/B,qBAAA,SAAS,CACR,IAAI,CAAC,aAAa,CAAC,QAAQ,EAC3B,IAAI,CAAC,aAAa,CAAC,UAAU,EAC7B,IAAI,OAAO,EAAE,CACd;YACL;QACF;IACF;IAEQ,YAAY,CAClB,MAA8B,EAC9B,cAAuC,EAAA;AAEvC,QAAA,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,KAAI;AAC1D,YAAA,IAAI,MAAM,KAAA,IAAA,IAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAY,CAAC,EAAE;AACnE,gBAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CACpB,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAY,EAClD,WAAW,CACZ;YACH;iBAAO;gBACL,WAAW,CAAC,OAAO,EAAE;YACvB;AACF,QAAA,CAAC,CAAC;QAEF,IAAI,MAAM,EAAE;AACV,YAAA,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,KAAI;;AACvB,gBAAA,IAAI,cAAc,IAAI,IAAI,EAAE;AAC1B,oBAAA,MAAM,IAAI,GAAG,IAAI,CAAC;AACf,yBAAA,QAAQ;AACR,yBAAA,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC;oBAC5C,IAAI,CAAC,IAAI,EAAE;wBACT;oBACF;oBACA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;AAElD,oBAAA,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO;AAE7B,oBAAA,IAAI,IAAI,GAAG,MAAM,CAAC,gBAAgB;AAClC,oBAAA,IAAI,IAAI,GAAG,MAAM,CAAC,gBAAgB;AAClC,oBAAA,IAAI,IAAI,GAAG,MAAM,CAAC,gBAAgB;AAClC,oBAAA,IAAI,IAAI,GAAG,MAAM,CAAC,gBAAgB;AAElC,oBAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;wBAC3B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;wBAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;wBAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;wBAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBAChC;AAEA,oBAAA,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI;AACzB,oBAAA,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI;oBAE1B,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;AACrD,oBAAA,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;AACrC,wBAAA,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE;AAC/B,wBAAA,SAAS,EAAE,IAAI;AACf,wBAAA,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK;AACzC,qBAAA,CAAC;oBAEF,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE;wBAC3C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;wBACzC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;wBACtD,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;wBACxD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC;AAC1D,wBAAA,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE;AAChC,4BAAA,MAAM,EAAE,KAAK;AACd,yBAAA,CAAC;oBACJ;yBAAO;AACL,wBAAA,MAAM,WAAW,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,QAAQ;AAC3D,wBAAA,WAAW,KAAA,IAAA,IAAX,WAAW,KAAA,MAAA,GAAA,MAAA,GAAX,WAAW,CAAE,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;AAC9D,wBAAA,WAAW,KAAA,IAAA,IAAX,WAAW,KAAA,MAAA,GAAA,MAAA,GAAX,WAAW,CAAE,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;oBAClE;gBACF;AACF,YAAA,CAAC,CAAC;QACJ;IACF;IAEQ,YAAY,CAClB,MAA6B,EAC7B,cAAuC,EAAA;AAEvC,QAAA,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,UAAU,KAAI;AACxD,YAAA,IAAI,MAAM,KAAA,IAAA,IAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAW,CAAC,EAAE;AAC/D,gBAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CACpB,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAW,EAC9C,UAAU,CACX;YACH;iBAAO;gBACL,UAAU,CAAC,OAAO,EAAE;YACtB;AACF,QAAA,CAAC,CAAC;QAEF,IAAI,MAAM,EAAE;AACV,YAAA,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAI;;AACtB,gBAAA,IAAI,cAAc,IAAI,IAAI,EAAE;AAC1B,oBAAA,MAAM,IAAI,GAAG,IAAI,CAAC;AACf,yBAAA,QAAQ;AACR,yBAAA,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC;oBAC1C,IAAI,CAAC,IAAI,EAAE;wBACT;oBACF;oBACA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;AAElD,oBAAA,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE;AACrC,oBAAA,QAAQ,CAAC,YAAY,CACnB,UAAU,EACV,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CACtC;AACD,oBAAA,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACvD,oBAAA,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;AACrC,wBAAA,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE;AAC/B,wBAAA,SAAS,EAAE,IAAI;AACf,wBAAA,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK;AACzC,qBAAA,CAAC;oBAEF,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE;wBAC1C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;wBAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC;wBAC9D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;wBAC3D,SAAS,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;AAE7D,wBAAA,IAAI,IAAI,CAAC,aAAa,KAAK,aAAa,EAAE;AACxC,4BAAA,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE;AAC9B,gCAAA,KAAK,EAAE,IAAI;AACX,gCAAA,WAAW,EAAE,KAAK;AACnB,6BAAA,CAAC;wBACJ;6BAAO;AACL,4BAAA,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,iBAAiB,CACnD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CACpC;AACD,4BAAA,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE;AAC9B,gCAAA,KAAK,EAAE,IAAI;AACX,gCAAA,WAAW,EAAE,IAAI;gCACjB,aAAa,EAAE,IAAI,CAAC,aAAa;AACjC,gCAAA,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzC,gCAAA,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzC,gCAAA,UAAU,EAAE;AACV,oCAAA,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,oCAAA,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,oCAAA,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;AACxB,iCAAA;AACF,6BAAA,CAAC;wBACJ;oBACF;yBAAO;AACL,wBAAA,MAAM,UAAU,GAAG,CAAA,EAAA,GAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,QAAQ;AACzD,wBAAA,UAAU,KAAA,IAAA,IAAV,UAAU,KAAA,MAAA,GAAA,MAAA,GAAV,UAAU,CAAE,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;AAC7D,wBAAA,UAAU,KAAA,IAAA,IAAV,UAAU,KAAA,MAAA,GAAA,MAAA,GAAV,UAAU,CAAE,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;oBACjE;gBACF;AACF,YAAA,CAAC,CAAC;QACJ;IACF;AAEQ,IAAA,qBAAqB,CAAC,SAA2B,EAAA;QACvD,IAAI,CAAC,SAAS,EAAE;AACd,YAAA,OAAO,CAAC,GAAG,CACT,+GAA+G,CAChH;YACD;QACF;AAEA,QAAA,MAAM,eAAe,GAAG,SAAS,CAAC,eAAe;AACjD,QAAA,IAAI,CAAC,mBAAmB,GAAG,eAAe,KAAA,IAAA,IAAf,eAAe,KAAA,MAAA,GAAA,MAAA,GAAf,eAAe,CAAE,QAAQ,CAAC,iBAAiB,CAAC;AACvE,QAAA,IAAI,CAAC,kBAAkB,GAAG,eAAe,KAAA,IAAA,IAAf,eAAe,KAAA,MAAA,GAAA,MAAA,GAAf,eAAe,CAAE,QAAQ,CAAC,gBAAgB,CAAC;AACrE,QAAA,IAAI,CAAC,oBAAoB,GAAG,eAAe,KAAA,IAAA,IAAf,eAAe,KAAA,MAAA,GAAA,MAAA,GAAf,eAAe,CAAE,QAAQ,CAAC,QAAQ,CAAC;AAE/D,QAAA,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;AAC7B,YAAA,OAAO,CAAC,GAAG,CACT,oHAAoH,CACrH;QACH;AAEA,QAAA,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE;AAC5B,YAAA,OAAO,CAAC,GAAG,CACT,mHAAmH,CACpH;QACH;AAEA,QAAA,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE;AAC9B,YAAA,OAAO,CAAC,GAAG,CACT,2GAA2G,CAC5G;QACH;IACF;IAEQ,MAAM,YAAY,CAAC,cAAuC,EAAA;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;AACvC,QAAA,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;AACvB,YAAA,MAAM,mCAAmC;QAC3C;QACA,IAAI,CAAC,cAAc,EAAE;AACnB,YAAA,MAAM,+CAA+C;QACvD;AAEA,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI;AAC3B,QAAA,IAAI,CAAC,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CACtC,IAAI,gBAAgB,EAAE,EACtB,cAAc,CACf;AACD,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;AAClB,YAAA,IAAI,CAAC,eAAe,GAAG,KAAK;AAC5B,YAAA,MAAM,0BAA0B;QAClC;IACF;IAEQ,oBAAoB,GAAA;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,KAAI;AACxD,YAAA,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ;AAC9B,YAAA,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;AACpD,gBAAA,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC;YAC7C;AACF,QAAA,CAAC,CAAC;IACJ;AAEQ,IAAA,eAAe,CAAC,GAAiB,EAAA;QACvC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE;AAChC,YAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;QAC1D;QACA,MAAM,MAAM,GAAG,EAAE;AACjB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;AACtC,YAAA,MAAM,GAAG,GAAG;AACV,gBAAA,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACT,gBAAA,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACb,gBAAA,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;aACd;AACD,YAAA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAClB;AACA,QAAA,OAAO,MAAM;IACf;AAEQ,IAAA,iBAAiB,CAAC,GAA0C,EAAA;AAClE,QAAA,IAAI,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;AACrB,QAAA,IAAI,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;QACrB,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnC,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,YAAA,IAAI,UAAU,GAAG,MAAM,EAAE;gBACvB,MAAM,GAAG,UAAU;AACnB,gBAAA,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;YACnB;AACA,YAAA,IAAI,UAAU,GAAG,MAAM,EAAE;gBACvB,MAAM,GAAG,UAAU;AACnB,gBAAA,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;YACnB;QACF;AACA,QAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC/B;AACD;;;;"}

package/dist/transform/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export * from './transform.js';
+export * from './synced-vector3.js';
+export * from './synced-quaternion.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}

package/dist/transform/synced-quaternion.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Quaternion } from '../runtime/three.js';
+/**
+ * Quaternion whose internal `_x/_y/_z/_w` are backed by a Float32Array.
+ *
+ * @remarks
+ * - Three.js quaternion math reads/writes the internal fields; by replacing
+ *   those with array‑backed accessors, all operations become zero‑copy against
+ *   the ECS component buffer.
+ * - When no target is set, it behaves like a normal `Quaternion`.
+ *
+ * @category Scene
+ */
+export declare class SyncedQuaternion extends Quaternion {
+    private target;
+    private targetOffset;
+    private __x;
+    private __y;
+    private __z;
+    private __w;
+    constructor(x?: number, y?: number, z?: number, w?: number);
+    private setupProperties;
+    /**
+     * Bind this quaternion to a packed float array.
+     * @param target Float32Array to read/write (xyzw at consecutive indices).
+     * @param offset Starting index within the array (x at `offset`).
+     */
+    setTarget(target: Float32Array, offset?: number): this;
+}
+//# sourceMappingURL=synced-quaternion.d.ts.map

package/dist/transform/synced-quaternion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synced-quaternion.d.ts","sourceRoot":"","sources":["../../src/transform/synced-quaternion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,GAAG,CAAa;gBAEZ,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI;IAUtC,OAAO,CAAC,eAAe;IA+EvB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,SAAI,GAAG,IAAI;CAKlD"}

package/dist/transform/synced-quaternion.js

@@ -0,0 +1,128 @@
+import '../runtime/three.js';
+import { Quaternion } from 'three';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Quaternion whose internal `_x/_y/_z/_w` are backed by a Float32Array.
+ *
+ * @remarks
+ * - Three.js quaternion math reads/writes the internal fields; by replacing
+ *   those with array‑backed accessors, all operations become zero‑copy against
+ *   the ECS component buffer.
+ * - When no target is set, it behaves like a normal `Quaternion`.
+ *
+ * @category Scene
+ */
+class SyncedQuaternion extends Quaternion {
+    constructor(x = 0, y = 0, z = 0, w = 1) {
+        super(x, y, z, w);
+        this.target = null;
+        this.targetOffset = 0;
+        this.__x = 0;
+        this.__y = 0;
+        this.__z = 0;
+        this.__w = 1;
+        // Preserve the values set by parent constructor before overriding properties
+        this.__x = this._x;
+        this.__y = this._y;
+        this.__z = this._z;
+        this.__w = this._w;
+        this.setupProperties();
+    }
+    setupProperties() {
+        // Override the internal _x, _y, _z, _w properties to sync with target
+        // This approach leverages the existing Three.js getter/setter architecture
+        // All Three.js methods will automatically sync because they use these internal properties
+        Object.defineProperty(this, '_x', {
+            get: () => {
+                if (this.target) {
+                    return this.target[this.targetOffset];
+                }
+                // Fallback to a private property when no target is set
+                return this.__x;
+            },
+            set: (value) => {
+                if (this.target) {
+                    this.target[this.targetOffset] = value;
+                }
+                else {
+                    this.__x = value;
+                }
+            },
+            enumerable: true,
+            configurable: true,
+        });
+        Object.defineProperty(this, '_y', {
+            get: () => {
+                if (this.target) {
+                    return this.target[this.targetOffset + 1];
+                }
+                return this.__y;
+            },
+            set: (value) => {
+                if (this.target) {
+                    this.target[this.targetOffset + 1] = value;
+                }
+                else {
+                    this.__y = value;
+                }
+            },
+            enumerable: true,
+            configurable: true,
+        });
+        Object.defineProperty(this, '_z', {
+            get: () => {
+                if (this.target) {
+                    return this.target[this.targetOffset + 2];
+                }
+                return this.__z;
+            },
+            set: (value) => {
+                if (this.target) {
+                    this.target[this.targetOffset + 2] = value;
+                }
+                else {
+                    this.__z = value;
+                }
+            },
+            enumerable: true,
+            configurable: true,
+        });
+        Object.defineProperty(this, '_w', {
+            get: () => {
+                if (this.target) {
+                    return this.target[this.targetOffset + 3];
+                }
+                return this.__w;
+            },
+            set: (value) => {
+                if (this.target) {
+                    this.target[this.targetOffset + 3] = value;
+                }
+                else {
+                    this.__w = value;
+                }
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    }
+    /**
+     * Bind this quaternion to a packed float array.
+     * @param target Float32Array to read/write (xyzw at consecutive indices).
+     * @param offset Starting index within the array (x at `offset`).
+     */
+    setTarget(target, offset = 0) {
+        this.target = target;
+        this.targetOffset = offset;
+        return this;
+    }
+}
+
+export { SyncedQuaternion };
+//# sourceMappingURL=synced-quaternion.js.map

package/dist/transform/synced-quaternion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synced-quaternion.js","sources":["../../src/transform/synced-quaternion.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;;;;;AAKG;AAIH;;;;;;;;;;AAUG;AACG,MAAO,gBAAiB,SAAQ,UAAU,CAAA;AAQ9C,IAAA,WAAA,CAAY,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAA;QACpC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QARX,IAAA,CAAA,MAAM,GAAwB,IAAI;QAClC,IAAA,CAAA,YAAY,GAAW,CAAC;QACxB,IAAA,CAAA,GAAG,GAAW,CAAC;QACf,IAAA,CAAA,GAAG,GAAW,CAAC;QACf,IAAA,CAAA,GAAG,GAAW,CAAC;QACf,IAAA,CAAA,GAAG,GAAW,CAAC;;AAKrB,QAAA,IAAI,CAAC,GAAG,GAAI,IAAY,CAAC,EAAE;AAC3B,QAAA,IAAI,CAAC,GAAG,GAAI,IAAY,CAAC,EAAE;AAC3B,QAAA,IAAI,CAAC,GAAG,GAAI,IAAY,CAAC,EAAE;AAC3B,QAAA,IAAI,CAAC,GAAG,GAAI,IAAY,CAAC,EAAE;QAC3B,IAAI,CAAC,eAAe,EAAE;IACxB;IAEQ,eAAe,GAAA;;;;AAKrB,QAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,MAAK;AACR,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;gBACvC;;gBAEA,OAAO,IAAI,CAAC,GAAG;YACjB,CAAC;AACD,YAAA,GAAG,EAAE,CAAC,KAAa,KAAI;AACrB,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,KAAK;gBACxC;qBAAO;AACL,oBAAA,IAAI,CAAC,GAAG,GAAG,KAAK;gBAClB;YACF,CAAC;AACD,YAAA,UAAU,EAAE,IAAI;AAChB,YAAA,YAAY,EAAE,IAAI;AACnB,SAAA,CAAC;AAEF,QAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,MAAK;AACR,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;gBAC3C;gBACA,OAAO,IAAI,CAAC,GAAG;YACjB,CAAC;AACD,YAAA,GAAG,EAAE,CAAC,KAAa,KAAI;AACrB,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,KAAK;gBAC5C;qBAAO;AACL,oBAAA,IAAI,CAAC,GAAG,GAAG,KAAK;gBAClB;YACF,CAAC;AACD,YAAA,UAAU,EAAE,IAAI;AAChB,YAAA,YAAY,EAAE,IAAI;AACnB,SAAA,CAAC;AAEF,QAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,MAAK;AACR,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;gBAC3C;gBACA,OAAO,IAAI,CAAC,GAAG;YACjB,CAAC;AACD,YAAA,GAAG,EAAE,CAAC,KAAa,KAAI;AACrB,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,KAAK;gBAC5C;qBAAO;AACL,oBAAA,IAAI,CAAC,GAAG,GAAG,KAAK;gBAClB;YACF,CAAC;AACD,YAAA,UAAU,EAAE,IAAI;AAChB,YAAA,YAAY,EAAE,IAAI;AACnB,SAAA,CAAC;AAEF,QAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,MAAK;AACR,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;gBAC3C;gBACA,OAAO,IAAI,CAAC,GAAG;YACjB,CAAC;AACD,YAAA,GAAG,EAAE,CAAC,KAAa,KAAI;AACrB,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE;oBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,KAAK;gBAC5C;qBAAO;AACL,oBAAA,IAAI,CAAC,GAAG,GAAG,KAAK;gBAClB;YACF,CAAC;AACD,YAAA,UAAU,EAAE,IAAI;AAChB,YAAA,YAAY,EAAE,IAAI;AACnB,SAAA,CAAC;IACJ;AAEA;;;;AAIG;AACH,IAAA,SAAS,CAAC,MAAoB,EAAE,MAAM,GAAG,CAAC,EAAA;AACxC,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;AACpB,QAAA,IAAI,CAAC,YAAY,GAAG,MAAM;AAC1B,QAAA,OAAO,IAAI;IACb;AACD;;;;"}

package/dist/transform/synced-vector3.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Vector3 } from '../runtime/three.js';
+/**
+ * Vector3 whose x/y/z accessors read from and write to a target Float32Array.
+ *
+ * @remarks
+ * - Used by {@link TransformSystem} to bind Object3D.position/scale directly to
+ *   ECS component storage for zero‑copy updates.
+ * - When no target is set, falls back to internal fields so it behaves like a
+ *   normal `Vector3`.
+ *
+ * @category Scene
+ */
+export declare class SyncedVector3 extends Vector3 {
+    private target;
+    private targetOffset;
+    private __x;
+    private __y;
+    private __z;
+    constructor(x?: number, y?: number, z?: number);
+    private setupProperties;
+    /**
+     * Bind this vector to a packed float array.
+     * @param target Float32Array to read/write.
+     * @param offset Starting index within the array (x at `offset`).
+     */
+    setTarget(target: Float32Array, offset?: number): this;
+}
+//# sourceMappingURL=synced-vector3.d.ts.map

package/dist/transform/synced-vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synced-vector3.d.ts","sourceRoot":"","sources":["../../src/transform/synced-vector3.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,GAAG,CAAa;gBAEZ,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI;IAS/B,OAAO,CAAC,eAAe;IA0DvB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,SAAI,GAAG,IAAI;CAKlD"}