blacktrigram 0.7.2

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

@@ -0,0 +1,120 @@
+/**
+ * ☱ Tae (Lake) Stance-Specific Animations
+ *
+ * Specialized idle, movement, and guard animations for the Tae (태/Lake) trigram.
+ * Embodies fluid joint manipulation and circular motion from Hapkido techniques.
+ *
+ * **Korean Martial Arts Context:**
+ * - **무술**: 합기도 관절기 (Hapkido Joint Manipulation)
+ * - **특성**: 유동적 관절기 (Fluid Joint Locks), 소원 기술 (Small Circle Techniques)
+ * - **철학**: 물처럼 흐르는 힘 (Flowing Power Like Water), 호수의 적응 (Lake's Adaptation)
+ * - **대표 기술**: 유수연타 (Flowing Water Strikes), 손목꺾기 (Wrist Lock), 팔꿈치 제어 (Elbow Control)
+ *
+ * @module systems/animation/catalogs/TaeStanceAnimations
+ * @category Animation
+ * @korean 태괘자세애니메이션
+ */
+import { type SkeletalAnimation } from "../../../types/skeletal";
+/**
+ * Anatomical safety constants for Tae (Lake) trigram animations
+ *
+ * These limits document safe physiological ranges for Korean martial arts movements.
+ * The constants serve as reference documentation validated by Korean martial arts experts
+ * and inform the design of all Tae animations to ensure realistic, safe joint mechanics.
+ *
+ * Note: These are documentation constants. The actual animation rotations are designed
+ * to stay well within these limits naturally through authentic Hapkido biomechanics.
+ */
+/**
+ * Tae Idle Flowing Animation
+ *
+ * **Korean**: 태괘 유동 자세 (Tae-gwae Yudong Jase)
+ * **Philosophy**: Embodying lake's fluidity through gentle circular breathing
+ *
+ * Characteristics:
+ * - Gentle circular shoulder movement
+ * - Relaxed mid-level guard position
+ * - Weight centered and stable
+ * - Hands open and ready to grasp
+ *
+ * Animation Cycle:
+ * - 0ms: Neutral position with mid-level guard
+ * - 1250ms: Circular shift (left shoulder forward, right back)
+ * - 2500ms: Return to neutral (complete cycle)
+ *
+ * @korean 태괘유동자세
+ * @duration 2500ms (2.5 second cycle)
+ * @category Idle Animation
+ */
+export declare const TAE_IDLE_FLOWING: SkeletalAnimation;
+/**
+ * Tae Circular Sidestep Animation
+ *
+ * **Korean**: 원형 측면보 (Wonhyeong Cheukmyeonbo) - Circular Sidestep
+ * **Technique**: Arc-shaped lateral movement, hip-led
+ *
+ * Characteristics:
+ * - Circular arc path (not straight lateral)
+ * - Hip leads the movement
+ * - Maintains flexible guard throughout
+ * - Weight shifts smoothly
+ *
+ * Animation Phases:
+ * - 0-180ms: Weight shift and hip initiation
+ * - 180-400ms: Circular arc movement
+ * - 400-550ms: Landing and settling
+ *
+ * @korean 원형측면보
+ * @duration 550ms
+ * @category Movement Animation
+ */
+export declare const TAE_CIRCULAR_SIDESTEP: SkeletalAnimation;
+/**
+ * Tae Diagonal Circular Approach Animation
+ *
+ * **Korean**: 대각선 원형 접근 (Daegakseon Wonhyeong Jeobgeun)
+ * **Technique**: 45° curved approach with hands extending
+ *
+ * Characteristics:
+ * - 45° diagonal angle with curved path
+ * - Hands extend forward for joint control
+ * - Hip rotation coordinates with step
+ * - Smooth weight transfer
+ *
+ * Animation Phases:
+ * - 0-233ms: Initial diagonal pivot
+ * - 233-500ms: Curved approach with extending hands
+ * - 500-667ms: Landing in engagement position
+ *
+ * @korean 대각선원형접근
+ * @duration 667ms
+ * @category Movement Animation
+ */
+export declare const TAE_DIAGONAL_CIRCULAR_APPROACH: SkeletalAnimation;
+/**
+ * Tae Flexible Guard Transition Animation
+ *
+ * **Korean**: 호수 방어 전환 (Hosu Bangeo Jeonhwan) - Lake Guard Transition
+ * **Technique**: Transition into Tae's characteristic flexible mid-level guard
+ *
+ * Characteristics:
+ * - Smooth transition to mid-level guard
+ * - Hands at chest/solar plexus height
+ * - Elbows bent at 80° for flexibility
+ * - Weight evenly distributed
+ *
+ * Animation Phases:
+ * - 0-150ms: Begin transition
+ * - 150-300ms: Settle into Tae guard
+ *
+ * @korean 호수방어전환
+ * @duration 300ms
+ * @category Stance Animation
+ */
+export declare const TAE_FLEXIBLE_GUARD_TRANSITION: SkeletalAnimation;
+/**
+ * Map of all Tae stance-specific animations for easy access
+ * @korean 태괘자세애니메이션맵
+ */
+export declare const TAE_STANCE_ANIMATIONS: ReadonlyMap<string, SkeletalAnimation>;
+//# sourceMappingURL=TaeStanceAnimations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaeStanceAnimations.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/catalogs/TaeStanceAnimations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAepE;;;;;;;;;GASG;AAMH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBA4CnB,CAAC;AAMb;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAqCxB,CAAC;AAMb;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,8BAA8B,EAAE,iBAyCjC,CAAC;AAMb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,6BAA6B,EAAE,iBA2BhC,CAAC;AAMb;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAkBvE,CAAC"}

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

