@relu-interactives/spatial-ecs 0.2.7 → 0.2.9

package/dist/{System-CIiWteft.d.cts → System-AV2_87Zr.d.cts}

@@ -86,7 +86,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */

package/dist/{System-CIiWteft.d.ts → System-AV2_87Zr.d.ts}

@@ -86,7 +86,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */

package/dist/{Video-Dj4KBqQ1.d.cts → Video-Bn93p6XV.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-CIiWteft.cjs';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-AV2_87Zr.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -678,8 +678,12 @@ declare class InstancedMeshComponent extends Component {
     castShadow: boolean;
     /** Whether all instances receive shadows. */
     receiveShadow: boolean;
-    /** Per-instance transforms stored in local space relative to the anchor object. */
-    instances: InstanceTransform[];
+    /**
+     * Ordered list of entity IDs for the instance slot entities owned by this group.
+     * Each slot entity carries a `TransformComponent` that `InstancedMeshSystem`
+     * reads every frame to build the per-instance matrix.
+     */
+    instanceEntityIds: number[];
     /**
      * Live runtime container managed by {@link InstancedMeshSystem}:
      * - For primitive kinds: a `THREE.InstancedMesh`.
@@ -690,13 +694,31 @@ declare class InstancedMeshComponent extends Component {
     constructor(meshKind?: InstancedMeshKind, meshParameters?: Partial<MeshGeometryParameters>, options?: {
         castShadow?: boolean;
         receiveShadow?: boolean;
-        instances?: InstanceTransform[];
+        instanceEntityIds?: number[];
         modelPath?: string;
     });
     /** Sanitize and return a copy of the current mesh parameters with valid values. */
     getSanitizedParameters(): MeshGeometryParameters;
 }
 
+/**
+ * Marks an entity as an instance slot owned by an {@link InstancedMeshComponent} group entity.
+ *
+ * Instance slot entities are lightweight data containers — they carry
+ * `TransformComponent` (the per-instance local transform) and this component,
+ * but do **not** have an `Object3DRef`. Their transforms are consumed each
+ * frame by `InstancedMeshSystem` to compose the instance matrix.
+ *
+ * @category Components
+ */
+declare class InstanceSlotComponent extends Component {
+    /** Entity ID of the owning `instancedMesh` group entity. */
+    groupEntityId: number;
+    /** Zero-based index of this slot within the group's `instanceEntityIds` array. */
+    slotIndex: number;
+    constructor(groupEntityId: number, slotIndex: number);
+}
+
 type RapierRigidBody = RAPIER.RigidBody;
 type RapierCollider = RAPIER.Collider;
 /**
@@ -1330,4 +1352,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type RadiusMeshParameters as $, AnimationComponent as A, type ImageTargetReference as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type InstanceTransform as F, InstancedMeshComponent as G, type InstancedMeshKind as H, ImageComponent as I, type LightValueState as J, type MaterialTypeValue as K, LightComponent as L, MaterialComponent as M, type MaterialValueState as N, MeshComponent as O, MeshGeometryComponent as P, type MeshGeometryParameters as Q, type MeshGeometryParametersByKind as R, ModelComponent as S, Name as T, Object3DRef as U, PhysicsComponent as V, type PhysicsState as W, type PlaneMeshParameters as X, Postprocessing as Y, type PostprocessingState as Z, type RadiusHeightMeshParameters as _, type AnimationComponentOptions as a, type RigidbodyState as a0, type RigidbodyType as a1, ScriptComponent as a2, type ScriptEntry as a3, Selectable as a4, SelectionTransformState as a5, SpriteComponent as a6, type TextureFilteringValue as a7, type TransformModeValue as a8, type TransformSpaceValue as a9, VideoComponent as aa, normalizePhysicsState as ab, type AnimationStateCallbacks as ac, AnimationStateMachine as ad, AnimationStateManager as ae, type StateMachine as af, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_ENVIRONMENT_STATE as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSTPROCESSING_STATE as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, Environment as q, type EnvironmentFogState as r, type EnvironmentFogType as s, type EnvironmentGradientEffect as t, type EnvironmentSkyboxState as u, type EnvironmentSkyboxType as v, type EnvironmentState as w, ImageTarget as x, ImageTargetAnchor as y, type ImageTargetAnchorOptions as z };
+export { type RadiusHeightMeshParameters as $, AnimationComponent as A, type ImageTargetReference as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, InstanceSlotComponent as F, type InstanceTransform as G, InstancedMeshComponent as H, ImageComponent as I, type InstancedMeshKind as J, type LightValueState as K, LightComponent as L, MaterialComponent as M, type MaterialTypeValue as N, type MaterialValueState as O, MeshComponent as P, MeshGeometryComponent as Q, type MeshGeometryParameters as R, type MeshGeometryParametersByKind as S, ModelComponent as T, Name as U, Object3DRef as V, PhysicsComponent as W, type PhysicsState as X, type PlaneMeshParameters as Y, Postprocessing as Z, type PostprocessingState as _, type AnimationComponentOptions as a, type RadiusMeshParameters as a0, type RigidbodyState as a1, type RigidbodyType as a2, ScriptComponent as a3, type ScriptEntry as a4, Selectable as a5, SelectionTransformState as a6, SpriteComponent as a7, type TextureFilteringValue as a8, type TransformModeValue as a9, type TransformSpaceValue as aa, VideoComponent as ab, normalizePhysicsState as ac, type AnimationStateCallbacks as ad, AnimationStateMachine as ae, AnimationStateManager as af, type StateMachine as ag, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_ENVIRONMENT_STATE as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSTPROCESSING_STATE as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, Environment as q, type EnvironmentFogState as r, type EnvironmentFogType as s, type EnvironmentGradientEffect as t, type EnvironmentSkyboxState as u, type EnvironmentSkyboxType as v, type EnvironmentState as w, ImageTarget as x, ImageTargetAnchor as y, type ImageTargetAnchorOptions as z };

package/dist/{Video-B-qMljTn.d.ts → Video-D6mObK_5.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-CIiWteft.js';
+import { C as Component, e as EcsEntityKind, m as EcsEntityEditorKind, n as EntityId } from './System-AV2_87Zr.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -678,8 +678,12 @@ declare class InstancedMeshComponent extends Component {
     castShadow: boolean;
     /** Whether all instances receive shadows. */
     receiveShadow: boolean;
