@principal-ade/panel-layouts 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -55,6 +55,14 @@ export declare interface AgentCommandInputProps {
     autoFocus?: boolean;
     /** Whether an AI agent is available */
     agentAvailable?: boolean;
+    /** Whether autocomplete dropdown is visible */
+    showAutocomplete?: boolean;
+    /** Navigate to next autocomplete item (Down arrow when autocomplete open) */
+    onAutocompleteNext?: () => void;
+    /** Navigate to previous autocomplete item (Up arrow when autocomplete open) */
+    onAutocompletePrevious?: () => void;
+    /** Accept selected autocomplete item (Tab key) */
+    onAutocompleteAccept?: () => void;
 }
 
 /**
@@ -247,6 +255,15 @@ export declare interface FocusIndicatorProps {
  */
 export declare const focusPanelTool: PanelTool;
 
+/**
+ * Fuzzy match a query against a target string.
+ * Returns score and matched indices, or null if no match.
+ */
+export declare function fuzzyMatch(query: string, target: string): {
+    score: number;
+    matchedIndices: number[];
+} | null;
+
 /**
  * Gemini function declaration format
  */
@@ -645,6 +662,66 @@ export declare interface PersistenceAdapter {
     }): Promise<void>;
 }
 
+/**
+ * Definition of a quick command for autocomplete
+ */
+export declare interface QuickCommand {
+    /** Command name without the leading slash (e.g., "toggle") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Argument definitions */
+    args?: QuickCommandArg[];
+    /** Aliases that also match this command (e.g., ["t"] for toggle) */
+    aliases?: string[];
+    /** Category for grouping in UI */
+    category?: string;
+}
+
+/**
+ * Argument definition for a quick command
+ */
+export declare interface QuickCommandArg {
+    /** Argument name (for display) */
+    name: string;
+    /** Description of the argument */
+    description?: string;
+    /** Whether this argument is required */
+    required?: boolean;
+    /** Allowed values (for enum-style args) */
+    options?: string[];
+}
+
+/**
+ * QuickCommandAutocomplete - Dropdown showing fuzzy-matched quick commands
+ */
+export declare const QuickCommandAutocomplete: default_2.FC<QuickCommandAutocompleteProps>;
+
+export declare interface QuickCommandAutocompleteProps {
+    /** Matched commands to display */
+    matches: QuickCommandMatch[];
+    /** Currently selected index */
+    selectedIndex: number;
+    /** Called when a command is clicked */
+    onSelect: (index: number) => void;
+    /** Maximum number of visible items before scrolling */
+    maxVisible?: number;
+}
+
+/**
+ * A quick command match result from fuzzy search
+ */
+export declare interface QuickCommandMatch {
+    /** The matched command */
+    command: QuickCommand;
+    /** Match score (higher = better match) */
+    score: number;
+    /** Which parts of the name matched (for highlighting) */
+    matchedIndices: number[];
+    /** The specific variant matched (name or alias) */
+    matchedOn: string;
+}
+
 /**
  * Repository-specific workspace state
  * Tracks which workspace is active and current panel configuration for a repository
@@ -684,6 +761,12 @@ export { ResponsiveConfigurablePanelLayout }
 
 export { ResponsiveConfigurablePanelLayoutProps }
 
+/**
+ * Search quick commands using fuzzy matching.
+ * Returns sorted matches with scores.
+ */
+export declare function searchQuickCommands(query: string, commands: QuickCommand[], maxResults?: number): QuickCommandMatch[];
+
 /**
  * State query tools only (for selective registration).
  */
@@ -847,7 +930,7 @@ export declare interface UpdateWorkspaceOptions {
  * Hook for managing Agent Command Palette state and behavior
  * Handles input, history navigation, tool execution tracking, and keyboard shortcuts
  */
-export declare function useAgentCommandPalette({ events, keyboard, config, onExecuteTool, initialSuggestions, agentAvailable, }?: UseAgentCommandPaletteOptions): UseAgentCommandPaletteReturn;
+export declare function useAgentCommandPalette({ events, keyboard, config, onExecuteTool, initialSuggestions, agentAvailable, quickCommands, }?: UseAgentCommandPaletteOptions): UseAgentCommandPaletteReturn;
 
 /**
  * Options for the useAgentCommandPalette hook
@@ -865,6 +948,8 @@ export declare interface UseAgentCommandPaletteOptions {
     initialSuggestions?: string[];
     /** Whether an AI agent is available (defaults to true). When false, only quick commands work. */
     agentAvailable?: boolean;
+    /** Quick commands available for autocomplete */
+    quickCommands?: QuickCommand[];
 }
 
 /**
@@ -917,6 +1002,18 @@ export declare interface UseAgentCommandPaletteReturn {
     suggestions: string[];
     /** Clear the current state (query, tools, response) */
     clear: () => void;
+    /** Filtered quick command matches based on current query */
+    quickCommandMatches: QuickCommandMatch[];
+    /** Currently selected autocomplete index (-1 = none) */
+    selectedAutocompleteIndex: number;
+    /** Select next autocomplete item */
+    autocompleteNext: () => void;
+    /** Select previous autocomplete item */
+    autocompletePrevious: () => void;
+    /** Accept the currently selected autocomplete item */
+    autocompleteAccept: () => void;
+    /** Whether autocomplete dropdown should be shown */
+    showAutocomplete: boolean;
 }
 
 /**