blacktrigram 0.7.2

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

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA,IAAa,uBAAb,MAAkC;CAChC;CAEA,YAAY,SAA+B,0BAA0B;AACnE,OAAK,SAAS;;;;;;;;;;;;CAahB,4BAA4B,YAAoB,KAAqB;AACnE,SAAO;GACL,MAAM;GACN,MAAM;GACN,YAAY;GACZ,YAAY;GACZ,SAAS;GACT,UAAU;GACV,SAAS;GACT,UAAU;GACX;;;;;;;;;;;;CAaH,uBAAuB,gBAAwB,KAAwB;AACrE,SAAO;GACL,MAAM;GACN,MAAM;GACN,YAAY;GACZ,YAAY;GACZ,SAAS;GACT,UAAU;GACV,SAAS;GACT,UAAU;GACX;;;;;;;;;;;;;;;;;;CAmBH,sBACE,SACA,UACA,QACA,WACgB;EAChB,MAAM,YAAY,KAAK,IAAI,GAAG,QAAQ,YAAY,OAAO;EACzD,MAAM,gBAAgB,YAClB,KAAK,IAAI,WAAW,UAAU,UAAU,GACxC;AAEJ,SAAO;GACL,GAAG;IACF,WAAW;GACb;;;;;;;;;;;;;;;CAgBH,sBAAsB,YAAoD;AACxE,UAAQ,YAAR;GACE,KAAK,WAAW,KACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAM,YAAY;KAAK;IACjD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAM,YAAY;KAAK,CAAC;IACtD;GAEH,KAAK,WAAW,KACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAM,YAAY;KAAK;IACjD,WAAW,CACT;KAAE,MAAM,SAAS;KAAM,YAAY;KAAK,EACxC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAChD;IACF;GAEH,KAAK,WAAW,MACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK;IACxD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,KAAK,WAAW,KACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK;IACxD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,KAAK,WAAW,SACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAU,YAAY;KAAK;IACrD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,KAAK,WAAW,UACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAW,YAAY;KAAK;IACtD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,KAAK,WAAW,SACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAU,YAAY;KAAK;IACrD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,KAAK,WAAW,UACd,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAW,YAAY;KAAK;IACtD,WAAW,CAAC;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK,CAAC;IAC7D;GAEH,QAEE,QAAO;IACL,SAAS;KAAE,MAAM,SAAS;KAAa,YAAY;KAAK;IACxD,WAAW,EAAE;IACd;;;;;;;;;;;;;;;;;;;CAoBP,uBACE,SACA,YACA,aACA,WACgB;EAChB,MAAM,eAAe,KAAK,sBAAsB,WAAW;EAC3D,IAAI,UAAU,EAAE,GAAG,SAAS;AAG5B,YAAU,KAAK,sBACb,SACA,aAAa,QAAQ,MACrB,cAAc,aAAa,QAAQ,YACnC,UACD;AAGD,OAAK,MAAM,aAAa,aAAa,UACnC,WAAU,KAAK,sBACb,SACA,UAAU,MACV,cAAc,UAAU,YACxB,UACD;AAGH,SAAO;;;;;;;;;;;;;;;;;;;;CAqBT,yBACE,QACA,WACiB;EACjB,MAAM,MAAM,aAAa,KAAK,wBAAwB;EAGtD,MAAM,iBAAiB,OAAO,OAAO,IAAI;EACzC,MAAM,iBAAiB,OAAO,OAAO,IAAI;EACzC,MAAM,cAAc,KAAK,IAAI,gBAAgB,eAAe;EAE5D,IAAI,wBAAwB;AAC5B,MAAI,cAAc,2BAA2B,KAAK,mBAChD,yBAAwB,2BAA2B,KAAK;EAM1D,MAAM,YAFuB,OAAO,aAAa,IAAI,aACxB,OAAO,aAAa,IAAI,cACY;EAEjE,IAAI,uBAAuB;AAC3B,MAAI,WAAW,2BAA2B,MAAM,mBAC9C,wBAAuB,2BAA2B,MAAM;EAM1D,MAAM,WAFoB,OAAO,UAAU,IAAI,UACpB,OAAO,WAAW,IAAI,YACU;EAE3D,IAAI,uBAAuB;AAC3B,MAAI,UAAU,2BAA2B,KAAK,mBAC5C,wBAAuB,2BAA2B,KAAK;EAMzD,MAAM,WAFoB,OAAO,UAAU,IAAI,UACpB,OAAO,WAAW,IAAI,YACU;EAE3D,IAAI,wBAAwB;AAC5B,MAAI,UAAU,2BAA2B,KAAK,mBAC5C,yBAAwB,2BAA2B,KAAK;AAS1D,SAAO;GACL;GACA;GACA;GACA;GACA,iBAVsB,KAAK,IAAI,UAAU,QAAQ;GAWjD,2BARgC,KAAK,IAAI,gBAAgB,QAAQ;GASlE;;;;;;;;;;;;;;;CAgBH,yBAAyB,QAAgC;AAWvD,UATE,OAAO,OACP,OAAO,OACP,OAAO,aACP,OAAO,aACP,OAAO,UACP,OAAO,WACP,OAAO,UACP,OAAO,YAEI;;;;;;;;;;;;;;;;;CAkBf,kBACE,QACA,WACA,MACgB;EAChB,MAAM,UAAU,OAAO;EACvB,MAAM,MAAM,UAAU;EACtB,MAAM,aAAa,UAAU;EAG7B,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;AAEJ,MAAI,eAAe,GAAG;AACpB,YAAS;IAAE,QAAQ;IAAO,SAAS;IAAY;AAC/C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;aACF,aAAa,KAAK,OAAO,mBAAmB;AACrD,YAAS;IAAE,QAAQ;IAAO,SAAS;IAAY;AAC/C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;aACF,aAAa,KAAK,OAAO,wBAAwB;AAC1D,YAAS;IAAE,QAAQ;IAAM,SAAS;IAAU;AAC5C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;aACF,aAAa,KAAK,OAAO,uBAAuB;AACzD,YAAS;IAAE,QAAQ;IAAM,SAAS;IAAS;AAC3C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;aACF,aAAa,KAAK,OAAO,uBAAuB;AACzD,YAAS;IAAE,QAAQ;IAAM,SAAS;IAAS;AAC3C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;SACN;AACL,YAAS;IAAE,QAAQ;IAAM,SAAS;IAAU;AAC5C,WAAQ,cAAc;AACtB,cAAW;AACX,cAAW;;AAGb,SAAO;GACL;GACA,QAAQ;GACR,WAAW;GACX;GACA;GACA;GACA;GACA;GACD;;;;;;;;;;;;;;;CAgBH,uBACE,QACA,WACkB;AAClB,SAAO,OAAO,OAAO,SAAS,CAAC,KAAK,SAClC,KAAK,kBAAkB,QAAQ,WAAW,KAAK,CAChD;;;;;;;;;;;;;;;;;;CAmBH,aACE,SACA,UACA,YACA,WACgB;EAChB,MAAM,MAAM,aAAa,KAAK,wBAAwB;EACtD,MAAM,YAAY,KAAK,IAAI,IAAI,WAAW,QAAQ,YAAY,WAAW;AAEzE,SAAO;GACL,GAAG;IACF,WAAW;GACb;;;;;;;;;;;;;;;;;CAkBH,gBAAgB,QAAiC;AAE/C,MAAI,OAAO,QAAQ,EAAG,QAAO;AAG7B,MAAI,OAAO,WAAW,KAAK,OAAO,YAAY,EAAG,QAAO;AAIxD,MADkB,KAAK,yBAAyB,OAAO,GACvC,GAAI,QAAO;AAE3B,SAAO;;;;;;;;;;;;AAaX,IAAa,uBAAuB,IAAI,sBAAsB"}

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

