@cj-tech-master/excelts 5.1.18 → 6.0.0-beta.1

package/dist/browser/modules/csv/format/formatter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * CSV Formatter
+ *
+ * Core formatting functions for converting data to CSV strings.
+ *
+ * Low-level exports:
+ * - formatField(): Format a single field value
+ * - formatRowWithLookup(): Format an entire row (used by CsvFormatterStream)
+ * - applyTypeTransform(): Apply type-based transforms
+ * - defaultToString(): Default value-to-string conversion
+ *
+ * High-level exports:
+ * - formatCsv(): Batch format data to CSV string
+ *
+ * Features:
+ * - Multiple input types (objects, arrays, RowHashArray)
+ * - Flexible quoting (per-column, per-header, always, disabled)
+ * - Type transforms with context
+ * - Formula escaping (CSV injection protection)
+ * - BOM support
+ */
+import type { CsvFormatOptions, Row, TypeTransformMap, TransformContext, TransformResult } from "../types.js";
+import { type DecimalSeparator } from "../utils/number.js";
+import type { CsvFormatRegex, FormatFieldContext, FormatRowOptions } from "./config.js";
+/**
+ * Apply type-based transform to a single value.
+ * Returns the transformed result, or undefined if no transform applies.
+ */
+export declare function applyTypeTransform(value: any, transform: TypeTransformMap, ctx: TransformContext): TransformResult;
+/**
+ * Default type conversion to string.
+ */
+export declare function defaultToString(value: any, decimalSeparator: DecimalSeparator): string;
+/**
+ * Format a single field value to CSV string
+ */
+export declare function formatField(value: unknown, regex: CsvFormatRegex, ctx: FormatFieldContext): string;
+/**
+ * Format an entire row to CSV string.
+ *
+ * Performance optimizations:
+ * - Uses for loop with direct string building instead of map().join()
+ * - Reuses a single mutable context object instead of creating one per field
+ */
+export declare function formatRowWithLookup(row: unknown[], regex: CsvFormatRegex, options: FormatRowOptions): string;
+/**
+ * Format data as CSV string.
+ *
+ * Performance optimization: Builds result string directly without
+ * intermediate arrays from map().join() operations.
+ *
+ * @example
+ * ```ts
+ * // Array of arrays
+ * formatCsv([["a", "b"], ["1", "2"]])
+ * // "a,b\n1,2"
+ *
+ * // Array of objects
+ * formatCsv([{ name: "Alice", age: 30 }])
+ * // "name,age\nAlice,30"
+ *
+ * // With options
+ * formatCsv(data, {
+ *   delimiter: ";",
+ *   quoteColumns: { name: true },
+ *   escapeFormulae: true,
+ *   bom: true
+ * })
+ * ```
+ */
+export declare function formatCsv(data: Row[] | Record<string, unknown>[], options?: CsvFormatOptions): string;

package/dist/browser/modules/csv/format/formatter.js

