blacktrigram 0.7.44 → 0.7.45

package/lib/systems/combat/PainResponseSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"PainResponseSystem.js","names":[],"sources":["../../../src/systems/combat/PainResponseSystem.ts"],"sourcesContent":["/**\n * Pain Response System for managing cumulative pain effects in combat.\n * \n * **Korean**: 고통 반응 시스템 (Pain Response System)\n * \n * Implements realistic pain accumulation that progressively reduces combat\n * effectiveness. Unlike health, pain represents the body's protective response\n * to damage, reducing capabilities before critical injury occurs.\n * \n * ## Pain Mechanics\n * \n * - **충격통 (Shock Pain)**: Instant reaction affecting all abilities (10-30% reduction for 2-3 seconds)\n * - **누적외상 (Cumulative Trauma)**: Progressive damage impairment\n * - **통증과부하 (Pain Overload)**: Complete incapacitation from overwhelming pain (>80 pain)\n * - **무력화한계 (Incapacitation Threshold)**: Point of complete combat inability\n * \n * ## Pain Levels\n * \n * - **0-20**: Minimal pain - no significant effects\n * - **20-40**: Moderate pain - slight performance reduction (-10%)\n * - **40-60**: Significant pain - noticeable impairment (-20%)\n * - **60-80**: Severe pain - major limitations (-35%)\n * - **80-100**: Pain overload - chance of stun/unconsciousness, extreme impairment (-50%)\n * \n * @module systems/combat/PainResponseSystem\n * @category Combat System\n * @korean 고통반응시스템\n */\n\nimport { PlayerState } from \"../player\";\nimport { VitalPointSeverity, VitalPointCategory } from \"@/types\";\n\n/**\n * Pain level categories for status indication.\n */\nexport enum PainLevel {\n  /** Minimal pain (0-20) - no significant effects */\n  MINIMAL = \"minimal\",\n  /** Moderate pain (20-40) - slight performance reduction (-10%) */\n  MODERATE = \"moderate\",\n  /** Significant pain (40-60) - noticeable impairment (-20%) */\n  SIGNIFICANT = \"significant\",\n  /** Severe pain (60-80) - major limitations (-35%) */\n  SEVERE = \"severe\",\n  /** Pain overload (80-100) - chance of stun/unconsciousness, extreme impairment (-50%) */\n  OVERLOAD = \"overload\",\n}\n\n/**\n * Shock pain effect from sudden trauma.\n * \n * **Korean**: 충격통 효과 (Shock Pain Effect)\n * \n * Represents instant reaction to damage affecting all abilities for 2-3 seconds.\n */\nexport interface ShockPainEffect {\n  /** Intensity of shock pain (0.1-0.3 for 10-30% reduction) */\n  readonly intensity: number;\n  /** Duration remaining in milliseconds (2000-3000ms) */\n  readonly duration: number;\n  /** Timestamp when shock pain was applied */\n  readonly startTime: number;\n  /** Damage value that caused the shock */\n  readonly causedByDamage: number;\n}\n\n/**\n * Effects of pain on combat performance.\n */\ninterface PainEffects {\n  /** Pain value range */\n  readonly range: readonly [number, number];\n  /** Overall performance penalty multiplier */\n  readonly performancePenalty: number;\n  /** Accuracy reduction */\n  readonly accuracyReduction: number;\n  /** Damage output reduction */\n  readonly damageReduction: number;\n  /** Movement speed reduction */\n  readonly speedReduction: number;\n  /** Chance of involuntary stun (0-1) */\n  readonly stunChance: number;\n}\n\n/**\n * Pain Response System managing cumulative pain effects.\n * \n * Pain accumulates from all damage sources and reduces combat effectiveness\n * progressively. High pain can incapacitate even if health remains adequate.\n * Pain dissipates slowly over time.\n * \n * @example\n * ```typescript\n * const painSystem = new PainResponseSystem();\n * \n * // Apply pain from damage\n * const newPlayer = painSystem.applyPain(player, 15, VitalPointSeverity.MAJOR);\n * \n * // Check pain level\n * const level = painSystem.getPainLevel(newPlayer.pain);\n * \n * // Apply dissipation over time\n * const recovered = painSystem.applyDissipation(newPlayer, 1000);\n * ```\n * \n * @public\n * @korean 고통반응시스템\n */\nexport class PainResponseSystem {\n  /**\n   * Pain level effects and thresholds matching requirements.\n   */\n  private readonly painEffects: Record<PainLevel, PainEffects> = {\n    [PainLevel.MINIMAL]: {\n      range: [0, 20],\n      performancePenalty: 0.0,\n      accuracyReduction: 0.0,\n      damageReduction: 0.0,\n      speedReduction: 0.0,\n      stunChance: 0.0,\n    },\n    [PainLevel.MODERATE]: {\n      range: [20, 40],\n      performancePenalty: 0.1, // -10% overall\n      accuracyReduction: 0.1,\n      damageReduction: 0.1,\n      speedReduction: 0.05,\n      stunChance: 0.0,\n    },\n    [PainLevel.SIGNIFICANT]: {\n      range: [40, 60],\n      performancePenalty: 0.2, // -20% overall\n      accuracyReduction: 0.2,\n      damageReduction: 0.2,\n      speedReduction: 0.15,\n      stunChance: 0.05, // 5% chance\n    },\n    [PainLevel.SEVERE]: {\n      range: [60, 80],\n      performancePenalty: 0.35, // -35% overall\n      accuracyReduction: 0.35,\n      damageReduction: 0.35,\n      speedReduction: 0.25,\n      stunChance: 0.15, // 15% chance\n    },\n    [PainLevel.OVERLOAD]: {\n      range: [80, 100],\n      performancePenalty: 0.5, // -50% overall\n      accuracyReduction: 0.5,\n      damageReduction: 0.5,\n      speedReduction: 0.4,\n      stunChance: 0.3, // 30% chance per hit at pain >80\n    },\n  };\n\n  /**\n   * Pain multipliers by vital point severity.\n   */\n  private readonly severityMultipliers: Record<VitalPointSeverity, number> = {\n    [VitalPointSeverity.MINOR]: 0.5,\n    [VitalPointSeverity.MODERATE]: 1.0,\n    [VitalPointSeverity.MAJOR]: 1.5,\n    [VitalPointSeverity.CRITICAL]: 2.0,\n    [VitalPointSeverity.LETHAL]: 3.0,\n  };\n\n  /**\n   * Pain multipliers by vital point category.\n   */\n  private readonly categoryMultipliers: Record<string, number> = {\n    [VitalPointCategory.NEUROLOGICAL]: 2.5, // Nerve strikes cause intense pain\n    [VitalPointCategory.VASCULAR]: 1.5, // Blood flow restriction\n    [VitalPointCategory.RESPIRATORY]: 2.0, // Breathing difficulty causes panic\n    [VitalPointCategory.SKELETAL]: 1.8, // Bone/structural damage\n    [VitalPointCategory.MUSCULAR]: 1.4, // Muscle trauma\n    [VitalPointCategory.ORGAN]: 2.2, // Internal organ trauma\n    [VitalPointCategory.JOINT]: 1.9, // Joint damage\n    [VitalPointCategory.CIRCULATORY]: 1.6, // Circulatory disruption\n    default: 1.0, // Standard damage\n  };\n\n  /**\n   * Base pain dissipation rate per second (requirement: -5 pain/second).\n   */\n  private readonly BASE_DISSIPATION_RATE = 5.0; // -5 pain per second\n\n  /**\n   * Shock pain duration range in milliseconds (requirement: 2-3 seconds).\n   */\n  private readonly SHOCK_PAIN_DURATION = {\n    min: 2000, // 2 seconds\n    max: 3000, // 3 seconds\n  };\n\n  /**\n   * Minimum damage to trigger shock pain.\n   */\n  private readonly SHOCK_PAIN_THRESHOLD = 10;\n\n  /**\n   * Pain overload threshold for stun chance (requirement: >80).\n   */\n  private readonly PAIN_OVERLOAD_THRESHOLD = 80;\n\n  /**\n   * Shock pain intensity constants.\n   */\n  private readonly MAX_SHOCK_INTENSITY = 0.3; // 30% max reduction\n  private readonly MIN_SHOCK_INTENSITY = 0.1; // 10% min reduction\n  private readonly DAMAGE_SCALE_FACTOR = 100; // for normalizing damage to 0-1 range\n  private readonly INTENSITY_RANGE = 0.2; // 20% variable range\n\n  /**\n   * Pain to damage ratio for cumulative trauma calculation.\n   */\n  private readonly PAIN_TO_DAMAGE_RATIO = 0.5;\n\n  /**\n   * Applies pain from combat damage with shock pain effects.\n   * \n   * Calculates pain increase based on damage amount, vital point severity,\n   * and vital point category. Also determines if shock pain effect should be triggered.\n   * \n   * **Shock Pain**: Instant 10-30% reduction for 2-3 seconds on significant hits (>=10 damage)\n   * **Cumulative Trauma**: Progressive pain accumulation that reduces performance\n   * **Pain Overload**: At >80 pain, chance of stun/unconsciousness\n   * \n   * @param player - Current player state\n   * @param damage - Base damage amount\n   * @param severity - Optional vital point severity\n   * @param category - Optional vital point category for more accurate pain calculation\n   * @returns Updated player state with increased pain and optional shock effect\n   * \n   * @example\n   * ```typescript\n   * // Normal hit\n   * const result = system.applyPain(player, 10);\n   * \n   * // Vital point neurological hit with shock pain\n   * const result = system.applyPain(\n   *   player, \n   *   20, \n   *   VitalPointSeverity.MAJOR,\n   *   VitalPointCategory.NEUROLOGICAL\n   * );\n   * if (result.shockEffect) {\n   *   console.log(`Shock pain active for ${result.shockEffect.duration}ms`);\n   * }\n   * ```\n   * \n   * @public\n   * @korean 고통적용\n   */\n  applyPain(\n    player: PlayerState,\n    damage: number,\n    severity?: VitalPointSeverity,\n    category?: VitalPointCategory\n  ): { player: PlayerState; shockEffect?: ShockPainEffect } {\n    // Get multipliers based on severity and category\n    const severityMultiplier = severity\n      ? this.severityMultipliers[severity]\n      : 1.0;\n    \n    const categoryMultiplier = category\n      ? this.categoryMultipliers[category] ?? this.categoryMultipliers.default\n      : this.categoryMultipliers.default;\n\n    // Calculate pain increase (cumulative trauma)\n    const painIncrease = damage * severityMultiplier * categoryMultiplier * this.PAIN_TO_DAMAGE_RATIO;\n\n    // Apply pain, clamped to 0-100\n    const newPain = Math.max(0, Math.min(100, player.pain + painIncrease));\n\n    let shockEffect: ShockPainEffect | undefined;\n\n    // Trigger shock pain for significant hits (>=10 damage)\n    if (damage >= this.SHOCK_PAIN_THRESHOLD) {\n      // Calculate shock intensity: 10-30% reduction based on damage\n      const shockIntensity = Math.min(\n        this.MAX_SHOCK_INTENSITY,\n        this.MIN_SHOCK_INTENSITY + (damage / this.DAMAGE_SCALE_FACTOR) * this.INTENSITY_RANGE\n      );\n      \n      // Random duration between 2-3 seconds\n      const shockDuration =\n        this.SHOCK_PAIN_DURATION.min +\n        Math.random() *\n          (this.SHOCK_PAIN_DURATION.max - this.SHOCK_PAIN_DURATION.min);\n\n      shockEffect = {\n        intensity: shockIntensity,\n        duration: shockDuration,\n        startTime: Date.now(),\n        causedByDamage: damage,\n      };\n    }\n\n    const updatedPlayer: PlayerState = {\n      ...player,\n      pain: newPain,\n    };\n\n    return { player: updatedPlayer, shockEffect };\n  }\n\n  /**\n   * Applies pain dissipation over time (requirement: -5 pain/second).\n   * \n   * Pain naturally dissipates when not taking damage at a constant rate\n   * of -5 pain per second.\n   * \n   * @param player - Current player state\n   * @param deltaTime - Time elapsed in milliseconds\n   * @returns Updated player state with reduced pain\n   * \n   * @example\n   * ```typescript\n   * // In game loop (~60fps, 16ms per frame)\n   * player = system.applyDissipation(player, 16);\n   * ```\n   * \n   * @public\n   * @korean 고통감소\n   */\n  applyDissipation(player: PlayerState, deltaTime: number): PlayerState {\n    // Already at zero pain\n    if (player.pain <= 0) {\n      return player;\n    }\n\n    const deltaSeconds = deltaTime / 1000;\n    \n    // Constant dissipation rate of -5 pain/second\n    const dissipation = this.BASE_DISSIPATION_RATE * deltaSeconds;\n    const newPain = Math.max(0, player.pain - dissipation);\n\n    return {\n      ...player,\n      pain: newPain,\n    };\n  }\n\n  /**\n   * Determines pain level from pain value.\n   * \n   * @param pain - Pain value (0-100)\n   * @returns Current pain level\n   * \n   * @public\n   * @korean 고통수준확인\n   */\n  getPainLevel(pain: number): PainLevel {\n    if (pain >= 80) return PainLevel.OVERLOAD;\n    if (pain >= 60) return PainLevel.SEVERE;\n    if (pain >= 40) return PainLevel.SIGNIFICANT;\n    if (pain >= 20) return PainLevel.MODERATE;\n    return PainLevel.MINIMAL;\n  }\n\n  /**\n   * Gets effects for a specific pain level.\n   * \n   * @param level - Pain level\n   * @returns Effects applied at that level\n   * \n   * @public\n   * @korean 고통효과\n   */\n  getEffects(level: PainLevel): PainEffects {\n    return this.painEffects[level];\n  }\n\n  /**\n   * Applies pain effects to player state, including shock pain.\n   * \n   * Modifies player stats based on current pain level. When shock pain\n   * is active, additional penalties are applied temporarily.\n   * \n   * @param player - Current player state\n   * @param shockEffect - Optional active shock pain effect\n   * @returns Modified player state with pain effects\n   * \n   * @public\n   * @korean 고통효과적용\n   */\n  applyEffects(\n    player: PlayerState,\n    shockEffect?: ShockPainEffect\n  ): PlayerState {\n    const level = this.getPainLevel(player.pain);\n    const effects = this.getEffects(level);\n\n    // Calculate total penalties (base pain + shock pain if active)\n    let totalAccuracyPenalty = effects.accuracyReduction;\n    let totalDamagePenalty = effects.damageReduction;\n\n    // Apply shock pain if still active\n    if (shockEffect) {\n      const elapsed = Date.now() - shockEffect.startTime;\n      if (elapsed < shockEffect.duration) {\n        // Add shock pain intensity to penalties\n        totalAccuracyPenalty = Math.min(\n          1.0,\n          totalAccuracyPenalty + shockEffect.intensity\n        );\n        totalDamagePenalty = Math.min(\n          1.0,\n          totalDamagePenalty + shockEffect.intensity\n        );\n      }\n    }\n\n    return {\n      ...player,\n      attackPower: Math.floor(\n        player.attackPower * (1 - totalDamagePenalty)\n      ),\n      defense: Math.floor(\n        player.defense * (1 - effects.performancePenalty)\n      ),\n      speed: Math.floor(\n        player.speed * (1 - effects.speedReduction)\n      ),\n      technique: Math.floor(\n        player.technique * (1 - totalAccuracyPenalty)\n      ),\n    };\n  }\n\n  /**\n   * Checks if pain overload should trigger stun.\n   * \n   * At pain >80, there's a chance per hit to trigger stun based on pain level.\n   * Pain Overload level has 30% chance to trigger stun.\n   * \n   * @param player - Current player state\n   * @returns True if player should be stunned from pain\n   * \n   * @public\n   * @korean 고통기절확인\n   */\n  shouldTriggerStun(player: PlayerState): boolean {\n    if (player.pain < this.PAIN_OVERLOAD_THRESHOLD) {\n      return false;\n    }\n\n    const level = this.getPainLevel(player.pain);\n    const effects = this.getEffects(level);\n\n    // Roll for stun chance\n    return Math.random() < effects.stunChance;\n  }\n\n  /**\n   * Checks if player is in pain overload state (>80 pain).\n   * \n   * @param player - Current player state\n   * @returns True if pain is above overload threshold\n   * \n   * @public\n   * @korean 고통과부하확인\n   */\n  isInPainOverload(player: PlayerState): boolean {\n    return player.pain >= this.PAIN_OVERLOAD_THRESHOLD;\n  }\n\n  /**\n   * Checks if player is incapacitated by pain.\n   * \n   * @param player - Current player state\n   * @returns True if pain is at overload level\n   * \n   * @public\n   * @korean 고통무력화확인\n   */\n  isIncapacitated(player: PlayerState): boolean {\n    return this.getPainLevel(player.pain) === PainLevel.OVERLOAD;\n  }\n\n  /**\n   * Gets bilingual name for pain level.\n   * \n   * @param level - Pain level\n   * @returns Korean and English level names\n   * \n   * @public\n   * @korean 고통이름\n   */\n  getLevelName(level: PainLevel): { korean: string; english: string } {\n    const names: Record<PainLevel, { korean: string; english: string }> = {\n      [PainLevel.MINIMAL]: {\n        korean: \"최소\",\n        english: \"Minimal\",\n      },\n      [PainLevel.MODERATE]: {\n        korean: \"보통\",\n        english: \"Moderate\",\n      },\n      [PainLevel.SIGNIFICANT]: {\n        korean: \"상당\",\n        english: \"Significant\",\n      },\n      [PainLevel.SEVERE]: {\n        korean: \"심각\",\n        english: \"Severe\",\n      },\n      [PainLevel.OVERLOAD]: {\n        korean: \"과부하\",\n        english: \"Overload\",\n      },\n    };\n\n    return names[level];\n  }\n\n  /**\n   * Gets description of pain level effects.\n   * \n   * @param level - Pain level\n   * @returns Bilingual description\n   * \n   * @public\n   * @korean 고통설명\n   */\n  getLevelDescription(level: PainLevel): {\n    korean: string;\n    english: string;\n  } {\n    const descriptions: Record<\n      PainLevel,\n      { korean: string; english: string }\n    > = {\n      [PainLevel.MINIMAL]: {\n        korean: \"최소한의 고통, 전투 능력에 영향 없음\",\n        english: \"Minimal pain, no significant effects on combat\",\n      },\n      [PainLevel.MODERATE]: {\n        korean: \"보통 고통, 약간의 능력 저하 (-10%)\",\n        english: \"Moderate pain, slight performance reduction (-10%)\",\n      },\n      [PainLevel.SIGNIFICANT]: {\n        korean: \"상당한 고통, 명확한 손상 (-20%)\",\n        english: \"Significant pain, noticeable impairment (-20%)\",\n      },\n      [PainLevel.SEVERE]: {\n        korean: \"심각한 고통, 주요 제한 (-35%)\",\n        english: \"Severe pain, major limitations (-35%)\",\n      },\n      [PainLevel.OVERLOAD]: {\n        korean: \"고통 과부하, 기절 위험 (-50%, 30% 기절 확률)\",\n        english: \"Pain overload, stun risk (-50%, 30% stun chance)\",\n      },\n    };\n\n    return descriptions[level];\n  }\n}\n\nexport default PainResponseSystem;\n"],"mappings":"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"}
+{"version":3,"file":"PainResponseSystem.js","names":[],"sources":["../../../src/systems/combat/PainResponseSystem.ts"],"sourcesContent":["/**\n * Pain Response System for managing cumulative pain effects in combat.\n * \n * **Korean**: 고통 반응 시스템 (Pain Response System)\n * \n * Implements realistic pain accumulation that progressively reduces combat\n * effectiveness. Unlike health, pain represents the body's protective response\n * to damage, reducing capabilities before critical injury occurs.\n * \n * ## Pain Mechanics\n * \n * - **충격통 (Shock Pain)**: Instant reaction affecting all abilities (10-30% reduction for 2-3 seconds)\n * - **누적외상 (Cumulative Trauma)**: Progressive damage impairment\n * - **통증과부하 (Pain Overload)**: Complete incapacitation from overwhelming pain (>80 pain)\n * - **무력화한계 (Incapacitation Threshold)**: Point of complete combat inability\n * \n * ## Pain Levels\n * \n * - **0-20**: Minimal pain - no significant effects\n * - **20-40**: Moderate pain - slight performance reduction (-10%)\n * - **40-60**: Significant pain - noticeable impairment (-20%)\n * - **60-80**: Severe pain - major limitations (-35%)\n * - **80-100**: Pain overload - chance of stun/unconsciousness, extreme impairment (-50%)\n * \n * @module systems/combat/PainResponseSystem\n * @category Combat System\n * @korean 고통반응시스템\n */\n\nimport { PlayerState } from \"../player\";\nimport { VitalPointSeverity, VitalPointCategory } from \"@/types\";\n\n/**\n * Pain level categories for status indication.\n */\nexport enum PainLevel {\n  /** Minimal pain (0-20) - no significant effects */\n  MINIMAL = \"minimal\",\n  /** Moderate pain (20-40) - slight performance reduction (-10%) */\n  MODERATE = \"moderate\",\n  /** Significant pain (40-60) - noticeable impairment (-20%) */\n  SIGNIFICANT = \"significant\",\n  /** Severe pain (60-80) - major limitations (-35%) */\n  SEVERE = \"severe\",\n  /** Pain overload (80-100) - chance of stun/unconsciousness, extreme impairment (-50%) */\n  OVERLOAD = \"overload\",\n}\n\n/**\n * Shock pain effect from sudden trauma.\n * \n * **Korean**: 충격통 효과 (Shock Pain Effect)\n * \n * Represents instant reaction to damage affecting all abilities for 2-3 seconds.\n */\nexport interface ShockPainEffect {\n  /** Intensity of shock pain (0.1-0.3 for 10-30% reduction) */\n  readonly intensity: number;\n  /** Duration remaining in milliseconds (2000-3000ms) */\n  readonly duration: number;\n  /** Timestamp when shock pain was applied */\n  readonly startTime: number;\n  /** Damage value that caused the shock */\n  readonly causedByDamage: number;\n}\n\n/**\n * Effects of pain on combat performance.\n */\ninterface PainEffects {\n  /** Pain value range */\n  readonly range: readonly [number, number];\n  /** Overall performance penalty multiplier */\n  readonly performancePenalty: number;\n  /** Accuracy reduction */\n  readonly accuracyReduction: number;\n  /** Damage output reduction */\n  readonly damageReduction: number;\n  /** Movement speed reduction */\n  readonly speedReduction: number;\n  /** Chance of involuntary stun (0-1) */\n  readonly stunChance: number;\n}\n\n/**\n * Pain Response System managing cumulative pain effects.\n * \n * Pain accumulates from all damage sources and reduces combat effectiveness\n * progressively. High pain can incapacitate even if health remains adequate.\n * Pain dissipates slowly over time.\n * \n * @example\n * ```typescript\n * const painSystem = new PainResponseSystem();\n * \n * // Apply pain from damage\n * const newPlayer = painSystem.applyPain(player, 15, VitalPointSeverity.MAJOR);\n * \n * // Check pain level\n * const level = painSystem.getPainLevel(newPlayer.pain);\n * \n * // Apply dissipation over time\n * const recovered = painSystem.applyDissipation(newPlayer, 1000);\n * ```\n * \n * @korean 고통반응시스템\n */\nexport class PainResponseSystem {\n  /**\n   * Pain level effects and thresholds matching requirements.\n   */\n  private readonly painEffects: Record<PainLevel, PainEffects> = {\n    [PainLevel.MINIMAL]: {\n      range: [0, 20],\n      performancePenalty: 0.0,\n      accuracyReduction: 0.0,\n      damageReduction: 0.0,\n      speedReduction: 0.0,\n      stunChance: 0.0,\n    },\n    [PainLevel.MODERATE]: {\n      range: [20, 40],\n      performancePenalty: 0.1, // -10% overall\n      accuracyReduction: 0.1,\n      damageReduction: 0.1,\n      speedReduction: 0.05,\n      stunChance: 0.0,\n    },\n    [PainLevel.SIGNIFICANT]: {\n      range: [40, 60],\n      performancePenalty: 0.2, // -20% overall\n      accuracyReduction: 0.2,\n      damageReduction: 0.2,\n      speedReduction: 0.15,\n      stunChance: 0.05, // 5% chance\n    },\n    [PainLevel.SEVERE]: {\n      range: [60, 80],\n      performancePenalty: 0.35, // -35% overall\n      accuracyReduction: 0.35,\n      damageReduction: 0.35,\n      speedReduction: 0.25,\n      stunChance: 0.15, // 15% chance\n    },\n    [PainLevel.OVERLOAD]: {\n      range: [80, 100],\n      performancePenalty: 0.5, // -50% overall\n      accuracyReduction: 0.5,\n      damageReduction: 0.5,\n      speedReduction: 0.4,\n      stunChance: 0.3, // 30% chance per hit at pain >80\n    },\n  };\n\n  /**\n   * Pain multipliers by vital point severity.\n   */\n  private readonly severityMultipliers: Record<VitalPointSeverity, number> = {\n    [VitalPointSeverity.MINOR]: 0.5,\n    [VitalPointSeverity.MODERATE]: 1.0,\n    [VitalPointSeverity.MAJOR]: 1.5,\n    [VitalPointSeverity.CRITICAL]: 2.0,\n    [VitalPointSeverity.LETHAL]: 3.0,\n  };\n\n  /**\n   * Pain multipliers by vital point category.\n   */\n  private readonly categoryMultipliers: Record<string, number> = {\n    [VitalPointCategory.NEUROLOGICAL]: 2.5, // Nerve strikes cause intense pain\n    [VitalPointCategory.VASCULAR]: 1.5, // Blood flow restriction\n    [VitalPointCategory.RESPIRATORY]: 2.0, // Breathing difficulty causes panic\n    [VitalPointCategory.SKELETAL]: 1.8, // Bone/structural damage\n    [VitalPointCategory.MUSCULAR]: 1.4, // Muscle trauma\n    [VitalPointCategory.ORGAN]: 2.2, // Internal organ trauma\n    [VitalPointCategory.JOINT]: 1.9, // Joint damage\n    [VitalPointCategory.CIRCULATORY]: 1.6, // Circulatory disruption\n    default: 1.0, // Standard damage\n  };\n\n  /**\n   * Base pain dissipation rate per second (requirement: -5 pain/second).\n   */\n  private readonly BASE_DISSIPATION_RATE = 5.0; // -5 pain per second\n\n  /**\n   * Shock pain duration range in milliseconds (requirement: 2-3 seconds).\n   */\n  private readonly SHOCK_PAIN_DURATION = {\n    min: 2000, // 2 seconds\n    max: 3000, // 3 seconds\n  };\n\n  /**\n   * Minimum damage to trigger shock pain.\n   */\n  private readonly SHOCK_PAIN_THRESHOLD = 10;\n\n  /**\n   * Pain overload threshold for stun chance (requirement: >80).\n   */\n  private readonly PAIN_OVERLOAD_THRESHOLD = 80;\n\n  /**\n   * Shock pain intensity constants.\n   */\n  private readonly MAX_SHOCK_INTENSITY = 0.3; // 30% max reduction\n  private readonly MIN_SHOCK_INTENSITY = 0.1; // 10% min reduction\n  private readonly DAMAGE_SCALE_FACTOR = 100; // for normalizing damage to 0-1 range\n  private readonly INTENSITY_RANGE = 0.2; // 20% variable range\n\n  /**\n   * Pain to damage ratio for cumulative trauma calculation.\n   */\n  private readonly PAIN_TO_DAMAGE_RATIO = 0.5;\n\n  /**\n   * Applies pain from combat damage with shock pain effects.\n   * \n   * Calculates pain increase based on damage amount, vital point severity,\n   * and vital point category. Also determines if shock pain effect should be triggered.\n   * \n   * **Shock Pain**: Instant 10-30% reduction for 2-3 seconds on significant hits (>=10 damage)\n   * **Cumulative Trauma**: Progressive pain accumulation that reduces performance\n   * **Pain Overload**: At >80 pain, chance of stun/unconsciousness\n   * \n   * @param player - Current player state\n   * @param damage - Base damage amount\n   * @param severity - Optional vital point severity\n   * @param category - Optional vital point category for more accurate pain calculation\n   * @returns Updated player state with increased pain and optional shock effect\n   * \n   * @example\n   * ```typescript\n   * // Normal hit\n   * const result = system.applyPain(player, 10);\n   * \n   * // Vital point neurological hit with shock pain\n   * const result = system.applyPain(\n   *   player, \n   *   20, \n   *   VitalPointSeverity.MAJOR,\n   *   VitalPointCategory.NEUROLOGICAL\n   * );\n   * if (result.shockEffect) {\n   *   console.log(`Shock pain active for ${result.shockEffect.duration}ms`);\n   * }\n   * ```\n   * \n   * @korean 고통적용\n   */\n  applyPain(\n    player: PlayerState,\n    damage: number,\n    severity?: VitalPointSeverity,\n    category?: VitalPointCategory\n  ): { player: PlayerState; shockEffect?: ShockPainEffect } {\n    // Get multipliers based on severity and category\n    const severityMultiplier = severity\n      ? this.severityMultipliers[severity]\n      : 1.0;\n    \n    const categoryMultiplier = category\n      ? this.categoryMultipliers[category] ?? this.categoryMultipliers.default\n      : this.categoryMultipliers.default;\n\n    // Calculate pain increase (cumulative trauma)\n    const painIncrease = damage * severityMultiplier * categoryMultiplier * this.PAIN_TO_DAMAGE_RATIO;\n\n    // Apply pain, clamped to 0-100\n    const newPain = Math.max(0, Math.min(100, player.pain + painIncrease));\n\n    let shockEffect: ShockPainEffect | undefined;\n\n    // Trigger shock pain for significant hits (>=10 damage)\n    if (damage >= this.SHOCK_PAIN_THRESHOLD) {\n      // Calculate shock intensity: 10-30% reduction based on damage\n      const shockIntensity = Math.min(\n        this.MAX_SHOCK_INTENSITY,\n        this.MIN_SHOCK_INTENSITY + (damage / this.DAMAGE_SCALE_FACTOR) * this.INTENSITY_RANGE\n      );\n      \n      // Random duration between 2-3 seconds\n      const shockDuration =\n        this.SHOCK_PAIN_DURATION.min +\n        Math.random() *\n          (this.SHOCK_PAIN_DURATION.max - this.SHOCK_PAIN_DURATION.min);\n\n      shockEffect = {\n        intensity: shockIntensity,\n        duration: shockDuration,\n        startTime: Date.now(),\n        causedByDamage: damage,\n      };\n    }\n\n    const updatedPlayer: PlayerState = {\n      ...player,\n      pain: newPain,\n    };\n\n    return { player: updatedPlayer, shockEffect };\n  }\n\n  /**\n   * Applies pain dissipation over time (requirement: -5 pain/second).\n   * \n   * Pain naturally dissipates when not taking damage at a constant rate\n   * of -5 pain per second.\n   * \n   * @param player - Current player state\n   * @param deltaTime - Time elapsed in milliseconds\n   * @returns Updated player state with reduced pain\n   * \n   * @example\n   * ```typescript\n   * // In game loop (~60fps, 16ms per frame)\n   * player = system.applyDissipation(player, 16);\n   * ```\n   * \n   * @korean 고통감소\n   */\n  applyDissipation(player: PlayerState, deltaTime: number): PlayerState {\n    // Already at zero pain\n    if (player.pain <= 0) {\n      return player;\n    }\n\n    const deltaSeconds = deltaTime / 1000;\n    \n    // Constant dissipation rate of -5 pain/second\n    const dissipation = this.BASE_DISSIPATION_RATE * deltaSeconds;\n    const newPain = Math.max(0, player.pain - dissipation);\n\n    return {\n      ...player,\n      pain: newPain,\n    };\n  }\n\n  /**\n   * Determines pain level from pain value.\n   * \n   * @param pain - Pain value (0-100)\n   * @returns Current pain level\n   * \n   * @korean 고통수준확인\n   */\n  getPainLevel(pain: number): PainLevel {\n    if (pain >= 80) return PainLevel.OVERLOAD;\n    if (pain >= 60) return PainLevel.SEVERE;\n    if (pain >= 40) return PainLevel.SIGNIFICANT;\n    if (pain >= 20) return PainLevel.MODERATE;\n    return PainLevel.MINIMAL;\n  }\n\n  /**\n   * Gets effects for a specific pain level.\n   * \n   * @param level - Pain level\n   * @returns Effects applied at that level\n   * \n   * @korean 고통효과\n   */\n  getEffects(level: PainLevel): PainEffects {\n    return this.painEffects[level];\n  }\n\n  /**\n   * Applies pain effects to player state, including shock pain.\n   * \n   * Modifies player stats based on current pain level. When shock pain\n   * is active, additional penalties are applied temporarily.\n   * \n   * @param player - Current player state\n   * @param shockEffect - Optional active shock pain effect\n   * @returns Modified player state with pain effects\n   * \n   * @korean 고통효과적용\n   */\n  applyEffects(\n    player: PlayerState,\n    shockEffect?: ShockPainEffect\n  ): PlayerState {\n    const level = this.getPainLevel(player.pain);\n    const effects = this.getEffects(level);\n\n    // Calculate total penalties (base pain + shock pain if active)\n    let totalAccuracyPenalty = effects.accuracyReduction;\n    let totalDamagePenalty = effects.damageReduction;\n\n    // Apply shock pain if still active\n    if (shockEffect) {\n      const elapsed = Date.now() - shockEffect.startTime;\n      if (elapsed < shockEffect.duration) {\n        // Add shock pain intensity to penalties\n        totalAccuracyPenalty = Math.min(\n          1.0,\n          totalAccuracyPenalty + shockEffect.intensity\n        );\n        totalDamagePenalty = Math.min(\n          1.0,\n          totalDamagePenalty + shockEffect.intensity\n        );\n      }\n    }\n\n    return {\n      ...player,\n      attackPower: Math.floor(\n        player.attackPower * (1 - totalDamagePenalty)\n      ),\n      defense: Math.floor(\n        player.defense * (1 - effects.performancePenalty)\n      ),\n      speed: Math.floor(\n        player.speed * (1 - effects.speedReduction)\n      ),\n      technique: Math.floor(\n        player.technique * (1 - totalAccuracyPenalty)\n      ),\n    };\n  }\n\n  /**\n   * Checks if pain overload should trigger stun.\n   * \n   * At pain >80, there's a chance per hit to trigger stun based on pain level.\n   * Pain Overload level has 30% chance to trigger stun.\n   * \n   * @param player - Current player state\n   * @returns True if player should be stunned from pain\n   * \n   * @korean 고통기절확인\n   */\n  shouldTriggerStun(player: PlayerState): boolean {\n    if (player.pain < this.PAIN_OVERLOAD_THRESHOLD) {\n      return false;\n    }\n\n    const level = this.getPainLevel(player.pain);\n    const effects = this.getEffects(level);\n\n    // Roll for stun chance\n    return Math.random() < effects.stunChance;\n  }\n\n  /**\n   * Checks if player is in pain overload state (>80 pain).\n   * \n   * @param player - Current player state\n   * @returns True if pain is above overload threshold\n   * \n   * @korean 고통과부하확인\n   */\n  isInPainOverload(player: PlayerState): boolean {\n    return player.pain >= this.PAIN_OVERLOAD_THRESHOLD;\n  }\n\n  /**\n   * Checks if player is incapacitated by pain.\n   * \n   * @param player - Current player state\n   * @returns True if pain is at overload level\n   * \n   * @korean 고통무력화확인\n   */\n  isIncapacitated(player: PlayerState): boolean {\n    return this.getPainLevel(player.pain) === PainLevel.OVERLOAD;\n  }\n\n  /**\n   * Gets bilingual name for pain level.\n   * \n   * @param level - Pain level\n   * @returns Korean and English level names\n   * \n   * @korean 고통이름\n   */\n  getLevelName(level: PainLevel): { korean: string; english: string } {\n    const names: Record<PainLevel, { korean: string; english: string }> = {\n      [PainLevel.MINIMAL]: {\n        korean: \"최소\",\n        english: \"Minimal\",\n      },\n      [PainLevel.MODERATE]: {\n        korean: \"보통\",\n        english: \"Moderate\",\n      },\n      [PainLevel.SIGNIFICANT]: {\n        korean: \"상당\",\n        english: \"Significant\",\n      },\n      [PainLevel.SEVERE]: {\n        korean: \"심각\",\n        english: \"Severe\",\n      },\n      [PainLevel.OVERLOAD]: {\n        korean: \"과부하\",\n        english: \"Overload\",\n      },\n    };\n\n    return names[level];\n  }\n\n  /**\n   * Gets description of pain level effects.\n   * \n   * @param level - Pain level\n   * @returns Bilingual description\n   * \n   * @korean 고통설명\n   */\n  getLevelDescription(level: PainLevel): {\n    korean: string;\n    english: string;\n  } {\n    const descriptions: Record<\n      PainLevel,\n      { korean: string; english: string }\n    > = {\n      [PainLevel.MINIMAL]: {\n        korean: \"최소한의 고통, 전투 능력에 영향 없음\",\n        english: \"Minimal pain, no significant effects on combat\",\n      },\n      [PainLevel.MODERATE]: {\n        korean: \"보통 고통, 약간의 능력 저하 (-10%)\",\n        english: \"Moderate pain, slight performance reduction (-10%)\",\n      },\n      [PainLevel.SIGNIFICANT]: {\n        korean: \"상당한 고통, 명확한 손상 (-20%)\",\n        english: \"Significant pain, noticeable impairment (-20%)\",\n      },\n      [PainLevel.SEVERE]: {\n        korean: \"심각한 고통, 주요 제한 (-35%)\",\n        english: \"Severe pain, major limitations (-35%)\",\n      },\n      [PainLevel.OVERLOAD]: {\n        korean: \"고통 과부하, 기절 위험 (-50%, 30% 기절 확률)\",\n        english: \"Pain overload, stun risk (-50%, 30% stun chance)\",\n      },\n    };\n\n    return descriptions[level];\n  }\n}\n\nexport default PainResponseSystem;\n"],"mappings":"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"}

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