@@ -0,0 +1,139 @@
+import { BoneName } from "../../../types/skeletal.js";
+import { MartialArtsAnimationBuilder } from "../builders/MartialArtsAnimationBuilder.js";
+import { TAE_ARM_BAR, TAE_ELBOW_CONTROL, TAE_FINGER_LOCK, TAE_FLOWING_COUNTER, TAE_FLOWING_STRIKES, TAE_SHOULDER_LOCK, TAE_SMALL_CIRCLE, TAE_WRIST_LOCK_SEQUENCE } from "./TaeJointLockAnimations.js";
+//#region src/systems/animation/catalogs/TaeStanceAnimations.ts
+/**
+* ☱ Tae (Lake) Stance-Specific Animations
+*
+* Specialized idle, movement, and guard animations for the Tae (태/Lake) trigram.
+* Embodies fluid joint manipulation and circular motion from Hapkido techniques.
+*
+* **Korean Martial Arts Context:**
+* - **무술**: 합기도 관절기 (Hapkido Joint Manipulation)
+* - **특성**: 유동적 관절기 (Fluid Joint Locks), 소원 기술 (Small Circle Techniques)
+* - **철학**: 물처럼 흐르는 힘 (Flowing Power Like Water), 호수의 적응 (Lake's Adaptation)
+* - **대표 기술**: 유수연타 (Flowing Water Strikes), 손목꺾기 (Wrist Lock), 팔꿈치 제어 (Elbow Control)
+*
+* @module systems/animation/catalogs/TaeStanceAnimations
+* @category Animation
+* @korean 태괘자세애니메이션
+*/
+/**
+* Anatomical safety constants for Tae (Lake) trigram animations
+*
+* These limits document safe physiological ranges for Korean martial arts movements.
+* The constants serve as reference documentation validated by Korean martial arts experts
+* and inform the design of all Tae animations to ensure realistic, safe joint mechanics.
+*
+* Note: These are documentation constants. The actual animation rotations are designed
+* to stay well within these limits naturally through authentic Hapkido biomechanics.
+*/
+/**
+* Tae Idle Flowing Animation
+*
+* **Korean**: 태괘 유동 자세 (Tae-gwae Yudong Jase)
+* **Philosophy**: Embodying lake's fluidity through gentle circular breathing
+*
+* Characteristics:
+* - Gentle circular shoulder movement
+* - Relaxed mid-level guard position
+* - Weight centered and stable
+* - Hands open and ready to grasp
+*
+* Animation Cycle:
+* - 0ms: Neutral position with mid-level guard
+* - 1250ms: Circular shift (left shoulder forward, right back)
+* - 2500ms: Return to neutral (complete cycle)
+*
+* @korean 태괘유동자세
+* @duration 2500ms (2.5 second cycle)
+* @category Idle Animation
+*/
+var TAE_IDLE_FLOWING = MartialArtsAnimationBuilder.create("tae_idle_flowing", "태괘 유동 자세").asIdle(2.5, true).at(0).rotate(BoneName.PELVIS, 0, 0, 0).rotate(BoneName.SPINE_UPPER, 0, 0, 0).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).rotate(BoneName.ELBOW_L, 0, 0, -1.4).rotate(BoneName.ELBOW_R, 0, 0, 1.4).rotate(BoneName.WRIST_L, 0, 0, 0).rotate(BoneName.WRIST_R, 0, 0, 0).rotate(BoneName.HEAD, 0, 0, 0).position(BoneName.PELVIS, 0, 0, 0).done().at(1.25).rotate(BoneName.SPINE_UPPER, 0, .09, 0).rotate(BoneName.SHOULDER_L, -.48, -.09, .17).rotate(BoneName.SHOULDER_R, -.57, .26, -.17).rotate(BoneName.ELBOW_L, 0, 0, -1.31).rotate(BoneName.ELBOW_R, 0, 0, 1.48).rotate(BoneName.WRIST_L, 0, .09, 0).rotate(BoneName.WRIST_R, 0, -.09, 0).rotate(BoneName.PELVIS, 0, .05, 0).position(BoneName.PELVIS, -.02, 0, 0).done().at(2.5).rotate(BoneName.SPINE_UPPER, 0, 0, 0).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).rotate(BoneName.ELBOW_L, 0, 0, -1.4).rotate(BoneName.ELBOW_R, 0, 0, 1.4).rotate(BoneName.WRIST_L, 0, 0, 0).rotate(BoneName.WRIST_R, 0, 0, 0).rotate(BoneName.HEAD, 0, 0, 0).rotate(BoneName.PELVIS, 0, 0, 0).position(BoneName.PELVIS, 0, 0, 0).done().build();
+/**
+* Tae Circular Sidestep Animation
+*
+* **Korean**: 원형 측면보 (Wonhyeong Cheukmyeonbo) - Circular Sidestep
+* **Technique**: Arc-shaped lateral movement, hip-led
+*
+* Characteristics:
+* - Circular arc path (not straight lateral)
+* - Hip leads the movement
+* - Maintains flexible guard throughout
+* - Weight shifts smoothly
+*
+* Animation Phases:
+* - 0-180ms: Weight shift and hip initiation
+* - 180-400ms: Circular arc movement
+* - 400-550ms: Landing and settling
+*
+* @korean 원형측면보
+* @duration 550ms
+* @category Movement Animation
+*/
+var TAE_CIRCULAR_SIDESTEP = MartialArtsAnimationBuilder.create("tae_circular_sidestep", "원형 측면보").asMovement(.55, false).at(0).rotate(BoneName.PELVIS, 0, -.17, 0).rotate(BoneName.KNEE_R, -.26, 0, 0).rotate(BoneName.KNEE_L, -.35, 0, 0).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).rotate(BoneName.ELBOW_L, 0, 0, -1.4).rotate(BoneName.ELBOW_R, 0, 0, 1.4).position(BoneName.PELVIS, 0, 0, 0).done().at(.275).rotate(BoneName.PELVIS, 0, -.35, 0).rotate(BoneName.KNEE_R, -.17, 0, 0).rotate(BoneName.KNEE_L, -.44, 0, 0).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).position(BoneName.PELVIS, -.18, .02, -.03).done().at(.55).rotate(BoneName.PELVIS, 0, -.26, 0).rotate(BoneName.KNEE_R, -.26, 0, 0).rotate(BoneName.KNEE_L, -.35, 0, 0).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).rotate(BoneName.ELBOW_L, 0, 0, -1.4).rotate(BoneName.ELBOW_R, 0, 0, 1.4).position(BoneName.PELVIS, -.25, 0, 0).done().build();
+/**
+* Tae Diagonal Circular Approach Animation
+*
+* **Korean**: 대각선 원형 접근 (Daegakseon Wonhyeong Jeobgeun)
+* **Technique**: 45° curved approach with hands extending
+*
+* Characteristics:
+* - 45° diagonal angle with curved path
+* - Hands extend forward for joint control
+* - Hip rotation coordinates with step
+* - Smooth weight transfer
+*
+* Animation Phases:
+* - 0-233ms: Initial diagonal pivot
+* - 233-500ms: Curved approach with extending hands
+* - 500-667ms: Landing in engagement position
+*
+* @korean 대각선원형접근
+* @duration 667ms
+* @category Movement Animation
+*/
+var TAE_DIAGONAL_CIRCULAR_APPROACH = MartialArtsAnimationBuilder.create("tae_diagonal_circular_approach", "대각선 원형 접근").asMovement(.667, false).at(0).rotate(BoneName.PELVIS, 0, -.79, 0).rotate(BoneName.KNEE_R, -.35, 0, 0).rotate(BoneName.KNEE_L, -.26, 0, 0).rotate(BoneName.SHOULDER_L, -.44, -.26, .35).rotate(BoneName.SHOULDER_R, -.44, .26, -.35).rotate(BoneName.ELBOW_L, 0, 0, -1.05).rotate(BoneName.ELBOW_R, 0, 0, 1.05).position(BoneName.PELVIS, 0, 0, 0).done().at(.361).rotate(BoneName.PELVIS, 0, -.61, 0).rotate(BoneName.KNEE_R, -.17, 0, 0).rotate(BoneName.KNEE_L, -.44, 0, 0).rotate(BoneName.SHOULDER_L, -.35, -.35, .44).rotate(BoneName.SHOULDER_R, -.35, .35, -.44).rotate(BoneName.ELBOW_L, 0, 0, -.7).rotate(BoneName.ELBOW_R, 0, 0, .7).position(BoneName.PELVIS, -.2, .02, .2).done().at(.667).rotate(BoneName.PELVIS, 0, -.79, 0).rotate(BoneName.KNEE_R, -.26, 0, 0).rotate(BoneName.KNEE_L, -.35, 0, 0).rotate(BoneName.SHOULDER_L, -.26, -.44, .52).rotate(BoneName.SHOULDER_R, -.26, .44, -.52).rotate(BoneName.ELBOW_L, 0, 0, -.52).rotate(BoneName.ELBOW_R, 0, 0, .52).rotate(BoneName.WRIST_L, .09, 0, -.09).rotate(BoneName.WRIST_R, .09, 0, .09).position(BoneName.PELVIS, -.3, 0, .3).done().build();
+/**
+* Tae Flexible Guard Transition Animation
+*
+* **Korean**: 호수 방어 전환 (Hosu Bangeo Jeonhwan) - Lake Guard Transition
+* **Technique**: Transition into Tae's characteristic flexible mid-level guard
+*
+* Characteristics:
+* - Smooth transition to mid-level guard
+* - Hands at chest/solar plexus height
+* - Elbows bent at 80° for flexibility
+* - Weight evenly distributed
+*
+* Animation Phases:
+* - 0-150ms: Begin transition
+* - 150-300ms: Settle into Tae guard
+*
+* @korean 호수방어전환
+* @duration 300ms
+* @category Stance Animation
+*/
+var TAE_FLEXIBLE_GUARD_TRANSITION = MartialArtsAnimationBuilder.create("tae_flexible_guard_transition", "호수 방어 전환").asStance(.3, false).at(0).rotate(BoneName.SHOULDER_L, -.44, -.09, .22).rotate(BoneName.SHOULDER_R, -.44, .09, -.22).rotate(BoneName.ELBOW_L, 0, 0, -1.22).rotate(BoneName.ELBOW_R, 0, 0, 1.22).rotate(BoneName.PELVIS, 0, 0, 0).position(BoneName.PELVIS, 0, 0, 0).done().at(.3).rotate(BoneName.SHOULDER_L, -.52, -.17, .26).rotate(BoneName.SHOULDER_R, -.52, .17, -.26).rotate(BoneName.ELBOW_L, 0, 0, -1.4).rotate(BoneName.ELBOW_R, 0, 0, 1.4).rotate(BoneName.WRIST_L, 0, 0, 0).rotate(BoneName.WRIST_R, 0, 0, 0).rotate(BoneName.KNEE_L, -.26, 0, 0).rotate(BoneName.KNEE_R, -.26, 0, 0).position(BoneName.PELVIS, 0, 0, 0).done().build();
+/**
+* Map of all Tae stance-specific animations for easy access
+* @korean 태괘자세애니메이션맵
+*/
+var TAE_STANCE_ANIMATIONS = new Map([
+	["tae_idle_flowing", TAE_IDLE_FLOWING],
+	["tae_circular_sidestep", TAE_CIRCULAR_SIDESTEP],
+	["tae_diagonal_circular_approach", TAE_DIAGONAL_CIRCULAR_APPROACH],
+	["tae_flexible_guard_transition", TAE_FLEXIBLE_GUARD_TRANSITION],
+	["tae_wrist_lock_sequence", TAE_WRIST_LOCK_SEQUENCE],
+	["tae_elbow_control", TAE_ELBOW_CONTROL],
+	["tae_finger_lock", TAE_FINGER_LOCK],
+	["tae_flowing_counter", TAE_FLOWING_COUNTER],
+	["tae_flowing_strikes", TAE_FLOWING_STRIKES],
+	["tae_small_circle", TAE_SMALL_CIRCLE],
+	["tae_shoulder_lock", TAE_SHOULDER_LOCK],
+	["tae_arm_bar", TAE_ARM_BAR]
+]);
+//#endregion
+export { TAE_CIRCULAR_SIDESTEP, TAE_DIAGONAL_CIRCULAR_APPROACH, TAE_FLEXIBLE_GUARD_TRANSITION, TAE_IDLE_FLOWING, TAE_STANCE_ANIMATIONS };
+
+//# sourceMappingURL=TaeStanceAnimations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaeStanceAnimations.js","names":[],"sources":["../../../../src/systems/animation/catalogs/TaeStanceAnimations.ts"],"sourcesContent":["/**\n * ☱ Tae (Lake) Stance-Specific Animations\n *\n * Specialized idle, movement, and guard animations for the Tae (태/Lake) trigram.\n * Embodies fluid joint manipulation and circular motion from Hapkido techniques.\n *\n * **Korean Martial Arts Context:**\n * - **무술**: 합기도 관절기 (Hapkido Joint Manipulation)\n * - **특성**: 유동적 관절기 (Fluid Joint Locks), 소원 기술 (Small Circle Techniques)\n * - **철학**: 물처럼 흐르는 힘 (Flowing Power Like Water), 호수의 적응 (Lake's Adaptation)\n * - **대표 기술**: 유수연타 (Flowing Water Strikes), 손목꺾기 (Wrist Lock), 팔꿈치 제어 (Elbow Control)\n *\n * @module systems/animation/catalogs/TaeStanceAnimations\n * @category Animation\n * @korean 태괘자세애니메이션\n */\n\nimport { BoneName, type SkeletalAnimation } from \"@/types/skeletal\";\nimport { MartialArtsAnimationBuilder } from \"../builders/MartialArtsAnimationBuilder\";\n\n// Import Hapkido joint lock techniques (합기도 관절기)\nimport {\n  TAE_WRIST_LOCK_SEQUENCE,\n  TAE_ELBOW_CONTROL,\n  TAE_FINGER_LOCK,\n  TAE_FLOWING_COUNTER,\n  TAE_FLOWING_STRIKES,\n  TAE_SMALL_CIRCLE,\n  TAE_SHOULDER_LOCK,\n  TAE_ARM_BAR,\n} from \"./TaeJointLockAnimations\";\n\n/**\n * Anatomical safety constants for Tae (Lake) trigram animations\n *\n * These limits document safe physiological ranges for Korean martial arts movements.\n * The constants serve as reference documentation validated by Korean martial arts experts\n * and inform the design of all Tae animations to ensure realistic, safe joint mechanics.\n *\n * Note: These are documentation constants. The actual animation rotations are designed\n * to stay well within these limits naturally through authentic Hapkido biomechanics.\n */\n\n// ═══════════════════════════════════════════════════════════════════════════\n// ☱ TAE IDLE FLOWING ANIMATION (태괘 유동 자세)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Tae Idle Flowing Animation\n *\n * **Korean**: 태괘 유동 자세 (Tae-gwae Yudong Jase)\n * **Philosophy**: Embodying lake's fluidity through gentle circular breathing\n *\n * Characteristics:\n * - Gentle circular shoulder movement\n * - Relaxed mid-level guard position\n * - Weight centered and stable\n * - Hands open and ready to grasp\n *\n * Animation Cycle:\n * - 0ms: Neutral position with mid-level guard\n * - 1250ms: Circular shift (left shoulder forward, right back)\n * - 2500ms: Return to neutral (complete cycle)\n *\n * @korean 태괘유동자세\n * @duration 2500ms (2.5 second cycle)\n * @category Idle Animation\n */\nexport const TAE_IDLE_FLOWING: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\n    \"tae_idle_flowing\",\n    \"태괘 유동 자세\"\n  )\n    .asIdle(2.5, true)\n    // Keyframe 0ms: Neutral mid-level guard (baseline)\n    .at(0)\n    .rotate(BoneName.PELVIS, 0, 0, 0) // Neutral pelvis\n    .rotate(BoneName.SPINE_UPPER, 0, 0, 0) // Neutral spine\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26) // -30°, -10°, 15° (mid-level flexible guard)\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26) // -30°, 10°, -15°\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.4) // -80° (flexed guard)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.4) // 80° (flexed guard)\n    .rotate(BoneName.WRIST_L, 0, 0, 0) // Neutral wrists\n    .rotate(BoneName.WRIST_R, 0, 0, 0)\n    .rotate(BoneName.HEAD, 0, 0, 0) // Head neutral, aware\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    // Keyframe 1250ms: Circular shift (subtle flowing motion)\n    .at(1.25)\n    .rotate(BoneName.SPINE_UPPER, 0, 0.09, 0) // 0°, 5° (slight rotation creating circular feel)\n    .rotate(BoneName.SHOULDER_L, -0.48, -0.09, 0.17) // -27.5°, -5°, 10° (left forward slightly)\n    .rotate(BoneName.SHOULDER_R, -0.57, 0.26, -0.17) // -32.5°, 15°, -10° (right back slightly)\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.31) // -75° (slight extension)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.48) // 85° (slight flexion)\n    .rotate(BoneName.WRIST_L, 0, 0.09, 0) // 0°, 5° (gentle circular motion)\n    .rotate(BoneName.WRIST_R, 0, -0.09, 0) // 0°, -5°\n    .rotate(BoneName.PELVIS, 0, 0.05, 0) // 0°, 3° (subtle weight shift)\n    .position(BoneName.PELVIS, -0.02, 0, 0) // Minimal lateral shift\n    .done<MartialArtsAnimationBuilder>()\n    // Keyframe 2500ms: Return to neutral (complete cycle)\n    .at(2.5)\n    .rotate(BoneName.SPINE_UPPER, 0, 0, 0)\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26)\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26)\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.4)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.4)\n    .rotate(BoneName.WRIST_L, 0, 0, 0)\n    .rotate(BoneName.WRIST_R, 0, 0, 0)\n    .rotate(BoneName.HEAD, 0, 0, 0)\n    .rotate(BoneName.PELVIS, 0, 0, 0)\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// ☱ TAE CIRCULAR SIDESTEP (원형 측면보)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Tae Circular Sidestep Animation\n *\n * **Korean**: 원형 측면보 (Wonhyeong Cheukmyeonbo) - Circular Sidestep\n * **Technique**: Arc-shaped lateral movement, hip-led\n *\n * Characteristics:\n * - Circular arc path (not straight lateral)\n * - Hip leads the movement\n * - Maintains flexible guard throughout\n * - Weight shifts smoothly\n *\n * Animation Phases:\n * - 0-180ms: Weight shift and hip initiation\n * - 180-400ms: Circular arc movement\n * - 400-550ms: Landing and settling\n *\n * @korean 원형측면보\n * @duration 550ms\n * @category Movement Animation\n */\nexport const TAE_CIRCULAR_SIDESTEP: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\n    \"tae_circular_sidestep\",\n    \"원형 측면보\"\n  )\n    .asMovement(0.55, false)\n    // Phase 1: Initial weight shift (0ms)\n    .at(0)\n    .rotate(BoneName.PELVIS, 0, -0.17, 0) // 0°, -10° (hip begins rotation)\n    .rotate(BoneName.KNEE_R, -0.26, 0, 0) // -15° (rear leg loads)\n    .rotate(BoneName.KNEE_L, -0.35, 0, 0) // -20° (lead leg ready)\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26) // Guard maintained\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26)\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.4)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.4)\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    // Phase 2: Circular arc movement (275ms)\n    .at(0.275)\n    .rotate(BoneName.PELVIS, 0, -0.35, 0) // 0°, -20° (maximum hip rotation)\n    .rotate(BoneName.KNEE_R, -0.17, 0, 0) // -10° (rear leg extends)\n    .rotate(BoneName.KNEE_L, -0.44, 0, 0) // -25° (lead leg pushes)\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26) // Guard stable\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26)\n    .position(BoneName.PELVIS, -0.18, 0.02, -0.03) // Arc trajectory (lateral + slight back)\n    .done<MartialArtsAnimationBuilder>()\n    // Phase 3: Landing and settling (550ms)\n    .at(0.55)\n    .rotate(BoneName.PELVIS, 0, -0.26, 0) // 0°, -15° (settled)\n    .rotate(BoneName.KNEE_R, -0.26, 0, 0) // -15° (stable)\n    .rotate(BoneName.KNEE_L, -0.35, 0, 0) // -20° (grounded)\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26) // Guard maintained\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26)\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.4)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.4)\n    .position(BoneName.PELVIS, -0.25, 0, 0) // Final lateral position\n    .done<MartialArtsAnimationBuilder>()\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// ☱ TAE DIAGONAL CIRCULAR APPROACH (대각선 원형 접근)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Tae Diagonal Circular Approach Animation\n *\n * **Korean**: 대각선 원형 접근 (Daegakseon Wonhyeong Jeobgeun)\n * **Technique**: 45° curved approach with hands extending\n *\n * Characteristics:\n * - 45° diagonal angle with curved path\n * - Hands extend forward for joint control\n * - Hip rotation coordinates with step\n * - Smooth weight transfer\n *\n * Animation Phases:\n * - 0-233ms: Initial diagonal pivot\n * - 233-500ms: Curved approach with extending hands\n * - 500-667ms: Landing in engagement position\n *\n * @korean 대각선원형접근\n * @duration 667ms\n * @category Movement Animation\n */\nexport const TAE_DIAGONAL_CIRCULAR_APPROACH: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\n    \"tae_diagonal_circular_approach\",\n    \"대각선 원형 접근\"\n  )\n    .asMovement(0.667, false)\n    // Phase 1: Initial diagonal pivot (0ms)\n    .at(0)\n    .rotate(BoneName.PELVIS, 0, -0.79, 0) // 0°, -45° (diagonal rotation)\n    .rotate(BoneName.KNEE_R, -0.35, 0, 0) // -20° (rear leg ready)\n    .rotate(BoneName.KNEE_L, -0.26, 0, 0) // -15° (lead leg ready)\n    .rotate(BoneName.SHOULDER_L, -0.44, -0.26, 0.35) // -25°, -15°, 20° (hands begin extending)\n    .rotate(BoneName.SHOULDER_R, -0.44, 0.26, -0.35) // -25°, 15°, -20°\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.05) // -60° (extending)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.05) // 60° (extending)\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    // Phase 2: Curved approach with extending hands (361ms)\n    .at(0.361)\n    .rotate(BoneName.PELVIS, 0, -0.61, 0) // 0°, -35° (unwinding)\n    .rotate(BoneName.KNEE_R, -0.17, 0, 0) // -10° (extending)\n    .rotate(BoneName.KNEE_L, -0.44, 0, 0) // -25° (pushing)\n    .rotate(BoneName.SHOULDER_L, -0.35, -0.35, 0.44) // -20°, -20°, 25° (reaching)\n    .rotate(BoneName.SHOULDER_R, -0.35, 0.35, -0.44) // -20°, 20°, -25°\n    .rotate(BoneName.ELBOW_L, 0, 0, -0.7) // -40° (extending more)\n    .rotate(BoneName.ELBOW_R, 0, 0, 0.7) // 40° (extending more)\n    .position(BoneName.PELVIS, -0.2, 0.02, 0.2) // Curved diagonal path\n    .done<MartialArtsAnimationBuilder>()\n    // Phase 3: Landing in engagement position (667ms)\n    .at(0.667)\n    .rotate(BoneName.PELVIS, 0, -0.79, 0) // 0°, -45° (settled diagonal)\n    .rotate(BoneName.KNEE_R, -0.26, 0, 0) // -15° (stable)\n    .rotate(BoneName.KNEE_L, -0.35, 0, 0) // -20° (grounded)\n    .rotate(BoneName.SHOULDER_L, -0.26, -0.44, 0.52) // -15°, -25°, 30° (hands extended)\n    .rotate(BoneName.SHOULDER_R, -0.26, 0.44, -0.52) // -15°, 25°, -30°\n    .rotate(BoneName.ELBOW_L, 0, 0, -0.52) // -30° (ready to engage)\n    .rotate(BoneName.ELBOW_R, 0, 0, 0.52) // 30° (ready to engage)\n    .rotate(BoneName.WRIST_L, 0.09, 0, -0.09) // 5°, 0°, -5° (hands ready to grasp)\n    .rotate(BoneName.WRIST_R, 0.09, 0, 0.09) // 5°, 0°, 5°\n    .position(BoneName.PELVIS, -0.3, 0, 0.3) // Diagonal 45° position\n    .done<MartialArtsAnimationBuilder>()\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// ☱ TAE FLEXIBLE GUARD TRANSITION (호수 방어 전환)\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Tae Flexible Guard Transition Animation\n *\n * **Korean**: 호수 방어 전환 (Hosu Bangeo Jeonhwan) - Lake Guard Transition\n * **Technique**: Transition into Tae's characteristic flexible mid-level guard\n *\n * Characteristics:\n * - Smooth transition to mid-level guard\n * - Hands at chest/solar plexus height\n * - Elbows bent at 80° for flexibility\n * - Weight evenly distributed\n *\n * Animation Phases:\n * - 0-150ms: Begin transition\n * - 150-300ms: Settle into Tae guard\n *\n * @korean 호수방어전환\n * @duration 300ms\n * @category Stance Animation\n */\nexport const TAE_FLEXIBLE_GUARD_TRANSITION: SkeletalAnimation =\n  MartialArtsAnimationBuilder.create(\n    \"tae_flexible_guard_transition\",\n    \"호수 방어 전환\"\n  )\n    .asStance(0.3, false)\n    // Phase 1: Begin transition (0ms)\n    .at(0)\n    .rotate(BoneName.SHOULDER_L, -0.44, -0.09, 0.22) // -25°, -5°, 12.5° (moving toward guard)\n    .rotate(BoneName.SHOULDER_R, -0.44, 0.09, -0.22) // -25°, 5°, -12.5°\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.22) // -70° (transitioning)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.22) // 70° (transitioning)\n    .rotate(BoneName.PELVIS, 0, 0, 0) // Neutral pelvis\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    // Phase 2: Settle into Tae guard (300ms)\n    .at(0.3)\n    .rotate(BoneName.SHOULDER_L, -0.52, -0.17, 0.26) // -30°, -10°, 15° (Tae guard)\n    .rotate(BoneName.SHOULDER_R, -0.52, 0.17, -0.26) // -30°, 10°, -15°\n    .rotate(BoneName.ELBOW_L, 0, 0, -1.4) // -80° (Tae guard angle)\n    .rotate(BoneName.ELBOW_R, 0, 0, 1.4) // 80° (Tae guard angle)\n    .rotate(BoneName.WRIST_L, 0, 0, 0) // Neutral wrists\n    .rotate(BoneName.WRIST_R, 0, 0, 0)\n    .rotate(BoneName.KNEE_L, -0.26, 0, 0) // -15° (stable stance)\n    .rotate(BoneName.KNEE_R, -0.26, 0, 0) // -15° (stable stance)\n    .position(BoneName.PELVIS, 0, 0, 0)\n    .done<MartialArtsAnimationBuilder>()\n    .build();\n\n// ═══════════════════════════════════════════════════════════════════════════\n// EXPORTS\n// ═══════════════════════════════════════════════════════════════════════════\n\n/**\n * Map of all Tae stance-specific animations for easy access\n * @korean 태괘자세애니메이션맵\n */\nexport const TAE_STANCE_ANIMATIONS: ReadonlyMap<string, SkeletalAnimation> = new Map([\n  // Idle & Movement\n  [\"tae_idle_flowing\", TAE_IDLE_FLOWING],\n  [\"tae_circular_sidestep\", TAE_CIRCULAR_SIDESTEP],\n  [\"tae_diagonal_circular_approach\", TAE_DIAGONAL_CIRCULAR_APPROACH],\n  \n  // Stance Transitions\n  [\"tae_flexible_guard_transition\", TAE_FLEXIBLE_GUARD_TRANSITION],\n  \n  // Hapkido Joint Lock Techniques (합기도 관절기)\n  [\"tae_wrist_lock_sequence\", TAE_WRIST_LOCK_SEQUENCE],\n  [\"tae_elbow_control\", TAE_ELBOW_CONTROL],\n  [\"tae_finger_lock\", TAE_FINGER_LOCK],\n  [\"tae_flowing_counter\", TAE_FLOWING_COUNTER],\n  [\"tae_flowing_strikes\", TAE_FLOWING_STRIKES],\n  [\"tae_small_circle\", TAE_SMALL_CIRCLE],\n  [\"tae_shoulder_lock\", TAE_SHOULDER_LOCK],\n  [\"tae_arm_bar\", TAE_ARM_BAR],\n]);\n"],"mappings":"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"}

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

