@nindroidsystems/pluginator 2.3.0

package/dist/ui/keyboard/macro-types.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Macro Recording Types
+ *
+ * Types for macro recording, playback, and management.
+ *
+ * @since v1.58.2
+ */
+import type { Tier } from '../../core/types/auth.js';
+/**
+ * A recorded macro
+ */
+export interface Macro {
+    /** Unique identifier */
+    id: string;
+    /** User-friendly name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Recorded steps */
+    steps: MacroStep[];
+    /** When the macro was created */
+    createdAt: number;
+    /** When the macro was last modified */
+    updatedAt: number;
+    /** Assigned register slot (q, w, e, r) */
+    register?: string;
+    /** Tags for organization */
+    tags?: string[];
+}
+/**
+ * A step in a macro
+ */
+export interface MacroStep {
+    /** Step type */
+    type: MacroStepType;
+    /** Step data (type-specific) */
+    data: MacroStepData;
+    /** Timestamp relative to start (for timing playback) */
+    timestamp?: number;
+}
+/**
+ * Types of macro steps
+ */
+export type MacroStepType = 'keypress' | 'input' | 'wait' | 'action' | 'assert';
+/**
+ * Union type for step data
+ */
+export type MacroStepData = KeypressData | InputData | WaitData | ActionData | AssertData;
+/**
+ * Keypress step data
+ */
+export interface KeypressData {
+    type: 'keypress';
+    /** Key that was pressed */
+    key: string;
+    /** Modifier keys held */
+    modifiers?: ('ctrl' | 'alt' | 'shift' | 'meta')[];
+}
+/**
+ * Text input step data
+ */
+export interface InputData {
+    type: 'input';
+    /** Input value */
+    value: string;
+    /** Field identifier (optional) */
+    field?: string;
+}
+/**
+ * Wait step data
+ */
+export interface WaitData {
+    type: 'wait';
+    /** Duration in milliseconds */
+    duration: number;
+    /** Optional condition to wait for */
+    condition?: string;
+}
+/**
+ * Action step data
+ */
+export interface ActionData {
+    type: 'action';
+    /** Action identifier (e.g., 'sync:all', 'update:check') */
+    action: string;
+    /** Optional parameters */
+    params?: Record<string, unknown>;
+}
+/**
+ * Assertion step data
+ */
+export interface AssertData {
+    type: 'assert';
+    /** Condition to check */
+    condition: string;
+    /** Expected value */
+    expected: unknown;
+    /** What to do on failure */
+    failAction?: 'stop' | 'continue' | 'skip';
+}
+/**
+ * Macro recorder state
+ */
+export interface MacroRecorderState {
+    /** Whether recording is active */
+    isRecording: boolean;
+    /** Current register being recorded to */
+    currentRegister: string | null;
+    /** Steps recorded so far */
+    steps: MacroStep[];
+    /** When recording started */
+    startTime: number | null;
+    /** Error if any */
+    error: string | null;
+}
+/**
+ * Macro playback state
+ */
+export interface MacroPlaybackState {
+    /** Whether playback is active */
+    isPlaying: boolean;
+    /** Macro being played */
+    currentMacro: Macro | null;
+    /** Current step index */
+    currentStep: number;
+    /** Total steps */
+    totalSteps: number;
+    /** Remaining loop iterations */
+    remainingLoops: number;
+    /** Whether paused */
+    isPaused: boolean;
+    /** Playback speed (1.0 = normal) */
+    speed: number;
+    /** Error if any */
+    error: string | null;
+}
+/**
+ * Macro library state
+ */
+export interface MacroLibrary {
+    /** All saved macros */
+    macros: Macro[];
+    /** Quick-access registers (q, w, e, r) */
+    registers: Record<string, Macro | null>;
+    /** Last played macro ID */
+    lastPlayedId: string | null;
+}
+/**
+ * Macro recorder configuration
+ */
+export interface MacroRecorderConfig {
+    /** Whether recording is enabled */
+    enabled: boolean;
+    /** User's tier for feature gating */
+    userTier: Tier;
+    /** Maximum steps per macro */
+    maxSteps: number;
+    /** Whether to record timing */
+    recordTiming: boolean;
+    /** Default playback speed */
+    defaultSpeed: number;
+    /** Available registers */
+    registers: string[];
+}
+/**
+ * Default macro recorder configuration
+ */
+export declare const DEFAULT_MACRO_CONFIG: MacroRecorderConfig;
+/**
+ * Macro file format for import/export
+ */
+export interface MacroExportFormat {
+    version: 1;
+    exportedAt: number;
+    macros: Macro[];
+}
+/**
+ * Create an empty macro
+ */
+export declare function createEmptyMacro(name: string, register?: string): Macro;
+/**
+ * Create initial recorder state
+ */
+export declare function createInitialRecorderState(): MacroRecorderState;
+/**
+ * Create initial playback state
+ */
+export declare function createInitialPlaybackState(): MacroPlaybackState;
+/**
+ * Create initial library
+ */
+export declare function createInitialLibrary(): MacroLibrary;
+/**
+ * Format a step for display
+ */
+export declare function formatStep(step: MacroStep): string;
+/**
+ * Calculate total duration of a macro
+ */
+export declare function calculateMacroDuration(macro: Macro): number;
+/**
+ * Validate a macro
+ */
+export declare function validateMacro(macro: Macro): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=macro-types.d.ts.map

