@nindroidsystems/pluginator 2.3.0

package/dist/ui/state/key-matrix.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Key Validity Matrix
+ *
+ * Defines which keys are valid in each UI state.
+ * This is the core configuration for input validation.
+ */
+import type { UIState } from './types.js';
+/**
+ * Key validity sets for each UI state.
+ *
+ * Keys are identified by their normalized form:
+ * - Regular characters: 'a', 'b', '/', ':'
+ * - Special keys: 'escape', 'enter', 'up', 'down', 'left', 'right', 'tab', 'space'
+ * - Modifier combinations: 'ctrl+c', 'ctrl+d', 'shift+tab'
+ * - The special value '*' in command-palette means "any printable character"
+ */
+export declare const KEY_VALIDITY: Record<UIState, Set<string>>;
+/**
+ * Check if a key is valid in the given state
+ *
+ * @param keyId - The normalized key identifier
+ * @param state - The current UI state
+ * @returns Whether the key is valid
+ */
+export declare function isKeyValidForState(keyId: string, state: UIState): boolean;
+/**
+ * Get all valid keys for a given state
+ */
+export declare function getValidKeysForState(state: UIState): Set<string>;
+/**
+ * Get a human-readable description of valid keys for a state
+ */
+export declare function describeValidKeys(state: UIState): string;
+//# sourceMappingURL=key-matrix.d.ts.map

package/dist/ui/state/key-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-matrix.d.ts","sourceRoot":"","sources":["../../../src/ui/state/key-matrix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CA2SrD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAWzE;AAcD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiCxD"}

package/dist/ui/state/key-utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Key Utilities
+ *
+ * Utilities for working with keyboard input and key identification.
+ */
+/**
+ * Key object from Ink's useInput hook
+ */
+export interface Key {
+    upArrow: boolean;
+    downArrow: boolean;
+    leftArrow: boolean;
+    rightArrow: boolean;
+    pageDown: boolean;
+    pageUp: boolean;
+    return: boolean;
+    escape: boolean;
+    ctrl: boolean;
+    shift: boolean;
+    tab: boolean;
+    backspace: boolean;
+    delete: boolean;
+    meta: boolean;
+}
+/**
+ * Normalize a key input to a standard identifier string.
+ *
+ * This converts the input character and key modifiers into a
+ * consistent string format for validation.
+ *
+ * @param input - The input character from useInput
+ * @param key - The key object from useInput
+ * @returns Normalized key identifier
+ *
+ * @example
+ * getKeyIdentifier('c', { ctrl: true, ... }) // 'ctrl+c'
+ * getKeyIdentifier('', { escape: true, ... }) // 'escape'
+ * getKeyIdentifier('', { return: true, ... }) // 'enter'
+ * getKeyIdentifier('', { upArrow: true, ... }) // 'up'
+ * getKeyIdentifier('', { tab: true, shift: true, ... }) // 'shift+tab'
+ * getKeyIdentifier('a', { ... }) // 'a'
+ */
+export declare function getKeyIdentifier(input: string, key: Key): string;
+/**
+ * Check if a key is a modifier key (doesn't produce input on its own)
+ */
+export declare function isModifierKey(key: Key): boolean;
+/**
+ * Check if input is a printable character
+ *
+ * @param input - The input string from useInput
+ * @returns Whether the input is a printable character
+ */
+export declare function isPrintableChar(input: string): boolean;
+/**
+ * Check if the key combination is the quit shortcut (Ctrl+C)
+ */
+export declare function isQuitShortcut(input: string, key: Key): boolean;
+/**
+ * Check if the key is a navigation key
+ */
+export declare function isNavigationKey(keyId: string): boolean;
+/**
+ * Check if the key is an action key
+ */
+export declare function isActionKey(keyId: string): boolean;
+/**
+ * Check if the key is a number key (1-9)
+ */
+export declare function isNumberKey(input: string): boolean;
+/**
+ * Check if the key is a global shortcut
+ */
+export declare function isGlobalShortcut(keyId: string): boolean;
+/**
+ * Get a human-readable description of a key
+ */
+export declare function describeKey(keyId: string): string;
+/**
+ * Format a key identifier for display (with proper styling hints)
+ */
+export declare function formatKeyForDisplay(keyId: string): string;
+//# sourceMappingURL=key-utils.d.ts.map

package/dist/ui/state/key-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-utils.d.ts","sourceRoot":"","sources":["../../../src/ui/state/key-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAiChE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYzD"}

