@relu-interactives/spatial-ecs 0.3.1 → 0.3.2

package/dist/factories/index.js

@@ -1,4 +1,4 @@
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRInteractableComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-PCOZLCXS.js';
+export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRInteractableComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-JWTRFJBL.js';
 import '../chunk-67WGASUJ.js';
 import '../chunk-U3MDYKPV.js';
 import '../chunk-OY7ZODZP.js';

package/dist/{index-YYypJaVw.d.cts → index-Bc0YCz1A.d.cts}

@@ -485,4 +485,30 @@ declare class XRSessionSystem implements EcsSystem {
     getInputs(): XrInputState[];
 }
 
-export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VideoSystem as V, type XrCapabilities as X, type XrInputState as a, AudioSystem as b, MeshGeometrySystem as c, type ModuleLoader as d, PostprocessingSyncSystem as e, ScriptBehaviourSystem as f, ScriptObjectSystem as g, type SelectionContext as h, XRInputSystem as i, XRInteractionSystem as j, XRLocomotionSystem as k, XRSessionSystem as l, type XrHandedness as m, type XrInputKind as n, readXrCapabilities as r };
+declare class VRTeleportAreaSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class XRControllerVisualSystem implements EcsSystem {
+    private readonly controllerModelFactory;
+    private readonly handModelFactory;
+    private readonly group;
+    private built;
+    private attachedTo;
+    /** Index → whether we've already attached visuals for that slot. */
+    private readonly ready;
+    /** How many controller slots to wire. Two covers every current headset. */
+    private readonly slots;
+    constructor(slots?: number);
+    update(world: World): void;
+    /**
+     * Parent the visuals to the XR rig when there is one, so locomotion moves the
+     * hands with the player. Falls back to the scene root.
+     */
+    private ensureAttached;
+    private createRay;
+    dispose(): void;
+}
+
+export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, AudioSystem as b, MeshGeometrySystem as c, type ModuleLoader as d, PostprocessingSyncSystem as e, ScriptBehaviourSystem as f, ScriptObjectSystem as g, type SelectionContext as h, VideoSystem as i, XRControllerVisualSystem as j, XRInputSystem as k, XRInteractionSystem as l, XRLocomotionSystem as m, XRSessionSystem as n, type XrHandedness as o, type XrInputKind as p, readXrCapabilities as r };

package/dist/{index-D84o_UA6.d.ts → index-CRmfSYdj.d.ts}

@@ -485,4 +485,30 @@ declare class XRSessionSystem implements EcsSystem {
     getInputs(): XrInputState[];
 }
 
-export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VideoSystem as V, type XrCapabilities as X, type XrInputState as a, AudioSystem as b, MeshGeometrySystem as c, type ModuleLoader as d, PostprocessingSyncSystem as e, ScriptBehaviourSystem as f, ScriptObjectSystem as g, type SelectionContext as h, XRInputSystem as i, XRInteractionSystem as j, XRLocomotionSystem as k, XRSessionSystem as l, type XrHandedness as m, type XrInputKind as n, readXrCapabilities as r };
+declare class VRTeleportAreaSystem implements EcsSystem {
+    private readonly signatures;
+    update(world: World): void;
+}
+
+declare class XRControllerVisualSystem implements EcsSystem {
+    private readonly controllerModelFactory;
+    private readonly handModelFactory;
+    private readonly group;
+    private built;
+    private attachedTo;
+    /** Index → whether we've already attached visuals for that slot. */
+    private readonly ready;
+    /** How many controller slots to wire. Two covers every current headset. */
+    private readonly slots;
+    constructor(slots?: number);
+    update(world: World): void;
+    /**
+     * Parent the visuals to the XR rig when there is one, so locomotion moves the
+     * hands with the player. Falls back to the scene root.
+     */
+    private ensureAttached;
+    private createRay;
+    dispose(): void;
+}
+
+export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, AudioSystem as b, MeshGeometrySystem as c, type ModuleLoader as d, PostprocessingSyncSystem as e, ScriptBehaviourSystem as f, ScriptObjectSystem as g, type SelectionContext as h, VideoSystem as i, XRControllerVisualSystem as j, XRInputSystem as k, XRInteractionSystem as l, XRLocomotionSystem as m, XRSessionSystem as n, type XrHandedness as o, type XrInputKind as p, readXrCapabilities as r };

