blacktrigram 0.7.2

package/lib/components/screens/combat/hooks/useCombatActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatActions.js","names":[],"sources":["../../../../../src/components/screens/combat/hooks/useCombatActions.ts"],"sourcesContent":["/**\n * useCombatActions Hook - Combat Action Handlers\n *\n * Custom hook for managing combat action handlers.\n * Consolidates player attack, defend, technique, and AI action logic.\n *\n * Performance:\n * - Memoized callbacks to prevent recreation\n * - Centralized action logic for better maintainability\n * - Reduces main component complexity\n *\n * @param config Combat action configuration\n * @returns Combat action handlers\n *\n * @example\n * ```typescript\n * const {\n *   handleAttack,\n *   handleDefend,\n *   handleTechniqueExecute,\n *   handleStanceSwitch,\n *   handleAIAttack,\n *   handleAIDefend,\n *   handleAITechnique,\n *   moveAIPlayer\n * } = useCombatActions({\n *   validPlayers,\n *   playerPositions,\n *   combatState,\n *   combatActions,\n *   combatSystem,\n *   onPlayerUpdate,\n *   addCombatMessage,\n *   addHitEffect,\n *   arenaBounds\n * });\n * ```\n */\n\nimport { PlayerState } from \"@/systems\";\nimport {\n  AnimationType,\n  getAnimationHitTiming,\n  type AnimationState,\n} from \"@/systems/animation\";\nimport { movementPenaltySystem } from \"@/systems/bodypart\";\nimport { clampToArenaBounds, type PhysicsArenaBounds } from \"@/types/PhysicsTypes\";\nimport {\n  checkForFall,\n  getFallTypeName,\n} from \"@/systems/combat/FallIntegration\";\nimport type { CombatResult } from \"@/systems/combat/types\";\nimport { CombatSystem } from \"@/systems/CombatSystem\";\nimport { HitEffectType } from \"@/systems/effects\";\nimport { KnockbackPhysics } from \"@/systems/physics\";\nimport { StanceManager } from \"@/systems/trigram\";\nimport { KoreanTechniquesSystem } from \"@/systems/trigram/KoreanTechniques\";\nimport { getVitalPointById } from \"@/systems/vitalpoint/KoreanVitalPoints\";\nimport { KoreanTechnique } from \"@/systems/vitalpoint/types\";\nimport { Position, Technique, TrigramStance, BodyRegion } from \"@/types\";\nimport { Injury, InjuryType } from \"@/types/injury\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { AttackIntensity } from \"./useCombatAudio\";\nimport { CombatActions, CombatScreenState } from \"./useCombatState\";\n\n/**\n * Hit position variation range for randomizing strike heights\n * Produces ±0.2 absolute units (±10% of 2.0 character height)\n */\nconst HIT_Y_VARIATION_RANGE = 0.4;\n\n/**\n * Calculate randomized hit position based on defender position\n * Adds vertical variation to simulate different strike heights\n *\n * @param defenderPos - Position of the defender being struck\n * @returns Hit position with randomized Y coordinate\n */\nfunction calculateHitPosition(defenderPos: Position): { x: number; y: number } {\n  const hitYVariation = (Math.random() - 0.5) * HIT_Y_VARIATION_RANGE; // ±0.2 units\n  return {\n    x: defenderPos.x,\n    y: Math.max(0.3, Math.min(1.8, defenderPos.y + hitYVariation)),\n  };\n}\n\n/**\n * Determine injury type from combat result and technique damage type\n * 전투 결과와 기술 피해 유형으로 부상 유형 결정\n *\n * @param result - Combat result with damage information\n * @param technique - Technique that was executed\n * @returns InjuryType to create\n */\nfunction determineInjuryType(\n  result: CombatResult,\n  technique: KoreanTechnique,\n): InjuryType {\n  // Slashing damage creates cuts (damageType is a string, not enum)\n  if (technique.damageType === \"slashing\") {\n    return result.damage > 20 ? InjuryType.LACERATION : InjuryType.CUT;\n  }\n\n  // Heavy damage creates severe bruising\n  if (result.damage > 25) {\n    return InjuryType.BRUISE;\n  }\n\n  // Medium damage creates moderate bruising\n  if (result.damage > 15) {\n    return InjuryType.BRUISE;\n  }\n\n  // Light damage creates light bruising\n  return InjuryType.BRUISE;\n}\n\n/**\n * Map body region to 3D position offset on character model\n * 신체 부위를 캐릭터 모델의 3D 위치 오프셋으로 매핑\n *\n * @param region - Body region that was hit\n * @returns Position offset [x, y, z] relative to character center\n */\nfunction getBodyRegionPosition(region: BodyRegion): [number, number, number] {\n  // Map body regions to approximate positions on character model\n  // Character is ~2 units tall, centered at [0, 0, 0]\n  switch (region) {\n    case BodyRegion.HEAD:\n      return [0, 1.6, 0];\n    case BodyRegion.NECK:\n      return [0, 1.3, 0];\n    case BodyRegion.TORSO:\n    case BodyRegion.CORE:\n      return [0, 0.8, 0];\n    case BodyRegion.LEFT_ARM:\n      return [-0.4, 1.0, 0];\n    case BodyRegion.RIGHT_ARM:\n      return [0.4, 1.0, 0];\n    case BodyRegion.LEFT_LEG:\n      return [-0.2, 0.2, 0];\n    case BodyRegion.RIGHT_LEG:\n      return [0.2, 0.2, 0];\n    default:\n      return [0, 0.8, 0]; // Default to torso\n  }\n}\n\n/**\n * Create injury from combat damage result\n * 전투 피해 결과로부터 부상 생성\n *\n * @param result - Combat result with damage details\n * @param technique - Technique that caused the damage\n * @param defenderHealth - Current defender health after damage (0-100 scale)\n * @param targetPlayerIndex - Index of the player who was hit (0 or 1)\n * @returns Injury object for visualization\n */\nfunction createInjuryFromDamage(\n  result: CombatResult,\n  technique: KoreanTechnique,\n  defenderHealth: number,\n  targetPlayerIndex: number,\n): Injury {\n  // Determine body region - use torso as default if not specified\n  const bodyRegion = BodyRegion.TORSO; // TODO: Extract from result when available\n\n  // Determine injury type based on damage and technique\n  let injuryType = determineInjuryType(result, technique);\n\n  // Promote to fracture when health is critically low and damage is severe\n  // to align with TraumaOverlay3D fracture behavior\n  const isLowHealth = defenderHealth <= 30; // 30% health threshold\n  const isSevereDamage = result.damage >= 25; // Severe damage threshold\n  if (isLowHealth && isSevereDamage && injuryType !== InjuryType.FRACTURE) {\n    injuryType = InjuryType.FRACTURE;\n  }\n\n  // Calculate severity (0.0 to 1.0) based on damage\n  // Normalized so that a ~30-damage hit is treated as near-max severity\n  const severity = Math.min(1.0, result.damage / 30);\n\n  // Get position on character model for this body region\n  const basePosition = getBodyRegionPosition(bodyRegion);\n\n  // Add small random offset for variety\n  const randomOffset: [number, number, number] = [\n    (Math.random() - 0.5) * 0.1,\n    (Math.random() - 0.5) * 0.1,\n    (Math.random() - 0.5) * 0.1,\n  ];\n\n  const position: [number, number, number] = [\n    basePosition[0] + randomOffset[0],\n    basePosition[1] + randomOffset[1],\n    basePosition[2] + randomOffset[2],\n  ];\n\n  return {\n    id: `injury_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`,\n    region: bodyRegion,\n    type: injuryType,\n    position,\n    severity,\n    hitCount: 1,\n    timestamp: Date.now(),\n    playerId: targetPlayerIndex === 0 ? \"player\" : \"enemy\",\n  };\n}\n\n/**\n * Apply knockback displacement to defender position\n *\n * **Korean**: 밀침 적용 (Apply Knockback)\n *\n * Updates the defender's position based on knockback physics calculation.\n * The knockback displacement is applied in the direction of the attack vector\n * (attacker → defender), respecting arena boundaries.\n *\n * **Physics-First Architecture**: Both positions and knockback displacement\n * are in meters. Arena bounds are centered at origin (0, 0) with extent\n * ±worldWidthMeters/2 in X and ±worldDepthMeters/2 in Z.\n *\n * @param result - Combat result containing knockback data (in meters)\n * @param defenderPos - Current defender position (in meters)\n * @param arenaBounds - Arena boundary limits with meter dimensions\n * @returns Updated defender position after knockback (in meters)\n *\n * @example\n * ```typescript\n * // 10m × 7.5m arena, player at x=2m knocked back 2.5m to right\n * const newPosition = applyKnockbackDisplacement(\n *   result, // knockback.displacement.x = 2.5m\n *   { x: 2, y: 0 }, // Current position: 2m from center\n *   { worldWidthMeters: 10, worldDepthMeters: 7.5, ... }\n * );\n * // Returns: { x: 4.5, y: 0 } (2m + 2.5m = 4.5m, within ±5m boundary)\n *\n * // Same knockback but would exceed boundary\n * const clampedPosition = applyKnockbackDisplacement(\n *   result, // knockback.displacement.x = 2.5m\n *   { x: 4, y: 0 }, // Current position: 4m from center\n *   { worldWidthMeters: 10, worldDepthMeters: 7.5, ... }\n * );\n * // Returns: { x: 5, y: 0 } (4m + 2.5m = 6.5m, clamped to +5m boundary)\n * ```\n */\nfunction applyKnockbackDisplacement(\n  result: CombatResult,\n  defenderPos: Position,\n  arenaBounds: PhysicsArenaBounds,\n): Position {\n  if (!result.knockback) {\n    return defenderPos;\n  }\n\n  // Apply knockback displacement (both in meters)\n  // Note: knockback.displacement.z maps to position.y in 2D arena\n  const newPos = {\n    x: defenderPos.x + result.knockback.displacement.x,\n    y: defenderPos.y + result.knockback.displacement.z,\n  };\n\n  // Clamp to arena boundaries using shared physics helper\n  return clampToArenaBounds(newPos, arenaBounds);\n}\n\nexport interface UseCombatActionsConfig {\n  readonly validPlayers: readonly [PlayerState, PlayerState];\n  readonly playerPositions: readonly [Position, Position];\n  readonly combatState: CombatScreenState;\n  readonly combatActions: CombatActions;\n  readonly combatSystem: CombatSystem;\n  readonly onPlayerUpdate: (\n    playerIndex: number,\n    updates: Partial<PlayerState>,\n  ) => void;\n  readonly onPlayerPositionUpdate?: (\n    playerIndex: number,\n    position: Position,\n  ) => void;\n  readonly onLateralityUpdate?: (\n    playerIndex: number,\n    laterality: \"left\" | \"right\",\n  ) => void;\n  readonly onInjuryCreated?: (\n    injury: Injury,\n    targetPlayerIndex: number,\n  ) => void;\n  readonly addCombatMessage: (korean: string, english: string) => void;\n  readonly addHitEffect: (\n    type: HitEffectType,\n    position: Position,\n    intensity?: number,\n  ) => void;\n  readonly arenaBounds: PhysicsArenaBounds;\n  readonly combatAudio?: {\n    readonly playAttackSound: (intensity?: AttackIntensity) => Promise<void>;\n    readonly playHitSound: (damage: number) => Promise<void>;\n    readonly playBoneImpactSound: (options: {\n      region?: import(\"../../../../audio/types\").AudioBodyRegion;\n      intensity?: import(\"../../../../audio/types\").ImpactIntensity;\n      damage?: number;\n      remainingHealth?: number;\n      vitalPoint?: boolean;\n      hitPosition?: { x: number; y: number; z?: number };\n    }) => Promise<void>;\n    readonly playBlockSound: (guardBroken?: boolean) => Promise<void>;\n    readonly playDodgeSound: () => Promise<void>;\n    readonly playStanceChangeSound: () => Promise<void>;\n    readonly playSpecialTechniqueSound: () => Promise<void>;\n  };\n  readonly playerAnimations?: {\n    readonly player1: {\n      readonly transitionTo: (state: AnimationState) => boolean;\n    };\n    readonly player2: {\n      readonly transitionTo: (state: AnimationState) => boolean;\n    };\n  };\n}\n\nexport interface UseCombatActionsReturn {\n  readonly handleAttack: (technique?: Technique) => void;\n  readonly handleDefend: () => void;\n  readonly handleTechniqueExecute: () => void;\n  readonly handleStanceSwitch: (stance: TrigramStance) => void;\n  readonly handleStanceSideSwitch: (playerIndex: 0 | 1) => void;\n  readonly handleAIAttack: (\n    technique?: KoreanTechnique,\n    targetVitalPoint?: string,\n  ) => void;\n  readonly handleAIDefend: () => void;\n  readonly handleAITechnique: (\n    technique?: KoreanTechnique,\n    targetVitalPoint?: string,\n  ) => void;\n  readonly moveAIPlayer: (targetPos: Position) => void;\n}\n\n/**\n * Helper function to convert Technique to KoreanTechnique format\n * @param technique - The technique to convert\n * @param stance - Current player stance\n * @returns KoreanTechnique compatible with CombatSystem\n */\nfunction convertTechniqueToKorean(\n  technique: Technique,\n  stance: TrigramStance,\n): KoreanTechnique {\n  return {\n    id: technique.id,\n    name: {\n      korean: technique.name.korean,\n      english: technique.name.english,\n      romanized: technique.name.romanized ?? \"\",\n    },\n    koreanName: technique.name.korean,\n    englishName: technique.name.english,\n    romanized: technique.name.romanized ?? \"\",\n    description: {\n      korean: technique.description.korean,\n      english: technique.description.english,\n    },\n    stance: technique.requiredStance ?? stance,\n    type: \"attack\",\n    damageType: technique.damageType,\n    damage: (technique.damage.min + technique.damage.max) / 2, // Use average damage\n    kiCost: technique.kiCost,\n    staminaCost: technique.staminaCost,\n    accuracy: 0.85, // Default accuracy\n    reachConfig: {\n      bodyPart: \"arm\" as const,\n      techniqueType: \"punch\" as const,\n      baseExtension: 0.9,\n    },\n    executionTime: technique.animationDuration ?? 400,\n    recoveryTime: 300,\n    critChance: technique.criticalChance ?? 0.1,\n    critMultiplier: 1.5,\n    effects: [],\n  };\n}\n\n/**\n * Custom hook for combat action handlers\n */\nexport function useCombatActions(\n  config: UseCombatActionsConfig,\n): UseCombatActionsReturn {\n  const {\n    validPlayers,\n    playerPositions,\n    combatState,\n    combatActions,\n    combatSystem,\n    onPlayerUpdate,\n    onLateralityUpdate,\n    onInjuryCreated,\n    addCombatMessage,\n    addHitEffect,\n    arenaBounds,\n    combatAudio,\n  } = config;\n\n  // Refs to track knockback recovery timeouts for cleanup\n  const player1KnockbackTimeoutRef = useRef<NodeJS.Timeout | null>(null);\n  const player2KnockbackTimeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  // Cleanup timeouts on unmount\n  useEffect(() => {\n    return () => {\n      if (player1KnockbackTimeoutRef.current) {\n        clearTimeout(player1KnockbackTimeoutRef.current);\n      }\n      if (player2KnockbackTimeoutRef.current) {\n        clearTimeout(player2KnockbackTimeoutRef.current);\n      }\n    };\n  }, []);\n\n  // Player attack handler\n  const handleAttack = useCallback(\n    (technique?: Technique) => {\n      if (\n        combatState.isExecutingTechnique ||\n        !combatState.roundStarted ||\n        combatState.roundEnded\n      )\n        return;\n\n      const player = validPlayers[0];\n      const currentStance = player.currentStance;\n      const archetype = player.archetype;\n\n      // Use provided technique or select from stance techniques\n      let attackTechnique: KoreanTechnique;\n\n      if (technique) {\n        // Convert selected technique to KoreanTechnique format\n        attackTechnique = convertTechniqueToKorean(technique, currentStance);\n      } else {\n        // Get techniques for current stance and archetype\n        const availableTechniques =\n          KoreanTechniquesSystem.getAllAvailableTechniques(\n            currentStance,\n            archetype,\n          );\n\n        if (availableTechniques.length === 0) {\n          console.warn(\n            `No techniques found for stance: ${currentStance}, archetype: ${archetype}`,\n          );\n          addCombatMessage(\"기술 없음\", \"No techniques available\");\n          return;\n        }\n\n        // Select primary technique (first in list)\n        const selectedTechnique = availableTechniques[0];\n\n        // Check if player has sufficient resources\n        if (\n          !KoreanTechniquesSystem.canExecuteTechnique(player, selectedTechnique)\n        ) {\n          addCombatMessage(\"기력/체력 부족\", \"Insufficient Ki/Stamina\");\n          return;\n        }\n\n        attackTechnique = selectedTechnique;\n      }\n\n      combatActions.setExecutingTechnique(true);\n\n      // Play attack sound based on technique damage/intensity\n      const damage = attackTechnique.damage ?? 10;\n      const intensity: AttackIntensity =\n        damage >= 40\n          ? \"critical\"\n          : damage >= 25\n            ? \"heavy\"\n            : damage >= 10\n              ? \"medium\"\n              : \"light\";\n      combatAudio?.playAttackSound(intensity);\n\n      // Calculate animation timing context for hit detection.\n      // For synchronous hit detection, we use the animation's peak time (when limb\n      // is fully extended) rather than t=0 (attack start). This ensures the hit\n      // window check passes when the attack would visually connect.\n      // 동기식 타격 판정: 애니메이션 피크 타임 사용 (팔/다리 완전 신전 시점)\n      const animationType = attackTechnique.animationType ?? AnimationType.JAB;\n      const hitTiming = getAnimationHitTiming(animationType);\n      const peakTime = hitTiming?.hitWindow.peakTime ?? 0.15; // Default to typical punch peak\n      const animationContext = {\n        animationType,\n        currentTime: peakTime, // Use peak time for synchronous hit detection\n      };\n\n      // Use combat system for proper calculation with animation context\n      const result = combatSystem.resolveAttack(\n        validPlayers[0],\n        validPlayers[1],\n        attackTechnique,\n        undefined,\n        animationContext,\n      );\n\n      const effectType = result.hit\n        ? result.isCritical\n          ? HitEffectType.CRITICAL_HIT\n          : HitEffectType.HIT\n        : HitEffectType.MISS;\n\n      addHitEffect(effectType, playerPositions[0], result.hit ? 1 : 0.5);\n\n      if (result.hit) {\n        // Play bone impact sound with body region and damage context\n        const hitPosition = calculateHitPosition(playerPositions[1]);\n\n        // Use bone impact audio instead of generic hit sound\n        combatAudio?.playBoneImpactSound({\n          damage: result.damage,\n          remainingHealth: validPlayers[1].health - result.damage,\n          vitalPoint: result.isCritical, // Critical hits are often vital points\n          hitPosition,\n        });\n\n        // Combo tracking: reset combo if too much time passed\n        const now = Date.now();\n        const timeSinceLastHit = now - combatState.lastHitTime;\n        const newCombo =\n          timeSinceLastHit < 2000 ? combatState.comboCount + 1 : 1;\n        combatActions.setComboCount(newCombo);\n        combatActions.setLastHitTime(now);\n\n        // Apply damage through combat system\n        const { updatedAttacker, updatedDefender } =\n          combatSystem.applyCombatResult(\n            result,\n            validPlayers[0],\n            validPlayers[1],\n          );\n\n        onPlayerUpdate(0, updatedAttacker);\n        onPlayerUpdate(1, updatedDefender);\n\n        // Create injury for trauma visualization\n        if (onInjuryCreated) {\n          const injury = createInjuryFromDamage(\n            result,\n            attackTechnique,\n            updatedDefender.health,\n            1, // Player 2 (enemy) was hit\n          );\n          onInjuryCreated(injury, 1);\n        }\n\n        // Apply knockback displacement (밀침 적용)\n        if (result.knockback && config.onPlayerPositionUpdate) {\n          const newDefenderPosition = applyKnockbackDisplacement(\n            result,\n            playerPositions[1],\n            config.arenaBounds,\n          );\n          config.onPlayerPositionUpdate(1, newDefenderPosition);\n\n          // Add combat message for significant knockback\n          const knockbackDistance = Math.sqrt(\n            result.knockback.displacement.x ** 2 +\n              result.knockback.displacement.z ** 2,\n          );\n          if (knockbackDistance > 1.5) {\n            const knockbackName = KnockbackPhysics.getKnockbackStateName(\n              result.knockback.shouldFall,\n            );\n            addCombatMessage(knockbackName.korean, knockbackName.english);\n          }\n\n          // Set stunned state for knockback duration (non-interruptible)\n          if (result.knockback.duration > 0) {\n            // Clear any existing timeout for player 2\n            if (player2KnockbackTimeoutRef.current) {\n              clearTimeout(player2KnockbackTimeoutRef.current);\n            }\n\n            onPlayerUpdate(1, { isStunned: true });\n\n            // Schedule recovery after knockback duration + recovery window\n            player2KnockbackTimeoutRef.current = setTimeout(\n              () => {\n                onPlayerUpdate(1, { isStunned: false });\n                player2KnockbackTimeoutRef.current = null;\n              },\n              (result.knockback.duration + result.knockback.recoveryWindow) *\n                1000,\n            );\n          }\n        }\n\n        // Check if defender should fall after taking damage\n        if (config.playerAnimations?.player2) {\n          const fallCheck = checkForFall(\n            updatedDefender,\n            combatSystem,\n            undefined, // lastImpactAngle not tracked yet\n            undefined, // attackAngle not tracked yet\n          );\n\n          if (\n            fallCheck.shouldFall &&\n            fallCheck.animationState &&\n            fallCheck.fallType\n          ) {\n            config.playerAnimations.player2.transitionTo(\n              fallCheck.animationState,\n            );\n            const fallName = getFallTypeName(fallCheck.fallType);\n            addCombatMessage(`${fallName.korean}!`, `${fallName.english}!`);\n          }\n        }\n\n        // Display technique name in combat log\n        const techniqueNameKorean =\n          attackTechnique.koreanName ?? attackTechnique.name.korean;\n        const techniqueNameEnglish =\n          attackTechnique.englishName ?? attackTechnique.name.english;\n\n        if (result.isCritical) {\n          addCombatMessage(\n            `치명타! ${techniqueNameKorean}`,\n            `Critical Hit! ${techniqueNameEnglish}`,\n          );\n        } else if (newCombo > 2) {\n          addCombatMessage(\n            `${newCombo} 연속! ${techniqueNameKorean}`,\n            `${newCombo} Combo! ${techniqueNameEnglish}`,\n          );\n        } else {\n          addCombatMessage(\n            `${techniqueNameKorean} 성공!`,\n            `${techniqueNameEnglish} Hit!`,\n          );\n        }\n      } else {\n        combatActions.resetCombo();\n        const techniqueNameKorean =\n          attackTechnique.koreanName ?? attackTechnique.name.korean;\n        const techniqueNameEnglish =\n          attackTechnique.englishName ?? attackTechnique.name.english;\n        addCombatMessage(\n          `${techniqueNameKorean} 빗나감`,\n          `${techniqueNameEnglish} Missed`,\n        );\n      }\n\n      setTimeout(() => combatActions.setExecutingTechnique(false), 500);\n    },\n    [\n      validPlayers,\n      playerPositions,\n      combatState.isExecutingTechnique,\n      combatState.roundStarted,\n      combatState.roundEnded,\n      combatState.comboCount,\n      combatState.lastHitTime,\n      combatActions,\n      combatSystem,\n      onPlayerUpdate,\n      onInjuryCreated,\n      addCombatMessage,\n      addHitEffect,\n      combatAudio,\n      config,\n    ],\n  );\n\n  // Player defend handler\n  const handleDefend = useCallback(() => {\n    if (!combatState.roundStarted || combatState.roundEnded) return;\n\n    // Play block sound\n    combatAudio?.playBlockSound(false);\n\n    onPlayerUpdate(0, { isBlocking: true });\n    addCombatMessage(\"방어 자세\", \"Defensive Stance\");\n    addHitEffect(HitEffectType.BLOCK, playerPositions[0], 0.8);\n\n    setTimeout(() => {\n      onPlayerUpdate(0, { isBlocking: false });\n    }, 1000);\n  }, [\n    combatState.roundStarted,\n    combatState.roundEnded,\n    onPlayerUpdate,\n    addCombatMessage,\n    addHitEffect,\n    playerPositions,\n    combatAudio,\n  ]);\n\n  // Player technique handler\n  const handleTechniqueExecute = useCallback(() => {\n    if (\n      combatState.isExecutingTechnique ||\n      !combatState.roundStarted ||\n      combatState.roundEnded\n    )\n      return;\n    if (validPlayers[0].ki < 10 || validPlayers[0].stamina < 15) {\n      addCombatMessage(\"기력/체력 부족\", \"Insufficient Ki/Stamina\");\n      return;\n    }\n\n    combatActions.setExecutingTechnique(true);\n\n    // Play special technique sound\n    combatAudio?.playSpecialTechniqueSound();\n\n    addHitEffect(HitEffectType.CRITICAL_HIT, playerPositions[0], 1.5);\n\n    // Screen shake effect for impact\n    const shakeIntensity = 8;\n    const shakeFrames = [\n      { x: shakeIntensity, y: -shakeIntensity * 0.5 },\n      { x: -shakeIntensity * 0.7, y: shakeIntensity * 0.8 },\n      { x: shakeIntensity * 0.5, y: shakeIntensity * 0.3 },\n      { x: -shakeIntensity * 0.3, y: -shakeIntensity * 0.6 },\n      { x: 0, y: 0 },\n    ];\n\n    shakeFrames.forEach((shake, index) => {\n      setTimeout(() => combatActions.setScreenShake(shake), index * 50);\n    });\n\n    const distance = Math.sqrt(\n      Math.pow(playerPositions[0].x - playerPositions[1].x, 2) +\n        Math.pow(playerPositions[0].y - playerPositions[1].y, 2),\n    );\n\n    if (distance < 150) {\n      // Play bone impact sound for special technique hit\n      const hitPosition = calculateHitPosition(playerPositions[1]);\n\n      combatAudio?.playBoneImpactSound({\n        damage: 25,\n        remainingHealth: validPlayers[1].health - 25,\n        vitalPoint: false,\n        hitPosition,\n      });\n\n      onPlayerUpdate(1, {\n        health: Math.max(0, validPlayers[1].health - 25),\n        hitsTaken: validPlayers[1].hitsTaken + 1,\n      });\n      addCombatMessage(\"특수 기술 성공!\", \"Special Technique Hit!\");\n    } else {\n      addCombatMessage(\"기술 실패\", \"Technique Failed\");\n    }\n\n    // Consume resources\n    onPlayerUpdate(0, {\n      ki: Math.max(0, validPlayers[0].ki - 10),\n      stamina: Math.max(0, validPlayers[0].stamina - 15),\n    });\n\n    setTimeout(() => combatActions.setExecutingTechnique(false), 800);\n  }, [\n    validPlayers,\n    playerPositions,\n    combatState.isExecutingTechnique,\n    combatState.roundStarted,\n    combatState.roundEnded,\n    combatActions,\n    onPlayerUpdate,\n    addCombatMessage,\n    addHitEffect,\n    combatAudio,\n  ]);\n\n  // Player stance switch handler\n  const handleStanceSwitch = useCallback(\n    (stance: TrigramStance) => {\n      if (!combatState.roundStarted || combatState.roundEnded) return;\n\n      // Play stance change sound\n      combatAudio?.playStanceChangeSound();\n\n      onPlayerUpdate(0, { currentStance: stance });\n      addCombatMessage(`자세 변경: ${stance}`, `Stance Change: ${stance}`);\n      addHitEffect(HitEffectType.STATUS_EFFECT, playerPositions[0], 0.6);\n    },\n    [\n      combatState.roundStarted,\n      combatState.roundEnded,\n      onPlayerUpdate,\n      addCombatMessage,\n      addHitEffect,\n      playerPositions,\n      combatAudio,\n    ],\n  );\n\n  /**\n   * Handle stance side switch (left/right)\n   * @korean 자세측면전환처리\n   */\n  // Reuse StanceManager instance for stance side switches\n  const stanceManagerRef = useRef<StanceManager>(new StanceManager());\n\n  const handleStanceSideSwitch = useCallback(\n    (playerIndex: 0 | 1) => {\n      if (!combatState.roundStarted || combatState.roundEnded) return;\n\n      const player = validPlayers[playerIndex];\n      // Get current laterality from combat state\n      const currentLaterality = combatState.playerLaterality[playerIndex];\n\n      const result = stanceManagerRef.current.switchStanceSide(\n        player,\n        currentLaterality,\n      );\n\n      if (result.success && result.laterality) {\n        // Update player state with new stamina\n        onPlayerUpdate(playerIndex, result.updatedPlayer);\n\n        // Update laterality in combat state via callback\n        onLateralityUpdate?.(playerIndex, result.laterality);\n\n        // Audio feedback\n        combatAudio?.playStanceChangeSound?.();\n\n        // Visual feedback\n        const koreanText =\n          result.laterality === \"left\" ? \"왼발서기\" : \"오른발서기\";\n        const englishText =\n          result.laterality === \"left\" ? \"Left Stance\" : \"Right Stance\";\n        addCombatMessage(koreanText, englishText);\n\n        // Visual effect\n        addHitEffect(\n          HitEffectType.STATUS_EFFECT,\n          playerPositions[playerIndex],\n          0.5,\n        );\n      } else {\n        // Feedback for failed switch\n        if (result.message?.includes(\"stamina\")) {\n          addCombatMessage(\"체력 부족\", \"Insufficient Stamina\");\n        } else if (result.message?.includes(\"cooldown\")) {\n          addCombatMessage(\"대기 중\", \"On Cooldown\");\n        }\n      }\n    },\n    [\n      combatState.roundStarted,\n      combatState.roundEnded,\n      combatState.playerLaterality,\n      validPlayers,\n      onPlayerUpdate,\n      onLateralityUpdate,\n      combatAudio,\n      addCombatMessage,\n      addHitEffect,\n      playerPositions,\n    ],\n  );\n\n  /**\n   * Helper function to create AI technique objects\n   * Reduces code duplication between basic attacks and special techniques\n   */\n  const createAITechnique = useCallback(\n    (type: \"basic\" | \"special\", aiPlayer: PlayerState) => {\n      if (type === \"basic\") {\n        return {\n          id: \"ai_basic_attack\",\n          name: {\n            korean: \"AI 기본공격\",\n            english: \"AI Basic Attack\",\n            romanized: \"ai_gibon_gonggyeok\",\n          },\n          koreanName: \"AI 기본공격\",\n          englishName: \"AI Basic Attack\",\n          romanized: \"ai_gibon_gonggyeok\",\n          description: { korean: \"AI 기본 공격\", english: \"AI basic attack\" },\n          stance: aiPlayer.currentStance,\n          type: \"attack\" as const,\n          damageType: \"physical\" as const,\n          damage: 15,\n          kiCost: 5,\n          staminaCost: 8,\n          accuracy: 0.8,\n          reachConfig: {\n            bodyPart: \"arm\" as const,\n            techniqueType: \"punch\" as const,\n            baseExtension: 0.95,\n          },\n          executionTime: 400,\n          recoveryTime: 300,\n          critChance: 0.1,\n          critMultiplier: 1.5,\n          effects: [],\n          animationType: AnimationType.JAB, // Default animation for basic attack\n        };\n      } else {\n        return {\n          id: \"ai_special_technique\",\n          name: {\n            korean: \"AI 특수기술\",\n            english: \"AI Special Technique\",\n            romanized: \"ai_teuksu_gisul\",\n          },\n          koreanName: \"AI 특수기술\",\n          englishName: \"AI Special Technique\",\n          romanized: \"ai_teuksu_gisul\",\n          description: {\n            korean: \"AI 특수 기술\",\n            english: \"AI special technique\",\n          },\n          stance: aiPlayer.currentStance,\n          type: \"technique\" as const,\n          damageType: \"physical\" as const,\n          damage: 25,\n          kiCost: 10,\n          staminaCost: 15,\n          accuracy: 0.85,\n          reachConfig: {\n            bodyPart: \"leg\" as const,\n            techniqueType: \"kick\" as const,\n            baseExtension: 1.1,\n          },\n          executionTime: 600,\n          recoveryTime: 800,\n          critChance: 0.15,\n          critMultiplier: 1.8,\n          effects: [],\n          animationType: AnimationType.SPINNING_HOOK, // Default animation for special technique\n        };\n      }\n    },\n    [],\n  );\n\n  /**\n   * Helper function to determine hit effect type based on combat result\n   * Reduces duplication between attack and technique handlers\n   */\n  const getHitEffectType = useCallback(\n    (result: { hit: boolean; isCritical?: boolean }): HitEffectType => {\n      if (!result.hit) return HitEffectType.MISS;\n      return result.isCritical ? HitEffectType.CRITICAL_HIT : HitEffectType.HIT;\n    },\n    [],\n  );\n\n  /**\n   * AI attack handler with technique and vital point targeting\n   *\n   * @param technique - Optional Korean martial arts technique to execute. If not provided, creates a basic attack.\n   * @param targetVitalPoint - Optional vital point ID to target for increased damage effectiveness.\n   */\n  const handleAIAttack = useCallback(\n    (technique?: KoreanTechnique, targetVitalPoint?: string) => {\n      const aiPlayer = validPlayers[1];\n      const targetPlayer = validPlayers[0];\n\n      // Use provided technique or create basic attack technique\n      const attackTechnique = technique ?? createAITechnique(\"basic\", aiPlayer);\n\n      // Play attack sound based on technique damage/intensity (consistent with player)\n      const damage = attackTechnique.damage ?? 10;\n      const intensity: AttackIntensity =\n        damage >= 40\n          ? \"critical\"\n          : damage >= 25\n            ? \"heavy\"\n            : damage >= 10\n              ? \"medium\"\n              : \"light\";\n      combatAudio?.playAttackSound(intensity);\n\n      // Calculate animation timing context for AI hit detection (same as player)\n      // 동기식 타격 판정: AI도 피크 타임 사용\n      const animationType = attackTechnique.animationType ?? AnimationType.JAB;\n      const hitTiming = getAnimationHitTiming(animationType);\n      const peakTime = hitTiming?.hitWindow.peakTime ?? 0.15;\n      const animationContext = {\n        animationType,\n        currentTime: peakTime,\n      };\n\n      // Use combat system for proper calculation with vital point targeting and animation context\n      const result = combatSystem.resolveAttack(\n        aiPlayer,\n        targetPlayer,\n        attackTechnique,\n        targetVitalPoint, // Pass vital point ID for targeting\n        animationContext, // Pass animation context for distance/reach check\n      );\n\n      const effectType = getHitEffectType(result);\n      addHitEffect(effectType, playerPositions[1], result.hit ? 1 : 0.5);\n\n      if (result.hit) {\n        // Play bone impact sound for AI hits on player\n        const hitPosition = calculateHitPosition(playerPositions[0]);\n\n        combatAudio?.playBoneImpactSound({\n          damage: result.damage,\n          remainingHealth: validPlayers[0].health - result.damage,\n          vitalPoint: result.isCritical,\n          hitPosition,\n        });\n\n        // Apply damage through combat system (deducts resources)\n        const { updatedAttacker, updatedDefender } =\n          combatSystem.applyCombatResult(result, aiPlayer, targetPlayer);\n\n        onPlayerUpdate(1, updatedAttacker);\n        onPlayerUpdate(0, updatedDefender);\n\n        // Create injury for trauma visualization (AI hit player)\n        if (onInjuryCreated) {\n          const injury = createInjuryFromDamage(\n            result,\n            attackTechnique,\n            updatedDefender.health,\n            0, // Player 1 (player) was hit by AI\n          );\n          onInjuryCreated(injury, 0);\n        }\n\n        // Apply knockback displacement for AI attacks (밀침 적용)\n        if (result.knockback && config.onPlayerPositionUpdate) {\n          const newDefenderPosition = applyKnockbackDisplacement(\n            result,\n            playerPositions[0],\n            config.arenaBounds,\n          );\n          config.onPlayerPositionUpdate(0, newDefenderPosition);\n\n          // Add combat message for significant knockback\n          const knockbackDistance = Math.sqrt(\n            result.knockback.displacement.x ** 2 +\n              result.knockback.displacement.z ** 2,\n          );\n          if (knockbackDistance > 1.5) {\n            const knockbackName = KnockbackPhysics.getKnockbackStateName(\n              result.knockback.shouldFall,\n            );\n            addCombatMessage(\n              `AI ${knockbackName.korean}`,\n              `AI ${knockbackName.english}`,\n            );\n          }\n\n          // Set stunned state for knockback duration (non-interruptible)\n          if (result.knockback.duration > 0) {\n            // Clear any existing timeout for player 1\n            if (player1KnockbackTimeoutRef.current) {\n              clearTimeout(player1KnockbackTimeoutRef.current);\n            }\n\n            onPlayerUpdate(0, { isStunned: true });\n\n            // Schedule recovery after knockback duration + recovery window\n            player1KnockbackTimeoutRef.current = setTimeout(\n              () => {\n                onPlayerUpdate(0, { isStunned: false });\n                player1KnockbackTimeoutRef.current = null;\n              },\n              (result.knockback.duration + result.knockback.recoveryWindow) *\n                1000,\n            );\n          }\n        }\n\n        // Check if player should fall after taking damage from AI\n        if (config.playerAnimations?.player1) {\n          const fallCheck = checkForFall(\n            updatedDefender,\n            combatSystem,\n            undefined, // lastImpactAngle not tracked yet\n            undefined, // attackAngle not tracked yet\n          );\n\n          if (\n            fallCheck.shouldFall &&\n            fallCheck.animationState &&\n            fallCheck.fallType\n          ) {\n            config.playerAnimations.player1.transitionTo(\n              fallCheck.animationState,\n            );\n            const fallName = getFallTypeName(fallCheck.fallType);\n            addCombatMessage(`${fallName.korean}!`, `${fallName.english}!`);\n          }\n        }\n\n        // Enhanced combat message with vital point info\n        if (result.vitalPointHit && targetVitalPoint) {\n          const vitalPoint = getVitalPointById(targetVitalPoint);\n          const vpName = vitalPoint\n            ? vitalPoint.names.korean\n            : targetVitalPoint;\n          addCombatMessage(\n            `AI 급소 타격! ${vpName}`,\n            `AI Vital Point Hit! ${\n              vitalPoint?.names.english ?? targetVitalPoint\n            }`,\n          );\n        } else if (result.isCritical) {\n          addCombatMessage(\"AI 치명타!\", \"AI Critical Hit!\");\n        } else {\n          addCombatMessage(\"AI 공격 성공!\", \"AI Attack Hit!\");\n        }\n      } else {\n        // Consume resources on miss for consistency with technique behavior\n        onPlayerUpdate(1, {\n          ki: Math.max(0, aiPlayer.ki - attackTechnique.kiCost),\n          stamina: Math.max(0, aiPlayer.stamina - attackTechnique.staminaCost),\n        });\n        addCombatMessage(\"AI 공격 빗나감\", \"AI Attack Missed\");\n      }\n    },\n    [\n      validPlayers,\n      playerPositions,\n      combatSystem,\n      onPlayerUpdate,\n      onInjuryCreated,\n      addCombatMessage,\n      addHitEffect,\n      combatAudio,\n      createAITechnique,\n      getHitEffectType,\n      config,\n    ],\n  );\n\n  // AI defend handler\n  const handleAIDefend = useCallback(() => {\n    // Play block sound\n    combatAudio?.playBlockSound(false);\n\n    onPlayerUpdate(1, { isBlocking: true });\n    addCombatMessage(\"AI 방어 자세\", \"AI Defensive Stance\");\n    addHitEffect(HitEffectType.BLOCK, playerPositions[1], 0.8);\n\n    setTimeout(() => {\n      onPlayerUpdate(1, { isBlocking: false });\n    }, 1000);\n  }, [\n    onPlayerUpdate,\n    addCombatMessage,\n    addHitEffect,\n    playerPositions,\n    combatAudio,\n  ]);\n\n  /**\n   * AI technique handler with technique and vital point targeting\n   *\n   * @param technique - Optional special Korean martial arts technique to execute. If not provided, creates a special technique.\n   * @param targetVitalPoint - Optional vital point ID to target for increased damage effectiveness.\n   */\n  const handleAITechnique = useCallback(\n    (technique?: KoreanTechnique, targetVitalPoint?: string) => {\n      const aiPlayer = validPlayers[1];\n      const targetPlayer = validPlayers[0];\n\n      // Use provided technique or create special technique\n      const specialTechnique =\n        technique ?? createAITechnique(\"special\", aiPlayer);\n\n      // Check if AI has sufficient resources for the technique\n      if (\n        aiPlayer.ki < specialTechnique.kiCost ||\n        aiPlayer.stamina < specialTechnique.staminaCost\n      ) {\n        handleAIAttack(undefined, targetVitalPoint); // Fallback to basic attack with same targeting\n        return;\n      }\n\n      // Play special technique sound\n      combatAudio?.playSpecialTechniqueSound();\n\n      // Calculate animation timing context for AI technique hit detection\n      // 동기식 타격 판정: AI 특수 기술도 피크 타임 사용\n      const animationType =\n        specialTechnique.animationType ?? AnimationType.SPINNING_HOOK;\n      const hitTiming = getAnimationHitTiming(animationType);\n      const peakTime = hitTiming?.hitWindow.peakTime ?? 0.25; // Special techniques often have longer peak times\n      const animationContext = {\n        animationType,\n        currentTime: peakTime,\n      };\n\n      // Use combat system for proper calculation with vital point targeting and animation context\n      const result = combatSystem.resolveAttack(\n        aiPlayer,\n        targetPlayer,\n        specialTechnique,\n        targetVitalPoint, // Pass vital point ID for targeting\n        animationContext, // Pass animation context for distance/reach check\n      );\n\n      const effectType = result.hit\n        ? HitEffectType.CRITICAL_HIT\n        : HitEffectType.MISS;\n\n      addHitEffect(effectType, playerPositions[1], result.hit ? 1.5 : 0.5);\n\n      if (result.hit) {\n        // Play bone impact sound for AI technique hits\n        const hitPosition = calculateHitPosition(playerPositions[0]);\n\n        combatAudio?.playBoneImpactSound({\n          damage: result.damage,\n          remainingHealth: validPlayers[0].health - result.damage,\n          vitalPoint: result.isCritical === true || !!targetVitalPoint, // Special techniques often target vital points\n          hitPosition,\n        });\n\n        // Apply damage through combat system (deducts resources)\n        const { updatedAttacker, updatedDefender } =\n          combatSystem.applyCombatResult(result, aiPlayer, targetPlayer);\n\n        onPlayerUpdate(1, updatedAttacker);\n        onPlayerUpdate(0, updatedDefender);\n\n        // Create injury for trauma visualization (AI technique hit player)\n        if (onInjuryCreated) {\n          const injury = createInjuryFromDamage(\n            result,\n            specialTechnique,\n            updatedDefender.health,\n            0, // Player 1 (player) was hit by AI technique\n          );\n          onInjuryCreated(injury, 0);\n        }\n\n        // Apply knockback displacement for AI special techniques (밀침 적용)\n        if (result.knockback && config.onPlayerPositionUpdate) {\n          const newDefenderPosition = applyKnockbackDisplacement(\n            result,\n            playerPositions[0],\n            config.arenaBounds,\n          );\n          config.onPlayerPositionUpdate(0, newDefenderPosition);\n\n          // Add combat message for significant knockback\n          const knockbackDistance = Math.sqrt(\n            result.knockback.displacement.x ** 2 +\n              result.knockback.displacement.z ** 2,\n          );\n          if (knockbackDistance > 1.5) {\n            const knockbackName = KnockbackPhysics.getKnockbackStateName(\n              result.knockback.shouldFall,\n            );\n            addCombatMessage(\n              `AI 특수 ${knockbackName.korean}`,\n              `AI Special ${knockbackName.english}`,\n            );\n          }\n\n          // Set stunned state for knockback duration (non-interruptible)\n          if (result.knockback.duration > 0) {\n            // Clear any existing timeout for player 1\n            if (player1KnockbackTimeoutRef.current) {\n              clearTimeout(player1KnockbackTimeoutRef.current);\n            }\n\n            onPlayerUpdate(0, { isStunned: true });\n\n            // Schedule recovery after knockback duration + recovery window\n            player1KnockbackTimeoutRef.current = setTimeout(\n              () => {\n                onPlayerUpdate(0, { isStunned: false });\n                player1KnockbackTimeoutRef.current = null;\n              },\n              (result.knockback.duration + result.knockback.recoveryWindow) *\n                1000,\n            );\n          }\n        }\n\n        // Check if player should fall after taking damage from AI technique\n        if (config.playerAnimations?.player1) {\n          const fallCheck = checkForFall(\n            updatedDefender,\n            combatSystem,\n            undefined, // lastImpactAngle not tracked yet\n            undefined, // attackAngle not tracked yet\n          );\n\n          if (\n            fallCheck.shouldFall &&\n            fallCheck.animationState &&\n            fallCheck.fallType\n          ) {\n            config.playerAnimations.player1.transitionTo(\n              fallCheck.animationState,\n            );\n            const fallName = getFallTypeName(fallCheck.fallType);\n            addCombatMessage(`${fallName.korean}!`, `${fallName.english}!`);\n          }\n        }\n\n        // Enhanced combat message with vital point info\n        if (result.vitalPointHit && targetVitalPoint) {\n          const vitalPoint = getVitalPointById(targetVitalPoint);\n          const vpName = vitalPoint\n            ? vitalPoint.names.korean\n            : targetVitalPoint;\n          addCombatMessage(\n            `AI 특수 급소 기술! ${vpName}`,\n            `AI Special Vital Point Technique! ${\n              vitalPoint?.names.english ?? targetVitalPoint\n            }`,\n          );\n        } else {\n          addCombatMessage(\"AI 특수 기술!\", \"AI Special Technique!\");\n        }\n      } else {\n        // Consume resources on miss (technique was attempted)\n        onPlayerUpdate(1, {\n          ki: Math.max(0, aiPlayer.ki - specialTechnique.kiCost),\n          stamina: Math.max(0, aiPlayer.stamina - specialTechnique.staminaCost),\n        });\n        addCombatMessage(\"AI 기술 빗나감\", \"AI Technique Missed\");\n      }\n    },\n    [\n      validPlayers,\n      playerPositions,\n      combatSystem,\n      onPlayerUpdate,\n      onInjuryCreated,\n      addCombatMessage,\n      addHitEffect,\n      handleAIAttack,\n      combatAudio,\n      createAITechnique,\n      config,\n    ],\n  );\n\n  // AI movement handler with injury-based movement penalties\n  // **UPDATED**: Now scale-aware for consistent movement and distance calculations\n  // **FIX**: Positions are in METERS, not pixels - use meters-based speed\n  const moveAIPlayer = useCallback(\n    (targetPos: Position) => {\n      const currentPos = playerPositions[1];\n      const aiPlayer = validPlayers[1];\n\n      // Movement speed calibrated for physics-first system (all in METERS)\n      // Combat closing speed: ~2.5 m/s (fast tactical approach, not slow walking)\n      // Real fights are over in 4-5 seconds - AI must close distance quickly\n      // AI decision loop frequency (defined in useAICombat.ts)\n      const AI_DECISION_FREQUENCY_HZ = 20; // 20 calls/second (50ms interval)\n      // Calculation: 2.5 m/s / 20 calls/s = 0.125 meters per call\n      const baseSpeed = 2.5 / AI_DECISION_FREQUENCY_HZ; // meters per call (0.125m per call)\n\n      // Calculate movement direction vector (in meters)\n      const dx = targetPos.x - currentPos.x;\n      const dy = targetPos.y - currentPos.y;\n      const distance = Math.sqrt(dx * dx + dy * dy);\n\n      // Apply movement penalties from leg injuries if body part health exists\n      let finalSpeed = baseSpeed;\n      if (aiPlayer.bodyPartHealth && aiPlayer.bodyPartMaxHealth) {\n        // Normalize movement direction\n        const movementDirection = {\n          x: distance > 0 ? dx / distance : 0,\n          y: distance > 0 ? dy / distance : 0,\n        };\n\n        // Calculate modified speed with all penalties applied\n        finalSpeed = movementPenaltySystem.calculateModifiedSpeed(\n          baseSpeed,\n          aiPlayer.bodyPartHealth,\n          aiPlayer.bodyPartMaxHealth,\n          movementDirection,\n        );\n      }\n\n      // Physics-first: positions are in METERS, so distance is in meters\n      // Stop moving when within 0.05 meters (5cm) of target - close enough for melee range\n      const MIN_MOVEMENT_THRESHOLD_METERS = 0.05;\n\n      if (distance > MIN_MOVEMENT_THRESHOLD_METERS) {\n        const newPos = {\n          x: currentPos.x + (dx / distance) * finalSpeed,\n          y: currentPos.y + (dy / distance) * finalSpeed,\n        };\n\n        // Keep AI within arena bounds (positions in meters, centered at origin)\n        const halfWidth = arenaBounds.worldWidthMeters / 2;\n        const halfDepth = arenaBounds.worldDepthMeters / 2;\n        newPos.x = Math.max(-halfWidth, Math.min(halfWidth, newPos.x));\n        newPos.y = Math.max(-halfDepth, Math.min(halfDepth, newPos.y));\n\n        // Update position through parent - this should trigger playerPositions state update in parent\n        onPlayerUpdate(1, { position: newPos });\n      }\n    },\n    [playerPositions, validPlayers, arenaBounds, onPlayerUpdate],\n  );\n\n  return {\n    handleAttack,\n    handleDefend,\n    handleTechniqueExecute,\n    handleStanceSwitch,\n    handleStanceSideSwitch,\n    handleAIAttack,\n    handleAIDefend,\n    handleAITechnique,\n    moveAIPlayer,\n  };\n}\n"],"mappings":"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"}

