@testing-library/user-event 14.4.0 → 14.4.3

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 (231) hide show
  1. package/dist/cjs/clipboard/copy.js +6 -15
  2. package/dist/cjs/clipboard/cut.js +6 -15
  3. package/dist/cjs/clipboard/paste.js +6 -14
  4. package/dist/cjs/convenience/click.js +1 -4
  5. package/dist/cjs/convenience/hover.js +2 -12
  6. package/dist/cjs/document/UI.js +94 -0
  7. package/dist/cjs/document/copySelection.js +37 -0
  8. package/dist/cjs/document/getValueOrTextContent.js +27 -0
  9. package/dist/cjs/document/index.js +13 -68
  10. package/dist/cjs/document/interceptor.js +87 -4
  11. package/dist/cjs/document/prepareDocument.js +67 -0
  12. package/dist/cjs/document/trackValue.js +65 -0
  13. package/dist/cjs/event/behavior/click.js +8 -12
  14. package/dist/cjs/event/behavior/cut.js +5 -11
  15. package/dist/cjs/event/behavior/keydown.js +43 -43
  16. package/dist/cjs/event/behavior/keypress.js +9 -10
  17. package/dist/cjs/event/behavior/keyup.js +6 -7
  18. package/dist/cjs/event/behavior/paste.js +7 -12
  19. package/dist/cjs/event/createEvent.js +37 -28
  20. package/dist/cjs/event/dispatchEvent.js +21 -2
  21. package/dist/cjs/event/focus.js +44 -0
  22. package/dist/cjs/event/index.js +24 -17
  23. package/dist/cjs/{utils/edit → event}/input.js +50 -47
  24. package/dist/cjs/{utils/edit/walkRadio.js → event/radio.js} +13 -7
  25. package/dist/cjs/event/selection/getInputRange.js +20 -0
  26. package/dist/cjs/event/selection/getTargetTypeAndSelection.js +40 -0
  27. package/dist/cjs/event/selection/index.js +26 -0
  28. package/dist/cjs/event/selection/modifySelection.js +30 -0
  29. package/dist/cjs/event/selection/modifySelectionPerMouse.js +49 -0
  30. package/dist/cjs/event/selection/moveSelection.js +47 -0
  31. package/dist/cjs/{utils/focus → event/selection}/resolveCaretPosition.js +11 -19
  32. package/dist/cjs/event/selection/selectAll.js +47 -0
  33. package/dist/cjs/event/selection/setSelection.js +30 -0
  34. package/dist/cjs/event/selection/setSelectionPerMouse.js +90 -0
  35. package/dist/cjs/event/selection/setSelectionRange.js +40 -0
  36. package/dist/cjs/event/selection/updateSelectionOnFocus.js +45 -0
  37. package/dist/cjs/keyboard/index.js +13 -23
  38. package/dist/cjs/keyboard/parseKeyDef.js +8 -13
  39. package/dist/cjs/options.js +0 -28
  40. package/dist/cjs/pointer/index.js +28 -34
  41. package/dist/cjs/pointer/parseKeyDef.js +1 -9
  42. package/dist/cjs/setup/directApi.js +6 -6
  43. package/dist/cjs/setup/index.js +0 -2
  44. package/dist/cjs/setup/setup.js +69 -38
  45. package/dist/cjs/system/index.js +4 -2
  46. package/dist/cjs/system/keyboard.js +32 -32
  47. package/dist/cjs/system/pointer/buttons.js +3 -1
  48. package/dist/cjs/system/pointer/device.js +3 -1
  49. package/dist/cjs/system/pointer/index.js +82 -79
  50. package/dist/cjs/system/pointer/mouse.js +97 -81
  51. package/dist/cjs/system/pointer/pointer.js +45 -46
  52. package/dist/cjs/system/pointer/shared.js +10 -0
  53. package/dist/cjs/utility/clear.js +10 -11
  54. package/dist/cjs/utility/selectOptions.js +17 -19
  55. package/dist/cjs/utility/type.js +6 -15
  56. package/dist/cjs/utility/upload.js +9 -15
  57. package/dist/cjs/utils/dataTransfer/Clipboard.js +11 -21
  58. package/dist/cjs/utils/dataTransfer/DataTransfer.js +22 -19
  59. package/dist/cjs/utils/edit/isEditable.js +6 -10
  60. package/dist/cjs/utils/edit/maxLength.js +6 -16
  61. package/dist/cjs/utils/edit/setFiles.js +4 -2
  62. package/dist/cjs/utils/edit/{buildTimeValue.js → timeValue.js} +6 -0
  63. package/dist/cjs/utils/focus/cursor.js +2 -17
  64. package/dist/cjs/utils/focus/getActiveElement.js +3 -2
  65. package/dist/cjs/utils/focus/selection.js +1 -266
  66. package/dist/cjs/utils/index.js +7 -32
  67. package/dist/cjs/utils/keyDef/readNextDescriptor.js +5 -3
  68. package/dist/cjs/utils/misc/isDisabled.js +2 -1
  69. package/dist/cjs/utils/misc/isVisible.js +1 -1
  70. package/dist/cjs/utils/misc/level.js +4 -6
  71. package/dist/cjs/utils/pointer/cssPointerEvents.js +26 -32
  72. package/dist/esm/clipboard/copy.js +6 -15
  73. package/dist/esm/clipboard/cut.js +6 -15
  74. package/dist/esm/clipboard/paste.js +6 -14
  75. package/dist/esm/convenience/click.js +1 -4
  76. package/dist/esm/convenience/hover.js +2 -12
  77. package/dist/esm/document/UI.js +79 -0
  78. package/dist/esm/document/copySelection.js +33 -0
  79. package/dist/esm/document/getValueOrTextContent.js +23 -0
  80. package/dist/esm/document/index.js +4 -66
  81. package/dist/esm/document/interceptor.js +85 -5
  82. package/dist/esm/document/prepareDocument.js +63 -0
  83. package/dist/esm/document/trackValue.js +59 -0
  84. package/dist/esm/event/behavior/click.js +8 -12
  85. package/dist/esm/event/behavior/cut.js +5 -11
  86. package/dist/esm/event/behavior/keydown.js +36 -36
  87. package/dist/esm/event/behavior/keypress.js +9 -10
  88. package/dist/esm/event/behavior/keyup.js +6 -7
  89. package/dist/esm/event/behavior/paste.js +7 -12
  90. package/dist/esm/event/createEvent.js +37 -28
  91. package/dist/esm/event/dispatchEvent.js +20 -3
  92. package/dist/esm/event/focus.js +39 -0
  93. package/dist/esm/event/index.js +14 -19
  94. package/dist/esm/{utils/edit → event}/input.js +37 -34
  95. package/dist/esm/{utils/edit/walkRadio.js → event/radio.js} +13 -7
  96. package/dist/esm/event/selection/getInputRange.js +16 -0
  97. package/dist/esm/event/selection/getTargetTypeAndSelection.js +36 -0
  98. package/dist/esm/event/selection/index.js +9 -0
  99. package/dist/esm/event/selection/modifySelection.js +26 -0
  100. package/dist/esm/event/selection/modifySelectionPerMouse.js +45 -0
  101. package/dist/esm/event/selection/moveSelection.js +43 -0
  102. package/dist/esm/{utils/focus → event/selection}/resolveCaretPosition.js +11 -19
  103. package/dist/esm/event/selection/selectAll.js +42 -0
  104. package/dist/esm/event/selection/setSelection.js +26 -0
  105. package/dist/esm/event/selection/setSelectionPerMouse.js +86 -0
  106. package/dist/esm/event/selection/setSelectionRange.js +36 -0
  107. package/dist/esm/event/selection/updateSelectionOnFocus.js +41 -0
  108. package/dist/esm/keyboard/index.js +13 -23
  109. package/dist/esm/keyboard/parseKeyDef.js +8 -13
  110. package/dist/esm/options.js +1 -26
  111. package/dist/esm/pointer/index.js +28 -34
  112. package/dist/esm/pointer/parseKeyDef.js +1 -9
  113. package/dist/esm/setup/directApi.js +6 -6
  114. package/dist/esm/setup/index.js +0 -1
  115. package/dist/esm/setup/setup.js +63 -33
  116. package/dist/esm/system/index.js +4 -2
  117. package/dist/esm/system/keyboard.js +32 -32
  118. package/dist/esm/system/pointer/buttons.js +3 -1
  119. package/dist/esm/system/pointer/device.js +3 -1
  120. package/dist/esm/system/pointer/index.js +83 -79
  121. package/dist/esm/system/pointer/mouse.js +95 -79
  122. package/dist/esm/system/pointer/pointer.js +44 -45
  123. package/dist/esm/system/pointer/shared.js +6 -0
  124. package/dist/esm/utility/clear.js +10 -11
  125. package/dist/esm/utility/selectOptions.js +17 -19
  126. package/dist/esm/utility/type.js +6 -15
  127. package/dist/esm/utility/upload.js +9 -15
  128. package/dist/esm/utils/dataTransfer/Clipboard.js +11 -21
  129. package/dist/esm/utils/dataTransfer/DataTransfer.js +22 -19
  130. package/dist/esm/utils/edit/isEditable.js +4 -8
  131. package/dist/esm/utils/edit/maxLength.js +5 -16
  132. package/dist/esm/utils/edit/setFiles.js +4 -2
  133. package/dist/esm/utils/edit/{buildTimeValue.js → timeValue.js} +6 -1
  134. package/dist/esm/utils/focus/cursor.js +2 -17
  135. package/dist/esm/utils/focus/getActiveElement.js +3 -2
  136. package/dist/esm/utils/focus/selection.js +3 -260
  137. package/dist/esm/utils/index.js +4 -11
  138. package/dist/esm/utils/keyDef/readNextDescriptor.js +5 -3
  139. package/dist/esm/utils/misc/isDisabled.js +2 -1
  140. package/dist/esm/utils/misc/isVisible.js +1 -1
  141. package/dist/esm/utils/misc/level.js +4 -6
  142. package/dist/esm/utils/pointer/cssPointerEvents.js +26 -32
  143. package/dist/types/clipboard/copy.d.ts +1 -1
  144. package/dist/types/clipboard/cut.d.ts +1 -1
  145. package/dist/types/clipboard/paste.d.ts +1 -1
  146. package/dist/types/convenience/click.d.ts +1 -1
  147. package/dist/types/convenience/hover.d.ts +1 -1
  148. package/dist/types/document/UI.d.ts +42 -0
  149. package/dist/types/{utils/focus → document}/copySelection.d.ts +0 -0
  150. package/dist/types/document/getValueOrTextContent.d.ts +1 -0
  151. package/dist/types/document/index.d.ts +5 -10
  152. package/dist/types/document/interceptor.d.ts +3 -0
  153. package/dist/types/document/prepareDocument.d.ts +8 -0
  154. package/dist/types/document/trackValue.d.ts +17 -0
  155. package/dist/types/event/behavior/registry.d.ts +2 -2
  156. package/dist/types/event/dispatchEvent.d.ts +5 -2
  157. package/dist/types/event/focus.d.ts +5 -0
  158. package/dist/types/event/index.d.ts +6 -4
  159. package/dist/types/event/input.d.ts +2 -0
  160. package/dist/types/event/radio.d.ts +4 -0
  161. package/dist/types/event/selection/getInputRange.d.ts +5 -0
  162. package/dist/types/event/selection/getTargetTypeAndSelection.d.ts +10 -0
  163. package/dist/types/event/selection/index.d.ts +15 -0
  164. package/dist/types/event/selection/modifySelection.d.ts +8 -0
  165. package/dist/types/event/selection/modifySelectionPerMouse.d.ts +7 -0
  166. package/dist/types/event/selection/moveSelection.d.ts +4 -0
  167. package/dist/types/{utils/focus → event/selection}/resolveCaretPosition.d.ts +0 -0
  168. package/dist/types/{utils/focus → event/selection}/selectAll.d.ts +0 -0
  169. package/dist/types/event/selection/setSelection.d.ts +10 -0
  170. package/dist/types/event/selection/setSelectionPerMouse.d.ts +8 -0
  171. package/dist/types/event/selection/setSelectionRange.d.ts +6 -0
  172. package/dist/types/event/selection/updateSelectionOnFocus.d.ts +5 -0
  173. package/dist/types/keyboard/index.d.ts +2 -2
  174. package/dist/types/options.d.ts +0 -8
  175. package/dist/types/pointer/index.d.ts +3 -3
  176. package/dist/types/setup/directApi.d.ts +1 -1
  177. package/dist/types/setup/index.d.ts +2 -15
  178. package/dist/types/setup/setup.d.ts +25 -7
  179. package/dist/types/system/keyboard.d.ts +3 -3
  180. package/dist/types/system/pointer/buttons.d.ts +1 -1
  181. package/dist/types/system/pointer/index.d.ts +7 -25
  182. package/dist/types/system/pointer/mouse.d.ts +5 -5
  183. package/dist/types/system/pointer/pointer.d.ts +7 -7
  184. package/dist/types/system/pointer/shared.d.ts +20 -0
  185. package/dist/types/utility/clear.d.ts +1 -1
  186. package/dist/types/utility/selectOptions.d.ts +1 -1
  187. package/dist/types/utility/type.d.ts +3 -3
  188. package/dist/types/utility/upload.d.ts +1 -1
  189. package/dist/types/utils/click/isClickableInput.d.ts +2 -2
  190. package/dist/types/utils/edit/isEditable.d.ts +5 -6
  191. package/dist/types/utils/edit/maxLength.d.ts +14 -1
  192. package/dist/types/utils/edit/{isValidDateOrTimeValue.d.ts → timeValue.d.ts} +1 -0
  193. package/dist/types/utils/focus/selection.d.ts +4 -69
  194. package/dist/types/utils/index.d.ts +2 -9
  195. package/dist/types/utils/misc/level.d.ts +4 -13
  196. package/dist/types/utils/misc/wait.d.ts +2 -2
  197. package/dist/types/utils/pointer/cssPointerEvents.d.ts +4 -4
  198. package/package.json +29 -4
  199. package/dist/cjs/document/selection.js +0 -107
  200. package/dist/cjs/document/setRangeText.js +0 -21
  201. package/dist/cjs/document/value.js +0 -125
  202. package/dist/cjs/setup/config.js +0 -7
  203. package/dist/cjs/utils/edit/getValue.js +0 -35
  204. package/dist/cjs/utils/edit/isValidDateOrTimeValue.js +0 -11
  205. package/dist/cjs/utils/focus/blur.js +0 -16
  206. package/dist/cjs/utils/focus/copySelection.js +0 -46
  207. package/dist/cjs/utils/focus/focus.js +0 -26
  208. package/dist/cjs/utils/focus/selectAll.js +0 -54
  209. package/dist/cjs/utils/misc/eventWrapper.js +0 -15
  210. package/dist/esm/document/selection.js +0 -99
  211. package/dist/esm/document/setRangeText.js +0 -17
  212. package/dist/esm/document/value.js +0 -115
  213. package/dist/esm/setup/config.js +0 -3
  214. package/dist/esm/utils/edit/getValue.js +0 -31
  215. package/dist/esm/utils/edit/isValidDateOrTimeValue.js +0 -7
  216. package/dist/esm/utils/focus/blur.js +0 -12
  217. package/dist/esm/utils/focus/copySelection.js +0 -42
  218. package/dist/esm/utils/focus/focus.js +0 -22
  219. package/dist/esm/utils/focus/selectAll.js +0 -49
  220. package/dist/esm/utils/misc/eventWrapper.js +0 -11
  221. package/dist/types/document/selection.d.ts +0 -29
  222. package/dist/types/document/setRangeText.d.ts +0 -1
  223. package/dist/types/document/value.d.ts +0 -26
  224. package/dist/types/setup/config.d.ts +0 -6
  225. package/dist/types/utils/edit/buildTimeValue.d.ts +0 -1
  226. package/dist/types/utils/edit/getValue.d.ts +0 -1
  227. package/dist/types/utils/edit/input.d.ts +0 -2
  228. package/dist/types/utils/edit/walkRadio.d.ts +0 -4
  229. package/dist/types/utils/focus/blur.d.ts +0 -2
  230. package/dist/types/utils/focus/focus.d.ts +0 -5
  231. package/dist/types/utils/misc/eventWrapper.d.ts +0 -1
