@spatial-engine/three 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Francisco Rueda Esquivel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ThreeSynchronizer: () => ThreeSynchronizer,
+  box3ToAABB: () => box3ToAABB,
+  rayBox3Intersect: () => rayBox3Intersect,
+  rayToFlatArray: () => rayToFlatArray,
+  threeRayToPool: () => threeRayToPool
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@spatial-engine/core");
+
+// src/synchronizer.ts
+var import_three = require("three");
+var ThreeSynchronizer = class {
+  /** The AABBPool index used to identify this object in the core engine. */
+  id;
+  object;
+  octree;
+  aabbPool;
+  _box = new import_three.Box3();
+  _inserted = false;
+  constructor(object, octree, aabbPool) {
+    this.object = object;
+    this.octree = octree;
+    this.aabbPool = aabbPool;
+    this.id = aabbPool.allocate();
+  }
+  /**
+   * Recompute the object's world-space bounding box and sync it to the
+   * Octree. Call this whenever the object may have moved or changed shape.
+   */
+  sync() {
+    this._box.setFromObject(this.object);
+    const { min, max } = this._box;
+    if (!this._inserted) {
+      this.aabbPool.set(this.id, min.x, min.y, min.z, max.x, max.y, max.z);
+      this.octree.insert(this.id);
+      this._inserted = true;
+    } else {
+      this.octree.update(this.id, min.x, min.y, min.z, max.x, max.y, max.z);
+    }
+  }
+};
+
+// src/index.ts
+function box3ToAABB(pool, box) {
+  const index = pool.allocate();
+  pool.set(
+    index,
+    box.min.x,
+    box.min.y,
+    box.min.z,
+    box.max.x,
+    box.max.y,
+    box.max.z
+  );
+  return index;
+}
+function threeRayToPool(pool, ray) {
+  const index = pool.allocate();
+  pool.set(
+    index,
+    ray.origin.x,
+    ray.origin.y,
+    ray.origin.z,
+    ray.direction.x,
+    ray.direction.y,
+    ray.direction.z
+  );
+  return index;
+}
+function rayToFlatArray(ray, buf = new Float32Array(import_core.RAY_STRIDE)) {
+  buf[0] = ray.origin.x;
+  buf[1] = ray.origin.y;
+  buf[2] = ray.origin.z;
+  buf[3] = ray.direction.x;
+  buf[4] = ray.direction.y;
+  buf[5] = ray.direction.z;
+  return buf;
+}
+var _rayBuf = new Float32Array(import_core.RAY_STRIDE);
+var _aabbBuf = new Float32Array(6);
+function rayBox3Intersect(ray, box) {
+  _rayBuf[0] = ray.origin.x;
+  _rayBuf[1] = ray.origin.y;
+  _rayBuf[2] = ray.origin.z;
+  _rayBuf[3] = ray.direction.x;
+  _rayBuf[4] = ray.direction.y;
+  _rayBuf[5] = ray.direction.z;
+  _aabbBuf[0] = box.min.x;
+  _aabbBuf[1] = box.min.y;
+  _aabbBuf[2] = box.min.z;
+  _aabbBuf[3] = box.max.x;
+  _aabbBuf[4] = box.max.y;
+  _aabbBuf[5] = box.max.z;
+  return (0, import_core.rayIntersectsAABB)(_rayBuf, 0, _aabbBuf, 0);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ThreeSynchronizer,
+  box3ToAABB,
+  rayBox3Intersect,
+  rayToFlatArray,
+  threeRayToPool
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/synchronizer.ts"],"sourcesContent":["import type { Box3, Ray } from 'three';\nimport { AABBPool, RayPool, rayIntersectsAABB, RAY_STRIDE } from '@spatial-engine/core';\n\nexport { ThreeSynchronizer } from './synchronizer.js';\n\n/**\n * Convert a Three.js Box3 into an AABB slot in the pool.\n * Returns the allocated index.\n */\nexport function box3ToAABB(pool: AABBPool, box: Box3): number {\n  const index = pool.allocate();\n  pool.set(\n    index,\n    box.min.x,\n    box.min.y,\n    box.min.z,\n    box.max.x,\n    box.max.y,\n    box.max.z,\n  );\n  return index;\n}\n\n/**\n * Convert a Three.js Ray into a Ray slot in the pool.\n * Returns the allocated index.\n */\nexport function threeRayToPool(pool: RayPool, ray: Ray): number {\n  const index = pool.allocate();\n  pool.set(\n    index,\n    ray.origin.x,\n    ray.origin.y,\n    ray.origin.z,\n    ray.direction.x,\n    ray.direction.y,\n    ray.direction.z,\n  );\n  return index;\n}\n\n/**\n * Fill a pre-allocated (or newly created) Float32Array with the ray data in\n * the flat format `[ox, oy, oz, dx, dy, dz]` expected by the core query engine.\n *\n * @param ray The Three.js Ray to convert.\n * @param buf Optional pre-allocated Float32Array of length RAY_STRIDE (6).\n *            If omitted a new buffer is created. Pass a cached buffer to\n *            avoid allocation and stay zero-GC.\n * @returns The filled buffer (same reference as `buf` when provided).\n */\nexport function rayToFlatArray(ray: Ray, buf: Float32Array = new Float32Array(RAY_STRIDE)): Float32Array {\n  buf[0] = ray.origin.x;\n  buf[1] = ray.origin.y;\n  buf[2] = ray.origin.z;\n  buf[3] = ray.direction.x;\n  buf[4] = ray.direction.y;\n  buf[5] = ray.direction.z;\n  return buf;\n}\n\n/**\n * Test whether a Three.js Ray intersects a Three.js Box3.\n * Returns the parametric hit distance `t` or -1 on miss.\n * Uses pre-allocated Float32Array buffers to stay zero-GC.\n */\nconst _rayBuf = new Float32Array(RAY_STRIDE);\nconst _aabbBuf = new Float32Array(6);\n\nexport function rayBox3Intersect(ray: Ray, box: Box3): number {\n  _rayBuf[0] = ray.origin.x;\n  _rayBuf[1] = ray.origin.y;\n  _rayBuf[2] = ray.origin.z;\n  _rayBuf[3] = ray.direction.x;\n  _rayBuf[4] = ray.direction.y;\n  _rayBuf[5] = ray.direction.z;\n\n  _aabbBuf[0] = box.min.x;\n  _aabbBuf[1] = box.min.y;\n  _aabbBuf[2] = box.min.z;\n  _aabbBuf[3] = box.max.x;\n  _aabbBuf[4] = box.max.y;\n  _aabbBuf[5] = box.max.z;\n\n  return rayIntersectsAABB(_rayBuf, 0, _aabbBuf, 0);\n}\n","import type { Mesh, Group } from 'three';\nimport { Box3 } from 'three';\nimport { AABBPool, Octree } from '@spatial-engine/core';\n\n/**\n * Synchronizes a THREE.Mesh or THREE.Group with a spatial-engine Octree.\n *\n * On the first call to `sync()` the object's world-space bounding box is\n * computed, stored in the AABBPool, and inserted into the Octree.\n * Subsequent calls to `sync()` recompute the bounding box and call\n * `Octree.update()` to reposition the entry without a full reinsertion.\n *\n * Each synchronizer occupies exactly one slot in the supplied AABBPool;\n * that slot's index is exposed as the read-only `id` property.\n */\nexport class ThreeSynchronizer {\n  /** The AABBPool index used to identify this object in the core engine. */\n  readonly id: number;\n\n  private readonly object: Mesh | Group;\n  private readonly octree: Octree;\n  private readonly aabbPool: AABBPool;\n  private readonly _box: Box3 = new Box3();\n  private _inserted: boolean = false;\n\n  constructor(object: Mesh | Group, octree: Octree, aabbPool: AABBPool) {\n    this.object = object;\n    this.octree = octree;\n    this.aabbPool = aabbPool;\n    this.id = aabbPool.allocate();\n  }\n\n  /**\n   * Recompute the object's world-space bounding box and sync it to the\n   * Octree. Call this whenever the object may have moved or changed shape.\n   */\n  sync(): void {\n    this._box.setFromObject(this.object);\n    const { min, max } = this._box;\n\n    if (!this._inserted) {\n      this.aabbPool.set(this.id, min.x, min.y, min.z, max.x, max.y, max.z);\n      this.octree.insert(this.id);\n      this._inserted = true;\n    } else {\n      this.octree.update(this.id, min.x, min.y, min.z, max.x, max.y, max.z);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAAiE;;;ACAjE,mBAAqB;AAcd,IAAM,oBAAN,MAAwB;AAAA;AAAA,EAEpB;AAAA,EAEQ;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAa,IAAI,kBAAK;AAAA,EAC/B,YAAqB;AAAA,EAE7B,YAAY,QAAsB,QAAgB,UAAoB;AACpE,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,KAAK,SAAS,SAAS;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAa;AACX,SAAK,KAAK,cAAc,KAAK,MAAM;AACnC,UAAM,EAAE,KAAK,IAAI,IAAI,KAAK;AAE1B,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,SAAS,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACnE,WAAK,OAAO,OAAO,KAAK,EAAE;AAC1B,WAAK,YAAY;AAAA,IACnB,OAAO;AACL,WAAK,OAAO,OAAO,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAAA,IACtE;AAAA,EACF;AACF;;;ADvCO,SAAS,WAAW,MAAgB,KAAmB;AAC5D,QAAM,QAAQ,KAAK,SAAS;AAC5B,OAAK;AAAA,IACH;AAAA,IACA,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,EACV;AACA,SAAO;AACT;AAMO,SAAS,eAAe,MAAe,KAAkB;AAC9D,QAAM,QAAQ,KAAK,SAAS;AAC5B,OAAK;AAAA,IACH;AAAA,IACA,IAAI,OAAO;AAAA,IACX,IAAI,OAAO;AAAA,IACX,IAAI,OAAO;AAAA,IACX,IAAI,UAAU;AAAA,IACd,IAAI,UAAU;AAAA,IACd,IAAI,UAAU;AAAA,EAChB;AACA,SAAO;AACT;AAYO,SAAS,eAAe,KAAU,MAAoB,IAAI,aAAa,sBAAU,GAAiB;AACvG,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,SAAO;AACT;AAOA,IAAM,UAAU,IAAI,aAAa,sBAAU;AAC3C,IAAM,WAAW,IAAI,aAAa,CAAC;AAE5B,SAAS,iBAAiB,KAAU,KAAmB;AAC5D,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,UAAU;AAC3B,UAAQ,CAAC,IAAI,IAAI,UAAU;AAC3B,UAAQ,CAAC,IAAI,IAAI,UAAU;AAE3B,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AAEtB,aAAO,+BAAkB,SAAS,GAAG,UAAU,CAAC;AAClD;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+import { Mesh, Group, Box3, Ray } from 'three';
+import { Octree, AABBPool, RayPool } from '@spatial-engine/core';
+
+/**
+ * Synchronizes a THREE.Mesh or THREE.Group with a spatial-engine Octree.
+ *
+ * On the first call to `sync()` the object's world-space bounding box is
+ * computed, stored in the AABBPool, and inserted into the Octree.
+ * Subsequent calls to `sync()` recompute the bounding box and call
+ * `Octree.update()` to reposition the entry without a full reinsertion.
+ *
+ * Each synchronizer occupies exactly one slot in the supplied AABBPool;
+ * that slot's index is exposed as the read-only `id` property.
+ */
+declare class ThreeSynchronizer {
+    /** The AABBPool index used to identify this object in the core engine. */
+    readonly id: number;
+    private readonly object;
+    private readonly octree;
+    private readonly aabbPool;
+    private readonly _box;
+    private _inserted;
+    constructor(object: Mesh | Group, octree: Octree, aabbPool: AABBPool);
+    /**
+     * Recompute the object's world-space bounding box and sync it to the
+     * Octree. Call this whenever the object may have moved or changed shape.
+     */
+    sync(): void;
+}
+
+/**
+ * Convert a Three.js Box3 into an AABB slot in the pool.
+ * Returns the allocated index.
+ */
+declare function box3ToAABB(pool: AABBPool, box: Box3): number;
+/**
+ * Convert a Three.js Ray into a Ray slot in the pool.
+ * Returns the allocated index.
+ */
+declare function threeRayToPool(pool: RayPool, ray: Ray): number;
+/**
+ * Fill a pre-allocated (or newly created) Float32Array with the ray data in
+ * the flat format `[ox, oy, oz, dx, dy, dz]` expected by the core query engine.
+ *
+ * @param ray The Three.js Ray to convert.
+ * @param buf Optional pre-allocated Float32Array of length RAY_STRIDE (6).
+ *            If omitted a new buffer is created. Pass a cached buffer to
+ *            avoid allocation and stay zero-GC.
+ * @returns The filled buffer (same reference as `buf` when provided).
+ */
+declare function rayToFlatArray(ray: Ray, buf?: Float32Array): Float32Array;
+declare function rayBox3Intersect(ray: Ray, box: Box3): number;
+
+export { ThreeSynchronizer, box3ToAABB, rayBox3Intersect, rayToFlatArray, threeRayToPool };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { Mesh, Group, Box3, Ray } from 'three';
+import { Octree, AABBPool, RayPool } from '@spatial-engine/core';
+
+/**
+ * Synchronizes a THREE.Mesh or THREE.Group with a spatial-engine Octree.
+ *
+ * On the first call to `sync()` the object's world-space bounding box is
+ * computed, stored in the AABBPool, and inserted into the Octree.
+ * Subsequent calls to `sync()` recompute the bounding box and call
+ * `Octree.update()` to reposition the entry without a full reinsertion.
+ *
+ * Each synchronizer occupies exactly one slot in the supplied AABBPool;
+ * that slot's index is exposed as the read-only `id` property.
+ */
+declare class ThreeSynchronizer {
+    /** The AABBPool index used to identify this object in the core engine. */
+    readonly id: number;
+    private readonly object;
+    private readonly octree;
+    private readonly aabbPool;
+    private readonly _box;
+    private _inserted;
+    constructor(object: Mesh | Group, octree: Octree, aabbPool: AABBPool);
+    /**
+     * Recompute the object's world-space bounding box and sync it to the
+     * Octree. Call this whenever the object may have moved or changed shape.
+     */
+    sync(): void;
+}
+
+/**
+ * Convert a Three.js Box3 into an AABB slot in the pool.
+ * Returns the allocated index.
+ */
+declare function box3ToAABB(pool: AABBPool, box: Box3): number;
+/**
+ * Convert a Three.js Ray into a Ray slot in the pool.
+ * Returns the allocated index.
+ */
+declare function threeRayToPool(pool: RayPool, ray: Ray): number;
+/**
+ * Fill a pre-allocated (or newly created) Float32Array with the ray data in
+ * the flat format `[ox, oy, oz, dx, dy, dz]` expected by the core query engine.
+ *
+ * @param ray The Three.js Ray to convert.
+ * @param buf Optional pre-allocated Float32Array of length RAY_STRIDE (6).
+ *            If omitted a new buffer is created. Pass a cached buffer to
+ *            avoid allocation and stay zero-GC.
+ * @returns The filled buffer (same reference as `buf` when provided).
+ */
+declare function rayToFlatArray(ray: Ray, buf?: Float32Array): Float32Array;
+declare function rayBox3Intersect(ray: Ray, box: Box3): number;
+
+export { ThreeSynchronizer, box3ToAABB, rayBox3Intersect, rayToFlatArray, threeRayToPool };

package/dist/index.js

@@ -0,0 +1,97 @@
+// src/index.ts
+import { rayIntersectsAABB, RAY_STRIDE } from "@spatial-engine/core";
+
+// src/synchronizer.ts
+import { Box3 } from "three";
+var ThreeSynchronizer = class {
+  /** The AABBPool index used to identify this object in the core engine. */
+  id;
+  object;
+  octree;
+  aabbPool;
+  _box = new Box3();
+  _inserted = false;
+  constructor(object, octree, aabbPool) {
+    this.object = object;
+    this.octree = octree;
+    this.aabbPool = aabbPool;
+    this.id = aabbPool.allocate();
+  }
+  /**
+   * Recompute the object's world-space bounding box and sync it to the
+   * Octree. Call this whenever the object may have moved or changed shape.
+   */
+  sync() {
+    this._box.setFromObject(this.object);
+    const { min, max } = this._box;
+    if (!this._inserted) {
+      this.aabbPool.set(this.id, min.x, min.y, min.z, max.x, max.y, max.z);
+      this.octree.insert(this.id);
+      this._inserted = true;
+    } else {
+      this.octree.update(this.id, min.x, min.y, min.z, max.x, max.y, max.z);
+    }
+  }
+};
+
+// src/index.ts
+function box3ToAABB(pool, box) {
+  const index = pool.allocate();
+  pool.set(
+    index,
+    box.min.x,
+    box.min.y,
+    box.min.z,
+    box.max.x,
+    box.max.y,
+    box.max.z
+  );
+  return index;
+}
+function threeRayToPool(pool, ray) {
+  const index = pool.allocate();
+  pool.set(
+    index,
+    ray.origin.x,
+    ray.origin.y,
+    ray.origin.z,
+    ray.direction.x,
+    ray.direction.y,
+    ray.direction.z
+  );
+  return index;
+}
+function rayToFlatArray(ray, buf = new Float32Array(RAY_STRIDE)) {
+  buf[0] = ray.origin.x;
+  buf[1] = ray.origin.y;
+  buf[2] = ray.origin.z;
+  buf[3] = ray.direction.x;
+  buf[4] = ray.direction.y;
+  buf[5] = ray.direction.z;
+  return buf;
+}
+var _rayBuf = new Float32Array(RAY_STRIDE);
+var _aabbBuf = new Float32Array(6);
+function rayBox3Intersect(ray, box) {
+  _rayBuf[0] = ray.origin.x;
+  _rayBuf[1] = ray.origin.y;
+  _rayBuf[2] = ray.origin.z;
+  _rayBuf[3] = ray.direction.x;
+  _rayBuf[4] = ray.direction.y;
+  _rayBuf[5] = ray.direction.z;
+  _aabbBuf[0] = box.min.x;
+  _aabbBuf[1] = box.min.y;
+  _aabbBuf[2] = box.min.z;
+  _aabbBuf[3] = box.max.x;
+  _aabbBuf[4] = box.max.y;
+  _aabbBuf[5] = box.max.z;
+  return rayIntersectsAABB(_rayBuf, 0, _aabbBuf, 0);
+}
+export {
+  ThreeSynchronizer,
+  box3ToAABB,
+  rayBox3Intersect,
+  rayToFlatArray,
+  threeRayToPool
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/synchronizer.ts"],"sourcesContent":["import type { Box3, Ray } from 'three';\nimport { AABBPool, RayPool, rayIntersectsAABB, RAY_STRIDE } from '@spatial-engine/core';\n\nexport { ThreeSynchronizer } from './synchronizer.js';\n\n/**\n * Convert a Three.js Box3 into an AABB slot in the pool.\n * Returns the allocated index.\n */\nexport function box3ToAABB(pool: AABBPool, box: Box3): number {\n  const index = pool.allocate();\n  pool.set(\n    index,\n    box.min.x,\n    box.min.y,\n    box.min.z,\n    box.max.x,\n    box.max.y,\n    box.max.z,\n  );\n  return index;\n}\n\n/**\n * Convert a Three.js Ray into a Ray slot in the pool.\n * Returns the allocated index.\n */\nexport function threeRayToPool(pool: RayPool, ray: Ray): number {\n  const index = pool.allocate();\n  pool.set(\n    index,\n    ray.origin.x,\n    ray.origin.y,\n    ray.origin.z,\n    ray.direction.x,\n    ray.direction.y,\n    ray.direction.z,\n  );\n  return index;\n}\n\n/**\n * Fill a pre-allocated (or newly created) Float32Array with the ray data in\n * the flat format `[ox, oy, oz, dx, dy, dz]` expected by the core query engine.\n *\n * @param ray The Three.js Ray to convert.\n * @param buf Optional pre-allocated Float32Array of length RAY_STRIDE (6).\n *            If omitted a new buffer is created. Pass a cached buffer to\n *            avoid allocation and stay zero-GC.\n * @returns The filled buffer (same reference as `buf` when provided).\n */\nexport function rayToFlatArray(ray: Ray, buf: Float32Array = new Float32Array(RAY_STRIDE)): Float32Array {\n  buf[0] = ray.origin.x;\n  buf[1] = ray.origin.y;\n  buf[2] = ray.origin.z;\n  buf[3] = ray.direction.x;\n  buf[4] = ray.direction.y;\n  buf[5] = ray.direction.z;\n  return buf;\n}\n\n/**\n * Test whether a Three.js Ray intersects a Three.js Box3.\n * Returns the parametric hit distance `t` or -1 on miss.\n * Uses pre-allocated Float32Array buffers to stay zero-GC.\n */\nconst _rayBuf = new Float32Array(RAY_STRIDE);\nconst _aabbBuf = new Float32Array(6);\n\nexport function rayBox3Intersect(ray: Ray, box: Box3): number {\n  _rayBuf[0] = ray.origin.x;\n  _rayBuf[1] = ray.origin.y;\n  _rayBuf[2] = ray.origin.z;\n  _rayBuf[3] = ray.direction.x;\n  _rayBuf[4] = ray.direction.y;\n  _rayBuf[5] = ray.direction.z;\n\n  _aabbBuf[0] = box.min.x;\n  _aabbBuf[1] = box.min.y;\n  _aabbBuf[2] = box.min.z;\n  _aabbBuf[3] = box.max.x;\n  _aabbBuf[4] = box.max.y;\n  _aabbBuf[5] = box.max.z;\n\n  return rayIntersectsAABB(_rayBuf, 0, _aabbBuf, 0);\n}\n","import type { Mesh, Group } from 'three';\nimport { Box3 } from 'three';\nimport { AABBPool, Octree } from '@spatial-engine/core';\n\n/**\n * Synchronizes a THREE.Mesh or THREE.Group with a spatial-engine Octree.\n *\n * On the first call to `sync()` the object's world-space bounding box is\n * computed, stored in the AABBPool, and inserted into the Octree.\n * Subsequent calls to `sync()` recompute the bounding box and call\n * `Octree.update()` to reposition the entry without a full reinsertion.\n *\n * Each synchronizer occupies exactly one slot in the supplied AABBPool;\n * that slot's index is exposed as the read-only `id` property.\n */\nexport class ThreeSynchronizer {\n  /** The AABBPool index used to identify this object in the core engine. */\n  readonly id: number;\n\n  private readonly object: Mesh | Group;\n  private readonly octree: Octree;\n  private readonly aabbPool: AABBPool;\n  private readonly _box: Box3 = new Box3();\n  private _inserted: boolean = false;\n\n  constructor(object: Mesh | Group, octree: Octree, aabbPool: AABBPool) {\n    this.object = object;\n    this.octree = octree;\n    this.aabbPool = aabbPool;\n    this.id = aabbPool.allocate();\n  }\n\n  /**\n   * Recompute the object's world-space bounding box and sync it to the\n   * Octree. Call this whenever the object may have moved or changed shape.\n   */\n  sync(): void {\n    this._box.setFromObject(this.object);\n    const { min, max } = this._box;\n\n    if (!this._inserted) {\n      this.aabbPool.set(this.id, min.x, min.y, min.z, max.x, max.y, max.z);\n      this.octree.insert(this.id);\n      this._inserted = true;\n    } else {\n      this.octree.update(this.id, min.x, min.y, min.z, max.x, max.y, max.z);\n    }\n  }\n}\n"],"mappings":";AACA,SAA4B,mBAAmB,kBAAkB;;;ACAjE,SAAS,YAAY;AAcd,IAAM,oBAAN,MAAwB;AAAA;AAAA,EAEpB;AAAA,EAEQ;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAa,IAAI,KAAK;AAAA,EAC/B,YAAqB;AAAA,EAE7B,YAAY,QAAsB,QAAgB,UAAoB;AACpE,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,KAAK,SAAS,SAAS;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAa;AACX,SAAK,KAAK,cAAc,KAAK,MAAM;AACnC,UAAM,EAAE,KAAK,IAAI,IAAI,KAAK;AAE1B,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,SAAS,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACnE,WAAK,OAAO,OAAO,KAAK,EAAE;AAC1B,WAAK,YAAY;AAAA,IACnB,OAAO;AACL,WAAK,OAAO,OAAO,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAAA,IACtE;AAAA,EACF;AACF;;;ADvCO,SAAS,WAAW,MAAgB,KAAmB;AAC5D,QAAM,QAAQ,KAAK,SAAS;AAC5B,OAAK;AAAA,IACH;AAAA,IACA,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,IACR,IAAI,IAAI;AAAA,EACV;AACA,SAAO;AACT;AAMO,SAAS,eAAe,MAAe,KAAkB;AAC9D,QAAM,QAAQ,KAAK,SAAS;AAC5B,OAAK;AAAA,IACH;AAAA,IACA,IAAI,OAAO;AAAA,IACX,IAAI,OAAO;AAAA,IACX,IAAI,OAAO;AAAA,IACX,IAAI,UAAU;AAAA,IACd,IAAI,UAAU;AAAA,IACd,IAAI,UAAU;AAAA,EAChB;AACA,SAAO;AACT;AAYO,SAAS,eAAe,KAAU,MAAoB,IAAI,aAAa,UAAU,GAAiB;AACvG,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,OAAO;AACpB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,MAAI,CAAC,IAAI,IAAI,UAAU;AACvB,SAAO;AACT;AAOA,IAAM,UAAU,IAAI,aAAa,UAAU;AAC3C,IAAM,WAAW,IAAI,aAAa,CAAC;AAE5B,SAAS,iBAAiB,KAAU,KAAmB;AAC5D,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,OAAO;AACxB,UAAQ,CAAC,IAAI,IAAI,UAAU;AAC3B,UAAQ,CAAC,IAAI,IAAI,UAAU;AAC3B,UAAQ,CAAC,IAAI,IAAI,UAAU;AAE3B,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AACtB,WAAS,CAAC,IAAI,IAAI,IAAI;AAEtB,SAAO,kBAAkB,SAAS,GAAG,UAAU,CAAC;AAClD;","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@spatial-engine/three",
+  "version": "0.0.1",
+  "description": "Three.js adapter for @spatial-engine/core",
+  "author": "Francisco Rueda Esquivel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/franruedaesq/spatial-engine.git",
+    "directory": "packages/three"
+  },
+  "keywords": [
+    "three",
+    "threejs",
+    "octree",
+    "spatial",
+    "aabb",
+    "3d",
+    "data-oriented-design",
+    "zero-gc"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@spatial-engine/core": "0.0.1"
+  },
+  "peerDependencies": {
+    "three": ">=0.150.0"
+  },
+  "devDependencies": {
+    "three": "^0.166.1",
+    "@types/three": "^0.166.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}