plezy/lib/widgets/focus_builders.dart

import 'package:flutter/material.dart';
import '../focus/focus_glow_overlay.dart';
import '../focus/focus_theme.dart';
import '../focus/input_mode_tracker.dart';
import 'clickable_cursor.dart';

/// Shared builders for focusable widgets to reduce code duplication.
///
/// These builders provide consistent focus decoration patterns across
/// different focusable widgets (chips, cards, etc.).
class FocusBuilders {
  /// Builds a chip-style focusable widget with background color changes.
  ///
  /// Used by FocusableTabChip and FocusableFilterChip.
  ///
  /// Parameters:
  /// - [context]: Build context for theming
  /// - [focusNode]: The focus node for this widget
  /// - [isFocused]: Whether this widget currently has focus
  /// - [onKeyEvent]: Callback for handling key events
  /// - [onTap]: Callback for tap/click events
  /// - [padding]: Padding inside the chip
  /// - [backgroundColor]: Background color for the chip
  /// - [borderRadius]: Border radius for the chip (defaults to 20)
  /// - [child]: The content to display inside the chip
  static Widget buildFocusableChip({
    required BuildContext context,
    required FocusNode focusNode,
    required KeyEventResult Function(FocusNode, KeyEvent) onKeyEvent,
    required VoidCallback onTap,
    required EdgeInsetsGeometry padding,
    required Color backgroundColor,
    double borderRadius = 20,
    required Widget child,
  }) {
    final duration = FocusTheme.getAnimationDuration(context);

    return Focus(
      focusNode: focusNode,
      onKeyEvent: onKeyEvent,
      child: ClickableCursor(
        child: GestureDetector(
          onTap: onTap,
          child: AnimatedContainer(
            duration: duration,
            curve: Curves.easeOutCubic,
            padding: padding,
            decoration: BoxDecoration(color: backgroundColor, borderRadius: BorderRadius.circular(borderRadius)),
            child: child,
          ),
        ),
      ),
    );
  }

  /// Builds a card-style focusable widget with scale and border decoration.
  ///
  /// Used by FocusableMediaCard and _LockedHubItemWrapper.
  ///
  /// Parameters:
  /// - [context]: Build context for theming
  /// - [focusNode]: The focus node for this widget (optional for locked wrappers)
  /// - [isFocused]: Whether this widget currently has focus
  /// - [onKeyEvent]: Callback for handling key events (optional for locked wrappers)
  /// - [onTap]: Callback for tap/click events
  /// - [onLongPress]: Callback for long press events
  /// - [borderRadius]: Border radius for the focus decoration
  /// - [child]: The content to display inside the card
  static Widget buildFocusableCard({
    required BuildContext context,
    FocusNode? focusNode,
    required bool isFocused,
    KeyEventResult Function(FocusNode, KeyEvent)? onKeyEvent,
    VoidCallback? onTap,
    VoidCallback? onLongPress,
    double borderRadius = FocusTheme.defaultBorderRadius,
    double focusScale = FocusTheme.focusScale,
    double focusBorderStrokeAlign = BorderSide.strokeAlignInside,
    bool useFocusGlow = false,
    bool useForegroundFocusDecoration = false,
    Size? glowSize,
    required Widget child,
  }) {
    final isKeyboardMode = InputModeTracker.isKeyboardMode(context);

    // In touch mode, no item ever shows focus effects — skip animated wrappers
    // entirely. This saves ~2 element levels per card on ARM32 Android phones.
    if (!isKeyboardMode) {
      final gestureWidget = (onTap != null || onLongPress != null)
          ? ClickableCursor(
              child: GestureDetector(onTap: onTap, onLongPress: onLongPress, child: child),
            )
          : child;
      if (focusNode != null && onKeyEvent != null) {
        return Focus(focusNode: focusNode, onKeyEvent: onKeyEvent, child: gestureWidget);
      }
      return gestureWidget;
    }

    final duration = FocusTheme.getAnimationDuration(context);
    final showFocus = isFocused && isKeyboardMode;
    final focusDecoration = FocusTheme.focusDecoration(
      context,
      isFocused: showFocus,
      borderRadius: borderRadius,
      borderStrokeAlign: focusBorderStrokeAlign,
    );
    // Glow (full-bleed cards) renders in an overlay above siblings so it stays
    // symmetric; the in-card decoration only carries the border.
    Widget card = AnimatedContainer(
      duration: duration,
      curve: Curves.easeOutCubic,
      decoration: useForegroundFocusDecoration ? null : focusDecoration,
      foregroundDecoration: useForegroundFocusDecoration ? focusDecoration : null,
      child: child,
    );
    if (useFocusGlow) {
      card = FocusGlowOverlay(
        isFocused: showFocus,
        borderRadius: borderRadius,
        color: FocusTheme.getFocusBorderColor(context),
        glowSize: glowSize,
        child: card,
      );
    }

    final focusedWidget = AnimatedScale(
      scale: showFocus ? focusScale : 1.0,
      duration: duration,
      curve: Curves.easeOutCubic,
      child: card,
    );

    // Wrap in GestureDetector if tap/long press handlers provided
    final gestureWidget = (onTap != null || onLongPress != null)
        ? ClickableCursor(
            child: GestureDetector(onTap: onTap, onLongPress: onLongPress, child: focusedWidget),
          )
        : focusedWidget;

    // Wrap in Focus if focus node and key event handler provided
    if (focusNode != null && onKeyEvent != null) {
      return Focus(focusNode: focusNode, onKeyEvent: onKeyEvent, child: gestureWidget);
    }

    return gestureWidget;
  }

  /// Builds a simple locked wrapper (no Focus widget) with scale and border decoration.
  ///
  /// Used by _LockedHubItemWrapper where focus is managed at a higher level.
  ///
  /// Parameters:
  /// - [context]: Build context for theming
  /// - [isFocused]: Whether this widget should appear focused
  /// - [onTap]: Callback for tap/click events
  /// - [onLongPress]: Callback for long press events
  /// - [borderRadius]: Border radius for the focus decoration
  /// - [child]: The content to display inside the wrapper
  static Widget buildLockedFocusWrapper({
    required BuildContext context,
    required bool isFocused,
    VoidCallback? onTap,
    VoidCallback? onLongPress,
    double borderRadius = FocusTheme.defaultBorderRadius,
    double focusScale = FocusTheme.focusScale,
    double focusBorderStrokeAlign = BorderSide.strokeAlignInside,
    bool useFocusGlow = false,
    bool useForegroundFocusDecoration = false,
    Size? glowSize,
    required Widget child,
  }) {
    return buildFocusableCard(
      context: context,
      focusNode: null,
      isFocused: isFocused,
      onKeyEvent: null,
      onTap: onTap,
      onLongPress: onLongPress,
      borderRadius: borderRadius,
      focusScale: focusScale,
      focusBorderStrokeAlign: focusBorderStrokeAlign,
      useFocusGlow: useFocusGlow,
      useForegroundFocusDecoration: useForegroundFocusDecoration,
      glowSize: glowSize,
      child: child,
    );
  }
}