blacktrigram 0.7.2

package/lib/types/constants/index.js

@@ -0,0 +1,176 @@
+import "./colors.js";
+import "./typography.js";
+import "./ui.js";
+import "./designSystem.js";
+import "./performance.js";
+import "../../systems/ResponsiveScaling.js";
+import "./animations.js";
+//#region src/types/constants/index.ts
+/**
+* Archetype-specific technique damage bonuses
+* Maps archetype to technique ID to bonus multiplier
+* 
+* @category Combat System
+* @korean 원형별 기술 보너스
+*/
+var ARCHETYPE_TECHNIQUE_BONUSES = {};
+/**
+* Maximum ki cost for stance transitions
+* @category Combat System
+* @korean 최대 기 전환 비용
+*/
+var MAX_TRANSITION_COST_KI = 50;
+/**
+* Maximum stamina cost for stance transitions
+* @category Combat System
+* @korean 최대 체력 전환 비용
+*/
+var MAX_TRANSITION_COST_STAMINA = 30;
+/**
+* Maximum time allowed for stance transitions in milliseconds
+* @category Combat System
+* @korean 최대 전환 시간
+*/
+var MAX_TRANSITION_TIME_MILLISECONDS = 1e3;
+/**
+* Performance rating thresholds for match results
+* Calculated based on combat effectiveness metrics
+* 
+* @category Combat Performance
+* @korean 전투 성능 등급
+*/
+var PERFORMANCE_RATING_THRESHOLDS = {
+	S: {
+		minScore: 90,
+		korean: "S급",
+		english: "S Rank",
+		description: {
+			korean: "완벽한 전투",
+			english: "Perfect Combat"
+		},
+		color: 16766720
+	},
+	A: {
+		minScore: 75,
+		korean: "A급",
+		english: "A Rank",
+		description: {
+			korean: "우수한 전투",
+			english: "Excellent Combat"
+		},
+		color: 65535
+	},
+	B: {
+		minScore: 60,
+		korean: "B급",
+		english: "B Rank",
+		description: {
+			korean: "양호한 전투",
+			english: "Good Combat"
+		},
+		color: 3381759
+	},
+	C: {
+		minScore: 0,
+		korean: "C급",
+		english: "C Rank",
+		description: {
+			korean: "보통 전투",
+			english: "Average Combat"
+		},
+		color: 13421772
+	}
+};
+/**
+* Archetype asset mapping for visual and audio integration
+* Maps each player archetype to its visual assets, theme music, and metadata
+* 
+* @category Player Archetypes
+* @korean 플레이어 원형 에셋
+*/
+var ARCHETYPE_ASSETS = {
+	musa: {
+		id: "musa",
+		image: "/assets/visual/archetypes/musa.png",
+		theme: "/assets/audio/music/archetype_themes/musa_warrior.mp3",
+		themeId: "musa_warrior_theme",
+		name_korean: "무사",
+		name_english: "Traditional Warrior",
+		textureKey: "musa"
+	},
+	amsalja: {
+		id: "amsalja",
+		image: "/assets/visual/archetypes/amsalja.png",
+		theme: "/assets/audio/music/archetype_themes/amsalja_shadow.mp3",
+		themeId: "amsalja_shadow_theme",
+		name_korean: "암살자",
+		name_english: "Shadow Assassin",
+		textureKey: "amsalja"
+	},
+	hacker: {
+		id: "hacker",
+		image: "/assets/visual/archetypes/hacker.png",
+		theme: "/assets/audio/music/archetype_themes/hacker_cyber.mp3",
+		themeId: "hacker_cyber_theme",
+		name_korean: "해커",
+		name_english: "Cyber Warrior",
+		textureKey: "hacker"
+	},
+	jeongbo_yowon: {
+		id: "jeongbo_yowon",
+		image: "/assets/visual/archetypes/jeongbo_yowon.png",
+		theme: "/assets/audio/music/archetype_themes/jeongbo_intel.mp3",
+		themeId: "jeongbo_intel_theme",
+		name_korean: "정보요원",
+		name_english: "Intelligence Operative",
+		textureKey: "jeongbo_yowon"
+	},
+	jojik_pokryeokbae: {
+		id: "jojik_pokryeokbae",
+		image: "/assets/visual/archetypes/jojik_pokryeokbae.png",
+		theme: "/assets/audio/music/archetype_themes/jojik_street.mp3",
+		themeId: "jojik_street_theme",
+		name_korean: "조직폭력배",
+		name_english: "Organized Crime",
+		textureKey: "jojik_pokryeokbae"
+	}
+};
+/**
+* Background images for archetype-related screens
+* 
+* Note: Directory name "archetyples" is intentionally spelled this way to match
+* the actual directory structure in /public/assets/visual/bg/
+* 
+* @category Visual Assets
+* @korean 원형 배경 이미지
+*/
+var ARCHETYPE_BACKGROUNDS = {
+	overview: "/assets/visual/bg/archetyples/PlayerArchetypesOverview.png",
+	explained: "/assets/visual/bg/archetyples/PlayerArchetypesExplained.png",
+	teamDynamics: "/assets/visual/bg/archetyples/CyberpunkTeamDynamics.png"
+};
+/**
+* Fallback image path for when archetype images fail to load
+* 
+* @category Visual Assets
+* @korean 대체 이미지 경로
+*/
+var FALLBACK_ARCHETYPE_IMAGE = "/assets/visual/logo/black-trigram-256.png";
+/**
+* Round announcement timing constants
+* Controls the display duration and transitions for round announcements
+* 
+* @category Combat UI
+* @korean 라운드 발표 타이밍
+*/
+var ROUND_ANNOUNCEMENT_TIMINGS = {
+	ANNOUNCEMENT_DURATION: 2,
+	COUNTDOWN_DURATION: 3,
+	TRANSITION_DURATION: 500,
+	FADE_IN_DURATION: 300,
+	FADE_OUT_DURATION: 300
+};
+//#endregion
+export { ARCHETYPE_ASSETS, ARCHETYPE_BACKGROUNDS, ARCHETYPE_TECHNIQUE_BONUSES, FALLBACK_ARCHETYPE_IMAGE, MAX_TRANSITION_COST_KI, MAX_TRANSITION_COST_STAMINA, MAX_TRANSITION_TIME_MILLISECONDS, PERFORMANCE_RATING_THRESHOLDS, ROUND_ANNOUNCEMENT_TIMINGS };
+
+//# sourceMappingURL=index.js.map