package/dist/ui/keyboard/macro-types.d.ts.map

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

package/dist/ui/keyboard/quick-actions-service.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Quick Actions Service
+ *
+ * Manages quick actions, bookmarks, recent items, and fuzzy search.
+ *
+ * @since v1.58.4
+ */
+import type { Bookmark, QuickActionCategory, QuickActionItem, QuickActionsConfig, QuickActionsState } from './quick-actions-types.js';
+/**
+ * Quick Actions Service
+ */
+export declare class QuickActionsService {
+    private config;
+    private state;
+    private bookmarks;
+    private recentItems;
+    private itemProviders;
+    private onChange?;
+    constructor(config?: Partial<QuickActionsConfig>, onChange?: (state: QuickActionsState) => void);
+    /**
+     * Register an item provider for a category
+     */
+    registerProvider(category: QuickActionCategory, provider: () => QuickActionItem[]): void;
+    /**
+     * Open the quick actions panel
+     */
+    open(): void;
+    /**
+     * Close the quick actions panel
+     */
+    close(): void;
+    /**
+     * Update the search query
+     */
+    setQuery(query: string): void;
+    /**
+     * Navigate selection up
+     */
+    selectPrevious(): void;
+    /**
+     * Navigate selection down
+     */
+    selectNext(): void;
+    /**
+     * Get currently selected item
+     */
+    getSelectedItem(): QuickActionItem | null;
+    /**
+     * Execute the selected item
+     */
+    executeSelected(): QuickActionItem | null;
+    /**
+     * Execute item by index
+     */
+    executeByIndex(index: number): QuickActionItem | null;
+    /**
+     * Track a recent item
+     */
+    trackRecent(item: QuickActionItem): void;
+    /**
+     * Get recent items
+     */
+    getRecent(): QuickActionItem[];
+    /**
+     * Clear recent items
+     */
+    clearRecent(): void;
+    /**
+     * Add a bookmark
+     */
+    addBookmark(type: Bookmark['type'], itemId: string, label: string, shortcut?: number): Bookmark | null;
+    /**
+     * Remove a bookmark
+     */
+    removeBookmark(id: string): boolean;
+    /**
+     * Toggle bookmark
+     */
+    toggleBookmark(type: Bookmark['type'], itemId: string, label: string): boolean;
+    /**
+     * Set bookmark shortcut
+     */
+    setBookmarkShortcut(id: string, shortcut: number | undefined): boolean;
+    /**
+     * Get bookmark by shortcut
+     */
+    getBookmarkByShortcut(shortcut: number): Bookmark | null;
+    /**
+     * Get all bookmarks
+     */
+    getBookmarks(): Bookmark[];
+    /**
+     * Check if item is bookmarked
+     */
+    isBookmarked(type: Bookmark['type'], itemId: string): boolean;
+    /**
+     * Increment bookmark usage count
+     */
+    incrementBookmarkUsage(id: string): void;
+    /**
+     * Update results based on query
+     */
+    private updateResults;
+    /**
+     * Get state
+     */
+    getState(): QuickActionsState;
+    /**
+     * Check tier access
+     */
+    private isTierAllowed;
+    /**
+     * Notify state change
+     */
+    private notify;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<QuickActionsConfig>): void;
+    /**
+     * Export bookmarks
+     */
+    exportBookmarks(): Bookmark[];
+    /**
+     * Import bookmarks
+     */
+    importBookmarks(bookmarks: Bookmark[], overwrite?: boolean): number;
+}
+/**
+ * Create a quick actions service instance
+ */
+export declare function createQuickActionsService(config?: Partial<QuickActionsConfig>, onChange?: (state: QuickActionsState) => void): QuickActionsService;
+//# sourceMappingURL=quick-actions-service.d.ts.map

