Defined in: recorder.ts:72

Framework-agnostic class for recording keyboard shortcuts.

This class handles all the complexity of capturing keyboard events, converting them to hotkey strings, and handling edge cases like Escape to cancel or Backspace/Delete to clear.

State Management:

• Uses TanStack Store for reactive state management
• State can be accessed via recorder.store.state when using the class directly
• When using framework adapters (React), use useStore hooks for reactive state

const recorder = new HotkeyRecorder({
  onRecord: (hotkey) => {
    console.log('Recorded:', hotkey)
  },
  onCancel: () => {
    console.log('Recording cancelled')
  },
})

// Start recording
recorder.start()

// Access state directly
console.log(recorder.store.state.isRecording) // true

// Subscribe to changes with TanStack Store
const unsubscribe = recorder.store.subscribe(() => {
  console.log('Recording:', recorder.store.state.isRecording)
})

// Cleanup
recorder.destroy()
unsubscribe()

new HotkeyRecorder(options): HotkeyRecorder;

Defined in: recorder.ts:86

HotkeyRecorderOptions

HotkeyRecorder

readonly store: Store<HotkeyRecorderState>;

Defined in: recorder.ts:77

The TanStack Store instance containing the recorder state. Use this to subscribe to state changes or access current state.

cancel(): void;

Defined in: recorder.ts:214

Cancel recording without saving.

Removes the event listener, resets the recording state, and calls the onCancel callback if provided.

void

destroy(): void;

Defined in: recorder.ts:259

Clean up event listeners and reset state.

Call this when you're done with the recorder to ensure all event listeners are properly removed.

void

setOptions(options): void;

Defined in: recorder.ts:95

Updates the recorder options, including callbacks. This allows framework adapters to sync callback changes without recreating the recorder.

Partial<HotkeyRecorderOptions>

void

start(): void;

Defined in: recorder.ts:109

Start recording a new hotkey.

Sets up a keydown event listener that captures keyboard events and converts them to hotkey strings. Recording continues until a valid hotkey is recorded, Escape is pressed, or stop/cancel is called.

void

stop(): void;

Defined in: recorder.ts:194

Stop recording (same as cancel, but doesn't call onCancel).

Removes the event listener and resets the recording state.

void