@tanstack/react-hotkeys 0.18.0 → 0.19.0

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,8 +1,8 @@
1
1
  'use client';
2
2
 
3
- import { AppHotkeysStore, publishAppHotkeysStore } from "@tanstack/hotkeys";
3
+ import { publishAppHotkeysStore } from "@tanstack/hotkeys";
4
4
  import React, { createContext, useContext, useEffect, useMemo, useState } from "react";
5
- import { activateHotkeysProviderScope, getHotkeysProviderScopeKey, mergeHotkeysProviderDefaults } from "@tanstack/hotkeys/adapter";
5
+ import { activateHotkeysProviderScope, createAppHotkeysStore, getHotkeysProviderScopeKey, mergeHotkeysProviderDefaults } from "@tanstack/hotkeys/adapter";
6
6
 
7
7
  //#region src/HotkeysProvider.tsx
8
8
  const HotkeysContext = createContext(null);
@@ -45,7 +45,7 @@ const NO_PARENT = {
45
45
  */
46
46
  function HotkeysProvider({ children, appHotkeys, customHotkeys, onCustomHotkeysChange, defaultOptions = DEFAULT_OPTIONS, scope, exclusive = false, enabled = true }) {
47
47
  const parent = useContext(HotkeysContext) ?? NO_PARENT;
48
- const [store] = useState(() => appHotkeys ? new AppHotkeysStore(appHotkeys, {
48
+ const [store] = useState(() => appHotkeys ? createAppHotkeysStore(appHotkeys, {
49
49
  customHotkeys,
50
50
  onCustomHotkeysChange
51
51
  }) : null);
@@ -1,10 +1,11 @@
1
1
  'use client';
2
2
 
3
3
  import { useHotkeysContext } from "./HotkeysProvider.js";
4
- import { Store, useSelector } from "@tanstack/react-store";
4
+ import { useSelector } from "./_useSelector.js";
5
+ import { createStore } from "@tanstack/hotkeys/adapter";
5
6
 
6
7
  //#region src/_appHotkeysStore.ts
7
- const NO_APP_HOTKEYS = new Store(null);
8
+ const NO_APP_HOTKEYS = createStore(null);
8
9
  /**
9
10
  * The provider's app hotkeys store, re-rendering when app hotkeys or custom
10
11
  * hotkeys change. Null outside a provider with `appHotkeys`.
@@ -0,0 +1,29 @@
1
+ 'use client';
2
+
3
+ import { useCallback, useRef, useSyncExternalStore } from "react";
4
+
5
+ //#region src/_useSelector.ts
6
+ /**
7
+ * Subscribes to a store and returns the selected value, re-rendering when it
8
+ * changes (by `Object.is`). The selector runs again only when the store's
9
+ * state or the selector itself changes.
10
+ */
11
+ function useSelector(store, selector) {
12
+ const subscribe = useCallback((onChange) => store.subscribe(onChange).unsubscribe, [store]);
13
+ const memo = useRef(null);
14
+ const getSelection = () => {
15
+ const state = store.get();
16
+ const last = memo.current;
17
+ if (last && last.selector === selector && Object.is(last.state, state)) return last.selected;
18
+ memo.current = {
19
+ state,
20
+ selector,
21
+ selected: selector(state)
22
+ };
23
+ return memo.current.selected;
24
+ };
25
+ return useSyncExternalStore(subscribe, getSelection, getSelection);
26
+ }
27
+
28
+ //#endregion
29
+ export { useSelector };
@@ -1,7 +1,7 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { getKeyStateTracker } from "@tanstack/hotkeys";
4
- import { useSelector } from "@tanstack/react-store";
5
5
 
6
6
  //#region src/useHeldKeyCodes.ts
7
7
  /**
@@ -2,8 +2,7 @@
2
2
  /**
3
3
  * React hook that returns an array of currently held keyboard keys.
4
4
  *
5
- * This hook uses `useSelector` from `@tanstack/react-store` to subscribe
6
- * to the global KeyStateTracker and updates whenever keys are pressed
5
+ * This hook subscribes to the global KeyStateTracker and updates whenever keys are pressed
7
6
  * or released.
8
7
  *
9
8
  * @returns Array of currently held key names
@@ -1,14 +1,13 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { getKeyStateTracker } from "@tanstack/hotkeys";
4
- import { useSelector } from "@tanstack/react-store";
5
5
 
6
6
  //#region src/useHeldKeys.ts
7
7
  /**
8
8
  * React hook that returns an array of currently held keyboard keys.
9
9
  *
10
- * This hook uses `useSelector` from `@tanstack/react-store` to subscribe
11
- * to the global KeyStateTracker and updates whenever keys are pressed
10
+ * This hook subscribes to the global KeyStateTracker and updates whenever keys are pressed
12
11
  * or released.
13
12
  *
14
13
  * @returns Array of currently held key names
@@ -1,8 +1,8 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { useAppHotkeysStoreState } from "./_appHotkeysStore.js";
4
5
  import { getHotkeyManager, getKeyStateTracker, isAppHotkey, matchesHeldModifiers, resolveAppHotkey } from "@tanstack/hotkeys";
5
- import { useSelector } from "@tanstack/react-store";
6
6
 
7
7
  //#region src/useHotkeyHint.ts
8
8
  /**
@@ -1,9 +1,9 @@
1
1
  'use client';
2
2
 
3
3
  import { useDefaultHotkeysOptions } from "./HotkeysProvider.js";
4
+ import { useSelector } from "./_useSelector.js";
4
5
  import { HotkeyRecorder } from "@tanstack/hotkeys";
5
6
  import { useEffect, useRef } from "react";
6
- import { useSelector } from "@tanstack/react-store";
7
7
 
8
8
  //#region src/useHotkeyRecorder.ts
9
9
  function useHotkeyRecorder(options) {
@@ -1,7 +1,7 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { getHotkeyManager, toHotkeyRegistrationView } from "@tanstack/hotkeys";
4
- import { useSelector } from "@tanstack/react-store";
5
5
 
6
6
  //#region src/useHotkeyRegistrations.ts
7
7
  /**
@@ -1,7 +1,7 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { getHotkeyManager } from "@tanstack/hotkeys";
4
- import { useSelector } from "@tanstack/react-store";
5
5
 
6
6
  //#region src/useHotkeyScopesState.ts
7
7
  /**
@@ -3,8 +3,7 @@ import { IndividualKey } from "@tanstack/hotkeys";
3
3
  /**
4
4
  * React hook that returns whether a specific key is currently being held.
5
5
  *
6
- * This hook uses `useSelector` from `@tanstack/react-store` to subscribe
7
- * to the global KeyStateTracker and uses a selector to determine if
6
+ * This hook subscribes to the global KeyStateTracker and uses a selector to determine if
8
7
  * the specified key is held.
9
8
  *
10
9
  * @param key - The key to check (e.g., 'Shift', 'Control', 'A')
@@ -1,14 +1,13 @@
1
1
  'use client';
2
2
 
3
+ import { useSelector } from "./_useSelector.js";
3
4
  import { getKeyStateTracker } from "@tanstack/hotkeys";
4
- import { useSelector } from "@tanstack/react-store";
5
5
 
6
6
  //#region src/useKeyHold.ts
7
7
  /**
8
8
  * React hook that returns whether a specific key is currently being held.
9
9
  *
10
- * This hook uses `useSelector` from `@tanstack/react-store` to subscribe
11
- * to the global KeyStateTracker and uses a selector to determine if
10
+ * This hook subscribes to the global KeyStateTracker and uses a selector to determine if
12
11
  * the specified key is held.
13
12
  *
14
13
  * @param key - The key to check (e.g., 'Shift', 'Control', 'A')
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tanstack/react-hotkeys",
3
- "version": "0.18.0",
3
+ "version": "0.19.0",
4
4
  "description": "React adapter for TanStack Hotkeys",
5
5
  "author": "Tanner Linsley",
6
6
  "license": "MIT",
@@ -35,11 +35,11 @@
35
35
  "skills"
36
36
  ],
37
37
  "dependencies": {
38
- "@tanstack/hotkeys": "0.19.0",
39
- "@tanstack/react-store": "^0.11.2"
38
+ "@tanstack/hotkeys": "0.20.0"
40
39
  },
41
40
  "devDependencies": {
42
41
  "@eslint-react/eslint-plugin": "^4.2.3",
42
+ "@tanstack/react-store": "^0.11.2",
43
43
  "@testing-library/react": "^16.3.3",
44
44
  "@types/react": "^19.3.0",
45
45
  "@vitejs/plugin-react": "^6.1.1",