blacktrigram 0.7.2

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

@@ -0,0 +1,184 @@
+/**
+ * Recovery Animation System for Black Trigram
+ *
+ * Implements realistic recovery animations for standing up from fallen states.
+ * Based on Korean martial arts recovery techniques (기상 - Gisang).
+ *
+ * @module systems/animation/RecoveryAnimations
+ * @category Animation
+ * @korean 기상애니메이션
+ */
+import type { GroundState, RecoveryAnimationType } from "../core/types";
+/**
+ * Recovery animation keyframe data structure
+ *
+ * Defines key poses during recovery animations for skeletal rendering.
+ * Each keyframe specifies body positions at critical moments.
+ *
+ * @korean 기상키프레임
+ */
+export interface RecoveryKeyframe {
+    /** Frame number (0-indexed) */
+    readonly frame: number;
+    /** Torso rotation (radians) */
+    readonly torsoRotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Center of mass vertical position (0-1, 1=standing, 0=ground) */
+    readonly centerOfMassHeight: number;
+    /** Description of this keyframe */
+    readonly description: {
+        readonly korean: string;
+        readonly english: string;
+    };
+    /** Whether player is vulnerable at this frame */
+    readonly vulnerable: boolean;
+}
+/**
+ * Prone stand-up keyframes (엎드린 기상)
+ *
+ * 30 frames (500ms) sequence:
+ * - Frames 0-8: Push up with hands, torso lifts
+ * - Frames 9-18: Legs swing under body, kneeling position
+ * - Frames 19-24: Rise from kneeling to standing (vulnerable)
+ * - Frames 25-29: Final stance adjustment (interruptible)
+ *
+ * @korean 엎드린기상키프레임
+ */
+export declare const RECOVERY_PRONE_KEYFRAMES: readonly RecoveryKeyframe[];
+/**
+ * Supine stand-up keyframes (누운 기상)
+ *
+ * 36 frames (600ms) sequence:
+ * - Frames 0-10: Abs crunch sit-up motion
+ * - Frames 11-22: Forward roll onto feet
+ * - Frames 23-30: Feet plant, rise to standing (vulnerable)
+ * - Frames 31-35: Final stance adjustment (interruptible)
+ *
+ * @korean 누운기상키프레임
+ */
+export declare const RECOVERY_SUPINE_KEYFRAMES: readonly RecoveryKeyframe[];
+/**
+ * Roll recovery keyframes (회전기상)
+ *
+ * 24 frames (400ms) sequence - FAST recovery
+ * - Frames 0-6: Roll to side, momentum building
+ * - Frames 7-14: Spring to feet with explosive movement
+ * - Frames 15-18: Quick stance (vulnerable)
+ * - Frames 19-23: Combat ready (interruptible)
+ *
+ * Costs 20 stamina for speed advantage.
+ *
+ * @korean 회전기상키프레임
+ */
+export declare const RECOVERY_ROLL_KEYFRAMES: readonly RecoveryKeyframe[];
+/**
+ * Defensive getup keyframes (방어기상)
+ *
+ * 42 frames (700ms) sequence - SLOW but protected
+ * - Frames 0-14: Slow rise with arms guarding head/torso
+ * - Frames 15-28: Gradual stand with maintained guard
+ * - Frames 29-36: Stance formation with guard (50% damage reduction)
+ * - Frames 37-41: Ready stance (interruptible)
+ *
+ * Provides 50% damage reduction throughout animation.
+ *
+ * @korean 방어기상키프레임
+ */
+export declare const RECOVERY_DEFENSIVE_KEYFRAMES: readonly RecoveryKeyframe[];
+/**
+ * Get keyframes for a specific recovery type
+ *
+ * @param recoveryType - Type of recovery animation
+ * @returns Array of keyframes for that recovery type
+ *
+ * @public
+ * @korean 기상키프레임가져오기
+ */
+export declare function getRecoveryKeyframes(recoveryType: RecoveryAnimationType): readonly RecoveryKeyframe[];
+/**
+ * Check if a frame in a recovery animation is vulnerable
+ *
+ * Vulnerability is determined by keyframe data. The last 6 frames
+ * of each recovery animation are interruptible and not vulnerable.
+ *
+ * @param recoveryType - Type of recovery animation
+ * @param frame - Current frame number (0-indexed)
+ * @returns True if player is vulnerable at this frame
+ *
+ * @public
+ * @korean 취약프레임확인
+ */
+export declare function isVulnerableFrame(recoveryType: RecoveryAnimationType, frame: number): boolean;
+/**
+ * Determine appropriate recovery animation from ground state
+ *
+ * Uses ground state to select default recovery animation.
+ * Side positions default to roll recovery for dynamic movement.
+ *
+ * @param groundState - Current ground position
+ * @returns Default recovery animation type
+ *
+ * @example
+ * ```typescript
+ * const recoveryType = determineRecoveryType("prone");
+ * // Returns: "prone_standup"
+ *
+ * const sideRecovery = determineRecoveryType("side_left");
+ * // Returns: "roll_recovery" (default for side positions)
+ * ```
+ *
+ * @public
+ * @korean 기상유형결정
+ */
+export declare function determineRecoveryType(groundState: GroundState): RecoveryAnimationType;
+/**
+ * Get recovery animation state from recovery type
+ *
+ * @param recoveryType - Recovery animation type
+ * @returns Animation state name
+ *
+ * @public
+ * @korean 기상애니메이션상태
+ */
+export declare function getRecoveryAnimationState(recoveryType: RecoveryAnimationType): string;
+/**
+ * Recovery animation configuration
+ *
+ * Additional properties for recovery animations beyond base AnimationConfig.
+ *
+ * @korean 기상설정
+ */
+export interface RecoveryConfig {
+    /** Recovery animation type */
+    readonly type: RecoveryAnimationType;
+    /** Stamina cost to execute (0 for normal recoveries) */
+    readonly staminaCost: number;
+    /** Damage reduction percentage during animation (0-1) */
+    readonly damageReduction: number;
+    /** Number of initial vulnerable frames (first N frames are vulnerable to damage) */
+    readonly vulnerableFrames: number;
+    /** Frame when player becomes interruptible (last 6 frames typically) */
+    readonly interruptibleFrame: number;
+}
+/**
+ * Recovery animation configurations
+ *
+ * Defines stamina costs, damage reduction, and vulnerability windows.
+ *
+ * @korean 기상설정맵
+ */
+export declare const RECOVERY_CONFIGS: Record<RecoveryAnimationType, RecoveryConfig>;
+/**
+ * Get recovery configuration
+ *
+ * @param recoveryType - Recovery animation type
+ * @returns Recovery configuration
+ *
+ * @public
+ * @korean 기상설정가져오기
+ */
+export declare function getRecoveryConfig(recoveryType: RecoveryAnimationType): RecoveryConfig;
+//# sourceMappingURL=RecoveryAnimations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryAnimations.d.ts","sourceRoot":"","sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAMxE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,+BAA+B;IAC/B,QAAQ,CAAC,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5D,mEAAmE;IACnE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAmDtD,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAmDvD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAmDrD,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,gBAAgB,EAmD1D,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,qBAAqB,GAClC,SAAS,gBAAgB,EAAE,CAa7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EACnC,KAAK,EAAE,MAAM,GACZ,OAAO,CAcT;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,qBAAqB,CAEvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAER;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,qBAAqB,EAAE,cAAc,CA6B1E,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,GAClC,cAAc,CAEhB"}

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

