npm - @peter.naydenov/cuts - Versions diffs - 2.0.2 → 2.0.3 - Mend

@peter.naydenov/cuts 2.0.2 → 2.0.3

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

Files changed (1029) hide show

package/test-e2e/node_modules/@peter.naydenov/shortcuts/html/bg.png ADDED Viewed

Binary file

package/test-e2e/node_modules/@peter.naydenov/shortcuts/html/favicon.ico ADDED Viewed

Binary file

package/test-e2e/node_modules/@peter.naydenov/shortcuts/html/favicon.svg ADDED Viewed

@@ -0,0 +1,5 @@
+<svg width="165" height="165" viewBox="0 0 165 165" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M120.831 57.2543L84.693 109.505C84.3099 110.059 83.7558 110.474 83.1148 110.687C82.4738 110.9 81.7809 110.898 81.1412 110.684C80.5015 110.469 79.95 110.052 79.5702 109.497C79.1905 108.941 79.0032 108.277 79.037 107.606L80.4833 78.7582L57.1343 73.8064C56.6353 73.7007 56.1704 73.474 55.7807 73.1465C55.391 72.8191 55.0885 72.4009 54.9001 71.929C54.7117 71.4571 54.6432 70.9461 54.7006 70.4412C54.758 69.9364 54.9395 69.4532 55.2291 69.0345L91.3675 16.7837C91.7507 16.2294 92.3048 15.8145 92.9458 15.6018C93.5869 15.3891 94.2798 15.3902 94.9196 15.6051C95.5593 15.8199 96.1109 16.2367 96.4906 16.7923C96.8703 17.3478 97.0575 18.0117 97.0236 18.6833L95.5773 47.5314L118.926 52.4828C119.425 52.5885 119.89 52.8152 120.28 53.1426C120.67 53.4701 120.972 53.8883 121.16 54.3602C121.349 54.8321 121.417 55.3431 121.36 55.8479C121.303 56.3528 121.121 56.836 120.831 57.2547L120.831 57.2543Z" fill="#FCC72B"/>
+<path d="M82.9866 153.343C82.0254 153.344 81.0735 153.156 80.1855 152.788C79.2975 152.42 78.4909 151.88 77.8122 151.2L43.6658 117.056C42.2998 115.683 41.5341 113.824 41.5366 111.887C41.5392 109.95 42.3098 108.092 43.6796 106.723C45.0493 105.353 46.9064 104.582 48.8435 104.579C50.7807 104.577 52.6399 105.342 54.0134 106.708L82.9866 135.678L146.105 72.5626C147.481 71.2088 149.336 70.4536 151.266 70.4615C153.197 70.4693 155.046 71.2396 156.41 72.6045C157.775 73.9695 158.546 75.8184 158.554 77.7487C158.561 79.679 157.806 81.5342 156.452 82.9101L88.1597 151.2C87.4811 151.881 86.6747 152.42 85.7869 152.788C84.8992 153.156 83.9475 153.344 82.9866 153.343Z" fill="#729B1B"/>
+<path d="M82.9572 153.343C83.9184 153.344 84.8703 153.156 85.7583 152.788C86.6463 152.42 87.4528 151.88 88.1316 151.2L122.278 117.056C123.644 115.683 124.41 113.824 124.407 111.887C124.405 109.95 123.634 108.092 122.264 106.723C120.894 105.353 119.037 104.582 117.1 104.579C115.163 104.577 113.304 105.342 111.93 106.708L82.9572 135.678L19.8389 72.5626C18.4629 71.2088 16.6077 70.4536 14.6775 70.4615C12.7472 70.4693 10.8982 71.2396 9.53331 72.6045C8.16839 73.9695 7.39811 75.8184 7.39025 77.7487C7.38239 79.679 8.13759 81.5342 9.49135 82.9101L77.784 151.2C78.4627 151.881 79.2691 152.42 80.1568 152.788C81.0446 153.156 81.9963 153.344 82.9572 153.343Z" fill="#729B1B" fill-opacity="0.5"/>
+</svg>

