@tanstack/hotkeys 0.9.0 → 0.10.0

package/dist/hotkey-recorder.js

@@ -49,14 +49,18 @@ import { Store } from "@tanstack/store";
 * ```
 */
 var HotkeyRecorder = class {
+	/**
+	* The TanStack Store instance containing the recorder state.
+	* Use this to subscribe to state changes or access current state.
+	*/
+	store = new Store({
+		isRecording: false,
+		recordedHotkey: null
+	});
 	#keydownHandler = null;
 	#options;
 	#platform;
 	constructor(options) {
-		this.store = new Store({
-			isRecording: false,
-			recordedHotkey: null
-		});
 		this.#options = options;
 		this.#platform = detectPlatform();
 	}
@@ -231,5 +235,4 @@ var HotkeyRecorder = class {
 };
 
 //#endregion
-export { HotkeyRecorder };
-//# sourceMappingURL=hotkey-recorder.js.map
+export { HotkeyRecorder };

package/dist/hotkey-sequence-recorder.d.ts

@@ -1,18 +1,17 @@
 import { HotkeySequence } from "./sequence-manager.js";
 import { HotkeySequenceRecorderValidationContext, RecorderOptions } from "./recorder-options.js";
 import { Store } from "@tanstack/store";
-
 //#region src/hotkey-sequence-recorder.d.ts
 /**
  * How the user can commit a recorded sequence from the keyboard.
  * - `'enter'`: plain Enter (no modifiers) commits when at least one step exists.
  * - `'none'`: only {@link HotkeySequenceRecorder.commit} finishes recording (or idle timeout if set).
  */
-type HotkeySequenceRecorderCommitKeys = 'enter' | 'none';
+export type HotkeySequenceRecorderCommitKeys = 'enter' | 'none';
 /**
  * State interface for the HotkeySequenceRecorder.
  */
-interface HotkeySequenceRecorderState {
+export interface HotkeySequenceRecorderState {
   /** Whether recording is currently active */
   isRecording: boolean;
   /** Chords captured so far in the current recording session */
@@ -23,7 +22,7 @@ interface HotkeySequenceRecorderState {
 /**
  * Options for configuring a HotkeySequenceRecorder instance.
  */
-interface HotkeySequenceRecorderOptions extends RecorderOptions {
+export interface HotkeySequenceRecorderOptions extends RecorderOptions {
   /** Validate the completed sequence. Rejection preserves the steps for editing. */
   validate?: (sequence: HotkeySequence, context: HotkeySequenceRecorderValidationContext) => boolean | string;
   /** Callback when a sequence is successfully recorded */
@@ -63,7 +62,7 @@ interface HotkeySequenceRecorderOptions extends RecorderOptions {
  * when {@link HotkeySequenceRecorderOptions.commitKeys} is `'enter'` (default), **Escape** to cancel,
  * **Backspace/Delete** to remove the last step or clear when empty.
  */
-declare class HotkeySequenceRecorder {
+export declare class HotkeySequenceRecorder {
   #private;
   readonly store: Store<HotkeySequenceRecorderState>;
   constructor(options: HotkeySequenceRecorderOptions);
@@ -81,6 +80,4 @@ declare class HotkeySequenceRecorder {
   cancel(): void;
   destroy(): void;
 }
-//#endregion
-export { HotkeySequenceRecorder, HotkeySequenceRecorderCommitKeys, HotkeySequenceRecorderOptions, HotkeySequenceRecorderState };
-//# sourceMappingURL=hotkey-sequence-recorder.d.ts.map
+//#endregion

package/dist/hotkey-sequence-recorder.js

@@ -26,17 +26,17 @@ function resolvedCommitOnEnter(options) {
 * **Backspace/Delete** to remove the last step or clear when empty.
 */
 var HotkeySequenceRecorder = class {
+	store = new Store({
+		isRecording: false,
+		steps: [],
+		recordedSequence: null
+	});
 	#keydownHandler = null;
 	#options;
 	#platform;
 	#events = [];
 	#idleTimer = null;
 	constructor(options) {
-		this.store = new Store({
-			isRecording: false,
-			steps: [],
-			recordedSequence: null
-		});
 		this.#options = {
 			...defaultHotkeySequenceRecorderOptions,
 			...options
@@ -251,5 +251,4 @@ var HotkeySequenceRecorder = class {
 };
 
 //#endregion
-export { HotkeySequenceRecorder };
-//# sourceMappingURL=hotkey-sequence-recorder.js.map
+export { HotkeySequenceRecorder };

package/dist/hotkey.types.d.ts

@@ -1,5 +1,4 @@
 import { CanonicalModifier, Key, LogicalKey } from "./key.types.js";
-
 //#region src/hotkey.types.d.ts
 /**
  * Single modifier + key combinations.
@@ -12,7 +11,7 @@ import { CanonicalModifier, Key, LogicalKey } from "./key.types.js";
  * This enables cross-platform hotkey definitions that automatically adapt to the platform.
  * For example, `Mod+S` becomes `Command+S` on Mac and `Ctrl+S` on Windows/Linux.
  */
-type SingleModifierHotkey = `Control+${Key}` | `Alt+${Key}` | `Shift+${Key}` | `Meta+${Key}` | `Mod+${Key}`;
+export type SingleModifierHotkey = `Control+${Key}` | `Alt+${Key}` | `Shift+${Key}` | `Meta+${Key}` | `Mod+${Key}`;
 /**
  * Two modifier + key combinations.
  *
@@ -22,7 +21,7 @@ type SingleModifierHotkey = `Control+${Key}` | `Alt+${Key}` | `Shift+${Key}` | `
  *   - `Mod+Control` duplicates `Control` on Windows/Linux (Mod = Control)
  *   - `Mod+Meta` duplicates `Meta` on macOS (Mod = Meta)
  */
