handsontable 13.1.0 → 14.0.0-next-e8f87aa-20231030

package/shortcuts/context.js

@@ -1,6 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.isContextObject = isContextObject;
 require("core-js/modules/es.error.cause.js");
 require("core-js/modules/es.array.push.js");
 var _uniqueMap = require("../utils/dataStructures/uniqueMap");
@@ -9,6 +10,18 @@ var _mixed = require("../helpers/mixed");
 var _function = require("../helpers/function");
 var _object = require("../helpers/object");
 var _templateLiteralTag = require("../helpers/templateLiteralTag");
+const __kindOf = Symbol('shortcut-context');
+
+/**
+ * Checks if the provided object is a context object.
+ *
+ * @param {*} objectToCheck An object to check.
+ * @returns {boolean}
+ */
+function isContextObject(objectToCheck) {
+  return (0, _object.isObject)(objectToCheck) && objectToCheck.__kindOf === __kindOf;
+}
+
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/accessories-and-menus/keyboard-shortcuts.md) in a given [context](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts).
@@ -36,13 +49,13 @@ const createContext = name => {
    * @param {Function} options.callback The shortcut's action
    * @param {object} options.group A group of shortcuts to which the shortcut belongs
    * @param {object} [options.runOnlyIf] A condition on which the shortcut's action runs
-   * @param {object} [options.stopPropagation=true] If set to `true`: stops the event's propagation
+   * @param {object} [options.stopPropagation=false] If set to `true`: stops the event's propagation
    * @param {object} [options.captureCtrl=false] If set to `true`: captures the state of the Control/Meta modifier key
    * @param {object} [options.preventDefault=true] If set to `true`: prevents the default behavior
    * @param {object} [options.position='after'] The order in which the shortcut's action runs:
    * `'before'` or `'after'` the `relativeToGroup` group of actions
    * @param {object} [options.relativeToGroup] The name of a group of actions, used to determine an action's `position`
-   *
+   * @param {object} [options.forwardToContext] The context object where the event will be forwarded to.
    */
   const addShortcut = function () {
     let {
@@ -54,7 +67,8 @@ const createContext = name => {
       preventDefault = true,
       stopPropagation = false,
       relativeToGroup,
-      position
+      position,
+      forwardToContext
     } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
     if ((0, _mixed.isUndefined)(group)) {
       throw new Error('You need to define the shortcut\'s group.');
@@ -78,6 +92,9 @@ const createContext = name => {
     if ((0, _mixed.isDefined)(relativeToGroup)) {
       [newShortcut.relativeToGroup, newShortcut.position] = [relativeToGroup, position];
     }
+    if (isContextObject(forwardToContext)) {
+      newShortcut.forwardToContext = forwardToContext;
+    }
     keys.forEach(keyCombination => {
       const normalizedKeys = (0, _utils.normalizeKeys)(keyCombination);
       const hasKeyCombination = SHORTCUTS.hasItem(normalizedKeys);
@@ -109,11 +126,12 @@ const createContext = name => {
    * @param {Function} [options.callback] A shortcut's action
    * @param {object} [options.group] A group of shortcuts to which a shortcut belongs
    * @param {object} [options.runOnlyIf] A condition on which a shortcut's action runs
-   * @param {object} [options.stopPropagation=true] If set to `true`: stops the event's propagation
+   * @param {object} [options.stopPropagation=false] If set to `true`: stops the event's propagation
    * @param {object} [options.preventDefault=true] If set to `true`: prevents the default behavior
    * @param {object} [options.position='after'] The order in which a shortcut's action runs:
    * `'before'` or `'after'` a `relativeToGroup` group of actions
    * @param {object} [options.relativeToGroup] The name of a group of actions, used to determine an action's `position`
+   * @param {object} [options.forwardToContext] The context object where the event will be forwarded to.
    */
   const addShortcuts = function (shortcuts) {
     let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -189,6 +207,7 @@ const createContext = name => {
     return SHORTCUTS.hasItem(normalizedKeys);
   };
   return {
+    __kindOf,
     addShortcut,
     addShortcuts,
     getShortcuts,

package/shortcuts/context.mjs

@@ -4,8 +4,20 @@ import { createUniqueMap } from "../utils/dataStructures/uniqueMap.mjs";
 import { normalizeKeys, getKeysList } from "./utils.mjs";
 import { isUndefined, isDefined } from "../helpers/mixed.mjs";
 import { isFunction } from "../helpers/function.mjs";
-import { objectEach } from "../helpers/object.mjs";
+import { objectEach, isObject } from "../helpers/object.mjs";
 import { toSingleLine } from "../helpers/templateLiteralTag.mjs";
+const __kindOf = Symbol('shortcut-context');
+
+/**
+ * Checks if the provided object is a context object.
+ *
+ * @param {*} objectToCheck An object to check.
+ * @returns {boolean}
+ */
+export function isContextObject(objectToCheck) {
+  return isObject(objectToCheck) && objectToCheck.__kindOf === __kindOf;
+}
+
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * The `ShortcutContext` API lets you store and manage [keyboard shortcuts](@/guides/accessories-and-menus/keyboard-shortcuts.md) in a given [context](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts).
@@ -33,13 +45,13 @@ export const createContext = name => {
    * @param {Function} options.callback The shortcut's action
    * @param {object} options.group A group of shortcuts to which the shortcut belongs
    * @param {object} [options.runOnlyIf] A condition on which the shortcut's action runs
-   * @param {object} [options.stopPropagation=true] If set to `true`: stops the event's propagation
+   * @param {object} [options.stopPropagation=false] If set to `true`: stops the event's propagation
    * @param {object} [options.captureCtrl=false] If set to `true`: captures the state of the Control/Meta modifier key
    * @param {object} [options.preventDefault=true] If set to `true`: prevents the default behavior
    * @param {object} [options.position='after'] The order in which the shortcut's action runs:
    * `'before'` or `'after'` the `relativeToGroup` group of actions
    * @param {object} [options.relativeToGroup] The name of a group of actions, used to determine an action's `position`
-   *
+   * @param {object} [options.forwardToContext] The context object where the event will be forwarded to.
    */
   const addShortcut = function () {
     let {
@@ -51,7 +63,8 @@ export const createContext = name => {
       preventDefault = true,
       stopPropagation = false,
       relativeToGroup,
-      position
+      position,
+      forwardToContext
     } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
     if (isUndefined(group)) {
       throw new Error('You need to define the shortcut\'s group.');
@@ -75,6 +88,9 @@ export const createContext = name => {
     if (isDefined(relativeToGroup)) {
       [newShortcut.relativeToGroup, newShortcut.position] = [relativeToGroup, position];
     }
+    if (isContextObject(forwardToContext)) {
+      newShortcut.forwardToContext = forwardToContext;
+    }
     keys.forEach(keyCombination => {
       const normalizedKeys = normalizeKeys(keyCombination);
       const hasKeyCombination = SHORTCUTS.hasItem(normalizedKeys);
@@ -106,11 +122,12 @@ export const createContext = name => {
    * @param {Function} [options.callback] A shortcut's action
    * @param {object} [options.group] A group of shortcuts to which a shortcut belongs
    * @param {object} [options.runOnlyIf] A condition on which a shortcut's action runs
-   * @param {object} [options.stopPropagation=true] If set to `true`: stops the event's propagation
+   * @param {object} [options.stopPropagation=false] If set to `true`: stops the event's propagation
    * @param {object} [options.preventDefault=true] If set to `true`: prevents the default behavior
    * @param {object} [options.position='after'] The order in which a shortcut's action runs:
    * `'before'` or `'after'` a `relativeToGroup` group of actions
    * @param {object} [options.relativeToGroup] The name of a group of actions, used to determine an action's `position`
+   * @param {object} [options.forwardToContext] The context object where the event will be forwarded to.
    */
   const addShortcuts = function (shortcuts) {
     let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -186,6 +203,7 @@ export const createContext = name => {
     return SHORTCUTS.hasItem(normalizedKeys);
   };
   return {
+    __kindOf,
     addShortcut,
     addShortcuts,
     getShortcuts,

package/shortcuts/manager.js

@@ -1,11 +1,13 @@
 "use strict";
 
 exports.__esModule = true;
+require("core-js/modules/es.error.cause.js");
 var _uniqueMap = require("../utils/dataStructures/uniqueMap");
+var _event = require("../helpers/dom/event");
 var _context = require("./context");
 var _recorder = require("./recorder");
+var _templateLiteralTag = require("../helpers/templateLiteralTag");
 /* eslint-disable jsdoc/require-description-complete-sentence */
-
 /**
  * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
  *
@@ -84,6 +86,10 @@ const createShortcutManager = _ref => {
    * @param {string} contextName The name of the shortcut context
    */
   const setActiveContextName = contextName => {
+    if (!CONTEXTS.hasItem(contextName)) {
+      throw new Error((0, _templateLiteralTag.toSingleLine)`You've tried to activate the "${contextName}" shortcut context\x20
+        that does not exist. Before activation, register the context using the "addContext" method.`);
+    }
     activeContextName = contextName;
   };
 
@@ -97,12 +103,18 @@ const createShortcutManager = _ref => {
   let isCtrlKeySilenced = false;
 
   /**
-   * Internal key recorder.
+   * A callback function for listening events from the recorder.
    *
-   * @private
+   * @param {KeyboardEvent} event The keyboard event.
+   * @param {string[]} keys Names of the shortcut's keys,
+   * (coming from [`KeyboardEvent.key`](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values)),
+   * in lowercase or uppercase, unified across browsers.
+   * @param {object | string} context The context object or name.
+   * @returns {boolean}
    */
-  const keyRecorder = (0, _recorder.useRecorder)(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, (event, keys) => {
-    const activeContext = getContext(getActiveContextName());
+  const recorderCallback = function (event, keys) {
+    let context = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : getActiveContextName();
+    const activeContext = (0, _context.isContextObject)(context) ? context : getContext(context);
     let isExecutionCancelled = false;
     if (!activeContext.hasShortcut(keys)) {
       return isExecutionCancelled;
@@ -116,7 +128,8 @@ const createShortcutManager = _ref => {
         runOnlyIf,
         preventDefault,
         stopPropagation,
-        captureCtrl
+        captureCtrl,
+        forwardToContext
       } = shortcuts[index];
       if (runOnlyIf(event) !== false) {
         isCtrlKeySilenced = captureCtrl;
@@ -126,15 +139,26 @@ const createShortcutManager = _ref => {
           event.preventDefault();
         }
         if (stopPropagation) {
+          (0, _event.stopImmediatePropagation)(event);
           event.stopPropagation();
         }
         if (isExecutionCancelled) {
           break;
         }
+        if (forwardToContext) {
+          recorderCallback(event, keys, forwardToContext);
+        }
       }
     }
     return isExecutionCancelled;
-  });
+  };
+
+  /**
+   * Internal key recorder.
+   *
+   * @private
+   */
+  const keyRecorder = (0, _recorder.useRecorder)(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, recorderCallback);
   keyRecorder.mount();
   return {
     addContext,

package/shortcuts/manager.mjs

@@ -1,6 +1,9 @@
+import "core-js/modules/es.error.cause.js";
 import { createUniqueMap } from "../utils/dataStructures/uniqueMap.mjs";
-import { createContext } from "./context.mjs";
+import { stopImmediatePropagation } from "../helpers/dom/event.mjs";
+import { createContext, isContextObject } from "./context.mjs";
 import { useRecorder } from "./recorder.mjs";
+import { toSingleLine } from "../helpers/templateLiteralTag.mjs";
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * The `ShortcutManager` API lets you store and manage [keyboard shortcut contexts](@/guides/accessories-and-menus/keyboard-shortcuts.md#keyboard-shortcut-contexts) ([`ShortcutContext`](@/api/shortcutContext.md)).
@@ -80,6 +83,10 @@ export const createShortcutManager = _ref => {
    * @param {string} contextName The name of the shortcut context
    */
   const setActiveContextName = contextName => {
+    if (!CONTEXTS.hasItem(contextName)) {
+      throw new Error(toSingleLine`You've tried to activate the "${contextName}" shortcut context\x20
+        that does not exist. Before activation, register the context using the "addContext" method.`);
+    }
     activeContextName = contextName;
   };
 
@@ -93,12 +100,18 @@ export const createShortcutManager = _ref => {
   let isCtrlKeySilenced = false;
 
   /**
-   * Internal key recorder.
+   * A callback function for listening events from the recorder.
    *
-   * @private
+   * @param {KeyboardEvent} event The keyboard event.
+   * @param {string[]} keys Names of the shortcut's keys,
+   * (coming from [`KeyboardEvent.key`](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values)),
+   * in lowercase or uppercase, unified across browsers.
+   * @param {object | string} context The context object or name.
+   * @returns {boolean}
    */
-  const keyRecorder = useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, (event, keys) => {
-    const activeContext = getContext(getActiveContextName());
+  const recorderCallback = function (event, keys) {
+    let context = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : getActiveContextName();
+    const activeContext = isContextObject(context) ? context : getContext(context);
     let isExecutionCancelled = false;
     if (!activeContext.hasShortcut(keys)) {
       return isExecutionCancelled;
@@ -112,7 +125,8 @@ export const createShortcutManager = _ref => {
         runOnlyIf,
         preventDefault,
         stopPropagation,
-        captureCtrl
+        captureCtrl,
+        forwardToContext
       } = shortcuts[index];
       if (runOnlyIf(event) !== false) {
         isCtrlKeySilenced = captureCtrl;
@@ -122,15 +136,26 @@ export const createShortcutManager = _ref => {
           event.preventDefault();
         }
         if (stopPropagation) {
+          stopImmediatePropagation(event);
           event.stopPropagation();
         }
         if (isExecutionCancelled) {
           break;
         }
+        if (forwardToContext) {
+          recorderCallback(event, keys, forwardToContext);
+        }
       }
     }
     return isExecutionCancelled;
-  });
+  };
+
+  /**
+   * Internal key recorder.
+   *
+   * @private
+   */
+  const keyRecorder = useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, recorderCallback);
   keyRecorder.mount();
   return {
     addContext,

package/shortcuts/recorder.js

@@ -10,6 +10,7 @@ var _element = require("../helpers/dom/element");
 var _browser = require("../helpers/browser");
 const MODIFIER_KEYS = ['meta', 'alt', 'shift', 'control'];
 const modifierKeysObserver = (0, _keyObserver.createKeysObserver)();
+let instanceCounter = 0;
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 
@@ -86,11 +87,9 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
     if (event.keyCode === 229 || result === false || (0, _event.isImmediatePropagationStopped)(event)) {
       return;
     }
-    const pressedKey = (0, _utils.normalizeEventKey)(event.key);
+    const pressedKey = (0, _utils.normalizeEventKey)(event);
     let extraModifierKeys = [];
-    if (isModifierKey(pressedKey)) {
-      modifierKeysObserver.press(pressedKey);
-    } else {
+    if (!isModifierKey(pressedKey)) {
       extraModifierKeys = getPressedModifierKeys(event);
     }
     const pressedKeys = [pressedKey].concat(extraModifierKeys);
@@ -103,20 +102,29 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
   };
 
   /**
-   * `KeyboardEvent`'s callback function
+   * `KeyboardEvent`'s callback function for observing the pressed state of the mod keys.
    *
    * @private
    * @param {KeyboardEvent} event The event object
    */
-  const onkeyup = event => {
-    if (handleEvent(event) === false) {
-      return;
+  const onkeydownForModKeys = event => {
+    const pressedKey = (0, _utils.normalizeEventKey)(event);
+    if (isModifierKey(pressedKey)) {
+      modifierKeysObserver.press(pressedKey);
     }
-    const pressedKey = (0, _utils.normalizeEventKey)(event.key);
-    if (isModifierKey(pressedKey) === false) {
-      return;
+  };
+
+  /**
+   * `KeyboardEvent`'s callback function for observing the pressed state of the mod keys.
+   *
+   * @private
+   * @param {KeyboardEvent} event The event object
+   */
+  const onkeyupForModKeys = event => {
+    const pressedKey = (0, _utils.normalizeEventKey)(event);
+    if (isModifierKey(pressedKey)) {
+      modifierKeysObserver.release(pressedKey);
     }
-    modifierKeysObserver.release(pressedKey);
   };
 
   /**
@@ -133,9 +141,13 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
    */
   const mount = () => {
     let eventTarget = ownerWindow;
+    instanceCounter += 1;
     while (eventTarget) {
+      if (instanceCounter === 1) {
+        eventTarget.document.documentElement.addEventListener('keydown', onkeydownForModKeys);
+        eventTarget.document.documentElement.addEventListener('keyup', onkeyupForModKeys);
+      }
       eventTarget.document.documentElement.addEventListener('keydown', onkeydown);
-      eventTarget.document.documentElement.addEventListener('keyup', onkeyup);
       eventTarget.document.documentElement.addEventListener('blur', onblur);
       eventTarget = (0, _element.getParentWindow)(eventTarget);
     }
@@ -146,9 +158,13 @@ function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDown, call
    */
   const unmount = () => {
     let eventTarget = ownerWindow;
+    instanceCounter -= 1;
     while (eventTarget) {
+      if (instanceCounter === 0) {
+        eventTarget.document.documentElement.removeEventListener('keydown', onkeydownForModKeys);
+        eventTarget.document.documentElement.removeEventListener('keyup', onkeyupForModKeys);
+      }
       eventTarget.document.documentElement.removeEventListener('keydown', onkeydown);
-      eventTarget.document.documentElement.removeEventListener('keyup', onkeyup);
       eventTarget.document.documentElement.removeEventListener('blur', onblur);
       eventTarget = (0, _element.getParentWindow)(eventTarget);
     }

package/shortcuts/recorder.mjs

@@ -6,6 +6,7 @@ import { getParentWindow } from "../helpers/dom/element.mjs";
 import { isMacOS } from "../helpers/browser.mjs";
 const MODIFIER_KEYS = ['meta', 'alt', 'shift', 'control'];
 const modifierKeysObserver = createKeysObserver();
+let instanceCounter = 0;
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 
@@ -82,11 +83,9 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
     if (event.keyCode === 229 || result === false || isImmediatePropagationStopped(event)) {
       return;
     }
-    const pressedKey = normalizeEventKey(event.key);
+    const pressedKey = normalizeEventKey(event);
     let extraModifierKeys = [];
-    if (isModifierKey(pressedKey)) {
-      modifierKeysObserver.press(pressedKey);
-    } else {
+    if (!isModifierKey(pressedKey)) {
       extraModifierKeys = getPressedModifierKeys(event);
     }
     const pressedKeys = [pressedKey].concat(extraModifierKeys);
@@ -99,20 +98,29 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
   };
 
   /**
-   * `KeyboardEvent`'s callback function
+   * `KeyboardEvent`'s callback function for observing the pressed state of the mod keys.
    *
    * @private
    * @param {KeyboardEvent} event The event object
    */
-  const onkeyup = event => {
-    if (handleEvent(event) === false) {
-      return;
+  const onkeydownForModKeys = event => {
+    const pressedKey = normalizeEventKey(event);
+    if (isModifierKey(pressedKey)) {
+      modifierKeysObserver.press(pressedKey);
     }
-    const pressedKey = normalizeEventKey(event.key);
-    if (isModifierKey(pressedKey) === false) {
-      return;
+  };
+
+  /**
+   * `KeyboardEvent`'s callback function for observing the pressed state of the mod keys.
+   *
+   * @private
+   * @param {KeyboardEvent} event The event object
+   */
+  const onkeyupForModKeys = event => {
+    const pressedKey = normalizeEventKey(event);
+    if (isModifierKey(pressedKey)) {
+      modifierKeysObserver.release(pressedKey);
     }
-    modifierKeysObserver.release(pressedKey);
   };
 
   /**
@@ -129,9 +137,13 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
    */
   const mount = () => {
     let eventTarget = ownerWindow;
+    instanceCounter += 1;
     while (eventTarget) {
+      if (instanceCounter === 1) {
+        eventTarget.document.documentElement.addEventListener('keydown', onkeydownForModKeys);
+        eventTarget.document.documentElement.addEventListener('keyup', onkeyupForModKeys);
+      }
       eventTarget.document.documentElement.addEventListener('keydown', onkeydown);
-      eventTarget.document.documentElement.addEventListener('keyup', onkeyup);
       eventTarget.document.documentElement.addEventListener('blur', onblur);
       eventTarget = getParentWindow(eventTarget);
     }
@@ -142,9 +154,13 @@ export function useRecorder(ownerWindow, handleEvent, beforeKeyDown, afterKeyDow
    */
   const unmount = () => {
     let eventTarget = ownerWindow;
+    instanceCounter -= 1;
     while (eventTarget) {
+      if (instanceCounter === 0) {
+        eventTarget.document.documentElement.removeEventListener('keydown', onkeydownForModKeys);
+        eventTarget.document.documentElement.removeEventListener('keyup', onkeyupForModKeys);
+      }
       eventTarget.document.documentElement.removeEventListener('keydown', onkeydown);
-      eventTarget.document.documentElement.removeEventListener('keyup', onkeyup);
       eventTarget.document.documentElement.removeEventListener('blur', onblur);
       eventTarget = getParentWindow(eventTarget);
     }

package/shortcuts/utils.js

@@ -37,13 +37,27 @@ const getKeysList = normalizedKeys => {
 };
 
 /**
- * Normalize a `KeyboardEvent.key` property, to use it for keyboard shortcuts.
+ * The regex tests if the event.code matches to the pattern and it's used to extract letters and digits from
+ * the string.
+ */
+exports.getKeysList = getKeysList;
+const codeToKeyRegExp = new RegExp('^(?:Key|Digit)([A-Z0-9])$');
+
+/**
+ * Normalizes a keyboard event key value to a key before its modification. When the keyboard event
+ * is triggered with Alt, Control or Shift keys the `key` property contains modified key e.g. for Alt+L
+ * it will be `ł`. But that value is only valid for polish keyboard layout. To fix that limitations, for
+ * letters and digits the value is taken from the `code` property which holds original value before
+ * transformation.
  *
- * @param {string} key KeyboardEvent's key property.
+ * @param {Event} event The KeyboardEvent object.
  * @returns {string}
  */
-exports.getKeysList = getKeysList;
-const normalizeEventKey = key => {
-  return key.toLowerCase();
+const normalizeEventKey = _ref => {
+  let {
+    key,
+    code
+  } = _ref;
+  return (codeToKeyRegExp.test(code) ? code.replace(codeToKeyRegExp, '$1') : key).toLowerCase();
 };
 exports.normalizeEventKey = normalizeEventKey;

package/shortcuts/utils.mjs

@@ -33,11 +33,25 @@ export const getKeysList = normalizedKeys => {
 };
 
 /**
- * Normalize a `KeyboardEvent.key` property, to use it for keyboard shortcuts.
+ * The regex tests if the event.code matches to the pattern and it's used to extract letters and digits from
+ * the string.
+ */
+const codeToKeyRegExp = new RegExp('^(?:Key|Digit)([A-Z0-9])$');
+
+/**
+ * Normalizes a keyboard event key value to a key before its modification. When the keyboard event
+ * is triggered with Alt, Control or Shift keys the `key` property contains modified key e.g. for Alt+L
+ * it will be `ł`. But that value is only valid for polish keyboard layout. To fix that limitations, for
+ * letters and digits the value is taken from the `code` property which holds original value before
+ * transformation.
  *
- * @param {string} key KeyboardEvent's key property.
+ * @param {Event} event The KeyboardEvent object.
  * @returns {string}
  */
-export const normalizeEventKey = key => {
-  return key.toLowerCase();
+export const normalizeEventKey = _ref => {
+  let {
+    key,
+    code
+  } = _ref;
+  return (codeToKeyRegExp.test(code) ? code.replace(codeToKeyRegExp, '$1') : key).toLowerCase();
 };