@testing-library/user-event 14.0.0-alpha.7 → 14.0.0-beta.10

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 (198) hide show
  1. package/README.md +5 -192
  2. package/dist/index.cjs +3003 -0
  3. package/dist/index.mjs +3074 -0
  4. package/dist/types/clipboard/copy.d.ts +2 -0
  5. package/dist/types/clipboard/cut.d.ts +2 -0
  6. package/dist/types/clipboard/index.d.ts +3 -0
  7. package/dist/types/clipboard/paste.d.ts +2 -0
  8. package/dist/types/convenience/click.d.ts +4 -0
  9. package/dist/types/convenience/hover.d.ts +3 -0
  10. package/dist/types/convenience/index.d.ts +3 -0
  11. package/dist/types/convenience/tab.d.ts +4 -0
  12. package/dist/{document → types/document}/index.d.ts +0 -0
  13. package/dist/{document → types/document}/interceptor.d.ts +0 -0
  14. package/dist/{document → types/document}/selection.d.ts +0 -0
  15. package/dist/{document → types/document}/value.d.ts +0 -0
  16. package/dist/types/event/behavior/click.d.ts +1 -0
  17. package/dist/types/event/behavior/index.d.ts +3 -0
  18. package/dist/types/event/behavior/registry.d.ts +9 -0
  19. package/dist/types/event/createEvent.d.ts +8 -0
  20. package/dist/types/event/dispatchEvent.d.ts +2 -0
  21. package/dist/types/event/eventTypes.d.ts +2 -0
  22. package/dist/types/event/index.d.ts +6 -0
  23. package/dist/types/event/types.d.ts +13 -0
  24. package/dist/types/event/wrapEvent.d.ts +1 -0
  25. package/dist/types/index.d.ts +4 -0
  26. package/dist/types/keyboard/index.d.ts +7 -0
  27. package/dist/{keyboard → types/keyboard}/keyMap.d.ts +0 -0
  28. package/dist/types/keyboard/keyboardAction.d.ts +10 -0
  29. package/dist/{keyboard/getNextKeyDef.d.ts → types/keyboard/parseKeyDef.d.ts} +4 -6
  30. package/dist/{keyboard → types/keyboard}/plugins/arrow.d.ts +0 -0
  31. package/dist/{keyboard → types/keyboard}/plugins/character.d.ts +0 -0
  32. package/dist/types/keyboard/plugins/combination.d.ts +5 -0
  33. package/dist/{keyboard → types/keyboard}/plugins/control.d.ts +0 -0
  34. package/dist/{keyboard → types/keyboard}/plugins/functional.d.ts +0 -3
  35. package/dist/{keyboard → types/keyboard}/plugins/index.d.ts +0 -1
  36. package/dist/types/keyboard/plugins/modifiers.d.ts +8 -0
  37. package/dist/types/keyboard/shared/fireChangeForInputTimeIfValid.d.ts +4 -0
  38. package/dist/{keyboard → types/keyboard}/shared/index.d.ts +0 -0
  39. package/dist/{keyboard → types/keyboard}/types.d.ts +22 -24
  40. package/dist/types/options.d.ts +117 -0
  41. package/dist/types/pointer/firePointerEvents.d.ts +11 -0
  42. package/dist/types/pointer/index.d.ts +10 -0
  43. package/dist/{pointer → types/pointer}/keyMap.d.ts +0 -0
  44. package/dist/types/pointer/parseKeyDef.d.ts +6 -0
  45. package/dist/{pointer → types/pointer}/pointerAction.d.ts +3 -2
  46. package/dist/types/pointer/pointerMove.d.ts +6 -0
  47. package/dist/types/pointer/pointerPress.d.ts +8 -0
  48. package/dist/{pointer → types/pointer}/resolveSelectionTarget.d.ts +0 -0
  49. package/dist/{pointer → types/pointer}/types.d.ts +2 -12
  50. package/dist/types/setup/api.d.ts +5 -0
  51. package/dist/types/setup/config.d.ts +10 -0
  52. package/dist/types/setup/directApi.d.ts +19 -0
  53. package/dist/types/setup/index.d.ts +36 -0
  54. package/dist/types/setup/setup.d.ts +20 -0
  55. package/dist/types/setup/wrapAsync.d.ts +4 -0
  56. package/dist/types/utility/clear.d.ts +2 -0
  57. package/dist/types/utility/index.d.ts +4 -0
  58. package/dist/types/utility/selectOptions.d.ts +3 -0
  59. package/dist/types/utility/type.d.ts +9 -0
  60. package/dist/types/utility/upload.d.ts +5 -0
  61. package/dist/{utils → types/utils}/click/isClickableInput.d.ts +0 -0
  62. package/dist/types/utils/dataTransfer/Blob.d.ts +1 -0
  63. package/dist/types/utils/dataTransfer/Clipboard.d.ts +9 -0
  64. package/dist/types/utils/dataTransfer/DataTransfer.d.ts +2 -0
  65. package/dist/types/utils/dataTransfer/FileList.d.ts +1 -0
  66. package/dist/{utils → types/utils}/edit/buildTimeValue.d.ts +0 -0
  67. package/dist/{utils → types/utils}/edit/calculateNewValue.d.ts +1 -3
  68. package/dist/types/utils/edit/editInputElement.d.ts +14 -0
  69. package/dist/{utils → types/utils}/edit/getValue.d.ts +0 -0
  70. package/dist/{utils → types/utils}/edit/isContentEditable.d.ts +0 -0
  71. package/dist/{utils → types/utils}/edit/isEditable.d.ts +0 -0
  72. package/dist/{utils → types/utils}/edit/isValidDateValue.d.ts +0 -0
  73. package/dist/{utils → types/utils}/edit/isValidInputTimeValue.d.ts +0 -0
  74. package/dist/{utils → types/utils}/edit/maxLength.d.ts +0 -0
  75. package/dist/types/utils/edit/prepareInput.d.ts +8 -0
  76. package/dist/types/utils/edit/setFiles.d.ts +12 -0
  77. package/dist/{utils → types/utils}/focus/blur.d.ts +0 -0
  78. package/dist/types/utils/focus/copySelection.d.ts +1 -0
  79. package/dist/types/utils/focus/cursor.d.ts +9 -0
  80. package/dist/{utils → types/utils}/focus/focus.d.ts +3 -0
  81. package/dist/{utils → types/utils}/focus/getActiveElement.d.ts +0 -0
  82. package/dist/{utils → types/utils}/focus/getTabDestination.d.ts +0 -0
  83. package/dist/{utils → types/utils}/focus/isFocusable.d.ts +0 -0
  84. package/dist/types/utils/focus/selectAll.d.ts +5 -0
  85. package/dist/{utils → types/utils}/focus/selection.d.ts +0 -0
  86. package/dist/{utils → types/utils}/focus/selector.d.ts +0 -0
  87. package/dist/{utils → types/utils}/index.d.ts +15 -4
  88. package/dist/{utils → types/utils}/keyDef/readNextDescriptor.d.ts +0 -0
  89. package/dist/types/utils/keyboard/getKeyEventProps.d.ts +5 -0
  90. package/dist/types/utils/keyboard/getUIEventModifiers.d.ts +15 -0
  91. package/dist/types/utils/misc/cloneEvent.d.ts +1 -0
  92. package/dist/{utils → types/utils}/misc/eventWrapper.d.ts +0 -0
  93. package/dist/types/utils/misc/findClosest.d.ts +1 -0
  94. package/dist/types/utils/misc/getDocumentFromNode.d.ts +1 -0
  95. package/dist/{utils → types/utils}/misc/hasFormSubmit.d.ts +0 -0
  96. package/dist/{utils → types/utils}/misc/isDescendantOrSelf.d.ts +0 -0
  97. package/dist/{utils → types/utils}/misc/isDisabled.d.ts +0 -0
  98. package/dist/{utils → types/utils}/misc/isElementType.d.ts +0 -0
  99. package/dist/{utils → types/utils}/misc/isVisible.d.ts +0 -0
  100. package/dist/types/utils/misc/level.d.ts +17 -0
  101. package/dist/{utils → types/utils}/misc/wait.d.ts +0 -0
  102. package/dist/types/utils/pointer/cssPointerEvents.d.ts +15 -0
  103. package/dist/{utils → types/utils}/pointer/mouseButtons.d.ts +0 -0
  104. package/package.json +13 -30
  105. package/CHANGELOG.md +0 -5
  106. package/dist/clear.d.ts +0 -2
  107. package/dist/clear.js +0 -46
  108. package/dist/click.d.ts +0 -9
  109. package/dist/click.js +0 -62
  110. package/dist/document/index.js +0 -100
  111. package/dist/document/interceptor.js +0 -37
  112. package/dist/document/selection.js +0 -90
  113. package/dist/document/value.js +0 -77
  114. package/dist/hover.d.ts +0 -4
  115. package/dist/hover.js +0 -43
  116. package/dist/index.d.ts +0 -8
  117. package/dist/index.js +0 -22
  118. package/dist/keyboard/getEventProps.d.ts +0 -17
  119. package/dist/keyboard/getEventProps.js +0 -33
  120. package/dist/keyboard/getNextKeyDef.js +0 -85
  121. package/dist/keyboard/index.d.ts +0 -19
  122. package/dist/keyboard/index.js +0 -78
  123. package/dist/keyboard/keyMap.js +0 -143
  124. package/dist/keyboard/keyboardImplementation.d.ts +0 -3
  125. package/dist/keyboard/keyboardImplementation.js +0 -169
  126. package/dist/keyboard/plugins/arrow.js +0 -28
  127. package/dist/keyboard/plugins/character.js +0 -166
  128. package/dist/keyboard/plugins/control.js +0 -52
  129. package/dist/keyboard/plugins/functional.js +0 -140
  130. package/dist/keyboard/plugins/index.js +0 -40
  131. package/dist/keyboard/shared/fireChangeForInputTimeIfValid.d.ts +0 -3
  132. package/dist/keyboard/shared/fireChangeForInputTimeIfValid.js +0 -20
  133. package/dist/keyboard/shared/index.js +0 -18
  134. package/dist/keyboard/specialCharMap.d.ts +0 -22
  135. package/dist/keyboard/specialCharMap.js +0 -30
  136. package/dist/keyboard/types.js +0 -19
  137. package/dist/paste.d.ts +0 -7
  138. package/dist/paste.js +0 -60
  139. package/dist/pointer/index.d.ts +0 -18
  140. package/dist/pointer/index.js +0 -90
  141. package/dist/pointer/keyMap.js +0 -29
  142. package/dist/pointer/parseKeyDef.d.ts +0 -6
  143. package/dist/pointer/parseKeyDef.js +0 -36
  144. package/dist/pointer/pointerAction.js +0 -52
  145. package/dist/pointer/pointerMove.d.ts +0 -5
  146. package/dist/pointer/pointerMove.js +0 -136
  147. package/dist/pointer/pointerPress.d.ts +0 -7
  148. package/dist/pointer/pointerPress.js +0 -330
  149. package/dist/pointer/resolveSelectionTarget.js +0 -75
  150. package/dist/pointer/types.js +0 -1
  151. package/dist/selectOptions.d.ts +0 -4
  152. package/dist/selectOptions.js +0 -142
  153. package/dist/setup.d.ts +0 -92
  154. package/dist/setup.js +0 -203
  155. package/dist/tab.d.ts +0 -5
  156. package/dist/tab.js +0 -12
  157. package/dist/type.d.ts +0 -14
  158. package/dist/type.js +0 -74
  159. package/dist/upload.d.ts +0 -10
  160. package/dist/upload.js +0 -92
  161. package/dist/utils/click/isClickableInput.js +0 -14
  162. package/dist/utils/edit/buildTimeValue.js +0 -44
  163. package/dist/utils/edit/calculateNewValue.js +0 -50
  164. package/dist/utils/edit/fireInputEvent.d.ts +0 -11
  165. package/dist/utils/edit/fireInputEvent.js +0 -65
  166. package/dist/utils/edit/getValue.js +0 -23
  167. package/dist/utils/edit/isContentEditable.js +0 -25
  168. package/dist/utils/edit/isEditable.js +0 -42
  169. package/dist/utils/edit/isValidDateValue.js +0 -12
  170. package/dist/utils/edit/isValidInputTimeValue.js +0 -12
  171. package/dist/utils/edit/maxLength.js +0 -50
  172. package/dist/utils/edit/prepareInput.d.ts +0 -4
  173. package/dist/utils/edit/prepareInput.js +0 -60
  174. package/dist/utils/focus/blur.js +0 -19
  175. package/dist/utils/focus/focus.js +0 -22
  176. package/dist/utils/focus/getActiveElement.js +0 -26
  177. package/dist/utils/focus/getTabDestination.js +0 -71
  178. package/dist/utils/focus/isFocusable.js +0 -12
  179. package/dist/utils/focus/selection.js +0 -190
  180. package/dist/utils/focus/selector.js +0 -8
  181. package/dist/utils/index.js +0 -408
  182. package/dist/utils/keyDef/readNextDescriptor.js +0 -102
  183. package/dist/utils/misc/eventWrapper.js +0 -16
  184. package/dist/utils/misc/findClosest.d.ts +0 -1
  185. package/dist/utils/misc/findClosest.js +0 -20
  186. package/dist/utils/misc/hasFormSubmit.js +0 -10
  187. package/dist/utils/misc/hasPointerEvents.d.ts +0 -15
  188. package/dist/utils/misc/hasPointerEvents.js +0 -24
  189. package/dist/utils/misc/isDescendantOrSelf.js +0 -20
  190. package/dist/utils/misc/isDisabled.js +0 -12
  191. package/dist/utils/misc/isElementType.js +0 -24
  192. package/dist/utils/misc/isVisible.js +0 -24
  193. package/dist/utils/misc/wait.js +0 -10
  194. package/dist/utils/pointer/fakeEvent.d.ts +0 -20
  195. package/dist/utils/pointer/fakeEvent.js +0 -91
  196. package/dist/utils/pointer/firePointerEvents.d.ts +0 -14
  197. package/dist/utils/pointer/firePointerEvents.js +0 -55
  198. package/dist/utils/pointer/mouseButtons.js +0 -45
