blacktrigram 0.7.2

package/lib/systems/breathing/BreathingDisruptionSystem.js

@@ -0,0 +1,388 @@
+import { VitalPointEffectType } from "../../types/common.js";
+import "../../types/index.js";
+import { EffectIntensity } from "../effects.js";
+//#region src/systems/breathing/BreathingDisruptionSystem.ts
+/**
+* Breathing Disruption System for realistic respiratory targeting mechanics.
+* 
+* **Korean**: 호흡곤란 시스템 (Breathing Disruption System)
+* 
+* This system implements realistic breathing disruption from torso strikes targeting
+* the solar plexus, ribs, and diaphragm. Breathing difficulty reduces stamina
+* regeneration and creates authentic combat trauma effects.
+* 
+* ## Disruption Levels (호흡곤란 수준)
+* 
+* - **Winded (바람맞음)**: 25% stamina regeneration penalty for 5 seconds
+* - **Gasping (헐떡임)**: 50% stamina regeneration penalty for 10 seconds
+* - **Severely Winded (심각한 호흡곤란)**: 75% stamina regeneration penalty for 15 seconds
+* 
+* ## Korean Martial Arts Context
+* 
+* Traditional Korean martial arts (태권도, 합기도, 택견) emphasize torso strikes:
+* - **명치 (Myeongchi)**: Solar plexus - instant breath disruption
+* - **늑골 (Neukgol)**: Floating ribs - cumulative breathing difficulty
+* - **횡격막 (Hoenggyeongmak)**: Diaphragm - severe respiratory impact
+* 
+* ## Game Design Philosophy
+* 
+* Breathing disruption creates tactical depth by:
+* 1. Rewarding torso targeting over simple head/limb attacks
+* 2. Creating stamina management gameplay - disrupted fighters must fight defensively
+* 3. Providing realistic combat trauma feedback
+* 4. Encouraging recovery periods when torso health is compromised
+* 
+* @module systems/breathing
+* @category Combat Systems
+* @korean 호흡곤란시스템
+*/
+/**
+* Breathing disruption severity levels.
+* 
+* **Korean**: 호흡곤란 수준
+* 
+* Progressive levels of respiratory impairment from torso strikes.
+* Higher levels stack duration and increase stamina regeneration penalties.
+* 
+* @public
+* @category Combat Systems
+* @korean 호흡곤란수준
+*/
+var BreathingDisruptionLevel = /* @__PURE__ */ function(BreathingDisruptionLevel) {
+	/** No breathing disruption - normal stamina regeneration */
+	BreathingDisruptionLevel["NONE"] = "none";
+	/**
+	* Winded (바람맞음)
+	* - 25% stamina regeneration penalty
+	* - Duration: 5 seconds
+	* - Caused by: Moderate torso strikes
+	*/
+	BreathingDisruptionLevel["WINDED"] = "winded";
+	/**
+	* Gasping (헐떡임)
+	* - 50% stamina regeneration penalty
+	* - Duration: 10 seconds
+	* - Caused by: Heavy torso strikes or multiple hits
+	*/
+	BreathingDisruptionLevel["GASPING"] = "gasping";
+	/**
+	* Severely Winded (심각한 호흡곤란)
+	* - 75% stamina regeneration penalty
+	* - Duration: 15 seconds
+	* - Caused by: Solar plexus vital point strikes
+	*/
+	BreathingDisruptionLevel["SEVERELY_WINDED"] = "severely_winded";
+	return BreathingDisruptionLevel;
+}({});
+/**
+* Breathing disruption level configurations.
+* 
+* Defines stamina penalties, durations, and bilingual descriptions
+* for each severity level.
+*/
+var BREATHING_DISRUPTION_CONFIGS = {
+	[BreathingDisruptionLevel.WINDED]: {
+		level: BreathingDisruptionLevel.WINDED,
+		duration: 5e3,
+		staminaRegenMultiplier: .75,
+		koreanName: "바람맞음",
+		englishName: "Winded",
+		description: {
+			korean: "중간 강도의 몸통 타격으로 호흡이 불규칙해짐",
+			english: "Breathing is irregular from moderate torso strike",
+			romanized: "baram-maeum"
+		}
+	},
+	[BreathingDisruptionLevel.GASPING]: {
+		level: BreathingDisruptionLevel.GASPING,
+		duration: 1e4,
+		staminaRegenMultiplier: .5,
+		koreanName: "헐떡임",
+		englishName: "Gasping",
+		description: {
+			korean: "강한 몸통 타격으로 호흡이 어려워짐",
+			english: "Heavy torso strikes cause breathing difficulty",
+			romanized: "heoltteogim"
+		}
+	},
+	[BreathingDisruptionLevel.SEVERELY_WINDED]: {
+		level: BreathingDisruptionLevel.SEVERELY_WINDED,
+		duration: 15e3,
+		staminaRegenMultiplier: .25,
+		koreanName: "심각한 호흡곤란",
+		englishName: "Severely Winded",
+		description: {
+			korean: "명치 급소 타격으로 심각한 호흡곤란 발생",
+			english: "Solar plexus vital strike causes severe breathing disruption",
+			romanized: "simgakhan hoheup gonnan"
+		}
+	}
+};
+/**
+* Breathing Disruption System implementation.
+* 
+* **Korean**: 호흡곤란 시스템
+* 
+* Manages breathing disruption effects from torso targeting.
+* Integrates with vital point system and stamina regeneration.
+* 
+* @public
+* @category Combat Systems
+*/
+var BreathingDisruptionSystem = class {
+	/**
+	* Create a breathing disruption effect at specified severity level.
+	* 
+	* **Korean**: 호흡곤란 효과 생성
+	* 
+	* @param level - Severity level of breathing disruption
+	* @param source - Source of the disruption (technique name, vital point, etc.)
+	* @param timestamp - When the effect was applied (game time)
+	* @returns BreathingDisruptionEffect ready to apply to PlayerState
+	* 
+	* @example
+	* ```typescript
+	* // Solar plexus strike causes severe disruption
+	* const effect = BreathingDisruptionSystem.createEffect(
+	*   BreathingDisruptionLevel.SEVERELY_WINDED,
+	*   "명치타격 (Solar Plexus Strike)",
+	*   Date.now()
+	* );
+	* ```
+	*/
+	static createEffect(level, source, timestamp) {
+		const config = BREATHING_DISRUPTION_CONFIGS[level];
+		return {
+			id: `breathing_disruption_${level}_${timestamp}`,
+			type: VitalPointEffectType.BREATHLESSNESS,
+			level,
+			intensity: this.levelToIntensity(level),
+			duration: config.duration,
+			staminaRegenMultiplier: config.staminaRegenMultiplier,
+			description: config.description,
+			stackable: true,
+			source,
+			startTime: timestamp,
+			endTime: timestamp + config.duration
+		};
+	}
+	/**
+	* Convert breathing disruption level to effect intensity.
+	* 
+	* Maps severity levels to standardized EffectIntensity enum.
+	* 
+	* @param level - Breathing disruption severity
+	* @returns Corresponding EffectIntensity value
+	*/
+	static levelToIntensity(level) {
+		switch (level) {
+			case BreathingDisruptionLevel.WINDED: return EffectIntensity.LOW;
+			case BreathingDisruptionLevel.GASPING: return EffectIntensity.MEDIUM;
+			case BreathingDisruptionLevel.SEVERELY_WINDED: return EffectIntensity.HIGH;
+			default: return EffectIntensity.WEAK;
+		}
+	}
+	/**
+	* Calculate breathing disruption level from damage amount.
+	* 
+	* **Korean**: 피해량으로 호흡곤란 수준 계산
+	* 
+	* Determines appropriate disruption severity based on torso strike damage.
+	* Used when vital point ID is not specified but torso region was hit.
+	* 
+	* @param damage - Base damage of the torso strike
+	* @param isSolarPlexus - Whether strike hit solar plexus vital point
+	* @returns Appropriate breathing disruption level
+	* 
+	* @example
+	* ```typescript
+	* // Moderate torso strike (15 damage) causes winded effect
+	* const level = BreathingDisruptionSystem.calculateLevelFromDamage(15, false);
+	* // level === BreathingDisruptionLevel.WINDED
+	* 
+	* // Solar plexus vital strike (20+ damage) causes severe effect
+	* const severeLevel = BreathingDisruptionSystem.calculateLevelFromDamage(25, true);
+	* // severeLevel === BreathingDisruptionLevel.SEVERELY_WINDED
+	* ```
+	*/
+	static calculateLevelFromDamage(damage, isSolarPlexus) {
+		if (isSolarPlexus) return BreathingDisruptionLevel.SEVERELY_WINDED;
+		if (damage >= 20) return BreathingDisruptionLevel.GASPING;
+		else if (damage >= 10) return BreathingDisruptionLevel.WINDED;
+		return BreathingDisruptionLevel.NONE;
+	}
+	/**
+	* Stack multiple breathing disruption effects.
+	* 
+	* **Korean**: 호흡곤란 효과 누적
+	* 
+	* Cumulative torso hits increase disruption duration and potentially severity.
+	* Multiple hits stack duration, and severe hits can escalate the level.
+	* 
+	* @param existingEffect - Current active breathing disruption effect
+	* @param newLevel - Severity of new torso strike
+	* @param source - Source of the new disruption
+	* @param timestamp - Current game time
+	* @returns Updated BreathingDisruptionEffect with stacked duration/severity
+	* 
+	* @example
+	* ```typescript
+	* // First hit: Winded for 5 seconds
+	* let effect = BreathingDisruptionSystem.createEffect(
+	*   BreathingDisruptionLevel.WINDED, "Rib Strike", 1000
+	* );
+	* 
+	* // Second hit: Stacks to Gasping with extended duration
+	* effect = BreathingDisruptionSystem.stackEffect(
+	*   effect, BreathingDisruptionLevel.WINDED, "Rib Strike", 3000
+	* );
+	* // Now Gasping level with 10+ seconds remaining
+	* ```
+	*/
+	static stackEffect(existingEffect, newLevel, source, timestamp) {
+		const newConfig = BREATHING_DISRUPTION_CONFIGS[newLevel];
+		const effectiveLevel = this.getHigherLevel(existingEffect.level, newLevel);
+		const effectiveConfig = BREATHING_DISRUPTION_CONFIGS[effectiveLevel];
+		const totalDuration = Math.max(0, existingEffect.endTime - timestamp) + Math.floor(newConfig.duration * .5);
+		return {
+			...existingEffect,
+			level: effectiveLevel,
+			intensity: this.levelToIntensity(effectiveLevel),
+			duration: totalDuration,
+			staminaRegenMultiplier: effectiveConfig.staminaRegenMultiplier,
+			description: effectiveConfig.description,
+			source: `${existingEffect.source}, ${source}`,
+			endTime: timestamp + totalDuration
+		};
+	}
+	/**
+	* Compare two disruption levels and return the more severe.
+	* 
+	* @param level1 - First disruption level
+	* @param level2 - Second disruption level
+	* @returns The more severe of the two levels
+	*/
+	static getHigherLevel(level1, level2) {
+		const severity = {
+			[BreathingDisruptionLevel.NONE]: 0,
+			[BreathingDisruptionLevel.WINDED]: 1,
+			[BreathingDisruptionLevel.GASPING]: 2,
+			[BreathingDisruptionLevel.SEVERELY_WINDED]: 3
+		};
+		return severity[level1] > severity[level2] ? level1 : level2;
+	}
+	/**
+	* Get active breathing disruption effect from player state.
+	* 
+	* **Korean**: 활성 호흡곤란 효과 가져오기
+	* 
+	* Searches player's active status effects for breathing disruption.
+	* 
+	* @param player - Current player state
+	* @returns Active BreathingDisruptionEffect or undefined
+	*/
+	static getActiveEffect(player) {
+		return player.statusEffects.find((effect) => effect.type === VitalPointEffectType.BREATHLESSNESS && "level" in effect && "staminaRegenMultiplier" in effect);
+	}
+	/**
+	* Calculate stamina regeneration multiplier with breathing disruption.
+	* 
+	* **Korean**: 호흡곤란 포함 스태미나 재생 계산
+	* 
+	* Applies breathing disruption penalty to base stamina regeneration rate.
+	* Used by stamina regeneration system each frame.
+	* 
+	* @param player - Current player state
+	* @param baseRegenRate - Base stamina regeneration per second
+	* @returns Modified regeneration rate with breathing penalty applied
+	* 
+	* @example
+	* ```typescript
+	* const baseRegen = 10; // 10 stamina/second normally
+	* 
+	* // With Gasping effect (50% penalty)
+	* const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(
+	*   player, baseRegen
+	* );
+	* // modifiedRegen === 5 (50% of base rate)
+	* ```
+	*/
+	static calculateStaminaRegen(player, baseRegenRate) {
+		const activeEffect = this.getActiveEffect(player);
+		if (!activeEffect) return baseRegenRate;
+		return baseRegenRate * activeEffect.staminaRegenMultiplier;
+	}
+	/**
+	* Check if player can recover from breathing disruption.
+	* 
+	* **Korean**: 호흡곤란 회복 가능 여부 확인
+	* 
+	* Recovery is possible when torso health > 50%.
+	* Player must avoid additional torso damage to allow breathing to normalize.
+	* 
+	* @param player - Current player state
+	* @returns True if torso health supports recovery
+	*/
+	static canRecover(player) {
+		if (!player.bodyPartHealth) return player.health > player.maxHealth * .5;
+		return ((player.bodyPartHealth.torsoUpper ?? 0) + (player.bodyPartHealth.torsoLower ?? 0)) / 2 / (((player.bodyPartMaxHealth?.torsoUpper ?? 100) + (player.bodyPartMaxHealth?.torsoLower ?? 100)) / 2) > .5;
+	}
+	/**
+	* Apply gradual recovery to breathing disruption effect.
+	* 
+	* **Korean**: 호흡곤란 점진적 회복 적용
+	* 
+	* When torso health > 50% and no new hits, breathing gradually improves.
+	* This provides tactical gameplay: fighters with damaged torsos must fight defensively.
+	* 
+	* @param effect - Current breathing disruption effect
+	* @param deltaTime - Time since last update (milliseconds)
+	* @param timestamp - Current game time
+	* @returns Updated effect with recovery applied, or undefined if fully recovered
+	* 
+	* @example
+	* ```typescript
+	* // Each frame with torso health > 50%
+	* const updated = BreathingDisruptionSystem.applyGradualRecovery(
+	*   effect, 16.67, timestamp
+	* );
+	* // Effect duration decreases faster than normal expiration
+	* ```
+	*/
+	static applyGradualRecovery(effect, deltaTime, timestamp) {
+		const recoveryTime = deltaTime * 2;
+		const newEndTime = effect.endTime - recoveryTime;
+		if (newEndTime <= timestamp) return;
+		return {
+			...effect,
+			endTime: newEndTime,
+			duration: newEndTime - effect.startTime
+		};
+	}
+	/**
+	* Get breathing disruption level from player state.
+	* 
+	* **Korean**: 플레이어 호흡곤란 수준 가져오기
+	* 
+	* Convenience method to get current disruption level.
+	* 
+	* @param player - Current player state
+	* @returns Current breathing disruption level (NONE if no active effect)
+	*/
+	static getCurrentLevel(player) {
+		return this.getActiveEffect(player)?.level ?? BreathingDisruptionLevel.NONE;
+	}
+	/**
+	* Check if breathing disruption is active.
+	* 
+	* @param player - Current player state
+	* @returns True if player has active breathing disruption
+	*/
+	static isActive(player) {
+		return this.getCurrentLevel(player) !== BreathingDisruptionLevel.NONE;
+	}
+};
+//#endregion
+export { BreathingDisruptionLevel, BreathingDisruptionSystem };
+
+//# sourceMappingURL=BreathingDisruptionSystem.js.map

