blacktrigram 0.7.2

package/lib/data/archetypePhysicalAttributes.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Physical attribute profiles for each player archetype.
+ *
+ * **Korean**: 원형별 신체 속성 (Archetype Physical Attributes)
+ *
+ * Defines realistic body dimensions and composition for each of the five
+ * player archetypes based on their combat style and background. These
+ * attributes directly affect combat calculations including reach, movement
+ * speed, damage, and stamina.
+ *
+ * ## Design Philosophy
+ *
+ * Each archetype's physical profile reflects their training, lifestyle, and
+ * combat specialization:
+ *
+ * - **무사 (Musa)**: Balanced warrior with traditional training
+ * - **암살자 (Amsalja)**: Lean and agile for stealth operations
+ * - **해커 (Hacker)**: Average build with tech enhancements
+ * - **정보요원 (Jeongbo)**: Fit operative with intelligence background
+ * - **조직폭력배 (Jojik)**: Heavy and brutal street fighter
+ *
+ * @module data/archetypePhysicalAttributes
+ * @category Player & Archetypes
+ * @korean 원형신체데이터
+ */
+import { PhysicalAttributes, PlayerArchetype } from "../types";
+/**
+ * 무사 (Musa) - Traditional Warrior Physical Profile
+ *
+ * **Philosophy**: Honor through disciplined strength
+ * **Training**: Military special forces with traditional martial arts
+ * **Build**: Balanced, athletic, well-conditioned warrior
+ *
+ * Physical characteristics reflect years of traditional Korean martial arts
+ * training combined with modern military conditioning. Optimal balance between
+ * strength, speed, and endurance for prolonged combat effectiveness.
+ *
+ * @korean 무사신체
+ */
+export declare const MUSA_PHYSICAL: PhysicalAttributes;
+/**
+ * 암살자 (Amsalja) - Shadow Assassin Physical Profile
+ *
+ * **Philosophy**: Efficiency through invisibility
+ * **Training**: Covert operations and silent elimination specialist
+ * **Build**: Lean, agile, optimized for stealth and precision
+ *
+ * Physical characteristics emphasize low body mass for stealth movement,
+ * exceptional reach for vital point targeting, and minimal fat for maximum
+ * agility. Every attribute optimized for silent, deadly efficiency.
+ *
+ * @korean 암살자신체
+ */
+export declare const AMSALJA_PHYSICAL: PhysicalAttributes;
+/**
+ * 해커 (Hacker) - Cyber Warrior Physical Profile
+ *
+ * **Philosophy**: Information as power through technology
+ * **Training**: Digital native with supplemental physical training
+ * **Build**: Average physique enhanced by technological augmentation
+ *
+ * Physical characteristics reflect a tech-focused lifestyle with functional
+ * fitness rather than peak athletic conditioning. Attributes are average
+ * but compensated by cybernetic enhancements and data-driven combat analysis.
+ *
+ * @korean 해커신체
+ */
+export declare const HACKER_PHYSICAL: PhysicalAttributes;
+/**
+ * 정보요원 (Jeongbo Yowon) - Intelligence Operative Physical Profile
+ *
+ * **Philosophy**: Knowledge through observation and strategy
+ * **Training**: Government intelligence agency with specialized combat
+ * **Build**: Athletic operative with strategic fitness
+ *
+ * Physical characteristics reflect intelligence agency fitness standards
+ * with emphasis on versatility, endurance, and adaptability. Balanced
+ * attributes suitable for varied operational requirements.
+ *
+ * @korean 정보요원신체
+ */
+export declare const JEONGBO_PHYSICAL: PhysicalAttributes;
+/**
+ * 조직폭력배 (Jojik Pokryeokbae) - Organized Crime Physical Profile
+ *
+ * **Philosophy**: Survival through ruthlessness and brutality
+ * **Training**: Street fighting and underground martial arts
+ * **Build**: Heavy, powerful, intimidating presence
+ *
+ * Physical characteristics emphasize raw power and intimidation over
+ * refined technique. Heavier build with high muscle mass for brutal
+ * effectiveness and street-proven durability.
+ *
+ * @korean 조직폭력배신체
+ */
+export declare const JOJIK_PHYSICAL: PhysicalAttributes;
+/**
+ * Archetype physical attributes lookup map.
+ *
+ * **Korean**: 원형 신체 속성 맵 (Archetype Physical Attributes Map)
+ *
+ * Provides quick access to physical attribute profiles by archetype.
+ * Used by combat system to retrieve realistic body dimensions and
+ * composition for calculations.
+ *
+ * @example
+ * ```typescript
+ * const playerArchetype = PlayerArchetype.MUSA;
+ * const physicalAttrs = ARCHETYPE_PHYSICAL_ATTRIBUTES[playerArchetype];
+ * const kickRange = calculateKickRange(physicalAttrs.legLength);
+ * ```
+ *
+ * @public
+ * @korean 원형신체맵
+ */
+export declare const ARCHETYPE_PHYSICAL_ATTRIBUTES: Record<PlayerArchetype, PhysicalAttributes>;
+/**
+ * Get physical attributes for a specific archetype.
+ *
+ * **Korean**: 원형 신체 속성 가져오기 (Get Archetype Physical Attributes)
+ *
+ * Retrieves the physical attribute profile for the specified player archetype.
+ * Returns a readonly copy to prevent accidental mutations.
+ *
+ * @param archetype - The player archetype to get attributes for
+ * @returns Physical attributes for the specified archetype
+ *
+ * @example
+ * ```typescript
+ * const musaAttrs = getArchetypePhysicalAttributes(PlayerArchetype.MUSA);
+ * console.log(`Musa weight: ${musaAttrs.weight}kg`);
+ * console.log(`Musa arm reach: ${musaAttrs.armLength}cm`);
+ * ```
+ *
+ * @public
+ * @korean 원형신체가져오기
+ */
+export declare function getArchetypePhysicalAttributes(archetype: PlayerArchetype): Readonly<PhysicalAttributes>;
+/**
+ * Calculate effective reach based on limb length and stance.
+ *
+ * **Korean**: 유효 거리 계산 (Calculate Effective Reach)
+ *
+ * Computes the effective combat reach considering limb length and
+ * body positioning. Different techniques use different limbs and
+ * leverage different amounts of body extension.
+ *
+ * @param limbLength - Length of the limb in centimeters
+ * @param extension - Percentage of full extension (0.0 to 1.0)
+ * @returns Effective reach in centimeters
+ *
+ * @example
+ * ```typescript
+ * // Full extension punch
+ * const punchReach = calculateEffectiveReach(75, 1.0); // 75cm
+ *
+ * // 70% extension kick (stable stance)
+ * const kickReach = calculateEffectiveReach(95, 0.7); // 66.5cm
+ * ```
+ *
+ * @public
+ * @korean 유효거리계산
+ */
+export declare function calculateEffectiveReach(limbLength: number, extension?: number): number;
+/**
+ * Calculate movement speed modifier based on weight and leg length.
+ *
+ * **Korean**: 이동 속도 계산 (Calculate Movement Speed)
+ *
+ * Computes movement speed modifier based on body weight (inversely)
+ * and leg length (positively). Heavier fighters move slower, while
+ * longer legs provide faster base movement.
+ *
+ * Formula: baseSpeed * (legLength / 95) * (75 / weight)
+ * - Normalized around 95cm legs and 75kg weight
+ *
+ * @param physical - Physical attributes of the fighter
+ * @param baseSpeed - Base movement speed (default: 100)
+ * @returns Modified movement speed
+ *
+ * @example
+ * ```typescript
+ * const musaSpeed = calculateMovementSpeed(MUSA_PHYSICAL);
+ * // Result: 100 * (95/95) * (75/75) = 100
+ *
+ * const jojikSpeed = calculateMovementSpeed(JOJIK_PHYSICAL);
+ * // Result: 100 * (90/95) * (75/85) = ~88.2 (slower)
+ * ```
+ *
+ * @public
+ * @korean 이동속도계산
+ */
+export declare function calculateMovementSpeed(physical: PhysicalAttributes, baseSpeed?: number): number;
+/**
+ * Calculate damage modifier based on muscle mass.
+ *
+ * **Korean**: 공격력 계산 (Calculate Damage Output)
+ *
+ * Computes damage output modifier based on muscle mass. More muscle
+ * means more power in strikes, but with diminishing returns.
+ *
+ * Formula: 1.0 + ((muscleMass - 35) / 35) * 0.3
+ * - Normalized around 35kg muscle mass
+ * - Maximum 30% bonus from muscle
+ *
+ * @param physical - Physical attributes of the fighter
+ * @returns Damage multiplier (typically 0.7 to 1.3)
+ *
+ * @example
+ * ```typescript
+ * const musaDamage = calculateDamageModifier(MUSA_PHYSICAL);
+ * // Result: 1.0 + ((38-35)/35)*0.3 = ~1.026
+ *
+ * const jojikDamage = calculateDamageModifier(JOJIK_PHYSICAL);
+ * // Result: 1.0 + ((42-35)/35)*0.3 = ~1.06 (stronger)
+ * ```
+ *
+ * @public
+ * @korean 공격력계산
+ */
+export declare function calculateDamageModifier(physical: PhysicalAttributes): number;
+/**
+ * Calculate defense modifier based on fat mass and muscle mass.
+ *
+ * **Korean**: 방어력 계산 (Calculate Defense)
+ *
+ * Computes defense modifier based on fat mass (padding) and muscle mass
+ * (structural integrity). Fat absorbs blunt damage, muscle protects
+ * against impact.
+ *
+ * Formula: 1.0 + (fatMass / 100) + (muscleMass / 200)
+ *
+ * @param physical - Physical attributes of the fighter
+ * @returns Defense multiplier (typically 1.0 to 1.3)
+ *
+ * @example
+ * ```typescript
+ * const amsaljaDefense = calculateDefenseModifier(AMSALJA_PHYSICAL);
+ * // Result: 1.0 + (9/100) + (32/200) = 1.25
+ *
+ * const jojikDefense = calculateDefenseModifier(JOJIK_PHYSICAL);
+ * // Result: 1.0 + (18/100) + (42/200) = 1.39 (tankier)
+ * ```
+ *
+ * @public
+ * @korean 방어력계산
+ */
+export declare function calculateDefenseModifier(physical: PhysicalAttributes): number;
+/**
+ * Calculate stamina regeneration rate based on age and fat mass.
+ *
+ * **Korean**: 체력 회복 속도 (Stamina Recovery Rate)
+ *
+ * Computes stamina recovery speed based on age (optimal 25-35) and
+ * fat mass (lower is better for recovery). Younger fighters and leaner
+ * builds recover faster.
+ *
+ * Formula: baseRate * ageFactor * fatFactor
+ * - Age factor peaks at 30 years (1.0), decreases before and after
+ * - Fat factor = 1.0 - (fatMass - 10) / 50
+ *
+ * @param physical - Physical attributes of the fighter
+ * @param baseRate - Base recovery rate (default: 10 per second)
+ * @returns Modified stamina recovery rate
+ *
+ * @example
+ * ```typescript
+ * const amsaljaRecovery = calculateStaminaRecovery(AMSALJA_PHYSICAL);
+ * // Age 28, fat 9kg: ~10.2 per second
+ *
+ * const jojikRecovery = calculateStaminaRecovery(JOJIK_PHYSICAL);
+ * // Age 36, fat 18kg: ~8.4 per second (slower)
+ * ```
+ *
+ * @public
+ * @korean 체력회복계산
+ */
+export declare function calculateStaminaRecovery(physical: PhysicalAttributes, baseRate?: number): number;
+//# sourceMappingURL=archetypePhysicalAttributes.d.ts.map

