@testing-library/react-native 12.1.3 → 12.2.0

package/build/user-event/press/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "PressOptions", {
+  enumerable: true,
+  get: function () {
+    return _press.PressOptions;
+  }
+});
 Object.defineProperty(exports, "longPress", {
   enumerable: true,
   get: function () {

package/build/user-event/press/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_press","require"],"sources":["../../../src/user-event/press/index.ts"],"sourcesContent":["export { press, longPress } from './press';\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA"}
+{"version":3,"file":"index.js","names":["_press","require"],"sources":["../../../src/user-event/press/index.ts"],"sourcesContent":["export { PressOptions, press, longPress } from './press';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA"}

package/build/user-event/press/press.d.ts

@@ -1,7 +1,7 @@
 import { ReactTestInstance } from 'react-test-renderer';
 import { UserEventInstance } from '../setup';
-export type PressOptions = {
-    duration: number;
-};
+export interface PressOptions {
+    duration?: number;
+}
 export declare function press(this: UserEventInstance, element: ReactTestInstance): Promise<void>;
 export declare function longPress(this: UserEventInstance, element: ReactTestInstance, options?: PressOptions): Promise<void>;

package/build/user-event/press/press.js

@@ -5,37 +5,37 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.longPress = longPress;
 exports.press = press;
-var _eventBuilder = require("../event-builder");
-var _utils = require("../utils");
 var _act = _interopRequireDefault(require("../../act"));
 var _componentTree = require("../../helpers/component-tree");
-var _filterNodeByType = require("../../helpers/filterNodeByType");
 var _pointerEvents = require("../../helpers/pointer-events");
 var _hostComponentNames = require("../../helpers/host-component-names");
-var _timers = require("../../helpers/timers");
+var _eventBuilder = require("../event-builder");
+var _utils = require("../utils");
 var _constants = require("./constants");
-var _warnAboutRealTimers = require("./utils/warnAboutRealTimers");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 async function press(element) {
-  await basePress(this.config, element);
+  await basePress(this.config, element, {
+    type: 'press',
+    duration: 0
+  });
 }
-async function longPress(element, options = {
-  duration: 500
-}) {
-  await basePress(this.config, element, options);
+async function longPress(element, options) {
+  await basePress(this.config, element, {
+    type: 'longPress',
+    duration: options?.duration ?? 500
+  });
 }
-const basePress = async (config, element, options = {
-  duration: 0
-}) => {
-  // Text and TextInput components are mocked in React Native preset so the mock
-  // doesn't implement the pressability class
-  // Thus we need to call the props directly on the host component
-  if (isEnabledHostText(element) || isEnabledTextInput(element)) {
-    await triggerMockPressEvent(config, element, options);
+const basePress = async (config, element, options) => {
+  if (isPressableText(element)) {
+    await emitTextPressEvents(config, element, options);
+    return;
+  }
+  if (isEnabledTextInput(element)) {
+    await emitTextInputPressEvents(config, element, options);
     return;
   }
   if (isEnabledTouchResponder(element)) {
-    await triggerPressEvent(config, element, options);
+    await emitPressablePressEvents(config, element, options);
     return;
   }
   const hostParentElement = (0, _componentTree.getHostParent)(element);
@@ -44,28 +44,17 @@ const basePress = async (config, element, options = {
   }
   await basePress(config, hostParentElement, options);
 };
-const triggerPressEvent = async (config, element, options = {
-  duration: 0
-}) => {
-  const areFakeTimersEnabled = (0, _timers.jestFakeTimersAreEnabled)();
-  if (!areFakeTimersEnabled) {
-    (0, _warnAboutRealTimers.warnAboutRealTimers)();
-  }
+const emitPressablePressEvents = async (config, element, options) => {
+  (0, _utils.warnAboutRealTimersIfNeeded)();
   await (0, _utils.wait)(config);
   await (0, _act.default)(async () => {
-    element.props.onResponderGrant({
-      ..._eventBuilder.EventBuilder.Common.touch(),
-      dispatchConfig: {
-        registrationName: 'onResponderGrant'
-      }
-    });
+    (0, _utils.dispatchEvent)(element, 'responderGrant', _eventBuilder.EventBuilder.Common.responderGrant());
     await (0, _utils.wait)(config, options.duration);
-    element.props.onResponderRelease({
-      ..._eventBuilder.EventBuilder.Common.touch(),
-      dispatchConfig: {
-        registrationName: 'onResponderRelease'
-      }
-    });
+    (0, _utils.dispatchEvent)(element, 'responderRelease', _eventBuilder.EventBuilder.Common.responderRelease());
+
+    // React Native will wait for minimal delay of DEFAULT_MIN_PRESS_DURATION
+    // before emitting the `pressOut` event. We need to wait here, so that
+    // `press()` function does not return before that.
     if (_constants.DEFAULT_MIN_PRESS_DURATION - options.duration > 0) {
       await (0, _utils.wait)(config, _constants.DEFAULT_MIN_PRESS_DURATION - options.duration);
     }
@@ -74,33 +63,37 @@ const triggerPressEvent = async (config, element, options = {
 const isEnabledTouchResponder = element => {
   return (0, _pointerEvents.isPointerEventEnabled)(element) && element.props.onStartShouldSetResponder?.();
 };
-const isEnabledHostText = element => {
-  return (0, _filterNodeByType.filterNodeByType)(element, (0, _hostComponentNames.getHostComponentNames)().text) && (0, _pointerEvents.isPointerEventEnabled)(element) && !element.props.disabled && element.props.onPress;
+const isPressableText = element => {
+  const hasPressEventHandler = Boolean(element.props.onPress || element.props.onLongPress || element.props.onPressIn || element.props.onPressOut);
+  return (0, _hostComponentNames.isHostText)(element) && (0, _pointerEvents.isPointerEventEnabled)(element) && !element.props.disabled && hasPressEventHandler;
 };
 const isEnabledTextInput = element => {
-  return (0, _filterNodeByType.filterNodeByType)(element, (0, _hostComponentNames.getHostComponentNames)().textInput) && (0, _pointerEvents.isPointerEventEnabled)(element) && element.props.editable !== false;
+  return (0, _hostComponentNames.isHostTextInput)(element) && (0, _pointerEvents.isPointerEventEnabled)(element) && element.props.editable !== false;
 };
-const triggerMockPressEvent = async (config, element, options = {
-  duration: 0
-}) => {
-  const {
-    onPressIn,
-    onPress,
-    onPressOut
-  } = element.props;
+
+/**
+ * Dispatches a press event sequence for Text.
+ */
+async function emitTextPressEvents(config, element, options) {
   await (0, _utils.wait)(config);
-  if (onPressIn) {
-    onPressIn(_eventBuilder.EventBuilder.Common.touch());
-  }
-  if (onPress) {
-    onPress(_eventBuilder.EventBuilder.Common.touch());
-  }
+  (0, _utils.dispatchEvent)(element, 'pressIn', _eventBuilder.EventBuilder.Common.touch());
+
+  // Emit either `press` or `longPress`.
+  (0, _utils.dispatchEvent)(element, options.type, _eventBuilder.EventBuilder.Common.touch());
   await (0, _utils.wait)(config, options.duration);
-  if (onPressOut) {
-    if (_constants.DEFAULT_MIN_PRESS_DURATION - options.duration > 0) {
-      await (0, _utils.wait)(config, _constants.DEFAULT_MIN_PRESS_DURATION - options.duration);
-    }
-    onPressOut(_eventBuilder.EventBuilder.Common.touch());
-  }
-};
+  (0, _utils.dispatchEvent)(element, 'pressOut', _eventBuilder.EventBuilder.Common.touch());
+}
+
+/**
+ * Dispatches a press event sequence for TextInput.
+ */
+async function emitTextInputPressEvents(config, element, options) {
+  await (0, _utils.wait)(config);
+  (0, _utils.dispatchEvent)(element, 'pressIn', _eventBuilder.EventBuilder.Common.touch());
+
+  // Note: TextInput does not have `onPress`/`onLongPress` props.
+
+  await (0, _utils.wait)(config, options.duration);
+  (0, _utils.dispatchEvent)(element, 'pressOut', _eventBuilder.EventBuilder.Common.touch());
+}
 //# sourceMappingURL=press.js.map

package/build/user-event/press/press.js.map

@@ -1 +1 @@
-{"version":3,"file":"press.js","names":["_eventBuilder","require","_utils","_act","_interopRequireDefault","_componentTree","_filterNodeByType","_pointerEvents","_hostComponentNames","_timers","_constants","_warnAboutRealTimers","obj","__esModule","default","press","element","basePress","config","longPress","options","duration","isEnabledHostText","isEnabledTextInput","triggerMockPressEvent","isEnabledTouchResponder","triggerPressEvent","hostParentElement","getHostParent","areFakeTimersEnabled","jestFakeTimersAreEnabled","warnAboutRealTimers","wait","act","props","onResponderGrant","EventBuilder","Common","touch","dispatchConfig","registrationName","onResponderRelease","DEFAULT_MIN_PRESS_DURATION","isPointerEventEnabled","onStartShouldSetResponder","filterNodeByType","getHostComponentNames","text","disabled","onPress","textInput","editable","onPressIn","onPressOut"],"sources":["../../../src/user-event/press/press.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport { EventBuilder } from '../event-builder';\nimport { UserEventInstance } from '../setup';\nimport { wait } from '../utils';\nimport act from '../../act';\nimport { getHostParent } from '../../helpers/component-tree';\nimport { filterNodeByType } from '../../helpers/filterNodeByType';\nimport { isPointerEventEnabled } from '../../helpers/pointer-events';\nimport { getHostComponentNames } from '../../helpers/host-component-names';\nimport { jestFakeTimersAreEnabled } from '../../helpers/timers';\nimport { DEFAULT_MIN_PRESS_DURATION } from './constants';\nimport { warnAboutRealTimers } from './utils/warnAboutRealTimers';\n\nexport type PressOptions = {\n  duration: number;\n};\n\nexport async function press(\n  this: UserEventInstance,\n  element: ReactTestInstance\n): Promise<void> {\n  await basePress(this.config, element);\n}\n\nexport async function longPress(\n  this: UserEventInstance,\n  element: ReactTestInstance,\n  options: PressOptions = { duration: 500 }\n): Promise<void> {\n  await basePress(this.config, element, options);\n}\n\nconst basePress = async (\n  config: UserEventInstance['config'],\n  element: ReactTestInstance,\n  options: PressOptions = { duration: 0 }\n): Promise<void> => {\n  // Text and TextInput components are mocked in React Native preset so the mock\n  // doesn't implement the pressability class\n  // Thus we need to call the props directly on the host component\n  if (isEnabledHostText(element) || isEnabledTextInput(element)) {\n    await triggerMockPressEvent(config, element, options);\n    return;\n  }\n\n  if (isEnabledTouchResponder(element)) {\n    await triggerPressEvent(config, element, options);\n    return;\n  }\n\n  const hostParentElement = getHostParent(element);\n  if (!hostParentElement) {\n    return;\n  }\n\n  await basePress(config, hostParentElement, options);\n};\n\nconst triggerPressEvent = async (\n  config: UserEventInstance['config'],\n  element: ReactTestInstance,\n  options: PressOptions = { duration: 0 }\n) => {\n  const areFakeTimersEnabled = jestFakeTimersAreEnabled();\n  if (!areFakeTimersEnabled) {\n    warnAboutRealTimers();\n  }\n\n  await wait(config);\n\n  await act(async () => {\n    element.props.onResponderGrant({\n      ...EventBuilder.Common.touch(),\n      dispatchConfig: { registrationName: 'onResponderGrant' },\n    });\n\n    await wait(config, options.duration);\n\n    element.props.onResponderRelease({\n      ...EventBuilder.Common.touch(),\n      dispatchConfig: { registrationName: 'onResponderRelease' },\n    });\n\n    if (DEFAULT_MIN_PRESS_DURATION - options.duration > 0) {\n      await wait(config, DEFAULT_MIN_PRESS_DURATION - options.duration);\n    }\n  });\n};\n\nconst isEnabledTouchResponder = (element: ReactTestInstance) => {\n  return (\n    isPointerEventEnabled(element) &&\n    element.props.onStartShouldSetResponder?.()\n  );\n};\n\nconst isEnabledHostText = (element: ReactTestInstance) => {\n  return (\n    filterNodeByType(element, getHostComponentNames().text) &&\n    isPointerEventEnabled(element) &&\n    !element.props.disabled &&\n    element.props.onPress\n  );\n};\n\nconst isEnabledTextInput = (element: ReactTestInstance) => {\n  return (\n    filterNodeByType(element, getHostComponentNames().textInput) &&\n    isPointerEventEnabled(element) &&\n    element.props.editable !== false\n  );\n};\n\nconst triggerMockPressEvent = async (\n  config: UserEventInstance['config'],\n  element: ReactTestInstance,\n  options: PressOptions = { duration: 0 }\n) => {\n  const { onPressIn, onPress, onPressOut } = element.props;\n  await wait(config);\n  if (onPressIn) {\n    onPressIn(EventBuilder.Common.touch());\n  }\n  if (onPress) {\n    onPress(EventBuilder.Common.touch());\n  }\n  await wait(config, options.duration);\n  if (onPressOut) {\n    if (DEFAULT_MIN_PRESS_DURATION - options.duration > 0) {\n      await wait(config, DEFAULT_MIN_PRESS_DURATION - options.duration);\n    }\n    onPressOut(EventBuilder.Common.touch());\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"press.js","names":["_act","_interopRequireDefault","require","_componentTree","_pointerEvents","_hostComponentNames","_eventBuilder","_utils","_constants","obj","__esModule","default","press","element","basePress","config","type","duration","longPress","options","isPressableText","emitTextPressEvents","isEnabledTextInput","emitTextInputPressEvents","isEnabledTouchResponder","emitPressablePressEvents","hostParentElement","getHostParent","warnAboutRealTimersIfNeeded","wait","act","dispatchEvent","EventBuilder","Common","responderGrant","responderRelease","DEFAULT_MIN_PRESS_DURATION","isPointerEventEnabled","props","onStartShouldSetResponder","hasPressEventHandler","Boolean","onPress","onLongPress","onPressIn","onPressOut","isHostText","disabled","isHostTextInput","editable","touch"],"sources":["../../../src/user-event/press/press.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport act from '../../act';\nimport { getHostParent } from '../../helpers/component-tree';\nimport { isPointerEventEnabled } from '../../helpers/pointer-events';\nimport {\n  isHostText,\n  isHostTextInput,\n} from '../../helpers/host-component-names';\nimport { EventBuilder } from '../event-builder';\nimport { UserEventConfig, UserEventInstance } from '../setup';\nimport { dispatchEvent, wait, warnAboutRealTimersIfNeeded } from '../utils';\nimport { DEFAULT_MIN_PRESS_DURATION } from './constants';\n\nexport interface PressOptions {\n  duration?: number;\n}\n\nexport async function press(\n  this: UserEventInstance,\n  element: ReactTestInstance\n): Promise<void> {\n  await basePress(this.config, element, {\n    type: 'press',\n    duration: 0,\n  });\n}\n\nexport async function longPress(\n  this: UserEventInstance,\n  element: ReactTestInstance,\n  options?: PressOptions\n): Promise<void> {\n  await basePress(this.config, element, {\n    type: 'longPress',\n    duration: options?.duration ?? 500,\n  });\n}\n\ninterface BasePressOptions {\n  type: 'press' | 'longPress';\n  duration: number;\n}\n\nconst basePress = async (\n  config: UserEventConfig,\n  element: ReactTestInstance,\n  options: BasePressOptions\n): Promise<void> => {\n  if (isPressableText(element)) {\n    await emitTextPressEvents(config, element, options);\n    return;\n  }\n\n  if (isEnabledTextInput(element)) {\n    await emitTextInputPressEvents(config, element, options);\n    return;\n  }\n\n  if (isEnabledTouchResponder(element)) {\n    await emitPressablePressEvents(config, element, options);\n    return;\n  }\n\n  const hostParentElement = getHostParent(element);\n  if (!hostParentElement) {\n    return;\n  }\n\n  await basePress(config, hostParentElement, options);\n};\n\nconst emitPressablePressEvents = async (\n  config: UserEventConfig,\n  element: ReactTestInstance,\n  options: BasePressOptions\n) => {\n  warnAboutRealTimersIfNeeded();\n\n  await wait(config);\n\n  await act(async () => {\n    dispatchEvent(\n      element,\n      'responderGrant',\n      EventBuilder.Common.responderGrant()\n    );\n\n    await wait(config, options.duration);\n\n    dispatchEvent(\n      element,\n      'responderRelease',\n      EventBuilder.Common.responderRelease()\n    );\n\n    // React Native will wait for minimal delay of DEFAULT_MIN_PRESS_DURATION\n    // before emitting the `pressOut` event. We need to wait here, so that\n    // `press()` function does not return before that.\n    if (DEFAULT_MIN_PRESS_DURATION - options.duration > 0) {\n      await wait(config, DEFAULT_MIN_PRESS_DURATION - options.duration);\n    }\n  });\n};\n\nconst isEnabledTouchResponder = (element: ReactTestInstance) => {\n  return (\n    isPointerEventEnabled(element) &&\n    element.props.onStartShouldSetResponder?.()\n  );\n};\n\nconst isPressableText = (element: ReactTestInstance) => {\n  const hasPressEventHandler = Boolean(\n    element.props.onPress ||\n      element.props.onLongPress ||\n      element.props.onPressIn ||\n      element.props.onPressOut\n  );\n\n  return (\n    isHostText(element) &&\n    isPointerEventEnabled(element) &&\n    !element.props.disabled &&\n    hasPressEventHandler\n  );\n};\n\nconst isEnabledTextInput = (element: ReactTestInstance) => {\n  return (\n    isHostTextInput(element) &&\n    isPointerEventEnabled(element) &&\n    element.props.editable !== false\n  );\n};\n\n/**\n * Dispatches a press event sequence for Text.\n */\nasync function emitTextPressEvents(\n  config: UserEventConfig,\n  element: ReactTestInstance,\n  options: BasePressOptions\n) {\n  await wait(config);\n  dispatchEvent(element, 'pressIn', EventBuilder.Common.touch());\n\n  // Emit either `press` or `longPress`.\n  dispatchEvent(element, options.type, EventBuilder.Common.touch());\n\n  await wait(config, options.duration);\n  dispatchEvent(element, 'pressOut', EventBuilder.Common.touch());\n}\n\n/**\n * Dispatches a press event sequence for TextInput.\n */\nasync function emitTextInputPressEvents(\n  config: UserEventConfig,\n  element: ReactTestInstance,\n  options: BasePressOptions\n) {\n  await wait(config);\n  dispatchEvent(element, 'pressIn', EventBuilder.Common.touch());\n\n  // Note: TextInput does not have `onPress`/`onLongPress` props.\n\n  await wait(config, options.duration);\n  dispatchEvent(element, 'pressOut', EventBuilder.Common.touch());\n}\n"],"mappings":"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"}

package/build/user-event/setup/setup.d.ts

@@ -1,5 +1,6 @@
 import { ReactTestInstance } from 'react-test-renderer';
-import { PressOptions } from '../press/press';
+import { PressOptions } from '../press';
+import { TypeOptions } from '../type';
 export interface UserEventSetupOptions {
     /**
      * Between some subsequent inputs like typing a series of characters
@@ -24,16 +25,45 @@ export interface UserEventSetupOptions {
  * Creates a new instance of user event instance with the given options.
  *
  * @param options
- * @returns
+ * @returns UserEvent instance
  */
 export declare function setup(options?: UserEventSetupOptions): UserEventInstance;
+/**
+ * Options affecting all user event interactions.
+ *
+ * @param delay between some subsequent inputs like typing a series of characters
+ * @param advanceTimers function to be called to advance fake timers
+ */
 export interface UserEventConfig {
     delay: number;
     advanceTimers: (delay: number) => Promise<void> | void;
 }
+/**
+ * UserEvent instance used to invoke user interaction functions.
+ */
 export interface UserEventInstance {
     config: UserEventConfig;
     press: (element: ReactTestInstance) => Promise<void>;
     longPress: (element: ReactTestInstance, options?: PressOptions) => Promise<void>;
-    type: (element: ReactTestInstance, text: string) => Promise<void>;
+    /**
+     * Simulate user pressing on given `TextInput` element and typing given text.
+     *
+     * This method will trigger the events for each character of the text:
+     * `keyPress`, `change`, `changeText`, `endEditing`, etc.
+     *
+     * It will also trigger events connected with entering and leaving the text
+     * input.
+     *
+     * The exact events sent depend on the props of TextInput (`editable`,
+     * `multiline`, value, defaultValue, etc) and passed options.
+     *
+     * @param element TextInput element to type on
+     * @param text Text to type
+     * @param options Options affecting typing behavior:
+     *  - `skipPress` - if true, `pressIn` and `pressOut` events will not be
+     *   triggered.
+     * - `submitEditing` - if true, `submitEditing` event will be triggered after
+     * typing the text.
+     */
+    type: (element: ReactTestInstance, text: string, options?: TypeOptions) => Promise<void>;
 }

package/build/user-event/setup/setup.js

@@ -26,19 +26,32 @@ const defaultOptions = {
  * Creates a new instance of user event instance with the given options.
  *
  * @param options
- * @returns
+ * @returns UserEvent instance
  */
 function setup(options) {
   const config = createConfig(options);
   const instance = createInstance(config);
   return instance;
 }
+
+/**
+ * Options affecting all user event interactions.
+ *
+ * @param delay between some subsequent inputs like typing a series of characters
+ * @param advanceTimers function to be called to advance fake timers
+ */
+
 function createConfig(options) {
   return {
     ...defaultOptions,
     ...options
   };
 }
+
+/**
+ * UserEvent instance used to invoke user interaction functions.
+ */
+
 function createInstance(config) {
   const instance = {
     config

package/build/user-event/setup/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","names":["_timers","require","_press","_type","universalJestAdvanceTimersBy","ms","jestFakeTimersAreEnabled","jest","advanceTimersByTime","Promise","resolve","defaultOptions","delay","advanceTimers","setup","options","config","createConfig","instance","createInstance","api","press","bind","longPress","type","Object","assign"],"sources":["../../../src/user-event/setup/setup.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport { jestFakeTimersAreEnabled } from '../../helpers/timers';\nimport { press, longPress } from '../press';\nimport { type } from '../type';\nimport { PressOptions } from '../press/press';\n\nexport interface UserEventSetupOptions {\n  /**\n   * Between some subsequent inputs like typing a series of characters\n   * the code execution is delayed per `setTimeout` for (at least) `delay` seconds.\n   * This moves the next changes at least to next macro task\n   * and allows other (asynchronous) code to run between events.\n   *\n   * `null` prevents `setTimeout` from being called.\n   *\n   * @default 0\n   */\n  delay?: number;\n\n  /**\n   * Function to be called to advance fake timers. Setting it is necessary for\n   * fake timers to work.\n   *\n   * @example jest.advanceTimersByTime\n   */\n  advanceTimers?: (delay: number) => Promise<void> | void;\n}\n\n/**\n * This functions allow wait to work correctly under both real and fake Jest timers.\n */\nfunction universalJestAdvanceTimersBy(ms: number) {\n  if (jestFakeTimersAreEnabled()) {\n    return jest.advanceTimersByTime(ms);\n  } else {\n    return Promise.resolve();\n  }\n}\n\nconst defaultOptions: Required<UserEventSetupOptions> = {\n  delay: 0,\n  advanceTimers: universalJestAdvanceTimersBy,\n};\n\n/**\n * Creates a new instance of user event instance with the given options.\n *\n * @param options\n * @returns\n */\nexport function setup(options?: UserEventSetupOptions) {\n  const config = createConfig(options);\n  const instance = createInstance(config);\n  return instance;\n}\n\nexport interface UserEventConfig {\n  delay: number;\n  advanceTimers: (delay: number) => Promise<void> | void;\n}\n\nfunction createConfig(options?: UserEventSetupOptions): UserEventConfig {\n  return {\n    ...defaultOptions,\n    ...options,\n  };\n}\n\nexport interface UserEventInstance {\n  config: UserEventConfig;\n  press: (element: ReactTestInstance) => Promise<void>;\n  longPress: (\n    element: ReactTestInstance,\n    options?: PressOptions\n  ) => Promise<void>;\n  type: (element: ReactTestInstance, text: string) => Promise<void>;\n}\n\nfunction createInstance(config: UserEventConfig): UserEventInstance {\n  const instance = {\n    config,\n  } as UserEventInstance;\n\n  // We need to bind these functions, as they access the config through 'this.config'.\n  const api = {\n    press: press.bind(instance),\n    longPress: longPress.bind(instance),\n    type: type.bind(instance),\n  };\n\n  Object.assign(instance, api);\n  return instance;\n}\n"],"mappings":";;;;;;AACA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AAyBA;AACA;AACA;AACA,SAASG,4BAA4BA,CAACC,EAAU,EAAE;EAChD,IAAI,IAAAC,gCAAwB,EAAC,CAAC,EAAE;IAC9B,OAAOC,IAAI,CAACC,mBAAmB,CAACH,EAAE,CAAC;EACrC,CAAC,MAAM;IACL,OAAOI,OAAO,CAACC,OAAO,CAAC,CAAC;EAC1B;AACF;AAEA,MAAMC,cAA+C,GAAG;EACtDC,KAAK,EAAE,CAAC;EACRC,aAAa,EAAET;AACjB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,SAASU,KAAKA,CAACC,OAA+B,EAAE;EACrD,MAAMC,MAAM,GAAGC,YAAY,CAACF,OAAO,CAAC;EACpC,MAAMG,QAAQ,GAAGC,cAAc,CAACH,MAAM,CAAC;EACvC,OAAOE,QAAQ;AACjB;AAOA,SAASD,YAAYA,CAACF,OAA+B,EAAmB;EACtE,OAAO;IACL,GAAGJ,cAAc;IACjB,GAAGI;EACL,CAAC;AACH;AAYA,SAASI,cAAcA,CAACH,MAAuB,EAAqB;EAClE,MAAME,QAAQ,GAAG;IACfF;EACF,CAAsB;;EAEtB;EACA,MAAMI,GAAG,GAAG;IACVC,KAAK,EAAEA,YAAK,CAACC,IAAI,CAACJ,QAAQ,CAAC;IAC3BK,SAAS,EAAEA,gBAAS,CAACD,IAAI,CAACJ,QAAQ,CAAC;IACnCM,IAAI,EAAEA,UAAI,CAACF,IAAI,CAACJ,QAAQ;EAC1B,CAAC;EAEDO,MAAM,CAACC,MAAM,CAACR,QAAQ,EAAEE,GAAG,CAAC;EAC5B,OAAOF,QAAQ;AACjB"}
+{"version":3,"file":"setup.js","names":["_timers","require","_press","_type","universalJestAdvanceTimersBy","ms","jestFakeTimersAreEnabled","jest","advanceTimersByTime","Promise","resolve","defaultOptions","delay","advanceTimers","setup","options","config","createConfig","instance","createInstance","api","press","bind","longPress","type","Object","assign"],"sources":["../../../src/user-event/setup/setup.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport { jestFakeTimersAreEnabled } from '../../helpers/timers';\nimport { PressOptions, press, longPress } from '../press';\nimport { TypeOptions, type } from '../type';\n\nexport interface UserEventSetupOptions {\n  /**\n   * Between some subsequent inputs like typing a series of characters\n   * the code execution is delayed per `setTimeout` for (at least) `delay` seconds.\n   * This moves the next changes at least to next macro task\n   * and allows other (asynchronous) code to run between events.\n   *\n   * `null` prevents `setTimeout` from being called.\n   *\n   * @default 0\n   */\n  delay?: number;\n\n  /**\n   * Function to be called to advance fake timers. Setting it is necessary for\n   * fake timers to work.\n   *\n   * @example jest.advanceTimersByTime\n   */\n  advanceTimers?: (delay: number) => Promise<void> | void;\n}\n\n/**\n * This functions allow wait to work correctly under both real and fake Jest timers.\n */\nfunction universalJestAdvanceTimersBy(ms: number) {\n  if (jestFakeTimersAreEnabled()) {\n    return jest.advanceTimersByTime(ms);\n  } else {\n    return Promise.resolve();\n  }\n}\n\nconst defaultOptions: Required<UserEventSetupOptions> = {\n  delay: 0,\n  advanceTimers: universalJestAdvanceTimersBy,\n};\n\n/**\n * Creates a new instance of user event instance with the given options.\n *\n * @param options\n * @returns UserEvent instance\n */\nexport function setup(options?: UserEventSetupOptions) {\n  const config = createConfig(options);\n  const instance = createInstance(config);\n  return instance;\n}\n\n/**\n * Options affecting all user event interactions.\n *\n * @param delay between some subsequent inputs like typing a series of characters\n * @param advanceTimers function to be called to advance fake timers\n */\nexport interface UserEventConfig {\n  delay: number;\n  advanceTimers: (delay: number) => Promise<void> | void;\n}\n\nfunction createConfig(options?: UserEventSetupOptions): UserEventConfig {\n  return {\n    ...defaultOptions,\n    ...options,\n  };\n}\n\n/**\n * UserEvent instance used to invoke user interaction functions.\n */\nexport interface UserEventInstance {\n  config: UserEventConfig;\n\n  press: (element: ReactTestInstance) => Promise<void>;\n  longPress: (\n    element: ReactTestInstance,\n    options?: PressOptions\n  ) => Promise<void>;\n\n  /**\n   * Simulate user pressing on given `TextInput` element and typing given text.\n   *\n   * This method will trigger the events for each character of the text:\n   * `keyPress`, `change`, `changeText`, `endEditing`, etc.\n   *\n   * It will also trigger events connected with entering and leaving the text\n   * input.\n   *\n   * The exact events sent depend on the props of TextInput (`editable`,\n   * `multiline`, value, defaultValue, etc) and passed options.\n   *\n   * @param element TextInput element to type on\n   * @param text Text to type\n   * @param options Options affecting typing behavior:\n   *  - `skipPress` - if true, `pressIn` and `pressOut` events will not be\n   *   triggered.\n   * - `submitEditing` - if true, `submitEditing` event will be triggered after\n   * typing the text.\n   */\n  type: (\n    element: ReactTestInstance,\n    text: string,\n    options?: TypeOptions\n  ) => Promise<void>;\n}\n\nfunction createInstance(config: UserEventConfig): UserEventInstance {\n  const instance = {\n    config,\n  } as UserEventInstance;\n\n  // We need to bind these functions, as they access the config through 'this.config'.\n  const api = {\n    press: press.bind(instance),\n    longPress: longPress.bind(instance),\n    type: type.bind(instance),\n  };\n\n  Object.assign(instance, api);\n  return instance;\n}\n"],"mappings":";;;;;;AACA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AAwBA;AACA;AACA;AACA,SAASG,4BAA4BA,CAACC,EAAU,EAAE;EAChD,IAAI,IAAAC,gCAAwB,EAAC,CAAC,EAAE;IAC9B,OAAOC,IAAI,CAACC,mBAAmB,CAACH,EAAE,CAAC;EACrC,CAAC,MAAM;IACL,OAAOI,OAAO,CAACC,OAAO,CAAC,CAAC;EAC1B;AACF;AAEA,MAAMC,cAA+C,GAAG;EACtDC,KAAK,EAAE,CAAC;EACRC,aAAa,EAAET;AACjB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,SAASU,KAAKA,CAACC,OAA+B,EAAE;EACrD,MAAMC,MAAM,GAAGC,YAAY,CAACF,OAAO,CAAC;EACpC,MAAMG,QAAQ,GAAGC,cAAc,CAACH,MAAM,CAAC;EACvC,OAAOE,QAAQ;AACjB;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAMA,SAASD,YAAYA,CAACF,OAA+B,EAAmB;EACtE,OAAO;IACL,GAAGJ,cAAc;IACjB,GAAGI;EACL,CAAC;AACH;;AAEA;AACA;AACA;;AAqCA,SAASI,cAAcA,CAACH,MAAuB,EAAqB;EAClE,MAAME,QAAQ,GAAG;IACfF;EACF,CAAsB;;EAEtB;EACA,MAAMI,GAAG,GAAG;IACVC,KAAK,EAAEA,YAAK,CAACC,IAAI,CAACJ,QAAQ,CAAC;IAC3BK,SAAS,EAAEA,gBAAS,CAACD,IAAI,CAACJ,QAAQ,CAAC;IACnCM,IAAI,EAAEA,UAAI,CAACF,IAAI,CAACJ,QAAQ;EAC1B,CAAC;EAEDO,MAAM,CAACC,MAAM,CAACR,QAAQ,EAAEE,GAAG,CAAC;EAC5B,OAAOF,QAAQ;AACjB"}

package/build/user-event/type/index.d.ts

@@ -1 +1 @@
-export { type } from './type';
+export { type, TypeOptions } from './type';

package/build/user-event/type/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "TypeOptions", {
+  enumerable: true,
+  get: function () {
+    return _type.TypeOptions;
+  }
+});
 Object.defineProperty(exports, "type", {
   enumerable: true,
   get: function () {

package/build/user-event/type/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_type","require"],"sources":["../../../src/user-event/type/index.ts"],"sourcesContent":["export { type } from './type';\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA"}
+{"version":3,"file":"index.js","names":["_type","require"],"sources":["../../../src/user-event/type/index.ts"],"sourcesContent":["export { type, TypeOptions } from './type';\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA"}

package/build/user-event/type/parseKeys.d.ts

@@ -0,0 +1 @@
+export declare function parseKeys(text: string): string[];

package/build/user-event/type/parseKeys.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseKeys = parseKeys;
+const knownKeys = new Set(['Enter', 'Backspace']);
+function parseKeys(text) {
+  const result = [];
+  let remainingText = text;
+  while (remainingText) {
+    const [token, rest] = getNextToken(remainingText);
+    if (token.length > 1 && !knownKeys.has(token)) {
+      throw new Error(`Unknown key "${token}" in "${text}"`);
+    }
+    result.push(token);
+    remainingText = rest;
+  }
+  return result;
+}
+function getNextToken(text) {
+  // Detect `{{` => escaped `{`
+  if (text[0] === '{' && text[1] === '{') {
+    return ['{', text.slice(2)];
+  }
+
+  // Detect `{key}` => special key
+  if (text[0] === '{') {
+    const endIndex = text.indexOf('}');
+    if (endIndex === -1) {
+      throw new Error(`Invalid key sequence "${text}"`);
+    }
+    return [text.slice(1, endIndex), text.slice(endIndex + 1)];
+  }
+  if (text[0] === '\n') {
+    return ['Enter', text.slice(1)];
+  }
+  return [text[0], text.slice(1)];
+}
+//# sourceMappingURL=parseKeys.js.map

package/build/user-event/type/parseKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseKeys.js","names":["knownKeys","Set","parseKeys","text","result","remainingText","token","rest","getNextToken","length","has","Error","push","slice","endIndex","indexOf"],"sources":["../../../src/user-event/type/parseKeys.ts"],"sourcesContent":["const knownKeys = new Set(['Enter', 'Backspace']);\n\nexport function parseKeys(text: string) {\n  const result = [];\n\n  let remainingText = text;\n  while (remainingText) {\n    const [token, rest] = getNextToken(remainingText);\n    if (token.length > 1 && !knownKeys.has(token)) {\n      throw new Error(`Unknown key \"${token}\" in \"${text}\"`);\n    }\n\n    result.push(token);\n    remainingText = rest;\n  }\n\n  return result;\n}\n\nfunction getNextToken(text: string): [string, string] {\n  // Detect `{{` => escaped `{`\n  if (text[0] === '{' && text[1] === '{') {\n    return ['{', text.slice(2)];\n  }\n\n  // Detect `{key}` => special key\n  if (text[0] === '{') {\n    const endIndex = text.indexOf('}');\n    if (endIndex === -1) {\n      throw new Error(`Invalid key sequence \"${text}\"`);\n    }\n\n    return [text.slice(1, endIndex), text.slice(endIndex + 1)];\n  }\n\n  if (text[0] === '\\n') {\n    return ['Enter', text.slice(1)];\n  }\n\n  return [text[0], text.slice(1)];\n}\n"],"mappings":";;;;;;AAAA,MAAMA,SAAS,GAAG,IAAIC,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAE1C,SAASC,SAASA,CAACC,IAAY,EAAE;EACtC,MAAMC,MAAM,GAAG,EAAE;EAEjB,IAAIC,aAAa,GAAGF,IAAI;EACxB,OAAOE,aAAa,EAAE;IACpB,MAAM,CAACC,KAAK,EAAEC,IAAI,CAAC,GAAGC,YAAY,CAACH,aAAa,CAAC;IACjD,IAAIC,KAAK,CAACG,MAAM,GAAG,CAAC,IAAI,CAACT,SAAS,CAACU,GAAG,CAACJ,KAAK,CAAC,EAAE;MAC7C,MAAM,IAAIK,KAAK,CAAE,gBAAeL,KAAM,SAAQH,IAAK,GAAE,CAAC;IACxD;IAEAC,MAAM,CAACQ,IAAI,CAACN,KAAK,CAAC;IAClBD,aAAa,GAAGE,IAAI;EACtB;EAEA,OAAOH,MAAM;AACf;AAEA,SAASI,YAAYA,CAACL,IAAY,EAAoB;EACpD;EACA,IAAIA,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAIA,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;IACtC,OAAO,CAAC,GAAG,EAAEA,IAAI,CAACU,KAAK,CAAC,CAAC,CAAC,CAAC;EAC7B;;EAEA;EACA,IAAIV,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;IACnB,MAAMW,QAAQ,GAAGX,IAAI,CAACY,OAAO,CAAC,GAAG,CAAC;IAClC,IAAID,QAAQ,KAAK,CAAC,CAAC,EAAE;MACnB,MAAM,IAAIH,KAAK,CAAE,yBAAwBR,IAAK,GAAE,CAAC;IACnD;IAEA,OAAO,CAACA,IAAI,CAACU,KAAK,CAAC,CAAC,EAAEC,QAAQ,CAAC,EAAEX,IAAI,CAACU,KAAK,CAACC,QAAQ,GAAG,CAAC,CAAC,CAAC;EAC5D;EAEA,IAAIX,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;IACpB,OAAO,CAAC,OAAO,EAAEA,IAAI,CAACU,KAAK,CAAC,CAAC,CAAC,CAAC;EACjC;EAEA,OAAO,CAACV,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAACU,KAAK,CAAC,CAAC,CAAC,CAAC;AACjC"}

package/build/user-event/type/type.d.ts

@@ -1,3 +1,7 @@
 import { ReactTestInstance } from 'react-test-renderer';
 import { UserEventInstance } from '../setup';
-export declare function type(this: UserEventInstance, element: ReactTestInstance, text: string): Promise<void>;
+export interface TypeOptions {
+    skipPress?: boolean;
+    submitEditing?: boolean;
+}
+export declare function type(this: UserEventInstance, element: ReactTestInstance, text: string, options?: TypeOptions): Promise<void>;

package/build/user-event/type/type.js

@@ -4,15 +4,73 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.type = type;
-var _utils = require("../utils");
+var _hostComponentNames = require("../../helpers/host-component-names");
 var _eventBuilder = require("../event-builder");
-async function type(element, text) {
-  // TODO provide real implementation
-  await (0, _utils.wait)(this.config);
-  (0, _utils.dispatchHostEvent)(element, 'focus', _eventBuilder.EventBuilder.Common.focus());
-  await (0, _utils.wait)(this.config);
-  (0, _utils.dispatchHostEvent)(element, 'changeText', text);
+var _errors = require("../../helpers/errors");
+var _pointerEvents = require("../../helpers/pointer-events");
+var _utils = require("../utils");
+var _parseKeys = require("./parseKeys");
+async function type(element, text, options) {
+  if (!(0, _hostComponentNames.isHostTextInput)(element)) {
+    throw new _errors.ErrorWithStack(`type() works only with host "TextInput" elements. Passed element has type "${element.type}".`, type);
+  }
+
+  // Skip events if the element is disabled
+  if (element.props.editable === false || !(0, _pointerEvents.isPointerEventEnabled)(element)) {
+    return;
+  }
+  const keys = (0, _parseKeys.parseKeys)(text);
+  if (!options?.skipPress) {
+    (0, _utils.dispatchEvent)(element, 'pressIn', _eventBuilder.EventBuilder.Common.touch());
+  }
+  (0, _utils.dispatchEvent)(element, 'focus', _eventBuilder.EventBuilder.Common.focus());
+  if (!options?.skipPress) {
+    await (0, _utils.wait)(this.config);
+    (0, _utils.dispatchEvent)(element, 'pressOut', _eventBuilder.EventBuilder.Common.touch());
+  }
+  let currentText = element.props.value ?? element.props.defaultValue ?? '';
+  for (const key of keys) {
+    const previousText = element.props.value ?? currentText;
+    currentText = applyKey(previousText, key);
+    await (0, _utils.wait)(this.config);
+    emitTypingEvents(element, key, currentText, previousText);
+  }
+  const finalText = element.props.value ?? currentText;
   await (0, _utils.wait)(this.config);
-  (0, _utils.dispatchHostEvent)(element, 'blur', _eventBuilder.EventBuilder.Common.blur());
+  if (options?.submitEditing) {
+    (0, _utils.dispatchEvent)(element, 'submitEditing', _eventBuilder.EventBuilder.TextInput.submitEditing(finalText));
+  }
+  (0, _utils.dispatchEvent)(element, 'endEditing', _eventBuilder.EventBuilder.TextInput.endEditing(finalText));
+  (0, _utils.dispatchEvent)(element, 'blur', _eventBuilder.EventBuilder.Common.blur());
+}
+async function emitTypingEvents(element, key, currentText, previousText) {
+  const isMultiline = element.props.multiline === true;
+  (0, _utils.dispatchEvent)(element, 'keyPress', _eventBuilder.EventBuilder.TextInput.keyPress(key));
+
+  // According to the docs only multiline TextInput emits textInput event
+  // @see: https://github.com/facebook/react-native/blob/42a2898617da1d7a98ef574a5b9e500681c8f738/packages/react-native/Libraries/Components/TextInput/TextInput.d.ts#L754
+  if (isMultiline) {
+    (0, _utils.dispatchEvent)(element, 'textInput', _eventBuilder.EventBuilder.TextInput.textInput(currentText, previousText));
+  }
+  (0, _utils.dispatchEvent)(element, 'change', _eventBuilder.EventBuilder.TextInput.change(currentText));
+  (0, _utils.dispatchEvent)(element, 'changeText', currentText);
+  const selectionRange = (0, _utils.getTextRange)(currentText);
+  (0, _utils.dispatchEvent)(element, 'selectionChange', _eventBuilder.EventBuilder.TextInput.selectionChange(selectionRange));
+
+  // According to the docs only multiline TextInput emits contentSizeChange event
+  // @see: https://reactnative.dev/docs/textinput#oncontentsizechange
+  if (isMultiline) {
+    const contentSize = (0, _utils.getTextContentSize)(currentText);
+    (0, _utils.dispatchEvent)(element, 'contentSizeChange', _eventBuilder.EventBuilder.TextInput.contentSizeChange(contentSize));
+  }
+}
+function applyKey(text, key) {
+  if (key === 'Enter') {
+    return `${text}\n`;
+  }
+  if (key === 'Backspace') {
+    return text.slice(0, -1);
+  }
+  return text + key;
 }
 //# sourceMappingURL=type.js.map

package/build/user-event/type/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","names":["_utils","require","_eventBuilder","type","element","text","wait","config","dispatchHostEvent","EventBuilder","Common","focus","blur"],"sources":["../../../src/user-event/type/type.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport { UserEventInstance } from '../setup';\nimport { dispatchHostEvent, wait } from '../utils';\nimport { EventBuilder } from '../event-builder';\n\nexport async function type(\n  this: UserEventInstance,\n  element: ReactTestInstance,\n  text: string\n) {\n  // TODO provide real implementation\n  await wait(this.config);\n  dispatchHostEvent(element, 'focus', EventBuilder.Common.focus());\n\n  await wait(this.config);\n  dispatchHostEvent(element, 'changeText', text);\n\n  await wait(this.config);\n  dispatchHostEvent(element, 'blur', EventBuilder.Common.blur());\n}\n"],"mappings":";;;;;;AAEA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAEO,eAAeE,IAAIA,CAExBC,OAA0B,EAC1BC,IAAY,EACZ;EACA;EACA,MAAM,IAAAC,WAAI,EAAC,IAAI,CAACC,MAAM,CAAC;EACvB,IAAAC,wBAAiB,EAACJ,OAAO,EAAE,OAAO,EAAEK,0BAAY,CAACC,MAAM,CAACC,KAAK,CAAC,CAAC,CAAC;EAEhE,MAAM,IAAAL,WAAI,EAAC,IAAI,CAACC,MAAM,CAAC;EACvB,IAAAC,wBAAiB,EAACJ,OAAO,EAAE,YAAY,EAAEC,IAAI,CAAC;EAE9C,MAAM,IAAAC,WAAI,EAAC,IAAI,CAACC,MAAM,CAAC;EACvB,IAAAC,wBAAiB,EAACJ,OAAO,EAAE,MAAM,EAAEK,0BAAY,CAACC,MAAM,CAACE,IAAI,CAAC,CAAC,CAAC;AAChE"}
+{"version":3,"file":"type.js","names":["_hostComponentNames","require","_eventBuilder","_errors","_pointerEvents","_utils","_parseKeys","type","element","text","options","isHostTextInput","ErrorWithStack","props","editable","isPointerEventEnabled","keys","parseKeys","skipPress","dispatchEvent","EventBuilder","Common","touch","focus","wait","config","currentText","value","defaultValue","key","previousText","applyKey","emitTypingEvents","finalText","submitEditing","TextInput","endEditing","blur","isMultiline","multiline","keyPress","textInput","change","selectionRange","getTextRange","selectionChange","contentSize","getTextContentSize","contentSizeChange","slice"],"sources":["../../../src/user-event/type/type.ts"],"sourcesContent":["import { ReactTestInstance } from 'react-test-renderer';\nimport { isHostTextInput } from '../../helpers/host-component-names';\nimport { EventBuilder } from '../event-builder';\nimport { ErrorWithStack } from '../../helpers/errors';\nimport { isPointerEventEnabled } from '../../helpers/pointer-events';\nimport { UserEventInstance } from '../setup';\nimport {\n  dispatchEvent,\n  wait,\n  getTextRange,\n  getTextContentSize,\n} from '../utils';\n\nimport { parseKeys } from './parseKeys';\n\nexport interface TypeOptions {\n  skipPress?: boolean;\n  submitEditing?: boolean;\n}\n\nexport async function type(\n  this: UserEventInstance,\n  element: ReactTestInstance,\n  text: string,\n  options?: TypeOptions\n): Promise<void> {\n  if (!isHostTextInput(element)) {\n    throw new ErrorWithStack(\n      `type() works only with host \"TextInput\" elements. Passed element has type \"${element.type}\".`,\n      type\n    );\n  }\n\n  // Skip events if the element is disabled\n  if (element.props.editable === false || !isPointerEventEnabled(element)) {\n    return;\n  }\n\n  const keys = parseKeys(text);\n\n  if (!options?.skipPress) {\n    dispatchEvent(element, 'pressIn', EventBuilder.Common.touch());\n  }\n\n  dispatchEvent(element, 'focus', EventBuilder.Common.focus());\n\n  if (!options?.skipPress) {\n    await wait(this.config);\n    dispatchEvent(element, 'pressOut', EventBuilder.Common.touch());\n  }\n\n  let currentText = element.props.value ?? element.props.defaultValue ?? '';\n  for (const key of keys) {\n    const previousText = element.props.value ?? currentText;\n    currentText = applyKey(previousText, key);\n\n    await wait(this.config);\n    emitTypingEvents(element, key, currentText, previousText);\n  }\n\n  const finalText = element.props.value ?? currentText;\n\n  await wait(this.config);\n\n  if (options?.submitEditing) {\n    dispatchEvent(\n      element,\n      'submitEditing',\n      EventBuilder.TextInput.submitEditing(finalText)\n    );\n  }\n\n  dispatchEvent(\n    element,\n    'endEditing',\n    EventBuilder.TextInput.endEditing(finalText)\n  );\n\n  dispatchEvent(element, 'blur', EventBuilder.Common.blur());\n}\n\nasync function emitTypingEvents(\n  element: ReactTestInstance,\n  key: string,\n  currentText: string,\n  previousText: string\n) {\n  const isMultiline = element.props.multiline === true;\n\n  dispatchEvent(element, 'keyPress', EventBuilder.TextInput.keyPress(key));\n\n  // According to the docs only multiline TextInput emits textInput event\n  // @see: https://github.com/facebook/react-native/blob/42a2898617da1d7a98ef574a5b9e500681c8f738/packages/react-native/Libraries/Components/TextInput/TextInput.d.ts#L754\n  if (isMultiline) {\n    dispatchEvent(\n      element,\n      'textInput',\n      EventBuilder.TextInput.textInput(currentText, previousText)\n    );\n  }\n\n  dispatchEvent(element, 'change', EventBuilder.TextInput.change(currentText));\n\n  dispatchEvent(element, 'changeText', currentText);\n\n  const selectionRange = getTextRange(currentText);\n  dispatchEvent(\n    element,\n    'selectionChange',\n    EventBuilder.TextInput.selectionChange(selectionRange)\n  );\n\n  // According to the docs only multiline TextInput emits contentSizeChange event\n  // @see: https://reactnative.dev/docs/textinput#oncontentsizechange\n  if (isMultiline) {\n    const contentSize = getTextContentSize(currentText);\n    dispatchEvent(\n      element,\n      'contentSizeChange',\n      EventBuilder.TextInput.contentSizeChange(contentSize)\n    );\n  }\n}\n\nfunction applyKey(text: string, key: string) {\n  if (key === 'Enter') {\n    return `${text}\\n`;\n  }\n\n  if (key === 'Backspace') {\n    return text.slice(0, -1);\n  }\n\n  return text + key;\n}\n"],"mappings":"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"}

package/build/user-event/utils/content-size.d.ts

@@ -0,0 +1,15 @@
+export interface ContentSize {
+    width: number;
+    height: number;
+}
+/**
+ * Simple function for getting mock the size of given text.
+ *
+ * It works by calculating height based on number of lines and width based on
+ * the longest line length. It does not take into account font size, font
+ * family, as well as different letter sizes.
+ *
+ * @param text text to be measure
+ * @returns width and height of the text
+ */
+export declare function getTextContentSize(text: string): ContentSize;

package/build/user-event/utils/content-size.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTextContentSize = getTextContentSize;
+/**
+ * Simple function for getting mock the size of given text.
+ *
+ * It works by calculating height based on number of lines and width based on
+ * the longest line length. It does not take into account font size, font
+ * family, as well as different letter sizes.
+ *
+ * @param text text to be measure
+ * @returns width and height of the text
+ */
+
+function getTextContentSize(text) {
+  const lines = text.split('\n');
+  const maxLineLength = Math.max(...lines.map(line => line.length));
+  return {
+    width: maxLineLength * 5,
+    height: lines.length * 16
+  };
+}
+//# sourceMappingURL=content-size.js.map

package/build/user-event/utils/content-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-size.js","names":["getTextContentSize","text","lines","split","maxLineLength","Math","max","map","line","length","width","height"],"sources":["../../../src/user-event/utils/content-size.ts"],"sourcesContent":["export interface ContentSize {\n  width: number;\n  height: number;\n}\n\n/**\n * Simple function for getting mock the size of given text.\n *\n * It works by calculating height based on number of lines and width based on\n * the longest line length. It does not take into account font size, font\n * family, as well as different letter sizes.\n *\n * @param text text to be measure\n * @returns width and height of the text\n */\n\nexport function getTextContentSize(text: string): ContentSize {\n  const lines = text.split('\\n');\n  const maxLineLength = Math.max(...lines.map((line) => line.length));\n\n  return {\n    width: maxLineLength * 5,\n    height: lines.length * 16,\n  };\n}\n"],"mappings":";;;;;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,SAASA,kBAAkBA,CAACC,IAAY,EAAe;EAC5D,MAAMC,KAAK,GAAGD,IAAI,CAACE,KAAK,CAAC,IAAI,CAAC;EAC9B,MAAMC,aAAa,GAAGC,IAAI,CAACC,GAAG,CAAC,GAAGJ,KAAK,CAACK,GAAG,CAAEC,IAAI,IAAKA,IAAI,CAACC,MAAM,CAAC,CAAC;EAEnE,OAAO;IACLC,KAAK,EAAEN,aAAa,GAAG,CAAC;IACxBO,MAAM,EAAET,KAAK,CAACO,MAAM,GAAG;EACzB,CAAC;AACH"}

package/build/user-event/utils/{events.d.ts → dispatch-event.d.ts}

@@ -1,9 +1,9 @@
 import { ReactTestInstance } from 'react-test-renderer';
 /**
- * Dispatch event function used by User Event module.
+ * Basic dispatch event function used by User Event module.
  *
  * @param element element trigger event on
  * @param eventName name of the event
  * @param event event payload
  */
-export declare function dispatchHostEvent(element: ReactTestInstance, eventName: string, event: unknown): void;
+export declare function dispatchEvent(element: ReactTestInstance, eventName: string, event: unknown): void;