import type { ComplexAttributeConverter } from 'lit';
type DeprecationWarningFn = (rawValue: string) => void;
/**
 * Creates a converter that handles both JSON arrays (new format) and comma-separated strings (legacy format).
 *
 * The legacy comma-separated format is deprecated and will be removed in Atomic v4.
 *
 * @param onDeprecatedFormat - Optional callback invoked when a comma-separated string is detected.
 *                              Use this to log deprecation warnings.
 * @returns A Lit attribute converter for string arrays.
 *
 * @example
 * ```typescript
 * @property({
 *   converter: createLegacyArrayStringConverter((value) => {
 *     console.warn(`Comma-separated value "${value}" is deprecated. Use JSON array format.`);
 *   }),
 * })
 * fields: string[] = [];
 * ```
 * // TODO V4 (KIT-5306): Remove converter and use arrayConverter directly.
 */
export declare function createLegacyArrayStringConverter(onDeprecatedFormat?: DeprecationWarningFn): ComplexAttributeConverter<string[]>;
export {};