package/lib/components/screens/combat/hooks/useCombatAttackMovement.d.ts

@@ -0,0 +1,85 @@
+/**
+ * useCombatAttackMovement Hook - Track Attack Movement for Combat Characters
+ *
+ * Custom hook for managing attack movement physics during combat animations.
+ * Supports two fighters with simultaneous attack movements and arena bounds.
+ *
+ * @korean 전투공격이동훅 - 전투 공격 이동 추적
+ */
+import { AnimationType } from "../../../../systems/animation";
+import { TrigramStance } from "../../../../types/common";
+/**
+ * Configuration for combat attack movement
+ */
+export interface CombatAttackMovementConfig {
+    /** Whether player 1 is currently attacking */
+    readonly player1Attacking: boolean;
+    /** Player 1 animation type */
+    readonly player1AnimationType?: AnimationType;
+    /** Player 1 current stance */
+    readonly player1Stance: TrigramStance;
+    /** Player 1 base position */
+    readonly player1BasePosition: [number, number, number];
+    /** Player 1 animation duration in seconds (default: 0.4) */
+    readonly player1AnimationDuration?: number;
+    /** Whether player 2 is currently attacking */
+    readonly player2Attacking: boolean;
+    /** Player 2 animation type */
+    readonly player2AnimationType?: AnimationType;
+    /** Player 2 current stance */
+    readonly player2Stance: TrigramStance;
+    /** Player 2 base position */
+    readonly player2BasePosition: [number, number, number];
+    /** Player 2 animation duration in seconds (default: 0.4) */
+    readonly player2AnimationDuration?: number;
+    /** Default animation duration in seconds for both players if individual values not specified (default: 0.4) */
+    readonly animationDuration?: number;
+}
+/**
+ * Return value from useCombatAttackMovement hook
+ */
+export interface CombatAttackMovementResult {
+    /** Player 1 current position including attack movement */
+    readonly player1Position: [number, number, number];
+    /** Player 2 current position including attack movement */
+    readonly player2Position: [number, number, number];
+    /** Whether player 1 is in forward lunge phase */
+    readonly player1IsLunging: boolean;
+    /** Whether player 2 is in forward lunge phase */
+    readonly player2IsLunging: boolean;
+}
+/**
+ * useCombatAttackMovement hook
+ *
+ * Tracks attack movement physics for both fighters in combat.
+ * Automatically handles lunge and recovery phases with smooth easing.
+ * Calculates attack direction between fighters dynamically.
+ *
+ * @param config - Combat attack movement configuration
+ * @returns Current positions and movement states for both fighters
+ *
+ * @example
+ * ```typescript
+ * const {
+ *   player1Position,
+ *   player2Position,
+ *   player1IsLunging
+ * } = useCombatAttackMovement({
+ *   player1Attacking: isPlayer1Attacking,
+ *   player1AnimationType: AnimationType.ROUNDHOUSE_KICK,
+ *   player1Stance: player1.stance,
+ *   player1BasePosition: [5, 0, 0],
+ *   player2Attacking: false,
+ *   player2AnimationType: undefined,
+ *   player2Stance: player2.stance,
+ *   player2BasePosition: [-5, 0, 0],
+ * });
+ *
+ * <Player3D position={player1Position} />
+ * <Player3D position={player2Position} />
+ * ```
+ *
+ * @korean 전투공격이동사용
+ */
+export declare function useCombatAttackMovement(config: CombatAttackMovementConfig): CombatAttackMovementResult;
+//# sourceMappingURL=useCombatAttackMovement.d.ts.map

