@tanstack/hotkeys 0.9.0 → 0.10.0

package/dist/constants.cjs

@@ -1,410 +0,0 @@
-const require__named_keys = require('./_named-keys.cjs');
-
-//#region src/constants.ts
-/**
-* Canonical order for modifiers in normalized hotkey strings.
-*
-* Defines the standard order in which modifiers should appear when formatting
-* hotkeys. This ensures consistent, predictable output across the library.
-*
-* Order: Control → Alt → Shift → Meta
-*
-* @example
-* ```ts
-* // Input: 'Shift+Control+Meta+S'
-* // Normalized: 'Control+Alt+Shift+Meta+S' (following MODIFIER_ORDER)
-* ```
-*/
-const MODIFIER_ORDER = [
-	"Control",
-	"Alt",
-	"Shift",
-	"Meta"
-];
-/**
-* Set of canonical modifier key names for fast lookup.
-*
-* Derived from `MODIFIER_ORDER` to ensure consistency. Used to detect when
-* 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).
-*/
-const MODIFIER_KEYS = new Set(MODIFIER_ORDER);
-/**
-* Maps modifier key aliases to their canonical form or platform-adaptive 'Mod'.
-*
-* This map allows users to write hotkeys using various aliases (e.g., 'Ctrl', 'Cmd', 'Option')
-* which are then normalized to canonical names ('Control', 'Meta', 'Alt') or the
-* platform-adaptive 'Mod' token.
-*
-* The 'Mod' and 'CommandOrControl' aliases are resolved at runtime via `resolveModifier()`
-* based on the detected platform (Command on Mac, Control elsewhere).
-*
-* @remarks Case-insensitive lookups are supported via lowercase variants
-*
-* @example
-* ```ts
-* MODIFIER_ALIASES['Ctrl'] // 'Control'
-* MODIFIER_ALIASES['Cmd'] // 'Meta'
-* MODIFIER_ALIASES['Mod'] // 'Mod' (resolved at runtime)
-* ```
-*/
-const MODIFIER_ALIASES = {
-	Control: "Control",
-	Ctrl: "Control",
-	control: "Control",
-	ctrl: "Control",
-	Shift: "Shift",
-	shift: "Shift",
-	Alt: "Alt",
-	Option: "Alt",
-	alt: "Alt",
-	option: "Alt",
-	Command: "Meta",
-	Cmd: "Meta",
-	Meta: "Meta",
-	command: "Meta",
-	cmd: "Meta",
-	meta: "Meta",
-	OS: "Meta",
-	os: "Meta",
-	Win: "Meta",
-	win: "Meta",
-	CommandOrControl: "Mod",
-	Mod: "Mod",
-	commandorcontrol: "Mod",
-	mod: "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.
-*/
-const LETTER_KEYS = new Set([
-	"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"
-]);
-/**
-* Set of all valid number keys (0-9).
-*
-* Note: Number keys are affected by Shift (Shift+1 → '!' on US layout),
-* so they're excluded from Shift-based hotkey combinations to avoid
-* layout-dependent behavior.
-*/
-const NUMBER_KEYS = new Set([
-	"0",
-	"1",
-	"2",
-	"3",
-	"4",
-	"5",
-	"6",
-	"7",
-	"8",
-	"9"
-]);
-/**
-* 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.
-*/
-const FUNCTION_KEYS = new Set([
-	"F1",
-	"F2",
-	"F3",
-	"F4",
-	"F5",
-	"F6",
-	"F7",
-	"F8",
-	"F9",
-	"F10",
-	"F11",
-	"F12",
-	"F13",
-	"F14",
-	"F15",
-	"F16",
-	"F17",
-	"F18",
-	"F19",
-	"F20",
-	"F21",
-	"F22",
-	"F23",
-	"F24"
-]);
-/**
-* Set of all valid navigation keys for cursor movement and document navigation.
-*
-* Includes arrow keys, Home/End (line navigation), and PageUp/PageDown (page navigation).
-* These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or
-* navigation shortcuts (Alt+ArrowLeft for back).
-*/
-const NAVIGATION_KEYS = new Set([
-	"ArrowUp",
-	"ArrowDown",
-	"ArrowLeft",
-	"ArrowRight",
-	"Home",
-	"End",
-	"PageUp",
-	"PageDown"
-]);
-/**
-* Set of all valid editing and special keys.
-*
-* Includes keys commonly used for text editing (Enter, Backspace, Delete, Tab) and
-* 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([
-	"Enter",
-	"Escape",
-	"Space",
-	"Tab",
-	"Backspace",
-	"Delete"
-]);
-/**
-* Set of all valid punctuation keys commonly used in keyboard shortcuts.
-*
-* These are the literal characters as they appear in `KeyboardEvent.key` (layout-dependent,
-* typically US keyboard layout). Common shortcuts include:
-* - `Mod+/` - Toggle comment
-* - `Mod+[` / `Mod+]` - Indent/outdent
-* - `Mod+=` / `Mod+-` - Zoom in/out
-*
-* 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([
-	"/",
-	"[",
-	"]",
-	"\\",
-	"=",
-	"-",
-	",",
-	".",
-	";",
-	"`",
-	"'",
-	"+",
-	"?",
-	"!",
-	"@",
-	"#",
-	"$",
-	"%",
-	"^",
-	"&",
-	"*",
-	"(",
-	")",
-	"_",
-	"{",
-	"}",
-	"|",
-	":",
-	"\"",
-	"<",
-	">",
-	"~"
-]);
-/**
-* Maps `KeyboardEvent.code` values for punctuation keys to their canonical characters.
-*
-* On macOS, holding the Option (Alt) key transforms punctuation keys into special characters
-* (e.g., Option+Minus → en-dash '–'), causing `event.key` to differ from the expected character.
-* However, `event.code` still reports the physical key (e.g., 'Minus'). This map enables
-* falling back to `event.code` for punctuation keys, similar to the existing `Key*`/`Digit*`
-* fallbacks for letters and digits.
-*/
-const PUNCTUATION_CODE_MAP = {
-	Backquote: "`",
-	Backslash: "\\",
-	BracketLeft: "[",
-	BracketRight: "]",
-	Comma: ",",
-	Equal: "=",
-	Minus: "-",
-	Period: ".",
-	Quote: "'",
-	Semicolon: ";",
-	Slash: "/"
-};
-/**
-* Set of all valid non-modifier keys.
-*
-* This is the union of all key type sets (letters, numbers, function keys, navigation,
-* editing, and punctuation). Used primarily for validation to check if a key string
-* is recognized and will have type-safe autocomplete support.
-*
-* @see {@link LETTER_KEYS}
-* @see {@link NUMBER_KEYS}
-* @see {@link FUNCTION_KEYS}
-* @see {@link NAVIGATION_KEYS}
-* @see {@link EDITING_KEYS}
-* @see {@link PUNCTUATION_KEYS}
-*/
-const ALL_KEYS = new Set([
-	...LETTER_KEYS,
-	...NUMBER_KEYS,
-	...FUNCTION_KEYS,
-	...NAVIGATION_KEYS,
-	...EDITING_KEYS,
-	...PUNCTUATION_KEYS,
-	...require__named_keys.SHARED_NAMED_KEYS,
-	...require__named_keys.LOGICAL_ONLY_NAMED_KEYS
-]);
-const CANONICAL_KEY_NAMES = new Map(Array.from(ALL_KEYS, (key) => [key.toLowerCase(), key]));
-/**
-* Maps key name aliases to their canonical form.
-*
-* Handles common variations and alternative names for keys to provide a more
-* forgiving API. For example, users can write 'Esc', 'esc', or 'escape' and
-* they'll all normalize to 'Escape'.
-*
-* This map is used internally by `normalizeKeyName()` to convert user input
-* into the canonical key names used throughout the library.
-*
-* @remarks Case-insensitive lookups are supported via lowercase variants
-*
-* @example
-* ```ts
-* KEY_ALIASES['Esc'] // 'Escape'
-* KEY_ALIASES['Del'] // 'Delete'
-* KEY_ALIASES['Up'] // 'ArrowUp'
-* ```
-*/
-const KEY_ALIASES = {
-	Plus: "+",
-	plus: "+",
-	Esc: "Escape",
-	esc: "Escape",
-	escape: "Escape",
-	Return: "Enter",
-	return: "Enter",
-	enter: "Enter",
-	" ": "Space",
-	space: "Space",
-	Spacebar: "Space",
-	spacebar: "Space",
-	tab: "Tab",
-	backspace: "Backspace",
-	Del: "Delete",
-	del: "Delete",
-	delete: "Delete",
-	Up: "ArrowUp",
-	up: "ArrowUp",
-	arrowup: "ArrowUp",
-	Down: "ArrowDown",
-	down: "ArrowDown",
-	arrowdown: "ArrowDown",
-	Left: "ArrowLeft",
-	left: "ArrowLeft",
-	arrowleft: "ArrowLeft",
-	Right: "ArrowRight",
-	right: "ArrowRight",
-	arrowright: "ArrowRight",
-	home: "Home",
-	end: "End",
-	pageup: "PageUp",
-	pagedown: "PageDown",
-	PgUp: "PageUp",
-	PgDn: "PageDown",
-	pgup: "PageUp",
-	pgdn: "PageDown"
-};
-/**
-* Normalizes a key name to its canonical form.
-*
-* Converts various key name formats (aliases, case variations) into the standard
-* canonical names used throughout the library. This enables a more forgiving API
-* where users can write keys in different ways and still get correct behavior.
-*
-* Normalization rules:
-* 1. Check aliases first (e.g., 'Esc' → 'Escape', 'Del' → 'Delete')
-* 2. Single letters → uppercase (e.g., 'a' → 'A', 's' → 'S')
-* 3. Function keys → uppercase (e.g., 'f1' → 'F1', 'F12' → 'F12')
-* 4. Other keys → returned as-is (already canonical or unknown)
-*
-* @param key - The key name to normalize (can be an alias, lowercase, etc.)
-* @returns The canonical key name
-*
-* @example
-* ```ts
-* normalizeKeyName('esc') // 'Escape'
-* normalizeKeyName('a') // 'A'
-* normalizeKeyName('f1') // 'F1'
-* normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)
-* ```
-*/
-function isSingleLetterKey(key) {
-	return /^\p{Letter}$/u.test(key);
-}
-/**
-* Normalizes a key name to its canonical form.
-*
-* @param key - The key name to normalize (can be an alias, lowercase, etc.)
-* @returns The canonical key name
-*
-* @example
-* ```ts
-* normalizeKeyName('esc') // 'Escape'
-* normalizeKeyName('a') // 'A'
-* normalizeKeyName('f1') // 'F1'
-* normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)
-* ```
-*/
-function normalizeKeyName(key) {
-	if (!key) return "";
-	if (key in KEY_ALIASES) return KEY_ALIASES[key];
-	if (isSingleLetterKey(key)) {
-		const upper = key.toUpperCase();
-		return upper.length === 1 ? upper : key;
-	}
-	return CANONICAL_KEY_NAMES.get(key.toLowerCase()) ?? key;
-}
-
-//#endregion
-exports.ALL_KEYS = ALL_KEYS;
-exports.EDITING_KEYS = EDITING_KEYS;
-exports.FUNCTION_KEYS = FUNCTION_KEYS;
-exports.LETTER_KEYS = LETTER_KEYS;
-exports.MODIFIER_ALIASES = MODIFIER_ALIASES;
-exports.MODIFIER_KEYS = MODIFIER_KEYS;
-exports.MODIFIER_ORDER = MODIFIER_ORDER;
-exports.NAVIGATION_KEYS = NAVIGATION_KEYS;
-exports.NUMBER_KEYS = NUMBER_KEYS;
-exports.PUNCTUATION_CODE_MAP = PUNCTUATION_CODE_MAP;
-exports.PUNCTUATION_KEYS = PUNCTUATION_KEYS;
-exports.isSingleLetterKey = isSingleLetterKey;
-exports.normalizeKeyName = normalizeKeyName;
-//# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.cjs","names":["SHARED_NAMED_KEYS","LOGICAL_ONLY_NAMED_KEYS"],"sources":["../src/constants.ts"],"sourcesContent":["import { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS } from './_named-keys'\nimport type {\n  CanonicalModifier,\n  EditingKey,\n  FunctionKey,\n  LetterKey,\n  NavigationKey,\n  NumberKey,\n  PunctuationKey,\n} from './key.types'\n\n/**\n * Canonical order for modifiers in normalized hotkey strings.\n *\n * Defines the standard order in which modifiers should appear when formatting\n * hotkeys. This ensures consistent, predictable output across the library.\n *\n * Order: Control → Alt → Shift → Meta\n *\n * @example\n * ```ts\n * // Input: 'Shift+Control+Meta+S'\n * // Normalized: 'Control+Alt+Shift+Meta+S' (following MODIFIER_ORDER)\n * ```\n */\nexport const MODIFIER_ORDER: Array<CanonicalModifier> = [\n  'Control',\n  'Alt',\n  'Shift',\n  'Meta',\n]\n\n/**\n * Set of canonical modifier key names for fast lookup.\n *\n * Derived from `MODIFIER_ORDER` to ensure consistency. Used to detect when\n * a modifier is released so we can clear non-modifier keys whose keyup events\n * may have been swallowed by the OS (e.g. macOS Cmd+key combos).\n */\nexport const MODIFIER_KEYS = new Set<string>(MODIFIER_ORDER)\n\n/**\n * Maps modifier key aliases to their canonical form or platform-adaptive 'Mod'.\n *\n * This map allows users to write hotkeys using various aliases (e.g., 'Ctrl', 'Cmd', 'Option')\n * which are then normalized to canonical names ('Control', 'Meta', 'Alt') or the\n * platform-adaptive 'Mod' token.\n *\n * The 'Mod' and 'CommandOrControl' aliases are resolved at runtime via `resolveModifier()`\n * based on the detected platform (Command on Mac, Control elsewhere).\n *\n * @remarks Case-insensitive lookups are supported via lowercase variants\n *\n * @example\n * ```ts\n * MODIFIER_ALIASES['Ctrl'] // 'Control'\n * MODIFIER_ALIASES['Cmd'] // 'Meta'\n * MODIFIER_ALIASES['Mod'] // 'Mod' (resolved at runtime)\n * ```\n */\nexport const MODIFIER_ALIASES: Record<string, CanonicalModifier | 'Mod'> = {\n  // Control variants\n  Control: 'Control',\n  Ctrl: 'Control',\n  control: 'Control',\n  ctrl: 'Control',\n\n  // Shift variants\n  Shift: 'Shift',\n  shift: 'Shift',\n\n  // Alt variants\n  Alt: 'Alt',\n  Option: 'Alt',\n  alt: 'Alt',\n  option: 'Alt',\n\n  // Meta/Command variants\n  Command: 'Meta',\n  Cmd: 'Meta',\n  Meta: 'Meta',\n  command: 'Meta',\n  cmd: 'Meta',\n  meta: 'Meta',\n\n  // DOM `KeyboardEvent.key` spellings for the meta / Windows key\n  OS: 'Meta',\n  os: 'Meta',\n  Win: 'Meta',\n  win: 'Meta',\n\n  // Platform-adaptive (resolved at runtime)\n  CommandOrControl: 'Mod',\n  Mod: 'Mod',\n  commandorcontrol: 'Mod',\n  mod: 'Mod',\n}\n\n/**\n * Set of all valid letter keys (A-Z).\n *\n * Used for validation and type checking. Letter keys are matched case-insensitively\n * in hotkey matching, but normalized to uppercase in canonical form.\n */\nexport const LETTER_KEYS = new Set<LetterKey>([\n  'A',\n  'B',\n  'C',\n  'D',\n  'E',\n  'F',\n  'G',\n  'H',\n  'I',\n  'J',\n  'K',\n  'L',\n  'M',\n  'N',\n  'O',\n  'P',\n  'Q',\n  'R',\n  'S',\n  'T',\n  'U',\n  'V',\n  'W',\n  'X',\n  'Y',\n  'Z',\n])\n\n/**\n * Set of all valid number keys (0-9).\n *\n * Note: Number keys are affected by Shift (Shift+1 → '!' on US layout),\n * so they're excluded from Shift-based hotkey combinations to avoid\n * layout-dependent behavior.\n */\nexport const NUMBER_KEYS = new Set<NumberKey>([\n  '0',\n  '1',\n  '2',\n  '3',\n  '4',\n  '5',\n  '6',\n  '7',\n  '8',\n  '9',\n])\n\n/**\n * Set of all valid function keys (F1-F24).\n *\n * Function keys are commonly used for system shortcuts (e.g., F12 for DevTools,\n * Alt+F4 to close windows) and application-specific commands.\n */\nexport const FUNCTION_KEYS = new Set<FunctionKey>([\n  'F1',\n  'F2',\n  'F3',\n  'F4',\n  'F5',\n  'F6',\n  'F7',\n  'F8',\n  'F9',\n  'F10',\n  'F11',\n  'F12',\n  'F13',\n  'F14',\n  'F15',\n  'F16',\n  'F17',\n  'F18',\n  'F19',\n  'F20',\n  'F21',\n  'F22',\n  'F23',\n  'F24',\n])\n\n/**\n * Set of all valid navigation keys for cursor movement and document navigation.\n *\n * Includes arrow keys, Home/End (line navigation), and PageUp/PageDown (page navigation).\n * These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or\n * navigation shortcuts (Alt+ArrowLeft for back).\n */\nexport const NAVIGATION_KEYS = new Set<NavigationKey>([\n  'ArrowUp',\n  'ArrowDown',\n  'ArrowLeft',\n  'ArrowRight',\n  'Home',\n  'End',\n  'PageUp',\n  'PageDown',\n])\n\n/**\n * Set of all valid editing and special keys.\n *\n * Includes keys commonly used for text editing (Enter, Backspace, Delete, Tab) and\n * special actions (Escape, Space). These keys are frequently combined with modifiers\n * for editor shortcuts (Mod+Enter to submit, Shift+Tab to go back).\n */\nexport const EDITING_KEYS = new Set<EditingKey>([\n  'Enter',\n  'Escape',\n  'Space',\n  'Tab',\n  'Backspace',\n  'Delete',\n])\n\n/**\n * Set of all valid punctuation keys commonly used in keyboard shortcuts.\n *\n * These are the literal characters as they appear in `KeyboardEvent.key` (layout-dependent,\n * typically US keyboard layout). Common shortcuts include:\n * - `Mod+/` - Toggle comment\n * - `Mod+[` / `Mod+]` - Indent/outdent\n * - `Mod+=` / `Mod+-` - Zoom in/out\n *\n * Note: Punctuation keys are affected by Shift (Shift+',' → '<' on US layout),\n * so they're excluded from Shift-based hotkey combinations to avoid layout-dependent behavior.\n */\nexport const PUNCTUATION_KEYS = new Set<PunctuationKey>([\n  '/',\n  '[',\n  ']',\n  '\\\\',\n  '=',\n  '-',\n  ',',\n  '.',\n  ';',\n  '`',\n  \"'\",\n  '+',\n  '?',\n  '!',\n  '@',\n  '#',\n  '$',\n  '%',\n  '^',\n  '&',\n  '*',\n  '(',\n  ')',\n  '_',\n  '{',\n  '}',\n  '|',\n  ':',\n  '\"',\n  '<',\n  '>',\n  '~',\n])\n\n/**\n * Maps `KeyboardEvent.code` values for punctuation keys to their canonical characters.\n *\n * On macOS, holding the Option (Alt) key transforms punctuation keys into special characters\n * (e.g., Option+Minus → en-dash '–'), causing `event.key` to differ from the expected character.\n * However, `event.code` still reports the physical key (e.g., 'Minus'). This map enables\n * falling back to `event.code` for punctuation keys, similar to the existing `Key*`/`Digit*`\n * fallbacks for letters and digits.\n */\nexport const PUNCTUATION_CODE_MAP: Record<string, string> = {\n  Backquote: '`',\n  Backslash: '\\\\',\n  BracketLeft: '[',\n  BracketRight: ']',\n  Comma: ',',\n  Equal: '=',\n  Minus: '-',\n  Period: '.',\n  Quote: \"'\",\n  Semicolon: ';',\n  Slash: '/',\n}\n\n/**\n * Set of all valid non-modifier keys.\n *\n * This is the union of all key type sets (letters, numbers, function keys, navigation,\n * editing, and punctuation). Used primarily for validation to check if a key string\n * is recognized and will have type-safe autocomplete support.\n *\n * @see {@link LETTER_KEYS}\n * @see {@link NUMBER_KEYS}\n * @see {@link FUNCTION_KEYS}\n * @see {@link NAVIGATION_KEYS}\n * @see {@link EDITING_KEYS}\n * @see {@link PUNCTUATION_KEYS}\n */\nexport const ALL_KEYS = new Set([\n  ...LETTER_KEYS,\n  ...NUMBER_KEYS,\n  ...FUNCTION_KEYS,\n  ...NAVIGATION_KEYS,\n  ...EDITING_KEYS,\n  ...PUNCTUATION_KEYS,\n  ...SHARED_NAMED_KEYS,\n  ...LOGICAL_ONLY_NAMED_KEYS,\n])\n\n// Share canonical spellings with validation, including newly supported named keys.\nconst CANONICAL_KEY_NAMES = new Map<string, string>(\n  Array.from(ALL_KEYS, (key) => [key.toLowerCase(), key]),\n)\n\n/**\n * Maps key name aliases to their canonical form.\n *\n * Handles common variations and alternative names for keys to provide a more\n * forgiving API. For example, users can write 'Esc', 'esc', or 'escape' and\n * they'll all normalize to 'Escape'.\n *\n * This map is used internally by `normalizeKeyName()` to convert user input\n * into the canonical key names used throughout the library.\n *\n * @remarks Case-insensitive lookups are supported via lowercase variants\n *\n * @example\n * ```ts\n * KEY_ALIASES['Esc'] // 'Escape'\n * KEY_ALIASES['Del'] // 'Delete'\n * KEY_ALIASES['Up'] // 'ArrowUp'\n * ```\n */\nconst KEY_ALIASES: Record<string, string> = {\n  Plus: '+',\n  plus: '+',\n  // Escape variants\n  Esc: 'Escape',\n  esc: 'Escape',\n  escape: 'Escape',\n\n  // Enter variants\n  Return: 'Enter',\n  return: 'Enter',\n  enter: 'Enter',\n\n  // Space variants\n  ' ': 'Space',\n  space: 'Space',\n  Spacebar: 'Space',\n  spacebar: 'Space',\n\n  // Tab variants\n  tab: 'Tab',\n\n  // Backspace variants\n  backspace: 'Backspace',\n\n  // Delete variants\n  Del: 'Delete',\n  del: 'Delete',\n  delete: 'Delete',\n\n  // Arrow key variants\n  Up: 'ArrowUp',\n  up: 'ArrowUp',\n  arrowup: 'ArrowUp',\n  Down: 'ArrowDown',\n  down: 'ArrowDown',\n  arrowdown: 'ArrowDown',\n  Left: 'ArrowLeft',\n  left: 'ArrowLeft',\n  arrowleft: 'ArrowLeft',\n  Right: 'ArrowRight',\n  right: 'ArrowRight',\n  arrowright: 'ArrowRight',\n\n  // Navigation variants\n  home: 'Home',\n  end: 'End',\n  pageup: 'PageUp',\n  pagedown: 'PageDown',\n  PgUp: 'PageUp',\n  PgDn: 'PageDown',\n  pgup: 'PageUp',\n  pgdn: 'PageDown',\n}\n\n/**\n * Normalizes a key name to its canonical form.\n *\n * Converts various key name formats (aliases, case variations) into the standard\n * canonical names used throughout the library. This enables a more forgiving API\n * where users can write keys in different ways and still get correct behavior.\n *\n * Normalization rules:\n * 1. Check aliases first (e.g., 'Esc' → 'Escape', 'Del' → 'Delete')\n * 2. Single letters → uppercase (e.g., 'a' → 'A', 's' → 'S')\n * 3. Function keys → uppercase (e.g., 'f1' → 'F1', 'F12' → 'F12')\n * 4. Other keys → returned as-is (already canonical or unknown)\n *\n * @param key - The key name to normalize (can be an alias, lowercase, etc.)\n * @returns The canonical key name\n *\n * @example\n * ```ts\n * normalizeKeyName('esc') // 'Escape'\n * normalizeKeyName('a') // 'A'\n * normalizeKeyName('f1') // 'F1'\n * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)\n * ```\n */\nexport function isSingleLetterKey(key: string): boolean {\n  return /^\\p{Letter}$/u.test(key)\n}\n\n/**\n * Normalizes a key name to its canonical form.\n *\n * @param key - The key name to normalize (can be an alias, lowercase, etc.)\n * @returns The canonical key name\n *\n * @example\n * ```ts\n * normalizeKeyName('esc') // 'Escape'\n * normalizeKeyName('a') // 'A'\n * normalizeKeyName('f1') // 'F1'\n * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)\n * ```\n */\nexport function normalizeKeyName(key: string): string {\n  // key can be undefined in rare cases\n  // (browser extensions synthesizing key events, accessibility tools, certain OS/browser combinations).\n  if (!key) return ''\n  // Check aliases first\n  if (key in KEY_ALIASES) {\n    return KEY_ALIASES[key]!\n  }\n\n  if (isSingleLetterKey(key)) {\n    const upper = key.toUpperCase()\n    // Some Unicode letters (e.g., 'ß') uppercase to multi-character sequences\n    // ('SS'). Avoid changing the string length so the rest of the matching\n    // logic can rely on a stable single-character key value.\n    return upper.length === 1 ? upper : key\n  }\n\n  return CANONICAL_KEY_NAMES.get(key.toLowerCase()) ?? key\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyBA,MAAa,iBAA2C;CACtD;CACA;CACA;CACA;CACD;;;;;;;;AASD,MAAa,gBAAgB,IAAI,IAAY,eAAe;;;;;;;;;;;;;;;;;;;;AAqB5D,MAAa,mBAA8D;CAEzE,SAAS;CACT,MAAM;CACN,SAAS;CACT,MAAM;CAGN,OAAO;CACP,OAAO;CAGP,KAAK;CACL,QAAQ;CACR,KAAK;CACL,QAAQ;CAGR,SAAS;CACT,KAAK;CACL,MAAM;CACN,SAAS;CACT,KAAK;CACL,MAAM;CAGN,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,KAAK;CAGL,kBAAkB;CAClB,KAAK;CACL,kBAAkB;CAClB,KAAK;CACN;;;;;;;AAQD,MAAa,cAAc,IAAI,IAAe;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,cAAc,IAAI,IAAe;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;AAQF,MAAa,gBAAgB,IAAI,IAAiB;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,kBAAkB,IAAI,IAAmB;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,eAAe,IAAI,IAAgB;CAC9C;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;AAcF,MAAa,mBAAmB,IAAI,IAAoB;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;AAWF,MAAa,uBAA+C;CAC1D,WAAW;CACX,WAAW;CACX,aAAa;CACb,cAAc;CACd,OAAO;CACP,OAAO;CACP,OAAO;CACP,QAAQ;CACR,OAAO;CACP,WAAW;CACX,OAAO;CACR;;;;;;;;;;;;;;;AAgBD,MAAa,WAAW,IAAI,IAAI;CAC9B,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAGA;CACH,GAAGC;CACJ,CAAC;AAGF,MAAM,sBAAsB,IAAI,IAC9B,MAAM,KAAK,WAAW,QAAQ,CAAC,IAAI,aAAa,EAAE,IAAI,CAAC,CACxD;;;;;;;;;;;;;;;;;;;;AAqBD,MAAM,cAAsC;CAC1C,MAAM;CACN,MAAM;CAEN,KAAK;CACL,KAAK;CACL,QAAQ;CAGR,QAAQ;CACR,QAAQ;CACR,OAAO;CAGP,KAAK;CACL,OAAO;CACP,UAAU;CACV,UAAU;CAGV,KAAK;CAGL,WAAW;CAGX,KAAK;CACL,KAAK;CACL,QAAQ;CAGR,IAAI;CACJ,IAAI;CACJ,SAAS;CACT,MAAM;CACN,MAAM;CACN,WAAW;CACX,MAAM;CACN,MAAM;CACN,WAAW;CACX,OAAO;CACP,OAAO;CACP,YAAY;CAGZ,MAAM;CACN,KAAK;CACL,QAAQ;CACR,UAAU;CACV,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACP;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,gBAAgB,KAAK,IAAI;;;;;;;;;;;;;;;;AAiBlC,SAAgB,iBAAiB,KAAqB;AAGpD,KAAI,CAAC,IAAK,QAAO;AAEjB,KAAI,OAAO,YACT,QAAO,YAAY;AAGrB,KAAI,kBAAkB,IAAI,EAAE;EAC1B,MAAM,QAAQ,IAAI,aAAa;AAI/B,SAAO,MAAM,WAAW,IAAI,QAAQ;;AAGtC,QAAO,oBAAoB,IAAI,IAAI,aAAa,CAAC,IAAI"}

package/dist/constants.d.cts

@@ -1,165 +0,0 @@
-import { CanonicalModifier, EditingKey, FunctionKey, LetterKey, NavigationKey, NumberKey, PunctuationKey } from "./key.types.cjs";
-
-//#region src/constants.d.ts
-/**
- * Canonical order for modifiers in normalized hotkey strings.
- *
- * Defines the standard order in which modifiers should appear when formatting
- * hotkeys. This ensures consistent, predictable output across the library.
- *
- * Order: Control → Alt → Shift → Meta
- *
- * @example
- * ```ts
- * // Input: 'Shift+Control+Meta+S'
- * // Normalized: 'Control+Alt+Shift+Meta+S' (following MODIFIER_ORDER)
- * ```
- */
-declare const MODIFIER_ORDER: Array<CanonicalModifier>;
-/**
- * Set of canonical modifier key names for fast lookup.
- *
- * Derived from `MODIFIER_ORDER` to ensure consistency. Used to detect when
- * 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>;
-/**
- * Maps modifier key aliases to their canonical form or platform-adaptive 'Mod'.
- *
- * This map allows users to write hotkeys using various aliases (e.g., 'Ctrl', 'Cmd', 'Option')
- * which are then normalized to canonical names ('Control', 'Meta', 'Alt') or the
- * platform-adaptive 'Mod' token.
- *
- * The 'Mod' and 'CommandOrControl' aliases are resolved at runtime via `resolveModifier()`
- * based on the detected platform (Command on Mac, Control elsewhere).
- *
- * @remarks Case-insensitive lookups are supported via lowercase variants
- *
- * @example
- * ```ts
- * MODIFIER_ALIASES['Ctrl'] // 'Control'
- * MODIFIER_ALIASES['Cmd'] // 'Meta'
- * MODIFIER_ALIASES['Mod'] // 'Mod' (resolved at runtime)
- * ```
- */
-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>;
-/**
- * Set of all valid number keys (0-9).
- *
- * Note: Number keys are affected by Shift (Shift+1 → '!' on US layout),
- * so they're excluded from Shift-based hotkey combinations to avoid
- * layout-dependent behavior.
- */
-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>;
-/**
- * Set of all valid navigation keys for cursor movement and document navigation.
- *
- * Includes arrow keys, Home/End (line navigation), and PageUp/PageDown (page navigation).
- * These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or
- * navigation shortcuts (Alt+ArrowLeft for back).
- */
-declare const NAVIGATION_KEYS: Set<NavigationKey>;
-/**
- * Set of all valid editing and special keys.
- *
- * Includes keys commonly used for text editing (Enter, Backspace, Delete, Tab) and
- * 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>;
-/**
- * Set of all valid punctuation keys commonly used in keyboard shortcuts.
- *
- * These are the literal characters as they appear in `KeyboardEvent.key` (layout-dependent,
- * typically US keyboard layout). Common shortcuts include:
- * - `Mod+/` - Toggle comment
- * - `Mod+[` / `Mod+]` - Indent/outdent
- * - `Mod+=` / `Mod+-` - Zoom in/out
- *
- * 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>;
-/**
- * Maps `KeyboardEvent.code` values for punctuation keys to their canonical characters.
- *
- * On macOS, holding the Option (Alt) key transforms punctuation keys into special characters
- * (e.g., Option+Minus → en-dash '–'), causing `event.key` to differ from the expected character.
- * However, `event.code` still reports the physical key (e.g., 'Minus'). This map enables
- * 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>;
-/**
- * Set of all valid non-modifier keys.
- *
- * This is the union of all key type sets (letters, numbers, function keys, navigation,
- * editing, and punctuation). Used primarily for validation to check if a key string
- * is recognized and will have type-safe autocomplete support.
- *
- * @see {@link LETTER_KEYS}
- * @see {@link NUMBER_KEYS}
- * @see {@link FUNCTION_KEYS}
- * @see {@link NAVIGATION_KEYS}
- * @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">;
-/**
- * Normalizes a key name to its canonical form.
- *
- * Converts various key name formats (aliases, case variations) into the standard
- * canonical names used throughout the library. This enables a more forgiving API
- * where users can write keys in different ways and still get correct behavior.
- *
- * Normalization rules:
- * 1. Check aliases first (e.g., 'Esc' → 'Escape', 'Del' → 'Delete')
- * 2. Single letters → uppercase (e.g., 'a' → 'A', 's' → 'S')
- * 3. Function keys → uppercase (e.g., 'f1' → 'F1', 'F12' → 'F12')
- * 4. Other keys → returned as-is (already canonical or unknown)
- *
- * @param key - The key name to normalize (can be an alias, lowercase, etc.)
- * @returns The canonical key name
- *
- * @example
- * ```ts
- * normalizeKeyName('esc') // 'Escape'
- * normalizeKeyName('a') // 'A'
- * normalizeKeyName('f1') // 'F1'
- * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)
- * ```
- */
-declare function isSingleLetterKey(key: string): boolean;
-/**
- * Normalizes a key name to its canonical form.
- *
- * @param key - The key name to normalize (can be an alias, lowercase, etc.)
- * @returns The canonical key name
- *
- * @example
- * ```ts
- * normalizeKeyName('esc') // 'Escape'
- * normalizeKeyName('a') // 'A'
- * normalizeKeyName('f1') // 'F1'
- * 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.cts.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { LOGICAL_ONLY_NAMED_KEYS, SHARED_NAMED_KEYS } from './_named-keys'\nimport type {\n  CanonicalModifier,\n  EditingKey,\n  FunctionKey,\n  LetterKey,\n  NavigationKey,\n  NumberKey,\n  PunctuationKey,\n} from './key.types'\n\n/**\n * Canonical order for modifiers in normalized hotkey strings.\n *\n * Defines the standard order in which modifiers should appear when formatting\n * hotkeys. This ensures consistent, predictable output across the library.\n *\n * Order: Control → Alt → Shift → Meta\n *\n * @example\n * ```ts\n * // Input: 'Shift+Control+Meta+S'\n * // Normalized: 'Control+Alt+Shift+Meta+S' (following MODIFIER_ORDER)\n * ```\n */\nexport const MODIFIER_ORDER: Array<CanonicalModifier> = [\n  'Control',\n  'Alt',\n  'Shift',\n  'Meta',\n]\n\n/**\n * Set of canonical modifier key names for fast lookup.\n *\n * Derived from `MODIFIER_ORDER` to ensure consistency. Used to detect when\n * a modifier is released so we can clear non-modifier keys whose keyup events\n * may have been swallowed by the OS (e.g. macOS Cmd+key combos).\n */\nexport const MODIFIER_KEYS = new Set<string>(MODIFIER_ORDER)\n\n/**\n * Maps modifier key aliases to their canonical form or platform-adaptive 'Mod'.\n *\n * This map allows users to write hotkeys using various aliases (e.g., 'Ctrl', 'Cmd', 'Option')\n * which are then normalized to canonical names ('Control', 'Meta', 'Alt') or the\n * platform-adaptive 'Mod' token.\n *\n * The 'Mod' and 'CommandOrControl' aliases are resolved at runtime via `resolveModifier()`\n * based on the detected platform (Command on Mac, Control elsewhere).\n *\n * @remarks Case-insensitive lookups are supported via lowercase variants\n *\n * @example\n * ```ts\n * MODIFIER_ALIASES['Ctrl'] // 'Control'\n * MODIFIER_ALIASES['Cmd'] // 'Meta'\n * MODIFIER_ALIASES['Mod'] // 'Mod' (resolved at runtime)\n * ```\n */\nexport const MODIFIER_ALIASES: Record<string, CanonicalModifier | 'Mod'> = {\n  // Control variants\n  Control: 'Control',\n  Ctrl: 'Control',\n  control: 'Control',\n  ctrl: 'Control',\n\n  // Shift variants\n  Shift: 'Shift',\n  shift: 'Shift',\n\n  // Alt variants\n  Alt: 'Alt',\n  Option: 'Alt',\n  alt: 'Alt',\n  option: 'Alt',\n\n  // Meta/Command variants\n  Command: 'Meta',\n  Cmd: 'Meta',\n  Meta: 'Meta',\n  command: 'Meta',\n  cmd: 'Meta',\n  meta: 'Meta',\n\n  // DOM `KeyboardEvent.key` spellings for the meta / Windows key\n  OS: 'Meta',\n  os: 'Meta',\n  Win: 'Meta',\n  win: 'Meta',\n\n  // Platform-adaptive (resolved at runtime)\n  CommandOrControl: 'Mod',\n  Mod: 'Mod',\n  commandorcontrol: 'Mod',\n  mod: 'Mod',\n}\n\n/**\n * Set of all valid letter keys (A-Z).\n *\n * Used for validation and type checking. Letter keys are matched case-insensitively\n * in hotkey matching, but normalized to uppercase in canonical form.\n */\nexport const LETTER_KEYS = new Set<LetterKey>([\n  'A',\n  'B',\n  'C',\n  'D',\n  'E',\n  'F',\n  'G',\n  'H',\n  'I',\n  'J',\n  'K',\n  'L',\n  'M',\n  'N',\n  'O',\n  'P',\n  'Q',\n  'R',\n  'S',\n  'T',\n  'U',\n  'V',\n  'W',\n  'X',\n  'Y',\n  'Z',\n])\n\n/**\n * Set of all valid number keys (0-9).\n *\n * Note: Number keys are affected by Shift (Shift+1 → '!' on US layout),\n * so they're excluded from Shift-based hotkey combinations to avoid\n * layout-dependent behavior.\n */\nexport const NUMBER_KEYS = new Set<NumberKey>([\n  '0',\n  '1',\n  '2',\n  '3',\n  '4',\n  '5',\n  '6',\n  '7',\n  '8',\n  '9',\n])\n\n/**\n * Set of all valid function keys (F1-F24).\n *\n * Function keys are commonly used for system shortcuts (e.g., F12 for DevTools,\n * Alt+F4 to close windows) and application-specific commands.\n */\nexport const FUNCTION_KEYS = new Set<FunctionKey>([\n  'F1',\n  'F2',\n  'F3',\n  'F4',\n  'F5',\n  'F6',\n  'F7',\n  'F8',\n  'F9',\n  'F10',\n  'F11',\n  'F12',\n  'F13',\n  'F14',\n  'F15',\n  'F16',\n  'F17',\n  'F18',\n  'F19',\n  'F20',\n  'F21',\n  'F22',\n  'F23',\n  'F24',\n])\n\n/**\n * Set of all valid navigation keys for cursor movement and document navigation.\n *\n * Includes arrow keys, Home/End (line navigation), and PageUp/PageDown (page navigation).\n * These keys are commonly combined with modifiers for selection (Shift+ArrowUp) or\n * navigation shortcuts (Alt+ArrowLeft for back).\n */\nexport const NAVIGATION_KEYS = new Set<NavigationKey>([\n  'ArrowUp',\n  'ArrowDown',\n  'ArrowLeft',\n  'ArrowRight',\n  'Home',\n  'End',\n  'PageUp',\n  'PageDown',\n])\n\n/**\n * Set of all valid editing and special keys.\n *\n * Includes keys commonly used for text editing (Enter, Backspace, Delete, Tab) and\n * special actions (Escape, Space). These keys are frequently combined with modifiers\n * for editor shortcuts (Mod+Enter to submit, Shift+Tab to go back).\n */\nexport const EDITING_KEYS = new Set<EditingKey>([\n  'Enter',\n  'Escape',\n  'Space',\n  'Tab',\n  'Backspace',\n  'Delete',\n])\n\n/**\n * Set of all valid punctuation keys commonly used in keyboard shortcuts.\n *\n * These are the literal characters as they appear in `KeyboardEvent.key` (layout-dependent,\n * typically US keyboard layout). Common shortcuts include:\n * - `Mod+/` - Toggle comment\n * - `Mod+[` / `Mod+]` - Indent/outdent\n * - `Mod+=` / `Mod+-` - Zoom in/out\n *\n * Note: Punctuation keys are affected by Shift (Shift+',' → '<' on US layout),\n * so they're excluded from Shift-based hotkey combinations to avoid layout-dependent behavior.\n */\nexport const PUNCTUATION_KEYS = new Set<PunctuationKey>([\n  '/',\n  '[',\n  ']',\n  '\\\\',\n  '=',\n  '-',\n  ',',\n  '.',\n  ';',\n  '`',\n  \"'\",\n  '+',\n  '?',\n  '!',\n  '@',\n  '#',\n  '$',\n  '%',\n  '^',\n  '&',\n  '*',\n  '(',\n  ')',\n  '_',\n  '{',\n  '}',\n  '|',\n  ':',\n  '\"',\n  '<',\n  '>',\n  '~',\n])\n\n/**\n * Maps `KeyboardEvent.code` values for punctuation keys to their canonical characters.\n *\n * On macOS, holding the Option (Alt) key transforms punctuation keys into special characters\n * (e.g., Option+Minus → en-dash '–'), causing `event.key` to differ from the expected character.\n * However, `event.code` still reports the physical key (e.g., 'Minus'). This map enables\n * falling back to `event.code` for punctuation keys, similar to the existing `Key*`/`Digit*`\n * fallbacks for letters and digits.\n */\nexport const PUNCTUATION_CODE_MAP: Record<string, string> = {\n  Backquote: '`',\n  Backslash: '\\\\',\n  BracketLeft: '[',\n  BracketRight: ']',\n  Comma: ',',\n  Equal: '=',\n  Minus: '-',\n  Period: '.',\n  Quote: \"'\",\n  Semicolon: ';',\n  Slash: '/',\n}\n\n/**\n * Set of all valid non-modifier keys.\n *\n * This is the union of all key type sets (letters, numbers, function keys, navigation,\n * editing, and punctuation). Used primarily for validation to check if a key string\n * is recognized and will have type-safe autocomplete support.\n *\n * @see {@link LETTER_KEYS}\n * @see {@link NUMBER_KEYS}\n * @see {@link FUNCTION_KEYS}\n * @see {@link NAVIGATION_KEYS}\n * @see {@link EDITING_KEYS}\n * @see {@link PUNCTUATION_KEYS}\n */\nexport const ALL_KEYS = new Set([\n  ...LETTER_KEYS,\n  ...NUMBER_KEYS,\n  ...FUNCTION_KEYS,\n  ...NAVIGATION_KEYS,\n  ...EDITING_KEYS,\n  ...PUNCTUATION_KEYS,\n  ...SHARED_NAMED_KEYS,\n  ...LOGICAL_ONLY_NAMED_KEYS,\n])\n\n// Share canonical spellings with validation, including newly supported named keys.\nconst CANONICAL_KEY_NAMES = new Map<string, string>(\n  Array.from(ALL_KEYS, (key) => [key.toLowerCase(), key]),\n)\n\n/**\n * Maps key name aliases to their canonical form.\n *\n * Handles common variations and alternative names for keys to provide a more\n * forgiving API. For example, users can write 'Esc', 'esc', or 'escape' and\n * they'll all normalize to 'Escape'.\n *\n * This map is used internally by `normalizeKeyName()` to convert user input\n * into the canonical key names used throughout the library.\n *\n * @remarks Case-insensitive lookups are supported via lowercase variants\n *\n * @example\n * ```ts\n * KEY_ALIASES['Esc'] // 'Escape'\n * KEY_ALIASES['Del'] // 'Delete'\n * KEY_ALIASES['Up'] // 'ArrowUp'\n * ```\n */\nconst KEY_ALIASES: Record<string, string> = {\n  Plus: '+',\n  plus: '+',\n  // Escape variants\n  Esc: 'Escape',\n  esc: 'Escape',\n  escape: 'Escape',\n\n  // Enter variants\n  Return: 'Enter',\n  return: 'Enter',\n  enter: 'Enter',\n\n  // Space variants\n  ' ': 'Space',\n  space: 'Space',\n  Spacebar: 'Space',\n  spacebar: 'Space',\n\n  // Tab variants\n  tab: 'Tab',\n\n  // Backspace variants\n  backspace: 'Backspace',\n\n  // Delete variants\n  Del: 'Delete',\n  del: 'Delete',\n  delete: 'Delete',\n\n  // Arrow key variants\n  Up: 'ArrowUp',\n  up: 'ArrowUp',\n  arrowup: 'ArrowUp',\n  Down: 'ArrowDown',\n  down: 'ArrowDown',\n  arrowdown: 'ArrowDown',\n  Left: 'ArrowLeft',\n  left: 'ArrowLeft',\n  arrowleft: 'ArrowLeft',\n  Right: 'ArrowRight',\n  right: 'ArrowRight',\n  arrowright: 'ArrowRight',\n\n  // Navigation variants\n  home: 'Home',\n  end: 'End',\n  pageup: 'PageUp',\n  pagedown: 'PageDown',\n  PgUp: 'PageUp',\n  PgDn: 'PageDown',\n  pgup: 'PageUp',\n  pgdn: 'PageDown',\n}\n\n/**\n * Normalizes a key name to its canonical form.\n *\n * Converts various key name formats (aliases, case variations) into the standard\n * canonical names used throughout the library. This enables a more forgiving API\n * where users can write keys in different ways and still get correct behavior.\n *\n * Normalization rules:\n * 1. Check aliases first (e.g., 'Esc' → 'Escape', 'Del' → 'Delete')\n * 2. Single letters → uppercase (e.g., 'a' → 'A', 's' → 'S')\n * 3. Function keys → uppercase (e.g., 'f1' → 'F1', 'F12' → 'F12')\n * 4. Other keys → returned as-is (already canonical or unknown)\n *\n * @param key - The key name to normalize (can be an alias, lowercase, etc.)\n * @returns The canonical key name\n *\n * @example\n * ```ts\n * normalizeKeyName('esc') // 'Escape'\n * normalizeKeyName('a') // 'A'\n * normalizeKeyName('f1') // 'F1'\n * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)\n * ```\n */\nexport function isSingleLetterKey(key: string): boolean {\n  return /^\\p{Letter}$/u.test(key)\n}\n\n/**\n * Normalizes a key name to its canonical form.\n *\n * @param key - The key name to normalize (can be an alias, lowercase, etc.)\n * @returns The canonical key name\n *\n * @example\n * ```ts\n * normalizeKeyName('esc') // 'Escape'\n * normalizeKeyName('a') // 'A'\n * normalizeKeyName('f1') // 'F1'\n * normalizeKeyName('ArrowUp') // 'ArrowUp' (already canonical)\n * ```\n */\nexport function normalizeKeyName(key: string): string {\n  // key can be undefined in rare cases\n  // (browser extensions synthesizing key events, accessibility tools, certain OS/browser combinations).\n  if (!key) return ''\n  // Check aliases first\n  if (key in KEY_ALIASES) {\n    return KEY_ALIASES[key]!\n  }\n\n  if (isSingleLetterKey(key)) {\n    const upper = key.toUpperCase()\n    // Some Unicode letters (e.g., 'ß') uppercase to multi-character sequences\n    // ('SS'). Avoid changing the string length so the rest of the matching\n    // logic can rely on a stable single-character key value.\n    return upper.length === 1 ? upper : key\n  }\n\n  return CANONICAL_KEY_NAMES.get(key.toLowerCase()) ?? key\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyBA,MAAa,iBAA2C;CACtD;CACA;CACA;CACA;CACD;;;;;;;;AASD,MAAa,gBAAgB,IAAI,IAAY,eAAe;;;;;;;;;;;;;;;;;;;;AAqB5D,MAAa,mBAA8D;CAEzE,SAAS;CACT,MAAM;CACN,SAAS;CACT,MAAM;CAGN,OAAO;CACP,OAAO;CAGP,KAAK;CACL,QAAQ;CACR,KAAK;CACL,QAAQ;CAGR,SAAS;CACT,KAAK;CACL,MAAM;CACN,SAAS;CACT,KAAK;CACL,MAAM;CAGN,IAAI;CACJ,IAAI;CACJ,KAAK;CACL,KAAK;CAGL,kBAAkB;CAClB,KAAK;CACL,kBAAkB;CAClB,KAAK;CACN;;;;;;;AAQD,MAAa,cAAc,IAAI,IAAe;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,cAAc,IAAI,IAAe;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;AAQF,MAAa,gBAAgB,IAAI,IAAiB;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,kBAAkB,IAAI,IAAmB;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,MAAa,eAAe,IAAI,IAAgB;CAC9C;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;AAcF,MAAa,mBAAmB,IAAI,IAAoB;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;AAWF,MAAa,uBAA+C;CAC1D,WAAW;CACX,WAAW;CACX,aAAa;CACb,cAAc;CACd,OAAO;CACP,OAAO;CACP,OAAO;CACP,QAAQ;CACR,OAAO;CACP,WAAW;CACX,OAAO;CACR;;;;;;;;;;;;;;;AAgBD,MAAa,WAAW,IAAI,IAAI;CAC9B,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ,CAAC;AAGF,MAAM,sBAAsB,IAAI,IAC9B,MAAM,KAAK,WAAW,QAAQ,CAAC,IAAI,aAAa,EAAE,IAAI,CAAC,CACxD;;;;;;;;;;;;;;;;;;;;AAqBD,MAAM,cAAsC;CAC1C,MAAM;CACN,MAAM;CAEN,KAAK;CACL,KAAK;CACL,QAAQ;CAGR,QAAQ;CACR,QAAQ;CACR,OAAO;CAGP,KAAK;CACL,OAAO;CACP,UAAU;CACV,UAAU;CAGV,KAAK;CAGL,WAAW;CAGX,KAAK;CACL,KAAK;CACL,QAAQ;CAGR,IAAI;CACJ,IAAI;CACJ,SAAS;CACT,MAAM;CACN,MAAM;CACN,WAAW;CACX,MAAM;CACN,MAAM;CACN,WAAW;CACX,OAAO;CACP,OAAO;CACP,YAAY;CAGZ,MAAM;CACN,KAAK;CACL,QAAQ;CACR,UAAU;CACV,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACP;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,gBAAgB,KAAK,IAAI;;;;;;;;;;;;;;;;AAiBlC,SAAgB,iBAAiB,KAAqB;AAGpD,KAAI,CAAC,IAAK,QAAO;AAEjB,KAAI,OAAO,YACT,QAAO,YAAY;AAGrB,KAAI,kBAAkB,IAAI,EAAE;EAC1B,MAAM,QAAQ,IAAI,aAAa;AAI/B,SAAO,MAAM,WAAW,IAAI,QAAQ;;AAGtC,QAAO,oBAAoB,IAAI,IAAI,aAAa,CAAC,IAAI"}