foreslash 0.3.8 → 0.3.9

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Change Log
 
+## Version 0.3.9 - 2026-01-31
+
+Added functions to generate CSV strings
+
+- Feat 🥥 Function(s) added: `arrayToCSV` `objectListToCSV` `csvToArray` `csvToObjectList`
+- Feat 🥥 Function(s) change: Refactor `getGlobalThis` to avoid `ReferenceError` in some case
+- Other fixes and improvements
+
+添加了生成 CSV 字符串的函数
+
+- 功能 🥥 添加函数: `arrayToCSV` `objectListToCSV` `csvToArray` `csvToObjectList`
+- 功能 🥥 变更函数: 重写 `getGlobalThis` 避免部分环境下调用出现 `ReferenceError`
+- 其他修复与优化
+
 ## Version 0.3.8 - 2026-01-25
 
 - Feat 🥥 Function(s) added: `constantCase`

package/README.EN.md

@@ -3,6 +3,9 @@
 <div align="center">
   <p align="center">
     <img src="https://img.shields.io/github/languages/top/Moushudyx/foreslash" alt="GitHub top lang" />
+    <a href="https://codecov.io/gh/moushudyx/foreslash">
+      <img src="https://codecov.io/gh/moushudyx/foreslash/graph/badge.svg" alt="codecov" />
+    </a>
     <img src="https://img.shields.io/badge/license-Mulan_PSL_v2-blue" alt="GitHub license" />
     <img src="https://img.shields.io/npm/v/foreslash" alt="NPM Version" />
     <img src="https://img.shields.io/npm/dm/foreslash" alt="NPM Downloads" />

package/README.md

@@ -3,6 +3,9 @@
 <div align="center">
   <p align="center">
     <img src="https://img.shields.io/github/languages/top/Moushudyx/foreslash" alt="GitHub top lang" />
+    <a href="https://codecov.io/gh/moushudyx/foreslash">
+      <img src="https://codecov.io/gh/moushudyx/foreslash/graph/badge.svg" alt="codecov" />
+    </a>
     <a href="https://github.com/moushudyx/foreslash/blob/master/LICENSE">
       <img src="https://img.shields.io/badge/license-Mulan_PSL_v2-blue" alt="GitHub license" />
     </a>

package/lib/index.cmn.cjs

@@ -157,13 +157,40 @@ function getTag(value) {
     return object2String.call(value).slice(8, -1);
 }
 
