@testing-library/user-event 13.4.1 → 14.0.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +4 -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 +29 -143
  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 +15 -57
  16. package/dist/index.d.ts +4 -21
  17. package/dist/index.js +4 -29
  18. package/dist/keyboard/getNextKeyDef.d.ts +3 -0
  19. package/dist/keyboard/getNextKeyDef.js +59 -87
  20. package/dist/keyboard/index.d.ts +1 -0
  21. package/dist/keyboard/index.js +4 -0
  22. package/dist/keyboard/keyMap.js +4 -0
  23. package/dist/keyboard/keyboardImplementation.js +28 -8
  24. package/dist/keyboard/plugins/arrow.js +7 -12
  25. package/dist/keyboard/plugins/character.js +29 -57
  26. package/dist/keyboard/plugins/combination.d.ts +5 -0
  27. package/dist/keyboard/plugins/combination.js +17 -0
  28. package/dist/keyboard/plugins/control.js +5 -16
  29. package/dist/keyboard/plugins/functional.js +33 -15
  30. package/dist/keyboard/plugins/index.js +5 -5
  31. package/dist/keyboard/shared/index.d.ts +0 -2
  32. package/dist/keyboard/shared/index.js +0 -26
  33. package/dist/keyboard/types.d.ts +8 -0
  34. package/dist/paste.d.ts +3 -2
  35. package/dist/paste.js +8 -15
  36. package/dist/pointer/index.d.ts +18 -0
  37. package/dist/pointer/index.js +90 -0
  38. package/dist/pointer/keyMap.d.ts +2 -0
  39. package/dist/pointer/keyMap.js +29 -0
  40. package/dist/pointer/parseKeyDef.d.ts +6 -0
  41. package/dist/pointer/parseKeyDef.js +36 -0
  42. package/dist/pointer/pointerAction.d.ts +6 -0
  43. package/dist/pointer/pointerAction.js +52 -0
  44. package/dist/pointer/pointerMove.d.ts +5 -0
  45. package/dist/pointer/pointerMove.js +136 -0
  46. package/dist/pointer/pointerPress.d.ts +7 -0
  47. package/dist/pointer/pointerPress.js +330 -0
  48. package/dist/pointer/resolveSelectionTarget.d.ts +5 -0
  49. package/dist/pointer/resolveSelectionTarget.js +75 -0
  50. package/dist/pointer/types.d.ts +72 -0
  51. package/dist/pointer/types.js +1 -0
  52. package/dist/selectOptions.d.ts +4 -0
  53. package/dist/{select-options.js → selectOptions.js} +18 -20
  54. package/dist/setup.d.ts +92 -0
  55. package/dist/setup.js +203 -0
  56. package/dist/tab.d.ts +3 -4
  57. package/dist/tab.js +3 -136
  58. package/dist/type.d.ts +14 -0
  59. package/dist/type.js +74 -0
  60. package/dist/upload.d.ts +4 -3
  61. package/dist/upload.js +3 -9
  62. package/dist/utils/edit/calculateNewValue.d.ts +12 -5
  63. package/dist/utils/edit/calculateNewValue.js +19 -21
  64. package/dist/utils/edit/editInputElement.d.ts +16 -0
  65. package/dist/utils/edit/editInputElement.js +53 -0
  66. package/dist/utils/edit/getValue.d.ts +1 -1
  67. package/dist/utils/edit/getValue.js +3 -1
  68. package/dist/utils/edit/isContentEditable.d.ts +4 -0
  69. package/dist/utils/edit/isContentEditable.js +14 -0
  70. package/dist/utils/edit/isEditable.d.ts +1 -0
  71. package/dist/utils/edit/prepareInput.d.ts +7 -0
  72. package/dist/utils/edit/prepareInput.js +77 -0
  73. package/dist/{blur.d.ts → utils/focus/blur.d.ts} +0 -0
  74. package/dist/utils/focus/blur.js +19 -0
  75. package/dist/{focus.d.ts → utils/focus/focus.d.ts} +0 -0
  76. package/dist/utils/focus/focus.js +22 -0
  77. package/dist/utils/focus/getTabDestination.d.ts +1 -0
  78. package/dist/utils/focus/getTabDestination.js +71 -0
  79. package/dist/utils/focus/isFocusable.js +1 -3
  80. package/dist/utils/focus/selectAll.d.ts +5 -0
  81. package/dist/utils/focus/selectAll.js +51 -0
  82. package/dist/utils/focus/selection.d.ts +42 -0
  83. package/dist/utils/focus/selection.js +190 -0
  84. package/dist/utils/index.d.ts +13 -6
  85. package/dist/utils/index.js +145 -54
  86. package/dist/utils/keyDef/readNextDescriptor.d.ts +19 -0
  87. package/dist/utils/keyDef/readNextDescriptor.js +102 -0
  88. package/dist/utils/misc/findClosest.d.ts +1 -0
  89. package/dist/utils/misc/findClosest.js +20 -0
  90. package/dist/utils/misc/hasFormSubmit.d.ts +1 -0
  91. package/dist/utils/misc/hasFormSubmit.js +10 -0
  92. package/dist/utils/misc/isDescendantOrSelf.d.ts +1 -0
  93. package/dist/utils/misc/isDescendantOrSelf.js +20 -0
  94. package/dist/utils/pointer/firePointerEvents.d.ts +25 -0
  95. package/dist/utils/pointer/firePointerEvents.js +112 -0
  96. package/dist/utils/pointer/mouseButtons.d.ts +12 -0
  97. package/dist/utils/pointer/mouseButtons.js +45 -0
  98. package/package.json +4 -3
  99. package/dist/blur.js +0 -15
  100. package/dist/dom-helpers.d.ts +0 -3
  101. package/dist/focus.js +0 -15
  102. package/dist/keyboard/shared/carryValue.d.ts +0 -2
  103. package/dist/keyboard/shared/carryValue.js +0 -13
  104. package/dist/keyboard/shared/fireInputEvent.d.ts +0 -17
  105. package/dist/keyboard/shared/fireInputEvent.js +0 -110
  106. package/dist/select-options.d.ts +0 -4
  107. package/dist/type/index.d.ts +0 -7
  108. package/dist/type/index.js +0 -33
  109. package/dist/type/typeImplementation.d.ts +0 -10
  110. package/dist/type/typeImplementation.js +0 -64
  111. package/dist/utils/click/getMouseEventOptions.d.ts +0 -31
  112. package/dist/utils/click/getMouseEventOptions.js +0 -61
  113. package/dist/utils/edit/cursorPosition.d.ts +0 -2
  114. package/dist/utils/edit/cursorPosition.js +0 -35
  115. package/dist/utils/edit/hasUnreliableEmptyValue.d.ts +0 -10
  116. package/dist/utils/edit/hasUnreliableEmptyValue.js +0 -21
  117. package/dist/utils/edit/selectionRange.d.ts +0 -16
  118. package/dist/utils/edit/selectionRange.js +0 -104
  119. package/dist/utils/misc/isDocument.d.ts +0 -1
  120. package/dist/utils/misc/isDocument.js +0 -10
  121. package/dist/utils/misc/isLabelWithInternallyDisabledControl.d.ts +0 -1
  122. package/dist/utils/misc/isLabelWithInternallyDisabledControl.js +0 -22
