fix(react-native): stop false-positives on Expo Universal UI (@expo/ui)

[aidenybai]

Problem

On Expo SDK 56 with Universal UI (@expo/ui), rn-no-raw-text reports a wall of false positives — e.g. "Raw text outside a Text component" ×69 — for valid code:

import { Host, List, ListItem } from "@expo/ui";

<List>
  <ListItem onPress={() => {}}>Settings</ListItem>
</List>

@expo/ui is a native UI layer (it delegates to SwiftUI / Jetpack Compose), not React Native's core primitives, so several RN-core assumptions don't hold for its components.

Investigation — which @expo/ui components / rules are actually affected

I audited the full Universal UI component set against the React Native rules:

@expo/ui component	Renders raw text?	Notes
ListItem (+ Leading/Supporting/Trailing slots)	Yes	Headline auto-wraps strings in native text → rn-no-raw-text false positive
Button	No	Uses a label prop; children doc says "Only nested elements are supported, not plain strings"
Collapsible	No	Header text is the label prop; content is always <Text>-wrapped
Text	n/a	Already covered by the name heuristic
Column / Row / Spacer	No	Layout primitives — Expo's own docs wrap their text in <Text>
ScrollView	n/a	Native scroll container — collides with rn-no-scrollview-mapped-list

Rule audit: most RN rules are already safe because they're import-gated to react-native (rn-no-image-children, rn-prefer-expo-image, rn-no-deprecated-modules), package-gated (rn-bottom-sheet-prefer-native), or prop-shape/behavior-gated (rn-scrollview-flex-in-content-container, rn-scrollview-dynamic-padding, rn-no-scroll-state). The two genuinely affected rules are name-only gated.

Fixes

Both fixes share a new reusable helper, isExpoUiComponentElement, that resolves whether a JSX element is a given @expo/ui export — covering named, renamed, slot-member (<ListItem.Supporting>), and namespace (<ExpoUI.ListItem>) imports across the @expo/ui root and the @expo/ui/swift-ui / @expo/ui/jetpack-compose subpaths. Gating on the import (not the name) means same-named components from other libraries — or with no import — still report. The helper takes the target componentName so rn-no-raw-text suppresses only ListItem (raw text in Column/Row still fires).

1. rn-no-raw-text now treats <ListItem> and its compound slot markers as text-handling.
2. rn-no-scrollview-mapped-list no longer flags mapped children inside an @expo/ui <ScrollView> — RN's virtualized lists can't compose inside the native <Host> tree, and @expo/ui ships its own virtualized <List>, so the FlashList/FlatList advice was actively wrong there.

The ESLint mirror (eslint-plugin-react-doctor) re-exports the oxlint rules directly, so both fixes propagate there automatically.

Changes

• constants/react-native.ts: add EXPO_UI_MODULE_SOURCES (the root + two platform subpaths).
• rules/react-native/utils/is-expo-ui-component-element.ts: new reusable helper (built on existing flattenJsxName + import-source utilities).
• rules/react-native/rn-no-raw-text.ts & rn-no-scrollview-mapped-list.ts: one early-return each via the helper, with the target component name passed inline (matching rn-no-image-children's inline "react-native"/"Image" pattern).
• Tests: 9 new rn-no-raw-text cases + a new rn-no-scrollview-mapped-list test file (the rule previously had none).
• Changeset (react-doctor: patch).

Verification

• rn-no-raw-text (18/18) and rn-no-scrollview-mapped-list (6/6) pass.
• typecheck, lint, format clean on changed files.
• The 2 failing tests in the broader react-native suite (rn-bottom-sheet-prefer-native, rn-prefer-pressable-over-gesture-detector) are pre-existing and unrelated — confirmed failing on the base branch with my changes stashed.

Refs: https://docs.expo.dev/versions/v56.0.0/sdk/ui/universal/list/ · https://docs.expo.dev/versions/v56.0.0/sdk/ui/universal/

  

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/eslint-plugin-react-doctor@645

npm i https://pkg.pr.new/oxlint-plugin-react-doctor@645

npm i https://pkg.pr.new/react-doctor@645

commit: dcf0d96

[github-actions]

React Doctor found 10 files changed in this pull request, but none matched the files covered by its enabled checks.

Scope: 10 files changed on cursor/expo-ui-listitem-raw-text-442f vs. main.

View workflow run

Generated by React Doctor. Questions? Contact founders@million.dev.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 4f054b2. Configure here.}