blacktrigram 0.7.2

package/lib/systems/bodypart/types.js

@@ -0,0 +1,157 @@
+//#region src/systems/bodypart/types.ts
+/**
+* Body part identifiers for health tracking.
+* 
+* **Korean**: 신체 부위 (Body Parts)
+* 
+* Each body part tracks independent health from 0-100 HP. Damage to specific
+* parts affects different combat capabilities based on anatomical function.
+* 
+* @example
+* ```typescript
+* const bodyPart: BodyPart = BodyPart.HEAD;
+* const health = player.bodyPartHealth[bodyPart]; // 0-100
+* ```
+* 
+* @public
+* @category Body Part System
+* @korean 신체부위
+*/
+var BodyPart = /* @__PURE__ */ function(BodyPart) {
+	/** Head region - affects consciousness and awareness */
+	BodyPart["HEAD"] = "head";
+	/** Neck region - affects breathing and blood flow */
+	BodyPart["NECK"] = "neck";
+	/** Upper torso - affects heart, lungs, stamina recovery */
+	BodyPart["TORSO_UPPER"] = "torsoUpper";
+	/** Lower torso - affects core strength and balance */
+	BodyPart["TORSO_LOWER"] = "torsoLower";
+	/** Left arm - affects attack capability on left side */
+	BodyPart["ARM_LEFT"] = "armLeft";
+	/** Right arm - affects attack capability on right side */
+	BodyPart["ARM_RIGHT"] = "armRight";
+	/** Left leg - affects movement and balance */
+	BodyPart["LEG_LEFT"] = "legLeft";
+	/** Right leg - affects movement and balance */
+	BodyPart["LEG_RIGHT"] = "legRight";
+	return BodyPart;
+}({});
+/**
+* Default configuration values for body part health system.
+* 
+* @public
+* @category Body Part System
+*/
+var DEFAULT_BODY_PART_CONFIG = {
+	defaultMaxHealth: 100,
+	minorPenaltyThreshold: .75,
+	majorPenaltyThreshold: .5,
+	severePenaltyThreshold: .25,
+	criticalThreshold: .1,
+	effectMultipliers: {
+		minor: .9,
+		major: .7,
+		severe: .4,
+		critical: .1
+	}
+};
+/**
+* Body part health effect constants matching acceptance criteria.
+* 
+* **Korean**: 신체 부위 효과 상수
+* 
+* Defines specific combat penalties as per requirements:
+* - Head <50%: Consciousness penalties
+* - Torso <50%: Stamina regen -50%
+* - Arms <50%: Attack damage -30%
+* - Legs <50%: Movement speed -40%
+* 
+* @public
+* @category Body Part System
+*/
+var BODY_PART_EFFECT_CONSTANTS = {
+	HEAD: {
+		CONSCIOUSNESS_PENALTY_AT_50: .75,
+		CRITICAL_THRESHOLD: .5
+	},
+	TORSO: {
+		STAMINA_REGEN_PENALTY_AT_50: .5,
+		CRITICAL_THRESHOLD: .5
+	},
+	ARMS: {
+		ATTACK_DAMAGE_PENALTY_AT_50: .7,
+		CRITICAL_THRESHOLD: .5
+	},
+	LEGS: {
+		MOVEMENT_SPEED_PENALTY_AT_50: .6,
+		CRITICAL_THRESHOLD: .5
+	}
+};
+/**
+* Leg injury severity levels for movement penalties.
+* 
+* **Korean**: 다리 부상 정도 (Leg Injury Severity)
+* 
+* Defines movement impairment states based on leg health percentage.
+* 
+* @public
+* @category Body Part System
+* @korean 다리부상정도
+*/
+var LegInjuryState = /* @__PURE__ */ function(LegInjuryState) {
+	/** Normal movement - Leg health 100-70% */
+	LegInjuryState["NORMAL"] = "normal";
+	/** Limping - Leg health 69-50% */
+	LegInjuryState["LIMPING"] = "limping";
+	/** Severe limp - Leg health 49-30% */
+	LegInjuryState["SEVERE_LIMP"] = "severe_limp";
+	/** Hobbled - Leg health <30%, cannot run */
+	LegInjuryState["HOBBLED"] = "hobbled";
+	return LegInjuryState;
+}({});
+/**
+* Movement penalty constants matching acceptance criteria.
+* 
+* **Korean**: 이동 패널티 상수
+* 
+* Defines thresholds and multipliers for injury-based movement penalties:
+* - 100-70%: Normal speed (100%)
+* - 69-50%: Limping (-20% speed)
+* - 49-30%: Severe limp (-40% speed)
+* - <30%: Hobbled (-60% speed, cannot run)
+* 
+* @public
+* @category Body Part System
+*/
+var MOVEMENT_PENALTY_CONSTANTS = {
+	THRESHOLDS: {
+		NORMAL: .7,
+		LIMPING: .5,
+		SEVERE_LIMP: .3,
+		HOBBLED: 0
+	},
+	SPEED_MULTIPLIERS: {
+		NORMAL: 1,
+		LIMPING: .8,
+		SEVERE_LIMP: .6,
+		HOBBLED: .4
+	},
+	STANCE_CHANGE: {
+		NORMAL: 1,
+		INJURED: 2,
+		CRITICAL_THRESHOLD: .5,
+		RESTRICTION_THRESHOLD: .3
+	},
+	INSTANT_PENALTY: {
+		SPEED_MULTIPLIER: .3,
+		DURATION: 5e3
+	},
+	ASYMMETRIC: {
+		SAME_SIDE_PENALTY: .8,
+		OPPOSITE_SIDE_PENALTY: .9
+	}
+};
+//#endregion
+export { BODY_PART_EFFECT_CONSTANTS, BodyPart, DEFAULT_BODY_PART_CONFIG, LegInjuryState, MOVEMENT_PENALTY_CONSTANTS };
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/systems/bodypart/types.ts"],"sourcesContent":["/**\n * Body Part Health System Types\n * \n * **Korean**: 신체부위 체력 시스템 타입\n * \n * This module defines types for the body part-specific health tracking system,\n * which replaces the single health bar with independent health tracking for\n * each major body region. This enables realistic localized damage and combat\n * trauma simulation.\n * \n * ## Body Part Health Philosophy\n * \n * Traditional Korean martial arts emphasize targeting specific body regions\n * to achieve maximum combat effectiveness. This system reflects that by\n * tracking damage to:\n * - **HEAD** (두부): Consciousness and awareness\n * - **NECK** (경부): Vascular and respiratory function\n * - **TORSO_UPPER** (상부 몸통): Heart, lungs, vital organs\n * - **TORSO_LOWER** (하부 몸통): Stamina and core strength\n * - **ARM_LEFT/RIGHT** (좌/우팔): Attack capability\n * - **LEG_LEFT/RIGHT** (좌/우다리): Mobility and balance\n * \n * @module systems/bodypart/types\n * @category Body Part System\n * @korean 신체부위타입\n */\n\nimport { KoreanText } from \"@/types\";\n\n/**\n * Body part identifiers for health tracking.\n * \n * **Korean**: 신체 부위 (Body Parts)\n * \n * Each body part tracks independent health from 0-100 HP. Damage to specific\n * parts affects different combat capabilities based on anatomical function.\n * \n * @example\n * ```typescript\n * const bodyPart: BodyPart = BodyPart.HEAD;\n * const health = player.bodyPartHealth[bodyPart]; // 0-100\n * ```\n * \n * @public\n * @category Body Part System\n * @korean 신체부위\n */\nexport enum BodyPart {\n  /** Head region - affects consciousness and awareness */\n  HEAD = \"head\",\n  /** Neck region - affects breathing and blood flow */\n  NECK = \"neck\",\n  /** Upper torso - affects heart, lungs, stamina recovery */\n  TORSO_UPPER = \"torsoUpper\",\n  /** Lower torso - affects core strength and balance */\n  TORSO_LOWER = \"torsoLower\",\n  /** Left arm - affects attack capability on left side */\n  ARM_LEFT = \"armLeft\",\n  /** Right arm - affects attack capability on right side */\n  ARM_RIGHT = \"armRight\",\n  /** Left leg - affects movement and balance */\n  LEG_LEFT = \"legLeft\",\n  /** Right leg - affects movement and balance */\n  LEG_RIGHT = \"legRight\",\n}\n\n/**\n * Health values for each body part (0-100 HP per part).\n * \n * **Korean**: 신체 부위별 체력\n * \n * Tracks independent health pools for each major body region. When a body part\n * reaches 0 HP, it becomes non-functional and applies severe combat penalties.\n * \n * ## Default Health Values\n * \n * All body parts start at 100 HP. Different archetypes may have variations:\n * - **무사 (Musa)**: Balanced health across all parts\n * - **암살자 (Amsalja)**: Lower torso health, higher arm precision\n * - **해커 (Hacker)**: Enhanced head/neck (cyber augmentation)\n * - **정보요원 (Jeongbo)**: Balanced with slight defensive boost\n * - **조직폭력배 (Jojik)**: Higher torso/leg health (street hardened)\n * \n * @example\n * ```typescript\n * const bodyHealth: BodyPartHealth = {\n *   head: 100,\n *   neck: 100,\n *   torsoUpper: 100,\n *   torsoLower: 100,\n *   armLeft: 100,\n *   armRight: 100,\n *   legLeft: 100,\n *   legRight: 100,\n * };\n * ```\n * \n * @public\n * @category Body Part System\n * @korean 신체부위체력\n */\nexport interface BodyPartHealth {\n  /** Head health (0-100 HP) - affects consciousness */\n  readonly head: number;\n  /** Neck health (0-100 HP) - affects breathing and circulation */\n  readonly neck: number;\n  /** Upper torso health (0-100 HP) - affects stamina recovery */\n  readonly torsoUpper: number;\n  /** Lower torso health (0-100 HP) - affects balance and core strength */\n  readonly torsoLower: number;\n  /** Left arm health (0-100 HP) - affects left-side attacks */\n  readonly armLeft: number;\n  /** Right arm health (0-100 HP) - affects right-side attacks */\n  readonly armRight: number;\n  /** Left leg health (0-100 HP) - affects movement and stance */\n  readonly legLeft: number;\n  /** Right leg health (0-100 HP) - affects movement and stance */\n  readonly legRight: number;\n}\n\n/**\n * Maximum health values for each body part.\n * \n * **Korean**: 최대 신체 부위 체력\n * \n * Defines the maximum HP capacity for each body part. Can be modified by\n * archetype, equipment, or training bonuses.\n * \n * @public\n * @category Body Part System\n * @korean 최대신체부위체력\n */\nexport interface BodyPartMaxHealth {\n  /** Maximum head health */\n  readonly head: number;\n  /** Maximum neck health */\n  readonly neck: number;\n  /** Maximum upper torso health */\n  readonly torsoUpper: number;\n  /** Maximum lower torso health */\n  readonly torsoLower: number;\n  /** Maximum left arm health */\n  readonly armLeft: number;\n  /** Maximum right arm health */\n  readonly armRight: number;\n  /** Maximum left leg health */\n  readonly legLeft: number;\n  /** Maximum right leg health */\n  readonly legRight: number;\n}\n\n/**\n * Combat capability effects from body part damage.\n * \n * **Korean**: 신체 부위 손상 효과\n * \n * Defines how damage to specific body parts affects combat performance.\n * Effects are applied as multipliers to base stats (0.0 = disabled, 1.0 = normal).\n * \n * ## Effect Thresholds\n * \n * - **100-75% HP**: No penalties (1.0x)\n * - **75-50% HP**: Minor penalties (0.9-0.8x)\n * - **50-25% HP**: Major penalties (0.7-0.5x)\n * - **25-0% HP**: Severe penalties (0.3-0.1x)\n * - **0% HP**: Non-functional (0.0x)\n * \n * @example\n * ```typescript\n * const effects: BodyPartEffects = {\n *   consciousnessModifier: 0.75, // Head at 50% HP\n *   staminaRegenModifier: 0.5,   // Torso damaged\n *   attackDamageModifier: 0.7,   // Arm injured\n *   movementSpeedModifier: 0.6,  // Leg damaged\n * };\n * ```\n * \n * @public\n * @category Body Part System\n * @korean 신체부위효과\n */\nexport interface BodyPartEffects {\n  /** Consciousness and awareness multiplier (0.0-1.0) - from head/neck damage */\n  readonly consciousnessModifier: number;\n  /** Stamina regeneration multiplier (0.0-1.0) - from torso damage */\n  readonly staminaRegenModifier: number;\n  /** Attack damage multiplier (0.0-1.0) - from arm damage */\n  readonly attackDamageModifier: number;\n  /** Movement speed multiplier (0.0-1.0) - from leg damage */\n  readonly movementSpeedModifier: number;\n  /** Balance modifier (0.0-1.0) - from lower torso and leg damage */\n  readonly balanceModifier: number;\n  /** Technique accuracy multiplier (0.0-1.0) - from head/arm damage */\n  readonly techniqueAccuracyModifier: number;\n}\n\n/**\n * Damage distribution configuration for body parts.\n * \n * **Korean**: 신체 부위 피해 분배\n * \n * Defines how damage from attacks is distributed across body parts based on\n * the hit location and attack type. Not all damage goes to a single part;\n * impact can affect adjacent regions.\n * \n * @example\n * ```typescript\n * // Strike to head distributes damage\n * const distribution: BodyPartDamageDistribution = {\n *   primary: { part: BodyPart.HEAD, percentage: 0.8 },\n *   secondary: [\n *     { part: BodyPart.NECK, percentage: 0.2 }\n *   ]\n * };\n * ```\n * \n * @public\n * @category Body Part System\n * @korean 신체부위피해분배\n */\nexport interface BodyPartDamageDistribution {\n  /** Primary body part receiving most damage */\n  readonly primary: {\n    readonly part: BodyPart;\n    readonly percentage: number; // 0.0-1.0\n  };\n  /** Secondary body parts receiving splash damage */\n  readonly secondary: readonly {\n    readonly part: BodyPart;\n    readonly percentage: number; // 0.0-1.0\n  }[];\n}\n\n/**\n * Body part status information for UI display.\n * \n * **Korean**: 신체 부위 상태 정보\n * \n * Provides UI-friendly data about body part health status including\n * color coding, status text, and icon information.\n * \n * @public\n * @category Body Part System\n * @korean 신체부위상태\n */\nexport interface BodyPartStatus {\n  /** Body part identifier */\n  readonly part: BodyPart;\n  /** Current health (0-100) */\n  readonly health: number;\n  /** Maximum health */\n  readonly maxHealth: number;\n  /** Health percentage (0.0-1.0) */\n  readonly percentage: number;\n  /** Status description */\n  readonly status: KoreanText;\n  /** Color code for UI (hex number) */\n  readonly color: number;\n  /** Whether this part is critically damaged */\n  readonly critical: boolean;\n  /** Whether this part is non-functional */\n  readonly disabled: boolean;\n}\n\n/**\n * Configuration for body part health system.\n * \n * **Korean**: 신체 부위 시스템 설정\n * \n * Defines thresholds, multipliers, and constants used by the body part\n * health system for damage calculation and effect application.\n * \n * @public\n * @category Body Part System\n * @korean 신체부위설정\n */\nexport interface BodyPartHealthConfig {\n  /** Default max health for all body parts */\n  readonly defaultMaxHealth: number;\n  /** Health threshold for minor penalties (percentage) */\n  readonly minorPenaltyThreshold: number;\n  /** Health threshold for major penalties (percentage) */\n  readonly majorPenaltyThreshold: number;\n  /** Health threshold for severe penalties (percentage) */\n  readonly severePenaltyThreshold: number;\n  /** Health threshold for critical status (percentage) */\n  readonly criticalThreshold: number;\n  /** Effect multipliers for each threshold tier */\n  readonly effectMultipliers: {\n    readonly minor: number;\n    readonly major: number;\n    readonly severe: number;\n    readonly critical: number;\n  };\n}\n\n/**\n * Default configuration values for body part health system.\n * \n * @public\n * @category Body Part System\n */\nexport const DEFAULT_BODY_PART_CONFIG: BodyPartHealthConfig = {\n  defaultMaxHealth: 100,\n  minorPenaltyThreshold: 0.75,  // 75% HP\n  majorPenaltyThreshold: 0.50,   // 50% HP\n  severePenaltyThreshold: 0.25,  // 25% HP\n  criticalThreshold: 0.10,       // 10% HP\n  effectMultipliers: {\n    minor: 0.90,    // 10% penalty\n    major: 0.70,    // 30% penalty\n    severe: 0.40,   // 60% penalty\n    critical: 0.10, // 90% penalty\n  },\n} as const;\n\n/**\n * Body part health effect constants matching acceptance criteria.\n * \n * **Korean**: 신체 부위 효과 상수\n * \n * Defines specific combat penalties as per requirements:\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 * @public\n * @category Body Part System\n */\nexport const BODY_PART_EFFECT_CONSTANTS = {\n  /** Head damage effects */\n  HEAD: {\n    CONSCIOUSNESS_PENALTY_AT_50: 0.75, // 25% consciousness reduction\n    CRITICAL_THRESHOLD: 0.50,\n  },\n  /** Torso damage effects */\n  TORSO: {\n    STAMINA_REGEN_PENALTY_AT_50: 0.50, // 50% stamina regen reduction\n    CRITICAL_THRESHOLD: 0.50,\n  },\n  /** Arm damage effects */\n  ARMS: {\n    ATTACK_DAMAGE_PENALTY_AT_50: 0.70, // 30% attack damage reduction\n    CRITICAL_THRESHOLD: 0.50,\n  },\n  /** Leg damage effects */\n  LEGS: {\n    MOVEMENT_SPEED_PENALTY_AT_50: 0.60, // 40% movement speed reduction\n    CRITICAL_THRESHOLD: 0.50,\n  },\n} as const;\n\n/**\n * Leg injury severity levels for movement penalties.\n * \n * **Korean**: 다리 부상 정도 (Leg Injury Severity)\n * \n * Defines movement impairment states based on leg health percentage.\n * \n * @public\n * @category Body Part System\n * @korean 다리부상정도\n */\nexport enum LegInjuryState {\n  /** Normal movement - Leg health 100-70% */\n  NORMAL = \"normal\",\n  /** Limping - Leg health 69-50% */\n  LIMPING = \"limping\",\n  /** Severe limp - Leg health 49-30% */\n  SEVERE_LIMP = \"severe_limp\",\n  /** Hobbled - Leg health <30%, cannot run */\n  HOBBLED = \"hobbled\",\n}\n\n/**\n * Movement penalty applied from leg damage.\n * \n * **Korean**: 이동 패널티 (Movement Penalty)\n * \n * Describes the current movement impairment including speed reduction,\n * stance change penalties, and balance effects.\n * \n * @public\n * @category Body Part System\n * @korean 이동패널티\n */\nexport interface MovementPenalty {\n  /** Movement speed multiplier (0.0-1.0) */\n  readonly speedMultiplier: number;\n  /** Whether player can run (false when hobbled) */\n  readonly canRun: boolean;\n  /** Current injury state */\n  readonly injuryState: LegInjuryState;\n  /** Stance change duration multiplier (1.0 = normal, 2.0 = 2x slower) */\n  readonly stanceChangePenalty: number;\n  /** Whether advanced stances are restricted */\n  readonly advancedStancesRestricted: boolean;\n  /** Balance modifier from leg damage (0.0-1.0) */\n  readonly balanceModifier: number;\n  /** Whether instant penalty is active (from knee/ankle strike) */\n  readonly hasInstantPenalty: boolean;\n  /** Timestamp when instant penalty expires (0 if not active) */\n  readonly instantPenaltyExpiry: number;\n}\n\n/**\n * Instant movement penalty from knee/ankle strikes.\n * \n * **Korean**: 순간 이동 패널티 (Instant Movement Penalty)\n * \n * Applied immediately upon striking knee or ankle vital points,\n * causing temporary severe movement impairment.\n * \n * @public\n * @category Body Part System\n * @korean 순간이동패널티\n */\nexport interface InstantMovementPenalty {\n  /** Speed multiplier during instant penalty */\n  readonly speedMultiplier: number;\n  /** Duration in milliseconds */\n  readonly duration: number;\n  /** Timestamp when penalty was applied */\n  readonly appliedAt: number;\n  /** Body part that was struck */\n  readonly affectedPart: BodyPart;\n}\n\n/**\n * Movement penalty constants matching acceptance criteria.\n * \n * **Korean**: 이동 패널티 상수\n * \n * Defines thresholds and multipliers for injury-based movement penalties:\n * - 100-70%: Normal speed (100%)\n * - 69-50%: Limping (-20% speed)\n * - 49-30%: Severe limp (-40% speed)\n * - <30%: Hobbled (-60% speed, cannot run)\n * \n * @public\n * @category Body Part System\n */\nexport const MOVEMENT_PENALTY_CONSTANTS = {\n  /** Health percentage thresholds for injury states */\n  THRESHOLDS: {\n    NORMAL: 0.70,        // 70% and above\n    LIMPING: 0.50,       // 50-69%\n    SEVERE_LIMP: 0.30,   // 30-49%\n    HOBBLED: 0.0,        // Below 30%\n  },\n  \n  /** Speed multipliers for each injury state */\n  SPEED_MULTIPLIERS: {\n    NORMAL: 1.0,         // 100% speed\n    LIMPING: 0.8,        // 80% speed (-20%)\n    SEVERE_LIMP: 0.6,    // 60% speed (-40%)\n    HOBBLED: 0.4,        // 40% speed (-60%)\n  },\n  \n  /** Stance change penalty multipliers */\n  STANCE_CHANGE: {\n    NORMAL: 1.0,         // Normal duration\n    INJURED: 2.0,        // 2x duration when legs <50%\n    CRITICAL_THRESHOLD: 0.50,  // Threshold for stance penalties\n    RESTRICTION_THRESHOLD: 0.30, // Threshold for advanced stance restriction\n  },\n  \n  /** Instant penalty from knee/ankle strikes */\n  INSTANT_PENALTY: {\n    SPEED_MULTIPLIER: 0.3,  // 30% speed for 5 seconds\n    DURATION: 5000,         // 5 seconds in milliseconds\n  },\n  \n  /** Asymmetric damage effects */\n  ASYMMETRIC: {\n    /** Penalty when moving toward injured side */\n    SAME_SIDE_PENALTY: 0.8,    // Additional 20% penalty\n    /** Penalty when moving away from injured side */\n    OPPOSITE_SIDE_PENALTY: 0.9, // Additional 10% penalty\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+CA,IAAY,WAAL,yBAAA,UAAA;;AAEL,UAAA,UAAA;;AAEA,UAAA,UAAA;;AAEA,UAAA,iBAAA;;AAEA,UAAA,iBAAA;;AAEA,UAAA,cAAA;;AAEA,UAAA,eAAA;;AAEA,UAAA,cAAA;;AAEA,UAAA,eAAA;;KACD;;;;;;;AA8OD,IAAa,2BAAiD;CAC5D,kBAAkB;CAClB,uBAAuB;CACvB,uBAAuB;CACvB,wBAAwB;CACxB,mBAAmB;CACnB,mBAAmB;EACjB,OAAO;EACP,OAAO;EACP,QAAQ;EACR,UAAU;EACX;CACF;;;;;;;;;;;;;;;AAgBD,IAAa,6BAA6B;CAExC,MAAM;EACJ,6BAA6B;EAC7B,oBAAoB;EACrB;CAED,OAAO;EACL,6BAA6B;EAC7B,oBAAoB;EACrB;CAED,MAAM;EACJ,6BAA6B;EAC7B,oBAAoB;EACrB;CAED,MAAM;EACJ,8BAA8B;EAC9B,oBAAoB;EACrB;CACF;;;;;;;;;;;;AAaD,IAAY,iBAAL,yBAAA,gBAAA;;AAEL,gBAAA,YAAA;;AAEA,gBAAA,aAAA;;AAEA,gBAAA,iBAAA;;AAEA,gBAAA,aAAA;;KACD;;;;;;;;;;;;;;;AAsED,IAAa,6BAA6B;CAExC,YAAY;EACV,QAAQ;EACR,SAAS;EACT,aAAa;EACb,SAAS;EACV;CAGD,mBAAmB;EACjB,QAAQ;EACR,SAAS;EACT,aAAa;EACb,SAAS;EACV;CAGD,eAAe;EACb,QAAQ;EACR,SAAS;EACT,oBAAoB;EACpB,uBAAuB;EACxB;CAGD,iBAAiB;EACf,kBAAkB;EAClB,UAAU;EACX;CAGD,YAAY;EAEV,mBAAmB;EAEnB,uBAAuB;EACxB;CACF"}

