Keyboard Shortcuts

<script lang="ts">
  import { createShortcutManager } from 'phoundry-ui';

  const shortcuts = createShortcutManager();

  shortcuts.register({
    id: 'app.save',
    label: 'Save',
    defaults: ['CmdOrCtrl+S'],
    handler: () => console.log('Saved!'),
  });

  shortcuts.register({
    id: 'app.new',
    label: 'New Document',
    defaults: ['CmdOrCtrl+N'],
    handler: () => console.log('New document'),
    section: 'Documents',
  });

  // Display the formatted shortcut
  const display = shortcuts.getDisplayShortcut('app.save');
  // → "⌘S" on Mac, "Ctrl+S" on Windows/Linux

  await shortcuts.init();
</script>

shortcuts.register({
  id: 'editor.delete-line',
  label: 'Delete Line',
  defaults: [
    { mac: 'Cmd+Backspace', default: 'Ctrl+Shift+K' }
  ],
  handler: () => deleteLine(),
});

// User wants to rebind Save to Ctrl+Shift+S
await shortcuts.setOverride('app.save', ['Ctrl+Shift+S']);

// Check for conflicts before setting
const conflict = shortcuts.checkConflict('Ctrl+N', 'app.new');
if (conflict) {
  console.warn(`Conflicts with "${conflict.existingActionLabel}"`);
}

// Reset a single action or all overrides
await shortcuts.resetToDefault('app.save');
await shortcuts.resetAll();

import { parseShortcut, formatShortcut, matchesEvent } from 'phoundry-ui';

const parsed = parseShortcut('CmdOrCtrl+Shift+P', 'mac');
// → { key: 'p', ctrl: false, meta: true, alt: false, shift: true }

const display = formatShortcut('CmdOrCtrl+S', 'mac');
// → "⌘S"

document.addEventListener('keydown', (e) => {
  if (matchesEvent(parsed, e)) {
    console.log('Matched!');
  }
});

import { createShortcutManager, getShortcutManager } from 'phoundry-ui';

// Typically once at startup:
export const shortcuts = createShortcutManager({ loadOverrides, saveOverrides });

// Elsewhere (after startup):
const same = getShortcutManager();