npm - ngx-keys - Versions diffs - 1.1.0 → 1.2.0 - Mend

ngx-keys 1.1.0 → 1.2.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 (5) hide show

package/fesm2022/ngx-keys.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ngx-keys.mjs","sources":["../../../projects/ngx-keys/src/lib/keyboard-shortcuts.errors.ts","../../../projects/ngx-keys/src/lib/keyboard-shortcuts.ts","../../../projects/ngx-keys/src/public-api.ts","../../../projects/ngx-keys/src/ngx-keys.ts"],"sourcesContent":["/*\n Centralized error messages for keyboard shortcuts service\n * This ensures consistency across the application and makes testing easier\n /\nexport const KeyboardShortcutsErrors = {\n // Registration errors\n SHORTCUT_ALREADY_REGISTERED: (id: string) => `Shortcut \"${id}\" already registered`,\n GROUP_ALREADY_REGISTERED: (id: string) => `Group \"${id}\" already registered`,\n KEY_CONFLICT: (conflictId: string) => `Key conflict with \"${conflictId}\"`,\n SHORTCUT_IDS_ALREADY_REGISTERED: (ids: string[]) => `Shortcut IDs already registered: ${ids.join(', ')}`,\n DUPLICATE_SHORTCUTS_IN_GROUP: (ids: string[]) => `Duplicate shortcuts in group: ${ids.join(', ')}`,\n KEY_CONFLICTS_IN_GROUP: (conflicts: string[]) => `Key conflicts: ${conflicts.join(', ')}`,\n \n // Operation errors\n SHORTCUT_NOT_REGISTERED: (id: string) => `Shortcut \"${id}\" not registered`,\n GROUP_NOT_REGISTERED: (id: string) => `Group \"${id}\" not registered`,\n \n // Activation/Deactivation errors\n CANNOT_ACTIVATE_SHORTCUT: (id: string) => `Cannot activate shortcut \"${id}\": not registered`,\n CANNOT_DEACTIVATE_SHORTCUT: (id: string) => `Cannot deactivate shortcut \"${id}\": not registered`,\n CANNOT_ACTIVATE_GROUP: (id: string) => `Cannot activate group \"${id}\": not registered`,\n CANNOT_DEACTIVATE_GROUP: (id: string) => `Cannot deactivate group \"${id}\": not registered`,\n \n // Unregistration errors\n CANNOT_UNREGISTER_SHORTCUT: (id: string) => `Cannot unregister shortcut \"${id}\": not registered`,\n CANNOT_UNREGISTER_GROUP: (id: string) => `Cannot unregister group \"${id}\": not registered`,\n} as const;\n\n/\n Error types for type safety\n /\nexport type KeyboardShortcutsErrorType = keyof typeof KeyboardShortcutsErrors;\n\n/\n Custom error class for keyboard shortcuts\n /\nexport class KeyboardShortcutError extends Error {\n constructor(\n public readonly errorType: KeyboardShortcutsErrorType,\n message: string,\n public readonly context?: Record<string, any>\n ) {\n super(message);\n this.name = 'KeyboardShortcutError';\n }\n}\n\n/\n Error factory for creating consistent errors\n /\nexport class KeyboardShortcutsErrorFactory {\n static shortcutAlreadyRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_ALREADY_REGISTERED(id),\n { shortcutId: id }\n );\n }\n\n static groupAlreadyRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'GROUP_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.GROUP_ALREADY_REGISTERED(id),\n { groupId: id }\n );\n }\n\n static keyConflict(conflictId: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'KEY_CONFLICT',\n KeyboardShortcutsErrors.KEY_CONFLICT(conflictId),\n { conflictId }\n );\n }\n\n static shortcutIdsAlreadyRegistered(ids: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_IDS_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_IDS_ALREADY_REGISTERED(ids),\n { duplicateIds: ids }\n );\n }\n\n static duplicateShortcutsInGroup(ids: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'DUPLICATE_SHORTCUTS_IN_GROUP',\n KeyboardShortcutsErrors.DUPLICATE_SHORTCUTS_IN_GROUP(ids),\n { duplicateIds: ids }\n );\n }\n\n static keyConflictsInGroup(conflicts: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'KEY_CONFLICTS_IN_GROUP',\n KeyboardShortcutsErrors.KEY_CONFLICTS_IN_GROUP(conflicts),\n { conflicts }\n );\n }\n\n static shortcutNotRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_NOT_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_NOT_REGISTERED(id),\n { shortcutId: id }\n );\n }\n\n static groupNotRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'GROUP_NOT_REGISTERED',\n KeyboardShortcutsErrors.GROUP_NOT_REGISTERED(id),\n { groupId: id }\n );\n }\n\n static cannotActivateShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_ACTIVATE_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_ACTIVATE_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotDeactivateShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_DEACTIVATE_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_DEACTIVATE_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotActivateGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_ACTIVATE_GROUP',\n KeyboardShortcutsErrors.CANNOT_ACTIVATE_GROUP(id),\n { groupId: id }\n );\n }\n\n static cannotDeactivateGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_DEACTIVATE_GROUP',\n KeyboardShortcutsErrors.CANNOT_DEACTIVATE_GROUP(id),\n { groupId: id }\n );\n }\n\n static cannotUnregisterShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_UNREGISTER_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_UNREGISTER_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotUnregisterGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_UNREGISTER_GROUP',\n KeyboardShortcutsErrors.CANNOT_UNREGISTER_GROUP(id),\n { groupId: id }\n );\n }\n}\n","import { DestroyRef, Injectable, OnDestroy, PLATFORM_ID, inject, signal, computed } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport { KeyboardShortcut, KeyboardShortcutActiveUntil, KeyboardShortcutGroup, KeyboardShortcutUI, KeyStep } from './keyboard-shortcut.interface'\nimport { KeyboardShortcutsErrorFactory } from './keyboard-shortcuts.errors';\nimport { Observable, take } from 'rxjs';\n\n@Injectable({\n providedIn: 'root'\n})\nexport class KeyboardShortcuts implements OnDestroy {\n private readonly shortcuts = new Map<string, KeyboardShortcut>();\n private readonly groups = new Map<string, KeyboardShortcutGroup>();\n private readonly activeShortcuts = new Set<string>();\n private readonly activeGroups = new Set<string>();\n private readonly currentlyDownKeys = new Set<string>();\n \n // Single consolidated state signal - reduces memory overhead\n private readonly state = signal({\n shortcuts: new Map<string, KeyboardShortcut>(),\n groups: new Map<string, KeyboardShortcutGroup>(),\n activeShortcuts: new Set<string>(),\n activeGroups: new Set<string>(),\n version: 0 // for change detection optimization\n });\n \n // Primary computed signal - consumers derive what they need from this\n readonly shortcuts$ = computed(() => {\n const state = this.state();\n const activeShortcuts = Array.from(state.activeShortcuts)\n .map(id => state.shortcuts.get(id))\n .filter((s): s is KeyboardShortcut => s !== undefined);\n \n const inactiveShortcuts = Array.from(state.shortcuts.values())\n .filter(s => !state.activeShortcuts.has(s.id));\n \n return {\n active: activeShortcuts,\n inactive: inactiveShortcuts,\n all: Array.from(state.shortcuts.values()),\n groups: {\n active: Array.from(state.activeGroups),\n inactive: Array.from(state.groups.keys())\n .filter(id => !state.activeGroups.has(id))\n }\n };\n });\n\n // Optional: Pre-formatted UI signal for components that need it\n readonly shortcutsUI$ = computed(() => {\n const shortcuts = this.shortcuts$();\n return {\n active: shortcuts.active.map(s => this.formatShortcutForUI(s)),\n inactive: shortcuts.inactive.map(s => this.formatShortcutForUI(s)),\n all: shortcuts.all.map(s => this.formatShortcutForUI(s))\n };\n });\n \n private readonly keydownListener = this.handleKeydown.bind(this);\n private readonly keyupListener = this.handleKeyup.bind(this);\n private readonly blurListener = this.handleWindowBlur.bind(this);\n private readonly visibilityListener = this.handleVisibilityChange.bind(this);\n private isListening = false;\n protected isBrowser: boolean;\n /* Default timeout (ms) for completing a multi-step sequence /\n protected sequenceTimeout = 2000;\n\n /* Runtime state for multi-step sequences /\n private pendingSequence: {\n shortcutId: string;\n stepIndex: number;\n timerId: any;\n } \| null = null;\n\n constructor() {\n // Use try-catch to handle injection context for better testability\n try {\n const platformId = inject(PLATFORM_ID);\n this.isBrowser = isPlatformBrowser(platformId);\n } catch {\n // Fallback for testing - assume browser environment\n this.isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';\n }\n\n if (this.isBrowser) {\n this.startListening();\n }\n }\n\n ngOnDestroy(): void {\n this.stopListening();\n }\n\n /\n Batch updates and increment version for change detection\n /\n private updateState(): void {\n this.state.update(current => ({\n shortcuts: new Map(this.shortcuts),\n groups: new Map(this.groups),\n activeShortcuts: new Set(this.activeShortcuts),\n activeGroups: new Set(this.activeGroups),\n version: current.version + 1\n }));\n }\n\n /\n Utility method for UI formatting\n /\n formatShortcutForUI(shortcut: KeyboardShortcut): KeyboardShortcutUI {\n return {\n id: shortcut.id,\n keys: this.formatStepsForDisplay(shortcut.keys ?? shortcut.steps ?? [], false),\n macKeys: this.formatStepsForDisplay(shortcut.macKeys ?? shortcut.macSteps ?? [], true),\n description: shortcut.description\n };\n }\n\n /\n Utility method for batch operations - reduces signal updates\n /\n batchUpdate(operations: () => void): void {\n operations();\n this.updateState();\n }\n\n /\n Format keys for display with proper Unicode symbols\n /\n private formatKeysForDisplay(keys: string[], isMac = false): string {\n const keyMap: Record<string, string> = isMac ? {\n 'ctrl': '⌃',\n 'alt': '⌥', \n 'shift': '⇧',\n 'meta': '⌘',\n 'cmd': '⌘',\n 'command': '⌘'\n } : {\n 'ctrl': 'Ctrl',\n 'alt': 'Alt',\n 'shift': 'Shift', \n 'meta': 'Win'\n };\n\n return keys\n .map(key => keyMap[key.toLowerCase()] \|\| key.toUpperCase())\n .join('+');\n }\n\n private formatStepsForDisplay(steps: string[] \| string[][], isMac = false): string {\n if (!steps) return '';\n\n // If the first element is an array, assume steps is string[][]\n const normalized = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n if (normalized.length === 0) return '';\n if (normalized.length === 1) return this.formatKeysForDisplay(normalized[0], isMac);\n return normalized.map(step => this.formatKeysForDisplay(step, isMac)).join(', ');\n }\n\n private normalizeToSteps(input: KeyStep[] \| string[]): KeyStep[] {\n if (!input) return [];\n // If first element is an array, assume already KeyStep[]\n if (Array.isArray(input[0])) {\n return input as KeyStep[];\n }\n // Single step array\n return [input as string[]];\n }\n\n /\n Check if a key combination is already registered\n * @returns The ID of the conflicting shortcut, or null if no conflict\n /\n private findConflict(newShortcut: KeyboardShortcut): string \| null {\n for (const existing of this.shortcuts.values()) {\n // Compare single-step shapes if provided\n if (newShortcut.keys && existing.keys && this.keysMatch(newShortcut.keys, existing.keys)) {\n return existing.id;\n }\n if (newShortcut.macKeys && existing.macKeys && this.keysMatch(newShortcut.macKeys, existing.macKeys)) {\n return existing.id;\n }\n\n // Compare multi-step shapes\n if (newShortcut.steps && existing.steps && this.stepsMatch(newShortcut.steps, existing.steps)) {\n return existing.id;\n }\n if (newShortcut.macSteps && existing.macSteps && this.stepsMatch(newShortcut.macSteps, existing.macSteps)) {\n return existing.id;\n }\n }\n return null;\n }\n\n /\n Register a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID is already registered or key combination is in use\n /\n register(shortcut: KeyboardShortcut): void {\n if (this.shortcuts.has(shortcut.id)) {\n throw KeyboardShortcutsErrorFactory.shortcutAlreadyRegistered(shortcut.id);\n }\n\n const conflictId = this.findConflict(shortcut);\n if (conflictId) {\n throw KeyboardShortcutsErrorFactory.keyConflict(conflictId);\n }\n \n this.shortcuts.set(shortcut.id, shortcut);\n this.activeShortcuts.add(shortcut.id);\n this.updateState();\n\n this.setupActiveUntil(\n shortcut.activeUntil,\n this.unregister.bind(this, shortcut.id),\n );\n }\n\n /\n Register multiple keyboard shortcuts as a group\n * @throws KeyboardShortcutError if group ID is already registered or if any shortcut ID or key combination conflicts\n /\n registerGroup(groupId: string, shortcuts: KeyboardShortcut[], activeUntil?: KeyboardShortcutActiveUntil): void {\n // Check if group ID already exists\n if (this.groups.has(groupId)) {\n throw KeyboardShortcutsErrorFactory.groupAlreadyRegistered(groupId);\n }\n \n // Check for duplicate shortcut IDs and key combination conflicts\n const duplicateIds: string[] = [];\n const keyConflicts: string[] = [];\n shortcuts.forEach(shortcut => {\n if (this.shortcuts.has(shortcut.id)) {\n duplicateIds.push(shortcut.id);\n }\n const conflictId = this.findConflict(shortcut);\n if (conflictId) {\n keyConflicts.push(`\"${shortcut.id}\" conflicts with \"${conflictId}\"`);\n }\n });\n \n if (duplicateIds.length > 0) {\n throw KeyboardShortcutsErrorFactory.shortcutIdsAlreadyRegistered(duplicateIds);\n }\n\n if (keyConflicts.length > 0) {\n throw KeyboardShortcutsErrorFactory.keyConflictsInGroup(keyConflicts);\n }\n \n // Validate that all shortcuts have unique IDs within the group\n const groupIds = new Set<string>();\n const duplicatesInGroup: string[] = [];\n shortcuts.forEach(shortcut => {\n if (groupIds.has(shortcut.id)) {\n duplicatesInGroup.push(shortcut.id);\n } else {\n groupIds.add(shortcut.id);\n }\n });\n \n if (duplicatesInGroup.length > 0) {\n throw KeyboardShortcutsErrorFactory.duplicateShortcutsInGroup(duplicatesInGroup);\n }\n \n // Use batch update to reduce signal updates\n this.batchUpdate(() => {\n const group: KeyboardShortcutGroup = {\n id: groupId,\n shortcuts,\n active: true\n };\n \n this.groups.set(groupId, group);\n this.activeGroups.add(groupId);\n \n // Register individual shortcuts\n shortcuts.forEach(shortcut => {\n this.shortcuts.set(shortcut.id, shortcut);\n this.activeShortcuts.add(shortcut.id);\n });\n });\n\n this.setupActiveUntil(\n activeUntil,\n this.unregisterGroup.bind(this, groupId),\n );\n }\n\n /\n Unregister a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist\n /\n unregister(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotUnregisterShortcut(shortcutId);\n }\n \n this.shortcuts.delete(shortcutId);\n this.activeShortcuts.delete(shortcutId);\n this.updateState();\n }\n\n /\n Unregister a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist\n /\n unregisterGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotUnregisterGroup(groupId);\n }\n \n this.batchUpdate(() => {\n group.shortcuts.forEach(shortcut => {\n this.shortcuts.delete(shortcut.id);\n this.activeShortcuts.delete(shortcut.id);\n });\n this.groups.delete(groupId);\n this.activeGroups.delete(groupId);\n });\n }\n\n /\n Activate a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist\n /\n activate(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotActivateShortcut(shortcutId);\n }\n \n this.activeShortcuts.add(shortcutId);\n this.updateState();\n }\n\n /\n Deactivate a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist\n /\n deactivate(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotDeactivateShortcut(shortcutId);\n }\n \n this.activeShortcuts.delete(shortcutId);\n this.updateState();\n }\n\n /\n Activate a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist\n /\n activateGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotActivateGroup(groupId);\n }\n \n this.batchUpdate(() => {\n group.active = true;\n this.activeGroups.add(groupId);\n group.shortcuts.forEach(shortcut => {\n this.activeShortcuts.add(shortcut.id);\n });\n });\n }\n\n /\n Deactivate a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist\n /\n deactivateGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotDeactivateGroup(groupId);\n }\n \n this.batchUpdate(() => {\n group.active = false;\n this.activeGroups.delete(groupId);\n group.shortcuts.forEach(shortcut => {\n this.activeShortcuts.delete(shortcut.id);\n });\n });\n }\n\n /\n Check if a shortcut is active\n /\n isActive(shortcutId: string): boolean {\n return this.activeShortcuts.has(shortcutId);\n }\n\n /\n Check if a shortcut is registered\n /\n isRegistered(shortcutId: string): boolean {\n return this.shortcuts.has(shortcutId);\n }\n\n /\n Check if a group is active\n /\n isGroupActive(groupId: string): boolean {\n return this.activeGroups.has(groupId);\n }\n\n /\n Check if a group is registered\n /\n isGroupRegistered(groupId: string): boolean {\n return this.groups.has(groupId);\n }\n\n /\n Get all registered shortcuts\n /\n getShortcuts(): ReadonlyMap<string, KeyboardShortcut> {\n return this.shortcuts;\n }\n\n /\n Get all registered groups\n /\n getGroups(): ReadonlyMap<string, KeyboardShortcutGroup> {\n return this.groups;\n }\n\n private startListening(): void {\n if (!this.isBrowser \|\| this.isListening) {\n return;\n }\n \n // Listen to both keydown and keyup so we can maintain a Set of currently\n // pressed physical keys. We avoid passive:true because we may call\n // preventDefault() when matching shortcuts.\n document.addEventListener('keydown', this.keydownListener, { passive: false });\n document.addEventListener('keyup', this.keyupListener, { passive: false });\n // Listen for blur/visibility changes so we can clear the currently-down keys\n // and avoid stale state when the browser or tab loses focus.\n window.addEventListener('blur', this.blurListener);\n document.addEventListener('visibilitychange', this.visibilityListener);\n this.isListening = true;\n }\n\n private stopListening(): void {\n if (!this.isBrowser \|\| !this.isListening) {\n return;\n }\n \n document.removeEventListener('keydown', this.keydownListener);\n document.removeEventListener('keyup', this.keyupListener);\n window.removeEventListener('blur', this.blurListener);\n document.removeEventListener('visibilitychange', this.visibilityListener);\n this.isListening = false;\n }\n\n protected handleKeydown(event: KeyboardEvent): void {\n // Update the currently down keys with this event's key\n this.updateCurrentlyDownKeysOnKeydown(event);\n\n // Build the pressed keys set used for matching. Prefer the currentlyDownKeys\n // if it contains more than one non-modifier key; otherwise fall back to the\n // traditional per-event pressed keys calculation for compatibility.\n // Use a Set for matching to avoid allocations and sorting on every event\n const pressedKeys = this.buildPressedKeysForMatch(event);\n const isMac = this.isMacPlatform();\n\n // If there is a pending multi-step sequence, try to advance it first\n if (this.pendingSequence) {\n const pending = this.pendingSequence;\n const shortcut = this.shortcuts.get(pending.shortcutId);\n if (shortcut) {\n const steps = isMac\n ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])\n : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);\n const normalizedSteps = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n const expected = normalizedSteps[pending.stepIndex];\n\n // Use per-event pressed keys for advancing sequence steps. Relying on\n // the accumulated `currentlyDownKeys` can accidentally include keys\n // from previous steps (if tests or callers don't emit keyup), which\n // would prevent matching a simple single-key step like ['s'] after\n // a prior ['k'] step. Use getPressedKeys(event) which reflects the\n // actual modifier/main-key state for this event.\n const stepPressed = this.getPressedKeys(event);\n\n if (expected && this.keysMatch(stepPressed, expected)) {\n // Advance sequence\n clearTimeout(pending.timerId);\n pending.stepIndex += 1;\n\n if (pending.stepIndex >= normalizedSteps.length) {\n // Completed\n event.preventDefault();\n event.stopPropagation();\n try {\n shortcut.action();\n } catch (error) {\n console.error(`Error executing keyboard shortcut \"${shortcut.id}\":`, error);\n }\n this.pendingSequence = null;\n return;\n }\n\n // Reset timer for next step\n pending.timerId = setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout);\n return;\n } else {\n // Cancel pending if doesn't match\n this.clearPendingSequence();\n }\n } else {\n // pending exists but shortcut not found\n this.clearPendingSequence();\n }\n }\n\n // No pending sequence - check active shortcuts for a match or sequence start\n for (const shortcutId of this.activeShortcuts) {\n const shortcut = this.shortcuts.get(shortcutId);\n if (!shortcut) continue;\n\n const steps = isMac\n ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])\n : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);\n const normalizedSteps = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n\n const firstStep = normalizedSteps[0];\n if (this.keysMatch(pressedKeys, firstStep)) {\n if (normalizedSteps.length === 1) {\n // single-step\n event.preventDefault();\n event.stopPropagation();\n try {\n shortcut.action();\n } catch (error) {\n console.error(`Error executing keyboard shortcut \"${shortcut.id}\":`, error);\n }\n break;\n } else {\n // start pending sequence\n if (this.pendingSequence) {\n this.clearPendingSequence();\n }\n this.pendingSequence = {\n shortcutId: shortcut.id,\n stepIndex: 1,\n timerId: setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout)\n };\n event.preventDefault();\n event.stopPropagation();\n return;\n }\n }\n }\n }\n\n protected handleKeyup(event: KeyboardEvent): void {\n // Remove the key from currentlyDownKeys on keyup\n const key = event.key ? event.key.toLowerCase() : '';\n if (key && !['control', 'alt', 'shift', 'meta'].includes(key)) {\n this.currentlyDownKeys.delete(key);\n }\n }\n\n /\n Clear the currently-down keys. Exposed for testing and for use by\n * blur/visibilitychange handlers to avoid stale state when the page loses focus.\n /\n clearCurrentlyDownKeys(): void {\n this.currentlyDownKeys.clear();\n }\n\n protected handleWindowBlur(): void {\n this.clearCurrentlyDownKeys();\n // Clear any pressed keys and any pending multi-step sequence to avoid\n // stale state when the window loses focus.\n this.clearPendingSequence();\n }\n\n protected handleVisibilityChange(): void {\n if (document.visibilityState === 'hidden') {\n // When the document becomes hidden, clear both pressed keys and any\n // pending multi-step sequence. This prevents sequences from remaining\n // active when the user switches tabs or minimizes the window.\n this.clearCurrentlyDownKeys();\n this.clearPendingSequence();\n }\n }\n\n /\n Update the currentlyDownKeys set when keydown events happen.\n * Normalizes common keys (function keys, space, etc.) to the same values\n * used by getPressedKeys/keysMatch.\n /\n protected updateCurrentlyDownKeysOnKeydown(event: KeyboardEvent): void {\n const key = event.key ? event.key.toLowerCase() : '';\n\n // Ignore modifier-only keydown entries\n if (['control', 'alt', 'shift', 'meta'].includes(key)) {\n return;\n }\n\n // Normalize some special cases similar to the demo component's recording logic\n if (event.code && event.code.startsWith('F') && /^F\\d+$/.test(event.code)) {\n this.currentlyDownKeys.add(event.code.toLowerCase());\n return;\n }\n\n if (key === ' ') {\n this.currentlyDownKeys.add('space');\n return;\n }\n\n if (key === 'escape') {\n this.currentlyDownKeys.add('escape');\n return;\n }\n\n if (key === 'enter') {\n this.currentlyDownKeys.add('enter');\n return;\n }\n\n if (key && key.length > 0) {\n this.currentlyDownKeys.add(key);\n }\n }\n\n /\n Build the pressed keys array used for matching against registered shortcuts.\n * If multiple non-modifier keys are currently down, include them (chord support).\n * Otherwise fall back to single main-key detection from the event for compatibility.\n /\n /\n Build the pressed keys set used for matching against registered shortcuts.\n * If multiple non-modifier keys are currently down, include them (chord support).\n * Otherwise fall back to single main-key detection from the event for compatibility.\n \n Returns a Set<string> (lowercased) to allow O(1) lookups and O(n) comparisons\n * without sorting or allocating sorted arrays on every event.\n /\n protected buildPressedKeysForMatch(event: KeyboardEvent): Set<string> {\n const modifiers = new Set<string>();\n if (event.ctrlKey) modifiers.add('ctrl');\n if (event.altKey) modifiers.add('alt');\n if (event.shiftKey) modifiers.add('shift');\n if (event.metaKey) modifiers.add('meta');\n\n // Collect non-modifier keys from currentlyDownKeys (excluding modifiers)\n const nonModifierKeys = Array.from(this.currentlyDownKeys).filter(k => !['control', 'alt', 'shift', 'meta'].includes(k));\n\n const result = new Set<string>();\n // Add modifiers first\n modifiers.forEach(m => result.add(m));\n\n if (nonModifierKeys.length > 0) {\n nonModifierKeys.forEach(k => result.add(k.toLowerCase()));\n return result;\n }\n\n // Fallback: single main key from the event (existing behavior)\n const key = event.key.toLowerCase();\n if (!['control', 'alt', 'shift', 'meta'].includes(key)) {\n result.add(key);\n }\n return result;\n }\n\n protected getPressedKeys(event: KeyboardEvent): string[] {\n const keys: string[] = [];\n \n if (event.ctrlKey) keys.push('ctrl');\n if (event.altKey) keys.push('alt');\n if (event.shiftKey) keys.push('shift');\n if (event.metaKey) keys.push('meta');\n \n // Add the main key (normalize to lowercase)\n const key = event.key.toLowerCase();\n if (!['control', 'alt', 'shift', 'meta'].includes(key)) {\n keys.push(key);\n }\n \n return keys;\n }\n\n /\n Compare pressed keys against a target key combination.\n * Accepts either a Set<string> (preferred) or an array for backwards compatibility.\n * Uses Set-based comparison: sizes must match and every element in target must exist in pressed.\n /\n protected keysMatch(pressedKeys: Set<string> \| string[], targetKeys: string[]): boolean {\n // Normalize targetKeys into a Set<string> (lowercased)\n const normalizedTarget = new Set<string>(targetKeys.map(k => k.toLowerCase()));\n\n // Normalize pressedKeys into a Set<string> if it's an array\n const pressedSet: Set<string> = Array.isArray(pressedKeys)\n ? new Set<string>(pressedKeys.map(k => k.toLowerCase()))\n : new Set<string>(Array.from(pressedKeys).map(k => k.toLowerCase()));\n\n if (pressedSet.size !== normalizedTarget.size) {\n return false;\n }\n \n // Check if every element in normalizedTarget exists in pressedSet\n for (const key of normalizedTarget) {\n if (!pressedSet.has(key)) {\n return false;\n }\n }\n \n return true;\n }\n\n /* Compare two multi-step sequences for equality /\n protected stepsMatch(a: string[][], b: string[][]): boolean {\n if (a.length !== b.length) return false;\n for (let i = 0; i < a.length; i++) {\n if (!this.keysMatch(a[i], b[i])) return false;\n }\n return true;\n }\n\n /* Safely clear any pending multi-step sequence /\n private clearPendingSequence(): void {\n if (!this.pendingSequence) return;\n try {\n clearTimeout(this.pendingSequence.timerId);\n } catch { / ignore / }\n this.pendingSequence = null;\n }\n\n protected isMacPlatform(): boolean {\n return this.isBrowser && /Mac\|iPod\|iPhone\|iPad/.test(navigator.platform);\n }\n \n protected setupActiveUntil (activeUntil: KeyboardShortcutActiveUntil\|undefined, unregister: () => void) {\n if (!activeUntil) {\n return\n }\n\n if (activeUntil === 'destruct') {\n inject(DestroyRef).onDestroy(unregister);\n return\n } \n \n if (activeUntil instanceof DestroyRef) {\n activeUntil.onDestroy(unregister);\n return\n } \n \n if (activeUntil instanceof Observable) {\n activeUntil.pipe(take(1)).subscribe(unregister);\n return\n }\n }\n}\n","/\n * Public API Surface of ngx-keys\n /\n\nexport from './lib/keyboard-shortcuts';\nexport * from './lib/keyboard-shortcut.interface';\nexport * from './lib/keyboard-shortcuts.errors';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"ngx-keys.mjs","sources":["../../../projects/ngx-keys/src/lib/keyboard-shortcuts.errors.ts","../../../projects/ngx-keys/src/lib/keyboard-shortcuts.ts","../../../projects/ngx-keys/src/public-api.ts","../../../projects/ngx-keys/src/ngx-keys.ts"],"sourcesContent":["/*\n Centralized error messages for keyboard shortcuts service\n * This ensures consistency across the application and makes testing easier\n /\nexport const KeyboardShortcutsErrors = {\n // Registration errors\n SHORTCUT_ALREADY_REGISTERED: (id: string) => `Shortcut \"${id}\" already registered`,\n GROUP_ALREADY_REGISTERED: (id: string) => `Group \"${id}\" already registered`,\n KEY_CONFLICT: (conflictId: string) => `Key conflict with \"${conflictId}\"`,\n ACTIVE_KEY_CONFLICT: (conflictId: string) => `Key conflict with active shortcut \"${conflictId}\"`,\n ACTIVATION_KEY_CONFLICT: (shortcutId: string, conflictIds: string[]) => `Cannot activate \"${shortcutId}\": would conflict with active shortcuts: ${conflictIds.join(', ')}`,\n GROUP_ACTIVATION_KEY_CONFLICT: (groupId: string, conflictIds: string[]) => `Cannot activate group \"${groupId}\": would conflict with active shortcuts: ${conflictIds.join(', ')}`,\n SHORTCUT_IDS_ALREADY_REGISTERED: (ids: string[]) => `Shortcut IDs already registered: ${ids.join(', ')}`,\n DUPLICATE_SHORTCUTS_IN_GROUP: (ids: string[]) => `Duplicate shortcuts in group: ${ids.join(', ')}`,\n KEY_CONFLICTS_IN_GROUP: (conflicts: string[]) => `Key conflicts: ${conflicts.join(', ')}`,\n \n // Operation errors\n SHORTCUT_NOT_REGISTERED: (id: string) => `Shortcut \"${id}\" not registered`,\n GROUP_NOT_REGISTERED: (id: string) => `Group \"${id}\" not registered`,\n \n // Activation/Deactivation errors\n CANNOT_ACTIVATE_SHORTCUT: (id: string) => `Cannot activate shortcut \"${id}\": not registered`,\n CANNOT_DEACTIVATE_SHORTCUT: (id: string) => `Cannot deactivate shortcut \"${id}\": not registered`,\n CANNOT_ACTIVATE_GROUP: (id: string) => `Cannot activate group \"${id}\": not registered`,\n CANNOT_DEACTIVATE_GROUP: (id: string) => `Cannot deactivate group \"${id}\": not registered`,\n \n // Unregistration errors\n CANNOT_UNREGISTER_SHORTCUT: (id: string) => `Cannot unregister shortcut \"${id}\": not registered`,\n CANNOT_UNREGISTER_GROUP: (id: string) => `Cannot unregister group \"${id}\": not registered`,\n} as const;\n\n/\n Error types for type safety\n /\nexport type KeyboardShortcutsErrorType = keyof typeof KeyboardShortcutsErrors;\n\n/\n Custom error class for keyboard shortcuts\n /\nexport class KeyboardShortcutError extends Error {\n constructor(\n public readonly errorType: KeyboardShortcutsErrorType,\n message: string,\n public readonly context?: Record<string, any>\n ) {\n super(message);\n this.name = 'KeyboardShortcutError';\n }\n}\n\n/\n Error factory for creating consistent errors\n /\nexport class KeyboardShortcutsErrorFactory {\n static shortcutAlreadyRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_ALREADY_REGISTERED(id),\n { shortcutId: id }\n );\n }\n\n static groupAlreadyRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'GROUP_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.GROUP_ALREADY_REGISTERED(id),\n { groupId: id }\n );\n }\n\n static keyConflict(conflictId: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'KEY_CONFLICT',\n KeyboardShortcutsErrors.KEY_CONFLICT(conflictId),\n { conflictId }\n );\n }\n\n static activeKeyConflict(conflictId: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'ACTIVE_KEY_CONFLICT',\n KeyboardShortcutsErrors.ACTIVE_KEY_CONFLICT(conflictId),\n { conflictId }\n );\n }\n\n static activationKeyConflict(shortcutId: string, conflictIds: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'ACTIVATION_KEY_CONFLICT',\n KeyboardShortcutsErrors.ACTIVATION_KEY_CONFLICT(shortcutId, conflictIds),\n { shortcutId, conflictIds }\n );\n }\n\n static groupActivationKeyConflict(groupId: string, conflictIds: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'GROUP_ACTIVATION_KEY_CONFLICT',\n KeyboardShortcutsErrors.GROUP_ACTIVATION_KEY_CONFLICT(groupId, conflictIds),\n { groupId, conflictIds }\n );\n }\n\n static shortcutIdsAlreadyRegistered(ids: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_IDS_ALREADY_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_IDS_ALREADY_REGISTERED(ids),\n { duplicateIds: ids }\n );\n }\n\n static duplicateShortcutsInGroup(ids: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'DUPLICATE_SHORTCUTS_IN_GROUP',\n KeyboardShortcutsErrors.DUPLICATE_SHORTCUTS_IN_GROUP(ids),\n { duplicateIds: ids }\n );\n }\n\n static keyConflictsInGroup(conflicts: string[]): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'KEY_CONFLICTS_IN_GROUP',\n KeyboardShortcutsErrors.KEY_CONFLICTS_IN_GROUP(conflicts),\n { conflicts }\n );\n }\n\n static shortcutNotRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'SHORTCUT_NOT_REGISTERED',\n KeyboardShortcutsErrors.SHORTCUT_NOT_REGISTERED(id),\n { shortcutId: id }\n );\n }\n\n static groupNotRegistered(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'GROUP_NOT_REGISTERED',\n KeyboardShortcutsErrors.GROUP_NOT_REGISTERED(id),\n { groupId: id }\n );\n }\n\n static cannotActivateShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_ACTIVATE_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_ACTIVATE_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotDeactivateShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_DEACTIVATE_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_DEACTIVATE_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotActivateGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_ACTIVATE_GROUP',\n KeyboardShortcutsErrors.CANNOT_ACTIVATE_GROUP(id),\n { groupId: id }\n );\n }\n\n static cannotDeactivateGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_DEACTIVATE_GROUP',\n KeyboardShortcutsErrors.CANNOT_DEACTIVATE_GROUP(id),\n { groupId: id }\n );\n }\n\n static cannotUnregisterShortcut(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_UNREGISTER_SHORTCUT',\n KeyboardShortcutsErrors.CANNOT_UNREGISTER_SHORTCUT(id),\n { shortcutId: id }\n );\n }\n\n static cannotUnregisterGroup(id: string): KeyboardShortcutError {\n return new KeyboardShortcutError(\n 'CANNOT_UNREGISTER_GROUP',\n KeyboardShortcutsErrors.CANNOT_UNREGISTER_GROUP(id),\n { groupId: id }\n );\n }\n}\n","import {\n afterNextRender,\n computed,\n DestroyRef,\n DOCUMENT,\n inject,\n Injectable,\n OnDestroy,\n signal,\n} from '@angular/core';\nimport { KeyboardShortcut, KeyboardShortcutActiveUntil, KeyboardShortcutFilter, KeyboardShortcutGroup, KeyboardShortcutGroupOptions, KeyboardShortcutUI, KeyStep } from './keyboard-shortcut.interface'\nimport { KeyboardShortcutsErrorFactory } from './keyboard-shortcuts.errors';\nimport { Observable, take } from 'rxjs';\n\n/\n Type guard to detect KeyboardShortcutGroupOptions at runtime.\n * Centralising this logic keeps registerGroup simpler and less fragile.\n /\nfunction isGroupOptions(param: unknown): param is KeyboardShortcutGroupOptions {\n if (!param \|\| typeof param !== 'object') return false;\n // Narrow to object for property checks\n const obj = param as Record<string, unknown>;\n return ('filter' in obj) \|\| ('activeUntil' in obj);\n}\n\n/\n Detect real DestroyRef instances or duck-typed objects exposing onDestroy(fn).\n * Returns true for either an actual DestroyRef or an object with an onDestroy method.\n /\nfunction isDestroyRefLike(obj: unknown): obj is DestroyRef & { onDestroy: (fn: () => void) => void } {\n if (!obj \|\| typeof obj !== 'object') return false;\n try {\n // Prefer instanceof when available (real DestroyRef)\n if (obj instanceof DestroyRef) return true;\n } catch {\n // instanceof may throw if DestroyRef is not constructable in certain runtimes/tests\n }\n\n const o = obj as Record<string, unknown>;\n return typeof o['onDestroy'] === 'function';\n}\n\n@Injectable({\n providedIn: 'root'\n})\nexport class KeyboardShortcuts implements OnDestroy {\n private static readonly MODIFIER_KEYS = new Set(['control', 'alt', 'shift', 'meta']);\n private readonly document = inject(DOCUMENT);\n private readonly window = this.document.defaultView!;\n\n private readonly shortcuts = new Map<string, KeyboardShortcut>();\n private readonly groups = new Map<string, KeyboardShortcutGroup>();\n private readonly activeShortcuts = new Set<string>();\n private readonly activeGroups = new Set<string>();\n private readonly currentlyDownKeys = new Set<string>();\n // O(1) lookup from shortcutId to its groupId to avoid scanning all groups per event\n private readonly shortcutToGroup = new Map<string, string>();\n\n /\n Named global filters that apply to all shortcuts.\n * All global filters must return `true` for a shortcut to be processed.\n /\n private readonly globalFilters = new Map<string, KeyboardShortcutFilter>();\n\n // Single consolidated state signal - reduces memory overhead\n private readonly state = signal({\n shortcuts: new Map<string, KeyboardShortcut>(),\n groups: new Map<string, KeyboardShortcutGroup>(),\n activeShortcuts: new Set<string>(),\n activeGroups: new Set<string>(),\n version: 0 // for change detection optimization\n });\n\n // Primary computed signal - consumers derive what they need from this\n readonly shortcuts$ = computed(() => {\n const state = this.state();\n const activeShortcuts = Array.from(state.activeShortcuts)\n .map(id => state.shortcuts.get(id))\n .filter((s): s is KeyboardShortcut => s !== undefined);\n\n const inactiveShortcuts = Array.from(state.shortcuts.values())\n .filter(s => !state.activeShortcuts.has(s.id));\n\n return {\n active: activeShortcuts,\n inactive: inactiveShortcuts,\n all: Array.from(state.shortcuts.values()),\n groups: {\n active: Array.from(state.activeGroups),\n inactive: Array.from(state.groups.keys())\n .filter(id => !state.activeGroups.has(id))\n }\n };\n });\n\n // Optional: Pre-formatted UI signal for components that need it\n readonly shortcutsUI$ = computed(() => {\n const shortcuts = this.shortcuts$();\n return {\n active: shortcuts.active.map(s => this.formatShortcutForUI(s)),\n inactive: shortcuts.inactive.map(s => this.formatShortcutForUI(s)),\n all: shortcuts.all.map(s => this.formatShortcutForUI(s))\n };\n });\n\n private readonly keydownListener = this.handleKeydown.bind(this);\n private readonly keyupListener = this.handleKeyup.bind(this);\n private readonly blurListener = this.handleWindowBlur.bind(this);\n private readonly visibilityListener = this.handleVisibilityChange.bind(this);\n private isListening = false;\n /* Default timeout (ms) for completing a multi-step sequence /\n protected sequenceTimeout = 2000;\n\n /* Runtime state for multi-step sequences /\n private pendingSequence: {\n shortcutId: string;\n stepIndex: number;\n timerId: any;\n } \| null = null;\n\n constructor() {\n afterNextRender(() => {\n this.startListening();\n });\n }\n\n ngOnDestroy(): void {\n this.stopListening();\n }\n\n /\n Batch updates and increment version for change detection\n /\n private updateState(): void {\n this.state.update(current => ({\n shortcuts: new Map(this.shortcuts),\n groups: new Map(this.groups),\n activeShortcuts: new Set(this.activeShortcuts),\n activeGroups: new Set(this.activeGroups),\n version: current.version + 1\n }));\n }\n\n /\n Utility method for UI formatting\n /\n formatShortcutForUI(shortcut: KeyboardShortcut): KeyboardShortcutUI {\n return {\n id: shortcut.id,\n keys: this.formatStepsForDisplay(shortcut.keys ?? shortcut.steps ?? [], false),\n macKeys: this.formatStepsForDisplay(shortcut.macKeys ?? shortcut.macSteps ?? [], true),\n description: shortcut.description\n };\n }\n\n /\n Utility method for batch operations - reduces signal updates\n /\n batchUpdate(operations: () => void): void {\n operations();\n this.updateState();\n }\n\n /\n Format keys for display with proper Unicode symbols\n /\n private formatKeysForDisplay(keys: string[], isMac = false): string {\n const keyMap: Record<string, string> = isMac ? {\n 'ctrl': '⌃',\n 'alt': '⌥',\n 'shift': '⇧',\n 'meta': '⌘',\n 'cmd': '⌘',\n 'command': '⌘'\n } : {\n 'ctrl': 'Ctrl',\n 'alt': 'Alt',\n 'shift': 'Shift',\n 'meta': 'Win'\n };\n\n return keys\n .map(key => keyMap[key.toLowerCase()] \|\| key.toUpperCase())\n .join('+');\n }\n\n private formatStepsForDisplay(steps: string[] \| string[][], isMac = false): string {\n if (!steps) return '';\n\n // If the first element is an array, assume steps is string[][]\n const normalized = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n if (normalized.length === 0) return '';\n if (normalized.length === 1) return this.formatKeysForDisplay(normalized[0], isMac);\n return normalized.map(step => this.formatKeysForDisplay(step, isMac)).join(', ');\n }\n\n private normalizeToSteps(input: KeyStep[] \| string[]): KeyStep[] {\n if (!input) return [];\n // If first element is an array, assume already KeyStep[]\n if (Array.isArray(input[0])) {\n return input as KeyStep[];\n }\n // Single step array\n return [input as string[]];\n }\n\n /\n Check if a key combination is already registered by an active shortcut\n * @returns The ID of the conflicting active shortcut, or null if no active conflict\n /\n private findActiveConflict(newShortcut: KeyboardShortcut): string \| null {\n for (const existing of this.shortcuts.values()) {\n // Only check conflicts with active shortcuts\n if (!this.activeShortcuts.has(existing.id)) {\n continue;\n }\n\n // Compare single-step shapes if provided\n if (newShortcut.keys && existing.keys && this.keysMatch(newShortcut.keys, existing.keys)) {\n return existing.id;\n }\n if (newShortcut.macKeys && existing.macKeys && this.keysMatch(newShortcut.macKeys, existing.macKeys)) {\n return existing.id;\n }\n\n // Compare multi-step shapes\n if (newShortcut.steps && existing.steps && this.stepsMatch(newShortcut.steps, existing.steps)) {\n return existing.id;\n }\n if (newShortcut.macSteps && existing.macSteps && this.stepsMatch(newShortcut.macSteps, existing.macSteps)) {\n return existing.id;\n }\n }\n return null;\n }\n\n /\n Check if activating a shortcut would create key conflicts with other active shortcuts\n * @returns Array of conflicting shortcut IDs that would be created by activation\n /\n private findActivationConflicts(shortcutId: string): string[] {\n const shortcut = this.shortcuts.get(shortcutId);\n if (!shortcut) return [];\n\n const conflicts: string[] = [];\n for (const existing of this.shortcuts.values()) {\n // Skip self and inactive shortcuts\n if (existing.id === shortcutId \|\| !this.activeShortcuts.has(existing.id)) {\n continue;\n }\n\n // Check for key conflicts\n if ((shortcut.keys && existing.keys && this.keysMatch(shortcut.keys, existing.keys)) \|\|\n (shortcut.macKeys && existing.macKeys && this.keysMatch(shortcut.macKeys, existing.macKeys)) \|\|\n (shortcut.steps && existing.steps && this.stepsMatch(shortcut.steps, existing.steps)) \|\|\n (shortcut.macSteps && existing.macSteps && this.stepsMatch(shortcut.macSteps, existing.macSteps))) {\n conflicts.push(existing.id);\n }\n }\n return conflicts;\n }\n\n /\n Register a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID is already registered or if the shortcut would conflict with currently active shortcuts\n /\n register(shortcut: KeyboardShortcut): void {\n if (this.shortcuts.has(shortcut.id)) {\n throw KeyboardShortcutsErrorFactory.shortcutAlreadyRegistered(shortcut.id);\n }\n\n // Check for conflicts only with currently active shortcuts\n const conflictId = this.findActiveConflict(shortcut);\n if (conflictId) {\n throw KeyboardShortcutsErrorFactory.activeKeyConflict(conflictId);\n }\n\n this.shortcuts.set(shortcut.id, shortcut);\n this.activeShortcuts.add(shortcut.id);\n this.updateState();\n\n this.setupActiveUntil(\n shortcut.activeUntil,\n this.unregister.bind(this, shortcut.id),\n );\n }\n\n /\n Register multiple keyboard shortcuts as a group\n * @param groupId - Unique identifier for the group\n * @param shortcuts - Array of shortcuts to register as a group\n * @param options - Optional configuration including filter and activeUntil\n * @throws KeyboardShortcutError if group ID is already registered or if any shortcut ID or key combination conflicts\n /\n registerGroup(groupId: string, shortcuts: KeyboardShortcut[], options?: KeyboardShortcutGroupOptions): void;\n /\n @deprecated Use registerGroup(groupId, shortcuts, { activeUntil }) instead\n /\n registerGroup(groupId: string, shortcuts: KeyboardShortcut[], activeUntil?: KeyboardShortcutActiveUntil): void;\n registerGroup(groupId: string, shortcuts: KeyboardShortcut[], optionsOrActiveUntil?: KeyboardShortcutGroupOptions \| KeyboardShortcutActiveUntil): void {\n // Parse parameters - support both old (activeUntil) and new (options) formats\n let options: KeyboardShortcutGroupOptions;\n if (isGroupOptions(optionsOrActiveUntil)) {\n // New format with options object\n options = optionsOrActiveUntil;\n } else {\n // Old format with just activeUntil parameter\n options = { activeUntil: optionsOrActiveUntil as KeyboardShortcutActiveUntil };\n }\n\n // Check if group ID already exists\n if (this.groups.has(groupId)) {\n throw KeyboardShortcutsErrorFactory.groupAlreadyRegistered(groupId);\n }\n \n // Check for duplicate shortcut IDs and key combination conflicts with active shortcuts\n const duplicateIds: string[] = [];\n const keyConflicts: string[] = [];\n shortcuts.forEach(shortcut => {\n if (this.shortcuts.has(shortcut.id)) {\n duplicateIds.push(shortcut.id);\n }\n const conflictId = this.findActiveConflict(shortcut);\n if (conflictId) {\n keyConflicts.push(`\"${shortcut.id}\" conflicts with active shortcut \"${conflictId}\"`);\n }\n });\n\n if (duplicateIds.length > 0) {\n throw KeyboardShortcutsErrorFactory.shortcutIdsAlreadyRegistered(duplicateIds);\n }\n\n if (keyConflicts.length > 0) {\n throw KeyboardShortcutsErrorFactory.keyConflictsInGroup(keyConflicts);\n }\n\n // Validate that all shortcuts have unique IDs within the group\n const groupIds = new Set<string>();\n const duplicatesInGroup: string[] = [];\n shortcuts.forEach(shortcut => {\n if (groupIds.has(shortcut.id)) {\n duplicatesInGroup.push(shortcut.id);\n } else {\n groupIds.add(shortcut.id);\n }\n });\n\n if (duplicatesInGroup.length > 0) {\n throw KeyboardShortcutsErrorFactory.duplicateShortcutsInGroup(duplicatesInGroup);\n }\n\n // Use batch update to reduce signal updates\n this.batchUpdate(() => {\n const group: KeyboardShortcutGroup = {\n id: groupId,\n shortcuts,\n active: true,\n filter: options.filter\n };\n\n this.groups.set(groupId, group);\n this.activeGroups.add(groupId);\n\n // Register individual shortcuts\n shortcuts.forEach(shortcut => {\n this.shortcuts.set(shortcut.id, shortcut);\n this.activeShortcuts.add(shortcut.id);\n this.shortcutToGroup.set(shortcut.id, groupId);\n });\n });\n\n this.setupActiveUntil(\n options.activeUntil,\n this.unregisterGroup.bind(this, groupId),\n );\n }\n\n /\n Unregister a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist\n /\n unregister(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotUnregisterShortcut(shortcutId);\n }\n\n this.shortcuts.delete(shortcutId);\n this.activeShortcuts.delete(shortcutId);\n this.shortcutToGroup.delete(shortcutId);\n this.updateState();\n }\n\n /\n Unregister a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist\n /\n unregisterGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotUnregisterGroup(groupId);\n }\n\n this.batchUpdate(() => {\n group.shortcuts.forEach(shortcut => {\n this.shortcuts.delete(shortcut.id);\n this.activeShortcuts.delete(shortcut.id);\n this.shortcutToGroup.delete(shortcut.id);\n });\n this.groups.delete(groupId);\n this.activeGroups.delete(groupId);\n });\n }\n\n /\n Activate a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist or if activation would create key conflicts\n /\n activate(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotActivateShortcut(shortcutId);\n }\n\n // Check for conflicts that would be created by activation\n const conflicts = this.findActivationConflicts(shortcutId);\n if (conflicts.length > 0) {\n throw KeyboardShortcutsErrorFactory.activationKeyConflict(shortcutId, conflicts);\n }\n\n this.activeShortcuts.add(shortcutId);\n this.updateState();\n }\n\n /\n Deactivate a single keyboard shortcut\n * @throws KeyboardShortcutError if shortcut ID doesn't exist\n /\n deactivate(shortcutId: string): void {\n if (!this.shortcuts.has(shortcutId)) {\n throw KeyboardShortcutsErrorFactory.cannotDeactivateShortcut(shortcutId);\n }\n\n this.activeShortcuts.delete(shortcutId);\n this.updateState();\n }\n\n /\n Activate a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist or if activation would create key conflicts\n /\n activateGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotActivateGroup(groupId);\n }\n\n // Check for conflicts that would be created by activating all shortcuts in the group\n const allConflicts: string[] = [];\n group.shortcuts.forEach(shortcut => {\n const conflicts = this.findActivationConflicts(shortcut.id);\n allConflicts.push(...conflicts);\n });\n\n if (allConflicts.length > 0) {\n throw KeyboardShortcutsErrorFactory.groupActivationKeyConflict(groupId, allConflicts);\n }\n\n this.batchUpdate(() => {\n group.active = true;\n this.activeGroups.add(groupId);\n group.shortcuts.forEach(shortcut => {\n this.activeShortcuts.add(shortcut.id);\n });\n });\n }\n\n /\n Deactivate a group of keyboard shortcuts\n * @throws KeyboardShortcutError if group ID doesn't exist\n /\n deactivateGroup(groupId: string): void {\n const group = this.groups.get(groupId);\n if (!group) {\n throw KeyboardShortcutsErrorFactory.cannotDeactivateGroup(groupId);\n }\n\n this.batchUpdate(() => {\n group.active = false;\n this.activeGroups.delete(groupId);\n group.shortcuts.forEach(shortcut => {\n this.activeShortcuts.delete(shortcut.id);\n });\n });\n }\n\n /\n Check if a shortcut is active\n /\n isActive(shortcutId: string): boolean {\n return this.activeShortcuts.has(shortcutId);\n }\n\n /\n Check if a shortcut is registered\n /\n isRegistered(shortcutId: string): boolean {\n return this.shortcuts.has(shortcutId);\n }\n\n /\n Check if a group is active\n /\n isGroupActive(groupId: string): boolean {\n return this.activeGroups.has(groupId);\n }\n\n /\n Check if a group is registered\n /\n isGroupRegistered(groupId: string): boolean {\n return this.groups.has(groupId);\n }\n\n /\n Get all registered shortcuts\n /\n getShortcuts(): ReadonlyMap<string, KeyboardShortcut> {\n return this.shortcuts;\n }\n\n /\n Get all registered groups\n /\n getGroups(): ReadonlyMap<string, KeyboardShortcutGroup> {\n return this.groups;\n }\n\n /\n Add a named global filter that applies to all shortcuts.\n * All global filters must return `true` for a shortcut to execute.\n * \n * @param name - Unique name for this filter\n * @param filter - Function that returns `true` to allow shortcuts, `false` to block them\n * \n * @example\n * ```typescript\n * // Block shortcuts in form elements\n * keyboardService.addFilter('forms', (event) => {\n * const target = event.target as HTMLElement;\n * const tagName = target?.tagName?.toLowerCase();\n * return !['input', 'textarea', 'select'].includes(tagName) && !target?.isContentEditable;\n * });\n * \n * // Block shortcuts when modal is open\n * keyboardService.addFilter('modal', (event) => {\n * return !document.querySelector('.modal.active');\n * });\n * ```\n /\n addFilter(name: string, filter: KeyboardShortcutFilter): void {\n this.globalFilters.set(name, filter);\n }\n\n /\n Remove a named global filter.\n * \n * @param name - Name of the filter to remove\n * @returns `true` if filter was removed, `false` if it didn't exist\n /\n removeFilter(name: string): boolean {\n return this.globalFilters.delete(name);\n }\n\n /\n Get a named global filter.\n * \n * @param name - Name of the filter to retrieve\n * @returns The filter function, or undefined if not found\n /\n getFilter(name: string): KeyboardShortcutFilter \| undefined {\n return this.globalFilters.get(name);\n }\n\n /\n Get all global filter names.\n * \n * @returns Array of filter names\n /\n getFilterNames(): string[] {\n return Array.from(this.globalFilters.keys());\n }\n\n /\n Remove all global filters.\n /\n clearFilters(): void {\n this.globalFilters.clear();\n }\n\n /\n Check if a named filter exists.\n * \n * @param name - Name of the filter to check\n * @returns `true` if filter exists, `false` otherwise\n /\n hasFilter(name: string): boolean {\n return this.globalFilters.has(name);\n }\n\n /\n Find the group that contains a specific shortcut.\n * \n * @param shortcutId - The ID of the shortcut to find\n * @returns The group containing the shortcut, or undefined if not found in any group\n /\n private findGroupForShortcut(shortcutId: string): KeyboardShortcutGroup \| undefined {\n const groupId = this.shortcutToGroup.get(shortcutId);\n return groupId ? this.groups.get(groupId) : undefined;\n }\n\n /\n Check if a keyboard event should be processed based on global, group, and per-shortcut filters.\n * Filter hierarchy: Global filters → Group filter → Individual shortcut filter\n * \n * @param event - The keyboard event to evaluate\n * @param shortcut - The shortcut being evaluated (for per-shortcut filter)\n * @returns `true` if event should be processed, `false` if it should be ignored\n /\n private shouldProcessEvent(event: KeyboardEvent, shortcut: KeyboardShortcut): boolean {\n // First, check all global filters - ALL must return true\n // Note: handleKeydown pre-checks these once per event for early exit,\n // but we keep this for direct calls and completeness.\n for (const globalFilter of this.globalFilters.values()) {\n if (!globalFilter(event)) {\n return false;\n }\n }\n\n // Then check group filter if shortcut belongs to a group\n const group = this.findGroupForShortcut(shortcut.id);\n if (group?.filter && !group.filter(event)) {\n return false;\n }\n\n // Finally check per-shortcut filter if it exists\n if (shortcut.filter && !shortcut.filter(event)) {\n return false;\n }\n\n return true;\n }\n\n private startListening(): void {\n if (this.isListening) {\n return;\n }\n\n // Listen to both keydown and keyup so we can maintain a Set of currently\n // pressed physical keys. We avoid passive:true because we may call\n // preventDefault() when matching shortcuts.\n this.document.addEventListener('keydown', this.keydownListener, { passive: false });\n this.document.addEventListener('keyup', this.keyupListener, { passive: false });\n // Listen for blur/visibility changes so we can clear the currently-down keys\n // and avoid stale state when the browser or tab loses focus.\n this.window.addEventListener('blur', this.blurListener);\n this.document.addEventListener('visibilitychange', this.visibilityListener);\n this.isListening = true;\n }\n\n private stopListening(): void {\n if (!this.isListening) {\n return;\n }\n\n this.document.removeEventListener('keydown', this.keydownListener);\n this.document.removeEventListener('keyup', this.keyupListener);\n this.window.removeEventListener('blur', this.blurListener);\n this.document.removeEventListener('visibilitychange', this.visibilityListener);\n this.isListening = false;\n }\n\n protected handleKeydown(event: KeyboardEvent): void {\n // Update the currently down keys with this event's key\n this.updateCurrentlyDownKeysOnKeydown(event);\n\n // Fast path: if any global filter blocks this event, bail out before\n // scanning all active shortcuts. This drastically reduces per-event work\n // when filters are commonly blocking (e.g., while typing in inputs).\n if (this.globalFilters.size > 0) {\n for (const f of this.globalFilters.values()) {\n if (!f(event)) {\n // Also clear any pending multi-step sequence – entering a globally\n // filtered context should not allow sequences to continue.\n this.clearPendingSequence();\n return;\n }\n }\n }\n\n const isMac = this.isMacPlatform();\n\n // Evaluate active group-level filters once per event and cache blocked groups\n const blockedGroups = this.precomputeBlockedGroups(event);\n\n // If there is a pending multi-step sequence, try to advance it first\n if (this.pendingSequence) {\n const pending = this.pendingSequence;\n const shortcut = this.shortcuts.get(pending.shortcutId);\n if (shortcut) {\n // If the pending shortcut belongs to a blocked group, cancel sequence\n const g = this.findGroupForShortcut(shortcut.id);\n if (g && blockedGroups.has(g.id)) {\n this.clearPendingSequence();\n return;\n }\n const steps = isMac\n ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])\n : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);\n const normalizedSteps = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n const expected = normalizedSteps[pending.stepIndex];\n\n // Use per-event pressed keys for advancing sequence steps. Relying on\n // the accumulated `currentlyDownKeys` can accidentally include keys\n // from previous steps (if tests or callers don't emit keyup), which\n // would prevent matching a simple single-key step like ['s'] after\n // a prior ['k'] step. Use getPressedKeys(event) which reflects the\n // actual modifier/main-key state for this event as a Set<string>.\n const stepPressed = this.getPressedKeys(event);\n\n if (expected && this.keysMatch(stepPressed, expected)) {\n // Advance sequence\n clearTimeout(pending.timerId);\n pending.stepIndex += 1;\n\n if (pending.stepIndex >= normalizedSteps.length) {\n // Completed - check filters before executing\n if (!this.shouldProcessEvent(event, shortcut)) {\n this.pendingSequence = null;\n return; // Skip execution due to filters\n }\n\n event.preventDefault();\n event.stopPropagation();\n try {\n shortcut.action();\n } catch (error) {\n console.error(`Error executing keyboard shortcut \"${shortcut.id}\":`, error);\n }\n this.pendingSequence = null;\n return;\n }\n\n // Reset timer for next step\n pending.timerId = setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout);\n return;\n } else {\n // Cancel pending if doesn't match\n this.clearPendingSequence();\n }\n } else {\n // pending exists but shortcut not found\n this.clearPendingSequence();\n }\n }\n\n // No pending sequence - check active shortcuts for a match or sequence start\n for (const shortcutId of this.activeShortcuts) {\n const shortcut = this.shortcuts.get(shortcutId);\n if (!shortcut) continue;\n\n // Skip expensive matching entirely when the shortcut's group is blocked\n const g = this.findGroupForShortcut(shortcut.id);\n if (g && blockedGroups.has(g.id)) {\n continue;\n }\n\n const steps = isMac\n ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])\n : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);\n const normalizedSteps = this.normalizeToSteps(steps as KeyStep[] \| string[]);\n\n const firstStep = normalizedSteps[0];\n\n // Decide which pressed-keys representation to use for this shortcut's\n // expected step: if it requires multiple non-modifier keys, treat it as\n // a chord and use accumulated keys; otherwise use per-event keys to avoid\n // interference from previously pressed non-modifier keys.\n const nonModifierCount = firstStep.filter(k => !KeyboardShortcuts.MODIFIER_KEYS.has(k.toLowerCase())).length;\n // Normalize pressed keys to a Set<string> for consistent typing\n const pressedForStep: Set<string> = nonModifierCount > 1\n ? this.buildPressedKeysForMatch(event)\n : this.getPressedKeys(event);\n\n if (this.keysMatch(pressedForStep, firstStep)) {\n // Check if this event should be processed based on filters\n if (!this.shouldProcessEvent(event, shortcut)) {\n continue; // Skip this shortcut due to filters\n }\n\n if (normalizedSteps.length === 1) {\n // single-step\n event.preventDefault();\n event.stopPropagation();\n try {\n shortcut.action();\n } catch (error) {\n console.error(`Error executing keyboard shortcut \"${shortcut.id}\":`, error);\n }\n break;\n } else {\n // start pending sequence\n if (this.pendingSequence) {\n this.clearPendingSequence();\n }\n this.pendingSequence = {\n shortcutId: shortcut.id,\n stepIndex: 1,\n timerId: setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout)\n };\n event.preventDefault();\n event.stopPropagation();\n return;\n }\n }\n }\n }\n\n protected handleKeyup(event: KeyboardEvent): void {\n // Remove the key from currentlyDownKeys on keyup\n const key = event.key ? event.key.toLowerCase() : '';\n if (key && !KeyboardShortcuts.MODIFIER_KEYS.has(key)) {\n this.currentlyDownKeys.delete(key);\n }\n }\n\n /\n Clear the currently-down keys. Exposed for testing and for use by\n * blur/visibilitychange handlers to avoid stale state when the page loses focus.\n /\n clearCurrentlyDownKeys(): void {\n this.currentlyDownKeys.clear();\n }\n\n protected handleWindowBlur(): void {\n this.clearCurrentlyDownKeys();\n // Clear any pressed keys and any pending multi-step sequence to avoid\n // stale state when the window loses focus.\n this.clearPendingSequence();\n }\n\n protected handleVisibilityChange(): void {\n if (this.document.visibilityState === 'hidden') {\n // When the document becomes hidden, clear both pressed keys and any\n // pending multi-step sequence. This prevents sequences from remaining\n // active when the user switches tabs or minimizes the window.\n this.clearCurrentlyDownKeys();\n this.clearPendingSequence();\n }\n }\n\n /\n Update the currentlyDownKeys set when keydown events happen.\n * Normalizes common keys (function keys, space, etc.) to the same values\n * used by getPressedKeys/keysMatch.\n /\n protected updateCurrentlyDownKeysOnKeydown(event: KeyboardEvent): void {\n const key = event.key ? event.key.toLowerCase() : '';\n\n // Ignore modifier-only keydown entries\n if (KeyboardShortcuts.MODIFIER_KEYS.has(key)) {\n return;\n }\n\n // Normalize some special cases similar to the demo component's recording logic\n if (event.code && event.code.startsWith('F') && /^F\\d+$/.test(event.code)) {\n this.currentlyDownKeys.add(event.code.toLowerCase());\n return;\n }\n\n if (key === ' ') {\n this.currentlyDownKeys.add('space');\n return;\n }\n\n if (key === 'escape') {\n this.currentlyDownKeys.add('escape');\n return;\n }\n\n if (key === 'enter') {\n this.currentlyDownKeys.add('enter');\n return;\n }\n\n if (key && key.length > 0) {\n this.currentlyDownKeys.add(key);\n }\n }\n\n /\n Build the pressed keys set used for matching against registered shortcuts.\n * If multiple non-modifier keys are currently down, include them (chord support).\n * Otherwise fall back to single main-key detection from the event for compatibility.\n \n Returns a Set<string> (lowercased) to allow O(1) lookups and O(n) comparisons\n * without sorting or allocating sorted arrays on every event.\n /\n protected buildPressedKeysForMatch(event: KeyboardEvent): Set<string> {\n const modifiers = new Set<string>();\n if (event.ctrlKey) modifiers.add('ctrl');\n if (event.altKey) modifiers.add('alt');\n if (event.shiftKey) modifiers.add('shift');\n if (event.metaKey) modifiers.add('meta');\n\n // Collect non-modifier keys from currentlyDownKeys (excluding modifiers)\n const nonModifierKeys = Array.from(this.currentlyDownKeys).filter(k => !KeyboardShortcuts.MODIFIER_KEYS.has(k));\n\n const result = new Set<string>();\n // Add modifiers first\n modifiers.forEach(m => result.add(m));\n\n if (nonModifierKeys.length > 0) {\n nonModifierKeys.forEach(k => result.add(k.toLowerCase()));\n return result;\n }\n\n // Fallback: single main key from the event (existing behavior)\n const key = event.key.toLowerCase();\n if (!KeyboardShortcuts.MODIFIER_KEYS.has(key)) {\n result.add(key);\n }\n return result;\n }\n\n /\n Return the pressed keys for this event as a Set<string>.\n * This is the canonical internal API used for matching.\n /\n protected getPressedKeys(event: KeyboardEvent): Set<string> {\n const result = new Set<string>();\n\n if (event.ctrlKey) result.add('ctrl');\n if (event.altKey) result.add('alt');\n if (event.shiftKey) result.add('shift');\n if (event.metaKey) result.add('meta');\n\n // Add the main key (normalize to lowercase) if it's not a modifier\n const key = (event.key ?? '').toLowerCase();\n if (key && !KeyboardShortcuts.MODIFIER_KEYS.has(key)) {\n result.add(key);\n }\n\n return result;\n }\n\n /\n Compare pressed keys against a target key combination.\n * Accepts either a Set<string> (preferred) or an array for backwards compatibility.\n * Uses Set-based comparison: sizes must match and every element in target must exist in pressed.\n /\n protected keysMatch(pressedKeys: Set<string> \| string[], targetKeys: string[]): boolean {\n // Normalize targetKeys into a Set<string> (lowercased)\n const normalizedTarget = new Set<string>(targetKeys.map(k => k.toLowerCase()));\n\n // Normalize pressedKeys into a Set<string> if it's an array\n const pressedSet: Set<string> = Array.isArray(pressedKeys)\n ? new Set<string>(pressedKeys.map(k => k.toLowerCase()))\n : new Set<string>(Array.from(pressedKeys).map(k => k.toLowerCase()));\n\n if (pressedSet.size !== normalizedTarget.size) {\n return false;\n }\n\n // Check if every element in normalizedTarget exists in pressedSet\n for (const key of normalizedTarget) {\n if (!pressedSet.has(key)) {\n return false;\n }\n }\n\n return true;\n }\n\n /* Compare two multi-step sequences for equality /\n protected stepsMatch(a: string[][], b: string[][]): boolean {\n if (a.length !== b.length) return false;\n for (let i = 0; i < a.length; i++) {\n if (!this.keysMatch(a[i], b[i])) return false;\n }\n return true;\n }\n\n /* Safely clear any pending multi-step sequence /\n private clearPendingSequence(): void {\n if (!this.pendingSequence) return;\n try {\n clearTimeout(this.pendingSequence.timerId);\n } catch { / ignore / }\n this.pendingSequence = null;\n }\n\n protected isMacPlatform(): boolean {\n return /Mac\|iPod\|iPhone\|iPad/.test(this.window.navigator.platform ?? '');\n }\n\n protected setupActiveUntil(activeUntil: KeyboardShortcutActiveUntil \| undefined, unregister: () => void) {\n if (!activeUntil) {\n return\n }\n\n if (activeUntil === 'destruct') {\n inject(DestroyRef).onDestroy(unregister);\n return\n }\n\n // Support both real DestroyRef instances and duck-typed objects (e.g.,\n // Jasmine spies) that expose an onDestroy(fn) method for backwards\n // compatibility with earlier APIs and tests.\n if (isDestroyRefLike(activeUntil)) {\n activeUntil.onDestroy(unregister);\n return;\n }\n\n if (activeUntil instanceof Observable) {\n activeUntil.pipe(take(1)).subscribe(unregister);\n return\n }\n }\n\n /\n Evaluate group filters once per event and return the set of blocked group IDs.\n /\n protected precomputeBlockedGroups(event: KeyboardEvent): Set<string> {\n const blocked = new Set<string>();\n if (this.activeGroups.size === 0) return blocked;\n for (const groupId of this.activeGroups) {\n const group = this.groups.get(groupId);\n if (group && group.filter && !group.filter(event)) {\n blocked.add(groupId);\n }\n }\n return blocked;\n }\n}","/\n * Public API Surface of ngx-keys\n /\n\nexport from './lib/keyboard-shortcuts';\nexport * from './lib/keyboard-shortcut.interface';\nexport * from './lib/keyboard-shortcuts.errors';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":[],"mappings":";;;;AAAA;;;AAGG;AACI,MAAM,uBAAuB,GAAG;;IAErC,2BAA2B,EAAE,CAAC,EAAU,KAAK,CAAA,UAAA,EAAa,EAAE,CAAA,oBAAA,CAAsB;IAClF,wBAAwB,EAAE,CAAC,EAAU,KAAK,CAAA,OAAA,EAAU,EAAE,CAAA,oBAAA,CAAsB;IAC5E,YAAY,EAAE,CAAC,UAAkB,KAAK,CAAA,mBAAA,EAAsB,UAAU,CAAA,CAAA,CAAG;IACzE,mBAAmB,EAAE,CAAC,UAAkB,KAAK,CAAA,mCAAA,EAAsC,UAAU,CAAA,CAAA,CAAG;AAChG,IAAA,uBAAuB,EAAE,CAAC,UAAkB,EAAE,WAAqB,KAAK,CAAA,iBAAA,EAAoB,UAAU,4CAA4C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AAC1K,IAAA,6BAA6B,EAAE,CAAC,OAAe,EAAE,WAAqB,KAAK,CAAA,uBAAA,EAA0B,OAAO,4CAA4C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AAChL,IAAA,+BAA+B,EAAE,CAAC,GAAa,KAAK,CAAA,iCAAA,EAAoC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AACxG,IAAA,4BAA4B,EAAE,CAAC,GAAa,KAAK,CAAA,8BAAA,EAAiC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AAClG,IAAA,sBAAsB,EAAE,CAAC,SAAmB,KAAK,CAAA,eAAA,EAAkB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;;IAGzF,uBAAuB,EAAE,CAAC,EAAU,KAAK,CAAA,UAAA,EAAa,EAAE,CAAA,gBAAA,CAAkB;IAC1E,oBAAoB,EAAE,CAAC,EAAU,KAAK,CAAA,OAAA,EAAU,EAAE,CAAA,gBAAA,CAAkB;;IAGpE,wBAAwB,EAAE,CAAC,EAAU,KAAK,CAAA,0BAAA,EAA6B,EAAE,CAAA,iBAAA,CAAmB;IAC5F,0BAA0B,EAAE,CAAC,EAAU,KAAK,CAAA,4BAAA,EAA+B,EAAE,CAAA,iBAAA,CAAmB;IAChG,qBAAqB,EAAE,CAAC,EAAU,KAAK,CAAA,uBAAA,EAA0B,EAAE,CAAA,iBAAA,CAAmB;IACtF,uBAAuB,EAAE,CAAC,EAAU,KAAK,CAAA,yBAAA,EAA4B,EAAE,CAAA,iBAAA,CAAmB;;IAG1F,0BAA0B,EAAE,CAAC,EAAU,KAAK,CAAA,4BAAA,EAA+B,EAAE,CAAA,iBAAA,CAAmB;IAChG,uBAAuB,EAAE,CAAC,EAAU,KAAK,CAAA,yBAAA,EAA4B,EAAE,CAAA,iBAAA,CAAmB;;AAQ5F;;AAEG;AACG,MAAO,qBAAsB,SAAQ,KAAK,CAAA;AAE5B,IAAA,SAAA;AAEA,IAAA,OAAA;AAHlB,IAAA,WAAA,CACkB,SAAqC,EACrD,OAAe,EACC,OAA6B,EAAA;QAE7C,KAAK,CAAC,OAAO,CAAC;QAJE,IAAA,CAAA,SAAS,GAAT,SAAS;QAET,IAAA,CAAA,OAAO,GAAP,OAAO;AAGvB,QAAA,IAAI,CAAC,IAAI,GAAG,uBAAuB;IACrC;AACD;AAED;;AAEG;MACU,6BAA6B,CAAA;IACxC,OAAO,yBAAyB,CAAC,EAAU,EAAA;AACzC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,6BAA6B,EAC7B,uBAAuB,CAAC,2BAA2B,CAAC,EAAE,CAAC,EACvD,EAAE,UAAU,EAAE,EAAE,EAAE,CACnB;IACH;IAEA,OAAO,sBAAsB,CAAC,EAAU,EAAA;AACtC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,0BAA0B,EAC1B,uBAAuB,CAAC,wBAAwB,CAAC,EAAE,CAAC,EACpD,EAAE,OAAO,EAAE,EAAE,EAAE,CAChB;IACH;IAEA,OAAO,WAAW,CAAC,UAAkB,EAAA;AACnC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,cAAc,EACd,uBAAuB,CAAC,YAAY,CAAC,UAAU,CAAC,EAChD,EAAE,UAAU,EAAE,CACf;IACH;IAEA,OAAO,iBAAiB,CAAC,UAAkB,EAAA;AACzC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,qBAAqB,EACrB,uBAAuB,CAAC,mBAAmB,CAAC,UAAU,CAAC,EACvD,EAAE,UAAU,EAAE,CACf;IACH;AAEA,IAAA,OAAO,qBAAqB,CAAC,UAAkB,EAAE,WAAqB,EAAA;QACpE,OAAO,IAAI,qBAAqB,CAC9B,yBAAyB,EACzB,uBAAuB,CAAC,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,EACxE,EAAE,UAAU,EAAE,WAAW,EAAE,CAC5B;IACH;AAEA,IAAA,OAAO,0BAA0B,CAAC,OAAe,EAAE,WAAqB,EAAA;QACtE,OAAO,IAAI,qBAAqB,CAC9B,+BAA+B,EAC/B,uBAAuB,CAAC,6BAA6B,CAAC,OAAO,EAAE,WAAW,CAAC,EAC3E,EAAE,OAAO,EAAE,WAAW,EAAE,CACzB;IACH;IAEA,OAAO,4BAA4B,CAAC,GAAa,EAAA;AAC/C,QAAA,OAAO,IAAI,qBAAqB,CAC9B,iCAAiC,EACjC,uBAAuB,CAAC,+BAA+B,CAAC,GAAG,CAAC,EAC5D,EAAE,YAAY,EAAE,GAAG,EAAE,CACtB;IACH;IAEA,OAAO,yBAAyB,CAAC,GAAa,EAAA;AAC5C,QAAA,OAAO,IAAI,qBAAqB,CAC9B,8BAA8B,EAC9B,uBAAuB,CAAC,4BAA4B,CAAC,GAAG,CAAC,EACzD,EAAE,YAAY,EAAE,GAAG,EAAE,CACtB;IACH;IAEA,OAAO,mBAAmB,CAAC,SAAmB,EAAA;AAC5C,QAAA,OAAO,IAAI,qBAAqB,CAC9B,wBAAwB,EACxB,uBAAuB,CAAC,sBAAsB,CAAC,SAAS,CAAC,EACzD,EAAE,SAAS,EAAE,CACd;IACH;IAEA,OAAO,qBAAqB,CAAC,EAAU,EAAA;AACrC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,yBAAyB,EACzB,uBAAuB,CAAC,uBAAuB,CAAC,EAAE,CAAC,EACnD,EAAE,UAAU,EAAE,EAAE,EAAE,CACnB;IACH;IAEA,OAAO,kBAAkB,CAAC,EAAU,EAAA;AAClC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,sBAAsB,EACtB,uBAAuB,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAChD,EAAE,OAAO,EAAE,EAAE,EAAE,CAChB;IACH;IAEA,OAAO,sBAAsB,CAAC,EAAU,EAAA;AACtC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,0BAA0B,EAC1B,uBAAuB,CAAC,wBAAwB,CAAC,EAAE,CAAC,EACpD,EAAE,UAAU,EAAE,EAAE,EAAE,CACnB;IACH;IAEA,OAAO,wBAAwB,CAAC,EAAU,EAAA;AACxC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,4BAA4B,EAC5B,uBAAuB,CAAC,0BAA0B,CAAC,EAAE,CAAC,EACtD,EAAE,UAAU,EAAE,EAAE,EAAE,CACnB;IACH;IAEA,OAAO,mBAAmB,CAAC,EAAU,EAAA;AACnC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,uBAAuB,EACvB,uBAAuB,CAAC,qBAAqB,CAAC,EAAE,CAAC,EACjD,EAAE,OAAO,EAAE,EAAE,EAAE,CAChB;IACH;IAEA,OAAO,qBAAqB,CAAC,EAAU,EAAA;AACrC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,yBAAyB,EACzB,uBAAuB,CAAC,uBAAuB,CAAC,EAAE,CAAC,EACnD,EAAE,OAAO,EAAE,EAAE,EAAE,CAChB;IACH;IAEA,OAAO,wBAAwB,CAAC,EAAU,EAAA;AACxC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,4BAA4B,EAC5B,uBAAuB,CAAC,0BAA0B,CAAC,EAAE,CAAC,EACtD,EAAE,UAAU,EAAE,EAAE,EAAE,CACnB;IACH;IAEA,OAAO,qBAAqB,CAAC,EAAU,EAAA;AACrC,QAAA,OAAO,IAAI,qBAAqB,CAC9B,yBAAyB,EACzB,uBAAuB,CAAC,uBAAuB,CAAC,EAAE,CAAC,EACnD,EAAE,OAAO,EAAE,EAAE,EAAE,CAChB;IACH;AACD;;AC/KD;;;AAGG;AACH,SAAS,cAAc,CAAC,KAAc,EAAA;AACpC,IAAA,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAE,QAAA,OAAO,KAAK;;IAErD,MAAM,GAAG,GAAG,KAAgC;IAC5C,OAAO,CAAC,QAAQ,IAAI,GAAG,MAAM,aAAa,IAAI,GAAG,CAAC;AACpD;AAEA;;;AAGG;AACH,SAAS,gBAAgB,CAAC,GAAY,EAAA;AACpC,IAAA,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;AAAE,QAAA,OAAO,KAAK;AACjD,IAAA,IAAI;;QAEF,IAAI,GAAG,YAAY,UAAU;AAAE,YAAA,OAAO,IAAI;IAC5C;AAAE,IAAA,MAAM;;IAER;IAEA,MAAM,CAAC,GAAG,GAA8B;AACxC,IAAA,OAAO,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,UAAU;AAC7C;MAKa,iBAAiB,CAAA;AACpB,IAAA,OAAgB,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACnE,IAAA,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AAC3B,IAAA,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAY;AAEnC,IAAA,SAAS,GAAG,IAAI,GAAG,EAA4B;AAC/C,IAAA,MAAM,GAAG,IAAI,GAAG,EAAiC;AACjD,IAAA,eAAe,GAAG,IAAI,GAAG,EAAU;AACnC,IAAA,YAAY,GAAG,IAAI,GAAG,EAAU;AAChC,IAAA,iBAAiB,GAAG,IAAI,GAAG,EAAU;;AAErC,IAAA,eAAe,GAAG,IAAI,GAAG,EAAkB;AAE5D;;;AAGG;AACc,IAAA,aAAa,GAAG,IAAI,GAAG,EAAkC;;IAGzD,KAAK,GAAG,MAAM,CAAC;QAC9B,SAAS,EAAE,IAAI,GAAG,EAA4B;QAC9C,MAAM,EAAE,IAAI,GAAG,EAAiC;QAChD,eAAe,EAAE,IAAI,GAAG,EAAU;QAClC,YAAY,EAAE,IAAI,GAAG,EAAU;QAC/B,OAAO,EAAE,CAAC;AACX,KAAA,EAAA,IAAA,SAAA,GAAA,CAAA,EAAA,SAAA,EAAA,OAAA,EAAA,CAAA,GAAA,EAAA,CAAA,CAAC;;AAGO,IAAA,UAAU,GAAG,QAAQ,CAAC,MAAK;AAClC,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE;QAC1B,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe;AACrD,aAAA,GAAG,CAAC,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;aACjC,MAAM,CAAC,CAAC,CAAC,KAA4B,CAAC,KAAK,SAAS,CAAC;AAExD,QAAA,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;AAC1D,aAAA,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEhD,OAAO;AACL,YAAA,MAAM,EAAE,eAAe;AACvB,YAAA,QAAQ,EAAE,iBAAiB;YAC3B,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;AACzC,YAAA,MAAM,EAAE;gBACN,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;gBACtC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;AACrC,qBAAA,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5C;SACF;AACH,IAAA,CAAC,sDAAC;;AAGO,IAAA,YAAY,GAAG,QAAQ,CAAC,MAAK;AACpC,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE;QACnC,OAAO;AACL,YAAA,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAC9D,YAAA,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAClE,YAAA,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;SACxD;AACH,IAAA,CAAC,wDAAC;IAEe,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/C,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3C,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/C,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;IACpE,WAAW,GAAG,KAAK;;IAEjB,eAAe,GAAG,IAAI;;IAGxB,eAAe,GAIZ,IAAI;AAEf,IAAA,WAAA,GAAA;QACE,eAAe,CAAC,MAAK;YACnB,IAAI,CAAC,cAAc,EAAE;AACvB,QAAA,CAAC,CAAC;IACJ;IAEA,WAAW,GAAA;QACT,IAAI,CAAC,aAAa,EAAE;IACtB;AAEA;;AAEG;IACK,WAAW,GAAA;QACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK;AAC5B,YAAA,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;AAClC,YAAA,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AAC5B,YAAA,eAAe,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC;AAC9C,YAAA,YAAY,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;AACxC,YAAA,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG;AAC5B,SAAA,CAAC,CAAC;IACL;AAEA;;AAEG;AACH,IAAA,mBAAmB,CAAC,QAA0B,EAAA;QAC5C,OAAO;YACL,EAAE,EAAE,QAAQ,CAAC,EAAE;AACf,YAAA,IAAI,EAAE,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC;AAC9E,YAAA,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,IAAI,CAAC;YACtF,WAAW,EAAE,QAAQ,CAAC;SACvB;IACH;AAEA;;AAEG;AACH,IAAA,WAAW,CAAC,UAAsB,EAAA;AAChC,QAAA,UAAU,EAAE;QACZ,IAAI,CAAC,WAAW,EAAE;IACpB;AAEA;;AAEG;AACK,IAAA,oBAAoB,CAAC,IAAc,EAAE,KAAK,GAAG,KAAK,EAAA;AACxD,QAAA,MAAM,MAAM,GAA2B,KAAK,GAAG;AAC7C,YAAA,MAAM,EAAE,GAAG;AACX,YAAA,KAAK,EAAE,GAAG;AACV,YAAA,OAAO,EAAE,GAAG;AACZ,YAAA,MAAM,EAAE,GAAG;AACX,YAAA,KAAK,EAAE,GAAG;AACV,YAAA,SAAS,EAAE;AACZ,SAAA,GAAG;AACF,YAAA,MAAM,EAAE,MAAM;AACd,YAAA,KAAK,EAAE,KAAK;AACZ,YAAA,OAAO,EAAE,OAAO;AAChB,YAAA,MAAM,EAAE;SACT;AAED,QAAA,OAAO;AACJ,aAAA,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE;aACzD,IAAI,CAAC,GAAG,CAAC;IACd;AAEQ,IAAA,qBAAqB,CAAC,KAA4B,EAAE,KAAK,GAAG,KAAK,EAAA;AACvE,QAAA,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,EAAE;;QAGrB,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAA6B,CAAC;AACvE,QAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,EAAE;AACtC,QAAA,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QACnF,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAClF;AAEQ,IAAA,gBAAgB,CAAC,KAA2B,EAAA;AAClD,QAAA,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,EAAE;;QAErB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;AAC3B,YAAA,OAAO,KAAkB;QAC3B;;QAEA,OAAO,CAAC,KAAiB,CAAC;IAC5B;AAEA;;;AAGG;AACK,IAAA,kBAAkB,CAAC,WAA6B,EAAA;QACtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE;;AAE9C,YAAA,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;gBAC1C;YACF;;YAGA,IAAI,WAAW,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;gBACxF,OAAO,QAAQ,CAAC,EAAE;YACpB;YACA,IAAI,WAAW,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;gBACpG,OAAO,QAAQ,CAAC,EAAE;YACpB;;YAGA,IAAI,WAAW,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE;gBAC7F,OAAO,QAAQ,CAAC,EAAE;YACpB;YACA,IAAI,WAAW,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBACzG,OAAO,QAAQ,CAAC,EAAE;YACpB;QACF;AACA,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACK,IAAA,uBAAuB,CAAC,UAAkB,EAAA;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;AAC/C,QAAA,IAAI,CAAC,QAAQ;AAAE,YAAA,OAAO,EAAE;QAExB,MAAM,SAAS,GAAa,EAAE;QAC9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE;;AAE9C,YAAA,IAAI,QAAQ,CAAC,EAAE,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;gBACxE;YACF;;YAGA,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;iBAC9E,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;iBAC3F,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;iBACpF,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE;AACrG,gBAAA,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B;QACF;AACA,QAAA,OAAO,SAAS;IAClB;AAEA;;;AAGG;AACH,IAAA,QAAQ,CAAC,QAA0B,EAAA;QACjC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YACnC,MAAM,6BAA6B,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5E;;QAGA,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QACpD,IAAI,UAAU,EAAE;AACd,YAAA,MAAM,6BAA6B,CAAC,iBAAiB,CAAC,UAAU,CAAC;QACnE;QAEA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;QACzC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE;QAElB,IAAI,CAAC,gBAAgB,CACnB,QAAQ,CAAC,WAAW,EACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CACxC;IACH;AAcA,IAAA,aAAa,CAAC,OAAe,EAAE,SAA6B,EAAE,oBAAiF,EAAA;;AAE7I,QAAA,IAAI,OAAqC;AACzC,QAAA,IAAI,cAAc,CAAC,oBAAoB,CAAC,EAAE;;YAExC,OAAO,GAAG,oBAAoB;QAChC;aAAO;;AAEL,YAAA,OAAO,GAAG,EAAE,WAAW,EAAE,oBAAmD,EAAE;QAChF;;QAGA,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;AAC5B,YAAA,MAAM,6BAA6B,CAAC,sBAAsB,CAAC,OAAO,CAAC;QACrE;;QAGA,MAAM,YAAY,GAAa,EAAE;QACjC,MAAM,YAAY,GAAa,EAAE;AACjC,QAAA,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;YAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;AACnC,gBAAA,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC;YACA,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;YACpD,IAAI,UAAU,EAAE;gBACd,YAAY,CAAC,IAAI,CAAC,CAAA,CAAA,EAAI,QAAQ,CAAC,EAAE,CAAA,kCAAA,EAAqC,UAAU,CAAA,CAAA,CAAG,CAAC;YACtF;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;AAC3B,YAAA,MAAM,6BAA6B,CAAC,4BAA4B,CAAC,YAAY,CAAC;QAChF;AAEA,QAAA,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;AAC3B,YAAA,MAAM,6BAA6B,CAAC,mBAAmB,CAAC,YAAY,CAAC;QACvE;;AAGA,QAAA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU;QAClC,MAAM,iBAAiB,GAAa,EAAE;AACtC,QAAA,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;YAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;AAC7B,gBAAA,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC;iBAAO;AACL,gBAAA,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE;AAChC,YAAA,MAAM,6BAA6B,CAAC,yBAAyB,CAAC,iBAAiB,CAAC;QAClF;;AAGA,QAAA,IAAI,CAAC,WAAW,CAAC,MAAK;AACpB,YAAA,MAAM,KAAK,GAA0B;AACnC,gBAAA,EAAE,EAAE,OAAO;gBACX,SAAS;AACT,gBAAA,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,OAAO,CAAC;aACjB;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;AAC/B,YAAA,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;;AAG9B,YAAA,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;gBAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;gBACzC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;AAChD,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,CAAC,gBAAgB,CACnB,OAAO,CAAC,WAAW,EACnB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CACzC;IACH;AAEA;;;AAGG;AACH,IAAA,UAAU,CAAC,UAAkB,EAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;AACnC,YAAA,MAAM,6BAA6B,CAAC,wBAAwB,CAAC,UAAU,CAAC;QAC1E;AAEA,QAAA,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;AACjC,QAAA,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;AACvC,QAAA,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,EAAE;IACpB;AAEA;;;AAGG;AACH,IAAA,eAAe,CAAC,OAAe,EAAA;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,6BAA6B,CAAC,qBAAqB,CAAC,OAAO,CAAC;QACpE;AAEA,QAAA,IAAI,CAAC,WAAW,CAAC,MAAK;AACpB,YAAA,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;gBACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1C,YAAA,CAAC,CAAC;AACF,YAAA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;AAC3B,YAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;AACnC,QAAA,CAAC,CAAC;IACJ;AAEA;;;AAGG;AACH,IAAA,QAAQ,CAAC,UAAkB,EAAA;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;AACnC,YAAA,MAAM,6BAA6B,CAAC,sBAAsB,CAAC,UAAU,CAAC;QACxE;;QAGA,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC;AAC1D,QAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;YACxB,MAAM,6BAA6B,CAAC,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC;QAClF;AAEA,QAAA,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,WAAW,EAAE;IACpB;AAEA;;;AAGG;AACH,IAAA,UAAU,CAAC,UAAkB,EAAA;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;AACnC,YAAA,MAAM,6BAA6B,CAAC,wBAAwB,CAAC,UAAU,CAAC;QAC1E;AAEA,QAAA,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,EAAE;IACpB;AAEA;;;AAGG;AACH,IAAA,aAAa,CAAC,OAAe,EAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,6BAA6B,CAAC,mBAAmB,CAAC,OAAO,CAAC;QAClE;;QAGA,MAAM,YAAY,GAAa,EAAE;AACjC,QAAA,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3D,YAAA,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;AACjC,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;YAC3B,MAAM,6BAA6B,CAAC,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC;QACvF;AAEA,QAAA,IAAI,CAAC,WAAW,CAAC,MAAK;AACpB,YAAA,KAAK,CAAC,MAAM,GAAG,IAAI;AACnB,YAAA,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;AAC9B,YAAA,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;gBACjC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvC,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;IACJ;AAEA;;;AAGG;AACH,IAAA,eAAe,CAAC,OAAe,EAAA;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,6BAA6B,CAAC,qBAAqB,CAAC,OAAO,CAAC;QACpE;AAEA,QAAA,IAAI,CAAC,WAAW,CAAC,MAAK;AACpB,YAAA,KAAK,CAAC,MAAM,GAAG,KAAK;AACpB,YAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;AACjC,YAAA,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAG;gBACjC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC1C,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;IACJ;AAEA;;AAEG;AACH,IAAA,QAAQ,CAAC,UAAkB,EAAA;QACzB,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;IAC7C;AAEA;;AAEG;AACH,IAAA,YAAY,CAAC,UAAkB,EAAA;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;IACvC;AAEA;;AAEG;AACH,IAAA,aAAa,CAAC,OAAe,EAAA;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;IACvC;AAEA;;AAEG;AACH,IAAA,iBAAiB,CAAC,OAAe,EAAA;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;IACjC;AAEA;;AAEG;IACH,YAAY,GAAA;QACV,OAAO,IAAI,CAAC,SAAS;IACvB;AAEA;;AAEG;IACH,SAAS,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA;;;;;;;;;;;;;;;;;;;;;AAqBG;IACH,SAAS,CAAC,IAAY,EAAE,MAA8B,EAAA;QACpD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;IACtC;AAEA;;;;;AAKG;AACH,IAAA,YAAY,CAAC,IAAY,EAAA;QACvB,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;IACxC;AAEA;;;;;AAKG;AACH,IAAA,SAAS,CAAC,IAAY,EAAA;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;IACrC;AAEA;;;;AAIG;IACH,cAAc,GAAA;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAC9C;AAEA;;AAEG;IACH,YAAY,GAAA;AACV,QAAA,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE;IAC5B;AAEA;;;;;AAKG;AACH,IAAA,SAAS,CAAC,IAAY,EAAA;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;IACrC;AAEA;;;;;AAKG;AACK,IAAA,oBAAoB,CAAC,UAAkB,EAAA;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;AACpD,QAAA,OAAO,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,SAAS;IACvD;AAEA;;;;;;;AAOG;IACK,kBAAkB,CAAC,KAAoB,EAAE,QAA0B,EAAA;;;;QAIzE,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE;AACtD,YAAA,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;AACxB,gBAAA,OAAO,KAAK;YACd;QACF;;QAGA,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACpD,QAAA,IAAI,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;AACzC,YAAA,OAAO,KAAK;QACd;;AAGA,QAAA,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;AAC9C,YAAA,OAAO,KAAK;QACd;AAEA,QAAA,OAAO,IAAI;IACb;IAEQ,cAAc,GAAA;AACpB,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB;QACF;;;;AAKA,QAAA,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnF,QAAA,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;;;QAG/E,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC;AAC3E,QAAA,IAAI,CAAC,WAAW,GAAG,IAAI;IACzB;IAEQ,aAAa,GAAA;AACnB,QAAA,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACrB;QACF;QAEA,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC;QAClE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC;AAC9E,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK;IAC1B;AAEU,IAAA,aAAa,CAAC,KAAoB,EAAA;;AAE1C,QAAA,IAAI,CAAC,gCAAgC,CAAC,KAAK,CAAC;;;;QAK5C,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE;YAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE;AAC3C,gBAAA,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;;;oBAGb,IAAI,CAAC,oBAAoB,EAAE;oBAC3B;gBACF;YACF;QACF;AAEA,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE;;QAGlC,MAAM,aAAa,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;;AAGzD,QAAA,IAAI,IAAI,CAAC,eAAe,EAAE;AACxB,YAAA,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe;AACpC,YAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;YACvD,IAAI,QAAQ,EAAE;;gBAEZ,MAAM,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;oBAChC,IAAI,CAAC,oBAAoB,EAAE;oBAC3B;gBACF;gBACA,MAAM,KAAK,GAAG;AACZ,uBAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE;uBAC9E,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;gBACpF,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAA6B,CAAC;gBAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC;;;;;;;gBAQzD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBAExC,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE;;AAErD,oBAAA,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7B,oBAAA,OAAO,CAAC,SAAS,IAAI,CAAC;oBAEtB,IAAI,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,EAAE;;wBAE/C,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;AAC7C,4BAAA,IAAI,CAAC,eAAe,GAAG,IAAI;AAC3B,4BAAA,OAAO;wBACT;wBAEA,KAAK,CAAC,cAAc,EAAE;wBACtB,KAAK,CAAC,eAAe,EAAE;AACvB,wBAAA,IAAI;4BACF,QAAQ,CAAC,MAAM,EAAE;wBACnB;wBAAE,OAAO,KAAK,EAAE;4BACd,OAAO,CAAC,KAAK,CAAC,CAAA,mCAAA,EAAsC,QAAQ,CAAC,EAAE,CAAA,EAAA,CAAI,EAAE,KAAK,CAAC;wBAC7E;AACA,wBAAA,IAAI,CAAC,eAAe,GAAG,IAAI;wBAC3B;oBACF;;oBAGA,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;oBAC1F;gBACF;qBAAO;;oBAEL,IAAI,CAAC,oBAAoB,EAAE;gBAC7B;YACF;iBAAO;;gBAEL,IAAI,CAAC,oBAAoB,EAAE;YAC7B;QACF;;AAGA,QAAA,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,eAAe,EAAE;YAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;AAC/C,YAAA,IAAI,CAAC,QAAQ;gBAAE;;YAGf,MAAM,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBAChC;YACF;YAEA,MAAM,KAAK,GAAG;AACZ,mBAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE;mBAC9E,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;YACpF,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAA6B,CAAC;AAE5E,YAAA,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC;;;;;YAMxC,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM;;AAExG,YAAA,MAAM,cAAc,GAAgB,gBAAgB,GAAG;AACrD,kBAAE,IAAI,CAAC,wBAAwB,CAAC,KAAK;AACrC,kBAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAE9B,IAAI,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE;;gBAE7C,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;AAC7C,oBAAA,SAAS;gBACX;AAEA,gBAAA,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE;;oBAEhC,KAAK,CAAC,cAAc,EAAE;oBACtB,KAAK,CAAC,eAAe,EAAE;AACvB,oBAAA,IAAI;wBACF,QAAQ,CAAC,MAAM,EAAE;oBACnB;oBAAE,OAAO,KAAK,EAAE;wBACd,OAAO,CAAC,KAAK,CAAC,CAAA,mCAAA,EAAsC,QAAQ,CAAC,EAAE,CAAA,EAAA,CAAI,EAAE,KAAK,CAAC;oBAC7E;oBACA;gBACF;qBAAO;;AAEL,oBAAA,IAAI,IAAI,CAAC,eAAe,EAAE;wBACxB,IAAI,CAAC,oBAAoB,EAAE;oBAC7B;oBACA,IAAI,CAAC,eAAe,GAAG;wBACrB,UAAU,EAAE,QAAQ,CAAC,EAAE;AACvB,wBAAA,SAAS,EAAE,CAAC;AACZ,wBAAA,OAAO,EAAE,UAAU,CAAC,MAAK,EAAG,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe;qBACjF;oBACD,KAAK,CAAC,cAAc,EAAE;oBACtB,KAAK,CAAC,eAAe,EAAE;oBACvB;gBACF;YACF;QACF;IACF;AAEU,IAAA,WAAW,CAAC,KAAoB,EAAA;;AAExC,QAAA,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE;AACpD,QAAA,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACpD,YAAA,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC;QACpC;IACF;AAEA;;;AAGG;IACH,sBAAsB,GAAA;AACpB,QAAA,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE;IAChC;IAEU,gBAAgB,GAAA;QACxB,IAAI,CAAC,sBAAsB,EAAE;;;QAG7B,IAAI,CAAC,oBAAoB,EAAE;IAC7B;IAEU,sBAAsB,GAAA;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE;;;;YAI9C,IAAI,CAAC,sBAAsB,EAAE;YAC7B,IAAI,CAAC,oBAAoB,EAAE;QAC7B;IACF;AAEA;;;;AAIG;AACO,IAAA,gCAAgC,CAAC,KAAoB,EAAA;AAC7D,QAAA,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE;;QAGpD,IAAI,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAC5C;QACF;;QAGA,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;AACzE,YAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD;QACF;AAEA,QAAA,IAAI,GAAG,KAAK,GAAG,EAAE;AACf,YAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;YACnC;QACF;AAEA,QAAA,IAAI,GAAG,KAAK,QAAQ,EAAE;AACpB,YAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC;YACpC;QACF;AAEA,QAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,YAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;YACnC;QACF;QAEA,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE;AACzB,YAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;QACjC;IACF;AAEA;;;;;;;AAOG;AACO,IAAA,wBAAwB,CAAC,KAAoB,EAAA;AACrD,QAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU;QACnC,IAAI,KAAK,CAAC,OAAO;AAAE,YAAA,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM;AAAE,YAAA,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QACtC,IAAI,KAAK,CAAC,QAAQ;AAAE,YAAA,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO;AAAE,YAAA,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;;QAG1C,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE7G,QAAA,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU;;AAEhC,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAErC,QAAA,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE;AAC9B,YAAA,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACzD,YAAA,OAAO,MAAM;QACf;;QAGA,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE;QACnC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AAC7C,YAAA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACjB;AACA,QAAA,OAAO,MAAM;IACf;AAEA;;;AAGG;AACO,IAAA,cAAc,CAAC,KAAoB,EAAA;AAC3C,QAAA,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU;QAEhC,IAAI,KAAK,CAAC,OAAO;AAAE,YAAA,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM;AAAE,YAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ;AAAE,YAAA,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACvC,IAAI,KAAK,CAAC,OAAO;AAAE,YAAA,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;;AAGrC,QAAA,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,WAAW,EAAE;AAC3C,QAAA,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACpD,YAAA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACjB;AAEA,QAAA,OAAO,MAAM;IACf;AAEA;;;;AAIG;IACO,SAAS,CAAC,WAAmC,EAAE,UAAoB,EAAA;;AAE3E,QAAA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;;AAG9E,QAAA,MAAM,UAAU,GAAgB,KAAK,CAAC,OAAO,CAAC,WAAW;AACvD,cAAE,IAAI,GAAG,CAAS,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;cACrD,IAAI,GAAG,CAAS,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAEtE,IAAI,UAAU,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,EAAE;AAC7C,YAAA,OAAO,KAAK;QACd;;AAGA,QAAA,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACxB,gBAAA,OAAO,KAAK;YACd;QACF;AAEA,QAAA,OAAO,IAAI;IACb;;IAGU,UAAU,CAAC,CAAa,EAAE,CAAa,EAAA;AAC/C,QAAA,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;AAAE,YAAA,OAAO,KAAK;AACvC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACjC,YAAA,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAAE,gBAAA,OAAO,KAAK;QAC/C;AACA,QAAA,OAAO,IAAI;IACb;;IAGQ,oBAAoB,GAAA;QAC1B,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE;AAC3B,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAC5C;AAAE,QAAA,MAAM,eAAe;AACvB,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI;IAC7B;IAEU,aAAa,GAAA;AACrB,QAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC1E;IAEU,gBAAgB,CAAC,WAAoD,EAAE,UAAsB,EAAA;QACrG,IAAI,CAAC,WAAW,EAAE;YAChB;QACF;AAEA,QAAA,IAAI,WAAW,KAAK,UAAU,EAAE;YAC9B,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;YACxC;QACF;;;;AAKA,QAAA,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE;AACjC,YAAA,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC;YACjC;QACF;AAEA,QAAA,IAAI,WAAW,YAAY,UAAU,EAAE;AACrC,YAAA,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;YAC/C;QACF;IACF;AAEA;;AAEG;AACO,IAAA,uBAAuB,CAAC,KAAoB,EAAA;AACpD,QAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU;AACjC,QAAA,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;AAAE,YAAA,OAAO,OAAO;AAChD,QAAA,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;AACtC,YAAA,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;AACjD,gBAAA,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YACtB;QACF;AACA,QAAA,OAAO,OAAO;IAChB;uGAp+BW,iBAAiB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAAjB,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,iBAAiB,cAFhB,MAAM,EAAA,CAAA;;2FAEP,iBAAiB,EAAA,UAAA,EAAA,CAAA;kBAH7B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE;AACb,iBAAA;;;AC5CD;;AAEG;;ACFH;;AAEG;;;;"}

package/index.d.ts CHANGED Viewed

@@ -9,6 +9,14 @@ interface KeyboardShortcut {
     /**
      * Single-step shortcuts keep the existing shape using `keys`/`macKeys`.
      * For multi-step shortcuts, use `steps` (array of steps), where each step is an array of keys.
+     *
+     * The library allows registering multiple shortcuts with the same
+     * key combination as long as they are not simultaneously active. This enables:
+     * - Context-specific shortcuts (e.g., same key in different UI contexts)
+     * - Alternative shortcuts for the same action
+     * - Feature toggles with same keys for different modes
+     *
+     * Conflicts are only checked among active shortcuts, not all registered shortcuts.
      */
     keys?: string[];
     macKeys?: string[];
