blacktrigram 0.7.2

package/lib/test/test-utils.d.ts

@@ -0,0 +1,46 @@
+import { PlayerState } from "../systems";
+import type { RenderOptions } from "@testing-library/react";
+import React from "react";
+/**
+ * Generic mutable type - removes readonly modifier from all properties
+ * Use this type when you need to modify readonly properties in tests
+ */
+export type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/**
+ * Mutable version of PlayerState for test setup
+ * Use this type when you need to modify player properties in tests
+ */
+export type MutablePlayerState = Mutable<PlayerState>;
+/**
+ * Cast any object to a mutable version for test setup purposes
+ * This allows direct property assignment during test setup on readonly properties
+ */
+export declare function asMutable<T>(obj: T): Mutable<T>;
+/**
+ * Arena bounds for combat testing
+ */
+export interface ArenaBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scale?: number;
+    worldWidthMeters: number;
+    worldDepthMeters: number;
+}
+/**
+ * Create mock arena bounds
+ */
+export declare function createMockArena(): ArenaBounds;
+export declare function createMockPlayerState(overrides?: Partial<PlayerState>): PlayerState;
+/**
+ * Create a modified copy of player state (for tests that need to mutate state)
+ * Use this instead of direct property assignment on readonly PlayerState
+ */
+export declare function withPlayerState(player: PlayerState, updates: Partial<PlayerState>): PlayerState;
+export declare function customRender(ui: React.ReactElement, options?: Omit<RenderOptions, "wrapper">): import("@testing-library/react").RenderResult<typeof import("@testing-library/dom/types/queries"), HTMLElement, HTMLElement>;
+export * from "@testing-library/react";
+export { customRender as render };
+//# sourceMappingURL=test-utils.d.ts.map

package/lib/test/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/test/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAU7C;AAED,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CA0Cb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,WAAW,CAEb;AAGD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,KAAK,CAAC,YAAY,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,gIAKzC;AAED,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,CAAC"}

