blacktrigram 0.7.43 → 0.7.45

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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"}

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

@@ -18,7 +18,6 @@ import { InjuryTracker } from "./InjuryTracker";
  *
  * **Korean**: 전투 피해 이벤트 데이터
  *
- * @public
  */
 export interface CombatDamageEvent {
     /** Damage amount (0-100) */
@@ -35,7 +34,6 @@ export interface CombatDamageEvent {
 /**
  * Configuration for combat injury integration.
  *
- * @public
  */
 export interface CombatInjuryConfig {
     /** Enable automatic injury tracking */
@@ -56,7 +54,6 @@ export interface CombatInjuryConfig {
  * 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'>;
 /**
@@ -90,7 +87,6 @@ export declare const DEFAULT_COMBAT_INJURY_CONFIG: Omit<CombatInjuryConfig, 'tra
  * const injuries = handler.getInjuries();
  * ```
  *
- * @public
  */
 export declare class CombatInjuryIntegration {
     private tracker;
@@ -107,7 +103,6 @@ export declare class CombatInjuryIntegration {
      * @param event - Combat damage event
      * @returns Whether injury was recorded (false if damage too low)
      *
-     * @public
      */
     recordCombatDamage(event: CombatDamageEvent): boolean;
     /**
@@ -118,7 +113,6 @@ export declare class CombatInjuryIntegration {
      * @param damage - Damage amount
      * @returns Whether to show blood effects
      *
-     * @public
      */
     shouldShowBloodEffect(damage: number): boolean;
     /**
@@ -139,7 +133,6 @@ export declare class CombatInjuryIntegration {
      *
      * @returns Array of injuries
      *
-     * @public
      */
     getInjuries(): import("./InjuryTracker").InjuryLocation[];
     /**
@@ -147,7 +140,6 @@ export declare class CombatInjuryIntegration {
      *
      * @returns InjuryTracker instance
      *
-     * @public
      */
     getTracker(): InjuryTracker;
     /**
@@ -155,7 +147,6 @@ export declare class CombatInjuryIntegration {
      *
      * **Korean**: 모든 부상 초기화
      *
-     * @public
      */
     clearInjuries(): void;
     /**
@@ -163,7 +154,6 @@ export declare class CombatInjuryIntegration {
      *
      * **Korean**: 만료된 부상 제거
      *
-     * @public
      */
     removeExpiredInjuries(): void;
 }

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

@@ -1 +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"}
+{"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;;;;;GAKG;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;;;GAGG;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;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAInE,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAMtC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAgCrD;;;;;;;;OAQG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;;;;;;OAOG;IACH,WAAW;IAIX;;;;;OAKG;IACH,UAAU,IAAI,aAAa;IAI3B;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAIrB;;;;;OAKG;IACH,qBAAqB,IAAI,IAAI;CAG9B"}

package/lib/systems/bodypart/CombatInjuryIntegration.js

@@ -8,7 +8,6 @@ import { getInjuryPositionWithOffset, mapBodyRegionToBodyPart } from "./BodyPart
 * Note: A valid `tracker` must still be supplied by the caller.
 * This provides defaults for other configuration values only.
 * 
-* @public
 */
 var DEFAULT_COMBAT_INJURY_CONFIG = {
 	enabled: true,
@@ -46,7 +45,6 @@ var DEFAULT_COMBAT_INJURY_CONFIG = {
 * const injuries = handler.getInjuries();
 * ```
 * 
-* @public
 */
 var CombatInjuryIntegration = class {
 	tracker;
@@ -66,7 +64,6 @@ var CombatInjuryIntegration = class {
 	* @param event - Combat damage event
 	* @returns Whether injury was recorded (false if damage too low)
 	* 
-	* @public
 	*/
 	recordCombatDamage(event) {
 		if (!this.config.enabled) return false;
@@ -84,7 +81,6 @@ var CombatInjuryIntegration = class {
 	* @param damage - Damage amount
 	* @returns Whether to show blood effects
 	* 
-	* @public
 	*/
 	shouldShowBloodEffect(damage) {
 		return damage > this.config.bloodThreshold;
@@ -119,7 +115,6 @@ var CombatInjuryIntegration = class {
 	* 
 	* @returns Array of injuries
 	* 
-	* @public
 	*/
 	getInjuries() {
 		return this.tracker.getInjuries();
@@ -129,7 +124,6 @@ var CombatInjuryIntegration = class {
 	* 
 	* @returns InjuryTracker instance
 	* 
-	* @public
 	*/
 	getTracker() {
 		return this.tracker;
@@ -139,7 +133,6 @@ var CombatInjuryIntegration = class {
 	* 
 	* **Korean**: 모든 부상 초기화
 	* 
-	* @public
 	*/
 	clearInjuries() {
 		this.tracker.clearInjuries();
@@ -149,7 +142,6 @@ var CombatInjuryIntegration = class {
 	* 
 	* **Korean**: 만료된 부상 제거
 	* 
-	* @public
 	*/
 	removeExpiredInjuries() {
 		this.tracker.removeExpiredInjuries();

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

@@ -1 +1 @@
-{"version":3,"file":"CombatInjuryIntegration.js","names":[],"sources":["../../../src/systems/bodypart/CombatInjuryIntegration.ts"],"sourcesContent":["/**\n * Combat Injury Integration\n * \n * **Korean**: 전투 부상 통합\n * \n * Integrates InjuryTracker with combat damage events to automatically\n * record injuries and trigger visual trauma effects during combat.\n * \n * @module systems/bodypart/CombatInjuryIntegration\n * @category Body Part System\n * @korean 전투부상통합\n */\n\nimport * as THREE from \"three\";\nimport { BodyRegion, DamageType } from \"../../types/common\";\nimport { InjuryTracker } from \"./InjuryTracker\";\nimport {\n  getInjuryPositionWithOffset,\n  mapBodyRegionToBodyPart,\n} from \"./BodyPartPositionMapping\";\nimport { InjuryType } from \"../../types/injury\";\n\n/**\n * Combat damage event data.\n * \n * **Korean**: 전투 피해 이벤트 데이터\n * \n * @public\n */\nexport interface CombatDamageEvent {\n  /** Damage amount (0-100) */\n  readonly damage: number;\n  /** Body region hit */\n  readonly bodyRegion: BodyRegion;\n  /** Damage type */\n  readonly damageType?: DamageType;\n  /** Optional specific position override */\n  readonly position?: THREE.Vector3;\n  /** Whether this is a critical hit */\n  readonly isCritical?: boolean;\n}\n\n/**\n * Configuration for combat injury integration.\n * \n * @public\n */\nexport interface CombatInjuryConfig {\n  /** Enable automatic injury tracking */\n  readonly enabled: boolean;\n  /** Minimum damage to create injury */\n  readonly minDamage: number;\n  /** Damage threshold for blood effects */\n  readonly bloodThreshold: number;\n  /** \n   * InjuryTracker instance to use for this integration.\n   * Must be explicitly provided per character; singleton usage is no longer supported.\n   */\n  readonly tracker: InjuryTracker;\n}\n\n/**\n * Default combat injury configuration.\n * \n * Note: A valid `tracker` must still be supplied by the caller.\n * This provides defaults for other configuration values only.\n * \n * @public\n */\nexport const DEFAULT_COMBAT_INJURY_CONFIG: Omit<CombatInjuryConfig, 'tracker'> = {\n  enabled: true,\n  minDamage: 5,\n  bloodThreshold: 30,\n} as const;\n\n/**\n * Combat Injury Integration Handler.\n * \n * **Korean**: 전투 부상 통합 핸들러\n * \n * Processes combat damage events and records injuries for visualization.\n * Automatically maps damage types to injury types and applies blood effects.\n * \n * @example\n * ```typescript\n * // Recommended: Use PlayerInjuryTrackingManager for per-player tracking\n * import { playerInjuryManager } from '@/systems/bodypart';\n * const integration = playerInjuryManager.getIntegrationForPlayer('player-1');\n * \n * // Or create with explicit tracker for testing/custom scenarios\n * const handler = new CombatInjuryIntegration({\n *   ...DEFAULT_COMBAT_INJURY_CONFIG,\n *   tracker: new InjuryTracker(),\n * });\n * \n * // Record combat damage\n * handler.recordCombatDamage({\n *   damage: 35,\n *   bodyRegion: BodyRegion.TORSO,\n *   damageType: DamageType.BLUNT,\n * });\n * \n * // Get injuries for visualization\n * const injuries = handler.getInjuries();\n * ```\n * \n * @public\n */\nexport class CombatInjuryIntegration {\n  private tracker: InjuryTracker;\n  private config: CombatInjuryConfig;\n\n  constructor(config: CombatInjuryConfig) {\n    this.config = config;\n    // Tracker is now required in CombatInjuryConfig interface\n    this.tracker = config.tracker;\n  }\n\n  /**\n   * Record injury from combat damage event.\n   * \n   * **Korean**: 전투 피해로부터 부상 기록\n   * \n   * Automatically determines injury type from damage type and applies\n   * appropriate visual effects.\n   * \n   * @param event - Combat damage event\n   * @returns Whether injury was recorded (false if damage too low)\n   * \n   * @public\n   */\n  recordCombatDamage(event: CombatDamageEvent): boolean {\n    if (!this.config.enabled) {\n      return false;\n    }\n\n    if (event.damage < this.config.minDamage) {\n      return false;\n    }\n\n    // Determine injury type from damage type\n    const injuryType = this.getInjuryTypeFromDamage(event.damageType);\n\n    // Get position for injury\n    const position =\n      event.position ?? getInjuryPositionWithOffset(event.bodyRegion, 0.15);\n\n    // Map body region to body part\n    const bodyPart = mapBodyRegionToBodyPart(event.bodyRegion);\n\n    // Record injury\n    const recordedInjury = this.tracker.recordInjury(\n      bodyPart,\n      event.bodyRegion,\n      position,\n      event.damage,\n      injuryType\n    );\n\n    // Return true only if the injury was actually recorded\n    return recordedInjury !== null;\n  }\n\n  /**\n   * Check if damage should trigger blood effects.\n   * \n   * **Korean**: 피해가 출혈 효과를 발생시켜야 하는지 확인\n   * \n   * @param damage - Damage amount\n   * @returns Whether to show blood effects\n   * \n   * @public\n   */\n  shouldShowBloodEffect(damage: number): boolean {\n    return damage > this.config.bloodThreshold;\n  }\n\n  /**\n   * Get injury type from damage type.\n   * \n   * **Korean**: 피해 타입으로부터 부상 타입 가져오기\n   * \n   * @param damageType - Type of damage dealt\n   * @returns Corresponding injury type for visualization\n   * \n   * @private\n   */\n  private getInjuryTypeFromDamage(damageType?: DamageType): InjuryType {\n    if (!damageType) {\n      return InjuryType.BRUISE; // Default to bruise\n    }\n\n    switch (damageType) {\n      case DamageType.BLUNT:\n      case DamageType.IMPACT:\n      case DamageType.CRUSHING:\n        return InjuryType.BRUISE;\n\n      case DamageType.PIERCING:\n      case DamageType.SHARP:\n        return InjuryType.CUT;\n\n      case DamageType.SLASHING:\n        return InjuryType.LACERATION;\n\n      case DamageType.JOINT:\n        return InjuryType.FRACTURE;\n\n      default:\n        return InjuryType.BRUISE;\n    }\n  }\n\n  /**\n   * Get all tracked injuries.\n   * \n   * **Korean**: 모든 추적된 부상 가져오기\n   * \n   * @returns Array of injuries\n   * \n   * @public\n   */\n  getInjuries() {\n    return this.tracker.getInjuries();\n  }\n\n  /**\n   * Get tracker instance.\n   * \n   * @returns InjuryTracker instance\n   * \n   * @public\n   */\n  getTracker(): InjuryTracker {\n    return this.tracker;\n  }\n\n  /**\n   * Clear all injuries (for new round/match).\n   * \n   * **Korean**: 모든 부상 초기화\n   * \n   * @public\n   */\n  clearInjuries(): void {\n    this.tracker.clearInjuries();\n  }\n\n  /**\n   * Remove expired injuries.\n   * \n   * **Korean**: 만료된 부상 제거\n   * \n   * @public\n   */\n  removeExpiredInjuries(): void {\n    this.tracker.removeExpiredInjuries();\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAqEA,IAAa,+BAAoE;CAC/E,SAAS;CACT,WAAW;CACX,gBAAgB;CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCD,IAAa,0BAAb,MAAqC;CACnC;CACA;CAEA,YAAY,QAA4B;EACtC,KAAK,SAAS;EAEd,KAAK,UAAU,OAAO;;;;;;;;;;;;;;;CAgBxB,mBAAmB,OAAmC;EACpD,IAAI,CAAC,KAAK,OAAO,SACf,OAAO;EAGT,IAAI,MAAM,SAAS,KAAK,OAAO,WAC7B,OAAO;EAIT,MAAM,aAAa,KAAK,wBAAwB,MAAM,WAAW;EAGjE,MAAM,WACJ,MAAM,YAAY,4BAA4B,MAAM,YAAY,IAAK;EAGvE,MAAM,WAAW,wBAAwB,MAAM,WAAW;EAY1D,OATuB,KAAK,QAAQ,aAClC,UACA,MAAM,YACN,UACA,MAAM,QACN,WAIK,KAAmB;;;;;;;;;;;;CAa5B,sBAAsB,QAAyB;EAC7C,OAAO,SAAS,KAAK,OAAO;;;;;;;;;;;;CAa9B,wBAAgC,YAAqC;EACnE,IAAI,CAAC,YACH,OAAO,WAAW;EAGpB,QAAQ,YAAR;GACE,KAAK,WAAW;GAChB,KAAK,WAAW;GAChB,KAAK,WAAW,UACd,OAAO,WAAW;GAEpB,KAAK,WAAW;GAChB,KAAK,WAAW,OACd,OAAO,WAAW;GAEpB,KAAK,WAAW,UACd,OAAO,WAAW;GAEpB,KAAK,WAAW,OACd,OAAO,WAAW;GAEpB,SACE,OAAO,WAAW;;;;;;;;;;;;CAaxB,cAAc;EACZ,OAAO,KAAK,QAAQ,aAAa;;;;;;;;;CAUnC,aAA4B;EAC1B,OAAO,KAAK;;;;;;;;;CAUd,gBAAsB;EACpB,KAAK,QAAQ,eAAe;;;;;;;;;CAU9B,wBAA8B;EAC5B,KAAK,QAAQ,uBAAuB"}
+{"version":3,"file":"CombatInjuryIntegration.js","names":[],"sources":["../../../src/systems/bodypart/CombatInjuryIntegration.ts"],"sourcesContent":["/**\n * Combat Injury Integration\n * \n * **Korean**: 전투 부상 통합\n * \n * Integrates InjuryTracker with combat damage events to automatically\n * record injuries and trigger visual trauma effects during combat.\n * \n * @module systems/bodypart/CombatInjuryIntegration\n * @category Body Part System\n * @korean 전투부상통합\n */\n\nimport * as THREE from \"three\";\nimport { BodyRegion, DamageType } from \"../../types/common\";\nimport { InjuryTracker } from \"./InjuryTracker\";\nimport {\n  getInjuryPositionWithOffset,\n  mapBodyRegionToBodyPart,\n} from \"./BodyPartPositionMapping\";\nimport { InjuryType } from \"../../types/injury\";\n\n/**\n * Combat damage event data.\n * \n * **Korean**: 전투 피해 이벤트 데이터\n * \n */\nexport interface CombatDamageEvent {\n  /** Damage amount (0-100) */\n  readonly damage: number;\n  /** Body region hit */\n  readonly bodyRegion: BodyRegion;\n  /** Damage type */\n  readonly damageType?: DamageType;\n  /** Optional specific position override */\n  readonly position?: THREE.Vector3;\n  /** Whether this is a critical hit */\n  readonly isCritical?: boolean;\n}\n\n/**\n * Configuration for combat injury integration.\n * \n */\nexport interface CombatInjuryConfig {\n  /** Enable automatic injury tracking */\n  readonly enabled: boolean;\n  /** Minimum damage to create injury */\n  readonly minDamage: number;\n  /** Damage threshold for blood effects */\n  readonly bloodThreshold: number;\n  /** \n   * InjuryTracker instance to use for this integration.\n   * Must be explicitly provided per character; singleton usage is no longer supported.\n   */\n  readonly tracker: InjuryTracker;\n}\n\n/**\n * Default combat injury configuration.\n * \n * Note: A valid `tracker` must still be supplied by the caller.\n * This provides defaults for other configuration values only.\n * \n */\nexport const DEFAULT_COMBAT_INJURY_CONFIG: Omit<CombatInjuryConfig, 'tracker'> = {\n  enabled: true,\n  minDamage: 5,\n  bloodThreshold: 30,\n} as const;\n\n/**\n * Combat Injury Integration Handler.\n * \n * **Korean**: 전투 부상 통합 핸들러\n * \n * Processes combat damage events and records injuries for visualization.\n * Automatically maps damage types to injury types and applies blood effects.\n * \n * @example\n * ```typescript\n * // Recommended: Use PlayerInjuryTrackingManager for per-player tracking\n * import { playerInjuryManager } from '@/systems/bodypart';\n * const integration = playerInjuryManager.getIntegrationForPlayer('player-1');\n * \n * // Or create with explicit tracker for testing/custom scenarios\n * const handler = new CombatInjuryIntegration({\n *   ...DEFAULT_COMBAT_INJURY_CONFIG,\n *   tracker: new InjuryTracker(),\n * });\n * \n * // Record combat damage\n * handler.recordCombatDamage({\n *   damage: 35,\n *   bodyRegion: BodyRegion.TORSO,\n *   damageType: DamageType.BLUNT,\n * });\n * \n * // Get injuries for visualization\n * const injuries = handler.getInjuries();\n * ```\n * \n */\nexport class CombatInjuryIntegration {\n  private tracker: InjuryTracker;\n  private config: CombatInjuryConfig;\n\n  constructor(config: CombatInjuryConfig) {\n    this.config = config;\n    // Tracker is now required in CombatInjuryConfig interface\n    this.tracker = config.tracker;\n  }\n\n  /**\n   * Record injury from combat damage event.\n   * \n   * **Korean**: 전투 피해로부터 부상 기록\n   * \n   * Automatically determines injury type from damage type and applies\n   * appropriate visual effects.\n   * \n   * @param event - Combat damage event\n   * @returns Whether injury was recorded (false if damage too low)\n   * \n   */\n  recordCombatDamage(event: CombatDamageEvent): boolean {\n    if (!this.config.enabled) {\n      return false;\n    }\n\n    if (event.damage < this.config.minDamage) {\n      return false;\n    }\n\n    // Determine injury type from damage type\n    const injuryType = this.getInjuryTypeFromDamage(event.damageType);\n\n    // Get position for injury\n    const position =\n      event.position ?? getInjuryPositionWithOffset(event.bodyRegion, 0.15);\n\n    // Map body region to body part\n    const bodyPart = mapBodyRegionToBodyPart(event.bodyRegion);\n\n    // Record injury\n    const recordedInjury = this.tracker.recordInjury(\n      bodyPart,\n      event.bodyRegion,\n      position,\n      event.damage,\n      injuryType\n    );\n\n    // Return true only if the injury was actually recorded\n    return recordedInjury !== null;\n  }\n\n  /**\n   * Check if damage should trigger blood effects.\n   * \n   * **Korean**: 피해가 출혈 효과를 발생시켜야 하는지 확인\n   * \n   * @param damage - Damage amount\n   * @returns Whether to show blood effects\n   * \n   */\n  shouldShowBloodEffect(damage: number): boolean {\n    return damage > this.config.bloodThreshold;\n  }\n\n  /**\n   * Get injury type from damage type.\n   * \n   * **Korean**: 피해 타입으로부터 부상 타입 가져오기\n   * \n   * @param damageType - Type of damage dealt\n   * @returns Corresponding injury type for visualization\n   * \n   * @private\n   */\n  private getInjuryTypeFromDamage(damageType?: DamageType): InjuryType {\n    if (!damageType) {\n      return InjuryType.BRUISE; // Default to bruise\n    }\n\n    switch (damageType) {\n      case DamageType.BLUNT:\n      case DamageType.IMPACT:\n      case DamageType.CRUSHING:\n        return InjuryType.BRUISE;\n\n      case DamageType.PIERCING:\n      case DamageType.SHARP:\n        return InjuryType.CUT;\n\n      case DamageType.SLASHING:\n        return InjuryType.LACERATION;\n\n      case DamageType.JOINT:\n        return InjuryType.FRACTURE;\n\n      default:\n        return InjuryType.BRUISE;\n    }\n  }\n\n  /**\n   * Get all tracked injuries.\n   * \n   * **Korean**: 모든 추적된 부상 가져오기\n   * \n   * @returns Array of injuries\n   * \n   */\n  getInjuries() {\n    return this.tracker.getInjuries();\n  }\n\n  /**\n   * Get tracker instance.\n   * \n   * @returns InjuryTracker instance\n   * \n   */\n  getTracker(): InjuryTracker {\n    return this.tracker;\n  }\n\n  /**\n   * Clear all injuries (for new round/match).\n   * \n   * **Korean**: 모든 부상 초기화\n   * \n   */\n  clearInjuries(): void {\n    this.tracker.clearInjuries();\n  }\n\n  /**\n   * Remove expired injuries.\n   * \n   * **Korean**: 만료된 부상 제거\n   * \n   */\n  removeExpiredInjuries(): void {\n    this.tracker.removeExpiredInjuries();\n  }\n}\n"],"mappings":";;;;;;;;;;;AAkEA,IAAa,+BAAoE;CAC/E,SAAS;CACT,WAAW;CACX,gBAAgB;CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCD,IAAa,0BAAb,MAAqC;CACnC;CACA;CAEA,YAAY,QAA4B;EACtC,KAAK,SAAS;EAEd,KAAK,UAAU,OAAO;;;;;;;;;;;;;;CAexB,mBAAmB,OAAmC;EACpD,IAAI,CAAC,KAAK,OAAO,SACf,OAAO;EAGT,IAAI,MAAM,SAAS,KAAK,OAAO,WAC7B,OAAO;EAIT,MAAM,aAAa,KAAK,wBAAwB,MAAM,WAAW;EAGjE,MAAM,WACJ,MAAM,YAAY,4BAA4B,MAAM,YAAY,IAAK;EAGvE,MAAM,WAAW,wBAAwB,MAAM,WAAW;EAY1D,OATuB,KAAK,QAAQ,aAClC,UACA,MAAM,YACN,UACA,MAAM,QACN,WAIK,KAAmB;;;;;;;;;;;CAY5B,sBAAsB,QAAyB;EAC7C,OAAO,SAAS,KAAK,OAAO;;;;;;;;;;;;CAa9B,wBAAgC,YAAqC;EACnE,IAAI,CAAC,YACH,OAAO,WAAW;EAGpB,QAAQ,YAAR;GACE,KAAK,WAAW;GAChB,KAAK,WAAW;GAChB,KAAK,WAAW,UACd,OAAO,WAAW;GAEpB,KAAK,WAAW;GAChB,KAAK,WAAW,OACd,OAAO,WAAW;GAEpB,KAAK,WAAW,UACd,OAAO,WAAW;GAEpB,KAAK,WAAW,OACd,OAAO,WAAW;GAEpB,SACE,OAAO,WAAW;;;;;;;;;;;CAYxB,cAAc;EACZ,OAAO,KAAK,QAAQ,aAAa;;;;;;;;CASnC,aAA4B;EAC1B,OAAO,KAAK;;;;;;;;CASd,gBAAsB;EACpB,KAAK,QAAQ,eAAe;;;;;;;;CAS9B,wBAA8B;EAC5B,KAAK,QAAQ,uBAAuB"}

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

@@ -21,7 +21,6 @@ import { Injury } from "../../types/injury";
  * @param playerId - Optional player ID for multi-player scenarios
  * @returns Injury in TraumaOverlay3D format
  *
- * @public
  */
 export declare function convertInjuryForVisualization(injuryLocation: InjuryLocation, playerId?: string | number): Injury;
 /**
@@ -33,7 +32,6 @@ export declare function convertInjuryForVisualization(injuryLocation: InjuryLoca
  * @param playerId - Optional player ID
  * @returns Array of injuries in TraumaOverlay3D format
  *
- * @public
  */
 export declare function convertInjuriesForVisualization(injuryLocations: InjuryLocation[], playerId?: string | number): Injury[];
 //# sourceMappingURL=InjuryIntegration.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"InjuryIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/InjuryIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,CAeR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,cAAc,EAAE,EACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,EAAE,CAIV"}
+{"version":3,"file":"InjuryIntegration.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/InjuryIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,CAeR;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,cAAc,EAAE,EACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,EAAE,CAIV"}

package/lib/systems/bodypart/InjuryIntegration.js

@@ -8,7 +8,6 @@
 * @param playerId - Optional player ID for multi-player scenarios
 * @returns Injury in TraumaOverlay3D format
 * 
-* @public
 */
 function convertInjuryForVisualization(injuryLocation, playerId) {
 	return {
@@ -35,7 +34,6 @@ function convertInjuryForVisualization(injuryLocation, playerId) {
 * @param playerId - Optional player ID
 * @returns Array of injuries in TraumaOverlay3D format
 * 
-* @public
 */
 function convertInjuriesForVisualization(injuryLocations, playerId) {
 	return injuryLocations.map((loc) => convertInjuryForVisualization(loc, playerId));

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

@@ -1 +1 @@
-{"version":3,"file":"InjuryIntegration.js","names":[],"sources":["../../../src/systems/bodypart/InjuryIntegration.ts"],"sourcesContent":["/**\n * Injury Integration Utilities\n * \n * **Korean**: 부상 통합 유틸리티\n * \n * Utilities to convert between InjuryTracker format and TraumaOverlay3D format,\n * enabling seamless integration of injury tracking with visual trauma display.\n * \n * @module systems/bodypart/InjuryIntegration\n * @category Body Part System\n * @korean 부상통합\n */\n\nimport { InjuryLocation } from \"./InjuryTracker\";\nimport { Injury } from \"../../types/injury\";\n\n/**\n * Convert InjuryLocation to TraumaOverlay3D Injury format.\n * \n * **Korean**: InjuryLocation을 TraumaOverlay3D Injury 형식으로 변환\n * \n * @param injuryLocation - Injury from InjuryTracker\n * @param playerId - Optional player ID for multi-player scenarios\n * @returns Injury in TraumaOverlay3D format\n * \n * @public\n */\nexport function convertInjuryForVisualization(\n  injuryLocation: InjuryLocation,\n  playerId?: string | number\n): Injury {\n  return {\n    id: injuryLocation.id,\n    region: injuryLocation.bodyRegion,\n    type: injuryLocation.type,\n    position: [\n      injuryLocation.position.x,\n      injuryLocation.position.y,\n      injuryLocation.position.z,\n    ],\n    severity: injuryLocation.severity / 100, // Convert 0-100 to 0-1\n    hitCount: injuryLocation.hitCount,\n    timestamp: injuryLocation.timestamp,\n    playerId,\n  };\n}\n\n/**\n * Convert array of InjuryLocations to TraumaOverlay3D Injuries.\n * \n * **Korean**: InjuryLocation 배열을 TraumaOverlay3D Injuries로 변환\n * \n * @param injuryLocations - Array of injuries from InjuryTracker\n * @param playerId - Optional player ID\n * @returns Array of injuries in TraumaOverlay3D format\n * \n * @public\n */\nexport function convertInjuriesForVisualization(\n  injuryLocations: InjuryLocation[],\n  playerId?: string | number\n): Injury[] {\n  return injuryLocations.map((loc) =>\n    convertInjuryForVisualization(loc, playerId)\n  );\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,SAAgB,8BACd,gBACA,UACQ;CACR,OAAO;EACL,IAAI,eAAe;EACnB,QAAQ,eAAe;EACvB,MAAM,eAAe;EACrB,UAAU;GACR,eAAe,SAAS;GACxB,eAAe,SAAS;GACxB,eAAe,SAAS;GACzB;EACD,UAAU,eAAe,WAAW;EACpC,UAAU,eAAe;EACzB,WAAW,eAAe;EAC1B;EACD;;;;;;;;;;;;;AAcH,SAAgB,gCACd,iBACA,UACU;CACV,OAAO,gBAAgB,KAAK,QAC1B,8BAA8B,KAAK,SAAS,CAC7C"}
+{"version":3,"file":"InjuryIntegration.js","names":[],"sources":["../../../src/systems/bodypart/InjuryIntegration.ts"],"sourcesContent":["/**\n * Injury Integration Utilities\n * \n * **Korean**: 부상 통합 유틸리티\n * \n * Utilities to convert between InjuryTracker format and TraumaOverlay3D format,\n * enabling seamless integration of injury tracking with visual trauma display.\n * \n * @module systems/bodypart/InjuryIntegration\n * @category Body Part System\n * @korean 부상통합\n */\n\nimport { InjuryLocation } from \"./InjuryTracker\";\nimport { Injury } from \"../../types/injury\";\n\n/**\n * Convert InjuryLocation to TraumaOverlay3D Injury format.\n * \n * **Korean**: InjuryLocation을 TraumaOverlay3D Injury 형식으로 변환\n * \n * @param injuryLocation - Injury from InjuryTracker\n * @param playerId - Optional player ID for multi-player scenarios\n * @returns Injury in TraumaOverlay3D format\n * \n */\nexport function convertInjuryForVisualization(\n  injuryLocation: InjuryLocation,\n  playerId?: string | number\n): Injury {\n  return {\n    id: injuryLocation.id,\n    region: injuryLocation.bodyRegion,\n    type: injuryLocation.type,\n    position: [\n      injuryLocation.position.x,\n      injuryLocation.position.y,\n      injuryLocation.position.z,\n    ],\n    severity: injuryLocation.severity / 100, // Convert 0-100 to 0-1\n    hitCount: injuryLocation.hitCount,\n    timestamp: injuryLocation.timestamp,\n    playerId,\n  };\n}\n\n/**\n * Convert array of InjuryLocations to TraumaOverlay3D Injuries.\n * \n * **Korean**: InjuryLocation 배열을 TraumaOverlay3D Injuries로 변환\n * \n * @param injuryLocations - Array of injuries from InjuryTracker\n * @param playerId - Optional player ID\n * @returns Array of injuries in TraumaOverlay3D format\n * \n */\nexport function convertInjuriesForVisualization(\n  injuryLocations: InjuryLocation[],\n  playerId?: string | number\n): Injury[] {\n  return injuryLocations.map((loc) =>\n    convertInjuryForVisualization(loc, playerId)\n  );\n}\n"],"mappings":";;;;;;;;;;;AA0BA,SAAgB,8BACd,gBACA,UACQ;CACR,OAAO;EACL,IAAI,eAAe;EACnB,QAAQ,eAAe;EACvB,MAAM,eAAe;EACrB,UAAU;GACR,eAAe,SAAS;GACxB,eAAe,SAAS;GACxB,eAAe,SAAS;GACzB;EACD,UAAU,eAAe,WAAW;EACpC,UAAU,eAAe;EACzB,WAAW,eAAe;EAC1B;EACD;;;;;;;;;;;;AAaH,SAAgB,gCACd,iBACA,UACU;CACV,OAAO,gBAAgB,KAAK,QAC1B,8BAA8B,KAAK,SAAS,CAC7C"}