web-csv-toolbox 0.14.0-next-386eebeaafe5857e28c876345c14c9fe5f1a3774 → 0.14.0-next-978b88933762ecc27270ce746b80a3fa7ed8c4f7

package/dist/utils/types.d.ts

@@ -1,16 +1,21 @@
+import { CSVString } from '../common/types.ts';
 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.
+ * Join CSV field array into a CSV-formatted string with proper escaping.
  *
  * @category Types
  *
+ * @remarks
+ * This type handles CSV-specific formatting:
+ * - Quotes fields containing delimiters, quotations, or newlines
+ * - Joins fields with the specified delimiter
+ *
  * @example Default
  *
  * ```ts
  * const header = ["name", "age", "city", "zip"];
  *
- * type _ = Join<typeof header>
+ * type _ = JoinCSVFields<typeof header>
  * // `name,age,city,zip`
  * ```
  *
@@ -19,22 +24,28 @@ import { CSVString } from '../web-csv-toolbox.ts';
  * ```ts
  * const header = ["name", "a\nge", "city", "zip"];
  *
- * type _ = Join<typeof header, "@", "$">
+ * type _ = JoinCSVFields<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 : "";
+export type JoinCSVFields<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}${JoinCSVFields<R, Delimiter, Quotation>}` : string : string : "";
 /**
- * Generate a delimiter-separated tuple from a string.
+ * Split CSV-formatted string into field array with proper unescaping.
  *
  * @category Types
  *
+ * @remarks
+ * This type handles CSV-specific parsing:
+ * - Unquotes quoted fields
+ * - Handles escaped quotation marks
+ * - Splits by the specified delimiter
+ *
  * @example Default
  *
  * ```ts
  * const header = `name,age,city,zip`;
  *
- * type _ = Split<typeof header>
+ * type _ = SplitCSVFields<typeof header>
  * // ["name", "age", "city", "zip"]
  * ```
  *
@@ -44,11 +55,11 @@ export type Join<Chars extends ReadonlyArray<string | number | boolean | bigint>
  * const header = `name@$a
  * ge$@city@zip`;
  *
- * type _ = Split<typeof header, "@", "$">
+ * type _ = SplitCSVFields<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];
+export type SplitCSVFields<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 ? SplitCSVFields<R, Delimiter, Quotation, true, `${Col}${Delimiter}`, Result> : SplitCSVFields<R, Delimiter, Quotation, false, "", [...Result, Col]> : Char extends `${Quotation}${infer R}` ? Escaping extends true ? R extends "" | Delimiter | `${Delimiter}${string}` ? SplitCSVFields<R, Delimiter, Quotation, false, Col, Result> : SplitCSVFields<R, Delimiter, Quotation, true, `${Col}${Quotation}`, Result> : SplitCSVFields<R, Delimiter, Quotation, true, Col, Result> : Char extends `${infer F}${infer R}` ? SplitCSVFields<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> : "";
 /**
@@ -110,5 +121,5 @@ export type ExtractCSVHeader<CSVSource extends CSVString, Delimiter extends stri
  * // ["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 type PickCSVHeader<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = ExtractString<CSVSource> extends `${infer S}` ? SplitCSVFields<ExtractCSVHeader<S, Delimiter, Quotation>, Delimiter, Quotation> : ReadonlyArray<string>;
 export {};

package/dist/web-csv-toolbox.d.ts

@@ -8,6 +8,9 @@ export * from './parse.ts';
 export * from './parseBinary.ts';
 export * from './parseBlob.ts';
 export * from './parseFile.ts';
+export * from './parseFileToArray.ts';
+export * from './parseFileToStream.ts';
+export * from './getOptionsFromFile.ts';
 export * from './parseRequest.ts';
 export * from './parseResponse.ts';
 export * from './parseString.ts';

package/dist/web-csv-toolbox.js

@@ -7,6 +7,9 @@ export { parse } from './parse.js';
 export { parseBinary } from './parseBinary.js';
 export { parseBlob } from './parseBlob.js';
 export { parseFile } from './parseFile.js';
+export { parseFileToArray } from './parseFileToArray.js';
+export { parseFileToStream } from './parseFileToStream.js';
+export { getOptionsFromFile } from './getOptionsFromFile.js';
 export { parseRequest } from './parseRequest.js';
 export { parseResponse } from './parseResponse.js';
 export { parseString } from './parseString.js';

package/dist/web-csv-toolbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-csv-toolbox.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"web-csv-toolbox.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-csv-toolbox",
-  "version": "0.14.0-next-386eebeaafe5857e28c876345c14c9fe5f1a3774",
+  "version": "0.14.0-next-978b88933762ecc27270ce746b80a3fa7ed8c4f7",
   "description": "A CSV Toolbox utilizing Web Standard APIs.",
   "type": "module",
   "module": "dist/web-csv-toolbox.js",
@@ -56,6 +56,12 @@
       "browser": "./dist/getOptionsFromResponse.constants.web.js",
       "default": "./dist/getOptionsFromResponse.constants.web.js"
     },
+    "#getCharsetValidation.constants.js": {
+      "types": "./dist/getCharsetValidation.constants.d.ts",
+      "node": "./dist/getCharsetValidation.constants.node.js",
+      "browser": "./dist/getCharsetValidation.constants.web.js",
+      "default": "./dist/getCharsetValidation.constants.web.js"
+    },
     "#execution/worker/parseStringInWorker.js": {
       "types": "./dist/execution/worker/parseStringInWorker.d.ts",
       "node": "./dist/execution/worker/parseStringInWorker.node.js",