package/lib/types/AccessibilityTypes.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Accessibility type definitions for WCAG 2.1 Level AA compliance
+ * Provides type-safe ARIA attributes and keyboard navigation interfaces
+ *
+ * @module types/AccessibilityTypes
+ * @category Accessibility
+ * @korean 접근성 타입
+ */
+/**
+ * ARIA role types for semantic HTML elements
+ */
+export type AriaRole = 'button' | 'navigation' | 'main' | 'complementary' | 'contentinfo' | 'banner' | 'form' | 'search' | 'region' | 'article' | 'alert' | 'alertdialog' | 'dialog' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'progressbar' | 'slider' | 'spinbutton' | 'tab' | 'tablist' | 'tabpanel' | 'toolbar' | 'tooltip' | 'group' | 'listbox' | 'option' | 'radio' | 'radiogroup' | 'switch' | 'link' | 'img' | 'presentation' | 'none';
+/**
+ * ARIA live region politeness levels
+ */
+export type AriaLive = 'off' | 'polite' | 'assertive';
+/**
+ * ARIA current state values
+ */
+export type AriaCurrent = 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false';
+/**
+ * Keyboard key codes for navigation
+ */
+export declare enum KeyCode {
+    ENTER = "Enter",
+    SPACE = " ",
+    ESCAPE = "Escape",
+    TAB = "Tab",
+    ARROW_UP = "ArrowUp",
+    ARROW_DOWN = "ArrowDown",
+    ARROW_LEFT = "ArrowLeft",
+    ARROW_RIGHT = "ArrowRight",
+    HOME = "Home",
+    END = "End",
+    PAGE_UP = "PageUp",
+    PAGE_DOWN = "PageDown"
+}
+/**
+ * Keyboard navigation actions
+ */
+export interface KeyboardActions {
+    /** Action triggered on Enter or Space */
+    readonly onActivate?: () => void;
+    /** Action triggered on Escape */
+    readonly onCancel?: () => void;
+    /** Action triggered on arrow keys */
+    readonly onNavigate?: (direction: 'up' | 'down' | 'left' | 'right') => void;
+    /** Action triggered on Tab key */
+    readonly onTab?: (shiftKey: boolean) => void;
+    /** Action triggered on Home/End keys */
+    readonly onJump?: (to: 'start' | 'end') => void;
+}
+/**
+ * ARIA attributes for components
+ */
+export interface AriaAttributes {
+    /** ARIA role */
+    readonly role?: AriaRole;
+    /** ARIA label (Korean | English bilingual format) */
+    readonly 'aria-label'?: string;
+    /** ARIA labelled by element ID */
+    readonly 'aria-labelledby'?: string;
+    /** ARIA described by element ID */
+    readonly 'aria-describedby'?: string;
+    /** ARIA live region politeness */
+    readonly 'aria-live'?: AriaLive;
+    /** ARIA expanded state */
+    readonly 'aria-expanded'?: boolean;
+    /** ARIA pressed state */
+    readonly 'aria-pressed'?: boolean;
+    /** ARIA selected state */
+    readonly 'aria-selected'?: boolean;
+    /** ARIA checked state */
+    readonly 'aria-checked'?: boolean | 'mixed';
+    /** ARIA disabled state */
+    readonly 'aria-disabled'?: boolean;
+    /** ARIA hidden state */
+    readonly 'aria-hidden'?: boolean;
+    /** ARIA current state */
+    readonly 'aria-current'?: AriaCurrent;
+    /** ARIA modal state */
+    readonly 'aria-modal'?: boolean;
+    /** ARIA controls element ID */
+    readonly 'aria-controls'?: string;
+    /** ARIA owns element IDs */
+    readonly 'aria-owns'?: string;
+    /** ARIA has popup type */
+    readonly 'aria-haspopup'?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+    /** ARIA value now (for progress indicators) */
+    readonly 'aria-valuenow'?: number;
+    /** ARIA value min */
+    readonly 'aria-valuemin'?: number;
+    /** ARIA value max */
+    readonly 'aria-valuemax'?: number;
+    /** ARIA value text */
+    readonly 'aria-valuetext'?: string;
+    /** ARIA orientation */
+    readonly 'aria-orientation'?: 'horizontal' | 'vertical';
+    /** ARIA atomic (for live regions) */
+    readonly 'aria-atomic'?: boolean;
+    /** ARIA relevant (for live regions) */
+    readonly 'aria-relevant'?: 'additions' | 'removals' | 'text' | 'all';
+    /** ARIA busy state */
+    readonly 'aria-busy'?: boolean;
+    /** ARIA invalid state */
+    readonly 'aria-invalid'?: boolean | 'grammar' | 'spelling';
+    /** ARIA required state */
+    readonly 'aria-required'?: boolean;
+    /** ARIA readonly state */
+    readonly 'aria-readonly'?: boolean;
+}
+/**
+ * Focus management configuration
+ */
+export interface FocusConfig {
+    /** Whether element should receive focus on mount */
+    readonly autoFocus?: boolean;
+    /** Whether focus should be trapped within element */
+    readonly trapFocus?: boolean;
+    /** Whether focus should be restored on unmount */
+    readonly restoreFocus?: boolean;
+    /** Initial focus target selector */
+    readonly initialFocus?: string;
+    /** Return focus target selector */
+    readonly returnFocus?: string;
+}
+/**
+ * Focus indicator style configuration
+ */
+export interface FocusIndicatorStyle {
+    /** Outline width in pixels */
+    readonly outlineWidth?: number;
+    /** Outline color (hex) */
+    readonly outlineColor?: number;
+    /** Outline offset in pixels */
+    readonly outlineOffset?: number;
+    /** Outline style */
+    readonly outlineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Box shadow for glow effect */
+    readonly boxShadow?: string;
+    /** Transition duration in seconds */
+    readonly transitionDuration?: number;
+}
+/**
+ * Keyboard event handler type
+ */
+export type KeyboardEventHandler = (event: KeyboardEvent) => void;
+/**
+ * Focus event handler type
+ */
+export type FocusEventHandler = (event: FocusEvent) => void;
+/**
+ * Screen reader announcement configuration
+ */
+export interface ScreenReaderAnnouncement {
+    /** Message to announce (Korean | English bilingual) */
+    readonly message: string;
+    /** Politeness level */
+    readonly politeness?: AriaLive;
+    /** Delay before announcement in milliseconds */
+    readonly delay?: number;
+}
+/**
+ * Color contrast configuration for WCAG compliance
+ */
+export interface ColorContrastConfig {
+    /** Foreground color (hex) */
+    readonly foreground: number;
+    /** Background color (hex) */
+    readonly background: number;
+    /** Target contrast ratio (4.5:1 for normal text, 3:1 for large text or UI) */
+    readonly targetRatio: 4.5 | 3;
+    /** Whether this is for large text (18pt+ or 14pt+ bold) */
+    readonly isLargeText?: boolean;
+}
+/**
+ * Accessibility validation result
+ */
+export interface AccessibilityValidation {
+    /** Whether validation passed */
+    readonly passed: boolean;
+    /** Validation errors */
+    readonly errors: readonly string[];
+    /** Validation warnings */
+    readonly warnings: readonly string[];
+    /** Validation recommendations */
+    readonly recommendations: readonly string[];
+}
+/**
+ * WCAG compliance level
+ */
+export declare enum WCAGLevel {
+    A = "A",
+    AA = "AA",
+    AAA = "AAA"
+}
+/**
+ * WCAG compliance check result
+ */
+export interface WCAGComplianceResult {
+    /** Compliance level achieved */
+    readonly level: WCAGLevel;
+    /** Whether component meets target level */
+    readonly compliant: boolean;
+    /** Specific criteria results */
+    readonly criteria: {
+        readonly keyboardAccessible: boolean;
+        readonly colorContrast: boolean;
+        readonly focusVisible: boolean;
+        readonly ariaLabels: boolean;
+        readonly semanticHTML: boolean;
+        readonly errorIdentification: boolean;
+    };
+    /** Issues found */
+    readonly issues: readonly string[];
+}
+/**
+ * Bilingual label format (Korean | English)
+ */
+export interface BilingualLabel {
+    /** Korean text */
+    readonly korean: string;
+    /** English text */
+    readonly english: string;
+    /** Formatted label string (Korean | English) */
+    readonly label: string;
+}
+/**
+ * Helper function to create bilingual labels
+ */
+export declare const createBilingualLabel: (korean: string, english: string) => BilingualLabel;
+//# sourceMappingURL=AccessibilityTypes.d.ts.map

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

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

