npm - @vielzeug/keymap - Versions diffs - 1.1.3 → 2.1.0 - Mend

@vielzeug/keymap 1.1.3 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (40) hide show

package/dist/keymap.iife.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"keymap.iife.js","names":[],"sources":["../src/errors.ts","../src/parser.ts","../src/conflicts.ts","../src/_dev.ts","../src/format.ts","../src/keymap.ts","../src/layer.ts"],"sourcesContent":["/** Base class for all keymap errors. Use `instanceof KeymapError` to catch any keymap-originated error. /\nexport class KeymapError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static is(err: unknown): err is KeymapError {\n return err instanceof KeymapError;\n }\n}\n\n/* Thrown when a shortcut string cannot be parsed — ambiguous or invalid key step. /\nexport class KeymapParseError extends KeymapError {\n constructor(message: string) {\n super(message);\n }\n}\n","import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction buildModifierAliases(modKey: 'ctrl' \| 'meta'): Record<string, ModifierKey> {\n return { ...MODIFIER_ALIASES_BASE, mod: modKey };\n}\n\nfunction normalizeModifier(token: string, aliases: Record<string, ModifierKey>): ModifierKey \| null {\n const lower = token.toLowerCase();\n\n return Object.hasOwn(aliases, lower) ? aliases[lower]! : null;\n}\n\nfunction normalizeKey(raw: string): string {\n return Object.hasOwn(SPECIAL_KEY_ALIASES, raw) ? SPECIAL_KEY_ALIASES[raw]! : raw;\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((p) => p.toLowerCase());\n\n if (parts.length === 0) return null;\n\n const aliases = buildModifierAliases(modKey);\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const mod = normalizeModifier(part, aliases);\n\n if (mod) {\n modifiers.add(mod);\n } else {\n keyParts.push(part);\n }\n }\n\n if (keyParts.length === 0) return null;\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const key = normalizeKey(keyParts[0]);\n\n return { key, modifiers };\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n return raw\n .trim()\n .split(/\\s+/)\n .filter(Boolean)\n .map((step) => {\n const result = parseStep(step, modKey);\n\n if (result === null) {\n throw new KeymapParseError(`Invalid shortcut step: \"${step}\" in \"${raw}\"`);\n }\n\n return result;\n });\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((s) => {\n const mods = [...s.modifiers].sort().join('+');\n\n return mods ? `${mods}+${s.key}` : s.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n if (event.altKey !== modifiers.has('alt')) return false;\n\n if (event.ctrlKey !== modifiers.has('ctrl')) return false;\n\n if (event.metaKey !== modifiers.has('meta')) return false;\n\n if (event.shiftKey !== modifiers.has('shift')) return false;\n\n return true;\n}\n","import type { ShortcutStep } from './parser';\nimport type { BindingEntry } from './types';\n\nimport { canonicalizeShortcut, parseShortcut } from './parser';\n\nexport interface ConflictOptions {\n modKey?: 'ctrl' \| 'meta';\n trigger?: 'keydown' \| 'keyup';\n}\n\nfunction isPrefixOf(shorter: readonly ShortcutStep[], longer: readonly ShortcutStep[]): boolean {\n if (shorter.length > longer.length) return false;\n\n return canonicalizeShortcut(shorter) === canonicalizeShortcut(longer.slice(0, shorter.length));\n}\n\n/\n Finds registered bindings that would conflict with a proposed shortcut — an exact duplicate, a\n * shorter binding that would shadow it as a chord prefix, or a longer binding it would itself\n * shadow. Only compares against entries sharing the same `trigger` — `'keydown'` and `'keyup'`\n * chords are matched independently and never conflict with each other.\n \n @example\n * const entries = map.listBindings();\n * findShortcutConflicts('g g', entries); // → the entry for 'g', if one is bound\n /\nexport function findShortcutConflicts(\n shortcut: string,\n entries: readonly BindingEntry[],\n options: ConflictOptions = {},\n): BindingEntry[] {\n const { modKey, trigger = 'keydown' } = options;\n const steps = parseShortcut(shortcut, modKey);\n\n // An empty/whitespace-only shortcut parses to zero steps, which would otherwise be treated as\n // a trivial prefix of every entry — never report that as a conflict.\n if (steps.length === 0) return [];\n\n return entries.filter(\n (entry) => entry.trigger === trigger && (isPrefixOf(steps, entry.shortcut) \|\| isPrefixOf(entry.shortcut, steps)),\n );\n}\n","const isDev = !(globalThis as { __KEYMAP_PROD__?: boolean }).__KEYMAP_PROD__;\n\n/* @internal /\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/keymap] ${msg}`);\n}\n\n/* @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. /\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { warn } from './_dev';\nimport { detectModKey, parseShortcut } from './parser';\n\nconst KEY_SYMBOLS: Record<string, string> = {\n ' ': 'Space',\n arrowdown: '↓',\n arrowleft: '←',\n arrowright: '→',\n arrowup: '↑',\n backspace: '⌫',\n delete: '⌦',\n end: 'End',\n enter: '↵',\n escape: 'Esc',\n home: 'Home',\n pagedown: 'PgDn',\n pageup: 'PgUp',\n tab: '⇥',\n};\n\nconst MOD_SYMBOLS_MAC: Record<string, string> = {\n alt: '⌥',\n ctrl: '⌃',\n meta: '⌘',\n shift: '⇧',\n};\n\nconst MOD_LABELS_OTHER: Record<string, string> = {\n alt: 'Alt',\n ctrl: 'Ctrl',\n meta: 'Win',\n shift: 'Shift',\n};\n\nconst MOD_ORDER = ['ctrl', 'alt', 'shift', 'meta'] as const;\n\n/\n Formats a shortcut string into a human-readable display string.\n \n On Mac (when `modKey` is `'meta'`), uses standard Mac symbols (⌘, ⌥, ⇧, ⌃).\n * On other platforms, uses word labels (Ctrl, Alt, Shift, Win).\n \n @example\n * formatShortcut('mod+shift+p', 'meta') // '⇧⌘P' (canonical order: ctrl, alt, shift, meta)\n * formatShortcut('mod+shift+p', 'ctrl') // 'Ctrl+Shift+P'\n * formatShortcut('ctrl+k ctrl+s', 'meta') // '⌃K ⌃S'\n /\nexport function formatShortcut(shortcut: string, modKey: 'ctrl' \| 'meta' = detectModKey()): string {\n if (!shortcut.trim()) {\n warn(`formatShortcut() received an empty shortcut string`);\n\n return '';\n }\n\n let steps;\n\n try {\n steps = parseShortcut(shortcut, modKey);\n } catch {\n warn(`formatShortcut() received an invalid shortcut: \"${shortcut}\"`);\n\n return '';\n }\n\n const isMac = modKey === 'meta';\n\n return steps\n .map((step) => {\n const modParts = MOD_ORDER.filter((m) => step.modifiers.has(m)).map((m) =>\n isMac ? MOD_SYMBOLS_MAC[m] : MOD_LABELS_OTHER[m],\n );\n\n const keyLabel = KEY_SYMBOLS[step.key] ?? step.key.toUpperCase();\n\n return isMac ? `${modParts.join('')}${keyLabel}` : [...modParts, keyLabel].join('+');\n })\n .join(' ');\n}\n","import type { Shortcut } from './parser';\nimport type { BindingEntry, BindingOptions, BindingValue, Handler, Keymap, KeymapOptions } from './types';\n\nimport { warn } from './_dev';\nimport { canonicalizeShortcut, detectModKey, matchStep, parseShortcut } from './parser';\n\ntype ParsedBinding = {\n handler: Handler;\n priority: number;\n shortcut: Shortcut;\n trigger: 'keydown' \| 'keyup';\n when?: () => boolean;\n};\n\nfunction resolveBinding(value: BindingValue): Omit<ParsedBinding, 'shortcut'> {\n if (typeof value === 'function') {\n return { handler: value, priority: 0, trigger: 'keydown' };\n }\n\n const priority = value.priority ?? 0;\n\n if (!Number.isFinite(priority)) {\n warn(`binding priority must be a finite number; received ${priority}. Using 0.`);\n }\n\n return {\n handler: value.handler,\n priority: Number.isFinite(priority) ? priority : 0,\n trigger: value.trigger ?? 'keydown',\n when: value.when,\n };\n}\n\nfunction createChordTracker(getBindings: () => ParsedBinding[], chordTimeout: number) {\n let pendingIndex = 0;\n let candidates: ParsedBinding[] = [];\n let timer: ReturnType<typeof setTimeout> \| null = null;\n\n function clearTimer(): void {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n }\n\n function reset(): void {\n clearTimer();\n pendingIndex = 0;\n candidates = [];\n }\n\n function advance(event: KeyboardEvent): ParsedBinding \| null {\n // At the root of a chord, re-scan every binding. Mid-chord, narrow only within bindings that\n // already matched every prior step — never re-admit a binding whose earlier step didn't match.\n const pool = pendingIndex === 0 ? getBindings() : candidates;\n const matched: ParsedBinding[] = [];\n\n for (const binding of pool) {\n const step = binding.shortcut[pendingIndex];\n\n if (step && matchStep(event, step)) {\n matched.push(binding);\n }\n }\n\n if (matched.length === 0) {\n const wasPartial = pendingIndex !== 0;\n\n reset();\n\n if (wasPartial) {\n return advance(event);\n }\n\n return null;\n }\n\n clearTimer();\n\n // At most one binding can complete here — the bindings map is keyed by canonical shortcut,\n // so two live bindings can never share an identical step sequence. `priority` therefore never\n // has a real tie to resolve; the shortest completing match always fires immediately.\n const completed = matched.find((b) => b.shortcut.length === pendingIndex + 1);\n\n if (completed) {\n reset();\n\n return completed;\n }\n\n candidates = matched;\n pendingIndex++;\n timer = setTimeout(reset, chordTimeout);\n\n return null;\n }\n\n return { advance, reset };\n}\n\n/\n Creates a headless keyboard shortcut manager.\n \n Pass a bindings map of shortcut strings to handlers or `BindingOptions`, then call\n * `.mount(target)` to attach to any `EventTarget`. Supports chord sequences\n * (e.g. `\"ctrl+k ctrl+s\"`), per-binding `when` guards, `trigger` (keydown/keyup),\n * `priority`, and dynamic `bind`/`unbind`.\n \n @example\n * const map = createKeymap({\n * 'mod+k mod+s': () => save(),\n * 'mod+shift+p': () => openPalette(),\n * 'g g': () => goToTop(),\n * esc: { handler: closePanel, when: () => isPanelOpen() },\n * space: { handler: togglePlay, trigger: 'keyup' },\n * }, { modKey: 'ctrl' });\n * const unmount = map.mount(document);\n /\nexport function createKeymap(initialBindings: Record<string, BindingValue> = {}, options: KeymapOptions = {}): Keymap {\n const {\n chordTimeout: rawChordTimeout = 1000,\n modKey = detectModKey(),\n preventDefault = true,\n stopPropagation = false,\n when: globalWhen,\n } = options;\n\n const chordTimeout = Number.isFinite(rawChordTimeout) && rawChordTimeout > 0 ? rawChordTimeout : 1000;\n\n if (chordTimeout !== rawChordTimeout) {\n warn(`chordTimeout must be a positive finite number; received ${rawChordTimeout}. Using default of 1000ms.`);\n }\n\n const bindings = new Map<string, ParsedBinding>();\n let bindingsDown: ParsedBinding[] = [];\n let bindingsUp: ParsedBinding[] = [];\n\n function rebuildTriggerCaches(): void {\n bindingsDown = [];\n bindingsUp = [];\n\n for (const b of bindings.values()) {\n if (b.trigger === 'keydown') bindingsDown.push(b);\n else bindingsUp.push(b);\n }\n }\n\n function addBinding(shortcutStr: string, value: BindingValue): string {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n bindings.set(key, { shortcut, ...resolveBinding(value) });\n rebuildTriggerCaches();\n\n return key;\n }\n\n function removeByKey(key: string): boolean {\n const existed = bindings.delete(key);\n\n if (existed) rebuildTriggerCaches();\n\n return existed;\n }\n\n function removeBinding(shortcutStr: string): boolean {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n return removeByKey(key);\n }\n\n for (const [shortcutStr, value] of Object.entries(initialBindings)) {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n bindings.set(key, { shortcut, ...resolveBinding(value) });\n }\n\n rebuildTriggerCaches();\n\n const chordDown = createChordTracker(() => bindingsDown, chordTimeout);\n const chordUp = createChordTracker(() => bindingsUp, chordTimeout);\n const unmounts = new Set<() => void>();\n const mountCounts = new Map<EventTarget, number>();\n\n function makeHandler(chord: ReturnType<typeof createChordTracker>) {\n return function handleEvent(event: KeyboardEvent): void {\n if (globalWhen && !globalWhen()) return;\n\n const binding = chord.advance(event);\n\n if (!binding) return;\n\n if (binding.when && !binding.when()) return;\n\n if (preventDefault) event.preventDefault();\n\n if (stopPropagation) event.stopPropagation();\n\n binding.handler(event);\n };\n }\n\n const handleKeydown = makeHandler(chordDown);\n const handleKeyup = makeHandler(chordUp);\n const ac = new AbortController();\n let isDisposed = false;\n\n return {\n bind(shortcutStr: string, value: BindingValue): () => void {\n const key = addBinding(shortcutStr, value);\n\n return () => {\n removeByKey(key);\n };\n },\n\n get disposalSignal(): AbortSignal {\n return ac.signal;\n },\n\n dispose(): void {\n if (isDisposed) return;\n\n isDisposed = true;\n ac.abort();\n for (const unmount of unmounts) unmount();\n unmounts.clear();\n chordDown.reset();\n chordUp.reset();\n },\n\n get disposed(): boolean {\n return isDisposed;\n },\n\n listBindings(): readonly BindingEntry[] {\n return [...bindings.values()].map((b) => ({\n priority: b.priority,\n shortcut: b.shortcut.map((s) => ({ key: s.key, modifiers: new Set(s.modifiers) })),\n trigger: b.trigger,\n }));\n },\n\n mount(target: EventTarget): () => void {\n const priorCount = mountCounts.get(target) ?? 0;\n\n if (priorCount > 0) {\n warn('mount() called for a target that is already mounted — this registers a duplicate listener');\n }\n\n mountCounts.set(target, priorCount + 1);\n\n target.addEventListener('keydown', handleKeydown as EventListener);\n target.addEventListener('keyup', handleKeyup as EventListener);\n\n const unmount = (): void => {\n target.removeEventListener('keydown', handleKeydown as EventListener);\n target.removeEventListener('keyup', handleKeyup as EventListener);\n unmounts.delete(unmount);\n\n const remaining = (mountCounts.get(target) ?? 1) - 1;\n\n if (remaining <= 0) mountCounts.delete(target);\n else mountCounts.set(target, remaining);\n };\n\n unmounts.add(unmount);\n\n return unmount;\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcutStr: string): void {\n const existed = removeBinding(shortcutStr);\n\n if (!existed) {\n warn(`unbind() called for unknown shortcut: \"${shortcutStr}\"`);\n }\n },\n };\n}\n\nexport type { BindingOptions };\n","import type { BindingValue, Keymap, KeymapOptions } from './types';\n\nimport { createKeymap } from './keymap';\n\n/\n Creates a scoped keymap layer that sits on top of a parent keymap.\n \n The caller is responsible for mounting and disposing the parent independently.\n * `layer.mount(target)` only attaches the layer's own shortcuts — it does not touch\n * the parent. `layer.dispose()` only tears down the layer — it does not dispose the parent.\n \n While the layer is active, matching shortcuts are handled by the layer. Call\n * `layer.deactivate()` to suspend the layer and `layer.activate()` to re-enable it.\n \n @example\n * const base = createKeymap({ 'ctrl+z': undo });\n * const modal = createKeymapLayer(base, {\n * esc: { handler: closeModal, when: () => isModalOpen() },\n * });\n * // Mount both independently — the layer does NOT auto-mount the parent.\n * const unmountBase = base.mount(document);\n * const unmountModal = modal.mount(document);\n \n modal.deactivate(); // base handles everything; layer is suspended\n * modal.activate(); // layer is active again\n */\nexport interface KeymapLayer extends Keymap {\n activate(): void;\n deactivate(): void;\n readonly active: boolean;\n readonly parent: Keymap;\n}\n\nexport function createKeymapLayer(\n parent: Keymap,\n initialBindings: Record<string, BindingValue> = {},\n options: KeymapOptions = {},\n): KeymapLayer {\n let isActive = true;\n\n const layer = createKeymap(initialBindings, {\n ...options,\n when: () => isActive && (options.when?.() ?? true),\n });\n\n return {\n activate(): void {\n isActive = true;\n },\n\n get active() {\n return isActive;\n },\n\n bind(shortcut: string, value: BindingValue): () => void {\n return layer.bind(shortcut, value);\n },\n\n deactivate(): void {\n isActive = false;\n },\n\n get disposalSignal(): AbortSignal {\n return layer.disposalSignal;\n },\n\n dispose(): void {\n layer.dispose();\n },\n\n get disposed(): boolean {\n return layer.disposed;\n },\n\n listBindings() {\n return layer.listBindings();\n },\n\n mount(target: EventTarget): () => void {\n return layer.mount(target);\n },\n\n get parent() {\n return parent;\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcut: string): void {\n layer.unbind(shortcut);\n },\n };\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"keymap.iife.js","names":[],"sources":["../src/errors.ts","../src/parser.ts","../src/conflicts.ts","../src/_dev.ts","../src/format.ts","../src/keymap.ts"],"sourcesContent":["/** Base class for all keymap errors. Use `instanceof KeymapError` to catch any keymap-originated error. /\nexport class KeymapError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static is(err: unknown): err is KeymapError {\n return err instanceof KeymapError;\n }\n}\n\n/* Thrown when a shortcut string cannot be parsed — ambiguous or invalid key step. /\nexport class KeymapParseError extends KeymapError {}\n","import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction parseStepStrict(raw: string, modKey: 'ctrl' \| 'meta'): ShortcutStep {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((part) => part.toLowerCase());\n\n if (parts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n const aliases: Record<string, ModifierKey> = { ...MODIFIER_ALIASES_BASE, mod: modKey };\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const modifier = Object.hasOwn(aliases, part) ? aliases[part]! : undefined;\n\n if (modifier) modifiers.add(modifier);\n else keyParts.push(part);\n }\n\n if (keyParts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const rawKey = keyParts[0]!;\n const key = Object.hasOwn(SPECIAL_KEY_ALIASES, rawKey) ? SPECIAL_KEY_ALIASES[rawKey]! : rawKey;\n\n return { key, modifiers };\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n try {\n return parseStepStrict(raw, modKey);\n } catch {\n return null;\n }\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n const steps = raw.trim().split(/\\s+/).filter(Boolean);\n\n if (steps.length === 0) throw new KeymapParseError('Shortcut must contain at least one key step');\n\n return steps.map((step) => parseStepStrict(step, modKey));\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((step) => {\n const modifiers = [...step.modifiers].sort().join('+');\n\n return modifiers ? `${modifiers}+${step.key}` : step.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n return (\n event.altKey === modifiers.has('alt') &&\n event.ctrlKey === modifiers.has('ctrl') &&\n event.metaKey === modifiers.has('meta') &&\n event.shiftKey === modifiers.has('shift')\n );\n}\n","import type { ShortcutStep } from './parser';\nimport { canonicalizeShortcut, parseShortcut } from './parser';\nimport type { BindingEntry } from './types';\n\nexport interface ConflictOptions {\n modKey?: 'ctrl' \| 'meta';\n trigger?: 'keydown' \| 'keyup';\n}\n\nfunction isPrefixOf(shorter: readonly ShortcutStep[], longer: readonly ShortcutStep[]): boolean {\n if (shorter.length > longer.length) return false;\n\n return canonicalizeShortcut(shorter) === canonicalizeShortcut(longer.slice(0, shorter.length));\n}\n\n/\n Finds registered bindings that would conflict with a proposed shortcut — an exact duplicate, a\n * shorter binding that would shadow it as a chord prefix, or a longer binding it would itself\n * shadow. Only compares against entries sharing the same `trigger` — `'keydown'` and `'keyup'`\n * chords are matched independently and never conflict with each other.\n \n @example\n * const entries = map.listBindings();\n * findShortcutConflicts('g g', entries); // → the entry for 'g', if one is bound\n /\nexport function findShortcutConflicts(\n shortcut: string,\n entries: readonly BindingEntry[],\n options: ConflictOptions = {},\n): BindingEntry[] {\n const { modKey, trigger = 'keydown' } = options;\n\n // An empty/whitespace-only shortcut would be a trivial prefix of every entry — never report it\n // as a conflict.\n if (shortcut.trim() === '') return [];\n\n const steps = parseShortcut(shortcut, modKey);\n\n return entries.filter(\n (entry) => entry.trigger === trigger && (isPrefixOf(steps, entry.shortcut) \|\| isPrefixOf(entry.shortcut, steps)),\n );\n}\n","const isDev = !(globalThis as { __KEYMAP_PROD__?: boolean }).__KEYMAP_PROD__;\n\n/* @internal /\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/keymap] ${msg}`);\n}\n\n/* @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. /\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { warn } from './_dev';\nimport { detectModKey, parseShortcut } from './parser';\n\nconst KEY_SYMBOLS: Record<string, string> = {\n ' ': 'Space',\n arrowdown: '↓',\n arrowleft: '←',\n arrowright: '→',\n arrowup: '↑',\n backspace: '⌫',\n delete: '⌦',\n end: 'End',\n enter: '↵',\n escape: 'Esc',\n home: 'Home',\n pagedown: 'PgDn',\n pageup: 'PgUp',\n tab: '⇥',\n};\n\nconst MOD_SYMBOLS_MAC: Record<string, string> = {\n alt: '⌥',\n ctrl: '⌃',\n meta: '⌘',\n shift: '⇧',\n};\n\nconst MOD_LABELS_OTHER: Record<string, string> = {\n alt: 'Alt',\n ctrl: 'Ctrl',\n meta: 'Win',\n shift: 'Shift',\n};\n\nconst MOD_ORDER = ['ctrl', 'alt', 'shift', 'meta'] as const;\n\n/\n Formats a shortcut string into a human-readable display string.\n \n On Mac (when `modKey` is `'meta'`), uses standard Mac symbols (⌘, ⌥, ⇧, ⌃).\n * On other platforms, uses word labels (Ctrl, Alt, Shift, Win).\n \n @example\n * formatShortcut('mod+shift+p', 'meta') // '⇧⌘P' (canonical order: ctrl, alt, shift, meta)\n * formatShortcut('mod+shift+p', 'ctrl') // 'Ctrl+Shift+P'\n * formatShortcut('ctrl+k ctrl+s', 'meta') // '⌃K ⌃S'\n /\nexport function formatShortcut(shortcut: string, modKey: 'ctrl' \| 'meta' = detectModKey()): string {\n if (!shortcut.trim()) {\n warn(`formatShortcut() received an empty shortcut string`);\n\n return '';\n }\n\n let steps: ReturnType<typeof parseShortcut>;\n\n try {\n steps = parseShortcut(shortcut, modKey);\n } catch {\n warn(`formatShortcut() received an invalid shortcut: \"${shortcut}\"`);\n\n return '';\n }\n\n const isMac = modKey === 'meta';\n\n return steps\n .map((step) => {\n const modParts = MOD_ORDER.filter((m) => step.modifiers.has(m)).map((m) =>\n isMac ? MOD_SYMBOLS_MAC[m] : MOD_LABELS_OTHER[m],\n );\n\n const keyLabel = KEY_SYMBOLS[step.key] ?? step.key.toUpperCase();\n\n return isMac ? `${modParts.join('')}${keyLabel}` : [...modParts, keyLabel].join('+');\n })\n .join(' ');\n}\n","import { warn } from './_dev';\nimport { KeymapError } from './errors';\nimport type { Shortcut, ShortcutStep } from './parser';\nimport { canonicalizeShortcut, detectModKey, matchStep, parseShortcut } from './parser';\nimport type { BindingEntry, BindingValue, ChordStateChange, Handler, Keymap, KeymapOptions, When } from './types';\n\ntype ParsedBinding = {\n handler: Handler;\n shortcut: Shortcut;\n trigger: 'keydown' \| 'keyup';\n when?: When;\n};\n\ntype ChordTracker = ReturnType<typeof createChordTracker>;\ntype MountedTarget = {\n keydown: ChordTracker;\n keyup: ChordTracker;\n onKeydown: EventListener;\n onKeyup: EventListener;\n refs: number;\n};\n\nfunction resolveBinding(value: BindingValue): Omit<ParsedBinding, 'shortcut'> {\n if (typeof value === 'function') return { handler: value, trigger: 'keydown' };\n\n return {\n handler: value.handler,\n trigger: value.trigger ?? 'keydown',\n when: value.when,\n };\n}\n\ntype ChordTrackerCallbacks = {\n onChordStart?: (target: EventTarget, step: ShortcutStep, trigger: 'keydown' \| 'keyup') => void;\n onChordProgress?: (target: EventTarget, steps: readonly ShortcutStep[], trigger: 'keydown' \| 'keyup') => void;\n onChordTimeout?: (target: EventTarget, trigger: 'keydown' \| 'keyup') => void;\n};\n\nfunction createChordTracker(\n getBindings: () => ParsedBinding[],\n chordTimeout: number,\n target: EventTarget,\n trigger: 'keydown' \| 'keyup',\n callbacks?: ChordTrackerCallbacks,\n) {\n let pendingIndex = 0;\n let candidates: ParsedBinding[] = [];\n let timer: ReturnType<typeof setTimeout> \| undefined;\n let pendingSteps: ShortcutStep[] = [];\n\n function reset(emitTimeout = false): void {\n if (timer !== undefined) clearTimeout(timer);\n\n // Emit timeout only if explicitly requested (from timeout event)\n if (emitTimeout && pendingIndex > 0 && callbacks?.onChordTimeout) {\n try {\n callbacks.onChordTimeout(target, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n timer = undefined;\n pendingIndex = 0;\n candidates = [];\n pendingSteps = [];\n }\n\n function advance(event: KeyboardEvent): ParsedBinding \| undefined {\n const pool = pendingIndex === 0 ? getBindings() : candidates;\n const matched = pool.filter((binding) => {\n const step = binding.shortcut[pendingIndex];\n\n return step !== undefined && matchStep(event, step);\n });\n\n if (matched.length === 0) {\n const retryFromRoot = pendingIndex !== 0;\n\n reset();\n\n return retryFromRoot ? advance(event) : undefined;\n }\n\n if (timer !== undefined) clearTimeout(timer);\n\n timer = undefined;\n\n const completed = matched.find((binding) => binding.shortcut.length === pendingIndex + 1);\n\n if (completed) {\n reset();\n\n return completed;\n }\n\n // New step in chord progression\n const currentStep = matched[0]!.shortcut[pendingIndex];\n pendingSteps = matched[0]!.shortcut.slice(0, pendingIndex + 1);\n\n // Emit started or progressed\n if (pendingIndex === 0 && callbacks?.onChordStart) {\n try {\n callbacks.onChordStart(target, currentStep, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n } else if (pendingIndex > 0 && callbacks?.onChordProgress) {\n try {\n callbacks.onChordProgress(target, pendingSteps, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n candidates = matched;\n pendingIndex += 1;\n timer = setTimeout(() => reset(true), chordTimeout);\n\n return undefined;\n }\n\n return { advance, reset: () => reset() };\n}\n\n/\n Creates a headless keyboard shortcut manager with target-local chord state.\n \n Pass a bindings map of shortcut strings to handlers or `BindingOptions`, then call\n * `.mount(target)` to attach to any `EventTarget`. Supports chord sequences\n * (e.g. `\"ctrl+k ctrl+s\"`), per-binding `when` guards, `trigger` (keydown/keyup),\n * and dynamic `bind`/`unbind`.\n \n @example\n * const map = createKeymap({\n * 'mod+k mod+s': () => save(),\n * 'mod+shift+p': () => openPalette(),\n * 'g g': () => goToTop(),\n * esc: { handler: closePanel, when: (event) => !isEditableTarget(event.target) },\n * space: { handler: togglePlay, trigger: 'keyup' },\n * }, { modKey: 'ctrl' });\n * const unmount = map.mount(document);\n */\nexport function createKeymap(initialBindings: Record<string, BindingValue> = {}, options: KeymapOptions = {}): Keymap {\n const {\n chordTimeout: rawChordTimeout = 1000,\n modKey = detectModKey(),\n preventDefault = true,\n stopPropagation = false,\n when: globalWhen,\n onChordState: userOnChordState,\n } = options;\n const chordTimeout = Number.isFinite(rawChordTimeout) && rawChordTimeout > 0 ? rawChordTimeout : 1000;\n\n if (chordTimeout !== rawChordTimeout) {\n warn(`chordTimeout must be a positive finite number; received ${rawChordTimeout}. Using default of 1000ms.`);\n }\n\n const bindings = new Map<string, ParsedBinding>();\n const mounted = new Map<EventTarget, MountedTarget>();\n const disposalController = new AbortController();\n let bindingsDown: ParsedBinding[] = [];\n let bindingsUp: ParsedBinding[] = [];\n let disposed = false;\n\n function assertActive(): void {\n if (disposed) throw new KeymapError('Keymap is disposed');\n }\n\n function rebuildTriggerCaches(): void {\n bindingsDown = [];\n bindingsUp = [];\n\n for (const binding of bindings.values()) {\n if (binding.trigger === 'keydown') bindingsDown.push(binding);\n else bindingsUp.push(binding);\n }\n }\n\n function bindingKey(shortcut: string): string {\n return canonicalizeShortcut(parseShortcut(shortcut, modKey));\n }\n\n function addBinding(shortcut: string, value: BindingValue): string {\n const parsed = parseShortcut(shortcut, modKey);\n const key = canonicalizeShortcut(parsed);\n\n bindings.set(key, { shortcut: parsed, ...resolveBinding(value) });\n rebuildTriggerCaches();\n\n return key;\n }\n\n function removeByKey(key: string): boolean {\n const existed = bindings.delete(key);\n\n if (existed) rebuildTriggerCaches();\n\n return existed;\n }\n\n function emitChordState(change: ChordStateChange): void {\n if (!userOnChordState) return;\n\n try {\n userOnChordState(change);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n function makeHandler(target: EventTarget, chord: ChordTracker): EventListener {\n return (event) => {\n const path = typeof event.composedPath === 'function' ? event.composedPath() : [];\n const nearestMountedTarget = path.find((pathTarget) => mounted.has(pathTarget));\n\n if (nearestMountedTarget && nearestMountedTarget !== target) return;\n\n const keyboardEvent = event as KeyboardEvent;\n\n if (disposed) return;\n\n // Track chord progression (independent of guards)\n const binding = chord.advance(keyboardEvent);\n\n // Check guards AFTER tracking chord\n if (globalWhen && !globalWhen(keyboardEvent)) return;\n\n if (!binding \|\| (binding.when && !binding.when(keyboardEvent))) return;\n\n if (preventDefault) keyboardEvent.preventDefault();\n\n if (stopPropagation) keyboardEvent.stopPropagation();\n\n binding.handler(keyboardEvent);\n };\n }\n\n for (const [shortcut, value] of Object.entries(initialBindings)) addBinding(shortcut, value);\n\n return {\n bind(shortcut: string, value: BindingValue): () => void {\n assertActive();\n\n const key = addBinding(shortcut, value);\n\n return () => {\n if (!disposed) removeByKey(key);\n };\n },\n\n get disposalSignal(): AbortSignal {\n return disposalController.signal;\n },\n\n dispose(): void {\n if (disposed) return;\n\n disposed = true;\n disposalController.abort();\n\n for (const [target, record] of mounted) {\n target.removeEventListener('keydown', record.onKeydown);\n target.removeEventListener('keyup', record.onKeyup);\n record.keydown.reset();\n record.keyup.reset();\n }\n\n mounted.clear();\n bindings.clear();\n bindingsDown = [];\n bindingsUp = [];\n },\n\n get disposed(): boolean {\n return disposed;\n },\n\n listBindings(): readonly BindingEntry[] {\n return [...bindings.values()].map((binding) => ({\n shortcut: binding.shortcut.map((step) => ({ key: step.key, modifiers: new Set(step.modifiers) })),\n trigger: binding.trigger,\n }));\n },\n\n mount(target: EventTarget): () => void {\n assertActive();\n\n let record = mounted.get(target);\n\n if (!record) {\n const keydown = createChordTracker(() => bindingsDown, chordTimeout, target, 'keydown', {\n onChordProgress: (t, steps, trigger) => emitChordState({ steps, target: t, trigger, type: 'progressed' }),\n onChordStart: (t, step, trigger) => emitChordState({ step, target: t, trigger, type: 'started' }),\n onChordTimeout: (t, trigger) => emitChordState({ target: t, trigger, type: 'timeout' }),\n });\n const keyup = createChordTracker(() => bindingsUp, chordTimeout, target, 'keyup', {\n onChordProgress: (t, steps, trigger) => emitChordState({ steps, target: t, trigger, type: 'progressed' }),\n onChordStart: (t, step, trigger) => emitChordState({ step, target: t, trigger, type: 'started' }),\n onChordTimeout: (t, trigger) => emitChordState({ target: t, trigger, type: 'timeout' }),\n });\n const onKeydown = makeHandler(target, keydown);\n const onKeyup = makeHandler(target, keyup);\n\n record = { keydown, keyup, onKeydown, onKeyup, refs: 0 };\n mounted.set(target, record);\n target.addEventListener('keydown', onKeydown);\n target.addEventListener('keyup', onKeyup);\n }\n\n record.refs += 1;\n\n let unmounted = false;\n\n return () => {\n if (unmounted) return;\n\n unmounted = true;\n record!.refs -= 1;\n\n if (record?.refs > 0) return;\n\n target.removeEventListener('keydown', record?.onKeydown);\n target.removeEventListener('keyup', record?.onKeyup);\n record?.keydown.reset();\n record?.keyup.reset();\n mounted.delete(target);\n };\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcut: string): void {\n assertActive();\n\n if (!removeByKey(bindingKey(shortcut))) {\n warn(`unbind() called for unknown shortcut: \"${shortcut}\"`);\n }\n },\n };\n}\n"],"mappings":"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"}

package/dist/keymap.js CHANGED Viewed

@@ -1,2 +1,2 @@
-var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{constructor(e){super(e)}};function n(){if(typeof navigator>`u`)return`ctrl`;let e=navigator.userAgentData?.platform??navigator.platform??``;return/mac/i.test(e)?`meta`:`ctrl`}var r={alt:`alt`,cmd:`meta`,command:`meta`,control:`ctrl`,ctrl:`ctrl`,meta:`meta`,opt:`alt`,option:`alt`,shift:`shift`,win:`meta`},i={del:`delete`,down:`arrowdown`,esc:`escape`,left:`arrowleft`,right:`arrowright`,space:` `,spacebar:` `,up:`arrowup`};function a(e){return{...r,mod:e}}function o(e,t){let n=e.toLowerCase();return Object.hasOwn(t,n)?t[n]:null}function s(e){return Object.hasOwn(i,e)?i[e]:e}function c(e,r=n()){let i=e.trim().split(`+`).filter(Boolean).map(e=>e.toLowerCase());if(i.length===0)return null;let c=a(r),l=new Set,u=[];for(let e of i){let t=o(e,c);t?l.add(t):u.push(e)}if(u.length===0)return null;if(u.length>1)throw new t(`Ambiguous shortcut step: "${e}" — multiple non-modifier keys found`);return{key:s(u[0]),modifiers:l}}function l(e,r=n()){return e.trim().split(/\s+/).filter(Boolean).map(n=>{let i=c(n,r);if(i===null)throw new t(`Invalid shortcut step: "${n}" in "${e}"`);return i})}function u(e){return e.map(e=>{let t=[...e.modifiers].sort().join(`+`);return t?`${t}+${e.key}`:e.key}).join(` `)}function d(e,t){if(typeof e.key!=`string`||e.key.toLowerCase()!==t.key)return!1;let{modifiers:n}=t;return e.altKey===n.has(`alt`)&&e.ctrlKey===n.has(`ctrl`)&&e.metaKey===n.has(`meta`)&&e.shiftKey===n.has(`shift`)}function f(e,t){return e.length>t.length?!1:u(e)===u(t.slice(0,e.length))}function p(e,t,n={}){let{modKey:r,trigger:i=`keydown`}=n,a=l(e,r);return a.length===0?[]:t.filter(e=>e.trigger===i&&(f(a,e.shortcut)||f(e.shortcut,a)))}var m={" ":`Space`,arrowdown:`↓`,arrowleft:`←`,arrowright:`→`,arrowup:`↑`,backspace:`⌫`,delete:`⌦`,end:`End`,enter:`↵`,escape:`Esc`,home:`Home`,pagedown:`PgDn`,pageup:`PgUp`,tab:`⇥`},h={alt:`⌥`,ctrl:`⌃`,meta:`⌘`,shift:`⇧`},g={alt:`Alt`,ctrl:`Ctrl`,meta:`Win`,shift:`Shift`},_=[`ctrl`,`alt`,`shift`,`meta`];function v(e,t=n()){if(!e.trim())return``;let r;try{r=l(e,t)}catch{return`${e}`,``}let i=t===`meta`;return r.map(e=>{let t=_.filter(t=>e.modifiers.has(t)).map(e=>i?h[e]:g[e]),n=m[e.key]??e.key.toUpperCase();return i?`${t.join(``)}${n}`:[...t,n].join(`+`)}).join(` `)}function y(e){if(typeof e==`function`)return{handler:e,priority:0,trigger:`keydown`};let t=e.priority??0;return Number.isFinite(t)||`${t}`,{handler:e.handler,priority:Number.isFinite(t)?t:0,trigger:e.trigger??`keydown`,when:e.when}}function b(e,t){let n=0,r=[],i=null;function a(){i!==null&&(clearTimeout(i),i=null)}function o(){a(),n=0,r=[]}function s(c){let l=n===0?e():r,u=[];for(let e of l){let t=e.shortcut[n];t&&d(c,t)&&u.push(e)}if(u.length===0){let e=n!==0;return o(),e?s(c):null}a();let f=u.find(e=>e.shortcut.length===n+1);return f?(o(),f):(r=u,n++,i=setTimeout(o,t),null)}return{advance:s,reset:o}}function x(e={},t={}){let{chordTimeout:r=1e3,modKey:i=n(),preventDefault:a=!0,stopPropagation:o=!1,when:s}=t,c=Number.isFinite(r)&&r>0?r:1e3;c!==r&&`${r}`;let d=new Map,f=[],p=[];function m(){f=[],p=[];for(let e of d.values())e.trigger===`keydown`?f.push(e):p.push(e)}function h(e,t){let n=l(e,i),r=u(n);return d.set(r,{shortcut:n,...y(t)}),m(),r}function g(e){let t=d.delete(e);return t&&m(),t}function _(e){return g(u(l(e,i)))}for(let[t,n]of Object.entries(e)){let e=l(t,i),r=u(e);d.set(r,{shortcut:e,...y(n)})}m();let v=b(()=>f,c),x=b(()=>p,c),S=new Set,C=new Map;function w(e){return function(t){if(s&&!s())return;let n=e.advance(t);n&&(n.when&&!n.when()||(a&&t.preventDefault(),o&&t.stopPropagation(),n.handler(t)))}}let T=w(v),E=w(x),D=new AbortController,O=!1;return{bind(e,t){let n=h(e,t);return()=>{g(n)}},get disposalSignal(){return D.signal},dispose(){if(!O){O=!0,D.abort();for(let e of S)e();S.clear(),v.reset(),x.reset()}},get disposed(){return O},listBindings(){return[...d.values()].map(e=>({priority:e.priority,shortcut:e.shortcut.map(e=>({key:e.key,modifiers:new Set(e.modifiers)})),trigger:e.trigger}))},mount(e){let t=C.get(e)??0;C.set(e,t+1),e.addEventListener(`keydown`,T),e.addEventListener(`keyup`,E);let n=()=>{e.removeEventListener(`keydown`,T),e.removeEventListener(`keyup`,E),S.delete(n);let t=(C.get(e)??1)-1;t<=0?C.delete(e):C.set(e,t)};return S.add(n),n},[Symbol.dispose](){this.dispose()},unbind(e){_(e)||`${e}`}}}function S(e,t={},n={}){let r=!0,i=x(t,{...n,when:()=>r&&(n.when?.()??!0)});return{activate(){r=!0},get active(){return r},bind(e,t){return i.bind(e,t)},deactivate(){r=!1},get disposalSignal(){return i.disposalSignal},dispose(){i.dispose()},get disposed(){return i.disposed},listBindings(){return i.listBindings()},mount(e){return i.mount(e)},get parent(){return e},[Symbol.dispose](){this.dispose()},unbind(e){i.unbind(e)}}}export{e as KeymapError,t as KeymapParseError,u as canonicalizeShortcut,x as createKeymap,S as createKeymapLayer,n as detectModKey,p as findShortcutConflicts,v as formatShortcut,d as matchStep,l as parseShortcut,c as parseStep};
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{};function n(){if(typeof navigator>`u`)return`ctrl`;let e=navigator.userAgentData?.platform??navigator.platform??``;return/mac/i.test(e)?`meta`:`ctrl`}var r={alt:`alt`,cmd:`meta`,command:`meta`,control:`ctrl`,ctrl:`ctrl`,meta:`meta`,opt:`alt`,option:`alt`,shift:`shift`,win:`meta`},i={del:`delete`,down:`arrowdown`,esc:`escape`,left:`arrowleft`,right:`arrowright`,space:` `,spacebar:` `,up:`arrowup`};function a(e,n){let a=e.trim().split(`+`).filter(Boolean).map(e=>e.toLowerCase());if(a.length===0)throw new t(`Invalid shortcut step: "${e}"`);let o={...r,mod:n},s=new Set,c=[];for(let e of a){let t=Object.hasOwn(o,e)?o[e]:void 0;t?s.add(t):c.push(e)}if(c.length===0)throw new t(`Invalid shortcut step: "${e}"`);if(c.length>1)throw new t(`Ambiguous shortcut step: "${e}" — multiple non-modifier keys found`);let l=c[0];return{key:Object.hasOwn(i,l)?i[l]:l,modifiers:s}}function o(e,t=n()){try{return a(e,t)}catch{return null}}function s(e,r=n()){let i=e.trim().split(/\s+/).filter(Boolean);if(i.length===0)throw new t(`Shortcut must contain at least one key step`);return i.map(e=>a(e,r))}function c(e){return e.map(e=>{let t=[...e.modifiers].sort().join(`+`);return t?`${t}+${e.key}`:e.key}).join(` `)}function l(e,t){if(typeof e.key!=`string`||e.key.toLowerCase()!==t.key)return!1;let{modifiers:n}=t;return e.altKey===n.has(`alt`)&&e.ctrlKey===n.has(`ctrl`)&&e.metaKey===n.has(`meta`)&&e.shiftKey===n.has(`shift`)}function u(e,t){return e.length>t.length?!1:c(e)===c(t.slice(0,e.length))}function d(e,t,n={}){let{modKey:r,trigger:i=`keydown`}=n;if(e.trim()===``)return[];let a=s(e,r);return t.filter(e=>e.trigger===i&&(u(a,e.shortcut)||u(e.shortcut,a)))}var f={" ":`Space`,arrowdown:`↓`,arrowleft:`←`,arrowright:`→`,arrowup:`↑`,backspace:`⌫`,delete:`⌦`,end:`End`,enter:`↵`,escape:`Esc`,home:`Home`,pagedown:`PgDn`,pageup:`PgUp`,tab:`⇥`},p={alt:`⌥`,ctrl:`⌃`,meta:`⌘`,shift:`⇧`},m={alt:`Alt`,ctrl:`Ctrl`,meta:`Win`,shift:`Shift`},h=[`ctrl`,`alt`,`shift`,`meta`];function g(e,t=n()){if(!e.trim())return``;let r;try{r=s(e,t)}catch{return`${e}`,``}let i=t===`meta`;return r.map(e=>{let t=h.filter(t=>e.modifiers.has(t)).map(e=>i?p[e]:m[e]),n=f[e.key]??e.key.toUpperCase();return i?`${t.join(``)}${n}`:[...t,n].join(`+`)}).join(` `)}function _(e){return typeof e==`function`?{handler:e,trigger:`keydown`}:{handler:e.handler,trigger:e.trigger??`keydown`,when:e.when}}function v(e,t,n,r,i){let a=0,o=[],s,c=[];function u(e=!1){if(s!==void 0&&clearTimeout(s),e&&a>0&&i?.onChordTimeout)try{i.onChordTimeout(n,r)}catch(e){`${e instanceof Error?e.message:String(e)}`}s=void 0,a=0,o=[],c=[]}function d(f){let p=(a===0?e():o).filter(e=>{let t=e.shortcut[a];return t!==void 0&&l(f,t)});if(p.length===0){let e=a!==0;return u(),e?d(f):void 0}s!==void 0&&clearTimeout(s),s=void 0;let m=p.find(e=>e.shortcut.length===a+1);if(m)return u(),m;let h=p[0].shortcut[a];if(c=p[0].shortcut.slice(0,a+1),a===0&&i?.onChordStart)try{i.onChordStart(n,h,r)}catch(e){`${e instanceof Error?e.message:String(e)}`}else if(a>0&&i?.onChordProgress)try{i.onChordProgress(n,c,r)}catch(e){`${e instanceof Error?e.message:String(e)}`}o=p,a+=1,s=setTimeout(()=>u(!0),t)}return{advance:d,reset:()=>u()}}function y(t={},r={}){let{chordTimeout:i=1e3,modKey:a=n(),preventDefault:o=!0,stopPropagation:l=!1,when:u,onChordState:d}=r,f=Number.isFinite(i)&&i>0?i:1e3;f!==i&&`${i}`;let p=new Map,m=new Map,h=new AbortController,g=[],y=[],b=!1;function x(){if(b)throw new e(`Keymap is disposed`)}function S(){g=[],y=[];for(let e of p.values())e.trigger===`keydown`?g.push(e):y.push(e)}function C(e){return c(s(e,a))}function w(e,t){let n=s(e,a),r=c(n);return p.set(r,{shortcut:n,..._(t)}),S(),r}function T(e){let t=p.delete(e);return t&&S(),t}function E(e){if(d)try{d(e)}catch(e){`${e instanceof Error?e.message:String(e)}`}}function D(e,t){return n=>{let r=(typeof n.composedPath==`function`?n.composedPath():[]).find(e=>m.has(e));if(r&&r!==e)return;let i=n;if(b)return;let a=t.advance(i);u&&!u(i)||!a||a.when&&!a.when(i)||(o&&i.preventDefault(),l&&i.stopPropagation(),a.handler(i))}}for(let[e,n]of Object.entries(t))w(e,n);return{bind(e,t){x();let n=w(e,t);return()=>{b||T(n)}},get disposalSignal(){return h.signal},dispose(){if(!b){b=!0,h.abort();for(let[e,t]of m)e.removeEventListener(`keydown`,t.onKeydown),e.removeEventListener(`keyup`,t.onKeyup),t.keydown.reset(),t.keyup.reset();m.clear(),p.clear(),g=[],y=[]}},get disposed(){return b},listBindings(){return[...p.values()].map(e=>({shortcut:e.shortcut.map(e=>({key:e.key,modifiers:new Set(e.modifiers)})),trigger:e.trigger}))},mount(e){x();let t=m.get(e);if(!t){let n=v(()=>g,f,e,`keydown`,{onChordProgress:(e,t,n)=>E({steps:t,target:e,trigger:n,type:`progressed`}),onChordStart:(e,t,n)=>E({step:t,target:e,trigger:n,type:`started`}),onChordTimeout:(e,t)=>E({target:e,trigger:t,type:`timeout`})}),r=v(()=>y,f,e,`keyup`,{onChordProgress:(e,t,n)=>E({steps:t,target:e,trigger:n,type:`progressed`}),onChordStart:(e,t,n)=>E({step:t,target:e,trigger:n,type:`started`}),onChordTimeout:(e,t)=>E({target:e,trigger:t,type:`timeout`})}),i=D(e,n),a=D(e,r);t={keydown:n,keyup:r,onKeydown:i,onKeyup:a,refs:0},m.set(e,t),e.addEventListener(`keydown`,i),e.addEventListener(`keyup`,a)}t.refs+=1;let n=!1;return()=>{n||(n=!0,--t.refs,!(t?.refs>0)&&(e.removeEventListener(`keydown`,t?.onKeydown),e.removeEventListener(`keyup`,t?.onKeyup),t?.keydown.reset(),t?.keyup.reset(),m.delete(e)))}},[Symbol.dispose](){this.dispose()},unbind(e){x(),T(C(e))||`${e}`}}}export{e as KeymapError,t as KeymapParseError,c as canonicalizeShortcut,y as createKeymap,n as detectModKey,d as findShortcutConflicts,g as formatShortcut,l as matchStep,s as parseShortcut,o as parseStep};
 //# sourceMappingURL=keymap.js.map

package/dist/keymap.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"keymap.js","names":[],"sources":["../src/errors.ts","../src/parser.ts","../src/conflicts.ts","../src/_dev.ts","../src/format.ts","../src/keymap.ts","../src/layer.ts"],"sourcesContent":["/** Base class for all keymap errors. Use `instanceof KeymapError` to catch any keymap-originated error. /\nexport class KeymapError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static is(err: unknown): err is KeymapError {\n return err instanceof KeymapError;\n }\n}\n\n/* Thrown when a shortcut string cannot be parsed — ambiguous or invalid key step. /\nexport class KeymapParseError extends KeymapError {\n constructor(message: string) {\n super(message);\n }\n}\n","import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction buildModifierAliases(modKey: 'ctrl' \| 'meta'): Record<string, ModifierKey> {\n return { ...MODIFIER_ALIASES_BASE, mod: modKey };\n}\n\nfunction normalizeModifier(token: string, aliases: Record<string, ModifierKey>): ModifierKey \| null {\n const lower = token.toLowerCase();\n\n return Object.hasOwn(aliases, lower) ? aliases[lower]! : null;\n}\n\nfunction normalizeKey(raw: string): string {\n return Object.hasOwn(SPECIAL_KEY_ALIASES, raw) ? SPECIAL_KEY_ALIASES[raw]! : raw;\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((p) => p.toLowerCase());\n\n if (parts.length === 0) return null;\n\n const aliases = buildModifierAliases(modKey);\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const mod = normalizeModifier(part, aliases);\n\n if (mod) {\n modifiers.add(mod);\n } else {\n keyParts.push(part);\n }\n }\n\n if (keyParts.length === 0) return null;\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const key = normalizeKey(keyParts[0]);\n\n return { key, modifiers };\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n return raw\n .trim()\n .split(/\\s+/)\n .filter(Boolean)\n .map((step) => {\n const result = parseStep(step, modKey);\n\n if (result === null) {\n throw new KeymapParseError(`Invalid shortcut step: \"${step}\" in \"${raw}\"`);\n }\n\n return result;\n });\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((s) => {\n const mods = [...s.modifiers].sort().join('+');\n\n return mods ? `${mods}+${s.key}` : s.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n if (event.altKey !== modifiers.has('alt')) return false;\n\n if (event.ctrlKey !== modifiers.has('ctrl')) return false;\n\n if (event.metaKey !== modifiers.has('meta')) return false;\n\n if (event.shiftKey !== modifiers.has('shift')) return false;\n\n return true;\n}\n","import type { ShortcutStep } from './parser';\nimport type { BindingEntry } from './types';\n\nimport { canonicalizeShortcut, parseShortcut } from './parser';\n\nexport interface ConflictOptions {\n modKey?: 'ctrl' \| 'meta';\n trigger?: 'keydown' \| 'keyup';\n}\n\nfunction isPrefixOf(shorter: readonly ShortcutStep[], longer: readonly ShortcutStep[]): boolean {\n if (shorter.length > longer.length) return false;\n\n return canonicalizeShortcut(shorter) === canonicalizeShortcut(longer.slice(0, shorter.length));\n}\n\n/\n Finds registered bindings that would conflict with a proposed shortcut — an exact duplicate, a\n * shorter binding that would shadow it as a chord prefix, or a longer binding it would itself\n * shadow. Only compares against entries sharing the same `trigger` — `'keydown'` and `'keyup'`\n * chords are matched independently and never conflict with each other.\n \n @example\n * const entries = map.listBindings();\n * findShortcutConflicts('g g', entries); // → the entry for 'g', if one is bound\n /\nexport function findShortcutConflicts(\n shortcut: string,\n entries: readonly BindingEntry[],\n options: ConflictOptions = {},\n): BindingEntry[] {\n const { modKey, trigger = 'keydown' } = options;\n const steps = parseShortcut(shortcut, modKey);\n\n // An empty/whitespace-only shortcut parses to zero steps, which would otherwise be treated as\n // a trivial prefix of every entry — never report that as a conflict.\n if (steps.length === 0) return [];\n\n return entries.filter(\n (entry) => entry.trigger === trigger && (isPrefixOf(steps, entry.shortcut) \|\| isPrefixOf(entry.shortcut, steps)),\n );\n}\n","const isDev = !(globalThis as { __KEYMAP_PROD__?: boolean }).__KEYMAP_PROD__;\n\n/* @internal /\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/keymap] ${msg}`);\n}\n\n/* @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. /\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { warn } from './_dev';\nimport { detectModKey, parseShortcut } from './parser';\n\nconst KEY_SYMBOLS: Record<string, string> = {\n ' ': 'Space',\n arrowdown: '↓',\n arrowleft: '←',\n arrowright: '→',\n arrowup: '↑',\n backspace: '⌫',\n delete: '⌦',\n end: 'End',\n enter: '↵',\n escape: 'Esc',\n home: 'Home',\n pagedown: 'PgDn',\n pageup: 'PgUp',\n tab: '⇥',\n};\n\nconst MOD_SYMBOLS_MAC: Record<string, string> = {\n alt: '⌥',\n ctrl: '⌃',\n meta: '⌘',\n shift: '⇧',\n};\n\nconst MOD_LABELS_OTHER: Record<string, string> = {\n alt: 'Alt',\n ctrl: 'Ctrl',\n meta: 'Win',\n shift: 'Shift',\n};\n\nconst MOD_ORDER = ['ctrl', 'alt', 'shift', 'meta'] as const;\n\n/\n Formats a shortcut string into a human-readable display string.\n \n On Mac (when `modKey` is `'meta'`), uses standard Mac symbols (⌘, ⌥, ⇧, ⌃).\n * On other platforms, uses word labels (Ctrl, Alt, Shift, Win).\n \n @example\n * formatShortcut('mod+shift+p', 'meta') // '⇧⌘P' (canonical order: ctrl, alt, shift, meta)\n * formatShortcut('mod+shift+p', 'ctrl') // 'Ctrl+Shift+P'\n * formatShortcut('ctrl+k ctrl+s', 'meta') // '⌃K ⌃S'\n /\nexport function formatShortcut(shortcut: string, modKey: 'ctrl' \| 'meta' = detectModKey()): string {\n if (!shortcut.trim()) {\n warn(`formatShortcut() received an empty shortcut string`);\n\n return '';\n }\n\n let steps;\n\n try {\n steps = parseShortcut(shortcut, modKey);\n } catch {\n warn(`formatShortcut() received an invalid shortcut: \"${shortcut}\"`);\n\n return '';\n }\n\n const isMac = modKey === 'meta';\n\n return steps\n .map((step) => {\n const modParts = MOD_ORDER.filter((m) => step.modifiers.has(m)).map((m) =>\n isMac ? MOD_SYMBOLS_MAC[m] : MOD_LABELS_OTHER[m],\n );\n\n const keyLabel = KEY_SYMBOLS[step.key] ?? step.key.toUpperCase();\n\n return isMac ? `${modParts.join('')}${keyLabel}` : [...modParts, keyLabel].join('+');\n })\n .join(' ');\n}\n","import type { Shortcut } from './parser';\nimport type { BindingEntry, BindingOptions, BindingValue, Handler, Keymap, KeymapOptions } from './types';\n\nimport { warn } from './_dev';\nimport { canonicalizeShortcut, detectModKey, matchStep, parseShortcut } from './parser';\n\ntype ParsedBinding = {\n handler: Handler;\n priority: number;\n shortcut: Shortcut;\n trigger: 'keydown' \| 'keyup';\n when?: () => boolean;\n};\n\nfunction resolveBinding(value: BindingValue): Omit<ParsedBinding, 'shortcut'> {\n if (typeof value === 'function') {\n return { handler: value, priority: 0, trigger: 'keydown' };\n }\n\n const priority = value.priority ?? 0;\n\n if (!Number.isFinite(priority)) {\n warn(`binding priority must be a finite number; received ${priority}. Using 0.`);\n }\n\n return {\n handler: value.handler,\n priority: Number.isFinite(priority) ? priority : 0,\n trigger: value.trigger ?? 'keydown',\n when: value.when,\n };\n}\n\nfunction createChordTracker(getBindings: () => ParsedBinding[], chordTimeout: number) {\n let pendingIndex = 0;\n let candidates: ParsedBinding[] = [];\n let timer: ReturnType<typeof setTimeout> \| null = null;\n\n function clearTimer(): void {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n }\n\n function reset(): void {\n clearTimer();\n pendingIndex = 0;\n candidates = [];\n }\n\n function advance(event: KeyboardEvent): ParsedBinding \| null {\n // At the root of a chord, re-scan every binding. Mid-chord, narrow only within bindings that\n // already matched every prior step — never re-admit a binding whose earlier step didn't match.\n const pool = pendingIndex === 0 ? getBindings() : candidates;\n const matched: ParsedBinding[] = [];\n\n for (const binding of pool) {\n const step = binding.shortcut[pendingIndex];\n\n if (step && matchStep(event, step)) {\n matched.push(binding);\n }\n }\n\n if (matched.length === 0) {\n const wasPartial = pendingIndex !== 0;\n\n reset();\n\n if (wasPartial) {\n return advance(event);\n }\n\n return null;\n }\n\n clearTimer();\n\n // At most one binding can complete here — the bindings map is keyed by canonical shortcut,\n // so two live bindings can never share an identical step sequence. `priority` therefore never\n // has a real tie to resolve; the shortest completing match always fires immediately.\n const completed = matched.find((b) => b.shortcut.length === pendingIndex + 1);\n\n if (completed) {\n reset();\n\n return completed;\n }\n\n candidates = matched;\n pendingIndex++;\n timer = setTimeout(reset, chordTimeout);\n\n return null;\n }\n\n return { advance, reset };\n}\n\n/\n Creates a headless keyboard shortcut manager.\n \n Pass a bindings map of shortcut strings to handlers or `BindingOptions`, then call\n * `.mount(target)` to attach to any `EventTarget`. Supports chord sequences\n * (e.g. `\"ctrl+k ctrl+s\"`), per-binding `when` guards, `trigger` (keydown/keyup),\n * `priority`, and dynamic `bind`/`unbind`.\n \n @example\n * const map = createKeymap({\n * 'mod+k mod+s': () => save(),\n * 'mod+shift+p': () => openPalette(),\n * 'g g': () => goToTop(),\n * esc: { handler: closePanel, when: () => isPanelOpen() },\n * space: { handler: togglePlay, trigger: 'keyup' },\n * }, { modKey: 'ctrl' });\n * const unmount = map.mount(document);\n /\nexport function createKeymap(initialBindings: Record<string, BindingValue> = {}, options: KeymapOptions = {}): Keymap {\n const {\n chordTimeout: rawChordTimeout = 1000,\n modKey = detectModKey(),\n preventDefault = true,\n stopPropagation = false,\n when: globalWhen,\n } = options;\n\n const chordTimeout = Number.isFinite(rawChordTimeout) && rawChordTimeout > 0 ? rawChordTimeout : 1000;\n\n if (chordTimeout !== rawChordTimeout) {\n warn(`chordTimeout must be a positive finite number; received ${rawChordTimeout}. Using default of 1000ms.`);\n }\n\n const bindings = new Map<string, ParsedBinding>();\n let bindingsDown: ParsedBinding[] = [];\n let bindingsUp: ParsedBinding[] = [];\n\n function rebuildTriggerCaches(): void {\n bindingsDown = [];\n bindingsUp = [];\n\n for (const b of bindings.values()) {\n if (b.trigger === 'keydown') bindingsDown.push(b);\n else bindingsUp.push(b);\n }\n }\n\n function addBinding(shortcutStr: string, value: BindingValue): string {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n bindings.set(key, { shortcut, ...resolveBinding(value) });\n rebuildTriggerCaches();\n\n return key;\n }\n\n function removeByKey(key: string): boolean {\n const existed = bindings.delete(key);\n\n if (existed) rebuildTriggerCaches();\n\n return existed;\n }\n\n function removeBinding(shortcutStr: string): boolean {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n return removeByKey(key);\n }\n\n for (const [shortcutStr, value] of Object.entries(initialBindings)) {\n const shortcut = parseShortcut(shortcutStr, modKey);\n const key = canonicalizeShortcut(shortcut);\n\n bindings.set(key, { shortcut, ...resolveBinding(value) });\n }\n\n rebuildTriggerCaches();\n\n const chordDown = createChordTracker(() => bindingsDown, chordTimeout);\n const chordUp = createChordTracker(() => bindingsUp, chordTimeout);\n const unmounts = new Set<() => void>();\n const mountCounts = new Map<EventTarget, number>();\n\n function makeHandler(chord: ReturnType<typeof createChordTracker>) {\n return function handleEvent(event: KeyboardEvent): void {\n if (globalWhen && !globalWhen()) return;\n\n const binding = chord.advance(event);\n\n if (!binding) return;\n\n if (binding.when && !binding.when()) return;\n\n if (preventDefault) event.preventDefault();\n\n if (stopPropagation) event.stopPropagation();\n\n binding.handler(event);\n };\n }\n\n const handleKeydown = makeHandler(chordDown);\n const handleKeyup = makeHandler(chordUp);\n const ac = new AbortController();\n let isDisposed = false;\n\n return {\n bind(shortcutStr: string, value: BindingValue): () => void {\n const key = addBinding(shortcutStr, value);\n\n return () => {\n removeByKey(key);\n };\n },\n\n get disposalSignal(): AbortSignal {\n return ac.signal;\n },\n\n dispose(): void {\n if (isDisposed) return;\n\n isDisposed = true;\n ac.abort();\n for (const unmount of unmounts) unmount();\n unmounts.clear();\n chordDown.reset();\n chordUp.reset();\n },\n\n get disposed(): boolean {\n return isDisposed;\n },\n\n listBindings(): readonly BindingEntry[] {\n return [...bindings.values()].map((b) => ({\n priority: b.priority,\n shortcut: b.shortcut.map((s) => ({ key: s.key, modifiers: new Set(s.modifiers) })),\n trigger: b.trigger,\n }));\n },\n\n mount(target: EventTarget): () => void {\n const priorCount = mountCounts.get(target) ?? 0;\n\n if (priorCount > 0) {\n warn('mount() called for a target that is already mounted — this registers a duplicate listener');\n }\n\n mountCounts.set(target, priorCount + 1);\n\n target.addEventListener('keydown', handleKeydown as EventListener);\n target.addEventListener('keyup', handleKeyup as EventListener);\n\n const unmount = (): void => {\n target.removeEventListener('keydown', handleKeydown as EventListener);\n target.removeEventListener('keyup', handleKeyup as EventListener);\n unmounts.delete(unmount);\n\n const remaining = (mountCounts.get(target) ?? 1) - 1;\n\n if (remaining <= 0) mountCounts.delete(target);\n else mountCounts.set(target, remaining);\n };\n\n unmounts.add(unmount);\n\n return unmount;\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcutStr: string): void {\n const existed = removeBinding(shortcutStr);\n\n if (!existed) {\n warn(`unbind() called for unknown shortcut: \"${shortcutStr}\"`);\n }\n },\n };\n}\n\nexport type { BindingOptions };\n","import type { BindingValue, Keymap, KeymapOptions } from './types';\n\nimport { createKeymap } from './keymap';\n\n/\n Creates a scoped keymap layer that sits on top of a parent keymap.\n \n The caller is responsible for mounting and disposing the parent independently.\n * `layer.mount(target)` only attaches the layer's own shortcuts — it does not touch\n * the parent. `layer.dispose()` only tears down the layer — it does not dispose the parent.\n \n While the layer is active, matching shortcuts are handled by the layer. Call\n * `layer.deactivate()` to suspend the layer and `layer.activate()` to re-enable it.\n \n @example\n * const base = createKeymap({ 'ctrl+z': undo });\n * const modal = createKeymapLayer(base, {\n * esc: { handler: closeModal, when: () => isModalOpen() },\n * });\n * // Mount both independently — the layer does NOT auto-mount the parent.\n * const unmountBase = base.mount(document);\n * const unmountModal = modal.mount(document);\n \n modal.deactivate(); // base handles everything; layer is suspended\n * modal.activate(); // layer is active again\n */\nexport interface KeymapLayer extends Keymap {\n activate(): void;\n deactivate(): void;\n readonly active: boolean;\n readonly parent: Keymap;\n}\n\nexport function createKeymapLayer(\n parent: Keymap,\n initialBindings: Record<string, BindingValue> = {},\n options: KeymapOptions = {},\n): KeymapLayer {\n let isActive = true;\n\n const layer = createKeymap(initialBindings, {\n ...options,\n when: () => isActive && (options.when?.() ?? true),\n });\n\n return {\n activate(): void {\n isActive = true;\n },\n\n get active() {\n return isActive;\n },\n\n bind(shortcut: string, value: BindingValue): () => void {\n return layer.bind(shortcut, value);\n },\n\n deactivate(): void {\n isActive = false;\n },\n\n get disposalSignal(): AbortSignal {\n return layer.disposalSignal;\n },\n\n dispose(): void {\n layer.dispose();\n },\n\n get disposed(): boolean {\n return layer.disposed;\n },\n\n listBindings() {\n return layer.listBindings();\n },\n\n mount(target: EventTarget): () => void {\n return layer.mount(target);\n },\n\n get parent() {\n return parent;\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcut: string): void {\n layer.unbind(shortcut);\n },\n };\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"keymap.js","names":[],"sources":["../src/errors.ts","../src/parser.ts","../src/conflicts.ts","../src/_dev.ts","../src/format.ts","../src/keymap.ts"],"sourcesContent":["/** Base class for all keymap errors. Use `instanceof KeymapError` to catch any keymap-originated error. /\nexport class KeymapError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static is(err: unknown): err is KeymapError {\n return err instanceof KeymapError;\n }\n}\n\n/* Thrown when a shortcut string cannot be parsed — ambiguous or invalid key step. /\nexport class KeymapParseError extends KeymapError {}\n","import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction parseStepStrict(raw: string, modKey: 'ctrl' \| 'meta'): ShortcutStep {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((part) => part.toLowerCase());\n\n if (parts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n const aliases: Record<string, ModifierKey> = { ...MODIFIER_ALIASES_BASE, mod: modKey };\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const modifier = Object.hasOwn(aliases, part) ? aliases[part]! : undefined;\n\n if (modifier) modifiers.add(modifier);\n else keyParts.push(part);\n }\n\n if (keyParts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const rawKey = keyParts[0]!;\n const key = Object.hasOwn(SPECIAL_KEY_ALIASES, rawKey) ? SPECIAL_KEY_ALIASES[rawKey]! : rawKey;\n\n return { key, modifiers };\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n try {\n return parseStepStrict(raw, modKey);\n } catch {\n return null;\n }\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n const steps = raw.trim().split(/\\s+/).filter(Boolean);\n\n if (steps.length === 0) throw new KeymapParseError('Shortcut must contain at least one key step');\n\n return steps.map((step) => parseStepStrict(step, modKey));\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((step) => {\n const modifiers = [...step.modifiers].sort().join('+');\n\n return modifiers ? `${modifiers}+${step.key}` : step.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n return (\n event.altKey === modifiers.has('alt') &&\n event.ctrlKey === modifiers.has('ctrl') &&\n event.metaKey === modifiers.has('meta') &&\n event.shiftKey === modifiers.has('shift')\n );\n}\n","import type { ShortcutStep } from './parser';\nimport { canonicalizeShortcut, parseShortcut } from './parser';\nimport type { BindingEntry } from './types';\n\nexport interface ConflictOptions {\n modKey?: 'ctrl' \| 'meta';\n trigger?: 'keydown' \| 'keyup';\n}\n\nfunction isPrefixOf(shorter: readonly ShortcutStep[], longer: readonly ShortcutStep[]): boolean {\n if (shorter.length > longer.length) return false;\n\n return canonicalizeShortcut(shorter) === canonicalizeShortcut(longer.slice(0, shorter.length));\n}\n\n/\n Finds registered bindings that would conflict with a proposed shortcut — an exact duplicate, a\n * shorter binding that would shadow it as a chord prefix, or a longer binding it would itself\n * shadow. Only compares against entries sharing the same `trigger` — `'keydown'` and `'keyup'`\n * chords are matched independently and never conflict with each other.\n \n @example\n * const entries = map.listBindings();\n * findShortcutConflicts('g g', entries); // → the entry for 'g', if one is bound\n /\nexport function findShortcutConflicts(\n shortcut: string,\n entries: readonly BindingEntry[],\n options: ConflictOptions = {},\n): BindingEntry[] {\n const { modKey, trigger = 'keydown' } = options;\n\n // An empty/whitespace-only shortcut would be a trivial prefix of every entry — never report it\n // as a conflict.\n if (shortcut.trim() === '') return [];\n\n const steps = parseShortcut(shortcut, modKey);\n\n return entries.filter(\n (entry) => entry.trigger === trigger && (isPrefixOf(steps, entry.shortcut) \|\| isPrefixOf(entry.shortcut, steps)),\n );\n}\n","const isDev = !(globalThis as { __KEYMAP_PROD__?: boolean }).__KEYMAP_PROD__;\n\n/* @internal /\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/keymap] ${msg}`);\n}\n\n/* @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. /\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","import { warn } from './_dev';\nimport { detectModKey, parseShortcut } from './parser';\n\nconst KEY_SYMBOLS: Record<string, string> = {\n ' ': 'Space',\n arrowdown: '↓',\n arrowleft: '←',\n arrowright: '→',\n arrowup: '↑',\n backspace: '⌫',\n delete: '⌦',\n end: 'End',\n enter: '↵',\n escape: 'Esc',\n home: 'Home',\n pagedown: 'PgDn',\n pageup: 'PgUp',\n tab: '⇥',\n};\n\nconst MOD_SYMBOLS_MAC: Record<string, string> = {\n alt: '⌥',\n ctrl: '⌃',\n meta: '⌘',\n shift: '⇧',\n};\n\nconst MOD_LABELS_OTHER: Record<string, string> = {\n alt: 'Alt',\n ctrl: 'Ctrl',\n meta: 'Win',\n shift: 'Shift',\n};\n\nconst MOD_ORDER = ['ctrl', 'alt', 'shift', 'meta'] as const;\n\n/\n Formats a shortcut string into a human-readable display string.\n \n On Mac (when `modKey` is `'meta'`), uses standard Mac symbols (⌘, ⌥, ⇧, ⌃).\n * On other platforms, uses word labels (Ctrl, Alt, Shift, Win).\n \n @example\n * formatShortcut('mod+shift+p', 'meta') // '⇧⌘P' (canonical order: ctrl, alt, shift, meta)\n * formatShortcut('mod+shift+p', 'ctrl') // 'Ctrl+Shift+P'\n * formatShortcut('ctrl+k ctrl+s', 'meta') // '⌃K ⌃S'\n /\nexport function formatShortcut(shortcut: string, modKey: 'ctrl' \| 'meta' = detectModKey()): string {\n if (!shortcut.trim()) {\n warn(`formatShortcut() received an empty shortcut string`);\n\n return '';\n }\n\n let steps: ReturnType<typeof parseShortcut>;\n\n try {\n steps = parseShortcut(shortcut, modKey);\n } catch {\n warn(`formatShortcut() received an invalid shortcut: \"${shortcut}\"`);\n\n return '';\n }\n\n const isMac = modKey === 'meta';\n\n return steps\n .map((step) => {\n const modParts = MOD_ORDER.filter((m) => step.modifiers.has(m)).map((m) =>\n isMac ? MOD_SYMBOLS_MAC[m] : MOD_LABELS_OTHER[m],\n );\n\n const keyLabel = KEY_SYMBOLS[step.key] ?? step.key.toUpperCase();\n\n return isMac ? `${modParts.join('')}${keyLabel}` : [...modParts, keyLabel].join('+');\n })\n .join(' ');\n}\n","import { warn } from './_dev';\nimport { KeymapError } from './errors';\nimport type { Shortcut, ShortcutStep } from './parser';\nimport { canonicalizeShortcut, detectModKey, matchStep, parseShortcut } from './parser';\nimport type { BindingEntry, BindingValue, ChordStateChange, Handler, Keymap, KeymapOptions, When } from './types';\n\ntype ParsedBinding = {\n handler: Handler;\n shortcut: Shortcut;\n trigger: 'keydown' \| 'keyup';\n when?: When;\n};\n\ntype ChordTracker = ReturnType<typeof createChordTracker>;\ntype MountedTarget = {\n keydown: ChordTracker;\n keyup: ChordTracker;\n onKeydown: EventListener;\n onKeyup: EventListener;\n refs: number;\n};\n\nfunction resolveBinding(value: BindingValue): Omit<ParsedBinding, 'shortcut'> {\n if (typeof value === 'function') return { handler: value, trigger: 'keydown' };\n\n return {\n handler: value.handler,\n trigger: value.trigger ?? 'keydown',\n when: value.when,\n };\n}\n\ntype ChordTrackerCallbacks = {\n onChordStart?: (target: EventTarget, step: ShortcutStep, trigger: 'keydown' \| 'keyup') => void;\n onChordProgress?: (target: EventTarget, steps: readonly ShortcutStep[], trigger: 'keydown' \| 'keyup') => void;\n onChordTimeout?: (target: EventTarget, trigger: 'keydown' \| 'keyup') => void;\n};\n\nfunction createChordTracker(\n getBindings: () => ParsedBinding[],\n chordTimeout: number,\n target: EventTarget,\n trigger: 'keydown' \| 'keyup',\n callbacks?: ChordTrackerCallbacks,\n) {\n let pendingIndex = 0;\n let candidates: ParsedBinding[] = [];\n let timer: ReturnType<typeof setTimeout> \| undefined;\n let pendingSteps: ShortcutStep[] = [];\n\n function reset(emitTimeout = false): void {\n if (timer !== undefined) clearTimeout(timer);\n\n // Emit timeout only if explicitly requested (from timeout event)\n if (emitTimeout && pendingIndex > 0 && callbacks?.onChordTimeout) {\n try {\n callbacks.onChordTimeout(target, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n timer = undefined;\n pendingIndex = 0;\n candidates = [];\n pendingSteps = [];\n }\n\n function advance(event: KeyboardEvent): ParsedBinding \| undefined {\n const pool = pendingIndex === 0 ? getBindings() : candidates;\n const matched = pool.filter((binding) => {\n const step = binding.shortcut[pendingIndex];\n\n return step !== undefined && matchStep(event, step);\n });\n\n if (matched.length === 0) {\n const retryFromRoot = pendingIndex !== 0;\n\n reset();\n\n return retryFromRoot ? advance(event) : undefined;\n }\n\n if (timer !== undefined) clearTimeout(timer);\n\n timer = undefined;\n\n const completed = matched.find((binding) => binding.shortcut.length === pendingIndex + 1);\n\n if (completed) {\n reset();\n\n return completed;\n }\n\n // New step in chord progression\n const currentStep = matched[0]!.shortcut[pendingIndex];\n pendingSteps = matched[0]!.shortcut.slice(0, pendingIndex + 1);\n\n // Emit started or progressed\n if (pendingIndex === 0 && callbacks?.onChordStart) {\n try {\n callbacks.onChordStart(target, currentStep, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n } else if (pendingIndex > 0 && callbacks?.onChordProgress) {\n try {\n callbacks.onChordProgress(target, pendingSteps, trigger);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n candidates = matched;\n pendingIndex += 1;\n timer = setTimeout(() => reset(true), chordTimeout);\n\n return undefined;\n }\n\n return { advance, reset: () => reset() };\n}\n\n/\n Creates a headless keyboard shortcut manager with target-local chord state.\n \n Pass a bindings map of shortcut strings to handlers or `BindingOptions`, then call\n * `.mount(target)` to attach to any `EventTarget`. Supports chord sequences\n * (e.g. `\"ctrl+k ctrl+s\"`), per-binding `when` guards, `trigger` (keydown/keyup),\n * and dynamic `bind`/`unbind`.\n \n @example\n * const map = createKeymap({\n * 'mod+k mod+s': () => save(),\n * 'mod+shift+p': () => openPalette(),\n * 'g g': () => goToTop(),\n * esc: { handler: closePanel, when: (event) => !isEditableTarget(event.target) },\n * space: { handler: togglePlay, trigger: 'keyup' },\n * }, { modKey: 'ctrl' });\n * const unmount = map.mount(document);\n */\nexport function createKeymap(initialBindings: Record<string, BindingValue> = {}, options: KeymapOptions = {}): Keymap {\n const {\n chordTimeout: rawChordTimeout = 1000,\n modKey = detectModKey(),\n preventDefault = true,\n stopPropagation = false,\n when: globalWhen,\n onChordState: userOnChordState,\n } = options;\n const chordTimeout = Number.isFinite(rawChordTimeout) && rawChordTimeout > 0 ? rawChordTimeout : 1000;\n\n if (chordTimeout !== rawChordTimeout) {\n warn(`chordTimeout must be a positive finite number; received ${rawChordTimeout}. Using default of 1000ms.`);\n }\n\n const bindings = new Map<string, ParsedBinding>();\n const mounted = new Map<EventTarget, MountedTarget>();\n const disposalController = new AbortController();\n let bindingsDown: ParsedBinding[] = [];\n let bindingsUp: ParsedBinding[] = [];\n let disposed = false;\n\n function assertActive(): void {\n if (disposed) throw new KeymapError('Keymap is disposed');\n }\n\n function rebuildTriggerCaches(): void {\n bindingsDown = [];\n bindingsUp = [];\n\n for (const binding of bindings.values()) {\n if (binding.trigger === 'keydown') bindingsDown.push(binding);\n else bindingsUp.push(binding);\n }\n }\n\n function bindingKey(shortcut: string): string {\n return canonicalizeShortcut(parseShortcut(shortcut, modKey));\n }\n\n function addBinding(shortcut: string, value: BindingValue): string {\n const parsed = parseShortcut(shortcut, modKey);\n const key = canonicalizeShortcut(parsed);\n\n bindings.set(key, { shortcut: parsed, ...resolveBinding(value) });\n rebuildTriggerCaches();\n\n return key;\n }\n\n function removeByKey(key: string): boolean {\n const existed = bindings.delete(key);\n\n if (existed) rebuildTriggerCaches();\n\n return existed;\n }\n\n function emitChordState(change: ChordStateChange): void {\n if (!userOnChordState) return;\n\n try {\n userOnChordState(change);\n } catch (err) {\n warn(`onChordState callback error: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n function makeHandler(target: EventTarget, chord: ChordTracker): EventListener {\n return (event) => {\n const path = typeof event.composedPath === 'function' ? event.composedPath() : [];\n const nearestMountedTarget = path.find((pathTarget) => mounted.has(pathTarget));\n\n if (nearestMountedTarget && nearestMountedTarget !== target) return;\n\n const keyboardEvent = event as KeyboardEvent;\n\n if (disposed) return;\n\n // Track chord progression (independent of guards)\n const binding = chord.advance(keyboardEvent);\n\n // Check guards AFTER tracking chord\n if (globalWhen && !globalWhen(keyboardEvent)) return;\n\n if (!binding \|\| (binding.when && !binding.when(keyboardEvent))) return;\n\n if (preventDefault) keyboardEvent.preventDefault();\n\n if (stopPropagation) keyboardEvent.stopPropagation();\n\n binding.handler(keyboardEvent);\n };\n }\n\n for (const [shortcut, value] of Object.entries(initialBindings)) addBinding(shortcut, value);\n\n return {\n bind(shortcut: string, value: BindingValue): () => void {\n assertActive();\n\n const key = addBinding(shortcut, value);\n\n return () => {\n if (!disposed) removeByKey(key);\n };\n },\n\n get disposalSignal(): AbortSignal {\n return disposalController.signal;\n },\n\n dispose(): void {\n if (disposed) return;\n\n disposed = true;\n disposalController.abort();\n\n for (const [target, record] of mounted) {\n target.removeEventListener('keydown', record.onKeydown);\n target.removeEventListener('keyup', record.onKeyup);\n record.keydown.reset();\n record.keyup.reset();\n }\n\n mounted.clear();\n bindings.clear();\n bindingsDown = [];\n bindingsUp = [];\n },\n\n get disposed(): boolean {\n return disposed;\n },\n\n listBindings(): readonly BindingEntry[] {\n return [...bindings.values()].map((binding) => ({\n shortcut: binding.shortcut.map((step) => ({ key: step.key, modifiers: new Set(step.modifiers) })),\n trigger: binding.trigger,\n }));\n },\n\n mount(target: EventTarget): () => void {\n assertActive();\n\n let record = mounted.get(target);\n\n if (!record) {\n const keydown = createChordTracker(() => bindingsDown, chordTimeout, target, 'keydown', {\n onChordProgress: (t, steps, trigger) => emitChordState({ steps, target: t, trigger, type: 'progressed' }),\n onChordStart: (t, step, trigger) => emitChordState({ step, target: t, trigger, type: 'started' }),\n onChordTimeout: (t, trigger) => emitChordState({ target: t, trigger, type: 'timeout' }),\n });\n const keyup = createChordTracker(() => bindingsUp, chordTimeout, target, 'keyup', {\n onChordProgress: (t, steps, trigger) => emitChordState({ steps, target: t, trigger, type: 'progressed' }),\n onChordStart: (t, step, trigger) => emitChordState({ step, target: t, trigger, type: 'started' }),\n onChordTimeout: (t, trigger) => emitChordState({ target: t, trigger, type: 'timeout' }),\n });\n const onKeydown = makeHandler(target, keydown);\n const onKeyup = makeHandler(target, keyup);\n\n record = { keydown, keyup, onKeydown, onKeyup, refs: 0 };\n mounted.set(target, record);\n target.addEventListener('keydown', onKeydown);\n target.addEventListener('keyup', onKeyup);\n }\n\n record.refs += 1;\n\n let unmounted = false;\n\n return () => {\n if (unmounted) return;\n\n unmounted = true;\n record!.refs -= 1;\n\n if (record?.refs > 0) return;\n\n target.removeEventListener('keydown', record?.onKeydown);\n target.removeEventListener('keyup', record?.onKeyup);\n record?.keydown.reset();\n record?.keyup.reset();\n mounted.delete(target);\n };\n },\n\n [Symbol.dispose](): void {\n this.dispose();\n },\n\n unbind(shortcut: string): void {\n assertActive();\n\n if (!removeByKey(bindingKey(shortcut))) {\n warn(`unbind() called for unknown shortcut: \"${shortcut}\"`);\n }\n },\n };\n}\n"],"mappings":"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"}

package/dist/parser.cjs CHANGED Viewed

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs");function t(){if(typeof navigator>`u`)return`ctrl`;let e=navigator.userAgentData?.platform??navigator.platform??``;return/mac/i.test(e)?`meta`:`ctrl`}var n={alt:`alt`,cmd:`meta`,command:`meta`,control:`ctrl`,ctrl:`ctrl`,meta:`meta`,opt:`alt`,option:`alt`,shift:`shift`,win:`meta`},r={del:`delete`,down:`arrowdown`,esc:`escape`,left:`arrowleft`,right:`arrowright`,space:` `,spacebar:` `,up:`arrowup`};function i(e){return{...n,mod:e}}function a(e,t){let n=e.toLowerCase();return Object.hasOwn(t,n)?t[n]:null}function o(e){return Object.hasOwn(r,e)?r[e]:e}function s(n,r=t()){let s=n.trim().split(`+`).filter(Boolean).map(e=>e.toLowerCase());if(s.length===0)return null;let c=i(r),l=new Set,u=[];for(let e of s){let t=a(e,c);t?l.add(t):u.push(e)}if(u.length===0)return null;if(u.length>1)throw new e.KeymapParseError(`Ambiguous shortcut step: "${n}" — multiple non-modifier keys found`);return{key:o(u[0]),modifiers:l}}function c(n,r=t()){return n.trim().split(/\s+/).filter(Boolean).map(t=>{let i=s(t,r);if(i===null)throw new e.KeymapParseError(`Invalid shortcut step: "${t}" in "${n}"`);return i})}function l(e){return e.map(e=>{let t=[...e.modifiers].sort().join(`+`);return t?`${t}+${e.key}`:e.key}).join(` `)}function u(e,t){if(typeof e.key!=`string`||e.key.toLowerCase()!==t.key)return!1;let{modifiers:n}=t;return e.altKey===n.has(`alt`)&&e.ctrlKey===n.has(`ctrl`)&&e.metaKey===n.has(`meta`)&&e.shiftKey===n.has(`shift`)}exports.canonicalizeShortcut=l,exports.detectModKey=t,exports.matchStep=u,exports.parseShortcut=c,exports.parseStep=s;
+const e=require("./errors.cjs");function t(){if(typeof navigator>`u`)return`ctrl`;let e=navigator.userAgentData?.platform??navigator.platform??``;return/mac/i.test(e)?`meta`:`ctrl`}var n={alt:`alt`,cmd:`meta`,command:`meta`,control:`ctrl`,ctrl:`ctrl`,meta:`meta`,opt:`alt`,option:`alt`,shift:`shift`,win:`meta`},r={del:`delete`,down:`arrowdown`,esc:`escape`,left:`arrowleft`,right:`arrowright`,space:` `,spacebar:` `,up:`arrowup`};function i(t,i){let a=t.trim().split(`+`).filter(Boolean).map(e=>e.toLowerCase());if(a.length===0)throw new e.KeymapParseError(`Invalid shortcut step: "${t}"`);let o={...n,mod:i},s=new Set,c=[];for(let e of a){let t=Object.hasOwn(o,e)?o[e]:void 0;t?s.add(t):c.push(e)}if(c.length===0)throw new e.KeymapParseError(`Invalid shortcut step: "${t}"`);if(c.length>1)throw new e.KeymapParseError(`Ambiguous shortcut step: "${t}" — multiple non-modifier keys found`);let l=c[0];return{key:Object.hasOwn(r,l)?r[l]:l,modifiers:s}}function a(e,n=t()){try{return i(e,n)}catch{return null}}function o(n,r=t()){let a=n.trim().split(/\s+/).filter(Boolean);if(a.length===0)throw new e.KeymapParseError(`Shortcut must contain at least one key step`);return a.map(e=>i(e,r))}function s(e){return e.map(e=>{let t=[...e.modifiers].sort().join(`+`);return t?`${t}+${e.key}`:e.key}).join(` `)}function c(e,t){if(typeof e.key!=`string`||e.key.toLowerCase()!==t.key)return!1;let{modifiers:n}=t;return e.altKey===n.has(`alt`)&&e.ctrlKey===n.has(`ctrl`)&&e.metaKey===n.has(`meta`)&&e.shiftKey===n.has(`shift`)}exports.canonicalizeShortcut=s,exports.detectModKey=t,exports.matchStep=c,exports.parseShortcut=o,exports.parseStep=a;
 //# sourceMappingURL=parser.cjs.map

package/dist/parser.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"parser.cjs","names":[],"sources":["../src/parser.ts"],"sourcesContent":["import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction ~~buildModifierAliases~~(modKey: 'ctrl' \| 'meta'): Record<string, ModifierKey> {\n return { ...MODIFIER_ALIASES_BASE, mod: modKey };\n}\n\nfunction normalizeModifier(token: string, aliases: Record<string, ModifierKey>): ModifierKey \| null {\n const lower = token.toLowerCase();\n\n return Object.hasOwn(aliases, lower) ? aliases[lower]! : null;\n}\n\nfunction normalizeKey(raw: string~~): string {\n return Object.hasOwn(SPECIAL_KEY_ALIASES~~, ~~raw) ? SPECIAL_KEY_ALIASES[raw]! : raw;\n}\n\nexport function parseStep(raw: string,~~ modKey: 'ctrl' \| 'meta' ~~= detectModKey(~~)): ShortcutStep ~~\| null~~ {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((p) => p.toLowerCase());\n\n if (parts.length === 0) ~~return~~ ~~null~~;\n\n const aliases = ~~buildModifierAliases(~~modKey);\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const ~~mod~~ = ~~normalizeModifier~~(~~part~~, aliases);\n\n if (~~mod~~) ~~{\n~~ modifiers.add(~~mod~~);\n } else ~~{\n~~ keyParts.push(part);\n ~~}\n~~ }\n\n if (keyParts.length === 0) ~~return~~ ~~null~~;\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const ~~key~~ = ~~normalizeKey(~~keyParts[0]);\n\n return { key, modifiers };\n}\n\nexport function ~~parseShortcut~~(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ~~Shortcut~~ {\n ~~return~~ ~~raw~~\n ~~.trim~~()\n ~~.split(/\\s+/)~~\n ~~.filter(Boolean)~~\n ~~.map~~((~~step~~) => {\n const ~~result~~ = ~~parseStep~~(~~step, modKey~~);\n\n if (~~result~~ === ~~null~~) ~~{\n~~ throw new KeymapParseError(~~`Invalid~~ ~~shortcut~~ ~~step:~~ ~~\"${step}\"~~ in ~~\"${raw}\"`~~);\n }\n\n return ~~result;\n }~~);\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((s) => {\n const ~~mods~~ = [...s.modifiers].sort().join('+');\n\n return ~~mods~~ ? `${~~mods~~}+${s.key}` : s.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n if (event.altKey ~~!==~~ modifiers.has('alt')) ~~return false;\~~n~~\n if (~~event.ctrlKey ~~!==~~ modifiers.has('ctrl')) ~~return false;\~~n~~\n if (~~event.metaKey ~~!==~~ modifiers.has('meta')) ~~return false;\~~n~~\n if (~~event.shiftKey ~~!==~~ modifiers.has('shift')~~) return false;\n~~\n ~~return true~~;\n}\n"],"mappings":"gCAWA,SAAgB,GAAgC,CAC9C,GAAI,OAAO,UAAc,IAAa,MAAO,OAE7C,IAAM,EACH,UAAoE,eAAe,UACpF,UAAU,UACV,GAEF,MAAO,OAAO,KAAK,CAAQ,EAAI,OAAS,MAC1C,CAEA,IAAM,EAAqD,CACzD,IAAK,MACL,IAAK,OACL,QAAS,OACT,QAAS,OACT,KAAM,OACN,KAAM,OACN,IAAK,MACL,OAAQ,MACR,MAAO,QACP,IAAK,MACP,EAEM,EAA8C,CAClD,IAAK,SACL,KAAM,YACN,IAAK,SACL,KAAM,YACN,MAAO,aACP,MAAO,IACP,SAAU,IACV,GAAI,SACN,EAEA,SAAS,~~EAAqB~~,~~EAAsD,CAClF,MAAO,CAAE,GAAG,EAAuB,IAAK,CAAO,CACjD,CAEA,SAAS,EAAkB,EAAe,EAA0D,CAClG,IAAM,EAAQ,EAAM,YAAY,EAEhC,OAAO,OAAO,OAAO,EAAS,CAAK,EAAI,EAAQ,GAAU,IAC3D,CAEA,SAAS,~~EAAa,~~EAAqB~~,~~CACzC~~,~~OAAO,OAAO,OAAO,EAAqB,CAAG,EAAI,EAAoB,GAAQ,CAC/E,CAEA,SAAgB,EAAU,EAAa,EAA0B,EAAa,EAAwB,CACpG,~~IAAM,EAAQ,EACX,KAAK,CAAC,CACN,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CAAC,CACf,IAAK,~~GAAM~~,~~EAAE~~,YAAY,CAAC,~~EAE7B~~,GAAI,EAAM,SAAW,EAAG,~~OAAO~~,~~KAE/B~~,IAAM,~~EAAU~~,~~EAAqB~~,~~CAAM~~,~~EACrC~~,EAAY,IAAI,IAChB,EAAqB,CAAC,EAE5B,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,~~EAAM~~,~~EAAkB~~,~~EAAM~~,~~CAAO~~,~~EAEvC~~,~~EACF~~,EAAU,IAAI,~~CAAG~~,~~EAEjB~~,EAAS,KAAK,CAAI,~~CAEtB~~,CAEA,GAAI,EAAS,SAAW,EAAG,~~OAAO~~,~~KAElC~~,GAAI,EAAS,OAAS,EACpB,MAAM,IAAI,EAAA,iBAAiB,6BAA6B,EAAI,qCAAqC,~~EAKnG~~,MAAO,CAAE,IAFG,~~EAAa~~,~~EAAS~~,~~EAEzB~~,~~EAAK~~,WAAU,CAC1B,CAEA,SAAgB,~~EAAc~~,EAAa,EAA0B,EAAa,~~EAAa~~,~~CAC7F~~,OAAO,~~EACJ~~,~~KAAK~~,~~CAAC~~,CACN,~~MAAM~~,~~KAAK~~,~~CAAC~~,~~CACZ~~,~~OAAO~~,~~OAAO~~,~~CAAC~~,~~CACf~~,~~IAAK~~,~~GAAS~~,~~CACb~~,IAAM,~~EAAS~~,~~EAAU~~,~~EAAM~~,~~CAAM~~,~~EAErC~~,GAAI,~~IAAW~~,~~KACb~~,MAAM,IAAI,EAAA,iBAAiB,~~2BAA2B~~,~~EAAK~~,~~QAAQ~~,~~EAAI~~,~~EAAE~~,~~EAG3E~~,~~OAAO~~,~~CACT~~,CAAC,~~CACL~~,CAEA,SAAgB,EAAqB,EAAwC,CAC3E,OAAO,EACJ,IAAK,~~GAAM~~,~~CACV~~,IAAM,~~EAAO~~,CAAC,GAAG,~~EAAE~~,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,~~EAE7C~~,OAAO,~~EAAO~~,GAAG,~~EAAK~~,GAAG,~~EAAE~~,MAAQ,~~EAAE~~,~~GACvC~~,CAAC,CAAC,CACD,KAAK,GAAG,CACb,CAEA,SAAgB,EAAU,EAAsB,EAA6B,CAM3E,GAFI,OAAO,EAAM,KAAQ,UAErB,EAAM,IAAI,YAAY,IAAM,EAAK,IAAK,MAAO,GAEjD,GAAM,CAAE,aAAc,~~EAUtB~~,~~OARI~~,EAAM,SAAW,EAAU,IAAI,KAAK,~~GAEpC~~,EAAM,UAAY,EAAU,IAAI,MAAM,~~GAEtC~~,EAAM,UAAY,EAAU,IAAI,MAAM,~~GAEtC~~,EAAM,WAAa,EAAU,IAAI,OAAO,~~CAG9C~~"}
1	+ {"version":3,"file":"parser.cjs","names":[],"sources":["../src/parser.ts"],"sourcesContent":["import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction parseStepStrict(raw: string, modKey: 'ctrl' \| 'meta'): ShortcutStep {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((part) => part.toLowerCase());\n\n if (parts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n const aliases: Record<string, ModifierKey> = { ...MODIFIER_ALIASES_BASE, mod: modKey };\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const modifier = Object.hasOwn(aliases, part) ? aliases[part]! : undefined;\n\n if (modifier) modifiers.add(modifier);\n else keyParts.push(part);\n }\n\n if (keyParts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const rawKey = keyParts[0]!;\n const key = Object.hasOwn(SPECIAL_KEY_ALIASES, rawKey) ? SPECIAL_KEY_ALIASES[rawKey]! : rawKey;\n\n return { key, modifiers };\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n try {\n return parseStepStrict(raw, modKey);\n } catch {\n return null;\n }\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n const steps = raw.trim().split(/\\s+/).filter(Boolean);\n\n if (steps.length === 0) throw new KeymapParseError('Shortcut must contain at least one key step');\n\n return steps.map((step) => parseStepStrict(step, modKey));\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((step) => {\n const modifiers = [...step.modifiers].sort().join('+');\n\n return modifiers ? `${modifiers}+${step.key}` : step.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n return (\n event.altKey === modifiers.has('alt') &&\n event.ctrlKey === modifiers.has('ctrl') &&\n event.metaKey === modifiers.has('meta') &&\n event.shiftKey === modifiers.has('shift')\n );\n}\n"],"mappings":"gCAWA,SAAgB,GAAgC,CAC9C,GAAI,OAAO,UAAc,IAAa,MAAO,OAE7C,IAAM,EACH,UAAoE,eAAe,UACpF,UAAU,UACV,GAEF,MAAO,OAAO,KAAK,CAAQ,EAAI,OAAS,MAC1C,CAEA,IAAM,EAAqD,CACzD,IAAK,MACL,IAAK,OACL,QAAS,OACT,QAAS,OACT,KAAM,OACN,KAAM,OACN,IAAK,MACL,OAAQ,MACR,MAAO,QACP,IAAK,MACP,EAEM,EAA8C,CAClD,IAAK,SACL,KAAM,YACN,IAAK,SACL,KAAM,YACN,MAAO,aACP,MAAO,IACP,SAAU,IACV,GAAI,SACN,EAEA,SAAS,EAAgB,EAAa,EAAuC,CAC3E,IAAM,EAAQ,EACX,KAAK,CAAC,CACN,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CAAC,CACf,IAAK,GAAS,EAAK,YAAY,CAAC,EAEnC,GAAI,EAAM,SAAW,EAAG,MAAM,IAAI,EAAA,iBAAiB,2BAA2B,EAAI,EAAE,EAEpF,IAAM,EAAuC,CAAE,GAAG,EAAuB,IAAK,CAAO,EAC/E,EAAY,IAAI,IAChB,EAAqB,CAAC,EAE5B,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAW,OAAO,OAAO,EAAS,CAAI,EAAI,EAAQ,GAAS,IAAA,GAE7D,EAAU,EAAU,IAAI,CAAQ,EAC/B,EAAS,KAAK,CAAI,CACzB,CAEA,GAAI,EAAS,SAAW,EAAG,MAAM,IAAI,EAAA,iBAAiB,2BAA2B,EAAI,EAAE,EAEvF,GAAI,EAAS,OAAS,EACpB,MAAM,IAAI,EAAA,iBAAiB,6BAA6B,EAAI,qCAAqC,EAGnG,IAAM,EAAS,EAAS,GAGxB,MAAO,CAAE,IAFG,OAAO,OAAO,EAAqB,CAAM,EAAI,EAAoB,GAAW,EAE1E,WAAU,CAC1B,CAEA,SAAgB,EAAU,EAAa,EAA0B,EAAa,EAAwB,CACpG,GAAI,CACF,OAAO,EAAgB,EAAK,CAAM,CACpC,MAAQ,CACN,OAAO,IACT,CACF,CAEA,SAAgB,EAAc,EAAa,EAA0B,EAAa,EAAa,CAC7F,IAAM,EAAQ,EAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,EAEpD,GAAI,EAAM,SAAW,EAAG,MAAM,IAAI,EAAA,iBAAiB,6CAA6C,EAEhG,OAAO,EAAM,IAAK,GAAS,EAAgB,EAAM,CAAM,CAAC,CAC1D,CAEA,SAAgB,EAAqB,EAAwC,CAC3E,OAAO,EACJ,IAAK,GAAS,CACb,IAAM,EAAY,CAAC,GAAG,EAAK,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,EAErD,OAAO,EAAY,GAAG,EAAU,GAAG,EAAK,MAAQ,EAAK,GACvD,CAAC,CAAC,CACD,KAAK,GAAG,CACb,CAEA,SAAgB,EAAU,EAAsB,EAA6B,CAM3E,GAFI,OAAO,EAAM,KAAQ,UAErB,EAAM,IAAI,YAAY,IAAM,EAAK,IAAK,MAAO,GAEjD,GAAM,CAAE,aAAc,EAEtB,OACE,EAAM,SAAW,EAAU,IAAI,KAAK,GACpC,EAAM,UAAY,EAAU,IAAI,MAAM,GACtC,EAAM,UAAY,EAAU,IAAI,MAAM,GACtC,EAAM,WAAa,EAAU,IAAI,OAAO,CAE5C"}

package/dist/parser.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEtC,wBAAgB,YAAY,IAAI,MAAM,GAAG,MAAM,CAS9C;~~AAwCD~~,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAuB,GAAG,YAAY,GAAG,IAAI,~~CAgCpG~~;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAuB,GAAG,QAAQ,~~CAc7F~~;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAQ3E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,~~CAmB3E~~"}
1	+ {"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEtC,wBAAgB,YAAY,IAAI,MAAM,GAAG,MAAM,CAS9C;AA0DD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAuB,GAAG,YAAY,GAAG,IAAI,CAMpG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAuB,GAAG,QAAQ,CAM7F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAQ3E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAgB3E"}

package/dist/parser.js CHANGED Viewed

@@ -26,53 +26,49 @@ var n = {
 	spacebar: " ",
 	up: "arrowup"
 };
-function i(e) {
-	return {
+function i(t, i) {
+	let a = t.trim().split("+").filter(Boolean).map((e) => e.toLowerCase());
+	if (a.length === 0) throw new e(`Invalid shortcut step: "${t}"`);
+	let o = {
 		...n,
-		mod: e
-	};
-}
-function a(e, t) {
-	let n = e.toLowerCase();
-	return Object.hasOwn(t, n) ? t[n] : null;
-}
-function o(e) {
-	return Object.hasOwn(r, e) ? r[e] : e;
-}
-function s(n, r = t()) {
-	let s = n.trim().split("+").filter(Boolean).map((e) => e.toLowerCase());
-	if (s.length === 0) return null;
-	let c = i(r), l = /* @__PURE__ */ new Set(), u = [];
-	for (let e of s) {
-		let t = a(e, c);
-		t ? l.add(t) : u.push(e);
+		mod: i
+	}, s = /* @__PURE__ */ new Set(), c = [];
+	for (let e of a) {
+		let t = Object.hasOwn(o, e) ? o[e] : void 0;
+		t ? s.add(t) : c.push(e);
 	}
-	if (u.length === 0) return null;
-	if (u.length > 1) throw new e(`Ambiguous shortcut step: "${n}" — multiple non-modifier keys found`);
+	if (c.length === 0) throw new e(`Invalid shortcut step: "${t}"`);
+	if (c.length > 1) throw new e(`Ambiguous shortcut step: "${t}" — multiple non-modifier keys found`);
+	let l = c[0];
 	return {
-		key: o(u[0]),
-		modifiers: l
+		key: Object.hasOwn(r, l) ? r[l] : l,
+		modifiers: s
 	};
 }
-function c(n, r = t()) {
-	return n.trim().split(/\s+/).filter(Boolean).map((t) => {
-		let i = s(t, r);
-		if (i === null) throw new e(`Invalid shortcut step: "${t}" in "${n}"`);
-		return i;
-	});
+function a(e, n = t()) {
+	try {
+		return i(e, n);
+	} catch {
+		return null;
+	}
+}
+function o(n, r = t()) {
+	let a = n.trim().split(/\s+/).filter(Boolean);
+	if (a.length === 0) throw new e("Shortcut must contain at least one key step");
+	return a.map((e) => i(e, r));
 }
-function l(e) {
+function s(e) {
 	return e.map((e) => {
 		let t = [...e.modifiers].sort().join("+");
 		return t ? `${t}+${e.key}` : e.key;
 	}).join(" ");
 }
-function u(e, t) {
+function c(e, t) {
 	if (typeof e.key != "string" || e.key.toLowerCase() !== t.key) return !1;
 	let { modifiers: n } = t;
 	return e.altKey === n.has("alt") && e.ctrlKey === n.has("ctrl") && e.metaKey === n.has("meta") && e.shiftKey === n.has("shift");
 }
 //#endregion
-export { l as canonicalizeShortcut, t as detectModKey, u as matchStep, c as parseShortcut, s as parseStep };
+export { s as canonicalizeShortcut, t as detectModKey, c as matchStep, o as parseShortcut, a as parseStep };
 //# sourceMappingURL=parser.js.map

package/dist/parser.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"parser.js","names":[],"sources":["../src/parser.ts"],"sourcesContent":["import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction ~~buildModifierAliases~~(modKey: 'ctrl' \| 'meta'): Record<string, ModifierKey> {\n return { ...MODIFIER_ALIASES_BASE, mod: modKey };\n}\n\nfunction normalizeModifier(token: string, aliases: Record<string, ModifierKey>): ModifierKey \| null {\n const lower = token.toLowerCase();\n\n return Object.hasOwn(aliases, lower) ? aliases[lower]! : null;\n}\n\nfunction normalizeKey(raw: string~~): string {\n return Object.hasOwn(SPECIAL_KEY_ALIASES~~, ~~raw) ? SPECIAL_KEY_ALIASES[raw]! : raw;\n}\n\nexport function parseStep(raw: string,~~ modKey: 'ctrl' \| 'meta' ~~= detectModKey(~~)): ShortcutStep ~~\| null~~ {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((p) => p.toLowerCase());\n\n if (parts.length === 0) ~~return~~ ~~null~~;\n\n const aliases = ~~buildModifierAliases(~~modKey);\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const ~~mod~~ = ~~normalizeModifier~~(~~part~~, aliases);\n\n if (~~mod~~) ~~{\n~~ modifiers.add(~~mod~~);\n } else ~~{\n~~ keyParts.push(part);\n ~~}\n~~ }\n\n if (keyParts.length === 0) ~~return~~ ~~null~~;\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const ~~key~~ = ~~normalizeKey(~~keyParts[0]);\n\n return { key, modifiers };\n}\n\nexport function ~~parseShortcut~~(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ~~Shortcut~~ {\n ~~return~~ ~~raw~~\n ~~.trim~~()\n ~~.split(/\\s+/)~~\n ~~.filter(Boolean)~~\n ~~.map~~((~~step~~) => {\n const ~~result~~ = ~~parseStep~~(~~step, modKey~~);\n\n if (~~result~~ === ~~null~~) ~~{\n~~ throw new KeymapParseError(~~`Invalid~~ ~~shortcut~~ ~~step:~~ ~~\"${step}\"~~ in ~~\"${raw}\"`~~);\n }\n\n return ~~result;\n }~~);\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((s) => {\n const ~~mods~~ = [...s.modifiers].sort().join('+');\n\n return ~~mods~~ ? `${~~mods~~}+${s.key}` : s.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n if (event.altKey ~~!==~~ modifiers.has('alt')) ~~return false;\~~n~~\n if (~~event.ctrlKey ~~!==~~ modifiers.has('ctrl')) ~~return false;\~~n~~\n if (~~event.metaKey ~~!==~~ modifiers.has('meta')) ~~return false;\~~n~~\n if (~~event.shiftKey ~~!==~~ modifiers.has('shift')~~) return false;\n~~\n ~~return true~~;\n}\n"],"mappings":";;AAWA,SAAgB,IAAgC;CAC9C,IAAI,OAAO,YAAc,KAAa,OAAO;CAE7C,IAAM,IACH,UAAoE,eAAe,YACpF,UAAU,YACV;CAEF,OAAO,OAAO,KAAK,CAAQ,IAAI,SAAS;AAC1C;AAEA,IAAM,IAAqD;CACzD,KAAK;CACL,KAAK;CACL,SAAS;CACT,SAAS;CACT,MAAM;CACN,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;CACP,KAAK;AACP,GAEM,IAA8C;CAClD,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,OAAO;CACP,OAAO;CACP,UAAU;CACV,IAAI;AACN;AAEA,SAAS,~~EAAqB~~,GAAsD;CAClF,OAAO;EAAE,GAAG;EAAuB,KAAK;CAAO;AACjD;AAEA,SAAS,EAAkB,GAAe,GAA0D;CAClG,IAAM,IAAQ,EAAM,YAAY;CAEhC,OAAO,OAAO,OAAO,GAAS,CAAK,IAAI,EAAQ,KAAU;AAC3D;AAEA,SAAS,EAAa,GAAqB;CACzC,OAAO,OAAO,OAAO,GAAqB,CAAG,IAAI,EAAoB,KAAQ;AAC/E;AAEA,SAAgB,EAAU,GAAa,~~IAA0B,EAAa,GAAwB~~;~~CACpG~~,IAAM,IAAQ,EACX,KAAK,CAAC,CACN,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CAAC,CACf,KAAK,~~MAAM~~,~~EAAE~~,YAAY,CAAC;~~CAE7B~~,IAAI,EAAM,WAAW,GAAG,~~OAAO~~;~~CAE/B~~,IAAM,~~IAAU~~,~~EAAqB~~,~~CAAM~~,~~GACrC~~,oBAAY,IAAI,IAAiB,GACjC,IAAqB,CAAC;CAE5B,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAM,~~IAAM~~,~~EAAkB~~,~~GAAM~~,~~CAAO~~;~~EAE3C~~,AAAI,~~IACF~~,EAAU,IAAI,~~CAAG~~,~~IAEjB~~,EAAS,KAAK,CAAI;~~CAEtB~~;CAEA,IAAI,EAAS,WAAW,GAAG,~~OAAO~~;~~CAElC~~,IAAI,EAAS,SAAS,GACpB,MAAM,IAAI,EAAiB,6BAA6B,EAAI,qCAAqC;~~CAKnG~~,OAAO;EAAE,KAFG,~~EAAa~~,~~EAAS~~,~~EAEzB~~;~~EAAK~~;CAAU;AAC1B;AAEA,SAAgB,~~EAAc~~,GAAa,IAA0B,EAAa,~~GAAa~~;~~CAC7F~~,OAAO,~~EACJ~~,~~KAAK~~,~~CAAC~~,~~CACN~~,~~MAAM~~,~~KAAK~~,~~CAAC~~,~~CACZ~~,~~OAAO~~,~~OAAO~~,~~CAAC~~,~~CACf~~,KAAK,~~MAAS;EACb~~,~~IAAM~~,~~IAAS~~,~~EAAU~~,~~GAAM~~,~~CAAM~~;~~EAErC~~,IAAI,~~MAAW~~,~~MACb~~,MAAM,IAAI,EAAiB,~~2BAA2B~~,~~EAAK~~,~~QAAQ~~,~~EAAI~~,~~EAAE;EAG3E~~,~~OAAO;CACT~~,CAAC;~~AACL~~;AAEA,SAAgB,EAAqB,GAAwC;CAC3E,OAAO,EACJ,KAAK,~~MAAM~~;~~EACV~~,IAAM,~~IAAO~~,CAAC,GAAG,~~EAAE~~,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG;~~EAE7C~~,OAAO,~~IAAO~~,GAAG,~~EAAK~~,GAAG,~~EAAE~~,QAAQ,~~EAAE~~;~~CACvC~~,CAAC,CAAC,CACD,KAAK,GAAG;AACb;AAEA,SAAgB,EAAU,GAAsB,GAA6B;CAM3E,IAFI,OAAO,EAAM,OAAQ,YAErB,EAAM,IAAI,YAAY,MAAM,EAAK,KAAK,OAAO;CAEjD,IAAM,EAAE,iBAAc;~~CAUtB~~,~~OARI~~,EAAM,WAAW,EAAU,IAAI,KAAK,~~KAEpC~~,EAAM,YAAY,EAAU,IAAI,MAAM,~~KAEtC~~,EAAM,YAAY,EAAU,IAAI,MAAM,~~KAEtC~~,EAAM,aAAa,EAAU,IAAI,OAAO;~~AAG9C~~"}
1	+ {"version":3,"file":"parser.js","names":[],"sources":["../src/parser.ts"],"sourcesContent":["import { KeymapParseError } from './errors';\n\nexport type ModifierKey = 'alt' \| 'ctrl' \| 'meta' \| 'shift';\n\nexport type ShortcutStep = {\n key: string;\n modifiers: Set<ModifierKey>;\n};\n\nexport type Shortcut = ShortcutStep[];\n\nexport function detectModKey(): 'ctrl' \| 'meta' {\n if (typeof navigator === 'undefined') return 'ctrl';\n\n const platform =\n (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData?.platform ??\n navigator.platform ??\n '';\n\n return /mac/i.test(platform) ? 'meta' : 'ctrl';\n}\n\nconst MODIFIER_ALIASES_BASE: Record<string, ModifierKey> = {\n alt: 'alt',\n cmd: 'meta',\n command: 'meta',\n control: 'ctrl',\n ctrl: 'ctrl',\n meta: 'meta',\n opt: 'alt',\n option: 'alt',\n shift: 'shift',\n win: 'meta',\n};\n\nconst SPECIAL_KEY_ALIASES: Record<string, string> = {\n del: 'delete',\n down: 'arrowdown',\n esc: 'escape',\n left: 'arrowleft',\n right: 'arrowright',\n space: ' ',\n spacebar: ' ',\n up: 'arrowup',\n};\n\nfunction parseStepStrict(raw: string, modKey: 'ctrl' \| 'meta'): ShortcutStep {\n const parts = raw\n .trim()\n .split('+')\n .filter(Boolean)\n .map((part) => part.toLowerCase());\n\n if (parts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n const aliases: Record<string, ModifierKey> = { ...MODIFIER_ALIASES_BASE, mod: modKey };\n const modifiers = new Set<ModifierKey>();\n const keyParts: string[] = [];\n\n for (const part of parts) {\n const modifier = Object.hasOwn(aliases, part) ? aliases[part]! : undefined;\n\n if (modifier) modifiers.add(modifier);\n else keyParts.push(part);\n }\n\n if (keyParts.length === 0) throw new KeymapParseError(`Invalid shortcut step: \"${raw}\"`);\n\n if (keyParts.length > 1) {\n throw new KeymapParseError(`Ambiguous shortcut step: \"${raw}\" — multiple non-modifier keys found`);\n }\n\n const rawKey = keyParts[0]!;\n const key = Object.hasOwn(SPECIAL_KEY_ALIASES, rawKey) ? SPECIAL_KEY_ALIASES[rawKey]! : rawKey;\n\n return { key, modifiers };\n}\n\nexport function parseStep(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): ShortcutStep \| null {\n try {\n return parseStepStrict(raw, modKey);\n } catch {\n return null;\n }\n}\n\nexport function parseShortcut(raw: string, modKey: 'ctrl' \| 'meta' = detectModKey()): Shortcut {\n const steps = raw.trim().split(/\\s+/).filter(Boolean);\n\n if (steps.length === 0) throw new KeymapParseError('Shortcut must contain at least one key step');\n\n return steps.map((step) => parseStepStrict(step, modKey));\n}\n\nexport function canonicalizeShortcut(steps: readonly ShortcutStep[]): string {\n return steps\n .map((step) => {\n const modifiers = [...step.modifiers].sort().join('+');\n\n return modifiers ? `${modifiers}+${step.key}` : step.key;\n })\n .join(' ');\n}\n\nexport function matchStep(event: KeyboardEvent, step: ShortcutStep): boolean {\n // Headless usage (SSR, non-DOM `EventTarget`s, hand-built test events) means `event` isn't\n // guaranteed to be a real `KeyboardEvent` at runtime even though the type says so — treat a\n // missing/non-string `key` as \"doesn't match\" rather than throwing inside the event listener.\n if (typeof event.key !== 'string') return false;\n\n if (event.key.toLowerCase() !== step.key) return false;\n\n const { modifiers } = step;\n\n return (\n event.altKey === modifiers.has('alt') &&\n event.ctrlKey === modifiers.has('ctrl') &&\n event.metaKey === modifiers.has('meta') &&\n event.shiftKey === modifiers.has('shift')\n );\n}\n"],"mappings":";;AAWA,SAAgB,IAAgC;CAC9C,IAAI,OAAO,YAAc,KAAa,OAAO;CAE7C,IAAM,IACH,UAAoE,eAAe,YACpF,UAAU,YACV;CAEF,OAAO,OAAO,KAAK,CAAQ,IAAI,SAAS;AAC1C;AAEA,IAAM,IAAqD;CACzD,KAAK;CACL,KAAK;CACL,SAAS;CACT,SAAS;CACT,MAAM;CACN,MAAM;CACN,KAAK;CACL,QAAQ;CACR,OAAO;CACP,KAAK;AACP,GAEM,IAA8C;CAClD,KAAK;CACL,MAAM;CACN,KAAK;CACL,MAAM;CACN,OAAO;CACP,OAAO;CACP,UAAU;CACV,IAAI;AACN;AAEA,SAAS,EAAgB,GAAa,GAAuC;CAC3E,IAAM,IAAQ,EACX,KAAK,CAAC,CACN,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CAAC,CACf,KAAK,MAAS,EAAK,YAAY,CAAC;CAEnC,IAAI,EAAM,WAAW,GAAG,MAAM,IAAI,EAAiB,2BAA2B,EAAI,EAAE;CAEpF,IAAM,IAAuC;EAAE,GAAG;EAAuB,KAAK;CAAO,GAC/E,oBAAY,IAAI,IAAiB,GACjC,IAAqB,CAAC;CAE5B,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAM,IAAW,OAAO,OAAO,GAAS,CAAI,IAAI,EAAQ,KAAS,KAAA;EAEjE,AAAI,IAAU,EAAU,IAAI,CAAQ,IAC/B,EAAS,KAAK,CAAI;CACzB;CAEA,IAAI,EAAS,WAAW,GAAG,MAAM,IAAI,EAAiB,2BAA2B,EAAI,EAAE;CAEvF,IAAI,EAAS,SAAS,GACpB,MAAM,IAAI,EAAiB,6BAA6B,EAAI,qCAAqC;CAGnG,IAAM,IAAS,EAAS;CAGxB,OAAO;EAAE,KAFG,OAAO,OAAO,GAAqB,CAAM,IAAI,EAAoB,KAAW;EAE1E;CAAU;AAC1B;AAEA,SAAgB,EAAU,GAAa,IAA0B,EAAa,GAAwB;CACpG,IAAI;EACF,OAAO,EAAgB,GAAK,CAAM;CACpC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,EAAc,GAAa,IAA0B,EAAa,GAAa;CAC7F,IAAM,IAAQ,EAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;CAEpD,IAAI,EAAM,WAAW,GAAG,MAAM,IAAI,EAAiB,6CAA6C;CAEhG,OAAO,EAAM,KAAK,MAAS,EAAgB,GAAM,CAAM,CAAC;AAC1D;AAEA,SAAgB,EAAqB,GAAwC;CAC3E,OAAO,EACJ,KAAK,MAAS;EACb,IAAM,IAAY,CAAC,GAAG,EAAK,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG;EAErD,OAAO,IAAY,GAAG,EAAU,GAAG,EAAK,QAAQ,EAAK;CACvD,CAAC,CAAC,CACD,KAAK,GAAG;AACb;AAEA,SAAgB,EAAU,GAAsB,GAA6B;CAM3E,IAFI,OAAO,EAAM,OAAQ,YAErB,EAAM,IAAI,YAAY,MAAM,EAAK,KAAK,OAAO;CAEjD,IAAM,EAAE,iBAAc;CAEtB,OACE,EAAM,WAAW,EAAU,IAAI,KAAK,KACpC,EAAM,YAAY,EAAU,IAAI,MAAM,KACtC,EAAM,YAAY,EAAU,IAAI,MAAM,KACtC,EAAM,aAAa,EAAU,IAAI,OAAO;AAE5C"}

package/dist/types.d.ts CHANGED Viewed

@@ -1,32 +1,97 @@
 import type { ShortcutStep } from './parser';
 export type BindingEntry = {
-    readonly priority: number;
     readonly shortcut: readonly ShortcutStep[];
     readonly trigger: 'keydown' | 'keyup';
 };
 export type Handler = (event: KeyboardEvent) => void;
+/**
+ * Guard function for fine-grained binding context.
+ *
+ * When both a global `when` (from `KeymapOptions`) and a per-binding `when`
+ * are provided, both must return `true` for the handler to fire:
+ *
+ * 1. Global `when` is checked first; if it fails, all bindings are skipped.
+ * 2. Per-binding `when` is checked only after the global guard passes.
+ *
+ * Treat it as: _global guard AND per-binding guard_.
+ *
+ * @example
+ * // Global: don't fire shortcuts while modal is open
+ * { when: (e) => !isModalOpen() }
+ *
+ * // Per-binding: only fire when event target is the specific panel
+ * { 'escape': { handler: closePanel, when: (e) => e.target === panel } }
+ *
+ * Both conditions must be met for the handler to execute.
+ */
+export type When = (event: KeyboardEvent) => boolean;
 export type BindingOptions = {
     handler: Handler;
-    priority?: number;
     trigger?: 'keydown' | 'keyup';
-    when?: () => boolean;
+    when?: When;
 };
 export type BindingValue = Handler | BindingOptions;
+/**
+ * Chord state change event emitted when chord progression changes.
+ *
+ * Use `onChordState` callback in `KeymapOptions` to observe chord state
+ * for debugging, UI hints, or chord history. When a chord fully matches,
+ * the binding handler fires immediately; no separate 'completed' event.
+ */
+export type ChordStateChange = {
+    type: 'started';
+    target: EventTarget;
+    step: ShortcutStep;
+    trigger: 'keydown' | 'keyup';
+} | {
+    type: 'progressed';
+    target: EventTarget;
+    steps: readonly ShortcutStep[];
+    trigger: 'keydown' | 'keyup';
+} | {
+    type: 'timeout';
+    target: EventTarget;
+    trigger: 'keydown' | 'keyup';
+};
 export interface KeymapOptions {
     chordTimeout?: number;
     modKey?: 'ctrl' | 'meta';
+    /**
+     * Optional callback to observe chord state changes.
+     *
+     * Fires when a chord starts, progresses through steps, completes, or times out.
+     * Useful for debugging, logging, testing, or implementing chord UI hints.
+     *
+     * @example
+     * {
+     *   onChordState: (change) => {
+     *     if (change.type === 'started') console.log('Chord started:', change.step.key);
+     *     if (change.type === 'timeout') console.log('Chord timed out');
+     *   }
+     * }
+     */
+    onChordState?: (change: ChordStateChange) => void;
     preventDefault?: boolean;
     stopPropagation?: boolean;
-    when?: () => boolean;
+    /**
+     * Guard function for all bindings in this keymap.
+     *
+     * When both global and per-binding `when` guards are provided, both must
+     * return `true` for the handler to fire. Global guard is checked first.
+     *
+     * @example
+     * { when: (e) => !isModalOpen() }
+     */
+    when?: When;
 }
 export interface Keymap {
-    [Symbol.dispose](): void;
     bind(shortcut: string, value: BindingValue): () => void;
-    dispose(): void;
     readonly disposalSignal: AbortSignal;
+    dispose(): void;
     readonly disposed: boolean;
     listBindings(): readonly BindingEntry[];
     mount(target: EventTarget): () => void;
     unbind(shortcut: string): void;
+    [Symbol.dispose](): void;
 }
 //# sourceMappingURL=types.d.ts.map