package/lib/components/screens/combat/hooks/useCombatAttackMovement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatAttackMovement.d.ts","sourceRoot":"","sources":["../../../../../src/components/screens/combat/hooks/useCombatAttackMovement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAsB/C;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IAC9C,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,4DAA4D;IAC5D,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAE3C,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IAC9C,8BAA8B;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,4DAA4D;IAC5D,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAE3C,+GAA+G;IAC/G,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,0BAA0B,GACjC,0BAA0B,CA6P5B"}

package/lib/components/screens/combat/hooks/useCombatAttackMovement.js

@@ -0,0 +1,202 @@
+import AttackMovementPhysics from "../../../../systems/physics/AttackMovementPhysics.js";
+import "../../../../systems/physics/index.js";
+import { useEffect, useRef, useState } from "react";
+import * as THREE from "three";
+//#region src/components/screens/combat/hooks/useCombatAttackMovement.ts
+/**
+* useCombatAttackMovement Hook - Track Attack Movement for Combat Characters
+*
+* Custom hook for managing attack movement physics during combat animations.
+* Supports two fighters with simultaneous attack movements and arena bounds.
+*
+* @korean 전투공격이동훅 - 전투 공격 이동 추적
+*/
+/**
+* Calculate attack direction from attacker to defender
+* 공격자에서 방어자로의 공격 방향 계산
+*
+* @param attackerPos - Attacker position
+* @param defenderPos - Defender position
+* @returns Normalized direction vector
+*/
+function calculateAttackDirection(attackerPos, defenderPos) {
+	return new THREE.Vector3(defenderPos[0] - attackerPos[0], 0, defenderPos[2] - attackerPos[2]).normalize();
+}
+/**
+* useCombatAttackMovement hook
+*
+* Tracks attack movement physics for both fighters in combat.
+* Automatically handles lunge and recovery phases with smooth easing.
+* Calculates attack direction between fighters dynamically.
+*
+* @param config - Combat attack movement configuration
+* @returns Current positions and movement states for both fighters
+*
+* @example
+* ```typescript
+* const {
+*   player1Position,
+*   player2Position,
+*   player1IsLunging
+* } = useCombatAttackMovement({
+*   player1Attacking: isPlayer1Attacking,
+*   player1AnimationType: AnimationType.ROUNDHOUSE_KICK,
+*   player1Stance: player1.stance,
+*   player1BasePosition: [5, 0, 0],
+*   player2Attacking: false,
+*   player2AnimationType: undefined,
+*   player2Stance: player2.stance,
+*   player2BasePosition: [-5, 0, 0],
+* });
+*
+* <Player3D position={player1Position} />
+* <Player3D position={player2Position} />
+* ```
+*
+* @korean 전투공격이동사용
+*/
+function useCombatAttackMovement(config) {
+	const { player1Attacking, player1AnimationType, player1Stance, player1BasePosition, player1AnimationDuration, player2Attacking, player2AnimationType, player2Stance, player2BasePosition, player2AnimationDuration, animationDuration = .4 } = config;
+	const p1Duration = player1AnimationDuration ?? animationDuration;
+	const p2Duration = player2AnimationDuration ?? animationDuration;
+	const player1PhysicsRef = useRef(new AttackMovementPhysics());
+	const player2PhysicsRef = useRef(new AttackMovementPhysics());
+	const player1BasePosVectorRef = useRef(new THREE.Vector3());
+	const player2BasePosVectorRef = useRef(new THREE.Vector3());
+	const player1AttackStartTimeRef = useRef(null);
+	const player1MovementResultRef = useRef(null);
+	const player2AttackStartTimeRef = useRef(null);
+	const player2MovementResultRef = useRef(null);
+	const [player1Position, setPlayer1Position] = useState(player1BasePosition);
+	const [player2Position, setPlayer2Position] = useState(player2BasePosition);
+	const [player1IsLunging, setPlayer1IsLunging] = useState(false);
+	const [player2IsLunging, setPlayer2IsLunging] = useState(false);
+	const player1WasAttackingRef = useRef(false);
+	const player2WasAttackingRef = useRef(false);
+	useEffect(() => {
+		const wasAttacking = player1WasAttackingRef.current;
+		player1WasAttackingRef.current = player1Attacking;
+		if (player1Attacking && player1AnimationType && !wasAttacking) {
+			player1AttackStartTimeRef.current = Date.now();
+			const direction = calculateAttackDirection(player1BasePosition, player2BasePosition);
+			player1MovementResultRef.current = player1PhysicsRef.current.calculateAttackMovement({
+				animationType: player1AnimationType,
+				currentStance: player1Stance,
+				direction,
+				animationDuration: p1Duration
+			});
+			setPlayer1IsLunging(true);
+			let animationFrameId;
+			const updatePosition = () => {
+				const elapsed = Date.now() - (player1AttackStartTimeRef.current ?? 0);
+				const movementResult = player1MovementResultRef.current;
+				if (!movementResult) {
+					setPlayer1Position(player1BasePosition);
+					return;
+				}
+				if (elapsed >= movementResult.totalDuration * 1e3) {
+					setPlayer1Position(player1BasePosition);
+					setPlayer1IsLunging(false);
+					player1AttackStartTimeRef.current = null;
+					player1MovementResultRef.current = null;
+					return;
+				}
+				const elapsedSeconds = elapsed / 1e3;
+				const basePos = player1BasePosVectorRef.current.set(...player1BasePosition);
+				const recovering = elapsed >= movementResult.lungeDuration * 1e3;
+				const newPos = player1PhysicsRef.current.applyAttackMovement(basePos, movementResult, elapsedSeconds, recovering);
+				setPlayer1Position([
+					newPos.x,
+					newPos.y,
+					newPos.z
+				]);
+				setPlayer1IsLunging(elapsedSeconds / movementResult.totalDuration < .5);
+				animationFrameId = requestAnimationFrame(updatePosition);
+			};
+			animationFrameId = requestAnimationFrame(updatePosition);
+			return () => {
+				if (animationFrameId) cancelAnimationFrame(animationFrameId);
+			};
+		} else {
+			setPlayer1Position(player1BasePosition);
+			setPlayer1IsLunging(false);
+			player1AttackStartTimeRef.current = null;
+			player1MovementResultRef.current = null;
+		}
+	}, [
+		player1Attacking,
+		player1AnimationType,
+		player1Stance,
+		player1BasePosition,
+		player2BasePosition,
+		p1Duration
+	]);
+	useEffect(() => {
+		const wasAttacking = player2WasAttackingRef.current;
+		player2WasAttackingRef.current = player2Attacking;
+		if (player2Attacking && player2AnimationType && !wasAttacking) {
+			player2AttackStartTimeRef.current = Date.now();
+			const direction = calculateAttackDirection(player2BasePosition, player1BasePosition);
+			player2MovementResultRef.current = player2PhysicsRef.current.calculateAttackMovement({
+				animationType: player2AnimationType,
+				currentStance: player2Stance,
+				direction,
+				animationDuration: p2Duration
+			});
+			setPlayer2IsLunging(true);
+			let animationFrameId;
+			const updatePosition = () => {
+				const elapsed = Date.now() - (player2AttackStartTimeRef.current ?? 0);
+				const movementResult = player2MovementResultRef.current;
+				if (!movementResult) {
+					setPlayer2Position(player2BasePosition);
+					return;
+				}
+				if (elapsed >= movementResult.totalDuration * 1e3) {
+					setPlayer2Position(player2BasePosition);
+					setPlayer2IsLunging(false);
+					player2AttackStartTimeRef.current = null;
+					player2MovementResultRef.current = null;
+					return;
+				}
+				const elapsedSeconds = elapsed / 1e3;
+				const basePos = player2BasePosVectorRef.current.set(...player2BasePosition);
+				const recovering = elapsed >= movementResult.lungeDuration * 1e3;
+				const newPos = player2PhysicsRef.current.applyAttackMovement(basePos, movementResult, elapsedSeconds, recovering);
+				setPlayer2Position([
+					newPos.x,
+					newPos.y,
+					newPos.z
+				]);
+				setPlayer2IsLunging(elapsedSeconds / movementResult.totalDuration < .5);
+				animationFrameId = requestAnimationFrame(updatePosition);
+			};
+			animationFrameId = requestAnimationFrame(updatePosition);
+			return () => {
+				if (animationFrameId) cancelAnimationFrame(animationFrameId);
+			};
+		} else {
+			setPlayer2Position(player2BasePosition);
+			setPlayer2IsLunging(false);
+			player2AttackStartTimeRef.current = null;
+			player2MovementResultRef.current = null;
+		}
+	}, [
+		player2Attacking,
+		player2AnimationType,
+		player2Stance,
+		player1BasePosition,
+		player2BasePosition,
+		p2Duration
+	]);
+	return {
+		player1Position,
+		player2Position,
+		player1IsLunging,
+		player2IsLunging
+	};
+}
+//#endregion
+export { useCombatAttackMovement };
+
+//# sourceMappingURL=useCombatAttackMovement.js.map

