blacktrigram 0.7.2

package/lib/types/physics.js

@@ -0,0 +1,162 @@
+//#region src/types/physics.ts
+/**
+* Runtime validation helper for base extension multiplier.
+*
+* Ensures that the provided baseExtension value respects the documented range
+* of 0.0 to 1.5. This should be used when loading or constructing technique
+* configurations from dynamic sources (e.g. JSON, network, editors).
+*
+* **Korean**: 기본 확장 배수 검증
+*
+* @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 기본확장배수검증
+*/
+function isValidBaseExtension(baseExtension) {
+	return baseExtension >= 0 && baseExtension <= 1.5;
+}
+/**
+* Asserts that a PhysicalReachConfig has a valid baseExtension value.
+*
+* Throws a RangeError if the configuration's baseExtension is outside the
+* allowed range of 0.0 to 1.5. This provides a canonical runtime check that
+* can be used by reach calculators or technique loaders.
+*
+* **Korean**: 물리적 도달 설정 검증
+*
+* @param config - The PhysicalReachConfig instance to validate.
+* @throws RangeError If baseExtension is outside [0.0, 1.5].
+* @public
+* @category Combat Types
+* @korean 물리적도달설정검증
+*/
+function assertValidPhysicalReachConfig(config) {
+	if (!isValidBaseExtension(config.baseExtension)) throw new RangeError(`Invalid baseExtension ${config.baseExtension}. Expected a value between 0.0 and 1.5 inclusive.`);
+}
+/**
+* Base reach values for different technique types.
+*
+* **Korean**: 기본 범위 값
+*
+* @public
+* @category Combat Constants
+* @korean 기본범위값
+*/
+var BASE_REACH = {
+	punch: .7,
+	kick: 1,
+	elbow: .4,
+	knee: .4,
+	pressure_point: .5
+};
+/**
+* Stance reach modifiers for the Eight Trigrams.
+*
+* **Korean**: 팔괘 범위 수정자
+*
+* Each stance affects attack range differently based on its combat philosophy:
+* - Aggressive stances (Fire, Thunder) extend reach
+* - Defensive stances (Mountain) reduce reach
+* - Balanced stances (Heaven, Earth) have minor adjustments
+*
+* @public
+* @category Combat Constants
+* @korean 팔괘범위수정자
+*/
+var STANCE_REACH_MODIFIERS = {
+	li: 1.2,
+	jin: 1.15,
+	geon: 1.1,
+	son: 1.05,
+	tae: 1,
+	gam: 1,
+	gon: .95,
+	gan: .9
+};
+/**
+* Korean terminology for collision detection concepts.
+*
+* **Korean**: 충돌 감지 용어
+*
+* @public
+* @category Korean Terms
+* @korean 충돌용어
+*/
+var COLLISION_KOREAN_TERMS = {
+	collisionDetection: "충돌감지",
+	attackRange: "타격범위",
+	preciseHit: "정밀타격",
+	boundingBox: "경계상자",
+	raycast: "광선투사",
+	hitAccuracy: "타격정확도",
+	effectiveReach: "유효범위"
+};
+/**
+* Anatomical region dimensions in meters.
+*
+* **Korean**: 해부 영역 치수
+*
+* Standard dimensions for adult human anatomical regions used for bounding box creation.
+*
+* @public
+* @category Collision Constants
+* @korean 해부영역치수
+*/
+var ANATOMICAL_DIMENSIONS = {
+	head: {
+		type: "sphere",
+		radius: .125,
+		center: {
+			x: 0,
+			y: 1.7,
+			z: 0
+		}
+	},
+	neck: {
+		type: "capsule",
+		radius: .075,
+		height: .15,
+		center: {
+			x: 0,
+			y: 1.5,
+			z: 0
+		}
+	},
+	torso: {
+		type: "box",
+		width: .4,
+		height: .6,
+		depth: .25,
+		center: {
+			x: 0,
+			y: 1.1,
+			z: 0
+		}
+	},
+	arms: {
+		type: "capsule",
+		radius: .05,
+		height: .6,
+		center: {
+			x: .3,
+			y: 1.1,
+			z: 0
+		}
+	},
+	legs: {
+		type: "capsule",
+		radius: .06,
+		height: .8,
+		center: {
+			x: .15,
+			y: .4,
+			z: 0
+		}
+	}
+};
+//#endregion
+export { ANATOMICAL_DIMENSIONS, BASE_REACH, COLLISION_KOREAN_TERMS, STANCE_REACH_MODIFIERS, assertValidPhysicalReachConfig, isValidBaseExtension };
+
+//# sourceMappingURL=physics.js.map

package/lib/types/physics.js.map

