import type { Formatter } from "../../types/string/formatString/formatter";
/**
 * Applies a formatter function to a value with optional arguments.
 *
 * Parses formatter syntax like "upper", "currency(ja-JP,JPY)", "pad(4,0)" and applies
 * the corresponding formatter function with parsed arguments.
 *
 * @param value - The value to format
 * @param formatterString - Formatter name with optional arguments (e.g., "upper", "currency(ja-JP,JPY)")
 * @param formatters - Available formatter functions
 * @returns Formatted string, or original string value if formatter not found/invalid
 *
 * @example
 * // Simple formatter
 * applyFormatter("hello", "upper", { upper: (v) => String(v).toUpperCase() }) // → "HELLO"
 *
 * @example
 * // Formatter with arguments
 * applyFormatter(42, "pad(4,0)", { pad: (v, len, char) => String(v).padStart(+len, char) }) // → "0042"
 *
 * @example
 * // Invalid formatter returns original value
 * applyFormatter("test", "invalid!@#", {}) // → "test"
 */
export declare function applyFormatter(value: unknown, formatterString: string, formatters: Record<string, Formatter>): string;