import type { CSSRuleObject } from '../types/tailwind-types.js';
/**
 * Creates a utility function that repeats a given CSS value multiple times
 * and joins them into a single declaration for a specified property.
 *
 * This is useful for properties like `transition-delay` where the number
 * of comma-separated values must match the number of transitioned properties.
 *
 * The repeat count is determined in the following order:
 *
 * 1. If `count` is provided and is a valid number, it takes precedence.
 * 2. Otherwise, `matchValue` is split by `splitDelimiter` (default: ',') to infer the count.
 * 3. If neither provides a valid count, the utility will be skipped (returns `null`).
 *
 * @param {string} property - The CSS property to assign (e.g. `transition-delay`).
 * @param {RepeaterOptions} options - Configuration for repetition behavior.
 * @param {number} [options.count] - A fixed number of repetitions. Takes precedence over `matchValue`.
 * @param {string} [options.matchValue] - A string to infer repeat count from (e.g. `opacity, transform`).
 * @param {string} [options.splitDelimiter] - The delimiter to split `matchValue` with. Leading/trailing whitespaces are trimmed after splitting. Defaults to `','`
 * @param {string} [options.fillDelimiter] - The delimiter to join repeated values with. Defaults to `', '`.
 * @param {boolean} [options.skipIfSingleProperty] - If true, returns null when the inferred repeat count is 1.
 *
 * @returns Either
 *   – a utility callback `(value) => CSSRuleObject | null` that applies the repetition logic,
 *   – or `null` when the utility should be skipped (e.g. invalid options, repeat count < 1, or
 *     `skipIfSingleProperty` && only one property).
 *
 * @example
 * createRepeaterUtility('transition-delay', { matchValue: 'opacity, transform' })('200ms');
 * // => { transition-delay: '200ms, 200ms' }
 *
 * @example
 * createRepeaterUtility('transition-delay', { count: 3 })('150ms');
 * // => { transition-delay: '150ms, 150ms, 150ms' }
 */
export declare function createRepeaterUtility(property: string, options: RepeaterOptions): ((value: unknown) => CSSRuleObject | null) | null;
/**
 * Options to control how a CSS value should be repeated and joined.
 */
export interface RepeaterOptions {
    /**
     * A string to infer repeat count from (e.g. 'opacity, transform').
     * Each segment will be trimmed after splitting.
     */
    matchValue?: string;
    /**
     * A fixed number of repetitions. Takes precedence over `matchValue` if both are present.
     */
    count?: number;
    /**
     * The delimiter used to split `matchValue` when inferring repeat count. Defaults to `','`.
     * Each segment is trimmed (i.e., leading/trailing spaces are removed) after splitting.
     */
    splitDelimiter?: string;
    /**
     * The delimiter used to join repeated values into a single declaration. Defaults to `', '`.
     */
    fillDelimiter?: string;
    /**
     * If true, returns null when the inferred repeat count is 1.
     * Useful for skipping redundant utilities like `duration-opacity-*`.
     */
    skipIfSingleProperty?: boolean;
}