package/test-e2e/node_modules/@peter.naydenov/shortcuts/html/html.meta.json.gz ADDED Viewed

Binary file

package/test-e2e/node_modules/@peter.naydenov/shortcuts/html/index.html ADDED Viewed

@@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="./favicon.ico" sizes="48x48">
+    <link rel="icon" href="./favicon.svg" sizes="any" type="image/svg+xml">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vitest</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Readex+Pro:wght@300;400&display=swap"
+      rel="stylesheet"
+    />
+    <script>
+      (function () {
+        const prefersDark =
+          window.matchMedia &&
+          window.matchMedia("(prefers-color-scheme: dark)").matches;
+        const setting = localStorage.getItem("vueuse-color-scheme") || "auto";
+        if (setting === "dark" || (prefersDark && setting !== "light"))
+          document.documentElement.classList.toggle("dark", true);
+      })();
+    </script>
+    <script>window.METADATA_PATH="html.meta.json.gz"</script>
+    <script type="module" src="./assets/index-DOkKC3NI.js"></script>
+    <link rel="stylesheet" href="./assets/index-COTh6lXR.css">
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>

package/test-e2e/node_modules/@peter.naydenov/shortcuts/index.html ADDED Viewed

@@ -0,0 +1,126 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite App</title>
+    <style>
+      .block {
+              width: 100px;
+              height: 100px;
+              background-color: red;
+          }
+      .big-btn {
+              width: 200px;
+              height: 200px;
+              margin-left: 320px;
+              background-color: skyblue;
+              border-radius: 10px;
+          }
+    </style>
+  </head>
+  <body>
+    <script type="module">
+        import { shortcuts, pluginKey, pluginClick, pluginForm } from './src/main.js'
+        const options = {
+                  onShortcut ( shortcut, { context, note }) {
+                          console.log ( '-- RESULTS --->' )
+                          console.log ( 'Shortcut', shortcut )
+                          console.log ( 'Context:', context )
+                          if ( note )   console.log ( 'Note:', note )
+                    } // onShortcut func.
+              }
+        const short = shortcuts ( options );
+        short.enablePlugin( pluginKey )
+        short.enablePlugin( pluginClick )
+        short.enablePlugin ( pluginForm )
+        short.load ( {
+                        test : {
+                             'key:r' : () => console.log ( 'R was clicked' )
+                            },
+                        general : {
+                              'key:esc' : () => console.log ( 'ESC was clicked' ),
+                              'key:q' : [ () => console.log('Q was clicked')   ]
+                            , 'key:r,o,s' : () => console.log ( 'ROS was clicked' )
+                            , 'click:left-2' : () => console.log ( 'Mouse left click 2' )
+                            , 'key:r' : [
+                                        ({isWaiting}) => {
+                                                if ( !isWaiting() ) {
+                                                            console.log ( 'R was clicked' )
+                                                    }
+                                            }
+                                    ]
+                            , 'key:shift+w' : [
+                                                ({wait, end, ignore, isWaiting, note })  => {
+                                                          console.log ( 'HIT a shift + w')
+                                                          ignore ()
+                                                          if ( isWaiting () ) {
+                                                                  end ()
+                                                                  console.log('END')
+                                                            }
+                                                          else {
+                                                                  console.log('WAIT')
+                                                                  wait ()
+                                                            }
+                                                    },
+                                                ({end}) => {
+                                                        console.log ( 'W' )
+                                                        setTimeout ( end, 3000 )
+                                                }
+                                          ]
+                            , 'form : watch' : () => 'input, button'
+                            , 'form : define' : (target) => {
+                                                if ( target.tagName === 'INPUT' ) {
+                                                        return 'input'
+                                                   }
+                                                if ( target.tagName === 'BUTTON' ) {
+                                                        return 'button'
+                                                   }
+                                        }
+                            , 'form : action' : () =>  [
+                                                {
+                                                        fn: ({target}) => { console.log ( target)}
+                                                , type : 'input'
+                                                , timing : 'in'
+                                                },
+                                                {
+                                                        fn: ({target}) => { console.log ( 'extra')}
+                                                , type : 'input'
+                                                , timing : 'in'
+                                                },
+                                                {
+                                                        fn: () => { console.log ( 'Update content') }
+                                                        , type : 'input'
+                                                        , timing : 'instant'
+                                                        , wait : 500
+                                                },
+                                                {
+                                                        fn: () => { console.log('It was a button') }
+                                                        , type : 'button'
+                                                        , timing : 'out'
+                                                }
+                            ] // form: action
+                            }
+            })
+        short.changeContext ( 'general' )
+        // short.changeContext (  )
+        // short.changeContext ( 'general' )
+    </script>
+    <div class="block" data-click="red-block">
+        <span>hello</span>
+    </div>
+    <button class="big-btn" data-click="mega-button" draggable>Mega button</button>
+    <p><input id="name" type="text" placeholder="Name"/></p>
+    <p><input id="age" type="text" placeholder="Age" /></p>
+  </body>
+</html>

