web-csv-toolbox 0.11.0-next-5d01c3998b1d65f9ecf06ae0cb3ec382001832c5 → 0.11.0-next-705a38880da3e4e52fe9a761222deadb93ff518f

package/dist/es/parseStringStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringStream.js","sources":["../../src/parseStringStream.ts"],"sourcesContent":["import type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { parseStringStreamToStream } from \"./parseStringStreamToStream.ts\";\nimport { convertStreamToAsyncIterableIterator } from \"./utils/convertStreamToAsyncIterableIterator.ts\";\nimport * as internal from \"./utils/convertThisAsyncIterableIteratorToArray.ts\";\n\n/**\n * Parse CSV string stream to records.\n *\n * @category Middle-level API\n * @param stream CSV string stream to parse\n * @param options Parsing options.\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseStringStream.toArray} function.\n *\n * @example Parsing CSV files from strings\n *\n * ```ts\n * import { parseStringStream } from 'web-csv-toolbox';\n *\n * const csv = `name,age\n * Alice,42\n * Bob,69`;\n *\n * const stream = new ReadableStream({\n *  start(controller) {\n *     controller.enqueue(csv);\n *     controller.close();\n *   },\n * });\n *\n * for await (const record of parseStringStream(csv)) {\n *   console.log(record);\n * }\n * // Prints:\n * // { name: 'Alice', age: '42' }\n * // { name: 'Bob', age: '69' }\n * ```\n */\nexport function parseStringStream<Header extends ReadonlyArray<string>>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  const recordStream = parseStringStreamToStream(stream, options);\n  return convertStreamToAsyncIterableIterator(recordStream);\n}\n\nexport declare namespace parseStringStream {\n  /**\n   * Parse CSV string stream to records.\n   *\n   * @returns Array of records\n   *\n   * @example\n   *\n   * ```ts\n   * import { parseStringStream } from 'web-csv-toolbox';\n   *\n   * const csv = `name,age\n   * Alice,42\n   * Bob,69`;\n   *\n   * const stream = new ReadableStream({\n   *   start(controller) {\n   *     controller.enqueue(csv);\n   *     controller.close();\n   *   },\n   * });\n   *\n   * const records = await parseStringStream.toArray(stream);\n   * console.log(records);\n   * // Prints:\n   * // [ { name: 'Alice', age: '42' }, { name: 'Bob', age: '69' } ]\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    stream: ReadableStream<string>,\n    options?: ParseOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV string stream to records.\n   *\n   * @returns Array of records\n   *\n   * @example\n   *\n   * ```ts\n   * import { parseStringStream } from 'web-csv-toolbox';\n   *\n   * const csv = `name,age\n   * Alice,42\n   * Bob,69`;\n   *\n   * const stream = new ReadableStream({\n   *   start(controller) {\n   *     controller.enqueue(csv);\n   *     controller.close();\n   *   },\n   * });\n   *\n   * await parseStringStream.toStream(stream)\n   *   .pipeTo(\n   *     new WritableStream({\n   *       write(record) {\n   *       console.log(record);\n   *     },\n   *   }),\n   * );\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    stream: ReadableStream<string>,\n    options?: ParseOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseStringStream, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: internal.convertThisAsyncIterableIteratorToArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseStringStreamToStream,\n  },\n});\n"],"names":["internal.convertThisAsyncIterableIteratorToArray"],"mappings":";;;;AAuCgB,SAAA,iBAAA,CACd,QACA,OAC0C,EAAA;AAC1C,EAAM,MAAA,YAAA,GAAe,yBAA0B,CAAA,MAAA,EAAQ,OAAO,CAAA,CAAA;AAC9D,EAAA,OAAO,qCAAqC,YAAY,CAAA,CAAA;AAC1D,CAAA;AAuEA,MAAA,CAAO,iBAAiB,iBAAmB,EAAA;AAAA,EACzC,OAAS,EAAA;AAAA,IACP,UAAY,EAAA,IAAA;AAAA,IACZ,QAAU,EAAA,KAAA;AAAA,IACV,OAAOA,uCAAS;AAAA,GAClB;AAAA,EACA,QAAU,EAAA;AAAA,IACR,UAAY,EAAA,IAAA;AAAA,IACZ,QAAU,EAAA,KAAA;AAAA,IACV,KAAO,EAAA,yBAAA;AAAA,GACT;AACF,CAAC,CAAA;;;;"}
+{"version":3,"file":"parseStringStream.js","sources":["../../src/parseStringStream.ts"],"sourcesContent":["import type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"./constants.ts\";\nimport { parseStringStreamToStream } from \"./parseStringStreamToStream.ts\";\nimport { convertStreamToAsyncIterableIterator } from \"./utils/convertStreamToAsyncIterableIterator.ts\";\nimport * as internal from \"./utils/convertThisAsyncIterableIteratorToArray.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\n/**\n * Parse CSV string stream to records.\n *\n * @category Middle-level API\n * @param stream CSV string stream to parse\n * @param options Parsing options.\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseStringStream.toArray} function.\n *\n * @example Parsing CSV files from strings\n *\n * ```ts\n * import { parseStringStream } from 'web-csv-toolbox';\n *\n * const csv = `name,age\n * Alice,42\n * Bob,69`;\n *\n * const stream = new ReadableStream({\n *  start(controller) {\n *     controller.enqueue(csv);\n *     controller.close();\n *   },\n * });\n *\n * for await (const record of parseStringStream(csv)) {\n *   console.log(record);\n * }\n * // Prints:\n * // { name: 'Alice', age: '42' }\n * // { name: 'Bob', age: '69' }\n * ```\n */\nexport function parseStringStream<\n  const CSVSource extends ReadableStream<string>,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  csv: CSVSource,\n  options: ParseOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>>;\nexport function parseStringStream<\n  const CSVSource extends ReadableStream<string>,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(\n  csv: CSVSource,\n  options?: ParseOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>>;\nexport function parseStringStream<const Header extends ReadonlyArray<string>>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>>;\nexport function parseStringStream<Header extends ReadonlyArray<string>>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  const recordStream = parseStringStreamToStream(stream, options);\n  return convertStreamToAsyncIterableIterator(recordStream);\n}\n\nexport declare namespace parseStringStream {\n  /**\n   * Parse CSV string stream to records.\n   *\n   * @returns Array of records\n   *\n   * @example\n   *\n   * ```ts\n   * import { parseStringStream } from 'web-csv-toolbox';\n   *\n   * const csv = `name,age\n   * Alice,42\n   * Bob,69`;\n   *\n   * const stream = new ReadableStream({\n   *   start(controller) {\n   *     controller.enqueue(csv);\n   *     controller.close();\n   *   },\n   * });\n   *\n   * const records = await parseStringStream.toArray(stream);\n   * console.log(records);\n   * // Prints:\n   * // [ { name: 'Alice', age: '42' }, { name: 'Bob', age: '69' } ]\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    stream: ReadableStream<string>,\n    options?: ParseOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV string stream to records.\n   *\n   * @returns Array of records\n   *\n   * @example\n   *\n   * ```ts\n   * import { parseStringStream } from 'web-csv-toolbox';\n   *\n   * const csv = `name,age\n   * Alice,42\n   * Bob,69`;\n   *\n   * const stream = new ReadableStream({\n   *   start(controller) {\n   *     controller.enqueue(csv);\n   *     controller.close();\n   *   },\n   * });\n   *\n   * await parseStringStream.toStream(stream)\n   *   .pipeTo(\n   *     new WritableStream({\n   *       write(record) {\n   *       console.log(record);\n   *     },\n   *   }),\n   * );\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    stream: ReadableStream<string>,\n    options?: ParseOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseStringStream, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: internal.convertThisAsyncIterableIteratorToArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseStringStreamToStream,\n  },\n});\n"],"names":["internal.convertThisAsyncIterableIteratorToArray"],"mappings":";;;;AAiEgB,SAAA,iBAAA,CACd,QACA,OAC0C,EAAA;AAC1C,EAAM,MAAA,YAAA,GAAe,yBAA0B,CAAA,MAAA,EAAQ,OAAO,CAAA,CAAA;AAC9D,EAAA,OAAO,qCAAqC,YAAY,CAAA,CAAA;AAC1D,CAAA;AAuEA,MAAA,CAAO,iBAAiB,iBAAmB,EAAA;AAAA,EACzC,OAAS,EAAA;AAAA,IACP,UAAY,EAAA,IAAA;AAAA,IACZ,QAAU,EAAA,KAAA;AAAA,IACV,OAAOA,uCAAS;AAAA,GAClB;AAAA,EACA,QAAU,EAAA;AAAA,IACR,UAAY,EAAA,IAAA;AAAA,IACZ,QAAU,EAAA,KAAA;AAAA,IACV,KAAO,EAAA,yBAAA;AAAA,GACT;AACF,CAAC,CAAA;;;;"}