package/lib/components/screens/combat/hooks/useCombatAttackMovement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatAttackMovement.js","names":[],"sources":["../../../../../src/components/screens/combat/hooks/useCombatAttackMovement.ts"],"sourcesContent":["/**\n * useCombatAttackMovement Hook - Track Attack Movement for Combat Characters\n *\n * Custom hook for managing attack movement physics during combat animations.\n * Supports two fighters with simultaneous attack movements and arena bounds.\n *\n * @korean 전투공격이동훅 - 전투 공격 이동 추적\n */\n\nimport { useEffect, useRef, useState } from \"react\";\nimport * as THREE from \"three\";\nimport { AnimationType } from \"@/systems/animation\";\nimport { AttackMovementPhysics } from \"@/systems/physics\";\nimport { TrigramStance } from \"@/types/common\";\n\n/**\n * Calculate attack direction from attacker to defender\n * 공격자에서 방어자로의 공격 방향 계산\n *\n * @param attackerPos - Attacker position\n * @param defenderPos - Defender position\n * @returns Normalized direction vector\n */\nfunction calculateAttackDirection(\n  attackerPos: [number, number, number],\n  defenderPos: [number, number, number],\n): THREE.Vector3 {\n  const direction = new THREE.Vector3(\n    defenderPos[0] - attackerPos[0],\n    0, // Keep movement horizontal\n    defenderPos[2] - attackerPos[2],\n  );\n  return direction.normalize();\n}\n\n/**\n * Configuration for combat attack movement\n */\nexport interface CombatAttackMovementConfig {\n  /** Whether player 1 is currently attacking */\n  readonly player1Attacking: boolean;\n  /** Player 1 animation type */\n  readonly player1AnimationType?: AnimationType;\n  /** Player 1 current stance */\n  readonly player1Stance: TrigramStance;\n  /** Player 1 base position */\n  readonly player1BasePosition: [number, number, number];\n  /** Player 1 animation duration in seconds (default: 0.4) */\n  readonly player1AnimationDuration?: number;\n\n  /** Whether player 2 is currently attacking */\n  readonly player2Attacking: boolean;\n  /** Player 2 animation type */\n  readonly player2AnimationType?: AnimationType;\n  /** Player 2 current stance */\n  readonly player2Stance: TrigramStance;\n  /** Player 2 base position */\n  readonly player2BasePosition: [number, number, number];\n  /** Player 2 animation duration in seconds (default: 0.4) */\n  readonly player2AnimationDuration?: number;\n\n  /** Default animation duration in seconds for both players if individual values not specified (default: 0.4) */\n  readonly animationDuration?: number;\n}\n\n/**\n * Return value from useCombatAttackMovement hook\n */\nexport interface CombatAttackMovementResult {\n  /** Player 1 current position including attack movement */\n  readonly player1Position: [number, number, number];\n  /** Player 2 current position including attack movement */\n  readonly player2Position: [number, number, number];\n  /** Whether player 1 is in forward lunge phase */\n  readonly player1IsLunging: boolean;\n  /** Whether player 2 is in forward lunge phase */\n  readonly player2IsLunging: boolean;\n}\n\n/**\n * useCombatAttackMovement hook\n *\n * Tracks attack movement physics for both fighters in combat.\n * Automatically handles lunge and recovery phases with smooth easing.\n * Calculates attack direction between fighters dynamically.\n *\n * @param config - Combat attack movement configuration\n * @returns Current positions and movement states for both fighters\n *\n * @example\n * ```typescript\n * const {\n *   player1Position,\n *   player2Position,\n *   player1IsLunging\n * } = useCombatAttackMovement({\n *   player1Attacking: isPlayer1Attacking,\n *   player1AnimationType: AnimationType.ROUNDHOUSE_KICK,\n *   player1Stance: player1.stance,\n *   player1BasePosition: [5, 0, 0],\n *   player2Attacking: false,\n *   player2AnimationType: undefined,\n *   player2Stance: player2.stance,\n *   player2BasePosition: [-5, 0, 0],\n * });\n *\n * <Player3D position={player1Position} />\n * <Player3D position={player2Position} />\n * ```\n *\n * @korean 전투공격이동사용\n */\nexport function useCombatAttackMovement(\n  config: CombatAttackMovementConfig,\n): CombatAttackMovementResult {\n  const {\n    player1Attacking,\n    player1AnimationType,\n    player1Stance,\n    player1BasePosition,\n    player1AnimationDuration,\n    player2Attacking,\n    player2AnimationType,\n    player2Stance,\n    player2BasePosition,\n    player2AnimationDuration,\n    animationDuration = 0.4,\n  } = config;\n\n  // Per-player animation durations (fallback to shared default)\n  const p1Duration = player1AnimationDuration ?? animationDuration;\n  const p2Duration = player2AnimationDuration ?? animationDuration;\n\n  // Attack movement physics engines (separate instances for each player to avoid race conditions)\n  const player1PhysicsRef = useRef(new AttackMovementPhysics());\n  const player2PhysicsRef = useRef(new AttackMovementPhysics());\n\n  // Reusable Vector3 objects to avoid GC pressure (60fps allocation)\n  const player1BasePosVectorRef = useRef(new THREE.Vector3());\n  const player2BasePosVectorRef = useRef(new THREE.Vector3());\n\n  // Player 1 attack timing\n  const player1AttackStartTimeRef = useRef<number | null>(null);\n  const player1MovementResultRef = useRef<ReturnType<\n    typeof player1PhysicsRef.current.calculateAttackMovement\n  > | null>(null);\n\n  // Player 2 attack timing\n  const player2AttackStartTimeRef = useRef<number | null>(null);\n  const player2MovementResultRef = useRef<ReturnType<\n    typeof player2PhysicsRef.current.calculateAttackMovement\n  > | null>(null);\n\n  // Current positions\n  const [player1Position, setPlayer1Position] =\n    useState<[number, number, number]>(player1BasePosition);\n  const [player2Position, setPlayer2Position] =\n    useState<[number, number, number]>(player2BasePosition);\n\n  // Movement states\n  const [player1IsLunging, setPlayer1IsLunging] = useState(false);\n  const [player2IsLunging, setPlayer2IsLunging] = useState(false);\n\n  // Track previous attacking state for rising-edge detection\n  const player1WasAttackingRef = useRef(false);\n  const player2WasAttackingRef = useRef(false);\n\n  // Player 1 attack movement effect\n  useEffect(() => {\n    const wasAttacking = player1WasAttackingRef.current;\n    player1WasAttackingRef.current = player1Attacking;\n\n    // Only initialize on transition from not-attacking → attacking (rising edge)\n    if (player1Attacking && player1AnimationType && !wasAttacking) {\n      // Start attack - calculate movement result\n      player1AttackStartTimeRef.current = Date.now();\n\n      const direction = calculateAttackDirection(\n        player1BasePosition,\n        player2BasePosition,\n      );\n\n      player1MovementResultRef.current =\n        player1PhysicsRef.current.calculateAttackMovement({\n          animationType: player1AnimationType,\n          currentStance: player1Stance,\n          direction,\n          animationDuration: p1Duration,\n        });\n\n      setPlayer1IsLunging(true);\n\n      // Setup animation frame loop\n      let animationFrameId: number;\n\n      const updatePosition = () => {\n        const elapsed = Date.now() - (player1AttackStartTimeRef.current ?? 0);\n        const movementResult = player1MovementResultRef.current;\n\n        if (!movementResult) {\n          setPlayer1Position(player1BasePosition);\n          return;\n        }\n\n        const totalDuration = movementResult.totalDuration * 1000; // Convert to ms\n\n        if (elapsed >= totalDuration) {\n          // Attack complete - return to base position\n          setPlayer1Position(player1BasePosition);\n          setPlayer1IsLunging(false);\n          player1AttackStartTimeRef.current = null;\n          player1MovementResultRef.current = null;\n          return;\n        }\n\n        // Calculate current position with attack movement\n        const elapsedSeconds = elapsed / 1000;\n        const basePos = player1BasePosVectorRef.current.set(\n          ...player1BasePosition,\n        );\n        const recovering = elapsed >= movementResult.lungeDuration * 1000;\n\n        const newPos = player1PhysicsRef.current.applyAttackMovement(\n          basePos,\n          movementResult,\n          elapsedSeconds,\n          recovering,\n        );\n\n        const newPosition: [number, number, number] = [\n          newPos.x,\n          newPos.y,\n          newPos.z,\n        ];\n\n        setPlayer1Position(newPosition);\n\n        // Update lunging state (first half is lunge, second half is recovery)\n        const totalProgress = elapsedSeconds / movementResult.totalDuration;\n        setPlayer1IsLunging(totalProgress < 0.5);\n\n        animationFrameId = requestAnimationFrame(updatePosition);\n      };\n\n      animationFrameId = requestAnimationFrame(updatePosition);\n\n      return () => {\n        if (animationFrameId) {\n          cancelAnimationFrame(animationFrameId);\n        }\n      };\n    } else {\n      // Not attacking - reset to base position\n      setPlayer1Position(player1BasePosition);\n      setPlayer1IsLunging(false);\n      player1AttackStartTimeRef.current = null;\n      player1MovementResultRef.current = null;\n    }\n  }, [\n    player1Attacking,\n    player1AnimationType,\n    player1Stance,\n    player1BasePosition,\n    player2BasePosition,\n    p1Duration,\n  ]);\n\n  // Player 2 attack movement effect (same logic as player 1)\n  useEffect(() => {\n    const wasAttacking = player2WasAttackingRef.current;\n    player2WasAttackingRef.current = player2Attacking;\n\n    // Only initialize on transition from not-attacking → attacking (rising edge)\n    if (player2Attacking && player2AnimationType && !wasAttacking) {\n      player2AttackStartTimeRef.current = Date.now();\n\n      const direction = calculateAttackDirection(\n        player2BasePosition,\n        player1BasePosition,\n      );\n\n      player2MovementResultRef.current =\n        player2PhysicsRef.current.calculateAttackMovement({\n          animationType: player2AnimationType,\n          currentStance: player2Stance,\n          direction,\n          animationDuration: p2Duration,\n        });\n\n      setPlayer2IsLunging(true);\n\n      let animationFrameId: number;\n\n      const updatePosition = () => {\n        const elapsed = Date.now() - (player2AttackStartTimeRef.current ?? 0);\n        const movementResult = player2MovementResultRef.current;\n\n        if (!movementResult) {\n          setPlayer2Position(player2BasePosition);\n          return;\n        }\n\n        const totalDuration = movementResult.totalDuration * 1000;\n\n        if (elapsed >= totalDuration) {\n          setPlayer2Position(player2BasePosition);\n          setPlayer2IsLunging(false);\n          player2AttackStartTimeRef.current = null;\n          player2MovementResultRef.current = null;\n          return;\n        }\n\n        const elapsedSeconds = elapsed / 1000;\n        const basePos = player2BasePosVectorRef.current.set(\n          ...player2BasePosition,\n        );\n        const recovering = elapsed >= movementResult.lungeDuration * 1000;\n\n        const newPos = player2PhysicsRef.current.applyAttackMovement(\n          basePos,\n          movementResult,\n          elapsedSeconds,\n          recovering,\n        );\n\n        const newPosition: [number, number, number] = [\n          newPos.x,\n          newPos.y,\n          newPos.z,\n        ];\n\n        setPlayer2Position(newPosition);\n\n        const totalProgress = elapsedSeconds / movementResult.totalDuration;\n        setPlayer2IsLunging(totalProgress < 0.5);\n\n        animationFrameId = requestAnimationFrame(updatePosition);\n      };\n\n      animationFrameId = requestAnimationFrame(updatePosition);\n\n      return () => {\n        if (animationFrameId) {\n          cancelAnimationFrame(animationFrameId);\n        }\n      };\n    } else {\n      setPlayer2Position(player2BasePosition);\n      setPlayer2IsLunging(false);\n      player2AttackStartTimeRef.current = null;\n      player2MovementResultRef.current = null;\n    }\n  }, [\n    player2Attacking,\n    player2AnimationType,\n    player2Stance,\n    player1BasePosition,\n    player2BasePosition,\n    p2Duration,\n  ]);\n\n  return {\n    player1Position,\n    player2Position,\n    player1IsLunging,\n    player2IsLunging,\n  };\n}\n"],"mappings":"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"}