package/test-e2e/node_modules/@peter.naydenov/shortcuts/javascript.svg ADDED Viewed

@@ -0,0 +1 @@

+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="32" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path fill="#F7DF1E" d="M0 0h256v256H0V0Z"></path><path d="m67.312 213.932l19.59-11.856c3.78 6.701 7.218 12.371 15.465 12.371c7.905 0 12.89-3.092 12.89-15.12v-81.798h24.057v82.138c0 24.917-14.606 36.259-35.916 36.259c-19.245 0-30.416-9.967-36.087-21.996m85.07-2.576l19.588-11.341c5.157 8.421 11.859 14.607 23.715 14.607c9.969 0 16.325-4.984 16.325-11.858c0-8.248-6.53-11.17-17.528-15.98l-6.013-2.58c-17.357-7.387-28.87-16.667-28.87-36.257c0-18.044 13.747-31.792 35.228-31.792c15.294 0 26.292 5.328 34.196 19.247l-18.732 12.03c-4.125-7.389-8.591-10.31-15.465-10.31c-7.046 0-11.514 4.468-11.514 10.31c0 7.217 4.468 10.14 14.778 14.608l6.014 2.577c20.45 8.765 31.963 17.7 31.963 37.804c0 21.654-17.012 33.51-39.867 33.51c-22.339 0-36.774-10.654-43.819-24.574"></path></svg>

package/test-e2e/node_modules/@peter.naydenov/shortcuts/jsconfig.json ADDED Viewed

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+                "checkJs": false,  // Disables type checking in .js files
+                "noImplicitAny": false,
+                "strict": false,
+                "allowJs": true,
+        },
+  "include": ["src/**/*", "tests/**/*", "**/*.js"],  // Your files
+}

package/test-e2e/node_modules/@peter.naydenov/shortcuts/package.json ADDED Viewed

