feat(ui): channel page and floating UI

docs/docs_screenshots/pubspec.yaml

@@ -22,7 +22,7 @@ dependencies:
   stream_core_flutter:
     git:
       url: https://github.com/GetStream/stream-core-flutter.git
-      ref: 3ba1a36b6a3d9d3a194ccb8f0deaf4d69c5842eb
+      ref: c4308b3a2ea286483fc24c09c0168b10ad9de8a8
       path: packages/stream_core_flutter
 
 dev_dependencies:

docs/docs_screenshots/test/src/mocks.dart

@@ -137,7 +137,7 @@ void setupMockChannel({
   ).thenAnswer((_) => Stream.value(DateTime.parse('2020-06-22 12:00:00')));
   when(() => channel.state).thenReturn(channelState);
   when(() => channel.client).thenReturn(client);
-  when(() => channel.config).thenReturn(ChannelConfig(mutes: true));
+  when(() => channel.config).thenReturn(ChannelConfig(mutes: true, replies: true));
   when(channel.getRemainingCooldown).thenReturn(0);
   when(() => channel.getRemainingCooldown(lastMessageAt: any(named: 'lastMessageAt'))).thenReturn(0);
   when(() => channel.isDistinct).thenReturn(false);

melos.yaml

@@ -107,7 +107,7 @@ command:
       stream_core_flutter:
         git:
           url: https://github.com/GetStream/stream-core-flutter.git
-          ref: 3ba1a36b6a3d9d3a194ccb8f0deaf4d69c5842eb
+          ref: c4308b3a2ea286483fc24c09c0168b10ad9de8a8
           path: packages/stream_core_flutter
       stream_thumbnail: ^0.1.0
       synchronized: ^3.4.0

packages/stream_chat_flutter/CHANGELOG.md

@@ -1,7 +1,22 @@
 ## Upcoming
 
+⚠️ Changed
+
+- `StreamPhotoGallery` now defaults its `padding` to the bottom safe-area inset instead of no padding, so the last row clears the home indicator. Pass an explicit `padding` to opt out.
+- `StreamMessageListView.config` is now nullable (`StreamMessageListViewConfiguration?`) instead of defaulting to `const StreamMessageListViewConfiguration()`. Passing a value is unchanged; code that *reads* `config` off a `StreamMessageListView` instance now gets a nullable value.
+- `StreamMediaGalleryPreview` chrome now follows the app style — when floating, the header and footer float over full-bleed media and the footer's share / gallery buttons outline + elevate to match the back button; when regular, the chrome is docked and the media is inset between the bars.
+
 ✅ Added
 
+- Added `StreamChannelPage` — a ready-to-use channel page widget that wires up `StreamChannelHeader`, `StreamMessageListView`, and `StreamMessageComposer` with floating or docked layout driven by the active app style.
+- Added `StreamThreadPage` — a ready-to-use thread page widget with the same floating/docked layout support, plus an `onBackPressed` callback that replaces the header back button's default pop.
+- Added `onBackPressed` to `StreamChannelHeader` and `StreamThreadHeader` — replaces the default back button's `Navigator.maybePop` without rebuilding the whole `leading`, so callers keep the header's default unread badge. Ignored when `leading` is supplied.
+- Added `MessageComposerProps.surfaceStyle` (a `StreamSurfaceStyle`) — explicitly controls whether `StreamMessageComposer` renders `floating` or `regular`. When null it falls back to `StreamMessageComposerThemeData.surfaceStyle`, and then to the ambient `StreamSurfaceStyle`.
+- Added `StreamMessageComposerTheme` and `StreamMessageComposerThemeData` — a component theme for the composer, also available globally as `StreamChatThemeData.messageComposerTheme`.
+- Added `StreamMessageListView.config` — accepts an explicit `StreamMessageListViewConfiguration` per widget; falls back to `StreamChatConfigurationData.messageListViewConfiguration` from the nearest ancestor when omitted.
+- Added an `isFloating` parameter to `StreamBackButton`, controlling floating vs pinned back-button appearance. Falls back to `StreamAppBarTheme`, and then to the ambient `StreamSurfaceStyle`, when null. `StreamChannelHeader`, `StreamChannelListHeader`, and `StreamThreadHeader` now apply their per-header theme (`channelHeaderTheme` / `channelListHeaderTheme` / `threadHeaderTheme`) as a `StreamAppBarTheme` and pass `style` to the bar, which republishes its resolved behavior to its slots — so every slot in the bar — the default avatar's drop shadow, the default back button, and any `leading`/`trailing` the caller supplies — resolves the same chain the bar itself uses: `style`, then the per-header theme, then the ambient `StreamAppBarTheme`, then `StreamSurfaceStyle`.
+- Added `messageListViewConfiguration` field to `StreamChatConfigurationData`, allowing a global `StreamMessageListViewConfiguration` default for all `StreamMessageListView` widgets. Pass it via `StreamChat.configData` to configure behaviors like `swipeToReply` and `highlightInitialMessage` app-wide without wiring them per-page.
+- Re-exported `StreamScaffold`, `StreamScaffoldInsets`, `StreamBottomNavBar`, `StreamBottomNavBarItem`, `StreamSurfaceStyle`, and `streamFloatingFadeLinearGradient` from `stream_core_flutter` via `package:stream_chat_flutter/stream_chat_flutter.dart`.
 - 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.
@@ -22,6 +37,8 @@
 - 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 scroll-to-bottom button in thread views 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. Note that thread views now show the button at all: it follows `showScrollToBottom` from the effective `StreamMessageListViewConfiguration`, so set that to `false` to restore the previous always-hidden behavior.
 - Fixed the `StreamBackButton` unread badge including the currently open channel in its total count.
 - 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](https://github.com/GetStream/stream-chat-flutter/issues/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.

packages/stream_chat_flutter/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme.backup

@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1510"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

packages/stream_chat_flutter/lib/scrollable_positioned_list/src/item_positions_listener.dart

@@ -24,6 +24,8 @@ class ItemPosition {
     required this.index,
     required this.itemLeadingEdge,
     required this.itemTrailingEdge,
+    this.contentLeadingEdge,
+    this.contentTrailingEdge,
   });
 
   /// Index of the item.
