chore(ui)!: migrate to material_ui and cupertino_ui

.github/workflows/legacy_version_analyze.yml

@@ -3,7 +3,7 @@ name: legacy_version_analyze
 env:
   # Note: The versions below should be manually updated after a new stable
   # version comes out.
-  flutter_version: "3.38.10"
+  flutter_version: "3.44.0"
 
 on:
   push:

STYLE_GUIDE.md

@@ -65,6 +65,9 @@ document; the section link is provided.
 - Single quotes, **relative imports inside `lib/src/`** (`always_use_package_imports`
   is disabled here — a deliberate divergence from Flutter's style, favouring
   refactor-friendly relative paths inside the package).
+- Material and Cupertino come from `package:material_ui/material_ui.dart` and
+  `package:cupertino_ui/cupertino_ui.dart`, never `package:flutter/material.dart` —
+  the two sets of types are unrelated. `migrate_design_widgets` enforces this.
 - Trailing commas preserved, `const` wherever possible, `final` for locals that
   aren't reassigned.
 - Prefer named parameters for booleans (`avoid_positional_boolean_parameters`).
@@ -626,10 +629,18 @@ import '../../theme/components/stream_avatar_theme.dart';
 import '../common/stream_network_image.dart';
 
 // GOOD — package: for external and cross-package imports.
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core/stream_core.dart';
 ```
 
+Flutter split Material and Cupertino out of the framework, so
+`package:flutter/material.dart` and `package:material_ui/material_ui.dart` declare
+*different* `ThemeData`, `ThemeExtension` and widget types that cannot be passed to
+one another. Always import `material_ui`. The `migrate_design_widgets` lint fails the
+build on the old URI; the only exceptions are the prefixed bridges that adapt a value
+for a package which has not migrated yet, each carrying an
+`// ignore: migrate_design_widgets`.
+
 Do not use `package:stream_core_flutter/...` inside `lib/src/` — that path is
 reserved for consumers, and using it internally would round-trip through the public
 barrel (which the `check:barrels` rule also forbids).
@@ -1352,12 +1363,21 @@ sub-headings:
 
 - Fixed a crash when opening the media viewer with an empty attachments list.
 
+### 🔄 Changed
+
+- Raised the minimum Flutter version to `>=3.44.0` and the Dart SDK to `^3.12.0`.
+
 ### 🛑 Breaking / Removals
 
 - Removed `StreamCoreMessageComposer`. Use `StreamMessageComposer` from
   `stream_chat_flutter` instead.
 ```
 
+`### 🔄 Changed` covers what is neither new API nor a fix and does not break
+existing code — a raised minimum Flutter/Dart version, a tightened dependency
+constraint, a changed default. A raised floor is **not** breaking: code keeps
+compiling, older SDKs simply stop resolving the new version.
+
 Prefer **one short bullet** per entry, describing the functional change. Longer
 entries are acceptable for user-visible multi-facet features where the extra
 context matters to someone deciding whether to upgrade — but avoid sub-bullets,

all_lint_rules.yaml

@@ -92,6 +92,7 @@ linter:
     - literal_only_boolean_expressions
     - matching_super_parameters
     - missing_code_block_language_in_doc_comment
+    - migrate_design_widgets
     - missing_whitespace_between_adjacent_strings
     - no_adjacent_strings_in_list
     - no_default_cases

apps/design_system_gallery/AGENTS.md

