@peter.naydenov/shortcuts 3.5.2 → 4.0.0

package/dist/methods/_normalizeWithPlugins.d.ts

@@ -1,2 +1,64 @@
 export default _normalizeWithPlugins;
-declare function _normalizeWithPlugins(dependencies: any, state: any): (_normalizeShortcutName: Function) => void;
+export type dependencies = {
+    /**
+     * - Event emitter instance
+     */
+    ev: any;
+    /**
+     * - Internal API object
+     */
+    inAPI: any;
+    /**
+     * - Public API object
+     */
+    API: any;
+    /**
+     * - Extra dependencies object
+     */
+    extra: any;
+};
+export type state = {
+    /**
+     * - Current context data container
+     */
+    currentContext: any;
+    /**
+     * - Shortcuts object: { contextName : { shortcut : callback[] } }
+     */
+    shortcuts: any;
+    /**
+     * - Array of active plugins
+     */
+    plugins: any[];
+    /**
+     * - Keyboard shortcut log function
+     */
+    exposeShortcut: Function | null;
+    /**
+     * - Name for error events
+     */
+    ERROR_EVENT_NAME: string;
+};
+/**
+ * @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
+ */
+declare function _normalizeWithPlugins(dependencies: dependencies, state: state): Function;

package/dist/methods/_readShortcutWithPlugins.d.ts

@@ -1,2 +1,9 @@
 export default _readShortcutWithPlugins;
-declare function _readShortcutWithPlugins(dependencies: any, state: any): (shortcut: string) => string;
+/**
+ * @function _readShortcutWithPlugins
+ * @description Searches for belonging plugin and call the plugin method to normalize the shortcut name.
+ * @param {dependencies} dependencies - Dependencies object containing inAPI
+ * @param {state} state - State object containing plugins
+ * @returns {function} - Returns a function that processes shortcut names
+ */
+declare function _readShortcutWithPlugins(dependencies: any, state: any): Function;

package/dist/methods/_setupPlugin.d.ts

@@ -0,0 +1,9 @@
+export default _setupPlugin;
+/**
+ * @function _setupPlugin
+ * @description Setup a plugin with provided settings and dependencies
+ * @param {dependencies} dependencies - Dependencies object containing ev, extra, inAPI, API
+ * @param {state} state - State object containing currentContext, shortcuts, exposeShortcut, ERROR_EVENT_NAME
+ * @returns {function} - Returns a function that takes plugin settings and returns plugin API
+ */
+declare function _setupPlugin(dependencies: any, state: any): Function;

package/dist/methods/_systemAction.d.ts

@@ -1,2 +1,9 @@
 export default _systemAction;
-declare function _systemAction(dependencies: any, state: any): (pluginName: string, fn: string, params?: any) => any;
+/**
+ * @function _systemAction
+ * @description Call a specific plugin method.
+ * @param {dependencies} dependencies - Dependencies object containing inAPI
+ * @param {state} state - State object containing plugins array
+ * @returns {function} - Returns a function that executes plugin actions
+ */
+declare function _systemAction(dependencies: any, state: any): Function;

package/dist/methods/changeContext.d.ts

@@ -1,2 +1,9 @@
 export default changeContext;
-declare function changeContext(dependencies: any, state: any): (contextName?: string) => void;
+/**
+ * @function changeContext
+ * @description Change current context with shortcuts belonging to it
+ * @param {dependencies} dependencies - Dependencies object containing ev
+ * @param {state} state - State object containing shortcuts, currentContext, ERROR_EVENT_NAME
+ * @returns {function} - Returns a function that changes context
+ */
+declare function changeContext(dependencies: any, state: any): Function;

package/dist/methods/index.d.ts