@@ -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,24 +53,42 @@ 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;
73
82
  const keypressBehavior = [{
83
+ matches: (keyDef, element) => keyDef.key === 'Enter' && (0, _utils.isElementType)(element, 'input') && ['checkbox', 'radio'].includes(element.type),
84
+ handle: (keyDef, element) => {
85
+ const form = element.form;
86
+
87
+ if ((0, _utils.hasFormSubmit)(form)) {
88
+ _dom.fireEvent.submit(form);
89
+ }
90
+ }
91
+ }, {
74
92
  matches: (keyDef, element) => keyDef.key === 'Enter' && ((0, _utils.isClickableInput)(element) || // Links with href defined should handle Enter the same as a click
75
93
  (0, _utils.isElementType)(element, 'a') && Boolean(element.href)),
76
94
  handle: (keyDef, element, options, state) => {
@@ -81,7 +99,7 @@ const keypressBehavior = [{
81
99
  handle: (keyDef, element) => {
82
100
  const form = element.form;
83
101
 
84
- if (form && (form.querySelectorAll('input').length === 1 || form.querySelector('input[type="submit"]') || form.querySelector('button[type="submit"]'))) {
102
+ if (form && (form.querySelectorAll('input').length === 1 || (0, _utils.hasFormSubmit)(form))) {
85
103
  _dom.fireEvent.submit(form);
86
104
  }
87
105
  }
@@ -15,22 +15,22 @@ var characterKeys = _interopRequireWildcard(require("./character"));
15
15
 
16
16
  var functionalKeys = _interopRequireWildcard(require("./functional"));
17
17
 
18
+ var combination = _interopRequireWildcard(require("./combination"));
19
+
18
20
  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
21
 
20
22
  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
23
 
22
24
  const replaceBehavior = [{
23
25
  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);
26
+ handle: (keyDef, element) => {
27
+ (0, _utils.setSelectionRange)(element, 0, (0, _utils.getValue)(element).length);
28
28
  }
29
29
  }];
30
30
  exports.replaceBehavior = replaceBehavior;
31
31
  const preKeydownBehavior = [...functionalKeys.preKeydownBehavior];
32
32
  exports.preKeydownBehavior = preKeydownBehavior;
33
- const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior];
33
+ const keydownBehavior = [...arrowKeys.keydownBehavior, ...controlKeys.keydownBehavior, ...functionalKeys.keydownBehavior, ...combination.keydownBehavior];
34
34
  exports.keydownBehavior = keydownBehavior;
35
35
  const keypressBehavior = [...functionalKeys.keypressBehavior, ...characterKeys.keypressBehavior];
36
36
  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
  });
@@ -1,3 +1,4 @@
1
+ import { getNextKeyDef } from './getNextKeyDef';
1
2
  /**
2
3
  * @internal Do not create/alter this by yourself as this type might be subject to changes.
3
4
  */
@@ -28,6 +29,9 @@ export declare type keyboardState = {
28
29
  For HTMLInputElements type='number':
29
30
  If the last input char is '.', '-' or 'e',
30
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.
31
35
  */
32
36
  carryValue?: string;
33
37
  /**
@@ -35,6 +39,10 @@ export declare type keyboardState = {
35
39
  E.g. ^1
36
40
  */
37
41
  carryChar: string;
42
+ /**
43
+ Repeat keydown and keypress event
44
+ */
45
+ repeatKey?: ReturnType<typeof getNextKeyDef>;
38
46
  };
39
47
  export declare type keyboardOptions = {
40
48
  /** Document in which to perform the events */
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
+ }
@@ -0,0 +1,5 @@
1
+ import { inputDeviceState, PointerTarget, SelectionTarget } from './types';
2
+ export interface PointerMoveAction extends PointerTarget, SelectionTarget {
3
+ pointerName?: string;
4
+ }
5
+ export declare function pointerMove({ pointerName, target, coords, node, offset }: PointerMoveAction, { pointerState, keyboardState }: inputDeviceState): Promise<void>;
@@ -0,0 +1,136 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.pointerMove = pointerMove;
7
+
8
+ var _document = require("../document");
9
+
10
+ var _utils = require("../utils");
11
+
12
+ var _resolveSelectionTarget = require("./resolveSelectionTarget");
13
+
14
+ async function pointerMove({
15
+ pointerName = 'mouse',
16
+ target,
17
+ coords,
18
+ node,
19
+ offset
20
+ }, {
21
+ pointerState,
22
+ keyboardState
23
+ }) {
24
+ if (!(pointerName in pointerState.position)) {
25
+ throw new Error(`Trying to move pointer "${pointerName}" which does not exist.`);
26
+ }
27
+
28
+ const {
29
+ pointerId,
30
+ pointerType,
31
+ target: prevTarget,
32
+ coords: prevCoords,
33
+ selectionRange
34
+ } = pointerState.position[pointerName];
35
+
36
+ if (prevTarget && prevTarget !== target) {
37
+ // Here we could probably calculate a few coords to a fake boundary(?)
38
+ fireMove(prevTarget, prevCoords);
39
+
40
+ if (!(0, _utils.isDescendantOrSelf)(target, prevTarget)) {
41
+ fireLeave(prevTarget, prevCoords);
42
+ }
43
+ }
44
+
45
+ pointerState.position[pointerName] = { ...pointerState.position[pointerName],
46
+ target,
47
+ coords
48
+ };
49
+
50
+ if (prevTarget !== target) {
51
+ if (!prevTarget || !(0, _utils.isDescendantOrSelf)(prevTarget, target)) {
52
+ fireEnter(target, coords);
53
+ }
54
+ } // TODO: drag if the target didn't change?
55
+ // Here we could probably calculate a few coords leading up to the final position
56
+
57
+
58
+ fireMove(target, coords);
59
+
60
+ if (selectionRange) {
61
+ // TODO: support extending range (shift)
62
+ const selectionFocus = (0, _resolveSelectionTarget.resolveSelectionTarget)({
63
+ target,
64
+ node,
65
+ offset
66
+ });
67
+
68
+ if ('node' in selectionRange) {
69
+ // When the mouse is dragged outside of an input/textarea,
70
+ // the selection is extended to the beginning or end of the input
71
+ // depending on pointer position.
72
+ // TODO: extend selection according to pointer position
73
+
74
+ /* istanbul ignore else */
75
+ if (selectionFocus.node === selectionRange.node) {
76
+ const anchorOffset = selectionFocus.offset < selectionRange.start ? selectionRange.end : selectionRange.start;
77
+ const focusOffset = selectionFocus.offset > selectionRange.end || selectionFocus.offset < selectionRange.start ? selectionFocus.offset : selectionRange.end;
78
+ (0, _document.setUISelection)(selectionRange.node, {
79
+ anchorOffset,
80
+ focusOffset
81
+ });
82
+ }
83
+ } else {
84
+ const range = selectionRange.cloneRange();
85
+ const cmp = range.comparePoint(selectionFocus.node, selectionFocus.offset);
86
+
87
+ if (cmp < 0) {
88
+ range.setStart(selectionFocus.node, selectionFocus.offset);
89
+ } else if (cmp > 0) {
90
+ range.setEnd(selectionFocus.node, selectionFocus.offset);
91
+ }
92
+
93
+ const selection = target.ownerDocument.getSelection();
94
+ selection.removeAllRanges();
95
+ selection.addRange(range.cloneRange());
96
+ }
97
+ }
98
+
99
+ function fireMove(eventTarget, eventCoords) {
100
+ fire(eventTarget, 'pointermove', eventCoords);
101
+
102
+ if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
103
+ fire(eventTarget, 'mousemove', eventCoords);
104
+ }
105
+ }
106
+
107
+ function fireLeave(eventTarget, eventCoords) {
108
+ fire(eventTarget, 'pointerout', eventCoords);
109
+ fire(eventTarget, 'pointerleave', eventCoords);
110
+
111
+ if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
112
+ fire(eventTarget, 'mouseout', eventCoords);
113
+ fire(eventTarget, 'mouseleave', eventCoords);
114
+ }
115
+ }
116
+
117
+ function fireEnter(eventTarget, eventCoords) {
118
+ fire(eventTarget, 'pointerover', eventCoords);
119
+ fire(eventTarget, 'pointerenter', eventCoords);
120
+
121
+ if (pointerType === 'mouse' && !(0, _utils.isDisabled)(eventTarget)) {
122
+ fire(eventTarget, 'mouseover', eventCoords);
123
+ fire(eventTarget, 'mouseenter', eventCoords);
124
+ }
125
+ }
126
+
127
+ function fire(eventTarget, type, eventCoords) {
128
+ return (0, _utils.firePointerEvent)(eventTarget, type, {
129
+ pointerState,
130
+ keyboardState,
131
+ coords: eventCoords,
132
+ pointerId,
133
+ pointerType
134
+ });
135
+ }
136
+ }