keyborg 2.326.0-canary.0 → 3.0.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/esm/index.js DELETED
@@ -1,474 +0,0 @@
1
- // src/WeakRefInstance.ts
2
- var _canUseWeakRef = typeof WeakRef !== "undefined";
3
- var WeakRefInstance = class {
4
- constructor(instance) {
5
- if (_canUseWeakRef && typeof instance === "object") {
6
- this._weakRef = new WeakRef(instance);
7
- } else {
8
- this._instance = instance;
9
- }
10
- }
11
- /**
12
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef/deref}
13
- */
14
- deref() {
15
- var _a, _b;
16
- let instance;
17
- if (this._weakRef) {
18
- instance = (_a = this._weakRef) == null ? void 0 : _a.deref();
19
- if (!instance) {
20
- delete this._weakRef;
21
- }
22
- } else {
23
- instance = this._instance;
24
- if ((_b = instance == null ? void 0 : instance.isDisposed) == null ? void 0 : _b.call(instance)) {
25
- delete this._instance;
26
- }
27
- }
28
- return instance;
29
- }
30
- };
31
-
32
- // src/FocusEvent.ts
33
- var KEYBORG_FOCUSIN = "keyborg:focusin";
34
- var KEYBORG_FOCUSOUT = "keyborg:focusout";
35
- function canOverrideNativeFocus(win) {
36
- const HTMLElement = win.HTMLElement;
37
- const origFocus = HTMLElement.prototype.focus;
38
- let isCustomFocusCalled = false;
39
- HTMLElement.prototype.focus = function focus() {
40
- isCustomFocusCalled = true;
41
- };
42
- const btn = win.document.createElement("button");
43
- btn.focus();
44
- HTMLElement.prototype.focus = origFocus;
45
- return isCustomFocusCalled;
46
- }
47
- var _canOverrideNativeFocus = false;
48
- function nativeFocus(element) {
49
- const focus = element.focus;
50
- if (focus.__keyborgNativeFocus) {
51
- focus.__keyborgNativeFocus.call(element);
52
- } else {
53
- element.focus();
54
- }
55
- }
56
- function setupFocusEvent(win) {
57
- const kwin = win;
58
- if (!_canOverrideNativeFocus) {
59
- _canOverrideNativeFocus = canOverrideNativeFocus(kwin);
60
- }
61
- const origFocus = kwin.HTMLElement.prototype.focus;
62
- if (origFocus.__keyborgNativeFocus) {
63
- return;
64
- }
65
- kwin.HTMLElement.prototype.focus = focus;
66
- const shadowTargets = /* @__PURE__ */ new Set();
67
- const focusOutHandler = (e) => {
68
- const target = e.target;
69
- if (!target) {
70
- return;
71
- }
72
- const event = new CustomEvent(KEYBORG_FOCUSOUT, {
73
- cancelable: true,
74
- bubbles: true,
75
- // Allows the event to bubble past an open shadow root
76
- composed: true,
77
- detail: {
78
- originalEvent: e
79
- }
80
- });
81
- target.dispatchEvent(event);
82
- };
83
- const focusInHandler = (e) => {
84
- const target = e.target;
85
- if (!target) {
86
- return;
87
- }
88
- let node = e.composedPath()[0];
89
- const currentShadows = /* @__PURE__ */ new Set();
90
- while (node) {
91
- if (node.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
92
- currentShadows.add(node);
93
- node = node.host;
94
- } else {
95
- node = node.parentNode;
96
- }
97
- }
98
- for (const shadowRootWeakRef of shadowTargets) {
99
- const shadowRoot = shadowRootWeakRef.deref();
100
- if (!shadowRoot || !currentShadows.has(shadowRoot)) {
101
- shadowTargets.delete(shadowRootWeakRef);
102
- if (shadowRoot) {
103
- shadowRoot.removeEventListener("focusin", focusInHandler, true);
104
- shadowRoot.removeEventListener("focusout", focusOutHandler, true);
105
- }
106
- }
107
- }
108
- onFocusIn(target, e.relatedTarget || void 0);
109
- };
110
- const onFocusIn = (target, relatedTarget, originalEvent) => {
111
- var _a;
112
- const shadowRoot = target.shadowRoot;
113
- if (shadowRoot) {
114
- for (const shadowRootWeakRef of shadowTargets) {
115
- if (shadowRootWeakRef.deref() === shadowRoot) {
116
- return;
117
- }
118
- }
119
- shadowRoot.addEventListener("focusin", focusInHandler, true);
120
- shadowRoot.addEventListener("focusout", focusOutHandler, true);
121
- shadowTargets.add(new WeakRefInstance(shadowRoot));
122
- return;
123
- }
124
- const details = {
125
- relatedTarget,
126
- originalEvent
127
- };
128
- const event = new CustomEvent(KEYBORG_FOCUSIN, {
129
- cancelable: true,
130
- bubbles: true,
131
- // Allows the event to bubble past an open shadow root
132
- composed: true,
133
- detail: details
134
- });
135
- event.details = details;
136
- if (_canOverrideNativeFocus || data.lastFocusedProgrammatically) {
137
- details.isFocusedProgrammatically = target === ((_a = data.lastFocusedProgrammatically) == null ? void 0 : _a.deref());
138
- data.lastFocusedProgrammatically = void 0;
139
- }
140
- target.dispatchEvent(event);
141
- };
142
- const data = kwin.__keyborgData = {
143
- focusInHandler,
144
- focusOutHandler,
145
- shadowTargets
146
- };
147
- kwin.document.addEventListener(
148
- "focusin",
149
- kwin.__keyborgData.focusInHandler,
150
- true
151
- );
152
- kwin.document.addEventListener(
153
- "focusout",
154
- kwin.__keyborgData.focusOutHandler,
155
- true
156
- );
157
- function focus() {
158
- const keyborgNativeFocusEvent = kwin.__keyborgData;
159
- if (keyborgNativeFocusEvent) {
160
- keyborgNativeFocusEvent.lastFocusedProgrammatically = new WeakRefInstance(
161
- this
162
- );
163
- }
164
- return origFocus.apply(this, arguments);
165
- }
166
- let activeElement = kwin.document.activeElement;
167
- while (activeElement && activeElement.shadowRoot) {
168
- onFocusIn(activeElement);
169
- activeElement = activeElement.shadowRoot.activeElement;
170
- }
171
- focus.__keyborgNativeFocus = origFocus;
172
- }
173
- function disposeFocusEvent(win) {
174
- const kwin = win;
175
- const proto = kwin.HTMLElement.prototype;
176
- const origFocus = proto.focus.__keyborgNativeFocus;
177
- const keyborgNativeFocusEvent = kwin.__keyborgData;
178
- if (keyborgNativeFocusEvent) {
179
- kwin.document.removeEventListener(
180
- "focusin",
181
- keyborgNativeFocusEvent.focusInHandler,
182
- true
183
- );
184
- kwin.document.removeEventListener(
185
- "focusout",
186
- keyborgNativeFocusEvent.focusOutHandler,
187
- true
188
- );
189
- for (const shadowRootWeakRef of keyborgNativeFocusEvent.shadowTargets) {
190
- const shadowRoot = shadowRootWeakRef.deref();
191
- if (shadowRoot) {
192
- shadowRoot.removeEventListener(
193
- "focusin",
194
- keyborgNativeFocusEvent.focusInHandler,
195
- true
196
- );
197
- shadowRoot.removeEventListener(
198
- "focusout",
199
- keyborgNativeFocusEvent.focusOutHandler,
200
- true
201
- );
202
- }
203
- }
204
- keyborgNativeFocusEvent.shadowTargets.clear();
205
- delete kwin.__keyborgData;
206
- }
207
- if (origFocus) {
208
- proto.focus = origFocus;
209
- }
210
- }
211
- function getLastFocusedProgrammatically(win) {
212
- var _a;
213
- const keyborgNativeFocusEvent = win.__keyborgData;
214
- return keyborgNativeFocusEvent ? ((_a = keyborgNativeFocusEvent.lastFocusedProgrammatically) == null ? void 0 : _a.deref()) || null : void 0;
215
- }
216
-
217
- // src/Keyborg.ts
218
- var _dismissTimeout = 500;
219
- var _lastId = 0;
220
- var KeyborgCore = class {
221
- constructor(win, props) {
222
- this._isNavigatingWithKeyboard_DO_NOT_USE = false;
223
- this._onFocusIn = (e) => {
224
- if (this._isMouseOrTouchUsedTimer) {
225
- return;
226
- }
227
- if (this.isNavigatingWithKeyboard) {
228
- return;
229
- }
230
- const details = e.detail;
231
- if (!details.relatedTarget) {
232
- return;
233
- }
234
- if (details.isFocusedProgrammatically || details.isFocusedProgrammatically === void 0) {
235
- return;
236
- }
237
- this.isNavigatingWithKeyboard = true;
238
- };
239
- this._onMouseDown = (e) => {
240
- if (e.buttons === 0 || e.clientX === 0 && e.clientY === 0 && e.screenX === 0 && e.screenY === 0) {
241
- return;
242
- }
243
- this._onMouseOrTouch();
244
- };
245
- this._onMouseOrTouch = () => {
246
- const win = this._win;
247
- if (win) {
248
- if (this._isMouseOrTouchUsedTimer) {
249
- win.clearTimeout(this._isMouseOrTouchUsedTimer);
250
- }
251
- this._isMouseOrTouchUsedTimer = win.setTimeout(() => {
252
- delete this._isMouseOrTouchUsedTimer;
253
- }, 1e3);
254
- }
255
- this.isNavigatingWithKeyboard = false;
256
- };
257
- this._onKeyDown = (e) => {
258
- const isNavigatingWithKeyboard = this.isNavigatingWithKeyboard;
259
- if (isNavigatingWithKeyboard) {
260
- if (this._shouldDismissKeyboardNavigation(e)) {
261
- this._scheduleDismiss();
262
- }
263
- } else {
264
- if (this._shouldTriggerKeyboardNavigation(e)) {
265
- this.isNavigatingWithKeyboard = true;
266
- }
267
- }
268
- };
269
- this.id = "c" + ++_lastId;
270
- this._win = win;
271
- const doc = win.document;
272
- if (props) {
273
- const triggerKeys = props.triggerKeys;
274
- const dismissKeys = props.dismissKeys;
275
- if (triggerKeys == null ? void 0 : triggerKeys.length) {
276
- this._triggerKeys = new Set(triggerKeys);
277
- }
278
- if (dismissKeys == null ? void 0 : dismissKeys.length) {
279
- this._dismissKeys = new Set(dismissKeys);
280
- }
281
- }
282
- doc.addEventListener(KEYBORG_FOCUSIN, this._onFocusIn, true);
283
- doc.addEventListener("mousedown", this._onMouseDown, true);
284
- win.addEventListener("keydown", this._onKeyDown, true);
285
- doc.addEventListener("touchstart", this._onMouseOrTouch, true);
286
- doc.addEventListener("touchend", this._onMouseOrTouch, true);
287
- doc.addEventListener("touchcancel", this._onMouseOrTouch, true);
288
- setupFocusEvent(win);
289
- }
290
- get isNavigatingWithKeyboard() {
291
- return this._isNavigatingWithKeyboard_DO_NOT_USE;
292
- }
293
- set isNavigatingWithKeyboard(val) {
294
- if (this._isNavigatingWithKeyboard_DO_NOT_USE !== val) {
295
- this._isNavigatingWithKeyboard_DO_NOT_USE = val;
296
- this.update();
297
- }
298
- }
299
- dispose() {
300
- const win = this._win;
301
- if (win) {
302
- if (this._isMouseOrTouchUsedTimer) {
303
- win.clearTimeout(this._isMouseOrTouchUsedTimer);
304
- this._isMouseOrTouchUsedTimer = void 0;
305
- }
306
- if (this._dismissTimer) {
307
- win.clearTimeout(this._dismissTimer);
308
- this._dismissTimer = void 0;
309
- }
310
- disposeFocusEvent(win);
311
- const doc = win.document;
312
- doc.removeEventListener(KEYBORG_FOCUSIN, this._onFocusIn, true);
313
- doc.removeEventListener("mousedown", this._onMouseDown, true);
314
- win.removeEventListener("keydown", this._onKeyDown, true);
315
- doc.removeEventListener("touchstart", this._onMouseOrTouch, true);
316
- doc.removeEventListener("touchend", this._onMouseOrTouch, true);
317
- doc.removeEventListener("touchcancel", this._onMouseOrTouch, true);
318
- delete this._win;
319
- }
320
- }
321
- isDisposed() {
322
- return !!this._win;
323
- }
324
- /**
325
- * Updates all keyborg instances with the keyboard navigation state
326
- */
327
- update() {
328
- var _a, _b;
329
- const keyborgs = (_b = (_a = this._win) == null ? void 0 : _a.__keyborg) == null ? void 0 : _b.refs;
330
- if (keyborgs) {
331
- for (const id of Object.keys(keyborgs)) {
332
- Keyborg.update(keyborgs[id], this.isNavigatingWithKeyboard);
333
- }
334
- }
335
- }
336
- /**
337
- * @returns whether the keyboard event should trigger keyboard navigation mode
338
- */
339
- _shouldTriggerKeyboardNavigation(e) {
340
- var _a;
341
- if (e.key === "Tab") {
342
- return true;
343
- }
344
- const activeElement = (_a = this._win) == null ? void 0 : _a.document.activeElement;
345
- const isTriggerKey = !this._triggerKeys || this._triggerKeys.has(e.keyCode);
346
- const isEditable = activeElement && (activeElement.tagName === "INPUT" || activeElement.tagName === "TEXTAREA" || activeElement.isContentEditable);
347
- return isTriggerKey && !isEditable;
348
- }
349
- /**
350
- * @returns whether the keyboard event should dismiss keyboard navigation mode
351
- */
352
- _shouldDismissKeyboardNavigation(e) {
353
- var _a;
354
- return (_a = this._dismissKeys) == null ? void 0 : _a.has(e.keyCode);
355
- }
356
- _scheduleDismiss() {
357
- const win = this._win;
358
- if (win) {
359
- if (this._dismissTimer) {
360
- win.clearTimeout(this._dismissTimer);
361
- this._dismissTimer = void 0;
362
- }
363
- const was = win.document.activeElement;
364
- this._dismissTimer = win.setTimeout(() => {
365
- this._dismissTimer = void 0;
366
- const cur = win.document.activeElement;
367
- if (was && cur && was === cur) {
368
- this.isNavigatingWithKeyboard = false;
369
- }
370
- }, _dismissTimeout);
371
- }
372
- }
373
- };
374
- var Keyborg = class _Keyborg {
375
- constructor(win, props) {
376
- this._cb = [];
377
- this._id = "k" + ++_lastId;
378
- this._win = win;
379
- const current = win.__keyborg;
380
- if (current) {
381
- this._core = current.core;
382
- current.refs[this._id] = this;
383
- } else {
384
- this._core = new KeyborgCore(win, props);
385
- win.__keyborg = {
386
- core: this._core,
387
- refs: { [this._id]: this }
388
- };
389
- }
390
- }
391
- static create(win, props) {
392
- return new _Keyborg(win, props);
393
- }
394
- static dispose(instance) {
395
- instance.dispose();
396
- }
397
- /**
398
- * Updates all subscribed callbacks with the keyboard navigation state
399
- */
400
- static update(instance, isNavigatingWithKeyboard) {
401
- instance._cb.forEach((callback) => callback(isNavigatingWithKeyboard));
402
- }
403
- dispose() {
404
- var _a;
405
- const current = (_a = this._win) == null ? void 0 : _a.__keyborg;
406
- if (current == null ? void 0 : current.refs[this._id]) {
407
- delete current.refs[this._id];
408
- if (Object.keys(current.refs).length === 0) {
409
- current.core.dispose();
410
- delete this._win.__keyborg;
411
- }
412
- } else if (process.env.NODE_ENV !== "production") {
413
- console.error(
414
- `Keyborg instance ${this._id} is being disposed incorrectly.`
415
- );
416
- }
417
- this._cb = [];
418
- delete this._core;
419
- delete this._win;
420
- }
421
- /**
422
- * @returns Whether the user is navigating with keyboard
423
- */
424
- isNavigatingWithKeyboard() {
425
- var _a;
426
- return !!((_a = this._core) == null ? void 0 : _a.isNavigatingWithKeyboard);
427
- }
428
- /**
429
- * @param callback - Called when the keyboard navigation state changes
430
- */
431
- subscribe(callback) {
432
- this._cb.push(callback);
433
- }
434
- /**
435
- * @param callback - Registered with subscribe
436
- */
437
- unsubscribe(callback) {
438
- const index = this._cb.indexOf(callback);
439
- if (index >= 0) {
440
- this._cb.splice(index, 1);
441
- }
442
- }
443
- /**
444
- * Manually set the keyboard navigtion state
445
- */
446
- setVal(isNavigatingWithKeyboard) {
447
- if (this._core) {
448
- this._core.isNavigatingWithKeyboard = isNavigatingWithKeyboard;
449
- }
450
- }
451
- };
452
- function createKeyborg(win, props) {
453
- return Keyborg.create(win, props);
454
- }
455
- function disposeKeyborg(instance) {
456
- Keyborg.dispose(instance);
457
- }
458
-
459
- // src/index.ts
460
- var version = "2.326.0-canary.0";
461
- export {
462
- KEYBORG_FOCUSIN,
463
- KEYBORG_FOCUSOUT,
464
- createKeyborg,
465
- disposeKeyborg,
466
- getLastFocusedProgrammatically,
467
- nativeFocus,
468
- version
469
- };
470
- /*!
471
- * Copyright (c) Microsoft Corporation. All rights reserved.
472
- * Licensed under the MIT License.
473
- */
474
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/WeakRefInstance.ts","../../src/FocusEvent.ts","../../src/Keyborg.ts","../../src/index.ts"],"sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// IE11 compat, checks if WeakRef is supported\nexport const _canUseWeakRef = typeof WeakRef !== \"undefined\";\n\n/**\n * Allows disposable instances to be used\n */\nexport interface Disposable {\n isDisposed?(): boolean;\n}\n\n/**\n * WeakRef wrapper around a HTMLElement that also supports IE11\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef}\n * @internal\n */\nexport class WeakRefInstance<T extends Disposable | object> {\n private _weakRef?: WeakRef<T>;\n private _instance?: T;\n\n constructor(instance: T) {\n if (_canUseWeakRef && typeof instance === \"object\") {\n this._weakRef = new WeakRef(instance);\n } else {\n this._instance = instance;\n }\n }\n\n /**\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef/deref}\n */\n deref(): T | undefined {\n let instance: T | undefined;\n\n if (this._weakRef) {\n instance = this._weakRef?.deref();\n\n if (!instance) {\n delete this._weakRef;\n }\n } else {\n instance = this._instance;\n if ((instance as Disposable)?.isDisposed?.()) {\n delete this._instance;\n }\n }\n\n return instance;\n }\n}\n","/*!\n * Copyright (c) Microsoft Corporation. All rights reserved.\n * Licensed under the MIT License.\n */\nimport { WeakRefInstance } from \"./WeakRefInstance\";\n\nexport const KEYBORG_FOCUSIN = \"keyborg:focusin\";\nexport const KEYBORG_FOCUSOUT = \"keyborg:focusout\";\n\ninterface KeyborgFocus {\n /**\n * This is the native `focus` function that is retained so that it can be restored when keyborg is disposed\n */\n __keyborgNativeFocus?: (options?: FocusOptions | undefined) => void;\n}\n\ninterface KeyborgFocusEventData {\n focusInHandler: (e: FocusEvent) => void;\n focusOutHandler: (e: FocusEvent) => void;\n lastFocusedProgrammatically?: WeakRefInstance<HTMLElement>;\n shadowTargets: Set<WeakRefInstance<ShadowRoot>>;\n}\n\n/**\n * Extends the global window with keyborg focus event data\n */\ninterface WindowWithKeyborgFocusEvent extends Window {\n HTMLElement: typeof HTMLElement;\n __keyborgData?: KeyborgFocusEventData;\n}\n\nfunction canOverrideNativeFocus(win: Window): boolean {\n const HTMLElement = (win as WindowWithKeyborgFocusEvent).HTMLElement;\n const origFocus = HTMLElement.prototype.focus;\n\n let isCustomFocusCalled = false;\n\n HTMLElement.prototype.focus = function focus(): void {\n isCustomFocusCalled = true;\n };\n\n const btn = win.document.createElement(\"button\");\n\n btn.focus();\n\n HTMLElement.prototype.focus = origFocus;\n\n return isCustomFocusCalled;\n}\n\nlet _canOverrideNativeFocus = false;\n\nexport interface KeyborgFocusInEventDetails {\n relatedTarget?: HTMLElement;\n isFocusedProgrammatically?: boolean;\n originalEvent?: FocusEvent;\n}\n\nexport interface KeyborgFocusInEvent\n extends CustomEvent<KeyborgFocusInEventDetails> {\n /**\n * @deprecated - used `event.detail`\n */\n details?: KeyborgFocusInEventDetails;\n}\n\nexport interface KeyborgFocusOutEventDetails {\n originalEvent: FocusEvent;\n}\n\nexport type KeyborgFocusOutEvent = CustomEvent<KeyborgFocusOutEventDetails>;\n\n/**\n * Guarantees that the native `focus` will be used\n */\nexport function nativeFocus(element: HTMLElement): void {\n const focus = element.focus as KeyborgFocus;\n\n if (focus.__keyborgNativeFocus) {\n focus.__keyborgNativeFocus.call(element);\n } else {\n element.focus();\n }\n}\n\n/**\n * Overrides the native `focus` and setups the keyborg focus event\n */\nexport function setupFocusEvent(win: Window): void {\n const kwin = win as WindowWithKeyborgFocusEvent;\n\n if (!_canOverrideNativeFocus) {\n _canOverrideNativeFocus = canOverrideNativeFocus(kwin);\n }\n\n const origFocus = kwin.HTMLElement.prototype.focus;\n\n if ((origFocus as KeyborgFocus).__keyborgNativeFocus) {\n // Already set up.\n return;\n }\n\n kwin.HTMLElement.prototype.focus = focus;\n\n const shadowTargets: Set<WeakRefInstance<ShadowRoot>> = new Set();\n\n const focusOutHandler = (e: FocusEvent) => {\n const target = e.target as HTMLElement;\n\n if (!target) {\n return;\n }\n\n const event: KeyborgFocusOutEvent = new CustomEvent(KEYBORG_FOCUSOUT, {\n cancelable: true,\n bubbles: true,\n // Allows the event to bubble past an open shadow root\n composed: true,\n detail: {\n originalEvent: e,\n },\n });\n\n target.dispatchEvent(event);\n };\n\n const focusInHandler = (e: FocusEvent) => {\n const target = e.target as HTMLElement;\n\n if (!target) {\n return;\n }\n\n let node: Node | null | undefined = e.composedPath()[0] as\n | Node\n | null\n | undefined;\n\n const currentShadows: Set<ShadowRoot> = new Set();\n\n while (node) {\n if (node.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {\n currentShadows.add(node as ShadowRoot);\n node = (node as ShadowRoot).host;\n } else {\n node = node.parentNode;\n }\n }\n\n for (const shadowRootWeakRef of shadowTargets) {\n const shadowRoot = shadowRootWeakRef.deref();\n\n if (!shadowRoot || !currentShadows.has(shadowRoot)) {\n shadowTargets.delete(shadowRootWeakRef);\n\n if (shadowRoot) {\n shadowRoot.removeEventListener(\"focusin\", focusInHandler, true);\n shadowRoot.removeEventListener(\"focusout\", focusOutHandler, true);\n }\n }\n }\n\n onFocusIn(target, (e.relatedTarget as HTMLElement | null) || undefined);\n };\n\n const onFocusIn = (\n target: Element,\n relatedTarget?: HTMLElement,\n originalEvent?: FocusEvent,\n ) => {\n const shadowRoot = target.shadowRoot;\n\n if (shadowRoot) {\n /**\n * https://bugs.chromium.org/p/chromium/issues/detail?id=1512028\n * focusin events don't bubble up through an open shadow root once focus is inside\n * once focus moves into a shadow root - we drop the same focusin handler there\n * keyborg's custom event will still bubble up since it is composed\n * event handlers should be cleaned up once focus leaves the shadow root.\n *\n * When a focusin event is dispatched from a shadow root, its target is the shadow root parent.\n * Each shadow root encounter requires a new capture listener.\n * Why capture? - we want to follow the focus event in order or descending nested shadow roots\n * When there are no more shadow root targets - dispatch the keyborg:focusin event\n *\n * 1. no focus event\n * > document - capture listener ✅\n * > shadow root 1\n * > shadow root 2\n * > shadow root 3\n * > focused element\n *\n * 2. focus event received by document listener\n * > document - capture listener ✅ (focus event here)\n * > shadow root 1 - capture listener ✅\n * > shadow root 2\n * > shadow root 3\n * > focused element\n\n * 3. focus event received by root l1 listener\n * > document - capture listener ✅\n * > shadow root 1 - capture listener ✅ (focus event here)\n * > shadow root 2 - capture listener ✅\n * > shadow root 3\n * > focused element\n *\n * 4. focus event received by root l2 listener\n * > document - capture listener ✅\n * > shadow root 1 - capture listener ✅\n * > shadow root 2 - capture listener ✅ (focus event here)\n * > shadow root 3 - capture listener ✅\n * > focused element\n *\n * 5. focus event received by root l3 listener, no more shadow root targets\n * > document - capture listener ✅\n * > shadow root 1 - capture listener ✅\n * > shadow root 2 - capture listener ✅\n * > shadow root 3 - capture listener ✅ (focus event here)\n * > focused element ✅ (no shadow root - dispatch keyborg event)\n */\n\n for (const shadowRootWeakRef of shadowTargets) {\n if (shadowRootWeakRef.deref() === shadowRoot) {\n return;\n }\n }\n\n shadowRoot.addEventListener(\"focusin\", focusInHandler, true);\n shadowRoot.addEventListener(\"focusout\", focusOutHandler, true);\n\n shadowTargets.add(new WeakRefInstance(shadowRoot));\n\n return;\n }\n\n const details: KeyborgFocusInEventDetails = {\n relatedTarget,\n originalEvent,\n };\n\n const event: KeyborgFocusInEvent = new CustomEvent(KEYBORG_FOCUSIN, {\n cancelable: true,\n bubbles: true,\n // Allows the event to bubble past an open shadow root\n composed: true,\n detail: details,\n });\n\n // Tabster (and other users) can still use the legacy details field - keeping for backwards compat\n event.details = details;\n\n if (_canOverrideNativeFocus || data.lastFocusedProgrammatically) {\n details.isFocusedProgrammatically =\n target === data.lastFocusedProgrammatically?.deref();\n\n data.lastFocusedProgrammatically = undefined;\n }\n\n target.dispatchEvent(event);\n };\n\n const data: KeyborgFocusEventData = (kwin.__keyborgData = {\n focusInHandler,\n focusOutHandler,\n shadowTargets,\n });\n\n kwin.document.addEventListener(\n \"focusin\",\n kwin.__keyborgData.focusInHandler,\n true,\n );\n\n kwin.document.addEventListener(\n \"focusout\",\n kwin.__keyborgData.focusOutHandler,\n true,\n );\n\n function focus(this: HTMLElement) {\n const keyborgNativeFocusEvent = (kwin as WindowWithKeyborgFocusEvent)\n .__keyborgData;\n\n if (keyborgNativeFocusEvent) {\n keyborgNativeFocusEvent.lastFocusedProgrammatically = new WeakRefInstance(\n this,\n );\n }\n\n // eslint-disable-next-line prefer-rest-params\n return origFocus.apply(this, arguments);\n }\n\n let activeElement = kwin.document.activeElement as Element | null;\n\n // If keyborg is created with the focus inside shadow root, we need\n // to go through the shadows up to make sure all relevant shadows\n // have focus handlers attached.\n while (activeElement && activeElement.shadowRoot) {\n onFocusIn(activeElement);\n activeElement = activeElement.shadowRoot.activeElement;\n }\n\n (focus as KeyborgFocus).__keyborgNativeFocus = origFocus;\n}\n\n/**\n * Removes keyborg event listeners and custom focus override\n * @param win The window that stores keyborg focus events\n */\nexport function disposeFocusEvent(win: Window): void {\n const kwin = win as WindowWithKeyborgFocusEvent;\n const proto = kwin.HTMLElement.prototype;\n const origFocus = (proto.focus as KeyborgFocus).__keyborgNativeFocus;\n const keyborgNativeFocusEvent = kwin.__keyborgData;\n\n if (keyborgNativeFocusEvent) {\n kwin.document.removeEventListener(\n \"focusin\",\n keyborgNativeFocusEvent.focusInHandler,\n true,\n );\n\n kwin.document.removeEventListener(\n \"focusout\",\n keyborgNativeFocusEvent.focusOutHandler,\n true,\n );\n\n for (const shadowRootWeakRef of keyborgNativeFocusEvent.shadowTargets) {\n const shadowRoot = shadowRootWeakRef.deref();\n\n if (shadowRoot) {\n shadowRoot.removeEventListener(\n \"focusin\",\n keyborgNativeFocusEvent.focusInHandler,\n true,\n );\n shadowRoot.removeEventListener(\n \"focusout\",\n keyborgNativeFocusEvent.focusOutHandler,\n true,\n );\n }\n }\n\n keyborgNativeFocusEvent.shadowTargets.clear();\n\n delete kwin.__keyborgData;\n }\n\n if (origFocus) {\n proto.focus = origFocus;\n }\n}\n\n/**\n * @param win The window that stores keyborg focus events\n * @returns The last element focused with element.focus()\n */\nexport function getLastFocusedProgrammatically(\n win: Window,\n): HTMLElement | null | undefined {\n const keyborgNativeFocusEvent = (win as WindowWithKeyborgFocusEvent)\n .__keyborgData;\n\n return keyborgNativeFocusEvent\n ? keyborgNativeFocusEvent.lastFocusedProgrammatically?.deref() || null\n : undefined;\n}\n","/*!\n * Copyright (c) Microsoft Corporation. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n disposeFocusEvent,\n KeyborgFocusInEvent,\n KEYBORG_FOCUSIN,\n setupFocusEvent,\n} from \"./FocusEvent\";\nimport { Disposable } from \"./WeakRefInstance\";\n\ninterface WindowWithKeyborg extends Window {\n __keyborg?: {\n core: KeyborgCore;\n refs: { [id: string]: Keyborg };\n };\n}\n\nconst _dismissTimeout = 500; // When a key from dismissKeys is pressed and the focus is not moved\n// during _dismissTimeout time, dismiss the keyboard navigation mode.\n\nlet _lastId = 0;\n\nexport interface KeyborgProps {\n // Keys to be used to trigger keyboard navigation mode. By default, any key will trigger\n // it. Could be limited to, for example, just Tab (or Tab and arrow keys).\n triggerKeys?: number[];\n // Keys to be used to dismiss keyboard navigation mode using keyboard (in addition to\n // mouse clicks which dismiss it). For example, Esc could be used to dismiss.\n dismissKeys?: number[];\n}\n\nexport type KeyborgCallback = (isNavigatingWithKeyboard: boolean) => void;\n\n/**\n * Manages a collection of Keyborg instances in a window/document and updates keyborg state\n */\nclass KeyborgCore implements Disposable {\n readonly id: string;\n\n private _win?: WindowWithKeyborg;\n private _isMouseOrTouchUsedTimer: number | undefined;\n private _dismissTimer: number | undefined;\n private _triggerKeys?: Set<number>;\n private _dismissKeys?: Set<number>;\n private _isNavigatingWithKeyboard_DO_NOT_USE = false;\n\n constructor(win: WindowWithKeyborg, props?: KeyborgProps) {\n this.id = \"c\" + ++_lastId;\n this._win = win;\n const doc = win.document;\n\n if (props) {\n const triggerKeys = props.triggerKeys;\n const dismissKeys = props.dismissKeys;\n\n if (triggerKeys?.length) {\n this._triggerKeys = new Set(triggerKeys);\n }\n\n if (dismissKeys?.length) {\n this._dismissKeys = new Set(dismissKeys);\n }\n }\n\n doc.addEventListener(KEYBORG_FOCUSIN, this._onFocusIn, true); // Capture!\n doc.addEventListener(\"mousedown\", this._onMouseDown, true); // Capture!\n win.addEventListener(\"keydown\", this._onKeyDown, true); // Capture!\n\n doc.addEventListener(\"touchstart\", this._onMouseOrTouch, true); // Capture!\n doc.addEventListener(\"touchend\", this._onMouseOrTouch, true); // Capture!\n doc.addEventListener(\"touchcancel\", this._onMouseOrTouch, true); // Capture!\n\n setupFocusEvent(win);\n }\n\n get isNavigatingWithKeyboard() {\n return this._isNavigatingWithKeyboard_DO_NOT_USE;\n }\n\n set isNavigatingWithKeyboard(val: boolean) {\n if (this._isNavigatingWithKeyboard_DO_NOT_USE !== val) {\n this._isNavigatingWithKeyboard_DO_NOT_USE = val;\n this.update();\n }\n }\n\n dispose(): void {\n const win = this._win;\n\n if (win) {\n if (this._isMouseOrTouchUsedTimer) {\n win.clearTimeout(this._isMouseOrTouchUsedTimer);\n this._isMouseOrTouchUsedTimer = undefined;\n }\n\n if (this._dismissTimer) {\n win.clearTimeout(this._dismissTimer);\n this._dismissTimer = undefined;\n }\n\n disposeFocusEvent(win);\n\n const doc = win.document;\n\n doc.removeEventListener(KEYBORG_FOCUSIN, this._onFocusIn, true); // Capture!\n doc.removeEventListener(\"mousedown\", this._onMouseDown, true); // Capture!\n win.removeEventListener(\"keydown\", this._onKeyDown, true); // Capture!\n\n doc.removeEventListener(\"touchstart\", this._onMouseOrTouch, true); // Capture!\n doc.removeEventListener(\"touchend\", this._onMouseOrTouch, true); // Capture!\n doc.removeEventListener(\"touchcancel\", this._onMouseOrTouch, true); // Capture!\n\n delete this._win;\n }\n }\n\n isDisposed(): boolean {\n return !!this._win;\n }\n\n /**\n * Updates all keyborg instances with the keyboard navigation state\n */\n update(): void {\n const keyborgs = this._win?.__keyborg?.refs;\n\n if (keyborgs) {\n for (const id of Object.keys(keyborgs)) {\n Keyborg.update(keyborgs[id], this.isNavigatingWithKeyboard);\n }\n }\n }\n\n private _onFocusIn = (e: KeyborgFocusInEvent) => {\n // When the focus is moved not programmatically and without keydown events,\n // it is likely that the focus is moved by screen reader (as it might swallow\n // the events when the screen reader shortcuts are used). The screen reader\n // usage is keyboard navigation.\n\n if (this._isMouseOrTouchUsedTimer) {\n // There was a mouse or touch event recently.\n return;\n }\n\n if (this.isNavigatingWithKeyboard) {\n return;\n }\n\n const details = e.detail;\n\n if (!details.relatedTarget) {\n return;\n }\n\n if (\n details.isFocusedProgrammatically ||\n details.isFocusedProgrammatically === undefined\n ) {\n // The element is focused programmatically, or the programmatic focus detection\n // is not working.\n return;\n }\n\n this.isNavigatingWithKeyboard = true;\n };\n\n private _onMouseDown = (e: MouseEvent): void => {\n if (\n e.buttons === 0 ||\n (e.clientX === 0 && e.clientY === 0 && e.screenX === 0 && e.screenY === 0)\n ) {\n // This is most likely an event triggered by the screen reader to perform\n // an action on an element, do not dismiss the keyboard navigation mode.\n return;\n }\n\n this._onMouseOrTouch();\n };\n\n private _onMouseOrTouch = (): void => {\n const win = this._win;\n\n if (win) {\n if (this._isMouseOrTouchUsedTimer) {\n win.clearTimeout(this._isMouseOrTouchUsedTimer);\n }\n\n this._isMouseOrTouchUsedTimer = win.setTimeout(() => {\n delete this._isMouseOrTouchUsedTimer;\n }, 1000); // Keeping the indication of mouse or touch usage for some time.\n }\n\n this.isNavigatingWithKeyboard = false;\n };\n\n private _onKeyDown = (e: KeyboardEvent): void => {\n const isNavigatingWithKeyboard = this.isNavigatingWithKeyboard;\n\n if (isNavigatingWithKeyboard) {\n if (this._shouldDismissKeyboardNavigation(e)) {\n this._scheduleDismiss();\n }\n } else {\n if (this._shouldTriggerKeyboardNavigation(e)) {\n this.isNavigatingWithKeyboard = true;\n }\n }\n };\n\n /**\n * @returns whether the keyboard event should trigger keyboard navigation mode\n */\n private _shouldTriggerKeyboardNavigation(e: KeyboardEvent) {\n // TODO Some rich text fields can allow Tab key for indentation so it doesn't\n // need to be a navigation key. If there is a bug regarding that we should revisit\n if (e.key === \"Tab\") {\n return true;\n }\n\n const activeElement = this._win?.document\n .activeElement as HTMLElement | null;\n const isTriggerKey = !this._triggerKeys || this._triggerKeys.has(e.keyCode);\n\n const isEditable =\n activeElement &&\n (activeElement.tagName === \"INPUT\" ||\n activeElement.tagName === \"TEXTAREA\" ||\n activeElement.isContentEditable);\n\n return isTriggerKey && !isEditable;\n }\n\n /**\n * @returns whether the keyboard event should dismiss keyboard navigation mode\n */\n private _shouldDismissKeyboardNavigation(e: KeyboardEvent) {\n return this._dismissKeys?.has(e.keyCode);\n }\n\n private _scheduleDismiss(): void {\n const win = this._win;\n\n if (win) {\n if (this._dismissTimer) {\n win.clearTimeout(this._dismissTimer);\n this._dismissTimer = undefined;\n }\n\n const was = win.document.activeElement;\n\n this._dismissTimer = win.setTimeout(() => {\n this._dismissTimer = undefined;\n\n const cur = win.document.activeElement;\n\n if (was && cur && was === cur) {\n // Esc was pressed, currently focused element hasn't changed.\n // Just dismiss the keyboard navigation mode.\n this.isNavigatingWithKeyboard = false;\n }\n }, _dismissTimeout);\n }\n }\n}\n\n/**\n * Used to determine the keyboard navigation state\n */\nexport class Keyborg {\n private _id: string;\n private _win?: WindowWithKeyborg;\n private _core?: KeyborgCore;\n private _cb: KeyborgCallback[] = [];\n\n static create(win: WindowWithKeyborg, props?: KeyborgProps): Keyborg {\n return new Keyborg(win, props);\n }\n\n static dispose(instance: Keyborg): void {\n instance.dispose();\n }\n\n /**\n * Updates all subscribed callbacks with the keyboard navigation state\n */\n static update(instance: Keyborg, isNavigatingWithKeyboard: boolean): void {\n instance._cb.forEach((callback) => callback(isNavigatingWithKeyboard));\n }\n\n private constructor(win: WindowWithKeyborg, props?: KeyborgProps) {\n this._id = \"k\" + ++_lastId;\n this._win = win;\n\n const current = win.__keyborg;\n\n if (current) {\n this._core = current.core;\n current.refs[this._id] = this;\n } else {\n this._core = new KeyborgCore(win, props);\n win.__keyborg = {\n core: this._core,\n refs: { [this._id]: this },\n };\n }\n }\n\n private dispose(): void {\n const current = this._win?.__keyborg;\n\n if (current?.refs[this._id]) {\n delete current.refs[this._id];\n\n if (Object.keys(current.refs).length === 0) {\n current.core.dispose();\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n delete this._win!.__keyborg;\n }\n } else if (process.env.NODE_ENV !== \"production\") {\n console.error(\n `Keyborg instance ${this._id} is being disposed incorrectly.`,\n );\n }\n\n this._cb = [];\n delete this._core;\n delete this._win;\n }\n\n /**\n * @returns Whether the user is navigating with keyboard\n */\n isNavigatingWithKeyboard(): boolean {\n return !!this._core?.isNavigatingWithKeyboard;\n }\n\n /**\n * @param callback - Called when the keyboard navigation state changes\n */\n subscribe(callback: KeyborgCallback): void {\n this._cb.push(callback);\n }\n\n /**\n * @param callback - Registered with subscribe\n */\n unsubscribe(callback: KeyborgCallback): void {\n const index = this._cb.indexOf(callback);\n\n if (index >= 0) {\n this._cb.splice(index, 1);\n }\n }\n\n /**\n * Manually set the keyboard navigtion state\n */\n setVal(isNavigatingWithKeyboard: boolean): void {\n if (this._core) {\n this._core.isNavigatingWithKeyboard = isNavigatingWithKeyboard;\n }\n }\n}\n\nexport function createKeyborg(win: Window, props?: KeyborgProps): Keyborg {\n return Keyborg.create(win, props);\n}\n\nexport function disposeKeyborg(instance: Keyborg) {\n Keyborg.dispose(instance);\n}\n","/*!\n * Copyright (c) Microsoft Corporation. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport type { Keyborg, KeyborgCallback } from \"./Keyborg\";\nexport { createKeyborg, disposeKeyborg } from \"./Keyborg\";\n\nexport type {\n KeyborgFocusInEvent,\n KeyborgFocusInEventDetails,\n KeyborgFocusOutEvent,\n KeyborgFocusOutEventDetails,\n} from \"./FocusEvent\";\nexport {\n getLastFocusedProgrammatically,\n nativeFocus,\n KEYBORG_FOCUSIN,\n KEYBORG_FOCUSOUT,\n} from \"./FocusEvent\";\n\nexport const version = process.env.PKG_VERSION;\n"],"mappings":"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","names":[]}
package/dist/index.d.mts DELETED
@@ -1,130 +0,0 @@
1
- /**
2
- * Allows disposable instances to be used
3
- */
4
- interface Disposable {
5
- isDisposed?(): boolean;
6
- }
7
-
8
- /*!
9
- * Copyright (c) Microsoft Corporation. All rights reserved.
10
- * Licensed under the MIT License.
11
- */
12
-
13
- interface WindowWithKeyborg extends Window {
14
- __keyborg?: {
15
- core: KeyborgCore;
16
- refs: {
17
- [id: string]: Keyborg;
18
- };
19
- };
20
- }
21
- interface KeyborgProps {
22
- triggerKeys?: number[];
23
- dismissKeys?: number[];
24
- }
25
- type KeyborgCallback = (isNavigatingWithKeyboard: boolean) => void;
26
- /**
27
- * Manages a collection of Keyborg instances in a window/document and updates keyborg state
28
- */
29
- declare class KeyborgCore implements Disposable {
30
- readonly id: string;
31
- private _win?;
32
- private _isMouseOrTouchUsedTimer;
33
- private _dismissTimer;
34
- private _triggerKeys?;
35
- private _dismissKeys?;
36
- private _isNavigatingWithKeyboard_DO_NOT_USE;
37
- constructor(win: WindowWithKeyborg, props?: KeyborgProps);
38
- get isNavigatingWithKeyboard(): boolean;
39
- set isNavigatingWithKeyboard(val: boolean);
40
- dispose(): void;
41
- isDisposed(): boolean;
42
- /**
43
- * Updates all keyborg instances with the keyboard navigation state
44
- */
45
- update(): void;
46
- private _onFocusIn;
47
- private _onMouseDown;
48
- private _onMouseOrTouch;
49
- private _onKeyDown;
50
- /**
51
- * @returns whether the keyboard event should trigger keyboard navigation mode
52
- */
53
- private _shouldTriggerKeyboardNavigation;
54
- /**
55
- * @returns whether the keyboard event should dismiss keyboard navigation mode
56
- */
57
- private _shouldDismissKeyboardNavigation;
58
- private _scheduleDismiss;
59
- }
60
- /**
61
- * Used to determine the keyboard navigation state
62
- */
63
- declare class Keyborg {
64
- private _id;
65
- private _win?;
66
- private _core?;
67
- private _cb;
68
- static create(win: WindowWithKeyborg, props?: KeyborgProps): Keyborg;
69
- static dispose(instance: Keyborg): void;
70
- /**
71
- * Updates all subscribed callbacks with the keyboard navigation state
72
- */
73
- static update(instance: Keyborg, isNavigatingWithKeyboard: boolean): void;
74
- private constructor();
75
- private dispose;
76
- /**
77
- * @returns Whether the user is navigating with keyboard
78
- */
79
- isNavigatingWithKeyboard(): boolean;
80
- /**
81
- * @param callback - Called when the keyboard navigation state changes
82
- */
83
- subscribe(callback: KeyborgCallback): void;
84
- /**
85
- * @param callback - Registered with subscribe
86
- */
87
- unsubscribe(callback: KeyborgCallback): void;
88
- /**
89
- * Manually set the keyboard navigtion state
90
- */
91
- setVal(isNavigatingWithKeyboard: boolean): void;
92
- }
93
- declare function createKeyborg(win: Window, props?: KeyborgProps): Keyborg;
94
- declare function disposeKeyborg(instance: Keyborg): void;
95
-
96
- declare const KEYBORG_FOCUSIN = "keyborg:focusin";
97
- declare const KEYBORG_FOCUSOUT = "keyborg:focusout";
98
- interface KeyborgFocusInEventDetails {
99
- relatedTarget?: HTMLElement;
100
- isFocusedProgrammatically?: boolean;
101
- originalEvent?: FocusEvent;
102
- }
103
- interface KeyborgFocusInEvent extends CustomEvent<KeyborgFocusInEventDetails> {
104
- /**
105
- * @deprecated - used `event.detail`
106
- */
107
- details?: KeyborgFocusInEventDetails;
108
- }
109
- interface KeyborgFocusOutEventDetails {
110
- originalEvent: FocusEvent;
111
- }
112
- type KeyborgFocusOutEvent = CustomEvent<KeyborgFocusOutEventDetails>;
113
- /**
114
- * Guarantees that the native `focus` will be used
115
- */
116
- declare function nativeFocus(element: HTMLElement): void;
117
- /**
118
- * @param win The window that stores keyborg focus events
119
- * @returns The last element focused with element.focus()
120
- */
121
- declare function getLastFocusedProgrammatically(win: Window): HTMLElement | null | undefined;
122
-
123
- /*!
124
- * Copyright (c) Microsoft Corporation. All rights reserved.
125
- * Licensed under the MIT License.
126
- */
127
-
128
- declare const version: string | undefined;
129
-
130
- export { KEYBORG_FOCUSIN, KEYBORG_FOCUSOUT, Keyborg, type KeyborgCallback, type KeyborgFocusInEvent, type KeyborgFocusInEventDetails, type KeyborgFocusOutEvent, type KeyborgFocusOutEventDetails, createKeyborg, disposeKeyborg, getLastFocusedProgrammatically, nativeFocus, version };