@testing-library/user-event 14.2.5 → 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 (242) 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/document/index.d.ts +1 -1
  194. package/dist/types/document/selection.d.ts +1 -0
  195. package/dist/types/document/value.d.ts +4 -5
  196. package/dist/types/event/createEvent.d.ts +2 -8
  197. package/dist/types/event/eventMap.d.ts +204 -181
  198. package/dist/types/event/index.d.ts +1 -2
  199. package/dist/types/event/types.d.ts +6 -0
  200. package/dist/types/index.d.ts +2 -2
  201. package/dist/types/keyboard/index.d.ts +2 -6
  202. package/dist/types/keyboard/keyMap.d.ts +1 -1
  203. package/dist/types/keyboard/parseKeyDef.d.ts +1 -1
  204. package/dist/types/options.d.ts +4 -4
  205. package/dist/types/pointer/index.d.ts +23 -5
  206. package/dist/types/pointer/keyMap.d.ts +1 -1
  207. package/dist/types/pointer/parseKeyDef.d.ts +1 -1
  208. package/dist/types/setup/config.d.ts +3 -7
  209. package/dist/types/setup/directApi.d.ts +21 -16
  210. package/dist/types/setup/index.d.ts +1 -2
  211. package/dist/types/setup/setup.d.ts +7 -1
  212. package/dist/types/system/index.d.ts +10 -0
  213. package/dist/types/system/keyboard.d.ts +53 -0
  214. package/dist/types/system/pointer/buttons.d.ts +23 -0
  215. package/dist/types/system/pointer/device.d.ts +8 -0
  216. package/dist/types/system/pointer/index.d.ts +39 -0
  217. package/dist/types/system/pointer/mouse.d.ts +26 -0
  218. package/dist/types/system/pointer/pointer.d.ts +30 -0
  219. package/dist/types/utils/click/isClickableInput.d.ts +15 -1
  220. package/dist/types/utils/edit/walkRadio.d.ts +4 -0
  221. package/dist/types/utils/focus/getActiveElement.d.ts +1 -0
  222. package/dist/types/utils/focus/resolveCaretPosition.d.ts +8 -0
  223. package/dist/types/utils/focus/selection.d.ts +28 -1
  224. package/dist/types/utils/index.d.ts +3 -3
  225. package/dist/types/utils/misc/getTreeDiff.d.ts +1 -0
  226. package/dist/types/utils/pointer/cssPointerEvents.d.ts +6 -2
  227. package/package.json +9 -15
  228. package/dist/index.cjs +0 -3057
  229. package/dist/index.mjs +0 -3107
  230. package/dist/types/event/eventTypes.d.ts +0 -2
  231. package/dist/types/keyboard/keyboardAction.d.ts +0 -10
  232. package/dist/types/keyboard/modifiers.d.ts +0 -9
  233. package/dist/types/keyboard/types.d.ts +0 -73
  234. package/dist/types/pointer/firePointerEvents.d.ts +0 -11
  235. package/dist/types/pointer/pointerAction.d.ts +0 -7
  236. package/dist/types/pointer/pointerMove.d.ts +0 -6
  237. package/dist/types/pointer/pointerPress.d.ts +0 -8
  238. package/dist/types/pointer/resolveSelectionTarget.d.ts +0 -5
  239. package/dist/types/pointer/types.d.ts +0 -62
  240. package/dist/types/utils/keyboard/getKeyEventProps.d.ts +0 -5
  241. package/dist/types/utils/keyboard/getUIEventModifiers.d.ts +0 -15
  242. package/dist/types/utils/pointer/mouseButtons.d.ts +0 -12