@@ -1,90 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.clearUISelection = clearUISelection;
7
- exports.getUISelection = getUISelection;
8
- exports.prepareSelectionInterceptor = prepareSelectionInterceptor;
9
- exports.setUISelection = setUISelection;
10
-
11
- var _ = require(".");
12
-
13
- var _interceptor = require("./interceptor");
14
-
15
- const UISelection = Symbol('Displayed selection in UI');
16
-
17
- function prepareSelectionInterceptor(element) {
18
- (0, _interceptor.prepareInterceptor)(element, 'setSelectionRange', function interceptorImpl(start, end, direction = 'none') {
19
- const isUI = start && typeof start === 'object' && start[UISelection];
20
-
21
- if (!isUI) {
22
- this[UISelection] = undefined;
23
- }
24
-
25
- return {
26
- realArgs: [Number(start), end, direction]
27
- };
28
- });
29
- (0, _interceptor.prepareInterceptor)(element, 'selectionStart', function interceptorImpl(v) {
30
- this[UISelection] = undefined;
31
- return {
32
- realArgs: v
33
- };
34
- });
35
- (0, _interceptor.prepareInterceptor)(element, 'selectionEnd', function interceptorImpl(v) {
36
- this[UISelection] = undefined;
37
- return {
38
- realArgs: v
39
- };
40
- });
41
- }
42
-
43
- function setUISelection(element, {
44
- focusOffset: focusOffsetParam,
45
- anchorOffset: anchorOffsetParam = focusOffsetParam
46
- }, mode = 'replace') {
47
- const valueLength = (0, _.getUIValue)(element).length;
48
-
49
- const sanitizeOffset = o => Math.max(0, Math.min(valueLength, o));
50
-
51
- const anchorOffset = mode === 'replace' || element[UISelection] === undefined ? sanitizeOffset(anchorOffsetParam) : element[UISelection].anchorOffset;
52
- const focusOffset = sanitizeOffset(focusOffsetParam);
53
- const startOffset = Math.min(anchorOffset, focusOffset);
54
- const endOffset = Math.max(anchorOffset, focusOffset);
55
- element[UISelection] = {
56
- anchorOffset,
57
- focusOffset
58
- };
59
-
60
- if (element.selectionStart === startOffset && element.selectionEnd === endOffset) {
61
- return;
62
- } // eslint-disable-next-line no-new-wrappers
63
-
64
-
65
- const startObj = new Number(startOffset);
66
- startObj[UISelection] = UISelection;
67
-
68
- try {
69
- element.setSelectionRange(startObj, endOffset);
70
- } catch {// DOMException for invalid state is expected when calling this
71
- // on an element without support for setSelectionRange
72
- }
73
- }
74
-
75
- function getUISelection(element) {
76
- var _element$UISelection, _element$selectionSta, _element$selectionEnd;
77
-
78
- const sel = (_element$UISelection = element[UISelection]) != null ? _element$UISelection : {
79
- anchorOffset: (_element$selectionSta = element.selectionStart) != null ? _element$selectionSta : 0,
80
- focusOffset: (_element$selectionEnd = element.selectionEnd) != null ? _element$selectionEnd : 0
81
- };
82
- return { ...sel,
83
- startOffset: Math.min(sel.anchorOffset, sel.focusOffset),
84
- endOffset: Math.max(sel.anchorOffset, sel.focusOffset)
85
- };
86
- }
87
-
88
- function clearUISelection(element) {
89
- element[UISelection] = undefined;
90
- }
@@ -1,77 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.endTrackValue = endTrackValue;
7
- exports.getInitialValue = getInitialValue;
8
- exports.getUIValue = getUIValue;
9
- exports.prepareValueInterceptor = prepareValueInterceptor;
10
- exports.setInitialValue = setInitialValue;
11
- exports.setUIValue = setUIValue;
12
- exports.startTrackValue = startTrackValue;
13
-
14
- var _interceptor = require("./interceptor");
15
-
16
- var _selection = require("./selection");
17
-
18
- const UIValue = Symbol('Displayed value in UI');
19
- const InitialValue = Symbol('Initial value to compare on blur');
20
- const TrackChanges = Symbol('Track programmatic changes for React workaround');
21
-
22
- function valueInterceptor(v) {
23
- const isUI = typeof v === 'object' && v[UIValue];
24
- this[UIValue] = isUI ? String(v) : undefined;
25
-
26
- if (!isUI) {
27
- trackValue(this, String(v));
28
- this[InitialValue] = String(v); // Programmatically setting the value property
29
- // moves the cursor to the end of the input.
30
-
31
- (0, _selection.clearUISelection)(this);
32
- }
33
-
34
- return {
35
- applyNative: !!isUI,
36
- realArgs: String(v)
37
- };
38
- }
39
-
40
- function prepareValueInterceptor(element) {
41
- (0, _interceptor.prepareInterceptor)(element, 'value', valueInterceptor);
42
- }
43
-
44
- function setUIValue(element, value) {
45
- element.value = {
46
- [UIValue]: UIValue,
47
- toString: () => value
48
- };
49
- }
50
-
51
- function getUIValue(element) {
52
- return element[UIValue] === undefined ? element.value : String(element[UIValue]);
53
- }
54
-
55
- function setInitialValue(element) {
56
- element[InitialValue] = element.value;
57
- }
58
-
59
- function getInitialValue(element) {
60
- return element[InitialValue];
61
- }
62
-
63
- function startTrackValue(element) {
64
- element[TrackChanges] = [];
65
- }
66
-
67
- function trackValue(element, v) {
68
- var _element$TrackChanges;
69
-
70
- (_element$TrackChanges = element[TrackChanges]) == null ? void 0 : _element$TrackChanges.push(v);
71
- }
72
-
73
- function endTrackValue(element) {
74
- const tracked = element[TrackChanges];
75
- element[TrackChanges] = undefined;
76
- return tracked;
77
- }
package/dist/hover.d.ts DELETED
@@ -1,4 +0,0 @@
1
- import type { UserEvent } from './setup';
2
- import { PointerOptions } from './utils';
3
- export declare function hover(this: UserEvent, element: Element, init?: MouseEventInit, { skipPointerEventsCheck }?: PointerOptions): void;
4
- export declare function unhover(this: UserEvent, element: Element, init?: MouseEventInit, { skipPointerEventsCheck }?: PointerOptions): void;
package/dist/hover.js DELETED
@@ -1,43 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.hover = hover;
7
- exports.unhover = unhover;
8
-
9
- var _pointer = require("./pointer");
10
-
11
- var _utils = require("./utils");
12
-
13
- function hover(element, init, {
14
- skipPointerEventsCheck = false
15
- } = {}) {
16
- if (!skipPointerEventsCheck && !(0, _utils.hasPointerEvents)(element)) {
17
- throw new Error('unable to hover element as it has or inherits pointer-events set to "none".');
18
- }
19
-
20
- const pointerState = (0, _pointer.createPointerState)();
21
- pointerState.position.mouse.target = element.ownerDocument.body;
22
- this.pointer({
23
- target: element
24
- }, {
25
- pointerState
26
- });
27
- }
28
-
29
- function unhover(element, init, {
30
- skipPointerEventsCheck = false
31
- } = {}) {
32
- if (!skipPointerEventsCheck && !(0, _utils.hasPointerEvents)(element)) {
33
- throw new Error('unable to unhover element as it has or inherits pointer-events set to "none".');
34
- }
35
-
36
- const pointerState = (0, _pointer.createPointerState)();
37
- pointerState.position.mouse.target = element;
38
- this.pointer({
39
- target: element.ownerDocument.body
40
- }, {
41
- pointerState
42
- });
43
- }
package/dist/index.d.ts DELETED
@@ -1,8 +0,0 @@
1
- import { specialCharMap } from './keyboard';
2
- import { UserEventApis, setup } from './setup';
3
- declare const userEvent: UserEventApis & {
4
- setup: typeof setup;
5
- };
6
- export default userEvent;
7
- export { specialCharMap as specialChars };
8
- export type { keyboardKey } from './keyboard';
package/dist/index.js DELETED
@@ -1,22 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.default = void 0;
7
- Object.defineProperty(exports, "specialChars", {
8
- enumerable: true,
9
- get: function () {
10
- return _keyboard.specialCharMap;
11
- }
12
- });
13
-
14
- var _keyboard = require("./keyboard");
15
-
16
- var _setup = require("./setup");
17
-
18
- const userEvent = { ...Object.fromEntries(Object.entries(_setup.userEventApis).map(([k, f]) => [k, (...a) => f.apply(userEvent, a)])),
19
- setup: _setup.setup
20
- };
21
- var _default = userEvent;
22
- exports.default = _default;
@@ -1,17 +0,0 @@
1
- import { keyboardKey, keyboardState } from './types';
2
- export declare function getKeyEventProps(keyDef: keyboardKey, state: keyboardState): {
3
- key: string | undefined;
4
- code: string | undefined;
5
- altKey: boolean;
6
- ctrlKey: boolean;
7
- metaKey: boolean;
8
- shiftKey: boolean;
9
- /** @deprecated use code instead */
10
- keyCode: number | undefined;
11
- };
12
- export declare function getMouseEventProps(state: keyboardState): {
13
- altKey: boolean;
14
- ctrlKey: boolean;
15
- metaKey: boolean;
16
- shiftKey: boolean;
17
- };
@@ -1,33 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.getKeyEventProps = getKeyEventProps;
7
- exports.getMouseEventProps = getMouseEventProps;
8
-
9
- function getKeyEventProps(keyDef, state) {
10
- var _keyDef$keyCode, _keyDef$key;
11
-
12
- return {
13
- key: keyDef.key,
14
- code: keyDef.code,
15
- altKey: state.modifiers.alt,
16
- ctrlKey: state.modifiers.ctrl,
17
- metaKey: state.modifiers.meta,
18
- shiftKey: state.modifiers.shift,
19
-
20
- /** @deprecated use code instead */
21
- keyCode: (_keyDef$keyCode = keyDef.keyCode) != null ? _keyDef$keyCode : // istanbul ignore next
22
- ((_keyDef$key = keyDef.key) == null ? void 0 : _keyDef$key.length) === 1 ? keyDef.key.charCodeAt(0) : undefined
23
- };
24
- }
25
-
26
- function getMouseEventProps(state) {
27
- return {
28
- altKey: state.modifiers.alt,
29
- ctrlKey: state.modifiers.ctrl,
30
- metaKey: state.modifiers.meta,
31
- shiftKey: state.modifiers.shift
32
- };
33
- }
@@ -1,85 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.getNextKeyDef = getNextKeyDef;
7
-
8
- var _utils = require("../utils");
9
-
10
- var legacyModifiers;
11
-
12
- (function (legacyModifiers) {
13
- legacyModifiers["alt"] = "alt";
14
- legacyModifiers["ctrl"] = "ctrl";
15
- legacyModifiers["meta"] = "meta";
16
- legacyModifiers["shift"] = "shift";
17
- })(legacyModifiers || (legacyModifiers = {}));
18
-
19
- var legacyKeyMap;
20
- /**
21
- * Get the next key from keyMap
22
- *
23
- * Keys can be referenced by `{key}` or `{special}` as well as physical locations per `[code]`.
24
- * Everything else will be interpreted as a typed character - e.g. `a`.
25
- * Brackets `{` and `[` can be escaped by doubling - e.g. `foo[[bar` translates to `foo[bar`.
26
- * Keeping the key pressed can be written as `{key>}`.
27
- * When keeping the key pressed you can choose how long (how many keydown and keypress) the key is pressed `{key>3}`.
28
- * You can then release the key per `{key>3/}` or keep it pressed and continue with the next key.
29
- * Modifiers like `{shift}` imply being kept pressed. This can be turned of per `{shift/}`.
30
- */
31
-
32
- (function (legacyKeyMap) {
33
- legacyKeyMap["ctrl"] = "Control";
34
- legacyKeyMap["del"] = "Delete";
35
- legacyKeyMap["esc"] = "Escape";
36
- legacyKeyMap["space"] = " ";
37
- })(legacyKeyMap || (legacyKeyMap = {}));
38
-
39
- function getNextKeyDef(text, options) {
40
- var _options$keyboardMap$;
41
-
42
- const {
43
- type,
44
- descriptor,
45
- consumedLength,
46
- releasePrevious,
47
- releaseSelf = !(type === '{' && getEnumValue(legacyModifiers, descriptor.toLowerCase())),
48
- repeat
49
- } = (0, _utils.readNextDescriptor)(text);
50
- const keyDef = (_options$keyboardMap$ = options.keyboardMap.find(def => {
51
- if (type === '[') {
52
- var _def$code;
53
-
54
- return ((_def$code = def.code) == null ? void 0 : _def$code.toLowerCase()) === descriptor.toLowerCase();
55
- } else if (type === '{') {
56
- var _def$key;
57
-
58
- const key = mapLegacyKey(descriptor);
59
- return ((_def$key = def.key) == null ? void 0 : _def$key.toLowerCase()) === key.toLowerCase();
60
- }
61
-
62
- return def.key === descriptor;
63
- })) != null ? _options$keyboardMap$ : {
64
- key: 'Unknown',
65
- code: 'Unknown',
66
- [type === '[' ? 'code' : 'key']: descriptor
67
- };
68
- return {
69
- keyDef,
70
- consumedLength,
71
- releasePrevious,
72
- releaseSelf,
73
- repeat
74
- };
75
- }
76
-
77
- function getEnumValue(f, key) {
78
- return f[key];
79
- }
80
-
81
- function mapLegacyKey(descriptor) {
82
- var _getEnumValue;
83
-
84
- return (_getEnumValue = getEnumValue(legacyKeyMap, descriptor)) != null ? _getEnumValue : descriptor;
85
- }
@@ -1,19 +0,0 @@
1
- import { keyboardState, keyboardOptions, keyboardKey } from './types';
2
- export { specialCharMap } from './specialCharMap';
3
- export type { keyboardOptions, keyboardKey };
4
- export declare function keyboard(text: string, options?: Partial<keyboardOptions & {
5
- keyboardState: keyboardState;
6
- delay: 0;
7
- }>): keyboardState;
8
- export declare function keyboard(text: string, options: Partial<keyboardOptions & {
9
- keyboardState: keyboardState;
10
- delay: number;
11
- }>): Promise<keyboardState>;
12
- export declare function keyboardImplementationWrapper(text: string, config?: Partial<keyboardOptions & {
13
- keyboardState: keyboardState;
14
- }>): {
15
- promise: Promise<void>;
16
- state: keyboardState;
17
- releaseAllKeys: () => void;
18
- };
19
- export declare function createKeyboardState(): keyboardState;
@@ -1,78 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.createKeyboardState = createKeyboardState;
7
- exports.keyboard = keyboard;
8
- exports.keyboardImplementationWrapper = keyboardImplementationWrapper;
9
- Object.defineProperty(exports, "specialCharMap", {
10
- enumerable: true,
11
- get: function () {
12
- return _specialCharMap.specialCharMap;
13
- }
14
- });
15
-
16
- var _dom = require("@testing-library/dom");
17
-
18
- var _document = require("../document");
19
-
20
- var _keyboardImplementation = require("./keyboardImplementation");
21
-
22
- var _keyMap = require("./keyMap");
23
-
24
- var _specialCharMap = require("./specialCharMap");
25
-
26
- function keyboard(text, options) {
27
- var _options$delay;
28
-
29
- const {
30
- promise,
31
- state
32
- } = keyboardImplementationWrapper(text, options);
33
-
34
- if (((_options$delay = options == null ? void 0 : options.delay) != null ? _options$delay : 0) > 0) {
35
- return (0, _dom.getConfig)().asyncWrapper(() => promise.then(() => state));
36
- } else {
37
- // prevent users from dealing with UnhandledPromiseRejectionWarning in sync call
38
- promise.catch(console.error);
39
- return state;
40
- }
41
- }
42
-
43
- function keyboardImplementationWrapper(text, config = {}) {
44
- const {
45
- keyboardState: state = createKeyboardState(),
46
- delay = 0,
47
- document: doc = document,
48
- autoModify = false,
49
- keyboardMap = _keyMap.defaultKeyMap
50
- } = config;
51
- const options = {
52
- delay,
53
- document: doc,
54
- autoModify,
55
- keyboardMap
56
- };
57
- (0, _document.prepareDocument)(document);
58
- return {
59
- promise: (0, _keyboardImplementation.keyboardImplementation)(text, options, state),
60
- state,
61
- releaseAllKeys: () => (0, _keyboardImplementation.releaseAllKeys)(options, state)
62
- };
63
- }
64
-
65
- function createKeyboardState() {
66
- return {
67
- activeElement: null,
68
- pressed: [],
69
- carryChar: '',
70
- modifiers: {
71
- alt: false,
72
- caps: false,
73
- ctrl: false,
74
- meta: false,
75
- shift: false
76
- }
77
- };
78
- }
@@ -1,143 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.defaultKeyMap = void 0;
7
-
8
- var _types = require("./types");
9
-
10
- /**
11
- * Mapping for a default US-104-QWERTY keyboard
12
- */
13
- const defaultKeyMap = [// alphanumeric keys
14
- ...'0123456789'.split('').map(c => ({
15
- code: `Digit${c}`,
16
- key: c
17
- })), ...')!@#$%^&*('.split('').map((c, i) => ({
18
- code: `Digit${i}`,
19
- key: c,
20
- shiftKey: true
21
- })), ...'abcdefghijklmnopqrstuvwxyz'.split('').map(c => ({
22
- code: `Key${c.toUpperCase()}`,
23
- key: c
24
- })), ...'ABCDEFGHIJKLMNOPQRSTUVWXYZ'.split('').map(c => ({
25
- code: `Key${c}`,
26
- key: c,
27
- shiftKey: true
28
- })), // alphanumeric block - functional
29
- {
30
- code: 'Space',
31
- key: ' '
32
- }, {
33
- code: 'AltLeft',
34
- key: 'Alt',
35
- location: _types.DOM_KEY_LOCATION.LEFT,
36
- keyCode: 18
37
- }, {
38
- code: 'AltRight',
39
- key: 'Alt',
40
- location: _types.DOM_KEY_LOCATION.RIGHT,
41
- keyCode: 18
42
- }, {
43
- code: 'ShiftLeft',
44
- key: 'Shift',
45
- location: _types.DOM_KEY_LOCATION.LEFT,
46
- keyCode: 16
47
- }, {
48
- code: 'ShiftRight',
49
- key: 'Shift',
50
- location: _types.DOM_KEY_LOCATION.RIGHT,
51
- keyCode: 16
52
- }, {
53
- code: 'ControlLeft',
54
- key: 'Control',
55
- location: _types.DOM_KEY_LOCATION.LEFT,
56
- keyCode: 17
57
- }, {
58
- code: 'ControlRight',
59
- key: 'Control',
60
- location: _types.DOM_KEY_LOCATION.RIGHT,
61
- keyCode: 17
62
- }, {
63
- code: 'MetaLeft',
64
- key: 'Meta',
65
- location: _types.DOM_KEY_LOCATION.LEFT,
66
- keyCode: 93
67
- }, {
68
- code: 'MetaRight',
69
- key: 'Meta',
70
- location: _types.DOM_KEY_LOCATION.RIGHT,
71
- keyCode: 93
72
- }, {
73
- code: 'OSLeft',
74
- key: 'OS',
75
- location: _types.DOM_KEY_LOCATION.LEFT,
76
- keyCode: 91
77
- }, {
78
- code: 'OSRight',
79
- key: 'OS',
80
- location: _types.DOM_KEY_LOCATION.RIGHT,
81
- keyCode: 91
82
- }, {
83
- code: 'Tab',
84
- key: 'Tab',
85
- keyCode: 9
86
- }, {
87
- code: 'CapsLock',
88
- key: 'CapsLock',
89
- keyCode: 20
90
- }, {
91
- code: 'Backspace',
92
- key: 'Backspace',
93
- keyCode: 8
94
- }, {
95
- code: 'Enter',
96
- key: 'Enter',
97
- keyCode: 13
98
- }, // function
99
- {
100
- code: 'Escape',
101
- key: 'Escape',
102
- keyCode: 27
103
- }, // arrows
104
- {
105
- code: 'ArrowUp',
106
- key: 'ArrowUp',
107
- keyCode: 38
108
- }, {
109
- code: 'ArrowDown',
110
- key: 'ArrowDown',
111
- keyCode: 40
112
- }, {
113
- code: 'ArrowLeft',
114
- key: 'ArrowLeft',
115
- keyCode: 37
116
- }, {
117
- code: 'ArrowRight',
118
- key: 'ArrowRight',
119
- keyCode: 39
120
- }, // control pad
121
- {
122
- code: 'Home',
123
- key: 'Home',
124
- keyCode: 36
125
- }, {
126
- code: 'End',
127
- key: 'End',
128
- keyCode: 35
129
- }, {
130
- code: 'Delete',
131
- key: 'Delete',
132
- keyCode: 46
133
- }, {
134
- code: 'PageUp',
135
- key: 'PageUp',
136
- keyCode: 33
137
- }, {
138
- code: 'PageDown',
139
- key: 'PageDown',
140
- keyCode: 34
141
- } // TODO: add mappings
142
- ];
143
- exports.defaultKeyMap = defaultKeyMap;
@@ -1,3 +0,0 @@
1
- import { keyboardState, keyboardOptions } from './types';
2
- export declare function keyboardImplementation(text: string, options: keyboardOptions, state: keyboardState): Promise<void>;
3
- export declare function releaseAllKeys(options: keyboardOptions, state: keyboardState): void;