package/lib/types/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/types/constants/index.ts"],"sourcesContent":["/**\n * Main constants export for Black Trigram Korean martial arts system\n */\n\n// Fix: Remove duplicate exports and ensure proper imports\nexport { CYBERPUNK_COLORS, KOREAN_COLORS } from \"./colors\";\nexport {\n  FONT_FAMILY,\n  FONT_SIZES,\n  FONT_WEIGHTS,\n  // KOREAN_FONT_FAMILY, // Not exported from typography.ts\n  KOREAN_FONT_WEIGHTS,\n  KOREAN_TEXT_SIZES,\n  KOREAN_MOBILE_FONT_SIZES,\n  getKoreanFontSize,\n} from \"./typography\";\nexport { HEALTH_COLORS, UI_CONSTANTS, UI_DIMENSIONS } from \"./ui\";\n\n// Design System exports\nexport {\n  TYPOGRAPHY,\n  TYPOGRAPHY_NUMERIC,\n  SPACING,\n  SPACING_NUMERIC,\n  SPACING_ADJUSTMENTS,\n  BORDER_RADIUS,\n  HUD_STYLE,\n  HIERARCHY,\n  BORDERS,\n  GRADIENTS,\n  TRANSITIONS,\n  OPACITY,\n  COMBAT_UI_DIMENSIONS,\n  COMBAT_UI_DIMENSIONS_NUMERIC,\n  TEXT_EFFECTS,\n  FONT_SIZE_MULTIPLIERS,\n  LAYOUT_MULTIPLIERS,\n  getResponsiveSpacing,\n  getResponsiveFontSize,\n  type TypographyLevel,\n  type SpacingLevel,\n  type BorderRadiusLevel,\n  type HierarchyLevel,\n} from \"./designSystem\";\n\n// Performance constants\nexport {\n  PERFORMANCE_SETTINGS_BY_TIER,\n  FRAME_TIME_BUDGET,\n  getPerformanceTier,\n  getPerformanceSettings,\n  type PerformanceTier,\n  type PerformanceSettings,\n} from \"./performance\";\n\n// Responsive scaling system exports  \nexport {\n  RESPONSIVE_BREAKPOINTS,\n  FONT_SCALE_MAP,\n  SPACING_SCALE_MAP,\n  FONT_SIZE_CONSTRAINTS,\n  DEFAULT_RESIZE_TRANSITION,\n  getScreenSize,\n  calculateFontSize,\n  calculateSpacing,\n  getFontScale,\n  getSpacingScale,\n  createTransitionString,\n  createResponsiveConfig,\n  calculateResponsiveValues,\n  testScreenSize,\n  isMobileSize,\n  isTabletSize,\n  isDesktopSize,\n  // Use qualified name for ScreenSize to avoid conflict with LayoutTypes.ScreenSize\n  type ScreenSize as ResponsiveScreenSize,\n  type ResponsiveBreakpoints,\n  type FontScaleMap,\n  type SpacingScaleMap,\n  type ResponsiveScaleConfig,\n  type ResizeTransitionConfig,\n  type ResponsiveValues,\n  type ScreenSizeTestResult,\n} from \"../../systems/ResponsiveScaling\";\n\n// Fix: Provide default export\nexport { KOREAN_COLORS as default } from \"./colors\";\n\n// Fix: Add missing KOREAN_TYPOGRAPHY export\n\n// Fix: Add missing PIXI_FONT_WEIGHTS export\n\n// Fix: Add missing ANIMATION_DURATIONS export\nexport { ANIMATION_DURATIONS } from \"./animations\";\n\n/**\n * Archetype-specific technique damage bonuses\n * Maps archetype to technique ID to bonus multiplier\n * \n * @category Combat System\n * @korean 원형별 기술 보너스\n */\nexport const ARCHETYPE_TECHNIQUE_BONUSES: Record<\n  string,\n  Record<string, number>\n> = {\n  // Define bonuses for each archetype\n};\n\n/**\n * Maximum ki cost for stance transitions\n * @category Combat System\n * @korean 최대 기 전환 비용\n */\nexport const MAX_TRANSITION_COST_KI = 50;\n\n/**\n * Maximum stamina cost for stance transitions\n * @category Combat System\n * @korean 최대 체력 전환 비용\n */\nexport const MAX_TRANSITION_COST_STAMINA = 30;\n\n/**\n * Maximum time allowed for stance transitions in milliseconds\n * @category Combat System\n * @korean 최대 전환 시간\n */\nexport const MAX_TRANSITION_TIME_MILLISECONDS = 1000;\n\n/**\n * Performance rating thresholds for match results\n * Calculated based on combat effectiveness metrics\n * \n * @category Combat Performance\n * @korean 전투 성능 등급\n */\nexport const PERFORMANCE_RATING_THRESHOLDS = {\n  S: {\n    minScore: 90,\n    korean: \"S급\",\n    english: \"S Rank\",\n    description: {\n      korean: \"완벽한 전투\",\n      english: \"Perfect Combat\",\n    },\n    color: 0xffd700, // KOREAN_COLORS.ACCENT_GOLD\n  },\n  A: {\n    minScore: 75,\n    korean: \"A급\",\n    english: \"A Rank\",\n    description: {\n      korean: \"우수한 전투\",\n      english: \"Excellent Combat\",\n    },\n    color: 0x00ffff, // KOREAN_COLORS.PRIMARY_CYAN\n  },\n  B: {\n    minScore: 60,\n    korean: \"B급\",\n    english: \"B Rank\",\n    description: {\n      korean: \"양호한 전투\",\n      english: \"Good Combat\",\n    },\n    color: 0x3399ff, // KOREAN_COLORS.ACCENT_BLUE\n  },\n  C: {\n    minScore: 0,\n    korean: \"C급\",\n    english: \"C Rank\",\n    description: {\n      korean: \"보통 전투\",\n      english: \"Average Combat\",\n    },\n    color: 0xcccccc, // KOREAN_COLORS.TEXT_SECONDARY\n  },\n} as const;\n\n/**\n * Archetype asset mapping for visual and audio integration\n * Maps each player archetype to its visual assets, theme music, and metadata\n * \n * @category Player Archetypes\n * @korean 플레이어 원형 에셋\n */\nexport const ARCHETYPE_ASSETS = {\n  musa: {\n    id: \"musa\",\n    image: \"/assets/visual/archetypes/musa.png\",\n    theme: \"/assets/audio/music/archetype_themes/musa_warrior.mp3\",\n    themeId: \"musa_warrior_theme\",\n    name_korean: \"무사\",\n    name_english: \"Traditional Warrior\",\n    textureKey: \"musa\",\n  },\n  amsalja: {\n    id: \"amsalja\",\n    image: \"/assets/visual/archetypes/amsalja.png\",\n    theme: \"/assets/audio/music/archetype_themes/amsalja_shadow.mp3\",\n    themeId: \"amsalja_shadow_theme\",\n    name_korean: \"암살자\",\n    name_english: \"Shadow Assassin\",\n    textureKey: \"amsalja\",\n  },\n  hacker: {\n    id: \"hacker\",\n    image: \"/assets/visual/archetypes/hacker.png\",\n    theme: \"/assets/audio/music/archetype_themes/hacker_cyber.mp3\",\n    themeId: \"hacker_cyber_theme\",\n    name_korean: \"해커\",\n    name_english: \"Cyber Warrior\",\n    textureKey: \"hacker\",\n  },\n  jeongbo_yowon: {\n    id: \"jeongbo_yowon\",\n    image: \"/assets/visual/archetypes/jeongbo_yowon.png\",\n    theme: \"/assets/audio/music/archetype_themes/jeongbo_intel.mp3\",\n    themeId: \"jeongbo_intel_theme\",\n    name_korean: \"정보요원\",\n    name_english: \"Intelligence Operative\",\n    textureKey: \"jeongbo_yowon\",\n  },\n  jojik_pokryeokbae: {\n    id: \"jojik_pokryeokbae\",\n    image: \"/assets/visual/archetypes/jojik_pokryeokbae.png\",\n    theme: \"/assets/audio/music/archetype_themes/jojik_street.mp3\",\n    themeId: \"jojik_street_theme\",\n    name_korean: \"조직폭력배\",\n    name_english: \"Organized Crime\",\n    textureKey: \"jojik_pokryeokbae\",\n  },\n} as const;\n\n/**\n * Background images for archetype-related screens\n * \n * Note: Directory name \"archetyples\" is intentionally spelled this way to match\n * the actual directory structure in /public/assets/visual/bg/\n * \n * @category Visual Assets\n * @korean 원형 배경 이미지\n */\nexport const ARCHETYPE_BACKGROUNDS = {\n  overview: \"/assets/visual/bg/archetyples/PlayerArchetypesOverview.png\",\n  explained: \"/assets/visual/bg/archetyples/PlayerArchetypesExplained.png\",\n  teamDynamics: \"/assets/visual/bg/archetyples/CyberpunkTeamDynamics.png\",\n} as const;\n\n/**\n * Fallback image path for when archetype images fail to load\n * \n * @category Visual Assets\n * @korean 대체 이미지 경로\n */\nexport const FALLBACK_ARCHETYPE_IMAGE = \"/assets/visual/logo/black-trigram-256.png\" as const;\n\n/**\n * Round announcement timing constants\n * Controls the display duration and transitions for round announcements\n * \n * @category Combat UI\n * @korean 라운드 발표 타이밍\n */\nexport const ROUND_ANNOUNCEMENT_TIMINGS = {\n  /** Duration to display announcement before countdown (seconds) */\n  ANNOUNCEMENT_DURATION: 2,\n  /** Duration of countdown to next round (seconds) */\n  COUNTDOWN_DURATION: 3,\n  /** Brief transition duration before next round starts (milliseconds) */\n  TRANSITION_DURATION: 500,\n  /** Fade in animation duration (milliseconds) */\n  FADE_IN_DURATION: 300,\n  /** Fade out animation duration (milliseconds) */\n  FADE_OUT_DURATION: 300,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;AAsGA,IAAa,8BAGT,EAEH;;;;;;AAOD,IAAa,yBAAyB;;;;;;AAOtC,IAAa,8BAA8B;;;;;;AAO3C,IAAa,mCAAmC;;;;;;;;AAShD,IAAa,gCAAgC;CAC3C,GAAG;EACD,UAAU;EACV,QAAQ;EACR,SAAS;EACT,aAAa;GACX,QAAQ;GACR,SAAS;GACV;EACD,OAAO;EACR;CACD,GAAG;EACD,UAAU;EACV,QAAQ;EACR,SAAS;EACT,aAAa;GACX,QAAQ;GACR,SAAS;GACV;EACD,OAAO;EACR;CACD,GAAG;EACD,UAAU;EACV,QAAQ;EACR,SAAS;EACT,aAAa;GACX,QAAQ;GACR,SAAS;GACV;EACD,OAAO;EACR;CACD,GAAG;EACD,UAAU;EACV,QAAQ;EACR,SAAS;EACT,aAAa;GACX,QAAQ;GACR,SAAS;GACV;EACD,OAAO;EACR;CACF;;;;;;;;AASD,IAAa,mBAAmB;CAC9B,MAAM;EACJ,IAAI;EACJ,OAAO;EACP,OAAO;EACP,SAAS;EACT,aAAa;EACb,cAAc;EACd,YAAY;EACb;CACD,SAAS;EACP,IAAI;EACJ,OAAO;EACP,OAAO;EACP,SAAS;EACT,aAAa;EACb,cAAc;EACd,YAAY;EACb;CACD,QAAQ;EACN,IAAI;EACJ,OAAO;EACP,OAAO;EACP,SAAS;EACT,aAAa;EACb,cAAc;EACd,YAAY;EACb;CACD,eAAe;EACb,IAAI;EACJ,OAAO;EACP,OAAO;EACP,SAAS;EACT,aAAa;EACb,cAAc;EACd,YAAY;EACb;CACD,mBAAmB;EACjB,IAAI;EACJ,OAAO;EACP,OAAO;EACP,SAAS;EACT,aAAa;EACb,cAAc;EACd,YAAY;EACb;CACF;;;;;;;;;;AAWD,IAAa,wBAAwB;CACnC,UAAU;CACV,WAAW;CACX,cAAc;CACf;;;;;;;AAQD,IAAa,2BAA2B;;;;;;;;AASxC,IAAa,6BAA6B;CAExC,uBAAuB;CAEvB,oBAAoB;CAEpB,qBAAqB;CAErB,kBAAkB;CAElB,mBAAmB;CACpB"}