@@ -0,0 +1,36 @@
1
+ export { isClickableInput } from './click/isClickableInput.js';
2
+ export { readBlobText } from './dataTransfer/Blob.js';
3
+ export { createDataTransfer, getBlobFromDataTransferItem } from './dataTransfer/DataTransfer.js';
4
+ export { createFileList } from './dataTransfer/FileList.js';
5
+ export { attachClipboardStubToView, createClipboardItem, detachClipboardStubFromView, readDataTransferFromClipboard, resetClipboardStubOnView, writeDataTransferToClipboard } from './dataTransfer/Clipboard.js';
6
+ export { getValue } from './edit/getValue.js';
7
+ export { input } from './edit/input.js';
8
+ export { getContentEditable, isContentEditable } from './edit/isContentEditable.js';
9
+ export { editableInputTypes, isEditable, isEditableInput } from './edit/isEditable.js';
10
+ export { setFiles } from './edit/setFiles.js';
11
+ export { walkRadio } from './edit/walkRadio.js';
12
+ export { blur } from './focus/blur.js';
13
+ export { copySelection } from './focus/copySelection.js';
14
+ export { getNextCursorPosition } from './focus/cursor.js';
15
+ export { focus } from './focus/focus.js';
16
+ export { getActiveElement, getActiveElementOrBody } from './focus/getActiveElement.js';
17
+ export { getTabDestination } from './focus/getTabDestination.js';
18
+ export { isFocusable } from './focus/isFocusable.js';
19
+ export { isAllSelected, selectAll } from './focus/selectAll.js';
20
+ export { resolveCaretPosition } from './focus/resolveCaretPosition.js';
21
+ export { getInputRange, hasNoSelection, hasOwnSelection, modifySelection, modifySelectionPerMouseMove, moveSelection, setSelection, setSelectionPerMouseDown, setSelectionRange, updateSelectionOnFocus } from './focus/selection.js';
22
+ export { FOCUSABLE_SELECTOR } from './focus/selector.js';
23
+ export { readNextDescriptor } from './keyDef/readNextDescriptor.js';
24
+ export { cloneEvent } from './misc/cloneEvent.js';
25
+ export { eventWrapper } from './misc/eventWrapper.js';
26
+ export { findClosest } from './misc/findClosest.js';
27
+ export { getDocumentFromNode } from './misc/getDocumentFromNode.js';
28
+ export { getTreeDiff } from './misc/getTreeDiff.js';
29
+ export { getWindow } from './misc/getWindow.js';
30
+ export { isDescendantOrSelf } from './misc/isDescendantOrSelf.js';
31
+ export { isElementType } from './misc/isElementType.js';
32
+ export { isVisible } from './misc/isVisible.js';
33
+ export { isDisabled } from './misc/isDisabled.js';
34
+ export { ApiLevel, getLevelRef, setLevelRef } from './misc/level.js';
35
+ export { wait } from './misc/wait.js';
36
+ export { assertPointerEvents, hasPointerEvents } from './pointer/cssPointerEvents.js';
@@ -0,0 +1,88 @@
1
+ var bracketDict;
2
+ (function(bracketDict) {
3
+ bracketDict['{'] = '}';
4
+ bracketDict['['] = ']';
5
+ })(bracketDict || (bracketDict = {}));
6
+ /**
7
+ * Read the next key definition from user input
8
+ *
9
+ * Describe key per `{descriptor}` or `[descriptor]`.
10
+ * Everything else will be interpreted as a single character as descriptor - e.g. `a`.
11
+ * Brackets `{` and `[` can be escaped by doubling - e.g. `foo[[bar` translates to `foo[bar`.
12
+ * A previously pressed key can be released per `{/descriptor}`.
13
+ * Keeping the key pressed can be written as `{descriptor>}`.
14
+ * When keeping the key pressed you can choose how long the key is pressed `{descriptor>3}`.
15
+ * You can then release the key per `{descriptor>3/}` or keep it pressed and continue with the next key.
16
+ */ function readNextDescriptor(text, context) {
17
+ let pos = 0;
18
+ const startBracket = text[pos] in bracketDict ? text[pos] : '';
19
+ pos += startBracket.length;
20
+ const isEscapedChar = new RegExp(`^\\${startBracket}{2}`).test(text);
21
+ const type = isEscapedChar ? '' : startBracket;
22
+ return {
23
+ type,
24
+ ...type === '' ? readPrintableChar(text, pos, context) : readTag(text, pos, type, context)
25
+ };
26
+ }
27
+ function readPrintableChar(text, pos, context) {
28
+ const descriptor = text[pos];
29
+ assertDescriptor(descriptor, text, pos, context);
30
+ pos += descriptor.length;
31
+ return {
32
+ consumedLength: pos,
33
+ descriptor,
34
+ releasePrevious: false,
35
+ releaseSelf: true,
36
+ repeat: 1
37
+ };
38
+ }
39
+ function readTag(text, pos, startBracket, context) {
40
+ const releasePreviousModifier = text[pos] === '/' ? '/' : '';
41
+ pos += releasePreviousModifier.length;
42
+ const escapedDescriptor = startBracket === '{' && text[pos] === '\\';
43
+ pos += Number(escapedDescriptor);
44
+ const descriptor = escapedDescriptor ? text[pos] : text.slice(pos).match(startBracket === '{' ? /^\w+|^[^}>/]/ : /^\w+/)?.[0];
45
+ assertDescriptor(descriptor, text, pos, context);
46
+ pos += descriptor.length;
47
+ const repeatModifier = text.slice(pos).match(/^>\d+/)?.[0] ?? '';
48
+ pos += repeatModifier.length;
49
+ const releaseSelfModifier = text[pos] === '/' || !repeatModifier && text[pos] === '>' ? text[pos] : '';
50
+ pos += releaseSelfModifier.length;
51
+ const expectedEndBracket = bracketDict[startBracket];
52
+ const endBracket = text[pos] === expectedEndBracket ? expectedEndBracket : '';
53
+ if (!endBracket) {
54
+ throw new Error(getErrorMessage([
55
+ !repeatModifier && 'repeat modifier',
56
+ !releaseSelfModifier && 'release modifier',
57
+ `"${expectedEndBracket}"`,
58
+ ].filter(Boolean).join(' or '), text[pos], text, context));
59
+ }
60
+ pos += endBracket.length;
61
+ return {
62
+ consumedLength: pos,
63
+ descriptor,
64
+ releasePrevious: !!releasePreviousModifier,
65
+ repeat: repeatModifier ? Math.max(Number(repeatModifier.substr(1)), 1) : 1,
66
+ releaseSelf: hasReleaseSelf(releaseSelfModifier, repeatModifier)
67
+ };
68
+ }
69
+ function assertDescriptor(descriptor, text, pos, context) {
70
+ if (!descriptor) {
71
+ throw new Error(getErrorMessage('key descriptor', text[pos], text, context));
72
+ }
73
+ }
74
+ function hasReleaseSelf(releaseSelfModifier, repeatModifier) {
75
+ if (releaseSelfModifier) {
76
+ return releaseSelfModifier === '/';
77
+ }
78
+ if (repeatModifier) {
79
+ return false;
80
+ }
81
+ }
82
+ function getErrorMessage(expected, found, text, context) {
83
+ return `Expected ${expected} but found "${found ?? ''}" in "${text}"
84
+ 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`}
85
+ for more information about how userEvent parses your input.`;
86
+ }
87
+
88
+ export { readNextDescriptor };
@@ -0,0 +1,5 @@
1
+ function cloneEvent(event) {
2
+ return new event.constructor(event.type, event);
3
+ }
4
+
5
+ export { cloneEvent };
@@ -0,0 +1,11 @@
1
+ import { getConfig } from '@testing-library/dom';
2
+
3
+ function eventWrapper(cb) {
4
+ let result;
5
+ getConfig().eventWrapper(()=>{
6
+ result = cb();
7
+ });
8
+ return result;
9
+ }
10
+
11
+ export { eventWrapper };
@@ -0,0 +1,12 @@
1
+ function findClosest(element, callback) {
2
+ let el = element;
3
+ do {
4
+ if (callback(el)) {
5
+ return el;
6
+ }
7
+ el = el.parentElement;
8
+ }while (el && el !== element.ownerDocument.body)
9
+ return undefined;
10
+ }
11
+
12
+ export { findClosest };
@@ -0,0 +1,8 @@
1
+ function getDocumentFromNode(el) {
2
+ return isDocument(el) ? el : el.ownerDocument;
3
+ }
4
+ function isDocument(node) {
5
+ return node.nodeType === 9;
6
+ }
7
+
8
+ export { getDocumentFromNode };
@@ -0,0 +1,23 @@
1
+ function getTreeDiff(a, b) {
2
+ const treeA = [];
3
+ for(let el = a; el; el = el.parentElement){
4
+ treeA.push(el);
5
+ }
6
+ const treeB = [];
7
+ for(let el1 = b; el1; el1 = el1.parentElement){
8
+ treeB.push(el1);
9
+ }
10
+ let i = 0;
11
+ for(;; i++){
12
+ if (i >= treeA.length || i >= treeB.length || treeA[treeA.length - 1 - i] !== treeB[treeB.length - 1 - i]) {
13
+ break;
14
+ }
15
+ }
16
+ return [
17
+ treeA.slice(0, treeA.length - i),
18
+ treeB.slice(0, treeB.length - i),
19
+ treeB.slice(treeB.length - i),
20
+ ];
21
+ }
22
+
23
+ export { getTreeDiff };
@@ -0,0 +1,7 @@
1
+ import { getWindowFromNode } from '@testing-library/dom/dist/helpers.js';
2
+
3
+ function getWindow(node) {
4
+ return getWindowFromNode(node);
5
+ }
6
+
7
+ export { getWindow };
@@ -0,0 +1,12 @@
1
+ function isDescendantOrSelf(potentialDescendant, potentialAncestor) {
2
+ let el = potentialDescendant;
3
+ do {
4
+ if (el === potentialAncestor) {
5
+ return true;
6
+ }
7
+ el = el.parentElement;
8
+ }while (el)
9
+ return false;
10
+ }
11
+
12
+ export { isDescendantOrSelf };
@@ -0,0 +1,30 @@
1
+ import { isElementType } from './isElementType.js';
2
+
3
+ // This should probably just rely on the :disabled pseudo-class, but JSDOM doesn't implement it properly.
4
+ function isDisabled(element) {
5
+ for(let el = element; el; el = el.parentElement){
6
+ if (isElementType(el, [
7
+ 'button',
8
+ 'input',
9
+ 'select',
10
+ 'textarea',
11
+ 'optgroup',
12
+ 'option',
13
+ ])) {
14
+ if (el.hasAttribute('disabled')) {
15
+ return true;
16
+ }
17
+ } else if (isElementType(el, 'fieldset')) {
18
+ if (el.hasAttribute('disabled') && !el.querySelector(':scope > legend')?.contains(element)) {
19
+ return true;
20
+ }
21
+ } else if (el.tagName.includes('-')) {
22
+ if (el.constructor.formAssociated && el.hasAttribute('disabled')) {
23
+ return true;
24
+ }
25
+ }
26
+ }
27
+ return false;
28
+ }
29
+
30
+ export { isDisabled };
@@ -0,0 +1,18 @@
1
+ function isElementType(element, tag, props) {
2
+ if (element.namespaceURI && element.namespaceURI !== 'http://www.w3.org/1999/xhtml') {
3
+ return false;
4
+ }
5
+ tag = Array.isArray(tag) ? tag : [
6
+ tag
7
+ ];
8
+ // tagName is uppercase in HTMLDocument and lowercase in XMLDocument
9
+ if (!tag.includes(element.tagName.toLowerCase())) {
10
+ return false;
11
+ }
12
+ if (props) {
13
+ return Object.entries(props).every(([k, v])=>element[k] === v);
14
+ }
15
+ return true;
16
+ }
17
+
18
+ export { isElementType };
@@ -0,0 +1,17 @@
1
+ import { getWindow } from './getWindow.js';
2
+
3
+ function isVisible(element) {
4
+ const window = getWindow(element);
5
+ for(let el = element; el?.ownerDocument; el = el.parentElement){
6
+ const { display , visibility } = window.getComputedStyle(el);
7
+ if (display === 'none') {
8
+ return false;
9
+ }
10
+ if (visibility === 'hidden') {
11
+ return false;
12
+ }
13
+ }
14
+ return true;
15
+ }
16
+
17
+ export { isVisible };
@@ -0,0 +1,15 @@
1
+ var ApiLevel;
2
+ (function(ApiLevel) {
3
+ ApiLevel[ApiLevel["Trigger"] = 2] = "Trigger";
4
+ ApiLevel[ApiLevel["Call"] = 1] = "Call";
5
+ })(ApiLevel || (ApiLevel = {}));
6
+ const Level = Symbol('Api level refs');
7
+ function setLevelRef(config, level) {
8
+ config[Level] ??= {};
9
+ config[Level][level] = {};
10
+ }
11
+ function getLevelRef(config, level) {
12
+ return config[Level]?.[level];
13
+ }
14
+
15
+ export { ApiLevel, getLevelRef, setLevelRef };
@@ -0,0 +1,12 @@
1
+ function wait(config) {
2
+ const delay = config.delay;
3
+ if (typeof delay !== 'number') {
4
+ return;
5
+ }
6
+ return Promise.all([
7
+ new Promise((resolve)=>globalThis.setTimeout(()=>resolve(), delay)),
8
+ config.advanceTimers(delay),
9
+ ]);
10
+ }
11
+
12
+ export { wait };
@@ -0,0 +1,106 @@
1
+ import { PointerEventsCheckLevel } from '../../options.js';
2
+ import '../click/isClickableInput.js';
3
+ import '../dataTransfer/Clipboard.js';
4
+ import '../../event/eventMap.js';
5
+ import '../../event/behavior/click.js';
6
+ import '../../event/behavior/cut.js';
7
+ import '../../event/behavior/keydown.js';
8
+ import '../../event/behavior/keypress.js';
9
+ import '../../event/behavior/keyup.js';
10
+ import '../../event/behavior/paste.js';
11
+ import '@testing-library/dom';
12
+ import '../edit/maxLength.js';
13
+ import '../edit/isEditable.js';
14
+ import { isElementType } from '../misc/isElementType.js';
15
+ import { getWindow } from '../misc/getWindow.js';
16
+ import '../keyDef/readNextDescriptor.js';
17
+ import { ApiLevel, getLevelRef } from '../misc/level.js';
18
+
19
+ function hasPointerEvents(config, element) {
20
+ return checkPointerEvents(config, element)?.pointerEvents !== 'none';
21
+ }
22
+ function closestPointerEventsDeclaration(element) {
23
+ const window = getWindow(element);
24
+ for(let el = element, tree = []; el?.ownerDocument; el = el.parentElement){
25
+ tree.push(el);
26
+ const pointerEvents = window.getComputedStyle(el).pointerEvents;
27
+ if (pointerEvents && ![
28
+ 'inherit',
29
+ 'unset'
30
+ ].includes(pointerEvents)) {
31
+ return {
32
+ pointerEvents,
33
+ tree
34
+ };
35
+ }
36
+ }
37
+ return undefined;
38
+ }
39
+ const PointerEventsCheck = Symbol('Last check for pointer-events');
40
+ function checkPointerEvents(config, element) {
41
+ const lastCheck = element[PointerEventsCheck];
42
+ const needsCheck = config.pointerEventsCheck !== PointerEventsCheckLevel.Never && (!lastCheck || hasBitFlag(config.pointerEventsCheck, PointerEventsCheckLevel.EachApiCall) && lastCheck[ApiLevel.Call] !== getLevelRef(config, ApiLevel.Call) || hasBitFlag(config.pointerEventsCheck, PointerEventsCheckLevel.EachTrigger) && lastCheck[ApiLevel.Trigger] !== getLevelRef(config, ApiLevel.Trigger));
43
+ if (!needsCheck) {
44
+ return lastCheck?.result;
45
+ }
46
+ const declaration = closestPointerEventsDeclaration(element);
47
+ element[PointerEventsCheck] = {
48
+ [ApiLevel.Call]: getLevelRef(config, ApiLevel.Call),
49
+ [ApiLevel.Trigger]: getLevelRef(config, ApiLevel.Trigger),
50
+ result: declaration
51
+ };
52
+ return declaration;
53
+ }
54
+ function assertPointerEvents(config, element) {
55
+ const declaration = checkPointerEvents(config, element);
56
+ if (declaration?.pointerEvents === 'none') {
57
+ throw new Error([
58
+ `Unable to perform pointer interaction as the element ${declaration.tree.length > 1 ? 'inherits' : 'has'} \`pointer-events: none\`:`,
59
+ '',
60
+ printTree(declaration.tree),
61
+ ].join('\n'));
62
+ }
63
+ }
64
+ function printTree(tree) {
65
+ return tree.reverse().map((el, i)=>[
66
+ ''.padEnd(i),
67
+ el.tagName,
68
+ el.id && `#${el.id}`,
69
+ el.hasAttribute('data-testid') && `(testId=${el.getAttribute('data-testid')})`,
70
+ getLabelDescr(el),
71
+ tree.length > 1 && i === 0 && ' <-- This element declared `pointer-events: none`',
72
+ tree.length > 1 && i === tree.length - 1 && ' <-- Asserted pointer events here',
73
+ ].filter(Boolean).join('')).join('\n');
74
+ }
75
+ function getLabelDescr(element) {
76
+ let label;
77
+ if (element.hasAttribute('aria-label')) {
78
+ label = element.getAttribute('aria-label');
79
+ } else if (element.hasAttribute('aria-labelledby')) {
80
+ label = element.ownerDocument.getElementById(element.getAttribute('aria-labelledby'))?.textContent?.trim();
81
+ } else if (isElementType(element, [
82
+ 'button',
83
+ 'input',
84
+ 'meter',
85
+ 'output',
86
+ 'progress',
87
+ 'select',
88
+ 'textarea',
89
+ ]) && element.labels?.length) {
90
+ label = Array.from(element.labels).map((el)=>el.textContent?.trim()).join('|');
91
+ } else if (isElementType(element, 'button')) {
92
+ label = element.textContent?.trim();
93
+ }
94
+ label = label?.replace(/\n/g, ' ');
95
+ if (Number(label?.length) > 30) {
96
+ label = `${label?.substring(0, 29)}…`;
97
+ }
98
+ return label ? `(label=${label})` : '';
99
+ }
100
+ // With the eslint rule and prettier the bitwise operation isn't nice to read
101
+ function hasBitFlag(conf, flag) {
102
+ // eslint-disable-next-line no-bitwise
103
+ return (conf & flag) > 0;
104
+ }
105
+
106
+ export { assertPointerEvents, hasPointerEvents };
@@ -5,6 +5,6 @@ declare global {
5
5
  }
