@principal-ade/panel-layouts 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { default as default_2 } from 'react';
 import { EditableConfigurablePanelLayout } from '@principal-ade/panels';
 import { EditableConfigurablePanelLayoutProps } from '@principal-ade/panels';
 import { mapThemeToPanelVars } from '@principal-ade/panels';
@@ -40,6 +41,22 @@ export { EditableConfigurablePanelLayout }
 
 export { EditableConfigurablePanelLayoutProps }
 
+/**
+ * Visual indicator that highlights the focused panel
+ *
+ * Renders a subtle border/glow around the focused panel for keyboard navigation feedback
+ */
+export declare const FocusIndicator: default_2.FC<FocusIndicatorProps>;
+
+export declare interface FocusIndicatorProps {
+    /** Whether this panel is currently focused */
+    isFocused: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Custom styles */
+    style?: default_2.CSSProperties;
+}
+
 /**
  * Default localStorage-based persistence adapter for web applications
  */
@@ -92,6 +109,28 @@ export { PanelDefinition }
 
 export { PanelDefinitionWithContent }
 
+/**
+ * Actions for managing panel focus
+ */
+export declare interface PanelFocusActions {
+    /** Set focus to a specific panel */
+    setFocus: (panel: PanelSlotId) => void;
+    /** Clear focus from all panels */
+    clearFocus: () => void;
+    /** Focus the next visible panel */
+    focusNext: () => void;
+    /** Focus the previous visible panel */
+    focusPrevious: () => void;
+}
+
+/**
+ * Focus state for the panel layout
+ */
+export declare interface PanelFocusState {
+    /** Currently focused panel, or null if no panel is focused */
+    focusedPanel: PanelSlotId | null;
+}
+
 export { PanelGroup }
 
 export { PanelLayout }
@@ -116,6 +155,14 @@ export declare interface PanelSizes {
 
 export { PanelSlot }
 
+/**
+ * Focus management type definitions for keyboard shortcuts
+ */
+/**
+ * Panel identifier for focus tracking
+ */
+export declare type PanelSlotId = 'left' | 'middle' | 'right';
+
 /**
  * Storage adapter interface for persisting panel state
  * Implementations can use localStorage, Electron IPC, or remote storage
@@ -229,6 +276,63 @@ export declare interface UpdateWorkspaceOptions {
     };
 }
 
+/**
+ * Hook for managing panel focus state with keyboard shortcuts
+ */
+export declare function usePanelFocus(options?: UsePanelFocusOptions): UsePanelFocusReturn;
+
+export declare interface UsePanelFocusOptions {
+    /** Initial focused panel (optional) */
+    initialFocus?: PanelSlotId | null;
+    /** Collapsed state to determine which panels are visible */
+    collapsed?: PanelCollapsed;
+    /** Whether this is a two-panel or three-panel layout */
+    panelType?: 'two-panel' | 'three-panel';
+    /** Callback when focus changes */
+    onFocusChange?: (panel: PanelSlotId | null) => void;
+}
+
+export declare interface UsePanelFocusReturn extends PanelFocusState, PanelFocusActions {
+    /** Check if a specific panel is focused */
+    isFocused: (panel: PanelSlotId) => boolean;
+}
+
+/**
+ * Hook for handling Alt+1/2/3 keyboard shortcuts for panel toggle and focus
+ *
+ * Behavior:
+ * - Alt+1 (Left Panel):
+ *   1. If collapsed: expand (no focus change)
+ *   2. If expanded but not focused: focus it
+ *   3. If focused: collapse and focus middle
+ *
+ * - Alt+2 (Middle Panel):
+ *   - Always focus middle (never collapses)
+ *
+ * - Alt+3 (Right Panel):
+ *   1. If collapsed: expand (no focus change)
+ *   2. If expanded but not focused: focus it
+ *   3. If focused: collapse and focus middle
+ */
+export declare function usePanelKeyboardShortcuts(options: UsePanelKeyboardShortcutsOptions): void;
+
+export declare interface UsePanelKeyboardShortcutsOptions {
+    /** Whether keyboard shortcuts are enabled */
+    enabled?: boolean;
+    /** Current focused panel */
+    focusedPanel: PanelSlotId | null;
+    /** Current collapsed state */
+    collapsed: PanelCollapsed;
+    /** Panel type (two-panel or three-panel) */
+    panelType: 'two-panel' | 'three-panel';
+    /** Set focus to a specific panel */
+    setFocus: (panel: PanelSlotId) => void;
+    /** Callback to expand a panel */
+    onExpand: (panel: 'left' | 'right') => void | Promise<void>;
+    /** Callback to collapse a panel */
+    onCollapse: (panel: 'left' | 'right') => void | Promise<void>;
+}
+
 /**
  * Hook for persisting panel layouts across sessions
  *