@@ -41,19 +43,43 @@ class ItemPosition {
   /// May be greater than one if the item is partially visible.
   final double itemTrailingEdge;
 
+  /// Distance in proportion of the visible content's main axis length from the
+  /// leading edge of that content to the leading edge of the item.
+  ///
+  /// The visible content is the area inside the list's padding. Consider using
+  /// this for overlays inside that area, such as under a floating bar; scroll
+  /// logic keeps using [itemLeadingEdge]. Equal to [itemLeadingEdge] when the list has no
+  /// inset, and `null` only when the source omits it (a list always provides
+  /// it).
+  final double? contentLeadingEdge;
+
+  /// Distance in proportion of the visible content's main axis length from the
+  /// leading edge of that content to the trailing edge of the item.
+  ///
+  /// See [contentLeadingEdge].
+  final double? contentTrailingEdge;
+
   @override
   bool operator ==(Object other) =>
       identical(this, other) ||
       other is ItemPosition &&
           runtimeType == other.runtimeType &&
           index == other.index &&
           itemLeadingEdge == other.itemLeadingEdge &&
-          itemTrailingEdge == other.itemTrailingEdge;
+          itemTrailingEdge == other.itemTrailingEdge &&
+          contentLeadingEdge == other.contentLeadingEdge &&
+          contentTrailingEdge == other.contentTrailingEdge;
 
   @override
-  int get hashCode => 31 * (31 * (index.hashCode + 7) + itemLeadingEdge.hashCode) + itemTrailingEdge.hashCode;
+  int get hashCode => Object.hash(
+    index,
+    itemLeadingEdge,
+    itemTrailingEdge,
+    contentLeadingEdge,
+    contentTrailingEdge,
+  );
 
   @override
   String toString() =>
-      '''ItemPosition(index: $index, itemLeadingEdge: $itemLeadingEdge, itemTrailingEdge: $itemTrailingEdge)''';
+      '''ItemPosition(index: $index, itemLeadingEdge: $itemLeadingEdge, itemTrailingEdge: $itemTrailingEdge, contentLeadingEdge: $contentLeadingEdge, contentTrailingEdge: $contentTrailingEdge)''';
 }

packages/stream_chat_flutter/lib/scrollable_positioned_list/src/positioned_list.dart