@@ -0,0 +1,397 @@
+/**
+ * CSV Formatter
+ *
+ * Core formatting functions for converting data to CSV strings.
+ *
+ * Low-level exports:
+ * - formatField(): Format a single field value
+ * - formatRowWithLookup(): Format an entire row (used by CsvFormatterStream)
+ * - applyTypeTransform(): Apply type-based transforms
+ * - defaultToString(): Default value-to-string conversion
+ *
+ * High-level exports:
+ * - formatCsv(): Batch format data to CSV string
+ *
+ * Features:
+ * - Multiple input types (objects, arrays, RowHashArray)
+ * - Flexible quoting (per-column, per-header, always, disabled)
+ * - Type transforms with context
+ * - Formula escaping (CSV injection protection)
+ * - BOM support
+ */
+import { deduplicateHeaders, isRowHashArray, rowHashArrayToHeaders, rowHashArrayToValues, rowHashArrayMapByHeaders, processColumns } from "../utils/row.js";
+import { startsWithFormulaChar } from "../utils/detect.js";
+import { formatNumberForCsv } from "../utils/number.js";
+import { isFormattedValue } from "./formatted-value.js";
+import { createFormatConfig } from "./config.js";
+// =============================================================================
+// Type Transform Functions
+// =============================================================================
+/**
+ * Apply type-based transform to a single value.
+ * Returns the transformed result, or undefined if no transform applies.
+ */
+export function applyTypeTransform(value, transform, ctx) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    const type = typeof value;
+    if (type === "boolean" && transform.boolean) {
+        return transform.boolean(value, ctx);
+    }
+    if (value instanceof Date && transform.date) {
+        return transform.date(value, ctx);
+    }
+    if (type === "number" && transform.number) {
+        return transform.number(value, ctx);
+    }
+    if (type === "bigint" && transform.bigint) {
+        return transform.bigint(value, ctx);
+    }
+    if (type === "string" && transform.string) {
+        return transform.string(value, ctx);
+    }
+    // Handle plain objects (not Date, not Array, not null)
+    if (type === "object" && !Array.isArray(value) && !(value instanceof Date)) {
+        if (transform.object) {
+            return transform.object(value, ctx);
+        }
+    }
+    return undefined;
+}
+/**
+ * Default type conversion to string.
+ */
+export function defaultToString(value, decimalSeparator) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "number") {
+        return formatNumberForCsv(value, decimalSeparator);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "bigint") {
+        return String(value);
+    }
+    if (typeof value === "boolean") {
+        return value ? "true" : "false";
+    }
+    if (typeof value === "object") {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            // Handle circular references or other JSON.stringify errors
+            return "[object Object]";
+        }
+    }
+    return String(value);
+}
+// =============================================================================
+// Field Formatting
+// =============================================================================
+/**
+ * Fast check if a string needs quoting (for single-char delimiter/quote/escape)
+ * Uses indexOf for slightly better V8 optimization
+ */
+function needsQuoteFast(str, delimiter, quote, escape) {
+    return (str.indexOf(delimiter) !== -1 ||
+        str.indexOf(quote) !== -1 ||
+        (escape !== quote && str.indexOf(escape) !== -1) ||
+        str.indexOf("\n") !== -1 ||
+        str.indexOf("\r") !== -1);
+}
+/**
+ * Format a single field value to CSV string
+ */
+export function formatField(value, regex, ctx) {
+    const { index, header, isHeader, outputRowIndex, forceQuote, quoteAll, escapeFormulae, decimalSeparator, transform } = ctx;
+    // Apply type-based transform if provided (not for headers)
+    let str;
+    // Track if transform explicitly requested quoting control
+    let transformQuoteHint;
+    if (!isHeader && transform) {
+        // Create fresh context for each call to ensure safety if user stores reference
+        const transformCtx = { column: header ?? index, index: outputRowIndex };
+        const transformed = applyTypeTransform(value, transform, transformCtx);
+        if (transformed === undefined || transformed === null) {
+            str = defaultToString(value, decimalSeparator);
+        }
+        else if (isFormattedValue(transformed)) {
+            // FormattedValue contains explicit quoting hint
+            str = transformed.value;
+            transformQuoteHint = transformed.quote;
+        }
+        else {
+            str = transformed;
+        }
+    }
+    else {
+        str = defaultToString(value, decimalSeparator);
+    }
+    // Escape formulae to prevent CSV injection (OWASP recommendation)
+    // Prefix dangerous characters with single quote to neutralize them in spreadsheet apps
+    // Using single quote (') as recommended by OWASP, which Excel interprets as a text prefix
+    if (escapeFormulae && transformQuoteHint !== false && startsWithFormulaChar(str)) {
+        str = "'" + str;
+    }
+    // If quoting is disabled, return raw string
+    if (!regex.quoteEnabled) {
+        return str;
+    }
+    // Check if quoting is needed
+    // Transform quote hint takes precedence (explicit control via quoted()/unquoted())
+    let needsQuote;
+    if (transformQuoteHint !== undefined) {
+        needsQuote = transformQuoteHint;
+    }
+    else {
+        needsQuote =
+            quoteAll ||
+                forceQuote ||
+                (regex.useFastCheck
+                    ? needsQuoteFast(str, regex.delimiter, regex.quote, regex.escape)
+                    : regex.needsQuoteRegex.test(str));
+    }
+    if (needsQuote) {
+        // Escape quotes (and escape chars if different from quote) using pre-compiled regex
+        let escaped;
+        if (regex.escape !== regex.quote) {
+            // When escape !== quote, regex matches both quote and escape chars.
+            // Use replacement function to escape each correctly.
+            escaped = str.replace(regex.escapeQuoteRegex, ch => ch === regex.quote ? regex.escape + regex.quote : regex.escape + regex.escape);
+        }
+        else {
+            escaped = str.replace(regex.escapeQuoteRegex, regex.escapedQuote);
+        }
+        return regex.quote + escaped + regex.quote;
+    }
+    return str;
+}
+// =============================================================================
+// Row Formatting
+// =============================================================================
+/**
+ * Format an entire row to CSV string.
+ *
+ * Performance optimizations:
+ * - Uses for loop with direct string building instead of map().join()
+ * - Reuses a single mutable context object instead of creating one per field
+ */
+export function formatRowWithLookup(row, regex, options) {
+    const { quoteLookup, delimiter, headers, isHeader, outputRowIndex, quoteAll, escapeFormulae, decimalSeparator, transform } = options;
+    const len = row.length;
+    if (len === 0) {
+        return "";
+    }
+    // Reusable context object - mutate index/header/forceQuote per field
+    // This avoids creating a new object for every field
+    const ctx = {
+        index: 0,
+        header: headers?.[0],
+        isHeader,
+        outputRowIndex,
+        forceQuote: quoteLookup(0, headers?.[0]),
+        quoteAll,
+        escapeFormulae,
+        decimalSeparator,
+        transform
+    };
+    // Build string directly without intermediate array from map()
+    let result = formatField(row[0], regex, ctx);
+    for (let i = 1; i < len; i++) {
+        ctx.index = i;
+        ctx.header = headers?.[i];
+        ctx.forceQuote = quoteLookup(i, ctx.header);
+        result += delimiter + formatField(row[i], regex, ctx);
+    }
+    return result;
+}
+// =============================================================================
+// Input Normalization
+// =============================================================================
+/**
+ * Apply row transform if configured. Returns null to skip the row.
+ */
+function applyRowTransform(cfg, row, index) {
+    if (!cfg.typeTransform?.row) {
+        return row;
+    }
+    const t = cfg.typeTransform.row(row, index);
+    return t === null ? null : t;
+}
+/**
+ * Normalize all input types to a unified format.
+ * Handles: objects, arrays, RowHashArray, and columns config.
+ */
+function normalizeInput(data, options, cfg) {
+    const { headers, columns } = options;
+    // Empty data
+    if (data.length === 0) {
+        if (columns && columns.length > 0) {
+            const displayHeaders = columns.map(c => (typeof c === "string" ? c : (c.header ?? c.key)));
+            return { keys: null, displayHeaders, rows: [] };
+        }
+        if (Array.isArray(headers)) {
+            return { keys: headers, displayHeaders: headers, rows: [] };
+        }
+        return { keys: null, displayHeaders: null, rows: [] };
+    }
+    const firstRow = data[0];
+    // Columns config takes precedence
+    if (columns && columns.length > 0) {
+        const processed = processColumns(columns);
+        const keys = processed.keys;
+        const displayHeaders = processed.headers;
+        const rows = [];
+        for (let i = 0; i < data.length; i++) {
+            const row = applyRowTransform(cfg, data[i], i);
+            if (row === null) {
+                continue;
+            }
+            let values;
+            if (isRowHashArray(row)) {
+                values = rowHashArrayMapByHeaders(row, keys);
+            }
+            else if (Array.isArray(row)) {
+                values = row;
+            }
+            else {
+                values = keys.map(k => row[k]);
+            }
+            rows.push(values);
+        }
+        return { keys, displayHeaders, rows };
+    }
+    // RowHashArray input
+    if (isRowHashArray(firstRow)) {
+        const hashArrays = data;
+        const keys = headers === true
+            ? rowHashArrayToHeaders(hashArrays[0])
+            : Array.isArray(headers)
+                ? headers
+                : null;
+        const rows = [];
+        for (let i = 0; i < hashArrays.length; i++) {
+            const row = applyRowTransform(cfg, hashArrays[i], i);
+            if (row === null) {
+                continue;
+            }
+            let values;
+            if (isRowHashArray(row)) {
+                values = keys ? rowHashArrayMapByHeaders(row, keys) : rowHashArrayToValues(row);
+            }
+            else if (Array.isArray(row)) {
+                values = row;
+            }
+            else {
+                values = keys ? keys.map(k => row[k]) : Object.values(row);
+            }
+            rows.push(values);
+        }
+        return { keys, displayHeaders: keys, rows };
+    }
+    // Object input
+    if (!Array.isArray(firstRow) && typeof firstRow === "object") {
+        const objects = data;
+        const keys = headers === true ? Object.keys(objects[0]) : Array.isArray(headers) ? headers : null;
+        const rows = [];
+        for (let i = 0; i < objects.length; i++) {
+            const obj = applyRowTransform(cfg, objects[i], i);
+            if (obj === null) {
+                continue;
+            }
+            const values = keys
+                ? keys.map(k => obj[k])
+                : Object.values(obj);
+            rows.push(values);
+        }
+        return { keys, displayHeaders: keys, rows };
+    }
+    // Array input
+    const arrays = data;
+    const keys = Array.isArray(headers) ? headers : null;
+    const rows = [];
+    for (let i = 0; i < arrays.length; i++) {
+        const row = applyRowTransform(cfg, arrays[i], i);
+        if (row === null) {
+            continue;
+        }
+        rows.push(row);
+    }
+    return { keys, displayHeaders: keys, rows };
+}
+// =============================================================================
+// Main Formatter
+// =============================================================================
+/**
+ * Format data as CSV string.
+ *
+ * Performance optimization: Builds result string directly without
+ * intermediate arrays from map().join() operations.
+ *
+ * @example
+ * ```ts
+ * // Array of arrays
+ * formatCsv([["a", "b"], ["1", "2"]])
+ * // "a,b\n1,2"
+ *
+ * // Array of objects
+ * formatCsv([{ name: "Alice", age: 30 }])
+ * // "name,age\nAlice,30"
+ *
+ * // With options
+ * formatCsv(data, {
+ *   delimiter: ";",
+ *   quoteColumns: { name: true },
+ *   escapeFormulae: true,
+ *   bom: true
+ * })
+ * ```
+ */
+export function formatCsv(data, options = {}) {
+    const cfg = createFormatConfig(options);
+    const { displayHeaders, rows } = normalizeInput(data, options, cfg);
+    // Collect lines into array and join at the end.
+    // V8 optimizes Array.join internally, outperforming repeated += for many rows.
+    const lines = [];
+    // Deduplicate headers once for both header and data rows (consistent with stream formatter)
+    const effectiveHeaders = displayHeaders ? deduplicateHeaders(displayHeaders) : undefined;
+    // Header row
+    if (effectiveHeaders && cfg.writeHeaders) {
+        lines.push(formatRowWithLookup(effectiveHeaders, cfg.regex, {
+            quoteLookup: cfg.shouldQuoteHeader,
+            delimiter: cfg.delimiter,
+            headers: effectiveHeaders,
+            isHeader: true,
+            outputRowIndex: 0,
+            quoteAll: cfg.quoteAll,
+            escapeFormulae: cfg.escapeFormulae,
+            decimalSeparator: cfg.decimalSeparator,
+            transform: undefined
+        }));
+    }
+    // Data rows
+    for (let rowIdx = 0; rowIdx < rows.length; rowIdx++) {
+        lines.push(formatRowWithLookup(rows[rowIdx], cfg.regex, {
+            quoteLookup: cfg.shouldQuoteColumn,
+            delimiter: cfg.delimiter,
+            headers: effectiveHeaders,
+            isHeader: false,
+            outputRowIndex: rowIdx,
+            quoteAll: cfg.quoteAll,
+            escapeFormulae: cfg.escapeFormulae,
+            decimalSeparator: cfg.decimalSeparator,
+            transform: cfg.typeTransform
+        }));
+    }
+    let result = cfg.bom ? "\uFEFF" : "";
+    result += lines.join(cfg.lineEnding);
+    // Trailing newline
+    if (lines.length > 0 && cfg.trailingNewline) {
+        result += cfg.lineEnding;
+    }
+    return result;
+}