package/dist/es/parseStringStreamToStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringStreamToStream.js","sources":["../../src/parseStringStreamToStream.ts"],"sourcesContent":["import { LexerTransformer } from \"./LexerTransformer.ts\";\nimport { RecordAssemblerTransformer } from \"./RecordAssemblerTransformer.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { pipeline } from \"./utils/pipeline.ts\";\n\nexport function parseStringStreamToStream<Header extends ReadonlyArray<string>>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  return pipeline(\n    stream,\n    new LexerTransformer(options),\n    new RecordAssemblerTransformer(options),\n  );\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,yBAAA,CACd,QACA,OACmC,EAAA;AACnC,EAAO,OAAA,QAAA;AAAA,IACL,MAAA;AAAA,IACA,IAAI,iBAAiB,OAAO,CAAA;AAAA,IAC5B,IAAI,2BAA2B,OAAO,CAAA;AAAA,GACxC,CAAA;AACF;;;;"}
+{"version":3,"file":"parseStringStreamToStream.js","sources":["../../src/parseStringStreamToStream.ts"],"sourcesContent":["import { LexerTransformer } from \"./LexerTransformer.ts\";\nimport { RecordAssemblerTransformer } from \"./RecordAssemblerTransformer.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"./constants.ts\";\nimport { pipeline } from \"./utils/pipeline.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\nexport function parseStringStreamToStream<\n  const CSVSource extends ReadableStream<string>,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  stream: CSVSource,\n  options: ParseOptions<Header, Delimiter, Quotation>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringStreamToStream<\n  const CSVSource extends ReadableStream<string>,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(\n  stream: CSVSource,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringStreamToStream<\n  const Header extends ReadonlyArray<string>,\n>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringStreamToStream<\n  const Header extends ReadonlyArray<string>,\n>(\n  stream: ReadableStream<string>,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  return pipeline(\n    stream,\n    new LexerTransformer(options),\n    new RecordAssemblerTransformer(options),\n  );\n}\n"],"names":[],"mappings":";;;;AAiCgB,SAAA,yBAAA,CAGd,QACA,OACmC,EAAA;AACnC,EAAO,OAAA,QAAA;AAAA,IACL,MAAA;AAAA,IACA,IAAI,iBAAiB,OAAO,CAAA;AAAA,IAC5B,IAAI,2BAA2B,OAAO,CAAA;AAAA,GACxC,CAAA;AACF;;;;"}

