tuiuiu.js 0.1.1

package/dist/core/command-palette.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Command Palette System
+ *
+ * Provides a fuzzy-searchable command palette for discovering and executing actions.
+ */
+/**
+ * Command definition
+ */
+export interface Command {
+    /** Unique identifier for the command */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Category for grouping */
+    category?: string;
+    /** Keyboard shortcut string (e.g., 'ctrl+k') */
+    keybinding?: string;
+    /** Action to execute */
+    action: () => void | Promise<void>;
+    /** Whether the command is currently enabled */
+    enabled?: boolean;
+    /** Icon character or emoji */
+    icon?: string;
+    /** Tags for additional search matching */
+    tags?: string[];
+    /** When true, don't add to recent commands */
+    hideFromRecent?: boolean;
+}
+/**
+ * Command registration options (partial command)
+ */
+export type CommandOptions = Omit<Command, 'id'> & {
+    id?: string;
+};
+/**
+ * Fuzzy match result
+ */
+export interface FuzzyMatch {
+    command: Command;
+    score: number;
+    matches: number[];
+}
+/**
+ * Command palette state
+ */
+export interface CommandPaletteState {
+    isOpen: boolean;
+    query: string;
+    results: FuzzyMatch[];
+    selectedIndex: number;
+    isLoading: boolean;
+}
+/**
+ * Command palette options
+ */
+export interface CommandPaletteOptions {
+    /** Maximum number of results to show */
+    maxResults?: number;
+    /** Maximum number of recent commands to track */
+    maxRecent?: number;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Whether to show categories */
+    showCategories?: boolean;
+    /** Whether to show keybindings */
+    showKeybindings?: boolean;
+    /** Whether to show descriptions */
+    showDescriptions?: boolean;
+    /** Custom key to open the palette (default: 'ctrl+k') */
+    openKey?: string;
+}
+/**
+ * Perform fuzzy matching on a string
+ * Returns null if no match, or a score and match positions
+ */
+export declare function fuzzyMatch(pattern: string, text: string): FuzzyMatch | null;
+/**
+ * Search commands with fuzzy matching
+ */
+export declare function searchCommands(commands: Command[], query: string, maxResults?: number): FuzzyMatch[];
+/**
+ * Reset command ID counter (for testing)
+ */
+export declare function resetCommandIdCounter(): void;
+/**
+ * Command Registry
+ *
+ * Centralized registry for all discoverable commands.
+ */
+export declare class CommandRegistry {
+    private commands;
+    private recentCommands;
+    private maxRecent;
+    private listeners;
+    /**
+     * Register a command
+     */
+    register(options: CommandOptions): string;
+    /**
+     * Unregister a command
+     */
+    unregister(id: string): boolean;
+    /**
+     * Get a command by ID
+     */
+    get(id: string): Command | undefined;
+    /**
+     * Get all commands
+     */
+    getAll(): Command[];
+    /**
+     * Get commands by category
+     */
+    getByCategory(category: string): Command[];
+    /**
+     * Get all categories
+     */
+    getCategories(): string[];
+    /**
+     * Get recent commands
+     */
+    getRecent(): Command[];
+    /**
+     * Execute a command by ID
+     */
+    execute(id: string): Promise<boolean>;
+    /**
+     * Add command to recent list
+     */
+    private addToRecent;
+    /**
+     * Set maximum recent commands
+     */
+    setMaxRecent(max: number): void;
+    /**
+     * Clear recent commands
+     */
+    clearRecent(): void;
+    /**
+     * Search commands
+     */
+    search(query: string, maxResults?: number): FuzzyMatch[];
+    /**
+     * Enable/disable a command
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * Subscribe to registry changes
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Notify all listeners of changes
+     */
+    private notifyListeners;
+    /**
+     * Clear all commands
+     */
+    clear(): void;
+    /**
+     * Get command count
+     */
+    get size(): number;
+}
+/**
+ * Get the global command registry
+ */
+export declare function getCommandRegistry(): CommandRegistry;
+/**
+ * Reset the global registry (for testing)
+ */
+export declare function resetCommandRegistry(): void;
+/**
+ * Register a command in the global registry
+ */
+export declare function registerCommand(options: CommandOptions): string;
+/**
+ * Unregister a command from the global registry
+ */
+export declare function unregisterCommand(id: string): boolean;
+/**
+ * Execute a command by ID
+ */
+export declare function executeCommand(id: string): Promise<boolean>;
+/**
+ * Search commands in the global registry
+ */
+export declare function searchGlobalCommands(query: string, maxResults?: number): FuzzyMatch[];
+/**
+ * Create command palette state
+ */
+export declare function createCommandPaletteState(options?: CommandPaletteOptions): {
+    state: () => CommandPaletteState;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    setQuery: (query: string) => void;
+    selectNext: () => void;
+    selectPrevious: () => void;
+    selectFirst: () => void;
+    selectLast: () => void;
+    executeSelected: () => Promise<boolean>;
+};
+/**
+ * Split text into segments for highlighting matched characters
+ */
+export declare function highlightMatches(text: string, matches: number[]): Array<{
+    text: string;
+    highlight: boolean;
+}>;
+/**
+ * Format command for display with optional keybinding
+ */
+export declare function formatCommand(command: Command): string;
+/**
+ * Group commands by category
+ */
+export declare function groupByCategory(commands: Command[]): Map<string, Command[]>;
+//# sourceMappingURL=command-palette.d.ts.map

package/dist/core/command-palette.d.ts.map

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