react-hotkeys-hook 4.5.0 → 5.0.0-1

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.
@@ -1 +1 @@
1
- {"version":3,"file":"react-hotkeys-hook.esm.js","sources":["../src/parseHotkeys.ts","../src/isHotkeyPressed.ts","../src/validators.ts","../src/BoundHotkeysProxyProvider.tsx","../src/deepEqual.ts","../src/HotkeysProvider.tsx","../src/useDeepEqualMemo.ts","../src/useHotkeys.ts","../src/useRecordHotkeys.ts"],"sourcesContent":["import { Hotkey, KeyboardModifiers } from './types'\n\nconst reservedModifierKeywords = ['shift', 'alt', 'meta', 'mod', 'ctrl']\n\nconst mappedKeys: Record<string, string> = {\n esc: 'escape',\n return: 'enter',\n '.': 'period',\n ',': 'comma',\n '-': 'slash',\n ' ': 'space',\n '`': 'backquote',\n '#': 'backslash',\n '+': 'bracketright',\n ShiftLeft: 'shift',\n ShiftRight: 'shift',\n AltLeft: 'alt',\n AltRight: 'alt',\n MetaLeft: 'meta',\n MetaRight: 'meta',\n OSLeft: 'meta',\n OSRight: 'meta',\n ControlLeft: 'ctrl',\n ControlRight: 'ctrl',\n}\n\nexport function mapKey(key: string): string {\n return (mappedKeys[key] || key)\n .trim()\n .toLowerCase()\n .replace(/key|digit|numpad|arrow/, '')\n}\n\nexport function isHotkeyModifier(key: string) {\n return reservedModifierKeywords.includes(key)\n}\n\nexport function parseKeysHookInput(keys: string, splitKey = ','): string[] {\n return keys.split(splitKey)\n}\n\nexport function parseHotkey(hotkey: string, combinationKey = '+', description?: string): Hotkey {\n const keys = hotkey\n .toLocaleLowerCase()\n .split(combinationKey)\n .map((k) => mapKey(k))\n\n const modifiers: KeyboardModifiers = {\n alt: keys.includes('alt'),\n ctrl: keys.includes('ctrl') || keys.includes('control'),\n shift: keys.includes('shift'),\n meta: keys.includes('meta'),\n mod: keys.includes('mod'),\n }\n\n const singleCharKeys = keys.filter((k) => !reservedModifierKeywords.includes(k))\n\n return {\n ...modifiers,\n keys: singleCharKeys,\n description,\n }\n}\n","import { isHotkeyModifier, mapKey } from './parseHotkeys'\n;(() => {\n if (typeof document !== 'undefined') {\n document.addEventListener('keydown', (e) => {\n if (e.key === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n pushToCurrentlyPressedKeys([mapKey(e.key), mapKey(e.code)])\n })\n\n document.addEventListener('keyup', (e) => {\n if (e.key === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n removeFromCurrentlyPressedKeys([mapKey(e.key), mapKey(e.code)])\n })\n }\n\n if (typeof window !== 'undefined') {\n window.addEventListener('blur', () => {\n currentlyPressedKeys.clear()\n })\n }\n})()\n\nconst currentlyPressedKeys: Set<string> = new Set<string>()\n\n// https://github.com/microsoft/TypeScript/issues/17002\nexport function isReadonlyArray(value: unknown): value is readonly unknown[] {\n return Array.isArray(value)\n}\n\nexport function isHotkeyPressed(key: string | readonly string[], splitKey = ','): boolean {\n const hotkeyArray = isReadonlyArray(key) ? key : key.split(splitKey)\n\n return hotkeyArray.every((hotkey) => currentlyPressedKeys.has(hotkey.trim().toLowerCase()))\n}\n\nexport function pushToCurrentlyPressedKeys(key: string | string[]): void {\n const hotkeyArray = Array.isArray(key) ? key : [key]\n\n /*\n Due to a weird behavior on macOS we need to clear the set if the user pressed down the meta key and presses another key.\n https://stackoverflow.com/questions/11818637/why-does-javascript-drop-keyup-events-when-the-metakey-is-pressed-on-mac-browser\n Otherwise the set will hold all ever pressed keys while the meta key is down which leads to wrong results.\n */\n if (currentlyPressedKeys.has('meta')) {\n currentlyPressedKeys.forEach((key) => !isHotkeyModifier(key) && currentlyPressedKeys.delete(key.toLowerCase()))\n }\n\n hotkeyArray.forEach((hotkey) => currentlyPressedKeys.add(hotkey.toLowerCase()))\n}\n\nexport function removeFromCurrentlyPressedKeys(key: string | string[]): void {\n const hotkeyArray = Array.isArray(key) ? key : [key]\n\n /*\n Due to a weird behavior on macOS we need to clear the set if the user pressed down the meta key and presses another key.\n https://stackoverflow.com/questions/11818637/why-does-javascript-drop-keyup-events-when-the-metakey-is-pressed-on-mac-browser\n Otherwise the set will hold all ever pressed keys while the meta key is down which leads to wrong results.\n */\n if (key === 'meta') {\n currentlyPressedKeys.clear()\n } else {\n hotkeyArray.forEach((hotkey) => currentlyPressedKeys.delete(hotkey.toLowerCase()))\n }\n}\n","import { FormTags, Hotkey, Scopes, Trigger } from './types'\nimport { isHotkeyPressed, isReadonlyArray } from './isHotkeyPressed'\nimport { mapKey } from './parseHotkeys'\n\nexport function maybePreventDefault(e: KeyboardEvent, hotkey: Hotkey, preventDefault?: Trigger): void {\n if ((typeof preventDefault === 'function' && preventDefault(e, hotkey)) || preventDefault === true) {\n e.preventDefault()\n }\n}\n\nexport function isHotkeyEnabled(e: KeyboardEvent, hotkey: Hotkey, enabled?: Trigger): boolean {\n if (typeof enabled === 'function') {\n return enabled(e, hotkey)\n }\n\n return enabled === true || enabled === undefined\n}\n\nexport function isKeyboardEventTriggeredByInput(ev: KeyboardEvent): boolean {\n return isHotkeyEnabledOnTag(ev, ['input', 'textarea', 'select'])\n}\n\nexport function isHotkeyEnabledOnTag(\n { target }: KeyboardEvent,\n enabledOnTags: readonly FormTags[] | boolean = false\n): boolean {\n const targetTagName = target && (target as HTMLElement).tagName\n\n if (isReadonlyArray(enabledOnTags)) {\n return Boolean(\n targetTagName && enabledOnTags && enabledOnTags.some((tag) => tag.toLowerCase() === targetTagName.toLowerCase())\n )\n }\n\n return Boolean(targetTagName && enabledOnTags && enabledOnTags === true)\n}\n\nexport function isScopeActive(activeScopes: string[], scopes?: Scopes): boolean {\n if (activeScopes.length === 0 && scopes) {\n console.warn(\n 'A hotkey has the \"scopes\" option set, however no active scopes were found. If you want to use the global scopes feature, you need to wrap your app in a <HotkeysProvider>'\n )\n\n return true\n }\n\n if (!scopes) {\n return true\n }\n\n return activeScopes.some((scope) => scopes.includes(scope)) || activeScopes.includes('*')\n}\n\nexport const isHotkeyMatchingKeyboardEvent = (e: KeyboardEvent, hotkey: Hotkey, ignoreModifiers = false): boolean => {\n const { alt, meta, mod, shift, ctrl, keys } = hotkey\n const { key: pressedKeyUppercase, code, ctrlKey, metaKey, shiftKey, altKey } = e\n\n const keyCode = mapKey(code)\n const pressedKey = pressedKeyUppercase.toLowerCase()\n\n if (!keys?.includes(keyCode) && !keys?.includes(pressedKey) && !['ctrl', 'control', 'unknown', 'meta', 'alt', 'shift', 'os'].includes(keyCode)) {\n return false\n }\n\n if (!ignoreModifiers) {\n // We check the pressed keys for compatibility with the keyup event. In keyup events the modifier flags are not set.\n if (alt === !altKey && pressedKey !== 'alt') {\n return false\n }\n\n if (shift === !shiftKey && pressedKey !== 'shift') {\n return false\n }\n\n // Mod is a special key name that is checking for meta on macOS and ctrl on other platforms\n if (mod) {\n if (!metaKey && !ctrlKey) {\n return false\n }\n } else {\n if (meta === !metaKey && pressedKey !== 'meta' && pressedKey !== 'os') {\n return false\n }\n\n if (ctrl === !ctrlKey && pressedKey !== 'ctrl' && pressedKey !== 'control') {\n return false\n }\n }\n }\n\n // All modifiers are correct, now check the key\n // If the key is set, we check for the key\n if (keys && keys.length === 1 && (keys.includes(pressedKey) || keys.includes(keyCode))) {\n return true\n } else if (keys) {\n // Check if all keys are present in pressedDownKeys set\n return isHotkeyPressed(keys)\n } else if (!keys) {\n // If the key is not set, we only listen for modifiers, that check went alright, so we return true\n return true\n }\n\n // There is nothing that matches.\n return false\n}\n","import { createContext, ReactNode, useContext } from 'react'\nimport { Hotkey } from './types'\n\ntype BoundHotkeysProxyProviderType = {\n addHotkey: (hotkey: Hotkey) => void\n removeHotkey: (hotkey: Hotkey) => void\n}\n\nconst BoundHotkeysProxyProvider = createContext<BoundHotkeysProxyProviderType | undefined>(undefined)\n\nexport const useBoundHotkeysProxy = () => {\n return useContext(BoundHotkeysProxyProvider)\n}\n\ninterface Props {\n children: ReactNode\n addHotkey: (hotkey: Hotkey) => void\n removeHotkey: (hotkey: Hotkey) => void\n}\n\nexport default function BoundHotkeysProxyProviderProvider({ addHotkey, removeHotkey, children }: Props) {\n return (\n <BoundHotkeysProxyProvider.Provider value={{ addHotkey, removeHotkey }}>\n {children}\n </BoundHotkeysProxyProvider.Provider>\n )\n}\n","export default function deepEqual(x: any, y: any): boolean {\n //@ts-ignore\n return x && y && typeof x === 'object' && typeof y === 'object'\n ? Object.keys(x).length === Object.keys(y).length &&\n //@ts-ignore\n Object.keys(x).reduce((isEqual, key) => isEqual && deepEqual(x[key], y[key]), true)\n : x === y\n}\n","import { Hotkey } from './types'\nimport { createContext, ReactNode, useState, useContext, useCallback } from 'react'\nimport BoundHotkeysProxyProviderProvider from './BoundHotkeysProxyProvider'\nimport deepEqual from './deepEqual'\n\nexport type HotkeysContextType = {\n hotkeys: ReadonlyArray<Hotkey>\n enabledScopes: string[]\n toggleScope: (scope: string) => void\n enableScope: (scope: string) => void\n disableScope: (scope: string) => void\n}\n\n// The context is only needed for special features like global scoping, so we use a graceful default fallback\nconst HotkeysContext = createContext<HotkeysContextType>({\n hotkeys: [],\n enabledScopes: [], // This array has to be empty instead of containing '*' as default, to check if the provider is set or not\n toggleScope: () => {},\n enableScope: () => {},\n disableScope: () => {},\n})\n\nexport const useHotkeysContext = () => {\n return useContext(HotkeysContext)\n}\n\ninterface Props {\n initiallyActiveScopes?: string[]\n children: ReactNode\n}\n\nexport const HotkeysProvider = ({ initiallyActiveScopes = ['*'], children }: Props) => {\n const [internalActiveScopes, setInternalActiveScopes] = useState(\n initiallyActiveScopes?.length > 0 ? initiallyActiveScopes : ['*']\n )\n const [boundHotkeys, setBoundHotkeys] = useState<Hotkey[]>([])\n\n const enableScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n if (prev.includes('*')) {\n return [scope]\n }\n\n return Array.from(new Set([...prev, scope]))\n })\n }, [])\n\n const disableScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n if (prev.filter((s) => s !== scope).length === 0) {\n return ['*']\n } else {\n return prev.filter((s) => s !== scope)\n }\n })\n }, [])\n\n const toggleScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n if (prev.includes(scope)) {\n if (prev.filter((s) => s !== scope).length === 0) {\n return ['*']\n } else {\n return prev.filter((s) => s !== scope)\n }\n } else {\n if (prev.includes('*')) {\n return [scope]\n }\n\n return Array.from(new Set([...prev, scope]))\n }\n })\n }, [])\n\n const addBoundHotkey = useCallback((hotkey: Hotkey) => {\n setBoundHotkeys((prev) => [...prev, hotkey])\n }, [])\n\n const removeBoundHotkey = useCallback((hotkey: Hotkey) => {\n setBoundHotkeys((prev) => prev.filter((h) => !deepEqual(h, hotkey)))\n }, [])\n\n return (\n <HotkeysContext.Provider\n value={{ enabledScopes: internalActiveScopes, hotkeys: boundHotkeys, enableScope, disableScope, toggleScope }}\n >\n <BoundHotkeysProxyProviderProvider addHotkey={addBoundHotkey} removeHotkey={removeBoundHotkey}>\n {children}\n </BoundHotkeysProxyProviderProvider>\n </HotkeysContext.Provider>\n )\n}\n","import { useRef } from 'react'\nimport deepEqual from './deepEqual'\n\nexport default function useDeepEqualMemo<T>(value: T) {\n const ref = useRef<T | undefined>(undefined)\n\n if (!deepEqual(ref.current, value)) {\n ref.current = value\n }\n\n return ref.current\n}\n","import { HotkeyCallback, Keys, Options, OptionsOrDependencyArray, RefType } from './types'\nimport { DependencyList, useCallback, useEffect, useLayoutEffect, useRef } from 'react'\nimport { mapKey, parseHotkey, parseKeysHookInput } from './parseHotkeys'\nimport {\n isHotkeyEnabled,\n isHotkeyEnabledOnTag,\n isHotkeyMatchingKeyboardEvent,\n isKeyboardEventTriggeredByInput,\n isScopeActive,\n maybePreventDefault,\n} from './validators'\nimport { useHotkeysContext } from './HotkeysProvider'\nimport { useBoundHotkeysProxy } from './BoundHotkeysProxyProvider'\nimport useDeepEqualMemo from './useDeepEqualMemo'\nimport { isReadonlyArray, pushToCurrentlyPressedKeys, removeFromCurrentlyPressedKeys } from './isHotkeyPressed'\n\nconst stopPropagation = (e: KeyboardEvent): void => {\n e.stopPropagation()\n e.preventDefault()\n e.stopImmediatePropagation()\n}\n\nconst useSafeLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect\n\nexport default function useHotkeys<T extends HTMLElement>(\n keys: Keys,\n callback: HotkeyCallback,\n options?: OptionsOrDependencyArray,\n dependencies?: OptionsOrDependencyArray\n) {\n const ref = useRef<RefType<T>>(null)\n const hasTriggeredRef = useRef(false)\n\n const _options: Options | undefined = !(options instanceof Array)\n ? (options as Options)\n : !(dependencies instanceof Array)\n ? (dependencies as Options)\n : undefined\n const _keys: string = isReadonlyArray(keys) ? keys.join(_options?.splitKey) : keys\n const _deps: DependencyList | undefined =\n options instanceof Array ? options : dependencies instanceof Array ? dependencies : undefined\n\n const memoisedCB = useCallback(callback, _deps ?? [])\n const cbRef = useRef<HotkeyCallback>(memoisedCB)\n\n if (_deps) {\n cbRef.current = memoisedCB\n } else {\n cbRef.current = callback\n }\n\n const memoisedOptions = useDeepEqualMemo(_options)\n\n const { enabledScopes } = useHotkeysContext()\n const proxy = useBoundHotkeysProxy()\n\n useSafeLayoutEffect(() => {\n if (memoisedOptions?.enabled === false || !isScopeActive(enabledScopes, memoisedOptions?.scopes)) {\n return\n }\n\n const listener = (e: KeyboardEvent, isKeyUp = false) => {\n if (isKeyboardEventTriggeredByInput(e) && !isHotkeyEnabledOnTag(e, memoisedOptions?.enableOnFormTags)) {\n return\n }\n\n // TODO: SINCE THE EVENT IS NOW ATTACHED TO THE REF, THE ACTIVE ELEMENT CAN NEVER BE INSIDE THE REF. THE HOTKEY ONLY TRIGGERS IF THE\n // REF IS THE ACTIVE ELEMENT. THIS IS A PROBLEM SINCE FOCUSED SUB COMPONENTS WON'T TRIGGER THE HOTKEY.\n if (ref.current !== null) {\n const rootNode = ref.current.getRootNode()\n if (\n (rootNode instanceof Document || rootNode instanceof ShadowRoot) &&\n rootNode.activeElement !== ref.current &&\n !ref.current.contains(rootNode.activeElement)\n ) {\n stopPropagation(e)\n return\n }\n }\n\n if ((e.target as HTMLElement)?.isContentEditable && !memoisedOptions?.enableOnContentEditable) {\n return\n }\n\n parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) => {\n const hotkey = parseHotkey(key, memoisedOptions?.combinationKey)\n\n if (isHotkeyMatchingKeyboardEvent(e, hotkey, memoisedOptions?.ignoreModifiers) || hotkey.keys?.includes('*')) {\n if (memoisedOptions?.ignoreEventWhen?.(e)) {\n return\n }\n\n if (isKeyUp && hasTriggeredRef.current) {\n return\n }\n\n maybePreventDefault(e, hotkey, memoisedOptions?.preventDefault)\n\n if (!isHotkeyEnabled(e, hotkey, memoisedOptions?.enabled)) {\n stopPropagation(e)\n\n return\n }\n\n // Execute the user callback for that hotkey\n cbRef.current(e, hotkey)\n\n if (!isKeyUp) {\n hasTriggeredRef.current = true\n }\n }\n })\n }\n\n const handleKeyDown = (event: KeyboardEvent) => {\n if (event.key === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n pushToCurrentlyPressedKeys(mapKey(event.code))\n\n if ((memoisedOptions?.keydown === undefined && memoisedOptions?.keyup !== true) || memoisedOptions?.keydown) {\n listener(event)\n }\n }\n\n const handleKeyUp = (event: KeyboardEvent) => {\n if (event.key === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n removeFromCurrentlyPressedKeys(mapKey(event.code))\n\n hasTriggeredRef.current = false\n\n if (memoisedOptions?.keyup) {\n listener(event, true)\n }\n }\n\n const domNode = ref.current || _options?.document || document\n\n // @ts-ignore\n domNode.addEventListener('keyup', handleKeyUp)\n // @ts-ignore\n domNode.addEventListener('keydown', handleKeyDown)\n\n if (proxy) {\n parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) =>\n proxy.addHotkey(parseHotkey(key, memoisedOptions?.combinationKey, memoisedOptions?.description))\n )\n }\n\n return () => {\n // @ts-ignore\n domNode.removeEventListener('keyup', handleKeyUp)\n // @ts-ignore\n domNode.removeEventListener('keydown', handleKeyDown)\n\n if (proxy) {\n parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) =>\n proxy.removeHotkey(parseHotkey(key, memoisedOptions?.combinationKey, memoisedOptions?.description))\n )\n }\n }\n }, [_keys, memoisedOptions, enabledScopes])\n\n return ref\n}\n","import { useCallback, useState } from 'react'\nimport { mapKey } from './parseHotkeys'\n\nexport default function useRecordHotkeys() {\n const [keys, setKeys] = useState(new Set<string>())\n const [isRecording, setIsRecording] = useState(false)\n\n const handler = useCallback((event: KeyboardEvent) => {\n if (event.key === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n event.preventDefault()\n event.stopPropagation()\n\n setKeys((prev) => {\n const newKeys = new Set(prev)\n\n newKeys.add(mapKey(event.code))\n\n return newKeys\n })\n }, [])\n\n const stop = useCallback(() => {\n if (typeof document !== 'undefined') {\n document.removeEventListener('keydown', handler)\n\n setIsRecording(false)\n }\n }, [handler])\n\n const start = useCallback(() => {\n setKeys(new Set<string>())\n\n if (typeof document !== 'undefined') {\n stop()\n\n document.addEventListener('keydown', handler)\n\n setIsRecording(true)\n }\n }, [handler, stop])\n\n const resetKeys = useCallback(() => {\n setKeys(new Set<string>())\n }, [])\n\n return [keys, { start, stop, resetKeys, isRecording }] as const\n}\n"],"names":["reservedModifierKeywords","mappedKeys","esc","ShiftLeft","ShiftRight","AltLeft","AltRight","MetaLeft","MetaRight","OSLeft","OSRight","ControlLeft","ControlRight","mapKey","key","trim","toLowerCase","replace","isHotkeyModifier","includes","parseKeysHookInput","keys","splitKey","split","parseHotkey","hotkey","combinationKey","description","toLocaleLowerCase","map","k","modifiers","alt","ctrl","shift","meta","mod","singleCharKeys","filter","_extends","document","addEventListener","e","undefined","pushToCurrentlyPressedKeys","code","removeFromCurrentlyPressedKeys","window","currentlyPressedKeys","clear","Set","isReadonlyArray","value","Array","isArray","isHotkeyPressed","hotkeyArray","every","has","forEach","add","maybePreventDefault","preventDefault","isHotkeyEnabled","enabled","isKeyboardEventTriggeredByInput","ev","isHotkeyEnabledOnTag","_ref","enabledOnTags","target","targetTagName","tagName","Boolean","some","tag","isScopeActive","activeScopes","scopes","length","console","warn","scope","isHotkeyMatchingKeyboardEvent","ignoreModifiers","pressedKeyUppercase","ctrlKey","metaKey","shiftKey","altKey","keyCode","pressedKey","BoundHotkeysProxyProvider","createContext","useBoundHotkeysProxy","useContext","BoundHotkeysProxyProviderProvider","addHotkey","removeHotkey","children","_jsx","Provider","deepEqual","x","y","Object","reduce","isEqual","HotkeysContext","hotkeys","enabledScopes","toggleScope","enableScope","disableScope","useHotkeysContext","HotkeysProvider","initiallyActiveScopes","_ref$initiallyActiveS","_useState","useState","internalActiveScopes","setInternalActiveScopes","_useState2","boundHotkeys","setBoundHotkeys","useCallback","prev","from","concat","s","addBoundHotkey","removeBoundHotkey","h","useDeepEqualMemo","ref","useRef","current","stopPropagation","stopImmediatePropagation","useSafeLayoutEffect","useLayoutEffect","useEffect","useHotkeys","callback","options","dependencies","hasTriggeredRef","_options","_keys","join","_deps","memoisedCB","cbRef","memoisedOptions","_useHotkeysContext","proxy","listener","isKeyUp","enableOnFormTags","rootNode","getRootNode","Document","ShadowRoot","activeElement","contains","_e$target","isContentEditable","enableOnContentEditable","_hotkey$keys","ignoreEventWhen","handleKeyDown","event","keydown","keyup","handleKeyUp","domNode","removeEventListener","useRecordHotkeys","setKeys","isRecording","setIsRecording","handler","newKeys","stop","start","resetKeys"],"mappings":"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"}
1
+ {"version":3,"file":"react-hotkeys-hook.esm.js","sources":["../src/parseHotkeys.ts","../src/isHotkeyPressed.ts","../src/validators.ts","../src/BoundHotkeysProxyProvider.tsx","../src/deepEqual.ts","../src/HotkeysProvider.tsx","../src/useDeepEqualMemo.ts","../src/useHotkeys.ts","../src/useRecordHotkeys.ts"],"sourcesContent":["import { Hotkey, KeyboardModifiers } from './types'\n\nconst reservedModifierKeywords = ['shift', 'alt', 'meta', 'mod', 'ctrl', 'control']\n\nconst mappedKeys: Record<string, string> = {\n esc: 'escape',\n return: 'enter',\n left: 'arrowleft',\n right: 'arrowright',\n up: 'arrowup',\n down: 'arrowdown',\n ShiftLeft: 'shift',\n ShiftRight: 'shift',\n AltLeft: 'alt',\n AltRight: 'alt',\n MetaLeft: 'meta',\n MetaRight: 'meta',\n OSLeft: 'meta',\n OSRight: 'meta',\n ControlLeft: 'ctrl',\n ControlRight: 'ctrl',\n}\n\nexport function mapKey(key: string): string {\n return (mappedKeys[key.trim()] || key.trim()).toLowerCase().replace(/key|digit|numpad/, '')\n}\n\nexport function isHotkeyModifier(key: string) {\n return reservedModifierKeywords.includes(key)\n}\n\nexport function parseKeysHookInput(keys: string, delimiter = ','): string[] {\n return keys.toLowerCase().split(delimiter)\n}\n\nexport function parseHotkey(hotkey: string, splitKey = '+', useKey = false, description?: string): Hotkey {\n const keys = hotkey\n .toLocaleLowerCase()\n .split(splitKey)\n .map((k) => mapKey(k))\n\n const modifiers: KeyboardModifiers = {\n alt: keys.includes('alt'),\n ctrl: keys.includes('ctrl') || keys.includes('control'),\n shift: keys.includes('shift'),\n meta: keys.includes('meta'),\n mod: keys.includes('mod'),\n useKey,\n }\n\n const singleCharKeys = keys.filter((k) => !reservedModifierKeywords.includes(k))\n\n return {\n ...modifiers,\n keys: singleCharKeys,\n description,\n }\n}\n","import { isHotkeyModifier, mapKey } from './parseHotkeys'\n;(() => {\n if (typeof document !== 'undefined') {\n document.addEventListener('keydown', (e) => {\n if (e.code === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n pushToCurrentlyPressedKeys([mapKey(e.code)])\n })\n\n document.addEventListener('keyup', (e) => {\n if (e.code === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n removeFromCurrentlyPressedKeys([mapKey(e.code)])\n })\n }\n\n if (typeof window !== 'undefined') {\n window.addEventListener('blur', () => {\n currentlyPressedKeys.clear()\n })\n }\n})()\n\nconst currentlyPressedKeys: Set<string> = new Set<string>()\n\n// https://github.com/microsoft/TypeScript/issues/17002\nexport function isReadonlyArray(value: unknown): value is readonly unknown[] {\n return Array.isArray(value)\n}\n\nexport function isHotkeyPressed(key: string | readonly string[], delimiter = ','): boolean {\n const hotkeyArray = isReadonlyArray(key) ? key : key.split(delimiter)\n\n return hotkeyArray.every((hotkey) => currentlyPressedKeys.has(hotkey.trim().toLowerCase()))\n}\n\nexport function pushToCurrentlyPressedKeys(key: string | string[]): void {\n const hotkeyArray = Array.isArray(key) ? key : [key]\n\n /*\n Due to a weird behavior on macOS we need to clear the set if the user pressed down the meta key and presses another key.\n https://stackoverflow.com/questions/11818637/why-does-javascript-drop-keyup-events-when-the-metakey-is-pressed-on-mac-browser\n Otherwise the set will hold all ever pressed keys while the meta key is down which leads to wrong results.\n */\n if (currentlyPressedKeys.has('meta')) {\n currentlyPressedKeys.forEach((key) => !isHotkeyModifier(key) && currentlyPressedKeys.delete(key.toLowerCase()))\n }\n\n hotkeyArray.forEach((hotkey) => currentlyPressedKeys.add(hotkey.toLowerCase()))\n}\n\nexport function removeFromCurrentlyPressedKeys(key: string | string[]): void {\n const hotkeyArray = Array.isArray(key) ? key : [key]\n\n /*\n Due to a weird behavior on macOS we need to clear the set if the user pressed down the meta key and presses another key.\n https://stackoverflow.com/questions/11818637/why-does-javascript-drop-keyup-events-when-the-metakey-is-pressed-on-mac-browser\n Otherwise the set will hold all ever pressed keys while the meta key is down which leads to wrong results.\n */\n if (key === 'meta') {\n currentlyPressedKeys.clear()\n } else {\n hotkeyArray.forEach((hotkey) => currentlyPressedKeys.delete(hotkey.toLowerCase()))\n }\n}\n","import { FormTags, Hotkey, Scopes, Trigger } from './types'\nimport { isHotkeyPressed, isReadonlyArray } from './isHotkeyPressed'\nimport { mapKey } from './parseHotkeys'\n\nexport function maybePreventDefault(e: KeyboardEvent, hotkey: Hotkey, preventDefault?: Trigger): void {\n if ((typeof preventDefault === 'function' && preventDefault(e, hotkey)) || preventDefault === true) {\n e.preventDefault()\n }\n}\n\nexport function isHotkeyEnabled(e: KeyboardEvent, hotkey: Hotkey, enabled?: Trigger): boolean {\n if (typeof enabled === 'function') {\n return enabled(e, hotkey)\n }\n\n return enabled === true || enabled === undefined\n}\n\nexport function isKeyboardEventTriggeredByInput(ev: KeyboardEvent): boolean {\n return isHotkeyEnabledOnTag(ev, ['input', 'textarea', 'select'])\n}\n\nexport function isHotkeyEnabledOnTag(\n { target }: KeyboardEvent,\n enabledOnTags: readonly FormTags[] | boolean = false\n): boolean {\n const targetTagName = target && (target as HTMLElement).tagName\n\n if (isReadonlyArray(enabledOnTags)) {\n return Boolean(\n targetTagName && enabledOnTags && enabledOnTags.some((tag) => tag.toLowerCase() === targetTagName.toLowerCase())\n )\n }\n\n return Boolean(targetTagName && enabledOnTags && enabledOnTags)\n}\n\nexport function isScopeActive(activeScopes: string[], scopes?: Scopes): boolean {\n if (activeScopes.length === 0 && scopes) {\n console.warn(\n 'A hotkey has the \"scopes\" option set, however no active scopes were found. If you want to use the global scopes feature, you need to wrap your app in a <HotkeysProvider>'\n )\n\n return true\n }\n\n if (!scopes) {\n return true\n }\n\n return activeScopes.some((scope) => scopes.includes(scope)) || activeScopes.includes('*')\n}\n\nexport const isHotkeyMatchingKeyboardEvent = (e: KeyboardEvent, hotkey: Hotkey, ignoreModifiers = false): boolean => {\n const { alt, meta, mod, shift, ctrl, keys, useKey } = hotkey\n const { code, key: producedKey, ctrlKey, metaKey, shiftKey, altKey } = e\n\n const mappedCode = mapKey(code)\n\n if (useKey && keys?.length === 1 && keys.includes(producedKey)) {\n return true\n }\n\n if (\n !keys?.includes(mappedCode) &&\n !['ctrl', 'control', 'unknown', 'meta', 'alt', 'shift', 'os'].includes(mappedCode)\n ) {\n return false\n }\n\n if (!ignoreModifiers) {\n // We check the pressed keys for compatibility with the keyup event. In keyup events the modifier flags are not set.\n if (alt !== altKey && mappedCode !== 'alt') {\n return false\n }\n\n if (shift !== shiftKey && mappedCode !== 'shift') {\n return false\n }\n\n // Mod is a special key name that is checking for meta on macOS and ctrl on other platforms\n if (mod) {\n if (!metaKey && !ctrlKey) {\n return false\n }\n } else {\n if (meta !== metaKey && mappedCode !== 'meta' && mappedCode !== 'os') {\n return false\n }\n\n if (ctrl !== ctrlKey && mappedCode !== 'ctrl' && mappedCode !== 'control') {\n return false\n }\n }\n }\n\n // All modifiers are correct, now check the key\n // If the key is set, we check for the key\n if (keys && keys.length === 1 && keys.includes(mappedCode)) {\n return true\n } else if (keys) {\n // Check if all keys are present in pressedDownKeys set\n return isHotkeyPressed(keys)\n } else if (!keys) {\n // If the key is not set, we only listen for modifiers, that check went alright, so we return true\n return true\n }\n\n // There is nothing that matches.\n return false\n}\n","import { createContext, ReactNode, useContext } from 'react'\nimport { Hotkey } from './types'\n\ntype BoundHotkeysProxyProviderType = {\n addHotkey: (hotkey: Hotkey) => void\n removeHotkey: (hotkey: Hotkey) => void\n}\n\nconst BoundHotkeysProxyProvider = createContext<BoundHotkeysProxyProviderType | undefined>(undefined)\n\nexport const useBoundHotkeysProxy = () => {\n return useContext(BoundHotkeysProxyProvider)\n}\n\ninterface Props {\n children: ReactNode\n addHotkey: (hotkey: Hotkey) => void\n removeHotkey: (hotkey: Hotkey) => void\n}\n\nexport default function BoundHotkeysProxyProviderProvider({ addHotkey, removeHotkey, children }: Props) {\n return (\n <BoundHotkeysProxyProvider.Provider value={{ addHotkey, removeHotkey }}>\n {children}\n </BoundHotkeysProxyProvider.Provider>\n )\n}\n","export default function deepEqual(x: any, y: any): boolean {\n //@ts-ignore\n return x && y && typeof x === 'object' && typeof y === 'object'\n ? Object.keys(x).length === Object.keys(y).length &&\n //@ts-ignore\n Object.keys(x).reduce((isEqual, key) => isEqual && deepEqual(x[key], y[key]), true)\n : x === y\n}\n","import { Hotkey } from './types'\nimport { createContext, ReactNode, useState, useContext, useCallback } from 'react'\nimport BoundHotkeysProxyProviderProvider from './BoundHotkeysProxyProvider'\nimport deepEqual from './deepEqual'\n\nexport type HotkeysContextType = {\n hotkeys: ReadonlyArray<Hotkey>\n activeScopes: string[]\n toggleScope: (scope: string) => void\n enableScope: (scope: string) => void\n disableScope: (scope: string) => void\n}\n\n// The context is only needed for special features like global scoping, so we use a graceful default fallback\nconst HotkeysContext = createContext<HotkeysContextType>({\n hotkeys: [],\n activeScopes: [], // This array has to be empty instead of containing '*' as default, to check if the provider is set or not\n toggleScope: () => {},\n enableScope: () => {},\n disableScope: () => {},\n})\n\nexport const useHotkeysContext = () => {\n return useContext(HotkeysContext)\n}\n\ninterface Props {\n initiallyActiveScopes?: string[]\n children: ReactNode\n}\n\nexport const HotkeysProvider = ({ initiallyActiveScopes = ['*'], children }: Props) => {\n const [internalActiveScopes, setInternalActiveScopes] = useState(initiallyActiveScopes)\n const [boundHotkeys, setBoundHotkeys] = useState<Hotkey[]>([])\n\n const enableScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n if (prev.includes('*')) {\n return [scope]\n }\n return Array.from(new Set([...prev, scope]))\n })\n }, [])\n\n const disableScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n return prev.filter((s) => s !== scope)\n })\n }, [])\n\n const toggleScope = useCallback((scope: string) => {\n setInternalActiveScopes((prev) => {\n if (prev.includes(scope)) {\n return prev.filter((s) => s !== scope)\n } else {\n if (prev.includes('*')) {\n return [scope]\n }\n return Array.from(new Set([...prev, scope]))\n }\n })\n }, [])\n\n const addBoundHotkey = useCallback((hotkey: Hotkey) => {\n setBoundHotkeys((prev) => [...prev, hotkey])\n }, [])\n\n const removeBoundHotkey = useCallback((hotkey: Hotkey) => {\n setBoundHotkeys((prev) => prev.filter((h) => !deepEqual(h, hotkey)))\n }, [])\n\n return (\n <HotkeysContext.Provider\n value={{ activeScopes: internalActiveScopes, hotkeys: boundHotkeys, enableScope, disableScope, toggleScope }}\n >\n <BoundHotkeysProxyProviderProvider addHotkey={addBoundHotkey} removeHotkey={removeBoundHotkey}>\n {children}\n </BoundHotkeysProxyProviderProvider>\n </HotkeysContext.Provider>\n )\n}\n","import { useRef } from 'react'\nimport deepEqual from './deepEqual'\n\nexport default function useDeepEqualMemo<T>(value: T) {\n const ref = useRef<T | undefined>(undefined)\n\n if (!deepEqual(ref.current, value)) {\n ref.current = value\n }\n\n return ref.current\n}\n","import { HotkeyCallback, Keys, Options, OptionsOrDependencyArray, RefType } from './types'\nimport { DependencyList, useCallback, useEffect, useLayoutEffect, useRef } from 'react'\nimport { mapKey, parseHotkey, parseKeysHookInput } from './parseHotkeys'\nimport {\n isHotkeyEnabled,\n isHotkeyEnabledOnTag,\n isHotkeyMatchingKeyboardEvent,\n isKeyboardEventTriggeredByInput,\n isScopeActive,\n maybePreventDefault,\n} from './validators'\nimport { useHotkeysContext } from './HotkeysProvider'\nimport { useBoundHotkeysProxy } from './BoundHotkeysProxyProvider'\nimport useDeepEqualMemo from './useDeepEqualMemo'\nimport { isReadonlyArray, pushToCurrentlyPressedKeys, removeFromCurrentlyPressedKeys } from './isHotkeyPressed'\n\nconst stopPropagation = (e: KeyboardEvent): void => {\n e.stopPropagation()\n e.preventDefault()\n e.stopImmediatePropagation()\n}\n\nconst useSafeLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect\n\nexport default function useHotkeys<T extends HTMLElement>(\n keys: Keys,\n callback: HotkeyCallback,\n options?: OptionsOrDependencyArray,\n dependencies?: OptionsOrDependencyArray\n) {\n const ref = useRef<RefType<T>>(null)\n const hasTriggeredRef = useRef(false)\n\n const _options: Options | undefined = !(options instanceof Array)\n ? (options as Options)\n : !(dependencies instanceof Array)\n ? (dependencies as Options)\n : undefined\n const _keys: string = isReadonlyArray(keys) ? keys.join(_options?.delimiter) : keys\n const _deps: DependencyList | undefined =\n options instanceof Array ? options : dependencies instanceof Array ? dependencies : undefined\n\n const memoisedCB = useCallback(callback, _deps ?? [])\n const cbRef = useRef<HotkeyCallback>(memoisedCB)\n\n if (_deps) {\n cbRef.current = memoisedCB\n } else {\n cbRef.current = callback\n }\n\n const memoisedOptions = useDeepEqualMemo(_options)\n\n const { activeScopes } = useHotkeysContext()\n const proxy = useBoundHotkeysProxy()\n\n useSafeLayoutEffect(() => {\n if (memoisedOptions?.enabled === false || !isScopeActive(activeScopes, memoisedOptions?.scopes)) {\n return\n }\n\n const listener = (e: KeyboardEvent, isKeyUp = false) => {\n if (isKeyboardEventTriggeredByInput(e) && !isHotkeyEnabledOnTag(e, memoisedOptions?.enableOnFormTags)) {\n return\n }\n\n // TODO: SINCE THE EVENT IS NOW ATTACHED TO THE REF, THE ACTIVE ELEMENT CAN NEVER BE INSIDE THE REF. THE HOTKEY ONLY TRIGGERS IF THE\n // REF IS THE ACTIVE ELEMENT. THIS IS A PROBLEM SINCE FOCUSED SUB COMPONENTS WON'T TRIGGER THE HOTKEY.\n if (ref.current !== null) {\n const rootNode = ref.current.getRootNode()\n\n if (\n (rootNode instanceof Document || rootNode instanceof ShadowRoot) &&\n rootNode.activeElement !== ref.current &&\n !ref.current.contains(rootNode.activeElement)\n ) {\n stopPropagation(e)\n return\n }\n }\n\n if ((e.target as HTMLElement)?.isContentEditable && !memoisedOptions?.enableOnContentEditable) {\n return\n }\n\n parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) => {\n const hotkey = parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey)\n\n if (isHotkeyMatchingKeyboardEvent(e, hotkey, memoisedOptions?.ignoreModifiers) || hotkey.keys?.includes('*')) {\n if (memoisedOptions?.ignoreEventWhen?.(e)) {\n return\n }\n\n if (isKeyUp && hasTriggeredRef.current) {\n return\n }\n\n maybePreventDefault(e, hotkey, memoisedOptions?.preventDefault)\n\n if (!isHotkeyEnabled(e, hotkey, memoisedOptions?.enabled)) {\n stopPropagation(e)\n\n return\n }\n\n // Execute the user callback for that hotkey\n cbRef.current(e, hotkey)\n\n if (!isKeyUp) {\n hasTriggeredRef.current = true\n }\n }\n })\n }\n\n const handleKeyDown = (event: KeyboardEvent) => {\n if (event.code === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n pushToCurrentlyPressedKeys(mapKey(event.code))\n\n if ((memoisedOptions?.keydown === undefined && memoisedOptions?.keyup !== true) || memoisedOptions?.keydown) {\n listener(event)\n }\n }\n\n const handleKeyUp = (event: KeyboardEvent) => {\n if (event.code === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n removeFromCurrentlyPressedKeys(mapKey(event.code))\n\n hasTriggeredRef.current = false\n\n if (memoisedOptions?.keyup) {\n listener(event, true)\n }\n }\n\n const domNode = ref.current || _options?.document || document\n\n // @ts-ignore\n domNode.addEventListener('keyup', handleKeyUp)\n // @ts-ignore\n domNode.addEventListener('keydown', handleKeyDown)\n\n if (proxy) {\n parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) =>\n proxy.addHotkey(\n parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey, memoisedOptions?.description)\n )\n )\n }\n\n return () => {\n // @ts-ignore\n domNode.removeEventListener('keyup', handleKeyUp)\n // @ts-ignore\n domNode.removeEventListener('keydown', handleKeyDown)\n\n if (proxy) {\n parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) =>\n proxy.removeHotkey(\n parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey, memoisedOptions?.description)\n )\n )\n }\n }\n }, [_keys, memoisedOptions, activeScopes])\n\n return ref\n}\n","import { useCallback, useState } from 'react'\nimport { mapKey } from './parseHotkeys'\n\nexport default function useRecordHotkeys() {\n const [keys, setKeys] = useState(new Set<string>())\n const [isRecording, setIsRecording] = useState(false)\n\n const handler = useCallback((event: KeyboardEvent) => {\n if (event.code === undefined) {\n // Synthetic event (e.g., Chrome autofill). Ignore.\n return\n }\n\n event.preventDefault()\n event.stopPropagation()\n\n setKeys((prev) => {\n const newKeys = new Set(prev)\n\n newKeys.add(mapKey(event.code))\n\n return newKeys\n })\n }, [])\n\n const stop = useCallback(() => {\n if (typeof document !== 'undefined') {\n document.removeEventListener('keydown', handler)\n\n setIsRecording(false)\n }\n }, [handler])\n\n const start = useCallback(() => {\n setKeys(new Set<string>())\n\n if (typeof document !== 'undefined') {\n stop()\n\n document.addEventListener('keydown', handler)\n\n setIsRecording(true)\n }\n }, [handler, stop])\n\n const resetKeys = useCallback(() => {\n setKeys(new Set<string>())\n }, [])\n\n return [keys, { start, stop, resetKeys, isRecording }] as const\n}\n"],"names":["reservedModifierKeywords","mappedKeys","esc","left","right","up","down","ShiftLeft","ShiftRight","AltLeft","AltRight","MetaLeft","MetaRight","OSLeft","OSRight","ControlLeft","ControlRight","mapKey","key","trim","toLowerCase","replace","isHotkeyModifier","includes","parseKeysHookInput","keys","delimiter","split","parseHotkey","hotkey","splitKey","useKey","description","toLocaleLowerCase","map","k","modifiers","alt","ctrl","shift","meta","mod","singleCharKeys","filter","_extends","document","addEventListener","e","code","undefined","pushToCurrentlyPressedKeys","removeFromCurrentlyPressedKeys","window","currentlyPressedKeys","clear","Set","isReadonlyArray","value","Array","isArray","isHotkeyPressed","hotkeyArray","every","has","forEach","add","maybePreventDefault","preventDefault","isHotkeyEnabled","enabled","isKeyboardEventTriggeredByInput","ev","isHotkeyEnabledOnTag","_ref","enabledOnTags","target","targetTagName","tagName","Boolean","some","tag","isScopeActive","activeScopes","scopes","length","console","warn","scope","isHotkeyMatchingKeyboardEvent","ignoreModifiers","producedKey","ctrlKey","metaKey","shiftKey","altKey","mappedCode","BoundHotkeysProxyProvider","createContext","useBoundHotkeysProxy","useContext","BoundHotkeysProxyProviderProvider","addHotkey","removeHotkey","children","_jsx","Provider","deepEqual","x","y","Object","reduce","isEqual","HotkeysContext","hotkeys","toggleScope","enableScope","disableScope","useHotkeysContext","HotkeysProvider","initiallyActiveScopes","_ref$initiallyActiveS","_useState","useState","internalActiveScopes","setInternalActiveScopes","_useState2","boundHotkeys","setBoundHotkeys","useCallback","prev","from","concat","s","addBoundHotkey","removeBoundHotkey","h","useDeepEqualMemo","ref","useRef","current","stopPropagation","stopImmediatePropagation","useSafeLayoutEffect","useLayoutEffect","useEffect","useHotkeys","callback","options","dependencies","hasTriggeredRef","_options","_keys","join","_deps","memoisedCB","cbRef","memoisedOptions","_useHotkeysContext","proxy","listener","isKeyUp","enableOnFormTags","rootNode","getRootNode","Document","ShadowRoot","activeElement","contains","_e$target","isContentEditable","enableOnContentEditable","_hotkey$keys","ignoreEventWhen","handleKeyDown","event","keydown","keyup","handleKeyUp","domNode","removeEventListener","useRecordHotkeys","setKeys","isRecording","setIsRecording","handler","newKeys","stop","start","resetKeys"],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -9,6 +9,7 @@ export declare type KeyboardModifiers = {
9
9
  meta?: boolean;
10
10
  shift?: boolean;
11
11
  mod?: boolean;
12
+ useKey?: boolean;
12
13
  };
13
14
  export declare type Hotkey = KeyboardModifiers & {
14
15
  keys?: readonly string[];
@@ -23,8 +24,8 @@ export declare type Options = {
23
24
  enableOnFormTags?: readonly FormTags[] | boolean;
24
25
  enableOnContentEditable?: boolean;
25
26
  ignoreEventWhen?: (e: KeyboardEvent) => boolean;
26
- combinationKey?: string;
27
27
  splitKey?: string;
28
+ delimiter?: string;
28
29
  scopes?: Scopes;
29
30
  keyup?: boolean;
30
31
  keydown?: boolean;
@@ -32,5 +33,6 @@ export declare type Options = {
32
33
  description?: string;
33
34
  document?: Document;
34
35
  ignoreModifiers?: boolean;
36
+ useKey?: boolean;
35
37
  };
36
38
  export declare type OptionsOrDependencyArray = Options | DependencyList;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "react-hotkeys-hook",
3
3
  "description": "React hook for handling keyboard shortcuts",
4
- "version": "4.5.0",
4
+ "version": "5.0.0-1",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "https://github.com/JohannesKlauss/react-keymap-hook.git"
@@ -5,7 +5,7 @@ import deepEqual from './deepEqual'
5
5
 
6
6
  export type HotkeysContextType = {
7
7
  hotkeys: ReadonlyArray<Hotkey>
8
- enabledScopes: string[]
8
+ activeScopes: string[]
9
9
  toggleScope: (scope: string) => void
10
10
  enableScope: (scope: string) => void
11
11
  disableScope: (scope: string) => void
@@ -14,7 +14,7 @@ export type HotkeysContextType = {
14
14
  // The context is only needed for special features like global scoping, so we use a graceful default fallback
15
15
  const HotkeysContext = createContext<HotkeysContextType>({
16
16
  hotkeys: [],
17
- enabledScopes: [], // This array has to be empty instead of containing '*' as default, to check if the provider is set or not
17
+ activeScopes: [], // This array has to be empty instead of containing '*' as default, to check if the provider is set or not
18
18
  toggleScope: () => {},
19
19
  enableScope: () => {},
20
20
  disableScope: () => {},
@@ -30,9 +30,7 @@ interface Props {
30
30
  }
31
31
 
32
32
  export const HotkeysProvider = ({ initiallyActiveScopes = ['*'], children }: Props) => {
33
- const [internalActiveScopes, setInternalActiveScopes] = useState(
34
- initiallyActiveScopes?.length > 0 ? initiallyActiveScopes : ['*']
35
- )
33
+ const [internalActiveScopes, setInternalActiveScopes] = useState(initiallyActiveScopes)
36
34
  const [boundHotkeys, setBoundHotkeys] = useState<Hotkey[]>([])
37
35
 
38
36
  const enableScope = useCallback((scope: string) => {
@@ -40,34 +38,24 @@ export const HotkeysProvider = ({ initiallyActiveScopes = ['*'], children }: Pro
40
38
  if (prev.includes('*')) {
41
39
  return [scope]
42
40
  }
43
-
44
41
  return Array.from(new Set([...prev, scope]))
45
42
  })
46
43
  }, [])
47
44
 
48
45
  const disableScope = useCallback((scope: string) => {
49
46
  setInternalActiveScopes((prev) => {
50
- if (prev.filter((s) => s !== scope).length === 0) {
51
- return ['*']
52
- } else {
53
- return prev.filter((s) => s !== scope)
54
- }
47
+ return prev.filter((s) => s !== scope)
55
48
  })
56
49
  }, [])
57
50
 
58
51
  const toggleScope = useCallback((scope: string) => {
59
52
  setInternalActiveScopes((prev) => {
60
53
  if (prev.includes(scope)) {
61
- if (prev.filter((s) => s !== scope).length === 0) {
62
- return ['*']
63
- } else {
64
- return prev.filter((s) => s !== scope)
65
- }
54
+ return prev.filter((s) => s !== scope)
66
55
  } else {
67
56
  if (prev.includes('*')) {
68
57
  return [scope]
69
58
  }
70
-
71
59
  return Array.from(new Set([...prev, scope]))
72
60
  }
73
61
  })
@@ -83,7 +71,7 @@ export const HotkeysProvider = ({ initiallyActiveScopes = ['*'], children }: Pro
83
71
 
84
72
  return (
85
73
  <HotkeysContext.Provider
86
- value={{ enabledScopes: internalActiveScopes, hotkeys: boundHotkeys, enableScope, disableScope, toggleScope }}
74
+ value={{ activeScopes: internalActiveScopes, hotkeys: boundHotkeys, enableScope, disableScope, toggleScope }}
87
75
  >
88
76
  <BoundHotkeysProxyProviderProvider addHotkey={addBoundHotkey} removeHotkey={removeBoundHotkey}>
89
77
  {children}
@@ -2,21 +2,21 @@ import { isHotkeyModifier, mapKey } from './parseHotkeys'
2
2
  ;(() => {
3
3
  if (typeof document !== 'undefined') {
4
4
  document.addEventListener('keydown', (e) => {
5
- if (e.key === undefined) {
6
- // Synthetic event (e.g., Chrome autofill). Ignore.
5
+ if (e.code === undefined) {
6
+ // Synthetic event (e.g., Chrome autofill). Ignore.
7
7
  return
8
8
  }
9
9
 
10
- pushToCurrentlyPressedKeys([mapKey(e.key), mapKey(e.code)])
10
+ pushToCurrentlyPressedKeys([mapKey(e.code)])
11
11
  })
12
12
 
13
13
  document.addEventListener('keyup', (e) => {
14
- if (e.key === undefined) {
15
- // Synthetic event (e.g., Chrome autofill). Ignore.
14
+ if (e.code === undefined) {
15
+ // Synthetic event (e.g., Chrome autofill). Ignore.
16
16
  return
17
17
  }
18
18
 
19
- removeFromCurrentlyPressedKeys([mapKey(e.key), mapKey(e.code)])
19
+ removeFromCurrentlyPressedKeys([mapKey(e.code)])
20
20
  })
21
21
  }
22
22
 
@@ -34,8 +34,8 @@ export function isReadonlyArray(value: unknown): value is readonly unknown[] {
34
34
  return Array.isArray(value)
35
35
  }
36
36
 
37
- export function isHotkeyPressed(key: string | readonly string[], splitKey = ','): boolean {
38
- const hotkeyArray = isReadonlyArray(key) ? key : key.split(splitKey)
37
+ export function isHotkeyPressed(key: string | readonly string[], delimiter = ','): boolean {
38
+ const hotkeyArray = isReadonlyArray(key) ? key : key.split(delimiter)
39
39
 
40
40
  return hotkeyArray.every((hotkey) => currentlyPressedKeys.has(hotkey.trim().toLowerCase()))
41
41
  }
@@ -1,17 +1,14 @@
1
1
  import { Hotkey, KeyboardModifiers } from './types'
2
2
 
3
- const reservedModifierKeywords = ['shift', 'alt', 'meta', 'mod', 'ctrl']
3
+ const reservedModifierKeywords = ['shift', 'alt', 'meta', 'mod', 'ctrl', 'control']
4
4
 
5
5
  const mappedKeys: Record<string, string> = {
6
6
  esc: 'escape',
7
7
  return: 'enter',
8
- '.': 'period',
9
- ',': 'comma',
10
- '-': 'slash',
11
- ' ': 'space',
12
- '`': 'backquote',
13
- '#': 'backslash',
14
- '+': 'bracketright',
8
+ left: 'arrowleft',
9
+ right: 'arrowright',
10
+ up: 'arrowup',
11
+ down: 'arrowdown',
15
12
  ShiftLeft: 'shift',
16
13
  ShiftRight: 'shift',
17
14
  AltLeft: 'alt',
@@ -25,24 +22,21 @@ const mappedKeys: Record<string, string> = {
25
22
  }
26
23
 
27
24
  export function mapKey(key: string): string {
28
- return (mappedKeys[key] || key)
29
- .trim()
30
- .toLowerCase()
31
- .replace(/key|digit|numpad|arrow/, '')
25
+ return (mappedKeys[key.trim()] || key.trim()).toLowerCase().replace(/key|digit|numpad/, '')
32
26
  }
33
27
 
34
28
  export function isHotkeyModifier(key: string) {
35
29
  return reservedModifierKeywords.includes(key)
36
30
  }
37
31
 
38
- export function parseKeysHookInput(keys: string, splitKey = ','): string[] {
39
- return keys.split(splitKey)
32
+ export function parseKeysHookInput(keys: string, delimiter = ','): string[] {
33
+ return keys.toLowerCase().split(delimiter)
40
34
  }
41
35
 
42
- export function parseHotkey(hotkey: string, combinationKey = '+', description?: string): Hotkey {
36
+ export function parseHotkey(hotkey: string, splitKey = '+', useKey = false, description?: string): Hotkey {
43
37
  const keys = hotkey
44
38
  .toLocaleLowerCase()
45
- .split(combinationKey)
39
+ .split(splitKey)
46
40
  .map((k) => mapKey(k))
47
41
 
48
42
  const modifiers: KeyboardModifiers = {
@@ -51,6 +45,7 @@ export function parseHotkey(hotkey: string, combinationKey = '+', description?:
51
45
  shift: keys.includes('shift'),
52
46
  meta: keys.includes('meta'),
53
47
  mod: keys.includes('mod'),
48
+ useKey,
54
49
  }
55
50
 
56
51
  const singleCharKeys = keys.filter((k) => !reservedModifierKeywords.includes(k))
package/src/types.ts CHANGED
@@ -12,6 +12,7 @@ export type KeyboardModifiers = {
12
12
  meta?: boolean
13
13
  shift?: boolean
14
14
  mod?: boolean
15
+ useKey?: boolean // Custom modifier to listen to the produced key instead of the code
15
16
  }
16
17
 
17
18
  export type Hotkey = KeyboardModifiers & {
@@ -27,19 +28,34 @@ export type HotkeyCallback = (keyboardEvent: KeyboardEvent, hotkeysEvent: Hotkey
27
28
  export type Trigger = boolean | ((keyboardEvent: KeyboardEvent, hotkeysEvent: HotkeysEvent) => boolean)
28
29
 
29
30
  export type Options = {
30
- enabled?: Trigger // Main setting that determines if the hotkey is enabled or not. (Default: true)
31
- enableOnFormTags?: readonly FormTags[] | boolean // Enable hotkeys on a list of tags. (Default: false)
32
- enableOnContentEditable?: boolean // Enable hotkeys on tags with contentEditable props. (Default: false)
33
- ignoreEventWhen?: (e: KeyboardEvent) => boolean // Ignore evenets based on a condition (Default: undefined)
34
- combinationKey?: string // Character to split keys in hotkeys combinations. (Default: +)
35
- splitKey?: string // Character to separate different hotkeys. (Default: ,)
36
- scopes?: Scopes // Scope
37
- keyup?: boolean // Trigger on keyup event? (Default: undefined)
38
- keydown?: boolean // Trigger on keydown event? (Default: true)
39
- preventDefault?: Trigger // Prevent default browser behavior? (Default: false)
40
- description?: string // Use this option to describe what the hotkey does. (Default: undefined)
41
- document?: Document // Listen to events on the document instead of the window. (Default: false)
42
- ignoreModifiers?: boolean // Ignore modifiers when matching hotkeys. (Default: false)
31
+ // Main setting that determines if the hotkey is enabled or not. (Default: true)
32
+ enabled?: Trigger
33
+ // Enable hotkeys on a list of tags. (Default: false)
34
+ enableOnFormTags?: readonly FormTags[] | boolean
35
+ // Enable hotkeys on tags with contentEditable props. (Default: false)
36
+ enableOnContentEditable?: boolean
37
+ // Ignore evenets based on a condition (Default: undefined)
38
+ ignoreEventWhen?: (e: KeyboardEvent) => boolean
39
+ // Character to split keys in hotkeys combinations. (Default: +)
40
+ splitKey?: string
41
+ // Character to separate different hotkeys. (Default: ,)
42
+ delimiter?: string
43
+ // Scope of the hotkey. (Default: undefined)
44
+ scopes?: Scopes
45
+ // Trigger on keyup event? (Default: undefined)
46
+ keyup?: boolean
47
+ // Trigger on keydown event? (Default: true)
48
+ keydown?: boolean
49
+ // Prevent default browser behavior? (Default: false)
50
+ preventDefault?: Trigger
51
+ // Use this option to describe what the hotkey does. (Default: undefined)
52
+ description?: string
53
+ // Listen to events on the document instead of the window. (Default: false)
54
+ document?: Document
55
+ // Ignore modifiers when matching hotkeys. (Default: false)
56
+ ignoreModifiers?: boolean
57
+ // Listen to the produced key instead of the code. (Default: false)
58
+ useKey?: boolean
43
59
  }
44
60
 
45
61
  export type OptionsOrDependencyArray = Options | DependencyList
package/src/useHotkeys.ts CHANGED
@@ -36,7 +36,7 @@ export default function useHotkeys<T extends HTMLElement>(
36
36
  : !(dependencies instanceof Array)
37
37
  ? (dependencies as Options)
38
38
  : undefined
39
- const _keys: string = isReadonlyArray(keys) ? keys.join(_options?.splitKey) : keys
39
+ const _keys: string = isReadonlyArray(keys) ? keys.join(_options?.delimiter) : keys
40
40
  const _deps: DependencyList | undefined =
41
41
  options instanceof Array ? options : dependencies instanceof Array ? dependencies : undefined
42
42
 
@@ -51,11 +51,11 @@ export default function useHotkeys<T extends HTMLElement>(
51
51
 
52
52
  const memoisedOptions = useDeepEqualMemo(_options)
53
53
 
54
- const { enabledScopes } = useHotkeysContext()
54
+ const { activeScopes } = useHotkeysContext()
55
55
  const proxy = useBoundHotkeysProxy()
56
56
 
57
57
  useSafeLayoutEffect(() => {
58
- if (memoisedOptions?.enabled === false || !isScopeActive(enabledScopes, memoisedOptions?.scopes)) {
58
+ if (memoisedOptions?.enabled === false || !isScopeActive(activeScopes, memoisedOptions?.scopes)) {
59
59
  return
60
60
  }
61
61
 
@@ -68,6 +68,7 @@ export default function useHotkeys<T extends HTMLElement>(
68
68
  // REF IS THE ACTIVE ELEMENT. THIS IS A PROBLEM SINCE FOCUSED SUB COMPONENTS WON'T TRIGGER THE HOTKEY.
69
69
  if (ref.current !== null) {
70
70
  const rootNode = ref.current.getRootNode()
71
+
71
72
  if (
72
73
  (rootNode instanceof Document || rootNode instanceof ShadowRoot) &&
73
74
  rootNode.activeElement !== ref.current &&
@@ -82,8 +83,8 @@ export default function useHotkeys<T extends HTMLElement>(
82
83
  return
83
84
  }
84
85
 
85
- parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) => {
86
- const hotkey = parseHotkey(key, memoisedOptions?.combinationKey)
86
+ parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) => {
87
+ const hotkey = parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey)
87
88
 
88
89
  if (isHotkeyMatchingKeyboardEvent(e, hotkey, memoisedOptions?.ignoreModifiers) || hotkey.keys?.includes('*')) {
89
90
  if (memoisedOptions?.ignoreEventWhen?.(e)) {
@@ -113,7 +114,7 @@ export default function useHotkeys<T extends HTMLElement>(
113
114
  }
114
115
 
115
116
  const handleKeyDown = (event: KeyboardEvent) => {
116
- if (event.key === undefined) {
117
+ if (event.code === undefined) {
117
118
  // Synthetic event (e.g., Chrome autofill). Ignore.
118
119
  return
119
120
  }
@@ -126,7 +127,7 @@ export default function useHotkeys<T extends HTMLElement>(
126
127
  }
127
128
 
128
129
  const handleKeyUp = (event: KeyboardEvent) => {
129
- if (event.key === undefined) {
130
+ if (event.code === undefined) {
130
131
  // Synthetic event (e.g., Chrome autofill). Ignore.
131
132
  return
132
133
  }
@@ -148,8 +149,10 @@ export default function useHotkeys<T extends HTMLElement>(
148
149
  domNode.addEventListener('keydown', handleKeyDown)
149
150
 
150
151
  if (proxy) {
151
- parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) =>
152
- proxy.addHotkey(parseHotkey(key, memoisedOptions?.combinationKey, memoisedOptions?.description))
152
+ parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) =>
153
+ proxy.addHotkey(
154
+ parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey, memoisedOptions?.description)
155
+ )
153
156
  )
154
157
  }
155
158
 
@@ -160,12 +163,14 @@ export default function useHotkeys<T extends HTMLElement>(
160
163
  domNode.removeEventListener('keydown', handleKeyDown)
161
164
 
162
165
  if (proxy) {
163
- parseKeysHookInput(_keys, memoisedOptions?.splitKey).forEach((key) =>
164
- proxy.removeHotkey(parseHotkey(key, memoisedOptions?.combinationKey, memoisedOptions?.description))
166
+ parseKeysHookInput(_keys, memoisedOptions?.delimiter).forEach((key) =>
167
+ proxy.removeHotkey(
168
+ parseHotkey(key, memoisedOptions?.splitKey, memoisedOptions?.useKey, memoisedOptions?.description)
169
+ )
165
170
  )
166
171
  }
167
172
  }
168
- }, [_keys, memoisedOptions, enabledScopes])
173
+ }, [_keys, memoisedOptions, activeScopes])
169
174
 
170
175
  return ref
171
176
  }
@@ -6,7 +6,7 @@ export default function useRecordHotkeys() {
6
6
  const [isRecording, setIsRecording] = useState(false)
7
7
 
8
8
  const handler = useCallback((event: KeyboardEvent) => {
9
- if (event.key === undefined) {
9
+ if (event.code === undefined) {
10
10
  // Synthetic event (e.g., Chrome autofill). Ignore.
11
11
  return
12
12
  }
package/src/validators.ts CHANGED
@@ -32,7 +32,7 @@ export function isHotkeyEnabledOnTag(
32
32
  )
33
33
  }
34
34
 
35
- return Boolean(targetTagName && enabledOnTags && enabledOnTags === true)
35
+ return Boolean(targetTagName && enabledOnTags && enabledOnTags)
36
36
  }
37
37
 
38
38
  export function isScopeActive(activeScopes: string[], scopes?: Scopes): boolean {
@@ -52,23 +52,29 @@ export function isScopeActive(activeScopes: string[], scopes?: Scopes): boolean
52
52
  }
53
53
 
54
54
  export const isHotkeyMatchingKeyboardEvent = (e: KeyboardEvent, hotkey: Hotkey, ignoreModifiers = false): boolean => {
55
- const { alt, meta, mod, shift, ctrl, keys } = hotkey
56
- const { key: pressedKeyUppercase, code, ctrlKey, metaKey, shiftKey, altKey } = e
55
+ const { alt, meta, mod, shift, ctrl, keys, useKey } = hotkey
56
+ const { code, key: producedKey, ctrlKey, metaKey, shiftKey, altKey } = e
57
57
 
58
- const keyCode = mapKey(code)
59
- const pressedKey = pressedKeyUppercase.toLowerCase()
58
+ const mappedCode = mapKey(code)
60
59
 
61
- if (!keys?.includes(keyCode) && !keys?.includes(pressedKey) && !['ctrl', 'control', 'unknown', 'meta', 'alt', 'shift', 'os'].includes(keyCode)) {
60
+ if (useKey && keys?.length === 1 && keys.includes(producedKey)) {
61
+ return true
62
+ }
63
+
64
+ if (
65
+ !keys?.includes(mappedCode) &&
66
+ !['ctrl', 'control', 'unknown', 'meta', 'alt', 'shift', 'os'].includes(mappedCode)
67
+ ) {
62
68
  return false
63
69
  }
64
70
 
65
71
  if (!ignoreModifiers) {
66
72
  // We check the pressed keys for compatibility with the keyup event. In keyup events the modifier flags are not set.
67
- if (alt === !altKey && pressedKey !== 'alt') {
73
+ if (alt !== altKey && mappedCode !== 'alt') {
68
74
  return false
69
75
  }
70
76
 
71
- if (shift === !shiftKey && pressedKey !== 'shift') {
77
+ if (shift !== shiftKey && mappedCode !== 'shift') {
72
78
  return false
73
79
  }
74
80
 
@@ -78,11 +84,11 @@ export const isHotkeyMatchingKeyboardEvent = (e: KeyboardEvent, hotkey: Hotkey,
78
84
  return false
79
85
  }
80
86
  } else {
81
- if (meta === !metaKey && pressedKey !== 'meta' && pressedKey !== 'os') {
87
+ if (meta !== metaKey && mappedCode !== 'meta' && mappedCode !== 'os') {
82
88
  return false
83
89
  }
84
90
 
85
- if (ctrl === !ctrlKey && pressedKey !== 'ctrl' && pressedKey !== 'control') {
91
+ if (ctrl !== ctrlKey && mappedCode !== 'ctrl' && mappedCode !== 'control') {
86
92
  return false
87
93
  }
88
94
  }
@@ -90,7 +96,7 @@ export const isHotkeyMatchingKeyboardEvent = (e: KeyboardEvent, hotkey: Hotkey,
90
96
 
91
97
  // All modifiers are correct, now check the key
92
98
  // If the key is set, we check for the key
93
- if (keys && keys.length === 1 && (keys.includes(pressedKey) || keys.includes(keyCode))) {
99
+ if (keys && keys.length === 1 && keys.includes(mappedCode)) {
94
100
  return true
95
101
  } else if (keys) {
96
102
  // Check if all keys are present in pressedDownKeys set