@@ -1,6 +1,7 @@
 declare namespace _default {
     export { _normalizeWithPlugins };
     export { _readShortcutWithPlugins };
+    export { _setupPlugin };
     export { _systemAction };
     export { changeContext };
     export { listShortcuts };
@@ -10,6 +11,7 @@ declare namespace _default {
 export default _default;
 import _normalizeWithPlugins from './_normalizeWithPlugins.js';
 import _readShortcutWithPlugins from './_readShortcutWithPlugins.js';
+import _setupPlugin from './_setupPlugin.js';
 import _systemAction from './_systemAction.js';
 import changeContext from './changeContext.js';
 import listShortcuts from './listShortcuts.js';

package/dist/methods/listShortcuts.d.ts

@@ -1,17 +1,2 @@
 export default listShortcuts;
-export type contextShortcuts = {
-    /**
-     * - Context name
-     */
-    context: string;
-    /**
-     * - List of shortcuts in a context
-     */
-    shortcuts: string[];
-};
-/**
- * @typedef {object} contextShortcuts
- * @property {string} context - Context name
- * @property {string[]} shortcuts - List of shortcuts in a context
- */
-declare function listShortcuts(dependencies: any, state: any): (contextName?: string) => string[] | contextShortcuts[];
+declare function listShortcuts(dependencies: any, state: any): (contextName?: string | null) => string[] | contextShortcuts[] | null;

package/dist/methods/load.d.ts

@@ -1,2 +1,9 @@
 export default load;
-declare function load(dependencies: any, state: any): (shortcutsUpdate: any) => void;
+/**
+ * @function load
+ * @description Load a context with shortcuts object
+ * @param {dependencies} dependencies - Dependencies object containing API with changeContext and getContext
+ * @param {state} state - State object containing shortcuts and plugins
+ * @returns {function} - Returns a function that loads shortcuts
+ */
+declare function load(dependencies: any, state: any): Function;

package/dist/methods/unload.d.ts

@@ -1,2 +1,9 @@
 export default unload;
-declare function unload(dependencies: any, state: any): (contextName: string) => void;
+/**
+ * @function unload
+ * @description Unload a non-active context with shortcuts
+ * @param {dependencies} dependencies - Dependencies object containing ev
+ * @param {state} state - State object containing currentContext, shortcuts, ERROR_EVENT_NAME
+ * @returns {function} - Returns a function that unloads contexts
+ */
+declare function unload(dependencies: any, state: any): Function;

package/dist/plugins/click/_findTarget.d.ts

@@ -1,2 +1,10 @@
 export default _findTarget;
-declare function _findTarget(dependencies: any, state: any, target: any): any;
+/**
+ * @function _findTarget
+ * @description Find the appropriate click target element by checking if element has any of the target attributes
+ * @param {Object} dependencies - Dependencies object
+ * @param {Object} state - Plugin state containing listenOptions with clickTarget array
+ * @param {Element} target - DOM element to start searching from
+ * @returns {Element|null} - Target element or null if not found
+ */
+declare function _findTarget(dependencies: any, state: any, target: Element): Element | null;

package/dist/plugins/click/_listenDOM.d.ts

@@ -1,5 +1,78 @@
 export default _listenDOM;
-declare function _listenDOM(dependencies: any, state: any): {
-    start: () => void;
-    stop: () => void;
+export type ClickEventData = {
+    /**
+     * - The DOM element that was clicked
+     */
+    target: Element;
+    /**
+     * - X coordinate of the click event
+     */
+    x: number;
+    /**
+     * - Y coordinate of the click event
+     */
+    y: number;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+    /**
+     * - The original DOM event
+     */
+    event: Event;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Element dimensions with width, height
+     */
+    sizes: any;
+    /**
+     * - Element position relative to viewport with x, y
+     */
+    position: any;
+    /**
+     * - Element position relative to page with x, y
+     */
+    pagePosition: any;
+    /**
+     * - Event type ('click')
+     */
+    type: string;
 };
+/**
+ * @function _listenDOM
+ * @description Set up DOM event listeners for click events
+ * @param {Object} dependencies - Dependencies object containing ev, _findTarget, _readClickEvent, extra, resetState
+ * @param {Object} state - Plugin state containing listenOptions and currentContext
+ * @returns {Object} - Object containing start and stop methods
+ *
+ * @typedef {Object} ClickEventData
+ * @property {Element} target - The DOM element that was clicked
+ * @property {number} x - X coordinate of the click event
+ * @property {number} y - Y coordinate of the click event
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ * @property {Event} event - The original DOM event
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} viewport - Viewport information with X, Y, width, height
+ * @property {Object} sizes - Element dimensions with width, height
+ * @property {Object} position - Element position relative to viewport with x, y
+ * @property {Object} pagePosition - Element position relative to page with x, y
+ * @property {string} type - Event type ('click')
+ */
+declare function _listenDOM(dependencies: any, state: any): any;

package/dist/plugins/click/_normalizeShortcutName.d.ts

@@ -1,2 +1,8 @@
 export default _normalizeShortcutName;
-declare function _normalizeShortcutName(name: any): any;
+/**
+ * @function _normalizeShortcutName
+ * @description Normalize click shortcut name to standard format
+ * @param {string} name - Raw shortcut name
+ * @returns {string} - Normalized shortcut name
+ */
+declare function _normalizeShortcutName(name: string): string;

package/dist/plugins/click/_registerShortcutEvents.d.ts

@@ -1,2 +1,28 @@
 export default _registerShortcutEvents;
+export type ClickSetupData = {
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Default options (clone of pluginState.defaultOptions)
+     */
+    defaults: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+};
+/**
+ * @function _registerShortcutEvents
+ * @description Register click shortcut events and handle setup
+ * @param {Object} dependencies - Dependencies object containing regex
+ * @param {Object} pluginState - Plugin state containing listenOptions, currentContext, shortcuts, etc.
+ * @returns {number} - Number of registered shortcuts
+ *
+ * @typedef {Object} ClickSetupData
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} defaults - Default options (clone of pluginState.defaultOptions)
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ */
 declare function _registerShortcutEvents(dependencies: any, pluginState: any): number;

package/dist/plugins/click/index.d.ts

@@ -1,41 +1,16 @@
 export default pluginClick;
-export type PluginAPI = {
-    /**
-     * - Get plugin prefix
-     */
-    getPrefix: () => string;
-    /**
-     * - Format shortcut name
-     */
-    shortcutName: (arg0: string) => string;
-    /**
-     * - Handle context change
-     */
-    contextChange: (arg0: string) => void;
-    /**
-     * - Mute the plugin
-     */
-    mute: () => void;
-    /**
-     * - Unmute the plugin
-     */
-    unmute: () => void;
-    /**
-     * - Destroy the plugin
-     */
-    destroy: () => void;
-};
 /**
  * @function pluginClick
  * @description Plugin for mouse click shortcuts
- * @param {Object} dependencies - Internal dependencies
- * @param {Object} state - Library state
+ * @param {function} setupPlugin - Plugin setup function from the library
  * @param {Object} [options={}] - Plugin options
  * @param {number} [options.mouseWait=320] - Time to wait for click sequence in ms
- * @param {string} [options.clickTarget='click'] - Data attribute name for click targets
+ * @param {string[]} [options.clickTarget=['data-click', 'href']] - Array of attribute names for click targets
+ * @param {function} [options.streamKeys] - Function to stream key presses
  * @returns {PluginAPI} Plugin API
  */
-declare function pluginClick(dependencies: any, state: any, options?: {
+declare function pluginClick(setupPlugin: Function, options?: {
     mouseWait?: number;
-    clickTarget?: string;
+    clickTarget?: string[];
+    streamKeys?: Function;
 }): PluginAPI;

package/dist/plugins/form/_defaults.d.ts

@@ -1,5 +1,17 @@
 export default _defaults;
+export type _defaults = {
+    /**
+     * - Function that returns CSS selector for form elements to watch
+     */
+    watch: Function;
+    /**
+     * - Function that determines the type of form element
+     */
+    define: Function;
+};
 declare namespace _defaults {
     function watch(): string;
-    function define(el: any): "input" | "checkbox" | "button";
+    function define({ target }: {
+        target: any;
+    }): "input" | "checkbox" | "button";
 }

package/dist/plugins/form/_listenDOM.d.ts

@@ -1,5 +1,68 @@
 export default _listenDOM;
-declare function _listenDOM(dependencies: any, state: any): {
-    start: () => void;
-    stop: () => void;
+export type FormEventData = {
+    /**
+     * - The DOM element that triggered the form event
+     */
+    target: Element;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - The original DOM event
+     */
+    event: Event;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Element dimensions with width, height
+     */
+    sizes: any;
+    /**
+     * - Element position relative to viewport with x, y
+     */
+    position: any;
+    /**
+     * - Element position relative to page with x, y
+     */
+    pagePosition: any;
+    /**
+     * - Event type ('form-in', 'form-out', 'form-instant')
+     */
+    type: string;
 };
+/**
+ * @function _listenDOM
+ * @description Set up DOM event listeners for form events
+ * @param {Object} dependencies - Dependencies object containing ev
+ * @param {Object} state - Plugin state containing listenOptions and currentContext
+ * @returns {Object} - Object containing start and stop methods
+ *
+ * @typedef {Object} FormEventData
+ * @property {Element} target - The DOM element that triggered the form event
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @property {Event} event - The original DOM event
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ * @property {Object} viewport - Viewport information with X, Y, width, height
+ * @property {Object} sizes - Element dimensions with width, height
+ * @property {Object} position - Element position relative to viewport with x, y
+ * @property {Object} pagePosition - Element position relative to page with x, y
+ * @property {string} type - Event type ('form-in', 'form-out', 'form-instant')
+ */
+declare function _listenDOM(dependencies: any, state: any): any;

package/dist/plugins/form/_registerShortcutEvents.d.ts

@@ -1,2 +1,96 @@
 export default _registerShortcutEvents;
-declare function _registerShortcutEvents(dependencies: any, pluginState: any): boolean;
+export type FormWatchData = {
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+};
+export type FormDefineData = {
+    /**
+     * - The DOM element being watched
+     */
+    target: Element;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Element dimensions with width, height
+     */
+    sizes: any;
+    /**
+     * - Element position relative to viewport with x, y
+     */
+    position: any;
+    /**
+     * - Element position relative to page with x, y
+     */
+    pagePosition: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+};
+export type FormActionData = {
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+};
+/**
+ * @function _registerShortcutEvents
+ * @description Register form shortcut events and handle setup
+ * @param {Object} dependencies - Dependencies object containing regex, _defaults, ev
+ * @param {Object} pluginState - Plugin state containing currentContext, shortcuts, callbacks, etc.
+ * @returns {number|false} - Number of registered shortcuts or false if no actions
+ *
+ * @typedef {Object} FormWatchData
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ *
+ * @typedef {Object} FormDefineData
+ * @property {Element} target - The DOM element being watched
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} viewport - Viewport information with X, Y, width, height
+ * @property {Object} sizes - Element dimensions with width, height
+ * @property {Object} position - Element position relative to viewport with x, y
+ * @property {Object} pagePosition - Element position relative to page with x, y
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ *
+ * @typedef {Object} FormActionData
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ */
+declare function _registerShortcutEvents(dependencies: any, pluginState: any): number | false;

package/dist/plugins/form/index.d.ts

@@ -1,36 +1,9 @@
 export default pluginForm;
-export type PluginAPI = {
-    /**
-     * - Get plugin prefix
-     */
-    getPrefix: () => string;
-    /**
-     * - Format shortcut name
-     */
-    shortcutName: (arg0: string) => string;
-    /**
-     * - Handle context change
-     */
-    contextChange: (arg0: string) => void;
-    /**
-     * - Mute the plugin
-     */
-    mute: () => void;
-    /**
-     * - Unmute the plugin
-     */
-    unmute: () => void;
-    /**
-     * - Destroy the plugin
-     */
-    destroy: () => void;
-};
 /**
  * @function pluginForm
  * @description Plugin for form element shortcuts
- * @param {Object} dependencies - Internal dependencies
- * @param {Object} state - Library state
+ * @param {function} setupPlugin - Plugin setup function from the library
  * @param {Object} [options={}] - Plugin options
  * @returns {PluginAPI} Plugin API
  */
-declare function pluginForm(dependencies: any, state: any, options?: any): PluginAPI;
+declare function pluginForm(setupPlugin: Function, options?: any): PluginAPI;

package/dist/plugins/hover/_findTarget.d.ts

@@ -0,0 +1,10 @@
+export default _findTarget;
+/**
+ * @function _findTarget
+ * @description Find the appropriate hover target element by checking if element has any of the target attributes
+ * @param {Object} dependencies - Dependencies object
+ * @param {Object} state - Plugin state containing listenOptions with hoverTarget array
+ * @param {Element} target - DOM element to start searching from
+ * @returns {Element|false} - Target element or false if not found
+ */
+declare function _findTarget(dependencies: any, state: any, target: Element): Element | false;

package/dist/plugins/hover/_listenDOM.d.ts

@@ -0,0 +1,68 @@
+export default _listenDOM;
+export type HoverEventData = {
+    /**
+     * - The DOM element that is being hovered
+     */
+    target: Element;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - The original DOM event
+     */
+    event: Event;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Element dimensions with width, height
+     */
+    sizes: any;
+    /**
+     * - Element position relative to viewport with x, y
+     */
+    position: any;
+    /**
+     * - Element position relative to page with x, y
+     */
+    pagePosition: any;
+    /**
+     * - Event type ('hover')
+     */
+    type: string;
+};
+/**
+ * @function _listenDOM
+ * @description Set up DOM event listeners for hover events
+ * @param {Object} dependencies - Dependencies object containing ev, _findTarget, resetState, extra
+ * @param {Object} state - Plugin state containing listenOptions and currentContext
+ * @returns {Object} - Object containing start and stop methods
+ *
+ * @typedef {Object} HoverEventData
+ * @property {Element} target - The DOM element that is being hovered
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @property {Event} event - The original DOM event
+ * @property {Object} dependencies - Extra dependencies object
+ * @property {Object} options - Plugin state listenOptions (reference to pluginState.listenOptions)
+ * @property {Object} viewport - Viewport information with X, Y, width, height
+ * @property {Object} sizes - Element dimensions with width, height
+ * @property {Object} position - Element position relative to viewport with x, y
+ * @property {Object} pagePosition - Element position relative to page with x, y
+ * @property {string} type - Event type ('hover')
+ */
+declare function _listenDOM(dependencies: any, state: any): any;

package/dist/plugins/hover/_normalizeShortcutName.d.ts

@@ -0,0 +1,2 @@
+export default _normalizeShortcutName;
+declare function _normalizeShortcutName(name: any): any;