@@ -0,0 +1,116 @@
+/**
+ * Body Part Position Mapping Utilities
+ *
+ * **Korean**: 신체 부위 위치 매핑 유틸리티
+ *
+ * Maps body regions and body parts to 3D positions on character models
+ * for accurate trauma visualization placement.
+ *
+ * @module systems/bodypart/BodyPartPositionMapping
+ * @category Body Part System
+ * @korean 신체부위위치매핑
+ */
+import * as THREE from "three";
+import { BodyPart } from "./types";
+import { BodyRegion } from "../../types/common";
+/**
+ * Standard character model dimensions.
+ *
+ * Based on average human proportions scaled for game character.
+ * Character center is at [0, 0, 0], standing upright.
+ */
+export declare const CHARACTER_DIMENSIONS: {
+    /** Total height from feet to head */
+    readonly HEIGHT: 2;
+    /** Width at shoulders */
+    readonly SHOULDER_WIDTH: 0.6;
+    /** Torso height */
+    readonly TORSO_HEIGHT: 0.8;
+    /** Leg length */
+    readonly LEG_LENGTH: 1;
+    /** Arm length */
+    readonly ARM_LENGTH: 0.7;
+    /** Head height */
+    readonly HEAD_HEIGHT: 0.3;
+};
+/**
+ * Get 3D position for a body part on character model.
+ *
+ * **Korean**: 신체 부위 3D 위치 가져오기
+ *
+ * Returns center position of the body part relative to character origin.
+ * Character is centered at [0, 0, 0] standing upright.
+ * Positions are calculated from CHARACTER_DIMENSIONS for consistency.
+ *
+ * @param bodyPart - Body part to get position for
+ * @returns 3D position vector
+ *
+ * @public
+ */
+export declare function getBodyPartPosition(bodyPart: BodyPart): THREE.Vector3;
+/**
+ * Get 3D position for a body region on character model.
+ *
+ * **Korean**: 신체 영역 3D 위치 가져오기
+ *
+ * @param bodyRegion - Body region to get position for
+ * @returns 3D position vector
+ *
+ * @public
+ */
+export declare function getBodyRegionPosition(bodyRegion: BodyRegion): THREE.Vector3;
+/**
+ * Map BodyRegion to corresponding BodyPart.
+ *
+ * **Korean**: 신체 영역을 신체 부위로 매핑
+ *
+ * @param bodyRegion - Body region to map
+ * @returns Corresponding body part
+ *
+ * @public
+ */
+export declare function mapBodyRegionToBodyPart(bodyRegion: BodyRegion): BodyPart;
+/**
+ * Add random offset to position for varied injury placement.
+ *
+ * **Korean**: 부상 위치에 무작위 오프셋 추가
+ *
+ * Adds slight randomness to injury positions to avoid exact overlap
+ * and create more realistic trauma distribution.
+ *
+ * @param basePosition - Base position to offset from
+ * @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;
+/**
+ * Get injury position with slight randomization.
+ *
+ * **Korean**: 무작위 오프셋이 포함된 부상 위치 가져오기
+ *
+ * Convenience function that combines region-to-position mapping
+ * with random offset for natural injury placement.
+ *
+ * @param bodyRegion - Body region that was hit
+ * @param maxOffset - Maximum offset for randomization
+ * @returns Position with random offset
+ *
+ * @public
+ */
+export declare function getInjuryPositionWithOffset(bodyRegion: BodyRegion, maxOffset?: number): THREE.Vector3;
+/**
+ * Check if position is within body part bounds.
+ *
+ * **Korean**: 위치가 신체 부위 경계 내에 있는지 확인
+ *
+ * @param position - Position to check
+ * @param bodyPart - Body part to check against
+ * @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

@@ -0,0 +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"}

package/lib/systems/bodypart/BodyPartPositionMapping.js

@@ -0,0 +1,122 @@
+import { BodyRegion } from "../../types/common.js";
+import { BodyPart } from "./types.js";
+import * as THREE from "three";
+//#region src/systems/bodypart/BodyPartPositionMapping.ts
+/**
+* Body Part Position Mapping Utilities
+* 
+* **Korean**: 신체 부위 위치 매핑 유틸리티
+* 
+* Maps body regions and body parts to 3D positions on character models
+* for accurate trauma visualization placement.
+* 
+* @module systems/bodypart/BodyPartPositionMapping
+* @category Body Part System
+* @korean 신체부위위치매핑
+*/
+/**
+* Standard character model dimensions.
+* 
+* Based on average human proportions scaled for game character.
+* Character center is at [0, 0, 0], standing upright.
+*/
+var CHARACTER_DIMENSIONS = {
+	HEIGHT: 2,
+	SHOULDER_WIDTH: .6,
+	TORSO_HEIGHT: .8,
+	LEG_LENGTH: 1,
+	ARM_LENGTH: .7,
+	HEAD_HEIGHT: .3
+};
+/**
+* Get 3D position for a body region on character model.
+* 
+* **Korean**: 신체 영역 3D 위치 가져오기
+* 
+* @param bodyRegion - Body region to get position for
+* @returns 3D position vector
+* 
+* @public
+*/
+function getBodyRegionPosition(bodyRegion) {
+	const { HEIGHT, LEG_LENGTH, SHOULDER_WIDTH } = CHARACTER_DIMENSIONS;
+	const headY = HEIGHT * .9;
+	const neckY = HEIGHT * .8;
+	const torsoY = HEIGHT * .6;
+	const coreY = HEIGHT * .45;
+	const armY = torsoY;
+	const legY = LEG_LENGTH * .4;
+	switch (bodyRegion) {
+		case BodyRegion.HEAD: return new THREE.Vector3(0, headY, 0);
+		case BodyRegion.NECK: return new THREE.Vector3(0, neckY, 0);
+		case BodyRegion.TORSO: return new THREE.Vector3(0, torsoY, 0);
+		case BodyRegion.CORE: return new THREE.Vector3(0, coreY, 0);
+		case BodyRegion.LEFT_ARM: return new THREE.Vector3(-SHOULDER_WIDTH / 2, armY, 0);
+		case BodyRegion.RIGHT_ARM: return new THREE.Vector3(SHOULDER_WIDTH / 2, armY, 0);
+		case BodyRegion.LEFT_LEG: return new THREE.Vector3(-SHOULDER_WIDTH * .25, legY, 0);
+		case BodyRegion.RIGHT_LEG: return new THREE.Vector3(SHOULDER_WIDTH * .25, legY, 0);
+		default: return new THREE.Vector3(0, torsoY, 0);
+	}
+}
+/**
+* Map BodyRegion to corresponding BodyPart.
+* 
+* **Korean**: 신체 영역을 신체 부위로 매핑
+* 
+* @param bodyRegion - Body region to map
+* @returns Corresponding body part
+* 
+* @public
+*/
+function mapBodyRegionToBodyPart(bodyRegion) {
+	switch (bodyRegion) {
+		case BodyRegion.HEAD: return BodyPart.HEAD;
+		case BodyRegion.NECK: return BodyPart.NECK;
+		case BodyRegion.TORSO: return BodyPart.TORSO_UPPER;
+		case BodyRegion.CORE: return BodyPart.TORSO_LOWER;
+		case BodyRegion.LEFT_ARM: return BodyPart.ARM_LEFT;
+		case BodyRegion.RIGHT_ARM: return BodyPart.ARM_RIGHT;
+		case BodyRegion.LEFT_LEG: return BodyPart.LEG_LEFT;
+		case BodyRegion.RIGHT_LEG: return BodyPart.LEG_RIGHT;
+		default: return BodyPart.TORSO_UPPER;
+	}
+}
+/**
+* Add random offset to position for varied injury placement.
+* 
+* **Korean**: 부상 위치에 무작위 오프셋 추가
+* 
+* Adds slight randomness to injury positions to avoid exact overlap
+* and create more realistic trauma distribution.
+* 
+* @param basePosition - Base position to offset from
+* @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);
+	return basePosition.clone().add(offset);
+}
+/**
+* Get injury position with slight randomization.
+* 
+* **Korean**: 무작위 오프셋이 포함된 부상 위치 가져오기
+* 
+* Convenience function that combines region-to-position mapping
+* with random offset for natural injury placement.
+* 
+* @param bodyRegion - Body region that was hit
+* @param maxOffset - Maximum offset for randomization
+* @returns Position with random offset
+* 
+* @public
+*/
+function getInjuryPositionWithOffset(bodyRegion, maxOffset = .1) {
+	return addRandomOffset(getBodyRegionPosition(bodyRegion), maxOffset);
+}
+//#endregion
+export { CHARACTER_DIMENSIONS, addRandomOffset, getBodyRegionPosition, getInjuryPositionWithOffset, mapBodyRegionToBodyPart };
+
+//# sourceMappingURL=BodyPartPositionMapping.js.map

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

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAa,uBAAuB;CAElC,QAAQ;CAER,gBAAgB;CAEhB,cAAc;CAEd,YAAY;CAEZ,YAAY;CAEZ,aAAa;CACd;;;;;;;;;;;AAkED,SAAgB,sBAAsB,YAAuC;CAE3E,MAAM,EAAE,QAAQ,YAAY,mBAAmB;CAE/C,MAAM,QAAQ,SAAS;CACvB,MAAM,QAAQ,SAAS;CACvB,MAAM,SAAS,SAAS;CACxB,MAAM,QAAQ,SAAS;CACvB,MAAM,OAAO;CACb,MAAM,OAAO,aAAa;AAE1B,SAAQ,YAAR;EACE,KAAK,WAAW,KACd,QAAO,IAAI,MAAM,QAAQ,GAAG,OAAO,EAAE;EAEvC,KAAK,WAAW,KACd,QAAO,IAAI,MAAM,QAAQ,GAAG,OAAO,EAAE;EAEvC,KAAK,WAAW,MACd,QAAO,IAAI,MAAM,QAAQ,GAAG,QAAQ,EAAE;EAExC,KAAK,WAAW,KACd,QAAO,IAAI,MAAM,QAAQ,GAAG,OAAO,EAAE;EAEvC,KAAK,WAAW,SACd,QAAO,IAAI,MAAM,QAAQ,CAAC,iBAAiB,GAAG,MAAM,EAAE;EAExD,KAAK,WAAW,UACd,QAAO,IAAI,MAAM,QAAQ,iBAAiB,GAAG,MAAM,EAAE;EAEvD,KAAK,WAAW,SACd,QAAO,IAAI,MAAM,QAAQ,CAAC,iBAAiB,KAAM,MAAM,EAAE;EAE3D,KAAK,WAAW,UACd,QAAO,IAAI,MAAM,QAAQ,iBAAiB,KAAM,MAAM,EAAE;EAE1D,QAEE,QAAO,IAAI,MAAM,QAAQ,GAAG,QAAQ,EAAE;;;;;;;;;;;;;AAc5C,SAAgB,wBAAwB,YAAkC;AACxE,SAAQ,YAAR;EACE,KAAK,WAAW,KACd,QAAO,SAAS;EAElB,KAAK,WAAW,KACd,QAAO,SAAS;EAElB,KAAK,WAAW,MACd,QAAO,SAAS;EAElB,KAAK,WAAW,KACd,QAAO,SAAS;EAElB,KAAK,WAAW,SACd,QAAO,SAAS;EAElB,KAAK,WAAW,UACd,QAAO,SAAS;EAElB,KAAK,WAAW,SACd,QAAO,SAAS;EAElB,KAAK,WAAW,UACd,QAAO,SAAS;EAElB,QAEE,QAAO,SAAS;;;;;;;;;;;;;;;;;AAkBtB,SAAgB,gBACd,cACA,YAAoB,IACL;CACf,MAAM,SAAS,IAAI,MAAM,SACtB,KAAK,QAAQ,GAAG,MAAO,YAAY,IACnC,KAAK,QAAQ,GAAG,MAAO,YAAY,IACnC,KAAK,QAAQ,GAAG,MAAO,YAAY,EACrC;AAED,QAAO,aAAa,OAAO,CAAC,IAAI,OAAO;;;;;;;;;;;;;;;;AAiBzC,SAAgB,4BACd,YACA,YAAoB,IACL;AAEf,QAAO,gBADc,sBAAsB,WAAW,EACjB,UAAU"}

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

