@relu-interactives/spatial-ecs 0.5.3 → 0.9.0

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

@@ -0,0 +1,28 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / createXRRigComponent
+
+# Function: createXRRigComponent()
+
+```ts
+function createXRRigComponent(
+   world, 
+   entityId, ...
+   args): XRRigComponent;
+```
+
+Defined in: [factories/components/XRRigFactory.ts:4](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/factories/components/XRRigFactory.ts#L4)
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `world` | [`World`](../classes/World.md) |
+| `entityId` | `number` |
+| ...`args` | \[[`XRRigOptions`](../../components/type-aliases/XRRigOptions.md)\] |
+
+## Returns
+
+[`XRRigComponent`](../../components/classes/XRRigComponent.md)

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

@@ -10,7 +10,7 @@
 function decanonicalizeComponentValue(value, nodeToId): unknown;
 ```
 
-Defined in: [prefab/overrides.ts:256](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L256)
+Defined in: [prefab/overrides.ts:256](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L256)
 
 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

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

@@ -13,7 +13,7 @@ function despawnPrefab(
    dispose?): number;
 ```
 
-Defined in: [prefab/spawnPrefab.ts:201](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L201)
+Defined in: [prefab/spawnPrefab.ts:201](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/spawnPrefab.ts#L201)
 
 Delete a spawned prefab instance: the root entity plus every descendant
 (children first). Returns the number of entities removed. `dispose`

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

@@ -13,7 +13,7 @@ function encodeOverride(
    path): string;
 ```
 
-Defined in: [prefab/overrides.ts:277](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L277)
+Defined in: [prefab/overrides.ts:277](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L277)
 
 ## Parameters
 

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

@@ -0,0 +1,28 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / estimateHandScale
+
+# Function: estimateHandScale()
+
+```ts
+function estimateHandScale(joints): number;
+```
+
+Defined in: [xr/handPose.ts:244](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/handPose.ts#L244)
+
+Characteristic hand size in metres.
+
+Every distance threshold in this module is a multiple of this, which is what
+lets one authored pose match hands of any size.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `joints` | [`XrHandJoints`](../type-aliases/XrHandJoints.md) |
+
+## Returns
+
+`number`

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

@@ -10,7 +10,7 @@
 function findSnapshotRootEntityIds(snapshot): number[];
 ```
 
-Defined in: [prefab/overrides.ts:73](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L73)
+Defined in: [prefab/overrides.ts:73](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L73)
 
 Entity ids of entities whose ParentId is null or absent.
 

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

@@ -10,7 +10,7 @@
 function findTopLevelNestedRegions(snapshot): NestedRegion[];
 ```
 
-Defined in: [prefab/nodeKeys.ts:207](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/nodeKeys.ts#L207)
+Defined in: [prefab/nodeKeys.ts:207](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/nodeKeys.ts#L207)
 
 TOP-LEVEL-RELATIVE nested instance regions of a document: instance roots
 that are not the scope root and not themselves inside another region.

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

@@ -0,0 +1,31 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / getHandPosePreset
+
+# Function: getHandPosePreset()
+
+```ts
+function getHandPosePreset(id): 
+  | XrHandPoseDefinition
+  | null;
+```
+
+Defined in: [xr/handPosePresets.ts:173](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/handPosePresets.ts#L173)
+
+A deep copy of a preset.
+
+Returned by value because scenes edit their poses: handing out the shared
+object would let one scene's tweak leak into every other pose in the app.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `id` | `string` |
+
+## Returns
+
+  \| [`XrHandPoseDefinition`](../type-aliases/XrHandPoseDefinition.md)
+  \| `null`

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

@@ -10,7 +10,7 @@
 function groupOverridePaths(overrides): Map<string, Map<string, Set<string>>>;
 ```
 
-Defined in: [prefab/overrides.ts:302](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L302)
+Defined in: [prefab/overrides.ts:302](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L302)
 
 nodeId → componentName → set of overridden paths.
 

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

@@ -0,0 +1,42 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / handPoseFromCurls
+
+# Function: handPoseFromCurls()
+
+```ts
+function handPoseFromCurls(
+   id, 
+   name, 
+   curls, 
+   options?): XrHandPoseDefinition;
+```
+
+Defined in: [xr/handPosePresets.ts:209](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/handPosePresets.ts#L209)
+
+Build a pose from five curl values — the shape the editor's sliders and the
+AI tools produce.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `id` | `string` | - |
+| `name` | `string` | - |
+| `curls` | `Record`\<[`XrFinger`](../type-aliases/XrFinger.md), `number`\> | - |
+| `options?` | \{ `tolerance?`: `number`; `pinch?`: \{ `finger`: `"index"` \| `"middle"` \| `"ring"` \| `"pinky"`; `target`: `number`; `tolerance`: `number`; \}; `orientation?`: [`XrHandPoseOrientation`](../type-aliases/XrHandPoseOrientation.md); `hand?`: `"left"` \| `"right"`; `directions?`: `Partial`\<`Record`\<[`XrFinger`](../type-aliases/XrFinger.md), [`XrHandPoseDirection`](../type-aliases/XrHandPoseDirection.md)[]\>\>; `directionToleranceDegrees?`: `number`; \} | - |
+| `options.tolerance?` | `number` | - |
+| `options.pinch?` | \{ `finger`: `"index"` \| `"middle"` \| `"ring"` \| `"pinky"`; `target`: `number`; `tolerance`: `number`; \} | - |
+| `options.pinch.finger?` | `"index"` \| `"middle"` \| `"ring"` \| `"pinky"` | - |
+| `options.pinch.target?` | `number` | 1 = touching. |
+| `options.pinch.tolerance?` | `number` | - |
+| `options.orientation?` | [`XrHandPoseOrientation`](../type-aliases/XrHandPoseOrientation.md) | - |
+| `options.hand?` | `"left"` \| `"right"` | - |
+| `options.directions?` | `Partial`\<`Record`\<[`XrFinger`](../type-aliases/XrFinger.md), [`XrHandPoseDirection`](../type-aliases/XrHandPoseDirection.md)[]\>\> | Per-finger accepted directions; empty lists leave a finger free. |
+| `options.directionToleranceDegrees?` | `number` | - |
+
+## Returns
+
+[`XrHandPoseDefinition`](../type-aliases/XrHandPoseDefinition.md)

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

@@ -13,7 +13,7 @@ function hydrateWorldFromSnapshot(
    objectManagementSystem): number;
 ```
 
-Defined in: [hydration/hydrateWorld.ts:318](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/hydrateWorld.ts#L318)
+Defined in: [hydration/hydrateWorld.ts:322](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/hydration/hydrateWorld.ts#L322)
 
 ## Parameters
 

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

@@ -14,7 +14,7 @@ function hydrateWorldFromSnapshotDetailed(
    options?): HydrateWorldFromSnapshotResult;
 ```
 
-Defined in: [hydration/hydrateWorld.ts:221](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/hydrateWorld.ts#L221)
+Defined in: [hydration/hydrateWorld.ts:221](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/hydration/hydrateWorld.ts#L221)
 
 ## Parameters
 

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

@@ -10,7 +10,7 @@
 function indexSnapshotByEntity(snapshot): Map<number, Map<string, unknown>>;
 ```
 
-Defined in: [prefab/overrides.ts:109](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L109)
+Defined in: [prefab/overrides.ts:109](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L109)
 
 Invert the columnar snapshot into entityId → (componentName → value).
 

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

@@ -13,7 +13,7 @@ function instantiateSubtree(
    snapshot): InstantiateSubtreeResult;
 ```
 
-Defined in: [prefab/instantiateSubtree.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/instantiateSubtree.ts#L33)
+Defined in: [prefab/instantiateSubtree.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/instantiateSubtree.ts#L33)
 
 Hydrate a self-contained subtree snapshot (a prefab file's `snapshot`)
 into a LIVE world: fresh entity ids, internal references remapped, no

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

@@ -10,7 +10,7 @@
 function loadPrefab(url): Promise<PrefabAsset>;
 ```
 
-Defined in: [prefab/spawnPrefab.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/spawnPrefab.ts#L61)
+Defined in: [prefab/spawnPrefab.ts:61](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/spawnPrefab.ts#L61)
 
 Fetch + parse (and cache) a `.prefab` asset. All strings inside the
 snapshot are passed through the registered URL resolver, so asset

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

@@ -10,7 +10,7 @@
 function loadSharedGltf(url, load): Promise<GLTF>;
 ```
 
-Defined in: [utils/modelCache.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/utils/modelCache.ts#L39)
+Defined in: [utils/modelCache.ts:39](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/utils/modelCache.ts#L39)
 
 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

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

@@ -0,0 +1,34 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / matchHandPose
+
+# Function: matchHandPose()
+
+```ts
+function matchHandPose(
+   shape, 
+   definition, 
+   context?): XrHandPoseMatch;
+```
+
+Defined in: [xr/handPose.ts:650](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/handPose.ts#L650)
+
+Score a live hand against a pose.
+
+Confidence is the MINIMUM across constraints, not the average — a soft AND.
+Averaging lets three perfect fingers outvote one badly wrong one, which is how
+a fist ends up firing as a thumbs-up.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `shape` | [`XrHandShape`](../type-aliases/XrHandShape.md) |
+| `definition` | [`XrHandPoseDefinition`](../type-aliases/XrHandPoseDefinition.md) |
+| `context?` | [`XrHandPoseContext`](../type-aliases/XrHandPoseContext.md) |
+
+## Returns
+
+[`XrHandPoseMatch`](../type-aliases/XrHandPoseMatch.md)

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

@@ -13,7 +13,7 @@ function mergeComponentValue(
    overridePaths): unknown;
 ```
 
-Defined in: [prefab/overrides.ts:542](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L542)
+Defined in: [prefab/overrides.ts:542](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L542)
 
 Merge a component's NEW canonical file value with an instance's canonical
 value, preserving the instance side at every overridden path. An empty

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

@@ -16,7 +16,7 @@ function parseOverride(encoded):
   | null;
 ```
 
-Defined in: [prefab/overrides.ts:283](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/overrides.ts#L283)
+Defined in: [prefab/overrides.ts:283](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/overrides.ts#L283)
 
 ## Parameters
 

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

@@ -10,7 +10,7 @@
 function parsePrefabAsset(json): PrefabAsset | null;
 ```
 
-Defined in: [prefab/types.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L32)
+Defined in: [prefab/types.ts:32](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/types.ts#L32)
 
 Validate untrusted JSON into a `PrefabAsset`, or null when malformed.
 

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

@@ -10,7 +10,7 @@
 function prefabFileVersionFor(snapshot): number;
 ```
 
-Defined in: [prefab/types.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/types.ts#L9)
+Defined in: [prefab/types.ts:9](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/types.ts#L9)
 
 File version to write for a given snapshot: 2 iff it nests instances.
 

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

@@ -0,0 +1,30 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / readXrCapabilities
+
+# Function: readXrCapabilities()
+
+```ts
+function readXrCapabilities(session, mode?): XrCapabilities;
+```
+
+Defined in: [xr/types.ts:124](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/types.ts#L124)
+
+Read granted features off a live session.
+
+`enabledFeatures` is optional in the spec and missing on some UAs; when it is
+absent we report nothing as granted rather than optimistically assuming
+support, so callers degrade instead of calling an API that will throw.
+
+## Parameters
+
+| Parameter | Type | Default value |
+| ------ | ------ | ------ |
+| `session` | `XRSession` \| `null` | `undefined` |
+| `mode` | `"immersive-vr"` \| `"immersive-ar"` \| `"inline"` | `"immersive-vr"` |
+
+## Returns
+
+[`XrCapabilities`](../type-aliases/XrCapabilities.md)

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

@@ -10,7 +10,7 @@
 function registerDefaultComponentFactories(objectManagementSystem): void;
 ```
 
-Defined in: [factories/registerDefaultComponentFactories.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/factories/registerDefaultComponentFactories.ts#L31)
+Defined in: [factories/registerDefaultComponentFactories.ts:43](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/factories/registerDefaultComponentFactories.ts#L43)
 
 ## Parameters
 

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

@@ -10,7 +10,7 @@
 function registerDefaultFactories(objectManagementSystem): void;
 ```
 
-Defined in: [factories/registerDefaultFactories.ts:25](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/factories/registerDefaultFactories.ts#L25)
+Defined in: [factories/registerDefaultFactories.ts:33](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/factories/registerDefaultFactories.ts#L33)
 
 ## Parameters
 

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

@@ -16,7 +16,7 @@ function remapSnapshotEntityIds(
 };
 ```
 
-Defined in: [prefab/snapshotIdUtils.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L108)
+Defined in: [prefab/snapshotIdUtils.ts:108](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/snapshotIdUtils.ts#L108)
 
 Return a deep-cloned snapshot with every entity id (entity list, entry
 keys, and all id-bearing component fields) remapped through `idMap`.
@@ -42,5 +42,5 @@ reported in `warnings` (with ids in the INPUT snapshot's id space).
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `snapshot` | [`SubtreeSnapshot`](../type-aliases/SubtreeSnapshot.md) | [prefab/snapshotIdUtils.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L112) |
-| `warnings` | [`ExternalRefWarning`](../type-aliases/ExternalRefWarning.md)[] | [prefab/snapshotIdUtils.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/snapshotIdUtils.ts#L112) |
+| `snapshot` | [`SubtreeSnapshot`](../type-aliases/SubtreeSnapshot.md) | [prefab/snapshotIdUtils.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/snapshotIdUtils.ts#L112) |
+| `warnings` | [`ExternalRefWarning`](../type-aliases/ExternalRefWarning.md)[] | [prefab/snapshotIdUtils.ts:112](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/snapshotIdUtils.ts#L112) |

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

@@ -10,7 +10,7 @@
 function resolveDracoDecoderPath(): string;
 ```
 
-Defined in: [utils/dracoDecoderPath.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/utils/dracoDecoderPath.ts#L23)
+Defined in: [utils/dracoDecoderPath.ts:23](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/utils/dracoDecoderPath.ts#L23)
 
 ## Returns
 

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

@@ -16,7 +16,7 @@ function restoreComponentState(
    values): void;
 ```
 
-Defined in: [hydration/restoreComponentState.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/restoreComponentState.ts#L59)
+Defined in: [hydration/restoreComponentState.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/hydration/restoreComponentState.ts#L59)
 
 ## Parameters
 

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

@@ -17,7 +17,7 @@ function restorePostCreateComponents(
    idMap): void;
 ```
 
-Defined in: [hydration/postCreateComponents.ts:45](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/hydration/postCreateComponents.ts#L45)
+Defined in: [hydration/postCreateComponents.ts:59](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/hydration/postCreateComponents.ts#L59)
 
 ## Parameters
 

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

@@ -0,0 +1,40 @@
+[**@relu-interactives/spatial-ecs**](../../index.md)
+
+***
+
+[@relu-interactives/spatial-ecs](../../index.md) / [index](../index.md) / sampleTeleportArc
+
+# Function: sampleTeleportArc()
+
+```ts
+function sampleTeleportArc(
+   origin, 
+   direction, 
+   out?, 
+   options?): Vector3[];
+```
+
+Defined in: [xr/teleportArc.ts:31](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/xr/teleportArc.ts#L31)
+
+Sample a ballistic curve starting at `origin` heading along `direction`.
+
+Returns points in world space, oldest first. The caller raycasts consecutive
+pairs to find where the arc meets a teleport surface — sampling and
+intersection are kept separate so this stays testable.
+
+## Parameters
+
+| Parameter | Type | Default value |
+| ------ | ------ | ------ |
+| `origin` | `Vector3` | `undefined` |
+| `direction` | `Vector3` | `undefined` |
+| `out` | `Vector3`[] | `[]` |
+| `options?` | \{ `speed?`: `number`; `gravity?`: `number`; `steps?`: `number`; `maxTime?`: `number`; \} | `undefined` |
+| `options.speed?` | `number` | `undefined` |
+| `options.gravity?` | `number` | `undefined` |
+| `options.steps?` | `number` | `undefined` |
+| `options.maxTime?` | `number` | `undefined` |
+
+## Returns
+
+`Vector3`[]

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

@@ -13,7 +13,7 @@ function serializeEntitySubtree(
    options?): SerializeEntitySubtreeResult;
 ```
 
-Defined in: [prefab/serializeEntitySubtree.ts:42](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/020795472520adb990c488982ca8572cbf8580db/core/prefab/serializeEntitySubtree.ts#L42)
+Defined in: [prefab/serializeEntitySubtree.ts:42](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/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

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

@@ -10,7 +10,7 @@
 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)
+Defined in: [utils/dracoDecoderPath.ts:15](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/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

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

@@ -10,7 +10,7 @@
 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)
+Defined in: [prefab/spawnPrefab.ts:21](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/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

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

@@ -13,7 +13,7 @@ function spawnPrefab(
 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)
+Defined in: [prefab/spawnPrefab.ts:144](https://github.com/Relu-Interactives/relu-spatial-ecs-engine/blob/72f129a02ec4b2f93ff337d16361a731efd8cc5d/core/prefab/spawnPrefab.ts#L144)
 
 Instantiate a prefab into a live world at runtime.