@wordpress/keyboard-shortcuts 5.44.0 → 5.44.1-next.v.202604201441.0

package/README.md

@@ -22,11 +22,11 @@ Handles callbacks added to context by `useShortcut`. Adding a provider allows to
 
 _Parameters_
 
--   _props_ `Object`: Props to pass to `div`.
+-   _props_ `ShortcutProviderProps`: Props to pass to `div`.
 
 _Returns_
 
--   `Element`: Component.
+-   Component.
 
 ### store
 
@@ -36,10 +36,6 @@ _Related_
 
 -   <https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore>
 
-_Type_
-
--   `Object`
-
 ### useShortcut
 
 Attach a keyboard shortcut handler.
@@ -47,9 +43,9 @@ Attach a keyboard shortcut handler.
 _Parameters_
 
 -   _name_ `string`: Shortcut name.
--   _callback_ `Function`: Shortcut callback.
--   _options_ `Object`: Shortcut options.
--   _options.isDisabled_ `boolean`: Whether to disable to shortut.
+-   _callback_ `( event: KeyboardEvent ) => void`: Shortcut callback.
+-   _options_ `UseShortcutOptions`: Shortcut options.
+-   _options.isDisabled_ `UseShortcutOptions[ 'isDisabled' ]`: Whether to disable the shortcut.
 
 <!-- END TOKEN(Autogenerated API docs) -->
 