package/lib/types/constants/layout.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Layout positioning constants for combat and training screens
+ * Centralized to prevent magic numbers and ensure consistency
+ *
+ * @category UI Constants
+ * @korean 레이아웃위치상수
+ */
+/**
+ * Bottom positioning for UI elements (in pixels)
+ * Values designed to prevent overlap and prioritize gameplay visibility:
+ * - Mobile controls at 200px for ergonomic touch access
+ * - TechniqueBar lowered to 20px (mobile) / 30px (desktop) to minimize arena obstruction
+ * - Back button moved to top-right corner (off-center) for accessibility
+ *
+ * PRIORITY: Combat arena visibility > TechniqueBar > Mobile controls > Back button
+ */
+export declare const LAYOUT_BOTTOM_POSITIONS: {
+    /** Mobile controls (VirtualDPad, ActionButtons) - must stay at 200px for accessibility */
+    readonly MOBILE_CONTROLS: 200;
+    /** TechniqueBar container - lowered to bottom to prioritize arena visibility */
+    readonly TECHNIQUE_BAR: {
+        readonly MOBILE: 20;
+        readonly DESKTOP: 30;
+    };
+    /** TechniqueBar container height (for overlap calculations) */
+    readonly TECHNIQUE_BAR_HEIGHT: 180;
+};
+/**
+ * Top positioning for UI elements (in pixels)
+ * Used for elements positioned from the top of the screen
+ */
+export declare const LAYOUT_TOP_POSITIONS: {
+    /** Back to Menu button positioned at top-right */
+    readonly BACK_BUTTON: {
+        readonly MOBILE: 10;
+        readonly DESKTOP: 20;
+    };
+    /** Safe area offset for notched devices */
+    readonly SAFE_AREA_TOP: 44;
+};
+/**
+ * Helper function to get technique bar bottom position
+ * NOTE: positionScale NOT applied to prevent layout bugs on 4K displays
+ *
+ * @param isMobile - Whether device is mobile (<768px)
+ * @returns Bottom position in pixels
+ */
+export declare function getTechniqueBarBottom(isMobile: boolean): number;
+/**
+ * Get mobile controls bottom position (always 200px)
+ *
+ * @returns Bottom position in pixels
+ */
+export declare function getMobileControlsBottom(): number;
+/**
+ * Get back button top position for top-right corner placement
+ * Includes safe area offset for notched devices
+ *
+ * @param isMobile - Whether device is mobile (<768px)
+ * @param hasSafeArea - Whether device has notch/safe area (default: false)
+ * @returns Top position in pixels
+ */
+export declare function getBackButtonTop(isMobile: boolean, hasSafeArea?: boolean): number;
+/**
+ * Get back button right position for top-right corner placement
+ *
+ * @param isMobile - Whether device is mobile (<768px)
+ * @returns Right position in pixels
+ */
+export declare function getBackButtonRight(isMobile: boolean): number;
+/**
+ * Type for layout position values
+ */
+export type LayoutBottomPosition = number;
+export type LayoutTopPosition = number;
+//# sourceMappingURL=layout.d.ts.map

