Description

Re-attempt #36030, fixing misunderstanding of debugLabel and updating accordingly.

Updates from previous attempt are as follows:

• debugLabel no longer replaces "black" with "white" and vice versa, but instead correctly reflects the history of mutations made to the TextStyle
  https://github.com/flutter/flutter/pull/36856/files#diff-2c8a7ca0f8585eb93a5940b5f832bea5R341
  https://github.com/flutter/flutter/pull/36856/files#diff-2c8a7ca0f8585eb93a5940b5f832bea5R349

• Tests for debugLabel were updated accordingly:
  https://github.com/flutter/flutter/pull/36856/files#diff-0f32d5c2e77a0a6dd50c3e92e9187420R446
  https://github.com/flutter/flutter/pull/36856/files#diff-0f32d5c2e77a0a6dd50c3e92e9187420R472

Note: Screenshot sizes differ because of how I took the screenshots, all tooltips are the same size in these images.

1. Implements a TooltipTheme widget that allows all existing properties to be themeable.

2. Introduces the textStyle property, granting more fine-grained control to developers to update the tooltip's text message.

3. Breaking change: Updating default tooltip decoration to the following:

• Brightness.light

BoxDecoration(
  color: Colors.grey[700].withOpacity(0.9),
  borderRadius: const BorderRadius.all(Radius.circular(4)),
);

• Brightness.dark

BoxDecoration(
  color: Colors.white.withOpacity(0.9), // new
  borderRadius: const BorderRadius.all(Radius.circular(4)),
);

4. Breaking change: Updating default textStyle to the following:

• Brightness.light

theme.textTheme.body1.copyWith(
  color: Colors.white, // new
  debugLabel: theme.textTheme.body1.debugLabel.replaceAll('white', 'black'), // fixes debugLabel
);

• Brightness.dark

theme.textTheme.body1.copyWith(
  color: Colors.black, // new
  debugLabel: theme.textTheme.body1.debugLabel.replaceAll('white', 'black'), // fixes debugLabel
);

Tooltip Before Breaking change:

Tooltip After Breaking change:

Related Issues

Fixes #35513
Related to #33654
Related to #25844

Tests

I added the following tests:

Several tests verifying passing down of TooltipTheme properties (color, location, height, decoration, semantics, show and wait durations to reveal and hide tooltip)
Tests for textStyle implementation
Test to verify debugLabel for light and dark theme

Checklist

Before you create this PR confirm that it meets all requirements listed below by checking the relevant checkboxes ([x]). This will ensure a smooth and quick review process.

• I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
• I signed the [CLA].
• I read and followed the [Flutter Style Guide], including [Features we expect every widget to implement].
• I updated/added relevant documentation (doc comments with ///).
• All existing and new tests are passing.
• The analyzer (flutter analyze --flutter-repo) does not report any problems on my PR.
• I am willing to follow-up on review comments in a timely manner.

Breaking Change

Does your PR require Flutter developers to manually update their apps to accommodate your change?

• Yes, this is a breaking change (Please read [Handling breaking changes]). Replace this with a link to the e-mail where you asked for input on this proposed change.
• No, this is not a breaking change.