@testing-library/react-native 14.0.0-alpha.6 → 14.0.0-beta.1

package/README.md

@@ -12,13 +12,18 @@
 [![MIT License][license-badge]][license]
 [![Sponsored by Callstack][callstack-badge]][callstack]
 
+> [!WARNING]
+> **Beta Version:** This version (v14) is currently in beta. APIs and behavior may change before the stable release. Please report any issues you encounter.
+>
+> For stable version (v13) see [README-v13.md](./README-v13.md).
+
 ## The problem
 
-You want to write maintainable tests for your React Native components. As a part of this goal, you want your tests to avoid including implementation details of your components and rather focus on making your tests give you the confidence for which they are intended. As part of this, you want your tests to be maintainable in the long run so refactors of your components (changes to implementation but not functionality) don't break your tests and slow you and your team down.
+You want to write maintainable tests for your React Native components. Your tests should avoid implementation details and focus on giving you confidence. They should remain maintainable so refactors (changes to implementation but not functionality) don't break your tests and slow you and your team down.
 
 ## This solution
 
-The React Native Testing Library (RNTL) is a comprehensive solution for testing React Native components. It provides React Native runtime simulation on top of `test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+The React Native Testing Library (RNTL) tests React Native components. It simulates the React Native runtime on top of [Test Renderer](https://github.com/mdjastrzebski/test-renderer) and encourages better testing practices. Its primary guiding principle is:
 
 > The more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -29,14 +34,14 @@ This project is inspired by [React Testing Library](https://github.com/testing-l
 Open a Terminal in your project's folder and run:
 
 ```sh
