import { useShortcut } from '@/lib/keyboard'

function MyComponent() {
  useShortcut('QUICK_SWITCHER', () => {
    openQuickSwitcher()
  })

  return <div>...</div>
}

import { useHotkey } from '@/hooks/use-hotkey'

function MyComponent() {
  // Simple usage
  useHotkey('mod+k', () => openSearch())

  // With options
  useHotkey('mod+s', handleSave, {
    preventDefault: true,
    enableOnInputs: true,
  })

  return <div>...</div>
}

import { useEditorShortcuts } from '@/hooks/use-editor-shortcuts';
import { useEditor } from '@tiptap/react';

function MessageEditor() {
  const editor = useEditor({...});

  useEditorShortcuts({
    editor,
    isFocused: true,
    onInsertLink: () => setLinkDialogOpen(true),
  });

  return <EditorContent editor={editor} />;
}

import { useScopedKeyboard } from '@/lib/keyboard'

function MessageList() {
  const [selectedMessageId, setSelectedMessageId] = useState(null)

  // Activate 'message-selected' scope when a message is selected
  useScopedKeyboard('message-selected', !!selectedMessageId)

  // This shortcut only works when scope is active
  useShortcut(
    'REPLY',
    () => {
      replyToMessage(selectedMessageId)
    },
    { scopes: ['message-selected'] }
  )

  return <div>...</div>
}

import { getShortcutManager } from '@/lib/shortcuts/shortcut-manager'

const manager = getShortcutManager()

// Register a shortcut
const unregister = manager.register({
  id: 'my-shortcut',
  key: 'mod+shift+x',
  handler: (event) => {
    console.log('Shortcut triggered!')
  },
  priority: 10,
  scopes: ['chat'],
})

// Add scope
manager.addScope('chat')

// Clean up
unregister()

// Example: Two shortcuts with same key in overlapping scopes
{
  key: 'mod+s',
  id: 'save-message',
  scopes: ['chat']
}

{
  key: 'mod+s',
  id: 'save-draft',
  scopes: ['chat'] // ❌ CONFLICT!
}

// Export customizations
const json = useShortcutStore.getState().exportCustomizations()
// Download as JSON file

// Import customizations
const success = useShortcutStore.getState().importCustomizations(json)

import { useScopedKeyboard } from '@/lib/keyboard'

function MyComponent() {
  const [isActive, setIsActive] = useState(false)

  // Scope is active when isActive is true
  useScopedKeyboard('my-scope', isActive)

  useShortcut('MY_SHORTCUT', handleAction, {
    scopes: ['my-scope'],
  })
}

interface ShortcutStoreState {
  customShortcuts: Record<string, CustomShortcut>
  disabledShortcuts: Set<string>
  shortcutsEnabled: boolean
  showKeyboardHints: boolean
  recordingShortcut: ShortcutKey | null
  conflicts: ShortcutConflict[]
}

// Customization
setCustomKey(id: ShortcutKey, key: string): void
resetToDefault(id: ShortcutKey): void
resetAllToDefaults(): void

// Enable/Disable
disableShortcut(id: ShortcutKey): void
enableShortcut(id: ShortcutKey): void
toggleShortcut(id: ShortcutKey): void
setShortcutsEnabled(enabled: boolean): void

// Recording
startRecording(id: ShortcutKey): void
stopRecording(): void
recordKey(key: string): boolean

// Preferences
setShowKeyboardHints(show: boolean): void

// Getters
getEffectiveKey(id: ShortcutKey): string
isShortcutEnabled(id: ShortcutKey): boolean
getConflicts(): ShortcutConflict[]

// Export/Import
exportCustomizations(): string
importCustomizations(json: string): boolean

import { formatShortcut } from '@/lib/keyboard/shortcut-utils'

// Platform-aware formatting
const display = formatShortcut('mod+shift+k', { useMacSymbols: true })
// Mac: "⌘⇧K"
// Windows: "Ctrl+Shift+K"

import { shortcutsConflict } from '@/lib/keyboard/shortcut-utils'

const hasConflict = shortcutsConflict('mod+k', 'mod+k') // true
const hasConflict = shortcutsConflict('mod+k', 'mod+shift+k') // false

import { parseShortcut } from '@/lib/keyboard/shortcut-utils'

const parsed = parseShortcut('mod+shift+k')
// {
//   modifiers: ['mod', 'shift'],
//   key: 'k',
//   originalString: 'mod+shift+k'
// }

// ✅ Good - works on all platforms
useHotkey('mod+k', handleAction)

// ❌ Bad - Mac only
useHotkey('meta+k', handleAction)

// ✅ Prevent browser's print dialog
useHotkey('mod+p', handlePrint, { preventDefault: true })

// ✅ Editor shortcuts only active when editing
useShortcut('BOLD', handleBold, { scopes: ['editor'] })

// ❌ Would interfere with global actions
useShortcut('BOLD', handleBold) // No scope

// Higher priority executes first
manager.register({
  id: 'high-priority',
  key: 'mod+k',
  handler: handleAction,
  priority: 100, // Executes before lower priorities
})

useEffect(() => {
  const unregister = manager.register({...});

  return () => {
    unregister(); // ✅ Clean up
  };
}, []);

import { useShortcutStore } from '@/lib/keyboard/shortcut-store'

function MyButton() {
  const showHints = useShortcutStore(selectShowKeyboardHints)
  const shortcut = useShortcutStore(selectEffectiveKey('QUICK_SWITCHER'))

  return (
    <Tooltip>
      <TooltipTrigger>
        <Button>Quick Switcher</Button>
      </TooltipTrigger>
      {showHints && (
        <TooltipContent>
          <p>{formatShortcut(shortcut)}</p>
        </TooltipContent>
      )}
    </Tooltip>
  )
}

<button aria-keyshortcuts="Control+K">Open Quick Switcher</button>

import { matchesShortcut } from '@/lib/keyboard/shortcut-utils'

test('matches shortcut correctly', () => {
  const event = new KeyboardEvent('keydown', {
    key: 'k',
    metaKey: true,
  })

  expect(matchesShortcut(event, 'mod+k')).toBe(true)
})

import { renderHook } from '@testing-library/react'
import { useShortcut } from '@/lib/keyboard'

test('shortcut triggers callback', () => {
  const handleAction = jest.fn()

  renderHook(() => useShortcut('QUICK_SWITCHER', handleAction))

  // Simulate Cmd+K
  const event = new KeyboardEvent('keydown', {
    key: 'k',
    metaKey: true,
  })

  window.dispatchEvent(event)

  expect(handleAction).toHaveBeenCalled()
})

// Old
useKeyboardShortcuts({
  'Cmd+K': handleAction,
})

// New
useShortcut('QUICK_SWITCHER', handleAction)
// or
useHotkey('mod+k', handleAction)