package/lib/data/archetypePhysicalAttributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypePhysicalAttributes.d.ts","sourceRoot":"","sources":["../../src/data/archetypePhysicalAttributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,kBAgH3B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAgH9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,kBAgH7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAgH9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,EAAE,kBAgH5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,eAAe,EACf,kBAAkB,CAOnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,eAAe,GACzB,QAAQ,CAAC,kBAAkB,CAAC,CAE9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAY,GACtB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,GAAE,MAAY,GACtB,MAAM,CAIR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAG5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAI7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,GAAE,MAAW,GACpB,MAAM,CAUR"}

package/lib/data/archetypePhysicalAttributes.js

@@ -0,0 +1,227 @@
+import { PlayerArchetype } from "../types/common.js";
+import "../types/index.js";
+//#region src/data/archetypePhysicalAttributes.ts
+/**
+* Physical attribute profiles for each player archetype.
+*
+* **Korean**: 원형별 신체 속성 (Archetype Physical Attributes)
+*
+* Defines realistic body dimensions and composition for each of the five
+* player archetypes based on their combat style and background. These
+* attributes directly affect combat calculations including reach, movement
+* speed, damage, and stamina.
+*
+* ## Design Philosophy
+*
+* Each archetype's physical profile reflects their training, lifestyle, and
+* combat specialization:
+*
+* - **무사 (Musa)**: Balanced warrior with traditional training
+* - **암살자 (Amsalja)**: Lean and agile for stealth operations
+* - **해커 (Hacker)**: Average build with tech enhancements
+* - **정보요원 (Jeongbo)**: Fit operative with intelligence background
+* - **조직폭력배 (Jojik)**: Heavy and brutal street fighter
+*
+* @module data/archetypePhysicalAttributes
+* @category Player & Archetypes
+* @korean 원형신체데이터
+*/
+/**
+* 무사 (Musa) - Traditional Warrior Physical Profile
+*
+* **Philosophy**: Honor through disciplined strength
+* **Training**: Military special forces with traditional martial arts
+* **Build**: Balanced, athletic, well-conditioned warrior
+*
+* Physical characteristics reflect years of traditional Korean martial arts
+* training combined with modern military conditioning. Optimal balance between
+* strength, speed, and endurance for prolonged combat effectiveness.
+*
+* @korean 무사신체
+*/
+var MUSA_PHYSICAL = {
+	weight: 82,
+	legLength: 96,
+	armLength: 77,
+	muscleMass: 35,
+	fatMass: 13,
+	age: 32,
+	totalHeight: 180,
+	torsoLength: 59,
+	headSize: 22,
+	neckLength: 11,
+	shoulderWidth: 46,
+	walkSpeed: 6,
+	runSpeed: 9.5,
+	acceleration: 12
+};
+/**
+* 암살자 (Amsalja) - Shadow Assassin Physical Profile
+*
+* **Philosophy**: Efficiency through invisibility
+* **Training**: Covert operations and silent elimination specialist
+* **Build**: Lean, agile, optimized for stealth and precision
+*
+* Physical characteristics emphasize low body mass for stealth movement,
+* exceptional reach for vital point targeting, and minimal fat for maximum
+* agility. Every attribute optimized for silent, deadly efficiency.
+*
+* @korean 암살자신체
+*/
+var AMSALJA_PHYSICAL = {
+	weight: 75,
+	legLength: 102,
+	armLength: 82,
+	muscleMass: 30,
+	fatMass: 10,
+	age: 28,
+	totalHeight: 186,
+	torsoLength: 58,
+	headSize: 22,
+	neckLength: 11,
+	shoulderWidth: 44,
+	walkSpeed: 6.5,
+	runSpeed: 11,
+	acceleration: 15
+};
+/**
+* 해커 (Hacker) - Cyber Warrior Physical Profile
+*
+* **Philosophy**: Information as power through technology
+* **Training**: Digital native with supplemental physical training
+* **Build**: Average physique enhanced by technological augmentation
+*
+* Physical characteristics reflect a tech-focused lifestyle with functional
+* fitness rather than peak athletic conditioning. Attributes are average
+* but compensated by cybernetic enhancements and data-driven combat analysis.
+*
+* @korean 해커신체
+*/
+var HACKER_PHYSICAL = {
+	weight: 72,
+	legLength: 92,
+	armLength: 73,
+	muscleMass: 28,
+	fatMass: 15,
+	age: 26,
+	totalHeight: 175,
+	torsoLength: 57,
+	headSize: 22,
+	neckLength: 10,
+	shoulderWidth: 43,
+	walkSpeed: 5.5,
+	runSpeed: 8.5,
+	acceleration: 10
+};
+/**
+* 정보요원 (Jeongbo Yowon) - Intelligence Operative Physical Profile
+*
+* **Philosophy**: Knowledge through observation and strategy
+* **Training**: Government intelligence agency with specialized combat
+* **Build**: Athletic operative with strategic fitness
+*
+* Physical characteristics reflect intelligence agency fitness standards
+* with emphasis on versatility, endurance, and adaptability. Balanced
+* attributes suitable for varied operational requirements.
+*
+* @korean 정보요원신체
+*/
+var JEONGBO_PHYSICAL = {
+	weight: 78,
+	legLength: 95,
+	armLength: 76,
+	muscleMass: 32,
+	fatMass: 12,
+	age: 34,
+	totalHeight: 179,
+	torsoLength: 58,
+	headSize: 22,
+	neckLength: 10,
+	shoulderWidth: 45,
+	walkSpeed: 6.2,
+	runSpeed: 10,
+	acceleration: 14
+};
+/**
+* 조직폭력배 (Jojik Pokryeokbae) - Organized Crime Physical Profile
+*
+* **Philosophy**: Survival through ruthlessness and brutality
+* **Training**: Street fighting and underground martial arts
+* **Build**: Heavy, powerful, intimidating presence
+*
+* Physical characteristics emphasize raw power and intimidation over
+* refined technique. Heavier build with high muscle mass for brutal
+* effectiveness and street-proven durability.
+*
+* @korean 조직폭력배신체
+*/
+var JOJIK_PHYSICAL = {
+	weight: 105,
+	legLength: 100,
+	armLength: 84,
+	muscleMass: 48,
+	fatMass: 20,
+	age: 36,
+	totalHeight: 188,
+	torsoLength: 64,
+	headSize: 24,
+	neckLength: 11,
+	shoulderWidth: 54,
+	walkSpeed: 5,
+	runSpeed: 8,
+	acceleration: 9
+};
+/**
+* Archetype physical attributes lookup map.
+*
+* **Korean**: 원형 신체 속성 맵 (Archetype Physical Attributes Map)
+*
+* Provides quick access to physical attribute profiles by archetype.
+* Used by combat system to retrieve realistic body dimensions and
+* composition for calculations.
+*
+* @example
+* ```typescript
+* const playerArchetype = PlayerArchetype.MUSA;
+* const physicalAttrs = ARCHETYPE_PHYSICAL_ATTRIBUTES[playerArchetype];
+* const kickRange = calculateKickRange(physicalAttrs.legLength);
+* ```
+*
+* @public
+* @korean 원형신체맵
+*/
+var ARCHETYPE_PHYSICAL_ATTRIBUTES = {
+	[PlayerArchetype.MUSA]: MUSA_PHYSICAL,
+	[PlayerArchetype.AMSALJA]: AMSALJA_PHYSICAL,
+	[PlayerArchetype.HACKER]: HACKER_PHYSICAL,
+	[PlayerArchetype.JEONGBO_YOWON]: JEONGBO_PHYSICAL,
+	[PlayerArchetype.JOJIK_POKRYEOKBAE]: JOJIK_PHYSICAL
+};
+/**
+* Get physical attributes for a specific archetype.
+*
+* **Korean**: 원형 신체 속성 가져오기 (Get Archetype Physical Attributes)
+*
+* Retrieves the physical attribute profile for the specified player archetype.
+* Returns a readonly copy to prevent accidental mutations.
+*
+* @param archetype - The player archetype to get attributes for
+* @returns Physical attributes for the specified archetype
+*
+* @example
+* ```typescript
+* const musaAttrs = getArchetypePhysicalAttributes(PlayerArchetype.MUSA);
+* console.log(`Musa weight: ${musaAttrs.weight}kg`);
+* console.log(`Musa arm reach: ${musaAttrs.armLength}cm`);
+* ```
+*
+* @public
+* @korean 원형신체가져오기
+*/
+function getArchetypePhysicalAttributes(archetype) {
+	return ARCHETYPE_PHYSICAL_ATTRIBUTES[archetype];
+}
+//#endregion
+export { getArchetypePhysicalAttributes };
+
+//# sourceMappingURL=archetypePhysicalAttributes.js.map

