@tanstack/hotkeys 0.9.0 → 0.10.0

package/dist/_event-target.js

@@ -67,5 +67,4 @@ function isEventForTarget(event, target) {
 }
 
 //#endregion
-export { isEventForTarget, shouldIgnoreInputEvent };
-//# sourceMappingURL=_event-target.js.map
+export { getActiveElementForListenerTarget, isEventForTarget, isInputElement, shouldIgnoreInputEvent };

package/dist/_keyboard-event.js

@@ -72,5 +72,4 @@ function assertLogicalKey(key) {
 }
 
 //#endregion
-export { assertLogicalKey, codeToLogicalKey, isAsciiLetter, isLatinLetter, isPrintableKey, keysEqual, normalizeKeyboardEvent, splitHotkeyParts };
-//# sourceMappingURL=_keyboard-event.js.map
+export { assertLogicalKey, codeToLogicalKey, isAsciiLetter, isLatinLetter, isPrintableKey, keysEqual, normalizeKeyboardEvent, splitHotkeyParts };

package/dist/_match.js

@@ -45,5 +45,4 @@ function modifiersMatch(event, parsed, allowImplicitShift) {
 }
 
 //#endregion
-export { matchKeyboardEvent };
-//# sourceMappingURL=_match.js.map
+export { matchKeyboardEvent };

package/dist/_named-keys.d.ts

@@ -1,8 +1,6 @@
 //#region src/_named-keys.d.ts
 /** Names defined for both KeyboardEvent.key and KeyboardEvent.code, beyond the basic key groups. */
-declare const SHARED_NAMED_KEYS: readonly ["CapsLock", "ContextMenu", "Convert", "KanaMode", "NonConvert", "Help", "Insert", "NumLock", "Fn", "FnLock", "PrintScreen", "ScrollLock", "Pause", "BrowserBack", "BrowserFavorites", "BrowserForward", "BrowserHome", "BrowserRefresh", "BrowserSearch", "BrowserStop", "Eject", "LaunchMail", "MediaPlayPause", "MediaStop", "MediaTrackNext", "MediaTrackPrevious", "Power", "AudioVolumeDown", "AudioVolumeMute", "AudioVolumeUp", "WakeUp", "Hyper", "Super", "Again", "Copy", "Cut", "Find", "Open", "Paste", "Props", "Select", "Undo", "Hiragana", "Katakana"];
+export declare const SHARED_NAMED_KEYS: readonly ["CapsLock", "ContextMenu", "Convert", "KanaMode", "NonConvert", "Help", "Insert", "NumLock", "Fn", "FnLock", "PrintScreen", "ScrollLock", "Pause", "BrowserBack", "BrowserFavorites", "BrowserForward", "BrowserHome", "BrowserRefresh", "BrowserSearch", "BrowserStop", "Eject", "LaunchMail", "MediaPlayPause", "MediaStop", "MediaTrackNext", "MediaTrackPrevious", "Power", "AudioVolumeDown", "AudioVolumeMute", "AudioVolumeUp", "WakeUp", "Hyper", "Super", "Again", "Copy", "Cut", "Find", "Open", "Paste", "Props", "Select", "Undo", "Hiragana", "Katakana"];
 /** Logical counterparts whose physical positions use different names (for example Sleep and Lang1). */
-declare const LOGICAL_ONLY_NAMED_KEYS: readonly ["Clear", "Cancel", "Standby", "LaunchApplication1", "LaunchApplication2", "LaunchMediaPlayer", "HangulMode", "HanjaMode", "Zenkaku", "Hankaku", "ZenkakuHankaku"];
-//#endregion
-export { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS };
-//# sourceMappingURL=_named-keys.d.ts.map
+export declare const LOGICAL_ONLY_NAMED_KEYS: readonly ["Clear", "Cancel", "Standby", "LaunchApplication1", "LaunchApplication2", "LaunchMediaPlayer", "HangulMode", "HanjaMode", "Zenkaku", "Hankaku", "ZenkakuHankaku"];
+//#endregion

package/dist/_named-keys.js

@@ -62,5 +62,4 @@ const LOGICAL_ONLY_NAMED_KEYS = [
 ];
 
 //#endregion
-export { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS };
-//# sourceMappingURL=_named-keys.js.map
+export { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS };

package/dist/_recorder-chord.js

@@ -39,5 +39,4 @@ function chordRejection(event, options) {
 }
 
 //#endregion
-export { chordRejection, hotkeyChordFromKeydown };
-//# sourceMappingURL=_recorder-chord.js.map
+export { chordRejection, hotkeyChordFromKeydown };

package/dist/_recording-guard.js

@@ -52,5 +52,4 @@ function isRecordingEvent(event) {
 }
 
 //#endregion
