blacktrigram 0.7.43 → 0.7.45

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

@@ -33,7 +33,6 @@ import { BodyRegion } from "../../types/common";
  * Records a single injury with its location, severity, and cumulative hit count.
  * Used for progressive bruising visualization.
  *
- * @public
  * @category Injury Tracking
  * @korean 부상위치
  */
@@ -58,7 +57,6 @@ export interface InjuryLocation {
 /**
  * Configuration for injury tracking behavior.
  *
- * @public
  * @category Injury Tracking
  */
 export interface InjuryTrackerConfig {
@@ -76,7 +74,6 @@ export interface InjuryTrackerConfig {
 /**
  * Default injury tracker configuration.
  *
- * @public
  */
 export declare const DEFAULT_INJURY_TRACKER_CONFIG: InjuryTrackerConfig;
 /**
@@ -104,7 +101,6 @@ export declare const DEFAULT_INJURY_TRACKER_CONFIG: InjuryTrackerConfig;
  * const injuries = tracker.getInjuries();
  * ```
  *
- * @public
  * @category Body Part System
  */
 export declare class InjuryTracker {
@@ -128,7 +124,6 @@ export declare class InjuryTracker {
      * @param type - Type of injury
      * @returns The created or updated injury, or null if damage is below threshold
      *
-     * @public
      */
     recordInjury(bodyPart: BodyPart, bodyRegion: BodyRegion, position: THREE.Vector3, damage: number, type: InjuryType): InjuryLocation | null;
     /**
@@ -141,7 +136,6 @@ export declare class InjuryTracker {
      * @param threshold - Distance threshold
      * @returns Nearby injury or null
      *
-     * @public
      */
     findNearbyInjury(bodyPart: BodyPart, position: THREE.Vector3, threshold: number): InjuryLocation | null;
     /**
@@ -151,7 +145,6 @@ export declare class InjuryTracker {
      *
      * @returns Array of all injuries
      *
-     * @public
      */
     getInjuries(): InjuryLocation[];
     /**
@@ -162,7 +155,6 @@ export declare class InjuryTracker {
      * @param bodyPart - Body part to query
      * @returns Array of injuries on that body part
      *
-     * @public
      */
     getInjuriesByBodyPart(bodyPart: BodyPart): InjuryLocation[];
     /**
@@ -182,7 +174,6 @@ export declare class InjuryTracker {
      * @param hitCount - Number of hits to same location
      * @returns Hex color string
      *
-     * @public
      */
     getBruiseColor(severity: number, hitCount: number): string;
     /**
@@ -193,7 +184,6 @@ export declare class InjuryTracker {
      * @param damage - Damage amount
      * @returns Whether to show blood effects
      *
-     * @public
      */
     shouldShowBloodEffect(damage: number): boolean;
     /**
@@ -207,7 +197,6 @@ export declare class InjuryTracker {
      *
      * **Korean**: 모든 부상 초기화
      *
-     * @public
      */
     clearInjuries(): void;
     /**
@@ -215,7 +204,6 @@ export declare class InjuryTracker {
      *
      * **Korean**: 만료된 부상 제거
      *
-     * @public
      */
     removeExpiredInjuries(): void;
     /**
@@ -223,7 +211,6 @@ export declare class InjuryTracker {
      *
      * @returns Current number of tracked injuries
      *
-     * @public
      */
     getInjuryCount(): number;
 }
@@ -243,7 +230,6 @@ export declare class InjuryTracker {
  * const player2Tracker = new InjuryTracker();
  * ```
  *
- * @public
  * @deprecated Use an explicitly scoped {@link InjuryTracker} instance per
  * player/character instead of relying on this shared module singleton. This
  * export is retained temporarily for backward compatibility with existing

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

@@ -1 +1 @@
-{"version":3,"file":"InjuryTracker.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/InjuryTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAMlC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,mBAAmD;IAMvE;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,cAAc,GAAG,IAAI;IAuDxB;;;;;;;;;;;OAWG;IACH,gBAAgB,CACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,SAAS,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI;IAiBxB;;;;;;;;OAQG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE;IAI3D;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAa1D;;;;;;;;;OASG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;;OAMG;IACH,qBAAqB,IAAI,IAAI;IAe7B;;;;;;OAMG;IACH,cAAc,IAAI,MAAM;CAGzB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}
+{"version":3,"file":"InjuryTracker.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/InjuryTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAMlC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,mBAAmD;IAMvE;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CACV,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,cAAc,GAAG,IAAI;IAuDxB;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,EACvB,SAAS,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI;IAiBxB;;;;;;;OAOG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE;IAI3D;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAa1D;;;;;;;;OAQG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;OAKG;IACH,qBAAqB,IAAI,IAAI;IAe7B;;;;;OAKG;IACH,cAAc,IAAI,MAAM;CAGzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/lib/systems/bodypart/InjuryTracker.js

@@ -2,7 +2,6 @@
 /**
 * Default injury tracker configuration.
 * 
-* @public
 */
 var DEFAULT_INJURY_TRACKER_CONFIG = {
 	maxInjuries: 50,
@@ -36,7 +35,6 @@ var DEFAULT_INJURY_TRACKER_CONFIG = {
 * const injuries = tracker.getInjuries();
 * ```
 * 
-* @public
 * @category Body Part System
 */
 var InjuryTracker = class {
@@ -64,7 +62,6 @@ var InjuryTracker = class {
 	* @param type - Type of injury
 	* @returns The created or updated injury, or null if damage is below threshold
 	* 
-	* @public
 	*/
 	recordInjury(bodyPart, bodyRegion, position, damage, type) {
 		if (damage < this.config.minDamageForInjury) return null;
@@ -107,7 +104,6 @@ var InjuryTracker = class {
 	* @param threshold - Distance threshold
 	* @returns Nearby injury or null
 	* 
-	* @public
 	*/
 	findNearbyInjury(bodyPart, position, threshold) {
 		let closestInjury = null;
@@ -128,7 +124,6 @@ var InjuryTracker = class {
 	* 
 	* @returns Array of all injuries
 	* 
-	* @public
 	*/
 	getInjuries() {
 		return Array.from(this.injuries.values());
@@ -141,7 +136,6 @@ var InjuryTracker = class {
 	* @param bodyPart - Body part to query
 	* @returns Array of injuries on that body part
 	* 
-	* @public
 	*/
 	getInjuriesByBodyPart(bodyPart) {
 		return this.getInjuries().filter((injury) => injury.bodyPart === bodyPart);
@@ -163,7 +157,6 @@ var InjuryTracker = class {
 	* @param hitCount - Number of hits to same location
 	* @returns Hex color string
 	* 
-	* @public
 	*/
 	getBruiseColor(severity, hitCount) {
 		const effectiveSeverity = severity + Math.max(0, hitCount - 1) * 10;
@@ -179,7 +172,6 @@ var InjuryTracker = class {
 	* @param damage - Damage amount
 	* @returns Whether to show blood effects
 	* 
-	* @public
 	*/
 	shouldShowBloodEffect(damage) {
 		return damage > this.config.bloodEffectThreshold;
@@ -203,7 +195,6 @@ var InjuryTracker = class {
 	* 
 	* **Korean**: 모든 부상 초기화
 	* 
-	* @public
 	*/
 	clearInjuries() {
 		this.injuries.clear();
@@ -214,7 +205,6 @@ var InjuryTracker = class {
 	* 
 	* **Korean**: 만료된 부상 제거
 	* 
-	* @public
 	*/
 	removeExpiredInjuries() {
 		const now = Date.now();
@@ -227,7 +217,6 @@ var InjuryTracker = class {
 	* 
 	* @returns Current number of tracked injuries
 	* 
-	* @public
 	*/
 	getInjuryCount() {
 		return this.injuries.size;
@@ -249,7 +238,6 @@ var InjuryTracker = class {
 * const player2Tracker = new InjuryTracker();
 * ```
 *
-* @public
 * @deprecated Use an explicitly scoped {@link InjuryTracker} instance per
 * player/character instead of relying on this shared module singleton. This
 * export is retained temporarily for backward compatibility with existing

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

@@ -1 +1 @@
-{"version":3,"file":"InjuryTracker.js","names":[],"sources":["../../../src/systems/bodypart/InjuryTracker.ts"],"sourcesContent":["/**\n * Injury Tracking System\n * \n * **Korean**: 부상 추적 시스템\n * \n * Tracks individual injuries on character models for realistic trauma visualization.\n * Records injury location, type, severity, and timestamp for progressive bruising,\n * cuts, and bleeding effects during combat.\n * \n * ## Features\n * \n * - Track injuries by body part and 3D position\n * - Progressive bruising: Multiple hits to same location darken existing bruises\n * - Color-coded severity (getBruiseColor): Yellow (fresh), Purple (moderate), Dark red (severe)\n * - Note: TraumaOverlay3D uses different progression: Dark red → Indigo → Black\n * - Blood effects triggered when damage > 30 in single hit\n * - Injury persistence across combat rounds\n * - Nearby injury lookup using linear scan over tracked injuries (O(n))\n * \n * @module systems/bodypart/InjuryTracker\n * @category Body Part System\n * @korean 부상추적시스템\n */\n\nimport * as THREE from \"three\";\nimport { BodyPart } from \"./types\";\nimport { InjuryType } from \"../../types/injury\";\nimport { BodyRegion } from \"../../types/common\";\n\n/**\n * Individual injury location data.\n * \n * **Korean**: 부상 위치 데이터\n * \n * Records a single injury with its location, severity, and cumulative hit count.\n * Used for progressive bruising visualization.\n * \n * @public\n * @category Injury Tracking\n * @korean 부상위치\n */\nexport interface InjuryLocation {\n  /** Unique identifier */\n  readonly id: string;\n  /** Body part affected */\n  readonly bodyPart: BodyPart;\n  /** Body region for hit detection */\n  readonly bodyRegion: BodyRegion;\n  /** 3D position relative to character center */\n  readonly position: THREE.Vector3;\n  /** Damage severity (0-100) */\n  readonly severity: number;\n  /** Number of hits to this location (for progressive bruising) */\n  readonly hitCount: number;\n  /** Timestamp when injury occurred */\n  readonly timestamp: number;\n  /** Injury type */\n  readonly type: InjuryType;\n}\n\n/**\n * Configuration for injury tracking behavior.\n * \n * @public\n * @category Injury Tracking\n */\nexport interface InjuryTrackerConfig {\n  /** Maximum number of injuries to track per character */\n  readonly maxInjuries: number;\n  /** Distance threshold for considering injuries at same location (in units) */\n  readonly sameLocationThreshold: number;\n  /** Minimum damage required to create an injury */\n  readonly minDamageForInjury: number;\n  /** Damage threshold for blood effects */\n  readonly bloodEffectThreshold: number;\n  /** Time before injuries are removed/expired (milliseconds) */\n  readonly injuryExpirationTimeMs: number;\n}\n\n/**\n * Default injury tracker configuration.\n * \n * @public\n */\nexport const DEFAULT_INJURY_TRACKER_CONFIG: InjuryTrackerConfig = {\n  maxInjuries: 50, // Reasonable limit for performance\n  sameLocationThreshold: 0.6, // 0.6 units distance (accommodates ±0.15 randomization)\n  minDamageForInjury: 5, // Minimum 5 damage to show injury\n  bloodEffectThreshold: 30, // Blood effects when damage > 30\n  injuryExpirationTimeMs: 30000, // Injuries are removed after 30 seconds\n} as const;\n\n/**\n * Injury Tracker System.\n * \n * **Korean**: 부상 추적 시스템\n * \n * Manages injury recording and retrieval for trauma visualization.\n * Implements progressive bruising by tracking hit counts at similar locations.\n * \n * @example\n * ```typescript\n * const tracker = new InjuryTracker();\n * \n * // Record injury from hit\n * const injury = tracker.recordInjury(\n *   BodyPart.TORSO_UPPER,\n *   BodyRegion.TORSO,\n *   new THREE.Vector3(0, 1.5, 0),\n *   25,\n *   InjuryType.BRUISE\n * );\n * \n * // Get all injuries for visualization\n * const injuries = tracker.getInjuries();\n * ```\n * \n * @public\n * @category Body Part System\n */\nexport class InjuryTracker {\n  private injuries: Map<string, InjuryLocation>;\n  private config: InjuryTrackerConfig;\n  private nextId: number;\n\n  constructor(config: InjuryTrackerConfig = DEFAULT_INJURY_TRACKER_CONFIG) {\n    this.injuries = new Map();\n    this.config = config;\n    this.nextId = 0;\n  }\n\n  /**\n   * Record a new injury or update existing one at similar location.\n   * \n   * **Korean**: 부상 기록\n   * \n   * If an injury exists near the hit position, it updates the existing injury\n   * with increased severity and hit count (progressive bruising). Otherwise,\n   * creates a new injury.\n   * \n   * @param bodyPart - Body part affected\n   * @param bodyRegion - Body region for damage distribution\n   * @param position - 3D position relative to character center\n   * @param damage - Damage amount (0-100)\n   * @param type - Type of injury\n   * @returns The created or updated injury, or null if damage is below threshold\n   * \n   * @public\n   */\n  recordInjury(\n    bodyPart: BodyPart,\n    bodyRegion: BodyRegion,\n    position: THREE.Vector3,\n    damage: number,\n    type: InjuryType\n  ): InjuryLocation | null {\n    // Check if damage is significant enough to track\n    if (damage < this.config.minDamageForInjury) {\n      return null;\n    }\n\n    // Find nearby injury at similar location (same body part)\n    const existing = this.findNearbyInjury(bodyPart, position, this.config.sameLocationThreshold);\n\n    // Only merge injuries that also match type and body region to avoid\n    // incorrectly combining different injury types at the same spot\n    const shouldMerge =\n      !!existing &&\n      existing.type === type &&\n      existing.bodyRegion === bodyRegion;\n\n    if (shouldMerge && existing) {\n      // Progressive bruising - update existing injury\n      const newSeverity = Math.min(100, existing.severity + damage / 2);\n      const newHitCount = existing.hitCount + 1;\n\n      const updated: InjuryLocation = {\n        ...existing,\n        severity: newSeverity,\n        hitCount: newHitCount,\n        timestamp: Date.now(),\n      };\n\n      this.injuries.set(existing.id, updated);\n      return updated;\n    } else {\n      // Create new injury\n      const id = `injury-${this.nextId++}`;\n      const injury: InjuryLocation = {\n        id,\n        bodyPart,\n        bodyRegion,\n        position: position.clone(),\n        severity: damage,\n        hitCount: 1,\n        timestamp: Date.now(),\n        type,\n      };\n\n      this.injuries.set(id, injury);\n\n      // Enforce max injuries limit\n      if (this.injuries.size > this.config.maxInjuries) {\n        this.removeOldestInjury();\n      }\n\n      return injury;\n    }\n  }\n\n  /**\n   * Find injury near a given position on the same body part.\n   * \n   * **Korean**: 인근 부상 찾기\n   * \n   * @param bodyPart - Body part to search\n   * @param position - Position to search near\n   * @param threshold - Distance threshold\n   * @returns Nearby injury or null\n   * \n   * @public\n   */\n  findNearbyInjury(\n    bodyPart: BodyPart,\n    position: THREE.Vector3,\n    threshold: number\n  ): InjuryLocation | null {\n    let closestInjury: InjuryLocation | null = null;\n    let closestDistance = threshold;\n\n    for (const injury of this.injuries.values()) {\n      if (injury.bodyPart === bodyPart) {\n        const distance = injury.position.distanceTo(position);\n        if (distance < closestDistance) {\n          closestDistance = distance;\n          closestInjury = injury;\n        }\n      }\n    }\n\n    return closestInjury;\n  }\n\n  /**\n   * Get all tracked injuries.\n   * \n   * **Korean**: 모든 부상 조회\n   * \n   * @returns Array of all injuries\n   * \n   * @public\n   */\n  getInjuries(): InjuryLocation[] {\n    return Array.from(this.injuries.values());\n  }\n\n  /**\n   * Get injuries for a specific body part.\n   * \n   * **Korean**: 신체 부위 부상 조회\n   * \n   * @param bodyPart - Body part to query\n   * @returns Array of injuries on that body part\n   * \n   * @public\n   */\n  getInjuriesByBodyPart(bodyPart: BodyPart): InjuryLocation[] {\n    return this.getInjuries().filter((injury) => injury.bodyPart === bodyPart);\n  }\n\n  /**\n   * Get bruise color based on severity and hit count.\n   * \n   * **Korean**: 타박상 색상 가져오기\n   * \n   * Progressive color scheme (for reference - TraumaOverlay3D uses its own colors):\n   * - Light bruising (severity < 20): Yellow (#ffeb3b)\n   * - Moderate bruising (severity < 50): Purple (#9c27b0)\n   * - Severe bruising (severity >= 50): Dark red (#b71c1c)\n   * \n   * Note: TraumaOverlay3D uses Dark red → Indigo → Black progression.\n   * Consider using TraumaOverlay3D's getBruiseColor for consistent visualization.\n   * \n   * @param severity - Injury severity (0-100)\n   * @param hitCount - Number of hits to same location\n   * @returns Hex color string\n   * \n   * @public\n   */\n  getBruiseColor(severity: number, hitCount: number): string {\n    // Progressive darkening with hit count (subtract 1 since first hit shouldn't darken)\n    const effectiveSeverity = severity + Math.max(0, hitCount - 1) * 10;\n\n    if (effectiveSeverity < 20) {\n      return \"#ffeb3b\"; // Yellow - light bruising\n    } else if (effectiveSeverity < 50) {\n      return \"#9c27b0\"; // Purple - moderate bruising\n    } else {\n      return \"#b71c1c\"; // Dark red - severe bruising\n    }\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.bloodEffectThreshold;\n  }\n\n  /**\n   * Remove oldest injury to maintain performance.\n   * \n   * @private\n   */\n  private removeOldestInjury(): void {\n    let oldestId: string | null = null;\n    let oldestTimestamp = Infinity;\n\n    for (const [id, injury] of this.injuries.entries()) {\n      if (injury.timestamp < oldestTimestamp) {\n        oldestTimestamp = injury.timestamp;\n        oldestId = id;\n      }\n    }\n\n    if (oldestId) {\n      this.injuries.delete(oldestId);\n    }\n  }\n\n  /**\n   * Clear all injuries (for new match/round).\n   * \n   * **Korean**: 모든 부상 초기화\n   * \n   * @public\n   */\n  clearInjuries(): void {\n    this.injuries.clear();\n    this.nextId = 0;\n  }\n\n  /**\n   * Remove injuries older than expiration time.\n   * \n   * **Korean**: 만료된 부상 제거\n   * \n   * @public\n   */\n  removeExpiredInjuries(): void {\n    const now = Date.now();\n    const expiredIds: string[] = [];\n\n    for (const [id, injury] of this.injuries.entries()) {\n      if (now - injury.timestamp > this.config.injuryExpirationTimeMs) {\n        expiredIds.push(id);\n      }\n    }\n\n    for (const id of expiredIds) {\n      this.injuries.delete(id);\n    }\n  }\n\n  /**\n   * Get injury count for performance monitoring.\n   * \n   * @returns Current number of tracked injuries\n   * \n   * @public\n   */\n  getInjuryCount(): number {\n    return this.injuries.size;\n  }\n}\n\n/**\n * Legacy module-level injury tracker singleton.\n *\n * **Korean**: 레거시 모듈 전역 부상 추적기\n *\n * **Warning**: This singleton does **not** track any playerId/character identifier\n * on injuries. All recorded injuries are stored together in a single collection.\n * For any scenario with more than one character (including 1v1 combat), you\n * **must** create a separate {@link InjuryTracker} instance per character to\n * avoid mixing injuries between characters:\n *\n * ```typescript\n * const player1Tracker = new InjuryTracker();\n * const player2Tracker = new InjuryTracker();\n * ```\n *\n * @public\n * @deprecated Use an explicitly scoped {@link InjuryTracker} instance per\n * player/character instead of relying on this shared module singleton. This\n * export is retained temporarily for backward compatibility with existing\n * consumers importing `injuryTracker` from `systems/bodypart` and will be\n * removed in a future major release.\n */\nexport const injuryTracker = new InjuryTracker();\n"],"mappings":"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"}
+{"version":3,"file":"InjuryTracker.js","names":[],"sources":["../../../src/systems/bodypart/InjuryTracker.ts"],"sourcesContent":["/**\n * Injury Tracking System\n * \n * **Korean**: 부상 추적 시스템\n * \n * Tracks individual injuries on character models for realistic trauma visualization.\n * Records injury location, type, severity, and timestamp for progressive bruising,\n * cuts, and bleeding effects during combat.\n * \n * ## Features\n * \n * - Track injuries by body part and 3D position\n * - Progressive bruising: Multiple hits to same location darken existing bruises\n * - Color-coded severity (getBruiseColor): Yellow (fresh), Purple (moderate), Dark red (severe)\n * - Note: TraumaOverlay3D uses different progression: Dark red → Indigo → Black\n * - Blood effects triggered when damage > 30 in single hit\n * - Injury persistence across combat rounds\n * - Nearby injury lookup using linear scan over tracked injuries (O(n))\n * \n * @module systems/bodypart/InjuryTracker\n * @category Body Part System\n * @korean 부상추적시스템\n */\n\nimport * as THREE from \"three\";\nimport { BodyPart } from \"./types\";\nimport { InjuryType } from \"../../types/injury\";\nimport { BodyRegion } from \"../../types/common\";\n\n/**\n * Individual injury location data.\n * \n * **Korean**: 부상 위치 데이터\n * \n * Records a single injury with its location, severity, and cumulative hit count.\n * Used for progressive bruising visualization.\n * \n * @category Injury Tracking\n * @korean 부상위치\n */\nexport interface InjuryLocation {\n  /** Unique identifier */\n  readonly id: string;\n  /** Body part affected */\n  readonly bodyPart: BodyPart;\n  /** Body region for hit detection */\n  readonly bodyRegion: BodyRegion;\n  /** 3D position relative to character center */\n  readonly position: THREE.Vector3;\n  /** Damage severity (0-100) */\n  readonly severity: number;\n  /** Number of hits to this location (for progressive bruising) */\n  readonly hitCount: number;\n  /** Timestamp when injury occurred */\n  readonly timestamp: number;\n  /** Injury type */\n  readonly type: InjuryType;\n}\n\n/**\n * Configuration for injury tracking behavior.\n * \n * @category Injury Tracking\n */\nexport interface InjuryTrackerConfig {\n  /** Maximum number of injuries to track per character */\n  readonly maxInjuries: number;\n  /** Distance threshold for considering injuries at same location (in units) */\n  readonly sameLocationThreshold: number;\n  /** Minimum damage required to create an injury */\n  readonly minDamageForInjury: number;\n  /** Damage threshold for blood effects */\n  readonly bloodEffectThreshold: number;\n  /** Time before injuries are removed/expired (milliseconds) */\n  readonly injuryExpirationTimeMs: number;\n}\n\n/**\n * Default injury tracker configuration.\n * \n */\nexport const DEFAULT_INJURY_TRACKER_CONFIG: InjuryTrackerConfig = {\n  maxInjuries: 50, // Reasonable limit for performance\n  sameLocationThreshold: 0.6, // 0.6 units distance (accommodates ±0.15 randomization)\n  minDamageForInjury: 5, // Minimum 5 damage to show injury\n  bloodEffectThreshold: 30, // Blood effects when damage > 30\n  injuryExpirationTimeMs: 30000, // Injuries are removed after 30 seconds\n} as const;\n\n/**\n * Injury Tracker System.\n * \n * **Korean**: 부상 추적 시스템\n * \n * Manages injury recording and retrieval for trauma visualization.\n * Implements progressive bruising by tracking hit counts at similar locations.\n * \n * @example\n * ```typescript\n * const tracker = new InjuryTracker();\n * \n * // Record injury from hit\n * const injury = tracker.recordInjury(\n *   BodyPart.TORSO_UPPER,\n *   BodyRegion.TORSO,\n *   new THREE.Vector3(0, 1.5, 0),\n *   25,\n *   InjuryType.BRUISE\n * );\n * \n * // Get all injuries for visualization\n * const injuries = tracker.getInjuries();\n * ```\n * \n * @category Body Part System\n */\nexport class InjuryTracker {\n  private injuries: Map<string, InjuryLocation>;\n  private config: InjuryTrackerConfig;\n  private nextId: number;\n\n  constructor(config: InjuryTrackerConfig = DEFAULT_INJURY_TRACKER_CONFIG) {\n    this.injuries = new Map();\n    this.config = config;\n    this.nextId = 0;\n  }\n\n  /**\n   * Record a new injury or update existing one at similar location.\n   * \n   * **Korean**: 부상 기록\n   * \n   * If an injury exists near the hit position, it updates the existing injury\n   * with increased severity and hit count (progressive bruising). Otherwise,\n   * creates a new injury.\n   * \n   * @param bodyPart - Body part affected\n   * @param bodyRegion - Body region for damage distribution\n   * @param position - 3D position relative to character center\n   * @param damage - Damage amount (0-100)\n   * @param type - Type of injury\n   * @returns The created or updated injury, or null if damage is below threshold\n   * \n   */\n  recordInjury(\n    bodyPart: BodyPart,\n    bodyRegion: BodyRegion,\n    position: THREE.Vector3,\n    damage: number,\n    type: InjuryType\n  ): InjuryLocation | null {\n    // Check if damage is significant enough to track\n    if (damage < this.config.minDamageForInjury) {\n      return null;\n    }\n\n    // Find nearby injury at similar location (same body part)\n    const existing = this.findNearbyInjury(bodyPart, position, this.config.sameLocationThreshold);\n\n    // Only merge injuries that also match type and body region to avoid\n    // incorrectly combining different injury types at the same spot\n    const shouldMerge =\n      !!existing &&\n      existing.type === type &&\n      existing.bodyRegion === bodyRegion;\n\n    if (shouldMerge && existing) {\n      // Progressive bruising - update existing injury\n      const newSeverity = Math.min(100, existing.severity + damage / 2);\n      const newHitCount = existing.hitCount + 1;\n\n      const updated: InjuryLocation = {\n        ...existing,\n        severity: newSeverity,\n        hitCount: newHitCount,\n        timestamp: Date.now(),\n      };\n\n      this.injuries.set(existing.id, updated);\n      return updated;\n    } else {\n      // Create new injury\n      const id = `injury-${this.nextId++}`;\n      const injury: InjuryLocation = {\n        id,\n        bodyPart,\n        bodyRegion,\n        position: position.clone(),\n        severity: damage,\n        hitCount: 1,\n        timestamp: Date.now(),\n        type,\n      };\n\n      this.injuries.set(id, injury);\n\n      // Enforce max injuries limit\n      if (this.injuries.size > this.config.maxInjuries) {\n        this.removeOldestInjury();\n      }\n\n      return injury;\n    }\n  }\n\n  /**\n   * Find injury near a given position on the same body part.\n   * \n   * **Korean**: 인근 부상 찾기\n   * \n   * @param bodyPart - Body part to search\n   * @param position - Position to search near\n   * @param threshold - Distance threshold\n   * @returns Nearby injury or null\n   * \n   */\n  findNearbyInjury(\n    bodyPart: BodyPart,\n    position: THREE.Vector3,\n    threshold: number\n  ): InjuryLocation | null {\n    let closestInjury: InjuryLocation | null = null;\n    let closestDistance = threshold;\n\n    for (const injury of this.injuries.values()) {\n      if (injury.bodyPart === bodyPart) {\n        const distance = injury.position.distanceTo(position);\n        if (distance < closestDistance) {\n          closestDistance = distance;\n          closestInjury = injury;\n        }\n      }\n    }\n\n    return closestInjury;\n  }\n\n  /**\n   * Get all tracked injuries.\n   * \n   * **Korean**: 모든 부상 조회\n   * \n   * @returns Array of all injuries\n   * \n   */\n  getInjuries(): InjuryLocation[] {\n    return Array.from(this.injuries.values());\n  }\n\n  /**\n   * Get injuries for a specific body part.\n   * \n   * **Korean**: 신체 부위 부상 조회\n   * \n   * @param bodyPart - Body part to query\n   * @returns Array of injuries on that body part\n   * \n   */\n  getInjuriesByBodyPart(bodyPart: BodyPart): InjuryLocation[] {\n    return this.getInjuries().filter((injury) => injury.bodyPart === bodyPart);\n  }\n\n  /**\n   * Get bruise color based on severity and hit count.\n   * \n   * **Korean**: 타박상 색상 가져오기\n   * \n   * Progressive color scheme (for reference - TraumaOverlay3D uses its own colors):\n   * - Light bruising (severity < 20): Yellow (#ffeb3b)\n   * - Moderate bruising (severity < 50): Purple (#9c27b0)\n   * - Severe bruising (severity >= 50): Dark red (#b71c1c)\n   * \n   * Note: TraumaOverlay3D uses Dark red → Indigo → Black progression.\n   * Consider using TraumaOverlay3D's getBruiseColor for consistent visualization.\n   * \n   * @param severity - Injury severity (0-100)\n   * @param hitCount - Number of hits to same location\n   * @returns Hex color string\n   * \n   */\n  getBruiseColor(severity: number, hitCount: number): string {\n    // Progressive darkening with hit count (subtract 1 since first hit shouldn't darken)\n    const effectiveSeverity = severity + Math.max(0, hitCount - 1) * 10;\n\n    if (effectiveSeverity < 20) {\n      return \"#ffeb3b\"; // Yellow - light bruising\n    } else if (effectiveSeverity < 50) {\n      return \"#9c27b0\"; // Purple - moderate bruising\n    } else {\n      return \"#b71c1c\"; // Dark red - severe bruising\n    }\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.bloodEffectThreshold;\n  }\n\n  /**\n   * Remove oldest injury to maintain performance.\n   * \n   * @private\n   */\n  private removeOldestInjury(): void {\n    let oldestId: string | null = null;\n    let oldestTimestamp = Infinity;\n\n    for (const [id, injury] of this.injuries.entries()) {\n      if (injury.timestamp < oldestTimestamp) {\n        oldestTimestamp = injury.timestamp;\n        oldestId = id;\n      }\n    }\n\n    if (oldestId) {\n      this.injuries.delete(oldestId);\n    }\n  }\n\n  /**\n   * Clear all injuries (for new match/round).\n   * \n   * **Korean**: 모든 부상 초기화\n   * \n   */\n  clearInjuries(): void {\n    this.injuries.clear();\n    this.nextId = 0;\n  }\n\n  /**\n   * Remove injuries older than expiration time.\n   * \n   * **Korean**: 만료된 부상 제거\n   * \n   */\n  removeExpiredInjuries(): void {\n    const now = Date.now();\n    const expiredIds: string[] = [];\n\n    for (const [id, injury] of this.injuries.entries()) {\n      if (now - injury.timestamp > this.config.injuryExpirationTimeMs) {\n        expiredIds.push(id);\n      }\n    }\n\n    for (const id of expiredIds) {\n      this.injuries.delete(id);\n    }\n  }\n\n  /**\n   * Get injury count for performance monitoring.\n   * \n   * @returns Current number of tracked injuries\n   * \n   */\n  getInjuryCount(): number {\n    return this.injuries.size;\n  }\n}\n\n/**\n * Legacy module-level injury tracker singleton.\n *\n * **Korean**: 레거시 모듈 전역 부상 추적기\n *\n * **Warning**: This singleton does **not** track any playerId/character identifier\n * on injuries. All recorded injuries are stored together in a single collection.\n * For any scenario with more than one character (including 1v1 combat), you\n * **must** create a separate {@link InjuryTracker} instance per character to\n * avoid mixing injuries between characters:\n *\n * ```typescript\n * const player1Tracker = new InjuryTracker();\n * const player2Tracker = new InjuryTracker();\n * ```\n *\n * @deprecated Use an explicitly scoped {@link InjuryTracker} instance per\n * player/character instead of relying on this shared module singleton. This\n * export is retained temporarily for backward compatibility with existing\n * consumers importing `injuryTracker` from `systems/bodypart` and will be\n * removed in a future major release.\n */\nexport const injuryTracker = new InjuryTracker();\n"],"mappings":"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"}

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

@@ -58,7 +58,6 @@ import { BodyPart, BodyPartHealth, BodyPartMaxHealth, MovementPenalty, InstantMo
  * const actualSpeed = baseSpeed * penalty.speedMultiplier;
  * ```
  *
- * @public
  * @category Body Part System
  */
 export declare class MovementPenaltySystem {
@@ -76,7 +75,6 @@ export declare class MovementPenaltySystem {
      * @param currentTime - Current timestamp for instant penalty expiry check
      * @returns Movement penalty with all modifiers
      *
-     * @public
      */
     calculateMovementPenalty(health: BodyPartHealth, maxHealth: BodyPartMaxHealth, instantPenalty?: InstantMovementPenalty, currentTime?: number): MovementPenalty;
     /**
@@ -104,7 +102,6 @@ export declare class MovementPenaltySystem {
      * @param movementDirection - Direction of movement (positive = right, negative = left)
      * @returns Additional speed multiplier for asymmetric penalty
      *
-     * @public
      */
     calculateAsymmetricPenalty(health: BodyPartHealth, maxHealth: BodyPartMaxHealth, movementDirection: {
         x: number;
@@ -122,7 +119,6 @@ export declare class MovementPenaltySystem {
      * @param currentTime - Timestamp when strike occurred
      * @returns Instant movement penalty configuration
      *
-     * @public
      */
     createInstantPenalty(affectedPart: BodyPart.LEG_LEFT | BodyPart.LEG_RIGHT, currentTime?: number): InstantMovementPenalty;
     /**
@@ -137,7 +133,6 @@ export declare class MovementPenaltySystem {
      * @param maxHealth - Maximum health values
      * @returns True if player should enter vulnerable state
      *
-     * @public
      */
     shouldEnterVulnerableState(health: BodyPartHealth, maxHealth: BodyPartMaxHealth): boolean;
     /**
@@ -152,7 +147,6 @@ export declare class MovementPenaltySystem {
      * @param maxHealth - Maximum health values
      * @returns True if player should enter helpless state
      *
-     * @public
      */
     shouldEnterHelplessState(health: BodyPartHealth, maxHealth: BodyPartMaxHealth): boolean;
     /**
@@ -171,7 +165,6 @@ export declare class MovementPenaltySystem {
      * @param currentTime - Current timestamp
      * @returns Final movement speed with all penalties applied
      *
-     * @public
      */
     calculateModifiedSpeed(baseSpeed: number, health: BodyPartHealth, maxHealth: BodyPartMaxHealth, movementDirection: {
         x: number;
@@ -185,7 +178,6 @@ export declare class MovementPenaltySystem {
  *
  * Provides global access to the movement penalty system throughout the game.
  *
- * @public
  */
 export declare const movementPenaltySystem: MovementPenaltySystem;
 //# sourceMappingURL=MovementPenaltySystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MovementPenaltySystem.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/MovementPenaltySystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EAEjB,eAAe,EACf,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,cAAc,CAAC,EAAE,sBAAsB,EACvC,WAAW,GAAE,MAAmB,GAC/B,eAAe;IAiDlB;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;;;;;;;;;;;;;;OAeG;IACH,0BAA0B,CACxB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,MAAM;IAqCT;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAClB,YAAY,EAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,SAAS,EACpD,WAAW,GAAE,MAAmB,GAC/B,sBAAsB;IASzB;;;;;;;;;;;;;OAaG;IACH,0BAA0B,CACxB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,OAAO;IASV;;;;;;;;;;;;;OAaG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,OAAO;IAWV;;;;;;;;;;;;;;;;;OAiBG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3C,cAAc,CAAC,EAAE,sBAAsB,EACvC,WAAW,GAAE,MAAmB,GAC/B,MAAM;CAmBV;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}
+{"version":3,"file":"MovementPenaltySystem.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/MovementPenaltySystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EAEjB,eAAe,EACf,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;;;;;;OAcG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,cAAc,CAAC,EAAE,sBAAsB,EACvC,WAAW,GAAE,MAAmB,GAC/B,eAAe;IAiDlB;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;;;;;;;;;;;;;OAcG;IACH,0BAA0B,CACxB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,MAAM;IAqCT;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAClB,YAAY,EAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,SAAS,EACpD,WAAW,GAAE,MAAmB,GAC/B,sBAAsB;IASzB;;;;;;;;;;;;OAYG;IACH,0BAA0B,CACxB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,OAAO;IASV;;;;;;;;;;;;OAYG;IACH,wBAAwB,CACtB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,GAC3B,OAAO;IAWV;;;;;;;;;;;;;;;;OAgBG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3C,cAAc,CAAC,EAAE,sBAAsB,EACvC,WAAW,GAAE,MAAmB,GAC/B,MAAM;CAmBV;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/lib/systems/bodypart/MovementPenaltySystem.js

@@ -59,7 +59,6 @@ import { LegInjuryState, MOVEMENT_PENALTY_CONSTANTS } from "./types.js";
 * const actualSpeed = baseSpeed * penalty.speedMultiplier;
 * ```
 * 
-* @public
 * @category Body Part System
 */
 var MovementPenaltySystem = class {
@@ -77,7 +76,6 @@ var MovementPenaltySystem = class {
 	* @param currentTime - Current timestamp for instant penalty expiry check
 	* @returns Movement penalty with all modifiers
 	* 
-	* @public
 	*/
 	calculateMovementPenalty(health, maxHealth, instantPenalty, currentTime = Date.now()) {
 		const avgLegHealth = (health.legLeft / maxHealth.legLeft + health.legRight / maxHealth.legRight) / 2;
@@ -141,7 +139,6 @@ var MovementPenaltySystem = class {
 	* @param movementDirection - Direction of movement (positive = right, negative = left)
 	* @returns Additional speed multiplier for asymmetric penalty
 	* 
-	* @public
 	*/
 	calculateAsymmetricPenalty(health, maxHealth, movementDirection) {
 		const leftLegPercent = health.legLeft / maxHealth.legLeft;
@@ -169,7 +166,6 @@ var MovementPenaltySystem = class {
 	* @param currentTime - Timestamp when strike occurred
 	* @returns Instant movement penalty configuration
 	* 
-	* @public
 	*/
 	createInstantPenalty(affectedPart, currentTime = Date.now()) {
 		return {
@@ -191,7 +187,6 @@ var MovementPenaltySystem = class {
 	* @param maxHealth - Maximum health values
 	* @returns True if player should enter vulnerable state
 	* 
-	* @public
 	*/
 	shouldEnterVulnerableState(health, maxHealth) {
 		return (health.legLeft / maxHealth.legLeft + health.legRight / maxHealth.legRight) / 2 < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP;
@@ -208,7 +203,6 @@ var MovementPenaltySystem = class {
 	* @param maxHealth - Maximum health values
 	* @returns True if player should enter helpless state
 	* 
-	* @public
 	*/
 	shouldEnterHelplessState(health, maxHealth) {
 		const leftLegPercent = health.legLeft / maxHealth.legLeft;
@@ -231,7 +225,6 @@ var MovementPenaltySystem = class {
 	* @param currentTime - Current timestamp
 	* @returns Final movement speed with all penalties applied
 	* 
-	* @public
 	*/
 	calculateModifiedSpeed(baseSpeed, health, maxHealth, movementDirection, instantPenalty, currentTime = Date.now()) {
 		const penalty = this.calculateMovementPenalty(health, maxHealth, instantPenalty, currentTime);
@@ -246,7 +239,6 @@ var MovementPenaltySystem = class {
 * 
 * Provides global access to the movement penalty system throughout the game.
 * 
-* @public
 */
 var movementPenaltySystem = new MovementPenaltySystem();
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"MovementPenaltySystem.js","names":[],"sources":["../../../src/systems/bodypart/MovementPenaltySystem.ts"],"sourcesContent":["/**\n * Movement Penalty System\n * \n * **Korean**: 이동 패널티 시스템\n * \n * Implements injury-based movement penalties where leg and body damage reduces\n * movement speed, stance changes, and mobility capabilities. This system applies\n * realistic combat trauma effects based on Korean martial arts principles.\n * \n * ## System Features\n * \n * - Progressive speed reduction based on leg health\n * - Asymmetric damage (left/right leg affects directional movement)\n * - Instant penalties from knee/ankle strikes (5 seconds)\n * - Stance change duration penalties\n * - Advanced stance restrictions when critically injured\n * - Balance integration for VULNERABLE/HELPLESS states\n * \n * ## Movement Speed Penalties\n * \n * | Leg Health | State | Speed | Can Run |\n * |------------|-------|-------|---------|\n * | 100-70% | Normal | 100% | Yes |\n * | 69-50% | Limping | 80% | Yes |\n * | 49-30% | Severe Limp | 60% | Yes |\n * | <30% | Hobbled | 40% | No |\n * \n * ## Stance Change Penalties\n * \n * - Legs <50% health: Stance change takes 2x longer\n * - Legs <30% health: Cannot change to advanced stances (only basic)\n * \n * @module systems/bodypart/MovementPenaltySystem\n * @category Body Part System\n * @korean 이동패널티시스템\n */\n\nimport {\n  BodyPart,\n  BodyPartHealth,\n  BodyPartMaxHealth,\n  LegInjuryState,\n  MovementPenalty,\n  InstantMovementPenalty,\n  MOVEMENT_PENALTY_CONSTANTS,\n} from \"./types\";\n\n/**\n * Movement Penalty System class.\n * \n * **Korean**: 이동 패널티 시스템 클래스\n * \n * Calculates movement penalties from leg injuries, manages instant penalties\n * from knee/ankle strikes, and integrates with balance system.\n * \n * @example\n * ```typescript\n * const system = new MovementPenaltySystem();\n * \n * // Calculate current movement penalty\n * const penalty = system.calculateMovementPenalty(\n *   bodyPartHealth,\n *   maxHealth,\n *   activeInstantPenalty\n * );\n * \n * // Apply to movement speed\n * const actualSpeed = baseSpeed * penalty.speedMultiplier;\n * ```\n * \n * @public\n * @category Body Part System\n */\nexport class MovementPenaltySystem {\n  /**\n   * Calculate movement penalty from body part health.\n   * \n   * **Korean**: 이동 패널티 계산\n   * \n   * Analyzes leg health and returns comprehensive movement penalty including\n   * speed multiplier, stance change penalties, and balance effects.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param instantPenalty - Optional active instant penalty\n   * @param currentTime - Current timestamp for instant penalty expiry check\n   * @returns Movement penalty with all modifiers\n   * \n   * @public\n   */\n  calculateMovementPenalty(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    instantPenalty?: InstantMovementPenalty,\n    currentTime: number = Date.now()\n  ): MovementPenalty {\n    // Calculate average leg health percentage\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n    const avgLegHealth = (leftLegPercent + rightLegPercent) / 2;\n\n    // Determine injury state and base speed multiplier\n    const { injuryState, speedMultiplier } = this.getInjuryStateFromHealth(avgLegHealth);\n\n    // Check if instant penalty is active\n    const hasActiveInstantPenalty = \n      instantPenalty !== undefined &&\n      instantPenalty.appliedAt + instantPenalty.duration > currentTime;\n\n    // Apply instant penalty if active, otherwise use base multiplier\n    const finalSpeedMultiplier = hasActiveInstantPenalty && instantPenalty\n      ? Math.min(speedMultiplier, instantPenalty.speedMultiplier)\n      : speedMultiplier;\n\n    // Calculate stance change penalty\n    const stanceChangePenalty = \n      avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.CRITICAL_THRESHOLD\n        ? MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.INJURED\n        : MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.NORMAL;\n\n    // Determine if advanced stances are restricted\n    const advancedStancesRestricted =\n      avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.RESTRICTION_THRESHOLD;\n\n    // Calculate balance modifier (lower leg health = worse balance)\n    const balanceModifier = Math.max(0.3, avgLegHealth);\n\n    // Determine if player can run\n    const canRun = injuryState !== LegInjuryState.HOBBLED;\n\n    return {\n      speedMultiplier: finalSpeedMultiplier,\n      canRun,\n      injuryState,\n      stanceChangePenalty,\n      advancedStancesRestricted,\n      balanceModifier,\n      hasInstantPenalty: hasActiveInstantPenalty,\n      instantPenaltyExpiry: hasActiveInstantPenalty && instantPenalty\n        ? instantPenalty.appliedAt + instantPenalty.duration\n        : 0,\n    };\n  }\n\n  /**\n   * Get injury state and speed multiplier from leg health percentage.\n   * \n   * **Korean**: 부상 상태 및 속도 배율 조회\n   * \n   * @param legHealthPercent - Average leg health as percentage (0.0-1.0)\n   * @returns Injury state and corresponding speed multiplier\n   * \n   * @private\n   */\n  private getInjuryStateFromHealth(legHealthPercent: number): {\n    injuryState: LegInjuryState;\n    speedMultiplier: number;\n  } {\n    const { THRESHOLDS, SPEED_MULTIPLIERS } = MOVEMENT_PENALTY_CONSTANTS;\n\n    if (legHealthPercent >= THRESHOLDS.NORMAL) {\n      return {\n        injuryState: LegInjuryState.NORMAL,\n        speedMultiplier: SPEED_MULTIPLIERS.NORMAL,\n      };\n    } else if (legHealthPercent >= THRESHOLDS.LIMPING) {\n      return {\n        injuryState: LegInjuryState.LIMPING,\n        speedMultiplier: SPEED_MULTIPLIERS.LIMPING,\n      };\n    } else if (legHealthPercent >= THRESHOLDS.SEVERE_LIMP) {\n      return {\n        injuryState: LegInjuryState.SEVERE_LIMP,\n        speedMultiplier: SPEED_MULTIPLIERS.SEVERE_LIMP,\n      };\n    } else {\n      return {\n        injuryState: LegInjuryState.HOBBLED,\n        speedMultiplier: SPEED_MULTIPLIERS.HOBBLED,\n      };\n    }\n  }\n\n  /**\n   * Calculate asymmetric movement penalty based on movement direction and injured leg.\n   * \n   * **Korean**: 비대칭 이동 패널티 계산\n   * \n   * Left leg damage affects left-side movements more, and vice versa.\n   * This creates realistic limping behavior where movement toward the injured\n   * side is more impaired.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param movementDirection - Direction of movement (positive = right, negative = left)\n   * @returns Additional speed multiplier for asymmetric penalty\n   * \n   * @public\n   */\n  calculateAsymmetricPenalty(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    movementDirection: { x: number; y: number }\n  ): number {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n\n    // Only apply asymmetric penalty if one leg is significantly more damaged\n    const legHealthDifference = Math.abs(leftLegPercent - rightLegPercent);\n    if (legHealthDifference < 0.15) {\n      // Both legs similarly damaged - no asymmetric penalty\n      return 1.0;\n    }\n\n    // Determine which leg is more injured\n    const leftLegMoreInjured = leftLegPercent < rightLegPercent;\n\n    // Horizontal movement direction (x-axis)\n    const movingLeft = movementDirection.x < -0.1;\n    const movingRight = movementDirection.x > 0.1;\n\n    if (leftLegMoreInjured) {\n      // Left leg injured - left movement more impaired\n      if (movingLeft) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.SAME_SIDE_PENALTY;\n      } else if (movingRight) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.OPPOSITE_SIDE_PENALTY;\n      }\n    } else {\n      // Right leg injured - right movement more impaired\n      if (movingRight) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.SAME_SIDE_PENALTY;\n      } else if (movingLeft) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.OPPOSITE_SIDE_PENALTY;\n      }\n    }\n\n    return 1.0; // No horizontal movement\n  }\n\n  /**\n   * Create instant movement penalty from knee/ankle strike.\n   * \n   * **Korean**: 순간 이동 패널티 생성\n   * \n   * Applied when knee or ankle vital points are struck, causing immediate\n   * severe movement impairment for 5 seconds.\n   * \n   * @param affectedPart - Body part that was struck (LEG_LEFT or LEG_RIGHT)\n   * @param currentTime - Timestamp when strike occurred\n   * @returns Instant movement penalty configuration\n   * \n   * @public\n   */\n  createInstantPenalty(\n    affectedPart: BodyPart.LEG_LEFT | BodyPart.LEG_RIGHT,\n    currentTime: number = Date.now()\n  ): InstantMovementPenalty {\n    return {\n      speedMultiplier: MOVEMENT_PENALTY_CONSTANTS.INSTANT_PENALTY.SPEED_MULTIPLIER,\n      duration: MOVEMENT_PENALTY_CONSTANTS.INSTANT_PENALTY.DURATION,\n      appliedAt: currentTime,\n      affectedPart,\n    };\n  }\n\n  /**\n   * Check if player should enter VULNERABLE state from leg damage.\n   * \n   * **Korean**: 취약 상태 확인\n   * \n   * Low leg health increases chance of entering vulnerable state,\n   * making player more susceptible to follow-up attacks.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns True if player should enter vulnerable state\n   * \n   * @public\n   */\n  shouldEnterVulnerableState(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): boolean {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n    const avgLegHealth = (leftLegPercent + rightLegPercent) / 2;\n\n    // Enter vulnerable state when legs are critically damaged\n    return avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP;\n  }\n\n  /**\n   * Check if player should enter HELPLESS state from leg damage.\n   * \n   * **Korean**: 무력 상태 확인\n   * \n   * Both legs critically damaged or hobbled - player cannot maintain\n   * effective combat stance and is highly vulnerable.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns True if player should enter helpless state\n   * \n   * @public\n   */\n  shouldEnterHelplessState(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): boolean {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n\n    // Enter helpless state when both legs are hobbled\n    return (\n      leftLegPercent < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP &&\n      rightLegPercent < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP\n    );\n  }\n\n  /**\n   * Calculate modified movement speed with all penalties applied.\n   * \n   * **Korean**: 수정된 이동 속도 계산\n   * \n   * Applies base movement penalty, asymmetric penalties, and instant penalties\n   * to calculate the final movement speed.\n   * \n   * @param baseSpeed - Base movement speed (pixels per frame)\n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param movementDirection - Direction vector of movement\n   * @param instantPenalty - Optional active instant penalty\n   * @param currentTime - Current timestamp\n   * @returns Final movement speed with all penalties applied\n   * \n   * @public\n   */\n  calculateModifiedSpeed(\n    baseSpeed: number,\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    movementDirection: { x: number; y: number },\n    instantPenalty?: InstantMovementPenalty,\n    currentTime: number = Date.now()\n  ): number {\n    // Get base movement penalty\n    const penalty = this.calculateMovementPenalty(\n      health,\n      maxHealth,\n      instantPenalty,\n      currentTime\n    );\n\n    // Calculate asymmetric penalty\n    const asymmetricMultiplier = this.calculateAsymmetricPenalty(\n      health,\n      maxHealth,\n      movementDirection\n    );\n\n    // Apply all multipliers\n    return baseSpeed * penalty.speedMultiplier * asymmetricMultiplier;\n  }\n}\n\n/**\n * Singleton instance of Movement Penalty System.\n * \n * **Korean**: 이동 패널티 시스템 싱글톤\n * \n * Provides global access to the movement penalty system throughout the game.\n * \n * @public\n */\nexport const movementPenaltySystem = new MovementPenaltySystem();\n"],"mappings":"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"}
+{"version":3,"file":"MovementPenaltySystem.js","names":[],"sources":["../../../src/systems/bodypart/MovementPenaltySystem.ts"],"sourcesContent":["/**\n * Movement Penalty System\n * \n * **Korean**: 이동 패널티 시스템\n * \n * Implements injury-based movement penalties where leg and body damage reduces\n * movement speed, stance changes, and mobility capabilities. This system applies\n * realistic combat trauma effects based on Korean martial arts principles.\n * \n * ## System Features\n * \n * - Progressive speed reduction based on leg health\n * - Asymmetric damage (left/right leg affects directional movement)\n * - Instant penalties from knee/ankle strikes (5 seconds)\n * - Stance change duration penalties\n * - Advanced stance restrictions when critically injured\n * - Balance integration for VULNERABLE/HELPLESS states\n * \n * ## Movement Speed Penalties\n * \n * | Leg Health | State | Speed | Can Run |\n * |------------|-------|-------|---------|\n * | 100-70% | Normal | 100% | Yes |\n * | 69-50% | Limping | 80% | Yes |\n * | 49-30% | Severe Limp | 60% | Yes |\n * | <30% | Hobbled | 40% | No |\n * \n * ## Stance Change Penalties\n * \n * - Legs <50% health: Stance change takes 2x longer\n * - Legs <30% health: Cannot change to advanced stances (only basic)\n * \n * @module systems/bodypart/MovementPenaltySystem\n * @category Body Part System\n * @korean 이동패널티시스템\n */\n\nimport {\n  BodyPart,\n  BodyPartHealth,\n  BodyPartMaxHealth,\n  LegInjuryState,\n  MovementPenalty,\n  InstantMovementPenalty,\n  MOVEMENT_PENALTY_CONSTANTS,\n} from \"./types\";\n\n/**\n * Movement Penalty System class.\n * \n * **Korean**: 이동 패널티 시스템 클래스\n * \n * Calculates movement penalties from leg injuries, manages instant penalties\n * from knee/ankle strikes, and integrates with balance system.\n * \n * @example\n * ```typescript\n * const system = new MovementPenaltySystem();\n * \n * // Calculate current movement penalty\n * const penalty = system.calculateMovementPenalty(\n *   bodyPartHealth,\n *   maxHealth,\n *   activeInstantPenalty\n * );\n * \n * // Apply to movement speed\n * const actualSpeed = baseSpeed * penalty.speedMultiplier;\n * ```\n * \n * @category Body Part System\n */\nexport class MovementPenaltySystem {\n  /**\n   * Calculate movement penalty from body part health.\n   * \n   * **Korean**: 이동 패널티 계산\n   * \n   * Analyzes leg health and returns comprehensive movement penalty including\n   * speed multiplier, stance change penalties, and balance effects.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param instantPenalty - Optional active instant penalty\n   * @param currentTime - Current timestamp for instant penalty expiry check\n   * @returns Movement penalty with all modifiers\n   * \n   */\n  calculateMovementPenalty(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    instantPenalty?: InstantMovementPenalty,\n    currentTime: number = Date.now()\n  ): MovementPenalty {\n    // Calculate average leg health percentage\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n    const avgLegHealth = (leftLegPercent + rightLegPercent) / 2;\n\n    // Determine injury state and base speed multiplier\n    const { injuryState, speedMultiplier } = this.getInjuryStateFromHealth(avgLegHealth);\n\n    // Check if instant penalty is active\n    const hasActiveInstantPenalty = \n      instantPenalty !== undefined &&\n      instantPenalty.appliedAt + instantPenalty.duration > currentTime;\n\n    // Apply instant penalty if active, otherwise use base multiplier\n    const finalSpeedMultiplier = hasActiveInstantPenalty && instantPenalty\n      ? Math.min(speedMultiplier, instantPenalty.speedMultiplier)\n      : speedMultiplier;\n\n    // Calculate stance change penalty\n    const stanceChangePenalty = \n      avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.CRITICAL_THRESHOLD\n        ? MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.INJURED\n        : MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.NORMAL;\n\n    // Determine if advanced stances are restricted\n    const advancedStancesRestricted =\n      avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.STANCE_CHANGE.RESTRICTION_THRESHOLD;\n\n    // Calculate balance modifier (lower leg health = worse balance)\n    const balanceModifier = Math.max(0.3, avgLegHealth);\n\n    // Determine if player can run\n    const canRun = injuryState !== LegInjuryState.HOBBLED;\n\n    return {\n      speedMultiplier: finalSpeedMultiplier,\n      canRun,\n      injuryState,\n      stanceChangePenalty,\n      advancedStancesRestricted,\n      balanceModifier,\n      hasInstantPenalty: hasActiveInstantPenalty,\n      instantPenaltyExpiry: hasActiveInstantPenalty && instantPenalty\n        ? instantPenalty.appliedAt + instantPenalty.duration\n        : 0,\n    };\n  }\n\n  /**\n   * Get injury state and speed multiplier from leg health percentage.\n   * \n   * **Korean**: 부상 상태 및 속도 배율 조회\n   * \n   * @param legHealthPercent - Average leg health as percentage (0.0-1.0)\n   * @returns Injury state and corresponding speed multiplier\n   * \n   * @private\n   */\n  private getInjuryStateFromHealth(legHealthPercent: number): {\n    injuryState: LegInjuryState;\n    speedMultiplier: number;\n  } {\n    const { THRESHOLDS, SPEED_MULTIPLIERS } = MOVEMENT_PENALTY_CONSTANTS;\n\n    if (legHealthPercent >= THRESHOLDS.NORMAL) {\n      return {\n        injuryState: LegInjuryState.NORMAL,\n        speedMultiplier: SPEED_MULTIPLIERS.NORMAL,\n      };\n    } else if (legHealthPercent >= THRESHOLDS.LIMPING) {\n      return {\n        injuryState: LegInjuryState.LIMPING,\n        speedMultiplier: SPEED_MULTIPLIERS.LIMPING,\n      };\n    } else if (legHealthPercent >= THRESHOLDS.SEVERE_LIMP) {\n      return {\n        injuryState: LegInjuryState.SEVERE_LIMP,\n        speedMultiplier: SPEED_MULTIPLIERS.SEVERE_LIMP,\n      };\n    } else {\n      return {\n        injuryState: LegInjuryState.HOBBLED,\n        speedMultiplier: SPEED_MULTIPLIERS.HOBBLED,\n      };\n    }\n  }\n\n  /**\n   * Calculate asymmetric movement penalty based on movement direction and injured leg.\n   * \n   * **Korean**: 비대칭 이동 패널티 계산\n   * \n   * Left leg damage affects left-side movements more, and vice versa.\n   * This creates realistic limping behavior where movement toward the injured\n   * side is more impaired.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param movementDirection - Direction of movement (positive = right, negative = left)\n   * @returns Additional speed multiplier for asymmetric penalty\n   * \n   */\n  calculateAsymmetricPenalty(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    movementDirection: { x: number; y: number }\n  ): number {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n\n    // Only apply asymmetric penalty if one leg is significantly more damaged\n    const legHealthDifference = Math.abs(leftLegPercent - rightLegPercent);\n    if (legHealthDifference < 0.15) {\n      // Both legs similarly damaged - no asymmetric penalty\n      return 1.0;\n    }\n\n    // Determine which leg is more injured\n    const leftLegMoreInjured = leftLegPercent < rightLegPercent;\n\n    // Horizontal movement direction (x-axis)\n    const movingLeft = movementDirection.x < -0.1;\n    const movingRight = movementDirection.x > 0.1;\n\n    if (leftLegMoreInjured) {\n      // Left leg injured - left movement more impaired\n      if (movingLeft) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.SAME_SIDE_PENALTY;\n      } else if (movingRight) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.OPPOSITE_SIDE_PENALTY;\n      }\n    } else {\n      // Right leg injured - right movement more impaired\n      if (movingRight) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.SAME_SIDE_PENALTY;\n      } else if (movingLeft) {\n        return MOVEMENT_PENALTY_CONSTANTS.ASYMMETRIC.OPPOSITE_SIDE_PENALTY;\n      }\n    }\n\n    return 1.0; // No horizontal movement\n  }\n\n  /**\n   * Create instant movement penalty from knee/ankle strike.\n   * \n   * **Korean**: 순간 이동 패널티 생성\n   * \n   * Applied when knee or ankle vital points are struck, causing immediate\n   * severe movement impairment for 5 seconds.\n   * \n   * @param affectedPart - Body part that was struck (LEG_LEFT or LEG_RIGHT)\n   * @param currentTime - Timestamp when strike occurred\n   * @returns Instant movement penalty configuration\n   * \n   */\n  createInstantPenalty(\n    affectedPart: BodyPart.LEG_LEFT | BodyPart.LEG_RIGHT,\n    currentTime: number = Date.now()\n  ): InstantMovementPenalty {\n    return {\n      speedMultiplier: MOVEMENT_PENALTY_CONSTANTS.INSTANT_PENALTY.SPEED_MULTIPLIER,\n      duration: MOVEMENT_PENALTY_CONSTANTS.INSTANT_PENALTY.DURATION,\n      appliedAt: currentTime,\n      affectedPart,\n    };\n  }\n\n  /**\n   * Check if player should enter VULNERABLE state from leg damage.\n   * \n   * **Korean**: 취약 상태 확인\n   * \n   * Low leg health increases chance of entering vulnerable state,\n   * making player more susceptible to follow-up attacks.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns True if player should enter vulnerable state\n   * \n   */\n  shouldEnterVulnerableState(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): boolean {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n    const avgLegHealth = (leftLegPercent + rightLegPercent) / 2;\n\n    // Enter vulnerable state when legs are critically damaged\n    return avgLegHealth < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP;\n  }\n\n  /**\n   * Check if player should enter HELPLESS state from leg damage.\n   * \n   * **Korean**: 무력 상태 확인\n   * \n   * Both legs critically damaged or hobbled - player cannot maintain\n   * effective combat stance and is highly vulnerable.\n   * \n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @returns True if player should enter helpless state\n   * \n   */\n  shouldEnterHelplessState(\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth\n  ): boolean {\n    const leftLegPercent = health.legLeft / maxHealth.legLeft;\n    const rightLegPercent = health.legRight / maxHealth.legRight;\n\n    // Enter helpless state when both legs are hobbled\n    return (\n      leftLegPercent < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP &&\n      rightLegPercent < MOVEMENT_PENALTY_CONSTANTS.THRESHOLDS.SEVERE_LIMP\n    );\n  }\n\n  /**\n   * Calculate modified movement speed with all penalties applied.\n   * \n   * **Korean**: 수정된 이동 속도 계산\n   * \n   * Applies base movement penalty, asymmetric penalties, and instant penalties\n   * to calculate the final movement speed.\n   * \n   * @param baseSpeed - Base movement speed (pixels per frame)\n   * @param health - Current body part health\n   * @param maxHealth - Maximum health values\n   * @param movementDirection - Direction vector of movement\n   * @param instantPenalty - Optional active instant penalty\n   * @param currentTime - Current timestamp\n   * @returns Final movement speed with all penalties applied\n   * \n   */\n  calculateModifiedSpeed(\n    baseSpeed: number,\n    health: BodyPartHealth,\n    maxHealth: BodyPartMaxHealth,\n    movementDirection: { x: number; y: number },\n    instantPenalty?: InstantMovementPenalty,\n    currentTime: number = Date.now()\n  ): number {\n    // Get base movement penalty\n    const penalty = this.calculateMovementPenalty(\n      health,\n      maxHealth,\n      instantPenalty,\n      currentTime\n    );\n\n    // Calculate asymmetric penalty\n    const asymmetricMultiplier = this.calculateAsymmetricPenalty(\n      health,\n      maxHealth,\n      movementDirection\n    );\n\n    // Apply all multipliers\n    return baseSpeed * penalty.speedMultiplier * asymmetricMultiplier;\n  }\n}\n\n/**\n * Singleton instance of Movement Penalty System.\n * \n * **Korean**: 이동 패널티 시스템 싱글톤\n * \n * Provides global access to the movement penalty system throughout the game.\n * \n */\nexport const movementPenaltySystem = new MovementPenaltySystem();\n"],"mappings":"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"}

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

@@ -40,7 +40,6 @@ import { CombatInjuryIntegration } from "./CombatInjuryIntegration";
  * manager.clearPlayerInjuries('player-1');
  * ```
  *
- * @public
  */
 export declare class PlayerInjuryTrackingManager {
     private trackers;
@@ -53,7 +52,6 @@ export declare class PlayerInjuryTrackingManager {
      * @param playerId - Unique player identifier (string or number)
      * @returns InjuryTracker instance for the player
      *
-     * @public
      */
     getTrackerForPlayer(playerId: string | number): InjuryTracker;
     /**
@@ -64,7 +62,6 @@ export declare class PlayerInjuryTrackingManager {
      * @param playerId - Unique player identifier (string or number)
      * @returns CombatInjuryIntegration instance for the player
      *
-     * @public
      */
     getIntegrationForPlayer(playerId: string | number): CombatInjuryIntegration;
     /**
@@ -76,7 +73,6 @@ export declare class PlayerInjuryTrackingManager {
      *
      * @param playerId - Unique player identifier (string or number)
      *
-     * @public
      */
     clearPlayerInjuries(playerId: string | number): void;
     /**
@@ -86,7 +82,6 @@ export declare class PlayerInjuryTrackingManager {
      *
      * @param playerId - Unique player identifier (string or number)
      *
-     * @public
      */
     removePlayer(playerId: string | number): void;
     /**
@@ -96,7 +91,6 @@ export declare class PlayerInjuryTrackingManager {
      *
      * Useful for resetting the entire game state.
      *
-     * @public
      */
     clearAll(): void;
     /**
@@ -106,7 +100,6 @@ export declare class PlayerInjuryTrackingManager {
      *
      * @returns Array of player IDs
      *
-     * @public
      */
     getActivePlayerIds(): string[];
 }
@@ -131,7 +124,6 @@ export declare class PlayerInjuryTrackingManager {
  * });
  * ```
  *
- * @public
  */
 export declare const playerInjuryManager: PlayerInjuryTrackingManager;
 //# sourceMappingURL=PlayerInjuryTrackingManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PlayerInjuryTrackingManager.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/PlayerInjuryTrackingManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,YAAY,CAA8C;IAElE;;;;;;;;;OASG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa;IAU7D;;;;;;;;;OASG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,uBAAuB;IAiB3E;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQpD;;;;;;;;OAQG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C;;;;;;;;OAQG;IACH,QAAQ,IAAI,IAAI;IAKhB;;;;;;;;OAQG;IACH,kBAAkB,IAAI,MAAM,EAAE;CAG/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,mBAAmB,6BAAoC,CAAC"}
+{"version":3,"file":"PlayerInjuryTrackingManager.d.ts","sourceRoot":"","sources":["../../../src/systems/bodypart/PlayerInjuryTrackingManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,YAAY,CAA8C;IAElE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa;IAU7D;;;;;;;;OAQG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,uBAAuB;IAiB3E;;;;;;;;;OASG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQpD;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C;;;;;;;OAOG;IACH,QAAQ,IAAI,IAAI;IAKhB;;;;;;;OAOG;IACH,kBAAkB,IAAI,MAAM,EAAE;CAG/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,mBAAmB,6BAAoC,CAAC"}

package/lib/systems/bodypart/PlayerInjuryTrackingManager.js

@@ -41,7 +41,6 @@ import { CombatInjuryIntegration } from "./CombatInjuryIntegration.js";
 * manager.clearPlayerInjuries('player-1');
 * ```
 * 
-* @public
 */
 var PlayerInjuryTrackingManager = class {
 	trackers = /* @__PURE__ */ new Map();
@@ -54,7 +53,6 @@ var PlayerInjuryTrackingManager = class {
 	* @param playerId - Unique player identifier (string or number)
 	* @returns InjuryTracker instance for the player
 	* 
-	* @public
 	*/
 	getTrackerForPlayer(playerId) {
 		const key = String(playerId);
@@ -73,7 +71,6 @@ var PlayerInjuryTrackingManager = class {
 	* @param playerId - Unique player identifier (string or number)
 	* @returns CombatInjuryIntegration instance for the player
 	* 
-	* @public
 	*/
 	getIntegrationForPlayer(playerId) {
 		const key = String(playerId);
@@ -98,7 +95,6 @@ var PlayerInjuryTrackingManager = class {
 	* 
 	* @param playerId - Unique player identifier (string or number)
 	* 
-	* @public
 	*/
 	clearPlayerInjuries(playerId) {
 		const key = String(playerId);
@@ -112,7 +108,6 @@ var PlayerInjuryTrackingManager = class {
 	* 
 	* @param playerId - Unique player identifier (string or number)
 	* 
-	* @public
 	*/
 	removePlayer(playerId) {
 		const key = String(playerId);
@@ -126,7 +121,6 @@ var PlayerInjuryTrackingManager = class {
 	* 
 	* Useful for resetting the entire game state.
 	* 
-	* @public
 	*/
 	clearAll() {
 		this.trackers.clear();
@@ -139,7 +133,6 @@ var PlayerInjuryTrackingManager = class {
 	* 
 	* @returns Array of player IDs
 	* 
-	* @public
 	*/
 	getActivePlayerIds() {
 		return Array.from(this.trackers.keys());
@@ -166,7 +159,6 @@ var PlayerInjuryTrackingManager = class {
 * });
 * ```
 * 
-* @public
 */
 var playerInjuryManager = new PlayerInjuryTrackingManager();
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"PlayerInjuryTrackingManager.js","names":[],"sources":["../../../src/systems/bodypart/PlayerInjuryTrackingManager.ts"],"sourcesContent":["/**\n * Player Injury Tracking Manager\n * \n * **Korean**: 플레이어 부상 추적 관리자\n * \n * Manages per-player injury tracking to prevent mixing injuries between\n * multiple characters in combat scenarios. Each player gets their own\n * InjuryTracker instance.\n * \n * @module systems/bodypart\n * @category Injury Tracking\n * @korean 부상추적\n */\n\nimport { InjuryTracker } from \"./InjuryTracker\";\nimport { CombatInjuryIntegration } from \"./CombatInjuryIntegration\";\n\n/**\n * Manager for per-player injury tracking.\n * \n * **Korean**: 플레이어별 부상 추적 관리자\n * \n * Maintains separate {@link InjuryTracker} and {@link CombatInjuryIntegration}\n * instances for each player to ensure injuries don't get mixed between characters.\n * \n * @example\n * ```typescript\n * const manager = new PlayerInjuryTrackingManager();\n * \n * // Get or create tracker for a player\n * const player1Tracker = manager.getTrackerForPlayer('player-1');\n * const player1Integration = manager.getIntegrationForPlayer('player-1');\n * \n * // Record injury for specific player\n * player1Integration.recordCombatDamage({\n *   damage: 35,\n *   bodyRegion: BodyRegion.TORSO,\n *   damageType: DamageType.BLUNT,\n * });\n * \n * // Clear injuries for a player (e.g., between rounds)\n * manager.clearPlayerInjuries('player-1');\n * ```\n * \n * @public\n */\nexport class PlayerInjuryTrackingManager {\n  private trackers = new Map<string, InjuryTracker>();\n  private integrations = new Map<string, CombatInjuryIntegration>();\n\n  /**\n   * Get the InjuryTracker for a specific player, creating it if needed.\n   * \n   * **Korean**: 특정 플레이어의 InjuryTracker 가져오기 (필요시 생성)\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * @returns InjuryTracker instance for the player\n   * \n   * @public\n   */\n  getTrackerForPlayer(playerId: string | number): InjuryTracker {\n    const key = String(playerId);\n    let tracker = this.trackers.get(key);\n    if (!tracker) {\n      tracker = new InjuryTracker();\n      this.trackers.set(key, tracker);\n    }\n    return tracker;\n  }\n\n  /**\n   * Get the CombatInjuryIntegration for a specific player, creating it if needed.\n   * \n   * **Korean**: 특정 플레이어의 CombatInjuryIntegration 가져오기 (필요시 생성)\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * @returns CombatInjuryIntegration instance for the player\n   * \n   * @public\n   */\n  getIntegrationForPlayer(playerId: string | number): CombatInjuryIntegration {\n    const key = String(playerId);\n    let integration = this.integrations.get(key);\n    if (!integration) {\n      const tracker = this.getTrackerForPlayer(playerId);\n      // Pass complete config with tracker override\n      integration = new CombatInjuryIntegration({\n        enabled: true,\n        minDamage: 5,\n        bloodThreshold: 30,\n        tracker,\n      });\n      this.integrations.set(key, integration);\n    }\n    return integration;\n  }\n\n  /**\n   * Clear all injuries for a specific player.\n   * \n   * **Korean**: 특정 플레이어의 모든 부상 제거\n   * \n   * Useful for round resets or when a player is defeated.\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * \n   * @public\n   */\n  clearPlayerInjuries(playerId: string | number): void {\n    const key = String(playerId);\n    const tracker = this.trackers.get(key);\n    if (tracker) {\n      tracker.clearInjuries();\n    }\n  }\n\n  /**\n   * Remove tracking data for a player (e.g., when they leave the game).\n   * \n   * **Korean**: 플레이어 추적 데이터 제거\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * \n   * @public\n   */\n  removePlayer(playerId: string | number): void {\n    const key = String(playerId);\n    this.trackers.delete(key);\n    this.integrations.delete(key);\n  }\n\n  /**\n   * Clear all player tracking data.\n   * \n   * **Korean**: 모든 플레이어 추적 데이터 제거\n   * \n   * Useful for resetting the entire game state.\n   * \n   * @public\n   */\n  clearAll(): void {\n    this.trackers.clear();\n    this.integrations.clear();\n  }\n\n  /**\n   * Get all active player IDs being tracked.\n   * \n   * **Korean**: 추적 중인 모든 플레이어 ID 가져오기\n   * \n   * @returns Array of player IDs\n   * \n   * @public\n   */\n  getActivePlayerIds(): string[] {\n    return Array.from(this.trackers.keys());\n  }\n}\n\n/**\n * Global singleton manager for player injury tracking.\n * \n * **Korean**: 플레이어 부상 추적을 위한 전역 싱글톤 관리자\n * \n * This singleton manages per-player injury trackers to ensure injuries\n * from different characters don't get mixed together.\n * \n * @example\n * ```typescript\n * import { playerInjuryManager } from '@/systems/bodypart';\n * \n * // In combat code:\n * const defenderIntegration = playerInjuryManager.getIntegrationForPlayer(defender.id);\n * defenderIntegration.recordCombatDamage({\n *   damage: result.damage,\n *   bodyRegion,\n *   damageType,\n * });\n * ```\n * \n * @public\n */\nexport const playerInjuryManager = new PlayerInjuryTrackingManager();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,IAAa,8BAAb,MAAyC;CACvC,2BAAmB,IAAI,KAA4B;CACnD,+BAAuB,IAAI,KAAsC;;;;;;;;;;;CAYjE,oBAAoB,UAA0C;EAC5D,MAAM,MAAM,OAAO,SAAS;EAC5B,IAAI,UAAU,KAAK,SAAS,IAAI,IAAI;EACpC,IAAI,CAAC,SAAS;GACZ,UAAU,IAAI,eAAe;GAC7B,KAAK,SAAS,IAAI,KAAK,QAAQ;;EAEjC,OAAO;;;;;;;;;;;;CAaT,wBAAwB,UAAoD;EAC1E,MAAM,MAAM,OAAO,SAAS;EAC5B,IAAI,cAAc,KAAK,aAAa,IAAI,IAAI;EAC5C,IAAI,CAAC,aAAa;GAGhB,cAAc,IAAI,wBAAwB;IACxC,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,SANc,KAAK,oBAAoB,SAMvC;IACD,CAAC;GACF,KAAK,aAAa,IAAI,KAAK,YAAY;;EAEzC,OAAO;;;;;;;;;;;;;CAcT,oBAAoB,UAAiC;EACnD,MAAM,MAAM,OAAO,SAAS;EAC5B,MAAM,UAAU,KAAK,SAAS,IAAI,IAAI;EACtC,IAAI,SACF,QAAQ,eAAe;;;;;;;;;;;CAa3B,aAAa,UAAiC;EAC5C,MAAM,MAAM,OAAO,SAAS;EAC5B,KAAK,SAAS,OAAO,IAAI;EACzB,KAAK,aAAa,OAAO,IAAI;;;;;;;;;;;CAY/B,WAAiB;EACf,KAAK,SAAS,OAAO;EACrB,KAAK,aAAa,OAAO;;;;;;;;;;;CAY3B,qBAA+B;EAC7B,OAAO,MAAM,KAAK,KAAK,SAAS,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B3C,IAAa,sBAAsB,IAAI,6BAA6B"}
+{"version":3,"file":"PlayerInjuryTrackingManager.js","names":[],"sources":["../../../src/systems/bodypart/PlayerInjuryTrackingManager.ts"],"sourcesContent":["/**\n * Player Injury Tracking Manager\n * \n * **Korean**: 플레이어 부상 추적 관리자\n * \n * Manages per-player injury tracking to prevent mixing injuries between\n * multiple characters in combat scenarios. Each player gets their own\n * InjuryTracker instance.\n * \n * @module systems/bodypart\n * @category Injury Tracking\n * @korean 부상추적\n */\n\nimport { InjuryTracker } from \"./InjuryTracker\";\nimport { CombatInjuryIntegration } from \"./CombatInjuryIntegration\";\n\n/**\n * Manager for per-player injury tracking.\n * \n * **Korean**: 플레이어별 부상 추적 관리자\n * \n * Maintains separate {@link InjuryTracker} and {@link CombatInjuryIntegration}\n * instances for each player to ensure injuries don't get mixed between characters.\n * \n * @example\n * ```typescript\n * const manager = new PlayerInjuryTrackingManager();\n * \n * // Get or create tracker for a player\n * const player1Tracker = manager.getTrackerForPlayer('player-1');\n * const player1Integration = manager.getIntegrationForPlayer('player-1');\n * \n * // Record injury for specific player\n * player1Integration.recordCombatDamage({\n *   damage: 35,\n *   bodyRegion: BodyRegion.TORSO,\n *   damageType: DamageType.BLUNT,\n * });\n * \n * // Clear injuries for a player (e.g., between rounds)\n * manager.clearPlayerInjuries('player-1');\n * ```\n * \n */\nexport class PlayerInjuryTrackingManager {\n  private trackers = new Map<string, InjuryTracker>();\n  private integrations = new Map<string, CombatInjuryIntegration>();\n\n  /**\n   * Get the InjuryTracker for a specific player, creating it if needed.\n   * \n   * **Korean**: 특정 플레이어의 InjuryTracker 가져오기 (필요시 생성)\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * @returns InjuryTracker instance for the player\n   * \n   */\n  getTrackerForPlayer(playerId: string | number): InjuryTracker {\n    const key = String(playerId);\n    let tracker = this.trackers.get(key);\n    if (!tracker) {\n      tracker = new InjuryTracker();\n      this.trackers.set(key, tracker);\n    }\n    return tracker;\n  }\n\n  /**\n   * Get the CombatInjuryIntegration for a specific player, creating it if needed.\n   * \n   * **Korean**: 특정 플레이어의 CombatInjuryIntegration 가져오기 (필요시 생성)\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * @returns CombatInjuryIntegration instance for the player\n   * \n   */\n  getIntegrationForPlayer(playerId: string | number): CombatInjuryIntegration {\n    const key = String(playerId);\n    let integration = this.integrations.get(key);\n    if (!integration) {\n      const tracker = this.getTrackerForPlayer(playerId);\n      // Pass complete config with tracker override\n      integration = new CombatInjuryIntegration({\n        enabled: true,\n        minDamage: 5,\n        bloodThreshold: 30,\n        tracker,\n      });\n      this.integrations.set(key, integration);\n    }\n    return integration;\n  }\n\n  /**\n   * Clear all injuries for a specific player.\n   * \n   * **Korean**: 특정 플레이어의 모든 부상 제거\n   * \n   * Useful for round resets or when a player is defeated.\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * \n   */\n  clearPlayerInjuries(playerId: string | number): void {\n    const key = String(playerId);\n    const tracker = this.trackers.get(key);\n    if (tracker) {\n      tracker.clearInjuries();\n    }\n  }\n\n  /**\n   * Remove tracking data for a player (e.g., when they leave the game).\n   * \n   * **Korean**: 플레이어 추적 데이터 제거\n   * \n   * @param playerId - Unique player identifier (string or number)\n   * \n   */\n  removePlayer(playerId: string | number): void {\n    const key = String(playerId);\n    this.trackers.delete(key);\n    this.integrations.delete(key);\n  }\n\n  /**\n   * Clear all player tracking data.\n   * \n   * **Korean**: 모든 플레이어 추적 데이터 제거\n   * \n   * Useful for resetting the entire game state.\n   * \n   */\n  clearAll(): void {\n    this.trackers.clear();\n    this.integrations.clear();\n  }\n\n  /**\n   * Get all active player IDs being tracked.\n   * \n   * **Korean**: 추적 중인 모든 플레이어 ID 가져오기\n   * \n   * @returns Array of player IDs\n   * \n   */\n  getActivePlayerIds(): string[] {\n    return Array.from(this.trackers.keys());\n  }\n}\n\n/**\n * Global singleton manager for player injury tracking.\n * \n * **Korean**: 플레이어 부상 추적을 위한 전역 싱글톤 관리자\n * \n * This singleton manages per-player injury trackers to ensure injuries\n * from different characters don't get mixed together.\n * \n * @example\n * ```typescript\n * import { playerInjuryManager } from '@/systems/bodypart';\n * \n * // In combat code:\n * const defenderIntegration = playerInjuryManager.getIntegrationForPlayer(defender.id);\n * defenderIntegration.recordCombatDamage({\n *   damage: result.damage,\n *   bodyRegion,\n *   damageType,\n * });\n * ```\n * \n */\nexport const playerInjuryManager = new PlayerInjuryTrackingManager();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,8BAAb,MAAyC;CACvC,2BAAmB,IAAI,KAA4B;CACnD,+BAAuB,IAAI,KAAsC;;;;;;;;;;CAWjE,oBAAoB,UAA0C;EAC5D,MAAM,MAAM,OAAO,SAAS;EAC5B,IAAI,UAAU,KAAK,SAAS,IAAI,IAAI;EACpC,IAAI,CAAC,SAAS;GACZ,UAAU,IAAI,eAAe;GAC7B,KAAK,SAAS,IAAI,KAAK,QAAQ;;EAEjC,OAAO;;;;;;;;;;;CAYT,wBAAwB,UAAoD;EAC1E,MAAM,MAAM,OAAO,SAAS;EAC5B,IAAI,cAAc,KAAK,aAAa,IAAI,IAAI;EAC5C,IAAI,CAAC,aAAa;GAGhB,cAAc,IAAI,wBAAwB;IACxC,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,SANc,KAAK,oBAAoB,SAMvC;IACD,CAAC;GACF,KAAK,aAAa,IAAI,KAAK,YAAY;;EAEzC,OAAO;;;;;;;;;;;;CAaT,oBAAoB,UAAiC;EACnD,MAAM,MAAM,OAAO,SAAS;EAC5B,MAAM,UAAU,KAAK,SAAS,IAAI,IAAI;EACtC,IAAI,SACF,QAAQ,eAAe;;;;;;;;;;CAY3B,aAAa,UAAiC;EAC5C,MAAM,MAAM,OAAO,SAAS;EAC5B,KAAK,SAAS,OAAO,IAAI;EACzB,KAAK,aAAa,OAAO,IAAI;;;;;;;;;;CAW/B,WAAiB;EACf,KAAK,SAAS,OAAO;EACrB,KAAK,aAAa,OAAO;;;;;;;;;;CAW3B,qBAA+B;EAC7B,OAAO,MAAM,KAAK,KAAK,SAAS,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA0B3C,IAAa,sBAAsB,IAAI,6BAA6B"}