blacktrigram 0.7.44 → 0.7.45

package/lib/types/physics.js

@@ -10,7 +10,6 @@
 *
 * @param baseExtension - The base extension multiplier to validate.
 * @returns `true` if the value is within the inclusive range [0.0, 1.5], otherwise `false`.
-* @public
 * @category Combat Types
 * @korean 기본확장배수검증
 */
@@ -28,7 +27,6 @@ function isValidBaseExtension(baseExtension) {
 *
 * @param config - The PhysicalReachConfig instance to validate.
 * @throws RangeError If baseExtension is outside [0.0, 1.5].
-* @public
 * @category Combat Types
 * @korean 물리적도달설정검증
 */
@@ -40,7 +38,6 @@ function assertValidPhysicalReachConfig(config) {
 *
 * **Korean**: 기본 범위 값
 *
-* @public
 * @category Combat Constants
 * @korean 기본범위값
 */
@@ -61,7 +58,6 @@ var BASE_REACH = {
 * - Defensive stances (Mountain) reduce reach
 * - Balanced stances (Heaven, Earth) have minor adjustments
 *
-* @public
 * @category Combat Constants
 * @korean 팔괘범위수정자
 */
@@ -80,7 +76,6 @@ var STANCE_REACH_MODIFIERS = {
 *
 * **Korean**: 충돌 감지 용어
 *
-* @public
 * @category Korean Terms
 * @korean 충돌용어
 */
@@ -100,7 +95,6 @@ var COLLISION_KOREAN_TERMS = {
 *
 * Standard dimensions for adult human anatomical regions used for bounding box creation.
 *
-* @public
 * @category Collision Constants
 * @korean 해부영역치수
 */

package/lib/types/physics.js.map

@@ -1 +1 @@
-{"version":3,"file":"physics.js","names":[],"sources":["../../src/types/physics.ts"],"sourcesContent":["/**\n * Physics and collision detection type definitions for Black Trigram combat system.\n *\n * **Korean**: 물리 및 충돌 타입 정의\n *\n * This module provides type definitions for the collision detection system, including\n * bounding boxes, attack reach calculations, and raycasting results.\n *\n * @module types/physics\n * @category Type Definitions\n * @korean 물리타입\n */\n\nimport type {\n  Position,\n  TrigramStance,\n  VitalPointCategory,\n  VitalPointSeverity,\n} from \"./common\";\n\n/**\n * Anatomical regions for collision detection.\n *\n * **Korean**: 해부학적 영역\n *\n * The five main body regions used for bounding box collision detection.\n * Each region contains multiple vital points.\n *\n * @public\n * @category Collision Types\n * @korean 해부영역\n */\nexport type AnatomicalRegionPhysics =\n  | \"head\" // 머리 (Meori)\n  | \"neck\" // 목 (Mok)\n  | \"torso\" // 몸통 (Momtong)\n  | \"arms\" // 팔 (Pal)\n  | \"legs\"; // 다리 (Dari)\n\n/**\n * Bounding box shape types for collision detection.\n *\n * **Korean**: 경계 상자 형태\n *\n * @public\n * @category Collision Types\n * @korean 경계형태\n */\nexport type BoundingBoxType = \"sphere\" | \"box\" | \"capsule\";\n\n/**\n * Body part source for reach calculation.\n *\n * **Korean**: 신체 부위\n *\n * Defines which body part's length is used for reach calculation.\n *\n * @public\n * @category Combat Types\n * @korean 신체부위\n */\nexport type ReachBodyPart = \"arm\" | \"leg\" | \"torso\";\n\n/**\n * Specific limb types for exposure tracking.\n *\n * **Korean**: 노출된 사지 부위\n *\n * Granular limb identification for counter-attack and breaking techniques.\n * Each limb can be targeted during its extension phase.\n *\n * @public\n * @category Combat Types\n * @korean 사지부위\n */\nexport type ExposedLimbType =\n  | \"left_arm\" // 왼팔 (Oenpal)\n  | \"right_arm\" // 오른팔 (Oreunpal)\n  | \"left_leg\" // 왼다리 (Oendari)\n  | \"right_leg\" // 오른다리 (Oreundari)\n  | \"left_ankle\" // 왼발목 (Oenbalmok)\n  | \"right_ankle\" // 오른발목 (Oreunbalmok)\n  | \"left_knee\" // 왼무릎 (Oenmureup)\n  | \"right_knee\" // 오른무릎 (Oreunmureup)\n  | \"left_elbow\" // 왼팔꿈치 (Oenpalkkumchi)\n  | \"right_elbow\" // 오른팔꿈치 (Oreunpalkkumchi)\n  | \"left_wrist\" // 왼손목 (Oensomok)\n  | \"right_wrist\"; // 오른손목 (Oreunsomok)\n\n/**\n * Limb exposure window during technique execution.\n *\n * **Korean**: 사지 노출 시간\n *\n * Defines when and how a limb becomes vulnerable during attack execution.\n * Used for counter-attacks, breaking techniques, and defensive opportunities.\n *\n * @public\n * @category Combat Types\n * @korean 사지노출시간\n */\nexport interface LimbExposureWindow {\n  /**\n   * Which limb is exposed during the technique.\n   * @korean 노출된사지\n   */\n  readonly exposedLimb: ExposedLimbType;\n\n  /**\n   * Start time of exposure as fraction of execution time (0.0-1.0).\n   * Example: 0.3 means exposure starts at 30% into the animation.\n   * @korean 노출시작시간\n   */\n  readonly startTime: number;\n\n  /**\n   * Duration of exposure window in milliseconds.\n   * This is the vulnerable period where counter-attacks can target the limb.\n   * @korean 노출지속시간\n   */\n  readonly duration: number;\n\n  /**\n   * Vulnerability multiplier for damage to this limb (1.0-3.0).\n   * Higher values indicate greater vulnerability:\n   * - 1.0-1.3: Minor exposure (quick jabs)\n   * - 1.4-1.8: Moderate exposure (standard strikes)\n   * - 1.9-3.0: Critical exposure (overextended kicks, spinning techniques)\n   * @korean 취약성배수\n   */\n  readonly vulnerabilityMultiplier: number;\n\n  /**\n   * Whether this exposure allows breaking techniques.\n   * True for fully extended limbs (kicks, lunging punches).\n   * @korean 파쇄기술가능\n   */\n  readonly allowsBreaking: boolean;\n}\n\n/**\n * Physical reach configuration for techniques.\n *\n * **Korean**: 물리적 도달 설정\n *\n * Defines how a technique's reach is calculated using physical attributes\n * rather than a fixed distance value. The actual reach depends on:\n * - Body part length from archetype physical attributes\n * - Animation extension multiplier from hit timing\n * - Stance modifiers from Eight Trigrams\n *\n * **NEW**: Now includes limb exposure tracking for counter-attack opportunities.\n *\n * Formula: `effectiveReach = (limbLength/100) × extensionMultiplier × stanceModifier`\n *\n * @example\n * ```typescript\n * // Punch technique using arm length with exposure\n * const punchReach: PhysicalReachConfig = {\n *   bodyPart: \"arm\",\n *   techniqueType: \"punch\",\n *   baseExtension: 0.95, // 95% arm extension at peak\n *   exposureWindow: {\n *     exposedLimb: \"right_arm\",\n *     startTime: 0.4,\n *     duration: 300,\n *     vulnerabilityMultiplier: 1.3,\n *     allowsBreaking: false\n *   }\n * };\n *\n * // Kick using leg length - high vulnerability\n * const kickReach: PhysicalReachConfig = {\n *   bodyPart: \"leg\",\n *   techniqueType: \"kick\",\n *   baseExtension: 1.1, // 110% leg extension (high reach)\n *   exposureWindow: {\n *     exposedLimb: \"right_leg\",\n *     startTime: 0.5,\n *     duration: 400,\n *     vulnerabilityMultiplier: 2.2,\n *     allowsBreaking: true\n *   }\n * };\n * ```\n *\n * @public\n * @category Combat Types\n * @korean 물리적도달설정\n */\nexport interface PhysicalReachConfig {\n  /**\n   * Body part used for reach calculation.\n   * Determines which physical attribute length is used.\n   * @korean 신체부위\n   */\n  readonly bodyPart: ReachBodyPart;\n\n  /**\n   * Technique type for classification.\n   * @korean 기술유형\n   */\n  readonly techniqueType: TechniqueType;\n\n  /**\n   * Base extension multiplier (0.0 - 1.5).\n   * - 0.4-0.5: Close range (elbows, knees)\n   * - 0.9-1.0: Standard reach (punches)\n   * - 1.1-1.5: Extended reach (kicks, spinning techniques)\n   * @korean 기본확장배수\n   */\n  readonly baseExtension: number;\n\n  /**\n   * Optional limb exposure window for counter-attack opportunities.\n   * Defines when and how the attacking limb becomes vulnerable.\n   * @korean 사지노출설정\n   */\n  readonly exposureWindow?: LimbExposureWindow;\n}\n\n/**\n * Runtime validation helper for base extension multiplier.\n *\n * Ensures that the provided baseExtension value respects the documented range\n * of 0.0 to 1.5. This should be used when loading or constructing technique\n * configurations from dynamic sources (e.g. JSON, network, editors).\n *\n * **Korean**: 기본 확장 배수 검증\n *\n * @param baseExtension - The base extension multiplier to validate.\n * @returns `true` if the value is within the inclusive range [0.0, 1.5], otherwise `false`.\n * @public\n * @category Combat Types\n * @korean 기본확장배수검증\n */\nexport function isValidBaseExtension(baseExtension: number): boolean {\n  return baseExtension >= 0.0 && baseExtension <= 1.5;\n}\n\n/**\n * Asserts that a PhysicalReachConfig has a valid baseExtension value.\n *\n * Throws a RangeError if the configuration's baseExtension is outside the\n * allowed range of 0.0 to 1.5. This provides a canonical runtime check that\n * can be used by reach calculators or technique loaders.\n *\n * **Korean**: 물리적 도달 설정 검증\n *\n * @param config - The PhysicalReachConfig instance to validate.\n * @throws RangeError If baseExtension is outside [0.0, 1.5].\n * @public\n * @category Combat Types\n * @korean 물리적도달설정검증\n */\nexport function assertValidPhysicalReachConfig(\n  config: PhysicalReachConfig\n): void {\n  if (!isValidBaseExtension(config.baseExtension)) {\n    throw new RangeError(\n      `Invalid baseExtension ${config.baseExtension}. ` +\n        \"Expected a value between 0.0 and 1.5 inclusive.\"\n    );\n  }\n}\n\n/**\n * Technique types for attack reach calculation.\n *\n * **Korean**: 기술 유형\n *\n * @public\n * @category Combat Types\n * @korean 기술유형\n */\nexport type TechniqueType =\n  | \"punch\" // 주먹 (Jumeok)\n  | \"kick\" // 발차기 (Balchagi)\n  | \"elbow\" // 팔꿈치 (Palkkumchi)\n  | \"knee\" // 무릎 (Mureup)\n  | \"pressure_point\"; // 급소 (Geupso)\n\n/**\n * Bounding box definition for an anatomical region.\n *\n * **Korean**: 경계 상자\n *\n * Defines the collision volume for an anatomical region using either a sphere,\n * box, or capsule shape. Used for broad-phase collision detection.\n *\n * @example\n * ```typescript\n * const headBox: BoundingBox = {\n *   type: \"sphere\",\n *   center: { x: 0, y: 1.7, z: 0 },\n *   dimensions: { x: 0.125, y: 0, z: 0 }, // radius only\n *   region: \"head\"\n * };\n * ```\n *\n * @public\n * @category Collision Types\n * @korean 경계상자\n */\nexport interface BoundingBox {\n  /** Shape type of the bounding box */\n  readonly type: BoundingBoxType;\n\n  /** Center position of the bounding box in 3D space */\n  readonly center: Position3D;\n\n  /** Dimensions: radius for sphere, width/height/depth for box, radius/height for capsule */\n  readonly dimensions: Position3D;\n\n  /** Anatomical region this bounding box represents */\n  readonly region: AnatomicalRegionPhysics;\n}\n\n/**\n * Position in 3D space.\n *\n * **Korean**: 3D 위치\n *\n * Extends the 2D Position type with a z-coordinate for Three.js integration.\n *\n * @public\n * @category Core Types\n * @korean 3D위치\n */\nexport interface Position3D {\n  /** X coordinate in meters */\n  readonly x: number;\n\n  /** Y coordinate in meters */\n  readonly y: number;\n\n  /** Z coordinate in meters */\n  readonly z: number;\n}\n\n/**\n * Attack reach calculation result.\n *\n * **Korean**: 공격 범위\n *\n * Contains the effective attack range considering technique type and stance modifiers.\n *\n * @example\n * ```typescript\n * const kickReach: AttackReach = {\n *   technique: \"kick\",\n *   baseReach: 1.0,\n *   stance: TrigramStance.LI,\n *   stanceModifier: 1.20,\n *   effectiveReach: 1.2\n * };\n * ```\n *\n * @public\n * @category Combat Types\n * @korean 공격범위\n */\nexport interface AttackReach {\n  /** Type of technique being used */\n  readonly technique: TechniqueType;\n\n  /** Base reach in meters without modifiers */\n  readonly baseReach: number;\n\n  /** Current trigram stance */\n  readonly stance: TrigramStance;\n\n  /** Stance-specific reach modifier (0.9 - 1.2) */\n  readonly stanceModifier: number;\n\n  /** Final effective reach: baseReach × stanceModifier */\n  readonly effectiveReach: number;\n}\n\n/**\n * Collision detection result.\n *\n * **Korean**: 충돌 결과\n *\n * Contains comprehensive information about a collision, including whether it hit,\n * which region and vital point were struck, distance, and accuracy.\n *\n * @example\n * ```typescript\n * const result: CollisionResult = {\n *   hit: true,\n *   region: \"head\",\n *   vitalPoint: templePoint,\n *   distance: 0.8,\n *   accuracy: 0.95\n * };\n * ```\n *\n * @public\n * @category Collision Types\n * @korean 충돌결과\n */\nexport interface CollisionResult {\n  /** Whether the attack hit */\n  readonly hit: boolean;\n\n  /** Anatomical region hit (if any) */\n  readonly region?: AnatomicalRegionPhysics;\n\n  /** Specific vital point hit (if any) */\n  readonly vitalPoint?: CollisionVitalPoint;\n\n  /** Actual distance from attacker to target in meters */\n  readonly distance: number;\n\n  /** Hit accuracy (0-1), based on targeting precision */\n  readonly accuracy: number;\n\n  /** 3D point of intersection (if hit) */\n  readonly hitPoint?: Position3D;\n}\n\n/**\n * Minimal vital point shape for collision results to avoid deep cross-module\n * dependencies. Full vital point data lives in the vitalpoint system.\n */\nexport interface CollisionVitalPoint {\n  readonly id: string;\n  readonly names: {\n    readonly korean: string;\n    readonly english: string;\n    readonly romanized: string;\n  };\n  readonly position: Position;\n  readonly category: VitalPointCategory;\n  readonly severity: VitalPointSeverity;\n}\n\n/**\n * Counter-attack opportunity during opponent's technique execution.\n *\n * **Korean**: 반격 기회\n *\n * Represents a window of opportunity to counter-attack when the opponent\n * has exposed a limb during their technique execution.\n *\n * @example\n * ```typescript\n * const counterOpportunity: CounterOpportunity = {\n *   exposedLimb: \"right_leg\",\n *   windowStart: 450, // ms into opponent's kick\n *   windowDuration: 300, // 300ms counter window\n *   vulnerabilityMultiplier: 2.0,\n *   allowsBreaking: true,\n *   recommendedCounters: [\"ankle_break\", \"knee_strike\", \"leg_sweep\"]\n * };\n * ```\n *\n * @public\n * @category Combat Types\n * @korean 반격기회\n */\nexport interface CounterOpportunity {\n  /**\n   * The exposed limb that can be targeted.\n   * @korean 노출된사지\n   */\n  readonly exposedLimb: ExposedLimbType;\n\n  /**\n   * Start time of counter window in milliseconds (from technique start).\n   * @korean 반격시작시간\n   */\n  readonly windowStart: number;\n\n  /**\n   * Duration of counter window in milliseconds.\n   * @korean 반격지속시간\n   */\n  readonly windowDuration: number;\n\n  /**\n   * Vulnerability multiplier for damage during this window.\n   * @korean 취약성배수\n   */\n  readonly vulnerabilityMultiplier: number;\n\n  /**\n   * Whether limb breaking techniques are effective during this window.\n   * @korean 파쇄기술가능\n   */\n  readonly allowsBreaking: boolean;\n\n  /**\n   * Recommended counter-technique IDs for this opportunity.\n   * @korean 추천반격기술\n   */\n  readonly recommendedCounters?: readonly string[];\n}\n\n/**\n * Breaking technique target types.\n *\n * **Korean**: 파쇄 기술 목표\n *\n * Specific joint and bone targets for breaking techniques.\n * Used for limb-breaking counter-attacks.\n *\n * @public\n * @category Combat Types\n * @korean 파쇄목표\n */\nexport type BreakingTarget =\n  | \"ankle\" // 발목 (Balmok)\n  | \"knee\" // 무릎 (Mureup)\n  | \"elbow\" // 팔꿈치 (Palkkumchi)\n  | \"wrist\" // 손목 (Sonmok)\n  | \"shoulder\" // 어깨 (Eokkae)\n  | \"hip\"; // 엉덩이/골반 (Eongdeongi)\n\n/**\n * Breaking technique result.\n *\n * **Korean**: 파쇄 결과\n *\n * Result of a breaking technique attempt, including injury severity\n * and status effects applied to the broken limb.\n *\n * @public\n * @category Combat Types\n * @korean 파쇄결과\n */\nexport interface BreakingResult {\n  /**\n   * Whether the breaking technique succeeded.\n   * @korean 파쇄성공\n   */\n  readonly success: boolean;\n\n  /**\n   * Target limb/joint that was broken.\n   * @korean 파쇄목표\n   */\n  readonly target: BreakingTarget;\n\n  /**\n   * Severity of the break (fracture, dislocation, etc.).\n   * Range: 0.0 (failed) to 1.0 (complete break).\n   * @korean 파쇄심각도\n   */\n  readonly severity: number;\n\n  /**\n   * Damage dealt to the limb.\n   * @korean 피해량\n   */\n  readonly damage: number;\n\n  /**\n   * Mobility reduction percentage (0.0-1.0).\n   * Affects movement speed and technique execution.\n   * @korean 이동력감소\n   */\n  readonly mobilityReduction: number;\n\n  /**\n   * IDs of status effects applied (pain, bleeding, disabled_limb, etc.).\n   * @korean 상태효과\n   */\n  readonly statusEffects: readonly string[];\n}\n\n/**\n * Raycast query parameters.\n *\n * **Korean**: 레이캐스트 쿼리\n *\n * Defines the parameters for a raycasting operation from attacker to target.\n *\n * @public\n * @category Collision Types\n * @korean 레이캐스트쿼리\n */\nexport interface RaycastQuery {\n  /** Origin point of the ray (attacker position) */\n  readonly origin: Position3D;\n\n  /** Direction vector of the ray (normalized) */\n  readonly direction: Position3D;\n\n  /** Maximum distance to check in meters */\n  readonly maxDistance: number;\n\n  /** Target anatomical region (optional, for filtering) */\n  readonly targetRegion?: AnatomicalRegionPhysics;\n}\n\n/**\n * Base reach values for different technique types.\n *\n * **Korean**: 기본 범위 값\n *\n * @public\n * @category Combat Constants\n * @korean 기본범위값\n */\nexport const BASE_REACH: Record<TechniqueType, number> = {\n  punch: 0.7, // 70cm - Standard punch range\n  kick: 1.0, // 100cm - Longer leg reach\n  elbow: 0.4, // 40cm - Close-range strike\n  knee: 0.4, // 40cm - Close-range strike\n  pressure_point: 0.5, // 50cm - Precise targeting\n};\n\n/**\n * Stance reach modifiers for the Eight Trigrams.\n *\n * **Korean**: 팔괘 범위 수정자\n *\n * Each stance affects attack range differently based on its combat philosophy:\n * - Aggressive stances (Fire, Thunder) extend reach\n * - Defensive stances (Mountain) reduce reach\n * - Balanced stances (Heaven, Earth) have minor adjustments\n *\n * @public\n * @category Combat Constants\n * @korean 팔괘범위수정자\n */\nexport const STANCE_REACH_MODIFIERS: Record<TrigramStance, number> = {\n  li: 1.2, // ☲ Fire (리): +20% reach (aggressive)\n  jin: 1.15, // ☳ Thunder (진): +15% reach (explosive)\n  geon: 1.1, // ☰ Heaven (건): +10% reach (balanced)\n  son: 1.05, // ☴ Wind (손): +5% reach (continuous)\n  tae: 1.0, // ☱ Lake (태): neutral reach\n  gam: 1.0, // ☵ Water (감): neutral reach (adaptive)\n  gon: 0.95, // ☷ Earth (곤): -5% reach (grounded)\n  gan: 0.9, // ☶ Mountain (간): -10% reach (defensive)\n};\n\n/**\n * Korean terminology for collision detection concepts.\n *\n * **Korean**: 충돌 감지 용어\n *\n * @public\n * @category Korean Terms\n * @korean 충돌용어\n */\nexport const COLLISION_KOREAN_TERMS = {\n  collisionDetection: \"충돌감지\", // Chungdol Gamji\n  attackRange: \"타격범위\", // Tagyeok Beomwi\n  preciseHit: \"정밀타격\", // Jeongmil Tagyeok\n  boundingBox: \"경계상자\", // Gyeonggye Sangja\n  raycast: \"광선투사\", // Gwangseon Tusa\n  hitAccuracy: \"타격정확도\", // Tagyeok Jeonghwakdo\n  effectiveReach: \"유효범위\", // Yuhyo Beomwi\n} as const;\n\n/**\n * Anatomical region dimensions in meters.\n *\n * **Korean**: 해부 영역 치수\n *\n * Standard dimensions for adult human anatomical regions used for bounding box creation.\n *\n * @public\n * @category Collision Constants\n * @korean 해부영역치수\n */\nexport const ANATOMICAL_DIMENSIONS = {\n  head: {\n    type: \"sphere\" as const,\n    radius: 0.125, // 머리 구 반경 (Meori sphere radius) – 12.5cm radius for head sphere\n    center: { x: 0, y: 1.7, z: 0 }, // 머리 중심 높이 (Meori center height) – Average adult head height\n  },\n  neck: {\n    type: \"capsule\" as const,\n    radius: 0.075, // 목 캡슐 반경 (Mok capsule radius) – 7.5cm radius for neck cylinder\n    height: 0.15, // 목 캡슐 높이 (Mok capsule height) – 15cm height\n    center: { x: 0, y: 1.5, z: 0 }, // 목 중심 높이 (Mok center height)\n  },\n  torso: {\n    type: \"box\" as const,\n    width: 0.4, // 몸통 상자 가로 (Momtong box width) – 40cm width (shoulder to shoulder)\n    height: 0.6, // 몸통 상자 세로 (Momtong box height) – 60cm height (neck to waist)\n    depth: 0.25, // 몸통 상자 깊이 (Momtong box depth) – 25cm depth (front to back)\n    center: { x: 0, y: 1.1, z: 0 }, // 몸통 중심 높이 (Momtong center height)\n  },\n  arms: {\n    type: \"capsule\" as const,\n    radius: 0.05, // 팔 캡슐 반경 (Pal capsule radius) – 5cm radius for arm cylinder\n    height: 0.6, // 팔 캡슐 길이 (Pal capsule length) – 60cm length (shoulder to hand)\n    center: { x: 0.3, y: 1.1, z: 0 }, // 팔 위치 오프셋 (Pal position offset) – Offset for arm position\n  },\n  legs: {\n    type: \"capsule\" as const,\n    radius: 0.06, // 다리 캡슐 반경 (Dari capsule radius) – 6cm radius for leg cylinder\n    height: 0.8, // 다리 캡슐 길이 (Dari capsule length) – 80cm length (hip to foot)\n    center: { x: 0.15, y: 0.4, z: 0 }, // 다리 위치 오프셋 (Dari position offset) – Offset for leg position\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;AA4OA,SAAgB,qBAAqB,eAAgC;CACnE,OAAO,iBAAiB,KAAO,iBAAiB;;;;;;;;;;;;;;;;;AAkBlD,SAAgB,+BACd,QACM;CACN,IAAI,CAAC,qBAAqB,OAAO,cAAc,EAC7C,MAAM,IAAI,WACR,yBAAyB,OAAO,cAAc,mDAE/C;;;;;;;;;;;AAwVL,IAAa,aAA4C;CACvD,OAAO;CACP,MAAM;CACN,OAAO;CACP,MAAM;CACN,gBAAgB;CACjB;;;;;;;;;;;;;;;AAgBD,IAAa,yBAAwD;CACnE,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;;;;;;;;;;AAWD,IAAa,yBAAyB;CACpC,oBAAoB;CACpB,aAAa;CACb,YAAY;CACZ,aAAa;CACb,SAAS;CACT,aAAa;CACb,gBAAgB;CACjB;;;;;;;;;;;;AAaD,IAAa,wBAAwB;CACnC,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,OAAO;EACL,MAAM;EACN,OAAO;EACP,QAAQ;EACR,OAAO;EACP,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAK,GAAG;GAAK,GAAG;GAAG;EACjC;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAM,GAAG;GAAK,GAAG;GAAG;EAClC;CACF"}
+{"version":3,"file":"physics.js","names":[],"sources":["../../src/types/physics.ts"],"sourcesContent":["/**\n * Physics and collision detection type definitions for Black Trigram combat system.\n *\n * **Korean**: 물리 및 충돌 타입 정의\n *\n * This module provides type definitions for the collision detection system, including\n * bounding boxes, attack reach calculations, and raycasting results.\n *\n * @module types/physics\n * @category Type Definitions\n * @korean 물리타입\n */\n\nimport type {\n  Position,\n  TrigramStance,\n  VitalPointCategory,\n  VitalPointSeverity,\n} from \"./common\";\n\n/**\n * Anatomical regions for collision detection.\n *\n * **Korean**: 해부학적 영역\n *\n * The five main body regions used for bounding box collision detection.\n * Each region contains multiple vital points.\n *\n * @category Collision Types\n * @korean 해부영역\n */\nexport type AnatomicalRegionPhysics =\n  | \"head\" // 머리 (Meori)\n  | \"neck\" // 목 (Mok)\n  | \"torso\" // 몸통 (Momtong)\n  | \"arms\" // 팔 (Pal)\n  | \"legs\"; // 다리 (Dari)\n\n/**\n * Bounding box shape types for collision detection.\n *\n * **Korean**: 경계 상자 형태\n *\n * @category Collision Types\n * @korean 경계형태\n */\nexport type BoundingBoxType = \"sphere\" | \"box\" | \"capsule\";\n\n/**\n * Body part source for reach calculation.\n *\n * **Korean**: 신체 부위\n *\n * Defines which body part's length is used for reach calculation.\n *\n * @category Combat Types\n * @korean 신체부위\n */\nexport type ReachBodyPart = \"arm\" | \"leg\" | \"torso\";\n\n/**\n * Specific limb types for exposure tracking.\n *\n * **Korean**: 노출된 사지 부위\n *\n * Granular limb identification for counter-attack and breaking techniques.\n * Each limb can be targeted during its extension phase.\n *\n * @category Combat Types\n * @korean 사지부위\n */\nexport type ExposedLimbType =\n  | \"left_arm\" // 왼팔 (Oenpal)\n  | \"right_arm\" // 오른팔 (Oreunpal)\n  | \"left_leg\" // 왼다리 (Oendari)\n  | \"right_leg\" // 오른다리 (Oreundari)\n  | \"left_ankle\" // 왼발목 (Oenbalmok)\n  | \"right_ankle\" // 오른발목 (Oreunbalmok)\n  | \"left_knee\" // 왼무릎 (Oenmureup)\n  | \"right_knee\" // 오른무릎 (Oreunmureup)\n  | \"left_elbow\" // 왼팔꿈치 (Oenpalkkumchi)\n  | \"right_elbow\" // 오른팔꿈치 (Oreunpalkkumchi)\n  | \"left_wrist\" // 왼손목 (Oensomok)\n  | \"right_wrist\"; // 오른손목 (Oreunsomok)\n\n/**\n * Limb exposure window during technique execution.\n *\n * **Korean**: 사지 노출 시간\n *\n * Defines when and how a limb becomes vulnerable during attack execution.\n * Used for counter-attacks, breaking techniques, and defensive opportunities.\n *\n * @category Combat Types\n * @korean 사지노출시간\n */\nexport interface LimbExposureWindow {\n  /**\n   * Which limb is exposed during the technique.\n   * @korean 노출된사지\n   */\n  readonly exposedLimb: ExposedLimbType;\n\n  /**\n   * Start time of exposure as fraction of execution time (0.0-1.0).\n   * Example: 0.3 means exposure starts at 30% into the animation.\n   * @korean 노출시작시간\n   */\n  readonly startTime: number;\n\n  /**\n   * Duration of exposure window in milliseconds.\n   * This is the vulnerable period where counter-attacks can target the limb.\n   * @korean 노출지속시간\n   */\n  readonly duration: number;\n\n  /**\n   * Vulnerability multiplier for damage to this limb (1.0-3.0).\n   * Higher values indicate greater vulnerability:\n   * - 1.0-1.3: Minor exposure (quick jabs)\n   * - 1.4-1.8: Moderate exposure (standard strikes)\n   * - 1.9-3.0: Critical exposure (overextended kicks, spinning techniques)\n   * @korean 취약성배수\n   */\n  readonly vulnerabilityMultiplier: number;\n\n  /**\n   * Whether this exposure allows breaking techniques.\n   * True for fully extended limbs (kicks, lunging punches).\n   * @korean 파쇄기술가능\n   */\n  readonly allowsBreaking: boolean;\n}\n\n/**\n * Physical reach configuration for techniques.\n *\n * **Korean**: 물리적 도달 설정\n *\n * Defines how a technique's reach is calculated using physical attributes\n * rather than a fixed distance value. The actual reach depends on:\n * - Body part length from archetype physical attributes\n * - Animation extension multiplier from hit timing\n * - Stance modifiers from Eight Trigrams\n *\n * **NEW**: Now includes limb exposure tracking for counter-attack opportunities.\n *\n * Formula: `effectiveReach = (limbLength/100) × extensionMultiplier × stanceModifier`\n *\n * @example\n * ```typescript\n * // Punch technique using arm length with exposure\n * const punchReach: PhysicalReachConfig = {\n *   bodyPart: \"arm\",\n *   techniqueType: \"punch\",\n *   baseExtension: 0.95, // 95% arm extension at peak\n *   exposureWindow: {\n *     exposedLimb: \"right_arm\",\n *     startTime: 0.4,\n *     duration: 300,\n *     vulnerabilityMultiplier: 1.3,\n *     allowsBreaking: false\n *   }\n * };\n *\n * // Kick using leg length - high vulnerability\n * const kickReach: PhysicalReachConfig = {\n *   bodyPart: \"leg\",\n *   techniqueType: \"kick\",\n *   baseExtension: 1.1, // 110% leg extension (high reach)\n *   exposureWindow: {\n *     exposedLimb: \"right_leg\",\n *     startTime: 0.5,\n *     duration: 400,\n *     vulnerabilityMultiplier: 2.2,\n *     allowsBreaking: true\n *   }\n * };\n * ```\n *\n * @category Combat Types\n * @korean 물리적도달설정\n */\nexport interface PhysicalReachConfig {\n  /**\n   * Body part used for reach calculation.\n   * Determines which physical attribute length is used.\n   * @korean 신체부위\n   */\n  readonly bodyPart: ReachBodyPart;\n\n  /**\n   * Technique type for classification.\n   * @korean 기술유형\n   */\n  readonly techniqueType: TechniqueType;\n\n  /**\n   * Base extension multiplier (0.0 - 1.5).\n   * - 0.4-0.5: Close range (elbows, knees)\n   * - 0.9-1.0: Standard reach (punches)\n   * - 1.1-1.5: Extended reach (kicks, spinning techniques)\n   * @korean 기본확장배수\n   */\n  readonly baseExtension: number;\n\n  /**\n   * Optional limb exposure window for counter-attack opportunities.\n   * Defines when and how the attacking limb becomes vulnerable.\n   * @korean 사지노출설정\n   */\n  readonly exposureWindow?: LimbExposureWindow;\n}\n\n/**\n * Runtime validation helper for base extension multiplier.\n *\n * Ensures that the provided baseExtension value respects the documented range\n * of 0.0 to 1.5. This should be used when loading or constructing technique\n * configurations from dynamic sources (e.g. JSON, network, editors).\n *\n * **Korean**: 기본 확장 배수 검증\n *\n * @param baseExtension - The base extension multiplier to validate.\n * @returns `true` if the value is within the inclusive range [0.0, 1.5], otherwise `false`.\n * @category Combat Types\n * @korean 기본확장배수검증\n */\nexport function isValidBaseExtension(baseExtension: number): boolean {\n  return baseExtension >= 0.0 && baseExtension <= 1.5;\n}\n\n/**\n * Asserts that a PhysicalReachConfig has a valid baseExtension value.\n *\n * Throws a RangeError if the configuration's baseExtension is outside the\n * allowed range of 0.0 to 1.5. This provides a canonical runtime check that\n * can be used by reach calculators or technique loaders.\n *\n * **Korean**: 물리적 도달 설정 검증\n *\n * @param config - The PhysicalReachConfig instance to validate.\n * @throws RangeError If baseExtension is outside [0.0, 1.5].\n * @category Combat Types\n * @korean 물리적도달설정검증\n */\nexport function assertValidPhysicalReachConfig(\n  config: PhysicalReachConfig\n): void {\n  if (!isValidBaseExtension(config.baseExtension)) {\n    throw new RangeError(\n      `Invalid baseExtension ${config.baseExtension}. ` +\n        \"Expected a value between 0.0 and 1.5 inclusive.\"\n    );\n  }\n}\n\n/**\n * Technique types for attack reach calculation.\n *\n * **Korean**: 기술 유형\n *\n * @category Combat Types\n * @korean 기술유형\n */\nexport type TechniqueType =\n  | \"punch\" // 주먹 (Jumeok)\n  | \"kick\" // 발차기 (Balchagi)\n  | \"elbow\" // 팔꿈치 (Palkkumchi)\n  | \"knee\" // 무릎 (Mureup)\n  | \"pressure_point\"; // 급소 (Geupso)\n\n/**\n * Bounding box definition for an anatomical region.\n *\n * **Korean**: 경계 상자\n *\n * Defines the collision volume for an anatomical region using either a sphere,\n * box, or capsule shape. Used for broad-phase collision detection.\n *\n * @example\n * ```typescript\n * const headBox: BoundingBox = {\n *   type: \"sphere\",\n *   center: { x: 0, y: 1.7, z: 0 },\n *   dimensions: { x: 0.125, y: 0, z: 0 }, // radius only\n *   region: \"head\"\n * };\n * ```\n *\n * @category Collision Types\n * @korean 경계상자\n */\nexport interface BoundingBox {\n  /** Shape type of the bounding box */\n  readonly type: BoundingBoxType;\n\n  /** Center position of the bounding box in 3D space */\n  readonly center: Position3D;\n\n  /** Dimensions: radius for sphere, width/height/depth for box, radius/height for capsule */\n  readonly dimensions: Position3D;\n\n  /** Anatomical region this bounding box represents */\n  readonly region: AnatomicalRegionPhysics;\n}\n\n/**\n * Position in 3D space.\n *\n * **Korean**: 3D 위치\n *\n * Extends the 2D Position type with a z-coordinate for Three.js integration.\n *\n * @category Core Types\n * @korean 3D위치\n */\nexport interface Position3D {\n  /** X coordinate in meters */\n  readonly x: number;\n\n  /** Y coordinate in meters */\n  readonly y: number;\n\n  /** Z coordinate in meters */\n  readonly z: number;\n}\n\n/**\n * Attack reach calculation result.\n *\n * **Korean**: 공격 범위\n *\n * Contains the effective attack range considering technique type and stance modifiers.\n *\n * @example\n * ```typescript\n * const kickReach: AttackReach = {\n *   technique: \"kick\",\n *   baseReach: 1.0,\n *   stance: TrigramStance.LI,\n *   stanceModifier: 1.20,\n *   effectiveReach: 1.2\n * };\n * ```\n *\n * @category Combat Types\n * @korean 공격범위\n */\nexport interface AttackReach {\n  /** Type of technique being used */\n  readonly technique: TechniqueType;\n\n  /** Base reach in meters without modifiers */\n  readonly baseReach: number;\n\n  /** Current trigram stance */\n  readonly stance: TrigramStance;\n\n  /** Stance-specific reach modifier (0.9 - 1.2) */\n  readonly stanceModifier: number;\n\n  /** Final effective reach: baseReach × stanceModifier */\n  readonly effectiveReach: number;\n}\n\n/**\n * Collision detection result.\n *\n * **Korean**: 충돌 결과\n *\n * Contains comprehensive information about a collision, including whether it hit,\n * which region and vital point were struck, distance, and accuracy.\n *\n * @example\n * ```typescript\n * const result: CollisionResult = {\n *   hit: true,\n *   region: \"head\",\n *   vitalPoint: templePoint,\n *   distance: 0.8,\n *   accuracy: 0.95\n * };\n * ```\n *\n * @category Collision Types\n * @korean 충돌결과\n */\nexport interface CollisionResult {\n  /** Whether the attack hit */\n  readonly hit: boolean;\n\n  /** Anatomical region hit (if any) */\n  readonly region?: AnatomicalRegionPhysics;\n\n  /** Specific vital point hit (if any) */\n  readonly vitalPoint?: CollisionVitalPoint;\n\n  /** Actual distance from attacker to target in meters */\n  readonly distance: number;\n\n  /** Hit accuracy (0-1), based on targeting precision */\n  readonly accuracy: number;\n\n  /** 3D point of intersection (if hit) */\n  readonly hitPoint?: Position3D;\n}\n\n/**\n * Minimal vital point shape for collision results to avoid deep cross-module\n * dependencies. Full vital point data lives in the vitalpoint system.\n */\nexport interface CollisionVitalPoint {\n  readonly id: string;\n  readonly names: {\n    readonly korean: string;\n    readonly english: string;\n    readonly romanized: string;\n  };\n  readonly position: Position;\n  readonly category: VitalPointCategory;\n  readonly severity: VitalPointSeverity;\n}\n\n/**\n * Counter-attack opportunity during opponent's technique execution.\n *\n * **Korean**: 반격 기회\n *\n * Represents a window of opportunity to counter-attack when the opponent\n * has exposed a limb during their technique execution.\n *\n * @example\n * ```typescript\n * const counterOpportunity: CounterOpportunity = {\n *   exposedLimb: \"right_leg\",\n *   windowStart: 450, // ms into opponent's kick\n *   windowDuration: 300, // 300ms counter window\n *   vulnerabilityMultiplier: 2.0,\n *   allowsBreaking: true,\n *   recommendedCounters: [\"ankle_break\", \"knee_strike\", \"leg_sweep\"]\n * };\n * ```\n *\n * @category Combat Types\n * @korean 반격기회\n */\nexport interface CounterOpportunity {\n  /**\n   * The exposed limb that can be targeted.\n   * @korean 노출된사지\n   */\n  readonly exposedLimb: ExposedLimbType;\n\n  /**\n   * Start time of counter window in milliseconds (from technique start).\n   * @korean 반격시작시간\n   */\n  readonly windowStart: number;\n\n  /**\n   * Duration of counter window in milliseconds.\n   * @korean 반격지속시간\n   */\n  readonly windowDuration: number;\n\n  /**\n   * Vulnerability multiplier for damage during this window.\n   * @korean 취약성배수\n   */\n  readonly vulnerabilityMultiplier: number;\n\n  /**\n   * Whether limb breaking techniques are effective during this window.\n   * @korean 파쇄기술가능\n   */\n  readonly allowsBreaking: boolean;\n\n  /**\n   * Recommended counter-technique IDs for this opportunity.\n   * @korean 추천반격기술\n   */\n  readonly recommendedCounters?: readonly string[];\n}\n\n/**\n * Breaking technique target types.\n *\n * **Korean**: 파쇄 기술 목표\n *\n * Specific joint and bone targets for breaking techniques.\n * Used for limb-breaking counter-attacks.\n *\n * @category Combat Types\n * @korean 파쇄목표\n */\nexport type BreakingTarget =\n  | \"ankle\" // 발목 (Balmok)\n  | \"knee\" // 무릎 (Mureup)\n  | \"elbow\" // 팔꿈치 (Palkkumchi)\n  | \"wrist\" // 손목 (Sonmok)\n  | \"shoulder\" // 어깨 (Eokkae)\n  | \"hip\"; // 엉덩이/골반 (Eongdeongi)\n\n/**\n * Breaking technique result.\n *\n * **Korean**: 파쇄 결과\n *\n * Result of a breaking technique attempt, including injury severity\n * and status effects applied to the broken limb.\n *\n * @category Combat Types\n * @korean 파쇄결과\n */\nexport interface BreakingResult {\n  /**\n   * Whether the breaking technique succeeded.\n   * @korean 파쇄성공\n   */\n  readonly success: boolean;\n\n  /**\n   * Target limb/joint that was broken.\n   * @korean 파쇄목표\n   */\n  readonly target: BreakingTarget;\n\n  /**\n   * Severity of the break (fracture, dislocation, etc.).\n   * Range: 0.0 (failed) to 1.0 (complete break).\n   * @korean 파쇄심각도\n   */\n  readonly severity: number;\n\n  /**\n   * Damage dealt to the limb.\n   * @korean 피해량\n   */\n  readonly damage: number;\n\n  /**\n   * Mobility reduction percentage (0.0-1.0).\n   * Affects movement speed and technique execution.\n   * @korean 이동력감소\n   */\n  readonly mobilityReduction: number;\n\n  /**\n   * IDs of status effects applied (pain, bleeding, disabled_limb, etc.).\n   * @korean 상태효과\n   */\n  readonly statusEffects: readonly string[];\n}\n\n/**\n * Raycast query parameters.\n *\n * **Korean**: 레이캐스트 쿼리\n *\n * Defines the parameters for a raycasting operation from attacker to target.\n *\n * @category Collision Types\n * @korean 레이캐스트쿼리\n */\nexport interface RaycastQuery {\n  /** Origin point of the ray (attacker position) */\n  readonly origin: Position3D;\n\n  /** Direction vector of the ray (normalized) */\n  readonly direction: Position3D;\n\n  /** Maximum distance to check in meters */\n  readonly maxDistance: number;\n\n  /** Target anatomical region (optional, for filtering) */\n  readonly targetRegion?: AnatomicalRegionPhysics;\n}\n\n/**\n * Base reach values for different technique types.\n *\n * **Korean**: 기본 범위 값\n *\n * @category Combat Constants\n * @korean 기본범위값\n */\nexport const BASE_REACH: Record<TechniqueType, number> = {\n  punch: 0.7, // 70cm - Standard punch range\n  kick: 1.0, // 100cm - Longer leg reach\n  elbow: 0.4, // 40cm - Close-range strike\n  knee: 0.4, // 40cm - Close-range strike\n  pressure_point: 0.5, // 50cm - Precise targeting\n};\n\n/**\n * Stance reach modifiers for the Eight Trigrams.\n *\n * **Korean**: 팔괘 범위 수정자\n *\n * Each stance affects attack range differently based on its combat philosophy:\n * - Aggressive stances (Fire, Thunder) extend reach\n * - Defensive stances (Mountain) reduce reach\n * - Balanced stances (Heaven, Earth) have minor adjustments\n *\n * @category Combat Constants\n * @korean 팔괘범위수정자\n */\nexport const STANCE_REACH_MODIFIERS: Record<TrigramStance, number> = {\n  li: 1.2, // ☲ Fire (리): +20% reach (aggressive)\n  jin: 1.15, // ☳ Thunder (진): +15% reach (explosive)\n  geon: 1.1, // ☰ Heaven (건): +10% reach (balanced)\n  son: 1.05, // ☴ Wind (손): +5% reach (continuous)\n  tae: 1.0, // ☱ Lake (태): neutral reach\n  gam: 1.0, // ☵ Water (감): neutral reach (adaptive)\n  gon: 0.95, // ☷ Earth (곤): -5% reach (grounded)\n  gan: 0.9, // ☶ Mountain (간): -10% reach (defensive)\n};\n\n/**\n * Korean terminology for collision detection concepts.\n *\n * **Korean**: 충돌 감지 용어\n *\n * @category Korean Terms\n * @korean 충돌용어\n */\nexport const COLLISION_KOREAN_TERMS = {\n  collisionDetection: \"충돌감지\", // Chungdol Gamji\n  attackRange: \"타격범위\", // Tagyeok Beomwi\n  preciseHit: \"정밀타격\", // Jeongmil Tagyeok\n  boundingBox: \"경계상자\", // Gyeonggye Sangja\n  raycast: \"광선투사\", // Gwangseon Tusa\n  hitAccuracy: \"타격정확도\", // Tagyeok Jeonghwakdo\n  effectiveReach: \"유효범위\", // Yuhyo Beomwi\n} as const;\n\n/**\n * Anatomical region dimensions in meters.\n *\n * **Korean**: 해부 영역 치수\n *\n * Standard dimensions for adult human anatomical regions used for bounding box creation.\n *\n * @category Collision Constants\n * @korean 해부영역치수\n */\nexport const ANATOMICAL_DIMENSIONS = {\n  head: {\n    type: \"sphere\" as const,\n    radius: 0.125, // 머리 구 반경 (Meori sphere radius) – 12.5cm radius for head sphere\n    center: { x: 0, y: 1.7, z: 0 }, // 머리 중심 높이 (Meori center height) – Average adult head height\n  },\n  neck: {\n    type: \"capsule\" as const,\n    radius: 0.075, // 목 캡슐 반경 (Mok capsule radius) – 7.5cm radius for neck cylinder\n    height: 0.15, // 목 캡슐 높이 (Mok capsule height) – 15cm height\n    center: { x: 0, y: 1.5, z: 0 }, // 목 중심 높이 (Mok center height)\n  },\n  torso: {\n    type: \"box\" as const,\n    width: 0.4, // 몸통 상자 가로 (Momtong box width) – 40cm width (shoulder to shoulder)\n    height: 0.6, // 몸통 상자 세로 (Momtong box height) – 60cm height (neck to waist)\n    depth: 0.25, // 몸통 상자 깊이 (Momtong box depth) – 25cm depth (front to back)\n    center: { x: 0, y: 1.1, z: 0 }, // 몸통 중심 높이 (Momtong center height)\n  },\n  arms: {\n    type: \"capsule\" as const,\n    radius: 0.05, // 팔 캡슐 반경 (Pal capsule radius) – 5cm radius for arm cylinder\n    height: 0.6, // 팔 캡슐 길이 (Pal capsule length) – 60cm length (shoulder to hand)\n    center: { x: 0.3, y: 1.1, z: 0 }, // 팔 위치 오프셋 (Pal position offset) – Offset for arm position\n  },\n  legs: {\n    type: \"capsule\" as const,\n    radius: 0.06, // 다리 캡슐 반경 (Dari capsule radius) – 6cm radius for leg cylinder\n    height: 0.8, // 다리 캡슐 길이 (Dari capsule length) – 80cm length (hip to foot)\n    center: { x: 0.15, y: 0.4, z: 0 }, // 다리 위치 오프셋 (Dari position offset) – Offset for leg position\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;AAqOA,SAAgB,qBAAqB,eAAgC;CACnE,OAAO,iBAAiB,KAAO,iBAAiB;;;;;;;;;;;;;;;;AAiBlD,SAAgB,+BACd,QACM;CACN,IAAI,CAAC,qBAAqB,OAAO,cAAc,EAC7C,MAAM,IAAI,WACR,yBAAyB,OAAO,cAAc,mDAE/C;;;;;;;;;;AA8UL,IAAa,aAA4C;CACvD,OAAO;CACP,MAAM;CACN,OAAO;CACP,MAAM;CACN,gBAAgB;CACjB;;;;;;;;;;;;;;AAeD,IAAa,yBAAwD;CACnE,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;;;;;;;;;AAUD,IAAa,yBAAyB;CACpC,oBAAoB;CACpB,aAAa;CACb,YAAY;CACZ,aAAa;CACb,SAAS;CACT,aAAa;CACb,gBAAgB;CACjB;;;;;;;;;;;AAYD,IAAa,wBAAwB;CACnC,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,OAAO;EACL,MAAM;EACN,OAAO;EACP,QAAQ;EACR,OAAO;EACP,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAK,GAAG;GAAG;EAC/B;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAK,GAAG;GAAK,GAAG;GAAG;EACjC;CACD,MAAM;EACJ,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,QAAQ;GAAE,GAAG;GAAM,GAAG;GAAK,GAAG;GAAG;EAClC;CACF"}

package/lib/types/physicsConstants.d.ts

@@ -42,7 +42,6 @@
  * );
  * ```
  *
- * @public
  * @category Combat Constants
  * @korean 기본체력재생속도
  */
@@ -68,7 +67,6 @@ export declare const BASE_STAMINA_REGEN_RATE: 15;
  * const velocityChange = effectiveAcceleration * deltaTime;
  * ```
  *
- * @public
  * @category Physics Constants
  * @korean 기본이동가속도
  */
@@ -95,7 +93,6 @@ export declare const BASE_MOVEMENT_ACCELERATION: 30;
  * const scale = actualPixelsPerMeter / REFERENCE_PIXELS_PER_METER;
  * ```
  *
- * @public
  * @category Coordinate Constants
  * @korean 참조픽셀미터비율
  */
@@ -111,7 +108,6 @@ export declare const REFERENCE_PIXELS_PER_METER: 100;
  * `METERS_TO_PIXELS_SCALE` from `blacktrigram/types` and will be removed in a
  * future major release.
  *
- * @public
  * @category Coordinate Constants
  * @korean 미터-픽셀변환 (구형)
  */
@@ -134,7 +130,6 @@ export declare const METERS_TO_PIXELS_SCALE: 100;
  * const reachInUnits = reachInMeters * METERS_TO_TRAINING_UNITS;
  * ```
  *
- * @public
  * @category Coordinate Constants
  * @korean 미터훈련비율
  */
@@ -168,7 +163,6 @@ export declare const METERS_TO_TRAINING_UNITS: 1;
  * const effectiveDistance = centerToCenter - radius;
  * ```
  *
- * @public
  * @category Physics Constants
  * @korean 기본몸체반경
  */
@@ -183,7 +177,6 @@ export declare const DEFAULT_BODY_RADIUS_METERS: 0.23;
  * importing `BODY_RADIUS_METERS` from `blacktrigram/types` and will be removed
  * in a future major release.
  *
- * @public
  * @category Physics Constants
  * @korean 몸체반경별칭
  */
@@ -191,7 +184,6 @@ export declare const BODY_RADIUS_METERS: 0.23;
 /**
  * Standard arena sizes in meters (4:3 aspect ratio).
  *
- * @public
  */
 export declare const ARENA_SIZE_METERS: {
     /** Small screens (< 768px): 6m × 4.5m */
@@ -213,7 +205,6 @@ export declare const ARENA_SIZE_METERS: {
  * These values define combat distance thresholds for AI decision-making
  * and hit detection. Use these instead of pixel-based COMBAT_RANGES.
  *
- * @public
  */
 export declare const COMBAT_RANGES_METERS: {
     /** Melee range: very close, grappling distance (0.5m) */
@@ -232,7 +223,6 @@ export declare const COMBAT_RANGES_METERS: {
  *
  * **Korean**: AI이동상수미터 (AI Movement Constants in Meters)
  *
- * @public
  */
 export declare const AI_MOVEMENT_METERS: {
     /** Step size for AI movement (0.5m per step) */
@@ -256,7 +246,6 @@ export declare const AI_MOVEMENT_METERS: {
  * Use these ratios with arena dimensions to calculate starting positions:
  * - playerStartX = arenaX + (arenaWidth * PLAYER_START_POSITIONS.PLAYER1_X)
  *
- * @public
  */
 export declare const PLAYER_START_POSITIONS: {
     /** Player 1 starts at 25% from left edge */
@@ -271,7 +260,6 @@ export declare const PLAYER_START_POSITIONS: {
  *
  * **Korean**: AI성격최적범위미터 (AI Personality Optimal Ranges in Meters)
  *
- * @public
  */
 export declare const AI_OPTIMAL_RANGE_METERS: {
     /** Musa - Traditional warrior: close quarters */

package/lib/types/physicsConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physicsConstants.d.ts","sourceRoot":"","sources":["../../src/types/physicsConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,uBAAuB,EAAG,EAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAa,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,0BAA0B,EAAG,GAAY,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,KAA6B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,EAAG,CAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,0BAA0B,EAAG,IAAa,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,MAA6B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yCAAyC;;IAEzC,2CAA2C;;IAE3C,8CAA8C;;IAE9C,6CAA6C;;IAE7C,4CAA4C;;CAEpC,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;IAC/B,yDAAyD;;IAEzD,kDAAkD;;IAElD,4CAA4C;;IAE5C,6CAA6C;;IAE7C,gDAAgD;;CAExC,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gDAAgD;;IAEhD,2DAA2D;;IAE3D,+DAA+D;;IAE/D,0EAA0E;;IAE1E,kCAAkC;;IAElC,0CAA0C;;CAElC,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;IACjC,4CAA4C;;IAE5C,4CAA4C;;IAE5C,0DAA0D;;CAElD,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;IAClC,iDAAiD;;IAEjD,+CAA+C;;IAE/C,iDAAiD;;IAEjD,iEAAiE;;IAEjE,+DAA+D;;CAEvD,CAAC"}
+{"version":3,"file":"physicsConstants.d.ts","sourceRoot":"","sources":["../../src/types/physicsConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,uBAAuB,EAAG,EAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAa,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,0BAA0B,EAAG,GAAY,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,KAA6B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,EAAG,CAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,0BAA0B,EAAG,IAAa,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,MAA6B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yCAAyC;;IAEzC,2CAA2C;;IAE3C,8CAA8C;;IAE9C,6CAA6C;;IAE7C,4CAA4C;;CAEpC,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;IAC/B,yDAAyD;;IAEzD,kDAAkD;;IAElD,4CAA4C;;IAE5C,6CAA6C;;IAE7C,gDAAgD;;CAExC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gDAAgD;;IAEhD,2DAA2D;;IAE3D,+DAA+D;;IAE/D,0EAA0E;;IAE1E,kCAAkC;;IAElC,0CAA0C;;CAElC,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;IACjC,4CAA4C;;IAE5C,4CAA4C;;IAE5C,0DAA0D;;CAElD,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;IAClC,iDAAiD;;IAEjD,+CAA+C;;IAE/C,iDAAiD;;IAEjD,iEAAiE;;IAEjE,+DAA+D;;CAEvD,CAAC"}

package/lib/types/physicsConstants.js

@@ -43,7 +43,6 @@
 * );
 * ```
 *
-* @public
 * @category Combat Constants
 * @korean 기본체력재생속도
 */
@@ -69,7 +68,6 @@ var BASE_STAMINA_REGEN_RATE = 15;
 * const velocityChange = effectiveAcceleration * deltaTime;
 * ```
 *
-* @public
 * @category Physics Constants
 * @korean 기본이동가속도
 */
@@ -96,7 +94,6 @@ var BASE_MOVEMENT_ACCELERATION = 30;
 * const scale = actualPixelsPerMeter / REFERENCE_PIXELS_PER_METER;
 * ```
 *
-* @public
 * @category Coordinate Constants
 * @korean 참조픽셀미터비율
 */
@@ -112,7 +109,6 @@ var REFERENCE_PIXELS_PER_METER = 100;
 * `METERS_TO_PIXELS_SCALE` from `blacktrigram/types` and will be removed in a
 * future major release.
 *
-* @public
 * @category Coordinate Constants
 * @korean 미터-픽셀변환 (구형)
 */
@@ -135,7 +131,6 @@ var METERS_TO_PIXELS_SCALE = 100;
 * const reachInUnits = reachInMeters * METERS_TO_TRAINING_UNITS;
 * ```
 *
-* @public
 * @category Coordinate Constants
 * @korean 미터훈련비율
 */
@@ -169,7 +164,6 @@ var METERS_TO_TRAINING_UNITS = 1;
 * const effectiveDistance = centerToCenter - radius;
 * ```
 *
-* @public
 * @category Physics Constants
 * @korean 기본몸체반경
 */
@@ -184,7 +178,6 @@ var DEFAULT_BODY_RADIUS_METERS = .23;
 * importing `BODY_RADIUS_METERS` from `blacktrigram/types` and will be removed
 * in a future major release.
 *
-* @public
 * @category Physics Constants
 * @korean 몸체반경별칭
 */
@@ -192,7 +185,6 @@ var BODY_RADIUS_METERS = DEFAULT_BODY_RADIUS_METERS;
 /**
 * Standard arena sizes in meters (4:3 aspect ratio).
 *
-* @public
 */
 var ARENA_SIZE_METERS = {
 	/** Small screens (< 768px): 6m × 4.5m */
@@ -214,7 +206,6 @@ var ARENA_SIZE_METERS = {
 * These values define combat distance thresholds for AI decision-making
 * and hit detection. Use these instead of pixel-based COMBAT_RANGES.
 *
-* @public
 */
 var COMBAT_RANGES_METERS = {
 	/** Melee range: very close, grappling distance (0.5m) */
@@ -233,7 +224,6 @@ var COMBAT_RANGES_METERS = {
 *
 * **Korean**: AI이동상수미터 (AI Movement Constants in Meters)
 *
-* @public
 */
 var AI_MOVEMENT_METERS = {
 	/** Step size for AI movement (0.5m per step) */
@@ -257,7 +247,6 @@ var AI_MOVEMENT_METERS = {
 * Use these ratios with arena dimensions to calculate starting positions:
 * - playerStartX = arenaX + (arenaWidth * PLAYER_START_POSITIONS.PLAYER1_X)
 *
-* @public
 */
 var PLAYER_START_POSITIONS = {
 	/** Player 1 starts at 25% from left edge */
@@ -272,7 +261,6 @@ var PLAYER_START_POSITIONS = {
 *
 * **Korean**: AI성격최적범위미터 (AI Personality Optimal Ranges in Meters)
 *
-* @public
 */
 var AI_OPTIMAL_RANGE_METERS = {
 	/** Musa - Traditional warrior: close quarters */

package/lib/types/physicsConstants.js.map

@@ -1 +1 @@
-{"version":3,"file":"physicsConstants.js","names":[],"sources":["../../src/types/physicsConstants.ts"],"sourcesContent":["/**\n * Shared physics constants for Black Trigram combat system.\n *\n * **Korean**: 물리 상수\n *\n * This module provides shared constants for physics calculations across\n * combat and training systems, ensuring consistency in coordinate transformations\n * and unit conversions.\n *\n * ## Physics-First Architecture\n *\n * The game uses a physics-first coordinate system where:\n * - All internal calculations use meters (m) and meters/second (m/s)\n * - Arena sizes are determined by screen resolution (6m, 8m, 10m, 12m, 14m)\n * - Pixel conversion happens only at render time\n * - The pixels-per-meter ratio varies by device/resolution\n *\n * @module types/physicsConstants\n * @category Constants\n * @korean 물리상수\n */\n\n/**\n * Base stamina regeneration rate (stamina per second).\n *\n * **Korean**: 기본 체력 재생 속도\n *\n * This is the base rate at which stamina regenerates when not affected by\n * combat state penalties, breathing disruption, or other modifiers.\n *\n * - Increased from 3 to 15 stamina/second (5x faster) for fluid combat\n * - Allows players to move around and attack frequently without exhaustion\n * - Subject to penalties from breathing disruption (25%-75% reduction)\n * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)\n *\n * @example\n * ```typescript\n * // Calculate stamina regen with breathing disruption\n * const baseRegen = regenRate * BASE_STAMINA_REGEN_RATE;\n * const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(\n *   player,\n *   baseRegen\n * );\n * ```\n *\n * @public\n * @category Combat Constants\n * @korean 기본체력재생속도\n */\nexport const BASE_STAMINA_REGEN_RATE = 15.0 as const;\n\n/**\n * Base movement acceleration rate (m/s²).\n *\n * **Korean**: 기본 이동 가속도\n *\n * This is the base rate at which characters accelerate during movement.\n * Used by both MovementPhysics and SpeedModifierSystem for consistency.\n *\n * - Increased from 12.0 to 30.0 m/s² (2.5x faster) for instant-response combat\n * - Reaches 6 m/s walking speed in 0.2 seconds\n * - Reaches 10 m/s sprint speed in 0.33 seconds\n * - Provides arcade-style responsiveness suitable for Korean martial arts combat\n * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)\n *\n * @example\n * ```typescript\n * // Calculate acceleration with combat state penalty\n * const effectiveAcceleration = BASE_MOVEMENT_ACCELERATION * (1 - statePenalty);\n * const velocityChange = effectiveAcceleration * deltaTime;\n * ```\n *\n * @public\n * @category Physics Constants\n * @korean 기본이동가속도\n */\nexport const BASE_MOVEMENT_ACCELERATION = 30.0 as const;\n\n/**\n * Reference pixels-per-meter ratio for scale calculations.\n *\n * **Korean**: 참조 미터-픽셀 변환\n *\n * This is the REFERENCE ratio used for calculating scale factors.\n * The actual pixels-per-meter varies by device resolution:\n * - Calculate actual ratio: `arenaWidthPixels / arenaWidthMeters`\n * - Calculate scale: `actualRatio / REFERENCE_PIXELS_PER_METER`\n *\n * **Do NOT use this for direct coordinate conversion.**\n * Use `bounds.width / bounds.worldWidthMeters` instead.\n *\n * @example\n * ```typescript\n * // Calculate actual pixels per meter from arena bounds\n * const actualPixelsPerMeter = bounds.width / bounds.worldWidthMeters;\n *\n * // Calculate scale relative to reference\n * const scale = actualPixelsPerMeter / REFERENCE_PIXELS_PER_METER;\n * ```\n *\n * @public\n * @category Coordinate Constants\n * @korean 참조픽셀미터비율\n */\nexport const REFERENCE_PIXELS_PER_METER = 100 as const;\n\n/**\n * Legacy conversion factor from meters to pixels.\n *\n * **Korean**: 미터-픽셀 변환 인자 (구형)\n *\n * @deprecated Use `bounds.width / bounds.worldWidthMeters` for dynamic conversion.\n * The actual ratio now varies by screen resolution and arena size; this constant\n * is retained for backward compatibility with existing consumers importing\n * `METERS_TO_PIXELS_SCALE` from `blacktrigram/types` and will be removed in a\n * future major release.\n *\n * @public\n * @category Coordinate Constants\n * @korean 미터-픽셀변환 (구형)\n */\nexport const METERS_TO_PIXELS_SCALE = REFERENCE_PIXELS_PER_METER;\n\n/**\n * Conversion factor from meters to training scene units.\n *\n * **Korean**: 미터-훈련 단위 변환\n *\n * Training scenes are authored in real-world meters and use a 1:1 conversion\n * ratio. This means 1 meter in the game world equals 1 unit in the training\n * scene coordinate system.\n *\n * **IMPORTANT**: This differs from combat AI which uses dynamic pixels-per-meter.\n * The 3D world uses 1:1 meter scale for consistent physics.\n *\n * @example\n * ```typescript\n * // Convert reach from meters to training units (1:1)\n * const reachInUnits = reachInMeters * METERS_TO_TRAINING_UNITS;\n * ```\n *\n * @public\n * @category Coordinate Constants\n * @korean 미터훈련비율\n */\nexport const METERS_TO_TRAINING_UNITS = 1.0 as const;\n\n/**\n * Default body radius for hit distance calculation (training dummy).\n *\n * **Korean**: 기본몸체반경 (Default Body Radius)\n *\n * When calculating hit distance, we measure center-to-center, but attacks\n * land on the target's body surface, not their center point. This constant\n * represents the default body radius for entities without physical attributes\n * (like training dummies).\n *\n * For player archetypes, use `calculateBodyRadius(physicalAttributes)` from\n * `utils/skeletonScaling.ts` which calculates based on shoulder width.\n *\n * Based on average human proportions:\n * - Average shoulder width: ~45cm\n * - Body depth ratio: 0.5 × shoulderWidth = 22.5cm\n * - Result: ~0.225m (rounded to 0.23m)\n *\n * @example\n * ```typescript\n * // For training dummy (no archetype):\n * const effectiveDistance = centerToCenter - DEFAULT_BODY_RADIUS_METERS;\n *\n * // For player (use archetype):\n * import { calculateBodyRadius } from '@/utils/skeletonScaling';\n * const radius = calculateBodyRadius(physicalAttributes);\n * const effectiveDistance = centerToCenter - radius;\n * ```\n *\n * @public\n * @category Physics Constants\n * @korean 기본몸체반경\n */\nexport const DEFAULT_BODY_RADIUS_METERS = 0.23 as const;\n\n/**\n * Backwards-compatible alias for the default body radius.\n *\n * **Korean**: 이전호환몸체반경별칭\n *\n * @deprecated Use `DEFAULT_BODY_RADIUS_METERS` or `calculateBodyRadius()` instead.\n * This alias is retained for backward compatibility with existing consumers\n * importing `BODY_RADIUS_METERS` from `blacktrigram/types` and will be removed\n * in a future major release.\n *\n * @public\n * @category Physics Constants\n * @korean 몸체반경별칭\n */\nexport const BODY_RADIUS_METERS = DEFAULT_BODY_RADIUS_METERS;\n\n/**\n * Standard arena sizes in meters (4:3 aspect ratio).\n *\n * @public\n */\nexport const ARENA_SIZE_METERS = {\n  /** Small screens (< 768px): 6m × 4.5m */\n  SMALL: 6,\n  /** Medium screens (768-1199px): 8m × 6m */\n  MEDIUM: 8,\n  /** Large screens (1200-1919px): 10m × 7.5m */\n  LARGE: 10,\n  /** XLarge screens (1920-2559px): 12m × 9m */\n  XLARGE: 12,\n  /** Ultra screens (≥ 2560px): 14m × 10.5m */\n  ULTRA: 14,\n} as const;\n\n/**\n * Combat ranges in METERS for physics-first system.\n *\n * **Korean**: 전투범위미터 (Combat Ranges in Meters)\n *\n * These values define combat distance thresholds for AI decision-making\n * and hit detection. Use these instead of pixel-based COMBAT_RANGES.\n *\n * @public\n */\nexport const COMBAT_RANGES_METERS = {\n  /** Melee range: very close, grappling distance (0.5m) */\n  MELEE: 0.5,\n  /** Close range: punching/elbow distance (0.8m) */\n  CLOSE: 0.8,\n  /** Medium range: kicking distance (1.2m) */\n  MEDIUM: 1.2,\n  /** Long range: max attack distance (2.0m) */\n  LONG: 2.0,\n  /** Maximum range: engagement distance (3.0m) */\n  MAX: 3.0,\n} as const;\n\n/**\n * AI movement constants in METERS for physics-first system.\n *\n * **Korean**: AI이동상수미터 (AI Movement Constants in Meters)\n *\n * @public\n */\nexport const AI_MOVEMENT_METERS = {\n  /** Step size for AI movement (0.5m per step) */\n  STEP_SIZE: 0.5,\n  /** Minimum distance threshold to avoid division by zero */\n  MIN_DISTANCE_THRESHOLD: 0.05,\n  /** Horizontal arena margin (based on character width ~0.6m) */\n  ARENA_MARGIN_X: 0.6,\n  /** Vertical arena margin (based on character depth ~1.8m for movement) */\n  ARENA_MARGIN_Y: 1.8,\n  /** Flanking offset base (0.4m) */\n  FLANK_OFFSET_BASE: 0.4,\n  /** Flanking offset random range (0.2m) */\n  FLANK_OFFSET_RANDOM: 0.2,\n} as const;\n\n/**\n * Player starting positions as PERCENTAGES of arena dimensions.\n *\n * **Korean**: 시작위치비율 (Starting Position Ratios)\n *\n * Use these ratios with arena dimensions to calculate starting positions:\n * - playerStartX = arenaX + (arenaWidth * PLAYER_START_POSITIONS.PLAYER1_X)\n *\n * @public\n */\nexport const PLAYER_START_POSITIONS = {\n  /** Player 1 starts at 25% from left edge */\n  PLAYER1_X: 0.25,\n  /** Player 2 starts at 75% from left edge */\n  PLAYER2_X: 0.75,\n  /** Both players start at 50% depth (center vertically) */\n  CENTER_Y: 0.5,\n} as const;\n\n/**\n * AI personality optimal ranges in METERS.\n *\n * **Korean**: AI성격최적범위미터 (AI Personality Optimal Ranges in Meters)\n *\n * @public\n */\nexport const AI_OPTIMAL_RANGE_METERS = {\n  /** Musa - Traditional warrior: close quarters */\n  MUSA: 0.5,\n  /** Amsalja - Shadow assassin: stealth melee */\n  AMSALJA: 0.4,\n  /** Hacker - Cyber warrior: mid-range analysis */\n  HACKER: 1.2,\n  /** Jeongbo Yowon - Intelligence operative: tactical mid-range */\n  JEONGBO_YOWON: 0.8,\n  /** Jojik Pokryeokbae - Organized crime: brutal close combat */\n  JOJIK: 0.6,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAa,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BvC,IAAa,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4B1C,IAAa,6BAA6B;;;;;;;;;;;;;;;;AAiB1C,IAAa,yBAAA;;;;;;;;;;;;;;;;;;;;;;;AAwBb,IAAa,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCxC,IAAa,6BAA6B;;;;;;;;;;;;;;;AAgB1C,IAAa,qBAAqB;;;;;;AAOlC,IAAa,oBAAoB;;CAE/B,OAAO;;CAEP,QAAQ;;CAER,OAAO;;CAEP,QAAQ;;CAER,OAAO;CACR;;;;;;;;;;;AAYD,IAAa,uBAAuB;;CAElC,OAAO;;CAEP,OAAO;;CAEP,QAAQ;;CAER,MAAM;;CAEN,KAAK;CACN;;;;;;;;AASD,IAAa,qBAAqB;;CAEhC,WAAW;;CAEX,wBAAwB;;CAExB,gBAAgB;;CAEhB,gBAAgB;;CAEhB,mBAAmB;;CAEnB,qBAAqB;CACtB;;;;;;;;;;;AAYD,IAAa,yBAAyB;;CAEpC,WAAW;;CAEX,WAAW;;CAEX,UAAU;CACX;;;;;;;;AASD,IAAa,0BAA0B;;CAErC,MAAM;;CAEN,SAAS;;CAET,QAAQ;;CAER,eAAe;;CAEf,OAAO;CACR"}
+{"version":3,"file":"physicsConstants.js","names":[],"sources":["../../src/types/physicsConstants.ts"],"sourcesContent":["/**\n * Shared physics constants for Black Trigram combat system.\n *\n * **Korean**: 물리 상수\n *\n * This module provides shared constants for physics calculations across\n * combat and training systems, ensuring consistency in coordinate transformations\n * and unit conversions.\n *\n * ## Physics-First Architecture\n *\n * The game uses a physics-first coordinate system where:\n * - All internal calculations use meters (m) and meters/second (m/s)\n * - Arena sizes are determined by screen resolution (6m, 8m, 10m, 12m, 14m)\n * - Pixel conversion happens only at render time\n * - The pixels-per-meter ratio varies by device/resolution\n *\n * @module types/physicsConstants\n * @category Constants\n * @korean 물리상수\n */\n\n/**\n * Base stamina regeneration rate (stamina per second).\n *\n * **Korean**: 기본 체력 재생 속도\n *\n * This is the base rate at which stamina regenerates when not affected by\n * combat state penalties, breathing disruption, or other modifiers.\n *\n * - Increased from 3 to 15 stamina/second (5x faster) for fluid combat\n * - Allows players to move around and attack frequently without exhaustion\n * - Subject to penalties from breathing disruption (25%-75% reduction)\n * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)\n *\n * @example\n * ```typescript\n * // Calculate stamina regen with breathing disruption\n * const baseRegen = regenRate * BASE_STAMINA_REGEN_RATE;\n * const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(\n *   player,\n *   baseRegen\n * );\n * ```\n *\n * @category Combat Constants\n * @korean 기본체력재생속도\n */\nexport const BASE_STAMINA_REGEN_RATE = 15.0 as const;\n\n/**\n * Base movement acceleration rate (m/s²).\n *\n * **Korean**: 기본 이동 가속도\n *\n * This is the base rate at which characters accelerate during movement.\n * Used by both MovementPhysics and SpeedModifierSystem for consistency.\n *\n * - Increased from 12.0 to 30.0 m/s² (2.5x faster) for instant-response combat\n * - Reaches 6 m/s walking speed in 0.2 seconds\n * - Reaches 10 m/s sprint speed in 0.33 seconds\n * - Provides arcade-style responsiveness suitable for Korean martial arts combat\n * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)\n *\n * @example\n * ```typescript\n * // Calculate acceleration with combat state penalty\n * const effectiveAcceleration = BASE_MOVEMENT_ACCELERATION * (1 - statePenalty);\n * const velocityChange = effectiveAcceleration * deltaTime;\n * ```\n *\n * @category Physics Constants\n * @korean 기본이동가속도\n */\nexport const BASE_MOVEMENT_ACCELERATION = 30.0 as const;\n\n/**\n * Reference pixels-per-meter ratio for scale calculations.\n *\n * **Korean**: 참조 미터-픽셀 변환\n *\n * This is the REFERENCE ratio used for calculating scale factors.\n * The actual pixels-per-meter varies by device resolution:\n * - Calculate actual ratio: `arenaWidthPixels / arenaWidthMeters`\n * - Calculate scale: `actualRatio / REFERENCE_PIXELS_PER_METER`\n *\n * **Do NOT use this for direct coordinate conversion.**\n * Use `bounds.width / bounds.worldWidthMeters` instead.\n *\n * @example\n * ```typescript\n * // Calculate actual pixels per meter from arena bounds\n * const actualPixelsPerMeter = bounds.width / bounds.worldWidthMeters;\n *\n * // Calculate scale relative to reference\n * const scale = actualPixelsPerMeter / REFERENCE_PIXELS_PER_METER;\n * ```\n *\n * @category Coordinate Constants\n * @korean 참조픽셀미터비율\n */\nexport const REFERENCE_PIXELS_PER_METER = 100 as const;\n\n/**\n * Legacy conversion factor from meters to pixels.\n *\n * **Korean**: 미터-픽셀 변환 인자 (구형)\n *\n * @deprecated Use `bounds.width / bounds.worldWidthMeters` for dynamic conversion.\n * The actual ratio now varies by screen resolution and arena size; this constant\n * is retained for backward compatibility with existing consumers importing\n * `METERS_TO_PIXELS_SCALE` from `blacktrigram/types` and will be removed in a\n * future major release.\n *\n * @category Coordinate Constants\n * @korean 미터-픽셀변환 (구형)\n */\nexport const METERS_TO_PIXELS_SCALE = REFERENCE_PIXELS_PER_METER;\n\n/**\n * Conversion factor from meters to training scene units.\n *\n * **Korean**: 미터-훈련 단위 변환\n *\n * Training scenes are authored in real-world meters and use a 1:1 conversion\n * ratio. This means 1 meter in the game world equals 1 unit in the training\n * scene coordinate system.\n *\n * **IMPORTANT**: This differs from combat AI which uses dynamic pixels-per-meter.\n * The 3D world uses 1:1 meter scale for consistent physics.\n *\n * @example\n * ```typescript\n * // Convert reach from meters to training units (1:1)\n * const reachInUnits = reachInMeters * METERS_TO_TRAINING_UNITS;\n * ```\n *\n * @category Coordinate Constants\n * @korean 미터훈련비율\n */\nexport const METERS_TO_TRAINING_UNITS = 1.0 as const;\n\n/**\n * Default body radius for hit distance calculation (training dummy).\n *\n * **Korean**: 기본몸체반경 (Default Body Radius)\n *\n * When calculating hit distance, we measure center-to-center, but attacks\n * land on the target's body surface, not their center point. This constant\n * represents the default body radius for entities without physical attributes\n * (like training dummies).\n *\n * For player archetypes, use `calculateBodyRadius(physicalAttributes)` from\n * `utils/skeletonScaling.ts` which calculates based on shoulder width.\n *\n * Based on average human proportions:\n * - Average shoulder width: ~45cm\n * - Body depth ratio: 0.5 × shoulderWidth = 22.5cm\n * - Result: ~0.225m (rounded to 0.23m)\n *\n * @example\n * ```typescript\n * // For training dummy (no archetype):\n * const effectiveDistance = centerToCenter - DEFAULT_BODY_RADIUS_METERS;\n *\n * // For player (use archetype):\n * import { calculateBodyRadius } from '@/utils/skeletonScaling';\n * const radius = calculateBodyRadius(physicalAttributes);\n * const effectiveDistance = centerToCenter - radius;\n * ```\n *\n * @category Physics Constants\n * @korean 기본몸체반경\n */\nexport const DEFAULT_BODY_RADIUS_METERS = 0.23 as const;\n\n/**\n * Backwards-compatible alias for the default body radius.\n *\n * **Korean**: 이전호환몸체반경별칭\n *\n * @deprecated Use `DEFAULT_BODY_RADIUS_METERS` or `calculateBodyRadius()` instead.\n * This alias is retained for backward compatibility with existing consumers\n * importing `BODY_RADIUS_METERS` from `blacktrigram/types` and will be removed\n * in a future major release.\n *\n * @category Physics Constants\n * @korean 몸체반경별칭\n */\nexport const BODY_RADIUS_METERS = DEFAULT_BODY_RADIUS_METERS;\n\n/**\n * Standard arena sizes in meters (4:3 aspect ratio).\n *\n */\nexport const ARENA_SIZE_METERS = {\n  /** Small screens (< 768px): 6m × 4.5m */\n  SMALL: 6,\n  /** Medium screens (768-1199px): 8m × 6m */\n  MEDIUM: 8,\n  /** Large screens (1200-1919px): 10m × 7.5m */\n  LARGE: 10,\n  /** XLarge screens (1920-2559px): 12m × 9m */\n  XLARGE: 12,\n  /** Ultra screens (≥ 2560px): 14m × 10.5m */\n  ULTRA: 14,\n} as const;\n\n/**\n * Combat ranges in METERS for physics-first system.\n *\n * **Korean**: 전투범위미터 (Combat Ranges in Meters)\n *\n * These values define combat distance thresholds for AI decision-making\n * and hit detection. Use these instead of pixel-based COMBAT_RANGES.\n *\n */\nexport const COMBAT_RANGES_METERS = {\n  /** Melee range: very close, grappling distance (0.5m) */\n  MELEE: 0.5,\n  /** Close range: punching/elbow distance (0.8m) */\n  CLOSE: 0.8,\n  /** Medium range: kicking distance (1.2m) */\n  MEDIUM: 1.2,\n  /** Long range: max attack distance (2.0m) */\n  LONG: 2.0,\n  /** Maximum range: engagement distance (3.0m) */\n  MAX: 3.0,\n} as const;\n\n/**\n * AI movement constants in METERS for physics-first system.\n *\n * **Korean**: AI이동상수미터 (AI Movement Constants in Meters)\n *\n */\nexport const AI_MOVEMENT_METERS = {\n  /** Step size for AI movement (0.5m per step) */\n  STEP_SIZE: 0.5,\n  /** Minimum distance threshold to avoid division by zero */\n  MIN_DISTANCE_THRESHOLD: 0.05,\n  /** Horizontal arena margin (based on character width ~0.6m) */\n  ARENA_MARGIN_X: 0.6,\n  /** Vertical arena margin (based on character depth ~1.8m for movement) */\n  ARENA_MARGIN_Y: 1.8,\n  /** Flanking offset base (0.4m) */\n  FLANK_OFFSET_BASE: 0.4,\n  /** Flanking offset random range (0.2m) */\n  FLANK_OFFSET_RANDOM: 0.2,\n} as const;\n\n/**\n * Player starting positions as PERCENTAGES of arena dimensions.\n *\n * **Korean**: 시작위치비율 (Starting Position Ratios)\n *\n * Use these ratios with arena dimensions to calculate starting positions:\n * - playerStartX = arenaX + (arenaWidth * PLAYER_START_POSITIONS.PLAYER1_X)\n *\n */\nexport const PLAYER_START_POSITIONS = {\n  /** Player 1 starts at 25% from left edge */\n  PLAYER1_X: 0.25,\n  /** Player 2 starts at 75% from left edge */\n  PLAYER2_X: 0.75,\n  /** Both players start at 50% depth (center vertically) */\n  CENTER_Y: 0.5,\n} as const;\n\n/**\n * AI personality optimal ranges in METERS.\n *\n * **Korean**: AI성격최적범위미터 (AI Personality Optimal Ranges in Meters)\n *\n */\nexport const AI_OPTIMAL_RANGE_METERS = {\n  /** Musa - Traditional warrior: close quarters */\n  MUSA: 0.5,\n  /** Amsalja - Shadow assassin: stealth melee */\n  AMSALJA: 0.4,\n  /** Hacker - Cyber warrior: mid-range analysis */\n  HACKER: 1.2,\n  /** Jeongbo Yowon - Intelligence operative: tactical mid-range */\n  JEONGBO_YOWON: 0.8,\n  /** Jojik Pokryeokbae - Organized crime: brutal close combat */\n  JOJIK: 0.6,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,IAAa,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;AA0BvC,IAAa,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;AA2B1C,IAAa,6BAA6B;;;;;;;;;;;;;;;AAgB1C,IAAa,yBAAA;;;;;;;;;;;;;;;;;;;;;;AAuBb,IAAa,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCxC,IAAa,6BAA6B;;;;;;;;;;;;;;AAe1C,IAAa,qBAAqB;;;;;AAMlC,IAAa,oBAAoB;;CAE/B,OAAO;;CAEP,QAAQ;;CAER,OAAO;;CAEP,QAAQ;;CAER,OAAO;CACR;;;;;;;;;;AAWD,IAAa,uBAAuB;;CAElC,OAAO;;CAEP,OAAO;;CAEP,QAAQ;;CAER,MAAM;;CAEN,KAAK;CACN;;;;;;;AAQD,IAAa,qBAAqB;;CAEhC,WAAW;;CAEX,wBAAwB;;CAExB,gBAAgB;;CAEhB,gBAAgB;;CAEhB,mBAAmB;;CAEnB,qBAAqB;CACtB;;;;;;;;;;AAWD,IAAa,yBAAyB;;CAEpC,WAAW;;CAEX,WAAW;;CAEX,UAAU;CACX;;;;;;;AAQD,IAAa,0BAA0B;;CAErC,MAAM;;CAEN,SAAS;;CAET,QAAQ;;CAER,eAAe;;CAEf,OAAO;CACR"}