@@ -336,7 +336,7 @@ class _PositionedListState extends State<PositionedList> {
   @override
   Widget build(BuildContext context) {
     _rebuildKeyIndexMap();
-    return RegistryWidget(
+    Widget list = RegistryWidget(
       elementNotifier: registeredElements,
       child: UnboundedCustomScrollView(
         anchor: widget.alignment,
@@ -409,6 +409,23 @@ class _PositionedListState extends State<PositionedList> {
         ],
       ),
     );
+
+    // Match BoxScrollView: when the main-axis MediaQuery padding was
+    // auto-consumed (no explicit padding), strip it from descendants so nested
+    // widgets and scrollables don't inset for it a second time.
+    final mediaQuery = MediaQuery.maybeOf(context);
+    if (widget.padding == null && mediaQuery != null) {
+      list = MediaQuery(
+        data: mediaQuery.copyWith(
+          padding: widget.scrollDirection == Axis.vertical
+              ? mediaQuery.padding.copyWith(top: 0, bottom: 0)
+              : mediaQuery.padding.copyWith(left: 0, right: 0),
+        ),
+        child: list,
+      );
+    }
+
+    return list;
   }
 
   Widget _buildSeparatedListElement(int index) {
@@ -440,8 +457,19 @@ class _PositionedListState extends State<PositionedList> {
     );
   }
 
-  EdgeInsets get _resolvedPadding =>
-      widget.padding?.resolve(Directionality.maybeOf(context) ?? TextDirection.ltr) ?? EdgeInsets.zero;
+  EdgeInsets get _resolvedPadding {
+    final padding = widget.padding;
+    if (padding != null) {
+      return padding.resolve(Directionality.maybeOf(context) ?? TextDirection.ltr);
+    }
+    // Match BoxScrollView: with no explicit padding, consume the main-axis
+    // MediaQuery padding so the list auto-insets like a ListView. The cross-axis
+    // remainder is handed to descendants in [build].
+    final mediaPadding = MediaQuery.maybeOf(context)?.padding ?? EdgeInsets.zero;
+    return widget.scrollDirection == Axis.vertical
+        ? mediaPadding.copyWith(left: 0, right: 0)
+        : mediaPadding.copyWith(top: 0, bottom: 0);
+  }
 
   AxisDirection get _axisDirection {
     if (widget.scrollDirection == Axis.vertical) {
@@ -558,12 +586,22 @@ class _PositionedListState extends State<PositionedList> {
               final reveal = viewport!.getOffsetToReveal(box, 0).offset;
               if (!reveal.isFinite) continue;
               final itemOffset = reveal - viewport.offset.pixels;
+              final viewportDimension = scrollController.position.viewportDimension;
+              // content* edges are measured from the visible content (inside the
+              // padding) so overlays under a floating bar can key off 0..1;
+              // subtract the leading padding (the bottom when reversed, which
+              // `_leadingSliverPadding` resolves). item* stays viewport-relative
+              // for scroll mechanics (alignment / anchor preservation).
+              final leadingPad = _leadingSliverPadding.vertical;
+              final contentExtent = viewportDimension - _resolvedPadding.vertical;
+              final contentDenom = contentExtent > 0 ? contentExtent : viewportDimension;
               positions.add(
                 ItemPosition(
                   index: key.index,
-                  itemLeadingEdge: itemOffset.round() / scrollController.position.viewportDimension,
-                  itemTrailingEdge:
-                      (itemOffset + box.size.height).round() / scrollController.position.viewportDimension,
+                  itemLeadingEdge: itemOffset.round() / viewportDimension,
+                  itemTrailingEdge: (itemOffset + box.size.height).round() / viewportDimension,
+                  contentLeadingEdge: (itemOffset - leadingPad).round() / contentDenom,
+                  contentTrailingEdge: (itemOffset + box.size.height - leadingPad).round() / contentDenom,
                 ),
               );
             } else {
@@ -574,11 +612,18 @@ class _PositionedListState extends State<PositionedList> {
               final isRight = _axisDirection == AxisDirection.right;
               final leadingPx = isRight ? itemOffset : viewportDimension - (itemOffset + box.size.width);
               final trailingPx = isRight ? itemOffset + box.size.width : viewportDimension - itemOffset;
+              // content* edges (see the vertical branch): drop the leading
+              // padding so 0..1 spans the visible content.
+              final leadingPad = _leadingSliverPadding.horizontal;
+              final contentExtent = viewportDimension - _resolvedPadding.horizontal;
+              final contentDenom = contentExtent > 0 ? contentExtent : viewportDimension;
               positions.add(
                 ItemPosition(
                   index: key.index,
                   itemLeadingEdge: leadingPx.round() / viewportDimension,
                   itemTrailingEdge: trailingPx.round() / viewportDimension,
+                  contentLeadingEdge: (leadingPx - leadingPad).round() / contentDenom,
+                  contentTrailingEdge: (trailingPx - leadingPad).round() / contentDenom,
                 ),
               );
             }