package/lib/systems/breathing/BreathingDisruptionSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BreathingDisruptionSystem.js","names":[],"sources":["../../../src/systems/breathing/BreathingDisruptionSystem.ts"],"sourcesContent":["/**\n * Breathing Disruption System for realistic respiratory targeting mechanics.\n * \n * **Korean**: 호흡곤란 시스템 (Breathing Disruption System)\n * \n * This system implements realistic breathing disruption from torso strikes targeting\n * the solar plexus, ribs, and diaphragm. Breathing difficulty reduces stamina\n * regeneration and creates authentic combat trauma effects.\n * \n * ## Disruption Levels (호흡곤란 수준)\n * \n * - **Winded (바람맞음)**: 25% stamina regeneration penalty for 5 seconds\n * - **Gasping (헐떡임)**: 50% stamina regeneration penalty for 10 seconds\n * - **Severely Winded (심각한 호흡곤란)**: 75% stamina regeneration penalty for 15 seconds\n * \n * ## Korean Martial Arts Context\n * \n * Traditional Korean martial arts (태권도, 합기도, 택견) emphasize torso strikes:\n * - **명치 (Myeongchi)**: Solar plexus - instant breath disruption\n * - **늑골 (Neukgol)**: Floating ribs - cumulative breathing difficulty\n * - **횡격막 (Hoenggyeongmak)**: Diaphragm - severe respiratory impact\n * \n * ## Game Design Philosophy\n * \n * Breathing disruption creates tactical depth by:\n * 1. Rewarding torso targeting over simple head/limb attacks\n * 2. Creating stamina management gameplay - disrupted fighters must fight defensively\n * 3. Providing realistic combat trauma feedback\n * 4. Encouraging recovery periods when torso health is compromised\n * \n * @module systems/breathing\n * @category Combat Systems\n * @korean 호흡곤란시스템\n */\n\nimport { KoreanText, VitalPointEffectType } from \"@/types\";\nimport { StatusEffect } from \"@/systems/types\";\nimport { PlayerState } from \"@/systems/player\";\nimport { EffectIntensity } from \"@/systems/effects\";\n\n/**\n * Breathing disruption severity levels.\n * \n * **Korean**: 호흡곤란 수준\n * \n * Progressive levels of respiratory impairment from torso strikes.\n * Higher levels stack duration and increase stamina regeneration penalties.\n * \n * @public\n * @category Combat Systems\n * @korean 호흡곤란수준\n */\nexport enum BreathingDisruptionLevel {\n  /** No breathing disruption - normal stamina regeneration */\n  NONE = \"none\",\n  \n  /**\n   * Winded (바람맞음)\n   * - 25% stamina regeneration penalty\n   * - Duration: 5 seconds\n   * - Caused by: Moderate torso strikes\n   */\n  WINDED = \"winded\",\n  \n  /**\n   * Gasping (헐떡임)\n   * - 50% stamina regeneration penalty\n   * - Duration: 10 seconds\n   * - Caused by: Heavy torso strikes or multiple hits\n   */\n  GASPING = \"gasping\",\n  \n  /**\n   * Severely Winded (심각한 호흡곤란)\n   * - 75% stamina regeneration penalty\n   * - Duration: 15 seconds\n   * - Caused by: Solar plexus vital point strikes\n   */\n  SEVERELY_WINDED = \"severely_winded\",\n}\n\n/**\n * Breathing disruption effect extending StatusEffect.\n * \n * **Korean**: 호흡곤란 효과\n * \n * Tracks active breathing difficulty with Korean-English terminology.\n * Integrates with the status effect system for consistent duration tracking.\n * \n * @public\n * @category Combat Systems\n * @korean 호흡곤란효과\n */\nexport interface BreathingDisruptionEffect extends StatusEffect {\n  /** Effect type is always BREATHLESSNESS */\n  readonly type: VitalPointEffectType.BREATHLESSNESS;\n  \n  /** Breathing disruption severity level */\n  readonly level: BreathingDisruptionLevel;\n  \n  /** Stamina regeneration multiplier (0.25 = 75% penalty, 0.50 = 50% penalty) */\n  readonly staminaRegenMultiplier: number;\n  \n  /** Whether this effect can stack with additional torso hits */\n  readonly stackable: true;\n}\n\n/**\n * Configuration for breathing disruption level effects.\n * \n * **Korean**: 호흡곤란 설정\n */\ninterface BreathingDisruptionConfig {\n  readonly level: BreathingDisruptionLevel;\n  readonly duration: number; // milliseconds\n  readonly staminaRegenMultiplier: number;\n  readonly koreanName: string;\n  readonly englishName: string;\n  readonly description: KoreanText;\n}\n\n/**\n * Breathing disruption level configurations.\n * \n * Defines stamina penalties, durations, and bilingual descriptions\n * for each severity level.\n */\nconst BREATHING_DISRUPTION_CONFIGS: Record<\n  Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n  BreathingDisruptionConfig\n> = {\n  [BreathingDisruptionLevel.WINDED]: {\n    level: BreathingDisruptionLevel.WINDED,\n    duration: 5000, // 5 seconds\n    staminaRegenMultiplier: 0.75, // 25% penalty\n    koreanName: \"바람맞음\",\n    englishName: \"Winded\",\n    description: {\n      korean: \"중간 강도의 몸통 타격으로 호흡이 불규칙해짐\",\n      english: \"Breathing is irregular from moderate torso strike\",\n      romanized: \"baram-maeum\",\n    },\n  },\n  [BreathingDisruptionLevel.GASPING]: {\n    level: BreathingDisruptionLevel.GASPING,\n    duration: 10000, // 10 seconds\n    staminaRegenMultiplier: 0.50, // 50% penalty\n    koreanName: \"헐떡임\",\n    englishName: \"Gasping\",\n    description: {\n      korean: \"강한 몸통 타격으로 호흡이 어려워짐\",\n      english: \"Heavy torso strikes cause breathing difficulty\",\n      romanized: \"heoltteogim\",\n    },\n  },\n  [BreathingDisruptionLevel.SEVERELY_WINDED]: {\n    level: BreathingDisruptionLevel.SEVERELY_WINDED,\n    duration: 15000, // 15 seconds\n    staminaRegenMultiplier: 0.25, // 75% penalty\n    koreanName: \"심각한 호흡곤란\",\n    englishName: \"Severely Winded\",\n    description: {\n      korean: \"명치 급소 타격으로 심각한 호흡곤란 발생\",\n      english: \"Solar plexus vital strike causes severe breathing disruption\",\n      romanized: \"simgakhan hoheup gonnan\",\n    },\n  },\n};\n\n/**\n * Breathing Disruption System implementation.\n * \n * **Korean**: 호흡곤란 시스템\n * \n * Manages breathing disruption effects from torso targeting.\n * Integrates with vital point system and stamina regeneration.\n * \n * @public\n * @category Combat Systems\n */\nexport class BreathingDisruptionSystem {\n  /**\n   * Create a breathing disruption effect at specified severity level.\n   * \n   * **Korean**: 호흡곤란 효과 생성\n   * \n   * @param level - Severity level of breathing disruption\n   * @param source - Source of the disruption (technique name, vital point, etc.)\n   * @param timestamp - When the effect was applied (game time)\n   * @returns BreathingDisruptionEffect ready to apply to PlayerState\n   * \n   * @example\n   * ```typescript\n   * // Solar plexus strike causes severe disruption\n   * const effect = BreathingDisruptionSystem.createEffect(\n   *   BreathingDisruptionLevel.SEVERELY_WINDED,\n   *   \"명치타격 (Solar Plexus Strike)\",\n   *   Date.now()\n   * );\n   * ```\n   */\n  static createEffect(\n    level: Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n    source: string,\n    timestamp: number\n  ): BreathingDisruptionEffect {\n    const config = BREATHING_DISRUPTION_CONFIGS[level];\n    \n    return {\n      id: `breathing_disruption_${level}_${timestamp}`,\n      type: VitalPointEffectType.BREATHLESSNESS,\n      level,\n      intensity: this.levelToIntensity(level),\n      duration: config.duration,\n      staminaRegenMultiplier: config.staminaRegenMultiplier,\n      description: config.description,\n      stackable: true,\n      source,\n      startTime: timestamp,\n      endTime: timestamp + config.duration,\n    };\n  }\n\n  /**\n   * Convert breathing disruption level to effect intensity.\n   * \n   * Maps severity levels to standardized EffectIntensity enum.\n   * \n   * @param level - Breathing disruption severity\n   * @returns Corresponding EffectIntensity value\n   */\n  private static levelToIntensity(\n    level: BreathingDisruptionLevel\n  ): EffectIntensity {\n    switch (level) {\n      case BreathingDisruptionLevel.WINDED:\n        return EffectIntensity.LOW;\n      case BreathingDisruptionLevel.GASPING:\n        return EffectIntensity.MEDIUM;\n      case BreathingDisruptionLevel.SEVERELY_WINDED:\n        return EffectIntensity.HIGH;\n      default:\n        return EffectIntensity.WEAK;\n    }\n  }\n\n  /**\n   * Calculate breathing disruption level from damage amount.\n   * \n   * **Korean**: 피해량으로 호흡곤란 수준 계산\n   * \n   * Determines appropriate disruption severity based on torso strike damage.\n   * Used when vital point ID is not specified but torso region was hit.\n   * \n   * @param damage - Base damage of the torso strike\n   * @param isSolarPlexus - Whether strike hit solar plexus vital point\n   * @returns Appropriate breathing disruption level\n   * \n   * @example\n   * ```typescript\n   * // Moderate torso strike (15 damage) causes winded effect\n   * const level = BreathingDisruptionSystem.calculateLevelFromDamage(15, false);\n   * // level === BreathingDisruptionLevel.WINDED\n   * \n   * // Solar plexus vital strike (20+ damage) causes severe effect\n   * const severeLevel = BreathingDisruptionSystem.calculateLevelFromDamage(25, true);\n   * // severeLevel === BreathingDisruptionLevel.SEVERELY_WINDED\n   * ```\n   */\n  static calculateLevelFromDamage(\n    damage: number,\n    isSolarPlexus: boolean\n  ): BreathingDisruptionLevel {\n    // Solar plexus vital strikes always cause severe disruption\n    if (isSolarPlexus) {\n      return BreathingDisruptionLevel.SEVERELY_WINDED;\n    }\n\n    // Thresholds for damage-based severity\n    if (damage >= 20) {\n      return BreathingDisruptionLevel.GASPING;\n    } else if (damage >= 10) {\n      return BreathingDisruptionLevel.WINDED;\n    }\n\n    return BreathingDisruptionLevel.NONE;\n  }\n\n  /**\n   * Stack multiple breathing disruption effects.\n   * \n   * **Korean**: 호흡곤란 효과 누적\n   * \n   * Cumulative torso hits increase disruption duration and potentially severity.\n   * Multiple hits stack duration, and severe hits can escalate the level.\n   * \n   * @param existingEffect - Current active breathing disruption effect\n   * @param newLevel - Severity of new torso strike\n   * @param source - Source of the new disruption\n   * @param timestamp - Current game time\n   * @returns Updated BreathingDisruptionEffect with stacked duration/severity\n   * \n   * @example\n   * ```typescript\n   * // First hit: Winded for 5 seconds\n   * let effect = BreathingDisruptionSystem.createEffect(\n   *   BreathingDisruptionLevel.WINDED, \"Rib Strike\", 1000\n   * );\n   * \n   * // Second hit: Stacks to Gasping with extended duration\n   * effect = BreathingDisruptionSystem.stackEffect(\n   *   effect, BreathingDisruptionLevel.WINDED, \"Rib Strike\", 3000\n   * );\n   * // Now Gasping level with 10+ seconds remaining\n   * ```\n   */\n  static stackEffect(\n    existingEffect: BreathingDisruptionEffect,\n    newLevel: Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n    source: string,\n    timestamp: number\n  ): BreathingDisruptionEffect {\n    const newConfig = BREATHING_DISRUPTION_CONFIGS[newLevel];\n    \n    // Escalate to higher severity if new strike is more severe\n    const effectiveLevel = this.getHigherLevel(existingEffect.level, newLevel);\n    const effectiveConfig = BREATHING_DISRUPTION_CONFIGS[effectiveLevel];\n\n    // Stack duration: add 50% of new effect's duration to remaining time\n    const remainingTime = Math.max(0, existingEffect.endTime - timestamp);\n    const additionalTime = Math.floor(newConfig.duration * 0.5);\n    const totalDuration = remainingTime + additionalTime;\n\n    return {\n      ...existingEffect,\n      level: effectiveLevel,\n      intensity: this.levelToIntensity(effectiveLevel),\n      duration: totalDuration,\n      staminaRegenMultiplier: effectiveConfig.staminaRegenMultiplier,\n      description: effectiveConfig.description,\n      source: `${existingEffect.source}, ${source}`,\n      endTime: timestamp + totalDuration,\n    };\n  }\n\n  /**\n   * Compare two disruption levels and return the more severe.\n   * \n   * @param level1 - First disruption level\n   * @param level2 - Second disruption level\n   * @returns The more severe of the two levels\n   */\n  private static getHigherLevel(\n    level1: BreathingDisruptionLevel,\n    level2: BreathingDisruptionLevel\n  ): Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE> {\n    const severity = {\n      [BreathingDisruptionLevel.NONE]: 0,\n      [BreathingDisruptionLevel.WINDED]: 1,\n      [BreathingDisruptionLevel.GASPING]: 2,\n      [BreathingDisruptionLevel.SEVERELY_WINDED]: 3,\n    };\n\n    const higher = severity[level1] > severity[level2] ? level1 : level2;\n    \n    // Type guard: result can't be NONE since inputs exclude NONE\n    return higher as Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>;\n  }\n\n  /**\n   * Get active breathing disruption effect from player state.\n   * \n   * **Korean**: 활성 호흡곤란 효과 가져오기\n   * \n   * Searches player's active status effects for breathing disruption.\n   * \n   * @param player - Current player state\n   * @returns Active BreathingDisruptionEffect or undefined\n   */\n  static getActiveEffect(\n    player: PlayerState\n  ): BreathingDisruptionEffect | undefined {\n    return player.statusEffects.find(\n      (effect): effect is BreathingDisruptionEffect =>\n        effect.type === VitalPointEffectType.BREATHLESSNESS &&\n        \"level\" in effect &&\n        \"staminaRegenMultiplier\" in effect\n    );\n  }\n\n  /**\n   * Calculate stamina regeneration multiplier with breathing disruption.\n   * \n   * **Korean**: 호흡곤란 포함 스태미나 재생 계산\n   * \n   * Applies breathing disruption penalty to base stamina regeneration rate.\n   * Used by stamina regeneration system each frame.\n   * \n   * @param player - Current player state\n   * @param baseRegenRate - Base stamina regeneration per second\n   * @returns Modified regeneration rate with breathing penalty applied\n   * \n   * @example\n   * ```typescript\n   * const baseRegen = 10; // 10 stamina/second normally\n   * \n   * // With Gasping effect (50% penalty)\n   * const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(\n   *   player, baseRegen\n   * );\n   * // modifiedRegen === 5 (50% of base rate)\n   * ```\n   */\n  static calculateStaminaRegen(\n    player: PlayerState,\n    baseRegenRate: number\n  ): number {\n    const activeEffect = this.getActiveEffect(player);\n    \n    if (!activeEffect) {\n      return baseRegenRate;\n    }\n\n    return baseRegenRate * activeEffect.staminaRegenMultiplier;\n  }\n\n  /**\n   * Check if player can recover from breathing disruption.\n   * \n   * **Korean**: 호흡곤란 회복 가능 여부 확인\n   * \n   * Recovery is possible when torso health > 50%.\n   * Player must avoid additional torso damage to allow breathing to normalize.\n   * \n   * @param player - Current player state\n   * @returns True if torso health supports recovery\n   */\n  static canRecover(player: PlayerState): boolean {\n    // Check if body part health tracking is available\n    if (!player.bodyPartHealth) {\n      // Fallback: use overall health as proxy\n      return player.health > player.maxHealth * 0.5;\n    }\n\n    // Calculate torso health percentage (using upper torso as primary)\n    const upperTorsoHealth = player.bodyPartHealth.torsoUpper ?? 0;\n    const lowerTorsoHealth = player.bodyPartHealth.torsoLower ?? 0;\n    const avgTorsoHealth = (upperTorsoHealth + lowerTorsoHealth) / 2;\n    \n    const maxUpperTorsoHealth = player.bodyPartMaxHealth?.torsoUpper ?? 100;\n    const maxLowerTorsoHealth = player.bodyPartMaxHealth?.torsoLower ?? 100;\n    const avgMaxTorsoHealth = (maxUpperTorsoHealth + maxLowerTorsoHealth) / 2;\n    \n    const torsoHealthPercent = avgTorsoHealth / avgMaxTorsoHealth;\n\n    return torsoHealthPercent > 0.5;\n  }\n\n  /**\n   * Apply gradual recovery to breathing disruption effect.\n   * \n   * **Korean**: 호흡곤란 점진적 회복 적용\n   * \n   * When torso health > 50% and no new hits, breathing gradually improves.\n   * This provides tactical gameplay: fighters with damaged torsos must fight defensively.\n   * \n   * @param effect - Current breathing disruption effect\n   * @param deltaTime - Time since last update (milliseconds)\n   * @param timestamp - Current game time\n   * @returns Updated effect with recovery applied, or undefined if fully recovered\n   * \n   * @example\n   * ```typescript\n   * // Each frame with torso health > 50%\n   * const updated = BreathingDisruptionSystem.applyGradualRecovery(\n   *   effect, 16.67, timestamp\n   * );\n   * // Effect duration decreases faster than normal expiration\n   * ```\n   */\n  static applyGradualRecovery(\n    effect: BreathingDisruptionEffect,\n    deltaTime: number,\n    timestamp: number\n  ): BreathingDisruptionEffect | undefined {\n    // Recovery rate: 2x faster than normal expiration\n    const recoveryMultiplier = 2.0;\n    const recoveryTime = deltaTime * recoveryMultiplier;\n    \n    const newEndTime = effect.endTime - recoveryTime;\n    \n    // Fully recovered if end time reached\n    if (newEndTime <= timestamp) {\n      return undefined;\n    }\n\n    return {\n      ...effect,\n      endTime: newEndTime,\n      duration: newEndTime - effect.startTime,\n    };\n  }\n\n  /**\n   * Get breathing disruption level from player state.\n   * \n   * **Korean**: 플레이어 호흡곤란 수준 가져오기\n   * \n   * Convenience method to get current disruption level.\n   * \n   * @param player - Current player state\n   * @returns Current breathing disruption level (NONE if no active effect)\n   */\n  static getCurrentLevel(player: PlayerState): BreathingDisruptionLevel {\n    const activeEffect = this.getActiveEffect(player);\n    return activeEffect?.level ?? BreathingDisruptionLevel.NONE;\n  }\n\n  /**\n   * Check if breathing disruption is active.\n   * \n   * @param player - Current player state\n   * @returns True if player has active breathing disruption\n   */\n  static isActive(player: PlayerState): boolean {\n    return this.getCurrentLevel(player) !== BreathingDisruptionLevel.NONE;\n  }\n}\n"],"mappings":"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"}

