blacktrigram 0.7.2

package/lib/systems/CombatSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombatSystem.js","names":[],"sources":["../../src/systems/CombatSystem.ts"],"sourcesContent":["import * as THREE from \"three\";\nimport { getArchetypePhysicalAttributes } from \"../data/archetypePhysicalAttributes\";\nimport { getTechniqueById } from \"../data/techniques\";\nimport { BodyRegion, CombatAttackType, CombatState, DamageType, GrappleTarget } from \"../types\";\nimport { VitalPointCategory, VitalPointSeverity } from \"../types/common\";\nimport { BASE_STAMINA_REGEN_RATE } from \"../types/physicsConstants\";\nimport { Technique } from \"../types/technique\";\nimport { calculateDistance3D } from \"../utils/math\";\nimport { calculateBodyRadius } from \"../utils/skeletonScaling\";\nimport type { DefensiveAnimationType } from \"./animation\";\nimport {\n  AnimationType,\n  calculateSpeedModifierForDamage,\n  determineAnimationTypeForTechnique,\n  getAdjustedAnimationDuration,\n  getAnimationNameForType,\n  isWithinHitWindow,\n} from \"./animation\";\nimport { applyDamageToBodyParts } from \"./bodypart/BodyPartDamageIntegration\";\nimport { playerInjuryManager } from \"./bodypart\";\nimport {\n  applyBreathingDisruptionFromVitalPoint,\n  applyBreathingDisruptionFromTorsoDamage,\n  BreathingDisruptionSystem,\n  causesBreathingDisruption,\n  updateBreathingDisruption,\n} from \"./breathing\";\nimport BalanceSystem from \"./combat/BalanceSystem\";\nimport ConsciousnessSystem from \"./combat/ConsciousnessSystem\";\nimport {\n  extractVitalPointCategory,\n  isHeadTraumaHit,\n} from \"./combat/painConsciousnessUtils\";\nimport PainResponseSystem, {\n  ShockPainEffect,\n} from \"./combat/PainResponseSystem\";\nimport { CombatResult, CombatSystemInterface } from \"./combat/types\";\nimport {\n  CollisionDetection,\n  KnockbackPhysics,\n  physicalReachCalculator,\n  type KnockbackConfig,\n} from \"./physics\";\nimport { PlayerState } from \"./player\";\nimport {\n  addEffectsToPlayer,\n  getEffectModifiers,\n  removeExpiredEffects,\n} from \"./PlayerEffectManager\";\nimport { TRIGRAM_TECHNIQUES } from \"./trigram\";\nimport { TrigramSystem } from \"./TrigramSystem\";\nimport { StatusEffect } from \"./types\";\nimport { KoreanTechnique, VitalPointHitResult } from \"./vitalpoint/types\";\nimport { VitalPointSystem } from \"./VitalPointSystem\";\nimport { GrappleSystem } from \"./combat/GrappleSystem\";\n\n/**\n * Enhanced Combat System with Pain Response and Consciousness integration.\n *\n * Integrates realistic pain accumulation and consciousness tracking for\n * progressive combat impairment.\n */\nexport class CombatSystem implements CombatSystemInterface {\n  private vitalPointSystem: VitalPointSystem;\n  protected trigramSystem: TrigramSystem;\n  private painSystem: PainResponseSystem;\n  private consciousnessSystem: ConsciousnessSystem;\n  private balanceSystem: BalanceSystem;\n  private knockbackPhysics: KnockbackPhysics;\n  private collisionDetection: CollisionDetection;\n  private grappleSystem: GrappleSystem;\n\n  // Track shock pain effects per player\n  private shockPainEffects: Map<string, ShockPainEffect>;\n  // Track last head trauma time per player for consciousness recovery\n  private lastHeadTraumaTime: Map<string, number>;\n\n  // Vital point severity thresholds\n  private readonly SEVERITY_MAJOR_THRESHOLD = 30;\n  private readonly SEVERITY_MODERATE_THRESHOLD = 20;\n\n  constructor() {\n    this.vitalPointSystem = new VitalPointSystem();\n    this.trigramSystem = new TrigramSystem();\n    this.painSystem = new PainResponseSystem();\n    this.consciousnessSystem = new ConsciousnessSystem();\n    this.balanceSystem = new BalanceSystem();\n    this.knockbackPhysics = new KnockbackPhysics();\n    this.collisionDetection = new CollisionDetection();\n    this.grappleSystem = new GrappleSystem();\n    this.shockPainEffects = new Map();\n    this.lastHeadTraumaTime = new Map();\n  }\n\n  /**\n   * Cleanup per-player combat state.\n   *\n   * Call this when a player permanently leaves the match or when\n   * match-level cleanup is performed to avoid unbounded Map growth.\n   *\n   * @param playerId - ID of the player to cleanup\n   *\n   * @public\n   * @korean 플레이어데이터정리\n   */\n  public cleanupPlayerData(playerId: string): void {\n    this.shockPainEffects.delete(playerId);\n    this.lastHeadTraumaTime.delete(playerId);\n  }\n\n  /**\n   * Dispose of all combat system resources.\n   *\n   * **Korean**: 전투 시스템 자원 정리\n   *\n   * Cleans up Three.js resources (geometries, raycaster) used by the collision\n   * detection system to prevent memory leaks. Should be called when the\n   * CombatSystem is destroyed or reinitialized.\n   *\n   * @public\n   * @korean 전투시스템자원정리\n   */\n  public dispose(): void {\n    // Dispose collision detection resources (cached geometries, raycaster)\n    this.collisionDetection.dispose();\n  }\n\n  /**\n   * Get the balance system instance for fall checking.\n   *\n   * @returns BalanceSystem instance\n   * @public\n   * @korean 균형시스템가져오기\n   */\n  public getBalanceSystem(): BalanceSystem {\n    return this.balanceSystem;\n  }\n\n  /**\n   * Get the consciousness system instance for fall checking.\n   *\n   * @returns ConsciousnessSystem instance\n   * @public\n   * @korean 의식시스템가져오기\n   */\n  public getConsciousnessSystem(): ConsciousnessSystem {\n    return this.consciousnessSystem;\n  }\n\n  /**\n   * Get the collision detection system instance.\n   *\n   * @returns CollisionDetection instance\n   * @public\n   * @korean 충돌감지시스템가져오기\n   */\n  public getCollisionDetection(): CollisionDetection {\n    return this.collisionDetection;\n  }\n\n  /**\n   * Calculate knockback physics for combat hit.\n   *\n   * **Korean**: 밀침 계산 (Calculate Knockback)\n   *\n   * Determines knockback displacement, duration, and fall state based on:\n   * - Attack damage amount\n   * - Defender's balance state\n   * - Defender's stance resistance\n   * - Attack direction vector\n   *\n   * @param attacker - Attacking player state\n   * @param defender - Defending player state\n   * @param damage - Total damage dealt\n   * @returns Knockback information or undefined if no knockback\n   *\n   * @example\n   * ```typescript\n   * const knockback = this.calculateKnockback(attacker, defender, 80);\n   * // Returns: { displacement: {x:2.5,y:0,z:0}, duration:0.8, recoveryWindow:0.7, shouldFall:false }\n   * ```\n   *\n   * @private\n   * @korean 밀침계산\n   */\n  private calculateKnockback(\n    attacker: PlayerState,\n    defender: PlayerState,\n    damage: number,\n  ): CombatResult[\"knockback\"] {\n    // Calculate attack direction vector (attacker → defender)\n    const attackDirection = new THREE.Vector3(\n      defender.position.x - attacker.position.x,\n      0, // Keep knockback on horizontal plane\n      defender.position.y - attacker.position.y,\n    );\n\n    // If attacker and defender are at the exact same position, skip knockback to avoid NaN direction\n    if (attackDirection.lengthSq() === 0) {\n      return undefined;\n    }\n\n    attackDirection.normalize();\n\n    // Create knockback configuration\n    const config: KnockbackConfig = {\n      force: damage * 10, // Convert damage to force (arbitrary scaling)\n      direction: attackDirection,\n      duration: 0, // Will be calculated by physics engine\n      balanceState: {\n        current: defender.balance,\n        max: 100, // Assuming max balance is always 100\n      },\n      currentStance: defender.currentStance,\n    };\n\n    // Calculate knockback result\n    const result = this.knockbackPhysics.calculateKnockback(config, damage);\n\n    // Convert Three.js Vector3 to plain object for serialization\n    return {\n      displacement: {\n        x: result.displacement.x,\n        y: result.displacement.y,\n        z: result.displacement.z,\n      },\n      duration: result.duration,\n      recoveryWindow: result.recoveryWindow,\n      shouldFall: result.shouldFall,\n    };\n  }\n\n  /**\n   * Fix: Update resolveAttack to match interface signature and add animation-aware hit detection\n   *\n   * **Korean**: 공격 해결 (애니메이션 인식)\n   *\n   * Integrates animation timing and physical reach calculation for reality-based hit detection.\n   * Hits only register when:\n   * 1. Animation is in hit window (extension phase)\n   * 2. Attacker is within effective reach based on limb length and animation\n   * 3. Existing accuracy and stance checks pass\n   *\n   * @param attacker - Attacking player state\n   * @param defender - Defending player state\n   * @param technique - Technique being executed\n   * @param targetedVitalPointId - Optional specific vital point target\n   * @param animationContext - Optional animation timing context for reality-based hit detection\n   * @returns Combat result with hit/miss and damage information\n   */\n  resolveAttack(\n    attacker: PlayerState,\n    defender: PlayerState,\n    technique: KoreanTechnique,\n    targetedVitalPointId?: string,\n    animationContext?: {\n      animationType: AnimationType;\n      currentTime: number;\n    },\n  ): CombatResult {\n    const timestamp = Date.now();\n\n    // Check if attacker can execute the technique\n    if (!this.canExecuteTechnique(attacker, technique)) {\n      return {\n        hit: false,\n        damage: 0,\n        criticalHit: false,\n        vitalPointHit: false,\n        effects: [],\n        timestamp,\n        technique,\n        attacker,\n        defender,\n        success: false,\n        isCritical: false,\n        isBlocked: false,\n      };\n    }\n\n    // Check if attacker is being grappled - cannot attack while controlled\n    if (attacker.combatState === CombatState.GRAPPLED) {\n      return {\n        hit: false,\n        damage: 0,\n        criticalHit: false,\n        vitalPointHit: false,\n        effects: [],\n        timestamp,\n        technique,\n        attacker,\n        defender,\n        success: false,\n        isCritical: false,\n        isBlocked: false,\n      };\n    }\n\n    // === ANIMATION-AWARE HIT DETECTION ===\n    // If animation context provided, validate timing and reach\n    if (animationContext) {\n      const { animationType, currentTime } = animationContext;\n\n      // Check if within hit window (extension phase)\n      if (!isWithinHitWindow(animationType, currentTime)) {\n        return {\n          hit: false,\n          damage: 0,\n          criticalHit: false,\n          vitalPointHit: false,\n          effects: [],\n          timestamp,\n          technique,\n          attacker,\n          defender,\n          success: false,\n          isCritical: false,\n          isBlocked: false,\n        };\n      }\n\n      // Calculate effective reach based on physical attributes and animation\n      const attackerPhysical = getArchetypePhysicalAttributes(\n        attacker.archetype,\n      );\n      const reachResult = physicalReachCalculator.calculateReach(\n        attackerPhysical,\n        animationType,\n        currentTime,\n        attacker.currentStance,\n        technique.reachConfig, // Pass reachConfig for hybrid reach calculation\n      );\n\n      // Check distance to defender using 3D Euclidean distance\n      // Physics-first: Position type is 2D in METERS\n      // No conversion needed - positions are already in meters\n      const centerToCenterDistance = calculateDistance3D(\n        [attacker.position.x, attacker.position.y, 0],\n        [defender.position.x, defender.position.y, 0],\n      );\n\n      // Calculate body radii\n      // Note: PhysicalReachCalculator already includes attacker body pivot/offset in reach calculation\n      // (shoulder offset for punches, hip rotation for kicks), so we only subtract defender radius\n      // to avoid double-counting the attacker's body dimension.\n      // 타격 거리 계산: 수비자 몸체 반경만 제외 (공격자 몸체 오프셋은 이미 도달 거리에 포함됨)\n      const defenderPhysical = getArchetypePhysicalAttributes(\n        defender.archetype,\n      );\n      const defenderBodyRadius = calculateBodyRadius(defenderPhysical);\n\n      // Effective distance = center-to-center minus defender body radius only\n      // Reach is calculated from attacker center to striking limb surface (includes body pivot),\n      // so we measure from attacker center to defender surface (subtracting defender radius only).\n      // 유효 거리 = 중심간 거리 - 수비자 몸체 반경\n      const distance = Math.max(0, centerToCenterDistance - defenderBodyRadius);\n\n      // If out of reach, miss\n      if (distance > reachResult.effectiveReach) {\n        return {\n          hit: false,\n          damage: 0,\n          criticalHit: false,\n          vitalPointHit: false,\n          effects: [],\n          timestamp,\n          technique,\n          attacker,\n          defender,\n          success: false,\n          isCritical: false,\n          isBlocked: false,\n        };\n      }\n    }\n\n    // Fix: Use correct method signature\n    const stanceEffectiveness = this.trigramSystem.calculateStanceEffectiveness(\n      attacker.currentStance,\n      defender.currentStance,\n    );\n\n    // Calculate base hit chance\n    const baseAccuracy = technique.accuracy * stanceEffectiveness;\n    const hitRoll = Math.random();\n    const hit = hitRoll <= baseAccuracy;\n\n    if (!hit) {\n      return {\n        hit: false,\n        damage: 0,\n        criticalHit: false,\n        vitalPointHit: false,\n        effects: [],\n        timestamp,\n        technique,\n        attacker,\n        defender,\n        success: false,\n        isCritical: false,\n        isBlocked: false,\n      };\n    }\n\n    // Special handling for grapple techniques\n    if (technique.type === CombatAttackType.GRAPPLE) {\n      const grappleResult = this.handleGrappleTechnique(\n        attacker,\n        defender,\n        technique,\n        timestamp\n      );\n\n      // Grapples don't deal immediate damage, they establish control\n      // Small damage on successful grapple to represent the initial impact\n      const grappleDamage = grappleResult.grappleSuccess\n        ? technique.damage * 0.3\n        : 0;\n\n      return {\n        hit: grappleResult.grappleSuccess,\n        damage: grappleDamage,\n        criticalHit: false,\n        vitalPointHit: false,\n        effects: [],\n        timestamp,\n        technique,\n        attacker: grappleResult.updatedAttacker,\n        defender: grappleResult.updatedDefender,\n        success: grappleResult.grappleSuccess,\n        isCritical: false,\n        isBlocked: false,\n        animation: this.getAnimationInfoForTechnique(technique),\n      };\n    }\n\n    // Process vital point hit if targeted (with archetype parameters)\n    let vitalPointResult: VitalPointHitResult | null = null;\n    if (targetedVitalPointId) {\n      vitalPointResult = this.processVitalPointHit(\n        targetedVitalPointId,\n        technique.damage ?? 15,\n        attacker,\n        defender,\n      );\n    }\n\n    // Calculate damage using the interface method\n    const damageResult = this.calculateDamage(\n      technique,\n      attacker,\n      defender,\n      vitalPointResult ?? {\n        hit: false,\n        damage: 0,\n        effects: [],\n        severity: VitalPointSeverity.MINOR,\n      },\n    );\n\n    // Check for critical hit\n    const critRoll = Math.random();\n    const isCritical = critRoll <= (technique.critChance ?? 0.1);\n\n    // Determine animation information for technique\n    const animationInfo = this.getAnimationInfoForTechnique(technique);\n\n    // Calculate knockback physics (밀침 물리)\n    const knockbackInfo = this.calculateKnockback(\n      attacker,\n      defender,\n      damageResult.totalDamage,\n    );\n\n    return {\n      hit: true,\n      damage: damageResult.totalDamage,\n      criticalHit: isCritical,\n      vitalPointHit: vitalPointResult?.hit ?? false,\n      effects: damageResult.effectsApplied,\n      timestamp,\n      technique,\n      attacker,\n      defender,\n      success: true,\n      isCritical: vitalPointResult?.hit ?? false,\n      isBlocked: false,\n      targetedVitalPointId, // Pass through the targeted vital point ID\n      animation: animationInfo, // Add animation information\n      knockback: knockbackInfo, // Add knockback information\n    };\n  }\n\n  /**\n   * Get animation information for a technique\n   *\n   * Determines the skeletal animation to play, duration, and speed modifier\n   * based on technique configuration or automatic determination.\n   *\n   * @param technique - Korean technique to execute\n   * @returns Animation information or undefined\n   *\n   * @private\n   * @korean 기술애니메이션정보가져오기\n   */\n  private getAnimationInfoForTechnique(\n    technique: KoreanTechnique,\n  ): CombatResult[\"animation\"] {\n    // Check if technique has explicit animation config (from Technique interface)\n    // KoreanTechnique may not have animation field, so check the technique data\n    const techniqueData = this.getTechniqueData(technique);\n\n    let animationType;\n    let speedModifier;\n\n    if (techniqueData?.animation) {\n      // Use explicit animation configuration\n      animationType = techniqueData.animation.type;\n      speedModifier = techniqueData.animation.speedModifier;\n    } else {\n      // Auto-determine animation from technique characteristics\n      const techniqueName =\n        technique.name?.english || technique.englishName || \"\";\n      const techniqueId = technique.id || \"\";\n      const damageType = technique.damageType || \"\";\n\n      animationType = determineAnimationTypeForTechnique(\n        techniqueName,\n        techniqueId,\n        damageType,\n      );\n\n      // Calculate speed modifier based on technique damage\n      speedModifier = calculateSpeedModifierForDamage(technique.damage || 15);\n    }\n\n    // Get base animation name from animation type\n    const animationName = getAnimationNameForType(animationType);\n\n    // Calculate adjusted duration\n    const duration = getAdjustedAnimationDuration(animationName, speedModifier);\n\n    // Get Korean technique name for display\n    const techniqueDisplayName =\n      technique.name?.korean || technique.koreanName || technique.id;\n\n    return {\n      animationName,\n      duration,\n      speedModifier,\n      techniqueDisplayName,\n    };\n  }\n\n  /**\n   * Get Technique data if this KoreanTechnique has an associated Technique definition\n   *\n   * @param technique - Korean technique\n   * @returns Technique data or null\n   *\n   * @private\n   * @korean 기술데이터가져오기\n   */\n  private getTechniqueData(technique: KoreanTechnique): Technique | null {\n    return getTechniqueById(technique.id) ?? null;\n  }\n\n  /**\n   * Handle grapple technique execution.\n   *\n   * **Korean**: 잡기 기술 처리 (Handle Grapple Technique)\n   *\n   * Initiates or transitions grapple control based on technique.\n   *\n   * @param attacker - Player executing grapple\n   * @param defender - Target player\n   * @param technique - Grapple technique being used\n   * @param currentTime - Current game time in milliseconds\n   * @returns Updated player states with grapple control\n   */\n  handleGrappleTechnique(\n    attacker: PlayerState,\n    defender: PlayerState,\n    technique: KoreanTechnique,\n    currentTime: number\n  ): {\n    updatedAttacker: PlayerState;\n    updatedDefender: PlayerState;\n    grappleSuccess: boolean;\n  } {\n    // Determine grapple target from technique\n    const target = this.getGrappleTargetFromTechnique(technique);\n\n    // Attempt grapple\n    const result = this.grappleSystem.attemptGrapple(\n      attacker,\n      defender,\n      target,\n      currentTime\n    );\n\n    if (result.success && result.grappleControl) {\n      // Grapple succeeded - update both players\n      return {\n        updatedAttacker: {\n          ...attacker,\n          combatState: CombatState.GRAPPLING,\n          grappleControl: result.grappleControl,\n          stamina: Math.max(0, attacker.stamina - result.staminaCost),\n        },\n        updatedDefender: {\n          ...defender,\n          combatState: CombatState.GRAPPLED,\n          grappleControl: result.grappleControl,\n        },\n        grappleSuccess: true,\n      };\n    }\n\n    // Grapple failed\n    return {\n      updatedAttacker: {\n        ...attacker,\n        stamina: Math.max(0, attacker.stamina - result.staminaCost),\n      },\n      updatedDefender: defender,\n      grappleSuccess: false,\n    };\n  }\n\n  /**\n   * Determine grapple target from technique characteristics.\n   *\n   * **Korean**: 기술에서 잡기 목표 결정 (Determine Grapple Target from Technique)\n   *\n   * @private\n   */\n  private getGrappleTargetFromTechnique(\n    technique: KoreanTechnique\n  ): GrappleTarget {\n    // Check technique name/ID for hints (both English and Korean)\n    const techName = (\n      technique.name?.english ||\n      technique.englishName ||\n      \"\"\n    ).toLowerCase();\n    const techNameKorean = (\n      technique.name?.korean ||\n      technique.koreanName ||\n      \"\"\n    );\n    const techId = technique.id.toLowerCase();\n\n    // Check for wrist/hand - 손목 (sonmok)\n    if (\n      techName.includes(\"wrist\") ||\n      techId.includes(\"wrist\") ||\n      techNameKorean.includes(\"손목\")\n    ) {\n      return GrappleTarget.HAND;\n    }\n\n    // Check for arm - 팔 (pal)\n    if (\n      techName.includes(\"arm\") ||\n      techId.includes(\"arm\") ||\n      techNameKorean.includes(\"팔\")\n    ) {\n      return GrappleTarget.ARM;\n    }\n\n    // Check for leg - 다리 (dari)\n    if (\n      techName.includes(\"leg\") ||\n      techId.includes(\"leg\") ||\n      techNameKorean.includes(\"다리\")\n    ) {\n      return GrappleTarget.LEG;\n    }\n\n    // Check for neck - 목 (mok)\n    if (\n      techName.includes(\"neck\") ||\n      techId.includes(\"neck\") ||\n      techNameKorean.includes(\"목\")\n    ) {\n      return GrappleTarget.NECK;\n    }\n\n    // Check for both arms - 양팔 (yangpal)\n    if (\n      techName.includes(\"both\") ||\n      techName.includes(\"double\") ||\n      techId.includes(\"both\") ||\n      techNameKorean.includes(\"양팔\") ||\n      techNameKorean.includes(\"쌍\")\n    ) {\n      return GrappleTarget.BOTH_ARMS;\n    }\n\n    // Check for torso/body/hip - 몸통 (momtong), 허리 (heori), 몸 (mom)\n    if (\n      techName.includes(\"torso\") ||\n      techName.includes(\"body\") ||\n      techName.includes(\"hip\") ||\n      techId.includes(\"torso\") ||\n      techNameKorean.includes(\"몸통\") ||\n      techNameKorean.includes(\"허리\") ||\n      techNameKorean.includes(\"몸\")\n    ) {\n      return GrappleTarget.TORSO;\n    }\n\n    // Default to arm for unspecified grapples\n    return GrappleTarget.ARM;\n  }\n\n  /**\n   * Update grapple state for players over time.\n   *\n   * **Korean**: 잡기 상태 업데이트 (Update Grapple State)\n   *\n   * @param controller - Player maintaining control\n   * @param target - Player being controlled\n   * @param deltaTime - Time elapsed in seconds\n   * @param currentTime - Current game time in milliseconds\n   * @returns Updated player states\n   */\n  updateGrappleState(\n    controller: PlayerState,\n    target: PlayerState,\n    deltaTime: number,\n    currentTime: number\n  ): {\n    updatedController: PlayerState;\n    updatedTarget: PlayerState;\n  } {\n    if (!controller.grappleControl) {\n      // No active grapple\n      return {\n        updatedController: controller,\n        updatedTarget: target,\n      };\n    }\n\n    // Validate grapple control consistency\n    if (\n      controller.grappleControl.controllerId !== controller.id ||\n      controller.grappleControl.targetId !== target.id\n    ) {\n      // Inconsistent state - break grapple\n      return {\n        updatedController: {\n          ...controller,\n          combatState: CombatState.IDLE,\n          grappleControl: null,\n        },\n        updatedTarget: {\n          ...target,\n          combatState: CombatState.IDLE,\n          grappleControl: null,\n        },\n      };\n    }\n\n    // Update grapple control\n    const updatedControl = this.grappleSystem.updateGrapple(\n      controller.grappleControl,\n      controller,\n      target,\n      deltaTime,\n      currentTime\n    );\n\n    if (!updatedControl) {\n      // Grapple broken - reset both players\n      return {\n        updatedController: {\n          ...controller,\n          combatState: CombatState.IDLE,\n          grappleControl: null,\n        },\n        updatedTarget: {\n          ...target,\n          combatState: CombatState.IDLE,\n          grappleControl: null,\n        },\n      };\n    }\n\n    // Deduct stamina from controller\n    const staminaCost = updatedControl.staminaCostPerSecond * deltaTime;\n\n    return {\n      updatedController: {\n        ...controller,\n        grappleControl: updatedControl,\n        stamina: Math.max(0, controller.stamina - staminaCost),\n      },\n      updatedTarget: {\n        ...target,\n        grappleControl: updatedControl,\n      },\n    };\n  }\n\n  /**\n   * Fix: Make applyCombatResult non-static instance method with effect application\n   * Enhanced with Pain Response and Consciousness System integration\n   */\n  applyCombatResult(\n    result: CombatResult,\n    attacker: PlayerState,\n    defender: PlayerState,\n  ): { updatedAttacker: PlayerState; updatedDefender: PlayerState } {\n    // Start with base result\n    const { updatedAttacker, updatedDefender: initialDefender } =\n      CombatSystem.applyCombatResult(result, attacker, defender);\n    let updatedDefender = initialDefender;\n\n    if (result.hit && result.damage > 0) {\n      // Determine vital point category and severity from hit result\n      const category = this.getVitalPointCategory(result);\n      const severity = this.getVitalPointSeverity(result);\n\n      // Apply pain from damage\n      const { player: defenderWithPain, shockEffect: newShockEffect } =\n        this.painSystem.applyPain(\n          updatedDefender,\n          result.damage,\n          severity,\n          category,\n        );\n      updatedDefender = defenderWithPain;\n\n      // Store shock pain effect if triggered\n      if (newShockEffect) {\n        this.shockPainEffects.set(updatedDefender.id, newShockEffect);\n      }\n\n      // Check for pain overload stun\n      if (this.painSystem.shouldTriggerStun(updatedDefender)) {\n        updatedDefender = {\n          ...updatedDefender,\n          isStunned: true,\n        };\n      }\n\n      // Apply consciousness damage for head/neurological hits\n      if (this.isHeadTrauma(result, category)) {\n        updatedDefender = this.consciousnessSystem.applyDamage(\n          updatedDefender,\n          result.damage,\n          category,\n        );\n\n        // Track head trauma time for recovery gating\n        this.lastHeadTraumaTime.set(updatedDefender.id, Date.now());\n\n        // Check incapacitation threshold\n        if (\n          this.consciousnessSystem.isAtIncapacitationThreshold(updatedDefender)\n        ) {\n          updatedDefender = {\n            ...updatedDefender,\n            isStunned: true,\n            // Could add helpless duration tracking here if needed\n          };\n        }\n      }\n\n      // Apply pain and consciousness effects to stats\n      const currentShockEffect = this.shockPainEffects.get(updatedDefender.id);\n      updatedDefender = this.painSystem.applyEffects(\n        updatedDefender,\n        currentShockEffect,\n      );\n      updatedDefender = this.consciousnessSystem.applyEffects(updatedDefender);\n\n      // Apply balance disruption from the hit\n      // Determine body region from vital point or use default\n      const bodyRegion = this.getBodyRegionFromResult(result);\n      updatedDefender = this.balanceSystem.disruptBalance(\n        updatedDefender,\n        result.damage,\n        bodyRegion,\n      );\n\n      // Apply breathing disruption for torso strikes\n      if (result.vitalPointHit && result.targetedVitalPointId) {\n        // Vital point strike to torso\n        const vitalPoint = this.vitalPointSystem.getVitalPointById(\n          result.targetedVitalPointId,\n        );\n        if (vitalPoint && causesBreathingDisruption(vitalPoint.id)) {\n          updatedDefender = applyBreathingDisruptionFromVitalPoint(\n            updatedDefender,\n            vitalPoint,\n            Date.now(),\n          );\n        }\n      } else if (bodyRegion === BodyRegion.TORSO && result.damage >= 10) {\n        // General torso damage (non-vital point hits)\n        // Apply breathing disruption if damage is significant enough\n        // Note: Solar plexus detection is best-effort; vital point system is primary mechanism\n        const techniqueId = (result.technique?.id ?? \"\").toLowerCase();\n        const isSolarPlexusArea = \n          techniqueId.includes(\"solar\") ||\n          techniqueId.includes(\"myeongchi\");\n        updatedDefender = applyBreathingDisruptionFromTorsoDamage(\n          updatedDefender,\n          result.damage,\n          isSolarPlexusArea,\n          Date.now(),\n        );\n      }\n    }\n\n    return { updatedAttacker, updatedDefender };\n  }\n\n  /**\n   * Determines if a hit caused head trauma (affects consciousness).\n   *\n   * @param result - Combat result\n   * @param category - Vital point category\n   * @returns True if hit should affect consciousness\n   */\n  private isHeadTrauma(\n    result: CombatResult,\n    category?: VitalPointCategory,\n  ): boolean {\n    return isHeadTraumaHit(result, category);\n  }\n\n  /**\n   * Extracts vital point category from combat result.\n   *\n   * @param result - Combat result\n   * @returns Vital point category if available\n   */\n  private getVitalPointCategory(\n    result: CombatResult,\n  ): VitalPointCategory | undefined {\n    return extractVitalPointCategory(result);\n  }\n\n  /**\n   * Extracts vital point severity from combat result.\n   *\n   * @param result - Combat result\n   * @returns Vital point severity if critical hit\n   */\n  private getVitalPointSeverity(\n    result: CombatResult,\n  ): VitalPointSeverity | undefined {\n    if (result.vitalPointHit) {\n      if (result.isCritical) {\n        return VitalPointSeverity.CRITICAL;\n      }\n      if (result.damage > this.SEVERITY_MAJOR_THRESHOLD) {\n        return VitalPointSeverity.MAJOR;\n      }\n      if (result.damage > this.SEVERITY_MODERATE_THRESHOLD) {\n        return VitalPointSeverity.MODERATE;\n      }\n      return VitalPointSeverity.MINOR;\n    }\n    return undefined;\n  }\n\n  /**\n   * Determines body region from combat result for balance disruption.\n   *\n   * Maps vital points to body regions for balance system integration.\n   * Uses string matching on vital point IDs as a pragmatic heuristic since\n   * VitalPoint interface doesn't currently include a bodyRegion property.\n   *\n   * Future improvement: Add bodyRegion: BodyRegion to VitalPoint interface\n   * for more robust region mapping without string pattern matching.\n   *\n   * @param result - Combat result\n   * @returns Body region that was struck\n   * @private\n   * @korean 신체부위결정\n   */\n  private getBodyRegionFromResult(result: CombatResult): BodyRegion {\n    // If we have a targeted vital point, try to determine region\n    if (result.targetedVitalPointId) {\n      const vitalPoint = this.vitalPointSystem.getVitalPointById(\n        result.targetedVitalPointId,\n      );\n\n      if (vitalPoint) {\n        const pointId = vitalPoint.id.toLowerCase();\n\n        // Check for leg/lower body targets\n        if (\n          pointId.includes(\"leg\") ||\n          pointId.includes(\"knee\") ||\n          pointId.includes(\"ankle\") ||\n          pointId.includes(\"thigh\")\n        ) {\n          return BodyRegion.LEFT_LEG; // Generic leg for balance disruption\n        }\n\n        // Check for head targets\n        if (\n          pointId.includes(\"head\") ||\n          pointId.includes(\"temple\") ||\n          pointId.includes(\"jaw\") ||\n          pointId.includes(\"nose\")\n        ) {\n          return BodyRegion.HEAD;\n        }\n\n        // Check for arm targets\n        if (\n          pointId.includes(\"arm\") ||\n          pointId.includes(\"elbow\") ||\n          pointId.includes(\"wrist\") ||\n          pointId.includes(\"shoulder\")\n        ) {\n          return BodyRegion.LEFT_ARM;\n        }\n      }\n    }\n\n    // Default to torso for general strikes\n    return BodyRegion.TORSO;\n  }\n\n  /**\n   * Updates player states for recovery (pain dissipation, consciousness recovery, balance recovery).\n   * Call this regularly in game loop.\n   *\n   * @param player - Player to update\n   * @param deltaTime - Time elapsed since last update (ms)\n   * @returns Updated player state\n   */\n  applyRecovery(player: PlayerState, deltaTime: number): PlayerState {\n    let updatedPlayer = player;\n\n    // Apply pain recovery\n    updatedPlayer = this.painSystem.applyDissipation(updatedPlayer, deltaTime);\n\n    // Apply consciousness recovery (only if enough time since head trauma)\n    const lastTrauma = this.lastHeadTraumaTime.get(player.id);\n    updatedPlayer = this.consciousnessSystem.applyRecovery(\n      updatedPlayer,\n      deltaTime,\n      lastTrauma,\n    );\n\n    // Apply balance recovery\n    updatedPlayer = this.balanceSystem.applyRecovery(updatedPlayer, deltaTime);\n\n    // Clean up expired shock pain effects\n    const shockEffect = this.shockPainEffects.get(player.id);\n    if (shockEffect) {\n      const elapsed = Date.now() - shockEffect.startTime;\n      if (elapsed >= shockEffect.duration) {\n        this.shockPainEffects.delete(player.id);\n      }\n    }\n\n    return updatedPlayer;\n  }\n\n  /**\n   * Static version for backwards compatibility with comprehensive effect application\n   * Enhanced with Pain Response and Consciousness System integration\n   * Updated to apply damage to body parts for 8-body-part health visualization\n   */\n  static applyCombatResult(\n    result: CombatResult,\n    attacker: PlayerState,\n    defender: PlayerState,\n  ): { updatedAttacker: PlayerState; updatedDefender: PlayerState } {\n    // Apply damage and effects\n    let updatedDefender = defender;\n    let updatedAttacker = attacker;\n\n    if (result.hit) {\n      // Determine body region from technique or use random distribution\n      const bodyRegion = CombatSystem.getBodyRegionFromTechnique(\n        result.technique,\n      );\n\n      // Apply damage to body parts (this also updates aggregate health)\n      updatedDefender = applyDamageToBodyParts(\n        defender,\n        result.damage,\n        bodyRegion,\n      );\n\n      // Record injury for trauma visualization (외상 시각화)\n      // Use per-player injury tracking to prevent mixing injuries between characters\n      // Automatically tracks bruising, cuts, and blood effects based on damage type\n      // Records injury even without specific technique (defaults to BRUISE)\n      if (result.damage > 0) {\n        const defenderInjuryIntegration = playerInjuryManager.getIntegrationForPlayer(defender.id);\n        defenderInjuryIntegration.recordCombatDamage({\n          damage: result.damage,\n          bodyRegion,\n          damageType: (result.technique?.damageType as DamageType) || undefined,\n        });\n      }\n\n      // Update tracking stats (applyDamageToBodyParts already sets health)\n      updatedDefender = {\n        ...updatedDefender,\n        totalDamageReceived:\n          updatedDefender.totalDamageReceived + result.damage,\n        hitsTaken: updatedDefender.hitsTaken + 1,\n      };\n\n      // Apply status effects from vital point hit\n      if (result.effects && result.effects.length > 0) {\n        updatedDefender = addEffectsToPlayer(updatedDefender, result.effects);\n      }\n\n      // Track vital point hits\n      if (result.vitalPointHit) {\n        updatedAttacker = {\n          ...updatedAttacker,\n          vitalPointHits: attacker.vitalPointHits + 1,\n        };\n      }\n\n      // Track perfect strikes (high accuracy)\n      if (result.isCritical) {\n        updatedAttacker = {\n          ...updatedAttacker,\n          perfectStrikes: attacker.perfectStrikes + 1,\n        };\n      }\n    }\n\n    // Apply technique costs to attacker\n    updatedAttacker = {\n      ...updatedAttacker,\n      ki: Math.max(0, attacker.ki - 5),\n      stamina: Math.max(0, attacker.stamina - 10),\n      totalDamageDealt:\n        attacker.totalDamageDealt + (result.hit ? result.damage : 0),\n      hitsLanded: attacker.hitsLanded + (result.hit ? 1 : 0),\n    };\n\n    return { updatedAttacker, updatedDefender };\n  }\n\n  /**\n   * Determine body region from technique name or type\n   *\n   * **Korean**: 기술에서 신체 영역 결정\n   *\n   * @param technique - The technique used in the attack\n   * @returns Body region to apply damage to\n   */\n  private static getBodyRegionFromTechnique(\n    technique?: KoreanTechnique,\n  ): BodyRegion {\n    if (!technique) {\n      // Default to torso if no technique specified\n      return BodyRegion.TORSO;\n    }\n\n    const techniqueName = (\n      technique.name?.english ||\n      technique.englishName ||\n      \"\"\n    ).toLowerCase();\n    const techniqueId = technique.id?.toLowerCase() || \"\";\n\n    // Head/face targeting techniques\n    if (\n      techniqueName.includes(\"head\") ||\n      techniqueName.includes(\"temple\") ||\n      techniqueName.includes(\"jaw\") ||\n      techniqueName.includes(\"face\") ||\n      techniqueId.includes(\"head\") ||\n      techniqueId.includes(\"skull\")\n    ) {\n      return BodyRegion.HEAD;\n    }\n\n    // Neck targeting techniques\n    if (\n      techniqueName.includes(\"neck\") ||\n      techniqueName.includes(\"throat\") ||\n      techniqueName.includes(\"choke\") ||\n      techniqueId.includes(\"neck\")\n    ) {\n      return BodyRegion.NECK;\n    }\n\n    // Leg targeting techniques\n    if (\n      techniqueName.includes(\"kick\") ||\n      techniqueName.includes(\"sweep\") ||\n      techniqueName.includes(\"leg\") ||\n      techniqueName.includes(\"knee\") ||\n      techniqueId.includes(\"kick\") ||\n      techniqueId.includes(\"leg\")\n    ) {\n      // Randomly choose left or right leg\n      return Math.random() < 0.5 ? BodyRegion.LEFT_LEG : BodyRegion.RIGHT_LEG;\n    }\n\n    // Arm targeting techniques\n    if (\n      techniqueName.includes(\"arm\") ||\n      techniqueName.includes(\"shoulder\") ||\n      techniqueName.includes(\"elbow\") ||\n      techniqueId.includes(\"arm\")\n    ) {\n      // Randomly choose left or right arm\n      return Math.random() < 0.5 ? BodyRegion.LEFT_ARM : BodyRegion.RIGHT_ARM;\n    }\n\n    // Punch/strike techniques typically target torso\n    if (\n      techniqueName.includes(\"punch\") ||\n      techniqueName.includes(\"strike\") ||\n      techniqueName.includes(\"jab\") ||\n      techniqueName.includes(\"cross\") ||\n      techniqueName.includes(\"hook\") ||\n      techniqueName.includes(\"uppercut\")\n    ) {\n      // Mix of torso and head for punches\n      return Math.random() < 0.7 ? BodyRegion.TORSO : BodyRegion.HEAD;\n    }\n\n    // Body/core targeting techniques\n    if (\n      techniqueName.includes(\"body\") ||\n      techniqueName.includes(\"solar\") ||\n      techniqueName.includes(\"liver\") ||\n      techniqueName.includes(\"ribs\") ||\n      techniqueName.includes(\"abdomen\") ||\n      techniqueId.includes(\"torso\") ||\n      techniqueId.includes(\"core\")\n    ) {\n      return BodyRegion.TORSO;\n    }\n\n    // Default to torso for unmatched techniques\n    return BodyRegion.TORSO;\n  }\n\n  /**\n   * Fix: Add missing getAvailableTechniques method required by interface\n   */\n  getAvailableTechniques(player: PlayerState): readonly KoreanTechnique[] {\n    const allTechniques = TRIGRAM_TECHNIQUES[player.currentStance] ?? [];\n\n    // Filter techniques based on available resources using canExecuteTechnique\n    return allTechniques.filter((technique) =>\n      this.canExecuteTechnique(player, technique as KoreanTechnique),\n    ) as readonly KoreanTechnique[];\n  }\n\n  /**\n   * Check if attacker can execute technique\n   */\n  private canExecuteTechnique(\n    player: PlayerState,\n    technique: KoreanTechnique,\n  ): boolean {\n    return (\n      player.ki >= technique.kiCost &&\n      player.stamina >= technique.staminaCost &&\n      player.currentStance === technique.stance &&\n      !player.isStunned\n    );\n  }\n\n  /**\n   * Static methods for backwards compatibility\n   */\n  static resolveAttack(\n    attacker: PlayerState,\n    defender: PlayerState,\n    technique: KoreanTechnique,\n  ): CombatResult {\n    const instance = new CombatSystem();\n    return instance.executeAttack(attacker, defender, technique);\n  }\n\n  /**\n   * Check if a player is defeated\n   */\n  isPlayerDefeated(player: PlayerState): boolean {\n    return player.health <= 0 || player.consciousness <= 0;\n  }\n\n  /**\n   * Update player state over time with effect management\n   */\n  updatePlayerState(player: PlayerState, deltaTime: number): PlayerState {\n    let updatedPlayer = { ...player };\n\n    // Remove expired effects first\n    updatedPlayer = removeExpiredEffects(updatedPlayer);\n\n    // Get effect modifiers for resource regeneration\n    const effectModifiers = getEffectModifiers(updatedPlayer);\n\n    // Apply natural regeneration with effect modifiers\n    const regenRate = deltaTime / 1000; // Convert to seconds\n\n    // Ki regeneration (slower during combat) - affected by effects\n    if (updatedPlayer.ki < updatedPlayer.maxKi) {\n      updatedPlayer.ki = Math.min(\n        updatedPlayer.maxKi,\n        updatedPlayer.ki + regenRate * 2 * effectModifiers.kiRegen,\n      );\n    }\n\n    // Stamina regeneration - affected by effects and breathing disruption\n    // Uses BASE_STAMINA_REGEN_RATE constant for better gameplay\n    // Allows players to move around and attack frequently without running out\n    // 체력 재생 속도 - 더 활발한 전투를 위해\n    if (updatedPlayer.stamina < updatedPlayer.maxStamina) {\n      const baseStaminaRegen = regenRate * BASE_STAMINA_REGEN_RATE * effectModifiers.staminaRegen;\n      // Apply breathing disruption system's stamina regen modifier\n      const modifiedStaminaRegen =\n        BreathingDisruptionSystem.calculateStaminaRegen(\n          updatedPlayer,\n          baseStaminaRegen,\n        );\n      updatedPlayer.stamina = Math.min(\n        updatedPlayer.maxStamina,\n        updatedPlayer.stamina + modifiedStaminaRegen,\n      );\n    }\n\n    // Health regeneration (very slow)\n    if (\n      updatedPlayer.health < updatedPlayer.maxHealth &&\n      updatedPlayer.health > 0\n    ) {\n      updatedPlayer.health = Math.min(\n        updatedPlayer.maxHealth,\n        updatedPlayer.health + regenRate * 0.5,\n      );\n    }\n\n    // Update breathing disruption effects (gradual recovery if torso health > 50%)\n    updatedPlayer = updateBreathingDisruption(\n      updatedPlayer,\n      deltaTime,\n      Date.now(),\n    );\n\n    // Clear temporary combat states\n    const currentTime = Date.now();\n    if (\n      updatedPlayer.lastActionTime &&\n      currentTime - updatedPlayer.lastActionTime > updatedPlayer.recoveryTime\n    ) {\n      updatedPlayer.isStunned = false;\n      updatedPlayer.isCountering = false;\n    }\n\n    return updatedPlayer;\n  }\n\n  /**\n   * Get combat statistics\n   */\n  getCombatStatistics(player: PlayerState): {\n    healthPercent: number;\n    kiPercent: number;\n    staminaPercent: number;\n    balancePercent: number;\n  } {\n    return {\n      healthPercent: (player.health / player.maxHealth) * 100,\n      kiPercent: (player.ki / player.maxKi) * 100,\n      staminaPercent: (player.stamina / player.maxStamina) * 100,\n      balancePercent: player.balance,\n    };\n  }\n\n  /**\n   * Fix: Integrate processVitalPointHit into the combat system with archetype parameters\n   */\n  private processVitalPointHit(\n    vitalPointId: string,\n    _baseDamage: number, // Unused but kept for interface compatibility\n    attacker: PlayerState,\n    defender: PlayerState,\n  ): VitalPointHitResult {\n    const vitalPoint = this.vitalPointSystem.getVitalPointById(vitalPointId);\n\n    if (!vitalPoint) {\n      return {\n        hit: false,\n        damage: 0,\n        effects: [],\n        severity: VitalPointSeverity.MINOR,\n      };\n    }\n\n    // Use VitalPointSystem's processHit with full archetype support\n    return this.vitalPointSystem.processHit(\n      vitalPoint.position, // Use vital point position for hit calculation\n      { width: 10, height: 10 }, // Standard hit box\n      vitalPointId, // Targeted vital point\n      undefined, // Use current hour from system\n      attacker.archetype, // Attacker archetype for offensive modifiers\n      defender.archetype, // Defender archetype for defensive modifiers\n    );\n  }\n\n  /**\n   * Process defensive action and determine animation type.\n   *\n   * Determines the appropriate defensive animation based on:\n   * - Defender's balance and stamina (defensive power)\n   * - Attacker's technique power\n   * - Combat readiness state\n   *\n   * **Korean**: 방어 행동 처리\n   *\n   * @param defender - Defending player state\n   * @param attacker - Attacking player state (unused but kept for future enhancements)\n   * @param attackPower - Power of the incoming attack\n   * @returns Defensive animation type to play (parry_deflect, block_success, or guard_break)\n   *\n   * @example\n   * ```typescript\n   * const animType = combatSystem.processDefensiveAction(\n   *   defender,\n   *   attacker,\n   *   technique.damage\n   * );\n   * // Returns: 'parry_deflect', 'block_success', or 'guard_break'\n   * ```\n   *\n   * @public\n   * @korean 방어행동처리\n   */\n  public processDefensiveAction(\n    defender: PlayerState,\n    _attacker: PlayerState,\n    attackPower: number,\n  ): Exclude<DefensiveAnimationType, \"guard_recovery\"> {\n    // Guard Break: Check balance threshold first (highest priority condition)\n    if (defender.balance < 30) {\n      return \"guard_break\";\n    }\n\n    // Calculate defensive power based on balance and stamina\n    // Balance represents physical stability (0-100)\n    // Stamina represents energy reserves (0-100)\n    const balanceFactor = defender.balance / 100;\n    const staminaFactor = defender.stamina / 100;\n\n    // Apply defensive modifiers from effects\n    const effectModifiers = getEffectModifiers(defender);\n    const defenseMultiplier = effectModifiers.defense;\n\n    // Defense stat provides moderate bonus (normalized to 0.5-1.5 range for typical 5-15 defense)\n    const defenseBonus = Math.max(0.5, Math.min(1.5, defender.defense / 10));\n\n    // Calculate final defensive power\n    const defensePower =\n      balanceFactor * staminaFactor * 100 * defenseMultiplier * defenseBonus;\n\n    // Determine defensive outcome based on power ratio\n    // Parry: Strong defense (1.8x attack power or more) - Perfect deflection\n    if (defensePower >= attackPower * 1.8) {\n      return \"parry_deflect\";\n    }\n    // Block Success: Adequate defense (1.0x to 1.8x attack power) - Absorb impact\n    else if (defensePower >= attackPower) {\n      return \"block_success\";\n    }\n    // Guard Break: Defense insufficient against powerful attack (<60% of attack power)\n    else if (defensePower < attackPower * 0.6) {\n      return \"guard_break\";\n    }\n    // Block Success: Marginal defense (60-100% of attack power) - barely hold\n    else {\n      return \"block_success\";\n    }\n  }\n\n  /**\n   * Execute attack with technique\n   */\n  protected executeAttack(\n    attacker: PlayerState,\n    defender: PlayerState,\n    technique: KoreanTechnique,\n  ): CombatResult {\n    const hitRoll = Math.random();\n    const accuracy = technique.accuracy || 0.8;\n    const hit = hitRoll <= accuracy;\n\n    if (!hit) {\n      return {\n        hit: false,\n        damage: 0,\n        criticalHit: false,\n        vitalPointHit: false,\n        effects: [],\n        timestamp: Date.now(),\n        technique,\n        attacker,\n        defender,\n        success: false,\n        isCritical: false,\n        isBlocked: false,\n      };\n    }\n\n    // Calculate damage using the interface method\n    const vitalPointHit: VitalPointHitResult = {\n      hit: false,\n      damage: 0,\n      effects: [],\n      severity: VitalPointSeverity.MINOR, // Use the enum directly\n    };\n\n    const damageResult = this.calculateDamage(\n      technique,\n      attacker,\n      defender,\n      vitalPointHit,\n    );\n\n    return {\n      hit: true,\n      damage: damageResult.totalDamage,\n      criticalHit: Math.random() < (technique.critChance || 0.1),\n      vitalPointHit: false,\n      effects: damageResult.effectsApplied,\n      timestamp: Date.now(),\n      technique,\n      attacker,\n      defender,\n      success: true,\n      isCritical: false,\n      isBlocked: false,\n    };\n  }\n\n  /**\n   * Fix: Add missing calculateDamage method required by interface\n   */\n  calculateDamage(\n    technique: KoreanTechnique,\n    attacker: PlayerState,\n    defender: PlayerState,\n    hitResult: VitalPointHitResult,\n  ): {\n    baseDamage: number;\n    modifierDamage: number;\n    totalDamage: number;\n    effectsApplied: readonly StatusEffect[];\n    finalDefenderState?: Partial<PlayerState>;\n  } {\n    // Calculate base damage from technique\n    const baseDamage = technique.damage || 15;\n\n    // Apply attacker modifiers\n    const attackerBonus = attacker.attackPower * 0.1;\n\n    // Apply vital point modifiers if hit\n    let vitalPointMultiplier = 1.0;\n    if (hitResult.hit && hitResult.vitalPointHit) {\n      // Use the correct property name\n      const severityMultipliers: Record<VitalPointSeverity, number> = {\n        [VitalPointSeverity.MINOR]: 1.1,\n        [VitalPointSeverity.MODERATE]: 1.3,\n        [VitalPointSeverity.MAJOR]: 1.6,\n        [VitalPointSeverity.CRITICAL]: 2.0,\n        [VitalPointSeverity.LETHAL]: 3.0,\n      };\n\n      // Use the severity property directly\n      vitalPointMultiplier = severityMultipliers[hitResult.severity] ?? 1.0;\n    }\n\n    // Calculate total modifier damage\n    const modifierDamage = attackerBonus * vitalPointMultiplier;\n\n    // Apply defense reduction\n    const defenseReduction = defender.defense * 0.05;\n    const totalDamage = Math.max(\n      1,\n      baseDamage + modifierDamage - defenseReduction,\n    );\n\n    // Combine effects from technique and vital point hit\n    const effectsApplied = [...technique.effects, ...hitResult.effects];\n\n    return {\n      baseDamage,\n      modifierDamage,\n      totalDamage: Math.floor(totalDamage),\n      effectsApplied,\n      finalDefenderState: {\n        health: Math.max(0, defender.health - totalDamage),\n      },\n    };\n  }\n}\n\n/**\n * Creates a standardized CombatResult with all required fields\n * Ensures both 'critical' and 'criticalHit' are present for API compatibility\n */\nexport function createCombatResult(\n  partialResult: Partial<CombatResult>,\n): CombatResult {\n  // Set default values\n  const result: CombatResult = {\n    success: partialResult.success ?? false,\n    damage: partialResult.damage ?? 0,\n    isCritical: partialResult.isCritical ?? partialResult.criticalHit ?? false,\n    hit: partialResult.hit ?? partialResult.success ?? false,\n    isBlocked: partialResult.isBlocked ?? false,\n    vitalPointHit: partialResult.vitalPointHit ?? false,\n    effects: partialResult.effects ?? [],\n    attacker: partialResult.attacker,\n    defender: partialResult.defender,\n    technique: partialResult.technique,\n    // Always set criticalHit to match critical for consistency\n    criticalHit: partialResult.isCritical ?? partialResult.criticalHit ?? false,\n    timestamp: Date.now(),\n  };\n\n  return result;\n}\n\nexport default CombatSystem;\n"],"mappings":"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"}

