Add effective text style selectors

lib/src/spot/effective/effective_text.dart

@@ -3,6 +3,9 @@ import 'package:spot/spot.dart';
 import 'package:spot/src/spot/element_extensions.dart';
 import 'package:spot/src/spot/selectors.dart';
 
+/// Matchers for the [Text] widget to make assertions about:
+/// - [Text.maxLines]
+/// - [Text.textStyle]
 extension EffectiveTextMatcher on WidgetMatcher<Text> {
   /// Matches the [Text] widget when it has the given [maxLines].
   ///
@@ -20,6 +23,7 @@ extension EffectiveTextMatcher on WidgetMatcher<Text> {
     );
   }
 
+  /// Matches the [Text] widget for given maxLines.
   WidgetMatcher<Text> hasEffectiveMaxLines(int? value) {
     return hasEffectiveMaxLinesWhere((it) {
       if (value == null) {
@@ -30,6 +34,7 @@ extension EffectiveTextMatcher on WidgetMatcher<Text> {
     });
   }
 
+  /// Matches the [Text] widget when it has the given [TextStyle].
   WidgetMatcher<Text> hasEffectiveTextStyleWhere(MatchProp<TextStyle> match) {
     return hasProp(
       elementSelector: (subject) => subject.context.nest<TextStyle?>(
@@ -82,7 +87,11 @@ extension TextStyleSubject on Subject<TextStyle> {
   }
 }
 
+/// Selectors for the [Text] widget like
+/// - [Text.maxLines]
+/// - [Text.textStyle]
 extension EffectiveTextSelector on WidgetSelector<Text> {
+  /// Selects the [Text] widget where given `maxLines` properties match.
   WidgetSelector<Text> withEffectiveMaxLinesMatching(MatchProp<int?> match) {
     return withProp(
       elementSelector: (subject) => subject.context.nest<int?>(
@@ -93,9 +102,34 @@ extension EffectiveTextSelector on WidgetSelector<Text> {
     );
   }
 
+  /// Selects a [Text] widget with given `maxLines`.
   WidgetSelector<Text> withEffectiveMaxLines(int? value) {
     return withEffectiveMaxLinesMatching((it) => it.equals(value));
   }
+
+  /// Selects the [Text] widget where given [TextStyle] properties match.
+  WidgetSelector<Text> withEffectiveTextStyleMatching(
+    MatchProp<TextStyle> match,
+  ) {
+    return withProp(
+      elementSelector: (subject) => subject.context.nest<TextStyle>(
+        () => ['with "textStyle"'],
+        (Element element) => Extracted.value(_extractTextStyle(element)),
+      ),
+      match: match,
+    );
+  }
+
+  /// Selects a [Text] widget with a given [TextStyle].
+  WidgetSelector<Text> withEffectiveTextStyle(TextStyle? value) {
+    return withEffectiveTextStyleMatching((it) {
+      if (value == null) {
+        it.isNull();
+      } else {
+        it.equals(value);
+      }
+    });
+  }
 }
 
 int? _extractMaxLines(Element element) {

test/widgets/effective_text_test.dart

@@ -223,5 +223,94 @@ void main() {
         ]),
       );
     });
+
+    testWidgets(
+      'Select with TextStyle',
+      (widgetTester) async {
+        final style = TextStyle(
+          fontSize: 20,
+          fontStyle: FontStyle.italic,
+          fontWeight: FontWeight.bold,
+          letterSpacing: 2,
+        );
+
+        await widgetTester.pumpWidget(
+          MaterialApp(
+            home: Column(
+              children: [
+                Text(
+                  'Great Text',
+                  style: TextStyle(fontSize: 20),
+                ),
+                DefaultTextStyle(
+                  style: style,
+                  child: Text('Great Text'),
+                ),
+              ],
+            ),
+          ),
+        );
+
+        // Select with single props
+        spot<Text>().withText('Great Text').withEffectiveTextStyleMatching(
+          (style) {
+            style.fontSize.equals(20);
+            style.fontStyle.equals(FontStyle.italic);
+            style.fontWeight.equals(FontWeight.bold);
+            style.letterSpacing.equals(2);
+          },
+        ).existsOnce();
+
+        // Select with complete TextStyle
+        spot<Text>()
+            .withText('Great Text')
+            .withEffectiveTextStyle(style)
+            .existsOnce();
+      },
+    );
+
+    testWidgets('Failed selection with TextStyle shows missing values',
+        (widgetTester) async {
+      final style = TextStyle(
+        fontSize: 20,
+        fontStyle: FontStyle.italic,
+        fontWeight: FontWeight.bold,
+        letterSpacing: 2,
+      );
+
+      await widgetTester.pumpWidget(
+        MaterialApp(
+          home: DefaultTextStyle(
+            style: style,
+            child: Text('Great Text'),
+          ),
+        ),
+      );
+
+      expect(
+        () =>
+            spot<Text>().withText('Great Text').withEffectiveTextStyleMatching(
+          (style) {
+            style.fontSize.equals(20);
+            style.fontStyle.equals(FontStyle.normal);
+            style.fontWeight.equals(FontWeight.bold);
+            style.letterSpacing.equals(2);
+          },
+        ).existsOnce(),
+        throwsSpotErrorContaining([
+          'with "textStyle" that: has fontSize that: equals <20.0> has fontStyle that: equals <FontStyle.normal> has fontWeight that: equals <FontWeight.w700> has letterSpacing that: equals <2.0>',
+        ]),
+      );
+
+      expect(
+        () => spot<Text>()
+            .withText('Great Text')
+            .withEffectiveTextStyle(style.copyWith(fontStyle: FontStyle.normal))
+            .existsOnce(),
+        throwsSpotErrorContaining([
+          'with "textStyle" that: equals <TextStyle(inherit: true, size: 20.0, weight: 700, style: normal, letterSpacing: 2.0)>',
+        ]),
+      );
+    });
   });
 }