@@ -0,0 +1,66 @@
+{
+  "name": "@peter.naydenov/shortcuts",
+  "description": "Context control of shortcuts based on keyboard and mouse events",
+  "version": "4.0.2",
+  "license": "MIT",
+  "author": "Peter Naydenov",
+  "main": "./src/main.js",
+  "types": "./dist/main.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/shortcuts.esm.mjs",
+      "require": "./dist/shortcuts.cjs",
+      "default": "./dist/shortcuts.umd.js"
+    },
+    "./package.json": "./package.json",
+    "./dist/*": "./dist/*",
+    "./src/*": "./src/*"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "rollup -c && npm run types",
+    "test": "vitest",
+    "test:ui": "vitest --ui --open",
+    "cover": "vitest run --coverage",
+    "types": "tsc",
+    "lint": "eslint src/ test/*.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PeterNaydenov/shortcuts"
+  },
+  "dependencies": {
+    "@peter.naydenov/notice": "^2.4.2"
+  },
+  "devDependencies": {
+    "@peter.naydenov/visual-controller-for-react": "^3.0.2",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/user-event": "^14.6.1",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/browser": "^4.1.2",
+    "@vitest/browser-playwright": "^4.1.2",
+    "@vitest/coverage-v8": "^4.1.2",
+    "@vitest/ui": "^4.1.2",
+    "ask-for-promise": "^3.1.0",
+    "eslint": "^10.1.0",
+    "playwright": "^1.59.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "rollup": "^4.60.1",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3",
+    "vitest": "^4.1.2"
+  },
+  "keywords": [
+    "shortcut",
+    "key",
+    "keyboard",
+    "mouse",
+    "click"
+  ]
+}

package/test-e2e/node_modules/@peter.naydenov/shortcuts/public/vite.svg ADDED Viewed

@@ -0,0 +1 @@

+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/test-e2e/node_modules/@peter.naydenov/shortcuts/rollup.config.js ADDED Viewed

@@ -0,0 +1,40 @@
+import resolve    from '@rollup/plugin-node-resolve'
+import commonjs   from '@rollup/plugin-commonjs'
+import terser     from '@rollup/plugin-terser';
+export default [
+	// browser-friendly UMD build
+	{
+		input: 'src/main.js',
+		output: {
+			name: 'shortcuts',
+			file: 'dist/shortcuts.umd.js',
+			format: 'umd',
+            globals : {
+                    '@peter.naydenov/notice': 'notice'
+                }
+		},
+		plugins: [
+			resolve(), // so Rollup can find `ms`
+			commonjs() // so Rollup can convert `ms` to an ES module
+			, terser()
+		]
+	},
+	// CommonJS (for Node) and ES module (for bundlers) build.
+	// (We could have three entries in the configuration array
+	// instead of two, but it's quicker to generate multiple
+	// builds from a single configuration where possible, using
+	// an array for the `output` option, where we can specify
+	// `file` and `format` for each target)
+	{
+		input: 'src/main.js',
+		external: ['@peter.naydenov/notice'],
+		output: [
+			{ file: 'dist/shortcuts.cjs'    , format: 'cjs' },
+			{ file: 'dist/shortcuts.esm.mjs', format: 'es' }
+		],
+		plugins: [ terser() ]
+	}
+];

package/test-e2e/node_modules/@peter.naydenov/shortcuts/shortcuts.png ADDED Viewed

Binary file

package/test-e2e/node_modules/@peter.naydenov/shortcuts/src/main.js ADDED Viewed