package/lib/data/archetypePhysicalAttributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypePhysicalAttributes.js","names":[],"sources":["../../src/data/archetypePhysicalAttributes.ts"],"sourcesContent":["/**\n * Physical attribute profiles for each player archetype.\n *\n * **Korean**: 원형별 신체 속성 (Archetype Physical Attributes)\n *\n * Defines realistic body dimensions and composition for each of the five\n * player archetypes based on their combat style and background. These\n * attributes directly affect combat calculations including reach, movement\n * speed, damage, and stamina.\n *\n * ## Design Philosophy\n *\n * Each archetype's physical profile reflects their training, lifestyle, and\n * combat specialization:\n *\n * - **무사 (Musa)**: Balanced warrior with traditional training\n * - **암살자 (Amsalja)**: Lean and agile for stealth operations\n * - **해커 (Hacker)**: Average build with tech enhancements\n * - **정보요원 (Jeongbo)**: Fit operative with intelligence background\n * - **조직폭력배 (Jojik)**: Heavy and brutal street fighter\n *\n * @module data/archetypePhysicalAttributes\n * @category Player & Archetypes\n * @korean 원형신체데이터\n */\n\nimport { PhysicalAttributes, PlayerArchetype } from \"@/types\";\n\n/**\n * 무사 (Musa) - Traditional Warrior Physical Profile\n *\n * **Philosophy**: Honor through disciplined strength\n * **Training**: Military special forces with traditional martial arts\n * **Build**: Balanced, athletic, well-conditioned warrior\n *\n * Physical characteristics reflect years of traditional Korean martial arts\n * training combined with modern military conditioning. Optimal balance between\n * strength, speed, and endurance for prolonged combat effectiveness.\n *\n * @korean 무사신체\n */\nexport const MUSA_PHYSICAL: PhysicalAttributes = {\n  /**\n   * Weight: 82 kg\n   * Athletic military build for strength and mobility\n   * Korean Special Forces standard physique\n   * Optimal power-to-weight ratio for combat\n   */\n  weight: 82,\n\n  /**\n   * Leg Length: 96 cm\n   * Athletic leg length for powerful kicks\n   * Trained for devastating Taekwondo kicks\n   * Balanced reach and stability\n   */\n  legLength: 96,\n\n  /**\n   * Arm Length: 77 cm\n   * Strong arm reach for disciplined striking\n   * Conditioned for both precision and power\n   * Effective grappling range\n   */\n  armLength: 77,\n\n  /**\n   * Muscle Mass: 35 kg (43% of body weight)\n   * High muscle mass from military training\n   * Realistic for trained special forces soldier\n   * Excellent functional strength\n   */\n  muscleMass: 35,\n\n  /**\n   * Fat Mass: 13 kg (16% body fat)\n   * Athletic body fat percentage\n   * Maintains energy reserves for combat endurance\n   * Optimal for sustained operations\n   */\n  fatMass: 13,\n\n  /**\n   * Age: 32 years\n   * Prime combat age combining experience and physical capability\n   * Peak of martial arts mastery and physical conditioning\n   * Balanced wisdom and reflexes\n   */\n  age: 32,\n\n  /**\n   * Total Height: 180 cm\n   * Solid military build height\n   * Above average for imposing presence\n   * Good proportions for all-around combat\n   */\n  totalHeight: 180,\n\n  /**\n   * Torso Length: 59 cm\n   * Strong core providing stable base\n   * Optimal for breath control and Ki cultivation\n   * Protected vital points\n   */\n  torsoLength: 59,\n\n  /**\n   * Head Size: 22 cm\n   * Average head diameter\n   * Standard vital point target area\n   * Balanced consciousness vulnerability\n   */\n  headSize: 22,\n\n  /**\n   * Neck Length: 11 cm\n   * Strong, trained neck\n   * Moderate vulnerability to chokes\n   * Conditioned for impact resistance\n   */\n  neckLength: 11,\n\n  /**\n   * Shoulder Width: 46 cm\n   * Broad military shoulders\n   * Strong defense coverage\n   * Excellent grappling control points\n   */\n  shoulderWidth: 46,\n\n  /**\n   * Walk Speed: 6.0 m/s\n   * Balanced tactical movement\n   * Military conditioning for sustained mobility\n   * Optimal for disciplined combat approach\n   */\n  walkSpeed: 6.0,\n\n  /**\n   * Run Speed: 9.5 m/s\n   * Strong sprint capability\n   * Combat-ready rapid repositioning\n   * Efficient for tactical advances\n   */\n  runSpeed: 9.5,\n\n  /**\n   * Acceleration: 12.0 m/s²\n   * Balanced explosiveness\n   * Military conditioning for quick reactions\n   * Optimal muscle-to-weight ratio for combat\n   */\n  acceleration: 12.0,\n};\n\n/**\n * 암살자 (Amsalja) - Shadow Assassin Physical Profile\n *\n * **Philosophy**: Efficiency through invisibility\n * **Training**: Covert operations and silent elimination specialist\n * **Build**: Lean, agile, optimized for stealth and precision\n *\n * Physical characteristics emphasize low body mass for stealth movement,\n * exceptional reach for vital point targeting, and minimal fat for maximum\n * agility. Every attribute optimized for silent, deadly efficiency.\n *\n * @korean 암살자신체\n */\nexport const AMSALJA_PHYSICAL: PhysicalAttributes = {\n  /**\n   * Weight: 75 kg\n   * Lean athletic build like a kickboxer (Israel Adesanya type)\n   * Optimized for speed, reach, and precision\n   * Light enough for stealth, heavy enough for power\n   */\n  weight: 75,\n\n  /**\n   * Leg Length: 102 cm\n   * Long legs for exceptional reach and stride\n   * Enables precise high kicks to vital points\n   * Excellent for maintaining distance\n   */\n  legLength: 102,\n\n  /**\n   * Arm Length: 82 cm\n   * Extended reach for range advantage\n   * Crucial for vital point precision strikes\n   * Keeps opponents at safe distance\n   */\n  armLength: 82,\n\n  /**\n   * Muscle Mass: 30 kg (40% of body weight)\n   * Lean, functional muscle for speed\n   * Optimized for explosive movements\n   * Sufficient for devastating precision strikes\n   */\n  muscleMass: 30,\n\n  /**\n   * Fat Mass: 10 kg (13% body fat)\n   * Very low fat for maximum definition\n   * Peak agility and flexibility\n   * Athletic performance optimized\n   */\n  fatMass: 10,\n\n  /**\n   * Age: 28 years\n   * Young and at peak physical agility\n   * Optimal reflexes for split-second decisions\n   * Experience balanced with peak conditioning\n   */\n  age: 28,\n\n  /**\n   * Total Height: 186 cm\n   * Tall for exceptional reach advantage\n   * Long limb ratios for vital point access\n   * Intimidating presence while maintaining agility\n   */\n  totalHeight: 186,\n\n  /**\n   * Torso Length: 58 cm\n   * Compact torso for lower center of gravity\n   * Agile core for quick movement\n   * Reduced vital point target area\n   */\n  torsoLength: 58,\n\n  /**\n   * Head Size: 22 cm\n   * Normal head profile\n   * Standard target area for head strikes\n   * Balanced consciousness vulnerability\n   */\n  headSize: 22,\n\n  /**\n   * Neck Length: 11 cm\n   * Longer neck for head movement evasion\n   * Slightly increased choke vulnerability\n   * Requires skilled guard positioning\n   */\n  neckLength: 11,\n\n  /**\n   * Shoulder Width: 44 cm\n   * Lean but athletic shoulders\n   * Good mobility with adequate coverage\n   * Efficient for striking mechanics\n   */\n  shoulderWidth: 44,\n\n  /**\n   * Walk Speed: 6.5 m/s\n   * FASTEST tactical movement\n   * Optimized for silent, rapid repositioning\n   * Assassin-level agility and speed\n   */\n  walkSpeed: 6.5,\n\n  /**\n   * Run Speed: 11.0 m/s\n   * FASTEST sprint capability\n   * Peak athletic conditioning for pursuit\n   * Exceptional for closing distance quickly\n   */\n  runSpeed: 11.0,\n\n  /**\n   * Acceleration: 15.0 m/s²\n   * HIGHEST explosiveness\n   * Exceptional muscle-to-weight ratio\n   * Lightning-fast direction changes\n   */\n  acceleration: 15.0,\n};\n\n/**\n * 해커 (Hacker) - Cyber Warrior Physical Profile\n *\n * **Philosophy**: Information as power through technology\n * **Training**: Digital native with supplemental physical training\n * **Build**: Average physique enhanced by technological augmentation\n *\n * Physical characteristics reflect a tech-focused lifestyle with functional\n * fitness rather than peak athletic conditioning. Attributes are average\n * but compensated by cybernetic enhancements and data-driven combat analysis.\n *\n * @korean 해커신체\n */\nexport const HACKER_PHYSICAL: PhysicalAttributes = {\n  /**\n   * Weight: 72 kg\n   * Average weight for height\n   * Functional fitness from regular training\n   * Tech worker who maintains fitness\n   */\n  weight: 72,\n\n  /**\n   * Leg Length: 92 cm\n   * Standard leg proportions\n   * Adequate for tech-assisted movement\n   * Compensated by augmented targeting systems\n   */\n  legLength: 92,\n\n  /**\n   * Arm Length: 73 cm\n   * Average arm reach\n   * Sufficient when aided by cybernetic enhancements\n   * Precision compensated by data analysis\n   */\n  armLength: 73,\n\n  /**\n   * Muscle Mass: 28 kg (39% of body weight)\n   * Moderate muscle mass for tech worker\n   * Maintained through efficient training\n   * Relies more on tech than raw strength\n   */\n  muscleMass: 28,\n\n  /**\n   * Fat Mass: 15 kg (21% body fat)\n   * Average body fat from desk work\n   * Still functional for combat\n   * Less emphasis on peak conditioning\n   */\n  fatMass: 15,\n\n  /**\n   * Age: 26 years\n   * Young digital native\n   * High neuroplasticity for tech integration\n   * Peak learning and adaptation capabilities\n   */\n  age: 26,\n\n  /**\n   * Total Height: 175 cm\n   * Average Korean male height\n   * Standard proportions for tech integration\n   * Balanced body type for augmentation\n   */\n  totalHeight: 175,\n\n  /**\n   * Torso Length: 57 cm\n   * Average torso length\n   * Standard core for cyber implants\n   * Balanced Ki flow for tech-bio integration\n   */\n  torsoLength: 57,\n\n  /**\n   * Head Size: 22 cm\n   * Average head size\n   * Standard neural interface compatibility\n   * Balanced for augmented reality overlays\n   */\n  headSize: 22,\n\n  /**\n   * Neck Length: 10 cm\n   * Average neck length\n   * Standard vulnerability to chokes\n   * Adequate for neural interface cables\n   */\n  neckLength: 10,\n\n  /**\n   * Shoulder Width: 43 cm\n   * Average shoulder span\n   * Standard defense coverage\n   * Balanced for wearable tech integration\n   */\n  shoulderWidth: 43,\n\n  /**\n   * Walk Speed: 5.5 m/s\n   * Average tactical movement\n   * Tech-focused rather than athletic\n   * Compensated by cybernetic enhancements\n   */\n  walkSpeed: 5.5,\n\n  /**\n   * Run Speed: 8.5 m/s\n   * Moderate sprint capability\n   * Supplemental physical training\n   * Relies on tech for combat advantage\n   */\n  runSpeed: 8.5,\n\n  /**\n   * Acceleration: 10.0 m/s²\n   * Moderate explosiveness\n   * Average physical conditioning\n   * Compensated by tech-enhanced reactions\n   */\n  acceleration: 10.0,\n};\n\n/**\n * 정보요원 (Jeongbo Yowon) - Intelligence Operative Physical Profile\n *\n * **Philosophy**: Knowledge through observation and strategy\n * **Training**: Government intelligence agency with specialized combat\n * **Build**: Athletic operative with strategic fitness\n *\n * Physical characteristics reflect intelligence agency fitness standards\n * with emphasis on versatility, endurance, and adaptability. Balanced\n * attributes suitable for varied operational requirements.\n *\n * @korean 정보요원신체\n */\nexport const JEONGBO_PHYSICAL: PhysicalAttributes = {\n  /**\n   * Weight: 78 kg\n   * Fit intelligence operative build\n   * Government agency fitness standard\n   * Balance between capability and inconspicuousness\n   */\n  weight: 78,\n\n  /**\n   * Leg Length: 95 cm\n   * Balanced leg length for varied terrain\n   * Standard proportions for operational flexibility\n   * Suitable for extended pursuit or evasion\n   */\n  legLength: 95,\n\n  /**\n   * Arm Length: 76 cm\n   * Standard operative reach\n   * Trained for weapon and hand-to-hand versatility\n   * Balanced for multiple combat scenarios\n   */\n  armLength: 76,\n\n  /**\n   * Muscle Mass: 32 kg (41% of body weight)\n   * Agency-required conditioning\n   * Balanced strength for operational demands\n   * Emphasis on functional fitness\n   */\n  muscleMass: 32,\n\n  /**\n   * Fat Mass: 12 kg (15% body fat)\n   * Low but sustainable body fat\n   * Maintains energy reserves for long operations\n   * Within intelligence service standards\n   */\n  fatMass: 12,\n\n  /**\n   * Age: 34 years\n   * Experienced operative\n   * Peak of analytical and physical capability\n   * Wisdom from field experience\n   */\n  age: 34,\n\n  /**\n   * Total Height: 179 cm\n   * Standard government agency height\n   * Balanced proportions for versatility\n   * Neither imposing nor inconspicuous\n   */\n  totalHeight: 179,\n\n  /**\n   * Torso Length: 58 cm\n   * Balanced torso for varied operations\n   * Good breath control and stamina\n   * Standard vital point distribution\n   */\n  torsoLength: 58,\n\n  /**\n   * Head Size: 22 cm\n   * Average head size\n   * Standard tactical gear compatibility\n   * Balanced consciousness resilience\n   */\n  headSize: 22,\n\n  /**\n   * Neck Length: 10 cm\n   * Average neck length\n   * Trained resistance to chokes\n   * Standard blood choke vulnerability\n   */\n  neckLength: 10,\n\n  /**\n   * Shoulder Width: 45 cm\n   * Athletic shoulder width\n   * Good defense coverage\n   * Versatile grappling control\n   */\n  shoulderWidth: 45,\n\n  /**\n   * Walk Speed: 6.2 m/s\n   * Fast tactical movement\n   * Agency fitness standards\n   * Excellent for varied operations\n   */\n  walkSpeed: 6.2,\n\n  /**\n   * Run Speed: 10.0 m/s\n   * Strong sprint capability\n   * Intelligence operative conditioning\n   * Efficient pursuit and evasion\n   */\n  runSpeed: 10.0,\n\n  /**\n   * Acceleration: 14.0 m/s²\n   * High explosiveness\n   * Agency combat training\n   * Quick response for tactical situations\n   */\n  acceleration: 14.0,\n};\n\n/**\n * 조직폭력배 (Jojik Pokryeokbae) - Organized Crime Physical Profile\n *\n * **Philosophy**: Survival through ruthlessness and brutality\n * **Training**: Street fighting and underground martial arts\n * **Build**: Heavy, powerful, intimidating presence\n *\n * Physical characteristics emphasize raw power and intimidation over\n * refined technique. Heavier build with high muscle mass for brutal\n * effectiveness and street-proven durability.\n *\n * @korean 조직폭력배신체\n */\nexport const JOJIK_PHYSICAL: PhysicalAttributes = {\n  /**\n   * Weight: 105 kg\n   * MASSIVE build for power and intimidation\n   * Like a heavyweight MMA fighter or large taekwondo practitioner\n   * Dominant mass advantage in any confrontation\n   */\n  weight: 105,\n\n  /**\n   * Leg Length: 100 cm\n   * Long, powerful legs despite heavy build\n   * Devastating kicks with massive power\n   * Surprising mobility for size\n   */\n  legLength: 100,\n\n  /**\n   * Arm Length: 84 cm\n   * Long, thick arms for crushing power\n   * Exceptional reach for grappling and strikes\n   * Street-fighting dominance\n   */\n  armLength: 84,\n\n  /**\n   * Muscle Mass: 48 kg (46% of body weight)\n   * Highest muscle mass of all archetypes\n   * Built through intense street combat and heavy training\n   * Raw, overwhelming power\n   */\n  muscleMass: 48,\n\n  /**\n   * Fat Mass: 20 kg (19% body fat)\n   * Functional body fat for damage absorption\n   * Provides padding against strikes\n   * Still very fit despite bulk\n   */\n  fatMass: 20,\n\n  /**\n   * Age: 36 years\n   * Veteran of street conflicts\n   * Battle-scarred and experienced\n   * Peak brutality and survival instincts\n   */\n  age: 36,\n\n  /**\n   * Total Height: 188 cm\n   * Tall AND massive build\n   * Physically imposing presence\n   * Dominates any confrontation visually\n   */\n  totalHeight: 188,\n\n  /**\n   * Torso Length: 64 cm\n   * Thick, powerful torso\n   * Massive core strength\n   * Enhanced durability and power generation\n   */\n  torsoLength: 64,\n\n  /**\n   * Head Size: 24 cm\n   * Large, thick skull\n   * Significant head strike resistance\n   * High consciousness resilience\n   */\n  headSize: 24,\n\n  /**\n   * Neck Length: 11 cm\n   * Thick, muscular neck\n   * Very difficult to choke\n   * Protected blood vessels\n   */\n  neckLength: 11,\n\n  /**\n   * Shoulder Width: 54 cm\n   * WIDEST shoulders - intimidating presence\n   * Maximum defense coverage\n   * Overwhelming physical dominance\n   */\n  shoulderWidth: 54,\n\n  /**\n   * Walk Speed: 5.0 m/s\n   * Slower tactical movement\n   * Heavy build reduces mobility\n   * Compensated by raw power and reach\n   */\n  walkSpeed: 5.0,\n\n  /**\n   * Run Speed: 8.0 m/s\n   * Moderate sprint capability\n   * Mass limits top speed\n   * Still intimidating when charging\n   */\n  runSpeed: 8.0,\n\n  /**\n   * Acceleration: 9.0 m/s²\n   * Lower explosiveness\n   * Heavy mass requires more force to move\n   * Compensated by devastating power on contact\n   */\n  acceleration: 9.0,\n};\n\n/**\n * Archetype physical attributes lookup map.\n *\n * **Korean**: 원형 신체 속성 맵 (Archetype Physical Attributes Map)\n *\n * Provides quick access to physical attribute profiles by archetype.\n * Used by combat system to retrieve realistic body dimensions and\n * composition for calculations.\n *\n * @example\n * ```typescript\n * const playerArchetype = PlayerArchetype.MUSA;\n * const physicalAttrs = ARCHETYPE_PHYSICAL_ATTRIBUTES[playerArchetype];\n * const kickRange = calculateKickRange(physicalAttrs.legLength);\n * ```\n *\n * @public\n * @korean 원형신체맵\n */\nexport const ARCHETYPE_PHYSICAL_ATTRIBUTES: Record<\n  PlayerArchetype,\n  PhysicalAttributes\n> = {\n  [PlayerArchetype.MUSA]: MUSA_PHYSICAL,\n  [PlayerArchetype.AMSALJA]: AMSALJA_PHYSICAL,\n  [PlayerArchetype.HACKER]: HACKER_PHYSICAL,\n  [PlayerArchetype.JEONGBO_YOWON]: JEONGBO_PHYSICAL,\n  [PlayerArchetype.JOJIK_POKRYEOKBAE]: JOJIK_PHYSICAL,\n};\n\n/**\n * Get physical attributes for a specific archetype.\n *\n * **Korean**: 원형 신체 속성 가져오기 (Get Archetype Physical Attributes)\n *\n * Retrieves the physical attribute profile for the specified player archetype.\n * Returns a readonly copy to prevent accidental mutations.\n *\n * @param archetype - The player archetype to get attributes for\n * @returns Physical attributes for the specified archetype\n *\n * @example\n * ```typescript\n * const musaAttrs = getArchetypePhysicalAttributes(PlayerArchetype.MUSA);\n * console.log(`Musa weight: ${musaAttrs.weight}kg`);\n * console.log(`Musa arm reach: ${musaAttrs.armLength}cm`);\n * ```\n *\n * @public\n * @korean 원형신체가져오기\n */\nexport function getArchetypePhysicalAttributes(\n  archetype: PlayerArchetype,\n): Readonly<PhysicalAttributes> {\n  return ARCHETYPE_PHYSICAL_ATTRIBUTES[archetype];\n}\n\n/**\n * Calculate effective reach based on limb length and stance.\n *\n * **Korean**: 유효 거리 계산 (Calculate Effective Reach)\n *\n * Computes the effective combat reach considering limb length and\n * body positioning. Different techniques use different limbs and\n * leverage different amounts of body extension.\n *\n * @param limbLength - Length of the limb in centimeters\n * @param extension - Percentage of full extension (0.0 to 1.0)\n * @returns Effective reach in centimeters\n *\n * @example\n * ```typescript\n * // Full extension punch\n * const punchReach = calculateEffectiveReach(75, 1.0); // 75cm\n *\n * // 70% extension kick (stable stance)\n * const kickReach = calculateEffectiveReach(95, 0.7); // 66.5cm\n * ```\n *\n * @public\n * @korean 유효거리계산\n */\nexport function calculateEffectiveReach(\n  limbLength: number,\n  extension: number = 1.0,\n): number {\n  return limbLength * Math.max(0, Math.min(1, extension));\n}\n\n/**\n * Calculate movement speed modifier based on weight and leg length.\n *\n * **Korean**: 이동 속도 계산 (Calculate Movement Speed)\n *\n * Computes movement speed modifier based on body weight (inversely)\n * and leg length (positively). Heavier fighters move slower, while\n * longer legs provide faster base movement.\n *\n * Formula: baseSpeed * (legLength / 95) * (75 / weight)\n * - Normalized around 95cm legs and 75kg weight\n *\n * @param physical - Physical attributes of the fighter\n * @param baseSpeed - Base movement speed (default: 100)\n * @returns Modified movement speed\n *\n * @example\n * ```typescript\n * const musaSpeed = calculateMovementSpeed(MUSA_PHYSICAL);\n * // Result: 100 * (95/95) * (75/75) = 100\n *\n * const jojikSpeed = calculateMovementSpeed(JOJIK_PHYSICAL);\n * // Result: 100 * (90/95) * (75/85) = ~88.2 (slower)\n * ```\n *\n * @public\n * @korean 이동속도계산\n */\nexport function calculateMovementSpeed(\n  physical: PhysicalAttributes,\n  baseSpeed: number = 100,\n): number {\n  const legFactor = physical.legLength / 95; // Normalized to 95cm average\n  const weightFactor = 75 / physical.weight; // Normalized to 75kg average\n  return baseSpeed * legFactor * weightFactor;\n}\n\n/**\n * Calculate damage modifier based on muscle mass.\n *\n * **Korean**: 공격력 계산 (Calculate Damage Output)\n *\n * Computes damage output modifier based on muscle mass. More muscle\n * means more power in strikes, but with diminishing returns.\n *\n * Formula: 1.0 + ((muscleMass - 35) / 35) * 0.3\n * - Normalized around 35kg muscle mass\n * - Maximum 30% bonus from muscle\n *\n * @param physical - Physical attributes of the fighter\n * @returns Damage multiplier (typically 0.7 to 1.3)\n *\n * @example\n * ```typescript\n * const musaDamage = calculateDamageModifier(MUSA_PHYSICAL);\n * // Result: 1.0 + ((38-35)/35)*0.3 = ~1.026\n *\n * const jojikDamage = calculateDamageModifier(JOJIK_PHYSICAL);\n * // Result: 1.0 + ((42-35)/35)*0.3 = ~1.06 (stronger)\n * ```\n *\n * @public\n * @korean 공격력계산\n */\nexport function calculateDamageModifier(physical: PhysicalAttributes): number {\n  const normalizedMuscle = (physical.muscleMass - 35) / 35;\n  return 1.0 + normalizedMuscle * 0.3;\n}\n\n/**\n * Calculate defense modifier based on fat mass and muscle mass.\n *\n * **Korean**: 방어력 계산 (Calculate Defense)\n *\n * Computes defense modifier based on fat mass (padding) and muscle mass\n * (structural integrity). Fat absorbs blunt damage, muscle protects\n * against impact.\n *\n * Formula: 1.0 + (fatMass / 100) + (muscleMass / 200)\n *\n * @param physical - Physical attributes of the fighter\n * @returns Defense multiplier (typically 1.0 to 1.3)\n *\n * @example\n * ```typescript\n * const amsaljaDefense = calculateDefenseModifier(AMSALJA_PHYSICAL);\n * // Result: 1.0 + (9/100) + (32/200) = 1.25\n *\n * const jojikDefense = calculateDefenseModifier(JOJIK_PHYSICAL);\n * // Result: 1.0 + (18/100) + (42/200) = 1.39 (tankier)\n * ```\n *\n * @public\n * @korean 방어력계산\n */\nexport function calculateDefenseModifier(physical: PhysicalAttributes): number {\n  const fatPadding = physical.fatMass / 100;\n  const muscleStructure = physical.muscleMass / 200;\n  return 1.0 + fatPadding + muscleStructure;\n}\n\n/**\n * Calculate stamina regeneration rate based on age and fat mass.\n *\n * **Korean**: 체력 회복 속도 (Stamina Recovery Rate)\n *\n * Computes stamina recovery speed based on age (optimal 25-35) and\n * fat mass (lower is better for recovery). Younger fighters and leaner\n * builds recover faster.\n *\n * Formula: baseRate * ageFactor * fatFactor\n * - Age factor peaks at 30 years (1.0), decreases before and after\n * - Fat factor = 1.0 - (fatMass - 10) / 50\n *\n * @param physical - Physical attributes of the fighter\n * @param baseRate - Base recovery rate (default: 10 per second)\n * @returns Modified stamina recovery rate\n *\n * @example\n * ```typescript\n * const amsaljaRecovery = calculateStaminaRecovery(AMSALJA_PHYSICAL);\n * // Age 28, fat 9kg: ~10.2 per second\n *\n * const jojikRecovery = calculateStaminaRecovery(JOJIK_PHYSICAL);\n * // Age 36, fat 18kg: ~8.4 per second (slower)\n * ```\n *\n * @public\n * @korean 체력회복계산\n */\nexport function calculateStaminaRecovery(\n  physical: PhysicalAttributes,\n  baseRate: number = 10,\n): number {\n  // Age factor: peaks at 30, decreases before and after\n  const ageOptimal = 30;\n  const ageDiff = Math.abs(physical.age - ageOptimal);\n  const ageFactor = Math.max(0.7, 1.0 - ageDiff / 30);\n\n  // Fat factor: lower fat = faster recovery\n  const fatFactor = Math.max(0.7, 1.0 - (physical.fatMass - 10) / 50);\n\n  return baseRate * ageFactor * fatFactor;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,IAAa,gBAAoC;CAO/C,QAAQ;CAQR,WAAW;CAQX,WAAW;CAQX,YAAY;CAQZ,SAAS;CAQT,KAAK;CAQL,aAAa;CAQb,aAAa;CAQb,UAAU;CAQV,YAAY;CAQZ,eAAe;CAQf,WAAW;CAQX,UAAU;CAQV,cAAc;CACf;;;;;;;;;;;;;;AAeD,IAAa,mBAAuC;CAOlD,QAAQ;CAQR,WAAW;CAQX,WAAW;CAQX,YAAY;CAQZ,SAAS;CAQT,KAAK;CAQL,aAAa;CAQb,aAAa;CAQb,UAAU;CAQV,YAAY;CAQZ,eAAe;CAQf,WAAW;CAQX,UAAU;CAQV,cAAc;CACf;;;;;;;;;;;;;;AAeD,IAAa,kBAAsC;CAOjD,QAAQ;CAQR,WAAW;CAQX,WAAW;CAQX,YAAY;CAQZ,SAAS;CAQT,KAAK;CAQL,aAAa;CAQb,aAAa;CAQb,UAAU;CAQV,YAAY;CAQZ,eAAe;CAQf,WAAW;CAQX,UAAU;CAQV,cAAc;CACf;;;;;;;;;;;;;;AAeD,IAAa,mBAAuC;CAOlD,QAAQ;CAQR,WAAW;CAQX,WAAW;CAQX,YAAY;CAQZ,SAAS;CAQT,KAAK;CAQL,aAAa;CAQb,aAAa;CAQb,UAAU;CAQV,YAAY;CAQZ,eAAe;CAQf,WAAW;CAQX,UAAU;CAQV,cAAc;CACf;;;;;;;;;;;;;;AAeD,IAAa,iBAAqC;CAOhD,QAAQ;CAQR,WAAW;CAQX,WAAW;CAQX,YAAY;CAQZ,SAAS;CAQT,KAAK;CAQL,aAAa;CAQb,aAAa;CAQb,UAAU;CAQV,YAAY;CAQZ,eAAe;CAQf,WAAW;CAQX,UAAU;CAQV,cAAc;CACf;;;;;;;;;;;;;;;;;;;;AAqBD,IAAa,gCAGT;EACD,gBAAgB,OAAO;EACvB,gBAAgB,UAAU;EAC1B,gBAAgB,SAAS;EACzB,gBAAgB,gBAAgB;EAChC,gBAAgB,oBAAoB;CACtC;;;;;;;;;;;;;;;;;;;;;;AAuBD,SAAgB,+BACd,WAC8B;AAC9B,QAAO,8BAA8B"}

