blacktrigram 0.7.44 → 0.7.47

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

@@ -1 +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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"}
+{"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 * @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 * @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 * @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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAY,2BAAL,yBAAA,0BAAA;;CAEL,yBAAA,UAAO;;;;;;;CAQP,yBAAA,YAAS;;;;;;;CAQT,yBAAA,aAAU;;;;;;;CAQV,yBAAA,qBAAkB;;KACnB;;;;;;;AA+CD,IAAM,+BAGF;EACD,yBAAyB,SAAS;EACjC,OAAO,yBAAyB;EAChC,UAAU;EACV,wBAAwB;EACxB,YAAY;EACZ,aAAa;EACb,aAAa;GACX,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;EACA,yBAAyB,UAAU;EAClC,OAAO,yBAAyB;EAChC,UAAU;EACV,wBAAwB;EACxB,YAAY;EACZ,aAAa;EACb,aAAa;GACX,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;EACA,yBAAyB,kBAAkB;EAC1C,OAAO,yBAAyB;EAChC,UAAU;EACV,wBAAwB;EACxB,YAAY;EACZ,aAAa;EACb,aAAa;GACX,QAAQ;GACR,SAAS;GACT,WAAW;GACZ;EACF;CACF;;;;;;;;;;;AAYD,IAAa,4BAAb,MAAuC;;;;;;;;;;;;;;;;;;;;;CAqBrC,OAAO,aACL,OACA,QACA,WAC2B;EAC3B,MAAM,SAAS,6BAA6B;EAE5C,OAAO;GACL,IAAI,wBAAwB,MAAM,GAAG;GACrC,MAAM,qBAAqB;GAC3B;GACA,WAAW,KAAK,iBAAiB,MAAM;GACvC,UAAU,OAAO;GACjB,wBAAwB,OAAO;GAC/B,aAAa,OAAO;GACpB,WAAW;GACX;GACA,WAAW;GACX,SAAS,YAAY,OAAO;GAC7B;;;;;;;;;;CAWH,OAAe,iBACb,OACiB;EACjB,QAAQ,OAAR;GACE,KAAK,yBAAyB,QAC5B,OAAO,gBAAgB;GACzB,KAAK,yBAAyB,SAC5B,OAAO,gBAAgB;GACzB,KAAK,yBAAyB,iBAC5B,OAAO,gBAAgB;GACzB,SACE,OAAO,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B7B,OAAO,yBACL,QACA,eAC0B;EAE1B,IAAI,eACF,OAAO,yBAAyB;EAIlC,IAAI,UAAU,IACZ,OAAO,yBAAyB;OAC3B,IAAI,UAAU,IACnB,OAAO,yBAAyB;EAGlC,OAAO,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlC,OAAO,YACL,gBACA,UACA,QACA,WAC2B;EAC3B,MAAM,YAAY,6BAA6B;EAG/C,MAAM,iBAAiB,KAAK,eAAe,eAAe,OAAO,SAAS;EAC1E,MAAM,kBAAkB,6BAA6B;EAKrD,MAAM,gBAFgB,KAAK,IAAI,GAAG,eAAe,UAAU,UAErC,GADC,KAAK,MAAM,UAAU,WAAW,GACjB;EAEtC,OAAO;GACL,GAAG;GACH,OAAO;GACP,WAAW,KAAK,iBAAiB,eAAe;GAChD,UAAU;GACV,wBAAwB,gBAAgB;GACxC,aAAa,gBAAgB;GAC7B,QAAQ,GAAG,eAAe,OAAO,IAAI;GACrC,SAAS,YAAY;GACtB;;;;;;;;;CAUH,OAAe,eACb,QACA,QACkE;EAClE,MAAM,WAAW;IACd,yBAAyB,OAAO;IAChC,yBAAyB,SAAS;IAClC,yBAAyB,UAAU;IACnC,yBAAyB,kBAAkB;GAC7C;EAKD,OAHe,SAAS,UAAU,SAAS,UAAU,SAAS;;;;;;;;;;;;CAgBhE,OAAO,gBACL,QACuC;EACvC,OAAO,OAAO,cAAc,MACzB,WACC,OAAO,SAAS,qBAAqB,kBACrC,WAAW,UACX,4BAA4B,OAC/B;;;;;;;;;;;;;;;;;;;;;;;;;CA0BH,OAAO,sBACL,QACA,eACQ;EACR,MAAM,eAAe,KAAK,gBAAgB,OAAO;EAEjD,IAAI,CAAC,cACH,OAAO;EAGT,OAAO,gBAAgB,aAAa;;;;;;;;;;;;;CActC,OAAO,WAAW,QAA8B;EAE9C,IAAI,CAAC,OAAO,gBAEV,OAAO,OAAO,SAAS,OAAO,YAAY;EAc5C,SAVyB,OAAO,eAAe,cAAc,MACpC,OAAO,eAAe,cAAc,MACE,OAEnC,OAAO,mBAAmB,cAAc,QACxC,OAAO,mBAAmB,cAAc,QACI,KAI5C;;;;;;;;;;;;;;;;;;;;;;;;CAyB9B,OAAO,qBACL,QACA,WACA,WACuC;EAGvC,MAAM,eAAe,YAAY;EAEjC,MAAM,aAAa,OAAO,UAAU;EAGpC,IAAI,cAAc,WAChB;EAGF,OAAO;GACL,GAAG;GACH,SAAS;GACT,UAAU,aAAa,OAAO;GAC/B;;;;;;;;;;;;CAaH,OAAO,gBAAgB,QAA+C;EAEpE,OADqB,KAAK,gBAAgB,OACnC,EAAc,SAAS,yBAAyB;;;;;;;;CASzD,OAAO,SAAS,QAA8B;EAC5C,OAAO,KAAK,gBAAgB,OAAO,KAAK,yBAAyB"}

