import { CSVRecord, CSVRecordAssemblerCommonOptions, CSVRecordAssemblerTransformerStreamOptions, InferFormat, Token } from '../../../core/types';
import { CSVRecordAssemblerTransformer } from '../../stream/CSVRecordAssemblerTransformer';
/**
 * Factory function to create a CSVRecordAssemblerTransformer instance.
 *
 * This function internally creates a CSVRecordAssembler and wraps it in a
 * CSVRecordAssemblerTransformer, providing a simpler API for stream-based
 * CSV record assembly.
 *
 * @category Mid-level API
 *
 * @template Header - The type of the header row
 * @template Options - The assembler options type
 * @param options - CSV assembler options including header, outputFormat, etc.
 * @param streamOptions - Stream-specific options like backpressureCheckInterval
 * @param writableStrategy - Strategy for the writable side (default: `{ highWaterMark: 1024, size: () => 1 }`)
 * @param readableStrategy - Strategy for the readable side (default: `{ highWaterMark: 256, size: () => 1 }`)
 * @returns A CSVRecordAssemblerTransformer instance configured with the specified options
 *
 * @see {@link https://github.com/kamiazya/web-csv-toolbox/blob/main/docs/how-to-guides/choosing-the-right-api.md | Choosing the Right API} for guidance on selecting the appropriate API level.
 *
 * @example Custom processing between lexer and assembler
 * ```ts
 * import { createStringCSVLexerTransformer, createCSVRecordAssemblerTransformer } from 'web-csv-toolbox';
 *
 * new ReadableStream({
 *   start(controller) {
 *     controller.enqueue("name,age\r\n");
 *     controller.enqueue("Alice,20\r\n");
 *     controller.enqueue("Bob,25\r\n");
 *     controller.close();
 *   }
 * })
 *   .pipeThrough(createStringCSVLexerTransformer())
 *   .pipeThrough(createCSVRecordAssemblerTransformer())
 *   .pipeTo(new WritableStream({ write(record) {
 *     console.log(record);
 *   }}));
 * // { name: "Alice", age: "20" }
 * // { name: "Bob", age: "25" }
 * ```
 *
 * @example With predefined header
 * ```ts
 * import { createStringCSVLexerTransformer, createCSVRecordAssemblerTransformer } from 'web-csv-toolbox';
 *
 * const transformer = createCSVRecordAssemblerTransformer({
 *   header: ['name', 'age']
 * });
 *
 * // Data without header row
 * csvStream
 *   .pipeThrough(createStringCSVLexerTransformer())
 *   .pipeThrough(transformer);
 * ```
 *
 * @example Array output format
 * ```ts
 * import { createStringCSVLexerTransformer, createCSVRecordAssemblerTransformer } from 'web-csv-toolbox';
 *
 * const transformer = createCSVRecordAssemblerTransformer({
 *   outputFormat: 'array'
 * });
 *
 * csvStream
 *   .pipeThrough(createStringCSVLexerTransformer())
 *   .pipeThrough(transformer)
 *   .pipeTo(new WritableStream({ write(record) {
 *     console.log(record); // ['Alice', '20']
 *   }}));
 * ```
 *
 * @example With backpressure tuning
 * ```ts
 * import { createStringCSVLexerTransformer, createCSVRecordAssemblerTransformer } from 'web-csv-toolbox';
 *
 * const transformer = createCSVRecordAssemblerTransformer(
 *   { header: ['name', 'age'] },
 *   { backpressureCheckInterval: 20 },
 *   new CountQueuingStrategy({ highWaterMark: 2048 }),
 *   new CountQueuingStrategy({ highWaterMark: 512 })
 * );
 *
 * await tokenStream
 *   .pipeThrough(transformer)
 *   .pipeTo(yourRecordProcessor);
 * ```
 */
export declare function createCSVRecordAssemblerTransformer<Header extends ReadonlyArray<string> = readonly string[], Options extends CSVRecordAssemblerCommonOptions<Header> = CSVRecordAssemblerCommonOptions<Header>>(options?: Options, streamOptions?: CSVRecordAssemblerTransformerStreamOptions, writableStrategy?: QueuingStrategy<Token>, readableStrategy?: QueuingStrategy<CSVRecord<Header, InferFormat<Options>>>): CSVRecordAssemblerTransformer<Header, InferFormat<Options>>;