package/dist/ui/state/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * UI State Types
+ *
+ * Defines the types for the UI state machine used in input validation
+ * and state management across the application.
+ */
+/**
+ * All possible UI states the application can be in.
+ * These are mutually exclusive - only one can be active at a time.
+ */
+export type UIState = 'idle' | 'command-palette' | 'confirm-dialog' | 'selection-dialog' | 'progress' | 'help' | 'config' | 'setup' | 'batch-menu' | 'login-dialog' | 'account-view' | 'first-launch' | 'rollback-dialog';
+/**
+ * All possible tab IDs in the application
+ */
+export type TabId = 'home' | 'servers' | 'plugins' | 'updates' | 'logs' | 'stats' | 'health' | 'recommendations' | 'performance';
+/**
+ * Loading states for various operations
+ */
+export interface LoadingStates {
+    sync: boolean;
+    backup: boolean;
+    download: boolean;
+    updates: boolean;
+    servers: boolean;
+    plugins: boolean;
+    logs: boolean;
+}
+/**
+ * Context provided with the current UI state
+ */
+export interface StateContext {
+    /** Current UI state */
+    state: UIState;
+    /** Active tab ID (when in idle state) */
+    activeTab: TabId;
+    /** Loading states for various operations */
+    loading: LoadingStates;
+    /** Whether the current operation can be cancelled (for progress state) */
+    canCancel?: boolean;
+    /** Whether network is online */
+    online: boolean;
+    /** Whether debug mode is enabled */
+    debugEnabled: boolean;
+}
+/**
+ * Input to derive the current UI state
+ */
+export interface UIStateInput {
+    showHelp: boolean;
+    showConfig: boolean;
+    showCommandPalette: boolean;
+    showConfirmDialog: boolean;
+    workflowType: 'sync' | 'backup' | 'download' | 'migrate' | null;
+    showBatchMenu: boolean;
+    showSetup: boolean;
+    downloadStep: 'config-prompt' | 'type' | 'version' | 'destination' | 'progress';
+    syncLoading: boolean;
+    backupLoading: boolean;
+    downloadLoading: boolean;
+    updatesLoading: boolean;
+    serversLoading: boolean;
+    pluginsLoading: boolean;
+    logsLoading: boolean;
+    activeTab: TabId;
+    online: boolean;
+    debugEnabled: boolean;
+    canCancel?: boolean;
+    showFirstLaunchPrompt?: boolean;
+    showLoginDialog?: boolean;
+    showAccountView?: boolean;
+    showRollbackDialog?: boolean;
+}
+/**
+ * Derive the current UI state from component state
+ *
+ * Priority order (first match wins):
+ * 1. Progress states (loading workflows)
+ * 2. Dialog states (setup, batch, confirm, selection)
+ * 3. Overlay states (help, config, command palette)
+ * 4. Idle state
+ */
+export declare function deriveUIState(input: UIStateInput): StateContext;
+/**
+ * Check if any workflow is currently loading
+ */
+export declare function isAnyWorkflowLoading(loading: LoadingStates): boolean;
+/**
+ * Check if any data loading is in progress
+ */
+export declare function isAnyDataLoading(loading: LoadingStates): boolean;
+/**
+ * Check if the UI is in a state that should block most input
+ */
+export declare function isInputBlocked(state: UIState): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ui/state/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,MAAM,GACN,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,UAAU,GACV,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,GAEZ,cAAc,GACd,cAAc,GACd,cAAc,GAEd,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAEjI;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,SAAS,EAAE,KAAK,CAAC;IACjB,4CAA4C;IAC5C,OAAO,EAAE,aAAa,CAAC;IACvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAwJ/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD"}

