@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,330 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.pointerPress = pointerPress;
7
-
8
- var _dom = require("@testing-library/dom");
9
-
10
- var _utils = require("../utils");
11
-
12
- var _document = require("../document");
13
-
14
- var _resolveSelectionTarget = require("./resolveSelectionTarget");
15
-
16
- /* eslint-disable complexity */
17
- async function pointerPress(action, state) {
18
- const {
19
- keyDef,
20
- target,
21
- releasePrevious,
22
- releaseSelf
23
- } = action;
24
- const previous = state.pointerState.pressed.find(p => p.keyDef === keyDef);
25
- const pointerName = keyDef.pointerType === 'touch' ? keyDef.name : keyDef.pointerType;
26
- const targetIsDisabled = (0, _utils.isDisabled)(target);
27
-
28
- if (previous) {
29
- up(state, pointerName, action, previous, targetIsDisabled);
30
- }
31
-
32
- if (!releasePrevious) {
33
- const press = down(state, pointerName, action, targetIsDisabled);
34
-
35
- if (releaseSelf) {
36
- up(state, pointerName, action, press, targetIsDisabled);
37
- }
38
- }
39
- }
40
-
41
- function getNextPointerId(state) {
42
- state.pointerId = state.pointerId + 1;
43
- return state.pointerId;
44
- }
45
-
46
- function down({
47
- pointerState,
48
- keyboardState
49
- }, pointerName, {
50
- keyDef,
51
- node,
52
- offset,
53
- target,
54
- coords
55
- }, targetIsDisabled) {
56
- var _pointerState$activeC, _pointerState$activeC2, _pointerState$activeC3;
57
-
58
- const {
59
- name,
60
- pointerType,
61
- button
62
- } = keyDef;
63
- const pointerId = pointerType === 'mouse' ? 1 : getNextPointerId(pointerState);
64
- pointerState.position[pointerName] = { ...pointerState.position[pointerName],
65
- pointerId,
66
- pointerType,
67
- target,
68
- coords
69
- };
70
- let isMultiTouch = false;
71
- let isPrimary = true;
72
-
73
- if (pointerType !== 'mouse') {
74
- for (const obj of pointerState.pressed) {
75
- // TODO: test multi device input across browsers
76
- // istanbul ignore else
77
- if (obj.keyDef.pointerType === pointerType) {
78
- obj.isMultiTouch = true;
79
- isMultiTouch = true;
80
- isPrimary = false;
81
- }
82
- }
83
- }
84
-
85
- if (((_pointerState$activeC = pointerState.activeClickCount) == null ? void 0 : _pointerState$activeC[0]) !== name) {
86
- delete pointerState.activeClickCount;
87
- }
88
-
89
- const clickCount = Number((_pointerState$activeC2 = (_pointerState$activeC3 = pointerState.activeClickCount) == null ? void 0 : _pointerState$activeC3[1]) != null ? _pointerState$activeC2 : 0) + 1;
90
- pointerState.activeClickCount = [name, clickCount];
91
- const pressObj = {
92
- keyDef,
93
- downTarget: target,
94
- pointerId,
95
- unpreventedDefault: true,
96
- isMultiTouch,
97
- isPrimary,
98
- clickCount
99
- };
100
- pointerState.pressed.push(pressObj);
101
-
102
- if (!targetIsDisabled) {
103
- if (pointerType !== 'mouse') {
104
- fire('pointerover');
105
- fire('pointerenter');
106
- }
107
-
108
- if (pointerType !== 'mouse' || !pointerState.pressed.some(p => p.keyDef !== keyDef && p.keyDef.pointerType === pointerType)) {
109
- fire('pointerdown');
110
- }
111
-
112
- if (pointerType === 'mouse') {
113
- pressObj.unpreventedDefault = fire('mousedown');
114
- } // TODO: touch...
115
-
116
- }
117
-
118
- if (pointerType === 'mouse' && pressObj.unpreventedDefault) {
119
- mousedownDefaultBehavior({
120
- target,
121
- targetIsDisabled,
122
- clickCount,
123
- position: pointerState.position[pointerName],
124
- node,
125
- offset
126
- });
127
- }
128
-
129
- return pressObj;
130
-
131
- function fire(type) {
132
- return (0, _utils.firePointerEvent)(target, type, {
133
- pointerState,
134
- keyboardState,
135
- button,
136
- clickCount,
137
- coords,
138
- isPrimary,
139
- pointerId,
140
- pointerType
141
- });
142
- }
143
- }
144
-
145
- function up({
146
- pointerState,
147
- keyboardState
148
- }, pointerName, {
149
- keyDef: {
150
- pointerType,
151
- button
152
- },
153
- target,
154
- coords,
155
- node,
156
- offset
157
- }, pressed, targetIsDisabled) {
158
- pointerState.pressed = pointerState.pressed.filter(p => p !== pressed);
159
- const {
160
- isMultiTouch,
161
- isPrimary,
162
- pointerId,
163
- clickCount
164
- } = pressed;
165
- let {
166
- unpreventedDefault
167
- } = pressed;
168
- pointerState.position[pointerName] = { ...pointerState.position[pointerName],
169
- target,
170
- coords
171
- }; // TODO: pointerleave for touch device
172
-
173
- if (!targetIsDisabled) {
174
- if (pointerType !== 'mouse' || !pointerState.pressed.filter(p => p.keyDef.pointerType === pointerType).length) {
175
- fire('pointerup');
176
- }
177
-
178
- if (pointerType !== 'mouse') {
179
- fire('pointerout');
180
- fire('pointerleave');
181
- }
182
-
183
- if (pointerType !== 'mouse' && !isMultiTouch) {
184
- if (clickCount === 1) {
185
- fire('mouseover');
186
- fire('mouseenter');
187
- }
188
-
189
- fire('mousemove');
190
- unpreventedDefault = fire('mousedown') && unpreventedDefault;
191
- }
192
- }
193
-
194
- if (unpreventedDefault && pointerType !== 'mouse' && !isMultiTouch) {
195
- mousedownDefaultBehavior({
196
- target,
197
- targetIsDisabled,
198
- clickCount,
199
- position: pointerState.position[pointerName],
200
- node,
201
- offset
202
- });
203
- }
204
-
205
- delete pointerState.position[pointerName].selectionRange;
206
-
207
- if (!targetIsDisabled) {
208
- if (pointerType === 'mouse' || !isMultiTouch) {
209
- unpreventedDefault = fire('mouseup') && unpreventedDefault;
210
- const canClick = pointerType !== 'mouse' || button === 'primary';
211
-
212
- if (canClick && target === pressed.downTarget) {
213
- fire('click');
214
-
215
- if (clickCount === 2) {
216
- fire('dblclick');
217
- } // If the click happens inside a `label` with a control, the control (or closes focusable) is focused.
218
-
219
-
220
- const label = target.closest('label');
221
-
222
- if (label != null && label.control) {
223
- var _findClosest;
224
-
225
- (0, _utils.focus)((_findClosest = (0, _utils.findClosest)(label.control, _utils.isFocusable)) != null ? _findClosest : target.ownerDocument.body);
226
- }
227
- }
228
-
229
- if (pointerType === 'mouse' && button === 'secondary') {
230
- _dom.fireEvent.contextMenu(target);
231
- }
232
- }
233
- }
234
-
235
- function fire(type) {
236
- return (0, _utils.firePointerEvent)(target, type, {
237
- pointerState,
238
- keyboardState,
239
- button,
240
- clickCount,
241
- coords,
242
- isPrimary,
243
- pointerId,
244
- pointerType
245
- });
246
- }
247
- }
248
-
249
- function mousedownDefaultBehavior({
250
- position,
251
- target,
252
- targetIsDisabled,
253
- clickCount,
254
- node,
255
- offset
256
- }) {
257
- var _findClosest2;
258
-
259
- // The closest focusable element is focused when a `mousedown` would have been fired.
260
- // Even if there was no `mousedown` because the element was disabled.
261
- // A `mousedown` that preventsDefault cancels this though.
262
- (0, _utils.focus)((_findClosest2 = (0, _utils.findClosest)(target, _utils.isFocusable)) != null ? _findClosest2 : target.ownerDocument.body); // TODO: What happens if a focus event handler interfers?
263
- // An unprevented mousedown moves the cursor to the closest character.
264
- // We try to approximate the behavior for a no-layout environment.
265
-
266
- if (!targetIsDisabled) {
267
- const hasValue = (0, _utils.isElementType)(target, ['input', 'textarea']); // On non-input elements the text selection per multiple click
268
- // can extend beyond the target boundaries.
269
- // The exact mechanism what is considered in the same line is unclear.
270
- // Looks it might be every inline element.
271
- // TODO: Check what might be considered part of the same line of text.
272
-
273
- const text = String(hasValue ? (0, _document.getUIValue)(target) : target.textContent);
274
- const [start, end] = node ? // As offset is describing a DOMOffset it is non-trivial to determine
275
- // which elements might be considered in the same line of text.
276
- // TODO: support expanding initial range on multiple clicks if node is given
277
- [offset, offset] : getTextRange(text, offset, clickCount); // TODO: implement modifying selection per shift/ctrl+mouse
278
-
279
- if (hasValue) {
280
- (0, _document.setUISelection)(target, {
281
- anchorOffset: start != null ? start : text.length,
282
- focusOffset: end != null ? end : text.length
283
- });
284
- position.selectionRange = {
285
- node: target,
286
- start: start != null ? start : 0,
287
- end: end != null ? end : text.length
288
- };
289
- } else {
290
- const {
291
- node: startNode,
292
- offset: startOffset
293
- } = (0, _resolveSelectionTarget.resolveSelectionTarget)({
294
- target,
295
- node,
296
- offset: start
297
- });
298
- const {
299
- node: endNode,
300
- offset: endOffset
301
- } = (0, _resolveSelectionTarget.resolveSelectionTarget)({
302
- target,
303
- node,
304
- offset: end
305
- });
306
- const range = new Range();
307
- range.setStart(startNode, startOffset);
308
- range.setEnd(endNode, endOffset);
309
- position.selectionRange = range;
310
- const selection = target.ownerDocument.getSelection();
311
- selection.removeAllRanges();
312
- selection.addRange(range.cloneRange());
313
- }
314
- }
315
- }
316
-
317
- function getTextRange(text, pos, clickCount) {
318
- if (clickCount % 3 === 1 || text.length === 0) {
319
- return [pos, pos];
320
- }
321
-
322
- const textPos = pos != null ? pos : text.length;
323
-
324
- if (clickCount % 3 === 2) {
325
- return [textPos - text.substr(0, pos).match(/(\w+|\s+|\W)?$/)[0].length, pos === undefined ? pos : pos + text.substr(pos).match(/^(\w+|\s+|\W)?/)[0].length];
326
- } // triple click
327
-
328
-
329
- return [textPos - text.substr(0, pos).match(/[^\r\n]*$/)[0].length, pos === undefined ? pos : pos + text.substr(pos).match(/^[^\r\n]*/)[0].length];
330
- }
@@ -1,75 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.resolveSelectionTarget = resolveSelectionTarget;
7
-
8
- var _document = require("../document");
9
-
10
- var _utils = require("../utils");
11
-
12
- function resolveSelectionTarget({
13
- target,
14
- node,
15
- offset
16
- }) {
17
- if ((0, _utils.isElementType)(target, ['input', 'textarea'])) {
18
- return {
19
- node: target,
20
- offset: offset != null ? offset : (0, _document.getUIValue)(target).length
21
- };
22
- } else if (node) {
23
- return {
24
- node,
25
- offset: offset != null ? offset : node.nodeType === 3 ? node.nodeValue.length : node.childNodes.length
26
- };
27
- }
28
-
29
- return findNodeAtTextOffset(target, offset);
30
- }
31
-
32
- function findNodeAtTextOffset(node, offset, isRoot = true) {
33
- // When clicking after the content the browser behavior can be complicated:
34
- // 1. If there is textContent after the last element child,
35
- // the cursor is moved there.
36
- // 2. If there is textContent in the last element child,
37
- // the browser moves the cursor to the last non-empty text node inside this element.
38
- // 3. Otherwise the cursor is moved to the end of the target.
39
- let i = offset === undefined ? node.childNodes.length - 1 : 0;
40
- const step = offset === undefined ? -1 : +1;
41
-
42
- while (offset === undefined ? i >= (isRoot ? Math.max(node.childNodes.length - 1, 0) : 0) : i <= node.childNodes.length) {
43
- const c = node.childNodes.item(i);
44
- const text = String(c.textContent);
45
-
46
- if (text.length) {
47
- if (offset !== undefined && text.length < offset) {
48
- offset -= text.length;
49
- } else if (c.nodeType === 1) {
50
- return findNodeAtTextOffset(c, offset, false);
51
- } else {
52
- // The pre-commit hooks keeps changing this
53
- // See https://github.com/kentcdodds/kcd-scripts/issues/218
54
-
55
- /* istanbul ignore else */
56
- // eslint-disable-next-line no-lonely-if
57
- if (c.nodeType === 3) {
58
- var _offset;
59
-
60
- return {
61
- node: c,
62
- offset: (_offset = offset) != null ? _offset : c.nodeValue.length
63
- };
64
- }
65
- }
66
- }
67
-
68
- i += step;
69
- }
70
-
71
- return {
72
- node,
73
- offset: node.childNodes.length
74
- };
75
- }
@@ -1 +0,0 @@
1
- "use strict";
@@ -1,4 +0,0 @@
1
- import { PointerOptions } from './utils';
2
- import type { UserEvent } from './setup';
3
- export declare function selectOptions(this: UserEvent, select: Element, values: HTMLElement | HTMLElement[] | string[] | string, init?: MouseEventInit, options?: PointerOptions): void;
4
- export declare function deselectOptions(this: UserEvent, select: Element, values: HTMLElement | HTMLElement[] | string[] | string, init?: MouseEventInit, options?: PointerOptions): void;
@@ -1,142 +0,0 @@
1
- "use strict";
2
-
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.deselectOptions = deselectOptions;
7
- exports.selectOptions = selectOptions;
8
-
9
- var _dom = require("@testing-library/dom");
10
-
11
- var _utils = require("./utils");
12
-
13
- function selectOptions(select, values, init, options = {}) {
14
- return selectOptionsBase.call(this, true, select, values, init, options);
15
- }
16
-
17
- function deselectOptions(select, values, init, options = {}) {
18
- return selectOptionsBase.call(this, false, select, values, init, options);
19
- }
20
-
21
- function selectOptionsBase(newValue, select, values, init, {
22
- skipPointerEventsCheck
23
- }) {
24
- if (!newValue && !select.multiple) {
25
- throw (0, _dom.getConfig)().getElementError(`Unable to deselect an option in a non-multiple select. Use selectOptions to change the selection instead.`, select);
26
- }
27
-
28
- const valArray = Array.isArray(values) ? values : [values];
29
- const allOptions = Array.from(select.querySelectorAll('option, [role="option"]'));
30
- const selectedOptions = valArray.map(val => {
31
- if (typeof val !== 'string' && allOptions.includes(val)) {
32
- return val;
33
- } else {
34
- const matchingOption = allOptions.find(o => o.value === val || o.innerHTML === val);
35
-
36
- if (matchingOption) {
37
- return matchingOption;
38
- } else {
39
- throw (0, _dom.getConfig)().getElementError(`Value "${String(val)}" not found in options`, select);
40
- }
41
- }
42
- }).filter(option => !(0, _utils.isDisabled)(option));
43
- if ((0, _utils.isDisabled)(select) || !selectedOptions.length) return;
44
-
45
- if ((0, _utils.isElementType)(select, 'select')) {
46
- if (select.multiple) {
47
- for (const option of selectedOptions) {
48
- const withPointerEvents = skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(option); // events fired for multiple select are weird. Can't use hover...
49
-
50
- if (withPointerEvents) {
51
- _dom.fireEvent.pointerOver(option, init);
52
-
53
- _dom.fireEvent.pointerEnter(select, init);
54
-
55
- _dom.fireEvent.mouseOver(option);
56
-
57
- _dom.fireEvent.mouseEnter(select);
58
-
59
- _dom.fireEvent.pointerMove(option, init);
60
-
61
- _dom.fireEvent.mouseMove(option, init);
62
-
63
- _dom.fireEvent.pointerDown(option, init);
64
-
65
- _dom.fireEvent.mouseDown(option, init);
66
- }
67
-
68
- (0, _utils.focus)(select);
69
-
70
- if (withPointerEvents) {
71
- _dom.fireEvent.pointerUp(option, init);
72
-
73
- _dom.fireEvent.mouseUp(option, init);
74
- }
75
-
76
- selectOption(option);
77
-
78
- if (withPointerEvents) {
79
- _dom.fireEvent.click(option, init);
80
- }
81
- }
82
- } else if (selectedOptions.length === 1) {
83
- const withPointerEvents = skipPointerEventsCheck ? true : (0, _utils.hasPointerEvents)(select); // the click to open the select options
84
-
85
- if (withPointerEvents) {
86
- this.click(select, init, {
87
- skipPointerEventsCheck: true
88
- });
89
- } else {
90
- (0, _utils.focus)(select);
91
- }
92
-
93
- selectOption(selectedOptions[0]);
94
-
95
- if (withPointerEvents) {
96
- // the browser triggers another click event on the select for the click on the option
97
- // this second click has no 'down' phase
98
- _dom.fireEvent.pointerOver(select, init);
99
-
100
- _dom.fireEvent.pointerEnter(select, init);
101
-
102
- _dom.fireEvent.mouseOver(select);
103
-
104
- _dom.fireEvent.mouseEnter(select);
105
-
106
- _dom.fireEvent.pointerUp(select, init);
107
-
108
- _dom.fireEvent.mouseUp(select, init);
109
-
110
- _dom.fireEvent.click(select, init);
111
- }
112
- } else {
113
- throw (0, _dom.getConfig)().getElementError(`Cannot select multiple options on a non-multiple select`, select);
114
- }
115
- } else if (select.getAttribute('role') === 'listbox') {
116
- selectedOptions.forEach(option => {
117
- this.hover(option, init, {
118
- skipPointerEventsCheck
119
- });
120
- this.click(option, init, {
121
- skipPointerEventsCheck
122
- });
123
- this.unhover(option, init, {
124
- skipPointerEventsCheck
125
- });
126
- });
127
- } else {
128
- throw (0, _dom.getConfig)().getElementError(`Cannot select options on elements that are neither select nor listbox elements`, select);
129
- }
130
-
131
- function selectOption(option) {
132
- option.selected = newValue;
133
- (0, _dom.fireEvent)(select, (0, _dom.createEvent)('input', select, {
134
- bubbles: true,
135
- cancelable: false,
136
- composed: true,
137
- ...init
138
- }));
139
-
140
- _dom.fireEvent.change(select, init);
141
- }
142
- }
package/dist/setup.d.ts DELETED
@@ -1,92 +0,0 @@
1
- import { clear } from './clear';
2
- import { click, clickOptions, dblClick, tripleClick } from './click';
3
- import { hover, unhover } from './hover';
4
- import { keyboard, keyboardOptions } from './keyboard';
5
- import type { keyboardState } from './keyboard/types';
6
- import { paste } from './paste';
7
- import { pointer } from './pointer';
8
- import type { pointerOptions, pointerState } from './pointer/types';
9
- import { deselectOptions, selectOptions } from './selectOptions';
10
- import { tab, tabOptions } from './tab';
11
- import { type, typeOptions } from './type';
12
- import { upload, uploadOptions } from './upload';
13
- import { PointerOptions } from './utils';
14
- export declare const userEventApis: {
15
- clear: typeof clear;
16
- click: typeof click;
17
- dblClick: typeof dblClick;
18
- deselectOptions: typeof deselectOptions;
19
- hover: typeof hover;
20
- keyboard: typeof keyboard;
21
- paste: typeof paste;
22
- pointer: typeof pointer;
23
- selectOptions: typeof selectOptions;
24
- tab: typeof tab;
25
- tripleClick: typeof tripleClick;
26
- type: typeof type;
27
- unhover: typeof unhover;
28
- upload: typeof upload;
29
- };
30
- export declare type UserEventApis = typeof userEventApis;
31
- declare type setup = ReturnType<typeof _setup>['setup'];
32
- export declare type UserEvent = UserEventApis & {
33
- setup: setup;
34
- };
35
- declare type ClickOptions = Omit<clickOptions, 'clickCount'>;
36
- declare type KeyboardOptions = Partial<keyboardOptions>;
37
- declare type PointerApiOptions = Partial<pointerOptions>;
38
- declare type TabOptions = Omit<tabOptions, 'shift'>;
39
- declare type TypeOptions = Omit<typeOptions, 'initialSelectionStart' | 'initialSelectionEnd'>;
40
- declare type UploadOptions = uploadOptions;
41
- interface SetupOptions extends ClickOptions, KeyboardOptions, PointerOptions, PointerApiOptions, TabOptions, TypeOptions, UploadOptions {
42
- }
43
- /**
44
- * Start a "session" with userEvent.
45
- * All APIs returned by this function share an input device state and a default configuration.
46
- */
47
- export declare function setup(options?: SetupOptions): {
48
- clear: typeof clear;
49
- click: typeof click;
50
- dblClick: typeof dblClick;
51
- deselectOptions: typeof deselectOptions;
52
- hover: typeof hover;
53
- keyboard: typeof keyboard;
54
- paste: typeof paste;
55
- pointer: typeof pointer;
56
- selectOptions: typeof selectOptions;
57
- tab: typeof tab;
58
- tripleClick: typeof tripleClick;
59
- type: typeof type;
60
- unhover: typeof unhover;
61
- upload: typeof upload;
62
- } & {
63
- /**
64
- * Create a set of callbacks with different default settings but the same state.
65
- */
66
- setup(options: SetupOptions): {
67
- clear: typeof clear;
68
- click: typeof click;
69
- dblClick: typeof dblClick;
70
- deselectOptions: typeof deselectOptions;
71
- hover: typeof hover;
72
- keyboard: typeof keyboard;
73
- paste: typeof paste;
74
- pointer: typeof pointer;
75
- selectOptions: typeof selectOptions;
76
- tab: typeof tab;
77
- tripleClick: typeof tripleClick;
78
- type: typeof type;
79
- unhover: typeof unhover;
80
- upload: typeof upload;
81
- } & any;
82
- };
83
- declare function _setup({ applyAccept, autoModify, delay, document, keyboardMap, pointerMap, skipAutoClose, skipClick, skipHover, skipPointerEventsCheck, }: SetupOptions, { keyboardState, pointerState, }: {
84
- keyboardState: keyboardState;
85
- pointerState: pointerState;
86
- }): UserEventApis & {
87
- /**
88
- * Create a set of callbacks with different default settings but the same state.
89
- */
90
- setup(options: SetupOptions): ReturnType<typeof _setup>;
91
- };
92
- export {};