blacktrigram 0.7.44 → 0.7.45

package/lib/systems/PlayerEffectManager.d.ts

@@ -40,7 +40,6 @@ import { PlayerState } from "./player";
  * );
  * ```
  *
- * @public
  * @korean 효과추가
  */
 export declare function addEffectsToPlayer(player: PlayerState, effects: readonly StatusEffect[]): PlayerState;
@@ -60,7 +59,6 @@ export declare function addEffectsToPlayer(player: PlayerState, effects: readonl
  * const updatedPlayer = removeExpiredEffects(player, Date.now());
  * ```
  *
- * @public
  * @korean 만료효과제거
  */
 export declare function removeExpiredEffects(player: PlayerState, currentTime?: number): PlayerState;
@@ -78,7 +76,6 @@ export declare function removeExpiredEffects(player: PlayerState, currentTime?:
  * const updatedPlayer = removeEffectById(player, "stun_12345");
  * ```
  *
- * @public
  * @korean 효과제거
  */
 export declare function removeEffectById(player: PlayerState, effectId: string): PlayerState;
@@ -99,7 +96,6 @@ export declare function removeEffectById(player: PlayerState, effectId: string):
  * );
  * ```
  *
- * @public
  * @korean 유형별효과제거
  */
 export declare function removeEffectsByType(player: PlayerState, effectType: VitalPointEffectType): PlayerState;
@@ -118,7 +114,6 @@ export declare function removeEffectsByType(player: PlayerState, effectType: Vit
  * const clearedPlayer = clearAllEffects(player);
  * ```
  *
- * @public
  * @korean 전체효과제거
  */
 export declare function clearAllEffects(player: PlayerState): PlayerState;
@@ -139,7 +134,6 @@ export declare function clearAllEffects(player: PlayerState): PlayerState;
  * const effectiveSpeed = baseSpeed * modifiers.speed;
  * ```
  *
- * @public
  * @korean 효과배율계산
  */
 export declare function getEffectModifiers(player: PlayerState): {
@@ -166,7 +160,6 @@ export declare function getEffectModifiers(player: PlayerState): {
  * }
  * ```
  *
- * @public
  * @korean 효과확인
  */
 export declare function hasEffect(player: PlayerState, effectType: VitalPointEffectType): boolean;
@@ -179,7 +172,6 @@ export declare function hasEffect(player: PlayerState, effectType: VitalPointEff
  * @param effectType - Type to retrieve
  * @returns Array of matching effects
  *
- * @public
  * @korean 유형별효과조회
  */
 export declare function getEffectsByType(player: PlayerState, effectType: VitalPointEffectType): StatusEffect[];
@@ -191,7 +183,6 @@ export declare function getEffectsByType(player: PlayerState, effectType: VitalP
  * @param player - Current player state
  * @returns Number of active effects
  *
- * @public
  * @korean 효과개수조회
  */
 export declare function getActiveEffectCount(player: PlayerState): number;
@@ -203,7 +194,6 @@ export declare function getActiveEffectCount(player: PlayerState): number;
  * @param player - Current player state
  * @returns True if under MAX_CONCURRENT_EFFECTS limit
  *
- * @public
  * @korean 효과추가가능확인
  */
 export declare function canAddMoreEffects(player: PlayerState): boolean;

package/lib/systems/PlayerEffectManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerEffectManager.d.ts","sourceRoot":"","sources":["../../src/systems/PlayerEffectManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,WAAW,CAkBb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,WAAW,GAAE,MAAmB,GAC/B,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAMhE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAiGA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,YAAY,EAAE,CAEhB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"PlayerEffectManager.d.ts","sourceRoot":"","sources":["../../src/systems/PlayerEffectManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,WAAW,CAgBb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,WAAW,GAAE,MAAmB,GAC/B,WAAW,CAYb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,WAAW,CAYb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAMhE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAiGA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,oBAAoB,GAC/B,YAAY,EAAE,CAEhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE9D"}

package/lib/systems/PlayerEffectManager.js

@@ -40,7 +40,6 @@ import { applyEffectStacking } from "./EffectCalculator.js";
 * );
 * ```
 * 
-* @public
 * @korean 효과추가
 */
 function addEffectsToPlayer(player, effects) {
@@ -69,7 +68,6 @@ function addEffectsToPlayer(player, effects) {
 * const updatedPlayer = removeExpiredEffects(player, Date.now());
 * ```
 * 
-* @public
 * @korean 만료효과제거
 */
 function removeExpiredEffects(player, currentTime = Date.now()) {
@@ -98,7 +96,6 @@ function removeExpiredEffects(player, currentTime = Date.now()) {
 * const effectiveSpeed = baseSpeed * modifiers.speed;
 * ```
 * 
-* @public
 * @korean 효과배율계산
 */
 function getEffectModifiers(player) {

package/lib/systems/PlayerEffectManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerEffectManager.js","names":[],"sources":["../../src/systems/PlayerEffectManager.ts"],"sourcesContent":["/**\n * Player Effect Manager for tracking and applying status effects.\n * \n * **Korean**: 플레이어 효과 관리자 (Player Effect Manager)\n * \n * This module provides utilities for managing status effects on player state,\n * including adding effects with stacking logic, removing expired effects,\n * and applying effect-based combat modifiers.\n * \n * ## Key Features\n * \n * - **Effect Tracking**: Add, remove, and update status effects\n * - **Stacking Logic**: Manage concurrent effects (max 5)\n * - **Expiration Handling**: Auto-remove expired effects\n * - **Combat Modifiers**: Calculate effect-based stat changes\n * \n * @module systems/PlayerEffectManager\n * @category Player Management\n * @korean 플레이어효과관리\n */\n\nimport { VitalPointEffectType } from \"../types/common\";\nimport { StatusEffect } from \"./types\";\nimport { PlayerState } from \"./player\";\nimport { applyEffectStacking, MAX_CONCURRENT_EFFECTS } from \"./EffectCalculator\";\n\n/**\n * Adds status effects to a player's active effects list.\n * \n * **Korean**: 플레이어에 효과 추가 (Add Effects to Player)\n * \n * Applies stacking logic and respects the max concurrent effects limit.\n * \n * @param player - Current player state\n * @param effects - New effects to add\n * @returns Updated player state with new effects\n * \n * @example\n * ```typescript\n * const updatedPlayer = addEffectsToPlayer(\n *   player,\n *   [paralyze, bleed, stun]\n * );\n * ```\n * \n * @public\n * @korean 효과추가\n */\nexport function addEffectsToPlayer(\n  player: PlayerState,\n  effects: readonly StatusEffect[]\n): PlayerState {\n  const currentTime = Date.now();\n\n  // Apply stacking logic\n  const updatedEffects = applyEffectStacking(\n    player.statusEffects,\n    effects,\n    currentTime\n  );\n\n  // Update activeEffects array with effect IDs\n  const activeEffectIds = updatedEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: updatedEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes expired status effects from player.\n * \n * **Korean**: 만료 효과 제거 (Remove Expired Effects)\n * \n * Filters out effects whose endTime has passed.\n * \n * @param player - Current player state\n * @param currentTime - Current timestamp (default: Date.now())\n * @returns Updated player state with expired effects removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeExpiredEffects(player, Date.now());\n * ```\n * \n * @public\n * @korean 만료효과제거\n */\nexport function removeExpiredEffects(\n  player: PlayerState,\n  currentTime: number = Date.now()\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.endTime > currentTime\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes a specific status effect by ID.\n * \n * **Korean**: 특정 효과 제거 (Remove Specific Effect)\n * \n * @param player - Current player state\n * @param effectId - ID of effect to remove\n * @returns Updated player state with effect removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeEffectById(player, \"stun_12345\");\n * ```\n * \n * @public\n * @korean 효과제거\n */\nexport function removeEffectById(\n  player: PlayerState,\n  effectId: string\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.id !== effectId\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes all status effects of a specific type.\n * \n * **Korean**: 특정 유형 효과 모두 제거 (Remove All Effects of Type)\n * \n * @param player - Current player state\n * @param effectType - Type of effects to remove\n * @returns Updated player state with effects removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeEffectsByType(\n *   player,\n *   VitalPointEffectType.PARALYSIS\n * );\n * ```\n * \n * @public\n * @korean 유형별효과제거\n */\nexport function removeEffectsByType(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.type !== effectType\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Clears all status effects from player.\n * \n * **Korean**: 모든 효과 제거 (Clear All Effects)\n * \n * Useful for healing items, rest periods, or match resets.\n * \n * @param player - Current player state\n * @returns Updated player state with no effects\n * \n * @example\n * ```typescript\n * const clearedPlayer = clearAllEffects(player);\n * ```\n * \n * @public\n * @korean 전체효과제거\n */\nexport function clearAllEffects(player: PlayerState): PlayerState {\n  return {\n    ...player,\n    statusEffects: [],\n    activeEffects: [],\n  };\n}\n\n/**\n * Calculates combat stat modifiers based on active status effects.\n * \n * **Korean**: 효과 기반 전투 배율 계산 (Calculate Effect-Based Combat Modifiers)\n * \n * Returns multipliers for various combat attributes affected by status effects.\n * \n * @param player - Current player state\n * @returns Object with stat multipliers (1.0 = no change)\n * \n * @example\n * ```typescript\n * const modifiers = getEffectModifiers(player);\n * const effectiveDamage = baseDamage * modifiers.attackPower;\n * const effectiveSpeed = baseSpeed * modifiers.speed;\n * ```\n * \n * @public\n * @korean 효과배율계산\n */\nexport function getEffectModifiers(player: PlayerState): {\n  attackPower: number;\n  defense: number;\n  speed: number;\n  technique: number;\n  staminaRegen: number;\n  kiRegen: number;\n} {\n  let attackPower = 1.0;\n  let defense = 1.0;\n  let speed = 1.0;\n  let technique = 1.0;\n  let staminaRegen = 1.0;\n  let kiRegen = 1.0;\n\n  for (const effect of player.statusEffects) {\n    // UNCONSCIOUSNESS takes precedence - early return with complete incapacitation\n    if (effect.type === VitalPointEffectType.UNCONSCIOUSNESS) {\n      return {\n        attackPower: 0,\n        defense: 0,\n        speed: 0,\n        technique: 0,\n        staminaRegen: 0,\n        kiRegen: 0,\n      };\n    }\n\n    // Apply other effect modifiers multiplicatively\n    switch (effect.type) {\n      case VitalPointEffectType.PARALYSIS:\n        // Severe movement and action impairment\n        attackPower *= 0.3;\n        speed *= 0.2;\n        technique *= 0.4;\n        break;\n\n      case VitalPointEffectType.STUN:\n        // Moderate impairment\n        attackPower *= 0.5;\n        defense *= 0.6;\n        speed *= 0.5;\n        technique *= 0.6;\n        break;\n\n      case VitalPointEffectType.PAIN:\n        // Reduces effectiveness across the board\n        attackPower *= 0.7;\n        defense *= 0.8;\n        speed *= 0.8;\n        technique *= 0.7;\n        break;\n\n      case VitalPointEffectType.BLOOD_FLOW_RESTRICTION:\n        // Gradual weakening from reduced circulation\n        attackPower *= 0.85;\n        staminaRegen *= 0.5;\n        break;\n\n      case VitalPointEffectType.BREATHLESSNESS:\n        // NOTE: Stamina regen is handled by BreathingDisruptionSystem.calculateStaminaRegen()\n        // which applies severity-specific multipliers (25%-75% depending on disruption level).\n        // DO NOT apply a flat multiplier here as it would compound with the breathing system.\n        // Only apply secondary effects here.\n        speed *= 0.7; // Reduced movement speed due to breathing difficulty\n        break;\n\n      case VitalPointEffectType.DISORIENTATION:\n        // Accuracy and technique affected\n        technique *= 0.6;\n        defense *= 0.7;\n        break;\n\n      case VitalPointEffectType.WEAKNESS:\n        // Overall power reduction\n        attackPower *= 0.7;\n        defense *= 0.8;\n        break;\n\n      case VitalPointEffectType.NERVE_DISRUPTION:\n        // Ki system and coordination impaired\n        kiRegen *= 0.5;\n        attackPower *= 0.8;\n        technique *= 0.7;\n        break;\n\n      case VitalPointEffectType.ORGAN_DISRUPTION:\n        // Internal damage affecting all systems\n        attackPower *= 0.6;\n        defense *= 0.7;\n        staminaRegen *= 0.4;\n        kiRegen *= 0.4;\n        break;\n    }\n  }\n\n  return {\n    attackPower,\n    defense,\n    speed,\n    technique,\n    staminaRegen,\n    kiRegen,\n  };\n}\n\n/**\n * Checks if player has a specific effect type active.\n * \n * **Korean**: 효과 활성 여부 확인 (Check Effect Active)\n * \n * @param player - Current player state\n * @param effectType - Type to check for\n * @returns True if effect type is active\n * \n * @example\n * ```typescript\n * if (hasEffect(player, VitalPointEffectType.PARALYSIS)) {\n *   console.log(\"Player is paralyzed!\");\n * }\n * ```\n * \n * @public\n * @korean 효과확인\n */\nexport function hasEffect(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): boolean {\n  return player.statusEffects.some((effect) => effect.type === effectType);\n}\n\n/**\n * Gets all active effects of a specific type.\n * \n * **Korean**: 유형별 활성 효과 조회 (Get Effects by Type)\n * \n * @param player - Current player state\n * @param effectType - Type to retrieve\n * @returns Array of matching effects\n * \n * @public\n * @korean 유형별효과조회\n */\nexport function getEffectsByType(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): StatusEffect[] {\n  return player.statusEffects.filter((effect) => effect.type === effectType);\n}\n\n/**\n * Gets the total number of active status effects.\n * \n * **Korean**: 활성 효과 개수 조회 (Get Active Effect Count)\n * \n * @param player - Current player state\n * @returns Number of active effects\n * \n * @public\n * @korean 효과개수조회\n */\nexport function getActiveEffectCount(player: PlayerState): number {\n  return player.statusEffects.length;\n}\n\n/**\n * Checks if player can accept new status effects.\n * \n * **Korean**: 효과 추가 가능 여부 확인 (Can Add More Effects)\n * \n * @param player - Current player state\n * @returns True if under MAX_CONCURRENT_EFFECTS limit\n * \n * @public\n * @korean 효과추가가능확인\n */\nexport function canAddMoreEffects(player: PlayerState): boolean {\n  return player.statusEffects.length < MAX_CONCURRENT_EFFECTS;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,mBACd,QACA,SACa;CACb,MAAM,cAAc,KAAK,KAAK;CAG9B,MAAM,iBAAiB,oBACrB,OAAO,eACP,SACA,YACD;CAGD,MAAM,kBAAkB,eAAe,KAAK,WAAW,OAAO,GAAG;CAEjE,OAAO;EACL,GAAG;EACH,eAAe;EACf,eAAe;EAChB;;;;;;;;;;;;;;;;;;;;;AAsBH,SAAgB,qBACd,QACA,cAAsB,KAAK,KAAK,EACnB;CACb,MAAM,gBAAgB,OAAO,cAAc,QACxC,WAAW,OAAO,UAAU,YAC9B;CAED,MAAM,kBAAkB,cAAc,KAAK,WAAW,OAAO,GAAG;CAEhE,OAAO;EACL,GAAG;EACH,eAAe;EACf,eAAe;EAChB;;;;;;;;;;;;;;;;;;;;;;AAwHH,SAAgB,mBAAmB,QAOjC;CACA,IAAI,cAAc;CAClB,IAAI,UAAU;CACd,IAAI,QAAQ;CACZ,IAAI,YAAY;CAChB,IAAI,eAAe;CACnB,IAAI,UAAU;CAEd,KAAK,MAAM,UAAU,OAAO,eAAe;EAEzC,IAAI,OAAO,SAAS,qBAAqB,iBACvC,OAAO;GACL,aAAa;GACb,SAAS;GACT,OAAO;GACP,WAAW;GACX,cAAc;GACd,SAAS;GACV;EAIH,QAAQ,OAAO,MAAf;GACE,KAAK,qBAAqB;IAExB,eAAe;IACf,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,gBAAgB;IAChB;GAEF,KAAK,qBAAqB;IAKxB,SAAS;IACT;GAEF,KAAK,qBAAqB;IAExB,aAAa;IACb,WAAW;IACX;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX;GAEF,KAAK,qBAAqB;IAExB,WAAW;IACX,eAAe;IACf,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX;;;CAIN,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"PlayerEffectManager.js","names":[],"sources":["../../src/systems/PlayerEffectManager.ts"],"sourcesContent":["/**\n * Player Effect Manager for tracking and applying status effects.\n * \n * **Korean**: 플레이어 효과 관리자 (Player Effect Manager)\n * \n * This module provides utilities for managing status effects on player state,\n * including adding effects with stacking logic, removing expired effects,\n * and applying effect-based combat modifiers.\n * \n * ## Key Features\n * \n * - **Effect Tracking**: Add, remove, and update status effects\n * - **Stacking Logic**: Manage concurrent effects (max 5)\n * - **Expiration Handling**: Auto-remove expired effects\n * - **Combat Modifiers**: Calculate effect-based stat changes\n * \n * @module systems/PlayerEffectManager\n * @category Player Management\n * @korean 플레이어효과관리\n */\n\nimport { VitalPointEffectType } from \"../types/common\";\nimport { StatusEffect } from \"./types\";\nimport { PlayerState } from \"./player\";\nimport { applyEffectStacking, MAX_CONCURRENT_EFFECTS } from \"./EffectCalculator\";\n\n/**\n * Adds status effects to a player's active effects list.\n * \n * **Korean**: 플레이어에 효과 추가 (Add Effects to Player)\n * \n * Applies stacking logic and respects the max concurrent effects limit.\n * \n * @param player - Current player state\n * @param effects - New effects to add\n * @returns Updated player state with new effects\n * \n * @example\n * ```typescript\n * const updatedPlayer = addEffectsToPlayer(\n *   player,\n *   [paralyze, bleed, stun]\n * );\n * ```\n * \n * @korean 효과추가\n */\nexport function addEffectsToPlayer(\n  player: PlayerState,\n  effects: readonly StatusEffect[]\n): PlayerState {\n  const currentTime = Date.now();\n\n  const updatedEffects = applyEffectStacking(\n    player.statusEffects,\n    effects,\n    currentTime\n  );\n\n  const activeEffectIds = updatedEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: updatedEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes expired status effects from player.\n * \n * **Korean**: 만료 효과 제거 (Remove Expired Effects)\n * \n * Filters out effects whose endTime has passed.\n * \n * @param player - Current player state\n * @param currentTime - Current timestamp (default: Date.now())\n * @returns Updated player state with expired effects removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeExpiredEffects(player, Date.now());\n * ```\n * \n * @korean 만료효과제거\n */\nexport function removeExpiredEffects(\n  player: PlayerState,\n  currentTime: number = Date.now()\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.endTime > currentTime\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes a specific status effect by ID.\n * \n * **Korean**: 특정 효과 제거 (Remove Specific Effect)\n * \n * @param player - Current player state\n * @param effectId - ID of effect to remove\n * @returns Updated player state with effect removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeEffectById(player, \"stun_12345\");\n * ```\n * \n * @korean 효과제거\n */\nexport function removeEffectById(\n  player: PlayerState,\n  effectId: string\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.id !== effectId\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Removes all status effects of a specific type.\n * \n * **Korean**: 특정 유형 효과 모두 제거 (Remove All Effects of Type)\n * \n * @param player - Current player state\n * @param effectType - Type of effects to remove\n * @returns Updated player state with effects removed\n * \n * @example\n * ```typescript\n * const updatedPlayer = removeEffectsByType(\n *   player,\n *   VitalPointEffectType.PARALYSIS\n * );\n * ```\n * \n * @korean 유형별효과제거\n */\nexport function removeEffectsByType(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): PlayerState {\n  const activeEffects = player.statusEffects.filter(\n    (effect) => effect.type !== effectType\n  );\n\n  const activeEffectIds = activeEffects.map((effect) => effect.id);\n\n  return {\n    ...player,\n    statusEffects: activeEffects,\n    activeEffects: activeEffectIds,\n  };\n}\n\n/**\n * Clears all status effects from player.\n * \n * **Korean**: 모든 효과 제거 (Clear All Effects)\n * \n * Useful for healing items, rest periods, or match resets.\n * \n * @param player - Current player state\n * @returns Updated player state with no effects\n * \n * @example\n * ```typescript\n * const clearedPlayer = clearAllEffects(player);\n * ```\n * \n * @korean 전체효과제거\n */\nexport function clearAllEffects(player: PlayerState): PlayerState {\n  return {\n    ...player,\n    statusEffects: [],\n    activeEffects: [],\n  };\n}\n\n/**\n * Calculates combat stat modifiers based on active status effects.\n * \n * **Korean**: 효과 기반 전투 배율 계산 (Calculate Effect-Based Combat Modifiers)\n * \n * Returns multipliers for various combat attributes affected by status effects.\n * \n * @param player - Current player state\n * @returns Object with stat multipliers (1.0 = no change)\n * \n * @example\n * ```typescript\n * const modifiers = getEffectModifiers(player);\n * const effectiveDamage = baseDamage * modifiers.attackPower;\n * const effectiveSpeed = baseSpeed * modifiers.speed;\n * ```\n * \n * @korean 효과배율계산\n */\nexport function getEffectModifiers(player: PlayerState): {\n  attackPower: number;\n  defense: number;\n  speed: number;\n  technique: number;\n  staminaRegen: number;\n  kiRegen: number;\n} {\n  let attackPower = 1.0;\n  let defense = 1.0;\n  let speed = 1.0;\n  let technique = 1.0;\n  let staminaRegen = 1.0;\n  let kiRegen = 1.0;\n\n  for (const effect of player.statusEffects) {\n    // UNCONSCIOUSNESS takes precedence - early return with complete incapacitation\n    if (effect.type === VitalPointEffectType.UNCONSCIOUSNESS) {\n      return {\n        attackPower: 0,\n        defense: 0,\n        speed: 0,\n        technique: 0,\n        staminaRegen: 0,\n        kiRegen: 0,\n      };\n    }\n\n    // Apply other effect modifiers multiplicatively\n    switch (effect.type) {\n      case VitalPointEffectType.PARALYSIS:\n        // Severe movement and action impairment\n        attackPower *= 0.3;\n        speed *= 0.2;\n        technique *= 0.4;\n        break;\n\n      case VitalPointEffectType.STUN:\n        // Moderate impairment\n        attackPower *= 0.5;\n        defense *= 0.6;\n        speed *= 0.5;\n        technique *= 0.6;\n        break;\n\n      case VitalPointEffectType.PAIN:\n        // Reduces effectiveness across the board\n        attackPower *= 0.7;\n        defense *= 0.8;\n        speed *= 0.8;\n        technique *= 0.7;\n        break;\n\n      case VitalPointEffectType.BLOOD_FLOW_RESTRICTION:\n        // Gradual weakening from reduced circulation\n        attackPower *= 0.85;\n        staminaRegen *= 0.5;\n        break;\n\n      case VitalPointEffectType.BREATHLESSNESS:\n        // NOTE: Stamina regen is handled by BreathingDisruptionSystem.calculateStaminaRegen()\n        // which applies severity-specific multipliers (25%-75% depending on disruption level).\n        // DO NOT apply a flat multiplier here as it would compound with the breathing system.\n        // Only apply secondary effects here.\n        speed *= 0.7; // Reduced movement speed due to breathing difficulty\n        break;\n\n      case VitalPointEffectType.DISORIENTATION:\n        // Accuracy and technique affected\n        technique *= 0.6;\n        defense *= 0.7;\n        break;\n\n      case VitalPointEffectType.WEAKNESS:\n        // Overall power reduction\n        attackPower *= 0.7;\n        defense *= 0.8;\n        break;\n\n      case VitalPointEffectType.NERVE_DISRUPTION:\n        // Ki system and coordination impaired\n        kiRegen *= 0.5;\n        attackPower *= 0.8;\n        technique *= 0.7;\n        break;\n\n      case VitalPointEffectType.ORGAN_DISRUPTION:\n        // Internal damage affecting all systems\n        attackPower *= 0.6;\n        defense *= 0.7;\n        staminaRegen *= 0.4;\n        kiRegen *= 0.4;\n        break;\n    }\n  }\n\n  return {\n    attackPower,\n    defense,\n    speed,\n    technique,\n    staminaRegen,\n    kiRegen,\n  };\n}\n\n/**\n * Checks if player has a specific effect type active.\n * \n * **Korean**: 효과 활성 여부 확인 (Check Effect Active)\n * \n * @param player - Current player state\n * @param effectType - Type to check for\n * @returns True if effect type is active\n * \n * @example\n * ```typescript\n * if (hasEffect(player, VitalPointEffectType.PARALYSIS)) {\n *   console.log(\"Player is paralyzed!\");\n * }\n * ```\n * \n * @korean 효과확인\n */\nexport function hasEffect(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): boolean {\n  return player.statusEffects.some((effect) => effect.type === effectType);\n}\n\n/**\n * Gets all active effects of a specific type.\n * \n * **Korean**: 유형별 활성 효과 조회 (Get Effects by Type)\n * \n * @param player - Current player state\n * @param effectType - Type to retrieve\n * @returns Array of matching effects\n * \n * @korean 유형별효과조회\n */\nexport function getEffectsByType(\n  player: PlayerState,\n  effectType: VitalPointEffectType\n): StatusEffect[] {\n  return player.statusEffects.filter((effect) => effect.type === effectType);\n}\n\n/**\n * Gets the total number of active status effects.\n * \n * **Korean**: 활성 효과 개수 조회 (Get Active Effect Count)\n * \n * @param player - Current player state\n * @returns Number of active effects\n * \n * @korean 효과개수조회\n */\nexport function getActiveEffectCount(player: PlayerState): number {\n  return player.statusEffects.length;\n}\n\n/**\n * Checks if player can accept new status effects.\n * \n * **Korean**: 효과 추가 가능 여부 확인 (Can Add More Effects)\n * \n * @param player - Current player state\n * @returns True if under MAX_CONCURRENT_EFFECTS limit\n * \n * @korean 효과추가가능확인\n */\nexport function canAddMoreEffects(player: PlayerState): boolean {\n  return player.statusEffects.length < MAX_CONCURRENT_EFFECTS;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,mBACd,QACA,SACa;CACb,MAAM,cAAc,KAAK,KAAK;CAE9B,MAAM,iBAAiB,oBACrB,OAAO,eACP,SACA,YACD;CAED,MAAM,kBAAkB,eAAe,KAAK,WAAW,OAAO,GAAG;CAEjE,OAAO;EACL,GAAG;EACH,eAAe;EACf,eAAe;EAChB;;;;;;;;;;;;;;;;;;;;AAqBH,SAAgB,qBACd,QACA,cAAsB,KAAK,KAAK,EACnB;CACb,MAAM,gBAAgB,OAAO,cAAc,QACxC,WAAW,OAAO,UAAU,YAC9B;CAED,MAAM,kBAAkB,cAAc,KAAK,WAAW,OAAO,GAAG;CAEhE,OAAO;EACL,GAAG;EACH,eAAe;EACf,eAAe;EAChB;;;;;;;;;;;;;;;;;;;;;AAoHH,SAAgB,mBAAmB,QAOjC;CACA,IAAI,cAAc;CAClB,IAAI,UAAU;CACd,IAAI,QAAQ;CACZ,IAAI,YAAY;CAChB,IAAI,eAAe;CACnB,IAAI,UAAU;CAEd,KAAK,MAAM,UAAU,OAAO,eAAe;EAEzC,IAAI,OAAO,SAAS,qBAAqB,iBACvC,OAAO;GACL,aAAa;GACb,SAAS;GACT,OAAO;GACP,WAAW;GACX,cAAc;GACd,SAAS;GACV;EAIH,QAAQ,OAAO,MAAf;GACE,KAAK,qBAAqB;IAExB,eAAe;IACf,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,SAAS;IACT,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,gBAAgB;IAChB;GAEF,KAAK,qBAAqB;IAKxB,SAAS;IACT;GAEF,KAAK,qBAAqB;IAExB,aAAa;IACb,WAAW;IACX;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX;GAEF,KAAK,qBAAqB;IAExB,WAAW;IACX,eAAe;IACf,aAAa;IACb;GAEF,KAAK,qBAAqB;IAExB,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX;;;CAIN,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD"}

package/lib/systems/ResponsiveScaling.d.ts

@@ -91,7 +91,6 @@ export declare const FONT_SIZE_CONSTRAINTS: {
  * getScreenSize(1920); // 'xlarge'
  * ```
  *
- * @public
  * @korean 화면크기얻기
  */
 export declare function getScreenSize(width: number): ScreenSize;
@@ -117,7 +116,6 @@ export declare function getScreenSize(width: number): ScreenSize;
  * calculateFontSize(20, 'xlarge', 14, 24); // 24 (clamped from 28)
  * ```
  *
- * @public
  * @korean 글꼴크기계산
  */
 export declare function calculateFontSize(baseSize: number, screenSize: ScreenSize, minSize?: number, maxSize?: number): number;
@@ -138,7 +136,6 @@ export declare function calculateFontSize(baseSize: number, screenSize: ScreenSi
  * calculateSpacing(20, 'xlarge');  // 30 (20 * 1.5)
  * ```
  *
- * @public
  * @korean 간격계산
  */
 export declare function calculateSpacing(baseSpacing: number, screenSize: ScreenSize): number;
@@ -155,7 +152,6 @@ export declare function calculateSpacing(baseSpacing: number, screenSize: Screen
  * getFontScale('xlarge');  // 1.4
  * ```
  *
- * @public
  * @korean 글꼴스케일얻기
  */
 export declare function getFontScale(screenSize: ScreenSize): number;
@@ -172,7 +168,6 @@ export declare function getFontScale(screenSize: ScreenSize): number;
  * getSpacingScale('xlarge');  // 1.5
  * ```
  *
- * @public
  * @korean 간격스케일얻기
  */
 export declare function getSpacingScale(screenSize: ScreenSize): number;
@@ -191,7 +186,6 @@ export declare function getSpacingScale(screenSize: ScreenSize): number;
  * // 'font-size 200ms linear, padding 200ms linear, ...'
  * ```
  *
- * @public
  * @korean 전환문자열생성
  */
 export declare function createTransitionString(config?: Partial<ResizeTransitionConfig>): string;
@@ -210,7 +204,6 @@ export declare function createTransitionString(config?: Partial<ResizeTransition
  * console.log(config.spacingScale); // 0.5
  * ```
  *
- * @public
  * @korean 반응형설정생성
  */
 export declare function createResponsiveConfig(width: number, height: number): ResponsiveScaleConfig;
@@ -238,7 +231,6 @@ export declare function createResponsiveConfig(width: number, height: number): R
  * </div>
  * ```
  *
- * @public
  * @korean 반응형값계산
  */
 export declare function calculateResponsiveValues(width: number, baseFontSize?: number, baseSpacing?: number): ResponsiveValues;
@@ -261,7 +253,6 @@ export declare function calculateResponsiveValues(width: number, baseFontSize?:
  * console.log(result.isMobile);    // false
  * ```
  *
- * @public
  * @korean 화면크기테스트
  */
 export declare function testScreenSize(width: number, height: number): ScreenSizeTestResult;
@@ -271,7 +262,6 @@ export declare function testScreenSize(width: number, height: number): ScreenSiz
  * @param width - Viewport width
  * @returns True if mobile screen size
  *
- * @public
  * @korean 모바일확인
  */
 export declare function isMobileSize(width: number): boolean;
@@ -281,7 +271,6 @@ export declare function isMobileSize(width: number): boolean;
  * @param width - Viewport width
  * @returns True if tablet screen size
  *
- * @public
  * @korean 태블릿확인
  */
 export declare function isTabletSize(width: number): boolean;
@@ -291,7 +280,6 @@ export declare function isTabletSize(width: number): boolean;
  * @param width - Viewport width
  * @returns True if desktop, large, or xlarge screen size
  *
- * @public
  * @korean 데스크톱확인
  */
 export declare function isDesktopSize(width: number): boolean;

package/lib/systems/ResponsiveScaling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponsiveScaling.d.ts","sourceRoot":"","sources":["../../src/systems/ResponsiveScaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAM3B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,YAMnB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAMtB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBAK9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;IAChC,6CAA6C;;IAE7C,iDAAiD;;IAEjD,oCAAoC;;CAE5B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,MAA4C,EACrD,OAAO,GAAE,MAAuC,GAC/C,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,MAAM,CAGR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC3C,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,qBAAqB,CAWvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,MAAwC,EACtD,WAAW,GAAE,MAAW,GACvB,gBAAgB,CA6BlB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,oBAAoB,CActB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"ResponsiveScaling.d.ts","sourceRoot":"","sources":["../../src/systems/ResponsiveScaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAM3B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,YAMnB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAMtB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,sBAK9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;IAChC,6CAA6C;;IAE7C,iDAAiD;;IAEjD,oCAAoC;;CAE5B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMvD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,MAA4C,EACrD,OAAO,GAAE,MAAuC,GAC/C,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,MAAM,CAGR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC3C,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,qBAAqB,CAWvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,MAAwC,EACtD,WAAW,GAAE,MAAW,GACvB,gBAAgB,CA6BlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,oBAAoB,CActB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD"}

package/lib/systems/ResponsiveScaling.js

@@ -101,7 +101,6 @@ var FONT_SIZE_CONSTRAINTS = {
 * getScreenSize(1920); // 'xlarge'
 * ```
 * 
-* @public
 * @korean 화면크기얻기
 */
 function getScreenSize(width) {
@@ -133,7 +132,6 @@ function getScreenSize(width) {
 * calculateFontSize(20, 'xlarge', 14, 24); // 24 (clamped from 28)
 * ```
 * 
-* @public
 * @korean 글꼴크기계산
 */
 function calculateFontSize(baseSize, screenSize, minSize = FONT_SIZE_CONSTRAINTS.MIN_BODY_SIZE, maxSize = FONT_SIZE_CONSTRAINTS.MAX_SIZE) {
@@ -157,7 +155,6 @@ function calculateFontSize(baseSize, screenSize, minSize = FONT_SIZE_CONSTRAINTS
 * calculateSpacing(20, 'xlarge');  // 30 (20 * 1.5)
 * ```
 * 
-* @public
 * @korean 간격계산
 */
 function calculateSpacing(baseSpacing, screenSize) {
@@ -177,7 +174,6 @@ function calculateSpacing(baseSpacing, screenSize) {
 * getFontScale('xlarge');  // 1.4
 * ```
 * 
-* @public
 * @korean 글꼴스케일얻기
 */
 function getFontScale(screenSize) {
@@ -196,7 +192,6 @@ function getFontScale(screenSize) {
 * getSpacingScale('xlarge');  // 1.5
 * ```
 * 
-* @public
 * @korean 간격스케일얻기
 */
 function getSpacingScale(screenSize) {
@@ -217,7 +212,6 @@ function getSpacingScale(screenSize) {
 * // 'font-size 200ms linear, padding 200ms linear, ...'
 * ```
 * 
-* @public
 * @korean 전환문자열생성
 */
 function createTransitionString(config = {}) {
@@ -240,7 +234,6 @@ function createTransitionString(config = {}) {
 * console.log(config.spacingScale); // 0.5
 * ```
 * 
-* @public
 * @korean 반응형설정생성
 */
 function createResponsiveConfig(width, height) {
@@ -279,7 +272,6 @@ function createResponsiveConfig(width, height) {
 * </div>
 * ```
 * 
-* @public
 * @korean 반응형값계산
 */
 function calculateResponsiveValues(width, baseFontSize = FONT_SIZE_CONSTRAINTS.BASE_SIZE, baseSpacing = 16) {
@@ -321,7 +313,6 @@ function calculateResponsiveValues(width, baseFontSize = FONT_SIZE_CONSTRAINTS.B
 * console.log(result.isMobile);    // false
 * ```
 * 
-* @public
 * @korean 화면크기테스트
 */
 function testScreenSize(width, height) {
@@ -342,7 +333,6 @@ function testScreenSize(width, height) {
 * @param width - Viewport width
 * @returns True if mobile screen size
 * 
-* @public
 * @korean 모바일확인
 */
 function isMobileSize(width) {
@@ -354,7 +344,6 @@ function isMobileSize(width) {
 * @param width - Viewport width
 * @returns True if tablet screen size
 * 
-* @public
 * @korean 태블릿확인
 */
 function isTabletSize(width) {
@@ -366,7 +355,6 @@ function isTabletSize(width) {
 * @param width - Viewport width
 * @returns True if desktop, large, or xlarge screen size
 * 
-* @public
 * @korean 데스크톱확인
 */
 function isDesktopSize(width) {

package/lib/systems/ResponsiveScaling.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResponsiveScaling.js","names":[],"sources":["../../src/systems/ResponsiveScaling.ts"],"sourcesContent":["/**\n * Responsive Scaling System for Black Trigram\n * \n * Centralized scaling calculations for responsive layout across all screen sizes.\n * Implements proportional font and spacing scaling with smooth transitions.\n * \n * Features:\n * - Five screen size categories (mobile, tablet, desktop, large, xlarge)\n * - Font scaling: 0.8x (mobile) to 1.4x (4K displays)\n * - Spacing scaling: 0.5x (mobile) to 1.5x (4K displays)\n * - Korean text readability: 14-24px range enforced\n * - Smooth CSS transitions for resize operations\n * - 60fps performance maintained\n * \n * @module systems/ResponsiveScaling\n * @category Responsive Layout\n * @korean 반응형스케일시스템\n */\n\nimport type {\n  ScreenSize,\n  ResponsiveBreakpoints,\n  FontScaleMap,\n  SpacingScaleMap,\n  ResponsiveScaleConfig,\n  ResizeTransitionConfig,\n  ResponsiveValues,\n  ScreenSizeTestResult,\n} from '../types/ResponsiveTypes';\n\n// Re-export types for convenience\nexport type {\n  ScreenSize,\n  ResponsiveBreakpoints,\n  FontScaleMap,\n  SpacingScaleMap,\n  ResponsiveScaleConfig,\n  ResizeTransitionConfig,\n  ResponsiveValues,\n  ScreenSizeTestResult,\n};\n\n/**\n * Standard breakpoints for responsive design\n * Maps viewport widths to device categories\n * \n * Note: XLARGE is defined as a reference value (2560px) but xlarge category\n * starts at LARGE (1920px). This allows for consistent scaling across all\n * displays from 1920px upwards, including 2K, 4K, and ultra-wide monitors.\n * \n * @constant\n * @category Responsive Layout\n */\nexport const RESPONSIVE_BREAKPOINTS: ResponsiveBreakpoints = {\n  MOBILE: 768,      // < 768px: Mobile devices\n  TABLET: 1024,     // 768-1024px: Tablets\n  DESKTOP: 1440,    // 1024-1440px: Standard desktop\n  LARGE: 1920,      // 1440-1920px: HD/2K displays\n  XLARGE: 2560,     // Reference for 4K displays (xlarge starts at 1920px)\n} as const;\n\n/**\n * Font scaling multipliers by screen size\n * Base size (16px) * scale = final size\n * \n * Results clamped to 14-24px for readability\n * \n * @constant\n * @category Typography\n */\nexport const FONT_SCALE_MAP: FontScaleMap = {\n  mobile: 0.8,    // 16px * 0.8 = 12.8px → clamped to 14px min\n  tablet: 0.9,    // 16px * 0.9 = 14.4px\n  desktop: 1.0,   // 16px * 1.0 = 16px (base)\n  large: 1.2,     // 16px * 1.2 = 19.2px\n  xlarge: 1.4,    // 16px * 1.4 = 22.4px → clamped to 24px max\n} as const;\n\n/**\n * Spacing scaling multipliers by screen size\n * Base spacing * scale = final spacing\n * \n * @constant\n * @category Layout\n */\nexport const SPACING_SCALE_MAP: SpacingScaleMap = {\n  mobile: 0.5,    // Compact spacing for small screens\n  tablet: 0.75,   // Moderate spacing for tablets\n  desktop: 1.0,   // Standard reference spacing\n  large: 1.25,    // Spacious for large displays\n  xlarge: 1.5,    // Maximum spacing for 4K\n} as const;\n\n/**\n * Default transition configuration for smooth resizing\n * Optimized for 60fps performance\n * \n * @constant\n * @category Animation\n */\nexport const DEFAULT_RESIZE_TRANSITION: ResizeTransitionConfig = {\n  duration: '300ms',\n  easing: 'ease-in-out',\n  properties: ['font-size', 'padding', 'margin', 'width', 'height'] as const,\n  enabled: true,\n} as const;\n\n/**\n * Font size constraints for Korean and English text\n * Ensures readability across all screen sizes\n * \n * @constant\n * @category Typography\n */\nexport const FONT_SIZE_CONSTRAINTS = {\n  /** Minimum body text size for readability */\n  MIN_BODY_SIZE: 14,\n  /** Maximum size before text becomes too large */\n  MAX_SIZE: 24,\n  /** Base reference size (desktop) */\n  BASE_SIZE: 16,\n} as const;\n\n/**\n * Determine screen size category from viewport width\n * \n * Categories:\n * - mobile: < 768px (phones)\n * - tablet: 768-1024px (tablets)\n * - desktop: 1024-1440px (standard monitors)\n * - large: 1440-1920px (HD/2K displays)\n * - xlarge: ≥1920px (4K/ultra-wide)\n * \n * @param width - Viewport width in pixels\n * @returns Screen size category\n * \n * @example\n * ```typescript\n * getScreenSize(375);  // 'mobile'\n * getScreenSize(768);  // 'tablet'\n * getScreenSize(1920); // 'xlarge'\n * ```\n * \n * @public\n * @korean 화면크기얻기\n */\nexport function getScreenSize(width: number): ScreenSize {\n  if (width < RESPONSIVE_BREAKPOINTS.MOBILE) return 'mobile';\n  if (width < RESPONSIVE_BREAKPOINTS.TABLET) return 'tablet';\n  if (width < RESPONSIVE_BREAKPOINTS.DESKTOP) return 'desktop';\n  if (width < RESPONSIVE_BREAKPOINTS.LARGE) return 'large';\n  return 'xlarge';\n}\n\n/**\n * Calculate scaled font size with readability constraints\n * \n * Formula: baseSize * scale\n * Clamped: max(minSize, min(maxSize, calculated))\n * \n * Ensures Korean and English text remain readable at all sizes\n * \n * @param baseSize - Base font size in pixels (typically 16px)\n * @param screenSize - Current screen size category\n * @param minSize - Minimum allowed size (default: 14px)\n * @param maxSize - Maximum allowed size (default: 24px)\n * @returns Calculated font size in pixels\n * \n * @example\n * ```typescript\n * calculateFontSize(16, 'mobile');  // 14 (clamped from 12.8)\n * calculateFontSize(16, 'desktop'); // 16\n * calculateFontSize(16, 'xlarge');  // 22.4\n * calculateFontSize(20, 'xlarge', 14, 24); // 24 (clamped from 28)\n * ```\n * \n * @public\n * @korean 글꼴크기계산\n */\nexport function calculateFontSize(\n  baseSize: number,\n  screenSize: ScreenSize,\n  minSize: number = FONT_SIZE_CONSTRAINTS.MIN_BODY_SIZE,\n  maxSize: number = FONT_SIZE_CONSTRAINTS.MAX_SIZE\n): number {\n  const scale = FONT_SCALE_MAP[screenSize];\n  const scaled = baseSize * scale;\n  \n  // Clamp to readable range\n  return Math.max(minSize, Math.min(maxSize, scaled));\n}\n\n/**\n * Calculate scaled spacing value\n * \n * Formula: baseSpacing * scale\n * Rounded to nearest integer for crisp rendering\n * \n * @param baseSpacing - Base spacing value in pixels\n * @param screenSize - Current screen size category\n * @returns Calculated spacing in pixels (rounded)\n * \n * @example\n * ```typescript\n * calculateSpacing(20, 'mobile');  // 10 (20 * 0.5)\n * calculateSpacing(20, 'desktop'); // 20\n * calculateSpacing(20, 'xlarge');  // 30 (20 * 1.5)\n * ```\n * \n * @public\n * @korean 간격계산\n */\nexport function calculateSpacing(\n  baseSpacing: number,\n  screenSize: ScreenSize\n): number {\n  const scale = SPACING_SCALE_MAP[screenSize];\n  return Math.round(baseSpacing * scale);\n}\n\n/**\n * Get font scale multiplier for screen size\n * \n * @param screenSize - Screen size category\n * @returns Scale multiplier (0.8 - 1.4)\n * \n * @example\n * ```typescript\n * getFontScale('mobile');  // 0.8\n * getFontScale('desktop'); // 1.0\n * getFontScale('xlarge');  // 1.4\n * ```\n * \n * @public\n * @korean 글꼴스케일얻기\n */\nexport function getFontScale(screenSize: ScreenSize): number {\n  return FONT_SCALE_MAP[screenSize];\n}\n\n/**\n * Get spacing scale multiplier for screen size\n * \n * @param screenSize - Screen size category\n * @returns Scale multiplier (0.5 - 1.5)\n * \n * @example\n * ```typescript\n * getSpacingScale('mobile');  // 0.5\n * getSpacingScale('desktop'); // 1.0\n * getSpacingScale('xlarge');  // 1.5\n * ```\n * \n * @public\n * @korean 간격스케일얻기\n */\nexport function getSpacingScale(screenSize: ScreenSize): number {\n  return SPACING_SCALE_MAP[screenSize];\n}\n\n/**\n * Create CSS transition string for smooth resizing\n * \n * @param config - Transition configuration (optional)\n * @returns CSS transition string\n * \n * @example\n * ```typescript\n * createTransitionString();\n * // 'font-size 300ms ease-in-out, padding 300ms ease-in-out, ...'\n * \n * createTransitionString({ duration: '200ms', easing: 'linear' });\n * // 'font-size 200ms linear, padding 200ms linear, ...'\n * ```\n * \n * @public\n * @korean 전환문자열생성\n */\nexport function createTransitionString(\n  config: Partial<ResizeTransitionConfig> = {}\n): string {\n  const {\n    duration = DEFAULT_RESIZE_TRANSITION.duration,\n    easing = DEFAULT_RESIZE_TRANSITION.easing,\n    properties = DEFAULT_RESIZE_TRANSITION.properties,\n    enabled = DEFAULT_RESIZE_TRANSITION.enabled,\n  } = config;\n\n  if (!enabled) {\n    return 'none';\n  }\n\n  return properties\n    .map((prop) => `${prop} ${duration} ${easing}`)\n    .join(', ');\n}\n\n/**\n * Create complete responsive scale configuration\n * \n * @param width - Viewport width\n * @param height - Viewport height\n * @returns Complete responsive configuration\n * \n * @example\n * ```typescript\n * const config = createResponsiveConfig(375, 667);\n * console.log(config.screenSize);  // 'mobile'\n * console.log(config.fontScale);   // 0.8\n * console.log(config.spacingScale); // 0.5\n * ```\n * \n * @public\n * @korean 반응형설정생성\n */\nexport function createResponsiveConfig(\n  width: number,\n  height: number\n): ResponsiveScaleConfig {\n  const screenSize = getScreenSize(width);\n  const fontScale = getFontScale(screenSize);\n  const spacingScale = getSpacingScale(screenSize);\n\n  return {\n    screenSize,\n    fontScale,\n    spacingScale,\n    viewport: { width, height },\n  };\n}\n\n/**\n * Calculate all responsive values for a component\n * \n * Computes font sizes, spacing, and transitions based on screen size\n * Ready-to-use values for component styling\n * \n * @param width - Viewport width\n * @param baseFontSize - Base font size (default: 16px)\n * @param baseSpacing - Base spacing unit (default: 16px)\n * @returns Complete responsive values\n * \n * @example\n * ```typescript\n * const values = calculateResponsiveValues(375);\n * \n * <div style={{\n *   fontSize: values.fontSize.body,\n *   padding: values.spacing.md,\n *   transition: values.transition,\n * }}>\n *   Responsive content\n * </div>\n * ```\n * \n * @public\n * @korean 반응형값계산\n */\nexport function calculateResponsiveValues(\n  width: number,\n  baseFontSize: number = FONT_SIZE_CONSTRAINTS.BASE_SIZE,\n  baseSpacing: number = 16\n): ResponsiveValues {\n  const screenSize = getScreenSize(width);\n  \n  // Calculate font sizes for all text levels\n  const fontSize = {\n    small: calculateFontSize(baseFontSize * 0.75, screenSize, 12, 18),\n    body: calculateFontSize(baseFontSize, screenSize),\n    title: calculateFontSize(baseFontSize * 1.5, screenSize, 18, 28),\n    hero: calculateFontSize(baseFontSize * 2.25, screenSize, 24, 36),\n    hud: calculateFontSize(baseFontSize * 1.25, screenSize, 16, 24),\n  };\n\n  // Calculate spacing scale\n  const spacing = {\n    xs: calculateSpacing(baseSpacing * 0.5, screenSize),\n    sm: calculateSpacing(baseSpacing * 0.75, screenSize),\n    md: calculateSpacing(baseSpacing, screenSize),\n    lg: calculateSpacing(baseSpacing * 1.5, screenSize),\n    xl: calculateSpacing(baseSpacing * 2, screenSize),\n  };\n\n  // Create transition string\n  const transition = createTransitionString();\n\n  return {\n    fontSize,\n    spacing,\n    transition,\n  };\n}\n\n/**\n * Test screen size determination for validation\n * \n * Useful for testing and debugging responsive breakpoints.\n * Screen size is determined by width (breakpoints), but height is included\n * in the result for testing portrait/landscape orientations.\n * \n * @param width - Viewport width to test\n * @param height - Viewport height to test\n * @returns Test result with screen size and device type flags\n * \n * @example\n * ```typescript\n * const result = testScreenSize(768, 1024);\n * console.log(result.screenSize);  // 'tablet'\n * console.log(result.isTablet);    // true\n * console.log(result.isMobile);    // false\n * ```\n * \n * @public\n * @korean 화면크기테스트\n */\nexport function testScreenSize(\n  width: number,\n  height: number\n): ScreenSizeTestResult {\n  const screenSize = getScreenSize(width);\n  const isLandscape = width > height;\n  \n  return {\n    width,\n    height,\n    screenSize,\n    isMobile: screenSize === 'mobile',\n    isTablet: screenSize === 'tablet',\n    isDesktop: screenSize === 'desktop' || screenSize === 'large' || screenSize === 'xlarge',\n    // Include landscape in test result for completeness\n    isLandscape,\n  };\n}\n\n/**\n * Check if screen size is mobile\n * \n * @param width - Viewport width\n * @returns True if mobile screen size\n * \n * @public\n * @korean 모바일확인\n */\nexport function isMobileSize(width: number): boolean {\n  return getScreenSize(width) === 'mobile';\n}\n\n/**\n * Check if screen size is tablet\n * \n * @param width - Viewport width\n * @returns True if tablet screen size\n * \n * @public\n * @korean 태블릿확인\n */\nexport function isTabletSize(width: number): boolean {\n  return getScreenSize(width) === 'tablet';\n}\n\n/**\n * Check if screen size is desktop or larger\n * \n * @param width - Viewport width\n * @returns True if desktop, large, or xlarge screen size\n * \n * @public\n * @korean 데스크톱확인\n */\nexport function isDesktopSize(width: number): boolean {\n  const size = getScreenSize(width);\n  return size === 'desktop' || size === 'large' || size === 'xlarge';\n}\n"],"mappings":"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"}
+{"version":3,"file":"ResponsiveScaling.js","names":[],"sources":["../../src/systems/ResponsiveScaling.ts"],"sourcesContent":["/**\n * Responsive Scaling System for Black Trigram\n * \n * Centralized scaling calculations for responsive layout across all screen sizes.\n * Implements proportional font and spacing scaling with smooth transitions.\n * \n * Features:\n * - Five screen size categories (mobile, tablet, desktop, large, xlarge)\n * - Font scaling: 0.8x (mobile) to 1.4x (4K displays)\n * - Spacing scaling: 0.5x (mobile) to 1.5x (4K displays)\n * - Korean text readability: 14-24px range enforced\n * - Smooth CSS transitions for resize operations\n * - 60fps performance maintained\n * \n * @module systems/ResponsiveScaling\n * @category Responsive Layout\n * @korean 반응형스케일시스템\n */\n\nimport type {\n  ScreenSize,\n  ResponsiveBreakpoints,\n  FontScaleMap,\n  SpacingScaleMap,\n  ResponsiveScaleConfig,\n  ResizeTransitionConfig,\n  ResponsiveValues,\n  ScreenSizeTestResult,\n} from '../types/ResponsiveTypes';\n\n// Re-export types for convenience\nexport type {\n  ScreenSize,\n  ResponsiveBreakpoints,\n  FontScaleMap,\n  SpacingScaleMap,\n  ResponsiveScaleConfig,\n  ResizeTransitionConfig,\n  ResponsiveValues,\n  ScreenSizeTestResult,\n};\n\n/**\n * Standard breakpoints for responsive design\n * Maps viewport widths to device categories\n * \n * Note: XLARGE is defined as a reference value (2560px) but xlarge category\n * starts at LARGE (1920px). This allows for consistent scaling across all\n * displays from 1920px upwards, including 2K, 4K, and ultra-wide monitors.\n * \n * @constant\n * @category Responsive Layout\n */\nexport const RESPONSIVE_BREAKPOINTS: ResponsiveBreakpoints = {\n  MOBILE: 768,      // < 768px: Mobile devices\n  TABLET: 1024,     // 768-1024px: Tablets\n  DESKTOP: 1440,    // 1024-1440px: Standard desktop\n  LARGE: 1920,      // 1440-1920px: HD/2K displays\n  XLARGE: 2560,     // Reference for 4K displays (xlarge starts at 1920px)\n} as const;\n\n/**\n * Font scaling multipliers by screen size\n * Base size (16px) * scale = final size\n * \n * Results clamped to 14-24px for readability\n * \n * @constant\n * @category Typography\n */\nexport const FONT_SCALE_MAP: FontScaleMap = {\n  mobile: 0.8,    // 16px * 0.8 = 12.8px → clamped to 14px min\n  tablet: 0.9,    // 16px * 0.9 = 14.4px\n  desktop: 1.0,   // 16px * 1.0 = 16px (base)\n  large: 1.2,     // 16px * 1.2 = 19.2px\n  xlarge: 1.4,    // 16px * 1.4 = 22.4px → clamped to 24px max\n} as const;\n\n/**\n * Spacing scaling multipliers by screen size\n * Base spacing * scale = final spacing\n * \n * @constant\n * @category Layout\n */\nexport const SPACING_SCALE_MAP: SpacingScaleMap = {\n  mobile: 0.5,    // Compact spacing for small screens\n  tablet: 0.75,   // Moderate spacing for tablets\n  desktop: 1.0,   // Standard reference spacing\n  large: 1.25,    // Spacious for large displays\n  xlarge: 1.5,    // Maximum spacing for 4K\n} as const;\n\n/**\n * Default transition configuration for smooth resizing\n * Optimized for 60fps performance\n * \n * @constant\n * @category Animation\n */\nexport const DEFAULT_RESIZE_TRANSITION: ResizeTransitionConfig = {\n  duration: '300ms',\n  easing: 'ease-in-out',\n  properties: ['font-size', 'padding', 'margin', 'width', 'height'] as const,\n  enabled: true,\n} as const;\n\n/**\n * Font size constraints for Korean and English text\n * Ensures readability across all screen sizes\n * \n * @constant\n * @category Typography\n */\nexport const FONT_SIZE_CONSTRAINTS = {\n  /** Minimum body text size for readability */\n  MIN_BODY_SIZE: 14,\n  /** Maximum size before text becomes too large */\n  MAX_SIZE: 24,\n  /** Base reference size (desktop) */\n  BASE_SIZE: 16,\n} as const;\n\n/**\n * Determine screen size category from viewport width\n * \n * Categories:\n * - mobile: < 768px (phones)\n * - tablet: 768-1024px (tablets)\n * - desktop: 1024-1440px (standard monitors)\n * - large: 1440-1920px (HD/2K displays)\n * - xlarge: ≥1920px (4K/ultra-wide)\n * \n * @param width - Viewport width in pixels\n * @returns Screen size category\n * \n * @example\n * ```typescript\n * getScreenSize(375);  // 'mobile'\n * getScreenSize(768);  // 'tablet'\n * getScreenSize(1920); // 'xlarge'\n * ```\n * \n * @korean 화면크기얻기\n */\nexport function getScreenSize(width: number): ScreenSize {\n  if (width < RESPONSIVE_BREAKPOINTS.MOBILE) return 'mobile';\n  if (width < RESPONSIVE_BREAKPOINTS.TABLET) return 'tablet';\n  if (width < RESPONSIVE_BREAKPOINTS.DESKTOP) return 'desktop';\n  if (width < RESPONSIVE_BREAKPOINTS.LARGE) return 'large';\n  return 'xlarge';\n}\n\n/**\n * Calculate scaled font size with readability constraints\n * \n * Formula: baseSize * scale\n * Clamped: max(minSize, min(maxSize, calculated))\n * \n * Ensures Korean and English text remain readable at all sizes\n * \n * @param baseSize - Base font size in pixels (typically 16px)\n * @param screenSize - Current screen size category\n * @param minSize - Minimum allowed size (default: 14px)\n * @param maxSize - Maximum allowed size (default: 24px)\n * @returns Calculated font size in pixels\n * \n * @example\n * ```typescript\n * calculateFontSize(16, 'mobile');  // 14 (clamped from 12.8)\n * calculateFontSize(16, 'desktop'); // 16\n * calculateFontSize(16, 'xlarge');  // 22.4\n * calculateFontSize(20, 'xlarge', 14, 24); // 24 (clamped from 28)\n * ```\n * \n * @korean 글꼴크기계산\n */\nexport function calculateFontSize(\n  baseSize: number,\n  screenSize: ScreenSize,\n  minSize: number = FONT_SIZE_CONSTRAINTS.MIN_BODY_SIZE,\n  maxSize: number = FONT_SIZE_CONSTRAINTS.MAX_SIZE\n): number {\n  const scale = FONT_SCALE_MAP[screenSize];\n  const scaled = baseSize * scale;\n  \n  // Clamp to readable range\n  return Math.max(minSize, Math.min(maxSize, scaled));\n}\n\n/**\n * Calculate scaled spacing value\n * \n * Formula: baseSpacing * scale\n * Rounded to nearest integer for crisp rendering\n * \n * @param baseSpacing - Base spacing value in pixels\n * @param screenSize - Current screen size category\n * @returns Calculated spacing in pixels (rounded)\n * \n * @example\n * ```typescript\n * calculateSpacing(20, 'mobile');  // 10 (20 * 0.5)\n * calculateSpacing(20, 'desktop'); // 20\n * calculateSpacing(20, 'xlarge');  // 30 (20 * 1.5)\n * ```\n * \n * @korean 간격계산\n */\nexport function calculateSpacing(\n  baseSpacing: number,\n  screenSize: ScreenSize\n): number {\n  const scale = SPACING_SCALE_MAP[screenSize];\n  return Math.round(baseSpacing * scale);\n}\n\n/**\n * Get font scale multiplier for screen size\n * \n * @param screenSize - Screen size category\n * @returns Scale multiplier (0.8 - 1.4)\n * \n * @example\n * ```typescript\n * getFontScale('mobile');  // 0.8\n * getFontScale('desktop'); // 1.0\n * getFontScale('xlarge');  // 1.4\n * ```\n * \n * @korean 글꼴스케일얻기\n */\nexport function getFontScale(screenSize: ScreenSize): number {\n  return FONT_SCALE_MAP[screenSize];\n}\n\n/**\n * Get spacing scale multiplier for screen size\n * \n * @param screenSize - Screen size category\n * @returns Scale multiplier (0.5 - 1.5)\n * \n * @example\n * ```typescript\n * getSpacingScale('mobile');  // 0.5\n * getSpacingScale('desktop'); // 1.0\n * getSpacingScale('xlarge');  // 1.5\n * ```\n * \n * @korean 간격스케일얻기\n */\nexport function getSpacingScale(screenSize: ScreenSize): number {\n  return SPACING_SCALE_MAP[screenSize];\n}\n\n/**\n * Create CSS transition string for smooth resizing\n * \n * @param config - Transition configuration (optional)\n * @returns CSS transition string\n * \n * @example\n * ```typescript\n * createTransitionString();\n * // 'font-size 300ms ease-in-out, padding 300ms ease-in-out, ...'\n * \n * createTransitionString({ duration: '200ms', easing: 'linear' });\n * // 'font-size 200ms linear, padding 200ms linear, ...'\n * ```\n * \n * @korean 전환문자열생성\n */\nexport function createTransitionString(\n  config: Partial<ResizeTransitionConfig> = {}\n): string {\n  const {\n    duration = DEFAULT_RESIZE_TRANSITION.duration,\n    easing = DEFAULT_RESIZE_TRANSITION.easing,\n    properties = DEFAULT_RESIZE_TRANSITION.properties,\n    enabled = DEFAULT_RESIZE_TRANSITION.enabled,\n  } = config;\n\n  if (!enabled) {\n    return 'none';\n  }\n\n  return properties\n    .map((prop) => `${prop} ${duration} ${easing}`)\n    .join(', ');\n}\n\n/**\n * Create complete responsive scale configuration\n * \n * @param width - Viewport width\n * @param height - Viewport height\n * @returns Complete responsive configuration\n * \n * @example\n * ```typescript\n * const config = createResponsiveConfig(375, 667);\n * console.log(config.screenSize);  // 'mobile'\n * console.log(config.fontScale);   // 0.8\n * console.log(config.spacingScale); // 0.5\n * ```\n * \n * @korean 반응형설정생성\n */\nexport function createResponsiveConfig(\n  width: number,\n  height: number\n): ResponsiveScaleConfig {\n  const screenSize = getScreenSize(width);\n  const fontScale = getFontScale(screenSize);\n  const spacingScale = getSpacingScale(screenSize);\n\n  return {\n    screenSize,\n    fontScale,\n    spacingScale,\n    viewport: { width, height },\n  };\n}\n\n/**\n * Calculate all responsive values for a component\n * \n * Computes font sizes, spacing, and transitions based on screen size\n * Ready-to-use values for component styling\n * \n * @param width - Viewport width\n * @param baseFontSize - Base font size (default: 16px)\n * @param baseSpacing - Base spacing unit (default: 16px)\n * @returns Complete responsive values\n * \n * @example\n * ```typescript\n * const values = calculateResponsiveValues(375);\n * \n * <div style={{\n *   fontSize: values.fontSize.body,\n *   padding: values.spacing.md,\n *   transition: values.transition,\n * }}>\n *   Responsive content\n * </div>\n * ```\n * \n * @korean 반응형값계산\n */\nexport function calculateResponsiveValues(\n  width: number,\n  baseFontSize: number = FONT_SIZE_CONSTRAINTS.BASE_SIZE,\n  baseSpacing: number = 16\n): ResponsiveValues {\n  const screenSize = getScreenSize(width);\n  \n  // Calculate font sizes for all text levels\n  const fontSize = {\n    small: calculateFontSize(baseFontSize * 0.75, screenSize, 12, 18),\n    body: calculateFontSize(baseFontSize, screenSize),\n    title: calculateFontSize(baseFontSize * 1.5, screenSize, 18, 28),\n    hero: calculateFontSize(baseFontSize * 2.25, screenSize, 24, 36),\n    hud: calculateFontSize(baseFontSize * 1.25, screenSize, 16, 24),\n  };\n\n  // Calculate spacing scale\n  const spacing = {\n    xs: calculateSpacing(baseSpacing * 0.5, screenSize),\n    sm: calculateSpacing(baseSpacing * 0.75, screenSize),\n    md: calculateSpacing(baseSpacing, screenSize),\n    lg: calculateSpacing(baseSpacing * 1.5, screenSize),\n    xl: calculateSpacing(baseSpacing * 2, screenSize),\n  };\n\n  // Create transition string\n  const transition = createTransitionString();\n\n  return {\n    fontSize,\n    spacing,\n    transition,\n  };\n}\n\n/**\n * Test screen size determination for validation\n * \n * Useful for testing and debugging responsive breakpoints.\n * Screen size is determined by width (breakpoints), but height is included\n * in the result for testing portrait/landscape orientations.\n * \n * @param width - Viewport width to test\n * @param height - Viewport height to test\n * @returns Test result with screen size and device type flags\n * \n * @example\n * ```typescript\n * const result = testScreenSize(768, 1024);\n * console.log(result.screenSize);  // 'tablet'\n * console.log(result.isTablet);    // true\n * console.log(result.isMobile);    // false\n * ```\n * \n * @korean 화면크기테스트\n */\nexport function testScreenSize(\n  width: number,\n  height: number\n): ScreenSizeTestResult {\n  const screenSize = getScreenSize(width);\n  const isLandscape = width > height;\n  \n  return {\n    width,\n    height,\n    screenSize,\n    isMobile: screenSize === 'mobile',\n    isTablet: screenSize === 'tablet',\n    isDesktop: screenSize === 'desktop' || screenSize === 'large' || screenSize === 'xlarge',\n    // Include landscape in test result for completeness\n    isLandscape,\n  };\n}\n\n/**\n * Check if screen size is mobile\n * \n * @param width - Viewport width\n * @returns True if mobile screen size\n * \n * @korean 모바일확인\n */\nexport function isMobileSize(width: number): boolean {\n  return getScreenSize(width) === 'mobile';\n}\n\n/**\n * Check if screen size is tablet\n * \n * @param width - Viewport width\n * @returns True if tablet screen size\n * \n * @korean 태블릿확인\n */\nexport function isTabletSize(width: number): boolean {\n  return getScreenSize(width) === 'tablet';\n}\n\n/**\n * Check if screen size is desktop or larger\n * \n * @param width - Viewport width\n * @returns True if desktop, large, or xlarge screen size\n * \n * @korean 데스크톱확인\n */\nexport function isDesktopSize(width: number): boolean {\n  const size = getScreenSize(width);\n  return size === 'desktop' || size === 'large' || size === 'xlarge';\n}\n"],"mappings":"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"}

package/lib/systems/TrigramSystem.d.ts

@@ -83,7 +83,6 @@ export declare function applyCounterStanceDamage(baseDamage: number, isCounterSt
  * const recommendedStance = trigramSystem.recommendStance(playerState);
  * ```
  *
- * @public
  * @category Trigram System
  * @korean 팔괘시스템
  */
@@ -121,7 +120,6 @@ export declare class TrigramSystem {
      * console.log(offensive); // "offensive"
      * ```
      *
-     * @public
      * @korean 자세특성조회
      */
     getStanceCharacteristic(stance: TrigramStance): "defensive" | "offensive" | "balanced";
@@ -140,7 +138,6 @@ export declare class TrigramSystem {
      * }
      * ```
      *
-     * @public
      * @korean 방어자세확인
      */
     isDefensiveStance(stance: TrigramStance): boolean;
@@ -159,7 +156,6 @@ export declare class TrigramSystem {
      * }
      * ```
      *
-     * @public
      * @korean 공격자세확인
      */
     isOffensiveStance(stance: TrigramStance): boolean;
@@ -183,7 +179,6 @@ export declare class TrigramSystem {
      * );
      * ```
      *
-     * @public
      * @korean 자세전환가능확인
      */
     canTransitionTo(fromStance: TrigramStance, toStance: TrigramStance, player: PlayerState): boolean;
@@ -205,7 +200,6 @@ export declare class TrigramSystem {
      * console.log(`Consider switching to ${recommended}`);
      * ```
      *
-     * @public
      * @korean 최적자세추천
      */
     recommendStance(player: PlayerState): TrigramStance;
@@ -237,7 +231,6 @@ export declare class TrigramSystem {
      * console.log(`Cost: ${cost.ki} Ki, ${cost.stamina} Stamina`);
      * ```
      *
-     * @public
      * @korean 자세전환비용
      */
     getTransitionCost(from: TrigramStance, to: TrigramStance, player?: PlayerState): TrigramTransitionCost;
@@ -259,7 +252,6 @@ export declare class TrigramSystem {
      * ); // Returns > 1.0 (Water beats Fire)
      * ```
      *
-     * @public
      * @korean 자세효과성계산
      */
     calculateStanceEffectiveness(attackerStance: TrigramStance, defenderStance: TrigramStance): number;
@@ -277,7 +269,6 @@ export declare class TrigramSystem {
      * console.log(`${name.korean} (${name.english})`); // "건 (Heaven)"
      * ```
      *
-     * @public
      * @korean 자세이름조회
      */
     getStanceName(stance: TrigramStance): {
@@ -306,7 +297,6 @@ export declare class TrigramSystem {
      * console.log(counterStance); // TrigramStance.GAM (Water counters Heaven)
      * ```
      *
-     * @public
      * @korean 상극자세조회
      */
     getCounterStance(opponentStance: TrigramStance): TrigramStance;
@@ -332,7 +322,6 @@ export declare class TrigramSystem {
      * }
      * ```
      *
-     * @public
      * @korean 상극자세확인
      */
     isCounterStance(myStance: TrigramStance, opponentStance: TrigramStance): boolean;
@@ -344,7 +333,6 @@ export declare class TrigramSystem {
      * @param stance - Stance to get data for
      * @returns Stance data object
      *
-     * @public
      * @korean 자세데이터조회
      */
     getCurrentStanceData(stance: TrigramStance): {
@@ -376,7 +364,6 @@ export declare class TrigramSystem {
      * }
      * ```
      *
-     * @public
      * @korean 자세전환검증
      */
     validateTransition(fromStance: TrigramStance, toStance: TrigramStance, player: PlayerState): {

package/lib/systems/TrigramSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrigramSystem.d.ts","sourceRoot":"","sources":["../../src/systems/TrigramSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAyB,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAIzE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAShE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,OAAO,GACvB,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAoB;IAEtC;;;;OAIG;;IAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,uBAAuB,CACrB,MAAM,EAAE,aAAa,GACpB,WAAW,GAAG,WAAW,GAAG,UAAU;IAezC;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIjD;;;;;;;;;;;;;;;;;OAiBG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIjD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,CACb,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO;IAYV;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAiBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACI,iBAAiB,CACtB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,qBAAqB;IAmCxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,4BAA4B,CAC1B,cAAc,EAAE,aAAa,EAC7B,cAAc,EAAE,aAAa,GAC5B,MAAM;IAOT;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAezE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,gBAAgB,CAAC,cAAc,EAAE,aAAa,GAAG,aAAa;IAI9D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,GAAG,OAAO;IAIhF;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG;QAC3C,EAAE,EAAE,aAAa,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IAUD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,kBAAkB,CAChB,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAuBvC;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"TrigramSystem.d.ts","sourceRoot":"","sources":["../../src/systems/TrigramSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAyB,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAIzE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAShE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,OAAO,GACvB,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAoB;IAEtC;;;;OAIG;;IAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,uBAAuB,CACrB,MAAM,EAAE,aAAa,GACpB,WAAW,GAAG,WAAW,GAAG,UAAU;IAezC;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIjD;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIjD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CACb,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO;IAYV;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAiBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACI,iBAAiB,CACtB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,qBAAqB;IAmCxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,4BAA4B,CAC1B,cAAc,EAAE,aAAa,EAC7B,cAAc,EAAE,aAAa,GAC5B,MAAM;IAOT;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAezE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gBAAgB,CAAC,cAAc,EAAE,aAAa,GAAG,aAAa;IAI9D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,GAAG,OAAO;IAIhF;;;;;;;;;OASG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG;QAC3C,EAAE,EAAE,aAAa,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IAUD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,kBAAkB,CAChB,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,GAClB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAuBvC;AAED,eAAe,aAAa,CAAC"}

package/lib/systems/TrigramSystem.js

@@ -97,7 +97,6 @@ function applyCounterStanceDamage(baseDamage, isCounterStance) {
 * const recommendedStance = trigramSystem.recommendStance(playerState);
 * ```
 *
-* @public
 * @category Trigram System
 * @korean 팔괘시스템
 */
@@ -137,7 +136,6 @@ var TrigramSystem = class {
 	* console.log(offensive); // "offensive"
 	* ```
 	*
-	* @public
 	* @korean 자세특성조회
 	*/
 	getStanceCharacteristic(stance) {
@@ -164,7 +162,6 @@ var TrigramSystem = class {
 	* }
 	* ```
 	*
-	* @public
 	* @korean 방어자세확인
 	*/
 	isDefensiveStance(stance) {
@@ -185,7 +182,6 @@ var TrigramSystem = class {
 	* }
 	* ```
 	*
-	* @public
 	* @korean 공격자세확인
 	*/
 	isOffensiveStance(stance) {
@@ -211,7 +207,6 @@ var TrigramSystem = class {
 	* );
 	* ```
 	*
-	* @public
 	* @korean 자세전환가능확인
 	*/
 	canTransitionTo(fromStance, toStance, player) {
@@ -239,7 +234,6 @@ var TrigramSystem = class {
 	* console.log(`Consider switching to ${recommended}`);
 	* ```
 	*
-	* @public
 	* @korean 최적자세추천
 	*/
 	recommendStance(player) {
@@ -284,7 +278,6 @@ var TrigramSystem = class {
 	* console.log(`Cost: ${cost.ki} Ki, ${cost.stamina} Stamina`);
 	* ```
 	*
-	* @public
 	* @korean 자세전환비용
 	*/
 	getTransitionCost(from, to, player) {
@@ -327,7 +320,6 @@ var TrigramSystem = class {
 	* ); // Returns > 1.0 (Water beats Fire)
 	* ```
 	*
-	* @public
 	* @korean 자세효과성계산
 	*/
 	calculateStanceEffectiveness(attackerStance, defenderStance) {
@@ -347,7 +339,6 @@ var TrigramSystem = class {
 	* console.log(`${name.korean} (${name.english})`); // "건 (Heaven)"
 	* ```
 	*
-	* @public
 	* @korean 자세이름조회
 	*/
 	getStanceName(stance) {
@@ -411,7 +402,6 @@ var TrigramSystem = class {
 	* console.log(counterStance); // TrigramStance.GAM (Water counters Heaven)
 	* ```
 	* 
-	* @public
 	* @korean 상극자세조회
 	*/
 	getCounterStance(opponentStance) {
@@ -439,7 +429,6 @@ var TrigramSystem = class {
 	* }
 	* ```
 	* 
-	* @public
 	* @korean 상극자세확인
 	*/
 	isCounterStance(myStance, opponentStance) {
@@ -453,7 +442,6 @@ var TrigramSystem = class {
 	* @param stance - Stance to get data for
 	* @returns Stance data object
 	*
-	* @public
 	* @korean 자세데이터조회
 	*/
 	getCurrentStanceData(stance) {
@@ -488,7 +476,6 @@ var TrigramSystem = class {
 	* }
 	* ```
 	*
-	* @public
 	* @korean 자세전환검증
 	*/
 	validateTransition(fromStance, toStance, player) {