stream_chat_flutter

✅ Added

• Added onReactionLongPress to StreamMessageItem and StreamMessageListView, reporting the long-pressed message's BuildContext and a ReactionLongPressDetails with the message and reaction (the reaction is null for a clustered or overflow chip that maps to no single reaction).
• Exported this package's StreamMessageContent, which was previously unreachable from package:stream_chat_flutter/stream_chat_flutter.dart.
• Added StreamChatConfigurationData.messageTranslation, a StreamMessageTranslationConfiguration with enabled (default true) to display translations from Message.i18n and annotationEnabled (default false) to opt into a "Translated"/"Original" annotation with a toggle link.
• Added StreamMessageTranslationStore, tracking which messages show their original text instead of their translation. StreamChat owns one and provides it through a StreamMessageTranslations scope, so every message list agrees on which text a message shows. Also drivable per widget via showTranslatedText and onToggleTranslatedText.

⚠️ Changed

• Long-pressing a reaction chip no longer opens the message actions modal; the chips always claim the long press. Left unset, onReactionLongPress defaults to opening the ReactionDetailSheet.
• Tapping or long-pressing a reaction chip now opens the ReactionDetailSheet pre-filtered to that reaction; it previously opened unfiltered. Clustered and overflow chips map to no single reaction, so they still open unfiltered.

🔄 Changed

• Raised minimum Flutter to >=3.44.0 and Dart SDK to ^3.12.0.

🐞 Fixed

• Fixed message text and previews translating to English for users with no User.language set; they now show the original text.
• Fixed a crash on web when the message list rebuilt while messages were selectable, for example after opening the attachment picker.
• Fixed the browser's native context menu reappearing over the message context menu on web after scrolling messages out of view or deleting one.
• Fixed the SDK re-enabling the browser's native context menu on web in apps that had disabled it themselves.

⚠️ Changed

• StreamMediaGallery no longer applies its own outer padding or strips the ambient MediaQuery padding; pass padding to inset the grid.
• StreamMessageListView.config is now nullable; reading it off an instance yields StreamMessageListViewConfiguration? rather than a default instance.
• StreamMediaGalleryPreview chrome now follows the app style — floating over full-bleed media, or docked with the media inset between the bars.
• Thread views now show the scroll-to-bottom button, following showScrollToBottom from the effective StreamMessageListViewConfiguration; set it to false to hide it.

✅ Added

• Added resolveSurfaceStyle to StreamMessageComposer, StreamChannelHeader, StreamChannelListHeader, and StreamThreadHeader, reporting the surface style each renders with so a page can lay its scaffold slot out to match.
• Added StreamChannelPage — a ready-to-use channel page wiring up StreamChannelHeader, StreamMessageListView, and StreamMessageComposer with floating or docked layout.
• Added StreamThreadPage — the thread equivalent, plus an onBackPressed that replaces the header back button's default pop.
• Added onBackPressed to StreamChannelHeader and StreamThreadHeader, replacing the default back button's pop without rebuilding leading. Ignored when leading is supplied.
• Added MessageComposerProps.surfaceStyle, selecting whether StreamMessageComposer renders floating or regular. Falls back to StreamMessageComposerThemeData.surfaceStyle, then the ambient StreamSurfaceStyle.
• Added StreamMessageComposerTheme and StreamMessageComposerThemeData — a component theme for the composer, also available globally as StreamChatThemeData.messageComposerTheme.
• Added StreamMessageListView.config — an explicit StreamMessageListViewConfiguration per widget, falling back to StreamChatConfigurationData.messageListViewConfiguration.
• Added StreamChatConfigurationData.messageListViewConfiguration — an app-wide StreamMessageListViewConfiguration default, passed via StreamChat.configData.
• Added floating support to StreamChannelHeader, StreamChannelListHeader, and StreamThreadHeader — each resolves the surface style from its per-header theme and republishes it to every slot, including the new StreamBackButton.isFloating.
• Added StreamMessageListViewConfiguration.autoScrollPolicy to control whether and how StreamMessageListView scrolls to the newest message when a new message arrives. Use StreamAutoScrollPolicy.disabled to fully control scrolling yourself.
• Added onReactionSelected to StreamMessageReactionPicker, a context-aware callback that provides the BuildContext for navigation.
• Added an errorSubtitle to StreamScrollViewErrorWidget, which now falls back to the design's generic error copy (title, description, and a "Try Again" retry label) when values aren't provided.
• Added a size (StreamLoadingSpinnerSize) parameter to StreamScrollViewLoadingWidget.
• Added onReactionTap to StreamMessageItem and StreamMessageListView, reporting the tapped message's BuildContext and a ReactionTapDetails with the tapped message and reaction (the reaction is null for a clustered or overflow chip that maps to no single reaction).
• Exported StreamEphemeralMessage, the row StreamMessageListView builds for ephemeral messages, matching its already-exported StreamSystemMessage and StreamModeratedMessage siblings.
• Added an unreadIndicator parameter to StreamBackButton that overlays a widget (typically a StreamUnreadIndicator) on the button's top-end corner. Pass StreamUnreadIndicator(excludeCid: cid) to show the total unread count of other channels, or StreamUnreadIndicator.channels(cid: cid) for a single channel's count.