package/dist/ui/themes/color-blindness.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Color Blindness Simulation & Accessibility
+ *
+ * Functions for simulating color vision deficiencies and
+ * creating accessible color palettes.
+ *
+ * @since v1.57.3
+ */
+import type { ExtendedTheme, SemanticColors } from './theme-types.js';
+/**
+ * Color vision deficiency types
+ */
+export type ColorBlindnessType = 'normal' | 'deuteranopia' | 'protanopia' | 'tritanopia' | 'achromatopsia';
+/**
+ * Apply color blindness simulation to a single color
+ */
+export declare function simulateColorBlindness(hex: string, type: ColorBlindnessType): string;
+/**
+ * Simulate entire color palette for color blindness
+ */
+export declare function simulatePaletteColorBlindness(colors: SemanticColors, type: ColorBlindnessType): SemanticColors;
+/**
+ * Check if two colors are distinguishable for a given color blindness type
+ */
+export declare function areColorsDistinguishable(hex1: string, hex2: string, type: ColorBlindnessType, threshold?: number): boolean;
+/**
+ * Get color-blind safe alternatives for common colors
+ */
+export declare function getColorBlindSafeColor(purpose: 'success' | 'warning' | 'error' | 'info', isDark?: boolean): string;
+/**
+ * Create a Deuteranopia-friendly theme
+ */
+export declare function createDeuteranopiaTheme(): ExtendedTheme;
+/**
+ * Create a Protanopia-friendly theme
+ */
+export declare function createProtanopiaTheme(): ExtendedTheme;
+/**
+ * Create a Tritanopia-friendly theme
+ */
+export declare function createTritanopiaTheme(): ExtendedTheme;
+/**
+ * Accessibility preference options
+ */
+export interface AccessibilityPreferences {
+    /** Reduce motion/animations */
+    reduceMotion: boolean;
+    /** Color blindness type to optimize for */
+    colorBlindnessType: ColorBlindnessType;
+    /** High contrast mode */
+    highContrast: boolean;
+    /** Increase text size */
+    largerText: boolean;
+}
+/**
+ * Get default accessibility preferences
+ */
+export declare function getDefaultAccessibilityPreferences(): AccessibilityPreferences;
+/**
+ * Get all color blindness types with descriptions
+ */
+export declare function getColorBlindnessTypes(): Array<{
+    type: ColorBlindnessType;
+    name: string;
+    description: string;
+    prevalence: string;
+}>;
+/**
+ * Check if a theme is accessible for a specific color blindness type
+ */
+export declare function isThemeAccessibleForColorBlindness(colors: SemanticColors, type: ColorBlindnessType): {
+    isAccessible: boolean;
+    issues: string[];
+};
+//# sourceMappingURL=color-blindness.d.ts.map

package/dist/ui/themes/color-blindness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-blindness.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/color-blindness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,eAAe,CAAC;AAkCpB;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAoBpF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA4C9G;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,SAAK,GAAG,OAAO,CAWtH;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,UAAO,GAAG,MAAM,CAW/G;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CA+CvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CA+CrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CA+CrD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,yBAAyB;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,wBAAwB,CAO7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,KAAK,CAAC;IAC9C,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAiCD;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,GAAG;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8BhJ"}

package/dist/ui/themes/color-utils.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Color Utilities for Theme Derivation
+ *
+ * Functions for manipulating colors and generating palettes.
+ *
+ * @since v1.57.2
+ */
+import type { ExtendedTheme, SemanticColors } from './theme-types.js';
+/**
+ * RGB color representation
+ */
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * HSL color representation
+ */
+export interface HSL {
+    h: number;
+    s: number;
+    l: number;
+}
+/**
+ * Parse hex color to RGB
+ */
+export declare function hexToRgb(hex: string): RGB;
+/**
+ * Convert RGB to hex
+ */
+export declare function rgbToHex(rgb: RGB): string;
+/**
+ * Convert RGB to HSL
+ */
+export declare function rgbToHsl(rgb: RGB): HSL;
+/**
+ * Convert HSL to RGB
+ */
+export declare function hslToRgb(hsl: HSL): RGB;
+/**
+ * Convert hex to HSL
+ */
+export declare function hexToHsl(hex: string): HSL;
+/**
+ * Convert HSL to hex
+ */
+export declare function hslToHex(hsl: HSL): string;
+/**
+ * Lighten a color
+ */
+export declare function lighten(hex: string, amount: number): string;
+/**
+ * Darken a color
+ */
+export declare function darken(hex: string, amount: number): string;
+/**
+ * Saturate a color
+ */
+export declare function saturate(hex: string, amount: number): string;
+/**
+ * Desaturate a color
+ */
+export declare function desaturate(hex: string, amount: number): string;
+/**
+ * Adjust hue of a color
+ */
+export declare function adjustHue(hex: string, degrees: number): string;
+/**
+ * Get complementary color (opposite on color wheel)
+ */
+export declare function complementary(hex: string): string;
+/**
+ * Get triadic colors (120° apart)
+ */
+export declare function triadic(hex: string): [string, string];
+/**
+ * Get analogous colors (30° apart)
+ */
+export declare function analogous(hex: string): [string, string];
+/**
+ * Get split-complementary colors (150° and 210°)
+ */
+export declare function splitComplementary(hex: string): [string, string];
+/**
+ * Mix two colors
+ */
+export declare function mixColors(hex1: string, hex2: string, weight?: number): string;
+/**
+ * Derive a full semantic color palette from a primary color
+ */
+export declare function deriveFromPrimary(primaryHex: string, isDark?: boolean): SemanticColors;
+/**
+ * Get perceived brightness of a color (0-255)
+ */
+export declare function getBrightness(hex: string): number;
+/**
+ * Check if a color is "dark"
+ */
+export declare function isDarkColor(hex: string): boolean;
+/**
+ * Get relative luminance for WCAG calculations
+ */
+export declare function getRelativeLuminance(hex: string): number;
+/**
+ * Calculate contrast ratio between two colors
+ */
+export declare function getContrastRatio(hex1: string, hex2: string): number;
+/**
+ * Generate a color scale from a base color
+ */
+export declare function generateColorScale(hex: string, steps?: number): string[];
+/**
+ * Export a theme to JSON string
+ */
+export declare function exportThemeToJson(theme: ExtendedTheme): string;
+/**
+ * Import a theme from JSON string
+ */
+export declare function importThemeFromJson(json: string): ExtendedTheme | null;
+/**
+ * Duplicate a theme with a new name
+ */
+export declare function duplicateTheme(theme: ExtendedTheme, newName: string): ExtendedTheme;
+//# sourceMappingURL=color-utils.d.ts.map