package/lib/types/constants/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/types/constants/layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;IAClC,0FAA0F;;IAG1F,gFAAgF;;;;;IAMhF,+DAA+D;;CAEvD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B,kDAAkD;;;;;IAMlD,2CAA2C;;CAEnC,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,UAAQ,GAAG,MAAM,CAQ/E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC"}

package/lib/types/constants/layout.js

@@ -0,0 +1,37 @@
+//#region src/types/constants/layout.ts
+/**
+* Layout positioning constants for combat and training screens
+* Centralized to prevent magic numbers and ensure consistency
+* 
+* @category UI Constants
+* @korean 레이아웃위치상수
+*/
+/**
+* Bottom positioning for UI elements (in pixels)
+* Values designed to prevent overlap and prioritize gameplay visibility:
+* - Mobile controls at 200px for ergonomic touch access
+* - TechniqueBar lowered to 20px (mobile) / 30px (desktop) to minimize arena obstruction
+* - Back button moved to top-right corner (off-center) for accessibility
+* 
+* PRIORITY: Combat arena visibility > TechniqueBar > Mobile controls > Back button
+*/
+var LAYOUT_BOTTOM_POSITIONS = {
+	MOBILE_CONTROLS: 200,
+	TECHNIQUE_BAR: {
+		MOBILE: 20,
+		DESKTOP: 30
+	},
+	TECHNIQUE_BAR_HEIGHT: 180
+};
+/**
+* Get mobile controls bottom position (always 200px)
+* 
+* @returns Bottom position in pixels
+*/
+function getMobileControlsBottom() {
+	return LAYOUT_BOTTOM_POSITIONS.MOBILE_CONTROLS;
+}
+//#endregion
+export { getMobileControlsBottom };
+
+//# sourceMappingURL=layout.js.map