@@ -52,7 +52,6 @@ export interface PainConsciousnessStatus {
  * console.log(`Status: ${status.statusDescription.english}`);
  * ```
  *
- * @public
  * @korean 상태확인
  */
 export declare function getPainConsciousnessStatus(player: PlayerState, painSystem: PainResponseSystem, consciousnessSystem: ConsciousnessSystem): PainConsciousnessStatus;
@@ -69,7 +68,6 @@ export declare function getPainConsciousnessStatus(player: PlayerState, painSyst
  * @param category - Vital point category if known
  * @returns True if result should cause head trauma
  *
- * @public
  * @korean 두부외상확인
  */
 export declare function isHeadTraumaHit(result: CombatResult, category?: VitalPointCategory): boolean;
@@ -81,7 +79,6 @@ export declare function isHeadTraumaHit(result: CombatResult, category?: VitalPo
  * @param result - Combat result
  * @returns Vital point category if determinable
  *
- * @public
  * @korean 급소분류추출
  */
 export declare function extractVitalPointCategory(result: CombatResult): VitalPointCategory | undefined;
@@ -98,7 +95,6 @@ export declare function extractVitalPointCategory(result: CombatResult): VitalPo
  * console.log(`Recovery needed: ${recoveryTime}s`);
  * ```
  *
- * @public
  * @korean 회복시간계산
  */
 export declare function getRecommendedRecoveryTime(player: PlayerState, consciousnessSystem: ConsciousnessSystem): number;
@@ -108,7 +104,6 @@ export declare function getRecommendedRecoveryTime(player: PlayerState, consciou
  * @param shockEffect - Shock pain effect to check
  * @returns True if effect is still active
  *
- * @public
  * @korean 충격통활성확인
  */
 export declare function isShockPainActive(shockEffect: ShockPainEffect): boolean;
@@ -118,7 +113,6 @@ export declare function isShockPainActive(shockEffect: ShockPainEffect): boolean
  * @param shockEffect - Shock pain effect
  * @returns Remaining duration in milliseconds, or 0 if expired
  *
- * @public
  * @korean 충격통잔여시간
  */
 export declare function getShockPainRemainingDuration(shockEffect: ShockPainEffect): number;
@@ -135,7 +129,6 @@ export declare function getShockPainRemainingDuration(shockEffect: ShockPainEffe
  * console.log(display.consciousness); // "Consciousness: 85/100"
  * ```
  *
- * @public
  * @korean 표시형식
  */
 export declare function formatPainConsciousnessDisplay(player: PlayerState): {

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

@@ -1 +1 @@
-{"version":3,"file":"painConsciousnessUtils.d.ts","sourceRoot":"","sources":["../../../src/systems/combat/painConsciousnessUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,kBAAkB,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,mBAAmB,EAAE,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,mCAAmC;IACnC,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,kBAAkB,EAC9B,mBAAmB,EAAE,mBAAmB,GACvC,uBAAuB,CAyCzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAsBT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,GAAG,SAAS,CAoC9F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,CA4BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAGvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAGlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,GAAG;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,CAOA"}
+{"version":3,"file":"painConsciousnessUtils.d.ts","sourceRoot":"","sources":["../../../src/systems/combat/painConsciousnessUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,kBAAkB,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,mBAAmB,EAAE,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,mCAAmC;IACnC,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,kBAAkB,EAC9B,mBAAmB,EAAE,mBAAmB,GACvC,uBAAuB,CAyCzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAsBT;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,GAAG,SAAS,CAoC9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,CA4BR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAGlF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,WAAW,GAAG;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,CAOA"}

package/lib/systems/combat/painConsciousnessUtils.js

@@ -16,7 +16,6 @@ import { ConsciousnessLevel } from "./ConsciousnessSystem.js";
 * console.log(`Status: ${status.statusDescription.english}`);
 * ```
 * 
-* @public
 * @korean 상태확인
 */
 function getPainConsciousnessStatus(player, painSystem, consciousnessSystem) {
@@ -65,7 +64,6 @@ function getPainConsciousnessStatus(player, painSystem, consciousnessSystem) {
 * @param category - Vital point category if known
 * @returns True if result should cause head trauma
 * 
-* @public
 * @korean 두부외상확인
 */
 function isHeadTraumaHit(result, category) {
@@ -83,7 +81,6 @@ function isHeadTraumaHit(result, category) {
 * @param result - Combat result
 * @returns Vital point category if determinable
 * 
-* @public
 * @korean 급소분류추출
 */
 function extractVitalPointCategory(result) {
@@ -112,7 +109,6 @@ function extractVitalPointCategory(result) {
 * console.log(`Recovery needed: ${recoveryTime}s`);
 * ```
 * 
-* @public
 * @korean 회복시간계산
 */
 function getRecommendedRecoveryTime(player, consciousnessSystem) {
@@ -135,7 +131,6 @@ function getRecommendedRecoveryTime(player, consciousnessSystem) {
 * @param shockEffect - Shock pain effect to check
 * @returns True if effect is still active
 * 
-* @public
 * @korean 충격통활성확인
 */
 function isShockPainActive(shockEffect) {
@@ -147,7 +142,6 @@ function isShockPainActive(shockEffect) {
 * @param shockEffect - Shock pain effect
 * @returns Remaining duration in milliseconds, or 0 if expired
 * 
-* @public
 * @korean 충격통잔여시간
 */
 function getShockPainRemainingDuration(shockEffect) {
@@ -167,7 +161,6 @@ function getShockPainRemainingDuration(shockEffect) {
 * console.log(display.consciousness); // "Consciousness: 85/100"
 * ```
 * 
-* @public
 * @korean 표시형식
 */
 function formatPainConsciousnessDisplay(player) {

package/lib/systems/combat/painConsciousnessUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"painConsciousnessUtils.js","names":[],"sources":["../../../src/systems/combat/painConsciousnessUtils.ts"],"sourcesContent":["/**\n * Utility functions for Pain and Consciousness management in combat.\n * \n * **Korean**: 고통 의식 관리 유틸리티\n * \n * Provides helper functions for managing pain and consciousness effects\n * in combat scenarios, including status checking, effect application,\n * and recovery management.\n * \n * @module systems/combat/painConsciousnessUtils\n * @category Combat System\n */\n\nimport { PlayerState } from \"../player\";\nimport { VitalPointCategory } from \"@/types\";\nimport { CombatResult } from \"./types\";\nimport PainResponseSystem, { PainLevel, ShockPainEffect } from \"./PainResponseSystem\";\nimport ConsciousnessSystem, { ConsciousnessLevel } from \"./ConsciousnessSystem\";\n\n/**\n * Pain and consciousness status information.\n */\nexport interface PainConsciousnessStatus {\n  /** Current pain level */\n  readonly painLevel: PainLevel;\n  /** Current consciousness level */\n  readonly consciousnessLevel: ConsciousnessLevel;\n  /** Whether player is in pain overload */\n  readonly isInPainOverload: boolean;\n  /** Whether player is at incapacitation threshold */\n  readonly isIncapacitated: boolean;\n  /** Whether player is combat effective */\n  readonly isCombatEffective: boolean;\n  /** Overall combat effectiveness percentage (0-1) */\n  readonly combatEffectiveness: number;\n  /** Bilingual status description */\n  readonly statusDescription: {\n    readonly korean: string;\n    readonly english: string;\n  };\n}\n\n/**\n * Gets comprehensive pain and consciousness status for a player.\n * \n * @param player - Player to check status for\n * @param painSystem - Pain response system instance\n * @param consciousnessSystem - Consciousness system instance\n * @returns Comprehensive status information\n * \n * @example\n * ```typescript\n * const status = getPainConsciousnessStatus(player, painSystem, consciousnessSystem);\n * console.log(`Combat effectiveness: ${status.combatEffectiveness * 100}%`);\n * console.log(`Status: ${status.statusDescription.english}`);\n * ```\n * \n * @public\n * @korean 상태확인\n */\nexport function getPainConsciousnessStatus(\n  player: PlayerState,\n  painSystem: PainResponseSystem,\n  consciousnessSystem: ConsciousnessSystem\n): PainConsciousnessStatus {\n  const painLevel = painSystem.getPainLevel(player.pain);\n  const consciousnessLevel = consciousnessSystem.getLevel(player.consciousness);\n  \n  const isInPainOverload = painSystem.isInPainOverload(player);\n  const isIncapacitated = consciousnessSystem.isAtIncapacitationThreshold(player);\n  \n  // Calculate overall combat effectiveness\n  const painPenalty = painSystem.getEffects(painLevel).performancePenalty;\n  const consciousnessPenalty = consciousnessSystem.getEffects(consciousnessLevel).accuracyPenalty;\n  const combatEffectiveness = Math.max(0, 1 - Math.max(painPenalty, consciousnessPenalty));\n  \n  const isCombatEffective = combatEffectiveness > 0.5;\n  \n  // Generate status description\n  const painName = painSystem.getLevelName(painLevel);\n  const consciousnessName = consciousnessSystem.getLevelName(consciousnessLevel);\n  \n  let statusKorean = `고통: ${painName.korean}, 의식: ${consciousnessName.korean}`;\n  let statusEnglish = `Pain: ${painName.english}, Consciousness: ${consciousnessName.english}`;\n  \n  if (isIncapacitated) {\n    statusKorean = \"무력화 상태\";\n    statusEnglish = \"Incapacitated\";\n  } else if (isInPainOverload) {\n    statusKorean = \"고통 과부하\";\n    statusEnglish = \"Pain Overload\";\n  }\n  \n  return {\n    painLevel,\n    consciousnessLevel,\n    isInPainOverload,\n    isIncapacitated,\n    isCombatEffective,\n    combatEffectiveness,\n    statusDescription: {\n      korean: statusKorean,\n      english: statusEnglish,\n    },\n  };\n}\n\n/**\n * Determines if a combat result should trigger head trauma.\n * \n * Head trauma occurs for:\n * - Neurological vital point hits\n * - Vascular hits to head region\n * - High damage hits (>25) that could cause concussion\n * - Critical hits to upper body\n * \n * @param result - Combat result to check\n * @param category - Vital point category if known\n * @returns True if result should cause head trauma\n * \n * @public\n * @korean 두부외상확인\n */\nexport function isHeadTraumaHit(\n  result: CombatResult,\n  category?: VitalPointCategory\n): boolean {\n  // Neurological hits often target head\n  if (category === VitalPointCategory.NEUROLOGICAL) {\n    return true;\n  }\n  \n  // Vascular hits to head region\n  if (category === VitalPointCategory.VASCULAR && result.damage > 15) {\n    return true;\n  }\n  \n  // High damage hits that could concuss\n  if (result.damage > 25) {\n    return true;\n  }\n  \n  // Critical hits to vital points\n  if (result.isCritical && result.vitalPointHit) {\n    return true;\n  }\n  \n  return false;\n}\n\n/**\n * Extracts vital point category from combat result.\n * \n * Uses heuristics to determine category from effect sources and hit data.\n * \n * @param result - Combat result\n * @returns Vital point category if determinable\n * \n * @public\n * @korean 급소분류추출\n */\nexport function extractVitalPointCategory(result: CombatResult): VitalPointCategory | undefined {\n  if (!result.vitalPointHit || !result.effects || result.effects.length === 0) {\n    return undefined;\n  }\n  \n  const effect = result.effects[0];\n  if (!effect.source) {\n    return undefined;\n  }\n  \n  const source = effect.source.toLowerCase();\n  \n  // Map source strings to categories\n  if (source.includes('neuro') || source.includes('nerve')) {\n    return VitalPointCategory.NEUROLOGICAL;\n  }\n  if (source.includes('vascular') || source.includes('blood') || source.includes('artery')) {\n    return VitalPointCategory.VASCULAR;\n  }\n  if (source.includes('respiratory') || source.includes('breath') || source.includes('lung')) {\n    return VitalPointCategory.RESPIRATORY;\n  }\n  if (source.includes('skeletal') || source.includes('bone')) {\n    return VitalPointCategory.SKELETAL;\n  }\n  if (source.includes('muscular') || source.includes('muscle')) {\n    return VitalPointCategory.MUSCULAR;\n  }\n  if (source.includes('organ') || source.includes('visceral')) {\n    return VitalPointCategory.ORGAN;\n  }\n  if (source.includes('joint')) {\n    return VitalPointCategory.JOINT;\n  }\n  \n  return undefined;\n}\n\n/**\n * Calculates recommended recovery time based on player condition.\n * \n * @param player - Player state\n * @param consciousnessSystem - Consciousness system\n * @returns Estimated recovery time in seconds\n * \n * @example\n * ```typescript\n * const recoveryTime = getRecommendedRecoveryTime(player, consciousnessSystem);\n * console.log(`Recovery needed: ${recoveryTime}s`);\n * ```\n * \n * @public\n * @korean 회복시간계산\n */\nexport function getRecommendedRecoveryTime(\n  player: PlayerState,\n  consciousnessSystem: ConsciousnessSystem\n): number {\n  let painRecoveryTime = 0;\n  let consciousnessRecoveryTime = 0;\n  \n  // Pain recovery time (-5 pain/second)\n  if (player.pain > 0) {\n    painRecoveryTime = player.pain / 5;\n  }\n  \n  // Consciousness recovery time (5 points/second after 5s delay)\n  if (player.consciousness < 100) {\n    const consciousnessToRecover = 100 - player.consciousness;\n    const consciousnessLevel = consciousnessSystem.getLevel(player.consciousness);\n    \n    // Account for slower recovery at low consciousness\n    let recoveryRate = 5; // Base rate\n    if (consciousnessLevel === ConsciousnessLevel.STUNNED) {\n      recoveryRate = 2.5; // 50% slower\n    } else if (consciousnessLevel === ConsciousnessLevel.UNCONSCIOUS) {\n      recoveryRate = 1; // 20% of base\n    }\n    \n    consciousnessRecoveryTime = 5 + (consciousnessToRecover / recoveryRate);\n  }\n  \n  // Since pain and consciousness recover in parallel (concurrently in game loop),\n  // return the maximum of the two recovery times, not the sum\n  return Math.ceil(Math.max(painRecoveryTime, consciousnessRecoveryTime));\n}\n\n/**\n * Checks if shock pain effect is still active.\n * \n * @param shockEffect - Shock pain effect to check\n * @returns True if effect is still active\n * \n * @public\n * @korean 충격통활성확인\n */\nexport function isShockPainActive(shockEffect: ShockPainEffect): boolean {\n  const elapsed = Date.now() - shockEffect.startTime;\n  return elapsed < shockEffect.duration;\n}\n\n/**\n * Gets remaining shock pain duration.\n * \n * @param shockEffect - Shock pain effect\n * @returns Remaining duration in milliseconds, or 0 if expired\n * \n * @public\n * @korean 충격통잔여시간\n */\nexport function getShockPainRemainingDuration(shockEffect: ShockPainEffect): number {\n  const elapsed = Date.now() - shockEffect.startTime;\n  return Math.max(0, shockEffect.duration - elapsed);\n}\n\n/**\n * Formats pain and consciousness values for display.\n * \n * @param player - Player state\n * @returns Formatted display strings\n * \n * @example\n * ```typescript\n * const display = formatPainConsciousnessDisplay(player);\n * console.log(display.pain); // \"Pain: 45/100\"\n * console.log(display.consciousness); // \"Consciousness: 85/100\"\n * ```\n * \n * @public\n * @korean 표시형식\n */\nexport function formatPainConsciousnessDisplay(player: PlayerState): {\n  readonly pain: string;\n  readonly consciousness: string;\n  readonly painKorean: string;\n  readonly consciousnessKorean: string;\n} {\n  return {\n    pain: `Pain: ${Math.floor(player.pain)}/100`,\n    consciousness: `Consciousness: ${Math.floor(player.consciousness)}/100`,\n    painKorean: `고통: ${Math.floor(player.pain)}/100`,\n    consciousnessKorean: `의식: ${Math.floor(player.consciousness)}/100`,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,2BACd,QACA,YACA,qBACyB;CACzB,MAAM,YAAY,WAAW,aAAa,OAAO,KAAK;CACtD,MAAM,qBAAqB,oBAAoB,SAAS,OAAO,cAAc;CAE7E,MAAM,mBAAmB,WAAW,iBAAiB,OAAO;CAC5D,MAAM,kBAAkB,oBAAoB,4BAA4B,OAAO;CAG/E,MAAM,cAAc,WAAW,WAAW,UAAU,CAAC;CACrD,MAAM,uBAAuB,oBAAoB,WAAW,mBAAmB,CAAC;CAChF,MAAM,sBAAsB,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,aAAa,qBAAqB,CAAC;CAExF,MAAM,oBAAoB,sBAAsB;CAGhD,MAAM,WAAW,WAAW,aAAa,UAAU;CACnD,MAAM,oBAAoB,oBAAoB,aAAa,mBAAmB;CAE9E,IAAI,eAAe,OAAO,SAAS,OAAO,QAAQ,kBAAkB;CACpE,IAAI,gBAAgB,SAAS,SAAS,QAAQ,mBAAmB,kBAAkB;CAEnF,IAAI,iBAAiB;EACnB,eAAe;EACf,gBAAgB;QACX,IAAI,kBAAkB;EAC3B,eAAe;EACf,gBAAgB;;CAGlB,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,mBAAmB;GACjB,QAAQ;GACR,SAAS;GACV;EACF;;;;;;;;;;;;;;;;;;AAmBH,SAAgB,gBACd,QACA,UACS;CAET,IAAI,aAAa,mBAAmB,cAClC,OAAO;CAIT,IAAI,aAAa,mBAAmB,YAAY,OAAO,SAAS,IAC9D,OAAO;CAIT,IAAI,OAAO,SAAS,IAClB,OAAO;CAIT,IAAI,OAAO,cAAc,OAAO,eAC9B,OAAO;CAGT,OAAO;;;;;;;;;;;;;AAcT,SAAgB,0BAA0B,QAAsD;CAC9F,IAAI,CAAC,OAAO,iBAAiB,CAAC,OAAO,WAAW,OAAO,QAAQ,WAAW,GACxE;CAGF,MAAM,SAAS,OAAO,QAAQ;CAC9B,IAAI,CAAC,OAAO,QACV;CAGF,MAAM,SAAS,OAAO,OAAO,aAAa;CAG1C,IAAI,OAAO,SAAS,QAAQ,IAAI,OAAO,SAAS,QAAQ,EACtD,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,WAAW,IAAI,OAAO,SAAS,QAAQ,IAAI,OAAO,SAAS,SAAS,EACtF,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,cAAc,IAAI,OAAO,SAAS,SAAS,IAAI,OAAO,SAAS,OAAO,EACxF,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,WAAW,IAAI,OAAO,SAAS,OAAO,EACxD,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,WAAW,IAAI,OAAO,SAAS,SAAS,EAC1D,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,QAAQ,IAAI,OAAO,SAAS,WAAW,EACzD,OAAO,mBAAmB;CAE5B,IAAI,OAAO,SAAS,QAAQ,EAC1B,OAAO,mBAAmB;;;;;;;;;;;;;;;;;;AAsB9B,SAAgB,2BACd,QACA,qBACQ;CACR,IAAI,mBAAmB;CACvB,IAAI,4BAA4B;CAGhC,IAAI,OAAO,OAAO,GAChB,mBAAmB,OAAO,OAAO;CAInC,IAAI,OAAO,gBAAgB,KAAK;EAC9B,MAAM,yBAAyB,MAAM,OAAO;EAC5C,MAAM,qBAAqB,oBAAoB,SAAS,OAAO,cAAc;EAG7E,IAAI,eAAe;EACnB,IAAI,uBAAuB,mBAAmB,SAC5C,eAAe;OACV,IAAI,uBAAuB,mBAAmB,aACnD,eAAe;EAGjB,4BAA4B,IAAK,yBAAyB;;CAK5D,OAAO,KAAK,KAAK,KAAK,IAAI,kBAAkB,0BAA0B,CAAC;;;;;;;;;;;AAYzE,SAAgB,kBAAkB,aAAuC;CAEvE,OADgB,KAAK,KAAK,GAAG,YAAY,YACxB,YAAY;;;;;;;;;;;AAY/B,SAAgB,8BAA8B,aAAsC;CAClF,MAAM,UAAU,KAAK,KAAK,GAAG,YAAY;CACzC,OAAO,KAAK,IAAI,GAAG,YAAY,WAAW,QAAQ;;;;;;;;;;;;;;;;;;AAmBpD,SAAgB,+BAA+B,QAK7C;CACA,OAAO;EACL,MAAM,SAAS,KAAK,MAAM,OAAO,KAAK,CAAC;EACvC,eAAe,kBAAkB,KAAK,MAAM,OAAO,cAAc,CAAC;EAClE,YAAY,OAAO,KAAK,MAAM,OAAO,KAAK,CAAC;EAC3C,qBAAqB,OAAO,KAAK,MAAM,OAAO,cAAc,CAAC;EAC9D"}
+{"version":3,"file":"painConsciousnessUtils.js","names":[],"sources":["../../../src/systems/combat/painConsciousnessUtils.ts"],"sourcesContent":["/**\n * Utility functions for Pain and Consciousness management in combat.\n * \n * **Korean**: 고통 의식 관리 유틸리티\n * \n * Provides helper functions for managing pain and consciousness effects\n * in combat scenarios, including status checking, effect application,\n * and recovery management.\n * \n * @module systems/combat/painConsciousnessUtils\n * @category Combat System\n */\n\nimport { PlayerState } from \"../player\";\nimport { VitalPointCategory } from \"@/types\";\nimport { CombatResult } from \"./types\";\nimport PainResponseSystem, { PainLevel, ShockPainEffect } from \"./PainResponseSystem\";\nimport ConsciousnessSystem, { ConsciousnessLevel } from \"./ConsciousnessSystem\";\n\n/**\n * Pain and consciousness status information.\n */\nexport interface PainConsciousnessStatus {\n  /** Current pain level */\n  readonly painLevel: PainLevel;\n  /** Current consciousness level */\n  readonly consciousnessLevel: ConsciousnessLevel;\n  /** Whether player is in pain overload */\n  readonly isInPainOverload: boolean;\n  /** Whether player is at incapacitation threshold */\n  readonly isIncapacitated: boolean;\n  /** Whether player is combat effective */\n  readonly isCombatEffective: boolean;\n  /** Overall combat effectiveness percentage (0-1) */\n  readonly combatEffectiveness: number;\n  /** Bilingual status description */\n  readonly statusDescription: {\n    readonly korean: string;\n    readonly english: string;\n  };\n}\n\n/**\n * Gets comprehensive pain and consciousness status for a player.\n * \n * @param player - Player to check status for\n * @param painSystem - Pain response system instance\n * @param consciousnessSystem - Consciousness system instance\n * @returns Comprehensive status information\n * \n * @example\n * ```typescript\n * const status = getPainConsciousnessStatus(player, painSystem, consciousnessSystem);\n * console.log(`Combat effectiveness: ${status.combatEffectiveness * 100}%`);\n * console.log(`Status: ${status.statusDescription.english}`);\n * ```\n * \n * @korean 상태확인\n */\nexport function getPainConsciousnessStatus(\n  player: PlayerState,\n  painSystem: PainResponseSystem,\n  consciousnessSystem: ConsciousnessSystem\n): PainConsciousnessStatus {\n  const painLevel = painSystem.getPainLevel(player.pain);\n  const consciousnessLevel = consciousnessSystem.getLevel(player.consciousness);\n  \n  const isInPainOverload = painSystem.isInPainOverload(player);\n  const isIncapacitated = consciousnessSystem.isAtIncapacitationThreshold(player);\n  \n  // Calculate overall combat effectiveness\n  const painPenalty = painSystem.getEffects(painLevel).performancePenalty;\n  const consciousnessPenalty = consciousnessSystem.getEffects(consciousnessLevel).accuracyPenalty;\n  const combatEffectiveness = Math.max(0, 1 - Math.max(painPenalty, consciousnessPenalty));\n  \n  const isCombatEffective = combatEffectiveness > 0.5;\n  \n  // Generate status description\n  const painName = painSystem.getLevelName(painLevel);\n  const consciousnessName = consciousnessSystem.getLevelName(consciousnessLevel);\n  \n  let statusKorean = `고통: ${painName.korean}, 의식: ${consciousnessName.korean}`;\n  let statusEnglish = `Pain: ${painName.english}, Consciousness: ${consciousnessName.english}`;\n  \n  if (isIncapacitated) {\n    statusKorean = \"무력화 상태\";\n    statusEnglish = \"Incapacitated\";\n  } else if (isInPainOverload) {\n    statusKorean = \"고통 과부하\";\n    statusEnglish = \"Pain Overload\";\n  }\n  \n  return {\n    painLevel,\n    consciousnessLevel,\n    isInPainOverload,\n    isIncapacitated,\n    isCombatEffective,\n    combatEffectiveness,\n    statusDescription: {\n      korean: statusKorean,\n      english: statusEnglish,\n    },\n  };\n}\n\n/**\n * Determines if a combat result should trigger head trauma.\n * \n * Head trauma occurs for:\n * - Neurological vital point hits\n * - Vascular hits to head region\n * - High damage hits (>25) that could cause concussion\n * - Critical hits to upper body\n * \n * @param result - Combat result to check\n * @param category - Vital point category if known\n * @returns True if result should cause head trauma\n * \n * @korean 두부외상확인\n */\nexport function isHeadTraumaHit(\n  result: CombatResult,\n  category?: VitalPointCategory\n): boolean {\n  // Neurological hits often target head\n  if (category === VitalPointCategory.NEUROLOGICAL) {\n    return true;\n  }\n  \n  // Vascular hits to head region\n  if (category === VitalPointCategory.VASCULAR && result.damage > 15) {\n    return true;\n  }\n  \n  // High damage hits that could concuss\n  if (result.damage > 25) {\n    return true;\n  }\n  \n  // Critical hits to vital points\n  if (result.isCritical && result.vitalPointHit) {\n    return true;\n  }\n  \n  return false;\n}\n\n/**\n * Extracts vital point category from combat result.\n * \n * Uses heuristics to determine category from effect sources and hit data.\n * \n * @param result - Combat result\n * @returns Vital point category if determinable\n * \n * @korean 급소분류추출\n */\nexport function extractVitalPointCategory(result: CombatResult): VitalPointCategory | undefined {\n  if (!result.vitalPointHit || !result.effects || result.effects.length === 0) {\n    return undefined;\n  }\n  \n  const effect = result.effects[0];\n  if (!effect.source) {\n    return undefined;\n  }\n  \n  const source = effect.source.toLowerCase();\n  \n  // Map source strings to categories\n  if (source.includes('neuro') || source.includes('nerve')) {\n    return VitalPointCategory.NEUROLOGICAL;\n  }\n  if (source.includes('vascular') || source.includes('blood') || source.includes('artery')) {\n    return VitalPointCategory.VASCULAR;\n  }\n  if (source.includes('respiratory') || source.includes('breath') || source.includes('lung')) {\n    return VitalPointCategory.RESPIRATORY;\n  }\n  if (source.includes('skeletal') || source.includes('bone')) {\n    return VitalPointCategory.SKELETAL;\n  }\n  if (source.includes('muscular') || source.includes('muscle')) {\n    return VitalPointCategory.MUSCULAR;\n  }\n  if (source.includes('organ') || source.includes('visceral')) {\n    return VitalPointCategory.ORGAN;\n  }\n  if (source.includes('joint')) {\n    return VitalPointCategory.JOINT;\n  }\n  \n  return undefined;\n}\n\n/**\n * Calculates recommended recovery time based on player condition.\n * \n * @param player - Player state\n * @param consciousnessSystem - Consciousness system\n * @returns Estimated recovery time in seconds\n * \n * @example\n * ```typescript\n * const recoveryTime = getRecommendedRecoveryTime(player, consciousnessSystem);\n * console.log(`Recovery needed: ${recoveryTime}s`);\n * ```\n * \n * @korean 회복시간계산\n */\nexport function getRecommendedRecoveryTime(\n  player: PlayerState,\n  consciousnessSystem: ConsciousnessSystem\n): number {\n  let painRecoveryTime = 0;\n  let consciousnessRecoveryTime = 0;\n  \n  // Pain recovery time (-5 pain/second)\n  if (player.pain > 0) {\n    painRecoveryTime = player.pain / 5;\n  }\n  \n  // Consciousness recovery time (5 points/second after 5s delay)\n  if (player.consciousness < 100) {\n    const consciousnessToRecover = 100 - player.consciousness;\n    const consciousnessLevel = consciousnessSystem.getLevel(player.consciousness);\n    \n    // Account for slower recovery at low consciousness\n    let recoveryRate = 5; // Base rate\n    if (consciousnessLevel === ConsciousnessLevel.STUNNED) {\n      recoveryRate = 2.5; // 50% slower\n    } else if (consciousnessLevel === ConsciousnessLevel.UNCONSCIOUS) {\n      recoveryRate = 1; // 20% of base\n    }\n    \n    consciousnessRecoveryTime = 5 + (consciousnessToRecover / recoveryRate);\n  }\n  \n  // Since pain and consciousness recover in parallel (concurrently in game loop),\n  // return the maximum of the two recovery times, not the sum\n  return Math.ceil(Math.max(painRecoveryTime, consciousnessRecoveryTime));\n}\n\n/**\n * Checks if shock pain effect is still active.\n * \n * @param shockEffect - Shock pain effect to check\n * @returns True if effect is still active\n * \n * @korean 충격통활성확인\n */\nexport function isShockPainActive(shockEffect: ShockPainEffect): boolean {\n  const elapsed = Date.now() - shockEffect.startTime;\n  return elapsed < shockEffect.duration;\n}\n\n/**\n * Gets remaining shock pain duration.\n * \n * @param shockEffect - Shock pain effect\n * @returns Remaining duration in milliseconds, or 0 if expired\n * \n * @korean 충격통잔여시간\n */\nexport function getShockPainRemainingDuration(shockEffect: ShockPainEffect): number {\n  const elapsed = Date.now() - shockEffect.startTime;\n  return Math.max(0, shockEffect.duration - elapsed);\n}\n\n/**\n * Formats pain and consciousness values for display.\n * \n * @param player - Player state\n * @returns Formatted display strings\n * \n * @example\n * ```typescript\n * const display = formatPainConsciousnessDisplay(player);\n * console.log(display.pain); // \"Pain: 45/100\"\n * console.log(display.consciousness); // \"Consciousness: 85/100\"\n * ```\n * \n * @korean 표시형식\n */\nexport function formatPainConsciousnessDisplay(player: PlayerState): {\n  readonly pain: string;\n  readonly consciousness: string;\n  readonly painKorean: string;\n  readonly consciousnessKorean: string;\n} {\n  return {\n    pain: `Pain: ${Math.floor(player.pain)}/100`,\n    consciousness: `Consciousness: ${Math.floor(player.consciousness)}/100`,\n    painKorean: `고통: ${Math.floor(player.pain)}/100`,\n    consciousnessKorean: `의식: ${Math.floor(player.consciousness)}/100`,\n  };\n}\n"],"mappings":"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"}

package/lib/systems/effects.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Combat effects and status system for Korean martial arts.
+ *
+ * @module systems/effects
+ * @category Combat Effects
+ * @korean 전투효과시스템
+ */
+/** Hit effect type discriminator for combat feedback */
 export declare enum HitEffectType {
     GENERAL_DAMAGE = "general_damage",
     CRITICAL_HIT = "critical_hit",
@@ -9,6 +17,7 @@ export declare enum HitEffectType {
     COUNTER = "counter",
     HIT = "hit"
 }
+/** Additional hit effect variants for status effects */
 export declare enum HitEffectEnum {
     STUN = "stun",
     WEAKNESS = "weakness",
@@ -23,6 +32,7 @@ export declare enum HitEffectEnum {
     FREEZE = "freeze",
     CONFUSION = "confusion"
 }
+/** Effect intensity levels for status effects */
 export declare enum EffectIntensity {
     WEAK = "weak",
     MINOR = "minor",
@@ -34,6 +44,7 @@ export declare enum EffectIntensity {
     CRITICAL = "critical",
     EXTREME = "extreme"
 }
+/** Union type of all applicable status effect identifiers */
 export type EffectType = "stun" | "poison" | "burn" | "bleed" | "exhausted" | "focused" | "rage" | "defensive" | "weakened" | "strengthened" | "paralysis" | "confusion" | "vulnerability" | "stamina_drain";
 export type ParticleType = "spark" | "blood" | "energy" | "dust" | "flash" | "smoke" | "lightning" | "wind";
 export type EnvironmentalEffectType = "smoke" | "fire" | "ice" | "wind" | "lightning" | "darkness" | "light" | "pressure";

package/lib/systems/effects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/systems/effects.ts"],"names":[],"mappings":"AAOA,oBAAY,aAAa;IACvB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,GAAG,QAAQ;CACZ;AAGD,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAGD,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAID,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,MAAM,GACN,WAAW,GACX,UAAU,GACV,cAAc,GACd,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,CAAC;AAIpB,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,WAAW,GACX,MAAM,CAAC;AAIX,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,WAAW,GACX,UAAU,GACV,OAAO,GACP,UAAU,CAAC"}
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/systems/effects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wDAAwD;AACxD,oBAAY,aAAa;IACvB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,GAAG,QAAQ;CACZ;AAED,wDAAwD;AACxD,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,iDAAiD;AACjD,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,MAAM,GACN,WAAW,GACX,UAAU,GACV,cAAc,GACd,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,CAAC;AAIpB,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,WAAW,GACX,MAAM,CAAC;AAIX,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,GACN,WAAW,GACX,UAAU,GACV,OAAO,GACP,UAAU,CAAC"}

package/lib/systems/effects.js

@@ -1,4 +1,12 @@
 //#region src/systems/effects.ts
+/**
+* Combat effects and status system for Korean martial arts.
+*
+* @module systems/effects
+* @category Combat Effects
+* @korean 전투효과시스템
+*/
+/** Hit effect type discriminator for combat feedback */
 var HitEffectType = /* @__PURE__ */ function(HitEffectType) {
 	HitEffectType["GENERAL_DAMAGE"] = "general_damage";
 	HitEffectType["CRITICAL_HIT"] = "critical_hit";
@@ -11,6 +19,7 @@ var HitEffectType = /* @__PURE__ */ function(HitEffectType) {
 	HitEffectType["HIT"] = "hit";
 	return HitEffectType;
 }({});
+/** Additional hit effect variants for status effects */
 var HitEffectEnum = /* @__PURE__ */ function(HitEffectEnum) {
 	HitEffectEnum["STUN"] = "stun";
 	HitEffectEnum["WEAKNESS"] = "weakness";
@@ -26,6 +35,7 @@ var HitEffectEnum = /* @__PURE__ */ function(HitEffectEnum) {
 	HitEffectEnum["CONFUSION"] = "confusion";
 	return HitEffectEnum;
 }({});
+/** Effect intensity levels for status effects */
 var EffectIntensity = /* @__PURE__ */ function(EffectIntensity) {
 	EffectIntensity["WEAK"] = "weak";
 	EffectIntensity["MINOR"] = "minor";

package/lib/systems/effects.js.map

@@ -1 +1 @@
-{"version":3,"file":"effects.js","names":[],"sources":["../../src/systems/effects.ts"],"sourcesContent":["// Import enums from enums.ts\n\n// Combat effects and status system for Korean martial arts\n\n// Hit effect for visual feedback\n// Hit effect types\n\nexport enum HitEffectType {\n  GENERAL_DAMAGE = \"general_damage\",\n  CRITICAL_HIT = \"critical_hit\",\n  VITAL_POINT_STRIKE = \"vital_point_strike\",\n  STATUS_EFFECT = \"status_effect\",\n  MISS = \"miss\",\n  BLOCK = \"block\",\n  PARRY = \"parry\",\n  COUNTER = \"counter\",\n  HIT = \"hit\",\n}\n\n// Effect types for status effects\nexport enum HitEffectEnum {\n  STUN = \"stun\",\n  WEAKNESS = \"weakness\",\n  STAMINA_DRAIN = \"stamina_drain\",\n  VULNERABILITY = \"vulnerability\",\n  BLEEDING = \"bleeding\",\n  BUFF = \"buff\",\n  DEBUFF = \"debuff\",\n  PARALYSIS = \"paralysis\",\n  POISON = \"poison\",\n  BURN = \"burn\",\n  FREEZE = \"freeze\",\n  CONFUSION = \"confusion\",\n}\n\n// Effect intensity levels\nexport enum EffectIntensity {\n  WEAK = \"weak\",\n  MINOR = \"minor\",\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  MODERATE = \"moderate\",\n  HIGH = \"high\",\n  SEVERE = \"severe\",\n  CRITICAL = \"critical\",\n  EXTREME = \"extreme\",\n}\n\n// Status effects that can be applied to players\n// Effect types\nexport type EffectType =\n  | \"stun\"\n  | \"poison\"\n  | \"burn\"\n  | \"bleed\"\n  | \"exhausted\"\n  | \"focused\"\n  | \"rage\"\n  | \"defensive\"\n  | \"weakened\"\n  | \"strengthened\"\n  | \"paralysis\" // Add missing paralysis\n  | \"confusion\" // Add missing confusion\n  | \"vulnerability\" // Add missing vulnerability\n  | \"stamina_drain\"; // Add missing stamina_drain\n\n// Particle effect for visual feedback\n// Particle effect types\nexport type ParticleType =\n  | \"spark\"\n  | \"blood\"\n  | \"energy\"\n  | \"dust\"\n  | \"flash\"\n  | \"smoke\"\n  | \"lightning\"\n  | \"wind\";\n\n// Environmental effect\n// Environmental effect types\nexport type EnvironmentalEffectType =\n  | \"smoke\"\n  | \"fire\"\n  | \"ice\"\n  | \"wind\"\n  | \"lightning\"\n  | \"darkness\"\n  | \"light\"\n  | \"pressure\";\n"],"mappings":";AAOA,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,oBAAiB;CACjB,cAAA,kBAAe;CACf,cAAA,wBAAqB;CACrB,cAAA,mBAAgB;CAChB,cAAA,UAAO;CACP,cAAA,WAAQ;CACR,cAAA,WAAQ;CACR,cAAA,aAAU;CACV,cAAA,SAAM;;KACP;AAGD,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,UAAO;CACP,cAAA,cAAW;CACX,cAAA,mBAAgB;CAChB,cAAA,mBAAgB;CAChB,cAAA,cAAW;CACX,cAAA,UAAO;CACP,cAAA,YAAS;CACT,cAAA,eAAY;CACZ,cAAA,YAAS;CACT,cAAA,UAAO;CACP,cAAA,YAAS;CACT,cAAA,eAAY;;KACb;AAGD,IAAY,kBAAL,yBAAA,iBAAA;CACL,gBAAA,UAAO;CACP,gBAAA,WAAQ;CACR,gBAAA,SAAM;CACN,gBAAA,YAAS;CACT,gBAAA,cAAW;CACX,gBAAA,UAAO;CACP,gBAAA,YAAS;CACT,gBAAA,cAAW;CACX,gBAAA,aAAU;;KACX"}
+{"version":3,"file":"effects.js","names":[],"sources":["../../src/systems/effects.ts"],"sourcesContent":["/**\n * Combat effects and status system for Korean martial arts.\n *\n * @module systems/effects\n * @category Combat Effects\n * @korean 전투효과시스템\n */\n\n/** Hit effect type discriminator for combat feedback */\nexport enum HitEffectType {\n  GENERAL_DAMAGE = \"general_damage\",\n  CRITICAL_HIT = \"critical_hit\",\n  VITAL_POINT_STRIKE = \"vital_point_strike\",\n  STATUS_EFFECT = \"status_effect\",\n  MISS = \"miss\",\n  BLOCK = \"block\",\n  PARRY = \"parry\",\n  COUNTER = \"counter\",\n  HIT = \"hit\",\n}\n\n/** Additional hit effect variants for status effects */\nexport enum HitEffectEnum {\n  STUN = \"stun\",\n  WEAKNESS = \"weakness\",\n  STAMINA_DRAIN = \"stamina_drain\",\n  VULNERABILITY = \"vulnerability\",\n  BLEEDING = \"bleeding\",\n  BUFF = \"buff\",\n  DEBUFF = \"debuff\",\n  PARALYSIS = \"paralysis\",\n  POISON = \"poison\",\n  BURN = \"burn\",\n  FREEZE = \"freeze\",\n  CONFUSION = \"confusion\",\n}\n\n/** Effect intensity levels for status effects */\nexport enum EffectIntensity {\n  WEAK = \"weak\",\n  MINOR = \"minor\",\n  LOW = \"low\",\n  MEDIUM = \"medium\",\n  MODERATE = \"moderate\",\n  HIGH = \"high\",\n  SEVERE = \"severe\",\n  CRITICAL = \"critical\",\n  EXTREME = \"extreme\",\n}\n\n/** Union type of all applicable status effect identifiers */\nexport type EffectType =\n  | \"stun\"\n  | \"poison\"\n  | \"burn\"\n  | \"bleed\"\n  | \"exhausted\"\n  | \"focused\"\n  | \"rage\"\n  | \"defensive\"\n  | \"weakened\"\n  | \"strengthened\"\n  | \"paralysis\" // Add missing paralysis\n  | \"confusion\" // Add missing confusion\n  | \"vulnerability\" // Add missing vulnerability\n  | \"stamina_drain\"; // Add missing stamina_drain\n\n// Particle effect for visual feedback\n// Particle effect types\nexport type ParticleType =\n  | \"spark\"\n  | \"blood\"\n  | \"energy\"\n  | \"dust\"\n  | \"flash\"\n  | \"smoke\"\n  | \"lightning\"\n  | \"wind\";\n\n// Environmental effect\n// Environmental effect types\nexport type EnvironmentalEffectType =\n  | \"smoke\"\n  | \"fire\"\n  | \"ice\"\n  | \"wind\"\n  | \"lightning\"\n  | \"darkness\"\n  | \"light\"\n  | \"pressure\";\n"],"mappings":";;;;;;;;;AASA,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,oBAAiB;CACjB,cAAA,kBAAe;CACf,cAAA,wBAAqB;CACrB,cAAA,mBAAgB;CAChB,cAAA,UAAO;CACP,cAAA,WAAQ;CACR,cAAA,WAAQ;CACR,cAAA,aAAU;CACV,cAAA,SAAM;;KACP;;AAGD,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,UAAO;CACP,cAAA,cAAW;CACX,cAAA,mBAAgB;CAChB,cAAA,mBAAgB;CAChB,cAAA,cAAW;CACX,cAAA,UAAO;CACP,cAAA,YAAS;CACT,cAAA,eAAY;CACZ,cAAA,YAAS;CACT,cAAA,UAAO;CACP,cAAA,YAAS;CACT,cAAA,eAAY;;KACb;;AAGD,IAAY,kBAAL,yBAAA,iBAAA;CACL,gBAAA,UAAO;CACP,gBAAA,WAAQ;CACR,gBAAA,SAAM;CACN,gBAAA,YAAS;CACT,gBAAA,cAAW;CACX,gBAAA,UAAO;CACP,gBAAA,YAAS;CACT,gBAAA,cAAW;CACX,gBAAA,aAAU;;KACX"}

package/lib/systems/game.d.ts

@@ -1,5 +1,16 @@
+/**
+ * Core game state and flow management types.
+ *
+ * Defines match configuration, event system, game sessions, and
+ * persistent save data for the Black Trigram combat game.
+ *
+ * @module systems/game
+ * @category Game State
+ * @korean 게임상태관리
+ */
 import { GameMode, KoreanText } from "../types";
 import type { PlayerState } from "./player";
+/** Configuration for a match before it begins */
 export interface MatchConfig {
     readonly mode: GameMode;
     readonly rounds: number;
@@ -9,6 +20,7 @@ export interface MatchConfig {
     readonly stage: string;
     readonly difficulty?: "easy" | "medium" | "hard" | "expert";
 }
+/** A discrete event emitted during gameplay for logging and UI updates */
 export interface GameEvent {
     readonly id: string;
     readonly type: GameEventType;
@@ -17,6 +29,7 @@ export interface GameEvent {
     readonly data: Record<string, any>;
     readonly message?: KoreanText;
 }
+/** All event types emitted during a match lifecycle */
 export declare enum GameEventType {
     GAME_START = "game_start",
     ROUND_START = "round_start",
@@ -31,6 +44,7 @@ export declare enum GameEventType {
     PAUSE_TOGGLE = "pause_toggle",
     ERROR = "error"
 }
+/** Runtime state for an active match session */
 export interface GameSession {
     readonly id: string;
     readonly gameMode: GameMode;
@@ -43,6 +57,7 @@ export interface GameSession {
     readonly isGameOver: boolean;
     readonly winner: PlayerState | null;
 }
+/** Global game rules and balance parameters */
 export interface GameConfig {
     readonly maxHealth: number;
     readonly maxKi: number;
@@ -54,6 +69,7 @@ export interface GameConfig {
     readonly enableStatusEffects: boolean;
     readonly allowArchetypeSwitching: boolean;
 }
+/** Persistent player data written to save storage */
 export interface GameSaveData {
     readonly version: string;
     readonly playerId: string;

package/lib/systems/game.d.ts.map

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

package/lib/systems/game.js

@@ -1,4 +1,5 @@
 //#region src/systems/game.ts
+/** All event types emitted during a match lifecycle */
 var GameEventType = /* @__PURE__ */ function(GameEventType) {
 	GameEventType["GAME_START"] = "game_start";
 	GameEventType["ROUND_START"] = "round_start";

package/lib/systems/game.js.map

@@ -1 +1 @@
-{"version":3,"file":"game.js","names":[],"sources":["../../src/systems/game.ts"],"sourcesContent":["// Core game state and flow management\n\nimport { GameMode, KoreanText } from \"@/types\";\nimport type { PlayerState } from \"./player\";\n\n// Match configuration\nexport interface MatchConfig {\n  readonly mode: GameMode;\n  readonly rounds: number;\n  readonly roundDuration: number; // seconds\n  readonly player1Archetype: string;\n  readonly player2Archetype: string;\n  readonly stage: string;\n  readonly difficulty?: \"easy\" | \"medium\" | \"hard\" | \"expert\";\n}\n\n// Game event system\nexport interface GameEvent {\n  readonly id: string;\n  readonly type: GameEventType;\n  readonly timestamp: number;\n  readonly playerId?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Event data can contain various types depending on event type\n  readonly data: Record<string, any>;\n  readonly message?: KoreanText;\n}\n\n// Game event types\nexport enum GameEventType {\n  GAME_START = \"game_start\",\n  ROUND_START = \"round_start\",\n  ROUND_END = \"round_end\",\n  MATCH_END = \"match_end\",\n  PLAYER_ATTACK = \"player_attack\",\n  PLAYER_HIT = \"player_hit\",\n  STANCE_CHANGE = \"stance_change\",\n  TECHNIQUE_EXECUTE = \"technique_execute\",\n  VITAL_POINT_HIT = \"vital_point_hit\",\n  STATUS_EFFECT = \"status_effect\",\n  PAUSE_TOGGLE = \"pause_toggle\",\n  ERROR = \"error\",\n}\n\n// Game session interface\nexport interface GameSession {\n  readonly id: string;\n  readonly gameMode: GameMode;\n  readonly players: readonly [PlayerState, PlayerState];\n  readonly currentRound: number;\n  readonly maxRounds: number;\n  readonly roundTimeLimit: number;\n  readonly timeRemaining: number;\n  readonly isPaused: boolean;\n  readonly isGameOver: boolean;\n  readonly winner: PlayerState | null;\n}\n\n// Game configuration\nexport interface GameConfig {\n  readonly maxHealth: number;\n  readonly maxKi: number;\n  readonly maxStamina: number;\n  readonly roundDuration: number;\n  readonly maxRounds: number;\n  readonly difficulty: \"beginner\" | \"intermediate\" | \"expert\" | \"master\";\n  readonly enableVitalPoints: boolean;\n  readonly enableStatusEffects: boolean;\n  readonly allowArchetypeSwitching: boolean;\n}\n\n// Game save data\nexport interface GameSaveData {\n  readonly version: string;\n  readonly playerId: string;\n  readonly playerProgress: {\n    readonly archetypeExperience: Record<string, number>;\n    readonly unlockedTechniques: readonly string[];\n    readonly achievements: readonly string[];\n  };\n  readonly settings: {\n    readonly volume: number;\n    readonly difficulty: string;\n    readonly controls: Record<string, string>;\n  };\n  readonly statistics: {\n    readonly totalMatches: number;\n    readonly wins: number;\n    readonly losses: number;\n    readonly favoriteArchetype: string;\n  };\n}\n"],"mappings":";AA4BA,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,gBAAa;CACb,cAAA,iBAAc;CACd,cAAA,eAAY;CACZ,cAAA,eAAY;CACZ,cAAA,mBAAgB;CAChB,cAAA,gBAAa;CACb,cAAA,mBAAgB;CAChB,cAAA,uBAAoB;CACpB,cAAA,qBAAkB;CAClB,cAAA,mBAAgB;CAChB,cAAA,kBAAe;CACf,cAAA,WAAQ;;KACT"}
+{"version":3,"file":"game.js","names":[],"sources":["../../src/systems/game.ts"],"sourcesContent":["/**\n * Core game state and flow management types.\n *\n * Defines match configuration, event system, game sessions, and\n * persistent save data for the Black Trigram combat game.\n *\n * @module systems/game\n * @category Game State\n * @korean 게임상태관리\n */\n\nimport { GameMode, KoreanText } from \"@/types\";\nimport type { PlayerState } from \"./player\";\n\n/** Configuration for a match before it begins */\nexport interface MatchConfig {\n  readonly mode: GameMode;\n  readonly rounds: number;\n  readonly roundDuration: number; // seconds\n  readonly player1Archetype: string;\n  readonly player2Archetype: string;\n  readonly stage: string;\n  readonly difficulty?: \"easy\" | \"medium\" | \"hard\" | \"expert\";\n}\n\n/** A discrete event emitted during gameplay for logging and UI updates */\nexport interface GameEvent {\n  readonly id: string;\n  readonly type: GameEventType;\n  readonly timestamp: number;\n  readonly playerId?: string;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Event data can contain various types depending on event type\n  readonly data: Record<string, any>;\n  readonly message?: KoreanText;\n}\n\n/** All event types emitted during a match lifecycle */\nexport enum GameEventType {\n  GAME_START = \"game_start\",\n  ROUND_START = \"round_start\",\n  ROUND_END = \"round_end\",\n  MATCH_END = \"match_end\",\n  PLAYER_ATTACK = \"player_attack\",\n  PLAYER_HIT = \"player_hit\",\n  STANCE_CHANGE = \"stance_change\",\n  TECHNIQUE_EXECUTE = \"technique_execute\",\n  VITAL_POINT_HIT = \"vital_point_hit\",\n  STATUS_EFFECT = \"status_effect\",\n  PAUSE_TOGGLE = \"pause_toggle\",\n  ERROR = \"error\",\n}\n\n/** Runtime state for an active match session */\nexport interface GameSession {\n  readonly id: string;\n  readonly gameMode: GameMode;\n  readonly players: readonly [PlayerState, PlayerState];\n  readonly currentRound: number;\n  readonly maxRounds: number;\n  readonly roundTimeLimit: number;\n  readonly timeRemaining: number;\n  readonly isPaused: boolean;\n  readonly isGameOver: boolean;\n  readonly winner: PlayerState | null;\n}\n\n/** Global game rules and balance parameters */\nexport interface GameConfig {\n  readonly maxHealth: number;\n  readonly maxKi: number;\n  readonly maxStamina: number;\n  readonly roundDuration: number;\n  readonly maxRounds: number;\n  readonly difficulty: \"beginner\" | \"intermediate\" | \"expert\" | \"master\";\n  readonly enableVitalPoints: boolean;\n  readonly enableStatusEffects: boolean;\n  readonly allowArchetypeSwitching: boolean;\n}\n\n/** Persistent player data written to save storage */\nexport interface GameSaveData {\n  readonly version: string;\n  readonly playerId: string;\n  readonly playerProgress: {\n    readonly archetypeExperience: Record<string, number>;\n    readonly unlockedTechniques: readonly string[];\n    readonly achievements: readonly string[];\n  };\n  readonly settings: {\n    readonly volume: number;\n    readonly difficulty: string;\n    readonly controls: Record<string, string>;\n  };\n  readonly statistics: {\n    readonly totalMatches: number;\n    readonly wins: number;\n    readonly losses: number;\n    readonly favoriteArchetype: string;\n  };\n}\n"],"mappings":";;AAqCA,IAAY,gBAAL,yBAAA,eAAA;CACL,cAAA,gBAAa;CACb,cAAA,iBAAc;CACd,cAAA,eAAY;CACZ,cAAA,eAAY;CACZ,cAAA,mBAAgB;CAChB,cAAA,gBAAa;CACb,cAAA,mBAAgB;CAChB,cAAA,uBAAoB;CACpB,cAAA,qBAAkB;CAClB,cAAA,mBAAgB;CAChB,cAAA,kBAAe;CACf,cAAA,WAAQ;;KACT"}

package/lib/systems/index.d.ts

@@ -1,5 +1,9 @@
 /**
- * Barrel exports for systems types
+ * Barrel exports for the systems module.
+ *
+ * Re-exports all types, classes, and utilities from the combat,
+ * vital point, effect, layout, and player subsystems.
+ *
  * @module systems
  * @category Game Systems
  */

package/lib/systems/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/systems/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/systems/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/lib/systems/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/systems/index.ts"],"sourcesContent":["/**\n * Barrel exports for systems types\n * @module systems\n * @category Game Systems\n */\n\n// Export base types\nexport type {\n  AISystemConfig,\n  AnimationSystemInterface,\n  CombatSystemConfig,\n  CombatSystemInterface,\n  DisplayHitEffect,\n  EffectSystem,\n  EnvironmentalEffect,\n  EventBusInterface,\n  GameSystemManager,\n  GameSystemState,\n  HitEffect,\n  InputSystemInterface,\n  ParticleEffect,\n  PhysicsSystemInterface,\n  RenderingSystemInterface,\n  StatusEffect,\n  SystemConfig,\n  SystemEvent,\n  SystemPerformance,\n  TrigramSystemConfig,\n  TrigramSystemInterface,\n  VisualEffect,\n  VitalPointSystemConfig,\n  VitalPointSystemInterface,\n} from \"./types\";\n\n// Export specific system types\nexport type {\n  CombatEventData,\n  CombatResult,\n  CombatStats,\n  CombatSystem,\n  TrainingCombatResult,\n} from \"./combat\";\n\nexport type {\n  AnatomicalRegion,\n  DamageResult,\n  KoreanTechnique,\n  VitalPoint,\n  VitalPointEffect,\n  VitalPointHitResult,\n  VitalPointSystem,\n} from \"./vitalpoint\";\n\nexport type {\n  StanceTransition,\n  TransitionMetrics,\n  TransitionPath,\n  TrigramCombatStyle,\n  TrigramData,\n  TrigramPhilosophy,\n  TrigramSystem,\n  TrigramTheme,\n  TrigramTransitionCost,\n  TrigramTransitionRule,\n} from \"./trigram\";\n\n// Re-export system types\nexport type {\n  AnimationConfig,\n  AnimationState,\n  CollisionData,\n  PhysicsEntityConfig,\n  PhysicsEntityState,\n  RenderableConfig,\n  Velocity,\n} from \"./types\";\n\nexport * from \"./ai\";\nexport * from \"./bodypart\";\nexport * from \"./breathing\";\nexport * from \"./combat\";\nexport * from \"./combat/FallIntegration\";\nexport * from \"./CombatSystem\";\nexport * from \"./effects\";\nexport * from \"./game\";\nexport * from \"./LayoutSystem\";\nexport * from \"./movement\";\nexport * from \"./player\";\nexport * from \"./trigram\";\nexport * from \"./TrigramSystem\";\nexport * from \"./types\";\nexport * from \"./vitalpoint\";\nexport * from \"./VitalPointSystem\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/systems/index.ts"],"sourcesContent":["/**\n * Barrel exports for the systems module.\n *\n * Re-exports all types, classes, and utilities from the combat,\n * vital point, effect, layout, and player subsystems.\n *\n * @module systems\n * @category Game Systems\n */\n\n// Base system interface types\nexport type {\n  AISystemConfig,\n  AnimationSystemInterface,\n  CombatSystemConfig,\n  CombatSystemInterface,\n  DisplayHitEffect,\n  EffectSystem,\n  EnvironmentalEffect,\n  EventBusInterface,\n  GameSystemManager,\n  GameSystemState,\n  HitEffect,\n  InputSystemInterface,\n  ParticleEffect,\n  PhysicsSystemInterface,\n  RenderingSystemInterface,\n  StatusEffect,\n  SystemConfig,\n  SystemEvent,\n  SystemPerformance,\n  TrigramSystemConfig,\n  TrigramSystemInterface,\n  VisualEffect,\n  VitalPointSystemConfig,\n  VitalPointSystemInterface,\n} from \"./types\";\n\n// Export specific system types\nexport type {\n  CombatEventData,\n  CombatResult,\n  CombatStats,\n  CombatSystem,\n  TrainingCombatResult,\n} from \"./combat\";\n\nexport type {\n  AnatomicalRegion,\n  DamageResult,\n  KoreanTechnique,\n  VitalPoint,\n  VitalPointEffect,\n  VitalPointHitResult,\n  VitalPointSystem,\n} from \"./vitalpoint\";\n\nexport type {\n  StanceTransition,\n  TransitionMetrics,\n  TransitionPath,\n  TrigramCombatStyle,\n  TrigramData,\n  TrigramPhilosophy,\n  TrigramSystem,\n  TrigramTheme,\n  TrigramTransitionCost,\n  TrigramTransitionRule,\n} from \"./trigram\";\n\n// Re-export system types\nexport type {\n  AnimationConfig,\n  AnimationState,\n  CollisionData,\n  PhysicsEntityConfig,\n  PhysicsEntityState,\n  RenderableConfig,\n  Velocity,\n} from \"./types\";\n\nexport * from \"./ai\";\nexport * from \"./bodypart\";\nexport * from \"./breathing\";\nexport * from \"./combat\";\nexport * from \"./combat/FallIntegration\";\nexport * from \"./CombatSystem\";\nexport * from \"./effects\";\nexport * from \"./game\";\nexport * from \"./LayoutSystem\";\nexport * from \"./movement\";\nexport * from \"./player\";\nexport * from \"./trigram\";\nexport * from \"./TrigramSystem\";\nexport * from \"./types\";\nexport * from \"./vitalpoint\";\nexport * from \"./VitalPointSystem\";\n"],"mappings":""}

package/lib/systems/movement/InjuryMovementModifier.d.ts

@@ -36,7 +36,6 @@ import type { BodyPartHealth } from "../bodypart/types";
  *
  * **Korean**: 손상 이동 설정
  *
- * @public
  * @category Movement System
  */
 export interface InjuryMovementConfig {
@@ -61,7 +60,6 @@ export interface InjuryMovementConfig {
  * Deep partial type for InjuryMovementConfig to support partial overrides.
  * Allows callers to override individual threshold values without providing all.
  *
- * @public
  * @category Movement System
  */
 export type PartialInjuryMovementConfig = {
@@ -81,7 +79,6 @@ export declare const DEFAULT_INJURY_MOVEMENT_CONFIG: InjuryMovementConfig;
  *
  * **Korean**: 손상 이동 결과
  *
- * @public
  * @category Movement System
  */
 export interface InjuryMovementResult {
@@ -131,7 +128,6 @@ export interface InjuryMovementResult {
  * console.log(`Status: ${result.statusText.korean} | ${result.statusText.english}`);
  * ```
  *
- * @public
  * @category Movement System
  * @korean 손상기반이동수정자
  */
@@ -168,7 +164,6 @@ export declare class InjuryMovementModifier {
      * @param painLevel - Current pain level (0-100)
      * @returns Complete movement calculation result
      *
-     * @public
      * @korean 이동속도계산
      */
     calculateMovementSpeed(baseSpeed: number, bodyPartHealth: BodyPartHealth, stance: TrigramStance, painLevel: number): InjuryMovementResult;
@@ -207,7 +202,6 @@ export declare class InjuryMovementModifier {
      * @param stance - Current trigram stance
      * @returns Speed multiplier (0.8-1.25), defaults to 1.0 for unknown stances
      *
-     * @public
      */
     getStanceSpeedModifier(stance: TrigramStance): number;
     /**
@@ -233,7 +227,6 @@ export declare class InjuryMovementModifier {
      * @param bodyPartHealth - Current body part health
      * @returns True if limping animation should play
      *
-     * @public
      */
     shouldLimp(bodyPartHealth: BodyPartHealth): boolean;
     /**
@@ -246,7 +239,6 @@ export declare class InjuryMovementModifier {
      * @param bodyPartHealth - Current body part health
      * @returns True if severe limp (leg health < 30%)
      *
-     * @public
      */
     hasSevereLimp(bodyPartHealth: BodyPartHealth): boolean;
     /**
@@ -259,7 +251,6 @@ export declare class InjuryMovementModifier {
      * @param bodyPartHealth - Current body part health
      * @returns Bilingual injury description
      *
-     * @public
      */
     getInjuryDescription(bodyPartHealth: BodyPartHealth): {
         korean: string;
@@ -269,7 +260,6 @@ export declare class InjuryMovementModifier {
 /**
  * Singleton instance for global access.
  *
- * @public
  */
 export declare const injuryMovementModifier: InjuryMovementModifier;
 //# sourceMappingURL=InjuryMovementModifier.d.ts.map

package/lib/systems/movement/InjuryMovementModifier.d.ts.map

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