package/lib/systems/breathing/feedback.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Visual and Audio Feedback Types for Breathing Disruption System.
+ *
+ * **Korean**: 호흡곤란 시각/청각 피드백
+ *
+ * Type definitions for visual indicators, animations, and audio effects
+ * that provide player feedback for breathing disruption status.
+ *
+ * @module systems/breathing/feedback
+ * @category Combat Systems
+ * @korean 호흡곤란피드백
+ */
+import { KoreanText } from "../../types";
+import { BreathingDisruptionLevel } from "./BreathingDisruptionSystem";
+/**
+ * Visual indicator configuration for breathing disruption HUD display.
+ *
+ * **Korean**: 호흡곤란 HUD 표시기
+ *
+ * Displays breathing difficulty status with color-coded lungs icon (🫁)
+ * and severity-based visual styling.
+ */
+export interface BreathingIndicatorConfig {
+    /** Whether to show the breathing indicator */
+    readonly visible: boolean;
+    /** Current breathing disruption level */
+    readonly level: BreathingDisruptionLevel;
+    /** Icon to display (default: 🫁 lungs emoji) */
+    readonly icon: string;
+    /** Color based on severity */
+    readonly color: number;
+    /** Opacity for pulsing effect (0-1) */
+    readonly opacity: number;
+    /** Scale for emphasis (1.0 = normal) */
+    readonly scale: number;
+    /** Bilingual text label */
+    readonly label: KoreanText;
+    /** Time remaining until recovery (milliseconds) */
+    readonly timeRemaining: number;
+    /** Whether recovery is in progress */
+    readonly isRecovering: boolean;
+}
+/**
+ * Animation state for character posture during breathing disruption.
+ *
+ * **Korean**: 호흡곤란 자세 애니메이션
+ *
+ * Defines character posture and movement patterns based on breathing difficulty.
+ */
+export interface BreathingPostureState {
+    /** Breathing disruption level affecting posture */
+    readonly level: BreathingDisruptionLevel;
+    /** Body bend angle (degrees) - 0 = upright, positive = bent forward */
+    readonly bendAngle: number;
+    /** Breathing rhythm speed multiplier (0-1) */
+    readonly breathingSpeed: number;
+    /** Chest expansion intensity (0-1) */
+    readonly chestExpansion: number;
+    /** Shoulder rise/fall intensity (0-1) */
+    readonly shoulderMovement: number;
+    /** Whether character is gasping (rapid breathing) */
+    readonly isGasping: boolean;
+    /** Whether character is holding chest/torso */
+    readonly isHoldingTorso: boolean;
+    /** Movement speed penalty (0-1, where 1 = no penalty) */
+    readonly movementPenalty: number;
+}
+/**
+ * Audio effect configuration for breathing sounds.
+ *
+ * **Korean**: 호흡 소리 효과
+ *
+ * Defines audio playback for breathing difficulty sounds.
+ */
+export interface BreathingAudioEffect {
+    /** Breathing disruption level */
+    readonly level: BreathingDisruptionLevel;
+    /** Audio file ID or URL */
+    readonly audioId: string;
+    /** Volume level (0-1) */
+    readonly volume: number;
+    /** Playback speed multiplier */
+    readonly playbackRate: number;
+    /** Whether to loop the sound */
+    readonly loop: boolean;
+    /** Fade in duration (milliseconds) */
+    readonly fadeIn: number;
+    /** Fade out duration (milliseconds) */
+    readonly fadeOut: number;
+    /** Korean voice callout (optional) */
+    readonly voiceCallout?: {
+        readonly text: string;
+        readonly audioId: string;
+    };
+}
+/**
+ * Predefined breathing indicator configurations for each severity level.
+ */
+export declare const BREATHING_INDICATOR_CONFIGS: Record<Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>, Omit<BreathingIndicatorConfig, "visible" | "timeRemaining" | "isRecovering">>;
+/**
+ * Predefined posture states for each breathing disruption level.
+ */
+export declare const BREATHING_POSTURE_STATES: Record<Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>, BreathingPostureState>;
+/**
+ * Audio effect configurations for breathing sounds.
+ */
+export declare const BREATHING_AUDIO_EFFECTS: Record<Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>, BreathingAudioEffect>;
+/**
+ * Create breathing indicator config for current player state.
+ *
+ * @param level - Current breathing disruption level
+ * @param timeRemaining - Milliseconds until effect expires
+ * @param isRecovering - Whether recovery is in progress
+ * @returns Complete BreathingIndicatorConfig for HUD display
+ */
+export declare function createBreathingIndicator(level: BreathingDisruptionLevel, timeRemaining: number, isRecovering: boolean): BreathingIndicatorConfig;
+/**
+ * Get posture state for current breathing disruption level.
+ *
+ * @param level - Current breathing disruption level
+ * @returns BreathingPostureState for character animation
+ */
+export declare function getBreathingPosture(level: BreathingDisruptionLevel): BreathingPostureState | null;
+/**
+ * Get audio effect for current breathing disruption level.
+ *
+ * @param level - Current breathing disruption level
+ * @returns BreathingAudioEffect for audio playback
+ */
+export declare function getBreathingAudio(level: BreathingDisruptionLevel): BreathingAudioEffect | null;
+//# sourceMappingURL=feedback.d.ts.map

