/**
 * Keyboard Service Types
 *
 * Type definitions for the unified keyboard shortcut system.
 * Provides type-safe interfaces for registering and handling keyboard shortcuts.
 */

export interface ShortcutConfig {
  /** The keyboard shortcut key combination (e.g., 'cmdorctrl+l', 'escape', 'enter') */
  key: string;

  /** Function to execute when the shortcut is triggered */
  handler: () => void;

  /** Whether to prevent the default browser behavior (default: true) */
  preventDefault?: boolean;

  /** Whether to stop event propagation (default: true) */
  stopPropagation?: boolean;

  /** Only trigger when this component is focused (default: false) */
  whenFocused?: boolean;

  /** Optional description for debugging */
  description?: string;
}

export interface KeyboardEventDetail {
  /** The original keyboard shortcut string */
  shortcut: string;

  /** Timestamp when the event occurred */
  timestamp: number;

  /** Component that should handle this event (if specified) */
  targetComponent?: string;
}

export interface ComponentShortcuts {
  /** Unique component identifier */
  componentId: string;

  /** Array of shortcuts registered by this component */
  shortcuts: ShortcutConfig[];

  /** Whether this component is currently focused */
  focused: boolean;

  /** Optional cleanup function called when component is destroyed */
  cleanup?: () => void;
}

export interface KeyboardServiceConfig {
  /** Enable debug logging for keyboard events */
  debug?: boolean;

  /** Global shortcuts that work regardless of component focus */
  globalShortcuts?: ShortcutConfig[];
}

/**
 * Event types for keyboard service
 */
export type KeyboardEventType =
  | 'shortcut-triggered'
  | 'component-focused'
  | 'component-blurred'
  | 'shortcut-registered'
  | 'shortcut-unregistered';

export interface KeyboardEvent {
  type: KeyboardEventType;
  detail: KeyboardEventDetail | ComponentShortcuts | ShortcutConfig;
}

/**
 * Keyboard modifiers mapping
 */
export const MODIFIER_KEYS = {
  ctrl: 'ctrlKey',
  cmd: 'metaKey',
  cmdorctrl: navigator.platform.includes('Mac') ? 'metaKey' : 'ctrlKey',
  alt: 'altKey',
  shift: 'shiftKey'
} as const;

/**
 * Common shortcut patterns used throughout the application
 */
export const COMMON_SHORTCUTS = {
  OMNIBOX_OPEN: 'cmdorctrl+l',
  FIND_OPEN: 'cmdorctrl+f',
  ESCAPE: 'escape',
  ENTER: 'enter',
  ARROW_UP: 'arrowup',
  ARROW_DOWN: 'arrowdown',
  ARROW_LEFT: 'arrowleft',
  ARROW_RIGHT: 'arrowright',
  TAB: 'tab',
  SHIFT_TAB: 'shift+tab'
} as const;