blacktrigram 0.7.2

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

@@ -0,0 +1,475 @@
+import { MartialArtsAnimationBuilder, TECHNIQUE_TIMING } from "../builders/MartialArtsAnimationBuilder.js";
+//#region src/systems/animation/catalogs/GrapplingAnimations.ts
+/**
+* Throw - 던지기
+*
+* Hip throw technique from Hapkido and Ssireum.
+* Unbalance and throw opponent over hip.
+*
+* Phases:
+* 1. Entry (진입): Step in and grab
+* 2. Load: Hip under opponent's center
+* 3. Throw (던지기): Hip rotation throws opponent
+* 4. Recovery (복귀): Return to stance
+*
+* @korean 던지기애니메이션
+*/
+var THROW_ANIMATION = MartialArtsAnimationBuilder.create("throw", "던지기").asAttack(.7).throwEntry(.15).hipThrow(.18).throwExecute(.12).recover(.25).build();
+/**
+* Grapple - 관절기
+*
+* Joint lock application from Hapkido.
+* Control and submit opponent through joint manipulation.
+*
+* Phases:
+* 1. Grab (잡기): Secure grip on limb
+* 2. Control: Position for leverage
+* 3. Lock (꺾기): Apply joint pressure
+* 4. Hold/Release: Maintain or release
+*
+* @korean 관절기애니메이션
+*/
+var GRAPPLE_ANIMATION = MartialArtsAnimationBuilder.create("grapple", "관절기").asAttack(.65).wristGrab(.15).jointLock(.25).recover(.25).build();
+/**
+* Counter Attack - 반격
+*
+* Defensive parry followed by immediate counter strike.
+* Fundamental Hapkido and Taekwondo defensive concept.
+*
+* Phases:
+* 1. Parry (막기): Deflect incoming attack
+* 2. Counter (반격): Immediate return strike
+* 3. Recovery (복귀): Return to guard
+*
+* @korean 반격애니메이션
+*/
+var COUNTER_ATTACK_ANIMATION = MartialArtsAnimationBuilder.create("counter_attack", "반격").asAttack(.45).parry(.12).punchExtend(.13).recover(.2).build();
+/**
+* Block - 막기 (Rigid High Block - Traditional Taekwondo Style)
+*
+* Defensive blocking technique with rigid, forceful blocking motion.
+* Strong high block (상단막기) with chambered arm position.
+* Contrasts with flowing/yielding styles - this is direct force against force.
+*
+* Korean Martial Arts: 막기 (Mak-gi) - "to block/prevent"
+* - Strong chambering from hip (허리에서)
+* - Explosive upward motion (폭발적 상향)
+* - Solid contact intercept (강한 차단)
+* - Firm guard position maintained (견고한 방어 자세)
+*
+* @korean 막기애니메이션
+*/
+var BLOCK_ANIMATION = MartialArtsAnimationBuilder.create("block", "막기").asDefense(TECHNIQUE_TIMING.FAST.total).withHighGuard().parry(TECHNIQUE_TIMING.FAST.chamber, "ease-out").parry(TECHNIQUE_TIMING.FAST.extend, "linear").recover(TECHNIQUE_TIMING.FAST.peak + TECHNIQUE_TIMING.FAST.retract + TECHNIQUE_TIMING.FAST.recover).build();
+/**
+* Wrist Lock - 손목꺾기 (Sonmok-kkeokgi) - Hapkido Joint Lock
+*
+* **Authentic Hapkido Wrist Joint Manipulation Technique**
+*
+* Fundamental Hapkido joint lock controlling opponent through rotational pressure
+* on the wrist joint. The small joints of the wrist are manipulated through circular
+* motion (원 - Won) to create pain compliance and control. One of the signature
+* techniques that defines Hapkido's approach to joint manipulation.
+*
+* **Korean Martial Arts Biomechanics**:
+* - **Secure Grip (확실한 잡기)**: Two-handed control of opponent's wrist
+* - **Circular Motion (원형 움직임)**: Small circle technique (소원법)
+* - **Wrist Rotation (손목 회전)**: Twist wrist beyond natural range of motion
+* - **Hip Power (골반 힘)**: Hip rotation amplifies wrist twist
+* - **Body Drop (몸 낮춤)**: Lower body position adds downward pressure
+* - **Hyperextension (과신전)**: Wrist bent backward to anatomical limit (70°)
+*
+* **Hapkido Principles Applied**:
+* - **원 (Won - Circle)**: Circular wrist manipulation, not linear force
+* - **유 (Yu - Flow)**: Flowing control without jerky motions
+* - **화 (Hwa - Harmony)**: Blending with opponent's resistance
+*
+* **Anatomical Targets**:
+* - Wrist joint (radiocarpal joint)
+* - Forearm tendons and ligaments
+* - Median nerve compression
+* - Elbow joint (secondary control)
+*
+* **Pain Compliance Mechanism**:
+* - Hyperextension beyond 70° causes acute pain
+* - Continued pressure risks ligament damage
+* - Opponent must comply or risk wrist injury
+* - Can escalate to arm bar if opponent resists
+*
+* **Combat Applications**:
+* - Grab defense (opponent grabs your wrist, you counter)
+* - Control technique for restraining without striking
+* - Transitioning to throw or takedown
+* - Police/security restraint technique
+* - Self-defense against larger opponents (uses leverage, not strength)
+*
+* **Technical Keys**:
+* - Two hands control one wrist (2-on-1 principle)
+* - Circular motion is key (not straight twist)
+* - Hip rotation provides power, not arm strength
+* - Opponent's elbow must be straight for maximum effect
+* - Maintain control throughout - no gaps
+*
+* Phases:
+* 1. Grab (잡기): 150ms - Secure firm grip on opponent's wrist with both hands
+* 2. Position (위치): 100ms - Position opponent's arm for control
+* 3. Twist (꺾기): 200ms - Apply circular rotational pressure to wrist
+* 4. Control (제어): 120ms - Hold pressure, opponent's wrist hyperextended
+* 5. Release (복귀): 180ms - Controlled release or transition to next technique
+*
+* Duration: 750ms (Controlled joint manipulation takes time)
+*
+* @korean 손목꺾기애니메이션
+*/
+var WRIST_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("wrist_lock", "손목꺾기").asAttack(.75).wristGrab(.15).wristGrab(.1).wristTwist(.2).wristTwist(.12).recover(.18).build();
+/**
+* Small Circle Lock - 소원꺾기
+*
+* Tae (Lake) Trigram signature technique.
+* Using minimal circular motion to lock joint.
+*
+* @korean 소원꺾기애니메이션
+*/
+var SMALL_CIRCLE_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("small_circle_lock", "소원꺾기").asAttack(.55).wristGrab(.12).wristTwist(.1).jointLock(.15).recover(.18).build();
+/**
+* Finger Lock - 손가락꺾기
+*
+* Manipulating individual digits for pain compliance.
+*
+* @korean 손가락꺾기애니메이션
+*/
+var FINGER_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("finger_lock", "손가락꺾기").asAttack(.5).wristGrab(.1).fingerLockTwist(.15).recover(.25).build();
+/**
+* Elbow Lock - 팔꿈치꺾기
+*
+* Hyperextending the elbow joint (Armbar variation).
+*
+* @korean 팔꿈치꺾기애니메이션
+*/
+var ELBOW_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("elbow_lock", "팔꿈치꺾기").asAttack(.65).wristGrab(.15).elbowLockApply(.3).recover(.2).build();
+/**
+* Shoulder Manipulation - 어깨비틀기
+*
+* Rotational torque on shoulder joint.
+*
+* @korean 어깨비틀기애니메이션
+*/
+var SHOULDER_MANIPULATION_ANIMATION = MartialArtsAnimationBuilder.create("shoulder_manipulation", "어깨비틀기").asAttack(.7).wristGrab(.2).shoulderLockTwist(.3).recover(.2).build();
+/**
+* Flowing Arm Bar - 유수팔꺾기
+*
+* Fluid transition into arm bar from movement.
+*
+* @korean 유수팔꺾기애니메이션
+*/
+var FLOWING_ARM_BAR_ANIMATION = MartialArtsAnimationBuilder.create("flowing_arm_bar", "유수팔꺾기").asAttack(.75).parry(.15).armBarEntry(.15).armBarDrop(.25).recover(.2).build();
+/**
+* Joint Lock Defense - 관절기방어
+*
+* Escaping or countering a joint lock.
+*
+* @korean 관절기방어애니메이션
+*/
+var JOINT_LOCK_DEFENSE_ANIMATION = MartialArtsAnimationBuilder.create("joint_lock_defense", "관절기방어").asDefense(.5).parry(.1).wristTwist(.2).recover(.2).build();
+/**
+* Sweep Defense - 걸기방어
+*
+* Avoiding or countering a low sweep.
+*
+* @korean 걸기방어애니메이션
+*/
+var SWEEP_DEFENSE_ANIMATION = MartialArtsAnimationBuilder.create("sweep_defense", "걸기방어").asDefense(.45).recover(.15).parry(.1).recover(.2).build();
+/**
+* Mountain Lock - 산형굳히기 (Gan Trigram)
+* Immovable hold.
+*
+* @korean 산형굳히기애니메이션
+*/
+var MOUNTAIN_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("mountain_lock", "산형굳히기").asAttack(.8).clinchGrab(.2).jointLock(.4).recover(.2).build();
+/**
+* Earth Embrace - 대지포옹 (Gon Trigram)
+* Ground control technique.
+*
+* @korean 대지포옹애니메이션
+*/
+var EARTH_EMBRACE_ANIMATION = MartialArtsAnimationBuilder.create("earth_embrace", "대지포옹").asAttack(.9).takedownShoot(.25).takedownDump(.35).groundMount(.3).build();
+/**
+* Carotid Choke - 경동맥조르기 (Dark Ops)
+* Blood choke.
+*
+* @korean 경동맥조르기애니메이션
+*/
+var CAROTID_CHOKE_ANIMATION = MartialArtsAnimationBuilder.create("carotid_choke", "경동맥조르기").asAttack(1).clinchGrab(.2).chokeGrip(.6).recover(.2).build();
+/**
+* Rear Naked Choke - 뒤조르기 (Dark Ops)
+* Traditional mata leao.
+*
+* @korean 뒤조르기애니메이션
+*/
+var REAR_NAKED_CHOKE_ANIMATION = MartialArtsAnimationBuilder.create("rear_naked_choke", "뒤조르기").asAttack(1.2).clinchGrab(.3).chokeGrip(.7).recover(.2).build();
+/**
+* Redirect Throw - 유수던지기 (Gam Trigram)
+* Using opponent momentum.
+*
+* @korean 유수던지기애니메이션
+*/
+var REDIRECT_THROW_ANIMATION = MartialArtsAnimationBuilder.create("redirect_throw", "유수던지기").asAttack(.7).parry(.15).hipThrow(.2).throwExecute(.15).recover(.2).build();
+/**
+* Arm Bar - 팔꺾기 (Pal-kkeok-gi) - Direct Force Hapkido Arm Bar
+*
+* **Authentic Hapkido Straight Arm Hyperextension Lock**
+*
+* Straight arm hyperextension lock with direct downward force. Traditional Hapkido
+* style emphasizing immediate control, explosive entry, and strong submission pressure.
+* The arm bar (Juji-Gatame in Judo, Pal-kkeok-gi in Hapkido) is one of the most
+* effective joint locks, attacking the elbow joint's natural range of motion.
+*
+* Contrasts with Tae (Lake) Trigram flowing circular technique:
+* - **Tae Style**: Circular, flowing, uses momentum and small circles
+* - **This Style**: Linear, forceful, direct pressure and immediate submission
+*
+* **Korean Martial Arts Biomechanics**:
+* - **Quick Entry (빠른진입)**: Explosive arm capture with strong grip
+* - **Linear Pressure (직선압박)**: Straight downward force on elbow
+* - **Immediate Control (즉각제압)**: No circular motion, direct submission
+* - **Hip Pressure (골반 압박)**: Hips thrust upward against elbow joint
+* - **Two-on-One Control (2대1 제어)**: Both hands control one arm
+* - **Body Weight (체중 이용)**: Full body weight applied to hyperextension
+*
+* **Anatomical Mechanics**:
+* - Elbow joint bends ~145° naturally (flexion)
+* - Hyperextension beyond 0° (straight) causes pain
+* - 10-15° hyperextension forces tap or break
+* - Ligaments (UCL, RCL) stressed beyond limits
+* - Can cause permanent elbow damage if held too long
+*
+* **Hapkido Principles Applied**:
+* - **강 (Gang - Strength)**: Direct force application (not flowing)
+* - **속 (Sok - Speed)**: Explosive entry prevents escape
+* - **제 (Je - Control)**: Complete arm control throughout
+*
+* **Submission Mechanism**:
+* - Opponent's arm extended and isolated
+* - Elbow joint hyperextended beyond natural range
+* - Extreme pain forces tap or risks elbow break
+* - No escape once position secured
+*
+* **Combat Applications**:
+* - Ground fighting dominant position
+* - Standing arm bar from wrist control
+* - Counter to opponent's punch (catch and arm bar)
+* - Submission finish after throw
+* - Police/security restraint and arrest technique
+*
+* **Technical Requirements**:
+* - Opponent's arm must be straight (can't bend elbow to escape)
+* - Thumb points up (prevents rotation escape)
+* - Hips positioned tight against elbow joint
+* - Legs pinch opponent's body for control
+* - Body leans back to add pressure
+*
+* Phases:
+* 1. Entry (진입): 150ms - Quick explosive catch of opponent's arm
+* 2. Position (위치 설정): 180ms - Direct downward drop, secure arm
+* 3. Drop (내려가기): 250ms - Body drops to ground, arm isolated
+* 4. Extension (확장): 150ms - Immediate hyperextension with hip pressure
+* 5. Submission (굴복): 100ms - Maximum pressure, opponent must tap
+* 6. Release (복귀): 150ms - Controlled release after submission
+*
+* Duration: 980ms (Full arm bar sequence with control)
+*
+* @korean 팔꺾기애니메이션
+*/
+var ARM_BAR_ANIMATION = MartialArtsAnimationBuilder.create("arm_bar", "팔꺾기").asAttack(.98).armBarEntry(.15).armBarEntry(.18).armBarDrop(.25).jointLock(.15).jointLock(.1).recover(.15).build();
+/**
+* Slam - 메치기
+*
+* Powerful lift and slam technique.
+* Lifts opponent and drives them into ground.
+*
+* Phases:
+* 1. Entry (진입): Clinch and underhook
+* 2. Lift (들기): Lift opponent
+* 3. Slam (메치기): Drive to ground
+* 4. Recovery (복귀): Return to stance
+*
+* @korean 메치기애니메이션
+*/
+var SLAM_ANIMATION = MartialArtsAnimationBuilder.create("slam", "메치기").asAttack(.85).clinchGrab(.1).slamLift(.25).slamDown(.2).recover(.3).build();
+/**
+* Hip Throw - 허리치기 (Heori Chigi) / 배대되치기 (Baedae-doechigi)
+*
+* **Authentic Hapkido / Judo Hip Throw (O-Goshi / Koshi-Guruma)**
+*
+* Classic hip throw from Hapkido and Judo using hip as fulcrum to project opponent.
+* One of the first throws taught in Hapkido (합기도) and Judo (유도) due to its
+* fundamental mechanics and effectiveness. The hip becomes the pivot point that
+* multiplies force, allowing smaller practitioners to throw larger opponents.
+*
+* **Korean Martial Arts Biomechanics**:
+* - **Deep Entry (깊은 진입)**: Step in front of opponent, hip lower than theirs
+* - **Arm Control (팔 제어)**: One arm controls opponent's arm, other wraps body
+* - **Hip Position (골반 위치)**: Hip positioned under opponent's center of mass
+* - **Hip Rotation (골반 회전)**: Explosive hip rotation lifts and throws
+* - **Forward Lean (앞으로 숙임)**: Upper body leans forward for leverage
+* - **Leg Drive (다리 힘)**: Legs extend to add upward lift force
+*
+* **Hapkido Principles Applied**:
+* - **원 (Won - Circle)**: Circular motion redirects opponent's force
+* - **유 (Yu - Flow)**: Blend with opponent's movement
+* - **화 (Hwa - Harmony)**: Use opponent's energy against them
+*
+* **Target Application**:
+* - Opponent pushed to ground on back/side (hard impact)
+* - Sets up ground control or follow-up strikes
+* - Can be done with or without gi/jacket grip
+*
+* **Combat Applications**:
+* - Close-range when opponent pushes forward
+* - Counter to straight punches (step in and throw)
+* - Setting up ground and pound position
+* - Creating distance by throwing opponent away
+* - Self-defense against larger/stronger attackers
+*
+* **Variations**:
+* - O-Goshi (Major Hip Throw): Arm under opponent's armpit
+* - Koshi-Guruma (Hip Wheel): Arm around opponent's neck
+* - Harai-Goshi (Sweeping Hip): Leg sweeps during throw
+*
+* Phases:
+* 1. Entry (진입): 200ms - Step deep in front of opponent, lower hips
+* 2. Grip & Position (잡기 및 위치): 150ms - Secure control, hip under center mass
+* 3. Rotation (회전): 220ms - Explosive hip rotation lifts opponent
+* 4. Projection (던지기): 120ms - Opponent leaves feet, airborne
+* 5. Follow-Through (완료): 100ms - Complete rotation and release
+* 6. Recovery (복귀): 180ms - Return to standing or ground position
+*
+* Duration: 970ms (Long duration for full throw sequence)
+*
+* @korean 허리치기애니메이션
+*/
+var HIP_THROW_ANIMATION = MartialArtsAnimationBuilder.create("hip_throw", "허리치기").asAttack(.97).throwEntry(.2).throwEntry(.15).hipThrow(.22).hipThrow(.12).throwExecute(.1).recover(.18).build();
+/**
+* Leg Reap - 다리걸기
+*
+* Reap opponent's leg while pushing.
+* Opponent falls backward.
+*
+* @korean 다리걸기애니메이션
+*/
+var LEG_REAP_ANIMATION = MartialArtsAnimationBuilder.create("leg_reap", "다리걸기").asAttack(.55).clinchGrab(.12).sweep(.18).recover(.25).build();
+/**
+* Shoulder Lock - 어깨꺾기
+*
+* Rotational pressure on shoulder joint.
+* Standing or ground submission.
+*
+* @korean 어깨꺾기애니메이션
+*/
+var SHOULDER_LOCK_ANIMATION = MartialArtsAnimationBuilder.create("shoulder_lock", "어깨꺾기").asAttack(.65).wristGrab(.15).shoulderLockTwist(.25).recover(.25).build();
+/**
+* Counter Strike - 반격타격
+*
+* Defensive parry followed by powerful counter.
+* More aggressive than standard counter attack.
+*
+* @korean 반격타격애니메이션
+*/
+var COUNTER_STRIKE_ANIMATION = MartialArtsAnimationBuilder.create("counter_strike", "반격타격").asAttack(.5).counterParry(.1).counterStrike(.15).recover(.25).build();
+/**
+* Parry Counter - 막기반격
+*
+* High block followed by immediate counter strike.
+*
+* @korean 막기반격애니메이션
+*/
+var PARRY_COUNTER_ANIMATION = MartialArtsAnimationBuilder.create("parry_counter", "막기반격").asAttack(.48).parry(.12).punchExtend(.14).recover(.22).build();
+/**
+* Double Knee - 더블무릎
+*
+* Two rapid knee strikes from clinch.
+*
+* @korean 더블무릎애니메이션
+*/
+var DOUBLE_KNEE_ANIMATION = MartialArtsAnimationBuilder.create("double_knee", "더블무릎").asAttack(.6).clinchGrab(.1).kneeStrike(.12).kneeStrike(.15).recover(.23).build();
+/**
+* Suplex - 수플렉스
+*
+* Grab and throw opponent backward.
+* High-impact wrestling technique.
+*
+* @korean 수플렉스애니메이션
+*/
+var SUPLEX_ANIMATION = MartialArtsAnimationBuilder.create("suplex", "수플렉스").asAttack(.8).clinchGrab(.15).slamLift(.25).slamDown(.2).recover(.2).build();
+/**
+* High Block - 상단막기
+*
+* High defensive block against head attacks.
+*
+* @korean 상단막기애니메이션
+*/
+var HIGH_BLOCK_ANIMATION = MartialArtsAnimationBuilder.create("block_high", "상단막기").asDefense(TECHNIQUE_TIMING.FAST.total).withHighGuard().blockHigh(TECHNIQUE_TIMING.FAST.chamber + TECHNIQUE_TIMING.FAST.extend).recover(TECHNIQUE_TIMING.FAST.peak + TECHNIQUE_TIMING.FAST.retract + TECHNIQUE_TIMING.FAST.recover).build();
+/**
+* Low Block - 하단막기
+*
+* Low defensive block against leg attacks.
+*
+* @korean 하단막기애니메이션
+*/
+var LOW_BLOCK_ANIMATION = MartialArtsAnimationBuilder.create("block_low", "하단막기").asDefense(TECHNIQUE_TIMING.FAST.total).blockLow(TECHNIQUE_TIMING.FAST.chamber + TECHNIQUE_TIMING.FAST.extend).recover(TECHNIQUE_TIMING.FAST.peak + TECHNIQUE_TIMING.FAST.retract + TECHNIQUE_TIMING.FAST.recover).build();
+/**
+* Takedown - 테이크다운
+*
+* Wrestling-style double leg takedown.
+* Shoot for legs and drive through.
+*
+* @korean 테이크다운애니메이션
+*/
+var TAKEDOWN_ANIMATION = MartialArtsAnimationBuilder.create("takedown", "테이크다운").asAttack(.65).takedownShoot(.2).takedownDump(.2).recover(.25).build();
+/**
+* Body Lock Throw - 바디락던지기
+*
+* Grab body and throw using leverage.
+*
+* @korean 바디락던지기애니메이션
+*/
+var BODY_LOCK_THROW_ANIMATION = MartialArtsAnimationBuilder.create("body_lock_throw", "바디락던지기").asAttack(.7).clinchGrab(.15).throwEntry(.15).throwExecute(.2).recover(.2).build();
+/**
+* Map of all grappling animations for easy access
+* 잡기 애니메이션 맵
+*/
+var GRAPPLING_ANIMATIONS = new Map([
+	["throw", THROW_ANIMATION],
+	["grapple", GRAPPLE_ANIMATION],
+	["counter_attack", COUNTER_ATTACK_ANIMATION],
+	["block", BLOCK_ANIMATION],
+	["wrist_lock", WRIST_LOCK_ANIMATION],
+	["arm_bar", ARM_BAR_ANIMATION],
+	["slam", SLAM_ANIMATION],
+	["hip_throw", HIP_THROW_ANIMATION],
+	["leg_reap", LEG_REAP_ANIMATION],
+	["shoulder_lock", SHOULDER_LOCK_ANIMATION],
+	["counter_strike", COUNTER_STRIKE_ANIMATION],
+	["parry_counter", PARRY_COUNTER_ANIMATION],
+	["double_knee", DOUBLE_KNEE_ANIMATION],
+	["suplex", SUPLEX_ANIMATION],
+	["block_high", HIGH_BLOCK_ANIMATION],
+	["block_low", LOW_BLOCK_ANIMATION],
+	["takedown", TAKEDOWN_ANIMATION],
+	["body_lock_throw", BODY_LOCK_THROW_ANIMATION],
+	["small_circle_lock", SMALL_CIRCLE_LOCK_ANIMATION],
+	["finger_lock", FINGER_LOCK_ANIMATION],
+	["elbow_lock", ELBOW_LOCK_ANIMATION],
+	["shoulder_manipulation", SHOULDER_MANIPULATION_ANIMATION],
+	["flowing_arm_bar", FLOWING_ARM_BAR_ANIMATION],
+	["joint_lock_defense", JOINT_LOCK_DEFENSE_ANIMATION],
+	["sweep_defense", SWEEP_DEFENSE_ANIMATION],
+	["mountain_lock", MOUNTAIN_LOCK_ANIMATION],
+	["earth_embrace", EARTH_EMBRACE_ANIMATION],
+	["carotid_choke", CAROTID_CHOKE_ANIMATION],
+	["rear_naked_choke", REAR_NAKED_CHOKE_ANIMATION],
+	["redirect_throw", REDIRECT_THROW_ANIMATION]
+]);
+//#endregion
+export { ARM_BAR_ANIMATION, BLOCK_ANIMATION, BODY_LOCK_THROW_ANIMATION, CAROTID_CHOKE_ANIMATION, COUNTER_ATTACK_ANIMATION, COUNTER_STRIKE_ANIMATION, DOUBLE_KNEE_ANIMATION, EARTH_EMBRACE_ANIMATION, ELBOW_LOCK_ANIMATION, FINGER_LOCK_ANIMATION, FLOWING_ARM_BAR_ANIMATION, GRAPPLE_ANIMATION, GRAPPLING_ANIMATIONS, HIGH_BLOCK_ANIMATION, HIP_THROW_ANIMATION, JOINT_LOCK_DEFENSE_ANIMATION, LEG_REAP_ANIMATION, LOW_BLOCK_ANIMATION, MOUNTAIN_LOCK_ANIMATION, PARRY_COUNTER_ANIMATION, REAR_NAKED_CHOKE_ANIMATION, REDIRECT_THROW_ANIMATION, SHOULDER_LOCK_ANIMATION, SHOULDER_MANIPULATION_ANIMATION, SLAM_ANIMATION, SMALL_CIRCLE_LOCK_ANIMATION, SUPLEX_ANIMATION, SWEEP_DEFENSE_ANIMATION, TAKEDOWN_ANIMATION, THROW_ANIMATION, WRIST_LOCK_ANIMATION };
+
+//# sourceMappingURL=GrapplingAnimations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrapplingAnimations.js","names":[],"sources":["../../../../src/systems/animation/catalogs/GrapplingAnimations.ts"],"sourcesContent":["/**\n * Grappling Animations Module\n *\n * Throw (던지기), lock (관절기), and grappling animations for Korean martial arts.\n * Features Hapkido and Ssireum techniques.\n * Uses MartialArtsAnimationBuilder for readable, martial arts expert-friendly code.\n *\n * 한국 무술 잡기 애니메이션 모듈\n *\n * @module systems/animation/GrapplingAnimations\n * @korean 잡기애니메이션\n */\n\nimport type { SkeletalAnimation } from \"@/types/skeletal\";\nimport {\n  MartialArtsAnimationBuilder,\n  TECHNIQUE_TIMING,\n} from \"../builders/MartialArtsAnimationBuilder\";\n\n// ═══════════════════════════════════════════════════════════════════════════\n// THROW (던지기) - Hip Throw\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Throw - 던지기\n *\n * Hip throw technique from Hapkido and Ssireum.\n * Unbalance and throw opponent over hip.\n *\n * Phases:\n * 1. Entry (진입): Step in and grab\n * 2. Load: Hip under opponent's center\n * 3. Throw (던지기): Hip rotation throws opponent\n * 4. Recovery (복귀): Return to stance\n *\n * @korean 던지기애니메이션\n */\nexport const THROW_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"throw\", \"던지기\")\n    .asAttack(0.7)\n    .throwEntry(0.15) // 진입 - Entry and grab\n    .hipThrow(0.18) // 던지기 - Load hip under opponent\n    .throwExecute(0.12) // 투척 - Project opponent over hip\n    .recover(0.25) // 복귀\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// GRAPPLE (관절기) - Joint Lock\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Grapple - 관절기\n *\n * Joint lock application from Hapkido.\n * Control and submit opponent through joint manipulation.\n *\n * Phases:\n * 1. Grab (잡기): Secure grip on limb\n * 2. Control: Position for leverage\n * 3. Lock (꺾기): Apply joint pressure\n * 4. Hold/Release: Maintain or release\n *\n * @korean 관절기애니메이션\n */\nexport const GRAPPLE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"grapple\", \"관절기\")\n    .asAttack(0.65)\n    .wristGrab(0.15) // 잡기 - Seize limb\n    .jointLock(0.25) // 꺾기 - Apply lock\n    .recover(0.25) // Release/reset\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// COUNTER ATTACK (반격) - Defensive Counter\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Counter Attack - 반격\n *\n * Defensive parry followed by immediate counter strike.\n * Fundamental Hapkido and Taekwondo defensive concept.\n *\n * Phases:\n * 1. Parry (막기): Deflect incoming attack\n * 2. Counter (반격): Immediate return strike\n * 3. Recovery (복귀): Return to guard\n *\n * @korean 반격애니메이션\n */\nexport const COUNTER_ATTACK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"counter_attack\", \"반격\")\n    .asAttack(0.45)\n    .parry(0.12) // 막기 - Deflect\n    .punchExtend(0.13) // 반격 - Counter strike\n    .recover(0.2) // 복귀\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// BLOCK (막기) - Defensive Block\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Block - 막기 (Rigid High Block - Traditional Taekwondo Style)\n *\n * Defensive blocking technique with rigid, forceful blocking motion.\n * Strong high block (상단막기) with chambered arm position.\n * Contrasts with flowing/yielding styles - this is direct force against force.\n *\n * Korean Martial Arts: 막기 (Mak-gi) - \"to block/prevent\"\n * - Strong chambering from hip (허리에서)\n * - Explosive upward motion (폭발적 상향)\n * - Solid contact intercept (강한 차단)\n * - Firm guard position maintained (견고한 방어 자세)\n *\n * @korean 막기애니메이션\n */\nexport const BLOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"block\", \"막기\")\n    .asDefense(TECHNIQUE_TIMING.FAST.total)\n    .withHighGuard() // Start from high guard position\n    .parry(TECHNIQUE_TIMING.FAST.chamber, \"ease-out\") // Explosive upward block\n    .parry(TECHNIQUE_TIMING.FAST.extend, \"linear\") // Hold firm blocking position\n    .recover(\n      TECHNIQUE_TIMING.FAST.peak +\n        TECHNIQUE_TIMING.FAST.retract +\n        TECHNIQUE_TIMING.FAST.recover,\n    ) // 복귀 - Return to guard\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// WRIST LOCK (손목꺾기) - Hapkido Joint Lock\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Wrist Lock - 손목꺾기 (Sonmok-kkeokgi) - Hapkido Joint Lock\n *\n * **Authentic Hapkido Wrist Joint Manipulation Technique**\n *\n * Fundamental Hapkido joint lock controlling opponent through rotational pressure\n * on the wrist joint. The small joints of the wrist are manipulated through circular\n * motion (원 - Won) to create pain compliance and control. One of the signature\n * techniques that defines Hapkido's approach to joint manipulation.\n *\n * **Korean Martial Arts Biomechanics**:\n * - **Secure Grip (확실한 잡기)**: Two-handed control of opponent's wrist\n * - **Circular Motion (원형 움직임)**: Small circle technique (소원법)\n * - **Wrist Rotation (손목 회전)**: Twist wrist beyond natural range of motion\n * - **Hip Power (골반 힘)**: Hip rotation amplifies wrist twist\n * - **Body Drop (몸 낮춤)**: Lower body position adds downward pressure\n * - **Hyperextension (과신전)**: Wrist bent backward to anatomical limit (70°)\n *\n * **Hapkido Principles Applied**:\n * - **원 (Won - Circle)**: Circular wrist manipulation, not linear force\n * - **유 (Yu - Flow)**: Flowing control without jerky motions\n * - **화 (Hwa - Harmony)**: Blending with opponent's resistance\n *\n * **Anatomical Targets**:\n * - Wrist joint (radiocarpal joint)\n * - Forearm tendons and ligaments\n * - Median nerve compression\n * - Elbow joint (secondary control)\n *\n * **Pain Compliance Mechanism**:\n * - Hyperextension beyond 70° causes acute pain\n * - Continued pressure risks ligament damage\n * - Opponent must comply or risk wrist injury\n * - Can escalate to arm bar if opponent resists\n *\n * **Combat Applications**:\n * - Grab defense (opponent grabs your wrist, you counter)\n * - Control technique for restraining without striking\n * - Transitioning to throw or takedown\n * - Police/security restraint technique\n * - Self-defense against larger opponents (uses leverage, not strength)\n *\n * **Technical Keys**:\n * - Two hands control one wrist (2-on-1 principle)\n * - Circular motion is key (not straight twist)\n * - Hip rotation provides power, not arm strength\n * - Opponent's elbow must be straight for maximum effect\n * - Maintain control throughout - no gaps\n *\n * Phases:\n * 1. Grab (잡기): 150ms - Secure firm grip on opponent's wrist with both hands\n * 2. Position (위치): 100ms - Position opponent's arm for control\n * 3. Twist (꺾기): 200ms - Apply circular rotational pressure to wrist\n * 4. Control (제어): 120ms - Hold pressure, opponent's wrist hyperextended\n * 5. Release (복귀): 180ms - Controlled release or transition to next technique\n *\n * Duration: 750ms (Controlled joint manipulation takes time)\n *\n * @korean 손목꺾기애니메이션\n */\nexport const WRIST_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"wrist_lock\", \"손목꺾기\")\n    .asAttack(0.75)\n    .wristGrab(0.15) // 잡기 - Secure two-handed grip on wrist\n    .wristGrab(0.1) // 위치 - Position arm for control\n    .wristTwist(0.2) // 꺾기 - Apply circular rotational pressure\n    .wristTwist(0.12) // 제어 - Hold at hyperextension\n    .recover(0.18) // 복귀 - Controlled release\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// NEW TAE (LAKE) TRIGRAM JOINT LOCKS (새로운 태괘 관절기)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Small Circle Lock - 소원꺾기\n *\n * Tae (Lake) Trigram signature technique.\n * Using minimal circular motion to lock joint.\n *\n * @korean 소원꺾기애니메이션\n */\nexport const SMALL_CIRCLE_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"small_circle_lock\", \"소원꺾기\")\n    .asAttack(0.55)\n    .wristGrab(0.12) // 잡기 - Quick grab\n    .wristTwist(0.1) // 꺾기 - Small circle twist\n    .jointLock(0.15) // 제압 - Lock\n    .recover(0.18) // 복귀\n    .build();\n\n/**\n * Finger Lock - 손가락꺾기\n *\n * Manipulating individual digits for pain compliance.\n *\n * @korean 손가락꺾기애니메이션\n */\nexport const FINGER_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"finger_lock\", \"손가락꺾기\")\n    .asAttack(0.5)\n    .wristGrab(0.1) // 잡기 - Grab fingers\n    .fingerLockTwist(0.15) // 꺺기 - Hyper-extend fingers\n    .recover(0.25) // 복귀\n    .build();\n\n/**\n * Elbow Lock - 팔꿈치꺾기\n *\n * Hyperextending the elbow joint (Armbar variation).\n *\n * @korean 팔꿈치꺾기애니메이션\n */\nexport const ELBOW_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"elbow_lock\", \"팔꿈치꺾기\")\n    .asAttack(0.65)\n    .wristGrab(0.15) // 잡기 - Seize arm\n    .elbowLockApply(0.3) // 꺺기 - Apply elbow hyperextension\n    .recover(0.2) // 복귀\n    .build();\n\n/**\n * Shoulder Manipulation - 어깨비틀기\n *\n * Rotational torque on shoulder joint.\n *\n * @korean 어깨비틀기애니메이션\n */\nexport const SHOULDER_MANIPULATION_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"shoulder_manipulation\", \"어깨비틀기\")\n    .asAttack(0.7)\n    .wristGrab(0.2) // 잡기 - Capture arm\n    .shoulderLockTwist(0.3) // 비틀기 - Shoulder manipulation\n    .recover(0.2) // 복귀\n    .build();\n\n/**\n * Flowing Arm Bar - 유수팔꺾기\n *\n * Fluid transition into arm bar from movement.\n *\n * @korean 유수팔꺾기애니메이션\n */\nexport const FLOWING_ARM_BAR_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"flowing_arm_bar\", \"유수팔꺾기\")\n    .asAttack(0.75)\n    .parry(0.15) // 막기 - Flow with attack\n    .armBarEntry(0.15) // 진입 - Catch arm\n    .armBarDrop(0.25) // 내려가기 - Drop to arm bar position\n    .recover(0.2) // 복귀\n    .build();\n\n/**\n * Joint Lock Defense - 관절기방어\n *\n * Escaping or countering a joint lock.\n *\n * @korean 관절기방어애니메이션\n */\nexport const JOINT_LOCK_DEFENSE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"joint_lock_defense\", \"관절기방어\")\n    .asDefense(0.5)\n    .parry(0.1) // 틈파기 - Create space\n    .wristTwist(0.2) // 빼기 - Rotate out\n    .recover(0.2) // 복귀\n    .build();\n\n/**\n * Sweep Defense - 걸기방어\n *\n * Avoiding or countering a low sweep.\n *\n * @korean 걸기방어애니메이션\n */\nexport const SWEEP_DEFENSE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"sweep_defense\", \"걸기방어\")\n    .asDefense(0.45)\n    .recover(0.15) // 들어올리기 - Lift leg\n    .parry(0.1) // 피하기 - Avoid\n    .recover(0.2) // 착지 - Land\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// NEW GROUND/CHOKE TECHNIQUES (새로운 그라운드/조르기 기법)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Mountain Lock - 산형굳히기 (Gan Trigram)\n * Immovable hold.\n *\n * @korean 산형굳히기애니메이션\n */\nexport const MOUNTAIN_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"mountain_lock\", \"산형굳히기\")\n    .asAttack(0.8)\n    .clinchGrab(0.2) // 잡기 - Establish grip control\n    .jointLock(0.4) // Long hold pressure\n    .recover(0.2)\n    .build();\n\n/**\n * Earth Embrace - 대지포옹 (Gon Trigram)\n * Ground control technique.\n *\n * @korean 대지포옹애니메이션\n */\nexport const EARTH_EMBRACE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"earth_embrace\", \"대지포옹\")\n    .asAttack(0.9)\n    .takedownShoot(0.25) // Shoot for takedown\n    .takedownDump(0.35) // Take down\n    .groundMount(0.3) // Control on ground\n    .build();\n\n/**\n * Carotid Choke - 경동맥조르기 (Dark Ops)\n * Blood choke.\n *\n * @korean 경동맥조르기애니메이션\n */\nexport const CAROTID_CHOKE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"carotid_choke\", \"경동맥조르기\")\n    .asAttack(1.0)\n    .clinchGrab(0.2) // 뒤잡기 - Establish rear control\n    .chokeGrip(0.6) // Apply carotid squeeze\n    .recover(0.2)\n    .build();\n\n/**\n * Rear Naked Choke - 뒤조르기 (Dark Ops)\n * Traditional mata leao.\n *\n * @korean 뒤조르기애니메이션\n */\nexport const REAR_NAKED_CHOKE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"rear_naked_choke\", \"뒤조르기\")\n    .asAttack(1.2)\n    .clinchGrab(0.3) // 뒤잡기 - Get back control\n    .chokeGrip(0.7) // Apply rear naked choke\n    .recover(0.2)\n    .build();\n\n/**\n * Redirect Throw - 유수던지기 (Gam Trigram)\n * Using opponent momentum.\n *\n * @korean 유수던지기애니메이션\n */\nexport const REDIRECT_THROW_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"redirect_throw\", \"유수던지기\")\n    .asAttack(0.7)\n    .parry(0.15) // Flow with attack\n    .hipThrow(0.2) // Redirect momentum into throw\n    .throwExecute(0.15) // 투척 - Complete the projection\n    .recover(0.2)\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// ARM BAR (팔꺾기) - Arm Hyperextension\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Arm Bar - 팔꺾기 (Pal-kkeok-gi) - Direct Force Hapkido Arm Bar\n *\n * **Authentic Hapkido Straight Arm Hyperextension Lock**\n *\n * Straight arm hyperextension lock with direct downward force. Traditional Hapkido\n * style emphasizing immediate control, explosive entry, and strong submission pressure.\n * The arm bar (Juji-Gatame in Judo, Pal-kkeok-gi in Hapkido) is one of the most\n * effective joint locks, attacking the elbow joint's natural range of motion.\n *\n * Contrasts with Tae (Lake) Trigram flowing circular technique:\n * - **Tae Style**: Circular, flowing, uses momentum and small circles\n * - **This Style**: Linear, forceful, direct pressure and immediate submission\n *\n * **Korean Martial Arts Biomechanics**:\n * - **Quick Entry (빠른진입)**: Explosive arm capture with strong grip\n * - **Linear Pressure (직선압박)**: Straight downward force on elbow\n * - **Immediate Control (즉각제압)**: No circular motion, direct submission\n * - **Hip Pressure (골반 압박)**: Hips thrust upward against elbow joint\n * - **Two-on-One Control (2대1 제어)**: Both hands control one arm\n * - **Body Weight (체중 이용)**: Full body weight applied to hyperextension\n *\n * **Anatomical Mechanics**:\n * - Elbow joint bends ~145° naturally (flexion)\n * - Hyperextension beyond 0° (straight) causes pain\n * - 10-15° hyperextension forces tap or break\n * - Ligaments (UCL, RCL) stressed beyond limits\n * - Can cause permanent elbow damage if held too long\n *\n * **Hapkido Principles Applied**:\n * - **강 (Gang - Strength)**: Direct force application (not flowing)\n * - **속 (Sok - Speed)**: Explosive entry prevents escape\n * - **제 (Je - Control)**: Complete arm control throughout\n *\n * **Submission Mechanism**:\n * - Opponent's arm extended and isolated\n * - Elbow joint hyperextended beyond natural range\n * - Extreme pain forces tap or risks elbow break\n * - No escape once position secured\n *\n * **Combat Applications**:\n * - Ground fighting dominant position\n * - Standing arm bar from wrist control\n * - Counter to opponent's punch (catch and arm bar)\n * - Submission finish after throw\n * - Police/security restraint and arrest technique\n *\n * **Technical Requirements**:\n * - Opponent's arm must be straight (can't bend elbow to escape)\n * - Thumb points up (prevents rotation escape)\n * - Hips positioned tight against elbow joint\n * - Legs pinch opponent's body for control\n * - Body leans back to add pressure\n *\n * Phases:\n * 1. Entry (진입): 150ms - Quick explosive catch of opponent's arm\n * 2. Position (위치 설정): 180ms - Direct downward drop, secure arm\n * 3. Drop (내려가기): 250ms - Body drops to ground, arm isolated\n * 4. Extension (확장): 150ms - Immediate hyperextension with hip pressure\n * 5. Submission (굴복): 100ms - Maximum pressure, opponent must tap\n * 6. Release (복귀): 150ms - Controlled release after submission\n *\n * Duration: 980ms (Full arm bar sequence with control)\n *\n * @korean 팔꺾기애니메이션\n */\nexport const ARM_BAR_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"arm_bar\", \"팔꺾기\")\n    .asAttack(0.98)\n    .armBarEntry(0.15) // 진입 - Quick explosive catch (faster than Tae flowing style)\n    .armBarEntry(0.18) // 위치 설정 - Position for downward drop\n    .armBarDrop(0.25) // 내려가기 - Direct downward drop (linear, not circular)\n    .jointLock(0.15) // 확장 - Hyperextension with hip pressure\n    .jointLock(0.1) // 굴복 - Maximum submission pressure\n    .recover(0.15) // 복귀 - Quick controlled release\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// SLAM (메치기) - Powerful Throw Down\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Slam - 메치기\n *\n * Powerful lift and slam technique.\n * Lifts opponent and drives them into ground.\n *\n * Phases:\n * 1. Entry (진입): Clinch and underhook\n * 2. Lift (들기): Lift opponent\n * 3. Slam (메치기): Drive to ground\n * 4. Recovery (복귀): Return to stance\n *\n * @korean 메치기애니메이션\n */\nexport const SLAM_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"slam\", \"메치기\")\n    .asAttack(0.85)\n    .clinchGrab(0.1) // 잡기 - Clinch and underhook\n    .slamLift(0.25) // 들기 - Lift opponent\n    .slamDown(0.2) // 메치기 - Slam down\n    .recover(0.3) // 복귀\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// HIP THROW (허리치기) - Classic Judo/Hapkido Throw\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Hip Throw - 허리치기 (Heori Chigi) / 배대되치기 (Baedae-doechigi)\n *\n * **Authentic Hapkido / Judo Hip Throw (O-Goshi / Koshi-Guruma)**\n *\n * Classic hip throw from Hapkido and Judo using hip as fulcrum to project opponent.\n * One of the first throws taught in Hapkido (합기도) and Judo (유도) due to its\n * fundamental mechanics and effectiveness. The hip becomes the pivot point that\n * multiplies force, allowing smaller practitioners to throw larger opponents.\n *\n * **Korean Martial Arts Biomechanics**:\n * - **Deep Entry (깊은 진입)**: Step in front of opponent, hip lower than theirs\n * - **Arm Control (팔 제어)**: One arm controls opponent's arm, other wraps body\n * - **Hip Position (골반 위치)**: Hip positioned under opponent's center of mass\n * - **Hip Rotation (골반 회전)**: Explosive hip rotation lifts and throws\n * - **Forward Lean (앞으로 숙임)**: Upper body leans forward for leverage\n * - **Leg Drive (다리 힘)**: Legs extend to add upward lift force\n *\n * **Hapkido Principles Applied**:\n * - **원 (Won - Circle)**: Circular motion redirects opponent's force\n * - **유 (Yu - Flow)**: Blend with opponent's movement\n * - **화 (Hwa - Harmony)**: Use opponent's energy against them\n *\n * **Target Application**:\n * - Opponent pushed to ground on back/side (hard impact)\n * - Sets up ground control or follow-up strikes\n * - Can be done with or without gi/jacket grip\n *\n * **Combat Applications**:\n * - Close-range when opponent pushes forward\n * - Counter to straight punches (step in and throw)\n * - Setting up ground and pound position\n * - Creating distance by throwing opponent away\n * - Self-defense against larger/stronger attackers\n *\n * **Variations**:\n * - O-Goshi (Major Hip Throw): Arm under opponent's armpit\n * - Koshi-Guruma (Hip Wheel): Arm around opponent's neck\n * - Harai-Goshi (Sweeping Hip): Leg sweeps during throw\n *\n * Phases:\n * 1. Entry (진입): 200ms - Step deep in front of opponent, lower hips\n * 2. Grip & Position (잡기 및 위치): 150ms - Secure control, hip under center mass\n * 3. Rotation (회전): 220ms - Explosive hip rotation lifts opponent\n * 4. Projection (던지기): 120ms - Opponent leaves feet, airborne\n * 5. Follow-Through (완료): 100ms - Complete rotation and release\n * 6. Recovery (복귀): 180ms - Return to standing or ground position\n *\n * Duration: 970ms (Long duration for full throw sequence)\n *\n * @korean 허리치기애니메이션\n */\nexport const HIP_THROW_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"hip_throw\", \"허리치기\")\n    .asAttack(0.97)\n    .throwEntry(0.2) // 진입 - Deep entry, lower hips\n    .throwEntry(0.15) // 잡기 및 위치 - Secure control and positioning\n    .hipThrow(0.22) // 회전 - Explosive hip rotation lifts opponent\n    .hipThrow(0.12) // 던지기 - Opponent airborne\n    .throwExecute(0.1) // 완료 - Complete rotation\n    .recover(0.18) // 복귀 - Return to standing or ground\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// LEG REAP (다리걸기) - Leg Sweep Takedown\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Leg Reap - 다리걸기\n *\n * Reap opponent's leg while pushing.\n * Opponent falls backward.\n *\n * @korean 다리걸기애니메이션\n */\nexport const LEG_REAP_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"leg_reap\", \"다리걸기\")\n    .asAttack(0.55)\n    .clinchGrab(0.12) // Grab opponent\n    .sweep(0.18) // Reap leg\n    .recover(0.25) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// SHOULDER LOCK (어깨꺾기) - Kimura/Americana\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Shoulder Lock - 어깨꺾기\n *\n * Rotational pressure on shoulder joint.\n * Standing or ground submission.\n *\n * @korean 어깨꺾기애니메이션\n */\nexport const SHOULDER_LOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"shoulder_lock\", \"어깨꺾기\")\n    .asAttack(0.65)\n    .wristGrab(0.15) // Grab arm\n    .shoulderLockTwist(0.25) // Apply shoulder rotation\n    .recover(0.25) // Release\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// COUNTER STRIKE (반격타격) - Parry to Strike\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Counter Strike - 반격타격\n *\n * Defensive parry followed by powerful counter.\n * More aggressive than standard counter attack.\n *\n * @korean 반격타격애니메이션\n */\nexport const COUNTER_STRIKE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"counter_strike\", \"반격타격\")\n    .asAttack(0.5)\n    .counterParry(0.1) // Parry incoming\n    .counterStrike(0.15) // Powerful counter\n    .recover(0.25) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// PARRY COUNTER (막기반격) - Block and Counter\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Parry Counter - 막기반격\n *\n * High block followed by immediate counter strike.\n *\n * @korean 막기반격애니메이션\n */\nexport const PARRY_COUNTER_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"parry_counter\", \"막기반격\")\n    .asAttack(0.48)\n    .parry(0.12) // Block\n    .punchExtend(0.14) // Quick counter\n    .recover(0.22) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// REMOVED - MOVED TO ELBOWKNEEANIMATIONS\n// ═══════════════════════════════════════════════════════════════════════════\n\n// ═══════════════════════════════════════════════════════════════════════════\n// DOUBLE KNEE (더블무릎) - Two Rapid Knee Strikes\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Double Knee - 더블무릎\n *\n * Two rapid knee strikes from clinch.\n *\n * @korean 더블무릎애니메이션\n */\nexport const DOUBLE_KNEE_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"double_knee\", \"더블무릎\")\n    .asAttack(0.6)\n    .clinchGrab(0.1) // Clinch\n    .kneeStrike(0.12) // First knee\n    .kneeStrike(0.15) // Second knee\n    .recover(0.23) // Release\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// SUPLEX (수플렉스) - Backward Throw\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Suplex - 수플렉스\n *\n * Grab and throw opponent backward.\n * High-impact wrestling technique.\n *\n * @korean 수플렉스애니메이션\n */\nexport const SUPLEX_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"suplex\", \"수플렉스\")\n    .asAttack(0.8)\n    .clinchGrab(0.15) // Grab from behind\n    .slamLift(0.25) // Lift and arch\n    .slamDown(0.2) // Slam backward\n    .recover(0.2) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// HIGH BLOCK (상단막기) - Upper Defense\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * High Block - 상단막기\n *\n * High defensive block against head attacks.\n *\n * @korean 상단막기애니메이션\n */\nexport const HIGH_BLOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"block_high\", \"상단막기\")\n    .asDefense(TECHNIQUE_TIMING.FAST.total)\n    .withHighGuard() // High guard position\n    .blockHigh(TECHNIQUE_TIMING.FAST.chamber + TECHNIQUE_TIMING.FAST.extend) // High block technique\n    .recover(\n      TECHNIQUE_TIMING.FAST.peak +\n        TECHNIQUE_TIMING.FAST.retract +\n        TECHNIQUE_TIMING.FAST.recover,\n    ) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// LOW BLOCK (하단막기) - Lower Defense\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Low Block - 하단막기\n *\n * Low defensive block against leg attacks.\n *\n * @korean 하단막기애니메이션\n */\nexport const LOW_BLOCK_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"block_low\", \"하단막기\")\n    .asDefense(TECHNIQUE_TIMING.FAST.total)\n    .blockLow(TECHNIQUE_TIMING.FAST.chamber + TECHNIQUE_TIMING.FAST.extend) // Low block technique\n    .recover(\n      TECHNIQUE_TIMING.FAST.peak +\n        TECHNIQUE_TIMING.FAST.retract +\n        TECHNIQUE_TIMING.FAST.recover,\n    ) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// TAKEDOWN (테이크다운) - Wrestling Takedown\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Takedown - 테이크다운\n *\n * Wrestling-style double leg takedown.\n * Shoot for legs and drive through.\n *\n * @korean 테이크다운애니메이션\n */\nexport const TAKEDOWN_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"takedown\", \"테이크다운\")\n    .asAttack(0.65)\n    .takedownShoot(0.2) // Shoot for legs\n    .takedownDump(0.2) // Drive through and dump\n    .recover(0.25) // Top position\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// BODY LOCK THROW (바디락던지기) - Bear Hug Throw\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Body Lock Throw - 바디락던지기\n *\n * Grab body and throw using leverage.\n *\n * @korean 바디락던지기애니메이션\n */\nexport const BODY_LOCK_THROW_ANIMATION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\"body_lock_throw\", \"바디락던지기\")\n    .asAttack(0.7)\n    .clinchGrab(0.15) // Body lock\n    .throwEntry(0.15) // Position\n    .throwExecute(0.2) // Execute throw\n    .recover(0.2) // Recover\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// EXPORT GRAPPLING ANIMATION MAP\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Map of all grappling animations for easy access\n * 잡기 애니메이션 맵\n */\nexport const GRAPPLING_ANIMATIONS: ReadonlyMap<string, SkeletalAnimation> =\n  new Map([\n    [\"throw\", THROW_ANIMATION],\n    [\"grapple\", GRAPPLE_ANIMATION],\n    [\"counter_attack\", COUNTER_ATTACK_ANIMATION],\n    [\"block\", BLOCK_ANIMATION],\n    [\"wrist_lock\", WRIST_LOCK_ANIMATION],\n    [\"arm_bar\", ARM_BAR_ANIMATION],\n    [\"slam\", SLAM_ANIMATION],\n    [\"hip_throw\", HIP_THROW_ANIMATION],\n    [\"leg_reap\", LEG_REAP_ANIMATION],\n    [\"shoulder_lock\", SHOULDER_LOCK_ANIMATION],\n    [\"counter_strike\", COUNTER_STRIKE_ANIMATION],\n    [\"parry_counter\", PARRY_COUNTER_ANIMATION],\n    // Clinch knee moved to ElbowKneeAnimations\n    [\"double_knee\", DOUBLE_KNEE_ANIMATION],\n    [\"suplex\", SUPLEX_ANIMATION],\n    [\"block_high\", HIGH_BLOCK_ANIMATION],\n    [\"block_low\", LOW_BLOCK_ANIMATION],\n    [\"takedown\", TAKEDOWN_ANIMATION],\n    [\"body_lock_throw\", BODY_LOCK_THROW_ANIMATION],\n    [\"small_circle_lock\", SMALL_CIRCLE_LOCK_ANIMATION],\n    [\"finger_lock\", FINGER_LOCK_ANIMATION],\n    [\"elbow_lock\", ELBOW_LOCK_ANIMATION],\n    [\"shoulder_manipulation\", SHOULDER_MANIPULATION_ANIMATION],\n    [\"flowing_arm_bar\", FLOWING_ARM_BAR_ANIMATION],\n    [\"joint_lock_defense\", JOINT_LOCK_DEFENSE_ANIMATION],\n    [\"sweep_defense\", SWEEP_DEFENSE_ANIMATION],\n    [\"mountain_lock\", MOUNTAIN_LOCK_ANIMATION],\n    [\"earth_embrace\", EARTH_EMBRACE_ANIMATION],\n    [\"carotid_choke\", CAROTID_CHOKE_ANIMATION],\n    [\"rear_naked_choke\", REAR_NAKED_CHOKE_ANIMATION],\n    [\"redirect_throw\", REDIRECT_THROW_ANIMATION],\n  ]);\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,IAAa,kBACX,4BAA4B,OAAO,SAAS,MAAM,CAC/C,SAAS,GAAI,CACb,WAAW,IAAK,CAChB,SAAS,IAAK,CACd,aAAa,IAAK,CAClB,QAAQ,IAAK,CACb,OAAO;;;;;;;;;;;;;;;AAoBZ,IAAa,oBACX,4BAA4B,OAAO,WAAW,MAAM,CACjD,SAAS,IAAK,CACd,UAAU,IAAK,CACf,UAAU,IAAK,CACf,QAAQ,IAAK,CACb,OAAO;;;;;;;;;;;;;;AAmBZ,IAAa,2BACX,4BAA4B,OAAO,kBAAkB,KAAK,CACvD,SAAS,IAAK,CACd,MAAM,IAAK,CACX,YAAY,IAAK,CACjB,QAAQ,GAAI,CACZ,OAAO;;;;;;;;;;;;;;;;AAqBZ,IAAa,kBACX,4BAA4B,OAAO,SAAS,KAAK,CAC9C,UAAU,iBAAiB,KAAK,MAAM,CACtC,eAAe,CACf,MAAM,iBAAiB,KAAK,SAAS,WAAW,CAChD,MAAM,iBAAiB,KAAK,QAAQ,SAAS,CAC7C,QACC,iBAAiB,KAAK,OACpB,iBAAiB,KAAK,UACtB,iBAAiB,KAAK,QACzB,CACA,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEZ,IAAa,uBACX,4BAA4B,OAAO,cAAc,OAAO,CACrD,SAAS,IAAK,CACd,UAAU,IAAK,CACf,UAAU,GAAI,CACd,WAAW,GAAI,CACf,WAAW,IAAK,CAChB,QAAQ,IAAK,CACb,OAAO;;;;;;;;;AAcZ,IAAa,8BACX,4BAA4B,OAAO,qBAAqB,OAAO,CAC5D,SAAS,IAAK,CACd,UAAU,IAAK,CACf,WAAW,GAAI,CACf,UAAU,IAAK,CACf,QAAQ,IAAK,CACb,OAAO;;;;;;;;AASZ,IAAa,wBACX,4BAA4B,OAAO,eAAe,QAAQ,CACvD,SAAS,GAAI,CACb,UAAU,GAAI,CACd,gBAAgB,IAAK,CACrB,QAAQ,IAAK,CACb,OAAO;;;;;;;;AASZ,IAAa,uBACX,4BAA4B,OAAO,cAAc,QAAQ,CACtD,SAAS,IAAK,CACd,UAAU,IAAK,CACf,eAAe,GAAI,CACnB,QAAQ,GAAI,CACZ,OAAO;;;;;;;;AASZ,IAAa,kCACX,4BAA4B,OAAO,yBAAyB,QAAQ,CACjE,SAAS,GAAI,CACb,UAAU,GAAI,CACd,kBAAkB,GAAI,CACtB,QAAQ,GAAI,CACZ,OAAO;;;;;;;;AASZ,IAAa,4BACX,4BAA4B,OAAO,mBAAmB,QAAQ,CAC3D,SAAS,IAAK,CACd,MAAM,IAAK,CACX,YAAY,IAAK,CACjB,WAAW,IAAK,CAChB,QAAQ,GAAI,CACZ,OAAO;;;;;;;;AASZ,IAAa,+BACX,4BAA4B,OAAO,sBAAsB,QAAQ,CAC9D,UAAU,GAAI,CACd,MAAM,GAAI,CACV,WAAW,GAAI,CACf,QAAQ,GAAI,CACZ,OAAO;;;;;;;;AASZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,OAAO,CACxD,UAAU,IAAK,CACf,QAAQ,IAAK,CACb,MAAM,GAAI,CACV,QAAQ,GAAI,CACZ,OAAO;;;;;;;AAYZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,QAAQ,CACzD,SAAS,GAAI,CACb,WAAW,GAAI,CACf,UAAU,GAAI,CACd,QAAQ,GAAI,CACZ,OAAO;;;;;;;AAQZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,OAAO,CACxD,SAAS,GAAI,CACb,cAAc,IAAK,CACnB,aAAa,IAAK,CAClB,YAAY,GAAI,CAChB,OAAO;;;;;;;AAQZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,SAAS,CAC1D,SAAS,EAAI,CACb,WAAW,GAAI,CACf,UAAU,GAAI,CACd,QAAQ,GAAI,CACZ,OAAO;;;;;;;AAQZ,IAAa,6BACX,4BAA4B,OAAO,oBAAoB,OAAO,CAC3D,SAAS,IAAI,CACb,WAAW,GAAI,CACf,UAAU,GAAI,CACd,QAAQ,GAAI,CACZ,OAAO;;;;;;;AAQZ,IAAa,2BACX,4BAA4B,OAAO,kBAAkB,QAAQ,CAC1D,SAAS,GAAI,CACb,MAAM,IAAK,CACX,SAAS,GAAI,CACb,aAAa,IAAK,CAClB,QAAQ,GAAI,CACZ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEZ,IAAa,oBACX,4BAA4B,OAAO,WAAW,MAAM,CACjD,SAAS,IAAK,CACd,YAAY,IAAK,CACjB,YAAY,IAAK,CACjB,WAAW,IAAK,CAChB,UAAU,IAAK,CACf,UAAU,GAAI,CACd,QAAQ,IAAK,CACb,OAAO;;;;;;;;;;;;;;;AAoBZ,IAAa,iBACX,4BAA4B,OAAO,QAAQ,MAAM,CAC9C,SAAS,IAAK,CACd,WAAW,GAAI,CACf,SAAS,IAAK,CACd,SAAS,GAAI,CACb,QAAQ,GAAI,CACZ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DZ,IAAa,sBACX,4BAA4B,OAAO,aAAa,OAAO,CACpD,SAAS,IAAK,CACd,WAAW,GAAI,CACf,WAAW,IAAK,CAChB,SAAS,IAAK,CACd,SAAS,IAAK,CACd,aAAa,GAAI,CACjB,QAAQ,IAAK,CACb,OAAO;;;;;;;;;AAcZ,IAAa,qBACX,4BAA4B,OAAO,YAAY,OAAO,CACnD,SAAS,IAAK,CACd,WAAW,IAAK,CAChB,MAAM,IAAK,CACX,QAAQ,IAAK,CACb,OAAO;;;;;;;;;AAcZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,OAAO,CACxD,SAAS,IAAK,CACd,UAAU,IAAK,CACf,kBAAkB,IAAK,CACvB,QAAQ,IAAK,CACb,OAAO;;;;;;;;;AAcZ,IAAa,2BACX,4BAA4B,OAAO,kBAAkB,OAAO,CACzD,SAAS,GAAI,CACb,aAAa,GAAI,CACjB,cAAc,IAAK,CACnB,QAAQ,IAAK,CACb,OAAO;;;;;;;;AAaZ,IAAa,0BACX,4BAA4B,OAAO,iBAAiB,OAAO,CACxD,SAAS,IAAK,CACd,MAAM,IAAK,CACX,YAAY,IAAK,CACjB,QAAQ,IAAK,CACb,OAAO;;;;;;;;AAiBZ,IAAa,wBACX,4BAA4B,OAAO,eAAe,OAAO,CACtD,SAAS,GAAI,CACb,WAAW,GAAI,CACf,WAAW,IAAK,CAChB,WAAW,IAAK,CAChB,QAAQ,IAAK,CACb,OAAO;;;;;;;;;AAcZ,IAAa,mBACX,4BAA4B,OAAO,UAAU,OAAO,CACjD,SAAS,GAAI,CACb,WAAW,IAAK,CAChB,SAAS,IAAK,CACd,SAAS,GAAI,CACb,QAAQ,GAAI,CACZ,OAAO;;;;;;;;AAaZ,IAAa,uBACX,4BAA4B,OAAO,cAAc,OAAO,CACrD,UAAU,iBAAiB,KAAK,MAAM,CACtC,eAAe,CACf,UAAU,iBAAiB,KAAK,UAAU,iBAAiB,KAAK,OAAO,CACvE,QACC,iBAAiB,KAAK,OACpB,iBAAiB,KAAK,UACtB,iBAAiB,KAAK,QACzB,CACA,OAAO;;;;;;;;AAaZ,IAAa,sBACX,4BAA4B,OAAO,aAAa,OAAO,CACpD,UAAU,iBAAiB,KAAK,MAAM,CACtC,SAAS,iBAAiB,KAAK,UAAU,iBAAiB,KAAK,OAAO,CACtE,QACC,iBAAiB,KAAK,OACpB,iBAAiB,KAAK,UACtB,iBAAiB,KAAK,QACzB,CACA,OAAO;;;;;;;;;AAcZ,IAAa,qBACX,4BAA4B,OAAO,YAAY,QAAQ,CACpD,SAAS,IAAK,CACd,cAAc,GAAI,CAClB,aAAa,GAAI,CACjB,QAAQ,IAAK,CACb,OAAO;;;;;;;;AAaZ,IAAa,4BACX,4BAA4B,OAAO,mBAAmB,SAAS,CAC5D,SAAS,GAAI,CACb,WAAW,IAAK,CAChB,WAAW,IAAK,CAChB,aAAa,GAAI,CACjB,QAAQ,GAAI,CACZ,OAAO;;;;;AAUZ,IAAa,uBACX,IAAI,IAAI;CACN,CAAC,SAAS,gBAAgB;CAC1B,CAAC,WAAW,kBAAkB;CAC9B,CAAC,kBAAkB,yBAAyB;CAC5C,CAAC,SAAS,gBAAgB;CAC1B,CAAC,cAAc,qBAAqB;CACpC,CAAC,WAAW,kBAAkB;CAC9B,CAAC,QAAQ,eAAe;CACxB,CAAC,aAAa,oBAAoB;CAClC,CAAC,YAAY,mBAAmB;CAChC,CAAC,iBAAiB,wBAAwB;CAC1C,CAAC,kBAAkB,yBAAyB;CAC5C,CAAC,iBAAiB,wBAAwB;CAE1C,CAAC,eAAe,sBAAsB;CACtC,CAAC,UAAU,iBAAiB;CAC5B,CAAC,cAAc,qBAAqB;CACpC,CAAC,aAAa,oBAAoB;CAClC,CAAC,YAAY,mBAAmB;CAChC,CAAC,mBAAmB,0BAA0B;CAC9C,CAAC,qBAAqB,4BAA4B;CAClD,CAAC,eAAe,sBAAsB;CACtC,CAAC,cAAc,qBAAqB;CACpC,CAAC,yBAAyB,gCAAgC;CAC1D,CAAC,mBAAmB,0BAA0B;CAC9C,CAAC,sBAAsB,6BAA6B;CACpD,CAAC,iBAAiB,wBAAwB;CAC1C,CAAC,iBAAiB,wBAAwB;CAC1C,CAAC,iBAAiB,wBAAwB;CAC1C,CAAC,iBAAiB,wBAAwB;CAC1C,CAAC,oBAAoB,2BAA2B;CAChD,CAAC,kBAAkB,yBAAyB;CAC7C,CAAC"}