@tanstack/hotkeys 0.0.1 → 0.1.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.
Files changed (74) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +121 -45
  3. package/dist/constants.cjs +444 -0
  4. package/dist/constants.cjs.map +1 -0
  5. package/dist/constants.d.cts +226 -0
  6. package/dist/constants.d.ts +226 -0
  7. package/dist/constants.js +428 -0
  8. package/dist/constants.js.map +1 -0
  9. package/dist/format.cjs +178 -0
  10. package/dist/format.cjs.map +1 -0
  11. package/dist/format.d.cts +110 -0
  12. package/dist/format.d.ts +110 -0
  13. package/dist/format.js +175 -0
  14. package/dist/format.js.map +1 -0
  15. package/dist/hotkey-manager.cjs +420 -0
  16. package/dist/hotkey-manager.cjs.map +1 -0
  17. package/dist/hotkey-manager.d.cts +207 -0
  18. package/dist/hotkey-manager.d.ts +207 -0
  19. package/dist/hotkey-manager.js +419 -0
  20. package/dist/hotkey-manager.js.map +1 -0
  21. package/dist/hotkey.d.cts +278 -0
  22. package/dist/hotkey.d.ts +278 -0
  23. package/dist/index.cjs +54 -0
  24. package/dist/index.d.cts +11 -0
  25. package/dist/index.d.ts +11 -0
  26. package/dist/index.js +11 -0
  27. package/dist/key-state-tracker.cjs +197 -0
  28. package/dist/key-state-tracker.cjs.map +1 -0
  29. package/dist/key-state-tracker.d.cts +107 -0
  30. package/dist/key-state-tracker.d.ts +107 -0
  31. package/dist/key-state-tracker.js +196 -0
  32. package/dist/key-state-tracker.js.map +1 -0
  33. package/dist/match.cjs +143 -0
  34. package/dist/match.cjs.map +1 -0
  35. package/dist/match.d.cts +79 -0
  36. package/dist/match.d.ts +79 -0
  37. package/dist/match.js +141 -0
  38. package/dist/match.js.map +1 -0
  39. package/dist/parse.cjs +266 -0
  40. package/dist/parse.cjs.map +1 -0
  41. package/dist/parse.d.cts +169 -0
  42. package/dist/parse.d.ts +169 -0
  43. package/dist/parse.js +258 -0
  44. package/dist/parse.js.map +1 -0
  45. package/dist/recorder.cjs +177 -0
  46. package/dist/recorder.cjs.map +1 -0
  47. package/dist/recorder.d.cts +108 -0
  48. package/dist/recorder.d.ts +108 -0
  49. package/dist/recorder.js +177 -0
  50. package/dist/recorder.js.map +1 -0
  51. package/dist/sequence.cjs +242 -0
  52. package/dist/sequence.cjs.map +1 -0
  53. package/dist/sequence.d.cts +109 -0
  54. package/dist/sequence.d.ts +109 -0
  55. package/dist/sequence.js +240 -0
  56. package/dist/sequence.js.map +1 -0
  57. package/dist/validate.cjs +116 -0
  58. package/dist/validate.cjs.map +1 -0
  59. package/dist/validate.d.cts +56 -0
  60. package/dist/validate.d.ts +56 -0
  61. package/dist/validate.js +114 -0
  62. package/dist/validate.js.map +1 -0
  63. package/package.json +55 -7
  64. package/src/constants.ts +514 -0
  65. package/src/format.ts +261 -0
  66. package/src/hotkey-manager.ts +822 -0
  67. package/src/hotkey.ts +411 -0
  68. package/src/index.ts +10 -0
  69. package/src/key-state-tracker.ts +249 -0
  70. package/src/match.ts +222 -0
  71. package/src/parse.ts +368 -0
  72. package/src/recorder.ts +266 -0
  73. package/src/sequence.ts +391 -0
  74. package/src/validate.ts +171 -0
