igniteui-webcomponents 7.3.1 → 7.4.0

package/internals/controllers/key-bindings.d.ts

@@ -1,56 +1,42 @@
-import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ReactiveControllerHost } from 'lit';
 import type { Ref } from 'lit/directives/ref.js';
-export declare const arrowLeft: "ArrowLeft";
-export declare const arrowRight: "ArrowRight";
-export declare const arrowUp: "ArrowUp";
-export declare const arrowDown: "ArrowDown";
-export declare const enterKey: "Enter";
-export declare const spaceBar: " ";
-export declare const escapeKey: "Escape";
-export declare const homeKey: "Home";
-export declare const endKey: "End";
-export declare const pageUpKey: "PageUp";
-export declare const pageDownKey: "PageDown";
-export declare const tabKey: "Tab";
-export declare const altKey: "Alt";
-export declare const ctrlKey: "Control";
-export declare const metaKey: "Meta";
-export declare const shiftKey: "Shift";
+export * from './keys.js';
+/**
+ * {@link MODIFIER_ENTRIES} as a name to event property lookup.
+ * @internal Used by the keyboard simulation helper of the test suite.
+ */
+export declare const MODIFIER_EVENT_KEYS: Record<string, string>;
+/**
+ * Splits the keys into modifiers (Alt, Control, Meta, Shift) and normal keys,
+ * in lower case.
+ *
+ * @internal
+ */
+export declare function parseKeys(inputKeys: string | string[]): {
+    keys: string[];
+    modifiers: string[];
+};
 type KeyBindingHandler = (event: KeyboardEvent) => void;
 type KeyBindingObserverCleanup = {
     unsubscribe: () => void;
 };
 /**
- * Whether the current event should be ignored by the controller.
- *
- * @param node - The event target
- * @param event - The event object
+ * Whether the controller must ignore the current event.
  *
- * When `true` is returned, the current event is ignored.
+ * @param node - The target of the event.
+ * @param event - The event.
  */
 type KeyBindingSkipCallback = (node: Element, event: KeyboardEvent) => boolean;
-/**
- * The event type which will trigger the bound handler.
- */
+/** The event type that starts the bound handler. */
 type KeyBindingTrigger = 'keydown' | 'keyup';
-/**
- * Configuration object for the controller.
- * @hidden
- */
+/** @hidden */
 interface KeyBindingControllerOptions {
-    /**
-     * By default, the controller listens for keypress events in the context of the host element.
-     * If you pass a `ref`, you can limit the observation to a certain DOM part of the host scope.
-     */
+    /** The element to observe. Defaults to the host element. */
     ref?: Ref;
     /**
-     * Option to ignore key press events.
-     *
-     * If passed an array of CSS selectors, it will ignore key presses originating from elements in the event composed path
-     * that match one of the selectors.
-     * Otherwise you can pass a {@link KeyBindingSkipCallback} function.
-     *
-     * Defaults to `['input', 'textarea', 'select']`.
+     * The key presses that the controller ignores. CSS selectors match against
+     * the composed path of the event; a {@link KeyBindingSkipCallback} decides
+     * per event instead. Defaults to `['input', 'textarea', 'select']`.
      *
      * @example
      * ```ts
@@ -66,177 +52,94 @@ interface KeyBindingControllerOptions {
      * ```
      */
     skip?: string[] | KeyBindingSkipCallback;
-    /**
-     * A set of KeyBindingOptions configuration which is applied to every handler
-     * that is added to the controller.
-     *
-     * Any additional KeyBindingOptions values passed when `set` is called
-     * will be merged with `bindingDefaults`.
-     */
+    /** Default options for every binding. A `set` call merges over them. */
     bindingDefaults?: KeyBindingOptions;
 }
-/**
- * Configuration object for customizing the behavior of
- * the registered handler.
- */
 interface KeyBindingOptions {
-    /**
-     * The event type(s) on which the handler will be invoked.
-     *
-     * Defaults to `keydown` if not set.
-     */
+    /** The event types that start the handler. Defaults to `keydown`. */
     triggers?: KeyBindingTrigger[];
-    /**
-     * Whether the handler should fire on auto-repeated keydown events (i.e. when a key is held down).
-     *
-     * Defaults to `false`.
-     */
+    /** Whether the handler runs for a repeated keydown. Defaults to `false`. */
     repeat?: boolean;
-    /**
-     * Whether to call `preventDefault` on the target event before the handler is invoked.
-     */
+    /** Whether to call `preventDefault` before the handler runs. */
     preventDefault?: boolean;
-    /**
-     * Whether to call `stopPropagation` on the target event before the handler is invoked.
-     */
+    /** Whether to call `stopPropagation` before the handler runs. */
     stopPropagation?: boolean;
 }
-/** {@link MODIFIER_ENTRIES} as a lookup of modifier name to event property. */
-export declare const MODIFIER_EVENT_KEYS: Record<string, string>;
 /**
- * Whether the event's key matches `key`, case-insensitively. Prefer this over
- * comparing `event.key` directly - the key names of this module are lowercase,
- * while real events carry the canonical casing (e.g. `Enter`).
- */
-export declare function isKey(event: KeyboardEvent, key: string): boolean;
-/**
- * A controller for managing key bindings on a host element. It allows you to register handlers for specific key combinations,
- * with support for modifier keys and event options such as `preventDefault` and `stopPropagation`.
- *
- * The controller listens for keyboard events on the host element (or an optionally specified element) and invokes the appropriate handlers
- * when the registered key combinations are detected.
+ * Manages the key bindings of a host element.
  * @hidden
  */
