@relu-interactives/spatial-ecs 0.2.5 → 0.2.6

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

@@ -647,11 +647,11 @@ type InstanceTransform = {
         z: number;
     };
 };
-/** Primitive geometry kinds supported by instanced mesh rendering. */
-type InstancedMeshKind = "capsule" | "cube" | "cylinder" | "plane" | "sphere";
+/** Primitive geometry kinds and custom 3D model kind supported by instanced mesh rendering. */
+type InstancedMeshKind = "capsule" | "cube" | "cylinder" | "model" | "plane" | "sphere";
 /** Default identity instance transform. */
 declare const DEFAULT_INSTANCE_TRANSFORM: InstanceTransform;
-/** Default geometry parameters per instanced mesh kind. */
+/** Default geometry parameters per instanced mesh kind. For "model" kind, cube params are stored as a placeholder (unused). */
 declare const DEFAULT_INSTANCED_MESH_PARAMETERS: Record<InstancedMeshKind, MeshGeometryParameters>;
 /**
  * Holds authored instanced-mesh data for an entity that renders as a
@@ -665,9 +665,14 @@ declare const DEFAULT_INSTANCED_MESH_PARAMETERS: Record<InstancedMeshKind, MeshG
  * @category Components
  */
 declare class InstancedMeshComponent extends Component {
-    /** Primitive geometry kind shared by all instances. */
+    /** Geometry kind for all instances. Use `"model"` for a custom GLTF/GLB asset. */
     meshKind: InstancedMeshKind;
-    /** Editable geometry parameters (width/height/depth, radius, etc.). */
+    /**
+     * Path to the GLTF/GLB asset when `meshKind === "model"`.
+     * Serialized in snapshots and restored on hydration.
+     */
+    modelPath: string;
+    /** Editable geometry parameters (width/height/depth, radius, etc.). Ignored when `meshKind === "model"`. */
     meshParameters: MeshGeometryParameters;
     /** Whether all instances cast shadows. */
     castShadow: boolean;
@@ -676,14 +681,17 @@ declare class InstancedMeshComponent extends Component {
     /** Per-instance transforms stored in local space relative to the anchor object. */
     instances: InstanceTransform[];
     /**
-     * Live `THREE.InstancedMesh` managed by {@link InstancedMeshSystem}.
+     * Live runtime container managed by {@link InstancedMeshSystem}:
+     * - For primitive kinds: a `THREE.InstancedMesh`.
+     * - For `"model"` kind: a `THREE.Group` containing per-mesh `THREE.InstancedMesh` objects.
      * Excluded from snapshot serialization — do **not** read this in hydration code.
      */
-    instancedMesh: THREE.InstancedMesh | null;
+    instancedMesh: THREE.Object3D | null;
     constructor(meshKind?: InstancedMeshKind, meshParameters?: Partial<MeshGeometryParameters>, options?: {
         castShadow?: boolean;
         receiveShadow?: boolean;
         instances?: InstanceTransform[];
+        modelPath?: string;
     });
     /** Sanitize and return a copy of the current mesh parameters with valid values. */
     getSanitizedParameters(): MeshGeometryParameters;

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

@@ -647,11 +647,11 @@ type InstanceTransform = {
         z: number;
     };
 };
-/** Primitive geometry kinds supported by instanced mesh rendering. */
-type InstancedMeshKind = "capsule" | "cube" | "cylinder" | "plane" | "sphere";
+/** Primitive geometry kinds and custom 3D model kind supported by instanced mesh rendering. */
+type InstancedMeshKind = "capsule" | "cube" | "cylinder" | "model" | "plane" | "sphere";
 /** Default identity instance transform. */
 declare const DEFAULT_INSTANCE_TRANSFORM: InstanceTransform;
-/** Default geometry parameters per instanced mesh kind. */
+/** Default geometry parameters per instanced mesh kind. For "model" kind, cube params are stored as a placeholder (unused). */
 declare const DEFAULT_INSTANCED_MESH_PARAMETERS: Record<InstancedMeshKind, MeshGeometryParameters>;
 /**
  * Holds authored instanced-mesh data for an entity that renders as a
@@ -665,9 +665,14 @@ declare const DEFAULT_INSTANCED_MESH_PARAMETERS: Record<InstancedMeshKind, MeshG
  * @category Components
  */
 declare class InstancedMeshComponent extends Component {
-    /** Primitive geometry kind shared by all instances. */
+    /** Geometry kind for all instances. Use `"model"` for a custom GLTF/GLB asset. */
     meshKind: InstancedMeshKind;
-    /** Editable geometry parameters (width/height/depth, radius, etc.). */
+    /**
+     * Path to the GLTF/GLB asset when `meshKind === "model"`.
+     * Serialized in snapshots and restored on hydration.
+     */
+    modelPath: string;
+    /** Editable geometry parameters (width/height/depth, radius, etc.). Ignored when `meshKind === "model"`. */
     meshParameters: MeshGeometryParameters;
     /** Whether all instances cast shadows. */
     castShadow: boolean;
@@ -676,14 +681,17 @@ declare class InstancedMeshComponent extends Component {
     /** Per-instance transforms stored in local space relative to the anchor object. */
     instances: InstanceTransform[];
     /**
-     * Live `THREE.InstancedMesh` managed by {@link InstancedMeshSystem}.
+     * Live runtime container managed by {@link InstancedMeshSystem}:
+     * - For primitive kinds: a `THREE.InstancedMesh`.
+     * - For `"model"` kind: a `THREE.Group` containing per-mesh `THREE.InstancedMesh` objects.
      * Excluded from snapshot serialization — do **not** read this in hydration code.
      */
-    instancedMesh: THREE.InstancedMesh | null;
+    instancedMesh: THREE.Object3D | null;
     constructor(meshKind?: InstancedMeshKind, meshParameters?: Partial<MeshGeometryParameters>, options?: {
         castShadow?: boolean;
         receiveShadow?: boolean;
         instances?: InstanceTransform[];
+        modelPath?: string;
     });
     /** Sanitize and return a copy of the current mesh parameters with valid values. */
     getSanitizedParameters(): MeshGeometryParameters;

package/dist/{chunk-4A66FSFT.js → chunk-EIC5B3A7.js}

@@ -1,5 +1,5 @@
-import { resolveDracoDecoderPath, createTransform, applyTransform } from './chunk-CRP3W2GK.js';
-import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, VideoComponent } from './chunk-KRZLEPRI.js';
+import { resolveDracoDecoderPath, createTransform, applyTransform } from './chunk-FDWNCXU3.js';
+import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, VideoComponent } from './chunk-R5D5PWXV.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE21 from 'three';
 import { RectAreaLightHelper } from 'three/examples/jsm/helpers/RectAreaLightHelper.js';
@@ -1357,5 +1357,5 @@ function registerDefaultFactories(objectManagementSystem) {
 __name(registerDefaultFactories, "registerDefaultFactories");
 
 export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVideoComponent, registerDefaultComponentFactories, registerDefaultFactories };
-//# sourceMappingURL=chunk-4A66FSFT.js.map
-//# sourceMappingURL=chunk-4A66FSFT.js.map
+//# sourceMappingURL=chunk-EIC5B3A7.js.map
+//# sourceMappingURL=chunk-EIC5B3A7.js.map