npm - umbr-key-master - Versions diffs - 1.0.4 → 1.0.6 - Mend

umbr-key-master 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md +47 -107
package/dist/index.d.ts +19 -31
package/dist/index.d.ts.map +1 -0
package/dist/index.js +65 -47
package/dist/index.js.map +1 -1
package/dist/types.d.ts +20 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +2 -0
package/dist/types.js.map +1 -0
package/dist/w3ckeyAttributeValues.d.ts +1 -0
package/dist/w3ckeyAttributeValues.d.ts.map +1 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,120 +1,60 @@
 # KeyMaster
-`KeyMaster` is a TypeScript library for managing complex keyboard shortcuts and key combinations in the browser. It allows you to register callbacks for specific key sequences, supporting all W3C/DOM-standard key values.
----
-## Features
-* **Multi-Key Support**: Listen to single keys or complex combinations (e.g., `Ctrl + Shift + S`).
-* **Standard Compliant**: Supports all standard key types defined by the W3C UI Events spec:
-* **Alphabet keys** (A-Z)
-* **Control keys** (Enter, Escape, Backspace)
-* **Modifier keys** (Shift, Ctrl, Alt, Meta)
-* **Navigation keys** (Arrow keys, Home, End)
-* **Function keys** (F1-F12)
-* **Multimedia & Device keys**
-* **Contextual Data**: Pass custom data or state to your callbacks automatically.
-* **Memory Safe**: Simple `dispose()` method to clean up event listeners and prevent memory leaks.
----
-## Installation
+A lightweight, type-safe TypeScript library for managing complex keyboard shortcuts and multi-key combinations in the browser.
 ```bash
-npm install umbr-key-master
+npm i umbr-key-master
 ```
