@relu-interactives/spatial-ecs 0.5.3 → 0.8.0

package/dist/{XRHandPose-CU3vNFuS.d.ts → XRHandPose-G0Dl-F0w.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-V_mv07le.js';
+import { d as Component, a3 as AudioBus, $ as EcsEntityKind, ae as EcsEntityEditorKind, M as EntityId } from './System-DPMAW30g.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.js';
 
@@ -256,6 +256,7 @@ declare const DEFAULT_AUDIO_OPTIONS: {
     refDistance: number;
     distanceModel: string;
     rolloffFactor: number;
+    bus: AudioBus;
 };
 /**
  * Plays an audio clip from `path`. Supports both global stereo (`positional:
@@ -281,6 +282,7 @@ declare class AudioComponent extends Component {
      * | `refDistance` | `1` | Distance at which volume is unattenuated (positional only). |
      * | `distanceModel` | `"inverse"` | WebAudio distance model (`linear`, `inverse`, `exponential`). |
      * | `rolloffFactor` | `1` | How quickly volume falls off past `refDistance`. |
+     * | `bus` | `"sfx"` | The mixer group it plays through: `sfx`, `voice` or `music`. Music dips while a voice plays. |
      */
     options: typeof DEFAULT_AUDIO_OPTIONS;
     /** Live three.js object hosting the audio (a parented `Audio`/`PositionalAudio`). `null` until built. */
@@ -761,6 +763,32 @@ declare class ImageTargetAnchor extends Component {
     constructor(options?: ImageTargetAnchorOptions);
 }
 
+/**
+ * Optional shadow tuning for a shadow-casting light (directional, spot,
+ * point). Only the fields present are applied; a missing field keeps three's
+ * default, and a light without a `shadow` block is never touched.
+ */
+type LightShadowState = {
+    /** Shadow map resolution in texels (square). three's default is `512`. Clamped to `[16, 8192]`. */
+    mapSize?: number;
+    /** Depth bias to fight shadow acne. Small negatives such as `-0.0005` are typical. */
+    bias?: number;
+    /** Bias along the surface normal; `0.02`-`0.05` removes acne on large flat surfaces. */
+    normalBias?: number;
+    /** Blur radius of the shadow edge (PCF shadow maps). */
+    radius?: number;
+    /**
+     * Half-extent, in world units, of a DIRECTIONAL light's orthographic shadow
+     * camera (`left = bottom = -cameraSize`, `right = top = cameraSize`).
+     * three's default is `5`, which only covers a 10 m square. Ignored for spot
+     * and point lights.
+     */
+    cameraSize?: number;
+    /** Near plane of the shadow camera. */
+    near?: number;
+    /** Far plane of the shadow camera. Spot lights with a `distance` use that instead. */
+    far?: number;
+};
 /** Authoring state for {@link LightComponent}. Common fields apply to every light kind; the optional fields are only meaningful for specific kinds. */
 type LightValueState = {
     /** Light color as `#rrggbb` hex string. */
@@ -783,6 +811,8 @@ type LightValueState = {
     width?: number;
     /** Rectangle height in world units. (RectAreaLight) */
     height?: number;
+    /** Optional shadow tuning. Absent = three's shadow defaults. (DirectionalLight, SpotLight, PointLight) */
+    shadow?: LightShadowState;
 };
 /**
  * Light source attached to an entity. `type` selects the underlying three.js
@@ -922,11 +952,23 @@ declare class MeshComponent extends Component {
     constructor(mesh: THREE.Object3D);
 }
 
+/** Load progress of a {@link ModelComponent}'s asset. */
+type ModelLoadState = "loading" | "loaded" | "error";
+/** Message used when a model entity has no asset path to load. */
+declare const MODEL_NO_PATH_MESSAGE = "No model path set.";
+/**
+ * Write a model's load state as NON-ENUMERABLE own properties, so it never
+ * enters snapshots, undo history or saved projects. Always via defineProperty
+ * (the pattern `setPhysicsLiveRef` uses): plain assignment on a
+ * history-restored clone would create an ENUMERABLE property instead.
+ */
+declare function setModelLoadState(component: ModelComponent, state: ModelLoadState, error?: string): void;
 /**
  * References a GLTF/GLB asset loaded from `path`. The model loading system
  * resolves the asset asynchronously and populates {@link ModelComponent.object}
  * once available; loading is deferred-tolerant so the entity exists before
- * the model finishes loading.
+ * the model finishes loading. {@link ModelComponent.loadState} reports
+ * progress (`"loading"` → `"loaded"` or `"error"`).
  *
  * @category Components
  */
@@ -935,6 +977,15 @@ declare class ModelComponent extends Component {
     path: string;
     /** Loaded model object, populated asynchronously by the model loader. `null` until loaded. */
     object: THREE.Object3D | null;
+    /**
+     * `"loading"` while the asset is being fetched and parsed, `"loaded"` once
+     * it is attached to the entity, `"error"` when it failed (see
+     * {@link loadError}). A model with an empty `path` reports `"error"`.
+     * Runtime-only: never saved.
+     */
+    loadState: ModelLoadState;
+    /** Why the load failed, when {@link loadState} is `"error"`. Runtime-only. */
+    loadError?: string;
     constructor(path: string);
 }
 
@@ -1573,6 +1624,45 @@ declare class XRAnchorComponent extends Component {
     constructor(options?: XRAnchorOptions);
 }
 
+/** Optional initializer for {@link BoneAttachmentComponent}. */
+type BoneAttachmentOptions = {
+    /** The bone's node name in the parent's model (as three.js names it). */
+    bone?: string;
+    /** The bone's humanoid name (`rightHand`, `head` …), used when the node name isn't found (another rig). */
+    humanoid?: string | null;
+    /** Cancel the bone's world scale so offsets are in metres on any rig. Defaults to `true`. */
+    compensateScale?: boolean;
+    /** Turn the attachment off without removing it. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Fixes an entity to a bone of its PARENT's model — a sword in a hand, a hat
+ * on a head, a backpack on the chest — so it moves with every animation.
+ *
+ * The entity's `ParentId` stays the character; this names the bone. The
+ * `ObjectManagementSystem` then parents the entity's object under that bone
+ * (through a small socket that cancels the rig's scale), and the entity's
+ * Transform becomes its offset FROM the bone: position in metres, rotation
+ * relative to the bone. Until the model has loaded, or when the bone isn't
+ * found, the entity sits under the character as an ordinary child.
+ *
+ * Attach and detach with `ObjectManagementSystem.attachToBone` /
+ * `detachFromBone`, which can keep the entity where it is in the world.
+ *
+ * @category Components
+ */
+declare class BoneAttachmentComponent extends Component {
+    /** The bone's node name in the parent's model. */
+    bone: string;
+    /** The bone's humanoid name, the fallback when the node name isn't found. */
+    humanoid: string | null;
+    /** Cancel the bone's world scale (offsets in metres on a centimetre rig). */
+    compensateScale: boolean;
+    /** Whether the entity follows the bone. Off: an ordinary child of the character. */
+    enabled: boolean;
+    constructor(options?: BoneAttachmentOptions);
+}
+
 /** How a panel orients itself while the experience runs. */
 type UiFollowMode = "world" | "billboard";
 /** Optional initializer for {@link UIPanelComponent}. */
@@ -1953,4 +2043,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, UIButtonComponent as a5, type UIButtonOptions as a6, UIPanelComponent as a7, type UIPanelOptions as a8, UISliderComponent as a9, type XrGrabGesture as aA, type XrGrabHands as aB, type XrGrabReach as aC, type XrHandPoseEntry as aD, type XrHandPreset as aE, type XrInteractorSide as aF, type XrInteractorType as aG, type XrLocomotionMode as aH, type XrTrackingOrigin as aI, type XrTwoHandRotation as aJ, createAttachPoint as aK, createHandPoseEntry as aL, defaultMaterialValue as aM, handPoseDefinitionFor as aN, normalizePhysicsState as aO, setPhysicsLiveRef as aP, type AnimationStateCallbacks as aQ, AnimationStateMachine as aR, AnimationStateManager as aS, type StateMachine as aT, type UISliderOptions as aa, UITextComponent as ab, type UITextOptions as ac, UIToggleComponent as ad, type UIToggleOptions as ae, type UiFollowMode as af, type UiTextAlign as ag, type UiTextVAlign as ah, VRTeleportAreaComponent as ai, type VRTeleportAreaOptions as aj, VideoComponent as ak, type VrTeleportShape as al, XRAnchorComponent as am, type XRAnchorOptions as an, XRHandPoseComponent as ao, type XRHandPoseOptions as ap, XRInteractableComponent as aq, type XRInteractableOptions as ar, XRInteractorComponent as as, type XRInteractorOptions as at, XRInteractorSideComponent as au, XRRigComponent as av, type XRRigOptions as aw, type XrAttachPoint as ax, type XrDistanceGrabBehavior as ay, type XrEnvironmentPhysics as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { ScriptComponent as $, AnimationComponent as A, BoneAttachmentComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type LightValueState as F, MaterialComponent as G, type MaterialTypeValue as H, ImageComponent as I, type MaterialValueState as J, MeshComponent as K, LightComponent as L, MODEL_NO_PATH_MESSAGE as M, MeshGeometryComponent as N, type MeshGeometryParameters as O, type MeshGeometryParametersByKind as P, ModelComponent as Q, type ModelLoadState as R, Name as S, Object3DRef as T, PhysicsComponent as U, type PhysicsState as V, type PlaneMeshParameters as W, type RadiusHeightMeshParameters as X, type RadiusMeshParameters as Y, type RigidbodyState as Z, type RigidbodyType as _, type AnimationComponentOptions as a, type ScriptEntry as a0, ScriptObjectComponent as a1, type ScriptObjectComponentInput as a2, type ScriptObjectRuntimeState as a3, Selectable as a4, SelectionTransformState as a5, SpriteComponent as a6, type TextureFilteringValue as a7, type TransformModeValue as a8, type TransformSpaceValue as a9, XRRigComponent as aA, type XRRigOptions as aB, type XrAttachPoint as aC, type XrDistanceGrabBehavior as aD, type XrEnvironmentPhysics as aE, type XrGrabGesture as aF, type XrGrabHands as aG, type XrGrabReach as aH, type XrHandPoseEntry as aI, type XrHandPreset as aJ, type XrInteractorSide as aK, type XrInteractorType as aL, type XrLocomotionMode as aM, type XrTrackingOrigin as aN, type XrTwoHandRotation as aO, createAttachPoint as aP, createHandPoseEntry as aQ, defaultMaterialValue as aR, handPoseDefinitionFor as aS, normalizePhysicsState as aT, setModelLoadState as aU, setPhysicsLiveRef as aV, type AnimationStateCallbacks as aW, AnimationStateMachine as aX, AnimationStateManager as aY, type StateMachine as aZ, UIButtonComponent as aa, type UIButtonOptions as ab, UIPanelComponent as ac, type UIPanelOptions as ad, UISliderComponent as ae, type UISliderOptions as af, UITextComponent as ag, type UITextOptions as ah, UIToggleComponent as ai, type UIToggleOptions as aj, type UiFollowMode as ak, type UiTextAlign as al, type UiTextVAlign as am, VRTeleportAreaComponent as an, type VRTeleportAreaOptions as ao, VideoComponent as ap, type VrTeleportShape as aq, XRAnchorComponent as ar, type XRAnchorOptions as as, XRHandPoseComponent as at, type XRHandPoseOptions as au, XRInteractableComponent as av, type XRInteractableOptions as aw, XRInteractorComponent as ax, type XRInteractorOptions as ay, XRInteractorSideComponent as az, AudioComponent as b, type BoneAttachmentOptions as c, type CameraComponentOptions as d, type CameraProjection as e, type CameraRuntimeType as f, type ColliderShape as g, type ColliderState as h, type CubeMeshParameters as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSE_CURLS as n, DEFAULT_POSE_DIRECTIONS as o, DEFAULT_RIGIDBODY_STATE as p, EntityType as q, ImageTarget as r, ImageTargetAnchor as s, type ImageTargetAnchorOptions as t, type ImageTargetReference as u, InstanceSlotComponent as v, type InstanceTransform as w, InstancedMeshComponent as x, type InstancedMeshKind as y, type LightShadowState as z };

package/dist/{XRHandPose-CQTLGxFC.d.cts → XRHandPose-VQMT1WXj.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-V_mv07le.cjs';
+import { C as Component, _ as AudioBus, U as EcsEntityKind, aa as EcsEntityEditorKind, G as EntityId } from './System-8D-XBDKZ.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.cjs';
 
@@ -256,6 +256,7 @@ declare const DEFAULT_AUDIO_OPTIONS: {
     refDistance: number;
     distanceModel: string;
     rolloffFactor: number;
+    bus: AudioBus;
 };
 /**
  * Plays an audio clip from `path`. Supports both global stereo (`positional:
@@ -281,6 +282,7 @@ declare class AudioComponent extends Component {
      * | `refDistance` | `1` | Distance at which volume is unattenuated (positional only). |
      * | `distanceModel` | `"inverse"` | WebAudio distance model (`linear`, `inverse`, `exponential`). |
      * | `rolloffFactor` | `1` | How quickly volume falls off past `refDistance`. |
+     * | `bus` | `"sfx"` | The mixer group it plays through: `sfx`, `voice` or `music`. Music dips while a voice plays. |
      */
     options: typeof DEFAULT_AUDIO_OPTIONS;
     /** Live three.js object hosting the audio (a parented `Audio`/`PositionalAudio`). `null` until built. */
@@ -761,6 +763,32 @@ declare class ImageTargetAnchor extends Component {
     constructor(options?: ImageTargetAnchorOptions);
 }
 
+/**
+ * Optional shadow tuning for a shadow-casting light (directional, spot,
+ * point). Only the fields present are applied; a missing field keeps three's
+ * default, and a light without a `shadow` block is never touched.
+ */
+type LightShadowState = {
+    /** Shadow map resolution in texels (square). three's default is `512`. Clamped to `[16, 8192]`. */
+    mapSize?: number;
+    /** Depth bias to fight shadow acne. Small negatives such as `-0.0005` are typical. */
+    bias?: number;
+    /** Bias along the surface normal; `0.02`-`0.05` removes acne on large flat surfaces. */
+    normalBias?: number;
+    /** Blur radius of the shadow edge (PCF shadow maps). */
+    radius?: number;
+    /**
+     * Half-extent, in world units, of a DIRECTIONAL light's orthographic shadow
+     * camera (`left = bottom = -cameraSize`, `right = top = cameraSize`).
+     * three's default is `5`, which only covers a 10 m square. Ignored for spot
+     * and point lights.
+     */
+    cameraSize?: number;
+    /** Near plane of the shadow camera. */
+    near?: number;
+    /** Far plane of the shadow camera. Spot lights with a `distance` use that instead. */
+    far?: number;
+};
 /** Authoring state for {@link LightComponent}. Common fields apply to every light kind; the optional fields are only meaningful for specific kinds. */
 type LightValueState = {
     /** Light color as `#rrggbb` hex string. */
@@ -783,6 +811,8 @@ type LightValueState = {
     width?: number;
     /** Rectangle height in world units. (RectAreaLight) */
     height?: number;
+    /** Optional shadow tuning. Absent = three's shadow defaults. (DirectionalLight, SpotLight, PointLight) */
+    shadow?: LightShadowState;
 };
 /**
  * Light source attached to an entity. `type` selects the underlying three.js
@@ -922,11 +952,23 @@ declare class MeshComponent extends Component {
     constructor(mesh: THREE.Object3D);
 }
 
+/** Load progress of a {@link ModelComponent}'s asset. */
+type ModelLoadState = "loading" | "loaded" | "error";
+/** Message used when a model entity has no asset path to load. */
+declare const MODEL_NO_PATH_MESSAGE = "No model path set.";
+/**
+ * Write a model's load state as NON-ENUMERABLE own properties, so it never
+ * enters snapshots, undo history or saved projects. Always via defineProperty
+ * (the pattern `setPhysicsLiveRef` uses): plain assignment on a
+ * history-restored clone would create an ENUMERABLE property instead.
+ */
+declare function setModelLoadState(component: ModelComponent, state: ModelLoadState, error?: string): void;
 /**
  * References a GLTF/GLB asset loaded from `path`. The model loading system
  * resolves the asset asynchronously and populates {@link ModelComponent.object}
  * once available; loading is deferred-tolerant so the entity exists before
- * the model finishes loading.
+ * the model finishes loading. {@link ModelComponent.loadState} reports
+ * progress (`"loading"` → `"loaded"` or `"error"`).
  *
  * @category Components
  */
@@ -935,6 +977,15 @@ declare class ModelComponent extends Component {
     path: string;
     /** Loaded model object, populated asynchronously by the model loader. `null` until loaded. */
     object: THREE.Object3D | null;
+    /**
+     * `"loading"` while the asset is being fetched and parsed, `"loaded"` once
+     * it is attached to the entity, `"error"` when it failed (see
+     * {@link loadError}). A model with an empty `path` reports `"error"`.
+     * Runtime-only: never saved.
+     */
+    loadState: ModelLoadState;
+    /** Why the load failed, when {@link loadState} is `"error"`. Runtime-only. */
+    loadError?: string;
     constructor(path: string);
 }
 
@@ -1573,6 +1624,45 @@ declare class XRAnchorComponent extends Component {
     constructor(options?: XRAnchorOptions);
 }
 
+/** Optional initializer for {@link BoneAttachmentComponent}. */
+type BoneAttachmentOptions = {
+    /** The bone's node name in the parent's model (as three.js names it). */
+    bone?: string;
+    /** The bone's humanoid name (`rightHand`, `head` …), used when the node name isn't found (another rig). */
+    humanoid?: string | null;
+    /** Cancel the bone's world scale so offsets are in metres on any rig. Defaults to `true`. */
+    compensateScale?: boolean;
+    /** Turn the attachment off without removing it. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Fixes an entity to a bone of its PARENT's model — a sword in a hand, a hat
+ * on a head, a backpack on the chest — so it moves with every animation.
+ *
+ * The entity's `ParentId` stays the character; this names the bone. The
+ * `ObjectManagementSystem` then parents the entity's object under that bone
+ * (through a small socket that cancels the rig's scale), and the entity's
+ * Transform becomes its offset FROM the bone: position in metres, rotation
+ * relative to the bone. Until the model has loaded, or when the bone isn't
+ * found, the entity sits under the character as an ordinary child.
+ *
+ * Attach and detach with `ObjectManagementSystem.attachToBone` /
+ * `detachFromBone`, which can keep the entity where it is in the world.
+ *
+ * @category Components
+ */
+declare class BoneAttachmentComponent extends Component {
+    /** The bone's node name in the parent's model. */
+    bone: string;
+    /** The bone's humanoid name, the fallback when the node name isn't found. */
+    humanoid: string | null;
+    /** Cancel the bone's world scale (offsets in metres on a centimetre rig). */
+    compensateScale: boolean;
+    /** Whether the entity follows the bone. Off: an ordinary child of the character. */
+    enabled: boolean;
+    constructor(options?: BoneAttachmentOptions);
+}
+
 /** How a panel orients itself while the experience runs. */
 type UiFollowMode = "world" | "billboard";
 /** Optional initializer for {@link UIPanelComponent}. */
@@ -1953,4 +2043,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, UIButtonComponent as a5, type UIButtonOptions as a6, UIPanelComponent as a7, type UIPanelOptions as a8, UISliderComponent as a9, type XrGrabGesture as aA, type XrGrabHands as aB, type XrGrabReach as aC, type XrHandPoseEntry as aD, type XrHandPreset as aE, type XrInteractorSide as aF, type XrInteractorType as aG, type XrLocomotionMode as aH, type XrTrackingOrigin as aI, type XrTwoHandRotation as aJ, createAttachPoint as aK, createHandPoseEntry as aL, defaultMaterialValue as aM, handPoseDefinitionFor as aN, normalizePhysicsState as aO, setPhysicsLiveRef as aP, type AnimationStateCallbacks as aQ, AnimationStateMachine as aR, AnimationStateManager as aS, type StateMachine as aT, type UISliderOptions as aa, UITextComponent as ab, type UITextOptions as ac, UIToggleComponent as ad, type UIToggleOptions as ae, type UiFollowMode as af, type UiTextAlign as ag, type UiTextVAlign as ah, VRTeleportAreaComponent as ai, type VRTeleportAreaOptions as aj, VideoComponent as ak, type VrTeleportShape as al, XRAnchorComponent as am, type XRAnchorOptions as an, XRHandPoseComponent as ao, type XRHandPoseOptions as ap, XRInteractableComponent as aq, type XRInteractableOptions as ar, XRInteractorComponent as as, type XRInteractorOptions as at, XRInteractorSideComponent as au, XRRigComponent as av, type XRRigOptions as aw, type XrAttachPoint as ax, type XrDistanceGrabBehavior as ay, type XrEnvironmentPhysics as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { ScriptComponent as $, AnimationComponent as A, BoneAttachmentComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type LightValueState as F, MaterialComponent as G, type MaterialTypeValue as H, ImageComponent as I, type MaterialValueState as J, MeshComponent as K, LightComponent as L, MODEL_NO_PATH_MESSAGE as M, MeshGeometryComponent as N, type MeshGeometryParameters as O, type MeshGeometryParametersByKind as P, ModelComponent as Q, type ModelLoadState as R, Name as S, Object3DRef as T, PhysicsComponent as U, type PhysicsState as V, type PlaneMeshParameters as W, type RadiusHeightMeshParameters as X, type RadiusMeshParameters as Y, type RigidbodyState as Z, type RigidbodyType as _, type AnimationComponentOptions as a, type ScriptEntry as a0, ScriptObjectComponent as a1, type ScriptObjectComponentInput as a2, type ScriptObjectRuntimeState as a3, Selectable as a4, SelectionTransformState as a5, SpriteComponent as a6, type TextureFilteringValue as a7, type TransformModeValue as a8, type TransformSpaceValue as a9, XRRigComponent as aA, type XRRigOptions as aB, type XrAttachPoint as aC, type XrDistanceGrabBehavior as aD, type XrEnvironmentPhysics as aE, type XrGrabGesture as aF, type XrGrabHands as aG, type XrGrabReach as aH, type XrHandPoseEntry as aI, type XrHandPreset as aJ, type XrInteractorSide as aK, type XrInteractorType as aL, type XrLocomotionMode as aM, type XrTrackingOrigin as aN, type XrTwoHandRotation as aO, createAttachPoint as aP, createHandPoseEntry as aQ, defaultMaterialValue as aR, handPoseDefinitionFor as aS, normalizePhysicsState as aT, setModelLoadState as aU, setPhysicsLiveRef as aV, type AnimationStateCallbacks as aW, AnimationStateMachine as aX, AnimationStateManager as aY, type StateMachine as aZ, UIButtonComponent as aa, type UIButtonOptions as ab, UIPanelComponent as ac, type UIPanelOptions as ad, UISliderComponent as ae, type UISliderOptions as af, UITextComponent as ag, type UITextOptions as ah, UIToggleComponent as ai, type UIToggleOptions as aj, type UiFollowMode as ak, type UiTextAlign as al, type UiTextVAlign as am, VRTeleportAreaComponent as an, type VRTeleportAreaOptions as ao, VideoComponent as ap, type VrTeleportShape as aq, XRAnchorComponent as ar, type XRAnchorOptions as as, XRHandPoseComponent as at, type XRHandPoseOptions as au, XRInteractableComponent as av, type XRInteractableOptions as aw, XRInteractorComponent as ax, type XRInteractorOptions as ay, XRInteractorSideComponent as az, AudioComponent as b, type BoneAttachmentOptions as c, type CameraComponentOptions as d, type CameraProjection as e, type CameraRuntimeType as f, type ColliderShape as g, type ColliderState as h, type CubeMeshParameters as i, DEFAULT_INSTANCED_MESH_PARAMETERS as j, DEFAULT_INSTANCE_TRANSFORM as k, DEFAULT_MESH_GEOMETRY_PARAMETERS as l, DEFAULT_PHYSICS_STATE as m, DEFAULT_POSE_CURLS as n, DEFAULT_POSE_DIRECTIONS as o, DEFAULT_RIGIDBODY_STATE as p, EntityType as q, ImageTarget as r, ImageTargetAnchor as s, type ImageTargetAnchorOptions as t, type ImageTargetReference as u, InstanceSlotComponent as v, type InstanceTransform as w, InstancedMeshComponent as x, type InstancedMeshKind as y, type LightShadowState as z };

package/dist/animation/index.cjs

@@ -0,0 +1,252 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// core/animation/humanoid.ts
+var REQUIRED_HUMANOID_BONES = [
+  "hips",
+  "spine",
+  "head",
+  "leftUpperArm",
+  "leftLowerArm",
+  "leftHand",
+  "rightUpperArm",
+  "rightLowerArm",
+  "rightHand",
+  "leftUpperLeg",
+  "leftLowerLeg",
+  "leftFoot",
+  "rightUpperLeg",
+  "rightLowerLeg",
+  "rightFoot"
+];
+var qmul = /* @__PURE__ */ __name((a, b) => [
+  a[3] * b[0] + a[0] * b[3] + a[1] * b[2] - a[2] * b[1],
+  a[3] * b[1] - a[0] * b[2] + a[1] * b[3] + a[2] * b[0],
+  a[3] * b[2] + a[0] * b[1] - a[1] * b[0] + a[2] * b[3],
+  a[3] * b[3] - a[0] * b[0] - a[1] * b[1] - a[2] * b[2]
+], "qmul");
+var qinv = /* @__PURE__ */ __name((q) => [-q[0], -q[1], -q[2], q[3]], "qinv");
+var qrot = /* @__PURE__ */ __name((q, v) => {
+  const r = qmul(qmul(q, [v[0], v[1], v[2], 0]), qinv(q));
+  return [r[0], r[1], r[2]];
+}, "qrot");
+function restPositions(root) {
+  const out = /* @__PURE__ */ new Map();
+  const walk = /* @__PURE__ */ __name((n, pq, pp, ps) => {
+    const t = qrot(pq, [n.translation[0] * ps, n.translation[1] * ps, n.translation[2] * ps]);
+    const p = [pp[0] + t[0], pp[1] + t[1], pp[2] + t[2]];
+    out.set(n.name, p);
+    const q = qmul(pq, n.rotation);
+    const s = ps * (n.scale?.[0] ?? 1);
+    for (const c of n.children) walk(c, q, p, s);
+  }, "walk");
+  walk(root, [0, 0, 0, 1], [0, 0, 0], 1);
+  return out;
+}
+__name(restPositions, "restPositions");
+function splitBoneName(raw) {
+  let n = raw.replace(/^.*[:|]/, "").replace(/^(mixamorig\d*|def[-_]|org[-_]|mch[-_]|bip\d*[ _]|b[-_])/i, "").trim();
+  let side = null;
+  const sided = [
+    [/^left[\s_.-]*/i, "left"],
+    [/^right[\s_.-]*/i, "right"],
+    [/^l[\s_.-]+/i, "left"],
+    [/^r[\s_.-]+/i, "right"],
+    [/[\s_.-]+l$/i, "left"],
+    [/[\s_.-]+r$/i, "right"],
+    [/[\s_.-]*left$/i, "left"],
+    [/[\s_.-]*right$/i, "right"]
+  ];
+  for (const [re, s] of sided) {
+    if (re.test(n)) {
+      side = s;
+      n = n.replace(re, "");
+      break;
+    }
+  }
+  return { side, base: n.toLowerCase().replace(/[^a-z0-9]/g, "") };
+}
+__name(splitBoneName, "splitBoneName");
+var LIMB_BASES = [
+  [/^(shoulder|clavicle|collar(bone)?)$/, "Shoulder"],
+  [/^(upperarm|uparm|arm)$/, "UpperArm"],
+  [/^(forearm|lowerarm|elbow|loarm)$/, "LowerArm"],
+  [/^(hand|wrist)$/, "Hand"],
+  [/^(upleg|upperleg|thigh|hipjoint)$/, "UpperLeg"],
+  [/^(leg|lowerleg|calf|shin|knee)$/, "LowerLeg"],
+  [/^(foot|ankle)$/, "Foot"],
+  [/^(toebase|toe|toes|ball)$/, "Toes"]
+];
+var FINGERS = [
+  [/^thumb/, "Thumb"],
+  [/^(index|pointer)/, "Index"],
+  [/^(middle|fingers)/, "Middle"],
+  [/^ring/, "Ring"],
+  [/^(pinky|little|small)/, "Little"]
+];
+function fingerJoint(finger, digits) {
+  const n = digits === "" ? 1 : Number(digits);
+  const joints = finger === "Thumb" ? ["Metacarpal", "Proximal", "Distal"] : ["Proximal", "Intermediate", "Distal"];
+  return joints[n - 1] ?? null;
+}
+__name(fingerJoint, "fingerJoint");
+function sidedBone(base, side) {
+  for (const [re, part] of LIMB_BASES) {
+    if (re.test(base)) return `${side}${part}`;
+  }
+  const f = base.replace(/^hand(?=(thumb|index|middle|ring|pinky|little))/, "");
+  for (const [re, finger] of FINGERS) {
+    if (!re.test(f)) continue;
+    const digits = /(\d+)$/.exec(f)?.[1] ?? "";
+    const joint = fingerJoint(finger, digits.replace(/^0+/, ""));
+    return joint ? `${side}${finger}${joint}` : null;
+  }
+  return null;
+}
+__name(sidedBone, "sidedBone");
+var VRM_LOWER = /* @__PURE__ */ new Map();
+var VRM_FINGER = /^(left|right)(Thumb|Index|Middle|Ring|Little)(Metacarpal|Proximal|Intermediate|Distal)$/;
+function vrmBone(raw) {
+  const name = raw.replace(/^.*[:|]/, "");
+  if (VRM_FINGER.test(name)) return name;
+  if (VRM_LOWER.size === 0) {
+    const sides = ["left", "right"];
+    const parts = ["Shoulder", "UpperArm", "LowerArm", "Hand", "UpperLeg", "LowerLeg", "Foot", "Toes"];
+    for (const s of sides) for (const p of parts) VRM_LOWER.set(`${s}${p}`.toLowerCase(), `${s}${p}`);
+    for (const b of ["hips", "spine", "chest", "upperChest", "neck", "head"])
+      VRM_LOWER.set(b.toLowerCase(), b);
+  }
+  return VRM_LOWER.get(name.toLowerCase()) ?? null;
+}
+__name(vrmBone, "vrmBone");
+function profileOf(names) {
+  if (names.some((n) => /^mixamorig/i.test(n))) return "mixamo";
+  if (names.some((n) => /^(upperarm|lowerarm|thigh|calf)_[lr]$/i.test(n))) return "unreal";
+  if (names.some((n) => /\.[LR]$/.test(n))) return "rigify";
+  if (names.some((n) => /^leftUpperArm$/.test(n))) return "vrm";
+  if (names.some((n) => /^Spine0[12]$/.test(n))) return "meshy";
+  return "generic";
+}
+__name(profileOf, "profileOf");
+function findHips(root) {
+  let found = null;
+  const walk = /* @__PURE__ */ __name((n) => {
+    if (found) return;
+    const { base } = splitBoneName(n.name);
+    if (/^(hips|hip|pelvis)$/.test(base)) {
+      found = n;
+      return;
+    }
+    for (const c of n.children) walk(c);
+  }, "walk");
+  walk(root);
+  return found;
+}
+__name(findHips, "findHips");
+var isSpineLike = /* @__PURE__ */ __name((base) => /^(spine|chest|upperchest|torso|back)\d*$/.test(base), "isSpineLike");
+function detectRig(root) {
+  const all = [];
+  const collect = /* @__PURE__ */ __name((n) => {
+    all.push(n);
+    for (const c of n.children) collect(c);
+  }, "collect");
+  collect(root);
+  const profile = profileOf(all.map((n) => n.name));
+  const bones = {};
+  const set = /* @__PURE__ */ __name((b, name) => {
+    if (!bones[b]) bones[b] = name;
+  }, "set");
+  const hips = findHips(root);
+  const positions = restPositions(root);
+  if (hips) {
+    set("hips", hips.name);
+    const chain = [];
+    let cur = hips;
+    while (cur) {
+      const next = cur.children.find((c) => isSpineLike(splitBoneName(c.name).base));
+      if (!next) break;
+      chain.push(next);
+      cur = next;
+    }
+    if (chain[0]) set("spine", chain[0].name);
+    if (chain[1]) set("chest", chain[1].name);
+    if (chain[2]) set("upperChest", chain[chain.length - 1].name);
+  }
+  for (const n of all) {
+    const vrm = vrmBone(n.name);
+    if (vrm) {
+      set(vrm, n.name);
+      continue;
+    }
+    const { side, base } = splitBoneName(n.name);
+    if (/^neck\d*$/.test(base)) {
+      set("neck", n.name);
+      continue;
+    }
+    if (/^head$/.test(base)) {
+      set("head", n.name);
+      continue;
+    }
+    if (base === "hips" || base === "pelvis" || isSpineLike(base)) continue;
+    const s = side ?? (() => {
+      const p = positions.get(n.name);
+      const h = hips ? positions.get(hips.name) : void 0;
+      if (!p || !h || Math.abs(p[0] - h[0]) < 1e-4) return null;
+      return p[0] > h[0] ? "left" : "right";
+    })();
+    if (!s) continue;
+    const b = sidedBone(base, s);
+    if (b) set(b, n.name);
+  }
+  const byName = /* @__PURE__ */ new Map();
+  for (const [b, name] of Object.entries(bones)) byName.set(name, b);
+  let armDrop = null;
+  const ua = bones.leftUpperArm && positions.get(bones.leftUpperArm);
+  const la = bones.leftLowerArm && positions.get(bones.leftLowerArm);
+  if (ua && la) {
+    const d = [la[0] - ua[0], la[1] - ua[1], la[2] - ua[2]];
+    const len = Math.hypot(d[0], d[1], d[2]) || 1;
+    armDrop = Math.asin(Math.max(-1, Math.min(1, -d[1] / len))) * 180 / Math.PI;
+  }
+  const restPose = armDrop === null ? "unknown" : armDrop < 15 ? "T" : armDrop <= 65 ? "A" : "unknown";
+  return {
+    profile,
+    bones,
+    byName,
+    restPose,
+    armDrop,
+    missing: REQUIRED_HUMANOID_BONES.filter((b) => !bones[b])
+  };
+}
+__name(detectRig, "detectRig");
+function mirrorHumanoidBone(b) {
+  if (b.startsWith("left")) return `right${b.slice(4)}`;
+  if (b.startsWith("right")) return `left${b.slice(5)}`;
+  return b;
+}
+__name(mirrorHumanoidBone, "mirrorHumanoidBone");
+function skeletonFromObject3D(object) {
+  const o = object;
+  return {
+    name: o.name,
+    translation: [o.position.x, o.position.y, o.position.z],
+    rotation: [o.quaternion.x, o.quaternion.y, o.quaternion.z, o.quaternion.w],
+    scale: o.scale ? [o.scale.x, o.scale.y, o.scale.z] : void 0,
+    children: o.children.map(skeletonFromObject3D)
+  };
+}
+__name(skeletonFromObject3D, "skeletonFromObject3D");
+
+exports.REQUIRED_HUMANOID_BONES = REQUIRED_HUMANOID_BONES;
+exports.detectRig = detectRig;
+exports.mirrorHumanoidBone = mirrorHumanoidBone;
+exports.qinv = qinv;
+exports.qmul = qmul;
+exports.qrot = qrot;
+exports.restPositions = restPositions;
+exports.skeletonFromObject3D = skeletonFromObject3D;
+exports.splitBoneName = splitBoneName;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/animation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/animation/humanoid.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * One vocabulary for humanoid skeletons.\n *\n * Every source names its bones differently: Mixamo `mixamorig:LeftForeArm`,\n * Meshy `LeftForeArm` with its spine numbered top-down (`Spine02` is the\n * LOWEST), Unreal / Quaternius UAL `lowerarm_l` with `spine_01` lowest,\n * Blender rigify `forearm.L`, VRM `leftLowerArm`. Retargeting, the animation\n * editor and bone sockets all need \"the left forearm\" regardless, so a\n * skeleton is mapped once onto VRM's humanoid bone names (the closest thing\n * to a standard) and everything downstream speaks those.\n *\n * Pure data + math, no three.js: the editor's Node tools (gltf-transform\n * documents) and the runtime (THREE.Bone trees) both build a `SkeletonNode`\n * tree and call `detectRig`.\n */\n\nexport type HumanoidBone =\n  | \"hips\"\n  | \"spine\"\n  | \"chest\"\n  | \"upperChest\"\n  | \"neck\"\n  | \"head\"\n  | \"leftShoulder\"\n  | \"leftUpperArm\"\n  | \"leftLowerArm\"\n  | \"leftHand\"\n  | \"rightShoulder\"\n  | \"rightUpperArm\"\n  | \"rightLowerArm\"\n  | \"rightHand\"\n  | \"leftUpperLeg\"\n  | \"leftLowerLeg\"\n  | \"leftFoot\"\n  | \"leftToes\"\n  | \"rightUpperLeg\"\n  | \"rightLowerLeg\"\n  | \"rightFoot\"\n  | \"rightToes\"\n  | `${\"left\" | \"right\"}${Finger}${FingerJoint}`;\n\ntype Finger = \"Thumb\" | \"Index\" | \"Middle\" | \"Ring\" | \"Little\";\ntype FingerJoint = \"Metacarpal\" | \"Proximal\" | \"Intermediate\" | \"Distal\";\n\n/** The bones a humanoid must have to retarget a full-body clip. */\nexport const REQUIRED_HUMANOID_BONES: readonly HumanoidBone[] = [\n  \"hips\",\n  \"spine\",\n  \"head\",\n  \"leftUpperArm\",\n  \"leftLowerArm\",\n  \"leftHand\",\n  \"rightUpperArm\",\n  \"rightLowerArm\",\n  \"rightHand\",\n  \"leftUpperLeg\",\n  \"leftLowerLeg\",\n  \"leftFoot\",\n  \"rightUpperLeg\",\n  \"rightLowerLeg\",\n  \"rightFoot\",\n];\n\n/** Vector [x, y, z] and quaternion [x, y, z, w]. */\nexport type Vec3 = [number, number, number];\nexport type Quat = [number, number, number, number];\n\n/** A bone (or any node) with its LOCAL rest transform. */\nexport interface SkeletonNode {\n  name: string;\n  translation: Vec3;\n  rotation: Quat;\n  scale?: Vec3;\n  children: SkeletonNode[];\n}\n\nexport type RigProfile =\n  | \"mixamo\"\n  | \"meshy\"\n  | \"unreal\"\n  | \"rigify\"\n  | \"vrm\"\n  | \"generic\";\n\nexport interface RigDetection {\n  profile: RigProfile;\n  /** Humanoid bone → the rig's own bone name. */\n  bones: Partial<Record<HumanoidBone, string>>;\n  /** Rig bone name → humanoid bone. */\n  byName: Map<string, HumanoidBone>;\n  /** Arms level (T), angled down (A), or neither. */\n  restPose: \"T\" | \"A\" | \"unknown\";\n  /** Degrees the left upper arm points below horizontal at rest. */\n  armDrop: number | null;\n  /** Required bones the rig lacks (empty = can retarget). */\n  missing: HumanoidBone[];\n}\n\n// ── quaternion helpers ───────────────────────────────────────────────────────\n\nexport const qmul = (a: Quat, b: Quat): Quat => [\n  a[3] * b[0] + a[0] * b[3] + a[1] * b[2] - a[2] * b[1],\n  a[3] * b[1] - a[0] * b[2] + a[1] * b[3] + a[2] * b[0],\n  a[3] * b[2] + a[0] * b[1] - a[1] * b[0] + a[2] * b[3],\n  a[3] * b[3] - a[0] * b[0] - a[1] * b[1] - a[2] * b[2],\n];\nexport const qinv = (q: Quat): Quat => [-q[0], -q[1], -q[2], q[3]];\nexport const qrot = (q: Quat, v: Vec3): Vec3 => {\n  const r = qmul(qmul(q, [v[0], v[1], v[2], 0]), qinv(q));\n  return [r[0], r[1], r[2]];\n};\n\n/** World (rig-space) rest position of every node, by name. */\nexport function restPositions(root: SkeletonNode): Map<string, Vec3> {\n  const out = new Map<string, Vec3>();\n  const walk = (n: SkeletonNode, pq: Quat, pp: Vec3, ps: number) => {\n    const t = qrot(pq, [n.translation[0] * ps, n.translation[1] * ps, n.translation[2] * ps]);\n    const p: Vec3 = [pp[0] + t[0], pp[1] + t[1], pp[2] + t[2]];\n    out.set(n.name, p);\n    const q = qmul(pq, n.rotation);\n    const s = ps * (n.scale?.[0] ?? 1);\n    for (const c of n.children) walk(c, q, p, s);\n  };\n  walk(root, [0, 0, 0, 1], [0, 0, 0], 1);\n  return out;\n}\n\n// ── names ────────────────────────────────────────────────────────────────────\n\n/**\n * `mixamorig1:LeftForeArm` → { side: \"left\", base: \"forearm\" };\n * `upperarm_l` → { side: \"left\", base: \"upperarm\" }; `forearm.L` → left.\n */\nexport function splitBoneName(raw: string): { side: \"left\" | \"right\" | null; base: string } {\n  let n = raw\n    .replace(/^.*[:|]/, \"\") // mixamorig:, Armature|, rig:\n    .replace(/^(mixamorig\\d*|def[-_]|org[-_]|mch[-_]|bip\\d*[ _]|b[-_])/i, \"\")\n    .trim();\n  let side: \"left\" | \"right\" | null = null;\n  const sided = [\n    [/^left[\\s_.-]*/i, \"left\"],\n    [/^right[\\s_.-]*/i, \"right\"],\n    [/^l[\\s_.-]+/i, \"left\"],\n    [/^r[\\s_.-]+/i, \"right\"],\n    [/[\\s_.-]+l$/i, \"left\"],\n    [/[\\s_.-]+r$/i, \"right\"],\n    [/[\\s_.-]*left$/i, \"left\"],\n    [/[\\s_.-]*right$/i, \"right\"],\n  ] as const;\n  for (const [re, s] of sided) {\n    if (re.test(n)) {\n      side = s;\n      n = n.replace(re, \"\");\n      break;\n    }\n  }\n  return { side, base: n.toLowerCase().replace(/[^a-z0-9]/g, \"\") };\n}\n\n/** Bases for sided limb bones. Order matters: first match wins. */\nconst LIMB_BASES: Array<[RegExp, string]> = [\n  [/^(shoulder|clavicle|collar(bone)?)$/, \"Shoulder\"],\n  [/^(upperarm|uparm|arm)$/, \"UpperArm\"],\n  [/^(forearm|lowerarm|elbow|loarm)$/, \"LowerArm\"],\n  [/^(hand|wrist)$/, \"Hand\"],\n  [/^(upleg|upperleg|thigh|hipjoint)$/, \"UpperLeg\"],\n  [/^(leg|lowerleg|calf|shin|knee)$/, \"LowerLeg\"],\n  [/^(foot|ankle)$/, \"Foot\"],\n  [/^(toebase|toe|toes|ball)$/, \"Toes\"],\n];\n\nconst FINGERS: Array<[RegExp, Finger]> = [\n  [/^thumb/, \"Thumb\"],\n  [/^(index|pointer)/, \"Index\"],\n  [/^(middle|fingers)/, \"Middle\"],\n  [/^ring/, \"Ring\"],\n  [/^(pinky|little|small)/, \"Little\"],\n];\n\nfunction fingerJoint(finger: Finger, digits: string): FingerJoint | null {\n  // Mixamo/UE number 1-3 (4 = tip); a bare \"Thumb\"/\"Fingers\" (Meshy after\n  // fix-rig) is the first joint.\n  const n = digits === \"\" ? 1 : Number(digits);\n  const joints: FingerJoint[] =\n    finger === \"Thumb\"\n      ? [\"Metacarpal\", \"Proximal\", \"Distal\"]\n      : [\"Proximal\", \"Intermediate\", \"Distal\"];\n  return joints[n - 1] ?? null;\n}\n\n/** A sided bone from its name alone, or null. */\nfunction sidedBone(base: string, side: \"left\" | \"right\"): HumanoidBone | null {\n  for (const [re, part] of LIMB_BASES) {\n    if (re.test(base)) return `${side}${part}` as HumanoidBone;\n  }\n  // Mixamo writes fingers as LeftHandIndex1.\n  const f = base.replace(/^hand(?=(thumb|index|middle|ring|pinky|little))/, \"\");\n  for (const [re, finger] of FINGERS) {\n    if (!re.test(f)) continue;\n    const digits = /(\\d+)$/.exec(f)?.[1] ?? \"\";\n    const joint = fingerJoint(finger, digits.replace(/^0+/, \"\"));\n    return joint ? (`${side}${finger}${joint}` as HumanoidBone) : null;\n  }\n  return null;\n}\n\n// VRM names, recognised directly (leftUpperArm → lowercase \"leftupperarm\").\nconst VRM_LOWER = new Map<string, HumanoidBone>();\n\nconst VRM_FINGER = /^(left|right)(Thumb|Index|Middle|Ring|Little)(Metacarpal|Proximal|Intermediate|Distal)$/;\n\nfunction vrmBone(raw: string): HumanoidBone | null {\n  const name = raw.replace(/^.*[:|]/, \"\");\n  if (VRM_FINGER.test(name)) return name as HumanoidBone;\n  if (VRM_LOWER.size === 0) {\n    const sides = [\"left\", \"right\"] as const;\n    const parts = [\"Shoulder\", \"UpperArm\", \"LowerArm\", \"Hand\", \"UpperLeg\", \"LowerLeg\", \"Foot\", \"Toes\"];\n    for (const s of sides) for (const p of parts) VRM_LOWER.set(`${s}${p}`.toLowerCase(), `${s}${p}` as HumanoidBone);\n    for (const b of [\"hips\", \"spine\", \"chest\", \"upperChest\", \"neck\", \"head\"] as const)\n      VRM_LOWER.set(b.toLowerCase(), b);\n  }\n  return VRM_LOWER.get(name.toLowerCase()) ?? null;\n}\n\nfunction profileOf(names: string[]): RigProfile {\n  if (names.some((n) => /^mixamorig/i.test(n))) return \"mixamo\";\n  if (names.some((n) => /^(upperarm|lowerarm|thigh|calf)_[lr]$/i.test(n))) return \"unreal\";\n  if (names.some((n) => /\\.[LR]$/.test(n))) return \"rigify\";\n  if (names.some((n) => /^leftUpperArm$/.test(n))) return \"vrm\";\n  if (names.some((n) => /^Spine0[12]$/.test(n))) return \"meshy\";\n  return \"generic\";\n}\n\nfunction findHips(root: SkeletonNode): SkeletonNode | null {\n  let found: SkeletonNode | null = null;\n  const walk = (n: SkeletonNode) => {\n    if (found) return;\n    const { base } = splitBoneName(n.name);\n    if (/^(hips|hip|pelvis)$/.test(base)) {\n      found = n;\n      return;\n    }\n    for (const c of n.children) walk(c);\n  };\n  walk(root);\n  return found;\n}\n\nconst isSpineLike = (base: string) => /^(spine|chest|upperchest|torso|back)\\d*$/.test(base);\n\n/**\n * Map a skeleton onto humanoid bones. Pass the scene root (the armature's\n * own transform included): the rest-pose check measures \"down\" in that space,\n * and a Mixamo armature is Z-up under a 90° turn.\n *\n * Limbs and fingers come from their names (any of the conventions above, side\n * from prefixes/suffixes, or from which side of the body they sit when the\n * name has none). The spine comes from the CHAIN between the hips and the\n * neck, not from names, because conventions number it in opposite\n * directions: its first bone is `spine`, the second `chest`, a third\n * `upperChest`.\n */\nexport function detectRig(root: SkeletonNode): RigDetection {\n  const all: SkeletonNode[] = [];\n  const collect = (n: SkeletonNode) => {\n    all.push(n);\n    for (const c of n.children) collect(c);\n  };\n  collect(root);\n  const profile = profileOf(all.map((n) => n.name));\n  const bones: Partial<Record<HumanoidBone, string>> = {};\n  const set = (b: HumanoidBone, name: string) => {\n    if (!bones[b]) bones[b] = name;\n  };\n\n  const hips = findHips(root);\n  const positions = restPositions(root);\n  if (hips) {\n    set(\"hips\", hips.name);\n    // The spine chain: follow spine-like children upward from the hips.\n    const chain: SkeletonNode[] = [];\n    let cur: SkeletonNode | undefined = hips;\n    while (cur) {\n      const next: SkeletonNode | undefined = cur.children.find((c) => isSpineLike(splitBoneName(c.name).base));\n      if (!next) break;\n      chain.push(next);\n      cur = next;\n    }\n    if (chain[0]) set(\"spine\", chain[0].name);\n    if (chain[1]) set(\"chest\", chain[1].name);\n    if (chain[2]) set(\"upperChest\", chain[chain.length - 1].name);\n  }\n\n  for (const n of all) {\n    const vrm = vrmBone(n.name);\n    if (vrm) {\n      set(vrm, n.name);\n      continue;\n    }\n    const { side, base } = splitBoneName(n.name);\n    if (/^neck\\d*$/.test(base)) {\n      set(\"neck\", n.name);\n      continue;\n    }\n    if (/^head$/.test(base)) {\n      set(\"head\", n.name);\n      continue;\n    }\n    if (base === \"hips\" || base === \"pelvis\" || isSpineLike(base)) continue;\n    // No side in the name: decide by which side of the hips it sits (glTF\n    // humanoids face +Z, so their left is +X).\n    const s =\n      side ??\n      (() => {\n        const p = positions.get(n.name);\n        const h = hips ? positions.get(hips.name) : undefined;\n        if (!p || !h || Math.abs(p[0] - h[0]) < 1e-4) return null;\n        return p[0] > h[0] ? \"left\" : \"right\";\n      })();\n    if (!s) continue;\n    const b = sidedBone(base, s);\n    if (b) set(b, n.name);\n  }\n\n  const byName = new Map<string, HumanoidBone>();\n  for (const [b, name] of Object.entries(bones)) byName.set(name as string, b as HumanoidBone);\n\n  // Rest pose from the left upper arm's direction.\n  let armDrop: number | null = null;\n  const ua = bones.leftUpperArm && positions.get(bones.leftUpperArm);\n  const la = bones.leftLowerArm && positions.get(bones.leftLowerArm);\n  if (ua && la) {\n    const d: Vec3 = [la[0] - ua[0], la[1] - ua[1], la[2] - ua[2]];\n    const len = Math.hypot(d[0], d[1], d[2]) || 1;\n    armDrop = (Math.asin(Math.max(-1, Math.min(1, -d[1] / len))) * 180) / Math.PI;\n  }\n  const restPose = armDrop === null ? \"unknown\" : armDrop < 15 ? \"T\" : armDrop <= 65 ? \"A\" : \"unknown\";\n\n  return {\n    profile,\n    bones,\n    byName,\n    restPose,\n    armDrop,\n    missing: REQUIRED_HUMANOID_BONES.filter((b) => !bones[b]),\n  };\n}\n\n/** The same bone on the other side (`leftHand` ↔ `rightHand`). */\nexport function mirrorHumanoidBone(b: HumanoidBone): HumanoidBone {\n  if (b.startsWith(\"left\")) return `right${b.slice(4)}` as HumanoidBone;\n  if (b.startsWith(\"right\")) return `left${b.slice(5)}` as HumanoidBone;\n  return b;\n}\n\n/**\n * Duck-typed adapter for a three.js Object3D/Bone tree (position: Vector3,\n * quaternion: Quaternion), so the runtime can call `detectRig` without this\n * module importing three.\n */\nexport function skeletonFromObject3D(object: {\n  name: string;\n  position: { x: number; y: number; z: number };\n  quaternion: { x: number; y: number; z: number; w: number };\n  scale?: { x: number; y: number; z: number };\n  children: unknown[];\n}): SkeletonNode {\n  const o = object;\n  return {\n    name: o.name,\n    translation: [o.position.x, o.position.y, o.position.z],\n    rotation: [o.quaternion.x, o.quaternion.y, o.quaternion.z, o.quaternion.w],\n    scale: o.scale ? [o.scale.x, o.scale.y, o.scale.z] : undefined,\n    children: (o.children as (typeof object)[]).map(skeletonFromObject3D),\n  };\n}\n"]}