blacktrigram 0.7.44 → 0.7.45

package/lib/systems/animation/builders/SkeletonRig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SkeletonRig.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/builders/SkeletonRig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,QAAQ,IAAI,GAAG,IAAI,EACnB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,eAAY,KACX,IAuBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,QAAO,WAyIpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,kBAAkB,KAC7B,WAoOF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAoF9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,EAyElC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,IAAI,EACV,YAAY,eAAe,KAC1B,IAkBF,CAAC;AAOF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,KAAG,KAAK,CAAC,OA0BvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,KAAG,KAAK,CAAC,KAsBvD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,IAAI,KAAG,IAIhD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,WAAW,KAAG,IAIrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,IAAI,EACd,MAAM,MAAM,GAAG,OAAO,KACrB,GAAG,CAAC,MAAM,EAAE,IAAI,CAiMlB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GACrC,mBAAkB,OAAe,KAChC,WAkCF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,KAAK,CAAC,OAAO,EAC9B,gBAAgB,EAAE,KAAK,CAAC,OAAO,EAC/B,kBAAkB,EAAE,KAAK,CAAC,OAAO,EACjC,WAAW,EAAE,MAAM,GAClB,MAAM,CA0BR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAC1C,MAAM,CAeR"}
+{"version":3,"file":"SkeletonRig.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/builders/SkeletonRig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,QAAQ,IAAI,GAAG,IAAI,EACnB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,eAAY,KACX,IAuBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,QAAO,WAyIpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,kBAAkB,KAC7B,WAoOF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAoF9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,EAyElC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,IAAI,EACV,YAAY,eAAe,KAC1B,IAkBF,CAAC;AAOF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,KAAG,KAAK,CAAC,OA0BvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,KAAG,KAAK,CAAC,KAsBvD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,IAAI,KAAG,IAIhD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,WAAW,KAAG,IAIrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,IAAI,EACd,MAAM,MAAM,GAAG,OAAO,KACrB,GAAG,CAAC,MAAM,EAAE,IAAI,CAiMlB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GACrC,mBAAkB,OAAe,KAChC,WAkCF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,KAAK,CAAC,OAAO,EAC9B,gBAAgB,EAAE,KAAK,CAAC,OAAO,EAC/B,kBAAkB,EAAE,KAAK,CAAC,OAAO,EACjC,WAAW,EAAE,MAAM,GAClB,MAAM,CA0BR;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAC1C,MAAM,CAeR"}

package/lib/systems/animation/builders/SkeletonRig.js