-export { beginRecording, captureRecordingEvent, endRecording, isRecordingEvent };
-//# sourceMappingURL=_recording-guard.js.map
+export { beginRecording, captureRecordingEvent, endRecording, isRecordingEvent };

package/dist/_registration.js

@@ -46,5 +46,4 @@ function optionsEqual(left, right) {
 }
 
 //#endregion
-export { defaultHotkeyOptions, getDefaultIgnoreInputs, handleConflict, optionsEqual };
-//# sourceMappingURL=_registration.js.map
+export { defaultHotkeyOptions, getDefaultIgnoreInputs, handleConflict, optionsEqual };

package/dist/conflicts.d.ts

@@ -1,16 +1,15 @@
 import { RegisterableHotkey } from "./hotkey.types.js";
 import { HotkeyRegistrationView } from "./hotkey-manager.js";
 import { SequenceRegistrationView } from "./sequence-manager.js";
-
 //#region src/conflicts.d.ts
-type HotkeyConflict = {
+export type HotkeyConflict = {
   type: 'hotkey';
   registration: HotkeyRegistrationView;
 } | {
   type: 'sequence';
   registration: SequenceRegistrationView;
 };
-interface HotkeyConflictOptions {
+export interface HotkeyConflictOptions {
   /** Intended registration target. Defaults to document; disjoint targets are excluded. */
   target?: HTMLElement | Document | Window;
   /** Check all targets instead of overlapping targets. Default: overlapping. */
@@ -33,7 +32,5 @@ interface HotkeyConflictOptions {
  * With source events, also checks observed logical/physical overlap. Does not
  * discover unmounted handlers, external listeners, or other keyboard layouts.
  */
-declare function findHotkeyConflicts(candidate: RegisterableHotkey | ReadonlyArray<RegisterableHotkey>, options?: HotkeyConflictOptions): Array<HotkeyConflict>;
-//#endregion
-export { HotkeyConflict, HotkeyConflictOptions, findHotkeyConflicts };
-//# sourceMappingURL=conflicts.d.ts.map
+export declare function findHotkeyConflicts(candidate: RegisterableHotkey | ReadonlyArray<RegisterableHotkey>, options?: HotkeyConflictOptions): Array<HotkeyConflict>;
+//#endregion

package/dist/conflicts.js

@@ -51,5 +51,4 @@ function findHotkeyConflicts(candidate, options = {}) {
 }
 
 //#endregion
-export { findHotkeyConflicts };
-//# sourceMappingURL=conflicts.js.map
+export { findHotkeyConflicts };

package/dist/constants.d.ts

@@ -1,5 +1,4 @@
 import { CanonicalModifier, EditingKey, FunctionKey, LetterKey, NavigationKey, NumberKey, PunctuationKey } from "./key.types.js";
-
 //#region src/constants.d.ts
 /**
  * Canonical order for modifiers in normalized hotkey strings.
@@ -15,7 +14,7 @@ import { CanonicalModifier, EditingKey, FunctionKey, LetterKey, NavigationKey, N
  * // Normalized: 'Control+Alt+Shift+Meta+S' (following MODIFIER_ORDER)
  * ```
  */
-declare const MODIFIER_ORDER: Array<CanonicalModifier>;
+export declare const MODIFIER_ORDER: Array<CanonicalModifier>;
 /**
  * Set of canonical modifier key names for fast lookup.
  *
@@ -23,7 +22,7 @@ declare const MODIFIER_ORDER: Array<CanonicalModifier>;
  * a modifier is released so we can clear non-modifier keys whose keyup events
  * may have been swallowed by the OS (e.g. macOS Cmd+key combos).
  */
-declare const MODIFIER_KEYS: Set<string>;
+export declare const MODIFIER_KEYS: Set<string>;
 /**
  * Maps modifier key aliases to their canonical form or platform-adaptive 'Mod'.
  *
@@ -43,14 +42,14 @@ declare const MODIFIER_KEYS: Set<string>;
  * MODIFIER_ALIASES['Mod'] // 'Mod' (resolved at runtime)
  * ```
  */
-declare const MODIFIER_ALIASES: Record<string, CanonicalModifier | 'Mod'>;
+export declare const MODIFIER_ALIASES: Record<string, CanonicalModifier | 'Mod'>;
 /**
  * Set of all valid letter keys (A-Z).
  *
  * Used for validation and type checking. Letter keys are matched case-insensitively
  * in hotkey matching, but normalized to uppercase in canonical form.
  */
-declare const LETTER_KEYS: Set<LetterKey>;
+export declare const LETTER_KEYS: Set<LetterKey>;
 /**
  * Set of all valid number keys (0-9).
  *
@@ -58,14 +57,14 @@ declare const LETTER_KEYS: Set<LetterKey>;
  * so they're excluded from Shift-based hotkey combinations to avoid
  * layout-dependent behavior.
  */
-declare const NUMBER_KEYS: Set<NumberKey>;
+export declare const NUMBER_KEYS: Set<NumberKey>;
 /**
  * Set of all valid function keys (F1-F24).
  *
  * Function keys are commonly used for system shortcuts (e.g., F12 for DevTools,
  * Alt+F4 to close windows) and application-specific commands.
  */
-declare const FUNCTION_KEYS: Set<FunctionKey>;
+export declare const FUNCTION_KEYS: Set<FunctionKey>;
 /**
  * Set of all valid navigation keys for cursor movement and document navigation.
  *
@@ -73,7 +72,7 @@ declare const FUNCTION_KEYS: Set<FunctionKey>;
  * These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or
  * navigation shortcuts (Alt+ArrowLeft for back).
  */
-declare const NAVIGATION_KEYS: Set<NavigationKey>;
+export declare const NAVIGATION_KEYS: Set<NavigationKey>;
 /**
  * Set of all valid editing and special keys.
  *
@@ -81,7 +80,7 @@ declare const NAVIGATION_KEYS: Set<NavigationKey>;
  * special actions (Escape, Space). These keys are frequently combined with modifiers
  * for editor shortcuts (Mod+Enter to submit, Shift+Tab to go back).
  */
-declare const EDITING_KEYS: Set<EditingKey>;
+export declare const EDITING_KEYS: Set<EditingKey>;
 /**
  * Set of all valid punctuation keys commonly used in keyboard shortcuts.
  *
@@ -94,7 +93,7 @@ declare const EDITING_KEYS: Set<EditingKey>;
  * Note: Punctuation keys are affected by Shift (Shift+',' → '<' on US layout),
  * so they're excluded from Shift-based hotkey combinations to avoid layout-dependent behavior.
  */
-declare const PUNCTUATION_KEYS: Set<PunctuationKey>;
+export declare const PUNCTUATION_KEYS: Set<PunctuationKey>;
 /**
  * Maps `KeyboardEvent.code` values for punctuation keys to their canonical characters.
  *
@@ -104,7 +103,7 @@ declare const PUNCTUATION_KEYS: Set<PunctuationKey>;
  * falling back to `event.code` for punctuation keys, similar to the existing `Key*`/`Digit*`
  * fallbacks for letters and digits.
  */
-declare const PUNCTUATION_CODE_MAP: Record<string, string>;
+export declare const PUNCTUATION_CODE_MAP: Record<string, string>;
 /**
  * Set of all valid non-modifier keys.
  *
@@ -119,7 +118,7 @@ declare const PUNCTUATION_CODE_MAP: Record<string, string>;
  * @see {@link EDITING_KEYS}
  * @see {@link PUNCTUATION_KEYS}
  */
-declare const ALL_KEYS: Set<LetterKey | NumberKey | FunctionKey | NavigationKey | EditingKey | PunctuationKey | "CapsLock" | "ContextMenu" | "Convert" | "KanaMode" | "NonConvert" | "Help" | "Insert" | "NumLock" | "Fn" | "FnLock" | "PrintScreen" | "ScrollLock" | "Pause" | "BrowserBack" | "BrowserFavorites" | "BrowserForward" | "BrowserHome" | "BrowserRefresh" | "BrowserSearch" | "BrowserStop" | "Eject" | "LaunchMail" | "MediaPlayPause" | "MediaStop" | "MediaTrackNext" | "MediaTrackPrevious" | "Power" | "AudioVolumeDown" | "AudioVolumeMute" | "AudioVolumeUp" | "WakeUp" | "Hyper" | "Super" | "Again" | "Copy" | "Cut" | "Find" | "Open" | "Paste" | "Props" | "Select" | "Undo" | "Hiragana" | "Katakana" | "Clear" | "Cancel" | "Standby" | "LaunchApplication1" | "LaunchApplication2" | "LaunchMediaPlayer" | "HangulMode" | "HanjaMode" | "Zenkaku" | "Hankaku" | "ZenkakuHankaku">;
+export declare const ALL_KEYS: Set<LetterKey | NumberKey | FunctionKey | NavigationKey | EditingKey | PunctuationKey | "CapsLock" | "ContextMenu" | "Convert" | "KanaMode" | "NonConvert" | "Help" | "Insert" | "NumLock" | "Fn" | "FnLock" | "PrintScreen" | "ScrollLock" | "Pause" | "BrowserBack" | "BrowserFavorites" | "BrowserForward" | "BrowserHome" | "BrowserRefresh" | "BrowserSearch" | "BrowserStop" | "Eject" | "LaunchMail" | "MediaPlayPause" | "MediaStop" | "MediaTrackNext" | "MediaTrackPrevious" | "Power" | "AudioVolumeDown" | "AudioVolumeMute" | "AudioVolumeUp" | "WakeUp" | "Hyper" | "Super" | "Again" | "Copy" | "Cut" | "Find" | "Open" | "Paste" | "Props" | "Select" | "Undo" | "Hiragana" | "Katakana" | "Clear" | "Cancel" | "Standby" | "LaunchApplication1" | "LaunchApplication2" | "LaunchMediaPlayer" | "HangulMode" | "HanjaMode" | "Zenkaku" | "Hankaku" | "ZenkakuHankaku">;
 /**
  * Normalizes a key name to its canonical form.
  *
@@ -144,7 +143,7 @@ declare const ALL_KEYS: Set<LetterKey | NumberKey | FunctionKey | NavigationKey
  * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)
  * ```
  */
-declare function isSingleLetterKey(key: string): boolean;
+export declare function isSingleLetterKey(key: string): boolean;
 /**
  * Normalizes a key name to its canonical form.
  *
@@ -159,7 +158,5 @@ declare function isSingleLetterKey(key: string): boolean;
  * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)
  * ```
  */
-declare function normalizeKeyName(key: string): string;
-//#endregion
-export { ALL_KEYS, EDITING_KEYS, FUNCTION_KEYS, LETTER_KEYS, MODIFIER_ALIASES, MODIFIER_KEYS, MODIFIER_ORDER, NAVIGATION_KEYS, NUMBER_KEYS, PUNCTUATION_CODE_MAP, PUNCTUATION_KEYS, isSingleLetterKey, normalizeKeyName };
-//# sourceMappingURL=constants.d.ts.map
+export declare function normalizeKeyName(key: string): string;
+//#endregion

package/dist/constants.js

@@ -80,7 +80,7 @@ const MODIFIER_ALIASES = {
 * Used for validation and type checking. Letter keys are matched case-insensitively
 * in hotkey matching, but normalized to uppercase in canonical form.
 */
-const LETTER_KEYS = new Set([
+const LETTER_KEYS = /* @__PURE__ */ new Set([
 	"A",
 	"B",
 	"C",
@@ -115,7 +115,7 @@ const LETTER_KEYS = new Set([
 * so they're excluded from Shift-based hotkey combinations to avoid
 * layout-dependent behavior.
 */
-const NUMBER_KEYS = new Set([
+const NUMBER_KEYS = /* @__PURE__ */ new Set([
 	"0",
 	"1",
 	"2",
@@ -133,7 +133,7 @@ const NUMBER_KEYS = new Set([
 * Function keys are commonly used for system shortcuts (e.g., F12 for DevTools,
 * Alt+F4 to close windows) and application-specific commands.
 */
-const FUNCTION_KEYS = new Set([
+const FUNCTION_KEYS = /* @__PURE__ */ new Set([
 	"F1",
 	"F2",
 	"F3",
@@ -166,7 +166,7 @@ const FUNCTION_KEYS = new Set([
 * These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or
 * navigation shortcuts (Alt+ArrowLeft for back).
 */
-const NAVIGATION_KEYS = new Set([
+const NAVIGATION_KEYS = /* @__PURE__ */ new Set([
 	"ArrowUp",
 	"ArrowDown",
 	"ArrowLeft",
@@ -183,7 +183,7 @@ const NAVIGATION_KEYS = new Set([
 * special actions (Escape, Space). These keys are frequently combined with modifiers
 * for editor shortcuts (Mod+Enter to submit, Shift+Tab to go back).
 */
-const EDITING_KEYS = new Set([
+const EDITING_KEYS = /* @__PURE__ */ new Set([
 	"Enter",
 	"Escape",
 	"Space",
@@ -203,7 +203,7 @@ const EDITING_KEYS = new Set([
 * Note: Punctuation keys are affected by Shift (Shift+',' → '<' on US layout),
 * so they're excluded from Shift-based hotkey combinations to avoid layout-dependent behavior.
 */
-const PUNCTUATION_KEYS = new Set([
+const PUNCTUATION_KEYS = /* @__PURE__ */ new Set([
 	"/",
 	"[",
 	"]",
@@ -273,7 +273,7 @@ const PUNCTUATION_CODE_MAP = {
 * @see {@link EDITING_KEYS}
 * @see {@link PUNCTUATION_KEYS}
 */
-const ALL_KEYS = new Set([
+const ALL_KEYS = /* @__PURE__ */ new Set([
 	...LETTER_KEYS,
 	...NUMBER_KEYS,
 	...FUNCTION_KEYS,
@@ -394,5 +394,4 @@ function normalizeKeyName(key) {
 }
 
 //#endregion
-export { ALL_KEYS, EDITING_KEYS, FUNCTION_KEYS, LETTER_KEYS, MODIFIER_ALIASES, MODIFIER_KEYS, MODIFIER_ORDER, NAVIGATION_KEYS, NUMBER_KEYS, PUNCTUATION_CODE_MAP, PUNCTUATION_KEYS, isSingleLetterKey, normalizeKeyName };
-//# sourceMappingURL=constants.js.map
+export { ALL_KEYS, EDITING_KEYS, FUNCTION_KEYS, LETTER_KEYS, MODIFIER_ALIASES, MODIFIER_KEYS, MODIFIER_ORDER, NAVIGATION_KEYS, NUMBER_KEYS, PUNCTUATION_CODE_MAP, PUNCTUATION_KEYS, isSingleLetterKey, normalizeKeyName };

package/dist/display-labels.d.ts

@@ -1,5 +1,4 @@
 import { CanonicalModifier } from "./key.types.js";
-
 //#region src/display-labels.d.ts
 /**
  * Modifier key symbols for macOS display.
@@ -16,7 +15,7 @@ import { CanonicalModifier } from "./key.types.js";
  * MAC_MODIFIER_SYMBOLS['Shift'] // '⇧'
  * ```
  */
-declare const MAC_MODIFIER_SYMBOLS: Record<CanonicalModifier | 'Mod', string>;
+export declare const MAC_MODIFIER_SYMBOLS: Record<CanonicalModifier | 'Mod', string>;
 /**
  * Modifier key labels for macOS display.
  *
@@ -32,7 +31,7 @@ declare const MAC_MODIFIER_SYMBOLS: Record<CanonicalModifier | 'Mod', string>;
  * MAC_MODIFIER_LABELS['Meta'] // 'cmd'
  * ```
  */
-declare const MAC_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
+export declare const MAC_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
 /**
  * Modifier key labels for Windows/Linux display.
  *
@@ -48,9 +47,9 @@ declare const MAC_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
  * STANDARD_MODIFIER_LABELS['Shift'] // 'Shift'
  * ```
  */
-declare const WINDOWS_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
-declare const LINUX_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
-declare const PUNCTUATION_KEY_DISPLAY_LABELS: {
+export declare const WINDOWS_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
+export declare const LINUX_MODIFIER_LABELS: Record<CanonicalModifier | 'Mod', string>;
+export declare const PUNCTUATION_KEY_DISPLAY_LABELS: {
   readonly '`': "Backquote";
   readonly '\\': "Backslash";
   readonly '[': "Left Bracket";
@@ -76,7 +75,7 @@ declare const PUNCTUATION_KEY_DISPLAY_LABELS: {
  * KEY_DISPLAY_SYMBOLS['Space'] // '␣'
  * ```
  */
-declare const KEY_DISPLAY_SYMBOLS: {
+export declare const KEY_DISPLAY_SYMBOLS: {
   readonly ArrowUp: "↑";
   readonly ArrowDown: "↓";
   readonly ArrowLeft: "←";
@@ -88,6 +87,4 @@ declare const KEY_DISPLAY_SYMBOLS: {
   readonly Tab: "⇥";
   readonly Space: "␣";
 };
-//#endregion
-export { KEY_DISPLAY_SYMBOLS, LINUX_MODIFIER_LABELS, MAC_MODIFIER_LABELS, MAC_MODIFIER_SYMBOLS, PUNCTUATION_KEY_DISPLAY_LABELS, WINDOWS_MODIFIER_LABELS };
-//# sourceMappingURL=display-labels.d.ts.map
+//#endregion

package/dist/display-labels.js

@@ -109,5 +109,4 @@ const KEY_DISPLAY_SYMBOLS = {
 };
 
 //#endregion
-export { KEY_DISPLAY_SYMBOLS, LINUX_MODIFIER_LABELS, MAC_MODIFIER_LABELS, MAC_MODIFIER_SYMBOLS, PUNCTUATION_KEY_DISPLAY_LABELS, WINDOWS_MODIFIER_LABELS };
-//# sourceMappingURL=display-labels.js.map
+export { KEY_DISPLAY_SYMBOLS, LINUX_MODIFIER_LABELS, MAC_MODIFIER_LABELS, MAC_MODIFIER_SYMBOLS, PUNCTUATION_KEY_DISPLAY_LABELS, WINDOWS_MODIFIER_LABELS };

package/dist/format.d.ts

@@ -1,5 +1,4 @@
 import { Hotkey, ParsedHotkey, RegisterableHotkey } from "./hotkey.types.js";
-
 //#region src/format.d.ts
 /**
  * Joins stored sequence steps with spaces, preserving physical code tokens.
@@ -14,7 +13,7 @@ import { Hotkey, ParsedHotkey, RegisterableHotkey } from "./hotkey.types.js";
  * formatHotkeySequence(['D', 'I', 'W']) // 'D I W'
  * ```
  */
-declare function formatHotkeySequence(sequence: Array<Hotkey>): string;
+export declare function formatHotkeySequence(sequence: Array<Hotkey>): string;
 /**
  * Converts a ParsedHotkey back to a hotkey string.
  *
@@ -27,8 +26,8 @@ declare function formatHotkeySequence(sequence: Array<Hotkey>): string;
  * // Returns: 'Control+Shift+S'
  * ```
  */
-declare function formatHotkey(parsed: ParsedHotkey): string;
-type DisplayHotkey = RegisterableHotkey | ParsedHotkey | (string & {});
+export declare function formatHotkey(parsed: ParsedHotkey): string;
+export type DisplayHotkey = RegisterableHotkey | ParsedHotkey | (string & {});
 /**
  * Formats a hotkey for display in a user interface.
  *
@@ -56,21 +55,21 @@ type DisplayHotkey = RegisterableHotkey | ParsedHotkey | (string & {});
  * // Returns: 'Esc' (on all platforms)
  * ```
  */
-declare function formatForDisplay(hotkey: DisplayHotkey, options: FormatDisplayOptions & {
+export declare function formatForDisplay(hotkey: DisplayHotkey, options: FormatDisplayOptions & {
   parts: true;
 }): Array<string>;
-declare function formatForDisplay(hotkey: DisplayHotkey, options?: FormatDisplayOptions & {
+export declare function formatForDisplay(hotkey: DisplayHotkey, options?: FormatDisplayOptions & {
   parts?: false;
 }): string;
-declare function formatForDisplay(hotkey: DisplayHotkey, options: FormatDisplayOptions): string | Array<string>;
+export declare function formatForDisplay(hotkey: DisplayHotkey, options: FormatDisplayOptions): string | Array<string>;
 /**
  * @deprecated Use {@link formatForDisplay} instead with `useSymbols: false` option.
  */
-declare function formatWithLabels(hotkey: RegisterableHotkey, options?: Omit<FormatDisplayOptions, 'useSymbols' | 'parts'>): string;
+export declare function formatWithLabels(hotkey: RegisterableHotkey, options?: Omit<FormatDisplayOptions, 'useSymbols' | 'parts'>): string;
 /**
  * Options for formatting hotkeys for display.
  */
-interface FormatDisplayOptions {
+export interface FormatDisplayOptions {
   /** The target platform. Defaults to auto-detection. */
   platform?: 'mac' | 'windows' | 'linux';
   /** Whether to use symbols for the display. Defaults to true. */
@@ -94,6 +93,4 @@ interface FormatDisplayOptions {
   /** Override the separator between display tokens. Defaults to platform-specific formatting when null/undefined. */
   separatorToken?: string | null;
 }
-//#endregion
-export { DisplayHotkey, FormatDisplayOptions, formatForDisplay, formatHotkey, formatHotkeySequence, formatWithLabels };
-//# sourceMappingURL=format.d.ts.map
+//#endregion

package/dist/format.js

@@ -46,7 +46,8 @@ function formatForDisplay(hotkey, options = {}) {
 	const modifierSymbols = typeof symbols === "boolean" ? symbols : symbols.modifiers ?? true;
 	const keySymbols = typeof symbols === "boolean" ? symbols : symbols.keys ?? true;
 	const separator = options.separatorToken ?? (platform === "mac" && modifierSymbols ? " " : "+");
-	const parts = splitHotkeyParts(typeof hotkey === "object" && "modifiers" in hotkey ? normalizeHotkeyFromParsed(hotkey, platform) : normalizeRegisterableHotkey(hotkey, platform)).map((segment) => {
+	const normalized = typeof hotkey === "object" && "modifiers" in hotkey ? normalizeHotkeyFromParsed(hotkey, platform) : normalizeRegisterableHotkey(hotkey, platform);
+	const parts = splitHotkeyParts(normalized).map((segment) => {
 		if (isModifierKey(segment)) {
 			const modifier = MODIFIER_ALIASES[segment] ?? MODIFIER_ALIASES[segment.toLowerCase()];
 			return platform === "mac" ? modifierSymbols ? MAC_MODIFIER_SYMBOLS[modifier] : MAC_MODIFIER_LABELS[modifier] : platform === "windows" ? WINDOWS_MODIFIER_LABELS[modifier] : LINUX_MODIFIER_LABELS[modifier];
@@ -58,10 +59,12 @@ function formatForDisplay(hotkey, options = {}) {
 		let displayKey = code ?? segment;
 		const mappedKey = code ? options.layoutMap?.get(code) : void 0;
 		if (mappedKey) displayKey = normalizeKeyName(mappedKey);
-		else if (code) if (/^Key[A-Z]$/.test(code)) displayKey = code.slice(3);
-		else if (/^Digit[0-9]$/.test(code)) displayKey = code.slice(5);
-		else if (numpad) displayKey = code.slice(6);
-		else displayKey = PUNCTUATION_CODE_MAP[code] ?? code;
+		else if (code) {
+			if (/^Key[A-Z]$/.test(code)) displayKey = code.slice(3);
+			else if (/^Digit[0-9]$/.test(code)) displayKey = code.slice(5);
+			else if (numpad) displayKey = code.slice(6);
+			else displayKey = PUNCTUATION_CODE_MAP[code] ?? code;
+		}
 		const display = (keySymbols ? KEY_DISPLAY_SYMBOLS : PUNCTUATION_KEY_DISPLAY_LABELS)[displayKey] ?? displayKey;
 		return numpad ? `Numpad ${display.replace(/([a-z])([A-Z])/g, "$1 $2")}` : display;
 	});
@@ -78,5 +81,4 @@ function formatWithLabels(hotkey, options = {}) {
 }
 
 //#endregion
-export { formatForDisplay, formatHotkey, formatHotkeySequence, formatWithLabels };
-//# sourceMappingURL=format.js.map
+export { formatForDisplay, formatHotkey, formatHotkeySequence, formatWithLabels };

package/dist/hint.d.ts

@@ -1,7 +1,6 @@
 import { RegisterableHotkey } from "./hotkey.types.js";
-
 //#region src/hint.d.ts
-interface HeldModifierOptions {
+export interface HeldModifierOptions {
   /** Resolve Mod for this platform. Defaults to platform detection. */
   platform?: 'mac' | 'windows' | 'linux';
   /** Require every binding modifier to be held. Default: false (nonempty subset). */
@@ -17,7 +16,5 @@ interface HeldModifierOptions {
  * matchesHeldModifiers('Alt+Shift+[KeyK]', ['Alt']) // true
  * matchesHeldModifiers('Alt+Shift+[KeyK]', ['Alt', 'Control']) // false
  */
-declare function matchesHeldModifiers(hotkey: RegisterableHotkey, heldKeys: ReadonlyArray<string>, options?: HeldModifierOptions): boolean;
-//#endregion
-export { HeldModifierOptions, matchesHeldModifiers };
-//# sourceMappingURL=hint.d.ts.map
+export declare function matchesHeldModifiers(hotkey: RegisterableHotkey, heldKeys: ReadonlyArray<string>, options?: HeldModifierOptions): boolean;
+//#endregion

package/dist/hint.js

@@ -20,5 +20,4 @@ function matchesHeldModifiers(hotkey, heldKeys, options = {}) {
 }
 
 //#endregion
-export { matchesHeldModifiers };
-//# sourceMappingURL=hint.js.map
+export { matchesHeldModifiers };

package/dist/hotkey-manager.d.ts

@@ -1,11 +1,10 @@
 import { ConflictBehavior, Hotkey, HotkeyCallback, HotkeyMeta, ParsedHotkey, RegisterableHotkey } from "./hotkey.types.js";
 import { Store } from "@tanstack/store";
-
 //#region src/hotkey-manager.d.ts
 /**
  * Options for registering a hotkey.
  */
-interface HotkeyOptions {
+export interface HotkeyOptions {
   /** Behavior when this hotkey conflicts with an existing registration on the same target. Defaults to 'warn' */
   conflictBehavior?: ConflictBehavior;
   /**
@@ -34,7 +33,7 @@ interface HotkeyOptions {
 /**
  * A registered hotkey handler in the HotkeyManager.
  */
-interface HotkeyRegistration {
+export interface HotkeyRegistration {
   /** The callback to invoke */
   callback: HotkeyCallback;
   /** Whether this registration has fired and needs reset (for requireReset) */
@@ -61,7 +60,7 @@ interface HotkeyRegistration {
  * Public view of a hotkey registration for display and introspection.
  * Omits the callback function which is an internal implementation detail.
  */
-interface HotkeyRegistrationView {
+export interface HotkeyRegistrationView {
   /** The original hotkey string */
   hotkey: Hotkey;
   /** Unique identifier for this registration */
@@ -81,7 +80,7 @@ interface HotkeyRegistrationView {
  * Creates a public view from an internal registration,
  * stripping the callback function.
  */
-declare function toHotkeyRegistrationView(reg: HotkeyRegistration): HotkeyRegistrationView;
+export declare function toHotkeyRegistrationView(reg: HotkeyRegistration): HotkeyRegistrationView;
 /**
  * A handle returned from HotkeyManager.register() that allows updating
  * the callback and options without re-registering the hotkey.
@@ -105,7 +104,7 @@ declare function toHotkeyRegistrationView(reg: HotkeyRegistration): HotkeyRegist
  * handle.unregister()
  * ```
  */
-interface HotkeyRegistrationHandle {
+export interface HotkeyRegistrationHandle {
   /**
    * The callback function. Can be set directly to update without re-registering.
    * This avoids stale closures when the callback references React state.
@@ -142,7 +141,7 @@ interface HotkeyRegistrationHandle {
  * unregister()
  * ```
  */
-declare class HotkeyManager {
+export declare class HotkeyManager {
   #private;
   /**
    * The TanStack Store containing all hotkey registrations.
@@ -228,7 +227,6 @@ declare class HotkeyManager {
  * Gets the singleton HotkeyManager instance.
  * Convenience function for accessing the manager.
  */
-declare function getHotkeyManager(): HotkeyManager;
+export declare function getHotkeyManager(): HotkeyManager;
 //#endregion
-export { HotkeyManager, HotkeyOptions, HotkeyRegistration, HotkeyRegistrationHandle, HotkeyRegistrationView, getHotkeyManager, toHotkeyRegistrationView };
-//# sourceMappingURL=hotkey-manager.d.ts.map
+export type { ConflictBehavior };

package/dist/hotkey-manager.js

@@ -53,11 +53,30 @@ function generateId() {
 */
 var HotkeyManager = class HotkeyManager {
 	static #instance = null;
+	/**
+	* The TanStack Store containing all hotkey registrations.
+	* Use this to subscribe to registration changes or access current registrations.
+	*
+	* @example
+	* ```ts
+	* const manager = HotkeyManager.getInstance()
+	*
+	* // Subscribe to registration changes
+	* const unsubscribe = manager.registrations.subscribe(() => {
+	*   console.log('Registrations changed:', manager.registrations.state.size)
+	* })
+	*
+	* // Access current registrations
+	* for (const [id, reg] of manager.registrations.state) {
+	*   console.log(reg.hotkey, reg.options.enabled)
+	* }
+	* ```
+	*/
+	registrations = new Store(/* @__PURE__ */ new Map());
 	#platform;
 	#targetListeners = /* @__PURE__ */ new Map();
 	#targetRegistrations = /* @__PURE__ */ new Map();
 	constructor() {
-		this.registrations = new Store(/* @__PURE__ */ new Map());
 		this.#platform = detectPlatform();
 	}
 	/**
@@ -408,5 +427,4 @@ function getHotkeyManager() {
 }
 
 //#endregion
-export { HotkeyManager, getHotkeyManager, toHotkeyRegistrationView };
-//# sourceMappingURL=hotkey-manager.js.map
+export { HotkeyManager, getHotkeyManager, toHotkeyRegistrationView };

package/dist/hotkey-recorder.d.ts

@@ -1,12 +1,11 @@
 import { Hotkey } from "./hotkey.types.js";
 import { HotkeyRecorderValidationContext, RecorderOptions } from "./recorder-options.js";
 import { Store } from "@tanstack/store";
-
 //#region src/hotkey-recorder.d.ts
 /**
  * State interface for the HotkeyRecorder.
  */
-interface HotkeyRecorderState {
+export interface HotkeyRecorderState {
   /** Whether recording is currently active */
   isRecording: boolean;
   /** The currently recorded hotkey (for live preview) */
@@ -15,7 +14,7 @@ interface HotkeyRecorderState {
 /**
  * Options for configuring a HotkeyRecorder instance.
  */
-interface HotkeyRecorderOptions extends RecorderOptions {
+export interface HotkeyRecorderOptions extends RecorderOptions {
   /** Return true to accept, or false/a message to reject while staying in recording mode. */
   validate?: (hotkey: Hotkey, context: HotkeyRecorderValidationContext) => boolean | string;
   /** Callback when a hotkey is successfully recorded */
@@ -72,7 +71,7 @@ interface HotkeyRecorderOptions extends RecorderOptions {
  * unsubscribe()
  * ```
  */
-declare class HotkeyRecorder {
+export declare class HotkeyRecorder {
   #private;
   /**
    * The TanStack Store instance containing the recorder state.
@@ -114,6 +113,4 @@ declare class HotkeyRecorder {
    */
   destroy(): void;
 }
-//#endregion
-export { HotkeyRecorder, HotkeyRecorderOptions, HotkeyRecorderState };
-//# sourceMappingURL=hotkey-recorder.d.ts.map
+//#endregion