@testing-library/user-event 14.3.0 → 14.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (237) hide show
  1. package/dist/cjs/clipboard/copy.js +40 -0
  2. package/dist/cjs/clipboard/cut.js +40 -0
  3. package/dist/cjs/clipboard/index.js +13 -0
  4. package/dist/cjs/clipboard/paste.js +41 -0
  5. package/dist/cjs/convenience/click.js +40 -0
  6. package/dist/cjs/convenience/hover.js +37 -0
  7. package/dist/cjs/convenience/index.js +16 -0
  8. package/dist/cjs/convenience/tab.js +9 -0
  9. package/dist/cjs/document/index.js +74 -0
  10. package/dist/cjs/document/interceptor.js +30 -0
  11. package/dist/cjs/document/selection.js +107 -0
  12. package/dist/cjs/document/setRangeText.js +21 -0
  13. package/dist/cjs/document/value.js +125 -0
  14. package/dist/cjs/event/behavior/click.js +42 -0
  15. package/dist/cjs/event/behavior/cut.js +26 -0
  16. package/dist/cjs/event/behavior/index.js +15 -0
  17. package/dist/cjs/event/behavior/keydown.js +134 -0
  18. package/dist/cjs/event/behavior/keypress.js +58 -0
  19. package/dist/cjs/event/behavior/keyup.js +24 -0
  20. package/dist/cjs/event/behavior/paste.js +29 -0
  21. package/dist/cjs/event/behavior/registry.js +7 -0
  22. package/dist/cjs/event/createEvent.js +193 -0
  23. package/dist/cjs/event/dispatchEvent.js +37 -0
  24. package/dist/cjs/event/dom-events.d.js +2 -0
  25. package/dist/cjs/event/eventMap.js +64 -0
  26. package/dist/cjs/event/index.js +24 -0
  27. package/dist/cjs/event/types.js +2 -0
  28. package/dist/cjs/event/wrapEvent.js +11 -0
  29. package/dist/cjs/index.js +14 -0
  30. package/dist/cjs/keyboard/index.js +59 -0
  31. package/dist/cjs/keyboard/keyMap.js +158 -0
  32. package/dist/cjs/keyboard/parseKeyDef.js +58 -0
  33. package/dist/cjs/options.js +42 -0
  34. package/dist/cjs/package.json +3 -0
  35. package/dist/cjs/pointer/index.js +88 -0
  36. package/dist/cjs/pointer/keyMap.js +35 -0
  37. package/dist/cjs/pointer/parseKeyDef.js +39 -0
  38. package/dist/cjs/setup/api.js +35 -0
  39. package/dist/cjs/setup/config.js +7 -0
  40. package/dist/cjs/setup/directApi.js +77 -0
  41. package/dist/cjs/setup/index.js +15 -0
  42. package/dist/cjs/setup/setup.js +97 -0
  43. package/dist/cjs/setup/wrapAsync.js +13 -0
  44. package/dist/cjs/system/index.js +31 -0
  45. package/dist/cjs/system/keyboard.js +135 -0
  46. package/dist/cjs/system/pointer/buttons.js +71 -0
  47. package/dist/cjs/system/pointer/device.js +21 -0
  48. package/dist/cjs/system/pointer/index.js +146 -0
  49. package/dist/cjs/system/pointer/mouse.js +186 -0
  50. package/dist/cjs/system/pointer/pointer.js +114 -0
  51. package/dist/cjs/utility/clear.js +42 -0
  52. package/dist/cjs/utility/index.js +16 -0
  53. package/dist/cjs/utility/selectOptions.js +125 -0
  54. package/dist/cjs/utility/type.js +41 -0
  55. package/dist/cjs/utility/upload.js +72 -0
  56. package/dist/cjs/utils/click/isClickableInput.js +22 -0
  57. package/dist/cjs/utils/dataTransfer/Blob.js +18 -0
  58. package/dist/cjs/utils/dataTransfer/Clipboard.js +168 -0
  59. package/dist/cjs/utils/dataTransfer/DataTransfer.js +124 -0
  60. package/dist/cjs/utils/dataTransfer/FileList.js +26 -0
  61. package/dist/cjs/utils/edit/buildTimeValue.js +36 -0
  62. package/dist/cjs/utils/edit/getValue.js +35 -0
  63. package/dist/cjs/utils/edit/input.js +162 -0
  64. package/dist/cjs/utils/edit/isContentEditable.js +20 -0
  65. package/dist/cjs/utils/edit/isEditable.js +35 -0
  66. package/dist/cjs/utils/edit/isValidDateOrTimeValue.js +11 -0
  67. package/dist/cjs/utils/edit/maxLength.js +38 -0
  68. package/dist/cjs/utils/edit/setFiles.js +59 -0
  69. package/dist/cjs/utils/edit/walkRadio.js +28 -0
  70. package/dist/cjs/utils/focus/blur.js +16 -0
  71. package/dist/cjs/utils/focus/copySelection.js +46 -0
  72. package/dist/cjs/utils/focus/cursor.js +143 -0
  73. package/dist/cjs/utils/focus/focus.js +26 -0
  74. package/dist/cjs/utils/focus/getActiveElement.js +24 -0
  75. package/dist/cjs/utils/focus/getTabDestination.js +82 -0
  76. package/dist/cjs/utils/focus/isFocusable.js +11 -0
  77. package/dist/cjs/utils/focus/resolveCaretPosition.js +78 -0
  78. package/dist/cjs/utils/focus/selectAll.js +54 -0
  79. package/dist/cjs/utils/focus/selection.js +287 -0
  80. package/dist/cjs/utils/focus/selector.js +16 -0
  81. package/dist/cjs/utils/index.js +108 -0
  82. package/dist/cjs/utils/keyDef/readNextDescriptor.js +92 -0
  83. package/dist/cjs/utils/misc/cloneEvent.js +9 -0
  84. package/dist/cjs/utils/misc/dom-helpers.d.js +2 -0
  85. package/dist/cjs/utils/misc/eventWrapper.js +15 -0
  86. package/dist/cjs/utils/misc/findClosest.js +16 -0
  87. package/dist/cjs/utils/misc/getDocumentFromNode.js +12 -0
  88. package/dist/cjs/utils/misc/getTreeDiff.js +27 -0
  89. package/dist/cjs/utils/misc/getWindow.js +11 -0
  90. package/dist/cjs/utils/misc/isDescendantOrSelf.js +16 -0
  91. package/dist/cjs/utils/misc/isDisabled.js +34 -0
  92. package/dist/cjs/utils/misc/isElementType.js +22 -0
  93. package/dist/cjs/utils/misc/isVisible.js +21 -0
  94. package/dist/cjs/utils/misc/level.js +20 -0
  95. package/dist/cjs/utils/misc/wait.js +16 -0
  96. package/dist/cjs/utils/pointer/cssPointerEvents.js +111 -0
  97. package/dist/esm/clipboard/copy.js +36 -0
  98. package/dist/esm/clipboard/cut.js +36 -0
  99. package/dist/esm/clipboard/index.js +3 -0
  100. package/dist/esm/clipboard/paste.js +37 -0
  101. package/dist/esm/convenience/click.js +34 -0
  102. package/dist/esm/convenience/hover.js +32 -0
  103. package/dist/esm/convenience/index.js +3 -0
  104. package/dist/esm/convenience/tab.js +5 -0
  105. package/dist/esm/document/index.js +66 -0
  106. package/dist/esm/document/interceptor.js +26 -0
  107. package/dist/esm/document/selection.js +99 -0
  108. package/dist/esm/document/setRangeText.js +17 -0
  109. package/dist/esm/document/value.js +115 -0
  110. package/dist/esm/event/behavior/click.js +40 -0
  111. package/dist/esm/event/behavior/cut.js +24 -0
  112. package/dist/esm/event/behavior/index.js +7 -0
  113. package/dist/esm/event/behavior/keydown.js +132 -0
  114. package/dist/esm/event/behavior/keypress.js +56 -0
  115. package/dist/esm/event/behavior/keyup.js +22 -0
  116. package/dist/esm/event/behavior/paste.js +27 -0
  117. package/dist/esm/event/behavior/registry.js +3 -0
  118. package/dist/esm/event/createEvent.js +189 -0
  119. package/dist/esm/event/dispatchEvent.js +33 -0
  120. package/dist/esm/event/dom-events.d.js +1 -0
  121. package/dist/esm/event/eventMap.js +57 -0
  122. package/dist/esm/event/index.js +19 -0
  123. package/dist/esm/event/types.js +1 -0
  124. package/dist/esm/event/wrapEvent.js +7 -0
  125. package/dist/esm/index.js +2 -0
  126. package/dist/esm/keyboard/index.js +54 -0
  127. package/dist/esm/keyboard/keyMap.js +154 -0
  128. package/dist/esm/keyboard/parseKeyDef.js +54 -0
  129. package/dist/esm/options.js +37 -0
  130. package/dist/esm/package.json +3 -0
  131. package/dist/esm/pointer/index.js +84 -0
  132. package/dist/esm/pointer/keyMap.js +31 -0
  133. package/dist/esm/pointer/parseKeyDef.js +35 -0
  134. package/dist/esm/setup/api.js +12 -0
  135. package/dist/esm/setup/config.js +3 -0
  136. package/dist/esm/setup/directApi.js +58 -0
  137. package/dist/esm/setup/index.js +10 -0
  138. package/dist/esm/setup/setup.js +90 -0
  139. package/dist/esm/setup/wrapAsync.js +9 -0
  140. package/dist/esm/system/index.js +27 -0
  141. package/dist/esm/system/keyboard.js +131 -0
  142. package/dist/esm/system/pointer/buttons.js +63 -0
  143. package/dist/esm/system/pointer/device.js +17 -0
  144. package/dist/esm/system/pointer/index.js +141 -0
  145. package/dist/esm/system/pointer/mouse.js +182 -0
  146. package/dist/esm/system/pointer/pointer.js +110 -0
  147. package/dist/esm/utility/clear.js +38 -0
  148. package/dist/esm/utility/index.js +4 -0
  149. package/dist/esm/utility/selectOptions.js +120 -0
  150. package/dist/esm/utility/type.js +37 -0
  151. package/dist/esm/utility/upload.js +68 -0
  152. package/dist/esm/utils/click/isClickableInput.js +18 -0
  153. package/dist/esm/utils/dataTransfer/Blob.js +14 -0
  154. package/dist/esm/utils/dataTransfer/Clipboard.js +159 -0
  155. package/dist/esm/utils/dataTransfer/DataTransfer.js +119 -0
  156. package/dist/esm/utils/dataTransfer/FileList.js +22 -0
  157. package/dist/esm/utils/edit/buildTimeValue.js +32 -0
  158. package/dist/esm/utils/edit/getValue.js +31 -0
  159. package/dist/esm/utils/edit/input.js +158 -0
  160. package/dist/esm/utils/edit/isContentEditable.js +15 -0
  161. package/dist/esm/utils/edit/isEditable.js +30 -0
  162. package/dist/esm/utils/edit/isValidDateOrTimeValue.js +7 -0
  163. package/dist/esm/utils/edit/maxLength.js +34 -0
  164. package/dist/esm/utils/edit/setFiles.js +55 -0
  165. package/dist/esm/utils/edit/walkRadio.js +24 -0
  166. package/dist/esm/utils/focus/blur.js +12 -0
  167. package/dist/esm/utils/focus/copySelection.js +42 -0
  168. package/dist/esm/utils/focus/cursor.js +139 -0
  169. package/dist/esm/utils/focus/focus.js +22 -0
  170. package/dist/esm/utils/focus/getActiveElement.js +19 -0
  171. package/dist/esm/utils/focus/getTabDestination.js +78 -0
  172. package/dist/esm/utils/focus/isFocusable.js +7 -0
  173. package/dist/esm/utils/focus/resolveCaretPosition.js +74 -0
  174. package/dist/esm/utils/focus/selectAll.js +49 -0
  175. package/dist/esm/utils/focus/selection.js +274 -0
  176. package/dist/esm/utils/focus/selector.js +12 -0
  177. package/dist/esm/utils/index.js +36 -0
  178. package/dist/esm/utils/keyDef/readNextDescriptor.js +88 -0
  179. package/dist/esm/utils/misc/cloneEvent.js +5 -0
  180. package/dist/esm/utils/misc/dom-helpers.d.js +1 -0
  181. package/dist/esm/utils/misc/eventWrapper.js +11 -0
  182. package/dist/esm/utils/misc/findClosest.js +12 -0
  183. package/dist/esm/utils/misc/getDocumentFromNode.js +8 -0
  184. package/dist/esm/utils/misc/getTreeDiff.js +23 -0
  185. package/dist/esm/utils/misc/getWindow.js +7 -0
  186. package/dist/esm/utils/misc/isDescendantOrSelf.js +12 -0
  187. package/dist/esm/utils/misc/isDisabled.js +30 -0
  188. package/dist/esm/utils/misc/isElementType.js +18 -0
  189. package/dist/esm/utils/misc/isVisible.js +17 -0
  190. package/dist/esm/utils/misc/level.js +15 -0
  191. package/dist/esm/utils/misc/wait.js +12 -0
  192. package/dist/esm/utils/pointer/cssPointerEvents.js +106 -0
  193. package/dist/types/event/createEvent.d.ts +2 -8
  194. package/dist/types/event/eventMap.d.ts +204 -181
  195. package/dist/types/event/index.d.ts +1 -2
  196. package/dist/types/event/types.d.ts +6 -0
  197. package/dist/types/index.d.ts +2 -2
  198. package/dist/types/keyboard/index.d.ts +2 -6
  199. package/dist/types/keyboard/keyMap.d.ts +1 -1
  200. package/dist/types/keyboard/parseKeyDef.d.ts +1 -1
  201. package/dist/types/options.d.ts +4 -4
  202. package/dist/types/pointer/index.d.ts +23 -5
  203. package/dist/types/pointer/keyMap.d.ts +1 -1
  204. package/dist/types/pointer/parseKeyDef.d.ts +1 -1
  205. package/dist/types/setup/config.d.ts +3 -7
  206. package/dist/types/setup/directApi.d.ts +21 -16
  207. package/dist/types/setup/index.d.ts +1 -2
  208. package/dist/types/setup/setup.d.ts +7 -1
  209. package/dist/types/system/index.d.ts +10 -0
  210. package/dist/types/system/keyboard.d.ts +53 -0
  211. package/dist/types/system/pointer/buttons.d.ts +23 -0
  212. package/dist/types/system/pointer/device.d.ts +8 -0
  213. package/dist/types/system/pointer/index.d.ts +39 -0
  214. package/dist/types/system/pointer/mouse.d.ts +26 -0
  215. package/dist/types/system/pointer/pointer.d.ts +30 -0
  216. package/dist/types/utils/click/isClickableInput.d.ts +15 -1
  217. package/dist/types/utils/focus/getActiveElement.d.ts +1 -0
  218. package/dist/types/utils/focus/resolveCaretPosition.d.ts +8 -0
  219. package/dist/types/utils/focus/selection.d.ts +28 -1
  220. package/dist/types/utils/index.d.ts +2 -3
  221. package/dist/types/utils/misc/getTreeDiff.d.ts +1 -0
  222. package/package.json +9 -15
  223. package/dist/index.cjs +0 -3104
  224. package/dist/index.mjs +0 -3155
  225. package/dist/types/event/eventTypes.d.ts +0 -2
  226. package/dist/types/keyboard/keyboardAction.d.ts +0 -10
  227. package/dist/types/keyboard/modifiers.d.ts +0 -9
  228. package/dist/types/keyboard/types.d.ts +0 -73
  229. package/dist/types/pointer/firePointerEvents.d.ts +0 -11
  230. package/dist/types/pointer/pointerAction.d.ts +0 -7
  231. package/dist/types/pointer/pointerMove.d.ts +0 -6
  232. package/dist/types/pointer/pointerPress.d.ts +0 -8
  233. package/dist/types/pointer/resolveSelectionTarget.d.ts +0 -5
  234. package/dist/types/pointer/types.d.ts +0 -62
  235. package/dist/types/utils/keyboard/getKeyEventProps.d.ts +0 -5
  236. package/dist/types/utils/keyboard/getUIEventModifiers.d.ts +0 -15
  237. package/dist/types/utils/pointer/mouseButtons.d.ts +0 -12