package/dist/browser/modules/csv/format/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CSV Format Module - Public Exports
+ *
+ * Provides all CSV formatting functionality:
+ * - formatCsv: Main batch formatting function
+ * - Low-level utilities for streaming formatters
+ */
+export type { FormatConfig, FormatRowOptions } from "./config.js";
+export { createFormatConfig } from "./config.js";
+export { formatCsv, formatRowWithLookup } from "./formatter.js";

package/dist/browser/modules/csv/format/index.js

@@ -0,0 +1,12 @@
+/**
+ * CSV Format Module - Public Exports
+ *
+ * Provides all CSV formatting functionality:
+ * - formatCsv: Main batch formatting function
+ * - Low-level utilities for streaming formatters
+ */
+export { createFormatConfig } from "./config.js";
+// =============================================================================
+// Formatting
+// =============================================================================
+export { formatCsv, formatRowWithLookup } from "./formatter.js";

package/dist/browser/modules/csv/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CSV Module - Public API
+ *
+ * Pure CSV parsing/formatting functionality with no Excel dependencies.
+ * For CSV-Worksheet integration, use Workbook.readCsv/writeCsv methods instead.
+ *
+ * Design principles:
+ * - Only export types and functions that are part of the PUBLIC API
+ * - Internal utilities (like format helpers) are used internally but not exported
+ * - This reduces bundle size and simplifies the public interface
+ */
+export type { HeaderArray, RowHashArray, RowArray, RowMap, Row, HeaderTransformFunction, RowTransformCallback, RowTransformFunction, RowValidateCallback, RowValidateFunction, TransformContext, FormattedValue, TransformResult, TypeTransformMap, DynamicTypingConfig, CastDateConfig, ColumnConfig, CsvErrorCode, CsvRecordError, OnSkipCallback, CsvParseOptions, CsvFormatOptions, CsvParseArrayOptions, CsvParseObjectOptions, ChunkMeta, CsvParseMeta, RecordInfo, RecordWithInfo, CsvParseResult, CsvParseResultWithObjname, ColumnMismatchConfig, ColumnMismatchLess, ColumnMismatchMore } from "./types.js";
+export { isFormattedValue, quoted, unquoted } from "./types.js";
+export { parseCsv } from "./parse/index.js";
+export { parseCsvAsync, parseCsvRows, parseCsvWithProgress } from "./parse/index.js";
+export { formatCsv } from "./format/index.js";
+export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./stream/index.js";
+export { detectDelimiter, detectLinebreak, stripBom } from "./utils/detect.js";
+export { isRowHashArray, rowHashArrayToValues, rowHashArrayToHeaders, rowHashArrayMapByHeaders, processColumns, deduplicateHeaders, deduplicateHeadersWithRenames } from "./utils/row.js";
+export { applyDynamicTyping, applyDynamicTypingToRow } from "./utils/dynamic-typing.js";
+export { csvGenerate, csvGenerateRows, csvGenerateAsync, csvGenerateData, createCsvGenerator, type CsvGenerateOptions, type CsvGenerateResult, type ColumnDef, type GeneratorColumnConfig, type BuiltinColumnType, type GeneratorFn, type GeneratorContext, type StopCondition, type StopContext } from "./utils/generate.js";
+export { formatNumberForCsv, parseNumberFromCsv, type DecimalSeparator } from "./utils/number.js";
+export { CsvError, CsvWorkerError } from "./errors.js";

