add event.code fallbacks for a-z and 0-9

Author: KevinVandy

README.md

@@ -41,7 +41,7 @@ Type-safe keyboard shortcuts for the web. Template strings, parsed objects, cros
 > [!NOTE]
 > TanStack Keys is pre-alpha (prototyping phase). We are actively developing the library and are open to feedback and contributions.
 
-## Goals
+## Features
 
 - **Key Bindings**
   - Template strings as the primary syntax: `Mod+Shift+S`, `Control+Shift+A`, `Escape`
@@ -67,11 +67,15 @@ Type-safe keyboard shortcuts for the web. Template strings, parsed objects, cros
   - `SequenceManager`, `createSequenceMatcher` for Vim-style multi-key shortcuts (e.g. `['G','G']`, `['D','I','W']`)
 - **Key State**
   - `KeyStateTracker`, `getKeyStateTracker` for held-key tracking
+- **Hotkey Recorder**
+  - `HotkeyRecorder` class for capturing keyboard shortcuts interactively
+  - Supports live preview, cancellation, and clearing during recording
 - **React Hooks**
   - `useHotkey` – register a keyboard shortcut (global, via singleton manager)
   - `useHotkeySequence` – detect keys pressed in order within a timeout
   - `useHeldKeys` – reactive list of currently held keys
   - `useKeyHold` – reactive boolean for whether a given key is held
+  - `useHotkeyRecorder` – record keyboard shortcuts interactively with live preview
 - **Devtools**
   - Devtools are a core focus: visibility into all registered hotkeys, scopes, and options
   - `@tanstack/keys-devtools` and `@tanstack/react-keys-devtools` (in active development)
