chore: update to test-renderer 0.12

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';

.github/ISSUE_TEMPLATE/bug_report.md

@@ -34,5 +34,5 @@ labels: 'bug report'
 <!--
  run following command in terminal of your root project and paste the result down
 
- `npx envinfo --npmPackages react,react-native,universal-test-renderer,@testing-library/react-native`
+ `npx envinfo --npmPackages react,react-native,test-renderer,@testing-library/react-native`
 -->

.yarnrc.yml

@@ -5,7 +5,7 @@ npmMinimalAgeGate: '3d'
 npmPreapprovedPackages:
  - react
  - react-native
- - universal-test-renderer
+ - test-renderer
  - '@testing-library/react-native'
  - '@react-native/*'
  - '@types/react'

AGENTS.md

@@ -8,7 +8,7 @@ This document provides context for the any code assistant to understand the `@te
 
 - **Core Principle:** "The more your tests resemble the way your software is used, the more confidence they can give you."
 - **Tech Stack:** TypeScript, React Native, Jest.
-- **Architecture:** The library simulates the React Native runtime on top of `universal-test-renderer`.
+- **Architecture:** The library simulates the React Native runtime on top of `test-renderer`.
 
 ## Project Guidelines
 

README.md

@@ -18,7 +18,7 @@ You want to write maintainable tests for your React Native components. As a part
 
 ## 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 `universal-test-renderer`, in a way that encourages better testing practices. Its primary guiding principle is:
+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 more your tests resemble the way your software is used, the more confidence they can give you.
 
@@ -36,7 +36,7 @@ yarn add --dev @testing-library/react-native
 npm install --save-dev @testing-library/react-native
 ```
 
-This library has a `peerDependencies` listing for `universal-test-renderer`. Make sure that your `universal-test-renderer` version matches exactly the `react` version, avoid using `^` in version number.
+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.
 
 ### Additional Jest matchers
 

codemods/v14-update-deps/README.md

@@ -7,7 +7,7 @@ This codemod automatically updates your `package.json` to prepare for React Nati
 - Removes `@types/react-test-renderer` and `react-test-renderer` (no longer needed)
 - Moves `@testing-library/react-native` to `devDependencies` if it's in `dependencies`
 - Updates `@testing-library/react-native` to `^14.0.0-alpha.5`
-- Adds `universal-test-renderer@0.10.1` to `devDependencies`
+- Adds `test-renderer@0.12.0` to `devDependencies`
 
 ## Usage
 