package/lib/systems/breathing/feedback.d.ts.map

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

package/lib/systems/breathing/feedback.js

@@ -0,0 +1,80 @@
+import { BreathingDisruptionLevel } from "./BreathingDisruptionSystem.js";
+//#region src/systems/breathing/feedback.ts
+/**
+* Predefined breathing indicator configurations for each severity level.
+*/
+var BREATHING_INDICATOR_CONFIGS = {
+	[BreathingDisruptionLevel.WINDED]: {
+		level: BreathingDisruptionLevel.WINDED,
+		icon: "🫁",
+		color: 16766720,
+		opacity: .7,
+		scale: 1,
+		label: {
+			korean: "바람맞음",
+			english: "Winded",
+			romanized: "baram-maeum"
+		}
+	},
+	[BreathingDisruptionLevel.GASPING]: {
+		level: BreathingDisruptionLevel.GASPING,
+		icon: "🫁",
+		color: 16753920,
+		opacity: .85,
+		scale: 1.1,
+		label: {
+			korean: "헐떡임",
+			english: "Gasping",
+			romanized: "heoltteogim"
+		}
+	},
+	[BreathingDisruptionLevel.SEVERELY_WINDED]: {
+		level: BreathingDisruptionLevel.SEVERELY_WINDED,
+		icon: "🫁",
+		color: 16729156,
+		opacity: 1,
+		scale: 1.2,
+		label: {
+			korean: "심각한 호흡곤란",
+			english: "Severely Winded",
+			romanized: "simgakhan hoheup gonnan"
+		}
+	}
+};
+BreathingDisruptionLevel.WINDED, BreathingDisruptionLevel.WINDED, BreathingDisruptionLevel.GASPING, BreathingDisruptionLevel.GASPING, BreathingDisruptionLevel.SEVERELY_WINDED, BreathingDisruptionLevel.SEVERELY_WINDED;
+BreathingDisruptionLevel.WINDED, BreathingDisruptionLevel.WINDED, BreathingDisruptionLevel.GASPING, BreathingDisruptionLevel.GASPING, BreathingDisruptionLevel.SEVERELY_WINDED, BreathingDisruptionLevel.SEVERELY_WINDED;
+/**
+* Create breathing indicator config for current player state.
+* 
+* @param level - Current breathing disruption level
+* @param timeRemaining - Milliseconds until effect expires
+* @param isRecovering - Whether recovery is in progress
+* @returns Complete BreathingIndicatorConfig for HUD display
+*/
+function createBreathingIndicator(level, timeRemaining, isRecovering) {
+	if (level === BreathingDisruptionLevel.NONE) return {
+		visible: false,
+		level,
+		icon: "🫁",
+		color: 65280,
+		opacity: 0,
+		scale: 1,
+		label: {
+			korean: "정상",
+			english: "Normal",
+			romanized: "jeongsang"
+		},
+		timeRemaining: 0,
+		isRecovering: false
+	};
+	return {
+		...BREATHING_INDICATOR_CONFIGS[level],
+		visible: true,
+		timeRemaining,
+		isRecovering
+	};
+}
+//#endregion
+export { BREATHING_INDICATOR_CONFIGS, createBreathingIndicator };
+
+//# sourceMappingURL=feedback.js.map

