@peter.naydenov/shortcuts 4.0.0 → 4.0.1

package/Changelog.md

@@ -2,7 +2,13 @@
 
 
 
-### 4.0.0 ( 2025-11-?? )
+### 4.0.1 ( 2026-03-24 )
+- [x] Dev deps update. TypeScript to v.6.0.2;
+- [x] Types update according to TypeScript v.6.0.2;
+
+
+
+### 4.0.0 ( 2025-11-08 )
 - [x] New plugin 'hover';
 - [x] New plugin 'scroll';
 - [x] Refactoring on plugin API. New method for building plugin interface;

package/README.md

@@ -1,4 +1,4 @@
-<img src="shortcuts.png" width="100%" alt="Notice" align="center" />
+<img src="shortcuts.png" width="100%" alt="Shortcuts" align="center" />
 
 
 

package/dist/src/main.d.ts

@@ -0,0 +1,172 @@
+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 with name and note properties
+     */
+    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;
+};
+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;
+};
+export type contextShortcuts = {
+    /**
+     * - Context name
+     */
+    context: string;
+    /**
+     * - List of shortcuts in a context
+     */
+    shortcuts: string[];
+};
+export type ShortcutsAPI = {
+    /**
+     * - Enable a plugin
+     */
+    enablePlugin: (arg0: Function, arg1: any) => void;
+    /**
+     * - Disable a plugin
+     */
+    disablePlugin: (arg0: string) => void;
+    /**
+     * - Mute a plugin
+     */
+    mutePlugin: (arg0: string) => number;
+    /**
+     * - Unmute a plugin
+     */
+    unmutePlugin: (arg0: string) => number;
+    /**
+     * - List enabled plugins
+     */
+    listPlugins: () => string[];
+    /**
+     * - Get current context name
+     */
+    getContext: () => string | null;
+    /**
+     * - Get current context note
+     */
+    getNote: () => string | null;
+    /**
+     * - Set current context note
+     */
+    setNote: (arg0: string | null) => void;
+    /**
+     * - Pause shortcuts in current context
+     */
+    pause: (arg0: string) => void;
+    /**
+     * - Resume shortcuts in current context
+     */
+    resume: (arg0: string) => void;
+    /**
+     * - Emit event for shortcut
+     */
+    emit: (arg0: string, ...args: any[]) => void;
+    /**
+     * - List all context names
+     */
+    listContexts: () => string[];
+    /**
+     * - Set external dependencies
+     */
+    setDependencies: (arg0: any) => void;
+    /**
+     * - Get external dependencies
+     */
+    getDependencies: () => any;
+    /**
+     * - Reset the library instance
+     */
+    reset: () => void;
+    /**
+     * - Change current context
+     */
+    changeContext: (arg0: string | boolean) => void;
+    /**
+     * - List shortcuts
+     */
+    listShortcuts: (arg0: string | null) => string[] | contextShortcuts[] | null;
+    /**
+     * - Load shortcuts into contexts
+     */
+    load: (arg0: any) => void;
+    /**
+     * - Unload a context
+     */
+    unload: (arg0: string) => void;
+};
+/**
+ * @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
+ */
+declare function main(options?: {
+    onShortcut?: Function;
+    errorEventName?: string;
+}): ShortcutsAPI;
+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';
+export { main as shortcuts, pluginKey, pluginClick, pluginForm, pluginHover, pluginScroll };

package/dist/src/methods/_normalizeWithPlugins.d.ts

@@ -0,0 +1,64 @@
+export default _normalizeWithPlugins;
+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/src/methods/_readShortcutWithPlugins.d.ts