package/dist/ui/keyboard/quick-actions-service.d.ts.map

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

package/dist/ui/keyboard/quick-actions-types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Quick Actions Types
+ *
+ * Types for quick actions, bookmarks, and fuzzy finder.
+ *
+ * @since v1.58.4
+ */
+import type { Tier } from '../../core/types/auth.js';
+/**
+ * A quick action item
+ */
+export interface QuickActionItem {
+    /** Unique identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Secondary text */
+    description?: string;
+    /** Icon or emoji */
+    icon?: string;
+    /** Category for grouping */
+    category: QuickActionCategory;
+    /** Action to execute */
+    action: string;
+    /** Action parameters */
+    params?: Record<string, unknown>;
+    /** Keyboard shortcut (if any) */
+    shortcut?: string;
+    /** Minimum tier required */
+    tier?: Tier;
+    /** Match score (for fuzzy search results) */
+    score?: number;
+    /** Whether this is a recent item */
+    isRecent?: boolean;
+    /** Whether this is a favorite */
+    isFavorite?: boolean;
+}
+/**
+ * Quick action category
+ */
+export type QuickActionCategory = 'plugin' | 'server' | 'action' | 'view' | 'recent' | 'favorite' | 'registry';
+/**
+ * Bookmark/favorite
+ */
+export interface Bookmark {
+    /** Unique identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Type of bookmarked item */
+    type: 'plugin' | 'server' | 'view' | 'action';
+    /** Item identifier */
+    itemId: string;
+    /** Optional keyboard shortcut (1-9) */
+    shortcut?: number;
+    /** When created */
+    createdAt: number;
+    /** Usage count */
+    usageCount: number;
+    /** Tags for organization */
+    tags?: string[];
+}
+/**
+ * Quick actions configuration
+ */
+export interface QuickActionsConfig {
+    /** Whether quick actions are enabled */
+    enabled: boolean;
+    /** User's tier for feature gating */
+    userTier: Tier;
+    /** Maximum recent items to track */
+    maxRecent: number;
+    /** Maximum bookmarks */
+    maxBookmarks: number;
+    /** Whether to show recent items in quick open */
+    showRecent: boolean;
+    /** Whether to show favorites first */
+    prioritizeFavorites: boolean;
+}
+/**
+ * Quick actions state
+ */
+export interface QuickActionsState {
+    /** Current query */
+    query: string;
+    /** Filtered results */
+    results: QuickActionItem[];
+    /** Selected index */
+    selectedIndex: number;
+    /** Whether open */
+    isOpen: boolean;
+    /** Loading state */
+    isLoading: boolean;
+}
+/**
+ * Default quick actions configuration
+ */
+export declare const DEFAULT_QUICK_ACTIONS_CONFIG: QuickActionsConfig;
+/**
+ * Create initial quick actions state
+ */
+export declare function createInitialQuickActionsState(): QuickActionsState;
+/**
+ * Create a quick action item
+ */
+export declare function createQuickActionItem(id: string, label: string, category: QuickActionCategory, action: string, options?: Partial<QuickActionItem>): QuickActionItem;
+/**
+ * Create a bookmark
+ */
+export declare function createBookmark(type: Bookmark['type'], itemId: string, label: string, shortcut?: number): Bookmark;
+/**
+ * Fuzzy match score calculation
+ */
+export declare function calculateFuzzyScore(query: string, target: string): number;
+/**
+ * Sort items by score
+ */
+export declare function sortByScore(items: QuickActionItem[]): QuickActionItem[];
+/**
+ * Group items by category
+ */
+export declare function groupByCategory(items: QuickActionItem[]): Map<QuickActionCategory, QuickActionItem[]>;
+/**
+ * Get category display name
+ */
+export declare function getCategoryDisplayName(category: QuickActionCategory): string;
+/**
+ * Get category icon
+ */
+export declare function getCategoryIcon(category: QuickActionCategory): string;
+//# sourceMappingURL=quick-actions-types.d.ts.map

