blacktrigram 0.7.44 → 0.7.45

package/lib/systems/bodypart/BodyPartDamageIntegration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartDamageIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAY,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,GACrB,UAAU,CAoGZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,oBAAoB,EACnE,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,CAAC,CA0BH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,CAAC,CAG3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,qCAiBpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,gBAAgB,GAAE,MAAY,GAAG,CAAC,CAiB9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,oBAAoB,EACxE,MAAM,EAAE,CAAC,EACT,eAAe,EAAE,MAAM,GACtB,CAAC,CA+CH"}
+{"version":3,"file":"BodyPartDamageIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAY,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,GACrB,UAAU,CAoGZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,oBAAoB,EACnE,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,CAAC,CA0BH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,CAAC,CAG3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,qCAiBpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAMT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iCAAiC,CAC/C,CAAC,SAAS,oBAAoB,EAC9B,MAAM,EAAE,CAAC,EAAE,gBAAgB,GAAE,MAAY,GAAG,CAAC,CAiB9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,oBAAoB,EACxE,MAAM,EAAE,CAAC,EACT,eAAe,EAAE,MAAM,GACtB,CAAC,CA+CH"}

package/lib/systems/bodypart/BodyPartDamageIntegration.js

@@ -25,7 +25,6 @@ import { bodyPartHealthSystem } from "./BodyPartHealthSystem.js";
 * @param vitalPoint - Vital point that was struck
 * @returns Corresponding body region
 *
