@relu-interactives/spatial-ecs 0.2.17 → 0.2.21

package/dist/{System-BeuJ1xt5.d.cts → System-me3iAcMF.d.cts}

@@ -468,6 +468,132 @@ type NormalizeContext = {
 declare function normalizeDebugValue(value: unknown, ctx: NormalizeContext): unknown;
 declare function cloneHistoryValue<T>(value: T, seen?: WeakMap<object, unknown>): T;
 
+/**
+ * Snapshot-space entity-id walking/remapping.
+ *
+ * This module is the single source of truth for WHERE entity ids live inside
+ * a serialized world snapshot:
+ *   - `ParentId.value`
+ *   - `ScriptComponent.entries[].data` EntityInput (`{type:"entity", value}`)
+ *     and ComponentInput (`{type:"component", value:{entityId, …}}`)
+ *   - `InstancedMeshComponent.instanceEntityIds[]`
+ *   - `InstanceSlotComponent.groupEntityId`
+ *
+ * Any new id-bearing component field must be added here — serialization,
+ * instantiation and the override differ all route through this walker.
+ */
+type SubtreeSnapshot = {
+    entities: number[];
+    components: Array<{
+        component: string;
+        entries: Array<{
+            entityId: number;
+            value: unknown;
+        }>;
+    }>;
+};
+type ExternalRefWarning = {
+    /** Entity id (in the INPUT snapshot's id space) holding the reference. */
+    entityId: number;
+    component: string;
+    /** Slash-separated path of the reference inside the component value. */
+    path: string;
+    /** The referenced entity id that falls outside the id map. */
+    targetId: number;
+};
+type RemapSnapshotOptions = {
+    /**
+     * What to do with references to entities NOT present in the id map:
+     * - "null": replace the reference with null and record a warning
+     *   (prefab-file serialization — external refs must not leak).
+     * - "keep": leave the raw id untouched and record a warning.
+     * Default: "keep".
+     */
+    externalRefPolicy?: "null" | "keep";
+};
+/**
+ * Return a deep-cloned snapshot with every entity id (entity list, entry
+ * keys, and all id-bearing component fields) remapped through `idMap`.
+ * References to ids missing from the map follow `externalRefPolicy` and are
+ * reported in `warnings` (with ids in the INPUT snapshot's id space).
+ */
+declare function remapSnapshotEntityIds(snapshot: SubtreeSnapshot, idMap: Map<number, number>, options?: RemapSnapshotOptions): {
+    snapshot: SubtreeSnapshot;
+    warnings: ExternalRefWarning[];
+};
+
+declare const PREFAB_FILE_VERSION = 1;
+/** Written for files containing NESTED instances (parse accepts either). */
+declare const PREFAB_FILE_VERSION_NESTED = 2;
+/** File version to write for a given snapshot: 2 iff it nests instances. */
+declare function prefabFileVersionFor(snapshot: SubtreeSnapshot): number;
+/**
+ * Envelope of a `.prefab` asset file (and, later, `.scene` assets — same
+ * shape with `type: "scene"`). `snapshot` is the same columnar world-snapshot
+ * format `hydrateWorldFromSnapshotDetailed` consumes, with entity ids
+ * renumbered 1..N and every entity carrying a `PrefabNode` identity.
+ */
+type PrefabAsset = {
+    version: number;
+    type?: "prefab" | "scene";
+    name?: string;
+    snapshot: SubtreeSnapshot;
+};
+/** Validate untrusted JSON into a `PrefabAsset`, or null when malformed. */
+declare function parsePrefabAsset(json: unknown): PrefabAsset | null;
+
+type Vec3Like = {
+    x?: number;
+    y?: number;
+    z?: number;
+};
+/**
+ * Override how prefab asset URLs (the file URL itself AND every asset URL
+ * stored inside prefab files) are resolved before fetching. Published/preview
+ * runtimes register a resolver that maps the editor's `localasset://…/assets/x`
+ * URLs to `./assets/x`; the editor leaves it unset (identity — the
+ * `localasset://` protocol is fetchable there). Same pattern as
+ * {@link setDracoDecoderPath}. Pass null to restore identity.
+ */
+declare function setPrefabAssetUrlResolver(resolver: ((url: string) => string) | null): void;
+/**
+ * Fetch + parse (and cache) a `.prefab` asset. All strings inside the
+ * snapshot are passed through the registered URL resolver, so asset
+ * references load correctly in published/preview builds. Use this from
+ * preloaders to warm the same cache `spawnPrefab` reads.
+ */
+declare function loadPrefab(url: string): Promise<PrefabAsset>;
+/** Drop one cached prefab (or all when no url is given). */
+declare function clearPrefabCache(url?: string): void;
+type SpawnPrefabSource = string | {
+    path: string;
+    type?: string;
+} | PrefabAsset;
+type SpawnPrefabOptions = {
+    /** Parent the spawned root under this entity (default: world root). */
+    parentId?: EntityId | null;
+    /** Local-space spawn transform for the root (partial axes allowed). */
+    position?: Vec3Like;
+    rotation?: Vec3Like;
+    scale?: Vec3Like;
+};
+/**
+ * Instantiate a prefab into a live world at runtime.
+ *
+ * `source` may be a URL string, a script AssetInput (`{ path, type }`), or an
+ * already-loaded {@link PrefabAsset}. Resolves with the root entity id once
+ * all entities/components exist — heavyweight assets inside (models,
+ * textures, audio) continue loading reactively through their systems, using
+ * the shared model cache for repeat spawns.
+ */
+declare function spawnPrefab(world: World, source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<EntityId>;
+/**
+ * Delete a spawned prefab instance: the root entity plus every descendant
+ * (children first). Returns the number of entities removed. `dispose`
+ * releases GPU resources not flagged as shared (safe with the model cache).
+ */
+declare function despawnPrefab(world: World, rootId: EntityId, dispose?: boolean): number;
+
 type CreatePayload = {
     name?: string;
     transform?: TransformData;
@@ -867,6 +993,14 @@ declare class World {
     getEntityById(entityId: number): WorldEntityView | null;
     getEntitiesChildren(entityId: EntityId): WorldEntityView[];
     getEntitiesParent(entityId: EntityId): WorldEntityView | null;
+    /**
+     * Instantiate a prefab asset into this world at runtime — see
+     * {@link spawnPrefab}. Convenience wrapper so scripts and embedding apps
+     * can spawn without reaching for the object management system.
+     */
+    spawnPrefab(source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<EntityId>;
+    /** Remove a spawned prefab instance (root + descendants). */
+    despawnPrefab(rootEntityId: EntityId): number;
     getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Returns the singleton {@link Environment} component for the scene, or
@@ -959,6 +1093,21 @@ declare class World {
     subscribe(listener: StoreListener): () => void;
     getDebugSnapshot(maxDepth?: number): unknown;
     getDebugSignature(maxDepth?: number): string;
+    /**
+     * Serialize ONLY the given entities into the same columnar
+     * `{entities, components}` shape as {@link getDebugSnapshot} (no systems,
+     * no selection). Used by prefab/scene subtree serialization.
+     */
+    getEntitiesSnapshot(entityIds: EntityId[], maxDepth?: number): {
+        entities: number[];
+        components: Array<{
+            component: string;
+            entries: Array<{
+                entityId: number;
+                value: unknown;
+            }>;
+        }>;
+    };
     createHistorySnapshot(): WorldHistorySnapshot;
     applyHistorySnapshot(snapshot: WorldHistorySnapshot): void;
     private emitStoreChanged;
@@ -969,4 +1118,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { cloneHistoryValue as $, type AssetInput as A, type IntersectionResult as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type FloatInput as F, KeyboardKeys as G, type SliderInput as H, InputSystem as I, type TextInput as J, type KeyboardKey as K, type ToggleInput as L, type MouseButton as M, TransformSyncSystem as N, ObjectManagementSystem as O, ParentId as P, type Vec3 as Q, RenderSystem as R, type SelectionListener as S, TransformComponent as T, type Vector2Input as U, type Vec3$1 as V, type WorldEntityView$1 as W, type Vector3Input as X, type AnyComponent as Y, DEBUG_CHANGE_IGNORED_SYSTEMS as Z, type WorldHistorySnapshot as _, DEFAULT_POSTPROCESSING_STATE as a, normalizeDebugValue as a0, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type ComponentClass as m, type ParentLookup as n, type EcsEntityKind as o, type CheckboxInput as p, type ColorInput as q, type ComponentFactory as r, type ComponentInput as s, type ComponentKind as t, type DropdownInput as u, type DropdownOption as v, type EcsComponentFactoryKind as w, type EcsEntityEditorKind as x, type EntityId as y, type EntityInput as z };
+export { type ToggleInput as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, PREFAB_FILE_VERSION_NESTED as Q, type PrefabAsset as R, type SpawnPrefabSource as S, TransformComponent as T, type RemapSnapshotOptions as U, type Vec3$1 as V, type WorldEntityView$1 as W, RenderSystem as X, type SelectionListener as Y, type SliderInput as Z, type TextInput as _, DEFAULT_POSTPROCESSING_STATE as a, TransformSyncSystem as a0, type Vec3 as a1, type Vector2Input as a2, type Vector3Input as a3, clearPrefabCache as a4, despawnPrefab as a5, loadPrefab as a6, parsePrefabAsset as a7, prefabFileVersionFor as a8, remapSnapshotEntityIds as a9, setPrefabAssetUrlResolver as aa, spawnPrefab as ab, type AnyComponent as ac, DEBUG_CHANGE_IGNORED_SYSTEMS as ad, type WorldHistorySnapshot as ae, cloneHistoryValue as af, normalizeDebugValue as ag, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type SubtreeSnapshot as q, type EntityId as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };

package/dist/{System-BeuJ1xt5.d.ts → System-me3iAcMF.d.ts}

@@ -468,6 +468,132 @@ type NormalizeContext = {
 declare function normalizeDebugValue(value: unknown, ctx: NormalizeContext): unknown;
 declare function cloneHistoryValue<T>(value: T, seen?: WeakMap<object, unknown>): T;
 
+/**
+ * Snapshot-space entity-id walking/remapping.
+ *
+ * This module is the single source of truth for WHERE entity ids live inside
+ * a serialized world snapshot:
+ *   - `ParentId.value`
+ *   - `ScriptComponent.entries[].data` EntityInput (`{type:"entity", value}`)
+ *     and ComponentInput (`{type:"component", value:{entityId, …}}`)
+ *   - `InstancedMeshComponent.instanceEntityIds[]`
+ *   - `InstanceSlotComponent.groupEntityId`
+ *
+ * Any new id-bearing component field must be added here — serialization,
+ * instantiation and the override differ all route through this walker.
+ */
+type SubtreeSnapshot = {
+    entities: number[];
+    components: Array<{
+        component: string;
+        entries: Array<{
+            entityId: number;
+            value: unknown;
+        }>;
+    }>;
+};
+type ExternalRefWarning = {
+    /** Entity id (in the INPUT snapshot's id space) holding the reference. */
+    entityId: number;
+    component: string;
+    /** Slash-separated path of the reference inside the component value. */
+    path: string;
+    /** The referenced entity id that falls outside the id map. */
+    targetId: number;
+};
+type RemapSnapshotOptions = {
+    /**
+     * What to do with references to entities NOT present in the id map:
+     * - "null": replace the reference with null and record a warning
+     *   (prefab-file serialization — external refs must not leak).
+     * - "keep": leave the raw id untouched and record a warning.
+     * Default: "keep".
+     */
+    externalRefPolicy?: "null" | "keep";
+};
+/**
+ * Return a deep-cloned snapshot with every entity id (entity list, entry
+ * keys, and all id-bearing component fields) remapped through `idMap`.
+ * References to ids missing from the map follow `externalRefPolicy` and are
+ * reported in `warnings` (with ids in the INPUT snapshot's id space).
+ */
+declare function remapSnapshotEntityIds(snapshot: SubtreeSnapshot, idMap: Map<number, number>, options?: RemapSnapshotOptions): {
+    snapshot: SubtreeSnapshot;
+    warnings: ExternalRefWarning[];
+};
+
+declare const PREFAB_FILE_VERSION = 1;
+/** Written for files containing NESTED instances (parse accepts either). */
+declare const PREFAB_FILE_VERSION_NESTED = 2;
+/** File version to write for a given snapshot: 2 iff it nests instances. */
+declare function prefabFileVersionFor(snapshot: SubtreeSnapshot): number;
+/**
+ * Envelope of a `.prefab` asset file (and, later, `.scene` assets — same
+ * shape with `type: "scene"`). `snapshot` is the same columnar world-snapshot
+ * format `hydrateWorldFromSnapshotDetailed` consumes, with entity ids
+ * renumbered 1..N and every entity carrying a `PrefabNode` identity.
+ */
+type PrefabAsset = {
+    version: number;
+    type?: "prefab" | "scene";
+    name?: string;
+    snapshot: SubtreeSnapshot;
+};
+/** Validate untrusted JSON into a `PrefabAsset`, or null when malformed. */
+declare function parsePrefabAsset(json: unknown): PrefabAsset | null;
+
+type Vec3Like = {
+    x?: number;
+    y?: number;
+    z?: number;
+};
+/**
+ * Override how prefab asset URLs (the file URL itself AND every asset URL
+ * stored inside prefab files) are resolved before fetching. Published/preview
+ * runtimes register a resolver that maps the editor's `localasset://…/assets/x`
+ * URLs to `./assets/x`; the editor leaves it unset (identity — the
+ * `localasset://` protocol is fetchable there). Same pattern as
+ * {@link setDracoDecoderPath}. Pass null to restore identity.
+ */
+declare function setPrefabAssetUrlResolver(resolver: ((url: string) => string) | null): void;
+/**
+ * Fetch + parse (and cache) a `.prefab` asset. All strings inside the
+ * snapshot are passed through the registered URL resolver, so asset
+ * references load correctly in published/preview builds. Use this from
+ * preloaders to warm the same cache `spawnPrefab` reads.
+ */
+declare function loadPrefab(url: string): Promise<PrefabAsset>;
+/** Drop one cached prefab (or all when no url is given). */
+declare function clearPrefabCache(url?: string): void;
+type SpawnPrefabSource = string | {
+    path: string;
+    type?: string;
+} | PrefabAsset;
+type SpawnPrefabOptions = {
+    /** Parent the spawned root under this entity (default: world root). */
+    parentId?: EntityId | null;
+    /** Local-space spawn transform for the root (partial axes allowed). */
+    position?: Vec3Like;
+    rotation?: Vec3Like;
+    scale?: Vec3Like;
+};
+/**
+ * Instantiate a prefab into a live world at runtime.
+ *
+ * `source` may be a URL string, a script AssetInput (`{ path, type }`), or an
+ * already-loaded {@link PrefabAsset}. Resolves with the root entity id once
+ * all entities/components exist — heavyweight assets inside (models,
+ * textures, audio) continue loading reactively through their systems, using
+ * the shared model cache for repeat spawns.
+ */
+declare function spawnPrefab(world: World, source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<EntityId>;
+/**
+ * Delete a spawned prefab instance: the root entity plus every descendant
+ * (children first). Returns the number of entities removed. `dispose`
+ * releases GPU resources not flagged as shared (safe with the model cache).
+ */
+declare function despawnPrefab(world: World, rootId: EntityId, dispose?: boolean): number;
+
 type CreatePayload = {
     name?: string;
     transform?: TransformData;
@@ -867,6 +993,14 @@ declare class World {
     getEntityById(entityId: number): WorldEntityView | null;
     getEntitiesChildren(entityId: EntityId): WorldEntityView[];
     getEntitiesParent(entityId: EntityId): WorldEntityView | null;
+    /**
+     * Instantiate a prefab asset into this world at runtime — see
+     * {@link spawnPrefab}. Convenience wrapper so scripts and embedding apps
+     * can spawn without reaching for the object management system.
+     */
+    spawnPrefab(source: SpawnPrefabSource, options?: SpawnPrefabOptions): Promise<EntityId>;
+    /** Remove a spawned prefab instance (root + descendants). */
+    despawnPrefab(rootEntityId: EntityId): number;
     getObjectManagementSystem(): ObjectManagementSystem;
     /**
      * Returns the singleton {@link Environment} component for the scene, or
@@ -959,6 +1093,21 @@ declare class World {
     subscribe(listener: StoreListener): () => void;
     getDebugSnapshot(maxDepth?: number): unknown;
     getDebugSignature(maxDepth?: number): string;
+    /**
+     * Serialize ONLY the given entities into the same columnar
+     * `{entities, components}` shape as {@link getDebugSnapshot} (no systems,
+     * no selection). Used by prefab/scene subtree serialization.
+     */
+    getEntitiesSnapshot(entityIds: EntityId[], maxDepth?: number): {
+        entities: number[];
+        components: Array<{
+            component: string;
+            entries: Array<{
+                entityId: number;
+                value: unknown;
+            }>;
+        }>;
+    };
     createHistorySnapshot(): WorldHistorySnapshot;
     applyHistorySnapshot(snapshot: WorldHistorySnapshot): void;
     private emitStoreChanged;
@@ -969,4 +1118,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { cloneHistoryValue as $, type AssetInput as A, type IntersectionResult as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type FloatInput as F, KeyboardKeys as G, type SliderInput as H, InputSystem as I, type TextInput as J, type KeyboardKey as K, type ToggleInput as L, type MouseButton as M, TransformSyncSystem as N, ObjectManagementSystem as O, ParentId as P, type Vec3 as Q, RenderSystem as R, type SelectionListener as S, TransformComponent as T, type Vector2Input as U, type Vec3$1 as V, type WorldEntityView$1 as W, type Vector3Input as X, type AnyComponent as Y, DEBUG_CHANGE_IGNORED_SYSTEMS as Z, type WorldHistorySnapshot as _, DEFAULT_POSTPROCESSING_STATE as a, normalizeDebugValue as a0, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type ComponentClass as m, type ParentLookup as n, type EcsEntityKind as o, type CheckboxInput as p, type ColorInput as q, type ComponentFactory as r, type ComponentInput as s, type ComponentKind as t, type DropdownInput as u, type DropdownOption as v, type EcsComponentFactoryKind as w, type EcsEntityEditorKind as x, type EntityId as y, type EntityInput as z };
+export { type ToggleInput as $, type AssetInput as A, type EcsComponentFactoryKind as B, Component as C, DEFAULT_ENVIRONMENT_STATE as D, Environment as E, type EcsEntityEditorKind as F, type EntityInput as G, type FloatInput as H, InputSystem as I, type IntersectionResult as J, type KeyboardKey as K, KeyboardKeys as L, type MouseButton as M, PREFAB_FILE_VERSION as N, ObjectManagementSystem as O, ParentId as P, PREFAB_FILE_VERSION_NESTED as Q, type PrefabAsset as R, type SpawnPrefabSource as S, TransformComponent as T, type RemapSnapshotOptions as U, type Vec3$1 as V, type WorldEntityView$1 as W, RenderSystem as X, type SelectionListener as Y, type SliderInput as Z, type TextInput as _, DEFAULT_POSTPROCESSING_STATE as a, TransformSyncSystem as a0, type Vec3 as a1, type Vector2Input as a2, type Vector3Input as a3, clearPrefabCache as a4, despawnPrefab as a5, loadPrefab as a6, parsePrefabAsset as a7, prefabFileVersionFor as a8, remapSnapshotEntityIds as a9, setPrefabAssetUrlResolver as aa, spawnPrefab as ab, type AnyComponent as ac, DEBUG_CHANGE_IGNORED_SYSTEMS as ad, type WorldHistorySnapshot as ae, cloneHistoryValue as af, normalizeDebugValue as ag, type EnvironmentFogState as b, type EnvironmentFogType as c, type EnvironmentGradientEffect as d, type EnvironmentSkyboxState as e, type EnvironmentSkyboxType as f, type EnvironmentState as g, Postprocessing as h, type PostprocessingState as i, type TransformData as j, type EcsSystem as k, World as l, type SpawnPrefabOptions as m, type ComponentClass as n, type ParentLookup as o, type EcsEntityKind as p, type SubtreeSnapshot as q, type EntityId as r, type ExternalRefWarning as s, type CheckboxInput as t, type ColorInput as u, type ComponentFactory as v, type ComponentInput as w, type ComponentKind as x, type DropdownInput as y, type DropdownOption as z };

package/dist/{Video-Cym2C52L.d.ts → Video-DHnxjGhW.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, o as EcsEntityKind, x as EcsEntityEditorKind, y as EntityId } from './System-BeuJ1xt5.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-me3iAcMF.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -552,7 +552,7 @@ type ColliderState = {
         /** Rotation around local Z (radians). */
         z: number;
     };
-    /** Half-extents for `cuboid` shape, in world units. */
+    /** FULL edge lengths for `cuboid` shape (NOT half-extents), in unscaled local units — multiplied by the entity world scale at collider build time. */
     size: {
         /** Half-extent along X. */
         x: number;
@@ -821,6 +821,7 @@ type MaterialValueState = {
     /** Whether mipmaps are generated for texture maps. */
     useMipmaps: boolean;
 };
+declare function defaultMaterialValue(): MaterialValueState;
 /**
  * Material catalog for an entity. Tracks the live three.js materials
  * (`materials`, `material`) plus serialized authoring state (`values[]`)
@@ -842,7 +843,20 @@ declare class MaterialComponent extends Component {
     material: THREE.Material | null;
     /** Serialized authoring state (one entry per material in {@link materials}). Saved with the project. */
     values: MaterialValueState[];
+    /**
+     * Editor-managed material-asset linkage, one entry per slot (parallel to
+     * {@link values}). A `localasset://` URL of a `.material` asset file, or
+     * `null`/absent for a local (unlinked) material. The editor materializes the
+     * asset's values into {@link values} and keeps them in sync when the asset
+     * is edited — rendering and the runtime read only {@link values} and ignore
+     * this field. Saved with the project; survives material rebinds.
+     */
+    assetRefs: (string | null)[];
     constructor(materialOrMaterials?: THREE.Material | THREE.Material[]);
+    /** Link/unlink a slot to a material asset URL (editor bookkeeping only). */
+    setAssetRef(index: number, url: string | null): void;
+    /** The material-asset URL a slot is linked to, or null when local. */
+    getAssetRef(index: number): string | null;
     setMaterials(materialOrMaterials?: THREE.Material | THREE.Material[]): void;
     updateValue(index: number, patch: Partial<MaterialValueState>): void;
     resetValue(index: number): void;
@@ -1113,4 +1127,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, normalizePhysicsState as a1, type AnimationStateCallbacks as a2, AnimationStateMachine as a3, AnimationStateManager as a4, type StateMachine as a5, 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_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, defaultMaterialValue as a1, normalizePhysicsState as a2, type AnimationStateCallbacks as a3, AnimationStateMachine as a4, AnimationStateManager as a5, type StateMachine as a6, 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_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };

package/dist/{Video-D4B-z74P.d.cts → Video-U9hAnf9y.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, o as EcsEntityKind, x as EcsEntityEditorKind, y as EntityId } from './System-BeuJ1xt5.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-me3iAcMF.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 
 interface StateMachine {
@@ -552,7 +552,7 @@ type ColliderState = {
         /** Rotation around local Z (radians). */
         z: number;
     };
-    /** Half-extents for `cuboid` shape, in world units. */
+    /** FULL edge lengths for `cuboid` shape (NOT half-extents), in unscaled local units — multiplied by the entity world scale at collider build time. */
     size: {
         /** Half-extent along X. */
         x: number;
@@ -821,6 +821,7 @@ type MaterialValueState = {
     /** Whether mipmaps are generated for texture maps. */
     useMipmaps: boolean;
 };
+declare function defaultMaterialValue(): MaterialValueState;
 /**
  * Material catalog for an entity. Tracks the live three.js materials
  * (`materials`, `material`) plus serialized authoring state (`values[]`)
@@ -842,7 +843,20 @@ declare class MaterialComponent extends Component {
     material: THREE.Material | null;
     /** Serialized authoring state (one entry per material in {@link materials}). Saved with the project. */
     values: MaterialValueState[];
+    /**
+     * Editor-managed material-asset linkage, one entry per slot (parallel to
+     * {@link values}). A `localasset://` URL of a `.material` asset file, or
+     * `null`/absent for a local (unlinked) material. The editor materializes the
+     * asset's values into {@link values} and keeps them in sync when the asset
+     * is edited — rendering and the runtime read only {@link values} and ignore
+     * this field. Saved with the project; survives material rebinds.
+     */
+    assetRefs: (string | null)[];
     constructor(materialOrMaterials?: THREE.Material | THREE.Material[]);
+    /** Link/unlink a slot to a material asset URL (editor bookkeeping only). */
+    setAssetRef(index: number, url: string | null): void;
+    /** The material-asset URL a slot is linked to, or null when local. */
+    getAssetRef(index: number): string | null;
     setMaterials(materialOrMaterials?: THREE.Material | THREE.Material[]): void;
     updateValue(index: number, patch: Partial<MaterialValueState>): void;
     resetValue(index: number): void;
@@ -1113,4 +1127,4 @@ declare class VideoComponent extends Component {
     stop(): void;
 }
 
-export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, normalizePhysicsState as a1, type AnimationStateCallbacks as a2, AnimationStateMachine as a3, AnimationStateManager as a4, type StateMachine as a5, 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_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };
+export { type TransformSpaceValue as $, AnimationComponent as A, MeshGeometryComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MeshGeometryParameters as F, type MeshGeometryParametersByKind as G, ModelComponent as H, ImageComponent as I, type PhysicsState as J, type PlaneMeshParameters as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type RadiusMeshParameters as Q, type RadiusHeightMeshParameters as R, type RigidbodyState as S, type RigidbodyType as T, ScriptComponent as U, type ScriptEntry as V, Selectable as W, SelectionTransformState as X, SpriteComponent as Y, type TextureFilteringValue as Z, type TransformModeValue as _, type AnimationComponentOptions as a, VideoComponent as a0, defaultMaterialValue as a1, normalizePhysicsState as a2, type AnimationStateCallbacks as a3, AnimationStateMachine as a4, AnimationStateManager as a5, type StateMachine as a6, 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_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_RIGIDBODY_STATE as m, EntityType as n, ImageTarget as o, ImageTargetAnchor as p, type ImageTargetAnchorOptions as q, type ImageTargetReference as r, InstanceSlotComponent as s, type InstanceTransform as t, InstancedMeshComponent as u, type InstancedMeshKind as v, type LightValueState as w, type MaterialTypeValue as x, type MaterialValueState as y, MeshComponent as z };