@@ -0,0 +1,9 @@
+export default _readShortcutWithPlugins;
+/**
+ * @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/src/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/src/methods/_systemAction.d.ts

@@ -0,0 +1,9 @@
+export default _systemAction;
+/**
+ * @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/src/methods/changeContext.d.ts

@@ -0,0 +1,9 @@
+export default changeContext;
+/**
+ * @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/src/methods/index.d.ts

@@ -0,0 +1,19 @@
+declare namespace _default {
+    export { _normalizeWithPlugins };
+    export { _readShortcutWithPlugins };
+    export { _setupPlugin };
+    export { _systemAction };
+    export { changeContext };
+    export { listShortcuts };
+    export { load };
+    export { unload };
+}
+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';
+import load from './load.js';
+import unload from './unload.js';

package/dist/src/methods/listShortcuts.d.ts

@@ -0,0 +1,2 @@
+export default listShortcuts;
+declare function listShortcuts(dependencies: any, state: any): (contextName?: string | null) => string[] | contextShortcuts[] | null;

package/dist/src/methods/load.d.ts

@@ -0,0 +1,9 @@
+export default load;
+/**
+ * @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/src/methods/unload.d.ts

@@ -0,0 +1,9 @@
+export default unload;
+/**
+ * @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/src/plugins/click/_findTarget.d.ts

@@ -0,0 +1,10 @@
+export default _findTarget;
+/**
+ * @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/src/plugins/click/_listenDOM.d.ts

@@ -0,0 +1,78 @@
+export default _listenDOM;
+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/src/plugins/click/_normalizeShortcutName.d.ts

@@ -0,0 +1,8 @@
+export default _normalizeShortcutName;
+/**
+ * @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/src/plugins/click/_readClickEvent.d.ts

@@ -0,0 +1,2 @@
+export default _readClickEvent;
+declare function _readClickEvent(event: any, count: any): string;

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

@@ -0,0 +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/src/plugins/click/index.d.ts

@@ -0,0 +1,16 @@
+export default pluginClick;
+/**
+ * @function pluginClick
+ * @description Plugin for mouse click shortcuts
+ * @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=['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(setupPlugin: Function, options?: {
+    mouseWait?: number;
+    clickTarget?: string[];
+    streamKeys?: Function;
+}): PluginAPI;

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

@@ -0,0 +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({ target }: {
+        target: any;
+    }): "input" | "checkbox" | "button";
+}

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

@@ -0,0 +1,68 @@
+export default _listenDOM;
+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/src/plugins/form/_normalizeShortcutName.d.ts

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

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

@@ -0,0 +1,96 @@
+export default _registerShortcutEvents;
+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/src/plugins/form/index.d.ts

@@ -0,0 +1,9 @@
+export default pluginForm;
+/**
+ * @function pluginForm
+ * @description Plugin for form element shortcuts
+ * @param {function} setupPlugin - Plugin setup function from the library
+ * @param {Object} [options={}] - Plugin options
+ * @returns {PluginAPI} Plugin API
+ */
+declare function pluginForm(setupPlugin: Function, options?: any): PluginAPI;

package/dist/src/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/src/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/src/plugins/hover/_normalizeShortcutName.d.ts

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

package/dist/src/plugins/hover/_registerShortcutEvents.d.ts

