@sekiui/elements 0.0.55 → 0.0.57

package/dist/components/p-BJCq8m2o.js

@@ -0,0 +1,138 @@
+/**
+ * Keyboard Service
+ * Provides normalized keyboard event handling and shortcut management
+ * Handles cross-platform shortcuts (Ctrl/Cmd combinations)
+ */
+/**
+ * KeyboardService - Centralized keyboard event management
+ * Provides:
+ * - Normalized keyboard shortcuts (handles Ctrl vs Cmd on Mac)
+ * - Cross-platform shortcut registration
+ * - Event cleanup and teardown
+ */
+class KeyboardService {
+    constructor() {
+        this.shortcuts = new Map();
+        this.listeners = new Map();
+    }
+    /**
+     * Register a keyboard shortcut
+     * @param id - Unique identifier for this shortcut
+     * @param options - Shortcut configuration
+     */
+    registerShortcut(id, options) {
+        if (typeof window === 'undefined')
+            return;
+        const { key, ctrl = false, shift = false, alt = false, meta = false, handler, preventDefault = true } = options;
+        const handleKeyDown = (event) => {
+            const keyboardEvent = event;
+            const keyMatches = keyboardEvent.key.toLowerCase() === key.toLowerCase();
+            const ctrlMatches = ctrl ? keyboardEvent.ctrlKey : true;
+            const shiftMatches = shift ? keyboardEvent.shiftKey : !keyboardEvent.shiftKey;
+            const altMatches = alt ? keyboardEvent.altKey : !keyboardEvent.altKey;
+            // metaKey matches both metaKey (Mac Cmd) and ctrlKey (Windows/Linux) for cross-platform support
+            const metaMatches = meta ? keyboardEvent.metaKey || keyboardEvent.ctrlKey : !keyboardEvent.metaKey && !keyboardEvent.ctrlKey;
+            if (keyMatches && ctrlMatches && shiftMatches && altMatches && metaMatches) {
+                if (preventDefault) {
+                    keyboardEvent.preventDefault();
+                }
+                handler(keyboardEvent);
+            }
+        };
+        this.shortcuts.set(id, {
+            key,
+            ctrlKey: ctrl,
+            shiftKey: shift,
+            altKey: alt,
+            metaKey: meta,
+            handler: handleKeyDown,
+        });
+        this.listeners.set(id, handleKeyDown);
+        window.addEventListener('keydown', handleKeyDown);
+    }
+    /**
+     * Register a shortcut that works with Ctrl on Windows/Linux and Cmd on Mac
+     * @param id - Unique identifier for this shortcut
+     * @param key - The key to listen for
+     * @param handler - Callback when shortcut is triggered
+     * @param preventDefault - Whether to prevent default browser behavior
+     */
+    registerCtrlOrCmdShortcut(id, key, handler, preventDefault = true) {
+        if (typeof window === 'undefined')
+            return;
+        const handleKeyDown = (event) => {
+            const keyboardEvent = event;
+            const keyMatches = keyboardEvent.key.toLowerCase() === key.toLowerCase();
+            const modifierMatches = keyboardEvent.ctrlKey || keyboardEvent.metaKey;
+            if (keyMatches && modifierMatches && !keyboardEvent.shiftKey && !keyboardEvent.altKey) {
+                if (preventDefault) {
+                    keyboardEvent.preventDefault();
+                }
+                handler(keyboardEvent);
+            }
+        };
+        this.listeners.set(id, handleKeyDown);
+        window.addEventListener('keydown', handleKeyDown);
+    }
+    /**
+     * Unregister a keyboard shortcut
+     * @param id - The identifier of the shortcut to remove
+     */
+    unregisterShortcut(id) {
+        if (typeof window === 'undefined')
+            return;
+        const listener = this.listeners.get(id);
+        if (listener) {
+            window.removeEventListener('keydown', listener);
+            this.listeners.delete(id);
+        }
+        this.shortcuts.delete(id);
+    }
+    /**
+     * Unregister all shortcuts and clean up
+     */
+    cleanup() {
+        if (typeof window === 'undefined')
+            return;
+        this.listeners.forEach((listener) => {
+            window.removeEventListener('keydown', listener);
+        });
+        this.listeners.clear();
+        this.shortcuts.clear();
+    }
+    /**
+     * Check if a keyboard event matches a specific key combination
+     * @param event - The keyboard event to check
+     * @param key - The key to match
+     * @param ctrl - Whether Ctrl/Cmd should be pressed
+     * @param shift - Whether Shift should be pressed
+     * @param alt - Whether Alt should be pressed
+     */
+    matchesShortcut(event, key, ctrl = false, shift = false, alt = false) {
+        const keyMatches = event.key.toLowerCase() === key.toLowerCase();
+        const ctrlMatches = ctrl ? event.ctrlKey || event.metaKey : !event.ctrlKey && !event.metaKey;
+        const shiftMatches = shift ? event.shiftKey : !event.shiftKey;
+        const altMatches = alt ? event.altKey : !event.altKey;
+        return keyMatches && ctrlMatches && shiftMatches && altMatches;
+    }
+}
+// Singleton instance
+let keyboardServiceInstance = null;
+/**
+ * Get the singleton KeyboardService instance
+ */
+function getKeyboardService() {
+    if (!keyboardServiceInstance) {
+        keyboardServiceInstance = new KeyboardService();
+    }
+    return keyboardServiceInstance;
+}
+/**
+ * Create a new isolated KeyboardService instance
+ * Useful for testing or when you need independent event handling
+ */
+function createKeyboardService() {
+    return new KeyboardService();
+}
+
+export { KeyboardService as K, createKeyboardService as c, getKeyboardService as g };