import { ColumnCountStrategy, CSVRecordAssemblerFactoryOptions } from '../../../core/types';
import { FlexibleCSVArrayRecordAssembler } from '../../models/FlexibleCSVArrayRecordAssembler';
import { FlexibleCSVObjectRecordAssembler } from '../../models/FlexibleCSVObjectRecordAssembler';
/**
 * Factory function to create the appropriate CSV record assembler based on options.
 *
 * @param options - Assembler options including outputFormat and engine
 * @returns An assembler instance configured for the specified output format
 *
 * @remarks
 * This function accepts {@link CSVRecordAssemblerFactoryOptions} for flexibility,
 * but runtime validation ensures type safety. For compile-time type safety,
 * use {@link CSVRecordAssemblerOptions} type directly.
 *
 * **Design Intent**: This factory function accepts options including engine configuration
 * to enable future execution path optimization. The function may select the optimal internal
 * assembler implementation based on the provided options. Currently, this optimization
 * is not implemented, but the API is designed to support it without breaking changes.
 *
 * @example
 * ```ts
 * // Create an object record assembler
 * const objectAssembler = createCSVRecordAssembler({
 *   header: ['name', 'age'],
 *   outputFormat: 'object'
 * });
 *
 * // Create an array record assembler
 * const arrayAssembler = createCSVRecordAssembler({
 *   header: ['name', 'age'],
 *   outputFormat: 'array'
 * });
 * ```
 */
export declare function createCSVRecordAssembler<const Header extends ReadonlyArray<string>, const Strategy extends ColumnCountStrategy = ColumnCountStrategy>(options: CSVRecordAssemblerFactoryOptions<Header, "array", Strategy> & {
    outputFormat: "array";
}): FlexibleCSVArrayRecordAssembler<Header>;
export declare function createCSVRecordAssembler<const Header extends ReadonlyArray<string>, const Strategy extends ColumnCountStrategy = ColumnCountStrategy>(options: CSVRecordAssemblerFactoryOptions<Header, "object", Strategy> & {
    outputFormat: "object";
}): FlexibleCSVObjectRecordAssembler<Header>;
export declare function createCSVRecordAssembler<const Header extends ReadonlyArray<string>, const Strategy extends ColumnCountStrategy = ColumnCountStrategy>(options?: Omit<CSVRecordAssemblerFactoryOptions<Header, "object", Strategy>, "outputFormat">): FlexibleCSVObjectRecordAssembler<Header>;
export declare function createCSVRecordAssembler<const Header extends ReadonlyArray<string>, const OutputFormat extends "object" | "array" = "object" | "array", const Strategy extends ColumnCountStrategy = ColumnCountStrategy>(options: CSVRecordAssemblerFactoryOptions<Header, OutputFormat, Strategy>): FlexibleCSVArrayRecordAssembler<Header> | FlexibleCSVObjectRecordAssembler<Header>;