package/build/components/shortcut-provider.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/components/shortcut-provider.js
+// packages/keyboard-shortcuts/src/components/shortcut-provider.tsx
 var shortcut_provider_exports = {};
 __export(shortcut_provider_exports, {
   ShortcutProvider: () => ShortcutProvider
@@ -27,13 +28,16 @@ var import_context = require("../context.cjs");
 var import_jsx_runtime = require("react/jsx-runtime");
 var { Provider } = import_context.context;
 function ShortcutProvider(props) {
-  const [keyboardShortcuts] = (0, import_element.useState)(() => /* @__PURE__ */ new Set());
+  const [keyboardShortcuts] = (0, import_element.useState)(
+    () => /* @__PURE__ */ new Set()
+  );
   function onKeyDown(event) {
     if (props.onKeyDown) {
       props.onKeyDown(event);
     }
+    const nativeEvent = event.nativeEvent;
     for (const keyboardShortcut of keyboardShortcuts) {
-      keyboardShortcut(event);
+      keyboardShortcut(nativeEvent);
     }
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Provider, { value: keyboardShortcuts, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { ...props, onKeyDown }) });

package/build/components/shortcut-provider.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/components/shortcut-provider.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useState } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport { context } from '../context';\n\nconst { Provider } = context;\n\n/**\n * Handles callbacks added to context by `useShortcut`.\n * Adding a provider allows to register contextual shortcuts\n * that are only active when a certain part of the UI is focused.\n *\n * @param {Object} props Props to pass to `div`.\n *\n * @return {Element} Component.\n */\nexport function ShortcutProvider( props ) {\n\tconst [ keyboardShortcuts ] = useState( () => new Set() );\n\n\tfunction onKeyDown( event ) {\n\t\tif ( props.onKeyDown ) {\n\t\t\tprops.onKeyDown( event );\n\t\t}\n\n\t\tfor ( const keyboardShortcut of keyboardShortcuts ) {\n\t\t\tkeyboardShortcut( event );\n\t\t}\n\t}\n\n\t/* eslint-disable jsx-a11y/no-static-element-interactions */\n\treturn (\n\t\t<Provider value={ keyboardShortcuts }>\n\t\t\t<div { ...props } onKeyDown={ onKeyDown } />\n\t\t</Provider>\n\t);\n\t/* eslint-enable jsx-a11y/no-static-element-interactions */\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAAyB;AAKzB,qBAAwB;AA6BrB;AA3BH,IAAM,EAAE,SAAS,IAAI;AAWd,SAAS,iBAAkB,OAAQ;AACzC,QAAM,CAAE,iBAAkB,QAAI,yBAAU,MAAM,oBAAI,IAAI,CAAE;AAExD,WAAS,UAAW,OAAQ;AAC3B,QAAK,MAAM,WAAY;AACtB,YAAM,UAAW,KAAM;AAAA,IACxB;AAEA,eAAY,oBAAoB,mBAAoB;AACnD,uBAAkB,KAAM;AAAA,IACzB;AAAA,EACD;AAGA,SACC,4CAAC,YAAS,OAAQ,mBACjB,sDAAC,SAAM,GAAG,OAAQ,WAAwB,GAC3C;AAGF;",
+  "sources": ["../../src/components/shortcut-provider.tsx"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useState } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport { context } from '../context';\n\nconst { Provider } = context;\n\ntype ShortcutCallback = ( event: KeyboardEvent ) => void;\n\ninterface ShortcutProviderProps extends React.HTMLAttributes< HTMLDivElement > {\n\tonKeyDown?: ( event: React.KeyboardEvent< HTMLDivElement > ) => void;\n}\n\n/**\n * Handles callbacks added to context by `useShortcut`.\n * Adding a provider allows to register contextual shortcuts\n * that are only active when a certain part of the UI is focused.\n *\n * @param props Props to pass to `div`.\n *\n * @return Component.\n */\nexport function ShortcutProvider( props: ShortcutProviderProps ) {\n\tconst [ keyboardShortcuts ] = useState(\n\t\t() => new Set< ShortcutCallback >()\n\t);\n\n\tfunction onKeyDown( event: React.KeyboardEvent< HTMLDivElement > ) {\n\t\tif ( props.onKeyDown ) {\n\t\t\tprops.onKeyDown( event );\n\t\t}\n\n\t\t// Convert React event to native KeyboardEvent for compatibility\n\t\tconst nativeEvent = event.nativeEvent;\n\t\tfor ( const keyboardShortcut of keyboardShortcuts ) {\n\t\t\tkeyboardShortcut( nativeEvent );\n\t\t}\n\t}\n\n\t/* eslint-disable jsx-a11y/no-static-element-interactions */\n\treturn (\n\t\t<Provider value={ keyboardShortcuts }>\n\t\t\t<div { ...props } onKeyDown={ onKeyDown } />\n\t\t</Provider>\n\t);\n\t/* eslint-enable jsx-a11y/no-static-element-interactions */\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAAyB;AAKzB,qBAAwB;AAuCrB;AArCH,IAAM,EAAE,SAAS,IAAI;AAiBd,SAAS,iBAAkB,OAA+B;AAChE,QAAM,CAAE,iBAAkB,QAAI;AAAA,IAC7B,MAAM,oBAAI,IAAwB;AAAA,EACnC;AAEA,WAAS,UAAW,OAA+C;AAClE,QAAK,MAAM,WAAY;AACtB,YAAM,UAAW,KAAM;AAAA,IACxB;AAGA,UAAM,cAAc,MAAM;AAC1B,eAAY,oBAAoB,mBAAoB;AACnD,uBAAkB,WAAY;AAAA,IAC/B;AAAA,EACD;AAGA,SACC,4CAAC,YAAS,OAAQ,mBACjB,sDAAC,SAAM,GAAG,OAAQ,WAAwB,GAC3C;AAGF;",
   "names": []
 }

package/build/context.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/context.js
+// packages/keyboard-shortcuts/src/context.ts
 var context_exports = {};
 __export(context_exports, {
   context: () => context

package/build/context.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/context.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createContext } from '@wordpress/element';\n\nconst globalShortcuts = new Set();\nconst globalListener = ( event ) => {\n\tfor ( const keyboardShortcut of globalShortcuts ) {\n\t\tkeyboardShortcut( event );\n\t}\n};\n\nexport const context = createContext( {\n\tadd: ( shortcut ) => {\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.addEventListener( 'keydown', globalListener );\n\t\t}\n\t\tglobalShortcuts.add( shortcut );\n\t},\n\tdelete: ( shortcut ) => {\n\t\tglobalShortcuts.delete( shortcut );\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.removeEventListener( 'keydown', globalListener );\n\t\t}\n\t},\n} );\n\ncontext.displayName = 'KeyboardShortcutsContext';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA8B;AAE9B,IAAM,kBAAkB,oBAAI,IAAI;AAChC,IAAM,iBAAiB,CAAE,UAAW;AACnC,aAAY,oBAAoB,iBAAkB;AACjD,qBAAkB,KAAM;AAAA,EACzB;AACD;AAEO,IAAM,cAAU,8BAAe;AAAA,EACrC,KAAK,CAAE,aAAc;AACpB,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,iBAAkB,WAAW,cAAe;AAAA,IACtD;AACA,oBAAgB,IAAK,QAAS;AAAA,EAC/B;AAAA,EACA,QAAQ,CAAE,aAAc;AACvB,oBAAgB,OAAQ,QAAS;AACjC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,oBAAqB,WAAW,cAAe;AAAA,IACzD;AAAA,EACD;AACD,CAAE;AAEF,QAAQ,cAAc;",
+  "sources": ["../src/context.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createContext } from '@wordpress/element';\n\ntype ShortcutCallback = ( event: KeyboardEvent ) => void;\n\ninterface ShortcutContextType {\n\tadd: ( shortcut: ShortcutCallback ) => void;\n\tdelete: ( shortcut: ShortcutCallback ) => void;\n}\n\nconst globalShortcuts = new Set< ShortcutCallback >();\nconst globalListener = ( event: KeyboardEvent ) => {\n\tfor ( const keyboardShortcut of globalShortcuts ) {\n\t\tkeyboardShortcut( event );\n\t}\n};\n\nexport const context = createContext< ShortcutContextType >( {\n\tadd: ( shortcut: ShortcutCallback ) => {\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.addEventListener( 'keydown', globalListener );\n\t\t}\n\t\tglobalShortcuts.add( shortcut );\n\t},\n\tdelete: ( shortcut: ShortcutCallback ) => {\n\t\tglobalShortcuts.delete( shortcut );\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.removeEventListener( 'keydown', globalListener );\n\t\t}\n\t},\n} );\n\ncontext.displayName = 'KeyboardShortcutsContext';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA8B;AAS9B,IAAM,kBAAkB,oBAAI,IAAwB;AACpD,IAAM,iBAAiB,CAAE,UAA0B;AAClD,aAAY,oBAAoB,iBAAkB;AACjD,qBAAkB,KAAM;AAAA,EACzB;AACD;AAEO,IAAM,cAAU,8BAAsC;AAAA,EAC5D,KAAK,CAAE,aAAgC;AACtC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,iBAAkB,WAAW,cAAe;AAAA,IACtD;AACA,oBAAgB,IAAK,QAAS;AAAA,EAC/B;AAAA,EACA,QAAQ,CAAE,aAAgC;AACzC,oBAAgB,OAAQ,QAAS;AACjC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,oBAAqB,WAAW,cAAe;AAAA,IACzD;AAAA,EACD;AACD,CAAE;AAEF,QAAQ,cAAc;",
   "names": []
 }

package/build/hooks/use-shortcut-event-match.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,26 +17,32 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/hooks/use-shortcut-event-match.js
+// packages/keyboard-shortcuts/src/hooks/use-shortcut-event-match.ts
 var use_shortcut_event_match_exports = {};
 __export(use_shortcut_event_match_exports, {
   default: () => useShortcutEventMatch
 });
 module.exports = __toCommonJS(use_shortcut_event_match_exports);
 var import_data = require("@wordpress/data");
+var import_element = require("@wordpress/element");
 var import_keycodes = require("@wordpress/keycodes");
 var import_store = require("../store/index.cjs");
 function useShortcutEventMatch() {
   const { getAllShortcutKeyCombinations } = (0, import_data.useSelect)(
     import_store.store
   );
-  function isMatch(name, event) {
-    return getAllShortcutKeyCombinations(name).some(
-      ({ modifier, character }) => {
-        return import_keycodes.isKeyboardEvent[modifier](event, character);
-      }
-    );
-  }
-  return isMatch;
+  return (0, import_element.useCallback)(
+    (name, event) => {
+      return getAllShortcutKeyCombinations(name).some(
+        (combination) => {
+          if (!combination) {
+            return false;
+          }
+          return import_keycodes.isKeyboardEvent[combination.modifier ?? "undefined"](event, combination.character);
+        }
+      );
+    },
+    [getAllShortcutKeyCombinations]
+  );
 }
 //# sourceMappingURL=use-shortcut-event-match.cjs.map

package/build/hooks/use-shortcut-event-match.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/hooks/use-shortcut-event-match.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useSelect } from '@wordpress/data';\nimport { isKeyboardEvent } from '@wordpress/keycodes';\n\n/**\n * Internal dependencies\n */\nimport { store as keyboardShortcutsStore } from '../store';\n\n/**\n * Returns a function to check if a keyboard event matches a shortcut name.\n *\n * @return {Function} A function to check if a keyboard event matches a\n *                    predefined shortcut combination.\n */\nexport default function useShortcutEventMatch() {\n\tconst { getAllShortcutKeyCombinations } = useSelect(\n\t\tkeyboardShortcutsStore\n\t);\n\n\t/**\n\t * A function to check if a keyboard event matches a predefined shortcut\n\t * combination.\n\t *\n\t * @param {string}        name  Shortcut name.\n\t * @param {KeyboardEvent} event Event to check.\n\t *\n\t * @return {boolean} True if the event matches any shortcuts, false if not.\n\t */\n\tfunction isMatch( name, event ) {\n\t\treturn getAllShortcutKeyCombinations( name ).some(\n\t\t\t( { modifier, character } ) => {\n\t\t\t\treturn isKeyboardEvent[ modifier ]( event, character );\n\t\t\t}\n\t\t);\n\t}\n\n\treturn isMatch;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA0B;AAC1B,sBAAgC;AAKhC,mBAAgD;AAQjC,SAAR,wBAAyC;AAC/C,QAAM,EAAE,8BAA8B,QAAI;AAAA,IACzC,aAAAA;AAAA,EACD;AAWA,WAAS,QAAS,MAAM,OAAQ;AAC/B,WAAO,8BAA+B,IAAK,EAAE;AAAA,MAC5C,CAAE,EAAE,UAAU,UAAU,MAAO;AAC9B,eAAO,gCAAiB,QAAS,EAAG,OAAO,SAAU;AAAA,MACtD;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AACR;",
+  "sources": ["../../src/hooks/use-shortcut-event-match.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useSelect } from '@wordpress/data';\nimport { useCallback } from '@wordpress/element';\nimport { isKeyboardEvent } from '@wordpress/keycodes';\n\n/**\n * Internal dependencies\n */\nimport { store as keyboardShortcutsStore } from '../store';\n\n/**\n * Returns a function to check if a keyboard event matches a shortcut name.\n *\n * @return A function to check if a keyboard event matches a\n *         predefined shortcut combination.\n */\nexport default function useShortcutEventMatch(): (\n\tname: string,\n\tevent: KeyboardEvent\n) => boolean {\n\tconst { getAllShortcutKeyCombinations } = useSelect(\n\t\tkeyboardShortcutsStore\n\t);\n\n\t/**\n\t * A function to check if a keyboard event matches a predefined shortcut\n\t * combination.\n\t *\n\t * @param name  Shortcut name.\n\t * @param event Event to check.\n\t *\n\t * @return True if the event matches the shortcuts, false if not.\n\t */\n\treturn useCallback(\n\t\t( name: string, event: KeyboardEvent ) => {\n\t\t\treturn getAllShortcutKeyCombinations( name ).some(\n\t\t\t\t( combination ) => {\n\t\t\t\t\tif ( ! combination ) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\t\t\t\t\treturn isKeyboardEvent[\n\t\t\t\t\t\tcombination.modifier ?? 'undefined'\n\t\t\t\t\t]( event, combination.character );\n\t\t\t\t}\n\t\t\t);\n\t\t},\n\t\t[ getAllShortcutKeyCombinations ]\n\t);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA0B;AAC1B,qBAA4B;AAC5B,sBAAgC;AAKhC,mBAAgD;AAQjC,SAAR,wBAGM;AACZ,QAAM,EAAE,8BAA8B,QAAI;AAAA,IACzC,aAAAA;AAAA,EACD;AAWA,aAAO;AAAA,IACN,CAAE,MAAc,UAA0B;AACzC,aAAO,8BAA+B,IAAK,EAAE;AAAA,QAC5C,CAAE,gBAAiB;AAClB,cAAK,CAAE,aAAc;AACpB,mBAAO;AAAA,UACR;AACA,iBAAO,gCACN,YAAY,YAAY,WACzB,EAAG,OAAO,YAAY,SAAU;AAAA,QACjC;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAE,6BAA8B;AAAA,EACjC;AACD;",
   "names": ["keyboardShortcutsStore"]
 }

package/build/hooks/use-shortcut.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -26,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/hooks/use-shortcut.js
+// packages/keyboard-shortcuts/src/hooks/use-shortcut.ts
 var use_shortcut_exports = {};
 __export(use_shortcut_exports, {
   default: () => useShortcut
@@ -47,7 +48,7 @@ function useShortcut(name, callback, { isDisabled = false } = {}) {
       return;
     }
     function _callback(event) {
-      if (isMatch(name, event)) {
+      if (isMatch(name, event) && callbackRef.current) {
         callbackRef.current(event);
       }
     }
@@ -55,6 +56,6 @@ function useShortcut(name, callback, { isDisabled = false } = {}) {
     return () => {
       shortcuts.delete(_callback);
     };
-  }, [name, isDisabled, shortcuts]);
+  }, [name, isDisabled, shortcuts, isMatch]);
 }
 //# sourceMappingURL=use-shortcut.cjs.map

package/build/hooks/use-shortcut.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/hooks/use-shortcut.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useContext, useEffect, useRef } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport useShortcutEventMatch from './use-shortcut-event-match';\nimport { context } from '../context';\n\n/**\n * Attach a keyboard shortcut handler.\n *\n * @param {string}   name               Shortcut name.\n * @param {Function} callback           Shortcut callback.\n * @param {Object}   options            Shortcut options.\n * @param {boolean}  options.isDisabled Whether to disable to shortut.\n */\nexport default function useShortcut(\n\tname,\n\tcallback,\n\t{ isDisabled = false } = {}\n) {\n\tconst shortcuts = useContext( context );\n\tconst isMatch = useShortcutEventMatch();\n\tconst callbackRef = useRef();\n\n\tuseEffect( () => {\n\t\tcallbackRef.current = callback;\n\t}, [ callback ] );\n\n\tuseEffect( () => {\n\t\tif ( isDisabled ) {\n\t\t\treturn;\n\t\t}\n\n\t\tfunction _callback( event ) {\n\t\t\tif ( isMatch( name, event ) ) {\n\t\t\t\tcallbackRef.current( event );\n\t\t\t}\n\t\t}\n\n\t\tshortcuts.add( _callback );\n\t\treturn () => {\n\t\t\tshortcuts.delete( _callback );\n\t\t};\n\t}, [ name, isDisabled, shortcuts ] );\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA8C;AAK9C,sCAAkC;AAClC,qBAAwB;AAUT,SAAR,YACN,MACA,UACA,EAAE,aAAa,MAAM,IAAI,CAAC,GACzB;AACD,QAAM,gBAAY,2BAAY,sBAAQ;AACtC,QAAM,cAAU,gCAAAA,SAAsB;AACtC,QAAM,kBAAc,uBAAO;AAE3B,gCAAW,MAAM;AAChB,gBAAY,UAAU;AAAA,EACvB,GAAG,CAAE,QAAS,CAAE;AAEhB,gCAAW,MAAM;AAChB,QAAK,YAAa;AACjB;AAAA,IACD;AAEA,aAAS,UAAW,OAAQ;AAC3B,UAAK,QAAS,MAAM,KAAM,GAAI;AAC7B,oBAAY,QAAS,KAAM;AAAA,MAC5B;AAAA,IACD;AAEA,cAAU,IAAK,SAAU;AACzB,WAAO,MAAM;AACZ,gBAAU,OAAQ,SAAU;AAAA,IAC7B;AAAA,EACD,GAAG,CAAE,MAAM,YAAY,SAAU,CAAE;AACpC;",
+  "sources": ["../../src/hooks/use-shortcut.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useContext, useEffect, useRef } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport useShortcutEventMatch from './use-shortcut-event-match';\nimport { context } from '../context';\n\ninterface UseShortcutOptions {\n\tisDisabled?: boolean;\n}\n\n/**\n * Attach a keyboard shortcut handler.\n *\n * @param name               Shortcut name.\n * @param callback           Shortcut callback.\n * @param options            Shortcut options.\n * @param options.isDisabled Whether to disable the shortcut.\n */\nexport default function useShortcut(\n\tname: string,\n\tcallback: ( event: KeyboardEvent ) => void,\n\t{ isDisabled = false }: UseShortcutOptions = {}\n) {\n\tconst shortcuts = useContext( context );\n\tconst isMatch = useShortcutEventMatch();\n\tconst callbackRef = useRef< ( event: KeyboardEvent ) => void >();\n\n\tuseEffect( () => {\n\t\tcallbackRef.current = callback;\n\t}, [ callback ] );\n\n\tuseEffect( () => {\n\t\tif ( isDisabled ) {\n\t\t\treturn;\n\t\t}\n\n\t\tfunction _callback( event: KeyboardEvent ) {\n\t\t\tif ( isMatch( name, event ) && callbackRef.current ) {\n\t\t\t\tcallbackRef.current( event );\n\t\t\t}\n\t\t}\n\n\t\tshortcuts.add( _callback );\n\t\treturn () => {\n\t\t\tshortcuts.delete( _callback );\n\t\t};\n\t}, [ name, isDisabled, shortcuts, isMatch ] );\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,qBAA8C;AAK9C,sCAAkC;AAClC,qBAAwB;AAcT,SAAR,YACN,MACA,UACA,EAAE,aAAa,MAAM,IAAwB,CAAC,GAC7C;AACD,QAAM,gBAAY,2BAAY,sBAAQ;AACtC,QAAM,cAAU,gCAAAA,SAAsB;AACtC,QAAM,kBAAc,uBAA2C;AAE/D,gCAAW,MAAM;AAChB,gBAAY,UAAU;AAAA,EACvB,GAAG,CAAE,QAAS,CAAE;AAEhB,gCAAW,MAAM;AAChB,QAAK,YAAa;AACjB;AAAA,IACD;AAEA,aAAS,UAAW,OAAuB;AAC1C,UAAK,QAAS,MAAM,KAAM,KAAK,YAAY,SAAU;AACpD,oBAAY,QAAS,KAAM;AAAA,MAC5B;AAAA,IACD;AAEA,cAAU,IAAK,SAAU;AACzB,WAAO,MAAM;AACZ,gBAAU,OAAQ,SAAU;AAAA,IAC7B;AAAA,EACD,GAAG,CAAE,MAAM,YAAY,WAAW,OAAQ,CAAE;AAC7C;",
   "names": ["useShortcutEventMatch"]
 }

package/build/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -26,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/index.js
+// packages/keyboard-shortcuts/src/index.ts
 var index_exports = {};
 __export(index_exports, {
   ShortcutProvider: () => import_shortcut_provider.ShortcutProvider,

package/build/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/index.js"],
+  "sources": ["../src/index.ts"],
   "sourcesContent": ["export { store } from './store';\nexport { default as useShortcut } from './hooks/use-shortcut';\nexport { ShortcutProvider } from './components/shortcut-provider';\nexport { default as __unstableUseShortcutEventMatch } from './hooks/use-shortcut-event-match';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsB;AACtB,0BAAuC;AACvC,+BAAiC;AACjC,sCAA2D;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsB;AACtB,0BAAuC;AACvC,+BAAiC;AACjC,sCAA2D;",
   "names": []
 }

package/build/store/actions.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/store/actions.js
+// packages/keyboard-shortcuts/src/store/actions.ts
 var actions_exports = {};
 __export(actions_exports, {
   registerShortcut: () => registerShortcut,

package/build/store/actions.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/actions.js"],
-  "sourcesContent": ["/** @typedef {import('@wordpress/keycodes').WPKeycodeModifier} WPKeycodeModifier */\n\n/**\n * Keyboard key combination.\n *\n * @typedef {Object} WPShortcutKeyCombination\n *\n * @property {string}                      character Character.\n * @property {WPKeycodeModifier|undefined} modifier  Modifier.\n */\n\n/**\n * Configuration of a registered keyboard shortcut.\n *\n * @typedef {Object} WPShortcutConfig\n *\n * @property {string}                     name           Shortcut name.\n * @property {string}                     category       Shortcut category.\n * @property {string}                     description    Shortcut description.\n * @property {WPShortcutKeyCombination}   keyCombination Shortcut key combination.\n * @property {WPShortcutKeyCombination[]} [aliases]      Shortcut aliases.\n */\n\n/**\n * Returns an action object used to register a new keyboard shortcut.\n *\n * @param {WPShortcutConfig} config Shortcut config.\n *\n * @example\n *\n *```js\n * import { useEffect } from 'react';\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect, useDispatch } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const { registerShortcut } = useDispatch( keyboardShortcutsStore );\n *\n *     useEffect( () => {\n *         registerShortcut( {\n *             name: 'custom/my-custom-shortcut',\n *             category: 'my-category',\n *             description: __( 'My custom shortcut' ),\n *             keyCombination: {\n *                 modifier: 'primary',\n *                 character: 'j',\n *             },\n *         } );\n *     }, [] );\n *\n *     const shortcut = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'custom/my-custom-shortcut'\n *             ),\n *         []\n *     );\n *\n *     return shortcut ? (\n *         <p>{ __( 'Shortcut is registered.' ) }</p>\n *     ) : (\n *         <p>{ __( 'Shortcut is not registered.' ) }</p>\n *     );\n * };\n *```\n * @return {Object} action.\n */\nexport function registerShortcut( {\n\tname,\n\tcategory,\n\tdescription,\n\tkeyCombination,\n\taliases,\n} ) {\n\treturn {\n\t\ttype: 'REGISTER_SHORTCUT',\n\t\tname,\n\t\tcategory,\n\t\tkeyCombination,\n\t\taliases,\n\t\tdescription,\n\t};\n}\n\n/**\n * Returns an action object used to unregister a keyboard shortcut.\n *\n * @param {string} name Shortcut name.\n *\n * @example\n *\n *```js\n * import { useEffect } from 'react';\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect, useDispatch } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const { unregisterShortcut } = useDispatch( keyboardShortcutsStore );\n *\n *     useEffect( () => {\n *         unregisterShortcut( 'core/editor/next-region' );\n *     }, [] );\n *\n *     const shortcut = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return shortcut ? (\n *         <p>{ __( 'Shortcut is not unregistered.' ) }</p>\n *     ) : (\n *         <p>{ __( 'Shortcut is unregistered.' ) }</p>\n *     );\n * };\n *```\n * @return {Object} action.\n */\nexport function unregisterShortcut( name ) {\n\treturn {\n\t\ttype: 'UNREGISTER_SHORTCUT',\n\t\tname,\n\t};\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoEO,SAAS,iBAAkB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,GAAI;AACH,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;AAuCO,SAAS,mBAAoB,MAAO;AAC1C,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
+  "sources": ["../../src/store/actions.ts"],
+  "sourcesContent": ["import type { WPKeycodeModifier } from '@wordpress/keycodes';\n\n/**\n * Keyboard key combination.\n */\nexport interface ShortcutKeyCombination {\n\tcharacter: string;\n\tmodifier: WPKeycodeModifier | undefined;\n}\n\n/**\n * Configuration of a registered keyboard shortcut.\n */\nexport interface ShortcutConfig {\n\tname: string;\n\tcategory: string;\n\tdescription: string;\n\tkeyCombination: ShortcutKeyCombination;\n\taliases?: ShortcutKeyCombination[];\n}\n\nexport type ShortcutAction =\n\t| ReturnType< typeof registerShortcut >\n\t| ReturnType< typeof unregisterShortcut >;\n\n/**\n * Returns an action object used to register a new keyboard shortcut.\n *\n * @param {ShortcutConfig} config Shortcut config.\n *\n * @example\n *\n *```js\n * import { useEffect } from 'react';\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect, useDispatch } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const { registerShortcut } = useDispatch( keyboardShortcutsStore );\n *\n *     useEffect( () => {\n *         registerShortcut( {\n *             name: 'custom/my-custom-shortcut',\n *             category: 'my-category',\n *             description: __( 'My custom shortcut' ),\n *             keyCombination: {\n *                 modifier: 'primary',\n *                 character: 'j',\n *             },\n *         } );\n *     }, [] );\n *\n *     const shortcut = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'custom/my-custom-shortcut'\n *             ),\n *         []\n *     );\n *\n *     return shortcut ? (\n *         <p>{ __( 'Shortcut is registered.' ) }</p>\n *     ) : (\n *         <p>{ __( 'Shortcut is not registered.' ) }</p>\n *     );\n * };\n *```\n * @return {Object} action.\n */\nexport function registerShortcut( {\n\tname,\n\tcategory,\n\tdescription,\n\tkeyCombination,\n\taliases,\n}: ShortcutConfig ) {\n\treturn {\n\t\ttype: 'REGISTER_SHORTCUT' as const,\n\t\tname,\n\t\tcategory,\n\t\tkeyCombination,\n\t\taliases,\n\t\tdescription,\n\t};\n}\n\n/**\n * Returns an action object used to unregister a keyboard shortcut.\n *\n * @param {string} name Shortcut name.\n *\n * @example\n *\n *```js\n * import { useEffect } from 'react';\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect, useDispatch } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const { unregisterShortcut } = useDispatch( keyboardShortcutsStore );\n *\n *     useEffect( () => {\n *         unregisterShortcut( 'core/editor/next-region' );\n *     }, [] );\n *\n *     const shortcut = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return shortcut ? (\n *         <p>{ __( 'Shortcut is not unregistered.' ) }</p>\n *     ) : (\n *         <p>{ __( 'Shortcut is unregistered.' ) }</p>\n *     );\n * };\n *```\n * @return {Object} action.\n */\nexport function unregisterShortcut( name: string ) {\n\treturn {\n\t\ttype: 'UNREGISTER_SHORTCUT' as const,\n\t\tname,\n\t};\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsEO,SAAS,iBAAkB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,GAAoB;AACnB,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;AAuCO,SAAS,mBAAoB,MAAe;AAClD,SAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACD;AACD;",
   "names": []
 }

package/build/store/index.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -26,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/store/index.js
+// packages/keyboard-shortcuts/src/store/index.ts
 var store_exports = {};
 __export(store_exports, {
   store: () => store

package/build/store/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/index.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createReduxStore, register } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport reducer from './reducer';\nimport * as actions from './actions';\nimport * as selectors from './selectors';\n\nconst STORE_NAME = 'core/keyboard-shortcuts';\n\n/**\n * Store definition for the keyboard shortcuts namespace.\n *\n * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore\n *\n * @type {Object}\n */\nexport const store = createReduxStore( STORE_NAME, {\n\treducer,\n\tactions,\n\tselectors,\n} );\n\nregister( store );\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2C;AAK3C,qBAAoB;AACpB,cAAyB;AACzB,gBAA2B;AAE3B,IAAM,aAAa;AASZ,IAAM,YAAQ,8BAAkB,YAAY;AAAA,EAClD,wBAAAA;AAAA,EACA;AAAA,EACA;AACD,CAAE;AAAA,IAEF,sBAAU,KAAM;",
+  "sources": ["../../src/store/index.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createReduxStore, register } from '@wordpress/data';\n\n/**\n * Internal dependencies\n */\nimport reducer from './reducer';\nimport * as actions from './actions';\nimport * as selectors from './selectors';\n\nconst STORE_NAME = 'core/keyboard-shortcuts';\n\n/**\n * Store definition for the keyboard shortcuts namespace.\n *\n * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/data/README.md#createReduxStore\n */\nexport const store = createReduxStore( STORE_NAME, {\n\treducer,\n\tactions,\n\tselectors,\n} );\n\nregister( store );\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA2C;AAK3C,qBAAoB;AACpB,cAAyB;AACzB,gBAA2B;AAE3B,IAAM,aAAa;AAOZ,IAAM,YAAQ,8BAAkB,YAAY;AAAA,EAClD,wBAAAA;AAAA,EACA;AAAA,EACA;AACD,CAAE;AAAA,IAEF,sBAAU,KAAM;",
   "names": ["reducer"]
 }

package/build/store/reducer.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/store/reducer.js
+// packages/keyboard-shortcuts/src/store/reducer.ts
 var reducer_exports = {};
 __export(reducer_exports, {
   default: () => reducer_default

package/build/store/reducer.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/reducer.js"],
-  "sourcesContent": ["/**\n * Reducer returning the registered shortcuts\n *\n * @param {Object} state  Current state.\n * @param {Object} action Dispatched action.\n *\n * @return {Object} Updated state.\n */\nfunction reducer( state = {}, action ) {\n\tswitch ( action.type ) {\n\t\tcase 'REGISTER_SHORTCUT':\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\t[ action.name ]: {\n\t\t\t\t\tcategory: action.category,\n\t\t\t\t\tkeyCombination: action.keyCombination,\n\t\t\t\t\taliases: action.aliases,\n\t\t\t\t\tdescription: action.description,\n\t\t\t\t},\n\t\t\t};\n\t\tcase 'UNREGISTER_SHORTCUT':\n\t\t\tconst { [ action.name ]: actionName, ...remainingState } = state;\n\t\t\treturn remainingState;\n\t}\n\n\treturn state;\n}\n\nexport default reducer;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,QAAS,QAAQ,CAAC,GAAG,QAAS;AACtC,UAAS,OAAO,MAAO;AAAA,IACtB,KAAK;AACJ,aAAO;AAAA,QACN,GAAG;AAAA,QACH,CAAE,OAAO,IAAK,GAAG;AAAA,UAChB,UAAU,OAAO;AAAA,UACjB,gBAAgB,OAAO;AAAA,UACvB,SAAS,OAAO;AAAA,UAChB,aAAa,OAAO;AAAA,QACrB;AAAA,MACD;AAAA,IACD,KAAK;AACJ,YAAM,EAAE,CAAE,OAAO,IAAK,GAAG,YAAY,GAAG,eAAe,IAAI;AAC3D,aAAO;AAAA,EACT;AAEA,SAAO;AACR;AAEA,IAAO,kBAAQ;",
+  "sources": ["../../src/store/reducer.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport type { ShortcutAction } from './actions';\nimport type { ShortcutsState } from './types';\n\n/**\n * Reducer returning the registered shortcuts\n *\n * @param state  Current state.\n * @param action Dispatched action.\n *\n * @return Updated state.\n */\nfunction reducer(\n\tstate: ShortcutsState = {},\n\taction: ShortcutAction\n): ShortcutsState {\n\tswitch ( action.type ) {\n\t\tcase 'REGISTER_SHORTCUT':\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\t[ action.name ]: {\n\t\t\t\t\tcategory: action.category,\n\t\t\t\t\tkeyCombination: action.keyCombination,\n\t\t\t\t\taliases: action.aliases,\n\t\t\t\t\tdescription: action.description,\n\t\t\t\t},\n\t\t\t};\n\t\tcase 'UNREGISTER_SHORTCUT':\n\t\t\tconst { [ action.name ]: actionName, ...remainingState } = state;\n\t\t\treturn remainingState;\n\t}\n\n\treturn state;\n}\n\nexport default reducer;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAcA,SAAS,QACR,QAAwB,CAAC,GACzB,QACiB;AACjB,UAAS,OAAO,MAAO;AAAA,IACtB,KAAK;AACJ,aAAO;AAAA,QACN,GAAG;AAAA,QACH,CAAE,OAAO,IAAK,GAAG;AAAA,UAChB,UAAU,OAAO;AAAA,UACjB,gBAAgB,OAAO;AAAA,UACvB,SAAS,OAAO;AAAA,UAChB,aAAa,OAAO;AAAA,QACrB;AAAA,MACD;AAAA,IACD,KAAK;AACJ,YAAM,EAAE,CAAE,OAAO,IAAK,GAAG,YAAY,GAAG,eAAe,IAAI;AAC3D,aAAO;AAAA,EACT;AAEA,SAAO;AACR;AAEA,IAAO,kBAAQ;",
   "names": []
 }

package/build/store/selectors.cjs

@@ -1,3 +1,4 @@
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -16,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/keyboard-shortcuts/src/store/selectors.js
+// packages/keyboard-shortcuts/src/store/selectors.ts
 var selectors_exports = {};
 __export(selectors_exports, {
   getAllShortcutKeyCombinations: () => getAllShortcutKeyCombinations,
@@ -32,8 +33,17 @@ var import_data = require("@wordpress/data");
 var import_keycodes = require("@wordpress/keycodes");
 var EMPTY_ARRAY = [];
 var FORMATTING_METHODS = {
+  /**
+   * Display formatting.
+   */
   display: import_keycodes.displayShortcut,
+  /**
+   * Raw shortcut formatting.
+   */
   raw: import_keycodes.rawShortcut,
+  /**
+   * ARIA label formatting.
+   */
   ariaLabel: import_keycodes.shortcutAriaLabel
 };
 function getKeyCombinationRepresentation(shortcut, representation) {
@@ -62,7 +72,9 @@ var getAllShortcutKeyCombinations = (0, import_data.createSelector)(
     return [
       getShortcutKeyCombination(state, name),
       ...getShortcutAliases(state, name)
-    ].filter(Boolean);
+    ].filter(
+      (combination) => !!combination
+    );
   },
   (state, name) => [state[name]]
 );

package/build/store/selectors.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/store/selectors.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createSelector } from '@wordpress/data';\nimport {\n\tdisplayShortcut,\n\tshortcutAriaLabel,\n\trawShortcut,\n} from '@wordpress/keycodes';\n\n/** @typedef {import('./actions').WPShortcutKeyCombination} WPShortcutKeyCombination */\n\n/** @typedef {import('@wordpress/keycodes').WPKeycodeHandlerByModifier} WPKeycodeHandlerByModifier */\n\n/**\n * Shared reference to an empty array for cases where it is important to avoid\n * returning a new array reference on every invocation.\n *\n * @type {Array<any>}\n */\nconst EMPTY_ARRAY = [];\n\n/**\n * Shortcut formatting methods.\n *\n * @property {WPKeycodeHandlerByModifier} display     Display formatting.\n * @property {WPKeycodeHandlerByModifier} rawShortcut Raw shortcut formatting.\n * @property {WPKeycodeHandlerByModifier} ariaLabel   ARIA label formatting.\n */\nconst FORMATTING_METHODS = {\n\tdisplay: displayShortcut,\n\traw: rawShortcut,\n\tariaLabel: shortcutAriaLabel,\n};\n\n/**\n * Returns a string representing the key combination.\n *\n * @param {?WPShortcutKeyCombination} shortcut       Key combination.\n * @param {keyof FORMATTING_METHODS}  representation Type of representation\n *                                                   (display, raw, ariaLabel).\n *\n * @return {?string} Shortcut representation.\n */\nfunction getKeyCombinationRepresentation( shortcut, representation ) {\n\tif ( ! shortcut ) {\n\t\treturn null;\n\t}\n\n\treturn shortcut.modifier\n\t\t? FORMATTING_METHODS[ representation ][ shortcut.modifier ](\n\t\t\t\tshortcut.character\n\t\t  )\n\t\t: shortcut.character;\n}\n\n/**\n * Returns the main key combination for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const {character, modifier} = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         <div>\n *             { createInterpolateElement(\n *                 sprintf(\n *                     'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                     character,\n *                     modifier\n *                 ),\n *                 {\n *                     code: <code />,\n *                 }\n *             ) }\n *         </div>\n *     );\n * };\n *```\n *\n * @return {WPShortcutKeyCombination?} Key combination.\n */\nexport function getShortcutKeyCombination( state, name ) {\n\treturn state[ name ] ? state[ name ].keyCombination : null;\n}\n\n/**\n * Returns a string representing the main key combination for a given shortcut name.\n *\n * @param {Object}                   state          Global state.\n * @param {string}                   name           Shortcut name.\n * @param {keyof FORMATTING_METHODS} representation Type of representation\n *                                                  (display, raw, ariaLabel).\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const {display, raw, ariaLabel} = useSelect(\n *         ( select ) =>{\n *             return {\n *                 display: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region' ),\n *                 raw: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region','raw' ),\n *                 ariaLabel: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region', 'ariaLabel')\n *             }\n *         },\n *         []\n *     );\n *\n *     return (\n *         <ul>\n *             <li>{ sprintf( 'display string: %s', display ) }</li>\n *             <li>{ sprintf( 'raw string: %s', raw ) }</li>\n *             <li>{ sprintf( 'ariaLabel string: %s', ariaLabel ) }</li>\n *         </ul>\n *     );\n * };\n *```\n *\n * @return {?string} Shortcut representation.\n */\nexport function getShortcutRepresentation(\n\tstate,\n\tname,\n\trepresentation = 'display'\n) {\n\tconst shortcut = getShortcutKeyCombination( state, name );\n\treturn getKeyCombinationRepresentation( shortcut, representation );\n}\n\n/**\n * Returns the shortcut description given its name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const shortcutDescription = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutDescription( 'core/editor/next-region' ),\n *         []\n *     );\n *\n *     return shortcutDescription ? (\n *         <div>{ shortcutDescription }</div>\n *     ) : (\n *         <div>{ __( 'No description.' ) }</div>\n *     );\n * };\n *```\n * @return {?string} Shortcut description.\n */\nexport function getShortcutDescription( state, name ) {\n\treturn state[ name ] ? state[ name ].description : null;\n}\n\n/**\n * Returns the aliases for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const shortcutAliases = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutAliases(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         shortcutAliases.length > 0 && (\n *             <ul>\n *                 { shortcutAliases.map( ( { character, modifier }, index ) => (\n *                     <li key={ index }>\n *                         { createInterpolateElement(\n *                             sprintf(\n *                                 'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                                 character,\n *                                 modifier\n *                             ),\n *                             {\n *                                 code: <code />,\n *                             }\n *                         ) }\n *                     </li>\n *                 ) ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {WPShortcutKeyCombination[]} Key combinations.\n */\nexport function getShortcutAliases( state, name ) {\n\treturn state[ name ] && state[ name ].aliases\n\t\t? state[ name ].aliases\n\t\t: EMPTY_ARRAY;\n}\n\n/**\n * Returns the shortcuts that include aliases for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const allShortcutKeyCombinations = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getAllShortcutKeyCombinations(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         allShortcutKeyCombinations.length > 0 && (\n *             <ul>\n *                 { allShortcutKeyCombinations.map(\n *                     ( { character, modifier }, index ) => (\n *                         <li key={ index }>\n *                             { createInterpolateElement(\n *                                 sprintf(\n *                                     'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                                     character,\n *                                     modifier\n *                                 ),\n *                                 {\n *                                     code: <code />,\n *                                 }\n *                             ) }\n *                         </li>\n *                     )\n *                 ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {WPShortcutKeyCombination[]} Key combinations.\n */\nexport const getAllShortcutKeyCombinations = createSelector(\n\t( state, name ) => {\n\t\treturn [\n\t\t\tgetShortcutKeyCombination( state, name ),\n\t\t\t...getShortcutAliases( state, name ),\n\t\t].filter( Boolean );\n\t},\n\t( state, name ) => [ state[ name ] ]\n);\n\n/**\n * Returns the raw representation of all the keyboard combinations of a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const allShortcutRawKeyCombinations = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getAllShortcutRawKeyCombinations(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         allShortcutRawKeyCombinations.length > 0 && (\n *             <ul>\n *                 { allShortcutRawKeyCombinations.map(\n *                     ( shortcutRawKeyCombination, index ) => (\n *                         <li key={ index }>\n *                             { createInterpolateElement(\n *                                 sprintf(\n *                                     ' <code>%s</code>',\n *                                     shortcutRawKeyCombination\n *                                 ),\n *                                 {\n *                                     code: <code />,\n *                                 }\n *                             ) }\n *                         </li>\n *                     )\n *                 ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {string[]} Shortcuts.\n */\nexport const getAllShortcutRawKeyCombinations = createSelector(\n\t( state, name ) => {\n\t\treturn getAllShortcutKeyCombinations( state, name ).map(\n\t\t\t( combination ) =>\n\t\t\t\tgetKeyCombinationRepresentation( combination, 'raw' )\n\t\t);\n\t},\n\t( state, name ) => [ state[ name ] ]\n);\n\n/**\n * Returns the shortcut names list for a given category name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Category name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n *\n * const ExampleComponent = () => {\n *     const categoryShortcuts = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getCategoryShortcuts(\n *                 'block'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         categoryShortcuts.length > 0 && (\n *             <ul>\n *                 { categoryShortcuts.map( ( categoryShortcut ) => (\n *                     <li key={ categoryShortcut }>{ categoryShortcut }</li>\n *                 ) ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n * @return {string[]} Shortcut names.\n */\nexport const getCategoryShortcuts = createSelector(\n\t( state, categoryName ) => {\n\t\treturn Object.entries( state )\n\t\t\t.filter( ( [ , shortcut ] ) => shortcut.category === categoryName )\n\t\t\t.map( ( [ name ] ) => name );\n\t},\n\t( state ) => [ state ]\n);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA+B;AAC/B,sBAIO;AAYP,IAAM,cAAc,CAAC;AASrB,IAAM,qBAAqB;AAAA,EAC1B,SAAS;AAAA,EACT,KAAK;AAAA,EACL,WAAW;AACZ;AAWA,SAAS,gCAAiC,UAAU,gBAAiB;AACpE,MAAK,CAAE,UAAW;AACjB,WAAO;AAAA,EACR;AAEA,SAAO,SAAS,WACb,mBAAoB,cAAe,EAAG,SAAS,QAAS;AAAA,IACxD,SAAS;AAAA,EACT,IACA,SAAS;AACb;AA2CO,SAAS,0BAA2B,OAAO,MAAO;AACxD,SAAO,MAAO,IAAK,IAAI,MAAO,IAAK,EAAE,iBAAiB;AACvD;AAwCO,SAAS,0BACf,OACA,MACA,iBAAiB,WAChB;AACD,QAAM,WAAW,0BAA2B,OAAO,IAAK;AACxD,SAAO,gCAAiC,UAAU,cAAe;AAClE;AA8BO,SAAS,uBAAwB,OAAO,MAAO;AACrD,SAAO,MAAO,IAAK,IAAI,MAAO,IAAK,EAAE,cAAc;AACpD;AAgDO,SAAS,mBAAoB,OAAO,MAAO;AACjD,SAAO,MAAO,IAAK,KAAK,MAAO,IAAK,EAAE,UACnC,MAAO,IAAK,EAAE,UACd;AACJ;AAmDO,IAAM,oCAAgC;AAAA,EAC5C,CAAE,OAAO,SAAU;AAClB,WAAO;AAAA,MACN,0BAA2B,OAAO,IAAK;AAAA,MACvC,GAAG,mBAAoB,OAAO,IAAK;AAAA,IACpC,EAAE,OAAQ,OAAQ;AAAA,EACnB;AAAA,EACA,CAAE,OAAO,SAAU,CAAE,MAAO,IAAK,CAAE;AACpC;AAmDO,IAAM,uCAAmC;AAAA,EAC/C,CAAE,OAAO,SAAU;AAClB,WAAO,8BAA+B,OAAO,IAAK,EAAE;AAAA,MACnD,CAAE,gBACD,gCAAiC,aAAa,KAAM;AAAA,IACtD;AAAA,EACD;AAAA,EACA,CAAE,OAAO,SAAU,CAAE,MAAO,IAAK,CAAE;AACpC;AAmCO,IAAM,2BAAuB;AAAA,EACnC,CAAE,OAAO,iBAAkB;AAC1B,WAAO,OAAO,QAAS,KAAM,EAC3B,OAAQ,CAAE,CAAE,EAAE,QAAS,MAAO,SAAS,aAAa,YAAa,EACjE,IAAK,CAAE,CAAE,IAAK,MAAO,IAAK;AAAA,EAC7B;AAAA,EACA,CAAE,UAAW,CAAE,KAAM;AACtB;",
+  "sources": ["../../src/store/selectors.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createSelector } from '@wordpress/data';\nimport {\n\tdisplayShortcut,\n\tshortcutAriaLabel,\n\trawShortcut,\n} from '@wordpress/keycodes';\n\n/**\n * Internal dependencies\n */\nimport type { ShortcutKeyCombination } from './actions';\n\ninterface ShortcutState {\n\tcategory: string;\n\tkeyCombination: ShortcutKeyCombination;\n\taliases?: ShortcutKeyCombination[];\n\tdescription: string;\n}\n\ntype ShortcutsState = Record< string, ShortcutState >;\n\n/**\n * Shared reference to an empty array for cases where it is important to avoid\n * returning a new array reference on every invocation.\n */\nconst EMPTY_ARRAY: ShortcutKeyCombination[] = [];\n\n/**\n * Shortcut formatting methods.\n */\nconst FORMATTING_METHODS = {\n\t/**\n\t * Display formatting.\n\t */\n\tdisplay: displayShortcut,\n\t/**\n\t * Raw shortcut formatting.\n\t */\n\traw: rawShortcut,\n\t/**\n\t * ARIA label formatting.\n\t */\n\tariaLabel: shortcutAriaLabel,\n};\n\n/**\n * Returns a string representing the key combination.\n *\n * @param shortcut       Key combination.\n * @param representation Type of representation\n *                       (display, raw, ariaLabel).\n *\n * @return Shortcut representation.\n */\nfunction getKeyCombinationRepresentation(\n\tshortcut: ShortcutKeyCombination | null,\n\trepresentation: keyof typeof FORMATTING_METHODS\n): string | null {\n\tif ( ! shortcut ) {\n\t\treturn null;\n\t}\n\n\treturn shortcut.modifier\n\t\t? FORMATTING_METHODS[ representation ][ shortcut.modifier ](\n\t\t\t\tshortcut.character\n\t\t  )\n\t\t: shortcut.character;\n}\n\n/**\n * Returns the main key combination for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const {character, modifier} = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutKeyCombination(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         <div>\n *             { createInterpolateElement(\n *                 sprintf(\n *                     'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                     character,\n *                     modifier\n *                 ),\n *                 {\n *                     code: <code />,\n *                 }\n *             ) }\n *         </div>\n *     );\n * };\n *```\n *\n * @return {ShortcutKeyCombination?} Key combination.\n */\nexport function getShortcutKeyCombination(\n\tstate: ShortcutsState,\n\tname: string\n): ShortcutKeyCombination | null {\n\treturn state[ name ] ? state[ name ].keyCombination : null;\n}\n\n/**\n * Returns a string representing the main key combination for a given shortcut name.\n *\n * @param {Object}                   state          Global state.\n * @param {string}                   name           Shortcut name.\n * @param {keyof FORMATTING_METHODS} representation Type of representation\n *                                                  (display, raw, ariaLabel).\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const {display, raw, ariaLabel} = useSelect(\n *         ( select ) =>{\n *             return {\n *                 display: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region' ),\n *                 raw: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region','raw' ),\n *                 ariaLabel: select( keyboardShortcutsStore ).getShortcutRepresentation('core/editor/next-region', 'ariaLabel')\n *             }\n *         },\n *         []\n *     );\n *\n *     return (\n *         <ul>\n *             <li>{ sprintf( 'display string: %s', display ) }</li>\n *             <li>{ sprintf( 'raw string: %s', raw ) }</li>\n *             <li>{ sprintf( 'ariaLabel string: %s', ariaLabel ) }</li>\n *         </ul>\n *     );\n * };\n *```\n *\n * @return {?string} Shortcut representation.\n */\nexport function getShortcutRepresentation(\n\tstate: ShortcutsState,\n\tname: string,\n\trepresentation: keyof typeof FORMATTING_METHODS = 'display'\n): string | null {\n\tconst shortcut = getShortcutKeyCombination( state, name );\n\treturn getKeyCombinationRepresentation( shortcut, representation );\n}\n\n/**\n * Returns the shortcut description given its name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { __ } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const shortcutDescription = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutDescription( 'core/editor/next-region' ),\n *         []\n *     );\n *\n *     return shortcutDescription ? (\n *         <div>{ shortcutDescription }</div>\n *     ) : (\n *         <div>{ __( 'No description.' ) }</div>\n *     );\n * };\n *```\n * @return {?string} Shortcut description.\n */\nexport function getShortcutDescription(\n\tstate: ShortcutsState,\n\tname: string\n): string | null {\n\treturn state[ name ] ? state[ name ].description : null;\n}\n\n/**\n * Returns the aliases for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n * const ExampleComponent = () => {\n *     const shortcutAliases = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getShortcutAliases(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         shortcutAliases.length > 0 && (\n *             <ul>\n *                 { shortcutAliases.map( ( { character, modifier }, index ) => (\n *                     <li key={ index }>\n *                         { createInterpolateElement(\n *                             sprintf(\n *                                 'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                                 character,\n *                                 modifier\n *                             ),\n *                             {\n *                                 code: <code />,\n *                             }\n *                         ) }\n *                     </li>\n *                 ) ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {ShortcutKeyCombination[]} Key combinations.\n */\nexport function getShortcutAliases(\n\tstate: ShortcutsState,\n\tname: string\n): ShortcutKeyCombination[] {\n\treturn state[ name ] && state[ name ].aliases\n\t\t? state[ name ].aliases\n\t\t: EMPTY_ARRAY;\n}\n\n/**\n * Returns the shortcuts that include aliases for a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const allShortcutKeyCombinations = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getAllShortcutKeyCombinations(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         allShortcutKeyCombinations.length > 0 && (\n *             <ul>\n *                 { allShortcutKeyCombinations.map(\n *                     ( { character, modifier }, index ) => (\n *                         <li key={ index }>\n *                             { createInterpolateElement(\n *                                 sprintf(\n *                                     'Character: <code>%s</code> / Modifier: <code>%s</code>',\n *                                     character,\n *                                     modifier\n *                                 ),\n *                                 {\n *                                     code: <code />,\n *                                 }\n *                             ) }\n *                         </li>\n *                     )\n *                 ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {ShortcutKeyCombination[]} Key combinations.\n */\nexport const getAllShortcutKeyCombinations = createSelector(\n\t( state, name ) => {\n\t\treturn [\n\t\t\tgetShortcutKeyCombination( state, name ),\n\t\t\t...getShortcutAliases( state, name ),\n\t\t].filter(\n\t\t\t( combination ): combination is ShortcutKeyCombination =>\n\t\t\t\t!! combination\n\t\t);\n\t},\n\t( state, name ) => [ state[ name ] ]\n);\n\n/**\n * Returns the raw representation of all the keyboard combinations of a given shortcut name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Shortcut name.\n *\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n * import { createInterpolateElement } from '@wordpress/element';\n * import { sprintf } from '@wordpress/i18n';\n *\n * const ExampleComponent = () => {\n *     const allShortcutRawKeyCombinations = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getAllShortcutRawKeyCombinations(\n *                 'core/editor/next-region'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         allShortcutRawKeyCombinations.length > 0 && (\n *             <ul>\n *                 { allShortcutRawKeyCombinations.map(\n *                     ( shortcutRawKeyCombination, index ) => (\n *                         <li key={ index }>\n *                             { createInterpolateElement(\n *                                 sprintf(\n *                                     ' <code>%s</code>',\n *                                     shortcutRawKeyCombination\n *                                 ),\n *                                 {\n *                                     code: <code />,\n *                                 }\n *                             ) }\n *                         </li>\n *                     )\n *                 ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n *\n * @return {string[]} Shortcuts.\n */\nexport const getAllShortcutRawKeyCombinations = createSelector(\n\t( state, name ) => {\n\t\treturn getAllShortcutKeyCombinations( state, name ).map(\n\t\t\t( combination ) =>\n\t\t\t\tgetKeyCombinationRepresentation( combination, 'raw' )\n\t\t);\n\t},\n\t( state, name ) => [ state[ name ] ]\n);\n\n/**\n * Returns the shortcut names list for a given category name.\n *\n * @param {Object} state Global state.\n * @param {string} name  Category name.\n * @example\n *\n *```js\n * import { store as keyboardShortcutsStore } from '@wordpress/keyboard-shortcuts';\n * import { useSelect } from '@wordpress/data';\n *\n * const ExampleComponent = () => {\n *     const categoryShortcuts = useSelect(\n *         ( select ) =>\n *             select( keyboardShortcutsStore ).getCategoryShortcuts(\n *                 'block'\n *             ),\n *         []\n *     );\n *\n *     return (\n *         categoryShortcuts.length > 0 && (\n *             <ul>\n *                 { categoryShortcuts.map( ( categoryShortcut ) => (\n *                     <li key={ categoryShortcut }>{ categoryShortcut }</li>\n *                 ) ) }\n *             </ul>\n *         )\n *     );\n * };\n *```\n * @return {string[]} Shortcut names.\n */\nexport const getCategoryShortcuts = createSelector(\n\t( state: ShortcutsState, categoryName: string ): string[] => {\n\t\treturn Object.entries< ShortcutState >( state )\n\t\t\t.filter( ( [ , shortcut ] ) => shortcut.category === categoryName )\n\t\t\t.map( ( [ name ] ) => name );\n\t},\n\t( state: ShortcutsState ) => [ state ]\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAA+B;AAC/B,sBAIO;AAoBP,IAAM,cAAwC,CAAC;AAK/C,IAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA,EAI1B,SAAS;AAAA;AAAA;AAAA;AAAA,EAIT,KAAK;AAAA;AAAA;AAAA;AAAA,EAIL,WAAW;AACZ;AAWA,SAAS,gCACR,UACA,gBACgB;AAChB,MAAK,CAAE,UAAW;AACjB,WAAO;AAAA,EACR;AAEA,SAAO,SAAS,WACb,mBAAoB,cAAe,EAAG,SAAS,QAAS;AAAA,IACxD,SAAS;AAAA,EACT,IACA,SAAS;AACb;AA2CO,SAAS,0BACf,OACA,MACgC;AAChC,SAAO,MAAO,IAAK,IAAI,MAAO,IAAK,EAAE,iBAAiB;AACvD;AAwCO,SAAS,0BACf,OACA,MACA,iBAAkD,WAClC;AAChB,QAAM,WAAW,0BAA2B,OAAO,IAAK;AACxD,SAAO,gCAAiC,UAAU,cAAe;AAClE;AA8BO,SAAS,uBACf,OACA,MACgB;AAChB,SAAO,MAAO,IAAK,IAAI,MAAO,IAAK,EAAE,cAAc;AACpD;AAgDO,SAAS,mBACf,OACA,MAC2B;AAC3B,SAAO,MAAO,IAAK,KAAK,MAAO,IAAK,EAAE,UACnC,MAAO,IAAK,EAAE,UACd;AACJ;AAmDO,IAAM,oCAAgC;AAAA,EAC5C,CAAE,OAAO,SAAU;AAClB,WAAO;AAAA,MACN,0BAA2B,OAAO,IAAK;AAAA,MACvC,GAAG,mBAAoB,OAAO,IAAK;AAAA,IACpC,EAAE;AAAA,MACD,CAAE,gBACD,CAAC,CAAE;AAAA,IACL;AAAA,EACD;AAAA,EACA,CAAE,OAAO,SAAU,CAAE,MAAO,IAAK,CAAE;AACpC;AAmDO,IAAM,uCAAmC;AAAA,EAC/C,CAAE,OAAO,SAAU;AAClB,WAAO,8BAA+B,OAAO,IAAK,EAAE;AAAA,MACnD,CAAE,gBACD,gCAAiC,aAAa,KAAM;AAAA,IACtD;AAAA,EACD;AAAA,EACA,CAAE,OAAO,SAAU,CAAE,MAAO,IAAK,CAAE;AACpC;AAmCO,IAAM,2BAAuB;AAAA,EACnC,CAAE,OAAuB,iBAAoC;AAC5D,WAAO,OAAO,QAA0B,KAAM,EAC5C,OAAQ,CAAE,CAAE,EAAE,QAAS,MAAO,SAAS,aAAa,YAAa,EACjE,IAAK,CAAE,CAAE,IAAK,MAAO,IAAK;AAAA,EAC7B;AAAA,EACA,CAAE,UAA2B,CAAE,KAAM;AACtC;",
   "names": []
 }

package/build/store/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/keyboard-shortcuts/src/store/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/build/store/types.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/store/types.ts"],
+  "sourcesContent": ["import type { ShortcutKeyCombination } from './actions';\n\nexport interface ShortcutState {\n\tcategory: string;\n\tkeyCombination: ShortcutKeyCombination;\n\taliases?: ShortcutKeyCombination[];\n\tdescription: string;\n}\n\nexport type ShortcutsState = Record< string, ShortcutState >;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build-module/components/shortcut-provider.mjs

@@ -1,16 +1,19 @@
-// packages/keyboard-shortcuts/src/components/shortcut-provider.js
+// packages/keyboard-shortcuts/src/components/shortcut-provider.tsx
 import { useState } from "@wordpress/element";
 import { context } from "../context.mjs";
 import { jsx } from "react/jsx-runtime";
 var { Provider } = context;
 function ShortcutProvider(props) {
-  const [keyboardShortcuts] = useState(() => /* @__PURE__ */ new Set());
+  const [keyboardShortcuts] = useState(
+    () => /* @__PURE__ */ new Set()
+  );
   function onKeyDown(event) {
     if (props.onKeyDown) {
       props.onKeyDown(event);
     }
+    const nativeEvent = event.nativeEvent;
     for (const keyboardShortcut of keyboardShortcuts) {
-      keyboardShortcut(event);
+      keyboardShortcut(nativeEvent);
     }
   }
   return /* @__PURE__ */ jsx(Provider, { value: keyboardShortcuts, children: /* @__PURE__ */ jsx("div", { ...props, onKeyDown }) });

package/build-module/components/shortcut-provider.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/components/shortcut-provider.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useState } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport { context } from '../context';\n\nconst { Provider } = context;\n\n/**\n * Handles callbacks added to context by `useShortcut`.\n * Adding a provider allows to register contextual shortcuts\n * that are only active when a certain part of the UI is focused.\n *\n * @param {Object} props Props to pass to `div`.\n *\n * @return {Element} Component.\n */\nexport function ShortcutProvider( props ) {\n\tconst [ keyboardShortcuts ] = useState( () => new Set() );\n\n\tfunction onKeyDown( event ) {\n\t\tif ( props.onKeyDown ) {\n\t\t\tprops.onKeyDown( event );\n\t\t}\n\n\t\tfor ( const keyboardShortcut of keyboardShortcuts ) {\n\t\t\tkeyboardShortcut( event );\n\t\t}\n\t}\n\n\t/* eslint-disable jsx-a11y/no-static-element-interactions */\n\treturn (\n\t\t<Provider value={ keyboardShortcuts }>\n\t\t\t<div { ...props } onKeyDown={ onKeyDown } />\n\t\t</Provider>\n\t);\n\t/* eslint-enable jsx-a11y/no-static-element-interactions */\n}\n"],
-  "mappings": ";AAGA,SAAS,gBAAgB;AAKzB,SAAS,eAAe;AA6BrB;AA3BH,IAAM,EAAE,SAAS,IAAI;AAWd,SAAS,iBAAkB,OAAQ;AACzC,QAAM,CAAE,iBAAkB,IAAI,SAAU,MAAM,oBAAI,IAAI,CAAE;AAExD,WAAS,UAAW,OAAQ;AAC3B,QAAK,MAAM,WAAY;AACtB,YAAM,UAAW,KAAM;AAAA,IACxB;AAEA,eAAY,oBAAoB,mBAAoB;AACnD,uBAAkB,KAAM;AAAA,IACzB;AAAA,EACD;AAGA,SACC,oBAAC,YAAS,OAAQ,mBACjB,8BAAC,SAAM,GAAG,OAAQ,WAAwB,GAC3C;AAGF;",
+  "sources": ["../../src/components/shortcut-provider.tsx"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useState } from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport { context } from '../context';\n\nconst { Provider } = context;\n\ntype ShortcutCallback = ( event: KeyboardEvent ) => void;\n\ninterface ShortcutProviderProps extends React.HTMLAttributes< HTMLDivElement > {\n\tonKeyDown?: ( event: React.KeyboardEvent< HTMLDivElement > ) => void;\n}\n\n/**\n * Handles callbacks added to context by `useShortcut`.\n * Adding a provider allows to register contextual shortcuts\n * that are only active when a certain part of the UI is focused.\n *\n * @param props Props to pass to `div`.\n *\n * @return Component.\n */\nexport function ShortcutProvider( props: ShortcutProviderProps ) {\n\tconst [ keyboardShortcuts ] = useState(\n\t\t() => new Set< ShortcutCallback >()\n\t);\n\n\tfunction onKeyDown( event: React.KeyboardEvent< HTMLDivElement > ) {\n\t\tif ( props.onKeyDown ) {\n\t\t\tprops.onKeyDown( event );\n\t\t}\n\n\t\t// Convert React event to native KeyboardEvent for compatibility\n\t\tconst nativeEvent = event.nativeEvent;\n\t\tfor ( const keyboardShortcut of keyboardShortcuts ) {\n\t\t\tkeyboardShortcut( nativeEvent );\n\t\t}\n\t}\n\n\t/* eslint-disable jsx-a11y/no-static-element-interactions */\n\treturn (\n\t\t<Provider value={ keyboardShortcuts }>\n\t\t\t<div { ...props } onKeyDown={ onKeyDown } />\n\t\t</Provider>\n\t);\n\t/* eslint-enable jsx-a11y/no-static-element-interactions */\n}\n"],
+  "mappings": ";AAGA,SAAS,gBAAgB;AAKzB,SAAS,eAAe;AAuCrB;AArCH,IAAM,EAAE,SAAS,IAAI;AAiBd,SAAS,iBAAkB,OAA+B;AAChE,QAAM,CAAE,iBAAkB,IAAI;AAAA,IAC7B,MAAM,oBAAI,IAAwB;AAAA,EACnC;AAEA,WAAS,UAAW,OAA+C;AAClE,QAAK,MAAM,WAAY;AACtB,YAAM,UAAW,KAAM;AAAA,IACxB;AAGA,UAAM,cAAc,MAAM;AAC1B,eAAY,oBAAoB,mBAAoB;AACnD,uBAAkB,WAAY;AAAA,IAC/B;AAAA,EACD;AAGA,SACC,oBAAC,YAAS,OAAQ,mBACjB,8BAAC,SAAM,GAAG,OAAQ,WAAwB,GAC3C;AAGF;",
   "names": []
 }

package/build-module/context.mjs

@@ -1,4 +1,4 @@
-// packages/keyboard-shortcuts/src/context.js
+// packages/keyboard-shortcuts/src/context.ts
 import { createContext } from "@wordpress/element";
 var globalShortcuts = /* @__PURE__ */ new Set();
 var globalListener = (event) => {

package/build-module/context.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/context.js"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createContext } from '@wordpress/element';\n\nconst globalShortcuts = new Set();\nconst globalListener = ( event ) => {\n\tfor ( const keyboardShortcut of globalShortcuts ) {\n\t\tkeyboardShortcut( event );\n\t}\n};\n\nexport const context = createContext( {\n\tadd: ( shortcut ) => {\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.addEventListener( 'keydown', globalListener );\n\t\t}\n\t\tglobalShortcuts.add( shortcut );\n\t},\n\tdelete: ( shortcut ) => {\n\t\tglobalShortcuts.delete( shortcut );\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.removeEventListener( 'keydown', globalListener );\n\t\t}\n\t},\n} );\n\ncontext.displayName = 'KeyboardShortcutsContext';\n"],
-  "mappings": ";AAGA,SAAS,qBAAqB;AAE9B,IAAM,kBAAkB,oBAAI,IAAI;AAChC,IAAM,iBAAiB,CAAE,UAAW;AACnC,aAAY,oBAAoB,iBAAkB;AACjD,qBAAkB,KAAM;AAAA,EACzB;AACD;AAEO,IAAM,UAAU,cAAe;AAAA,EACrC,KAAK,CAAE,aAAc;AACpB,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,iBAAkB,WAAW,cAAe;AAAA,IACtD;AACA,oBAAgB,IAAK,QAAS;AAAA,EAC/B;AAAA,EACA,QAAQ,CAAE,aAAc;AACvB,oBAAgB,OAAQ,QAAS;AACjC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,oBAAqB,WAAW,cAAe;AAAA,IACzD;AAAA,EACD;AACD,CAAE;AAEF,QAAQ,cAAc;",
+  "sources": ["../src/context.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { createContext } from '@wordpress/element';\n\ntype ShortcutCallback = ( event: KeyboardEvent ) => void;\n\ninterface ShortcutContextType {\n\tadd: ( shortcut: ShortcutCallback ) => void;\n\tdelete: ( shortcut: ShortcutCallback ) => void;\n}\n\nconst globalShortcuts = new Set< ShortcutCallback >();\nconst globalListener = ( event: KeyboardEvent ) => {\n\tfor ( const keyboardShortcut of globalShortcuts ) {\n\t\tkeyboardShortcut( event );\n\t}\n};\n\nexport const context = createContext< ShortcutContextType >( {\n\tadd: ( shortcut: ShortcutCallback ) => {\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.addEventListener( 'keydown', globalListener );\n\t\t}\n\t\tglobalShortcuts.add( shortcut );\n\t},\n\tdelete: ( shortcut: ShortcutCallback ) => {\n\t\tglobalShortcuts.delete( shortcut );\n\t\tif ( globalShortcuts.size === 0 ) {\n\t\t\tdocument.removeEventListener( 'keydown', globalListener );\n\t\t}\n\t},\n} );\n\ncontext.displayName = 'KeyboardShortcutsContext';\n"],
+  "mappings": ";AAGA,SAAS,qBAAqB;AAS9B,IAAM,kBAAkB,oBAAI,IAAwB;AACpD,IAAM,iBAAiB,CAAE,UAA0B;AAClD,aAAY,oBAAoB,iBAAkB;AACjD,qBAAkB,KAAM;AAAA,EACzB;AACD;AAEO,IAAM,UAAU,cAAsC;AAAA,EAC5D,KAAK,CAAE,aAAgC;AACtC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,iBAAkB,WAAW,cAAe;AAAA,IACtD;AACA,oBAAgB,IAAK,QAAS;AAAA,EAC/B;AAAA,EACA,QAAQ,CAAE,aAAgC;AACzC,oBAAgB,OAAQ,QAAS;AACjC,QAAK,gBAAgB,SAAS,GAAI;AACjC,eAAS,oBAAqB,WAAW,cAAe;AAAA,IACzD;AAAA,EACD;AACD,CAAE;AAEF,QAAQ,cAAc;",
   "names": []
 }