feat: Introduce StacTooltipThemeData and parser

packages/stac/lib/src/parsers/theme/stac_theme_parser.dart

@@ -27,6 +27,7 @@ import 'package:stac/src/parsers/theme/stac_scrollbar_theme_data_parser.dart';
 import 'package:stac/src/parsers/theme/stac_snack_bar_theme_data_parser.dart';
 import 'package:stac/src/parsers/theme/stac_tab_bar_theme_data_parser.dart';
 import 'package:stac/src/parsers/theme/stac_text_theme_parser.dart';
+import 'package:stac/src/parsers/theme/stac_tool_tip_theme_data_parser.dart';
 import 'package:stac/src/utils/color_utils.dart';
 import 'package:stac_core/stac_core.dart';
 
@@ -125,7 +126,7 @@ extension StacThemeParser on StacTheme {
       // TextSelectionThemeData? textSelectionTheme,
       // TimePickerThemeData? timePickerTheme,
       // ToggleButtonsThemeData? toggleButtonsTheme,
-      // TooltipThemeData? tooltipTheme,
+      tooltipTheme: tooltipTheme?.parse(context),
     );
   }
 }

packages/stac/lib/src/parsers/theme/stac_tool_tip_theme_data_parser.dart

@@ -0,0 +1,27 @@
+import 'package:flutter/material.dart';
+import 'package:stac/src/parsers/foundation/foundation.dart';
+import 'package:stac_core/stac_core.dart';
+
+/// Parser extension for [StacTooltipThemeData].
+///
+/// Converts [StacTooltipThemeData] to Flutter's [TooltipThemeData].
+extension StacTooltipThemeDataParser on StacTooltipThemeData {
+  TooltipThemeData parse(BuildContext context) {
+    return TooltipThemeData(
+      constraints: constraints?.parse,
+      padding: padding?.parse,
+      margin: margin?.parse,
+      verticalOffset: verticalOffset,
+      preferBelow: preferBelow,
+      excludeFromSemantics: excludeFromSemantics,
+      decoration: decoration?.parse(context),
+      textStyle: textStyle?.parse(context),
+      textAlign: textAlign?.parse,
+      waitDuration: waitDuration?.parse,
+      showDuration: showDuration?.parse,
+      exitDuration: exitDuration?.parse,
+      triggerMode: triggerMode?.parse,
+      enableFeedback: enableFeedback,
+    );
+  }
+}

packages/stac/lib/src/parsers/theme/themes.dart

@@ -26,7 +26,8 @@ export 'package:stac_core/stac_core.dart'
         StacSnackBarThemeData,
         StacTabBarThemeData,
         StacTextTheme,
-        StacTheme;
+        StacTheme,
+        StacTooltipThemeData;
 
 // Export parsers
 export 'stac_app_bar_theme_parser.dart';
@@ -55,3 +56,4 @@ export 'stac_snack_bar_theme_data_parser.dart';
 export 'stac_tab_bar_theme_data_parser.dart';
 export 'stac_text_theme_parser.dart';
 export 'stac_theme_parser.dart';
+export 'stac_tool_tip_theme_data_parser.dart';

packages/stac_core/lib/foundation/theme/stac_theme/stac_theme.dart

@@ -28,6 +28,7 @@ import 'package:stac_core/foundation/theme/stac_scrollbar_theme_data/stac_scroll
 import 'package:stac_core/foundation/theme/stac_snack_bar_theme_data/stac_snack_bar_theme_data.dart';
 import 'package:stac_core/foundation/theme/stac_tab_bar_theme_data/stac_tab_bar_theme_data.dart';
 import 'package:stac_core/foundation/theme/stac_text_theme/stac_text_theme.dart';
+import 'package:stac_core/foundation/theme/stac_tool_tip_theme_data/stac_tool_tip_theme_data.dart';
 
 part 'stac_theme.g.dart';
 
@@ -155,7 +156,7 @@ class StacTheme implements StacElement {
     // TextSelectionThemeData? textSelectionTheme,
     // TimePickerThemeData? timePickerTheme,
     // ToggleButtonsThemeData? toggleButtonsTheme,
-    // TooltipThemeData? tooltipTheme,
+    this.tooltipTheme,
   });
 
   // GENERAL CONFIGURATION