@@ -0,0 +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;AACnE,QAAO,iBAAiB,KAAO,iBAAiB;;;;;;;;;;;;;;;;;AAkBlD,SAAgB,+BACd,QACM;AACN,KAAI,CAAC,qBAAqB,OAAO,cAAc,CAC7C,OAAM,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"}

package/lib/types/physicsConstants.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Shared physics constants for Black Trigram combat system.
+ *
+ * **Korean**: 물리 상수
+ *
+ * This module provides shared constants for physics calculations across
+ * combat and training systems, ensuring consistency in coordinate transformations
+ * and unit conversions.
+ *
+ * ## Physics-First Architecture
+ *
+ * The game uses a physics-first coordinate system where:
+ * - All internal calculations use meters (m) and meters/second (m/s)
+ * - Arena sizes are determined by screen resolution (6m, 8m, 10m, 12m, 14m)
+ * - Pixel conversion happens only at render time
+ * - The pixels-per-meter ratio varies by device/resolution
+ *
+ * @module types/physicsConstants
+ * @category Constants
+ * @korean 물리상수
+ */
+/**
+ * Base stamina regeneration rate (stamina per second).
+ *
+ * **Korean**: 기본 체력 재생 속도
+ *
+ * This is the base rate at which stamina regenerates when not affected by
+ * combat state penalties, breathing disruption, or other modifiers.
+ *
+ * - Increased from 3 to 15 stamina/second (5x faster) for fluid combat
+ * - Allows players to move around and attack frequently without exhaustion
+ * - Subject to penalties from breathing disruption (25%-75% reduction)
+ * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)
+ *
+ * @example
+ * ```typescript
+ * // Calculate stamina regen with breathing disruption
+ * const baseRegen = regenRate * BASE_STAMINA_REGEN_RATE;
+ * const modifiedRegen = BreathingDisruptionSystem.calculateStaminaRegen(
+ *   player,
+ *   baseRegen
+ * );
+ * ```
+ *
+ * @public
+ * @category Combat Constants
+ * @korean 기본체력재생속도
+ */
+export declare const BASE_STAMINA_REGEN_RATE: 15;
+/**
+ * Base movement acceleration rate (m/s²).
+ *
+ * **Korean**: 기본 이동 가속도
+ *
+ * This is the base rate at which characters accelerate during movement.
+ * Used by both MovementPhysics and SpeedModifierSystem for consistency.
+ *
+ * - Increased from 12.0 to 30.0 m/s² (2.5x faster) for instant-response combat
+ * - Reaches 6 m/s walking speed in 0.2 seconds
+ * - Reaches 10 m/s sprint speed in 0.33 seconds
+ * - Provides arcade-style responsiveness suitable for Korean martial arts combat
+ * - Subject to combat state penalties (20%-100% reduction when attacking/stunned)
+ *
+ * @example
+ * ```typescript
+ * // Calculate acceleration with combat state penalty
+ * const effectiveAcceleration = BASE_MOVEMENT_ACCELERATION * (1 - statePenalty);
+ * const velocityChange = effectiveAcceleration * deltaTime;
+ * ```
+ *
+ * @public
+ * @category Physics Constants
+ * @korean 기본이동가속도
+ */
+export declare const BASE_MOVEMENT_ACCELERATION: 30;
+/**
+ * Reference pixels-per-meter ratio for scale calculations.
+ *
+ * **Korean**: 참조 미터-픽셀 변환
+ *
+ * This is the REFERENCE ratio used for calculating scale factors.
+ * The actual pixels-per-meter varies by device resolution:
+ * - Calculate actual ratio: `arenaWidthPixels / arenaWidthMeters`
+ * - Calculate scale: `actualRatio / REFERENCE_PIXELS_PER_METER`
+ *
+ * **Do NOT use this for direct coordinate conversion.**
+ * Use `bounds.width / bounds.worldWidthMeters` instead.
+ *
+ * @example
+ * ```typescript
+ * // Calculate actual pixels per meter from arena bounds
+ * const actualPixelsPerMeter = bounds.width / bounds.worldWidthMeters;
+ *
+ * // Calculate scale relative to reference
+ * const scale = actualPixelsPerMeter / REFERENCE_PIXELS_PER_METER;
+ * ```
+ *
+ * @public
+ * @category Coordinate Constants
+ * @korean 참조픽셀미터비율
+ */
+export declare const REFERENCE_PIXELS_PER_METER: 100;
+/**
+ * @deprecated Use `bounds.width / bounds.worldWidthMeters` for dynamic conversion.
+ * This constant is kept for backward compatibility only.
+ *
+ * Legacy conversion factor from meters to pixels. The actual ratio now varies
+ * by screen resolution and arena size.
+ */
+export declare const METERS_TO_PIXELS_SCALE: 100;
+/**
+ * Conversion factor from meters to training scene units.
+ *
+ * **Korean**: 미터-훈련 단위 변환
+ *
+ * Training scenes are authored in real-world meters and use a 1:1 conversion
+ * ratio. This means 1 meter in the game world equals 1 unit in the training
+ * scene coordinate system.
+ *
+ * **IMPORTANT**: This differs from combat AI which uses dynamic pixels-per-meter.
+ * The 3D world uses 1:1 meter scale for consistent physics.
+ *
+ * @example
+ * ```typescript
+ * // Convert reach from meters to training units (1:1)
+ * const reachInUnits = reachInMeters * METERS_TO_TRAINING_UNITS;
+ * ```
+ *
+ * @public
+ * @category Coordinate Constants
+ * @korean 미터훈련비율
+ */
+export declare const METERS_TO_TRAINING_UNITS: 1;
+/**
+ * Default body radius for hit distance calculation (training dummy).
+ *
+ * **Korean**: 기본몸체반경 (Default Body Radius)
+ *
+ * When calculating hit distance, we measure center-to-center, but attacks
+ * land on the target's body surface, not their center point. This constant
+ * represents the default body radius for entities without physical attributes
+ * (like training dummies).
+ *
+ * For player archetypes, use `calculateBodyRadius(physicalAttributes)` from
+ * `utils/skeletonScaling.ts` which calculates based on shoulder width.
+ *
+ * Based on average human proportions:
+ * - Average shoulder width: ~45cm
+ * - Body depth ratio: 0.5 × shoulderWidth = 22.5cm
+ * - Result: ~0.225m (rounded to 0.23m)
+ *
+ * @example
+ * ```typescript
+ * // For training dummy (no archetype):
+ * const effectiveDistance = centerToCenter - DEFAULT_BODY_RADIUS_METERS;
+ *
+ * // For player (use archetype):
+ * import { calculateBodyRadius } from '../utils/skeletonScaling';
+ * const radius = calculateBodyRadius(physicalAttributes);
+ * const effectiveDistance = centerToCenter - radius;
+ * ```
+ *
+ * @public
+ * @category Physics Constants
+ * @korean 기본몸체반경
+ */
+export declare const DEFAULT_BODY_RADIUS_METERS: 0.23;
+/**
+ * @deprecated Use DEFAULT_BODY_RADIUS_METERS or calculateBodyRadius() instead.
+ * Kept for backward compatibility.
+ */
+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 */
+    readonly SMALL: 6;
+    /** Medium screens (768-1199px): 8m × 6m */
+    readonly MEDIUM: 8;
+    /** Large screens (1200-1919px): 10m × 7.5m */
+    readonly LARGE: 10;
+    /** XLarge screens (1920-2559px): 12m × 9m */
+    readonly XLARGE: 12;
+    /** Ultra screens (≥ 2560px): 14m × 10.5m */
+    readonly ULTRA: 14;
+};
+/**
+ * Combat ranges in METERS for physics-first system.
+ *
+ * **Korean**: 전투범위미터 (Combat Ranges in 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) */
+    readonly MELEE: 0.5;
+    /** Close range: punching/elbow distance (0.8m) */
+    readonly CLOSE: 0.8;
+    /** Medium range: kicking distance (1.2m) */
+    readonly MEDIUM: 1.2;
+    /** Long range: max attack distance (2.0m) */
+    readonly LONG: 2;
+    /** Maximum range: engagement distance (3.0m) */
+    readonly MAX: 3;
+};
+/**
+ * AI movement constants in METERS for physics-first system.
+ *
+ * **Korean**: AI이동상수미터 (AI Movement Constants in Meters)
+ *
+ * @public
+ */
+export declare const AI_MOVEMENT_METERS: {
+    /** Step size for AI movement (0.5m per step) */
+    readonly STEP_SIZE: 0.5;
+    /** Minimum distance threshold to avoid division by zero */
+    readonly MIN_DISTANCE_THRESHOLD: 0.05;
+    /** Horizontal arena margin (based on character width ~0.6m) */
+    readonly ARENA_MARGIN_X: 0.6;
+    /** Vertical arena margin (based on character depth ~1.8m for movement) */
+    readonly ARENA_MARGIN_Y: 1.8;
+    /** Flanking offset base (0.4m) */
+    readonly FLANK_OFFSET_BASE: 0.4;
+    /** Flanking offset random range (0.2m) */
+    readonly FLANK_OFFSET_RANDOM: 0.2;
+};
+/**
+ * Player starting positions as PERCENTAGES of arena dimensions.
+ *
+ * **Korean**: 시작위치비율 (Starting Position Ratios)
+ *
+ * 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 */
+    readonly PLAYER1_X: 0.25;
+    /** Player 2 starts at 75% from left edge */
+    readonly PLAYER2_X: 0.75;
+    /** Both players start at 50% depth (center vertically) */
+    readonly CENTER_Y: 0.5;
+};
+/**
+ * AI personality optimal ranges in METERS.
+ *
+ * **Korean**: AI성격최적범위미터 (AI Personality Optimal Ranges in Meters)
+ *
+ * @public
+ */
+export declare const AI_OPTIMAL_RANGE_METERS: {
+    /** Musa - Traditional warrior: close quarters */
+    readonly MUSA: 0.5;
+    /** Amsalja - Shadow assassin: stealth melee */
+    readonly AMSALJA: 0.4;
+    /** Hacker - Cyber warrior: mid-range analysis */
+    readonly HACKER: 1.2;
+    /** Jeongbo Yowon - Intelligence operative: tactical mid-range */
+    readonly JEONGBO_YOWON: 0.8;
+    /** Jojik Pokryeokbae - Organized crime: brutal close combat */
+    readonly JOJIK: 0.6;
+};
+//# sourceMappingURL=physicsConstants.d.ts.map

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