@@ -1,5 +1,5 @@
1
- import { Config } from '../../setup';
2
- import { pointerKey, PointerPosition } from '.';
1
+ import type { Instance } from '../../setup';
2
+ import { pointerKey, PointerPosition } from './shared';
3
3
  declare type PointerInit = {
4
4
  pointerId: number;
5
5
  pointerType: string;
@@ -15,15 +15,15 @@ export declare class Pointer {
15
15
  isDown: boolean;
16
16
  isPrevented: boolean;
17
17
  position: PointerPosition;
18
- init(config: Config, position: PointerPosition): this;
19
- move(config: Config, position: PointerPosition): {
18
+ init(instance: Instance, position: PointerPosition): this;
19
+ move(instance: Instance, position: PointerPosition): {
20
20
  leave: () => void;
21
21
  enter: () => void;
22
22
  move: () => void;
23
23
  } | undefined;
24
- down(config: Config, _keyDef: pointerKey): void;
25
- up(config: Config, _keyDef: pointerKey): void;
26
- release(config: Config): void;
24
+ down(instance: Instance, _keyDef: pointerKey): void;
25
+ up(instance: Instance, _keyDef: pointerKey): void;
26
+ release(instance: Instance): void;
27
27
  private getTarget;
28
28
  private getEventInit;
29
29
  }
@@ -0,0 +1,20 @@
1
+ import { PointerCoords } from '../../event';
2
+ import { MouseButton } from './buttons';
3
+ export interface pointerKey {
4
+ /** Name of the pointer key */
5
+ name: string;
6
+ /** Type of the pointer device */
7
+ pointerType: 'mouse' | 'pen' | 'touch';
8
+ /** Type of button */
9
+ button?: MouseButton;
10
+ }
11
+ export interface PointerPosition {
12
+ target?: Element;
13
+ coords?: PointerCoords;
14
+ caret?: CaretPosition;
15
+ }
16
+ export interface CaretPosition {
17
+ node?: Node;
18
+ offset?: number;
19
+ }
20
+ export declare function isDifferentPointerPosition(positionA: PointerPosition, positionB: PointerPosition): boolean;
@@ -1,2 +1,2 @@
1
- import { Instance } from '../setup';
1
+ import type { Instance } from '../setup';
2
2
  export declare function clear(this: Instance, element: Element): Promise<void>;
@@ -1,3 +1,3 @@
1
- import { Instance } from '../setup';
1
+ import type { Instance } from '../setup';
2
2
  export declare function selectOptions(this: Instance, select: Element, values: HTMLElement | HTMLElement[] | string[] | string): Promise<void>;
3
3
  export declare function deselectOptions(this: Instance, select: Element, values: HTMLElement | HTMLElement[] | string[] | string): Promise<void>;
@@ -1,8 +1,8 @@
1
1
  import type { Instance } from '../setup';
2
- import { Config } from '../setup/config';
2
+ import type { Options } from '../options';
3
3
  export interface typeOptions {
4
- skipClick?: Config['skipClick'];
5
- skipAutoClose?: Config['skipClick'];
4
+ skipClick?: Options['skipClick'];
5
+ skipAutoClose?: Options['skipAutoClose'];
6
6
  initialSelectionStart?: number;
7
7
  initialSelectionEnd?: number;
8
8
  }
@@ -1,4 +1,4 @@
1
- import { Instance } from '../setup';
1
+ import type { Instance } from '../setup';
2
2
  export interface uploadInit {
3
3
  changeInit?: EventInit;
4
4
  }
@@ -8,8 +8,8 @@ declare enum clickableInputTypes {
8
8
  'checkbox' = "checkbox",
9
9
  'radio' = "radio"
10
10
  }
11
- export declare type ClickableInputType = keyof typeof clickableInputTypes;
12
- export declare function isClickableInput(element: Element): element is HTMLButtonElement | (HTMLInputElement & {
11
+ export declare type ClickableInputOrButton = HTMLButtonElement | (HTMLInputElement & {
13
12
  type: clickableInputTypes;
14
13
  });
14
+ export declare function isClickableInput(element: Element): element is ClickableInputOrButton;
15
15
  export {};
@@ -1,9 +1,9 @@
1
1
  import { isContentEditable } from './isContentEditable';
2
2
  declare type GuardedType<T> = T extends (x: any) => x is infer R ? R : never;
3
- export declare function isEditable(element: Element): element is GuardedType<typeof isContentEditable> | GuardedType<typeof isEditableInput> | (HTMLTextAreaElement & {
3
+ export declare function isEditable(element: Element): element is GuardedType<typeof isContentEditable> | (EditableInputOrTextarea & {
4
4
  readOnly: false;
5
5
  });
6
- export declare enum editableInputTypes {
6
+ declare enum editableInputTypes {
7
7
  'text' = "text",
8
8
  'date' = "date",
9
9
  'datetime-local' = "datetime-local",
@@ -17,9 +17,8 @@ export declare enum editableInputTypes {
17
17
  'url' = "url",
18
18
  'week' = "week"
19
19
  }
20
- export declare type EditableInputType = keyof typeof editableInputTypes;
21
- export declare function isEditableInput(element: Element): element is HTMLInputElement & {
22
- readOnly: false;
20
+ export declare type EditableInputOrTextarea = HTMLTextAreaElement | (HTMLInputElement & {
23
21
  type: editableInputTypes;
24
- };
22
+ });
23
+ export declare function isEditableInputOrTextArea(element: Element): element is EditableInputOrTextarea;
25
24
  export {};
@@ -1 +1,14 @@
1
- export declare function getSpaceUntilMaxLength(element: Element): number | undefined;
1
+ declare enum maxLengthSupportedTypes {
2
+ 'email' = "email",
3
+ 'password' = "password",
4
+ 'search' = "search",
5
+ 'telephone' = "telephone",
6
+ 'text' = "text",
7
+ 'url' = "url"
8
+ }
9
+ declare type ElementWithMaxLengthSupport = HTMLTextAreaElement | (HTMLInputElement & {
10
+ type: maxLengthSupportedTypes;
11
+ });
12
+ export declare function getMaxLength(element: ElementWithMaxLengthSupport): number | undefined;
13
+ export declare function supportsMaxLength(element: Element): element is ElementWithMaxLengthSupport;
14
+ export {};
@@ -1,3 +1,4 @@
1
+ export declare function buildTimeValue(value: string): string;
1
2
  export declare function isValidDateOrTimeValue(element: HTMLInputElement & {
2
3
  type: 'date' | 'time';
3
4
  }, value: string): boolean;
@@ -1,73 +1,8 @@
1
- import { UISelectionRange } from '../../document';
2
- import { EditableInputType, editableInputTypes } from '../edit/isEditable';
3
- /**
4
- * Backward-compatible selection.
5
- *
6
- * Handles input elements and contenteditable if it only contains a single text node.
7
- */
8
- export declare function setSelectionRange(element: Element, anchorOffset: number, focusOffset: number): void;
1
+ import { ClickableInputOrButton } from '../click/isClickableInput';
2
+ import { EditableInputOrTextarea } from '../edit/isEditable';
9
3
  /**
10
4
  * Determine if the element has its own selection implementation
11
5
  * and does not interact with the Document Selection API.
12
6
  */
13
- export declare function hasOwnSelection(node: Node): node is HTMLTextAreaElement | (HTMLInputElement & {
14
- type: editableInputTypes;
15
- });
16
- export declare function hasNoSelection(node: Node): boolean;
17
- /**
18
- * Reset the Document Selection when moving focus into an element
19
- * with own selection implementation.
20
- */
21
- export declare function updateSelectionOnFocus(element: Element): void;
22
- /**
23
- * Get the range that would be overwritten by input.
24
- */
25
- export declare function getInputRange(focusNode: Node): UISelectionRange | Range | undefined;
26
- /**
27
- * Extend/shrink the selection like with Shift+Arrows or Shift+Mouse
28
- */
29
- export declare function modifySelection({ focusNode, focusOffset, }: {
30
- focusNode: Node;
31
- /** DOM Offset */
32
- focusOffset: number;
33
- }): void;
34
- /**
35
- * Set the selection
36
- */
37
- export declare function setSelection({ focusNode, focusOffset, anchorNode, anchorOffset, }: {
38
- anchorNode?: Node;
39
- /** DOM offset */
40
- anchorOffset?: number;
41
- focusNode: Node;
42
- focusOffset: number;
43
- }): void;
44
- /**
45
- * Move the selection
46
- */
47
- export declare function moveSelection(node: Element, direction: -1 | 1): void;
48
- export declare type SelectionRange = {
49
- node: (HTMLInputElement & {
50
- type: EditableInputType;
51
- }) | HTMLTextAreaElement;
52
- start: number;
53
- end: number;
54
- };
55
- export declare function setSelectionPerMouseDown({ document, target, clickCount, node, offset, }: {
56
- document: Document;
57
- target: Element;
58
- clickCount: number;
59
- node?: Node;
60
- offset?: number;
61
- }): Range | {
62
- node: HTMLTextAreaElement | (HTMLInputElement & {
63
- type: editableInputTypes;
64
- });
65
- start: number;
66
- end: number;
67
- } | undefined;
68
- export declare function modifySelectionPerMouseMove(selectionRange: Range | SelectionRange, { document, target, node, offset, }: {
69
- document: Document;
70
- target: Element;
71
- node?: Node;
72
- offset?: number;
73
- }): void;
7
+ export declare function hasOwnSelection(node: Node): node is EditableInputOrTextarea;
8
+ export declare function hasNoSelection(node: Node): node is ClickableInputOrButton;
@@ -3,26 +3,19 @@ export * from './dataTransfer/Blob';
3
3
  export * from './dataTransfer/DataTransfer';
4
4
  export * from './dataTransfer/FileList';
5
5
  export * from './dataTransfer/Clipboard';
6
- export * from './edit/getValue';
7
- export * from './edit/input';
6
+ export * from './edit/timeValue';
8
7
  export * from './edit/isContentEditable';
9
8
  export * from './edit/isEditable';
9
+ export * from './edit/maxLength';
10
10
  export * from './edit/setFiles';
11
- export * from './edit/walkRadio';
12
- export * from './focus/blur';
13
- export * from './focus/copySelection';
14
11
  export * from './focus/cursor';
15
- export * from './focus/focus';
16
12
  export * from './focus/getActiveElement';
17
13
  export * from './focus/getTabDestination';
18
14
  export * from './focus/isFocusable';
19
- export * from './focus/selectAll';
20
- export * from './focus/resolveCaretPosition';
21
15
  export * from './focus/selection';
22
16
  export * from './focus/selector';
23
17
  export * from './keyDef/readNextDescriptor';
24
18
  export * from './misc/cloneEvent';
25
- export * from './misc/eventWrapper';
26
19
  export * from './misc/findClosest';
27
20
  export * from './misc/getDocumentFromNode';
28
21
  export * from './misc/getTreeDiff';
@@ -1,17 +1,8 @@
1
- import { Config } from '../../setup';
1
+ import type { Instance } from '../../setup';
2
2
  export declare enum ApiLevel {
3
3
  Trigger = 2,
4
4
  Call = 1
5
5
  }
6
- declare const Level: unique symbol;
7
- interface LevelRefs {
8
- [k: number]: object | undefined;
9
- }
10
- declare module '../../setup' {
11
- interface Config {
12
- [Level]?: LevelRefs;
13
- }
14
- }
15
- export declare function setLevelRef(config: Config, level: ApiLevel): void;
16
- export declare function getLevelRef(config: Config, level: ApiLevel): object | undefined;
17
- export {};
6
+ export declare type LevelRefs = Record<ApiLevel, object | undefined>;
7
+ export declare function setLevelRef(instance: Instance, level: ApiLevel): void;
8
+ export declare function getLevelRef(instance: Instance, level: ApiLevel): object | undefined;
@@ -1,2 +1,2 @@
1
- import { Config } from '../../setup';
2
- export declare function wait(config: Config): Promise<[void, void]> | undefined;
1
+ import type { Instance } from '../../setup';
2
+ export declare function wait(config: Instance['config']): Promise<[void, void]> | undefined;
@@ -1,6 +1,6 @@
1
- import { Config } from '../../setup';
2
- import { ApiLevel } from '..';
3
- export declare function hasPointerEvents(config: Config, element: Element): boolean;
1
+ import type { Instance } from '../../setup';
2
+ import { ApiLevel } from '../misc/level';
3
+ export declare function hasPointerEvents(instance: Instance, element: Element): boolean;
4
4
  declare function closestPointerEventsDeclaration(element: Element): {
5
5
  pointerEvents: string;
6
6
  tree: Element[];
@@ -15,5 +15,5 @@ declare global {
15
15
  };
16
16
  }
17
17
  }
18
- export declare function assertPointerEvents(config: Config, element: Element): void;
18
+ export declare function assertPointerEvents(instance: Instance, element: Element): void;
19
19
  export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@testing-library/user-event",
3
- "version": "14.4.0",
3
+ "version": "14.4.3",
4
4
  "description": "Fire events the same way the user does",
5
5
  "keywords": [
6
6
  "react-testing-library",
@@ -26,7 +26,7 @@
26
26
  "dist"
27
27
  ],
28
28
  "scripts": {
29
- "build": "scripts ts-build2 --cjs",
29
+ "build": "scripts ts-build2 --cjs --target es2019",
30
30
  "lint": "kcd-scripts lint",
31
31
  "setup": "npm install && npm run validate -s",
32
32
  "test": "kcd-scripts test",
@@ -35,7 +35,7 @@
35
35
  "validate": "kcd-scripts typecheck"
36
36
  },
37
37
  "devDependencies": {
38
- "@ph.fritsche/scripts-config": "^2.2.4",
38
+ "@ph.fritsche/scripts-config": "^2.4.0",
39
39
  "@testing-library/dom": "^8.11.4",
40
40
  "@testing-library/jest-dom": "^5.16.3",
41
41
  "@testing-library/react": "^13.0.0",
@@ -61,5 +61,30 @@
61
61
  },
62
62
  "main": "./dist/cjs/index.js",
63
63
  "module": "./dist/esm/index.js",
64
- "types": "./dist/types/index.d.ts"
64
+ "types": "./dist/types/index.d.ts",
65
+ "exports": {
66
+ ".": {
67
+ "types": "./dist/types/index.d.ts",
68
+ "require": "./dist/cjs/index.js",
69
+ "default": "./dist/esm/index.js"
70
+ },
71
+ "./dist/cjs/*": "./dist/cjs/*",
72
+ "./dist/esm/*": "./dist/esm/*"
73
+ },
74
+ "typesVersions": {
75
+ "*": {
76
+ "dist/types/*": [
77
+ "./dist/types/*"
78
+ ],
79
+ "dist/cjs/*.js": [
80
+ "./dist/types/*.d.ts"
81
+ ],
82
+ "dist/esm/*.js": [
83
+ "./dist/types/*.d.ts"
84
+ ],
85
+ "*": [
86
+ "./dist/types/*.d.ts"
87
+ ]
88
+ }
89
+ }
65
90
  }
@@ -1,107 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- require('../utils/click/isClickableInput.js');
6
- require('../utils/dataTransfer/Clipboard.js');
7
- require('../utils/edit/maxLength.js');
8
- require('../utils/edit/isEditable.js');
9
- require('@testing-library/dom');
10
- require('@testing-library/dom/dist/helpers.js');
11
- require('../utils/keyDef/readNextDescriptor.js');
12
- require('../utils/misc/level.js');
13
- require('../options.js');
14
- require('../event/eventMap.js');
15
- require('../event/behavior/click.js');
16
- require('../event/behavior/cut.js');
17
- require('../event/behavior/keydown.js');
18
- require('../event/behavior/keypress.js');
19
- require('../event/behavior/keyup.js');
20
- require('../event/behavior/paste.js');
21
- var interceptor = require('./interceptor.js');
22
- var value = require('./value.js');
23
-
24
- const UISelection = Symbol('Displayed selection in UI');
25
- function prepareSelectionInterceptor(element) {
26
- interceptor.prepareInterceptor(element, 'setSelectionRange', function interceptorImpl(start, ...others) {
27
- const isUI = start && typeof start === 'object' && start[UISelection];
28
- if (!isUI) {
29
- this[UISelection] = undefined;
30
- }
31
- return {
32
- applyNative: !!isUI,
33
- realArgs: [
34
- Number(start),
35
- ...others
36
- ]
37
- };
38
- });
39
- interceptor.prepareInterceptor(element, 'selectionStart', function interceptorImpl(v) {
40
- this[UISelection] = undefined;
41
- return {
42
- realArgs: v
43
- };
44
- });
45
- interceptor.prepareInterceptor(element, 'selectionEnd', function interceptorImpl(v) {
46
- this[UISelection] = undefined;
47
- return {
48
- realArgs: v
49
- };
50
- });
51
- interceptor.prepareInterceptor(element, 'select', function interceptorImpl() {
52
- this[UISelection] = {
53
- anchorOffset: 0,
54
- focusOffset: value.getUIValue(element).length
55
- };
56
- return {
57
- realArgs: []
58
- };
59
- });
60
- }
61
- function setUISelection(element, { focusOffset: focusOffsetParam , anchorOffset: anchorOffsetParam = focusOffsetParam }, mode = 'replace') {
62
- const valueLength = value.getUIValue(element).length;
63
- const sanitizeOffset = (o)=>Math.max(0, Math.min(valueLength, o));
64
- const anchorOffset = mode === 'replace' || element[UISelection] === undefined ? sanitizeOffset(anchorOffsetParam) : element[UISelection].anchorOffset;
65
- const focusOffset = sanitizeOffset(focusOffsetParam);
66
- const startOffset = Math.min(anchorOffset, focusOffset);
67
- const endOffset = Math.max(anchorOffset, focusOffset);
68
- element[UISelection] = {
69
- anchorOffset,
70
- focusOffset
71
- };
72
- if (element.selectionStart === startOffset && element.selectionEnd === endOffset) {
73
- return;
74
- }
75
- // eslint-disable-next-line no-new-wrappers
76
- const startObj = new Number(startOffset);
77
- startObj[UISelection] = UISelection;
78
- try {
79
- element.setSelectionRange(startObj, endOffset);
80
- } catch {
81
- // DOMException for invalid state is expected when calling this
82
- // on an element without support for setSelectionRange
83
- }
84
- }
85
- function getUISelection(element) {
86
- const sel = element[UISelection] ?? {
87
- anchorOffset: element.selectionStart ?? 0,
88
- focusOffset: element.selectionEnd ?? 0
89
- };
90
- return {
91
- ...sel,
92
- startOffset: Math.min(sel.anchorOffset, sel.focusOffset),
93
- endOffset: Math.max(sel.anchorOffset, sel.focusOffset)
94
- };
95
- }
96
- function hasUISelection(element) {
97
- return !!element[UISelection];
98
- }
99
- /** Flag the IDL selection as clean. This does not change the selection. */ function setUISelectionClean(element) {
100
- element[UISelection] = undefined;
101
- }
102
-
103
- exports.getUISelection = getUISelection;
104
- exports.hasUISelection = hasUISelection;
105
- exports.prepareSelectionInterceptor = prepareSelectionInterceptor;
106
- exports.setUISelection = setUISelection;
107
- exports.setUISelectionClean = setUISelectionClean;
@@ -1,21 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- var interceptor = require('./interceptor.js');
6
- var selection = require('./selection.js');
7
- var value = require('./value.js');
8
-
9
- function prepareRangeTextInterceptor(element) {
10
- interceptor.prepareInterceptor(element, 'setRangeText', function interceptorImpl(...realArgs) {
11
- return {
12
- realArgs,
13
- then: ()=>{
14
- value.setUIValueClean(element);
15
- selection.setUISelectionClean(element);
16
- }
17
- };
18
- });
19
- }
20
-
21
- exports.prepareRangeTextInterceptor = prepareRangeTextInterceptor;
@@ -1,125 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- require('../utils/click/isClickableInput.js');
6
- require('../utils/dataTransfer/Clipboard.js');
7
- require('../event/eventMap.js');
8
- require('../event/behavior/click.js');
9
- require('../event/behavior/cut.js');
10
- require('../event/behavior/keydown.js');
11
- require('../event/behavior/keypress.js');
12
- require('../event/behavior/keyup.js');
13
- require('../event/behavior/paste.js');
14
- require('@testing-library/dom');
15
- var selection = require('./selection.js');
16
- var interceptor = require('./interceptor.js');
17
- require('../utils/edit/maxLength.js');
18
- require('../utils/edit/isEditable.js');
19
- var isElementType = require('../utils/misc/isElementType.js');
20
- var getWindow = require('../utils/misc/getWindow.js');
21
- require('../utils/keyDef/readNextDescriptor.js');
22
- require('../utils/misc/level.js');
23
- require('../options.js');
24
-
25
- const UIValue = Symbol('Displayed value in UI');
26
- const InitialValue = Symbol('Initial value to compare on blur');
27
- const TrackChanges = Symbol('Track programmatic changes for React workaround');
28
- function valueInterceptor(v) {
29
- const isUI = typeof v === 'object' && v[UIValue];
30
- if (isUI) {
31
- this[UIValue] = String(v);
32
- startTrackValue(this);
33
- }
34
- return {
35
- applyNative: !!isUI,
36
- realArgs: sanitizeValue(this, v),
37
- then: isUI ? undefined : ()=>trackOrSetValue(this, String(v))
38
- };
39
- }
40
- function sanitizeValue(element, v) {
41
- // Workaround for JSDOM
42
- if (isElementType.isElementType(element, 'input', {
43
- type: 'number'
44
- }) && String(v) !== '' && !Number.isNaN(Number(v))) {
45
- // Setting value to "1." results in `null` in JSDOM
46
- return String(Number(v));
47
- }
48
- return String(v);
49
- }
50
- function prepareValueInterceptor(element) {
51
- interceptor.prepareInterceptor(element, 'value', valueInterceptor);
52
- }
53
- function setUIValue(element, value) {
54
- if (element[InitialValue] === undefined) {
55
- element[InitialValue] = element.value;
56
- }
57
- element.value = {
58
- [UIValue]: UIValue,
59
- toString: ()=>value
60
- };
61
- }
62
- function getUIValue(element) {
63
- return element[UIValue] === undefined ? element.value : String(element[UIValue]);
64
- }
65
- /** Flag the IDL value as clean. This does not change the value.*/ function setUIValueClean(element) {
66
- element[UIValue] = undefined;
67
- }
68
- function clearInitialValue(element) {
69
- element[InitialValue] = undefined;
70
- }
71
- function getInitialValue(element) {
72
- return element[InitialValue];
73
- }
74
- // When the input event happens in the browser, React executes all event handlers
75
- // and if they change state of a controlled value, nothing happens.
76
- // But when we trigger the event handlers in test environment with React@17,
77
- // the changes are rolled back before the state update is applied.
78
- // This results in a reset cursor.
79
- // There might be a better way to work around if we figure out
80
- // why the batched update is executed differently in our test environment.
81
- function isReact17Element(element) {
82
- return Object.getOwnPropertyNames(element).some((k)=>k.startsWith('__react')) && getWindow.getWindow(element).REACT_VERSION === 17;
83
- }
84
- function startTrackValue(element) {
85
- if (!isReact17Element(element)) {
86
- return;
87
- }
88
- element[TrackChanges] = {
89
- previousValue: String(element.value),
90
- tracked: []
91
- };
92
- }
93
- function trackOrSetValue(element, v) {
94
- element[TrackChanges]?.tracked?.push(v);
95
- if (!element[TrackChanges]) {
96
- setUIValueClean(element);
97
- selection.setUISelection(element, {
98
- focusOffset: v.length
99
- });
100
- }
101
- }
102
- function commitValueAfterInput(element, cursorOffset) {
103
- const changes = element[TrackChanges];
104
- element[TrackChanges] = undefined;
105
- if (!changes?.tracked?.length) {
106
- return;
107
- }
108
- const isJustReactStateUpdate = changes.tracked.length === 2 && changes.tracked[0] === changes.previousValue && changes.tracked[1] === element.value;
109
- if (!isJustReactStateUpdate) {
110
- setUIValueClean(element);
111
- }
112
- if (selection.hasUISelection(element)) {
113
- selection.setUISelection(element, {
114
- focusOffset: isJustReactStateUpdate ? cursorOffset : element.value.length
115
- });
116
- }
117
- }
118
-
119
- exports.clearInitialValue = clearInitialValue;
120
- exports.commitValueAfterInput = commitValueAfterInput;
121
- exports.getInitialValue = getInitialValue;
122
- exports.getUIValue = getUIValue;
123
- exports.prepareValueInterceptor = prepareValueInterceptor;
124
- exports.setUIValue = setUIValue;
125
- exports.setUIValueClean = setUIValueClean;
@@ -1,7 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- const Config = Symbol('Config');
6
-
7
- exports.Config = Config;
@@ -1,35 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- require('../click/isClickableInput.js');
6
- require('../dataTransfer/Clipboard.js');
7
- require('./maxLength.js');
8
- var isContentEditable = require('./isContentEditable.js');
9
- require('./isEditable.js');
10
- require('@testing-library/dom');
11
- require('@testing-library/dom/dist/helpers.js');
12
- require('../keyDef/readNextDescriptor.js');
13
- require('../misc/level.js');
14
- require('../../options.js');
15
- require('../../event/eventMap.js');
16
- require('../../event/behavior/click.js');
17
- require('../../event/behavior/cut.js');
18
- require('../../event/behavior/keydown.js');
19
- require('../../event/behavior/keypress.js');
20
- require('../../event/behavior/keyup.js');
21
- require('../../event/behavior/paste.js');
22
- var value = require('../../document/value.js');
23
-
24
- function getValue(element) {
25
- // istanbul ignore if
26
- if (!element) {
27
- return null;
28
- }
29
- if (isContentEditable.isContentEditable(element)) {
30
- return element.textContent;
31
- }
32
- return value.getUIValue(element);
33
- }
34
-
35
- exports.getValue = getValue;
@@ -1,11 +0,0 @@
1
- 'use strict';
2
-
3
- Object.defineProperty(exports, '__esModule', { value: true });
4
-
5
- function isValidDateOrTimeValue(element, value) {
6
- const clone = element.cloneNode();
7
- clone.value = value;
8
- return clone.value === value;
9
- }
10
-
11
- exports.isValidDateOrTimeValue = isValidDateOrTimeValue;