package/dist/ui/keyboard/quick-actions-types.d.ts.map

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

package/dist/ui/keyboard/useChordMode.d.ts

@@ -0,0 +1,70 @@
+/**
+ * useChordMode Hook
+ *
+ * React hook for integrating chord keybindings into components.
+ *
+ * @since v1.58.1
+ */
+import type { Tier } from '../../core/types/auth.js';
+import type { ChordConfig, ChordDefinition, ChordHint, ChordResult, ChordState } from './chord-types.js';
+/**
+ * Hook configuration
+ */
+export interface UseChordModeConfig {
+    /** Enable chord mode */
+    enabled?: boolean;
+    /** User's tier for feature gating */
+    userTier?: Tier;
+    /** Chord configuration overrides */
+    config?: Partial<ChordConfig>;
+    /** Custom chords to add */
+    customChords?: ChordDefinition[];
+    /** Replace default chords entirely */
+    replaceDefaults?: boolean;
+    /** Callback when a chord completes */
+    onChordComplete?: (action: string, chord: ChordDefinition) => void;
+    /** Callback when chord state changes */
+    onStateChange?: (state: ChordState) => void;
+}
+/**
+ * Hook return type
+ */
+export interface UseChordModeReturn {
+    /** Current chord state */
+    state: ChordState;
+    /** Whether chord mode is enabled */
+    enabled: boolean;
+    /** Whether a chord is active */
+    isActive: boolean;
+    /** Whether the which-key popup should show */
+    showWhichKey: boolean;
+    /** Current hints */
+    hints: ChordHint[];
+    /** Pending keys in the current chord */
+    pending: string[];
+    /** Process a key event */
+    processKey: (key: string) => ChordResult;
+    /** Cancel the current chord */
+    cancel: () => void;
+    /** Check if a key is the leader */
+    isLeader: (key: string) => boolean;
+    /** Register a custom chord */
+    registerChord: (chord: ChordDefinition) => void;
+    /** Unregister a chord */
+    unregisterChord: (id: string) => boolean;
+    /** Get all registered chords */
+    getChords: () => ChordDefinition[];
+    /** Get chords by category */
+    getChordsByCategory: (category: string) => ChordDefinition[];
+    /** Toggle chord mode */
+    toggle: () => boolean;
+    /** Enable chord mode */
+    enable: () => void;
+    /** Disable chord mode */
+    disable: () => void;
+}
+/**
+ * useChordMode hook
+ */
+export declare function useChordMode(config?: UseChordModeConfig): UseChordModeReturn;
+//# sourceMappingURL=useChordMode.d.ts.map

package/dist/ui/keyboard/useChordMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChordMode.d.ts","sourceRoot":"","sources":["../../../src/ui/keyboard/useChordMode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAIzG;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACnE,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0BAA0B;IAC1B,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC;IACzC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mCAAmC;IACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,8BAA8B;IAC9B,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,yBAAyB;IACzB,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,gCAAgC;IAChC,SAAS,EAAE,MAAM,eAAe,EAAE,CAAC;IACnC,6BAA6B;IAC7B,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;IAC7D,wBAAwB;IACxB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,wBAAwB;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,kBAAkB,CAuIhF"}

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

