From 514de82c1e1ae40863583daec0c0965b5c901f2f Mon Sep 17 00:00:00 2001 From: Qun Cheng <36861262+QuncCccccc@users.noreply.github.com> Date: Tue, 21 Jul 2026 15:46:36 -0700 Subject: [PATCH 1/5] Add Material style variant enum (#12221) Related to https://github.com/orgs/flutter/projects/250 This PR is just to add the `StyleVariant` enum so we can start migrating individual components. ## Pre-Review Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools. - [x] I read the [Tree Hygiene] page, which explains my responsibilities. - [x] I read and followed the [relevant style guides] and ran [the auto-formatter]. - [x] I signed the [CLA]. - [x] The title of the PR starts with the name of the package surrounded by square brackets, e.g. `[shared_preferences]` - [x] I [linked to at least one issue that this PR fixes] in the description above. - [x] I followed [the version and CHANGELOG instructions], using [semantic versioning] and the [repository CHANGELOG style], or I have commented below to indicate which documented exception this PR falls under[^1]. - [x] I updated/added any relevant documentation (doc comments with `///`). - [x] I added new tests to check the change I am making, or I have commented below to indicate which [test exemption] this PR falls under[^1]. - [x] All existing and new tests are passing. --- packages/material_ui/lib/src/theme_data.dart | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/packages/material_ui/lib/src/theme_data.dart b/packages/material_ui/lib/src/theme_data.dart index 3f21a84d69f0..e86b20d4e701 100644 --- a/packages/material_ui/lib/src/theme_data.dart +++ b/packages/material_ui/lib/src/theme_data.dart @@ -194,6 +194,23 @@ enum MaterialTapTargetSize { shrinkWrap, } +/// Defines the Material Design style variant used by Material components. +enum StyleVariant { + /// The Material Design 3 style variant. + material3, + + /// The Material Design 3 Expressive style variant. + /// + /// Material 3 Expressive support is under development. Apps or components + /// that opt into this variant may see visual changes as more Expressive + /// features get added. + /// + /// See also: + /// + /// * the [Material Design 3 Expressive updates](https://m3.material.io/#9f2db05b-ebbb-47c2-892d-1cca35afa386) for design guidelines. + material3Expressive, +} + /// Defines the configuration of the overall visual [Theme] for a [MaterialApp] /// or a widget subtree within the app. /// From a4efb076efda95e655e786b39133a3935ffb1007 Mon Sep 17 00:00:00 2001 From: Elliott Brooks <21270878+elliette@users.noreply.github.com> Date: Tue, 1 Sep 2026 15:00:40 -0700 Subject: [PATCH 2/5] Add CHANGELOG entry --- .../pending_changelogs/change_2026_09_01_1788300011018.yaml | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml diff --git a/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml new file mode 100644 index 000000000000..68a7d10df95f --- /dev/null +++ b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml @@ -0,0 +1,3 @@ +changelog: | + - Adds the `StyleVariant` enum defining the Material 3 and Material 3 Expressive style variants. +version: skip From ea5254b4f84005b8d232a6902bc188d348d6f5fd Mon Sep 17 00:00:00 2001 From: Elliott Brooks <21270878+elliette@users.noreply.github.com> Date: Tue, 1 Sep 2026 15:03:43 -0700 Subject: [PATCH 3/5] Responded to AI review --- packages/material_ui/lib/src/theme_data.dart | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/material_ui/lib/src/theme_data.dart b/packages/material_ui/lib/src/theme_data.dart index e86b20d4e701..77b6b862de9e 100644 --- a/packages/material_ui/lib/src/theme_data.dart +++ b/packages/material_ui/lib/src/theme_data.dart @@ -207,7 +207,7 @@ enum StyleVariant { /// /// See also: /// - /// * the [Material Design 3 Expressive updates](https://m3.material.io/#9f2db05b-ebbb-47c2-892d-1cca35afa386) for design guidelines. + /// * [Material Design 3 Expressive updates](https://m3.material.io/#9f2db05b-ebbb-47c2-892d-1cca35afa386) for design guidelines. material3Expressive, } From 1b088c6201e99d65e3ce15816cd6f4c539d1e253 Mon Sep 17 00:00:00 2001 From: Elliott Brooks <21270878+elliette@users.noreply.github.com> Date: Wed, 2 Sep 2026 11:43:44 -0700 Subject: [PATCH 4/5] skip -> patch --- .../pending_changelogs/change_2026_09_01_1788300011018.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml index 68a7d10df95f..4dfda923f14c 100644 --- a/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml +++ b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml @@ -1,3 +1,3 @@ changelog: | - Adds the `StyleVariant` enum defining the Material 3 and Material 3 Expressive style variants. -version: skip +version: patch From 9fdb3d2900c873ce2718dd84f20b0d4942084a6c Mon Sep 17 00:00:00 2001 From: Elliott Brooks <21270878+elliette@users.noreply.github.com> Date: Wed, 2 Sep 2026 11:49:58 -0700 Subject: [PATCH 5/5] patch -> minor --- .../pending_changelogs/change_2026_09_01_1788300011018.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml index 4dfda923f14c..2ebcd33fdc41 100644 --- a/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml +++ b/packages/material_ui/pending_changelogs/change_2026_09_01_1788300011018.yaml @@ -1,3 +1,3 @@ changelog: | - Adds the `StyleVariant` enum defining the Material 3 and Material 3 Expressive style variants. -version: patch +version: minor