Skip to content

Commit becee7b

Browse files
authored
docs: track react v14 style import cleanup (#3073)
### 🎯 Goal Keep the internal React v14 migration trackers aligned with the latest styling-import cleanup so the source-of-truth docs and the public docs stay in sync. ### 🛠 Implementation details - advance the audited SDK head to `f06846da` - add `BC-057` for the removed `stream-chat-react/dist/css/v2/*` import paths - record the test-only stale-prop cleanup window as ruled out for migration tracking - resolve the matching docs-plan issue now that the public docs are updated in docs-content#1131 ### 🎨 UI Changes None. ### Validation - `git diff --check`
1 parent f06846d commit becee7b

File tree

2 files changed

+137
-97
lines changed

2 files changed

+137
-97
lines changed

ai-docs/breaking-changes.md

Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# React v14 Breaking Changes
22

3-
Last updated: 2026-03-27
3+
Last updated: 2026-03-28
44

55
## Scope
66

@@ -13,8 +13,8 @@ This file tracks confirmed v13 to v14 breaking changes for `stream-chat-react`.
1313
## Audit Reference
1414

1515
- Baseline tag: `v13.14.2`
16-
- Current audited SDK head: `55b1dd6c43f006ac8e7e2ceba1a58d8838bef149` (`55b1dd6c`, `2026-03-27`, `chore(release): 14.0.0-beta.3 [skip ci]`)
17-
- Future mining starting point: diff `55b1dd6c43f006ac8e7e2ceba1a58d8838bef149..HEAD` first, then compare any newly confirmed changes back to the original v13 baseline before adding them here
16+
- Current audited SDK head: `f06846da4d492c0fb9ca375ee049682e6f9e48ba` (`f06846da`, `2026-03-27`, `fix: clean up CSS build output (#3072)`)
17+
- Future mining starting point: diff `f06846da4d492c0fb9ca375ee049682e6f9e48ba..HEAD` first, then compare any newly confirmed changes back to the original v13 baseline before adding them here
1818

1919
Only confirmed items should move from this file into the migration guide.
2020

@@ -1941,6 +1941,33 @@ Only confirmed items should move from this file into the migration guide.
19411941
- `docs/data/docs/chat-sdk/react/v14/04-guides/07-sdk-state-management.md`
19421942
- Example needed: no
19431943

1944+
### BC-057: legacy `dist/css/v2/*` stylesheet import paths no longer resolve
1945+
1946+
- Status: confirmed
1947+
- Area: styling imports
1948+
- User impact:
1949+
- apps importing default styles from `stream-chat-react/dist/css/v2/*` stop resolving those assets after the CSS build-output cleanup
1950+
- installation guides, starter snippets, or internal app templates that still use the old `v2` CSS path are now stale
1951+
- Old API:
1952+
- `stream-chat-react/dist/css/v2/index.css`
1953+
- `stream-chat-react/dist/css/v2/index.layout.css`
1954+
- New API:
1955+
- `stream-chat-react/dist/css/index.css`
1956+
- `stream-chat-react/dist/css/index.layout.css`
1957+
- Replacement:
1958+
- remove the `/v2` segment from CSS import paths
1959+
- if you import SCSS entrypoints, use the root `dist/scss/*` paths as well so examples stay aligned with the package exports
1960+
- Evidence:
1961+
- commit `f06846da fix: clean up CSS build output (#3072)` explicitly marks `stream-chat-react/dist/css/v2/*` imports as a breaking change
1962+
- current `package.json` exports `./dist/css/*`, `./dist/scss/*`, `./css/*`, and `./scss/*`, with no `v2` subpath exports
1963+
- current build scripts output styles directly under `dist/css/*`
1964+
- Docs impact:
1965+
- migration guide
1966+
- `docs/data/docs/chat-sdk/react/v14/01-basics/02-installation.md`
1967+
- `docs/data/docs/chat-sdk/react/v14/02-ui-components/01-getting_started.md`
1968+
- `docs/data/docs/chat-sdk/react/v14/02-ui-components/02-theming/01-themingv2.md`
1969+
- Example needed: no
1970+
19441971
## Likely
19451972

19461973
- None yet
@@ -1962,6 +1989,7 @@ Only confirmed items should move from this file into the migration guide.
19621989
- context-menu animations and global outside-click dismissal controls (`630e5c72`): investigated; current source adds `ContextMenu`, `ContextMenuContent`, `DialogManagerProvider.closeOnClickOutside`, and `DialogAnchor` transition controls, but this is additive customization and behavior polish rather than a removed or renamed v13 public API.
19631990
- `MessageReactionsDetail` loading/toggle refinements (`cab3ffd3`): investigated; current source adds `MessageReactionsDetailLoadingIndicator`, allows toggling the selected reaction type back to `null`, and improves the unfiltered reactions view, but these are additive/current-behavior changes rather than a distinct migration bucket.
19641991
- audio/player, scrolling, and layout polish (`7914e516`, `91eba1b4`, `8d25ead3`, `55dd2e81`, `fdf0e155`, `221aa0d4`): investigated; these commits refine playback reset behavior, initial bottom-pinning, mobile-nav click detection, message-list width, reactions alignment, and voice-recording attachment layout, but they do not remove or rename a documented public API beyond the separately tracked `useChannelListContext()` signature cleanup.
1992+
- type-safety and stale-prop cleanup in tests (`277bc417`): investigated; this commit removes stale props from test fixtures and tightens mock typing, but it does not change the current public runtime API beyond what was already documented in earlier migration buckets.
19651993

19661994
## Notes For Migration Guide Drafting
19671995

0 commit comments

Comments
 (0)