@principal-ade/panel-layouts 0.2.8 → 0.3.0

package/dist/index.d.ts

@@ -5,9 +5,7 @@ import { EditableConfigurablePanelLayoutProps } from '@principal-ade/panels';
 import { JsonSchema } from '@principal-ade/panel-framework-core';
 import { mapThemeToPanelVars } from '@principal-ade/panels';
 import { mapThemeToTabVars } from '@principal-ade/panels';
-import { PanelActions } from '@principal-ade/panel-framework-core';
 import { PanelBlurEventPayload } from '@principal-ade/panel-framework-core';
-import { PanelContextValue } from '@principal-ade/panel-framework-core';
 import { PanelDefinition } from '@principal-ade/panels';
 import { PanelDefinitionWithContent } from '@principal-ade/panels';
 import { PanelEventEmitter } from '@principal-ade/panel-framework-core';
@@ -16,8 +14,6 @@ import { PanelGroup } from '@principal-ade/panels';
 import { PanelLayout } from '@principal-ade/panels';
 import { PanelSlot } from '@principal-ade/panels';
 import { PanelTool } from '@principal-ade/panel-framework-core';
-import { PanelToolRegistry } from '@principal-ade/panel-framework-core';
-import { RegisteredTool } from '@principal-ade/panel-framework-core';
 import { ResponsiveConfigurablePanelLayout } from '@principal-ade/panels';
 import { ResponsiveConfigurablePanelLayoutProps } from '@principal-ade/panels';
 import { TabsConfig } from '@principal-ade/panels';
@@ -56,6 +52,8 @@ export declare interface AgentCommandInputProps {
     disabled?: boolean;
     /** Auto-focus on mount */
     autoFocus?: boolean;
+    /** Whether an AI agent is available */
+    agentAvailable?: boolean;
 }
 
 /**
@@ -182,66 +180,6 @@ export declare type BuiltInWorkspaceId = 'project-management' | 'code-review' |
  */
 export declare const collapseAllPanelsTool: PanelTool;
 
-/**
- * Command definition for the command palette
- */
-export declare interface Command {
-    /** Unique identifier for the command */
-    id: string;
-    /** Display label shown in the command list */
-    label: string;
-    /** Optional description shown below the label */
-    description?: string;
-    /** Optional icon (string or React element) */
-    icon?: string | React.ReactNode;
-    /** Keywords for fuzzy search matching */
-    keywords?: string[];
-    /** Category for grouping commands */
-    category?: string;
-    /** Optional keyboard shortcut hint (e.g., "Alt+1") */
-    shortcut?: string;
-    /** Command execution function */
-    execute: (context: CommandContext) => void | Promise<void>;
-    /** Optional function to determine if command is available */
-    isAvailable?: (context: CommandContext) => boolean;
-    /** Priority for ordering (higher = appears first) */
-    priority?: number;
-}
-
-/**
- * Command category definition
- */
-export declare interface CommandCategory {
-    /** Category identifier */
-    id: string;
-    /** Display label */
-    label: string;
-    /** Display priority (higher = shown first) */
-    priority?: number;
-    /** Optional icon */
-    icon?: string | React.ReactNode;
-}
-
-/**
- * Context provided to command execution functions
- */
-export declare interface CommandContext {
-    /** Panel framework context */
-    panelContext: PanelContextValue;
-    /** Panel actions for navigation, file operations, etc. */
-    actions: PanelActions;
-    /** Event bus for inter-panel communication */
-    events: PanelEventEmitter;
-    /** Currently focused panel */
-    focusedPanel: PanelSlotId | null;
-    /** Function to set panel focus */
-    setFocus: (panel: PanelSlotId) => void;
-    /** Workspace management service */
-    workspaceService?: WorkspaceLayoutService;
-    /** Close the command palette */
-    closeCommandPalette: () => void;
-}
-
 /**
  * Entry in the command history
  */
@@ -256,187 +194,6 @@ export declare interface CommandHistoryEntry {
     success: boolean;
 }
 