-type TwoModifierHotkey = `Control+Alt+${Key}` | `Control+Shift+${Key}` | `Control+Meta+${Key}` | `Alt+Shift+${Key}` | `Alt+Meta+${Key}` | `Shift+Meta+${Key}` | `Mod+Alt+${Key}` | `Mod+Shift+${Key}`;
+export type TwoModifierHotkey = `Control+Alt+${Key}` | `Control+Shift+${Key}` | `Control+Meta+${Key}` | `Alt+Shift+${Key}` | `Alt+Meta+${Key}` | `Shift+Meta+${Key}` | `Mod+Alt+${Key}` | `Mod+Shift+${Key}`;
 /**
  * Three modifier + key combinations.
  *
@@ -32,7 +31,7 @@ type TwoModifierHotkey = `Control+Alt+${Key}` | `Control+Shift+${Key}` | `Contro
  *   - `Mod+Control+Shift` duplicates `Control` on Windows/Linux (Mod = Control)
  *   - `Mod+Shift+Meta` duplicates `Meta` on macOS (Mod = Meta)
  */
-type ThreeModifierHotkey = `Control+Alt+Shift+${Key}` | `Control+Alt+Meta+${Key}` | `Control+Shift+Meta+${Key}` | `Alt+Shift+Meta+${Key}` | `Mod+Alt+Shift+${Key}`;
+export type ThreeModifierHotkey = `Control+Alt+Shift+${Key}` | `Control+Alt+Meta+${Key}` | `Control+Shift+Meta+${Key}` | `Alt+Shift+Meta+${Key}` | `Mod+Alt+Shift+${Key}`;
 /**
  * Four modifier + key combinations.
  *
@@ -45,7 +44,7 @@ type ThreeModifierHotkey = `Control+Alt+Shift+${Key}` | `Control+Alt+Meta+${Key}
  * - `Mod+Control+Alt+Shift` → duplicates `Control` on Windows/Linux
  * - `Mod+Alt+Shift+Meta` → duplicates `Meta` on macOS
  */
-type FourModifierHotkey = `Control+Alt+Shift+Meta+${Key}`;
+export type FourModifierHotkey = `Control+Alt+Shift+Meta+${Key}`;
 /**
  * A type-safe hotkey string.
  *
@@ -98,9 +97,9 @@ type FourModifierHotkey = `Control+Alt+Shift+Meta+${Key}`;
  * const windowsOnly: Hotkey = 'Control+S' // Ctrl+S on Windows/Linux only
  * ```
  */
-type Hotkey = Key | SingleModifierHotkey | TwoModifierHotkey | ThreeModifierHotkey | FourModifierHotkey;
+export type Hotkey = Key | SingleModifierHotkey | TwoModifierHotkey | ThreeModifierHotkey | FourModifierHotkey;
 /** Resolved modifier flags shared by both parsed binding variants. */