-function getGlobalThis() {
-    if (typeof self !== 'undefined')
-        return self;
-    if (typeof window !== 'undefined')
-        return window;
-    if (typeof global !== 'undefined')
-        return global;
+const getGlobalThis = (function () {
+    let globalThisCache = null;
+    return function () {
+        if (globalThisCache)
+            return globalThisCache;
+        globalThisCache = _getGlobalThis();
+        return globalThisCache;
+    };
+})();
+function _getGlobalThis() {
+    try {
+        if (typeof self !== 'undefined')
+            return self;
+    }
+    catch (_a) {
+    }
+    try {
+        if (typeof window !== 'undefined')
+            return window;
+    }
+    catch (_b) {
+    }
+    try {
+        if (typeof global !== 'undefined')
+            return global;
+    }
+    catch (_c) {
+    }
+    try {
+        if (typeof globalThis !== 'undefined')
+            return globalThis;
+    }
+    catch (_d) {
+    }
     return Function('return this')();
 }
 
@@ -1519,6 +1546,160 @@ function acceptableFileType(fileType, accept) {
     return false;
 }
 
+function normalizeOptions$2(options) {
+    var _a, _b, _c, _d;
+    if (typeof options === 'string') {
+        return { delimiter: options, bom: false, newline: '\n', quoteAll: false };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        bom: (_b = options === null || options === void 0 ? void 0 : options.bom) !== null && _b !== void 0 ? _b : false,
+        newline: (_c = options === null || options === void 0 ? void 0 : options.newline) !== null && _c !== void 0 ? _c : '\n',
+        quoteAll: (_d = options === null || options === void 0 ? void 0 : options.quoteAll) !== null && _d !== void 0 ? _d : false,
+    };
+}
+function arrayToCSV(data, options) {
+    const { delimiter, bom, newline, quoteAll } = normalizeOptions$2(options);
+    const content = data
+        .map((row) => row
+        .map((item) => {
+        const str = String(item);
+        if (quoteAll) {
+            return `"${str.replace(/"/g, '""')}"`;
+        }
+        if (typeof item === 'string' && (item.includes(delimiter) || item.includes('"') || item.includes('\n'))) {
+            return `"${str.replace(/"/g, '""')}"`;
+        }
+        return str;
+    })
+        .join(delimiter))
+        .join(newline);
+    return bom ? `\uFEFF${content}` : content;
+}
+
+function normalizeOptions$1(options) {
+    var _a, _b;
+    if (typeof options === 'string') {
+        return { delimiter: options, skipEmptyLines: true };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+    };
+}
+function csvToArray(csv, options) {
+    if (!csv)
+        return [];
+    const { delimiter, skipEmptyLines } = normalizeOptions$1(options);
+    const text = csv.charCodeAt(0) === 0xfeff ? csv.slice(1) : csv;
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (inQuotes) {
+            if (char === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                field += char;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+            continue;
+        }
+        if (char === delimiter) {
+            row.push(field);
+            field = '';
+            continue;
+        }
+        if (char === '\r') {
+            if (text[i + 1] === '\n')
+                i++;
+            row.push(field);
+            field = '';
+            if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                rows.push(row);
+            }
+            row = [];
+            continue;
+        }
+        if (char === '\n') {
+            row.push(field);
+            field = '';
+            if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                rows.push(row);
+            }
+            row = [];
+            continue;
+        }
+        field += char;
+    }
+    row.push(field);
+    if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+        rows.push(row);
+    }
+    return rows;
+}
+
+function normalizeOptions(options) {
+    var _a, _b, _c, _d, _e, _f;
+    if (typeof options === 'string') {
+        return {
+            delimiter: options,
+            skipEmptyLines: true,
+            includeUnknown: false,
+            emptyValue: '',
+            emptyNumberValue: NaN,
+            numberFields: [],
+        };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+        includeUnknown: (_c = options === null || options === void 0 ? void 0 : options.includeUnknown) !== null && _c !== void 0 ? _c : false,
+        emptyValue: (_d = options === null || options === void 0 ? void 0 : options.emptyValue) !== null && _d !== void 0 ? _d : '',
+        emptyNumberValue: (_e = options === null || options === void 0 ? void 0 : options.emptyNumberValue) !== null && _e !== void 0 ? _e : NaN,
+        numberFields: (_f = options === null || options === void 0 ? void 0 : options.numberFields) !== null && _f !== void 0 ? _f : [],
+    };
+}
+function csvToObjectList(csv, fields, options) {
+    const normalized = normalizeOptions(options);
+    const rows = csvToArray(csv, normalized);
+    if (!rows.length)
+        return [];
+    const [headers, ...data] = rows;
+    const fieldMap = new Map(fields.map(([key, value]) => [value, key]));
+    const numberFields = new Set(normalized.numberFields);
+    const { includeUnknown, emptyValue, emptyNumberValue } = normalized;
+    const fieldKeys = headers.map(header => { var _a; return (_a = fieldMap.get(header)) !== null && _a !== void 0 ? _a : (includeUnknown ? header : undefined); });
+    return data.map((row) => {
+        const record = {};
+        for (let i = 0; i < headers.length; i++) {
+            const fieldKey = fieldKeys[i];
+            if (!fieldKey)
+                continue;
+            const isNumberField = numberFields.has(fieldKey);
+            const raw = row[i];
+            let value = isNil(raw) || raw === '' ? (isNumberField ? emptyNumberValue : emptyValue) : raw;
+            if (isNumberField && typeof value === 'string' && value.trim() !== '') {
+                value = Number(value);
+            }
+            record[fieldKey] = value;
+        }
+        return record;
+    });
+}
+
 function getAcceptableExtByMIME(mime) {
     if (!mime || !isString(mime))
         return [];
@@ -1533,6 +1714,20 @@ function getAcceptableMIMEByExt(ext) {
     return _getAcceptableMIMEByExt(e);
 }
 
+function objectListToCSV(objList, fields, options) {
+    var _a;
+    const data = [];
+    data.push(fields.map((f) => f[1]));
+    for (const obj of objList) {
+        const row = [];
+        for (const field of fields) {
+            row.push((_a = obj[field[0]]) !== null && _a !== void 0 ? _a : '');
+        }
+        data.push(row);
+    }
+    return arrayToCSV(data, options);
+}
+
 function randomInt(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
@@ -2764,6 +2959,7 @@ exports.$$Empty = $$Empty;
 exports._ = _;
 exports.acceptableFileName = acceptableFileName;
 exports.acceptableFileType = acceptableFileType;
+exports.arrayToCSV = arrayToCSV;
 exports.base64ToBlob = base64ToBlob;
 exports.blobToBase64 = blobToBase64;
 exports.camelCase = camelCase;
@@ -2780,6 +2976,8 @@ exports.chunk = chunk;
 exports.clamp = clamp;
 exports.compose = compose;
 exports.constantCase = constantCase;
+exports.csvToArray = csvToArray;
+exports.csvToObjectList = csvToObjectList;
 exports.curry = _curryMore;
 exports.dataUrlToBlob = dataUrlToBlob;
 exports.debounce = debounce;
@@ -2857,6 +3055,7 @@ exports.lerp = lerp;
 exports.memo = memo;
 exports.noop = noop;
 exports.not = not;
+exports.objectListToCSV = objectListToCSV;
 exports.omit = omit;
 exports.parallel = parallel;
 exports.pascalCase = pascalCase;

package/lib/index.d.ts

@@ -1382,6 +1382,97 @@ declare function acceptableFileName(fileName: string, accept: string): boolean;
  */
 declare function acceptableFileType(fileType: string, accept: string): boolean;
 
+/** CSV 字符串选项 */
+interface CSVStringifyOptions {
+    delimiter?: string;
+    bom?: boolean;
+    newline?: '\n' | '\r\n';
+    quoteAll?: boolean;
+}
+/**
+ * 将二维数组转换为 CSV 格式的字符串
+ * @param data 二维数组
+ * @param options 配置项, 可设置分隔符、BOM、换行符、引号策略\
+ * 直接传入字符串时表示分隔符\
+ * `delimiter` 分隔符, 默认为 `,`\
+ * `bom` 是否在开头添加 BOM, 默认为 `false`\
+ * `newline` 换行符, 可选值为 `\n` 或 `\r\n`, 默认为 `\n`\
+ * `quoteAll` 是否对所有字段加引号, 默认为 `false`, 仅在必要时加引号
+ * @returns CSV 格式的字符串
+ * @example
+ * ```js
+ * arrayToCSV([['姓名', '年龄'], ['张三', 16], ['李四', 25]])
+ * // 返回:
+ * // 姓名,年龄
+ * // 张三,16
+ * // 李四,25
+ * ```
+ * @version 0.3.9
+ */
+declare function arrayToCSV(data: any[][], options?: string | CSVStringifyOptions): string;
+
+/**
+ * CSV 解析选项
+ */
+interface CSVParseOptions {
+    delimiter?: string;
+    skipEmptyLines?: boolean;
+}
+/**
+ * 将 CSV 字符串解析为二维数组
+ * @param csv CSV 字符串
+ * @param options 配置项, 可设置分隔符与是否跳过空行
+ * @returns 二维数组
+ * @example
+ * ```js
+ * csvToArray('姓名,年龄\n张三,16\n李四,25')
+ * // 返回:
+ * // [['姓名', '年龄'], ['张三', '16'], ['李四', '25']]
+ * ```
+ * @version 0.3.9
+ */
+declare function csvToArray(csv: string, options?: string | CSVParseOptions): string[][];
+
+/**
+ * CSV 对象解析选项
+ */
+interface CSVObjectParseOptions extends CSVParseOptions {
+    includeUnknown?: boolean;
+    emptyValue?: unknown;
+    emptyNumberValue?: number;
+    numberFields?: string[];
+}
+/**
+ * 将 CSV 字符串解析为对象列表
+ * @param csv CSV 字符串
+ * @param fields 字段映射数组, 每一项为 `[对象字段名, CSV 列名]`
+ * @param options 配置项, 可设置分隔符、空行处理、空值默认值、数字字段等
+ * @returns 对象列表
+ * @example
+ * ```js
+ * const csv = '姓名,年龄\n张三,16\n李四,25'
+ * const fields = [['name', '姓名'], ['age', '年龄']]
+ * csvToObjectList(csv, fields)
+ * // 返回:
+ * // [{ name: '张三', age: '16' }, { name: '李四', age: '25' }]
+ * ```
+ * @version 0.3.9
+ */
+declare function csvToObjectList(csv: string, fields: [string, string][], options?: string | (CSVObjectParseOptions & {
+    emptyValue?: string;
+    numberFields?: undefined;
+})): Record<string, string>[];
+declare function csvToObjectList(csv: string, fields: [string, string][], options?: string | (CSVObjectParseOptions & {
+    numberFields?: undefined;
+})): Record<string, string | unknown>[];
+declare function csvToObjectList(csv: string, fields: [string, string][], options: string | (CSVObjectParseOptions & {
+    emptyValue?: string;
+    numberFields: string[];
+})): Record<string, string | number>[];
+declare function csvToObjectList(csv: string, fields: [string, string][], options: string | (CSVObjectParseOptions & {
+    numberFields: string[];
+})): Record<string, string | number | unknown>[];
+
 /**
  * 根据 MIME 类型获取所有匹配的文件拓展名，需要注意 `.C` 与 `.c` 的区别
  * - `text/x-c++src` 对应 `.C`
@@ -1418,6 +1509,33 @@ declare function getAcceptableExtByMIME(mime: string): string[];
  */
 declare function getAcceptableMIMEByExt(ext: string): string[];
 
+/**
+ * 根据对象列表生成 CSV 字符串
+ * @param objList 对象列表
+ * @param fields 字段映射数组, 每一项为 `[对象字段名, CSV 列名]`
+ * @param options 配置项, 可设置分隔符、BOM、换行符、引号策略
+ * @returns CSV 格式的字符串
+ * @example
+ * ```js
+ * const objList = [
+ *  { name: '张三', age: 16, city: '上海' },
+ *  { name: '李四', age: 25, city: '新加坡' }
+ * ]
+ * const fields = [
+ * ['name', '姓名'],
+ * ['age', '年龄'],
+ * ['city', '城市']
+ * ]
+ * objectListToCSV(objList, fields)
+ * // 返回:
+ * // 姓名,年龄,城市
+ * // 张三,16,上海
+ * // 李四,25,新加坡
+ * ```
+ * @version 0.3.9
+ */
+declare function objectListToCSV(objList: Record<string, any>[], fields: [string, string][], options?: string | CSVStringifyOptions): string;
+
 /**
  * 从给定的数组中返回随机一个元素
  * @param arr 可以是数组或类数组对象
@@ -1973,7 +2091,7 @@ declare function getTag(value: unknown): string;
  * 获取全局对象，浏览器环境返回 `self` 或 `window`, Node.js 环境返回 `global`
  * @returns 全局对象
  */
-declare function getGlobalThis(): typeof globalThis;
+declare const getGlobalThis: () => typeof globalThis;
 
 // compose
 type ComposeFuncList1<CompArgs extends any[], CompResult> = [(...args: CompArgs) => CompResult]
@@ -2657,5 +2775,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, constantCase, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
-export type { BaseMargeType, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };
+export { $$Empty, _, acceptableFileName, acceptableFileType, arrayToCSV, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, constantCase, csvToArray, csvToObjectList, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, objectListToCSV, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
+export type { BaseMargeType, CSVObjectParseOptions, CSVParseOptions, CSVStringifyOptions, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };

package/lib/index.mjs

@@ -155,13 +155,40 @@ function getTag(value) {
     return object2String.call(value).slice(8, -1);
 }
 
-function getGlobalThis() {
-    if (typeof self !== 'undefined')
-        return self;
-    if (typeof window !== 'undefined')
-        return window;
-    if (typeof global !== 'undefined')
-        return global;
+const getGlobalThis = (function () {
+    let globalThisCache = null;
+    return function () {
+        if (globalThisCache)
+            return globalThisCache;
+        globalThisCache = _getGlobalThis();
+        return globalThisCache;
+    };
+})();
+function _getGlobalThis() {
+    try {
+        if (typeof self !== 'undefined')
+            return self;
+    }
+    catch (_a) {
+    }
+    try {
+        if (typeof window !== 'undefined')
+            return window;
+    }
+    catch (_b) {
+    }
+    try {
+        if (typeof global !== 'undefined')
+            return global;
+    }
+    catch (_c) {
+    }
+    try {
+        if (typeof globalThis !== 'undefined')
+            return globalThis;
+    }
+    catch (_d) {
+    }
     return Function('return this')();
 }
 
@@ -1517,6 +1544,160 @@ function acceptableFileType(fileType, accept) {
     return false;
 }
 
+function normalizeOptions$2(options) {
+    var _a, _b, _c, _d;
+    if (typeof options === 'string') {
+        return { delimiter: options, bom: false, newline: '\n', quoteAll: false };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        bom: (_b = options === null || options === void 0 ? void 0 : options.bom) !== null && _b !== void 0 ? _b : false,
+        newline: (_c = options === null || options === void 0 ? void 0 : options.newline) !== null && _c !== void 0 ? _c : '\n',
+        quoteAll: (_d = options === null || options === void 0 ? void 0 : options.quoteAll) !== null && _d !== void 0 ? _d : false,
+    };
+}
+function arrayToCSV(data, options) {
+    const { delimiter, bom, newline, quoteAll } = normalizeOptions$2(options);
+    const content = data
+        .map((row) => row
+        .map((item) => {
+        const str = String(item);
+        if (quoteAll) {
+            return `"${str.replace(/"/g, '""')}"`;
+        }
+        if (typeof item === 'string' && (item.includes(delimiter) || item.includes('"') || item.includes('\n'))) {
+            return `"${str.replace(/"/g, '""')}"`;
+        }
+        return str;
+    })
+        .join(delimiter))
+        .join(newline);
+    return bom ? `\uFEFF${content}` : content;
+}
+
+function normalizeOptions$1(options) {
+    var _a, _b;
+    if (typeof options === 'string') {
+        return { delimiter: options, skipEmptyLines: true };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+    };
+}
+function csvToArray(csv, options) {
+    if (!csv)
+        return [];
+    const { delimiter, skipEmptyLines } = normalizeOptions$1(options);
+    const text = csv.charCodeAt(0) === 0xfeff ? csv.slice(1) : csv;
+    const rows = [];
+    let row = [];
+    let field = '';
+    let inQuotes = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (inQuotes) {
+            if (char === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                field += char;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inQuotes = true;
+            continue;
+        }
+        if (char === delimiter) {
+            row.push(field);
+            field = '';
+            continue;
+        }
+        if (char === '\r') {
+            if (text[i + 1] === '\n')
+                i++;
+            row.push(field);
+            field = '';
+            if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                rows.push(row);
+            }
+            row = [];
+            continue;
+        }
+        if (char === '\n') {
+            row.push(field);
+            field = '';
+            if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                rows.push(row);
+            }
+            row = [];
+            continue;
+        }
+        field += char;
+    }
+    row.push(field);
+    if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+        rows.push(row);
+    }
+    return rows;
+}
+
+function normalizeOptions(options) {
+    var _a, _b, _c, _d, _e, _f;
+    if (typeof options === 'string') {
+        return {
+            delimiter: options,
+            skipEmptyLines: true,
+            includeUnknown: false,
+            emptyValue: '',
+            emptyNumberValue: NaN,
+            numberFields: [],
+        };
+    }
+    return {
+        delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+        skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+        includeUnknown: (_c = options === null || options === void 0 ? void 0 : options.includeUnknown) !== null && _c !== void 0 ? _c : false,
+        emptyValue: (_d = options === null || options === void 0 ? void 0 : options.emptyValue) !== null && _d !== void 0 ? _d : '',
+        emptyNumberValue: (_e = options === null || options === void 0 ? void 0 : options.emptyNumberValue) !== null && _e !== void 0 ? _e : NaN,
+        numberFields: (_f = options === null || options === void 0 ? void 0 : options.numberFields) !== null && _f !== void 0 ? _f : [],
+    };
+}
+function csvToObjectList(csv, fields, options) {
+    const normalized = normalizeOptions(options);
+    const rows = csvToArray(csv, normalized);
+    if (!rows.length)
+        return [];
+    const [headers, ...data] = rows;
+    const fieldMap = new Map(fields.map(([key, value]) => [value, key]));
+    const numberFields = new Set(normalized.numberFields);
+    const { includeUnknown, emptyValue, emptyNumberValue } = normalized;
+    const fieldKeys = headers.map(header => { var _a; return (_a = fieldMap.get(header)) !== null && _a !== void 0 ? _a : (includeUnknown ? header : undefined); });
+    return data.map((row) => {
+        const record = {};
+        for (let i = 0; i < headers.length; i++) {
+            const fieldKey = fieldKeys[i];
+            if (!fieldKey)
+                continue;
+            const isNumberField = numberFields.has(fieldKey);
+            const raw = row[i];
+            let value = isNil(raw) || raw === '' ? (isNumberField ? emptyNumberValue : emptyValue) : raw;
+            if (isNumberField && typeof value === 'string' && value.trim() !== '') {
+                value = Number(value);
+            }
+            record[fieldKey] = value;
+        }
+        return record;
+    });
+}
+
 function getAcceptableExtByMIME(mime) {
     if (!mime || !isString(mime))
         return [];
@@ -1531,6 +1712,20 @@ function getAcceptableMIMEByExt(ext) {
     return _getAcceptableMIMEByExt(e);
 }
 
+function objectListToCSV(objList, fields, options) {
+    var _a;
+    const data = [];
+    data.push(fields.map((f) => f[1]));
+    for (const obj of objList) {
+        const row = [];
+        for (const field of fields) {
+            row.push((_a = obj[field[0]]) !== null && _a !== void 0 ? _a : '');
+        }
+        data.push(row);
+    }
+    return arrayToCSV(data, options);
+}
+
 function randomInt(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
@@ -2758,4 +2953,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, constantCase, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, arrayToCSV, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, constantCase, csvToArray, csvToObjectList, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, objectListToCSV, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };

package/lib/index.umd.js

@@ -161,13 +161,40 @@ See the Mulan PSL v2 for more details.
       return object2String.call(value).slice(8, -1);
   }
 
-  function getGlobalThis() {
-      if (typeof self !== 'undefined')
-          return self;
-      if (typeof window !== 'undefined')
-          return window;
-      if (typeof global !== 'undefined')
-          return global;
+  const getGlobalThis = (function () {
+      let globalThisCache = null;
+      return function () {
+          if (globalThisCache)
+              return globalThisCache;
+          globalThisCache = _getGlobalThis();
+          return globalThisCache;
+      };
+  })();
+  function _getGlobalThis() {
+      try {
+          if (typeof self !== 'undefined')
+              return self;
+      }
+      catch (_a) {
+      }
+      try {
+          if (typeof window !== 'undefined')
+              return window;
+      }
+      catch (_b) {
+      }
+      try {
+          if (typeof global !== 'undefined')
+              return global;
+      }
+      catch (_c) {
+      }
+      try {
+          if (typeof globalThis !== 'undefined')
+              return globalThis;
+      }
+      catch (_d) {
+      }
       return Function('return this')();
   }
 
@@ -1523,6 +1550,160 @@ See the Mulan PSL v2 for more details.
       return false;
   }
 
+  function normalizeOptions$2(options) {
+      var _a, _b, _c, _d;
+      if (typeof options === 'string') {
+          return { delimiter: options, bom: false, newline: '\n', quoteAll: false };
+      }
+      return {
+          delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+          bom: (_b = options === null || options === void 0 ? void 0 : options.bom) !== null && _b !== void 0 ? _b : false,
+          newline: (_c = options === null || options === void 0 ? void 0 : options.newline) !== null && _c !== void 0 ? _c : '\n',
+          quoteAll: (_d = options === null || options === void 0 ? void 0 : options.quoteAll) !== null && _d !== void 0 ? _d : false,
+      };
+  }
+  function arrayToCSV(data, options) {
+      const { delimiter, bom, newline, quoteAll } = normalizeOptions$2(options);
+      const content = data
+          .map((row) => row
+          .map((item) => {
+          const str = String(item);
+          if (quoteAll) {
+              return `"${str.replace(/"/g, '""')}"`;
+          }
+          if (typeof item === 'string' && (item.includes(delimiter) || item.includes('"') || item.includes('\n'))) {
+              return `"${str.replace(/"/g, '""')}"`;
+          }
+          return str;
+      })
+          .join(delimiter))
+          .join(newline);
+      return bom ? `\uFEFF${content}` : content;
+  }
+
+  function normalizeOptions$1(options) {
+      var _a, _b;
+      if (typeof options === 'string') {
+          return { delimiter: options, skipEmptyLines: true };
+      }
+      return {
+          delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+          skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+      };
+  }
+  function csvToArray(csv, options) {
+      if (!csv)
+          return [];
+      const { delimiter, skipEmptyLines } = normalizeOptions$1(options);
+      const text = csv.charCodeAt(0) === 0xfeff ? csv.slice(1) : csv;
+      const rows = [];
+      let row = [];
+      let field = '';
+      let inQuotes = false;
+      for (let i = 0; i < text.length; i++) {
+          const char = text[i];
+          if (inQuotes) {
+              if (char === '"') {
+                  if (text[i + 1] === '"') {
+                      field += '"';
+                      i++;
+                  }
+                  else {
+                      inQuotes = false;
+                  }
+              }
+              else {
+                  field += char;
+              }
+              continue;
+          }
+          if (char === '"') {
+              inQuotes = true;
+              continue;
+          }
+          if (char === delimiter) {
+              row.push(field);
+              field = '';
+              continue;
+          }
+          if (char === '\r') {
+              if (text[i + 1] === '\n')
+                  i++;
+              row.push(field);
+              field = '';
+              if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                  rows.push(row);
+              }
+              row = [];
+              continue;
+          }
+          if (char === '\n') {
+              row.push(field);
+              field = '';
+              if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+                  rows.push(row);
+              }
+              row = [];
+              continue;
+          }
+          field += char;
+      }
+      row.push(field);
+      if (!(skipEmptyLines && row.length === 1 && row[0] === '')) {
+          rows.push(row);
+      }
+      return rows;
+  }
+
+  function normalizeOptions(options) {
+      var _a, _b, _c, _d, _e, _f;
+      if (typeof options === 'string') {
+          return {
+              delimiter: options,
+              skipEmptyLines: true,
+              includeUnknown: false,
+              emptyValue: '',
+              emptyNumberValue: NaN,
+              numberFields: [],
+          };
+      }
+      return {
+          delimiter: (_a = options === null || options === void 0 ? void 0 : options.delimiter) !== null && _a !== void 0 ? _a : ',',
+          skipEmptyLines: (_b = options === null || options === void 0 ? void 0 : options.skipEmptyLines) !== null && _b !== void 0 ? _b : true,
+          includeUnknown: (_c = options === null || options === void 0 ? void 0 : options.includeUnknown) !== null && _c !== void 0 ? _c : false,
+          emptyValue: (_d = options === null || options === void 0 ? void 0 : options.emptyValue) !== null && _d !== void 0 ? _d : '',
+          emptyNumberValue: (_e = options === null || options === void 0 ? void 0 : options.emptyNumberValue) !== null && _e !== void 0 ? _e : NaN,
+          numberFields: (_f = options === null || options === void 0 ? void 0 : options.numberFields) !== null && _f !== void 0 ? _f : [],
+      };
+  }
+  function csvToObjectList(csv, fields, options) {
+      const normalized = normalizeOptions(options);
+      const rows = csvToArray(csv, normalized);
+      if (!rows.length)
+          return [];
+      const [headers, ...data] = rows;
+      const fieldMap = new Map(fields.map(([key, value]) => [value, key]));
+      const numberFields = new Set(normalized.numberFields);
+      const { includeUnknown, emptyValue, emptyNumberValue } = normalized;
+      const fieldKeys = headers.map(header => { var _a; return (_a = fieldMap.get(header)) !== null && _a !== void 0 ? _a : (includeUnknown ? header : undefined); });
+      return data.map((row) => {
+          const record = {};
+          for (let i = 0; i < headers.length; i++) {
+              const fieldKey = fieldKeys[i];
+              if (!fieldKey)
+                  continue;
+              const isNumberField = numberFields.has(fieldKey);
+              const raw = row[i];
+              let value = isNil(raw) || raw === '' ? (isNumberField ? emptyNumberValue : emptyValue) : raw;
+              if (isNumberField && typeof value === 'string' && value.trim() !== '') {
+                  value = Number(value);
+              }
+              record[fieldKey] = value;
+          }
+          return record;
+      });
+  }
+
   function getAcceptableExtByMIME(mime) {
       if (!mime || !isString(mime))
           return [];
@@ -1537,6 +1718,20 @@ See the Mulan PSL v2 for more details.
       return _getAcceptableMIMEByExt(e);
   }
 