@@ -0,0 +1,287 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var isElementType = require('../misc/isElementType.js');
6
+ var isClickableInput = require('../click/isClickableInput.js');
7
+ require('../dataTransfer/Clipboard.js');
8
+ var isContentEditable = require('../edit/isContentEditable.js');
9
+ require('../edit/maxLength.js');
10
+ var isEditable = require('../edit/isEditable.js');
11
+ require('@testing-library/dom');
12
+ require('@testing-library/dom/dist/helpers.js');
13
+ var cursor = require('./cursor.js');
14
+ var resolveCaretPosition = require('./resolveCaretPosition.js');
15
+ require('../keyDef/readNextDescriptor.js');
16
+ require('../misc/level.js');
17
+ require('../../options.js');
18
+ require('../../event/eventMap.js');
19
+ require('../../event/behavior/click.js');
20
+ require('../../event/behavior/cut.js');
21
+ require('../../event/behavior/keydown.js');
22
+ require('../../event/behavior/keypress.js');
23
+ require('../../event/behavior/keyup.js');
24
+ require('../../event/behavior/paste.js');
25
+ var selection = require('../../document/selection.js');
26
+ var value = require('../../document/value.js');
27
+
28
+ /**
29
+ * Backward-compatible selection.
30
+ *
31
+ * Handles input elements and contenteditable if it only contains a single text node.
32
+ */ function setSelectionRange(element, anchorOffset, focusOffset) {
33
+ if (hasOwnSelection(element)) {
34
+ return setSelection({
35
+ focusNode: element,
36
+ anchorOffset,
37
+ focusOffset
38
+ });
39
+ }
40
+ /* istanbul ignore else */ if (isContentEditable.isContentEditable(element) && element.firstChild?.nodeType === 3) {
41
+ return setSelection({
42
+ focusNode: element.firstChild,
43
+ anchorOffset,
44
+ focusOffset
45
+ });
46
+ }
47
+ /* istanbul ignore next */ throw new Error('Not implemented. The result of this interaction is unreliable.');
48
+ }
49
+ /**
50
+ * Determine if the element has its own selection implementation
51
+ * and does not interact with the Document Selection API.
52
+ */ function hasOwnSelection(node) {
53
+ return isElement(node) && (isElementType.isElementType(node, 'textarea') || isElementType.isElementType(node, 'input') && node.type in isEditable.editableInputTypes);
54
+ }
55
+ function hasNoSelection(node) {
56
+ return isElement(node) && isClickableInput.isClickableInput(node);
57
+ }
58
+ function isElement(node) {
59
+ return node.nodeType === 1;
60
+ }
61
+ /**
62
+ * Determine which selection logic and selection ranges to consider.
63
+ */ function getTargetTypeAndSelection(node) {
64
+ const element = getElement(node);
65
+ if (element && hasOwnSelection(element)) {
66
+ return {
67
+ type: 'input',
68
+ selection: selection.getUISelection(element)
69
+ };
70
+ }
71
+ const selection$1 = element?.ownerDocument.getSelection();
72
+ // It is possible to extend a single-range selection into a contenteditable.
73
+ // This results in the range acting like a range outside of contenteditable.
74
+ const isCE = isContentEditable.getContentEditable(node) && selection$1?.anchorNode && isContentEditable.getContentEditable(selection$1.anchorNode);
75
+ return {
76
+ type: isCE ? 'contenteditable' : 'default',
77
+ selection: selection$1
78
+ };
79
+ }
80
+ function getElement(node) {
81
+ return node.nodeType === 1 ? node : node.parentElement;
82
+ }
83
+ /**
84
+ * Reset the Document Selection when moving focus into an element
85
+ * with own selection implementation.
86
+ */ function updateSelectionOnFocus(element) {
87
+ const selection = element.ownerDocument.getSelection();
88
+ /* istanbul ignore if */ if (!selection?.focusNode) {
89
+ return;
90
+ }
91
+ // If the focus moves inside an element with own selection implementation,
92
+ // the document selection will be this element.
93
+ // But if the focused element is inside a contenteditable,
94
+ // 1) a collapsed selection will be retained.
95
+ // 2) other selections will be replaced by a cursor
96
+ // 2.a) at the start of the first child if it is a text node
97
+ // 2.b) at the start of the contenteditable.
98
+ if (hasOwnSelection(element)) {
99
+ const contenteditable = isContentEditable.getContentEditable(selection.focusNode);
100
+ if (contenteditable) {
101
+ if (!selection.isCollapsed) {
102
+ const focusNode = contenteditable.firstChild?.nodeType === 3 ? contenteditable.firstChild : contenteditable;
103
+ selection.setBaseAndExtent(focusNode, 0, focusNode, 0);
104
+ }
105
+ } else {
106
+ selection.setBaseAndExtent(element, 0, element, 0);
107
+ }
108
+ }
109
+ }
110
+ /**
111
+ * Get the range that would be overwritten by input.
112
+ */ function getInputRange(focusNode) {
113
+ const typeAndSelection = getTargetTypeAndSelection(focusNode);
114
+ if (typeAndSelection.type === 'input') {
115
+ return typeAndSelection.selection;
116
+ } else if (typeAndSelection.type === 'contenteditable') {
117
+ // Multi-range on contenteditable edits the first selection instead of the last
118
+ return typeAndSelection.selection?.getRangeAt(0);
119
+ }
120
+ }
121
+ /**
122
+ * Extend/shrink the selection like with Shift+Arrows or Shift+Mouse
123
+ */ function modifySelection({ focusNode , focusOffset }) {
124
+ const typeAndSelection = getTargetTypeAndSelection(focusNode);
125
+ if (typeAndSelection.type === 'input') {
126
+ return selection.setUISelection(focusNode, {
127
+ anchorOffset: typeAndSelection.selection.anchorOffset,
128
+ focusOffset
129
+ }, 'modify');
130
+ }
131
+ focusNode.ownerDocument?.getSelection()?.extend(focusNode, focusOffset);
132
+ }
133
+ /**
134
+ * Set the selection
135
+ */ function setSelection({ focusNode , focusOffset , anchorNode =focusNode , anchorOffset =focusOffset }) {
136
+ const typeAndSelection = getTargetTypeAndSelection(focusNode);
137
+ if (typeAndSelection.type === 'input') {
138
+ return selection.setUISelection(focusNode, {
139
+ anchorOffset,
140
+ focusOffset
141
+ });
142
+ }
143
+ anchorNode.ownerDocument?.getSelection()?.setBaseAndExtent(anchorNode, anchorOffset, focusNode, focusOffset);
144
+ }
145
+ /**
146
+ * Move the selection
147
+ */ function moveSelection(node, direction) {
148
+ // TODO: implement shift
149
+ if (hasOwnSelection(node)) {
150
+ const selection$1 = selection.getUISelection(node);
151
+ setSelection({
152
+ focusNode: node,
153
+ focusOffset: selection$1.startOffset === selection$1.endOffset ? selection$1.focusOffset + direction : direction < 0 ? selection$1.startOffset : selection$1.endOffset
154
+ });
155
+ } else {
156
+ const selection1 = node.ownerDocument.getSelection();
157
+ if (!selection1?.focusNode) {
158
+ return;
159
+ }
160
+ if (selection1.isCollapsed) {
161
+ const nextPosition = cursor.getNextCursorPosition(selection1.focusNode, selection1.focusOffset, direction);
162
+ if (nextPosition) {
163
+ setSelection({
164
+ focusNode: nextPosition.node,
165
+ focusOffset: nextPosition.offset
166
+ });
167
+ }
168
+ } else {
169
+ selection1[direction < 0 ? 'collapseToStart' : 'collapseToEnd']();
170
+ }
171
+ }
172
+ }
173
+ function setSelectionPerMouseDown({ document , target , clickCount , node , offset }) {
174
+ if (hasNoSelection(target)) {
175
+ return;
176
+ }
177
+ const targetHasOwnSelection = hasOwnSelection(target);
178
+ // On non-input elements the text selection per multiple click
179
+ // can extend beyond the target boundaries.
180
+ // The exact mechanism what is considered in the same line is unclear.
181
+ // Looks it might be every inline element.
182
+ // TODO: Check what might be considered part of the same line of text.
183
+ const text = String(targetHasOwnSelection ? value.getUIValue(target) : target.textContent);
184
+ const [start, end] = node ? // which elements might be considered in the same line of text.
185
+ // TODO: support expanding initial range on multiple clicks if node is given
186
+ [
187
+ offset,
188
+ offset
189
+ ] : getTextRange(text, offset, clickCount);
190
+ // TODO: implement modifying selection per shift/ctrl+mouse
191
+ if (targetHasOwnSelection) {
192
+ selection.setUISelection(target, {
193
+ anchorOffset: start ?? text.length,
194
+ focusOffset: end ?? text.length
195
+ });
196
+ return {
197
+ node: target,
198
+ start: start ?? 0,
199
+ end: end ?? text.length
200
+ };
201
+ } else {
202
+ const { node: startNode , offset: startOffset } = resolveCaretPosition.resolveCaretPosition({
203
+ target,
204
+ node,
205
+ offset: start
206
+ });
207
+ const { node: endNode , offset: endOffset } = resolveCaretPosition.resolveCaretPosition({
208
+ target,
209
+ node,
210
+ offset: end
211
+ });
212
+ const range = target.ownerDocument.createRange();
213
+ try {
214
+ range.setStart(startNode, startOffset);
215
+ range.setEnd(endNode, endOffset);
216
+ } catch (e) {
217
+ throw new Error('The given offset is out of bounds.');
218
+ }
219
+ const selection = document.getSelection();
220
+ selection?.removeAllRanges();
221
+ selection?.addRange(range.cloneRange());
222
+ return range;
223
+ }
224
+ }
225
+ function getTextRange(text, pos, clickCount) {
226
+ if (clickCount % 3 === 1 || text.length === 0) {
227
+ return [
228
+ pos,
229
+ pos
230
+ ];
231
+ }
232
+ const textPos = pos ?? text.length;
233
+ if (clickCount % 3 === 2) {
234
+ return [
235
+ textPos - text.substr(0, pos).match(/(\w+|\s+|\W)?$/)[0].length,
236
+ pos === undefined ? pos : pos + text.substr(pos).match(/^(\w+|\s+|\W)?/)[0].length,
237
+ ];
238
+ }
239
+ // triple click
240
+ return [
241
+ textPos - text.substr(0, pos).match(/[^\r\n]*$/)[0].length,
242
+ pos === undefined ? pos : pos + text.substr(pos).match(/^[^\r\n]*/)[0].length,
243
+ ];
244
+ }
245
+ function modifySelectionPerMouseMove(selectionRange, { document , target , node , offset }) {
246
+ const selectionFocus = resolveCaretPosition.resolveCaretPosition({
247
+ target,
248
+ node,
249
+ offset
250
+ });
251
+ if ('node' in selectionRange) {
252
+ // When the mouse is dragged outside of an input/textarea,
253
+ // the selection is extended to the beginning or end of the input
254
+ // depending on pointer position.
255
+ // TODO: extend selection according to pointer position
256
+ /* istanbul ignore else */ if (selectionFocus.node === selectionRange.node) {
257
+ const anchorOffset = selectionFocus.offset < selectionRange.start ? selectionRange.end : selectionRange.start;
258
+ const focusOffset = selectionFocus.offset > selectionRange.end || selectionFocus.offset < selectionRange.start ? selectionFocus.offset : selectionRange.end;
259
+ selection.setUISelection(selectionRange.node, {
260
+ anchorOffset,
261
+ focusOffset
262
+ });
263
+ }
264
+ } else {
265
+ const range = selectionRange.cloneRange();
266
+ const cmp = range.comparePoint(selectionFocus.node, selectionFocus.offset);
267
+ if (cmp < 0) {
268
+ range.setStart(selectionFocus.node, selectionFocus.offset);
269
+ } else if (cmp > 0) {
270
+ range.setEnd(selectionFocus.node, selectionFocus.offset);
271
+ }
272
+ const selection = document.getSelection();
273
+ selection?.removeAllRanges();
274
+ selection?.addRange(range.cloneRange());
275
+ }
276
+ }
277
+
278
+ exports.getInputRange = getInputRange;
279
+ exports.hasNoSelection = hasNoSelection;
280
+ exports.hasOwnSelection = hasOwnSelection;
281
+ exports.modifySelection = modifySelection;
282
+ exports.modifySelectionPerMouseMove = modifySelectionPerMouseMove;
283
+ exports.moveSelection = moveSelection;
284
+ exports.setSelection = setSelection;
285
+ exports.setSelectionPerMouseDown = setSelectionPerMouseDown;
286
+ exports.setSelectionRange = setSelectionRange;
287
+ exports.updateSelectionOnFocus = updateSelectionOnFocus;
@@ -0,0 +1,16 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ const FOCUSABLE_SELECTOR = [
6
+ 'input:not([type=hidden]):not([disabled])',
7
+ 'button:not([disabled])',
8
+ 'select:not([disabled])',
9
+ 'textarea:not([disabled])',
10
+ '[contenteditable=""]',
11
+ '[contenteditable="true"]',
12
+ 'a[href]',
13
+ '[tabindex]:not([disabled])',
14
+ ].join(', ');
15
+
16
+ exports.FOCUSABLE_SELECTOR = FOCUSABLE_SELECTOR;
@@ -0,0 +1,108 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var isClickableInput = require('./click/isClickableInput.js');
6
+ var Blob = require('./dataTransfer/Blob.js');
7
+ var DataTransfer = require('./dataTransfer/DataTransfer.js');
8
+ var FileList = require('./dataTransfer/FileList.js');
9
+ var Clipboard = require('./dataTransfer/Clipboard.js');
10
+ var getValue = require('./edit/getValue.js');
11
+ var input = require('./edit/input.js');
12
+ var isContentEditable = require('./edit/isContentEditable.js');
13
+ var isEditable = require('./edit/isEditable.js');
14
+ var setFiles = require('./edit/setFiles.js');
15
+ var walkRadio = require('./edit/walkRadio.js');
16
+ var blur = require('./focus/blur.js');
17
+ var copySelection = require('./focus/copySelection.js');
18
+ var cursor = require('./focus/cursor.js');
19
+ var focus = require('./focus/focus.js');
20
+ var getActiveElement = require('./focus/getActiveElement.js');
21
+ var getTabDestination = require('./focus/getTabDestination.js');
22
+ var isFocusable = require('./focus/isFocusable.js');
23
+ var selectAll = require('./focus/selectAll.js');
24
+ var resolveCaretPosition = require('./focus/resolveCaretPosition.js');
25
+ var selection = require('./focus/selection.js');
26
+ var selector = require('./focus/selector.js');
27
+ var readNextDescriptor = require('./keyDef/readNextDescriptor.js');
28
+ var cloneEvent = require('./misc/cloneEvent.js');
29
+ var eventWrapper = require('./misc/eventWrapper.js');
30
+ var findClosest = require('./misc/findClosest.js');
31
+ var getDocumentFromNode = require('./misc/getDocumentFromNode.js');
32
+ var getTreeDiff = require('./misc/getTreeDiff.js');
33
+ var getWindow = require('./misc/getWindow.js');
34
+ var isDescendantOrSelf = require('./misc/isDescendantOrSelf.js');
35
+ var isElementType = require('./misc/isElementType.js');
36
+ var isVisible = require('./misc/isVisible.js');
37
+ var isDisabled = require('./misc/isDisabled.js');
38
+ var level = require('./misc/level.js');
39
+ var wait = require('./misc/wait.js');
40
+ var cssPointerEvents = require('./pointer/cssPointerEvents.js');
41
+
42
+
43
+
44
+ exports.isClickableInput = isClickableInput.isClickableInput;
45
+ exports.readBlobText = Blob.readBlobText;
46
+ exports.createDataTransfer = DataTransfer.createDataTransfer;
47
+ exports.getBlobFromDataTransferItem = DataTransfer.getBlobFromDataTransferItem;
48
+ exports.createFileList = FileList.createFileList;
49
+ exports.attachClipboardStubToView = Clipboard.attachClipboardStubToView;
50
+ exports.createClipboardItem = Clipboard.createClipboardItem;
51
+ exports.detachClipboardStubFromView = Clipboard.detachClipboardStubFromView;
52
+ exports.readDataTransferFromClipboard = Clipboard.readDataTransferFromClipboard;
53
+ exports.resetClipboardStubOnView = Clipboard.resetClipboardStubOnView;
54
+ exports.writeDataTransferToClipboard = Clipboard.writeDataTransferToClipboard;
55
+ exports.getValue = getValue.getValue;
56
+ exports.input = input.input;
57
+ exports.getContentEditable = isContentEditable.getContentEditable;
58
+ exports.isContentEditable = isContentEditable.isContentEditable;
59
+ Object.defineProperty(exports, 'editableInputTypes', {
60
+ enumerable: true,
61
+ get: function () { return isEditable.editableInputTypes; }
62
+ });
63
+ exports.isEditable = isEditable.isEditable;
64
+ exports.isEditableInput = isEditable.isEditableInput;
65
+ exports.setFiles = setFiles.setFiles;
66
+ exports.walkRadio = walkRadio.walkRadio;
67
+ exports.blur = blur.blur;
68
+ exports.copySelection = copySelection.copySelection;
69
+ exports.getNextCursorPosition = cursor.getNextCursorPosition;
70
+ exports.focus = focus.focus;
71
+ exports.getActiveElement = getActiveElement.getActiveElement;
72
+ exports.getActiveElementOrBody = getActiveElement.getActiveElementOrBody;
73
+ exports.getTabDestination = getTabDestination.getTabDestination;
74
+ exports.isFocusable = isFocusable.isFocusable;
75
+ exports.isAllSelected = selectAll.isAllSelected;
76
+ exports.selectAll = selectAll.selectAll;
77
+ exports.resolveCaretPosition = resolveCaretPosition.resolveCaretPosition;
78
+ exports.getInputRange = selection.getInputRange;
79
+ exports.hasNoSelection = selection.hasNoSelection;
80
+ exports.hasOwnSelection = selection.hasOwnSelection;
81
+ exports.modifySelection = selection.modifySelection;
82
+ exports.modifySelectionPerMouseMove = selection.modifySelectionPerMouseMove;
83
+ exports.moveSelection = selection.moveSelection;
84
+ exports.setSelection = selection.setSelection;
85
+ exports.setSelectionPerMouseDown = selection.setSelectionPerMouseDown;
86
+ exports.setSelectionRange = selection.setSelectionRange;
87
+ exports.updateSelectionOnFocus = selection.updateSelectionOnFocus;
88
+ exports.FOCUSABLE_SELECTOR = selector.FOCUSABLE_SELECTOR;
89
+ exports.readNextDescriptor = readNextDescriptor.readNextDescriptor;
90
+ exports.cloneEvent = cloneEvent.cloneEvent;
91
+ exports.eventWrapper = eventWrapper.eventWrapper;
92
+ exports.findClosest = findClosest.findClosest;
93
+ exports.getDocumentFromNode = getDocumentFromNode.getDocumentFromNode;
94
+ exports.getTreeDiff = getTreeDiff.getTreeDiff;
95
+ exports.getWindow = getWindow.getWindow;
96
+ exports.isDescendantOrSelf = isDescendantOrSelf.isDescendantOrSelf;
97
+ exports.isElementType = isElementType.isElementType;
98
+ exports.isVisible = isVisible.isVisible;
99
+ exports.isDisabled = isDisabled.isDisabled;
100
+ Object.defineProperty(exports, 'ApiLevel', {
101
+ enumerable: true,
102
+ get: function () { return level.ApiLevel; }
103
+ });
104
+ exports.getLevelRef = level.getLevelRef;
105
+ exports.setLevelRef = level.setLevelRef;
106
+ exports.wait = wait.wait;
107
+ exports.assertPointerEvents = cssPointerEvents.assertPointerEvents;
108
+ exports.hasPointerEvents = cssPointerEvents.hasPointerEvents;
@@ -0,0 +1,92 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var bracketDict;
6
+ (function(bracketDict) {
7
+ bracketDict['{'] = '}';
8
+ bracketDict['['] = ']';
9
+ })(bracketDict || (bracketDict = {}));
10
+ /**
11
+ * Read the next key definition from user input
12
+ *
13
+ * Describe key per `{descriptor}` or `[descriptor]`.
14
+ * Everything else will be interpreted as a single character as descriptor - e.g. `a`.
15
+ * Brackets `{` and `[` can be escaped by doubling - e.g. `foo[[bar` translates to `foo[bar`.
16
+ * A previously pressed key can be released per `{/descriptor}`.
17
+ * Keeping the key pressed can be written as `{descriptor>}`.
18
+ * When keeping the key pressed you can choose how long the key is pressed `{descriptor>3}`.
19
+ * You can then release the key per `{descriptor>3/}` or keep it pressed and continue with the next key.
20
+ */ function readNextDescriptor(text, context) {
21
+ let pos = 0;
22
+ const startBracket = text[pos] in bracketDict ? text[pos] : '';
23
+ pos += startBracket.length;
24
+ const isEscapedChar = new RegExp(`^\\${startBracket}{2}`).test(text);
25
+ const type = isEscapedChar ? '' : startBracket;
26
+ return {
27
+ type,
28
+ ...type === '' ? readPrintableChar(text, pos, context) : readTag(text, pos, type, context)
29
+ };
30
+ }
31
+ function readPrintableChar(text, pos, context) {
32
+ const descriptor = text[pos];
33
+ assertDescriptor(descriptor, text, pos, context);
34
+ pos += descriptor.length;
35
+ return {
36
+ consumedLength: pos,
37
+ descriptor,
38
+ releasePrevious: false,
39
+ releaseSelf: true,
40
+ repeat: 1
41
+ };
42
+ }
43
+ function readTag(text, pos, startBracket, context) {
44
+ const releasePreviousModifier = text[pos] === '/' ? '/' : '';
45
+ pos += releasePreviousModifier.length;
46
+ const escapedDescriptor = startBracket === '{' && text[pos] === '\\';
47
+ pos += Number(escapedDescriptor);
48
+ const descriptor = escapedDescriptor ? text[pos] : text.slice(pos).match(startBracket === '{' ? /^\w+|^[^}>/]/ : /^\w+/)?.[0];
49
+ assertDescriptor(descriptor, text, pos, context);
50
+ pos += descriptor.length;
51
+ const repeatModifier = text.slice(pos).match(/^>\d+/)?.[0] ?? '';
52
+ pos += repeatModifier.length;
53
+ const releaseSelfModifier = text[pos] === '/' || !repeatModifier && text[pos] === '>' ? text[pos] : '';
54
+ pos += releaseSelfModifier.length;
55
+ const expectedEndBracket = bracketDict[startBracket];
56
+ const endBracket = text[pos] === expectedEndBracket ? expectedEndBracket : '';
57
+ if (!endBracket) {
58
+ throw new Error(getErrorMessage([
59
+ !repeatModifier && 'repeat modifier',
60
+ !releaseSelfModifier && 'release modifier',
61
+ `"${expectedEndBracket}"`,
62
+ ].filter(Boolean).join(' or '), text[pos], text, context));
63
+ }
64
+ pos += endBracket.length;
65
+ return {
66
+ consumedLength: pos,
67
+ descriptor,
68
+ releasePrevious: !!releasePreviousModifier,
69
+ repeat: repeatModifier ? Math.max(Number(repeatModifier.substr(1)), 1) : 1,
70
+ releaseSelf: hasReleaseSelf(releaseSelfModifier, repeatModifier)
71
+ };
72
+ }
73
+ function assertDescriptor(descriptor, text, pos, context) {
74
+ if (!descriptor) {
75
+ throw new Error(getErrorMessage('key descriptor', text[pos], text, context));
76
+ }
77
+ }
78
+ function hasReleaseSelf(releaseSelfModifier, repeatModifier) {
79
+ if (releaseSelfModifier) {
80
+ return releaseSelfModifier === '/';
81
+ }
82
+ if (repeatModifier) {
83
+ return false;
84
+ }
85
+ }
86
+ function getErrorMessage(expected, found, text, context) {
87
+ return `Expected ${expected} but found "${found ?? ''}" in "${text}"
88
+ See ${context === 'pointer' ? `https://testing-library.com/docs/user-event/pointer#pressing-a-button-or-touching-the-screen` : `https://testing-library.com/docs/user-event/keyboard`}
89
+ for more information about how userEvent parses your input.`;
90
+ }
91
+
92
+ exports.readNextDescriptor = readNextDescriptor;
@@ -0,0 +1,9 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ function cloneEvent(event) {
6
+ return new event.constructor(event.type, event);
7
+ }
8
+
9
+ exports.cloneEvent = cloneEvent;
@@ -0,0 +1,2 @@
1
+ 'use strict';
2
+
@@ -0,0 +1,15 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var dom = require('@testing-library/dom');
6
+
7
+ function eventWrapper(cb) {
8
+ let result;
9
+ dom.getConfig().eventWrapper(()=>{
10
+ result = cb();
11
+ });
12
+ return result;
13
+ }
14
+
15
+ exports.eventWrapper = eventWrapper;
@@ -0,0 +1,16 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ function findClosest(element, callback) {
6
+ let el = element;
7
+ do {
8
+ if (callback(el)) {
9
+ return el;
10
+ }
11
+ el = el.parentElement;
12
+ }while (el && el !== element.ownerDocument.body)
13
+ return undefined;
14
+ }
15
+
16
+ exports.findClosest = findClosest;
@@ -0,0 +1,12 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ function getDocumentFromNode(el) {
6
+ return isDocument(el) ? el : el.ownerDocument;
7
+ }
8
+ function isDocument(node) {
9
+ return node.nodeType === 9;
10
+ }
11
+
12
+ exports.getDocumentFromNode = getDocumentFromNode;
@@ -0,0 +1,27 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ function getTreeDiff(a, b) {
6
+ const treeA = [];
7
+ for(let el = a; el; el = el.parentElement){
8
+ treeA.push(el);
9
+ }
10
+ const treeB = [];
11
+ for(let el1 = b; el1; el1 = el1.parentElement){
12
+ treeB.push(el1);
13
+ }
14
+ let i = 0;
15
+ for(;; i++){
16
+ if (i >= treeA.length || i >= treeB.length || treeA[treeA.length - 1 - i] !== treeB[treeB.length - 1 - i]) {
17
+ break;
18
+ }
19
+ }
20
+ return [
21
+ treeA.slice(0, treeA.length - i),
22
+ treeB.slice(0, treeB.length - i),
23
+ treeB.slice(treeB.length - i),
24
+ ];
25
+ }
26
+
27
+ exports.getTreeDiff = getTreeDiff;
@@ -0,0 +1,11 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var helpers_js = require('@testing-library/dom/dist/helpers.js');
6
+
7
+ function getWindow(node) {
8
+ return helpers_js.getWindowFromNode(node);
9
+ }
10
+
11
+ exports.getWindow = getWindow;
@@ -0,0 +1,16 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ function isDescendantOrSelf(potentialDescendant, potentialAncestor) {
6
+ let el = potentialDescendant;
7
+ do {
8
+ if (el === potentialAncestor) {
9
+ return true;
10
+ }
11
+ el = el.parentElement;
12
+ }while (el)
13
+ return false;
14
+ }
15
+
16
+ exports.isDescendantOrSelf = isDescendantOrSelf;
@@ -0,0 +1,34 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var isElementType = require('./isElementType.js');
6
+
7
+ // This should probably just rely on the :disabled pseudo-class, but JSDOM doesn't implement it properly.
8
+ function isDisabled(element) {
9
+ for(let el = element; el; el = el.parentElement){
10
+ if (isElementType.isElementType(el, [
11
+ 'button',
12
+ 'input',
13
+ 'select',
14
+ 'textarea',
15
+ 'optgroup',
16
+ 'option',
17
+ ])) {
18
+ if (el.hasAttribute('disabled')) {
19
+ return true;
20
+ }
21
+ } else if (isElementType.isElementType(el, 'fieldset')) {
22
+ if (el.hasAttribute('disabled') && !el.querySelector(':scope > legend')?.contains(element)) {
23
+ return true;
24
+ }
25
+ } else if (el.tagName.includes('-')) {
26
+ if (el.constructor.formAssociated && el.hasAttribute('disabled')) {
27
+ return true;
28
+ }
29
+ }
30
+ }
31
+ return false;
32
+ }
33
+
34
+ exports.isDisabled = isDisabled;