blacktrigram 0.7.2

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

@@ -0,0 +1,655 @@
+import { TrigramStance } from "../../../types/common.js";
+import { mirrorGuardPose } from "../../../types/skeletal.js";
+import * as THREE from "three";
+//#region src/systems/animation/catalogs/StanceGuardPoses.ts
+/**
+* Fighting Stance Guard Poses for Eight Trigram System
+*
+* Defines default guard positions for all 8 trigram stances (팔괘).
+* Each guard pose includes arm positions, torso rotation, weight distribution,
+* and breathing animation parameters for authentic Korean martial arts stance representation.
+*
+* Based on COMBAT_ARCHITECTURE.md and game-design.md specifications:
+* - ☰ 건 (Geon/Heaven): High guard with strong forward presence
+* - ☱ 태 (Tae/Lake): Fluid mid-guard with adaptive positioning
+* - ☲ 리 (Li/Fire): Aggressive forward guard
+* - ☳ 진 (Jin/Thunder): Explosive ready stance
+* - ☴ 손 (Son/Wind): Continuous motion guard
+* - ☵ 감 (Gam/Water): Flowing defensive guard
+* - ☶ 간 (Gan/Mountain): Solid defensive posture
+* - ☷ 곤 (Gon/Earth): Grounded low guard
+*
+* @module systems/animation/StanceGuardPoses
+* @category Animation
+* @korean 자세방어포즈
+*/
+/**
+* ☰ 건 (Geon) - Heaven: Taekwondo Power Striking Stance
+*
+* **Korean Name**: 건괘 - 하늘 (Geon-gwae - Haneul)
+* **Martial Art**: Taekwondo (태권도) Ap Seogi (앞서기) - Forward Walking Stance
+* **Philosophy**: Direct yang force, overwhelming power, heaven's authority descending
+*
+* **Authentic Taekwondo Ap Seogi Characteristics**:
+* - 앞서기 (Ap Seogi): Classic forward stance for aggressive advance
+* - Front leg bent ~70°, back leg extended ~160° for explosive forward power
+* - 70/30 weight distribution forward for constant pressure
+* - High chamber position (높은 준비) ready for 돌려차기 (Dollyo Chagi - roundhouse kick)
+* - Hands at chin level in Juchum Seogi guard (주춤서기 방어)
+* - Tight elbows protect floating ribs (늑골 보호)
+*
+* **Biomechanical Analysis**:
+* - Front knee over toes creates spring-loaded power platform
+* - Back leg straight provides driving force for forward strikes
+* - Shoulder alignment allows maximum power transfer to fists
+* - Hip rotation ~30° creates torque for bone-breaking punches (골절타격)
+*
+* **Combat Applications**:
+* - 정권지르기 (Jeongwon Jireugi): Straight punch to solar plexus
+* - 앞차기 (Ap Chagi): Front snap kick to abdomen/chin
+* - 돌려차기 (Dollyo Chagi): Roundhouse kick from high chamber
+* - Direct frontal bone-breaking strikes (+10% damage to skeletal targets)
+* - High mobility (+15% movement speed for aggressive advance)
+*
+* @korean 건괘방어포즈
+*/
+var GEON_HIGH_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.9, .3, .6),
+		elbow: new THREE.Euler(0, 0, -2.3),
+		wrist: new THREE.Euler(.2, .15, 0)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-1, -.2, -.5),
+		elbow: new THREE.Euler(0, 0, 2.4),
+		wrist: new THREE.Euler(.3, -.1, 0)
+	},
+	torso: new THREE.Euler(.12, -.35, .05),
+	leftLeg: {
+		hip: new THREE.Euler(-.15, .2, .08),
+		knee: new THREE.Euler(.35, 0, 0),
+		ankle: new THREE.Euler(-.08, .05, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.55, -.18, -.05),
+		knee: new THREE.Euler(1.22, 0, 0),
+		ankle: new THREE.Euler(-.12, -.05, 0)
+	},
+	pelvis: new THREE.Euler(.18, -.45, .03),
+	stanceWidth: .55,
+	stanceDepth: .65,
+	pelvisHeight: -.14,
+	weight: "forward",
+	breathingRange: {
+		min: .98,
+		max: 1.025
+	}
+};
+/**
+* ☱ 태 (Tae) - Lake: Hapkido Fluid Grappling Stance
+*
+* **Korean Name**: 태괘 - 호수 (Tae-gwae - Hosu)
+* **Martial Art**: Hapkido (합기도) Beom Seogi (범서기) - Tiger Stance / Cat Stance
+* **Philosophy**: Yin softness, adaptive water, circular redirection, lake's receptive surface
+*
+* **Authentic Hapkido Beom Seogi Characteristics**:
+* - 범서기 (Beom Seogi): Cat stance with 90% weight on back leg
+* - Front leg light (170° nearly straight) ready to sweep or evade
+* - Back leg deeply bent (120°) like coiled spring for explosive throws
+* - 팔목잡기 (Palmok Japgi): Wrist grab readiness with open palms
+* - Lead hand extended for 원형막기 (Wonhyeong Makgi - circular block)
+* - Rear hand chambered at solar plexus for 관절기 (Gwanjeolgi - joint locks)
+*
+* **Biomechanical Analysis**:
+* - Back-weighted allows front leg to lift instantly for sweeps (발걸기)
+* - Open palms enable rapid grip transitions for joint manipulation
+* - Low center of gravity provides stability for throws (던지기)
+* - Hip mobility allows 360° rotation for redirection techniques
+*
+* **Combat Applications**:
+* - 손목꺾기 (Sonmok-kkeokgi): Wrist twist throw (Kote Gaeshi)
+* - 팔굽관절기 (Palgup Gwanjeolgi): Elbow joint lock
+* - 발등걸기 (Baldeung Geolgi): Foot sweep with ankle hook
+* - Joint locks and circular throws (+15% throw range)
+* - Small circle joint manipulation (+10% joint lock damage)
+*
+* @korean 태괘방어포즈
+*/
+var TAE_FLUID_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.65, .5, .4),
+		elbow: new THREE.Euler(0, 0, -1.9),
+		wrist: new THREE.Euler(-.15, .35, .25)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-.8, -.15, -.3),
+		elbow: new THREE.Euler(0, 0, 2.1),
+		wrist: new THREE.Euler(.1, -.25, .15)
+	},
+	torso: new THREE.Euler(.08, -.55, .08),
+	leftLeg: {
+		hip: new THREE.Euler(.12, .25, .05),
+		knee: new THREE.Euler(.18, 0, 0),
+		ankle: new THREE.Euler(-.06, .08, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(-.22, -.3, .05),
+		knee: new THREE.Euler(1.05, 0, 0),
+		ankle: new THREE.Euler(-.18, .02, 0)
+	},
+	pelvis: new THREE.Euler(.08, -.65, .04),
+	stanceWidth: .38,
+	stanceDepth: .42,
+	pelvisHeight: -.11,
+	weight: "back",
+	breathingRange: {
+		min: .975,
+		max: 1.025
+	}
+};
+/**
+* ☲ 리 (Li) - Fire: Kuk Sool Won Precision Strike Stance
+*
+* **Korean Name**: 리괘 - 불 (Li-gwae - Bul)
+* **Martial Art**: Kuk Sool Won (국술원) / Taekwondo Gyeorugi Junbi (겨루기 준비) - Fighting Ready Stance
+* **Philosophy**: Yang penetration, laser focus, burning precision, fire's consuming accuracy
+*
+* **Authentic Gyeorugi Junbi Characteristics**:
+* - 겨루기 준비 (Gyeorugi Junbi): Olympic sparring ready position
+* - Balanced 50/50 weight distribution for rapid direction changes
+* - Both knees bent ~135° for explosive spring in any direction
+* - 피카부 가드 (Peekaboo Guard): High tight hands protecting face
+* - Elbows flared wide like wings (날개) for maximum head protection
+* - Fists literally glued to temples/cheekbones (관자놀이)
+*
+* **Biomechanical Analysis**:
+* - Square stance allows equal power generation both sides
+* - High guard creates narrow target profile (minimal exposure)
+* - Deep knee bend provides explosive movement in 8 directions
+* - Tight fists to temples allow instant peek-and-strike
+*
+* **Combat Applications**:
+* - 혈도공격 (Hyeoldo Gonggyeok): Precise vital point strikes
+* - 급소타격 (Geupso Tagyeok): Pressure point penetration
+* - 관자놀이 타격 (Gwanjari Tagyeok): Temple strike from peek
+* - Precision nerve strikes (+15% critical hit chance)
+* - Vital point targeting accuracy (+10% vital point damage)
+*
+* @korean 리괘방어포즈
+*/
+var LI_FIRE_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-1.65, .25, 1),
+		elbow: new THREE.Euler(0, 0, -2.5),
+		wrist: new THREE.Euler(.45, .2, .05)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-1.65, -.25, -1),
+		elbow: new THREE.Euler(0, 0, 2.5),
+		wrist: new THREE.Euler(.45, -.2, -.05)
+	},
+	torso: new THREE.Euler(.18, 0, 0),
+	leftLeg: {
+		hip: new THREE.Euler(.22, .32, .18),
+		knee: new THREE.Euler(.79, 0, 0),
+		ankle: new THREE.Euler(-.14, .12, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.22, -.32, -.18),
+		knee: new THREE.Euler(.79, 0, 0),
+		ankle: new THREE.Euler(-.14, -.12, 0)
+	},
+	pelvis: new THREE.Euler(.12, 0, 0),
+	stanceWidth: .48,
+	stanceDepth: .28,
+	pelvisHeight: -.13,
+	weight: "neutral",
+	breathingRange: {
+		min: .99,
+		max: 1.01
+	}
+};
+/**
+* ☳ 진 (Jin) - Thunder: Taekwondo Explosive Power Stance
+*
+* **Korean Name**: 진괘 - 천둥 (Jin-gwae - Cheondeung)
+* **Martial Art**: Taekwondo (태권도) Juchum Seogi (주춤서기) - Horse Riding Stance
+* **Philosophy**: Extreme yang, shocking power, thunder's instant discharge, explosive release
+*
+* **Authentic Juchum Seogi Characteristics**:
+* - 주춤서기 (Juchum Seogi): Classic horse stance - VERY WIDE and VERY LOW
+* - 2.0x shoulder width stance (~80-90cm) with parallel feet
+* - Both knees bent to 90° (수평 허벅지) - thighs parallel to ground
+* - 50/50 perfect weight distribution for explosive power either direction
+* - Arms chambered low (낮은 준비) - coiled spring ready to explode
+* - Lead arm extended but tight, rear fist at ribs ready to thunder strike
+*
+* **Biomechanical Analysis**:
+* - Ultra-wide stance creates maximum stability platform
+* - 90° knee bend stores enormous elastic energy in quadriceps
+* - Low center of gravity allows explosive upward/lateral movement
+* - Parallel feet enable instant pivot and rotation
+*
+* **Combat Applications**:
+* - 뇌성타격 (Noeseong Tagyeok): Thunder strike to nerve clusters
+* - 신경충격파 (Singyeong Chunggyeokpa): Shocking nerve disruption
+* - 폭발적 주먹지르기 (Pokbaljeok Jumeok Jireugi): Explosive power punch
+* - Nerve strike warfare (+15% shock damage on nerve points)
+* - Stunning power (-30 consciousness on head impacts)
+*
+* @korean 진괘방어포즈
+*/
+var JIN_THUNDER_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.55, .25, .65),
+		elbow: new THREE.Euler(0, 0, -2.3),
+		wrist: new THREE.Euler(.35, .12, 0)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-.65, -.18, -.4),
+		elbow: new THREE.Euler(0, 0, 2.45),
+		wrist: new THREE.Euler(.4, -.08, 0)
+	},
+	torso: new THREE.Euler(-.05, -.38, .06),
+	leftLeg: {
+		hip: new THREE.Euler(.32, .52, .35),
+		knee: new THREE.Euler(1.57, 0, 0),
+		ankle: new THREE.Euler(-.28, .22, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.32, -.52, -.35),
+		knee: new THREE.Euler(1.57, 0, 0),
+		ankle: new THREE.Euler(-.28, -.22, 0)
+	},
+	pelvis: new THREE.Euler(.08, 0, 0),
+	stanceWidth: .95,
+	stanceDepth: 0,
+	pelvisHeight: -.28,
+	weight: "neutral",
+	breathingRange: {
+		min: .96,
+		max: 1.045
+	}
+};
+/**
+* ☴ 손 (Son) - Wind: Taekyon Continuous Flow Stance
+*
+* **Korean Name**: 손괘 - 바람 (Son-gwae - Baram)
+* **Martial Art**: Taekyon (택견) Hakdari Seogi (학다리서기) - Crane Stance
+* **Philosophy**: Gentle yin, persistent wind, flowing rhythm, continuous pressure
+*
+* **Authentic Hakdari Seogi Characteristics**:
+* - 학다리서기 (Hakdari Seogi): Traditional Korean crane stance - ONE LEG RAISED
+* - Standing leg nearly straight (170°) with perfect balance
+* - Raised leg bent deeply (knee at waist level, 45° thigh angle)
+* - 100% weight on standing leg - ready to kick with raised leg instantly
+* - Arms in flowing 품밟기 (Pumbalbgi) motion - continuous circular movement
+* - Lead knife hand extended for 손날막기 (Sonnal Makgi - knife hand block)
+*
+* **Biomechanical Analysis**:
+* - Single leg stance enables instant kick without telegraphing
+* - High knee chamber provides explosive kick power
+* - Flowing arm position creates deceptive continuous motion
+* - Perfect balance allows rapid direction changes
+*
+* **Combat Applications**:
+* - 연속발차기 (Yeonsok Balchagi): Continuous kicking combinations
+* - 품밟기 리듬 (Pumbalbgi Rhythm): Rhythmic pressure sequences
+* - 발걸이 (Balgeori): Sweeping techniques from raised leg
+* - Continuous pressure strikes (+10% chaining speed)
+* - Lateral movement advantage (+10% lateral mobility)
+*
+* @korean 손괘방어포즈
+*/
+var SON_WIND_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.68, .48, .35),
+		elbow: new THREE.Euler(0, 0, -1.85),
+		wrist: new THREE.Euler(-.08, .32, .25)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-.95, -.18, -.45),
+		elbow: new THREE.Euler(0, 0, 2.15),
+		wrist: new THREE.Euler(.18, -.22, .08)
+	},
+	torso: new THREE.Euler(.06, -.52, .12),
+	leftLeg: {
+		hip: new THREE.Euler(1.3, .35, .25),
+		knee: new THREE.Euler(2.1, 0, 0),
+		ankle: new THREE.Euler(-.45, .28, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.08, -.18, 0),
+		knee: new THREE.Euler(.18, 0, 0),
+		ankle: new THREE.Euler(-.09, 0, 0)
+	},
+	pelvis: new THREE.Euler(.04, -.58, .08),
+	stanceWidth: 0,
+	stanceDepth: .18,
+	pelvisHeight: -.06,
+	weight: "neutral",
+	breathingRange: {
+		min: .985,
+		max: 1.018
+	}
+};
+/**
+* ☵ 감 (Gam) - Water: Hapkido Defensive Counter Stance
+*
+* **Korean Name**: 감괘 - 물 (Gam-gwae - Mul)
+* **Martial Art**: Hapkido (합기도) Dwitbal Seogi (뒷발서기) - Back Weighted Stance
+* **Philosophy**: Yin reception, adaptive flow, water's yielding redirection, counter force
+*
+* **Authentic Dwitbal Seogi Characteristics**:
+* - 뒷발서기 (Dwitbal Seogi): Defensive back stance with 70% weight on rear leg
+* - Front leg extended nearly straight (160°) for defensive distance
+* - Back leg deeply bent (100°) coiled for explosive counter
+* - Both palms open (손바닥) mid-level for 막기 (Makgi - blocking/deflection)
+* - Tight elbows protect ribs while ready to redirect force
+* - Bladed profile (칼날 자세) minimizes target area
+*
+* **Biomechanical Analysis**:
+* - Back-weighted provides safety distance from opponent
+* - Extended front leg acts as range-finder and tripwire
+* - Deep rear leg stores elastic energy for counter explosion
+* - Open palms enable instant grip and redirection
+*
+* **Combat Applications**:
+* - 막고반격 (Makgo Bangyeok): Block-and-counter sequences
+* - 원형막기 (Wonhyeong Makgi): Circular deflection techniques
+* - 흘려치기 (Heullyeo Chigi): Flow-redirect strikes
+* - Adaptive counters (+10% counter speed)
+* - Rib damage amplification (+15 bleed on rib shots from counters)
+*
+* @korean 감괘방어포즈
+*/
+var GAM_WATER_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.75, .32, .42),
+		elbow: new THREE.Euler(0, 0, -2.05),
+		wrist: new THREE.Euler(-.12, .35, .32)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-.78, -.28, -.38),
+		elbow: new THREE.Euler(0, 0, 2.08),
+		wrist: new THREE.Euler(-.09, -.32, -.28)
+	},
+	torso: new THREE.Euler(.09, -.42, .11),
+	leftLeg: {
+		hip: new THREE.Euler(.16, .22, .04),
+		knee: new THREE.Euler(.35, 0, 0),
+		ankle: new THREE.Euler(-.07, .03, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(-.28, -.25, .03),
+		knee: new THREE.Euler(1.4, 0, 0),
+		ankle: new THREE.Euler(-.22, .02, 0)
+	},
+	pelvis: new THREE.Euler(.06, -.45, .06),
+	stanceWidth: .52,
+	stanceDepth: .48,
+	pelvisHeight: -.13,
+	weight: "back",
+	breathingRange: {
+		min: .975,
+		max: 1.028
+	}
+};
+/**
+* ☶ 간 (Gan) - Mountain: Taekwondo Immovable Defense Stance
+*
+* **Korean Name**: 간괘 - 산 (Gan-gwae - San)
+* **Martial Art**: Taekwondo (태권도) Moa Seogi (모아서기) - Closed Feet Stance
+* **Philosophy**: Mountain's stillness, immovable yang, absolute defense, rooted earth
+*
+* **Authentic Moa Seogi Characteristics**:
+* - 모아서기 (Moa Seogi): Feet together or nearly touching - NARROW stance
+* - 0.6x shoulder width (~24cm) for mountain-solid rooting
+* - Both knees bent ~145° as shock absorbers (충격 흡수)
+* - 50/50 perfect weight distribution for balanced defense
+* - 상단막기 (Sangdan Makgi): High X-block with forearms crossed
+* - Fists at opposite shoulders creating impenetrable face shield
+*
+* **Biomechanical Analysis**:
+* - Narrow stance creates ultra-stable base (low moment arm)
+* - Knees bent absorb impact force like suspension system
+* - Crossed forearms provide maximum frontal protection
+* - Square facing presents minimal target profile
+*
+* **Combat Applications**:
+* - 산막기 (San Makgi): Mountain block - immovable defense
+* - 가위막기 (Gawi Makgi): Scissor block with crossed arms
+* - 반격준비 (Bangyeok Junbi): Counter-strike preparation from solid base
+* - Impenetrable blocking (+15% block strength)
+* - Instant counter strikes (+10% counter-strike speed)
+*
+* @korean 간괘방어포즈
+*/
+var GAN_MOUNTAIN_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-1.85, .12, 1.05),
+		elbow: new THREE.Euler(0, 0, -2.5),
+		wrist: new THREE.Euler(.52, .42, .35)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-1.85, -.12, -1.05),
+		elbow: new THREE.Euler(0, 0, 2.5),
+		wrist: new THREE.Euler(.52, -.42, -.35)
+	},
+	torso: new THREE.Euler(.16, 0, 0),
+	leftLeg: {
+		hip: new THREE.Euler(.12, .09, .02),
+		knee: new THREE.Euler(.61, 0, 0),
+		ankle: new THREE.Euler(-.11, .02, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.12, -.09, -.02),
+		knee: new THREE.Euler(.61, 0, 0),
+		ankle: new THREE.Euler(-.11, -.02, 0)
+	},
+	pelvis: new THREE.Euler(.11, 0, 0),
+	stanceWidth: .12,
+	stanceDepth: 0,
+	pelvisHeight: -.07,
+	weight: "neutral",
+	breathingRange: {
+		min: .992,
+		max: 1.008
+	}
+};
+/**
+* ☷ 곤 (Gon) - Earth: Ssireum Grappling Ground Stance
+*
+* **Korean Name**: 곤괘 - 땅 (Gon-gwae - Ttang)
+* **Martial Art**: Ssireum (씨름) / Yusul (유술) Deep Squat Grappling Stance
+* **Philosophy**: Ultimate yin, earth's receptive power, grounding force, takedown dominance
+*
+* **Authentic Ssireum Deep Stance Characteristics**:
+* - 씨름 자세 (Ssireum Jase): Traditional Korean wrestling deep squat
+* - ULTRA WIDE stance 2.8x shoulder width (~1.1m+) for maximum stability
+* - Both knees bent to ~80° (극한 굽힘) - DEEP sumo-like squat
+* - 50/50 weight distribution with VERY LOW center of gravity
+* - Arms low ready for 샅바잡기 (Satbajapgi - belt/thigh grabs)
+* - Hands at hip level for 허리후리기 (Heori Hurigi - hip throw preparation)
+*
+* **Biomechanical Analysis**:
+* - Ultra-wide stance lowers center of gravity below opponent's
+* - Deep squat provides explosive upward throwing power
+* - Low hand position enables immediate grip on legs/hips
+* - Forward torso lean establishes grappling pressure
+*
+* **Combat Applications**:
+* - 다리후리기 (Dari Hurigi): Leg sweep and trip techniques
+* - 허리후리기 (Heori Hurigi): Hip throw from deep position
+* - 배지기 (Baejigi): Belly-to-belly suplex throws
+* - Ground clinches and throws (+20% ground control)
+* - Takedown damage amplification (+20 bleed on successful throws)
+*
+* @korean 곤괘방어포즈
+*/
+var GON_EARTH_GUARD_POSE = {
+	leftArm: {
+		shoulder: new THREE.Euler(-.38, .32, .55),
+		elbow: new THREE.Euler(0, 0, -2.05),
+		wrist: new THREE.Euler(-.08, .22, .35)
+	},
+	rightArm: {
+		shoulder: new THREE.Euler(-.38, -.32, -.55),
+		elbow: new THREE.Euler(0, 0, 2.05),
+		wrist: new THREE.Euler(-.08, -.22, -.35)
+	},
+	torso: new THREE.Euler(.32, 0, 0),
+	leftLeg: {
+		hip: new THREE.Euler(.15, .58, .45),
+		knee: new THREE.Euler(1.48, 0, 0),
+		ankle: new THREE.Euler(-.32, .25, 0)
+	},
+	rightLeg: {
+		hip: new THREE.Euler(.15, -.58, -.45),
+		knee: new THREE.Euler(1.48, 0, 0),
+		ankle: new THREE.Euler(-.32, -.25, 0)
+	},
+	pelvis: new THREE.Euler(.22, 0, 0),
+	stanceWidth: 1.35,
+	stanceDepth: 0,
+	pelvisHeight: -.48,
+	weight: "neutral",
+	breathingRange: {
+		min: .965,
+		max: 1.042
+	}
+};
+/**
+* Stance Guard Animation Configurations
+*
+* Record mapping each trigram stance to its complete guard animation config.
+* Includes 4-6 frame breathing animation at 60fps for realistic idle behavior.
+*
+* Using Record instead of Map for better performance with small static dataset.
+*
+* Integration:
+* - Links to AnimationStateMachine for stance-specific idle states
+* - Used by SkeletalPlayer3D for rendering guard positions
+* - Integrates with StanceManager for trigram system
+*
+* @korean 자세방어애니메이션설정맵
+*/
+var STANCE_GUARD_CONFIGS = {
+	[TrigramStance.GEON]: {
+		stance: TrigramStance.GEON,
+		koreanName: "건",
+		englishName: "Heaven",
+		guardPose: GEON_HIGH_GUARD_POSE,
+		breathingFrames: 6,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.TAE]: {
+		stance: TrigramStance.TAE,
+		koreanName: "태",
+		englishName: "Lake",
+		guardPose: TAE_FLUID_GUARD_POSE,
+		breathingFrames: 6,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.LI]: {
+		stance: TrigramStance.LI,
+		koreanName: "리",
+		englishName: "Fire",
+		guardPose: LI_FIRE_GUARD_POSE,
+		breathingFrames: 4,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.JIN]: {
+		stance: TrigramStance.JIN,
+		koreanName: "진",
+		englishName: "Thunder",
+		guardPose: JIN_THUNDER_GUARD_POSE,
+		breathingFrames: 5,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.SON]: {
+		stance: TrigramStance.SON,
+		koreanName: "손",
+		englishName: "Wind",
+		guardPose: SON_WIND_GUARD_POSE,
+		breathingFrames: 6,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.GAM]: {
+		stance: TrigramStance.GAM,
+		koreanName: "감",
+		englishName: "Water",
+		guardPose: GAM_WATER_GUARD_POSE,
+		breathingFrames: 6,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.GAN]: {
+		stance: TrigramStance.GAN,
+		koreanName: "간",
+		englishName: "Mountain",
+		guardPose: GAN_MOUNTAIN_GUARD_POSE,
+		breathingFrames: 4,
+		fps: 60,
+		loop: true,
+		priority: 0
+	},
+	[TrigramStance.GON]: {
+		stance: TrigramStance.GON,
+		koreanName: "곤",
+		englishName: "Earth",
+		guardPose: GON_EARTH_GUARD_POSE,
+		breathingFrames: 5,
+		fps: 60,
+		loop: true,
+		priority: 0
+	}
+};
+/**
+* Get guard pose for a specific trigram stance with laterality support
+*
+* **Korean**: 자세 방어 포즈 가져오기
+*
+* Returns the appropriate guard pose for the given stance and laterality.
+* Right laterality returns the base pose; left laterality returns a mirrored version.
+* This supports authentic Korean martial arts stance differentiation:
+* - 오른발서기 (Oreun Bal Seogi): Right foot forward - base pose
+* - 왼발서기 (Oenbal Seogi): Left foot forward - mirrored pose
+*
+* @param stance - Trigram stance identifier (e.g., "geon", "tae")
+* @param laterality - Stance side: "left" or "right" (defaults to "right")
+* @returns Guard pose configuration or undefined if not found
+*
+* @example
+* ```typescript
+* // Get right Heaven stance (default)
+* const rightGeon = getGuardPoseForStance("geon", "right");
+*
+* // Get left Heaven stance (mirrored)
+* const leftGeon = getGuardPoseForStance("geon", "left");
+* // leftGeon now has left foot forward, left hand lead
+* ```
+*
+* @korean 자세방어포즈가져오기
+*/
+function getGuardPoseForStance(stance, laterality = "right") {
+	const config = STANCE_GUARD_CONFIGS[stance];
+	if (!config?.guardPose) return;
+	if (laterality === "right") return config.guardPose;
+	return mirrorGuardPose(config.guardPose);
+}
+//#endregion
+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, getGuardPoseForStance };
+
+//# sourceMappingURL=StanceGuardPoses.js.map