package/lib/systems/breathing/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","names":[],"sources":["../../../src/systems/breathing/feedback.ts"],"sourcesContent":["/**\n * Visual and Audio Feedback Types for Breathing Disruption System.\n * \n * **Korean**: 호흡곤란 시각/청각 피드백\n * \n * Type definitions for visual indicators, animations, and audio effects\n * that provide player feedback for breathing disruption status.\n * \n * @module systems/breathing/feedback\n * @category Combat Systems\n * @korean 호흡곤란피드백\n */\n\nimport { KoreanText } from \"@/types\";\nimport { BreathingDisruptionLevel } from \"./BreathingDisruptionSystem\";\n\n/**\n * Visual indicator configuration for breathing disruption HUD display.\n * \n * **Korean**: 호흡곤란 HUD 표시기\n * \n * Displays breathing difficulty status with color-coded lungs icon (🫁)\n * and severity-based visual styling.\n */\nexport interface BreathingIndicatorConfig {\n  /** Whether to show the breathing indicator */\n  readonly visible: boolean;\n  \n  /** Current breathing disruption level */\n  readonly level: BreathingDisruptionLevel;\n  \n  /** Icon to display (default: 🫁 lungs emoji) */\n  readonly icon: string;\n  \n  /** Color based on severity */\n  readonly color: number;\n  \n  /** Opacity for pulsing effect (0-1) */\n  readonly opacity: number;\n  \n  /** Scale for emphasis (1.0 = normal) */\n  readonly scale: number;\n  \n  /** Bilingual text label */\n  readonly label: KoreanText;\n  \n  /** Time remaining until recovery (milliseconds) */\n  readonly timeRemaining: number;\n  \n  /** Whether recovery is in progress */\n  readonly isRecovering: boolean;\n}\n\n/**\n * Animation state for character posture during breathing disruption.\n * \n * **Korean**: 호흡곤란 자세 애니메이션\n * \n * Defines character posture and movement patterns based on breathing difficulty.\n */\nexport interface BreathingPostureState {\n  /** Breathing disruption level affecting posture */\n  readonly level: BreathingDisruptionLevel;\n  \n  /** Body bend angle (degrees) - 0 = upright, positive = bent forward */\n  readonly bendAngle: number;\n  \n  /** Breathing rhythm speed multiplier (0-1) */\n  readonly breathingSpeed: number;\n  \n  /** Chest expansion intensity (0-1) */\n  readonly chestExpansion: number;\n  \n  /** Shoulder rise/fall intensity (0-1) */\n  readonly shoulderMovement: number;\n  \n  /** Whether character is gasping (rapid breathing) */\n  readonly isGasping: boolean;\n  \n  /** Whether character is holding chest/torso */\n  readonly isHoldingTorso: boolean;\n  \n  /** Movement speed penalty (0-1, where 1 = no penalty) */\n  readonly movementPenalty: number;\n}\n\n/**\n * Audio effect configuration for breathing sounds.\n * \n * **Korean**: 호흡 소리 효과\n * \n * Defines audio playback for breathing difficulty sounds.\n */\nexport interface BreathingAudioEffect {\n  /** Breathing disruption level */\n  readonly level: BreathingDisruptionLevel;\n  \n  /** Audio file ID or URL */\n  readonly audioId: string;\n  \n  /** Volume level (0-1) */\n  readonly volume: number;\n  \n  /** Playback speed multiplier */\n  readonly playbackRate: number;\n  \n  /** Whether to loop the sound */\n  readonly loop: boolean;\n  \n  /** Fade in duration (milliseconds) */\n  readonly fadeIn: number;\n  \n  /** Fade out duration (milliseconds) */\n  readonly fadeOut: number;\n  \n  /** Korean voice callout (optional) */\n  readonly voiceCallout?: {\n    readonly text: string;\n    readonly audioId: string;\n  };\n}\n\n/**\n * Predefined breathing indicator configurations for each severity level.\n */\nexport const BREATHING_INDICATOR_CONFIGS: Record<\n  Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n  Omit<BreathingIndicatorConfig, \"visible\" | \"timeRemaining\" | \"isRecovering\">\n> = {\n  [BreathingDisruptionLevel.WINDED]: {\n    level: BreathingDisruptionLevel.WINDED,\n    icon: \"🫁\",\n    color: 0xffd700, // Gold - mild warning\n    opacity: 0.7,\n    scale: 1.0,\n    label: {\n      korean: \"바람맞음\",\n      english: \"Winded\",\n      romanized: \"baram-maeum\",\n    },\n  },\n  [BreathingDisruptionLevel.GASPING]: {\n    level: BreathingDisruptionLevel.GASPING,\n    icon: \"🫁\",\n    color: 0xffa500, // Orange - moderate warning\n    opacity: 0.85,\n    scale: 1.1,\n    label: {\n      korean: \"헐떡임\",\n      english: \"Gasping\",\n      romanized: \"heoltteogim\",\n    },\n  },\n  [BreathingDisruptionLevel.SEVERELY_WINDED]: {\n    level: BreathingDisruptionLevel.SEVERELY_WINDED,\n    icon: \"🫁\",\n    color: 0xff4444, // Red - severe warning\n    opacity: 1.0,\n    scale: 1.2,\n    label: {\n      korean: \"심각한 호흡곤란\",\n      english: \"Severely Winded\",\n      romanized: \"simgakhan hoheup gonnan\",\n    },\n  },\n};\n\n/**\n * Predefined posture states for each breathing disruption level.\n */\nexport const BREATHING_POSTURE_STATES: Record<\n  Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n  BreathingPostureState\n> = {\n  [BreathingDisruptionLevel.WINDED]: {\n    level: BreathingDisruptionLevel.WINDED,\n    bendAngle: 5, // Slight forward lean\n    breathingSpeed: 1.3, // 30% faster breathing\n    chestExpansion: 0.6,\n    shoulderMovement: 0.5,\n    isGasping: false,\n    isHoldingTorso: false,\n    movementPenalty: 0.95, // 5% movement penalty\n  },\n  [BreathingDisruptionLevel.GASPING]: {\n    level: BreathingDisruptionLevel.GASPING,\n    bendAngle: 15, // Noticeable forward bend\n    breathingSpeed: 1.8, // 80% faster breathing\n    chestExpansion: 0.4,\n    shoulderMovement: 0.7,\n    isGasping: true,\n    isHoldingTorso: false,\n    movementPenalty: 0.85, // 15% movement penalty\n  },\n  [BreathingDisruptionLevel.SEVERELY_WINDED]: {\n    level: BreathingDisruptionLevel.SEVERELY_WINDED,\n    bendAngle: 30, // Bent over significantly\n    breathingSpeed: 2.5, // 150% faster breathing\n    chestExpansion: 0.2,\n    shoulderMovement: 0.9,\n    isGasping: true,\n    isHoldingTorso: true,\n    movementPenalty: 0.70, // 30% movement penalty\n  },\n};\n\n/**\n * Audio effect configurations for breathing sounds.\n */\nexport const BREATHING_AUDIO_EFFECTS: Record<\n  Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>,\n  BreathingAudioEffect\n> = {\n  [BreathingDisruptionLevel.WINDED]: {\n    level: BreathingDisruptionLevel.WINDED,\n    audioId: \"breathing_heavy\",\n    volume: 0.5,\n    playbackRate: 1.2,\n    loop: true,\n    fadeIn: 200,\n    fadeOut: 500,\n  },\n  [BreathingDisruptionLevel.GASPING]: {\n    level: BreathingDisruptionLevel.GASPING,\n    audioId: \"breathing_gasping\",\n    volume: 0.7,\n    playbackRate: 1.5,\n    loop: true,\n    fadeIn: 150,\n    fadeOut: 500,\n    voiceCallout: {\n      text: \"헉헉\", // Gasp sound\n      audioId: \"voice_gasping_kr\",\n    },\n  },\n  [BreathingDisruptionLevel.SEVERELY_WINDED]: {\n    level: BreathingDisruptionLevel.SEVERELY_WINDED,\n    audioId: \"breathing_severe\",\n    volume: 0.9,\n    playbackRate: 2.0,\n    loop: true,\n    fadeIn: 100,\n    fadeOut: 500,\n    voiceCallout: {\n      text: \"호흡곤란!\", // Breathing difficulty!\n      audioId: \"voice_breathing_difficulty_kr\",\n    },\n  },\n};\n\n/**\n * Create breathing indicator config for current player state.\n * \n * @param level - Current breathing disruption level\n * @param timeRemaining - Milliseconds until effect expires\n * @param isRecovering - Whether recovery is in progress\n * @returns Complete BreathingIndicatorConfig for HUD display\n */\nexport function createBreathingIndicator(\n  level: BreathingDisruptionLevel,\n  timeRemaining: number,\n  isRecovering: boolean\n): BreathingIndicatorConfig {\n  if (level === BreathingDisruptionLevel.NONE) {\n    return {\n      visible: false,\n      level,\n      icon: \"🫁\",\n      color: 0x00ff00,\n      opacity: 0,\n      scale: 1.0,\n      label: { korean: \"정상\", english: \"Normal\", romanized: \"jeongsang\" },\n      timeRemaining: 0,\n      isRecovering: false,\n    };\n  }\n\n  const baseConfig = BREATHING_INDICATOR_CONFIGS[level];\n  \n  return {\n    ...baseConfig,\n    visible: true,\n    timeRemaining,\n    isRecovering,\n  };\n}\n\n/**\n * Get posture state for current breathing disruption level.\n * \n * @param level - Current breathing disruption level\n * @returns BreathingPostureState for character animation\n */\nexport function getBreathingPosture(\n  level: BreathingDisruptionLevel\n): BreathingPostureState | null {\n  if (level === BreathingDisruptionLevel.NONE) {\n    return null;\n  }\n  \n  return BREATHING_POSTURE_STATES[level];\n}\n\n/**\n * Get audio effect for current breathing disruption level.\n * \n * @param level - Current breathing disruption level\n * @returns BreathingAudioEffect for audio playback\n */\nexport function getBreathingAudio(\n  level: BreathingDisruptionLevel\n): BreathingAudioEffect | null {\n  if (level === BreathingDisruptionLevel.NONE) {\n    return null;\n  }\n  \n  return BREATHING_AUDIO_EFFECTS[level];\n}\n"],"mappings":";;;;;AA6HA,IAAa,8BAGT;EACD,yBAAyB,SAAS;EACjC,OAAO,yBAAyB;EAChC,MAAM;EACN,OAAO;EACP,SAAS;EACT,OAAO;EACP,OAAO;GACL,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;EACA,yBAAyB,UAAU;EAClC,OAAO,yBAAyB;EAChC,MAAM;EACN,OAAO;EACP,SAAS;EACT,OAAO;EACP,OAAO;GACL,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;EACA,yBAAyB,kBAAkB;EAC1C,OAAO,yBAAyB;EAChC,MAAM;EACN,OAAO;EACP,SAAS;EACT,OAAO;EACP,OAAO;GACL,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;CACF;AASE,yBAAyB,QACjB,yBAAyB,QASjC,yBAAyB,SACjB,yBAAyB,SASjC,yBAAyB,iBACjB,yBAAyB;AAkBjC,yBAAyB,QACjB,yBAAyB,QAQjC,yBAAyB,SACjB,yBAAyB,SAYjC,yBAAyB,iBACjB,yBAAyB;;;;;;;;;AAsBpC,SAAgB,yBACd,OACA,eACA,cAC0B;AAC1B,KAAI,UAAU,yBAAyB,KACrC,QAAO;EACL,SAAS;EACT;EACA,MAAM;EACN,OAAO;EACP,SAAS;EACT,OAAO;EACP,OAAO;GAAE,QAAQ;GAAM,SAAS;GAAU,WAAW;GAAa;EAClE,eAAe;EACf,cAAc;EACf;AAKH,QAAO;EACL,GAHiB,4BAA4B;EAI7C,SAAS;EACT;EACA;EACD"}