package/dist/ui/themes/color-utils.d.ts.map

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

package/dist/ui/themes/contrast-checker.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Contrast Checker Utility
+ *
+ * WCAG-compliant contrast ratio checking and accessibility validation.
+ *
+ * @since v1.57.2
+ */
+import type { SemanticColors } from './theme-types.js';
+/**
+ * WCAG compliance level
+ */
+export type WCAGLevel = 'AAA' | 'AA' | 'fail';
+/**
+ * WCAG compliance thresholds
+ */
+export declare const WCAG_THRESHOLDS: {
+    readonly AAA_NORMAL: 7;
+    readonly AA_NORMAL: 4.5;
+    readonly AAA_LARGE: 4.5;
+    readonly AA_LARGE: 3;
+    readonly AA_UI: 3;
+};
+/**
+ * Contrast check result
+ */
+export interface ContrastResult {
+    /** Contrast ratio (1.0 to 21.0) */
+    ratio: number;
+    /** WCAG level for normal text */
+    normalText: WCAGLevel;
+    /** WCAG level for large text */
+    largeText: WCAGLevel;
+    /** WCAG level for UI components */
+    uiComponents: WCAGLevel;
+    /** Whether the combination is accessible */
+    isAccessible: boolean;
+    /** Human-readable summary */
+    summary: string;
+}
+/**
+ * Check contrast between two colors
+ */
+export declare function checkContrast(foreground: string, background: string): ContrastResult;
+/**
+ * Theme contrast check result for a specific pair
+ */
+export interface ThemeContrastPair {
+    name: string;
+    foreground: string;
+    background: string;
+    result: ContrastResult;
+}
+/**
+ * Full theme accessibility report
+ */
+export interface ThemeAccessibilityReport {
+    /** Overall accessibility score (0-100) */
+    score: number;
+    /** All contrast checks */
+    pairs: ThemeContrastPair[];
+    /** Pairs that fail WCAG AA */
+    failures: ThemeContrastPair[];
+    /** Pairs that pass AA but not AAA */
+    warnings: ThemeContrastPair[];
+    /** Summary text */
+    summary: string;
+    /** Whether theme passes minimum requirements */
+    passesMinimum: boolean;
+}
+/**
+ * Check accessibility of a complete theme
+ */
+export declare function checkThemeAccessibility(colors: SemanticColors): ThemeAccessibilityReport;
+/**
+ * Get a text representation of contrast ratio
+ */
+export declare function formatContrastRatio(ratio: number): string;
+/**
+ * Get a visual progress bar for contrast
+ */
+export declare function getContrastProgressBar(ratio: number, width?: number): string;
+/**
+ * Suggest improvements for a failing contrast
+ */
+export declare function suggestContrastFix(foreground: string, background: string, targetRatio?: number): {
+    foreground: string;
+    background: string;
+} | null;
+/**
+ * Check if a color pair is considered "high contrast"
+ */
+export declare function isHighContrast(foreground: string, background: string): boolean;
+/**
+ * Get color pair issues for terminal display
+ */
+export declare function getAccessibilityIssues(colors: SemanticColors): string[];
+//# sourceMappingURL=contrast-checker.d.ts.map

