Skip to content

Commit d313317

Browse files
chore(release): 14.0.0-beta.6 [skip ci]
## [14.0.0-beta.6](v14.0.0-beta.5...v14.0.0-beta.6) (2026-04-03) ### ⚠ BREAKING CHANGES * for existing code but changes the accepted values. ### `getGroupChannelDisplayInfo` return value changed The utility function `getGroupChannelDisplayInfo` (from `src/components/ChannelListItem/utils.tsx`) no longer returns `overflowCount` in its result object. ### `AvatarProps.size` type widened to accept arbitrary strings The `size` prop on `AvatarProps` changed from the union `'2xl' | 'xl' | 'lg' | 'md' | 'sm' | 'xs' | null` to `'2xl' | 'xl' | 'lg' | 'md' | 'sm' | 'xs' | (string & {}) | null`. This allows passing custom size strings while preserving autocomplete for the known values. ### `GroupAvatarProps.size` type widened to accept arbitrary strings The `size` prop on `GroupAvatarProps` changed from `'2xl' | 'xl' | 'lg' | null` to `'2xl' | 'xl' | 'lg' | (string & {}) | null`. This allows passing custom size strings while preserving autocomplete for the known values. ### New `capLimit` prop on `AvatarStack` A new optional `capLimit` prop (type `number`, default `3`) controls the maximum number of avatars rendered before overflow. When `displayInfo` has more entries than `capLimit`, only the first `capLimit` items are shown and a "+N" badge displays the remainder. ### `GroupAvatarMember` type gains optional `id` field The `GroupAvatarMember` type now includes an optional `id?: string` field. When present, it is used as the React `key` for rendered avatars instead of the fallback `${userName}-${imageUrl}-${index}` pattern. ## Behavioral Changes ### `ChannelAvatar` always renders via `GroupAvatar` internally Previously, `ChannelAvatar` conditionally chose between `<Avatar>` (for 0–1 members) and `<GroupAvatar>` (for 2+ members). It now always delegates to `<GroupAvatar>`, which itself renders a single `<Avatar>` when fewer than 2 members are present. The visual output is unchanged, but the component tree structure differs. ### `GroupAvatar` auto-caps displayed members at 4 (or 2 with overflow) Previously, callers controlled how many members to display and the overflow count. Now `GroupAvatar` internally slices `displayMembers`: - **4 or fewer members:** all are rendered, no badge. - **More than 4 members:** only the first 2 are rendered, with a "+N" badge showing the count of remaining members. ### `AvatarStack` auto-caps displayed items (default: 3, configurable via `capLimit`) Previously, callers controlled how many items to display and the overflow count. Now `AvatarStack` internally slices `displayInfo` based on the `capLimit` prop (default `3`): - **`capLimit` or fewer items:** all are rendered, no badge. - **More than `capLimit` items:** only the first `capLimit` are rendered, with a "+N" badge showing the count of remaining items. ### `TypingIndicator` no longer manually slices typing users The `TypingIndicator` component previously sliced the list of typing users to a maximum of 3 before passing to `AvatarStack`. It now passes all typing users, relying on `AvatarStack`'s internal capping (also at 3). The net visual result is unchanged. ### chore * adjustmens to Avatar, GroupAvatar and ChannelAvatar ([#3087](#3087)) ([49d576e](49d576e)) ### Bug Fixes * **examples:** clean up tutorial examples for v14 ([#3089](#3089)) ([6239895](6239895)) * **examples:** enable async voice recording preview in thread composer ([#3092](#3092)) ([6c7cd42](6c7cd42)) * **examples:** fix resize handle alignment and thread border gap in RTL ([#3091](#3091)) ([2f060ae](2f060ae)) * **Icons, RTL:** update icon catalog, RTL layout fixes, dark mode & thread voice recording ([#3090](#3090)) ([a4b1c26](a4b1c26)), closes [#3080](#3080)
1 parent 6c7cd42 commit d313317

File tree

1 file changed

+85
-0
lines changed

1 file changed

+85
-0
lines changed

