blacktrigram 0.7.44 → 0.7.45

package/lib/types/player-visual.d.ts

@@ -16,7 +16,6 @@ import type { FacialDamageState, FacialExpression } from "./facial";
  * Balance state representing player stability in combat.
  * Drives visual indicators and affects combat effectiveness.
  *
- * @public
  * @category Combat States
  * @korean 균형상태
  */
@@ -24,7 +23,6 @@ export type BalanceState = "READY" | "SHAKEN" | "VULNERABLE" | "HELPLESS";
 /**
  * Player animation states for 3D model pose and movement.
  *
- * @public
  * @category Animation
  * @korean 애니메이션상태
  */
@@ -35,265 +33,123 @@ export type PlayerAnimation = "idle" | "attack" | "defend" | "hit" | "stance_cha
  * This interface provides all properties needed to render a player
  * in both combat and training contexts with full state visualization.
  *
- * @public
  * @category Component Props
  * @korean 플레이어3D속성
  */
 export interface Player3DUnifiedProps {
-    /**
-     * Unique identifier for the player
-     * @korean 플레이어ID
-     */
+    /** Unique identifier for the player @korean 플레이어ID */
     readonly playerId: string;
-    /**
-     * Player archetype determining visual style and theming
-     * @korean 원형
-     */
+    /** Player archetype determining visual style and theming @korean 원형 */
     readonly archetype: PlayerArchetype;
-    /**
-     * Current trigram stance (1 of 8)
-     * @korean 현재자세
-     */
+    /** Current trigram stance (1 of 8) @korean 현재자세 */
     readonly stance: TrigramStance;
     /**
      * Stance laterality (left or right foot forward)
-     *
      * - "left": Left foot forward (왼발서기 - Oenbal Seogi)
      * - "right": Right foot forward (오른발서기 - Oreun Bal Seogi)
-     *
-     * This affects animation mirroring - techniques will be mirrored
-     * appropriately based on the laterality, creating 16 distinct stance
-     * configurations (8 trigrams × 2 laterality).
-     *
-     * **Korean**: 측면성 (Cheugmyeonseong - Laterality/Sidedness)
+     * @korean 측면성
      */
     readonly laterality?: "left" | "right";
-    /**
-     * 3D world position [x, y, z]
-     * @korean 위치
-     */
+    /** 3D world position [x, y, z] @korean 위치 */
     readonly position: [number, number, number];
-    /**
-     * Rotation in radians (Y-axis)
-     * @korean 회전
-     */
+    /** Rotation in radians (Y-axis) @korean 회전 */
     readonly rotation: number;
-    /**
-     * Current health points (0-maxHealth)
-     * @korean 건강
-     */
+    /** Current health points (0-maxHealth) @korean 건강 */
     readonly health: number;
-    /**
-     * Maximum health points
-     * @korean 최대건강
-     */
+    /** Maximum health points @korean 최대건강 */
     readonly maxHealth: number;
-    /**
-     * Current stamina points (0-100)
-     * @korean 체력
-     */
+    /** Current stamina points (0-100) @korean 체력 */
     readonly stamina: number;
-    /**
-     * Current Ki/energy points (0-100)
-     * @korean 기
-     */
+    /** Current Ki/energy points (0-100) @korean 기 */
     readonly ki: number;
-    /**
-     * Pain level affecting balance and performance (0-100)
-     * @korean 통증
-     */
+    /** Pain level affecting balance and performance (0-100) @korean 통증 */
     readonly pain: number;
-    /**
-     * Balance/stability state in combat
-     * @korean 균형상태
-     */
+    /** Balance/stability state in combat @korean 균형상태 */
     readonly balance: BalanceState;
-    /**
-     * Consciousness level (0-100)
-     * @korean 의식
-     */
+    /** Consciousness level (0-100) @korean 의식 */
     readonly consciousness: number;
-    /**
-     * Blood loss amount (0-100)
-     * Optional since not all game modes track blood loss
-     * @korean 출혈
-     */
+    /** Blood loss amount (0-100) @korean 출혈 */
     readonly bloodLoss?: number;
-    /**
-     * Whether player is currently blocking
-     * @korean 방어중
-     */
+    /** Whether player is currently blocking @korean 방어중 */
     readonly isBlocking: boolean;
-    /**
-     * Whether player is stunned
-     * @korean 기절
-     */
+    /** Whether player is stunned @korean 기절 */
     readonly isStunned?: boolean;
-    /**
-     * Whether player is countering
-     * @korean 반격중
-     */
+    /** Whether player is countering @korean 반격중 */
     readonly isCountering?: boolean;
-    /**
-     * Current animation state
-     * @korean 현재애니메이션
-     */
+    /** Current animation state @korean 현재애니메이션 */
     readonly currentAnimation: PlayerAnimation;
-    /**
-     * Whether rendering for mobile device (affects scaling and detail)
-     * @korean 모바일여부
-     */
+    /** Whether rendering for mobile device @korean 모바일여부 */
     readonly isMobile: boolean;
-    /**
-     * Player display name (Korean and English)
-     * @korean 이름
-     */
+    /** Player display name (Korean and English) @korean 이름 */
     readonly name?: {
         readonly korean: string;
         readonly english: string;
     };
-    /**
-     * Scale multiplier for the model (default: 1)
-     * @korean 크기
-     */
+    /** Scale multiplier for the model (default: 1) @korean 크기 */
     readonly scale?: number;
-    /**
-     * Whether to show Html overlay with stats
-     * @korean 세부정보표시
-     */
+    /** Whether to show Html overlay with stats @korean 세부정보표시 */
     readonly showDetails?: boolean;
-    /**
-     * Direction the player is facing
-     * @korean 방향
-     */
+    /** Direction the player is facing @korean 방향 */
     readonly facing?: "left" | "right";
-    /**
-     * Whether to show health bar
-     * @korean 체력바표시
-     */
+    /** Whether to show health bar @korean 체력바표시 */
     readonly showHealthBar?: boolean;
-    /**
-     * Whether to show stance indicator
-     * @korean 자세표시기표시
-     */
+    /** Whether to show stance indicator @korean 자세표시기표시 */
     readonly showStanceIndicator?: boolean;
-    /**
-     * Callback when animation completes
-     * @korean 애니메이션완료콜백
-     */
+    /** Callback when animation completes @korean 애니메이션완료콜백 */
     readonly onAnimationComplete?: () => void;
-    /**
-     * Current facial expression (optional, auto-calculated if not provided)
-     * @korean 얼굴표정
-     */
+    /** Current facial expression @korean 얼굴표정 */
     readonly facialExpression?: FacialExpression;
-    /**
-     * Facial damage state (optional, defaults to no damage)
-     * @korean 얼굴손상
-     */
+    /** Facial damage state @korean 얼굴손상 */
     readonly facialDamage?: FacialDamageState;
-    /**
-     * Whether to enable facial expressions (opt-in, default: false)
-     * @korean 표정사용
-     */
+    /** Whether to enable facial expressions @korean 표정사용 */
     readonly enableFacialExpressions?: boolean;
-    /**
-     * Whether to enable eye tracking (opt-in, default: false)
-     * @korean 눈추적사용
-     */
+    /** Whether to enable eye tracking @korean 눈추적사용 */
     readonly enableEyeTracking?: boolean;
-    /**
-     * Opponent position for eye tracking (optional)
-     * @korean 상대위치
-     */
+    /** Opponent position for eye tracking @korean 상대위치 */
     readonly opponentPosition?: [number, number, number];
-    /**
-     * Body facing state for automatic opponent tracking (optional)
-     * @korean 몸향하기상태
-     */
+    /** Body facing state for automatic opponent tracking @korean 몸향하기상태 */
     readonly bodyFacing?: BodyFacing;
-    /**
-     * Callback to update body facing state
-     * @korean 몸향하기업데이트콜백
-     */
+    /** Callback to update body facing state @korean 몸향하기업데이트콜백 */
     readonly onBodyFacingUpdate?: (bodyFacing: BodyFacing) => void;
 }
 /**
  * Props for PlayerStateIndicators component (Html overlay)
  *
- * @public
  * @category Component Props
  * @korean 상태표시기속성
  */
 export interface PlayerStateIndicatorsProps {
-    /**
-     * Current health (0-maxHealth)
-     * @korean 건강
-     */
+    /** Current health (0-maxHealth) @korean 건강 */
     readonly health: number;
-    /**
-     * Maximum health
-     * @korean 최대건강
-     */
+    /** Maximum health @korean 최대건강 */
     readonly maxHealth: number;
-    /**
-     * Current stamina (0-100)
-     * @korean 체력
-     */
+    /** Current stamina (0-100) @korean 체력 */
     readonly stamina: number;
-    /**
-     * Current Ki (0-100)
-     * @korean 기
-     */
+    /** Current Ki (0-100) @korean 기 */
     readonly ki: number;
-    /**
-     * Balance state
-     * @korean 균형상태
-     */
+    /** Balance state @korean 균형상태 */
     readonly balance: BalanceState;
-    /**
-     * Consciousness level (0-100)
-     * @korean 의식
-     */
+    /** Consciousness level (0-100) @korean 의식 */
     readonly consciousness: number;
-    /**
-     * Pain level (0-100)
-     * @korean 통증
-     */
+    /** Pain level (0-100) @korean 통증 */
     readonly pain?: number;
-    /**
-     * Blood loss (0-100)
-     * @korean 출혈
-     */
+    /** Blood loss (0-100) @korean 출혈 */
     readonly bloodLoss?: number;
-    /**
-     * Mobile responsive mode
-     * @korean 모바일여부
-     */
+    /** Mobile responsive mode @korean 모바일여부 */
     readonly isMobile: boolean;
 }
 /**
  * Props for StanceAura component (3D effect)
  *
- * @public
  * @category Component Props
  * @korean 자세오라속성
  */
 export interface StanceAuraProps {
-    /**
-     * Current trigram stance
-     * @korean 자세
-     */
+    /** Current trigram stance @korean 자세 */
     readonly stance: TrigramStance;
-    /**
-     * Aura intensity (0-1, typically Ki / 100)
-     * @korean 강도
-     */
+    /** Aura intensity (0-1, typically Ki / 100) @korean 강도 */
     readonly intensity: number;
-    /**
-     * Whether to animate the aura
-     * @korean 애니메이션여부
-     */
+    /** Whether to animate the aura @korean 애니메이션여부 */
     readonly animated?: boolean;
 }
 //# sourceMappingURL=player-visual.d.ts.map