@@ -0,0 +1,11 @@
+/**
+ * UI State Module
+ *
+ * Provides the state machine and input validation infrastructure
+ * for consistent keyboard handling across the application.
+ */
+export { deriveUIState, isAnyDataLoading, isAnyWorkflowLoading, isInputBlocked, type LoadingStates, type StateContext, type TabId, type UIState, type UIStateInput, } from './types.js';
+export { describeValidKeys, getValidKeysForState, isKeyValidForState, KEY_VALIDITY, } from './key-matrix.js';
+export { describeKey, formatKeyForDisplay, getKeyIdentifier, isActionKey, isGlobalShortcut, isModifierKey, isNavigationKey, isNumberKey, isPrintableChar, isQuitShortcut, type Key, } from './key-utils.js';
+export { logEdgeCase, logInputAttempt, logLoadingGuardRejection, logStateTransition, logThrottleRejection, type InputLogOptions, type StateTransitionLogOptions, type ThrottleLogOptions, } from './input-logger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/state/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,cAAc,EACd,KAAK,GAAG,GACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/ui/state/input-logger.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Input Logger
+ *
+ * Debug logging for keyboard input events and state transitions.
+ * Only logs when debug mode is enabled.
+ */
+import type { UIState } from './types.js';
+/**
+ * Options for logging an input attempt
+ */
+export interface InputLogOptions {
+    /** The key identifier that was pressed */
+    key: string;
+    /** The current UI state */
+    state: UIState;
+    /** Whether the input was valid for the current state */
+    valid: boolean;
+    /** Whether the input was throttled */
+    throttled?: boolean;
+    /** Reason for rejection (if not valid) */
+    reason?: string;
+}
+/**
+ * Options for logging a state transition
+ */
+export interface StateTransitionLogOptions {
+    /** Previous UI state */
+    from: UIState;
+    /** New UI state */
+    to: UIState;
+    /** What triggered the transition */
+    trigger: string;
+}
+/**
+ * Options for logging a throttle rejection
+ */
+export interface ThrottleLogOptions {
+    /** The action that was throttled */
+    action: string;
+    /** Time since last call in milliseconds */
+    timeSinceLastCall: number;
+    /** Required minimum time between calls */
+    minInterval: number;
+}
+/**
+ * Log an input attempt (only in debug mode)
+ *
+ * @param options - Input attempt details
+ * @param debugEnabled - Whether debug mode is enabled
+ */
+export declare function logInputAttempt(options: InputLogOptions, debugEnabled: boolean): void;
+/**
+ * Log a state transition (only in debug mode)
+ *
+ * @param options - State transition details
+ * @param debugEnabled - Whether debug mode is enabled
+ */
+export declare function logStateTransition(options: StateTransitionLogOptions, debugEnabled: boolean): void;
+/**
+ * Log a throttle rejection (only in debug mode)
+ *
+ * @param options - Throttle details
+ * @param debugEnabled - Whether debug mode is enabled
+ */
+export declare function logThrottleRejection(options: ThrottleLogOptions, debugEnabled: boolean): void;
+/**
+ * Log a loading guard rejection (only in debug mode)
+ *
+ * @param action - The action that was blocked
+ * @param loadingOperation - Which operation is currently loading
+ * @param debugEnabled - Whether debug mode is enabled
+ */
+export declare function logLoadingGuardRejection(action: string, loadingOperation: string, debugEnabled: boolean): void;
+/**
+ * Log an edge case handling event (only in debug mode)
+ *
+ * @param event - Description of the edge case
+ * @param details - Additional details
+ * @param debugEnabled - Whether debug mode is enabled
+ */
+export declare function logEdgeCase(event: string, details: Record<string, unknown>, debugEnabled: boolean): void;
+//# sourceMappingURL=input-logger.d.ts.map

package/dist/ui/state/input-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-logger.d.ts","sourceRoot":"","sources":["../../../src/ui/state/input-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wBAAwB;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAuBrF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAclG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAW7F;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAQ9G;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAOxG"}