-/**
- * CommandInput - Input field for the command palette
- * Auto-focuses on mount and handles input changes
- */
-export declare const CommandInput: default_2.FC<CommandInputProps>;
-
-declare interface CommandInputProps {
-    value: string;
-    onChange: (value: string) => void;
-    placeholder?: string;
-    onClose: () => void;
-    onEnter?: () => void;
-}
-
-/**
- * CommandItem - Individual command item in the list
- * Displays command label, description, icon, and keyboard shortcut
- */
-export declare const CommandItem: default_2.ForwardRefExoticComponent<CommandItemProps & default_2.RefAttributes<HTMLDivElement>>;
-
-declare interface CommandItemProps {
-    command: Command;
-    isSelected: boolean;
-    onClick: () => void;
-    onMouseEnter: () => void;
-}
-
-/**
- * CommandList - List of filtered commands
- * Displays commands grouped by category with keyboard navigation support
- */
-export declare const CommandList: default_2.FC<CommandListProps>;
-
-declare interface CommandListProps {
-    commands: Command[];
-    selectedIndex: number;
-    onSelect: (command: Command) => void;
-    onHover: (index: number) => void;
-    maxResults?: number;
-}
-
-/**
- * CommandPalette - Vim-style command palette component
- * Displays at the bottom of the screen with an input field and command list
- */
-export declare const CommandPalette: default_2.FC<CommandPaletteProps>;
-
-/**
- * Configuration options for the command palette
- */
-export declare interface CommandPaletteConfig {
-    /** Custom keyboard shortcut configuration */
-    keyboard?: CommandPaletteKeyboardConfig;
-    /** Maximum number of results to show */
-    maxResults?: number;
-    /** Placeholder text for the input field */
-    placeholder?: string;
-    /** Custom CSS class for the container */
-    className?: string;
-    /** Custom styles for the container */
-    style?: React.CSSProperties;
-    /** Maximum height of the results list */
-    maxHeight?: string;
-    /** Enable fuzzy search (default: true) */
-    fuzzySearch?: boolean;
-    /** Threshold for fuzzy search matching (0-1, default: 0.3) */
-    fuzzyThreshold?: number;
-}
-
-/**
- * Keyboard shortcut configuration for triggering the command palette
- */
-export declare interface CommandPaletteKeyboardConfig {
-    /** Key to trigger the command palette (default: ' ' for Space) */
-    key?: string;
-    /** Require Alt key (default: true) */
-    altKey?: boolean;
-    /** Require Ctrl key (default: false) */
-    ctrlKey?: boolean;
-    /** Require Meta/Cmd key (default: false) */
-    metaKey?: boolean;
-    /** Require Shift key (default: false) */
-    shiftKey?: boolean;
-}
-
-/**
- * Props for the CommandPalette component
- */
-export declare interface CommandPaletteProps {
-    /** Command palette hook return value */
-    commandPalette: UseCommandPaletteReturn;
-    /** Configuration options */
-    config?: CommandPaletteConfig;
-    /** Panel context for command execution */
-    context: CommandContext;
-}
-
-/**
- * Service for managing command registration and execution
- * Provides a centralized registry for commands that can be accessed via the command palette
- */
-export declare class CommandRegistryService {
-    private commands;
-    private listeners;
-    /**
-     * Register one or more commands
-     * @param commands - Array of commands to register
-     */
-    registerCommands(commands: Command[]): void;
-    /**
-     * Register a single command
-     * @param command - Command to register
-     */
-    registerCommand(command: Command): void;
-    /**
-     * Unregister commands by ID
-     * @param commandIds - Array of command IDs to unregister
-     */
-    unregisterCommands(commandIds: string[]): void;
-    /**
-     * Unregister a single command
-     * @param commandId - Command ID to unregister
-     */
-    unregisterCommand(commandId: string): void;
-    /**
-     * Get all registered commands
-     * @param context - Command context for availability checks
-     * @returns Array of available commands
-     */
-    getCommands(context?: CommandContext): Command[];
-    /**
-     * Get a command by ID
-     * @param commandId - Command ID
-     * @returns Command if found, undefined otherwise
-     */
-    getCommand(commandId: string): Command | undefined;
-    /**
-     * Execute a command by ID
-     * @param commandId - Command ID to execute
-     * @param context - Command context
-     */
-    executeCommand(commandId: string, context: CommandContext): Promise<void>;
-    /**
-     * Search commands by query
-     * @param query - Search query
-     * @param context - Command context for availability checks
-     * @returns Filtered and sorted commands
-     */
-    searchCommands(query: string, context?: CommandContext): Command[];
-    /**
-     * Sort commands by priority and label
-     * @param commands - Commands to sort
-     * @returns Sorted commands
-     */
-    private sortCommands;
-    /**
-     * Subscribe to registry changes
-     * @param listener - Callback function called when registry changes
-     * @returns Unsubscribe function
-     */
-    subscribe(listener: () => void): () => void;
-    /**
-     * Clear all commands
-     */
-    clear(): void;
-    /**
-     * Get count of registered commands
-     */
-    get size(): number;
-    /**
-     * Notify all listeners of registry changes
-     */
-    private notifyListeners;
-}
-
-/**
- * Creates a hook-like function that returns commands from a registry.
- * Useful for dynamic command registration.
- */
-export declare function createToolCommandsProvider(registry: PanelToolRegistry, config?: ToolCommandBridgeConfig): () => Command[];
-
 /**
  * Options for creating a new workspace
  */