@@ -0,0 +1,191 @@
+/**
+ * Combat Injury Integration
+ *
+ * **Korean**: 전투 부상 통합
+ *
+ * Integrates InjuryTracker with combat damage events to automatically
+ * record injuries and trigger visual trauma effects during combat.
+ *
+ * @module systems/bodypart/CombatInjuryIntegration
+ * @category Body Part System
+ * @korean 전투부상통합
+ */
+import * as THREE from "three";
+import { BodyRegion, DamageType } from "../../types/common";
+import { InjuryTracker } from "./InjuryTracker";
+/**
+ * Combat damage event data.
+ *
+ * **Korean**: 전투 피해 이벤트 데이터
+ *
+ * @public
+ */
+export interface CombatDamageEvent {
+    /** Damage amount (0-100) */
+    readonly damage: number;
+    /** Body region hit */
+    readonly bodyRegion: BodyRegion;
+    /** Damage type */
+    readonly damageType?: DamageType;
+    /** Optional specific position override */
+    readonly position?: THREE.Vector3;
+    /** Whether this is a critical hit */
+    readonly isCritical?: boolean;
+}
+/**
+ * Configuration for combat injury integration.
+ *
+ * @public
+ */
+export interface CombatInjuryConfig {
+    /** Enable automatic injury tracking */
+    readonly enabled: boolean;
+    /** Minimum damage to create injury */
+    readonly minDamage: number;
+    /** Damage threshold for blood effects */
+    readonly bloodThreshold: number;
+    /**
+     * InjuryTracker instance to use for this integration.
+     * Must be explicitly provided per character; singleton usage is no longer supported.
+     */
+    readonly tracker: InjuryTracker;
+}
+/**
+ * Default combat injury configuration.
+ *
+ * Note: A valid `tracker` must still be supplied by the caller.
+ * This provides defaults for other configuration values only.
+ *
+ * @public
+ */
+export declare const DEFAULT_COMBAT_INJURY_CONFIG: Omit<CombatInjuryConfig, 'tracker'>;
+/**
+ * Combat Injury Integration Handler.
+ *
+ * **Korean**: 전투 부상 통합 핸들러
+ *
+ * Processes combat damage events and records injuries for visualization.
+ * Automatically maps damage types to injury types and applies blood effects.
+ *
+ * @example
+ * ```typescript
+ * // Recommended: Use PlayerInjuryTrackingManager for per-player tracking
+ * import { playerInjuryManager } from '../bodypart';
+ * const integration = playerInjuryManager.getIntegrationForPlayer('player-1');
+ *
+ * // Or create with explicit tracker for testing/custom scenarios
+ * const handler = new CombatInjuryIntegration({
+ *   ...DEFAULT_COMBAT_INJURY_CONFIG,
+ *   tracker: new InjuryTracker(),
+ * });
+ *
+ * // Record combat damage
+ * handler.recordCombatDamage({
+ *   damage: 35,
+ *   bodyRegion: BodyRegion.TORSO,
+ *   damageType: DamageType.BLUNT,
+ * });
+ *
+ * // Get injuries for visualization
+ * const injuries = handler.getInjuries();
+ * ```
+ *
+ * @public
+ */
+export declare class CombatInjuryIntegration {
+    private tracker;
+    private config;
+    constructor(config: CombatInjuryConfig);
+    /**
+     * Record injury from combat damage event.
+     *
+     * **Korean**: 전투 피해로부터 부상 기록
+     *
+     * Automatically determines injury type from damage type and applies
+     * appropriate visual effects.
+     *
+     * @param event - Combat damage event
+     * @returns Whether injury was recorded (false if damage too low)
+     *
+     * @public
+     */
+    recordCombatDamage(event: CombatDamageEvent): boolean;
+    /**
+     * Check if damage should trigger blood effects.
+     *
+     * **Korean**: 피해가 출혈 효과를 발생시켜야 하는지 확인
+     *
+     * @param damage - Damage amount
+     * @returns Whether to show blood effects
+     *
+     * @public
+     */
+    shouldShowBloodEffect(damage: number): boolean;
+    /**
+     * Get injury type from damage type.
+     *
+     * **Korean**: 피해 타입으로부터 부상 타입 가져오기
+     *
+     * @param damageType - Type of damage dealt
+     * @returns Corresponding injury type for visualization
+     *
+     * @private
+     */
+    private getInjuryTypeFromDamage;
+    /**
+     * Get all tracked injuries.
+     *
+     * **Korean**: 모든 추적된 부상 가져오기
+     *
+     * @returns Array of injuries
+     *
+     * @public
+     */
+    getInjuries(): import("./InjuryTracker").InjuryLocation[];
+    /**
+     * Get tracker instance.
+     *
+     * @returns InjuryTracker instance
+     *
+     * @public
+     */
+    getTracker(): InjuryTracker;
+    /**
+     * Clear all injuries (for new round/match).
+     *
+     * **Korean**: 모든 부상 초기화
+     *
+     * @public
+     */
+    clearInjuries(): void;
+    /**
+     * Remove expired injuries.
+     *
+     * **Korean**: 만료된 부상 제거
+     *
+     * @public
+     */
+    removeExpiredInjuries(): void;
+}
+/**
+ * @deprecated Use {@link PlayerInjuryTrackingManager} instead to get per-player instances.
+ *
+ * Creating a singleton is no longer supported because it mixes injuries between
+ * multiple characters. Use `playerInjuryManager.getIntegrationForPlayer(playerId)`
+ * to get a properly scoped integration instance.
+ *
+ * **Korean**: PlayerInjuryTrackingManager를 사용하여 플레이어별 인스턴스를 가져오세요
+ *
+ * @example
+ * ```typescript
+ * // OLD (deprecated):
+ * // import { combatInjuryIntegration } from '../bodypart';
+ *
+ * // NEW (correct):
+ * import { playerInjuryManager } from '../bodypart';
+ * const integration = playerInjuryManager.getIntegrationForPlayer(playerId);
+ * ```
+ *
+ * @public
+ */
+//# sourceMappingURL=CombatInjuryIntegration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CombatInjuryIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/CombatInjuryIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOhD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,kBAAkB;IAClB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAInE,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAMtC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAgCrD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;;;;;;;OAQG;IACH,WAAW;IAIX;;;;;;OAMG;IACH,UAAU,IAAI,aAAa;IAI3B;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAIrB;;;;;;OAMG;IACH,qBAAqB,IAAI,IAAI;CAG9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/lib/systems/bodypart/CombatInjuryIntegration.js