package/lib/data/techniqueMappings.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Technique to Animation Type mappings
+ *
+ * **Korean**: 기술-애니메이션 매핑
+ *
+ * Maps each technique to its corresponding AnimationType for attack movement physics.
+ * This provides a type-safe, comprehensive mapping that replaces string-based
+ * substring matching.
+ *
+ * @module data/techniqueMappings
+ * @category Combat System
+ * @korean 기술매핑
+ */
+import { TechniqueId } from "../types/techniqueId";
+import { AnimationType } from "../systems/animation/builders/MartialArtsConstants";
+import { AttackAnimationType } from "../types/skeletal";
+/**
+ * Maps AttackAnimationType (from technique definitions) to AnimationType (for movement physics)
+ *
+ * AttackAnimationType is the skeletal animation type (PUNCH_HIGH, KICK_FRONT, etc.)
+ * AnimationType is the martial arts movement type for physics calculations
+ *
+ * @korean 공격애니메이션타입-애니메이션타입매핑
+ */
+export declare const ATTACK_ANIMATION_TO_MOVEMENT_TYPE: Record<AttackAnimationType, AnimationType>;
+/**
+ * Maps TechniqueId to AnimationType for movement physics
+ *
+ * This is the primary lookup table used by CombatScreen3D to determine
+ * the correct movement animation for each technique.
+ *
+ * Derived from technique definitions but cached here for performance.
+ *
+ * @korean 기술ID-애니메이션타입매핑
+ */
+export declare const TECHNIQUE_TO_ANIMATION_TYPE: Record<TechniqueId, AnimationType>;
+/**
+ * Get AnimationType for a given technique ID
+ *
+ * Looks up the AnimationType from the TECHNIQUE_TO_ANIMATION_TYPE mapping.
+ * Currently only supports archetype techniques (TechniqueId enum).
+ * Returns undefined for unknown techniques or trigram techniques.
+ *
+ * @param techniqueId - The technique ID
+ * @returns The AnimationType for movement physics, or undefined if not found
+ * @korean 기술ID로애니메이션타입가져오기
+ */
+export declare function getAnimationTypeForTechnique(techniqueId: string | undefined): AnimationType | undefined;
+/**
+ * Get AnimationType from AttackAnimationType
+ *
+ * @param attackAnimationType - The attack animation type from technique definition
+ * @returns The AnimationType for movement physics
+ * @korean 공격애니메이션타입에서애니메이션타입가져오기
+ */
+export declare function getAnimationTypeFromAttackAnimation(attackAnimationType: AttackAnimationType): AnimationType;
+declare const _default: {
+    TECHNIQUE_TO_ANIMATION_TYPE: Record<TechniqueId, AnimationType>;
+    ATTACK_ANIMATION_TO_MOVEMENT_TYPE: Record<AttackAnimationType, AnimationType>;
+    getAnimationTypeForTechnique: typeof getAnimationTypeForTechnique;
+    getAnimationTypeFromAttackAnimation: typeof getAnimationTypeFromAttackAnimation;
+};
+export default _default;
+//# sourceMappingURL=techniqueMappings.d.ts.map

package/lib/data/techniqueMappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniqueMappings.d.ts","sourceRoot":"","sources":["../../src/data/techniqueMappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CACpD,mBAAmB,EACnB,aAAa,CAuBd,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,CA+B1E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,aAAa,GAAG,SAAS,CAQ3B;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,mBAAmB,EAAE,mBAAmB,GACvC,aAAa,CAEf;;;;;;;AAED,wBAKE"}