import 'package:flutter/material.dart';

/// Wraps a widget with semantic information for accessibility and automation.
///
/// Usage:
/// ```dart
/// SemanticWidget(
///   id: ProfileSemantics.button,
///   label: 'Open profile menu',
///   child: IconButton(...),
/// )
/// ```
///
/// For buttons, use `button: true`. For other interactive elements,
/// set the appropriate semantic properties.
class SemanticWidget extends StatelessWidget {
  const SemanticWidget({
    super.key,
    required this.id,
    required this.child,
    this.label,
    this.hint,
    this.button = false,
    this.link = false,
    this.header = false,
    this.textField = false,
    this.enabled = true,
    this.selected,
    this.checked,
    this.value,
    this.excludeSemantics = false,
  });

  /// Unique identifier for this widget, exposed via [SemanticsProperties.identifier].
  final String id;

  /// The widget to wrap.
  final Widget child;

  /// Accessibility label describing the widget.
  final String? label;

  /// Hint text for screen readers.
  final String? hint;

  /// Whether this widget represents a button.
  final bool button;

  /// Whether this widget represents a link.
  final bool link;

  /// Whether this widget represents a header.
  final bool header;

  /// Whether this widget represents a text field.
  final bool textField;

  /// Whether the widget is enabled.
  final bool enabled;

  /// Whether the widget is selected (for toggle buttons, tabs).
  final bool? selected;

  /// Whether the widget is checked (for checkboxes).
  final bool? checked;

  /// Current value (for sliders, progress indicators).
  final String? value;

  /// Whether to exclude child semantics.
  final bool excludeSemantics;

  @override
  Widget build(BuildContext context) {
    return Semantics(
      identifier: id,
      label: label,
      hint: hint,
      button: button,
      link: link,
      header: header,
      textField: textField,
      enabled: enabled,
      selected: selected,
      checked: checked,
      value: value,
      excludeSemantics: excludeSemantics,
      child: child,
    );
  }
}

/// Extension to easily wrap any widget with semantic info.
extension SemanticExtension on Widget {
  /// Wraps this widget with a semantic identifier.
  Widget withSemantics({
    required String id,
    String? label,
    String? hint,
    bool button = false,
    bool link = false,
    bool enabled = true,
    bool? selected,
    bool? checked,
  }) {
    return SemanticWidget(
      id: id,
      label: label,
      hint: hint,
      button: button,
      link: link,
      enabled: enabled,
      selected: selected,
      checked: checked,
      child: this,
    );
  }
}