⚠️ Deprecated

• Deprecated StreamMessageReactionPicker.onReactionPicked in favor of onReactionSelected.
• Deprecated onReactionsTap (and the OnReactionsTap typedef) on StreamMessageItem and StreamMessageListView in favor of onReactionTap.
• Deprecated height/width of StreamScrollViewLoadingWidget in favor of size.
• Deprecated StreamBackButton.showUnreadCount and StreamBackButton.channelId in favor of unreadIndicator.

🐞 Fixed

• Fixed a failed send surfacing as an unhandled async error when StreamMessageComposer has no onError; it is now reported through FlutterError.reportError.
• Fixed the default StreamChannel loading and error states not being themed or localized; StreamChat now installs themed, connection-aware defaults, overridable per StreamChannel or via DefaultStreamChannelBuilders.
• Fixed the default list/scroll-view error states (channel, message, member, user, thread, poll-vote, reaction, search, and photo) showing raw or fixed errors; they are now connection-aware (no internet / slow connection), falling back to each view's specific error text.
• Fixed StreamTypingIndicator briefly showing typing users from a different context (main channel vs. thread) on its first frame.
• Fixed the attachment picker throwing a Tooltip assertion error when a custom TabbedAttachmentPickerOption is added without a title; the tooltip is now only shown when a title is provided.
• Fixed the "Message deleted" bubble overflowing its maximum width when the localized label is long; the label now wraps instead.
• Fixed the thread scroll-to-bottom button keying off the parent channel's up-to-date state instead of the thread's own scroll position, so it no longer appears while already at the newest reply.
• Fixed the StreamBackButton unread badge including the currently open channel in its total count.
• Fixed the thread-replies footer under a message in the channel being hardcoded English and reading "1 replies" for a single reply; it now uses threadReplyCountText, which is localized and correctly singularized.
• Fixed a channel-list row briefly previewing another channel's last message after the list reorders. The preserved last-known message is now dropped when a row is rebound to a different channel, instead of being used as a fallback while the new channel is still loading.
• Fixed the channel list still showing a timestamp next to "No messages yet" after a channel is truncated. ChannelLastMessageDate now reads the date off the message the preview actually shows instead of Channel.lastMessageAt, which cannot be cleared once a truncation removes every message.
• Fixed StreamMessageListView jumping several screens when selecting text in a message on desktop or web. The ScrollablePositionedList viewports now account for their anchor in getOffsetToReveal, so implicit reveals (Scrollable.ensureVisible, RenderObject.showOnScreen) no longer overshoot. #2862
• Fixed modal dialogs (message actions, delete/flag confirmation) rendering over a white scrim in light theme; they now use the design system's scrim token.
• Fixed the message metadata in the long-press actions modal keeping its muted in-list colors against the dark scrim. The previewed message now renders its annotations ("Saved for later", "Pinned by", "Replied to a thread" + "View", "Reminder set"), username, sending status and read receipts, timestamp, "Edited" label, and thread-reply count in white. Added StreamSendingIndicator.color to override the indicator's icon color.

🔄 Changed

• Improved message text selection experience on desktop and web.

⚠️ Changed