package/dist/browser/modules/csv/index.js

@@ -0,0 +1,47 @@
+/**
+ * CSV Module - Public API
+ *
+ * Pure CSV parsing/formatting functionality with no Excel dependencies.
+ * For CSV-Worksheet integration, use Workbook.readCsv/writeCsv methods instead.
+ *
+ * Design principles:
+ * - Only export types and functions that are part of the PUBLIC API
+ * - Internal utilities (like format helpers) are used internally but not exported
+ * - This reduces bundle size and simplifies the public interface
+ */
+// Type guards and helpers from types.ts
+export { isFormattedValue, quoted, unquoted } from "./types.js";
+// =============================================================================
+// Core Functions
+// =============================================================================
+// Synchronous parser
+export { parseCsv } from "./parse/index.js";
+// Async parser
+export { parseCsvAsync, parseCsvRows, parseCsvWithProgress } from "./parse/index.js";
+// Formatter
+export { formatCsv } from "./format/index.js";
+// =============================================================================
+// Stream Classes
+// =============================================================================
+export { CsvParserStream, CsvFormatterStream, createCsvParserStream, createCsvFormatterStream } from "./stream/index.js";
+// =============================================================================
+// Detection Utilities (commonly needed by users)
+// =============================================================================
+export { detectDelimiter, detectLinebreak, stripBom } from "./utils/detect.js";
+// =============================================================================
+// Row Utilities (commonly needed by users)
+// =============================================================================
+export { isRowHashArray, rowHashArrayToValues, rowHashArrayToHeaders, rowHashArrayMapByHeaders, processColumns, deduplicateHeaders, deduplicateHeadersWithRenames } from "./utils/row.js";
+// =============================================================================
+// Extras (opt-in utilities - inline for tree-shaking)
+// =============================================================================
+// Dynamic Typing utilities
+export { applyDynamicTyping, applyDynamicTypingToRow } from "./utils/dynamic-typing.js";
+// CSV Generator utilities
+export { csvGenerate, csvGenerateRows, csvGenerateAsync, csvGenerateData, createCsvGenerator } from "./utils/generate.js";
+// Number formatting utilities
+export { formatNumberForCsv, parseNumberFromCsv } from "./utils/number.js";
+// =============================================================================
+// Errors
+// =============================================================================
+export { CsvError, CsvWorkerError } from "./errors.js";

