tailwind-tree/dist/index.d.ts

A utility for writing deeply nested and composable Tailwind CSS classes using an expressive tree structure, supporting responsive and interactive variants for Tailwind v3 and v4.

/**
 * Parses a nested Tailwind class structure and returns a flattened string of classes
 * with variants applied, e.g., `hover:bg-red-500`, `md:focus:text-blue-600`.
 *
 * Supports nested variant objects like:
 * ```ts
 * twTree([
 *   "bg-red-500 text-white",
 *   { hover: ["bg-blue-500"], md: [{ focus: ["text-xl"] }] }
 * ]);
 * // => "bg-red-500 text-white hover:bg-blue-500 md:focus:text-xl"
 * ```
 *
 * @param input - Array of Tailwind class strings or nested variant objects.
 *                Objects can nest arbitrarily deep to represent variant chains.
 * @param options.prefix - Internal use for recursive variant prefixing (e.g., `hover:`).
 * @param options.merge - When true (default), merges and deduplicates classes using `tailwind-merge`.
 *                        When false, returns all classes without merging (useful for extraction/safelist).
 * @returns A space-separated string of Tailwind classes with prefixes applied.
 */
declare function twTree<T extends string | object>(input: T[], options?: {
    prefix?: string;
    merge?: boolean;
}): string;

export { twTree };