• Removed dependency on media_kit and media_kit_video. When running the VideoPlayer on Windows or Linux platforms, you need to add media_kit dependency to your pubspec.yaml file and create a custom StreamVideoPlayer implementation in the streamChatComponentBuilders. (#2828)

✅ Added

• Added AccessibilityTranslations on Translations (accessed via context.translations.accessibility) — screen-reader labels, tooltips, hints, and live-region announcements. Includes formatDateTime, formatDuration, and formatRecentDateTime formatters.
• Added AccessibleMessagePreviewFormatter — an optional interface extending MessagePreviewFormatter with formatMessageSemanticsLabel and formatDraftMessageSemanticsLabel. StreamMessagePreviewText, StreamDraftMessagePreviewText, and StreamSendingIndicator now emit natural-language screen-reader labels for the channel list.
• Added optional semanticsLabel to StreamChannelAvatar. Group channels emit a default "Group" label; direct-message avatars stay silent.
• Added optional semanticsLabel to StreamTimestamp. Defaults to a bucketed natural-language phrasing via AccessibilityTranslations.formatRecentDateTime.
• Added a LastMessagePredicate typedef for the ChannelLastMessageText.lastMessagePredicate filter.
• Added optional semanticsLabel to StreamUserAvatar, StreamUserAvatarGroup, and StreamUserAvatarStack.
• Made StreamVideoPlayer overridable via the StreamComponentFactory (streamChatComponentBuilders(videoPlayer: ...)), with the previous implementation now available as DefaultStreamVideoPlayer.

🐞 Fixed

• Fixed link preview enrichment failing for uppercase URL schemes (e.g. HTTPS://) by normalizing the scheme before enriching.
• Fixed last-message preview flicker during channel-state reloads.
• Fixed shadowed messages not hidden in channel list items.
• Fixed StreamMessageListView firing markThreadRead on a reply-less parent, which produced a guaranteed 404 every time the thread view was opened before the first reply.
• Fixed dismissing the StreamMessageListView unread indicator being ignored while a channel is receiving a rapid burst of messages.
• Fixed StreamTypingIndicator rebuilding on every typing event by comparing the typing users by id, so it only rebuilds when the set of typing users changes.
• Fixed StreamChannelListTile announcing avatar initials and unlabeled fragments — now merges into a single accessible row summary with labeled avatar, muted / pinned icons, and unread badge.
• Fixed StreamThreadListTile announcing content as flat comma-separated fragments — now merges into a single accessible row summary and labels the unread badge with the localized "N unread messages" phrasing.
• Renamed attachmentPickerTooltip to state-agnostic "Toggle attachment picker" so screen readers no longer announce "Open attachment picker" while the picker is already expanded.
• Fixed voiceRecordingText casing to sentence case ("Voice recording").
• Fixed formatRecentDateTime hardcoding 24-hour time — displayed and announced timestamps now follow the locale's convention (e.g. 24-hour in Germany, 12-hour in India).
• Replaced the get_thumbnail_video dependency with Stream's own stream_thumbnail plugin, resolving the iOS duplicate-VideoThumbnailPlugin-symbol crash when an app also uses video_thumbnail/video_editor (#2360).

🐛 Fixed

• Fixed a use-after-dispose race condition in StreamAttachmentPickerController, StreamAudioRecorderController, and StreamAudioPlaylistController: async methods could write value after dispose(), causing a notifyListeners() assertion throw in debug mode. All three now use the DisposeAwareValueNotifier mixin from stream_chat_flutter_core.

✅ Added

• Added support for @channel, @here, role, and user-group mentions — parsed on incoming messages, rendered as styled tappable spans in message text, and selectable from the composer's @ autocomplete.
• Added a single mentionItemBuilder on StreamMessageComposer and StreamMentionAutocompleteOptions that receives StreamMentionItemProps and covers every mention kind. Customise globally via streamChatComponentBuilders(mentionItem: ...) or per-instance via the new constructor parameter. Defaults are rendered by DefaultStreamMentionItem. Also added onMention*Tap callbacks on StreamMentionAutocompleteOptions.
• Added StreamMessageListView.onMentionTap and StreamMessageItem.onMentionTap — receives a typed StreamMention (StreamUserMention, StreamChannelMention, StreamHereMention, StreamRoleMention, or StreamGroupMention).
• StreamMessageComposer now surfaces the hold-to-record hint through StreamSnackbar anchored above the composer, and StreamChat provides an app-wide StreamSnackbarScope fallback.
• Added commandValidator prop on StreamCommandAutocompleteOptions and StreamCommandPicker for marking rows as unavailable; disabled rows remain tappable so the caller can surface feedback.
• StreamMessageComposer now surfaces a StreamSnackbar when the user taps a disabled slash command in the picker or autocomplete, explaining why it's blocked.

⚠️ Deprecated

• StreamAudioRecorderController.showInfo is now deprecated. Show your own snackbar via StreamSnackbarMessenger.of(context).show(StreamSnackbar(...)) instead.
• RecordStateIdle.message is now deprecated; the composer no longer reads it.
• Deprecated userMentionsTileBuilder on StreamMessageComposer and mentionsTileBuilder on StreamMentionAutocompleteOptions in favor of mentionItemBuilder.
• Deprecated StreamMessageListView.onUserMentionTap and StreamMessageItem.onUserMentionTap in favor of onMentionTap.
• Deprecated UserListX.search.

🔄 Changed

• Improved the local filtering/sorting logic for the mention suggestions autocomplete.

🐞 Fixed

• StreamMessageItem.onUserAvatarTap now fires when the author avatar is tapped. (#2741)
• Added MessageComposerProps.copyWith so factory overrides can tweak individual props (e.g. useSystemAttachmentPicker) without re-specifying every field. (#2742)
• StreamMessageContent no longer re-runs setState on every inherited-widget change when the measured attachment width has not changed. (#2761)

🐞 Fixed

• Fixed the "Also send in Channel" checkbox not being disabled during slow mode. The checkbox and its label now render with disabled colors (colorScheme.textDisabled) when a cooldown is active, matching the rest of the composer.
• StreamUserAvatar with StreamAvatarSize.xxl now uses StreamOnlineIndicatorSize.xxl (20px) instead of xl (16px), matching the Chat SDK design system spec.
• Fixed the thread page flashing through a large scroll-up animation when opened from an in-channel reply with cached thread replies.
• Fixed the thread page throwing Bad state: No element on every channel state update when the parent message wasn't in the channel's loaded window.
• Fixed opening a thread page or long-press message-actions modal overwriting the channel's loaded window — most visibly, jumping back to latest when the user had navigated to an older message via a quoted reply.
• StreamMessageComposer no longer clobbers pre-populated composer state (text, quoted message, attachments) when the channel's draft stream emits its initial null (no draft on server). The reset now fires only on an actual non-null → null transition, distinguishing "no draft yet" from "draft was removed".

✅ Added

• StreamMessageComposer now validates attachments against the app's AppSettings (configured in the Stream Dashboard) — enforcing size, extension/MIME, and count rules. Pass onError to handle the typed AttachmentLimitReachedError, AttachmentTooLargeError, or AttachmentBlockedError instead of the default error sheet.
• Added Translations.fileTypeNotSupportedError(String? extension) — surfaced by the composer when an attachment's extension or MIME type is rejected.
• Added BlockUser / UnblockUser default message actions, dispatching to StreamChatClient.blockUser / unblockUser.

🔄 Internal / Non-breaking

• Reordered the default message actions to match the design system.

• Renamed default English threadReplyLabel ('Thread' → 'Thread Reply') and markAsUnreadLabel ('Mark as Unread' → 'Mark Unread').

• StreamThreadHeader default title now sources from the new threadLabel translation key instead of threadReplyLabel, restoring the short 'Thread' header.

• ReactionIconResolver.supportedReactions is now wired to the full emoji picker sheet opened by the "+" button in StreamMessageReactionPicker and the add-emoji chip in ReactionDetailSheet. Override supportedReactions on a custom resolver to control which reactions appear in the full picker grid.

• Composer UI primitives (StreamMessageComposerInputField, VoiceRecordingCallback, and the outer/inner layout containers) are now owned by stream_chat_flutter and exported from this package. They were previously supplied by stream_core_flutter. The public API of StreamMessageComposer / StreamChatMessageInput and its sub-components is unchanged.

• Re-export StreamAvatarTheme and StreamAvatarThemeData from stream_core_flutter so consumers can theme avatars without adding a separate stream_core_flutter import.

• Added messageLeading, messageHeader, and messageFooter factory slots to streamChatComponentBuilders for overriding the message item's avatar, annotations, or metadata row without replacing the whole messageItem.

• Bumped jiffy to ^6.4.5 to pick up cached locale and DateFormat lookups for cheaper relative-time formatting.

• Raised minimum Flutter to >=3.41.0 and Dart SDK to ^3.11.0.

🛑️ Breaking

• StreamChatConfigurationData.draftMessagesEnabled now defaults to true. Draft messages are enabled out of the box; pass draftMessagesEnabled: false to opt out.
• StreamChatConfigurationData.enforceUniqueReactions now defaults to false. Users can add multiple distinct reaction types to a message by default; pass enforceUniqueReactions: true to restore the previous behaviour.
• StreamMessageComposer.enableVoiceRecording now defaults to true. The voice recording button is shown out of the box; pass enableVoiceRecording: false to opt out.
• StreamMessageListView had its large set of configuration and builder parameters reorganized. Behavior flags (e.g. swipeToReply, markReadWhenAtTheBottom, showScrollToBottom, reverse, paginationLimit, scrollPhysics, etc.) moved to StreamMessageListViewConfiguration, passed directly as StreamMessageListView.config. Custom builder callbacks (headerBuilder, footerBuilder, loadingBuilder, emptyBuilder, errorBuilder, messageListBuilder, parentMessageBuilder, dateDividerBuilder, floatingDateDividerBuilder, threadSeparatorBuilder, unreadMessagesSeparatorBuilder, scrollToBottomBuilder, paginationLoadingIndicatorBuilder, spacingWidgetBuilder, systemMessageBuilder, ephemeralMessageBuilder, moderatedMessageBuilder) moved to StreamMessageListViewBuilders, passed directly as StreamMessageListView.builders. The messageBuilder parameter is back at the root of the constructor as before.
• Bumped file_picker to ^11.0.0 to resolve #2599. Apps depending on file_picker directly must also upgrade past 11.0.0, which replaces the instance-based FilePicker.platform.* API with static FilePicker.* methods.
• Renamed StreamChat.streamChatThemeData → StreamChat.themeData and StreamChat.streamChatConfigData → StreamChat.configData. The StreamChatState.streamChatConfigData getter is now StreamChatState.configData.
• Renamed StreamMessageComposer.messageInputController parameter to messageComposerController.
• Removed StreamDraftListView, StreamDraftListTile, StreamDraftListTileTheme, and StreamDraftListTileThemeData from the SDK. Also removed StreamChatThemeData.draftListTileTheme. Refer to the sample app for a reference implementation using StreamDraftListController and PagedValueListView.
• Renamed StreamMessageComposerInput → StreamMessageComposerInputCenter (and DefaultStreamMessageComposerInput → DefaultStreamMessageComposerInputCenter). The name StreamMessageComposerInput is now the input container widget (assembles header, leading, center, trailing).
• Renamed MessageComposerInputProps → MessageComposerInputCenterProps. The name MessageComposerInputProps now refers to the new container widget's props.
• Renamed messageComposerInput builder key in streamChatComponentBuilders → messageComposerInputCenter. The name messageComposerInput now overrides the whole input container.
• Replaced StreamMessageInput.hintGetter with placeholderBuilder over a sealed MessageInputPlaceholder. See migrations/redesign/message_composer.md.
• Removed StreamMessageListView.unreadIndicatorBuilder; use StreamComponentFactory.jumpToUnreadButton.
• Renamed UnreadIndicatorButton.onTap → onJumpTap.
• Renamed stream icons to remove the size suffix from the icon names.
• Removed StreamAttachmentUploadStateBuilder.successBuilder and the SuccessBuilder typedef (unreachable).
• Removed StreamFileAttachmentThumbnail; use StreamImageAttachmentThumbnail / StreamVideoAttachmentThumbnail or StreamFileTypeIcon.fromMimeType(...).
• Removed StreamMessageThemeData (ownMessageTheme / otherMessageTheme) and StreamMessageInputThemeData (messageInputTheme).
• Removed StreamChannelPreviewThemeData (channelPreviewTheme).
• Removed the public MessageDetails class. The new messageBuilder signature no longer receives it — use StreamChat.of(context).currentUser and StreamMessageLayout.of(context) instead. See migrations/redesign/message_list.md.
• Renamed StreamPollOptionsDialog / StreamPollResultsDialog / StreamPollOptionVotesDialog / StreamPollCommentsDialog (and their show* helpers and ...DialogThemeData types) → ...Sheet. They now render as modal bottom sheets.
• Replaced StreamPollCreatorDialog / StreamPollCreatorFullScreenDialog (and showStreamPollCreatorDialog) with a single StreamPollCreatorSheet (showStreamPollCreatorSheet) that renders as a modal bottom sheet, matching the other poll sheets. StreamPollCreatorWidget gained an optional scrollController parameter.
• Removed primaryActionStyle and secondaryActionStyle from StreamPollCreatorThemeData. Use the new sheetHeaderStyle.trailingStyle / sheetHeaderStyle.leadingStyle instead — see migrations/redesign/attachments_and_polls.md.
• Redesigned StreamPollOptionsSheetThemeData, StreamPollResultsSheetThemeData, StreamPollOptionVotesSheetThemeData and StreamPollCommentsSheetThemeData — see migrations/redesign/attachments_and_polls.md.
• Renamed Translations.questionsLabel getter → questionLabel({bool isPlural = false}) method.
• Renamed Translations.endVoteConfirmationText → endVoteConfirmationTitle; English default changed to 'End This Poll?'.
• Renamed Translations.slowModeOnLabel getter → slowModeOnLabel(int cooldownTimeOut) method; English default changed from 'Slow mode ON' to 'Slow mode, wait ${cooldownTimeOut}s\u2026'. While slow mode is active for the current user the composer text input is now disabled and the trailing send button is replaced by a disabled countdown button showing the remaining seconds, matching the redesigned Figma. See migrations/redesign/message_composer.md.
• Reworded Translations.endVoteLabel English default to 'End Poll'.
• Removed AttachmentButton, StreamQuotedMessageWidget, EditMessageSheet, StreamMessageSendButton and DesktopReactionsBuilder.
• Removed StreamChannelGridView, StreamChannelGridTile and StreamMessageSearchGridView.
• StreamMessageActionConfirmationModal.cancelActionTitle / confirmActionTitle are now nullable and fall back to Translations.cancelLabel / confirmLabel.
• Renamed Translations.attachmentsUploadProgressText parameter remaining → completed.
• Updated several Translations default strings and added new abstract members — see migrations/redesign/localizations.md.
• Renamed MuteIconPosition → AttributePosition (values title → inlineTitle, subtitle → trailingBottom) and StreamChannelListItemThemeData.muteIconPosition → attributePosition. Now controls both mute and pin icons in StreamChannelListTile.
• Removed AttachmentModalSheet, ErrorAlertSheet and StreamChannelInfoBottomSheet.
• Removed StreamMarkdownMessage; use StreamMessageText (re-exported from stream_core_flutter) instead.
• Renamed message item components to align with Android Compose and SwiftUI conventions:
  • StreamMessageWidget → StreamMessageItem (file moved to message_item.dart).
  • DefaultStreamMessage → DefaultStreamMessageItem.
  • StreamMessageWidgetProps → StreamMessageItemProps.
  • StreamMessageWidgetBuilder typedef → StreamMessageItemBuilder.
  • StreamMessageAnnotations → StreamMessageHeader.
  • StreamMessageMetadata → StreamMessageFooter.
  • ParseAttachments → StreamMessageAttachments.
  • streamChatComponentBuilders(messageWidget: ...) → messageItem: ....
  • StreamMessageContent(annotation: ..., metadata: ...) → header: ..., footer: .... See migrations/redesign/message_widget.md.
• Redesigned the full-screen media viewer:
  • Replaced StreamFullScreenMedia (and its StreamFullScreenMediaBuilder / FullScreenMediaWidget / FullScreenMediaDesktop / fsm_stub variants) with a single cross-platform StreamMediaGalleryPreview. Renamed mediaAttachmentPackages → attachments, startIndex → initialIndex; dropped userName, sentAt, onReplyMessage, onShowMessage and attachmentActionsModalBuilder from its surface.
  • Renamed StreamGalleryHeader → StreamMediaGalleryPreviewHeader and StreamGalleryFooter → StreamMediaGalleryPreviewFooter, rebuilt on StreamAppBar / StreamBottomAppBar. Both shrank to a title (+ optional subtitle) and minimal action callbacks; the more-actions overflow header was removed.
  • Renamed StreamAttachmentPackage → StreamMediaGalleryAttachment and added a Message.toMediaGalleryAttachments({filter}) extension.
  • Removed VideoPackage, DesktopVideoPackage and GalleryNavigationItem from the public API — each preview page now owns its own player state internally.
  • Removed StreamMessageItem.onShowMessage / attachmentActionsModalBuilder and the matching StreamMessageListView / StreamMessageContent props; those callbacks no longer have a destination after the gallery overflow was removed.
  • Removed StreamChatThemeData.galleryHeaderTheme, StreamChatThemeData.galleryFooterTheme (and the imageFooterTheme: constructor parameter) and the StreamGalleryFooterThemeData class. Header / footer chrome now flows through StreamAppBarThemeData / StreamBottomAppBarThemeData.
  • Removed the unused StreamAvatarThemeData. See migrations/redesign/media_viewer.md.
• Removed StreamMessageComposer.maxAttachmentSize (and the kDefaultMaxAttachmentSize constant). Per-type size limits come from StreamChatClient.appSettings (configured in the Stream Dashboard).
• Removed StreamMessageComposer.onAttachmentLimitExceed and the AttachmentLimitExceedListener typedef. Use onError for custom error handling.
• StreamMessageComposer.attachmentLimit is now a non-nullable int defaulting to 30 (the per-message attachment cap). Previously int? defaulting to null ("no limit").
• StreamAttachmentPickerController constructor now takes a single validator: StreamAttachmentValidator parameter (replaces the previous size / limit / config parameters).

✅ Added

• Video attachments use the shared StreamVideoPlayIndicator for the play-button overlay.
• Redesigned StreamSystemMessage / StreamModeratedMessage with a pill-shaped style and visual customisation props.
• Added visual customisation props to ThreadSeparator and UnreadMessagesSeparator.
• Added StreamUnsupportedAttachment and UnsupportedAttachmentBuilder for unrecognised attachment types.
• Added StreamMediaGallery — a 3-up thumbnail grid that pairs with StreamMediaGalleryPreview. Each tile surfaces the sender's avatar (StreamUserAvatar) plus a video duration badge for video attachments. Used by StreamMediaGalleryPreviewFooter's gallery-grid sheet and ready to drop into channel-level media listings. Customisable via streamChatComponentBuilders(mediaGallery: ...).
• Added StreamMediaGalleryPreview — the redesigned full-screen swipeable viewer. Built on the design system's StreamMediaViewer, StreamAppBar and StreamBottomAppBar. Customisable via streamChatComponentBuilders(mediaGalleryPreview: ...). Exposes StreamMediaGalleryPreviewScope so per-page widgets (e.g. videos) can react to the active page.
• Added StreamVideoPlayer — the platform-aware video backend used by StreamMediaGalleryPreview. Pauses itself when its page is no longer active and resumes on return.
• Added Translations.photosAndVideosLabel — used by the footer's thumbnail-grid sheet header.
• Added StreamQuotedMessage and StreamQuotedMessageThemeData for the quoted message preview.
• MessagePreviewFormatter now renders AttachmentType.urlPreview messages with a link icon and caption / OG title / linkAttachmentText fallback.
• Added StreamPollCardStyle, StreamPollQuestionStyle and StreamPollOptionVotesStyle shared style classes for the poll sheets.
• Added a total vote count footer and per-option "View all" action to StreamPollResultsSheet.
• Added a sheetHeaderStyle field to each poll sheet theme data (including StreamPollCreatorThemeData).
• Re-exported StreamSheetHeader, StreamSheetHeaderStyle, StreamSheetHeaderTheme and StreamSheetHeaderThemeData from stream_core_flutter.
• Re-exported showStreamSheet, StreamSheet, StreamSheetDragHandle, StreamSheetRoute, StreamSheetTransition, StreamSheetScrollableWidgetBuilder, StreamSheetTheme and StreamSheetThemeData from stream_core_flutter. Poll sheets (StreamPollOptionsSheet, StreamPollResultsSheet, StreamPollOptionVotesSheet, StreamPollCommentsSheet, StreamPollCreatorSheet) now present as Stream-styled modal bottom sheets via showStreamSheet. See migrations/redesign/attachments_and_polls.md.
• Re-exported StreamMessageAttachment and StreamMessageAttachmentStyle from stream_core_flutter.
• Added a BoxFit? fit parameter to ThumbnailSizeCalculator.calculate (null defaults to BoxFit.scaleDown, matching paintImage) so callers using cover / fill get a bitmap large enough to render without upscale blur.
• Added Translations.totalVoteCountLabel({int? count}), viewAllLabel, pollVotesLabel, endVoteConfirmationMessage and questionLabel({bool isPlural = false}).
• Added Translations.reactionsCountText(int count) for the reaction-detail sheet header.
• Added StreamChannelListTile.isPinned — renders a pin icon alongside the existing mute icon for pinned channels.
• Exported StreamScrollViewLoadMoreError and StreamScrollViewLoadMoreIndicator from the public API.
• Exported StreamTimestamp, DateFormatter, formatDate and formatRecentDateTime from the public API.
• Added DateTimeComparisonUtils extension on DateTime (isToday, isYesterday, isWithinLastMinute, isWithinLastWeek, isInSameYear, isSame(other, unit:)) and the DateTimeUnit enum (year / month / day / hour / minute / second / millisecond / microsecond). All getters compare in local time and read the current instant via package:clock, so they're testable under withClock(...).

🔄 Changed

• Widened share_plus to >=12.0.2 <14.0.0 so apps can adopt the latest major. Raised minimum versions of bundled UI/media dependencies (cached_network_image, chewie, desktop_drop, diacritic, file_selector, flutter_markdown, flutter_svg, gal, image_picker, image_size_getter, jiffy, just_audio, lottie, media_kit, media_kit_video, photo_manager, url_launcher, video_player) to current resolved versions.
• Changed the default StreamChat.backgroundKeepAlive from 1 minute to 15 seconds, matching StreamChatCore. See stream_chat_flutter_core changelog for rationale.
• StreamPhotoGalleryTile now auto-sizes the platform thumbnail request from the tile's layout × DPR (132px fallback) instead of always asking for 400×400, so cells decode only what they paint. Pass an explicit thumbnailSize to override.
• formatRecentDateTime reworked to a five-state cascade matching the Figma design system: Just now (< 1 min) / Today at H:mm / Yesterday at H:mm / Weekday at H:mm (within the last week) / MMM do at H:mm (older). Previously emitted formatDate-style output with the time appended.

🐞 Fixed

• Set supported emojis for the reaction picker and detail sheet to the full set of supported emojis from stream_core_flutter.
• Fixed StreamCommandAutocompleteOptions and StreamMentionAutocompleteOptions expanding to half the screen height — both now cap at a fixed max height (208px / 176px) and scroll internally so the list can't dominate the screen or overlap the header.
• Fixed the "Add an option" button in the poll creator looking like a tappable empty option row while disabled. The button is now hidden when adding a new option isn't allowed (an existing option is empty, or the maximum has been reached) instead of rendering as a disabled lookalike.
• Fixed voice recording duration label jumping by ~1 second when playback starts. The recording timer tracks duration in whole seconds, so the stored value can be up to 1 second longer than the actual audio file. The player now resolves this by keeping the larger of the stored and player-reported durations, matching the strategy used by the iOS SDK.
• Fixed voice message time label displaying elapsed time instead of remaining time.
• Fixed RTL layout for the scroll-to-bottom button, swipe-to-reply icon, and voice recording lock button.
• Fixed draft stream updates clobbering the composer while editing a message.
• Fixed retries of in-flight sends being routed through updateMessage instead of sendMessage.
• Fixed composer attachment button staying rotated at 45° after the inline picker was dismissed.
• Fixed composer focus being lost after selecting a command from the attachment picker.
• Fixed gallery attachment picker empty placeholder using an oversized icon.
• Fixed gallery attachment picker permission placeholder not being centered and inconsistent grid and "add more" tile spacing.
• Fixed EndOfFrameCallbackWidget showing a generic error string when its callback throws.
• Fixed unintended Material ink ripple on message tap.
• Standardised empty and error states across channel, thread, draft, member, user, message search, poll vote, reaction and photo gallery scroll views.
• Standardised list separators across thread, draft, member, user and message search scroll views to match the channel scroll view.
• Fixed StreamPhotoGalleryTile missing rounded corners and its badges not mirroring in RTL.
• Fixed the "thread reply" action showing on parent messages while already inside their thread view.
• Fixed poll vote progress bars re-animating from zero whenever the poll message was re-mounted in the message list (e.g. on jump-to-message, scrolling, or after new messages were sent).
• Voice recording playback now pauses automatically when the app moves to the background.
• Fixed voice recording playback resetting on the first tap after the app returned from the background. StreamVoiceRecordingAttachmentPlaylist.didUpdateWidget now compares the projected playlist (content-based equality on track uri / title / duration / waveform) instead of the raw Attachment list, so re-syncs that mint fresh client-side Attachment UUIDs no longer trip a needless updatePlaylist() mid-playback.
• Fixed PollAddCommentDialog and PollSuggestOptionDialog accepting whitespace-only or unchanged submissions; the confirm action now disables when the trimmed text is empty or matches the initial value.
• Fixed StreamPhotoGalleryTile using a hand-rolled icon as its loading placeholder and silently rendering nothing on decode failure. Now uses the shared StreamImageLoadingPlaceholder while loading and StreamImageErrorPlaceholder if the thumbnail fails to load.
• Fixed poll, attachment-action, and message-action dialog buttons rendering their labels in uppercase (e.g. CANCEL, SEND, FLAG, DELETE); they now use the localized labels as-is so they match the rest of the system.
• Fixed tapping a quoted parent message inside a thread doing nothing (or kicking back to the channel). The thread message list now resolves the parent slot directly and scrolls/highlights it instead of falling through to loadChannelAtMessage.
• Fixed the jump-to-message highlight starting before the scroll settled, which made the fade barely visible (or invisible if the target hadn't been mounted yet). The message list now awaits the scroll, then plays a 1s hold + 1s ease-out fade — closer to the highlight feel in Slack's permalink jump.

🛑️ Breaking

• SDK Redesign Changes. For more details, please refer to the migration guide. The SDK redesign introduces a fresher default UI, but also better APIs for customization of the components.

🐞 Fixed

• Fixed ScrollablePositionedList.scrollTo taking the long-distance teleport path when called immediately after mount (before itemPositions had been published). It now waits one frame for layout, then animates the real pixel distance.
• Fixed StreamMessageListView not auto-scrolling to the bottom on the user's own outgoing message until the server confirmed it.
• Fixed StreamMessageListView tripping A RenderViewport exceeded its maximum number of layout cycles under mid-list anchored layout. ScrollablePositionedList now preserves the scroll offset across reanchors instead of resetting it to 0.
• Fixed RenderBox was not laid out thrown by MessageCard._updateWidthLimit when the attachments subtree was detached between scheduling the post-frame callback and it firing (e.g. the list was rebuilt or the message removed). Added a hasSize guard before reading RenderBox.size.

🚀 Improved

• ScrollablePositionedList.padding now accepts EdgeInsetsGeometry (resolved against Directionality), and scrollTo lands the target at the content-area edge by adjusting for leading padding.
• StreamChat.of now resolves via StreamStateScope instead of findAncestorStateOfType, replacing an O(tree-depth) element walk with an O(1) inherited-widget lookup. Callers and behavior are unchanged.

✅ Added

• StreamMessageListView now accepts maximumMessageLimit to cap the loaded message list. See MessageListCore for the trim semantics.

🐞 Fixed

• Fixed StreamMessageListView thread page crashing with StateError when the parent message was no longer present in the channel's loaded messages (e.g. filtered, shadowed, or paginated out). The thread now falls back to the captured parent message in that case.

🚀 Improved

• StreamMessageListView's markRead / markThreadRead now fire on the leading edge of their 1s debounce window, so the first read receipt after entering a channel or sending a message hits the server immediately instead of waiting for the trailing edge. The redundant local unreadCount = 0 short-circuit on own-message send was removed — the leading-edge mark plus readStream updates now keep the unread badge in sync without an extra setState.