@directivegames/genesys.js 3.1.24

package/dist/src/animation/AnimationRetargeting.js

@@ -0,0 +1,455 @@
+/**
+ * AnimationRetargeting - runtime animation retargeting between different skeleton conventions.
+ *
+ * Uses the UPF GTI AnimationRetargeting algorithm which handles bind pose differences
+ * between skeletons through quaternion space transformations.
+ *
+ * Retargets animation clips from one skeleton format to another using explicit semantic
+ * bone mappings defined in SkeletonProfiles. This enables using animations from external
+ * sources (Mixamo, UE5, etc.) on characters with different bone naming conventions.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Define source and target profiles explicitly in AnimationStateMachineConfig
+ * - Profiles are loaded from JSON assets or referenced by name
+ * - Retargeting happens automatically during external animation loading
+ */
+import * as THREE from 'three';
+import { applyTPose as applyTPoseInternal, AnimationRetargeting as UPFRetargeting } from './retargeting.js';
+// Re-export for external use
+export { applyTPoseInternal as applyTPose };
+import { BoneRole } from './SkeletonProfile.js';
+/** Default name for synthetic root bones */
+const SYNTHETIC_ROOT_BONE_NAME = 'syntheticRoot';
+/**
+ * Add a synthetic root bone to a skeleton that doesn't have one.
+ *
+ * This modifies the skeleton in-place by:
+ * 1. Creating a new root bone at ground level (0,0,0)
+ * 2. Reparenting the current root (typically hips) to be a child of the new root
+ * 3. Rebuilding the skeleton's bone array and inverse bind matrices
+ *
+ * @param skeleton - The skeleton to modify (will be modified in-place)
+ * @param skinnedMesh - The skinned mesh using this skeleton (will be updated)
+ * @param profile - The skeleton profile (will be cloned and updated)
+ * @param rootBoneName - Name for the synthetic root bone
+ * @returns Result containing the modified skeleton and updated profile
+ */
+export function addSyntheticRootBone(skeleton, skinnedMesh, profile, rootBoneName = SYNTHETIC_ROOT_BONE_NAME) {
+    // Don't add if skeleton already has a root bone
+    const existingRootBone = Object.entries(profile.boneToRole)
+        .find(([, role]) => role === BoneRole.Root);
+    if (existingRootBone) {
+        console.warn(`[AnimationRetargeting] Skeleton already has a root bone: ${existingRootBone[0]}`);
+        return { skeleton, rootBoneName: existingRootBone[0], updatedProfile: profile };
+    }
+    const oldBones = skeleton.bones;
+    if (oldBones.length === 0) {
+        throw new Error('[AnimationRetargeting] Cannot add synthetic root to empty skeleton');
+    }
+    // Find the current root bone (the one with no parent in the skeleton)
+    const currentRoot = oldBones[0];
+    // Store the current root's parent (if any, typically the armature or model)
+    const originalParent = currentRoot.parent;
+    // Create synthetic root bone at local origin
+    const syntheticRoot = new THREE.Bone();
+    syntheticRoot.name = rootBoneName;
+    syntheticRoot.position.set(0, 0, 0);
+    syntheticRoot.quaternion.identity();
+    syntheticRoot.scale.set(1, 1, 1);
+    // Reparent: synthetic root becomes parent of current root
+    // Keep hips' local transform unchanged - it becomes relative to synthetic root
+    if (originalParent) {
+        originalParent.remove(currentRoot);
+        originalParent.add(syntheticRoot);
+    }
+    syntheticRoot.add(currentRoot);
+    // Update world matrices
+    syntheticRoot.updateMatrixWorld(true);
+    // Build new bone array with synthetic root at index 0
+    const newBones = [syntheticRoot, ...oldBones];
+    // CRITICAL: Update skin indices in the geometry
+    // Since we inserted a bone at index 0, all existing bone indices must shift by +1
+    const geometry = skinnedMesh.geometry;
+    const skinIndexAttr = geometry.getAttribute('skinIndex');
+    if (skinIndexAttr) {
+        const skinIndices = skinIndexAttr.array;
+        for (let i = 0; i < skinIndices.length; i++) {
+            skinIndices[i] += 1;
+        }
+        skinIndexAttr.needsUpdate = true;
+    }
+    // Preserve original boneInverses and prepend identity for synthetic root
+    // The synthetic root is at origin with identity rotation, so its inverse is identity
+    const syntheticRootInverse = new THREE.Matrix4(); // identity
+    const newBoneInverses = [syntheticRootInverse, ...skeleton.boneInverses];
+    // Create new skeleton with preserved boneInverses
+    const newSkeleton = new THREE.Skeleton(newBones, newBoneInverses);
+    // Update the skinned mesh to use the new skeleton
+    skinnedMesh.bind(newSkeleton, skinnedMesh.bindMatrix);
+    // Create updated profile with synthetic root mapping
+    const updatedProfile = {
+        ...profile,
+        boneToRole: {
+            [rootBoneName]: BoneRole.Root,
+            ...profile.boneToRole
+        }
+    };
+    console.log(`[AnimationRetargeting] Added synthetic root bone "${rootBoneName}" to skeleton. ` +
+        `New bone count: ${newBones.length}`);
+    return {
+        skeleton: newSkeleton,
+        rootBoneName,
+        updatedProfile
+    };
+}
+/**
+ * Check if a skeleton needs a synthetic root bone for retargeting from a source that has one.
+ */
+export function needsSyntheticRoot(sourceProfile, targetProfile) {
+    const sourceHasRoot = Object.values(sourceProfile.boneToRole).includes(BoneRole.Root);
+    const targetHasRoot = Object.values(targetProfile.boneToRole).includes(BoneRole.Root);
+    return sourceHasRoot && !targetHasRoot;
+}
+/**
+ * Add getBoneByName helper to skeleton if it doesn't exist
+ */
+function ensureGetBoneByName(skeleton) {
+    if (!skeleton.getBoneByName) {
+        skeleton.getBoneByName = function (name) {
+            return this.bones.find((b) => b.name === name);
+        };
+    }
+}
+/**
+ * Convert SkeletonProfile to the format applyTPose expects
+ */
+function profileToTPoseMap(profile) {
+    // Invert boneToRole to get roleToName
+    const roleToName = {};
+    for (const [boneName, role] of Object.entries(profile.boneToRole)) {
+        roleToName[role] = boneName;
+    }
+    // Map to the semantic keys applyTPose expects
+    return {
+        Hips: roleToName[BoneRole.Hips],
+        Stomach: roleToName[BoneRole.Spine],
+        ShouldersUnion: roleToName[BoneRole.Chest] ?? roleToName[BoneRole.UpperChest],
+        Neck: roleToName[BoneRole.Neck],
+        Head: roleToName[BoneRole.Head],
+        LShoulder: roleToName[BoneRole.LeftShoulder],
+        LArm: roleToName[BoneRole.LeftUpperArm],
+        LElbow: roleToName[BoneRole.LeftLowerArm],
+        LWrist: roleToName[BoneRole.LeftHand],
+        RShoulder: roleToName[BoneRole.RightShoulder],
+        RArm: roleToName[BoneRole.RightUpperArm],
+        RElbow: roleToName[BoneRole.RightLowerArm],
+        RWrist: roleToName[BoneRole.RightHand],
+        LUpLeg: roleToName[BoneRole.LeftUpperLeg],
+        LLeg: roleToName[BoneRole.LeftLowerLeg],
+        LFoot: roleToName[BoneRole.LeftFoot],
+        LToeBase: roleToName[BoneRole.LeftToeBase],
+        RUpLeg: roleToName[BoneRole.RightUpperLeg],
+        RLeg: roleToName[BoneRole.RightLowerLeg],
+        RFoot: roleToName[BoneRole.RightFoot],
+        RToeBase: roleToName[BoneRole.RightToeBase]
+    };
+}
+/**
+ * Create a bone name mapping between source and target skeletons using their profiles.
+ * Returns an object compatible with UPF AnimationRetargeting: { sourceRole: targetBoneName }
+ */
+export function createBoneMapping(sourceProfile, targetProfile, sourceSkeleton, targetSkeleton) {
+    const mapping = {};
+    // Build reverse map for source: role -> bone name
+    const sourceRoleToBone = new Map();
+    for (const bone of sourceSkeleton.bones) {
+        const role = sourceProfile.boneToRole[bone.name];
+        if (role) {
+            sourceRoleToBone.set(role, bone.name);
+        }
+    }
+    // Build reverse map for target: role -> bone name
+    const targetRoleToBone = new Map();
+    for (const bone of targetSkeleton.bones) {
+        const role = targetProfile.boneToRole[bone.name];
+        if (role) {
+            targetRoleToBone.set(role, bone.name);
+        }
+    }
+    // Map source bones to target bones via semantic roles
+    for (const [role, sourceBoneName] of sourceRoleToBone) {
+        const targetBoneName = targetRoleToBone.get(role);
+        if (targetBoneName) {
+            mapping[sourceBoneName] = targetBoneName;
+        }
+    }
+    // Note: Root motion is dropped when target has no root bone
+    return mapping;
+}
+/**
+ * Retarget an animation clip from source skeleton to target skeleton using UPF GTI retargeting.
+ *
+ * @param sourceClip - The animation clip to retarget
+ * @param sourceProfile - Skeleton profile for the source animation
+ * @param targetProfile - Skeleton profile for the target character
+ * @param sourceSkeleton - Source skeleton (from the animation's original GLTF)
+ * @param targetSkeleton - Target skeleton (from the character being animated)
+ * @param targetSkinnedMesh - Target skinned mesh (required by Three.js retargeting)
+ * @returns Retargeted animation clip, or null if retargeting failed
+ */
+export function retargetAnimationClip(sourceClip, sourceProfile, targetProfile, sourceSkeleton, targetSkeleton, targetSkinnedMesh) {
+    // Build reverse map for source: role -> bone name
+    const sourceRoleToBone = new Map();
+    for (const bone of sourceSkeleton.bones) {
+        const role = sourceProfile.boneToRole[bone.name];
+        if (role) {
+            sourceRoleToBone.set(role, bone.name);
+        }
+    }
+    // Create bone mapping using our profile system
+    const boneMapping = createBoneMapping(sourceProfile, targetProfile, sourceSkeleton, targetSkeleton);
+    if (Object.keys(boneMapping).length === 0) {
+        console.error('[AnimationRetargeting] Failed to create bone mapping - no bones matched');
+        return null;
+    }
+    try {
+        // Add getBoneByName helper method required by applyTPose
+        ensureGetBoneByName(sourceSkeleton);
+        ensureGetBoneByName(targetSkeleton);
+        // Convert our profiles to the format applyTPose expects
+        const sourceTPoseMap = profileToTPoseMap(sourceProfile);
+        const targetTPoseMap = profileToTPoseMap(targetProfile);
+        // Apply T-Pose to both skeletons for consistent bind poses
+        try {
+            const sourceTPose = applyTPoseInternal(sourceSkeleton, sourceTPoseMap);
+            const targetTPose = applyTPoseInternal(targetSkeleton, targetTPoseMap);
+            // Create UPF retargeting instance using CURRENT pose mode to capture the T-Poses
+            const retargeter = new UPFRetargeting(sourceTPose.skeleton, targetTPose.skeleton, {
+                boneNameMap: boneMapping,
+                srcPoseMode: UPFRetargeting.BindPoseModes.CURRENT,
+                trgPoseMode: UPFRetargeting.BindPoseModes.CURRENT,
+                srcEmbedWorldTransforms: true,
+                trgEmbedWorldTransforms: true,
+                positionAxisFlips: targetProfile.positionAxisFlips,
+                hipsPositionAxisFlips: targetProfile.hipsPositionAxisFlips
+            });
+            // Retarget the animation
+            const retargetedClip = retargeter.retargetAnimation(sourceClip);
+            if (!retargetedClip || retargetedClip.tracks.length === 0) {
+                console.error(`[AnimationRetargeting] Failed to retarget "${sourceClip.name}": no tracks generated`);
+                return null;
+            }
+            // CRITICAL: Remove scale tracks to prevent shrinking/deformation
+            const originalTrackCount = retargetedClip.tracks.length;
+            retargetedClip.tracks = retargetedClip.tracks.filter(track => {
+                return !track.name.endsWith('.scale');
+            });
+            // Handle root motion incompatibility between source and target
+            const sourceRootBoneName = sourceRoleToBone.get(BoneRole.Root);
+            const targetRootBoneName = targetProfile.boneToRole[targetSkeleton.bones[0]?.name];
+            const targetHipsBoneName = Array.from(Object.entries(targetProfile.boneToRole))
+                .find(([, role]) => role === BoneRole.Hips)?.[0];
+            // Case 1: Source has no root bone but target does
+            // Mixamo hips position tracks should NOT be applied to Rigify hips (child of root)
+            if (!sourceRootBoneName && targetRootBoneName === BoneRole.Root && targetHipsBoneName) {
+                const hipsPositionTrackIndex = retargetedClip.tracks.findIndex(track => track.name.includes(targetHipsBoneName) && track.name.endsWith('.position'));
+                if (hipsPositionTrackIndex !== -1) {
+                    retargetedClip.tracks.splice(hipsPositionTrackIndex, 1);
+                    console.warn(`[AnimationRetargeting] Removed hips position track from "${sourceClip.name}" ` +
+                        'because source skeleton lacks a root bone (Mixamo) but target has one (Rigify).');
+                }
+            }
+            // Case 2: Source has root motion but target doesn't
+            const sourceHasRootMotion = sourceRootBoneName &&
+                sourceClip.tracks.some(track => track.name.includes(sourceRootBoneName) && track.name.endsWith('.position'));
+            if (sourceHasRootMotion && targetRootBoneName !== BoneRole.Root) {
+                console.warn(`[AnimationRetargeting] Source animation "${sourceClip.name}" contains root motion. ` +
+                    'Root motion tracks are not transferred when target skeleton lacks a root bone. ' +
+                    'Consider implementing root motion extraction to model transform.');
+            }
+            // Reset all bone scales to (1,1,1) to prevent accumulated scale issues
+            targetSkeleton.bones.forEach(bone => {
+                bone.scale.set(1, 1, 1);
+            });
+            targetSkeleton.update();
+            return retargetedClip;
+        }
+        catch (tPoseError) {
+            console.error('[AnimationRetargeting] T-Pose failed, falling back to default bind poses:', tPoseError);
+            // Fallback: use default bind poses without T-Pose
+            const retargeter = new UPFRetargeting(sourceSkeleton, targetSkeleton, {
+                boneNameMap: boneMapping,
+                srcPoseMode: UPFRetargeting.BindPoseModes.DEFAULT,
+                trgPoseMode: UPFRetargeting.BindPoseModes.DEFAULT,
+                positionAxisFlips: targetProfile.positionAxisFlips,
+                hipsPositionAxisFlips: targetProfile.hipsPositionAxisFlips
+            });
+            // Retarget the animation
+            const retargetedClip = retargeter.retargetAnimation(sourceClip);
+            if (!retargetedClip || retargetedClip.tracks.length === 0) {
+                console.error(`[AnimationRetargeting] Failed to retarget "${sourceClip.name}": no tracks generated`);
+                return null;
+            }
+            // CRITICAL: Remove scale tracks to prevent shrinking/deformation
+            retargetedClip.tracks = retargetedClip.tracks.filter(track => {
+                return !track.name.endsWith('.scale');
+            });
+            targetSkeleton.bones.forEach(bone => {
+                bone.scale.set(1, 1, 1);
+            });
+            targetSkeleton.update();
+            return retargetedClip;
+        }
+    }
+    catch (error) {
+        console.error(`[AnimationRetargeting] Failed to retarget "${sourceClip.name}":`, error);
+        return null;
+    }
+}
+/**
+ * A reusable retargeting session that initializes T-poses once and can retarget multiple clips.
+ * This is more efficient than calling retargetAnimationClip for each clip individually.
+ */
+export class RetargetingSession {
+    constructor(sourceProfile, targetProfile, sourceSkeleton, targetSkeleton) {
+        Object.defineProperty(this, "retargeter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "sourceRoleToBone", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "targetProfile", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "targetSkeleton", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "initialized", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.targetProfile = targetProfile;
+        this.targetSkeleton = targetSkeleton;
+        // Build reverse map for source: role -> bone name
+        for (const bone of sourceSkeleton.bones) {
+            const role = sourceProfile.boneToRole[bone.name];
+            if (role) {
+                this.sourceRoleToBone.set(role, bone.name);
+            }
+        }
+        // Create bone mapping
+        const boneMapping = createBoneMapping(sourceProfile, targetProfile, sourceSkeleton, targetSkeleton);
+        if (Object.keys(boneMapping).length === 0) {
+            console.error('[RetargetingSession] Failed to create bone mapping - no bones matched');
+            return;
+        }
+        // Add getBoneByName helper
+        ensureGetBoneByName(sourceSkeleton);
+        ensureGetBoneByName(targetSkeleton);
+        // Convert profiles to T-pose map format
+        const sourceTPoseMap = profileToTPoseMap(sourceProfile);
+        const targetTPoseMap = profileToTPoseMap(targetProfile);
+        // Apply T-Pose ONCE to both skeletons
+        try {
+            // const sourceTPose = applyTPoseInternal(sourceSkeleton, sourceTPoseMap);
+            // const targetTPose = applyTPoseInternal(targetSkeleton, targetTPoseMap);
+            // Create retargeter instance ONCE
+            this.retargeter = new UPFRetargeting(sourceSkeleton, targetSkeleton, {
+                boneNameMap: boneMapping,
+                srcPoseMode: UPFRetargeting.BindPoseModes.CURRENT,
+                trgPoseMode: UPFRetargeting.BindPoseModes.CURRENT,
+                srcEmbedWorldTransforms: true,
+                trgEmbedWorldTransforms: true,
+                positionAxisFlips: targetProfile.positionAxisFlips,
+                hipsPositionAxisFlips: targetProfile.hipsPositionAxisFlips
+            });
+            this.initialized = true;
+            console.log('[RetargetingSession] Initialized with T-poses applied once');
+        }
+        catch (error) {
+            console.error('[RetargetingSession] Failed to initialize:', error);
+        }
+    }
+    /**
+     * Retarget a single clip using the pre-initialized session.
+     */
+    retargetClip(sourceClip) {
+        if (!this.initialized || !this.retargeter) {
+            console.error('[RetargetingSession] Session not initialized');
+            return null;
+        }
+        try {
+            const retargetedClip = this.retargeter.retargetAnimation(sourceClip);
+            if (!retargetedClip || retargetedClip.tracks.length === 0) {
+                console.error(`[RetargetingSession] Failed to retarget "${sourceClip.name}": no tracks generated`);
+                return null;
+            }
+            // Remove scale tracks
+            retargetedClip.tracks = retargetedClip.tracks.filter(track => !track.name.endsWith('.scale'));
+            // Handle root motion incompatibility
+            const sourceRootBoneName = this.sourceRoleToBone.get(BoneRole.Root);
+            const targetRootBoneName = this.targetProfile.boneToRole[this.targetSkeleton.bones[0]?.name];
+            const targetHipsBoneName = Array.from(Object.entries(this.targetProfile.boneToRole))
+                .find(([, role]) => role === BoneRole.Hips)?.[0];
+            if (!sourceRootBoneName && targetRootBoneName === BoneRole.Root && targetHipsBoneName) {
+                const hipsPositionTrackIndex = retargetedClip.tracks.findIndex(track => track.name.includes(targetHipsBoneName) && track.name.endsWith('.position'));
+                if (hipsPositionTrackIndex !== -1) {
+                    retargetedClip.tracks.splice(hipsPositionTrackIndex, 1);
+                }
+            }
+            return retargetedClip;
+        }
+        catch (error) {
+            console.error(`[RetargetingSession] Failed to retarget "${sourceClip.name}":`, error);
+            return null;
+        }
+    }
+    /**
+     * Retarget multiple clips using the pre-initialized session.
+     */
+    retargetClips(sourceClips) {
+        return sourceClips.map(sourceClip => ({
+            clip: this.retargetClip(sourceClip),
+            success: this.retargetClip(sourceClip) !== null,
+            originalName: sourceClip.name
+        }));
+    }
+    isInitialized() {
+        return this.initialized;
+    }
+}
+/**
+ * Batch retarget multiple animation clips.
+ * Uses RetargetingSession internally to apply T-poses only once.
+ */
+export function retargetAnimationClips(sourceClips, sourceProfile, targetProfile, sourceSkeleton, targetSkeleton, _targetSkinnedMesh) {
+    // Create a session that initializes T-poses once
+    const session = new RetargetingSession(sourceProfile, targetProfile, sourceSkeleton, targetSkeleton);
+    if (!session.isInitialized()) {
+        return sourceClips.map(clip => ({ clip: null, success: false, originalName: clip.name }));
+    }
+    // Retarget all clips using the same session
+    return sourceClips.map(sourceClip => {
+        const retargetedClip = session.retargetClip(sourceClip);
+        return {
+            clip: retargetedClip,
+            success: retargetedClip !== null,
+            originalName: sourceClip.name
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQW5pbWF0aW9uUmV0YXJnZXRpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYW5pbWF0aW9uL0FuaW1hdGlvblJldGFyZ2V0aW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBR0gsT0FBTyxLQUFLLEtBQUssTUFBTSxPQUFPLENBQUM7QUFFL0IsT0FBTyxFQUFFLFVBQVUsSUFBSSxrQkFBa0IsRUFBRSxvQkFBb0IsSUFBSSxjQUFjLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM1Ryw2QkFBNkI7QUFDN0IsT0FBTyxFQUFFLGtCQUFrQixJQUFJLFVBQVUsRUFBRSxDQUFDO0FBQzVDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUloRCw0Q0FBNEM7QUFDNUMsTUFBTSx3QkFBd0IsR0FBRyxlQUFlLENBQUM7QUFjakQ7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILE1BQU0sVUFBVSxvQkFBb0IsQ0FDbEMsUUFBd0IsRUFDeEIsV0FBOEIsRUFDOUIsT0FBd0IsRUFDeEIsZUFBdUIsd0JBQXdCO0lBRS9DLGdEQUFnRDtJQUNoRCxNQUFNLGdCQUFnQixHQUFHLE1BQU0sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQztTQUN4RCxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsSUFBSSxDQUFDLEVBQUUsRUFBRSxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDOUMsSUFBSSxnQkFBZ0IsRUFBRSxDQUFDO1FBQ3JCLE9BQU8sQ0FBQyxJQUFJLENBQUMsNERBQTRELGdCQUFnQixDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUNoRyxPQUFPLEVBQUUsUUFBUSxFQUFFLFlBQVksRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDLENBQUMsRUFBRSxjQUFjLEVBQUUsT0FBTyxFQUFFLENBQUM7SUFDbEYsQ0FBQztJQUVELE1BQU0s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

package/dist/src/animation/SkeletonProfile.d.ts

@@ -0,0 +1,112 @@
+/**
+ * SkeletonProfile - defines bone naming conventions for animation retargeting.
+ *
+ * Skeleton profiles map bone names to semantic roles (e.g., "mixamorigHips" -> Hips),
+ * enabling animation retargeting between different skeleton conventions. Profiles can
+ * be loaded from JSON files or defined programmatically.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Store profile JSON files in assets/animation-profiles/
+ * - Reference profiles explicitly in AnimationStateMachineConfig
+ * - Use built-in profiles (Mixamo, UE5, Standard, etc.) or create custom ones
+ */
+/**
+ * Semantic bone roles for humanoid characters.
+ * This is the universal language that different skeletons are mapped to.
+ */
+export declare enum BoneRole {
+    Root = "Root",
+    Hips = "Hips",
+    Spine = "Spine",
+    Chest = "Chest",
+    UpperChest = "UpperChest",
+    Neck = "Neck",
+    Head = "Head",
+    LeftShoulder = "LeftShoulder",
+    LeftUpperArm = "LeftUpperArm",
+    LeftLowerArm = "LeftLowerArm",
+    LeftHand = "LeftHand",
+    RightShoulder = "RightShoulder",
+    RightUpperArm = "RightUpperArm",
+    RightLowerArm = "RightLowerArm",
+    RightHand = "RightHand",
+    LeftUpperLeg = "LeftUpperLeg",
+    LeftLowerLeg = "LeftLowerLeg",
+    LeftFoot = "LeftFoot",
+    LeftToeBase = "LeftToeBase",
+    RightUpperLeg = "RightUpperLeg",
+    RightLowerLeg = "RightLowerLeg",
+    RightFoot = "RightFoot",
+    RightToeBase = "RightToeBase",
+    LeftHandThumb1 = "LeftHandThumb1",
+    LeftHandThumb2 = "LeftHandThumb2",
+    LeftHandThumb3 = "LeftHandThumb3",
+    LeftHandIndex1 = "LeftHandIndex1",
+    LeftHandIndex2 = "LeftHandIndex2",
+    LeftHandIndex3 = "LeftHandIndex3",
+    LeftHandMiddle1 = "LeftHandMiddle1",
+    LeftHandMiddle2 = "LeftHandMiddle2",
+    LeftHandMiddle3 = "LeftHandMiddle3",
+    LeftHandRing1 = "LeftHandRing1",
+    LeftHandRing2 = "LeftHandRing2",
+    LeftHandRing3 = "LeftHandRing3",
+    LeftHandPinky1 = "LeftHandPinky1",
+    LeftHandPinky2 = "LeftHandPinky2",
+    LeftHandPinky3 = "LeftHandPinky3",
+    RightHandThumb1 = "RightHandThumb1",
+    RightHandThumb2 = "RightHandThumb2",
+    RightHandThumb3 = "RightHandThumb3",
+    RightHandIndex1 = "RightHandIndex1",
+    RightHandIndex2 = "RightHandIndex2",
+    RightHandIndex3 = "RightHandIndex3",
+    RightHandMiddle1 = "RightHandMiddle1",
+    RightHandMiddle2 = "RightHandMiddle2",
+    RightHandMiddle3 = "RightHandMiddle3",
+    RightHandRing1 = "RightHandRing1",
+    RightHandRing2 = "RightHandRing2",
+    RightHandRing3 = "RightHandRing3",
+    RightHandPinky1 = "RightHandPinky1",
+    RightHandPinky2 = "RightHandPinky2",
+    RightHandPinky3 = "RightHandPinky3",
+    RightEye = "RightEye",
+    LeftEye = "LeftEye",
+    Jaw = "Jaw"
+}
+/**
+ * Axis flip configuration for position retargeting.
+ * Used to handle coordinate system differences between skeletons.
+ */
+export interface PositionAxisFlips {
+    /** Flip X axis for root motion */
+    x?: boolean;
+    /** Flip Y axis for root motion */
+    y?: boolean;
+    /** Flip Z axis for root motion */
+    z?: boolean;
+}
+/**
+ * Skeleton profile - maps bone names to semantic roles.
+ * Can be serialized to/from JSON for asset storage.
+ */
+export interface SkeletonProfile {
+    /** Profile name (e.g., "Mixamo", "UE5", "Standard") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Map bone name -> semantic role */
+    boneToRole: Record<string, BoneRole>;
+    /** Hip bone name (required for retargeting root motion) */
+    hipBoneName: string;
+    /** Optional scale factor for unit conversion (e.g., 0.01 for cm to m) */
+    scale?: number;
+    /**
+     * Optional axis flips for root position retargeting.
+     * Used when this profile is the TARGET to correct coordinate system differences.
+     */
+    positionAxisFlips?: PositionAxisFlips;
+    /**
+     * Optional axis flips for hips position retargeting.
+     * Separate from root because hips may have different coordinate system.
+     */
+    hipsPositionAxisFlips?: PositionAxisFlips;
+}