ngx-keys 1.0.0

package/README.md

@@ -0,0 +1,382 @@
+# ngx-keys
+
+A lightweight, reactive Angular service for managing keyboard shortcuts with signals-based UI integration.
+
+## Features
+
+- **🎯 Service-Focused**: Clean, focused API without unnecessary UI components
+- **⚡ Reactive Signals**: Track active/inactive shortcuts with Angular signals
+- **🔧 UI-Agnostic**: Build your own UI using the provided reactive signals
+- **🌍 Cross-Platform**: Automatic Mac/PC key display formatting
+- **🔄 Dynamic Management**: Add, remove, activate/deactivate shortcuts at runtime
+- **📁 Group Management**: Organize shortcuts into logical groups
+- **🪶 Lightweight**: Zero dependencies, minimal bundle impact
+
+## Installation
+
+```bash
+npm install ngx-keys
+```
+
+## Quick Start
+### Displaying Shortcuts
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { KeyboardShortcuts } from 'ngx-keys';
+
+@Component({
+  template: `
+    @for (shortcut of activeShortcuts(); track shortcut.id) {
+      <div>
+        <kbd>{{ shortcut.keys }}</kbd> - {{ shortcut.description }}
+      </div>
+    }
+  `
+})
+export class ShortcutsComponent {
+  private readonly keyboardService = inject(KeyboardShortcuts);
+  protected readonly activeShortcuts = () => this.keyboardService.shortcutsUI$().active;
+}
+```
+## Key Concepts
+
+### Automatic Activation
+
+> [!IMPORTANT]
+> When you register shortcuts using `register()` or `registerGroup()`, they are **automatically activated** and ready to use immediately. You don't need to call `activate()` unless you've previously deactivated them.
+
+```typescript
+// This shortcut is immediately active after registration
+this.keyboardService.register({
+  id: 'save',
+  keys: ['ctrl', 's'],
+  macKeys: ['meta', 's'],
+  action: () => this.save(),
+  description: 'Save document'
+});
+```
+
+Use the `activate()` and `deactivate()` methods for dynamic control after registration:
+
+```typescript
+// Temporarily disable a shortcut
+this.keyboardService.deactivate('save');
+
+// Re-enable it later
+this.keyboardService.activate('save');
+```
+
+## API Reference
+
+### KeyboardShortcuts Service
+
+#### Methods
+
+**Registration Methods:**
+- `register(shortcut: KeyboardShortcut)` - Register and automatically activate a single shortcut *Throws error on conflicts*
+- `registerGroup(groupId: string, shortcuts: KeyboardShortcut[])` - Register and automatically activate a group of shortcuts *Throws error on conflicts*
+
+**Management Methods:**
+- `unregister(shortcutId: string)` - Remove a shortcut *Throws error if not found*
+- `unregisterGroup(groupId: string)` - Remove a group *Throws error if not found*
+- `activate(shortcutId: string)` - Activate a shortcut *Throws error if not registered*
+- `deactivate(shortcutId: string)` - Deactivate a shortcut *Throws error if not registered*
+- `activateGroup(groupId: string)` - Activate all shortcuts in a group *Throws error if not found*
+- `deactivateGroup(groupId: string)` - Deactivate all shortcuts in a group *Throws error if not found*
+
+**Query Methods:**
+- `isActive(shortcutId: string): boolean` - Check if a shortcut is active
+- `isRegistered(shortcutId: string): boolean` - Check if a shortcut is registered
+- `isGroupActive(groupId: string): boolean` - Check if a group is active
+- `isGroupRegistered(groupId: string): boolean` - Check if a group is registered
+- `getShortcuts(): ReadonlyMap<string, KeyboardShortcut>` - Get all registered shortcuts
+- `getGroups(): ReadonlyMap<string, KeyboardShortcutGroup>` - Get all registered groups
+
+**Utility Methods:**
+- `formatShortcutForUI(shortcut: KeyboardShortcut): KeyboardShortcutUI` - Format a shortcut for display
+- `batchUpdate(operations: () => void): void` - Batch multiple operations to reduce signal updates
+
+#### Reactive Signals
+
+The service provides reactive signals for UI integration:
+
+```typescript
+// Primary signal containing all shortcut state
+shortcuts$: Signal<{
+  active: KeyboardShortcut[];
+  inactive: KeyboardShortcut[];
+  all: KeyboardShortcut[];
+  groups: {
+    active: string[];
+    inactive: string[];
+  };
+}>
+
+// Pre-formatted UI signal for easy display
+shortcutsUI$: Signal<{
+  active: ShortcutUI[];
+  inactive: ShortcutUI[];
+  all: ShortcutUI[];
+}>
+```
+
+**ShortcutUI Interface:**
+```typescript
+interface KeyboardShortcutUI {
+  id: string;           // Shortcut identifier
+  keys: string;         // Formatted PC/Linux keys (e.g., "Ctrl+S")
+  macKeys: string;      // Formatted Mac keys (e.g., "⌘+S")
+  description: string;  // Human-readable description
+}
+```
+
+### KeyboardShortcut Interface
+
+```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'])
+  action: () => void;   // Function to execute
+  description: string;  // Human-readable description
+}
+```
+
+### KeyboardShortcutGroup Interface
+
+```typescript
+interface KeyboardShortcutGroup {
+  id: string;                     // Unique group identifier
+  shortcuts: KeyboardShortcut[];  // Array of shortcuts in this group
+  active: boolean;                // Whether the group is currently active
+}
+```
+
+## Key Mapping Reference
+
+### Modifier Keys
+
+| 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` |
+
+## Browser Conflicts Warning
+
+> [!WARNING]
+> Some key combinations conflict with browser defaults. Use these with caution:
+
+### High-Risk Combinations (avoid these)
+- `Ctrl+N` / `⌘+N` - New tab/window
+- `Ctrl+T` / `⌘+T` - New tab
+- `Ctrl+W` / `⌘+W` - Close tab
+- `Ctrl+R` / `⌘+R` - Reload page
+- `Ctrl+L` / `⌘+L` - Focus address bar
+- `Ctrl+D` / `⌘+D` - Bookmark page
+
+### Safer Alternatives
+- 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
+
+### Reactive UI Integration
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { KeyboardShortcuts } from 'ngx-keys';
+
+@Component({
+  template: `
+    <section>
+      <h3>Active Shortcuts ({{ activeShortcuts().length }})</h3>
+      @for (shortcut of activeShortcuts(); track shortcut.id) {
+        <div>
+          <kbd>{{ shortcut.keys }}</kbd> - {{ shortcut.description }}
+        </div>
+      }
+    </section>
+
+    <section>
+      <h3>Active Groups</h3>
+      @for (groupId of activeGroups(); track groupId) {
+        <div>{{ groupId }}</div>
+      }
+    </section>
+  `
+})
+export class ShortcutsDisplayComponent {
+  private readonly keyboardService = inject(KeyboardShortcuts);
+  
+  // Access formatted shortcuts for display
+  protected readonly activeShortcuts = () => this.keyboardService.shortcutsUI$().active;
+  protected readonly inactiveShortcuts = () => this.keyboardService.shortcutsUI$().inactive;
+  protected readonly allShortcuts = () => this.keyboardService.shortcutsUI$().all;
+  
+  // Access group information
+  protected readonly activeGroups = () => this.keyboardService.shortcuts$().groups.active;
+  protected readonly inactiveGroups = () => this.keyboardService.shortcuts$().groups.inactive;
+}
+```
+### Group Management
+
+```typescript
+import { Component, DestroyRef, inject } from '@angular/core';
+import { KeyboardShortcuts, KeyboardShortcut } from 'ngx-keys';
+
+export class FeatureComponent {
+  private readonly keyboardService = inject(KeyboardShortcuts);
+  private readonly destroyRef = inject(DestroyRef);
+
+  constructor() {
+    const shortcuts: KeyboardShortcut[] = [
+      {
+        id: 'cut',
+        keys: ['ctrl', 'x'],
+        macKeys: ['meta', 'x'],
+        action: () => this.cut(),
+        description: 'Cut selection'
+      },
+      {
+        id: 'copy',
+        keys: ['ctrl', 'c'],
+        macKeys: ['meta', 'c'],
+        action: () => this.copy(),
+        description: 'Copy selection'
+      }
+    ];
+
+    // Group is automatically activated when registered
+    this.keyboardService.registerGroup('edit-shortcuts', shortcuts);
+
+    // Setup cleanup on destroy
+    this.destroyRef.onDestroy(() => {
+      this.keyboardService.unregisterGroup('edit-shortcuts');
+    });
+  }
+
+  toggleEditMode(enabled: boolean) {
+    if (enabled) {
+      this.keyboardService.activateGroup('edit-shortcuts');
+    } else {
+      this.keyboardService.deactivateGroup('edit-shortcuts');
+    }
+  }
+
+  private cut() { /* implementation */ }
+  private copy() { /* implementation */ }
+}
+```
+
+### Batch Operations
+
+For better performance when making multiple changes, use the `batchUpdate` method:
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { KeyboardShortcuts } from 'ngx-keys';
+
+export class BatchUpdateComponent {
+  private readonly keyboardService = inject(KeyboardShortcuts);
+
+  constructor() {
+    this.setupMultipleShortcuts();
+  }
+
+  private setupMultipleShortcuts() {
+    // Batch multiple operations to reduce signal updates
+    // Note: Shortcuts are automatically activated when registered
+    this.keyboardService.batchUpdate(() => {
+      this.keyboardService.register({
+        id: 'action1',
+        keys: ['ctrl', '1'],
+        macKeys: ['meta', '1'],
+        action: () => this.action1(),
+        description: 'Action 1'
+      });
+
+      this.keyboardService.register({
+        id: 'action2',
+        keys: ['ctrl', '2'],
+        macKeys: ['meta', '2'],
+        action: () => this.action2(),
+        description: 'Action 2'
+      });
+    });
+  }
+
+  private action1() { /* implementation */ }
+  private action2() { /* implementation */ }
+}
+```
+
+### Checking Status
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { KeyboardShortcuts } from 'ngx-keys';
+
+export class MyComponent {
+  private readonly keyboardService = inject(KeyboardShortcuts);
+
+  checkAndActivate() {
+    // Check before performing operations
+    if (this.keyboardService.isRegistered('my-shortcut')) {
+      this.keyboardService.activate('my-shortcut');
+    }
+
+    if (this.keyboardService.isGroupRegistered('my-group')) {
+      this.keyboardService.activateGroup('my-group');
+    }
+  }
+}
+```
+
+## Building
+
+To build the library:
+
+```bash
+ng build ngx-keys
+```
+
+## Testing
+
+To run tests:
+
+```bash
+ng test ngx-keys
+```
+
+## License
+
+0BSD © [ngx-keys Contributors](LICENSE)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request

package/fesm2022/ngx-keys.mjs

@@ -0,0 +1,495 @@
+import * as i0 from '@angular/core';
+import { signal, computed, inject, PLATFORM_ID, Injectable } from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+
+/**
+ * Centralized error messages for keyboard shortcuts service
+ * This ensures consistency across the application and makes testing easier
+ */
+const KeyboardShortcutsErrors = {
+    // Registration errors
+    SHORTCUT_ALREADY_REGISTERED: (id) => `Shortcut "${id}" already registered`,
+    GROUP_ALREADY_REGISTERED: (id) => `Group "${id}" already registered`,
+    KEY_CONFLICT: (conflictId) => `Key conflict with "${conflictId}"`,
+    SHORTCUT_IDS_ALREADY_REGISTERED: (ids) => `Shortcut IDs already registered: ${ids.join(', ')}`,
+    DUPLICATE_SHORTCUTS_IN_GROUP: (ids) => `Duplicate shortcuts in group: ${ids.join(', ')}`,
+    KEY_CONFLICTS_IN_GROUP: (conflicts) => `Key conflicts: ${conflicts.join(', ')}`,
+    // Operation errors
+    SHORTCUT_NOT_REGISTERED: (id) => `Shortcut "${id}" not registered`,
+    GROUP_NOT_REGISTERED: (id) => `Group "${id}" not registered`,
+    // Activation/Deactivation errors
+    CANNOT_ACTIVATE_SHORTCUT: (id) => `Cannot activate shortcut "${id}": not registered`,
+    CANNOT_DEACTIVATE_SHORTCUT: (id) => `Cannot deactivate shortcut "${id}": not registered`,
+    CANNOT_ACTIVATE_GROUP: (id) => `Cannot activate group "${id}": not registered`,
+    CANNOT_DEACTIVATE_GROUP: (id) => `Cannot deactivate group "${id}": not registered`,
+    // Unregistration errors
+    CANNOT_UNREGISTER_SHORTCUT: (id) => `Cannot unregister shortcut "${id}": not registered`,
+    CANNOT_UNREGISTER_GROUP: (id) => `Cannot unregister group "${id}": not registered`,
+};
+/**
+ * Custom error class for keyboard shortcuts
+ */
+class KeyboardShortcutError extends Error {
+    errorType;
+    context;
+    constructor(errorType, message, context) {
+        super(message);
+        this.errorType = errorType;
+        this.context = context;
+        this.name = 'KeyboardShortcutError';
+    }
+}
+/**
+ * Error factory for creating consistent errors
+ */
+class KeyboardShortcutsErrorFactory {
+    static shortcutAlreadyRegistered(id) {
+        return new KeyboardShortcutError('SHORTCUT_ALREADY_REGISTERED', KeyboardShortcutsErrors.SHORTCUT_ALREADY_REGISTERED(id), { shortcutId: id });
+    }
+    static groupAlreadyRegistered(id) {
+        return new KeyboardShortcutError('GROUP_ALREADY_REGISTERED', KeyboardShortcutsErrors.GROUP_ALREADY_REGISTERED(id), { groupId: id });
+    }
+    static keyConflict(conflictId) {
+        return new KeyboardShortcutError('KEY_CONFLICT', KeyboardShortcutsErrors.KEY_CONFLICT(conflictId), { conflictId });
+    }
+    static shortcutIdsAlreadyRegistered(ids) {
+        return new KeyboardShortcutError('SHORTCUT_IDS_ALREADY_REGISTERED', KeyboardShortcutsErrors.SHORTCUT_IDS_ALREADY_REGISTERED(ids), { duplicateIds: ids });
+    }
+    static duplicateShortcutsInGroup(ids) {
+        return new KeyboardShortcutError('DUPLICATE_SHORTCUTS_IN_GROUP', KeyboardShortcutsErrors.DUPLICATE_SHORTCUTS_IN_GROUP(ids), { duplicateIds: ids });
+    }
+    static keyConflictsInGroup(conflicts) {
+        return new KeyboardShortcutError('KEY_CONFLICTS_IN_GROUP', KeyboardShortcutsErrors.KEY_CONFLICTS_IN_GROUP(conflicts), { conflicts });
+    }
+    static shortcutNotRegistered(id) {
+        return new KeyboardShortcutError('SHORTCUT_NOT_REGISTERED', KeyboardShortcutsErrors.SHORTCUT_NOT_REGISTERED(id), { shortcutId: id });
+    }
+    static groupNotRegistered(id) {
+        return new KeyboardShortcutError('GROUP_NOT_REGISTERED', KeyboardShortcutsErrors.GROUP_NOT_REGISTERED(id), { groupId: id });
+    }
+    static cannotActivateShortcut(id) {
+        return new KeyboardShortcutError('CANNOT_ACTIVATE_SHORTCUT', KeyboardShortcutsErrors.CANNOT_ACTIVATE_SHORTCUT(id), { shortcutId: id });
+    }
+    static cannotDeactivateShortcut(id) {
+        return new KeyboardShortcutError('CANNOT_DEACTIVATE_SHORTCUT', KeyboardShortcutsErrors.CANNOT_DEACTIVATE_SHORTCUT(id), { shortcutId: id });
+    }
+    static cannotActivateGroup(id) {
+        return new KeyboardShortcutError('CANNOT_ACTIVATE_GROUP', KeyboardShortcutsErrors.CANNOT_ACTIVATE_GROUP(id), { groupId: id });
+    }
+    static cannotDeactivateGroup(id) {
+        return new KeyboardShortcutError('CANNOT_DEACTIVATE_GROUP', KeyboardShortcutsErrors.CANNOT_DEACTIVATE_GROUP(id), { groupId: id });
+    }
+    static cannotUnregisterShortcut(id) {
+        return new KeyboardShortcutError('CANNOT_UNREGISTER_SHORTCUT', KeyboardShortcutsErrors.CANNOT_UNREGISTER_SHORTCUT(id), { shortcutId: id });
+    }
+    static cannotUnregisterGroup(id) {
+        return new KeyboardShortcutError('CANNOT_UNREGISTER_GROUP', KeyboardShortcutsErrors.CANNOT_UNREGISTER_GROUP(id), { groupId: id });
+    }
+}
+
+class KeyboardShortcuts {
+    shortcuts = new Map();
+    groups = new Map();
+    activeShortcuts = new Set();
+    activeGroups = new Set();
+    // Single consolidated state signal - reduces memory overhead
+    state = signal({
+        shortcuts: new Map(),
+        groups: new Map(),
+        activeShortcuts: new Set(),
+        activeGroups: new Set(),
+        version: 0 // for change detection optimization
+    }, ...(ngDevMode ? [{ debugName: "state" }] : []));
+    // Primary computed signal - consumers derive what they need from this
+    shortcuts$ = computed(() => {
+        const state = this.state();
+        const activeShortcuts = Array.from(state.activeShortcuts)
+            .map(id => state.shortcuts.get(id))
+            .filter((s) => s !== undefined);
+        const inactiveShortcuts = Array.from(state.shortcuts.values())
+            .filter(s => !state.activeShortcuts.has(s.id));
+        return {
+            active: activeShortcuts,
+            inactive: inactiveShortcuts,
+            all: Array.from(state.shortcuts.values()),
+            groups: {
+                active: Array.from(state.activeGroups),
+                inactive: Array.from(state.groups.keys())
+                    .filter(id => !state.activeGroups.has(id))
+            }
+        };
+    }, ...(ngDevMode ? [{ debugName: "shortcuts$" }] : []));
+    // Optional: Pre-formatted UI signal for components that need it
+    shortcutsUI$ = computed(() => {
+        const shortcuts = this.shortcuts$();
+        return {
+            active: shortcuts.active.map(s => this.formatShortcutForUI(s)),
+            inactive: shortcuts.inactive.map(s => this.formatShortcutForUI(s)),
+            all: shortcuts.all.map(s => this.formatShortcutForUI(s))
+        };
+    }, ...(ngDevMode ? [{ debugName: "shortcutsUI$" }] : []));
+    keydownListener = this.handleKeydown.bind(this);
+    isListening = false;
+    isBrowser;
+    constructor() {
+        // Use try-catch to handle injection context for better testability
+        try {
+            const platformId = inject(PLATFORM_ID);
+            this.isBrowser = isPlatformBrowser(platformId);
+        }
+        catch {
+            // Fallback for testing - assume browser environment
+            this.isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+        }
+        if (this.isBrowser) {
+            this.startListening();
+        }
+    }
+    ngOnDestroy() {
+        this.stopListening();
+    }
+    /**
+     * Batch updates and increment version for change detection
+     */
+    updateState() {
+        this.state.update(current => ({
+            shortcuts: new Map(this.shortcuts),
+            groups: new Map(this.groups),
+            activeShortcuts: new Set(this.activeShortcuts),
+            activeGroups: new Set(this.activeGroups),
+            version: current.version + 1
+        }));
+    }
+    /**
+     * Utility method for UI formatting
+     */
+    formatShortcutForUI(shortcut) {
+        return {
+            id: shortcut.id,
+            keys: this.formatKeysForDisplay(shortcut.keys, false),
+            macKeys: this.formatKeysForDisplay(shortcut.macKeys, true),
+            description: shortcut.description
+        };
+    }
+    /**
+     * Utility method for batch operations - reduces signal updates
+     */
+    batchUpdate(operations) {
+        operations();
+        this.updateState();
+    }
+    /**
+     * Format keys for display with proper Unicode symbols
+     */
+    formatKeysForDisplay(keys, isMac = false) {
+        const keyMap = isMac ? {
+            'ctrl': '⌃',
+            'alt': '⌥',
+            'shift': '⇧',
+            'meta': '⌘',
+            'cmd': '⌘',
+            'command': '⌘'
+        } : {
+            'ctrl': 'Ctrl',
+            'alt': 'Alt',
+            'shift': 'Shift',
+            'meta': 'Win'
+        };
+        return keys
+            .map(key => keyMap[key.toLowerCase()] || key.toUpperCase())
+            .join('+');
+    }
+    /**
+     * 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)) {
+                return existing.id;
+            }
+            if (this.keysMatch(newShortcut.macKeys, existing.macKeys)) {
+                return existing.id;
+            }
+        }
+        return null;
+    }
+    /**
+     * Register a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID is already registered or key combination is in use
+     */
+    register(shortcut) {
+        if (this.shortcuts.has(shortcut.id)) {
+            throw KeyboardShortcutsErrorFactory.shortcutAlreadyRegistered(shortcut.id);
+        }
+        const conflictId = this.findConflict(shortcut);
+        if (conflictId) {
+            throw KeyboardShortcutsErrorFactory.keyConflict(conflictId);
+        }
+        this.shortcuts.set(shortcut.id, shortcut);
+        this.activeShortcuts.add(shortcut.id);
+        this.updateState();
+    }
+    /**
+     * 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) {
+        // Check if group ID already exists
+        if (this.groups.has(groupId)) {
+            throw KeyboardShortcutsErrorFactory.groupAlreadyRegistered(groupId);
+        }
+        // Check for duplicate shortcut IDs and key combination conflicts
+        const duplicateIds = [];
+        const keyConflicts = [];
+        shortcuts.forEach(shortcut => {
+            if (this.shortcuts.has(shortcut.id)) {
+                duplicateIds.push(shortcut.id);
+            }
+            const conflictId = this.findConflict(shortcut);
+            if (conflictId) {
+                keyConflicts.push(`"${shortcut.id}" conflicts with "${conflictId}"`);
+            }
+        });
+        if (duplicateIds.length > 0) {
+            throw KeyboardShortcutsErrorFactory.shortcutIdsAlreadyRegistered(duplicateIds);
+        }
+        if (keyConflicts.length > 0) {
+            throw KeyboardShortcutsErrorFactory.keyConflictsInGroup(keyConflicts);
+        }
+        // Validate that all shortcuts have unique IDs within the group
+        const groupIds = new Set();
+        const duplicatesInGroup = [];
+        shortcuts.forEach(shortcut => {
+            if (groupIds.has(shortcut.id)) {
+                duplicatesInGroup.push(shortcut.id);
+            }
+            else {
+                groupIds.add(shortcut.id);
+            }
+        });
+        if (duplicatesInGroup.length > 0) {
+            throw KeyboardShortcutsErrorFactory.duplicateShortcutsInGroup(duplicatesInGroup);
+        }
+        // Use batch update to reduce signal updates
+        this.batchUpdate(() => {
+            const group = {
+                id: groupId,
+                shortcuts,
+                active: true
+            };
+            this.groups.set(groupId, group);
+            this.activeGroups.add(groupId);
+            // Register individual shortcuts
+            shortcuts.forEach(shortcut => {
+                this.shortcuts.set(shortcut.id, shortcut);
+                this.activeShortcuts.add(shortcut.id);
+            });
+        });
+    }
+    /**
+     * Unregister a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    unregister(shortcutId) {
+        if (!this.shortcuts.has(shortcutId)) {
+            throw KeyboardShortcutsErrorFactory.cannotUnregisterShortcut(shortcutId);
+        }
+        this.shortcuts.delete(shortcutId);
+        this.activeShortcuts.delete(shortcutId);
+        this.updateState();
+    }
+    /**
+     * Unregister a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    unregisterGroup(groupId) {
+        const group = this.groups.get(groupId);
+        if (!group) {
+            throw KeyboardShortcutsErrorFactory.cannotUnregisterGroup(groupId);
+        }
+        this.batchUpdate(() => {
+            group.shortcuts.forEach(shortcut => {
+                this.shortcuts.delete(shortcut.id);
+                this.activeShortcuts.delete(shortcut.id);
+            });
+            this.groups.delete(groupId);
+            this.activeGroups.delete(groupId);
+        });
+    }
+    /**
+     * Activate a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    activate(shortcutId) {
+        if (!this.shortcuts.has(shortcutId)) {
+            throw KeyboardShortcutsErrorFactory.cannotActivateShortcut(shortcutId);
+        }
+        this.activeShortcuts.add(shortcutId);
+        this.updateState();
+    }
+    /**
+     * Deactivate a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    deactivate(shortcutId) {
+        if (!this.shortcuts.has(shortcutId)) {
+            throw KeyboardShortcutsErrorFactory.cannotDeactivateShortcut(shortcutId);
+        }
+        this.activeShortcuts.delete(shortcutId);
+        this.updateState();
+    }
+    /**
+     * Activate a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    activateGroup(groupId) {
+        const group = this.groups.get(groupId);
+        if (!group) {
+            throw KeyboardShortcutsErrorFactory.cannotActivateGroup(groupId);
+        }
+        this.batchUpdate(() => {
+            group.active = true;
+            this.activeGroups.add(groupId);
+            group.shortcuts.forEach(shortcut => {
+                this.activeShortcuts.add(shortcut.id);
+            });
+        });
+    }
+    /**
+     * Deactivate a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    deactivateGroup(groupId) {
+        const group = this.groups.get(groupId);
+        if (!group) {
+            throw KeyboardShortcutsErrorFactory.cannotDeactivateGroup(groupId);
+        }
+        this.batchUpdate(() => {
+            group.active = false;
+            this.activeGroups.delete(groupId);
+            group.shortcuts.forEach(shortcut => {
+                this.activeShortcuts.delete(shortcut.id);
+            });
+        });
+    }
+    /**
+     * Check if a shortcut is active
+     */
+    isActive(shortcutId) {
+        return this.activeShortcuts.has(shortcutId);
+    }
+    /**
+     * Check if a shortcut is registered
+     */
+    isRegistered(shortcutId) {
+        return this.shortcuts.has(shortcutId);
+    }
+    /**
+     * Check if a group is active
+     */
+    isGroupActive(groupId) {
+        return this.activeGroups.has(groupId);
+    }
+    /**
+     * Check if a group is registered
+     */
+    isGroupRegistered(groupId) {
+        return this.groups.has(groupId);
+    }
+    /**
+     * Get all registered shortcuts
+     */
+    getShortcuts() {
+        return this.shortcuts;
+    }
+    /**
+     * Get all registered groups
+     */
+    getGroups() {
+        return this.groups;
+    }
+    startListening() {
+        if (!this.isBrowser || this.isListening) {
+            return;
+        }
+        document.addEventListener('keydown', this.keydownListener, { passive: false });
+        this.isListening = true;
+    }
+    stopListening() {
+        if (!this.isBrowser || !this.isListening) {
+            return;
+        }
+        document.removeEventListener('keydown', this.keydownListener);
+        this.isListening = false;
+    }
+    handleKeydown(event) {
+        const pressedKeys = this.getPressedKeys(event);
+        const isMac = this.isMacPlatform();
+        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();
+                }
+                catch (error) {
+                    console.error(`Error executing keyboard shortcut "${shortcut.id}":`, error);
+                }
+                break; // Only execute the first matching shortcut
+            }
+        }
+    }
+    getPressedKeys(event) {
+        const keys = [];
+        if (event.ctrlKey)
+            keys.push('ctrl');
+        if (event.altKey)
+            keys.push('alt');
+        if (event.shiftKey)
+            keys.push('shift');
+        if (event.metaKey)
+            keys.push('meta');
+        // Add the main key (normalize to lowercase)
+        const key = event.key.toLowerCase();
+        if (!['control', 'alt', 'shift', 'meta'].includes(key)) {
+            keys.push(key);
+        }
+        return keys;
+    }
+    keysMatch(pressedKeys, targetKeys) {
+        if (pressedKeys.length !== targetKeys.length) {
+            return false;
+        }
+        // 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]);
+    }
+    isMacPlatform() {
+        return this.isBrowser && /Mac|iPod|iPhone|iPad/.test(navigator.platform);
+    }
+    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' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: KeyboardShortcuts, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: () => [] });
+
+/*
+ * Public API Surface of ngx-keys
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { KeyboardShortcutError, KeyboardShortcuts, KeyboardShortcutsErrorFactory, KeyboardShortcutsErrors };
+//# sourceMappingURL=ngx-keys.mjs.map

package/fesm2022/ngx-keys.mjs.map

@@ -0,0 +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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"}

package/index.d.ts

@@ -0,0 +1,199 @@
+import * as _angular_core from '@angular/core';
+import { OnDestroy } from '@angular/core';
+
+interface KeyboardShortcut {
+    id: string;
+    keys: string[];
+    macKeys: string[];
+    action: () => void;
+    description: string;
+}
+interface KeyboardShortcutGroup {
+    id: string;
+    shortcuts: KeyboardShortcut[];
+    active: boolean;
+}
+/**
+ * Interface for keyboard shortcut data optimized for UI display
+ */
+interface KeyboardShortcutUI {
+    id: string;
+    keys: string;
+    macKeys: string;
+    description: string;
+}
+
+declare class KeyboardShortcuts implements OnDestroy {
+    private readonly shortcuts;
+    private readonly groups;
+    private readonly activeShortcuts;
+    private readonly activeGroups;
+    private readonly state;
+    readonly shortcuts$: _angular_core.Signal<{
+        active: KeyboardShortcut[];
+        inactive: KeyboardShortcut[];
+        all: KeyboardShortcut[];
+        groups: {
+            active: string[];
+            inactive: string[];
+        };
+    }>;
+    readonly shortcutsUI$: _angular_core.Signal<{
+        active: KeyboardShortcutUI[];
+        inactive: KeyboardShortcutUI[];
+        all: KeyboardShortcutUI[];
+    }>;
+    private readonly keydownListener;
+    private isListening;
+    protected isBrowser: boolean;
+    constructor();
+    ngOnDestroy(): void;
+    /**
+     * Batch updates and increment version for change detection
+     */
+    private updateState;
+    /**
+     * Utility method for UI formatting
+     */
+    formatShortcutForUI(shortcut: KeyboardShortcut): KeyboardShortcutUI;
+    /**
+     * Utility method for batch operations - reduces signal updates
+     */
+    batchUpdate(operations: () => void): void;
+    /**
+     * Format keys for display with proper Unicode symbols
+     */
+    private formatKeysForDisplay;
+    /**
+     * Check if a key combination is already registered
+     * @returns The ID of the conflicting shortcut, or null if no conflict
+     */
+    private findConflict;
+    /**
+     * Register a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID is already registered or key combination is in use
+     */
+    register(shortcut: KeyboardShortcut): void;
+    /**
+     * 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;
+    /**
+     * Unregister a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    unregister(shortcutId: string): void;
+    /**
+     * Unregister a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    unregisterGroup(groupId: string): void;
+    /**
+     * Activate a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    activate(shortcutId: string): void;
+    /**
+     * Deactivate a single keyboard shortcut
+     * @throws KeyboardShortcutError if shortcut ID doesn't exist
+     */
+    deactivate(shortcutId: string): void;
+    /**
+     * Activate a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    activateGroup(groupId: string): void;
+    /**
+     * Deactivate a group of keyboard shortcuts
+     * @throws KeyboardShortcutError if group ID doesn't exist
+     */
+    deactivateGroup(groupId: string): void;
+    /**
+     * Check if a shortcut is active
+     */
+    isActive(shortcutId: string): boolean;
+    /**
+     * Check if a shortcut is registered
+     */
+    isRegistered(shortcutId: string): boolean;
+    /**
+     * Check if a group is active
+     */
+    isGroupActive(groupId: string): boolean;
+    /**
+     * Check if a group is registered
+     */
+    isGroupRegistered(groupId: string): boolean;
+    /**
+     * Get all registered shortcuts
+     */
+    getShortcuts(): ReadonlyMap<string, KeyboardShortcut>;
+    /**
+     * Get all registered groups
+     */
+    getGroups(): ReadonlyMap<string, KeyboardShortcutGroup>;
+    private startListening;
+    private stopListening;
+    protected handleKeydown(event: KeyboardEvent): void;
+    protected getPressedKeys(event: KeyboardEvent): string[];
+    protected keysMatch(pressedKeys: string[], targetKeys: string[]): boolean;
+    protected isMacPlatform(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KeyboardShortcuts, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<KeyboardShortcuts>;
+}
+
+/**
+ * Centralized error messages for keyboard shortcuts service
+ * This ensures consistency across the application and makes testing easier
+ */
+declare const KeyboardShortcutsErrors: {
+    readonly SHORTCUT_ALREADY_REGISTERED: (id: string) => string;
+    readonly GROUP_ALREADY_REGISTERED: (id: string) => string;
+    readonly KEY_CONFLICT: (conflictId: 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;
+    readonly SHORTCUT_NOT_REGISTERED: (id: string) => string;
+    readonly GROUP_NOT_REGISTERED: (id: string) => string;
+    readonly CANNOT_ACTIVATE_SHORTCUT: (id: string) => string;
+    readonly CANNOT_DEACTIVATE_SHORTCUT: (id: string) => string;
+    readonly CANNOT_ACTIVATE_GROUP: (id: string) => string;
+    readonly CANNOT_DEACTIVATE_GROUP: (id: string) => string;
+    readonly CANNOT_UNREGISTER_SHORTCUT: (id: string) => string;
+    readonly CANNOT_UNREGISTER_GROUP: (id: string) => string;
+};
+/**
+ * Error types for type safety
+ */
+type KeyboardShortcutsErrorType = keyof typeof KeyboardShortcutsErrors;
+/**
+ * Custom error class for keyboard shortcuts
+ */
+declare class KeyboardShortcutError extends Error {
+    readonly errorType: KeyboardShortcutsErrorType;
+    readonly context?: Record<string, any> | undefined;
+    constructor(errorType: KeyboardShortcutsErrorType, message: string, context?: Record<string, any> | undefined);
+}
+/**
+ * Error factory for creating consistent errors
+ */
+declare class KeyboardShortcutsErrorFactory {
+    static shortcutAlreadyRegistered(id: string): KeyboardShortcutError;
+    static groupAlreadyRegistered(id: string): KeyboardShortcutError;
+    static keyConflict(conflictId: string): KeyboardShortcutError;
+    static shortcutIdsAlreadyRegistered(ids: string[]): KeyboardShortcutError;
+    static duplicateShortcutsInGroup(ids: string[]): KeyboardShortcutError;
+    static keyConflictsInGroup(conflicts: string[]): KeyboardShortcutError;
+    static shortcutNotRegistered(id: string): KeyboardShortcutError;
+    static groupNotRegistered(id: string): KeyboardShortcutError;
+    static cannotActivateShortcut(id: string): KeyboardShortcutError;
+    static cannotDeactivateShortcut(id: string): KeyboardShortcutError;
+    static cannotActivateGroup(id: string): KeyboardShortcutError;
+    static cannotDeactivateGroup(id: string): KeyboardShortcutError;
+    static cannotUnregisterShortcut(id: string): KeyboardShortcutError;
+    static cannotUnregisterGroup(id: string): KeyboardShortcutError;
+}
+
+export { KeyboardShortcutError, KeyboardShortcuts, KeyboardShortcutsErrorFactory, KeyboardShortcutsErrors };
+export type { KeyboardShortcut, KeyboardShortcutGroup, KeyboardShortcutUI, KeyboardShortcutsErrorType };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ngx-keys",
+  "version": "1.0.0",
+  "description": "A reactive Angular library for managing keyboard shortcuts with signals-based UI integration",
+  "keywords": [
+    "angular",
+    "typescript",
+    "keyboard-shortcuts",
+    "hotkeys",
+    "angular-library",
+    "reactive",
+    "signals",
+    "ui-components",
+    "cross-platform",
+    "angular-signals"
+  ],
+  "license": "0BSD",
+  "author": "NgxKeys Contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrivasperez/ngx-keys.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mrivasperez/ngx-keys/issues"
+  },
+  "homepage": "https://github.com/mrivasperez/ngx-keys#readme",
+  "peerDependencies": {
+    "@angular/common": "^20.2.0",
+    "@angular/core": "^20.2.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/ngx-keys.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/ngx-keys.mjs"
+    }
+  }
+}