+  function objectListToCSV(objList, fields, options) {
+      var _a;
+      const data = [];
+      data.push(fields.map((f) => f[1]));
+      for (const obj of objList) {
+          const row = [];
+          for (const field of fields) {
+              row.push((_a = obj[field[0]]) !== null && _a !== void 0 ? _a : '');
+          }
+          data.push(row);
+      }
+      return arrayToCSV(data, options);
+  }
+
   function randomInt(min, max) {
       return Math.floor(Math.random() * (max - min + 1)) + min;
   }
@@ -2768,6 +2963,7 @@ See the Mulan PSL v2 for more details.
   exports._ = _;
   exports.acceptableFileName = acceptableFileName;
   exports.acceptableFileType = acceptableFileType;
+  exports.arrayToCSV = arrayToCSV;
   exports.base64ToBlob = base64ToBlob;
   exports.blobToBase64 = blobToBase64;
   exports.camelCase = camelCase;
@@ -2784,6 +2980,8 @@ See the Mulan PSL v2 for more details.
   exports.clamp = clamp;
   exports.compose = compose;
   exports.constantCase = constantCase;
+  exports.csvToArray = csvToArray;
+  exports.csvToObjectList = csvToObjectList;
   exports.curry = _curryMore;
   exports.dataUrlToBlob = dataUrlToBlob;
   exports.debounce = debounce;
@@ -2861,6 +3059,7 @@ See the Mulan PSL v2 for more details.
   exports.memo = memo;
   exports.noop = noop;
   exports.not = not;
+  exports.objectListToCSV = objectListToCSV;
   exports.omit = omit;
   exports.parallel = parallel;
   exports.pascalCase = pascalCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",