package/dist/index.cjs

@@ -19,6 +19,8 @@ var OutputPass_js = require('three/examples/jsm/postprocessing/OutputPass.js');
 var HueSaturationShader_js = require('three/examples/jsm/shaders/HueSaturationShader.js');
 var SepiaShader_js = require('three/examples/jsm/shaders/SepiaShader.js');
 var VignetteShader_js = require('three/examples/jsm/shaders/VignetteShader.js');
+var XRControllerModelFactory_js = require('three/examples/jsm/webxr/XRControllerModelFactory.js');
+var XRHandModelFactory_js = require('three/examples/jsm/webxr/XRHandModelFactory.js');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespace(e) {
@@ -3890,11 +3892,19 @@ function createTeleportArea({
     depthWrite: false
   });
   const object = new THREE38__namespace.Mesh(geometry, material);
-  object.rotation.x = -Math.PI / 2;
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Teleport Area",
     entityType: "teleportArea",
-    transformInput: payload.transform
+    // The flat-on-the-ground rotation must live in the ECS TRANSFORM, not on
+    // the Object3D: createBaseEntity applies the transform over the object, and
+    // TransformSyncSystem re-applies it every frame — so a rotation set
+    // directly on the mesh is overwritten immediately and the area stands up
+    // like a wall. Same convention as the `plane` primitive.
+    transformInput: {
+      position: payload.transform?.position,
+      rotation: payload.transform?.rotation ?? { x: -Math.PI / 2, y: 0, z: 0 },
+      scale: payload.transform?.scale
+    }
   });
   world.addComponent(
     entityId,
@@ -10647,6 +10657,128 @@ var _XRSessionSystem = class _XRSessionSystem {
 };
 __name(_XRSessionSystem, "XRSessionSystem");
 var XRSessionSystem = _XRSessionSystem;
+function buildGeometry2(area) {
+  if (area.shape === "cylinder") {
+    const radius = Math.max(5e-3, area.width / 2);
+    return new THREE38__namespace.CircleGeometry(radius, 48);
+  }
+  return new THREE38__namespace.PlaneGeometry(
+    Math.max(0.01, area.width),
+    Math.max(0.01, area.depth)
+  );
+}
+__name(buildGeometry2, "buildGeometry");
+function signatureOf(area) {
+  return `${area.shape}:${area.width}:${area.depth}`;
+}
+__name(signatureOf, "signatureOf");
+var _VRTeleportAreaSystem = class _VRTeleportAreaSystem {
+  constructor() {
+    this.signatures = /* @__PURE__ */ new Map();
+  }
+  update(world) {
+    const entityIds = world.query(VRTeleportAreaComponent, Object3DRef);
+    const alive = new Set(entityIds);
+    for (const tracked of this.signatures.keys()) {
+      if (!alive.has(tracked)) this.signatures.delete(tracked);
+    }
+    for (const entityId of entityIds) {
+      const area = world.getComponent(entityId, VRTeleportAreaComponent);
+      const object = world.getComponent(entityId, Object3DRef)?.object;
+      if (!area || !(object instanceof THREE38__namespace.Mesh)) continue;
+      const signature = signatureOf(area);
+      if (this.signatures.get(entityId) === signature) continue;
+      this.signatures.set(entityId, signature);
+      object.geometry?.dispose?.();
+      object.geometry = buildGeometry2(area);
+    }
+  }
+};
+__name(_VRTeleportAreaSystem, "VRTeleportAreaSystem");
+var VRTeleportAreaSystem = _VRTeleportAreaSystem;
+var _XRControllerVisualSystem = class _XRControllerVisualSystem {
+  constructor(slots = 2) {
+    this.controllerModelFactory = new XRControllerModelFactory_js.XRControllerModelFactory();
+    this.handModelFactory = new XRHandModelFactory_js.XRHandModelFactory();
+    this.group = new THREE38__namespace.Group();
+    this.built = false;
+    this.attachedTo = null;
+    /** Index → whether we've already attached visuals for that slot. */
+    this.ready = /* @__PURE__ */ new Set();
+    this.slots = slots;
+    this.group.name = "XRControllerVisuals";
+    this.group.userData.ecsPreviewHidden = true;
+  }
+  update(world) {
+    const renderer = world.getRenderer();
+    if (!renderer.xr?.enabled) return;
+    this.ensureAttached(world);
+    if (this.built) return;
+    for (let index = 0; index < this.slots; index += 1) {
+      if (this.ready.has(index)) continue;
+      const controller = renderer.xr.getController(index);
+      const grip = renderer.xr.getControllerGrip(index);
+      const hand = renderer.xr.getHand(index);
+      if (!controller || !grip || !hand) continue;
+      controller.add(this.createRay());
+      this.group.add(controller);
+      grip.add(this.controllerModelFactory.createControllerModel(grip));
+      this.group.add(grip);
+      hand.add(this.handModelFactory.createHandModel(hand, "mesh"));
+      this.group.add(hand);
+      this.ready.add(index);
+    }
+    if (this.ready.size >= this.slots) {
+      this.built = true;
+    }
+  }
+  /**
+   * Parent the visuals to the XR rig when there is one, so locomotion moves the
+   * hands with the player. Falls back to the scene root.
+   */
+  ensureAttached(world) {
+    const camera = world.getCamera();
+    const target = camera.parent ?? world.getScene();
+    if (this.attachedTo === target) return;
+    target.add(this.group);
+    this.attachedTo = target;
+  }
+  createRay() {
+    const geometry = new THREE38__namespace.BufferGeometry().setFromPoints([
+      new THREE38__namespace.Vector3(0, 0, 0),
+      new THREE38__namespace.Vector3(0, 0, -5)
+    ]);
+    const material = new THREE38__namespace.LineBasicMaterial({
+      color: "#4da3ff",
+      transparent: true,
+      opacity: 0.6,
+      depthTest: false
+    });
+    const line = new THREE38__namespace.Line(geometry, material);
+    line.name = "XRPointerRay";
+    line.renderOrder = 999;
+    return line;
+  }
+  dispose() {
+    this.group.removeFromParent();
+    this.group.traverse((child) => {
+      const mesh = child;
+      mesh.geometry?.dispose?.();
+      const material = mesh.material;
+      if (Array.isArray(material)) {
+        for (const entry of material) entry.dispose?.();
+      } else {
+        material?.dispose?.();
+      }
+    });
+    this.group.clear();
+    this.ready.clear();
+    this.built = false;
+    this.attachedTo = null;
+  }
+};
+__name(_XRControllerVisualSystem, "XRControllerVisualSystem");
+var XRControllerVisualSystem = _XRControllerVisualSystem;
 
 // core/World.ts
 var _World = class _World {
@@ -10992,6 +11124,7 @@ var _World = class _World {
     const postprocessingSyncSystem = this.featureFlags.supportPostprocessing ? new PostprocessingSyncSystem(this.renderer, this.scene, this.camera) : null;
     const lightSyncSystem = new LightSyncSystem();
     const materialSyncSystem = new MaterialSyncSystem();
+    const vrTeleportAreaSystem = new VRTeleportAreaSystem();
     const physicsSyncSystem = new PhysicsSyncSystem({
       isEditor: isEditor ?? false
     });
@@ -11021,6 +11154,7 @@ var _World = class _World {
     }
     this.addSystems([
       ...coreSystems,
+      vrTeleportAreaSystem,
       physicsSyncSystem,
       ...systems,
       objectVisibilitySystem,
@@ -12052,8 +12186,10 @@ exports.ScriptBehaviourSystem = ScriptBehaviourSystem;
 exports.ScriptObject = ScriptObject;
 exports.ScriptObjectSystem = ScriptObjectSystem;
 exports.TransformSyncSystem = TransformSyncSystem;
+exports.VRTeleportAreaSystem = VRTeleportAreaSystem;
 exports.VideoSystem = VideoSystem;
 exports.World = World;
+exports.XRControllerVisualSystem = XRControllerVisualSystem;
 exports.XRInputSystem = XRInputSystem;
 exports.XRInteractionSystem = XRInteractionSystem;
 exports.XRLocomotionSystem = XRLocomotionSystem;