blacktrigram 0.7.44 → 0.7.45

package/lib/systems/animation/systems/AdvancedJointMovements.d.ts

@@ -18,7 +18,6 @@ import * as THREE from "three";
 /**
  * Body side for limb-specific movements
  *
- * @public
  * @korean 신체측면
  */
 export type BodySide = 'left' | 'right';
@@ -32,7 +31,6 @@ export type BodySide = 'left' | 'right';
  * - hook: 후려차기 (Huryeochagi)
  * - axe: 내려차기 (Naeryeochagi)
  *
- * @public
  * @korean 차기기술유형
  */
 export type KickType = 'front' | 'roundhouse' | 'side' | 'hook' | 'axe';
@@ -46,7 +44,6 @@ export type KickType = 'front' | 'roundhouse' | 'side' | 'hook' | 'axe';
  * - ridge-hand: 손날등 (Sonnaldeung)
  * - hammer-fist: 망치주먹 (Mangchijumeok)
  *
- * @public
  * @korean 수격기술유형
  */
 export type HandStrikeType = 'backfist' | 'knife-hand' | 'palm-heel' | 'ridge-hand' | 'hammer-fist';
@@ -58,7 +55,6 @@ export type HandStrikeType = 'backfist' | 'knife-hand' | 'palm-heel' | 'ridge-ha
  * - 1: 중단 (Jungdan) - Middle section
  * - 2: 상단 (Sangdan) - High section
  *
- * @public
  * @korean 차기높이
  */
 export type KickHeight = 0 | 1 | 2;
@@ -70,7 +66,6 @@ export type KickHeight = 0 | 1 | 2;
  * - extension: 확장 (Hwakjang) - Extension
  * - retraction: 회수 (Hoesu) - Retraction
  *
- * @public
  * @korean 기술단계
  */
 export type TechniquePhase = 'chamber' | 'extension' | 'retraction';
@@ -82,7 +77,6 @@ export type TechniquePhase = 'chamber' | 'extension' | 'retraction';
  * - impact: 타격 (Tagyeok) - Impact
  * - follow-through: 후속동작 (Husok Dongjak) - Follow-through
  *
- * @public
  * @korean 타격단계
  */
 export type StrikePhase = 'wind-up' | 'impact' | 'follow-through';
@@ -96,7 +90,6 @@ export type StrikePhase = 'wind-up' | 'impact' | 'follow-through';
  * - shrug: 어깨올리기 (Eokkae Olligi)
  * - neutral: 중립 (Jungnip)
  *
- * @public
  * @korean 어깨기술유형
  */
 export type ShoulderTechniqueType = 'high-block' | 'overhead-strike' | 'rising-block' | 'shrug' | 'neutral';
@@ -108,7 +101,6 @@ export type ShoulderTechniqueType = 'high-block' | 'overhead-strike' | 'rising-b
  * - execution: 실행 (Silhaeng)
  * - recovery: 복귀 (Bokgwi)
  *
- * @public
  * @korean 어깨단계
  */
 export type ShoulderPhase = 'preparation' | 'execution' | 'recovery';
@@ -123,7 +115,6 @@ export type ShoulderPhase = 'preparation' | 'execution' | 'recovery';
  * - low-attack: 낮은공격 (Najeun Gonggyeok) - Low attack
  * - neutral: 중립 (Jungnip) - Neutral
  *
- * @public
  * @korean 척추동작유형
  */
 export type SpinalMovementType = 'duck' | 'lean-back' | 'lean-left' | 'lean-right' | 'low-attack' | 'neutral';
@@ -136,7 +127,6 @@ export type SpinalMovementType = 'duck' | 'lean-back' | 'lean-left' | 'lean-righ
  * - push-kick: 밀어차기 (Mireo Chagi)
  * - neutral: 중립 (Jungnip)
  *
- * @public
  * @korean 무릎기술유형
  */
 export type KneeTechniqueType = 'knee-strike' | 'clinch-control' | 'push-kick' | 'neutral';
@@ -148,7 +138,6 @@ export type KneeTechniqueType = 'knee-strike' | 'clinch-control' | 'push-kick' |
  * - execution: 실행 (Silhaeng)
  * - recovery: 복귀 (Bokgwi)
  *
- * @public
  * @korean 무릎단계
  */
 export type KneePhase = 'wind-up' | 'execution' | 'recovery';
@@ -161,7 +150,6 @@ export type KneePhase = 'wind-up' | 'execution' | 'recovery';
  *
  * Korean: 고관절 회전 상태
  *
