import { Text, Typography, Size } from '@idealyst/theme';
import type { ReactNode } from 'react';
import type { StyleProp, TextStyle } from 'react-native';
import { TextSpacingStyleProps } from '../utils/viewStyleProps';

// Component-specific type aliases for future extensibility
export type TextColorVariant = Text;
export type TextWeightVariant = 'light' | 'normal' | 'medium' | 'semibold' | 'bold';
export type TextAlignVariant = 'left' | 'center' | 'right';
export type TextTypographyVariant = Typography;
/**
 * Text size variant - accepts both Typography values and Size shorthand
 * Typography: 'h1', 'h2', 'body1', 'caption', etc.
 * Size: 'xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl'
 */
export type TextSizeVariant = Typography | Size;

/**
 * Typography component for rendering text with consistent styling.
 * Supports semantic typography variants, custom weights, and theme-aware colors.
 */
export interface TextProps extends TextSpacingStyleProps {
  /**
   * The text content to display
   */
  children: ReactNode;

  /**
   * Typography variant for semantic text styling.
   * Automatically sets fontSize, lineHeight, and fontWeight.
   */
  typography?: TextTypographyVariant;

  /**
   * The weight of the text.
   * Overrides the weight from typography if both are set.
   */
  weight?: TextWeightVariant;

  /**
   * The color of the text
   */
  color?: TextColorVariant;

  /**
   * Text alignment
   */
  align?: TextAlignVariant;

  /**
   * Number of lines to display before truncating with ellipsis.
   * On native, maps directly to React Native's numberOfLines prop.
   * On web, uses CSS line-clamp for multi-line and text-overflow for single-line.
   */
  numberOfLines?: number;

  /**
   * Maximum font scale factor for accessibility text sizing.
   * Limits how large text can grow when the user increases their device font size.
   * Set to 0 to disable scaling limits. Only applies on native (iOS & Android).
   */
  maxFontSizeMultiplier?: number;

  /**
   * Additional styles (platform-specific)
   */
  style?: StyleProp<TextStyle>;

  /**
   * Test ID for testing
   */
  testID?: string;
}