@@ -371,7 +372,9 @@ class StacTheme implements StacElement {
   // TextSelectionThemeData? textSelectionTheme,
   // TimePickerThemeData? timePickerTheme,
   // ToggleButtonsThemeData? toggleButtonsTheme,
-  // TooltipThemeData? tooltipTheme,
+
+  /// The theme for [Tooltip] widgets.
+  final StacTooltipThemeData? tooltipTheme;
 
   /// Creates a [StacTheme] from JSON.
   factory StacTheme.fromJson(Map<String, dynamic> json) =>

packages/stac_core/lib/foundation/theme/stac_tool_tip_theme_data/stac_tool_tip_theme_data.dart

@@ -0,0 +1,102 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:stac_core/stac_core.dart';
+
+part 'stac_tool_tip_theme_data.g.dart';
+
+/// A Stac model representing Flutter's [TooltipThemeData].
+///
+/// Defines default visual and behavioral properties for [Tooltip] widgets.
+///
+/// {@tool snippet}
+/// Dart Example:
+/// ```dart
+/// StacTooltipThemeData(
+///   padding: StacEdgeInsets.all(8),
+///   textStyle: StacTextStyle(color: '#FFFFFF'),
+///   preferBelow: true,
+/// )
+/// ```
+/// {@end-tool}
+///
+/// {@tool snippet}
+/// JSON Example:
+/// ```json
+/// {
+///   "padding": { "all": 8 },
+///   "margin": { "horizontal": 12 },
+///   "verticalOffset": 24,
+///   "preferBelow": true,
+///   "textStyle": { "color": "#FFFFFF", "fontSize": 12 },
+///   "triggerMode": "longPress"
+/// }
+/// ```
+/// {@end-tool}
+@JsonSerializable()
+class StacTooltipThemeData implements StacElement {
+  /// Creates a [StacTooltipThemeData] with the given properties.
+  const StacTooltipThemeData({
+    this.constraints,
+    this.padding,
+    this.margin,
+    this.verticalOffset,
+    this.preferBelow,
+    this.excludeFromSemantics,
+    this.decoration,
+    this.textStyle,
+    this.textAlign,
+    this.waitDuration,
+    this.showDuration,
+    this.exitDuration,
+    this.triggerMode,
+    this.enableFeedback,
+  });
+
+  /// Size constraints for the tooltip.
+  final StacBoxConstraints? constraints;
+
+  /// Padding inside the tooltip.
+  final StacEdgeInsets? padding;
+
+  /// Margin around the tooltip.
+  final StacEdgeInsets? margin;
+
+  /// Vertical gap between widget and tooltip.
+  final double? verticalOffset;
+
+  /// Whether tooltip prefers to appear below the widget.
+  final bool? preferBelow;
+
+  /// Whether tooltip text is excluded from semantics.
+  final bool? excludeFromSemantics;
+
+  /// Tooltip decoration.
+  final StacBoxDecoration? decoration;
+
+  /// Tooltip text style.
+  final StacTextStyle? textStyle;
+
+  /// Tooltip text alignment.
+  final StacTextAlign? textAlign;
+
+  /// Delay before showing tooltip.
+  final StacDuration? waitDuration;
+
+  /// Duration tooltip remains visible.
+  final StacDuration? showDuration;
+
+  /// Delay before tooltip disappears.
+  final StacDuration? exitDuration;
+
+  /// Trigger mode for tooltip.
+  final StacTooltipTriggerMode? triggerMode;
+
+  /// Whether to provide acoustic/haptic feedback.
+  final bool? enableFeedback;
+
+  /// Creates a [StacTooltipThemeData] from JSON.
+  factory StacTooltipThemeData.fromJson(Map<String, dynamic> json) =>
+      _$StacTooltipThemeDataFromJson(json);
+
+  @override
+  Map<String, dynamic> toJson() => _$StacTooltipThemeDataToJson(this);
+}

packages/stac_core/lib/foundation/theme/theme.dart

@@ -28,3 +28,4 @@ export 'stac_snack_bar_theme_data/stac_snack_bar_theme_data.dart';
 export 'stac_tab_bar_theme_data/stac_tab_bar_theme_data.dart';
 export 'stac_text_theme/stac_text_theme.dart';
 export 'stac_theme/stac_theme.dart';
+export 'stac_tool_tip_theme_data/stac_tool_tip_theme_data.dart';