Repository: flutter/flutter
File: packages/flutter/lib/src/material/date_picker_theme.dart (Dart)

Code before:
  /// Overrides the default text style used for each individual day
  /// label in the grid of the date picker.
  ///
  /// The [TextStyle.color] of the [dayStyle] is not used,
  /// [dayForegroundColor] is used instead.
  final TextStyle? dayStyle;

  /// Overrides the default color used to paint the day labels in the
  /// grid of the date picker.
  ///
  /// This will be used instead of the color provided in [dayStyle].
  ///
  /// This supports different colors based on the [WidgetState]s of
  /// the day button, such as [WidgetState.selected], [WidgetState.hovered],
  /// [WidgetState.focused], and [WidgetState.disabled].
  ///
  /// ```dart
  /// dayBackgroundColor: WidgetStateProperty.resolveWith((Set<WidgetState> states) {
  ///   if (states.contains(WidgetState.selected)) {
  ///     return Theme.of(context).colorScheme.primary;
  ///   }
  ///   return Colors.transparent;
  /// })
  /// ```
  final WidgetStateProperty<Color?>? dayForegroundColor;

  /// Overrides the default color used to paint the background of the
  /// day labels in the grid of the date picker.
  ///
  /// This supports different colors based on the [WidgetState]s of
  /// the day button, such as [WidgetState.selected], [WidgetState.hovered],
  /// [WidgetState.focused], and [WidgetState.disabled].
  ///
  /// ```dart
  /// dayBackgroundColor: WidgetStateProperty.resolveWith((Set<WidgetState> states) {
  ///   if (states.contains(WidgetState.selected)) {
  ///     return Theme.of(context).colorScheme.primary;
  ///   }
  ///   return Colors.transparent;
  /// })
  /// ```
  final WidgetStateProperty<Color?>? dayBackgroundColor;

  /// Overrides the default highlight color that's typically used to
  /// indicate that a day in the grid is focused, hovered, or pressed.
  ///
  /// This supports different colors based on the [WidgetState]s of
  /// the day button. The overlay color is usually used with an opacity to
  /// create hover, focus, and press effects.
  ///
  /// ```dart

Review comment (suggestion):
Should probably include a comment that mentions dayOverlayColor. Maybe something like this at the bottom:

```dart 
See also:
  * [dayOverlayColor] which applies an overlay over the day labels depending on the [WidgetState].
```
Or a comment up above.

Code after:
  final TextStyle? weekdayStyle;

  /// Overrides the default text style used for each individual day
  /// label in the grid of the date picker.
  ///
  /// The [TextStyle.color] of the [dayStyle] is not used,
  /// [dayForegroundColor] is used instead.
  final TextStyle? dayStyle;

  /// Overrides the default color used to paint the day labels in the
  /// grid of the date picker.
  ///
  /// This will be used instead of the color provided in [dayStyle].
  ///
  /// This supports different colors based on the [WidgetState]s of
  /// the day button, such as `WidgetState.selected`, `WidgetState.hovered`,
  /// `WidgetState.focused`, and `WidgetState.disabled`.
  ///
  /// ```dart
  /// dayBackgroundColor: WidgetStateProperty.resolveWith((Set<WidgetState> states) {
  ///   if (states.contains(WidgetState.selected)) {
  ///     return Theme.of(context).colorScheme.primary;
  ///   }
  ///   return null; // Use the default color.
  /// })
  /// ```
  ///
  /// See also:
  ///   * [dayOverlayColor] which applies an overlay over the day labels depending on the [WidgetState].
  final WidgetStateProperty<Color?>? dayForegroundColor;

  /// Overrides the default color used to paint the background of the
  /// day labels in the grid of the date picker.
  ///
  /// This supports different colors based on the [WidgetState]s of
  /// the day button, such as `WidgetState.selected`, `WidgetState.hovered`,
  /// `WidgetState.focused`, and `WidgetState.disabled`.
  ///
  /// ```dart
  /// dayBackgroundColor: WidgetStateProperty.resolveWith((Set<WidgetState> states) {
  ///   if (states.contains(WidgetState.selected)) {
  ///     return Theme.of(context).colorScheme.primary;
  ///   }
  ///   return null; // Use the default color.
  /// })
  /// ```
  /// See also:
  ///   * [dayOverlayColor] which applies an overlay over the day labels depending on the [WidgetState].
  final WidgetStateProperty<Color?>? dayBackgroundColor;

  /// Overrides the default highlight color that's typically used to