ngx-keys 1.0.0 → 1.1.0

package/README.md

@@ -19,14 +19,21 @@ npm install ngx-keys
 ```
 
 ## Quick Start
-### Displaying Shortcuts
+
+### Register and Display Shortcuts
+>[!NOTE]
+For related shortcuts, use groups for easier management (*[See group management section](#group-management)*).
 
 ```typescript
-import { Component, inject } from '@angular/core';
+import { Component, DestroyRef, inject } from '@angular/core';
 import { KeyboardShortcuts } from 'ngx-keys';
 
 @Component({
   template: `
+    <h3>My App</h3>
+    <p>Last action: {{ lastAction }}</p>
+    
+    <h4>Available Shortcuts:</h4>
     @for (shortcut of activeShortcuts(); track shortcut.id) {
       <div>
         <kbd>{{ shortcut.keys }}</kbd> - {{ shortcut.description }}
@@ -34,11 +41,69 @@ import { KeyboardShortcuts } from 'ngx-keys';
     }
   `
 })
-export class ShortcutsComponent {
+export class MyComponent {
   private readonly keyboardService = inject(KeyboardShortcuts);
+  private readonly destroyRef = inject(DestroyRef);
+  
+  protected lastAction = 'Try pressing Ctrl+S or Ctrl+H';
   protected readonly activeShortcuts = () => this.keyboardService.shortcutsUI$().active;
+
+  constructor() {
+    // Register individual shortcuts (automatically activated)
+    this.keyboardService.register({
+      id: 'save',
+      keys: ['ctrl', 's'],
+      macKeys: ['meta', 's'], 
+      action: () => this.save(),
+      description: 'Save document'
+    });
+
+    this.keyboardService.register({
+      id: 'help',
+      keys: ['ctrl', 'h'],
+      macKeys: ['meta', 'h'],
+      action: () => this.showHelp(),
+      description: 'Show help'
+    });
+
+    // Clean up on component destroy
+    this.destroyRef.onDestroy(() => {
+      this.keyboardService.unregister('save');
+      this.keyboardService.unregister('help');
+    });
+  }
+
+  private save() {
+    this.lastAction = 'Document saved!';
+  }
+
+  private showHelp() {
+    this.lastAction = 'Help displayed!';
+  }
 }
 ```
+
+
+
+## Explore the Demo
+
+Want to see ngx-keys in action? Check out our comprehensive [demo application](/projects/demo) with:
+
+| Component                                                                          | Purpose                    | Key Features                                  |
+| ---------------------------------------------------------------------------------- | -------------------------- | --------------------------------------------- |
+| [**App Component**](/projects/demo/src/app/app.ts)                                 | Global shortcuts           | Single & group registration, cleanup patterns |
+| [**Home Component**](/projects/demo/src/app/home/home.component.ts)                | Reactive UI                | Real-time status display, toggle controls     |
+| [**Feature Component**](/projects/demo/src/app/feature/feature.component.ts)       | Route-specific shortcuts   | Scoped shortcuts, lifecycle management        |
+| [**Customize Component**](/projects/demo/src/app/customize/customize.component.ts) | Dynamic shortcut recording | Real-time key capture, shortcut customization |
+
+**Run the demo:**
+```bash
+git clone https://github.com/mrivasperez/ngx-keys
+cd ngx-keys
+npm install
+npm start
+```
+
 ## Key Concepts
 
 ### Automatic Activation
@@ -57,6 +122,29 @@ this.keyboardService.register({
 });
 ```
 
+### Multi-step (sequence) shortcuts
+
+In addition to single-step shortcuts using `keys` / `macKeys`, ngx-keys supports ordered multi-step sequences using `steps` and `macSteps` on the `KeyboardShortcut` object. Each element in `steps` is itself an array of key tokens that must be pressed together for that step.
+
+Example: register a sequence that requires `Ctrl+K` followed by `S`:
+
+```typescript
+this.keyboardService.register({
+  id: 'open-settings-seq',
+  steps: [['ctrl', 'k'], ['s']],
+  macSteps: [['meta', 'k'], ['s']],
+  action: () => this.openSettings(),
+  description: 'Open settings (Ctrl+K then S)'
+});
+```
+
+Important behavior notes:
+
+- Default sequence timeout: the service requires the next step to be entered within 2000ms (2 seconds) of the previous step; otherwise the pending sequence is cleared. This timeout is intentionally conservative and can be changed in future releases or exposed per-shortcut if needed.
+- Steps are order-sensitive. `steps: [['ctrl','k'], ['s']]` is different from `steps: [['s'], ['ctrl','k']]`.
+- Existing single-step `keys` / `macKeys` remain supported and continue to work as before.
+
+
 Use the `activate()` and `deactivate()` methods for dynamic control after registration:
 
 ```typescript
@@ -136,8 +224,14 @@ interface KeyboardShortcutUI {
 ```typescript
 interface KeyboardShortcut {
   id: string;           // Unique identifier
-  keys: string[];       // Key combination for PC/Linux (e.g., ['ctrl', 's'])
-  macKeys: string[];    // Key combination for Mac (e.g., ['meta', 's'])
+  // Single-step combinations (existing API)
+  keys?: string[];       // Key combination for PC/Linux (e.g., ['ctrl', 's'])
+  macKeys?: string[];    // Key combination for Mac (e.g., ['meta', 's'])
+
+  // Multi-step sequences (new)
+  // Each step is an array of keys pressed together. Example: steps: [['ctrl','k'], ['s']]
+  steps?: string[][];
+  macSteps?: string[][];
   action: () => void;   // Function to execute
   description: string;  // Human-readable description
 }
@@ -157,21 +251,21 @@ interface KeyboardShortcutGroup {
 
 ### Modifier Keys
 
-| PC/Linux | Mac | Description |
-|----------|-----|-------------|
-| `ctrl` | `meta` | Control/Command key |
-| `alt` | `alt` | Alt/Option key |
-| `shift` | `shift` | Shift key |
+| PC/Linux | Mac     | Description         |
+| -------- | ------- | ------------------- |
+| `ctrl`   | `meta`  | Control/Command key |
+| `alt`    | `alt`   | Alt/Option key      |
+| `shift`  | `shift` | Shift key           |
 
 ### Special Keys
 
-| Key | Value |
-|-----|-------|
-| Function keys | `f1`, `f2`, `f3`, ... `f12` |
-| Arrow keys | `arrowup`, `arrowdown`, `arrowleft`, `arrowright` |
-| Navigation | `home`, `end`, `pageup`, `pagedown` |
-| Editing | `insert`, `delete`, `backspace` |
-| Other | `escape`, `tab`, `enter`, `space` |
+| Key           | Value                                             |
+| ------------- | ------------------------------------------------- |
+| Function keys | `f1`, `f2`, `f3`, ... `f12`                       |
+| Arrow keys    | `arrowup`, `arrowdown`, `arrowleft`, `arrowright` |
+| Navigation    | `home`, `end`, `pageup`, `pagedown`               |
+| Editing       | `insert`, `delete`, `backspace`                   |
+| Other         | `escape`, `tab`, `enter`, `space`                 |
 
 ## Browser Conflicts Warning
 
@@ -187,18 +281,19 @@ interface KeyboardShortcutGroup {
 - `Ctrl+D` / `⌘+D` - Bookmark page
 
 ### Safer Alternatives
+> [!TIP]
+> Always test your shortcuts across different browsers and operating systems. Consider providing alternative key combinations or allow users to customize shortcuts.
 - Function keys: `F1`, `F2`, `F3`, etc.
 - Custom combinations: `Ctrl+Shift+S`, `Alt+Enter`
 - Arrow keys with modifiers: `Ctrl+ArrowUp`
 - Application-specific: `Ctrl+K`, `Ctrl+P` (if not conflicting)
 
-### Testing Browser Conflicts
-
-> [!TIP]
-> Always test your shortcuts across different browsers and operating systems. Consider providing alternative key combinations or allow users to customize shortcuts.
 
 ## Advanced Usage
 
+> [!TIP]
+Check out our [demo application](/projects/demo/src/app) for full implementations of all patterns shown below.
+
 ### Reactive UI Integration
 
 ```typescript
@@ -239,6 +334,9 @@ export class ShortcutsDisplayComponent {
 ```
 ### Group Management
 
+> [!NOTE]
+> **Live Example**: See this pattern in action in [feature.component.ts](/projects/demo/src/app/feature/feature.component.ts)
+
 ```typescript
 import { Component, DestroyRef, inject } from '@angular/core';
 import { KeyboardShortcuts, KeyboardShortcut } from 'ngx-keys';
@@ -287,9 +385,65 @@ export class FeatureComponent {
 }
 ```
 
+### Automatic unregistering
+
+`register` and `registerGroup` have the optional parameter: `activeUntil`. 
+The `activeUntil` parameter allows you to connect the shortcut to the wrappers lifecycle or logic in general.  
+
+`activeUntil` supports three types:
+- `'destruct'`: the shortcut injects the parents `DestroyRef` and unregisters once the component destructs
+- `DestroyRef`: DestroyRef which should trigger the destruction of the shortcut
+- `Observable<unknown>`: an Observable which will unregister the shortcut when triggered
+
+#### Example: `'destruct'`
+Shortcuts defined by this component will only be listening during the lifecycle of the component.
+Shortcuts are registered on construction and are automatically unregistered on destruction.
+
+```typescript
+export class Component {
+  constructor() {
+    const keyboardService = inject(KeyboardShortcuts)
+
+    keyboardService.register({
+      // ...
+      activeUntil: 'destruct', // alternatively: inject(DestroyRef)
+    });
+
+    keyboardService.registerGroup(
+      'shortcuts',
+      [/* ... */],
+      'destruct', // alternatively: inject(DestroyRef)
+    );
+  }
+}
+```
+
+#### Example: `Observable`
+
+```typescript
+const shortcutTTL = new Subject<void>();
+
+keyboardService.register({
+  // ...
+  activeUntil: shortcutTTL,
+});
+
+keyboardService.registerGroup(
+  'shortcuts',
+  [/* ... */], 
+  shortcutTTL,
+);
+
+// Shortcuts are listening...
+
+shortcutTTL.next();
+
+// Shortcuts are unregistered
+```
+
 ### Batch Operations
 
-For better performance when making multiple changes, use the `batchUpdate` method:
+For better performance when making multiple changes, use the `batchUpdate` method.
 
 ```typescript
 import { Component, inject } from '@angular/core';
@@ -331,6 +485,9 @@ export class BatchUpdateComponent {
 
 ### Checking Status
 
+> [!NOTE]
+> See status checking in [home.component.ts](/projects/demo/src/app/home/home.component.ts)
+
 ```typescript
 import { Component, inject } from '@angular/core';
 import { KeyboardShortcuts } from 'ngx-keys';
@@ -351,6 +508,25 @@ export class MyComponent {
 }
 ```
 
+### Chords (multiple non-modifier keys)
+
+- ngx-keys supports chords composed of multiple non-modifier keys pressed simultaneously (for example `C + A`).
+- When multiple non-modifier keys are physically held down at the same time, the service uses the set of currently pressed keys plus any modifier flags to match registered shortcuts.
+- Example: register a chord with `keys: ['c','a']` and pressing and holding `c` then pressing `a` will trigger the shortcut.
+- Note: Browsers deliver separate keydown events for each physical key; the library maintains a Set of currently-down keys via `keydown`/`keyup` listeners to enable chords. This approach attempts to be robust but can be affected by browser focus changes — ensure tests in your target browsers.
+
+Example registration:
+
+```typescript
+this.keyboardService.register({
+  id: 'chord-ca',
+  keys: ['c', 'a'],
+  macKeys: ['c', 'a'],
+  action: () => console.log('Chord C+A executed'),
+  description: 'Demo chord'
+});
+```
+
 ## Building
 
 To build the library:

package/fesm2022/ngx-keys.mjs

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
-import { signal, computed, inject, PLATFORM_ID, Injectable } from '@angular/core';
+import { signal, computed, inject, PLATFORM_ID, DestroyRef, Injectable } from '@angular/core';
 import { isPlatformBrowser } from '@angular/common';
+import { Observable, take } from 'rxjs';
 
 /**
  * Centralized error messages for keyboard shortcuts service
@@ -92,6 +93,7 @@ class KeyboardShortcuts {
     groups = new Map();
     activeShortcuts = new Set();
     activeGroups = new Set();
+    currentlyDownKeys = new Set();
     // Single consolidated state signal - reduces memory overhead
     state = signal({
         shortcuts: new Map(),
@@ -129,8 +131,15 @@ class KeyboardShortcuts {
         };
     }, ...(ngDevMode ? [{ debugName: "shortcutsUI$" }] : []));
     keydownListener = this.handleKeydown.bind(this);
+    keyupListener = this.handleKeyup.bind(this);
+    blurListener = this.handleWindowBlur.bind(this);
+    visibilityListener = this.handleVisibilityChange.bind(this);
     isListening = false;
     isBrowser;
+    /** Default timeout (ms) for completing a multi-step sequence */
+    sequenceTimeout = 2000;
+    /** Runtime state for multi-step sequences */
+    pendingSequence = null;
     constructor() {
         // Use try-catch to handle injection context for better testability
         try {
@@ -166,8 +175,8 @@ class KeyboardShortcuts {
     formatShortcutForUI(shortcut) {
         return {
             id: shortcut.id,
-            keys: this.formatKeysForDisplay(shortcut.keys, false),
-            macKeys: this.formatKeysForDisplay(shortcut.macKeys, true),
+            keys: this.formatStepsForDisplay(shortcut.keys ?? shortcut.steps ?? [], false),
+            macKeys: this.formatStepsForDisplay(shortcut.macKeys ?? shortcut.macSteps ?? [], true),
             description: shortcut.description
         };
     }
@@ -199,16 +208,45 @@ class KeyboardShortcuts {
             .map(key => keyMap[key.toLowerCase()] || key.toUpperCase())
             .join('+');
     }
+    formatStepsForDisplay(steps, isMac = false) {
+        if (!steps)
+            return '';
+        // If the first element is an array, assume steps is string[][]
+        const normalized = this.normalizeToSteps(steps);
+        if (normalized.length === 0)
+            return '';
+        if (normalized.length === 1)
+            return this.formatKeysForDisplay(normalized[0], isMac);
+        return normalized.map(step => this.formatKeysForDisplay(step, isMac)).join(', ');
+    }
+    normalizeToSteps(input) {
+        if (!input)
+            return [];
+        // If first element is an array, assume already KeyStep[]
+        if (Array.isArray(input[0])) {
+            return input;
+        }
+        // Single step array
+        return [input];
+    }
     /**
      * Check if a key combination is already registered
      * @returns The ID of the conflicting shortcut, or null if no conflict
      */
     findConflict(newShortcut) {
         for (const existing of this.shortcuts.values()) {
-            if (this.keysMatch(newShortcut.keys, existing.keys)) {
+            // Compare single-step shapes if provided
+            if (newShortcut.keys && existing.keys && this.keysMatch(newShortcut.keys, existing.keys)) {
                 return existing.id;
             }
-            if (this.keysMatch(newShortcut.macKeys, existing.macKeys)) {
+            if (newShortcut.macKeys && existing.macKeys && this.keysMatch(newShortcut.macKeys, existing.macKeys)) {
+                return existing.id;
+            }
+            // Compare multi-step shapes
+            if (newShortcut.steps && existing.steps && this.stepsMatch(newShortcut.steps, existing.steps)) {
+                return existing.id;
+            }
+            if (newShortcut.macSteps && existing.macSteps && this.stepsMatch(newShortcut.macSteps, existing.macSteps)) {
                 return existing.id;
             }
         }
@@ -229,12 +267,13 @@ class KeyboardShortcuts {
         this.shortcuts.set(shortcut.id, shortcut);
         this.activeShortcuts.add(shortcut.id);
         this.updateState();
+        this.setupActiveUntil(shortcut.activeUntil, this.unregister.bind(this, shortcut.id));
     }
     /**
      * Register multiple keyboard shortcuts as a group
      * @throws KeyboardShortcutError if group ID is already registered or if any shortcut ID or key combination conflicts
      */
-    registerGroup(groupId, shortcuts) {
+    registerGroup(groupId, shortcuts, activeUntil) {
         // Check if group ID already exists
         if (this.groups.has(groupId)) {
             throw KeyboardShortcutsErrorFactory.groupAlreadyRegistered(groupId);
@@ -286,6 +325,7 @@ class KeyboardShortcuts {
                 this.activeShortcuts.add(shortcut.id);
             });
         });
+        this.setupActiveUntil(activeUntil, this.unregisterGroup.bind(this, groupId));
     }
     /**
      * Unregister a single keyboard shortcut
@@ -413,7 +453,15 @@ class KeyboardShortcuts {
         if (!this.isBrowser || this.isListening) {
             return;
         }
+        // Listen to both keydown and keyup so we can maintain a Set of currently
+        // pressed physical keys. We avoid passive:true because we may call
+        // preventDefault() when matching shortcuts.
         document.addEventListener('keydown', this.keydownListener, { passive: false });
+        document.addEventListener('keyup', this.keyupListener, { passive: false });
+        // Listen for blur/visibility changes so we can clear the currently-down keys
+        // and avoid stale state when the browser or tab loses focus.
+        window.addEventListener('blur', this.blurListener);
+        document.addEventListener('visibilitychange', this.visibilityListener);
         this.isListening = true;
     }
     stopListening() {
@@ -421,29 +469,208 @@ class KeyboardShortcuts {
             return;
         }
         document.removeEventListener('keydown', this.keydownListener);
+        document.removeEventListener('keyup', this.keyupListener);
+        window.removeEventListener('blur', this.blurListener);
+        document.removeEventListener('visibilitychange', this.visibilityListener);
         this.isListening = false;
     }
     handleKeydown(event) {
-        const pressedKeys = this.getPressedKeys(event);
+        // Update the currently down keys with this event's key
+        this.updateCurrentlyDownKeysOnKeydown(event);
+        // Build the pressed keys set used for matching. Prefer the currentlyDownKeys
+        // if it contains more than one non-modifier key; otherwise fall back to the
+        // traditional per-event pressed keys calculation for compatibility.
+        // Use a Set for matching to avoid allocations and sorting on every event
+        const pressedKeys = this.buildPressedKeysForMatch(event);
         const isMac = this.isMacPlatform();
+        // If there is a pending multi-step sequence, try to advance it first
+        if (this.pendingSequence) {
+            const pending = this.pendingSequence;
+            const shortcut = this.shortcuts.get(pending.shortcutId);
+            if (shortcut) {
+                const steps = isMac
+                    ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])
+                    : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);
+                const normalizedSteps = this.normalizeToSteps(steps);
+                const expected = normalizedSteps[pending.stepIndex];
+                // Use per-event pressed keys for advancing sequence steps. Relying on
+                // the accumulated `currentlyDownKeys` can accidentally include keys
+                // from previous steps (if tests or callers don't emit keyup), which
+                // would prevent matching a simple single-key step like ['s'] after
+                // a prior ['k'] step. Use getPressedKeys(event) which reflects the
+                // actual modifier/main-key state for this event.
+                const stepPressed = this.getPressedKeys(event);
+                if (expected && this.keysMatch(stepPressed, expected)) {
+                    // Advance sequence
+                    clearTimeout(pending.timerId);
+                    pending.stepIndex += 1;
+                    if (pending.stepIndex >= normalizedSteps.length) {
+                        // Completed
+                        event.preventDefault();
+                        event.stopPropagation();
+                        try {
+                            shortcut.action();
+                        }
+                        catch (error) {
+                            console.error(`Error executing keyboard shortcut "${shortcut.id}":`, error);
+                        }
+                        this.pendingSequence = null;
+                        return;
+                    }
+                    // Reset timer for next step
+                    pending.timerId = setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout);
+                    return;
+                }
+                else {
+                    // Cancel pending if doesn't match
+                    this.clearPendingSequence();
+                }
+            }
+            else {
+                // pending exists but shortcut not found
+                this.clearPendingSequence();
+            }
+        }
+        // No pending sequence - check active shortcuts for a match or sequence start
         for (const shortcutId of this.activeShortcuts) {
             const shortcut = this.shortcuts.get(shortcutId);
             if (!shortcut)
                 continue;
-            const targetKeys = isMac ? shortcut.macKeys : shortcut.keys;
-            if (this.keysMatch(pressedKeys, targetKeys)) {
-                event.preventDefault();
-                event.stopPropagation();
-                try {
-                    shortcut.action();
+            const steps = isMac
+                ? (shortcut.macSteps ?? shortcut.macKeys ?? shortcut.steps ?? shortcut.keys ?? [])
+                : (shortcut.steps ?? shortcut.keys ?? shortcut.macSteps ?? shortcut.macKeys ?? []);
+            const normalizedSteps = this.normalizeToSteps(steps);
+            const firstStep = normalizedSteps[0];
+            if (this.keysMatch(pressedKeys, firstStep)) {
+                if (normalizedSteps.length === 1) {
+                    // single-step
+                    event.preventDefault();
+                    event.stopPropagation();
+                    try {
+                        shortcut.action();
+                    }
+                    catch (error) {
+                        console.error(`Error executing keyboard shortcut "${shortcut.id}":`, error);
+                    }
+                    break;
                 }
-                catch (error) {
-                    console.error(`Error executing keyboard shortcut "${shortcut.id}":`, error);
+                else {
+                    // start pending sequence
+                    if (this.pendingSequence) {
+                        this.clearPendingSequence();
+                    }
+                    this.pendingSequence = {
+                        shortcutId: shortcut.id,
+                        stepIndex: 1,
+                        timerId: setTimeout(() => { this.pendingSequence = null; }, this.sequenceTimeout)
+                    };
+                    event.preventDefault();
+                    event.stopPropagation();
+                    return;
                 }
-                break; // Only execute the first matching shortcut
             }
         }
     }
+    handleKeyup(event) {
+        // Remove the key from currentlyDownKeys on keyup
+        const key = event.key ? event.key.toLowerCase() : '';
+        if (key && !['control', 'alt', 'shift', 'meta'].includes(key)) {
+            this.currentlyDownKeys.delete(key);
+        }
+    }
+    /**
+     * Clear the currently-down keys. Exposed for testing and for use by
+     * blur/visibilitychange handlers to avoid stale state when the page loses focus.
+     */
+    clearCurrentlyDownKeys() {
+        this.currentlyDownKeys.clear();
+    }
+    handleWindowBlur() {
+        this.clearCurrentlyDownKeys();
+        // Clear any pressed keys and any pending multi-step sequence to avoid
+        // stale state when the window loses focus.
+        this.clearPendingSequence();
+    }
+    handleVisibilityChange() {
+        if (document.visibilityState === 'hidden') {
+            // When the document becomes hidden, clear both pressed keys and any
+            // pending multi-step sequence. This prevents sequences from remaining
+            // active when the user switches tabs or minimizes the window.
+            this.clearCurrentlyDownKeys();
+            this.clearPendingSequence();
+        }
+    }
+    /**
+     * Update the currentlyDownKeys set when keydown events happen.
+     * Normalizes common keys (function keys, space, etc.) to the same values
+     * used by getPressedKeys/keysMatch.
+     */
+    updateCurrentlyDownKeysOnKeydown(event) {
+        const key = event.key ? event.key.toLowerCase() : '';
+        // Ignore modifier-only keydown entries
+        if (['control', 'alt', 'shift', 'meta'].includes(key)) {
+            return;
+        }
+        // Normalize some special cases similar to the demo component's recording logic
+        if (event.code && event.code.startsWith('F') && /^F\d+$/.test(event.code)) {
+            this.currentlyDownKeys.add(event.code.toLowerCase());
+            return;
+        }
+        if (key === ' ') {
+            this.currentlyDownKeys.add('space');
+            return;
+        }
+        if (key === 'escape') {
+            this.currentlyDownKeys.add('escape');
+            return;
+        }
+        if (key === 'enter') {
+            this.currentlyDownKeys.add('enter');
+            return;
+        }
+        if (key && key.length > 0) {
+            this.currentlyDownKeys.add(key);
+        }
+    }
+    /**
+     * 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).
+     * Otherwise fall back to single main-key detection from the event for compatibility.
+     *
+     * Returns a Set<string> (lowercased) to allow O(1) lookups and O(n) comparisons
+     * without sorting or allocating sorted arrays on every event.
+     */
+    buildPressedKeysForMatch(event) {
+        const modifiers = new Set();
+        if (event.ctrlKey)
+            modifiers.add('ctrl');
+        if (event.altKey)
+            modifiers.add('alt');
+        if (event.shiftKey)
+            modifiers.add('shift');
+        if (event.metaKey)
+            modifiers.add('meta');
+        // Collect non-modifier keys from currentlyDownKeys (excluding modifiers)
+        const nonModifierKeys = Array.from(this.currentlyDownKeys).filter(k => !['control', 'alt', 'shift', 'meta'].includes(k));
+        const result = new Set();
+        // Add modifiers first
+        modifiers.forEach(m => result.add(m));
+        if (nonModifierKeys.length > 0) {
+            nonModifierKeys.forEach(k => result.add(k.toLowerCase()));
+            return result;
+        }
+        // Fallback: single main key from the event (existing behavior)
+        const key = event.key.toLowerCase();
+        if (!['control', 'alt', 'shift', 'meta'].includes(key)) {
+            result.add(key);
+        }
+        return result;
+    }
     getPressedKeys(event) {
         const keys = [];
         if (event.ctrlKey)
@@ -461,18 +688,69 @@ class KeyboardShortcuts {
         }
         return keys;
     }
+    /**
+     * Compare pressed keys against a target key combination.
+     * Accepts either a Set<string> (preferred) or an array for backwards compatibility.
+     * Uses Set-based comparison: sizes must match and every element in target must exist in pressed.
+     */
     keysMatch(pressedKeys, targetKeys) {
-        if (pressedKeys.length !== targetKeys.length) {
+        // Normalize targetKeys into a Set<string> (lowercased)
+        const normalizedTarget = new Set(targetKeys.map(k => k.toLowerCase()));
+        // Normalize pressedKeys into a Set<string> if it's an array
+        const pressedSet = Array.isArray(pressedKeys)
+            ? new Set(pressedKeys.map(k => k.toLowerCase()))
+            : new Set(Array.from(pressedKeys).map(k => k.toLowerCase()));
+        if (pressedSet.size !== normalizedTarget.size) {
+            return false;
+        }
+        // Check if every element in normalizedTarget exists in pressedSet
+        for (const key of normalizedTarget) {
+            if (!pressedSet.has(key)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /** Compare two multi-step sequences for equality */
+    stepsMatch(a, b) {
+        if (a.length !== b.length)
             return false;
+        for (let i = 0; i < a.length; i++) {
+            if (!this.keysMatch(a[i], b[i]))
+                return false;
+        }
+        return true;
+    }
+    /** Safely clear any pending multi-step sequence */
+    clearPendingSequence() {
+        if (!this.pendingSequence)
+            return;
+        try {
+            clearTimeout(this.pendingSequence.timerId);
         }
-        // Normalize and sort both arrays for comparison
-        const normalizedPressed = pressedKeys.map(key => key.toLowerCase()).sort();
-        const normalizedTarget = targetKeys.map(key => key.toLowerCase()).sort();
-        return normalizedPressed.every((key, index) => key === normalizedTarget[index]);
+        catch { /* ignore */ }
+        this.pendingSequence = null;
     }
     isMacPlatform() {
         return this.isBrowser && /Mac|iPod|iPhone|iPad/.test(navigator.platform);
     }
+    setupActiveUntil(activeUntil, unregister) {
+        if (!activeUntil) {
+            return;
+        }
+        if (activeUntil === 'destruct') {
+            inject(DestroyRef).onDestroy(unregister);
+            return;
+        }
+        if (activeUntil instanceof DestroyRef) {
+            activeUntil.onDestroy(unregister);
+            return;
+        }
+        if (activeUntil instanceof Observable) {
+            activeUntil.pipe(take(1)).subscribe(unregister);
+            return;
+        }
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: KeyboardShortcuts, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: KeyboardShortcuts, providedIn: 'root' });
 }

package/fesm2022/ngx-keys.mjs.map

@@ -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 { Injectable, OnDestroy, PLATFORM_ID, inject, signal, computed } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport { KeyboardShortcut, KeyboardShortcutGroup, KeyboardShortcutUI } from './keyboard-shortcut.interface';\nimport { KeyboardShortcutsErrorFactory } from './keyboard-shortcuts.errors';\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  \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 isListening = false;\n  protected isBrowser: boolean;\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.formatKeysForDisplay(shortcut.keys, false),\n      macKeys: this.formatKeysForDisplay(shortcut.macKeys, 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  /**\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      if (this.keysMatch(newShortcut.keys, existing.keys)) {\n        return existing.id;\n      }\n      if (this.keysMatch(newShortcut.macKeys, existing.macKeys)) {\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\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[]): 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\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    document.addEventListener('keydown', this.keydownListener, { passive: false });\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    this.isListening = false;\n  }\n\n  protected handleKeydown(event: KeyboardEvent): void {\n    const pressedKeys = this.getPressedKeys(event);\n    const isMac = this.isMacPlatform();\n    \n    for (const shortcutId of this.activeShortcuts) {\n      const shortcut = this.shortcuts.get(shortcutId);\n      if (!shortcut) continue;\n      \n      const targetKeys = isMac ? shortcut.macKeys : shortcut.keys;\n      \n      if (this.keysMatch(pressedKeys, targetKeys)) {\n        event.preventDefault();\n        event.stopPropagation();\n        \n        try {\n          shortcut.action();\n        } catch (error) {\n          console.error(`Error executing keyboard shortcut \"${shortcut.id}\":`, error);\n        }\n        \n        break; // Only execute the first matching shortcut\n      }\n    }\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  protected keysMatch(pressedKeys: string[], targetKeys: string[]): boolean {\n    if (pressedKeys.length !== targetKeys.length) {\n      return false;\n    }\n    \n    // Normalize and sort both arrays for comparison\n    const normalizedPressed = pressedKeys.map(key => key.toLowerCase()).sort();\n    const normalizedTarget = targetKeys.map(key => key.toLowerCase()).sort();\n    \n    return normalizedPressed.every((key, index) => key === normalizedTarget[index]);\n  }\n\n  protected isMacPlatform(): boolean {\n    return this.isBrowser && /Mac|iPod|iPhone|iPad/.test(navigator.platform);\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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"}
+{"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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"}

package/index.d.ts

@@ -1,12 +1,22 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy } from '@angular/core';
+import { DestroyRef, OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
 
+type KeyboardShortcutActiveUntil = Observable<unknown> | DestroyRef | 'destruct';
+type KeyStep = string[];
 interface KeyboardShortcut {
     id: string;
-    keys: string[];
-    macKeys: string[];
+    /**
+     * 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.
+     */
+    keys?: string[];
+    macKeys?: string[];
+    steps?: KeyStep[];
+    macSteps?: KeyStep[];
     action: () => void;
     description: string;
+    activeUntil?: KeyboardShortcutActiveUntil;
 }
 interface KeyboardShortcutGroup {
     id: string;
@@ -28,6 +38,7 @@ declare class KeyboardShortcuts implements OnDestroy {
     private readonly groups;
     private readonly activeShortcuts;
     private readonly activeGroups;
+    private readonly currentlyDownKeys;
     private readonly state;
     readonly shortcuts$: _angular_core.Signal<{
         active: KeyboardShortcut[];
@@ -44,8 +55,15 @@ declare class KeyboardShortcuts implements OnDestroy {
         all: KeyboardShortcutUI[];
     }>;
     private readonly keydownListener;
+    private readonly keyupListener;
+    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 */
+    private pendingSequence;
     constructor();
     ngOnDestroy(): void;
     /**
@@ -64,6 +82,8 @@ declare class KeyboardShortcuts implements OnDestroy {
      * Format keys for display with proper Unicode symbols
      */
     private formatKeysForDisplay;
+    private formatStepsForDisplay;
+    private normalizeToSteps;
     /**
      * Check if a key combination is already registered
      * @returns The ID of the conflicting shortcut, or null if no conflict
@@ -78,7 +98,7 @@ declare class KeyboardShortcuts implements OnDestroy {
      * Register multiple keyboard shortcuts as a group
      * @throws KeyboardShortcutError if group ID is already registered or if any shortcut ID or key combination conflicts
      */
-    registerGroup(groupId: string, shortcuts: KeyboardShortcut[]): void;
+    registerGroup(groupId: string, shortcuts: KeyboardShortcut[], activeUntil?: KeyboardShortcutActiveUntil): void;
     /**
      * Unregister a single keyboard shortcut
      * @throws KeyboardShortcutError if shortcut ID doesn't exist
@@ -136,9 +156,47 @@ declare class KeyboardShortcuts implements OnDestroy {
     private startListening;
     private stopListening;
     protected handleKeydown(event: KeyboardEvent): void;
+    protected handleKeyup(event: KeyboardEvent): void;
+    /**
+     * Clear the currently-down keys. Exposed for testing and for use by
+     * blur/visibilitychange handlers to avoid stale state when the page loses focus.
+     */
+    clearCurrentlyDownKeys(): void;
+    protected handleWindowBlur(): void;
+    protected handleVisibilityChange(): void;
+    /**
+     * Update the currentlyDownKeys set when keydown events happen.
+     * Normalizes common keys (function keys, space, etc.) to the same values
+     * 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).
+     * Otherwise fall back to single main-key detection from the event for compatibility.
+     *
+     * Returns a Set<string> (lowercased) to allow O(1) lookups and O(n) comparisons
+     * without sorting or allocating sorted arrays on every event.
+     */
+    protected buildPressedKeysForMatch(event: KeyboardEvent): Set<string>;
     protected getPressedKeys(event: KeyboardEvent): string[];
-    protected keysMatch(pressedKeys: string[], targetKeys: string[]): boolean;
+    /**
+     * Compare pressed keys against a target key combination.
+     * Accepts either a Set<string> (preferred) or an array for backwards compatibility.
+     * Uses Set-based comparison: sizes must match and every element in target must exist in pressed.
+     */
+    protected keysMatch(pressedKeys: Set<string> | string[], targetKeys: string[]): boolean;
+    /** Compare two multi-step sequences for equality */
+    protected stepsMatch(a: string[][], b: string[][]): boolean;
+    /** Safely clear any pending multi-step sequence */
+    private clearPendingSequence;
     protected isMacPlatform(): boolean;
+    protected setupActiveUntil(activeUntil: KeyboardShortcutActiveUntil | undefined, unregister: () => void): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KeyboardShortcuts, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<KeyboardShortcuts>;
 }
@@ -196,4 +254,4 @@ declare class KeyboardShortcutsErrorFactory {
 }
 
 export { KeyboardShortcutError, KeyboardShortcuts, KeyboardShortcutsErrorFactory, KeyboardShortcutsErrors };
-export type { KeyboardShortcut, KeyboardShortcutGroup, KeyboardShortcutUI, KeyboardShortcutsErrorType };
+export type { KeyStep, KeyboardShortcut, KeyboardShortcutActiveUntil, KeyboardShortcutGroup, KeyboardShortcutUI, KeyboardShortcutsErrorType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-keys",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A reactive Angular library for managing keyboard shortcuts with signals-based UI integration",
   "keywords": [
     "angular",
@@ -18,7 +18,7 @@
   "author": "NgxKeys Contributors",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mrivasperez/ngx-keys.git"
+    "url": "https://github.com/mrivasperez/ngx-keys.git"
   },
   "bugs": {
     "url": "https://github.com/mrivasperez/ngx-keys/issues"
@@ -43,4 +43,4 @@
       "default": "./fesm2022/ngx-keys.mjs"
     }
   }
-}
+}