@tanstack/octane-hotkeys 0.9.0 → 0.9.2

package/dist/useHotkeyRecorder.js

@@ -9,18 +9,23 @@ function useHotkeyRecorder(options, slot) {
 	const defaults = useDefaultHotkeysOptions();
 	const merged = withDefaults(defaults.hotkeyRecorder, options);
 	const ref = useRef(null, subSlot(slot, "recorder"));
-	ref.current ??= new HotkeyRecorder(merged);
-	const recorder = ref.current;
+	if (!ref.current) {
+		const recorder = new HotkeyRecorder(merged);
+		ref.current = [recorder, {
+			startRecording: () => recorder.start(),
+			stopRecording: () => recorder.stop(),
+			cancelRecording: () => recorder.cancel(),
+			commitRecording: () => recorder.commit()
+		}];
+	}
+	const [recorder, actions] = ref.current;
 	useLayoutEffect(() => {
 		recorder.setOptions(merged);
 	}, null, subSlot(slot, "options"));
 	useLayoutEffect(() => () => recorder.destroy(), [], subSlot(slot, "cleanup"));
 	return {
 		...select(recorder.store, (value) => value, subSlot(slot, "state")),
-		startRecording: () => recorder.start(),
-		stopRecording: () => recorder.stop(),
-		cancelRecording: () => recorder.cancel(),
-		commitRecording: () => recorder.commit()
+		...actions
 	};
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/octane-hotkeys",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Octane adapter for TanStack Hotkeys",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "skills"
   ],
   "dependencies": {
-    "@tanstack/hotkeys": "0.21.0"
+    "@tanstack/hotkeys": "0.22.1"
   },
   "devDependencies": {
     "@tsrx/oxc": "0.20.0",

package/skills/octane-hotkeys/SKILL.md

@@ -75,6 +75,7 @@ No provider is required. Use Octane 0.12 or newer, with hooks in compiler-enable
 - **Targets are elements, not ref objects.** Keep the element in state with a callback ref, as above; a `null` target waits for the element.
 - **Register a dialog's hotkeys in a child of its provider.** A hook uses the nearest `HotkeysProvider` above its component, so a dialog that renders `<HotkeysProvider scope={...} exclusive>` and registers `Escape` itself puts it in the suspended outer scope. Give each open dialog its own scope name, such as `` `dialog-${useId()}` ``.
 - **Hooks are tracked by call site.** Use `useHotkeys(items.map(...))` for lists, not `useHotkey` in a loop.
+- **Custom hooks in plain `.ts` and `.js` files need the compiler.** Calls from a `.ts` or `.js` file that the compiler skips share one slot per hook in each component, even across different custom hooks, so only the last `useHotkey` call works. The compiler handles a file that imports a value from `octane` or starts with `/** @jsxImportSource octane */`. A type-only import doesn't count. `.tsrx` and `.tsx` files are fine.
 - **Call the hooks directly.** A `useShortcut(keys: string)` wrapper has to cast strings to hotkeys, which turns off type checking and drops sequences, options, and app hotkeys.
 
 When declaring app hotkeys, building a cheat sheet, or letting users rebind shortcuts, load `@tanstack/hotkeys#app-hotkeys` and read [app hotkeys in Octane](references/app-hotkeys.md).