package/lib/systems/EffectCalculator.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Effect calculation system for vital point strikes.
+ *
+ * **Korean**: 효과 계산 시스템 (Effect Calculation System)
+ *
+ * This module provides comprehensive calculations for status effect duration,
+ * intensity, and application based on vital point strikes, accuracy, severity,
+ * and archetype-specific modifiers.
+ *
+ * ## Key Features
+ *
+ * - **Duration Calculation**: Based on severity, accuracy, and archetype
+ * - **Intensity Scaling**: Scales with hit accuracy (0.5-1.5x)
+ * - **Archetype Modifiers**: Resistance and vulnerability factors
+ * - **Critical Hit Enhancement**: 2x duration for accuracy > 0.9
+ * - **Effect Stacking**: Manages multiple concurrent effects
+ *
+ * @module systems/EffectCalculator
+ * @category Combat Effects
+ * @korean 효과계산기
+ */
+import { PlayerArchetype, VitalPointSeverity } from "../types/common";
+import { EffectIntensity } from "./effects";
+import { StatusEffect } from "./types";
+import { VitalPointEffect } from "./vitalpoint/types";
+/**
+ * Maximum number of concurrent status effects allowed per player.
+ *
+ * **Korean**: 최대 동시 효과 개수
+ */
+export declare const MAX_CONCURRENT_EFFECTS = 5;
+/**
+ * Calculates the duration of a status effect based on multiple factors.
+ *
+ * **Korean**: 효과 지속시간 계산 (Calculate Effect Duration)
+ *
+ * Formula:
+ * ```
+ * duration = baseDuration * (1 + (accuracy - 0.5) * 0.5) * severityMultiplier * archetypeModifier
+ * ```
+ *
+ * For critical hits (accuracy >= 0.9):
+ * ```
+ * duration = duration * 2.0
+ * ```
+ *
+ * @param effect - Vital point effect with base duration
+ * @param accuracy - Hit accuracy (0-1)
+ * @param severity - Vital point severity level
+ * @param attackerArchetype - Attacking player's archetype
+ * @param defenderArchetype - Defending player's archetype
+ * @returns Calculated duration in milliseconds
+ *
+ * @example
+ * ```typescript
+ * const duration = calculateEffectDuration(
+ *   { id: "paralysis", duration: 2000, ... },
+ *   0.95, // High accuracy
+ *   VitalPointSeverity.MAJOR,
+ *   PlayerArchetype.AMSALJA, // Assassin attacker (+30%)
+ *   PlayerArchetype.MUSA // Warrior defender (+20% resistance)
+ * );
+ * // Result: 2000 * 1.225 * 1.5 * 1.3 * 0.8 * 2.0 = ~9,568ms
+ * ```
+ *
+ * @public
+ * @korean 효과지속시간계산
+ */
+export declare function calculateEffectDuration(effect: VitalPointEffect, accuracy: number, severity: VitalPointSeverity, attackerArchetype: PlayerArchetype, defenderArchetype: PlayerArchetype): number;
+/**
+ * Calculates the intensity of a status effect based on hit accuracy.
+ *
+ * **Korean**: 효과 강도 계산 (Calculate Effect Intensity)
+ *
+ * Scales effect intensity from 0.5x (poor accuracy) to 1.5x (perfect accuracy).
+ *
+ * @param baseIntensity - Base effect intensity
+ * @param accuracy - Hit accuracy (0-1)
+ * @returns Scaled intensity value
+ *
+ * @example
+ * ```typescript
+ * const intensity = calculateEffectIntensity(
+ *   EffectIntensity.MEDIUM,
+ *   0.9 // High accuracy
+ * );
+ * // Returns scaled intensity for 90% accuracy hit
+ * ```
+ *
+ * @public
+ * @korean 효과강도계산
+ */
+export declare function calculateEffectIntensity(baseIntensity: EffectIntensity, accuracy: number): EffectIntensity;
+/**
+ * Converts a VitalPointEffect to a StatusEffect with calculated properties.
+ *
+ * **Korean**: 급소 효과를 상태 효과로 변환 (Convert Vital Point Effect to Status Effect)
+ *
+ * @param effect - Vital point effect to convert
+ * @param accuracy - Hit accuracy
+ * @param severity - Vital point severity
+ * @param attackerArchetype - Attacker's archetype
+ * @param defenderArchetype - Defender's archetype
+ * @param vitalPointId - Source vital point ID
+ * @param timestamp - Current timestamp (for startTime/endTime)
+ * @returns StatusEffect with calculated duration and intensity
+ *
+ * @public
+ * @korean 상태효과변환
+ */
+export declare function convertToStatusEffect(effect: VitalPointEffect, accuracy: number, severity: VitalPointSeverity, attackerArchetype: PlayerArchetype, defenderArchetype: PlayerArchetype, vitalPointId: string, timestamp: number): StatusEffect;
+/**
+ * Applies effect stacking logic to a list of status effects.
+ *
+ * **Korean**: 효과 중첩 관리 (Manage Effect Stacking)
+ *
+ * Rules:
+ * - Non-stackable effects: Keep only the most recent
+ * - Stackable effects: Allow up to MAX_CONCURRENT_EFFECTS
+ * - Expired effects: Remove automatically
+ *
+ * @param currentEffects - Existing active effects
+ * @param newEffects - New effects to add
+ * @param currentTime - Current timestamp
+ * @returns Updated effect list with stacking applied
+ *
+ * @example
+ * ```typescript
+ * const updated = applyEffectStacking(
+ *   player.statusEffects,
+ *   newVitalPointEffects,
+ *   Date.now()
+ * );
+ * ```
+ *
+ * @public
+ * @korean 효과중첩적용
+ */
+export declare function applyEffectStacking(currentEffects: readonly StatusEffect[], newEffects: readonly StatusEffect[], currentTime: number): StatusEffect[];
+/**
+ * Gets the offensive effect modifier for an archetype.
+ *
+ * **Korean**: 원형 공격 배율 조회 (Get Archetype Offensive Modifier)
+ *
+ * @param archetype - Player archetype
+ * @returns Offensive effect multiplier (1.0 - 1.3)
+ *
+ * @public
+ * @korean 원형공격배율조회
+ */
+export declare function getArchetypeOffensiveModifier(archetype: PlayerArchetype): number;
+/**
+ * Gets the defensive resistance modifier for an archetype.
+ *
+ * **Korean**: 원형 방어 배율 조회 (Get Archetype Defensive Modifier)
+ *
+ * @param archetype - Player archetype
+ * @returns Resistance modifier (-0.1 to 0.2)
+ *
+ * @public
+ * @korean 원형방어배율조회
+ */
+export declare function getArchetypeDefensiveModifier(archetype: PlayerArchetype): number;
+/**
+ * Checks if a hit qualifies as a critical hit based on accuracy.
+ *
+ * **Korean**: 크리티컬 타격 판정 (Check Critical Hit)
+ *
+ * @param accuracy - Hit accuracy (0-1)
+ * @returns True if accuracy >= 0.9 (critical hit)
+ *
+ * @public
+ * @korean 크리티컬판정
+ */
+export declare function isCriticalHit(accuracy: number): boolean;
+//# sourceMappingURL=EffectCalculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EffectCalculator.d.ts","sourceRoot":"","sources":["../../src/systems/EffectCalculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA8BtD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAsCxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,iBAAiB,EAAE,eAAe,EAClC,iBAAiB,EAAE,eAAe,GACjC,MAAM,CA0BR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,eAAe,EAC9B,QAAQ,EAAE,MAAM,GACf,eAAe,CAuCjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,iBAAiB,EAAE,eAAe,EAClC,iBAAiB,EAAE,eAAe,EAClC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,YAAY,CAsBd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,SAAS,YAAY,EAAE,EACvC,UAAU,EAAE,SAAS,YAAY,EAAE,EACnC,WAAW,EAAE,MAAM,GAClB,YAAY,EAAE,CA2BhB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,eAAe,GACzB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,eAAe,GACzB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/lib/systems/EffectCalculator.js