@@ -0,0 +1,419 @@
1
+ import { detectPlatform, normalizeKeyName } from "./constants.js";
2
+ import { parseHotkey, rawHotkeyToParsedHotkey } from "./parse.js";
3
+ import { formatHotkey } from "./format.js";
4
+ import { matchesKeyboardEvent } from "./match.js";
5
+ import { Store } from "@tanstack/store";
6
+
7
+ //#region src/hotkey-manager.ts
8
+ /**
9
+ * Default options for hotkey registration.
10
+ */
11
+ const defaultHotkeyOptions = {
12
+ preventDefault: true,
13
+ stopPropagation: true,
14
+ eventType: "keydown",
15
+ requireReset: false,
16
+ enabled: true,
17
+ ignoreInputs: true,
18
+ conflictBehavior: "warn"
19
+ };
20
+ let registrationIdCounter = 0;
21
+ /**
22
+ * Generates a unique ID for hotkey registrations.
23
+ */
24
+ function generateId() {
25
+ return `hotkey_${++registrationIdCounter}`;
26
+ }
27
+ /**
28
+ * Computes the default ignoreInputs value based on the hotkey.
29
+ * Ctrl/Meta shortcuts and Escape fire in inputs; single keys and Shift/Alt combos are ignored.
30
+ */
31
+ function getDefaultIgnoreInputs(parsedHotkey) {
32
+ if (parsedHotkey.ctrl || parsedHotkey.meta) return false;
33
+ if (parsedHotkey.key === "Escape") return false;
34
+ return true;
35
+ }
36
+ /**
37
+ * Singleton manager for hotkey registrations.
38
+ *
39
+ * This class provides a centralized way to register and manage keyboard hotkeys.
40
+ * It uses a single event listener for efficiency, regardless of how many hotkeys
41
+ * are registered.
42
+ *
43
+ * @example
44
+ * ```ts
45
+ * const manager = HotkeyManager.getInstance()
46
+ *
47
+ * const unregister = manager.register('Mod+S', (event, context) => {
48
+ * console.log('Save triggered!')
49
+ * })
50
+ *
51
+ * // Later, to unregister:
52
+ * unregister()
53
+ * ```
54
+ */
55
+ var HotkeyManager = class HotkeyManager {
56
+ static #instance = null;
57
+ #platform;
58
+ #targetListeners = /* @__PURE__ */ new Map();
59
+ #targetRegistrations = /* @__PURE__ */ new Map();
60
+ constructor() {
61
+ this.registrations = new Store(/* @__PURE__ */ new Map());
62
+ this.#platform = detectPlatform();
63
+ }
64
+ /**
65
+ * Gets the singleton instance of HotkeyManager.
66
+ */
67
+ static getInstance() {
68
+ if (!HotkeyManager.#instance) HotkeyManager.#instance = new HotkeyManager();
69
+ return HotkeyManager.#instance;
70
+ }
71
+ /**
72
+ * Resets the singleton instance. Useful for testing.
73
+ */
74
+ static resetInstance() {
75
+ if (HotkeyManager.#instance) {
76
+ HotkeyManager.#instance.destroy();
77
+ HotkeyManager.#instance = null;
78
+ }
79
+ }
80
+ /**
81
+ * Registers a hotkey handler and returns a handle for updating the registration.
82
+ *
83
+ * The returned handle allows updating the callback and options without
84
+ * re-registering, which is useful for avoiding stale closures in React.
85
+ *
86
+ * @param hotkey - The hotkey string (e.g., 'Mod+S') or RawHotkey object
87
+ * @param callback - The function to call when the hotkey is pressed
88
+ * @param options - Options for the hotkey behavior
89
+ * @returns A handle for managing the registration
90
+ *
91
+ * @example
92
+ * ```ts
93
+ * const handle = manager.register('Mod+S', callback)
94
+ *
95
+ * // Update callback without re-registering (avoids stale closures)
96
+ * handle.callback = newCallback
97
+ *
98
+ * // Update options
99
+ * handle.setOptions({ enabled: false })
100
+ *
101
+ * // Unregister when done
102
+ * handle.unregister()
103
+ * ```
104
+ */
105
+ register(hotkey, callback, options = {}) {
106
+ const id = generateId();
107
+ const platform = options.platform ?? this.#platform;
108
+ const parsedHotkey = typeof hotkey === "string" ? parseHotkey(hotkey, platform) : rawHotkeyToParsedHotkey(hotkey, platform);
109
+ const hotkeyStr = typeof hotkey === "string" ? hotkey : formatHotkey(parsedHotkey);
110
+ const target = options.target ?? (typeof document !== "undefined" ? document : {});
111
+ const conflictBehavior = options.conflictBehavior ?? "warn";
112
+ const conflictingRegistration = this.#findConflictingRegistration(hotkeyStr, target);
113
+ if (conflictingRegistration) this.#handleConflict(conflictingRegistration, hotkeyStr, conflictBehavior);
114
+ const resolvedIgnoreInputs = options.ignoreInputs ?? getDefaultIgnoreInputs(parsedHotkey);
115
+ const registration = {
116
+ id,
117
+ hotkey: hotkeyStr,
118
+ parsedHotkey,
119
+ callback,
120
+ options: {
121
+ ...defaultHotkeyOptions,
122
+ ...options,
123
+ platform,
124
+ ignoreInputs: resolvedIgnoreInputs
125
+ },
126
+ hasFired: false,
127
+ triggerCount: 0,
128
+ target
129
+ };
130
+ this.registrations.setState((prev) => new Map(prev).set(id, registration));
131
+ if (!this.#targetRegistrations.has(target)) this.#targetRegistrations.set(target, /* @__PURE__ */ new Set());
132
+ this.#targetRegistrations.get(target).add(id);
133
+ this.#ensureListenersForTarget(target);
134
+ const manager = this;
135
+ return {
136
+ get id() {
137
+ return id;
138
+ },
139
+ unregister: () => {
140
+ manager.#unregister(id);
141
+ },
142
+ get callback() {
143
+ return manager.registrations.state.get(id)?.callback ?? callback;
144
+ },
145
+ set callback(newCallback) {
146
+ const reg = manager.registrations.state.get(id);
147
+ if (reg) reg.callback = newCallback;
148
+ },
149
+ setOptions: (newOptions) => {
150
+ manager.registrations.setState((prev) => {
151
+ const reg = prev.get(id);
152
+ if (reg) {
153
+ const next = new Map(prev);
154
+ next.set(id, {
155
+ ...reg,
156
+ options: {
157
+ ...reg.options,
158
+ ...newOptions
159
+ }
160
+ });
161
+ return next;
162
+ }
163
+ return prev;
164
+ });
165
+ },
166
+ get isActive() {
167
+ return manager.registrations.state.has(id);
168
+ }
169
+ };
170
+ }
171
+ /**
172
+ * Unregisters a hotkey by its registration ID.
173
+ */
174
+ #unregister(id) {
175
+ const registration = this.registrations.state.get(id);
176
+ if (!registration) return;
177
+ const target = registration.target;
178
+ this.registrations.setState((prev) => {
179
+ const next = new Map(prev);
180
+ next.delete(id);
181
+ return next;
182
+ });
183
+ const targetRegs = this.#targetRegistrations.get(target);
184
+ if (targetRegs) {
185
+ targetRegs.delete(id);
186
+ if (targetRegs.size === 0) this.#removeListenersForTarget(target);
187
+ }
188
+ }
189
+ /**
190
+ * Ensures event listeners are attached for a specific target.
191
+ */
192
+ #ensureListenersForTarget(target) {
193
+ if (typeof document === "undefined") return;
194
+ if (this.#targetListeners.has(target)) return;
195
+ const keydownHandler = this.#createTargetKeyDownHandler(target);
196
+ const keyupHandler = this.#createTargetKeyUpHandler(target);
197
+ target.addEventListener("keydown", keydownHandler);
198
+ target.addEventListener("keyup", keyupHandler);
199
+ this.#targetListeners.set(target, {
200
+ keydown: keydownHandler,
201
+ keyup: keyupHandler
202
+ });
203
+ }
204
+ /**
205
+ * Removes event listeners for a specific target.
206
+ */
207
+ #removeListenersForTarget(target) {
208
+ if (typeof document === "undefined") return;
209
+ const listeners = this.#targetListeners.get(target);
210
+ if (!listeners) return;
211
+ target.removeEventListener("keydown", listeners.keydown);
212
+ target.removeEventListener("keyup", listeners.keyup);
213
+ this.#targetListeners.delete(target);
214
+ this.#targetRegistrations.delete(target);
215
+ }
216
+ /**
217
+ * Processes keyboard events for a specific target and event type.
218
+ */
219
+ #processTargetEvent(event, target, eventType) {
220
+ const targetRegs = this.#targetRegistrations.get(target);
221
+ if (!targetRegs) return;
222
+ for (const id of targetRegs) {
223
+ const registration = this.registrations.state.get(id);
224
+ if (!registration) continue;
225
+ if (!this.#isEventForTarget(event, target)) continue;
226
+ if (!registration.options.enabled) continue;
227
+ if (registration.options.ignoreInputs !== false) {
228
+ if (this.#isInputElement(event.target)) {
229
+ if (event.target !== registration.target) continue;
230
+ }
231
+ }
232
+ if (eventType === "keydown") {
233
+ if (registration.options.eventType !== "keydown") continue;
234
+ if (matchesKeyboardEvent(event, registration.parsedHotkey, registration.options.platform)) {
235
+ if (registration.options.preventDefault) event.preventDefault();
236
+ if (registration.options.stopPropagation) event.stopPropagation();
237
+ if (!registration.options.requireReset || !registration.hasFired) {
238
+ this.#executeHotkeyCallback(registration, event);
239
+ if (registration.options.requireReset) registration.hasFired = true;
240
+ }
241
+ }
242
+ } else {
243
+ if (registration.options.eventType === "keyup") {
244
+ if (matchesKeyboardEvent(event, registration.parsedHotkey, registration.options.platform)) this.#executeHotkeyCallback(registration, event);
245
+ }
246
+ if (registration.options.requireReset && registration.hasFired) {
247
+ if (this.#shouldResetRegistration(registration, event)) registration.hasFired = false;
248
+ }
249
+ }
250
+ }
251
+ }
252
+ /**
253
+ * Executes a hotkey callback with proper event handling.
254
+ */
255
+ #executeHotkeyCallback(registration, event) {
256
+ if (registration.options.preventDefault) event.preventDefault();
257
+ if (registration.options.stopPropagation) event.stopPropagation();
258
+ registration.triggerCount++;
259
+ this.registrations.setState((prev) => new Map(prev));
260
+ const context = {
261
+ hotkey: registration.hotkey,
262
+ parsedHotkey: registration.parsedHotkey
263
+ };
264
+ registration.callback(event, context);
265
+ }
266
+ /**
267
+ * Creates a keydown handler for a specific target.
268
+ */
269
+ #createTargetKeyDownHandler(target) {
270
+ return (event) => {
271
+ this.#processTargetEvent(event, target, "keydown");
272
+ };
273
+ }
274
+ /**
275
+ * Creates a keyup handler for a specific target.
276
+ */
277
+ #createTargetKeyUpHandler(target) {
278
+ return (event) => {
279
+ this.#processTargetEvent(event, target, "keyup");
280
+ };
281
+ }
282
+ /**
283
+ * Checks if an event is for the given target (originated from or bubbled to it).
284
+ */
285
+ #isEventForTarget(event, target) {
286
+ if (target === document || target === window) return event.currentTarget === target;
287
+ if (target instanceof HTMLElement) {
288
+ if (event.currentTarget === target) return true;
289
+ if (event.target instanceof Node && target.contains(event.target)) return true;
290
+ }
291
+ return false;
292
+ }
293
+ /**
294
+ * Finds an existing registration with the same hotkey and target.
295
+ */
296
+ #findConflictingRegistration(hotkey, target) {
297
+ for (const registration of this.registrations.state.values()) if (registration.hotkey === hotkey && registration.target === target) return registration;
298
+ return null;
299
+ }
300
+ /**
301
+ * Handles conflicts between hotkey registrations based on conflict behavior.
302
+ */
303
+ #handleConflict(conflictingRegistration, hotkey, conflictBehavior) {
304
+ if (conflictBehavior === "allow") return;
305
+ if (conflictBehavior === "warn") {
306
+ console.warn(`Hotkey '${hotkey}' is already registered. Multiple handlers will be triggered. Use conflictBehavior: 'replace' to replace the existing handler, or conflictBehavior: 'allow' to suppress this warning.`);
307
+ return;
308
+ }
309
+ if (conflictBehavior === "error") throw new Error(`Hotkey '${hotkey}' is already registered. Use conflictBehavior: 'replace' to replace the existing handler, or conflictBehavior: 'allow' to allow multiple registrations.`);
310
+ this.#unregister(conflictingRegistration.id);
311
+ }
312
+ /**
313
+ * Checks if an element is an input-like element that should be ignored.
314
+ *
315
+ * This includes:
316
+ * - HTMLInputElement (all input types except button, submit, reset)
317
+ * - HTMLTextAreaElement
318
+ * - HTMLSelectElement
319
+ * - Elements with contentEditable enabled
320
+ *
321
+ * Button-type inputs (button, submit, reset) are excluded so hotkeys like
322
+ * Mod+S and Escape fire when the user has tabbed to a form button.
323
+ */
324
+ #isInputElement(element) {
325
+ if (!element) return false;
326
+ if (element instanceof HTMLInputElement) {
327
+ const type = element.type.toLowerCase();
328
+ if (type === "button" || type === "submit" || type === "reset") return false;
329
+ return true;
330
+ }
331
+ if (element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement) return true;
332
+ if (element instanceof HTMLElement) {
333
+ const contentEditable = element.contentEditable;
334
+ if (contentEditable === "true" || contentEditable === "") return true;
335
+ }
336
+ return false;
337
+ }
338
+ /**
339
+ * Determines if a registration should be reset based on the keyup event.
340
+ */
341
+ #shouldResetRegistration(registration, event) {
342
+ const parsed = registration.parsedHotkey;
343
+ const releasedKey = normalizeKeyName(event.key);
344
+ const parsedKeyNormalized = parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key;
345
+ if ((releasedKey.length === 1 ? releasedKey.toUpperCase() : releasedKey) === parsedKeyNormalized) return true;
346
+ if (parsed.ctrl && releasedKey === "Control") return true;
347
+ if (parsed.shift && releasedKey === "Shift") return true;
348
+ if (parsed.alt && releasedKey === "Alt") return true;
349
+ if (parsed.meta && releasedKey === "Meta") return true;
350
+ return false;
351
+ }
352
+ /**
353
+ * Triggers a registration's callback programmatically from devtools.
354
+ * Creates a synthetic KeyboardEvent and invokes the callback.
355
+ *
356
+ * @param id - The registration ID to trigger
357
+ * @returns True if the registration was found and triggered
358
+ */
359
+ triggerRegistration(id) {
360
+ const registration = this.registrations.state.get(id);
361
+ if (!registration) return false;
362
+ const parsed = registration.parsedHotkey;
363
+ const syntheticEvent = new KeyboardEvent(registration.options.eventType ?? "keydown", {
364
+ key: parsed.key,
365
+ ctrlKey: parsed.ctrl,
366
+ shiftKey: parsed.shift,
367
+ altKey: parsed.alt,
368
+ metaKey: parsed.meta,
369
+ bubbles: true,
370
+ cancelable: true
371
+ });
372
+ registration.triggerCount++;
373
+ this.registrations.setState((prev) => new Map(prev));
374
+ registration.callback(syntheticEvent, {
375
+ hotkey: registration.hotkey,
376
+ parsedHotkey: registration.parsedHotkey
377
+ });
378
+ return true;
379
+ }
380
+ /**
381
+ * Gets the number of registered hotkeys.
382
+ */
383
+ getRegistrationCount() {
384
+ return this.registrations.state.size;
385
+ }
386
+ /**
387
+ * Checks if a specific hotkey is registered.
388
+ *
389
+ * @param hotkey - The hotkey string to check
390
+ * @param target - Optional target element to match (if provided, both hotkey and target must match)
391
+ * @returns True if a matching registration exists
392
+ */
393
+ isRegistered(hotkey, target) {
394
+ for (const registration of this.registrations.state.values()) if (registration.hotkey === hotkey) {
395
+ if (target === void 0 || registration.target === target) return true;
396
+ }
397
+ return false;
398
+ }
399
+ /**
400
+ * Destroys the manager and removes all listeners.
401
+ */
402
+ destroy() {
403
+ for (const target of this.#targetListeners.keys()) this.#removeListenersForTarget(target);
404
+ this.registrations.setState(() => /* @__PURE__ */ new Map());
405
+ this.#targetListeners.clear();
406
+ this.#targetRegistrations.clear();
407
+ }
408
+ };
409
+ /**
410
+ * Gets the singleton HotkeyManager instance.
411
+ * Convenience function for accessing the manager.
412
+ */
413
+ function getHotkeyManager() {
414
+ return HotkeyManager.getInstance();
415
+ }
416
+
417
+ //#endregion
418
+ export { HotkeyManager, getHotkeyManager };
419
+ //# sourceMappingURL=hotkey-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hotkey-manager.js","names":["#instance","#platform","#findConflictingRegistration","#handleConflict","#targetRegistrations","#ensureListenersForTarget","#unregister","#removeListenersForTarget","#targetListeners","#createTargetKeyDownHandler","#createTargetKeyUpHandler","#isEventForTarget","#isInputElement","#executeHotkeyCallback","#shouldResetRegistration","#processTargetEvent"],"sources":["../src/hotkey-manager.ts"],"sourcesContent":["import { Store } from '@tanstack/store'\nimport { detectPlatform, normalizeKeyName } from './constants'\nimport { formatHotkey } from './format'\nimport { parseHotkey, rawHotkeyToParsedHotkey } from './parse'\nimport { matchesKeyboardEvent } from './match'\nimport type {\n Hotkey,\n HotkeyCallback,\n HotkeyCallbackContext,\n ParsedHotkey,\n RegisterableHotkey,\n} from './hotkey'\n\n/**\n * Behavior when registering a hotkey that conflicts with an existing registration.\n *\n * - `'warn'` - Log a warning to the console but allow both registrations (default)\n * - `'error'` - Throw an error and prevent the new registration\n * - `'replace'` - Unregister the existing hotkey and register the new one\n * - `'allow'` - Allow multiple registrations of the same hotkey without warning\n */\nexport type ConflictBehavior = 'warn' | 'error' | 'replace' | 'allow'\n\n/**\n * Options for registering a hotkey.\n */\nexport interface HotkeyOptions {\n /** Behavior when this hotkey conflicts with an existing registration on the same target. Defaults to 'warn' */\n conflictBehavior?: ConflictBehavior\n /** Whether the hotkey is enabled. Defaults to true */\n enabled?: boolean\n /** The event type to listen for. Defaults to 'keydown' */\n eventType?: 'keydown' | 'keyup'\n /** Whether to ignore hotkeys when keyboard events originate from input-like elements (text inputs, textarea, select, contenteditable — button-type inputs like type=button/submit/reset are not ignored). Defaults based on hotkey: true for single keys and Shift/Alt combos; false for Ctrl/Meta shortcuts and Escape */\n ignoreInputs?: boolean\n /** The target platform for resolving 'Mod' */\n platform?: 'mac' | 'windows' | 'linux'\n /** Prevent the default browser action when the hotkey matches. Defaults to true */\n preventDefault?: boolean\n /** If true, only trigger once until all keys are released. Default: false */\n requireReset?: boolean\n /** Stop event propagation when the hotkey matches. Defaults to true */\n stopPropagation?: boolean\n /** The DOM element to attach the event listener to. Defaults to document. */\n target?: HTMLElement | Document | Window | null\n}\n\n/**\n * A registered hotkey handler in the HotkeyManager.\n */\nexport interface HotkeyRegistration {\n /** The callback to invoke */\n callback: HotkeyCallback\n /** Whether this registration has fired and needs reset (for requireReset) */\n hasFired: boolean\n /** The original hotkey string */\n hotkey: Hotkey\n /** Unique identifier for this registration */\n id: string\n /** Options for this registration */\n options: HotkeyOptions\n /** The parsed hotkey */\n parsedHotkey: ParsedHotkey\n /** The resolved target element for this registration */\n target: HTMLElement | Document | Window\n /** How many times this registration's callback has been triggered */\n triggerCount: number\n}\n\n/**\n * A handle returned from HotkeyManager.register() that allows updating\n * the callback and options without re-registering the hotkey.\n *\n * @example\n * ```ts\n * const handle = manager.register('Mod+S', callback, options)\n *\n * // Update callback without re-registering (avoids stale closures)\n * handle.callback = newCallback\n *\n * // Update options without re-registering\n * handle.setOptions({ enabled: false })\n *\n * // Check if still active\n * if (handle.isActive) {\n * // ...\n * }\n *\n * // Unregister when done\n * handle.unregister()\n * ```\n */\nexport interface HotkeyRegistrationHandle {\n /**\n * The callback function. Can be set directly to update without re-registering.\n * This avoids stale closures when the callback references React state.\n */\n callback: HotkeyCallback\n /** Unique identifier for this registration */\n readonly id: string\n /** Check if this registration is still active (not unregistered) */\n readonly isActive: boolean\n /**\n * Update options (merged with existing options).\n * Useful for updating `enabled`, `preventDefault`, etc. without re-registering.\n */\n setOptions: (options: Partial<HotkeyOptions>) => void\n /** Unregister this hotkey */\n unregister: () => void\n}\n\n/**\n * Default options for hotkey registration.\n */\nconst defaultHotkeyOptions: Omit<\n Required<HotkeyOptions>,\n 'platform' | 'target'\n> = {\n preventDefault: true,\n stopPropagation: true,\n eventType: 'keydown',\n requireReset: false,\n enabled: true,\n ignoreInputs: true,\n conflictBehavior: 'warn',\n}\n\nlet registrationIdCounter = 0\n\n/**\n * Generates a unique ID for hotkey registrations.\n */\nfunction generateId(): string {\n return `hotkey_${++registrationIdCounter}`\n}\n\n/**\n * Computes the default ignoreInputs value based on the hotkey.\n * Ctrl/Meta shortcuts and Escape fire in inputs; single keys and Shift/Alt combos are ignored.\n */\nfunction getDefaultIgnoreInputs(parsedHotkey: ParsedHotkey): boolean {\n if (parsedHotkey.ctrl || parsedHotkey.meta) return false // Mod+S, Ctrl+C, etc.\n if (parsedHotkey.key === 'Escape') return false // Close modal, etc.\n return true // Single keys, Shift+key, Alt+key\n}\n\n/**\n * Singleton manager for hotkey registrations.\n *\n * This class provides a centralized way to register and manage keyboard hotkeys.\n * It uses a single event listener for efficiency, regardless of how many hotkeys\n * are registered.\n *\n * @example\n * ```ts\n * const manager = HotkeyManager.getInstance()\n *\n * const unregister = manager.register('Mod+S', (event, context) => {\n * console.log('Save triggered!')\n * })\n *\n * // Later, to unregister:\n * unregister()\n * ```\n */\nexport class HotkeyManager {\n static #instance: HotkeyManager | null = null\n\n /**\n * The TanStack Store containing all hotkey registrations.\n * Use this to subscribe to registration changes or access current registrations.\n *\n * @example\n * ```ts\n * const manager = HotkeyManager.getInstance()\n *\n * // Subscribe to registration changes\n * const unsubscribe = manager.registrations.subscribe(() => {\n * console.log('Registrations changed:', manager.registrations.state.size)\n * })\n *\n * // Access current registrations\n * for (const [id, reg] of manager.registrations.state) {\n * console.log(reg.hotkey, reg.options.enabled)\n * }\n * ```\n */\n readonly registrations: Store<Map<string, HotkeyRegistration>> = new Store(\n new Map(),\n )\n #platform: 'mac' | 'windows' | 'linux'\n #targetListeners: Map<\n HTMLElement | Document | Window,\n {\n keydown: (event: KeyboardEvent) => void\n keyup: (event: KeyboardEvent) => void\n }\n > = new Map()\n #targetRegistrations: Map<HTMLElement | Document | Window, Set<string>> =\n new Map()\n\n private constructor() {\n this.#platform = detectPlatform()\n }\n\n /**\n * Gets the singleton instance of HotkeyManager.\n */\n static getInstance(): HotkeyManager {\n if (!HotkeyManager.#instance) {\n HotkeyManager.#instance = new HotkeyManager()\n }\n return HotkeyManager.#instance\n }\n\n /**\n * Resets the singleton instance. Useful for testing.\n */\n static resetInstance(): void {\n if (HotkeyManager.#instance) {\n HotkeyManager.#instance.destroy()\n HotkeyManager.#instance = null\n }\n }\n\n /**\n * Registers a hotkey handler and returns a handle for updating the registration.\n *\n * The returned handle allows updating the callback and options without\n * re-registering, which is useful for avoiding stale closures in React.\n *\n * @param hotkey - The hotkey string (e.g., 'Mod+S') or RawHotkey object\n * @param callback - The function to call when the hotkey is pressed\n * @param options - Options for the hotkey behavior\n * @returns A handle for managing the registration\n *\n * @example\n * ```ts\n * const handle = manager.register('Mod+S', callback)\n *\n * // Update callback without re-registering (avoids stale closures)\n * handle.callback = newCallback\n *\n * // Update options\n * handle.setOptions({ enabled: false })\n *\n * // Unregister when done\n * handle.unregister()\n * ```\n */\n register(\n hotkey: RegisterableHotkey,\n callback: HotkeyCallback,\n options: HotkeyOptions = {},\n ): HotkeyRegistrationHandle {\n const id = generateId()\n const platform = options.platform ?? this.#platform\n const parsedHotkey =\n typeof hotkey === 'string'\n ? parseHotkey(hotkey, platform)\n : rawHotkeyToParsedHotkey(hotkey, platform)\n const hotkeyStr = (\n typeof hotkey === 'string' ? hotkey : formatHotkey(parsedHotkey)\n ) as Hotkey\n\n // Resolve target: default to document if not provided or null\n const target =\n options.target ??\n (typeof document !== 'undefined' ? document : ({} as Document))\n\n // Resolve conflict behavior\n const conflictBehavior = options.conflictBehavior ?? 'warn'\n\n // Check for existing registrations with the same hotkey and target\n const conflictingRegistration = this.#findConflictingRegistration(\n hotkeyStr,\n target,\n )\n\n if (conflictingRegistration) {\n this.#handleConflict(conflictingRegistration, hotkeyStr, conflictBehavior)\n }\n\n const resolvedIgnoreInputs =\n options.ignoreInputs ?? getDefaultIgnoreInputs(parsedHotkey)\n\n const baseOptions = {\n ...defaultHotkeyOptions,\n ...options,\n platform,\n }\n\n const registration: HotkeyRegistration = {\n id,\n hotkey: hotkeyStr,\n parsedHotkey,\n callback,\n options: { ...baseOptions, ignoreInputs: resolvedIgnoreInputs },\n hasFired: false,\n triggerCount: 0,\n target,\n }\n\n this.registrations.setState((prev) => new Map(prev).set(id, registration))\n\n // Track registration for this target\n if (!this.#targetRegistrations.has(target)) {\n this.#targetRegistrations.set(target, new Set())\n }\n this.#targetRegistrations.get(target)!.add(id)\n\n // Ensure listeners are attached for this target\n this.#ensureListenersForTarget(target)\n\n // Create and return the handle\n const manager = this\n const handle: HotkeyRegistrationHandle = {\n get id() {\n return id\n },\n unregister: () => {\n manager.#unregister(id)\n },\n get callback() {\n const reg = manager.registrations.state.get(id)\n return reg?.callback ?? callback\n },\n set callback(newCallback: HotkeyCallback) {\n const reg = manager.registrations.state.get(id)\n if (reg) {\n reg.callback = newCallback\n }\n },\n setOptions: (newOptions: Partial<HotkeyOptions>) => {\n manager.registrations.setState((prev) => {\n const reg = prev.get(id)\n if (reg) {\n const next = new Map(prev)\n next.set(id, { ...reg, options: { ...reg.options, ...newOptions } })\n return next\n }\n return prev\n })\n },\n get isActive() {\n return manager.registrations.state.has(id)\n },\n }\n\n return handle\n }\n\n /**\n * Unregisters a hotkey by its registration ID.\n */\n #unregister(id: string): void {\n const registration = this.registrations.state.get(id)\n if (!registration) {\n return\n }\n\n const target = registration.target\n\n // Remove registration\n this.registrations.setState((prev) => {\n const next = new Map(prev)\n next.delete(id)\n return next\n })\n\n // Remove from target registrations tracking\n const targetRegs = this.#targetRegistrations.get(target)\n if (targetRegs) {\n targetRegs.delete(id)\n // If no more registrations for this target, remove listeners\n if (targetRegs.size === 0) {\n this.#removeListenersForTarget(target)\n }\n }\n }\n\n /**\n * Ensures event listeners are attached for a specific target.\n */\n #ensureListenersForTarget(target: HTMLElement | Document | Window): void {\n if (typeof document === 'undefined') {\n return // SSR safety\n }\n\n // Skip if listeners already exist for this target\n if (this.#targetListeners.has(target)) {\n return\n }\n\n const keydownHandler = this.#createTargetKeyDownHandler(target)\n const keyupHandler = this.#createTargetKeyUpHandler(target)\n\n target.addEventListener('keydown', keydownHandler as EventListener)\n target.addEventListener('keyup', keyupHandler as EventListener)\n\n this.#targetListeners.set(target, {\n keydown: keydownHandler,\n keyup: keyupHandler,\n })\n }\n\n /**\n * Removes event listeners for a specific target.\n */\n #removeListenersForTarget(target: HTMLElement | Document | Window): void {\n if (typeof document === 'undefined') {\n return\n }\n\n const listeners = this.#targetListeners.get(target)\n if (!listeners) {\n return\n }\n\n target.removeEventListener('keydown', listeners.keydown as EventListener)\n target.removeEventListener('keyup', listeners.keyup as EventListener)\n\n this.#targetListeners.delete(target)\n this.#targetRegistrations.delete(target)\n }\n\n /**\n * Processes keyboard events for a specific target and event type.\n */\n #processTargetEvent(\n event: KeyboardEvent,\n target: HTMLElement | Document | Window,\n eventType: 'keydown' | 'keyup',\n ): void {\n const targetRegs = this.#targetRegistrations.get(target)\n if (!targetRegs) {\n return\n }\n\n for (const id of targetRegs) {\n const registration = this.registrations.state.get(id)\n if (!registration) {\n continue\n }\n\n // Check if event originated from or bubbled to this target\n if (!this.#isEventForTarget(event, target)) {\n continue\n }\n\n if (!registration.options.enabled) {\n continue\n }\n\n // Check if we should ignore input elements (defaults to true)\n if (registration.options.ignoreInputs !== false) {\n if (this.#isInputElement(event.target)) {\n // Don't ignore if the hotkey is explicitly scoped to this input element\n if (event.target !== registration.target) {\n continue\n }\n }\n }\n\n // Handle keydown events\n if (eventType === 'keydown') {\n if (registration.options.eventType !== 'keydown') {\n continue\n }\n\n // Check if the hotkey matches first\n const matches = matchesKeyboardEvent(\n event,\n registration.parsedHotkey,\n registration.options.platform,\n )\n\n if (matches) {\n // Always apply preventDefault/stopPropagation if the hotkey matches,\n // even when requireReset is active and has already fired\n if (registration.options.preventDefault) {\n event.preventDefault()\n }\n if (registration.options.stopPropagation) {\n event.stopPropagation()\n }\n\n // Only execute callback if requireReset is not active or hasn't fired yet\n if (!registration.options.requireReset || !registration.hasFired) {\n this.#executeHotkeyCallback(registration, event)\n\n // Mark as fired if requireReset is enabled\n if (registration.options.requireReset) {\n registration.hasFired = true\n }\n }\n }\n }\n // Handle keyup events\n else {\n if (registration.options.eventType === 'keyup') {\n if (\n matchesKeyboardEvent(\n event,\n registration.parsedHotkey,\n registration.options.platform,\n )\n ) {\n this.#executeHotkeyCallback(registration, event)\n }\n }\n\n // Reset hasFired when any key in the hotkey is released\n if (registration.options.requireReset && registration.hasFired) {\n if (this.#shouldResetRegistration(registration, event)) {\n registration.hasFired = false\n }\n }\n }\n }\n }\n\n /**\n * Executes a hotkey callback with proper event handling.\n */\n #executeHotkeyCallback(\n registration: HotkeyRegistration,\n event: KeyboardEvent,\n ): void {\n if (registration.options.preventDefault) {\n event.preventDefault()\n }\n if (registration.options.stopPropagation) {\n event.stopPropagation()\n }\n\n registration.triggerCount++\n\n // Notify the store so subscribers (e.g. devtools) see the updated count.\n // We create a new Map but keep the same registration reference to preserve\n // identity for mutation-based fields like hasFired.\n this.registrations.setState((prev) => new Map(prev))\n\n const context: HotkeyCallbackContext = {\n hotkey: registration.hotkey,\n parsedHotkey: registration.parsedHotkey,\n }\n\n registration.callback(event, context)\n }\n\n /**\n * Creates a keydown handler for a specific target.\n */\n #createTargetKeyDownHandler(\n target: HTMLElement | Document | Window,\n ): (event: KeyboardEvent) => void {\n return (event: KeyboardEvent) => {\n this.#processTargetEvent(event, target, 'keydown')\n }\n }\n\n /**\n * Creates a keyup handler for a specific target.\n */\n #createTargetKeyUpHandler(\n target: HTMLElement | Document | Window,\n ): (event: KeyboardEvent) => void {\n return (event: KeyboardEvent) => {\n this.#processTargetEvent(event, target, 'keyup')\n }\n }\n\n /**\n * Checks if an event is for the given target (originated from or bubbled to it).\n */\n #isEventForTarget(\n event: KeyboardEvent,\n target: HTMLElement | Document | Window,\n ): boolean {\n // For Document and Window, check if currentTarget matches\n if (target === document || target === window) {\n return event.currentTarget === target\n }\n\n // For HTMLElement, check if event originated from or bubbled to the element\n if (target instanceof HTMLElement) {\n // Check if the event's currentTarget is the target (capturing/bubbling)\n if (event.currentTarget === target) {\n return true\n }\n\n // Check if the event's target is a descendant of our target\n if (event.target instanceof Node && target.contains(event.target)) {\n return true\n }\n }\n\n return false\n }\n\n /**\n * Finds an existing registration with the same hotkey and target.\n */\n #findConflictingRegistration(\n hotkey: Hotkey,\n target: HTMLElement | Document | Window,\n ): HotkeyRegistration | null {\n for (const registration of this.registrations.state.values()) {\n if (registration.hotkey === hotkey && registration.target === target) {\n return registration\n }\n }\n return null\n }\n\n /**\n * Handles conflicts between hotkey registrations based on conflict behavior.\n */\n #handleConflict(\n conflictingRegistration: HotkeyRegistration,\n hotkey: Hotkey,\n conflictBehavior: ConflictBehavior,\n ): void {\n if (conflictBehavior === 'allow') {\n return\n }\n\n if (conflictBehavior === 'warn') {\n console.warn(\n `Hotkey '${hotkey}' is already registered. Multiple handlers will be triggered. ` +\n `Use conflictBehavior: 'replace' to replace the existing handler, ` +\n `or conflictBehavior: 'allow' to suppress this warning.`,\n )\n return\n }\n\n if (conflictBehavior === 'error') {\n throw new Error(\n `Hotkey '${hotkey}' is already registered. ` +\n `Use conflictBehavior: 'replace' to replace the existing handler, ` +\n `or conflictBehavior: 'allow' to allow multiple registrations.`,\n )\n }\n\n // At this point, conflictBehavior must be 'replace'\n this.#unregister(conflictingRegistration.id)\n }\n\n /**\n * Checks if an element is an input-like element that should be ignored.\n *\n * This includes:\n * - HTMLInputElement (all input types except button, submit, reset)\n * - HTMLTextAreaElement\n * - HTMLSelectElement\n * - Elements with contentEditable enabled\n *\n * Button-type inputs (button, submit, reset) are excluded so hotkeys like\n * Mod+S and Escape fire when the user has tabbed to a form button.\n */\n #isInputElement(element: EventTarget | null): boolean {\n if (!element) {\n return false\n }\n\n if (element instanceof HTMLInputElement) {\n const type = element.type.toLowerCase()\n if (type === 'button' || type === 'submit' || type === 'reset') {\n return false\n }\n return true\n }\n\n if (\n element instanceof HTMLTextAreaElement ||\n element instanceof HTMLSelectElement\n ) {\n return true\n }\n\n // Check for contenteditable elements\n if (element instanceof HTMLElement) {\n const contentEditable = element.contentEditable\n if (contentEditable === 'true' || contentEditable === '') {\n return true\n }\n }\n\n return false\n }\n\n /**\n * Determines if a registration should be reset based on the keyup event.\n */\n #shouldResetRegistration(\n registration: HotkeyRegistration,\n event: KeyboardEvent,\n ): boolean {\n const parsed = registration.parsedHotkey\n const releasedKey = normalizeKeyName(event.key)\n\n // Reset if the main key is released\n // Compare case-insensitively for single-letter keys\n const parsedKeyNormalized =\n parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key\n const releasedKeyNormalized =\n releasedKey.length === 1 ? releasedKey.toUpperCase() : releasedKey\n\n if (releasedKeyNormalized === parsedKeyNormalized) {\n return true\n }\n\n // Reset if any required modifier is released\n // Use normalized key names and check against canonical modifier names\n if (parsed.ctrl && releasedKey === 'Control') {\n return true\n }\n if (parsed.shift && releasedKey === 'Shift') {\n return true\n }\n if (parsed.alt && releasedKey === 'Alt') {\n return true\n }\n if (parsed.meta && releasedKey === 'Meta') {\n return true\n }\n\n return false\n }\n\n /**\n * Triggers a registration's callback programmatically from devtools.\n * Creates a synthetic KeyboardEvent and invokes the callback.\n *\n * @param id - The registration ID to trigger\n * @returns True if the registration was found and triggered\n */\n triggerRegistration(id: string): boolean {\n const registration = this.registrations.state.get(id)\n if (!registration) {\n return false\n }\n\n const parsed = registration.parsedHotkey\n const syntheticEvent = new KeyboardEvent(\n registration.options.eventType ?? 'keydown',\n {\n key: parsed.key,\n ctrlKey: parsed.ctrl,\n shiftKey: parsed.shift,\n altKey: parsed.alt,\n metaKey: parsed.meta,\n bubbles: true,\n cancelable: true,\n },\n )\n\n registration.triggerCount++\n\n // Notify the store so subscribers (e.g. devtools) see the updated count\n this.registrations.setState((prev) => new Map(prev))\n\n registration.callback(syntheticEvent, {\n hotkey: registration.hotkey,\n parsedHotkey: registration.parsedHotkey,\n })\n\n return true\n }\n\n /**\n * Gets the number of registered hotkeys.\n */\n getRegistrationCount(): number {\n return this.registrations.state.size\n }\n\n /**\n * Checks if a specific hotkey is registered.\n *\n * @param hotkey - The hotkey string to check\n * @param target - Optional target element to match (if provided, both hotkey and target must match)\n * @returns True if a matching registration exists\n */\n isRegistered(\n hotkey: Hotkey,\n target?: HTMLElement | Document | Window,\n ): boolean {\n for (const registration of this.registrations.state.values()) {\n if (registration.hotkey === hotkey) {\n // If target is specified, both must match\n if (target === undefined || registration.target === target) {\n return true\n }\n }\n }\n return false\n }\n\n /**\n * Destroys the manager and removes all listeners.\n */\n destroy(): void {\n // Remove all target listeners\n for (const target of this.#targetListeners.keys()) {\n this.#removeListenersForTarget(target)\n }\n\n this.registrations.setState(() => new Map())\n this.#targetListeners.clear()\n this.#targetRegistrations.clear()\n }\n}\n\n/**\n * Gets the singleton HotkeyManager instance.\n * Convenience function for accessing the manager.\n */\nexport function getHotkeyManager(): HotkeyManager {\n return HotkeyManager.getInstance()\n}\n"],"mappings":"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"}