@relu-interactives/spatial-ecs 0.10.0 → 0.11.1

package/dist/{System-BldSHxZV.d.cts → System-D8vm-Jvv.d.cts}

@@ -599,6 +599,85 @@ declare class TransformComponent extends Component {
     setRotation(input: TransformInput, order?: EulerOrder): this;
 }
 
+/** Three numbers, as {@link TransformComponent} keeps them. */
+type Xyz = {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Where an attached entity goes while certain clips play: a rifle slung on the
+ * back in Idle, a sword hidden in Swim.
+ */
+type BoneHold = {
+    /** The clips this hold is for. */
+    clips: string[];
+    /** Another bone, by node name, for these clips. Unset: the attachment's own. */
+    bone: string | null;
+    /** Another bone by humanoid name, used when the node name isn't found (another rig). */
+    humanoid: string | null;
+    /** Hide the entity in these clips. */
+    hidden: boolean;
+    /** Offset from the bone in these clips, instead of the entity's Transform position. */
+    position: Xyz | null;
+    /** Rotation from the bone in radians, instead of the entity's Transform rotation. */
+    rotation: Xyz | null;
+};
+/** A hold with every field filled in. */
+declare function normalizeBoneHold(hold: Partial<BoneHold>): BoneHold;
+/** 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;
+    /** Where it goes in particular clips. Defaults to none. */
+    holds?: Array<Partial<BoneHold> & {
+        clips: string[];
+    }>;
+    /** Hide it while a clip no hold names is playing. Defaults to `false`. */
+    hideInOtherClips?: 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.
+ *
+ * `holds` change that per clip of the character's Animation component, so a
+ * rifle can be in the hands in the rifle clips, on the back in Idle and hidden
+ * in the rest. With no clip playing the attachment is as its own fields say.
+ *
+ * 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;
+    /** Where the entity goes in particular clips; the first hold naming the clip wins. */
+    holds: BoneHold[];
+    /** Hide the entity while a clip no hold names is playing. */
+    hideInOtherClips: boolean;
+    constructor(options?: BoneAttachmentOptions);
+}
+
 /** The limb a chain moves: its end bone, by humanoid name. */
 type IKLimb = "leftHand" | "rightHand" | "leftFoot" | "rightFoot";
 /** One limb reaching for an entity. */
