blacktrigram 0.7.2

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

@@ -0,0 +1,1644 @@
+//#region src/systems/animation/builders/MartialArtsConstants.ts
+/**
+* Martial Arts Animation Constants
+*
+* Constants for Korean martial arts animations including hand poses,
+* martial arts stances, kick phases, and punch phases.
+*
+* 한국 무술 애니메이션 상수 모듈
+*
+* @module systems/animation/MartialArtsConstants
+* @category Animation System
+* @korean 무술애니메이션상수
+*/
+/**
+* Hand poses for different strike types
+* 타격 유형별 손 자세
+*
+* Each pose defines rotations for all 19 finger joints (per hand):
+* - thumb_meta, thumb_prox, thumb_dist (3 joints)
+* - index_meta, index_prox, index_inter, index_dist (4 joints)
+* - middle_meta, middle_prox, middle_inter, middle_dist (4 joints)
+* - ring_meta, ring_prox, ring_inter, ring_dist (4 joints)
+* - pinky_meta, pinky_prox, pinky_inter, pinky_dist (4 joints)
+*
+* @korean 손자세
+*/
+var HAND_POSES = {
+	FIST: {
+		thumb_meta: [
+			.3,
+			.5,
+			.2
+		],
+		thumb_prox: [
+			.4,
+			0,
+			0
+		],
+		thumb_dist: [
+			.3,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			1.57,
+			0,
+			0
+		],
+		index_inter: [
+			1.57,
+			0,
+			0
+		],
+		index_dist: [
+			.8,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			1.57,
+			0,
+			0
+		],
+		middle_inter: [
+			1.57,
+			0,
+			0
+		],
+		middle_dist: [
+			.8,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			1.57,
+			0,
+			0
+		],
+		ring_inter: [
+			1.57,
+			0,
+			0
+		],
+		ring_dist: [
+			.8,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			1.57,
+			0,
+			0
+		],
+		pinky_inter: [
+			1.57,
+			0,
+			0
+		],
+		pinky_dist: [
+			.8,
+			0,
+			0
+		]
+	},
+	OPEN_PALM: {
+		thumb_meta: [
+			0,
+			.4,
+			-.3
+		],
+		thumb_prox: [
+			.1,
+			0,
+			0
+		],
+		thumb_dist: [
+			0,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			-.1
+		],
+		index_prox: [
+			0,
+			0,
+			0
+		],
+		index_inter: [
+			0,
+			0,
+			0
+		],
+		index_dist: [
+			0,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			0,
+			0,
+			0
+		],
+		middle_inter: [
+			0,
+			0,
+			0
+		],
+		middle_dist: [
+			0,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			.1
+		],
+		ring_prox: [
+			0,
+			0,
+			0
+		],
+		ring_inter: [
+			0,
+			0,
+			0
+		],
+		ring_dist: [
+			0,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			.2
+		],
+		pinky_prox: [
+			0,
+			0,
+			0
+		],
+		pinky_inter: [
+			0,
+			0,
+			0
+		],
+		pinky_dist: [
+			0,
+			0,
+			0
+		]
+	},
+	SPEAR_HAND: {
+		thumb_meta: [
+			.4,
+			.6,
+			.3
+		],
+		thumb_prox: [
+			.2,
+			0,
+			0
+		],
+		thumb_dist: [
+			.1,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			0,
+			0,
+			0
+		],
+		index_inter: [
+			0,
+			0,
+			0
+		],
+		index_dist: [
+			0,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			0,
+			0,
+			0
+		],
+		middle_inter: [
+			0,
+			0,
+			0
+		],
+		middle_dist: [
+			0,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			0,
+			0,
+			0
+		],
+		ring_inter: [
+			0,
+			0,
+			0
+		],
+		ring_dist: [
+			0,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			0,
+			0,
+			0
+		],
+		pinky_inter: [
+			0,
+			0,
+			0
+		],
+		pinky_dist: [
+			0,
+			0,
+			0
+		]
+	},
+	KNIFE_HAND: {
+		thumb_meta: [
+			.5,
+			.8,
+			.4
+		],
+		thumb_prox: [
+			.4,
+			0,
+			0
+		],
+		thumb_dist: [
+			.2,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			.1,
+			0,
+			0
+		],
+		index_inter: [
+			.05,
+			0,
+			0
+		],
+		index_dist: [
+			0,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			.1,
+			0,
+			0
+		],
+		middle_inter: [
+			.05,
+			0,
+			0
+		],
+		middle_dist: [
+			0,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			.1,
+			0,
+			0
+		],
+		ring_inter: [
+			.05,
+			0,
+			0
+		],
+		ring_dist: [
+			0,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			.1,
+			0,
+			0
+		],
+		pinky_inter: [
+			.05,
+			0,
+			0
+		],
+		pinky_dist: [
+			0,
+			0,
+			0
+		]
+	},
+	HAMMER_FIST: {
+		thumb_meta: [
+			.4,
+			.6,
+			.3
+		],
+		thumb_prox: [
+			.5,
+			0,
+			0
+		],
+		thumb_dist: [
+			.4,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			1.7,
+			0,
+			0
+		],
+		index_inter: [
+			1.7,
+			0,
+			0
+		],
+		index_dist: [
+			1,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			1.7,
+			0,
+			0
+		],
+		middle_inter: [
+			1.7,
+			0,
+			0
+		],
+		middle_dist: [
+			1,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			1.7,
+			0,
+			0
+		],
+		ring_inter: [
+			1.7,
+			0,
+			0
+		],
+		ring_dist: [
+			1,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			1.7,
+			0,
+			0
+		],
+		pinky_inter: [
+			1.7,
+			0,
+			0
+		],
+		pinky_dist: [
+			1,
+			0,
+			0
+		]
+	},
+	BACKFIST: {
+		thumb_meta: [
+			.3,
+			.5,
+			.2
+		],
+		thumb_prox: [
+			.3,
+			0,
+			0
+		],
+		thumb_dist: [
+			.2,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			1.4,
+			0,
+			0
+		],
+		index_inter: [
+			1.4,
+			0,
+			0
+		],
+		index_dist: [
+			.7,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			1.4,
+			0,
+			0
+		],
+		middle_inter: [
+			1.4,
+			0,
+			0
+		],
+		middle_dist: [
+			.7,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			1.4,
+			0,
+			0
+		],
+		ring_inter: [
+			1.4,
+			0,
+			0
+		],
+		ring_dist: [
+			.7,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			1.4,
+			0,
+			0
+		],
+		pinky_inter: [
+			1.4,
+			0,
+			0
+		],
+		pinky_dist: [
+			.7,
+			0,
+			0
+		]
+	},
+	GRAB: {
+		thumb_meta: [
+			.2,
+			.3,
+			.1
+		],
+		thumb_prox: [
+			.3,
+			0,
+			0
+		],
+		thumb_dist: [
+			.2,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			1.2,
+			0,
+			0
+		],
+		index_inter: [
+			1,
+			0,
+			0
+		],
+		index_dist: [
+			.6,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			1.3,
+			0,
+			0
+		],
+		middle_inter: [
+			1.1,
+			0,
+			0
+		],
+		middle_dist: [
+			.7,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			1.3,
+			0,
+			0
+		],
+		ring_inter: [
+			1.1,
+			0,
+			0
+		],
+		ring_dist: [
+			.7,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			1.2,
+			0,
+			0
+		],
+		pinky_inter: [
+			1,
+			0,
+			0
+		],
+		pinky_dist: [
+			.6,
+			0,
+			0
+		]
+	},
+	TWO_FINGER: {
+		thumb_meta: [
+			.4,
+			.6,
+			.3
+		],
+		thumb_prox: [
+			.3,
+			0,
+			0
+		],
+		thumb_dist: [
+			.2,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			-.1
+		],
+		index_prox: [
+			0,
+			0,
+			0
+		],
+		index_inter: [
+			0,
+			0,
+			0
+		],
+		index_dist: [
+			0,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			.1
+		],
+		middle_prox: [
+			0,
+			0,
+			0
+		],
+		middle_inter: [
+			0,
+			0,
+			0
+		],
+		middle_dist: [
+			0,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			1.57,
+			0,
+			0
+		],
+		ring_inter: [
+			1.57,
+			0,
+			0
+		],
+		ring_dist: [
+			.8,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			1.57,
+			0,
+			0
+		],
+		pinky_inter: [
+			1.57,
+			0,
+			0
+		],
+		pinky_dist: [
+			.8,
+			0,
+			0
+		]
+	},
+	RELAXED: {
+		thumb_meta: [
+			.1,
+			.2,
+			.1
+		],
+		thumb_prox: [
+			.1,
+			0,
+			0
+		],
+		thumb_dist: [
+			.05,
+			0,
+			0
+		],
+		index_meta: [
+			0,
+			0,
+			0
+		],
+		index_prox: [
+			.3,
+			0,
+			0
+		],
+		index_inter: [
+			.2,
+			0,
+			0
+		],
+		index_dist: [
+			.1,
+			0,
+			0
+		],
+		middle_meta: [
+			0,
+			0,
+			0
+		],
+		middle_prox: [
+			.35,
+			0,
+			0
+		],
+		middle_inter: [
+			.25,
+			0,
+			0
+		],
+		middle_dist: [
+			.15,
+			0,
+			0
+		],
+		ring_meta: [
+			0,
+			0,
+			0
+		],
+		ring_prox: [
+			.35,
+			0,
+			0
+		],
+		ring_inter: [
+			.25,
+			0,
+			0
+		],
+		ring_dist: [
+			.15,
+			0,
+			0
+		],
+		pinky_meta: [
+			0,
+			0,
+			0
+		],
+		pinky_prox: [
+			.3,
+			0,
+			0
+		],
+		pinky_inter: [
+			.2,
+			0,
+			0
+		],
+		pinky_dist: [
+			.1,
+			0,
+			0
+		]
+	}
+};
+/**
+* Standard martial arts poses used across Korean martial arts
+* 한국 무술의 기본 자세들
+*
+* @korean 기본자세
+*/
+var MARTIAL_POSES = {
+	GUARD: {
+		leftShoulder: [
+			-.6,
+			.4,
+			.3
+		],
+		leftElbow: [
+			0,
+			0,
+			-1.8
+		],
+		rightShoulder: [
+			-.6,
+			-.4,
+			-.3
+		],
+		rightElbow: [
+			0,
+			0,
+			1.8
+		]
+	},
+	HIGH_GUARD: {
+		leftShoulder: [
+			-.9,
+			.3,
+			.4
+		],
+		leftElbow: [
+			0,
+			0,
+			-1.6
+		],
+		rightShoulder: [
+			-.9,
+			-.3,
+			-.4
+		],
+		rightElbow: [
+			0,
+			0,
+			1.6
+		]
+	},
+	CLINCH: {
+		leftShoulder: [
+			.8,
+			0,
+			-.5
+		],
+		leftElbow: [
+			0,
+			0,
+			-1.3
+		],
+		rightShoulder: [
+			.8,
+			0,
+			.5
+		],
+		rightElbow: [
+			0,
+			0,
+			1.3
+		]
+	},
+	GRAPPLE_ENTRY: {
+		leftShoulder: [
+			.4,
+			.6,
+			-.2
+		],
+		leftElbow: [
+			0,
+			0,
+			-1.2
+		],
+		rightShoulder: [
+			.6,
+			-.4,
+			.3
+		],
+		rightElbow: [
+			0,
+			0,
+			.8
+		]
+	},
+	NEUTRAL: {
+		leftShoulder: [
+			0,
+			0,
+			.1
+		],
+		leftElbow: [
+			0,
+			0,
+			-.2
+		],
+		rightShoulder: [
+			0,
+			0,
+			-.1
+		],
+		rightElbow: [
+			0,
+			0,
+			.2
+		]
+	}
+};
+/**
+* Kick phases for proper martial arts execution
+* 발차기 단계별 자세
+*
+* @korean 발차기단계
+*/
+var KICK_PHASES = {
+	CHAMBER: {
+		hip: [
+			1.57,
+			0,
+			0
+		],
+		knee: [
+			-2,
+			0,
+			0
+		],
+		ankle: [
+			0,
+			0,
+			0
+		],
+		supportKnee: [
+			-.25,
+			0,
+			0
+		],
+		pelvis: [
+			-.1,
+			0,
+			0
+		]
+	},
+	EXTENSION: {
+		hip: [
+			1.7,
+			0,
+			0
+		],
+		knee: [
+			-.05,
+			0,
+			0
+		],
+		ankle: [
+			.5,
+			0,
+			0
+		],
+		supportKnee: [
+			-.35,
+			0,
+			0
+		],
+		pelvis: [
+			.15,
+			0,
+			0
+		],
+		pelvisY: -.6
+	},
+	HIGH_PEAK: {
+		hip: [
+			2.5,
+			0,
+			0
+		],
+		knee: [
+			-.1,
+			0,
+			0
+		],
+		ankle: [
+			.6,
+			0,
+			0
+		],
+		supportKnee: [
+			-.35,
+			0,
+			0
+		],
+		pelvis: [
+			-.25,
+			0,
+			0
+		]
+	},
+	ROUNDHOUSE_CHAMBER: {
+		hip: [
+			1.2,
+			0,
+			.8
+		],
+		knee: [
+			-1.5,
+			0,
+			0
+		],
+		pelvisY: -.5,
+		spineY: .3
+	},
+	SIDE_CHAMBER: {
+		hip: [
+			1.3,
+			0,
+			.3
+		],
+		knee: [
+			-1.6,
+			0,
+			0
+		],
+		pelvisY: -1.57,
+		spineY: -1.2,
+		spineLean: .2
+	}
+};
+/**
+* Punch phases for proper striking mechanics with Korean martial arts biomechanics
+* 주먹 단계별 자세 - 한국 무술 생체역학 기반
+*
+* Based on traditional Korean martial arts principles:
+* - 정권지르기 (Jeongkwon Jireugi) - Straight punch with fist rotation
+* - 역권지르기 (Yeokwon Jireugi) - Reverse punch with full hip drive
+* - 당기기 (Dangigi) - Pulling hand (hikite) for power generation
+* - 엉덩이회전 (Eongdeongi Hoejeon) - Hip rotation for maximum power
+* - 어깨비틀기 (Eokkae Biteulgi) - Shoulder torque coordination
+*
+* @korean 주먹단계
+*/
+var PUNCH_PHASES = {
+	CHAMBER: {
+		shoulder: [
+			-.15,
+			0,
+			-.2
+		],
+		elbow: [
+			0,
+			0,
+			-1.57
+		],
+		wrist: [
+			0,
+			0,
+			0
+		],
+		oppositeShoulder: [
+			-.1,
+			0,
+			.2
+		],
+		oppositeElbow: [
+			0,
+			0,
+			1.4
+		],
+		spineY: -.1,
+		pelvisY: -.1
+	},
+	WINDUP: {
+		shoulder: [
+			.3,
+			0,
+			-.3
+		],
+		elbow: [
+			0,
+			0,
+			1.8
+		],
+		spineY: -.15,
+		pelvisY: -.1
+	},
+	EXTENSION: {
+		shoulder: [
+			.25,
+			0,
+			.15
+		],
+		elbow: [
+			0,
+			0,
+			-.09
+		],
+		wrist: [
+			0,
+			0,
+			.2
+		],
+		oppositeShoulder: [
+			-.2,
+			0,
+			-.3
+		],
+		oppositeElbow: [
+			0,
+			0,
+			1.1
+		],
+		spineY: .4,
+		pelvisY: .25
+	},
+	PEAK: {
+		shoulder: [
+			.25,
+			0,
+			.15
+		],
+		elbow: [
+			0,
+			0,
+			-.05
+		],
+		wrist: [
+			0,
+			0,
+			.2
+		],
+		oppositeShoulder: [
+			-.2,
+			0,
+			-.3
+		],
+		oppositeElbow: [
+			0,
+			0,
+			1.1
+		],
+		spineY: .45,
+		pelvisY: .3
+	}
+};
+/**
+* Korean Martial Arts Stance Biomechanics
+*
+* Authentic biomechanical configurations for all eight trigram stances (팔괘 자세),
+* based on traditional Korean martial arts (Taekwondo 태권도, Hapkido 합기도, Taekyon 택견).
+*
+* Each stance defines:
+* - frontKneeBend: Front leg knee flexion angle in degrees (무릎굽힘각도)
+* - backKneeBend: Back leg knee flexion angle in degrees (뒷다리무릎각도)
+* - weightDistribution: Front/back weight ratio (체중분배)
+* - stanceWidth: Distance between feet in shoulder widths (발간격)
+* - hipHeight: Hip height relative to standing (0-1 scale) (엉덩이높이)
+* - tacticalRationale: Combat purpose of stance width (전술적 근거)
+*
+* Angle conventions:
+* - 180° = Fully straight leg (완전히 펴진 다리)
+* - 90° = Right angle bend (직각 굽힘)
+* - Lower angles = Deeper bend (낮은 각도 = 더 깊은 굽힘)
+*
+* Weight distribution:
+* - front: 0.6 = 60% weight on front leg (앞발 60% 체중)
+* - back: 0.4 = 40% weight on back leg (뒷발 40% 체중)
+*
+* Stance width tactical purposes:
+* - Wide stances (1.5-2.0x): Stability, power generation, low center of gravity
+* - Medium stances (1.0-1.3x): Balance between mobility and stability
+* - Narrow stances (0.8-1.0x): High mobility, quick footwork
+* - Single leg (0.0x): Maximum mobility, continuous attack capability
+*
+* Sources:
+* - Taekwondo (태권도) - KTA/WTF standard stances
+* - Hapkido (합기도) - Traditional defensive stances
+* - Taekyon (택견) - Korean traditional martial art stances
+*
+* @korean 한국무술자세생체역학
+*/
+var KOREAN_STANCE_BIOMECHANICS = {
+	GEON_HEAVEN: {
+		frontKneeBend: 70,
+		backKneeBend: 160,
+		weightDistribution: {
+			front: .6,
+			back: .4
+		},
+		stanceWidth: 1.35,
+		hipHeight: .85,
+		tacticalRationale: "power_generation"
+	},
+	TAE_LAKE: {
+		frontKneeBend: 170,
+		backKneeBend: 120,
+		weightDistribution: {
+			front: .1,
+			back: .9
+		},
+		stanceWidth: .9,
+		hipHeight: .9,
+		tacticalRationale: "mobility"
+	},
+	LI_FIRE: {
+		frontKneeBend: 135,
+		backKneeBend: 135,
+		weightDistribution: {
+			front: .5,
+			back: .5
+		},
+		stanceWidth: 1.1,
+		hipHeight: .88,
+		tacticalRationale: "balance"
+	},
+	JIN_THUNDER: {
+		frontKneeBend: 90,
+		backKneeBend: 90,
+		weightDistribution: {
+			front: .5,
+			back: .5
+		},
+		stanceWidth: 2,
+		hipHeight: .75,
+		tacticalRationale: "stability"
+	},
+	SON_WIND: {
+		frontKneeBend: 170,
+		backKneeBend: 45,
+		weightDistribution: {
+			front: 1,
+			back: 0
+		},
+		stanceWidth: 0,
+		hipHeight: .92,
+		tacticalRationale: "extreme_mobility"
+	},
+	GAM_WATER: {
+		frontKneeBend: 150,
+		backKneeBend: 100,
+		weightDistribution: {
+			front: .3,
+			back: .7
+		},
+		stanceWidth: 1.15,
+		hipHeight: .82,
+		tacticalRationale: "adaptability"
+	},
+	GAN_MOUNTAIN: {
+		frontKneeBend: 120,
+		backKneeBend: 120,
+		weightDistribution: {
+			front: .4,
+			back: .6
+		},
+		stanceWidth: 1.45,
+		hipHeight: .87,
+		tacticalRationale: "defensive_block"
+	},
+	GON_EARTH: {
+		frontKneeBend: 80,
+		backKneeBend: 80,
+		weightDistribution: {
+			front: .5,
+			back: .5
+		},
+		stanceWidth: 1.8,
+		hipHeight: .72,
+		tacticalRationale: "grounding"
+	}
+};
+/**
+* Animation type identifiers for the animation system
+* @korean 애니메이션타입
+*/
+var AnimationType = /* @__PURE__ */ function(AnimationType) {
+	AnimationType["FRONT_KICK"] = "front_kick";
+	AnimationType["ROUNDHOUSE_KICK"] = "roundhouse_kick";
+	AnimationType["SIDE_KICK"] = "side_kick";
+	AnimationType["AXE_KICK"] = "axe_kick";
+	AnimationType["CRESCENT_KICK"] = "crescent_kick";
+	AnimationType["SPINNING_HOOK"] = "spinning_hook";
+	AnimationType["BACK_KICK"] = "back_kick";
+	AnimationType["PUSH_KICK"] = "push_kick";
+	AnimationType["LOW_KICK"] = "low_kick";
+	AnimationType["KNEE_KICK"] = "knee_kick";
+	AnimationType["FLYING_KICK"] = "flying_kick";
+	AnimationType["TORNADO_KICK"] = "tornado_kick";
+	AnimationType["JUMPING_KICK"] = "jumping_kick";
+	AnimationType["SPINNING_HEEL_KICK"] = "spinning_heel_kick";
+	AnimationType["JAB"] = "jab";
+	AnimationType["CROSS"] = "cross";
+	AnimationType["HOOK"] = "hook";
+	AnimationType["UPPERCUT"] = "uppercut";
+	AnimationType["OVERHAND"] = "overhand";
+	AnimationType["PALM_STRIKE"] = "palm_strike";
+	AnimationType["BACKFIST"] = "backfist";
+	AnimationType["HAMMER_FIST"] = "hammer_fist";
+	AnimationType["SPEAR_HAND_STRIKE"] = "spear_hand_strike";
+	AnimationType["NERVE_STRIKE"] = "nerve_strike";
+	AnimationType["PRESSURE_POINT_STRIKE"] = "pressure_point_strike";
+	AnimationType["LIGHTNING_STRIKE"] = "lightning_strike";
+	AnimationType["RAPID_BARRAGE"] = "rapid_barrage";
+	AnimationType["RHYTHMIC_STRIKES"] = "rhythmic_strikes";
+	AnimationType["NERVE_PARALYSIS"] = "nerve_paralysis";
+	AnimationType["THROAT_STRIKE"] = "throat_strike";
+	AnimationType["EYE_GOUGE"] = "eye_gouge";
+	AnimationType["HEAVEN_STRIKE"] = "heaven_strike";
+	AnimationType["FLOWING_CROSS"] = "flowing_cross";
+	AnimationType["SOLAR_PLEXUS_STRIKE"] = "solar_plexus_strike";
+	AnimationType["FLOWING_PUSH"] = "flowing_push";
+	AnimationType["LIVER_DISRUPTION"] = "liver_disruption";
+	AnimationType["EAR_STRIKE"] = "ear_strike";
+	AnimationType["ELBOW_STRIKE"] = "elbow_strike";
+	AnimationType["KNEE_STRIKE"] = "knee_strike";
+	AnimationType["ELBOW_UPPERCUT"] = "elbow_uppercut";
+	AnimationType["FLYING_KNEE"] = "flying_knee";
+	AnimationType["CLINCH_KNEE"] = "clinch_knee";
+	AnimationType["SPINNING_ELBOW"] = "spinning_elbow";
+	AnimationType["TEMPLE_ELBOW"] = "temple_elbow";
+	AnimationType["SPINNING_BACK_ELBOW"] = "spinning_back_elbow";
+	AnimationType["SPINAL_ELBOW"] = "spinal_elbow";
+	AnimationType["BRACHIAL_ELBOW"] = "brachial_elbow";
+	AnimationType["KIDNEY_KNEE"] = "kidney_knee";
+	AnimationType["FEMORAL_KNEE"] = "femoral_knee";
+	AnimationType["THROW"] = "throw";
+	AnimationType["JOINT_LOCK"] = "joint_lock";
+	AnimationType["TAKEDOWN"] = "takedown";
+	AnimationType["SWEEP"] = "sweep";
+	AnimationType["CLINCH"] = "clinch";
+	AnimationType["GRAPPLE"] = "grapple";
+	AnimationType["SLAM"] = "slam";
+	AnimationType["WRIST_LOCK"] = "wrist_lock";
+	AnimationType["ARM_BAR"] = "arm_bar";
+	AnimationType["SHOULDER_LOCK"] = "shoulder_lock";
+	AnimationType["HIP_THROW"] = "hip_throw";
+	AnimationType["LEG_REAP"] = "leg_reap";
+	AnimationType["SMALL_CIRCLE_LOCK"] = "small_circle_lock";
+	AnimationType["FINGER_LOCK"] = "finger_lock";
+	AnimationType["ELBOW_LOCK"] = "elbow_lock";
+	AnimationType["SHOULDER_MANIPULATION"] = "shoulder_manipulation";
+	AnimationType["MOUNTAIN_LOCK"] = "mountain_lock";
+	AnimationType["EARTH_EMBRACE"] = "earth_embrace";
+	AnimationType["CAROTID_CHOKE"] = "carotid_choke";
+	AnimationType["REAR_NAKED_CHOKE"] = "rear_naked_choke";
+	AnimationType["REDIRECT_THROW"] = "redirect_throw";
+	AnimationType["HIP_WHEEL_THROW"] = "hip_wheel_throw";
+	AnimationType["SSIREUM_THROW"] = "ssireum_throw";
+	AnimationType["SACRIFICE_THROW"] = "sacrifice_throw";
+	AnimationType["ANKLE_PICK"] = "ankle_pick";
+	AnimationType["ACHILLES_ATTACK"] = "achilles_attack";
+	AnimationType["BODY_LOCK_SLAM"] = "body_lock_slam";
+	AnimationType["WRIST_TWIST_COUNTER"] = "wrist_twist_counter";
+	AnimationType["COUNTER_STRIKE"] = "counter_strike";
+	AnimationType["PARRY_COUNTER"] = "parry_counter";
+	AnimationType["COUNTER_ATTACK"] = "counter_attack";
+	AnimationType["WATER_COUNTER"] = "water_counter";
+	AnimationType["ROCK_COUNTER"] = "rock_counter";
+	AnimationType["BLOCK"] = "block";
+	AnimationType["BLOCK_HIGH"] = "block_high";
+	AnimationType["BLOCK_LOW"] = "block_low";
+	AnimationType["PARRY"] = "parry";
+	AnimationType["FLOWING_BLOCK"] = "flowing_block";
+	AnimationType["CIRCULAR_PARRY"] = "circular_parry";
+	AnimationType["ROCK_DEFENSE"] = "rock_defense";
+	AnimationType["IRON_BLOCK"] = "iron_block";
+	AnimationType["FLOW_DEFENSE"] = "flow_defense";
+	AnimationType["IMMOVABLE_BLOCK"] = "immovable_block";
+	AnimationType["EXPLOSIVE_BLOCK"] = "explosive_block";
+	AnimationType["CONTINUOUS_DEFLECTION"] = "continuous_deflection";
+	AnimationType["PRECISION_PARRY"] = "precision_parry";
+	AnimationType["JOINT_LOCK_DEFENSE"] = "joint_lock_defense";
+	AnimationType["SWEEP_DEFENSE"] = "sweep_defense";
+	AnimationType["GROUNDING_DEFENSE"] = "grounding_defense";
+	AnimationType["JAW_DISLOCATION"] = "jaw_dislocation";
+	AnimationType["TEMPLE_STRIKE"] = "temple_strike";
+	AnimationType["CERVICAL_TWIST"] = "cervical_twist";
+	AnimationType["ELBOW_HYPEREXTEND"] = "elbow_hyperextend";
+	AnimationType["FINGER_BREAK"] = "finger_break";
+	AnimationType["GUILLOTINE_CHOKE"] = "guillotine_choke";
+	AnimationType["JUGULAR_STRIKE"] = "jugular_strike";
+	AnimationType["KNEECAP_STRIKE"] = "kneecap_strike";
+	AnimationType["LARYNX_CRUSH"] = "larynx_crush";
+	AnimationType["OCCIPITAL_STRIKE"] = "occipital_strike";
+	AnimationType["SCIATIC_NERVE_STRIKE"] = "sciatic_nerve_strike";
+	AnimationType["SILENT_TAKEDOWN"] = "silent_takedown";
+	AnimationType["SLEEPER_HOLD"] = "sleeper_hold";
+	AnimationType["SPLEEN_RUPTURE"] = "spleen_rupture";
+	AnimationType["TRIANGLE_CHOKE"] = "triangle_choke";
+	AnimationType["BRACHIAL_PLEXUS"] = "brachial_plexus";
+	AnimationType["FEMORAL_NERVE"] = "femoral_nerve";
+	AnimationType["GEON_HEAVEN_STRIKE"] = "geon_heaven_strike";
+	AnimationType["HIGH_BLOCK"] = "high_block";
+	AnimationType["CRUSHING_ELBOW"] = "crushing_elbow";
+	AnimationType["THUNDEROUS_UPPERCUT"] = "thunderous_uppercut";
+	AnimationType["GEON_COUNTER"] = "geon_counter";
+	AnimationType["GEON_ROUNDHOUSE"] = "geon_roundhouse";
+	AnimationType["FLOWING_ARM_BAR"] = "flowing_arm_bar";
+	AnimationType["SPIRAL_SHOULDER_THROW"] = "spiral_shoulder_throw";
+	AnimationType["WRIST_LOCK_STRIKE"] = "wrist_lock_strike";
+	AnimationType["PHOENIX_EYE_STRIKE"] = "phoenix_eye_strike";
+	AnimationType["NERVE_STRIKE_COUNTER"] = "nerve_strike_counter";
+	AnimationType["SOLAR_PLEXUS_SPEAR"] = "solar_plexus_spear";
+	AnimationType["LI_SOLAR_PLEXUS"] = "li_solar_plexus";
+	AnimationType["EXPLOSIVE_KNEE"] = "explosive_knee";
+	AnimationType["LIGHTNING_STRAIGHT"] = "lightning_straight";
+	AnimationType["SHOCKING_COUNTER"] = "shocking_counter";
+	AnimationType["SHOCKING_HAMMER_FIST"] = "shocking_hammer_fist";
+	AnimationType["PENETRATING_PALM_RUSH"] = "penetrating_palm_rush";
+	AnimationType["PRESSURE_COUNTER"] = "pressure_counter";
+	AnimationType["PRESSURE_POINT_CHAIN"] = "pressure_point_chain";
+	AnimationType["FLOWING_RIVER_STRIKE"] = "flowing_river_strike";
+	AnimationType["REDIRECTION_COUNTER"] = "redirection_counter";
+	AnimationType["TIDAL_WAVE_PALM"] = "tidal_wave_palm";
+	AnimationType["WHIRLPOOL_COUNTER"] = "whirlpool_counter";
+	AnimationType["AVALANCHE_HAMMER"] = "avalanche_hammer";
+	AnimationType["COUNTER_FORTRESS"] = "counter_fortress";
+	AnimationType["FORTRESS_COUNTER_STRIKE"] = "fortress_counter_strike";
+	AnimationType["STONE_WALL_THRUST"] = "stone_wall_thrust";
+	AnimationType["EARTHQUAKE_STOMP"] = "earthquake_stomp";
+	AnimationType["GROUND_SWEEP_STRIKE"] = "ground_sweep_strike";
+	AnimationType["ROOTING_TAKEDOWN"] = "rooting_takedown";
+	AnimationType["TAKEDOWN_COUNTER"] = "takedown_counter";
+	AnimationType["GEON_HEAVENLY_FIST"] = "geon_heavenly_fist";
+	AnimationType["GEON_FRONTAL_KICK"] = "geon_frontal_kick";
+	AnimationType["GEON_PALM_STRIKE"] = "geon_palm_strike";
+	AnimationType["GAN_ROCK_DEFENSE_BLOCK"] = "gan_rock_defense_block";
+	AnimationType["GAN_IMMOVABLE_STANCE"] = "gan_immovable_stance";
+	AnimationType["GAN_COUNTER_STRIKE"] = "gan_counter_strike";
+	AnimationType["GAN_REVERSAL_TECHNIQUE"] = "gan_reversal_technique";
+	AnimationType["GAN_MOUNTAIN_STANCE_LOCK"] = "gan_mountain_stance_lock";
+	AnimationType["GAM_CIRCULAR_PARRY"] = "gam_circular_parry";
+	AnimationType["GAM_REDIRECT_THROW"] = "gam_redirect_throw";
+	AnimationType["GAM_HIP_THROW"] = "gam_hip_throw";
+	AnimationType["GON_EARTH_EMBRACE"] = "gon_earth_embrace";
+	AnimationType["GON_ANKLE_PICK"] = "gon_ankle_pick";
+	AnimationType["GON_BODY_LOCK_TAKEDOWN"] = "gon_body_lock_takedown";
+	AnimationType["GON_SSIREUM_THROW"] = "gon_ssireum_throw";
+	AnimationType["GON_SACRIFICE_THROW"] = "gon_sacrifice_throw";
+	AnimationType["SON_RHYTHMIC_STRIKES"] = "son_rhythmic_strikes";
+	AnimationType["SON_FLOWING_PUSH"] = "son_flowing_push";
+	AnimationType["SON_RAPID_FOOTWORK"] = "son_rapid_footwork";
+	AnimationType["JIN_JUMPING_FRONT_KICK"] = "jin_jumping_front_kick";
+	AnimationType["JIN_FLYING_SIDEKICK"] = "jin_flying_sidekick";
+	AnimationType["TAE_WRIST_LOCK"] = "tae_wrist_lock";
+	AnimationType["GAM_WRIST_TWIST_COUNTER"] = "gam_wrist_twist_counter";
+	AnimationType["SON_SWEEPING_LOW_KICK"] = "son_sweeping_low_kick";
+	AnimationType["GON_LEG_SWEEP"] = "gon_leg_sweep";
+	AnimationType["DRAGON_FIST"] = "dragon_fist";
+	AnimationType["IRON_DEFENSE"] = "iron_defense";
+	AnimationType["MOUNTAIN_BREAKER"] = "mountain_breaker";
+	AnimationType["THUNDER_STRIKE"] = "thunder_strike";
+	AnimationType["DEADLY_PRECISION"] = "deadly_precision";
+	AnimationType["SHADOW_NERVE_STRIKE"] = "shadow_nerve_strike";
+	AnimationType["SHADOW_STRIKE"] = "shadow_strike";
+	AnimationType["SILENT_DEATH"] = "silent_death";
+	AnimationType["CYBER_OVERDRIVE"] = "cyber_overdrive";
+	AnimationType["DATA_STRIKE"] = "data_strike";
+	AnimationType["ELECTRIC_SHOCK"] = "electric_shock";
+	AnimationType["SYSTEM_CRASH"] = "system_crash";
+	AnimationType["COUNTER_INTELLIGENCE"] = "counter_intelligence";
+	AnimationType["INTELLIGENCE_STRIKE"] = "intelligence_strike";
+	AnimationType["PSYCHOLOGICAL_WARFARE"] = "psychological_warfare";
+	AnimationType["TACTICAL_STRIKE"] = "tactical_strike";
+	AnimationType["BRUTAL_TAKEDOWN"] = "brutal_takedown";
+	AnimationType["IMPROVISED_WEAPON"] = "improvised_weapon";
+	AnimationType["RUTHLESS_ASSAULT"] = "ruthless_assault";
+	AnimationType["STREET_BRAWL"] = "street_brawl";
+	AnimationType["STEP_FORWARD"] = "step_forward";
+	AnimationType["STEP_BACK"] = "step_back";
+	AnimationType["SIDESTEP"] = "sidestep";
+	AnimationType["PIVOT"] = "pivot";
+	AnimationType["DUCK"] = "duck";
+	AnimationType["LEAN"] = "lean";
+	AnimationType["WALK"] = "walk";
+	AnimationType["IDLE_STANCE"] = "idle_stance";
+	AnimationType["FORWARD_DASH"] = "forward_dash";
+	AnimationType["BACKWARD_RETREAT"] = "backward_retreat";
+	AnimationType["SIDE_STEP"] = "side_step";
+	AnimationType["RAPID_FOOTWORK"] = "rapid_footwork";
+	AnimationType["RECOVERY"] = "recovery";
+	AnimationType["IDLE"] = "idle";
+	AnimationType["STANCE"] = "stance";
+	return AnimationType;
+}({});
+/**
+* Calculate lateral stance width in world units (meters)
+*
+* Converts stance width from shoulder width multipliers to actual
+* world-space distance for foot positioning in 3D space.
+*
+* Formula: stanceWidth (m) = shoulderWidth (cm) * multiplier / 100
+*
+* Example:
+* - shoulderWidth: 46 cm (Musa archetype)
+* - Jin Thunder stance: 2.0x shoulder width
+* - Result: 46 * 2.0 / 100 = 0.92m lateral distance between feet
+*
+* @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS (e.g., 1.5 for Jin)
+* @param shoulderWidth - Fighter's shoulder width in centimeters (from physical attributes)
+* @returns Stance width in meters for 3D world positioning
+*
+* @korean 자세너비계산
+*/
+function calculateStanceWidth(stanceWidthMultiplier, shoulderWidth) {
+	return shoulderWidth * stanceWidthMultiplier / 100;
+}
+/**
+* Calculate foot X positions for left and right feet based on stance width
+*
+* Returns X-axis offsets for positioning FOOT_L and FOOT_R bones.
+* Assumes center point (pelvis) is at X=0.
+*
+* @param stanceWidthMultiplier - Multiplier from KOREAN_STANCE_BIOMECHANICS
+* @param shoulderWidth - Fighter's shoulder width in centimeters
+* @returns Object with leftFootX (negative) and rightFootX (positive) positions
+*
+* @example
+* // Jin Thunder stance (2.0x) for Musa (46cm shoulders)
+* const footPositions = calculateFootPositions(2.0, 46);
+* // Returns: { leftFootX: -0.46, rightFootX: 0.46 }
+*
+* @korean 발위치계산
+*/
+function calculateFootPositions(stanceWidthMultiplier, shoulderWidth) {
+	const halfWidth = calculateStanceWidth(stanceWidthMultiplier, shoulderWidth) / 2;
+	return {
+		leftFootX: -halfWidth,
+		rightFootX: halfWidth
+	};
+}
+//#endregion
+export { AnimationType, HAND_POSES, KICK_PHASES, KOREAN_STANCE_BIOMECHANICS, MARTIAL_POSES, PUNCH_PHASES, calculateFootPositions, calculateStanceWidth };
+
+//# sourceMappingURL=MartialArtsConstants.js.map