-interface ParsedModifiers {
+export interface ParsedModifiers {
   /** Whether Control is required. */
   ctrl: boolean;
   /** Whether Shift is required. */
@@ -121,7 +120,7 @@ interface ParsedModifiers {
  * parseHotkey('Alt+S') // { key: 'S', alt: true, ... }
  * parseHotkey('Alt+[KeyS]') // { code: 'KeyS', alt: true, ... } — no key property
  */
-type ParsedHotkey = ParsedModifiers & ({
+export type ParsedHotkey = ParsedModifiers & ({
   key: LogicalKey | (string & {});
   code?: never;
 } | {
@@ -151,7 +150,7 @@ type ParsedHotkey = ParsedModifiers & ({
  * ```
  */
 /** Modifier flags shared by logical-key and physical-code registrations. */
-interface RawModifiers {
+export interface RawModifiers {
   /** The non-modifier key (e.g., 'S', 'Escape', 'F1'). */
   /** Platform-adaptive modifier: Command on macOS, Control on Windows/Linux. Defaults to false. */
   mod?: boolean;
@@ -164,7 +163,7 @@ interface RawModifiers {
   /** Whether the Meta (Command) key is required. Defaults to false. */
   meta?: boolean;
 }
-type RawHotkey = ({
+export type RawHotkey = ({
   key: LogicalKey | (string & {});
   code?: never;
 } & RawModifiers) | ({
@@ -175,11 +174,11 @@ type RawHotkey = ({
  * A hotkey that can be passed to `HotkeyManager.register()` and `useHotkey()`.
  * Either a type-safe string (`Hotkey`) or a raw object (`RawHotkey`).
  */
-type RegisterableHotkey = Hotkey | RawHotkey;
+export type RegisterableHotkey = Hotkey | RawHotkey;
 /**
  * Context passed to hotkey callbacks along with the keyboard event.
  */
-interface HotkeyCallbackContext {
+export interface HotkeyCallbackContext {
   /** The original hotkey string that was registered */
   hotkey: Hotkey;
   /** The parsed representation of the hotkey */
@@ -199,7 +198,7 @@ interface HotkeyCallbackContext {
  * }
  * ```
  */
-type HotkeyCallback = (event: KeyboardEvent, context: HotkeyCallbackContext) => void;
+export type HotkeyCallback = (event: KeyboardEvent, context: HotkeyCallbackContext) => void;
 /**
  * Metadata for hotkey and sequence registrations.
  * Includes `name`, `description`, and `group` by default. Extend via declaration merging:
@@ -214,7 +213,7 @@ type HotkeyCallback = (event: KeyboardEvent, context: HotkeyCallbackContext) =>
  * }
  * ```
  */
-interface HotkeyMeta {
+export interface HotkeyMeta {
   /** Human-readable name for this hotkey (e.g., "Save Document") */
   name?: string;
   /** Description of what this hotkey does */
@@ -230,7 +229,5 @@ interface HotkeyMeta {
  * - `'replace'` - Unregister the existing registration and register the new one
  * - `'allow'` - Allow multiple registrations without warning
  */
-type ConflictBehavior = 'warn' | 'error' | 'replace' | 'allow';
-//#endregion
-export { ConflictBehavior, FourModifierHotkey, Hotkey, HotkeyCallback, HotkeyCallbackContext, HotkeyMeta, ParsedHotkey, ParsedModifiers, RawHotkey, RawModifiers, RegisterableHotkey, SingleModifierHotkey, ThreeModifierHotkey, TwoModifierHotkey };
-//# sourceMappingURL=hotkey.types.d.ts.map
+export type ConflictBehavior = 'warn' | 'error' | 'replace' | 'allow';
+//#endregion

package/dist/key-state-tracker.d.ts

@@ -1,10 +1,9 @@
 import { Store } from "@tanstack/store";
-
 //#region src/key-state-tracker.d.ts
 /**
  * State interface for the KeyStateTracker.
  */
-interface KeyStateTrackerState {
+export interface KeyStateTrackerState {
   /**
    * Array of currently held key names (normalized, e.g. "Control", "A").
    */
@@ -49,7 +48,7 @@ interface KeyStateTrackerState {
  * unsubscribe()
  * ```
  */
-declare class KeyStateTracker {
+export declare class KeyStateTracker {
   #private;
   /**
    * The TanStack Store instance containing the tracker state.
@@ -101,7 +100,5 @@ declare class KeyStateTracker {
  * Gets the singleton KeyStateTracker instance.
  * Convenience function for accessing the tracker.
  */
-declare function getKeyStateTracker(): KeyStateTracker;
-//#endregion
-export { KeyStateTracker, KeyStateTrackerState, getKeyStateTracker };
-//# sourceMappingURL=key-state-tracker.d.ts.map
+export declare function getKeyStateTracker(): KeyStateTracker;
+//#endregion

package/dist/key-state-tracker.js

@@ -47,12 +47,16 @@ function getDefaultKeyStateTrackerState() {
 */
 var KeyStateTracker = class KeyStateTracker {
 	static #instance = null;
+	/**
+	* The TanStack Store instance containing the tracker state.
+	* Use this to subscribe to state changes or access current state.
+	*/
+	store = new Store(getDefaultKeyStateTrackerState());
 	#heldEntries = /* @__PURE__ */ new Map();
 	#keydownListener = null;
 	#keyupListener = null;
 	#blurListener = null;
 	constructor() {
-		this.store = new Store(getDefaultKeyStateTrackerState());
 		this.#setupListeners();
 	}
 	/**
@@ -192,5 +196,4 @@ function getKeyStateTracker() {
 }
 
 //#endregion
-export { KeyStateTracker, getKeyStateTracker };
-//# sourceMappingURL=key-state-tracker.js.map
+export { KeyStateTracker, getKeyStateTracker };

package/dist/key.types.d.ts

@@ -1,5 +1,4 @@
 import { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS } from "./_named-keys.js";
-
 //#region src/key.types.d.ts
 /**
  * All supported modifier key names, including aliases.
@@ -9,40 +8,40 @@ import { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS } from "./_named-keys.js";
  * - Command/Cmd: The Command key (macOS only)
  * - CommandOrControl/Mod: Command on macOS, Control on other platforms
  */
-type Modifier = 'Control' | 'Ctrl' | 'Shift' | 'Alt' | 'Option' | 'Command' | 'Cmd' | 'CommandOrControl' | 'Mod';
+export type Modifier = 'Control' | 'Ctrl' | 'Shift' | 'Alt' | 'Option' | 'Command' | 'Cmd' | 'CommandOrControl' | 'Mod';
 /**
  * Canonical modifier names that map to KeyboardEvent properties.
  */
-type CanonicalModifier = 'Control' | 'Shift' | 'Alt' | 'Meta';
+export type CanonicalModifier = 'Control' | 'Shift' | 'Alt' | 'Meta';
 /**
  * Letter keys A-Z (case-insensitive in matching).
  */
-type LetterKey = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
+export type LetterKey = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
 /**
  * Number keys 0-9.
  */
-type NumberKey = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+export type NumberKey = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
 /**
  * Function keys F1-F24, supported as both logical keys and physical codes.
  */
-type FunctionKey = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24';
+export type FunctionKey = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24';
 /**
  * Navigation keys for cursor movement.
  */
-type NavigationKey = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
+export type NavigationKey = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
 /**
  * Editing and special keys.
  */
-type EditingKey = 'Enter' | 'Escape' | 'Space' | 'Tab' | 'Backspace' | 'Delete';
+export type EditingKey = 'Enter' | 'Escape' | 'Space' | 'Tab' | 'Backspace' | 'Delete';
 /**
  * Printable punctuation glyphs used in keyboard shortcuts. Matching uses the
  * final KeyboardEvent.key glyph, independent of which layout produced it.
  */
-type PunctuationKey = '/' | '[' | ']' | '\\' | '=' | '-' | ',' | '.' | ';' | '`' | "'" | '+' | '?' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '*' | '(' | ')' | '_' | '{' | '}' | '|' | ':' | '"' | '<' | '>' | '~';
+export type PunctuationKey = '/' | '[' | ']' | '\\' | '=' | '-' | ',' | '.' | ';' | '`' | "'" | '+' | '?' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '*' | '(' | ')' | '_' | '{' | '}' | '|' | ':' | '"' | '<' | '>' | '~';
 /** Additional named logical keys, including media, browser, lock, and input-mode keys. */
-type NamedKey = (typeof SHARED_NAMED_KEYS)[number] | (typeof LOGICAL_ONLY_NAMED_KEYS)[number];
+export type NamedKey = (typeof SHARED_NAMED_KEYS)[number] | (typeof LOGICAL_ONLY_NAMED_KEYS)[number];
 /** Supported logical key names other than printable punctuation. */
-type NonPunctuationKey = LetterKey | NumberKey | EditingKey | NavigationKey | FunctionKey | NamedKey;
+export type NonPunctuationKey = LetterKey | NumberKey | EditingKey | NavigationKey | FunctionKey | NamedKey;
 /**
  * Supported physical KeyboardEvent.code names, independent of keyboard layout.
  * Letter, digit, numpad, and sided modifier names use finite template unions.
@@ -50,23 +49,23 @@ type NonPunctuationKey = LetterKey | NumberKey | EditingKey | NavigationKey | Fu
  *
  * @see https://www.w3.org/TR/uievents-code/
  */
-type PhysicalKeyCode = `Key${LetterKey}` | `Digit${NumberKey}` | `Numpad${NumberKey}` | `${'Alt' | 'Control' | 'Meta' | 'Shift'}${'Left' | 'Right'}` | EditingKey | NavigationKey | FunctionKey | (typeof SHARED_NAMED_KEYS)[number] | 'Backquote' | 'Backslash' | 'BracketLeft' | 'BracketRight' | 'Comma' | 'Equal' | 'IntlBackslash' | 'IntlRo' | 'IntlYen' | 'Minus' | 'Period' | 'Quote' | 'Semicolon' | 'Slash' | `Lang${1 | 2 | 3 | 4 | 5}` | `Numpad${'Add' | 'Backspace' | 'Clear' | 'ClearEntry' | 'Comma' | 'Decimal' | 'Divide' | 'Enter' | 'Equal' | 'Hash' | 'MemoryAdd' | 'MemoryClear' | 'MemoryRecall' | 'MemoryStore' | 'MemorySubtract' | 'Multiply' | 'ParenLeft' | 'ParenRight' | 'Star' | 'Subtract'}` | 'LaunchApp1' | 'LaunchApp2' | 'MediaSelect' | 'Sleep' | 'Turbo' | 'Abort' | 'Resume' | 'Suspend';
+export type PhysicalKeyCode = `Key${LetterKey}` | `Digit${NumberKey}` | `Numpad${NumberKey}` | `${'Alt' | 'Control' | 'Meta' | 'Shift'}${'Left' | 'Right'}` | EditingKey | NavigationKey | FunctionKey | (typeof SHARED_NAMED_KEYS)[number] | 'Backquote' | 'Backslash' | 'BracketLeft' | 'BracketRight' | 'Comma' | 'Equal' | 'IntlBackslash' | 'IntlRo' | 'IntlYen' | 'Minus' | 'Period' | 'Quote' | 'Semicolon' | 'Slash' | `Lang${1 | 2 | 3 | 4 | 5}` | `Numpad${'Add' | 'Backspace' | 'Clear' | 'ClearEntry' | 'Comma' | 'Decimal' | 'Divide' | 'Enter' | 'Equal' | 'Hash' | 'MemoryAdd' | 'MemoryClear' | 'MemoryRecall' | 'MemoryStore' | 'MemorySubtract' | 'Multiply' | 'ParenLeft' | 'ParenRight' | 'Star' | 'Subtract'}` | 'LaunchApp1' | 'LaunchApp2' | 'MediaSelect' | 'Sleep' | 'Turbo' | 'Abort' | 'Resume' | 'Suspend';
 /**
  * An explicit physical key token. All codes use brackets, including names such
  * as `[Enter]` that also exist as logical keys. Invalid code names are rejected
  * by TypeScript, and supported names are available in autocomplete.
  */
-type PhysicalKey = `[${PhysicalKeyCode}]`;
+export type PhysicalKey = `[${PhysicalKeyCode}]`;
 /** Supported logical key names, excluding bracketed physical-code syntax. */
-type LogicalKey = NonPunctuationKey | PunctuationKey;
+export type LogicalKey = NonPunctuationKey | PunctuationKey;
 /** All supported logical keys and bracketed physical key tokens. */
-type Key = LogicalKey | PhysicalKey;
+export type Key = LogicalKey | PhysicalKey;
 /**
  * Includes both modifier keys and regular keys.
  */
-type IndividualKey = CanonicalModifier | Key;
+export type IndividualKey = CanonicalModifier | Key;
 /** Keyboard event properties normalized for internal matching and recording. */
-interface NormalizedKeyboardEvent {
+export interface NormalizedKeyboardEvent {
   key: string;
   code: string;
   ctrl: boolean;
@@ -77,6 +76,4 @@ interface NormalizedKeyboardEvent {
   location: number;
   isComposing: boolean;
 }
-//#endregion
-export { CanonicalModifier, EditingKey, FunctionKey, IndividualKey, Key, LetterKey, LogicalKey, Modifier, NamedKey, NavigationKey, NonPunctuationKey, NormalizedKeyboardEvent, NumberKey, PhysicalKey, PhysicalKeyCode, PunctuationKey };
-//# sourceMappingURL=key.types.d.ts.map
+//#endregion

package/dist/match.d.ts

@@ -1,7 +1,6 @@
 import { Hotkey, HotkeyCallback, ParsedHotkey, RegisterableHotkey } from "./hotkey.types.js";
-
 //#region src/match.d.ts
-interface KeyboardEventMatch {
+export interface KeyboardEventMatch {
   matched: boolean;
   score: 0 | 1 | 2 | 3;
   source?: 'key' | 'code' | 'fallback';
@@ -39,11 +38,11 @@ interface KeyboardEventMatch {
  * })
  * ```
  */
-declare function matchesKeyboardEvent(event: KeyboardEvent, hotkey: Hotkey | ParsedHotkey, platform?: 'mac' | 'windows' | 'linux'): boolean;
+export declare function matchesKeyboardEvent(event: KeyboardEvent, hotkey: Hotkey | ParsedHotkey, platform?: 'mac' | 'windows' | 'linux'): boolean;
 /**
  * Options for creating a hotkey handler.
  */
-interface CreateHotkeyHandlerOptions {
+export interface CreateHotkeyHandlerOptions {
   /** Prevent the default browser action when the hotkey matches. Defaults to true */
   preventDefault?: boolean;
   /** Stop event propagation when the hotkey matches. Defaults to true */
@@ -69,8 +68,8 @@ interface CreateHotkeyHandlerOptions {
  * document.addEventListener('keydown', handler)
  * ```
  */
-declare function createHotkeyHandler(hotkey: Hotkey | ParsedHotkey, callback: HotkeyCallback, options?: CreateHotkeyHandlerOptions): (event: KeyboardEvent) => void;
-type MultiHotkeyHandler = { [K in Hotkey]?: HotkeyCallback };
+export declare function createHotkeyHandler(hotkey: Hotkey | ParsedHotkey, callback: HotkeyCallback, options?: CreateHotkeyHandlerOptions): (event: KeyboardEvent) => void;
+export type MultiHotkeyHandler = { [K in Hotkey]?: HotkeyCallback; };
 /**
  * Creates a handler that matches multiple hotkeys.
  *
@@ -89,13 +88,11 @@ type MultiHotkeyHandler = { [K in Hotkey]?: HotkeyCallback };
  * document.addEventListener('keydown', handler)
  * ```
  */
-declare function createMultiHotkeyHandler(handlers: MultiHotkeyHandler, options?: CreateHotkeyHandlerOptions): (event: KeyboardEvent) => void;
+export declare function createMultiHotkeyHandler(handlers: MultiHotkeyHandler, options?: CreateHotkeyHandlerOptions): (event: KeyboardEvent) => void;
 /**
  * Compares normalized binding identity, including all four modifiers.
  * Aliases resolve on the supplied platform. A physical code and a logical key
  * remain distinct even when one keyboard event could match both.
  */
-declare function areHotkeysEqual(left: RegisterableHotkey, right: RegisterableHotkey, platform?: "mac" | "windows" | "linux"): boolean;
-//#endregion
-export { CreateHotkeyHandlerOptions, KeyboardEventMatch, MultiHotkeyHandler, areHotkeysEqual, createHotkeyHandler, createMultiHotkeyHandler, matchesKeyboardEvent };
-//# sourceMappingURL=match.d.ts.map
+export declare function areHotkeysEqual(left: RegisterableHotkey, right: RegisterableHotkey, platform?: "mac" | "windows" | "linux"): boolean;
+//#endregion

package/dist/match.js

@@ -137,5 +137,4 @@ function areHotkeysEqual(left, right, platform = detectPlatform()) {
 }
 
 //#endregion
-export { areHotkeysEqual, createHotkeyHandler, createMultiHotkeyHandler, matchesKeyboardEvent };
-//# sourceMappingURL=match.js.map
+export { areHotkeysEqual, createHotkeyHandler, createMultiHotkeyHandler, matchesKeyboardEvent };

package/dist/parse.d.ts

@@ -1,7 +1,6 @@
 import { Key } from "./key.types.js";
 import { MODIFIER_ALIASES } from "./constants.js";
 import { Hotkey, ParsedHotkey, RawHotkey, RegisterableHotkey } from "./hotkey.types.js";
-
 //#region src/parse.d.ts
 /**
  * Parses a hotkey string into its component parts.
@@ -17,7 +16,7 @@ import { Hotkey, ParsedHotkey, RawHotkey, RegisterableHotkey } from "./hotkey.ty
  * parseHotkey('Control+Shift+A') // { key: 'A', ctrl: true, shift: true, alt: false, meta: false, modifiers: ['Control', 'Shift'] }
  * ```
  */
-declare function parseHotkey(hotkey: Hotkey | (string & {}), platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
+export declare function parseHotkey(hotkey: Hotkey | (string & {}), platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
 /**
  * Converts a RawHotkey object to a ParsedHotkey.
  * Optional modifier booleans default to false; modifiers array is derived from them.
@@ -39,7 +38,7 @@ declare function parseHotkey(hotkey: Hotkey | (string & {}), platform?: 'mac' |
  * // { key: 'S', ctrl: true, shift: true, alt: false, meta: false, modifiers: ['Control', 'Shift'] }
  * ```
  */
-declare function rawHotkeyToParsedHotkey(raw: RawHotkey, platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
+export declare function rawHotkeyToParsedHotkey(raw: RawHotkey, platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
 /**
  * Normalizes a hotkey string to its canonical form.
  *
@@ -60,16 +59,16 @@ declare function rawHotkeyToParsedHotkey(raw: RawHotkey, platform?: 'mac' | 'win
  * normalizeHotkey('esc') // 'Escape'
  * ```
  */
-declare function normalizeHotkey(hotkey: Key | (string & {}), platform?: 'mac' | 'windows' | 'linux'): Hotkey;
+export declare function normalizeHotkey(hotkey: Key | (string & {}), platform?: 'mac' | 'windows' | 'linux'): Hotkey;
 /**
  * Same canonical string as {@link normalizeHotkey}, but from an already-parsed hotkey.
  */
-declare function normalizeHotkeyFromParsed(parsed: ParsedHotkey, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
+export declare function normalizeHotkeyFromParsed(parsed: ParsedHotkey, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
 /**
  * Normalizes a string or {@link RawHotkey} object to the same canonical hotkey string.
  * Use this in framework adapters instead of branching on `formatHotkey(rawHotkeyToParsedHotkey(...))`.
  */
-declare function normalizeRegisterableHotkey(hotkey: RegisterableHotkey, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
+export declare function normalizeRegisterableHotkey(hotkey: RegisterableHotkey, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
 /**
  * Checks if a string is a recognized modifier token (including aliases).
  *
@@ -79,7 +78,7 @@ declare function normalizeRegisterableHotkey(hotkey: RegisterableHotkey, platfor
  * @param key - Key name or alias (e.g. from a hotkey string or `event.key`)
  * @returns True if the string is a recognized modifier
  */
-declare function isModifierKey(key: Key | (string & {})): key is keyof typeof MODIFIER_ALIASES;
+export declare function isModifierKey(key: Key | (string & {})): key is keyof typeof MODIFIER_ALIASES;
 /**
  * Parses a KeyboardEvent into a ParsedHotkey object.
  *
@@ -98,14 +97,14 @@ declare function isModifierKey(key: Key | (string & {})): key is keyof typeof MO
  * })
  * ```
  */
-declare function parseKeyboardEvent(event: KeyboardEvent, platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
+export declare function parseKeyboardEvent(event: KeyboardEvent, platform?: 'mac' | 'windows' | 'linux'): ParsedHotkey;
 /**
  * Normalizes a keyboard event to the same canonical hotkey string as {@link normalizeHotkey}.
  *
  * @param event - The keyboard event (typically `keydown`)
  * @param platform - Target platform for `Mod` eligibility
  */
-declare function normalizeHotkeyFromEvent(event: KeyboardEvent, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
+export declare function normalizeHotkeyFromEvent(event: KeyboardEvent, platform?: 'mac' | 'windows' | 'linux'): Hotkey;
 /**
  * Checks if a hotkey or ParsedHotkey contains at least one non-modifier key.
  *
@@ -123,12 +122,10 @@ declare function normalizeHotkeyFromEvent(event: KeyboardEvent, platform?: 'mac'
  * hasNonModifierKey(parseHotkey('Mod+A')) // true
  * ```
  */
-declare function hasNonModifierKey(hotkey: Hotkey | ParsedHotkey | (string & {}), platform?: 'mac' | 'windows' | 'linux'): boolean;
+export declare function hasNonModifierKey(hotkey: Hotkey | ParsedHotkey | (string & {}), platform?: 'mac' | 'windows' | 'linux'): boolean;
 /**
  * Parses a string or raw binding, resolving Mod for the supplied platform.
  * Physical tokens such as `[KeyQ]` retain `code`; they never become logical Q.
  */
-declare function parseRegisterableHotkey(hotkey: RegisterableHotkey, platform?: "mac" | "windows" | "linux"): ParsedHotkey;
-//#endregion
-export { hasNonModifierKey, isModifierKey, normalizeHotkey, normalizeHotkeyFromEvent, normalizeHotkeyFromParsed, normalizeRegisterableHotkey, parseHotkey, parseKeyboardEvent, parseRegisterableHotkey, rawHotkeyToParsedHotkey };
-//# sourceMappingURL=parse.d.ts.map
+export declare function parseRegisterableHotkey(hotkey: RegisterableHotkey, platform?: "mac" | "windows" | "linux"): ParsedHotkey;
+//#endregion

package/dist/parse.js

@@ -70,8 +70,10 @@ function rawHotkeyToParsedHotkey(raw, platform = detectPlatform()) {
 	const shift = raw.shift ?? false;
 	const alt = raw.alt ?? false;
 	let meta = raw.meta ?? false;
-	if (raw.mod) if (resolveModifier("Mod", platform) === "Control") ctrl = true;
-	else meta = true;
+	if (raw.mod) {
+		if (resolveModifier("Mod", platform) === "Control") ctrl = true;
+		else meta = true;
+	}
 	const modifiers = MODIFIER_ORDER.filter((m) => {
 		switch (m) {
 			case "Control": return ctrl;
@@ -232,5 +234,4 @@ function parseRegisterableHotkey(hotkey, platform = detectPlatform()) {
 }
 
 //#endregion
-export { hasNonModifierKey, isModifierKey, normalizeHotkey, normalizeHotkeyFromEvent, normalizeHotkeyFromParsed, normalizeRegisterableHotkey, parseHotkey, parseKeyboardEvent, parseRegisterableHotkey, rawHotkeyToParsedHotkey };
-//# sourceMappingURL=parse.js.map
+export { hasNonModifierKey, isModifierKey, normalizeHotkey, normalizeHotkeyFromEvent, normalizeHotkeyFromParsed, normalizeRegisterableHotkey, parseHotkey, parseKeyboardEvent, parseRegisterableHotkey, rawHotkeyToParsedHotkey };

package/dist/platform.d.ts

@@ -1,5 +1,4 @@
 import { CanonicalModifier } from "./key.types.js";
-
 //#region src/platform.d.ts
 /**
  * Detects the current platform based on browser navigator properties.
@@ -16,7 +15,7 @@ import { CanonicalModifier } from "./key.types.js";
  * const modifier = resolveModifier('Mod', platform) // 'Meta' on Mac, 'Control' elsewhere
  * ```
  */
-declare function detectPlatform(): 'mac' | 'windows' | 'linux';
+export declare function detectPlatform(): 'mac' | 'windows' | 'linux';
 /**
  * Resolves the platform-adaptive 'Mod' modifier to the appropriate canonical modifier.
  *
@@ -38,7 +37,5 @@ declare function detectPlatform(): 'mac' | 'windows' | 'linux';
  * resolveModifier('Control', 'mac') // 'Control' (unchanged)
  * ```
  */
-declare function resolveModifier(modifier: CanonicalModifier | 'Mod', platform?: 'mac' | 'windows' | 'linux'): CanonicalModifier;
-//#endregion
-export { detectPlatform, resolveModifier };
-//# sourceMappingURL=platform.d.ts.map
+export declare function resolveModifier(modifier: CanonicalModifier | 'Mod', platform?: 'mac' | 'windows' | 'linux'): CanonicalModifier;
+//#endregion

package/dist/platform.js

@@ -49,5 +49,4 @@ function resolveModifier(modifier, platform = detectPlatform()) {
 }
 
 //#endregion
-export { detectPlatform, resolveModifier };
-//# sourceMappingURL=platform.js.map
+export { detectPlatform, resolveModifier };

package/dist/recorder-options.d.ts

@@ -1,17 +1,16 @@
 import { Hotkey, ParsedHotkey } from "./hotkey.types.js";
 import { HotkeyConflict, HotkeyConflictOptions } from "./conflicts.js";
-
 //#region src/recorder-options.d.ts
 /** Event property used to record a binding. Physical codes are the default. */
-type RecorderKeyMode = 'code' | 'key';
-interface RecorderRejection {
+export type RecorderKeyMode = 'code' | 'key';
+export interface RecorderRejection {
   reason: 'missing-code' | 'alt-graph' | 'invalid' | 'conflict' | 'validation';
   message: string;
   hotkey?: Hotkey;
   sequence?: Array<Hotkey>;
   conflicts?: Array<HotkeyConflict>;
 }
-interface RecorderOptions {
+export interface RecorderOptions {
   /** Physical code recording is the default. Choose key to record logical characters. */
   recordBy?: RecorderKeyMode;
   /** Platform used for Mod and AltGraph handling. Defaults to platform detection. */
@@ -21,14 +20,12 @@ interface RecorderOptions {
   /** Rejected candidates leave recording active. */
   onReject?: (rejection: RecorderRejection) => void;
 }
-interface HotkeyRecorderValidationContext {
+export interface HotkeyRecorderValidationContext {
   event: KeyboardEvent;
   parsedHotkey: ParsedHotkey;
 }
-interface HotkeySequenceRecorderValidationContext {
+export interface HotkeySequenceRecorderValidationContext {
   events: ReadonlyArray<KeyboardEvent>;
   parsedSequence: ReadonlyArray<ParsedHotkey>;
 }
-//#endregion
-export { HotkeyRecorderValidationContext, HotkeySequenceRecorderValidationContext, RecorderKeyMode, RecorderOptions, RecorderRejection };
-//# sourceMappingURL=recorder-options.d.ts.map
+//#endregion