@@ -0,0 +1,251 @@
+import { PlayerArchetype, VitalPointSeverity } from "../types/common.js";
+import { EffectIntensity } from "./effects.js";
+//#region src/systems/EffectCalculator.ts
+/**
+* Effect calculation system for vital point strikes.
+* 
+* **Korean**: 효과 계산 시스템 (Effect Calculation System)
+* 
+* This module provides comprehensive calculations for status effect duration,
+* intensity, and application based on vital point strikes, accuracy, severity,
+* and archetype-specific modifiers.
+* 
+* ## Key Features
+* 
+* - **Duration Calculation**: Based on severity, accuracy, and archetype
+* - **Intensity Scaling**: Scales with hit accuracy (0.5-1.5x)
+* - **Archetype Modifiers**: Resistance and vulnerability factors
+* - **Critical Hit Enhancement**: 2x duration for accuracy > 0.9
+* - **Effect Stacking**: Manages multiple concurrent effects
+* 
+* @module systems/EffectCalculator
+* @category Combat Effects
+* @korean 효과계산기
+*/
+/**
+* Severity multipliers for effect duration calculation.
+* 
+* **Korean**: 심각도 배율 (Severity Multipliers)
+*/
+var SEVERITY_MULTIPLIERS = {
+	[VitalPointSeverity.MINOR]: .5,
+	[VitalPointSeverity.MODERATE]: 1,
+	[VitalPointSeverity.MAJOR]: 1.5,
+	[VitalPointSeverity.CRITICAL]: 2,
+	[VitalPointSeverity.LETHAL]: 3
+};
+/**
+* Critical hit accuracy threshold.
+* Strikes with accuracy >= 0.9 are considered critical.
+* 
+* **Korean**: 크리티컬 정확도 기준점
+*/
+var CRITICAL_HIT_THRESHOLD = .9;
+/**
+* Critical hit duration multiplier.
+* 
+* **Korean**: 크리티컬 타격 지속시간 배율
+*/
+var CRITICAL_DURATION_MULTIPLIER = 2;
+/**
+* Archetype resistance modifiers.
+* Positive values = resistance (effects last shorter)
+* Negative values = vulnerability (effects last longer)
+* 
+* **Korean**: 원형별 저항력 배율 (Archetype Resistance Modifiers)
+*/
+var ARCHETYPE_RESISTANCE = {
+	[PlayerArchetype.MUSA]: .2,
+	[PlayerArchetype.AMSALJA]: -.1,
+	[PlayerArchetype.HACKER]: 0,
+	[PlayerArchetype.JEONGBO_YOWON]: .1,
+	[PlayerArchetype.JOJIK_POKRYEOKBAE]: .15
+};
+/**
+* Archetype offensive effect modifiers.
+* Applied when archetype deals vital point strike.
+* 
+* **Korean**: 원형별 공격 효과 배율 (Archetype Offensive Modifiers)
+*/
+var ARCHETYPE_OFFENSIVE = {
+	[PlayerArchetype.MUSA]: 1,
+	[PlayerArchetype.AMSALJA]: 1.3,
+	[PlayerArchetype.HACKER]: 1.15,
+	[PlayerArchetype.JEONGBO_YOWON]: 1.25,
+	[PlayerArchetype.JOJIK_POKRYEOKBAE]: 1.2
+};
+/**
+* Default effect duration in milliseconds if not specified.
+* 
+* **Korean**: 기본 효과 지속시간 (Default Effect Duration)
+*/
+var DEFAULT_EFFECT_DURATION = 2e3;
+/**
+* Calculates the duration of a status effect based on multiple factors.
+* 
+* **Korean**: 효과 지속시간 계산 (Calculate Effect Duration)
+* 
+* Formula:
+* ```
+* duration = baseDuration * (1 + (accuracy - 0.5) * 0.5) * severityMultiplier * archetypeModifier
+* ```
+* 
+* For critical hits (accuracy >= 0.9):
+* ```
+* duration = duration * 2.0
+* ```
+* 
+* @param effect - Vital point effect with base duration
+* @param accuracy - Hit accuracy (0-1)
+* @param severity - Vital point severity level
+* @param attackerArchetype - Attacking player's archetype
+* @param defenderArchetype - Defending player's archetype
+* @returns Calculated duration in milliseconds
+* 
+* @example
+* ```typescript
+* const duration = calculateEffectDuration(
+*   { id: "paralysis", duration: 2000, ... },
+*   0.95, // High accuracy
+*   VitalPointSeverity.MAJOR,
+*   PlayerArchetype.AMSALJA, // Assassin attacker (+30%)
+*   PlayerArchetype.MUSA // Warrior defender (+20% resistance)
+* );
+* // Result: 2000 * 1.225 * 1.5 * 1.3 * 0.8 * 2.0 = ~9,568ms
+* ```
+* 
+* @public
+* @korean 효과지속시간계산
+*/
+function calculateEffectDuration(effect, accuracy, severity, attackerArchetype, defenderArchetype) {
+	const baseDuration = effect.duration || DEFAULT_EFFECT_DURATION;
+	const accuracyBonus = 1 + (accuracy - .5) * .5;
+	const severityMult = SEVERITY_MULTIPLIERS[severity] || 1;
+	const offensiveModifier = ARCHETYPE_OFFENSIVE[attackerArchetype] || 1;
+	const resistanceModifier = 1 - (ARCHETYPE_RESISTANCE[defenderArchetype] || 0);
+	let finalDuration = baseDuration * accuracyBonus * severityMult * offensiveModifier * resistanceModifier;
+	if (accuracy >= CRITICAL_HIT_THRESHOLD) finalDuration *= CRITICAL_DURATION_MULTIPLIER;
+	return Math.floor(finalDuration);
+}
+/**
+* Calculates the intensity of a status effect based on hit accuracy.
+* 
+* **Korean**: 효과 강도 계산 (Calculate Effect Intensity)
+* 
+* Scales effect intensity from 0.5x (poor accuracy) to 1.5x (perfect accuracy).
+* 
+* @param baseIntensity - Base effect intensity
+* @param accuracy - Hit accuracy (0-1)
+* @returns Scaled intensity value
+* 
+* @example
+* ```typescript
+* const intensity = calculateEffectIntensity(
+*   EffectIntensity.MEDIUM,
+*   0.9 // High accuracy
+* );
+* // Returns scaled intensity for 90% accuracy hit
+* ```
+* 
+* @public
+* @korean 효과강도계산
+*/
+function calculateEffectIntensity(baseIntensity, accuracy) {
+	const intensityMap = {
+		[EffectIntensity.WEAK]: 1,
+		[EffectIntensity.MINOR]: 2,
+		[EffectIntensity.LOW]: 3,
+		[EffectIntensity.MEDIUM]: 4,
+		[EffectIntensity.MODERATE]: 5,
+		[EffectIntensity.HIGH]: 6,
+		[EffectIntensity.SEVERE]: 7,
+		[EffectIntensity.CRITICAL]: 8,
+		[EffectIntensity.EXTREME]: 9
+	};
+	const reverseMap = [
+		EffectIntensity.WEAK,
+		EffectIntensity.MINOR,
+		EffectIntensity.LOW,
+		EffectIntensity.MEDIUM,
+		EffectIntensity.MODERATE,
+		EffectIntensity.HIGH,
+		EffectIntensity.SEVERE,
+		EffectIntensity.CRITICAL,
+		EffectIntensity.EXTREME
+	];
+	const baseLevel = intensityMap[baseIntensity] || 4;
+	const accuracyModifier = .5 + accuracy;
+	return reverseMap[Math.max(1, Math.min(9, Math.round(baseLevel * accuracyModifier))) - 1];
+}
+/**
+* Converts a VitalPointEffect to a StatusEffect with calculated properties.
+* 
+* **Korean**: 급소 효과를 상태 효과로 변환 (Convert Vital Point Effect to Status Effect)
+* 
+* @param effect - Vital point effect to convert
+* @param accuracy - Hit accuracy
+* @param severity - Vital point severity
+* @param attackerArchetype - Attacker's archetype
+* @param defenderArchetype - Defender's archetype
+* @param vitalPointId - Source vital point ID
+* @param timestamp - Current timestamp (for startTime/endTime)
+* @returns StatusEffect with calculated duration and intensity
+* 
+* @public
+* @korean 상태효과변환
+*/
+function convertToStatusEffect(effect, accuracy, severity, attackerArchetype, defenderArchetype, vitalPointId, timestamp) {
+	const duration = calculateEffectDuration(effect, accuracy, severity, attackerArchetype, defenderArchetype);
+	const intensity = calculateEffectIntensity(effect.intensity, accuracy);
+	return {
+		id: `${effect.id}_${timestamp}`,
+		type: effect.type,
+		intensity,
+		duration,
+		description: effect.description,
+		stackable: effect.stackable,
+		source: vitalPointId,
+		startTime: timestamp,
+		endTime: timestamp + duration
+	};
+}
+/**
+* Applies effect stacking logic to a list of status effects.
+* 
+* **Korean**: 효과 중첩 관리 (Manage Effect Stacking)
+* 
+* Rules:
+* - Non-stackable effects: Keep only the most recent
+* - Stackable effects: Allow up to MAX_CONCURRENT_EFFECTS
+* - Expired effects: Remove automatically
+* 
+* @param currentEffects - Existing active effects
+* @param newEffects - New effects to add
+* @param currentTime - Current timestamp
+* @returns Updated effect list with stacking applied
+* 
+* @example
+* ```typescript
+* const updated = applyEffectStacking(
+*   player.statusEffects,
+*   newVitalPointEffects,
+*   Date.now()
+* );
+* ```
+* 
+* @public
+* @korean 효과중첩적용
+*/
+function applyEffectStacking(currentEffects, newEffects, currentTime) {
+	let activeEffects = currentEffects.filter((effect) => effect.endTime > currentTime);
+	for (const newEffect of newEffects) {
+		if (!newEffect.stackable) activeEffects = activeEffects.filter((effect) => effect.type !== newEffect.type);
+		activeEffects = [...activeEffects, newEffect];
+	}
+	if (activeEffects.length > 5) activeEffects = activeEffects.sort((a, b) => b.startTime - a.startTime).slice(0, 5);
+	return activeEffects;
+}
+//#endregion
+export { applyEffectStacking, convertToStatusEffect };
+
+//# sourceMappingURL=EffectCalculator.js.map