package/dist/ui/themes/contrast-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-checker.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/contrast-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,UAAU,EAAE,SAAS,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,mCAAmC;IACnC,YAAY,EAAE,SAAS,CAAC;IACxB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CA8BpF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,wBAAwB,CA8HxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAMxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAE,MAAkC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgC7K;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAavE"}

package/dist/ui/themes/default-themes.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Default Bundled Themes
+ *
+ * Built-in themes available out of the box.
+ *
+ * @since v1.57.0
+ */
+import type { Tier } from '../../core/types/auth.js';
+import type { ExtendedTheme } from './theme-types.js';
+/**
+ * Theme list item for gallery display
+ */
+export interface ThemeListItem {
+    id: string;
+    name: string;
+    tier: Tier;
+    type: string;
+    isLocked: boolean;
+    isActive: boolean;
+}
+/**
+ * Create all default themes
+ */
+export declare function createDefaultThemes(): ExtendedTheme[];
+/**
+ * Get a default theme by ID
+ */
+export declare function getDefaultTheme(id: string): ExtendedTheme | undefined;
+/**
+ * Get theme list items for gallery display
+ */
+export declare function getThemeListItems(userTier: Tier, activeThemeId: string): ThemeListItem[];
+/**
+ * Get theme availability counts by tier
+ */
+export declare function getThemeCounts(userTier: Tier): {
+    available: number;
+    total: number;
+};
+//# sourceMappingURL=default-themes.d.ts.map

package/dist/ui/themes/default-themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-themes.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/default-themes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAgkBD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,EAAE,CAgSrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAUxF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,IAAI,GAAG;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAIA"}

package/dist/ui/themes/gradient-presets.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Gradient Animation Presets
+ *
+ * Defines shimmer effect presets for the GradientText component.
+ * Creates an organic glow/shimmer effect similar to Claude Code's
+ * "thinking" animation - multiple highlight spots that pulse and
+ * fade at random positions for a living, breathing effect.
+ *
+ * @since v1.52.0
+ * @updated v1.52.2 - Changed from rainbow cycling to shimmer effect
+ * @updated v1.52.3 - Enhanced with multi-spot pulse animation and vibrant colors
+ */
+/**
+ * Gradient preset names
+ */
+export type GradientPreset = 'success' | 'welcome' | 'premium' | 'sync' | 'thinking' | 'plus' | 'pro' | 'max';
+/**
+ * Animation speed names
+ */
+export type AnimationSpeed = 'slow' | 'normal' | 'fast';
+/**
+ * Shimmer preset definition - enhanced for multi-spot pulse animation
+ */
+export interface ShimmerPreset {
+    /** Base color for most of the text (vibrant, not muted) */
+    base: string;
+    /** Mid-tone color for fade transitions */
+    mid: string;
+    /** Highlight color for the shimmer peak */
+    highlight: string;
+    /** Width of shimmer spots in characters (2-5) */
+    shimmerWidth: number;
+    /** Maximum simultaneous shimmer spots (default: 2-3) */
+    maxSpots: number;
+}
+/**
+ * Shimmer presets - multi-spot pulse animation with vibrant colors
+ * Creates an organic glow effect like Claude Code's thinking animation
+ *
+ * All colors are vibrant (no dark/muted tones like gray).
+ * The shimmer only makes characters BRIGHTER, never darker.
+ * Base = normal color, mid = same as base, highlight = brightest (white glow)
+ */
+export declare const SHIMMER_PRESETS: Record<GradientPreset, ShimmerPreset>;
+/**
+ * Animation speed in milliseconds per frame
+ */
+export declare const ANIMATION_SPEEDS: Record<AnimationSpeed, number>;
+/**
+ * Default fallback colors when gradient is disabled (free tier)
+ * Using vibrant colors that match the base colors of presets
+ */
+export declare const FALLBACK_COLORS: Record<GradientPreset, string>;
+/**
+ * Get shimmer preset
+ */
+export declare function getShimmerPreset(preset: GradientPreset): ShimmerPreset;
+/**
+ * Get animation speed in ms
+ */
+export declare function getAnimationSpeed(speed: AnimationSpeed): number;
+/**
+ * Get fallback color for a preset
+ */
+export declare function getFallbackColor(preset: GradientPreset): string;
+export declare function getGradientColors(preset: GradientPreset): string[];
+//# sourceMappingURL=gradient-presets.d.ts.map

package/dist/ui/themes/gradient-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-presets.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/gradient-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9G;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,aAAa,CAoEjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAS1D,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE/D;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAGlE"}