@relu-interactives/spatial-ecs 0.2.25 → 0.3.0

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

@@ -0,0 +1,23 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / InstantiateSubtreeResult
+
+# Type Alias: InstantiateSubtreeResult
+
+```ts
+type InstantiateSubtreeResult = {
+  rootId: EntityId | null;
+  idMap: Map<number, number>;
+};
+```
+
+Defined in: [prefab/instantiateSubtree.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/instantiateSubtree.ts#L21)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="rootid"></a> `rootId` | [`EntityId`](../../types/type-aliases/EntityId.md) \| `null` | Live entity id of the subtree root, or null when nothing hydrated. | [prefab/instantiateSubtree.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/instantiateSubtree.ts#L23) |
+| <a id="idmap"></a> `idMap` | `Map`\<`number`, `number`\> | Snapshot entity id → live entity id. | [prefab/instantiateSubtree.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/instantiateSubtree.ts#L25) |

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

@@ -10,4 +10,4 @@
 type KeyboardKey = typeof KeyboardKeys[keyof typeof KeyboardKeys];
 ```
 
-Defined in: [systems/keyboardKeys.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/keyboardKeys.ts#L92)
+Defined in: [systems/keyboardKeys.ts:92](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/keyboardKeys.ts#L92)

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

@@ -0,0 +1,25 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ModuleLoader
+
+# Type Alias: ModuleLoader
+
+```ts
+type ModuleLoader = (scriptUrl) => Promise<Record<string, unknown>>;
+```
+
+Defined in: [systems/scriptShared.ts:12](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/scriptShared.ts#L12)
+
+Resolves a script URL to its ES module namespace.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `scriptUrl` | `string` |
+
+## Returns
+
+`Promise`\<`Record`\<`string`, `unknown`\>\>

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

@@ -10,4 +10,4 @@
 type MouseButton = "left" | "middle" | "right";
 ```
 
-Defined in: [systems/InputSystem.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/InputSystem.ts#L9)
+Defined in: [systems/InputSystem.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/InputSystem.ts#L9)

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

@@ -0,0 +1,27 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / NestedRegion
+
+# Type Alias: NestedRegion
+
+```ts
+type NestedRegion = {
+  rootEntityId: number;
+  url: string;
+  instanceId: string;
+  overrides: string[];
+};
+```
+
+Defined in: [prefab/nodeKeys.ts:194](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L194)
+
+## Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="rootentityid"></a> `rootEntityId` | `number` | [prefab/nodeKeys.ts:195](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L195) |
+| <a id="url"></a> `url` | `string` | [prefab/nodeKeys.ts:196](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L196) |
+| <a id="instanceid"></a> `instanceId` | `string` | [prefab/nodeKeys.ts:197](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L197) |
+| <a id="overrides"></a> `overrides` | `string`[] | [prefab/nodeKeys.ts:198](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L198) |

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

@@ -0,0 +1,30 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / NodeKeyMaps
+
+# Type Alias: NodeKeyMaps
+
+```ts
+type NodeKeyMaps = {
+  idToKey: Map<number, string>;
+  keyToId: Map<string, number>;
+  rootKey: string | null;
+  boundaryIds: Map<number, {
+     url: string;
+     instanceId: string;
+  }>;
+};
+```
+
+Defined in: [prefab/nodeKeys.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L33)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="idtokey"></a> `idToKey` | `Map`\<`number`, `string`\> | - | [prefab/nodeKeys.ts:34](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L34) |
+| <a id="keytoid"></a> `keyToId` | `Map`\<`string`, `number`\> | - | [prefab/nodeKeys.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L35) |
+| <a id="rootkey"></a> `rootKey` | `string` \| `null` | nodeKey of the scope root (bare nodeId), or null when it has none. | [prefab/nodeKeys.ts:37](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L37) |
+| <a id="boundaryids"></a> `boundaryIds` | `Map`\<`number`, \{ `url`: `string`; `instanceId`: `string`; \}\> | Entity ids of NESTED instance roots (non-scope-root PrefabInstance). | [prefab/nodeKeys.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L39) |

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

@@ -0,0 +1,25 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / NodeMaps
+
+# Type Alias: NodeMaps
+
+```ts
+type NodeMaps = {
+  idToNode: Map<number, string>;
+  nodeToId: Map<string, number>;
+  rootNodeId: string | null;
+};
+```
+
+Defined in: [prefab/overrides.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L43)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="idtonode"></a> `idToNode` | `Map`\<`number`, `string`\> | - | [prefab/overrides.ts:44](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L44) |
+| <a id="nodetoid"></a> `nodeToId` | `Map`\<`string`, `number`\> | - | [prefab/overrides.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L45) |
+| <a id="rootnodeid"></a> `rootNodeId` | `string` \| `null` | nodeId of the subtree root (entity whose ParentId is null/absent). | [prefab/overrides.ts:47](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L47) |

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

@@ -0,0 +1,32 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / PrefabAsset
+
+# Type Alias: PrefabAsset
+
+```ts
+type PrefabAsset = {
+  version: number;
+  type?: "prefab" | "scene";
+  name?: string;
+  snapshot: SubtreeSnapshot;
+};
+```
+
+Defined in: [prefab/types.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L21)
+
+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.
+
+## Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="version"></a> `version` | `number` | [prefab/types.ts:22](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L22) |
+| <a id="type"></a> `type?` | `"prefab"` \| `"scene"` | [prefab/types.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L23) |
+| <a id="name"></a> `name?` | `string` | [prefab/types.ts:24](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L24) |
+| <a id="snapshot"></a> `snapshot` | [`SubtreeSnapshot`](SubtreeSnapshot.md) | [prefab/types.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L25) |

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

@@ -0,0 +1,21 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / RemapSnapshotOptions
+
+# Type Alias: RemapSnapshotOptions
+
+```ts
+type RemapSnapshotOptions = {
+  externalRefPolicy?: "null" | "keep";
+};
+```
+
+Defined in: [prefab/snapshotIdUtils.ts:35](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L35)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="externalrefpolicy"></a> `externalRefPolicy?` | `"null"` \| `"keep"` | 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". | [prefab/snapshotIdUtils.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L43) |

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

@@ -14,7 +14,7 @@ type SelectionContext = {
 };
 ```
 
-Defined in: [systems/ScriptBehaviourSystem.ts:259](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ScriptBehaviourSystem.ts#L259)
+Defined in: [systems/ScriptBehaviourSystem.ts:105](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ScriptBehaviourSystem.ts#L105)
 
 Optional context that enables raycast-based onSelect / onDeselect dispatch.
 When provided, pointer/touch taps on the canvas fire a raycast against the
@@ -26,6 +26,6 @@ selected entity's instances receive onDeselect().
 
 | Property | Type | Defined in |
 | ------ | ------ | ------ |
-| <a id="camera"></a> `camera` | `THREE.Camera` | [systems/ScriptBehaviourSystem.ts:260](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ScriptBehaviourSystem.ts#L260) |
-| <a id="scene"></a> `scene` | `THREE.Scene` | [systems/ScriptBehaviourSystem.ts:261](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ScriptBehaviourSystem.ts#L261) |
-| <a id="domelement"></a> `domElement` | `HTMLElement` | [systems/ScriptBehaviourSystem.ts:262](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/systems/ScriptBehaviourSystem.ts#L262) |
+| <a id="camera"></a> `camera` | `THREE.Camera` | [systems/ScriptBehaviourSystem.ts:106](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ScriptBehaviourSystem.ts#L106) |
+| <a id="scene"></a> `scene` | `THREE.Scene` | [systems/ScriptBehaviourSystem.ts:107](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ScriptBehaviourSystem.ts#L107) |
+| <a id="domelement"></a> `domElement` | `HTMLElement` | [systems/ScriptBehaviourSystem.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/systems/ScriptBehaviourSystem.ts#L108) |

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

@@ -0,0 +1,25 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / SerializeEntitySubtreeResult
+
+# Type Alias: SerializeEntitySubtreeResult
+
+```ts
+type SerializeEntitySubtreeResult = {
+  snapshot: SubtreeSnapshot;
+  warnings: ExternalRefWarning[];
+  strippedComponents: string[];
+};
+```
+
+Defined in: [prefab/serializeEntitySubtree.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L23)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="snapshot"></a> `snapshot` | [`SubtreeSnapshot`](SubtreeSnapshot.md) | - | [prefab/serializeEntitySubtree.ts:24](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L24) |
+| <a id="warnings"></a> `warnings` | [`ExternalRefWarning`](ExternalRefWarning.md)[] | References that pointed OUTSIDE the subtree and were nulled out (ids are LIVE world ids so callers can name the offending entities). The root's own external parent link is nulled silently — it is expected. | [prefab/serializeEntitySubtree.ts:30](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L30) |
+| <a id="strippedcomponents"></a> `strippedComponents` | `string`[] | Component types stripped because they are scene singletons. | [prefab/serializeEntitySubtree.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L32) |

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

@@ -0,0 +1,27 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / SpawnPrefabOptions
+
+# Type Alias: SpawnPrefabOptions
+
+```ts
+type SpawnPrefabOptions = {
+  parentId?: EntityId | null;
+  position?: Vec3Like;
+  rotation?: Vec3Like;
+  scale?: Vec3Like;
+};
+```
+
+Defined in: [prefab/spawnPrefab.ts:111](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L111)
+
+## Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="parentid"></a> `parentId?` | [`EntityId`](../../types/type-aliases/EntityId.md) \| `null` | Parent the spawned root under this entity (default: world root). | [prefab/spawnPrefab.ts:113](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L113) |
+| <a id="position"></a> `position?` | `Vec3Like` | Local-space spawn transform for the root (partial axes allowed). | [prefab/spawnPrefab.ts:115](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L115) |
+| <a id="rotation"></a> `rotation?` | `Vec3Like` | - | [prefab/spawnPrefab.ts:116](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L116) |
+| <a id="scale"></a> `scale?` | `Vec3Like` | - | [prefab/spawnPrefab.ts:117](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L117) |

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

@@ -0,0 +1,19 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / SpawnPrefabSource
+
+# Type Alias: SpawnPrefabSource
+
+```ts
+type SpawnPrefabSource = 
+  | string
+  | {
+  path: string;
+  type?: string;
+}
+  | PrefabAsset;
+```
+
+Defined in: [prefab/spawnPrefab.ts:106](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L106)

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

@@ -0,0 +1,43 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / SubtreeSnapshot
+
+# Type Alias: SubtreeSnapshot
+
+```ts
+type SubtreeSnapshot = {
+  entities: number[];
+  components: {
+     component: string;
+     entries: {
+        entityId: number;
+        value: unknown;
+     }[];
+  }[];
+};
+```
+
+Defined in: [prefab/snapshotIdUtils.ts:17](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L17)
+
+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, …}}`)
+  - `ScriptObjectComponent.data` EntityInput/ComponentInput (same shapes)
+  - `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.
+
+## Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="entities"></a> `entities` | `number`[] | [prefab/snapshotIdUtils.ts:18](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L18) |
+| <a id="components"></a> `components` | \{ `component`: `string`; `entries`: \{ `entityId`: `number`; `value`: `unknown`; \}[]; \}[] | [prefab/snapshotIdUtils.ts:19](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L19) |

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

@@ -0,0 +1,19 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / ADDED\_NODE\_MARKER\_COMPONENT
+
+# Variable: ADDED\_NODE\_MARKER\_COMPONENT
+
+```ts
+const ADDED_NODE_MARKER_COMPONENT: "+node" = "+node";
+```
+
+Defined in: [prefab/nodeKeys.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L31)
+
+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.

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

@@ -10,4 +10,4 @@
 const HYDRATABLE_ENTITY_KINDS: Set<EcsEntityKind>;
 ```
 
-Defined in: [hydration/types.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/f4080487315dc2ea88332b3160fc071e7828b385/core/hydration/types.ts#L59)
+Defined in: [hydration/types.ts:85](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/types.ts#L85)