package/lib/types/AccessibilityTypes.js

@@ -0,0 +1,13 @@
+//#region src/types/AccessibilityTypes.ts
+/**
+* Helper function to create bilingual labels
+*/
+var createBilingualLabel = (korean, english) => ({
+	korean,
+	english,
+	label: `${korean} | ${english}`
+});
+//#endregion
+export { createBilingualLabel };
+
+//# sourceMappingURL=AccessibilityTypes.js.map

package/lib/types/AccessibilityTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessibilityTypes.js","names":[],"sources":["../../src/types/AccessibilityTypes.ts"],"sourcesContent":["/**\n * Accessibility type definitions for WCAG 2.1 Level AA compliance\n * Provides type-safe ARIA attributes and keyboard navigation interfaces\n * \n * @module types/AccessibilityTypes\n * @category Accessibility\n * @korean 접근성 타입\n */\n\n/**\n * ARIA role types for semantic HTML elements\n */\nexport type AriaRole =\n  | 'button'\n  | 'navigation'\n  | 'main'\n  | 'complementary'\n  | 'contentinfo'\n  | 'banner'\n  | 'form'\n  | 'search'\n  | 'region'\n  | 'article'\n  | 'alert'\n  | 'alertdialog'\n  | 'dialog'\n  | 'menu'\n  | 'menubar'\n  | 'menuitem'\n  | 'menuitemcheckbox'\n  | 'menuitemradio'\n  | 'progressbar'\n  | 'slider'\n  | 'spinbutton'\n  | 'tab'\n  | 'tablist'\n  | 'tabpanel'\n  | 'toolbar'\n  | 'tooltip'\n  | 'group'\n  | 'listbox'\n  | 'option'\n  | 'radio'\n  | 'radiogroup'\n  | 'switch'\n  | 'link'\n  | 'img'\n  | 'presentation'\n  | 'none';\n\n/**\n * ARIA live region politeness levels\n */\nexport type AriaLive = 'off' | 'polite' | 'assertive';\n\n/**\n * ARIA current state values\n */\nexport type AriaCurrent =\n  | 'page'\n  | 'step'\n  | 'location'\n  | 'date'\n  | 'time'\n  | 'true'\n  | 'false';\n\n/**\n * Keyboard key codes for navigation\n */\nexport enum KeyCode {\n  ENTER = 'Enter',\n  SPACE = ' ',\n  ESCAPE = 'Escape',\n  TAB = 'Tab',\n  ARROW_UP = 'ArrowUp',\n  ARROW_DOWN = 'ArrowDown',\n  ARROW_LEFT = 'ArrowLeft',\n  ARROW_RIGHT = 'ArrowRight',\n  HOME = 'Home',\n  END = 'End',\n  PAGE_UP = 'PageUp',\n  PAGE_DOWN = 'PageDown',\n}\n\n/**\n * Keyboard navigation actions\n */\nexport interface KeyboardActions {\n  /** Action triggered on Enter or Space */\n  readonly onActivate?: () => void;\n  /** Action triggered on Escape */\n  readonly onCancel?: () => void;\n  /** Action triggered on arrow keys */\n  readonly onNavigate?: (direction: 'up' | 'down' | 'left' | 'right') => void;\n  /** Action triggered on Tab key */\n  readonly onTab?: (shiftKey: boolean) => void;\n  /** Action triggered on Home/End keys */\n  readonly onJump?: (to: 'start' | 'end') => void;\n}\n\n/**\n * ARIA attributes for components\n */\nexport interface AriaAttributes {\n  /** ARIA role */\n  readonly role?: AriaRole;\n  /** ARIA label (Korean | English bilingual format) */\n  readonly 'aria-label'?: string;\n  /** ARIA labelled by element ID */\n  readonly 'aria-labelledby'?: string;\n  /** ARIA described by element ID */\n  readonly 'aria-describedby'?: string;\n  /** ARIA live region politeness */\n  readonly 'aria-live'?: AriaLive;\n  /** ARIA expanded state */\n  readonly 'aria-expanded'?: boolean;\n  /** ARIA pressed state */\n  readonly 'aria-pressed'?: boolean;\n  /** ARIA selected state */\n  readonly 'aria-selected'?: boolean;\n  /** ARIA checked state */\n  readonly 'aria-checked'?: boolean | 'mixed';\n  /** ARIA disabled state */\n  readonly 'aria-disabled'?: boolean;\n  /** ARIA hidden state */\n  readonly 'aria-hidden'?: boolean;\n  /** ARIA current state */\n  readonly 'aria-current'?: AriaCurrent;\n  /** ARIA modal state */\n  readonly 'aria-modal'?: boolean;\n  /** ARIA controls element ID */\n  readonly 'aria-controls'?: string;\n  /** ARIA owns element IDs */\n  readonly 'aria-owns'?: string;\n  /** ARIA has popup type */\n  readonly 'aria-haspopup'?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';\n  /** ARIA value now (for progress indicators) */\n  readonly 'aria-valuenow'?: number;\n  /** ARIA value min */\n  readonly 'aria-valuemin'?: number;\n  /** ARIA value max */\n  readonly 'aria-valuemax'?: number;\n  /** ARIA value text */\n  readonly 'aria-valuetext'?: string;\n  /** ARIA orientation */\n  readonly 'aria-orientation'?: 'horizontal' | 'vertical';\n  /** ARIA atomic (for live regions) */\n  readonly 'aria-atomic'?: boolean;\n  /** ARIA relevant (for live regions) */\n  readonly 'aria-relevant'?: 'additions' | 'removals' | 'text' | 'all';\n  /** ARIA busy state */\n  readonly 'aria-busy'?: boolean;\n  /** ARIA invalid state */\n  readonly 'aria-invalid'?: boolean | 'grammar' | 'spelling';\n  /** ARIA required state */\n  readonly 'aria-required'?: boolean;\n  /** ARIA readonly state */\n  readonly 'aria-readonly'?: boolean;\n}\n\n/**\n * Focus management configuration\n */\nexport interface FocusConfig {\n  /** Whether element should receive focus on mount */\n  readonly autoFocus?: boolean;\n  /** Whether focus should be trapped within element */\n  readonly trapFocus?: boolean;\n  /** Whether focus should be restored on unmount */\n  readonly restoreFocus?: boolean;\n  /** Initial focus target selector */\n  readonly initialFocus?: string;\n  /** Return focus target selector */\n  readonly returnFocus?: string;\n}\n\n/**\n * Focus indicator style configuration\n */\nexport interface FocusIndicatorStyle {\n  /** Outline width in pixels */\n  readonly outlineWidth?: number;\n  /** Outline color (hex) */\n  readonly outlineColor?: number;\n  /** Outline offset in pixels */\n  readonly outlineOffset?: number;\n  /** Outline style */\n  readonly outlineStyle?: 'solid' | 'dashed' | 'dotted';\n  /** Box shadow for glow effect */\n  readonly boxShadow?: string;\n  /** Transition duration in seconds */\n  readonly transitionDuration?: number;\n}\n\n/**\n * Keyboard event handler type\n */\nexport type KeyboardEventHandler = (event: KeyboardEvent) => void;\n\n/**\n * Focus event handler type\n */\nexport type FocusEventHandler = (event: FocusEvent) => void;\n\n/**\n * Screen reader announcement configuration\n */\nexport interface ScreenReaderAnnouncement {\n  /** Message to announce (Korean | English bilingual) */\n  readonly message: string;\n  /** Politeness level */\n  readonly politeness?: AriaLive;\n  /** Delay before announcement in milliseconds */\n  readonly delay?: number;\n}\n\n/**\n * Color contrast configuration for WCAG compliance\n */\nexport interface ColorContrastConfig {\n  /** Foreground color (hex) */\n  readonly foreground: number;\n  /** Background color (hex) */\n  readonly background: number;\n  /** Target contrast ratio (4.5:1 for normal text, 3:1 for large text or UI) */\n  readonly targetRatio: 4.5 | 3;\n  /** Whether this is for large text (18pt+ or 14pt+ bold) */\n  readonly isLargeText?: boolean;\n}\n\n/**\n * Accessibility validation result\n */\nexport interface AccessibilityValidation {\n  /** Whether validation passed */\n  readonly passed: boolean;\n  /** Validation errors */\n  readonly errors: readonly string[];\n  /** Validation warnings */\n  readonly warnings: readonly string[];\n  /** Validation recommendations */\n  readonly recommendations: readonly string[];\n}\n\n/**\n * WCAG compliance level\n */\nexport enum WCAGLevel {\n  A = 'A',\n  AA = 'AA',\n  AAA = 'AAA',\n}\n\n/**\n * WCAG compliance check result\n */\nexport interface WCAGComplianceResult {\n  /** Compliance level achieved */\n  readonly level: WCAGLevel;\n  /** Whether component meets target level */\n  readonly compliant: boolean;\n  /** Specific criteria results */\n  readonly criteria: {\n    readonly keyboardAccessible: boolean;\n    readonly colorContrast: boolean;\n    readonly focusVisible: boolean;\n    readonly ariaLabels: boolean;\n    readonly semanticHTML: boolean;\n    readonly errorIdentification: boolean;\n  };\n  /** Issues found */\n  readonly issues: readonly string[];\n}\n\n/**\n * Bilingual label format (Korean | English)\n */\nexport interface BilingualLabel {\n  /** Korean text */\n  readonly korean: string;\n  /** English text */\n  readonly english: string;\n  /** Formatted label string (Korean | English) */\n  readonly label: string;\n}\n\n/**\n * Helper function to create bilingual labels\n */\nexport const createBilingualLabel = (\n  korean: string,\n  english: string\n): BilingualLabel => ({\n  korean,\n  english,\n  label: `${korean} | ${english}`,\n});\n"],"mappings":";;;;AAkSA,IAAa,wBACX,QACA,aACoB;CACpB;CACA;CACA,OAAO,GAAG,OAAO,KAAK;CACvB"}

package/lib/types/HtmlOverlayTypes.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Type definitions for Three.js Html overlay positioning system
+ *
+ * Provides type-safe interfaces for Html overlays from @react-three/drei
+ * with Korean theming and cyberpunk styling.
+ *
+ * @module types/HtmlOverlayTypes
+ * @category Type Definitions
+ * @korean HTML오버레이타입
+ */
+import type { ZIndexValue } from "./LayoutTypes";
+/**
+ * Html overlay layer categories for z-index management
+ * Maps to Z_INDEX hierarchy in LayoutTypes
+ *
+ * @category Html Overlay Types
+ * @korean 오버레이계층
+ */
+export type HtmlOverlayLayer = "background" | "arena" | "players" | "effects" | "hud" | "mobile-controls" | "modal" | "tooltip" | "debug";
+/**
+ * Screen bounds for position calculations
+ * Used to prevent Html overlays from clipping at screen edges
+ *
+ * @category Html Overlay Types
+ * @korean 화면경계
+ */
+export interface ScreenBounds {
+    /** Screen width in pixels */
+    readonly width: number;
+    /** Screen height in pixels */
+    readonly height: number;
+    /** Safe area insets (for mobile notches) */
+    readonly safeArea?: {
+        readonly top: number;
+        readonly right: number;
+        readonly bottom: number;
+        readonly left: number;
+    };
+}
+/**
+ * Element bounds for positioning calculations
+ * Represents the size and position of an Html overlay element
+ *
+ * @category Html Overlay Types
+ * @korean 요소경계
+ */
+export interface ElementBounds {
+    /** Element width in pixels */
+    readonly width: number;
+    /** Element height in pixels */
+    readonly height: number;
+    /** Optional margin around element */
+    readonly margin?: number;
+}
+/**
+ * Safe position result after bounds checking
+ * Ensures Html overlay stays within screen bounds
+ *
+ * @category Html Overlay Types
+ * @korean 안전위치
+ */
+export interface SafePosition {
+    /** X coordinate in pixels */
+    readonly x: number;
+    /** Y coordinate in pixels */
+    readonly y: number;
+    /** Whether position was clamped to screen bounds */
+    readonly wasClamped: boolean;
+}
+/**
+ * Html overlay styling configuration
+ * Standardized styles for Korean-themed Html overlays
+ *
+ * @category Html Overlay Types
+ * @korean 오버레이스타일
+ */
+export interface HtmlOverlayStyle {
+    /** Z-index for layering */
+    readonly zIndex: ZIndexValue;
+    /** Pointer events setting ('none' | 'all' | 'auto') */
+    readonly pointerEvents: "none" | "all" | "auto";
+    /** Distance factor for Html scaling (default: 10) */
+    readonly distanceFactor?: number;
+    /** Whether to center the Html overlay */
+    readonly center?: boolean;
+    /** Whether to occlude behind 3D objects */
+    readonly occlude?: boolean;
+    /** Transform for positioning (translate, rotate, etc.) */
+    readonly transform?: string;
+}
+/**
+ * Korean text measurement result
+ * Used for calculating text bounds before rendering
+ *
+ * @category Html Overlay Types
+ * @korean 텍스트측정
+ */
+export interface TextMeasurement {
+    /** Total width in pixels */
+    readonly width: number;
+    /** Total height in pixels (including line-height) */
+    readonly height: number;
+    /** Korean text width */
+    readonly koreanWidth: number;
+    /** English text width */
+    readonly englishWidth: number;
+}
+/**
+ * Html overlay positioning options
+ * Complete configuration for Html overlay placement
+ *
+ * @category Html Overlay Types
+ * @korean 오버레이위치설정
+ */
+export interface HtmlOverlayPositionOptions {
+    /** 3D position [x, y, z] */
+    readonly position: [number, number, number];
+    /** Layer for z-index calculation */
+    readonly layer: HtmlOverlayLayer;
+    /** Screen bounds for clipping prevention */
+    readonly screenBounds?: ScreenBounds;
+    /** Element bounds for position calculation */
+    readonly elementBounds?: ElementBounds;
+    /** Whether on mobile device */
+    readonly isMobile?: boolean;
+    /** Additional z-index offset */
+    readonly zIndexOffset?: number;
+}
+/**
+ * Html overlay configuration result
+ * Complete styling and positioning for Html overlay
+ *
+ * @category Html Overlay Types
+ * @korean 오버레이설정결과
+ */
+export interface HtmlOverlayConfig {
+    /** Calculated safe position */
+    readonly position: SafePosition;
+    /** Styling configuration */
+    readonly style: HtmlOverlayStyle;
+    /** Original 3D position [x, y, z] */
+    readonly position3D: [number, number, number];
+}
+/**
+ * Html overlay performance options
+ * Settings for optimizing Html overlay rendering
+ *
+ * @category Html Overlay Types
+ * @korean 오버레이성능설정
+ */
+export interface HtmlOverlayPerformanceOptions {
+    /** Whether to use React.memo for component */
+    readonly useMemo?: boolean;
+    /** Whether to render only when visible */
+    readonly renderWhenVisible?: boolean;
+    /** Distance threshold for culling (meters) */
+    readonly cullDistance?: number;
+    /** Whether to use GPU acceleration */
+    readonly useGPUAcceleration?: boolean;
+}
+//# sourceMappingURL=HtmlOverlayTypes.d.ts.map

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

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