upgrade to flutter 3.37

Author: g-apparence

CHANGELOG.md

@@ -1,3 +1,47 @@
+## [2.0.0]
+
+**Breaking** — bart now builds on the `material_ui` / `cupertino_ui` packages
+instead of `package:flutter/material.dart` and `package:flutter/cupertino.dart`,
+following the Flutter 3.44+ split of Material and Cupertino out of the framework.
+
+### Why this is breaking
+
+The Flutter SDK still ships its own complete Material library, so
+`flutter/src/material/material.dart#Material` and
+`material_ui/src/material.dart#Material` are two *distinct* Dart types that both
+print as `Material`. Material lookups match on the exact runtime type
+(`debugCheckHasMaterial` uses `findAncestorWidgetOfExactType<Material>`), so a
+`Scaffold` from one library can never satisfy an `InkWell` from the other.
+
+Apps on `material_ui` that mounted a `BartScaffold` therefore hit
+`No Material widget found.` on every `InkWell`, `Ink`, `ListTile`, `TextField`,
+`IconButton`, `Chip`, `TabBar` (and friends) inside a tab — in debug via the
+assertion, and in release too for `Ink`, which resolves `Material.of` during
+build. The same applied one layer down to `CupertinoTabBar`, which needs the
+`CupertinoLocalizations` of whichever cupertino library declares it.
+
+### Migrating
+
+- Your app must now depend on `material_ui` and import
+  `package:material_ui/material_ui.dart` rather than
+  `package:flutter/material.dart`. Mixing the two in one widget tree reproduces
+  the bug in the opposite direction.
+- `enum Theme` is renamed to `enum BartBottomBarStyle`. The old name collided
+  with material_ui's `Theme` widget whenever `package:bart/bart.dart` was
+  imported without a prefix. The `BartBottomBar.material()` / `.material3()` /
+  `.cupertino()` / `.adaptive()` / `.custom()` factories are unchanged, so most
+  apps need no edit here.
+- Minimum constraints raised to Dart 3.12 / Flutter 3.44.
+
+### Also in this release
+
+- Files that never needed Material now import `package:flutter/widgets.dart`
+  directly, so bart no longer leaks a Material dependency into parts of its API
+  that do not use one.
+- Added `test/material_ancestor_test.dart`, which mounts material_ui `InkWell`,
+  `Ink` and `ListTile` inside a bart tab and asserts no Material assertion is
+  raised, plus a Cupertino localizations case. These fail on 1.x and pass on 2.0.0.
+
 ## [1.4.0]
 
 - add BartMenuRoute.bottomBarBuilder isActive property to builder

README.md

@@ -49,13 +49,26 @@
 ### Install the package
 
 ```sh
-flutter pub add bart
+flutter pub add bart material_ui
 ```
 
+Since **2.0.0**, bart builds on the [`material_ui`](https://pub.dev/packages/material_ui)
+and [`cupertino_ui`](https://pub.dev/packages/cupertino_ui) packages rather than
+`package:flutter/material.dart`, following the Flutter 3.44+ split of Material out
+of the framework. Requires Dart 3.12 / Flutter 3.44 or newer.
+
+> **Upgrading from 1.x?** Your app must import `package:material_ui/material_ui.dart`
+> instead of `package:flutter/material.dart`. The SDK still ships its own Material
+> library, and the two `Material` types are *not* interchangeable — mixing them
+> yields a confusing `No Material widget found.` on widgets that plainly sit under a
+> `Scaffold`. See the [CHANGELOG](CHANGELOG.md) for the full rationale.
+> `enum Theme` is also renamed to `enum BartBottomBarStyle`.
+
 ### Import the package
 
 ```dart
 import 'package:bart/bart.dart';
+import 'package:material_ui/material_ui.dart';
 ```
 
 ## 🚀  Get started

analysis_options.yaml

@@ -7,6 +7,15 @@
 
 # The following line activates a set of recommended lints for Flutter apps,
 # packages, and plugins designed to encourage good coding practices.
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
 include: package:flutter_lints/flutter.yaml
 
 linter:

example/analysis_options.yaml

@@ -7,6 +7,15 @@
 
 # The following line activates a set of recommended lints for Flutter apps,
 # packages, and plugins designed to encourage good coding practices.
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
 include: package:flutter_lints/flutter.yaml
 
 linter:

example/lib/main.dart

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

example/lib/navigation.dart

@@ -1,7 +1,7 @@
 import 'package:bart/bart.dart';
 import 'package:example/routes.dart';
 import 'package:example/widgets/simple_bottom_bar.dart';
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 class MainPageMenu extends StatelessWidget {
   const MainPageMenu({Key? key}) : super(key: key);

example/lib/routes.dart

@@ -2,7 +2,7 @@ import 'package:animations/animations.dart';
 import 'package:bart/bart.dart';
 import 'package:example/tabs/fake_list.dart';
 import 'package:example/tabs/page_counter.dart';
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 import 'tabs/home_page.dart';
 

example/lib/tabs/fake_list.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 class FakeListPage extends StatelessWidget {
   const FakeListPage({Key? key}) : super(key: key);

example/lib/tabs/home_page.dart

@@ -1,5 +1,5 @@
 import 'package:bart/bart/bart_bottombar_actions.dart';
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 import 'package:bart/bart.dart';
 

example/lib/tabs/page_counter.dart

@@ -1,5 +1,5 @@
 import 'package:bart/bart/bart_appbar.dart';
-import 'package:flutter/material.dart';
+import 'package:material_ui/material_ui.dart';
 
 class PageFakeCounter extends StatefulWidget {
   final bool showAppBar;