@relu-interactives/spatial-ecs 0.2.25 → 0.3.1

package/dist/docs/api/index/functions/serializeEntitySubtree.md

@@ -0,0 +1,35 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / serializeEntitySubtree
+
+# Function: serializeEntitySubtree()
+
+```ts
+function serializeEntitySubtree(
+   world, 
+   rootId, 
+   options?): SerializeEntitySubtreeResult;
+```
+
+Defined in: [prefab/serializeEntitySubtree.ts:42](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L42)
+
+Serialize `rootId` + all descendants into a self-contained snapshot:
+entity ids renumbered 1..N in BFS parent-first order, all internal id
+references remapped, external references nulled + reported, root ParentId
+forced to null. The result is directly consumable by
+`hydrateWorldFromSnapshotDetailed` / `instantiateSubtree`.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `world` | [`World`](../classes/World.md) |
+| `rootId` | `number` |
+| `options?` | \{ `maxDepth?`: `number`; \} |
+| `options.maxDepth?` | `number` |
+
+## Returns
+
+[`SerializeEntitySubtreeResult`](../type-aliases/SerializeEntitySubtreeResult.md)

package/dist/docs/api/index/functions/setDracoDecoderPath.md

@@ -0,0 +1,30 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / setDracoDecoderPath
+
+# Function: setDracoDecoderPath()
+
+```ts
+function setDracoDecoderPath(path): void;
+```
+
+Defined in: [utils/dracoDecoderPath.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/utils/dracoDecoderPath.ts#L15)
+
+Override where the DRACO decoder files (draco_wasm_wrapper.js,
+draco_decoder.wasm, draco_decoder.js) are fetched from. Embedding apps
+whose bundlers relocate this package's chunks — making the default
+import.meta.url resolution point at a location that is never populated —
+should call this before any model loads. The path must end with "/".
+Pass null to restore the default resolution.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `path` | `string` \| `null` |
+
+## Returns
+
+`void`

package/dist/docs/api/index/functions/setPrefabAssetUrlResolver.md

@@ -0,0 +1,30 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / setPrefabAssetUrlResolver
+
+# Function: setPrefabAssetUrlResolver()
+
+```ts
+function setPrefabAssetUrlResolver(resolver): void;
+```
+
+Defined in: [prefab/spawnPrefab.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L21)
+
+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
+[setDracoDecoderPath](setDracoDecoderPath.md). Pass null to restore identity.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `resolver` | ((`url`) => `string`) \| `null` |
+
+## Returns
+
+`void`

package/dist/docs/api/index/functions/spawnPrefab.md

@@ -0,0 +1,36 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / spawnPrefab
+
+# Function: spawnPrefab()
+
+```ts
+function spawnPrefab(
+   world, 
+   source, 
+options?): Promise<number>;
+```
+
+Defined in: [prefab/spawnPrefab.ts:144](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L144)
+
+Instantiate a prefab into a live world at runtime.
+
+`source` may be a URL string, a script AssetInput (`{ path, type }`), or an
+already-loaded [PrefabAsset](../type-aliases/PrefabAsset.md). 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.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `world` | [`World`](../classes/World.md) |
+| `source` | [`SpawnPrefabSource`](../type-aliases/SpawnPrefabSource.md) |
+| `options?` | [`SpawnPrefabOptions`](../type-aliases/SpawnPrefabOptions.md) |
+
+## Returns
+
+`Promise`\<`number`\>

package/dist/docs/api/index/index.md

@@ -31,11 +31,18 @@
 | [ScriptBehaviourSystem](classes/ScriptBehaviourSystem.md) | - |
 | [TransformSyncSystem](classes/TransformSyncSystem.md) | - |
 
+### Scripting
+
+| Class | Description |
+| ------ | ------ |
+| [ScriptObject](classes/ScriptObject.md) | Base class for **script objects** — entities whose THREE.js visual is built entirely by user code (procedural geometry, shaders, particle systems, anything the editor can't author natively). |
+
 ### Systems
 
 | Class | Description |
 | ------ | ------ |
 | [AudioSystem](classes/AudioSystem.md) | Reconciles `AudioComponent` state with the underlying THREE.js audio objects each frame. |
+| [ScriptObjectSystem](classes/ScriptObjectSystem.md) | Builds, ticks, and disposes [ScriptObject](classes/ScriptObject.md) scripts. Unlike `ScriptBehaviourSystem`, this runs in the editor AND at runtime — there is NO `isEditorMode` gating anywhere here. A script's `build()` output is attached under the entity's `Object3DRef.object` (so it inherits transform, selection and visibility). `runtimeState` is written on transitions only (never every frame). |
 | [VideoSystem](classes/VideoSystem.md) | Reconciles `VideoComponent` state with the underlying HTML video element and THREE.js mesh/material each frame. |
 
 ## Interfaces
@@ -50,21 +57,44 @@
 | Type Alias | Description |
 | ------ | ------ |
 | [AnimationStateCallbacks](type-aliases/AnimationStateCallbacks.md) | - |
+| [ComponentValueMaps](type-aliases/ComponentValueMaps.md) | - |
 | [EcsWorldComponentSnapshot](type-aliases/EcsWorldComponentSnapshot.md) | - |
 | [EcsWorldStateSnapshotLike](type-aliases/EcsWorldStateSnapshotLike.md) | - |
 | [HydrateWorldFromSnapshotResult](type-aliases/HydrateWorldFromSnapshotResult.md) | - |
+| [HydrateOptions](type-aliases/HydrateOptions.md) | Optional behavior tweaks for [hydrateWorldFromSnapshotDetailed](functions/hydrateWorldFromSnapshotDetailed.md). Defaults preserve the historical full-world-load behavior; prefab/subtree instantiation passes stricter options. |
+| [ApplyPrefabToSnapshotResult](type-aliases/ApplyPrefabToSnapshotResult.md) | - |
+| [InstantiateSubtreeResult](type-aliases/InstantiateSubtreeResult.md) | - |
+| [NodeKeyMaps](type-aliases/NodeKeyMaps.md) | - |
+| [NestedRegion](type-aliases/NestedRegion.md) | - |
+| [NodeMaps](type-aliases/NodeMaps.md) | - |
+| [SerializeEntitySubtreeResult](type-aliases/SerializeEntitySubtreeResult.md) | - |
+| [SubtreeSnapshot](type-aliases/SubtreeSnapshot.md) | Snapshot-space entity-id walking/remapping. |
+| [ExternalRefWarning](type-aliases/ExternalRefWarning.md) | - |
+| [RemapSnapshotOptions](type-aliases/RemapSnapshotOptions.md) | - |
+| [SpawnPrefabSource](type-aliases/SpawnPrefabSource.md) | - |
+| [SpawnPrefabOptions](type-aliases/SpawnPrefabOptions.md) | - |
+| [PrefabAsset](type-aliases/PrefabAsset.md) | 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. |
 | [MouseButton](type-aliases/MouseButton.md) | - |
 | [EcsComponentFactoryKind](type-aliases/EcsComponentFactoryKind.md) | - |
 | [ComponentFactory](type-aliases/ComponentFactory.md) | - |
 | [SelectionContext](type-aliases/SelectionContext.md) | Optional context that enables raycast-based onSelect / onDeselect dispatch. When provided, pointer/touch taps on the canvas fire a raycast against the scene. If the hit object (or any ancestor) carries userData.entityId, every Behaviour instance for that entity receives onSelect(); the previously selected entity's instances receive onDeselect(). |
 | [KeyboardKey](type-aliases/KeyboardKey.md) | - |
+| [ModuleLoader](type-aliases/ModuleLoader.md) | Resolves a script URL to its ES module namespace. |
 
 ## Variables
 
 | Variable | Description |
 | ------ | ------ |
 | [HYDRATABLE\_ENTITY\_KINDS](variables/HYDRATABLE_ENTITY_KINDS.md) | - |
+| [NODE\_KEY\_SEPARATOR](variables/NODE_KEY_SEPARATOR.md) | - |
+| [ADDED\_NODE\_MARKER\_COMPONENT](variables/ADDED_NODE_MARKER_COMPONENT.md) | Reserved override "component" marking a node ADDED by the host document inside a nested instance region (`"<nodeKey>|+node|"`). File patching trusts stored overrides (the old base is unavailable), so without the marker a host-authored node inside the region would be indistinguishable from a node the child prefab removed — and get deleted. |
+| [OVERRIDE\_DIFF\_EXCLUDED\_COMPONENTS](variables/OVERRIDE_DIFF_EXCLUDED_COMPONENTS.md) | Components that never participate in override diffing/merging. |
+| [OVERRIDE\_ROOT\_EXCLUDED\_COMPONENTS](variables/OVERRIDE_ROOT_EXCLUDED_COMPONENTS.md) | Components excluded ONLY on the instance ROOT node — these are per-instance by definition (where the instance sits in the scene and what it's called). |
+| [PREFAB\_FILE\_VERSION](variables/PREFAB_FILE_VERSION.md) | - |
+| [PREFAB\_FILE\_VERSION\_NESTED](variables/PREFAB_FILE_VERSION_NESTED.md) | Written for files containing NESTED instances (parse accepts either). |
+| [SCRIPT\_OBJECT\_ROOT\_FLAG](variables/SCRIPT_OBJECT_ROOT_FLAG.md) | Tags the Object3D a script's `build()` returned, so reloads can find/remove it. |
 | [KeyboardKeys](variables/KeyboardKeys.md) | - |
+| [SHARED\_MODEL\_RESOURCE\_FLAG](variables/SHARED_MODEL_RESOURCE_FLAG.md) | userData flag set on geometries/materials that back shared (cached) model scenes. Entity disposal must skip these — other live clones and future spawns reference the same GPU resources. |
 
 ## Functions
 
@@ -91,6 +121,7 @@
 | [createPhysicsComponent](functions/createPhysicsComponent.md) | - |
 | [createPostprocessingComponent](functions/createPostprocessingComponent.md) | - |
 | [createScriptComponent](functions/createScriptComponent.md) | - |
+| [createScriptObjectComponent](functions/createScriptObjectComponent.md) | - |
 | [createSelectableComponent](functions/createSelectableComponent.md) | - |
 | [createSelectionTransformStateComponent](functions/createSelectionTransformStateComponent.md) | - |
 | [createSpriteComponent](functions/createSpriteComponent.md) | - |
@@ -98,8 +129,42 @@
 | [createVideoComponent](functions/createVideoComponent.md) | - |
 | [registerDefaultComponentFactories](functions/registerDefaultComponentFactories.md) | - |
 | [registerDefaultFactories](functions/registerDefaultFactories.md) | - |
+| [buildComponentValueMaps](functions/buildComponentValueMaps.md) | - |
 | [hydrateWorldFromSnapshotDetailed](functions/hydrateWorldFromSnapshotDetailed.md) | - |
 | [hydrateWorldFromSnapshot](functions/hydrateWorldFromSnapshot.md) | - |
+| [restorePostCreateComponents](functions/restorePostCreateComponents.md) | - |
+| [restoreComponentState](functions/restoreComponentState.md) | - |
+| [applyPrefabToSnapshotInstances](functions/applyPrefabToSnapshotInstances.md) | Patch every top-level-relative nested instance of `nestedUrl` inside `hostSnapshot` with `newNestedSnapshot`. Deeper nesting (B inside C inside A) is NOT touched here — it cascades through C's own file. |
+| [collectEntitySubtree](functions/collectEntitySubtree.md) | Collect the given roots plus every descendant, BFS parent-first, using the `ParentId` component edges. Parent-first ordering matters: serialization renumbers ids in this order and instantiation creates entities in file order, so parents always exist before their children are linked. |
+| [collectDirectPrefabDependencies](functions/collectDirectPrefabDependencies.md) | Direct (top-level-relative) prefab urls a document depends on — the edges of the nesting graph. Deeper nesting is reached transitively through each dependency's own file, never directly. |
+| [instantiateSubtree](functions/instantiateSubtree.md) | Hydrate a self-contained subtree snapshot (a prefab file's `snapshot`) into a LIVE world: fresh entity ids, internal references remapped, no camera promotion, transform pass scoped to the created entities. |
+| [buildNodeKeyMapsFromSnapshot](functions/buildNodeKeyMapsFromSnapshot.md) | - |
+| [collectSnapshotSubtreeIds](functions/collectSnapshotSubtreeIds.md) | JSON-space subtree ids (root first, BFS) via ParentId edges. |
+| [findTopLevelNestedRegions](functions/findTopLevelNestedRegions.md) | TOP-LEVEL-RELATIVE nested instance regions of a document: instance roots that are not the scope root and not themselves inside another region. Deeper nesting is reached by cascading through the intermediate prefab's own file, never directly. |
+| [findSnapshotRootEntityIds](functions/findSnapshotRootEntityIds.md) | Entity ids of entities whose ParentId is null or absent. |
+| [buildNodeMapsFromSnapshot](functions/buildNodeMapsFromSnapshot.md) | - |
+| [indexSnapshotByEntity](functions/indexSnapshotByEntity.md) | Invert the columnar snapshot into entityId → (componentName → value). |
+| [canonicalizeComponentValue](functions/canonicalizeComponentValue.md) | Canonicalize a serialized component value into nodeId-space: - entity-id fields → `{$node}` (internal) or raw id (external) - ScriptComponent entries keep only `{className, scriptUrl, enabled, data}` (entityId/runtimeState/runtimeMessage are per-instance transients) - ScriptObjectComponent keeps only `{scriptUrl, className, enabled, data}` (runtimeState/runtimeMessage are per-instance transients) - Object3DRef keeps only `{visibility}` (the rest is a live object ref) |
+| [decanonicalizeComponentValue](functions/decanonicalizeComponentValue.md) | Replace every `{$node}` marker (at any depth) with the mapped entity id from `nodeToId`, or null when the node no longer exists. Exact inverse of canonicalization for the id-bearing positions. |
+| [encodeOverride](functions/encodeOverride.md) | - |
+| [parseOverride](functions/parseOverride.md) | - |
+| [groupOverridePaths](functions/groupOverridePaths.md) | nodeId → componentName → set of overridden paths. |
+| [collectDiffPaths](functions/collectDiffPaths.md) | Collect leaf paths where two canonical values differ. Semantics: - `{$node}` refs compare atomically by nodeId - arrays of differing length are ONE atomic override (the array path); equal lengths recurse per index - object key present on one side only marks that key's path - type mismatches mark the current path An empty-string path means the values differ at the top level. |
+| [computeInstanceOverrides](functions/computeInstanceOverrides.md) | Diff a live instance subtree against its prefab base (both as serialized subtree snapshots carrying PrefabNode identity) and return the encoded override list: every path where the instance deviates from the base. |
+| [mergeComponentValue](functions/mergeComponentValue.md) | Merge a component's NEW canonical file value with an instance's canonical value, preserving the instance side at every overridden path. An empty path ("") means the whole component is overridden → instance wins. |
+| [serializeEntitySubtree](functions/serializeEntitySubtree.md) | Serialize `rootId` + all descendants into a self-contained snapshot: entity ids renumbered 1..N in BFS parent-first order, all internal id references remapped, external references nulled + reported, root ParentId forced to null. The result is directly consumable by `hydrateWorldFromSnapshotDetailed` / `instantiateSubtree`. |
+| [remapSnapshotEntityIds](functions/remapSnapshotEntityIds.md) | 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). |
+| [setPrefabAssetUrlResolver](functions/setPrefabAssetUrlResolver.md) | 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 [setDracoDecoderPath](functions/setDracoDecoderPath.md). Pass null to restore identity. |
+| [loadPrefab](functions/loadPrefab.md) | 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. |
+| [clearPrefabCache](functions/clearPrefabCache.md) | Drop one cached prefab (or all when no url is given). |
+| [spawnPrefab](functions/spawnPrefab.md) | Instantiate a prefab into a live world at runtime. |
+| [despawnPrefab](functions/despawnPrefab.md) | 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). |
+| [prefabFileVersionFor](functions/prefabFileVersionFor.md) | File version to write for a given snapshot: 2 iff it nests instances. |
+| [parsePrefabAsset](functions/parsePrefabAsset.md) | Validate untrusted JSON into a `PrefabAsset`, or null when malformed. |
+| [setDracoDecoderPath](functions/setDracoDecoderPath.md) | Override where the DRACO decoder files (draco_wasm_wrapper.js, draco_decoder.wasm, draco_decoder.js) are fetched from. Embedding apps whose bundlers relocate this package's chunks — making the default import.meta.url resolution point at a location that is never populated — should call this before any model loads. The path must end with "/". Pass null to restore the default resolution. |
+| [resolveDracoDecoderPath](functions/resolveDracoDecoderPath.md) | - |
+| [loadSharedGltf](functions/loadSharedGltf.md) | Load a GLTF once per URL and share the parsed result, so repeated spawns of the same model skip both the fetch and the parse. The cached scene must never be mounted directly (an Object3D has a single parent) — mount a cloneModelScene() of it. Failed loads are evicted so a retry re-fetches. |
+| [clearModelCache](functions/clearModelCache.md) | Forget cached models (one URL, or everything). Subsequent loads fetch and parse anew. Does not dispose GPU resources — live clones may still use them. |
 
 ## References
 

package/dist/docs/api/index/interfaces/EcsSystem.md

@@ -6,7 +6,7 @@
 
 # Interface: EcsSystem
 
-Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/System.ts#L3)
+Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L3)
 
 ## Methods
 
@@ -16,7 +16,7 @@ Defined in: [System.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-
 update(world, deltaTime): void;
 ```
 
-Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/System.ts#L4)
+Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L4)
 
 #### Parameters
 
@@ -37,7 +37,7 @@ Defined in: [System.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-
 optional dispose(world): void;
 ```
 
-Defined in: [System.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/System.ts#L5)
+Defined in: [System.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/System.ts#L5)
 
 #### Parameters
 

package/dist/docs/api/index/interfaces/StateMachine.md

@@ -6,21 +6,21 @@
 
 # Interface: StateMachine
 
-Defined in: [AnimationStateMachine.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L3)
+Defined in: [AnimationStateMachine.ts:3](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L3)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="name"></a> `name` | `string` | [AnimationStateMachine.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L4) |
-| <a id="clip"></a> `clip` | `AnimationClip` | [AnimationStateMachine.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L5) |
-| <a id="clipid"></a> `clipId` | `string` \| `null` | [AnimationStateMachine.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L6) |
-| <a id="loop"></a> `loop` | `boolean` | [AnimationStateMachine.ts:7](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L7) |
-| <a id="isplaying"></a> `isPlaying` | `boolean` | [AnimationStateMachine.ts:8](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L8) |
-| <a id="ispaused"></a> `isPaused` | `boolean` | [AnimationStateMachine.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L9) |
-| <a id="onstart"></a> `onStart` | () => `void` | [AnimationStateMachine.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L10) |
-| <a id="onplaying"></a> `onPlaying` | () => `void` | [AnimationStateMachine.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L11) |
-| <a id="onend"></a> `onEnd` | () => `void` | [AnimationStateMachine.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L12) |
-| <a id="play"></a> `play` | () => `void` | [AnimationStateMachine.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L13) |
-| <a id="pause"></a> `pause` | () => `void` | [AnimationStateMachine.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L14) |
-| <a id="stop"></a> `stop` | () => `void` | [AnimationStateMachine.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L15) |
+| <a id="name"></a> `name` | `string` | [AnimationStateMachine.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L4) |
+| <a id="clip"></a> `clip` | `AnimationClip` | [AnimationStateMachine.ts:5](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L5) |
+| <a id="clipid"></a> `clipId` | `string` \| `null` | [AnimationStateMachine.ts:6](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L6) |
+| <a id="loop"></a> `loop` | `boolean` | [AnimationStateMachine.ts:7](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L7) |
+| <a id="isplaying"></a> `isPlaying` | `boolean` | [AnimationStateMachine.ts:8](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L8) |
+| <a id="ispaused"></a> `isPaused` | `boolean` | [AnimationStateMachine.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L9) |
+| <a id="onstart"></a> `onStart` | () => `void` | [AnimationStateMachine.ts:10](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L10) |
+| <a id="onplaying"></a> `onPlaying` | () => `void` | [AnimationStateMachine.ts:11](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L11) |
+| <a id="onend"></a> `onEnd` | () => `void` | [AnimationStateMachine.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L12) |
+| <a id="play"></a> `play` | () => `void` | [AnimationStateMachine.ts:13](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L13) |
+| <a id="pause"></a> `pause` | () => `void` | [AnimationStateMachine.ts:14](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L14) |
+| <a id="stop"></a> `stop` | () => `void` | [AnimationStateMachine.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L15) |

package/dist/docs/api/index/type-aliases/AnimationStateCallbacks.md

@@ -14,12 +14,12 @@ type AnimationStateCallbacks = {
 };
 ```
 
-Defined in: [AnimationStateMachine.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L18)
+Defined in: [AnimationStateMachine.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L18)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="onstart"></a> `onStart?` | () => `void` | [AnimationStateMachine.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L19) |
-| <a id="onplaying"></a> `onPlaying?` | () => `void` | [AnimationStateMachine.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L20) |
-| <a id="onend"></a> `onEnd?` | () => `void` | [AnimationStateMachine.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/AnimationStateMachine.ts#L21) |
+| <a id="onstart"></a> `onStart?` | () => `void` | [AnimationStateMachine.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L19) |
+| <a id="onplaying"></a> `onPlaying?` | () => `void` | [AnimationStateMachine.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L20) |
+| <a id="onend"></a> `onEnd?` | () => `void` | [AnimationStateMachine.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/AnimationStateMachine.ts#L21) |

package/dist/docs/api/index/type-aliases/ApplyPrefabToSnapshotResult.md

@@ -0,0 +1,23 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ApplyPrefabToSnapshotResult
+
+# Type Alias: ApplyPrefabToSnapshotResult
+
+```ts
+type ApplyPrefabToSnapshotResult = {
+  snapshot: SubtreeSnapshot;
+  changed: boolean;
+};
+```
+
+Defined in: [prefab/applyPrefabToSnapshot.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L112)
+
+## Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="snapshot"></a> `snapshot` | [`SubtreeSnapshot`](SubtreeSnapshot.md) | [prefab/applyPrefabToSnapshot.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L113) |
+| <a id="changed"></a> `changed` | `boolean` | [prefab/applyPrefabToSnapshot.ts:114](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/applyPrefabToSnapshot.ts#L114) |

package/dist/docs/api/index/type-aliases/ComponentFactory.md

@@ -10,7 +10,7 @@
 type ComponentFactory = (world, entityId, ...args) => unknown;
 ```
 
-Defined in: [systems/ObjectManagementSystem.ts:58](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ObjectManagementSystem.ts#L58)
+Defined in: [systems/ObjectManagementSystem.ts:60](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ObjectManagementSystem.ts#L60)
 
 ## Parameters
 

package/dist/docs/api/index/type-aliases/ComponentValueMaps.md

@@ -0,0 +1,69 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ComponentValueMaps
+
+# Type Alias: ComponentValueMaps
+
+```ts
+type ComponentValueMaps = {
+  object3DRefValues: Map<number, unknown>;
+  nameValues: Map<number, unknown>;
+  transformValues: Map<number, unknown>;
+  modelValues: Map<number, unknown>;
+  imageValues: Map<number, unknown>;
+  spriteValues: Map<number, unknown>;
+  videoValues: Map<number, unknown>;
+  cameraValues: Map<number, unknown>;
+  environmentValues: Map<number, unknown>;
+  postprocessingValues: Map<number, unknown>;
+  audioValues: Map<number, unknown>;
+  imageTargetValues: Map<number, unknown>;
+  lightValues: Map<number, unknown>;
+  materialValues: Map<number, unknown>;
+  meshGeometryValues: Map<number, unknown>;
+  selectableValues: Map<number, unknown>;
+  physicsValues: Map<number, unknown>;
+  animationValues: Map<number, unknown>;
+  imageTargetAnchorValues: Map<number, unknown>;
+  scriptValues: Map<number, unknown>;
+  scriptObjectValues: Map<number, unknown>;
+  instancedMeshValues: Map<number, unknown>;
+  instanceSlotValues: Map<number, unknown>;
+  prefabNodeValues: Map<number, unknown>;
+  prefabInstanceValues: Map<number, unknown>;
+};
+```
+
+Defined in: [hydration/types.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L15)
+
+## Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="object3drefvalues"></a> `object3DRefValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:16](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L16) |
+| <a id="namevalues"></a> `nameValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L17) |
+| <a id="transformvalues"></a> `transformValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L18) |
+| <a id="modelvalues"></a> `modelValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L19) |
+| <a id="imagevalues"></a> `imageValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:20](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L20) |
+| <a id="spritevalues"></a> `spriteValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L21) |
+| <a id="videovalues"></a> `videoValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L22) |
+| <a id="cameravalues"></a> `cameraValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L23) |
+| <a id="environmentvalues"></a> `environmentValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:24](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L24) |
+| <a id="postprocessingvalues"></a> `postprocessingValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L25) |
+| <a id="audiovalues"></a> `audioValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:26](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L26) |
+| <a id="imagetargetvalues"></a> `imageTargetValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:27](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L27) |
+| <a id="lightvalues"></a> `lightValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:28](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L28) |
+| <a id="materialvalues"></a> `materialValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:29](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L29) |
+| <a id="meshgeometryvalues"></a> `meshGeometryValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:30](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L30) |
+| <a id="selectablevalues"></a> `selectableValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L31) |
+| <a id="physicsvalues"></a> `physicsValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L32) |
+| <a id="animationvalues"></a> `animationValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L33) |
+| <a id="imagetargetanchorvalues"></a> `imageTargetAnchorValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:34](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L34) |
+| <a id="scriptvalues"></a> `scriptValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L35) |
+| <a id="scriptobjectvalues"></a> `scriptObjectValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:36](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L36) |
+| <a id="instancedmeshvalues"></a> `instancedMeshValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L37) |
+| <a id="instanceslotvalues"></a> `instanceSlotValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:38](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L38) |
+| <a id="prefabnodevalues"></a> `prefabNodeValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L39) |
+| <a id="prefabinstancevalues"></a> `prefabInstanceValues` | `Map`\<`number`, `unknown`\> | [hydration/types.ts:40](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L40) |

package/dist/docs/api/index/type-aliases/EcsComponentFactoryKind.md

@@ -27,6 +27,7 @@ type EcsComponentFactoryKind =
   | "physics"
   | "postprocessing"
   | "script"
+  | "scriptObject"
   | "selectable"
   | "selectionTransformState"
   | "sprite"
@@ -35,4 +36,4 @@ type EcsComponentFactoryKind =
   | "instancedMesh";
 ```
 