@@ -0,0 +1,302 @@
+'use strict'
+/**
+ * @typedef {Object} dependencies
+ * @property {Object} ev - Event emitter instance
+ * @property {Object} inAPI - Internal API object
+ * @property {Object} API - Public API object
+ * @property {Object} extra - Extra dependencies object
+ */
+/**
+ * @typedef {Object} state
+ * @property {Object} currentContext - Current context data container with name and note properties
+ * @property {Object} shortcuts - Shortcuts object: { contextName : { shortcut : callback[] } }
+ * @property {Array} plugins - Array of active plugins
+ * @property {Function|null} exposeShortcut - Keyboard shortcut log function
+ * @property {string} ERROR_EVENT_NAME - Name for error events
+ */
+/**
+ * @typedef {Object} PluginAPI
+ * @property {function(): string} getPrefix - Get plugin prefix
+ * @property {function(string): string} shortcutName - Format shortcut name
+ * @property {function(string): void} contextChange - Handle context change
+ * @property {function(): void} mute - Mute the plugin
+ * @property {function(): void} unmute - Unmute the plugin
+ * @property {function(): void} destroy - Destroy the plugin
+ */
+/**
+ * @typedef {Object} contextShortcuts
+ * @property {string} context - Context name
+ * @property {string[]} shortcuts - List of shortcuts in a context
+ */
+/**
+ * @typedef {Object} ShortcutsAPI
+ * @property {function(Function, Object): void} enablePlugin - Enable a plugin
+ * @property {function(string): void} disablePlugin - Disable a plugin
+ * @property {function(string): number} mutePlugin - Mute a plugin
+ * @property {function(string): number} unmutePlugin - Unmute a plugin
+ * @property {function(): string[]} listPlugins - List enabled plugins
+ * @property {function(): string|null} getContext - Get current context name
+ * @property {function(): string|null} getNote - Get current context note
+ * @property {function(string|null): void} setNote - Set current context note
+ * @property {function(string): void} pause - Pause shortcuts in current context
+ * @property {function(string): void} resume - Resume shortcuts in current context
+ * @property {function(string, ...any): void} emit - Emit event for shortcut
+ * @property {function(): string[]} listContexts - List all context names
+ * @property {function(Object): void} setDependencies - Set external dependencies
+ * @property {function(): Object} getDependencies - Get external dependencies
+ * @property {function(): void} reset - Reset the library instance
+ * @property {function(string|boolean): void} changeContext - Change current context
+ * @property {function(string|null): string[]|contextShortcuts[]|null} listShortcuts - List shortcuts
+ * @property {function(Object): void} load - Load shortcuts into contexts
+ * @property {function(string): void} unload - Unload a context
+ */
+/**
+ * Shortcuts
+ * =========
+ *
+ * Create shortcuts for your web application based on keyboard and mouse and DOM events.
+ * Repository: https://github.com/PeterNaydenov/shortcuts
+ *
+ * History notes:
+ * - Development was started on June 21st, 2023
+ * - First version was published on August 14th, 2023
+ * - Method 'emit' was added on September 30st, 2023
+ * - Version 2.0.0 was published on October 16th, 2023
+ * - Version 3.0.0. Plugin system. Published on March 5th, 2024
+ * - Version 3.2.0. Added plugin 'form'. Published on August 15th, 2025
+ */
+import notice  from '@peter.naydenov/notice'   // Docs: https://github.com/PeterNaydenov/notice
+import methods from './methods/index.js'
+// Plugins
+import pluginKey    from './plugins/key/index.js'
+import pluginClick  from './plugins/click/index.js'
+import pluginForm   from './plugins/form/index.js'
+import pluginHover  from './plugins/hover/index.js'
+import pluginScroll from './plugins/scroll/index.js'
+/**
+ * @function shortcuts
+ * @description Create a shortcuts instance
+ * @param {Object} [options={}] - Configuration options
+ * @param {function} [options.onShortcut] - Function to log shortcut events
+ * @param {string} [options.errorEventName='@shortcuts-error'] - Name for error events
+ * @returns {ShortcutsAPI} The shortcuts API
+ */
+function main ( options = {} ) {
+    const
+          inAPI = {}      // API for internal methods
+        , API   = {}      // API for public methods
+        ,  ev = notice ()  // Event emitter instance
+        , state = {
+                      currentContext   : { name: null, note: null } // Context data container
+                    , shortcuts        : {}   // shortcuts = { contextName : { shortcut :  callback[] } }
+                    , plugins          : [] // Array of active plugins
+                    , exposeShortcut   : (options.onShortcut && ( typeof options.onShortcut === 'function')) ? options.onShortcut : false   // Keyboard shortcut log function
+                    , ERROR_EVENT_NAME : ( options.errorEventName ) ? options.errorEventName : '@shortcuts-error'
+              } // state
+        ;
+    const dependencies = {
+                              ev
+                            , inAPI
+                            , API
+                            , extra : {}
+                        };
+    // ----------------------  > PLUGIN METHODS < ---------------------- //
+    /**
+     * @function enablePlugin
+     * @description Enable a plugin
+     * @param {Function} plugin - Plugin function to enable
+     * @param {Object} [options={}] - Plugin configuration options
+     * @returns {void}
+     */
+    API.enablePlugin = ( plugin, options={}) => {
+                if ( typeof plugin !== 'function' ) return
+                const setupPlugin = inAPI._setupPlugin
+                const plugApp = plugin ( setupPlugin, options )
+                const
+                      name = plugApp.getPrefix ()
+                    , ix = inAPI._systemAction ( name, 'none' )
+                    ;
+                if ( ix === -1 ) {   // If plugin is not registered
+                            // Started instance of the plugin
+                            state.plugins.push ( plugApp )
+                            plugApp.unmute ()
+                    }
+                else {
+                            plugApp.destroy ()
+                            state.plugins[ix].unmute ()
+                    }
+      } // enable func.
+    /**
+     * @function disablePlugin
+     * @description Disable a plugin
+     * @param {string} pluginName - Name of the plugin to disable
+     * @returns {void}
+     */
+    API.disablePlugin = pluginName => {
+                const ix = inAPI._systemAction ( pluginName, 'destroy' );
+                if ( ix !== -1 )   state.plugins.splice ( ix, 1 )
+      } // disable func.
+    /**
+     * @function mutePlugin
+     * @description Mute a plugin
+     * @param {string} pluginName - Name of the plugin to mute
+     * @returns {number} - Index of the plugin in the plugins array ( -1 if not found )
+     */
+    API.mutePlugin = pluginName => inAPI._systemAction ( pluginName, 'mute'   )
+    /**
+     * @function unmutePlugin
+     * @description Unmute a plugin
+     * @param {string} pluginName - Name of the plugin to unmute
+     * @returns {number} - Index of the plugin in the plugins array ( -1 if not found )
+     */
+    API.unmutePlugin = pluginName => inAPI._systemAction ( pluginName, 'unmute' )
+    /**
+     * @function listPlugins
+     * @description List all enabled plugins
+     * @returns {string[]} - Array of plugin names
+     */
+    API.listPlugins = () => state.plugins.map ( plugin => plugin.getPrefix() )
+    // ----------------------  > PUBLIC METHODS < ---------------------- //
+    /**
+     * @function getContext
+     * @description Get current context name
+     * @returns {string|null} - Current context name
+     */
+    API.getContext = () => state.currentContext.name
+    /**
+     * @function getNote
+     * @description Get current context note
+     * @returns {string|null} - Current context note
+     */
+    API.getNote    = () => state.currentContext.note
+    /**
+     * @function setNote
+     * @description Set current context note
+     * @param {string|null} note - Context note
+     * @returns {void}
+     */
+    API.setNote    = (note=null) => { if (typeof note === 'string' || note == null )   state.currentContext.note = note }
+    /**
+       * @function pause
+       * @description Pause shortcut(s) in current context
+       * @param {string} [name='*' ] - Shortcut name that should be paused. Default is '*' - all shortcuts in current context.
+       * @returns {void}
+       */
+    API.pause = (name='*') => {
+                        const pausedEvent = inAPI._readShortcutWithPlugins ( name );
+                        ev.stop ( pausedEvent )
+                  }
+    /**
+       * @function resume
+       * @description Resume shortcut(s) in current context
+       * @param {string} [name='*' ] - Shortcut name that should be resumed. Default is '*' - all shortcuts in current context.
+       * @returns {void}
+       */
+    API.resume = (name='*') => {
+                        const resumedEvent = inAPI._readShortcutWithPlugins ( name )
+                        ev.start ( resumedEvent )
+                  }
+    /**
+     * @function emit
+     * @description Emit event for shortcut in current context
+     * @param {string} name - Shortcut name
+     * @param {any} [args] - Arguments for callback function
+     * @returns {void}
+     **/
+    API.emit = (name,...args) =>  ev.emit ( inAPI._readShortcutWithPlugins ( name ), ...args )
+    /**
+     * @function listContexts
+     * @description List all context names
+     * @returns {string[]} - Array of context names
+     */
+    API.listContexts = () => Object.keys ( state.shortcuts )
+    /**
+     * @function setDependencies
+     * @description Set a dependency package that will be provided to each action function
+     * @param {Object} deps - Enumerate external dependencies
+     * @returns {void}
+     */
+    API.setDependencies = deps => Object.assign ( dependencies.extra, deps )
+    /**
+     * @function getDependencies
+     * @description Get a dependency package that will be provided to each action function
+     * @returns {Object} - Enumerate external dependencies
+     **/
+    API.getDependencies = () => dependencies.extra
+    /**
+     * @function reset
+     * @description Reset the library instance
+     * @returns {void}
+     */
+    API.reset = function reset () {
+                        ev.reset ()
+                        API.changeContext ()
+                        state.plugins.forEach ( plugin => plugin.destroy () )
+                        API.listContexts ().map ( cx =>  API.unload ( cx ))
+                        dependencies.extra = {}
+                        state.exposeShortcut = null
+      } // reset func.
+    Object.entries ( methods ).forEach ( ([ name, method ]) => {
+                if ( name.startsWith('_') ) inAPI [ name ] = method ( dependencies, state )
+                else                          API [ name ] = method ( dependencies, state )
+        })
+    return API
+} // main func.
+/** @type {function} */
+export { main as shortcuts }
+export {
+            pluginKey
+          , pluginClick
+          , pluginForm
+          , pluginHover
+          , pluginScroll
+        }

