(** Main Tailwind API module *)

(** The main type representing a collection of Tailwind classes *)
type t = Css.t

(** Module aliases for accessing individual utilities *)
module Css = Css
module Color = Color
module Size = Size
module Spacing = Spacing
module Display = Display
module Flexbox = Flexbox
module Grid = Grid
module Position = Position
module Layout = Layout
module Typography = Typography
module Effects = Effects
module Responsive = Responsive
module Variants = Variants

(** Combine multiple CSS classes *)
val tw : Css.t list -> Css.t

(** Conditionally include classes *)
val class_list : (Css.t * bool) list -> Css.t

(** Convert CSS classes to string *)
val to_string : t -> string

(** Common utility patterns *)

(** Centers content using flexbox *)
val flex_center : t

(** Centers content absolutely *)
val absolute_center : t

(** Screen reader only (visually hidden but accessible) *)
val sr_only : t

(** Focus ring utility *)
val focus_ring : ?color:Color.t -> ?width:Effects.border_width -> unit -> t

(** Container with responsive max-widths *)
val container : ?center:bool -> unit -> t

(** Reset styles for buttons *)
val button_reset : t

(** Reset styles for inputs *)
val input_reset : t

(** Common transition utilities *)
val transition : [`None | `All | `Colors | `Opacity | `Shadow | `Transform] -> t

(** Duration utilities (in ms) *)
val duration : int -> t

(** Ease timing functions *)
val ease : [`Linear | `In | `Out | `In_out] -> t

(** V4 specific features *)
module V4 : sig
  (** Container query support *)
  val container_query : Responsive.container_size -> t -> t
  
  (** Starting style animation *)
  val starting_style : t -> t
  
  (** Text shadow utilities *)
  val text_shadow : [`None | `Sm | `Base | `Lg | `Xl] -> t
  
  (** Mask utilities *)
  val mask : [`Auto | `Cover | `Contain] -> t
  
  (** 3D perspective *)
  val perspective : [`None | `Distant | `Normal | `Near] -> t
end