-Defined in: [systems/ObjectManagementSystem.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ObjectManagementSystem.ts#L31)
+Defined in: [systems/ObjectManagementSystem.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ObjectManagementSystem.ts#L32)

package/dist/docs/api/index/type-aliases/EcsWorldComponentSnapshot.md

@@ -16,11 +16,11 @@ type EcsWorldComponentSnapshot = {
 };
 ```
 
-Defined in: [hydration/types.ts:40](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L40)
+Defined in: [hydration/types.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L43)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="component"></a> `component` | `string` | [hydration/types.ts:41](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L41) |
-| <a id="entries"></a> `entries` | \{ `entityId`: `number`; `value`: `unknown`; \}[] | [hydration/types.ts:42](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L42) |
+| <a id="component"></a> `component` | `string` | [hydration/types.ts:44](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L44) |
+| <a id="entries"></a> `entries` | \{ `entityId`: `number`; `value`: `unknown`; \}[] | [hydration/types.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L45) |

package/dist/docs/api/index/type-aliases/EcsWorldStateSnapshotLike.md

@@ -14,12 +14,12 @@ type EcsWorldStateSnapshotLike = {
 };
 ```
 
-Defined in: [hydration/types.ts:48](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L48)
+Defined in: [hydration/types.ts:51](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L51)
 
 ## Properties
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="selectedentityid"></a> `selectedEntityId?` | `number` \| `null` | [hydration/types.ts:49](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L49) |
-| <a id="entities"></a> `entities` | `number`[] | [hydration/types.ts:50](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L50) |
-| <a id="components"></a> `components` | [`EcsWorldComponentSnapshot`](EcsWorldComponentSnapshot.md)[] | [hydration/types.ts:51](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L51) |
+| <a id="selectedentityid"></a> `selectedEntityId?` | `number` \| `null` | [hydration/types.ts:52](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L52) |
+| <a id="entities"></a> `entities` | `number`[] | [hydration/types.ts:53](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L53) |
+| <a id="components"></a> `components` | [`EcsWorldComponentSnapshot`](EcsWorldComponentSnapshot.md)[] | [hydration/types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L54) |

package/dist/docs/api/index/type-aliases/ExternalRefWarning.md

@@ -0,0 +1,27 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ExternalRefWarning
+
+# Type Alias: ExternalRefWarning
+
+```ts
+type ExternalRefWarning = {
+  entityId: number;
+  component: string;
+  path: string;
+  targetId: number;
+};
+```
+
+Defined in: [prefab/snapshotIdUtils.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L25)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="entityid"></a> `entityId` | `number` | Entity id (in the INPUT snapshot's id space) holding the reference. | [prefab/snapshotIdUtils.ts:27](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L27) |
+| <a id="component"></a> `component` | `string` | - | [prefab/snapshotIdUtils.ts:28](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L28) |
+| <a id="path"></a> `path` | `string` | Slash-separated path of the reference inside the component value. | [prefab/snapshotIdUtils.ts:30](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L30) |
+| <a id="targetid"></a> `targetId` | `number` | The referenced entity id that falls outside the id map. | [prefab/snapshotIdUtils.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L32) |

package/dist/docs/api/index/type-aliases/HydrateOptions.md

@@ -0,0 +1,27 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / HydrateOptions
+
+# Type Alias: HydrateOptions
+
+```ts
+type HydrateOptions = {
+  assignPrimaryCamera?: boolean;
+  applyTransformsScope?: "world" | "created";
+};
+```
+
+Defined in: [hydration/types.ts:69](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L69)
+
+Optional behavior tweaks for [hydrateWorldFromSnapshotDetailed](../functions/hydrateWorldFromSnapshotDetailed.md).
+Defaults preserve the historical full-world-load behavior; prefab/subtree
+instantiation passes stricter options.
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="assignprimarycamera"></a> `assignPrimaryCamera?` | `boolean` | When false, no camera in the snapshot is promoted to the world camera. Defaults to true (full scene loads want their default camera active); prefab spawns pass false so a spawned camera never hijacks the view. | [hydration/types.ts:75](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L75) |
+| <a id="applytransformsscope"></a> `applyTransformsScope?` | `"world"` \| `"created"` | "world" (default) re-applies local transforms for every entity in the world after parent links restore — correct for full scene loads. "created" limits the pass to entities created by THIS hydrate call, so mid-session spawns don't touch unrelated live entities. | [hydration/types.ts:82](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L82) |

package/dist/docs/api/index/type-aliases/HydrateWorldFromSnapshotResult.md

@@ -10,14 +10,16 @@
 type HydrateWorldFromSnapshotResult = {
   restoredCount: number;
   selectedEntityId: number | null;
+  idMap: Map<number, number>;
 };
 ```
 
-Defined in: [hydration/types.ts:54](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L54)
+Defined in: [hydration/types.ts:57](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L57)
 
 ## Properties
 
-| Property | Type | Defined in |
-| ------ | ------ | ------ |
-| <a id="restoredcount"></a> `restoredCount` | `number` | [hydration/types.ts:55](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L55) |
-| <a id="selectedentityid"></a> `selectedEntityId` | `number` \| `null` | [hydration/types.ts:56](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L56) |
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="restoredcount"></a> `restoredCount` | `number` | - | [hydration/types.ts:58](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L58) |
+| <a id="selectedentityid"></a> `selectedEntityId` | `number` \| `null` | - | [hydration/types.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L59) |
+| <a id="idmap"></a> `idMap` | `Map`\<`number`, `number`\> | Snapshot entity id → created live entity id for every hydrated entity. | [hydration/types.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L61) |