[isekovanic]

Ticket: https://linear.app/stream/issue/RN-485

🎯 Goal

Fix a startup crash for integrators who install with npm on React 19: "Cannot read property 'useState' of null".

Since 9.10.0, core depends on @khanacademy/simple-markdown (^2.1.0) for the AI components' markdown. That package peer-depends on react/react-dom ^18.2.0. Core does not declare react itself, so npm satisfies the peer by nesting React 18.3.1 at node_modules/stream-chat-react-native-core/node_modules/react. Core's own import 'react' then resolves to that copy, and the app runs two Reacts.

Only npm does this. Yarn 1, Yarn 4, pnpm 10 and bun 1.3 all hand core the app's React 19, which is why the monorepo never showed it.

🛠 Implementation details

Replace @khanacademy/simple-markdown with the original simple-markdown ^0.7.3. The fork was cut from it at 0.8.0, and 0.7.3 has no peer dependencies. It is already in the tree through react-native-markdown-package, and core's main entry already imported it (renderText.tsx) without declaring it.

• package/package.json / yarn.lock: swap the dependency (the fork and @khanacademy/perseus-utils drop out).
• src/ai-components/markdown/*: import from simple-markdown. The API and type names are the same.
• bin/validate-entry-isolation.js: drop the fork from the AI-only packages list, since the main entry already uses simple-markdown.
• src/ai-components/README.md: point the rules link at the original repo.

The fork's newer releases don't help. Every version up to 4.0.3, and Perseus main, still declares react/react-dom ^18.2.0. Even though V10 can resolve ESM modules just fine, some changes still need to be made to the upstream library so that react-dom is no longer enforced. For the time being, we'll revert to the known library that enforces nothing and we'll take up the markdown topic more seriously in the near future.

🎨 UI Changes

None. Markdown output is identical.

🧪 Testing

• yarn lint, cd package && yarn test:typecheck, yarn build and yarn test:unit (272 suites, 3206 tests) all pass.
• npm proof: npm install --package-lock-only next to react@19.3.0. Published 10.0.2 nests react/react-dom 18.3.1 under core; the packed fix resolves a single React 19.3.0, with no @khanacademy packages.
• Parity between the fork (2.2.3) and 0.7.3, run through our AI markdown rules on 2,732 markdown files: the parse trees and rendered element trees are identical. A source diff confirms the parser and regex code is the same. The only differences are sanitizeUrl and the default hr output, and both are code we never run.
• On device: ExpoChatGPTSample on an iOS 27 simulator against a live agent. Headings, nested and numbered lists, tables, syntax-highlighted code, bold, italic, inline code and links all render.

☑️ Checklist

• I have signed the Stream CLA (required)
• PR targets the develop branch
• Documentation is updated
• New code is tested in main example apps, including all possible scenarios
  • SampleApp iOS and Android
  • Expo iOS and Android

[Stream-SDK-Bot]

SDK Size

title	develop	branch	diff	status
js_bundle_size	2033 KB	2033 KB	0 B	🟢
ai_components_size	344 KB	344 KB	-26 B	🚀
a2ui_size	103 KB	103 KB	0 B	🟢

[ghost]

🎉 This PR is included in version 10.1.0 🎉

The release is available on:

• v10.1.0
• GitHub release

Your semantic-release bot 📦🚀