-    /** Per-instance transforms stored in local space relative to the anchor object. */
-    instances: InstanceTransform[];
+    /**
+     * Ordered list of entity IDs for the instance slot entities owned by this group.
+     * Each slot entity carries a `TransformComponent` that `InstancedMeshSystem`
+     * reads every frame to build the per-instance matrix.
+     */
+    instanceEntityIds: number[];
     /**
      * Live runtime container managed by {@link InstancedMeshSystem}:
      * - For primitive kinds: a `THREE.InstancedMesh`.
@@ -690,13 +694,31 @@ declare class InstancedMeshComponent extends Component {
     constructor(meshKind?: InstancedMeshKind, meshParameters?: Partial<MeshGeometryParameters>, options?: {
         castShadow?: boolean;
         receiveShadow?: boolean;
-        instances?: InstanceTransform[];
+        instanceEntityIds?: number[];
         modelPath?: string;
     });
     /** Sanitize and return a copy of the current mesh parameters with valid values. */
     getSanitizedParameters(): MeshGeometryParameters;
 }
 
+/**
+ * Marks an entity as an instance slot owned by an {@link InstancedMeshComponent} group entity.
+ *
+ * Instance slot entities are lightweight data containers — they carry
+ * `TransformComponent` (the per-instance local transform) and this component,
+ * but do **not** have an `Object3DRef`. Their transforms are consumed each
+ * frame by `InstancedMeshSystem` to compose the instance matrix.
+ *
+ * @category Components
+ */
+declare class InstanceSlotComponent extends Component {
+    /** Entity ID of the owning `instancedMesh` group entity. */
+    groupEntityId: number;
+    /** Zero-based index of this slot within the group's `instanceEntityIds` array. */
+    slotIndex: number;
+    constructor(groupEntityId: number, slotIndex: number);
+}
+
 type RapierRigidBody = RAPIER.RigidBody;
 type RapierCollider = RAPIER.Collider;
 /**
@@ -1330,4 +1352,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type RadiusMeshParameters as $, AnimationComponent as A, type ImageTargetReference as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type InstanceTransform as F, InstancedMeshComponent as G, type InstancedMeshKind as H, ImageComponent as I, type LightValueState as J, type MaterialTypeValue as K, LightComponent as L, MaterialComponent as M, type MaterialValueState as N, MeshComponent as O, MeshGeometryComponent as P, type MeshGeometryParameters as Q, type MeshGeometryParametersByKind as R, ModelComponent as S, Name as T, Object3DRef as U, PhysicsComponent as V, type PhysicsState as W, type PlaneMeshParameters as X, Postprocessing as Y, type PostprocessingState as Z, type RadiusHeightMeshParameters as _, type AnimationComponentOptions as a, type RigidbodyState as a0, type RigidbodyType as a1, ScriptComponent as a2, type ScriptEntry as a3, Selectable as a4, SelectionTransformState as a5, SpriteComponent as a6, type TextureFilteringValue as a7, type TransformModeValue as a8, type TransformSpaceValue as a9, VideoComponent as aa, normalizePhysicsState as ab, type AnimationStateCallbacks as ac, AnimationStateMachine as ad, AnimationStateManager as ae, type StateMachine as af, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_ENVIRONMENT_STATE as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSTPROCESSING_STATE as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, Environment as q, type EnvironmentFogState as r, type EnvironmentFogType as s, type EnvironmentGradientEffect as t, type EnvironmentSkyboxState as u, type EnvironmentSkyboxType as v, type EnvironmentState as w, ImageTarget as x, ImageTargetAnchor as y, type ImageTargetAnchorOptions as z };
+export { type RadiusHeightMeshParameters as $, AnimationComponent as A, type ImageTargetReference as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, InstanceSlotComponent as F, type InstanceTransform as G, InstancedMeshComponent as H, ImageComponent as I, type InstancedMeshKind as J, type LightValueState as K, LightComponent as L, MaterialComponent as M, type MaterialTypeValue as N, type MaterialValueState as O, MeshComponent as P, MeshGeometryComponent as Q, type MeshGeometryParameters as R, type MeshGeometryParametersByKind as S, ModelComponent as T, Name as U, Object3DRef as V, PhysicsComponent as W, type PhysicsState as X, type PlaneMeshParameters as Y, Postprocessing as Z, type PostprocessingState as _, type AnimationComponentOptions as a, type RadiusMeshParameters as a0, type RigidbodyState as a1, type RigidbodyType as a2, ScriptComponent as a3, type ScriptEntry as a4, Selectable as a5, SelectionTransformState as a6, SpriteComponent as a7, type TextureFilteringValue as a8, type TransformModeValue as a9, type TransformSpaceValue as aa, VideoComponent as ab, normalizePhysicsState as ac, type AnimationStateCallbacks as ad, AnimationStateMachine as ae, AnimationStateManager as af, type StateMachine as ag, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_ENVIRONMENT_STATE as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSTPROCESSING_STATE as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, Environment as q, type EnvironmentFogState as r, type EnvironmentFogType as s, type EnvironmentGradientEffect as t, type EnvironmentSkyboxState as u, type EnvironmentSkyboxType as v, type EnvironmentState as w, ImageTarget as x, ImageTargetAnchor as y, type ImageTargetAnchorOptions as z };

package/dist/{chunk-R5D5PWXV.js → chunk-AZR6SLQN.js}

@@ -21,6 +21,7 @@ __export(components_exports, {
   ImageComponent: () => ImageComponent,
   ImageTarget: () => ImageTarget,
   ImageTargetAnchor: () => ImageTargetAnchor,
+  InstanceSlotComponent: () => InstanceSlotComponent,
   InstancedMeshComponent: () => InstancedMeshComponent,
   LightComponent: () => LightComponent,
   MaterialComponent: () => MaterialComponent,
@@ -1050,7 +1051,7 @@ var _InstancedMeshComponent = class _InstancedMeshComponent extends Component {
     };
     this.castShadow = options?.castShadow ?? false;
     this.receiveShadow = options?.receiveShadow ?? false;
-    this.instances = options?.instances && options.instances.length > 0 ? options.instances : [{ ...DEFAULT_INSTANCE_TRANSFORM }];
+    this.instanceEntityIds = options?.instanceEntityIds ?? [];
     this.instancedMesh = null;
   }
   /** Sanitize and return a copy of the current mesh parameters with valid values. */