@@ -89,7 +89,6 @@ var createBone = (name, parent, position, length = .1) => {
 * // Height: 188cm, Legs: 100cm, Arms: 84cm, Shoulders: 54cm (25% wider!)
 * ```
 *
-* @public
 * @korean 크기조정된인간형골격생성
 */
 var createScaledHumanoidRig = (attributes) => {
@@ -287,7 +286,6 @@ new THREE.Vector3();
 * - 허리회전 (Heorhwoejeon) - Torso rotation
 * - 해부학적제약 (Haebuhakjeok Jeyak) - Anatomical constraints
 *
-* @public
 * @korean 허리회전제약조건
 */
 var TORSO_CONSTRAINTS = {
@@ -342,7 +340,6 @@ var TORSO_CONSTRAINTS = {
 * // Returns 1.05 (5% damage bonus)
 * ```
 *
-* @public
 * @korean 허리회전으로인한데미지배율계산
 */
 function calculateHipRotationPowerModifier(hipRotationAngle, techniqueType) {

package/lib/systems/animation/builders/SkeletonRig.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkeletonRig.js","names":[],"sources":["../../../../src/systems/animation/builders/SkeletonRig.ts"],"sourcesContent":["/**\n * Skeleton rig implementation for articulated body model\n *\n * Creates and manages humanoid skeletal rig with 28 bones for realistic\n * martial arts animations. Implements bone hierarchy following Korean martial\n * arts body mechanics.\n *\n * Now supports dynamic scaling based on player physical attributes for\n * anatomically accurate body proportions per archetype.\n *\n * @module systems/animation/SkeletonRig\n * @category Animation System\n * @korean 골격시스템\n */\n\nimport { PhysicalAttributes } from \"@/types/common\";\nimport type {\n  Bone,\n  BoneChain,\n  JointConstraint,\n  SkeletalRig,\n} from \"@/types/skeletal\";\nimport { BoneName } from \"@/types/skeletal\";\nimport {\n  calculateSkeletonDimensions,\n  cmToMeters,\n} from \"@/utils/characterScaling\";\nimport * as THREE from \"three\";\n\n/**\n * Create a bone with default rest pose\n *\n * Helper function to create a bone with position, rotation, and scale.\n * Sets up rest pose for animation blending.\n *\n * @param name - Unique bone identifier\n * @param parent - Parent bone (null for root)\n * @param position - Local position relative to parent [x, y, z]\n * @param length - Bone length for rendering\n * @returns Newly created bone\n *\n * @korean 뼈생성\n */\nexport const createBone = (\n  name: string,\n  parent: Bone | null,\n  position: [number, number, number],\n  length = 0.1,\n): Bone => {\n  const pos = new THREE.Vector3(position[0], position[1], position[2]);\n  const rot = new THREE.Euler(0, 0, 0);\n  const scale = new THREE.Vector3(1, 1, 1);\n\n  const bone: Bone = {\n    name,\n    parent,\n    position: pos.clone(),\n    rotation: rot.clone(),\n    scale: scale.clone(),\n    children: [],\n    length,\n    restPosition: pos.clone(),\n    restRotation: rot.clone(),\n  };\n\n  // Add to parent's children\n  if (parent) {\n    parent.children.push(bone);\n  }\n\n  return bone;\n};\n\n/**\n * Create complete humanoid skeletal rig\n *\n * Creates 28-bone humanoid skeleton following Korean martial arts anatomy:\n * - 1 root (pelvis)\n * - 3 spine bones\n * - 2 head bones (neck, head)\n * - 12 arm bones (6 per arm)\n * - 10 leg bones (5 per leg)\n *\n * Total: 28 bones (under 30 bone limit for 60fps performance)\n *\n * @returns Complete skeletal rig with bone hierarchy\n *\n * @example\n * ```typescript\n * const rig = createHumanoidRig();\n * const rightHand = rig.bones.get(BoneName.HAND_R);\n * console.log(`Hand position: ${rightHand?.position}`);\n * ```\n *\n * @korean 인간형골격생성\n */\nexport const createHumanoidRig = (): SkeletalRig => {\n  // Root (pelvis) - center of mass at hip height\n  // Pelvis height = sum of leg segments (hip + thigh + knee + shin + foot)\n  // = 0.1 + 0.3 + 0.3 + 0.3 + 0.1 = 1.1 to have feet at Y=0\n  const root = createBone(BoneName.PELVIS, null, [0, 1.1, 0], 0.15);\n\n  // Spine chain (3 bones)\n  const spine1 = createBone(BoneName.SPINE_LOWER, root, [0, 0.15, 0], 0.2);\n  const spine2 = createBone(BoneName.SPINE_MIDDLE, spine1, [0, 0.2, 0], 0.2);\n  const spine3 = createBone(BoneName.SPINE_UPPER, spine2, [0, 0.2, 0], 0.2);\n\n  // Head chain (2 bones)\n  const neck = createBone(BoneName.NECK, spine3, [0, 0.15, 0], 0.1);\n  const head = createBone(BoneName.HEAD, neck, [0, 0.2, 0], 0.2);\n\n  // Left arm chain (6 bones)\n  const leftShoulder = createBone(\n    BoneName.SHOULDER_L,\n    spine3,\n    [-0.15, 0.1, 0],\n    0.1,\n  );\n  const leftUpperArm = createBone(\n    BoneName.UPPER_ARM_L,\n    leftShoulder,\n    [-0.15, 0, 0],\n    0.25,\n  );\n  const leftElbow = createBone(\n    BoneName.ELBOW_L,\n    leftUpperArm,\n    [-0.25, 0, 0],\n    0.05,\n  );\n  const leftForearm = createBone(\n    BoneName.FOREARM_L,\n    leftElbow,\n    [-0.25, 0, 0],\n    0.25,\n  );\n  const leftWrist = createBone(\n    BoneName.WRIST_L,\n    leftForearm,\n    [-0.15, 0, 0],\n    0.05,\n  );\n  const leftHand = createBone(BoneName.HAND_L, leftWrist, [-0.08, 0, 0], 0.08);\n\n  // Right arm chain (6 bones - mirror of left)\n  const rightShoulder = createBone(\n    BoneName.SHOULDER_R,\n    spine3,\n    [0.15, 0.1, 0],\n    0.1,\n  );\n  const rightUpperArm = createBone(\n    BoneName.UPPER_ARM_R,\n    rightShoulder,\n    [0.15, 0, 0],\n    0.25,\n  );\n  const rightElbow = createBone(\n    BoneName.ELBOW_R,\n    rightUpperArm,\n    [0.25, 0, 0],\n    0.05,\n  );\n  const rightForearm = createBone(\n    BoneName.FOREARM_R,\n    rightElbow,\n    [0.25, 0, 0],\n    0.25,\n  );\n  const rightWrist = createBone(\n    BoneName.WRIST_R,\n    rightForearm,\n    [0.15, 0, 0],\n    0.05,\n  );\n  const rightHand = createBone(BoneName.HAND_R, rightWrist, [0.08, 0, 0], 0.08);\n\n  // Left leg chain (5 bones)\n  const leftHip = createBone(BoneName.HIP_L, root, [-0.1, -0.1, 0], 0.1);\n  const leftThigh = createBone(BoneName.THIGH_L, leftHip, [0, -0.3, 0], 0.3);\n  const leftKnee = createBone(BoneName.KNEE_L, leftThigh, [0, -0.3, 0], 0.05);\n  const leftShin = createBone(BoneName.SHIN_L, leftKnee, [0, -0.3, 0], 0.3);\n  const leftFoot = createBone(BoneName.FOOT_L, leftShin, [0, -0.1, 0.1], 0.15);\n\n  // Right leg chain (5 bones - mirror of left)\n  const rightHip = createBone(BoneName.HIP_R, root, [0.1, -0.1, 0], 0.1);\n  const rightThigh = createBone(BoneName.THIGH_R, rightHip, [0, -0.3, 0], 0.3);\n  const rightKnee = createBone(BoneName.KNEE_R, rightThigh, [0, -0.3, 0], 0.05);\n  const rightShin = createBone(BoneName.SHIN_R, rightKnee, [0, -0.3, 0], 0.3);\n  const rightFoot = createBone(\n    BoneName.FOOT_R,\n    rightShin,\n    [0, -0.1, 0.1],\n    0.15,\n  );\n\n  // Create bone map for fast lookup\n  const bones = new Map<string, Bone>([\n    [BoneName.PELVIS, root],\n    [BoneName.SPINE_LOWER, spine1],\n    [BoneName.SPINE_MIDDLE, spine2],\n    [BoneName.SPINE_UPPER, spine3],\n    [BoneName.NECK, neck],\n    [BoneName.HEAD, head],\n    [BoneName.SHOULDER_L, leftShoulder],\n    [BoneName.UPPER_ARM_L, leftUpperArm],\n    [BoneName.ELBOW_L, leftElbow],\n    [BoneName.FOREARM_L, leftForearm],\n    [BoneName.WRIST_L, leftWrist],\n    [BoneName.HAND_L, leftHand],\n    [BoneName.SHOULDER_R, rightShoulder],\n    [BoneName.UPPER_ARM_R, rightUpperArm],\n    [BoneName.ELBOW_R, rightElbow],\n    [BoneName.FOREARM_R, rightForearm],\n    [BoneName.WRIST_R, rightWrist],\n    [BoneName.HAND_R, rightHand],\n    [BoneName.HIP_L, leftHip],\n    [BoneName.THIGH_L, leftThigh],\n    [BoneName.KNEE_L, leftKnee],\n    [BoneName.SHIN_L, leftShin],\n    [BoneName.FOOT_L, leftFoot],\n    [BoneName.HIP_R, rightHip],\n    [BoneName.THIGH_R, rightThigh],\n    [BoneName.KNEE_R, rightKnee],\n    [BoneName.SHIN_R, rightShin],\n    [BoneName.FOOT_R, rightFoot],\n  ]);\n\n  return {\n    root,\n    bones,\n    boneCount: bones.size,\n  };\n};\n\n/**\n * Create humanoid rig with dynamic scaling based on physical attributes.\n *\n * **Korean**: 신체 속성 기반 골격 생성 (Physical Attributes-Based Skeleton Creation)\n *\n * Creates a 28-bone humanoid skeleton with bone lengths scaled according to\n * the fighter's physical attributes. This allows each archetype to have\n * anatomically accurate body proportions that affect combat hitboxes, vital\n * point positioning, and visual representation.\n *\n * ## Visual Amplification\n *\n * The scaling system applies amplification factors to create distinct visual\n * silhouettes while maintaining anatomical realism:\n *\n * - **2.5x limb amplification**: Makes reach differences clearly visible\n * - **1.15x shoulder amplification**: Creates recognizable body width differences\n * - **1.5x height amplification**: Subtle overall size differences\n *\n * ### Archetype Silhouettes Created\n *\n * The following table shows the effective shoulder span after amplification\n * (full span = offset * 2). Values show raw attribute → amplified visual span.\n *\n * | Archetype | Shoulders (Raw → Amplified Span) | Height | Silhouette |\n * |-----------|----------------------------------|--------|------------|\n * | Hacker    | 43cm → 49.5cm | 175cm | Compact, narrow |\n * | Amsalja   | 44cm → 50.6cm | 186cm | Tall, lean |\n * | Jeongbo   | 45cm → 51.8cm | 179cm | Balanced |\n * | Musa      | 46cm → 52.9cm | 180cm | Athletic |\n * | Jojik     | 54cm → 62.1cm | 188cm | Massive, wide |\n *\n * Note: Amplified span = raw width * 1.15 (shoulder amplification factor)\n * Percentage differences remain constant, but absolute gaps are amplified:\n * - Raw gap: Jojik (54cm) - Hacker (43cm) = 11cm\n * - Amplified gap: 62.1cm - 49.5cm = 12.6cm (15% larger absolute difference)\n *\n * @param attributes - Physical attributes to scale the skeleton\n * @returns Complete skeletal rig with scaled bone dimensions\n *\n * @example\n * ```typescript\n * import { AMSALJA_PHYSICAL } from \"@/data/archetypePhysicalAttributes\";\n *\n * // Create skeleton for lean assassin archetype\n * const amsaljaRig = createScaledHumanoidRig(AMSALJA_PHYSICAL);\n * // Results in taller skeleton with longer limbs, narrower shoulders\n * // Height: 186cm, Legs: 102cm, Arms: 82cm, Shoulders: 44cm\n *\n * // Create skeleton for heavy brawler archetype\n * const jojikRig = createScaledHumanoidRig(JOJIK_PHYSICAL);\n * // Results in stockier skeleton with wider shoulders, thicker torso\n * // Height: 188cm, Legs: 100cm, Arms: 84cm, Shoulders: 54cm (25% wider!)\n * ```\n *\n * @public\n * @korean 크기조정된인간형골격생성\n */\nexport const createScaledHumanoidRig = (\n  attributes: PhysicalAttributes,\n): SkeletalRig => {\n  // Calculate anatomically correct bone dimensions in meters\n  const dims = calculateSkeletonDimensions(attributes);\n\n  // Calculate shoulder offset (half of shoulder width) in meters\n  const shoulderOffsetMeters = cmToMeters(attributes.shoulderWidth) / 2;\n  const hipOffsetMeters = cmToMeters(attributes.shoulderWidth) * 0.35; // Hips are ~70% of shoulder width\n\n  // Root (pelvis) - position at pelvis height (ground + leg length + foot)\n  // This ensures feet are at Y=0\n  const root = createBone(\n    BoneName.PELVIS,\n    null,\n    [0, dims.pelvisHeight, 0],\n    dims.hip,\n  );\n\n  // Spine chain (3 bones) - using actual torso segment lengths\n  const spine1 = createBone(\n    BoneName.SPINE_LOWER,\n    root,\n    [0, dims.spineLower * 0.5, 0], // Start half a segment up from pelvis\n    dims.spineLower,\n  );\n  const spine2 = createBone(\n    BoneName.SPINE_MIDDLE,\n    spine1,\n    [0, dims.spineMiddle, 0],\n    dims.spineMiddle,\n  );\n  const spine3 = createBone(\n    BoneName.SPINE_UPPER,\n    spine2,\n    [0, dims.spineUpper, 0],\n    dims.spineUpper,\n  );\n\n  // Head chain (2 bones) - using actual neck and head sizes\n  const neck = createBone(\n    BoneName.NECK,\n    spine3,\n    [0, dims.neck * 0.5, 0], // Start from top of spine\n    dims.neck,\n  );\n  const head = createBone(\n    BoneName.HEAD,\n    neck,\n    [0, dims.head * 0.75, 0], // Head center offset\n    dims.head,\n  );\n\n  // Left arm chain (6 bones) - using actual arm segment lengths\n  const leftShoulder = createBone(\n    BoneName.SHOULDER_L,\n    spine3,\n    [-shoulderOffsetMeters * 0.7, dims.neck * 0.3, 0], // Shoulder starts inward from edge\n    dims.shoulder,\n  );\n  const leftUpperArm = createBone(\n    BoneName.UPPER_ARM_L,\n    leftShoulder,\n    [-dims.shoulder, 0, 0], // Extend outward by shoulder length\n    dims.upperArm,\n  );\n  const leftElbow = createBone(\n    BoneName.ELBOW_L,\n    leftUpperArm,\n    [-dims.upperArm, 0, 0], // End of upper arm\n    dims.elbow,\n  );\n  const leftForearm = createBone(\n    BoneName.FOREARM_L,\n    leftElbow,\n    [-dims.elbow, 0, 0], // Past elbow joint\n    dims.forearm,\n  );\n  const leftWrist = createBone(\n    BoneName.WRIST_L,\n    leftForearm,\n    [-dims.forearm, 0, 0], // End of forearm\n    dims.wrist,\n  );\n  const leftHand = createBone(\n    BoneName.HAND_L,\n    leftWrist,\n    [-dims.wrist, 0, 0], // Past wrist\n    dims.hand,\n  );\n\n  // Right arm chain (6 bones - mirror of left)\n  const rightShoulder = createBone(\n    BoneName.SHOULDER_R,\n    spine3,\n    [shoulderOffsetMeters * 0.7, dims.neck * 0.3, 0],\n    dims.shoulder,\n  );\n  const rightUpperArm = createBone(\n    BoneName.UPPER_ARM_R,\n    rightShoulder,\n    [dims.shoulder, 0, 0],\n    dims.upperArm,\n  );\n  const rightElbow = createBone(\n    BoneName.ELBOW_R,\n    rightUpperArm,\n    [dims.upperArm, 0, 0],\n    dims.elbow,\n  );\n  const rightForearm = createBone(\n    BoneName.FOREARM_R,\n    rightElbow,\n    [dims.elbow, 0, 0],\n    dims.forearm,\n  );\n  const rightWrist = createBone(\n    BoneName.WRIST_R,\n    rightForearm,\n    [dims.forearm, 0, 0],\n    dims.wrist,\n  );\n  const rightHand = createBone(\n    BoneName.HAND_R,\n    rightWrist,\n    [dims.wrist, 0, 0],\n    dims.hand,\n  );\n\n  // Left leg chain (5 bones) - using actual leg segment lengths\n  const leftHip = createBone(\n    BoneName.HIP_L,\n    root,\n    [-hipOffsetMeters, -dims.hip * 0.5, 0],\n    dims.hip,\n  );\n  const leftThigh = createBone(\n    BoneName.THIGH_L,\n    leftHip,\n    [0, -dims.hip, 0], // Drop down from hip\n    dims.thigh,\n  );\n  const leftKnee = createBone(\n    BoneName.KNEE_L,\n    leftThigh,\n    [0, -dims.thigh, 0], // End of thigh\n    dims.knee,\n  );\n  const leftShin = createBone(\n    BoneName.SHIN_L,\n    leftKnee,\n    [0, -dims.knee, 0], // Past knee\n    dims.shin,\n  );\n  const leftFoot = createBone(\n    BoneName.FOOT_L,\n    leftShin,\n    [0, -dims.shin, dims.foot * 0.5], // End of shin, slight forward for foot\n    dims.foot,\n  );\n\n  // Right leg chain (5 bones - mirror of left)\n  const rightHip = createBone(\n    BoneName.HIP_R,\n    root,\n    [hipOffsetMeters, -dims.hip * 0.5, 0],\n    dims.hip,\n  );\n  const rightThigh = createBone(\n    BoneName.THIGH_R,\n    rightHip,\n    [0, -dims.hip, 0],\n    dims.thigh,\n  );\n  const rightKnee = createBone(\n    BoneName.KNEE_R,\n    rightThigh,\n    [0, -dims.thigh, 0],\n    dims.knee,\n  );\n  const rightShin = createBone(\n    BoneName.SHIN_R,\n    rightKnee,\n    [0, -dims.knee, 0],\n    dims.shin,\n  );\n  const rightFoot = createBone(\n    BoneName.FOOT_R,\n    rightShin,\n    [0, -dims.shin, dims.foot * 0.5],\n    dims.foot,\n  );\n\n  // Create bone map for fast lookup\n  const bones = new Map<string, Bone>([\n    [BoneName.PELVIS, root],\n    [BoneName.SPINE_LOWER, spine1],\n    [BoneName.SPINE_MIDDLE, spine2],\n    [BoneName.SPINE_UPPER, spine3],\n    [BoneName.NECK, neck],\n    [BoneName.HEAD, head],\n    [BoneName.SHOULDER_L, leftShoulder],\n    [BoneName.UPPER_ARM_L, leftUpperArm],\n    [BoneName.ELBOW_L, leftElbow],\n    [BoneName.FOREARM_L, leftForearm],\n    [BoneName.WRIST_L, leftWrist],\n    [BoneName.HAND_L, leftHand],\n    [BoneName.SHOULDER_R, rightShoulder],\n    [BoneName.UPPER_ARM_R, rightUpperArm],\n    [BoneName.ELBOW_R, rightElbow],\n    [BoneName.FOREARM_R, rightForearm],\n    [BoneName.WRIST_R, rightWrist],\n    [BoneName.HAND_R, rightHand],\n    [BoneName.HIP_L, leftHip],\n    [BoneName.THIGH_L, leftThigh],\n    [BoneName.KNEE_L, leftKnee],\n    [BoneName.SHIN_L, leftShin],\n    [BoneName.FOOT_L, leftFoot],\n    [BoneName.HIP_R, rightHip],\n    [BoneName.THIGH_R, rightThigh],\n    [BoneName.KNEE_R, rightKnee],\n    [BoneName.SHIN_R, rightShin],\n    [BoneName.FOOT_R, rightFoot],\n  ]);\n\n  return {\n    root,\n    bones,\n    boneCount: bones.size,\n  };\n};\n\n/**\n * Joint constraints for anatomically correct movement\n *\n * Defines rotation limits for each joint to prevent unrealistic poses.\n * Based on human anatomy and Korean martial arts biomechanics.\n *\n * @korean 관절제약조건들\n */\nexport const JOINT_CONSTRAINTS: JointConstraint[] = [\n  // Elbow joints - can only bend one direction\n  {\n    boneName: BoneName.ELBOW_L,\n    minRotation: new THREE.Vector3(0, 0, -2.4), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n  {\n    boneName: BoneName.ELBOW_R,\n    minRotation: new THREE.Vector3(0, 0, 0),\n    maxRotation: new THREE.Vector3(0, 0, 2.4), // ~137 degrees\n    canTwist: false,\n  },\n\n  // Knee joints - can only bend backward\n  {\n    boneName: BoneName.KNEE_L,\n    minRotation: new THREE.Vector3(-2.4, 0, 0), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n  {\n    boneName: BoneName.KNEE_R,\n    minRotation: new THREE.Vector3(-2.4, 0, 0), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n\n  // Shoulder joints - full range of motion\n  {\n    boneName: BoneName.SHOULDER_L,\n    minRotation: new THREE.Vector3(-1.5, -1.5, -3.0),\n    maxRotation: new THREE.Vector3(1.5, 1.5, 3.0),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SHOULDER_R,\n    minRotation: new THREE.Vector3(-1.5, -1.5, -3.0),\n    maxRotation: new THREE.Vector3(1.5, 1.5, 3.0),\n    canTwist: true,\n  },\n\n  // Hip joints - large range for kicks\n  {\n    boneName: BoneName.HIP_L,\n    minRotation: new THREE.Vector3(-1.8, -0.8, -1.5),\n    maxRotation: new THREE.Vector3(1.8, 0.8, 1.5),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.HIP_R,\n    minRotation: new THREE.Vector3(-1.8, -0.8, -1.5),\n    maxRotation: new THREE.Vector3(1.8, 0.8, 1.5),\n    canTwist: true,\n  },\n\n  // Neck - moderate range\n  {\n    boneName: BoneName.NECK,\n    minRotation: new THREE.Vector3(-0.5, -0.8, -0.5),\n    maxRotation: new THREE.Vector3(0.5, 0.8, 0.5),\n    canTwist: true,\n  },\n\n  // Spine bones - limited rotation for realism\n  {\n    boneName: BoneName.SPINE_LOWER,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SPINE_MIDDLE,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SPINE_UPPER,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n];\n\n/**\n * Bone chains for IK (Inverse Kinematics)\n *\n * Defines logical bone chains for limbs, used for IK solving\n * and animation retargeting.\n *\n * @korean 뼈체인들\n */\nexport const BONE_CHAINS: BoneChain[] = [\n  // Left arm chain\n  {\n    name: \"left_arm\",\n    startBone: BoneName.SHOULDER_L,\n    endBone: BoneName.HAND_L,\n    bones: [\n      BoneName.SHOULDER_L,\n      BoneName.UPPER_ARM_L,\n      BoneName.ELBOW_L,\n      BoneName.FOREARM_L,\n      BoneName.WRIST_L,\n      BoneName.HAND_L,\n    ],\n  },\n\n  // Right arm chain\n  {\n    name: \"right_arm\",\n    startBone: BoneName.SHOULDER_R,\n    endBone: BoneName.HAND_R,\n    bones: [\n      BoneName.SHOULDER_R,\n      BoneName.UPPER_ARM_R,\n      BoneName.ELBOW_R,\n      BoneName.FOREARM_R,\n      BoneName.WRIST_R,\n      BoneName.HAND_R,\n    ],\n  },\n\n  // Left leg chain\n  {\n    name: \"left_leg\",\n    startBone: BoneName.HIP_L,\n    endBone: BoneName.FOOT_L,\n    bones: [\n      BoneName.HIP_L,\n      BoneName.THIGH_L,\n      BoneName.KNEE_L,\n      BoneName.SHIN_L,\n      BoneName.FOOT_L,\n    ],\n  },\n\n  // Right leg chain\n  {\n    name: \"right_leg\",\n    startBone: BoneName.HIP_R,\n    endBone: BoneName.FOOT_R,\n    bones: [\n      BoneName.HIP_R,\n      BoneName.THIGH_R,\n      BoneName.KNEE_R,\n      BoneName.SHIN_R,\n      BoneName.FOOT_R,\n    ],\n  },\n\n  // Spine chain\n  {\n    name: \"spine\",\n    startBone: BoneName.PELVIS,\n    endBone: BoneName.HEAD,\n    bones: [\n      BoneName.PELVIS,\n      BoneName.SPINE_LOWER,\n      BoneName.SPINE_MIDDLE,\n      BoneName.SPINE_UPPER,\n      BoneName.NECK,\n      BoneName.HEAD,\n    ],\n  },\n];\n\n/**\n * Apply joint constraints to bone rotation\n *\n * Clamps bone rotation to anatomically correct ranges.\n * Prevents unrealistic poses like backward-bending elbows.\n *\n * @param bone - Bone to constrain\n * @param constraints - Joint constraint to apply\n *\n * @korean 관절제약적용\n */\nexport const applyJointConstraint = (\n  bone: Bone,\n  constraint: JointConstraint,\n): void => {\n  // Clamp X rotation\n  bone.rotation.x = Math.max(\n    constraint.minRotation.x,\n    Math.min(constraint.maxRotation.x, bone.rotation.x),\n  );\n\n  // Clamp Y rotation\n  bone.rotation.y = Math.max(\n    constraint.minRotation.y,\n    Math.min(constraint.maxRotation.y, bone.rotation.y),\n  );\n\n  // Clamp Z rotation\n  bone.rotation.z = Math.max(\n    constraint.minRotation.z,\n    Math.min(constraint.maxRotation.z, bone.rotation.z),\n  );\n};\n\n// Reusable matrix objects for world transform calculations (avoid allocations in useFrame)\nconst tempMatrix = new THREE.Matrix4();\nconst tempQuaternion = new THREE.Quaternion();\nconst tempScale = new THREE.Vector3();\n\n/**\n * Get world position of bone\n *\n * Calculates absolute world position by traversing parent chain.\n * Uses proper matrix multiplication to account for parent rotations.\n *\n * @param bone - Bone to get world position for\n * @returns World position as Vector3\n *\n * @korean 뼈의세계위치구하기\n */\nexport const getBoneWorldPosition = (bone: Bone): THREE.Vector3 => {\n  // Build the bone chain from root to this bone\n  const boneChain: Bone[] = [];\n  let currentBone: Bone | null = bone;\n  while (currentBone) {\n    boneChain.unshift(currentBone);\n    currentBone = currentBone.parent;\n  }\n\n  // Compose world matrix by multiplying all local transforms\n  const worldMatrix = new THREE.Matrix4();\n  worldMatrix.identity();\n\n  for (const b of boneChain) {\n    tempMatrix.compose(\n      b.position,\n      tempQuaternion.setFromEuler(b.rotation),\n      b.scale,\n    );\n    worldMatrix.multiply(tempMatrix);\n  }\n\n  // Extract world position from composed matrix\n  const worldPos = new THREE.Vector3();\n  worldMatrix.decompose(worldPos, tempQuaternion, tempScale);\n  return worldPos;\n};\n\n/**\n * Get world rotation of bone\n *\n * Calculates absolute world rotation by traversing parent chain.\n * Uses proper quaternion multiplication for correct rotation composition.\n *\n * @param bone - Bone to get world rotation for\n * @returns World rotation as Euler\n *\n * @korean 뼈의세계회전구하기\n */\nexport const getBoneWorldRotation = (bone: Bone): THREE.Euler => {\n  // Build the bone chain from root to this bone\n  const boneChain: Bone[] = [];\n  let currentBone: Bone | null = bone;\n  while (currentBone) {\n    boneChain.unshift(currentBone);\n    currentBone = currentBone.parent;\n  }\n\n  // Compose world rotation by multiplying quaternions (proper rotation composition)\n  const worldQuat = new THREE.Quaternion();\n  worldQuat.identity();\n\n  for (const b of boneChain) {\n    tempQuaternion.setFromEuler(b.rotation);\n    worldQuat.multiply(tempQuaternion);\n  }\n\n  // Convert back to Euler\n  const worldRot = new THREE.Euler();\n  worldRot.setFromQuaternion(worldQuat);\n  return worldRot;\n};\n\n/**\n * Reset bone to rest pose\n *\n * Resets bone position and rotation to default rest pose.\n * Useful for animation blending and initialization.\n *\n * @param bone - Bone to reset\n *\n * @korean 뼈를기본자세로초기화\n */\nexport const resetBoneToRestPose = (bone: Bone): void => {\n  bone.position.copy(bone.restPosition);\n  bone.rotation.copy(bone.restRotation);\n  bone.scale.set(1, 1, 1);\n};\n\n/**\n * Reset entire rig to rest pose\n *\n * Resets all bones in rig to rest pose.\n *\n * @param rig - Skeletal rig to reset\n *\n * @korean 골격을기본자세로초기화\n */\nexport const resetRigToRestPose = (rig: SkeletalRig): void => {\n  rig.bones.forEach((bone) => {\n    resetBoneToRestPose(bone);\n  });\n};\n\n/**\n * Create hand bones with 5 fingers\n *\n * Creates detailed hand structure with 5 fingers (thumb, index, middle, ring, pinky),\n * attached to an existing hand/palm bone.\n * Each finger has 3-4 bones for realistic animation.\n *\n * Finger bone structure:\n * - Thumb: 3 bones (metacarpal, proximal, distal) - no intermediate\n * - Other fingers: 4 bones (metacarpal, proximal, intermediate, distal)\n *\n * Total created by this function: 19 finger bones per hand (3 thumb + 4*4 other fingers),\n * all attached to the provided hand bone.\n *\n * @param handBone - Parent hand bone (acts as the palm/root for finger bones)\n * @param side - Hand side (\"left\" or \"right\")\n * @returns Map of finger bones added to the rig\n *\n * @korean 손뼈생성\n */\nexport const createHandBones = (\n  handBone: Bone,\n  side: \"left\" | \"right\",\n): Map<string, Bone> => {\n  const fingerBones = new Map<string, Bone>();\n\n  // Hand orientation: left hand extends to -X, right hand extends to +X\n  const sideMultiplier = side === \"left\" ? -1 : 1;\n\n  // Thumb (3 bones) - offset slightly toward palm center and forward\n  const thumbMeta = createBone(\n    `${\n      BoneName[`THUMB_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.015 * sideMultiplier, 0.02, 0.01],\n    0.025,\n  );\n  const thumbProx = createBone(\n    `${\n      BoneName[`THUMB_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    thumbMeta,\n    [0.015 * sideMultiplier, 0.015, 0.01],\n    0.02,\n  );\n  const thumbDist = createBone(\n    `${\n      BoneName[`THUMB_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    thumbProx,\n    [0.01 * sideMultiplier, 0.01, 0],\n    0.015,\n  );\n\n  fingerBones.set(thumbMeta.name, thumbMeta);\n  fingerBones.set(thumbProx.name, thumbProx);\n  fingerBones.set(thumbDist.name, thumbDist);\n\n  // Index finger (4 bones)\n  const indexMeta = createBone(\n    `${\n      BoneName[`INDEX_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.015 * sideMultiplier, 0.06, 0],\n    0.03,\n  );\n  const indexProx = createBone(\n    `${\n      BoneName[`INDEX_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexMeta,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const indexInter = createBone(\n    `${\n      BoneName[`INDEX_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexProx,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const indexDist = createBone(\n    `${\n      BoneName[`INDEX_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexInter,\n    [0, 0.015, 0],\n    0.015,\n  );\n\n  fingerBones.set(indexMeta.name, indexMeta);\n  fingerBones.set(indexProx.name, indexProx);\n  fingerBones.set(indexInter.name, indexInter);\n  fingerBones.set(indexDist.name, indexDist);\n\n  // Middle finger (4 bones) - longest finger\n  const middleMeta = createBone(\n    `${\n      BoneName[`MIDDLE_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.005 * sideMultiplier, 0.065, 0],\n    0.035,\n  );\n  const middleProx = createBone(\n    `${\n      BoneName[`MIDDLE_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleMeta,\n    [0, 0.03, 0],\n    0.03,\n  );\n  const middleInter = createBone(\n    `${\n      BoneName[`MIDDLE_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleProx,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const middleDist = createBone(\n    `${\n      BoneName[`MIDDLE_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleInter,\n    [0, 0.02, 0],\n    0.02,\n  );\n\n  fingerBones.set(middleMeta.name, middleMeta);\n  fingerBones.set(middleProx.name, middleProx);\n  fingerBones.set(middleInter.name, middleInter);\n  fingerBones.set(middleDist.name, middleDist);\n\n  // Ring finger (4 bones)\n  const ringMeta = createBone(\n    `${\n      BoneName[`RING_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [-0.005 * sideMultiplier, 0.06, 0],\n    0.03,\n  );\n  const ringProx = createBone(\n    `${\n      BoneName[`RING_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringMeta,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const ringInter = createBone(\n    `${\n      BoneName[`RING_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringProx,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const ringDist = createBone(\n    `${\n      BoneName[`RING_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringInter,\n    [0, 0.015, 0],\n    0.015,\n  );\n\n  fingerBones.set(ringMeta.name, ringMeta);\n  fingerBones.set(ringProx.name, ringProx);\n  fingerBones.set(ringInter.name, ringInter);\n  fingerBones.set(ringDist.name, ringDist);\n\n  // Pinky finger (4 bones) - shortest finger\n  const pinkyMeta = createBone(\n    `${\n      BoneName[`PINKY_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [-0.015 * sideMultiplier, 0.05, 0],\n    0.025,\n  );\n  const pinkyProx = createBone(\n    `${\n      BoneName[`PINKY_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyMeta,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const pinkyInter = createBone(\n    `${\n      BoneName[`PINKY_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyProx,\n    [0, 0.015, 0],\n    0.015,\n  );\n  const pinkyDist = createBone(\n    `${\n      BoneName[`PINKY_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyInter,\n    [0, 0.01, 0],\n    0.01,\n  );\n\n  fingerBones.set(pinkyMeta.name, pinkyMeta);\n  fingerBones.set(pinkyProx.name, pinkyProx);\n  fingerBones.set(pinkyInter.name, pinkyInter);\n  fingerBones.set(pinkyDist.name, pinkyDist);\n\n  return fingerBones;\n};\n\n/**\n * Create humanoid rig with optional hand bones\n *\n * Creates complete skeletal rig with optional detailed hand bones.\n * Hand bones can be excluded for performance (LOD system).\n *\n * @param includeHandBones - Whether to include detailed hand bones (default: false)\n * @returns Complete skeletal rig with or without hand bones\n *\n * @korean 손뼈포함골격생성\n */\nexport const createHumanoidRigWithHands = (\n  includeHandBones: boolean = false,\n): SkeletalRig => {\n  // Create base rig\n  const baseRig = createHumanoidRig();\n\n  // If hand bones not requested, return base rig\n  if (!includeHandBones) {\n    return baseRig;\n  }\n\n  // Get hand bones from base rig\n  const leftHand = baseRig.bones.get(BoneName.HAND_L);\n  const rightHand = baseRig.bones.get(BoneName.HAND_R);\n\n  if (!leftHand || !rightHand) {\n    console.warn(\"Hand bones not found in base rig\");\n    return baseRig;\n  }\n\n  // Create finger bones\n  const leftFingerBones = createHandBones(leftHand, \"left\");\n  const rightFingerBones = createHandBones(rightHand, \"right\");\n\n  // Add finger bones to rig bone map\n  leftFingerBones.forEach((bone, name) => {\n    baseRig.bones.set(name, bone);\n  });\n  rightFingerBones.forEach((bone, name) => {\n    baseRig.bones.set(name, bone);\n  });\n\n  return {\n    ...baseRig,\n    boneCount: baseRig.bones.size,\n  };\n};\n\n/**\n * Torso rotation constraints for anatomically correct upper/lower body movement\n *\n * Defines limits and behavior for independent torso rotation relative to hips,\n * enabling realistic strafing and lateral movement while facing opponent.\n *\n * Korean terminology:\n * - 허리회전 (Heorhwoejeon) - Torso rotation\n * - 해부학적제약 (Haebuhakjeok Jeyak) - Anatomical constraints\n *\n * @public\n * @korean 허리회전제약조건\n */\nexport const TORSO_CONSTRAINTS = {\n  /**\n   * Maximum torso rotation relative to hips (radians)\n   * ±90° = π/2 radians - anatomically safe rotation limit\n   *\n   * @korean 최대회전각도\n   */\n  MAX_ROTATION: Math.PI / 2,\n\n  /**\n   * Minimum torso rotation relative to hips (radians)\n   * -90° = -π/2 radians\n   *\n   * @korean 최소회전각도\n   */\n  MIN_ROTATION: -Math.PI / 2,\n\n  /**\n   * Target interpolation time in seconds\n   * 200ms provides smooth, natural rotation feel\n   *\n   * @korean 보간시간\n   */\n  INTERPOLATION_TIME: 0.2,\n\n  /**\n   * Power modifier range for hip rotation\n   * [min, max] = [10%, 30%] damage bonus from proper hip engagement\n   *\n   * @korean 파워배율범위\n   */\n  POWER_MODIFIER_RANGE: [0.1, 0.3] as const,\n} as const;\n\n/**\n * Calculate torso rotation to face opponent while moving\n *\n * Determines optimal torso rotation angle to keep upper body facing opponent\n * while hips/legs are oriented in movement direction. Enforces anatomical\n * constraints (±90° max rotation).\n *\n * @param currentPosition - Player's current world position\n * @param opponentPosition - Opponent's current world position\n * @param _movementDirection - Direction of player movement (reserved for future use)\n * @param hipRotation - Current hip/pelvis rotation in radians\n * @returns Torso rotation in radians relative to hips (clamped to ±90°)\n *\n * @example\n * ```typescript\n * const playerPos = new THREE.Vector3(0, 0, 0);\n * const opponentPos = new THREE.Vector3(0, 0, 5); // Directly in front along Z+\n * const moveDir = new THREE.Vector3(0, 0, 1); // Moving forward\n * const hipRot = 0; // Hips facing forward (Z+)\n *\n * const torsoRot = calculateTorsoRotation(playerPos, opponentPos, moveDir, hipRot);\n * // Returns 0 (opponent is already aligned with hips)\n * ```\n *\n * @public\n * @korean 상대를향한허리회전계산\n */\nexport function calculateTorsoRotation(\n  currentPosition: THREE.Vector3,\n  opponentPosition: THREE.Vector3,\n  _movementDirection: THREE.Vector3,\n  hipRotation: number,\n): number {\n  // Calculate angle to opponent\n  const directionToOpponent = opponentPosition\n    .clone()\n    .sub(currentPosition)\n    .normalize();\n  // Use atan2(x, z) - X is horizontal, Z is forward/back in Three.js\n  const angleToOpponent = Math.atan2(\n    directionToOpponent.x,\n    directionToOpponent.z,\n  );\n\n  // Calculate torso rotation relative to hips\n  let torsoRotation = angleToOpponent - hipRotation;\n\n  // Normalize to -π to π range\n  while (torsoRotation > Math.PI) torsoRotation -= 2 * Math.PI;\n  while (torsoRotation < -Math.PI) torsoRotation += 2 * Math.PI;\n\n  // Apply anatomical constraints (±90°)\n  torsoRotation = Math.max(\n    TORSO_CONSTRAINTS.MIN_ROTATION,\n    Math.min(TORSO_CONSTRAINTS.MAX_ROTATION, torsoRotation),\n  );\n\n  return torsoRotation;\n}\n\n/**\n * Calculate damage modifier from hip rotation\n *\n * Determines power bonus applied to techniques based on hip rotation angle.\n * Greater hip rotation generates more power through proper biomechanics,\n * with strikes benefiting most from full rotation.\n *\n * @param hipRotationAngle - Hip rotation angle in radians (typically from torso twist)\n * @param techniqueType - Type of technique ('strike', 'throw', or 'joint')\n * @returns Damage multiplier (1.0-1.3 for strikes, 1.0-1.1 for throws/joints)\n *\n * @example\n * ```typescript\n * // Full hip rotation on strike technique\n * const modifier = calculateHipRotationPowerModifier(Math.PI / 2, 'strike');\n * // Returns 1.30 (30% damage bonus)\n *\n * // Half rotation on throw\n * const throwMod = calculateHipRotationPowerModifier(Math.PI / 4, 'throw');\n * // Returns 1.05 (5% damage bonus)\n * ```\n *\n * @public\n * @korean 허리회전으로인한데미지배율계산\n */\nexport function calculateHipRotationPowerModifier(\n  hipRotationAngle: number,\n  techniqueType: \"strike\" | \"throw\" | \"joint\",\n): number {\n  // Normalize rotation to 0-1 range (0 = no rotation, 1 = max rotation)\n  // Clamp to max rotation first to handle any values exceeding ±90°\n  const clampedAngle = Math.max(\n    -TORSO_CONSTRAINTS.MAX_ROTATION,\n    Math.min(TORSO_CONSTRAINTS.MAX_ROTATION, Math.abs(hipRotationAngle)),\n  );\n  const normalizedRotation = clampedAngle / TORSO_CONSTRAINTS.MAX_ROTATION;\n\n  // Strikes benefit most from hip rotation (up to 30% bonus)\n  // Throws get moderate benefit (up to 10% bonus)\n  // Joint locks get minimal benefit (up to 10% bonus)\n  const baseModifier = techniqueType === \"strike\" ? 0.3 : 0.1;\n\n  return 1.0 + normalizedRotation * baseModifier;\n}\n"],"mappings":"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"}
+{"version":3,"file":"SkeletonRig.js","names":[],"sources":["../../../../src/systems/animation/builders/SkeletonRig.ts"],"sourcesContent":["/**\n * Skeleton rig implementation for articulated body model\n *\n * Creates and manages humanoid skeletal rig with 28 bones for realistic\n * martial arts animations. Implements bone hierarchy following Korean martial\n * arts body mechanics.\n *\n * Now supports dynamic scaling based on player physical attributes for\n * anatomically accurate body proportions per archetype.\n *\n * @module systems/animation/SkeletonRig\n * @category Animation System\n * @korean 골격시스템\n */\n\nimport { PhysicalAttributes } from \"@/types/common\";\nimport type {\n  Bone,\n  BoneChain,\n  JointConstraint,\n  SkeletalRig,\n} from \"@/types/skeletal\";\nimport { BoneName } from \"@/types/skeletal\";\nimport {\n  calculateSkeletonDimensions,\n  cmToMeters,\n} from \"@/utils/characterScaling\";\nimport * as THREE from \"three\";\n\n/**\n * Create a bone with default rest pose\n *\n * Helper function to create a bone with position, rotation, and scale.\n * Sets up rest pose for animation blending.\n *\n * @param name - Unique bone identifier\n * @param parent - Parent bone (null for root)\n * @param position - Local position relative to parent [x, y, z]\n * @param length - Bone length for rendering\n * @returns Newly created bone\n *\n * @korean 뼈생성\n */\nexport const createBone = (\n  name: string,\n  parent: Bone | null,\n  position: [number, number, number],\n  length = 0.1,\n): Bone => {\n  const pos = new THREE.Vector3(position[0], position[1], position[2]);\n  const rot = new THREE.Euler(0, 0, 0);\n  const scale = new THREE.Vector3(1, 1, 1);\n\n  const bone: Bone = {\n    name,\n    parent,\n    position: pos.clone(),\n    rotation: rot.clone(),\n    scale: scale.clone(),\n    children: [],\n    length,\n    restPosition: pos.clone(),\n    restRotation: rot.clone(),\n  };\n\n  // Add to parent's children\n  if (parent) {\n    parent.children.push(bone);\n  }\n\n  return bone;\n};\n\n/**\n * Create complete humanoid skeletal rig\n *\n * Creates 28-bone humanoid skeleton following Korean martial arts anatomy:\n * - 1 root (pelvis)\n * - 3 spine bones\n * - 2 head bones (neck, head)\n * - 12 arm bones (6 per arm)\n * - 10 leg bones (5 per leg)\n *\n * Total: 28 bones (under 30 bone limit for 60fps performance)\n *\n * @returns Complete skeletal rig with bone hierarchy\n *\n * @example\n * ```typescript\n * const rig = createHumanoidRig();\n * const rightHand = rig.bones.get(BoneName.HAND_R);\n * console.log(`Hand position: ${rightHand?.position}`);\n * ```\n *\n * @korean 인간형골격생성\n */\nexport const createHumanoidRig = (): SkeletalRig => {\n  // Root (pelvis) - center of mass at hip height\n  // Pelvis height = sum of leg segments (hip + thigh + knee + shin + foot)\n  // = 0.1 + 0.3 + 0.3 + 0.3 + 0.1 = 1.1 to have feet at Y=0\n  const root = createBone(BoneName.PELVIS, null, [0, 1.1, 0], 0.15);\n\n  // Spine chain (3 bones)\n  const spine1 = createBone(BoneName.SPINE_LOWER, root, [0, 0.15, 0], 0.2);\n  const spine2 = createBone(BoneName.SPINE_MIDDLE, spine1, [0, 0.2, 0], 0.2);\n  const spine3 = createBone(BoneName.SPINE_UPPER, spine2, [0, 0.2, 0], 0.2);\n\n  // Head chain (2 bones)\n  const neck = createBone(BoneName.NECK, spine3, [0, 0.15, 0], 0.1);\n  const head = createBone(BoneName.HEAD, neck, [0, 0.2, 0], 0.2);\n\n  // Left arm chain (6 bones)\n  const leftShoulder = createBone(\n    BoneName.SHOULDER_L,\n    spine3,\n    [-0.15, 0.1, 0],\n    0.1,\n  );\n  const leftUpperArm = createBone(\n    BoneName.UPPER_ARM_L,\n    leftShoulder,\n    [-0.15, 0, 0],\n    0.25,\n  );\n  const leftElbow = createBone(\n    BoneName.ELBOW_L,\n    leftUpperArm,\n    [-0.25, 0, 0],\n    0.05,\n  );\n  const leftForearm = createBone(\n    BoneName.FOREARM_L,\n    leftElbow,\n    [-0.25, 0, 0],\n    0.25,\n  );\n  const leftWrist = createBone(\n    BoneName.WRIST_L,\n    leftForearm,\n    [-0.15, 0, 0],\n    0.05,\n  );\n  const leftHand = createBone(BoneName.HAND_L, leftWrist, [-0.08, 0, 0], 0.08);\n\n  // Right arm chain (6 bones - mirror of left)\n  const rightShoulder = createBone(\n    BoneName.SHOULDER_R,\n    spine3,\n    [0.15, 0.1, 0],\n    0.1,\n  );\n  const rightUpperArm = createBone(\n    BoneName.UPPER_ARM_R,\n    rightShoulder,\n    [0.15, 0, 0],\n    0.25,\n  );\n  const rightElbow = createBone(\n    BoneName.ELBOW_R,\n    rightUpperArm,\n    [0.25, 0, 0],\n    0.05,\n  );\n  const rightForearm = createBone(\n    BoneName.FOREARM_R,\n    rightElbow,\n    [0.25, 0, 0],\n    0.25,\n  );\n  const rightWrist = createBone(\n    BoneName.WRIST_R,\n    rightForearm,\n    [0.15, 0, 0],\n    0.05,\n  );\n  const rightHand = createBone(BoneName.HAND_R, rightWrist, [0.08, 0, 0], 0.08);\n\n  // Left leg chain (5 bones)\n  const leftHip = createBone(BoneName.HIP_L, root, [-0.1, -0.1, 0], 0.1);\n  const leftThigh = createBone(BoneName.THIGH_L, leftHip, [0, -0.3, 0], 0.3);\n  const leftKnee = createBone(BoneName.KNEE_L, leftThigh, [0, -0.3, 0], 0.05);\n  const leftShin = createBone(BoneName.SHIN_L, leftKnee, [0, -0.3, 0], 0.3);\n  const leftFoot = createBone(BoneName.FOOT_L, leftShin, [0, -0.1, 0.1], 0.15);\n\n  // Right leg chain (5 bones - mirror of left)\n  const rightHip = createBone(BoneName.HIP_R, root, [0.1, -0.1, 0], 0.1);\n  const rightThigh = createBone(BoneName.THIGH_R, rightHip, [0, -0.3, 0], 0.3);\n  const rightKnee = createBone(BoneName.KNEE_R, rightThigh, [0, -0.3, 0], 0.05);\n  const rightShin = createBone(BoneName.SHIN_R, rightKnee, [0, -0.3, 0], 0.3);\n  const rightFoot = createBone(\n    BoneName.FOOT_R,\n    rightShin,\n    [0, -0.1, 0.1],\n    0.15,\n  );\n\n  // Create bone map for fast lookup\n  const bones = new Map<string, Bone>([\n    [BoneName.PELVIS, root],\n    [BoneName.SPINE_LOWER, spine1],\n    [BoneName.SPINE_MIDDLE, spine2],\n    [BoneName.SPINE_UPPER, spine3],\n    [BoneName.NECK, neck],\n    [BoneName.HEAD, head],\n    [BoneName.SHOULDER_L, leftShoulder],\n    [BoneName.UPPER_ARM_L, leftUpperArm],\n    [BoneName.ELBOW_L, leftElbow],\n    [BoneName.FOREARM_L, leftForearm],\n    [BoneName.WRIST_L, leftWrist],\n    [BoneName.HAND_L, leftHand],\n    [BoneName.SHOULDER_R, rightShoulder],\n    [BoneName.UPPER_ARM_R, rightUpperArm],\n    [BoneName.ELBOW_R, rightElbow],\n    [BoneName.FOREARM_R, rightForearm],\n    [BoneName.WRIST_R, rightWrist],\n    [BoneName.HAND_R, rightHand],\n    [BoneName.HIP_L, leftHip],\n    [BoneName.THIGH_L, leftThigh],\n    [BoneName.KNEE_L, leftKnee],\n    [BoneName.SHIN_L, leftShin],\n    [BoneName.FOOT_L, leftFoot],\n    [BoneName.HIP_R, rightHip],\n    [BoneName.THIGH_R, rightThigh],\n    [BoneName.KNEE_R, rightKnee],\n    [BoneName.SHIN_R, rightShin],\n    [BoneName.FOOT_R, rightFoot],\n  ]);\n\n  return {\n    root,\n    bones,\n    boneCount: bones.size,\n  };\n};\n\n/**\n * Create humanoid rig with dynamic scaling based on physical attributes.\n *\n * **Korean**: 신체 속성 기반 골격 생성 (Physical Attributes-Based Skeleton Creation)\n *\n * Creates a 28-bone humanoid skeleton with bone lengths scaled according to\n * the fighter's physical attributes. This allows each archetype to have\n * anatomically accurate body proportions that affect combat hitboxes, vital\n * point positioning, and visual representation.\n *\n * ## Visual Amplification\n *\n * The scaling system applies amplification factors to create distinct visual\n * silhouettes while maintaining anatomical realism:\n *\n * - **2.5x limb amplification**: Makes reach differences clearly visible\n * - **1.15x shoulder amplification**: Creates recognizable body width differences\n * - **1.5x height amplification**: Subtle overall size differences\n *\n * ### Archetype Silhouettes Created\n *\n * The following table shows the effective shoulder span after amplification\n * (full span = offset * 2). Values show raw attribute → amplified visual span.\n *\n * | Archetype | Shoulders (Raw → Amplified Span) | Height | Silhouette |\n * |-----------|----------------------------------|--------|------------|\n * | Hacker    | 43cm → 49.5cm | 175cm | Compact, narrow |\n * | Amsalja   | 44cm → 50.6cm | 186cm | Tall, lean |\n * | Jeongbo   | 45cm → 51.8cm | 179cm | Balanced |\n * | Musa      | 46cm → 52.9cm | 180cm | Athletic |\n * | Jojik     | 54cm → 62.1cm | 188cm | Massive, wide |\n *\n * Note: Amplified span = raw width * 1.15 (shoulder amplification factor)\n * Percentage differences remain constant, but absolute gaps are amplified:\n * - Raw gap: Jojik (54cm) - Hacker (43cm) = 11cm\n * - Amplified gap: 62.1cm - 49.5cm = 12.6cm (15% larger absolute difference)\n *\n * @param attributes - Physical attributes to scale the skeleton\n * @returns Complete skeletal rig with scaled bone dimensions\n *\n * @example\n * ```typescript\n * import { AMSALJA_PHYSICAL } from \"@/data/archetypePhysicalAttributes\";\n *\n * // Create skeleton for lean assassin archetype\n * const amsaljaRig = createScaledHumanoidRig(AMSALJA_PHYSICAL);\n * // Results in taller skeleton with longer limbs, narrower shoulders\n * // Height: 186cm, Legs: 102cm, Arms: 82cm, Shoulders: 44cm\n *\n * // Create skeleton for heavy brawler archetype\n * const jojikRig = createScaledHumanoidRig(JOJIK_PHYSICAL);\n * // Results in stockier skeleton with wider shoulders, thicker torso\n * // Height: 188cm, Legs: 100cm, Arms: 84cm, Shoulders: 54cm (25% wider!)\n * ```\n *\n * @korean 크기조정된인간형골격생성\n */\nexport const createScaledHumanoidRig = (\n  attributes: PhysicalAttributes,\n): SkeletalRig => {\n  // Calculate anatomically correct bone dimensions in meters\n  const dims = calculateSkeletonDimensions(attributes);\n\n  // Calculate shoulder offset (half of shoulder width) in meters\n  const shoulderOffsetMeters = cmToMeters(attributes.shoulderWidth) / 2;\n  const hipOffsetMeters = cmToMeters(attributes.shoulderWidth) * 0.35; // Hips are ~70% of shoulder width\n\n  // Root (pelvis) - position at pelvis height (ground + leg length + foot)\n  // This ensures feet are at Y=0\n  const root = createBone(\n    BoneName.PELVIS,\n    null,\n    [0, dims.pelvisHeight, 0],\n    dims.hip,\n  );\n\n  // Spine chain (3 bones) - using actual torso segment lengths\n  const spine1 = createBone(\n    BoneName.SPINE_LOWER,\n    root,\n    [0, dims.spineLower * 0.5, 0], // Start half a segment up from pelvis\n    dims.spineLower,\n  );\n  const spine2 = createBone(\n    BoneName.SPINE_MIDDLE,\n    spine1,\n    [0, dims.spineMiddle, 0],\n    dims.spineMiddle,\n  );\n  const spine3 = createBone(\n    BoneName.SPINE_UPPER,\n    spine2,\n    [0, dims.spineUpper, 0],\n    dims.spineUpper,\n  );\n\n  // Head chain (2 bones) - using actual neck and head sizes\n  const neck = createBone(\n    BoneName.NECK,\n    spine3,\n    [0, dims.neck * 0.5, 0], // Start from top of spine\n    dims.neck,\n  );\n  const head = createBone(\n    BoneName.HEAD,\n    neck,\n    [0, dims.head * 0.75, 0], // Head center offset\n    dims.head,\n  );\n\n  // Left arm chain (6 bones) - using actual arm segment lengths\n  const leftShoulder = createBone(\n    BoneName.SHOULDER_L,\n    spine3,\n    [-shoulderOffsetMeters * 0.7, dims.neck * 0.3, 0], // Shoulder starts inward from edge\n    dims.shoulder,\n  );\n  const leftUpperArm = createBone(\n    BoneName.UPPER_ARM_L,\n    leftShoulder,\n    [-dims.shoulder, 0, 0], // Extend outward by shoulder length\n    dims.upperArm,\n  );\n  const leftElbow = createBone(\n    BoneName.ELBOW_L,\n    leftUpperArm,\n    [-dims.upperArm, 0, 0], // End of upper arm\n    dims.elbow,\n  );\n  const leftForearm = createBone(\n    BoneName.FOREARM_L,\n    leftElbow,\n    [-dims.elbow, 0, 0], // Past elbow joint\n    dims.forearm,\n  );\n  const leftWrist = createBone(\n    BoneName.WRIST_L,\n    leftForearm,\n    [-dims.forearm, 0, 0], // End of forearm\n    dims.wrist,\n  );\n  const leftHand = createBone(\n    BoneName.HAND_L,\n    leftWrist,\n    [-dims.wrist, 0, 0], // Past wrist\n    dims.hand,\n  );\n\n  // Right arm chain (6 bones - mirror of left)\n  const rightShoulder = createBone(\n    BoneName.SHOULDER_R,\n    spine3,\n    [shoulderOffsetMeters * 0.7, dims.neck * 0.3, 0],\n    dims.shoulder,\n  );\n  const rightUpperArm = createBone(\n    BoneName.UPPER_ARM_R,\n    rightShoulder,\n    [dims.shoulder, 0, 0],\n    dims.upperArm,\n  );\n  const rightElbow = createBone(\n    BoneName.ELBOW_R,\n    rightUpperArm,\n    [dims.upperArm, 0, 0],\n    dims.elbow,\n  );\n  const rightForearm = createBone(\n    BoneName.FOREARM_R,\n    rightElbow,\n    [dims.elbow, 0, 0],\n    dims.forearm,\n  );\n  const rightWrist = createBone(\n    BoneName.WRIST_R,\n    rightForearm,\n    [dims.forearm, 0, 0],\n    dims.wrist,\n  );\n  const rightHand = createBone(\n    BoneName.HAND_R,\n    rightWrist,\n    [dims.wrist, 0, 0],\n    dims.hand,\n  );\n\n  // Left leg chain (5 bones) - using actual leg segment lengths\n  const leftHip = createBone(\n    BoneName.HIP_L,\n    root,\n    [-hipOffsetMeters, -dims.hip * 0.5, 0],\n    dims.hip,\n  );\n  const leftThigh = createBone(\n    BoneName.THIGH_L,\n    leftHip,\n    [0, -dims.hip, 0], // Drop down from hip\n    dims.thigh,\n  );\n  const leftKnee = createBone(\n    BoneName.KNEE_L,\n    leftThigh,\n    [0, -dims.thigh, 0], // End of thigh\n    dims.knee,\n  );\n  const leftShin = createBone(\n    BoneName.SHIN_L,\n    leftKnee,\n    [0, -dims.knee, 0], // Past knee\n    dims.shin,\n  );\n  const leftFoot = createBone(\n    BoneName.FOOT_L,\n    leftShin,\n    [0, -dims.shin, dims.foot * 0.5], // End of shin, slight forward for foot\n    dims.foot,\n  );\n\n  // Right leg chain (5 bones - mirror of left)\n  const rightHip = createBone(\n    BoneName.HIP_R,\n    root,\n    [hipOffsetMeters, -dims.hip * 0.5, 0],\n    dims.hip,\n  );\n  const rightThigh = createBone(\n    BoneName.THIGH_R,\n    rightHip,\n    [0, -dims.hip, 0],\n    dims.thigh,\n  );\n  const rightKnee = createBone(\n    BoneName.KNEE_R,\n    rightThigh,\n    [0, -dims.thigh, 0],\n    dims.knee,\n  );\n  const rightShin = createBone(\n    BoneName.SHIN_R,\n    rightKnee,\n    [0, -dims.knee, 0],\n    dims.shin,\n  );\n  const rightFoot = createBone(\n    BoneName.FOOT_R,\n    rightShin,\n    [0, -dims.shin, dims.foot * 0.5],\n    dims.foot,\n  );\n\n  // Create bone map for fast lookup\n  const bones = new Map<string, Bone>([\n    [BoneName.PELVIS, root],\n    [BoneName.SPINE_LOWER, spine1],\n    [BoneName.SPINE_MIDDLE, spine2],\n    [BoneName.SPINE_UPPER, spine3],\n    [BoneName.NECK, neck],\n    [BoneName.HEAD, head],\n    [BoneName.SHOULDER_L, leftShoulder],\n    [BoneName.UPPER_ARM_L, leftUpperArm],\n    [BoneName.ELBOW_L, leftElbow],\n    [BoneName.FOREARM_L, leftForearm],\n    [BoneName.WRIST_L, leftWrist],\n    [BoneName.HAND_L, leftHand],\n    [BoneName.SHOULDER_R, rightShoulder],\n    [BoneName.UPPER_ARM_R, rightUpperArm],\n    [BoneName.ELBOW_R, rightElbow],\n    [BoneName.FOREARM_R, rightForearm],\n    [BoneName.WRIST_R, rightWrist],\n    [BoneName.HAND_R, rightHand],\n    [BoneName.HIP_L, leftHip],\n    [BoneName.THIGH_L, leftThigh],\n    [BoneName.KNEE_L, leftKnee],\n    [BoneName.SHIN_L, leftShin],\n    [BoneName.FOOT_L, leftFoot],\n    [BoneName.HIP_R, rightHip],\n    [BoneName.THIGH_R, rightThigh],\n    [BoneName.KNEE_R, rightKnee],\n    [BoneName.SHIN_R, rightShin],\n    [BoneName.FOOT_R, rightFoot],\n  ]);\n\n  return {\n    root,\n    bones,\n    boneCount: bones.size,\n  };\n};\n\n/**\n * Joint constraints for anatomically correct movement\n *\n * Defines rotation limits for each joint to prevent unrealistic poses.\n * Based on human anatomy and Korean martial arts biomechanics.\n *\n * @korean 관절제약조건들\n */\nexport const JOINT_CONSTRAINTS: JointConstraint[] = [\n  // Elbow joints - can only bend one direction\n  {\n    boneName: BoneName.ELBOW_L,\n    minRotation: new THREE.Vector3(0, 0, -2.4), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n  {\n    boneName: BoneName.ELBOW_R,\n    minRotation: new THREE.Vector3(0, 0, 0),\n    maxRotation: new THREE.Vector3(0, 0, 2.4), // ~137 degrees\n    canTwist: false,\n  },\n\n  // Knee joints - can only bend backward\n  {\n    boneName: BoneName.KNEE_L,\n    minRotation: new THREE.Vector3(-2.4, 0, 0), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n  {\n    boneName: BoneName.KNEE_R,\n    minRotation: new THREE.Vector3(-2.4, 0, 0), // ~-137 degrees\n    maxRotation: new THREE.Vector3(0, 0, 0),\n    canTwist: false,\n  },\n\n  // Shoulder joints - full range of motion\n  {\n    boneName: BoneName.SHOULDER_L,\n    minRotation: new THREE.Vector3(-1.5, -1.5, -3.0),\n    maxRotation: new THREE.Vector3(1.5, 1.5, 3.0),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SHOULDER_R,\n    minRotation: new THREE.Vector3(-1.5, -1.5, -3.0),\n    maxRotation: new THREE.Vector3(1.5, 1.5, 3.0),\n    canTwist: true,\n  },\n\n  // Hip joints - large range for kicks\n  {\n    boneName: BoneName.HIP_L,\n    minRotation: new THREE.Vector3(-1.8, -0.8, -1.5),\n    maxRotation: new THREE.Vector3(1.8, 0.8, 1.5),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.HIP_R,\n    minRotation: new THREE.Vector3(-1.8, -0.8, -1.5),\n    maxRotation: new THREE.Vector3(1.8, 0.8, 1.5),\n    canTwist: true,\n  },\n\n  // Neck - moderate range\n  {\n    boneName: BoneName.NECK,\n    minRotation: new THREE.Vector3(-0.5, -0.8, -0.5),\n    maxRotation: new THREE.Vector3(0.5, 0.8, 0.5),\n    canTwist: true,\n  },\n\n  // Spine bones - limited rotation for realism\n  {\n    boneName: BoneName.SPINE_LOWER,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SPINE_MIDDLE,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n  {\n    boneName: BoneName.SPINE_UPPER,\n    minRotation: new THREE.Vector3(-0.3, -0.5, -0.3),\n    maxRotation: new THREE.Vector3(0.3, 0.5, 0.3),\n    canTwist: true,\n  },\n];\n\n/**\n * Bone chains for IK (Inverse Kinematics)\n *\n * Defines logical bone chains for limbs, used for IK solving\n * and animation retargeting.\n *\n * @korean 뼈체인들\n */\nexport const BONE_CHAINS: BoneChain[] = [\n  // Left arm chain\n  {\n    name: \"left_arm\",\n    startBone: BoneName.SHOULDER_L,\n    endBone: BoneName.HAND_L,\n    bones: [\n      BoneName.SHOULDER_L,\n      BoneName.UPPER_ARM_L,\n      BoneName.ELBOW_L,\n      BoneName.FOREARM_L,\n      BoneName.WRIST_L,\n      BoneName.HAND_L,\n    ],\n  },\n\n  // Right arm chain\n  {\n    name: \"right_arm\",\n    startBone: BoneName.SHOULDER_R,\n    endBone: BoneName.HAND_R,\n    bones: [\n      BoneName.SHOULDER_R,\n      BoneName.UPPER_ARM_R,\n      BoneName.ELBOW_R,\n      BoneName.FOREARM_R,\n      BoneName.WRIST_R,\n      BoneName.HAND_R,\n    ],\n  },\n\n  // Left leg chain\n  {\n    name: \"left_leg\",\n    startBone: BoneName.HIP_L,\n    endBone: BoneName.FOOT_L,\n    bones: [\n      BoneName.HIP_L,\n      BoneName.THIGH_L,\n      BoneName.KNEE_L,\n      BoneName.SHIN_L,\n      BoneName.FOOT_L,\n    ],\n  },\n\n  // Right leg chain\n  {\n    name: \"right_leg\",\n    startBone: BoneName.HIP_R,\n    endBone: BoneName.FOOT_R,\n    bones: [\n      BoneName.HIP_R,\n      BoneName.THIGH_R,\n      BoneName.KNEE_R,\n      BoneName.SHIN_R,\n      BoneName.FOOT_R,\n    ],\n  },\n\n  // Spine chain\n  {\n    name: \"spine\",\n    startBone: BoneName.PELVIS,\n    endBone: BoneName.HEAD,\n    bones: [\n      BoneName.PELVIS,\n      BoneName.SPINE_LOWER,\n      BoneName.SPINE_MIDDLE,\n      BoneName.SPINE_UPPER,\n      BoneName.NECK,\n      BoneName.HEAD,\n    ],\n  },\n];\n\n/**\n * Apply joint constraints to bone rotation\n *\n * Clamps bone rotation to anatomically correct ranges.\n * Prevents unrealistic poses like backward-bending elbows.\n *\n * @param bone - Bone to constrain\n * @param constraints - Joint constraint to apply\n *\n * @korean 관절제약적용\n */\nexport const applyJointConstraint = (\n  bone: Bone,\n  constraint: JointConstraint,\n): void => {\n  // Clamp X rotation\n  bone.rotation.x = Math.max(\n    constraint.minRotation.x,\n    Math.min(constraint.maxRotation.x, bone.rotation.x),\n  );\n\n  // Clamp Y rotation\n  bone.rotation.y = Math.max(\n    constraint.minRotation.y,\n    Math.min(constraint.maxRotation.y, bone.rotation.y),\n  );\n\n  // Clamp Z rotation\n  bone.rotation.z = Math.max(\n    constraint.minRotation.z,\n    Math.min(constraint.maxRotation.z, bone.rotation.z),\n  );\n};\n\n// Reusable matrix objects for world transform calculations (avoid allocations in useFrame)\nconst tempMatrix = new THREE.Matrix4();\nconst tempQuaternion = new THREE.Quaternion();\nconst tempScale = new THREE.Vector3();\n\n/**\n * Get world position of bone\n *\n * Calculates absolute world position by traversing parent chain.\n * Uses proper matrix multiplication to account for parent rotations.\n *\n * @param bone - Bone to get world position for\n * @returns World position as Vector3\n *\n * @korean 뼈의세계위치구하기\n */\nexport const getBoneWorldPosition = (bone: Bone): THREE.Vector3 => {\n  // Build the bone chain from root to this bone\n  const boneChain: Bone[] = [];\n  let currentBone: Bone | null = bone;\n  while (currentBone) {\n    boneChain.unshift(currentBone);\n    currentBone = currentBone.parent;\n  }\n\n  // Compose world matrix by multiplying all local transforms\n  const worldMatrix = new THREE.Matrix4();\n  worldMatrix.identity();\n\n  for (const b of boneChain) {\n    tempMatrix.compose(\n      b.position,\n      tempQuaternion.setFromEuler(b.rotation),\n      b.scale,\n    );\n    worldMatrix.multiply(tempMatrix);\n  }\n\n  // Extract world position from composed matrix\n  const worldPos = new THREE.Vector3();\n  worldMatrix.decompose(worldPos, tempQuaternion, tempScale);\n  return worldPos;\n};\n\n/**\n * Get world rotation of bone\n *\n * Calculates absolute world rotation by traversing parent chain.\n * Uses proper quaternion multiplication for correct rotation composition.\n *\n * @param bone - Bone to get world rotation for\n * @returns World rotation as Euler\n *\n * @korean 뼈의세계회전구하기\n */\nexport const getBoneWorldRotation = (bone: Bone): THREE.Euler => {\n  // Build the bone chain from root to this bone\n  const boneChain: Bone[] = [];\n  let currentBone: Bone | null = bone;\n  while (currentBone) {\n    boneChain.unshift(currentBone);\n    currentBone = currentBone.parent;\n  }\n\n  // Compose world rotation by multiplying quaternions (proper rotation composition)\n  const worldQuat = new THREE.Quaternion();\n  worldQuat.identity();\n\n  for (const b of boneChain) {\n    tempQuaternion.setFromEuler(b.rotation);\n    worldQuat.multiply(tempQuaternion);\n  }\n\n  // Convert back to Euler\n  const worldRot = new THREE.Euler();\n  worldRot.setFromQuaternion(worldQuat);\n  return worldRot;\n};\n\n/**\n * Reset bone to rest pose\n *\n * Resets bone position and rotation to default rest pose.\n * Useful for animation blending and initialization.\n *\n * @param bone - Bone to reset\n *\n * @korean 뼈를기본자세로초기화\n */\nexport const resetBoneToRestPose = (bone: Bone): void => {\n  bone.position.copy(bone.restPosition);\n  bone.rotation.copy(bone.restRotation);\n  bone.scale.set(1, 1, 1);\n};\n\n/**\n * Reset entire rig to rest pose\n *\n * Resets all bones in rig to rest pose.\n *\n * @param rig - Skeletal rig to reset\n *\n * @korean 골격을기본자세로초기화\n */\nexport const resetRigToRestPose = (rig: SkeletalRig): void => {\n  rig.bones.forEach((bone) => {\n    resetBoneToRestPose(bone);\n  });\n};\n\n/**\n * Create hand bones with 5 fingers\n *\n * Creates detailed hand structure with 5 fingers (thumb, index, middle, ring, pinky),\n * attached to an existing hand/palm bone.\n * Each finger has 3-4 bones for realistic animation.\n *\n * Finger bone structure:\n * - Thumb: 3 bones (metacarpal, proximal, distal) - no intermediate\n * - Other fingers: 4 bones (metacarpal, proximal, intermediate, distal)\n *\n * Total created by this function: 19 finger bones per hand (3 thumb + 4*4 other fingers),\n * all attached to the provided hand bone.\n *\n * @param handBone - Parent hand bone (acts as the palm/root for finger bones)\n * @param side - Hand side (\"left\" or \"right\")\n * @returns Map of finger bones added to the rig\n *\n * @korean 손뼈생성\n */\nexport const createHandBones = (\n  handBone: Bone,\n  side: \"left\" | \"right\",\n): Map<string, Bone> => {\n  const fingerBones = new Map<string, Bone>();\n\n  // Hand orientation: left hand extends to -X, right hand extends to +X\n  const sideMultiplier = side === \"left\" ? -1 : 1;\n\n  // Thumb (3 bones) - offset slightly toward palm center and forward\n  const thumbMeta = createBone(\n    `${\n      BoneName[`THUMB_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.015 * sideMultiplier, 0.02, 0.01],\n    0.025,\n  );\n  const thumbProx = createBone(\n    `${\n      BoneName[`THUMB_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    thumbMeta,\n    [0.015 * sideMultiplier, 0.015, 0.01],\n    0.02,\n  );\n  const thumbDist = createBone(\n    `${\n      BoneName[`THUMB_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    thumbProx,\n    [0.01 * sideMultiplier, 0.01, 0],\n    0.015,\n  );\n\n  fingerBones.set(thumbMeta.name, thumbMeta);\n  fingerBones.set(thumbProx.name, thumbProx);\n  fingerBones.set(thumbDist.name, thumbDist);\n\n  // Index finger (4 bones)\n  const indexMeta = createBone(\n    `${\n      BoneName[`INDEX_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.015 * sideMultiplier, 0.06, 0],\n    0.03,\n  );\n  const indexProx = createBone(\n    `${\n      BoneName[`INDEX_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexMeta,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const indexInter = createBone(\n    `${\n      BoneName[`INDEX_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexProx,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const indexDist = createBone(\n    `${\n      BoneName[`INDEX_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    indexInter,\n    [0, 0.015, 0],\n    0.015,\n  );\n\n  fingerBones.set(indexMeta.name, indexMeta);\n  fingerBones.set(indexProx.name, indexProx);\n  fingerBones.set(indexInter.name, indexInter);\n  fingerBones.set(indexDist.name, indexDist);\n\n  // Middle finger (4 bones) - longest finger\n  const middleMeta = createBone(\n    `${\n      BoneName[`MIDDLE_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [0.005 * sideMultiplier, 0.065, 0],\n    0.035,\n  );\n  const middleProx = createBone(\n    `${\n      BoneName[`MIDDLE_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleMeta,\n    [0, 0.03, 0],\n    0.03,\n  );\n  const middleInter = createBone(\n    `${\n      BoneName[`MIDDLE_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleProx,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const middleDist = createBone(\n    `${\n      BoneName[`MIDDLE_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    middleInter,\n    [0, 0.02, 0],\n    0.02,\n  );\n\n  fingerBones.set(middleMeta.name, middleMeta);\n  fingerBones.set(middleProx.name, middleProx);\n  fingerBones.set(middleInter.name, middleInter);\n  fingerBones.set(middleDist.name, middleDist);\n\n  // Ring finger (4 bones)\n  const ringMeta = createBone(\n    `${\n      BoneName[`RING_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [-0.005 * sideMultiplier, 0.06, 0],\n    0.03,\n  );\n  const ringProx = createBone(\n    `${\n      BoneName[`RING_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringMeta,\n    [0, 0.025, 0],\n    0.025,\n  );\n  const ringInter = createBone(\n    `${\n      BoneName[`RING_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringProx,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const ringDist = createBone(\n    `${\n      BoneName[`RING_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    ringInter,\n    [0, 0.015, 0],\n    0.015,\n  );\n\n  fingerBones.set(ringMeta.name, ringMeta);\n  fingerBones.set(ringProx.name, ringProx);\n  fingerBones.set(ringInter.name, ringInter);\n  fingerBones.set(ringDist.name, ringDist);\n\n  // Pinky finger (4 bones) - shortest finger\n  const pinkyMeta = createBone(\n    `${\n      BoneName[`PINKY_META_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    handBone,\n    [-0.015 * sideMultiplier, 0.05, 0],\n    0.025,\n  );\n  const pinkyProx = createBone(\n    `${\n      BoneName[`PINKY_PROX_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyMeta,\n    [0, 0.02, 0],\n    0.02,\n  );\n  const pinkyInter = createBone(\n    `${\n      BoneName[`PINKY_INTER_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyProx,\n    [0, 0.015, 0],\n    0.015,\n  );\n  const pinkyDist = createBone(\n    `${\n      BoneName[`PINKY_DIST_${side.toUpperCase()[0]}` as keyof typeof BoneName]\n    }`,\n    pinkyInter,\n    [0, 0.01, 0],\n    0.01,\n  );\n\n  fingerBones.set(pinkyMeta.name, pinkyMeta);\n  fingerBones.set(pinkyProx.name, pinkyProx);\n  fingerBones.set(pinkyInter.name, pinkyInter);\n  fingerBones.set(pinkyDist.name, pinkyDist);\n\n  return fingerBones;\n};\n\n/**\n * Create humanoid rig with optional hand bones\n *\n * Creates complete skeletal rig with optional detailed hand bones.\n * Hand bones can be excluded for performance (LOD system).\n *\n * @param includeHandBones - Whether to include detailed hand bones (default: false)\n * @returns Complete skeletal rig with or without hand bones\n *\n * @korean 손뼈포함골격생성\n */\nexport const createHumanoidRigWithHands = (\n  includeHandBones: boolean = false,\n): SkeletalRig => {\n  // Create base rig\n  const baseRig = createHumanoidRig();\n\n  // If hand bones not requested, return base rig\n  if (!includeHandBones) {\n    return baseRig;\n  }\n\n  // Get hand bones from base rig\n  const leftHand = baseRig.bones.get(BoneName.HAND_L);\n  const rightHand = baseRig.bones.get(BoneName.HAND_R);\n\n  if (!leftHand || !rightHand) {\n    console.warn(\"Hand bones not found in base rig\");\n    return baseRig;\n  }\n\n  // Create finger bones\n  const leftFingerBones = createHandBones(leftHand, \"left\");\n  const rightFingerBones = createHandBones(rightHand, \"right\");\n\n  // Add finger bones to rig bone map\n  leftFingerBones.forEach((bone, name) => {\n    baseRig.bones.set(name, bone);\n  });\n  rightFingerBones.forEach((bone, name) => {\n    baseRig.bones.set(name, bone);\n  });\n\n  return {\n    ...baseRig,\n    boneCount: baseRig.bones.size,\n  };\n};\n\n/**\n * Torso rotation constraints for anatomically correct upper/lower body movement\n *\n * Defines limits and behavior for independent torso rotation relative to hips,\n * enabling realistic strafing and lateral movement while facing opponent.\n *\n * Korean terminology:\n * - 허리회전 (Heorhwoejeon) - Torso rotation\n * - 해부학적제약 (Haebuhakjeok Jeyak) - Anatomical constraints\n *\n * @korean 허리회전제약조건\n */\nexport const TORSO_CONSTRAINTS = {\n  /**\n   * Maximum torso rotation relative to hips (radians)\n   * ±90° = π/2 radians - anatomically safe rotation limit\n   *\n   * @korean 최대회전각도\n   */\n  MAX_ROTATION: Math.PI / 2,\n\n  /**\n   * Minimum torso rotation relative to hips (radians)\n   * -90° = -π/2 radians\n   *\n   * @korean 최소회전각도\n   */\n  MIN_ROTATION: -Math.PI / 2,\n\n  /**\n   * Target interpolation time in seconds\n   * 200ms provides smooth, natural rotation feel\n   *\n   * @korean 보간시간\n   */\n  INTERPOLATION_TIME: 0.2,\n\n  /**\n   * Power modifier range for hip rotation\n   * [min, max] = [10%, 30%] damage bonus from proper hip engagement\n   *\n   * @korean 파워배율범위\n   */\n  POWER_MODIFIER_RANGE: [0.1, 0.3] as const,\n} as const;\n\n/**\n * Calculate torso rotation to face opponent while moving\n *\n * Determines optimal torso rotation angle to keep upper body facing opponent\n * while hips/legs are oriented in movement direction. Enforces anatomical\n * constraints (±90° max rotation).\n *\n * @param currentPosition - Player's current world position\n * @param opponentPosition - Opponent's current world position\n * @param _movementDirection - Direction of player movement (reserved for future use)\n * @param hipRotation - Current hip/pelvis rotation in radians\n * @returns Torso rotation in radians relative to hips (clamped to ±90°)\n *\n * @example\n * ```typescript\n * const playerPos = new THREE.Vector3(0, 0, 0);\n * const opponentPos = new THREE.Vector3(0, 0, 5); // Directly in front along Z+\n * const moveDir = new THREE.Vector3(0, 0, 1); // Moving forward\n * const hipRot = 0; // Hips facing forward (Z+)\n *\n * const torsoRot = calculateTorsoRotation(playerPos, opponentPos, moveDir, hipRot);\n * // Returns 0 (opponent is already aligned with hips)\n * ```\n *\n * @korean 상대를향한허리회전계산\n */\nexport function calculateTorsoRotation(\n  currentPosition: THREE.Vector3,\n  opponentPosition: THREE.Vector3,\n  _movementDirection: THREE.Vector3,\n  hipRotation: number,\n): number {\n  // Calculate angle to opponent\n  const directionToOpponent = opponentPosition\n    .clone()\n    .sub(currentPosition)\n    .normalize();\n  // Use atan2(x, z) - X is horizontal, Z is forward/back in Three.js\n  const angleToOpponent = Math.atan2(\n    directionToOpponent.x,\n    directionToOpponent.z,\n  );\n\n  // Calculate torso rotation relative to hips\n  let torsoRotation = angleToOpponent - hipRotation;\n\n  // Normalize to -π to π range\n  while (torsoRotation > Math.PI) torsoRotation -= 2 * Math.PI;\n  while (torsoRotation < -Math.PI) torsoRotation += 2 * Math.PI;\n\n  // Apply anatomical constraints (±90°)\n  torsoRotation = Math.max(\n    TORSO_CONSTRAINTS.MIN_ROTATION,\n    Math.min(TORSO_CONSTRAINTS.MAX_ROTATION, torsoRotation),\n  );\n\n  return torsoRotation;\n}\n\n/**\n * Calculate damage modifier from hip rotation\n *\n * Determines power bonus applied to techniques based on hip rotation angle.\n * Greater hip rotation generates more power through proper biomechanics,\n * with strikes benefiting most from full rotation.\n *\n * @param hipRotationAngle - Hip rotation angle in radians (typically from torso twist)\n * @param techniqueType - Type of technique ('strike', 'throw', or 'joint')\n * @returns Damage multiplier (1.0-1.3 for strikes, 1.0-1.1 for throws/joints)\n *\n * @example\n * ```typescript\n * // Full hip rotation on strike technique\n * const modifier = calculateHipRotationPowerModifier(Math.PI / 2, 'strike');\n * // Returns 1.30 (30% damage bonus)\n *\n * // Half rotation on throw\n * const throwMod = calculateHipRotationPowerModifier(Math.PI / 4, 'throw');\n * // Returns 1.05 (5% damage bonus)\n * ```\n *\n * @korean 허리회전으로인한데미지배율계산\n */\nexport function calculateHipRotationPowerModifier(\n  hipRotationAngle: number,\n  techniqueType: \"strike\" | \"throw\" | \"joint\",\n): number {\n  // Normalize rotation to 0-1 range (0 = no rotation, 1 = max rotation)\n  // Clamp to max rotation first to handle any values exceeding ±90°\n  const clampedAngle = Math.max(\n    -TORSO_CONSTRAINTS.MAX_ROTATION,\n    Math.min(TORSO_CONSTRAINTS.MAX_ROTATION, Math.abs(hipRotationAngle)),\n  );\n  const normalizedRotation = clampedAngle / TORSO_CONSTRAINTS.MAX_ROTATION;\n\n  // Strikes benefit most from hip rotation (up to 30% bonus)\n  // Throws get moderate benefit (up to 10% bonus)\n  // Joint locks get minimal benefit (up to 10% bonus)\n  const baseModifier = techniqueType === \"strike\" ? 0.3 : 0.1;\n\n  return 1.0 + normalizedRotation * baseModifier;\n}\n"],"mappings":"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"}