@@ -615,6 +694,14 @@ type IKChain = {
     matchRotation: boolean;
     /** Whether this chain runs. */
     enabled: boolean;
+    /** Only while one of these clips plays (`null` = whatever plays). */
+    clips: string[] | null;
+    /**
+     * Seconds a chain with `clips` takes to fade in or out when the clip changes;
+     * `null` follows the Animation component's cross-fade, so the IK and the clip
+     * change together.
+     */
+    fade: number | null;
 };
 /** Optional initializer for {@link IKComponent}. */
 type IKOptions = {
@@ -635,6 +722,11 @@ declare function normalizeIKChain(chain: Partial<IKChain> & {
  * otherwise. Bones are found by humanoid name, so any rig the editor
  * recognises works (Mixamo, auto-rigs, Unreal, VRM).
  *
+ * A chain with `clips` runs only while one of those clips plays, fading in and
+ * out as the clip changes: a left hand on a rifle's grip in the rifle clips,
+ * free in the rest. Without an Animation component no clip is playing, so such
+ * a chain stays off.
+ *
  * The `IKSystem` runs it right after the `AnimationSystem`; objects attached
  * to the moved bones follow.
  *
@@ -1229,6 +1321,8 @@ declare class ObjectManagementSystem implements EcsSystem {
     private readonly boneSockets;
     /** Attachments whose bone wasn't found in a given model (skip re-searching every frame). */
     private readonly boneMisses;
+    /** Attachments with holds, and which one the current clip calls for (`null`: none). */
+    private readonly boneHolds;
     constructor(scene: THREE.Scene, camera: THREE.PerspectiveCamera, isEditor?: boolean);
     register(kind: EcsEntityKind, factory: EntityFactory): void;
     registerComponentFactory(kind: EcsComponentFactoryKind, factory: ComponentFactory): void;
@@ -1280,6 +1374,16 @@ declare class ObjectManagementSystem implements EcsSystem {
      * still applies, as it does to any child.
      */
     private fitSocketScale;
+    /** Whether {@link applyBoneHold} is managing this attachment. */
+    hasBoneHold(entityId: EntityId): boolean;
+    /**
+     * Put an attachment in a hold for the clip now playing (`hold` null: the
+     * attachment's own bone and Transform), moving it to the hold's bone if that
+     * changed. Called each frame, since a socket can be rebuilt under it.
+     */
+    applyBoneHold(world: World, entityId: EntityId, hold: BoneHold | null, hidden: boolean): void;
+    /** Stop managing an attachment that no longer has holds, and put it back. */
+    releaseBoneHold(world: World, entityId: EntityId): void;
     /**
      * Load a model entity's file again and swap it in (the file was rewritten);
      * the entity, its components and children stay, attachments re-home.
@@ -1615,7 +1719,8 @@ declare class TransformSyncSystem implements EcsSystem {
  * Runs each {@link IKComponent}'s chains after the animation: hands and feet
  * reach their target entities. Bones the animation doesn't drive would keep
  * last frame's IK pose and drift, so every bone IK touched is put back to its
- * pre-IK rotation first unless the animation already overwrote it.
+ * pre-IK rotation first unless the animation already overwrote it. A chain
+ * with `clips` fades with the clip that's playing.
  *
  * @category Systems
  */
@@ -1627,7 +1732,9 @@ declare class IKSystem implements EcsSystem {
      */
     getReachError(entityId: EntityId, limb: IKLimb): number | null;
     private restore;
-    update(world: World): void;
+    /** How strongly a chain applies now, moving its fade on by `deltaTime`. */
+    private fadeOf;
+    update(world: World, deltaTime?: number): void;
     dispose(): void;
 }
 
@@ -2013,4 +2120,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { type RenderBackend as $, type NetPose as A, type NetSound as B, Component as C, DEFAULT_ENVIRONMENT_LIGHTING as D, Environment as E, type VoiceFromRoom as F, type VoiceToRoom as G, type VoiceHandle as H, type IKChain as I, type VoicePeer as J, type EcsSystem as K, type NetworkService as L, type EntityId as M, type NetValue as N, type NetworkHandle as O, ParentId as P, type NetSpawnOptions as Q, type VoiceSignal as R, type WorldEntityView$1 as S, TransformComponent as T, type SpawnPrefabSource as U, type Vec3$1 as V, World as W, type SpawnPrefabOptions as X, type PlaySlotOptions as Y, type ComponentClass as Z, type ParentLookup as _, DEFAULT_ENVIRONMENT_STATE as a, spawnPrefab as a$, type EcsEntityKind as a0, ObjectManagementSystem as a1, type SubtreeSnapshot as a2, type ExternalRefWarning as a3, type AssetInput as a4, type AudioBus as a5, AudioMixer as a6, AudioSystem as a7, type CheckboxInput as a8, type ChromaKeyOptions as a9, type ScriptErrorEvent as aA, type ScriptErrorListener as aB, type ScriptErrorPhase as aC, type ScriptErrorReport as aD, type ScriptErrorSource as aE, type SelectionListener as aF, type SliderInput as aG, SlotChooser as aH, type SoundBankAsset as aI, type SoundSlot as aJ, type SoundTake as aK, type TextInput as aL, type ToggleInput as aM, TransformSyncSystem as aN, type Vec3 as aO, type Vector2Input as aP, type Vector3Input as aQ, clearPrefabCache as aR, despawnPrefab as aS, findModelBone as aT, listModelBones as aU, loadPrefab as aV, parsePrefabAsset as aW, prefabFileVersionFor as aX, remapSnapshotEntityIds as aY, setPrefabAssetUrlResolver as aZ, soundBankFiles as a_, type ColorInput as aa, type ComponentFactory as ab, type ComponentInput as ac, type ComponentKind as ad, type DropdownInput as ae, type DropdownOption as af, type EcsComponentFactoryKind as ag, type EcsEntityEditorKind as ah, type EcsRenderer as ai, type EntityInput as aj, type FloatInput as ak, IKSystem as al, InputSystem as am, type IntersectionResult as an, type KeyboardKey as ao, KeyboardKeys as ap, type ModelBoneInfo as aq, type MouseButton as ar, PREFAB_FILE_VERSION as as, PREFAB_FILE_VERSION_NESTED as at, type PostprocessingBuildContext as au, type PostprocessingPipeline as av, type PrefabAsset as aw, type RemapSnapshotOptions as ax, RenderSystem as ay, type RendererKind as az, DEFAULT_POSTPROCESSING_STATE as b, type AnyComponent as b0, DEBUG_CHANGE_IGNORED_SYSTEMS as b1, type WorldHistorySnapshot as b2, cloneHistoryValue as b3, normalizeDebugValue as b4, type EnvironmentFogState as c, type EnvironmentFogType as d, type EnvironmentGradientEffect as e, type EnvironmentLightingState as f, type EnvironmentSkyboxImageProjection as g, type EnvironmentSkyboxState as h, type EnvironmentSkyboxType as i, type EnvironmentState as j, type EnvironmentToneMapping as k, IKComponent as l, type IKLimb as m, type IKOptions as n, NetworkIdentityComponent as o, NetworkSpawnerComponent as p, NetworkTransformComponent as q, type NetworkTransformOptions as r, NetworkedPropsComponent as s, Postprocessing as t, type PostprocessingState as u, type TransformData as v, normalizeEnvironmentLighting as w, normalizeIKChain as x, type NetworkTransport as y, type NetEntityView as z };
+export { type SpawnPrefabOptions as $, normalizeIKChain as A, BoneAttachmentComponent as B, Component as C, DEFAULT_ENVIRONMENT_LIGHTING as D, Environment as E, type NetworkTransport as F, type NetEntityView as G, type NetPose as H, type IKChain as I, type NetSound as J, type VoiceFromRoom as K, type VoiceToRoom as L, type VoiceHandle as M, type NetValue as N, type VoicePeer as O, ParentId as P, type EcsSystem as Q, type NetworkService as R, type EntityId as S, TransformComponent as T, type NetworkHandle as U, type Vec3$1 as V, World as W, type NetSpawnOptions as X, type VoiceSignal as Y, type WorldEntityView$1 as Z, type SpawnPrefabSource as _, type BoneAttachmentOptions as a, prefabFileVersionFor as a$, type PlaySlotOptions as a0, type ComponentClass as a1, type ParentLookup as a2, type RenderBackend as a3, type EcsEntityKind as a4, ObjectManagementSystem as a5, type SubtreeSnapshot as a6, type ExternalRefWarning as a7, type AssetInput as a8, type AudioBus as a9, type PrefabAsset as aA, type RemapSnapshotOptions as aB, RenderSystem as aC, type RendererKind as aD, type ScriptErrorEvent as aE, type ScriptErrorListener as aF, type ScriptErrorPhase as aG, type ScriptErrorReport as aH, type ScriptErrorSource as aI, type SelectionListener as aJ, type SliderInput as aK, SlotChooser as aL, type SoundBankAsset as aM, type SoundSlot as aN, type SoundTake as aO, type TextInput as aP, type ToggleInput as aQ, TransformSyncSystem as aR, type Vec3 as aS, type Vector2Input as aT, type Vector3Input as aU, clearPrefabCache as aV, despawnPrefab as aW, findModelBone as aX, listModelBones as aY, loadPrefab as aZ, parsePrefabAsset as a_, AudioMixer as aa, AudioSystem as ab, type CheckboxInput as ac, type ChromaKeyOptions as ad, type ColorInput as ae, type ComponentFactory as af, type ComponentInput as ag, type ComponentKind as ah, type DropdownInput as ai, type DropdownOption as aj, type EcsComponentFactoryKind as ak, type EcsEntityEditorKind as al, type EcsRenderer as am, type EntityInput as an, type FloatInput as ao, IKSystem as ap, InputSystem as aq, type IntersectionResult as ar, type KeyboardKey as as, KeyboardKeys as at, type ModelBoneInfo as au, type MouseButton as av, PREFAB_FILE_VERSION as aw, PREFAB_FILE_VERSION_NESTED as ax, type PostprocessingBuildContext as ay, type PostprocessingPipeline as az, type BoneHold as b, remapSnapshotEntityIds as b0, setPrefabAssetUrlResolver as b1, soundBankFiles as b2, spawnPrefab as b3, type AnyComponent as b4, DEBUG_CHANGE_IGNORED_SYSTEMS as b5, type WorldHistorySnapshot as b6, cloneHistoryValue as b7, normalizeDebugValue as b8, DEFAULT_ENVIRONMENT_STATE as c, DEFAULT_POSTPROCESSING_STATE as d, type EnvironmentFogState as e, type EnvironmentFogType as f, type EnvironmentGradientEffect as g, type EnvironmentLightingState as h, type EnvironmentSkyboxImageProjection as i, type EnvironmentSkyboxState as j, type EnvironmentSkyboxType as k, type EnvironmentState as l, type EnvironmentToneMapping as m, IKComponent as n, type IKLimb as o, type IKOptions as p, NetworkIdentityComponent as q, NetworkSpawnerComponent as r, NetworkTransformComponent as s, type NetworkTransformOptions as t, NetworkedPropsComponent as u, Postprocessing as v, type PostprocessingState as w, type TransformData as x, normalizeBoneHold as y, normalizeEnvironmentLighting as z };

package/dist/{System-CADhPyQs.d.ts → System-ttkDQCrj.d.ts}

@@ -599,6 +599,85 @@ declare class TransformComponent extends Component {
     setRotation(input: TransformInput, order?: EulerOrder): this;
 }
 
+/** Three numbers, as {@link TransformComponent} keeps them. */
+type Xyz = {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Where an attached entity goes while certain clips play: a rifle slung on the
+ * back in Idle, a sword hidden in Swim.
+ */
+type BoneHold = {
+    /** The clips this hold is for. */
+    clips: string[];
+    /** Another bone, by node name, for these clips. Unset: the attachment's own. */
+    bone: string | null;
+    /** Another bone by humanoid name, used when the node name isn't found (another rig). */
+    humanoid: string | null;
+    /** Hide the entity in these clips. */
+    hidden: boolean;
+    /** Offset from the bone in these clips, instead of the entity's Transform position. */
+    position: Xyz | null;
+    /** Rotation from the bone in radians, instead of the entity's Transform rotation. */
+    rotation: Xyz | null;
+};
+/** A hold with every field filled in. */
+declare function normalizeBoneHold(hold: Partial<BoneHold>): BoneHold;
+/** 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;
+    /** Where it goes in particular clips. Defaults to none. */
+    holds?: Array<Partial<BoneHold> & {
+        clips: string[];
+    }>;
+    /** Hide it while a clip no hold names is playing. Defaults to `false`. */
+    hideInOtherClips?: 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.
+ *
+ * `holds` change that per clip of the character's Animation component, so a
+ * rifle can be in the hands in the rifle clips, on the back in Idle and hidden
+ * in the rest. With no clip playing the attachment is as its own fields say.
+ *
+ * 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;
+    /** Where the entity goes in particular clips; the first hold naming the clip wins. */
+    holds: BoneHold[];
+    /** Hide the entity while a clip no hold names is playing. */
+    hideInOtherClips: boolean;
+    constructor(options?: BoneAttachmentOptions);
+}
+
 /** The limb a chain moves: its end bone, by humanoid name. */
 type IKLimb = "leftHand" | "rightHand" | "leftFoot" | "rightFoot";
 /** One limb reaching for an entity. */
@@ -615,6 +694,14 @@ type IKChain = {
     matchRotation: boolean;
     /** Whether this chain runs. */
     enabled: boolean;
+    /** Only while one of these clips plays (`null` = whatever plays). */
+    clips: string[] | null;
+    /**
+     * Seconds a chain with `clips` takes to fade in or out when the clip changes;
+     * `null` follows the Animation component's cross-fade, so the IK and the clip
+     * change together.
+     */
+    fade: number | null;
 };
 /** Optional initializer for {@link IKComponent}. */
 type IKOptions = {
@@ -635,6 +722,11 @@ declare function normalizeIKChain(chain: Partial<IKChain> & {
  * otherwise. Bones are found by humanoid name, so any rig the editor
  * recognises works (Mixamo, auto-rigs, Unreal, VRM).
  *
+ * A chain with `clips` runs only while one of those clips plays, fading in and
+ * out as the clip changes: a left hand on a rifle's grip in the rifle clips,
+ * free in the rest. Without an Animation component no clip is playing, so such
+ * a chain stays off.
+ *
  * The `IKSystem` runs it right after the `AnimationSystem`; objects attached
  * to the moved bones follow.
  *
@@ -1229,6 +1321,8 @@ declare class ObjectManagementSystem implements EcsSystem {
     private readonly boneSockets;
     /** Attachments whose bone wasn't found in a given model (skip re-searching every frame). */
     private readonly boneMisses;
+    /** Attachments with holds, and which one the current clip calls for (`null`: none). */
+    private readonly boneHolds;
     constructor(scene: THREE.Scene, camera: THREE.PerspectiveCamera, isEditor?: boolean);
     register(kind: EcsEntityKind, factory: EntityFactory): void;
     registerComponentFactory(kind: EcsComponentFactoryKind, factory: ComponentFactory): void;
@@ -1280,6 +1374,16 @@ declare class ObjectManagementSystem implements EcsSystem {
      * still applies, as it does to any child.
      */
     private fitSocketScale;
+    /** Whether {@link applyBoneHold} is managing this attachment. */
+    hasBoneHold(entityId: EntityId): boolean;
+    /**
+     * Put an attachment in a hold for the clip now playing (`hold` null: the
+     * attachment's own bone and Transform), moving it to the hold's bone if that
+     * changed. Called each frame, since a socket can be rebuilt under it.
+     */
+    applyBoneHold(world: World, entityId: EntityId, hold: BoneHold | null, hidden: boolean): void;
+    /** Stop managing an attachment that no longer has holds, and put it back. */
+    releaseBoneHold(world: World, entityId: EntityId): void;
     /**
      * Load a model entity's file again and swap it in (the file was rewritten);
      * the entity, its components and children stay, attachments re-home.
@@ -1615,7 +1719,8 @@ declare class TransformSyncSystem implements EcsSystem {
  * Runs each {@link IKComponent}'s chains after the animation: hands and feet
  * reach their target entities. Bones the animation doesn't drive would keep
  * last frame's IK pose and drift, so every bone IK touched is put back to its
- * pre-IK rotation first unless the animation already overwrote it.
+ * pre-IK rotation first unless the animation already overwrote it. A chain
+ * with `clips` fades with the clip that's playing.
  *
  * @category Systems
  */
@@ -1627,7 +1732,9 @@ declare class IKSystem implements EcsSystem {
      */
     getReachError(entityId: EntityId, limb: IKLimb): number | null;
     private restore;
-    update(world: World): void;
+    /** How strongly a chain applies now, moving its fade on by `deltaTime`. */
+    private fadeOf;
+    update(world: World, deltaTime?: number): void;
     dispose(): void;
 }
 
@@ -2013,4 +2120,4 @@ interface EcsSystem {
     dispose?(world: World): void;
 }
 
-export { type WorldEntityView$1 as $, type TransformData as A, normalizeEnvironmentLighting as B, type ChromaKeyOptions as C, DEFAULT_ENVIRONMENT_LIGHTING as D, type EcsRenderer as E, normalizeIKChain as F, type NetworkTransport as G, type NetEntityView as H, type IKChain as I, type NetPose as J, type NetSound as K, type VoiceFromRoom as L, type VoiceToRoom as M, type NetValue as N, type VoiceHandle as O, type PostprocessingPipeline as P, type VoicePeer as Q, type RenderBackend as R, type EcsSystem as S, TransformComponent as T, type NetworkService as U, type Vec3$1 as V, World as W, type EntityId as X, type NetworkHandle as Y, type NetSpawnOptions as Z, type VoiceSignal as _, type PostprocessingBuildContext as a, spawnPrefab as a$, type SpawnPrefabSource as a0, type SpawnPrefabOptions as a1, type PlaySlotOptions as a2, type ComponentClass as a3, type ParentLookup as a4, type EcsEntityKind as a5, ObjectManagementSystem as a6, type SubtreeSnapshot as a7, type ExternalRefWarning as a8, type AssetInput as a9, type ScriptErrorEvent as aA, type ScriptErrorListener as aB, type ScriptErrorPhase as aC, type ScriptErrorReport as aD, type ScriptErrorSource as aE, type SelectionListener as aF, type SliderInput as aG, SlotChooser as aH, type SoundBankAsset as aI, type SoundSlot as aJ, type SoundTake as aK, type TextInput as aL, type ToggleInput as aM, TransformSyncSystem as aN, type Vec3 as aO, type Vector2Input as aP, type Vector3Input as aQ, clearPrefabCache as aR, despawnPrefab as aS, findModelBone as aT, listModelBones as aU, loadPrefab as aV, parsePrefabAsset as aW, prefabFileVersionFor as aX, remapSnapshotEntityIds as aY, setPrefabAssetUrlResolver as aZ, soundBankFiles as a_, type AudioBus as aa, AudioMixer as ab, AudioSystem as ac, type CheckboxInput as ad, type ColorInput as ae, type ComponentFactory as af, type ComponentInput as ag, type ComponentKind as ah, type DropdownInput as ai, type DropdownOption as aj, type EcsComponentFactoryKind as ak, type EcsEntityEditorKind as al, type EntityInput as am, type FloatInput as an, IKSystem as ao, InputSystem as ap, type IntersectionResult as aq, type KeyboardKey as ar, KeyboardKeys as as, type ModelBoneInfo as at, type MouseButton as au, PREFAB_FILE_VERSION as av, PREFAB_FILE_VERSION_NESTED as aw, type PrefabAsset as ax, type RemapSnapshotOptions as ay, RenderSystem as az, type PostprocessingState as b, type AnyComponent as b0, DEBUG_CHANGE_IGNORED_SYSTEMS as b1, type WorldHistorySnapshot as b2, cloneHistoryValue as b3, normalizeDebugValue as b4, type RendererKind as c, Component as d, DEFAULT_ENVIRONMENT_STATE as e, DEFAULT_POSTPROCESSING_STATE as f, Environment as g, type EnvironmentFogState as h, type EnvironmentFogType as i, type EnvironmentGradientEffect as j, type EnvironmentLightingState as k, type EnvironmentSkyboxImageProjection as l, type EnvironmentSkyboxState as m, type EnvironmentSkyboxType as n, type EnvironmentState as o, type EnvironmentToneMapping as p, IKComponent as q, type IKLimb as r, type IKOptions as s, NetworkIdentityComponent as t, NetworkSpawnerComponent as u, NetworkTransformComponent as v, type NetworkTransformOptions as w, NetworkedPropsComponent as x, ParentId as y, Postprocessing as z };
+export { type EntityId as $, ParentId as A, BoneAttachmentComponent as B, type ChromaKeyOptions as C, DEFAULT_ENVIRONMENT_LIGHTING as D, type EcsRenderer as E, Postprocessing as F, type TransformData as G, normalizeBoneHold as H, type IKChain as I, normalizeEnvironmentLighting as J, normalizeIKChain as K, type NetworkTransport as L, type NetEntityView as M, type NetValue as N, type NetPose as O, type PostprocessingPipeline as P, type NetSound as Q, type RenderBackend as R, type VoiceFromRoom as S, TransformComponent as T, type VoiceToRoom as U, type Vec3$1 as V, type VoiceHandle as W, type VoicePeer as X, type EcsSystem as Y, type NetworkService as Z, World as _, type PostprocessingBuildContext as a, prefabFileVersionFor as a$, type NetworkHandle as a0, type NetSpawnOptions as a1, type VoiceSignal as a2, type WorldEntityView$1 as a3, type SpawnPrefabSource as a4, type SpawnPrefabOptions as a5, type PlaySlotOptions as a6, type ComponentClass as a7, type ParentLookup as a8, type EcsEntityKind as a9, PREFAB_FILE_VERSION_NESTED as aA, type PrefabAsset as aB, type RemapSnapshotOptions as aC, RenderSystem as aD, type ScriptErrorEvent as aE, type ScriptErrorListener as aF, type ScriptErrorPhase as aG, type ScriptErrorReport as aH, type ScriptErrorSource as aI, type SelectionListener as aJ, type SliderInput as aK, SlotChooser as aL, type SoundBankAsset as aM, type SoundSlot as aN, type SoundTake as aO, type TextInput as aP, type ToggleInput as aQ, TransformSyncSystem as aR, type Vec3 as aS, type Vector2Input as aT, type Vector3Input as aU, clearPrefabCache as aV, despawnPrefab as aW, findModelBone as aX, listModelBones as aY, loadPrefab as aZ, parsePrefabAsset as a_, ObjectManagementSystem as aa, type SubtreeSnapshot as ab, type ExternalRefWarning as ac, type AssetInput as ad, type AudioBus as ae, AudioMixer as af, AudioSystem as ag, type CheckboxInput as ah, type ColorInput as ai, type ComponentFactory as aj, type ComponentInput as ak, type ComponentKind as al, type DropdownInput as am, type DropdownOption as an, type EcsComponentFactoryKind as ao, type EcsEntityEditorKind as ap, type EntityInput as aq, type FloatInput as ar, IKSystem as as, InputSystem as at, type IntersectionResult as au, type KeyboardKey as av, KeyboardKeys as aw, type ModelBoneInfo as ax, type MouseButton as ay, PREFAB_FILE_VERSION as az, type PostprocessingState as b, remapSnapshotEntityIds as b0, setPrefabAssetUrlResolver as b1, soundBankFiles as b2, spawnPrefab as b3, type AnyComponent as b4, DEBUG_CHANGE_IGNORED_SYSTEMS as b5, type WorldHistorySnapshot as b6, cloneHistoryValue as b7, normalizeDebugValue as b8, type RendererKind as c, Component as d, type BoneAttachmentOptions as e, type BoneHold as f, DEFAULT_ENVIRONMENT_STATE as g, DEFAULT_POSTPROCESSING_STATE as h, Environment as i, type EnvironmentFogState as j, type EnvironmentFogType as k, type EnvironmentGradientEffect as l, type EnvironmentLightingState as m, type EnvironmentSkyboxImageProjection as n, type EnvironmentSkyboxState as o, type EnvironmentSkyboxType as p, type EnvironmentState as q, type EnvironmentToneMapping as r, IKComponent as s, type IKLimb as t, type IKOptions as u, NetworkIdentityComponent as v, NetworkSpawnerComponent as w, NetworkTransformComponent as x, type NetworkTransformOptions as y, NetworkedPropsComponent as z };

package/dist/{XRHandPose-D3Ab1Dfs.d.cts → XRHandPose-C97XVW2R.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, a5 as AudioBus, a0 as EcsEntityKind, ah as EcsEntityEditorKind, M as EntityId } from './System-BldSHxZV.cjs';
+import { C as Component, a9 as AudioBus, a4 as EcsEntityKind, al as EcsEntityEditorKind, S as EntityId } from './System-D8vm-Jvv.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';
 
@@ -1624,45 +1624,6 @@ 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);
-}
-
 /**
  * The style model for spatial UI.
  *
@@ -2186,4 +2147,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-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, AnimationStateManager 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, XRInteractorComponent as aA, type XRInteractorOptions as aB, XRInteractorSideComponent as aC, XRRigComponent as aD, type XRRigOptions as aE, type XrAttachPoint as aF, type XrDistanceGrabBehavior as aG, type XrEnvironmentPhysics as aH, type XrGrabGesture as aI, type XrGrabHands as aJ, type XrGrabReach as aK, type XrHandPoseEntry as aL, type XrHandPreset as aM, type XrInteractorSide as aN, type XrInteractorType as aO, type XrLocomotionMode as aP, type XrTrackingOrigin as aQ, type XrTwoHandRotation as aR, createAttachPoint as aS, createHandPoseEntry as aT, defaultMaterialValue as aU, handPoseDefinitionFor as aV, normalizePhysicsState as aW, setModelLoadState as aX, setPhysicsLiveRef as aY, type AnimationStateCallbacks as aZ, AnimationStateMachine as a_, 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 UiIconPosition as al, type UiSliderVariant as am, type UiTextAlign as an, type UiTextVAlign as ao, type UiToggleVariant as ap, VRTeleportAreaComponent as aq, type VRTeleportAreaOptions as ar, VideoComponent as as, type VrTeleportShape as at, XRAnchorComponent as au, type XRAnchorOptions as av, XRHandPoseComponent as aw, type XRHandPoseOptions as ax, XRInteractableComponent as ay, type XRInteractableOptions as az, AudioComponent as b, type StateMachine as b0, type UiColorStop as b1, type UiPaint as b2, type UiShadow as b3, type UiStyle as b4, type UiTextStyle as b5, type UiTokens as b6, 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 };
+export { ScriptObjectComponent as $, AnimationComponent as A, MaterialComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MaterialTypeValue as F, type MaterialValueState as G, MeshComponent as H, ImageComponent as I, MeshGeometryComponent as J, type MeshGeometryParameters as K, LightComponent as L, MODEL_NO_PATH_MESSAGE as M, type MeshGeometryParametersByKind as N, ModelComponent as O, type ModelLoadState as P, Name as Q, Object3DRef as R, PhysicsComponent as S, type PhysicsState as T, type PlaneMeshParameters as U, type RadiusHeightMeshParameters as V, type RadiusMeshParameters as W, type RigidbodyState as X, type RigidbodyType as Y, ScriptComponent as Z, type ScriptEntry as _, type AnimationComponentOptions as a, type UiColorStop as a$, type ScriptObjectComponentInput as a0, type ScriptObjectRuntimeState as a1, Selectable as a2, SelectionTransformState as a3, SpriteComponent as a4, type TextureFilteringValue as a5, type TransformModeValue as a6, type TransformSpaceValue as a7, UIButtonComponent as a8, type UIButtonOptions as a9, XRInteractorSideComponent as aA, XRRigComponent as aB, type XRRigOptions as aC, type XrAttachPoint as aD, type XrDistanceGrabBehavior as aE, type XrEnvironmentPhysics as aF, type XrGrabGesture as aG, type XrGrabHands as aH, type XrGrabReach as aI, type XrHandPoseEntry as aJ, type XrHandPreset as aK, type XrInteractorSide as aL, type XrInteractorType as aM, type XrLocomotionMode as aN, type XrTrackingOrigin as aO, type XrTwoHandRotation as aP, createAttachPoint as aQ, createHandPoseEntry as aR, defaultMaterialValue as aS, handPoseDefinitionFor as aT, normalizePhysicsState as aU, setModelLoadState as aV, setPhysicsLiveRef as aW, type AnimationStateCallbacks as aX, AnimationStateMachine as aY, AnimationStateManager as aZ, type StateMachine as a_, UIPanelComponent as aa, type UIPanelOptions as ab, UISliderComponent as ac, type UISliderOptions as ad, UITextComponent as ae, type UITextOptions as af, UIToggleComponent as ag, type UIToggleOptions as ah, type UiFollowMode as ai, type UiIconPosition as aj, type UiSliderVariant as ak, type UiTextAlign as al, type UiTextVAlign as am, type UiToggleVariant as an, VRTeleportAreaComponent as ao, type VRTeleportAreaOptions as ap, VideoComponent as aq, type VrTeleportShape as ar, XRAnchorComponent as as, type XRAnchorOptions as at, XRHandPoseComponent as au, type XRHandPoseOptions as av, XRInteractableComponent as aw, type XRInteractableOptions as ax, XRInteractorComponent as ay, type XRInteractorOptions as az, AudioComponent as b, type UiPaint as b0, type UiShadow as b1, type UiStyle as b2, type UiTextStyle as b3, type UiTokens as b4, 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 LightShadowState as y, type LightValueState as z };

package/dist/{XRHandPose-BNSwd1y9.d.ts → XRHandPose-CxXtWF1y.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { d as Component, aa as AudioBus, a5 as EcsEntityKind, al as EcsEntityEditorKind, X as EntityId } from './System-CADhPyQs.js';
+import { d as Component, ae as AudioBus, a9 as EcsEntityKind, ap as EcsEntityEditorKind, $ as EntityId } from './System-ttkDQCrj.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';
 
@@ -1624,45 +1624,6 @@ 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);
-}
-
 /**
  * The style model for spatial UI.
  *
@@ -2186,4 +2147,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-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, AnimationStateManager 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, XRInteractorComponent as aA, type XRInteractorOptions as aB, XRInteractorSideComponent as aC, XRRigComponent as aD, type XRRigOptions as aE, type XrAttachPoint as aF, type XrDistanceGrabBehavior as aG, type XrEnvironmentPhysics as aH, type XrGrabGesture as aI, type XrGrabHands as aJ, type XrGrabReach as aK, type XrHandPoseEntry as aL, type XrHandPreset as aM, type XrInteractorSide as aN, type XrInteractorType as aO, type XrLocomotionMode as aP, type XrTrackingOrigin as aQ, type XrTwoHandRotation as aR, createAttachPoint as aS, createHandPoseEntry as aT, defaultMaterialValue as aU, handPoseDefinitionFor as aV, normalizePhysicsState as aW, setModelLoadState as aX, setPhysicsLiveRef as aY, type AnimationStateCallbacks as aZ, AnimationStateMachine as a_, 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 UiIconPosition as al, type UiSliderVariant as am, type UiTextAlign as an, type UiTextVAlign as ao, type UiToggleVariant as ap, VRTeleportAreaComponent as aq, type VRTeleportAreaOptions as ar, VideoComponent as as, type VrTeleportShape as at, XRAnchorComponent as au, type XRAnchorOptions as av, XRHandPoseComponent as aw, type XRHandPoseOptions as ax, XRInteractableComponent as ay, type XRInteractableOptions as az, AudioComponent as b, type StateMachine as b0, type UiColorStop as b1, type UiPaint as b2, type UiShadow as b3, type UiStyle as b4, type UiTextStyle as b5, type UiTokens as b6, 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 };
+export { ScriptObjectComponent as $, AnimationComponent as A, MaterialComponent as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, type MaterialTypeValue as F, type MaterialValueState as G, MeshComponent as H, ImageComponent as I, MeshGeometryComponent as J, type MeshGeometryParameters as K, LightComponent as L, MODEL_NO_PATH_MESSAGE as M, type MeshGeometryParametersByKind as N, ModelComponent as O, type ModelLoadState as P, Name as Q, Object3DRef as R, PhysicsComponent as S, type PhysicsState as T, type PlaneMeshParameters as U, type RadiusHeightMeshParameters as V, type RadiusMeshParameters as W, type RigidbodyState as X, type RigidbodyType as Y, ScriptComponent as Z, type ScriptEntry as _, type AnimationComponentOptions as a, type UiColorStop as a$, type ScriptObjectComponentInput as a0, type ScriptObjectRuntimeState as a1, Selectable as a2, SelectionTransformState as a3, SpriteComponent as a4, type TextureFilteringValue as a5, type TransformModeValue as a6, type TransformSpaceValue as a7, UIButtonComponent as a8, type UIButtonOptions as a9, XRInteractorSideComponent as aA, XRRigComponent as aB, type XRRigOptions as aC, type XrAttachPoint as aD, type XrDistanceGrabBehavior as aE, type XrEnvironmentPhysics as aF, type XrGrabGesture as aG, type XrGrabHands as aH, type XrGrabReach as aI, type XrHandPoseEntry as aJ, type XrHandPreset as aK, type XrInteractorSide as aL, type XrInteractorType as aM, type XrLocomotionMode as aN, type XrTrackingOrigin as aO, type XrTwoHandRotation as aP, createAttachPoint as aQ, createHandPoseEntry as aR, defaultMaterialValue as aS, handPoseDefinitionFor as aT, normalizePhysicsState as aU, setModelLoadState as aV, setPhysicsLiveRef as aW, type AnimationStateCallbacks as aX, AnimationStateMachine as aY, AnimationStateManager as aZ, type StateMachine as a_, UIPanelComponent as aa, type UIPanelOptions as ab, UISliderComponent as ac, type UISliderOptions as ad, UITextComponent as ae, type UITextOptions as af, UIToggleComponent as ag, type UIToggleOptions as ah, type UiFollowMode as ai, type UiIconPosition as aj, type UiSliderVariant as ak, type UiTextAlign as al, type UiTextVAlign as am, type UiToggleVariant as an, VRTeleportAreaComponent as ao, type VRTeleportAreaOptions as ap, VideoComponent as aq, type VrTeleportShape as ar, XRAnchorComponent as as, type XRAnchorOptions as at, XRHandPoseComponent as au, type XRHandPoseOptions as av, XRInteractableComponent as aw, type XRInteractableOptions as ax, XRInteractorComponent as ay, type XRInteractorOptions as az, AudioComponent as b, type UiPaint as b0, type UiShadow as b1, type UiStyle as b2, type UiTextStyle as b3, type UiTokens as b4, 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 LightShadowState as y, type LightValueState as z };

package/dist/animation/index.cjs

@@ -46,6 +46,7 @@ function restPositions(root) {
   return out;
 }
 __name(restPositions, "restPositions");
+var NUMBERED_NAME = /_\d+$/;
 function splitBoneName(raw) {
   let n = raw.replace(/^.*[:|]/, "").replace(/^(mixamorig\d*|def[-_]|org[-_]|mch[-_]|bip\d*[ _]|b[-_])/i, "").trim();
   let side = null;
@@ -147,6 +148,37 @@ function findHips(root) {
 __name(findHips, "findHips");
 var isSpineLike = /* @__PURE__ */ __name((base) => /^(spine|chest|upperchest|torso|back)\d*$/.test(base), "isSpineLike");
 function detectRig(root) {
+  const plain = readRig(root);
+  if (plain.missing.length === 0) return plain;
+  const stems = /* @__PURE__ */ new Map();
+  const count = /* @__PURE__ */ __name((n) => {
+    const stem = n.name.replace(NUMBERED_NAME, "");
+    stems.set(stem, (stems.get(stem) ?? 0) + 1);
+    n.children.forEach(count);
+  }, "count");
+  count(root);
+  const real = /* @__PURE__ */ new Map();
+  const strip = /* @__PURE__ */ __name((n) => {
+    const stem = n.name.replace(NUMBERED_NAME, "");
+    const name = stems.get(stem) === 1 ? stem : n.name;
+    real.set(name, n.name);
+    return { ...n, name, children: n.children.map(strip) };
+  }, "strip");
+  const found = readRig(strip(root));
+  if (found.missing.length >= plain.missing.length) return plain;
+  const realName = /* @__PURE__ */ __name((name) => real.get(name) ?? name, "realName");
+  const bones = {};
+  for (const [bone, name] of Object.entries(found.bones)) {
+    bones[bone] = realName(name);
+  }
+  return {
+    ...found,
+    bones,
+    byName: new Map([...found.byName].map(([name, bone]) => [realName(name), bone]))
+  };
+}
+__name(detectRig, "detectRig");
+function readRig(root) {
   const all = [];
   const collect = /* @__PURE__ */ __name((n) => {
     all.push(n);
@@ -220,7 +252,7 @@ function detectRig(root) {
     missing: REQUIRED_HUMANOID_BONES.filter((b) => !bones[b])
   };
 }
-__name(detectRig, "detectRig");
+__name(readRig, "readRig");
 function mirrorHumanoidBone(b) {
   if (b.startsWith("left")) return `right${b.slice(4)}`;
   if (b.startsWith("right")) return `left${b.slice(5)}`;