@@ -0,0 +1,465 @@
+import { GROUND_STATE_TO_RECOVERY, RECOVERY_TYPE_TO_ANIMATION } from "../core/types.js";
+//#region src/systems/animation/catalogs/RecoveryAnimations.ts
+/**
+* Prone stand-up keyframes (엎드린 기상)
+*
+* 30 frames (500ms) sequence:
+* - Frames 0-8: Push up with hands, torso lifts
+* - Frames 9-18: Legs swing under body, kneeling position
+* - Frames 19-24: Rise from kneeling to standing (vulnerable)
+* - Frames 25-29: Final stance adjustment (interruptible)
+*
+* @korean 엎드린기상키프레임
+*/
+var RECOVERY_PRONE_KEYFRAMES = [
+	{
+		frame: 0,
+		torsoRotation: {
+			x: 1.57,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .05,
+		description: {
+			korean: "엎드린 자세",
+			english: "Prone position"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 8,
+		torsoRotation: {
+			x: 1.2,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .2,
+		description: {
+			korean: "손으로 밀어 올리기",
+			english: "Hands push up torso"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 18,
+		torsoRotation: {
+			x: .7,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .5,
+		description: {
+			korean: "무릎 꿇기",
+			english: "Kneeling position"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 24,
+		torsoRotation: {
+			x: .2,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .75,
+		description: {
+			korean: "일어서기",
+			english: "Rising to standing"
+		},
+		vulnerable: false
+	},
+	{
+		frame: 29,
+		torsoRotation: {
+			x: 0,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .9,
+		description: {
+			korean: "서 있는 자세",
+			english: "Standing stance"
+		},
+		vulnerable: false
+	}
+];
+/**
+* Supine stand-up keyframes (누운 기상)
+*
+* 36 frames (600ms) sequence:
+* - Frames 0-10: Abs crunch sit-up motion
+* - Frames 11-22: Forward roll onto feet
+* - Frames 23-30: Feet plant, rise to standing (vulnerable)
+* - Frames 31-35: Final stance adjustment (interruptible)
+*
+* @korean 누운기상키프레임
+*/
+var RECOVERY_SUPINE_KEYFRAMES = [
+	{
+		frame: 0,
+		torsoRotation: {
+			x: -1.57,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .05,
+		description: {
+			korean: "누운 자세",
+			english: "Supine position"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 10,
+		torsoRotation: {
+			x: -.9,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .3,
+		description: {
+			korean: "윗몸 일으키기",
+			english: "Sit-up motion"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 22,
+		torsoRotation: {
+			x: .4,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .4,
+		description: {
+			korean: "전방 구르기",
+			english: "Forward roll"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 30,
+		torsoRotation: {
+			x: .2,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .7,
+		description: {
+			korean: "발 디디고 일어서기",
+			english: "Feet planted, rising"
+		},
+		vulnerable: false
+	},
+	{
+		frame: 35,
+		torsoRotation: {
+			x: 0,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .9,
+		description: {
+			korean: "서 있는 자세",
+			english: "Standing stance"
+		},
+		vulnerable: false
+	}
+];
+/**
+* Roll recovery keyframes (회전기상)
+*
+* 24 frames (400ms) sequence - FAST recovery
+* - Frames 0-6: Roll to side, momentum building
+* - Frames 7-14: Spring to feet with explosive movement
+* - Frames 15-18: Quick stance (vulnerable)
+* - Frames 19-23: Combat ready (interruptible)
+*
+* Costs 20 stamina for speed advantage.
+*
+* @korean 회전기상키프레임
+*/
+var RECOVERY_ROLL_KEYFRAMES = [
+	{
+		frame: 0,
+		torsoRotation: {
+			x: 0,
+			y: 1.57,
+			z: 1.57
+		},
+		centerOfMassHeight: .05,
+		description: {
+			korean: "측면 자세",
+			english: "Side position"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 6,
+		torsoRotation: {
+			x: .3,
+			y: .8,
+			z: .9
+		},
+		centerOfMassHeight: .25,
+		description: {
+			korean: "구르기 움직임",
+			english: "Rolling motion"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 14,
+		torsoRotation: {
+			x: .4,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .6,
+		description: {
+			korean: "발로 튀어오르기",
+			english: "Spring to feet"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 18,
+		torsoRotation: {
+			x: .1,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .85,
+		description: {
+			korean: "빠른 자세",
+			english: "Quick stance"
+		},
+		vulnerable: false
+	},
+	{
+		frame: 23,
+		torsoRotation: {
+			x: 0,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .9,
+		description: {
+			korean: "전투 준비",
+			english: "Combat ready"
+		},
+		vulnerable: false
+	}
+];
+/**
+* Defensive getup keyframes (방어기상)
+*
+* 42 frames (700ms) sequence - SLOW but protected
+* - Frames 0-14: Slow rise with arms guarding head/torso
+* - Frames 15-28: Gradual stand with maintained guard
+* - Frames 29-36: Stance formation with guard (50% damage reduction)
+* - Frames 37-41: Ready stance (interruptible)
+*
+* Provides 50% damage reduction throughout animation.
+*
+* @korean 방어기상키프레임
+*/
+var RECOVERY_DEFENSIVE_KEYFRAMES = [
+	{
+		frame: 0,
+		torsoRotation: {
+			x: 1.2,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .05,
+		description: {
+			korean: "지면에서 팔 올리기",
+			english: "Grounded, arms up"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 14,
+		torsoRotation: {
+			x: .9,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .3,
+		description: {
+			korean: "천천히 일어나며 방어",
+			english: "Slow rise, guarded"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 28,
+		torsoRotation: {
+			x: .5,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .6,
+		description: {
+			korean: "점차 서며 방어 유지",
+			english: "Gradual stand, guard up"
+		},
+		vulnerable: true
+	},
+	{
+		frame: 36,
+		torsoRotation: {
+			x: .2,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .8,
+		description: {
+			korean: "자세 형성, 방어 상태",
+			english: "Stance formation, guarded"
+		},
+		vulnerable: false
+	},
+	{
+		frame: 41,
+		torsoRotation: {
+			x: 0,
+			y: 0,
+			z: 0
+		},
+		centerOfMassHeight: .9,
+		description: {
+			korean: "준비 자세",
+			english: "Ready stance"
+		},
+		vulnerable: false
+	}
+];
+/**
+* Get keyframes for a specific recovery type
+*
+* @param recoveryType - Type of recovery animation
+* @returns Array of keyframes for that recovery type
+*
+* @public
+* @korean 기상키프레임가져오기
+*/
+function getRecoveryKeyframes(recoveryType) {
+	switch (recoveryType) {
+		case "prone_standup": return RECOVERY_PRONE_KEYFRAMES;
+		case "supine_standup": return RECOVERY_SUPINE_KEYFRAMES;
+		case "roll_recovery": return RECOVERY_ROLL_KEYFRAMES;
+		case "defensive_getup": return RECOVERY_DEFENSIVE_KEYFRAMES;
+		default: return RECOVERY_ROLL_KEYFRAMES;
+	}
+}
+/**
+* Check if a frame in a recovery animation is vulnerable
+*
+* Vulnerability is determined by keyframe data. The last 6 frames
+* of each recovery animation are interruptible and not vulnerable.
+*
+* @param recoveryType - Type of recovery animation
+* @param frame - Current frame number (0-indexed)
+* @returns True if player is vulnerable at this frame
+*
+* @public
+* @korean 취약프레임확인
+*/
+function isVulnerableFrame(recoveryType, frame) {
+	const keyframes = getRecoveryKeyframes(recoveryType);
+	let currentKeyframe = keyframes[0];
+	for (const kf of keyframes) if (kf.frame <= frame) currentKeyframe = kf;
+	else break;
+	return currentKeyframe.vulnerable;
+}
+/**
+* Determine appropriate recovery animation from ground state
+*
+* Uses ground state to select default recovery animation.
+* Side positions default to roll recovery for dynamic movement.
+*
+* @param groundState - Current ground position
+* @returns Default recovery animation type
+*
+* @example
+* ```typescript
+* const recoveryType = determineRecoveryType("prone");
+* // Returns: "prone_standup"
+*
+* const sideRecovery = determineRecoveryType("side_left");
+* // Returns: "roll_recovery" (default for side positions)
+* ```
+*
+* @public
+* @korean 기상유형결정
+*/
+function determineRecoveryType(groundState) {
+	return GROUND_STATE_TO_RECOVERY[groundState];
+}
+/**
+* Get recovery animation state from recovery type
+*
+* @param recoveryType - Recovery animation type
+* @returns Animation state name
+*
+* @public
+* @korean 기상애니메이션상태
+*/
+function getRecoveryAnimationState(recoveryType) {
+	return RECOVERY_TYPE_TO_ANIMATION[recoveryType];
+}
+/**
+* Recovery animation configurations
+*
+* Defines stamina costs, damage reduction, and vulnerability windows.
+*
+* @korean 기상설정맵
+*/
+var RECOVERY_CONFIGS = {
+	prone_standup: {
+		type: "prone_standup",
+		staminaCost: 0,
+		damageReduction: 0,
+		vulnerableFrames: 24,
+		interruptibleFrame: 24
+	},
+	supine_standup: {
+		type: "supine_standup",
+		staminaCost: 0,
+		damageReduction: 0,
+		vulnerableFrames: 30,
+		interruptibleFrame: 30
+	},
+	roll_recovery: {
+		type: "roll_recovery",
+		staminaCost: 20,
+		damageReduction: 0,
+		vulnerableFrames: 18,
+		interruptibleFrame: 18
+	},
+	defensive_getup: {
+		type: "defensive_getup",
+		staminaCost: 0,
+		damageReduction: .5,
+		vulnerableFrames: 36,
+		interruptibleFrame: 36
+	}
+};
+/**
+* Get recovery configuration
+*
+* @param recoveryType - Recovery animation type
+* @returns Recovery configuration
+*
+* @public
+* @korean 기상설정가져오기
+*/
+function getRecoveryConfig(recoveryType) {
+	return RECOVERY_CONFIGS[recoveryType];
+}
+//#endregion
+export { RECOVERY_CONFIGS, RECOVERY_DEFENSIVE_KEYFRAMES, RECOVERY_PRONE_KEYFRAMES, RECOVERY_ROLL_KEYFRAMES, RECOVERY_SUPINE_KEYFRAMES, determineRecoveryType, getRecoveryAnimationState, getRecoveryConfig, getRecoveryKeyframes, isVulnerableFrame };
+
+//# sourceMappingURL=RecoveryAnimations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryAnimations.js","names":[],"sources":["../../../../src/systems/animation/catalogs/RecoveryAnimations.ts"],"sourcesContent":["/**\n * Recovery Animation System for Black Trigram\n *\n * Implements realistic recovery animations for standing up from fallen states.\n * Based on Korean martial arts recovery techniques (기상 - Gisang).\n *\n * @module systems/animation/RecoveryAnimations\n * @category Animation\n * @korean 기상애니메이션\n */\n\nimport type { GroundState, RecoveryAnimationType } from \"../core/types\";\nimport {\n  GROUND_STATE_TO_RECOVERY,\n  RECOVERY_TYPE_TO_ANIMATION,\n} from \"../core/types\";\n\n/**\n * Recovery animation keyframe data structure\n *\n * Defines key poses during recovery animations for skeletal rendering.\n * Each keyframe specifies body positions at critical moments.\n *\n * @korean 기상키프레임\n */\nexport interface RecoveryKeyframe {\n  /** Frame number (0-indexed) */\n  readonly frame: number;\n\n  /** Torso rotation (radians) */\n  readonly torsoRotation: { x: number; y: number; z: number };\n\n  /** Center of mass vertical position (0-1, 1=standing, 0=ground) */\n  readonly centerOfMassHeight: number;\n\n  /** Description of this keyframe */\n  readonly description: {\n    readonly korean: string;\n    readonly english: string;\n  };\n\n  /** Whether player is vulnerable at this frame */\n  readonly vulnerable: boolean;\n}\n\n/**\n * Prone stand-up keyframes (엎드린 기상)\n *\n * 30 frames (500ms) sequence:\n * - Frames 0-8: Push up with hands, torso lifts\n * - Frames 9-18: Legs swing under body, kneeling position\n * - Frames 19-24: Rise from kneeling to standing (vulnerable)\n * - Frames 25-29: Final stance adjustment (interruptible)\n *\n * @korean 엎드린기상키프레임\n */\nexport const RECOVERY_PRONE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.57, y: 0, z: 0 }, // Face down (90° forward)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"엎드린 자세\",\n      english: \"Prone position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 8,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Hands pushing, torso lifting\n    centerOfMassHeight: 0.2,\n    description: {\n      korean: \"손으로 밀어 올리기\",\n      english: \"Hands push up torso\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.7, y: 0, z: 0 }, // Kneeling position\n    centerOfMassHeight: 0.5,\n    description: {\n      korean: \"무릎 꿇기\",\n      english: \"Kneeling position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 24,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Rising to standing\n    centerOfMassHeight: 0.75,\n    description: {\n      korean: \"일어서기\",\n      english: \"Rising to standing\",\n    },\n    vulnerable: false, // Last 6 frames (24-30) entering safe zone\n  },\n  {\n    frame: 29,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (25-30) are not vulnerable\n  },\n] as const;\n\n/**\n * Supine stand-up keyframes (누운 기상)\n *\n * 36 frames (600ms) sequence:\n * - Frames 0-10: Abs crunch sit-up motion\n * - Frames 11-22: Forward roll onto feet\n * - Frames 23-30: Feet plant, rise to standing (vulnerable)\n * - Frames 31-35: Final stance adjustment (interruptible)\n *\n * @korean 누운기상키프레임\n */\nexport const RECOVERY_SUPINE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: -1.57, y: 0, z: 0 }, // Face up (90° back)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"누운 자세\",\n      english: \"Supine position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 10,\n    torsoRotation: { x: -0.9, y: 0, z: 0 }, // Sit-up motion\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"윗몸 일으키기\",\n      english: \"Sit-up motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 22,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Forward roll\n    centerOfMassHeight: 0.4,\n    description: {\n      korean: \"전방 구르기\",\n      english: \"Forward roll\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 30,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Feet planted, rising\n    centerOfMassHeight: 0.7,\n    description: {\n      korean: \"발 디디고 일어서기\",\n      english: \"Feet planted, rising\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) entering safe zone\n  },\n  {\n    frame: 35,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Standing (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"서 있는 자세\",\n      english: \"Standing stance\",\n    },\n    vulnerable: false, // Last 6 frames (30-36) are not vulnerable\n  },\n] as const;\n\n/**\n * Roll recovery keyframes (회전기상)\n *\n * 24 frames (400ms) sequence - FAST recovery\n * - Frames 0-6: Roll to side, momentum building\n * - Frames 7-14: Spring to feet with explosive movement\n * - Frames 15-18: Quick stance (vulnerable)\n * - Frames 19-23: Combat ready (interruptible)\n *\n * Costs 20 stamina for speed advantage.\n *\n * @korean 회전기상키프레임\n */\nexport const RECOVERY_ROLL_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 0, y: 1.57, z: 1.57 }, // Side position (90° roll)\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"측면 자세\",\n      english: \"Side position\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 6,\n    torsoRotation: { x: 0.3, y: 0.8, z: 0.9 }, // Rolling motion\n    centerOfMassHeight: 0.25,\n    description: {\n      korean: \"구르기 움직임\",\n      english: \"Rolling motion\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.4, y: 0, z: 0 }, // Springing to feet\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"발로 튀어오르기\",\n      english: \"Spring to feet\",\n    },\n    vulnerable: true,\n  },\n  {\n    frame: 18,\n    torsoRotation: { x: 0.1, y: 0, z: 0 }, // Quick stance\n    centerOfMassHeight: 0.85,\n    description: {\n      korean: \"빠른 자세\",\n      english: \"Quick stance\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) entering safe zone\n  },\n  {\n    frame: 23,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Combat ready (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"전투 준비\",\n      english: \"Combat ready\",\n    },\n    vulnerable: false, // Last 6 frames (18-24) are not vulnerable\n  },\n] as const;\n\n/**\n * Defensive getup keyframes (방어기상)\n *\n * 42 frames (700ms) sequence - SLOW but protected\n * - Frames 0-14: Slow rise with arms guarding head/torso\n * - Frames 15-28: Gradual stand with maintained guard\n * - Frames 29-36: Stance formation with guard (50% damage reduction)\n * - Frames 37-41: Ready stance (interruptible)\n *\n * Provides 50% damage reduction throughout animation.\n *\n * @korean 방어기상키프레임\n */\nexport const RECOVERY_DEFENSIVE_KEYFRAMES: readonly RecoveryKeyframe[] = [\n  {\n    frame: 0,\n    torsoRotation: { x: 1.2, y: 0, z: 0 }, // Grounded, arms up\n    centerOfMassHeight: 0.05,\n    description: {\n      korean: \"지면에서 팔 올리기\",\n      english: \"Grounded, arms up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 14,\n    torsoRotation: { x: 0.9, y: 0, z: 0 }, // Slow rise, guard maintained\n    centerOfMassHeight: 0.3,\n    description: {\n      korean: \"천천히 일어나며 방어\",\n      english: \"Slow rise, guarded\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 28,\n    torsoRotation: { x: 0.5, y: 0, z: 0 }, // Gradual stand, guard up\n    centerOfMassHeight: 0.6,\n    description: {\n      korean: \"점차 서며 방어 유지\",\n      english: \"Gradual stand, guard up\",\n    },\n    vulnerable: true, // 50% damage reduction applies\n  },\n  {\n    frame: 36,\n    torsoRotation: { x: 0.2, y: 0, z: 0 }, // Stance formation, guarded\n    centerOfMassHeight: 0.8,\n    description: {\n      korean: \"자세 형성, 방어 상태\",\n      english: \"Stance formation, guarded\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) entering safe zone (still 50% reduction)\n  },\n  {\n    frame: 41,\n    torsoRotation: { x: 0, y: 0, z: 0 }, // Ready stance (interruptible)\n    centerOfMassHeight: 0.9,\n    description: {\n      korean: \"준비 자세\",\n      english: \"Ready stance\",\n    },\n    vulnerable: false, // Last 6 frames (36-42) are not vulnerable\n  },\n] as const;\n\n/**\n * Get keyframes for a specific recovery type\n *\n * @param recoveryType - Type of recovery animation\n * @returns Array of keyframes for that recovery type\n *\n * @public\n * @korean 기상키프레임가져오기\n */\nexport function getRecoveryKeyframes(\n  recoveryType: RecoveryAnimationType\n): readonly RecoveryKeyframe[] {\n  switch (recoveryType) {\n    case \"prone_standup\":\n      return RECOVERY_PRONE_KEYFRAMES;\n    case \"supine_standup\":\n      return RECOVERY_SUPINE_KEYFRAMES;\n    case \"roll_recovery\":\n      return RECOVERY_ROLL_KEYFRAMES;\n    case \"defensive_getup\":\n      return RECOVERY_DEFENSIVE_KEYFRAMES;\n    default:\n      return RECOVERY_ROLL_KEYFRAMES;\n  }\n}\n\n/**\n * Check if a frame in a recovery animation is vulnerable\n *\n * Vulnerability is determined by keyframe data. The last 6 frames\n * of each recovery animation are interruptible and not vulnerable.\n *\n * @param recoveryType - Type of recovery animation\n * @param frame - Current frame number (0-indexed)\n * @returns True if player is vulnerable at this frame\n *\n * @public\n * @korean 취약프레임확인\n */\nexport function isVulnerableFrame(\n  recoveryType: RecoveryAnimationType,\n  frame: number\n): boolean {\n  const keyframes = getRecoveryKeyframes(recoveryType);\n\n  // Find the keyframe for this frame or the previous keyframe\n  let currentKeyframe = keyframes[0];\n  for (const kf of keyframes) {\n    if (kf.frame <= frame) {\n      currentKeyframe = kf;\n    } else {\n      break;\n    }\n  }\n\n  return currentKeyframe.vulnerable;\n}\n\n/**\n * Determine appropriate recovery animation from ground state\n *\n * Uses ground state to select default recovery animation.\n * Side positions default to roll recovery for dynamic movement.\n *\n * @param groundState - Current ground position\n * @returns Default recovery animation type\n *\n * @example\n * ```typescript\n * const recoveryType = determineRecoveryType(\"prone\");\n * // Returns: \"prone_standup\"\n *\n * const sideRecovery = determineRecoveryType(\"side_left\");\n * // Returns: \"roll_recovery\" (default for side positions)\n * ```\n *\n * @public\n * @korean 기상유형결정\n */\nexport function determineRecoveryType(\n  groundState: GroundState\n): RecoveryAnimationType {\n  return GROUND_STATE_TO_RECOVERY[groundState];\n}\n\n/**\n * Get recovery animation state from recovery type\n *\n * @param recoveryType - Recovery animation type\n * @returns Animation state name\n *\n * @public\n * @korean 기상애니메이션상태\n */\nexport function getRecoveryAnimationState(\n  recoveryType: RecoveryAnimationType\n): string {\n  return RECOVERY_TYPE_TO_ANIMATION[recoveryType];\n}\n\n/**\n * Recovery animation configuration\n *\n * Additional properties for recovery animations beyond base AnimationConfig.\n *\n * @korean 기상설정\n */\nexport interface RecoveryConfig {\n  /** Recovery animation type */\n  readonly type: RecoveryAnimationType;\n\n  /** Stamina cost to execute (0 for normal recoveries) */\n  readonly staminaCost: number;\n\n  /** Damage reduction percentage during animation (0-1) */\n  readonly damageReduction: number;\n\n  /** Number of initial vulnerable frames (first N frames are vulnerable to damage) */\n  readonly vulnerableFrames: number;\n\n  /** Frame when player becomes interruptible (last 6 frames typically) */\n  readonly interruptibleFrame: number;\n}\n\n/**\n * Recovery animation configurations\n *\n * Defines stamina costs, damage reduction, and vulnerability windows.\n *\n * @korean 기상설정맵\n */\nexport const RECOVERY_CONFIGS: Record<RecoveryAnimationType, RecoveryConfig> = {\n  prone_standup: {\n    type: \"prone_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 24, // Vulnerable for first 24 frames (80%)\n    interruptibleFrame: 24, // Last 6 frames (25-30) are interruptible\n  },\n  supine_standup: {\n    type: \"supine_standup\",\n    staminaCost: 0,\n    damageReduction: 0,\n    vulnerableFrames: 30, // Vulnerable for first 30 frames (83%)\n    interruptibleFrame: 30, // Last 6 frames (30-36) are interruptible\n  },\n  roll_recovery: {\n    type: \"roll_recovery\",\n    staminaCost: 20, // Costs stamina for speed\n    damageReduction: 0,\n    vulnerableFrames: 18, // Vulnerable for first 18 frames (75%)\n    interruptibleFrame: 18, // Last 6 frames (18-24) are interruptible\n  },\n  defensive_getup: {\n    type: \"defensive_getup\",\n    staminaCost: 0,\n    damageReduction: 0.5, // 50% damage reduction throughout\n    vulnerableFrames: 36, // Vulnerable for first 36 frames (86%)\n    interruptibleFrame: 36, // Last 6 frames (36-42) are interruptible\n  },\n};\n\n/**\n * Get recovery configuration\n *\n * @param recoveryType - Recovery animation type\n * @returns Recovery configuration\n *\n * @public\n * @korean 기상설정가져오기\n */\nexport function getRecoveryConfig(\n  recoveryType: RecoveryAnimationType\n): RecoveryConfig {\n  return RECOVERY_CONFIGS[recoveryType];\n}\n"],"mappings":"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"}