@@ -1094,6 +1095,17 @@ var _InstancedMeshComponent = class _InstancedMeshComponent extends Component {
 __name(_InstancedMeshComponent, "InstancedMeshComponent");
 var InstancedMeshComponent = _InstancedMeshComponent;
 
+// core/components/InstanceSlotComponent.ts
+var _InstanceSlotComponent = class _InstanceSlotComponent extends Component {
+  constructor(groupEntityId, slotIndex) {
+    super();
+    this.groupEntityId = groupEntityId;
+    this.slotIndex = slotIndex;
+  }
+};
+__name(_InstanceSlotComponent, "InstanceSlotComponent");
+var InstanceSlotComponent = _InstanceSlotComponent;
+
 // core/components/Physics.ts
 var DEFAULT_RIGIDBODY_STATE = {
   enabled: true,
@@ -1789,6 +1801,6 @@ var _VideoComponent = class _VideoComponent extends Component {
 __name(_VideoComponent, "VideoComponent");
 var VideoComponent = _VideoComponent;
 
-export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, ImageComponent, ImageTarget, ImageTargetAnchor, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, ScriptComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, VideoComponent, components_exports, normalizePhysicsState };
-//# sourceMappingURL=chunk-R5D5PWXV.js.map
-//# sourceMappingURL=chunk-R5D5PWXV.js.map
+export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, ScriptComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, VideoComponent, components_exports, normalizePhysicsState };
+//# sourceMappingURL=chunk-AZR6SLQN.js.map
+//# sourceMappingURL=chunk-AZR6SLQN.js.map