@@ -0,0 +1,28 @@
+export default _registerShortcutEvents;
+export type HoverSetupData = {
+    /**
+     * - 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 hover shortcut events and handle setup
+ * @param {Object} dependencies - Dependencies object containing regex, _defaults, ev
+ * @param {Object} pluginState - Plugin state containing currentContext, shortcuts, ERROR_EVENT_NAME
+ * @returns {number} - Number of registered shortcuts
+ *
+ * @typedef {Object} HoverSetupData
+ * @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/src/plugins/hover/index.d.ts

@@ -0,0 +1,14 @@
+export default pluginHover;
+/**
+ * @function pluginHover
+ * @description Plugin for mouse hover shortcuts
+ * @param {function} setupPlugin - Plugin setup function from the library
+ * @param {Object} [options={}] - Plugin options
+ * @param {string[]} [options.hoverTarget=['data-hover']] - Array of attribute names for hover targets
+ * @param {number} [options.wait=320] - Time to wait for hover sequence in ms
+ * @returns {PluginAPI} Plugin API
+ */
+declare function pluginHover(setupPlugin: Function, options?: {
+    hoverTarget?: string[];
+    wait?: number;
+}): PluginAPI;

package/dist/src/plugins/key/_listenDOM.d.ts

@@ -0,0 +1,63 @@
+export default _listenDOM;
+export type KeyEventData = {
+    /**
+     * - Function to wait for keys (disables key sequence)
+     */
+    wait: Function;
+    /**
+     * - Function to end waiting for keys (enables key sequence)
+     */
+    end: Function;
+    /**
+     * - Function to ignore the last key in sequence
+     */
+    ignore: Function;
+    /**
+     * - Function to check if currently waiting for keys
+     */
+    isWaiting: Function;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Event type ('key')
+     */
+    type: string;
+};
+/**
+ * @function _listenDOM
+ * @description Set up DOM event listeners for keyboard events
+ * @param {Object} dependencies - Dependencies object containing ev, _specialChars, _readKeyEvent, extra, resetState
+ * @param {Object} state - Plugin state containing listenOptions and currentContext
+ * @returns {Object} - Object containing start and stop methods
+ *
+ * @typedef {Object} KeyEventData
+ * @property {Function} wait - Function to wait for keys (disables key sequence)
+ * @property {Function} end - Function to end waiting for keys (enables key sequence)
+ * @property {Function} ignore - Function to ignore the last key in sequence
+ * @property {Function} isWaiting - Function to check if currently waiting for keys
+ * @property {string|null} note - Current context note
+ * @property {string} context - Current context name
+ * @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 {string} type - Event type ('key')
+ */
+declare function _listenDOM(dependencies: any, state: any): any;

package/dist/src/plugins/key/_normalizeShortcutName.d.ts

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

package/dist/src/plugins/key/_readKeyEvent.d.ts

@@ -0,0 +1,2 @@
+export default _readKeyEvent;
+declare function _readKeyEvent(event: any, _specialChars: any): any[];

package/dist/src/plugins/key/_registerShortcutEvents.d.ts

@@ -0,0 +1,28 @@
+export default _registerShortcutEvents;
+export type KeySetupData = {
+    /**
+     * - 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 keyboard shortcut events and handle setup
+ * @param {Object} dependencies - Dependencies object containing regex
+ * @param {Object} pluginState - Plugin state containing currentContext, shortcuts
+ * @returns {number} - Number of registered shortcuts
+ *
+ * @typedef {Object} KeySetupData
+ * @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/src/plugins/key/_specialChars.d.ts

@@ -0,0 +1,7 @@
+export default _specialChars;
+/**
+ * @function _specialChars
+ * @description Get mapping of special keyboard characters to their normalized names
+ * @returns {Object} - Object mapping keyboard event keys to normalized names
+ */
+declare function _specialChars(): any;

package/dist/src/plugins/key/index.d.ts

@@ -0,0 +1,14 @@
+export default pluginKey;
+/**
+ * @function pluginKey
+ * @description Plugin for keyboard shortcuts
+ * @param {function} setupPlugin - Plugin setup function from the library
+ * @param {Object} [options={}] - Plugin options
+ * @param {number} [options.keyWait=480] - Time to wait for key sequence in ms
+ * @param {function} [options.streamKeys] - Function to stream key presses
+ * @returns {PluginAPI} Plugin API
+ */
+declare function pluginKey(setupPlugin: Function, options?: {
+    keyWait?: number;
+    streamKeys?: Function;
+}): PluginAPI;

package/dist/src/plugins/scroll/_listenDOM.d.ts

@@ -0,0 +1,58 @@
+export default _listenDOM;
+export type ScrollEventData = {
+    /**
+     * - Current scroll X position
+     */
+    x: number;
+    /**
+     * - Current scroll Y position
+     */
+    y: number;
+    /**
+     * - Scroll direction ('up', 'down', 'left', 'right')
+     */
+    direction: string;
+    /**
+     * - Current context name
+     */
+    context: string;
+    /**
+     * - Current context note
+     */
+    note: string | null;
+    /**
+     * - Extra dependencies object
+     */
+    dependencies: any;
+    /**
+     * - Plugin state listenOptions (reference to pluginState.listenOptions)
+     */
+    options: any;
+    /**
+     * - Viewport information with X, Y, width, height
+     */
+    viewport: any;
+    /**
+     * - Event type ('scroll')
+     */
+    type: string;
+};
+/**
+ * @function _listenDOM
+ * @description Set up DOM event listeners for scroll events
+ * @param {Object} dependencies - Dependencies object containing ev, resetState, extra
+ * @param {Object} state - Plugin state containing listenOptions and currentContext
+ * @returns {Object} - Object containing start and stop methods
+ *
+ * @typedef {Object} ScrollEventData
+ * @property {number} x - Current scroll X position
+ * @property {number} y - Current scroll Y position
+ * @property {string} direction - Scroll direction ('up', 'down', 'left', 'right')
+ * @property {string} context - Current context name
+ * @property {string|null} note - Current context note
+ * @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 {string} type - Event type ('scroll')
+ */
+declare function _listenDOM(dependencies: any, state: any): any;

package/dist/src/plugins/scroll/_normalizeShortcutName.d.ts

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

package/dist/src/plugins/scroll/_registerShortcutEvents.d.ts

@@ -0,0 +1,28 @@
+export default _registerShortcutEvents;
+export type ScrollSetupData = {
+    /**
+     * - 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 scroll shortcut events and handle setup
+ * @param {Object} dependencies - Dependencies object containing regex
+ * @param {Object} pluginState - Plugin state containing currentContext, shortcuts
+ * @returns {number} - Number of registered shortcuts
+ *
+ * @typedef {Object} ScrollSetupData
+ * @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/src/plugins/scroll/index.d.ts

@@ -0,0 +1,16 @@
+export default pluginScroll;
+/**
+ * @function pluginScroll
+ * @description Plugin for scroll event shortcuts
+ * @param {function} setupPlugin - Plugin setup function from the library
+ * @param {Object} [options={}] - Plugin options
+ * @param {number} [options.scrollWait=50] - Delay between scroll events in ms
+ * @param {number} [options.endScrollWait=400] - Delay when scroll was stopped in ms
+ * @param {number} [options.minSpace=40] - Minimum distance between scroll events in px
+ * @returns {PluginAPI} Plugin API
+ */
+declare function pluginScroll(setupPlugin: Function, options?: {
+    scrollWait?: number;
+    endScrollWait?: number;
+    minSpace?: number;
+}): PluginAPI;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@peter.naydenov/shortcuts",
   "description": "Context control of shortcuts based on keyboard and mouse events",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "license": "MIT",
   "author": "Peter Naydenov",
   "main": "./src/main.js",
@@ -38,24 +38,25 @@
     "@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": "^0.4.4",
+    "@rollup/plugin-terser": "^1.0.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/user-event": "^14.6.1",
-    "@vitejs/plugin-react": "^5.1.0",
-    "@vitest/browser": "^4.0.8",
-    "@vitest/browser-playwright": "^4.0.8",
-    "@vitest/coverage-v8": "^4.0.8",
-    "@vitest/ui": "^4.0.8",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/browser": "^4.0.18",
+    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
     "ask-for-promise": "^3.1.0",
-    "chai": "^6.2.0",
-    "eslint": "^9.39.1",
-    "mocha": "^11.7.4",
-    "playwright": "^1.56.1",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "typescript": "^5.9.3",
-    "vite": "^7.2.2",
-    "vitest": "^4.0.8"
+    "chai": "^6.2.2",
+    "eslint": "^10.1.0",
+    "mocha": "^12.0.0-beta-9",
+    "playwright": "^1.58.2",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "rollup": "^4.60.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.2",
+    "vitest": "^4.0.18"
   },
   "keywords": [
     "shortcut",

package/tsconfig.json

@@ -4,9 +4,10 @@
     "declaration": true,
     "emitDeclarationOnly": true,
     "outDir": "dist",
+    "rootDir": "src",
     "target": "ES2020",
     "module": "ESNext",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "esModuleInterop": true,
     "allowSyntheticDefaultImports": true,
     "strict": false,