package/dist/browser/modules/csv/parse/async.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Async CSV Parser
+ *
+ * Provides async CSV parsing supporting:
+ * - String input (delegates to sync parser)
+ * - AsyncIterable<string|Uint8Array> inputs
+ * - ReadableStream inputs (WHATWG streams)
+ *
+ * API Semantics:
+ * - parseCsvAsync(): Collects all rows into memory, returns full CsvParseResult.
+ *   Best for small-to-medium files where you need complete data at once.
+ *
+ * - parseCsvRows(): True streaming async generator that yields rows one at a time.
+ *   Best for large files or when processing rows incrementally.
+ *   Memory-efficient as it doesn't buffer the entire result.
+ *
+ * Note: Both functions are async but have different memory characteristics.
+ * parseCsvAsync buffers the entire input; parseCsvRows streams progressively.
+ */
+import type { CsvParseOptions, CsvParseArrayOptions, CsvParseObjectOptions, CsvParseResult, RecordWithInfo } from "../types.js";
+type ReadableStreamLike = {
+    getReader: () => any;
+};
+type AsyncInput = AsyncIterable<string | Uint8Array>;
+type AnyAsyncInput = AsyncInput | ReadableStreamLike;
+type CsvAsyncInput = string | AnyAsyncInput;
+/**
+ * Parse CSV asynchronously.
+ *
+ * For string input, this simply wraps the sync parser.
+ * For AsyncIterable input (streams), collects chunks and parses.
+ *
+ * @example
+ * ```ts
+ * // From string
+ * const result = await parseCsvAsync("a,b\n1,2", { headers: true });
+ *
+ * // From fetch response
+ * const response = await fetch("data.csv");
+ * const result = await parseCsvAsync(response.body, { headers: true });
+ *
+ * // From file stream (Node.js)
+ * import { createReadStream } from "fs";
+ * const result = await parseCsvAsync(createReadStream("data.csv"), { headers: true });
+ * ```
+ */
+/**
+ * Parse CSV async - returns string[][] when no options provided.
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput): Promise<string[][]>;
+/**
+ * Parse CSV async - returns string[][] when headers is false/undefined and no info option.
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput, options: CsvParseArrayOptions & {
+    info?: false;
+}): Promise<string[][]>;
+/**
+ * Parse CSV async - returns CsvParseResult with RecordWithInfo when info: true (array mode).
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput, options: CsvParseArrayOptions & {
+    info: true;
+}): Promise<CsvParseResult<RecordWithInfo<string[]>>>;
+/**
+ * Parse CSV async - returns CsvParseResult when headers are enabled.
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput, options: CsvParseObjectOptions & {
+    info?: false;
+}): Promise<CsvParseResult<Record<string, unknown>>>;
+/**
+ * Parse CSV async - returns CsvParseResult with RecordWithInfo when info: true (object mode).
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput, options: CsvParseObjectOptions & {
+    info: true;
+}): Promise<CsvParseResult<RecordWithInfo<Record<string, unknown>>>>;
+/**
+ * Parse CSV async - general overload for backward compatibility.
+ */
+export declare function parseCsvAsync(input: CsvAsyncInput, options: CsvParseOptions): Promise<string[][] | CsvParseResult<Record<string, string>> | CsvParseResult<Record<string, unknown>> | CsvParseResult<RecordWithInfo<Record<string, unknown>>> | CsvParseResult<RecordWithInfo<string[]>>>;
+/**
+ * Parse CSV as an async generator, yielding rows as they are parsed.
+ * This is the true streaming version that yields rows one at a time.
+ *
+ * @example
+ * ```ts
+ * // Process large file row by row
+ * for await (const row of parseCsvRows(fileStream, { headers: true })) {
+ *   console.log(row);
+ * }
+ *
+ * // With validation
+ * for await (const row of parseCsvRows(input, {
+ *   headers: true,
+ *   validate: (row) => row.id !== ""
+ * })) {
+ *   // Only valid rows
+ * }
+ * ```
+ */
+export declare function parseCsvRows(input: string | AnyAsyncInput, options?: CsvParseOptions): AsyncGenerator<Record<string, unknown> | string[] | RecordWithInfo<Record<string, unknown>> | RecordWithInfo<string[]>, void, unknown>;
+/**
+ * Parse CSV with progress callback for large files.
+ *
+ * @param input - CSV string or async iterable
+ * @param options - Parse options
+ * @param onProgress - Called periodically with progress info
+ */
+export declare function parseCsvWithProgress(input: string | AnyAsyncInput, options?: CsvParseOptions, onProgress?: (info: {
+    rowsProcessed: number;
+    bytesProcessed?: number;
+}) => void): Promise<string[][] | CsvParseResult<Record<string, string>> | CsvParseResult<Record<string, unknown>> | CsvParseResult<RecordWithInfo<Record<string, unknown>>> | CsvParseResult<RecordWithInfo<string[]>>>;
+export {};