blacktrigram 0.7.2

package/lib/types/constants/designSystem.js

@@ -0,0 +1,406 @@
+import { KOREAN_COLORS } from "./colors.js";
+import { FONT_FAMILY } from "./typography.js";
+//#region src/types/constants/designSystem.ts
+/**
+* Design System for Black Trigram HUD Components
+* 
+* Provides a unified visual language for cyberpunk Korean-themed interfaces
+* All values based on KOREAN_COLORS and FONT_FAMILY constants
+* 
+* Key Principles:
+* - 4px base spacing scale for consistent rhythm
+* - Typography scale optimized for Korean text readability
+* - WCAG AA compliant color hierarchies
+* - Consistent HUD styling with cyberpunk aesthetic
+* 
+* @korean 흑괘 HUD 디자인 시스템
+* @module DesignSystem
+*/
+/**
+* Convert hex color to RGB string
+* @param hex - Hex color value (e.g., 0x00e6e6)
+* @returns RGB string (e.g., "0, 230, 230")
+*/
+function hexToRgbString(hex) {
+	return `${hex >> 16 & 255}, ${hex >> 8 & 255}, ${hex & 255}`;
+}
+/**
+* Convert hex color to RGB color string
+* @param hex - Hex color value (e.g., 0x00e6e6)
+* @returns RGB color string (e.g., "rgb(0, 230, 230)")
+*/
+function hexToRgb(hex) {
+	return `rgb(${hexToRgbString(hex)})`;
+}
+/**
+* Typography Scale
+* 
+* Optimized for Korean text with proper line-heights and font weights.
+* All sizes include fontFamily to ensure consistent Korean rendering.
+* 
+* @korean 타이포그래피 척도
+*/
+var TYPOGRAPHY = {
+	heading1: {
+		fontSize: "24px",
+		fontWeight: 700,
+		lineHeight: 1.2,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	heading2: {
+		fontSize: "20px",
+		fontWeight: 600,
+		lineHeight: 1.3,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	heading3: {
+		fontSize: "16px",
+		fontWeight: 600,
+		lineHeight: 1.4,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	body: {
+		fontSize: "14px",
+		fontWeight: 400,
+		lineHeight: 1.5,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	bodySmall: {
+		fontSize: "12px",
+		fontWeight: 400,
+		lineHeight: 1.5,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	button: {
+		fontSize: "14px",
+		fontWeight: 600,
+		lineHeight: 1.4,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	caption: {
+		fontSize: "10px",
+		fontWeight: 400,
+		lineHeight: 1.4,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	micro: {
+		fontSize: "9px",
+		fontWeight: 400,
+		lineHeight: 1.4,
+		fontFamily: FONT_FAMILY.KOREAN
+	},
+	nano: {
+		fontSize: "8px",
+		fontWeight: 400,
+		lineHeight: 1.3,
+		fontFamily: FONT_FAMILY.KOREAN
+	}
+};
+/**
+* Pre-parsed Numeric Typography Values
+* 
+* Performance optimization: Numeric font sizes parsed once at module load
+* instead of repeated parseInt calls in component useMemo hooks.
+* 
+* @korean 사전 파싱된 타이포그래피 숫자 값
+*/
+var TYPOGRAPHY_NUMERIC = {
+	heading1: 24,
+	heading2: 20,
+	heading3: 16,
+	body: 14,
+	bodySmall: 12,
+	button: 14,
+	caption: 10,
+	micro: 9,
+	nano: 8
+};
+/**
+* Spacing Scale (4px base)
+* 
+* Consistent spacing system for margins, padding, and gaps.
+* Based on 4px increments for visual rhythm.
+* 
+* @korean 간격 척도
+*/
+var SPACING = {
+	xxs: "4px",
+	xs: "8px",
+	sm: "12px",
+	md: "16px",
+	lg: "24px",
+	xl: "32px",
+	xxl: "48px"
+};
+/**
+* Spacing Adjustments
+* 
+* Fine-tuned spacing values for specific layout requirements.
+* Use when standard SPACING scale doesn't provide exact needed value.
+* 
+* @korean 간격 조정
+*/
+var SPACING_ADJUSTMENTS = {
+	xsPlus: "10px",
+	smPlus: "14px",
+	mdPlus: "18px",
+	compact: "6px",
+	horizontalEmphasis: "24px",
+	micro: "3px",
+	tiny: "2px"
+};
+/**
+* Pre-parsed Numeric Spacing Values
+* 
+* Performance optimization: Numeric spacing values parsed once at module load.
+* Eliminates repeated parseInt calls in component calculations.
+* 
+* @korean 사전 파싱된 간격 숫자 값
+*/
+var SPACING_NUMERIC = {
+	xxs: 4,
+	xs: 8,
+	sm: 12,
+	md: 16,
+	lg: 24,
+	xl: 32,
+	xxl: 48,
+	xsPlus: 10,
+	smPlus: 14,
+	mdPlus: 18,
+	compact: 6,
+	horizontalEmphasis: 24,
+	micro: 3,
+	tiny: 2
+};
+/**
+* Font Size Multipliers
+* 
+* Scaling factors for responsive font size calculations.
+* Used to maintain consistent proportions across different screen sizes.
+* 
+* @korean 글꼴 크기 배율
+*/
+var FONT_SIZE_MULTIPLIERS = {
+	titleSmall: .6,
+	messageSmall: .75,
+	bodySmall: .875,
+	titleLarge: 1.125
+};
+/**
+* Layout Multipliers
+* 
+* Scaling factors for layout calculations.
+* Used to maintain consistent spacing relationships.
+* 
+* @korean 레이아웃 배율
+*/
+var LAYOUT_MULTIPLIERS = { gapToPadding: 1.2 };
+/**
+* Border Radius Scale
+* 
+* Consistent border radius values for UI elements.
+* Provides semantic naming for rounded corners.
+* 
+* @korean 테두리 반경 척도
+*/
+var BORDER_RADIUS = {
+	none: "0px",
+	sm: "4px",
+	md: "6px",
+	lg: "8px",
+	xl: "12px",
+	full: "9999px"
+};
+/**
+* HUD Style Constants
+* 
+* Unified styling for all HUD panels with cyberpunk Korean aesthetic.
+* Includes backgrounds, borders, shadows, and interactive states.
+* 
+* @korean HUD 스타일 상수
+*/
+var HUD_STYLE = {
+	background: `rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, 0.85)`,
+	backgroundRgb: hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK),
+	border: `2px solid ${hexToRgb(KOREAN_COLORS.PRIMARY_CYAN)}`,
+	borderRadius: BORDER_RADIUS.lg,
+	shadow: `0 4px 12px rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, 0.6)`,
+	shadowHover: `0 6px 20px rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.3)`,
+	backdropFilter: "blur(8px)",
+	accentGlow: `0 0 10px rgba(${hexToRgbString(KOREAN_COLORS.ACCENT_GOLD)}, 0.5)`,
+	cyanGlow: `0 0 10px rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.5)`
+};
+/**
+* Color Hierarchy for Text and UI Elements
+* 
+* WCAG AA compliant color system for different levels of visual emphasis.
+* All colors formatted as RGB strings for easy opacity manipulation.
+* 
+* @korean 색상 계층
+*/
+var HIERARCHY = {
+	primary: {
+		color: hexToRgb(KOREAN_COLORS.TEXT_PRIMARY),
+		hex: KOREAN_COLORS.TEXT_PRIMARY
+	},
+	secondary: {
+		color: hexToRgb(KOREAN_COLORS.TEXT_SECONDARY),
+		hex: KOREAN_COLORS.TEXT_SECONDARY
+	},
+	tertiary: {
+		color: hexToRgb(KOREAN_COLORS.TEXT_TERTIARY),
+		hex: KOREAN_COLORS.TEXT_TERTIARY
+	},
+	muted: {
+		color: hexToRgb(KOREAN_COLORS.UI_DISABLED_TEXT),
+		hex: KOREAN_COLORS.UI_DISABLED_TEXT
+	},
+	accent: {
+		color: hexToRgb(KOREAN_COLORS.PRIMARY_CYAN),
+		hex: KOREAN_COLORS.PRIMARY_CYAN
+	},
+	gold: {
+		color: hexToRgb(KOREAN_COLORS.ACCENT_GOLD),
+		hex: KOREAN_COLORS.ACCENT_GOLD
+	},
+	accent70: {
+		color: `rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.7)`,
+		hex: KOREAN_COLORS.PRIMARY_CYAN
+	},
+	accent50: {
+		color: `rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.5)`,
+		hex: KOREAN_COLORS.PRIMARY_CYAN
+	},
+	primary80: {
+		color: `rgba(${hexToRgbString(KOREAN_COLORS.TEXT_PRIMARY)}, 0.8)`,
+		hex: KOREAN_COLORS.TEXT_PRIMARY
+	}
+};
+/**
+* Border Styles for Different UI States
+* 
+* @korean 테두리 스타일
+*/
+var BORDERS = {
+	default: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.4)`,
+	accent: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.ACCENT_GOLD)}, 0.6)`,
+	muted: `1px solid rgba(${hexToRgbString(KOREAN_COLORS.UI_STEEL_GRAY)}, 0.3)`,
+	active: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 1.0)`
+};
+/**
+* Gradient Backgrounds
+* 
+* Cyberpunk-inspired gradients for panels and overlays.
+* 
+* @korean 그라디언트 배경
+*/
+var GRADIENTS = {
+	vertical: (opacity = .85) => `linear-gradient(180deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * .7}) 100%)`,
+	verticalReverse: (opacity = .85) => `linear-gradient(0deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * .7}) 100%)`,
+	horizontal: (opacity = .85) => `linear-gradient(90deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * .4}) 100%)`,
+	horizontalReverse: (opacity = .85) => `linear-gradient(270deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * .4}) 100%)`,
+	radial: (opacity = .85) => `radial-gradient(circle, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * .5}) 100%)`
+};
+/**
+* Transition Timings
+* 
+* Consistent animation durations for smooth interactions.
+* 
+* @korean 전환 타이밍
+*/
+var TRANSITIONS = {
+	fast: "150ms ease-in-out",
+	normal: "250ms ease-in-out",
+	slow: "400ms ease-in-out"
+};
+/**
+* Opacity Constants
+* 
+* Standard opacity values for consistent transparency effects.
+* 
+* @korean 투명도 상수
+*/
+var OPACITY = {
+	base: .7,
+	increment: .1,
+	light: .3,
+	medium: .5,
+	heavy: .8
+};
+/**
+* Combat UI Dimensions
+* 
+* Common width and size constraints for combat UI elements.
+* 
+* @korean 전투 UI 크기
+*/
+var COMBAT_UI_DIMENSIONS = {
+	combatLogMinMobile: "200px",
+	combatLogMinDesktop: "280px",
+	combatLogMaxMobile: "90%",
+	combatLogMaxDesktop: "500px",
+	combatLogMaxWidthPercentMobile: .9,
+	techniqueBarWidthMobile: "100%",
+	techniqueBarWidthDesktop: "70%"
+};
+/**
+* Pre-parsed Numeric Combat UI Dimensions
+* 
+* Performance optimization: Numeric dimension values parsed once at module load.
+* Eliminates repeated parseInt calls for combat UI dimensions.
+* 
+* @korean 사전 파싱된 전투 UI 크기 숫자 값
+*/
+var COMBAT_UI_DIMENSIONS_NUMERIC = {
+	combatLogMinMobile: 200,
+	combatLogMinDesktop: 280,
+	combatLogMaxDesktop: 500
+};
+/**
+* Text Effects
+* 
+* Reusable text shadow effects for emphasis and readability.
+* 
+* @korean 텍스트 효과
+*/
+var TEXT_EFFECTS = {
+	darkShadow: "0 0 4px rgba(0,0,0,0.8)",
+	lightGlow: "0 0 8px rgba(255,255,255,0.5)"
+};
+/**
+* Get responsive spacing based on screen size
+* 
+* Note: This helper function uses parseInt internally for flexibility
+* in returning pixel-suffixed strings. For performance-critical useMemo
+* calculations, prefer using SPACING_NUMERIC constants directly.
+* 
+* @param baseSpacing - Base spacing value from SPACING scale
+* @param isMobile - Whether mobile layout is active
+* @param positionScale - Position scale multiplier (for 4K displays)
+* @returns Calculated spacing in pixels
+*/
+function getResponsiveSpacing(baseSpacing, isMobile, positionScale = 1) {
+	const baseValue = parseInt(SPACING[baseSpacing], 10);
+	return `${isMobile ? baseValue : baseValue * positionScale}px`;
+}
+/**
+* Get responsive font size based on typography scale
+* 
+* Note: This helper function uses parseInt internally for flexibility
+* in returning pixel-suffixed strings. For performance-critical useMemo
+* calculations, prefer using TYPOGRAPHY_NUMERIC constants directly.
+* 
+* @param typographyLevel - Typography level from TYPOGRAPHY
+* @param isMobile - Whether mobile layout is active
+* @param positionScale - Position scale multiplier (for 4K displays)
+* @returns Calculated font size in pixels
+*/
+function getResponsiveFontSize(typographyLevel, isMobile, positionScale = 1) {
+	const baseSize = parseInt(TYPOGRAPHY[typographyLevel].fontSize, 10);
+	return `${isMobile ? baseSize : baseSize * positionScale}px`;
+}
+//#endregion
+export { BORDERS, BORDER_RADIUS, COMBAT_UI_DIMENSIONS, COMBAT_UI_DIMENSIONS_NUMERIC, FONT_SIZE_MULTIPLIERS, GRADIENTS, HIERARCHY, HUD_STYLE, LAYOUT_MULTIPLIERS, OPACITY, SPACING, SPACING_ADJUSTMENTS, SPACING_NUMERIC, TEXT_EFFECTS, TRANSITIONS, TYPOGRAPHY, TYPOGRAPHY_NUMERIC, getResponsiveFontSize, getResponsiveSpacing };
+
+//# sourceMappingURL=designSystem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"designSystem.js","names":[],"sources":["../../../src/types/constants/designSystem.ts"],"sourcesContent":["/**\n * Design System for Black Trigram HUD Components\n * \n * Provides a unified visual language for cyberpunk Korean-themed interfaces\n * All values based on KOREAN_COLORS and FONT_FAMILY constants\n * \n * Key Principles:\n * - 4px base spacing scale for consistent rhythm\n * - Typography scale optimized for Korean text readability\n * - WCAG AA compliant color hierarchies\n * - Consistent HUD styling with cyberpunk aesthetic\n * \n * @korean 흑괘 HUD 디자인 시스템\n * @module DesignSystem\n */\n\nimport { KOREAN_COLORS } from './colors';\nimport { FONT_FAMILY } from './typography';\n\n/**\n * Convert hex color to RGB string\n * @param hex - Hex color value (e.g., 0x00e6e6)\n * @returns RGB string (e.g., \"0, 230, 230\")\n */\nfunction hexToRgbString(hex: number): string {\n  const r = (hex >> 16) & 255;\n  const g = (hex >> 8) & 255;\n  const b = hex & 255;\n  return `${r}, ${g}, ${b}`;\n}\n\n/**\n * Convert hex color to RGB color string\n * @param hex - Hex color value (e.g., 0x00e6e6)\n * @returns RGB color string (e.g., \"rgb(0, 230, 230)\")\n */\nfunction hexToRgb(hex: number): string {\n  return `rgb(${hexToRgbString(hex)})`;\n}\n\n/**\n * Typography Scale\n * \n * Optimized for Korean text with proper line-heights and font weights.\n * All sizes include fontFamily to ensure consistent Korean rendering.\n * \n * @korean 타이포그래피 척도\n */\nexport const TYPOGRAPHY = {\n  /** Heading 1 - Main titles (24px) */\n  heading1: {\n    fontSize: '24px',\n    fontWeight: 700,\n    lineHeight: 1.2,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Heading 2 - Section titles (20px) */\n  heading2: {\n    fontSize: '20px',\n    fontWeight: 600,\n    lineHeight: 1.3,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Heading 3 - Subsection titles (16px) */\n  heading3: {\n    fontSize: '16px',\n    fontWeight: 600,\n    lineHeight: 1.4,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Body - Regular content (14px) */\n  body: {\n    fontSize: '14px',\n    fontWeight: 400,\n    lineHeight: 1.5,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Body Small - Secondary content (12px) */\n  bodySmall: {\n    fontSize: '12px',\n    fontWeight: 400,\n    lineHeight: 1.5,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Button - Button text (14px, semibold) */\n  button: {\n    fontSize: '14px',\n    fontWeight: 600,\n    lineHeight: 1.4,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Caption - Labels and hints (10px) */\n  caption: {\n    fontSize: '10px',\n    fontWeight: 400,\n    lineHeight: 1.4,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Micro - Very small text (9px) - for dense information */\n  micro: {\n    fontSize: '9px',\n    fontWeight: 400,\n    lineHeight: 1.4,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n  /** Nano - Smallest text (8px) - for status indicators */\n  nano: {\n    fontSize: '8px',\n    fontWeight: 400,\n    lineHeight: 1.3,\n    fontFamily: FONT_FAMILY.KOREAN,\n  },\n} as const;\n\n/**\n * Pre-parsed Numeric Typography Values\n * \n * Performance optimization: Numeric font sizes parsed once at module load\n * instead of repeated parseInt calls in component useMemo hooks.\n * \n * @korean 사전 파싱된 타이포그래피 숫자 값\n */\nexport const TYPOGRAPHY_NUMERIC = {\n  heading1: 24,\n  heading2: 20,\n  heading3: 16,\n  body: 14,\n  bodySmall: 12,\n  button: 14,\n  caption: 10,\n  micro: 9,\n  nano: 8,\n} as const;\n\n/**\n * Spacing Scale (4px base)\n * \n * Consistent spacing system for margins, padding, and gaps.\n * Based on 4px increments for visual rhythm.\n * \n * @korean 간격 척도\n */\nexport const SPACING = {\n  /** Extra Extra Small - 4px */\n  xxs: '4px',\n  /** Extra Small - 8px */\n  xs: '8px',\n  /** Small - 12px */\n  sm: '12px',\n  /** Medium - 16px */\n  md: '16px',\n  /** Large - 24px */\n  lg: '24px',\n  /** Extra Large - 32px */\n  xl: '32px',\n  /** Extra Extra Large - 48px */\n  xxl: '48px',\n} as const;\n\n/**\n * Spacing Adjustments\n * \n * Fine-tuned spacing values for specific layout requirements.\n * Use when standard SPACING scale doesn't provide exact needed value.\n * \n * @korean 간격 조정\n */\nexport const SPACING_ADJUSTMENTS = {\n  /** Extra small with minor adjustment - 10px (xs + 2px) */\n  xsPlus: '10px',\n  /** Small with minor adjustment - 14px (sm + 2px) */\n  smPlus: '14px',\n  /** Medium with minor adjustment - 18px (md + 2px) */\n  mdPlus: '18px',\n  /** Small gap for compact layouts - 6px */\n  compact: '6px',\n  /** \n   * Horizontal emphasis - 24px\n   * Aliases SPACING.lg for semantic use in wider horizontal padding\n   * Defined as 1.5x SPACING.md to emphasize horizontal breathing room\n   */\n  horizontalEmphasis: '24px',\n  /** Micro gap - 3px (for very tight layouts) */\n  micro: '3px',\n  /** Tiny margin - 2px (for subtle spacing) */\n  tiny: '2px',\n} as const;\n\n/**\n * Pre-parsed Numeric Spacing Values\n * \n * Performance optimization: Numeric spacing values parsed once at module load.\n * Eliminates repeated parseInt calls in component calculations.\n * \n * @korean 사전 파싱된 간격 숫자 값\n */\nexport const SPACING_NUMERIC = {\n  xxs: 4,\n  xs: 8,\n  sm: 12,\n  md: 16,\n  lg: 24,\n  xl: 32,\n  xxl: 48,\n  // Adjustments\n  xsPlus: 10,\n  smPlus: 14,\n  mdPlus: 18,\n  compact: 6,\n  horizontalEmphasis: 24,\n  micro: 3,\n  tiny: 2,\n} as const;\n\n/**\n * Font Size Multipliers\n * \n * Scaling factors for responsive font size calculations.\n * Used to maintain consistent proportions across different screen sizes.\n * \n * @korean 글꼴 크기 배율\n */\nexport const FONT_SIZE_MULTIPLIERS = {\n  /** Small title scaling - 60% of base */\n  titleSmall: 0.6,\n  /** Small message scaling - 75% of base */\n  messageSmall: 0.75,\n  /** Body small scaling - 87.5% of base */\n  bodySmall: 0.875,\n  /** Title large scaling - 112.5% of base */\n  titleLarge: 1.125,\n} as const;\n\n/**\n * Layout Multipliers\n * \n * Scaling factors for layout calculations.\n * Used to maintain consistent spacing relationships.\n * \n * @korean 레이아웃 배율\n */\nexport const LAYOUT_MULTIPLIERS = {\n  /** Gap to padding ratio - 120% */\n  gapToPadding: 1.2,\n} as const;\n\n\n\n/**\n * Border Radius Scale\n * \n * Consistent border radius values for UI elements.\n * Provides semantic naming for rounded corners.\n * \n * @korean 테두리 반경 척도\n */\nexport const BORDER_RADIUS = {\n  /** None - 0px (sharp corners) */\n  none: '0px',\n  /** Small - 4px */\n  sm: '4px',\n  /** Medium - 6px */\n  md: '6px',\n  /** Large - 8px */\n  lg: '8px',\n  /** Extra Large - 12px */\n  xl: '12px',\n  /** Full - 9999px (pill shape) */\n  full: '9999px',\n} as const;\n\n/**\n * HUD Style Constants\n * \n * Unified styling for all HUD panels with cyberpunk Korean aesthetic.\n * Includes backgrounds, borders, shadows, and interactive states.\n * \n * @korean HUD 스타일 상수\n */\nexport const HUD_STYLE = {\n  /** Background - Dark with 85% opacity */\n  background: `rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, 0.85)`,\n  /** Background RGB for gradient stops */\n  backgroundRgb: hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK),\n  /** Border - 2px solid cyan */\n  border: `2px solid ${hexToRgb(KOREAN_COLORS.PRIMARY_CYAN)}`,\n  /** Border radius - 8px for smooth corners (from BORDER_RADIUS.lg) */\n  borderRadius: BORDER_RADIUS.lg,\n  /** Box shadow - Subtle depth */\n  shadow: `0 4px 12px rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, 0.6)`,\n  /** Hover shadow - Increased depth on interaction */\n  shadowHover: `0 6px 20px rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.3)`,\n  /** Backdrop filter - Blur for glassmorphism */\n  backdropFilter: 'blur(8px)',\n  /** Accent glow - For important elements */\n  accentGlow: `0 0 10px rgba(${hexToRgbString(KOREAN_COLORS.ACCENT_GOLD)}, 0.5)`,\n  /** Cyan glow - For primary highlights */\n  cyanGlow: `0 0 10px rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.5)`,\n} as const;\n\n/**\n * Color Hierarchy for Text and UI Elements\n * \n * WCAG AA compliant color system for different levels of visual emphasis.\n * All colors formatted as RGB strings for easy opacity manipulation.\n * \n * @korean 색상 계층\n */\nexport const HIERARCHY = {\n  /** Primary - Main content (White - highest contrast) */\n  primary: {\n    color: hexToRgb(KOREAN_COLORS.TEXT_PRIMARY),\n    hex: KOREAN_COLORS.TEXT_PRIMARY,\n  },\n  /** Secondary - Supporting content (Light gray) */\n  secondary: {\n    color: hexToRgb(KOREAN_COLORS.TEXT_SECONDARY),\n    hex: KOREAN_COLORS.TEXT_SECONDARY,\n  },\n  /** Tertiary - Subtle content (Medium gray) */\n  tertiary: {\n    color: hexToRgb(KOREAN_COLORS.TEXT_TERTIARY),\n    hex: KOREAN_COLORS.TEXT_TERTIARY,\n  },\n  /** Muted - Disabled or inactive (Dark gray) */\n  muted: {\n    color: hexToRgb(KOREAN_COLORS.UI_DISABLED_TEXT),\n    hex: KOREAN_COLORS.UI_DISABLED_TEXT,\n  },\n  /** Accent - Emphasis and highlights (Cyan) */\n  accent: {\n    color: hexToRgb(KOREAN_COLORS.PRIMARY_CYAN),\n    hex: KOREAN_COLORS.PRIMARY_CYAN,\n  },\n  /** Gold - Special emphasis (Gold) */\n  gold: {\n    color: hexToRgb(KOREAN_COLORS.ACCENT_GOLD),\n    hex: KOREAN_COLORS.ACCENT_GOLD,\n  },\n  /** Accent with 70% opacity - For subtle emphasis */\n  accent70: {\n    color: `rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.7)`,\n    hex: KOREAN_COLORS.PRIMARY_CYAN,\n  },\n  /** Accent with 50% opacity - For backgrounds */\n  accent50: {\n    color: `rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.5)`,\n    hex: KOREAN_COLORS.PRIMARY_CYAN,\n  },\n  /** Primary with 80% opacity - For hover states */\n  primary80: {\n    color: `rgba(${hexToRgbString(KOREAN_COLORS.TEXT_PRIMARY)}, 0.8)`,\n    hex: KOREAN_COLORS.TEXT_PRIMARY,\n  },\n} as const;\n\n/**\n * Border Styles for Different UI States\n * \n * @korean 테두리 스타일\n */\nexport const BORDERS = {\n  /** Default border - Cyan 40% opacity */\n  default: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 0.4)`,\n  /** Accent border - Gold for emphasis */\n  accent: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.ACCENT_GOLD)}, 0.6)`,\n  /** Muted border - Gray for subtle separation */\n  muted: `1px solid rgba(${hexToRgbString(KOREAN_COLORS.UI_STEEL_GRAY)}, 0.3)`,\n  /** Active border - Full cyan for interaction */\n  active: `2px solid rgba(${hexToRgbString(KOREAN_COLORS.PRIMARY_CYAN)}, 1.0)`,\n} as const;\n\n/**\n * Gradient Backgrounds\n * \n * Cyberpunk-inspired gradients for panels and overlays.\n * \n * @korean 그라디언트 배경\n */\nexport const GRADIENTS = {\n  /** Vertical fade - Top to bottom */\n  vertical: (opacity: number = 0.85) =>\n    `linear-gradient(180deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * 0.7}) 100%)`,\n  /** Vertical fade (reverse) - Bottom to top */\n  verticalReverse: (opacity: number = 0.85) =>\n    `linear-gradient(0deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * 0.7}) 100%)`,\n  /** Horizontal fade - Left to right */\n  horizontal: (opacity: number = 0.85) =>\n    `linear-gradient(90deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * 0.4}) 100%)`,\n  /** Horizontal fade (reverse) - Right to left */\n  horizontalReverse: (opacity: number = 0.85) =>\n    `linear-gradient(270deg, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * 0.4}) 100%)`,\n  /** Radial fade - Center outward */\n  radial: (opacity: number = 0.85) =>\n    `radial-gradient(circle, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity}) 0%, rgba(${hexToRgbString(KOREAN_COLORS.UI_BACKGROUND_DARK)}, ${opacity * 0.5}) 100%)`,\n} as const;\n\n/**\n * Transition Timings\n * \n * Consistent animation durations for smooth interactions.\n * \n * @korean 전환 타이밍\n */\nexport const TRANSITIONS = {\n  /** Fast - Quick interactions (150ms) */\n  fast: '150ms ease-in-out',\n  /** Normal - Standard interactions (250ms) */\n  normal: '250ms ease-in-out',\n  /** Slow - Emphasis animations (400ms) */\n  slow: '400ms ease-in-out',\n} as const;\n\n/**\n * Opacity Constants\n * \n * Standard opacity values for consistent transparency effects.\n * \n * @korean 투명도 상수\n */\nexport const OPACITY = {\n  /** Base opacity for layered elements */\n  base: 0.7,\n  /** Opacity increment for stacking */\n  increment: 0.1,\n  /** High transparency */\n  light: 0.3,\n  /** Medium transparency */\n  medium: 0.5,\n  /** Low transparency */\n  heavy: 0.8,\n} as const;\n\n/**\n * Combat UI Dimensions\n * \n * Common width and size constraints for combat UI elements.\n * \n * @korean 전투 UI 크기\n */\nexport const COMBAT_UI_DIMENSIONS = {\n  /** Combat log minimum width - mobile */\n  combatLogMinMobile: '200px',\n  /** Combat log minimum width - desktop */\n  combatLogMinDesktop: '280px',\n  /** Combat log maximum width - mobile (percentage) */\n  combatLogMaxMobile: '90%',\n  /** Combat log maximum width - desktop */\n  combatLogMaxDesktop: '500px',\n  /** Combat log maximum width percentage (mobile) - 90% as decimal */\n  combatLogMaxWidthPercentMobile: 0.9,\n  /** Technique bar width - mobile (full width) */\n  techniqueBarWidthMobile: '100%',\n  /** Technique bar width - desktop (70% width) */\n  techniqueBarWidthDesktop: '70%',\n} as const;\n\n/**\n * Pre-parsed Numeric Combat UI Dimensions\n * \n * Performance optimization: Numeric dimension values parsed once at module load.\n * Eliminates repeated parseInt calls for combat UI dimensions.\n * \n * @korean 사전 파싱된 전투 UI 크기 숫자 값\n */\nexport const COMBAT_UI_DIMENSIONS_NUMERIC = {\n  combatLogMinMobile: 200,\n  combatLogMinDesktop: 280,\n  combatLogMaxDesktop: 500,\n} as const;\n\n/**\n * Text Effects\n * \n * Reusable text shadow effects for emphasis and readability.\n * \n * @korean 텍스트 효과\n */\nexport const TEXT_EFFECTS = {\n  /** Dark shadow for contrast on bright backgrounds */\n  darkShadow: '0 0 4px rgba(0,0,0,0.8)',\n  /** Light glow for emphasis */\n  lightGlow: '0 0 8px rgba(255,255,255,0.5)',\n} as const;\n\n/**\n * Get responsive spacing based on screen size\n * \n * Note: This helper function uses parseInt internally for flexibility\n * in returning pixel-suffixed strings. For performance-critical useMemo\n * calculations, prefer using SPACING_NUMERIC constants directly.\n * \n * @param baseSpacing - Base spacing value from SPACING scale\n * @param isMobile - Whether mobile layout is active\n * @param positionScale - Position scale multiplier (for 4K displays)\n * @returns Calculated spacing in pixels\n */\nexport function getResponsiveSpacing(\n  baseSpacing: keyof typeof SPACING,\n  isMobile: boolean,\n  positionScale: number = 1.0\n): string {\n  const baseValue = parseInt(SPACING[baseSpacing], 10);\n  const scaledValue = isMobile ? baseValue : baseValue * positionScale;\n  return `${scaledValue}px`;\n}\n\n/**\n * Get responsive font size based on typography scale\n * \n * Note: This helper function uses parseInt internally for flexibility\n * in returning pixel-suffixed strings. For performance-critical useMemo\n * calculations, prefer using TYPOGRAPHY_NUMERIC constants directly.\n * \n * @param typographyLevel - Typography level from TYPOGRAPHY\n * @param isMobile - Whether mobile layout is active\n * @param positionScale - Position scale multiplier (for 4K displays)\n * @returns Calculated font size in pixels\n */\nexport function getResponsiveFontSize(\n  typographyLevel: keyof typeof TYPOGRAPHY,\n  isMobile: boolean,\n  positionScale: number = 1.0\n): string {\n  const baseSize = parseInt(TYPOGRAPHY[typographyLevel].fontSize, 10);\n  const scaledSize = isMobile ? baseSize : baseSize * positionScale;\n  return `${scaledSize}px`;\n}\n\n/**\n * Type definitions for design system usage\n */\nexport type TypographyLevel = keyof typeof TYPOGRAPHY;\nexport type SpacingLevel = keyof typeof SPACING;\nexport type BorderRadiusLevel = keyof typeof BORDER_RADIUS;\nexport type HierarchyLevel = keyof typeof HIERARCHY;\n"],"mappings":"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"}

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

@@ -0,0 +1,181 @@
+/**
+ * Main constants export for Black Trigram Korean martial arts system
+ */
+export { CYBERPUNK_COLORS, KOREAN_COLORS } from "./colors";
+export { FONT_FAMILY, FONT_SIZES, FONT_WEIGHTS, KOREAN_FONT_WEIGHTS, KOREAN_TEXT_SIZES, KOREAN_MOBILE_FONT_SIZES, getKoreanFontSize, } from "./typography";
+export { HEALTH_COLORS, UI_CONSTANTS, UI_DIMENSIONS } from "./ui";
+export { TYPOGRAPHY, TYPOGRAPHY_NUMERIC, SPACING, SPACING_NUMERIC, SPACING_ADJUSTMENTS, BORDER_RADIUS, HUD_STYLE, HIERARCHY, BORDERS, GRADIENTS, TRANSITIONS, OPACITY, COMBAT_UI_DIMENSIONS, COMBAT_UI_DIMENSIONS_NUMERIC, TEXT_EFFECTS, FONT_SIZE_MULTIPLIERS, LAYOUT_MULTIPLIERS, getResponsiveSpacing, getResponsiveFontSize, type TypographyLevel, type SpacingLevel, type BorderRadiusLevel, type HierarchyLevel, } from "./designSystem";
+export { PERFORMANCE_SETTINGS_BY_TIER, FRAME_TIME_BUDGET, getPerformanceTier, getPerformanceSettings, type PerformanceTier, type PerformanceSettings, } from "./performance";
+export { RESPONSIVE_BREAKPOINTS, FONT_SCALE_MAP, SPACING_SCALE_MAP, FONT_SIZE_CONSTRAINTS, DEFAULT_RESIZE_TRANSITION, getScreenSize, calculateFontSize, calculateSpacing, getFontScale, getSpacingScale, createTransitionString, createResponsiveConfig, calculateResponsiveValues, testScreenSize, isMobileSize, isTabletSize, isDesktopSize, type ScreenSize as ResponsiveScreenSize, type ResponsiveBreakpoints, type FontScaleMap, type SpacingScaleMap, type ResponsiveScaleConfig, type ResizeTransitionConfig, type ResponsiveValues, type ScreenSizeTestResult, } from "../../systems/ResponsiveScaling";
+export { KOREAN_COLORS as default } from "./colors";
+export { ANIMATION_DURATIONS } from "./animations";
+/**
+ * Archetype-specific technique damage bonuses
+ * Maps archetype to technique ID to bonus multiplier
+ *
+ * @category Combat System
+ * @korean 원형별 기술 보너스
+ */
+export declare const ARCHETYPE_TECHNIQUE_BONUSES: Record<string, Record<string, number>>;
+/**
+ * Maximum ki cost for stance transitions
+ * @category Combat System
+ * @korean 최대 기 전환 비용
+ */
+export declare const MAX_TRANSITION_COST_KI = 50;
+/**
+ * Maximum stamina cost for stance transitions
+ * @category Combat System
+ * @korean 최대 체력 전환 비용
+ */
+export declare const MAX_TRANSITION_COST_STAMINA = 30;
+/**
+ * Maximum time allowed for stance transitions in milliseconds
+ * @category Combat System
+ * @korean 최대 전환 시간
+ */
+export declare const MAX_TRANSITION_TIME_MILLISECONDS = 1000;
+/**
+ * Performance rating thresholds for match results
+ * Calculated based on combat effectiveness metrics
+ *
+ * @category Combat Performance
+ * @korean 전투 성능 등급
+ */
+export declare const PERFORMANCE_RATING_THRESHOLDS: {
+    readonly S: {
+        readonly minScore: 90;
+        readonly korean: "S급";
+        readonly english: "S Rank";
+        readonly description: {
+            readonly korean: "완벽한 전투";
+            readonly english: "Perfect Combat";
+        };
+        readonly color: 16766720;
+    };
+    readonly A: {
+        readonly minScore: 75;
+        readonly korean: "A급";
+        readonly english: "A Rank";
+        readonly description: {
+            readonly korean: "우수한 전투";
+            readonly english: "Excellent Combat";
+        };
+        readonly color: 65535;
+    };
+    readonly B: {
+        readonly minScore: 60;
+        readonly korean: "B급";
+        readonly english: "B Rank";
+        readonly description: {
+            readonly korean: "양호한 전투";
+            readonly english: "Good Combat";
+        };
+        readonly color: 3381759;
+    };
+    readonly C: {
+        readonly minScore: 0;
+        readonly korean: "C급";
+        readonly english: "C Rank";
+        readonly description: {
+            readonly korean: "보통 전투";
+            readonly english: "Average Combat";
+        };
+        readonly 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 플레이어 원형 에셋
+ */
+export declare const ARCHETYPE_ASSETS: {
+    readonly musa: {
+        readonly id: "musa";
+        readonly image: "/assets/visual/archetypes/musa.png";
+        readonly theme: "/assets/audio/music/archetype_themes/musa_warrior.mp3";
+        readonly themeId: "musa_warrior_theme";
+        readonly name_korean: "무사";
+        readonly name_english: "Traditional Warrior";
+        readonly textureKey: "musa";
+    };
+    readonly amsalja: {
+        readonly id: "amsalja";
+        readonly image: "/assets/visual/archetypes/amsalja.png";
+        readonly theme: "/assets/audio/music/archetype_themes/amsalja_shadow.mp3";
+        readonly themeId: "amsalja_shadow_theme";
+        readonly name_korean: "암살자";
+        readonly name_english: "Shadow Assassin";
+        readonly textureKey: "amsalja";
+    };
+    readonly hacker: {
+        readonly id: "hacker";
+        readonly image: "/assets/visual/archetypes/hacker.png";
+        readonly theme: "/assets/audio/music/archetype_themes/hacker_cyber.mp3";
+        readonly themeId: "hacker_cyber_theme";
+        readonly name_korean: "해커";
+        readonly name_english: "Cyber Warrior";
+        readonly textureKey: "hacker";
+    };
+    readonly jeongbo_yowon: {
+        readonly id: "jeongbo_yowon";
+        readonly image: "/assets/visual/archetypes/jeongbo_yowon.png";
+        readonly theme: "/assets/audio/music/archetype_themes/jeongbo_intel.mp3";
+        readonly themeId: "jeongbo_intel_theme";
+        readonly name_korean: "정보요원";
+        readonly name_english: "Intelligence Operative";
+        readonly textureKey: "jeongbo_yowon";
+    };
+    readonly jojik_pokryeokbae: {
+        readonly id: "jojik_pokryeokbae";
+        readonly image: "/assets/visual/archetypes/jojik_pokryeokbae.png";
+        readonly theme: "/assets/audio/music/archetype_themes/jojik_street.mp3";
+        readonly themeId: "jojik_street_theme";
+        readonly name_korean: "조직폭력배";
+        readonly name_english: "Organized Crime";
+        readonly 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 원형 배경 이미지
+ */
+export declare const ARCHETYPE_BACKGROUNDS: {
+    readonly overview: "/assets/visual/bg/archetyples/PlayerArchetypesOverview.png";
+    readonly explained: "/assets/visual/bg/archetyples/PlayerArchetypesExplained.png";
+    readonly teamDynamics: "/assets/visual/bg/archetyples/CyberpunkTeamDynamics.png";
+};
+/**
+ * Fallback image path for when archetype images fail to load
+ *
+ * @category Visual Assets
+ * @korean 대체 이미지 경로
+ */
+export declare const 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 라운드 발표 타이밍
+ */
+export declare const ROUND_ANNOUNCEMENT_TIMINGS: {
+    /** Duration to display announcement before countdown (seconds) */
+    readonly ANNOUNCEMENT_DURATION: 2;
+    /** Duration of countdown to next round (seconds) */
+    readonly COUNTDOWN_DURATION: 3;
+    /** Brief transition duration before next round starts (milliseconds) */
+    readonly TRANSITION_DURATION: 500;
+    /** Fade in animation duration (milliseconds) */
+    readonly FADE_IN_DURATION: 300;
+    /** Fade out animation duration (milliseconds) */
+    readonly FADE_OUT_DURATION: 300;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EAEZ,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAGlE,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,4BAA4B,EAC5B,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EAEb,KAAK,UAAU,IAAI,oBAAoB,EACvC,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC;AAOpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChC,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CnB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAG,2CAAoD,CAAC;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;IACrC,kEAAkE;;IAElE,oDAAoD;;IAEpD,wEAAwE;;IAExE,gDAAgD;;IAEhD,iDAAiD;;CAEzC,CAAC"}