@@ -0,0 +1,43 @@
+/**
+ * Animation catalog sub-package
+ *
+ * Curated collections of skeletal animations for attacks, defenses,
+ * locomotion, stances, and recovery-aware variants.
+ */
+export { GAM_WATER_GUARD_POSE, GAN_MOUNTAIN_GUARD_POSE, GEON_HIGH_GUARD_POSE, GON_EARTH_GUARD_POSE, JIN_THUNDER_GUARD_POSE, LI_FIRE_GUARD_POSE, SON_WIND_GUARD_POSE, STANCE_GUARD_CONFIGS, TAE_FLUID_GUARD_POSE, getAllStanceGuardPoses, getGuardConfigForStance, getGuardPoseForStance, } from "./StanceGuardPoses";
+export { ATTACK_ANIMATIONS, BACKWARD_RETREAT_ANIMATION, BLOCK_ANIMATION, CROSS_ANIMATION, FORWARD_DASH_ANIMATION, FRONT_KICK_ANIMATION, IDLE_STANCE_ANIMATION, JAB_ANIMATION, ROUNDHOUSE_KICK_ANIMATION, SIDE_STEP_ANIMATION, WALK_ANIMATION, } from "./AttackAnimations";
+export { BASIC_ANIMATIONS, FALL_BACKWARD_ANIMATION, FALL_FORWARD_ANIMATION, FALL_SIDE_LEFT_ANIMATION, FALL_SIDE_RIGHT_ANIMATION, IDLE_ANIMATION, RUN_ANIMATION, WALK_ANIMATION as WALK_ANIMATION_NEW, } from "./BasicAnimations";
+export { STEP_ANIMATIONS, STEP_BACK_ANIMATION, STEP_FORWARD_ANIMATION, STEP_LEFT_ANIMATION, STEP_RIGHT_ANIMATION, getStepAnimation, } from "./StepSkeletalAnimations";
+export { FOOTWORK_ANIMATIONS, FOOTWORK_SLIDE_FORWARD_ANIMATION, FOOTWORK_SLIDE_BACK_ANIMATION, FOOTWORK_SLIDE_LEFT_ANIMATION, FOOTWORK_SLIDE_RIGHT_ANIMATION, FOOTWORK_SWITCH_STEP_ANIMATION, FOOTWORK_BOUNCE_STEP_ANIMATION, FOOTWORK_TRIANGLE_ANIMATION, FOOTWORK_CIRCULAR_LEFT_ANIMATION, FOOTWORK_CIRCULAR_RIGHT_ANIMATION, FOOTWORK_PIVOT_LEFT_ANIMATION, FOOTWORK_PIVOT_RIGHT_ANIMATION, FOOTWORK_SHUFFLE_ANIMATION, getFootworkAnimation, } from "./FootworkSkeletalAnimations";
+export { STEP_ANIMATION_CONFIGS, STEP_ANIMATION_PARAMS, STEP_KEYFRAMES, STEP_KOREAN_TERMS, createStepConfig, getStepDirectionVector, getStepKeyframeAtFrame, interpolateStepKeyframes, } from "./StepAnimations";
+export { ALL_DEFENSIVE_ANIMATIONS, DEFENSIVE_ANIMATIONS_BY_STANCE, GAM_FLOW_DEFENSE, GAM_REDIRECTION_COUNTER, GAN_COUNTER_FORTRESS, GAN_IMMOVABLE_BLOCK, GEON_COUNTER_STRIKE, GEON_HIGH_BLOCK, GON_GROUNDING_DEFENSE, GON_TAKEDOWN_COUNTER, JIN_EXPLOSIVE_BLOCK, JIN_SHOCKING_COUNTER, LI_NERVE_STRIKE_COUNTER, LI_PRECISION_PARRY, SON_CONTINUOUS_DEFLECTION, SON_PRESSURE_COUNTER, TAE_JOINT_LOCK_DEFENSE, TAE_SWEEP_DEFENSE, getDefensiveAnimation, getDefensiveAnimationsForStance, } from "./DefensiveAnimations";
+export { GAM_RUN_ANIMATION, GAM_WALK_ANIMATION, GAN_RUN_ANIMATION, GAN_WALK_ANIMATION, GEON_RUN_ANIMATION, GEON_WALK_ANIMATION, GON_RUN_ANIMATION, GON_WALK_ANIMATION, JIN_RUN_ANIMATION, JIN_WALK_ANIMATION, LI_RUN_ANIMATION, LI_WALK_ANIMATION, SON_RUN_ANIMATION, SON_WALK_ANIMATION, STANCE_LOCOMOTION_ANIMATIONS, STANCE_RUN_ANIMATIONS, STANCE_WALK_ANIMATIONS, TAE_RUN_ANIMATION, TAE_WALK_ANIMATION, getStanceRunAnimation, getStanceWalkAnimation, } from "./StanceLocomotionAnimations";
+export { ALL_ATTACK_ANIMATIONS, ATTACK_ANIMATIONS_BY_STANCE, GAM_FLOWING_RIVER_STRIKE, GAM_TIDAL_WAVE_PALM, GAM_WHIRLPOOL_COUNTER, GAN_AVALANCHE_HAMMER, GAN_FORTRESS_COUNTER_STRIKE, GAN_STONE_WALL_THRUST, GEON_BONE_BREAKING_STRIKE_1, GEON_CRUSHING_ELBOW, GEON_THUNDEROUS_UPPERCUT, GON_EARTHQUAKE_STOMP, GON_GROUND_SWEEP_STRIKE, GON_ROOTING_TAKEDOWN, JIN_EXPLOSIVE_KNEE, JIN_LIGHTNING_STRAIGHT, JIN_SHOCKING_HAMMER_FIST, LI_BURNING_FINGER_STRIKE_1, LI_PHOENIX_EYE_STRIKE, LI_SOLAR_PLEXUS_SPEAR, SON_PENETRATING_PALM_RUSH, SON_PRESSURE_POINT_CHAIN, SON_WHIRLWIND_COMBO_1, TAE_FLOWING_ARM_BAR, TAE_SPIRAL_SHOULDER_THROW, TAE_WRIST_LOCK_STRIKE, getAttackAnimation, getAttackAnimationsForStance, } from "./StanceAttackAnimations";
+export { CROSS_ANIMATION_ENHANCED, ENHANCED_ANIMATIONS, FRONT_KICK_ANIMATION_ENHANCED, JAB_ANIMATION_ENHANCED, RECOVERY_PRESETS, ROUNDHOUSE_KICK_ANIMATION_ENHANCED, applyRecoveryPreset, } from "./EnhancedAttackAnimations";
+export { ELBOW_STRIKE_ANIMATION_ENHANCED, ELBOW_UPPERCUT_ANIMATION_ENHANCED, ENHANCED_ELBOW_KNEE_ANIMATIONS, KNEE_STRIKE_ANIMATION_ENHANCED, } from "./EnhancedElbowKneeAnimations";
+export { ALL_TRIGRAM_IDLE_ANIMATIONS, GAM_IDLE_ANIMATION, GAN_IDLE_ANIMATION, GEON_IDLE_ANIMATION, GON_IDLE_ANIMATION, JIN_IDLE_ANIMATION, LI_IDLE_ANIMATION, SON_IDLE_ANIMATION, TAE_IDLE_ANIMATION, TRIGRAM_IDLE_ANIMATIONS, TRIGRAM_IDLE_ANIMATIONS_BY_NAME, TRIGRAM_IDLE_METADATA, getTrigramIdleAnimation, getTrigramIdleByName, } from "./StanceIdleAnimations";
+export { GEON_ANIMATIONS, GEON_AXE_KICK, GEON_DIAGONAL_POWER_STEP, GEON_ELBOW_SMASH, GEON_FORWARD_ADVANCE, GEON_FRONTAL_KICK, GEON_HEAVEN_STRIKE, GEON_HEAVENLY_FIST_ANIMATION, GEON_IDLE_BREATHING, GEON_OVERHEAD_HAMMER, GEON_PALM_STRIKE, GEON_ROUNDHOUSE_KICK, } from "./GeonStanceAnimations";
+export { GON_HEAVY_GROUNDING_STEP, GON_IDLE_SSIREUM_STANCE, GON_SWEEP_POSITIONING_STEP, } from "./GonStanceAnimations";
+export { GON_EARTH_EMBRACE_ANIMATION, GON_GROUND_CONTROL_TRANSITION, } from "./GonTechniqueAnimations";
+export { GON_GUARD_VARIANTS, GON_LOW_GRAPPLING_GUARD, } from "./GonGuardPoses";
+export { GAN_DEFENSIVE_ANGLE_SHIFT, GAN_HIGH_SOLID_GUARD_TRANSITION, GAN_IDLE_ROOTED, GAN_SHORT_ROOT_STEP, GAN_STANCE_ANIMATIONS, } from "./GanStanceAnimations";
+export { GAN_DEFENSIVE_REVERSAL, GAN_ROCK_DEFENSE_ANIMATION, GAN_TECHNIQUE_ANIMATIONS, } from "./GanTechniqueAnimations";
+export { TAE_CIRCULAR_SIDESTEP, TAE_DIAGONAL_CIRCULAR_APPROACH, TAE_FLEXIBLE_GUARD_TRANSITION, TAE_IDLE_FLOWING, TAE_STANCE_ANIMATIONS, } from "./TaeStanceAnimations";
+export { JIN_ANIMATIONS, JIN_IDLE_COILED, JIN_EXPLOSIVE_BURST, JIN_JUMPING_ADVANCE, } from "./JinStanceAnimations";
+export { JIN_TECHNIQUE_ANIMATIONS, JIN_THUNDER_FLASH_ANIMATION, JIN_JUMPING_KNEE_STRIKE, } from "./JinTechniqueAnimations";
+export * from "./ComboAnimations";
+export * from "./DarkOpsAnimations";
+export * from "./ElbowKneeAnimations";
+export * from "./GamRedirectionAnimations";
+export { GAM_IDLE_FLOWING, GAM_YIELDING_SIDESTEP, GAM_FLOWING_RETREAT_STEP, GAM_STANCE_ANIMATIONS, } from "./GamStanceAnimations";
+export { GAM_WATER_FLOW_COUNTER_ANIMATION, GAM_FLOWING_TAKEDOWN, GAM_TECHNIQUE_ANIMATIONS, } from "./GamTechniqueAnimations";
+export * from "./GrapplingAnimations";
+export * from "./KickAnimations";
+export * from "./LiStanceAnimations";
+export * from "./LiTechniqueAnimations";
+export * from "./MovementAnimations";
+export * from "./PunchAnimations";
+export * from "./RecoveryAnimations";
+export * from "./StanceAnimations";
+export * from "./TaeJointLockAnimations";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,36 @@
+import "./StanceGuardPoses.js";
+import "./AttackAnimations.js";
+import "./BasicAnimations.js";
+import "./ComboAnimations.js";
+import "./DarkOpsAnimations.js";
+import "./DefensiveAnimations.js";
+import "./ElbowKneeAnimations.js";
+import "./GrapplingAnimations.js";
+import "./KickAnimations.js";
+import "./MovementAnimations.js";
+import "./PunchAnimations.js";
+import "./LiTechniqueAnimations.js";
+import "./LiStanceAnimations.js";
+import "./JinTechniqueAnimations.js";
+import "./JinStanceAnimations.js";
+import "./StanceAnimations.js";
+import "./StanceAttackAnimations.js";
+import "./StanceIdleAnimations.js";
+import "./StanceLocomotionAnimations.js";
+import "./GamTechniqueAnimations.js";
+import "./GanTechniqueAnimations.js";
+import "./GanStanceAnimations.js";
+import "./GeonStanceAnimations.js";
+import "./TaeJointLockAnimations.js";
+import "./TaeStanceAnimations.js";
+import "./EnhancedAttackAnimations.js";
+import "./EnhancedElbowKneeAnimations.js";
+import "./GamRedirectionAnimations.js";
+import "./StepSkeletalAnimations.js";
+import "./FootworkSkeletalAnimations.js";
+import "./StepAnimations.js";
+import "./GonTechniqueAnimations.js";
+import "./GonStanceAnimations.js";
+import "./GonGuardPoses.js";
+import "./GamStanceAnimations.js";
+import "./RecoveryAnimations.js";