package/lib/types/player-visual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-visual.d.ts","sourceRoot":"","sources":["../../src/types/player-visual.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"player-visual.d.ts","sourceRoot":"","sources":["../../src/types/player-visual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,eAAe,GACf,mBAAmB,GACnB,MAAM,GACN,KAAK,GACL,OAAO,GACP,SAAS,GACT,OAAO,GAEP,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,WAAW,GACX,WAAW,GACX,YAAY,GACZ,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GAEjB,aAAa,GACb,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAEjB;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAC3C,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,uCAAuC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAC1C,wDAAwD;IACxD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAChE;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/lib/types/technique.d.ts

@@ -21,7 +21,6 @@ import { TechniqueAnimationConfig } from "./skeletal";
  * No overlap with movement keys (W, A, S, D) or browser shortcuts.
  * Supports up to 10 techniques with keyboard shortcuts.
  *
- * @public
  * @category Combat System
  */
 export type TechniqueKey = "Q" | "E" | "R" | "T" | "Y" | "F" | "G" | "Z" | "X" | "C";
@@ -39,6 +38,7 @@ export type TechniqueKey = "Q" | "E" | "R" | "T" | "Y" | "F" | "G" | "Z" | "X" |
  * const thunderStrike: Technique = {
  *   id: "musa_thunder_strike",
  *   name: {
+
  *     korean: "천둥벽력",
  *     english: "Thunder Strike"
  *   },
@@ -56,7 +56,6 @@ export type TechniqueKey = "Q" | "E" | "R" | "T" | "Y" | "F" | "G" | "Z" | "X" |
  * };
  * ```
  *
- * @public
  * @category Combat System
  * @korean 기술
  */
@@ -119,7 +118,6 @@ export interface Technique {
 /**
  * Technique cooldown state tracking.
  *
- * @public
  * @category Combat System
  */
 export interface TechniqueCooldown {
@@ -137,7 +135,6 @@ export interface TechniqueCooldown {
  *
  * Tracks available techniques, cooldowns, and current selection.
  *
- * @public
  * @category Combat System
  */
 export interface TechniqueSelection {
@@ -153,7 +150,6 @@ export interface TechniqueSelection {
 /**
  * Result of technique execution validation.
  *
- * @public
  * @category Combat System
  */
 export interface TechniqueValidation {

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

@@ -1 +1 @@
-{"version":3,"file":"technique.d.ts","sourceRoot":"","sources":["../../src/types/technique.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"technique.d.ts","sourceRoot":"","sources":["../../src/types/technique.ts"],"names":[],"mappings":"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"}

package/lib/types/techniqueId.d.ts

@@ -20,7 +20,6 @@
  * - 정보요원 (Jeongbo) - 5 techniques: jeongbo_tactical_strike, jeongbo_counter_intelligence, jeongbo_psychological_warfare, jeongbo_precision_takedown, jeongbo_intelligence_strike
  * - 조직폭력배 (Jojik) - 4 techniques: jojik_street_brawl, jojik_improvised_weapon, jojik_ruthless_assault, jojik_brutal_takedown
  *
- * @public
  * @category Combat System
  * @korean 기술ID열거형
  */

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

@@ -1 +1 @@
-{"version":3,"file":"techniqueId.d.ts","sourceRoot":"","sources":["../../src/types/techniqueId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;GAaG;AACH,oBAAY,WAAW;IAErB,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAG/C,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,oBAAoB,yBAAyB;IAG7C,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAG3C,uBAAuB,4BAA4B;IACnD,4BAA4B,iCAAiC;IAC7D,6BAA6B,kCAAkC;IAC/D,0BAA0B,+BAA+B;IACzD,2BAA2B,gCAAgC;IAG3D,kBAAkB,uBAAuB;IACzC,uBAAuB,4BAA4B;IACnD,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;CAChD;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"techniqueId.d.ts","sourceRoot":"","sources":["../../src/types/techniqueId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;GAYG;AACH,oBAAY,WAAW;IAErB,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,qBAAqB,0BAA0B;IAG/C,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,oBAAoB,yBAAyB;IAG7C,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAG3C,uBAAuB,4BAA4B;IACnD,4BAA4B,iCAAiC;IAC7D,6BAA6B,kCAAkC;IAC/D,0BAA0B,+BAA+B;IACzD,2BAA2B,gCAAgC;IAG3D,kBAAkB,uBAAuB;IACzC,uBAAuB,4BAA4B;IACnD,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;CAChD;AAED,eAAe,WAAW,CAAC"}

package/lib/types/techniqueId.js

@@ -21,7 +21,6 @@
 * - 정보요원 (Jeongbo) - 5 techniques: jeongbo_tactical_strike, jeongbo_counter_intelligence, jeongbo_psychological_warfare, jeongbo_precision_takedown, jeongbo_intelligence_strike
 * - 조직폭력배 (Jojik) - 4 techniques: jojik_street_brawl, jojik_improvised_weapon, jojik_ruthless_assault, jojik_brutal_takedown
 *
-* @public
 * @category Combat System
 * @korean 기술ID열거형
 */

package/lib/types/techniqueId.js.map

@@ -1 +1 @@
-{"version":3,"file":"techniqueId.js","names":[],"sources":["../../src/types/techniqueId.ts"],"sourcesContent":["/**\n * Technique ID enum for type-safe technique references\n *\n * **Korean**: 기술 ID 열거형\n *\n * Provides compile-time safety for all technique references across the codebase.\n * Every technique in the game has a unique ID defined here.\n *\n * @module types/techniqueId\n * @category Combat System\n * @korean 기술ID\n */\n\n/**\n * All technique IDs in the game system\n *\n * Each archetype has unique techniques:\n * - 무사 (Musa) - 4 techniques: musa_thunder_strike, musa_iron_defense, musa_dragon_fist, musa_mountain_breaker\n * - 암살자 (Amsalja) - 4 techniques: amsalja_shadow_strike, amsalja_nerve_strike, amsalja_deadly_precision, amsalja_silent_death\n * - 해커 (Hacker) - 4 techniques: hacker_electric_shock, hacker_data_strike, hacker_cyber_overdrive, hacker_system_crash\n * - 정보요원 (Jeongbo) - 5 techniques: jeongbo_tactical_strike, jeongbo_counter_intelligence, jeongbo_psychological_warfare, jeongbo_precision_takedown, jeongbo_intelligence_strike\n * - 조직폭력배 (Jojik) - 4 techniques: jojik_street_brawl, jojik_improvised_weapon, jojik_ruthless_assault, jojik_brutal_takedown\n *\n * @public\n * @category Combat System\n * @korean 기술ID열거형\n */\nexport enum TechniqueId {\n  // 무사 (Musa) - Traditional Warrior\n  MUSA_THUNDER_STRIKE = \"musa_thunder_strike\",\n  MUSA_IRON_DEFENSE = \"musa_iron_defense\",\n  MUSA_DRAGON_FIST = \"musa_dragon_fist\",\n  MUSA_MOUNTAIN_BREAKER = \"musa_mountain_breaker\",\n\n  // 암살자 (Amsalja) - Shadow Assassin\n  AMSALJA_SHADOW_STRIKE = \"amsalja_shadow_strike\",\n  AMSALJA_NERVE_STRIKE = \"amsalja_nerve_strike\",\n  AMSALJA_DEADLY_PRECISION = \"amsalja_deadly_precision\",\n  AMSALJA_SILENT_DEATH = \"amsalja_silent_death\",\n\n  // 해커 (Hacker) - Cyber Warrior\n  HACKER_ELECTRIC_SHOCK = \"hacker_electric_shock\",\n  HACKER_DATA_STRIKE = \"hacker_data_strike\",\n  HACKER_CYBER_OVERDRIVE = \"hacker_cyber_overdrive\",\n  HACKER_SYSTEM_CRASH = \"hacker_system_crash\",\n\n  // 정보요원 (Jeongbo Yowon) - Intelligence Operative\n  JEONGBO_TACTICAL_STRIKE = \"jeongbo_tactical_strike\",\n  JEONGBO_COUNTER_INTELLIGENCE = \"jeongbo_counter_intelligence\",\n  JEONGBO_PSYCHOLOGICAL_WARFARE = \"jeongbo_psychological_warfare\",\n  JEONGBO_PRECISION_TAKEDOWN = \"jeongbo_precision_takedown\",\n  JEONGBO_INTELLIGENCE_STRIKE = \"jeongbo_intelligence_strike\",\n\n  // 조직폭력배 (Jojik Pokryeokbae) - Organized Crime\n  JOJIK_STREET_BRAWL = \"jojik_street_brawl\",\n  JOJIK_IMPROVISED_WEAPON = \"jojik_improvised_weapon\",\n  JOJIK_RUTHLESS_ASSAULT = \"jojik_ruthless_assault\",\n  JOJIK_BRUTAL_TAKEDOWN = \"jojik_brutal_takedown\",\n}\n\nexport default TechniqueId;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAY,cAAL,yBAAA,aAAA;CAEL,YAAA,yBAAsB;CACtB,YAAA,uBAAoB;CACpB,YAAA,sBAAmB;CACnB,YAAA,2BAAwB;CAGxB,YAAA,2BAAwB;CACxB,YAAA,0BAAuB;CACvB,YAAA,8BAA2B;CAC3B,YAAA,0BAAuB;CAGvB,YAAA,2BAAwB;CACxB,YAAA,wBAAqB;CACrB,YAAA,4BAAyB;CACzB,YAAA,yBAAsB;CAGtB,YAAA,6BAA0B;CAC1B,YAAA,kCAA+B;CAC/B,YAAA,mCAAgC;CAChC,YAAA,gCAA6B;CAC7B,YAAA,iCAA8B;CAG9B,YAAA,wBAAqB;CACrB,YAAA,6BAA0B;CAC1B,YAAA,4BAAyB;CACzB,YAAA,2BAAwB;;KACzB"}
+{"version":3,"file":"techniqueId.js","names":[],"sources":["../../src/types/techniqueId.ts"],"sourcesContent":["/**\n * Technique ID enum for type-safe technique references\n *\n * **Korean**: 기술 ID 열거형\n *\n * Provides compile-time safety for all technique references across the codebase.\n * Every technique in the game has a unique ID defined here.\n *\n * @module types/techniqueId\n * @category Combat System\n * @korean 기술ID\n */\n\n/**\n * All technique IDs in the game system\n *\n * Each archetype has unique techniques:\n * - 무사 (Musa) - 4 techniques: musa_thunder_strike, musa_iron_defense, musa_dragon_fist, musa_mountain_breaker\n * - 암살자 (Amsalja) - 4 techniques: amsalja_shadow_strike, amsalja_nerve_strike, amsalja_deadly_precision, amsalja_silent_death\n * - 해커 (Hacker) - 4 techniques: hacker_electric_shock, hacker_data_strike, hacker_cyber_overdrive, hacker_system_crash\n * - 정보요원 (Jeongbo) - 5 techniques: jeongbo_tactical_strike, jeongbo_counter_intelligence, jeongbo_psychological_warfare, jeongbo_precision_takedown, jeongbo_intelligence_strike\n * - 조직폭력배 (Jojik) - 4 techniques: jojik_street_brawl, jojik_improvised_weapon, jojik_ruthless_assault, jojik_brutal_takedown\n *\n * @category Combat System\n * @korean 기술ID열거형\n */\nexport enum TechniqueId {\n  // 무사 (Musa) - Traditional Warrior\n  MUSA_THUNDER_STRIKE = \"musa_thunder_strike\",\n  MUSA_IRON_DEFENSE = \"musa_iron_defense\",\n  MUSA_DRAGON_FIST = \"musa_dragon_fist\",\n  MUSA_MOUNTAIN_BREAKER = \"musa_mountain_breaker\",\n\n  // 암살자 (Amsalja) - Shadow Assassin\n  AMSALJA_SHADOW_STRIKE = \"amsalja_shadow_strike\",\n  AMSALJA_NERVE_STRIKE = \"amsalja_nerve_strike\",\n  AMSALJA_DEADLY_PRECISION = \"amsalja_deadly_precision\",\n  AMSALJA_SILENT_DEATH = \"amsalja_silent_death\",\n\n  // 해커 (Hacker) - Cyber Warrior\n  HACKER_ELECTRIC_SHOCK = \"hacker_electric_shock\",\n  HACKER_DATA_STRIKE = \"hacker_data_strike\",\n  HACKER_CYBER_OVERDRIVE = \"hacker_cyber_overdrive\",\n  HACKER_SYSTEM_CRASH = \"hacker_system_crash\",\n\n  // 정보요원 (Jeongbo Yowon) - Intelligence Operative\n  JEONGBO_TACTICAL_STRIKE = \"jeongbo_tactical_strike\",\n  JEONGBO_COUNTER_INTELLIGENCE = \"jeongbo_counter_intelligence\",\n  JEONGBO_PSYCHOLOGICAL_WARFARE = \"jeongbo_psychological_warfare\",\n  JEONGBO_PRECISION_TAKEDOWN = \"jeongbo_precision_takedown\",\n  JEONGBO_INTELLIGENCE_STRIKE = \"jeongbo_intelligence_strike\",\n\n  // 조직폭력배 (Jojik Pokryeokbae) - Organized Crime\n  JOJIK_STREET_BRAWL = \"jojik_street_brawl\",\n  JOJIK_IMPROVISED_WEAPON = \"jojik_improvised_weapon\",\n  JOJIK_RUTHLESS_ASSAULT = \"jojik_ruthless_assault\",\n  JOJIK_BRUTAL_TAKEDOWN = \"jojik_brutal_takedown\",\n}\n\nexport default TechniqueId;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAY,cAAL,yBAAA,aAAA;CAEL,YAAA,yBAAsB;CACtB,YAAA,uBAAoB;CACpB,YAAA,sBAAmB;CACnB,YAAA,2BAAwB;CAGxB,YAAA,2BAAwB;CACxB,YAAA,0BAAuB;CACvB,YAAA,8BAA2B;CAC3B,YAAA,0BAAuB;CAGvB,YAAA,2BAAwB;CACxB,YAAA,wBAAqB;CACrB,YAAA,4BAAyB;CACzB,YAAA,yBAAsB;CAGtB,YAAA,6BAA0B;CAC1B,YAAA,kCAA+B;CAC/B,YAAA,mCAAgC;CAChC,YAAA,gCAA6B;CAC7B,YAAA,iCAA8B;CAG9B,YAAA,wBAAqB;CACrB,YAAA,6BAA0B;CAC1B,YAAA,4BAAyB;CACzB,YAAA,2BAAwB;;KACzB"}

package/lib/utils/arenaWorldDimensions.d.ts

@@ -28,14 +28,12 @@
  *
  * **Korean**: 화면크기범주 (Screen Size Category)
  *
- * @public
  */
 export type ScreenSizeCategory = "small" | "medium" | "large" | "xlarge" | "ultra";
 /**
  * Standard arena widths in meters.
  * Arenas use 4:3 aspect ratio (height = width × 0.75).
  *
- * @public
  */
 export declare const ARENA_SIZES: {
     /** Small arena for compact screens (6m × 4.5m) */
@@ -53,7 +51,6 @@ export declare const ARENA_SIZES: {
  * Resolution breakpoints for arena size determination.
  * Based on common display widths.
  *
- * @public
  */
 export declare const RESOLUTION_BREAKPOINTS: {
     /** Small screens: < 768px (phones, small tablets) */
@@ -70,7 +67,6 @@ export declare const RESOLUTION_BREAKPOINTS: {
  *
  * **Korean**: 세계크기 (World Dimensions)
  *
- * @public
  */
 export interface WorldDimensions {
     /** Arena width in meters */
@@ -85,7 +81,6 @@ export interface WorldDimensions {
 /**
  * Complete arena configuration including pixel and meter dimensions.
  *
- * @public
  */
 export interface ArenaConfiguration {
     /** Arena position X in pixels */
@@ -123,7 +118,6 @@ export interface ArenaConfiguration {
  * getScreenSizeCategory(3840);  // "ultra" - 4K display
  * ```
  *
- * @public
  */
 export declare function getScreenSizeCategory(screenWidth: number): ScreenSizeCategory;
 /**
@@ -132,7 +126,6 @@ export declare function getScreenSizeCategory(screenWidth: number): ScreenSizeCa
  * @param category - Screen size category
  * @returns Arena size in meters (square dimension)
  *
- * @public
  */
 export declare function getArenaSizeForCategory(category: ScreenSizeCategory): number;
 /**
@@ -165,7 +158,6 @@ export declare function getArenaSizeForCategory(category: ScreenSizeCategory): n
  * // Result: { widthMeters: 12, depthMeters: 9, sizeMeters: 12, screenCategory: "xlarge" }
  * ```
  *
- * @public
  */
 export declare function calculateArenaWorldDimensions(screenWidth: number): WorldDimensions;
 /**
@@ -183,7 +175,6 @@ export declare function calculateArenaWorldDimensions(screenWidth: number): Worl
  * @param horizontalMargin - Pixels to leave on sides (as ratio 0-1)
  * @returns Complete arena configuration
  *
- * @public
  */
 export declare function calculateArenaConfiguration(screenWidth: number, screenHeight: number, topOffset: number, bottomOffset: number, horizontalMargin?: number): ArenaConfiguration;
 /**
@@ -193,7 +184,6 @@ export declare function calculateArenaConfiguration(screenWidth: number, screenH
  * @param arenaWidthMeters - Arena width in meters
  * @returns Pixels per meter ratio
  *
- * @public
  */
 export declare function calculatePixelsPerMeter(arenaWidthPixels: number, arenaWidthMeters: number): number;
 /**
@@ -213,7 +203,6 @@ export declare function calculatePixelsPerMeter(arenaWidthPixels: number, arenaW
  * // Result: 1.8 meters
  * ```
  *
- * @public
  */
 export declare function getPlayerHeightMeters(archetypeHeightCm: number): number;
 //# sourceMappingURL=arenaWorldDimensions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"arenaWorldDimensions.d.ts","sourceRoot":"","sources":["../../src/utils/arenaWorldDimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,WAAW;IACtB,kDAAkD;;IAElD,2DAA2D;;IAE3D,qDAAqD;;IAErD,yDAAyD;;IAEzD,iDAAiD;;CAEzC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,qDAAqD;;IAErD,0DAA0D;;IAE1D,8DAA8D;;IAE9D,4DAA4D;;CAGpD,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,kCAAkC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAM7E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAe5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAClB,eAAe,CAYjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,gBAAgB,GAAE,MAAY,GAC7B,kBAAkB,CAgCpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAEvE"}
+{"version":3,"file":"arenaWorldDimensions.d.ts","sourceRoot":"","sources":["../../src/utils/arenaWorldDimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,kDAAkD;;IAElD,2DAA2D;;IAE3D,qDAAqD;;IAErD,yDAAyD;;IAEzD,iDAAiD;;CAEzC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,qDAAqD;;IAErD,0DAA0D;;IAE1D,8DAA8D;;IAE9D,4DAA4D;;CAGpD,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,kCAAkC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAM7E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAe5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,GAClB,eAAe,CAYjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,gBAAgB,GAAE,MAAY,GAC7B,kBAAkB,CAgCpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAEvE"}

package/lib/utils/arenaWorldDimensions.js

@@ -3,7 +3,6 @@
 * Standard arena widths in meters.
 * Arenas use 4:3 aspect ratio (height = width × 0.75).
 *
-* @public
 */
 var ARENA_SIZES = {
 	/** Small arena for compact screens (6m × 4.5m) */
@@ -21,7 +20,6 @@ var ARENA_SIZES = {
 * Resolution breakpoints for arena size determination.
 * Based on common display widths.
 *
-* @public
 */
 var RESOLUTION_BREAKPOINTS = {
 	/** Small screens: < 768px (phones, small tablets) */
@@ -51,7 +49,6 @@ var RESOLUTION_BREAKPOINTS = {
 * getScreenSizeCategory(3840);  // "ultra" - 4K display
 * ```
 *
-* @public
 */
 function getScreenSizeCategory(screenWidth) {
 	if (screenWidth < RESOLUTION_BREAKPOINTS.SMALL_MAX) return "small";
@@ -66,7 +63,6 @@ function getScreenSizeCategory(screenWidth) {
 * @param category - Screen size category
 * @returns Arena size in meters (square dimension)
 *
-* @public
 */
 function getArenaSizeForCategory(category) {
 	switch (category) {
@@ -108,7 +104,6 @@ function getArenaSizeForCategory(category) {
 * // Result: { widthMeters: 12, depthMeters: 9, sizeMeters: 12, screenCategory: "xlarge" }
 * ```
 *
-* @public
 */
 function calculateArenaWorldDimensions(screenWidth) {
 	const category = getScreenSizeCategory(screenWidth);
@@ -135,7 +130,6 @@ function calculateArenaWorldDimensions(screenWidth) {
 * @param horizontalMargin - Pixels to leave on sides (as ratio 0-1)
 * @returns Complete arena configuration
 *
-* @public
 */
 function calculateArenaConfiguration(screenWidth, screenHeight, topOffset, bottomOffset, horizontalMargin = .1) {
 	const worldDimensions = calculateArenaWorldDimensions(screenWidth);

package/lib/utils/arenaWorldDimensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"arenaWorldDimensions.js","names":[],"sources":["../../src/utils/arenaWorldDimensions.ts"],"sourcesContent":["/**\n * Arena world dimension calculations for physics-first coordinate system.\n *\n * Determines the physical size of the combat arena in meters based on\n * screen **resolution** (not device type), ensuring appropriate gameplay\n * space for different display capabilities.\n *\n * **Important**: Arena size is determined by RESOLUTION, not device type.\n * A mobile device with a 4K screen gets a larger arena than a desktop with\n * 1080p resolution, because arena size should match display capability.\n *\n * **4:3 Aspect Ratio Philosophy**:\n * All arenas use 4:3 aspect ratio (width > height) for optimal screen usage.\n * Width sizes: 6m, 8m, 10m, 12m, 14m based on resolution.\n * Height is calculated as width × 0.75 (3/4).\n * This ensures:\n * - Efficient use of horizontal screen space\n * - Consistent physics across all devices\n * - Traditional fighting game proportions\n *\n * **Korean**: 경기장세계크기 (Arena World Size)\n *\n * @module utils/arenaWorldDimensions\n * @category Physics\n */\n\n/**\n * Screen size category based on RESOLUTION (width in pixels).\n *\n * **Korean**: 화면크기범주 (Screen Size Category)\n *\n * @public\n */\nexport type ScreenSizeCategory =\n  | \"small\"\n  | \"medium\"\n  | \"large\"\n  | \"xlarge\"\n  | \"ultra\";\n\n/**\n * Standard arena widths in meters.\n * Arenas use 4:3 aspect ratio (height = width × 0.75).\n *\n * @public\n */\nexport const ARENA_SIZES = {\n  /** Small arena for compact screens (6m × 4.5m) */\n  SMALL: 6,\n  /** Medium arena for tablets and small laptops (8m × 6m) */\n  MEDIUM: 8,\n  /** Large arena for standard desktops (10m × 7.5m) */\n  LARGE: 10,\n  /** Extra-large arena for high-res displays (12m × 9m) */\n  XLARGE: 12,\n  /** Ultra arena for 4K+ displays (14m × 10.5m) */\n  ULTRA: 14,\n} as const;\n\n/**\n * Resolution breakpoints for arena size determination.\n * Based on common display widths.\n *\n * @public\n */\nexport const RESOLUTION_BREAKPOINTS = {\n  /** Small screens: < 768px (phones, small tablets) */\n  SMALL_MAX: 768,\n  /** Medium screens: 768-1199px (tablets, small laptops) */\n  MEDIUM_MAX: 1200,\n  /** Large screens: 1200-1919px (laptops, standard monitors) */\n  LARGE_MAX: 1920,\n  /** XLarge screens: 1920-2559px (large monitors, some 4K) */\n  XLARGE_MAX: 2560,\n  /** Ultra screens: ≥ 2560px (4K, ultrawide) */\n} as const;\n\n/**\n * World dimensions for an arena in meters.\n *\n * **Korean**: 세계크기 (World Dimensions)\n *\n * @public\n */\nexport interface WorldDimensions {\n  /** Arena width in meters */\n  readonly widthMeters: number;\n  /** Arena depth in meters (height = width × 0.75 for 4:3 ratio) */\n  readonly depthMeters: number;\n  /** Arena width in meters (same as widthMeters, for convenience) */\n  readonly sizeMeters: number;\n  /** Screen category used to determine arena size */\n  readonly screenCategory: ScreenSizeCategory;\n}\n\n/**\n * Complete arena configuration including pixel and meter dimensions.\n *\n * @public\n */\nexport interface ArenaConfiguration {\n  /** Arena position X in pixels */\n  readonly x: number;\n  /** Arena position Y in pixels */\n  readonly y: number;\n  /** Arena width in pixels */\n  readonly width: number;\n  /** Arena height in pixels */\n  readonly height: number;\n  /** Arena world width in meters */\n  readonly worldWidthMeters: number;\n  /** Arena world depth in meters */\n  readonly worldDepthMeters: number;\n  /** Pixels per meter ratio for this arena */\n  readonly pixelsPerMeter: number;\n  /** Scale factor (1.0 = reference desktop, <1.0 = smaller screens) */\n  readonly scale: number;\n}\n\n/**\n * Categorize screen based on resolution (width in pixels).\n *\n * This is used for arena sizing. Device type (mobile/desktop) is determined\n * separately for UI controls only.\n *\n * **Korean**: 화면크기범주결정 (Determine Screen Size Category)\n *\n * @param screenWidth - Screen width in pixels\n * @returns Screen size category for arena dimensions\n *\n * @example\n * ```typescript\n * getScreenSizeCategory(640);   // \"small\" - small phone\n * getScreenSizeCategory(1200);  // \"large\" - standard laptop\n * getScreenSizeCategory(3840);  // \"ultra\" - 4K display\n * ```\n *\n * @public\n */\nexport function getScreenSizeCategory(screenWidth: number): ScreenSizeCategory {\n  if (screenWidth < RESOLUTION_BREAKPOINTS.SMALL_MAX) return \"small\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.MEDIUM_MAX) return \"medium\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.LARGE_MAX) return \"large\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.XLARGE_MAX) return \"xlarge\";\n  return \"ultra\";\n}\n\n/**\n * Get arena size in meters for a given screen category.\n *\n * @param category - Screen size category\n * @returns Arena size in meters (square dimension)\n *\n * @public\n */\nexport function getArenaSizeForCategory(category: ScreenSizeCategory): number {\n  switch (category) {\n    case \"small\":\n      return ARENA_SIZES.SMALL;\n    case \"medium\":\n      return ARENA_SIZES.MEDIUM;\n    case \"large\":\n      return ARENA_SIZES.LARGE;\n    case \"xlarge\":\n      return ARENA_SIZES.XLARGE;\n    case \"ultra\":\n      return ARENA_SIZES.ULTRA;\n    default:\n      return ARENA_SIZES.LARGE;\n  }\n}\n\n/**\n * Calculate appropriate arena world dimensions based on screen resolution.\n *\n * Larger resolution displays get larger arenas for better gameplay, while\n * maintaining the same physical combat mechanics. Movement speed in m/s\n * remains constant, but larger arenas provide more tactical space.\n *\n * **Arenas use 4:3 aspect ratio** (width > depth):\n * - < 768px: 6m × 4.5m (compact, fast-paced combat)\n * - 768-1199px: 8m × 6m (balanced gameplay)\n * - 1200-1919px: 10m × 7.5m (tactical combat)\n * - 1920-2559px: 12m × 9m (advanced positioning)\n * - ≥ 2560px: 14m × 10.5m (maximum tactical space)\n *\n * **Korean**: 경기장크기계산 (Calculate Arena Size)\n *\n * @param screenWidth - Screen width in pixels (resolution, not device type)\n * @returns World dimensions in meters (4:3 aspect ratio)\n *\n * @example\n * ```typescript\n * // Mobile phone 640px width\n * const smallPhone = calculateArenaWorldDimensions(640);\n * // Result: { widthMeters: 6, depthMeters: 4.5, sizeMeters: 6, screenCategory: \"small\" }\n *\n * // Desktop 1920×1080\n * const desktop = calculateArenaWorldDimensions(1920);\n * // Result: { widthMeters: 12, depthMeters: 9, sizeMeters: 12, screenCategory: \"xlarge\" }\n * ```\n *\n * @public\n */\nexport function calculateArenaWorldDimensions(\n  screenWidth: number,\n): WorldDimensions {\n  const category = getScreenSizeCategory(screenWidth);\n  const sizeMeters = getArenaSizeForCategory(category);\n  // 4:3 aspect ratio: depth = width × 0.75\n  const depthMeters = sizeMeters * 0.75;\n\n  return {\n    widthMeters: sizeMeters,\n    depthMeters,\n    sizeMeters,\n    screenCategory: category,\n  };\n}\n\n/**\n * Calculate complete arena configuration including pixel and meter dimensions.\n *\n * This is the primary function for setting up arena bounds. It calculates:\n * - Pixel dimensions based on available screen space\n * - Meter dimensions based on screen resolution category\n * - Pixels-per-meter ratio for physics conversion\n *\n * @param screenWidth - Screen width in pixels\n * @param screenHeight - Screen height in pixels\n * @param topOffset - Pixels reserved at top (HUD, headers)\n * @param bottomOffset - Pixels reserved at bottom (controls, footer)\n * @param horizontalMargin - Pixels to leave on sides (as ratio 0-1)\n * @returns Complete arena configuration\n *\n * @public\n */\nexport function calculateArenaConfiguration(\n  screenWidth: number,\n  screenHeight: number,\n  topOffset: number,\n  bottomOffset: number,\n  horizontalMargin: number = 0.1,\n): ArenaConfiguration {\n  // Get world dimensions based on resolution\n  const worldDimensions = calculateArenaWorldDimensions(screenWidth);\n\n  // Calculate available pixel space\n  const availableWidth = screenWidth * (1 - 2 * horizontalMargin);\n  const availableHeight = screenHeight - topOffset - bottomOffset;\n\n  // Use the smaller dimension to ensure square arena fits\n  const arenaSizePixels = Math.min(availableWidth, availableHeight);\n\n  // Calculate arena position (centered horizontally)\n  const arenaX = (screenWidth - arenaSizePixels) / 2;\n  const arenaY = topOffset;\n\n  // Calculate pixels per meter for this configuration\n  const pixelsPerMeter = arenaSizePixels / worldDimensions.sizeMeters;\n\n  // Calculate scale relative to reference (1000px / 10m = 100 px/m)\n  const referencePixelsPerMeter = 100;\n  const scale = pixelsPerMeter / referencePixelsPerMeter;\n\n  return {\n    x: arenaX,\n    y: arenaY,\n    width: arenaSizePixels,\n    height: arenaSizePixels,\n    worldWidthMeters: worldDimensions.widthMeters,\n    worldDepthMeters: worldDimensions.depthMeters,\n    pixelsPerMeter,\n    scale,\n  };\n}\n\n/**\n * Calculate pixels-per-meter ratio from arena dimensions.\n *\n * @param arenaWidthPixels - Arena width in pixels\n * @param arenaWidthMeters - Arena width in meters\n * @returns Pixels per meter ratio\n *\n * @public\n */\nexport function calculatePixelsPerMeter(\n  arenaWidthPixels: number,\n  arenaWidthMeters: number,\n): number {\n  if (arenaWidthMeters <= 0) {\n    throw new Error(`arenaWidthMeters must be positive: ${arenaWidthMeters}`);\n  }\n  return arenaWidthPixels / arenaWidthMeters;\n}\n\n/**\n * Get player height in meters from archetype physical attributes.\n *\n * Converts archetype totalHeight (in centimeters) to meters for physics calculations.\n *\n * **Korean**: 플레이어키 (Player Height)\n *\n * @param archetypeHeightCm - Player height in centimeters from PhysicalAttributes\n * @returns Height in meters\n *\n * @example\n * ```typescript\n * // Musa archetype: 180cm\n * const height = getPlayerHeightMeters(180);\n * // Result: 1.8 meters\n * ```\n *\n * @public\n */\nexport function getPlayerHeightMeters(archetypeHeightCm: number): number {\n  return archetypeHeightCm / 100;\n}\n"],"mappings":";;;;;;;AA8CA,IAAa,cAAc;;CAEzB,OAAO;;CAEP,QAAQ;;CAER,OAAO;;CAEP,QAAQ;;CAER,OAAO;CACR;;;;;;;AAQD,IAAa,yBAAyB;;CAEpC,WAAW;;CAEX,YAAY;;CAEZ,WAAW;;CAEX,YAAY;CAEb;;;;;;;;;;;;;;;;;;;;;AAgED,SAAgB,sBAAsB,aAAyC;CAC7E,IAAI,cAAc,uBAAuB,WAAW,OAAO;CAC3D,IAAI,cAAc,uBAAuB,YAAY,OAAO;CAC5D,IAAI,cAAc,uBAAuB,WAAW,OAAO;CAC3D,IAAI,cAAc,uBAAuB,YAAY,OAAO;CAC5D,OAAO;;;;;;;;;;AAWT,SAAgB,wBAAwB,UAAsC;CAC5E,QAAQ,UAAR;EACE,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,UACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,UACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,SACE,OAAO,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCzB,SAAgB,8BACd,aACiB;CACjB,MAAM,WAAW,sBAAsB,YAAY;CACnD,MAAM,aAAa,wBAAwB,SAAS;CAIpD,OAAO;EACL,aAAa;EACb,aAJkB,aAAa;EAK/B;EACA,gBAAgB;EACjB;;;;;;;;;;;;;;;;;;;AAoBH,SAAgB,4BACd,aACA,cACA,WACA,cACA,mBAA2B,IACP;CAEpB,MAAM,kBAAkB,8BAA8B,YAAY;CAGlE,MAAM,iBAAiB,eAAe,IAAI,IAAI;CAC9C,MAAM,kBAAkB,eAAe,YAAY;CAGnD,MAAM,kBAAkB,KAAK,IAAI,gBAAgB,gBAAgB;CAGjE,MAAM,UAAU,cAAc,mBAAmB;CACjD,MAAM,SAAS;CAGf,MAAM,iBAAiB,kBAAkB,gBAAgB;CAIzD,MAAM,QAAQ,iBAAiB;CAE/B,OAAO;EACL,GAAG;EACH,GAAG;EACH,OAAO;EACP,QAAQ;EACR,kBAAkB,gBAAgB;EAClC,kBAAkB,gBAAgB;EAClC;EACA;EACD"}
+{"version":3,"file":"arenaWorldDimensions.js","names":[],"sources":["../../src/utils/arenaWorldDimensions.ts"],"sourcesContent":["/**\n * Arena world dimension calculations for physics-first coordinate system.\n *\n * Determines the physical size of the combat arena in meters based on\n * screen **resolution** (not device type), ensuring appropriate gameplay\n * space for different display capabilities.\n *\n * **Important**: Arena size is determined by RESOLUTION, not device type.\n * A mobile device with a 4K screen gets a larger arena than a desktop with\n * 1080p resolution, because arena size should match display capability.\n *\n * **4:3 Aspect Ratio Philosophy**:\n * All arenas use 4:3 aspect ratio (width > height) for optimal screen usage.\n * Width sizes: 6m, 8m, 10m, 12m, 14m based on resolution.\n * Height is calculated as width × 0.75 (3/4).\n * This ensures:\n * - Efficient use of horizontal screen space\n * - Consistent physics across all devices\n * - Traditional fighting game proportions\n *\n * **Korean**: 경기장세계크기 (Arena World Size)\n *\n * @module utils/arenaWorldDimensions\n * @category Physics\n */\n\n/**\n * Screen size category based on RESOLUTION (width in pixels).\n *\n * **Korean**: 화면크기범주 (Screen Size Category)\n *\n */\nexport type ScreenSizeCategory =\n  | \"small\"\n  | \"medium\"\n  | \"large\"\n  | \"xlarge\"\n  | \"ultra\";\n\n/**\n * Standard arena widths in meters.\n * Arenas use 4:3 aspect ratio (height = width × 0.75).\n *\n */\nexport const ARENA_SIZES = {\n  /** Small arena for compact screens (6m × 4.5m) */\n  SMALL: 6,\n  /** Medium arena for tablets and small laptops (8m × 6m) */\n  MEDIUM: 8,\n  /** Large arena for standard desktops (10m × 7.5m) */\n  LARGE: 10,\n  /** Extra-large arena for high-res displays (12m × 9m) */\n  XLARGE: 12,\n  /** Ultra arena for 4K+ displays (14m × 10.5m) */\n  ULTRA: 14,\n} as const;\n\n/**\n * Resolution breakpoints for arena size determination.\n * Based on common display widths.\n *\n */\nexport const RESOLUTION_BREAKPOINTS = {\n  /** Small screens: < 768px (phones, small tablets) */\n  SMALL_MAX: 768,\n  /** Medium screens: 768-1199px (tablets, small laptops) */\n  MEDIUM_MAX: 1200,\n  /** Large screens: 1200-1919px (laptops, standard monitors) */\n  LARGE_MAX: 1920,\n  /** XLarge screens: 1920-2559px (large monitors, some 4K) */\n  XLARGE_MAX: 2560,\n  /** Ultra screens: ≥ 2560px (4K, ultrawide) */\n} as const;\n\n/**\n * World dimensions for an arena in meters.\n *\n * **Korean**: 세계크기 (World Dimensions)\n *\n */\nexport interface WorldDimensions {\n  /** Arena width in meters */\n  readonly widthMeters: number;\n  /** Arena depth in meters (height = width × 0.75 for 4:3 ratio) */\n  readonly depthMeters: number;\n  /** Arena width in meters (same as widthMeters, for convenience) */\n  readonly sizeMeters: number;\n  /** Screen category used to determine arena size */\n  readonly screenCategory: ScreenSizeCategory;\n}\n\n/**\n * Complete arena configuration including pixel and meter dimensions.\n *\n */\nexport interface ArenaConfiguration {\n  /** Arena position X in pixels */\n  readonly x: number;\n  /** Arena position Y in pixels */\n  readonly y: number;\n  /** Arena width in pixels */\n  readonly width: number;\n  /** Arena height in pixels */\n  readonly height: number;\n  /** Arena world width in meters */\n  readonly worldWidthMeters: number;\n  /** Arena world depth in meters */\n  readonly worldDepthMeters: number;\n  /** Pixels per meter ratio for this arena */\n  readonly pixelsPerMeter: number;\n  /** Scale factor (1.0 = reference desktop, <1.0 = smaller screens) */\n  readonly scale: number;\n}\n\n/**\n * Categorize screen based on resolution (width in pixels).\n *\n * This is used for arena sizing. Device type (mobile/desktop) is determined\n * separately for UI controls only.\n *\n * **Korean**: 화면크기범주결정 (Determine Screen Size Category)\n *\n * @param screenWidth - Screen width in pixels\n * @returns Screen size category for arena dimensions\n *\n * @example\n * ```typescript\n * getScreenSizeCategory(640);   // \"small\" - small phone\n * getScreenSizeCategory(1200);  // \"large\" - standard laptop\n * getScreenSizeCategory(3840);  // \"ultra\" - 4K display\n * ```\n *\n */\nexport function getScreenSizeCategory(screenWidth: number): ScreenSizeCategory {\n  if (screenWidth < RESOLUTION_BREAKPOINTS.SMALL_MAX) return \"small\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.MEDIUM_MAX) return \"medium\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.LARGE_MAX) return \"large\";\n  if (screenWidth < RESOLUTION_BREAKPOINTS.XLARGE_MAX) return \"xlarge\";\n  return \"ultra\";\n}\n\n/**\n * Get arena size in meters for a given screen category.\n *\n * @param category - Screen size category\n * @returns Arena size in meters (square dimension)\n *\n */\nexport function getArenaSizeForCategory(category: ScreenSizeCategory): number {\n  switch (category) {\n    case \"small\":\n      return ARENA_SIZES.SMALL;\n    case \"medium\":\n      return ARENA_SIZES.MEDIUM;\n    case \"large\":\n      return ARENA_SIZES.LARGE;\n    case \"xlarge\":\n      return ARENA_SIZES.XLARGE;\n    case \"ultra\":\n      return ARENA_SIZES.ULTRA;\n    default:\n      return ARENA_SIZES.LARGE;\n  }\n}\n\n/**\n * Calculate appropriate arena world dimensions based on screen resolution.\n *\n * Larger resolution displays get larger arenas for better gameplay, while\n * maintaining the same physical combat mechanics. Movement speed in m/s\n * remains constant, but larger arenas provide more tactical space.\n *\n * **Arenas use 4:3 aspect ratio** (width > depth):\n * - < 768px: 6m × 4.5m (compact, fast-paced combat)\n * - 768-1199px: 8m × 6m (balanced gameplay)\n * - 1200-1919px: 10m × 7.5m (tactical combat)\n * - 1920-2559px: 12m × 9m (advanced positioning)\n * - ≥ 2560px: 14m × 10.5m (maximum tactical space)\n *\n * **Korean**: 경기장크기계산 (Calculate Arena Size)\n *\n * @param screenWidth - Screen width in pixels (resolution, not device type)\n * @returns World dimensions in meters (4:3 aspect ratio)\n *\n * @example\n * ```typescript\n * // Mobile phone 640px width\n * const smallPhone = calculateArenaWorldDimensions(640);\n * // Result: { widthMeters: 6, depthMeters: 4.5, sizeMeters: 6, screenCategory: \"small\" }\n *\n * // Desktop 1920×1080\n * const desktop = calculateArenaWorldDimensions(1920);\n * // Result: { widthMeters: 12, depthMeters: 9, sizeMeters: 12, screenCategory: \"xlarge\" }\n * ```\n *\n */\nexport function calculateArenaWorldDimensions(\n  screenWidth: number,\n): WorldDimensions {\n  const category = getScreenSizeCategory(screenWidth);\n  const sizeMeters = getArenaSizeForCategory(category);\n  // 4:3 aspect ratio: depth = width × 0.75\n  const depthMeters = sizeMeters * 0.75;\n\n  return {\n    widthMeters: sizeMeters,\n    depthMeters,\n    sizeMeters,\n    screenCategory: category,\n  };\n}\n\n/**\n * Calculate complete arena configuration including pixel and meter dimensions.\n *\n * This is the primary function for setting up arena bounds. It calculates:\n * - Pixel dimensions based on available screen space\n * - Meter dimensions based on screen resolution category\n * - Pixels-per-meter ratio for physics conversion\n *\n * @param screenWidth - Screen width in pixels\n * @param screenHeight - Screen height in pixels\n * @param topOffset - Pixels reserved at top (HUD, headers)\n * @param bottomOffset - Pixels reserved at bottom (controls, footer)\n * @param horizontalMargin - Pixels to leave on sides (as ratio 0-1)\n * @returns Complete arena configuration\n *\n */\nexport function calculateArenaConfiguration(\n  screenWidth: number,\n  screenHeight: number,\n  topOffset: number,\n  bottomOffset: number,\n  horizontalMargin: number = 0.1,\n): ArenaConfiguration {\n  // Get world dimensions based on resolution\n  const worldDimensions = calculateArenaWorldDimensions(screenWidth);\n\n  // Calculate available pixel space\n  const availableWidth = screenWidth * (1 - 2 * horizontalMargin);\n  const availableHeight = screenHeight - topOffset - bottomOffset;\n\n  // Use the smaller dimension to ensure square arena fits\n  const arenaSizePixels = Math.min(availableWidth, availableHeight);\n\n  // Calculate arena position (centered horizontally)\n  const arenaX = (screenWidth - arenaSizePixels) / 2;\n  const arenaY = topOffset;\n\n  // Calculate pixels per meter for this configuration\n  const pixelsPerMeter = arenaSizePixels / worldDimensions.sizeMeters;\n\n  // Calculate scale relative to reference (1000px / 10m = 100 px/m)\n  const referencePixelsPerMeter = 100;\n  const scale = pixelsPerMeter / referencePixelsPerMeter;\n\n  return {\n    x: arenaX,\n    y: arenaY,\n    width: arenaSizePixels,\n    height: arenaSizePixels,\n    worldWidthMeters: worldDimensions.widthMeters,\n    worldDepthMeters: worldDimensions.depthMeters,\n    pixelsPerMeter,\n    scale,\n  };\n}\n\n/**\n * Calculate pixels-per-meter ratio from arena dimensions.\n *\n * @param arenaWidthPixels - Arena width in pixels\n * @param arenaWidthMeters - Arena width in meters\n * @returns Pixels per meter ratio\n *\n */\nexport function calculatePixelsPerMeter(\n  arenaWidthPixels: number,\n  arenaWidthMeters: number,\n): number {\n  if (arenaWidthMeters <= 0) {\n    throw new Error(`arenaWidthMeters must be positive: ${arenaWidthMeters}`);\n  }\n  return arenaWidthPixels / arenaWidthMeters;\n}\n\n/**\n * Get player height in meters from archetype physical attributes.\n *\n * Converts archetype totalHeight (in centimeters) to meters for physics calculations.\n *\n * **Korean**: 플레이어키 (Player Height)\n *\n * @param archetypeHeightCm - Player height in centimeters from PhysicalAttributes\n * @returns Height in meters\n *\n * @example\n * ```typescript\n * // Musa archetype: 180cm\n * const height = getPlayerHeightMeters(180);\n * // Result: 1.8 meters\n * ```\n *\n */\nexport function getPlayerHeightMeters(archetypeHeightCm: number): number {\n  return archetypeHeightCm / 100;\n}\n"],"mappings":";;;;;;AA4CA,IAAa,cAAc;;CAEzB,OAAO;;CAEP,QAAQ;;CAER,OAAO;;CAEP,QAAQ;;CAER,OAAO;CACR;;;;;;AAOD,IAAa,yBAAyB;;CAEpC,WAAW;;CAEX,YAAY;;CAEZ,WAAW;;CAEX,YAAY;CAEb;;;;;;;;;;;;;;;;;;;;AA6DD,SAAgB,sBAAsB,aAAyC;CAC7E,IAAI,cAAc,uBAAuB,WAAW,OAAO;CAC3D,IAAI,cAAc,uBAAuB,YAAY,OAAO;CAC5D,IAAI,cAAc,uBAAuB,WAAW,OAAO;CAC3D,IAAI,cAAc,uBAAuB,YAAY,OAAO;CAC5D,OAAO;;;;;;;;;AAUT,SAAgB,wBAAwB,UAAsC;CAC5E,QAAQ,UAAR;EACE,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,UACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,UACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,SACE,OAAO,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCzB,SAAgB,8BACd,aACiB;CACjB,MAAM,WAAW,sBAAsB,YAAY;CACnD,MAAM,aAAa,wBAAwB,SAAS;CAIpD,OAAO;EACL,aAAa;EACb,aAJkB,aAAa;EAK/B;EACA,gBAAgB;EACjB;;;;;;;;;;;;;;;;;;AAmBH,SAAgB,4BACd,aACA,cACA,WACA,cACA,mBAA2B,IACP;CAEpB,MAAM,kBAAkB,8BAA8B,YAAY;CAGlE,MAAM,iBAAiB,eAAe,IAAI,IAAI;CAC9C,MAAM,kBAAkB,eAAe,YAAY;CAGnD,MAAM,kBAAkB,KAAK,IAAI,gBAAgB,gBAAgB;CAGjE,MAAM,UAAU,cAAc,mBAAmB;CACjD,MAAM,SAAS;CAGf,MAAM,iBAAiB,kBAAkB,gBAAgB;CAIzD,MAAM,QAAQ,iBAAiB;CAE/B,OAAO;EACL,GAAG;EACH,GAAG;EACH,OAAO;EACP,QAAQ;EACR,kBAAkB,gBAAgB;EAClC,kBAAkB,gBAAgB;EAClC;EACA;EACD"}