@@ -38,7 +38,7 @@ npx codemod@latest run rntl-v14-update-deps --target ./path/to/your/project
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }
 ```

codemods/v14-update-deps/scripts/codemod.ts

@@ -4,7 +4,7 @@ import type { Transform } from 'codemod:ast-grep';
 import type JSONLang from 'codemod:ast-grep/langs/json';
 
 const RNTL_VERSION = '^14.0.0-alpha.5';
-const UNIVERSAL_TEST_RENDERER_VERSION = '0.10.1';
+const TEST_RENDERER_VERSION = '0.12.0';
 
 interface PackageJson {
  dependencies?: Record<string, string>;
@@ -27,7 +27,7 @@ export default async function transform(
  const content = root.root().text();
  const packageJson: PackageJson = JSON.parse(content);
 
- if (!hasRNTLOrUTR(packageJson)) {
+ if (!hasRntlOrTestRenderer(packageJson)) {
  return null;
  }
 
@@ -41,11 +41,11 @@ export default async function transform(
  hasChanges = true;
  }
 
- if (ensureRNTLInDevDependencies(packageJson)) {
+ if (ensureRntlInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
- if (updateUTRVersionInDevDependencies(packageJson)) {
+ if (updateTestRendererVersionInDevDependencies(packageJson)) {
  hasChanges = true;
  }
 
@@ -67,18 +67,18 @@ function isPackageJsonFile(filename: string): boolean {
  return filename.endsWith('package.json');
 }
 
-function hasRNTLOrUTR(packageJson: PackageJson): boolean {
- const hasRNTL =
+function hasRntlOrTestRenderer(packageJson: PackageJson): boolean {
+ const hasRntl =
  packageJson.dependencies?.['@testing-library/react-native'] ||
  packageJson.devDependencies?.['@testing-library/react-native'] ||
  packageJson.peerDependencies?.['@testing-library/react-native'];
 
- const hasUTR =
- packageJson.dependencies?.['universal-test-renderer'] ||
- packageJson.devDependencies?.['universal-test-renderer'] ||
- packageJson.peerDependencies?.['universal-test-renderer'];
+ const hasTestRenderer =
+ packageJson.dependencies?.['test-renderer'] ||
+ packageJson.devDependencies?.['test-renderer'] ||
+ packageJson.peerDependencies?.['test-renderer'];
 
- return hasRNTL || hasUTR;
+ return hasRntl || hasTestRenderer;
 }
 
 function removePackageFromAllDependencyTypes(pkgName: string, packageJson: PackageJson): boolean {
@@ -121,7 +121,7 @@ function removeObsoletePackages(packageJson: PackageJson): boolean {
  return removedTypes || removedRenderer;
 }
 
-function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
+function ensureRntlInDevDependencies(packageJson: PackageJson): boolean {
  let hasChanges = false;
  const rntlInDeps = packageJson.dependencies?.['@testing-library/react-native'];
 
@@ -140,10 +140,10 @@ function ensureRNTLInDevDependencies(packageJson: PackageJson): boolean {
  return hasChanges;
 }
 
-function updateUTRVersionInDevDependencies(packageJson: PackageJson): boolean {
- const currentVersion = packageJson.devDependencies?.['universal-test-renderer'];
- if (currentVersion !== UNIVERSAL_TEST_RENDERER_VERSION) {
- packageJson.devDependencies!['universal-test-renderer'] = UNIVERSAL_TEST_RENDERER_VERSION;
+function updateTestRendererVersionInDevDependencies(packageJson: PackageJson): boolean {
+ const currentVersion = packageJson.devDependencies?.['test-renderer'];
+ if (currentVersion !== TEST_RENDERER_VERSION) {
+ packageJson.devDependencies!['test-renderer'] = TEST_RENDERER_VERSION;
  return true;
  }
  return false;

codemods/v14-update-deps/tests/fixtures/already-alpha/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/basic-update/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/move-from-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/rntl-in-devdeps/expected.json

@@ -1,6 +1,6 @@
 {
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

codemods/v14-update-deps/tests/fixtures/with-peer-deps/expected.json

@@ -3,6 +3,6 @@
  "version": "1.0.0",
  "devDependencies": {
  "@testing-library/react-native": "^14.0.0-alpha.5",
- "universal-test-renderer": "0.10.1"
+ "test-renderer": "0.12.0"
  }
 }

package.json

@@ -59,7 +59,7 @@
  "jest": ">=29.0.0",
  "react": ">=19.0.0",
  "react-native": ">=0.78",
- "universal-test-renderer": "~0.10.1"
+ "test-renderer": "~0.10.1"
  },
  "peerDependenciesMeta": {
  "jest": {
@@ -91,9 +91,9 @@
  "react-native": "0.83.1",
  "react-native-gesture-handler": "^2.29.1",
  "release-it": "^19.0.6",
+ "test-renderer": "0.12.0",
  "typescript": "^5.9.3",
- "typescript-eslint": "^8.47.0",
- "universal-test-renderer": "0.10.1"
+ "typescript-eslint": "^8.47.0"
  },
  "publishConfig": {
  "registry": "https://registry.npmjs.org"

src/__tests__/render.test.tsx

@@ -70,3 +70,15 @@ test('unmount function unmounts component asynchronously', async () => {
  await screen.unmount();
  expect(fn).toHaveBeenCalled();
 });
+
+test('render accepts RCTText component', async () => {
+ await render(React.createElement('RCTText', { testID: 'text' }, 'Hello'));
+ expect(screen.getByTestId('text')).toBeOnTheScreen();
+ expect(screen.getByText('Hello')).toBeOnTheScreen();
+});
+
+test('render throws when text string is rendered without Text component', async () => {
+ await expect(render(<View>Hello</View>)).rejects.toThrowErrorMatchingInlineSnapshot(
+ `"Invariant Violation: Text strings must be rendered within a <Text> component. Detected attempt to render "Hello" string within a <View> component."`,
+ );
+});

src/fire-event.ts

@@ -5,7 +5,7 @@ import type {
  TextProps,
  ViewProps,
 } from 'react-native';
-import type { Fiber, HostElement } from 'universal-test-renderer';
+import type { Fiber, HostElement } from 'test-renderer';
 
 import { act, unsafe_act } from './act';
 import type { EventHandler } from './event-handler';

src/helpers/accessibility.ts

@@ -1,6 +1,6 @@
 import type { AccessibilityRole, AccessibilityState, AccessibilityValue, Role } from 'react-native';
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement, getHostSiblings, isHostElement } from './component-tree';
 import { findAll } from './find-all';

src/helpers/component-tree.ts

@@ -1,4 +1,4 @@
-import type { HostElement, HostNode } from 'universal-test-renderer';
+import type { HostElement, HostNode } from 'test-renderer';
 
 import { screen } from '../screen';
 

src/helpers/debug.ts

@@ -1,4 +1,4 @@
-import type { JsonNode } from 'universal-test-renderer';
+import type { JsonNode } from 'test-renderer';
 
 import type { FormatElementOptions } from './format-element';
 import { formatJson } from './format-element';

src/helpers/find-all.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getConfig } from '../config';
 import { isHiddenFromAccessibility } from './accessibility';

src/helpers/format-element.ts

@@ -1,6 +1,6 @@
 import type { NewPlugin } from 'pretty-format';
 import prettyFormat, { plugins } from 'pretty-format';
-import type { HostElement, JsonNode } from 'universal-test-renderer';
+import type { HostElement, JsonNode } from 'test-renderer';
 
 import type { MapPropsFunction } from './map-props';
 import { defaultMapProps } from './map-props';

src/helpers/host-component-names.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export const HOST_TEXT_NAMES = ['Text', 'RCTText'];
 const HOST_TEXT_INPUT_NAMES = ['TextInput'];

src/helpers/matchers/match-accessibility-state.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaBusy,

src/helpers/matchers/match-accessibility-value.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch } from '../../matches';
 import { computeAriaValue } from '../accessibility';

src/helpers/matchers/match-label-text.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/matchers/match-text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import type { TextMatch, TextMatchOptions } from '../../matches';
 import { matches } from '../../matches';

src/helpers/pointer-events.ts

@@ -1,5 +1,5 @@
 import { StyleSheet } from 'react-native';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 /**
  * pointerEvents controls whether the View can be the target of touch events.

src/helpers/text-content.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 export function getTextContent(element: HostElement | string | null): string {
  if (!element) {

src/helpers/text-input.ts

@@ -1,4 +1,4 @@
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { nativeState } from '../native-state';
 import { isHostTextInput } from './host-component-names';

src/matchers/to-be-busy.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaBusy } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import {
  computeAriaChecked,

src/matchers/to-be-disabled.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaDisabled } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-empty-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHostElement } from '../helpers/component-tree';
 import { formatElementList } from '../helpers/format-element';

src/matchers/to-be-expanded.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaExpanded } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-on-the-screen.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { getContainerElement } from '../helpers/component-tree';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-partially-checked.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaChecked, getRole, isAccessibilityElement } from '../helpers/accessibility';
 import { ErrorWithStack } from '../helpers/errors';

src/matchers/to-be-selected.ts

@@ -1,6 +1,6 @@
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaSelected } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-be-visible.ts

@@ -1,7 +1,7 @@
 import { StyleSheet } from 'react-native';
 import { matcherHint } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { isHiddenFromAccessibility } from '../helpers/accessibility';
 import { formatElement } from '../helpers/format-element';

src/matchers/to-contain-element.ts

@@ -1,6 +1,6 @@
 import { matcherHint, RECEIVED_COLOR } from 'jest-matcher-utils';
 import redent from 'redent';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { formatElement } from '../helpers/format-element';
 import { checkHostElement } from './utils';

src/matchers/to-have-accessibility-value.ts

@@ -1,5 +1,5 @@
 import { matcherHint, stringify } from 'jest-matcher-utils';
-import type { HostElement } from 'universal-test-renderer';
+import type { HostElement } from 'test-renderer';
 
 import { computeAriaValue } from '../helpers/accessibility';
 import type { AccessibilityValueMatcher } from '../helpers/matchers/match-accessibility-value';