@@ -0,0 +1,169 @@
+import { DamageType } from "../../types/common.js";
+import { getInjuryPositionWithOffset, mapBodyRegionToBodyPart } from "./BodyPartPositionMapping.js";
+import { InjuryType } from "../../types/injury.js";
+//#region src/systems/bodypart/CombatInjuryIntegration.ts
+/**
+* Combat Injury Integration Handler.
+* 
+* **Korean**: 전투 부상 통합 핸들러
+* 
+* Processes combat damage events and records injuries for visualization.
+* Automatically maps damage types to injury types and applies blood effects.
+* 
+* @example
+* ```typescript
+* // Recommended: Use PlayerInjuryTrackingManager for per-player tracking
+* import { playerInjuryManager } from '@/systems/bodypart';
+* const integration = playerInjuryManager.getIntegrationForPlayer('player-1');
+* 
+* // Or create with explicit tracker for testing/custom scenarios
+* const handler = new CombatInjuryIntegration({
+*   ...DEFAULT_COMBAT_INJURY_CONFIG,
+*   tracker: new InjuryTracker(),
+* });
+* 
+* // Record combat damage
+* handler.recordCombatDamage({
+*   damage: 35,
+*   bodyRegion: BodyRegion.TORSO,
+*   damageType: DamageType.BLUNT,
+* });
+* 
+* // Get injuries for visualization
+* const injuries = handler.getInjuries();
+* ```
+* 
+* @public
+*/
+var CombatInjuryIntegration = class {
+	tracker;
+	config;
+	constructor(config) {
+		this.config = config;
+		this.tracker = config.tracker;
+	}
+	/**
+	* Record injury from combat damage event.
+	* 
+	* **Korean**: 전투 피해로부터 부상 기록
+	* 
+	* Automatically determines injury type from damage type and applies
+	* appropriate visual effects.
+	* 
+	* @param event - Combat damage event
+	* @returns Whether injury was recorded (false if damage too low)
+	* 
+	* @public
+	*/
+	recordCombatDamage(event) {
+		if (!this.config.enabled) return false;
+		if (event.damage < this.config.minDamage) return false;
+		const injuryType = this.getInjuryTypeFromDamage(event.damageType);
+		const position = event.position ?? getInjuryPositionWithOffset(event.bodyRegion, .15);
+		const bodyPart = mapBodyRegionToBodyPart(event.bodyRegion);
+		return this.tracker.recordInjury(bodyPart, event.bodyRegion, position, event.damage, injuryType) !== null;
+	}
+	/**
+	* Check if damage should trigger blood effects.
+	* 
+	* **Korean**: 피해가 출혈 효과를 발생시켜야 하는지 확인
+	* 
+	* @param damage - Damage amount
+	* @returns Whether to show blood effects
+	* 
+	* @public
+	*/
+	shouldShowBloodEffect(damage) {
+		return damage > this.config.bloodThreshold;
+	}
+	/**
+	* Get injury type from damage type.
+	* 
+	* **Korean**: 피해 타입으로부터 부상 타입 가져오기
+	* 
+	* @param damageType - Type of damage dealt
+	* @returns Corresponding injury type for visualization
+	* 
+	* @private
+	*/
+	getInjuryTypeFromDamage(damageType) {
+		if (!damageType) return InjuryType.BRUISE;
+		switch (damageType) {
+			case DamageType.BLUNT:
+			case DamageType.IMPACT:
+			case DamageType.CRUSHING: return InjuryType.BRUISE;
+			case DamageType.PIERCING:
+			case DamageType.SHARP: return InjuryType.CUT;
+			case DamageType.SLASHING: return InjuryType.LACERATION;
+			case DamageType.JOINT: return InjuryType.FRACTURE;
+			default: return InjuryType.BRUISE;
+		}
+	}
+	/**
+	* Get all tracked injuries.
+	* 
+	* **Korean**: 모든 추적된 부상 가져오기
+	* 
+	* @returns Array of injuries
+	* 
+	* @public
+	*/
+	getInjuries() {
+		return this.tracker.getInjuries();
+	}
+	/**
+	* Get tracker instance.
+	* 
+	* @returns InjuryTracker instance
+	* 
+	* @public
+	*/
+	getTracker() {
+		return this.tracker;
+	}
+	/**
+	* Clear all injuries (for new round/match).
+	* 
+	* **Korean**: 모든 부상 초기화
+	* 
+	* @public
+	*/
+	clearInjuries() {
+		this.tracker.clearInjuries();
+	}
+	/**
+	* Remove expired injuries.
+	* 
+	* **Korean**: 만료된 부상 제거
+	* 
+	* @public
+	*/
+	removeExpiredInjuries() {
+		this.tracker.removeExpiredInjuries();
+	}
+};
+/**
+* @deprecated Use {@link PlayerInjuryTrackingManager} instead to get per-player instances.
+* 
+* Creating a singleton is no longer supported because it mixes injuries between
+* multiple characters. Use `playerInjuryManager.getIntegrationForPlayer(playerId)`
+* to get a properly scoped integration instance.
+* 
+* **Korean**: PlayerInjuryTrackingManager를 사용하여 플레이어별 인스턴스를 가져오세요
+* 
+* @example
+* ```typescript
+* // OLD (deprecated):
+* // import { combatInjuryIntegration } from '@/systems/bodypart';
+* 
+* // NEW (correct):
+* import { playerInjuryManager } from '@/systems/bodypart';
+* const integration = playerInjuryManager.getIntegrationForPlayer(playerId);
+* ```
+* 
+* @public
+*/
+//#endregion
+export { CombatInjuryIntegration };
+
+//# sourceMappingURL=CombatInjuryIntegration.js.map