-declare class KeyBindingController implements ReactiveController {
+declare class KeyBindingController {
+    /** Base configuration, shared between instances. Never written to. */
     private static readonly _defaultOptions;
     private readonly _host;
     private readonly _ref?;
-    private readonly _abortHandle;
     private readonly _bindings;
     private readonly _allowedKeys;
     private readonly _pressedKeys;
-    private readonly _options;
-    private readonly _skipSelector;
+    private readonly _bindingDefaults;
+    private readonly _skipSelector?;
+    private readonly _skipCallback?;
     private _observedElement?;
     private get _element();
     constructor(host: ReactiveControllerHost & Element, options?: KeyBindingControllerOptions);
-    /**
-     * Applies the event modifiers specified in the binding options to the provided keyboard event.
-     * If `preventDefault` is set, it calls `event.preventDefault()`.
-     * If `stopPropagation` is set, it calls `event.stopPropagation()`.
-     */
+    /** Applies the event options of the binding to the keyboard event. */
     private _applyEventModifiers;
-    /**
-     * Determines whether the provided keyboard event matches the specified key binding,
-     * taking into account the event type and the binding's trigger options.
-     */
+    /** Whether the event type matches the triggers of the binding. */
     private _bindingMatches;
     /**
-     * Determines whether the provided event should be ignored based on the controller's configuration and the event's context.
-     * The method checks if the event's key is among the allowed keys, if the event originated from within the controller's scope,
-     * and if it matches any of the skip conditions defined in the controller's options.
+     * Whether to ignore the event. The key has no binding, the event missed the
+     * observed element, or the skip configuration agrees.
      */
     private _shouldSkip;
-    /** @internal */
-    hostConnected(): void;
-    /** @internal */
-    hostDisconnected(): void;
     /**
-     * Handles the global blur event to clear the internal state of pressed keys.
-     *
-     * This is necessary to prevent "stuck" keys when the user switches to another application
-     * or tab while holding down a key.
+     * Clears the pressed keys on a global blur. No keyup arrives if the user
+     * moves to a different application or tab with a key down.
      */
     private _handleGlobalBlur;
-    /**
-     * Handles keyboard events on the observed element.
-     *
-     * It checks if the event should be skipped based on the controller's configuration,
-     * and if not, it determines if there is a registered handler for the combination of pressed keys and active modifiers.
-     *
-     * If a matching handler is found, it applies the specified event modifiers and invokes the handler.
-     * It also manages the internal state of currently pressed keys to accurately detect key combinations.
-     *
-     */
+    /** Handles a keyboard event on the observed element. */
     private _handleKeyEvent;
     /** @internal */
     handleEvent(event: KeyboardEvent | FocusEvent): void;
     /**
-     * Registers a key binding with the specified key(s), handler function, and optional configuration.
-     *
-     * The `key` parameter can be a single key or an array of keys, and can include modifier keys (e.g., 'ctrl+s', ['shift', 'a']).
-     * The `handler` is a function that will be called when the specified key combination is detected.
-     * The `bindingOptions` allow you to customize the behavior of the binding, such as which event types trigger the handler,
-     * whether it should fire on auto-repeated keydown events, and whether to call `preventDefault` or `stopPropagation`.
-     *
-     * The method returns the controller instance to allow for method chaining.
+     * Registers a binding for a key or a combination, such as `['shift', 'a']`.
+     * Returns the controller, for chaining.
      */
     set(key: string | string[], handler: KeyBindingHandler, bindingOptions?: KeyBindingOptions): this;
     /**
-     * Registers the provided handler function to be called when either the Enter key or Space bar is pressed.
-     *
-     * This is a common pattern for activating buttons or interactive elements, and this method provides a convenient way to set up such bindings.
-     *
-     * The method accepts optional `KeyBindingOptions` which are applied to both the Enter key and Space bar bindings.
-     * It returns the controller instance to allow for method chaining.
-     *
+     * Registers `handler` for both the Enter key and the Space bar. Returns the
+     * controller, for chaining.
      */
     setActivateHandler(handler: KeyBindingHandler, options?: KeyBindingOptions): this;
     /**
-     * Sets the controller to listen for keyboard events on an arbitrary `element` in the page context.
-     * All the configuration and event handlers are applied as well.
-     *
-     * Returns an object with an `unsubscribe` function which should be called when the observing of keyboard
-     * events on the `element` should cease.
+     * Listens for keyboard events on any page element, with the configuration
+     * and the handlers of this controller. Call `unsubscribe` to stop.
      */
     observeElement(element: Element): KeyBindingObserverCleanup;
 }
 /**
- * Parses the provided key(s) and separates them into modifiers and regular keys.
- *
- * Modifiers are keys like Alt, Ctrl, Meta and Shift which modify the behavior of other keys when pressed in combination.
- * Regular keys are all other keys which trigger the bound handler when pressed.
- *
- * The returned `keys` and `modifiers` are normalized to lowercase for consistency.
- *
- * @internal
- *
- * @param inputKeys - The key or keys to parse, provided as a string or an array of strings.
- * @returns An object containing the separated `keys` and `modifiers`.
- */
-export declare function parseKeys(inputKeys: string | string[]): {
-    keys: string[];
-    modifiers: string[];
-};
-/**
- * Controller factory function which creates a {@link KeyBindingController} instance and attaches it to the provided host.
+ * Creates a {@link KeyBindingController}, and adds it to the given host.
  *
- * @param element - The host element to which the controller will be attached.
- * @param options - Optional configuration for the controller.
- * @returns The created {@link KeyBindingController} instance.
+ * @param element - The host element of the controller.
+ * @param options - The configuration of the controller.
+ * @returns The new controller.
  *
  * @example
  * ```ts
  * class MyComponent extends LitElement {
+ *   // `skip` ignores the key presses that come from these elements.
+ *   // `bindingDefaults` applies to each binding of the controller.
  *   private _keyBindings = addKeybindings(this, {
- *     skip: ['input', 'textarea'], // Optional: Skip key events originating from these elements
- *     bindingDefaults: { preventDefault: true }, // Optional: Default options for all bindings
+ *     skip: ['input', 'textarea'],
+ *     bindingDefaults: { preventDefault: true },
  *   });
  *
  *   constructor() {
  *     super();
- *     this._keyBindings.set('ctrl+s', this._handleSave); // Register a key binding
+ *     // A combination is an array of key names, not one joined string.
+ *     this._keyBindings.set([ctrlKey, 's'], this._handleSave);
  *   }
+ * }
  * ```
  */
 export declare function addKeybindings(element: ReactiveControllerHost & Element, options?: KeyBindingControllerOptions): KeyBindingController;

package/internals/controllers/key-bindings.js

@@ -1,24 +1,10 @@
 import { createAbortHandle } from '../abort-handler.js';
 import { asArray, partition } from '../utils/arrays.js';
 import { isElement } from '../utils/dom.js';
-import { toMerged } from '../utils/objects.js';
 import { isFunction } from '../utils/types.js';
-export const arrowLeft = 'ArrowLeft';
-export const arrowRight = 'ArrowRight';
-export const arrowUp = 'ArrowUp';
-export const arrowDown = 'ArrowDown';
-export const enterKey = 'Enter';
-export const spaceBar = ' ';
-export const escapeKey = 'Escape';
-export const homeKey = 'Home';
-export const endKey = 'End';
-export const pageUpKey = 'PageUp';
-export const pageDownKey = 'PageDown';
-export const tabKey = 'Tab';
-export const altKey = 'Alt';
-export const ctrlKey = 'Control';
-export const metaKey = 'Meta';
-export const shiftKey = 'Shift';
+import { addHostListeners } from './host-listeners.js';
+import { enterKey, spaceBar } from './keys.js';
+export * from './keys.js';
 const MODIFIER_ENTRIES = [
     ['alt', 'altKey'],
     ['control', 'ctrlKey'],
@@ -28,17 +14,9 @@ const MODIFIER_ENTRIES = [
 const ALL_MODIFIER_VALUES = MODIFIER_ENTRIES.map(([name]) => name);
 const MODIFIERS = new Set(ALL_MODIFIER_VALUES);
 export const MODIFIER_EVENT_KEYS = Object.fromEntries(MODIFIER_ENTRIES);
-function normalizeKeys(keys) {
-    return asArray(keys).map((key) => key.toLowerCase());
-}
-export function isKey(event, key) {
-    return event.key.toLowerCase() === key.toLowerCase();
-}
-function isKeydown(event) {
-    return event.type === 'keydown';
-}
-function isKeyup(event) {
-    return event.type === 'keyup';
+export function parseKeys(inputKeys) {
+    const [modifiers, keys] = partition(asArray(inputKeys).map((key) => key.toLowerCase()), (key) => MODIFIERS.has(key));
+    return { keys, modifiers };
 }
 function sortModifiers(modifiers) {
     return ALL_MODIFIER_VALUES.filter((mod) => modifiers.includes(mod));
@@ -52,9 +30,18 @@ function getActiveModifiers(event) {
     }
     return active;
 }
+function hasModifiers(event) {
+    return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;
+}
 function createCombinationKey(keys, modifiers) {
     return modifiers.concat(keys.length > 1 ? keys.toSorted() : keys).join('+');
 }
+function isKeydown(event) {
+    return event.type === 'keydown';
+}
+function isKeyup(event) {
+    return event.type === 'keyup';
+}
 class KeyBindingController {
     static { this._defaultOptions = {
         skip: ['input', 'textarea', 'select'],
@@ -67,17 +54,29 @@ class KeyBindingController {
         return this._ref?.value || this._host;
     }
     constructor(host, options) {
-        this._abortHandle = createAbortHandle();
         this._bindings = new Map();
         this._allowedKeys = new Set();
         this._pressedKeys = new Set();
+        const defaults = KeyBindingController._defaultOptions;
+        const skip = options?.skip ?? defaults.skip;
         this._host = host;
         this._ref = options?.ref;
-        this._options = toMerged(KeyBindingController._defaultOptions, options ?? {});
-        if (Array.isArray(this._options.skip)) {
-            this._skipSelector = this._options.skip.join(',');
-        }
-        host.addController(this);
+        this._bindingDefaults = {
+            ...defaults.bindingDefaults,
+            ...options?.bindingDefaults,
+        };
+        if (isFunction(skip)) {
+            this._skipCallback = skip;
+        }
+        else {
+            this._skipSelector = skip.join(',');
+        }
+        addHostListeners(host, { events: ['keyup', 'keydown'], listener: this });
+        addHostListeners(host, {
+            target: globalThis,
+            events: ['blur'],
+            listener: this,
+        });
     }
     _applyEventModifiers(binding, event) {
         if (binding.options?.preventDefault) {
@@ -101,29 +100,28 @@ class KeyBindingController {
         if (!this._allowedKeys.has(key)) {
             return true;
         }
-        const path = event.composedPath();
         const element = this._element;
-        if (!path.some((node) => node === element)) {
-            return true;
-        }
         const selector = this._skipSelector;
-        if (selector) {
-            return path.some((node) => isElement(node) && node.matches(selector));
+        const needsContainmentCheck = element !== this._host;
+        if (needsContainmentCheck || selector) {
+            let reachedElement = false;
+            for (const node of event.composedPath()) {
+                if (node === element) {
+                    reachedElement = true;
+                    break;
+                }
+                if (selector && isElement(node) && node.matches(selector)) {
+                    return true;
+                }
+            }
+            if (needsContainmentCheck && !reachedElement) {
+                return true;
+            }
         }
-        const skip = this._options.skip;
-        return isFunction(skip)
-            ? skip.call(this._host, event.target, event)
+        return this._skipCallback
+            ? this._skipCallback.call(this._host, event.target, event)
             : false;
     }
-    hostConnected() {
-        const { signal } = this._abortHandle;
-        this._host.addEventListener('keyup', this, { signal });
-        this._host.addEventListener('keydown', this, { signal });
-        globalThis.addEventListener('blur', this, { signal });
-    }
-    hostDisconnected() {
-        this._abortHandle.abort();
-    }
     _handleGlobalBlur() {
         this._pressedKeys.clear();
     }
@@ -139,11 +137,17 @@ class KeyBindingController {
         if (!isModifier) {
             this._pressedKeys.add(key);
         }
-        const activeModifiers = getActiveModifiers(event);
-        const combination = createCombinationKey(Array.from(this._pressedKeys), activeModifiers);
-        let binding = this._bindings.get(combination);
-        if (!binding && this._pressedKeys.size > 1) {
-            binding = this._bindings.get(createCombinationKey([key], activeModifiers));
+        let binding;
+        if (!isModifier && !hasModifiers(event) && this._pressedKeys.size === 1) {
+            binding = this._bindings.get(key);
+        }
+        else {
+            const activeModifiers = getActiveModifiers(event);
+            const combination = createCombinationKey(Array.from(this._pressedKeys), activeModifiers);
+            binding = this._bindings.get(combination);
+            if (!binding && this._pressedKeys.size > 1) {
+                binding = this._bindings.get(createCombinationKey([key], activeModifiers));
+            }
         }
         if (binding && this._bindingMatches(binding, event)) {
             this._applyEventModifiers(binding, event);
@@ -167,11 +171,11 @@ class KeyBindingController {
     set(key, handler, bindingOptions) {
         const { keys, modifiers } = parseKeys(key);
         const combination = createCombinationKey(keys, sortModifiers(modifiers));
-        const options = toMerged(this._options.bindingDefaults, bindingOptions ?? {});
+        const options = { ...this._bindingDefaults, ...bindingOptions };
         for (const each of [...keys, ...modifiers]) {
             this._allowedKeys.add(each);
         }
-        this._bindings.set(combination, { keys, handler, options, modifiers });
+        this._bindings.set(combination, { handler, options });
         return this;
     }
     setActivateHandler(handler, options) {
@@ -180,13 +184,14 @@ class KeyBindingController {
         return this;
     }
     observeElement(element) {
-        element.addEventListener('keydown', this);
-        element.addEventListener('keyup', this);
+        const handle = createAbortHandle();
+        const { signal } = handle;
+        element.addEventListener('keydown', this, { signal });
+        element.addEventListener('keyup', this, { signal });
         this._observedElement = element;
         return {
             unsubscribe: () => {
-                element.removeEventListener('keydown', this);
-                element.removeEventListener('keyup', this);
+                handle.abort();
                 if (this._observedElement === element) {
                     this._observedElement = undefined;
                 }
@@ -194,10 +199,6 @@ class KeyBindingController {
         };
     }
 }
-export function parseKeys(inputKeys) {
-    const [modifiers, keys] = partition(normalizeKeys(inputKeys), (key) => MODIFIERS.has(key));
-    return { keys, modifiers };
-}
 export function addKeybindings(element, options) {
     return new KeyBindingController(element, options);
 }

package/internals/controllers/key-bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"key-bindings.js","sourceRoot":"","sources":["../../../src/internals/controllers/key-bindings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\nimport { createAbortHandle } from '../abort-handler.js';\nimport { asArray, partition } from '../utils/arrays.js';\nimport { isElement } from '../utils/dom.js';\nimport { toMerged } from '../utils/objects.js';\nimport { isFunction } from '../utils/types.js';\n\n//#region Keys and modifiers\n\n/* Common keys */\nexport const arrowLeft = 'ArrowLeft' as const;\nexport const arrowRight = 'ArrowRight' as const;\nexport const arrowUp = 'ArrowUp' as const;\nexport const arrowDown = 'ArrowDown' as const;\nexport const enterKey = 'Enter' as const;\nexport const spaceBar = ' ' as const;\nexport const escapeKey = 'Escape' as const;\nexport const homeKey = 'Home' as const;\nexport const endKey = 'End' as const;\nexport const pageUpKey = 'PageUp' as const;\nexport const pageDownKey = 'PageDown' as const;\nexport const tabKey = 'Tab' as const;\n\n/* Modifiers */\nexport const altKey = 'Alt' as const;\nexport const ctrlKey = 'Control' as const;\nexport const metaKey = 'Meta' as const;\nexport const shiftKey = 'Shift' as const;\n\n//#endregion\n\n//#region Types\n\n/* Types */\ntype KeyBindingHandler = (event: KeyboardEvent) => void;\ntype KeyBindingObserverCleanup = { unsubscribe: () => void };\n\n/**\n * Whether the current event should be ignored by the controller.\n *\n * @param node - The event target\n * @param event - The event object\n *\n * When `true` is returned, the current event is ignored.\n */\ntype KeyBindingSkipCallback = (node: Element, event: KeyboardEvent) => boolean;\n\n/**\n * The event type which will trigger the bound handler.\n */\ntype KeyBindingTrigger = 'keydown' | 'keyup';\n\n/**\n * Configuration object for the controller.\n * @hidden\n */\ninterface KeyBindingControllerOptions {\n  /**\n   * By default, the controller listens for keypress events in the context of the host element.\n   * If you pass a `ref`, you can limit the observation to a certain DOM part of the host scope.\n   */\n  ref?: Ref;\n  /**\n   * Option to ignore key press events.\n   *\n   * If passed an array of CSS selectors, it will ignore key presses originating from elements in the event composed path\n   * that match one of the selectors.\n   * Otherwise you can pass a {@link KeyBindingSkipCallback} function.\n   *\n   * Defaults to `['input', 'textarea', 'select']`.\n   *\n   * @example\n   * ```ts\n   * {\n   *  // Skip events originating from elements with `readonly` attribute\n   *  skip: ['[readonly]']\n   * }\n   * ...\n   * {\n   * // Same as above but with a callback\n   *  skip: (node: Element) => node.hasAttribute('readonly')\n   * }\n   * ```\n   */\n  skip?: string[] | KeyBindingSkipCallback;\n  /**\n   * A set of KeyBindingOptions configuration which is applied to every handler\n   * that is added to the controller.\n   *\n   * Any additional KeyBindingOptions values passed when `set` is called\n   * will be merged with `bindingDefaults`.\n   */\n  bindingDefaults?: KeyBindingOptions;\n}\n\n/**\n * Configuration object for customizing the behavior of\n * the registered handler.\n */\ninterface KeyBindingOptions {\n  /**\n   * The event type(s) on which the handler will be invoked.\n   *\n   * Defaults to `keydown` if not set.\n   */\n  triggers?: KeyBindingTrigger[];\n  /**\n   * Whether the handler should fire on auto-repeated keydown events (i.e. when a key is held down).\n   *\n   * Defaults to `false`.\n   */\n  repeat?: boolean;\n  /**\n   * Whether to call `preventDefault` on the target event before the handler is invoked.\n   */\n  preventDefault?: boolean;\n  /**\n   * Whether to call `stopPropagation` on the target event before the handler is invoked.\n   */\n  stopPropagation?: boolean;\n}\n\n/** @hidden */\ninterface KeyBinding {\n  keys: string[];\n  handler: KeyBindingHandler;\n  options?: KeyBindingOptions;\n  modifiers: string[];\n}\n\n//#endregion\n\n//#region Internal functions and constants\n\n/**\n * Every modifier, paired with the `KeyboardEvent` boolean property it is read\n * from - `ctrlKey` is the property for the `'control'` modifier, not `'controlKey'`.\n *\n * Kept in alphabetical order: combination keys sort their modifiers, and every\n * derived collection below inherits that order for free.\n */\nconst MODIFIER_ENTRIES = [\n  ['alt', 'altKey'],\n  ['control', 'ctrlKey'],\n  ['meta', 'metaKey'],\n  ['shift', 'shiftKey'],\n] as const satisfies ReadonlyArray<readonly [string, keyof KeyboardEvent]>;\n\nconst ALL_MODIFIER_VALUES = MODIFIER_ENTRIES.map(([name]) => name);\nconst MODIFIERS = new Set<string>(ALL_MODIFIER_VALUES);\n\n/** {@link MODIFIER_ENTRIES} as a lookup of modifier name to event property. */\nexport const MODIFIER_EVENT_KEYS: Record<string, string> =\n  Object.fromEntries(MODIFIER_ENTRIES);\n\nfunction normalizeKeys(keys: string | string[]): string[] {\n  return asArray(keys).map((key) => key.toLowerCase());\n}\n\n/**\n * Whether the event's key matches `key`, case-insensitively. Prefer this over\n * comparing `event.key` directly - the key names of this module are lowercase,\n * while real events carry the canonical casing (e.g. `Enter`).\n */\nexport function isKey(event: KeyboardEvent, key: string): boolean {\n  return event.key.toLowerCase() === key.toLowerCase();\n}\n\nfunction isKeydown(event: Event): boolean {\n  return event.type === 'keydown';\n}\n\nfunction isKeyup(event: Event): boolean {\n  return event.type === 'keyup';\n}\n\n/** Sorts `modifiers` alphabetically, by filtering the already sorted source. */\nfunction sortModifiers(modifiers: string[]): string[] {\n  return ALL_MODIFIER_VALUES.filter((mod) => modifiers.includes(mod));\n}\n\n/** Returns the modifiers active for `event`, already sorted. */\nfunction getActiveModifiers(event: KeyboardEvent): string[] {\n  const active: string[] = [];\n\n  for (const [name, property] of MODIFIER_ENTRIES) {\n    if (event[property]) {\n      active.push(name);\n    }\n  }\n\n  return active;\n}\n\n/**\n * Creates a normalized combination key string from the provided keys and modifiers.\n *\n * The combination key is a string that uniquely identifies a specific combination of keys and modifiers.\n * It is created by sorting the keys and modifiers alphabetically and joining them with a '+' separator.\n *\n * `modifiers` must already be sorted - see {@link sortModifiers} and {@link getActiveModifiers}.\n */\nfunction createCombinationKey(keys: string[], modifiers: string[]): string {\n  return modifiers.concat(keys.length > 1 ? keys.toSorted() : keys).join('+');\n}\n\n//#endregion\n\n/**\n * A controller for managing key bindings on a host element. It allows you to register handlers for specific key combinations,\n * with support for modifier keys and event options such as `preventDefault` and `stopPropagation`.\n *\n * The controller listens for keyboard events on the host element (or an optionally specified element) and invokes the appropriate handlers\n * when the registered key combinations are detected.\n * @hidden\n */\nclass KeyBindingController implements ReactiveController {\n  //#region Private properties and state\n\n  private static readonly _defaultOptions: KeyBindingControllerOptions = {\n    skip: ['input', 'textarea', 'select'],\n    bindingDefaults: { preventDefault: true },\n  };\n\n  private readonly _host: ReactiveControllerHost & Element;\n  private readonly _ref?: Ref;\n  private readonly _abortHandle = createAbortHandle();\n\n  private readonly _bindings = new Map<string, KeyBinding>();\n  private readonly _allowedKeys = new Set<string>();\n  private readonly _pressedKeys = new Set<string>();\n\n  private readonly _options: KeyBindingControllerOptions;\n  private readonly _skipSelector: string | undefined;\n\n  private _observedElement?: Element;\n\n  private get _element(): Element {\n    if (this._observedElement) {\n      return this._observedElement;\n    }\n    return this._ref?.value || this._host;\n  }\n\n  //#endregion\n\n  constructor(\n    host: ReactiveControllerHost & Element,\n    options?: KeyBindingControllerOptions\n  ) {\n    this._host = host;\n    this._ref = options?.ref;\n    this._options = toMerged(\n      KeyBindingController._defaultOptions,\n      options ?? {}\n    );\n\n    if (Array.isArray(this._options.skip)) {\n      this._skipSelector = this._options.skip.join(',');\n    }\n\n    host.addController(this);\n  }\n\n  //#region Private API\n\n  /**\n   * Applies the event modifiers specified in the binding options to the provided keyboard event.\n   * If `preventDefault` is set, it calls `event.preventDefault()`.\n   * If `stopPropagation` is set, it calls `event.stopPropagation()`.\n   */\n  private _applyEventModifiers(\n    binding: KeyBinding,\n    event: KeyboardEvent\n  ): void {\n    if (binding.options?.preventDefault) {\n      event.preventDefault();\n    }\n\n    if (binding.options?.stopPropagation) {\n      event.stopPropagation();\n    }\n  }\n\n  /**\n   * Determines whether the provided keyboard event matches the specified key binding,\n   * taking into account the event type and the binding's trigger options.\n   */\n  private _bindingMatches(binding: KeyBinding, event: KeyboardEvent): boolean {\n    const triggers = binding.options?.triggers ?? ['keydown'];\n\n    if (isKeydown(event) && triggers.includes('keydown')) {\n      return !event.repeat || Boolean(binding.options?.repeat);\n    }\n\n    if (isKeyup(event) && triggers.includes('keyup')) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Determines whether the provided event should be ignored based on the controller's configuration and the event's context.\n   * The method checks if the event's key is among the allowed keys, if the event originated from within the controller's scope,\n   * and if it matches any of the skip conditions defined in the controller's options.\n   */\n  private _shouldSkip(event: KeyboardEvent, key: string): boolean {\n    if (!this._allowedKeys.has(key)) {\n      return true;\n    }\n\n    const path = event.composedPath();\n    const element = this._element;\n\n    if (!path.some((node) => node === element)) {\n      return true;\n    }\n\n    const selector = this._skipSelector;\n\n    if (selector) {\n      return path.some((node) => isElement(node) && node.matches(selector));\n    }\n\n    const skip = this._options.skip;\n\n    return isFunction(skip)\n      ? skip.call(this._host, event.target as Element, event)\n      : false;\n  }\n\n  //#endregion\n\n  //#region Controller lifecycle\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n    this._host.addEventListener('keyup', this, { signal });\n    this._host.addEventListener('keydown', this, { signal });\n    globalThis.addEventListener('blur', this, { signal });\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  //#endregion\n\n  //#region Event handling\n\n  /**\n   * Handles the global blur event to clear the internal state of pressed keys.\n   *\n   * This is necessary to prevent \"stuck\" keys when the user switches to another application\n   * or tab while holding down a key.\n   */\n  private _handleGlobalBlur(): void {\n    this._pressedKeys.clear();\n  }\n\n  /**\n   * Handles keyboard events on the observed element.\n   *\n   * It checks if the event should be skipped based on the controller's configuration,\n   * and if not, it determines if there is a registered handler for the combination of pressed keys and active modifiers.\n   *\n   * If a matching handler is found, it applies the specified event modifiers and invokes the handler.\n   * It also manages the internal state of currently pressed keys to accurately detect key combinations.\n   *\n   */\n  private _handleKeyEvent(event: KeyboardEvent): void {\n    const key = event.key.toLowerCase();\n    const isModifier = MODIFIERS.has(key);\n\n    if (this._shouldSkip(event, key)) {\n      // Always clean up on keyup regardless of whether the event is otherwise skipped.\n      if (!isModifier && isKeyup(event)) {\n        this._pressedKeys.delete(key);\n      }\n      return;\n    }\n\n    if (!isModifier) {\n      this._pressedKeys.add(key);\n    }\n\n    const activeModifiers = getActiveModifiers(event);\n\n    const combination = createCombinationKey(\n      Array.from(this._pressedKeys),\n      activeModifiers\n    );\n    let binding = this._bindings.get(combination);\n\n    // When multiple non-modifier keys are simultaneously in _pressedKeys (due to overlapping\n    // key presses, e.g. pressing ArrowUp before ArrowDown's keyup fires), the full combination\n    // won't match any single-key binding. Fall back to just the current key + modifiers so that\n    // single-key bindings continue to fire even when other keys are still \"held\".\n    if (!binding && this._pressedKeys.size > 1) {\n      binding = this._bindings.get(\n        createCombinationKey([key], activeModifiers)\n      );\n    }\n\n    if (binding && this._bindingMatches(binding, event)) {\n      this._applyEventModifiers(binding, event);\n      binding.handler.call(this._host, event);\n    }\n\n    if (!isModifier && isKeyup(event)) {\n      this._pressedKeys.delete(key);\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: KeyboardEvent | FocusEvent): void {\n    switch (event.type) {\n      case 'keydown':\n      case 'keyup':\n        this._handleKeyEvent(event as KeyboardEvent);\n        break;\n      case 'blur':\n        this._handleGlobalBlur();\n        break;\n    }\n  }\n\n  //#endregion\n\n  //#region Public API\n\n  /**\n   * Registers a key binding with the specified key(s), handler function, and optional configuration.\n   *\n   * The `key` parameter can be a single key or an array of keys, and can include modifier keys (e.g., 'ctrl+s', ['shift', 'a']).\n   * The `handler` is a function that will be called when the specified key combination is detected.\n   * The `bindingOptions` allow you to customize the behavior of the binding, such as which event types trigger the handler,\n   * whether it should fire on auto-repeated keydown events, and whether to call `preventDefault` or `stopPropagation`.\n   *\n   * The method returns the controller instance to allow for method chaining.\n   */\n  public set(\n    key: string | string[],\n    handler: KeyBindingHandler,\n    bindingOptions?: KeyBindingOptions\n  ): this {\n    const { keys, modifiers } = parseKeys(key);\n    const combination = createCombinationKey(keys, sortModifiers(modifiers));\n    const options = toMerged(\n      this._options.bindingDefaults!,\n      bindingOptions ?? {}\n    );\n\n    for (const each of [...keys, ...modifiers]) {\n      this._allowedKeys.add(each);\n    }\n\n    this._bindings.set(combination, { keys, handler, options, modifiers });\n\n    return this;\n  }\n\n  /**\n   * Registers the provided handler function to be called when either the Enter key or Space bar is pressed.\n   *\n   * This is a common pattern for activating buttons or interactive elements, and this method provides a convenient way to set up such bindings.\n   *\n   * The method accepts optional `KeyBindingOptions` which are applied to both the Enter key and Space bar bindings.\n   * It returns the controller instance to allow for method chaining.\n   *\n   */\n  public setActivateHandler(\n    handler: KeyBindingHandler,\n    options?: KeyBindingOptions\n  ): this {\n    this.set(enterKey, handler, options);\n    this.set(spaceBar, handler, options);\n\n    return this;\n  }\n\n  /**\n   * Sets the controller to listen for keyboard events on an arbitrary `element` in the page context.\n   * All the configuration and event handlers are applied as well.\n   *\n   * Returns an object with an `unsubscribe` function which should be called when the observing of keyboard\n   * events on the `element` should cease.\n   */\n  public observeElement(element: Element): KeyBindingObserverCleanup {\n    element.addEventListener('keydown', this);\n    element.addEventListener('keyup', this);\n    this._observedElement = element;\n\n    return {\n      unsubscribe: () => {\n        element.removeEventListener('keydown', this);\n        element.removeEventListener('keyup', this);\n        if (this._observedElement === element) {\n          this._observedElement = undefined;\n        }\n      },\n    };\n  }\n\n  //#endregion\n}\n\n/**\n * Parses the provided key(s) and separates them into modifiers and regular keys.\n *\n * Modifiers are keys like Alt, Ctrl, Meta and Shift which modify the behavior of other keys when pressed in combination.\n * Regular keys are all other keys which trigger the bound handler when pressed.\n *\n * The returned `keys` and `modifiers` are normalized to lowercase for consistency.\n *\n * @internal\n *\n * @param inputKeys - The key or keys to parse, provided as a string or an array of strings.\n * @returns An object containing the separated `keys` and `modifiers`.\n */\nexport function parseKeys(inputKeys: string | string[]): {\n  keys: string[];\n  modifiers: string[];\n} {\n  const [modifiers, keys] = partition(normalizeKeys(inputKeys), (key) =>\n    MODIFIERS.has(key)\n  );\n  return { keys, modifiers };\n}\n\n/**\n * Controller factory function which creates a {@link KeyBindingController} instance and attaches it to the provided host.\n *\n * @param element - The host element to which the controller will be attached.\n * @param options - Optional configuration for the controller.\n * @returns The created {@link KeyBindingController} instance.\n *\n * @example\n * ```ts\n * class MyComponent extends LitElement {\n *   private _keyBindings = addKeybindings(this, {\n *     skip: ['input', 'textarea'], // Optional: Skip key events originating from these elements\n *     bindingDefaults: { preventDefault: true }, // Optional: Default options for all bindings\n *   });\n *\n *   constructor() {\n *     super();\n *     this._keyBindings.set('ctrl+s', this._handleSave); // Register a key binding\n *   }\n * ```\n */\nexport function addKeybindings(\n  element: ReactiveControllerHost & Element,\n  options?: KeyBindingControllerOptions\n): KeyBindingController {\n  return new KeyBindingController(element, options);\n}\n\nexport type {\n  KeyBindingController,\n  KeyBindingControllerOptions,\n  KeyBindingHandler,\n  KeyBindingObserverCleanup,\n  KeyBindingOptions,\n  KeyBindingSkipCallback,\n  KeyBindingTrigger,\n};\n"]}
+{"version":3,"file":"key-bindings.js","sourceRoot":"","sources":["../../../src/internals/controllers/key-bindings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveControllerHost } from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\nimport { createAbortHandle } from '../abort-handler.js';\nimport { asArray, partition } from '../utils/arrays.js';\nimport { isElement } from '../utils/dom.js';\nimport { isFunction } from '../utils/types.js';\nimport { addHostListeners } from './host-listeners.js';\nimport { enterKey, spaceBar } from './keys.js';\n\n// Re-exported from `./keys.js`, so a consumer keeps a single import.\nexport * from './keys.js';\n\n//#region Modifiers and combination keys\n\n/**\n * Each modifier and the `KeyboardEvent` property it reads; `control` maps to\n * `ctrlKey`. The alphabetical order is what a combination key inherits.\n */\nconst MODIFIER_ENTRIES = [\n  ['alt', 'altKey'],\n  ['control', 'ctrlKey'],\n  ['meta', 'metaKey'],\n  ['shift', 'shiftKey'],\n] as const satisfies ReadonlyArray<readonly [string, keyof KeyboardEvent]>;\n\nconst ALL_MODIFIER_VALUES = MODIFIER_ENTRIES.map(([name]) => name);\nconst MODIFIERS = new Set<string>(ALL_MODIFIER_VALUES);\n\n/**\n * {@link MODIFIER_ENTRIES} as a name to event property lookup.\n * @internal Used by the keyboard simulation helper of the test suite.\n */\nexport const MODIFIER_EVENT_KEYS: Record<string, string> =\n  Object.fromEntries(MODIFIER_ENTRIES);\n\n/**\n * Splits the keys into modifiers (Alt, Control, Meta, Shift) and normal keys,\n * in lower case.\n *\n * @internal\n */\nexport function parseKeys(inputKeys: string | string[]): {\n  keys: string[];\n  modifiers: string[];\n} {\n  const [modifiers, keys] = partition(\n    asArray(inputKeys).map((key) => key.toLowerCase()),\n    (key) => MODIFIERS.has(key)\n  );\n  return { keys, modifiers };\n}\n\n/** Sorts `modifiers` alphabetically. */\nfunction sortModifiers(modifiers: string[]): string[] {\n  return ALL_MODIFIER_VALUES.filter((mod) => modifiers.includes(mod));\n}\n\n/** Returns the modifiers active for `event`, already sorted. */\nfunction getActiveModifiers(event: KeyboardEvent): string[] {\n  const active: string[] = [];\n\n  for (const [name, property] of MODIFIER_ENTRIES) {\n    if (event[property]) {\n      active.push(name);\n    }\n  }\n\n  return active;\n}\n\n/** Whether `event` carries at least one active modifier. */\nfunction hasModifiers(event: KeyboardEvent): boolean {\n  return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;\n}\n\n/**\n * Joins keys and modifiers into a `+` separated combination key, sorted\n * alphabetically. `modifiers` must already be sorted; see\n * {@link sortModifiers} and {@link getActiveModifiers}.\n */\nfunction createCombinationKey(keys: string[], modifiers: string[]): string {\n  return modifiers.concat(keys.length > 1 ? keys.toSorted() : keys).join('+');\n}\n\n//#endregion\n\n//#region Types\n\ntype KeyBindingHandler = (event: KeyboardEvent) => void;\ntype KeyBindingObserverCleanup = { unsubscribe: () => void };\n\n/**\n * Whether the controller must ignore the current event.\n *\n * @param node - The target of the event.\n * @param event - The event.\n */\ntype KeyBindingSkipCallback = (node: Element, event: KeyboardEvent) => boolean;\n\n/** The event type that starts the bound handler. */\ntype KeyBindingTrigger = 'keydown' | 'keyup';\n\n/** @hidden */\ninterface KeyBindingControllerOptions {\n  /** The element to observe. Defaults to the host element. */\n  ref?: Ref;\n  /**\n   * The key presses that the controller ignores. CSS selectors match against\n   * the composed path of the event; a {@link KeyBindingSkipCallback} decides\n   * per event instead. Defaults to `['input', 'textarea', 'select']`.\n   *\n   * @example\n   * ```ts\n   * {\n   *  // Skip events originating from elements with `readonly` attribute\n   *  skip: ['[readonly]']\n   * }\n   * ...\n   * {\n   * // Same as above but with a callback\n   *  skip: (node: Element) => node.hasAttribute('readonly')\n   * }\n   * ```\n   */\n  skip?: string[] | KeyBindingSkipCallback;\n  /** Default options for every binding. A `set` call merges over them. */\n  bindingDefaults?: KeyBindingOptions;\n}\n\ninterface KeyBindingOptions {\n  /** The event types that start the handler. Defaults to `keydown`. */\n  triggers?: KeyBindingTrigger[];\n  /** Whether the handler runs for a repeated keydown. Defaults to `false`. */\n  repeat?: boolean;\n  /** Whether to call `preventDefault` before the handler runs. */\n  preventDefault?: boolean;\n  /** Whether to call `stopPropagation` before the handler runs. */\n  stopPropagation?: boolean;\n}\n\n/** A registered binding. The key of the binding map holds the combination. */\ninterface KeyBinding {\n  handler: KeyBindingHandler;\n  options?: KeyBindingOptions;\n}\n\n//#endregion\n\n//#region Internal functions and constants\n\nfunction isKeydown(event: Event): boolean {\n  return event.type === 'keydown';\n}\n\nfunction isKeyup(event: Event): boolean {\n  return event.type === 'keyup';\n}\n\n//#endregion\n\n/**\n * Manages the key bindings of a host element.\n * @hidden\n */\nclass KeyBindingController {\n  //#region Private properties and state\n\n  /** Base configuration, shared between instances. Never written to. */\n  private static readonly _defaultOptions = {\n    skip: ['input', 'textarea', 'select'],\n    bindingDefaults: { preventDefault: true },\n  } satisfies KeyBindingControllerOptions;\n\n  private readonly _host: ReactiveControllerHost & Element;\n  private readonly _ref?: Ref;\n\n  private readonly _bindings = new Map<string, KeyBinding>();\n  private readonly _allowedKeys = new Set<string>();\n  private readonly _pressedKeys = new Set<string>();\n\n  private readonly _bindingDefaults: KeyBindingOptions;\n  private readonly _skipSelector?: string;\n  private readonly _skipCallback?: KeyBindingSkipCallback;\n\n  private _observedElement?: Element;\n\n  private get _element(): Element {\n    if (this._observedElement) {\n      return this._observedElement;\n    }\n    return this._ref?.value || this._host;\n  }\n\n  //#endregion\n\n  constructor(\n    host: ReactiveControllerHost & Element,\n    options?: KeyBindingControllerOptions\n  ) {\n    const defaults = KeyBindingController._defaultOptions;\n    const skip = options?.skip ?? defaults.skip;\n\n    this._host = host;\n    this._ref = options?.ref;\n\n    // Host options merge over the defaults instead of replacing them.\n    this._bindingDefaults = {\n      ...defaults.bindingDefaults,\n      ...options?.bindingDefaults,\n    };\n\n    if (isFunction(skip)) {\n      this._skipCallback = skip;\n    } else {\n      this._skipSelector = skip.join(',');\n    }\n\n    addHostListeners(host, { events: ['keyup', 'keydown'], listener: this });\n    addHostListeners(host, {\n      target: globalThis,\n      events: ['blur'],\n      listener: this,\n    });\n  }\n\n  //#region Private API\n\n  /** Applies the event options of the binding to the keyboard event. */\n  private _applyEventModifiers(\n    binding: KeyBinding,\n    event: KeyboardEvent\n  ): void {\n    if (binding.options?.preventDefault) {\n      event.preventDefault();\n    }\n\n    if (binding.options?.stopPropagation) {\n      event.stopPropagation();\n    }\n  }\n\n  /** Whether the event type matches the triggers of the binding. */\n  private _bindingMatches(binding: KeyBinding, event: KeyboardEvent): boolean {\n    const triggers = binding.options?.triggers ?? ['keydown'];\n\n    if (isKeydown(event) && triggers.includes('keydown')) {\n      return !event.repeat || Boolean(binding.options?.repeat);\n    }\n\n    if (isKeyup(event) && triggers.includes('keyup')) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Whether to ignore the event. The key has no binding, the event missed the\n   * observed element, or the skip configuration agrees.\n   */\n  private _shouldSkip(event: KeyboardEvent, key: string): boolean {\n    if (!this._allowedKeys.has(key)) {\n      return true;\n    }\n\n    const element = this._element;\n    const selector = this._skipSelector;\n\n    // The host carries the listeners. Only a `ref` puts the observed element\n    // deeper in the tree, where the path must confirm containment.\n    const needsContainmentCheck = element !== this._host;\n\n    if (needsContainmentCheck || selector) {\n      // The path runs target first, so the scan stops at the observed element.\n      let reachedElement = false;\n\n      for (const node of event.composedPath()) {\n        if (node === element) {\n          reachedElement = true;\n          break;\n        }\n\n        if (selector && isElement(node) && node.matches(selector)) {\n          return true;\n        }\n      }\n\n      if (needsContainmentCheck && !reachedElement) {\n        return true;\n      }\n    }\n\n    return this._skipCallback\n      ? this._skipCallback.call(this._host, event.target as Element, event)\n      : false;\n  }\n\n  //#endregion\n\n  //#region Event handling\n\n  /**\n   * Clears the pressed keys on a global blur. No keyup arrives if the user\n   * moves to a different application or tab with a key down.\n   */\n  private _handleGlobalBlur(): void {\n    this._pressedKeys.clear();\n  }\n\n  /** Handles a keyboard event on the observed element. */\n  private _handleKeyEvent(event: KeyboardEvent): void {\n    const key = event.key.toLowerCase();\n    const isModifier = MODIFIERS.has(key);\n\n    if (this._shouldSkip(event, key)) {\n      // A keyup always cleans up the key, also for an event that it skips.\n      if (!isModifier && isKeyup(event)) {\n        this._pressedKeys.delete(key);\n      }\n      return;\n    }\n\n    if (!isModifier) {\n      this._pressedKeys.add(key);\n    }\n\n    let binding: KeyBinding | undefined;\n\n    if (!isModifier && !hasModifiers(event) && this._pressedKeys.size === 1) {\n      // Fast path: one key, no modifier. The combination is the key itself,\n      // so the lookup builds no arrays or strings.\n      binding = this._bindings.get(key);\n    } else {\n      const activeModifiers = getActiveModifiers(event);\n\n      const combination = createCombinationKey(\n        Array.from(this._pressedKeys),\n        activeModifiers\n      );\n      binding = this._bindings.get(combination);\n\n      // Overlapping presses leave several regular keys down, so the full\n      // combination matches no single-key binding. Fall back to the current\n      // key, so its binding still runs while another key stays down.\n      if (!binding && this._pressedKeys.size > 1) {\n        binding = this._bindings.get(\n          createCombinationKey([key], activeModifiers)\n        );\n      }\n    }\n\n    if (binding && this._bindingMatches(binding, event)) {\n      this._applyEventModifiers(binding, event);\n      binding.handler.call(this._host, event);\n    }\n\n    if (!isModifier && isKeyup(event)) {\n      this._pressedKeys.delete(key);\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: KeyboardEvent | FocusEvent): void {\n    switch (event.type) {\n      case 'keydown':\n      case 'keyup':\n        this._handleKeyEvent(event as KeyboardEvent);\n        break;\n      case 'blur':\n        this._handleGlobalBlur();\n        break;\n    }\n  }\n\n  //#endregion\n\n  //#region Public API\n\n  /**\n   * Registers a binding for a key or a combination, such as `['shift', 'a']`.\n   * Returns the controller, for chaining.\n   */\n  public set(\n    key: string | string[],\n    handler: KeyBindingHandler,\n    bindingOptions?: KeyBindingOptions\n  ): this {\n    const { keys, modifiers } = parseKeys(key);\n    const combination = createCombinationKey(keys, sortModifiers(modifiers));\n    const options = { ...this._bindingDefaults, ...bindingOptions };\n\n    for (const each of [...keys, ...modifiers]) {\n      this._allowedKeys.add(each);\n    }\n\n    this._bindings.set(combination, { handler, options });\n\n    return this;\n  }\n\n  /**\n   * Registers `handler` for both the Enter key and the Space bar. Returns the\n   * controller, for chaining.\n   */\n  public setActivateHandler(\n    handler: KeyBindingHandler,\n    options?: KeyBindingOptions\n  ): this {\n    this.set(enterKey, handler, options);\n    this.set(spaceBar, handler, options);\n\n    return this;\n  }\n\n  /**\n   * Listens for keyboard events on any page element, with the configuration\n   * and the handlers of this controller. Call `unsubscribe` to stop.\n   */\n  public observeElement(element: Element): KeyBindingObserverCleanup {\n    const handle = createAbortHandle();\n    const { signal } = handle;\n\n    element.addEventListener('keydown', this, { signal });\n    element.addEventListener('keyup', this, { signal });\n    this._observedElement = element;\n\n    return {\n      unsubscribe: () => {\n        handle.abort();\n\n        if (this._observedElement === element) {\n          this._observedElement = undefined;\n        }\n      },\n    };\n  }\n\n  //#endregion\n}\n\n/**\n * Creates a {@link KeyBindingController}, and adds it to the given host.\n *\n * @param element - The host element of the controller.\n * @param options - The configuration of the controller.\n * @returns The new controller.\n *\n * @example\n * ```ts\n * class MyComponent extends LitElement {\n *   // `skip` ignores the key presses that come from these elements.\n *   // `bindingDefaults` applies to each binding of the controller.\n *   private _keyBindings = addKeybindings(this, {\n *     skip: ['input', 'textarea'],\n *     bindingDefaults: { preventDefault: true },\n *   });\n *\n *   constructor() {\n *     super();\n *     // A combination is an array of key names, not one joined string.\n *     this._keyBindings.set([ctrlKey, 's'], this._handleSave);\n *   }\n * }\n * ```\n */\nexport function addKeybindings(\n  element: ReactiveControllerHost & Element,\n  options?: KeyBindingControllerOptions\n): KeyBindingController {\n  return new KeyBindingController(element, options);\n}\n\nexport type {\n  KeyBindingController,\n  KeyBindingControllerOptions,\n  KeyBindingHandler,\n  KeyBindingObserverCleanup,\n  KeyBindingOptions,\n  KeyBindingSkipCallback,\n  KeyBindingTrigger,\n};\n"]}