package/dist/es/parseStringToArraySync.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToArraySync.js","sources":["../../src/parseStringToArraySync.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\n\nexport function parseStringToArraySync<Header extends ReadonlyArray<string>>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): CSVRecord<Header>[] {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    const tokens = lexer.lex(csv);\n    return [...assembler.assemble(tokens)];\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,sBAAA,CACd,KACA,OACqB,EAAA;AACrB,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,IAAA,OAAO,CAAC,GAAG,SAAU,CAAA,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA;AAAA,WAC9B,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}
+{"version":3,"file":"parseStringToArraySync.js","sources":["../../src/parseStringToArraySync.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"./constants.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\nexport function parseStringToArraySync<\n  const CSVSource extends string,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  csv: CSVSource,\n  options: ParseOptions<Header, Delimiter, Quotation>,\n): CSVRecord<Header>[];\nexport function parseStringToArraySync<\n  const CSVSource extends string,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(csv: CSVSource, options?: ParseOptions<Header>): CSVRecord<Header>[];\nexport function parseStringToArraySync<\n  const Header extends ReadonlyArray<string>,\n>(csv: string, options?: ParseOptions<Header>): CSVRecord<Header>[];\nexport function parseStringToArraySync<\n  const Header extends ReadonlyArray<string>,\n>(csv: string, options?: ParseOptions<Header>): CSVRecord<Header>[] {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    const tokens = lexer.lex(csv);\n    return [...assembler.assemble(tokens)];\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AA2BgB,SAAA,sBAAA,CAEd,KAAa,OAAqD,EAAA;AAClE,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,IAAA,OAAO,CAAC,GAAG,SAAU,CAAA,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA;AAAA,WAC9B,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}

package/dist/es/parseStringToArraySyncWASM.js

@@ -1,9 +1,9 @@
 import { parseStringToArraySync } from './_virtual/_web-csv-toolbox-wasm.js';
 import { assertCommonOptions } from './assertCommonOptions.js';
-import { DOUBLE_QUOTE, COMMA } from './constants.js';
+import { DOUBLE_QUOTE, DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.js';
 
 function parseStringToArraySyncWASM(csv, options = {}) {
-  const { delimiter = COMMA, quotation = DOUBLE_QUOTE } = options;
+  const { delimiter = DEFAULT_DELIMITER, quotation = DEFAULT_QUOTATION } = options;
   if (typeof delimiter !== "string" || delimiter.length !== 1) {
     throw new RangeError(
       "Invalid delimiter, must be a single character on WASM."

package/dist/es/parseStringToArraySyncWASM.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToArraySyncWASM.js","sources":["../../src/parseStringToArraySyncWASM.ts"],"sourcesContent":["import { parseStringToArraySync } from \"web-csv-toolbox-wasm\";\nimport { assertCommonOptions } from \"./assertCommonOptions.ts\";\nimport type { CSVRecord, CommonOptions } from \"./common/types.ts\";\nimport { COMMA, DOUBLE_QUOTE } from \"./constants.ts\";\nimport type { loadWASM } from \"./loadWASM.ts\";\n\n/**\n * Parse CSV string to record of arrays.\n *\n * @param csv CSV string\n * @param options Parse options\n * @returns Record of arrays\n *\n * @remarks\n * This function uses WebAssembly to parse CSV string.\n * Before calling this function, you must call {@link loadWASM} function.\n *\n * This function only supports UTF-8 string.\n * If you pass a string that is not UTF-8, like UTF-16, it throws an error.\n * This function only supports double quote as quotation.\n * So, `options.quotation` must be `\"` (double quote). Otherwise, it throws an error.\n *\n * And this function only supports single character as delimiter.\n * So, `options.delimiter` must be a single character. Otherwise, it throws an error.\n *\n * @example\n *\n * ```ts\n * import { loadWASM, parseStringWASM } from \"web-csv-toolbox\";\n *\n * await loadWASM();\n *\n * const csv = \"a,b,c\\n1,2,3\";\n *\n * const result = parseStringToArraySyncWASM(csv);\n * console.log(result);\n * // Prints:\n * // [{ a: \"1\", b: \"2\", c: \"3\" }]\n * ```\n * @beta\n * @throws {RangeError | TypeError} - If provided options are invalid.\n */\nexport function parseStringToArraySyncWASM<Header extends readonly string[]>(\n  csv: string,\n  options: CommonOptions = {},\n): CSVRecord<Header>[] {\n  const { delimiter = COMMA, quotation = DOUBLE_QUOTE } = options;\n  if (typeof delimiter !== \"string\" || delimiter.length !== 1) {\n    throw new RangeError(\n      \"Invalid delimiter, must be a single character on WASM.\",\n    );\n  }\n  if (quotation !== DOUBLE_QUOTE) {\n    throw new RangeError(\"Invalid quotation, must be double quote on WASM.\");\n  }\n  assertCommonOptions({ delimiter, quotation });\n  const demiliterCode = delimiter.charCodeAt(0);\n  return JSON.parse(parseStringToArraySync(csv, demiliterCode));\n}\n"],"names":[],"mappings":";;;;AA0CO,SAAS,0BACd,CAAA,GAAA,EACA,OAAyB,GAAA,EACJ,EAAA;AACrB,EAAA,MAAM,EAAE,SAAA,GAAY,KAAO,EAAA,SAAA,GAAY,cAAiB,GAAA,OAAA,CAAA;AACxD,EAAA,IAAI,OAAO,SAAA,KAAc,QAAY,IAAA,SAAA,CAAU,WAAW,CAAG,EAAA;AAC3D,IAAA,MAAM,IAAI,UAAA;AAAA,MACR,wDAAA;AAAA,KACF,CAAA;AAAA,GACF;AACA,EAAA,IAAI,cAAc,YAAc,EAAA;AAC9B,IAAM,MAAA,IAAI,WAAW,kDAAkD,CAAA,CAAA;AAAA,GACzE;AACA,EAAoB,mBAAA,CAAA,EAAE,SAAW,EAAA,SAAA,EAAW,CAAA,CAAA;AAC5C,EAAM,MAAA,aAAA,GAAgB,SAAU,CAAA,UAAA,CAAW,CAAC,CAAA,CAAA;AAC5C,EAAA,OAAO,IAAK,CAAA,KAAA,CAAM,sBAAuB,CAAA,GAAA,EAAK,aAAa,CAAC,CAAA,CAAA;AAC9D;;;;"}
+{"version":3,"file":"parseStringToArraySyncWASM.js","sources":["../../src/parseStringToArraySyncWASM.ts"],"sourcesContent":["import { parseStringToArraySync } from \"web-csv-toolbox-wasm\";\nimport { assertCommonOptions } from \"./assertCommonOptions.ts\";\nimport type { CSVRecord, CommonOptions } from \"./common/types.ts\";\nimport {\n  DEFAULT_DELIMITER,\n  DEFAULT_QUOTATION,\n  DOUBLE_QUOTE,\n} from \"./constants.ts\";\nimport type { loadWASM } from \"./loadWASM.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\n/**\n * Parse CSV string to record of arrays.\n *\n * @param csv CSV string\n * @param options Parse options\n * @returns Record of arrays\n *\n * @remarks\n * This function uses WebAssembly to parse CSV string.\n * Before calling this function, you must call {@link loadWASM} function.\n *\n * This function only supports UTF-8 string.\n * If you pass a string that is not UTF-8, like UTF-16, it throws an error.\n * This function only supports double quote as quotation.\n * So, `options.quotation` must be `\"` (double quote). Otherwise, it throws an error.\n *\n * And this function only supports single character as delimiter.\n * So, `options.delimiter` must be a single character. Otherwise, it throws an error.\n *\n * @example\n *\n * ```ts\n * import { loadWASM, parseStringWASM } from \"web-csv-toolbox\";\n *\n * await loadWASM();\n *\n * const csv = \"a,b,c\\n1,2,3\";\n *\n * const result = parseStringToArraySyncWASM(csv);\n * console.log(result);\n * // Prints:\n * // [{ a: \"1\", b: \"2\", c: \"3\" }]\n * ```\n * @beta\n * @throws {RangeError | TypeError} - If provided options are invalid.\n */\nexport function parseStringToArraySyncWASM<\n  const CSVSource extends string,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  csv: CSVSource,\n  options: CommonOptions<Delimiter, Quotation>,\n): CSVRecord<Header>[];\nexport function parseStringToArraySyncWASM<\n  const CSVSource extends string,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(\n  csv: CSVSource,\n  options?: CommonOptions<Delimiter, Quotation>,\n): CSVRecord<Header>[];\nexport function parseStringToArraySyncWASM<\n  const Header extends ReadonlyArray<string>,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n>(\n  csv: string,\n  options?: CommonOptions<Delimiter, Quotation>,\n): CSVRecord<Header>[];\nexport function parseStringToArraySyncWASM<\n  const Header extends readonly string[],\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n>(\n  csv: string,\n  options: CommonOptions<Delimiter, Quotation> = {},\n): CSVRecord<Header>[] {\n  const { delimiter = DEFAULT_DELIMITER, quotation = DEFAULT_QUOTATION } =\n    options;\n  if (typeof delimiter !== \"string\" || delimiter.length !== 1) {\n    throw new RangeError(\n      \"Invalid delimiter, must be a single character on WASM.\",\n    );\n  }\n  if (quotation !== DOUBLE_QUOTE) {\n    throw new RangeError(\"Invalid quotation, must be double quote on WASM.\");\n  }\n  assertCommonOptions({ delimiter, quotation });\n  const demiliterCode = delimiter.charCodeAt(0);\n  return JSON.parse(parseStringToArraySync(csv, demiliterCode));\n}\n"],"names":[],"mappings":";;;;AA6EO,SAAS,0BAKd,CAAA,GAAA,EACA,OAA+C,GAAA,EAC1B,EAAA;AACrB,EAAA,MAAM,EAAE,SAAA,GAAY,iBAAmB,EAAA,SAAA,GAAY,mBACjD,GAAA,OAAA,CAAA;AACF,EAAA,IAAI,OAAO,SAAA,KAAc,QAAY,IAAA,SAAA,CAAU,WAAW,CAAG,EAAA;AAC3D,IAAA,MAAM,IAAI,UAAA;AAAA,MACR,wDAAA;AAAA,KACF,CAAA;AAAA,GACF;AACA,EAAA,IAAI,cAAc,YAAc,EAAA;AAC9B,IAAM,MAAA,IAAI,WAAW,kDAAkD,CAAA,CAAA;AAAA,GACzE;AACA,EAAoB,mBAAA,CAAA,EAAE,SAAW,EAAA,SAAA,EAAW,CAAA,CAAA;AAC5C,EAAM,MAAA,aAAA,GAAgB,SAAU,CAAA,UAAA,CAAW,CAAC,CAAA,CAAA;AAC5C,EAAA,OAAO,IAAK,CAAA,KAAA,CAAM,sBAAuB,CAAA,GAAA,EAAK,aAAa,CAAC,CAAA,CAAA;AAC9D;;;;"}

package/dist/es/parseStringToIterableIterator.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToIterableIterator.js","sources":["../../src/parseStringToIterableIterator.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\n\nexport function parseStringToIterableIterator<\n  Header extends ReadonlyArray<string>,\n>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    const tokens = lexer.lex(csv);\n    return assembler.assemble(tokens);\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,6BAAA,CAGd,KACA,OACqC,EAAA;AACrC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,IAAO,OAAA,SAAA,CAAU,SAAS,MAAM,CAAA,CAAA;AAAA,WACzB,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}
+{"version":3,"file":"parseStringToIterableIterator.js","sources":["../../src/parseStringToIterableIterator.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"./constants.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\nexport function parseStringToIterableIterator<\n  const CSVSource extends string,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  stream: CSVSource,\n  options: ParseOptions<Header, Delimiter, Quotation>,\n): IterableIterator<CSVRecord<Header>>;\nexport function parseStringToIterableIterator<\n  const CSVSource extends string,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(\n  stream: CSVSource,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>>;\nexport function parseStringToIterableIterator<\n  const Header extends ReadonlyArray<string>,\n>(\n  stream: string,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>>;\nexport function parseStringToIterableIterator<\n  const Header extends ReadonlyArray<string>,\n>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    const tokens = lexer.lex(csv);\n    return assembler.assemble(tokens);\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAiCgB,SAAA,6BAAA,CAGd,KACA,OACqC,EAAA;AACrC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,IAAO,OAAA,SAAA,CAAU,SAAS,MAAM,CAAA,CAAA;AAAA,WACzB,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}

package/dist/es/parseStringToStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToStream.js","sources":["../../src/parseStringToStream.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\n\nexport function parseStringToStream<Header extends ReadonlyArray<string>>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    return new ReadableStream({\n      start(controller) {\n        const tokens = lexer.lex(csv);\n        for (const record of assembler.assemble(tokens)) {\n          controller.enqueue(record);\n        }\n        controller.close();\n      },\n    });\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,mBAAA,CACd,KACA,OACmC,EAAA;AACnC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAA,OAAO,IAAI,cAAe,CAAA;AAAA,MACxB,MAAM,UAAY,EAAA;AAChB,QAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,QAAA,KAAA,MAAW,MAAU,IAAA,SAAA,CAAU,QAAS,CAAA,MAAM,CAAG,EAAA;AAC/C,UAAA,UAAA,CAAW,QAAQ,MAAM,CAAA,CAAA;AAAA,SAC3B;AACA,QAAA,UAAA,CAAW,KAAM,EAAA,CAAA;AAAA,OACnB;AAAA,KACD,CAAA,CAAA;AAAA,WACM,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}
+{"version":3,"file":"parseStringToStream.js","sources":["../../src/parseStringToStream.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"./constants.ts\";\nimport type { PickCSVHeader } from \"./utils/types.ts\";\n\nexport function parseStringToStream<\n  const CSVSource extends string,\n  const Delimiter extends string = DEFAULT_DELIMITER,\n  const Quotation extends string = DEFAULT_QUOTATION,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<\n    CSVSource,\n    Delimiter,\n    Quotation\n  >,\n>(\n  stream: CSVSource,\n  options: ParseOptions<Header, Delimiter, Quotation>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringToStream<\n  const CSVSource extends string,\n  const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>,\n>(\n  stream: CSVSource,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringToStream<const Header extends ReadonlyArray<string>>(\n  stream: string,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>>;\nexport function parseStringToStream<const Header extends ReadonlyArray<string>>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    return new ReadableStream({\n      start(controller) {\n        const tokens = lexer.lex(csv);\n        for (const record of assembler.assemble(tokens)) {\n          controller.enqueue(record);\n        }\n        controller.close();\n      },\n    });\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AA+BgB,SAAA,mBAAA,CACd,KACA,OACmC,EAAA;AACnC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAA,OAAO,IAAI,cAAe,CAAA;AAAA,MACxB,MAAM,UAAY,EAAA;AAChB,QAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,QAAA,KAAA,MAAW,MAAU,IAAA,SAAA,CAAU,QAAS,CAAA,MAAM,CAAG,EAAA;AAC/C,UAAA,UAAA,CAAW,QAAQ,MAAM,CAAA,CAAA;AAAA,SAC3B;AACA,QAAA,UAAA,CAAW,KAAM,EAAA,CAAA;AAAA,OACnB;AAAA,KACD,CAAA,CAAA;AAAA,WACM,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}

package/dist/types/Lexer.d.ts

@@ -1,17 +1,18 @@
 import { AbortSignalOptions, CommonOptions, Token } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
 
 /**
  * CSV Lexer.
  *
  * Lexter tokenizes CSV data into fields and records.
  */
-export declare class Lexer {
+export declare class Lexer<Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> {
     #private;
     /**
      * Constructs a new Lexer instance.
      * @param options - The common options for the lexer.
      */
-    constructor({ delimiter, quotation, signal, }?: CommonOptions & AbortSignalOptions);
+    constructor(options?: CommonOptions<Delimiter, Quotation> & AbortSignalOptions);
     /**
      * Lexes the given chunk of CSV data.
      * @param chunk - The chunk of CSV data to be lexed.

package/dist/types/LexerTransformer.d.ts

@@ -1,5 +1,6 @@
 import { Lexer } from './Lexer.ts';
 import { CommonOptions, Token } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
 
 /**
  * A transform stream that converts a stream of tokens into a stream of rows.
@@ -31,7 +32,7 @@ import { CommonOptions, Token } from './common/types.ts';
  * // { type: RecordDelimiter, value: "\r\n", location: {...} }
  * ```
  */
-export declare class LexerTransformer extends TransformStream<string, Token[]> {
-    readonly lexer: Lexer;
-    constructor(options?: CommonOptions);
+export declare class LexerTransformer<Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> extends TransformStream<string, Token[]> {
+    readonly lexer: Lexer<Delimiter, Quotation>;
+    constructor(options?: CommonOptions<Delimiter, Quotation>);
 }

package/dist/types/assertCommonOptions.d.ts

@@ -19,4 +19,4 @@ import { CommonOptions } from './common/types.ts';
  * @throws {RangeError} If any required property is missing or if the delimiter is the same as the quotation.
  * @throws {TypeError} If any required property is not a string.
  */
-export declare function assertCommonOptions(options: Required<CommonOptions>): asserts options is Required<CommonOptions>;
+export declare function assertCommonOptions<Delimiter extends string, Quotation extends string>(options: Required<CommonOptions<Delimiter, Quotation>>): asserts options is Required<CommonOptions<Delimiter, Quotation>>;

package/dist/types/common/types.d.ts

@@ -1,3 +1,5 @@
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from '../constants.ts';
+import { Join } from '../utils/types.ts';
 import { Field, FieldDelimiter, RecordDelimiter } from './constants.ts';
 
 /**
@@ -131,7 +133,7 @@ export interface AbortSignalOptions {
  * CSV Common Options.
  * @category Types
  */
-export interface CommonOptions {
+export interface CommonOptions<Delimiter extends string, Quotation extends string> {
     /**
      * CSV field delimiter.
      * If you want to parse TSV, specify `'\t'`.
@@ -147,13 +149,13 @@ export interface CommonOptions {
      *
      * @default ','
      */
-    delimiter?: string;
+    delimiter?: Delimiter;
     /**
      * CSV field quotation.
      *
      * @default '"'
      */
-    quotation?: string;
+    quotation?: Quotation;
 }
 /**
  * CSV Parsing Options for binary.
@@ -238,7 +240,7 @@ export interface RecordAssemblerOptions<Header extends ReadonlyArray<string>> ex
  * Parse options for CSV string.
  * @category Types
  */
-export interface ParseOptions<Header extends ReadonlyArray<string>> extends CommonOptions, RecordAssemblerOptions<Header>, AbortSignalOptions {
+export interface ParseOptions<Header extends ReadonlyArray<string> = ReadonlyArray<string>, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> extends CommonOptions<Delimiter, Quotation>, RecordAssemblerOptions<Header>, AbortSignalOptions {
 }
 /**
  * Parse options for CSV binary.
@@ -265,7 +267,7 @@ export type CSVRecord<Header extends ReadonlyArray<string>> = Record<Header[numb
  *
  * @category Types
  */
-export type CSVString = string | ReadableStream<string>;
+export type CSVString<Header extends ReadonlyArray<string> = [], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = Header extends readonly [string, ...string[]] ? Join<Header, Delimiter, Quotation> | ReadableStream<Join<Header, Delimiter, Quotation>> : string | ReadableStream<string>;
 /**
  * CSV Binary.
  *
@@ -277,4 +279,4 @@ export type CSVBinary = ReadableStream<Uint8Array> | Response | ArrayBuffer | Ui
  *
  * @category Types
  */
-export type CSV = CSVString | CSVBinary;
+export type CSV<Header extends ReadonlyArray<string> = [], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = Header extends [] ? CSVString | CSVBinary : CSVString<Header, Delimiter, Quotation>;

package/dist/types/constants.d.ts

@@ -1,6 +1,10 @@
 export declare const CR = "\r";
+export type CR = typeof CR;
 export declare const CRLF = "\r\n";
+export type CRLF = typeof CRLF;
 export declare const LF = "\n";
+export type LF = typeof LF;
+export type Newline = CRLF | CR | LF;
 /**
  * COMMA is a symbol for comma(,).
  */
@@ -9,3 +13,7 @@ export declare const COMMA = ",";
  * DOUBLE_QUOTE is a symbol for double quote(").
  */
 export declare const DOUBLE_QUOTE = "\"";
+export declare const DEFAULT_DELIMITER = ",";
+export type DEFAULT_DELIMITER = typeof DEFAULT_DELIMITER;
+export declare const DEFAULT_QUOTATION = "\"";
+export type DEFAULT_QUOTATION = typeof DEFAULT_QUOTATION;

package/dist/types/escapeField.d.ts

@@ -1,6 +1,6 @@
 import { CommonOptions } from './common/types.ts';
 
-export interface EscapeFieldOptions extends CommonOptions {
+export interface EscapeFieldOptions<Delimiter extends string, Quotation extends string> extends CommonOptions<Delimiter, Quotation> {
     quote?: true;
 }
 /**
@@ -11,4 +11,4 @@ export interface EscapeFieldOptions extends CommonOptions {
  * @param options The options.
  * @returns The escaped field.
  */
-export declare function escapeField(value: string, { quotation, delimiter, quote, }?: EscapeFieldOptions): string;
+export declare function escapeField<const Delimiter extends string, const Quotation extends string>(value: string, options?: EscapeFieldOptions<Delimiter, Quotation>): string;

package/dist/types/parse.d.ts

@@ -1,4 +1,6 @@
 import { CSVBinary, CSVRecord, CSVString, ParseBinaryOptions, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
 /**
  * Parse CSV to records.
@@ -105,7 +107,10 @@ import { CSVBinary, CSVRecord, CSVString, ParseBinaryOptions, ParseOptions } fro
  * // { name: 'Bob', age: '69' }
  * ```
  */
-export declare function parse<Header extends ReadonlyArray<string>>(csv: CSVString, options?: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parse<const CSVSource extends CSVString>(csv: CSVSource): AsyncIterableIterator<CSVRecord<PickCSVHeader<CSVSource>>>;
+export declare function parse<const Header extends ReadonlyArray<string>>(csv: CSVString): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parse<const Header extends ReadonlyArray<string>>(csv: CSVString, options: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parse<const CSVSource extends CSVString, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(csv: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): AsyncIterableIterator<CSVRecord<Header>>;
 /**
  * Parse CSV binary to records.
  *
@@ -142,7 +147,7 @@ export declare function parse<Header extends ReadonlyArray<string>>(csv: CSVStri
  * }
  * ```
  */
-export declare function parse<Header extends ReadonlyArray<string>>(csv: CSVBinary, options?: ParseBinaryOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parse<const Header extends ReadonlyArray<string>>(csv: CSVBinary, options?: ParseBinaryOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
 export declare namespace parse {
     /**
      * Parse CSV string to array of records,

package/dist/types/parse.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseString.d.ts

@@ -1,4 +1,6 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
 /**
  * Parse CSV string to records.
@@ -26,7 +28,11 @@ import { CSVRecord, ParseOptions } from './common/types.ts';
  * // { name: 'Bob', age: '69' }
  * ```
  */
-export declare function parseString<Header extends ReadonlyArray<string>>(csv: string, options?: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseString<const CSVSource extends string>(csv: CSVSource): AsyncIterableIterator<CSVRecord<PickCSVHeader<CSVSource>>>;
+export declare function parseString<const Header extends ReadonlyArray<string>>(csv: string): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseString<const Header extends ReadonlyArray<string>>(csv: string, options: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseString<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(csv: CSVSource, options?: ParseOptions<Header, Delimiter, Quotation>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseString(csv: string, options?: ParseOptions): AsyncIterableIterator<CSVRecord<string[]>>;
 export declare namespace parseString {
     /**
      * Parse CSV string to records.

package/dist/types/parseString.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringStream.d.ts

@@ -1,4 +1,6 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
 /**
  * Parse CSV string stream to records.
@@ -34,7 +36,9 @@ import { CSVRecord, ParseOptions } from './common/types.ts';
  * // { name: 'Bob', age: '69' }
  * ```
  */
-export declare function parseStringStream<Header extends ReadonlyArray<string>>(stream: ReadableStream<string>, options?: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseStringStream<const CSVSource extends ReadableStream<string>, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(csv: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseStringStream<const CSVSource extends ReadableStream<string>, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(csv: CSVSource, options?: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
+export declare function parseStringStream<const Header extends ReadonlyArray<string>>(stream: ReadableStream<string>, options?: ParseOptions<Header>): AsyncIterableIterator<CSVRecord<Header>>;
 export declare namespace parseStringStream {
     /**
      * Parse CSV string stream to records.

package/dist/types/parseStringStream.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringStreamToStream.d.ts

@@ -1,3 +1,7 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
-export declare function parseStringStreamToStream<Header extends ReadonlyArray<string>>(stream: ReadableStream<string>, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringStreamToStream<const CSVSource extends ReadableStream<string>, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(stream: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringStreamToStream<const CSVSource extends ReadableStream<string>, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(stream: CSVSource, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringStreamToStream<const Header extends ReadonlyArray<string>>(stream: ReadableStream<string>, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;

package/dist/types/parseStringStreamToStream.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringToArraySync.d.ts

@@ -1,3 +1,7 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
-export declare function parseStringToArraySync<Header extends ReadonlyArray<string>>(csv: string, options?: ParseOptions<Header>): CSVRecord<Header>[];
+export declare function parseStringToArraySync<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(csv: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): CSVRecord<Header>[];
+export declare function parseStringToArraySync<const CSVSource extends string, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(csv: CSVSource, options?: ParseOptions<Header>): CSVRecord<Header>[];
+export declare function parseStringToArraySync<const Header extends ReadonlyArray<string>>(csv: string, options?: ParseOptions<Header>): CSVRecord<Header>[];

package/dist/types/parseStringToArraySync.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringToArraySyncWASM.d.ts

@@ -1,4 +1,6 @@
 import { CSVRecord, CommonOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
 /**
  * Parse CSV string to record of arrays.
@@ -36,4 +38,6 @@ import { CSVRecord, CommonOptions } from './common/types.ts';
  * @beta
  * @throws {RangeError | TypeError} - If provided options are invalid.
  */
-export declare function parseStringToArraySyncWASM<Header extends readonly string[]>(csv: string, options?: CommonOptions): CSVRecord<Header>[];
+export declare function parseStringToArraySyncWASM<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(csv: CSVSource, options: CommonOptions<Delimiter, Quotation>): CSVRecord<Header>[];
+export declare function parseStringToArraySyncWASM<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(csv: CSVSource, options?: CommonOptions<Delimiter, Quotation>): CSVRecord<Header>[];
+export declare function parseStringToArraySyncWASM<const Header extends ReadonlyArray<string>, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION>(csv: string, options?: CommonOptions<Delimiter, Quotation>): CSVRecord<Header>[];

package/dist/types/parseStringToArraySyncWASM.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringToIterableIterator.d.ts

@@ -1,3 +1,7 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
-export declare function parseStringToIterableIterator<Header extends ReadonlyArray<string>>(csv: string, options?: ParseOptions<Header>): IterableIterator<CSVRecord<Header>>;
+export declare function parseStringToIterableIterator<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(stream: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): IterableIterator<CSVRecord<Header>>;
+export declare function parseStringToIterableIterator<const CSVSource extends string, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(stream: CSVSource, options?: ParseOptions<Header>): IterableIterator<CSVRecord<Header>>;
+export declare function parseStringToIterableIterator<const Header extends ReadonlyArray<string>>(stream: string, options?: ParseOptions<Header>): IterableIterator<CSVRecord<Header>>;

package/dist/types/parseStringToIterableIterator.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseStringToStream.d.ts

@@ -1,3 +1,7 @@
 import { CSVRecord, ParseOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from './constants.ts';
+import { PickCSVHeader } from './utils/types.ts';
 
-export declare function parseStringToStream<Header extends ReadonlyArray<string>>(csv: string, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringToStream<const CSVSource extends string, const Delimiter extends string = DEFAULT_DELIMITER, const Quotation extends string = DEFAULT_QUOTATION, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource, Delimiter, Quotation>>(stream: CSVSource, options: ParseOptions<Header, Delimiter, Quotation>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringToStream<const CSVSource extends string, const Header extends ReadonlyArray<string> = PickCSVHeader<CSVSource>>(stream: CSVSource, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;
+export declare function parseStringToStream<const Header extends ReadonlyArray<string>>(stream: string, options?: ParseOptions<Header>): ReadableStream<CSVRecord<Header>>;

package/dist/types/parseStringToStream.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/types.d.ts

@@ -0,0 +1,115 @@
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION, Newline } from '../constants.ts';
+import { CSVString } from '../web-csv-toolbox.ts';
+
+/**
+ * Generate new string by concatenating all of the elements in array.
+ *
+ * @category Types
+ *
+ * @example Default
+ *
+ * ```ts
+ * const header = ["name", "age", "city", "zip"];
+ *
+ * type _ = Join<typeof header>
+ * // `name,age,city,zip`
+ * ```
+ *
+ * @example With different delimiter and quotation
+ *
+ * ```ts
+ * const header = ["name", "a\nge", "city", "zip"];
+ *
+ * type _ = Join<typeof header, "@", "$">
+ * // `name@$a\nge$@city@zip`
+ * ```
+ */
+export type Join<Chars extends ReadonlyArray<string | number | boolean | bigint>, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>> = Chars extends readonly [infer F, ...infer R] ? F extends string ? R extends string[] ? `${F extends `${string}${Nl | Delimiter | Quotation}${string}` ? `${Quotation}${F}${Quotation}` : F}${R extends [] ? "" : Delimiter}${Join<R, Delimiter, Quotation>}` : string : string : "";
+/**
+ * Generate a delimiter-separated tuple from a string.
+ *
+ * @category Types
+ *
+ * @example Default
+ *
+ * ```ts
+ * const header = `name,age,city,zip`;
+ *
+ * type _ = Split<typeof header>
+ * // ["name", "age", "city", "zip"]
+ * ```
+ *
+ * @example With different delimiter and quotation
+ *
+ * ```ts
+ * const header = `name@$a
+ * ge$@city@zip`;
+ *
+ * type _ = Split<typeof header, "@", "$">
+ * // ["name", "a\nge", "city", "zip"]
+ * ```
+ */
+export type Split<Char extends string, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Escaping extends boolean = false, Col extends string = "", Result extends string[] = []> = Char extends `${Delimiter}${infer R}` ? Escaping extends true ? Split<R, Delimiter, Quotation, true, `${Col}${Delimiter}`, Result> : Split<R, Delimiter, Quotation, false, "", [...Result, Col]> : Char extends `${Quotation}${infer R}` ? Escaping extends true ? R extends "" | Delimiter | `${Delimiter}${string}` ? Split<R, Delimiter, Quotation, false, Col, Result> : Split<R, Delimiter, Quotation, true, `${Col}${Quotation}`, Result> : Split<R, Delimiter, Quotation, true, Col, Result> : Char extends `${infer F}${infer R}` ? Split<R, Delimiter, Quotation, Escaping, `${Col}${F}`, Result> : [...Result, Col] extends [""] ? readonly string[] : readonly [...Result, Col];
+type ExtractString<Source extends CSVString> = Source extends `${infer S}` | ReadableStream<infer S> ? S : string;
+type ExtractCSVBody<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>, Escaping extends boolean = false> = ExtractString<CSVSource> extends `${Quotation}${infer R}` ? Escaping extends true ? R extends Delimiter | Nl | `${Delimiter | Nl}${string}` ? ExtractCSVBody<R, Delimiter, Quotation, Nl, false> : ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : ExtractString<CSVSource> extends `${infer _ extends Nl}${infer R}` ? Escaping extends true ? ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : R : ExtractString<CSVSource> extends `${infer _}${infer R}` ? ExtractCSVBody<R, Delimiter, Quotation, Nl, Escaping> : "";
+/**
+ * Extract a CSV header string from a CSVString.
+ *
+ * @category Types
+ *
+ * @example Default
+ *
+ * ```ts
+ * const csv = `name,age
+ * Alice,42
+ * Bob,69`;
+ *
+ * type _ = ExtractCSVHeader<typeof csv>
+ * // "name,age"
+ * ```
+ *
+ * @example With different delimiter and quotation
+ *
+ * ```ts
+ * const csv = `name@$a
+ * ge$
+ * $Ali
+ * ce$@42
+ * Bob@69`;
+ *
+ * type _ = ExtractCSVHeader<typeof csv, "@", "$">
+ * // "name@$a\nge$"
+ * ```
+ */
+export type ExtractCSVHeader<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>, Escaping extends boolean = false> = ExtractString<CSVSource> extends `${infer Header}${Newline}${ExtractCSVBody<CSVSource, Delimiter, Quotation, Nl, Escaping>}` ? Header : ExtractString<CSVSource>;
+/**
+ * Generates a delimiter-separated tuple of CSV headers from a CSVString.
+ *
+ * @category Types
+ *
+ * @example Default
+ *
+ * ```ts
+ * const csv = `name,age
+ * Alice,42
+ * Bob,69`;
+ *
+ * type _ = PickCSVHeader<typeof csv>
+ * // ["name", "age"]
+ * ```
+ *
+ * @example With different delimiter and quotation
+ *
+ * ```ts
+ * const csv = `name@$a
+ * ge$
+ * $Ali
+ * ce$@42
+ * Bob@69`;
+ *
+ * type _ = PickCSVHeader<typeof csv, "@", "$">
+ * // ["name", "a\nge"]
+ * ```
+ */
+export type PickCSVHeader<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = ExtractString<CSVSource> extends `${infer S}` ? Split<ExtractCSVHeader<S, Delimiter, Quotation>, Delimiter, Quotation> : ReadonlyArray<string>;
+export {};

package/dist/types/utils/types.test-d.d.ts

@@ -0,0 +1 @@
+export {};