package/lib/components/screens/combat/hooks/useCombatAudio.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Combat Audio Hook for Black Trigram
+ * Provides comprehensive audio feedback for combat actions including
+ * bone impact sounds, fracture audio, and body-region-specific hit sounds
+ */
+import { AudioBodyRegion, ImpactIntensity } from "../../../../audio/types";
+/**
+ * Attack intensity levels for sound selection
+ */
+export type AttackIntensity = "light" | "medium" | "heavy" | "critical";
+/**
+ * Combat audio hook for playing attack, hit, block, dodge, and stance sounds
+ * @returns Object with methods for playing various combat sounds
+ */
+export declare const useCombatAudio: () => {
+    playAttackSound: (intensity?: AttackIntensity) => Promise<void>;
+    playHitSound: (damage: number) => Promise<void>;
+    playBlockSound: (guardBroken?: boolean) => Promise<void>;
+    playDodgeSound: () => Promise<void>;
+    playStanceChangeSound: () => Promise<void>;
+    playSpecialTechniqueSound: () => Promise<void>;
+    playCombatMusic: (fadeInDuration?: number) => Promise<void>;
+    playArchetypeMusic: (archetype: string, fadeInDuration?: number) => Promise<void>;
+    stopCombatMusic: (fadeOutDuration?: number) => Promise<void>;
+    getActiveSoundCount: () => number;
+    playBoneImpactSound: (options: {
+        region?: AudioBodyRegion;
+        intensity?: ImpactIntensity;
+        damage?: number;
+        remainingHealth?: number;
+        vitalPoint?: boolean;
+        hitPosition?: {
+            x: number;
+            y: number;
+            z?: number;
+        };
+    }) => Promise<void>;
+};
+export default useCombatAudio;
+//# sourceMappingURL=useCombatAudio.d.ts.map

package/lib/components/screens/combat/hooks/useCombatAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCombatAudio.d.ts","sourceRoot":"","sources":["../../../../../src/components/screens/combat/hooks/useCombatAudio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAOxE;;;GAGG;AACH,eAAO,MAAM,cAAc;kCA2EL,eAAe;2BAgDlB,MAAM;mCAwCD,OAAO;;;;uCAmGJ,MAAM;oCAgBX,MAAM,mBAAkB,MAAM;wCAiCxB,MAAM;+BAcY,MAAM;mCAsChC;QACd,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,CAAC,EAAE,eAAe,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD;CAkEJ,CAAC;AAEF,eAAe,cAAc,CAAC"}