@testing-library/user-event 13.5.0 → 14.0.0-alpha.12

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 (125) hide show
  1. package/README.md +3 -0
  2. package/dist/clear.d.ts +2 -2
  3. package/dist/clear.js +14 -29
  4. package/dist/click.d.ts +4 -3
  5. package/dist/click.js +30 -145
  6. package/dist/document/index.d.ts +10 -0
  7. package/dist/document/index.js +100 -0
  8. package/dist/document/interceptor.d.ts +15 -0
  9. package/dist/document/interceptor.js +37 -0
  10. package/dist/document/selection.d.ts +27 -0
  11. package/dist/document/selection.js +90 -0
  12. package/dist/document/value.d.ts +18 -0
  13. package/dist/document/value.js +77 -0
  14. package/dist/hover.d.ts +3 -3
  15. package/dist/hover.js +17 -59
  16. package/dist/index.d.ts +3 -22
  17. package/dist/index.js +3 -36
  18. package/dist/keyboard/getEventProps.d.ts +0 -2
  19. package/dist/keyboard/getEventProps.js +1 -7
  20. package/dist/keyboard/getNextKeyDef.d.ts +0 -1
  21. package/dist/keyboard/getNextKeyDef.js +4 -123
  22. package/dist/keyboard/index.d.ts +1 -1
  23. package/dist/keyboard/index.js +4 -8
  24. package/dist/keyboard/keyMap.js +26 -46
  25. package/dist/keyboard/keyboardImplementation.js +15 -17
  26. package/dist/keyboard/plugins/arrow.js +7 -12
  27. package/dist/keyboard/plugins/character.js +29 -57
  28. package/dist/keyboard/plugins/combination.d.ts +5 -0
  29. package/dist/keyboard/plugins/combination.js +17 -0
  30. package/dist/keyboard/plugins/control.js +5 -16
  31. package/dist/keyboard/plugins/functional.js +23 -14
  32. package/dist/keyboard/plugins/index.d.ts +0 -1
  33. package/dist/keyboard/plugins/index.js +4 -13
  34. package/dist/keyboard/shared/index.d.ts +0 -2
  35. package/dist/keyboard/shared/index.js +0 -26
  36. package/dist/keyboard/types.d.ts +3 -2
  37. package/dist/paste.d.ts +3 -2
  38. package/dist/paste.js +8 -15
  39. package/dist/pointer/index.d.ts +18 -0
  40. package/dist/pointer/index.js +90 -0
  41. package/dist/pointer/keyMap.d.ts +2 -0
  42. package/dist/pointer/keyMap.js +29 -0
  43. package/dist/pointer/parseKeyDef.d.ts +6 -0
  44. package/dist/pointer/parseKeyDef.js +36 -0
  45. package/dist/pointer/pointerAction.d.ts +6 -0
  46. package/dist/pointer/pointerAction.js +52 -0
  47. package/dist/pointer/pointerMove.d.ts +5 -0
  48. package/dist/pointer/pointerMove.js +136 -0
  49. package/dist/pointer/pointerPress.d.ts +7 -0
  50. package/dist/pointer/pointerPress.js +330 -0
  51. package/dist/pointer/resolveSelectionTarget.d.ts +5 -0
  52. package/dist/pointer/resolveSelectionTarget.js +75 -0
  53. package/dist/pointer/types.d.ts +72 -0
  54. package/dist/pointer/types.js +1 -0
  55. package/dist/selectOptions.d.ts +4 -0
  56. package/dist/{select-options.js → selectOptions.js} +35 -38
  57. package/dist/setup.d.ts +92 -0
  58. package/dist/setup.js +203 -0
  59. package/dist/tab.d.ts +3 -4
  60. package/dist/tab.js +3 -136
  61. package/dist/type.d.ts +14 -0
  62. package/dist/type.js +74 -0
  63. package/dist/upload.d.ts +4 -4
  64. package/dist/upload.js +3 -9
  65. package/dist/utils/edit/calculateNewValue.d.ts +12 -5
  66. package/dist/utils/edit/calculateNewValue.js +19 -21
  67. package/dist/utils/edit/editInputElement.d.ts +16 -0
  68. package/dist/utils/edit/editInputElement.js +53 -0
  69. package/dist/utils/edit/getValue.d.ts +1 -1
  70. package/dist/utils/edit/getValue.js +3 -1
  71. package/dist/utils/edit/isContentEditable.d.ts +4 -0
  72. package/dist/utils/edit/isContentEditable.js +14 -0
  73. package/dist/utils/edit/isEditable.d.ts +1 -0
  74. package/dist/utils/edit/prepareInput.d.ts +7 -0
  75. package/dist/utils/edit/prepareInput.js +77 -0
  76. package/dist/{blur.d.ts → utils/focus/blur.d.ts} +0 -0
  77. package/dist/utils/focus/blur.js +19 -0
  78. package/dist/{focus.d.ts → utils/focus/focus.d.ts} +0 -0
  79. package/dist/utils/focus/focus.js +22 -0
  80. package/dist/utils/focus/getTabDestination.d.ts +1 -0
  81. package/dist/utils/focus/getTabDestination.js +71 -0
  82. package/dist/utils/focus/isFocusable.js +1 -3
  83. package/dist/utils/focus/selectAll.d.ts +5 -0
  84. package/dist/utils/focus/selectAll.js +51 -0
  85. package/dist/utils/focus/selection.d.ts +42 -0
  86. package/dist/utils/focus/selection.js +190 -0
  87. package/dist/utils/index.d.ts +12 -6
  88. package/dist/utils/index.js +132 -54
  89. package/dist/utils/keyDef/readNextDescriptor.d.ts +19 -0
  90. package/dist/utils/keyDef/readNextDescriptor.js +102 -0
  91. package/dist/utils/misc/findClosest.d.ts +1 -0
  92. package/dist/utils/misc/findClosest.js +20 -0
  93. package/dist/utils/misc/isDescendantOrSelf.d.ts +1 -0
  94. package/dist/utils/misc/isDescendantOrSelf.js +20 -0
  95. package/dist/utils/pointer/firePointerEvents.d.ts +25 -0
  96. package/dist/utils/pointer/firePointerEvents.js +112 -0
  97. package/dist/utils/pointer/mouseButtons.d.ts +12 -0
  98. package/dist/utils/pointer/mouseButtons.js +45 -0
  99. package/package.json +4 -3
  100. package/dist/blur.js +0 -15
  101. package/dist/dom-helpers.d.ts +0 -3
  102. package/dist/focus.js +0 -15
  103. package/dist/keyboard/shared/carryValue.d.ts +0 -2
  104. package/dist/keyboard/shared/carryValue.js +0 -13
  105. package/dist/keyboard/shared/fireInputEvent.d.ts +0 -17
  106. package/dist/keyboard/shared/fireInputEvent.js +0 -110
  107. package/dist/keyboard/specialCharMap.d.ts +0 -22
  108. package/dist/keyboard/specialCharMap.js +0 -30
  109. package/dist/select-options.d.ts +0 -4
  110. package/dist/type/index.d.ts +0 -7
  111. package/dist/type/index.js +0 -33
  112. package/dist/type/typeImplementation.d.ts +0 -10
  113. package/dist/type/typeImplementation.js +0 -64
  114. package/dist/utils/click/getMouseEventOptions.d.ts +0 -31
  115. package/dist/utils/click/getMouseEventOptions.js +0 -61
  116. package/dist/utils/edit/cursorPosition.d.ts +0 -2
  117. package/dist/utils/edit/cursorPosition.js +0 -35
  118. package/dist/utils/edit/hasUnreliableEmptyValue.d.ts +0 -10
  119. package/dist/utils/edit/hasUnreliableEmptyValue.js +0 -21
  120. package/dist/utils/edit/selectionRange.d.ts +0 -16
  121. package/dist/utils/edit/selectionRange.js +0 -104
  122. package/dist/utils/misc/isDocument.d.ts +0 -1
  123. package/dist/utils/misc/isDocument.js +0 -10
  124. package/dist/utils/misc/isLabelWithInternallyDisabledControl.d.ts +0 -1
  125. package/dist/utils/misc/isLabelWithInternallyDisabledControl.js +0 -22