package/lib/systems/breathing/BreathingDisruptionSystem.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Breathing Disruption System for realistic respiratory targeting mechanics.
+ *
+ * **Korean**: 호흡곤란 시스템 (Breathing Disruption System)
+ *
+ * This system implements realistic breathing disruption from torso strikes targeting
+ * the solar plexus, ribs, and diaphragm. Breathing difficulty reduces stamina
+ * regeneration and creates authentic combat trauma effects.
+ *
+ * ## Disruption Levels (호흡곤란 수준)
+ *
+ * - **Winded (바람맞음)**: 25% stamina regeneration penalty for 5 seconds
+ * - **Gasping (헐떡임)**: 50% stamina regeneration penalty for 10 seconds
+ * - **Severely Winded (심각한 호흡곤란)**: 75% stamina regeneration penalty for 15 seconds
+ *
+ * ## Korean Martial Arts Context
+ *
+ * Traditional Korean martial arts (태권도, 합기도, 택견) emphasize torso strikes:
+ * - **명치 (Myeongchi)**: Solar plexus - instant breath disruption
+ * - **늑골 (Neukgol)**: Floating ribs - cumulative breathing difficulty
+ * - **횡격막 (Hoenggyeongmak)**: Diaphragm - severe respiratory impact
+ *
+ * ## Game Design Philosophy
+ *
+ * Breathing disruption creates tactical depth by:
+ * 1. Rewarding torso targeting over simple head/limb attacks
+ * 2. Creating stamina management gameplay - disrupted fighters must fight defensively
+ * 3. Providing realistic combat trauma feedback
+ * 4. Encouraging recovery periods when torso health is compromised
+ *
+ * @module systems/breathing
+ * @category Combat Systems
+ * @korean 호흡곤란시스템
+ */
+import { VitalPointEffectType } from "../../types";
+import { StatusEffect } from "../types";
+import { PlayerState } from "../player";
+/**
+ * Breathing disruption severity levels.
+ *
+ * **Korean**: 호흡곤란 수준
+ *
+ * Progressive levels of respiratory impairment from torso strikes.
+ * Higher levels stack duration and increase stamina regeneration penalties.
+ *
+ * @public
+ * @category Combat Systems
+ * @korean 호흡곤란수준
+ */
+export declare enum BreathingDisruptionLevel {
+    /** No breathing disruption - normal stamina regeneration */
+    NONE = "none",
+    /**
+     * Winded (바람맞음)
+     * - 25% stamina regeneration penalty
+     * - Duration: 5 seconds
+     * - Caused by: Moderate torso strikes
+     */
+    WINDED = "winded",
+    /**
+     * Gasping (헐떡임)
+     * - 50% stamina regeneration penalty
+     * - Duration: 10 seconds
+     * - Caused by: Heavy torso strikes or multiple hits
+     */
+    GASPING = "gasping",
+    /**
+     * Severely Winded (심각한 호흡곤란)
+     * - 75% stamina regeneration penalty
+     * - Duration: 15 seconds
+     * - Caused by: Solar plexus vital point strikes
+     */
+    SEVERELY_WINDED = "severely_winded"
+}
+/**
+ * Breathing disruption effect extending StatusEffect.
+ *
+ * **Korean**: 호흡곤란 효과
+ *
+ * Tracks active breathing difficulty with Korean-English terminology.
+ * Integrates with the status effect system for consistent duration tracking.
+ *
+ * @public
+ * @category Combat Systems
+ * @korean 호흡곤란효과
+ */
+export interface BreathingDisruptionEffect extends StatusEffect {
+    /** Effect type is always BREATHLESSNESS */
+    readonly type: VitalPointEffectType.BREATHLESSNESS;
+    /** Breathing disruption severity level */
+    readonly level: BreathingDisruptionLevel;
+    /** Stamina regeneration multiplier (0.25 = 75% penalty, 0.50 = 50% penalty) */
+    readonly staminaRegenMultiplier: number;
+    /** Whether this effect can stack with additional torso hits */
+    readonly stackable: true;
+}
+/**
+ * Breathing Disruption System implementation.
+ *
+ * **Korean**: 호흡곤란 시스템
+ *
+ * Manages breathing disruption effects from torso targeting.
+ * Integrates with vital point system and stamina regeneration.
+ *
+ * @public
+ * @category Combat Systems
+ */
+export declare class BreathingDisruptionSystem {
+    /**
+     * Create a breathing disruption effect at specified severity level.
+     *
+     * **Korean**: 호흡곤란 효과 생성
+     *
+     * @param level - Severity level of breathing disruption
+     * @param source - Source of the disruption (technique name, vital point, etc.)
+     * @param timestamp - When the effect was applied (game time)
+     * @returns BreathingDisruptionEffect ready to apply to PlayerState
+     *
+     * @example
+     * ```typescript
+     * // Solar plexus strike causes severe disruption
+     * const effect = BreathingDisruptionSystem.createEffect(
+     *   BreathingDisruptionLevel.SEVERELY_WINDED,
+     *   "명치타격 (Solar Plexus Strike)",
+     *   Date.now()
+     * );
+     * ```
+     */
+    static createEffect(level: Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>, source: string, timestamp: number): BreathingDisruptionEffect;
+    /**
+     * Convert breathing disruption level to effect intensity.
+     *
+     * Maps severity levels to standardized EffectIntensity enum.
+     *
+     * @param level - Breathing disruption severity
+     * @returns Corresponding EffectIntensity value
+     */
+    private static levelToIntensity;
+    /**
+     * Calculate breathing disruption level from damage amount.
+     *
+     * **Korean**: 피해량으로 호흡곤란 수준 계산
+     *
+     * Determines appropriate disruption severity based on torso strike damage.
+     * Used when vital point ID is not specified but torso region was hit.
+     *
+     * @param damage - Base damage of the torso strike
+     * @param isSolarPlexus - Whether strike hit solar plexus vital point
+     * @returns Appropriate breathing disruption level
+     *
+     * @example
+     * ```typescript
+     * // Moderate torso strike (15 damage) causes winded effect
+     * const level = BreathingDisruptionSystem.calculateLevelFromDamage(15, false);
+     * // level === BreathingDisruptionLevel.WINDED
+     *
+     * // Solar plexus vital strike (20+ damage) causes severe effect
+     * const severeLevel = BreathingDisruptionSystem.calculateLevelFromDamage(25, true);
+     * // severeLevel === BreathingDisruptionLevel.SEVERELY_WINDED
+     * ```
+     */
+    static calculateLevelFromDamage(damage: number, isSolarPlexus: boolean): BreathingDisruptionLevel;
+    /**
+     * Stack multiple breathing disruption effects.
+     *
+     * **Korean**: 호흡곤란 효과 누적
+     *
+     * Cumulative torso hits increase disruption duration and potentially severity.
+     * Multiple hits stack duration, and severe hits can escalate the level.
+     *
+     * @param existingEffect - Current active breathing disruption effect
+     * @param newLevel - Severity of new torso strike
+     * @param source - Source of the new disruption
+     * @param timestamp - Current game time
+     * @returns Updated BreathingDisruptionEffect with stacked duration/severity
+     *
+     * @example
+     * ```typescript
+     * // First hit: Winded for 5 seconds
+     * let effect = BreathingDisruptionSystem.createEffect(
+     *   BreathingDisruptionLevel.WINDED, "Rib Strike", 1000
+     * );
+     *
+     * // Second hit: Stacks to Gasping with extended duration
+     * effect = BreathingDisruptionSystem.stackEffect(
+     *   effect, BreathingDisruptionLevel.WINDED, "Rib Strike", 3000
+     * );
+     * // Now Gasping level with 10+ seconds remaining
+     * ```
+     */
+    static stackEffect(existingEffect: BreathingDisruptionEffect, newLevel: Exclude<BreathingDisruptionLevel, BreathingDisruptionLevel.NONE>, source: string, timestamp: number): BreathingDisruptionEffect;
+    /**
+     * Compare two disruption levels and return the more severe.
+     *
+     * @param level1 - First disruption level
+     * @param level2 - Second disruption level
+     * @returns The more severe of the two levels
+     */
+    private static getHigherLevel;
+    /**
+     * Get active breathing disruption effect from player state.
+     *
+     * **Korean**: 활성 호흡곤란 효과 가져오기
+     *
+     * Searches player's active status effects for breathing disruption.
+     *
+     * @param player - Current player state
+     * @returns Active BreathingDisruptionEffect or undefined
+     */
+    static getActiveEffect(player: PlayerState): BreathingDisruptionEffect | undefined;
+    /**
+     * Calculate stamina regeneration multiplier with breathing disruption.
+     *
+     * **Korean**: 호흡곤란 포함 스태미나 재생 계산
+     *
+     * Applies breathing disruption penalty to base stamina regeneration rate.
+     * Used by stamina regeneration system each frame.
+     *
+     * @param player - Current player state
+     * @param baseRegenRate - Base stamina regeneration per second
+     * @returns Modified regeneration rate with breathing penalty applied
+     *
+     * @example
+     * ```typescript
+     * const baseRegen = 10; // 10 stamina/second normally
+     *
+     * // With Gasping effect (50% penalty)
+     * const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(
+     *   player, baseRegen
+     * );
+     * // modifiedRegen === 5 (50% of base rate)
+     * ```
+     */
+    static calculateStaminaRegen(player: PlayerState, baseRegenRate: number): number;
+    /**
+     * Check if player can recover from breathing disruption.
+     *
+     * **Korean**: 호흡곤란 회복 가능 여부 확인
+     *
+     * Recovery is possible when torso health > 50%.
+     * Player must avoid additional torso damage to allow breathing to normalize.
+     *
+     * @param player - Current player state
+     * @returns True if torso health supports recovery
+     */
+    static canRecover(player: PlayerState): boolean;
+    /**
+     * Apply gradual recovery to breathing disruption effect.
+     *
+     * **Korean**: 호흡곤란 점진적 회복 적용
+     *
+     * When torso health > 50% and no new hits, breathing gradually improves.
+     * This provides tactical gameplay: fighters with damaged torsos must fight defensively.
+     *
+     * @param effect - Current breathing disruption effect
+     * @param deltaTime - Time since last update (milliseconds)
+     * @param timestamp - Current game time
+     * @returns Updated effect with recovery applied, or undefined if fully recovered
+     *
+     * @example
+     * ```typescript
+     * // Each frame with torso health > 50%
+     * const updated = BreathingDisruptionSystem.applyGradualRecovery(
+     *   effect, 16.67, timestamp
+     * );
+     * // Effect duration decreases faster than normal expiration
+     * ```
+     */
+    static applyGradualRecovery(effect: BreathingDisruptionEffect, deltaTime: number, timestamp: number): BreathingDisruptionEffect | undefined;
+    /**
+     * Get breathing disruption level from player state.
+     *
+     * **Korean**: 플레이어 호흡곤란 수준 가져오기
+     *
+     * Convenience method to get current disruption level.
+     *
+     * @param player - Current player state
+     * @returns Current breathing disruption level (NONE if no active effect)
+     */
+    static getCurrentLevel(player: PlayerState): BreathingDisruptionLevel;
+    /**
+     * Check if breathing disruption is active.
+     *
+     * @param player - Current player state
+     * @returns True if player has active breathing disruption
+     */
+    static isActive(player: PlayerState): boolean;
+}
+//# sourceMappingURL=BreathingDisruptionSystem.d.ts.map