package/lib/types/constants/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","names":[],"sources":["../../../src/types/constants/layout.ts"],"sourcesContent":["/**\n * Layout positioning constants for combat and training screens\n * Centralized to prevent magic numbers and ensure consistency\n * \n * @category UI Constants\n * @korean 레이아웃위치상수\n */\n\n/**\n * Bottom positioning for UI elements (in pixels)\n * Values designed to prevent overlap and prioritize gameplay visibility:\n * - Mobile controls at 200px for ergonomic touch access\n * - TechniqueBar lowered to 20px (mobile) / 30px (desktop) to minimize arena obstruction\n * - Back button moved to top-right corner (off-center) for accessibility\n * \n * PRIORITY: Combat arena visibility > TechniqueBar > Mobile controls > Back button\n */\nexport const LAYOUT_BOTTOM_POSITIONS = {\n  /** Mobile controls (VirtualDPad, ActionButtons) - must stay at 200px for accessibility */\n  MOBILE_CONTROLS: 200,\n  \n  /** TechniqueBar container - lowered to bottom to prioritize arena visibility */\n  TECHNIQUE_BAR: {\n    MOBILE: 20,   // Near bottom of screen to minimize arena obstruction\n    DESKTOP: 30,  // Slightly higher on desktop for better visibility\n  },\n  \n  /** TechniqueBar container height (for overlap calculations) */\n  TECHNIQUE_BAR_HEIGHT: 180,\n} as const;\n\n/**\n * Top positioning for UI elements (in pixels)\n * Used for elements positioned from the top of the screen\n */\nexport const LAYOUT_TOP_POSITIONS = {\n  /** Back to Menu button positioned at top-right */\n  BACK_BUTTON: {\n    MOBILE: 10,    // 10px from top on mobile\n    DESKTOP: 20,   // 20px from top on desktop\n  },\n  \n  /** Safe area offset for notched devices */\n  SAFE_AREA_TOP: 44, // iPhone notch height\n} as const;\n\n/**\n * Helper function to get technique bar bottom position\n * NOTE: positionScale NOT applied to prevent layout bugs on 4K displays\n * \n * @param isMobile - Whether device is mobile (<768px)\n * @returns Bottom position in pixels\n */\nexport function getTechniqueBarBottom(isMobile: boolean): number {\n  return isMobile \n    ? LAYOUT_BOTTOM_POSITIONS.TECHNIQUE_BAR.MOBILE\n    : LAYOUT_BOTTOM_POSITIONS.TECHNIQUE_BAR.DESKTOP;\n}\n\n/**\n * Get mobile controls bottom position (always 200px)\n * \n * @returns Bottom position in pixels\n */\nexport function getMobileControlsBottom(): number {\n  return LAYOUT_BOTTOM_POSITIONS.MOBILE_CONTROLS;\n}\n\n/**\n * Get back button top position for top-right corner placement\n * Includes safe area offset for notched devices\n * \n * @param isMobile - Whether device is mobile (<768px)\n * @param hasSafeArea - Whether device has notch/safe area (default: false)\n * @returns Top position in pixels\n */\nexport function getBackButtonTop(isMobile: boolean, hasSafeArea = false): number {\n  const baseTop = isMobile \n    ? LAYOUT_TOP_POSITIONS.BACK_BUTTON.MOBILE\n    : LAYOUT_TOP_POSITIONS.BACK_BUTTON.DESKTOP;\n  \n  return hasSafeArea \n    ? baseTop + LAYOUT_TOP_POSITIONS.SAFE_AREA_TOP\n    : baseTop;\n}\n\n/**\n * Get back button right position for top-right corner placement\n * \n * @param isMobile - Whether device is mobile (<768px)\n * @returns Right position in pixels\n */\nexport function getBackButtonRight(isMobile: boolean): number {\n  return isMobile ? 10 : 20;\n}\n\n/**\n * Type for layout position values\n */\nexport type LayoutBottomPosition = number;\nexport type LayoutTopPosition = number;\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,0BAA0B;CAErC,iBAAiB;CAGjB,eAAe;EACb,QAAQ;EACR,SAAS;EACV;CAGD,sBAAsB;CACvB;;;;;;AAmCD,SAAgB,0BAAkC;AAChD,QAAO,wBAAwB"}

package/lib/types/constants/performance.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Performance constants and optimization settings for Black Trigram
+ *
+ * Optimized settings for different device categories to maintain 60fps target
+ * Special attention to low-end mobile devices (<380px, older hardware)
+ *
+ * @module types/constants/performance
+ * @category Performance
+ * @korean 성능설정상수
+ */
+/**
+ * Performance tier levels based on device capabilities
+ *
+ * @category Performance
+ * @korean 성능등급
+ */
+export type PerformanceTier = 'low' | 'medium' | 'high' | 'mobile-high';
+/**
+ * Performance settings for different device tiers
+ * Balances visual quality with frame rate targets
+ *
+ * @category Performance
+ * @korean 성능설정
+ */
+export interface PerformanceSettings {
+    /** Maximum particle count for effects */
+    readonly maxParticles: number;
+    /** Shadow map resolution (512, 1024, 2048) */
+    readonly shadowMapSize: number;
+    /** Enable antialiasing */
+    readonly antialias: boolean;
+    /** Device pixel ratio limit ([min, max] or single value) */
+    readonly dpr: number | [number, number];
+    /** Enable post-processing effects */
+    readonly postProcessing: boolean;
+    /** Target frame rate (fps) */
+    readonly targetFPS: number;
+}
+/**
+ * Performance settings by tier
+ *
+ * Low tier: Extra-small mobile (<380px), older devices, budget hardware
+ * Medium tier: Standard mobile (380-768px), tablets
+ * Mobile-high tier: High-resolution mobile devices (≥768px, 2K+, Motorola Edge, etc.)
+ * High tier: Desktop, large displays, modern hardware
+ *
+ * @constant
+ * @category Performance
+ * @korean 성능등급별설정
+ */
+export declare const PERFORMANCE_SETTINGS_BY_TIER: Record<PerformanceTier, PerformanceSettings>;
+/**
+ * Determine performance tier based on device characteristics
+ *
+ * Now properly handles high-resolution mobile devices (Motorola Edge 60 Pro, etc.)
+ * by checking isMobile flag before using screen width to determine tier.
+ *
+ * @param screenWidth - Screen width in pixels
+ * @param isMobile - Whether device is mobile (from user-agent detection)
+ * @returns Performance tier
+ *
+ * @example
+ * ```typescript
+ * getPerformanceTier(320, true);   // 'low' (extra-small mobile)
+ * getPerformanceTier(768, true);   // 'medium' (standard mobile)
+ * getPerformanceTier(2712, true);  // 'mobile-high' (Motorola Edge 60 Pro, 2K+ mobile)
+ * getPerformanceTier(768, false);  // 'medium' (tablet)
+ * getPerformanceTier(1920, false); // 'high' (desktop)
+ * ```
+ *
+ * @public
+ * @korean 성능등급결정
+ */
+export declare function getPerformanceTier(screenWidth: number, isMobile: boolean): PerformanceTier;
+/**
+ * Get performance settings for current device
+ *
+ * Properly handles high-resolution mobile devices (2K+, Super HD) by using
+ * the isMobile flag from user-agent detection before screen width classification.
+ *
+ * This ensures devices like Motorola Edge 60 Pro (2712x1220) get mobile-optimized
+ * settings with proper dpr support up to 3.5x for their Super HD displays.
+ *
+ * @param screenWidth - Screen width in pixels
+ * @param isMobile - Whether device is mobile (from user-agent detection)
+ * @returns Performance settings object
+ *
+ * @example
+ * ```typescript
+ * // Standard mobile (iPhone SE)
+ * const settings = getPerformanceSettings(375, true);
+ * // { maxParticles: 40, shadowMapSize: 1024, dpr: [1, 2], ... }
+ *
+ * // High-res mobile (Motorola Edge 60 Pro)
+ * const settingsHD = getPerformanceSettings(2712, true);
+ * // { maxParticles: 50, shadowMapSize: 1536, dpr: [1, 3.5], ... }
+ *
+ * // Desktop
+ * const settingsDesktop = getPerformanceSettings(1920, false);
+ * // { maxParticles: 100, shadowMapSize: 2048, dpr: [1, 2], ... }
+ *
+ * <Canvas
+ *   dpr={settings.dpr}
+ *   gl={{ antialias: settings.antialias }}
+ * />
+ * ```
+ *
+ * @public
+ * @korean 성능설정얻기
+ */
+export declare function getPerformanceSettings(screenWidth: number, isMobile: boolean): PerformanceSettings;
+/**
+ * Frame time budget in milliseconds for target FPS
+ *
+ * @constant
+ * @category Performance
+ * @korean 프레임시간예산
+ */
+export declare const FRAME_TIME_BUDGET: {
+    /** 60fps = 16.67ms per frame */
+    readonly FPS_60: 16.67;
+    /** 55fps = 18.18ms per frame */
+    readonly FPS_55: 18.18;
+    /** 50fps = 20ms per frame */
+    readonly FPS_50: 20;
+    /** 30fps = 33.33ms per frame (minimum acceptable) */
+    readonly FPS_30: 33.33;
+};
+/**
+ * Performance optimization thresholds for mobile
+ *
+ * Target values for mobile performance optimization:
+ * - FPS: 55+ sustained during combat
+ * - Draw calls: <100 per frame
+ * - Memory: <200MB heap usage
+ * - Particle count: 50% of desktop
+ *
+ * Note: shadowMapSize (512) represents the baseline/minimum for mobile.
+ * The adaptive quality system can dynamically adjust above this baseline
+ * (512 → 1024 → 1536) when performance allows, providing better visuals
+ * on higher-end mobile devices while maintaining the 512 minimum for
+ * low-end devices.
+ *
+ * @constant
+ * @category Performance
+ * @korean 모바일성능임계값
+ */
+export declare const MOBILE_PERFORMANCE_THRESHOLDS: {
+    /** Target FPS for mobile devices */
+    readonly targetFPS: 55;
+    /** Minimum acceptable FPS before quality downgrade */
+    readonly minAcceptableFPS: 45;
+    /** Maximum draw calls per frame */
+    readonly maxDrawCalls: 100;
+    /** Maximum memory usage in MB */
+    readonly maxMemoryMB: 200;
+    /** Particle count reduction factor (0.5 = 50% of desktop) */
+    readonly particleReduction: 0.5;
+    /** Shadow map size for mobile (baseline - adaptive quality can increase) */
+    readonly shadowMapSize: 512;
+};
+/**
+ * Desktop performance thresholds
+ *
+ * @constant
+ * @category Performance
+ * @korean 데스크톱성능임계값
+ */
+export declare const DESKTOP_PERFORMANCE_THRESHOLDS: {
+    /** Target FPS for desktop */
+    readonly targetFPS: 60;
+    /** Minimum acceptable FPS before quality downgrade */
+    readonly minAcceptableFPS: 55;
+    /** Maximum draw calls per frame */
+    readonly maxDrawCalls: 150;
+    /** Maximum memory usage in MB */
+    readonly maxMemoryMB: 300;
+    /** Particle count reduction factor (1.0 = full desktop quality) */
+    readonly particleReduction: 1;
+    /** Shadow map size for desktop */
+    readonly shadowMapSize: 2048;
+};
+//# sourceMappingURL=performance.d.ts.map

package/lib/types/constants/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/types/constants/performance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAiC5E,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,eAAe,CAyBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,mBAAmB,CAGrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gCAAgC;;IAEhC,gCAAgC;;IAEhC,6BAA6B;;IAE7B,qDAAqD;;CAE7C,CAAC;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B;IACxC,oCAAoC;;IAEpC,sDAAsD;;IAEtD,mCAAmC;;IAEnC,iCAAiC;;IAEjC,6DAA6D;;IAE7D,4EAA4E;;CAEpE,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;IACzC,6BAA6B;;IAE7B,sDAAsD;;IAEtD,mCAAmC;;IAEnC,iCAAiC;;IAEjC,mEAAmE;;IAEnE,kCAAkC;;CAE1B,CAAC"}

package/lib/types/constants/performance.js

@@ -0,0 +1,134 @@
+//#region src/types/constants/performance.ts
+/**
+* Performance settings by tier
+* 
+* Low tier: Extra-small mobile (<380px), older devices, budget hardware
+* Medium tier: Standard mobile (380-768px), tablets
+* Mobile-high tier: High-resolution mobile devices (≥768px, 2K+, Motorola Edge, etc.)
+* High tier: Desktop, large displays, modern hardware
+* 
+* @constant
+* @category Performance
+* @korean 성능등급별설정
+*/
+var PERFORMANCE_SETTINGS_BY_TIER = {
+	low: {
+		maxParticles: 20,
+		shadowMapSize: 512,
+		antialias: false,
+		dpr: 1,
+		postProcessing: false,
+		targetFPS: 50
+	},
+	medium: {
+		maxParticles: 40,
+		shadowMapSize: 1024,
+		antialias: true,
+		dpr: [1, 2],
+		postProcessing: false,
+		targetFPS: 55
+	},
+	"mobile-high": {
+		maxParticles: 50,
+		shadowMapSize: 1536,
+		antialias: true,
+		dpr: [1, 3.5],
+		postProcessing: false,
+		targetFPS: 55
+	},
+	high: {
+		maxParticles: 100,
+		shadowMapSize: 2048,
+		antialias: true,
+		dpr: [1, 2],
+		postProcessing: true,
+		targetFPS: 60
+	}
+};
+/**
+* Determine performance tier based on device characteristics
+* 
+* Now properly handles high-resolution mobile devices (Motorola Edge 60 Pro, etc.)
+* by checking isMobile flag before using screen width to determine tier.
+* 
+* @param screenWidth - Screen width in pixels
+* @param isMobile - Whether device is mobile (from user-agent detection)
+* @returns Performance tier
+* 
+* @example
+* ```typescript
+* getPerformanceTier(320, true);   // 'low' (extra-small mobile)
+* getPerformanceTier(768, true);   // 'medium' (standard mobile)
+* getPerformanceTier(2712, true);  // 'mobile-high' (Motorola Edge 60 Pro, 2K+ mobile)
+* getPerformanceTier(768, false);  // 'medium' (tablet)
+* getPerformanceTier(1920, false); // 'high' (desktop)
+* ```
+* 
+* @public
+* @korean 성능등급결정
+*/
+function getPerformanceTier(screenWidth, isMobile) {
+	if (isMobile) {
+		if (screenWidth < 380) return "low";
+		if (screenWidth >= 768) return "mobile-high";
+		return "medium";
+	}
+	if (screenWidth < 1024) return "medium";
+	return "high";
+}
+/**
+* Get performance settings for current device
+* 
+* Properly handles high-resolution mobile devices (2K+, Super HD) by using
+* the isMobile flag from user-agent detection before screen width classification.
+* 
+* This ensures devices like Motorola Edge 60 Pro (2712x1220) get mobile-optimized
+* settings with proper dpr support up to 3.5x for their Super HD displays.
+* 
+* @param screenWidth - Screen width in pixels
+* @param isMobile - Whether device is mobile (from user-agent detection)
+* @returns Performance settings object
+* 
+* @example
+* ```typescript
+* // Standard mobile (iPhone SE)
+* const settings = getPerformanceSettings(375, true);
+* // { maxParticles: 40, shadowMapSize: 1024, dpr: [1, 2], ... }
+* 
+* // High-res mobile (Motorola Edge 60 Pro)
+* const settingsHD = getPerformanceSettings(2712, true);
+* // { maxParticles: 50, shadowMapSize: 1536, dpr: [1, 3.5], ... }
+* 
+* // Desktop
+* const settingsDesktop = getPerformanceSettings(1920, false);
+* // { maxParticles: 100, shadowMapSize: 2048, dpr: [1, 2], ... }
+* 
+* <Canvas
+*   dpr={settings.dpr}
+*   gl={{ antialias: settings.antialias }}
+* />
+* ```
+* 
+* @public
+* @korean 성능설정얻기
+*/
+function getPerformanceSettings(screenWidth, isMobile) {
+	return PERFORMANCE_SETTINGS_BY_TIER[getPerformanceTier(screenWidth, isMobile)];
+}
+/**
+* Frame time budget in milliseconds for target FPS
+* 
+* @constant
+* @category Performance
+* @korean 프레임시간예산
+*/
+var FRAME_TIME_BUDGET = {
+	FPS_60: 16.67,
+	FPS_55: 18.18,
+	FPS_50: 20,
+	FPS_30: 33.33
+};
+//#endregion
+export { FRAME_TIME_BUDGET, PERFORMANCE_SETTINGS_BY_TIER, getPerformanceSettings, getPerformanceTier };
+
+//# sourceMappingURL=performance.js.map

package/lib/types/constants/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","names":[],"sources":["../../../src/types/constants/performance.ts"],"sourcesContent":["/**\n * Performance constants and optimization settings for Black Trigram\n * \n * Optimized settings for different device categories to maintain 60fps target\n * Special attention to low-end mobile devices (<380px, older hardware)\n * \n * @module types/constants/performance\n * @category Performance\n * @korean 성능설정상수\n */\n\n/**\n * Performance tier levels based on device capabilities\n * \n * @category Performance\n * @korean 성능등급\n */\nexport type PerformanceTier = 'low' | 'medium' | 'high' | 'mobile-high';\n\n/**\n * Performance settings for different device tiers\n * Balances visual quality with frame rate targets\n * \n * @category Performance\n * @korean 성능설정\n */\nexport interface PerformanceSettings {\n  /** Maximum particle count for effects */\n  readonly maxParticles: number;\n  /** Shadow map resolution (512, 1024, 2048) */\n  readonly shadowMapSize: number;\n  /** Enable antialiasing */\n  readonly antialias: boolean;\n  /** Device pixel ratio limit ([min, max] or single value) */\n  readonly dpr: number | [number, number];\n  /** Enable post-processing effects */\n  readonly postProcessing: boolean;\n  /** Target frame rate (fps) */\n  readonly targetFPS: number;\n}\n\n/**\n * Performance settings by tier\n * \n * Low tier: Extra-small mobile (<380px), older devices, budget hardware\n * Medium tier: Standard mobile (380-768px), tablets\n * Mobile-high tier: High-resolution mobile devices (≥768px, 2K+, Motorola Edge, etc.)\n * High tier: Desktop, large displays, modern hardware\n * \n * @constant\n * @category Performance\n * @korean 성능등급별설정\n */\nexport const PERFORMANCE_SETTINGS_BY_TIER: Record<PerformanceTier, PerformanceSettings> = {\n  low: {\n    maxParticles: 20,\n    shadowMapSize: 512,\n    antialias: false, // Disable AA for performance\n    dpr: 1, // Cap at 1x for low-end devices\n    postProcessing: false,\n    targetFPS: 50, // Realistic target for low-end\n  },\n  medium: {\n    maxParticles: 40,\n    shadowMapSize: 1024,\n    antialias: true,\n    dpr: [1, 2], // Allow up to 2x\n    postProcessing: false, // Keep disabled for mobile\n    targetFPS: 55,\n  },\n  'mobile-high': {\n    maxParticles: 50, // Between medium and high\n    shadowMapSize: 1536, // Between 1024 and 2048\n    antialias: true,\n    dpr: [1, 3.5], // Support up to 3.5x for Super HD displays (2712x1220)\n    postProcessing: false, // Keep disabled for mobile battery life\n    targetFPS: 55, // Realistic for high-end mobile\n  },\n  high: {\n    maxParticles: 100,\n    shadowMapSize: 2048,\n    antialias: true,\n    dpr: [1, 2],\n    postProcessing: true,\n    targetFPS: 60,\n  },\n} as const;\n\n/**\n * Determine performance tier based on device characteristics\n * \n * Now properly handles high-resolution mobile devices (Motorola Edge 60 Pro, etc.)\n * by checking isMobile flag before using screen width to determine tier.\n * \n * @param screenWidth - Screen width in pixels\n * @param isMobile - Whether device is mobile (from user-agent detection)\n * @returns Performance tier\n * \n * @example\n * ```typescript\n * getPerformanceTier(320, true);   // 'low' (extra-small mobile)\n * getPerformanceTier(768, true);   // 'medium' (standard mobile)\n * getPerformanceTier(2712, true);  // 'mobile-high' (Motorola Edge 60 Pro, 2K+ mobile)\n * getPerformanceTier(768, false);  // 'medium' (tablet)\n * getPerformanceTier(1920, false); // 'high' (desktop)\n * ```\n * \n * @public\n * @korean 성능등급결정\n */\nexport function getPerformanceTier(\n  screenWidth: number,\n  isMobile: boolean\n): PerformanceTier {\n  // Mobile device tiers (user-agent detection takes priority)\n  if (isMobile) {\n    // Extra-small mobile devices (<380px) are always low tier\n    if (screenWidth < 380) {\n      return 'low';\n    }\n    \n    // High-resolution mobile devices (≥768px, 2K+ displays like Motorola Edge 60 Pro)\n    // Get optimized settings for Super HD mobile displays\n    if (screenWidth >= 768) {\n      return 'mobile-high';\n    }\n    \n    // Standard mobile devices (380-768px)\n    return 'medium';\n  }\n  \n  // Non-mobile devices (tablets and desktop)\n  if (screenWidth < 1024) {\n    return 'medium'; // Tablet tier\n  }\n  \n  // Desktop and large displays are high tier\n  return 'high';\n}\n\n/**\n * Get performance settings for current device\n * \n * Properly handles high-resolution mobile devices (2K+, Super HD) by using\n * the isMobile flag from user-agent detection before screen width classification.\n * \n * This ensures devices like Motorola Edge 60 Pro (2712x1220) get mobile-optimized\n * settings with proper dpr support up to 3.5x for their Super HD displays.\n * \n * @param screenWidth - Screen width in pixels\n * @param isMobile - Whether device is mobile (from user-agent detection)\n * @returns Performance settings object\n * \n * @example\n * ```typescript\n * // Standard mobile (iPhone SE)\n * const settings = getPerformanceSettings(375, true);\n * // { maxParticles: 40, shadowMapSize: 1024, dpr: [1, 2], ... }\n * \n * // High-res mobile (Motorola Edge 60 Pro)\n * const settingsHD = getPerformanceSettings(2712, true);\n * // { maxParticles: 50, shadowMapSize: 1536, dpr: [1, 3.5], ... }\n * \n * // Desktop\n * const settingsDesktop = getPerformanceSettings(1920, false);\n * // { maxParticles: 100, shadowMapSize: 2048, dpr: [1, 2], ... }\n * \n * <Canvas\n *   dpr={settings.dpr}\n *   gl={{ antialias: settings.antialias }}\n * />\n * ```\n * \n * @public\n * @korean 성능설정얻기\n */\nexport function getPerformanceSettings(\n  screenWidth: number,\n  isMobile: boolean\n): PerformanceSettings {\n  const tier = getPerformanceTier(screenWidth, isMobile);\n  return PERFORMANCE_SETTINGS_BY_TIER[tier];\n}\n\n/**\n * Frame time budget in milliseconds for target FPS\n * \n * @constant\n * @category Performance\n * @korean 프레임시간예산\n */\nexport const FRAME_TIME_BUDGET = {\n  /** 60fps = 16.67ms per frame */\n  FPS_60: 16.67,\n  /** 55fps = 18.18ms per frame */\n  FPS_55: 18.18,\n  /** 50fps = 20ms per frame */\n  FPS_50: 20,\n  /** 30fps = 33.33ms per frame (minimum acceptable) */\n  FPS_30: 33.33,\n} as const;\n\n/**\n * Performance optimization thresholds for mobile\n * \n * Target values for mobile performance optimization:\n * - FPS: 55+ sustained during combat\n * - Draw calls: <100 per frame\n * - Memory: <200MB heap usage\n * - Particle count: 50% of desktop\n * \n * Note: shadowMapSize (512) represents the baseline/minimum for mobile.\n * The adaptive quality system can dynamically adjust above this baseline\n * (512 → 1024 → 1536) when performance allows, providing better visuals\n * on higher-end mobile devices while maintaining the 512 minimum for\n * low-end devices.\n * \n * @constant\n * @category Performance\n * @korean 모바일성능임계값\n */\nexport const MOBILE_PERFORMANCE_THRESHOLDS = {\n  /** Target FPS for mobile devices */\n  targetFPS: 55,\n  /** Minimum acceptable FPS before quality downgrade */\n  minAcceptableFPS: 45,\n  /** Maximum draw calls per frame */\n  maxDrawCalls: 100,\n  /** Maximum memory usage in MB */\n  maxMemoryMB: 200,\n  /** Particle count reduction factor (0.5 = 50% of desktop) */\n  particleReduction: 0.5,\n  /** Shadow map size for mobile (baseline - adaptive quality can increase) */\n  shadowMapSize: 512,\n} as const;\n\n/**\n * Desktop performance thresholds\n * \n * @constant\n * @category Performance\n * @korean 데스크톱성능임계값\n */\nexport const DESKTOP_PERFORMANCE_THRESHOLDS = {\n  /** Target FPS for desktop */\n  targetFPS: 60,\n  /** Minimum acceptable FPS before quality downgrade */\n  minAcceptableFPS: 55,\n  /** Maximum draw calls per frame */\n  maxDrawCalls: 150,\n  /** Maximum memory usage in MB */\n  maxMemoryMB: 300,\n  /** Particle count reduction factor (1.0 = full desktop quality) */\n  particleReduction: 1.0,\n  /** Shadow map size for desktop */\n  shadowMapSize: 2048,\n} as const;\n"],"mappings":";;;;;;;;;;;;;AAqDA,IAAa,+BAA6E;CACxF,KAAK;EACH,cAAc;EACd,eAAe;EACf,WAAW;EACX,KAAK;EACL,gBAAgB;EAChB,WAAW;EACZ;CACD,QAAQ;EACN,cAAc;EACd,eAAe;EACf,WAAW;EACX,KAAK,CAAC,GAAG,EAAE;EACX,gBAAgB;EAChB,WAAW;EACZ;CACD,eAAe;EACb,cAAc;EACd,eAAe;EACf,WAAW;EACX,KAAK,CAAC,GAAG,IAAI;EACb,gBAAgB;EAChB,WAAW;EACZ;CACD,MAAM;EACJ,cAAc;EACd,eAAe;EACf,WAAW;EACX,KAAK,CAAC,GAAG,EAAE;EACX,gBAAgB;EAChB,WAAW;EACZ;CACF;;;;;;;;;;;;;;;;;;;;;;;AAwBD,SAAgB,mBACd,aACA,UACiB;AAEjB,KAAI,UAAU;AAEZ,MAAI,cAAc,IAChB,QAAO;AAKT,MAAI,eAAe,IACjB,QAAO;AAIT,SAAO;;AAIT,KAAI,cAAc,KAChB,QAAO;AAIT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCT,SAAgB,uBACd,aACA,UACqB;AAErB,QAAO,6BADM,mBAAmB,aAAa,SAAS;;;;;;;;;AAWxD,IAAa,oBAAoB;CAE/B,QAAQ;CAER,QAAQ;CAER,QAAQ;CAER,QAAQ;CACT"}