package/lib/systems/EffectCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectCalculator.js","names":[],"sources":["../../src/systems/EffectCalculator.ts"],"sourcesContent":["/**\n * Effect calculation system for vital point strikes.\n * \n * **Korean**: 효과 계산 시스템 (Effect Calculation System)\n * \n * This module provides comprehensive calculations for status effect duration,\n * intensity, and application based on vital point strikes, accuracy, severity,\n * and archetype-specific modifiers.\n * \n * ## Key Features\n * \n * - **Duration Calculation**: Based on severity, accuracy, and archetype\n * - **Intensity Scaling**: Scales with hit accuracy (0.5-1.5x)\n * - **Archetype Modifiers**: Resistance and vulnerability factors\n * - **Critical Hit Enhancement**: 2x duration for accuracy > 0.9\n * - **Effect Stacking**: Manages multiple concurrent effects\n * \n * @module systems/EffectCalculator\n * @category Combat Effects\n * @korean 효과계산기\n */\n\nimport { PlayerArchetype, VitalPointSeverity } from \"../types/common\";\nimport { EffectIntensity } from \"./effects\";\nimport { StatusEffect } from \"./types\";\nimport { VitalPointEffect } from \"./vitalpoint/types\";\n\n/**\n * Severity multipliers for effect duration calculation.\n * \n * **Korean**: 심각도 배율 (Severity Multipliers)\n */\nconst SEVERITY_MULTIPLIERS: 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 * Critical hit accuracy threshold.\n * Strikes with accuracy >= 0.9 are considered critical.\n * \n * **Korean**: 크리티컬 정확도 기준점\n */\nconst CRITICAL_HIT_THRESHOLD = 0.9;\n\n/**\n * Critical hit duration multiplier.\n * \n * **Korean**: 크리티컬 타격 지속시간 배율\n */\nconst CRITICAL_DURATION_MULTIPLIER = 2.0;\n\n/**\n * Maximum number of concurrent status effects allowed per player.\n * \n * **Korean**: 최대 동시 효과 개수\n */\nexport const MAX_CONCURRENT_EFFECTS = 5;\n\n/**\n * Archetype resistance modifiers.\n * Positive values = resistance (effects last shorter)\n * Negative values = vulnerability (effects last longer)\n * \n * **Korean**: 원형별 저항력 배율 (Archetype Resistance Modifiers)\n */\nconst ARCHETYPE_RESISTANCE: Record<PlayerArchetype, number> = {\n  [PlayerArchetype.MUSA]: 0.2, // +20% resistance (traditional warrior discipline)\n  [PlayerArchetype.AMSALJA]: -0.1, // -10% resistance (glass cannon)\n  [PlayerArchetype.HACKER]: 0.0, // Neutral resistance\n  [PlayerArchetype.JEONGBO_YOWON]: 0.1, // +10% resistance (mental fortitude)\n  [PlayerArchetype.JOJIK_POKRYEOKBAE]: 0.15, // +15% resistance (street-hardened)\n};\n\n/**\n * Archetype offensive effect modifiers.\n * Applied when archetype deals vital point strike.\n * \n * **Korean**: 원형별 공격 효과 배율 (Archetype Offensive Modifiers)\n */\nconst ARCHETYPE_OFFENSIVE: Record<PlayerArchetype, number> = {\n  [PlayerArchetype.MUSA]: 1.0, // Standard effects\n  [PlayerArchetype.AMSALJA]: 1.3, // +30% effect potency (assassination mastery)\n  [PlayerArchetype.HACKER]: 1.15, // +15% effect potency (precision targeting)\n  [PlayerArchetype.JEONGBO_YOWON]: 1.25, // +25% effect potency (anatomical knowledge)\n  [PlayerArchetype.JOJIK_POKRYEOKBAE]: 1.2, // +20% effect potency (brutal efficiency)\n};\n\n/**\n * Default effect duration in milliseconds if not specified.\n * \n * **Korean**: 기본 효과 지속시간 (Default Effect Duration)\n */\nconst DEFAULT_EFFECT_DURATION = 2000;\n\n/**\n * Calculates the duration of a status effect based on multiple factors.\n * \n * **Korean**: 효과 지속시간 계산 (Calculate Effect Duration)\n * \n * Formula:\n * ```\n * duration = baseDuration * (1 + (accuracy - 0.5) * 0.5) * severityMultiplier * archetypeModifier\n * ```\n * \n * For critical hits (accuracy >= 0.9):\n * ```\n * duration = duration * 2.0\n * ```\n * \n * @param effect - Vital point effect with base duration\n * @param accuracy - Hit accuracy (0-1)\n * @param severity - Vital point severity level\n * @param attackerArchetype - Attacking player's archetype\n * @param defenderArchetype - Defending player's archetype\n * @returns Calculated duration in milliseconds\n * \n * @example\n * ```typescript\n * const duration = calculateEffectDuration(\n *   { id: \"paralysis\", duration: 2000, ... },\n *   0.95, // High accuracy\n *   VitalPointSeverity.MAJOR,\n *   PlayerArchetype.AMSALJA, // Assassin attacker (+30%)\n *   PlayerArchetype.MUSA // Warrior defender (+20% resistance)\n * );\n * // Result: 2000 * 1.225 * 1.5 * 1.3 * 0.8 * 2.0 = ~9,568ms\n * ```\n * \n * @public\n * @korean 효과지속시간계산\n */\nexport function calculateEffectDuration(\n  effect: VitalPointEffect,\n  accuracy: number,\n  severity: VitalPointSeverity,\n  attackerArchetype: PlayerArchetype,\n  defenderArchetype: PlayerArchetype\n): number {\n  const baseDuration = effect.duration || DEFAULT_EFFECT_DURATION;\n\n  // Accuracy bonus: 0.75x at 0 accuracy, 1.0x at 0.5, 1.25x at 1.0\n  const accuracyBonus = 1 + (accuracy - 0.5) * 0.5;\n\n  // Severity multiplier\n  const severityMult = SEVERITY_MULTIPLIERS[severity] || 1.0;\n\n  // Attacker offensive modifier\n  const offensiveModifier = ARCHETYPE_OFFENSIVE[attackerArchetype] || 1.0;\n\n  // Defender resistance modifier (inverted: resistance reduces duration)\n  const resistanceModifier =\n    1 - (ARCHETYPE_RESISTANCE[defenderArchetype] || 0);\n\n  // Calculate base duration\n  let finalDuration =\n    baseDuration * accuracyBonus * severityMult * offensiveModifier * resistanceModifier;\n\n  // Critical hit bonus for high accuracy\n  if (accuracy >= CRITICAL_HIT_THRESHOLD) {\n    finalDuration *= CRITICAL_DURATION_MULTIPLIER;\n  }\n\n  return Math.floor(finalDuration);\n}\n\n/**\n * Calculates the intensity of a status effect based on hit accuracy.\n * \n * **Korean**: 효과 강도 계산 (Calculate Effect Intensity)\n * \n * Scales effect intensity from 0.5x (poor accuracy) to 1.5x (perfect accuracy).\n * \n * @param baseIntensity - Base effect intensity\n * @param accuracy - Hit accuracy (0-1)\n * @returns Scaled intensity value\n * \n * @example\n * ```typescript\n * const intensity = calculateEffectIntensity(\n *   EffectIntensity.MEDIUM,\n *   0.9 // High accuracy\n * );\n * // Returns scaled intensity for 90% accuracy hit\n * ```\n * \n * @public\n * @korean 효과강도계산\n */\nexport function calculateEffectIntensity(\n  baseIntensity: EffectIntensity,\n  accuracy: number\n): EffectIntensity {\n  // Map intensities to numeric scale\n  const intensityMap: Record<EffectIntensity, number> = {\n    [EffectIntensity.WEAK]: 1,\n    [EffectIntensity.MINOR]: 2,\n    [EffectIntensity.LOW]: 3,\n    [EffectIntensity.MEDIUM]: 4,\n    [EffectIntensity.MODERATE]: 5,\n    [EffectIntensity.HIGH]: 6,\n    [EffectIntensity.SEVERE]: 7,\n    [EffectIntensity.CRITICAL]: 8,\n    [EffectIntensity.EXTREME]: 9,\n  };\n\n  // Reverse map for lookup\n  const reverseMap: EffectIntensity[] = [\n    EffectIntensity.WEAK,\n    EffectIntensity.MINOR,\n    EffectIntensity.LOW,\n    EffectIntensity.MEDIUM,\n    EffectIntensity.MODERATE,\n    EffectIntensity.HIGH,\n    EffectIntensity.SEVERE,\n    EffectIntensity.CRITICAL,\n    EffectIntensity.EXTREME,\n  ];\n\n  const baseLevel = intensityMap[baseIntensity] || 4;\n\n  // Accuracy modifier: 0.5x at 0 accuracy, 1.0x at 0.5, 1.5x at 1.0\n  const accuracyModifier = 0.5 + accuracy;\n\n  // Calculate scaled level\n  const scaledLevel = Math.max(\n    1,\n    Math.min(9, Math.round(baseLevel * accuracyModifier))\n  );\n\n  return reverseMap[scaledLevel - 1];\n}\n\n/**\n * Converts a VitalPointEffect to a StatusEffect with calculated properties.\n * \n * **Korean**: 급소 효과를 상태 효과로 변환 (Convert Vital Point Effect to Status Effect)\n * \n * @param effect - Vital point effect to convert\n * @param accuracy - Hit accuracy\n * @param severity - Vital point severity\n * @param attackerArchetype - Attacker's archetype\n * @param defenderArchetype - Defender's archetype\n * @param vitalPointId - Source vital point ID\n * @param timestamp - Current timestamp (for startTime/endTime)\n * @returns StatusEffect with calculated duration and intensity\n * \n * @public\n * @korean 상태효과변환\n */\nexport function convertToStatusEffect(\n  effect: VitalPointEffect,\n  accuracy: number,\n  severity: VitalPointSeverity,\n  attackerArchetype: PlayerArchetype,\n  defenderArchetype: PlayerArchetype,\n  vitalPointId: string,\n  timestamp: number\n): StatusEffect {\n  const duration = calculateEffectDuration(\n    effect,\n    accuracy,\n    severity,\n    attackerArchetype,\n    defenderArchetype\n  );\n\n  const intensity = calculateEffectIntensity(effect.intensity, accuracy);\n\n  return {\n    id: `${effect.id}_${timestamp}`,\n    type: effect.type,\n    intensity,\n    duration,\n    description: effect.description,\n    stackable: effect.stackable,\n    source: vitalPointId,\n    startTime: timestamp,\n    endTime: timestamp + duration,\n  };\n}\n\n/**\n * Applies effect stacking logic to a list of status effects.\n * \n * **Korean**: 효과 중첩 관리 (Manage Effect Stacking)\n * \n * Rules:\n * - Non-stackable effects: Keep only the most recent\n * - Stackable effects: Allow up to MAX_CONCURRENT_EFFECTS\n * - Expired effects: Remove automatically\n * \n * @param currentEffects - Existing active effects\n * @param newEffects - New effects to add\n * @param currentTime - Current timestamp\n * @returns Updated effect list with stacking applied\n * \n * @example\n * ```typescript\n * const updated = applyEffectStacking(\n *   player.statusEffects,\n *   newVitalPointEffects,\n *   Date.now()\n * );\n * ```\n * \n * @public\n * @korean 효과중첩적용\n */\nexport function applyEffectStacking(\n  currentEffects: readonly StatusEffect[],\n  newEffects: readonly StatusEffect[],\n  currentTime: number\n): StatusEffect[] {\n  // Remove expired effects\n  let activeEffects = currentEffects.filter(\n    (effect) => effect.endTime > currentTime\n  );\n\n  // Process each new effect\n  for (const newEffect of newEffects) {\n    if (!newEffect.stackable) {\n      // Remove existing effects of same type (non-stackable)\n      activeEffects = activeEffects.filter(\n        (effect) => effect.type !== newEffect.type\n      );\n    }\n\n    // Add new effect\n    activeEffects = [...activeEffects, newEffect];\n  }\n\n  // Limit to MAX_CONCURRENT_EFFECTS (keep most recent)\n  if (activeEffects.length > MAX_CONCURRENT_EFFECTS) {\n    activeEffects = activeEffects\n      .sort((a, b) => b.startTime - a.startTime)\n      .slice(0, MAX_CONCURRENT_EFFECTS);\n  }\n\n  return activeEffects;\n}\n\n/**\n * Gets the offensive effect modifier for an archetype.\n * \n * **Korean**: 원형 공격 배율 조회 (Get Archetype Offensive Modifier)\n * \n * @param archetype - Player archetype\n * @returns Offensive effect multiplier (1.0 - 1.3)\n * \n * @public\n * @korean 원형공격배율조회\n */\nexport function getArchetypeOffensiveModifier(\n  archetype: PlayerArchetype\n): number {\n  return ARCHETYPE_OFFENSIVE[archetype] || 1.0;\n}\n\n/**\n * Gets the defensive resistance modifier for an archetype.\n * \n * **Korean**: 원형 방어 배율 조회 (Get Archetype Defensive Modifier)\n * \n * @param archetype - Player archetype\n * @returns Resistance modifier (-0.1 to 0.2)\n * \n * @public\n * @korean 원형방어배율조회\n */\nexport function getArchetypeDefensiveModifier(\n  archetype: PlayerArchetype\n): number {\n  return ARCHETYPE_RESISTANCE[archetype] || 0;\n}\n\n/**\n * Checks if a hit qualifies as a critical hit based on accuracy.\n * \n * **Korean**: 크리티컬 타격 판정 (Check Critical Hit)\n * \n * @param accuracy - Hit accuracy (0-1)\n * @returns True if accuracy >= 0.9 (critical hit)\n * \n * @public\n * @korean 크리티컬판정\n */\nexport function isCriticalHit(accuracy: number): boolean {\n  return accuracy >= CRITICAL_HIT_THRESHOLD;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,IAAM,uBAA2D;EAC9D,mBAAmB,QAAQ;EAC3B,mBAAmB,WAAW;EAC9B,mBAAmB,QAAQ;EAC3B,mBAAmB,WAAW;EAC9B,mBAAmB,SAAS;CAC9B;;;;;;;AAQD,IAAM,yBAAyB;;;;;;AAO/B,IAAM,+BAA+B;;;;;;;;AAgBrC,IAAM,uBAAwD;EAC3D,gBAAgB,OAAO;EACvB,gBAAgB,UAAU;EAC1B,gBAAgB,SAAS;EACzB,gBAAgB,gBAAgB;EAChC,gBAAgB,oBAAoB;CACtC;;;;;;;AAQD,IAAM,sBAAuD;EAC1D,gBAAgB,OAAO;EACvB,gBAAgB,UAAU;EAC1B,gBAAgB,SAAS;EACzB,gBAAgB,gBAAgB;EAChC,gBAAgB,oBAAoB;CACtC;;;;;;AAOD,IAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuChC,SAAgB,wBACd,QACA,UACA,UACA,mBACA,mBACQ;CACR,MAAM,eAAe,OAAO,YAAY;CAGxC,MAAM,gBAAgB,KAAK,WAAW,MAAO;CAG7C,MAAM,eAAe,qBAAqB,aAAa;CAGvD,MAAM,oBAAoB,oBAAoB,sBAAsB;CAGpE,MAAM,qBACJ,KAAK,qBAAqB,sBAAsB;CAGlD,IAAI,gBACF,eAAe,gBAAgB,eAAe,oBAAoB;AAGpE,KAAI,YAAY,uBACd,kBAAiB;AAGnB,QAAO,KAAK,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;AA0BlC,SAAgB,yBACd,eACA,UACiB;CAEjB,MAAM,eAAgD;GACnD,gBAAgB,OAAO;GACvB,gBAAgB,QAAQ;GACxB,gBAAgB,MAAM;GACtB,gBAAgB,SAAS;GACzB,gBAAgB,WAAW;GAC3B,gBAAgB,OAAO;GACvB,gBAAgB,SAAS;GACzB,gBAAgB,WAAW;GAC3B,gBAAgB,UAAU;EAC5B;CAGD,MAAM,aAAgC;EACpC,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EAChB,gBAAgB;EACjB;CAED,MAAM,YAAY,aAAa,kBAAkB;CAGjD,MAAM,mBAAmB,KAAM;AAQ/B,QAAO,WALa,KAAK,IACvB,GACA,KAAK,IAAI,GAAG,KAAK,MAAM,YAAY,iBAAiB,CAAC,CACtD,GAE+B;;;;;;;;;;;;;;;;;;;AAoBlC,SAAgB,sBACd,QACA,UACA,UACA,mBACA,mBACA,cACA,WACc;CACd,MAAM,WAAW,wBACf,QACA,UACA,UACA,mBACA,kBACD;CAED,MAAM,YAAY,yBAAyB,OAAO,WAAW,SAAS;AAEtE,QAAO;EACL,IAAI,GAAG,OAAO,GAAG,GAAG;EACpB,MAAM,OAAO;EACb;EACA;EACA,aAAa,OAAO;EACpB,WAAW,OAAO;EAClB,QAAQ;EACR,WAAW;EACX,SAAS,YAAY;EACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,SAAgB,oBACd,gBACA,YACA,aACgB;CAEhB,IAAI,gBAAgB,eAAe,QAChC,WAAW,OAAO,UAAU,YAC9B;AAGD,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,CAAC,UAAU,UAEb,iBAAgB,cAAc,QAC3B,WAAW,OAAO,SAAS,UAAU,KACvC;AAIH,kBAAgB,CAAC,GAAG,eAAe,UAAU;;AAI/C,KAAI,cAAc,SAAA,EAChB,iBAAgB,cACb,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU,CACzC,MAAM,GAAA,EAA0B;AAGrC,QAAO"}