@@ -529,18 +286,6 @@ export declare function generateToolsSystemPrompt(tools: PanelTool[], options?:
     includeParameters?: boolean;
 }): string;
 
-/**
- * Get the global command registry instance
- * @returns Global CommandRegistryService instance
- */
-export declare function getGlobalCommandRegistry(): CommandRegistryService;
-
-/**
- * Get panel commands
- * @returns Array of panel-related commands
- */
-export declare function getPanelCommands(): Command[];
-
 /**
  * Tool: Get Panel State
  *
@@ -549,11 +294,6 @@ export declare function getPanelCommands(): Command[];
  */
 export declare const getPanelStateTool: PanelTool;
 
-/**
- * Utility to extract parameter information for UI rendering.
- */
-export declare function getToolParameterInfo(tool: RegisteredTool): ToolParameterInfo[];
-
 /**
  * Tool: Get Visible Panels
  *
@@ -704,11 +444,6 @@ export declare interface PanelCollapsed {
     right?: boolean;
 }
 
-/**
- * Built-in commands for panel navigation and control
- */
-export declare const panelCommands: Command[];
-
 /**
  * A button component for opening panel configuration/layout settings.
  */
@@ -937,11 +672,6 @@ export declare interface RepositoryWorkspaceState {
     };
 }
 
-/**
- * Reset the global command registry (useful for testing)
- */
-export declare function resetGlobalCommandRegistry(): void;
-
 /**
  * Tool: Reset Layout
  *
@@ -993,18 +723,6 @@ export { TilesConfig }
  */
 export declare const togglePanelTool: PanelTool;
 
-/**
- * Configuration for the tool-to-command bridge
- */
-export declare interface ToolCommandBridgeConfig {
-    /** Category prefix for tool commands (default: 'Panel Tools') */
-    categoryPrefix?: string;
-    /** Priority offset for tool commands (default: 50) */
-    basePriority?: number;
-    /** Whether to include panel ID in category (default: true) */
-    includePanelInCategory?: boolean;
-}
-
 /**
  * Represents a single tool execution
  */
@@ -1043,18 +761,6 @@ export declare interface ToolExecutionListProps {
  */
 export declare type ToolExecutionStatus = 'pending' | 'running' | 'success' | 'error';
 
-/**
- * Parameter information for UI rendering
- */
-export declare interface ToolParameterInfo {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-    default?: unknown;
-    enum?: string[];
-}
-
 /**
  * Convert an array of PanelTools to AIFunctionDefinition format.
  */
@@ -1065,11 +771,6 @@ export declare function toolsToAIFunctions(tools: PanelTool[]): AIFunctionDefini
  */
 export declare function toolsToAnthropicFormat(tools: PanelTool[]): AnthropicTool[];
 
-/**
- * Converts all tools from a registry into commands.
- */
-export declare function toolsToCommands(registry: PanelToolRegistry, config?: ToolCommandBridgeConfig): Command[];
-
 /**
  * Convert an array of PanelTools to Gemini tools format.
  */
@@ -1091,15 +792,6 @@ export declare function toolToAIFunction(tool: PanelTool): AIFunctionDefinition;
  */
 export declare function toolToAnthropicFormat(tool: PanelTool): AnthropicTool;
 
-/**
- * Converts a registered tool into a command palette command.
- *
- * For tools with no required parameters, the command executes immediately.
- * For tools with required parameters, this is a placeholder - full
- * implementation would need a parameter input UI.
- */
-export declare function toolToCommand(tool: RegisteredTool, registry: PanelToolRegistry, config?: ToolCommandBridgeConfig): Command;
-
 /**
  * Convert a PanelTool to Gemini function declaration format.
  */
@@ -1154,7 +846,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, }?: UseAgentCommandPaletteOptions): UseAgentCommandPaletteReturn;
+export declare function useAgentCommandPalette({ events, keyboard, config, onExecuteTool, initialSuggestions, agentAvailable, }?: UseAgentCommandPaletteOptions): UseAgentCommandPaletteReturn;
 
 /**
  * Options for the useAgentCommandPalette hook
@@ -1170,12 +862,16 @@ export declare interface UseAgentCommandPaletteOptions {
     onExecuteTool?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     /** Initial suggestions to show */
     initialSuggestions?: string[];