6
6
  }
7
7
  export declare function prepareDocument(document: Document): void;
8
- export { getUIValue, setUIValue, startTrackValue, endTrackValue, clearInitialValue, } from './value';
8
+ export { getUIValue, setUIValue, commitValueAfterInput, clearInitialValue, } from './value';
9
9
  export { getUISelection, setUISelection } from './selection';
10
10
  export type { UISelectionRange } from './selection';
@@ -23,6 +23,7 @@ export declare function getUISelection(element: HTMLInputElement | HTMLTextAreaE
23
23
  anchorOffset: number;
24
24
  focusOffset: number;
25
25
  };
26
+ export declare function hasUISelection(element: HTMLInputElement | HTMLTextAreaElement): boolean;
26
27
  /** Flag the IDL selection as clean. This does not change the selection. */
27
28
  export declare function setUISelectionClean(element: HTMLInputElement | HTMLTextAreaElement): void;
28
29
  export {};
@@ -2,6 +2,9 @@ declare const UIValue: unique symbol;
2
2
  declare const InitialValue: unique symbol;
3
3
  declare const TrackChanges: unique symbol;
4
4
  declare global {
5
+ interface Window {
6
+ REACT_VERSION?: number;
7
+ }
5
8
  interface Element {
6
9
  [UIValue]?: string;
7
10
  [InitialValue]?: string;
@@ -19,9 +22,5 @@ export declare function getUIValue(element: HTMLInputElement | HTMLTextAreaEleme
19
22
  export declare function setUIValueClean(element: HTMLInputElement | HTMLTextAreaElement): void;
20
23
  export declare function clearInitialValue(element: HTMLInputElement | HTMLTextAreaElement): void;
21
24
  export declare function getInitialValue(element: HTMLInputElement | HTMLTextAreaElement): string | undefined;
22
- export declare function startTrackValue(element: HTMLInputElement | HTMLTextAreaElement): void;
23
- /**
24
- * @returns `true` if we recognize a React state reset and update
25
- */
26
- export declare function endTrackValue(element: HTMLInputElement | HTMLTextAreaElement): boolean;
25
+ export declare function commitValueAfterInput(element: HTMLInputElement | HTMLTextAreaElement, cursorOffset: number): void;
27
26
  export {};
@@ -1,8 +1,2 @@
1
- import { EventType } from './types';
2
- export declare type EventTypeInit<K extends EventType> = SpecificEventInit<FixedDocumentEventMap[K]>;
3
- interface FixedDocumentEventMap extends DocumentEventMap {
4
- input: InputEvent;
5
- }
6
- declare type SpecificEventInit<E extends Event> = E extends InputEvent ? InputEventInit : E extends ClipboardEvent ? ClipboardEventInit : E extends KeyboardEvent ? KeyboardEventInit : E extends PointerEvent ? PointerEventInit : E extends MouseEvent ? MouseEventInit : E extends UIEvent ? UIEventInit : EventInit;
7
- export declare function createEvent<K extends EventType>(type: K, target: Element, init?: EventTypeInit<K>): DocumentEventMap[K];
8
- export {};
1
+ import type { EventType, EventTypeInit, FixedDocumentEventMap } from './types';
2
+ export declare function createEvent<K extends EventType>(type: K, target: Element, init?: EventTypeInit<K>): FixedDocumentEventMap[K];