@tanstack/hotkeys 0.9.0 → 0.10.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.
- package/dist/_event-target.js +1 -2
- package/dist/_keyboard-event.js +1 -2
- package/dist/_match.js +1 -2
- package/dist/_named-keys.d.ts +3 -5
- package/dist/_named-keys.js +1 -2
- package/dist/_recorder-chord.js +1 -2
- package/dist/_recording-guard.js +1 -2
- package/dist/_registration.js +1 -2
- package/dist/conflicts.d.ts +4 -7
- package/dist/conflicts.js +1 -2
- package/dist/constants.d.ts +14 -17
- package/dist/constants.js +8 -9
- package/dist/display-labels.d.ts +7 -10
- package/dist/display-labels.js +1 -2
- package/dist/format.d.ts +9 -12
- package/dist/format.js +9 -7
- package/dist/hint.d.ts +3 -6
- package/dist/hint.js +1 -2
- package/dist/hotkey-manager.d.ts +8 -10
- package/dist/hotkey-manager.js +21 -3
- package/dist/hotkey-recorder.d.ts +4 -7
- package/dist/hotkey-recorder.js +9 -6
- package/dist/hotkey-sequence-recorder.d.ts +5 -8
- package/dist/hotkey-sequence-recorder.js +6 -7
- package/dist/hotkey.types.d.ts +15 -18
- package/dist/key-state-tracker.d.ts +4 -7
- package/dist/key-state-tracker.js +6 -3
- package/dist/key.types.d.ts +17 -20
- package/dist/match.d.ts +8 -11
- package/dist/match.js +1 -2
- package/dist/parse.d.ts +11 -14
- package/dist/parse.js +5 -4
- package/dist/platform.d.ts +3 -6
- package/dist/platform.js +1 -2
- package/dist/recorder-options.d.ts +6 -9
- package/dist/sequence-manager.d.ts +11 -14
- package/dist/sequence-manager.js +12 -7
- package/dist/validate.d.ts +5 -8
- package/dist/validate.js +1 -2
- package/package.json +8 -13
- package/dist/_event-target.cjs +0 -73
- package/dist/_event-target.cjs.map +0 -1
- package/dist/_event-target.js.map +0 -1
- package/dist/_keyboard-event.cjs +0 -83
- package/dist/_keyboard-event.cjs.map +0 -1
- package/dist/_keyboard-event.js.map +0 -1
- package/dist/_match.cjs +0 -49
- package/dist/_match.cjs.map +0 -1
- package/dist/_match.js.map +0 -1
- package/dist/_named-keys.cjs +0 -68
- package/dist/_named-keys.cjs.map +0 -1
- package/dist/_named-keys.d.cts +0 -8
- package/dist/_named-keys.js.map +0 -1
- package/dist/_recorder-chord.cjs +0 -44
- package/dist/_recorder-chord.cjs.map +0 -1
- package/dist/_recorder-chord.js.map +0 -1
- package/dist/_recording-guard.cjs +0 -59
- package/dist/_recording-guard.cjs.map +0 -1
- package/dist/_recording-guard.js.map +0 -1
- package/dist/_registration.cjs +0 -54
- package/dist/_registration.cjs.map +0 -1
- package/dist/_registration.js.map +0 -1
- package/dist/conflicts.cjs +0 -55
- package/dist/conflicts.cjs.map +0 -1
- package/dist/conflicts.d.cts +0 -39
- package/dist/conflicts.js.map +0 -1
- package/dist/constants.cjs +0 -410
- package/dist/constants.cjs.map +0 -1
- package/dist/constants.d.cts +0 -165
- package/dist/constants.js.map +0 -1
- package/dist/display-labels.cjs +0 -119
- package/dist/display-labels.cjs.map +0 -1
- package/dist/display-labels.d.cts +0 -93
- package/dist/display-labels.js.map +0 -1
- package/dist/format.cjs +0 -85
- package/dist/format.cjs.map +0 -1
- package/dist/format.d.cts +0 -99
- package/dist/format.js.map +0 -1
- package/dist/hint.cjs +0 -24
- package/dist/hint.cjs.map +0 -1
- package/dist/hint.d.cts +0 -23
- package/dist/hint.js.map +0 -1
- package/dist/hotkey-manager.cjs +0 -414
- package/dist/hotkey-manager.cjs.map +0 -1
- package/dist/hotkey-manager.d.cts +0 -234
- package/dist/hotkey-manager.js.map +0 -1
- package/dist/hotkey-recorder.cjs +0 -235
- package/dist/hotkey-recorder.cjs.map +0 -1
- package/dist/hotkey-recorder.d.cts +0 -119
- package/dist/hotkey-recorder.js.map +0 -1
- package/dist/hotkey-sequence-recorder.cjs +0 -255
- package/dist/hotkey-sequence-recorder.cjs.map +0 -1
- package/dist/hotkey-sequence-recorder.d.cts +0 -86
- package/dist/hotkey-sequence-recorder.js.map +0 -1
- package/dist/hotkey.types.d.cts +0 -236
- package/dist/index.cjs +0 -71
- package/dist/index.d.cts +0 -18
- package/dist/key-state-tracker.cjs +0 -197
- package/dist/key-state-tracker.cjs.map +0 -1
- package/dist/key-state-tracker.d.cts +0 -107
- package/dist/key-state-tracker.js.map +0 -1
- package/dist/key.types.d.cts +0 -82
- package/dist/match.cjs +0 -144
- package/dist/match.cjs.map +0 -1
- package/dist/match.d.cts +0 -101
- package/dist/match.js.map +0 -1
- package/dist/parse.cjs +0 -245
- package/dist/parse.cjs.map +0 -1
- package/dist/parse.d.cts +0 -134
- package/dist/parse.js.map +0 -1
- package/dist/platform.cjs +0 -55
- package/dist/platform.cjs.map +0 -1
- package/dist/platform.d.cts +0 -44
- package/dist/platform.js.map +0 -1
- package/dist/recorder-options.d.cts +0 -34
- package/dist/sequence-manager.cjs +0 -441
- package/dist/sequence-manager.cjs.map +0 -1
- package/dist/sequence-manager.d.cts +0 -172
- package/dist/sequence-manager.js.map +0 -1
- package/dist/validate.cjs +0 -112
- package/dist/validate.cjs.map +0 -1
- package/dist/validate.d.cts +0 -67
- package/dist/validate.js.map +0 -1
- package/src/_event-target.ts +0 -157
- package/src/_keyboard-event.ts +0 -101
- package/src/_match.ts +0 -96
- package/src/_named-keys.ts +0 -62
- package/src/_recorder-chord.ts +0 -76
- package/src/_recording-guard.ts +0 -63
- package/src/_registration.ts +0 -79
- package/src/conflicts.ts +0 -125
- package/src/constants.ts +0 -455
- package/src/display-labels.ts +0 -123
- package/src/format.ts +0 -201
- package/src/hint.ts +0 -42
- package/src/hotkey-manager.ts +0 -814
- package/src/hotkey-recorder.ts +0 -348
- package/src/hotkey-sequence-recorder.ts +0 -410
- package/src/hotkey.types.ts +0 -269
- package/src/index.ts +0 -17
- package/src/key-state-tracker.ts +0 -261
- package/src/key.types.ts +0 -268
- package/src/match.ts +0 -210
- package/src/parse.ts +0 -369
- package/src/platform.ts +0 -66
- package/src/recorder-options.ts +0 -34
- package/src/sequence-manager.ts +0 -769
- package/src/validate.ts +0 -179
package/dist/hotkey-manager.cjs
DELETED
|
@@ -1,414 +0,0 @@
|
|
|
1
|
-
const require_constants = require('./constants.cjs');
|
|
2
|
-
const require_platform = require('./platform.cjs');
|
|
3
|
-
const require_parse = require('./parse.cjs');
|
|
4
|
-
const require_format = require('./format.cjs');
|
|
5
|
-
const require__match = require('./_match.cjs');
|
|
6
|
-
const require_match = require('./match.cjs');
|
|
7
|
-
const require__recording_guard = require('./_recording-guard.cjs');
|
|
8
|
-
const require__registration = require('./_registration.cjs');
|
|
9
|
-
const require__event_target = require('./_event-target.cjs');
|
|
10
|
-
let _tanstack_store = require("@tanstack/store");
|
|
11
|
-
|
|
12
|
-
//#region src/hotkey-manager.ts
|
|
13
|
-
/**
|
|
14
|
-
* Creates a public view from an internal registration,
|
|
15
|
-
* stripping the callback function.
|
|
16
|
-
*/
|
|
17
|
-
function toHotkeyRegistrationView(reg) {
|
|
18
|
-
return {
|
|
19
|
-
hotkey: reg.hotkey,
|
|
20
|
-
id: reg.id,
|
|
21
|
-
options: reg.options,
|
|
22
|
-
parsedHotkey: reg.parsedHotkey,
|
|
23
|
-
target: reg.target,
|
|
24
|
-
triggerCount: reg.triggerCount,
|
|
25
|
-
hasFired: reg.hasFired
|
|
26
|
-
};
|
|
27
|
-
}
|
|
28
|
-
let registrationIdCounter = 0;
|
|
29
|
-
/**
|
|
30
|
-
* Generates a unique ID for hotkey registrations.
|
|
31
|
-
*/
|
|
32
|
-
function generateId() {
|
|
33
|
-
return `hotkey_${++registrationIdCounter}`;
|
|
34
|
-
}
|
|
35
|
-
/**
|
|
36
|
-
* Singleton manager for hotkey registrations.
|
|
37
|
-
*
|
|
38
|
-
* This class provides a centralized way to register and manage keyboard hotkeys.
|
|
39
|
-
* It uses a single event listener for efficiency, regardless of how many hotkeys
|
|
40
|
-
* are registered.
|
|
41
|
-
*
|
|
42
|
-
* @example
|
|
43
|
-
* ```ts
|
|
44
|
-
* const manager = HotkeyManager.getInstance()
|
|
45
|
-
*
|
|
46
|
-
* const unregister = manager.register('Mod+S', (event, context) => {
|
|
47
|
-
* console.log('Save triggered!')
|
|
48
|
-
* })
|
|
49
|
-
*
|
|
50
|
-
* // Later, to unregister:
|
|
51
|
-
* unregister()
|
|
52
|
-
* ```
|
|
53
|
-
*/
|
|
54
|
-
var HotkeyManager = class HotkeyManager {
|
|
55
|
-
static #instance = null;
|
|
56
|
-
#platform;
|
|
57
|
-
#targetListeners = /* @__PURE__ */ new Map();
|
|
58
|
-
#targetRegistrations = /* @__PURE__ */ new Map();
|
|
59
|
-
constructor() {
|
|
60
|
-
this.registrations = new _tanstack_store.Store(/* @__PURE__ */ new Map());
|
|
61
|
-
this.#platform = require_platform.detectPlatform();
|
|
62
|
-
}
|
|
63
|
-
/**
|
|
64
|
-
* Gets the singleton instance of HotkeyManager.
|
|
65
|
-
*/
|
|
66
|
-
static getInstance() {
|
|
67
|
-
if (!HotkeyManager.#instance) HotkeyManager.#instance = new HotkeyManager();
|
|
68
|
-
return HotkeyManager.#instance;
|
|
69
|
-
}
|
|
70
|
-
/**
|
|
71
|
-
* Resets the singleton instance. Useful for testing.
|
|
72
|
-
*/
|
|
73
|
-
static resetInstance() {
|
|
74
|
-
if (HotkeyManager.#instance) {
|
|
75
|
-
HotkeyManager.#instance.destroy();
|
|
76
|
-
HotkeyManager.#instance = null;
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
/**
|
|
80
|
-
* Registers a hotkey handler and returns a handle for updating the registration.
|
|
81
|
-
*
|
|
82
|
-
* The returned handle allows updating the callback and options without
|
|
83
|
-
* re-registering, which is useful for avoiding stale closures in React.
|
|
84
|
-
*
|
|
85
|
-
* @param hotkey - The hotkey string (e.g., 'Mod+S') or RawHotkey object
|
|
86
|
-
* @param callback - The function to call when the hotkey is pressed
|
|
87
|
-
* @param options - Options for the hotkey behavior
|
|
88
|
-
* @returns A handle for managing the registration
|
|
89
|
-
*
|
|
90
|
-
* @example
|
|
91
|
-
* ```ts
|
|
92
|
-
* const handle = manager.register('Mod+S', callback)
|
|
93
|
-
*
|
|
94
|
-
* // Update callback without re-registering (avoids stale closures)
|
|
95
|
-
* handle.callback = newCallback
|
|
96
|
-
*
|
|
97
|
-
* // Update options
|
|
98
|
-
* handle.setOptions({ enabled: false })
|
|
99
|
-
*
|
|
100
|
-
* // Unregister when done
|
|
101
|
-
* handle.unregister()
|
|
102
|
-
* ```
|
|
103
|
-
*/
|
|
104
|
-
register(hotkey, callback, options = {}) {
|
|
105
|
-
if (typeof document === "undefined" && !options.target) {
|
|
106
|
-
let currentCallback = callback;
|
|
107
|
-
return {
|
|
108
|
-
id: generateId(),
|
|
109
|
-
unregister: () => {},
|
|
110
|
-
get callback() {
|
|
111
|
-
return currentCallback;
|
|
112
|
-
},
|
|
113
|
-
set callback(newCallback) {
|
|
114
|
-
currentCallback = newCallback;
|
|
115
|
-
},
|
|
116
|
-
setOptions: () => {},
|
|
117
|
-
get isActive() {
|
|
118
|
-
return false;
|
|
119
|
-
}
|
|
120
|
-
};
|
|
121
|
-
}
|
|
122
|
-
const id = generateId();
|
|
123
|
-
const platform = options.platform ?? this.#platform;
|
|
124
|
-
const parsedHotkey = typeof hotkey === "string" ? require_parse.parseHotkey(hotkey, platform) : require_parse.rawHotkeyToParsedHotkey(hotkey, platform);
|
|
125
|
-
const hotkeyStr = typeof hotkey === "string" ? hotkey : require_format.formatHotkey(parsedHotkey);
|
|
126
|
-
const target = options.target ?? document;
|
|
127
|
-
const conflictBehavior = options.conflictBehavior ?? "warn";
|
|
128
|
-
const conflictingRegistration = this.#findConflictingRegistration(hotkeyStr, target);
|
|
129
|
-
if (conflictingRegistration) require__registration.handleConflict(conflictingRegistration.id, hotkeyStr, conflictBehavior, (id) => this.#unregister(id));
|
|
130
|
-
const resolvedIgnoreInputs = options.ignoreInputs ?? require__registration.getDefaultIgnoreInputs(parsedHotkey);
|
|
131
|
-
const registration = {
|
|
132
|
-
id,
|
|
133
|
-
hotkey: hotkeyStr,
|
|
134
|
-
parsedHotkey,
|
|
135
|
-
callback,
|
|
136
|
-
options: {
|
|
137
|
-
...require__registration.defaultHotkeyOptions,
|
|
138
|
-
requireReset: false,
|
|
139
|
-
...options,
|
|
140
|
-
platform,
|
|
141
|
-
ignoreInputs: resolvedIgnoreInputs
|
|
142
|
-
},
|
|
143
|
-
hasFired: false,
|
|
144
|
-
triggerCount: 0,
|
|
145
|
-
target
|
|
146
|
-
};
|
|
147
|
-
this.registrations.setState((prev) => new Map(prev).set(id, registration));
|
|
148
|
-
if (!this.#targetRegistrations.has(target)) this.#targetRegistrations.set(target, /* @__PURE__ */ new Set());
|
|
149
|
-
this.#targetRegistrations.get(target).add(id);
|
|
150
|
-
this.#ensureListenersForTarget(target);
|
|
151
|
-
const manager = this;
|
|
152
|
-
return {
|
|
153
|
-
get id() {
|
|
154
|
-
return id;
|
|
155
|
-
},
|
|
156
|
-
unregister: () => {
|
|
157
|
-
manager.#unregister(id);
|
|
158
|
-
},
|
|
159
|
-
get callback() {
|
|
160
|
-
return manager.registrations.state.get(id)?.callback ?? callback;
|
|
161
|
-
},
|
|
162
|
-
set callback(newCallback) {
|
|
163
|
-
const reg = manager.registrations.state.get(id);
|
|
164
|
-
if (reg) reg.callback = newCallback;
|
|
165
|
-
},
|
|
166
|
-
setOptions: (newOptions) => {
|
|
167
|
-
manager.registrations.setState((prev) => {
|
|
168
|
-
const reg = prev.get(id);
|
|
169
|
-
if (reg && !require__registration.optionsEqual(reg.options, {
|
|
170
|
-
...reg.options,
|
|
171
|
-
...newOptions
|
|
172
|
-
})) {
|
|
173
|
-
const next = new Map(prev);
|
|
174
|
-
next.set(id, {
|
|
175
|
-
...reg,
|
|
176
|
-
options: {
|
|
177
|
-
...reg.options,
|
|
178
|
-
...newOptions
|
|
179
|
-
}
|
|
180
|
-
});
|
|
181
|
-
return next;
|
|
182
|
-
}
|
|
183
|
-
return prev;
|
|
184
|
-
});
|
|
185
|
-
},
|
|
186
|
-
get isActive() {
|
|
187
|
-
return manager.registrations.state.has(id);
|
|
188
|
-
}
|
|
189
|
-
};
|
|
190
|
-
}
|
|
191
|
-
/**
|
|
192
|
-
* Unregisters a hotkey by its registration ID.
|
|
193
|
-
*/
|
|
194
|
-
#unregister(id) {
|
|
195
|
-
const registration = this.registrations.state.get(id);
|
|
196
|
-
if (!registration) return;
|
|
197
|
-
const target = registration.target;
|
|
198
|
-
this.registrations.setState((prev) => {
|
|
199
|
-
const next = new Map(prev);
|
|
200
|
-
next.delete(id);
|
|
201
|
-
return next;
|
|
202
|
-
});
|
|
203
|
-
const targetRegs = this.#targetRegistrations.get(target);
|
|
204
|
-
if (targetRegs) {
|
|
205
|
-
targetRegs.delete(id);
|
|
206
|
-
if (targetRegs.size === 0) this.#removeListenersForTarget(target);
|
|
207
|
-
}
|
|
208
|
-
}
|
|
209
|
-
/**
|
|
210
|
-
* Ensures event listeners are attached for a specific target.
|
|
211
|
-
*/
|
|
212
|
-
#ensureListenersForTarget(target) {
|
|
213
|
-
if (typeof document === "undefined") return;
|
|
214
|
-
if (this.#targetListeners.has(target)) return;
|
|
215
|
-
const keydownHandler = this.#createTargetKeyDownHandler(target);
|
|
216
|
-
const keyupHandler = this.#createTargetKeyUpHandler(target);
|
|
217
|
-
target.addEventListener("keydown", keydownHandler);
|
|
218
|
-
target.addEventListener("keyup", keyupHandler);
|
|
219
|
-
this.#targetListeners.set(target, {
|
|
220
|
-
keydown: keydownHandler,
|
|
221
|
-
keyup: keyupHandler
|
|
222
|
-
});
|
|
223
|
-
}
|
|
224
|
-
/**
|
|
225
|
-
* Removes event listeners for a specific target.
|
|
226
|
-
*/
|
|
227
|
-
#removeListenersForTarget(target) {
|
|
228
|
-
if (typeof document === "undefined") return;
|
|
229
|
-
const listeners = this.#targetListeners.get(target);
|
|
230
|
-
if (!listeners) return;
|
|
231
|
-
target.removeEventListener("keydown", listeners.keydown);
|
|
232
|
-
target.removeEventListener("keyup", listeners.keyup);
|
|
233
|
-
this.#targetListeners.delete(target);
|
|
234
|
-
this.#targetRegistrations.delete(target);
|
|
235
|
-
}
|
|
236
|
-
/**
|
|
237
|
-
* Processes keyboard events for a specific target and event type.
|
|
238
|
-
*/
|
|
239
|
-
#processTargetEvent(event, target, eventType) {
|
|
240
|
-
if (eventType === "keyup") for (const id of this.#targetRegistrations.get(target) ?? []) {
|
|
241
|
-
const registration = this.registrations.state.get(id);
|
|
242
|
-
if (registration?.hasFired && this.#shouldResetRegistration(registration, event)) {
|
|
243
|
-
registration.hasFired = false;
|
|
244
|
-
registration.activeMatch = void 0;
|
|
245
|
-
}
|
|
246
|
-
}
|
|
247
|
-
if (require__recording_guard.isRecordingEvent(event)) return;
|
|
248
|
-
const targetRegs = this.#targetRegistrations.get(target);
|
|
249
|
-
if (!targetRegs) return;
|
|
250
|
-
const matches = /* @__PURE__ */ new Map();
|
|
251
|
-
let bestScore = 0;
|
|
252
|
-
for (const id of targetRegs) {
|
|
253
|
-
const registration = this.registrations.state.get(id);
|
|
254
|
-
if (!registration || !registration.options.enabled || registration.options.eventType !== eventType || !require__event_target.isEventForTarget(event, target) || registration.options.ignoreInputs !== false && require__event_target.shouldIgnoreInputEvent(event, target, registration.target)) continue;
|
|
255
|
-
const result = require__match.matchKeyboardEvent(event, registration.parsedHotkey, registration.options.platform);
|
|
256
|
-
if (result.matched) {
|
|
257
|
-
matches.set(id, result);
|
|
258
|
-
bestScore = Math.max(bestScore, result.score);
|
|
259
|
-
}
|
|
260
|
-
}
|
|
261
|
-
for (const id of targetRegs) {
|
|
262
|
-
const registration = this.registrations.state.get(id);
|
|
263
|
-
if (!registration) continue;
|
|
264
|
-
if (!require__event_target.isEventForTarget(event, target)) continue;
|
|
265
|
-
if (!registration.options.enabled) continue;
|
|
266
|
-
if (registration.options.ignoreInputs !== false) {
|
|
267
|
-
if (require__event_target.shouldIgnoreInputEvent(event, target, registration.target)) continue;
|
|
268
|
-
}
|
|
269
|
-
if (eventType === "keydown") {
|
|
270
|
-
if (registration.options.eventType !== "keydown") continue;
|
|
271
|
-
const match = matches.get(id);
|
|
272
|
-
if (match?.matched && match.score === bestScore) {
|
|
273
|
-
if (registration.options.preventDefault) event.preventDefault();
|
|
274
|
-
if (registration.options.stopPropagation) event.stopPropagation();
|
|
275
|
-
if (!registration.options.requireReset || !registration.hasFired) {
|
|
276
|
-
this.#executeHotkeyCallback(registration, event);
|
|
277
|
-
if (registration.options.requireReset) {
|
|
278
|
-
registration.hasFired = true;
|
|
279
|
-
registration.activeMatch = match.identity;
|
|
280
|
-
}
|
|
281
|
-
}
|
|
282
|
-
}
|
|
283
|
-
} else if (registration.options.eventType === "keyup") {
|
|
284
|
-
const match = matches.get(id);
|
|
285
|
-
if (match?.matched && match.score === bestScore) this.#executeHotkeyCallback(registration, event);
|
|
286
|
-
}
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
/**
|
|
290
|
-
* Executes a hotkey callback with proper event handling.
|
|
291
|
-
*/
|
|
292
|
-
#executeHotkeyCallback(registration, event) {
|
|
293
|
-
if (registration.options.preventDefault) event.preventDefault();
|
|
294
|
-
if (registration.options.stopPropagation) event.stopPropagation();
|
|
295
|
-
registration.triggerCount++;
|
|
296
|
-
this.registrations.setState((prev) => new Map(prev));
|
|
297
|
-
const context = {
|
|
298
|
-
hotkey: registration.hotkey,
|
|
299
|
-
parsedHotkey: registration.parsedHotkey
|
|
300
|
-
};
|
|
301
|
-
registration.callback(event, context);
|
|
302
|
-
}
|
|
303
|
-
/**
|
|
304
|
-
* Creates a keydown handler for a specific target.
|
|
305
|
-
*/
|
|
306
|
-
#createTargetKeyDownHandler(target) {
|
|
307
|
-
return (event) => {
|
|
308
|
-
this.#processTargetEvent(event, target, "keydown");
|
|
309
|
-
};
|
|
310
|
-
}
|
|
311
|
-
/**
|
|
312
|
-
* Creates a keyup handler for a specific target.
|
|
313
|
-
*/
|
|
314
|
-
#createTargetKeyUpHandler(target) {
|
|
315
|
-
return (event) => {
|
|
316
|
-
this.#processTargetEvent(event, target, "keyup");
|
|
317
|
-
};
|
|
318
|
-
}
|
|
319
|
-
/**
|
|
320
|
-
* Finds an existing registration with the same hotkey and target.
|
|
321
|
-
*/
|
|
322
|
-
#findConflictingRegistration(hotkey, target) {
|
|
323
|
-
for (const registration of this.registrations.state.values()) if (require_match.areHotkeysEqual(registration.hotkey, hotkey, registration.options.platform) && registration.target === target) return registration;
|
|
324
|
-
return null;
|
|
325
|
-
}
|
|
326
|
-
/**
|
|
327
|
-
* Determines if a registration should be reset based on the keyup event.
|
|
328
|
-
*/
|
|
329
|
-
#shouldResetRegistration(registration, event) {
|
|
330
|
-
const parsed = registration.parsedHotkey;
|
|
331
|
-
const releasedKey = require_constants.normalizeKeyName(event.key);
|
|
332
|
-
if (registration.activeMatch?.code && event.code === registration.activeMatch.code) return true;
|
|
333
|
-
if (parsed.code !== void 0) {
|
|
334
|
-
if (event.code === parsed.code) return true;
|
|
335
|
-
} else {
|
|
336
|
-
const parsedKeyNormalized = parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key;
|
|
337
|
-
if ((releasedKey.length === 1 ? releasedKey.toUpperCase() : releasedKey) === parsedKeyNormalized) return true;
|
|
338
|
-
}
|
|
339
|
-
if (parsed.ctrl && releasedKey === "Control") return true;
|
|
340
|
-
if (parsed.shift && releasedKey === "Shift") return true;
|
|
341
|
-
if (parsed.alt && releasedKey === "Alt") return true;
|
|
342
|
-
if (parsed.meta && releasedKey === "Meta") return true;
|
|
343
|
-
return false;
|
|
344
|
-
}
|
|
345
|
-
/**
|
|
346
|
-
* Triggers a registration's callback programmatically from devtools.
|
|
347
|
-
* Creates a synthetic KeyboardEvent and invokes the callback.
|
|
348
|
-
*
|
|
349
|
-
* @param id - The registration ID to trigger
|
|
350
|
-
* @returns True if the registration was found and triggered
|
|
351
|
-
*/
|
|
352
|
-
triggerRegistration(id) {
|
|
353
|
-
const registration = this.registrations.state.get(id);
|
|
354
|
-
if (!registration) return false;
|
|
355
|
-
const parsed = registration.parsedHotkey;
|
|
356
|
-
const syntheticEvent = new KeyboardEvent(registration.options.eventType ?? "keydown", {
|
|
357
|
-
...parsed.code !== void 0 ? { code: parsed.code } : { key: parsed.key },
|
|
358
|
-
ctrlKey: parsed.ctrl,
|
|
359
|
-
shiftKey: parsed.shift,
|
|
360
|
-
altKey: parsed.alt,
|
|
361
|
-
metaKey: parsed.meta,
|
|
362
|
-
bubbles: true,
|
|
363
|
-
cancelable: true
|
|
364
|
-
});
|
|
365
|
-
registration.triggerCount++;
|
|
366
|
-
this.registrations.setState((prev) => new Map(prev));
|
|
367
|
-
registration.callback(syntheticEvent, {
|
|
368
|
-
hotkey: registration.hotkey,
|
|
369
|
-
parsedHotkey: registration.parsedHotkey
|
|
370
|
-
});
|
|
371
|
-
return true;
|
|
372
|
-
}
|
|
373
|
-
/**
|
|
374
|
-
* Gets the number of registered hotkeys.
|
|
375
|
-
*/
|
|
376
|
-
getRegistrationCount() {
|
|
377
|
-
return this.registrations.state.size;
|
|
378
|
-
}
|
|
379
|
-
/**
|
|
380
|
-
* Checks if a specific hotkey is registered.
|
|
381
|
-
*
|
|
382
|
-
* @param hotkey - The hotkey string to check
|
|
383
|
-
* @param target - Optional target element to match (if provided, both hotkey and target must match)
|
|
384
|
-
* @returns True if a matching registration exists
|
|
385
|
-
*/
|
|
386
|
-
isRegistered(hotkey, target) {
|
|
387
|
-
for (const registration of this.registrations.state.values()) if (require_match.areHotkeysEqual(registration.hotkey, hotkey, registration.options.platform)) {
|
|
388
|
-
if (target === void 0 || registration.target === target) return true;
|
|
389
|
-
}
|
|
390
|
-
return false;
|
|
391
|
-
}
|
|
392
|
-
/**
|
|
393
|
-
* Destroys the manager and removes all listeners.
|
|
394
|
-
*/
|
|
395
|
-
destroy() {
|
|
396
|
-
for (const target of this.#targetListeners.keys()) this.#removeListenersForTarget(target);
|
|
397
|
-
this.registrations.setState(() => /* @__PURE__ */ new Map());
|
|
398
|
-
this.#targetListeners.clear();
|
|
399
|
-
this.#targetRegistrations.clear();
|
|
400
|
-
}
|
|
401
|
-
};
|
|
402
|
-
/**
|
|
403
|
-
* Gets the singleton HotkeyManager instance.
|
|
404
|
-
* Convenience function for accessing the manager.
|
|
405
|
-
*/
|
|
406
|
-
function getHotkeyManager() {
|
|
407
|
-
return HotkeyManager.getInstance();
|
|
408
|
-
}
|
|
409
|
-
|
|
410
|
-
//#endregion
|
|
411
|
-
exports.HotkeyManager = HotkeyManager;
|
|
412
|
-
exports.getHotkeyManager = getHotkeyManager;
|
|
413
|
-
exports.toHotkeyRegistrationView = toHotkeyRegistrationView;
|
|
414
|
-
//# sourceMappingURL=hotkey-manager.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"hotkey-manager.cjs","names":["#instance","Store","#platform","detectPlatform","parseHotkey","rawHotkeyToParsedHotkey","formatHotkey","#findConflictingRegistration","#unregister","getDefaultIgnoreInputs","defaultHotkeyOptions","#targetRegistrations","#ensureListenersForTarget","optionsEqual","#removeListenersForTarget","#targetListeners","#createTargetKeyDownHandler","#createTargetKeyUpHandler","#shouldResetRegistration","isRecordingEvent","isEventForTarget","shouldIgnoreInputEvent","matchKeyboardEvent","#executeHotkeyCallback","#processTargetEvent","areHotkeysEqual","normalizeKeyName"],"sources":["../src/hotkey-manager.ts"],"sourcesContent":["import { Store } from '@tanstack/store'\nimport { isRecordingEvent } from './_recording-guard'\nimport { areHotkeysEqual } from './match'\nimport { detectPlatform } from './platform'\nimport { normalizeKeyName } from './constants'\nimport { formatHotkey } from './format'\nimport { parseHotkey, rawHotkeyToParsedHotkey } from './parse'\nimport { matchKeyboardEvent } from './_match'\nimport {\n defaultHotkeyOptions,\n getDefaultIgnoreInputs,\n handleConflict,\n optionsEqual,\n} from './_registration'\nimport { isEventForTarget, shouldIgnoreInputEvent } from './_event-target'\nimport type {\n ConflictBehavior,\n Hotkey,\n HotkeyCallback,\n HotkeyCallbackContext,\n HotkeyMeta,\n ParsedHotkey,\n RegisterableHotkey,\n} from './hotkey.types'\n\nexport type { ConflictBehavior }\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 /**\n * Soft-disable: when `false`, the callback does not run but the registration\n * stays in `HotkeyManager` (and in devtools). Toggling this should update the\n * existing handle via `setOptions` rather than unregistering. Defaults to `true`.\n */\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 /** Optional metadata (name, description, custom fields via declaration merging) */\n meta?: HotkeyMeta\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 concrete key/code that activated a requireReset registration. */\n activeMatch?: { key: string; code: string }\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 * Public view of a hotkey registration for display and introspection.\n * Omits the callback function which is an internal implementation detail.\n */\nexport interface HotkeyRegistrationView {\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 /** Whether this registration has fired and needs reset (for requireReset) */\n hasFired: boolean\n}\n\n/**\n * Creates a public view from an internal registration,\n * stripping the callback function.\n */\nexport function toHotkeyRegistrationView(\n reg: HotkeyRegistration,\n): HotkeyRegistrationView {\n return {\n hotkey: reg.hotkey,\n id: reg.id,\n options: reg.options,\n parsedHotkey: reg.parsedHotkey,\n target: reg.target,\n triggerCount: reg.triggerCount,\n hasFired: reg.hasFired,\n }\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\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 * 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 // In SSR environments, return a no-op handle since there's no DOM to attach listeners to\n if (typeof document === 'undefined' && !options.target) {\n let currentCallback = callback\n return {\n id: generateId(),\n unregister: () => {},\n get callback() {\n return currentCallback\n },\n set callback(newCallback: HotkeyCallback) {\n currentCallback = newCallback\n },\n setOptions: () => {},\n get isActive() {\n return false\n },\n }\n }\n\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\n // Note: SSR case without explicit target is handled above\n const target = options.target ?? 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 handleConflict(\n conflictingRegistration.id,\n hotkeyStr,\n conflictBehavior,\n (id) => this.#unregister(id),\n )\n }\n\n const resolvedIgnoreInputs =\n options.ignoreInputs ?? getDefaultIgnoreInputs(parsedHotkey)\n\n const baseOptions = {\n ...defaultHotkeyOptions,\n requireReset: false,\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 (\n reg &&\n !optionsEqual(reg.options, { ...reg.options, ...newOptions })\n ) {\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 // Releases clear latches even when focus or enabled state now prevents callbacks.\n if (eventType === 'keyup') {\n for (const id of this.#targetRegistrations.get(target) ?? []) {\n const registration = this.registrations.state.get(id)\n if (\n registration?.hasFired &&\n this.#shouldResetRegistration(registration, event)\n ) {\n registration.hasFired = false\n registration.activeMatch = undefined\n }\n }\n }\n if (isRecordingEvent(event)) return\n const targetRegs = this.#targetRegistrations.get(target)\n if (!targetRegs) {\n return\n }\n\n const matches = new Map<string, ReturnType<typeof matchKeyboardEvent>>()\n let bestScore = 0\n\n // Exact logical/explicit-code matches outrank compatibility fallbacks.\n for (const id of targetRegs) {\n const registration = this.registrations.state.get(id)\n if (\n !registration ||\n !registration.options.enabled ||\n registration.options.eventType !== eventType ||\n !isEventForTarget(event, target) ||\n (registration.options.ignoreInputs !== false &&\n shouldIgnoreInputEvent(event, target, registration.target))\n ) {\n continue\n }\n const result = matchKeyboardEvent(\n event,\n registration.parsedHotkey,\n registration.options.platform,\n )\n if (result.matched) {\n matches.set(id, result)\n bestScore = Math.max(bestScore, result.score)\n }\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 (!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 (shouldIgnoreInputEvent(event, target, registration.target)) {\n continue\n }\n }\n\n // Handle keydown events\n if (eventType === 'keydown') {\n if (registration.options.eventType !== 'keydown') {\n continue\n }\n\n const match = matches.get(id)\n\n if (match?.matched && match.score === bestScore) {\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 registration.activeMatch = match.identity\n }\n }\n }\n }\n // Handle keyup events\n else {\n if (registration.options.eventType === 'keyup') {\n const match = matches.get(id)\n if (match?.matched && match.score === bestScore) {\n this.#executeHotkeyCallback(registration, event)\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 * 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 (\n areHotkeysEqual(\n registration.hotkey,\n hotkey,\n registration.options.platform,\n ) &&\n registration.target === target\n ) {\n return registration\n }\n }\n return null\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 if (\n registration.activeMatch?.code &&\n event.code === registration.activeMatch.code\n ) {\n return true\n }\n\n // Compare the release against the identity this binding actually stores.\n if (parsed.code !== undefined) {\n if (event.code === parsed.code) return true\n } else {\n const parsedKeyNormalized =\n parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key\n const releasedKeyNormalized =\n releasedKey.length === 1 ? releasedKey.toUpperCase() : releasedKey\n if (releasedKeyNormalized === parsedKeyNormalized) 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 ...(parsed.code !== undefined\n ? { code: parsed.code }\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 (\n areHotkeysEqual(\n registration.hotkey,\n hotkey,\n registration.options.platform,\n )\n ) {\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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"}
|