@@ -17,11 +25,83 @@ interface KeyboardShortcut {
     action: () => void;
     description: string;
     activeUntil?: KeyboardShortcutActiveUntil;
+    /**
+     * Optional filter function for this specific shortcut.
+     * If provided, this filter is evaluated AFTER global filters.
+     * Both global filters AND this filter must return true for the shortcut to execute.
+     *
+     * @param event - The keyboard event to evaluate
+     * @returns `true` to allow this shortcut, `false` to ignore the event
+     *
+     * @example
+     * ```typescript
+     * // This shortcut works everywhere, even bypassing global input filters
+     * {
+     *   id: 'emergency-save',
+     *   keys: ['ctrl', 'shift', 's'],
+     *   action: () => this.emergencySave(),
+     *   filter: () => true, // Always allow
+     *   description: 'Emergency save (works in inputs)'
+     * }
+     * ```
+     */
+    filter?: KeyboardShortcutFilter;
 }
 interface KeyboardShortcutGroup {
     id: string;
     shortcuts: KeyboardShortcut[];
     active: boolean;
+    /**
+     * Optional filter function for this entire group.
+     * If provided, this filter is evaluated AFTER global filters but BEFORE individual shortcut filters.
+     * The filter hierarchy is: Global filters → Group filter → Individual shortcut filter.
+     * All applicable filters must return true for a shortcut to execute.
+     *
+     * @param event - The keyboard event to evaluate
+     * @returns `true` to allow shortcuts in this group, `false` to ignore the event
+     *
+     * @example
+     * ```typescript
+     * // Modal shortcuts group that only works when modal is active
+     * keyboardService.registerGroup('modal-shortcuts', shortcuts, {
+     *   filter: (event) => !!document.querySelector('.modal.active')
+     * });
+     * ```
+     */
+    filter?: KeyboardShortcutFilter;
+}
+/**
+ * Filter function type for determining whether a keyboard event should be processed.
+ * Return `true` to process the event (allow shortcuts), `false` to ignore it.
+ *
+ * @param event - The keyboard event to evaluate
+ * @returns `true` to allow shortcuts, `false` to ignore the event
+ *
+ * @example
+ * ```typescript
+ * // Ignore shortcuts when typing in form elements
+ * const inputFilter: KeyboardShortcutFilter = (event) => {
+ *   const target = event.target as HTMLElement;
+ *   const tagName = target?.tagName?.toLowerCase();
+ *   return !['input', 'textarea', 'select'].includes(tagName) && !target?.isContentEditable;
+ * };
+ * // keyboardService.addFilter('forms', inputFilter);
+ * ```
+ */
+type KeyboardShortcutFilter = (event: KeyboardEvent) => boolean;
+/**
+ * Options for registering a group of keyboard shortcuts
+ */
+interface KeyboardShortcutGroupOptions {
+    /**
+     * Optional filter function for the entire group.
+     * This filter is evaluated after global filters but before individual shortcut filters.
+     */
+    filter?: KeyboardShortcutFilter;
+    /**
+     * Optional lifecycle management for automatic cleanup
+     */
+    activeUntil?: KeyboardShortcutActiveUntil;
 }
 /**
  * Interface for keyboard shortcut data optimized for UI display
@@ -34,11 +114,20 @@ interface KeyboardShortcutUI {
 }
 declare class KeyboardShortcuts implements OnDestroy {
+    private static readonly MODIFIER_KEYS;
+    private readonly document;
+    private readonly window;
     private readonly shortcuts;
     private readonly groups;
     private readonly activeShortcuts;
     private readonly activeGroups;
     private readonly currentlyDownKeys;
+    private readonly shortcutToGroup;
+    /**
+     * Named global filters that apply to all shortcuts.
+     * All global filters must return `true` for a shortcut to be processed.
+     */
+    private readonly globalFilters;
     private readonly state;
     readonly shortcuts$: _angular_core.Signal<{
         active: KeyboardShortcut[];
@@ -59,7 +148,6 @@ declare class KeyboardShortcuts implements OnDestroy {
     private readonly blurListener;
     private readonly visibilityListener;
     private isListening;
-    protected isBrowser: boolean;
     /** Default timeout (ms) for completing a multi-step sequence */
     protected sequenceTimeout: number;
     /** Runtime state for multi-step sequences */
@@ -85,19 +173,31 @@ declare class KeyboardShortcuts implements OnDestroy {
     private formatStepsForDisplay;
     private normalizeToSteps;
     /**
-     * Check if a key combination is already registered
-     * @returns The ID of the conflicting shortcut, or null if no conflict
+     * Check if a key combination is already registered by an active shortcut
+     * @returns The ID of the conflicting active shortcut, or null if no active conflict
+     */
+    private findActiveConflict;
+    /**
+     * Check if activating a shortcut would create key conflicts with other active shortcuts
+     * @returns Array of conflicting shortcut IDs that would be created by activation
      */
-    private findConflict;
+    private findActivationConflicts;
     /**
      * Register a single keyboard shortcut
-     * @throws KeyboardShortcutError if shortcut ID is already registered or key combination is in use
+     * @throws KeyboardShortcutError if shortcut ID is already registered or if the shortcut would conflict with currently active shortcuts
      */
     register(shortcut: KeyboardShortcut): void;
     /**
      * Register multiple keyboard shortcuts as a group
+     * @param groupId - Unique identifier for the group
+     * @param shortcuts - Array of shortcuts to register as a group
+     * @param options - Optional configuration including filter and activeUntil
      * @throws KeyboardShortcutError if group ID is already registered or if any shortcut ID or key combination conflicts
      */
+    registerGroup(groupId: string, shortcuts: KeyboardShortcut[], options?: KeyboardShortcutGroupOptions): void;
+    /**
+     * @deprecated Use registerGroup(groupId, shortcuts, { activeUntil }) instead
+     */
     registerGroup(groupId: string, shortcuts: KeyboardShortcut[], activeUntil?: KeyboardShortcutActiveUntil): void;
     /**
      * Unregister a single keyboard shortcut
@@ -111,7 +211,7 @@ declare class KeyboardShortcuts implements OnDestroy {
     unregisterGroup(groupId: string): void;
     /**
      * Activate a single keyboard shortcut
-     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist or if activation would create key conflicts
      */
     activate(shortcutId: string): void;
     /**
@@ -121,7 +221,7 @@ declare class KeyboardShortcuts implements OnDestroy {
     deactivate(shortcutId: string): void;
     /**
      * Activate a group of keyboard shortcuts
-     * @throws KeyboardShortcutError if group ID doesn't exist
+     * @throws KeyboardShortcutError if group ID doesn't exist or if activation would create key conflicts
      */
     activateGroup(groupId: string): void;
     /**
@@ -153,6 +253,76 @@ declare class KeyboardShortcuts implements OnDestroy {
      * Get all registered groups
      */
     getGroups(): ReadonlyMap<string, KeyboardShortcutGroup>;
+    /**
+     * Add a named global filter that applies to all shortcuts.
+     * All global filters must return `true` for a shortcut to execute.
+     *
+     * @param name - Unique name for this filter
+     * @param filter - Function that returns `true` to allow shortcuts, `false` to block them
+     *
+     * @example
+     * ```typescript
+     * // Block shortcuts in form elements
+     * keyboardService.addFilter('forms', (event) => {
+     *   const target = event.target as HTMLElement;
+     *   const tagName = target?.tagName?.toLowerCase();
+     *   return !['input', 'textarea', 'select'].includes(tagName) && !target?.isContentEditable;
+     * });
+     *
+     * // Block shortcuts when modal is open
+     * keyboardService.addFilter('modal', (event) => {
+     *   return !document.querySelector('.modal.active');
+     * });
+     * ```
+     */
+    addFilter(name: string, filter: KeyboardShortcutFilter): void;
+    /**
+     * Remove a named global filter.
+     *
+     * @param name - Name of the filter to remove
+     * @returns `true` if filter was removed, `false` if it didn't exist
+     */
+    removeFilter(name: string): boolean;
+    /**
+     * Get a named global filter.
+     *
+     * @param name - Name of the filter to retrieve
+     * @returns The filter function, or undefined if not found
+     */
+    getFilter(name: string): KeyboardShortcutFilter | undefined;
+    /**
+     * Get all global filter names.
+     *
+     * @returns Array of filter names
+     */
+    getFilterNames(): string[];
+    /**
+     * Remove all global filters.
+     */
+    clearFilters(): void;
+    /**
+     * Check if a named filter exists.
+     *
+     * @param name - Name of the filter to check
+     * @returns `true` if filter exists, `false` otherwise
+     */
+    hasFilter(name: string): boolean;
+    /**
+     * Find the group that contains a specific shortcut.
+     *
+     * @param shortcutId - The ID of the shortcut to find
+     * @returns The group containing the shortcut, or undefined if not found in any group
+     */
+    private findGroupForShortcut;
+    /**
+     * Check if a keyboard event should be processed based on global, group, and per-shortcut filters.
+     * Filter hierarchy: Global filters → Group filter → Individual shortcut filter
+     *
+     * @param event - The keyboard event to evaluate
+     * @param shortcut - The shortcut being evaluated (for per-shortcut filter)
+     * @returns `true` if event should be processed, `false` if it should be ignored
+     */
+    private shouldProcessEvent;
     private startListening;
     private stopListening;
     protected handleKeydown(event: KeyboardEvent): void;
@@ -170,11 +340,6 @@ declare class KeyboardShortcuts implements OnDestroy {
      * used by getPressedKeys/keysMatch.
      */
     protected updateCurrentlyDownKeysOnKeydown(event: KeyboardEvent): void;
-    /**
-     * Build the pressed keys array used for matching against registered shortcuts.
-     * If multiple non-modifier keys are currently down, include them (chord support).
-     * Otherwise fall back to single main-key detection from the event for compatibility.
-     */
     /**
      * Build the pressed keys set used for matching against registered shortcuts.
      * If multiple non-modifier keys are currently down, include them (chord support).
@@ -184,7 +349,11 @@ declare class KeyboardShortcuts implements OnDestroy {
      * without sorting or allocating sorted arrays on every event.
      */
     protected buildPressedKeysForMatch(event: KeyboardEvent): Set<string>;
-    protected getPressedKeys(event: KeyboardEvent): string[];
+    /**
+     * Return the pressed keys for this event as a Set<string>.
+     * This is the canonical internal API used for matching.
+     */
+    protected getPressedKeys(event: KeyboardEvent): Set<string>;
     /**
      * Compare pressed keys against a target key combination.
      * Accepts either a Set<string> (preferred) or an array for backwards compatibility.
@@ -197,6 +366,10 @@ declare class KeyboardShortcuts implements OnDestroy {
     private clearPendingSequence;
     protected isMacPlatform(): boolean;
     protected setupActiveUntil(activeUntil: KeyboardShortcutActiveUntil | undefined, unregister: () => void): void;
+    /**
+     * Evaluate group filters once per event and return the set of blocked group IDs.
+     */
+    protected precomputeBlockedGroups(event: KeyboardEvent): Set<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KeyboardShortcuts, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KeyboardShortcuts>;
 }
@@ -209,6 +382,9 @@ declare const KeyboardShortcutsErrors: {
     readonly SHORTCUT_ALREADY_REGISTERED: (id: string) => string;
     readonly GROUP_ALREADY_REGISTERED: (id: string) => string;
     readonly KEY_CONFLICT: (conflictId: string) => string;
+    readonly ACTIVE_KEY_CONFLICT: (conflictId: string) => string;
+    readonly ACTIVATION_KEY_CONFLICT: (shortcutId: string, conflictIds: string[]) => string;
+    readonly GROUP_ACTIVATION_KEY_CONFLICT: (groupId: string, conflictIds: string[]) => string;
     readonly SHORTCUT_IDS_ALREADY_REGISTERED: (ids: string[]) => string;
     readonly DUPLICATE_SHORTCUTS_IN_GROUP: (ids: string[]) => string;
     readonly KEY_CONFLICTS_IN_GROUP: (conflicts: string[]) => string;
@@ -240,6 +416,9 @@ declare class KeyboardShortcutsErrorFactory {
     static shortcutAlreadyRegistered(id: string): KeyboardShortcutError;
     static groupAlreadyRegistered(id: string): KeyboardShortcutError;
     static keyConflict(conflictId: string): KeyboardShortcutError;
+    static activeKeyConflict(conflictId: string): KeyboardShortcutError;
+    static activationKeyConflict(shortcutId: string, conflictIds: string[]): KeyboardShortcutError;
+    static groupActivationKeyConflict(groupId: string, conflictIds: string[]): KeyboardShortcutError;
     static shortcutIdsAlreadyRegistered(ids: string[]): KeyboardShortcutError;
     static duplicateShortcutsInGroup(ids: string[]): KeyboardShortcutError;
     static keyConflictsInGroup(conflicts: string[]): KeyboardShortcutError;
@@ -254,4 +433,4 @@ declare class KeyboardShortcutsErrorFactory {
 }
 export { KeyboardShortcutError, KeyboardShortcuts, KeyboardShortcutsErrorFactory, KeyboardShortcutsErrors };
-export type { KeyStep, KeyboardShortcut, KeyboardShortcutActiveUntil, KeyboardShortcutGroup, KeyboardShortcutUI, KeyboardShortcutsErrorType };
+export type { KeyStep, KeyboardShortcut, KeyboardShortcutActiveUntil, KeyboardShortcutFilter, KeyboardShortcutGroup, KeyboardShortcutGroupOptions, KeyboardShortcutUI, KeyboardShortcutsErrorType };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "ngx-keys",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A reactive Angular library for managing keyboard shortcuts with signals-based UI integration",
   "keywords": [
     "angular",