@@ -121,7 +125,7 @@ function Editor() {
 ## Packages
 
 - **`@tanstack/keys`** – Core: parse, format, match, validate, manager, sequence, key-state
-- **`@tanstack/react-keys`** – React: `useHotkey`, `useHotkeySequence`, `useHeldKeys`, `useKeyHold`
+- **`@tanstack/react-keys`** – React: `useHotkey`, `useHotkeySequence`, `useHeldKeys`, `useKeyHold`, `useHotkeyRecorder`
 - **`@tanstack/keys-devtools`** – Base devtools (in development)
 - **`@tanstack/react-keys-devtools`** – React devtools (in development)
 

docs/framework/react/reference/functions/useHotkeyRecorder.md

@@ -9,7 +9,7 @@ title: useHotkeyRecorder
 function useHotkeyRecorder(options): ReactHotkeyRecorder;
 ```
 
-Defined in: [useHotkeyRecorder.ts:60](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L60)
+Defined in: [useHotkeyRecorder.ts:57](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L57)
 
 React hook for recording keyboard shortcuts.
 

docs/framework/react/reference/interfaces/ReactHotkeyRecorder.md

@@ -5,7 +5,7 @@ title: ReactHotkeyRecorder
 
 # Interface: ReactHotkeyRecorder
 
-Defined in: [useHotkeyRecorder.ts:9](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L9)
+Defined in: [useHotkeyRecorder.ts:6](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L6)
 
 ## Properties
 
@@ -15,7 +15,7 @@ Defined in: [useHotkeyRecorder.ts:9](https://github.com/TanStack/keys/blob/main/
 cancelRecording: () => void;
 ```
 
-Defined in: [useHotkeyRecorder.ts:19](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L19)
+Defined in: [useHotkeyRecorder.ts:16](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L16)
 
 Cancel recording without saving
 
@@ -31,7 +31,7 @@ Cancel recording without saving
 isRecording: boolean;
 ```
 
-Defined in: [useHotkeyRecorder.ts:11](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L11)
+Defined in: [useHotkeyRecorder.ts:8](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L8)
 
 Whether recording is currently active
 
@@ -43,7 +43,7 @@ Whether recording is currently active
 recordedHotkey: Hotkey | null;
 ```
 
-Defined in: [useHotkeyRecorder.ts:13](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L13)
+Defined in: [useHotkeyRecorder.ts:10](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L10)
 
 The currently recorded hotkey (for live preview)
 
@@ -55,7 +55,7 @@ The currently recorded hotkey (for live preview)
 startRecording: () => void;
 ```
 
-Defined in: [useHotkeyRecorder.ts:15](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L15)
+Defined in: [useHotkeyRecorder.ts:12](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L12)
 
 Start recording a new hotkey
 
@@ -71,7 +71,7 @@ Start recording a new hotkey
 stopRecording: () => void;
 ```
 
-Defined in: [useHotkeyRecorder.ts:17](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L17)
+Defined in: [useHotkeyRecorder.ts:14](https://github.com/TanStack/keys/blob/main/packages/react-keys/src/useHotkeyRecorder.ts#L14)
 
 Stop recording (same as cancel)
 

docs/reference/classes/HotkeyManager.md

@@ -5,7 +5,7 @@ title: HotkeyManager
 
 # Class: HotkeyManager
 
-Defined in: [manager.ts:56](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L56)
+Defined in: [hotkey-manager.ts:145](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L145)
 
 Singleton manager for hotkey registrations.
 
@@ -34,7 +34,7 @@ unregister()
 destroy(): void;
 ```
 
-Defined in: [manager.ts:526](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L526)
+Defined in: [hotkey-manager.ts:609](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L609)
 
 Destroys the manager and removes all listeners.
 
@@ -50,7 +50,7 @@ Destroys the manager and removes all listeners.
 getRegistrationCount(): number;
 ```
 
-Defined in: [manager.ts:497](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L497)
+Defined in: [hotkey-manager.ts:580](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L580)
 
 Gets the number of registered hotkeys.
 
@@ -66,7 +66,7 @@ Gets the number of registered hotkeys.
 isRegistered(hotkey, target?): boolean;
 ```
 
-Defined in: [manager.ts:508](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L508)
+Defined in: [hotkey-manager.ts:591](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L591)
 
 Checks if a specific hotkey is registered.
 
@@ -82,7 +82,7 @@ The hotkey string to check
 
 Optional target element to match (if provided, both hotkey and target must match)
 
-`HTMLElement` | `Document` | `Window`
+`Document` | `Window` | `HTMLElement`
 
 #### Returns
 
@@ -101,7 +101,7 @@ register(
    options): HotkeyRegistrationHandle;
 ```
 
-Defined in: [manager.ts:122](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L122)
+Defined in: [hotkey-manager.ts:209](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L209)
 
 Registers a hotkey handler and returns a handle for updating the registration.
 
@@ -157,7 +157,7 @@ handle.unregister()
 static getInstance(): HotkeyManager;
 ```
 
-Defined in: [manager.ts:80](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L80)
+Defined in: [hotkey-manager.ts:167](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L167)
 
 Gets the singleton instance of HotkeyManager.
 
@@ -173,7 +173,7 @@ Gets the singleton instance of HotkeyManager.
 static resetInstance(): void;
 ```
 
-Defined in: [manager.ts:90](https://github.com/TanStack/keys/blob/main/packages/keys/src/manager.ts#L90)
+Defined in: [hotkey-manager.ts:177](https://github.com/TanStack/keys/blob/main/packages/keys/src/hotkey-manager.ts#L177)
 
 Resets the singleton instance. Useful for testing.
 

docs/reference/classes/HotkeyRecorder.md

@@ -87,7 +87,7 @@ Use this to subscribe to state changes or access current state.
 cancel(): void;
 ```
 
-Defined in: [recorder.ts:212](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L212)
+Defined in: [recorder.ts:214](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L214)
 
 Cancel recording without saving.
 
@@ -106,7 +106,7 @@ the onCancel callback if provided.
 destroy(): void;
 ```
 
-Defined in: [recorder.ts:257](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L257)
+Defined in: [recorder.ts:259](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L259)
 
 Clean up event listeners and reset state.
 
@@ -168,7 +168,7 @@ a valid hotkey is recorded, Escape is pressed, or stop/cancel is called.
 stop(): void;
 ```
 
-Defined in: [recorder.ts:192](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L192)
+Defined in: [recorder.ts:194](https://github.com/TanStack/keys/blob/main/packages/keys/src/recorder.ts#L194)
 
 Stop recording (same as cancel, but doesn't call onCancel).
 

docs/reference/classes/KeyStateTracker.md

@@ -5,7 +5,7 @@ title: KeyStateTracker
 
 # Class: KeyStateTracker
 
-Defined in: [key-state.ts:63](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L63)
+Defined in: [key-state-tracker.ts:63](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L63)
 
 Singleton tracker for currently held keyboard keys.
 
@@ -49,7 +49,7 @@ unsubscribe()
 readonly store: Store<KeyStateTrackerState>;
 ```
 
-Defined in: [key-state.ts:70](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L70)
+Defined in: [key-state-tracker.ts:70](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L70)
 
 The TanStack Store instance containing the tracker state.
 Use this to subscribe to state changes or access current state.
@@ -62,7 +62,7 @@ Use this to subscribe to state changes or access current state.
 areAllKeysHeld(keys): boolean;
 ```
 
-Defined in: [key-state.ts:209](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L209)
+Defined in: [key-state-tracker.ts:209](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L209)
 
 Checks if all of the given keys are currently held.
 
@@ -88,7 +88,7 @@ True if all of the keys are currently held
 destroy(): void;
 ```
 
-Defined in: [key-state.ts:233](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L233)
+Defined in: [key-state-tracker.ts:233](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L233)
 
 Destroys the tracker and removes all listeners.
 
@@ -104,7 +104,7 @@ Destroys the tracker and removes all listeners.
 getHeldKeys(): string[];
 ```
 
-Defined in: [key-state.ts:178](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L178)
+Defined in: [key-state-tracker.ts:178](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L178)
 
 Gets an array of currently held key names.
 
@@ -122,7 +122,7 @@ Array of key names currently being pressed
 isAnyKeyHeld(keys): boolean;
 ```
 
-Defined in: [key-state.ts:199](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L199)
+Defined in: [key-state-tracker.ts:199](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L199)
 
 Checks if any of the given keys are currently held.
 
@@ -148,7 +148,7 @@ True if any of the keys are currently held
 isKeyHeld(key): boolean;
 ```
 
-Defined in: [key-state.ts:188](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L188)
+Defined in: [key-state-tracker.ts:188](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L188)
 
 Checks if a specific key is currently being held.
 
@@ -174,7 +174,7 @@ True if the key is currently held
 subscribe(listener): () => void;
 ```
 
-Defined in: [key-state.ts:220](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L220)
+Defined in: [key-state-tracker.ts:220](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L220)
 
 Subscribes to key state changes.
 
@@ -210,7 +210,7 @@ Use `tracker.store.subscribe()` or `useStore()` from `@tanstack/react-store` ins
 static getInstance(): KeyStateTracker;
 ```
 
-Defined in: [key-state.ts:86](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L86)
+Defined in: [key-state-tracker.ts:86](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L86)
 
 Gets the singleton instance of KeyStateTracker.
 
@@ -226,7 +226,7 @@ Gets the singleton instance of KeyStateTracker.
 static resetInstance(): void;
 ```
 
-Defined in: [key-state.ts:96](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state.ts#L96)
+Defined in: [key-state-tracker.ts:96](https://github.com/TanStack/keys/blob/main/packages/keys/src/key-state-tracker.ts#L96)
 
 Resets the singleton instance. Useful for testing.
 

docs/reference/classes/SequenceManager.md

@@ -5,7 +5,7 @@ title: SequenceManager
 
 # Class: SequenceManager
 
-Defined in: [sequence.ts:60](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L60)
+Defined in: [sequence.ts:79](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L79)
 
 Manages keyboard sequence matching for Vim-style shortcuts.
 
@@ -35,7 +35,7 @@ unregister()
 destroy(): void;
 ```
 
-Defined in: [sequence.ts:281](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L281)
+Defined in: [sequence.ts:300](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L300)
 
 Destroys the manager and removes all listeners.
 
@@ -51,7 +51,7 @@ Destroys the manager and removes all listeners.
 getRegistrationCount(): number;
 ```
 
-Defined in: [sequence.ts:274](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L274)
+Defined in: [sequence.ts:293](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L293)
 
 Gets the number of registered sequences.
 
@@ -70,7 +70,7 @@ register(
    options): () => void;
 ```
 
-Defined in: [sequence.ts:99](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L99)
+Defined in: [sequence.ts:118](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L118)
 
 Registers a hotkey sequence handler.
 
@@ -114,7 +114,7 @@ A function to unregister the sequence
 resetAll(): void;
 ```
 
-Defined in: [sequence.ts:264](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L264)
+Defined in: [sequence.ts:283](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L283)
 
 Resets all sequence progress.
 
@@ -130,7 +130,7 @@ Resets all sequence progress.
 static getInstance(): SequenceManager;
 ```
 
-Defined in: [sequence.ts:74](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L74)
+Defined in: [sequence.ts:93](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L93)
 
 Gets the singleton instance of SequenceManager.
 
@@ -146,7 +146,7 @@ Gets the singleton instance of SequenceManager.
 static resetInstance(): void;
 ```
 
-Defined in: [sequence.ts:84](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L84)
+Defined in: [sequence.ts:103](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L103)
 
 Resets the singleton instance. Useful for testing.
 

docs/reference/functions/createHotkeyHandler.md

@@ -12,7 +12,7 @@ function createHotkeyHandler(
    options): (event) => void;
 ```
 
-Defined in: [match.ts:96](https://github.com/TanStack/keys/blob/main/packages/keys/src/match.ts#L96)
+Defined in: [match.ts:122](https://github.com/TanStack/keys/blob/main/packages/keys/src/match.ts#L122)
 
 Creates a keyboard event handler that calls the callback when the hotkey matches.
 

docs/reference/functions/createMultiHotkeyHandler.md

@@ -9,7 +9,7 @@ title: createMultiHotkeyHandler
 function createMultiHotkeyHandler(handlers, options): (event) => void;
 ```
 
-Defined in: [match.ts:147](https://github.com/TanStack/keys/blob/main/packages/keys/src/match.ts#L147)
+Defined in: [match.ts:173](https://github.com/TanStack/keys/blob/main/packages/keys/src/match.ts#L173)
 
 Creates a handler that matches multiple hotkeys.
 

docs/reference/functions/createSequenceMatcher.md

@@ -9,7 +9,7 @@ title: createSequenceMatcher
 function createSequenceMatcher(sequence, options): object;
 ```
 
-Defined in: [sequence.ts:313](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L313)
+Defined in: [sequence.ts:332](https://github.com/TanStack/keys/blob/main/packages/keys/src/sequence.ts#L332)
 
 Creates a simple sequence matcher for one-off use.