@@ -36,15 +36,18 @@ const keypressBehavior = [{
36
36
 
37
37
  const {
38
38
  newValue,
39
- newSelectionStart
40
- } = (0, _utils.calculateNewValue)(newEntry, element);
39
+ newOffset
40
+ } = (0, _utils.calculateNewValue)(newEntry, element, (0, _utils.getInputRange)(element));
41
41
  const prevValue = (0, _utils.getValue)(element); // this check was provided by fireInputEventIfNeeded
42
42
  // TODO: verify if it is even needed by this handler
43
43
 
44
44
  if (prevValue !== newValue) {
45
- (0, _shared.fireInputEvent)(element, {
45
+ (0, _utils.editInputElement)(element, {
46
46
  newValue,
47
- newSelectionStart,
47
+ newSelection: {
48
+ node: element,
49
+ offset: newOffset
50
+ },
48
51
  eventOverrides: {
49
52
  data: keyDef.key,
50
53
  inputType: 'insertText'
@@ -77,15 +80,18 @@ const keypressBehavior = [{
77
80
 
78
81
  const {
79
82
  newValue,
80
- newSelectionStart
81
- } = (0, _utils.calculateNewValue)(newEntry, element);
83
+ newOffset
84
+ } = (0, _utils.calculateNewValue)(newEntry, element, (0, _utils.getInputRange)(element));
82
85
  const prevValue = (0, _utils.getValue)(element); // this check was provided by fireInputEventIfNeeded
83
86
  // TODO: verify if it is even needed by this handler
84
87
 
85
88
  if (prevValue !== newValue) {
86
- (0, _shared.fireInputEvent)(element, {
89
+ (0, _utils.editInputElement)(element, {
87
90
  newValue,
88
- newSelectionStart,
91
+ newSelection: {
92
+ node: element,
93
+ offset: newOffset
94
+ },
89
95
  eventOverrides: {
90
96
  data: keyDef.key,
91
97
  inputType: 'insertText'
@@ -112,20 +118,18 @@ const keypressBehavior = [{
112
118
  readOnly: false
113
119
  });
114
120
  },
115
- handle: (keyDef, element, options, state) => {
116
- var _ref, _state$carryValue3, _newValue$match, _newValue$match2;
121
+ handle: (keyDef, element) => {
122
+ var _newValue$match, _newValue$match2;
117
123
 
118
124
  if (!/[\d.\-e]/.test(keyDef.key)) {
119
125
  return;
120
126
  }
121
127
 
122
- const oldValue = (_ref = (_state$carryValue3 = state.carryValue) != null ? _state$carryValue3 : (0, _utils.getValue)(element)) != null ? _ref :
123
- /* istanbul ignore next */
124
- '';
125
128
  const {
126
- newValue,
127
- newSelectionStart
128
- } = (0, _utils.calculateNewValue)(keyDef.key, element, oldValue); // the browser allows some invalid input but not others
129
+ getNewValue,
130
+ commit
131
+ } = (0, _utils.prepareInput)(keyDef.key, element);
132
+ const newValue = getNewValue(); // the browser allows some invalid input but not others
129
133
  // it allows up to two '-' at any place before any 'e' or one directly following 'e'
130
134
  // it allows one '.' at any place before e
131
135
 
@@ -135,61 +139,29 @@ const keypressBehavior = [{
135
139
  return;
136
140
  }
137
141
 
138
- (0, _shared.fireInputEvent)(element, {
139
- newValue,
140
- newSelectionStart,
141
- eventOverrides: {
142
- data: keyDef.key,
143
- inputType: 'insertText'
144
- }
145
- });
146
- const appliedValue = (0, _utils.getValue)(element);
147
-
148
- if (appliedValue === newValue) {
149
- state.carryValue = undefined;
150
- } else {
151
- state.carryValue = newValue;
152
- }
142
+ commit();
153
143
  }
154
144
  }, {
155
145
  matches: (keyDef, element) => {
156
146
  var _keyDef$key4;
157
147
 
158
- return ((_keyDef$key4 = keyDef.key) == null ? void 0 : _keyDef$key4.length) === 1 && ((0, _utils.isElementType)(element, ['input', 'textarea'], {
148
+ return ((_keyDef$key4 = keyDef.key) == null ? void 0 : _keyDef$key4.length) === 1 && ((0, _utils.isEditableInput)(element) || (0, _utils.isElementType)(element, 'textarea', {
159
149
  readOnly: false
160
- }) && !(0, _utils.isClickableInput)(element) || (0, _utils.isContentEditable)(element)) && (0, _utils.getSpaceUntilMaxLength)(element) !== 0;
150
+ }) || (0, _utils.isContentEditable)(element)) && (0, _utils.getSpaceUntilMaxLength)(element) !== 0;
161
151
  },
162
152
  handle: (keyDef, element) => {
163
- const {
164
- newValue,
165
- newSelectionStart
166
- } = (0, _utils.calculateNewValue)(keyDef.key, element);
167
- (0, _shared.fireInputEvent)(element, {
168
- newValue,
169
- newSelectionStart,
170
- eventOverrides: {
171
- data: keyDef.key,
172
- inputType: 'insertText'
173
- }
174
- });
153
+ var _prepareInput;
154
+
155
+ (_prepareInput = (0, _utils.prepareInput)(keyDef.key, element)) == null ? void 0 : _prepareInput.commit();
175
156
  }
176
157
  }, {
177
158
  matches: (keyDef, element) => keyDef.key === 'Enter' && ((0, _utils.isElementType)(element, 'textarea', {
178
159
  readOnly: false
179
160
  }) || (0, _utils.isContentEditable)(element)) && (0, _utils.getSpaceUntilMaxLength)(element) !== 0,
180
161
  handle: (keyDef, element, options, state) => {
181
- const {
182
- newValue,
183
- newSelectionStart
184
- } = (0, _utils.calculateNewValue)('\n', element);
185
- const inputType = (0, _utils.isContentEditable)(element) && !state.modifiers.shift ? 'insertParagraph' : 'insertLineBreak';
186
- (0, _shared.fireInputEvent)(element, {
187
- newValue,
188
- newSelectionStart,
189
- eventOverrides: {
190
- inputType
191
- }
192
- });
162
+ var _prepareInput2;
163
+
164
+ (_prepareInput2 = (0, _utils.prepareInput)('\n', element, (0, _utils.isContentEditable)(element) && !state.modifiers.shift ? 'insertParagraph' : 'insertLineBreak')) == null ? void 0 : _prepareInput2.commit();
193
165
  }
194
166
  }];
195
167
  exports.keypressBehavior = keypressBehavior;
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Default behavior for key combinations
3
+ */
4
+ import { behaviorPlugin } from '../types';
5
+ export declare const keydownBehavior: behaviorPlugin[];
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.keydownBehavior = void 0;
7
+
8
+ var _utils = require("../../utils");
9
+
10
+ /**
11
+ * Default behavior for key combinations
12
+ */
13
+ const keydownBehavior = [{
14
+ matches: (keyDef, element, options, state) => keyDef.code === 'KeyA' && state.modifiers.ctrl,
15
+ handle: (keyDef, element) => (0, _utils.selectAll)(element)
16
+ }];
17
+ exports.keydownBehavior = keydownBehavior;
@@ -7,8 +7,6 @@ exports.keydownBehavior = void 0;
7
7
 
8
8
  var _utils = require("../../utils");
9
9
 
10
- var _shared = require("../shared");
11
-
12
10
  /**
13
11
  * This file should contain behavior for arrow keys as described here:
14
12
  * https://w3c.github.io/uievents-code/#key-controlpad-section
@@ -44,20 +42,11 @@ const keydownBehavior = [{
44
42
  }
45
43
  }
46
44
  }, {
47
- matches: (keyDef, element) => keyDef.key === 'Delete' && (0, _utils.isEditable)(element) && !(0, _utils.isCursorAtEnd)(element),
48
- handle: (keDef, element, options, state) => {
49
- const {
50
- newValue,
51
- newSelectionStart
52
- } = (0, _utils.calculateNewValue)('', element, state.carryValue, undefined, 'forward');
53
- (0, _shared.fireInputEvent)(element, {
54
- newValue,
55
- newSelectionStart,
56
- eventOverrides: {
57
- inputType: 'deleteContentForward'
58
- }
59
- });
60
- (0, _shared.carryValue)(element, state, newValue);
45
+ matches: (keyDef, element) => keyDef.key === 'Delete' && (0, _utils.isEditable)(element),
46
+ handle: (keDef, element) => {
47
+ var _prepareInput;
48
+
49
+ (_prepareInput = (0, _utils.prepareInput)('', element, 'deleteContentForward')) == null ? void 0 : _prepareInput.commit();
61
50
  }
62
51
  }];
63
52
  exports.keydownBehavior = keydownBehavior;
@@ -7,12 +7,12 @@ exports.preKeyupBehavior = exports.preKeydownBehavior = exports.postKeyupBehavio
7
7
 
8
8
  var _dom = require("@testing-library/dom");
9
9
 
10
+ var _document = require("../../document");
11
+
10
12
  var _utils = require("../../utils");
11
13
 
12
14
  var _getEventProps = require("../getEventProps");
13
15
 
14
- var _shared = require("../shared");
15
-
16
16
  /**
17
17
  * This file should contain behavior for functional keys as described here:
18
18
  * https://w3c.github.io/uievents-code/#key-alphanumeric-functional
@@ -53,20 +53,29 @@ const keydownBehavior = [{
53
53
  state.modifiers.caps = !state.modifiers.caps;
54
54
  }
55
55
  }, {
56
- matches: (keyDef, element) => keyDef.key === 'Backspace' && (0, _utils.isEditable)(element) && !(0, _utils.isCursorAtStart)(element),
56
+ matches: (keyDef, element) => keyDef.key === 'Backspace' && (0, _utils.isEditable)(element),
57
+ handle: (keyDef, element) => {
58
+ var _prepareInput;
59
+
60
+ (_prepareInput = (0, _utils.prepareInput)('', element, 'deleteContentBackward')) == null ? void 0 : _prepareInput.commit();
61
+ }
62
+ }, {
63
+ matches: keyDef => keyDef.key === 'Tab',
57
64
  handle: (keyDef, element, options, state) => {
58
- const {
59
- newValue,
60
- newSelectionStart
61
- } = (0, _utils.calculateNewValue)('', element, state.carryValue, undefined, 'backward');
62
- (0, _shared.fireInputEvent)(element, {
63
- newValue,
64
- newSelectionStart,
65
- eventOverrides: {
66
- inputType: 'deleteContentBackward'
65
+ const dest = (0, _utils.getTabDestination)(element, state.modifiers.shift);
66
+
67
+ if (dest === element.ownerDocument.body) {
68
+ (0, _utils.blur)(element);
69
+ } else {
70
+ (0, _utils.focus)(dest);
71
+
72
+ if ((0, _utils.isElementType)(dest, ['input', 'textarea'])) {
73
+ (0, _document.setUISelection)(dest, {
74
+ anchorOffset: 0,
75
+ focusOffset: dest.value.length
76
+ });
67
77
  }
68
- });
69
- (0, _shared.carryValue)(element, state, newValue);
78
+ }
70
79
  }
71
80
  }];
72
81
  exports.keydownBehavior = keydownBehavior;
@@ -1,5 +1,4 @@
1
1
  import { behaviorPlugin } from '../types';
2
- export declare const replaceBehavior: behaviorPlugin[];
3
2
  export declare const preKeydownBehavior: behaviorPlugin[];
4
3
  export declare const keydownBehavior: behaviorPlugin[];
5
4
  export declare const keypressBehavior: behaviorPlugin[];
@@ -3,9 +3,7 @@
3
3
  Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
- exports.replaceBehavior = exports.preKeyupBehavior = exports.preKeydownBehavior = exports.postKeyupBehavior = exports.keyupBehavior = exports.keypressBehavior = exports.keydownBehavior = void 0;
7
-
8
- var _utils = require("../../utils");
6
+ exports.preKeyupBehavior = exports.preKeydownBehavior = exports.postKeyupBehavior = exports.keyupBehavior = exports.keypressBehavior = exports.keydownBehavior = void 0;
9
7
 
10
8
  var arrowKeys = _interopRequireWildcard(require("./arrow"));
11
9
 
@@ -15,22 +13,15 @@ var characterKeys = _interopRequireWildcard(require("./character"));
15
13
 
16
14
  var functionalKeys = _interopRequireWildcard(require("./functional"));
17
15
 
16
+ var combination = _interopRequireWildcard(require("./combination"));
17
+
18
18
  function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
19
19
 
20
20
  function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
21
21
 
22
- const replaceBehavior = [{
23
- matches: (keyDef, element) => keyDef.key === 'selectall' && (0, _utils.isElementType)(element, ['input', 'textarea']),
24
- handle: (keyDef, element, options, state) => {
25
- var _state$carryValue;
26
-
27
- (0, _utils.setSelectionRange)(element, 0, ((_state$carryValue = state.carryValue) != null ? _state$carryValue : element.value).length);
28
- }
29
- }];
30
- exports.replaceBehavior = replaceBehavior;
31
22
  const preKeydownBehavior = [...functionalKeys.preKeydownBehavior];
32
23
  exports.preKeydownBehavior = preKeydownBehavior;
33
- const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior];
24
+ const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior, ...combination.keydownBehavior];
34
25
  exports.keydownBehavior = keydownBehavior;
35
26
  const keypressBehavior = [...functionalKeys.keypressBehavior, ...characterKeys.keypressBehavior];
36
27
  exports.keypressBehavior = keypressBehavior;
@@ -1,3 +1 @@
1
- export * from './carryValue';
2
1
  export * from './fireChangeForInputTimeIfValid';
3
- export * from './fireInputEvent';
@@ -4,19 +4,6 @@ Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
6
 
7
- var _carryValue = require("./carryValue");
8
-
9
- Object.keys(_carryValue).forEach(function (key) {
10
- if (key === "default" || key === "__esModule") return;
11
- if (key in exports && exports[key] === _carryValue[key]) return;
12
- Object.defineProperty(exports, key, {
13
- enumerable: true,
14
- get: function () {
15
- return _carryValue[key];
16
- }
17
- });
18
- });
19
-
20
7
  var _fireChangeForInputTimeIfValid = require("./fireChangeForInputTimeIfValid");
21
8
 
22
9
  Object.keys(_fireChangeForInputTimeIfValid).forEach(function (key) {
@@ -28,17 +15,4 @@ Object.keys(_fireChangeForInputTimeIfValid).forEach(function (key) {
28
15
  return _fireChangeForInputTimeIfValid[key];
29
16
  }
30
17
  });
31
- });
32
-
33
- var _fireInputEvent = require("./fireInputEvent");
34
-
35
- Object.keys(_fireInputEvent).forEach(function (key) {
36
- if (key === "default" || key === "__esModule") return;
37
- if (key in exports && exports[key] === _fireInputEvent[key]) return;
38
- Object.defineProperty(exports, key, {
39
- enumerable: true,
40
- get: function () {
41
- return _fireInputEvent[key];
42
- }
43
- });
44
18
  });
@@ -29,6 +29,9 @@ export declare type keyboardState = {
29
29
  For HTMLInputElements type='number':
30
30
  If the last input char is '.', '-' or 'e',
31
31
  the IDL value attribute does not reflect the input value.
32
+
33
+ @deprecated The document state workaround in `src/document/value.ts` keeps track
34
+ of UI value diverging from value property.
32
35
  */
33
36
  carryValue?: string;
34
37
  /**
@@ -64,8 +67,6 @@ export interface keyboardKey {
64
67
  key?: string;
65
68
  /** Location on the keyboard for keys with multiple representation */
66
69
  location?: DOM_KEY_LOCATION;
67
- /** keyCode for legacy support */
68
- keyCode?: number;
69
70
  /** Does the character in `key` require/imply AltRight to be pressed? */
70
71
  altGr?: boolean;
71
72
  /** Does the character in `key` require/imply a shiftKey to be pressed? */
package/dist/paste.d.ts CHANGED
@@ -1,6 +1,7 @@
1
+ import type { UserEvent } from './setup';
1
2
  interface pasteOptions {
2
3
  initialSelectionStart?: number;
3
4
  initialSelectionEnd?: number;
4
5
  }
5
- declare function paste(element: HTMLElement, text: string, init?: ClipboardEventInit, { initialSelectionStart, initialSelectionEnd }?: pasteOptions): void;
6
- export { paste };
6
+ export declare function paste(this: UserEvent, element: HTMLElement, text: string, init?: ClipboardEventInit, { initialSelectionStart, initialSelectionEnd }?: pasteOptions): void;
7
+ export {};
package/dist/paste.js CHANGED
@@ -17,6 +17,8 @@ function paste(element, text, init, {
17
17
  initialSelectionStart,
18
18
  initialSelectionEnd
19
19
  } = {}) {
20
+ var _prepareInput;
21
+
20
22
  // TODO: implement for contenteditable
21
23
  if (!isSupportedElement(element)) {
22
24
  throw new TypeError(`The given ${element.tagName} element is currently unsupported.
@@ -47,21 +49,12 @@ function paste(element, text, init, {
47
49
  }
48
50
 
49
51
  text = text.substr(0, (0, _utils.getSpaceUntilMaxLength)(element));
50
- const {
51
- newValue,
52
- newSelectionStart
53
- } = (0, _utils.calculateNewValue)(text, element);
52
+ const inputRange = (0, _utils.getInputRange)(element);
53
+ /* istanbul ignore if */
54
54
 
55
- _dom.fireEvent.input(element, {
56
- inputType: 'insertFromPaste',
57
- target: {
58
- value: newValue
59
- }
60
- });
55
+ if (!inputRange) {
56
+ return;
57
+ }
61
58
 
62
- (0, _utils.setSelectionRange)(element, // TODO: investigate why the selection caused by invalid parameters was expected
63
- {
64
- newSelectionStart,
65
- selectionEnd: newSelectionStart
66
- }, {});
59
+ (_prepareInput = (0, _utils.prepareInput)(text, element, 'insertFromPaste')) == null ? void 0 : _prepareInput.commit();
67
60
  }
@@ -0,0 +1,18 @@
1
+ import { PointerAction, PointerActionTarget } from './pointerAction';
2
+ import type { inputDeviceState, pointerOptions, pointerState } from './types';
3
+ export declare function pointer(input: PointerInput, options?: Partial<pointerOptions & {
4
+ delay: 0;
5
+ } & inputDeviceState>): pointerState;
6
+ export declare function pointer(input: PointerInput, options: Partial<pointerOptions & {
7
+ delay: number;
8
+ } & inputDeviceState>): Promise<pointerState>;
9
+ declare type PointerActionInput = string | ({
10
+ keys: string;
11
+ } & PointerActionTarget) | PointerAction;
12
+ declare type PointerInput = PointerActionInput | Array<PointerActionInput>;
13
+ export declare function pointerImplementationWrapper(input: PointerInput, config: Partial<pointerOptions & inputDeviceState>): {
14
+ promise: Promise<unknown[]>;
15
+ pointerState: pointerState;
16
+ };
17
+ export declare function createPointerState(): pointerState;
18
+ export {};
@@ -0,0 +1,90 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.createPointerState = createPointerState;
7
+ exports.pointer = pointer;
8
+ exports.pointerImplementationWrapper = pointerImplementationWrapper;
9
+
10
+ var _dom = require("@testing-library/dom");
11
+
12
+ var _keyboard = require("../keyboard");
13
+
14
+ var _parseKeyDef = require("./parseKeyDef");
15
+
16
+ var _keyMap = require("./keyMap");
17
+
18
+ var _pointerAction = require("./pointerAction");
19
+
20
+ function pointer(input, options = {}) {
21
+ var _options$delay;
22
+
23
+ const {
24
+ promise,
25
+ pointerState
26
+ } = pointerImplementationWrapper(input, options);
27
+
28
+ if (((_options$delay = options.delay) != null ? _options$delay : 0) > 0) {
29
+ return (0, _dom.getConfig)().asyncWrapper(() => promise.then(() => pointerState));
30
+ } else {
31
+ // prevent users from dealing with UnhandledPromiseRejectionWarning in sync call
32
+ promise.catch(console.error);
33
+ return pointerState;
34
+ }
35
+ }
36
+
37
+ function pointerImplementationWrapper(input, config) {
38
+ const {
39
+ pointerState = createPointerState(),
40
+ keyboardState = (0, _keyboard.createKeyboardState)(),
41
+ delay = 0,
42
+ pointerMap = _keyMap.defaultKeyMap
43
+ } = config;
44
+ const options = {
45
+ delay,
46
+ pointerMap
47
+ };
48
+ const actions = [];
49
+ (Array.isArray(input) ? input : [input]).forEach(actionInput => {
50
+ if (typeof actionInput === 'string') {
51
+ actions.push(...(0, _parseKeyDef.parseKeyDef)(actionInput, options));
52
+ } else if ('keys' in actionInput) {
53
+ actions.push(...(0, _parseKeyDef.parseKeyDef)(actionInput.keys, options).map(i => ({ ...actionInput,
54
+ ...i
55
+ })));
56
+ } else {
57
+ actions.push(actionInput);
58
+ }
59
+ });
60
+ return {
61
+ promise: (0, _pointerAction.pointerAction)(actions, options, {
62
+ pointerState,
63
+ keyboardState
64
+ }),
65
+ pointerState
66
+ };
67
+ }
68
+
69
+ function createPointerState() {
70
+ return {
71
+ pointerId: 1,
72
+ position: {
73
+ mouse: {
74
+ pointerType: 'mouse',
75
+ pointerId: 1,
76
+ coords: {
77
+ clientX: 0,
78
+ clientY: 0,
79
+ offsetX: 0,
80
+ offsetY: 0,
81
+ pageX: 0,
82
+ pageY: 0,
83
+ x: 0,
84
+ y: 0
85
+ }
86
+ }
87
+ },
88
+ pressed: []
89
+ };
90
+ }
@@ -0,0 +1,2 @@
1
+ import { pointerKey } from './types';
2
+ export declare const defaultKeyMap: pointerKey[];
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.defaultKeyMap = void 0;
7
+ const defaultKeyMap = [{
8
+ name: 'MouseLeft',
9
+ pointerType: 'mouse',
10
+ button: 'primary'
11
+ }, {
12
+ name: 'MouseRight',
13
+ pointerType: 'mouse',
14
+ button: 'secondary'
15
+ }, {
16
+ name: 'MouseMiddle',
17
+ pointerType: 'mouse',
18
+ button: 'auxiliary'
19
+ }, {
20
+ name: 'TouchA',
21
+ pointerType: 'touch'
22
+ }, {
23
+ name: 'TouchB',
24
+ pointerType: 'touch'
25
+ }, {
26
+ name: 'TouchC',
27
+ pointerType: 'touch'
28
+ }];
29
+ exports.defaultKeyMap = defaultKeyMap;
@@ -0,0 +1,6 @@
1
+ import { pointerKey, pointerOptions } from './types';
2
+ export declare function parseKeyDef(keys: string, { pointerMap }: pointerOptions): {
3
+ keyDef: pointerKey;
4
+ releasePrevious: boolean;
5
+ releaseSelf: boolean;
6
+ }[];
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.parseKeyDef = parseKeyDef;
7
+
8
+ var _utils = require("../utils");
9
+
10
+ function parseKeyDef(keys, {
11
+ pointerMap
12
+ }) {
13
+ const defs = [];
14
+
15
+ do {
16
+ const {
17
+ descriptor,
18
+ consumedLength,
19
+ releasePrevious,
20
+ releaseSelf = true
21
+ } = (0, _utils.readNextDescriptor)(keys);
22
+ const keyDef = pointerMap.find(p => p.name === descriptor);
23
+
24
+ if (keyDef) {
25
+ defs.push({
26
+ keyDef,
27
+ releasePrevious,
28
+ releaseSelf
29
+ });
30
+ }
31
+
32
+ keys = keys.slice(consumedLength);
33
+ } while (keys);
34
+
35
+ return defs;
36
+ }
@@ -0,0 +1,6 @@
1
+ import { PointerMoveAction } from './pointerMove';
2
+ import { PointerPressAction } from './pointerPress';
3
+ import { inputDeviceState, pointerOptions, PointerTarget, SelectionTarget } from './types';
4
+ export declare type PointerActionTarget = Partial<PointerTarget> & Partial<SelectionTarget>;
5
+ export declare type PointerAction = PointerActionTarget & (Omit<PointerPressAction, 'target' | 'coords'> | Omit<PointerMoveAction, 'target' | 'coords'>);
6
+ export declare function pointerAction(actions: PointerAction[], options: pointerOptions, state: inputDeviceState): Promise<unknown[]>;
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.pointerAction = pointerAction;
7
+
8
+ var _utils = require("../utils");
9
+
10
+ var _pointerMove = require("./pointerMove");
11
+
12
+ var _pointerPress = require("./pointerPress");
13
+
14
+ async function pointerAction(actions, options, state) {
15
+ const ret = [];
16
+
17
+ for (let i = 0; i < actions.length; i++) {
18
+ var _action$target, _action$coords;
19
+
20
+ const action = actions[i];
21
+ const pointerName = 'pointerName' in action && action.pointerName ? action.pointerName : 'keyDef' in action ? action.keyDef.pointerType === 'touch' ? action.keyDef.name : action.keyDef.pointerType : 'mouse';
22
+ const target = (_action$target = action.target) != null ? _action$target : getPrevTarget(pointerName, state.pointerState);
23
+ const coords = (_action$coords = action.coords) != null ? _action$coords : pointerName in state.pointerState.position ? state.pointerState.position[pointerName].coords : undefined;
24
+ const promise = 'keyDef' in action ? (0, _pointerPress.pointerPress)({ ...action,
25
+ target,
26
+ coords
27
+ }, state) : (0, _pointerMove.pointerMove)({ ...action,
28
+ target,
29
+ coords
30
+ }, state);
31
+ ret.push(promise);
32
+
33
+ if (options.delay > 0) {
34
+ await promise;
35
+
36
+ if (i < actions.length - 1) {
37
+ await (0, _utils.wait)(options.delay);
38
+ }
39
+ }
40
+ }
41
+
42
+ delete state.pointerState.activeClickCount;
43
+ return Promise.all(ret);
44
+ }
45
+
46
+ function getPrevTarget(pointerName, state) {
47
+ if (!(pointerName in state.position) || !state.position[pointerName].target) {
48
+ throw new Error('This pointer has no previous position. Provide a target property!');
49
+ }
50
+
51
+ return state.position[pointerName].target;
52
+ }