@@ -0,0 +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;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAG,GAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,EAAG,CAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,0BAA0B,EAAG,IAAa,CAAC;AAExD;;;GAGG;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"}

package/lib/types/physicsConstants.js

@@ -0,0 +1,71 @@
+//#region src/types/physicsConstants.ts
+/**
+* Default body radius for hit distance calculation (training dummy).
+*
+* **Korean**: 기본몸체반경 (Default Body Radius)
+*
+* When calculating hit distance, we measure center-to-center, but attacks
+* land on the target's body surface, not their center point. This constant
+* represents the default body radius for entities without physical attributes
+* (like training dummies).
+*
+* For player archetypes, use `calculateBodyRadius(physicalAttributes)` from
+* `utils/skeletonScaling.ts` which calculates based on shoulder width.
+*
+* Based on average human proportions:
+* - Average shoulder width: ~45cm
+* - Body depth ratio: 0.5 × shoulderWidth = 22.5cm
+* - Result: ~0.225m (rounded to 0.23m)
+*
+* @example
+* ```typescript
+* // For training dummy (no archetype):
+* const effectiveDistance = centerToCenter - DEFAULT_BODY_RADIUS_METERS;
+*
+* // For player (use archetype):
+* import { calculateBodyRadius } from '@/utils/skeletonScaling';
+* const radius = calculateBodyRadius(physicalAttributes);
+* const effectiveDistance = centerToCenter - radius;
+* ```
+*
+* @public
+* @category Physics Constants
+* @korean 기본몸체반경
+*/
+var DEFAULT_BODY_RADIUS_METERS = .23;
+/**
+* Combat ranges in METERS for physics-first system.
+*
+* **Korean**: 전투범위미터 (Combat Ranges in 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: .5,
+	CLOSE: .8,
+	MEDIUM: 1.2,
+	LONG: 2,
+	MAX: 3
+};
+/**
+* AI movement constants in METERS for physics-first system.
+*
+* **Korean**: AI이동상수미터 (AI Movement Constants in Meters)
+*
+* @public
+*/
+var AI_MOVEMENT_METERS = {
+	STEP_SIZE: .5,
+	MIN_DISTANCE_THRESHOLD: .05,
+	ARENA_MARGIN_X: .6,
+	ARENA_MARGIN_Y: 1.8,
+	FLANK_OFFSET_BASE: .4,
+	FLANK_OFFSET_RANDOM: .2
+};
+//#endregion
+export { AI_MOVEMENT_METERS, COMBAT_RANGES_METERS, DEFAULT_BODY_RADIUS_METERS };
+
+//# sourceMappingURL=physicsConstants.js.map

package/lib/types/physicsConstants.js.map

@@ -0,0 +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 * @deprecated Use `bounds.width / bounds.worldWidthMeters` for dynamic conversion.\n * This constant is kept for backward compatibility only.\n *\n * Legacy conversion factor from meters to pixels. The actual ratio now varies\n * by screen resolution and arena size.\n */\nexport const METERS_TO_PIXELS_SCALE = 100 as const;\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 * @deprecated Use DEFAULT_BODY_RADIUS_METERS or calculateBodyRadius() instead.\n * Kept for backward compatibility.\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4KA,IAAa,6BAA6B;;;;;;;;;;;AAoC1C,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"}