+    /** Whether an AI agent is available (defaults to true). When false, only quick commands work. */
+    agentAvailable?: boolean;
 }
 
 /**
  * Return type for useAgentCommandPalette hook
  */
 export declare interface UseAgentCommandPaletteReturn {
+    /** Whether an AI agent is available */
+    agentAvailable: boolean;
     /** Whether the palette is open */
     isOpen: boolean;
     /** Open the palette */
@@ -1222,63 +918,6 @@ export declare interface UseAgentCommandPaletteReturn {
     clear: () => void;
 }
 
-/**
- * Hook for managing command palette state and behavior
- * Handles command registration, filtering, keyboard navigation, and execution
- */
-export declare function useCommandPalette({ context, commands: initialCommands, keyboard, config, registry: providedRegistry, }: UseCommandPaletteProps): UseCommandPaletteReturn;
-
-declare interface UseCommandPaletteProps {
-    /** Command context */
-    context: CommandContext;
-    /** Initial commands to register */
-    commands?: Command[];
-    /** Keyboard configuration */
-    keyboard?: CommandPaletteKeyboardConfig;
-    /** Command palette configuration */
-    config?: CommandPaletteConfig;
-    /** Command registry service (optional, uses global if not provided) */
-    registry?: CommandRegistryService;
-}
-
-/**
- * Command palette state and actions hook return type
- */
-export declare interface UseCommandPaletteReturn {
-    /** Whether the command palette is open */
-    isOpen: boolean;
-    /** Open the command palette */
-    open: () => void;
-    /** Close the command palette */
-    close: () => void;
-    /** Toggle the command palette */
-    toggle: () => void;
-    /** Search query */
-    query: string;
-    /** Set search query */
-    setQuery: (query: string) => void;
-    /** Filtered and sorted commands */
-    filteredCommands: Command[];
-    /** Execute a command by ID */
-    executeCommand: (commandId: string) => Promise<void>;
-    /** Selected command index (for keyboard navigation) */
-    selectedIndex: number;
-    /** Set selected index */
-    setSelectedIndex: (index: number) => void;
-    /** Navigate to next command */
-    selectNext: () => void;
-    /** Navigate to previous command */
-    selectPrevious: () => void;
-    /** Execute the currently selected command */
-    executeSelected: () => Promise<void>;
-    /** All registered commands */
-    commands: Command[];
-    /** Register new commands */
-    registerCommands: (commands: Command[]) => void;
-    /** Unregister commands by ID */
-    unregisterCommands: (commandIds: string[]) => void;
-}
-
 /**
  * Hook for managing panel focus state with keyboard shortcuts
  */
@@ -1415,12 +1054,6 @@ export declare interface UsePanelPersistenceOptions {
     adapter?: PersistenceAdapter;
 }
 
-/**
- * Hook to use tool commands in React components.
- * Subscribes to registry changes and updates commands accordingly.
- */
-export declare function useToolCommands(registry: PanelToolRegistry, config?: ToolCommandBridgeConfig): Command[];
-
 export declare function useWorkspace(options?: UseWorkspaceOptions): UseWorkspaceReturn;
 
 export declare interface UseWorkspaceOptions {