blacktrigram 0.7.2

package/lib/systems/animation/builders/MartialArtsConstants.d.ts

@@ -0,0 +1,1034 @@
+/**
+ * Martial Arts Animation Constants
+ *
+ * Constants for Korean martial arts animations including hand poses,
+ * martial arts stances, kick phases, and punch phases.
+ *
+ * 한국 무술 애니메이션 상수 모듈
+ *
+ * @module systems/animation/MartialArtsConstants
+ * @category Animation System
+ * @korean 무술애니메이션상수
+ */
+/**
+ * Hand poses for different strike types
+ * 타격 유형별 손 자세
+ *
+ * Each pose defines rotations for all 19 finger joints (per hand):
+ * - thumb_meta, thumb_prox, thumb_dist (3 joints)
+ * - index_meta, index_prox, index_inter, index_dist (4 joints)
+ * - middle_meta, middle_prox, middle_inter, middle_dist (4 joints)
+ * - ring_meta, ring_prox, ring_inter, ring_dist (4 joints)
+ * - pinky_meta, pinky_prox, pinky_inter, pinky_dist (4 joints)
+ *
+ * @korean 손자세
+ */
+export declare const HAND_POSES: {
+    /**
+     * Closed Fist - Standard punch (주먹)
+     * Fingers curled tight, thumb outside
+     */
+    readonly FIST: {
+        readonly thumb_meta: readonly [0.3, 0.5, 0.2];
+        readonly thumb_prox: readonly [0.4, 0, 0];
+        readonly thumb_dist: readonly [0.3, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [1.57, 0, 0];
+        readonly index_inter: readonly [1.57, 0, 0];
+        readonly index_dist: readonly [0.8, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [1.57, 0, 0];
+        readonly middle_inter: readonly [1.57, 0, 0];
+        readonly middle_dist: readonly [0.8, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [1.57, 0, 0];
+        readonly ring_inter: readonly [1.57, 0, 0];
+        readonly ring_dist: readonly [0.8, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [1.57, 0, 0];
+        readonly pinky_inter: readonly [1.57, 0, 0];
+        readonly pinky_dist: readonly [0.8, 0, 0];
+    };
+    /**
+     * Open Palm - Palm strikes, blocks (장권)
+     * Fingers extended, slight spread
+     */
+    readonly OPEN_PALM: {
+        readonly thumb_meta: readonly [0, 0.4, -0.3];
+        readonly thumb_prox: readonly [0.1, 0, 0];
+        readonly thumb_dist: readonly [0, 0, 0];
+        readonly index_meta: readonly [0, 0, -0.1];
+        readonly index_prox: readonly [0, 0, 0];
+        readonly index_inter: readonly [0, 0, 0];
+        readonly index_dist: readonly [0, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [0, 0, 0];
+        readonly middle_inter: readonly [0, 0, 0];
+        readonly middle_dist: readonly [0, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0.1];
+        readonly ring_prox: readonly [0, 0, 0];
+        readonly ring_inter: readonly [0, 0, 0];
+        readonly ring_dist: readonly [0, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0.2];
+        readonly pinky_prox: readonly [0, 0, 0];
+        readonly pinky_inter: readonly [0, 0, 0];
+        readonly pinky_dist: readonly [0, 0, 0];
+    };
+    /**
+     * Spear Hand - Finger strikes (관수)
+     * Fingers together, extended straight
+     */
+    readonly SPEAR_HAND: {
+        readonly thumb_meta: readonly [0.4, 0.6, 0.3];
+        readonly thumb_prox: readonly [0.2, 0, 0];
+        readonly thumb_dist: readonly [0.1, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [0, 0, 0];
+        readonly index_inter: readonly [0, 0, 0];
+        readonly index_dist: readonly [0, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [0, 0, 0];
+        readonly middle_inter: readonly [0, 0, 0];
+        readonly middle_dist: readonly [0, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [0, 0, 0];
+        readonly ring_inter: readonly [0, 0, 0];
+        readonly ring_dist: readonly [0, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [0, 0, 0];
+        readonly pinky_inter: readonly [0, 0, 0];
+        readonly pinky_dist: readonly [0, 0, 0];
+    };
+    /**
+     * Knife Hand - Ridge hand strikes (수도)
+     * Fingers together, thumb tucked
+     */
+    readonly KNIFE_HAND: {
+        readonly thumb_meta: readonly [0.5, 0.8, 0.4];
+        readonly thumb_prox: readonly [0.4, 0, 0];
+        readonly thumb_dist: readonly [0.2, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [0.1, 0, 0];
+        readonly index_inter: readonly [0.05, 0, 0];
+        readonly index_dist: readonly [0, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [0.1, 0, 0];
+        readonly middle_inter: readonly [0.05, 0, 0];
+        readonly middle_dist: readonly [0, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [0.1, 0, 0];
+        readonly ring_inter: readonly [0.05, 0, 0];
+        readonly ring_dist: readonly [0, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [0.1, 0, 0];
+        readonly pinky_inter: readonly [0.05, 0, 0];
+        readonly pinky_dist: readonly [0, 0, 0];
+    };
+    /**
+     * Hammer Fist - Bottom fist strikes (철퇴)
+     * Tight fist for hammer blow
+     */
+    readonly HAMMER_FIST: {
+        readonly thumb_meta: readonly [0.4, 0.6, 0.3];
+        readonly thumb_prox: readonly [0.5, 0, 0];
+        readonly thumb_dist: readonly [0.4, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [1.7, 0, 0];
+        readonly index_inter: readonly [1.7, 0, 0];
+        readonly index_dist: readonly [1, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [1.7, 0, 0];
+        readonly middle_inter: readonly [1.7, 0, 0];
+        readonly middle_dist: readonly [1, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [1.7, 0, 0];
+        readonly ring_inter: readonly [1.7, 0, 0];
+        readonly ring_dist: readonly [1, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [1.7, 0, 0];
+        readonly pinky_inter: readonly [1.7, 0, 0];
+        readonly pinky_dist: readonly [1, 0, 0];
+    };
+    /**
+     * Backfist - Knuckle strikes (등주먹)
+     * Fist with wrist extended back
+     */
+    readonly BACKFIST: {
+        readonly thumb_meta: readonly [0.3, 0.5, 0.2];
+        readonly thumb_prox: readonly [0.3, 0, 0];
+        readonly thumb_dist: readonly [0.2, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [1.4, 0, 0];
+        readonly index_inter: readonly [1.4, 0, 0];
+        readonly index_dist: readonly [0.7, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [1.4, 0, 0];
+        readonly middle_inter: readonly [1.4, 0, 0];
+        readonly middle_dist: readonly [0.7, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [1.4, 0, 0];
+        readonly ring_inter: readonly [1.4, 0, 0];
+        readonly ring_dist: readonly [0.7, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [1.4, 0, 0];
+        readonly pinky_inter: readonly [1.4, 0, 0];
+        readonly pinky_dist: readonly [0.7, 0, 0];
+    };
+    /**
+     * Grab - Grappling and holds (잡기)
+     * Fingers curled for grabbing
+     */
+    readonly GRAB: {
+        readonly thumb_meta: readonly [0.2, 0.3, 0.1];
+        readonly thumb_prox: readonly [0.3, 0, 0];
+        readonly thumb_dist: readonly [0.2, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [1.2, 0, 0];
+        readonly index_inter: readonly [1, 0, 0];
+        readonly index_dist: readonly [0.6, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [1.3, 0, 0];
+        readonly middle_inter: readonly [1.1, 0, 0];
+        readonly middle_dist: readonly [0.7, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [1.3, 0, 0];
+        readonly ring_inter: readonly [1.1, 0, 0];
+        readonly ring_dist: readonly [0.7, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [1.2, 0, 0];
+        readonly pinky_inter: readonly [1, 0, 0];
+        readonly pinky_dist: readonly [0.6, 0, 0];
+    };
+    /**
+     * Two Finger - Eye strikes (이지권)
+     * Index and middle extended, others curled
+     */
+    readonly TWO_FINGER: {
+        readonly thumb_meta: readonly [0.4, 0.6, 0.3];
+        readonly thumb_prox: readonly [0.3, 0, 0];
+        readonly thumb_dist: readonly [0.2, 0, 0];
+        readonly index_meta: readonly [0, 0, -0.1];
+        readonly index_prox: readonly [0, 0, 0];
+        readonly index_inter: readonly [0, 0, 0];
+        readonly index_dist: readonly [0, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0.1];
+        readonly middle_prox: readonly [0, 0, 0];
+        readonly middle_inter: readonly [0, 0, 0];
+        readonly middle_dist: readonly [0, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [1.57, 0, 0];
+        readonly ring_inter: readonly [1.57, 0, 0];
+        readonly ring_dist: readonly [0.8, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [1.57, 0, 0];
+        readonly pinky_inter: readonly [1.57, 0, 0];
+        readonly pinky_dist: readonly [0.8, 0, 0];
+    };
+    /**
+     * Relaxed - Natural/idle hands (자연)
+     * Fingers in natural slight curl
+     */
+    readonly RELAXED: {
+        readonly thumb_meta: readonly [0.1, 0.2, 0.1];
+        readonly thumb_prox: readonly [0.1, 0, 0];
+        readonly thumb_dist: readonly [0.05, 0, 0];
+        readonly index_meta: readonly [0, 0, 0];
+        readonly index_prox: readonly [0.3, 0, 0];
+        readonly index_inter: readonly [0.2, 0, 0];
+        readonly index_dist: readonly [0.1, 0, 0];
+        readonly middle_meta: readonly [0, 0, 0];
+        readonly middle_prox: readonly [0.35, 0, 0];
+        readonly middle_inter: readonly [0.25, 0, 0];
+        readonly middle_dist: readonly [0.15, 0, 0];
+        readonly ring_meta: readonly [0, 0, 0];
+        readonly ring_prox: readonly [0.35, 0, 0];
+        readonly ring_inter: readonly [0.25, 0, 0];
+        readonly ring_dist: readonly [0.15, 0, 0];
+        readonly pinky_meta: readonly [0, 0, 0];
+        readonly pinky_prox: readonly [0.3, 0, 0];
+        readonly pinky_inter: readonly [0.2, 0, 0];
+        readonly pinky_dist: readonly [0.1, 0, 0];
+    };
+};
+/** Type for a single hand pose */
+export type HandPoseType = (typeof HAND_POSES)[keyof typeof HAND_POSES];
+/** Available hand pose names */
+export type HandPoseName = keyof typeof HAND_POSES;
+/**
+ * Standard martial arts poses used across Korean martial arts
+ * 한국 무술의 기본 자세들
+ *
+ * @korean 기본자세
+ */
+export declare const MARTIAL_POSES: {
+    /**
+     * Fighting Guard - Hands protecting face (경계자세)
+     * Standard defensive position in Taekwondo
+     */
+    readonly GUARD: {
+        readonly leftShoulder: readonly [-0.6, 0.4, 0.3];
+        readonly leftElbow: readonly [0, 0, -1.8];
+        readonly rightShoulder: readonly [-0.6, -0.4, -0.3];
+        readonly rightElbow: readonly [0, 0, 1.8];
+    };
+    /**
+     * High Guard - Hands at temple level (상단방어)
+     * Used during kicks for head protection
+     */
+    readonly HIGH_GUARD: {
+        readonly leftShoulder: readonly [-0.9, 0.3, 0.4];
+        readonly leftElbow: readonly [0, 0, -1.6];
+        readonly rightShoulder: readonly [-0.9, -0.3, -0.4];
+        readonly rightElbow: readonly [0, 0, 1.6];
+    };
+    /**
+     * Clinch Position - Arms controlling opponent (클린치)
+     * Used for knee strikes and throws
+     */
+    readonly CLINCH: {
+        readonly leftShoulder: readonly [0.8, 0, -0.5];
+        readonly leftElbow: readonly [0, 0, -1.3];
+        readonly rightShoulder: readonly [0.8, 0, 0.5];
+        readonly rightElbow: readonly [0, 0, 1.3];
+    };
+    /**
+     * Grappling Entry - Reaching for opponent (잡기진입)
+     */
+    readonly GRAPPLE_ENTRY: {
+        readonly leftShoulder: readonly [0.4, 0.6, -0.2];
+        readonly leftElbow: readonly [0, 0, -1.2];
+        readonly rightShoulder: readonly [0.6, -0.4, 0.3];
+        readonly rightElbow: readonly [0, 0, 0.8];
+    };
+    /**
+     * Neutral Standing - Relaxed standing (기본선자세)
+     */
+    readonly NEUTRAL: {
+        readonly leftShoulder: readonly [0, 0, 0.1];
+        readonly leftElbow: readonly [0, 0, -0.2];
+        readonly rightShoulder: readonly [0, 0, -0.1];
+        readonly rightElbow: readonly [0, 0, 0.2];
+    };
+};
+/** Type for martial poses */
+export type MartialPoseType = (typeof MARTIAL_POSES)[keyof typeof MARTIAL_POSES];
+/** Available martial pose names */
+export type MartialPoseName = keyof typeof MARTIAL_POSES;
+/**
+ * Kick phases for proper martial arts execution
+ * 발차기 단계별 자세
+ *
+ * @korean 발차기단계
+ */
+export declare const KICK_PHASES: {
+    /**
+     * Chamber Position (준비자세) - Knee lifted, tight
+     */
+    readonly CHAMBER: {
+        readonly hip: readonly [1.57, 0, 0];
+        readonly knee: readonly [-2, 0, 0];
+        readonly ankle: readonly [0, 0, 0];
+        readonly supportKnee: readonly [-0.25, 0, 0];
+        readonly pelvis: readonly [-0.1, 0, 0];
+    };
+    /**
+     * Extension Position (차기자세) - Leg extended with hip drive
+     *
+     * Enhanced with proper hip Y-rotation for power generation (골반회전)
+     */
+    readonly EXTENSION: {
+        readonly hip: readonly [1.7, 0, 0];
+        readonly knee: readonly [-0.05, 0, 0];
+        readonly ankle: readonly [0.5, 0, 0];
+        readonly supportKnee: readonly [-0.35, 0, 0];
+        readonly pelvis: readonly [0.15, 0, 0];
+        readonly pelvisY: -0.6;
+    };
+    /**
+     * High Axe Kick Peak (높은차기) - Leg nearly vertical
+     */
+    readonly HIGH_PEAK: {
+        readonly hip: readonly [2.5, 0, 0];
+        readonly knee: readonly [-0.1, 0, 0];
+        readonly ankle: readonly [0.6, 0, 0];
+        readonly supportKnee: readonly [-0.35, 0, 0];
+        readonly pelvis: readonly [-0.25, 0, 0];
+    };
+    /**
+     * Roundhouse Chamber (돌려차기준비) - Hip rotated out
+     */
+    readonly ROUNDHOUSE_CHAMBER: {
+        readonly hip: readonly [1.2, 0, 0.8];
+        readonly knee: readonly [-1.5, 0, 0];
+        readonly pelvisY: -0.5;
+        readonly spineY: 0.3;
+    };
+    /**
+     * Side Kick Lateral (옆차기) - Turned sideways
+     */
+    readonly SIDE_CHAMBER: {
+        readonly hip: readonly [1.3, 0, 0.3];
+        readonly knee: readonly [-1.6, 0, 0];
+        readonly pelvisY: -1.57;
+        readonly spineY: -1.2;
+        readonly spineLean: 0.2;
+    };
+};
+/** Type for kick phases */
+export type KickPhaseType = (typeof KICK_PHASES)[keyof typeof KICK_PHASES];
+/** Available kick phase names */
+export type KickPhaseName = keyof typeof KICK_PHASES;
+/**
+ * Punch phases for proper striking mechanics with Korean martial arts biomechanics
+ * 주먹 단계별 자세 - 한국 무술 생체역학 기반
+ *
+ * Based on traditional Korean martial arts principles:
+ * - 정권지르기 (Jeongkwon Jireugi) - Straight punch with fist rotation
+ * - 역권지르기 (Yeokwon Jireugi) - Reverse punch with full hip drive
+ * - 당기기 (Dangigi) - Pulling hand (hikite) for power generation
+ * - 엉덩이회전 (Eongdeongi Hoejeon) - Hip rotation for maximum power
+ * - 어깨비틀기 (Eokkae Biteulgi) - Shoulder torque coordination
+ *
+ * @korean 주먹단계
+ */
+export declare const PUNCH_PHASES: {
+    /**
+     * Chamber (준비) - Arm coiled back with fist vertical
+     *
+     * Korean martial arts chamber position:
+     * - Fist at hip level, palm facing up/in (세로주먹)
+     * - Elbow bent ~90 degrees
+     * - Opposite arm in guard position
+     * - Hip neutral or slightly turned away
+     * - Coiled for explosive extension
+     */
+    readonly CHAMBER: {
+        readonly shoulder: readonly [-0.15, 0, -0.2];
+        readonly elbow: readonly [0, 0, -1.57];
+        readonly wrist: readonly [0, 0, 0];
+        readonly oppositeShoulder: readonly [-0.1, 0, 0.2];
+        readonly oppositeElbow: readonly [0, 0, 1.4];
+        readonly spineY: -0.1;
+        readonly pelvisY: -0.1;
+    };
+    /**
+     * Wind-up (준비강화) - Brief additional coil before strike
+     *
+     * Minimal wind-up for fast punches like jab.
+     * More pronounced for power punches like cross.
+     */
+    readonly WINDUP: {
+        readonly shoulder: readonly [0.3, 0, -0.3];
+        readonly elbow: readonly [0, 0, 1.8];
+        readonly spineY: -0.15;
+        readonly pelvisY: -0.1;
+    };
+    /**
+     * Extension with Hip Drive (지르기) - Full extension with body rotation
+     *
+     * Korean martial arts extension mechanics:
+     * - Fist rotates from vertical to pronated (palm-down)
+     * - Hip drives forward and rotates (엉덩이회전)
+     * - Shoulder rotates with punch (어깨비틀기)
+     * - Opposite arm pulls back to hip (당기기/hikite)
+     * - Elbow nearly straight at impact (~170-175°)
+     */
+    readonly EXTENSION: {
+        readonly shoulder: readonly [0.25, 0, 0.15];
+        readonly elbow: readonly [0, 0, -0.09];
+        readonly wrist: readonly [0, 0, 0.2];
+        readonly oppositeShoulder: readonly [-0.2, 0, -0.3];
+        readonly oppositeElbow: readonly [0, 0, 1.1];
+        readonly spineY: 0.4;
+        readonly pelvisY: 0.25;
+    };
+    /**
+     * Peak Impact (정점) - Maximum extension and rotation
+     *
+     * Brief hold at full extension for impact frame.
+     * All power delivered through aligned structure.
+     * Slight additional arm extension for maximum reach.
+     */
+    readonly PEAK: {
+        readonly shoulder: readonly [0.25, 0, 0.15];
+        readonly elbow: readonly [0, 0, -0.05];
+        readonly wrist: readonly [0, 0, 0.2];
+        readonly oppositeShoulder: readonly [-0.2, 0, -0.3];
+        readonly oppositeElbow: readonly [0, 0, 1.1];
+        readonly spineY: 0.45;
+        readonly pelvisY: 0.3;
+    };
+};
+/** Type for punch phases */
+export type PunchPhaseType = (typeof PUNCH_PHASES)[keyof typeof PUNCH_PHASES];
+/** Available punch phase names */
+export type PunchPhaseName = keyof typeof PUNCH_PHASES;
+/**
+ * Korean Martial Arts Stance Biomechanics
+ *
+ * Authentic biomechanical configurations for all eight trigram stances (팔괘 자세),
+ * based on traditional Korean martial arts (Taekwondo 태권도, Hapkido 합기도, Taekyon 택견).
+ *
+ * Each stance defines:
+ * - frontKneeBend: Front leg knee flexion angle in degrees (무릎굽힘각도)
+ * - backKneeBend: Back leg knee flexion angle in degrees (뒷다리무릎각도)
+ * - weightDistribution: Front/back weight ratio (체중분배)
+ * - stanceWidth: Distance between feet in shoulder widths (발간격)
+ * - hipHeight: Hip height relative to standing (0-1 scale) (엉덩이높이)
+ * - tacticalRationale: Combat purpose of stance width (전술적 근거)
+ *
+ * Angle conventions:
+ * - 180° = Fully straight leg (완전히 펴진 다리)
+ * - 90° = Right angle bend (직각 굽힘)
+ * - Lower angles = Deeper bend (낮은 각도 = 더 깊은 굽힘)
+ *
+ * Weight distribution:
+ * - front: 0.6 = 60% weight on front leg (앞발 60% 체중)
+ * - back: 0.4 = 40% weight on back leg (뒷발 40% 체중)
+ *
+ * Stance width tactical purposes:
+ * - Wide stances (1.5-2.0x): Stability, power generation, low center of gravity
+ * - Medium stances (1.0-1.3x): Balance between mobility and stability
+ * - Narrow stances (0.8-1.0x): High mobility, quick footwork
+ * - Single leg (0.0x): Maximum mobility, continuous attack capability
+ *
+ * Sources:
+ * - Taekwondo (태권도) - KTA/WTF standard stances
+ * - Hapkido (합기도) - Traditional defensive stances
+ * - Taekyon (택견) - Korean traditional martial art stances
+ *
+ * @korean 한국무술자세생체역학
+ */
+export declare const KOREAN_STANCE_BIOMECHANICS: {
+    /**
+     * ☰ GEON (건) - HEAVEN STANCE | 하늘 자세
+     *
+     * Forward stance (앞서기) - Taekwondo Ap Seogi
+     *
+     * Characteristics:
+     * - Aggressive forward position for direct force techniques
+     * - Deep front knee bend for power generation
+     * - Extended back leg for solid base
+     * - 60/40 weight distribution favoring front
+     * - 1.2-1.5x shoulder width for forward power transfer
+     *
+     * Tactical rationale for stance width:
+     * - Medium-wide base (1.2-1.5x) provides forward power generation
+     * - Wide enough for stability during penetrating strikes
+     * - Narrower than defensive stances for offensive mobility
+     * - Optimal for weight transfer into punches and forward kicks
+     *
+     * Korean martial art source: Taekwondo (태권도)
+     *
+     * @korean 건천자세
+     */
+    readonly GEON_HEAVEN: {
+        readonly frontKneeBend: 70;
+        readonly backKneeBend: 160;
+        readonly weightDistribution: {
+            readonly front: 0.6;
+            readonly back: 0.4;
+        };
+        readonly stanceWidth: 1.35;
+        readonly hipHeight: 0.85;
+        readonly tacticalRationale: "power_generation";
+    };
+    /**
+     * ☱ TAE (태) - LAKE STANCE | 호수 자세
+     *
+     * Cat stance (고양이서기) - Taekwondo Beom Seogi
+     *
+     * Characteristics:
+     * - Fluid defensive position for joint manipulation
+     * - Most weight on back leg (90/10)
+     * - Front leg light and mobile for kicking
+     * - Back knee bent for spring-loaded movement
+     * - High hip position for quick transitions
+     * - 0.8-1.0x shoulder width for maximum mobility
+     *
+     * Tactical rationale for stance width:
+     * - Narrow base (0.8-1.0x) enables rapid footwork
+     * - Quick transitions between stances
+     * - Mobile front leg ready for instant kicks or steps
+     * - Back-weighted for defensive redirection
+     *
+     * Korean martial art source: Hapkido (합기도)
+     *
+     * @korean 태호수자세
+     */
+    readonly TAE_LAKE: {
+        readonly frontKneeBend: 170;
+        readonly backKneeBend: 120;
+        readonly weightDistribution: {
+            readonly front: 0.1;
+            readonly back: 0.9;
+        };
+        readonly stanceWidth: 0.9;
+        readonly hipHeight: 0.9;
+        readonly tacticalRationale: "mobility";
+    };
+    /**
+     * ☲ LI (리) - FIRE STANCE | 불 자세
+     *
+     * Fighting stance (전투서기) - Taekwondo Gyeorugi Junbi Seogi
+     *
+     * Characteristics:
+     * - Balanced 50/50 stance for precision strikes
+     * - Both knees moderately bent (~135°)
+     * - Mobile and ready to move in any direction
+     * - Medium width for stability and mobility
+     * - Standard combat readiness position
+     * - 1.0-1.2x shoulder width for balanced combat
+     *
+     * Tactical rationale for stance width:
+     * - Standard width (1.0-1.2x) balances all combat attributes
+     * - Quick directional changes while maintaining stability
+     * - Optimal for precision vital point targeting
+     * - Neutral foundation for offensive and defensive transitions
+     *
+     * Korean martial art source: Taekwondo (태권도)
+     *
+     * @korean 리화염자세
+     */
+    readonly LI_FIRE: {
+        readonly frontKneeBend: 135;
+        readonly backKneeBend: 135;
+        readonly weightDistribution: {
+            readonly front: 0.5;
+            readonly back: 0.5;
+        };
+        readonly stanceWidth: 1.1;
+        readonly hipHeight: 0.88;
+        readonly tacticalRationale: "balance";
+    };
+    /**
+     * ☳ JIN (진) - THUNDER STANCE | 천둥 자세
+     *
+     * Horse stance (기마서기) - Taekwondo Juchum Seogi
+     *
+     * Characteristics:
+     * - Wide, powerful stance for explosive techniques
+     * - Deep knee bend in both legs (~90°)
+     * - Equal weight distribution (50/50)
+     * - Very low hip position for ground stability
+     * - Feet parallel, pointing forward
+     * - 1.8-2.2x shoulder width for maximum stability
+     *
+     * Tactical rationale for stance width:
+     * - Very wide base (1.8-2.2x) maximizes lateral stability
+     * - Low center of gravity for explosive power generation
+     * - Immovable platform for devastating techniques
+     * - Trades mobility for overwhelming striking force
+     *
+     * Korean martial art source: Taekwondo (태권도)
+     *
+     * @korean 진천둥자세
+     */
+    readonly JIN_THUNDER: {
+        readonly frontKneeBend: 90;
+        readonly backKneeBend: 90;
+        readonly weightDistribution: {
+            readonly front: 0.5;
+            readonly back: 0.5;
+        };
+        readonly stanceWidth: 2;
+        readonly hipHeight: 0.75;
+        readonly tacticalRationale: "stability";
+    };
+    /**
+     * ☴ SON (손) - WIND STANCE | 바람 자세
+     *
+     * Crane stance (학서기) - Taekwondo Hakdari Seogi
+     *
+     * Characteristics:
+     * - One-legged balance for continuous movement
+     * - Standing leg nearly straight (~170°)
+     * - All weight on standing leg (100%)
+     * - Raised leg ready for rapid kicks
+     * - High hip position for mobility
+     * - 0.0 stance width (single leg stance)
+     *
+     * Tactical rationale for stance width:
+     * - Zero width (0.0x) - single leg stance for extreme mobility
+     * - Raised leg enables instant kicks without chambering
+     * - Maximum freedom of movement in all directions
+     * - Continuous pressure capability through rapid strikes
+     * - Highest mobility, lowest stability trade-off
+     *
+     * Korean martial art source: Taekyon (택견)
+     *
+     * @korean 손바람자세
+     */
+    readonly SON_WIND: {
+        readonly frontKneeBend: 170;
+        readonly backKneeBend: 45;
+        readonly weightDistribution: {
+            readonly front: 1;
+            readonly back: 0;
+        };
+        readonly stanceWidth: 0;
+        readonly hipHeight: 0.92;
+        readonly tacticalRationale: "extreme_mobility";
+    };
+    /**
+     * ☵ GAM (감) - WATER STANCE | 물 자세
+     *
+     * Back stance (뒤서기) - Taekwondo Dwit Seogi
+     *
+     * Characteristics:
+     * - Defensive stance with weight on back leg
+     * - Deep back knee bend (~100°) for absorption
+     * - Front leg light for quick defense
+     * - 30/70 weight distribution (back-heavy)
+     * - Medium-low hip for stability
+     * - 1.0-1.3x shoulder width for adaptive response
+     *
+     * Tactical rationale for stance width:
+     * - Medium width (1.0-1.3x) enables flow and adaptation
+     * - Wide enough for stable defensive absorption
+     * - Narrow enough for quick counter-movements
+     * - Optimal for redirecting opponent's force
+     *
+     * Korean martial art source: Hapkido (합기도)
+     *
+     * @korean 감물자세
+     */
+    readonly GAM_WATER: {
+        readonly frontKneeBend: 150;
+        readonly backKneeBend: 100;
+        readonly weightDistribution: {
+            readonly front: 0.3;
+            readonly back: 0.7;
+        };
+        readonly stanceWidth: 1.15;
+        readonly hipHeight: 0.82;
+        readonly tacticalRationale: "adaptability";
+    };
+    /**
+     * ☶ GAN (간) - MOUNTAIN STANCE | 산 자세
+     *
+     * Defensive stance (방어서기) - Hapkido Bangeoseogi
+     *
+     * Characteristics:
+     * - Immovable defensive position
+     * - Moderate knee bend in both legs (~120°)
+     * - Slightly back-weighted (40/60)
+     * - Medium width for solid base
+     * - Medium-high hip for counter readiness
+     * - 1.3-1.6x shoulder width for defensive strength
+     *
+     * Tactical rationale for stance width:
+     * - Wide base (1.3-1.6x) provides immovable blocking platform
+     * - Stable foundation for absorbing powerful attacks
+     * - Wide enough for strong defensive counters
+     * - Rooted position for reversal techniques
+     *
+     * Korean martial art source: Hapkido (합기도)
+     *
+     * @korean 간산자세
+     */
+    readonly GAN_MOUNTAIN: {
+        readonly frontKneeBend: 120;
+        readonly backKneeBend: 120;
+        readonly weightDistribution: {
+            readonly front: 0.4;
+            readonly back: 0.6;
+        };
+        readonly stanceWidth: 1.45;
+        readonly hipHeight: 0.87;
+        readonly tacticalRationale: "defensive_block";
+    };
+    /**
+     * ☷ GON (곤) - EARTH STANCE | 땅 자세
+     *
+     * Low stance (낮은서기) - Korean Ssireum (씨름) wrestling stance
+     *
+     * Characteristics:
+     * - Very low, grounded position for takedowns
+     * - Deep knee bend in both legs (~80°)
+     * - Equal weight distribution (50/50)
+     * - Wide stance for base and grappling
+     * - Very low hip position for ground control
+     * - 1.6-2.0x shoulder width for grappling control
+     *
+     * Tactical rationale for stance width:
+     * - Very wide base (1.6-2.0x) optimal for takedown defense
+     * - Low center of gravity prevents being thrown
+     * - Wide platform for initiating grappling techniques
+     * - Grounded power for throws and slams
+     *
+     * Korean martial art source: Ssireum (씨름) / Hapkido ground techniques
+     *
+     * @korean 곤땅자세
+     */
+    readonly GON_EARTH: {
+        readonly frontKneeBend: 80;
+        readonly backKneeBend: 80;
+        readonly weightDistribution: {
+            readonly front: 0.5;
+            readonly back: 0.5;
+        };
+        readonly stanceWidth: 1.8;
+        readonly hipHeight: 0.72;
+        readonly tacticalRationale: "grounding";
+    };
+};
+/** Type for Korean stance biomechanics */
+export type KoreanStanceBiomechanicsType = (typeof KOREAN_STANCE_BIOMECHANICS)[keyof typeof KOREAN_STANCE_BIOMECHANICS];
+/** Available Korean stance biomechanics names */
+export type KoreanStanceName = keyof typeof KOREAN_STANCE_BIOMECHANICS;
+/**
+ * Animation type identifiers for the animation system
+ * @korean 애니메이션타입
+ */
+export declare enum AnimationType {
+    FRONT_KICK = "front_kick",
+    ROUNDHOUSE_KICK = "roundhouse_kick",
+    SIDE_KICK = "side_kick",
+    AXE_KICK = "axe_kick",
+    CRESCENT_KICK = "crescent_kick",
+    SPINNING_HOOK = "spinning_hook",
+    BACK_KICK = "back_kick",
+    PUSH_KICK = "push_kick",
+    LOW_KICK = "low_kick",
+    KNEE_KICK = "knee_kick",
+    FLYING_KICK = "flying_kick",
+    TORNADO_KICK = "tornado_kick",
+    JUMPING_KICK = "jumping_kick",
+    SPINNING_HEEL_KICK = "spinning_heel_kick",
+    JAB = "jab",
+    CROSS = "cross",
+    HOOK = "hook",
+    UPPERCUT = "uppercut",
+    OVERHAND = "overhand",
+    PALM_STRIKE = "palm_strike",
+    BACKFIST = "backfist",
+    HAMMER_FIST = "hammer_fist",
+    SPEAR_HAND_STRIKE = "spear_hand_strike",// li_flame_spear - Finger thrust
+    NERVE_STRIKE = "nerve_strike",// li_nerve_strike - Pressure point jab
+    PRESSURE_POINT_STRIKE = "pressure_point_strike",// li_pressure_point - Precision strike
+    LIGHTNING_STRIKE = "lightning_strike",// jin_lightning_flash - Fast explosive jab
+    RAPID_BARRAGE = "rapid_barrage",// son_whirlwind_barrage - Multiple fast jabs
+    RHYTHMIC_STRIKES = "rhythmic_strikes",// son_rhythmic_strikes - Patterned jabs
+    NERVE_PARALYSIS = "nerve_paralysis",// darkops_nerve_paralysis - Debilitating strike
+    THROAT_STRIKE = "throat_strike",// darkops_throat_strike - Airway attack
+    EYE_GOUGE = "eye_gouge",// darkops_eye_gouge - Vision attack
+    HEAVEN_STRIKE = "heaven_strike",// geon_heaven_strike - Powerful descending cross
+    FLOWING_CROSS = "flowing_cross",// tae_flowing_strikes - Circular cross motion
+    SOLAR_PLEXUS_STRIKE = "solar_plexus_strike",// li_solar_plexus_strike - Diaphragm shock
+    FLOWING_PUSH = "flowing_push",// son_flowing_push - Redirecting palm
+    LIVER_DISRUPTION = "liver_disruption",// darkops_liver_disruption - Organ strike
+    EAR_STRIKE = "ear_strike",// darkops_ear_strike - Concussive palm
+    ELBOW_STRIKE = "elbow_strike",
+    KNEE_STRIKE = "knee_strike",
+    ELBOW_UPPERCUT = "elbow_uppercut",
+    FLYING_KNEE = "flying_knee",
+    CLINCH_KNEE = "clinch_knee",
+    SPINNING_ELBOW = "spinning_elbow",
+    TEMPLE_ELBOW = "temple_elbow",// li_temple_strike - Lateral temple strike
+    SPINNING_BACK_ELBOW = "spinning_back_elbow",// son_spinning_elbow - Rotational power
+    SPINAL_ELBOW = "spinal_elbow",// darkops_spinal_strike - Vertebrae targeting
+    BRACHIAL_ELBOW = "brachial_elbow",// darkops_brachial_plexus_strike - Nerve cluster
+    KIDNEY_KNEE = "kidney_knee",// darkops_kidney_strike - Organ targeting
+    FEMORAL_KNEE = "femoral_knee",// darkops_femoral_nerve_strike - Nerve targeting
+    THROW = "throw",
+    JOINT_LOCK = "joint_lock",
+    TAKEDOWN = "takedown",
+    SWEEP = "sweep",
+    CLINCH = "clinch",
+    GRAPPLE = "grapple",
+    SLAM = "slam",
+    WRIST_LOCK = "wrist_lock",
+    ARM_BAR = "arm_bar",
+    SHOULDER_LOCK = "shoulder_lock",
+    HIP_THROW = "hip_throw",
+    LEG_REAP = "leg_reap",
+    SMALL_CIRCLE_LOCK = "small_circle_lock",// tae_small_circle - Subtle joint control
+    FINGER_LOCK = "finger_lock",// tae_finger_lock - Digit manipulation
+    ELBOW_LOCK = "elbow_lock",// tae_elbow_lock - Arm hyperextension
+    SHOULDER_MANIPULATION = "shoulder_manipulation",// tae_shoulder_lock - Rotator cuff attack
+    MOUNTAIN_LOCK = "mountain_lock",// gan_mountain_stance_lock - Immobilizing hold
+    EARTH_EMBRACE = "earth_embrace",// gon_earth_embrace - Ground control
+    CAROTID_CHOKE = "carotid_choke",// darkops_silent_carotid - Blood choke
+    REAR_NAKED_CHOKE = "rear_naked_choke",// darkops_rear_choke - Air choke
+    REDIRECT_THROW = "redirect_throw",// gam_redirect_throw - Using opponent's momentum
+    HIP_WHEEL_THROW = "hip_wheel_throw",// gam_hip_throw - O-goshi style
+    SSIREUM_THROW = "ssireum_throw",// gon_ssireum_throw - Korean wrestling throw
+    SACRIFICE_THROW = "sacrifice_throw",// gon_sacrifice_throw - Tomoe nage style
+    ANKLE_PICK = "ankle_pick",// gon_ankle_pick - Single leg takedown entry
+    ACHILLES_ATTACK = "achilles_attack",// darkops_achilles_sever - Tendon targeting
+    BODY_LOCK_SLAM = "body_lock_slam",// gon_body_lock_takedown - Bear hug slam
+    WRIST_TWIST_COUNTER = "wrist_twist_counter",// gam_wrist_twist_counter - Counter technique
+    COUNTER_STRIKE = "counter_strike",
+    PARRY_COUNTER = "parry_counter",
+    COUNTER_ATTACK = "counter_attack",
+    WATER_COUNTER = "water_counter",// gam_water_counter - Fluid redirection
+    ROCK_COUNTER = "rock_counter",// gan_counter_strike - Immovable counter
+    BLOCK = "block",
+    BLOCK_HIGH = "block_high",
+    BLOCK_LOW = "block_low",
+    PARRY = "parry",
+    FLOWING_BLOCK = "flowing_block",// gam_flowing_block - Soft redirection
+    CIRCULAR_PARRY = "circular_parry",// gam_circular_parry - Rotational deflect
+    ROCK_DEFENSE = "rock_defense",// gan_rock_defense - Immovable guard
+    IRON_BLOCK = "iron_block",// gan_iron_block - Hard block
+    FLOW_DEFENSE = "flow_defense",// gam_flow_defense - Water-like defense
+    IMMOVABLE_BLOCK = "immovable_block",// gan_immovable_block - Mountain defense
+    EXPLOSIVE_BLOCK = "explosive_block",// jin_explosive_block - Counter with block
+    CONTINUOUS_DEFLECTION = "continuous_deflection",// son_continuous_deflection - Wind deflection
+    PRECISION_PARRY = "precision_parry",// li_precision_parry - Fire precision
+    JOINT_LOCK_DEFENSE = "joint_lock_defense",// tae_joint_lock_defense - Hapkido defense
+    SWEEP_DEFENSE = "sweep_defense",// tae_sweep_defense - Low defense
+    GROUNDING_DEFENSE = "grounding_defense",// gon_grounding_defense - Earth rooting
+    JAW_DISLOCATION = "jaw_dislocation",// darkops_jaw_dislocation - TMJ attack
+    TEMPLE_STRIKE = "temple_strike",// darkops_temple_strike - Temporal bone strike
+    CERVICAL_TWIST = "cervical_twist",// darkops_cervical_twist - Neck manipulation
+    ELBOW_HYPEREXTEND = "elbow_hyperextend",// darkops_elbow_hyperextend - Joint destruction
+    FINGER_BREAK = "finger_break",// darkops_finger_break - Digit targeting
+    GUILLOTINE_CHOKE = "guillotine_choke",// darkops_guillotine - Front choke
+    JUGULAR_STRIKE = "jugular_strike",// darkops_jugular_strike - Vein targeting
+    KNEECAP_STRIKE = "kneecap_strike",// darkops_kneecap_strike - Patella attack
+    LARYNX_CRUSH = "larynx_crush",// darkops_larynx_crush - Throat destruction
+    OCCIPITAL_STRIKE = "occipital_strike",// darkops_occipital_strike - Skull base
+    SCIATIC_NERVE_STRIKE = "sciatic_nerve_strike",// darkops_sciatic_nerve - Leg nerve
+    SILENT_TAKEDOWN = "silent_takedown",// darkops_silent_takedown - Stealth attack
+    SLEEPER_HOLD = "sleeper_hold",// darkops_sleeper_hold - Sleep choke
+    SPLEEN_RUPTURE = "spleen_rupture",// darkops_spleen_rupture - Organ destruction
+    TRIANGLE_CHOKE = "triangle_choke",// darkops_triangle_choke - Leg choke
+    BRACHIAL_PLEXUS = "brachial_plexus",// darkops_brachial_plexus - Nerve cluster
+    FEMORAL_NERVE = "femoral_nerve",// darkops_femoral_nerve - Thigh nerve
+    GEON_HEAVEN_STRIKE = "geon_heaven_strike",
+    HIGH_BLOCK = "high_block",// geon_high_block - Overhead defense
+    CRUSHING_ELBOW = "crushing_elbow",// geon_crushing_elbow - Downward elbow
+    THUNDEROUS_UPPERCUT = "thunderous_uppercut",// geon_thunderous_uppercut - Rising power
+    GEON_COUNTER = "geon_counter",// geon_counter_strike - Heaven counter
+    GEON_ROUNDHOUSE = "geon_roundhouse",// geon_roundhouse - Power kick
+    FLOWING_ARM_BAR = "flowing_arm_bar",// tae_flowing_arm_bar - Fluid armlock
+    SPIRAL_SHOULDER_THROW = "spiral_shoulder_throw",// tae_spiral_shoulder_throw - Circular throw
+    WRIST_LOCK_STRIKE = "wrist_lock_strike",// tae_wrist_lock_strike - Lock with strike
+    PHOENIX_EYE_STRIKE = "phoenix_eye_strike",// li_phoenix_eye_strike - Single knuckle
+    NERVE_STRIKE_COUNTER = "nerve_strike_counter",// li_nerve_strike_counter - Pressure counter
+    SOLAR_PLEXUS_SPEAR = "solar_plexus_spear",// li_solar_plexus_spear - Diaphragm thrust
+    LI_SOLAR_PLEXUS = "li_solar_plexus",// li_solar_plexus - Precision strike
+    EXPLOSIVE_KNEE = "explosive_knee",// jin_explosive_knee - Thundering knee
+    LIGHTNING_STRAIGHT = "lightning_straight",// jin_lightning_straight - Fast cross
+    SHOCKING_COUNTER = "shocking_counter",// jin_shocking_counter - Thunder counter
+    SHOCKING_HAMMER_FIST = "shocking_hammer_fist",// jin_shocking_hammer_fist - Power hammer
+    PENETRATING_PALM_RUSH = "penetrating_palm_rush",// son_penetrating_palm_rush - Wind palm barrage
+    PRESSURE_COUNTER = "pressure_counter",// son_pressure_counter - Continuous counter
+    PRESSURE_POINT_CHAIN = "pressure_point_chain",// son_pressure_point_chain - Multiple points
+    FLOWING_RIVER_STRIKE = "flowing_river_strike",// gam_flowing_river_strike - Water flow attack
+    REDIRECTION_COUNTER = "redirection_counter",// gam_redirection_counter - Momentum counter
+    TIDAL_WAVE_PALM = "tidal_wave_palm",// gam_tidal_wave_palm - Wave impact
+    WHIRLPOOL_COUNTER = "whirlpool_counter",// gam_whirlpool_counter - Circular counter
+    AVALANCHE_HAMMER = "avalanche_hammer",// gan_avalanche_hammer - Crushing force
+    COUNTER_FORTRESS = "counter_fortress",// gan_counter_fortress - Immovable counter
+    FORTRESS_COUNTER_STRIKE = "fortress_counter_strike",// gan_fortress_counter_strike - Defensive strike
+    STONE_WALL_THRUST = "stone_wall_thrust",// gan_stone_wall_thrust - Heavy push
+    EARTHQUAKE_STOMP = "earthquake_stomp",// gon_earthquake_stomp - Ground impact
+    GROUND_SWEEP_STRIKE = "ground_sweep_strike",// gon_ground_sweep_strike - Low attack
+    ROOTING_TAKEDOWN = "rooting_takedown",// gon_rooting_takedown - Grounding takedown
+    TAKEDOWN_COUNTER = "takedown_counter",// gon_takedown_counter - Takedown defense
+    GEON_HEAVENLY_FIST = "geon_heavenly_fist",// geon_heavenly_fist - Taekwondo power punch
+    GEON_FRONTAL_KICK = "geon_frontal_kick",// geon_frontal_kick - Direct power kick
+    GEON_PALM_STRIKE = "geon_palm_strike",// geon_palm_strike - Heavenly palm
+    GAN_ROCK_DEFENSE_BLOCK = "gan_rock_defense_block",// gan_rock_defense - Mountain guard
+    GAN_IMMOVABLE_STANCE = "gan_immovable_stance",// gan_immovable_stance - Unmoving defense
+    GAN_COUNTER_STRIKE = "gan_counter_strike",// gan_counter_strike - Mountain counter
+    GAN_REVERSAL_TECHNIQUE = "gan_reversal_technique",// gan_reversal_technique - Defensive reversal
+    GAN_MOUNTAIN_STANCE_LOCK = "gan_mountain_stance_lock",// gan_mountain_stance_lock - Immobilizing hold
+    GAM_CIRCULAR_PARRY = "gam_circular_parry",// gam_circular_parry - Circular deflection
+    GAM_REDIRECT_THROW = "gam_redirect_throw",// gam_redirect_throw - Momentum redirection
+    GAM_HIP_THROW = "gam_hip_throw",// gam_hip_throw - Water hip wheel
+    GON_EARTH_EMBRACE = "gon_earth_embrace",// gon_earth_embrace - Ground control hold
+    GON_ANKLE_PICK = "gon_ankle_pick",// gon_ankle_pick - Single leg takedown
+    GON_BODY_LOCK_TAKEDOWN = "gon_body_lock_takedown",// gon_body_lock_takedown - Bear hug slam
+    GON_SSIREUM_THROW = "gon_ssireum_throw",// gon_ssireum_throw - Korean wrestling throw
+    GON_SACRIFICE_THROW = "gon_sacrifice_throw",// gon_sacrifice_throw - Tomoe nage style
+    SON_RHYTHMIC_STRIKES = "son_rhythmic_strikes",// son_rhythmic_strikes - Wind rhythm combo
+    SON_FLOWING_PUSH = "son_flowing_push",// son_flowing_push - Wind wave palm
+    SON_RAPID_FOOTWORK = "son_rapid_footwork",// son_rapid_footwork - Wind step kick
+    JIN_JUMPING_FRONT_KICK = "jin_jumping_front_kick",// jin_jumping_front_kick - Thunder leap
+    JIN_FLYING_SIDEKICK = "jin_flying_sidekick",// jin_flying_sidekick - Explosive aerial kick
+    TAE_WRIST_LOCK = "tae_wrist_lock",// tae_wrist_lock - Flowing joint manipulation
+    GAM_WRIST_TWIST_COUNTER = "gam_wrist_twist_counter",// gam_wrist_twist_counter - Water redirection lock
+    SON_SWEEPING_LOW_KICK = "son_sweeping_low_kick",// son_sweeping_low_kick - Wind sweep
+    GON_LEG_SWEEP = "gon_leg_sweep",// gon_leg_sweep - Earth grounding sweep
+    DRAGON_FIST = "dragon_fist",// musa_dragon_fist - Traditional power punch
+    IRON_DEFENSE = "iron_defense",// musa_iron_defense - Warrior block
+    MOUNTAIN_BREAKER = "mountain_breaker",// musa_mountain_breaker - Devastating strike
+    THUNDER_STRIKE = "thunder_strike",// musa_thunder_strike - Powerful attack
+    DEADLY_PRECISION = "deadly_precision",// amsalja_deadly_precision - Lethal accuracy
+    SHADOW_NERVE_STRIKE = "shadow_nerve_strike",// amsalja_nerve_strike - Hidden nerve attack
+    SHADOW_STRIKE = "shadow_strike",// amsalja_shadow_strike - Stealth attack
+    SILENT_DEATH = "silent_death",// amsalja_silent_death - Lethal finisher
+    CYBER_OVERDRIVE = "cyber_overdrive",// hacker_cyber_overdrive - Enhanced attack
+    DATA_STRIKE = "data_strike",// hacker_data_strike - Technical strike
+    ELECTRIC_SHOCK = "electric_shock",// hacker_electric_shock - Stunning attack
+    SYSTEM_CRASH = "system_crash",// hacker_system_crash - Disabling strike
+    COUNTER_INTELLIGENCE = "counter_intelligence",// jeongbo_counter_intelligence - Defensive counter
+    INTELLIGENCE_STRIKE = "intelligence_strike",// jeongbo_intelligence_strike - Calculated attack
+    PSYCHOLOGICAL_WARFARE = "psychological_warfare",// jeongbo_psychological_warfare - Mind attack
+    TACTICAL_STRIKE = "tactical_strike",// jeongbo_tactical_strike - Strategic hit
+    BRUTAL_TAKEDOWN = "brutal_takedown",// jojik_brutal_takedown - Ruthless takedown
+    IMPROVISED_WEAPON = "improvised_weapon",// jojik_improvised_weapon - Street fighting
+    RUTHLESS_ASSAULT = "ruthless_assault",// jojik_ruthless_assault - Savage attack
+    STREET_BRAWL = "street_brawl",// jojik_street_brawl - Dirty fighting
+    STEP_FORWARD = "step_forward",
+    STEP_BACK = "step_back",
+    SIDESTEP = "sidestep",
+    PIVOT = "pivot",
+    DUCK = "duck",
+    LEAN = "lean",
+    WALK = "walk",
+    IDLE_STANCE = "idle_stance",
+    FORWARD_DASH = "forward_dash",
+    BACKWARD_RETREAT = "backward_retreat",
+    SIDE_STEP = "side_step",
+    RAPID_FOOTWORK = "rapid_footwork",
+    RECOVERY = "recovery",
+    IDLE = "idle",
+    STANCE = "stance"
+}
+/**
+ * Calculate lateral stance width in world units (meters)
+ *
+ * Converts stance width from shoulder width multipliers to actual
+ * world-space distance for foot positioning in 3D space.
+ *
+ * Formula: stanceWidth (m) = shoulderWidth (cm) * multiplier / 100
+ *
+ * Example:
+ * - shoulderWidth: 46 cm (Musa archetype)
+ * - Jin Thunder stance: 2.0x shoulder width
+ * - Result: 46 * 2.0 / 100 = 0.92m lateral distance between feet
+ *
+ * @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS (e.g., 1.5 for Jin)
+ * @param shoulderWidth - Fighter's shoulder width in centimeters (from physical attributes)
+ * @returns Stance width in meters for 3D world positioning
+ *
+ * @korean 자세너비계산
+ */
+export declare function calculateStanceWidth(stanceWidthMultiplier: number, shoulderWidth: number): number;
+/**
+ * Calculate foot X positions for left and right feet based on stance width
+ *
+ * Returns X-axis offsets for positioning FOOT_L and FOOT_R bones.
+ * Assumes center point (pelvis) is at X=0.
+ *
+ * @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS
+ * @param shoulderWidth - Fighter's shoulder width in centimeters
+ * @returns Object with leftFootX (negative) and rightFootX (positive) positions
+ *
+ * @example
+ * // Jin Thunder stance (2.0x) for Musa (46cm shoulders)
+ * const footPositions = calculateFootPositions(2.0, 46);
+ * // Returns: { leftFootX: -0.46, rightFootX: 0.46 }
+ *
+ * @korean 발위치계산
+ */
+export declare function calculateFootPositions(stanceWidthMultiplier: number, shoulderWidth: number): {
+    readonly leftFootX: number;
+    readonly rightFootX: number;
+};
+//# sourceMappingURL=MartialArtsConstants.d.ts.map