package/lib/systems/breathing/BreathingDisruptionSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BreathingDisruptionSystem.d.ts","sourceRoot":"","sources":["../../../src/systems/breathing/BreathingDisruptionSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAc,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;GAWG;AACH,oBAAY,wBAAwB;IAClC,4DAA4D;IAC5D,IAAI,SAAS;IAEb;;;;;OAKG;IACH,MAAM,WAAW;IAEjB;;;;;OAKG;IACH,OAAO,YAAY;IAEnB;;;;;OAKG;IACH,eAAe,oBAAoB;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAA0B,SAAQ,YAAY;IAC7D,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,cAAc,CAAC;IAEnD,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IAEzC,+EAA+E;IAC/E,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAgED;;;;;;;;;;GAUG;AACH,qBAAa,yBAAyB;IACpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,OAAO,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,IAAI,CAAC,EACvE,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,yBAAyB;IAkB5B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAe/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,wBAAwB,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,GACrB,wBAAwB;IAgB3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,WAAW,CAChB,cAAc,EAAE,yBAAyB,EACzC,QAAQ,EAAE,OAAO,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,IAAI,CAAC,EAC1E,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,yBAAyB;IAwB5B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAiB7B;;;;;;;;;OASG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,WAAW,GAClB,yBAAyB,GAAG,SAAS;IASxC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,qBAAqB,CAC1B,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM;IAUT;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAqB/C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,oBAAoB,CACzB,MAAM,EAAE,yBAAyB,EACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,yBAAyB,GAAG,SAAS;IAmBxC;;;;;;;;;OASG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,wBAAwB;IAKrE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CAG9C"}