-# Yarn install:
-yarn add --dev @testing-library/react-native
-
-# NPM install
-npm install --save-dev @testing-library/react-native
+npm install --save-dev @testing-library/react-native@alpha
 ```
 
-This library has a `peerDependencies` listing for `test-renderer`. Make sure that your `test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+This library has a `peerDependencies` listing for [Test Renderer](https://github.com/mdjastrzebski/test-renderer). Make sure to install it as a dev dependency:
+
+```sh
+npm install --save-dev test-renderer
+```
 
 ### Additional Jest matchers
 
@@ -48,16 +53,12 @@ You can use the built-in Jest matchers automatically by having any import from `
 import { render, screen, userEvent } from '@testing-library/react-native';
 import { QuestionsBoard } from '../QuestionsBoard';
 
-// It is recommended to use userEvent with fake timers
-// Some events involve duration so your tests may take a long time to run.
-jest.useFakeTimers();
-
 test('form submits two answers', async () => {
   const questions = ['q1', 'q2'];
   const onSubmit = jest.fn();
 
   const user = userEvent.setup();
-  render(<QuestionsBoard questions={questions} onSubmit={onSubmit} />);
+  await render(<QuestionsBoard questions={questions} onSubmit={onSubmit} />);
 
   const answerInputs = screen.getAllByLabelText('answer input');
 
@@ -81,33 +82,32 @@ You can find the source of `QuestionsBoard` component and this example [here](ht
 
 React Native Testing Library consists of following APIs:
 
-- [`render` function](https://callstack.github.io/react-native-testing-library/docs/api/render) - render your UI components for testing purposes
-- [`screen` object](https://callstack.github.io/react-native-testing-library/docs/api/screen) - access rendered UI:
-  - [Queries](https://callstack.github.io/react-native-testing-library/docs/api/queries) - find rendered components by various predicates: role, text, test ids, etc
-  - Lifecycle methods: [`rerender`](https://callstack.github.io/react-native-testing-library/docs/api/screen#rerender), [`unmount`](https://callstack.github.io/react-native-testing-library/docs/api/screen#unmount)
-  - Helpers: [`debug`](https://callstack.github.io/react-native-testing-library/docs/api/screen#debug), [`toJSON`](https://callstack.github.io/react-native-testing-library/docs/api/screen#tojson), [`root`](https://callstack.github.io/react-native-testing-library/docs/api/screen#root)
-- [Jest matchers](https://callstack.github.io/react-native-testing-library/docs/api/jest-matchers) - validate assumptions about your UI
-- [User Event](https://callstack.github.io/react-native-testing-library/docs/api/events/user-event) - simulate common user interactions like [`press`](https://callstack.github.io/react-native-testing-library/docs/api/events/user-event#press) or [`type`](https://callstack.github.io/react-native-testing-library/docs/user-event#type) in a realistic way
-- [Fire Event](https://callstack.github.io/react-native-testing-library/docs/api/events/fire-event) - simulate any component event in a simplified way
-- [`renderHook` function](https://callstack.github.io/react-native-testing-library/docs/api/misc/render-hook) - render hooks for testing purposes
+- [`render` function](https://oss.callstack.com/react-native-testing-library/docs/api/render) - render your UI components for testing purposes
+- [`screen` object](https://oss.callstack.com/react-native-testing-library/docs/api/screen) - access rendered UI:
+  - [Queries](https://oss.callstack.com/react-native-testing-library/docs/api/queries) - find rendered components by various predicates: role, text, test ids, etc
+  - Lifecycle methods: [`rerender`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#rerender), [`unmount`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#unmount)
+  - Helpers: [`debug`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#debug), [`toJSON`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#tojson), [`root`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#root), [`container`](https://oss.callstack.com/react-native-testing-library/docs/api/screen#container)
+- [Jest matchers](https://oss.callstack.com/react-native-testing-library/docs/api/jest-matchers) - validate assumptions about your UI
+- [User Event](https://oss.callstack.com/react-native-testing-library/docs/api/events/user-event) - simulate common user interactions like [`press`](https://oss.callstack.com/react-native-testing-library/docs/api/events/user-event#press) or [`type`](https://oss.callstack.com/react-native-testing-library/docs/api/events/user-event#type)
+- [Fire Event](https://oss.callstack.com/react-native-testing-library/docs/api/events/fire-event) - simulate any component event
+- [`renderHook` function](https://oss.callstack.com/react-native-testing-library/docs/api/misc/render-hook) - render hooks for testing purposes
 - Miscellaneous APIs:
-  - [Async utils](https://callstack.github.io/react-native-testing-library/docs/api/misc/async): `findBy*` queries, `waitFor`, `waitForElementToBeRemoved`
-  - [Configuration](https://callstack.github.io/react-native-testing-library/docs/api/misc/config): `configure`, `resetToDefaults`
-  - [Accessibility](https://callstack.github.io/react-native-testing-library/docs/api/misc/accessibility): `isHiddenFromAccessibility`
-  - [Other](https://callstack.github.io/react-native-testing-library/docs/api/misc/other): `within`, `act`, `cleanup`
+  - [Async utils](https://oss.callstack.com/react-native-testing-library/docs/api/misc/async): `findBy*` queries, `waitFor`, `waitForElementToBeRemoved`
+  - [Configuration](https://oss.callstack.com/react-native-testing-library/docs/api/misc/config): `configure`, `resetToDefaults`
+  - [Accessibility](https://oss.callstack.com/react-native-testing-library/docs/api/misc/accessibility): `isHiddenFromAccessibility`
+  - [Other](https://oss.callstack.com/react-native-testing-library/docs/api/misc/other): `within`, `act`, `cleanup`
 
 ## Migration Guides
 
-- [Migration to 13.0](https://callstack.github.io/react-native-testing-library/docs/migration/v13)
-- [Migration to built-in Jest Matchers](https://callstack.github.io/react-native-testing-library/docs/migration/jest-matchers)
+- **[Migration to 14.0](https://oss.callstack.com/react-native-testing-library/docs/migration/v14)** - Drops React 18, async APIs by default
 
 ## Troubleshooting
 
-- [Troubleshooting guide](https://callstack.github.io/react-native-testing-library/docs/guides/troubleshooting)
+- [Troubleshooting guide](https://oss.callstack.com/react-native-testing-library/docs/guides/troubleshooting)
 
 ## Community Resources
 
-Check out our list of [Community Resources about RNTL](https://callstack.github.io/react-native-testing-library/docs/guides/community-resources).
+Check out our list of [Community Resources about RNTL](https://oss.callstack.com/react-native-testing-library/docs/guides/community-resources).
 
 ## Made with ❤️ at Callstack
 

package/build/config.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.configure = configure;
 exports.getConfig = getConfig;
 exports.resetToDefaults = resetToDefaults;
+var _validateOptions = require("./helpers/validate-options");
 /**
  * Global configuration options for React Native Testing Library.
  */
@@ -23,14 +24,19 @@ let config = {
  */
 function configure(options) {
   const {
+    asyncUtilTimeout,
+    defaultDebugOptions,
     defaultHidden,
-    ...restOptions
+    defaultIncludeHiddenElements,
+    ...rest
   } = options;
-  const defaultIncludeHiddenElements = restOptions.defaultIncludeHiddenElements ?? defaultHidden ?? config.defaultIncludeHiddenElements;
+  (0, _validateOptions.validateOptions)('configure', rest, configure);
+  const resolvedDefaultIncludeHiddenElements = defaultIncludeHiddenElements ?? defaultHidden ?? config.defaultIncludeHiddenElements;
   config = {
     ...config,
-    ...restOptions,
-    defaultIncludeHiddenElements
+    asyncUtilTimeout: asyncUtilTimeout ?? config.asyncUtilTimeout,
+    defaultDebugOptions,
+    defaultIncludeHiddenElements: resolvedDefaultIncludeHiddenElements
   };
 }
 function resetToDefaults() {

package/build/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["defaultConfig","asyncUtilTimeout","defaultIncludeHiddenElements","config","configure","options","defaultHidden","restOptions","resetToDefaults","getConfig"],"sources":["../src/config.ts"],"sourcesContent":["import type { DebugOptions } from './helpers/debug';\n\n/**\n * Global configuration options for React Native Testing Library.\n */\n\nexport type Config = {\n  /** Default timeout, in ms, for `waitFor` and `findBy*` queries. */\n  asyncUtilTimeout: number;\n\n  /** Default value for `includeHiddenElements` query option. */\n  defaultIncludeHiddenElements: boolean;\n\n  /** Default options for `debug` helper. */\n  defaultDebugOptions?: Partial<DebugOptions>;\n};\n\nexport type ConfigAliasOptions = {\n  /** RTL-compatibility alias to `defaultIncludeHiddenElements` */\n  defaultHidden: boolean;\n};\n\nconst defaultConfig: Config = {\n  asyncUtilTimeout: 1000,\n  defaultIncludeHiddenElements: false,\n};\n\nlet config = { ...defaultConfig };\n\n/**\n * Configure global options for React Native Testing Library.\n */\nexport function configure(options: Partial<Config & ConfigAliasOptions>) {\n  const { defaultHidden, ...restOptions } = options;\n\n  const defaultIncludeHiddenElements =\n    restOptions.defaultIncludeHiddenElements ??\n    defaultHidden ??\n    config.defaultIncludeHiddenElements;\n\n  config = {\n    ...config,\n    ...restOptions,\n    defaultIncludeHiddenElements,\n  };\n}\n\nexport function resetToDefaults() {\n  config = { ...defaultConfig };\n}\n\nexport function getConfig() {\n  return config;\n}\n"],"mappings":";;;;;;;;AAEA;AACA;AACA;;AAkBA,MAAMA,aAAqB,GAAG;EAC5BC,gBAAgB,EAAE,IAAI;EACtBC,4BAA4B,EAAE;AAChC,CAAC;AAED,IAAIC,MAAM,GAAG;EAAE,GAAGH;AAAc,CAAC;;AAEjC;AACA;AACA;AACO,SAASI,SAASA,CAACC,OAA6C,EAAE;EACvE,MAAM;IAAEC,aAAa;IAAE,GAAGC;EAAY,CAAC,GAAGF,OAAO;EAEjD,MAAMH,4BAA4B,GAChCK,WAAW,CAACL,4BAA4B,IACxCI,aAAa,IACbH,MAAM,CAACD,4BAA4B;EAErCC,MAAM,GAAG;IACP,GAAGA,MAAM;IACT,GAAGI,WAAW;IACdL;EACF,CAAC;AACH;AAEO,SAASM,eAAeA,CAAA,EAAG;EAChCL,MAAM,GAAG;IAAE,GAAGH;EAAc,CAAC;AAC/B;AAEO,SAASS,SAASA,CAAA,EAAG;EAC1B,OAAON,MAAM;AACf","ignoreList":[]}
+{"version":3,"file":"config.js","names":["_validateOptions","require","defaultConfig","asyncUtilTimeout","defaultIncludeHiddenElements","config","configure","options","defaultDebugOptions","defaultHidden","rest","validateOptions","resolvedDefaultIncludeHiddenElements","resetToDefaults","getConfig"],"sources":["../src/config.ts"],"sourcesContent":["import type { DebugOptions } from './helpers/debug';\nimport { validateOptions } from './helpers/validate-options';\n\n/**\n * Global configuration options for React Native Testing Library.\n */\n\nexport type Config = {\n  /** Default timeout, in ms, for `waitFor` and `findBy*` queries. */\n  asyncUtilTimeout: number;\n\n  /** Default value for `includeHiddenElements` query option. */\n  defaultIncludeHiddenElements: boolean;\n\n  /** Default options for `debug` helper. */\n  defaultDebugOptions?: Partial<DebugOptions>;\n};\n\nexport type ConfigAliasOptions = {\n  /** RTL-compatibility alias to `defaultIncludeHiddenElements` */\n  defaultHidden: boolean;\n};\n\nconst defaultConfig: Config = {\n  asyncUtilTimeout: 1000,\n  defaultIncludeHiddenElements: false,\n};\n\nlet config = { ...defaultConfig };\n\n/**\n * Configure global options for React Native Testing Library.\n */\nexport function configure(options: Partial<Config & ConfigAliasOptions>) {\n  const {\n    asyncUtilTimeout,\n    defaultDebugOptions,\n    defaultHidden,\n    defaultIncludeHiddenElements,\n    ...rest\n  } = options;\n\n  validateOptions('configure', rest, configure);\n\n  const resolvedDefaultIncludeHiddenElements =\n    defaultIncludeHiddenElements ?? defaultHidden ?? config.defaultIncludeHiddenElements;\n\n  config = {\n    ...config,\n    asyncUtilTimeout: asyncUtilTimeout ?? config.asyncUtilTimeout,\n    defaultDebugOptions,\n    defaultIncludeHiddenElements: resolvedDefaultIncludeHiddenElements,\n  };\n}\n\nexport function resetToDefaults() {\n  config = { ...defaultConfig };\n}\n\nexport function getConfig() {\n  return config;\n}\n"],"mappings":";;;;;;;;AACA,IAAAA,gBAAA,GAAAC,OAAA;AAEA;AACA;AACA;;AAkBA,MAAMC,aAAqB,GAAG;EAC5BC,gBAAgB,EAAE,IAAI;EACtBC,4BAA4B,EAAE;AAChC,CAAC;AAED,IAAIC,MAAM,GAAG;EAAE,GAAGH;AAAc,CAAC;;AAEjC;AACA;AACA;AACO,SAASI,SAASA,CAACC,OAA6C,EAAE;EACvE,MAAM;IACJJ,gBAAgB;IAChBK,mBAAmB;IACnBC,aAAa;IACbL,4BAA4B;IAC5B,GAAGM;EACL,CAAC,GAAGH,OAAO;EAEX,IAAAI,gCAAe,EAAC,WAAW,EAAED,IAAI,EAAEJ,SAAS,CAAC;EAE7C,MAAMM,oCAAoC,GACxCR,4BAA4B,IAAIK,aAAa,IAAIJ,MAAM,CAACD,4BAA4B;EAEtFC,MAAM,GAAG;IACP,GAAGA,MAAM;IACTF,gBAAgB,EAAEA,gBAAgB,IAAIE,MAAM,CAACF,gBAAgB;IAC7DK,mBAAmB;IACnBJ,4BAA4B,EAAEQ;EAChC,CAAC;AACH;AAEO,SAASC,eAAeA,CAAA,EAAG;EAChCR,MAAM,GAAG;IAAE,GAAGH;EAAc,CAAC;AAC/B;AAEO,SAASY,SAASA,CAAA,EAAG;EAC1B,OAAOT,MAAM;AACf","ignoreList":[]}

package/build/event-builder/base.d.ts

@@ -0,0 +1,7 @@
+import type { BaseSyntheticEvent } from 'react';
+/** Builds base syntentic event stub, with prop values as inspected in RN runtime. */
+type BaseEvent = Partial<BaseSyntheticEvent<object, unknown, unknown>> & {
+    isPersistent: () => boolean;
+};
+export declare function baseSyntheticEvent(): BaseEvent;
+export {};

package/build/{user-event/event-builder → event-builder}/base.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.baseSyntheticEvent = baseSyntheticEvent;
 /** Builds base syntentic event stub, with prop values as inspected in RN runtime. */
+
 function baseSyntheticEvent() {
   return {
     currentTarget: {},
@@ -14,7 +15,6 @@ function baseSyntheticEvent() {
     stopPropagation: () => {},
     isPropagationStopped: () => false,
     persist: () => {},
-    // @ts-expect-error: `isPersistent` is not a standard prop, but it's used in RN runtime. See: https://react.dev/reference/react-dom/components/common#react-event-object-methods
     isPersistent: () => false,
     timeStamp: 0
   };

package/build/event-builder/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":["baseSyntheticEvent","currentTarget","target","preventDefault","isDefaultPrevented","stopPropagation","isPropagationStopped","persist","isPersistent","timeStamp"],"sources":["../../src/event-builder/base.ts"],"sourcesContent":["import type { BaseSyntheticEvent } from 'react';\n\n/** Builds base syntentic event stub, with prop values as inspected in RN runtime. */\ntype BaseEvent = Partial<BaseSyntheticEvent<object, unknown, unknown>> & {\n  // `isPersistent` is not a standard prop, but it's used in RN runtime. See: https://react.dev/reference/react-dom/components/common#react-event-object-methods\n  isPersistent: () => boolean;\n};\n\nexport function baseSyntheticEvent(): BaseEvent {\n  return {\n    currentTarget: {},\n    target: {},\n    preventDefault: () => {},\n    isDefaultPrevented: () => false,\n    stopPropagation: () => {},\n    isPropagationStopped: () => false,\n    persist: () => {},\n    isPersistent: () => false,\n    timeStamp: 0,\n  };\n}\n"],"mappings":";;;;;;AAEA;;AAMO,SAASA,kBAAkBA,CAAA,EAAc;EAC9C,OAAO;IACLC,aAAa,EAAE,CAAC,CAAC;IACjBC,MAAM,EAAE,CAAC,CAAC;IACVC,cAAc,EAAEA,CAAA,KAAM,CAAC,CAAC;IACxBC,kBAAkB,EAAEA,CAAA,KAAM,KAAK;IAC/BC,eAAe,EAAEA,CAAA,KAAM,CAAC,CAAC;IACzBC,oBAAoB,EAAEA,CAAA,KAAM,KAAK;IACjCC,OAAO,EAAEA,CAAA,KAAM,CAAC,CAAC;IACjBC,YAAY,EAAEA,CAAA,KAAM,KAAK;IACzBC,SAAS,EAAE;EACb,CAAC;AACH","ignoreList":[]}

package/build/event-builder/common.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Experimental values:
+ * - iOS: `{"changedTouches": [[Circular]], "identifier": 1, "locationX": 253, "locationY": 30.333328247070312, "pageX": 273, "pageY": 141.3333282470703, "target": 75, "timestamp": 875928682.0450834, "touches": [[Circular]]}`
+ * - Android: `{"changedTouches": [[Circular]], "identifier": 0, "locationX": 160, "locationY": 40.3636360168457, "pageX": 180, "pageY": 140.36363220214844, "target": 53, "targetSurface": -1, "timestamp": 10290805, "touches": [[Circular]]}`
+ */
+export declare function buildTouchEvent(): {
+    nativeEvent: {
+        changedTouches: unknown[];
+        identifier: number;
+        locationX: number;
+        locationY: number;
+        pageX: number;
+        pageY: number;
+        target: number;
+        timestamp: number;
+        touches: unknown[];
+    };
+    currentTarget: {
+        measure: () => void;
+    };
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};
+export type TouchEvent = ReturnType<typeof buildTouchEvent>;
+export declare function buildResponderGrantEvent(): {
+    dispatchConfig: {
+        registrationName: string;
+    };
+    nativeEvent: {
+        changedTouches: unknown[];
+        identifier: number;
+        locationX: number;
+        locationY: number;
+        pageX: number;
+        pageY: number;
+        target: number;
+        timestamp: number;
+        touches: unknown[];
+    };
+    currentTarget: {
+        measure: () => void;
+    };
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};
+export declare function buildResponderReleaseEvent(): {
+    dispatchConfig: {
+        registrationName: string;
+    };
+    nativeEvent: {
+        changedTouches: unknown[];
+        identifier: number;
+        locationX: number;
+        locationY: number;
+        pageX: number;
+        pageY: number;
+        target: number;
+        timestamp: number;
+        touches: unknown[];
+    };
+    currentTarget: {
+        measure: () => void;
+    };
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};
+/**
+ * Experimental values:
+ * - iOS: `{"eventCount": 0, "target": 75, "text": ""}`
+ * - Android: `{"target": 53}`
+ */
+export declare function buildFocusEvent(): {
+    nativeEvent: {
+        target: number;
+    };
+    currentTarget?: unknown;
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};
+/**
+ * Experimental values:
+ * - iOS: `{"eventCount": 0, "target": 75, "text": ""}`
+ * - Android: `{"target": 53}`
+ */
+export declare function buildBlurEvent(): {
+    nativeEvent: {
+        target: number;
+    };
+    currentTarget?: unknown;
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};

package/build/event-builder/common.js

@@ -0,0 +1,80 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildBlurEvent = buildBlurEvent;
+exports.buildFocusEvent = buildFocusEvent;
+exports.buildResponderGrantEvent = buildResponderGrantEvent;
+exports.buildResponderReleaseEvent = buildResponderReleaseEvent;
+exports.buildTouchEvent = buildTouchEvent;
+var _base = require("./base");
+/**
+ * Experimental values:
+ * - iOS: `{"changedTouches": [[Circular]], "identifier": 1, "locationX": 253, "locationY": 30.333328247070312, "pageX": 273, "pageY": 141.3333282470703, "target": 75, "timestamp": 875928682.0450834, "touches": [[Circular]]}`
+ * - Android: `{"changedTouches": [[Circular]], "identifier": 0, "locationX": 160, "locationY": 40.3636360168457, "pageX": 180, "pageY": 140.36363220214844, "target": 53, "targetSurface": -1, "timestamp": 10290805, "touches": [[Circular]]}`
+ */
+function buildTouchEvent() {
+  return {
+    ...(0, _base.baseSyntheticEvent)(),
+    nativeEvent: {
+      changedTouches: [],
+      identifier: 0,
+      locationX: 0,
+      locationY: 0,
+      pageX: 0,
+      pageY: 0,
+      target: 0,
+      timestamp: Date.now(),
+      touches: []
+    },
+    currentTarget: {
+      measure: () => {}
+    }
+  };
+}
+function buildResponderGrantEvent() {
+  return {
+    ...buildTouchEvent(),
+    dispatchConfig: {
+      registrationName: 'onResponderGrant'
+    }
+  };
+}
+function buildResponderReleaseEvent() {
+  return {
+    ...buildTouchEvent(),
+    dispatchConfig: {
+      registrationName: 'onResponderRelease'
+    }
+  };
+}
+
+/**
+ * Experimental values:
+ * - iOS: `{"eventCount": 0, "target": 75, "text": ""}`
+ * - Android: `{"target": 53}`
+ */
+function buildFocusEvent() {
+  return {
+    ...(0, _base.baseSyntheticEvent)(),
+    nativeEvent: {
+      target: 0
+    }
+  };
+}
+
+/**
+ * Experimental values:
+ * - iOS: `{"eventCount": 0, "target": 75, "text": ""}`
+ * - Android: `{"target": 53}`
+ */
+function buildBlurEvent() {
+  return {
+    ...(0, _base.baseSyntheticEvent)(),
+    nativeEvent: {
+      target: 0
+    }
+  };
+}
+//# sourceMappingURL=common.js.map

package/build/event-builder/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":["_base","require","buildTouchEvent","baseSyntheticEvent","nativeEvent","changedTouches","identifier","locationX","locationY","pageX","pageY","target","timestamp","Date","now","touches","currentTarget","measure","buildResponderGrantEvent","dispatchConfig","registrationName","buildResponderReleaseEvent","buildFocusEvent","buildBlurEvent"],"sources":["../../src/event-builder/common.ts"],"sourcesContent":["import { baseSyntheticEvent } from './base';\n\n/**\n * Experimental values:\n * - iOS: `{\"changedTouches\": [[Circular]], \"identifier\": 1, \"locationX\": 253, \"locationY\": 30.333328247070312, \"pageX\": 273, \"pageY\": 141.3333282470703, \"target\": 75, \"timestamp\": 875928682.0450834, \"touches\": [[Circular]]}`\n * - Android: `{\"changedTouches\": [[Circular]], \"identifier\": 0, \"locationX\": 160, \"locationY\": 40.3636360168457, \"pageX\": 180, \"pageY\": 140.36363220214844, \"target\": 53, \"targetSurface\": -1, \"timestamp\": 10290805, \"touches\": [[Circular]]}`\n */\nexport function buildTouchEvent() {\n  return {\n    ...baseSyntheticEvent(),\n    nativeEvent: {\n      changedTouches: [] as unknown[],\n      identifier: 0,\n      locationX: 0,\n      locationY: 0,\n      pageX: 0,\n      pageY: 0,\n      target: 0,\n      timestamp: Date.now(),\n      touches: [] as unknown[],\n    },\n    currentTarget: { measure: () => {} },\n  };\n}\n\nexport type TouchEvent = ReturnType<typeof buildTouchEvent>;\n\nexport function buildResponderGrantEvent() {\n  return {\n    ...buildTouchEvent(),\n    dispatchConfig: { registrationName: 'onResponderGrant' },\n  };\n}\n\nexport function buildResponderReleaseEvent() {\n  return {\n    ...buildTouchEvent(),\n    dispatchConfig: { registrationName: 'onResponderRelease' },\n  };\n}\n\n/**\n * Experimental values:\n * - iOS: `{\"eventCount\": 0, \"target\": 75, \"text\": \"\"}`\n * - Android: `{\"target\": 53}`\n */\nexport function buildFocusEvent() {\n  return {\n    ...baseSyntheticEvent(),\n    nativeEvent: {\n      target: 0,\n    },\n  };\n}\n\n/**\n * Experimental values:\n * - iOS: `{\"eventCount\": 0, \"target\": 75, \"text\": \"\"}`\n * - Android: `{\"target\": 53}`\n */\nexport function buildBlurEvent() {\n  return {\n    ...baseSyntheticEvent(),\n    nativeEvent: {\n      target: 0,\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAAA,EAAG;EAChC,OAAO;IACL,GAAG,IAAAC,wBAAkB,EAAC,CAAC;IACvBC,WAAW,EAAE;MACXC,cAAc,EAAE,EAAe;MAC/BC,UAAU,EAAE,CAAC;MACbC,SAAS,EAAE,CAAC;MACZC,SAAS,EAAE,CAAC;MACZC,KAAK,EAAE,CAAC;MACRC,KAAK,EAAE,CAAC;MACRC,MAAM,EAAE,CAAC;MACTC,SAAS,EAAEC,IAAI,CAACC,GAAG,CAAC,CAAC;MACrBC,OAAO,EAAE;IACX,CAAC;IACDC,aAAa,EAAE;MAAEC,OAAO,EAAEA,CAAA,KAAM,CAAC;IAAE;EACrC,CAAC;AACH;AAIO,SAASC,wBAAwBA,CAAA,EAAG;EACzC,OAAO;IACL,GAAGhB,eAAe,CAAC,CAAC;IACpBiB,cAAc,EAAE;MAAEC,gBAAgB,EAAE;IAAmB;EACzD,CAAC;AACH;AAEO,SAASC,0BAA0BA,CAAA,EAAG;EAC3C,OAAO;IACL,GAAGnB,eAAe,CAAC,CAAC;IACpBiB,cAAc,EAAE;MAAEC,gBAAgB,EAAE;IAAqB;EAC3D,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASE,eAAeA,CAAA,EAAG;EAChC,OAAO;IACL,GAAG,IAAAnB,wBAAkB,EAAC,CAAC;IACvBC,WAAW,EAAE;MACXO,MAAM,EAAE;IACV;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASY,cAAcA,CAAA,EAAG;EAC/B,OAAO;IACL,GAAG,IAAApB,wBAAkB,EAAC,CAAC;IACvBC,WAAW,EAAE;MACXO,MAAM,EAAE;IACV;EACF,CAAC;AACH","ignoreList":[]}

package/build/event-builder/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common';
+export * from './scroll';
+export * from './text';

package/build/event-builder/index.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _common = require("./common");
+Object.keys(_common).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _common[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _common[key];
+    }
+  });
+});
+var _scroll = require("./scroll");
+Object.keys(_scroll).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _scroll[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _scroll[key];
+    }
+  });
+});
+var _text = require("./text");
+Object.keys(_text).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _text[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _text[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/build/event-builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_common","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_scroll","_text"],"sources":["../../src/event-builder/index.ts"],"sourcesContent":["export * from './common';\nexport * from './scroll';\nexport * from './text';\n"],"mappings":";;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,OAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,OAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,OAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,OAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,OAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,OAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,OAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,KAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,KAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,KAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,KAAA,CAAAN,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/build/event-builder/scroll.d.ts

@@ -0,0 +1,56 @@
+import type { Point, Size } from '../types';
+/**
+ * Other options for constructing a scroll event.
+ */
+export type ScrollEventOptions = {
+    contentSize?: Size;
+    layoutMeasurement?: Size;
+};
+/**
+ * Experimental values:
+ * - iOS: `{"contentInset": {"bottom": 0, "left": 0, "right": 0, "top": 0}, "contentOffset": {"x": 0, "y": 5.333333333333333}, "contentSize": {"height": 1676.6666259765625, "width": 390}, "layoutMeasurement": {"height": 753, "width": 390}, "zoomScale": 1}`
+ * - Android: `{"contentInset": {"bottom": 0, "left": 0, "right": 0, "top": 0}, "contentOffset": {"x": 0, "y": 31.619047164916992}, "contentSize": {"height": 1624.761962890625, "width": 411.4285583496094}, "layoutMeasurement": {"height": 785.5238037109375, "width": 411.4285583496094}, "responderIgnoreScroll": true, "target": 139, "velocity": {"x": -1.3633992671966553, "y": -1.3633992671966553}}`
+ */
+export declare function buildScrollEvent(offset?: Point, options?: ScrollEventOptions): {
+    nativeEvent: {
+        contentInset: {
+            bottom: number;
+            left: number;
+            right: number;
+            top: number;
+        };
+        contentOffset: {
+            y: number;
+            x: number;
+        };
+        contentSize: {
+            height: number;
+            width: number;
+        };
+        layoutMeasurement: {
+            height: number;
+            width: number;
+        };
+        responderIgnoreScroll: boolean;
+        target: number;
+        velocity: {
+            y: number;
+            x: number;
+        };
+    };
+    currentTarget?: unknown;
+    target?: unknown;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    preventDefault?: (() => void) | undefined;
+    isDefaultPrevented?: (() => boolean) | undefined;
+    stopPropagation?: (() => void) | undefined;
+    isPropagationStopped?: (() => boolean) | undefined;
+    persist?: (() => void) | undefined;
+    timeStamp?: number | undefined;
+    type?: string | undefined;
+    isPersistent: () => boolean;
+};

package/build/event-builder/scroll.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildScrollEvent = buildScrollEvent;
+var _base = require("./base");
+/**
+ * Other options for constructing a scroll event.
+ */
+
+/**
+ * Experimental values:
+ * - iOS: `{"contentInset": {"bottom": 0, "left": 0, "right": 0, "top": 0}, "contentOffset": {"x": 0, "y": 5.333333333333333}, "contentSize": {"height": 1676.6666259765625, "width": 390}, "layoutMeasurement": {"height": 753, "width": 390}, "zoomScale": 1}`
+ * - Android: `{"contentInset": {"bottom": 0, "left": 0, "right": 0, "top": 0}, "contentOffset": {"x": 0, "y": 31.619047164916992}, "contentSize": {"height": 1624.761962890625, "width": 411.4285583496094}, "layoutMeasurement": {"height": 785.5238037109375, "width": 411.4285583496094}, "responderIgnoreScroll": true, "target": 139, "velocity": {"x": -1.3633992671966553, "y": -1.3633992671966553}}`
+ */
+function buildScrollEvent(offset = {
+  y: 0,
+  x: 0
+}, options) {
+  return {
+    ...(0, _base.baseSyntheticEvent)(),
+    nativeEvent: {
+      contentInset: {
+        bottom: 0,
+        left: 0,
+        right: 0,
+        top: 0
+      },
+      contentOffset: {
+        y: offset.y,
+        x: offset.x
+      },
+      contentSize: {
+        height: options?.contentSize?.height ?? 0,
+        width: options?.contentSize?.width ?? 0
+      },
+      layoutMeasurement: {
+        height: options?.layoutMeasurement?.height ?? 0,
+        width: options?.layoutMeasurement?.width ?? 0
+      },
+      responderIgnoreScroll: true,
+      target: 0,
+      velocity: {
+        y: 0,
+        x: 0
+      }
+    }
+  };
+}
+//# sourceMappingURL=scroll.js.map

package/build/event-builder/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","names":["_base","require","buildScrollEvent","offset","y","x","options","baseSyntheticEvent","nativeEvent","contentInset","bottom","left","right","top","contentOffset","contentSize","height","width","layoutMeasurement","responderIgnoreScroll","target","velocity"],"sources":["../../src/event-builder/scroll.ts"],"sourcesContent":["import type { Point, Size } from '../types';\nimport { baseSyntheticEvent } from './base';\n\n/**\n * Other options for constructing a scroll event.\n */\nexport type ScrollEventOptions = {\n  contentSize?: Size;\n  layoutMeasurement?: Size;\n};\n\n/**\n * Experimental values:\n * - iOS: `{\"contentInset\": {\"bottom\": 0, \"left\": 0, \"right\": 0, \"top\": 0}, \"contentOffset\": {\"x\": 0, \"y\": 5.333333333333333}, \"contentSize\": {\"height\": 1676.6666259765625, \"width\": 390}, \"layoutMeasurement\": {\"height\": 753, \"width\": 390}, \"zoomScale\": 1}`\n * - Android: `{\"contentInset\": {\"bottom\": 0, \"left\": 0, \"right\": 0, \"top\": 0}, \"contentOffset\": {\"x\": 0, \"y\": 31.619047164916992}, \"contentSize\": {\"height\": 1624.761962890625, \"width\": 411.4285583496094}, \"layoutMeasurement\": {\"height\": 785.5238037109375, \"width\": 411.4285583496094}, \"responderIgnoreScroll\": true, \"target\": 139, \"velocity\": {\"x\": -1.3633992671966553, \"y\": -1.3633992671966553}}`\n */\nexport function buildScrollEvent(offset: Point = { y: 0, x: 0 }, options?: ScrollEventOptions) {\n  return {\n    ...baseSyntheticEvent(),\n    nativeEvent: {\n      contentInset: { bottom: 0, left: 0, right: 0, top: 0 },\n      contentOffset: { y: offset.y, x: offset.x },\n      contentSize: {\n        height: options?.contentSize?.height ?? 0,\n        width: options?.contentSize?.width ?? 0,\n      },\n      layoutMeasurement: {\n        height: options?.layoutMeasurement?.height ?? 0,\n        width: options?.layoutMeasurement?.width ?? 0,\n      },\n      responderIgnoreScroll: true,\n      target: 0,\n      velocity: { y: 0, x: 0 },\n    },\n  };\n}\n"],"mappings":";;;;;;AACA,IAAAA,KAAA,GAAAC,OAAA;AAEA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,MAAa,GAAG;EAAEC,CAAC,EAAE,CAAC;EAAEC,CAAC,EAAE;AAAE,CAAC,EAAEC,OAA4B,EAAE;EAC7F,OAAO;IACL,GAAG,IAAAC,wBAAkB,EAAC,CAAC;IACvBC,WAAW,EAAE;MACXC,YAAY,EAAE;QAAEC,MAAM,EAAE,CAAC;QAAEC,IAAI,EAAE,CAAC;QAAEC,KAAK,EAAE,CAAC;QAAEC,GAAG,EAAE;MAAE,CAAC;MACtDC,aAAa,EAAE;QAAEV,CAAC,EAAED,MAAM,CAACC,CAAC;QAAEC,CAAC,EAAEF,MAAM,CAACE;MAAE,CAAC;MAC3CU,WAAW,EAAE;QACXC,MAAM,EAAEV,OAAO,EAAES,WAAW,EAAEC,MAAM,IAAI,CAAC;QACzCC,KAAK,EAAEX,OAAO,EAAES,WAAW,EAAEE,KAAK,IAAI;MACxC,CAAC;MACDC,iBAAiB,EAAE;QACjBF,MAAM,EAAEV,OAAO,EAAEY,iBAAiB,EAAEF,MAAM,IAAI,CAAC;QAC/CC,KAAK,EAAEX,OAAO,EAAEY,iBAAiB,EAAED,KAAK,IAAI;MAC9C,CAAC;MACDE,qBAAqB,EAAE,IAAI;MAC3BC,MAAM,EAAE,CAAC;MACTC,QAAQ,EAAE;QAAEjB,CAAC,EAAE,CAAC;QAAEC,CAAC,EAAE;MAAE;IACzB;EACF,CAAC;AACH","ignoreList":[]}