From 6be0083378aa8570baea9b4207d1cf7411a6f532 Mon Sep 17 00:00:00 2001
From: Jarda Snajdr <jsnajdr@gmail.com>
Date: Thu, 5 Dec 2024 13:43:28 +0100
Subject: [PATCH] Keycodes: improve tree shaking by annotating exports as pure
 (#67615)

Co-authored-by: jsnajdr <jsnajdr@git.wordpress.org>
Co-authored-by: youknowriad <youknowriad@git.wordpress.org>
Co-authored-by: tyxla <tyxla@git.wordpress.org>
Co-authored-by: sgomes <sergiomdgomes@git.wordpress.org>
---
 packages/keycodes/src/index.js | 56 ++++++++++++++++------------------
 1 file changed, 27 insertions(+), 29 deletions(-)

diff --git a/packages/keycodes/src/index.js b/packages/keycodes/src/index.js
index 6b01109e2a40db..b6df5e3f4a2145 100644
--- a/packages/keycodes/src/index.js
+++ b/packages/keycodes/src/index.js
@@ -211,9 +211,9 @@ export const modifiers = {
  * @type {WPModifierHandler<WPKeyHandler<string>>} Keyed map of functions to raw
  *                                                 shortcuts.
  */
-export const rawShortcut = mapValues(
-	modifiers,
-	( /** @type {WPModifier} */ modifier ) => {
+export const rawShortcut =
+	/* @__PURE__ */
+	mapValues( modifiers, ( /** @type {WPModifier} */ modifier ) => {
 		return /** @type {WPKeyHandler<string>} */ (
 			character,
 			_isApple = isAppleOS
@@ -222,8 +222,7 @@ export const rawShortcut = mapValues(
 				'+'
 			);
 		};
-	}
-);
+	} );
 
 /**
  * Return an array of the parts of a keyboard shortcut chord for display.
@@ -238,9 +237,9 @@ export const rawShortcut = mapValues(
  * @type {WPModifierHandler<WPKeyHandler<string[]>>} Keyed map of functions to
  *                                                   shortcut sequences.
  */
-export const displayShortcutList = mapValues(
-	modifiers,
-	( /** @type {WPModifier} */ modifier ) => {
+export const displayShortcutList =
+	/* @__PURE__ */
+	mapValues( modifiers, ( /** @type {WPModifier} */ modifier ) => {
 		return /** @type {WPKeyHandler<string[]>} */ (
 			character,
 			_isApple = isAppleOS
@@ -268,8 +267,7 @@ export const displayShortcutList = mapValues(
 
 			return [ ...modifierKeys, capitaliseFirstCharacter( character ) ];
 		};
-	}
-);
+	} );
 
 /**
  * An object that contains functions to display shortcuts.
@@ -284,15 +282,17 @@ export const displayShortcutList = mapValues(
  * @type {WPModifierHandler<WPKeyHandler<string>>} Keyed map of functions to
  *                                                 display shortcuts.
  */
-export const displayShortcut = mapValues(
-	displayShortcutList,
-	( /** @type {WPKeyHandler<string[]>} */ shortcutList ) => {
-		return /** @type {WPKeyHandler<string>} */ (
-			character,
-			_isApple = isAppleOS
-		) => shortcutList( character, _isApple ).join( '' );
-	}
-);
+export const displayShortcut =
+	/* @__PURE__ */
+	mapValues(
+		displayShortcutList,
+		( /** @type {WPKeyHandler<string[]>} */ shortcutList ) => {
+			return /** @type {WPKeyHandler<string>} */ (
+				character,
+				_isApple = isAppleOS
+			) => shortcutList( character, _isApple ).join( '' );
+		}
+	);
 
 /**
  * An object that contains functions to return an aria label for a keyboard
@@ -308,9 +308,9 @@ export const displayShortcut = mapValues(
  * @type {WPModifierHandler<WPKeyHandler<string>>} Keyed map of functions to
  *                                                 shortcut ARIA labels.
  */
-export const shortcutAriaLabel = mapValues(
-	modifiers,
-	( /** @type {WPModifier} */ modifier ) => {
+export const shortcutAriaLabel =
+	/* @__PURE__ */
+	mapValues( modifiers, ( /** @type {WPModifier} */ modifier ) => {
 		return /** @type {WPKeyHandler<string>} */ (
 			character,
 			_isApple = isAppleOS
@@ -338,8 +338,7 @@ export const shortcutAriaLabel = mapValues(
 				)
 				.join( isApple ? ' ' : ' + ' );
 		};
-	}
-);
+	} );
 
 /**
  * From a given KeyboardEvent, returns an array of active modifier constants for
@@ -379,9 +378,9 @@ function getEventModifiers( event ) {
  * @type {WPModifierHandler<WPEventKeyHandler>} Keyed map of functions
  *                                                       to match events.
  */
-export const isKeyboardEvent = mapValues(
-	modifiers,
-	( /** @type {WPModifier} */ getModifiers ) => {
+export const isKeyboardEvent =
+	/* @__PURE__ */
+	mapValues( modifiers, ( /** @type {WPModifier} */ getModifiers ) => {
 		return /** @type {WPEventKeyHandler} */ (
 			event,
 			character,
@@ -439,5 +438,4 @@ export const isKeyboardEvent = mapValues(
 
 			return key === character.toLowerCase();
 		};
-	}
-);
+	} );