package/lib/systems/animation/constants/AnatomicalLimits.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Anatomical Limits Constants
+ *
+ * Centralized biomechanical safety limits for Korean martial arts animations.
+ * These constants document safe physiological ranges for joint movements,
+ * validated by Korean martial arts experts and biomechanical research.
+ *
+ * **Korean Martial Arts Context:**
+ * - 한국 무술 생체역학 안전 기준 (Korean Martial Arts Biomechanical Safety Standards)
+ * - 관절 안전 범위 (Joint Safety Ranges)
+ * - 실전 기술 적용 (Practical Technique Application)
+ *
+ * **Purpose:**
+ * These limits serve as reference documentation and inform animation design
+ * to ensure realistic, safe joint mechanics. Actual animations are designed
+ * to stay well within these limits through authentic martial arts biomechanics.
+ *
+ * **Note:** All values are in radians for Three.js compatibility.
+ * Convert degrees to radians: degrees * (π / 180)
+ *
+ * @module systems/animation/constants
+ * @category Animation Constants
+ * @korean 생체역학안전상수
+ */
+/**
+ * Anatomical Limits for Joint Rotations
+ *
+ * Comprehensive set of safe physiological ranges for all major joints
+ * used in Korean martial arts movements.
+ */
+export declare const ANATOMICAL_LIMITS: {
+    /**
+     * Shoulder Joint Limits (어깨 관절)
+     */
+    readonly SHOULDER: {
+        /**
+         * Maximum safe shoulder overhead rotation: -135° (-2.35 radians)
+         *
+         * Shoulder flexion limit is approximately 150-180°, making -135° a safe
+         * threshold for dramatic overhead positioning (used in Geon/Heaven stance)
+         * without risking constraint violations.
+         *
+         * **Used in:** Geon (건) overhead strikes, powerful techniques
+         */
+        readonly MAX_OVERHEAD: -2.35;
+        /**
+         * Maximum safe shoulder rotation: ±90° (±1.57 radians)
+         *
+         * Safe shoulder rotation range for circular movements without risking
+         * impingement or constraint violations (used in Tae/Lake, Son/Wind stances).
+         *
+         * **Used in:** Tae (태) circular motions, Son (손) continuous attacks
+         */
+        readonly MAX_ROTATION: 1.57;
+        /**
+         * Maximum safe shoulder elevation: -35° (-0.61 radians)
+         *
+         * Conservative shoulder elevation for defensive positions
+         * (used in Gan/Mountain guard stance).
+         *
+         * **Used in:** Gan (간) defensive guard positioning
+         */
+        readonly MAX_ELEVATION: -0.61;
+    };
+    /**
+     * Elbow Joint Limits (팔꿈치 관절)
+     */
+    readonly ELBOW: {
+        /**
+         * Maximum safe elbow bend: ±125° (±2.18 radians)
+         *
+         * Typical elbow flexion limit is 145-160°, making 125° a conservative
+         * threshold for powerful chambering positions (used in Geon/Heaven strikes).
+         *
+         * **Used in:** Geon (건) powerful overhead chambering
+         */
+        readonly MAX_BEND: 2.18;
+        /**
+         * Maximum safe elbow flexion: 145° (2.53 radians)
+         *
+         * Full elbow flexion for natural guard positions and joint manipulation
+         * techniques (used in Tae/Lake, Son/Wind stances).
+         *
+         * **Used in:** Tae (태) joint locks, Son (손) guard positions
+         */
+        readonly MAX_FLEXION: 2.53;
+        /**
+         * Maximum safe elbow bend for guard: 120° (2.09 radians)
+         *
+         * Conservative elbow flexion for defensive guard positions
+         * (used in Gan/Mountain defensive stance).
+         *
+         * **Used in:** Gan (간) defensive guard
+         */
+        readonly MAX_BEND_GUARD: 2.09;
+    };
+    /**
+     * Wrist Joint Limits (손목 관절)
+     */
+    readonly WRIST: {
+        /**
+         * Maximum safe wrist flexion/extension: ±70° (±1.22 radians)
+         *
+         * Typical wrist range is 70-90° flexion/extension. We use 70° as a safe
+         * threshold for joint lock techniques (used in Tae/Lake Hapkido techniques).
+         *
+         * **Used in:** Tae (태) wrist locks and joint manipulation
+         */
+        readonly MAX_BEND: 1.22;
+    };
+    /**
+     * Hip Joint Limits (엉덩이 관절)
+     */
+    readonly HIP: {
+        /**
+         * Maximum safe hip flexion: 110° (1.92 radians)
+         *
+         * Hip flexion for ground techniques and takedowns
+         * (used in Gon/Earth ground control stance).
+         *
+         * **Used in:** Gon (곤) ground techniques, throws
+         */
+        readonly MAX_FLEXION: 1.92;
+        /**
+         * Maximum safe hip rotation: ±70° (±1.22 radians)
+         *
+         * Safe hip rotation range for continuous flowing movements
+         * (used in Son/Wind circular attacks).
+         *
+         * **Used in:** Son (손) circular movements, flow techniques
+         */
+        readonly MAX_ROTATION: 1.22;
+    };
+    /**
+     * Knee Joint Limits (무릎 관절)
+     */
+    readonly KNEE: {
+        /**
+         * Maximum safe knee flexion: 90° (1.57 radians)
+         *
+         * Deep horse stance knee bend for explosive power generation
+         * (used in Jin/Thunder explosive stance).
+         *
+         * **Used in:** Jin (진) explosive power generation
+         */
+        readonly MAX_FLEXION: 1.57;
+        /**
+         * Maximum safe knee bend: 130° (2.27 radians)
+         *
+         * Deep knee bend for ground control and takedown positioning
+         * (used in Gon/Earth ground techniques).
+         *
+         * **Used in:** Gon (곤) ground control, low positioning
+         */
+        readonly MAX_BEND: 2.27;
+        /**
+         * Maximum safe knee bend for rooted stance: 25° (0.44 radians)
+         *
+         * Conservative knee bend for defensive rooted positions
+         * (used in Gan/Mountain defensive stance).
+         *
+         * **Used in:** Gan (간) rooted defensive positioning
+         */
+        readonly MAX_BEND_ROOTED: 0.44;
+    };
+    /**
+     * Ankle Joint Limits (발목 관절)
+     */
+    readonly ANKLE: {
+        /**
+         * Maximum safe ankle dorsiflexion: 25° (0.44 radians)
+         *
+         * Heel raising for explosive launch and power generation
+         * (used in Jin/Thunder explosive techniques).
+         *
+         * **Used in:** Jin (진) explosive heel raises
+         */
+        readonly MAX_DORSIFLEXION: 0.44;
+        /**
+         * Maximum safe ankle dorsiflex: 20° (0.35 radians)
+         *
+         * Conservative ankle flexion for ground control positioning
+         * (used in Gon/Earth ground techniques).
+         *
+         * **Used in:** Gon (곤) stable ground positioning
+         */
+        readonly MAX_DORSIFLEX: 0.35;
+    };
+};
+/**
+ * Type-safe access to anatomical limits
+ */
+export type AnatomicalLimits = typeof ANATOMICAL_LIMITS;
+/**
+ * Helper function to get anatomical limit by body part and movement type
+ *
+ * Type-safe function that ensures valid body part and limit type combinations
+ * are used at compile time, catching typos before runtime.
+ *
+ * @param bodyPart - Body part category (SHOULDER, ELBOW, WRIST, HIP, KNEE, ANKLE)
+ * @param limitType - Specific limit type (MAX_BEND, MAX_FLEXION, etc.)
+ * @returns The anatomical limit value in radians
+ *
+ * @example
+ * ```typescript
+ * const maxElbowBend = getAnatomicalLimit('ELBOW', 'MAX_BEND'); // 2.18 radians
+ * ```
+ */
+export declare function getAnatomicalLimit<B extends keyof AnatomicalLimits, L extends keyof AnatomicalLimits[B] & string>(bodyPart: B, limitType: L): AnatomicalLimits[B][L];
+/**
+ * Convert degrees to radians for animation calculations
+ *
+ * @param degrees - Angle in degrees
+ * @returns Angle in radians
+ *
+ * @example
+ * ```typescript
+ * const radians = degreesToRadians(90); // 1.5708 (π/2)
+ * ```
+ */
+export declare function degreesToRadians(degrees: number): number;
+/**
+ * Convert radians to degrees for human-readable output
+ *
+ * @param radians - Angle in radians
+ * @returns Angle in degrees
+ *
+ * @example
+ * ```typescript
+ * const degrees = radiansToDegrees(1.5708); // 90
+ * ```
+ */
+export declare function radiansToDegrees(radians: number): number;
+//# sourceMappingURL=AnatomicalLimits.d.ts.map

package/lib/systems/animation/constants/AnatomicalLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnatomicalLimits.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/constants/AnatomicalLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;IAK5B;;OAEG;;QAED;;;;;;;;WAQG;;QAGH;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;;IAIL;;OAEG;;QAED;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;;IAIL;;OAEG;;QAED;;;;;;;WAOG;;;IAQL;;OAEG;;QAED;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;;IAIL;;OAEG;;QAED;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;;IAIL;;OAEG;;QAED;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;;CAGG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,iBAAiB,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,MAAM,gBAAgB,EAChC,CAAC,SAAS,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,EAE5C,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,CAAC,GACX,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAWxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}