package/lib/systems/animation/catalogs/RecoveryAnimations.d.ts

@@ -94,7 +94,6 @@ export declare const RECOVERY_DEFENSIVE_KEYFRAMES: readonly RecoveryKeyframe[];
  * @param recoveryType - Type of recovery animation
  * @returns Array of keyframes for that recovery type
  *
- * @public
  * @korean 기상키프레임가져오기
  */
 export declare function getRecoveryKeyframes(recoveryType: RecoveryAnimationType): readonly RecoveryKeyframe[];
@@ -108,7 +107,6 @@ export declare function getRecoveryKeyframes(recoveryType: RecoveryAnimationType
  * @param frame - Current frame number (0-indexed)
  * @returns True if player is vulnerable at this frame
  *
- * @public
  * @korean 취약프레임확인
  */
 export declare function isVulnerableFrame(recoveryType: RecoveryAnimationType, frame: number): boolean;
@@ -130,7 +128,6 @@ export declare function isVulnerableFrame(recoveryType: RecoveryAnimationType, f
  * // Returns: "roll_recovery" (default for side positions)
  * ```
  *
- * @public
  * @korean 기상유형결정
  */
 export declare function determineRecoveryType(groundState: GroundState): RecoveryAnimationType;
@@ -140,7 +137,6 @@ export declare function determineRecoveryType(groundState: GroundState): Recover
  * @param recoveryType - Recovery animation type
  * @returns Animation state name
  *
- * @public
  * @korean 기상애니메이션상태
  */
 export declare function getRecoveryAnimationState(recoveryType: RecoveryAnimationType): string;
@@ -177,7 +173,6 @@ export declare const RECOVERY_CONFIGS: Record<RecoveryAnimationType, RecoveryCon
  * @param recoveryType - Recovery animation type
  * @returns Recovery configuration
  *
- * @public
  * @korean 기상설정가져오기
  */
 export declare function getRecoveryConfig(recoveryType: RecoveryAnimationType): RecoveryConfig;

package/lib/systems/animation/catalogs/RecoveryAnimations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecoveryAnimations.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAMxE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,+BAA+B;IAC/B,QAAQ,CAAC,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5D,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAmDtD,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAmDvD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAmDrD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,gBAAgB,EAmD1D,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,qBAAqB,GAClC,SAAS,gBAAgB,EAAE,CAa7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EACnC,KAAK,EAAE,MAAM,GACZ,OAAO,CAcT;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,qBAAqB,CAEvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,qBAAqB,EAAE,cAAc,CA6B1E,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,GAClC,cAAc,CAEhB"}
+{"version":3,"file":"RecoveryAnimations.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAMxE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,+BAA+B;IAC/B,QAAQ,CAAC,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5D,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAmDtD,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAmDvD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAmDrD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,gBAAgB,EAmD1D,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,qBAAqB,GAClC,SAAS,gBAAgB,EAAE,CAa7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EACnC,KAAK,EAAE,MAAM,GACZ,OAAO,CAcT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,qBAAqB,CAEvB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,qBAAqB,EAAE,cAAc,CA6B1E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,GAClC,cAAc,CAEhB"}

package/lib/systems/animation/catalogs/RecoveryAnimations.js

@@ -342,7 +342,6 @@ var RECOVERY_DEFENSIVE_KEYFRAMES = [
 * @param recoveryType - Type of recovery animation
 * @returns Array of keyframes for that recovery type
 *
-* @public
 * @korean 기상키프레임가져오기
 */
 function getRecoveryKeyframes(recoveryType) {
@@ -364,7 +363,6 @@ function getRecoveryKeyframes(recoveryType) {
 * @param frame - Current frame number (0-indexed)
 * @returns True if player is vulnerable at this frame
 *
-* @public
 * @korean 취약프레임확인
 */
 function isVulnerableFrame(recoveryType, frame) {
@@ -392,7 +390,6 @@ function isVulnerableFrame(recoveryType, frame) {
 * // Returns: "roll_recovery" (default for side positions)
 * ```
 *
-* @public
 * @korean 기상유형결정
 */
 function determineRecoveryType(groundState) {
@@ -404,7 +401,6 @@ function determineRecoveryType(groundState) {
 * @param recoveryType - Recovery animation type
 * @returns Animation state name
 *
-* @public
 * @korean 기상애니메이션상태
 */
 function getRecoveryAnimationState(recoveryType) {
@@ -453,7 +449,6 @@ var RECOVERY_CONFIGS = {
 * @param recoveryType - Recovery animation type
 * @returns Recovery configuration
 *
-* @public
 * @korean 기상설정가져오기
 */
 function getRecoveryConfig(recoveryType) {

package/lib/systems/animation/catalogs/RecoveryAnimations.js.map

@@ -1 +1 @@
-{"version":3,"file":"RecoveryAnimations.js","names":[],"sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"sourcesContent":["/**\n * Recovery Animation System for Black Trigram\n *\n * Implements realistic recovery animations for standing up from fallen states.\n * Based on Korean martial arts recovery techniques (기상 - Gisang).\n *\n * @module systems/animation/RecoveryAnimations\n * @category Animation\n * @korean 기상애니메이션\n */\n\nimport type { GroundState, RecoveryAnimationType } from \"../core/types\";\nimport {\n  GROUND_STATE_TO_RECOVERY,\n  RECOVERY_TYPE_TO_ANIMATION,\n} from \"../core/types\";\n\n/**\n * Recovery animation keyframe data structure\n *\n * Defines key poses during recovery animations for skeletal rendering.\n * Each keyframe specifies body positions at critical moments.\n *\n * @korean 기상키프레임\n */\nexport interface RecoveryKeyframe {\n  /** Frame number (0-indexed) */\n  readonly frame: number;\n\n  /** Torso rotation (radians) */\n  readonly torsoRotation: { x: number; y: number; z: number };\n\n  /** Center of mass vertical position (0-1, 1=standing, 0=ground) */\n  readonly centerOfMassHeight: number;\n\n  /** Description of this keyframe */\n  readonly description: {\n    readonly korean: string;\n    readonly english: string;\n  };\n\n  /** Whether player is vulnerable at this frame */\n  readonly vulnerable: boolean;\n}\n\n/**\n * Prone stand-up keyframes (엎드린 기상)\n *\n * 30 frames (500ms) sequence:\n * - Frames 0-8: Push up with hands, torso lifts\n * - Frames 9-18: Legs swing under body, kneeling position\n * - Frames 19-24: Rise from kneeling to standing (vulnerable)\n * - Frames 25-29: Final stance adjustment (interruptible)\n *\n * @korean 엎드린기상키프레임\n */\nexport const RECOVERY_PRONE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.57, y: 0, z: 0 }, // Face down (90° forward)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"엎드린 자세\",\n      english: \"Prone position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 8,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Hands pushing, torso lifting\n    centerOfMassHeight: 0.2,\n    description: {\n      korean: \"손으로 밀어 올리기\",\n      english: \"Hands push up torso\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.7, y: 0, z: 0 }, // Kneeling position\n    centerOfMassHeight: 0.5,\n    description: {\n      korean: \"무릎 꿇기\",\n      english: \"Kneeling position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 24,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Rising to standing\n    centerOfMassHeight: 0.75,\n    description: {\n      korean: \"일어서기\",\n      english: \"Rising to standing\",\n    },\n    vulnerable: false, // Last 6 frames (24-30) entering safe zone\n  },\n  {\n    frame: 29,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (25-30) are not vulnerable\n  },\n] as const;\n\n/**\n * Supine stand-up keyframes (누운 기상)\n *\n * 36 frames (600ms) sequence:\n * - Frames 0-10: Abs crunch sit-up motion\n * - Frames 11-22: Forward roll onto feet\n * - Frames 23-30: Feet plant, rise to standing (vulnerable)\n * - Frames 31-35: Final stance adjustment (interruptible)\n *\n * @korean 누운기상키프레임\n */\nexport const RECOVERY_SUPINE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: -1.57, y: 0, z: 0 }, // Face up (90° back)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"누운 자세\",\n      english: \"Supine position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 10,\n    torsoRotation: { x: -0.9, y: 0, z: 0 }, // Sit-up motion\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"윗몸 일으키기\",\n      english: \"Sit-up motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 22,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Forward roll\n    centerOfMassHeight: 0.4,\n    description: {\n      korean: \"전방 구르기\",\n      english: \"Forward roll\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 30,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Feet planted, rising\n    centerOfMassHeight: 0.7,\n    description: {\n      korean: \"발 디디고 일어서기\",\n      english: \"Feet planted, rising\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) entering safe zone\n  },\n  {\n    frame: 35,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) are not vulnerable\n  },\n] as const;\n\n/**\n * Roll recovery keyframes (회전기상)\n *\n * 24 frames (400ms) sequence - FAST recovery\n * - Frames 0-6: Roll to side, momentum building\n * - Frames 7-14: Spring to feet with explosive movement\n * - Frames 15-18: Quick stance (vulnerable)\n * - Frames 19-23: Combat ready (interruptible)\n *\n * Costs 20 stamina for speed advantage.\n *\n * @korean 회전기상키프레임\n */\nexport const RECOVERY_ROLL_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 0, y: 1.57, z: 1.57 }, // Side position (90° roll)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"측면 자세\",\n      english: \"Side position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 6,\n    torsoRotation: { x: 0.3, y: 0.8, z: 0.9 }, // Rolling motion\n    centerOfMassHeight: 0.25,\n    description: {\n      korean: \"구르기 움직임\",\n      english: \"Rolling motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Springing to feet\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"발로 튀어오르기\",\n      english: \"Spring to feet\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.1, y: 0, z: 0 }, // Quick stance\n    centerOfMassHeight: 0.85,\n    description: {\n      korean: \"빠른 자세\",\n      english: \"Quick stance\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) entering safe zone\n  },\n  {\n    frame: 23,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Combat ready (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"전투 준비\",\n      english: \"Combat ready\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) are not vulnerable\n  },\n] as const;\n\n/**\n * Defensive getup keyframes (방어기상)\n *\n * 42 frames (700ms) sequence - SLOW but protected\n * - Frames 0-14: Slow rise with arms guarding head/torso\n * - Frames 15-28: Gradual stand with maintained guard\n * - Frames 29-36: Stance formation with guard (50% damage reduction)\n * - Frames 37-41: Ready stance (interruptible)\n *\n * Provides 50% damage reduction throughout animation.\n *\n * @korean 방어기상키프레임\n */\nexport const RECOVERY_DEFENSIVE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Grounded, arms up\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"지면에서 팔 올리기\",\n      english: \"Grounded, arms up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.9, y: 0, z: 0 }, // Slow rise, guard maintained\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"천천히 일어나며 방어\",\n      english: \"Slow rise, guarded\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 28,\n    torsoRotation: { x: 0.5, y: 0, z: 0 }, // Gradual stand, guard up\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"점차 서며 방어 유지\",\n      english: \"Gradual stand, guard up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 36,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Stance formation, guarded\n    centerOfMassHeight: 0.8,\n    description: {\n      korean: \"자세 형성, 방어 상태\",\n      english: \"Stance formation, guarded\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) entering safe zone (still 50% reduction)\n  },\n  {\n    frame: 41,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Ready stance (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"준비 자세\",\n      english: \"Ready stance\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) are not vulnerable\n  },\n] as const;\n\n/**\n * Get keyframes for a specific recovery type\n *\n * @param recoveryType - Type of recovery animation\n * @returns Array of keyframes for that recovery type\n *\n * @public\n * @korean 기상키프레임가져오기\n */\nexport function getRecoveryKeyframes(\n  recoveryType: RecoveryAnimationType\n): readonly RecoveryKeyframe[] {\n  switch (recoveryType) {\n    case \"prone_standup\":\n      return RECOVERY_PRONE_KEYFRAMES;\n    case \"supine_standup\":\n      return RECOVERY_SUPINE_KEYFRAMES;\n    case \"roll_recovery\":\n      return RECOVERY_ROLL_KEYFRAMES;\n    case \"defensive_getup\":\n      return RECOVERY_DEFENSIVE_KEYFRAMES;\n    default:\n      return RECOVERY_ROLL_KEYFRAMES;\n  }\n}\n\n/**\n * Check if a frame in a recovery animation is vulnerable\n *\n * Vulnerability is determined by keyframe data. The last 6 frames\n * of each recovery animation are interruptible and not vulnerable.\n *\n * @param recoveryType - Type of recovery animation\n * @param frame - Current frame number (0-indexed)\n * @returns True if player is vulnerable at this frame\n *\n * @public\n * @korean 취약프레임확인\n */\nexport function isVulnerableFrame(\n  recoveryType: RecoveryAnimationType,\n  frame: number\n): boolean {\n  const keyframes = getRecoveryKeyframes(recoveryType);\n\n  // Find the keyframe for this frame or the previous keyframe\n  let currentKeyframe = keyframes[0];\n  for (const kf of keyframes) {\n    if (kf.frame <= frame) {\n      currentKeyframe = kf;\n    } else {\n      break;\n    }\n  }\n\n  return currentKeyframe.vulnerable;\n}\n\n/**\n * Determine appropriate recovery animation from ground state\n *\n * Uses ground state to select default recovery animation.\n * Side positions default to roll recovery for dynamic movement.\n *\n * @param groundState - Current ground position\n * @returns Default recovery animation type\n *\n * @example\n * ```typescript\n * const recoveryType = determineRecoveryType(\"prone\");\n * // Returns: \"prone_standup\"\n *\n * const sideRecovery = determineRecoveryType(\"side_left\");\n * // Returns: \"roll_recovery\" (default for side positions)\n * ```\n *\n * @public\n * @korean 기상유형결정\n */\nexport function determineRecoveryType(\n  groundState: GroundState\n): RecoveryAnimationType {\n  return GROUND_STATE_TO_RECOVERY[groundState];\n}\n\n/**\n * Get recovery animation state from recovery type\n *\n * @param recoveryType - Recovery animation type\n * @returns Animation state name\n *\n * @public\n * @korean 기상애니메이션상태\n */\nexport function getRecoveryAnimationState(\n  recoveryType: RecoveryAnimationType\n): string {\n  return RECOVERY_TYPE_TO_ANIMATION[recoveryType];\n}\n\n/**\n * Recovery animation configuration\n *\n * Additional properties for recovery animations beyond base AnimationConfig.\n *\n * @korean 기상설정\n */\nexport interface RecoveryConfig {\n  /** Recovery animation type */\n  readonly type: RecoveryAnimationType;\n\n  /** Stamina cost to execute (0 for normal recoveries) */\n  readonly staminaCost: number;\n\n  /** Damage reduction percentage during animation (0-1) */\n  readonly damageReduction: number;\n\n  /** Number of initial vulnerable frames (first N frames are vulnerable to damage) */\n  readonly vulnerableFrames: number;\n\n  /** Frame when player becomes interruptible (last 6 frames typically) */\n  readonly interruptibleFrame: number;\n}\n\n/**\n * Recovery animation configurations\n *\n * Defines stamina costs, damage reduction, and vulnerability windows.\n *\n * @korean 기상설정맵\n */\nexport const RECOVERY_CONFIGS: Record<RecoveryAnimationType, RecoveryConfig> = {\n  prone_standup: {\n    type: \"prone_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 24, // Vulnerable for first 24 frames (80%)\n    interruptibleFrame: 24, // Last 6 frames (25-30) are interruptible\n  },\n  supine_standup: {\n    type: \"supine_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 30, // Vulnerable for first 30 frames (83%)\n    interruptibleFrame: 30, // Last 6 frames (30-36) are interruptible\n  },\n  roll_recovery: {\n    type: \"roll_recovery\",\n    staminaCost: 20, // Costs stamina for speed\n    damageReduction: 0,\n    vulnerableFrames: 18, // Vulnerable for first 18 frames (75%)\n    interruptibleFrame: 18, // Last 6 frames (18-24) are interruptible\n  },\n  defensive_getup: {\n    type: \"defensive_getup\",\n    staminaCost: 0,\n    damageReduction: 0.5, // 50% damage reduction throughout\n    vulnerableFrames: 36, // Vulnerable for first 36 frames (86%)\n    interruptibleFrame: 36, // Last 6 frames (36-42) are interruptible\n  },\n};\n\n/**\n * Get recovery configuration\n *\n * @param recoveryType - Recovery animation type\n * @returns Recovery configuration\n *\n * @public\n * @korean 기상설정가져오기\n */\nexport function getRecoveryConfig(\n  recoveryType: RecoveryAnimationType\n): RecoveryConfig {\n  return RECOVERY_CONFIGS[recoveryType];\n}\n"],"mappings":"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"}
+{"version":3,"file":"RecoveryAnimations.js","names":[],"sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"sourcesContent":["/**\n * Recovery Animation System for Black Trigram\n *\n * Implements realistic recovery animations for standing up from fallen states.\n * Based on Korean martial arts recovery techniques (기상 - Gisang).\n *\n * @module systems/animation/RecoveryAnimations\n * @category Animation\n * @korean 기상애니메이션\n */\n\nimport type { GroundState, RecoveryAnimationType } from \"../core/types\";\nimport {\n  GROUND_STATE_TO_RECOVERY,\n  RECOVERY_TYPE_TO_ANIMATION,\n} from \"../core/types\";\n\n/**\n * Recovery animation keyframe data structure\n *\n * Defines key poses during recovery animations for skeletal rendering.\n * Each keyframe specifies body positions at critical moments.\n *\n * @korean 기상키프레임\n */\nexport interface RecoveryKeyframe {\n  /** Frame number (0-indexed) */\n  readonly frame: number;\n\n  /** Torso rotation (radians) */\n  readonly torsoRotation: { x: number; y: number; z: number };\n\n  /** Center of mass vertical position (0-1, 1=standing, 0=ground) */\n  readonly centerOfMassHeight: number;\n\n  /** Description of this keyframe */\n  readonly description: {\n    readonly korean: string;\n    readonly english: string;\n  };\n\n  /** Whether player is vulnerable at this frame */\n  readonly vulnerable: boolean;\n}\n\n/**\n * Prone stand-up keyframes (엎드린 기상)\n *\n * 30 frames (500ms) sequence:\n * - Frames 0-8: Push up with hands, torso lifts\n * - Frames 9-18: Legs swing under body, kneeling position\n * - Frames 19-24: Rise from kneeling to standing (vulnerable)\n * - Frames 25-29: Final stance adjustment (interruptible)\n *\n * @korean 엎드린기상키프레임\n */\nexport const RECOVERY_PRONE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.57, y: 0, z: 0 }, // Face down (90° forward)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"엎드린 자세\",\n      english: \"Prone position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 8,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Hands pushing, torso lifting\n    centerOfMassHeight: 0.2,\n    description: {\n      korean: \"손으로 밀어 올리기\",\n      english: \"Hands push up torso\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.7, y: 0, z: 0 }, // Kneeling position\n    centerOfMassHeight: 0.5,\n    description: {\n      korean: \"무릎 꿇기\",\n      english: \"Kneeling position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 24,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Rising to standing\n    centerOfMassHeight: 0.75,\n    description: {\n      korean: \"일어서기\",\n      english: \"Rising to standing\",\n    },\n    vulnerable: false, // Last 6 frames (24-30) entering safe zone\n  },\n  {\n    frame: 29,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (25-30) are not vulnerable\n  },\n] as const;\n\n/**\n * Supine stand-up keyframes (누운 기상)\n *\n * 36 frames (600ms) sequence:\n * - Frames 0-10: Abs crunch sit-up motion\n * - Frames 11-22: Forward roll onto feet\n * - Frames 23-30: Feet plant, rise to standing (vulnerable)\n * - Frames 31-35: Final stance adjustment (interruptible)\n *\n * @korean 누운기상키프레임\n */\nexport const RECOVERY_SUPINE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: -1.57, y: 0, z: 0 }, // Face up (90° back)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"누운 자세\",\n      english: \"Supine position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 10,\n    torsoRotation: { x: -0.9, y: 0, z: 0 }, // Sit-up motion\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"윗몸 일으키기\",\n      english: \"Sit-up motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 22,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Forward roll\n    centerOfMassHeight: 0.4,\n    description: {\n      korean: \"전방 구르기\",\n      english: \"Forward roll\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 30,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Feet planted, rising\n    centerOfMassHeight: 0.7,\n    description: {\n      korean: \"발 디디고 일어서기\",\n      english: \"Feet planted, rising\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) entering safe zone\n  },\n  {\n    frame: 35,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) are not vulnerable\n  },\n] as const;\n\n/**\n * Roll recovery keyframes (회전기상)\n *\n * 24 frames (400ms) sequence - FAST recovery\n * - Frames 0-6: Roll to side, momentum building\n * - Frames 7-14: Spring to feet with explosive movement\n * - Frames 15-18: Quick stance (vulnerable)\n * - Frames 19-23: Combat ready (interruptible)\n *\n * Costs 20 stamina for speed advantage.\n *\n * @korean 회전기상키프레임\n */\nexport const RECOVERY_ROLL_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 0, y: 1.57, z: 1.57 }, // Side position (90° roll)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"측면 자세\",\n      english: \"Side position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 6,\n    torsoRotation: { x: 0.3, y: 0.8, z: 0.9 }, // Rolling motion\n    centerOfMassHeight: 0.25,\n    description: {\n      korean: \"구르기 움직임\",\n      english: \"Rolling motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Springing to feet\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"발로 튀어오르기\",\n      english: \"Spring to feet\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.1, y: 0, z: 0 }, // Quick stance\n    centerOfMassHeight: 0.85,\n    description: {\n      korean: \"빠른 자세\",\n      english: \"Quick stance\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) entering safe zone\n  },\n  {\n    frame: 23,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Combat ready (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"전투 준비\",\n      english: \"Combat ready\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) are not vulnerable\n  },\n] as const;\n\n/**\n * Defensive getup keyframes (방어기상)\n *\n * 42 frames (700ms) sequence - SLOW but protected\n * - Frames 0-14: Slow rise with arms guarding head/torso\n * - Frames 15-28: Gradual stand with maintained guard\n * - Frames 29-36: Stance formation with guard (50% damage reduction)\n * - Frames 37-41: Ready stance (interruptible)\n *\n * Provides 50% damage reduction throughout animation.\n *\n * @korean 방어기상키프레임\n */\nexport const RECOVERY_DEFENSIVE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Grounded, arms up\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"지면에서 팔 올리기\",\n      english: \"Grounded, arms up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.9, y: 0, z: 0 }, // Slow rise, guard maintained\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"천천히 일어나며 방어\",\n      english: \"Slow rise, guarded\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 28,\n    torsoRotation: { x: 0.5, y: 0, z: 0 }, // Gradual stand, guard up\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"점차 서며 방어 유지\",\n      english: \"Gradual stand, guard up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 36,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Stance formation, guarded\n    centerOfMassHeight: 0.8,\n    description: {\n      korean: \"자세 형성, 방어 상태\",\n      english: \"Stance formation, guarded\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) entering safe zone (still 50% reduction)\n  },\n  {\n    frame: 41,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Ready stance (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"준비 자세\",\n      english: \"Ready stance\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) are not vulnerable\n  },\n] as const;\n\n/**\n * Get keyframes for a specific recovery type\n *\n * @param recoveryType - Type of recovery animation\n * @returns Array of keyframes for that recovery type\n *\n * @korean 기상키프레임가져오기\n */\nexport function getRecoveryKeyframes(\n  recoveryType: RecoveryAnimationType\n): readonly RecoveryKeyframe[] {\n  switch (recoveryType) {\n    case \"prone_standup\":\n      return RECOVERY_PRONE_KEYFRAMES;\n    case \"supine_standup\":\n      return RECOVERY_SUPINE_KEYFRAMES;\n    case \"roll_recovery\":\n      return RECOVERY_ROLL_KEYFRAMES;\n    case \"defensive_getup\":\n      return RECOVERY_DEFENSIVE_KEYFRAMES;\n    default:\n      return RECOVERY_ROLL_KEYFRAMES;\n  }\n}\n\n/**\n * Check if a frame in a recovery animation is vulnerable\n *\n * Vulnerability is determined by keyframe data. The last 6 frames\n * of each recovery animation are interruptible and not vulnerable.\n *\n * @param recoveryType - Type of recovery animation\n * @param frame - Current frame number (0-indexed)\n * @returns True if player is vulnerable at this frame\n *\n * @korean 취약프레임확인\n */\nexport function isVulnerableFrame(\n  recoveryType: RecoveryAnimationType,\n  frame: number\n): boolean {\n  const keyframes = getRecoveryKeyframes(recoveryType);\n\n  // Find the keyframe for this frame or the previous keyframe\n  let currentKeyframe = keyframes[0];\n  for (const kf of keyframes) {\n    if (kf.frame <= frame) {\n      currentKeyframe = kf;\n    } else {\n      break;\n    }\n  }\n\n  return currentKeyframe.vulnerable;\n}\n\n/**\n * Determine appropriate recovery animation from ground state\n *\n * Uses ground state to select default recovery animation.\n * Side positions default to roll recovery for dynamic movement.\n *\n * @param groundState - Current ground position\n * @returns Default recovery animation type\n *\n * @example\n * ```typescript\n * const recoveryType = determineRecoveryType(\"prone\");\n * // Returns: \"prone_standup\"\n *\n * const sideRecovery = determineRecoveryType(\"side_left\");\n * // Returns: \"roll_recovery\" (default for side positions)\n * ```\n *\n * @korean 기상유형결정\n */\nexport function determineRecoveryType(\n  groundState: GroundState\n): RecoveryAnimationType {\n  return GROUND_STATE_TO_RECOVERY[groundState];\n}\n\n/**\n * Get recovery animation state from recovery type\n *\n * @param recoveryType - Recovery animation type\n * @returns Animation state name\n *\n * @korean 기상애니메이션상태\n */\nexport function getRecoveryAnimationState(\n  recoveryType: RecoveryAnimationType\n): string {\n  return RECOVERY_TYPE_TO_ANIMATION[recoveryType];\n}\n\n/**\n * Recovery animation configuration\n *\n * Additional properties for recovery animations beyond base AnimationConfig.\n *\n * @korean 기상설정\n */\nexport interface RecoveryConfig {\n  /** Recovery animation type */\n  readonly type: RecoveryAnimationType;\n\n  /** Stamina cost to execute (0 for normal recoveries) */\n  readonly staminaCost: number;\n\n  /** Damage reduction percentage during animation (0-1) */\n  readonly damageReduction: number;\n\n  /** Number of initial vulnerable frames (first N frames are vulnerable to damage) */\n  readonly vulnerableFrames: number;\n\n  /** Frame when player becomes interruptible (last 6 frames typically) */\n  readonly interruptibleFrame: number;\n}\n\n/**\n * Recovery animation configurations\n *\n * Defines stamina costs, damage reduction, and vulnerability windows.\n *\n * @korean 기상설정맵\n */\nexport const RECOVERY_CONFIGS: Record<RecoveryAnimationType, RecoveryConfig> = {\n  prone_standup: {\n    type: \"prone_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 24, // Vulnerable for first 24 frames (80%)\n    interruptibleFrame: 24, // Last 6 frames (25-30) are interruptible\n  },\n  supine_standup: {\n    type: \"supine_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 30, // Vulnerable for first 30 frames (83%)\n    interruptibleFrame: 30, // Last 6 frames (30-36) are interruptible\n  },\n  roll_recovery: {\n    type: \"roll_recovery\",\n    staminaCost: 20, // Costs stamina for speed\n    damageReduction: 0,\n    vulnerableFrames: 18, // Vulnerable for first 18 frames (75%)\n    interruptibleFrame: 18, // Last 6 frames (18-24) are interruptible\n  },\n  defensive_getup: {\n    type: \"defensive_getup\",\n    staminaCost: 0,\n    damageReduction: 0.5, // 50% damage reduction throughout\n    vulnerableFrames: 36, // Vulnerable for first 36 frames (86%)\n    interruptibleFrame: 36, // Last 6 frames (36-42) are interruptible\n  },\n};\n\n/**\n * Get recovery configuration\n *\n * @param recoveryType - Recovery animation type\n * @returns Recovery configuration\n *\n * @korean 기상설정가져오기\n */\nexport function getRecoveryConfig(\n  recoveryType: RecoveryAnimationType\n): RecoveryConfig {\n  return RECOVERY_CONFIGS[recoveryType];\n}\n"],"mappings":"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"}

package/lib/systems/animation/core/AnimationHitTiming.d.ts

@@ -44,7 +44,6 @@ import { AnimationType } from "../builders/MartialArtsAnimationBuilder";
  * };
  * ```
  *
- * @public
  * @korean 타격창타이밍
  */
 export interface AnimationHitWindow {
@@ -86,7 +85,6 @@ export interface AnimationHitWindow {
  *
  * **Korean**: 기술 타격 타이밍 설정
  *
- * @public
  * @korean 기술타격타이밍
  */
 export interface TechniqueHitTiming {
@@ -116,7 +114,6 @@ export interface TechniqueHitTiming {
  * Only includes timing for techniques with actual hit windows.
  * Movement and non-combat animations can query this and will get undefined.
  *
- * @public
  * @korean 애니메이션타격타이밍데이터베이스
  */
 export declare const ANIMATION_HIT_TIMING: Partial<Record<AnimationType, TechniqueHitTiming>>;
@@ -136,7 +133,6 @@ export declare const ANIMATION_HIT_TIMING: Partial<Record<AnimationType, Techniq
  * }
  * ```
  *
- * @public
  * @korean 애니메이션타격타이밍가져오기
  */
 export declare function getAnimationHitTiming(animationType: AnimationType): TechniqueHitTiming | undefined;
@@ -155,7 +151,6 @@ export declare function getAnimationHitTiming(animationType: AnimationType): Tec
  * // Returns true (0.15s is within jab's 0.10-0.25s window)
  * ```
  *
- * @public
  * @korean 타격가능시간확인
  */
 export declare function isWithinHitWindow(animationType: AnimationType, currentTime: number): boolean;
@@ -177,7 +172,6 @@ export declare function isWithinHitWindow(animationType: AnimationType, currentT
  * // Returns 0 (before hit window starts)
  * ```
  *
- * @public
  * @korean 현재도달배수계산
  */
 export declare function getCurrentReachMultiplier(animationType: AnimationType, currentTime: number): number;

package/lib/systems/animation/core/AnimationHitTiming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationHitTiming.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/core/AnimationHitTiming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CACxC,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAutB1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,aAAa,GAC3B,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAQT;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAkCR"}
+{"version":3,"file":"AnimationHitTiming.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/core/AnimationHitTiming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CACxC,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAutB1C,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,aAAa,GAC3B,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAQT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAkCR"}

package/lib/systems/animation/core/AnimationHitTiming.js

@@ -36,7 +36,6 @@ import { AnimationType } from "../builders/MartialArtsConstants.js";
 * Only includes timing for techniques with actual hit windows.
 * Movement and non-combat animations can query this and will get undefined.
 *
-* @public
 * @korean 애니메이션타격타이밍데이터베이스
 */
 var ANIMATION_HIT_TIMING = {
@@ -697,7 +696,6 @@ var ANIMATION_HIT_TIMING = {
 * }
 * ```
 *
-* @public
 * @korean 애니메이션타격타이밍가져오기
 */
 function getAnimationHitTiming(animationType) {
@@ -718,7 +716,6 @@ function getAnimationHitTiming(animationType) {
 * // Returns true (0.15s is within jab's 0.10-0.25s window)
 * ```
 *
-* @public
 * @korean 타격가능시간확인
 */
 function isWithinHitWindow(animationType, currentTime) {
@@ -745,7 +742,6 @@ function isWithinHitWindow(animationType, currentTime) {
 * // Returns 0 (before hit window starts)
 * ```
 *
-* @public
 * @korean 현재도달배수계산
 */
 function getCurrentReachMultiplier(animationType, currentTime) {