package/lib/systems/combat/BalanceSystem.d.ts

@@ -144,7 +144,6 @@ interface BalanceEffects {
  * const recovered = balanceSystem.applyRecovery(newPlayer, 1000);
  * ```
  *
- * @public
  * @korean 균형시스템
  */
 export declare class BalanceSystem {
@@ -204,7 +203,6 @@ export declare class BalanceSystem {
      * );
      * ```
      *
-     * @public
      * @korean 균형파괴
      */
     disruptBalance(player: BalancePlayerState, impact: number, region?: BodyRegion, currentTime?: number): BalancePlayerState;
@@ -229,7 +227,6 @@ export declare class BalanceSystem {
      * player = system.applyRecovery(player, 16); // ~60fps
      * ```
      *
-     * @public
      * @korean 균형회복
      */
     applyRecovery(player: BalancePlayerState, deltaTime: number): BalancePlayerState;
@@ -239,7 +236,6 @@ export declare class BalanceSystem {
      * @param balance - Balance value (0-100)
      * @returns Current balance level
      *
-     * @public
      * @korean 균형수준확인
      */
     getBalanceLevel(balance: number): BalanceLevel;
@@ -249,7 +245,6 @@ export declare class BalanceSystem {
      * @param level - Balance level
      * @returns Effects applied at that level
      *
-     * @public
      * @korean 균형효과
      */
     getEffects(level: BalanceLevel): BalanceEffects;
@@ -261,7 +256,6 @@ export declare class BalanceSystem {
      * @param player - Current player state
      * @returns Modified player state with balance effects
      *
-     * @public
      * @korean 균형효과적용
      */
     applyEffects(player: PlayerState): PlayerState;
@@ -271,7 +265,6 @@ export declare class BalanceSystem {
      * @param player - Current player state
      * @returns True if off-balance or falling
      *
-     * @public
      * @korean 균형취약확인
      */
     isVulnerable(player: PlayerState): boolean;
@@ -281,7 +274,6 @@ export declare class BalanceSystem {
      * @param player - Current player state
      * @returns Damage multiplier (1.0 = normal, >1.0 = increased damage)
      *
-     * @public
      * @korean 취약성배율
      */
     getVulnerabilityMultiplier(player: PlayerState): number;
@@ -292,7 +284,6 @@ export declare class BalanceSystem {
      * @param randomFn - Optional random number generator (returns number in [0,1)), defaults to Math.random
      * @returns True if knockdown should occur
      *
-     * @public
      * @korean 넘어짐확인
      */
     shouldKnockdown(player: PlayerState, randomFn?: () => number): boolean;
@@ -302,7 +293,6 @@ export declare class BalanceSystem {
      * @param level - Balance level
      * @returns Korean and English level names
      *
-     * @public
      * @korean 균형이름
      */
     getLevelName(level: BalanceLevel): {
@@ -315,7 +305,6 @@ export declare class BalanceSystem {
      * @param level - Balance level
      * @returns Hex color code
      *
-     * @public
      * @korean 균형색상
      */
     getLevelColor(level: BalanceLevel): number;
@@ -340,7 +329,6 @@ export declare class BalanceSystem {
      * }
      * ```
      *
-     * @public
      * @korean 낙법발동확인
      */
     shouldTriggerFall(player: PlayerState): boolean;
@@ -381,7 +369,6 @@ export declare class BalanceSystem {
      * // Returns: 'side_right' (swept to the side)
      * ```
      *
-     * @public
      * @korean 낙법유형결정
      */
     determineFallType(_player: PlayerState, attackAngle: number, attackHeight?: "high" | "mid" | "low"): FallType;
@@ -403,7 +390,6 @@ export declare class BalanceSystem {
      * // Returns: 'forward' (Heaven stance has forward bias)
      * ```
      *
-     * @public
      * @korean 자세낙법결정
      */
     determineFallTypeFromStance(stance: TrigramStance): FallType;
@@ -425,7 +411,6 @@ export declare class BalanceSystem {
      * // Returns: false
      * ```
      *
-     * @public
      * @korean 지면상태확인
      */
     isGrounded(animationState: string): boolean;
@@ -447,7 +432,6 @@ export declare class BalanceSystem {
      * // Returns: null
      * ```
      *
-     * @public
      * @korean 지면자세가져오기
      */
     getGroundState(animationState: string): GroundState | null;
@@ -472,7 +456,6 @@ export declare class BalanceSystem {
      * // Returns: true (no stamina requirement)
      * ```
      *
-     * @public
      * @korean 회복가능확인
      */
     canRecoverWithType(player: PlayerState, recoveryType: RecoveryAnimationType): boolean;
@@ -493,7 +476,6 @@ export declare class BalanceSystem {
      * // recovered.stamina = player.stamina - 20
      * ```
      *
-     * @public
      * @korean 회복비용적용
      */
     applyRecoveryCost(player: PlayerState, recoveryType: RecoveryAnimationType): PlayerState;
@@ -518,7 +500,6 @@ export declare class BalanceSystem {
      * // Returns: 1.0 (full damage)
      * ```
      *
-     * @public
      * @korean 회복피해배율
      */
     getRecoveryDamageMultiplier(recoveryType: RecoveryAnimationType, currentFrame: number): number;
@@ -545,7 +526,6 @@ export declare class BalanceSystem {
      * // transitioning.transitionState.vulnerabilityMultiplier = 1.5
      * ```
      *
-     * @public
      * @korean 자세전환시작
      */
     startStanceTransition(player: BalancePlayerState, newStance: TrigramStance, currentTime: number): BalancePlayerState;
@@ -565,7 +545,6 @@ export declare class BalanceSystem {
      * player = balanceSystem.updateTransition(player, Date.now());
      * ```
      *
-     * @public
      * @korean 전환상태갱신
      */
     updateTransition(player: BalancePlayerState, currentTime: number): BalancePlayerState;
@@ -592,7 +571,6 @@ export declare class BalanceSystem {
      * const effectiveBalance = player.balance * modifier;
      * ```
      *
-     * @public
      * @korean 균형조정계수계산
      */
     calculateBalanceModifier(player: BalancePlayerState): number;
@@ -614,7 +592,6 @@ export declare class BalanceSystem {
      * const effectiveKnockback = baseKnockback * (1.0 / resistance);
      * ```
      *
-     * @public
      * @korean 넉백저항계산
      */
     getKnockbackResistance(stance: TrigramStance): number;
@@ -638,7 +615,6 @@ export declare class BalanceSystem {
      * }
      * ```
      *
-     * @public
      * @korean 급속변경벌칙확인
      */
     isRapidChangePenaltyActive(player: BalancePlayerState, currentTime: number): boolean;
@@ -658,7 +634,6 @@ export declare class BalanceSystem {
      * const finalDamage = baseDamage * multiplier;
      * ```
      *
-     * @public
      * @korean 총취약성배율
      */
     getTotalVulnerabilityMultiplier(player: BalancePlayerState): number;

package/lib/systems/combat/BalanceSystem.d.ts.map

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

package/lib/systems/combat/BalanceSystem.js

@@ -80,7 +80,6 @@ var BalanceLevel = /* @__PURE__ */ function(BalanceLevel) {
 * const recovered = balanceSystem.applyRecovery(newPlayer, 1000);
 * ```
 *
-* @public
 * @korean 균형시스템
 */
 var BalanceSystem = class {
@@ -184,7 +183,6 @@ var BalanceSystem = class {
 	* );
 	* ```
 	*
-	* @public
 	* @korean 균형파괴
 	*/
 	disruptBalance(player, impact, region, currentTime) {
@@ -219,7 +217,6 @@ var BalanceSystem = class {
 	* player = system.applyRecovery(player, 16); // ~60fps
 	* ```
 	*
-	* @public
 	* @korean 균형회복
 	*/
 	applyRecovery(player, deltaTime) {
@@ -245,7 +242,6 @@ var BalanceSystem = class {
 	* @param balance - Balance value (0-100)
 	* @returns Current balance level
 	*
-	* @public
 	* @korean 균형수준확인
 	*/
 	getBalanceLevel(balance) {
@@ -260,7 +256,6 @@ var BalanceSystem = class {
 	* @param level - Balance level
 	* @returns Effects applied at that level
 	*
-	* @public
 	* @korean 균형효과
 	*/
 	getEffects(level) {
@@ -274,7 +269,6 @@ var BalanceSystem = class {
 	* @param player - Current player state
 	* @returns Modified player state with balance effects
 	*
-	* @public
 	* @korean 균형효과적용
 	*/
 	applyEffects(player) {
@@ -292,7 +286,6 @@ var BalanceSystem = class {
 	* @param player - Current player state
 	* @returns True if off-balance or falling
 	*
-	* @public
 	* @korean 균형취약확인
 	*/
 	isVulnerable(player) {
@@ -305,7 +298,6 @@ var BalanceSystem = class {
 	* @param player - Current player state
 	* @returns Damage multiplier (1.0 = normal, >1.0 = increased damage)
 	*
-	* @public
 	* @korean 취약성배율
 	*/
 	getVulnerabilityMultiplier(player) {
@@ -319,7 +311,6 @@ var BalanceSystem = class {
 	* @param randomFn - Optional random number generator (returns number in [0,1)), defaults to Math.random
 	* @returns True if knockdown should occur
 	*
-	* @public
 	* @korean 넘어짐확인
 	*/
 	shouldKnockdown(player, randomFn = Math.random) {
@@ -333,7 +324,6 @@ var BalanceSystem = class {
 	* @param level - Balance level
 	* @returns Korean and English level names
 	*
-	* @public
 	* @korean 균형이름
 	*/
 	getLevelName(level) {
@@ -362,7 +352,6 @@ var BalanceSystem = class {
 	* @param level - Balance level
 	* @returns Hex color code
 	*
-	* @public
 	* @korean 균형색상
 	*/
 	getLevelColor(level) {
@@ -394,7 +383,6 @@ var BalanceSystem = class {
 	* }
 	* ```
 	*
-	* @public
 	* @korean 낙법발동확인
 	*/
 	shouldTriggerFall(player) {
@@ -437,7 +425,6 @@ var BalanceSystem = class {
 	* // Returns: 'side_right' (swept to the side)
 	* ```
 	*
-	* @public
 	* @korean 낙법유형결정
 	*/
 	determineFallType(_player, attackAngle, attackHeight = "mid") {
@@ -461,7 +448,6 @@ var BalanceSystem = class {
 	* // Returns: 'forward' (Heaven stance has forward bias)
 	* ```
 	*
-	* @public
 	* @korean 자세낙법결정
 	*/
 	determineFallTypeFromStance(stance) {
@@ -485,7 +471,6 @@ var BalanceSystem = class {
 	* // Returns: false
 	* ```
 	*
-	* @public
 	* @korean 지면상태확인
 	*/
 	isGrounded(animationState) {
@@ -509,7 +494,6 @@ var BalanceSystem = class {
 	* // Returns: null
 	* ```
 	*
-	* @public
 	* @korean 지면자세가져오기
 	*/
 	getGroundState(animationState) {
@@ -539,7 +523,6 @@ var BalanceSystem = class {
 	* // Returns: true (no stamina requirement)
 	* ```
 	*
-	* @public
 	* @korean 회복가능확인
 	*/
 	canRecoverWithType(player, recoveryType) {
@@ -563,7 +546,6 @@ var BalanceSystem = class {
 	* // recovered.stamina = player.stamina - 20
 	* ```
 	*
-	* @public
 	* @korean 회복비용적용
 	*/
 	applyRecoveryCost(player, recoveryType) {
@@ -595,7 +577,6 @@ var BalanceSystem = class {
 	* // Returns: 1.0 (full damage)
 	* ```
 	*
-	* @public
 	* @korean 회복피해배율
 	*/
 	getRecoveryDamageMultiplier(recoveryType, currentFrame) {
@@ -626,7 +607,6 @@ var BalanceSystem = class {
 	* // transitioning.transitionState.vulnerabilityMultiplier = 1.5
 	* ```
 	*
-	* @public
 	* @korean 자세전환시작
 	*/
 	startStanceTransition(player, newStance, currentTime) {
@@ -672,7 +652,6 @@ var BalanceSystem = class {
 	* player = balanceSystem.updateTransition(player, Date.now());
 	* ```
 	*
-	* @public
 	* @korean 전환상태갱신
 	*/
 	updateTransition(player, currentTime) {
@@ -710,7 +689,6 @@ var BalanceSystem = class {
 	* const effectiveBalance = player.balance * modifier;
 	* ```
 	*
-	* @public
 	* @korean 균형조정계수계산
 	*/
 	calculateBalanceModifier(player) {
@@ -742,7 +720,6 @@ var BalanceSystem = class {
 	* const effectiveKnockback = baseKnockback * (1.0 / resistance);
 	* ```
 	*
-	* @public
 	* @korean 넉백저항계산
 	*/
 	getKnockbackResistance(stance) {
@@ -770,7 +747,6 @@ var BalanceSystem = class {
 	* }
 	* ```
 	*
-	* @public
 	* @korean 급속변경벌칙확인
 	*/
 	isRapidChangePenaltyActive(player, currentTime) {
@@ -793,7 +769,6 @@ var BalanceSystem = class {
 	* const finalDamage = baseDamage * multiplier;
 	* ```
 	*
-	* @public
 	* @korean 총취약성배율
 	*/
 	getTotalVulnerabilityMultiplier(player) {