@@ -222,7 +222,7 @@ When modifying `ThemeConfiguration`, ensure `buildMaterialTheme()` stays updated
 Create a new file in `lib/components/`:
 
 ```dart
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/stream_core_flutter.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/app/gallery_app.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:provider/provider.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;
 
@@ -49,6 +49,14 @@ class _StreamDesignSystemGalleryState extends State<StreamDesignSystemGallery> {
             theme: materialTheme,
             darkTheme: materialTheme,
             themeMode: isDark ? .dark : .light,
+            // Maps the theme and localizations into Flutter's Material for the
+            // dependencies still built on it — Widgetbook, DeviceFrame, the
+            // colour picker — which would otherwise resolve stock defaults.
+            //
+            // TODO(material-ui): drop as each dependency migrates.
+            // https://linear.app/stream/issue/flu-698
+            // ignore: deprecated_member_use
+            builder: (context, child) => MaterialUiCompatibilityBridge(child: child!),
             home: GalleryShell(
               showThemePanel: _showThemePanel,
               onToggleThemePanel: () => setState(() => _showThemePanel = !_showThemePanel),

apps/design_system_gallery/lib/app/gallery_shell.dart

@@ -1,7 +1,11 @@
-import 'package:flutter/material.dart';
+// ignore: migrate_design_widgets
+import 'package:flutter/material.dart' as legacy;
+import 'package:material_ui/material_ui.dart';
+import 'package:provider/provider.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 
+import '../config/theme_configuration.dart';
 import '../core/preview_wrapper.dart';
 import '../widgets/theme_studio/theme_customization_panel.dart';
 import '../widgets/toolbar/toolbar.dart';
@@ -30,17 +34,24 @@ class GalleryShell extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    final materialTheme = Theme.of(context);
-    final isDark = materialTheme.brightness == .dark;
+    final themeConfig = context.watch<ThemeConfiguration>();
+    // Widgetbook builds its own `MaterialApp.router`, which installs a theme of
+    // its own below the bridge — so the chrome takes the bridged theme by value
+    // rather than by inheritance.
+    //
+    // TODO(material-ui): drop once widgetbook supports material_ui.
+    // https://linear.app/stream/issue/flu-703
+    final widgetbookTheme = legacy.Theme.of(context);
+    final isDark = themeConfig.brightness == .dark;
     final screenWidth = MediaQuery.sizeOf(context).width;
 
     // Use overlay on small screens, side-by-side on large screens
     final widgetbookWidth = showThemePanel ? screenWidth - kThemePanelWidth : screenWidth;
     final useOverlay = widgetbookWidth < kWidgetbookDesktopBreakpoint;
 
     final widgetbook = Widgetbook.material(
-      lightTheme: materialTheme,
-      darkTheme: materialTheme,
+      lightTheme: widgetbookTheme,
+      darkTheme: widgetbookTheme,
       themeMode: isDark ? .dark : .light,
       directories: _collapseDirectories(directories),
       home: const GalleryHomePage(),

apps/design_system_gallery/lib/app/home.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 
 import '../core/stream_icons.dart';

apps/design_system_gallery/lib/components/accessories/stream_audio_waveform.dart

@@ -1,6 +1,6 @@
 import 'dart:math' as math;
 
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/accessories/stream_emoji.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:unicode_emojis/unicode_emojis.dart';
 import 'package:widgetbook/widgetbook.dart';

apps/design_system_gallery/lib/components/accessories/stream_file_type_icons.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/avatar/stream_avatar.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/avatar/stream_avatar_group.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/avatar/stream_avatar_stack.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_badge_count.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_badge_notification.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_error_badge.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_image_source_badge.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_online_indicator.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/badge/stream_retry_badge.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/buttons/button.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/buttons/stream_emoji_button.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:unicode_emojis/unicode_emojis.dart';
 import 'package:widgetbook/widgetbook.dart';

apps/design_system_gallery/lib/components/buttons/stream_jump_to_unread_button.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_checkbox.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_flex.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_intrinsic_flex.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_loading_spinner.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_network_image.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_progress_bar.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_skeleton_loading.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_tap_target_padding.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/common/stream_text_input.dart

@@ -1,5 +1,5 @@
-import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/context_menu/stream_context_menu.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/playback_speed_toggle.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_command_chip.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_emoji_chip.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:unicode_emojis/unicode_emojis.dart';
 import 'package:widgetbook/widgetbook.dart';

apps/design_system_gallery/lib/components/controls/stream_emoji_chip_bar.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_remove_control.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_stepper.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_switch.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/controls/stream_video_play_indicator.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/emoji/stream_emoji_picker_sheet.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/media_viewer/stream_media_viewer.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/core.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_annotation.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_attachment.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_bubble.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_content.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_metadata.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;

apps/design_system_gallery/lib/components/message/stream_message_replies.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 import 'package:stream_core_flutter/chat.dart';
 import 'package:widgetbook/widgetbook.dart';
 import 'package:widgetbook_annotation/widgetbook_annotation.dart' as widgetbook;