blacktrigram 0.7.44 → 0.7.45

package/lib/utils/haptics.d.ts

@@ -51,7 +51,6 @@ export declare function isHapticSupported(): boolean;
  * triggerHaptic('heavy');
  * ```
  *
- * @public
  */
 export declare function triggerHaptic(intensity: HapticIntensity): void;
 /**
@@ -70,7 +69,6 @@ export declare function triggerHaptic(intensity: HapticIntensity): void;
  * triggerCustomHaptic([200]);
  * ```
  *
- * @public
  */
 export declare function triggerCustomHaptic(pattern: number[]): void;
 /**
@@ -85,7 +83,6 @@ export declare function triggerCustomHaptic(pattern: number[]): void;
  * stopHaptic();
  * ```
  *
- * @public
  */
 export declare function stopHaptic(): void;
 /**

package/lib/utils/haptics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../src/utils/haptics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAgB3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAO9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC"}
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../src/utils/haptics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAgB3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAO9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC"}

package/lib/utils/haptics.js

@@ -53,7 +53,6 @@ function isHapticSupported() {
 * triggerHaptic('heavy');
 * ```
 * 
-* @public
 */
 function triggerHaptic(intensity) {
 	if (!isHapticSupported()) return;

package/lib/utils/haptics.js.map

@@ -1 +1 @@
-{"version":3,"file":"haptics.js","names":[],"sources":["../../src/utils/haptics.ts"],"sourcesContent":["/**\n * Haptic Feedback Utility\n * \n * Provides tactile feedback for mobile touch interactions\n * Uses Vibration API for physical response on button presses and combat hits\n * \n * @module utils/haptics\n * @category Mobile Controls\n * @korean 햅틱 피드백 유틸리티\n */\n\n/**\n * Haptic intensity levels for different interactions\n */\nexport type HapticIntensity = 'light' | 'medium' | 'heavy';\n\n/**\n * Vibration patterns for different haptic intensities\n * - light: Quick tap (10ms) - UI interactions\n * - medium: Moderate pulse (50ms) - Combat actions\n * - heavy: Strong pulse (100ms) - Critical hits\n * \n * @korean 햅틱 강도 패턴\n */\nconst HAPTIC_PATTERNS: Record<HapticIntensity, number[]> = {\n  light: [10],\n  medium: [50],\n  heavy: [100],\n} as const;\n\n/**\n * Check if haptic feedback is supported by the device\n * \n * @returns True if Vibration API is available\n * @korean 햅틱 지원 확인\n * \n * @example\n * ```typescript\n * if (isHapticSupported()) {\n *   triggerHaptic('medium');\n * }\n * ```\n */\nexport function isHapticSupported(): boolean {\n  return typeof navigator !== 'undefined' && 'vibrate' in navigator;\n}\n\n/**\n * Trigger haptic feedback with specified intensity\n * \n * Provides tactile response for:\n * - Light: Menu selections, button taps\n * - Medium: Attack actions, stance changes\n * - Heavy: Critical hits, successful vital point strikes\n * \n * Falls back gracefully if Vibration API is not supported\n * \n * @param intensity - Haptic intensity level\n * @korean 햅틱 피드백 실행\n * \n * @example\n * ```typescript\n * // Light feedback for UI interaction\n * triggerHaptic('light');\n * \n * // Medium feedback for combat action\n * triggerHaptic('medium');\n * \n * // Heavy feedback for critical hit\n * triggerHaptic('heavy');\n * ```\n * \n * @public\n */\nexport function triggerHaptic(intensity: HapticIntensity): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  const pattern = HAPTIC_PATTERNS[intensity];\n  navigator.vibrate(pattern);\n}\n\n/**\n * Custom haptic pattern for specific game events\n * Allows creating complex vibration sequences\n * \n * @param pattern - Array of vibration durations in milliseconds\n * @korean 커스텀 햅틱 패턴\n * \n * @example\n * ```typescript\n * // Combo hit feedback: buzz, pause, buzz\n * triggerCustomHaptic([30, 20, 30]);\n * \n * // Critical vital point strike: long buzz\n * triggerCustomHaptic([200]);\n * ```\n * \n * @public\n */\nexport function triggerCustomHaptic(pattern: number[]): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(pattern);\n}\n\n/**\n * Stop any ongoing haptic feedback\n * Useful for interrupting long vibrations\n * \n * @korean 햅틱 피드백 중지\n * \n * @example\n * ```typescript\n * // Cancel ongoing vibration\n * stopHaptic();\n * ```\n * \n * @public\n */\nexport function stopHaptic(): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(0);\n}\n\n/**\n * Combat-specific haptic feedback patterns\n * Pre-configured patterns for common combat scenarios\n * \n * @korean 전투 햅틱 패턴\n */\nexport const CombatHaptics = {\n  /**\n   * Standard attack hit feedback\n   * @korean 일반 공격\n   */\n  attack: () => triggerHaptic('medium'),\n\n  /**\n   * Block successful feedback\n   * @korean 방어 성공\n   */\n  block: () => triggerHaptic('light'),\n\n  /**\n   * Critical hit feedback with double pulse\n   * @korean 크리티컬 히트\n   */\n  criticalHit: () => triggerCustomHaptic([50, 30, 100]),\n\n  /**\n   * Vital point strike feedback\n   * @korean 급소 타격\n   */\n  vitalPointStrike: () => triggerHaptic('heavy'),\n\n  /**\n   * Stance change feedback\n   * @korean 자세 변경\n   */\n  stanceChange: () => triggerHaptic('light'),\n\n  /**\n   * Combo counter increment\n   * @korean 콤보 카운터\n   */\n  comboIncrement: () => triggerHaptic('light'),\n\n  /**\n   * Player KO feedback with extended pattern\n   * @korean 플레이어 KO\n   */\n  knockout: () => triggerCustomHaptic([100, 50, 100, 50, 200]),\n\n  /**\n   * Error or invalid action feedback\n   * @korean 오류 피드백\n   */\n  error: () => triggerCustomHaptic([20, 10, 20]),\n} as const;\n"],"mappings":";;;;;;;;;AAwBA,IAAM,kBAAqD;CACzD,OAAO,CAAC,GAAG;CACX,QAAQ,CAAC,GAAG;CACZ,OAAO,CAAC,IAAI;CACb;;;;;;;;;;;;;;AAeD,SAAgB,oBAA6B;CAC3C,OAAO,OAAO,cAAc,eAAe,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B1D,SAAgB,cAAc,WAAkC;CAC9D,IAAI,CAAC,mBAAmB,EACtB;CAGF,MAAM,UAAU,gBAAgB;CAChC,UAAU,QAAQ,QAAQ"}
+{"version":3,"file":"haptics.js","names":[],"sources":["../../src/utils/haptics.ts"],"sourcesContent":["/**\n * Haptic Feedback Utility\n * \n * Provides tactile feedback for mobile touch interactions\n * Uses Vibration API for physical response on button presses and combat hits\n * \n * @module utils/haptics\n * @category Mobile Controls\n * @korean 햅틱 피드백 유틸리티\n */\n\n/**\n * Haptic intensity levels for different interactions\n */\nexport type HapticIntensity = 'light' | 'medium' | 'heavy';\n\n/**\n * Vibration patterns for different haptic intensities\n * - light: Quick tap (10ms) - UI interactions\n * - medium: Moderate pulse (50ms) - Combat actions\n * - heavy: Strong pulse (100ms) - Critical hits\n * \n * @korean 햅틱 강도 패턴\n */\nconst HAPTIC_PATTERNS: Record<HapticIntensity, number[]> = {\n  light: [10],\n  medium: [50],\n  heavy: [100],\n} as const;\n\n/**\n * Check if haptic feedback is supported by the device\n * \n * @returns True if Vibration API is available\n * @korean 햅틱 지원 확인\n * \n * @example\n * ```typescript\n * if (isHapticSupported()) {\n *   triggerHaptic('medium');\n * }\n * ```\n */\nexport function isHapticSupported(): boolean {\n  return typeof navigator !== 'undefined' && 'vibrate' in navigator;\n}\n\n/**\n * Trigger haptic feedback with specified intensity\n * \n * Provides tactile response for:\n * - Light: Menu selections, button taps\n * - Medium: Attack actions, stance changes\n * - Heavy: Critical hits, successful vital point strikes\n * \n * Falls back gracefully if Vibration API is not supported\n * \n * @param intensity - Haptic intensity level\n * @korean 햅틱 피드백 실행\n * \n * @example\n * ```typescript\n * // Light feedback for UI interaction\n * triggerHaptic('light');\n * \n * // Medium feedback for combat action\n * triggerHaptic('medium');\n * \n * // Heavy feedback for critical hit\n * triggerHaptic('heavy');\n * ```\n * \n */\nexport function triggerHaptic(intensity: HapticIntensity): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  const pattern = HAPTIC_PATTERNS[intensity];\n  navigator.vibrate(pattern);\n}\n\n/**\n * Custom haptic pattern for specific game events\n * Allows creating complex vibration sequences\n * \n * @param pattern - Array of vibration durations in milliseconds\n * @korean 커스텀 햅틱 패턴\n * \n * @example\n * ```typescript\n * // Combo hit feedback: buzz, pause, buzz\n * triggerCustomHaptic([30, 20, 30]);\n * \n * // Critical vital point strike: long buzz\n * triggerCustomHaptic([200]);\n * ```\n * \n */\nexport function triggerCustomHaptic(pattern: number[]): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(pattern);\n}\n\n/**\n * Stop any ongoing haptic feedback\n * Useful for interrupting long vibrations\n * \n * @korean 햅틱 피드백 중지\n * \n * @example\n * ```typescript\n * // Cancel ongoing vibration\n * stopHaptic();\n * ```\n * \n */\nexport function stopHaptic(): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(0);\n}\n\n/**\n * Combat-specific haptic feedback patterns\n * Pre-configured patterns for common combat scenarios\n * \n * @korean 전투 햅틱 패턴\n */\nexport const CombatHaptics = {\n  /**\n   * Standard attack hit feedback\n   * @korean 일반 공격\n   */\n  attack: () => triggerHaptic('medium'),\n\n  /**\n   * Block successful feedback\n   * @korean 방어 성공\n   */\n  block: () => triggerHaptic('light'),\n\n  /**\n   * Critical hit feedback with double pulse\n   * @korean 크리티컬 히트\n   */\n  criticalHit: () => triggerCustomHaptic([50, 30, 100]),\n\n  /**\n   * Vital point strike feedback\n   * @korean 급소 타격\n   */\n  vitalPointStrike: () => triggerHaptic('heavy'),\n\n  /**\n   * Stance change feedback\n   * @korean 자세 변경\n   */\n  stanceChange: () => triggerHaptic('light'),\n\n  /**\n   * Combo counter increment\n   * @korean 콤보 카운터\n   */\n  comboIncrement: () => triggerHaptic('light'),\n\n  /**\n   * Player KO feedback with extended pattern\n   * @korean 플레이어 KO\n   */\n  knockout: () => triggerCustomHaptic([100, 50, 100, 50, 200]),\n\n  /**\n   * Error or invalid action feedback\n   * @korean 오류 피드백\n   */\n  error: () => triggerCustomHaptic([20, 10, 20]),\n} as const;\n"],"mappings":";;;;;;;;;AAwBA,IAAM,kBAAqD;CACzD,OAAO,CAAC,GAAG;CACX,QAAQ,CAAC,GAAG;CACZ,OAAO,CAAC,IAAI;CACb;;;;;;;;;;;;;;AAeD,SAAgB,oBAA6B;CAC3C,OAAO,OAAO,cAAc,eAAe,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B1D,SAAgB,cAAc,WAAkC;CAC9D,IAAI,CAAC,mBAAmB,EACtB;CAGF,MAAM,UAAU,gBAAgB;CAChC,UAAU,QAAQ,QAAQ"}

package/lib/utils/math.d.ts

@@ -26,7 +26,6 @@
  * const distance = calculateDistance3D([0, 0, 0], [3, 4, 0]);
  * // Returns: 5.0 (3-4-5 triangle)
  *
- * @public
  * @category Math Utilities
  * @korean 3D거리계산
  */
@@ -47,7 +46,6 @@ export declare function calculateDistance3D(pos1: [number, number, number], pos2
  * const distSq = calculateDistance3DSquared([0, 0, 0], [3, 4, 0]);
  * // Returns: 25.0
  *
- * @public
  * @category Math Utilities
  * @korean 3D거리제곱계산
  */
@@ -72,7 +70,6 @@ export declare function calculateDistance3DSquared(pos1: [number, number, number
  * const straightAngle = toRadians(180);
  * // Returns: approximately 3.1416 (π)
  *
- * @public
  * @category Math Utilities
  * @korean 각도변환
  */

package/lib/utils/math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/lib/utils/math.js

@@ -27,7 +27,6 @@
 * const distance = calculateDistance3D([0, 0, 0], [3, 4, 0]);
 * // Returns: 5.0 (3-4-5 triangle)
 * 
-* @public
 * @category Math Utilities
 * @korean 3D거리계산
 */
@@ -57,7 +56,6 @@ function calculateDistance3D(pos1, pos2) {
 * const straightAngle = toRadians(180);
 * // Returns: approximately 3.1416 (π)
 * 
-* @public
 * @category Math Utilities
 * @korean 각도변환
 */

package/lib/utils/math.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.js","names":[],"sources":["../../src/utils/math.ts"],"sourcesContent":["/**\n * Mathematical utility functions for Black Trigram\n * \n * Provides shared mathematical operations used across combat, training,\n * and physics systems to ensure consistency and follow DRY principles.\n * \n * **Korean**: 수학 유틸리티 함수\n * \n * @module utils/math\n * @korean 수학유틸리티\n */\n\n/**\n * Calculate 3D Euclidean distance between two positions\n * \n * Uses the standard 3D distance formula: √(dx² + dy² + dz²)\n * This is used throughout the combat and training systems to calculate\n * distance between combatants, ensuring consistent distance calculations.\n * \n * **Korean**: 3D 유클리드 거리 계산\n * \n * @param pos1 - First position as [x, y, z] tuple\n * @param pos2 - Second position as [x, y, z] tuple\n * @returns The 3D Euclidean distance in meters\n * \n * @example\n * const distance = calculateDistance3D([0, 0, 0], [3, 4, 0]);\n * // Returns: 5.0 (3-4-5 triangle)\n * \n * @public\n * @category Math Utilities\n * @korean 3D거리계산\n */\nexport function calculateDistance3D(\n  pos1: [number, number, number],\n  pos2: [number, number, number]\n): number {\n  const dx = pos1[0] - pos2[0];\n  const dy = pos1[1] - pos2[1];\n  const dz = pos1[2] - pos2[2];\n  return Math.sqrt(dx * dx + dy * dy + dz * dz);\n}\n\n/**\n * Calculate squared 3D distance between two positions\n * \n * Optimized version that avoids the expensive square root operation.\n * Useful when comparing distances (A > B) where the square root is unnecessary.\n * \n * **Korean**: 3D 거리 제곱 계산\n * \n * @param pos1 - First position as [x, y, z] tuple\n * @param pos2 - Second position as [x, y, z] tuple\n * @returns The squared 3D distance in meters²\n * \n * @example\n * const distSq = calculateDistance3DSquared([0, 0, 0], [3, 4, 0]);\n * // Returns: 25.0\n * \n * @public\n * @category Math Utilities\n * @korean 3D거리제곱계산\n */\nexport function calculateDistance3DSquared(\n  pos1: [number, number, number],\n  pos2: [number, number, number]\n): number {\n  const dx = pos1[0] - pos2[0];\n  const dy = pos1[1] - pos2[1];\n  const dz = pos1[2] - pos2[2];\n  return dx * dx + dy * dy + dz * dz;\n}\n\n/**\n * Convert degrees to radians\n * \n * Used throughout animation systems for bone rotations where angles are\n * specified in degrees for readability but need to be converted to radians\n * for Three.js rendering.\n * \n * **Korean**: 각도를 라디안으로 변환\n * \n * @param degrees - Angle in degrees (0-360)\n * @returns Angle in radians (0-2π)\n * \n * @example\n * const rightAngle = toRadians(90);\n * // Returns: approximately 1.5708 (π/2)\n * \n * @example\n * const straightAngle = toRadians(180);\n * // Returns: approximately 3.1416 (π)\n * \n * @public\n * @category Math Utilities\n * @korean 각도변환\n */\nexport function toRadians(degrees: number): number {\n  return degrees * (Math.PI / 180);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,oBACd,MACA,MACQ;CACR,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;AAyD/C,SAAgB,UAAU,SAAyB;CACjD,OAAO,WAAW,KAAK,KAAK"}
+{"version":3,"file":"math.js","names":[],"sources":["../../src/utils/math.ts"],"sourcesContent":["/**\n * Mathematical utility functions for Black Trigram\n * \n * Provides shared mathematical operations used across combat, training,\n * and physics systems to ensure consistency and follow DRY principles.\n * \n * **Korean**: 수학 유틸리티 함수\n * \n * @module utils/math\n * @korean 수학유틸리티\n */\n\n/**\n * Calculate 3D Euclidean distance between two positions\n * \n * Uses the standard 3D distance formula: √(dx² + dy² + dz²)\n * This is used throughout the combat and training systems to calculate\n * distance between combatants, ensuring consistent distance calculations.\n * \n * **Korean**: 3D 유클리드 거리 계산\n * \n * @param pos1 - First position as [x, y, z] tuple\n * @param pos2 - Second position as [x, y, z] tuple\n * @returns The 3D Euclidean distance in meters\n * \n * @example\n * const distance = calculateDistance3D([0, 0, 0], [3, 4, 0]);\n * // Returns: 5.0 (3-4-5 triangle)\n * \n * @category Math Utilities\n * @korean 3D거리계산\n */\nexport function calculateDistance3D(\n  pos1: [number, number, number],\n  pos2: [number, number, number]\n): number {\n  const dx = pos1[0] - pos2[0];\n  const dy = pos1[1] - pos2[1];\n  const dz = pos1[2] - pos2[2];\n  return Math.sqrt(dx * dx + dy * dy + dz * dz);\n}\n\n/**\n * Calculate squared 3D distance between two positions\n * \n * Optimized version that avoids the expensive square root operation.\n * Useful when comparing distances (A > B) where the square root is unnecessary.\n * \n * **Korean**: 3D 거리 제곱 계산\n * \n * @param pos1 - First position as [x, y, z] tuple\n * @param pos2 - Second position as [x, y, z] tuple\n * @returns The squared 3D distance in meters²\n * \n * @example\n * const distSq = calculateDistance3DSquared([0, 0, 0], [3, 4, 0]);\n * // Returns: 25.0\n * \n * @category Math Utilities\n * @korean 3D거리제곱계산\n */\nexport function calculateDistance3DSquared(\n  pos1: [number, number, number],\n  pos2: [number, number, number]\n): number {\n  const dx = pos1[0] - pos2[0];\n  const dy = pos1[1] - pos2[1];\n  const dz = pos1[2] - pos2[2];\n  return dx * dx + dy * dy + dz * dz;\n}\n\n/**\n * Convert degrees to radians\n * \n * Used throughout animation systems for bone rotations where angles are\n * specified in degrees for readability but need to be converted to radians\n * for Three.js rendering.\n * \n * **Korean**: 각도를 라디안으로 변환\n * \n * @param degrees - Angle in degrees (0-360)\n * @returns Angle in radians (0-2π)\n * \n * @example\n * const rightAngle = toRadians(90);\n * // Returns: approximately 1.5708 (π/2)\n * \n * @example\n * const straightAngle = toRadians(180);\n * // Returns: approximately 3.1416 (π)\n * \n * @category Math Utilities\n * @korean 각도변환\n */\nexport function toRadians(degrees: number): number {\n  return degrees * (Math.PI / 180);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,oBACd,MACA,MACQ;CACR,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,MAAM,KAAK,KAAK,KAAK,KAAK;CAC1B,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;AAuD/C,SAAgB,UAAU,SAAyB;CACjD,OAAO,WAAW,KAAK,KAAK"}

package/lib/utils/mobileLayoutHelpers.d.ts

@@ -11,7 +11,6 @@
 /**
  * Mobile area bounds with world dimensions.
  *
- * @public
  */
 export interface MobileAreaBounds {
     readonly x: number;
@@ -31,7 +30,6 @@ export interface MobileAreaBounds {
  *   so both fighters plus the horizontal breathing-room between them fit
  *   inside a narrow viewport without being occluded by the bottom HUD.
  *
- * @public
  */
 export type MobileOrientation = "portrait" | "landscape";
 /**
@@ -63,7 +61,6 @@ export type MobileOrientation = "portrait" | "landscape";
  * const portrait  = calculateMobileAreaBounds(375, 667, 80, 220, 90, "portrait");
  * ```
  *
- * @public
  * @korean 모바일영역경계계산
  */
 export declare function calculateMobileAreaBounds(width: number, height: number, topClearance: number, bottomClearance: number, yOffset: number, orientation?: MobileOrientation): MobileAreaBounds;

package/lib/utils/mobileLayoutHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobileLayoutHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/mobileLayoutHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,iBAA+B,GAC3C,gBAAgB,CAgGlB"}
+{"version":3,"file":"mobileLayoutHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/mobileLayoutHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,iBAA+B,GAC3C,gBAAgB,CAgGlB"}

package/lib/utils/mobileLayoutHelpers.js

@@ -39,7 +39,6 @@ import { calculateArenaWorldDimensions } from "./arenaWorldDimensions.js";
 * const portrait  = calculateMobileAreaBounds(375, 667, 80, 220, 90, "portrait");
 * ```
 *
-* @public
 * @korean 모바일영역경계계산
 */
 function calculateMobileAreaBounds(width, height, topClearance, bottomClearance, yOffset, orientation = "landscape") {

package/lib/utils/mobileLayoutHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mobileLayoutHelpers.js","names":[],"sources":["../../src/utils/mobileLayoutHelpers.ts"],"sourcesContent":["/**\n * Mobile Layout Helpers\n *\n * Shared utilities for calculating mobile area bounds with consistent aspect ratios\n * and device-specific sizing. Used by both combat and training layout hooks.\n *\n * @module utils/mobileLayoutHelpers\n * @category Layout\n * @korean 모바일레이아웃도우미\n */\n\nimport { calculateArenaWorldDimensions } from \"./arenaWorldDimensions\";\n\n/**\n * Mobile area bounds with world dimensions.\n *\n * @public\n */\nexport interface MobileAreaBounds {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n  readonly scale: number;\n  readonly worldWidthMeters: number;\n  readonly worldDepthMeters: number;\n}\n\n/**\n * Device orientation for mobile area calculation.\n *\n * - `landscape`: width > height, the arena is rendered in 4:3 (wider than tall)\n *   so both fighters remain visible from a side view.\n * - `portrait`: height ≥ width, the arena is rendered in 3:4 (taller than wide)\n *   so both fighters plus the horizontal breathing-room between them fit\n *   inside a narrow viewport without being occluded by the bottom HUD.\n *\n * @public\n */\nexport type MobileOrientation = \"portrait\" | \"landscape\";\n\n/**\n * Calculate mobile area bounds, orientation-aware.\n *\n * Implements consistent mobile area sizing logic shared between combat and training screens.\n * Adapts to different device resolutions while maintaining an orientation-appropriate\n * aspect ratio (4:3 in landscape, 3:4 in portrait).\n *\n * The caller is responsible for passing `bottomClearance` that already includes\n * the bottom HUD (technique bar), the mobile controls (D-Pad / action buttons)\n * and any safe-area insets. This function will never let the arena overflow\n * `height - topClearance - bottomClearance`.\n *\n * @param width - Screen width in pixels\n * @param height - Screen height in pixels\n * @param topClearance - Minimum space to reserve at top (for HUD/header + safe area)\n * @param bottomClearance - Minimum space to reserve at bottom (controls + footer + safe area)\n * @param yOffset - Y position offset (typically header height + padding)\n * @param orientation - `\"portrait\"` for tall-narrow viewports, otherwise `\"landscape\"` (default)\n * @returns Mobile area bounds with position, dimensions, scale, and world dimensions\n *\n * @example\n * ```typescript\n * // Landscape phone: 4:3 arena\n * const landscape = calculateMobileAreaBounds(667, 375, 60, 120, 70, \"landscape\");\n *\n * // Portrait phone: 3:4 arena (taller than wide)\n * const portrait  = calculateMobileAreaBounds(375, 667, 80, 220, 90, \"portrait\");\n * ```\n *\n * @public\n * @korean 모바일영역경계계산\n */\nexport function calculateMobileAreaBounds(\n  width: number,\n  height: number,\n  topClearance: number,\n  bottomClearance: number,\n  yOffset: number,\n  orientation: MobileOrientation = \"landscape\",\n): MobileAreaBounds {\n  const isPortrait = orientation === \"portrait\";\n\n  // Calculate available space for the area.\n  // Extra-small devices (<380px) use tighter margins for more screen real estate.\n  //\n  // Height reservation: the arena starts at `yOffset`, so the available\n  // vertical space is bounded by `height - yOffset - bottomClearance`.\n  // Falling back to `height - topClearance - bottomClearance` when a caller\n  // passes `yOffset < topClearance` keeps the legacy behaviour, but we must\n  // never let the arena overflow when `yOffset > topClearance` (which is the\n  // case for the updated combat/training layout hooks).\n  const horizontalMargin = width < 380 ? 30 : 40; // 15px vs 20px per side\n  const effectiveTopReservation = Math.max(topClearance, yOffset);\n  const availableHeight = Math.max(\n    0,\n    height - effectiveTopReservation - bottomClearance,\n  );\n  const availableWidth = Math.max(0, width - horizontalMargin);\n\n  // Determine max width based on device resolution\n  // Device-specific sizing with extra-small support:\n  // - 4K mobile landscape (≥2160px): up to 1100px\n  // - QHD+/4K portrait (≥1440px): up to 960px\n  // - 2K (1200-1439px): up to 760px\n  // - Large phones/tablets (768-1199px): up to 560px\n  // - Standard phones (380-767px): up to 400px\n  // - Extra-small phones (<380px): up to 320px\n  let maxMobileWidth: number;\n  if (width >= 2160) {\n    maxMobileWidth = Math.min(availableWidth, 1100);\n  } else if (width >= 1440) {\n    maxMobileWidth = Math.min(availableWidth, 960);\n  } else if (width >= 1200) {\n    maxMobileWidth = Math.min(availableWidth, 760);\n  } else if (width >= 768) {\n    maxMobileWidth = Math.min(availableWidth, 560);\n  } else if (width >= 380) {\n    maxMobileWidth = Math.min(availableWidth, 400);\n  } else {\n    // Extra-small devices (iPhone SE, old Android, budget phones)\n    maxMobileWidth = Math.min(availableWidth, 320);\n  }\n\n  // In portrait we want the arena to consume more vertical real estate,\n  // so the per-device max-height cap only applies in landscape.\n  const maxMobileHeight = isPortrait\n    ? availableHeight\n    : Math.min(availableHeight, width < 380 ? 240 : 800);\n\n  // Aspect ratio depends on orientation:\n  //   landscape → 4:3 (height = width × 3/4)\n  //   portrait  → 3:4 (height = width × 4/3)\n  // In portrait, width is constrained by height × 3/4 (not height × 4/3).\n  const widthFromHeight = isPortrait\n    ? maxMobileHeight * (3 / 4)\n    : maxMobileHeight * (4 / 3);\n\n  // Minimum arena width so the 3D scene stays legible, but never above\n  // what the viewport can actually host:\n  //   - `availableWidth` caps absolute width of the arena element\n  //   - in portrait, `availableHeight × 3/4` caps arena width so the arena\n  //     height never exceeds `availableHeight` (preventing the arena from\n  //     being drawn behind the bottom HUD / D-Pad).\n  //   - in landscape, `availableHeight × 4/3` caps arena width so the 4:3\n  //     arena height never exceeds `availableHeight` on short mobile screens.\n  const hardWidthCap = isPortrait\n    ? Math.min(availableWidth, availableHeight * (3 / 4))\n    : Math.min(availableWidth, availableHeight * (4 / 3));\n  const minArenaWidth = Math.min(280, hardWidthCap);\n\n  const areaWidth = Math.max(\n    Math.min(maxMobileWidth, widthFromHeight, hardWidthCap),\n    Math.max(0, minArenaWidth),\n  );\n  const areaHeight = isPortrait ? areaWidth * (4 / 3) : areaWidth * (3 / 4);\n\n  // Calculate world dimensions based on RENDERED arena width (not screen width)\n  // This ensures correct pixels-per-meter ratio for the actual visible arena\n  const worldDimensions = calculateArenaWorldDimensions(areaWidth);\n\n  // Calculate 3D scale factor based on reference arena\n  // Reference: 10m arena at 1000px = 100 px/m\n  const pixelsPerMeter = areaWidth / worldDimensions.widthMeters;\n  const referencePixelsPerMeter = 100;\n  const scale = pixelsPerMeter / referencePixelsPerMeter;\n\n  return {\n    x: (width - areaWidth) / 2, // Centered horizontally\n    y: yOffset,\n    width: areaWidth,\n    height: areaHeight,\n    scale,\n    worldWidthMeters: worldDimensions.widthMeters,\n    worldDepthMeters: worldDimensions.depthMeters,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,0BACd,OACA,QACA,cACA,iBACA,SACA,cAAiC,aACf;CAClB,MAAM,aAAa,gBAAgB;CAWnC,MAAM,mBAAmB,QAAQ,MAAM,KAAK;CAE5C,MAAM,kBAAkB,KAAK,IAC3B,GACA,SAH8B,KAAK,IAAI,cAAc,QAG5C,GAA0B,gBACpC;CACD,MAAM,iBAAiB,KAAK,IAAI,GAAG,QAAQ,iBAAiB;CAU5D,IAAI;CACJ,IAAI,SAAS,MACX,iBAAiB,KAAK,IAAI,gBAAgB,KAAK;MAC1C,IAAI,SAAS,MAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,MAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,KAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,KAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MAG9C,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;CAKhD,MAAM,kBAAkB,aACpB,kBACA,KAAK,IAAI,iBAAiB,QAAQ,MAAM,MAAM,IAAI;CAMtD,MAAM,kBAAkB,aACpB,mBAAmB,IAAI,KACvB,mBAAmB,IAAI;CAU3B,MAAM,eAAe,aACjB,KAAK,IAAI,gBAAgB,mBAAmB,IAAI,GAAG,GACnD,KAAK,IAAI,gBAAgB,mBAAmB,IAAI,GAAG;CAGvD,MAAM,YAAY,KAAK,IACrB,KAAK,IAAI,gBAAgB,iBAAiB,aAAa,EACvD,KAAK,IAAI,GAJW,KAAK,IAAI,KAAK,aAItB,CAAc,CAC3B;CACD,MAAM,aAAa,aAAa,aAAa,IAAI,KAAK,aAAa,IAAI;CAIvE,MAAM,kBAAkB,8BAA8B,UAAU;CAMhE,MAAM,QAFiB,YAAY,gBAAgB,cAEpB;CAE/B,OAAO;EACL,IAAI,QAAQ,aAAa;EACzB,GAAG;EACH,OAAO;EACP,QAAQ;EACR;EACA,kBAAkB,gBAAgB;EAClC,kBAAkB,gBAAgB;EACnC"}
+{"version":3,"file":"mobileLayoutHelpers.js","names":[],"sources":["../../src/utils/mobileLayoutHelpers.ts"],"sourcesContent":["/**\n * Mobile Layout Helpers\n *\n * Shared utilities for calculating mobile area bounds with consistent aspect ratios\n * and device-specific sizing. Used by both combat and training layout hooks.\n *\n * @module utils/mobileLayoutHelpers\n * @category Layout\n * @korean 모바일레이아웃도우미\n */\n\nimport { calculateArenaWorldDimensions } from \"./arenaWorldDimensions\";\n\n/**\n * Mobile area bounds with world dimensions.\n *\n */\nexport interface MobileAreaBounds {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n  readonly scale: number;\n  readonly worldWidthMeters: number;\n  readonly worldDepthMeters: number;\n}\n\n/**\n * Device orientation for mobile area calculation.\n *\n * - `landscape`: width > height, the arena is rendered in 4:3 (wider than tall)\n *   so both fighters remain visible from a side view.\n * - `portrait`: height ≥ width, the arena is rendered in 3:4 (taller than wide)\n *   so both fighters plus the horizontal breathing-room between them fit\n *   inside a narrow viewport without being occluded by the bottom HUD.\n *\n */\nexport type MobileOrientation = \"portrait\" | \"landscape\";\n\n/**\n * Calculate mobile area bounds, orientation-aware.\n *\n * Implements consistent mobile area sizing logic shared between combat and training screens.\n * Adapts to different device resolutions while maintaining an orientation-appropriate\n * aspect ratio (4:3 in landscape, 3:4 in portrait).\n *\n * The caller is responsible for passing `bottomClearance` that already includes\n * the bottom HUD (technique bar), the mobile controls (D-Pad / action buttons)\n * and any safe-area insets. This function will never let the arena overflow\n * `height - topClearance - bottomClearance`.\n *\n * @param width - Screen width in pixels\n * @param height - Screen height in pixels\n * @param topClearance - Minimum space to reserve at top (for HUD/header + safe area)\n * @param bottomClearance - Minimum space to reserve at bottom (controls + footer + safe area)\n * @param yOffset - Y position offset (typically header height + padding)\n * @param orientation - `\"portrait\"` for tall-narrow viewports, otherwise `\"landscape\"` (default)\n * @returns Mobile area bounds with position, dimensions, scale, and world dimensions\n *\n * @example\n * ```typescript\n * // Landscape phone: 4:3 arena\n * const landscape = calculateMobileAreaBounds(667, 375, 60, 120, 70, \"landscape\");\n *\n * // Portrait phone: 3:4 arena (taller than wide)\n * const portrait  = calculateMobileAreaBounds(375, 667, 80, 220, 90, \"portrait\");\n * ```\n *\n * @korean 모바일영역경계계산\n */\nexport function calculateMobileAreaBounds(\n  width: number,\n  height: number,\n  topClearance: number,\n  bottomClearance: number,\n  yOffset: number,\n  orientation: MobileOrientation = \"landscape\",\n): MobileAreaBounds {\n  const isPortrait = orientation === \"portrait\";\n\n  // Calculate available space for the area.\n  // Extra-small devices (<380px) use tighter margins for more screen real estate.\n  //\n  // Height reservation: the arena starts at `yOffset`, so the available\n  // vertical space is bounded by `height - yOffset - bottomClearance`.\n  // Falling back to `height - topClearance - bottomClearance` when a caller\n  // passes `yOffset < topClearance` keeps the legacy behaviour, but we must\n  // never let the arena overflow when `yOffset > topClearance` (which is the\n  // case for the updated combat/training layout hooks).\n  const horizontalMargin = width < 380 ? 30 : 40; // 15px vs 20px per side\n  const effectiveTopReservation = Math.max(topClearance, yOffset);\n  const availableHeight = Math.max(\n    0,\n    height - effectiveTopReservation - bottomClearance,\n  );\n  const availableWidth = Math.max(0, width - horizontalMargin);\n\n  // Determine max width based on device resolution\n  // Device-specific sizing with extra-small support:\n  // - 4K mobile landscape (≥2160px): up to 1100px\n  // - QHD+/4K portrait (≥1440px): up to 960px\n  // - 2K (1200-1439px): up to 760px\n  // - Large phones/tablets (768-1199px): up to 560px\n  // - Standard phones (380-767px): up to 400px\n  // - Extra-small phones (<380px): up to 320px\n  let maxMobileWidth: number;\n  if (width >= 2160) {\n    maxMobileWidth = Math.min(availableWidth, 1100);\n  } else if (width >= 1440) {\n    maxMobileWidth = Math.min(availableWidth, 960);\n  } else if (width >= 1200) {\n    maxMobileWidth = Math.min(availableWidth, 760);\n  } else if (width >= 768) {\n    maxMobileWidth = Math.min(availableWidth, 560);\n  } else if (width >= 380) {\n    maxMobileWidth = Math.min(availableWidth, 400);\n  } else {\n    // Extra-small devices (iPhone SE, old Android, budget phones)\n    maxMobileWidth = Math.min(availableWidth, 320);\n  }\n\n  // In portrait we want the arena to consume more vertical real estate,\n  // so the per-device max-height cap only applies in landscape.\n  const maxMobileHeight = isPortrait\n    ? availableHeight\n    : Math.min(availableHeight, width < 380 ? 240 : 800);\n\n  // Aspect ratio depends on orientation:\n  //   landscape → 4:3 (height = width × 3/4)\n  //   portrait  → 3:4 (height = width × 4/3)\n  // In portrait, width is constrained by height × 3/4 (not height × 4/3).\n  const widthFromHeight = isPortrait\n    ? maxMobileHeight * (3 / 4)\n    : maxMobileHeight * (4 / 3);\n\n  // Minimum arena width so the 3D scene stays legible, but never above\n  // what the viewport can actually host:\n  //   - `availableWidth` caps absolute width of the arena element\n  //   - in portrait, `availableHeight × 3/4` caps arena width so the arena\n  //     height never exceeds `availableHeight` (preventing the arena from\n  //     being drawn behind the bottom HUD / D-Pad).\n  //   - in landscape, `availableHeight × 4/3` caps arena width so the 4:3\n  //     arena height never exceeds `availableHeight` on short mobile screens.\n  const hardWidthCap = isPortrait\n    ? Math.min(availableWidth, availableHeight * (3 / 4))\n    : Math.min(availableWidth, availableHeight * (4 / 3));\n  const minArenaWidth = Math.min(280, hardWidthCap);\n\n  const areaWidth = Math.max(\n    Math.min(maxMobileWidth, widthFromHeight, hardWidthCap),\n    Math.max(0, minArenaWidth),\n  );\n  const areaHeight = isPortrait ? areaWidth * (4 / 3) : areaWidth * (3 / 4);\n\n  // Calculate world dimensions based on RENDERED arena width (not screen width)\n  // This ensures correct pixels-per-meter ratio for the actual visible arena\n  const worldDimensions = calculateArenaWorldDimensions(areaWidth);\n\n  // Calculate 3D scale factor based on reference arena\n  // Reference: 10m arena at 1000px = 100 px/m\n  const pixelsPerMeter = areaWidth / worldDimensions.widthMeters;\n  const referencePixelsPerMeter = 100;\n  const scale = pixelsPerMeter / referencePixelsPerMeter;\n\n  return {\n    x: (width - areaWidth) / 2, // Centered horizontally\n    y: yOffset,\n    width: areaWidth,\n    height: areaHeight,\n    scale,\n    worldWidthMeters: worldDimensions.widthMeters,\n    worldDepthMeters: worldDimensions.depthMeters,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsEA,SAAgB,0BACd,OACA,QACA,cACA,iBACA,SACA,cAAiC,aACf;CAClB,MAAM,aAAa,gBAAgB;CAWnC,MAAM,mBAAmB,QAAQ,MAAM,KAAK;CAE5C,MAAM,kBAAkB,KAAK,IAC3B,GACA,SAH8B,KAAK,IAAI,cAAc,QAG5C,GAA0B,gBACpC;CACD,MAAM,iBAAiB,KAAK,IAAI,GAAG,QAAQ,iBAAiB;CAU5D,IAAI;CACJ,IAAI,SAAS,MACX,iBAAiB,KAAK,IAAI,gBAAgB,KAAK;MAC1C,IAAI,SAAS,MAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,MAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,KAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MACzC,IAAI,SAAS,KAClB,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;MAG9C,iBAAiB,KAAK,IAAI,gBAAgB,IAAI;CAKhD,MAAM,kBAAkB,aACpB,kBACA,KAAK,IAAI,iBAAiB,QAAQ,MAAM,MAAM,IAAI;CAMtD,MAAM,kBAAkB,aACpB,mBAAmB,IAAI,KACvB,mBAAmB,IAAI;CAU3B,MAAM,eAAe,aACjB,KAAK,IAAI,gBAAgB,mBAAmB,IAAI,GAAG,GACnD,KAAK,IAAI,gBAAgB,mBAAmB,IAAI,GAAG;CAGvD,MAAM,YAAY,KAAK,IACrB,KAAK,IAAI,gBAAgB,iBAAiB,aAAa,EACvD,KAAK,IAAI,GAJW,KAAK,IAAI,KAAK,aAItB,CAAc,CAC3B;CACD,MAAM,aAAa,aAAa,aAAa,IAAI,KAAK,aAAa,IAAI;CAIvE,MAAM,kBAAkB,8BAA8B,UAAU;CAMhE,MAAM,QAFiB,YAAY,gBAAgB,cAEpB;CAE/B,OAAO;EACL,IAAI,QAAQ,aAAa;EACzB,GAAG;EACH,OAAO;EACP,QAAQ;EACR;EACA,kBAAkB,gBAAgB;EAClC,kBAAkB,gBAAgB;EACnC"}

package/lib/utils/mobileUIUtils.d.ts

@@ -47,15 +47,6 @@ export interface TouchTargetSize {
  * @param width - Viewport width in pixels
  * @returns Viewport size category
  *
- * @example
- * ```typescript
- * getViewportSize(375); // 'xs' (iPhone SE)
- * getViewportSize(768); // 'sm' (Standard phones, high-end mobiles start here)
- * getViewportSize(2712); // 'md' (Motorola Edge 60 Pro Super HD)
- * getViewportSize(1200); // 'lg' (Desktop)
- * ```
- *
- * @public
  * @korean 뷰포트크기얻기
  */
 export declare function getViewportSize(width: number): ViewportSize;
@@ -70,16 +61,6 @@ export declare function getViewportSize(width: number): ViewportSize;
  * @param viewportWidth - Optional viewport width for fine-tuning
  * @returns Touch target size configuration
  *
- * @example
- * ```typescript
- * const buttonSize = getTouchTargetSize(true, 375);
- * // { minWidth: 48, minHeight: 48, padding: 12, spacing: 8 }
- *
- * const superHDButtonSize = getTouchTargetSize(true, 2712);
- * // { minWidth: 56, minHeight: 56, padding: 16, spacing: 12 }
- * ```
- *
- * @public
  * @korean 터치타겟크기얻기
  */
 export declare function getTouchTargetSize(isMobile: boolean, viewportWidth?: number): TouchTargetSize;
@@ -93,15 +74,6 @@ export declare function getTouchTargetSize(isMobile: boolean, viewportWidth?: nu
  * @param viewportWidth - Viewport width in pixels
  * @returns Font size in pixels
  *
- * @example
- * ```typescript
- * getMobileKoreanFontSize('SMALL', 375); // 16
- * getMobileKoreanFontSize('MEDIUM', 410); // 18
- * getMobileKoreanFontSize('MEDIUM', 2712); // 20 (Super HD enhanced)
- * getMobileKoreanFontSize('LARGE', 768); // 24
- * ```
- *
- * @public
  * @korean 모바일한글글꼴크기얻기
  */
 export declare function getMobileKoreanFontSize(size: keyof typeof KOREAN_MOBILE_FONT_SIZES, viewportWidth: number): number;
@@ -113,13 +85,6 @@ export declare function getMobileKoreanFontSize(size: keyof typeof KOREAN_MOBILE
  * @param isMobile - Whether on mobile device
  * @returns Scaled spacing in pixels
  *
- * @example
- * ```typescript
- * getResponsiveSpacing(SPACING.MD, true); // 12 (COMPACT on mobile)
- * getResponsiveSpacing(SPACING.MD, false); // 16 (original)
- * ```
- *
- * @public
  * @korean 반응형간격얻기
  */
 export declare function getResponsiveSpacing(baseSpacing: number, isMobile: boolean): number;
@@ -132,13 +97,6 @@ export declare function getResponsiveSpacing(baseSpacing: number, isMobile: bool
  * @param minMargin - Minimum margin on each side (default: 20px)
  * @returns Panel width in pixels
  *
- * @example
- * ```typescript
- * getResponsivePanelWidth(375, true); // ~335px (375 - 40 margin)
- * getResponsivePanelWidth(1200, false); // ~400px (max width applied)
- * ```
- *
- * @public
  * @korean 반응형패널폭얻기
  */
 export declare function getResponsivePanelWidth(viewportWidth: number, isMobile: boolean, minMargin?: number): number;
@@ -149,13 +107,6 @@ export declare function getResponsivePanelWidth(viewportWidth: number, isMobile:
  * @param viewportHeight - Viewport height in pixels
  * @returns Whether in landscape orientation
  *
- * @example
- * ```typescript
- * isLandscape(812, 375); // true (iPhone X landscape)
- * isLandscape(375, 812); // false (iPhone X portrait)
- * ```
- *
- * @public
  * @korean 가로모드여부
  */
 export declare function isLandscape(viewportWidth: number, viewportHeight: number): boolean;
@@ -166,19 +117,6 @@ export declare function isLandscape(viewportWidth: number, viewportHeight: numbe
  * @param viewportWidth - Optional viewport width
  * @returns CSS properties for button
  *
- * @example
- * ```typescript
- * const buttonStyles = getResponsiveButtonStyles(true, 375);
- * // {
- * //   minWidth: '48px',
- * //   minHeight: '48px',
- * //   padding: '12px',
- * //   fontSize: '16px',
- * //   ...
- * // }
- * ```
- *
- * @public
  * @korean 반응형버튼스타일얻기
  */
 export declare function getResponsiveButtonStyles(isMobile: boolean, viewportWidth?: number): React.CSSProperties;
@@ -190,17 +128,6 @@ export declare function getResponsiveButtonStyles(isMobile: boolean, viewportWid
  * @param viewportWidth - Viewport width in pixels
  * @returns CSS properties for text
  *
- * @example
- * ```typescript
- * const textStyles = getResponsiveTextStyles('MEDIUM', true, 375);
- * // {
- * //   fontSize: '18px',
- * //   lineHeight: '1.5',
- * //   letterSpacing: '0.02em',
- * // }
- * ```
- *
- * @public
  * @korean 반응형텍스트스타일얻기
  */
 export declare function getResponsiveTextStyles(size: keyof typeof KOREAN_MOBILE_FONT_SIZES, isMobile: boolean, viewportWidth: number): React.CSSProperties;
@@ -211,13 +138,6 @@ export declare function getResponsiveTextStyles(size: keyof typeof KOREAN_MOBILE
  * @param isMobile - Whether on mobile device
  * @returns Minimum spacing in pixels
  *
- * @example
- * ```typescript
- * getMinimumInteractiveSpacing(true); // 8px (mobile)
- * getMinimumInteractiveSpacing(false); // 12px (desktop)
- * ```
- *
- * @public
  * @korean 최소상호작용간격얻기
  */
 export declare function getMinimumInteractiveSpacing(isMobile: boolean): number;
@@ -230,15 +150,9 @@ export declare function getMinimumInteractiveSpacing(isMobile: boolean): number;
  * @korean 뷰포트감지
  */
 export declare const ViewportDetection: {
-    /**
-     * Check if iPhone SE or similar small device
-     * @korean iPhone SE여부
-     */
+    /** Check if iPhone SE or similar small device @korean iPhone SE여부 */
     readonly isSmallMobile: (width: number) => boolean;
-    /**
-     * Check if standard mobile device (excluding high-end)
-     * @korean 표준모바일여부
-     */
+    /** Check if standard mobile device (excluding high-end) @korean 표준모바일여부 */
     readonly isMobile: (width: number) => boolean;
     /**
      * Check if high-end mobile device (Super HD, 2K+)
@@ -247,20 +161,11 @@ export declare const ViewportDetection: {
      * @korean 고급모바일여부
      */
     readonly isSuperHDMobile: (width: number, height?: number) => boolean;
-    /**
-     * Check if tablet device
-     * @korean 태블릿여부
-     */
+    /** Check if tablet device @korean 태블릿여부 */
     readonly isTablet: (width: number) => boolean;
-    /**
-     * Check if desktop device
-     * @korean 데스크톱여부
-     */
+    /** Check if desktop device @korean 데스크톱여부 */
     readonly isDesktop: (width: number) => boolean;
-    /**
-     * Check if device has notch (iPhone X+)
-     * @korean 노치여부
-     */
+    /** Check if device has notch (iPhone X+) @korean 노치여부 */
     readonly hasNotch: (width: number, height: number) => boolean;
 };
 //# sourceMappingURL=mobileUIUtils.d.ts.map

package/lib/utils/mobileUIUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobileUIUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mobileUIUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,wBAAwB,EAEzB,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAM3D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,eAAe,CA8BjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,OAAO,wBAAwB,EAC3C,aAAa,EAAE,MAAM,GACpB,MAAM,CAUR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,OAAO,EACjB,SAAS,SAAK,GACb,MAAM,CAOR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAAC,aAAa,CAgBrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,OAAO,wBAAwB,EAC3C,QAAQ,EAAE,OAAO,EACjB,aAAa,EAAE,MAAM,GACpB,KAAK,CAAC,aAAa,CAUrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAItE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;oCACoB,MAAM;IAE7B;;;OAGG;+BACe,MAAM;IAExB;;;;;OAKG;sCACsB,MAAM,WAAU,MAAM;IAO/C;;;OAGG;+BACe,MAAM;IAExB;;;OAGG;gCACgB,MAAM;IAEzB;;;OAGG;+BACe,MAAM,UAAU,MAAM;CAMhC,CAAC"}
+{"version":3,"file":"mobileUIUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mobileUIUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,wBAAwB,EAEzB,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAM3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,eAAe,CA8BjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,OAAO,wBAAwB,EAC3C,aAAa,EAAE,MAAM,GACpB,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,OAAO,EACjB,SAAS,SAAK,GACb,MAAM,CAOR;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAAC,aAAa,CAgBrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,OAAO,wBAAwB,EAC3C,QAAQ,EAAE,OAAO,EACjB,aAAa,EAAE,MAAM,GACpB,KAAK,CAAC,aAAa,CAUrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAItE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;IAC5B,qEAAqE;oCAC9C,MAAM;IAE7B,2EAA2E;+BACzD,MAAM;IAExB;;;;;OAKG;sCACsB,MAAM,WAAU,MAAM;IAO/C,2CAA2C;+BACzB,MAAM;IAExB,6CAA6C;gCAC1B,MAAM;IAEzB,yDAAyD;+BACvC,MAAM,UAAU,MAAM;CAMhC,CAAC"}

package/lib/utils/mobileUIUtils.js

@@ -10,15 +10,6 @@ import { getKoreanFontSize } from "../types/constants/typography.js";
 * @param viewportWidth - Viewport width in pixels
 * @returns Font size in pixels
 * 
-* @example
-* ```typescript
-* getMobileKoreanFontSize('SMALL', 375); // 16
-* getMobileKoreanFontSize('MEDIUM', 410); // 18
-* getMobileKoreanFontSize('MEDIUM', 2712); // 20 (Super HD enhanced)
-* getMobileKoreanFontSize('LARGE', 768); // 24
-* ```
-* 
-* @public
 * @korean 모바일한글글꼴크기얻기
 */
 function getMobileKoreanFontSize(size, viewportWidth) {

package/lib/utils/mobileUIUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"mobileUIUtils.js","names":[],"sources":["../../src/utils/mobileUIUtils.ts"],"sourcesContent":["/**\n * Mobile UI utilities for responsive touch-optimized interfaces\n * \n * Provides helpers for touch target sizing, responsive font scaling,\n * and mobile-specific layout calculations following iOS/Android guidelines.\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are top priority and get:\n * - Enhanced touch targets (56px vs 48px)\n * - Larger Korean fonts (+10% for better readability)\n * - Optimized spacing and layout\n * - Full feature parity with desktop\n * \n * Supported Devices (Priority Order):\n * 1. Super HD Mobile (≥768px): Motorola Edge 60 Pro, Galaxy S-series\n * 2. Standard Mobile (375-767px): iPhone 12/13/14, standard Android\n * 3. Small Mobile (<375px): iPhone SE, budget devices\n * \n * @module utils/mobileUIUtils\n * @category Mobile Utilities\n * @korean 모바일UI유틸리티\n */\n\nimport { UI_DIMENSIONS, SPACING } from \"../types/constants/ui\";\nimport {\n  KOREAN_MOBILE_FONT_SIZES,\n  getKoreanFontSize,\n} from \"../types/constants/typography\";\n\n/**\n * Viewport size category for responsive design\n * \n * @category Mobile UI\n * @korean 뷰포트크기범주\n */\nexport type ViewportSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\n\n/**\n * Touch target size configuration\n * \n * @category Mobile UI\n * @korean 터치타겟크기설정\n */\nexport interface TouchTargetSize {\n  readonly minWidth: number;\n  readonly minHeight: number;\n  readonly padding: number;\n  readonly spacing: number;\n}\n\n/**\n * Get viewport size category from width\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are treated as 'md' for optimal layout\n * \n * @param width - Viewport width in pixels\n * @returns Viewport size category\n * \n * @example\n * ```typescript\n * getViewportSize(375); // 'xs' (iPhone SE)\n * getViewportSize(768); // 'sm' (Standard phones, high-end mobiles start here)\n * getViewportSize(2712); // 'md' (Motorola Edge 60 Pro Super HD)\n * getViewportSize(1200); // 'lg' (Desktop)\n * ```\n * \n * @public\n * @korean 뷰포트크기얻기\n */\nexport function getViewportSize(width: number): ViewportSize {\n  if (width < 375) return \"xs\"; // Extra small phones\n  if (width < 768) return \"sm\"; // Standard phones\n  if (width < 1024) return \"md\"; // High-end mobile (Super HD), tablets\n  if (width < 1440) return \"lg\"; // Small desktop\n  return \"xl\"; // Large desktop\n}\n\n/**\n * Get touch-optimized button size configuration\n * Ensures minimum 48px touch targets per iOS/Android guidelines\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) get enhanced touch targets (56px)\n * for better precision on high-resolution displays\n * \n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Optional viewport width for fine-tuning\n * @returns Touch target size configuration\n * \n * @example\n * ```typescript\n * const buttonSize = getTouchTargetSize(true, 375);\n * // { minWidth: 48, minHeight: 48, padding: 12, spacing: 8 }\n * \n * const superHDButtonSize = getTouchTargetSize(true, 2712);\n * // { minWidth: 56, minHeight: 56, padding: 16, spacing: 12 }\n * ```\n * \n * @public\n * @korean 터치타겟크기얻기\n */\nexport function getTouchTargetSize(\n  isMobile: boolean,\n  viewportWidth?: number\n): TouchTargetSize {\n  if (!isMobile) {\n    return {\n      minWidth: 120,\n      minHeight: 44,\n      padding: SPACING.MD,\n      spacing: SPACING.MD,\n    };\n  }\n\n  const width = viewportWidth ?? 375;\n  const isExtraSmall = width < 360;\n  const isSuperHD = width >= 768; // High-end mobile (Motorola Edge 60 Pro, etc.)\n\n  // Super HD devices get enhanced touch targets for better precision\n  if (isSuperHD) {\n    return {\n      minWidth: UI_DIMENSIONS.TOUCH_TARGET_COMFORTABLE,\n      minHeight: UI_DIMENSIONS.TOUCH_TARGET_COMFORTABLE,\n      padding: SPACING.MD,\n      spacing: SPACING.COMPACT,\n    };\n  }\n\n  return {\n    minWidth: UI_DIMENSIONS.TOUCH_TARGET_MIN,\n    minHeight: UI_DIMENSIONS.TOUCH_TARGET_MIN,\n    padding: isExtraSmall ? SPACING.SM : SPACING.COMPACT,\n    spacing: UI_DIMENSIONS.TOUCH_TARGET_SPACING,\n  };\n}\n\n/**\n * Get responsive Korean font size for mobile\n * Ensures minimum 16px for body text on mobile\n * \n * PRIORITY: High-end mobile (Super HD, 2K+) get enhanced font sizes for better readability\n * \n * @param size - Size category ('SMALL', 'MEDIUM', 'LARGE')\n * @param viewportWidth - Viewport width in pixels\n * @returns Font size in pixels\n * \n * @example\n * ```typescript\n * getMobileKoreanFontSize('SMALL', 375); // 16\n * getMobileKoreanFontSize('MEDIUM', 410); // 18\n * getMobileKoreanFontSize('MEDIUM', 2712); // 20 (Super HD enhanced)\n * getMobileKoreanFontSize('LARGE', 768); // 24\n * ```\n * \n * @public\n * @korean 모바일한글글꼴크기얻기\n */\nexport function getMobileKoreanFontSize(\n  size: keyof typeof KOREAN_MOBILE_FONT_SIZES,\n  viewportWidth: number\n): number {\n  const fontSize = getKoreanFontSize(size, viewportWidth);\n  \n  // Super HD mobile devices (≥768px) get enhanced font sizes\n  // for better readability on high-resolution displays\n  if (viewportWidth >= 768) {\n    return Math.ceil(fontSize * 1.1); // 10% larger for Super HD\n  }\n  \n  return fontSize;\n}\n\n/**\n * Get responsive spacing value\n * Scales spacing based on viewport size\n * \n * @param baseSpacing - Base spacing value from SPACING constant\n * @param isMobile - Whether on mobile device\n * @returns Scaled spacing in pixels\n * \n * @example\n * ```typescript\n * getResponsiveSpacing(SPACING.MD, true); // 12 (COMPACT on mobile)\n * getResponsiveSpacing(SPACING.MD, false); // 16 (original)\n * ```\n * \n * @public\n * @korean 반응형간격얻기\n */\nexport function getResponsiveSpacing(\n  baseSpacing: number,\n  isMobile: boolean\n): number {\n  return isMobile ? Math.max(SPACING.SM, baseSpacing * 0.75) : baseSpacing;\n}\n\n/**\n * Calculate responsive panel width\n * Ensures panels fit within viewport with proper margins\n * \n * @param viewportWidth - Viewport width in pixels\n * @param isMobile - Whether on mobile device\n * @param minMargin - Minimum margin on each side (default: 20px)\n * @returns Panel width in pixels\n * \n * @example\n * ```typescript\n * getResponsivePanelWidth(375, true); // ~335px (375 - 40 margin)\n * getResponsivePanelWidth(1200, false); // ~400px (max width applied)\n * ```\n * \n * @public\n * @korean 반응형패널폭얻기\n */\nexport function getResponsivePanelWidth(\n  viewportWidth: number,\n  isMobile: boolean,\n  minMargin = 20\n): number {\n  if (!isMobile) {\n    return Math.min(400, viewportWidth - minMargin * 2);\n  }\n\n  // Mobile: use most of screen width\n  return Math.min(viewportWidth - minMargin * 2, 360);\n}\n\n/**\n * Check if viewport is in landscape orientation\n * \n * @param viewportWidth - Viewport width in pixels\n * @param viewportHeight - Viewport height in pixels\n * @returns Whether in landscape orientation\n * \n * @example\n * ```typescript\n * isLandscape(812, 375); // true (iPhone X landscape)\n * isLandscape(375, 812); // false (iPhone X portrait)\n * ```\n * \n * @public\n * @korean 가로모드여부\n */\nexport function isLandscape(\n  viewportWidth: number,\n  viewportHeight: number\n): boolean {\n  return viewportWidth > viewportHeight;\n}\n\n/**\n * Get responsive button styles for touch optimization\n * \n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Optional viewport width\n * @returns CSS properties for button\n * \n * @example\n * ```typescript\n * const buttonStyles = getResponsiveButtonStyles(true, 375);\n * // {\n * //   minWidth: '48px',\n * //   minHeight: '48px',\n * //   padding: '12px',\n * //   fontSize: '16px',\n * //   ...\n * // }\n * ```\n * \n * @public\n * @korean 반응형버튼스타일얻기\n */\nexport function getResponsiveButtonStyles(\n  isMobile: boolean,\n  viewportWidth?: number\n): React.CSSProperties {\n  const touchTarget = getTouchTargetSize(isMobile, viewportWidth);\n  const fontSize = isMobile\n    ? getMobileKoreanFontSize(\"SMALL\", viewportWidth ?? 375)\n    : 16;\n\n  return {\n    minWidth: `${touchTarget.minWidth}px`,\n    minHeight: `${touchTarget.minHeight}px`,\n    padding: `${touchTarget.padding}px`,\n    fontSize: `${fontSize}px`,\n    lineHeight: \"1.4\",\n    cursor: \"pointer\",\n    userSelect: \"none\",\n    WebkitTapHighlightColor: \"transparent\",\n  };\n}\n\n/**\n * Get responsive text styles with proper Korean font sizing\n * \n * @param size - Font size category\n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Viewport width in pixels\n * @returns CSS properties for text\n * \n * @example\n * ```typescript\n * const textStyles = getResponsiveTextStyles('MEDIUM', true, 375);\n * // {\n * //   fontSize: '18px',\n * //   lineHeight: '1.5',\n * //   letterSpacing: '0.02em',\n * // }\n * ```\n * \n * @public\n * @korean 반응형텍스트스타일얻기\n */\nexport function getResponsiveTextStyles(\n  size: keyof typeof KOREAN_MOBILE_FONT_SIZES,\n  isMobile: boolean,\n  viewportWidth: number\n): React.CSSProperties {\n  const fontSize = isMobile\n    ? getMobileKoreanFontSize(size, viewportWidth)\n    : KOREAN_MOBILE_FONT_SIZES[size].regular;\n\n  return {\n    fontSize: `${fontSize}px`,\n    lineHeight: isMobile ? \"1.5\" : \"1.4\",\n    letterSpacing: \"0.02em\",\n  };\n}\n\n/**\n * Calculate minimum spacing between interactive elements\n * Ensures adequate spacing for touch accuracy\n * \n * @param isMobile - Whether on mobile device\n * @returns Minimum spacing in pixels\n * \n * @example\n * ```typescript\n * getMinimumInteractiveSpacing(true); // 8px (mobile)\n * getMinimumInteractiveSpacing(false); // 12px (desktop)\n * ```\n * \n * @public\n * @korean 최소상호작용간격얻기\n */\nexport function getMinimumInteractiveSpacing(isMobile: boolean): number {\n  return isMobile\n    ? UI_DIMENSIONS.TOUCH_TARGET_SPACING\n    : SPACING.COMPACT;\n}\n\n/**\n * Viewport detection utilities\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are explicitly supported\n * \n * @category Mobile UI\n * @korean 뷰포트감지\n */\nexport const ViewportDetection = {\n  /**\n   * Check if iPhone SE or similar small device\n   * @korean iPhone SE여부\n   */\n  isSmallMobile: (width: number) => width <= 375,\n\n  /**\n   * Check if standard mobile device (excluding high-end)\n   * @korean 표준모바일여부\n   */\n  isMobile: (width: number) => width < 768,\n\n  /**\n   * Check if high-end mobile device (Super HD, 2K+)\n   * Uses height + DPR to distinguish phones from tablets\n   * High-end phones: short side 400-600px, long side >=800px, DPR >=2\n   * @korean 고급모바일여부\n   */\n  isSuperHDMobile: (width: number, height: number = window.innerHeight) => {\n    const shortSide = Math.min(width, height);\n    const longSide = Math.max(width, height);\n    const dpr = window.devicePixelRatio || 1;\n    return shortSide >= 400 && shortSide <= 600 && longSide >= 800 && dpr >= 2;\n  },\n\n  /**\n   * Check if tablet device\n   * @korean 태블릿여부\n   */\n  isTablet: (width: number) => width >= 768 && width < 1024,\n\n  /**\n   * Check if desktop device\n   * @korean 데스크톱여부\n   */\n  isDesktop: (width: number) => width >= 1024,\n\n  /**\n   * Check if device has notch (iPhone X+)\n   * @korean 노치여부\n   */\n  hasNotch: (width: number, height: number) =>\n    (width === 375 && height === 812) || // iPhone X, XS, 11 Pro\n    (width === 414 && height === 896) || // iPhone XR, XS Max, 11, 11 Pro Max\n    (width === 390 && height === 844) || // iPhone 12, 12 Pro, 13, 13 Pro, 14\n    (width === 393 && height === 852) || // iPhone 14 Pro\n    (width === 428 && height === 926), // iPhone 12/13/14 Pro Max\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA2JA,SAAgB,wBACd,MACA,eACQ;CACR,MAAM,WAAW,kBAAkB,MAAM,cAAc;CAIvD,IAAI,iBAAiB,KACnB,OAAO,KAAK,KAAK,WAAW,IAAI;CAGlC,OAAO"}
+{"version":3,"file":"mobileUIUtils.js","names":[],"sources":["../../src/utils/mobileUIUtils.ts"],"sourcesContent":["/**\n * Mobile UI utilities for responsive touch-optimized interfaces\n * \n * Provides helpers for touch target sizing, responsive font scaling,\n * and mobile-specific layout calculations following iOS/Android guidelines.\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are top priority and get:\n * - Enhanced touch targets (56px vs 48px)\n * - Larger Korean fonts (+10% for better readability)\n * - Optimized spacing and layout\n * - Full feature parity with desktop\n * \n * Supported Devices (Priority Order):\n * 1. Super HD Mobile (≥768px): Motorola Edge 60 Pro, Galaxy S-series\n * 2. Standard Mobile (375-767px): iPhone 12/13/14, standard Android\n * 3. Small Mobile (<375px): iPhone SE, budget devices\n * \n * @module utils/mobileUIUtils\n * @category Mobile Utilities\n * @korean 모바일UI유틸리티\n */\n\nimport { UI_DIMENSIONS, SPACING } from \"../types/constants/ui\";\nimport {\n  KOREAN_MOBILE_FONT_SIZES,\n  getKoreanFontSize,\n} from \"../types/constants/typography\";\n\n/**\n * Viewport size category for responsive design\n * \n * @category Mobile UI\n * @korean 뷰포트크기범주\n */\nexport type ViewportSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\n\n/**\n * Touch target size configuration\n * \n * @category Mobile UI\n * @korean 터치타겟크기설정\n */\nexport interface TouchTargetSize {\n  readonly minWidth: number;\n  readonly minHeight: number;\n  readonly padding: number;\n  readonly spacing: number;\n}\n\n/**\n * Get viewport size category from width\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are treated as 'md' for optimal layout\n * \n * @param width - Viewport width in pixels\n * @returns Viewport size category\n * \n * @korean 뷰포트크기얻기\n */\nexport function getViewportSize(width: number): ViewportSize {\n  if (width < 375) return \"xs\"; // Extra small phones\n  if (width < 768) return \"sm\"; // Standard phones\n  if (width < 1024) return \"md\"; // High-end mobile (Super HD), tablets\n  if (width < 1440) return \"lg\"; // Small desktop\n  return \"xl\"; // Large desktop\n}\n\n/**\n * Get touch-optimized button size configuration\n * Ensures minimum 48px touch targets per iOS/Android guidelines\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) get enhanced touch targets (56px)\n * for better precision on high-resolution displays\n * \n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Optional viewport width for fine-tuning\n * @returns Touch target size configuration\n * \n * @korean 터치타겟크기얻기\n */\nexport function getTouchTargetSize(\n  isMobile: boolean,\n  viewportWidth?: number\n): TouchTargetSize {\n  if (!isMobile) {\n    return {\n      minWidth: 120,\n      minHeight: 44,\n      padding: SPACING.MD,\n      spacing: SPACING.MD,\n    };\n  }\n\n  const width = viewportWidth ?? 375;\n  const isExtraSmall = width < 360;\n  const isSuperHD = width >= 768; // High-end mobile (Motorola Edge 60 Pro, etc.)\n\n  // Super HD devices get enhanced touch targets for better precision\n  if (isSuperHD) {\n    return {\n      minWidth: UI_DIMENSIONS.TOUCH_TARGET_COMFORTABLE,\n      minHeight: UI_DIMENSIONS.TOUCH_TARGET_COMFORTABLE,\n      padding: SPACING.MD,\n      spacing: SPACING.COMPACT,\n    };\n  }\n\n  return {\n    minWidth: UI_DIMENSIONS.TOUCH_TARGET_MIN,\n    minHeight: UI_DIMENSIONS.TOUCH_TARGET_MIN,\n    padding: isExtraSmall ? SPACING.SM : SPACING.COMPACT,\n    spacing: UI_DIMENSIONS.TOUCH_TARGET_SPACING,\n  };\n}\n\n/**\n * Get responsive Korean font size for mobile\n * Ensures minimum 16px for body text on mobile\n * \n * PRIORITY: High-end mobile (Super HD, 2K+) get enhanced font sizes for better readability\n * \n * @param size - Size category ('SMALL', 'MEDIUM', 'LARGE')\n * @param viewportWidth - Viewport width in pixels\n * @returns Font size in pixels\n * \n * @korean 모바일한글글꼴크기얻기\n */\nexport function getMobileKoreanFontSize(\n  size: keyof typeof KOREAN_MOBILE_FONT_SIZES,\n  viewportWidth: number\n): number {\n  const fontSize = getKoreanFontSize(size, viewportWidth);\n  \n  // Super HD mobile devices (≥768px) get enhanced font sizes\n  // for better readability on high-resolution displays\n  if (viewportWidth >= 768) {\n    return Math.ceil(fontSize * 1.1); // 10% larger for Super HD\n  }\n  \n  return fontSize;\n}\n\n/**\n * Get responsive spacing value\n * Scales spacing based on viewport size\n * \n * @param baseSpacing - Base spacing value from SPACING constant\n * @param isMobile - Whether on mobile device\n * @returns Scaled spacing in pixels\n * \n * @korean 반응형간격얻기\n */\nexport function getResponsiveSpacing(\n  baseSpacing: number,\n  isMobile: boolean\n): number {\n  return isMobile ? Math.max(SPACING.SM, baseSpacing * 0.75) : baseSpacing;\n}\n\n/**\n * Calculate responsive panel width\n * Ensures panels fit within viewport with proper margins\n * \n * @param viewportWidth - Viewport width in pixels\n * @param isMobile - Whether on mobile device\n * @param minMargin - Minimum margin on each side (default: 20px)\n * @returns Panel width in pixels\n * \n * @korean 반응형패널폭얻기\n */\nexport function getResponsivePanelWidth(\n  viewportWidth: number,\n  isMobile: boolean,\n  minMargin = 20\n): number {\n  if (!isMobile) {\n    return Math.min(400, viewportWidth - minMargin * 2);\n  }\n\n  // Mobile: use most of screen width\n  return Math.min(viewportWidth - minMargin * 2, 360);\n}\n\n/**\n * Check if viewport is in landscape orientation\n * \n * @param viewportWidth - Viewport width in pixels\n * @param viewportHeight - Viewport height in pixels\n * @returns Whether in landscape orientation\n * \n * @korean 가로모드여부\n */\nexport function isLandscape(\n  viewportWidth: number,\n  viewportHeight: number\n): boolean {\n  return viewportWidth > viewportHeight;\n}\n\n/**\n * Get responsive button styles for touch optimization\n * \n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Optional viewport width\n * @returns CSS properties for button\n * \n * @korean 반응형버튼스타일얻기\n */\nexport function getResponsiveButtonStyles(\n  isMobile: boolean,\n  viewportWidth?: number\n): React.CSSProperties {\n  const touchTarget = getTouchTargetSize(isMobile, viewportWidth);\n  const fontSize = isMobile\n    ? getMobileKoreanFontSize(\"SMALL\", viewportWidth ?? 375)\n    : 16;\n\n  return {\n    minWidth: `${touchTarget.minWidth}px`,\n    minHeight: `${touchTarget.minHeight}px`,\n    padding: `${touchTarget.padding}px`,\n    fontSize: `${fontSize}px`,\n    lineHeight: \"1.4\",\n    cursor: \"pointer\",\n    userSelect: \"none\",\n    WebkitTapHighlightColor: \"transparent\",\n  };\n}\n\n/**\n * Get responsive text styles with proper Korean font sizing\n * \n * @param size - Font size category\n * @param isMobile - Whether on mobile device\n * @param viewportWidth - Viewport width in pixels\n * @returns CSS properties for text\n * \n * @korean 반응형텍스트스타일얻기\n */\nexport function getResponsiveTextStyles(\n  size: keyof typeof KOREAN_MOBILE_FONT_SIZES,\n  isMobile: boolean,\n  viewportWidth: number\n): React.CSSProperties {\n  const fontSize = isMobile\n    ? getMobileKoreanFontSize(size, viewportWidth)\n    : KOREAN_MOBILE_FONT_SIZES[size].regular;\n\n  return {\n    fontSize: `${fontSize}px`,\n    lineHeight: isMobile ? \"1.5\" : \"1.4\",\n    letterSpacing: \"0.02em\",\n  };\n}\n\n/**\n * Calculate minimum spacing between interactive elements\n * Ensures adequate spacing for touch accuracy\n * \n * @param isMobile - Whether on mobile device\n * @returns Minimum spacing in pixels\n * \n * @korean 최소상호작용간격얻기\n */\nexport function getMinimumInteractiveSpacing(isMobile: boolean): number {\n  return isMobile\n    ? UI_DIMENSIONS.TOUCH_TARGET_SPACING\n    : SPACING.COMPACT;\n}\n\n/**\n * Viewport detection utilities\n * \n * PRIORITY: High-end mobile devices (Super HD, 2K+) are explicitly supported\n * \n * @category Mobile UI\n * @korean 뷰포트감지\n */\nexport const ViewportDetection = {\n  /** Check if iPhone SE or similar small device @korean iPhone SE여부 */\n  isSmallMobile: (width: number) => width <= 375,\n\n  /** Check if standard mobile device (excluding high-end) @korean 표준모바일여부 */\n  isMobile: (width: number) => width < 768,\n\n  /**\n   * Check if high-end mobile device (Super HD, 2K+)\n   * Uses height + DPR to distinguish phones from tablets\n   * High-end phones: short side 400-600px, long side >=800px, DPR >=2\n   * @korean 고급모바일여부\n   */\n  isSuperHDMobile: (width: number, height: number = window.innerHeight) => {\n    const shortSide = Math.min(width, height);\n    const longSide = Math.max(width, height);\n    const dpr = window.devicePixelRatio || 1;\n    return shortSide >= 400 && shortSide <= 600 && longSide >= 800 && dpr >= 2;\n  },\n\n  /** Check if tablet device @korean 태블릿여부 */\n  isTablet: (width: number) => width >= 768 && width < 1024,\n\n  /** Check if desktop device @korean 데스크톱여부 */\n  isDesktop: (width: number) => width >= 1024,\n\n  /** Check if device has notch (iPhone X+) @korean 노치여부 */\n  hasNotch: (width: number, height: number) =>\n    (width === 375 && height === 812) || // iPhone X, XS, 11 Pro\n    (width === 414 && height === 896) || // iPhone XR, XS Max, 11, 11 Pro Max\n    (width === 390 && height === 844) || // iPhone 12, 12 Pro, 13, 13 Pro, 14\n    (width === 393 && height === 852) || // iPhone 14 Pro\n    (width === 428 && height === 926), // iPhone 12/13/14 Pro Max\n} as const;\n"],"mappings":";;;;;;;;;;;;;;AA+HA,SAAgB,wBACd,MACA,eACQ;CACR,MAAM,WAAW,kBAAkB,MAAM,cAAc;CAIvD,IAAI,iBAAiB,KACnB,OAAO,KAAK,KAAK,WAAW,IAAI;CAGlC,OAAO"}

package/lib/utils/physicalAttributeValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physicalAttributeValidation.d.ts","sourceRoot":"","sources":["../../src/utils/physicalAttributeValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnE;AAoCD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,CAwIlB;AAUD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,GACxB,IAAI,CA2BN"}
+{"version":3,"file":"physicalAttributeValidation.d.ts","sourceRoot":"","sources":["../../src/utils/physicalAttributeValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnE;AAoCD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,CA8HlB;AAUD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,GACxB,IAAI,CA2BN"}

package/lib/utils/player3DHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player3DHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/player3DHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAgFhC;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,cAAc,GACxB,eAAe,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAoBvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE1C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD,GACL,oBAAoB,CA0CtB"}
+{"version":3,"file":"player3DHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/player3DHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAgFhC;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,cAAc,GACxB,eAAe,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAK7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAiBvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE1C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD,GACL,oBAAoB,CAoCtB"}

package/lib/utils/player3DHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"player3DHelpers.js","names":[],"sources":["../../src/utils/player3DHelpers.ts"],"sourcesContent":["/**\n * Utility functions for Player3D component integration\n *\n * Converts PlayerState from combat system to Player3DUnifiedProps for rendering\n * with SkeletalPlayer3D (28-bone articulated body model).\n *\n * @module utils/player3DHelpers\n * @category Utilities\n * @korean 플레이어3D도우미\n */\n\nimport type { PlayerState } from \"../systems\";\nimport type { AnimationState } from \"../systems/animation/core/types\";\nimport type {\n  BalanceState,\n  Player3DUnifiedProps,\n  PlayerAnimation,\n} from \"../types/player-visual\";\n\n/**\n * Static mapping from AnimationState to PlayerAnimation\n *\n * Stance guard animations map to \"idle\" since SkeletalPlayer3D\n * will handle the stance-specific guard rendering.\n * Tactical steps now use dedicated step animations with guard maintenance.\n *\n * @korean 애니메이션상태맵\n */\nconst ANIMATION_STATE_MAP: Record<AnimationState, PlayerAnimation> = {\n  idle: \"idle\",\n  walk: \"walk\",\n  run: \"run\", // Now uses dedicated RUN_ANIMATION from BasicAnimations\n  attack: \"attack\",\n  defend: \"defend\",\n  // Defensive animations (방어 애니메이션) - map to defend with variations handled by skeletal system\n  defend_block_success: \"defend\",\n  defend_parry: \"defend\",\n  defend_guard_break: \"defend\",\n  defend_recovery: \"defend\",\n  hit: \"hit\",\n  stance_change: \"stance_change\",\n  stance_side_switch: \"stance_change\", // Map to stance_change animation (mirroring guard)\n  ko: \"death\", // Map ko to death\n  // Stance guard animations map to stance-specific idle animations with proper biomechanics\n  stance_guard_geon: \"stance_geon\",\n  stance_guard_tae: \"stance_tae\",\n  stance_guard_li: \"stance_li\",\n  stance_guard_jin: \"stance_jin\",\n  stance_guard_son: \"stance_son\",\n  stance_guard_gam: \"stance_gam\",\n  stance_guard_gan: \"stance_gan\",\n  stance_guard_gon: \"stance_gon\",\n  // Tactical step animations now map to dedicated step animations\n  step_forward: \"step_forward\",\n  step_back: \"step_back\",\n  step_left: \"step_left\",\n  step_right: \"step_right\",\n  step_forward_left: \"step_forward_left\",\n  step_forward_right: \"step_forward_right\",\n  step_back_left: \"step_back_left\",\n  step_back_right: \"step_back_right\",\n  // Fall animations: Now using dedicated FALL_*_ANIMATION from BasicAnimations\n  fall_forward: \"fall_forward\",\n  fall_backward: \"fall_backward\",\n  fall_side_left: \"fall_side_left\",\n  fall_side_right: \"fall_side_right\",\n  // Ground states map to idle with minimal movement\n  ground_prone: \"idle\",\n  ground_supine: \"idle\",\n  ground_side_left: \"idle\",\n  ground_side_right: \"idle\",\n  // 180-degree turn animations map to stance_change (body pivot animation)\n  turn_left: \"stance_change\",\n  turn_right: \"stance_change\",\n  // Footwork patterns (보법) - Korean martial arts specialized footwork\n  footwork_circular_left: \"walk\", // Lateral movement\n  footwork_circular_right: \"walk\",\n  footwork_pivot_left: \"walk\", // Rotation movement\n  footwork_pivot_right: \"walk\",\n  footwork_slide_forward: \"walk\", // Sliding movement\n  footwork_slide_back: \"walk\",\n  footwork_slide_left: \"walk\",\n  footwork_slide_right: \"walk\",\n  footwork_shuffle: \"walk\", // Quick adjustment\n  // Recovery animations (기상 애니메이션) - Getting up from ground states\n  // Map to idle for now, custom 3D recovery animations will be added in future\n  recovery_prone_standup: \"idle\",\n  recovery_supine_standup: \"idle\",\n  recovery_roll: \"walk\", // Rolling motion approximated by walk\n  recovery_defensive: \"defend\", // Guarded getup approximated by defend\n  // Grappling animations (잡기 애니메이션) - map to attack/defend based on action\n  grapple_entry: \"attack\", // Initiating grab uses attack animation\n  grapple_control: \"defend\", // Maintaining control uses defensive stance\n  grapple_struggle: \"hit\", // Struggling escape uses hit reaction\n  grapple_escape: \"attack\", // Successful escape uses attack burst\n};\n\n/**\n * Convert AnimationState to PlayerAnimation\n *\n * Maps the animation system's state types to SkeletalPlayer3D's animation types.\n *\n * @param animState - Animation state from the animation system\n * @returns Corresponding PlayerAnimation type\n * @korean 애니메이션상태변환\n */\nexport function animationStateToPlayerAnimation(\n  animState: AnimationState\n): PlayerAnimation {\n  return ANIMATION_STATE_MAP[animState];\n}\n\n/**\n * Convert balance number (0-100) to BalanceState enum\n *\n * @param balance - Balance value from PlayerState (0-100)\n * @returns BalanceState enum value\n * @korean 균형상태변환\n */\nexport function getBalanceState(balance: number): BalanceState {\n  if (balance >= 80) return \"READY\";\n  if (balance >= 50) return \"SHAKEN\";\n  if (balance >= 20) return \"VULNERABLE\";\n  return \"HELPLESS\";\n}\n\n/**\n * Get current animation state from PlayerState\n *\n * Returns stance-specific idle animations when player is in idle/recovering state.\n * This ensures each trigram stance displays the correct guard pose with proper\n * leg positioning and breathing animation.\n *\n * @param player - Current player state\n * @returns PlayerAnimation enum value (stance-specific for idle states)\n * @korean 애니메이션상태가져오기\n */\nexport function getPlayerAnimation(player: PlayerState): PlayerAnimation {\n  if (player.isStunned) return \"hit\";\n  if (player.isBlocking) return \"defend\";\n  if (player.isCountering) return \"counter\";\n\n  // Check combat state (CombatState enum values are lowercase strings)\n  switch (player.combatState) {\n    case \"attacking\":\n      return \"attack\";\n    case \"defending\":\n      return \"defend\";\n    case \"stunned\":\n      return \"hit\";\n    case \"recovering\":\n    case \"idle\":\n    default:\n      // Use stance-specific idle animation for proper guard pose\n      // This ensures correct leg positioning for each trigram stance\n      return `stance_${player.currentStance}` as PlayerAnimation;\n  }\n}\n\n/**\n * Converts PlayerState to Player3DUnifiedProps for visual rendering.\n *\n * Note: This function converts base PlayerState properties used in combat.\n * Training-specific stats (misses, accuracy, comboCount) are optional in PlayerState\n * and handled separately in training contexts.\n *\n * @param player - The player state to convert\n * @param position - 3D position [x, y, z]\n * @param rotation - Rotation in radians\n * @param options - Display and behavior options\n * @returns Props for SkeletalPlayer3D component (28-bone articulated body model)\n * @korean 플레이어상태변환\n *\n * @example\n * ```tsx\n * const playerProps = convertPlayerStateToProps(\n *   playerState,\n *   [-3, 0, 0],\n *   0,\n *   { isMobile: false, showVitalPoints: false }\n * );\n *\n * <SkeletalPlayer3D {...playerProps} />\n * ```\n */\nexport function convertPlayerStateToProps(\n  player: PlayerState,\n  position: [number, number, number],\n  rotation: number,\n  options: {\n    readonly isMobile?: boolean;\n    readonly facing?: \"left\" | \"right\";\n    readonly scale?: number;\n    readonly showDetails?: boolean;\n    readonly showHealthBar?: boolean;\n    readonly showStanceIndicator?: boolean;\n    readonly onAnimationComplete?: () => void;\n    // Facial expression options - 얼굴 표정 옵션\n    readonly enableFacialExpressions?: boolean;\n    readonly enableEyeTracking?: boolean;\n    readonly opponentPosition?: [number, number, number];\n  } = {}\n): Player3DUnifiedProps {\n  return {\n    playerId: player.id,\n    archetype: player.archetype,\n    stance: player.currentStance,\n    position,\n    rotation,\n\n    // Health and resources\n    health: player.health,\n    maxHealth: player.maxHealth,\n    stamina: player.stamina,\n    ki: player.ki,\n\n    // Combat states\n    pain: player.pain,\n    balance: getBalanceState(player.balance),\n    consciousness: player.consciousness,\n\n    // Combat flags\n    isBlocking: player.isBlocking,\n    isStunned: player.isStunned,\n    isCountering: player.isCountering,\n\n    // Animation (derived from combat state)\n    currentAnimation: getPlayerAnimation(player),\n\n    // Display options\n    name: player.name,\n    isMobile: options.isMobile ?? false,\n    facing: options.facing ?? \"right\",\n    scale: options.scale ?? 1,\n    showDetails: options.showDetails,\n    showHealthBar: options.showHealthBar,\n    showStanceIndicator: options.showStanceIndicator,\n    onAnimationComplete: options.onAnimationComplete,\n\n    // Facial expression options - 얼굴 표정 옵션\n    enableFacialExpressions: options.enableFacialExpressions ?? false,\n    enableEyeTracking: options.enableEyeTracking ?? true,\n    opponentPosition: options.opponentPosition,\n  };\n}\n"],"mappings":";;;;;;;;;;AA4BA,IAAM,sBAA+D;CACnE,MAAM;CACN,MAAM;CACN,KAAK;CACL,QAAQ;CACR,QAAQ;CAER,sBAAsB;CACtB,cAAc;CACd,oBAAoB;CACpB,iBAAiB;CACjB,KAAK;CACL,eAAe;CACf,oBAAoB;CACpB,IAAI;CAEJ,mBAAmB;CACnB,kBAAkB;CAClB,iBAAiB;CACjB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAElB,cAAc;CACd,WAAW;CACX,WAAW;CACX,YAAY;CACZ,mBAAmB;CACnB,oBAAoB;CACpB,gBAAgB;CAChB,iBAAiB;CAEjB,cAAc;CACd,eAAe;CACf,gBAAgB;CAChB,iBAAiB;CAEjB,cAAc;CACd,eAAe;CACf,kBAAkB;CAClB,mBAAmB;CAEnB,WAAW;CACX,YAAY;CAEZ,wBAAwB;CACxB,yBAAyB;CACzB,qBAAqB;CACrB,sBAAsB;CACtB,wBAAwB;CACxB,qBAAqB;CACrB,qBAAqB;CACrB,sBAAsB;CACtB,kBAAkB;CAGlB,wBAAwB;CACxB,yBAAyB;CACzB,eAAe;CACf,oBAAoB;CAEpB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;CACjB;;;;;;;;;;AAWD,SAAgB,gCACd,WACiB;CACjB,OAAO,oBAAoB;;;;;;;;;AAU7B,SAAgB,gBAAgB,SAA+B;CAC7D,IAAI,WAAW,IAAI,OAAO;CAC1B,IAAI,WAAW,IAAI,OAAO;CAC1B,IAAI,WAAW,IAAI,OAAO;CAC1B,OAAO;;;;;;;;;;;;;AAcT,SAAgB,mBAAmB,QAAsC;CACvE,IAAI,OAAO,WAAW,OAAO;CAC7B,IAAI,OAAO,YAAY,OAAO;CAC9B,IAAI,OAAO,cAAc,OAAO;CAGhC,QAAQ,OAAO,aAAf;EACE,KAAK,aACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,WACH,OAAO;EAGT,SAGE,OAAO,UAAU,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B9B,SAAgB,0BACd,QACA,UACA,UACA,UAYI,EAAE,EACgB;CACtB,OAAO;EACL,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf;EACA;EAGA,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,IAAI,OAAO;EAGX,MAAM,OAAO;EACb,SAAS,gBAAgB,OAAO,QAAQ;EACxC,eAAe,OAAO;EAGtB,YAAY,OAAO;EACnB,WAAW,OAAO;EAClB,cAAc,OAAO;EAGrB,kBAAkB,mBAAmB,OAAO;EAG5C,MAAM,OAAO;EACb,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,OAAO,QAAQ,SAAS;EACxB,aAAa,QAAQ;EACrB,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B,qBAAqB,QAAQ;EAG7B,yBAAyB,QAAQ,2BAA2B;EAC5D,mBAAmB,QAAQ,qBAAqB;EAChD,kBAAkB,QAAQ;EAC3B"}
+{"version":3,"file":"player3DHelpers.js","names":[],"sources":["../../src/utils/player3DHelpers.ts"],"sourcesContent":["/**\n * Utility functions for Player3D component integration\n *\n * Converts PlayerState from combat system to Player3DUnifiedProps for rendering\n * with SkeletalPlayer3D (28-bone articulated body model).\n *\n * @module utils/player3DHelpers\n * @category Utilities\n * @korean 플레이어3D도우미\n */\n\nimport type { PlayerState } from \"../systems\";\nimport type { AnimationState } from \"../systems/animation/core/types\";\nimport type {\n  BalanceState,\n  Player3DUnifiedProps,\n  PlayerAnimation,\n} from \"../types/player-visual\";\n\n/**\n * Static mapping from AnimationState to PlayerAnimation\n *\n * Stance guard animations map to \"idle\" since SkeletalPlayer3D\n * will handle the stance-specific guard rendering.\n * Tactical steps now use dedicated step animations with guard maintenance.\n *\n * @korean 애니메이션상태맵\n */\nconst ANIMATION_STATE_MAP: Record<AnimationState, PlayerAnimation> = {\n  idle: \"idle\",\n  walk: \"walk\",\n  run: \"run\", // Now uses dedicated RUN_ANIMATION from BasicAnimations\n  attack: \"attack\",\n  defend: \"defend\",\n  // Defensive animations (방어 애니메이션) - map to defend with variations handled by skeletal system\n  defend_block_success: \"defend\",\n  defend_parry: \"defend\",\n  defend_guard_break: \"defend\",\n  defend_recovery: \"defend\",\n  hit: \"hit\",\n  stance_change: \"stance_change\",\n  stance_side_switch: \"stance_change\", // Map to stance_change animation (mirroring guard)\n  ko: \"death\", // Map ko to death\n  // Stance guard animations map to stance-specific idle animations with proper biomechanics\n  stance_guard_geon: \"stance_geon\",\n  stance_guard_tae: \"stance_tae\",\n  stance_guard_li: \"stance_li\",\n  stance_guard_jin: \"stance_jin\",\n  stance_guard_son: \"stance_son\",\n  stance_guard_gam: \"stance_gam\",\n  stance_guard_gan: \"stance_gan\",\n  stance_guard_gon: \"stance_gon\",\n  // Tactical step animations now map to dedicated step animations\n  step_forward: \"step_forward\",\n  step_back: \"step_back\",\n  step_left: \"step_left\",\n  step_right: \"step_right\",\n  step_forward_left: \"step_forward_left\",\n  step_forward_right: \"step_forward_right\",\n  step_back_left: \"step_back_left\",\n  step_back_right: \"step_back_right\",\n  // Fall animations: Now using dedicated FALL_*_ANIMATION from BasicAnimations\n  fall_forward: \"fall_forward\",\n  fall_backward: \"fall_backward\",\n  fall_side_left: \"fall_side_left\",\n  fall_side_right: \"fall_side_right\",\n  // Ground states map to idle with minimal movement\n  ground_prone: \"idle\",\n  ground_supine: \"idle\",\n  ground_side_left: \"idle\",\n  ground_side_right: \"idle\",\n  // 180-degree turn animations map to stance_change (body pivot animation)\n  turn_left: \"stance_change\",\n  turn_right: \"stance_change\",\n  // Footwork patterns (보법) - Korean martial arts specialized footwork\n  footwork_circular_left: \"walk\", // Lateral movement\n  footwork_circular_right: \"walk\",\n  footwork_pivot_left: \"walk\", // Rotation movement\n  footwork_pivot_right: \"walk\",\n  footwork_slide_forward: \"walk\", // Sliding movement\n  footwork_slide_back: \"walk\",\n  footwork_slide_left: \"walk\",\n  footwork_slide_right: \"walk\",\n  footwork_shuffle: \"walk\", // Quick adjustment\n  // Recovery animations (기상 애니메이션) - Getting up from ground states\n  // Map to idle for now, custom 3D recovery animations will be added in future\n  recovery_prone_standup: \"idle\",\n  recovery_supine_standup: \"idle\",\n  recovery_roll: \"walk\", // Rolling motion approximated by walk\n  recovery_defensive: \"defend\", // Guarded getup approximated by defend\n  // Grappling animations (잡기 애니메이션) - map to attack/defend based on action\n  grapple_entry: \"attack\", // Initiating grab uses attack animation\n  grapple_control: \"defend\", // Maintaining control uses defensive stance\n  grapple_struggle: \"hit\", // Struggling escape uses hit reaction\n  grapple_escape: \"attack\", // Successful escape uses attack burst\n};\n\n/**\n * Convert AnimationState to PlayerAnimation\n *\n * Maps the animation system's state types to SkeletalPlayer3D's animation types.\n *\n * @param animState - Animation state from the animation system\n * @returns Corresponding PlayerAnimation type\n * @korean 애니메이션상태변환\n */\nexport function animationStateToPlayerAnimation(\n  animState: AnimationState\n): PlayerAnimation {\n  return ANIMATION_STATE_MAP[animState];\n}\n\n/**\n * Convert balance number (0-100) to BalanceState enum\n *\n * @param balance - Balance value from PlayerState (0-100)\n * @returns BalanceState enum value\n * @korean 균형상태변환\n */\nexport function getBalanceState(balance: number): BalanceState {\n  if (balance >= 80) return \"READY\";\n  if (balance >= 50) return \"SHAKEN\";\n  if (balance >= 20) return \"VULNERABLE\";\n  return \"HELPLESS\";\n}\n\n/**\n * Get current animation state from PlayerState\n *\n * Returns stance-specific idle animations when player is in idle/recovering state.\n * This ensures each trigram stance displays the correct guard pose with proper\n * leg positioning and breathing animation.\n *\n * @param player - Current player state\n * @returns PlayerAnimation enum value (stance-specific for idle states)\n * @korean 애니메이션상태가져오기\n */\nexport function getPlayerAnimation(player: PlayerState): PlayerAnimation {\n  if (player.isStunned) return \"hit\";\n  if (player.isBlocking) return \"defend\";\n  if (player.isCountering) return \"counter\";\n\n  switch (player.combatState) {\n    case \"attacking\":\n      return \"attack\";\n    case \"defending\":\n      return \"defend\";\n    case \"stunned\":\n      return \"hit\";\n    case \"recovering\":\n    case \"idle\":\n    default:\n      return `stance_${player.currentStance}` as PlayerAnimation;\n  }\n}\n\n/**\n * Converts PlayerState to Player3DUnifiedProps for visual rendering.\n *\n * Note: This function converts base PlayerState properties used in combat.\n * Training-specific stats (misses, accuracy, comboCount) are optional in PlayerState\n * and handled separately in training contexts.\n *\n * @param player - The player state to convert\n * @param position - 3D position [x, y, z]\n * @param rotation - Rotation in radians\n * @param options - Display and behavior options\n * @returns Props for SkeletalPlayer3D component (28-bone articulated body model)\n * @korean 플레이어상태변환\n *\n * @example\n * ```tsx\n * const playerProps = convertPlayerStateToProps(\n *   playerState,\n *   [-3, 0, 0],\n *   0,\n *   { isMobile: false, showVitalPoints: false }\n * );\n *\n * <SkeletalPlayer3D {...playerProps} />\n * ```\n */\nexport function convertPlayerStateToProps(\n  player: PlayerState,\n  position: [number, number, number],\n  rotation: number,\n  options: {\n    readonly isMobile?: boolean;\n    readonly facing?: \"left\" | \"right\";\n    readonly scale?: number;\n    readonly showDetails?: boolean;\n    readonly showHealthBar?: boolean;\n    readonly showStanceIndicator?: boolean;\n    readonly onAnimationComplete?: () => void;\n    // Facial expression options - 얼굴 표정 옵션\n    readonly enableFacialExpressions?: boolean;\n    readonly enableEyeTracking?: boolean;\n    readonly opponentPosition?: [number, number, number];\n  } = {}\n): Player3DUnifiedProps {\n  return {\n    playerId: player.id,\n    archetype: player.archetype,\n    stance: player.currentStance,\n    position,\n    rotation,\n\n    health: player.health,\n    maxHealth: player.maxHealth,\n    stamina: player.stamina,\n    ki: player.ki,\n\n    pain: player.pain,\n    balance: getBalanceState(player.balance),\n    consciousness: player.consciousness,\n\n    isBlocking: player.isBlocking,\n    isStunned: player.isStunned,\n    isCountering: player.isCountering,\n\n    currentAnimation: getPlayerAnimation(player),\n\n    name: player.name,\n    isMobile: options.isMobile ?? false,\n    facing: options.facing ?? \"right\",\n    scale: options.scale ?? 1,\n    showDetails: options.showDetails,\n    showHealthBar: options.showHealthBar,\n    showStanceIndicator: options.showStanceIndicator,\n    onAnimationComplete: options.onAnimationComplete,\n\n    enableFacialExpressions: options.enableFacialExpressions ?? false,\n    enableEyeTracking: options.enableEyeTracking ?? true,\n    opponentPosition: options.opponentPosition,\n  };\n}\n"],"mappings":";;;;;;;;;;AA4BA,IAAM,sBAA+D;CACnE,MAAM;CACN,MAAM;CACN,KAAK;CACL,QAAQ;CACR,QAAQ;CAER,sBAAsB;CACtB,cAAc;CACd,oBAAoB;CACpB,iBAAiB;CACjB,KAAK;CACL,eAAe;CACf,oBAAoB;CACpB,IAAI;CAEJ,mBAAmB;CACnB,kBAAkB;CAClB,iBAAiB;CACjB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAClB,kBAAkB;CAElB,cAAc;CACd,WAAW;CACX,WAAW;CACX,YAAY;CACZ,mBAAmB;CACnB,oBAAoB;CACpB,gBAAgB;CAChB,iBAAiB;CAEjB,cAAc;CACd,eAAe;CACf,gBAAgB;CAChB,iBAAiB;CAEjB,cAAc;CACd,eAAe;CACf,kBAAkB;CAClB,mBAAmB;CAEnB,WAAW;CACX,YAAY;CAEZ,wBAAwB;CACxB,yBAAyB;CACzB,qBAAqB;CACrB,sBAAsB;CACtB,wBAAwB;CACxB,qBAAqB;CACrB,qBAAqB;CACrB,sBAAsB;CACtB,kBAAkB;CAGlB,wBAAwB;CACxB,yBAAyB;CACzB,eAAe;CACf,oBAAoB;CAEpB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;CACjB;;;;;;;;;;AAWD,SAAgB,gCACd,WACiB;CACjB,OAAO,oBAAoB;;;;;;;;;AAU7B,SAAgB,gBAAgB,SAA+B;CAC7D,IAAI,WAAW,IAAI,OAAO;CAC1B,IAAI,WAAW,IAAI,OAAO;CAC1B,IAAI,WAAW,IAAI,OAAO;CAC1B,OAAO;;;;;;;;;;;;;AAcT,SAAgB,mBAAmB,QAAsC;CACvE,IAAI,OAAO,WAAW,OAAO;CAC7B,IAAI,OAAO,YAAY,OAAO;CAC9B,IAAI,OAAO,cAAc,OAAO;CAEhC,QAAQ,OAAO,aAAf;EACE,KAAK,aACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,WACH,OAAO;EAGT,SACE,OAAO,UAAU,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B9B,SAAgB,0BACd,QACA,UACA,UACA,UAYI,EAAE,EACgB;CACtB,OAAO;EACL,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf;EACA;EAEA,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,IAAI,OAAO;EAEX,MAAM,OAAO;EACb,SAAS,gBAAgB,OAAO,QAAQ;EACxC,eAAe,OAAO;EAEtB,YAAY,OAAO;EACnB,WAAW,OAAO;EAClB,cAAc,OAAO;EAErB,kBAAkB,mBAAmB,OAAO;EAE5C,MAAM,OAAO;EACb,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ,UAAU;EAC1B,OAAO,QAAQ,SAAS;EACxB,aAAa,QAAQ;EACrB,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B,qBAAqB,QAAQ;EAE7B,yBAAyB,QAAQ,2BAA2B;EAC5D,mBAAmB,QAAQ,qBAAqB;EAChD,kBAAkB,QAAQ;EAC3B"}