----
-## Usage
-```typescript
-import { KeyMaster, PressableKey } from "umbr-key-master";
+# Example usage
+```html
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>KeyMaster Popup Test</title>
+  </head>
+  <body>
+    <h1>KeyMaster Popup Test</h1>
+    <p>Press the keys below to see popups:</p>
+    <ul>
+      <li>Escape → Alert "Escape key pressed!"</li>
+      <li>Control + q → Alert "Control + q pressed!"</li>
+    </ul>
+    <script type="module">
+      import { KeyMaster } from "../dist/index.js";
+      const km = new KeyMaster();
+      // ---- Single key: Escape ----
+      km.add(["Escape"], () => {
+        alert("Escape key pressed!");
+      });
+      // ---- Multi-key: Control + S ----
+      km.add(["Control", "q"], () => {
+        alert("Control + q pressed!");
+      });
+    </script>
+  </body>
+</html>
+```
-// 1. (Optional) Define a function to provide context/data to your callbacks
-const getContext = () => ({
-  timestamp: Date.now(),
-  activeEditor: "main-text-area"
-});
+```js
+import { KeyMaster } from "umbr-key-master";
-// 2. Initialize KeyMaster
-const km = new KeyMaster(getContext);
+const km = new KeyMaster();
-// 3. Register a key combination (e.g., Shift + A)
-// Note: Key strings match W3C "key" values
-km.add(["Shift", "a"], (data) => {
-  console.log("Combination triggered!", data);
+// ---- Single key: Escape ----
+km.add(["Escape"], () => {
+  alert("Escape key pressed!");
 });
-// 4. Register a single key callback
-km.add(["Enter"], () => {
-  console.log("Enter key was pressed");
+// ---- Multi-key: Control + S ----
+km.add(["Control", "q"], () => {
+  alert("Control + q pressed!");
 });
-// 5. Removing a callback
-const myCallback = () => console.log("Temporary shortcut");
-km.add(["Control", "s"], myCallback);
-// Later...
-km.remove(myCallback);
-// 6. Clean up when the component or page is destroyed
-km.dispose();
 ```
----
-## API Reference
-### `constructor(getDataFunc?: GetDataCallback)`
-Initializes the listener.
-* **`getDataFunc`**: (Optional) A sync or async function. The return value of this function is passed as the first argument to every triggered callback.
-### `add(targetKeys: PressableKey[], callback: KeyCallback): void`
-Registers a callback to a specific combination.
-* **`targetKeys`**: An array of `PressableKey` strings. The order does not matter as the library sorts them internally.
-* **`callback`**: The function to run when all keys in the array (and *only* those keys) are held down.
-### `remove(callback: KeyCallback): void`
-Unregisters a specific callback function from all key combinations it was assigned to.
-### `dispose(): void`
-Removes the `keydown` and `keyup` listeners from the `document` and clears all internal maps. Use this during component unmounting or page transitions.
----
-## Supported Key Categories
-The library utilizes the full W3C UI Events key set. Common categories include:
-| Category | Examples |
-| --- | --- |
-| **Modifiers** | `Shift`, `Control`, `Alt`, `Meta` |
-| **Navigation** | `ArrowUp`, `ArrowDown`, `Home`, `PageUp` |
-| **Editing** | `Backspace`, `Delete`, `Enter`, `Tab` |
-| **UI Control** | `Escape`, `ContextMenu`, `Pause` |
-| **Functions** | `F1` through `F20` |
----
-## License
-MIT © Yousaf Wazir
-# Building
-- Change version up - push git change
-- Run `npm run build`
-- Run `npm run pubish`

package/dist/index.d.ts CHANGED Viewed

@@ -1,49 +1,36 @@
-import { DeviceKey, EditingKey, FunctionKey, GlyphModifierKey, ModifierKey, NavigationKey, SpecialKey, UIEventUnicodeKey, UIKey, UnicodeControlKey, WhitespaceKey } from "./w3ckeyAttributeValues";
-/**
- * Additional options for the KeyMaster instance.
- */
-export type KeyMasterOptions = {
-    /**
-     * If true, key comparisons will ignore casing (e.g., 'A' and 'a' are treated as the same key).
-     * @default false
-     */
-    caseInsensitive?: boolean;
-};
-/**
- * A function used to retrieve custom data passed to callbacks when conditions are met.
- */
-export type GetDataCallback = (() => any | Promise<any>) | null;
-/**
- * Union type of valid key values mapped from the W3C UI Events / DOM specification.
- */
-export type PressableKey = UIEventUnicodeKey | UnicodeControlKey | GlyphModifierKey | SpecialKey | ModifierKey | WhitespaceKey | NavigationKey | EditingKey | UIKey | DeviceKey | FunctionKey;
-/**
- * A callback function executed when registered key combinations are triggered.
- */
-export type KeyCallback = (data: any) => any | Promise<any>;
+import type types = require("./types");
 /**
  * Manages keyboard shortcuts and multi-key combinations.
- * Supports case-insensitive matching and contextual data injection.
  */
 export declare class KeyMaster {
-    private _getData;
+    /** Holds list of keys pressed */
     private readonly _keys;
+    /** Holds a list of callbacks to run */
     private readonly _callbacks;
+    /** Options for `this` keymaster */
     private _options;
     /**
-     * @param getDataFunc - Optional helper to provide data to callbacks.
      * @param options - Configuration options for key handling.
      */
-    constructor(getDataFunc?: GetDataCallback, options?: KeyMasterOptions);
+    constructor(options?: types.KeyMasterOptions);
     /**
      * Normalizes an array of keys into a sorted string ID.
-     * Handles case normalization if caseInsensitive is enabled.
      */
     private makeKey;
     private handleKeyDown;
     private handleKeyUp;
     /**
-     * Executes a list of callbacks with injected data.
+     * Clears all pressed keys when window loses focus.
+     * This prevents keys from getting "stuck" when DevTools or other windows are opened.
+     */
+    private handleBlur;
+    /**
+     * Clears all pressed keys when document becomes hidden.
+     * This handles cases where the page loses visibility.
+     */
+    private handleVisibilityChange;
+    /**
+     * Executes a list of callbacks.
      */
     private run;
     /**
@@ -51,13 +38,14 @@ export declare class KeyMaster {
      * @param targetKeys - Array of keys (e.g., ["Control", "S"]).
      * @param callback - Function to trigger.
      */
-    add(targetKeys: PressableKey[], callback: KeyCallback): void;
+    add(targetKeys: types.PressableKey[], callback: types.KeyCallback): void;
     /**
      * Removes a callback from all registered combinations.
      */
-    remove(callback: KeyCallback): void;
+    remove(callback: types.KeyCallback): void;
     /**
      * Cleans up event listeners and internal state.
      */
     dispose(): void;
 }
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,KAAK,GAAG,QAAQ,SAAS,CAAC,CAAC;AAEvC;;GAEG;AACH,qBAAa,SAAS;IACpB,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+C;IAE1E,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;OAEG;gBACS,OAAO,GAAE,KAAK,CAAC,gBAAqB;IAgBhD;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,aAAa,CAsBnB;IAEF,OAAO,CAAC,WAAW,CAMjB;IAEF;;;OAGG;IACH,OAAO,CAAC,UAAU,CAEhB;IAEF;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAI5B;IAEF;;OAEG;YACW,GAAG;IAMjB;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI;IAUxE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI;IAYzC;;OAEG;IACH,OAAO,IAAI,IAAI;CAWhB"}

package/dist/index.js CHANGED Viewed

@@ -1,68 +1,84 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 /**
  * Manages keyboard shortcuts and multi-key combinations.
- * Supports case-insensitive matching and contextual data injection.
  */
 export class KeyMaster {
+    /** Holds list of keys pressed */
+    _keys = new Set();
+    /** Holds a list of callbacks to run */
+    _callbacks = new Map();
+    /** Options for `this` keymaster */
+    _options;
     /**
-     * @param getDataFunc - Optional helper to provide data to callbacks.
      * @param options - Configuration options for key handling.
      */
-    constructor(getDataFunc = null, options = {}) {
-        this._getData = null;
-        this._keys = new Set();
-        this._callbacks = new Map();
-        this.handleKeyDown = (event) => {
-            const keyToStore = this._options.caseInsensitive
-                ? event.key.toLowerCase()
-                : event.key;
-            this._keys.add(keyToStore);
-            const pressed = Array.from(this._keys.values());
-            const comboId = this.makeKey(pressed);
-            const callbacks = this._callbacks.get(comboId);
-            if (callbacks) {
-                this.run(callbacks);
-            }
-        };
-        this.handleKeyUp = (event) => {
-            const keyToRemove = this._options.caseInsensitive
-                ? event.key.toLowerCase()
-                : event.key;
-            this._keys.delete(keyToRemove);
+    constructor(options = {}) {
+        if (typeof options !== "object") {
+            throw new TypeError("options must be a valid object");
+        }
+        this._options = {
+            caseInsensitive: false,
+            ...options,
         };
-        this._getData = getDataFunc;
-        this._options = Object.assign({ caseInsensitive: false }, options);
         document.addEventListener("keydown", this.handleKeyDown);
         document.addEventListener("keyup", this.handleKeyUp);
+        window.addEventListener("blur", this.handleBlur);
+        document.addEventListener("visibilitychange", this.handleVisibilityChange);
     }
     /**
      * Normalizes an array of keys into a sorted string ID.
-     * Handles case normalization if caseInsensitive is enabled.
      */
     makeKey(keys) {
-        const normalizedKeys = this._options.caseInsensitive
-            ? keys.map((k) => k.toLowerCase())
-            : keys;
-        return normalizedKeys.sort().join("_");
+        return keys.sort().join("_");
     }
+    handleKeyDown = (event) => {
+        const keyToStore = this._options.caseInsensitive
+            ? event.key.toLowerCase()
+            : event.key;
+        this._keys.add(keyToStore);
+        // Try single-key callback first, this is because when users register single keys, quick fires fail to run there logic.
+        const singleKeyCallbacks = this._callbacks.get(keyToStore);
+        if (singleKeyCallbacks) {
+            this.run(singleKeyCallbacks);
+        }
+        // Then multi-key combo
+        const pressed = Array.from(this._keys.values());
+        if (pressed.length > 1) {
+            const comboId = this.makeKey(pressed);
+            const comboCallbacks = this._callbacks.get(comboId);
+            if (comboCallbacks) {
+                this.run(comboCallbacks);
+            }
+        }
+    };
+    handleKeyUp = (event) => {
+        const keyToRemove = this._options.caseInsensitive
+            ? event.key.toLowerCase()
+            : event.key;
+        this._keys.delete(keyToRemove);
+    };
     /**
-     * Executes a list of callbacks with injected data.
+     * Clears all pressed keys when window loses focus.
+     * This prevents keys from getting "stuck" when DevTools or other windows are opened.
      */
-    run(callbacks) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const data = this._getData ? yield this._getData() : null;
-            for (const callback of callbacks) {
-                yield callback(data);
-            }
-        });
+    handleBlur = () => {
+        this._keys.clear();
+    };
+    /**
+     * Clears all pressed keys when document becomes hidden.
+     * This handles cases where the page loses visibility.
+     */
+    handleVisibilityChange = () => {
+        if (document.hidden) {
+            this._keys.clear();
+        }
+    };
+    /**
+     * Executes a list of callbacks.
+     */
+    async run(callbacks) {
+        for (const callback of callbacks) {
+            await callback();
+        }
     }
     /**
      * Registers a callback for a specific combination of keys.
@@ -96,6 +112,8 @@ export class KeyMaster {
     dispose() {
         document.removeEventListener("keydown", this.handleKeyDown);
         document.removeEventListener("keyup", this.handleKeyUp);
+        window.removeEventListener("blur", this.handleBlur);
+        document.removeEventListener("visibilitychange", this.handleVisibilityChange);
         this._callbacks.clear();
         this._keys.clear();
     }

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"~~;;;;;;;;;AAmDA;;;GAGG~~;AACH,MAAM,OAAO,SAAS;~~IAMpB;;;OAGG~~;~~IACH~~,~~YACE~~,~~cAA+B~~,IAAI,~~EACnC~~,~~UAA4B~~,~~EAAE~~;~~QAXxB~~,~~aAAQ,GAAoB,IAAI,CAAC~~;~~QACxB~~,~~UAAK~~,~~GAAG~~,IAAI,GAAG,~~EAAU~~,CAAC;~~QAC1B~~,~~eAAU~~,~~GAA+B~~,~~IAAI~~,~~GAAG~~,EAAE~~,CAAC~~;~~QAiC5D~~,~~kBAAa~~,~~GAAG~~,~~CAAC~~,~~KAAoB~~,EAAE,~~EAAE~~;~~YAC/C~~,MAAM,~~UAAU,GAAG,~~IAAI,~~CAAC~~,~~QAAQ,~~CAAC,~~eAAe;gBAC9C~~,CAAC,CAAC,~~KAAK,~~CAAC,~~GAAG~~,CAAC,~~WAAW~~,~~EAAE~~;~~gBACzB~~,~~CAAC~~,~~CAAC~~,KAAK,~~CAAC,~~GAAG,CAAC;~~YAEd~~,~~IAAI~~,CAAC,~~KAAK~~,CAAC,~~GAAG~~,CAAC,~~UAAU~~,CAAC,CAAC;~~YAE3B~~,~~MAAM~~,~~OAAO~~,~~GAAG~~,~~KAAK,~~CAAC,~~IAAI~~,~~CAAC~~,IAAI,CAAC,~~KAAK~~,CAAC,MAAM,~~EAAE,~~CAAC,CAAC~~;YAChD~~,MAAM,~~OAAO~~,~~GAAG,~~IAAI,CAAC,~~OAAO~~,CAAC,~~OAAO~~,CAAC,CAAC~~;YAEtC~~,~~MAAM~~,~~SAAS~~,~~GAAG,~~IAAI,CAAC,~~UAAU~~,CAAC,~~GAAG~~,CAAC,OAAO,CAAC,~~CAAC~~;~~YAC/C~~,IAAI,~~SAAS~~,EAAE,CAAC~~;gBACd~~,IAAI,CAAC,GAAG,CAAC,~~SAAS,~~CAAC~~,CAAC~~;~~YACtB~~,CAAC;~~QACH~~,~~CAAC~~,~~CAAC;QAEM,gBAAW,~~GAAG,CAAC,KAAoB,EAAE,EAAE;~~YAC7C~~,MAAM,~~WAAW~~,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe;~~gBAC/C~~,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE;~~gBACzB~~,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;~~YAEd~~,IAAI,CAAC,KAAK,CAAC,~~MAAM~~,CAAC,~~WAAW~~,CAAC,CAAC;~~QACjC~~,CAAC,CAAC;~~QA5CA~~,IAAI,CAAC,~~QAAQ~~,GAAG,~~WAAW~~,CAAC;~~QAC5B~~,~~IAAI~~,CAAC,~~QAAQ~~,~~mBACX~~,~~eAAe~~,~~EAAE~~,KAAK,~~IACnB~~,~~OAAO~~,~~CACX~~,CAAC;~~QAEF~~,~~QAAQ~~,CAAC,~~gBAAgB~~,CAAC,~~SAAS,~~EAAE,IAAI,CAAC,~~aAAa~~,CAAC,CAAC;~~QACzD~~,~~QAAQ~~,CAAC,~~gBAAgB~~,CAAC,OAAO,EAAE,IAAI,CAAC,~~WAAW~~,CAAC,CAAC;~~IACvD~~,CAAC;~~IAED;;;OAGG~~;~~IACK~~,~~OAAO~~,CAAC,~~IAAc~~;~~QAC5B~~,MAAM,~~cAAc~~,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe;~~YAClD~~,CAAC,CAAC,~~IAAI~~,CAAC,GAAG,CAAC,CAAC,CAAC,~~EAAE~~,~~EAAE~~,CAAC,CAAC,CAAC,WAAW,~~EAAE~~,CAAC;~~YAClC~~,CAAC,CAAC~~,IAAI,CAAC~~;~~QAET~~,~~OAAO~~,~~cAAc~~,~~CAAC~~,~~IAAI,~~EAAE,~~CAAC,~~IAAI,CAAC,~~GAAG~~,CAAC,CAAC;~~IACzC~~,CAAC;~~IA0BD;;OAEG~~;~~IACW~~,GAAG,~~CAAC~~,~~SAAwB;;YACxC~~,~~MAAM,~~IAAI,~~GAAG~~,~~IAAI,~~CAAC,~~QAAQ~~,~~CAAC~~,CAAC,CAAC,~~MAAM~~,~~IAAI,~~CAAC,~~QAAQ~~,EAAE,CAAC,CAAC,CAAC,~~IAAI~~,CAAC;~~YAC1D~~,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;~~gBACjC~~,MAAM,QAAQ,~~CAAC~~,~~IAAI,~~CAAC~~,CAAC~~;~~YACvB~~,CAAC;~~QACH~~,CAAC;~~KAAA;~~IAED;;;;OAIG;IACH,GAAG,CAAC,~~UAA0B~~,EAAE,~~QAAqB~~;~~QACnD~~,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAsB,CAAC,CAAC;QAErD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,~~QAAqB~~;~~QAC1B~~,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5D,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import type { DeviceKey, EditingKey, FunctionKey, GlyphModifierKey, ModifierKey, NavigationKey, SpecialKey, UIEventUnicodeKey, UIKey, UnicodeControlKey, WhitespaceKey } from "./w3ckeyAttributeValues";
+/**
+ * Additional options for the KeyMaster instance.
+ */
+export type KeyMasterOptions = {
+    /**
+     * If true, key comparisons will ignore casing (e.g., 'A' and 'a' are treated as the same key).
+     * @default false
+     */
+    caseInsensitive?: boolean;
+};
+/**
+ * A callback function executed when registered key combinations are triggered.
+ */
+export type KeyCallback = () => any | Promise<any>;
+/**
+ * Union type of valid key values mapped from the W3C UI Events / DOM specification.
+ */
+export type PressableKey = UIEventUnicodeKey | UnicodeControlKey | GlyphModifierKey | SpecialKey | ModifierKey | WhitespaceKey | NavigationKey | EditingKey | UIKey | DeviceKey | FunctionKey;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,KAAK,EACL,iBAAiB,EACjB,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,UAAU,GACV,WAAW,GACX,aAAa,GACb,aAAa,GACb,UAAU,GACV,KAAK,GACL,SAAS,GACT,WAAW,CAAC"}

package/dist/types.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=types.js.map

package/dist/types.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/w3ckeyAttributeValues.d.ts CHANGED Viewed

@@ -240,3 +240,4 @@ export type FunctionKey =
 /** * Implicitly defined Soft-keys (e.g., "Soft8").
  */
  | `Soft${number}`;
+//# sourceMappingURL=w3ckeyAttributeValues.d.ts.map

package/dist/w3ckeyAttributeValues.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"w3ckeyAttributeValues.d.ts","sourceRoot":"","sources":["../src/w3ckeyAttributeValues.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "umbr-key-master",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "A lightweight, type-safe TypeScript library for managing complex keyboard shortcuts and multi-key combinations in the browser.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",