-* @public
 */
 function getBodyRegionFromVitalPoint(vitalPoint) {
 	const pointId = vitalPoint.id.toLowerCase();
@@ -56,7 +55,6 @@ function getBodyRegionFromVitalPoint(vitalPoint) {
 * @param bodyRegion - Body region that was hit
 * @returns Updated player state with body part damage applied
 *
-* @public
 */
 function applyDamageToBodyParts(player, totalDamage, bodyRegion) {
 	const bodyPartHealth = player.bodyPartHealth ?? bodyPartHealthSystem.createDefaultBodyPartHealth();
@@ -83,7 +81,6 @@ function applyDamageToBodyParts(player, totalDamage, bodyRegion) {
 * @param vitalPoint - Vital point that was struck
 * @returns Updated player state with vital point damage applied
 *
-* @public
 */
 function applyVitalPointDamageToBodyParts(player, totalDamage, vitalPoint) {
 	return applyDamageToBodyParts(player, totalDamage, getBodyRegionFromVitalPoint(vitalPoint));
@@ -112,7 +109,6 @@ function applyVitalPointDamageToBodyParts(player, totalDamage, vitalPoint) {
 * const actualSpeed = baseSpeed * effects.movementSpeedModifier;
 * ```
 *
-* @public
 */
 function getBodyPartCombatEffects(player) {
 	if (!player.bodyPartHealth) return {
@@ -139,7 +135,6 @@ function getBodyPartCombatEffects(player) {
 * @param player - Player state to check
 * @returns Whether player is incapacitated
 *
-* @public
 */
 function isPlayerIncapacitatedByBodyDamage(player) {
 	if (!player.bodyPartHealth) return false;
@@ -157,7 +152,6 @@ function isPlayerIncapacitatedByBodyDamage(player) {
 * @param maxHealthPerPart - Optional custom max health per part
 * @returns Player state with body part health initialized
 *
-* @public
 */
 function initializeBodyPartHealthForPlayer(player, maxHealthPerPart = 100) {
 	if (player.bodyPartHealth && player.bodyPartMaxHealth) return player;
@@ -182,7 +176,6 @@ function initializeBodyPartHealthForPlayer(player, maxHealthPerPart = 100) {
 * @param totalHealAmount - Total healing to distribute
 * @returns Updated player state with healing applied
 *
-* @public
 */
 function healBodyPartsProportionally(player, totalHealAmount) {
 	if (!player.bodyPartHealth || !player.bodyPartMaxHealth) return player;

package/lib/systems/bodypart/BodyPartDamageIntegration.js.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartDamageIntegration.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"sourcesContent":["/**\n * Body Part Damage Integration for Combat System\n *\n * **Korean**: 신체부위 피해 통합\n *\n * Extends the damage calculation system to apply damage to specific body parts\n * based on vital point hits and attack locations. Integrates with the existing\n * VitalPointSystem and DamageCalculator.\n *\n * @module systems/bodypart/BodyPartDamageIntegration\n * @category Body Part System\n * @korean 신체부위피해통합\n */\n\nimport { BodyRegion } from \"@/types\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\nimport { bodyPartHealthSystem } from \"./BodyPartHealthSystem\";\nimport { BodyPart, BodyPartHealth, BodyPartMaxHealth } from \"./types\";\n\n/**\n * Minimal player view needed for body part damage operations.\n */\nexport interface BodyPartDamageTarget {\n  readonly health: number;\n  readonly bodyPartHealth?: BodyPartHealth;\n  readonly bodyPartMaxHealth?: BodyPartMaxHealth;\n}\n\n/**\n * Map vital point to its corresponding body region.\n *\n * **Korean**: 급소에서 신체 영역 매핑\n *\n * Analyzes a vital point's location and category to determine which\n * BodyRegion it belongs to, enabling proper damage distribution.\n *\n * @param vitalPoint - Vital point that was struck\n * @returns Corresponding body region\n *\n * @public\n */\nexport function getBodyRegionFromVitalPoint(\n  vitalPoint: VitalPoint\n): BodyRegion {\n  const pointId = vitalPoint.id.toLowerCase();\n\n  // Head region vital points\n  if (\n    pointId.includes(\"head_\") ||\n    pointId.includes(\"temple\") ||\n    pointId.includes(\"jaw\") ||\n    pointId.includes(\"crown\") ||\n    pointId.includes(\"forehead\") ||\n    pointId.includes(\"eye\") ||\n    pointId.includes(\"nose\") ||\n    pointId.includes(\"ear\") ||\n    pointId.includes(\"skull\")\n  ) {\n    return BodyRegion.HEAD;\n  }\n\n  // Neck region vital points\n  if (\n    pointId.includes(\"neck\") ||\n    pointId.includes(\"throat\") ||\n    pointId.includes(\"carotid\") ||\n    pointId.includes(\"cervical\")\n  ) {\n    return BodyRegion.NECK;\n  }\n\n  // Torso region vital points\n  if (\n    pointId.includes(\"torso_\") ||\n    pointId.includes(\"chest\") ||\n    pointId.includes(\"solar_plexus\") ||\n    pointId.includes(\"ribs\") ||\n    pointId.includes(\"sternum\") ||\n    pointId.includes(\"heart\") ||\n    pointId.includes(\"lung\") ||\n    pointId.includes(\"abdomen\")\n  ) {\n    return BodyRegion.TORSO;\n  }\n\n  // Core region vital points\n  if (\n    pointId.includes(\"core\") ||\n    pointId.includes(\"dantian\") ||\n    pointId.includes(\"kidney\") ||\n    pointId.includes(\"liver\") ||\n    pointId.includes(\"spleen\") ||\n    pointId.includes(\"bladder\")\n  ) {\n    return BodyRegion.CORE;\n  }\n\n  // Left arm vital points\n  if (\n    pointId.includes(\"arm_left\") ||\n    pointId.includes(\"left_shoulder\") ||\n    pointId.includes(\"left_elbow\") ||\n    pointId.includes(\"left_wrist\") ||\n    pointId.includes(\"left_hand\")\n  ) {\n    return BodyRegion.LEFT_ARM;\n  }\n\n  // Right arm vital points\n  if (\n    pointId.includes(\"arm_right\") ||\n    pointId.includes(\"right_shoulder\") ||\n    pointId.includes(\"right_elbow\") ||\n    pointId.includes(\"right_wrist\") ||\n    pointId.includes(\"right_hand\")\n  ) {\n    return BodyRegion.RIGHT_ARM;\n  }\n\n  // Left leg vital points\n  if (\n    pointId.includes(\"leg_left\") ||\n    pointId.includes(\"left_knee\") ||\n    pointId.includes(\"left_ankle\") ||\n    pointId.includes(\"left_foot\") ||\n    pointId.includes(\"left_thigh\")\n  ) {\n    return BodyRegion.LEFT_LEG;\n  }\n\n  // Right leg vital points\n  if (\n    pointId.includes(\"leg_right\") ||\n    pointId.includes(\"right_knee\") ||\n    pointId.includes(\"right_ankle\") ||\n    pointId.includes(\"right_foot\") ||\n    pointId.includes(\"right_thigh\")\n  ) {\n    return BodyRegion.RIGHT_LEG;\n  }\n\n  // Default to torso for unmatched points\n  return BodyRegion.TORSO;\n}\n\n/**\n * Apply damage to player's body parts based on hit location.\n *\n * **Korean**: 타격 위치 기반 신체부위 피해 적용\n *\n * Takes total damage and distributes it across body parts according to\n * the hit location. Updates both aggregate health and body part health.\n *\n * For combat compatibility, the aggregate health is directly reduced by\n * the damage amount (traditional behavior), while body part health is\n * updated proportionally for visualization purposes.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param bodyRegion - Body region that was hit\n * @returns Updated player state with body part damage applied\n *\n * @public\n */\nexport function applyDamageToBodyParts<T extends BodyPartDamageTarget>(\n  player: T,\n  totalDamage: number,\n  bodyRegion: BodyRegion\n): T {\n  // If body part health not initialized, initialize it\n  const bodyPartHealth =\n    player.bodyPartHealth ?? bodyPartHealthSystem.createDefaultBodyPartHealth();\n  const bodyPartMaxHealth =\n    player.bodyPartMaxHealth ?? bodyPartHealthSystem.createDefaultMaxHealth();\n\n  // Apply distributed damage to body parts for visualization\n  const updatedBodyPartHealth = bodyPartHealthSystem.applyDistributedDamage(\n    bodyPartHealth,\n    bodyRegion,\n    totalDamage,\n    bodyPartMaxHealth\n  );\n\n  // Calculate new aggregate health directly: traditional damage reduction\n  // This ensures combat damage calculations remain consistent\n  const newAggregateHealth = Math.max(0, player.health - totalDamage);\n\n  // Update player state with new body part health and aggregate health\n  return {\n    ...player,\n    bodyPartHealth: updatedBodyPartHealth,\n    bodyPartMaxHealth,\n    health: newAggregateHealth,\n  };\n}\n\n/**\n * Apply damage from a vital point hit to appropriate body parts.\n *\n * **Korean**: 급소 타격 신체부위 피해 적용\n *\n * Specialized damage application for vital point strikes. Maps the vital\n * point to its body region and applies damage with appropriate distribution.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param vitalPoint - Vital point that was struck\n * @returns Updated player state with vital point damage applied\n *\n * @public\n */\nexport function applyVitalPointDamageToBodyParts<\n  T extends BodyPartDamageTarget\n>(player: T, totalDamage: number, vitalPoint: VitalPoint): T {\n  const bodyRegion = getBodyRegionFromVitalPoint(vitalPoint);\n  return applyDamageToBodyParts(player, totalDamage, bodyRegion);\n}\n\n/**\n * Get combat capability modifiers from body part health.\n *\n * **Korean**: 신체부위 전투 능력 수정치 조회\n *\n * Calculates how body part damage affects combat capabilities.\n * Returns modifiers that should be applied to:\n * - Consciousness (awareness, reaction time)\n * - Stamina regeneration\n * - Attack damage output\n * - Movement speed\n * - Balance and stability\n * - Technique accuracy\n *\n * @param player - Player state to analyze\n * @returns Combat capability effect multipliers (0.0-1.0)\n *\n * @example\n * ```typescript\n * const effects = getBodyPartCombatEffects(player);\n * const actualDamage = baseDamage * effects.attackDamageModifier;\n * const actualSpeed = baseSpeed * effects.movementSpeedModifier;\n * ```\n *\n * @public\n */\nexport function getBodyPartCombatEffects(player: BodyPartDamageTarget) {\n  // If no body part health, return no effects\n  if (!player.bodyPartHealth) {\n    return {\n      consciousnessModifier: 1.0,\n      staminaRegenModifier: 1.0,\n      attackDamageModifier: 1.0,\n      movementSpeedModifier: 1.0,\n      balanceModifier: 1.0,\n      techniqueAccuracyModifier: 1.0,\n    };\n  }\n\n  return bodyPartHealthSystem.calculateBodyPartEffects(\n    player.bodyPartHealth,\n    player.bodyPartMaxHealth\n  );\n}\n\n/**\n * Check if player is incapacitated by body part damage.\n *\n * **Korean**: 신체부위 무력화 확인\n *\n * Determines if the player can continue fighting based on body part health.\n * Player is incapacitated if:\n * - Head is at 0 HP (unconscious)\n * - Both legs are at 0 HP (cannot stand)\n * - Aggregate health is below 10%\n *\n * @param player - Player state to check\n * @returns Whether player is incapacitated\n *\n * @public\n */\nexport function isPlayerIncapacitatedByBodyDamage(\n  player: BodyPartDamageTarget\n): boolean {\n  if (!player.bodyPartHealth) {\n    return false; // No body part system = use aggregate health only\n  }\n\n  return bodyPartHealthSystem.isIncapacitated(player.bodyPartHealth);\n}\n\n/**\n * Initialize body part health for a player.\n *\n * **Korean**: 플레이어 신체부위 체력 초기화\n *\n * Sets up body part health and max health for a player if not already present.\n * Uses the provided max health or defaults to 100 per part.\n *\n * @param player - Player state to initialize\n * @param maxHealthPerPart - Optional custom max health per part\n * @returns Player state with body part health initialized\n *\n * @public\n */\nexport function initializeBodyPartHealthForPlayer<\n  T extends BodyPartDamageTarget\n>(player: T, maxHealthPerPart: number = 100): T {\n  // Skip if already initialized\n  if (player.bodyPartHealth && player.bodyPartMaxHealth) {\n    return player;\n  }\n\n  const bodyPartHealth =\n    bodyPartHealthSystem.createDefaultBodyPartHealth(maxHealthPerPart);\n  const bodyPartMaxHealth =\n    bodyPartHealthSystem.createDefaultMaxHealth(maxHealthPerPart);\n\n  return {\n    ...player,\n    bodyPartHealth,\n    bodyPartMaxHealth,\n    health: bodyPartHealthSystem.calculateAggregateHealth(bodyPartHealth),\n  };\n}\n\n/**\n * Heal body parts proportionally based on total healing amount.\n *\n * **Korean**: 신체부위 비례 치유\n *\n * Distributes healing across all damaged body parts proportionally to\n * their damage level. Most damaged parts receive more healing.\n *\n * @param player - Player state to heal\n * @param totalHealAmount - Total healing to distribute\n * @returns Updated player state with healing applied\n *\n * @public\n */\nexport function healBodyPartsProportionally<T extends BodyPartDamageTarget>(\n  player: T,\n  totalHealAmount: number\n): T {\n  if (!player.bodyPartHealth || !player.bodyPartMaxHealth) {\n    return player; // No body part system active\n  }\n\n  const bodyPartHealth = player.bodyPartHealth;\n  const bodyPartMaxHealth = player.bodyPartMaxHealth;\n\n  // Calculate total missing health across all parts\n  const missingHealth = (Object.keys(bodyPartHealth) as BodyPart[]).reduce(\n    (sum, part) => {\n      return sum + (bodyPartMaxHealth[part] - bodyPartHealth[part]);\n    },\n    0\n  );\n\n  // If no damage, return unchanged\n  if (missingHealth <= 0) {\n    return player;\n  }\n\n  // Heal each part proportionally to its damage\n  let updatedHealth = { ...bodyPartHealth };\n\n  (Object.keys(bodyPartHealth) as BodyPart[]).forEach((part) => {\n    const partMissingHealth = bodyPartMaxHealth[part] - bodyPartHealth[part];\n    if (partMissingHealth > 0) {\n      const proportion = partMissingHealth / missingHealth;\n      const healForThisPart = totalHealAmount * proportion;\n      updatedHealth = bodyPartHealthSystem.healBodyPart(\n        updatedHealth,\n        part,\n        healForThisPart,\n        bodyPartMaxHealth\n      );\n    }\n  });\n\n  // Calculate new aggregate health\n  const newAggregateHealth =\n    bodyPartHealthSystem.calculateAggregateHealth(updatedHealth);\n\n  return {\n    ...player,\n    bodyPartHealth: updatedHealth,\n    health: newAggregateHealth,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"BodyPartDamageIntegration.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartDamageIntegration.ts"],"sourcesContent":["/**\n * Body Part Damage Integration for Combat System\n *\n * **Korean**: 신체부위 피해 통합\n *\n * Extends the damage calculation system to apply damage to specific body parts\n * based on vital point hits and attack locations. Integrates with the existing\n * VitalPointSystem and DamageCalculator.\n *\n * @module systems/bodypart/BodyPartDamageIntegration\n * @category Body Part System\n * @korean 신체부위피해통합\n */\n\nimport { BodyRegion } from \"@/types\";\nimport type { VitalPoint } from \"../vitalpoint/types\";\nimport { bodyPartHealthSystem } from \"./BodyPartHealthSystem\";\nimport { BodyPart, BodyPartHealth, BodyPartMaxHealth } from \"./types\";\n\n/**\n * Minimal player view needed for body part damage operations.\n */\nexport interface BodyPartDamageTarget {\n  readonly health: number;\n  readonly bodyPartHealth?: BodyPartHealth;\n  readonly bodyPartMaxHealth?: BodyPartMaxHealth;\n}\n\n/**\n * Map vital point to its corresponding body region.\n *\n * **Korean**: 급소에서 신체 영역 매핑\n *\n * Analyzes a vital point's location and category to determine which\n * BodyRegion it belongs to, enabling proper damage distribution.\n *\n * @param vitalPoint - Vital point that was struck\n * @returns Corresponding body region\n *\n */\nexport function getBodyRegionFromVitalPoint(\n  vitalPoint: VitalPoint\n): BodyRegion {\n  const pointId = vitalPoint.id.toLowerCase();\n\n  // Head region vital points\n  if (\n    pointId.includes(\"head_\") ||\n    pointId.includes(\"temple\") ||\n    pointId.includes(\"jaw\") ||\n    pointId.includes(\"crown\") ||\n    pointId.includes(\"forehead\") ||\n    pointId.includes(\"eye\") ||\n    pointId.includes(\"nose\") ||\n    pointId.includes(\"ear\") ||\n    pointId.includes(\"skull\")\n  ) {\n    return BodyRegion.HEAD;\n  }\n\n  // Neck region vital points\n  if (\n    pointId.includes(\"neck\") ||\n    pointId.includes(\"throat\") ||\n    pointId.includes(\"carotid\") ||\n    pointId.includes(\"cervical\")\n  ) {\n    return BodyRegion.NECK;\n  }\n\n  // Torso region vital points\n  if (\n    pointId.includes(\"torso_\") ||\n    pointId.includes(\"chest\") ||\n    pointId.includes(\"solar_plexus\") ||\n    pointId.includes(\"ribs\") ||\n    pointId.includes(\"sternum\") ||\n    pointId.includes(\"heart\") ||\n    pointId.includes(\"lung\") ||\n    pointId.includes(\"abdomen\")\n  ) {\n    return BodyRegion.TORSO;\n  }\n\n  // Core region vital points\n  if (\n    pointId.includes(\"core\") ||\n    pointId.includes(\"dantian\") ||\n    pointId.includes(\"kidney\") ||\n    pointId.includes(\"liver\") ||\n    pointId.includes(\"spleen\") ||\n    pointId.includes(\"bladder\")\n  ) {\n    return BodyRegion.CORE;\n  }\n\n  // Left arm vital points\n  if (\n    pointId.includes(\"arm_left\") ||\n    pointId.includes(\"left_shoulder\") ||\n    pointId.includes(\"left_elbow\") ||\n    pointId.includes(\"left_wrist\") ||\n    pointId.includes(\"left_hand\")\n  ) {\n    return BodyRegion.LEFT_ARM;\n  }\n\n  // Right arm vital points\n  if (\n    pointId.includes(\"arm_right\") ||\n    pointId.includes(\"right_shoulder\") ||\n    pointId.includes(\"right_elbow\") ||\n    pointId.includes(\"right_wrist\") ||\n    pointId.includes(\"right_hand\")\n  ) {\n    return BodyRegion.RIGHT_ARM;\n  }\n\n  // Left leg vital points\n  if (\n    pointId.includes(\"leg_left\") ||\n    pointId.includes(\"left_knee\") ||\n    pointId.includes(\"left_ankle\") ||\n    pointId.includes(\"left_foot\") ||\n    pointId.includes(\"left_thigh\")\n  ) {\n    return BodyRegion.LEFT_LEG;\n  }\n\n  // Right leg vital points\n  if (\n    pointId.includes(\"leg_right\") ||\n    pointId.includes(\"right_knee\") ||\n    pointId.includes(\"right_ankle\") ||\n    pointId.includes(\"right_foot\") ||\n    pointId.includes(\"right_thigh\")\n  ) {\n    return BodyRegion.RIGHT_LEG;\n  }\n\n  // Default to torso for unmatched points\n  return BodyRegion.TORSO;\n}\n\n/**\n * Apply damage to player's body parts based on hit location.\n *\n * **Korean**: 타격 위치 기반 신체부위 피해 적용\n *\n * Takes total damage and distributes it across body parts according to\n * the hit location. Updates both aggregate health and body part health.\n *\n * For combat compatibility, the aggregate health is directly reduced by\n * the damage amount (traditional behavior), while body part health is\n * updated proportionally for visualization purposes.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param bodyRegion - Body region that was hit\n * @returns Updated player state with body part damage applied\n *\n */\nexport function applyDamageToBodyParts<T extends BodyPartDamageTarget>(\n  player: T,\n  totalDamage: number,\n  bodyRegion: BodyRegion\n): T {\n  // If body part health not initialized, initialize it\n  const bodyPartHealth =\n    player.bodyPartHealth ?? bodyPartHealthSystem.createDefaultBodyPartHealth();\n  const bodyPartMaxHealth =\n    player.bodyPartMaxHealth ?? bodyPartHealthSystem.createDefaultMaxHealth();\n\n  // Apply distributed damage to body parts for visualization\n  const updatedBodyPartHealth = bodyPartHealthSystem.applyDistributedDamage(\n    bodyPartHealth,\n    bodyRegion,\n    totalDamage,\n    bodyPartMaxHealth\n  );\n\n  // Calculate new aggregate health directly: traditional damage reduction\n  // This ensures combat damage calculations remain consistent\n  const newAggregateHealth = Math.max(0, player.health - totalDamage);\n\n  // Update player state with new body part health and aggregate health\n  return {\n    ...player,\n    bodyPartHealth: updatedBodyPartHealth,\n    bodyPartMaxHealth,\n    health: newAggregateHealth,\n  };\n}\n\n/**\n * Apply damage from a vital point hit to appropriate body parts.\n *\n * **Korean**: 급소 타격 신체부위 피해 적용\n *\n * Specialized damage application for vital point strikes. Maps the vital\n * point to its body region and applies damage with appropriate distribution.\n *\n * @param player - Player receiving damage\n * @param totalDamage - Total damage amount\n * @param vitalPoint - Vital point that was struck\n * @returns Updated player state with vital point damage applied\n *\n */\nexport function applyVitalPointDamageToBodyParts<\n  T extends BodyPartDamageTarget\n>(player: T, totalDamage: number, vitalPoint: VitalPoint): T {\n  const bodyRegion = getBodyRegionFromVitalPoint(vitalPoint);\n  return applyDamageToBodyParts(player, totalDamage, bodyRegion);\n}\n\n/**\n * Get combat capability modifiers from body part health.\n *\n * **Korean**: 신체부위 전투 능력 수정치 조회\n *\n * Calculates how body part damage affects combat capabilities.\n * Returns modifiers that should be applied to:\n * - Consciousness (awareness, reaction time)\n * - Stamina regeneration\n * - Attack damage output\n * - Movement speed\n * - Balance and stability\n * - Technique accuracy\n *\n * @param player - Player state to analyze\n * @returns Combat capability effect multipliers (0.0-1.0)\n *\n * @example\n * ```typescript\n * const effects = getBodyPartCombatEffects(player);\n * const actualDamage = baseDamage * effects.attackDamageModifier;\n * const actualSpeed = baseSpeed * effects.movementSpeedModifier;\n * ```\n *\n */\nexport function getBodyPartCombatEffects(player: BodyPartDamageTarget) {\n  // If no body part health, return no effects\n  if (!player.bodyPartHealth) {\n    return {\n      consciousnessModifier: 1.0,\n      staminaRegenModifier: 1.0,\n      attackDamageModifier: 1.0,\n      movementSpeedModifier: 1.0,\n      balanceModifier: 1.0,\n      techniqueAccuracyModifier: 1.0,\n    };\n  }\n\n  return bodyPartHealthSystem.calculateBodyPartEffects(\n    player.bodyPartHealth,\n    player.bodyPartMaxHealth\n  );\n}\n\n/**\n * Check if player is incapacitated by body part damage.\n *\n * **Korean**: 신체부위 무력화 확인\n *\n * Determines if the player can continue fighting based on body part health.\n * Player is incapacitated if:\n * - Head is at 0 HP (unconscious)\n * - Both legs are at 0 HP (cannot stand)\n * - Aggregate health is below 10%\n *\n * @param player - Player state to check\n * @returns Whether player is incapacitated\n *\n */\nexport function isPlayerIncapacitatedByBodyDamage(\n  player: BodyPartDamageTarget\n): boolean {\n  if (!player.bodyPartHealth) {\n    return false; // No body part system = use aggregate health only\n  }\n\n  return bodyPartHealthSystem.isIncapacitated(player.bodyPartHealth);\n}\n\n/**\n * Initialize body part health for a player.\n *\n * **Korean**: 플레이어 신체부위 체력 초기화\n *\n * Sets up body part health and max health for a player if not already present.\n * Uses the provided max health or defaults to 100 per part.\n *\n * @param player - Player state to initialize\n * @param maxHealthPerPart - Optional custom max health per part\n * @returns Player state with body part health initialized\n *\n */\nexport function initializeBodyPartHealthForPlayer<\n  T extends BodyPartDamageTarget\n>(player: T, maxHealthPerPart: number = 100): T {\n  // Skip if already initialized\n  if (player.bodyPartHealth && player.bodyPartMaxHealth) {\n    return player;\n  }\n\n  const bodyPartHealth =\n    bodyPartHealthSystem.createDefaultBodyPartHealth(maxHealthPerPart);\n  const bodyPartMaxHealth =\n    bodyPartHealthSystem.createDefaultMaxHealth(maxHealthPerPart);\n\n  return {\n    ...player,\n    bodyPartHealth,\n    bodyPartMaxHealth,\n    health: bodyPartHealthSystem.calculateAggregateHealth(bodyPartHealth),\n  };\n}\n\n/**\n * Heal body parts proportionally based on total healing amount.\n *\n * **Korean**: 신체부위 비례 치유\n *\n * Distributes healing across all damaged body parts proportionally to\n * their damage level. Most damaged parts receive more healing.\n *\n * @param player - Player state to heal\n * @param totalHealAmount - Total healing to distribute\n * @returns Updated player state with healing applied\n *\n */\nexport function healBodyPartsProportionally<T extends BodyPartDamageTarget>(\n  player: T,\n  totalHealAmount: number\n): T {\n  if (!player.bodyPartHealth || !player.bodyPartMaxHealth) {\n    return player; // No body part system active\n  }\n\n  const bodyPartHealth = player.bodyPartHealth;\n  const bodyPartMaxHealth = player.bodyPartMaxHealth;\n\n  // Calculate total missing health across all parts\n  const missingHealth = (Object.keys(bodyPartHealth) as BodyPart[]).reduce(\n    (sum, part) => {\n      return sum + (bodyPartMaxHealth[part] - bodyPartHealth[part]);\n    },\n    0\n  );\n\n  // If no damage, return unchanged\n  if (missingHealth <= 0) {\n    return player;\n  }\n\n  // Heal each part proportionally to its damage\n  let updatedHealth = { ...bodyPartHealth };\n\n  (Object.keys(bodyPartHealth) as BodyPart[]).forEach((part) => {\n    const partMissingHealth = bodyPartMaxHealth[part] - bodyPartHealth[part];\n    if (partMissingHealth > 0) {\n      const proportion = partMissingHealth / missingHealth;\n      const healForThisPart = totalHealAmount * proportion;\n      updatedHealth = bodyPartHealthSystem.healBodyPart(\n        updatedHealth,\n        part,\n        healForThisPart,\n        bodyPartMaxHealth\n      );\n    }\n  });\n\n  // Calculate new aggregate health\n  const newAggregateHealth =\n    bodyPartHealthSystem.calculateAggregateHealth(updatedHealth);\n\n  return {\n    ...player,\n    bodyPartHealth: updatedHealth,\n    health: newAggregateHealth,\n  };\n}\n"],"mappings":"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"}

package/lib/systems/bodypart/BodyPartHealthSystem.d.ts

@@ -47,7 +47,6 @@ import { BodyPart, BodyPartDamageDistribution, BodyPartEffects, BodyPartHealth,
  * const effects = system.calculateBodyPartEffects(damaged);
  * ```
  *
- * @public
  * @category Body Part System
  */
 export declare class BodyPartHealthSystem {
@@ -61,7 +60,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Optional custom max health per part (default: 100)
      * @returns Body part health structure with all parts at max HP
      *
-     * @public
      */
     createDefaultBodyPartHealth(maxHealth?: number): BodyPartHealth;
     /**
@@ -72,7 +70,6 @@ export declare class BodyPartHealthSystem {
      * @param baseMaxHealth - Base maximum health per part
      * @returns Maximum health structure
      *
-     * @public
      */
     createDefaultMaxHealth(baseMaxHealth?: number): BodyPartMaxHealth;
     /**
@@ -89,7 +86,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Optional maximum health limits
      * @returns Updated body part health
      *
-     * @public
      */
     applyDamageToBodyPart(current: BodyPartHealth, bodyPart: BodyPart, damage: number, maxHealth?: BodyPartMaxHealth): BodyPartHealth;
     /**
@@ -103,7 +99,6 @@ export declare class BodyPartHealthSystem {
      * @param bodyRegion - Hit location
      * @returns Damage distribution configuration
      *
-     * @public
      */
     getDamageDistribution(bodyRegion: BodyRegion): BodyPartDamageDistribution;
     /**
@@ -120,7 +115,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Optional maximum health limits
      * @returns Updated body part health
      *
-     * @public
      */
     applyDistributedDamage(current: BodyPartHealth, bodyRegion: BodyRegion, totalDamage: number, maxHealth?: BodyPartMaxHealth): BodyPartHealth;
     /**
@@ -139,7 +133,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Maximum health values
      * @returns Combat capability effect multipliers
      *
-     * @public
      */
     calculateBodyPartEffects(health: BodyPartHealth, maxHealth?: BodyPartMaxHealth): BodyPartEffects;
     /**
@@ -153,7 +146,6 @@ export declare class BodyPartHealthSystem {
      * @param health - Body part health
      * @returns Aggregate health value (0-100)
      *
-     * @public
      */
     calculateAggregateHealth(health: BodyPartHealth): number;
     /**
@@ -169,7 +161,6 @@ export declare class BodyPartHealthSystem {
      * @param part - Body part to query
      * @returns Status information for display
      *
-     * @public
      */
     getBodyPartStatus(health: BodyPartHealth, maxHealth: BodyPartMaxHealth, part: BodyPart): BodyPartStatus;
     /**
@@ -183,7 +174,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Maximum health values
      * @returns Array of status information for all parts
      *
-     * @public
      */
     getAllBodyPartStatuses(health: BodyPartHealth, maxHealth: BodyPartMaxHealth): BodyPartStatus[];
     /**
@@ -200,7 +190,6 @@ export declare class BodyPartHealthSystem {
      * @param maxHealth - Optional maximum health limits
      * @returns Updated body part health
      *
-     * @public
      */
     healBodyPart(current: BodyPartHealth, bodyPart: BodyPart, healAmount: number, maxHealth?: BodyPartMaxHealth): BodyPartHealth;
     /**
@@ -216,7 +205,6 @@ export declare class BodyPartHealthSystem {
      * @param health - Current body part health
      * @returns Whether player is incapacitated
      *
-     * @public
      */
     isIncapacitated(health: BodyPartHealth): boolean;
 }
@@ -227,7 +215,6 @@ export declare class BodyPartHealthSystem {
  *
  * Provides global access to the body part health system throughout the game.
  *
- * @public
  */
 export declare const bodyPartHealthSystem: BodyPartHealthSystem;
 //# sourceMappingURL=BodyPartHealthSystem.d.ts.map

package/lib/systems/bodypart/BodyPartHealthSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartHealthSystem.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartHealthSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAA6B,MAAM,SAAS,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EAGf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,GAAE,oBAA+C;IAInE;;;;;;;;;OASG;IACH,2BAA2B,CAAC,SAAS,GAAE,MAAY,GAAG,cAAc;IAapE;;;;;;;;;OASG;IACH,sBAAsB,CAAC,aAAa,GAAE,MAAY,GAAG,iBAAiB;IAatE;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,CACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAYjB;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,0BAA0B;IA8DzE;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,CACpB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAyBjB;;;;;;;;;;;;;;;;;OAiBG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,eAAe;IA2DlB;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAcxD;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CACf,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,QAAQ,GACb,cAAc;IAuDjB;;;;;;;;;;;;OAYG;IACH,sBAAsB,CACpB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,cAAc,EAAE;IAMnB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CACV,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAUjB;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;CAajD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}
+{"version":3,"file":"BodyPartHealthSystem.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartHealthSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAA6B,MAAM,SAAS,CAAC;AAChE,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EAGf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,GAAE,oBAA+C;IAInE;;;;;;;;OAQG;IACH,2BAA2B,CAAC,SAAS,GAAE,MAAY,GAAG,cAAc;IAapE;;;;;;;;OAQG;IACH,sBAAsB,CAAC,aAAa,GAAE,MAAY,GAAG,iBAAiB;IAatE;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,CACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAYjB;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,0BAA0B;IA8DzE;;;;;;;;;;;;;;OAcG;IACH,sBAAsB,CACpB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAyBjB;;;;;;;;;;;;;;;;OAgBG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,eAAe;IA2DlB;;;;;;;;;;;OAWG;IACH,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAcxD;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CACf,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,QAAQ,GACb,cAAc;IAuDjB;;;;;;;;;;;OAWG;IACH,sBAAsB,CACpB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,cAAc,EAAE;IAMnB;;;;;;;;;;;;;;OAcG;IACH,YAAY,CACV,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,cAAc;IAUjB;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;CAajD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/lib/systems/bodypart/BodyPartHealthSystem.js

@@ -49,7 +49,6 @@ import { BODY_PART_EFFECT_CONSTANTS, BodyPart, DEFAULT_BODY_PART_CONFIG } from "
 * const effects = system.calculateBodyPartEffects(damaged);
 * ```
 * 
-* @public
 * @category Body Part System
 */
 var BodyPartHealthSystem = class {
@@ -65,7 +64,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Optional custom max health per part (default: 100)
 	* @returns Body part health structure with all parts at max HP
 	* 
-	* @public
 	*/
 	createDefaultBodyPartHealth(maxHealth = 100) {
 		return {
@@ -87,7 +85,6 @@ var BodyPartHealthSystem = class {
 	* @param baseMaxHealth - Base maximum health per part
 	* @returns Maximum health structure
 	* 
-	* @public
 	*/
 	createDefaultMaxHealth(baseMaxHealth = 100) {
 		return {
@@ -115,7 +112,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Optional maximum health limits
 	* @returns Updated body part health
 	* 
-	* @public
 	*/
 	applyDamageToBodyPart(current, bodyPart, damage, maxHealth) {
 		const newHealth = Math.max(0, current[bodyPart] - damage);
@@ -136,7 +132,6 @@ var BodyPartHealthSystem = class {
 	* @param bodyRegion - Hit location
 	* @returns Damage distribution configuration
 	* 
-	* @public
 	*/
 	getDamageDistribution(bodyRegion) {
 		switch (bodyRegion) {
@@ -246,7 +241,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Optional maximum health limits
 	* @returns Updated body part health
 	* 
-	* @public
 	*/
 	applyDistributedDamage(current, bodyRegion, totalDamage, maxHealth) {
 		const distribution = this.getDamageDistribution(bodyRegion);
@@ -271,7 +265,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Maximum health values
 	* @returns Combat capability effect multipliers
 	* 
-	* @public
 	*/
 	calculateBodyPartEffects(health, maxHealth) {
 		const max = maxHealth ?? this.createDefaultMaxHealth();
@@ -309,7 +302,6 @@ var BodyPartHealthSystem = class {
 	* @param health - Body part health
 	* @returns Aggregate health value (0-100)
 	* 
-	* @public
 	*/
 	calculateAggregateHealth(health) {
 		return (health.head + health.neck + health.torsoUpper + health.torsoLower + health.armLeft + health.armRight + health.legLeft + health.legRight) / 8;
@@ -327,7 +319,6 @@ var BodyPartHealthSystem = class {
 	* @param part - Body part to query
 	* @returns Status information for display
 	* 
-	* @public
 	*/
 	getBodyPartStatus(health, maxHealth, part) {
 		const current = health[part];
@@ -408,7 +399,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Maximum health values
 	* @returns Array of status information for all parts
 	* 
-	* @public
 	*/
 	getAllBodyPartStatuses(health, maxHealth) {
 		return Object.values(BodyPart).map((part) => this.getBodyPartStatus(health, maxHealth, part));
@@ -427,7 +417,6 @@ var BodyPartHealthSystem = class {
 	* @param maxHealth - Optional maximum health limits
 	* @returns Updated body part health
 	* 
-	* @public
 	*/
 	healBodyPart(current, bodyPart, healAmount, maxHealth) {
 		const max = maxHealth ?? this.createDefaultMaxHealth();
@@ -450,7 +439,6 @@ var BodyPartHealthSystem = class {
 	* @param health - Current body part health
 	* @returns Whether player is incapacitated
 	* 
-	* @public
 	*/
 	isIncapacitated(health) {
 		if (health.head <= 0) return true;
@@ -466,7 +454,6 @@ var BodyPartHealthSystem = class {
 * 
 * Provides global access to the body part health system throughout the game.
 * 
-* @public
 */
 var bodyPartHealthSystem = new BodyPartHealthSystem();
 //#endregion

package/lib/systems/bodypart/BodyPartHealthSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartHealthSystem.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartHealthSystem.ts"],"sourcesContent":["/**\n * Body Part Health System\n * \n * **Korean**: 신체부위 체력 시스템\n * \n * Manages body part-specific health tracking, damage distribution, and combat\n * capability effects. Implements realistic localized damage mechanics based on\n * Korean martial arts vital point targeting principles.\n * \n * ## System Features\n * \n * - Independent health tracking for 8 body parts\n * - Automatic combat capability penalties based on damage\n * - Damage distribution from hit locations to body parts\n * - UI-friendly status information generation\n * - Performance-optimized calculations\n * \n * @module systems/bodypart/BodyPartHealthSystem\n * @category Body Part System\n * @korean 신체부위체력시스템\n */\n\nimport { BodyRegion, KOREAN_COLORS, KoreanText } from \"@/types\";\nimport {\n  BodyPart,\n  BodyPartDamageDistribution,\n  BodyPartEffects,\n  BodyPartHealth,\n  BodyPartHealthConfig,\n  BodyPartMaxHealth,\n  BodyPartStatus,\n  BODY_PART_EFFECT_CONSTANTS,\n  DEFAULT_BODY_PART_CONFIG,\n} from \"./types\";\n\n/**\n * Body Part Health System class.\n * \n * **Korean**: 신체부위 체력 시스템 클래스\n * \n * Provides methods for managing body part health, calculating effects,\n * and distributing damage based on hit locations.\n * \n * @example\n * ```typescript\n * const system = new BodyPartHealthSystem();\n * \n * // Create initial body part health\n * const health = system.createDefaultBodyPartHealth();\n * \n * // Apply damage to head\n * const damaged = system.applyDamageToBodyPart(\n *   health,\n *   BodyPart.HEAD,\n *   25\n * );\n * \n * // Calculate combat effects\n * const effects = system.calculateBodyPartEffects(damaged);\n * ```\n * \n * @public\n * @category Body Part System\n */\nexport class BodyPartHealthSystem {\n  private config: BodyPartHealthConfig;\n\n  constructor(config: BodyPartHealthConfig = DEFAULT_BODY_PART_CONFIG) {\n    this.config = config;\n  }\n\n  /**\n   * Create default body part health with all parts at maximum.\n   * \n   * **Korean**: 기본 신체부위 체력 생성\n   * \n   * @param maxHealth - Optional custom max health per part (default: 100)\n   * @returns Body part health structure with all parts at max HP\n   * \n   * @public\n   */\n  createDefaultBodyPartHealth(maxHealth: number = 100): BodyPartHealth {\n    return {\n      head: maxHealth,\n      neck: maxHealth,\n      torsoUpper: maxHealth,\n      torsoLower: maxHealth,\n      armLeft: maxHealth,\n      armRight: maxHealth,\n      legLeft: maxHealth,\n      legRight: maxHealth,\n    };\n  }\n\n  /**\n   * Create default maximum health values for body parts.\n   * \n   * **Korean**: 기본 최대 체력 생성\n   * \n   * @param baseMaxHealth - Base maximum health per part\n   * @returns Maximum health structure\n   * \n   * @public\n   */\n  createDefaultMaxHealth(baseMaxHealth: number = 100): BodyPartMaxHealth {\n    return {\n      head: baseMaxHealth,\n      neck: baseMaxHealth,\n      torsoUpper: baseMaxHealth,\n      torsoLower: baseMaxHealth,\n      armLeft: baseMaxHealth,\n      armRight: baseMaxHealth,\n      legLeft: baseMaxHealth,\n      legRight: baseMaxHealth,\n    };\n  }\n\n  /**\n   * Apply damage to a specific body part.\n   * \n   * **Korean**: 신체부위 피해 적용\n   * \n   * Reduces health of the specified body part by the damage amount.\n   * Health is clamped to 0-maxHealth range.\n   * \n   * @param current - Current body part health\n   * @param bodyPart - Body part to damage\n   * @param damage - Damage amount to apply\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   * @public\n   */\n  applyDamageToBodyPart(\n    current: BodyPartHealth,\n    bodyPart: BodyPart,\n    damage: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const newHealth = Math.max(0, current[bodyPart] - damage);\n    const clampedHealth = maxHealth\n      ? Math.min(newHealth, maxHealth[bodyPart])\n      : newHealth;\n\n    return {\n      ...current,\n      [bodyPart]: clampedHealth,\n    };\n  }\n\n  /**\n   * Distribute damage across body parts based on hit location.\n   * \n   * **Korean**: 피해 분배\n   * \n   * Maps a BodyRegion hit location to primary and secondary body parts,\n   * distributing damage according to impact mechanics.\n   * \n   * @param bodyRegion - Hit location\n   * @returns Damage distribution configuration\n   * \n   * @public\n   */\n  getDamageDistribution(bodyRegion: BodyRegion): BodyPartDamageDistribution {\n    switch (bodyRegion) {\n      case BodyRegion.HEAD:\n        return {\n          primary: { part: BodyPart.HEAD, percentage: 0.9 },\n          secondary: [{ part: BodyPart.NECK, percentage: 0.1 }],\n        };\n\n      case BodyRegion.NECK:\n        return {\n          primary: { part: BodyPart.NECK, percentage: 0.8 },\n          secondary: [\n            { part: BodyPart.HEAD, percentage: 0.1 },\n            { part: BodyPart.TORSO_UPPER, percentage: 0.1 },\n          ],\n        };\n\n      case BodyRegion.TORSO:\n        return {\n          primary: { part: BodyPart.TORSO_UPPER, percentage: 0.6 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.4 }],\n        };\n\n      case BodyRegion.CORE:\n        return {\n          primary: { part: BodyPart.TORSO_LOWER, percentage: 0.7 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.3 }],\n        };\n\n      case BodyRegion.LEFT_ARM:\n        return {\n          primary: { part: BodyPart.ARM_LEFT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.RIGHT_ARM:\n        return {\n          primary: { part: BodyPart.ARM_RIGHT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.LEFT_LEG:\n        return {\n          primary: { part: BodyPart.LEG_LEFT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.RIGHT_LEG:\n        return {\n          primary: { part: BodyPart.LEG_RIGHT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.1 }],\n        };\n\n      default:\n        // Default to torso upper for unknown regions\n        return {\n          primary: { part: BodyPart.TORSO_UPPER, percentage: 1.0 },\n          secondary: [],\n        };\n    }\n  }\n\n  /**\n   * Apply distributed damage to body parts from a hit.\n   * \n   * **Korean**: 분산 피해 적용\n   * \n   * Takes total damage and distributes it across primary and secondary\n   * body parts based on the hit location.\n   * \n   * @param current - Current body part health\n   * @param bodyRegion - Hit location\n   * @param totalDamage - Total damage to distribute\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   * @public\n   */\n  applyDistributedDamage(\n    current: BodyPartHealth,\n    bodyRegion: BodyRegion,\n    totalDamage: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const distribution = this.getDamageDistribution(bodyRegion);\n    let updated = { ...current };\n\n    // Apply primary damage\n    updated = this.applyDamageToBodyPart(\n      updated,\n      distribution.primary.part,\n      totalDamage * distribution.primary.percentage,\n      maxHealth\n    );\n\n    // Apply secondary damage\n    for (const secondary of distribution.secondary) {\n      updated = this.applyDamageToBodyPart(\n        updated,\n        secondary.part,\n        totalDamage * secondary.percentage,\n        maxHealth\n      );\n    }\n\n    return updated;\n  }\n\n  /**\n   * Calculate combat capability effects from body part damage.\n   * \n   * **Korean**: 전투 능력 효과 계산\n   * \n   * Analyzes body part health and returns multipliers for various combat\n   * capabilities. Implements acceptance criteria:\n   * - Head <50%: Consciousness penalties\n   * - Torso <50%: Stamina regen -50%\n   * - Arms <50%: Attack damage -30%\n   * - Legs <50%: Movement speed -40%\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns Combat capability effect multipliers\n   * \n   * @public\n   */\n  calculateBodyPartEffects(\n    health: BodyPartHealth,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartEffects {\n    const max = maxHealth ?? this.createDefaultMaxHealth();\n\n    // Calculate head/neck effects on consciousness\n    const headPercentage = health.head / max.head;\n    const neckPercentage = health.neck / max.neck;\n    const minHeadNeck = Math.min(headPercentage, neckPercentage);\n    \n    let consciousnessModifier = 1.0;\n    if (minHeadNeck < BODY_PART_EFFECT_CONSTANTS.HEAD.CRITICAL_THRESHOLD) {\n      consciousnessModifier = BODY_PART_EFFECT_CONSTANTS.HEAD.CONSCIOUSNESS_PENALTY_AT_50;\n    }\n\n    // Calculate torso effects on stamina regeneration\n    const torsoUpperPercentage = health.torsoUpper / max.torsoUpper;\n    const torsoLowerPercentage = health.torsoLower / max.torsoLower;\n    const avgTorso = (torsoUpperPercentage + torsoLowerPercentage) / 2;\n    \n    let staminaRegenModifier = 1.0;\n    if (avgTorso < BODY_PART_EFFECT_CONSTANTS.TORSO.CRITICAL_THRESHOLD) {\n      staminaRegenModifier = BODY_PART_EFFECT_CONSTANTS.TORSO.STAMINA_REGEN_PENALTY_AT_50;\n    }\n\n    // Calculate arm effects on attack damage\n    const armLeftPercentage = health.armLeft / max.armLeft;\n    const armRightPercentage = health.armRight / max.armRight;\n    const avgArms = (armLeftPercentage + armRightPercentage) / 2;\n    \n    let attackDamageModifier = 1.0;\n    if (avgArms < BODY_PART_EFFECT_CONSTANTS.ARMS.CRITICAL_THRESHOLD) {\n      attackDamageModifier = BODY_PART_EFFECT_CONSTANTS.ARMS.ATTACK_DAMAGE_PENALTY_AT_50;\n    }\n\n    // Calculate leg effects on movement speed\n    const legLeftPercentage = health.legLeft / max.legLeft;\n    const legRightPercentage = health.legRight / max.legRight;\n    const avgLegs = (legLeftPercentage + legRightPercentage) / 2;\n    \n    let movementSpeedModifier = 1.0;\n    if (avgLegs < BODY_PART_EFFECT_CONSTANTS.LEGS.CRITICAL_THRESHOLD) {\n      movementSpeedModifier = BODY_PART_EFFECT_CONSTANTS.LEGS.MOVEMENT_SPEED_PENALTY_AT_50;\n    }\n\n    // Balance affected by torso and legs\n    const balanceModifier = Math.min(avgTorso, avgLegs);\n\n    // Technique accuracy affected by head and arms\n    const techniqueAccuracyModifier = Math.min(headPercentage, avgArms);\n\n    return {\n      consciousnessModifier,\n      staminaRegenModifier,\n      attackDamageModifier,\n      movementSpeedModifier,\n      balanceModifier,\n      techniqueAccuracyModifier,\n    };\n  }\n\n  /**\n   * Calculate aggregate health from body parts.\n   * \n   * **Korean**: 종합 체력 계산\n   * \n   * Computes overall health as average of all body part health values.\n   * This maintains backwards compatibility with single health bar systems.\n   * \n   * @param health - Body part health\n   * @returns Aggregate health value (0-100)\n   * \n   * @public\n   */\n  calculateAggregateHealth(health: BodyPartHealth): number {\n    const sum =\n      health.head +\n      health.neck +\n      health.torsoUpper +\n      health.torsoLower +\n      health.armLeft +\n      health.armRight +\n      health.legLeft +\n      health.legRight;\n\n    return sum / 8;\n  }\n\n  /**\n   * Get body part status for UI display.\n   * \n   * **Korean**: 신체부위 상태 조회\n   * \n   * Provides UI-friendly status information including color coding,\n   * status text, and critical/disabled flags.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param part - Body part to query\n   * @returns Status information for display\n   * \n   * @public\n   */\n  getBodyPartStatus(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    part: BodyPart\n  ): BodyPartStatus {\n    const current = health[part];\n    const max = maxHealth[part];\n    const percentage = current / max;\n\n    // Determine status and color\n    let status: KoreanText;\n    let color: number;\n    let critical: boolean;\n    let disabled: boolean;\n\n    if (percentage === 0) {\n      status = { korean: \"무력화\", english: \"Disabled\" };\n      color = KOREAN_COLORS.NEGATIVE_RED;\n      critical = true;\n      disabled = true;\n    } else if (percentage < this.config.criticalThreshold) {\n      status = { korean: \"치명적\", english: \"Critical\" };\n      color = KOREAN_COLORS.NEGATIVE_RED;\n      critical = true;\n      disabled = false;\n    } else if (percentage < this.config.severePenaltyThreshold) {\n      status = { korean: \"심각\", english: \"Severe\" };\n      color = KOREAN_COLORS.WARNING_ORANGE;\n      critical = false;\n      disabled = false;\n    } else if (percentage < this.config.majorPenaltyThreshold) {\n      status = { korean: \"중상\", english: \"Major\" };\n      color = KOREAN_COLORS.WARNING_YELLOW;\n      critical = false;\n      disabled = false;\n    } else if (percentage < this.config.minorPenaltyThreshold) {\n      status = { korean: \"경상\", english: \"Minor\" };\n      color = KOREAN_COLORS.HEALTH_FULL;\n      critical = false;\n      disabled = false;\n    } else {\n      status = { korean: \"정상\", english: \"Normal\" };\n      color = KOREAN_COLORS.HEALTH_FULL;\n      critical = false;\n      disabled = false;\n    }\n\n    return {\n      part,\n      health: current,\n      maxHealth: max,\n      percentage,\n      status,\n      color,\n      critical,\n      disabled,\n    };\n  }\n\n  /**\n   * Get all body part statuses for UI.\n   * \n   * **Korean**: 모든 신체부위 상태 조회\n   * \n   * Returns status information for all body parts in a single call.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns Array of status information for all parts\n   * \n   * @public\n   */\n  getAllBodyPartStatuses(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): BodyPartStatus[] {\n    return Object.values(BodyPart).map((part) =>\n      this.getBodyPartStatus(health, maxHealth, part)\n    );\n  }\n\n  /**\n   * Heal a specific body part.\n   * \n   * **Korean**: 신체부위 치유\n   * \n   * Increases health of the specified body part by the heal amount.\n   * Health is clamped to 0-maxHealth range.\n   * \n   * @param current - Current body part health\n   * @param bodyPart - Body part to heal\n   * @param healAmount - Amount of health to restore\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   * @public\n   */\n  healBodyPart(\n    current: BodyPartHealth,\n    bodyPart: BodyPart,\n    healAmount: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const max = maxHealth ?? this.createDefaultMaxHealth();\n    const newHealth = Math.min(max[bodyPart], current[bodyPart] + healAmount);\n\n    return {\n      ...current,\n      [bodyPart]: newHealth,\n    };\n  }\n\n  /**\n   * Check if player is incapacitated based on body part health.\n   * \n   * **Korean**: 무력화 상태 확인\n   * \n   * Player is incapacitated if:\n   * - Head is at 0 HP (unconscious)\n   * - Both legs are at 0 HP (cannot move)\n   * - Aggregate health below 10%\n   * \n   * @param health - Current body part health\n   * @returns Whether player is incapacitated\n   * \n   * @public\n   */\n  isIncapacitated(health: BodyPartHealth): boolean {\n    // Unconscious from head damage\n    if (health.head <= 0) return true;\n\n    // Cannot move from leg damage\n    if (health.legLeft <= 0 && health.legRight <= 0) return true;\n\n    // Aggregate health critical\n    const aggregate = this.calculateAggregateHealth(health);\n    if (aggregate < 10) return true;\n\n    return false;\n  }\n}\n\n/**\n * Singleton instance of Body Part Health System.\n * \n * **Korean**: 신체부위 체력 시스템 싱글톤\n * \n * Provides global access to the body part health system throughout the game.\n * \n * @public\n */\nexport const bodyPartHealthSystem = new BodyPartHealthSystem();\n"],"mappings":"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"}
+{"version":3,"file":"BodyPartHealthSystem.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartHealthSystem.ts"],"sourcesContent":["/**\n * Body Part Health System\n * \n * **Korean**: 신체부위 체력 시스템\n * \n * Manages body part-specific health tracking, damage distribution, and combat\n * capability effects. Implements realistic localized damage mechanics based on\n * Korean martial arts vital point targeting principles.\n * \n * ## System Features\n * \n * - Independent health tracking for 8 body parts\n * - Automatic combat capability penalties based on damage\n * - Damage distribution from hit locations to body parts\n * - UI-friendly status information generation\n * - Performance-optimized calculations\n * \n * @module systems/bodypart/BodyPartHealthSystem\n * @category Body Part System\n * @korean 신체부위체력시스템\n */\n\nimport { BodyRegion, KOREAN_COLORS, KoreanText } from \"@/types\";\nimport {\n  BodyPart,\n  BodyPartDamageDistribution,\n  BodyPartEffects,\n  BodyPartHealth,\n  BodyPartHealthConfig,\n  BodyPartMaxHealth,\n  BodyPartStatus,\n  BODY_PART_EFFECT_CONSTANTS,\n  DEFAULT_BODY_PART_CONFIG,\n} from \"./types\";\n\n/**\n * Body Part Health System class.\n * \n * **Korean**: 신체부위 체력 시스템 클래스\n * \n * Provides methods for managing body part health, calculating effects,\n * and distributing damage based on hit locations.\n * \n * @example\n * ```typescript\n * const system = new BodyPartHealthSystem();\n * \n * // Create initial body part health\n * const health = system.createDefaultBodyPartHealth();\n * \n * // Apply damage to head\n * const damaged = system.applyDamageToBodyPart(\n *   health,\n *   BodyPart.HEAD,\n *   25\n * );\n * \n * // Calculate combat effects\n * const effects = system.calculateBodyPartEffects(damaged);\n * ```\n * \n * @category Body Part System\n */\nexport class BodyPartHealthSystem {\n  private config: BodyPartHealthConfig;\n\n  constructor(config: BodyPartHealthConfig = DEFAULT_BODY_PART_CONFIG) {\n    this.config = config;\n  }\n\n  /**\n   * Create default body part health with all parts at maximum.\n   * \n   * **Korean**: 기본 신체부위 체력 생성\n   * \n   * @param maxHealth - Optional custom max health per part (default: 100)\n   * @returns Body part health structure with all parts at max HP\n   * \n   */\n  createDefaultBodyPartHealth(maxHealth: number = 100): BodyPartHealth {\n    return {\n      head: maxHealth,\n      neck: maxHealth,\n      torsoUpper: maxHealth,\n      torsoLower: maxHealth,\n      armLeft: maxHealth,\n      armRight: maxHealth,\n      legLeft: maxHealth,\n      legRight: maxHealth,\n    };\n  }\n\n  /**\n   * Create default maximum health values for body parts.\n   * \n   * **Korean**: 기본 최대 체력 생성\n   * \n   * @param baseMaxHealth - Base maximum health per part\n   * @returns Maximum health structure\n   * \n   */\n  createDefaultMaxHealth(baseMaxHealth: number = 100): BodyPartMaxHealth {\n    return {\n      head: baseMaxHealth,\n      neck: baseMaxHealth,\n      torsoUpper: baseMaxHealth,\n      torsoLower: baseMaxHealth,\n      armLeft: baseMaxHealth,\n      armRight: baseMaxHealth,\n      legLeft: baseMaxHealth,\n      legRight: baseMaxHealth,\n    };\n  }\n\n  /**\n   * Apply damage to a specific body part.\n   * \n   * **Korean**: 신체부위 피해 적용\n   * \n   * Reduces health of the specified body part by the damage amount.\n   * Health is clamped to 0-maxHealth range.\n   * \n   * @param current - Current body part health\n   * @param bodyPart - Body part to damage\n   * @param damage - Damage amount to apply\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   */\n  applyDamageToBodyPart(\n    current: BodyPartHealth,\n    bodyPart: BodyPart,\n    damage: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const newHealth = Math.max(0, current[bodyPart] - damage);\n    const clampedHealth = maxHealth\n      ? Math.min(newHealth, maxHealth[bodyPart])\n      : newHealth;\n\n    return {\n      ...current,\n      [bodyPart]: clampedHealth,\n    };\n  }\n\n  /**\n   * Distribute damage across body parts based on hit location.\n   * \n   * **Korean**: 피해 분배\n   * \n   * Maps a BodyRegion hit location to primary and secondary body parts,\n   * distributing damage according to impact mechanics.\n   * \n   * @param bodyRegion - Hit location\n   * @returns Damage distribution configuration\n   * \n   */\n  getDamageDistribution(bodyRegion: BodyRegion): BodyPartDamageDistribution {\n    switch (bodyRegion) {\n      case BodyRegion.HEAD:\n        return {\n          primary: { part: BodyPart.HEAD, percentage: 0.9 },\n          secondary: [{ part: BodyPart.NECK, percentage: 0.1 }],\n        };\n\n      case BodyRegion.NECK:\n        return {\n          primary: { part: BodyPart.NECK, percentage: 0.8 },\n          secondary: [\n            { part: BodyPart.HEAD, percentage: 0.1 },\n            { part: BodyPart.TORSO_UPPER, percentage: 0.1 },\n          ],\n        };\n\n      case BodyRegion.TORSO:\n        return {\n          primary: { part: BodyPart.TORSO_UPPER, percentage: 0.6 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.4 }],\n        };\n\n      case BodyRegion.CORE:\n        return {\n          primary: { part: BodyPart.TORSO_LOWER, percentage: 0.7 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.3 }],\n        };\n\n      case BodyRegion.LEFT_ARM:\n        return {\n          primary: { part: BodyPart.ARM_LEFT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.RIGHT_ARM:\n        return {\n          primary: { part: BodyPart.ARM_RIGHT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_UPPER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.LEFT_LEG:\n        return {\n          primary: { part: BodyPart.LEG_LEFT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.1 }],\n        };\n\n      case BodyRegion.RIGHT_LEG:\n        return {\n          primary: { part: BodyPart.LEG_RIGHT, percentage: 0.9 },\n          secondary: [{ part: BodyPart.TORSO_LOWER, percentage: 0.1 }],\n        };\n\n      default:\n        // Default to torso upper for unknown regions\n        return {\n          primary: { part: BodyPart.TORSO_UPPER, percentage: 1.0 },\n          secondary: [],\n        };\n    }\n  }\n\n  /**\n   * Apply distributed damage to body parts from a hit.\n   * \n   * **Korean**: 분산 피해 적용\n   * \n   * Takes total damage and distributes it across primary and secondary\n   * body parts based on the hit location.\n   * \n   * @param current - Current body part health\n   * @param bodyRegion - Hit location\n   * @param totalDamage - Total damage to distribute\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   */\n  applyDistributedDamage(\n    current: BodyPartHealth,\n    bodyRegion: BodyRegion,\n    totalDamage: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const distribution = this.getDamageDistribution(bodyRegion);\n    let updated = { ...current };\n\n    // Apply primary damage\n    updated = this.applyDamageToBodyPart(\n      updated,\n      distribution.primary.part,\n      totalDamage * distribution.primary.percentage,\n      maxHealth\n    );\n\n    // Apply secondary damage\n    for (const secondary of distribution.secondary) {\n      updated = this.applyDamageToBodyPart(\n        updated,\n        secondary.part,\n        totalDamage * secondary.percentage,\n        maxHealth\n      );\n    }\n\n    return updated;\n  }\n\n  /**\n   * Calculate combat capability effects from body part damage.\n   * \n   * **Korean**: 전투 능력 효과 계산\n   * \n   * Analyzes body part health and returns multipliers for various combat\n   * capabilities. Implements acceptance criteria:\n   * - Head <50%: Consciousness penalties\n   * - Torso <50%: Stamina regen -50%\n   * - Arms <50%: Attack damage -30%\n   * - Legs <50%: Movement speed -40%\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns Combat capability effect multipliers\n   * \n   */\n  calculateBodyPartEffects(\n    health: BodyPartHealth,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartEffects {\n    const max = maxHealth ?? this.createDefaultMaxHealth();\n\n    // Calculate head/neck effects on consciousness\n    const headPercentage = health.head / max.head;\n    const neckPercentage = health.neck / max.neck;\n    const minHeadNeck = Math.min(headPercentage, neckPercentage);\n    \n    let consciousnessModifier = 1.0;\n    if (minHeadNeck < BODY_PART_EFFECT_CONSTANTS.HEAD.CRITICAL_THRESHOLD) {\n      consciousnessModifier = BODY_PART_EFFECT_CONSTANTS.HEAD.CONSCIOUSNESS_PENALTY_AT_50;\n    }\n\n    // Calculate torso effects on stamina regeneration\n    const torsoUpperPercentage = health.torsoUpper / max.torsoUpper;\n    const torsoLowerPercentage = health.torsoLower / max.torsoLower;\n    const avgTorso = (torsoUpperPercentage + torsoLowerPercentage) / 2;\n    \n    let staminaRegenModifier = 1.0;\n    if (avgTorso < BODY_PART_EFFECT_CONSTANTS.TORSO.CRITICAL_THRESHOLD) {\n      staminaRegenModifier = BODY_PART_EFFECT_CONSTANTS.TORSO.STAMINA_REGEN_PENALTY_AT_50;\n    }\n\n    // Calculate arm effects on attack damage\n    const armLeftPercentage = health.armLeft / max.armLeft;\n    const armRightPercentage = health.armRight / max.armRight;\n    const avgArms = (armLeftPercentage + armRightPercentage) / 2;\n    \n    let attackDamageModifier = 1.0;\n    if (avgArms < BODY_PART_EFFECT_CONSTANTS.ARMS.CRITICAL_THRESHOLD) {\n      attackDamageModifier = BODY_PART_EFFECT_CONSTANTS.ARMS.ATTACK_DAMAGE_PENALTY_AT_50;\n    }\n\n    // Calculate leg effects on movement speed\n    const legLeftPercentage = health.legLeft / max.legLeft;\n    const legRightPercentage = health.legRight / max.legRight;\n    const avgLegs = (legLeftPercentage + legRightPercentage) / 2;\n    \n    let movementSpeedModifier = 1.0;\n    if (avgLegs < BODY_PART_EFFECT_CONSTANTS.LEGS.CRITICAL_THRESHOLD) {\n      movementSpeedModifier = BODY_PART_EFFECT_CONSTANTS.LEGS.MOVEMENT_SPEED_PENALTY_AT_50;\n    }\n\n    // Balance affected by torso and legs\n    const balanceModifier = Math.min(avgTorso, avgLegs);\n\n    // Technique accuracy affected by head and arms\n    const techniqueAccuracyModifier = Math.min(headPercentage, avgArms);\n\n    return {\n      consciousnessModifier,\n      staminaRegenModifier,\n      attackDamageModifier,\n      movementSpeedModifier,\n      balanceModifier,\n      techniqueAccuracyModifier,\n    };\n  }\n\n  /**\n   * Calculate aggregate health from body parts.\n   * \n   * **Korean**: 종합 체력 계산\n   * \n   * Computes overall health as average of all body part health values.\n   * This maintains backwards compatibility with single health bar systems.\n   * \n   * @param health - Body part health\n   * @returns Aggregate health value (0-100)\n   * \n   */\n  calculateAggregateHealth(health: BodyPartHealth): number {\n    const sum =\n      health.head +\n      health.neck +\n      health.torsoUpper +\n      health.torsoLower +\n      health.armLeft +\n      health.armRight +\n      health.legLeft +\n      health.legRight;\n\n    return sum / 8;\n  }\n\n  /**\n   * Get body part status for UI display.\n   * \n   * **Korean**: 신체부위 상태 조회\n   * \n   * Provides UI-friendly status information including color coding,\n   * status text, and critical/disabled flags.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param part - Body part to query\n   * @returns Status information for display\n   * \n   */\n  getBodyPartStatus(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    part: BodyPart\n  ): BodyPartStatus {\n    const current = health[part];\n    const max = maxHealth[part];\n    const percentage = current / max;\n\n    // Determine status and color\n    let status: KoreanText;\n    let color: number;\n    let critical: boolean;\n    let disabled: boolean;\n\n    if (percentage === 0) {\n      status = { korean: \"무력화\", english: \"Disabled\" };\n      color = KOREAN_COLORS.NEGATIVE_RED;\n      critical = true;\n      disabled = true;\n    } else if (percentage < this.config.criticalThreshold) {\n      status = { korean: \"치명적\", english: \"Critical\" };\n      color = KOREAN_COLORS.NEGATIVE_RED;\n      critical = true;\n      disabled = false;\n    } else if (percentage < this.config.severePenaltyThreshold) {\n      status = { korean: \"심각\", english: \"Severe\" };\n      color = KOREAN_COLORS.WARNING_ORANGE;\n      critical = false;\n      disabled = false;\n    } else if (percentage < this.config.majorPenaltyThreshold) {\n      status = { korean: \"중상\", english: \"Major\" };\n      color = KOREAN_COLORS.WARNING_YELLOW;\n      critical = false;\n      disabled = false;\n    } else if (percentage < this.config.minorPenaltyThreshold) {\n      status = { korean: \"경상\", english: \"Minor\" };\n      color = KOREAN_COLORS.HEALTH_FULL;\n      critical = false;\n      disabled = false;\n    } else {\n      status = { korean: \"정상\", english: \"Normal\" };\n      color = KOREAN_COLORS.HEALTH_FULL;\n      critical = false;\n      disabled = false;\n    }\n\n    return {\n      part,\n      health: current,\n      maxHealth: max,\n      percentage,\n      status,\n      color,\n      critical,\n      disabled,\n    };\n  }\n\n  /**\n   * Get all body part statuses for UI.\n   * \n   * **Korean**: 모든 신체부위 상태 조회\n   * \n   * Returns status information for all body parts in a single call.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns Array of status information for all parts\n   * \n   */\n  getAllBodyPartStatuses(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): BodyPartStatus[] {\n    return Object.values(BodyPart).map((part) =>\n      this.getBodyPartStatus(health, maxHealth, part)\n    );\n  }\n\n  /**\n   * Heal a specific body part.\n   * \n   * **Korean**: 신체부위 치유\n   * \n   * Increases health of the specified body part by the heal amount.\n   * Health is clamped to 0-maxHealth range.\n   * \n   * @param current - Current body part health\n   * @param bodyPart - Body part to heal\n   * @param healAmount - Amount of health to restore\n   * @param maxHealth - Optional maximum health limits\n   * @returns Updated body part health\n   * \n   */\n  healBodyPart(\n    current: BodyPartHealth,\n    bodyPart: BodyPart,\n    healAmount: number,\n    maxHealth?: BodyPartMaxHealth\n  ): BodyPartHealth {\n    const max = maxHealth ?? this.createDefaultMaxHealth();\n    const newHealth = Math.min(max[bodyPart], current[bodyPart] + healAmount);\n\n    return {\n      ...current,\n      [bodyPart]: newHealth,\n    };\n  }\n\n  /**\n   * Check if player is incapacitated based on body part health.\n   * \n   * **Korean**: 무력화 상태 확인\n   * \n   * Player is incapacitated if:\n   * - Head is at 0 HP (unconscious)\n   * - Both legs are at 0 HP (cannot move)\n   * - Aggregate health below 10%\n   * \n   * @param health - Current body part health\n   * @returns Whether player is incapacitated\n   * \n   */\n  isIncapacitated(health: BodyPartHealth): boolean {\n    // Unconscious from head damage\n    if (health.head <= 0) return true;\n\n    // Cannot move from leg damage\n    if (health.legLeft <= 0 && health.legRight <= 0) return true;\n\n    // Aggregate health critical\n    const aggregate = this.calculateAggregateHealth(health);\n    if (aggregate < 10) return true;\n\n    return false;\n  }\n}\n\n/**\n * Singleton instance of Body Part Health System.\n * \n * **Korean**: 신체부위 체력 시스템 싱글톤\n * \n * Provides global access to the body part health system throughout the game.\n * \n */\nexport const bodyPartHealthSystem = new BodyPartHealthSystem();\n"],"mappings":"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"}

package/lib/systems/bodypart/BodyPartPositionMapping.d.ts

@@ -45,7 +45,6 @@ export declare const CHARACTER_DIMENSIONS: {
  * @param bodyPart - Body part to get position for
  * @returns 3D position vector
  *
- * @public
  */
 export declare function getBodyPartPosition(bodyPart: BodyPart): THREE.Vector3;
 /**
@@ -56,7 +55,6 @@ export declare function getBodyPartPosition(bodyPart: BodyPart): THREE.Vector3;
  * @param bodyRegion - Body region to get position for
  * @returns 3D position vector
  *
- * @public
  */
 export declare function getBodyRegionPosition(bodyRegion: BodyRegion): THREE.Vector3;
 /**
@@ -67,7 +65,6 @@ export declare function getBodyRegionPosition(bodyRegion: BodyRegion): THREE.Vec
  * @param bodyRegion - Body region to map
  * @returns Corresponding body part
  *
- * @public
  */
 export declare function mapBodyRegionToBodyPart(bodyRegion: BodyRegion): BodyPart;
 /**
@@ -82,7 +79,6 @@ export declare function mapBodyRegionToBodyPart(bodyRegion: BodyRegion): BodyPar
  * @param maxOffset - Maximum offset in any direction (default: 0.1)
  * @returns New position with random offset
  *
- * @public
  */
 export declare function addRandomOffset(basePosition: THREE.Vector3, maxOffset?: number): THREE.Vector3;
 /**
@@ -97,7 +93,6 @@ export declare function addRandomOffset(basePosition: THREE.Vector3, maxOffset?:
  * @param maxOffset - Maximum offset for randomization
  * @returns Position with random offset
  *
- * @public
  */
 export declare function getInjuryPositionWithOffset(bodyRegion: BodyRegion, maxOffset?: number): THREE.Vector3;
 /**
@@ -110,7 +105,6 @@ export declare function getInjuryPositionWithOffset(bodyRegion: BodyRegion, maxO
  * @param tolerance - Distance tolerance (default: 0.3)
  * @returns Whether position is within body part bounds
  *
- * @public
  */
 export declare function isPositionInBodyPart(position: THREE.Vector3, bodyPart: BodyPart, tolerance?: number): boolean;
 //# sourceMappingURL=BodyPartPositionMapping.d.ts.map

package/lib/systems/bodypart/BodyPartPositionMapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartPositionMapping.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartPositionMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B,qCAAqC;;IAErC,yBAAyB;;IAEzB,mBAAmB;;IAEnB,iBAAiB;;IAEjB,iBAAiB;;IAEjB,kBAAkB;;CAEV,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,OAAO,CAsCrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,OAAO,CAwC3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CA8BxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,KAAK,CAAC,OAAO,EAC3B,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC,OAAO,CAQf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC,OAAO,CAGf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAIT"}
+{"version":3,"file":"BodyPartPositionMapping.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/BodyPartPositionMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B,qCAAqC;;IAErC,yBAAyB;;IAEzB,mBAAmB;;IAEnB,iBAAiB;;IAEjB,iBAAiB;;IAEjB,kBAAkB;;CAEV,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,OAAO,CAsCrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,OAAO,CAwC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CA8BxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,KAAK,CAAC,OAAO,EAC3B,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC,OAAO,CAQf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC,OAAO,CAGf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAIT"}

package/lib/systems/bodypart/BodyPartPositionMapping.js

@@ -46,7 +46,6 @@ var CHARACTER_DIMENSIONS = {
 * @param bodyPart - Body part to get position for
 * @returns 3D position vector
 * 
-* @public
 */
 function getBodyPartPosition(bodyPart) {
 	const headY = CHARACTER_DIMENSIONS.HEIGHT - CHARACTER_DIMENSIONS.HEAD_HEIGHT / 2;
@@ -75,7 +74,6 @@ function getBodyPartPosition(bodyPart) {
 * @param bodyRegion - Body region to get position for
 * @returns 3D position vector
 * 
-* @public
 */
 function getBodyRegionPosition(bodyRegion) {
 	const { HEIGHT, LEG_LENGTH, SHOULDER_WIDTH } = CHARACTER_DIMENSIONS;
@@ -105,7 +103,6 @@ function getBodyRegionPosition(bodyRegion) {
 * @param bodyRegion - Body region to map
 * @returns Corresponding body part
 * 
-* @public
 */
 function mapBodyRegionToBodyPart(bodyRegion) {
 	switch (bodyRegion) {
@@ -132,7 +129,6 @@ function mapBodyRegionToBodyPart(bodyRegion) {
 * @param maxOffset - Maximum offset in any direction (default: 0.1)
 * @returns New position with random offset
 * 
-* @public
 */
 function addRandomOffset(basePosition, maxOffset = .1) {
 	const offset = new THREE.Vector3((Math.random() - .5) * maxOffset * 2, (Math.random() - .5) * maxOffset * 2, (Math.random() - .5) * maxOffset * 2);
@@ -150,7 +146,6 @@ function addRandomOffset(basePosition, maxOffset = .1) {
 * @param maxOffset - Maximum offset for randomization
 * @returns Position with random offset
 * 
-* @public
 */
 function getInjuryPositionWithOffset(bodyRegion, maxOffset = .1) {
 	return addRandomOffset(getBodyRegionPosition(bodyRegion), maxOffset);
@@ -165,7 +160,6 @@ function getInjuryPositionWithOffset(bodyRegion, maxOffset = .1) {
 * @param tolerance - Distance tolerance (default: 0.3)
 * @returns Whether position is within body part bounds
 * 
-* @public
 */
 function isPositionInBodyPart(position, bodyPart, tolerance = .3) {
 	const partPosition = getBodyPartPosition(bodyPart);

package/lib/systems/bodypart/BodyPartPositionMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"BodyPartPositionMapping.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartPositionMapping.ts"],"sourcesContent":["/**\n * Body Part Position Mapping Utilities\n * \n * **Korean**: 신체 부위 위치 매핑 유틸리티\n * \n * Maps body regions and body parts to 3D positions on character models\n * for accurate trauma visualization placement.\n * \n * @module systems/bodypart/BodyPartPositionMapping\n * @category Body Part System\n * @korean 신체부위위치매핑\n */\n\nimport * as THREE from \"three\";\nimport { BodyPart } from \"./types\";\nimport { BodyRegion } from \"../../types/common\";\n\n/**\n * Standard character model dimensions.\n * \n * Based on average human proportions scaled for game character.\n * Character center is at [0, 0, 0], standing upright.\n */\nexport const CHARACTER_DIMENSIONS = {\n  /** Total height from feet to head */\n  HEIGHT: 2.0,\n  /** Width at shoulders */\n  SHOULDER_WIDTH: 0.6,\n  /** Torso height */\n  TORSO_HEIGHT: 0.8,\n  /** Leg length */\n  LEG_LENGTH: 1.0,\n  /** Arm length */\n  ARM_LENGTH: 0.7,\n  /** Head height */\n  HEAD_HEIGHT: 0.3,\n} as const;\n\n/**\n * Get 3D position for a body part on character model.\n * \n * **Korean**: 신체 부위 3D 위치 가져오기\n * \n * Returns center position of the body part relative to character origin.\n * Character is centered at [0, 0, 0] standing upright.\n * Positions are calculated from CHARACTER_DIMENSIONS for consistency.\n * \n * @param bodyPart - Body part to get position for\n * @returns 3D position vector\n * \n * @public\n */\nexport function getBodyPartPosition(bodyPart: BodyPart): THREE.Vector3 {\n  // Calculate positions from CHARACTER_DIMENSIONS\n  const headY = CHARACTER_DIMENSIONS.HEIGHT - CHARACTER_DIMENSIONS.HEAD_HEIGHT / 2;\n  const neckY = CHARACTER_DIMENSIONS.HEIGHT - CHARACTER_DIMENSIONS.HEAD_HEIGHT;\n  const torsoTop = neckY - CHARACTER_DIMENSIONS.TORSO_HEIGHT / 3;\n  const torsoBottom = neckY - (2 * CHARACTER_DIMENSIONS.TORSO_HEIGHT) / 3;\n  const armY = neckY - CHARACTER_DIMENSIONS.TORSO_HEIGHT / 3;\n  const legY = CHARACTER_DIMENSIONS.LEG_LENGTH / 2;\n  \n  switch (bodyPart) {\n    case BodyPart.HEAD:\n      return new THREE.Vector3(0, headY, 0);\n\n    case BodyPart.NECK:\n      return new THREE.Vector3(0, neckY, 0);\n\n    case BodyPart.TORSO_UPPER:\n      return new THREE.Vector3(0, torsoTop, 0);\n\n    case BodyPart.TORSO_LOWER:\n      return new THREE.Vector3(0, torsoBottom, 0);\n\n    case BodyPart.ARM_LEFT:\n      return new THREE.Vector3(-CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyPart.ARM_RIGHT:\n      return new THREE.Vector3(CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyPart.LEG_LEFT:\n      return new THREE.Vector3(-CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 4, legY, 0);\n\n    case BodyPart.LEG_RIGHT:\n      return new THREE.Vector3(CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 4, legY, 0);\n\n    default:\n      // Default to torso center\n      return new THREE.Vector3(0, CHARACTER_DIMENSIONS.HEIGHT / 2, 0);\n  }\n}\n\n/**\n * Get 3D position for a body region on character model.\n * \n * **Korean**: 신체 영역 3D 위치 가져오기\n * \n * @param bodyRegion - Body region to get position for\n * @returns 3D position vector\n * \n * @public\n */\nexport function getBodyRegionPosition(bodyRegion: BodyRegion): THREE.Vector3 {\n  // Calculate positions based on CHARACTER_DIMENSIONS for single source of truth\n  const { HEIGHT, LEG_LENGTH, SHOULDER_WIDTH } = CHARACTER_DIMENSIONS;\n  \n  const headY = HEIGHT * 0.9; // 1.8 for HEIGHT 2.0\n  const neckY = HEIGHT * 0.8; // 1.6 for HEIGHT 2.0\n  const torsoY = HEIGHT * 0.6; // 1.2 for HEIGHT 2.0\n  const coreY = HEIGHT * 0.45; // 0.9 for HEIGHT 2.0\n  const armY = torsoY; // Arms at torso level\n  const legY = LEG_LENGTH * 0.4; // 0.4 for LEG_LENGTH 1.0\n\n  switch (bodyRegion) {\n    case BodyRegion.HEAD:\n      return new THREE.Vector3(0, headY, 0);\n\n    case BodyRegion.NECK:\n      return new THREE.Vector3(0, neckY, 0);\n\n    case BodyRegion.TORSO:\n      return new THREE.Vector3(0, torsoY, 0);\n\n    case BodyRegion.CORE:\n      return new THREE.Vector3(0, coreY, 0);\n\n    case BodyRegion.LEFT_ARM:\n      return new THREE.Vector3(-SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyRegion.RIGHT_ARM:\n      return new THREE.Vector3(SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyRegion.LEFT_LEG:\n      return new THREE.Vector3(-SHOULDER_WIDTH * 0.25, legY, 0);\n\n    case BodyRegion.RIGHT_LEG:\n      return new THREE.Vector3(SHOULDER_WIDTH * 0.25, legY, 0);\n\n    default:\n      // Default to torso center\n      return new THREE.Vector3(0, torsoY, 0);\n  }\n}\n\n/**\n * Map BodyRegion to corresponding BodyPart.\n * \n * **Korean**: 신체 영역을 신체 부위로 매핑\n * \n * @param bodyRegion - Body region to map\n * @returns Corresponding body part\n * \n * @public\n */\nexport function mapBodyRegionToBodyPart(bodyRegion: BodyRegion): BodyPart {\n  switch (bodyRegion) {\n    case BodyRegion.HEAD:\n      return BodyPart.HEAD;\n\n    case BodyRegion.NECK:\n      return BodyPart.NECK;\n\n    case BodyRegion.TORSO:\n      return BodyPart.TORSO_UPPER;\n\n    case BodyRegion.CORE:\n      return BodyPart.TORSO_LOWER;\n\n    case BodyRegion.LEFT_ARM:\n      return BodyPart.ARM_LEFT;\n\n    case BodyRegion.RIGHT_ARM:\n      return BodyPart.ARM_RIGHT;\n\n    case BodyRegion.LEFT_LEG:\n      return BodyPart.LEG_LEFT;\n\n    case BodyRegion.RIGHT_LEG:\n      return BodyPart.LEG_RIGHT;\n\n    default:\n      // Default to upper torso\n      return BodyPart.TORSO_UPPER;\n  }\n}\n\n/**\n * Add random offset to position for varied injury placement.\n * \n * **Korean**: 부상 위치에 무작위 오프셋 추가\n * \n * Adds slight randomness to injury positions to avoid exact overlap\n * and create more realistic trauma distribution.\n * \n * @param basePosition - Base position to offset from\n * @param maxOffset - Maximum offset in any direction (default: 0.1)\n * @returns New position with random offset\n * \n * @public\n */\nexport function addRandomOffset(\n  basePosition: THREE.Vector3,\n  maxOffset: number = 0.1\n): THREE.Vector3 {\n  const offset = new THREE.Vector3(\n    (Math.random() - 0.5) * maxOffset * 2,\n    (Math.random() - 0.5) * maxOffset * 2,\n    (Math.random() - 0.5) * maxOffset * 2\n  );\n\n  return basePosition.clone().add(offset);\n}\n\n/**\n * Get injury position with slight randomization.\n * \n * **Korean**: 무작위 오프셋이 포함된 부상 위치 가져오기\n * \n * Convenience function that combines region-to-position mapping\n * with random offset for natural injury placement.\n * \n * @param bodyRegion - Body region that was hit\n * @param maxOffset - Maximum offset for randomization\n * @returns Position with random offset\n * \n * @public\n */\nexport function getInjuryPositionWithOffset(\n  bodyRegion: BodyRegion,\n  maxOffset: number = 0.1\n): THREE.Vector3 {\n  const basePosition = getBodyRegionPosition(bodyRegion);\n  return addRandomOffset(basePosition, maxOffset);\n}\n\n/**\n * Check if position is within body part bounds.\n * \n * **Korean**: 위치가 신체 부위 경계 내에 있는지 확인\n * \n * @param position - Position to check\n * @param bodyPart - Body part to check against\n * @param tolerance - Distance tolerance (default: 0.3)\n * @returns Whether position is within body part bounds\n * \n * @public\n */\nexport function isPositionInBodyPart(\n  position: THREE.Vector3,\n  bodyPart: BodyPart,\n  tolerance: number = 0.3\n): boolean {\n  const partPosition = getBodyPartPosition(bodyPart);\n  const distance = position.distanceTo(partPosition);\n  return distance <= tolerance;\n}\n"],"mappings":"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"}
+{"version":3,"file":"BodyPartPositionMapping.js","names":[],"sources":["../../../src/systems/bodypart/BodyPartPositionMapping.ts"],"sourcesContent":["/**\n * Body Part Position Mapping Utilities\n * \n * **Korean**: 신체 부위 위치 매핑 유틸리티\n * \n * Maps body regions and body parts to 3D positions on character models\n * for accurate trauma visualization placement.\n * \n * @module systems/bodypart/BodyPartPositionMapping\n * @category Body Part System\n * @korean 신체부위위치매핑\n */\n\nimport * as THREE from \"three\";\nimport { BodyPart } from \"./types\";\nimport { BodyRegion } from \"../../types/common\";\n\n/**\n * Standard character model dimensions.\n * \n * Based on average human proportions scaled for game character.\n * Character center is at [0, 0, 0], standing upright.\n */\nexport const CHARACTER_DIMENSIONS = {\n  /** Total height from feet to head */\n  HEIGHT: 2.0,\n  /** Width at shoulders */\n  SHOULDER_WIDTH: 0.6,\n  /** Torso height */\n  TORSO_HEIGHT: 0.8,\n  /** Leg length */\n  LEG_LENGTH: 1.0,\n  /** Arm length */\n  ARM_LENGTH: 0.7,\n  /** Head height */\n  HEAD_HEIGHT: 0.3,\n} as const;\n\n/**\n * Get 3D position for a body part on character model.\n * \n * **Korean**: 신체 부위 3D 위치 가져오기\n * \n * Returns center position of the body part relative to character origin.\n * Character is centered at [0, 0, 0] standing upright.\n * Positions are calculated from CHARACTER_DIMENSIONS for consistency.\n * \n * @param bodyPart - Body part to get position for\n * @returns 3D position vector\n * \n */\nexport function getBodyPartPosition(bodyPart: BodyPart): THREE.Vector3 {\n  // Calculate positions from CHARACTER_DIMENSIONS\n  const headY = CHARACTER_DIMENSIONS.HEIGHT - CHARACTER_DIMENSIONS.HEAD_HEIGHT / 2;\n  const neckY = CHARACTER_DIMENSIONS.HEIGHT - CHARACTER_DIMENSIONS.HEAD_HEIGHT;\n  const torsoTop = neckY - CHARACTER_DIMENSIONS.TORSO_HEIGHT / 3;\n  const torsoBottom = neckY - (2 * CHARACTER_DIMENSIONS.TORSO_HEIGHT) / 3;\n  const armY = neckY - CHARACTER_DIMENSIONS.TORSO_HEIGHT / 3;\n  const legY = CHARACTER_DIMENSIONS.LEG_LENGTH / 2;\n  \n  switch (bodyPart) {\n    case BodyPart.HEAD:\n      return new THREE.Vector3(0, headY, 0);\n\n    case BodyPart.NECK:\n      return new THREE.Vector3(0, neckY, 0);\n\n    case BodyPart.TORSO_UPPER:\n      return new THREE.Vector3(0, torsoTop, 0);\n\n    case BodyPart.TORSO_LOWER:\n      return new THREE.Vector3(0, torsoBottom, 0);\n\n    case BodyPart.ARM_LEFT:\n      return new THREE.Vector3(-CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyPart.ARM_RIGHT:\n      return new THREE.Vector3(CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyPart.LEG_LEFT:\n      return new THREE.Vector3(-CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 4, legY, 0);\n\n    case BodyPart.LEG_RIGHT:\n      return new THREE.Vector3(CHARACTER_DIMENSIONS.SHOULDER_WIDTH / 4, legY, 0);\n\n    default:\n      // Default to torso center\n      return new THREE.Vector3(0, CHARACTER_DIMENSIONS.HEIGHT / 2, 0);\n  }\n}\n\n/**\n * Get 3D position for a body region on character model.\n * \n * **Korean**: 신체 영역 3D 위치 가져오기\n * \n * @param bodyRegion - Body region to get position for\n * @returns 3D position vector\n * \n */\nexport function getBodyRegionPosition(bodyRegion: BodyRegion): THREE.Vector3 {\n  // Calculate positions based on CHARACTER_DIMENSIONS for single source of truth\n  const { HEIGHT, LEG_LENGTH, SHOULDER_WIDTH } = CHARACTER_DIMENSIONS;\n  \n  const headY = HEIGHT * 0.9; // 1.8 for HEIGHT 2.0\n  const neckY = HEIGHT * 0.8; // 1.6 for HEIGHT 2.0\n  const torsoY = HEIGHT * 0.6; // 1.2 for HEIGHT 2.0\n  const coreY = HEIGHT * 0.45; // 0.9 for HEIGHT 2.0\n  const armY = torsoY; // Arms at torso level\n  const legY = LEG_LENGTH * 0.4; // 0.4 for LEG_LENGTH 1.0\n\n  switch (bodyRegion) {\n    case BodyRegion.HEAD:\n      return new THREE.Vector3(0, headY, 0);\n\n    case BodyRegion.NECK:\n      return new THREE.Vector3(0, neckY, 0);\n\n    case BodyRegion.TORSO:\n      return new THREE.Vector3(0, torsoY, 0);\n\n    case BodyRegion.CORE:\n      return new THREE.Vector3(0, coreY, 0);\n\n    case BodyRegion.LEFT_ARM:\n      return new THREE.Vector3(-SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyRegion.RIGHT_ARM:\n      return new THREE.Vector3(SHOULDER_WIDTH / 2, armY, 0);\n\n    case BodyRegion.LEFT_LEG:\n      return new THREE.Vector3(-SHOULDER_WIDTH * 0.25, legY, 0);\n\n    case BodyRegion.RIGHT_LEG:\n      return new THREE.Vector3(SHOULDER_WIDTH * 0.25, legY, 0);\n\n    default:\n      // Default to torso center\n      return new THREE.Vector3(0, torsoY, 0);\n  }\n}\n\n/**\n * Map BodyRegion to corresponding BodyPart.\n * \n * **Korean**: 신체 영역을 신체 부위로 매핑\n * \n * @param bodyRegion - Body region to map\n * @returns Corresponding body part\n * \n */\nexport function mapBodyRegionToBodyPart(bodyRegion: BodyRegion): BodyPart {\n  switch (bodyRegion) {\n    case BodyRegion.HEAD:\n      return BodyPart.HEAD;\n\n    case BodyRegion.NECK:\n      return BodyPart.NECK;\n\n    case BodyRegion.TORSO:\n      return BodyPart.TORSO_UPPER;\n\n    case BodyRegion.CORE:\n      return BodyPart.TORSO_LOWER;\n\n    case BodyRegion.LEFT_ARM:\n      return BodyPart.ARM_LEFT;\n\n    case BodyRegion.RIGHT_ARM:\n      return BodyPart.ARM_RIGHT;\n\n    case BodyRegion.LEFT_LEG:\n      return BodyPart.LEG_LEFT;\n\n    case BodyRegion.RIGHT_LEG:\n      return BodyPart.LEG_RIGHT;\n\n    default:\n      // Default to upper torso\n      return BodyPart.TORSO_UPPER;\n  }\n}\n\n/**\n * Add random offset to position for varied injury placement.\n * \n * **Korean**: 부상 위치에 무작위 오프셋 추가\n * \n * Adds slight randomness to injury positions to avoid exact overlap\n * and create more realistic trauma distribution.\n * \n * @param basePosition - Base position to offset from\n * @param maxOffset - Maximum offset in any direction (default: 0.1)\n * @returns New position with random offset\n * \n */\nexport function addRandomOffset(\n  basePosition: THREE.Vector3,\n  maxOffset: number = 0.1\n): THREE.Vector3 {\n  const offset = new THREE.Vector3(\n    (Math.random() - 0.5) * maxOffset * 2,\n    (Math.random() - 0.5) * maxOffset * 2,\n    (Math.random() - 0.5) * maxOffset * 2\n  );\n\n  return basePosition.clone().add(offset);\n}\n\n/**\n * Get injury position with slight randomization.\n * \n * **Korean**: 무작위 오프셋이 포함된 부상 위치 가져오기\n * \n * Convenience function that combines region-to-position mapping\n * with random offset for natural injury placement.\n * \n * @param bodyRegion - Body region that was hit\n * @param maxOffset - Maximum offset for randomization\n * @returns Position with random offset\n * \n */\nexport function getInjuryPositionWithOffset(\n  bodyRegion: BodyRegion,\n  maxOffset: number = 0.1\n): THREE.Vector3 {\n  const basePosition = getBodyRegionPosition(bodyRegion);\n  return addRandomOffset(basePosition, maxOffset);\n}\n\n/**\n * Check if position is within body part bounds.\n * \n * **Korean**: 위치가 신체 부위 경계 내에 있는지 확인\n * \n * @param position - Position to check\n * @param bodyPart - Body part to check against\n * @param tolerance - Distance tolerance (default: 0.3)\n * @returns Whether position is within body part bounds\n * \n */\nexport function isPositionInBodyPart(\n  position: THREE.Vector3,\n  bodyPart: BodyPart,\n  tolerance: number = 0.3\n): boolean {\n  const partPosition = getBodyPartPosition(bodyPart);\n  const distance = position.distanceTo(partPosition);\n  return distance <= tolerance;\n}\n"],"mappings":"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"}