CHANGELOG.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,88 @@
1+
## [14.0.0-beta.6](https://github.com/GetStream/stream-chat-react/compare/v14.0.0-beta.5...v14.0.0-beta.6) (2026-04-03)
2+
3+
### ⚠ BREAKING CHANGES
4+
5+
* for existing code but changes the accepted values.
6+
7+
### `getGroupChannelDisplayInfo` return value changed
8+
9+
The utility function `getGroupChannelDisplayInfo` (from
10+
`src/components/ChannelListItem/utils.tsx`) no longer returns
11+
`overflowCount` in its result object.
12+
13+
### `AvatarProps.size` type widened to accept arbitrary strings
14+
15+
The `size` prop on `AvatarProps` changed from the union `'2xl' | 'xl' |
16+
'lg' | 'md' | 'sm' | 'xs' | null` to `'2xl' | 'xl' | 'lg' | 'md' | 'sm'
17+
| 'xs' | (string & {}) | null`. This allows passing custom size strings
18+
while preserving autocomplete for the known values.
19+
20+
### `GroupAvatarProps.size` type widened to accept arbitrary strings
21+
22+
The `size` prop on `GroupAvatarProps` changed from `'2xl' | 'xl' | 'lg'
23+
| null` to `'2xl' | 'xl' | 'lg' | (string & {}) | null`. This allows
24+
passing custom size strings while preserving autocomplete for the known
25+
values.
26+
27+
### New `capLimit` prop on `AvatarStack`
28+
29+
A new optional `capLimit` prop (type `number`, default `3`) controls the
30+
maximum number of avatars rendered before overflow. When `displayInfo`
31+
has more entries than `capLimit`, only the first `capLimit` items are
32+
shown and a "+N" badge displays the remainder.
33+
34+
### `GroupAvatarMember` type gains optional `id` field
35+
36+
The `GroupAvatarMember` type now includes an optional `id?: string`
37+
field. When present, it is used as the React `key` for rendered avatars
38+
instead of the fallback `${userName}-${imageUrl}-${index}` pattern.
39+
40+
## Behavioral Changes
41+
42+
### `ChannelAvatar` always renders via `GroupAvatar` internally
43+
44+
Previously, `ChannelAvatar` conditionally chose between `<Avatar>` (for
45+
0–1 members) and `<GroupAvatar>` (for 2+ members). It now always
46+
delegates to `<GroupAvatar>`, which itself renders a single `<Avatar>`
47+
when fewer than 2 members are present. The visual output is unchanged,
48+
but the component tree structure differs.
49+
50+
### `GroupAvatar` auto-caps displayed members at 4 (or 2 with overflow)
51+
52+
Previously, callers controlled how many members to display and the
53+
overflow count. Now `GroupAvatar` internally slices `displayMembers`:
54+
- **4 or fewer members:** all are rendered, no badge.
55+
- **More than 4 members:** only the first 2 are rendered, with a "+N"
56+
badge showing the count of remaining members.
57+
58+
### `AvatarStack` auto-caps displayed items (default: 3, configurable
59+
via `capLimit`)
60+
61+
Previously, callers controlled how many items to display and the
62+
overflow count. Now `AvatarStack` internally slices `displayInfo` based
63+
on the `capLimit` prop (default `3`):
64+
- **`capLimit` or fewer items:** all are rendered, no badge.
65+
- **More than `capLimit` items:** only the first `capLimit` are
66+
rendered, with a "+N" badge showing the count of remaining items.
67+
68+
### `TypingIndicator` no longer manually slices typing users
69+
70+
The `TypingIndicator` component previously sliced the list of typing
71+
users to a maximum of 3 before passing to `AvatarStack`. It now passes
72+
all typing users, relying on `AvatarStack`'s internal capping (also at
73+
3). The net visual result is unchanged.
74+
75+
### chore
76+
77+
* adjustmens to Avatar, GroupAvatar and ChannelAvatar ([#3087](https://github.com/GetStream/stream-chat-react/issues/3087)) ([49d576e](https://github.com/GetStream/stream-chat-react/commit/49d576e4a710472f797cd11feb3c562ebd36651b))
78+
79+
### Bug Fixes
80+
81+
* **examples:** clean up tutorial examples for v14 ([#3089](https://github.com/GetStream/stream-chat-react/issues/3089)) ([6239895](https://github.com/GetStream/stream-chat-react/commit/623989574afdaf250225f62e0627478ebb48e473))
82+
* **examples:** enable async voice recording preview in thread composer ([#3092](https://github.com/GetStream/stream-chat-react/issues/3092)) ([6c7cd42](https://github.com/GetStream/stream-chat-react/commit/6c7cd42afffb6d341b7a3b4bf5cc5a9bcd3f98ee))
83+
* **examples:** fix resize handle alignment and thread border gap in RTL ([#3091](https://github.com/GetStream/stream-chat-react/issues/3091)) ([2f060ae](https://github.com/GetStream/stream-chat-react/commit/2f060ae8979de5df77148c591785db730c6f533c))
84+
* **Icons, RTL:** update icon catalog, RTL layout fixes, dark mode & thread voice recording ([#3090](https://github.com/GetStream/stream-chat-react/issues/3090)) ([a4b1c26](https://github.com/GetStream/stream-chat-react/commit/a4b1c2662400f084c3d97f07457012928edf6885)), closes [#3080](https://github.com/GetStream/stream-chat-react/issues/3080)
85+
186
## [14.0.0-beta.5](https://github.com/GetStream/stream-chat-react/compare/v14.0.0-beta.4...v14.0.0-beta.5) (2026-03-31)
287

388
### Bug Fixes

0 commit comments

Comments
 (0)