- * @public
  */
 export interface HipRotationState {
     /**
@@ -205,7 +193,6 @@ export interface HipRotationState {
  *
  * Korean: 어깨 들어올림 상태
  *
- * @public
  */
 export interface ShoulderElevationState {
     /**
@@ -231,7 +218,6 @@ export interface ShoulderElevationState {
  *
  * Korean: 발목 관절 상태
  *
- * @public
  */
 export interface AnkleArticulationState {
     /**
@@ -264,7 +250,6 @@ export interface AnkleArticulationState {
  *
  * Korean: 손목 스냅 상태
  *
- * @public
  */
 export interface WristSnapState {
     /**
@@ -293,7 +278,6 @@ export interface WristSnapState {
  *
  * Korean: 무릎 밀어올림 상태
  *
- * @public
  */
 export interface KneeDriveState {
     /**
@@ -324,7 +308,6 @@ export interface KneeDriveState {
  *
  * Korean: 척추 굽힘 상태
  *
- * @public
  */
 export interface SpinalFlexionState {
     /**
@@ -430,7 +413,6 @@ export declare const ADVANCED_JOINT_CONSTRAINTS: {
  * // Returns frontal: 1.5, sagittal: 1.3, transverse: 0.6 for high roundhouse
  * ```
  *
- * @public
  * @korean 차기용고관절회전계산
  */
 export declare function calculateHipRotationForKick(kickType: KickType, targetHeight: KickHeight, side: BodySide): HipRotationState;
@@ -451,7 +433,6 @@ export declare function calculateHipRotationForKick(kickType: KickType, targetHe
  * // Returns ~1.35 for properly executed high roundhouse
  * ```
  *
- * @public
  * @korean 고관절회전에서차기파워계산
  */
 export declare function calculateKickPowerFromHipRotation(hipState: HipRotationState, kickType: KickType): number;
@@ -463,7 +444,6 @@ export declare function calculateKickPowerFromHipRotation(hipState: HipRotationS
  * @param hipState - Hip rotation state
  * @returns Three.js Euler angles (X=sagittal, Y=transverse, Z=frontal)
  *
- * @public
  * @korean 고관절회전을오일러각으로적용
  */
 export declare function applyHipRotationToEuler(hipState: HipRotationState): THREE.Euler;
@@ -484,7 +464,6 @@ export declare function applyHipRotationToEuler(hipState: HipRotationState): THR
  * // Returns: { flexion: 0.5, inversion: 0, side: 'right' }
  * ```
  *
- * @public
  * @korean 차기챔버용발목관절계산
  */
 export declare function calculateAnkleArticulation(kickType: KickType, phase: TechniquePhase, side: BodySide): AnkleArticulationState;
@@ -505,7 +484,6 @@ export declare function calculateAnkleArticulation(kickType: KickType, phase: Te
  * // Returns: { rotation: 1.2, velocity: 25.0, side: 'right' }
  * ```
  *
- * @public
  * @korean 수격용손목스냅계산
  */
 export declare function calculateWristSnap(strikeType: HandStrikeType, phase: StrikePhase, side: BodySide): WristSnapState;
@@ -525,7 +503,6 @@ export declare function calculateWristSnap(strikeType: HandStrikeType, phase: St
  * // Returns ~1.20 for proper backfist snap
  * ```
  *
- * @public
  * @korean 손목스냅파워배율계산
  */
 export declare function calculateWristSnapPowerModifier(wristState: WristSnapState): number;
@@ -546,7 +523,6 @@ export declare function calculateWristSnapPowerModifier(wristState: WristSnapSta
  * // Returns: { elevation: 0.04, side: 'left' }
  * ```
  *
- * @public
  * @korean 블록및상단공격용어깨들어올림계산
  */
 export declare function calculateShoulderElevation(techniqueType: ShoulderTechniqueType, phase: ShoulderPhase, side: BodySide): ShoulderElevationState;
@@ -566,7 +542,6 @@ export declare function calculateShoulderElevation(techniqueType: ShoulderTechni
  * // Returns: { flexion: 0.6, lateralBend: 0 }
  * ```
  *
- * @public
  * @korean 회피및하단공격용척추굽힘계산
  */
 export declare function calculateSpinalFlexion(movementType: SpinalMovementType, intensity?: number): SpinalFlexionState;
@@ -587,7 +562,6 @@ export declare function calculateSpinalFlexion(movementType: SpinalMovementType,
  * // Returns: { height: 0.7, forward: 0.25, side: 'right' }
  * ```
  *
- * @public
  * @korean 무릎차기및클린치용무릎밀어올림계산
  */
 export declare function calculateKneeDrive(technique: KneeTechniqueType, phase: KneePhase, side: BodySide): KneeDriveState;
@@ -607,7 +581,6 @@ export declare function calculateKneeDrive(technique: KneeTechniqueType, phase:
  * // Returns ~1.30 for properly executed knee strike
  * ```
  *
- * @public
  * @korean 무릎차기파워배율계산
  */
 export declare function calculateKneeStrikePowerModifier(kneeState: KneeDriveState): number;

package/lib/systems/animation/systems/AdvancedJointMovements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedJointMovements.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/systems/AdvancedJointMovements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5G;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAE9G;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;IACrC;;;OAGG;;;;;;;;;IAUH;;;OAGG;;;;;IAMH;;;OAGG;;;;;;;IAQH;;;OAGG;;;;;;IAOH;;;OAGG;;;;;;;IAQH;;;OAGG;;;;;;;CAOK,CAAC;AAEX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,UAAU,EACxB,IAAI,EAAE,QAAQ,GACb,gBAAgB,CAiElB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,QAAQ,GACjB,MAAM,CA+BR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAO/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,QAAQ,GACb,sBAAsB,CA2ExB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,QAAQ,GACb,cAAc,CA+EhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAYlF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,qBAAqB,EACpC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,QAAQ,GACb,sBAAsB,CAsDxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,kBAAkB,EAChC,SAAS,GAAE,MAAY,GACtB,kBAAkB,CAkDpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,GACb,cAAc,CA0DhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAYlF"}
+{"version":3,"file":"AdvancedJointMovements.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/systems/AdvancedJointMovements.ts"],"names":[],"mappings":"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"}

package/lib/systems/animation/systems/AdvancedJointMovements.js

@@ -86,7 +86,6 @@ var ADVANCED_JOINT_CONSTRAINTS = {
 * // Returns ~1.35 for properly executed high roundhouse
 * ```
 * 
-* @public
 * @korean 고관절회전에서차기파워계산
 */
 function calculateKickPowerFromHipRotation(hipState, kickType) {

package/lib/systems/animation/systems/AdvancedJointMovements.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedJointMovements.js","names":[],"sources":["../../../../src/systems/animation/systems/AdvancedJointMovements.ts"],"sourcesContent":["/**\n * Advanced Joint Movement System for Korean Martial Arts\n * \n * Extends the base skeletal animation system with specialized joint movements\n * for authentic martial arts technique execution:\n * - Hip rotation for kicks (고관절 회전)\n * - Shoulder elevation/depression (어깨 들어올림)\n * - Ankle articulation (발목 관절)\n * - Wrist snap mechanics (손목 스냅)\n * - Knee drive positioning (무릎 밀어올림)\n * - Spinal flexion/extension (척추 굽힘)\n * \n * @module systems/animation/AdvancedJointMovements\n * @category Animation System\n * @korean 고급관절동작시스템\n */\n\nimport * as THREE from \"three\";\n\n/**\n * Body side for limb-specific movements\n * \n * @public\n * @korean 신체측면\n */\nexport type BodySide = 'left' | 'right';\n\n/**\n * Kick technique types for hip rotation calculation\n * \n * Korean terminology:\n * - front: 앞차기 (Apchagi)\n * - roundhouse: 돌려차기 (Dollyeochagi)\n * - side: 옆차기 (Yeopchagi)\n * - hook: 후려차기 (Huryeochagi)\n * - axe: 내려차기 (Naeryeochagi)\n * \n * @public\n * @korean 차기기술유형\n */\nexport type KickType = 'front' | 'roundhouse' | 'side' | 'hook' | 'axe';\n\n/**\n * Hand strike technique types for wrist snap calculation\n * \n * Korean terminology:\n * - backfist: 등주먹 (Deungjumeok)\n * - knife-hand: 수도 (Sudo)\n * - palm-heel: 장저 (Jangjeo)\n * - ridge-hand: 손날등 (Sonnaldeung)\n * - hammer-fist: 망치주먹 (Mangchijumeok)\n * \n * @public\n * @korean 수격기술유형\n */\nexport type HandStrikeType = 'backfist' | 'knife-hand' | 'palm-heel' | 'ridge-hand' | 'hammer-fist';\n\n/**\n * Kick height levels for hip rotation scaling\n * \n * Korean terminology:\n * - 0: 하단 (Hadan) - Low section\n * - 1: 중단 (Jungdan) - Middle section\n * - 2: 상단 (Sangdan) - High section\n * \n * @public\n * @korean 차기높이\n */\nexport type KickHeight = 0 | 1 | 2;\n\n/**\n * Technique execution phases\n * \n * Korean terminology:\n * - chamber: 준비 (Junbi) - Preparation/chamber\n * - extension: 확장 (Hwakjang) - Extension\n * - retraction: 회수 (Hoesu) - Retraction\n * \n * @public\n * @korean 기술단계\n */\nexport type TechniquePhase = 'chamber' | 'extension' | 'retraction';\n\n/**\n * Strike execution phases\n * \n * Korean terminology:\n * - wind-up: 예비동작 (Yebi Dongjak) - Wind-up\n * - impact: 타격 (Tagyeok) - Impact\n * - follow-through: 후속동작 (Husok Dongjak) - Follow-through\n * \n * @public\n * @korean 타격단계\n */\nexport type StrikePhase = 'wind-up' | 'impact' | 'follow-through';\n\n/**\n * Block and overhead technique types for shoulder elevation\n * \n * Korean terminology:\n * - high-block: 상단막기 (Sangdan Makgi)\n * - overhead-strike: 상단공격 (Sangdan Gonggyeok)\n * - rising-block: 올려막기 (Ollyeo Makgi)\n * - shrug: 어깨올리기 (Eokkae Olligi)\n * - neutral: 중립 (Jungnip)\n * \n * @public\n * @korean 어깨기술유형\n */\nexport type ShoulderTechniqueType = 'high-block' | 'overhead-strike' | 'rising-block' | 'shrug' | 'neutral';\n\n/**\n * Shoulder and block technique execution phases\n * \n * Korean terminology:\n * - preparation: 준비 (Junbi)\n * - execution: 실행 (Silhaeng)\n * - recovery: 복귀 (Bokgwi)\n * \n * @public\n * @korean 어깨단계\n */\nexport type ShoulderPhase = 'preparation' | 'execution' | 'recovery';\n\n/**\n * Spinal movement types for dodging and positioning\n * \n * Korean terminology:\n * - duck: 숙이기 (Sugigi) - Duck down\n * - lean-back: 뒤로기울기 (Dwiro Giulgi) - Lean back\n * - lean-left: 왼쪽기울기 (Oenjjok Giulgi) - Lean left\n * - lean-right: 오른쪽기울기 (Oreunjjok Giulgi) - Lean right\n * - low-attack: 낮은공격 (Najeun Gonggyeok) - Low attack\n * - neutral: 중립 (Jungnip) - Neutral\n * \n * @public\n * @korean 척추동작유형\n */\nexport type SpinalMovementType = 'duck' | 'lean-back' | 'lean-left' | 'lean-right' | 'low-attack' | 'neutral';\n\n/**\n * Knee drive technique types for close-range combat\n * \n * Korean terminology:\n * - knee-strike: 무릎차기 (Mureup Chagi)\n * - clinch-control: 붙잡기제어 (Butjapgi Jeeo)\n * - push-kick: 밀어차기 (Mireo Chagi)\n * - neutral: 중립 (Jungnip)\n * \n * @public\n * @korean 무릎기술유형\n */\nexport type KneeTechniqueType = 'knee-strike' | 'clinch-control' | 'push-kick' | 'neutral';\n\n/**\n * Knee technique execution phases\n * \n * Korean terminology:\n * - wind-up: 예비동작 (Yebi Dongjak)\n * - execution: 실행 (Silhaeng)\n * - recovery: 복귀 (Bokgwi)\n * \n * @public\n * @korean 무릎단계\n */\nexport type KneePhase = 'wind-up' | 'execution' | 'recovery';\n\n/**\n * Hip rotation state for dynamic kick mechanics\n * \n * Tracks independent hip rotation in multiple planes for realistic\n * high kicks, roundhouse kicks, and hook kicks. Separates hip rotation\n * from pelvis rotation for authentic martial arts biomechanics.\n * \n * Korean: 고관절 회전 상태\n * \n * @public\n */\nexport interface HipRotationState {\n  /**\n   * Frontal plane rotation (abduction/adduction) in radians\n   * - Positive: Leg moves away from body centerline (abduction)\n   * - Negative: Leg moves toward centerline (adduction)\n   * Range: ±1.8 rad (±103°) for high kicks\n   * \n   * @korean 외전각도\n   */\n  readonly frontalRotation: number;\n\n  /**\n   * Sagittal plane rotation (flexion/extension) in radians\n   * - Positive: Leg moves forward (flexion)\n   * - Negative: Leg moves backward (extension)\n   * Range: -1.8 to 1.8 rad for kicks\n   * \n   * @korean 굴곡각도\n   */\n  readonly sagittalRotation: number;\n\n  /**\n   * Transverse plane rotation (internal/external rotation) in radians\n   * - Positive: Thigh rotates inward\n   * - Negative: Thigh rotates outward\n   * Range: ±0.8 rad (±46°)\n   * \n   * @korean 회전각도\n   */\n  readonly transverseRotation: number;\n\n  /**\n   * Which hip (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Shoulder elevation/depression state for blocks and overhead strikes\n * \n * Tracks vertical shoulder movement independent of arm rotation.\n * Essential for authentic blocking mechanics and overhead techniques.\n * \n * Korean: 어깨 들어올림 상태\n * \n * @public\n */\nexport interface ShoulderElevationState {\n  /**\n   * Vertical displacement in meters\n   * - Positive: Shoulder elevated (shrug)\n   * - Negative: Shoulder depressed (drop)\n   * Range: ±0.05 m (±5cm)\n   * \n   * @korean 수직변위\n   */\n  readonly elevation: number;\n\n  /**\n   * Which shoulder (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Ankle articulation state for kick chambers and pivots\n * \n * Tracks ankle joint positioning crucial for proper kick mechanics\n * and pivoting in Korean martial arts.\n * \n * Korean: 발목 관절 상태\n * \n * @public\n */\nexport interface AnkleArticulationState {\n  /**\n   * Dorsiflexion/plantarflexion angle in radians\n   * - Positive: Toes point up (dorsiflexion)\n   * - Negative: Toes point down (plantarflexion)\n   * Range: -0.8 to 0.5 rad\n   * \n   * @korean 발등굽힘각도\n   */\n  readonly flexion: number;\n\n  /**\n   * Inversion/eversion angle in radians\n   * Range: ±0.4 rad (±23°)\n   * \n   * @korean 안쪽굽힘각도\n   */\n  readonly inversion: number;\n\n  /**\n   * Which ankle (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Wrist snap state for rapid hand strikes\n * \n * Tracks rapid wrist rotation mechanics essential for backfist,\n * knife-hand, and other Korean martial arts hand techniques.\n * \n * Korean: 손목 스냅 상태\n * \n * @public\n */\nexport interface WristSnapState {\n  /**\n   * Rotation angle in radians\n   * Range: ±1.5 rad (±86°)\n   * \n   * @korean 회전각도\n   */\n  readonly rotation: number;\n\n  /**\n   * Snap velocity in rad/s (for power calculation)\n   * @korean 회전속도\n   */\n  readonly velocity: number;\n\n  /**\n   * Which wrist (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Knee drive state for clinch work and knee strikes\n * \n * Tracks independent knee positioning crucial for close-range\n * combat and knee strike techniques.\n * \n * Korean: 무릎 밀어올림 상태\n * \n * @public\n */\nexport interface KneeDriveState {\n  /**\n   * Drive height in meters (vertical displacement)\n   * Range: 0 to 0.8 m (80cm max lift)\n   * \n   * @korean 들어올림높이\n   */\n  readonly height: number;\n\n  /**\n   * Forward drive distance in meters\n   * Range: 0 to 0.3 m (30cm)\n   * \n   * @korean 전방거리\n   */\n  readonly forward: number;\n\n  /**\n   * Which knee (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Spinal flexion/extension state for dodges and low attacks\n * \n * Tracks forward/backward bending of spine for defensive\n * movements and low attack positioning.\n * \n * Korean: 척추 굽힘 상태\n * \n * @public\n */\nexport interface SpinalFlexionState {\n  /**\n   * Flexion angle in radians (forward/backward bend)\n   * - Positive: Forward bend\n   * - Negative: Backward bend\n   * Range: -0.5 to 0.8 rad\n   * \n   * @korean 굽힘각도\n   */\n  readonly flexion: number;\n\n  /**\n   * Lateral bend in radians (side to side)\n   * Range: ±0.3 rad (±17°)\n   * \n   * @korean 측면굽힘각도\n   */\n  readonly lateralBend: number;\n}\n\n/**\n * Advanced joint movement constraints\n * \n * Defines anatomically correct limits for all advanced joint movements\n * based on human biomechanics and Korean martial arts techniques.\n * \n * @korean 고급관절제약조건\n */\nexport const ADVANCED_JOINT_CONSTRAINTS = {\n  /**\n   * Hip rotation constraints for kicks\n   * @korean 고관절제약조건\n   */\n  HIP_ROTATION: {\n    FRONTAL_MIN: -1.8, // -103° adduction\n    FRONTAL_MAX: 1.8,  // 103° abduction\n    SAGITTAL_MIN: -1.8, // -103° extension\n    SAGITTAL_MAX: 1.8,  // 103° flexion\n    TRANSVERSE_MIN: -0.8, // -46° external rotation\n    TRANSVERSE_MAX: 0.8,  // 46° internal rotation\n  },\n\n  /**\n   * Shoulder elevation constraints\n   * @korean 어깨들어올림제약조건\n   */\n  SHOULDER_ELEVATION: {\n    MIN: -0.05, // -5cm depression\n    MAX: 0.05,  // 5cm elevation\n  },\n\n  /**\n   * Ankle articulation constraints\n   * @korean 발목관절제약조건\n   */\n  ANKLE_ARTICULATION: {\n    FLEXION_MIN: -0.8, // -46° plantarflexion\n    FLEXION_MAX: 0.5,  // 29° dorsiflexion\n    INVERSION_MIN: -0.4, // -23° eversion\n    INVERSION_MAX: 0.4,  // 23° inversion\n  },\n\n  /**\n   * Wrist snap constraints\n   * @korean 손목스냅제약조건\n   */\n  WRIST_SNAP: {\n    ROTATION_MIN: -1.5, // -86°\n    ROTATION_MAX: 1.5,  // 86°\n    MAX_VELOCITY: 30.0, // 30 rad/s for power strikes\n  },\n\n  /**\n   * Knee drive constraints\n   * @korean 무릎밀어올림제약조건\n   */\n  KNEE_DRIVE: {\n    HEIGHT_MIN: 0,    // Ground level\n    HEIGHT_MAX: 0.8,  // 80cm max lift\n    FORWARD_MIN: 0,\n    FORWARD_MAX: 0.3, // 30cm forward\n  },\n\n  /**\n   * Spinal flexion constraints\n   * @korean 척추굽힘제약조건\n   */\n  SPINAL_FLEXION: {\n    FLEXION_MIN: -0.5, // -29° extension (backward)\n    FLEXION_MAX: 0.8,  // 46° flexion (forward)\n    LATERAL_MIN: -0.3, // -17° left bend\n    LATERAL_MAX: 0.3,  // 17° right bend\n  },\n} as const;\n\n/**\n * Calculate hip rotation for kick mechanics\n * \n * Determines optimal hip rotation angles for various kick types,\n * ensuring anatomically correct positioning and maximum power generation.\n * \n * @param kickType - Type of kick being performed\n * @param targetHeight - Target height for kick (0=low, 1=medium, 2=high)\n * @param side - Which leg is kicking\n * @returns Hip rotation state with all three plane rotations\n * \n * @example\n * ```typescript\n * const hipState = calculateHipRotationForKick('roundhouse', 2, 'right');\n * // Returns frontal: 1.5, sagittal: 1.3, transverse: 0.6 for high roundhouse\n * ```\n * \n * @public\n * @korean 차기용고관절회전계산\n */\nexport function calculateHipRotationForKick(\n  kickType: KickType,\n  targetHeight: KickHeight,\n  side: BodySide\n): HipRotationState {\n  let frontalRotation = 0;\n  let sagittalRotation = 0;\n  let transverseRotation = 0;\n\n  // Height multiplier (more rotation needed for higher kicks)\n  const heightMultiplier = targetHeight === 0 ? 0.5 : targetHeight === 1 ? 0.75 : 1.0;\n\n  switch (kickType) {\n    case 'front':\n      // Front kick: primarily sagittal plane (forward)\n      sagittalRotation = 1.5 * heightMultiplier;\n      frontalRotation = 0.2; // Slight abduction for balance\n      transverseRotation = 0;\n      break;\n\n    case 'roundhouse':\n      // Roundhouse: combination of frontal abduction and transverse rotation\n      frontalRotation = 1.5 * heightMultiplier;\n      sagittalRotation = 0.8 * heightMultiplier;\n      transverseRotation = 0.6 * heightMultiplier; // Internal rotation for power\n      break;\n\n    case 'side':\n      // Side kick: primarily frontal plane (abduction)\n      frontalRotation = 1.6 * heightMultiplier;\n      sagittalRotation = 0.3;\n      transverseRotation = -0.4; // External rotation for proper foot alignment\n      break;\n\n    case 'hook':\n      // Hook kick: high abduction with forward component\n      frontalRotation = 1.7 * heightMultiplier;\n      sagittalRotation = 1.2 * heightMultiplier;\n      transverseRotation = 0.5;\n      break;\n\n    case 'axe':\n      // Axe kick: maximum sagittal flexion, some abduction\n      frontalRotation = 0.8 * heightMultiplier;\n      sagittalRotation = 1.8 * heightMultiplier; // Maximum forward flexion\n      transverseRotation = 0.2;\n      break;\n  }\n\n  // Apply constraints\n  frontalRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MAX, frontalRotation)\n  );\n  sagittalRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MAX, sagittalRotation)\n  );\n  transverseRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MAX, transverseRotation)\n  );\n\n  return {\n    frontalRotation,\n    sagittalRotation,\n    transverseRotation,\n    side,\n  };\n}\n\n/**\n * Calculate kick power modifier from hip rotation\n * \n * Determines power bonus based on proper hip rotation technique.\n * Greater rotation in the correct planes generates more power.\n * \n * @param hipState - Current hip rotation state\n * @param kickType - Type of kick\n * @returns Power multiplier (1.0-1.40x, with kicks getting up to 40% bonus)\n * \n * @example\n * ```typescript\n * const hipState = calculateHipRotationForKick('roundhouse', 2, 'right');\n * const power = calculateKickPowerFromHipRotation(hipState, 'roundhouse');\n * // Returns ~1.35 for properly executed high roundhouse\n * ```\n * \n * @public\n * @korean 고관절회전에서차기파워계산\n */\nexport function calculateKickPowerFromHipRotation(\n  hipState: HipRotationState,\n  kickType: KickType\n): number {\n  // Normalize rotations to 0-1 range based on constraints\n  const normalizedFrontal = Math.abs(hipState.frontalRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MAX;\n  const normalizedSagittal = Math.abs(hipState.sagittalRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MAX;\n  const normalizedTransverse = Math.abs(hipState.transverseRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MAX;\n\n  // Different kicks benefit from different rotation planes\n  let powerFactor = 0;\n  switch (kickType) {\n    case 'front':\n      powerFactor = normalizedSagittal * 0.8 + normalizedFrontal * 0.2;\n      break;\n    case 'roundhouse':\n      powerFactor = normalizedFrontal * 0.5 + normalizedTransverse * 0.3 + normalizedSagittal * 0.2;\n      break;\n    case 'side':\n      powerFactor = normalizedFrontal * 0.7 + normalizedTransverse * 0.3;\n      break;\n    case 'hook':\n      powerFactor = normalizedFrontal * 0.4 + normalizedSagittal * 0.4 + normalizedTransverse * 0.2;\n      break;\n    case 'axe':\n      powerFactor = normalizedSagittal * 0.8 + normalizedFrontal * 0.2;\n      break;\n  }\n\n  // Kicks can get up to 40% power bonus from proper hip rotation\n  return 1.0 + (powerFactor * 0.40);\n}\n\n/**\n * Apply hip rotation to Three.js Euler angles\n * \n * Converts hip rotation state into Three.js Euler angles for rendering.\n * \n * @param hipState - Hip rotation state\n * @returns Three.js Euler angles (X=sagittal, Y=transverse, Z=frontal)\n * \n * @public\n * @korean 고관절회전을오일러각으로적용\n */\nexport function applyHipRotationToEuler(hipState: HipRotationState): THREE.Euler {\n  return new THREE.Euler(\n    hipState.sagittalRotation,  // X-axis: forward/backward\n    hipState.transverseRotation, // Y-axis: twist\n    hipState.frontalRotation,    // Z-axis: side to side\n    'XYZ'\n  );\n}\n\n/**\n * Calculate ankle articulation for kick chamber\n * \n * Determines proper ankle positioning for kick chambering and extension,\n * crucial for proper foot alignment and power transfer in Korean martial arts.\n * \n * @param kickType - Type of kick being chambered\n * @param phase - Kick phase: 'chamber', 'extension', 'retraction'\n * @param side - Which ankle\n * @returns Ankle articulation state with flexion and inversion angles\n * \n * @example\n * ```typescript\n * const ankleState = calculateAnkleArticulation('front', 'extension', 'right');\n * // Returns: { flexion: 0.5, inversion: 0, side: 'right' }\n * ```\n * \n * @public\n * @korean 차기챔버용발목관절계산\n */\nexport function calculateAnkleArticulation(\n  kickType: KickType,\n  phase: TechniquePhase,\n  side: BodySide\n): AnkleArticulationState {\n  let flexion = 0;\n  let inversion = 0;\n\n  switch (kickType) {\n    case 'front':\n      if (phase === 'chamber') {\n        flexion = 0.2; // Slight dorsiflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = 0.5; // Strong dorsiflexion for striking with ball of foot\n      } else {\n        flexion = 0.1; // Slight flexion during retraction\n      }\n      inversion = 0; // Neutral for front kicks\n      break;\n\n    case 'roundhouse':\n      if (phase === 'chamber') {\n        flexion = -0.3; // Plantarflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = -0.5; // Strong plantarflexion for instep strike\n        inversion = -0.2; // Slight eversion to align instep\n      } else {\n        flexion = -0.2;\n        inversion = 0;\n      }\n      break;\n\n    case 'side':\n      if (phase === 'chamber') {\n        flexion = 0.3; // Dorsiflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = 0.4; // Dorsiflexion for heel/blade strike\n        inversion = 0.3; // Inversion to present blade edge\n      } else {\n        flexion = 0.2;\n        inversion = 0.1;\n      }\n      break;\n\n    case 'hook':\n      if (phase === 'chamber') {\n        flexion = -0.2;\n      } else if (phase === 'extension') {\n        flexion = -0.4; // Plantarflexion for heel strike\n        inversion = -0.15; // Slight eversion\n      } else {\n        flexion = -0.1;\n        inversion = 0;\n      }\n      break;\n\n    case 'axe':\n      if (phase === 'chamber') {\n        flexion = 0.1; // Minimal flexion in high chamber\n      } else if (phase === 'extension') {\n        flexion = 0.5; // Strong dorsiflexion for downward strike\n      } else {\n        flexion = 0.2;\n      }\n      inversion = 0; // Neutral for axe kicks\n      break;\n  }\n\n  // Apply constraints\n  flexion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.FLEXION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.FLEXION_MAX, flexion)\n  );\n  inversion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.INVERSION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.INVERSION_MAX, inversion)\n  );\n\n  return { flexion, inversion, side };\n}\n\n/**\n * Calculate wrist snap for hand strikes\n * \n * Determines wrist rotation and velocity for power generation in\n * backfist, knife-hand, and other Korean martial arts hand techniques.\n * \n * @param strikeType - Type of hand strike\n * @param phase - Strike phase: 'wind-up', 'impact', 'follow-through'\n * @param side - Which wrist\n * @returns Wrist snap state with rotation angle and velocity\n * \n * @example\n * ```typescript\n * const wristState = calculateWristSnap('backfist', 'impact', 'right');\n * // Returns: { rotation: 1.2, velocity: 25.0, side: 'right' }\n * ```\n * \n * @public\n * @korean 수격용손목스냅계산\n */\nexport function calculateWristSnap(\n  strikeType: HandStrikeType,\n  phase: StrikePhase,\n  side: BodySide\n): WristSnapState {\n  let rotation = 0;\n  let velocity = 0;\n\n  switch (strikeType) {\n    case 'backfist':\n      if (phase === 'wind-up') {\n        rotation = -0.8; // Cocked back\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 1.2; // Snapped forward\n        velocity = 25.0; // High velocity snap\n      } else {\n        rotation = 0.5;\n        velocity = 5.0;\n      }\n      break;\n\n    case 'knife-hand':\n      if (phase === 'wind-up') {\n        rotation = -0.5;\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.8; // Moderate snap for precision\n        velocity = 20.0;\n      } else {\n        rotation = 0.3;\n        velocity = 3.0;\n      }\n      break;\n\n    case 'palm-heel':\n      if (phase === 'wind-up') {\n        rotation = -0.3; // Minimal wind-up\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.5; // Push through\n        velocity = 15.0; // Lower velocity, more push\n      } else {\n        rotation = 0.2;\n        velocity = 2.0;\n      }\n      break;\n\n    case 'ridge-hand':\n      if (phase === 'wind-up') {\n        rotation = 0.8; // Opposite direction\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = -1.0; // Reverse snap\n        velocity = 22.0;\n      } else {\n        rotation = -0.4;\n        velocity = 4.0;\n      }\n      break;\n\n    case 'hammer-fist':\n      if (phase === 'wind-up') {\n        rotation = 0.2; // Minimal rotation\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.3; // Downward strike, less rotation\n        velocity = 18.0;\n      } else {\n        rotation = 0.1;\n        velocity = 2.0;\n      }\n      break;\n  }\n\n  // Apply constraints\n  rotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MAX, rotation)\n  );\n  velocity = Math.min(ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.MAX_VELOCITY, Math.abs(velocity));\n\n  return { rotation, velocity, side };\n}\n\n/**\n * Calculate wrist snap power modifier\n * \n * Determines power bonus based on wrist snap velocity and rotation.\n * Higher velocity generates more power for whipping strikes.\n * \n * @param wristState - Current wrist snap state\n * @returns Power multiplier (1.0-1.25x, with hand strikes getting up to 25% bonus)\n * \n * @example\n * ```typescript\n * const wristState = calculateWristSnap('backfist', 'impact', 'right');\n * const power = calculateWristSnapPowerModifier(wristState);\n * // Returns ~1.20 for proper backfist snap\n * ```\n * \n * @public\n * @korean 손목스냅파워배율계산\n */\nexport function calculateWristSnapPowerModifier(wristState: WristSnapState): number {\n  // Normalize velocity to 0-1 range\n  const normalizedVelocity = wristState.velocity / ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.MAX_VELOCITY;\n  \n  // Normalize rotation magnitude to 0-1 range\n  const normalizedRotation = Math.abs(wristState.rotation) / ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MAX;\n  \n  // Velocity contributes 70%, rotation contributes 30%\n  const powerFactor = (normalizedVelocity * 0.7) + (normalizedRotation * 0.3);\n  \n  // Hand strikes get up to 25% power bonus from wrist snap\n  return 1.0 + (powerFactor * 0.25);\n}\n\n/**\n * Calculate shoulder elevation for blocks and overhead strikes\n * \n * Determines vertical shoulder movement for defensive blocks and\n * overhead striking techniques in Korean martial arts.\n * \n * @param techniqueType - Type of technique requiring shoulder movement\n * @param phase - Technique phase\n * @param side - Which shoulder\n * @returns Shoulder elevation state with vertical displacement\n * \n * @example\n * ```typescript\n * const shoulderState = calculateShoulderElevation('high-block', 'execution', 'left');\n * // Returns: { elevation: 0.04, side: 'left' }\n * ```\n * \n * @public\n * @korean 블록및상단공격용어깨들어올림계산\n */\nexport function calculateShoulderElevation(\n  techniqueType: ShoulderTechniqueType,\n  phase: ShoulderPhase,\n  side: BodySide\n): ShoulderElevationState {\n  let elevation = 0;\n\n  switch (techniqueType) {\n    case 'high-block':\n      if (phase === 'preparation') {\n        elevation = -0.02; // Slight drop before elevation\n      } else if (phase === 'execution') {\n        elevation = 0.04; // Elevate for high block\n      } else {\n        elevation = 0.01; // Slight elevation maintained\n      }\n      break;\n\n    case 'overhead-strike':\n      if (phase === 'preparation') {\n        elevation = 0.03; // Pre-elevation for wind-up\n      } else if (phase === 'execution') {\n        elevation = 0.05; // Maximum elevation for overhead power\n      } else {\n        elevation = 0.01;\n      }\n      break;\n\n    case 'rising-block':\n      if (phase === 'preparation') {\n        elevation = -0.03; // Lower for rising motion\n      } else if (phase === 'execution') {\n        elevation = 0.04; // Elevate as block rises\n      } else {\n        elevation = 0.02;\n      }\n      break;\n\n    case 'shrug':\n      if (phase === 'execution') {\n        elevation = 0.05; // Maximum elevation for defensive shrug\n      } else {\n        elevation = 0;\n      }\n      break;\n\n    case 'neutral':\n      elevation = 0;\n      break;\n  }\n\n  // Apply constraints\n  elevation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SHOULDER_ELEVATION.MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SHOULDER_ELEVATION.MAX, elevation)\n  );\n\n  return { elevation, side };\n}\n\n/**\n * Calculate spinal flexion for dodges and low attacks\n * \n * Determines forward/backward and lateral bending of spine for\n * defensive movements and low attack positioning.\n * \n * @param movementType - Type of movement requiring spinal flexion\n * @param intensity - Movement intensity (0=minimal, 1=full)\n * @returns Spinal flexion state with flexion and lateral bend angles\n * \n * @example\n * ```typescript\n * const spineState = calculateSpinalFlexion('duck', 0.8);\n * // Returns: { flexion: 0.6, lateralBend: 0 }\n * ```\n * \n * @public\n * @korean 회피및하단공격용척추굽힘계산\n */\nexport function calculateSpinalFlexion(\n  movementType: SpinalMovementType,\n  intensity: number = 1.0\n): SpinalFlexionState {\n  let flexion = 0;\n  let lateralBend = 0;\n\n  // Clamp intensity to 0-1 range\n  intensity = Math.max(0, Math.min(1, intensity));\n\n  switch (movementType) {\n    case 'duck':\n      flexion = 0.7 * intensity; // Forward bend for ducking\n      lateralBend = 0;\n      break;\n\n    case 'lean-back':\n      flexion = -0.4 * intensity; // Backward bend for evasion\n      lateralBend = 0;\n      break;\n\n    case 'lean-left':\n      flexion = 0.1 * intensity; // Slight forward component\n      lateralBend = -0.25 * intensity; // Left lateral bend\n      break;\n\n    case 'lean-right':\n      flexion = 0.1 * intensity;\n      lateralBend = 0.25 * intensity; // Right lateral bend\n      break;\n\n    case 'low-attack':\n      flexion = 0.5 * intensity; // Forward bend for low strikes\n      lateralBend = 0;\n      break;\n\n    case 'neutral':\n      flexion = 0;\n      lateralBend = 0;\n      break;\n  }\n\n  // Apply constraints\n  flexion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.FLEXION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.FLEXION_MAX, flexion)\n  );\n  lateralBend = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.LATERAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.LATERAL_MAX, lateralBend)\n  );\n\n  return { flexion, lateralBend };\n}\n\n/**\n * Calculate knee drive for knee strikes and clinch\n * \n * Determines independent knee positioning for close-range combat,\n * crucial for knee strike power and clinch work positioning.\n * \n * @param technique - Technique requiring knee drive\n * @param phase - Technique phase\n * @param side - Which knee\n * @returns Knee drive state with height and forward distance\n * \n * @example\n * ```typescript\n * const kneeState = calculateKneeDrive('knee-strike', 'execution', 'right');\n * // Returns: { height: 0.7, forward: 0.25, side: 'right' }\n * ```\n * \n * @public\n * @korean 무릎차기및클린치용무릎밀어올림계산\n */\nexport function calculateKneeDrive(\n  technique: KneeTechniqueType,\n  phase: KneePhase,\n  side: BodySide\n): KneeDriveState {\n  let height = 0;\n  let forward = 0;\n\n  switch (technique) {\n    case 'knee-strike':\n      if (phase === 'wind-up') {\n        height = 0.3; // Partial chamber\n        forward = 0.1;\n      } else if (phase === 'execution') {\n        height = 0.7; // Drive upward\n        forward = 0.25; // Drive forward for power\n      } else {\n        height = 0.2;\n        forward = 0.05;\n      }\n      break;\n\n    case 'clinch-control':\n      if (phase === 'execution') {\n        height = 0.4; // Moderate elevation for control\n        forward = 0.15; // Forward pressure\n      } else {\n        height = 0.2;\n        forward = 0.08;\n      }\n      break;\n\n    case 'push-kick':\n      if (phase === 'wind-up') {\n        height = 0.5; // High chamber\n        forward = 0.05;\n      } else if (phase === 'execution') {\n        height = 0.6; // Maintain height\n        forward = 0.3; // Strong forward drive\n      } else {\n        height = 0.3;\n        forward = 0.1;\n      }\n      break;\n\n    case 'neutral':\n      height = 0;\n      forward = 0;\n      break;\n  }\n\n  // Apply constraints\n  height = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MAX, height)\n  );\n  forward = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MAX, forward)\n  );\n\n  return { height, forward, side };\n}\n\n/**\n * Calculate knee strike power modifier\n * \n * Determines power bonus based on knee drive height and forward momentum.\n * Greater drive generates more power through proper mechanics.\n * \n * @param kneeState - Current knee drive state\n * @returns Power multiplier (1.0-1.35x, with knee strikes getting up to 35% bonus)\n * \n * @example\n * ```typescript\n * const kneeState = calculateKneeDrive('knee-strike', 'execution', 'right');\n * const power = calculateKneeStrikePowerModifier(kneeState);\n * // Returns ~1.30 for properly executed knee strike\n * ```\n * \n * @public\n * @korean 무릎차기파워배율계산\n */\nexport function calculateKneeStrikePowerModifier(kneeState: KneeDriveState): number {\n  // Normalize height to 0-1 range\n  const normalizedHeight = kneeState.height / ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MAX;\n  \n  // Normalize forward drive to 0-1 range\n  const normalizedForward = kneeState.forward / ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MAX;\n  \n  // Height contributes 60%, forward drive contributes 40%\n  const powerFactor = (normalizedHeight * 0.6) + (normalizedForward * 0.4);\n  \n  // Knee strikes get up to 35% power bonus from proper drive\n  return 1.0 + (powerFactor * 0.35);\n}\n\n"],"mappings":";;;;;;;;;;AAgYA,IAAa,6BAA6B;;;;;CAKxC,cAAc;EACZ,aAAa;EACb,aAAa;EACb,cAAc;EACd,cAAc;EACd,gBAAgB;EAChB,gBAAgB;EACjB;;;;;CAMD,oBAAoB;EAClB,KAAK;EACL,KAAK;EACN;;;;;CAMD,oBAAoB;EAClB,aAAa;EACb,aAAa;EACb,eAAe;EACf,eAAe;EAChB;;;;;CAMD,YAAY;EACV,cAAc;EACd,cAAc;EACd,cAAc;EACf;;;;;CAMD,YAAY;EACV,YAAY;EACZ,YAAY;EACZ,aAAa;EACb,aAAa;EACd;;;;;CAMD,gBAAgB;EACd,aAAa;EACb,aAAa;EACb,aAAa;EACb,aAAa;EACd;CACF;;;;;;;;;;;;;;;;;;;;;AAiHD,SAAgB,kCACd,UACA,UACQ;CAER,MAAM,oBAAoB,KAAK,IAAI,SAAS,gBAAgB,GAC1D,2BAA2B,aAAa;CAC1C,MAAM,qBAAqB,KAAK,IAAI,SAAS,iBAAiB,GAC5D,2BAA2B,aAAa;CAC1C,MAAM,uBAAuB,KAAK,IAAI,SAAS,mBAAmB,GAChE,2BAA2B,aAAa;CAG1C,IAAI,cAAc;CAClB,QAAQ,UAAR;EACE,KAAK;GACH,cAAc,qBAAqB,KAAM,oBAAoB;GAC7D;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,uBAAuB,KAAM,qBAAqB;GAC1F;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,uBAAuB;GAC/D;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,qBAAqB,KAAM,uBAAuB;GAC1F;EACF,KAAK;GACH,cAAc,qBAAqB,KAAM,oBAAoB;GAC7D;;CAIJ,OAAO,IAAO,cAAc"}
+{"version":3,"file":"AdvancedJointMovements.js","names":[],"sources":["../../../../src/systems/animation/systems/AdvancedJointMovements.ts"],"sourcesContent":["/**\n * Advanced Joint Movement System for Korean Martial Arts\n * \n * Extends the base skeletal animation system with specialized joint movements\n * for authentic martial arts technique execution:\n * - Hip rotation for kicks (고관절 회전)\n * - Shoulder elevation/depression (어깨 들어올림)\n * - Ankle articulation (발목 관절)\n * - Wrist snap mechanics (손목 스냅)\n * - Knee drive positioning (무릎 밀어올림)\n * - Spinal flexion/extension (척추 굽힘)\n * \n * @module systems/animation/AdvancedJointMovements\n * @category Animation System\n * @korean 고급관절동작시스템\n */\n\nimport * as THREE from \"three\";\n\n/**\n * Body side for limb-specific movements\n * \n * @korean 신체측면\n */\nexport type BodySide = 'left' | 'right';\n\n/**\n * Kick technique types for hip rotation calculation\n * \n * Korean terminology:\n * - front: 앞차기 (Apchagi)\n * - roundhouse: 돌려차기 (Dollyeochagi)\n * - side: 옆차기 (Yeopchagi)\n * - hook: 후려차기 (Huryeochagi)\n * - axe: 내려차기 (Naeryeochagi)\n * \n * @korean 차기기술유형\n */\nexport type KickType = 'front' | 'roundhouse' | 'side' | 'hook' | 'axe';\n\n/**\n * Hand strike technique types for wrist snap calculation\n * \n * Korean terminology:\n * - backfist: 등주먹 (Deungjumeok)\n * - knife-hand: 수도 (Sudo)\n * - palm-heel: 장저 (Jangjeo)\n * - ridge-hand: 손날등 (Sonnaldeung)\n * - hammer-fist: 망치주먹 (Mangchijumeok)\n * \n * @korean 수격기술유형\n */\nexport type HandStrikeType = 'backfist' | 'knife-hand' | 'palm-heel' | 'ridge-hand' | 'hammer-fist';\n\n/**\n * Kick height levels for hip rotation scaling\n * \n * Korean terminology:\n * - 0: 하단 (Hadan) - Low section\n * - 1: 중단 (Jungdan) - Middle section\n * - 2: 상단 (Sangdan) - High section\n * \n * @korean 차기높이\n */\nexport type KickHeight = 0 | 1 | 2;\n\n/**\n * Technique execution phases\n * \n * Korean terminology:\n * - chamber: 준비 (Junbi) - Preparation/chamber\n * - extension: 확장 (Hwakjang) - Extension\n * - retraction: 회수 (Hoesu) - Retraction\n * \n * @korean 기술단계\n */\nexport type TechniquePhase = 'chamber' | 'extension' | 'retraction';\n\n/**\n * Strike execution phases\n * \n * Korean terminology:\n * - wind-up: 예비동작 (Yebi Dongjak) - Wind-up\n * - impact: 타격 (Tagyeok) - Impact\n * - follow-through: 후속동작 (Husok Dongjak) - Follow-through\n * \n * @korean 타격단계\n */\nexport type StrikePhase = 'wind-up' | 'impact' | 'follow-through';\n\n/**\n * Block and overhead technique types for shoulder elevation\n * \n * Korean terminology:\n * - high-block: 상단막기 (Sangdan Makgi)\n * - overhead-strike: 상단공격 (Sangdan Gonggyeok)\n * - rising-block: 올려막기 (Ollyeo Makgi)\n * - shrug: 어깨올리기 (Eokkae Olligi)\n * - neutral: 중립 (Jungnip)\n * \n * @korean 어깨기술유형\n */\nexport type ShoulderTechniqueType = 'high-block' | 'overhead-strike' | 'rising-block' | 'shrug' | 'neutral';\n\n/**\n * Shoulder and block technique execution phases\n * \n * Korean terminology:\n * - preparation: 준비 (Junbi)\n * - execution: 실행 (Silhaeng)\n * - recovery: 복귀 (Bokgwi)\n * \n * @korean 어깨단계\n */\nexport type ShoulderPhase = 'preparation' | 'execution' | 'recovery';\n\n/**\n * Spinal movement types for dodging and positioning\n * \n * Korean terminology:\n * - duck: 숙이기 (Sugigi) - Duck down\n * - lean-back: 뒤로기울기 (Dwiro Giulgi) - Lean back\n * - lean-left: 왼쪽기울기 (Oenjjok Giulgi) - Lean left\n * - lean-right: 오른쪽기울기 (Oreunjjok Giulgi) - Lean right\n * - low-attack: 낮은공격 (Najeun Gonggyeok) - Low attack\n * - neutral: 중립 (Jungnip) - Neutral\n * \n * @korean 척추동작유형\n */\nexport type SpinalMovementType = 'duck' | 'lean-back' | 'lean-left' | 'lean-right' | 'low-attack' | 'neutral';\n\n/**\n * Knee drive technique types for close-range combat\n * \n * Korean terminology:\n * - knee-strike: 무릎차기 (Mureup Chagi)\n * - clinch-control: 붙잡기제어 (Butjapgi Jeeo)\n * - push-kick: 밀어차기 (Mireo Chagi)\n * - neutral: 중립 (Jungnip)\n * \n * @korean 무릎기술유형\n */\nexport type KneeTechniqueType = 'knee-strike' | 'clinch-control' | 'push-kick' | 'neutral';\n\n/**\n * Knee technique execution phases\n * \n * Korean terminology:\n * - wind-up: 예비동작 (Yebi Dongjak)\n * - execution: 실행 (Silhaeng)\n * - recovery: 복귀 (Bokgwi)\n * \n * @korean 무릎단계\n */\nexport type KneePhase = 'wind-up' | 'execution' | 'recovery';\n\n/**\n * Hip rotation state for dynamic kick mechanics\n * \n * Tracks independent hip rotation in multiple planes for realistic\n * high kicks, roundhouse kicks, and hook kicks. Separates hip rotation\n * from pelvis rotation for authentic martial arts biomechanics.\n * \n * Korean: 고관절 회전 상태\n * \n */\nexport interface HipRotationState {\n  /**\n   * Frontal plane rotation (abduction/adduction) in radians\n   * - Positive: Leg moves away from body centerline (abduction)\n   * - Negative: Leg moves toward centerline (adduction)\n   * Range: ±1.8 rad (±103°) for high kicks\n   * \n   * @korean 외전각도\n   */\n  readonly frontalRotation: number;\n\n  /**\n   * Sagittal plane rotation (flexion/extension) in radians\n   * - Positive: Leg moves forward (flexion)\n   * - Negative: Leg moves backward (extension)\n   * Range: -1.8 to 1.8 rad for kicks\n   * \n   * @korean 굴곡각도\n   */\n  readonly sagittalRotation: number;\n\n  /**\n   * Transverse plane rotation (internal/external rotation) in radians\n   * - Positive: Thigh rotates inward\n   * - Negative: Thigh rotates outward\n   * Range: ±0.8 rad (±46°)\n   * \n   * @korean 회전각도\n   */\n  readonly transverseRotation: number;\n\n  /**\n   * Which hip (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Shoulder elevation/depression state for blocks and overhead strikes\n * \n * Tracks vertical shoulder movement independent of arm rotation.\n * Essential for authentic blocking mechanics and overhead techniques.\n * \n * Korean: 어깨 들어올림 상태\n * \n */\nexport interface ShoulderElevationState {\n  /**\n   * Vertical displacement in meters\n   * - Positive: Shoulder elevated (shrug)\n   * - Negative: Shoulder depressed (drop)\n   * Range: ±0.05 m (±5cm)\n   * \n   * @korean 수직변위\n   */\n  readonly elevation: number;\n\n  /**\n   * Which shoulder (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Ankle articulation state for kick chambers and pivots\n * \n * Tracks ankle joint positioning crucial for proper kick mechanics\n * and pivoting in Korean martial arts.\n * \n * Korean: 발목 관절 상태\n * \n */\nexport interface AnkleArticulationState {\n  /**\n   * Dorsiflexion/plantarflexion angle in radians\n   * - Positive: Toes point up (dorsiflexion)\n   * - Negative: Toes point down (plantarflexion)\n   * Range: -0.8 to 0.5 rad\n   * \n   * @korean 발등굽힘각도\n   */\n  readonly flexion: number;\n\n  /**\n   * Inversion/eversion angle in radians\n   * Range: ±0.4 rad (±23°)\n   * \n   * @korean 안쪽굽힘각도\n   */\n  readonly inversion: number;\n\n  /**\n   * Which ankle (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Wrist snap state for rapid hand strikes\n * \n * Tracks rapid wrist rotation mechanics essential for backfist,\n * knife-hand, and other Korean martial arts hand techniques.\n * \n * Korean: 손목 스냅 상태\n * \n */\nexport interface WristSnapState {\n  /**\n   * Rotation angle in radians\n   * Range: ±1.5 rad (±86°)\n   * \n   * @korean 회전각도\n   */\n  readonly rotation: number;\n\n  /**\n   * Snap velocity in rad/s (for power calculation)\n   * @korean 회전속도\n   */\n  readonly velocity: number;\n\n  /**\n   * Which wrist (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Knee drive state for clinch work and knee strikes\n * \n * Tracks independent knee positioning crucial for close-range\n * combat and knee strike techniques.\n * \n * Korean: 무릎 밀어올림 상태\n * \n */\nexport interface KneeDriveState {\n  /**\n   * Drive height in meters (vertical displacement)\n   * Range: 0 to 0.8 m (80cm max lift)\n   * \n   * @korean 들어올림높이\n   */\n  readonly height: number;\n\n  /**\n   * Forward drive distance in meters\n   * Range: 0 to 0.3 m (30cm)\n   * \n   * @korean 전방거리\n   */\n  readonly forward: number;\n\n  /**\n   * Which knee (left or right)\n   * @korean 측면\n   */\n  readonly side: BodySide;\n}\n\n/**\n * Spinal flexion/extension state for dodges and low attacks\n * \n * Tracks forward/backward bending of spine for defensive\n * movements and low attack positioning.\n * \n * Korean: 척추 굽힘 상태\n * \n */\nexport interface SpinalFlexionState {\n  /**\n   * Flexion angle in radians (forward/backward bend)\n   * - Positive: Forward bend\n   * - Negative: Backward bend\n   * Range: -0.5 to 0.8 rad\n   * \n   * @korean 굽힘각도\n   */\n  readonly flexion: number;\n\n  /**\n   * Lateral bend in radians (side to side)\n   * Range: ±0.3 rad (±17°)\n   * \n   * @korean 측면굽힘각도\n   */\n  readonly lateralBend: number;\n}\n\n/**\n * Advanced joint movement constraints\n * \n * Defines anatomically correct limits for all advanced joint movements\n * based on human biomechanics and Korean martial arts techniques.\n * \n * @korean 고급관절제약조건\n */\nexport const ADVANCED_JOINT_CONSTRAINTS = {\n  /**\n   * Hip rotation constraints for kicks\n   * @korean 고관절제약조건\n   */\n  HIP_ROTATION: {\n    FRONTAL_MIN: -1.8, // -103° adduction\n    FRONTAL_MAX: 1.8,  // 103° abduction\n    SAGITTAL_MIN: -1.8, // -103° extension\n    SAGITTAL_MAX: 1.8,  // 103° flexion\n    TRANSVERSE_MIN: -0.8, // -46° external rotation\n    TRANSVERSE_MAX: 0.8,  // 46° internal rotation\n  },\n\n  /**\n   * Shoulder elevation constraints\n   * @korean 어깨들어올림제약조건\n   */\n  SHOULDER_ELEVATION: {\n    MIN: -0.05, // -5cm depression\n    MAX: 0.05,  // 5cm elevation\n  },\n\n  /**\n   * Ankle articulation constraints\n   * @korean 발목관절제약조건\n   */\n  ANKLE_ARTICULATION: {\n    FLEXION_MIN: -0.8, // -46° plantarflexion\n    FLEXION_MAX: 0.5,  // 29° dorsiflexion\n    INVERSION_MIN: -0.4, // -23° eversion\n    INVERSION_MAX: 0.4,  // 23° inversion\n  },\n\n  /**\n   * Wrist snap constraints\n   * @korean 손목스냅제약조건\n   */\n  WRIST_SNAP: {\n    ROTATION_MIN: -1.5, // -86°\n    ROTATION_MAX: 1.5,  // 86°\n    MAX_VELOCITY: 30.0, // 30 rad/s for power strikes\n  },\n\n  /**\n   * Knee drive constraints\n   * @korean 무릎밀어올림제약조건\n   */\n  KNEE_DRIVE: {\n    HEIGHT_MIN: 0,    // Ground level\n    HEIGHT_MAX: 0.8,  // 80cm max lift\n    FORWARD_MIN: 0,\n    FORWARD_MAX: 0.3, // 30cm forward\n  },\n\n  /**\n   * Spinal flexion constraints\n   * @korean 척추굽힘제약조건\n   */\n  SPINAL_FLEXION: {\n    FLEXION_MIN: -0.5, // -29° extension (backward)\n    FLEXION_MAX: 0.8,  // 46° flexion (forward)\n    LATERAL_MIN: -0.3, // -17° left bend\n    LATERAL_MAX: 0.3,  // 17° right bend\n  },\n} as const;\n\n/**\n * Calculate hip rotation for kick mechanics\n * \n * Determines optimal hip rotation angles for various kick types,\n * ensuring anatomically correct positioning and maximum power generation.\n * \n * @param kickType - Type of kick being performed\n * @param targetHeight - Target height for kick (0=low, 1=medium, 2=high)\n * @param side - Which leg is kicking\n * @returns Hip rotation state with all three plane rotations\n * \n * @example\n * ```typescript\n * const hipState = calculateHipRotationForKick('roundhouse', 2, 'right');\n * // Returns frontal: 1.5, sagittal: 1.3, transverse: 0.6 for high roundhouse\n * ```\n * \n * @korean 차기용고관절회전계산\n */\nexport function calculateHipRotationForKick(\n  kickType: KickType,\n  targetHeight: KickHeight,\n  side: BodySide\n): HipRotationState {\n  let frontalRotation = 0;\n  let sagittalRotation = 0;\n  let transverseRotation = 0;\n\n  // Height multiplier (more rotation needed for higher kicks)\n  const heightMultiplier = targetHeight === 0 ? 0.5 : targetHeight === 1 ? 0.75 : 1.0;\n\n  switch (kickType) {\n    case 'front':\n      // Front kick: primarily sagittal plane (forward)\n      sagittalRotation = 1.5 * heightMultiplier;\n      frontalRotation = 0.2; // Slight abduction for balance\n      transverseRotation = 0;\n      break;\n\n    case 'roundhouse':\n      // Roundhouse: combination of frontal abduction and transverse rotation\n      frontalRotation = 1.5 * heightMultiplier;\n      sagittalRotation = 0.8 * heightMultiplier;\n      transverseRotation = 0.6 * heightMultiplier; // Internal rotation for power\n      break;\n\n    case 'side':\n      // Side kick: primarily frontal plane (abduction)\n      frontalRotation = 1.6 * heightMultiplier;\n      sagittalRotation = 0.3;\n      transverseRotation = -0.4; // External rotation for proper foot alignment\n      break;\n\n    case 'hook':\n      // Hook kick: high abduction with forward component\n      frontalRotation = 1.7 * heightMultiplier;\n      sagittalRotation = 1.2 * heightMultiplier;\n      transverseRotation = 0.5;\n      break;\n\n    case 'axe':\n      // Axe kick: maximum sagittal flexion, some abduction\n      frontalRotation = 0.8 * heightMultiplier;\n      sagittalRotation = 1.8 * heightMultiplier; // Maximum forward flexion\n      transverseRotation = 0.2;\n      break;\n  }\n\n  // Apply constraints\n  frontalRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MAX, frontalRotation)\n  );\n  sagittalRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MAX, sagittalRotation)\n  );\n  transverseRotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MAX, transverseRotation)\n  );\n\n  return {\n    frontalRotation,\n    sagittalRotation,\n    transverseRotation,\n    side,\n  };\n}\n\n/**\n * Calculate kick power modifier from hip rotation\n * \n * Determines power bonus based on proper hip rotation technique.\n * Greater rotation in the correct planes generates more power.\n * \n * @param hipState - Current hip rotation state\n * @param kickType - Type of kick\n * @returns Power multiplier (1.0-1.40x, with kicks getting up to 40% bonus)\n * \n * @example\n * ```typescript\n * const hipState = calculateHipRotationForKick('roundhouse', 2, 'right');\n * const power = calculateKickPowerFromHipRotation(hipState, 'roundhouse');\n * // Returns ~1.35 for properly executed high roundhouse\n * ```\n * \n * @korean 고관절회전에서차기파워계산\n */\nexport function calculateKickPowerFromHipRotation(\n  hipState: HipRotationState,\n  kickType: KickType\n): number {\n  // Normalize rotations to 0-1 range based on constraints\n  const normalizedFrontal = Math.abs(hipState.frontalRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.FRONTAL_MAX;\n  const normalizedSagittal = Math.abs(hipState.sagittalRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.SAGITTAL_MAX;\n  const normalizedTransverse = Math.abs(hipState.transverseRotation) / \n    ADVANCED_JOINT_CONSTRAINTS.HIP_ROTATION.TRANSVERSE_MAX;\n\n  // Different kicks benefit from different rotation planes\n  let powerFactor = 0;\n  switch (kickType) {\n    case 'front':\n      powerFactor = normalizedSagittal * 0.8 + normalizedFrontal * 0.2;\n      break;\n    case 'roundhouse':\n      powerFactor = normalizedFrontal * 0.5 + normalizedTransverse * 0.3 + normalizedSagittal * 0.2;\n      break;\n    case 'side':\n      powerFactor = normalizedFrontal * 0.7 + normalizedTransverse * 0.3;\n      break;\n    case 'hook':\n      powerFactor = normalizedFrontal * 0.4 + normalizedSagittal * 0.4 + normalizedTransverse * 0.2;\n      break;\n    case 'axe':\n      powerFactor = normalizedSagittal * 0.8 + normalizedFrontal * 0.2;\n      break;\n  }\n\n  // Kicks can get up to 40% power bonus from proper hip rotation\n  return 1.0 + (powerFactor * 0.40);\n}\n\n/**\n * Apply hip rotation to Three.js Euler angles\n * \n * Converts hip rotation state into Three.js Euler angles for rendering.\n * \n * @param hipState - Hip rotation state\n * @returns Three.js Euler angles (X=sagittal, Y=transverse, Z=frontal)\n * \n * @korean 고관절회전을오일러각으로적용\n */\nexport function applyHipRotationToEuler(hipState: HipRotationState): THREE.Euler {\n  return new THREE.Euler(\n    hipState.sagittalRotation,  // X-axis: forward/backward\n    hipState.transverseRotation, // Y-axis: twist\n    hipState.frontalRotation,    // Z-axis: side to side\n    'XYZ'\n  );\n}\n\n/**\n * Calculate ankle articulation for kick chamber\n * \n * Determines proper ankle positioning for kick chambering and extension,\n * crucial for proper foot alignment and power transfer in Korean martial arts.\n * \n * @param kickType - Type of kick being chambered\n * @param phase - Kick phase: 'chamber', 'extension', 'retraction'\n * @param side - Which ankle\n * @returns Ankle articulation state with flexion and inversion angles\n * \n * @example\n * ```typescript\n * const ankleState = calculateAnkleArticulation('front', 'extension', 'right');\n * // Returns: { flexion: 0.5, inversion: 0, side: 'right' }\n * ```\n * \n * @korean 차기챔버용발목관절계산\n */\nexport function calculateAnkleArticulation(\n  kickType: KickType,\n  phase: TechniquePhase,\n  side: BodySide\n): AnkleArticulationState {\n  let flexion = 0;\n  let inversion = 0;\n\n  switch (kickType) {\n    case 'front':\n      if (phase === 'chamber') {\n        flexion = 0.2; // Slight dorsiflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = 0.5; // Strong dorsiflexion for striking with ball of foot\n      } else {\n        flexion = 0.1; // Slight flexion during retraction\n      }\n      inversion = 0; // Neutral for front kicks\n      break;\n\n    case 'roundhouse':\n      if (phase === 'chamber') {\n        flexion = -0.3; // Plantarflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = -0.5; // Strong plantarflexion for instep strike\n        inversion = -0.2; // Slight eversion to align instep\n      } else {\n        flexion = -0.2;\n        inversion = 0;\n      }\n      break;\n\n    case 'side':\n      if (phase === 'chamber') {\n        flexion = 0.3; // Dorsiflexion in chamber\n      } else if (phase === 'extension') {\n        flexion = 0.4; // Dorsiflexion for heel/blade strike\n        inversion = 0.3; // Inversion to present blade edge\n      } else {\n        flexion = 0.2;\n        inversion = 0.1;\n      }\n      break;\n\n    case 'hook':\n      if (phase === 'chamber') {\n        flexion = -0.2;\n      } else if (phase === 'extension') {\n        flexion = -0.4; // Plantarflexion for heel strike\n        inversion = -0.15; // Slight eversion\n      } else {\n        flexion = -0.1;\n        inversion = 0;\n      }\n      break;\n\n    case 'axe':\n      if (phase === 'chamber') {\n        flexion = 0.1; // Minimal flexion in high chamber\n      } else if (phase === 'extension') {\n        flexion = 0.5; // Strong dorsiflexion for downward strike\n      } else {\n        flexion = 0.2;\n      }\n      inversion = 0; // Neutral for axe kicks\n      break;\n  }\n\n  // Apply constraints\n  flexion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.FLEXION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.FLEXION_MAX, flexion)\n  );\n  inversion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.INVERSION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.ANKLE_ARTICULATION.INVERSION_MAX, inversion)\n  );\n\n  return { flexion, inversion, side };\n}\n\n/**\n * Calculate wrist snap for hand strikes\n * \n * Determines wrist rotation and velocity for power generation in\n * backfist, knife-hand, and other Korean martial arts hand techniques.\n * \n * @param strikeType - Type of hand strike\n * @param phase - Strike phase: 'wind-up', 'impact', 'follow-through'\n * @param side - Which wrist\n * @returns Wrist snap state with rotation angle and velocity\n * \n * @example\n * ```typescript\n * const wristState = calculateWristSnap('backfist', 'impact', 'right');\n * // Returns: { rotation: 1.2, velocity: 25.0, side: 'right' }\n * ```\n * \n * @korean 수격용손목스냅계산\n */\nexport function calculateWristSnap(\n  strikeType: HandStrikeType,\n  phase: StrikePhase,\n  side: BodySide\n): WristSnapState {\n  let rotation = 0;\n  let velocity = 0;\n\n  switch (strikeType) {\n    case 'backfist':\n      if (phase === 'wind-up') {\n        rotation = -0.8; // Cocked back\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 1.2; // Snapped forward\n        velocity = 25.0; // High velocity snap\n      } else {\n        rotation = 0.5;\n        velocity = 5.0;\n      }\n      break;\n\n    case 'knife-hand':\n      if (phase === 'wind-up') {\n        rotation = -0.5;\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.8; // Moderate snap for precision\n        velocity = 20.0;\n      } else {\n        rotation = 0.3;\n        velocity = 3.0;\n      }\n      break;\n\n    case 'palm-heel':\n      if (phase === 'wind-up') {\n        rotation = -0.3; // Minimal wind-up\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.5; // Push through\n        velocity = 15.0; // Lower velocity, more push\n      } else {\n        rotation = 0.2;\n        velocity = 2.0;\n      }\n      break;\n\n    case 'ridge-hand':\n      if (phase === 'wind-up') {\n        rotation = 0.8; // Opposite direction\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = -1.0; // Reverse snap\n        velocity = 22.0;\n      } else {\n        rotation = -0.4;\n        velocity = 4.0;\n      }\n      break;\n\n    case 'hammer-fist':\n      if (phase === 'wind-up') {\n        rotation = 0.2; // Minimal rotation\n        velocity = 0;\n      } else if (phase === 'impact') {\n        rotation = 0.3; // Downward strike, less rotation\n        velocity = 18.0;\n      } else {\n        rotation = 0.1;\n        velocity = 2.0;\n      }\n      break;\n  }\n\n  // Apply constraints\n  rotation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MAX, rotation)\n  );\n  velocity = Math.min(ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.MAX_VELOCITY, Math.abs(velocity));\n\n  return { rotation, velocity, side };\n}\n\n/**\n * Calculate wrist snap power modifier\n * \n * Determines power bonus based on wrist snap velocity and rotation.\n * Higher velocity generates more power for whipping strikes.\n * \n * @param wristState - Current wrist snap state\n * @returns Power multiplier (1.0-1.25x, with hand strikes getting up to 25% bonus)\n * \n * @example\n * ```typescript\n * const wristState = calculateWristSnap('backfist', 'impact', 'right');\n * const power = calculateWristSnapPowerModifier(wristState);\n * // Returns ~1.20 for proper backfist snap\n * ```\n * \n * @korean 손목스냅파워배율계산\n */\nexport function calculateWristSnapPowerModifier(wristState: WristSnapState): number {\n  // Normalize velocity to 0-1 range\n  const normalizedVelocity = wristState.velocity / ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.MAX_VELOCITY;\n  \n  // Normalize rotation magnitude to 0-1 range\n  const normalizedRotation = Math.abs(wristState.rotation) / ADVANCED_JOINT_CONSTRAINTS.WRIST_SNAP.ROTATION_MAX;\n  \n  // Velocity contributes 70%, rotation contributes 30%\n  const powerFactor = (normalizedVelocity * 0.7) + (normalizedRotation * 0.3);\n  \n  // Hand strikes get up to 25% power bonus from wrist snap\n  return 1.0 + (powerFactor * 0.25);\n}\n\n/**\n * Calculate shoulder elevation for blocks and overhead strikes\n * \n * Determines vertical shoulder movement for defensive blocks and\n * overhead striking techniques in Korean martial arts.\n * \n * @param techniqueType - Type of technique requiring shoulder movement\n * @param phase - Technique phase\n * @param side - Which shoulder\n * @returns Shoulder elevation state with vertical displacement\n * \n * @example\n * ```typescript\n * const shoulderState = calculateShoulderElevation('high-block', 'execution', 'left');\n * // Returns: { elevation: 0.04, side: 'left' }\n * ```\n * \n * @korean 블록및상단공격용어깨들어올림계산\n */\nexport function calculateShoulderElevation(\n  techniqueType: ShoulderTechniqueType,\n  phase: ShoulderPhase,\n  side: BodySide\n): ShoulderElevationState {\n  let elevation = 0;\n\n  switch (techniqueType) {\n    case 'high-block':\n      if (phase === 'preparation') {\n        elevation = -0.02; // Slight drop before elevation\n      } else if (phase === 'execution') {\n        elevation = 0.04; // Elevate for high block\n      } else {\n        elevation = 0.01; // Slight elevation maintained\n      }\n      break;\n\n    case 'overhead-strike':\n      if (phase === 'preparation') {\n        elevation = 0.03; // Pre-elevation for wind-up\n      } else if (phase === 'execution') {\n        elevation = 0.05; // Maximum elevation for overhead power\n      } else {\n        elevation = 0.01;\n      }\n      break;\n\n    case 'rising-block':\n      if (phase === 'preparation') {\n        elevation = -0.03; // Lower for rising motion\n      } else if (phase === 'execution') {\n        elevation = 0.04; // Elevate as block rises\n      } else {\n        elevation = 0.02;\n      }\n      break;\n\n    case 'shrug':\n      if (phase === 'execution') {\n        elevation = 0.05; // Maximum elevation for defensive shrug\n      } else {\n        elevation = 0;\n      }\n      break;\n\n    case 'neutral':\n      elevation = 0;\n      break;\n  }\n\n  // Apply constraints\n  elevation = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SHOULDER_ELEVATION.MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SHOULDER_ELEVATION.MAX, elevation)\n  );\n\n  return { elevation, side };\n}\n\n/**\n * Calculate spinal flexion for dodges and low attacks\n * \n * Determines forward/backward and lateral bending of spine for\n * defensive movements and low attack positioning.\n * \n * @param movementType - Type of movement requiring spinal flexion\n * @param intensity - Movement intensity (0=minimal, 1=full)\n * @returns Spinal flexion state with flexion and lateral bend angles\n * \n * @example\n * ```typescript\n * const spineState = calculateSpinalFlexion('duck', 0.8);\n * // Returns: { flexion: 0.6, lateralBend: 0 }\n * ```\n * \n * @korean 회피및하단공격용척추굽힘계산\n */\nexport function calculateSpinalFlexion(\n  movementType: SpinalMovementType,\n  intensity: number = 1.0\n): SpinalFlexionState {\n  let flexion = 0;\n  let lateralBend = 0;\n\n  // Clamp intensity to 0-1 range\n  intensity = Math.max(0, Math.min(1, intensity));\n\n  switch (movementType) {\n    case 'duck':\n      flexion = 0.7 * intensity; // Forward bend for ducking\n      lateralBend = 0;\n      break;\n\n    case 'lean-back':\n      flexion = -0.4 * intensity; // Backward bend for evasion\n      lateralBend = 0;\n      break;\n\n    case 'lean-left':\n      flexion = 0.1 * intensity; // Slight forward component\n      lateralBend = -0.25 * intensity; // Left lateral bend\n      break;\n\n    case 'lean-right':\n      flexion = 0.1 * intensity;\n      lateralBend = 0.25 * intensity; // Right lateral bend\n      break;\n\n    case 'low-attack':\n      flexion = 0.5 * intensity; // Forward bend for low strikes\n      lateralBend = 0;\n      break;\n\n    case 'neutral':\n      flexion = 0;\n      lateralBend = 0;\n      break;\n  }\n\n  // Apply constraints\n  flexion = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.FLEXION_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.FLEXION_MAX, flexion)\n  );\n  lateralBend = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.LATERAL_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.SPINAL_FLEXION.LATERAL_MAX, lateralBend)\n  );\n\n  return { flexion, lateralBend };\n}\n\n/**\n * Calculate knee drive for knee strikes and clinch\n * \n * Determines independent knee positioning for close-range combat,\n * crucial for knee strike power and clinch work positioning.\n * \n * @param technique - Technique requiring knee drive\n * @param phase - Technique phase\n * @param side - Which knee\n * @returns Knee drive state with height and forward distance\n * \n * @example\n * ```typescript\n * const kneeState = calculateKneeDrive('knee-strike', 'execution', 'right');\n * // Returns: { height: 0.7, forward: 0.25, side: 'right' }\n * ```\n * \n * @korean 무릎차기및클린치용무릎밀어올림계산\n */\nexport function calculateKneeDrive(\n  technique: KneeTechniqueType,\n  phase: KneePhase,\n  side: BodySide\n): KneeDriveState {\n  let height = 0;\n  let forward = 0;\n\n  switch (technique) {\n    case 'knee-strike':\n      if (phase === 'wind-up') {\n        height = 0.3; // Partial chamber\n        forward = 0.1;\n      } else if (phase === 'execution') {\n        height = 0.7; // Drive upward\n        forward = 0.25; // Drive forward for power\n      } else {\n        height = 0.2;\n        forward = 0.05;\n      }\n      break;\n\n    case 'clinch-control':\n      if (phase === 'execution') {\n        height = 0.4; // Moderate elevation for control\n        forward = 0.15; // Forward pressure\n      } else {\n        height = 0.2;\n        forward = 0.08;\n      }\n      break;\n\n    case 'push-kick':\n      if (phase === 'wind-up') {\n        height = 0.5; // High chamber\n        forward = 0.05;\n      } else if (phase === 'execution') {\n        height = 0.6; // Maintain height\n        forward = 0.3; // Strong forward drive\n      } else {\n        height = 0.3;\n        forward = 0.1;\n      }\n      break;\n\n    case 'neutral':\n      height = 0;\n      forward = 0;\n      break;\n  }\n\n  // Apply constraints\n  height = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MAX, height)\n  );\n  forward = Math.max(\n    ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MIN,\n    Math.min(ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MAX, forward)\n  );\n\n  return { height, forward, side };\n}\n\n/**\n * Calculate knee strike power modifier\n * \n * Determines power bonus based on knee drive height and forward momentum.\n * Greater drive generates more power through proper mechanics.\n * \n * @param kneeState - Current knee drive state\n * @returns Power multiplier (1.0-1.35x, with knee strikes getting up to 35% bonus)\n * \n * @example\n * ```typescript\n * const kneeState = calculateKneeDrive('knee-strike', 'execution', 'right');\n * const power = calculateKneeStrikePowerModifier(kneeState);\n * // Returns ~1.30 for properly executed knee strike\n * ```\n * \n * @korean 무릎차기파워배율계산\n */\nexport function calculateKneeStrikePowerModifier(kneeState: KneeDriveState): number {\n  // Normalize height to 0-1 range\n  const normalizedHeight = kneeState.height / ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.HEIGHT_MAX;\n  \n  // Normalize forward drive to 0-1 range\n  const normalizedForward = kneeState.forward / ADVANCED_JOINT_CONSTRAINTS.KNEE_DRIVE.FORWARD_MAX;\n  \n  // Height contributes 60%, forward drive contributes 40%\n  const powerFactor = (normalizedHeight * 0.6) + (normalizedForward * 0.4);\n  \n  // Knee strikes get up to 35% power bonus from proper drive\n  return 1.0 + (powerFactor * 0.35);\n}\n\n"],"mappings":";;;;;;;;;;AA+WA,IAAa,6BAA6B;;;;;CAKxC,cAAc;EACZ,aAAa;EACb,aAAa;EACb,cAAc;EACd,cAAc;EACd,gBAAgB;EAChB,gBAAgB;EACjB;;;;;CAMD,oBAAoB;EAClB,KAAK;EACL,KAAK;EACN;;;;;CAMD,oBAAoB;EAClB,aAAa;EACb,aAAa;EACb,eAAe;EACf,eAAe;EAChB;;;;;CAMD,YAAY;EACV,cAAc;EACd,cAAc;EACd,cAAc;EACf;;;;;CAMD,YAAY;EACV,YAAY;EACZ,YAAY;EACZ,aAAa;EACb,aAAa;EACd;;;;;CAMD,gBAAgB;EACd,aAAa;EACb,aAAa;EACb,aAAa;EACb,aAAa;EACd;CACF;;;;;;;;;;;;;;;;;;;;AA+GD,SAAgB,kCACd,UACA,UACQ;CAER,MAAM,oBAAoB,KAAK,IAAI,SAAS,gBAAgB,GAC1D,2BAA2B,aAAa;CAC1C,MAAM,qBAAqB,KAAK,IAAI,SAAS,iBAAiB,GAC5D,2BAA2B,aAAa;CAC1C,MAAM,uBAAuB,KAAK,IAAI,SAAS,mBAAmB,GAChE,2BAA2B,aAAa;CAG1C,IAAI,cAAc;CAClB,QAAQ,UAAR;EACE,KAAK;GACH,cAAc,qBAAqB,KAAM,oBAAoB;GAC7D;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,uBAAuB,KAAM,qBAAqB;GAC1F;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,uBAAuB;GAC/D;EACF,KAAK;GACH,cAAc,oBAAoB,KAAM,qBAAqB,KAAM,uBAAuB;GAC1F;EACF,KAAK;GACH,cAAc,qBAAqB,KAAM,oBAAoB;GAC7D;;CAIJ,OAAO,IAAO,cAAc"}

package/lib/systems/animation/systems/BodyFacingSystem.d.ts

@@ -74,7 +74,6 @@ export declare const HEAD_TRACKING_SMOOTHING = 0.1;
  * normalizeAngle(-30); // Returns 330
  * ```
  *
- * @public
  * @korean 각도정규화
  */
 export declare function normalizeAngle(angle: number): number;
@@ -95,7 +94,6 @@ export declare function normalizeAngle(angle: number): number;
  * calculateAngleDifference(0, 180); // Returns 180
  * ```
  *
- * @public
  * @korean 각도차이계산
  */
 export declare function calculateAngleDifference(from: number, to: number): number;
@@ -117,7 +115,6 @@ export declare function calculateAngleDifference(from: number, to: number): numb
  * calculateAngleToTarget({ x: 0, y: 0 }, { x: 0, y: 1 }); // Returns 90° (down)
  * ```
  *
- * @public
  * @korean 목표각도계산
  */
 export declare function calculateAngleToTarget(from: Position, to: Position): number;
@@ -127,7 +124,6 @@ export declare function calculateAngleToTarget(from: Position, to: Position): nu
  * @param initialAngle - Initial facing angle in degrees (default: 0)
  * @returns Default BodyFacing state
  *
- * @public
  * @korean 기본몸향하기생성
  */
 export declare function createDefaultBodyFacing(initialAngle?: number): BodyFacing;
@@ -154,7 +150,6 @@ export declare function createDefaultBodyFacing(initialAngle?: number): BodyFaci
  * // Rotates ~0.72° toward 90° (45°/sec * 0.016s)
  * ```
  *
- * @public
  * @korean 몸향하기업데이트
  */
 export declare function updateBodyFacing(facing: BodyFacing, targetAngle: number, deltaTime: number, currentTime: number): BodyFacing;
@@ -183,7 +178,6 @@ export declare function updateBodyFacing(facing: BodyFacing, targetAngle: number
  * // Faces toward opponent (pointing right in this case)
  * ```
  *
- * @public
  * @korean 상대방향하기업데이트
  */
 export declare function updateFacingTowardOpponent(facing: BodyFacing, playerPosition: Position, opponentPosition: Position, deltaTime: number, currentTime: number): BodyFacing;
@@ -196,7 +190,6 @@ export declare function updateFacingTowardOpponent(facing: BodyFacing, playerPos
  * @param facing - Current body facing state
  * @returns Updated body facing state with lock enabled
  *
- * @public
  * @korean 회전잠금
  */
 export declare function lockFacing(facing: BodyFacing): BodyFacing;
@@ -208,7 +201,6 @@ export declare function lockFacing(facing: BodyFacing): BodyFacing;
  * @param facing - Current body facing state
  * @returns Updated body facing state with lock disabled
  *
- * @public
  * @korean 회전잠금해제
  */
 export declare function unlockFacing(facing: BodyFacing): BodyFacing;
@@ -218,7 +210,6 @@ export declare function unlockFacing(facing: BodyFacing): BodyFacing;
  * @param facing - Current body facing state
  * @returns True if 180° turn animation is in progress
  *
- * @public
  * @korean 회전중확인
  */
 export declare function isTurning(facing: BodyFacing): boolean;
@@ -229,7 +220,6 @@ export declare function isTurning(facing: BodyFacing): boolean;
  * @param facing - Current body facing state
  * @returns Current facing angle in radians
  *
- * @public
  * @korean 라디안각도
  */
 export declare function getFacingAngleRadians(facing: BodyFacing): number;
@@ -240,7 +230,6 @@ export declare function getFacingAngleRadians(facing: BodyFacing): number;
  * @param facing - Current body facing state
  * @returns Head rotation angle in radians
  *
- * @public
  * @korean 머리각도라디안
  */
 export declare function getHeadAngleRadians(facing: BodyFacing): number;
@@ -251,7 +240,6 @@ export declare function getHeadAngleRadians(facing: BodyFacing): number;
  * @param facing - Current body facing state
  * @returns Torso rotation in radians (defaults to 0 if not set)
  *
- * @public
  * @korean 허리회전라디안
  */
 export declare function getTorsoRotationRadians(facing: BodyFacing): number;
@@ -262,7 +250,6 @@ export declare function getTorsoRotationRadians(facing: BodyFacing): number;
  * @param facing - Current body facing state
  * @returns Hip rotation in radians
  *
- * @public
  * @korean 골반회전라디안
  */
 export declare function getHipRotationRadians(facing: BodyFacing): number;
@@ -271,7 +258,6 @@ export declare function getHipRotationRadians(facing: BodyFacing): number;
  *
  * Provides centralized system for body facing calculations and updates.
  *
- * @public
  * @korean 몸향하기시스템
  */
 export declare class BodyFacingSystem {
@@ -281,7 +267,6 @@ export declare class BodyFacingSystem {
      * @param initialAngle - Initial facing angle in degrees
      * @returns Default body facing state
      *
-     * @public
      * @korean 기본상태생성
      */
     createDefaultState(initialAngle?: number): BodyFacing;
@@ -295,7 +280,6 @@ export declare class BodyFacingSystem {
      * @param currentTime - Current timestamp
      * @returns Updated body facing state
      *
-     * @public
      * @korean 업데이트
      */
     update(facing: BodyFacing, playerPosition: Position, opponentPosition: Position, deltaTime: number, currentTime: number): BodyFacing;
@@ -305,7 +289,6 @@ export declare class BodyFacingSystem {
      * @param facing - Current body facing state
      * @returns Updated state with lock
      *
-     * @public
      * @korean 잠금
      */
     lock(facing: BodyFacing): BodyFacing;
@@ -315,7 +298,6 @@ export declare class BodyFacingSystem {
      * @param facing - Current body facing state
      * @returns Updated state without lock
      *
-     * @public
      * @korean 잠금해제
      */
     unlock(facing: BodyFacing): BodyFacing;
@@ -323,7 +305,6 @@ export declare class BodyFacingSystem {
 /**
  * Default body facing system instance
  *
- * @public
  * @korean 기본몸향하기시스템
  */
 export declare const bodyFacingSystem: BodyFacingSystem;

package/lib/systems/animation/systems/BodyFacingSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BodyFacingSystem.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/systems/BodyFacingSystem.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BodyFacingSystem.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/systems/BodyFacingSystem.ts"],"names":[],"mappings":"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"}