Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
148 commits
Select commit Hold shift + click to select a range
87d7d71
feat: bump stream-chat and introduce new hooks
isekovanic Jul 8, 2026
3888d48
feat: include message action handlers
isekovanic Jul 8, 2026
9f10e37
feat: use stat stores
isekovanic Jul 8, 2026
0872d91
feat: reactive message list first pass
isekovanic Jul 8, 2026
8633abf
feat: add mark read/unread
isekovanic Jul 9, 2026
7550378
feat: thread state
isekovanic Jul 9, 2026
ee53121
chore: context storm cleanup
isekovanic Jul 9, 2026
685fb30
feat: use state directly instead of UI sdk state
isekovanic Jul 9, 2026
5f83608
feat: remove PaginatedMessageListContext
isekovanic Jul 9, 2026
ca2eca4
chore: add ai migration guide for state layer
isekovanic Jul 9, 2026
6773480
chore: optimistic updates for edit and delete
isekovanic Jul 9, 2026
9ea3ec5
fix: pagination past a certain page
isekovanic Jul 9, 2026
fc09564
feat: move message sending to llc state updates
isekovanic Jul 10, 2026
c45d7fa
fix: reaction optimistic updates
isekovanic Jul 10, 2026
2b5d2c1
feat: completely remove channel unread store and rely on LLC
isekovanic Jul 10, 2026
bd86382
chore: cleanup of old state
isekovanic Jul 10, 2026
718fee6
feat: highlighted messages
isekovanic Jul 10, 2026
d3f824b
feat: migrate marking as read
isekovanic Jul 10, 2026
e880cce
feat: move thread to reactive state fully
isekovanic Jul 10, 2026
484fb49
perf: do not load too many messages
isekovanic Jul 11, 2026
4afa591
fix: messagelist snapping on send
isekovanic Jul 11, 2026
469ae4d
perf: introduce delivery count hooks
isekovanic Jul 11, 2026
05142b5
feat: fully migrate thread to thread instances
isekovanic Jul 11, 2026
6236684
feat: always rely on shared thread instance
isekovanic Jul 12, 2026
77e8592
fix: also replied to channel message operations
isekovanic Jul 13, 2026
262e1c1
fix: thread connection recovery mechanism
isekovanic Jul 13, 2026
7a7ee70
fix: inline merge of message lists
isekovanic Jul 15, 2026
18905dd
fix: scrollto edge cases
isekovanic Jul 15, 2026
34549a0
fix: unread resolution
isekovanic Jul 15, 2026
6ce7903
fix: unified unread count state
isekovanic Jul 16, 2026
fa1bf4b
fix: use throttled mark read version
isekovanic Jul 17, 2026
4a34bf3
chore: renaming
isekovanic Jul 17, 2026
e0cda49
chore: cleanup of old thread apis
isekovanic Jul 17, 2026
5741b51
chore: cleanup thread composer semantics
isekovanic Jul 17, 2026
36904be
fix: rely on paginator state and not replies
isekovanic Jul 20, 2026
8e14da1
fix: remove more remnants of the old channel state/
isekovanic Jul 20, 2026
2426410
Merge branch 'develop' into feat/LLC-new-state-layer
isekovanic Jul 20, 2026
3e94338
Merge pull request #3736 from GetStream/feat/LLC-new-state-layer
isekovanic Jul 20, 2026
e127820
fix: export missing hooks and update migration guide
isekovanic Jul 21, 2026
ea334af
feat: remove deprecated channel storage for messages (#3738)
isekovanic Jul 22, 2026
d556a51
feat: reactive channel preview data state (#3740)
isekovanic Jul 22, 2026
f94fb36
Merge branch 'develop' into V10
isekovanic Jul 29, 2026
f26f1fb
Merge branch 'develop' into V10
isekovanic Jul 31, 2026
b7cee73
feat: openapi migration (#3749)
isekovanic Aug 4, 2026
7acd7bc
chore: move optimistic reactions to llc (#3753)
isekovanic Aug 5, 2026
f61ac65
feat: migrate to new channel orchestrator approach (#3770)
isekovanic Aug 11, 2026
e446537
feat: destructive reconciliation (#3771)
isekovanic Aug 14, 2026
31b64c0
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Aug 14, 2026
bfc76b6
chore: remove abort ctrl ref
isekovanic Aug 17, 2026
1a7daa2
feat(i18n): port the v10 English-only translation architecture (#3776)
oliverlaz Aug 18, 2026
0c12071
feat: move to new upload API
szuperaz Aug 18, 2026
44b9381
feat: update stream-chat-js
szuperaz Aug 19, 2026
c959ac2
Merge pull request #3778 from GetStream/fix-upload-file
szuperaz Aug 19, 2026
99b8a94
refactor(i18n)!: adopt the shared i18n layer from stream-chat/i18n (#…
oliverlaz Aug 21, 2026
da80439
fix: adapt to removed stream-chat-js hand-written types (#3783)
szuperaz Aug 21, 2026
e558c03
Merge branch 'develop' into V10
isekovanic Aug 21, 2026
2273037
feat: channel state migration (#3779)
isekovanic Aug 21, 2026
33aa520
feat: migrate to instance configuration api (#3784)
isekovanic Aug 22, 2026
a83ca08
feat: llc driven connection recovery (#3785)
isekovanic Aug 27, 2026
5a8926c
feat: remaining optimistic updates (#3791)
isekovanic Aug 27, 2026
bf94a57
Merge branch 'develop' into V10
isekovanic Aug 27, 2026
7628dfa
chore: bump stream-chat-js to latest RC
isekovanic Aug 27, 2026
8090da2
chore: enable RC sample app builds
isekovanic Aug 27, 2026
8c6ca1a
fix: handle missing initial_build_number in Fastfile
isekovanic Aug 27, 2026
8ec4862
fix: wrongly migrated translations (#3792)
isekovanic Aug 27, 2026
6f51f35
feat!: move to timestamps in response models
szuperaz Aug 31, 2026
12ce664
docs: update docs
szuperaz Sep 1, 2026
f1adeac
feat: update db schema to store dates as numbers
szuperaz Sep 1, 2026
ad8dc9a
fix: review fixes
szuperaz Sep 1, 2026
41f14d3
fix: date values in unit tests
szuperaz Sep 2, 2026
d24df71
fix: more review fixes
szuperaz Sep 2, 2026
7335d50
fix: more review fixes
szuperaz Sep 2, 2026
872e4e1
fix: date null checks in sample apps
szuperaz Sep 2, 2026
4db36f7
fix: type errors in sample app
szuperaz Sep 2, 2026
fab4f11
fix: type errors in expo app
szuperaz Sep 2, 2026
1693793
fix: more review fixes
szuperaz Sep 2, 2026
cdc393d
fix: guard required timestamps from the offline store
oliverlaz Sep 3, 2026
f52c910
feat: update stream-chat-js version
szuperaz Sep 3, 2026
1ccd442
Merge pull request #3794 from GetStream/remove-date-transform
szuperaz Sep 3, 2026
c5e848b
refactor(i18n)!: consume the shared runtime from @stream-io/i18n (#3801)
oliverlaz Sep 11, 2026
cce7b31
fix: store predefined filters in db (#3804)
isekovanic Sep 16, 2026
1a6adc0
chore: bump stream-chat-js rc
isekovanic Sep 16, 2026
8f1adb6
test: update connection id mock
szuperaz Sep 16, 2026
e92e5d5
feat: message pruning
isekovanic Sep 16, 2026
f8efba9
fix: properly update yarn.lock
isekovanic Sep 16, 2026
36a9c36
chore: rename to isPruningSuspended
isekovanic Sep 17, 2026
0918280
Merge remote-tracking branch 'origin/V10' into feat/message-pruning
isekovanic Sep 17, 2026
f85cb3e
Merge pull request #3815 from GetStream/feat/message-pruning
szuperaz Sep 17, 2026
5098084
Merge pull request #3813 from GetStream/update-test-set-connection-id
szuperaz Sep 18, 2026
d0da7b6
feat: network observer (#3808)
isekovanic Sep 18, 2026
d13cc38
fix: do not report offline if state is still unknown
isekovanic Sep 18, 2026
3fa2305
fix: cold start while offline header
isekovanic Sep 18, 2026
9791e0d
fix: sample apps typecheck (#3817)
isekovanic Sep 22, 2026
7b1dd48
refactor: clean up channel hoc (#3820)
isekovanic Sep 22, 2026
0f1c3c9
refactor: delivery receipts v10 (#3823)
isekovanic Sep 23, 2026
88490a5
feat!: move send with pending attachments logic to LLC (#3821)
szuperaz Sep 24, 2026
23e7fdc
feat!: adopt stream-chat's branded TimestampNS (#3822)
oliverlaz Sep 24, 2026
f1b117c
fix(core): show an empty message preview when there is nothing to des…
oliverlaz Sep 25, 2026
98b153b
feat: thread paginator (#3832)
isekovanic Sep 30, 2026
c6cc098
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Sep 30, 2026
9485da2
feat(sampleapp): use token provider in sample app instead of static t…
szuperaz Oct 2, 2026
e2e1d05
feat: adopt TS generator changes (#3836)
szuperaz Oct 5, 2026
6c2513b
refactor: simplify optimistic updates (#3840)
isekovanic Oct 6, 2026
fc0a7c5
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Oct 6, 2026
8d6314a
feat: bump stream-chat-js
isekovanic Oct 6, 2026
5f3166f
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Oct 6, 2026
4c66609
Merge branch 'develop' into V10
isekovanic Oct 7, 2026
ba3c336
feat: v10 channel store migration (#3847)
isekovanic Oct 9, 2026
d1a29fe
feat: UI sdk state cleanup in favor of llc (#3848)
isekovanic Oct 9, 2026
ee238ad
refactor: miscellaneous cleanup v10 (#3852)
isekovanic Oct 12, 2026
ebfac3a
fix: stability and perf fixes (#3854)
isekovanic Oct 13, 2026
7e79dc9
feat: port the client config instance changes to scrn (#3855)
isekovanic Oct 13, 2026
43758fc
refactor: thread instance propagation (#3861)
isekovanic Oct 16, 2026
86500e5
fix: don't import axios into RN SDK (#3853)
szuperaz Oct 16, 2026
c994ffd
chore: merge develop into v10 (#3865)
isekovanic Oct 16, 2026
7ae4793
perf: message actions hook invocations (#3866)
isekovanic Oct 19, 2026
c5b82ac
refactor: separate thread from channel hoc (#3867)
isekovanic Oct 19, 2026
90d32a7
refactor: clean up channel lifecycle (#3868)
isekovanic Oct 19, 2026
2b3c00c
refactor: stop creating sdk paginator (#3869)
isekovanic Oct 19, 2026
585c5a9
fix: respect a registered message page size and accept ClientUser in …
oliverlaz Oct 19, 2026
b4924cd
docs: v10 breaking-changes inventory and v9→v10 ledger audit (#3870)
oliverlaz Oct 19, 2026
6bdfc1b
chore: enable RC creation for the ui sdk as well
isekovanic Oct 19, 2026
dd06eb4
chore: add dry run option
isekovanic Oct 19, 2026
120db5b
chore: add clearer logging of pending release
isekovanic Oct 19, 2026
dc3cb90
fix: v10 in depth review hotfixes (#3876)
isekovanic Oct 20, 2026
59a09b1
docs: tidy code comments in package/src (#3884)
oliverlaz Oct 21, 2026
a121e6e
fix: v10 issues found in the comment cleanup (#3885)
oliverlaz Oct 21, 2026
88e61d2
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Oct 22, 2026
b94f396
feat: paginator refactor compatibility (#3888)
isekovanic Oct 23, 2026
0dd7dd1
fix: bump llc and fix tests
isekovanic Oct 26, 2026
5767715
fix: docs fixes (#3891)
isekovanic Oct 27, 2026
841e115
feat(ai-components): add VoiceGlow and VoiceWave voice-agent visualiz…
oliverlaz Oct 28, 2026
91d63e7
fix: consolidate llc versions and merge master (#3906)
isekovanic Oct 28, 2026
cd9f539
fix: respect message_limit when querying the db (#3908)
isekovanic Oct 29, 2026
f8d46e0
docs(ai-migration): fix the stream-chat-js reference and cover connec…
oliverlaz Oct 29, 2026
194d01c
fix: select the pinned flag instead of the membership object (#3910)
isekovanic Oct 30, 2026
a59a108
Merge pull request #3911 from GetStream/fix/channel-list-loading-spin…
isekovanic Oct 30, 2026
657fdf5
fix(deps): bump @stream-io toolkit packages to the .mjs/.cjs builds (…
oliverlaz Oct 30, 2026
1bf4449
Merge remote-tracking branch 'origin/develop' into V10
isekovanic Oct 30, 2026
0470226
fix: bump stream-chat-js to latest rc
isekovanic Oct 30, 2026
74884ff
fix: v10 sdk regressions (#3916)
isekovanic Nov 2, 2026
de21c4a
docs(ai-migration): make the v9 → v10 guide agent-ready and re-verify…
oliverlaz Nov 3, 2026
e7794a7
fix: stream-chat rc.31 compatibility (#3919)
isekovanic Nov 3, 2026
b8485aa
fix: issues found by the e2e tests and rc.33 compatibility (#3935)
isekovanic Nov 5, 2026
10a59a5
fix: final consolidation with develop (#3943)
isekovanic Nov 6, 2026
73602ec
Merge remote-tracking branch 'origin/develop' into chore/v10-release-…
isekovanic Nov 6, 2026
30529ad
Merge pull request #3948 from GetStream/chore/v10-release-merge
isekovanic Nov 6, 2026
211725a
chore(deps): bump stream-chat to 10.0.0 (#3951)
isekovanic Nov 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
115 changes: 115 additions & 0 deletions .claude/plans/v10-breaking-changes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
# v10 breaking-changes inventory — plan

## Context

v10 moves much of the SDK's state logic into `stream-chat` v10 so it can be shared with `stream-chat-react`. Before release we need one authoritative list of every breaking change to the public API (exported components, props, contexts, hooks, utilities, types, state stores, theme, i18n, peer deps), to drive the migration guide and the docs update.

What exists today:

- v10 code lives on branch **`V10`** (origin/V10 = `c994ffd00`). This worktree's branch sits on `develop` (`42662cdb1`) and contains none of it.
- The running ledger `ai-docs/ai-migration-v9-to-v10.md` exists only on `V10` (~2.7k lines, sections §2–§19 plus Parts I–O). Companions: `ai-docs/channel-state-ui-migration.md`, `ai-docs/i18n-v10-migration.md`, `ai-docs/i18n-v10-key-map.json`.
- LLC guides already exist in `../stream-chat-js/` (`v9-to-v10-migration-guide-client-construction.md`, `…-dates.md`, `react-thread-paginator-migration.md`) — link to them, don't duplicate.
- Docs: `../getstream.io/content/docs/chat-sdk/react-native/v9-latest/` (302 pages; no v10 folder yet).
- Baseline caveats: V10 merges develop via **squash** PRs (#3865), so git ancestry and `develop...V10` three-dot diffs are wrong — compare **tree tips** instead. Three develop commits are not yet in V10 (#3862 host layers, #3863 CI, #3864 RN 0.88/Expo 58); anything only they introduced is filtered out and noted.
- 40 PRs merged into `V10` (plus some direct commits) — the source of behavioral changes and rationale.

Decisions (from user): cover the RN surface **plus** the stream-chat changes an RN integrator hits through the SDK (linking to LLC guides for the rest); **patch the ledger** where it is incomplete or stale; docs impact goes to a **separate report file**, no edits to getstream.io.

## Approach — mechanical diff first, human review second

The ledger was written incrementally by hand, so it is the thing being verified, not the input. Ground truth comes from a type-level diff of the two public surfaces, then commit/PR review catches what types can't see (behavior, defaults, runtime). Two extra **oracles** catch what a surface diff alone misses (see Step 1b).

## Execution order — what runs in parallel

- **Wave A (all concurrent):** both `yarn install`s in the background · 3 PR-review agents (Step 2, need no install) · 1 agent on non-TS surfaces + `examples/` diff + test diffs (Step 1c) · 1 agent extracting `stream-chat-react`'s v10 breaking-change notes for cross-reference.
- **Wave B (concurrent, after installs):** snapshot script in both checkouts · compile-the-v9-app oracle (Step 1b) · LLC type-closure snapshot.
- **Wave C (concurrent):** ledger reconciliation (me, Step 3) · docs-impact scan agent (Step 5) fed the merged item list from Waves A+B.
- **Wave D (sequential):** write the final file, completeness gate, verification.

~5–6 agents total via the Agent tool, run in one message per wave. (A Workflow script could orchestrate the same fan-out deterministically if you'd prefer — say "use a workflow".)

### Step 0 — Setup

- Move this worktree's branch onto `V10` (it has no commits of its own): `git switch -C claude/sdk-v10-breaking-changes-b84ec2 V10`, then `yarn install`.
- Baseline checkout in the scratchpad: `git worktree add <scratchpad>/develop develop` + `yarn install` (needs stream-chat 9.x types, so a separate install is unavoidable).
- Copy this plan into the repo at `.claude/plans/v10-breaking-changes.md` (repo convention).

### Step 1 — Public-surface snapshot (scratchpad script, not committed)

Write `<scratchpad>/api-snapshot.ts` using the TypeScript compiler API (`typescript` is already a dependency). For each entry point — `package/src/index.ts` and `package/src/ai-components/index.ts`, plus the wrapper extras in `package/{native,expo}-package/src/index.js` (`Audio`, `Video`, `FlatList`, …) — it:

- walks `checker.getExportsOfModule()` (following `export *` chains) and records each export's kind: component / hook / function / context / const / type / interface / enum;
- for functions & hooks: parameter names, optionality, types, and return type (`typeToString` with `NoTruncation`);
- for interfaces & type aliases (props, context values, `Theme`, `ComponentOverrides`): **flattened** members via `getPropertiesOfType`, so `Pick<…>`/`Omit<…>`-derived types like `ChannelProps` are compared property-by-property (name, optional, type string); recurse into `Theme` to full depth;
- special-cases `DEFAULT_COMPONENTS` keys and its `icons` map, the `*Translations` / i18n exports, and `state-store` classes (public members).

Emits `snapshot.json`. Run it in both checkouts (`yarn tsx` / `node --experimental-strip-types` from the scratchpad, passing the checkout path as an arg), then a small diff script classifies every change:

- **removed export**, **added export** (non-breaking, tracked for docs),
- **likely rename** (removed+added pairs with similar names/shapes, flagged for confirmation),
- **prop/member removed**, **optional → required**, **type changed** (narrowed/retyped), **signature changed** (params, return type).

Output: `<scratchpad>/surface-diff.md`, grouped by kind. This is the completeness backbone — every breaking line must end up either in the final file or explicitly dismissed (e.g. internal-only, came from develop-only commits).

**LLC type closure.** A prop typed `MessageResponse` prints the same string in v9 and v10 even though stream-chat reshaped it (`.custom`, timestamps). So the snapshot also collects every `stream-chat` type referenced from RN public signatures, snapshots those types (flattened) from stream-chat 9.x vs 10 rc, and flags RN exports whose referenced LLC types changed shape.

### Step 1b — Oracles (catch what the surface diff misses)

- **Compile v9 consumer code against v10.** Copy `develop`'s `examples/SampleApp/src` and `examples/ExpoMessaging` app code into a scratch dir that resolves `stream-chat-react-native` to the V10 checkout and run `tsc --noEmit`. Every error is a break a real integrator hits — cluster errors by symbol and require each cluster to map to an entry.
- **The team's own migration.** `git diff develop V10 -- examples/` is the migration already performed on the sample apps; every changed SDK usage there must map to an entry.
- **Test diffs.** Deleted/rewritten tests under `package/src/**/__tests__` between the tips point at removed behavior; feed them to the Step 2 agents.
- **Deep imports.** The 54 deleted / moved `package/src` files break `stream-chat-react-native-core/src/...` and `lib/...` deep imports; list them (low severity) and check the docs for deep-import paths.
- **Cross-SDK check.** `../stream-chat-react`'s v10/v14 migration notes list the shared LLC-driven changes; anything there that also applies to RN and is missing here gets investigated.

### Step 1c — Non-TS surfaces

Diff directly: `package.json` peer deps / deps (`stream-chat` ^10, new `@stream-io/i18n`, removed `@stream-io/state-store`?), wrapper `package.json`s, native module/Podfile flags, `SqliteClient.dbVersion`, theme generated tokens, i18n keys (already covered by `i18n-v10-migration.md` — cross-link only).

### Step 2 — Behavioral & runtime changes (parallel review)

Types miss default-value changes, removed side effects, moved logic, event semantics. Using `gh pr list --repo GetStream/stream-chat-react-native --base V10 --state merged` (40 PRs) plus direct commits on V10, run **3 parallel Explore/general agents**, each owning a slice of PRs (by area: channel/message-list/paginator & state; composer/attachments/offline/i18n; channel list/threads/connection/config). Each reads PR descriptions + diffs and returns a structured list: `{symbol, v9 behavior, v10 behavior, migration, PR}` for anything not already visible in the type diff (prop defaults, removed side effects, changed callback timing, things that now require `client.config`).

### Step 3 — Reconcile with the ledger

Build a coverage matrix (symbol × ledger §): for every item from Steps 1–2, grep the ledger.

- **Covered** → link the § in the new file.
- **Missing** → add a section to `ai-migration-v9-to-v10.md` in its existing style (Problem / Before / After / Detection; renames as bullets, not tables — per the ai-docs convention).
- **Stale** (ledger claims a removal/rename the diff doesn't confirm, or the replacement API changed again later, e.g. paginator follow-ups) → fix in place.
- Also fix the ledger's ordering quirks (e.g. §K.8 before §K.6, two "§13.1") only if trivially safe; otherwise leave.

### Step 4 — Write `ai-docs/v10-breaking-changes.md`

Source of truth for docs/migration authors (human + agent readable). Structure:

1. Scope & how it was produced (baseline `develop@<sha>` vs `V10@<sha>`, regeneration recipe pointing at the snapshot approach).
2. Dependencies & platform (stream-chat v10, peer deps, native/Expo, offline DB version bump).
3. One section per surface kind — Components & props · `<Channel>` / `<Chat>` / `<ChannelList>` props · Contexts (removed contexts, removed/retyped context fields) · Hooks · Utilities & functions · Types · State stores · `WithComponents` slots & icons · Theme · i18n (summary + link to `i18n-v10-migration.md`).
4. stream-chat changes an RN integrator hits (custom fields under `.custom`, timestamps, `client.config`, connection recovery, `channel.state`, OfflineDB APIs) — short entries linking to the LLC guides.
5. Behavioral changes (no symbol change).
6. Additive APIs worth documenting (from "added exports") — kept brief, needed for the docs update.

Each entry, as bullets: **symbol** — what changed (v9 → v10) — replacement / migration one-liner — ledger § link — PR #.

### Step 5 — Docs impact report `ai-docs/v10-docs-impact.md`

Script over `getstream.io/content/docs/chat-sdk/react-native/v9-latest/**`: for every removed/renamed/retyped symbol and removed prop name from the final list, grep page bodies, code fences and import lines (word-boundary match; prop names matched in context of their component to avoid noise like `channel`). Then manually triage hits. Report:

- per page: breaking items referenced + what must change (rewrite / delete section / update snippet);
- pages to delete outright (e.g. docs for removed contexts like `TypingContext`, `PaginatedMessageListContext`), pages needing new content (paginator, `client.config`, `channel.state`), and the migration-guide page to create (`06-migration-guides/…upgrading-from-v9`);
- summary counts so the docs effort can be sized.

## Critical files

- Read: `V10:ai-docs/ai-migration-v9-to-v10.md`, `package/src/index.ts`, `package/src/ai-components/index.ts`, `package/src/contexts/componentsContext/defaultComponents.ts`, `package/{native,expo}-package/src/index.js`, `package/package.json`, `package/src/store/SqliteClient.ts`
- Write: `ai-docs/v10-breaking-changes.md` (new), `ai-docs/v10-docs-impact.md` (new), `ai-docs/ai-migration-v9-to-v10.md` (patched), `.claude/plans/v10-breaking-changes.md` (plan copy)
- Scratch only: snapshot/diff scripts and their JSON/MD output.

## Verification

- Oracle gate: every `tsc` error cluster from compiling the v9 sample apps against V10, and every SDK-usage change in the `examples/` diff, maps to an entry (target: 0 unmapped).
- Completeness gate: every line in `surface-diff.md` classified as breaking is mapped to an entry in `v10-breaking-changes.md` or listed in a "dismissed" appendix with a reason — the script re-runs and reports unmapped symbols (target: 0).
- Spot-check 10 random entries against the code on `V10` (symbol really gone / retyped as stated).
- Every replacement API named in the file exists in `V10` exports (`grep` against the V10 snapshot).
- `yarn lint` passes (prettier on the new markdown).
- Nothing committed without showing the diff and getting approval.
2 changes: 1 addition & 1 deletion .claude/skills/accessibility/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ Use `useAnnounceOnStateChange(message, { debounceMs, priority })` for transition

Use `useAnnounceOnShow(visible, message, { delayMs, priority })` for **transient surfaces that appear and disappear repeatedly** (modals, sheets, autocomplete pickers). It announces on each `visible: false → true` transition and resets on hide, so the next show re-announces. The two announcer hooks are not interchangeable: `useAnnounceOnStateChange` dedupes on string equality (correct for "AI is typing" → "AI is generating"), while `useAnnounceOnShow` dedupes on visibility transition (correct for "Suggestions available" each time the picker reopens with the same label). Pair with `useA11yLabel('a11y/…')` for the message so the announcement is i18n'd and gated on the SDK's a11y opt-in.

For incoming messages: use `useIncomingMessageAnnouncements({ channel, ownUserId, activeThreadId, threadList })`. It throttles to 1 announcement per second, batches multi-message bursts, and bounds memory at 500 announced ids.
For incoming messages: use `useIncomingMessageAnnouncements({ channel, ownUserId, activeThreadId })` (set `activeThreadId` in a thread's list; there is no `threadList` flag). It throttles to 1 announcement per second, batches multi-message bursts, and bounds memory at 500 announced ids.

### 3) Modal / sheet focus trap

Expand Down
2 changes: 2 additions & 0 deletions .claude/skills/perf-benchmarking/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ description: Measure React Native performance on-device for stream-chat-react-na

# Perf benchmarking (on-device, stream-chat-react-native)

> For a full multi-hour base-vs-head comparison of every major flow (release builds, FlatList and FlashList, statistics), use the `perf-gauntlet` skill instead.

How to measure SDK performance for real, against the **SampleApp running on a physical Android device**, using the committed `perf/` toolkit. This skill exists because the methodology is full of traps that produce confidently-wrong numbers; follow the rules and recipes here instead of improvising.

Prerequisites for almost everything below:
Expand Down
Loading
Loading