package/test-e2e/node_modules/@peter.naydenov/shortcuts/src/methods/_normalizeWithPlugins.js ADDED Viewed

@@ -0,0 +1,49 @@
+/**
+ * @typedef {Object} dependencies
+ * @property {Object} ev - Event emitter instance
+ * @property {Object} inAPI - Internal API object
+ * @property {Object} API - Public API object
+ * @property {Object} extra - Extra dependencies object
+ */
+/**
+ * @typedef {Object} state
+ * @property {Object} currentContext - Current context data container
+ * @property {Object} shortcuts - Shortcuts object: { contextName : { shortcut : callback[] } }
+ * @property {Array} plugins - Array of active plugins
+ * @property {Function|null} exposeShortcut - Keyboard shortcut log function
+ * @property {string} ERROR_EVENT_NAME - Name for error events
+ */
+/**
+ * @function _normalizeWithPlugins
+ * @description Function used by plugins during the enable process to normalize the existing and related to the plugin shortcut names.
+ * @param {dependencies} dependencies - Dependencies object containing inAPI
+ * @param {state} state - State object containing shortcuts
+ * @returns {function} - Returns a function that takes a normalize function
+ */
+function _normalizeWithPlugins ( dependencies, state ) {
+/**
+ * @function _normalizeWithPlugins
+ * @description Normalize shortcut names across all contexts using plugin's normalize function
+ * @param {function} _normalizeShortcutName - Plugin internal 'normalize' function
+ * @returns {void}
+ */
+return function _normalizeWithPlugins ( _normalizeShortcutName ) {
+  const shortcuts = state.shortcuts;
+  Object.keys ( shortcuts ).forEach ( contextName => {
+                        Object.entries (shortcuts[contextName]).forEach ( ([shortcutName, callbackList]) => {
+                                                const name = _normalizeShortcutName ( shortcutName )
+                                                if ( name !== shortcutName ) {
+                                                                delete shortcuts[contextName][shortcutName]
+                                                                shortcuts[contextName][name] = callbackList
+                                                        }
+                                        })
+                })
+}} // _normalizeWithPlugins func.
+export default _normalizeWithPlugins