foreslash 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Change Log
 
+## Version 0.3.2 - 2025-09-23
+
+Unstable version
+
+- Feat 🥥 Functions added: `chunk` `decimalNotation` `round` `format` `isPlainObject` `cartesianProduct` **and** so forth
+- Feat 🥥 Type Utils: `Not` `IsNegative` `IsZero` `IsPositive` `Stringify`
+- Fix 🥕 Document: Added version tags to 19 methods
+- Other fixes and improvements
+
+不稳定版本
+
+- 功能 🥥 添加函数: `chunk` `decimalNotation` `round` `format` `isPlainObject` `cartesianProduct` 等
+- 功能 🥥 类型工具: `Not` `IsNegative` `IsZero` `IsPositive` `Stringify`
+- 修复 🥕 文档: 补充 19 个方法的版本标签
+- 其他修复与优化
+
 ## Version 0.3.1 - 2025-08-14
 
 Unstable version

package/lib/index.cmn.cjs

@@ -11,6 +11,53 @@ See the Mulan PSL v2 for more details.
 */
 'use strict';
 
+function cartesianProduct(...arrList) {
+    const arrLen = arrList.length;
+    const pList = Array(arrLen).fill(0);
+    const lastIndex = arrLen - 1;
+    const res = [];
+    for (let i = 0; i < arrLen; i++) {
+        if (!arrList[i].length)
+            return [];
+    }
+    while (1) {
+        const temp = [];
+        for (let i = 0; i < arrLen; i++) {
+            temp.push(arrList[i][pList[i]]);
+        }
+        res.push(temp);
+        pList[lastIndex] += 1;
+        for (let i = lastIndex; i >= 0; i--) {
+            if (pList[i] >= arrList[i].length) {
+                if (i > 0) {
+                    pList[i] = 0;
+                    pList[i - 1] += 1;
+                }
+                else
+                    break;
+            }
+            else
+                break;
+        }
+        if (pList[0] >= arrList[0].length)
+            break;
+    }
+    return res;
+}
+
+function chunk(array, size = 2) {
+    const res = [];
+    if (size < 1 || isNaN(size))
+        return res;
+    let start = 0, end = size;
+    while (start < array.length) {
+        res.push(Array.prototype.slice.call(array, start, end));
+        start = end;
+        end += size;
+    }
+    return res;
+}
+
 function range(start, end, stepOrOptions) {
     if (!isFinite(start))
         throw new Error('start must be finite');
@@ -202,6 +249,22 @@ function isNumber(value) {
     return typeof value === 'number';
 }
 
+const fnToString = Function.prototype.toString;
+const objProtoContString = fnToString.call(Object.prototype.constructor);
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === null)
+        return true;
+    if (!Object.prototype.hasOwnProperty.call(prototype, "constructor"))
+        return false;
+    const constructorFn = prototype.constructor;
+    if (!isFunction(constructorFn) || fnToString.call(constructorFn) !== objProtoContString)
+        return false;
+    return (Object.getPrototypeOf(prototype) === null);
+}
+
 function isPrimitive(value) {
     return value === undefined || value === null || (typeof value !== 'object' && typeof value !== 'function');
 }
@@ -374,6 +437,178 @@ function clamp(num, min, max, options) {
     return num < min ? defaultMin : num > max ? defaultMax : num;
 }
 
+function decimalNotation(num) {
+    const n = isNumber(num) ? num : Number(num);
+    if (!isFinite(n))
+        return String(n);
+    let str = String(n);
+    if (!/e/i.test(str))
+        return str;
+    const match = str.match(/^(-?)(\d+)\.?(\d*)e([+-]?)(\d+)$/);
+    const [_, sign, mantissaI, mantissaF, expSign, _exponent] = match;
+    const exponent = Number(_exponent);
+    let mantissa = mantissaI + mantissaF;
+    let dotPos = mantissaI.length;
+    if (expSign === '-') {
+        const zeroCount = exponent - dotPos + 1;
+        if (zeroCount > 0)
+            mantissa = '0'.repeat(zeroCount) + mantissa;
+        return sign + mantissa[0] + '.' + mantissa.substring(1);
+    }
+    else {
+        const zeroCount = exponent + dotPos - mantissa.length;
+        if (zeroCount > 0)
+            mantissa = mantissa + '0'.repeat(zeroCount);
+        return sign + mantissa.substring(0, exponent + dotPos);
+    }
+}
+
+function isOdd(num) {
+    return !!(num & 1);
+}
+function isEven(num) {
+    return !(num & 1);
+}
+
+function round(num, precision, type) {
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    let [_integer, _fractional] = str.split('.');
+    let sign = '';
+    if (/^-/.test(_integer)) {
+        _integer = _integer.substring(1);
+        sign = '-';
+    }
+    _fractional = _fractional !== null && _fractional !== void 0 ? _fractional : '';
+    const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+    const [integer, fractional] = (roundMap[type || 'round'] || roundBase)(_integer, _fractional, precision, !!sign);
+    if (precision > 0)
+        return sign + integer + '.' + fractional;
+    else
+        return sign + integer;
+}
+function roundBase(integer, fractional, precision) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (Number(fractional[precision]) > 4)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundBank(integer, fractional, precision) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        const rightNumber = Number(fractional[precision]);
+        if (rightNumber < 5)
+            return [integer, splitF];
+        if (rightNumber > 5)
+            return increase(integer, splitF);
+        const rightNumbers = fractional.substring(precision);
+        if (!/^50*$/.test(rightNumbers))
+            return increase(integer, splitF);
+        const leftNumber = Number(precision ? fractional[precision - 1] : integer[integer.length - 1]);
+        if (isEven(leftNumber))
+            return [integer, splitF];
+        else
+            return increase(integer, splitF);
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundFloor(integer, fractional, precision, isNegative) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (isNegative)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundCeil(integer, fractional, precision, isNegative) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (!isNegative)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function increase(integer, fractional) {
+    if (fractional) {
+        const _fractional = _increase(fractional);
+        if (_fractional.length > fractional.length) {
+            return [_increase(integer), _fractional.substring(1)];
+        }
+        return [integer, _fractional];
+    }
+    return [_increase(integer), ''];
+}
+function _increase(num) {
+    const numList = num.split('').map(Number).reverse();
+    numList[0] += 1;
+    numList.push(0);
+    for (let i = 0; i < numList.length; i++) {
+        if (numList[i] > 9) {
+            numList[i] -= 10;
+            numList[i + 1] += 1;
+        }
+        else
+            break;
+    }
+    if (numList[numList.length - 1] === 0)
+        numList.pop();
+    return numList.reverse().map(String).join('');
+}
+
+function format(num, options) {
+    var _a;
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    const separator = (options || {}).separator || ',';
+    const separate = clamp((options || {}).separate || 3, 1, Infinity);
+    const decimal = (options || {}).decimal || '.';
+    const precision = clamp((_a = (options || {}).precision) !== null && _a !== void 0 ? _a : 2, 0, Infinity);
+    const round = (options || {}).round || 'round';
+    let [integer, fractional] = str.split('.');
+    let sign = '';
+    if (/^-/.test(integer)) {
+        integer = integer.substring(1);
+        sign = '-';
+    }
+    fractional = fractional !== null && fractional !== void 0 ? fractional : '';
+    if (fractional.length > precision) {
+        const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+        [integer, fractional] = (roundMap[round] || roundBase)(integer, fractional, precision, !!sign);
+    }
+    else if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    if (integer.length > separate) {
+        integer = chunk(Array.from(integer).reverse(), separate)
+            .map((part) => part.join(''))
+            .join(separator);
+        integer = Array.from(integer).reverse().join('');
+    }
+    if (precision > 0)
+        return sign + integer + decimal + fractional;
+    else
+        return sign + integer;
+}
+
 function parallel(args, fn, options) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!args.length)
@@ -2048,20 +2283,24 @@ exports.acceptableFileName = acceptableFileName;
 exports.acceptableFileType = acceptableFileType;
 exports.camelCase = camelCase;
 exports.capitalize = capitalize;
+exports.cartesianProduct = cartesianProduct;
 exports.caseCamel = caseCamel;
 exports.caseConvert = caseConvert;
 exports.caseKebab = caseKebab;
 exports.casePascal = casePascal;
 exports.caseSnake = caseSnake;
+exports.chunk = chunk;
 exports.clamp = clamp;
 exports.compose = compose;
 exports.curry = _curryMore;
 exports.debounce = debounce;
+exports.decimalNotation = decimalNotation;
 exports.dedent = dedent;
 exports.deepClone = deepClone;
 exports.deepMerge = deepMerge;
 exports.defer = defer;
 exports.fastClone = fastClone;
+exports.format = format;
 exports.getAcceptableExtByMIME = getAcceptableExtByMIME;
 exports.getAcceptableMIMEByExt = getAcceptableMIMEByExt;
 exports.getGlobalThis = getGlobalThis;
@@ -2079,6 +2318,7 @@ exports.isBuffer = isBuffer;
 exports.isDataView = isDataView;
 exports.isDate = isDate;
 exports.isEmpty = isEmpty;
+exports.isEven = isEven;
 exports.isFile = isFile;
 exports.isFloat32Array = isFloat32Array;
 exports.isFloat64Array = isFloat64Array;
@@ -2095,7 +2335,9 @@ exports.isNil = isNil;
 exports.isNull = isNull;
 exports.isNumber = isNumber;
 exports.isObject = isObject;
+exports.isOdd = isOdd;
 exports.isPlaceholder = isPlaceholder;
+exports.isPlainObject = isPlainObject;
 exports.isPrimitive = isPrimitive;
 exports.isPromise = isPromise;
 exports.isPromiseLike = isPromiseLike;
@@ -2135,6 +2377,11 @@ exports.randomString = randomString;
 exports.range = range;
 exports.remove = remove;
 exports.retry = retry;
+exports.round = round;
+exports.roundBank = roundBank;
+exports.roundBase = roundBase;
+exports.roundCeil = roundCeil;
+exports.roundFloor = roundFloor;
 exports.shuffle = shuffle;
 exports.sleep = sleep;
 exports.snakeCase = snakeCase;

package/lib/index.d.ts

@@ -1,5 +1,61 @@
 import { A, F } from 'ts-toolbelt';
 
+/**
+ * 将多个数组或类数组对象以笛卡尔积的形式拼接为一个新的二维数组
+ * @returns 笛卡尔积
+ * @example
+ * ```js
+ * cartesianProduct([1, 2, 3, 4, 5]) // [[1], [2], [3], [4], [5]]
+ * cartesianProduct([1, 2], '12') // [[1, '1'], [1, '2'], [2, '1'], [2, '2']]
+ * cartesianProduct([1, 2], '12', [3, 4])
+ * // [[1, '1', 3], [1, '1', 4], [1, '2', 3], [1, '2', 4]
+ * //  [2, '1', 3], [2, '1', 4], [2, '2', 3], [2, '2', 4]]
+ * cartesianProduct([1, 2, 3, 4, 5], '12345', []) // [] 空集与其他集合的笛卡尔积是空集
+ * ```
+ * @version 0.3.2
+ */
+declare function cartesianProduct<T>(arr1: ArrayLike<T>): [T][];
+declare function cartesianProduct<T1, T2>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>): [T1, T2][];
+declare function cartesianProduct<T1, T2, T3>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>): [T1, T2, T3][];
+declare function cartesianProduct<T1, T2, T3, T4>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>, arr4: ArrayLike<T4>): [T1, T2, T3, T4][];
+declare function cartesianProduct<T1, T2, T3, T4, T5>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>, arr4: ArrayLike<T4>, arr5: ArrayLike<T5>): [T1, T2, T3, T4, T5][];
+declare function cartesianProduct<T1, T2, T3, T4, T5, T6>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>, arr4: ArrayLike<T4>, arr5: ArrayLike<T5>, arr6: ArrayLike<T6>): [T1, T2, T3, T4, T5, T6][];
+declare function cartesianProduct<T1, T2, T3, T4, T5, T6, T7>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>, arr4: ArrayLike<T4>, arr5: ArrayLike<T5>, arr6: ArrayLike<T6>, arr7: ArrayLike<T7>): [T1, T2, T3, T4, T5, T6, T7][];
+declare function cartesianProduct<T1, T2, T3, T4, T5, T6, T7, T8>(arr1: ArrayLike<T1>, arr2: ArrayLike<T2>, arr3: ArrayLike<T3>, arr4: ArrayLike<T4>, arr5: ArrayLike<T5>, arr6: ArrayLike<T6>, arr7: ArrayLike<T7>, arr8: ArrayLike<T8>): [T1, T2, T3, T4, T5, T6, T7, T8][];
+declare function cartesianProduct(...arrList: ArrayLike<any>[]): any[][];
+
+type Not<T> = T extends false | 0 | '' | null | undefined ? true : false;
+
+type Stringify<T extends string | number | boolean | bigint | null | undefined> = `${T}`;
+
+/** 检查输入的数字是否为 `0` 或 `0n` */
+type IsZero<T> = T extends 0 | 0n ? true : false;
+/** 检查输入的数字是否为负数 */
+type IsNegative<T> = T extends number | bigint ? (Stringify<T> extends `-${infer R}` ? true : false) : false;
+/** 检查输入的数字是否为正数 */
+type IsPositive<T> = T extends number | bigint ? (IsZero<T> extends true ? false : Not<IsNegative<T>>) : false;
+
+/**
+ * 将一个数组或类数组对象分割成多个指定大小的小块\
+ * 类似 Lodash 的 `chunk` 或是 Radash 的 `cluster`\
+ * 可以填入 `size` 以自定义每个小块的大小
+ * @param array 需要分块的数组
+ * @param size 每块大小, 不能小于 1, 默认为 `2`
+ * @returns 分块后的数组
+ * @example
+ * ```js
+ * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+ * chunk('12345', 3) // [['1', '2', '3'], ['4', '5']]
+ * chunk({0: 1, 1: 2, 2: 3, length: 3}, 2) // [[1, 2], [3]]
+ * // 如果传入了不正常的 size 则返回空数组(类型为 `never[]`)
+ * chunk([1, 2, 3, 4, 5], 0) // []
+ * chunk([1, 2, 3, 4, 5], NaN) // []
+ * ```
+ * @version 0.3.2
+ */
+declare function chunk<T, Size extends number = 2>(array: ArrayLike<T>, size?: Size): Chunked<T, Size>;
+type Chunked<T, Size extends number> = Size extends 1 ? [T][] : Size extends 2 ? [T, T][] : Size extends 3 ? [T, T, T][] : Size extends 4 ? [T, T, T, T][] : Size extends 5 ? [T, T, T, T, T][] : Size extends 6 ? [T, T, T, T, T, T][] : Size extends 7 ? [T, T, T, T, T, T, T][] : Size extends 8 ? [T, T, T, T, T, T, T, T][] : Size extends 9 ? [T, T, T, T, T, T, T, T, T][] : IsNegative<Size> extends true ? never[] : Size extends 0 ? never[] : T[][];
+
 type RangeOptions<T> = {
     step?: number;
     value?: T;
@@ -539,6 +595,21 @@ declare function isNumber(value: unknown): value is number;
  */
 declare function isObject(value: unknown): value is object;
 
+/**
+ * 类型守卫，判断给定的值是否为普通对象(不是 `Date`、数组等特殊对象)
+ * - 注意，与 lodash 的同名方法不同，不会将函数视为对象
+ * @param value 要判断的值
+ * @example
+ * ```js
+ * isObject({}) // true
+ * isObject(Object.create(null)) // true
+ * isObject([]) // false
+ * isObject(Object(123)) // false
+ * isObject(null) // false
+ * ```
+ */
+declare function isPlainObject(value: unknown): value is object;
+
 /**
  * 类型守卫，判断给定的值是否为原始类型(如字符串数字等 JS 内置的类型)
  * - 包括 `undefined` 和 `null`
@@ -876,6 +947,165 @@ declare function clamp(num: number, min: number, max: number, options?: {
     defaultMax?: number;
 }): number;
 
+/**
+ * 将一个数字转换为正常的十进制计数法
+ * @param num 需要转换的数字
+ * @returns 返回一个十进制计数法表示的数字
+ * @example
+ * ```js
+ * decimalNotation(1e12) // 1000000000000
+ * decimalNotation(-2.33e8) // -233000000
+ * decimalNotation(1.234e-6) // 0.000001234
+ * decimalNotation(-4.321e-8) // -0.00000004321
+ * ```
+ * @version 0.3.2
+ */
+declare function decimalNotation(num: string | number): string;
+
+/**
+ * 将一个数字转换为指定的格式(如千分位逗号分隔)
+ * @param num 需要格式化的数字
+ * @param options 格式化配置\
+ * - `separator` 分割符, 默认为 `','`
+ * - `separate` 按位分割, 默认为 `3`
+ * - `decimal` 小数点, 默认为 `'.'`
+ * - `precision` 小数精度, 默认为 `2`
+ * - `round` 数值修约规则
+ *   - `'round'` 四舍五入
+ *   - `'banker'` 四舍六入五成双
+ *   - `'floor'` 向下取整
+ *   - `'ceil'` 向上取整
+ * @returns 返回一个指定格式的十进制数字
+ * @version 0.3.2
+ */
+declare function format(num: number | string, options?: {
+    separator?: string;
+    separate?: number;
+    decimal?: string;
+    precision?: number;
+    round?: 'round' | 'banker' | 'floor' | 'ceil';
+}): string;
+
+/**
+ * 检查一个数字是否为奇数
+ * @param num 需要检查的数字
+ * @returns 如果是奇数则返回 true 否则返回 false
+ * @version 0.3.2
+ */
+declare function isOdd(num: number): boolean;
+/**
+ * 检查一个数字是否为偶数
+ * @param num 需要检查的数字
+ * @returns 如果是偶数则返回 true 否则返回 false
+ * @version 0.3.2
+ */
+declare function isEven(num: number): boolean;
+
+/**
+ * 数值修约, 可以使用 4 种修约方法, 默认使用四舍五入
+ * - 四舍五入: 修约位置的后一位如果是 5 则进位, 否则不进位
+ * - 四舍六入五成双: 修约位置的后一位如果是 5 且前一位是偶数则进位, 否则不进位
+ * - 向下取整
+ * - 向上取整
+ * @param num 需要修约的数字
+ * @param precision 精度, 小数点后几位
+ * @param type 修约方法, 默认使用四舍五入
+ * @example
+ * ```js
+ * // 四舍五入
+ * round(1.95, 1) // '2.0'
+ * round('1.95', 1) // '2.0'
+ * // 四舍六入五成双
+ * round('1.85', 1, 'banker') // '1.8'
+ * round('1.95', 1, 'banker') // '2.0'
+ * // 向下取整
+ * round('1.95', 1, 'floor') // '1.9'
+ * round(-1.95, 1, 'floor') // '-2.0'
+ * // 向上取整
+ * round('1.95', 1, 'ceil') // '2.0'
+ * round(-1.95, 1, 'ceil') // '-1.9'
+ * ```
+ * @version 0.3.2
+ */
+declare function round(num: string | number, precision: number, type?: 'round' | 'banker' | 'floor' | 'ceil'): string;
+/**
+ * 四舍五入, 由于 JS 的 toFixed 有浮点误差所以不能使用
+ * @example
+ * ```js
+ * // 四舍五入
+ * roundBase('1', '34', 1, false) // ['1', '3']
+ * roundBase('1', '35', 1, false) // ['1', '4']
+ * roundBase('1', '36', 1, false) // ['1', '4']
+ * // 与符号无关
+ * roundBase('1', '34', 1, true) // ['1', '3']
+ * roundBase('1', '35', 1, true) // ['1', '4']
+ * roundBase('1', '36', 1, true) // ['1', '4']
+ * ```
+ * @version 0.3.2
+ */
+declare function roundBase(integer: string, fractional: string, precision: number): [integer: string, fractional: string];
+/**
+ * 四舍六入五成双
+ * @example
+ * ```js
+ * // 四舍六入, 如果后一位是 5(000...) 则看前一位, 凑偶数
+ * roundBank('1', '34', 1, false) // ['1', '3']
+ * roundBank('1', '35', 1, false) // ['1', '4'] 五成双
+ * roundBank('1', '36', 1, false) // ['1', '4']
+ * roundBank('1', '44', 1, false) // ['1', '4']
+ * roundBank('1', '45', 1, false) // ['1', '4'] 五成双
+ * roundBank('1', '450001', 1, false) // ['1', '5'] 后一位比 5(000...) 多所以仍然进位
+ * roundBank('1', '46', 1, false) // ['1', '5']
+ * // 向整数进位也是如此
+ * roundBank('1', '4', 0, false) // ['1', '']
+ * roundBank('1', '5', 0, false) // ['2', ''] 五成双
+ * roundBank('1', '6', 0, false) // ['2', '']
+ * roundBank('2', '4', 0, false) // ['2', '']
+ * roundBank('2', '5', 0, false) // ['2', ''] 五成双
+ * roundBank('2', '6', 0, false) // ['3', '']
+ * // 与符号无关
+ * roundBank('1', '34', 1, true) // ['1', '3']
+ * roundBank('1', '35', 1, true) // ['1', '4'] 五成双
+ * roundBank('1', '36', 1, true) // ['1', '4']
+ * roundBank('1', '44', 1, true) // ['1', '4']
+ * roundBank('1', '45', 1, true) // ['1', '4'] 五成双
+ * roundBank('1', '450001', 1, true) // ['1', '5']
+ * roundBank('1', '46', 1, true) // ['1', '5']
+ * ```
+ * @version 0.3.2
+ */
+declare function roundBank(integer: string, fractional: string, precision: number): [integer: string, fractional: string];
+/** 向下取整
+ * @example
+ * ```js
+ * // 忽略后面的数字向下取整
+ * roundFloor('1', '34', 1, false) // ['1', '3']
+ * roundFloor('1', '36', 1, false) // ['1', '3']
+ * roundFloor('1', '39', 1, false) // ['1', '3']
+ * // 与符号有关 向更小的数字进位
+ * roundFloor('1', '34', 1, true) // ['1', '4']
+ * roundFloor('1', '35', 1, true) // ['1', '4']
+ * roundFloor('1', '36', 1, true) // ['1', '4']
+ * ```
+ * @version 0.3.2
+ */
+declare function roundFloor(integer: string, fractional: string, precision: number, isNegative: boolean): [integer: string, fractional: string];
+/** 向上取整
+ * @example
+ * ```js
+ * // 忽略后面的数字向上取整
+ * roundCeil('1', '34', 1, false) // ['1', '4']
+ * roundCeil('1', '35', 1, false) // ['1', '4']
+ * roundCeil('1', '36', 1, false) // ['1', '4']
+ * // 与符号有关 向更大的数字进位
+ * roundCeil('1', '34', 1, true) // ['1', '3']
+ * roundCeil('1', '35', 1, true) // ['1', '3']
+ * roundCeil('1', '36', 1, true) // ['1', '3']
+ * ```
+ * @version 0.3.2
+ */
+declare function roundCeil(integer: string, fractional: string, precision: number, isNegative: boolean): [integer: string, fractional: string];
+
 /**
  * 根据文件名称判断是否匹配支持的文件类型，需要注意 `.C` 与 `.c` 的区别
  * - `text/x-c++src` 对应 `.C`
@@ -1986,5 +2216,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, dedent, deepClone, deepMerge, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
-export type { BaseMargeType, CloneOptions, CustomCloner, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, RangeOptions, SourceMergeType, TargetMergeType, TypedArray };
+export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, chunk, clamp, compose, _curryMore as curry, debounce, decimalNotation, dedent, deepClone, deepMerge, defer, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, 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, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, round, roundBank, roundBase, roundCeil, roundFloor, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
+export type { BaseMargeType, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };

package/lib/index.mjs

@@ -9,6 +9,53 @@ EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
 MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 See the Mulan PSL v2 for more details.
 */
+function cartesianProduct(...arrList) {
+    const arrLen = arrList.length;
+    const pList = Array(arrLen).fill(0);
+    const lastIndex = arrLen - 1;
+    const res = [];
+    for (let i = 0; i < arrLen; i++) {
+        if (!arrList[i].length)
+            return [];
+    }
+    while (1) {
+        const temp = [];
+        for (let i = 0; i < arrLen; i++) {
+            temp.push(arrList[i][pList[i]]);
+        }
+        res.push(temp);
+        pList[lastIndex] += 1;
+        for (let i = lastIndex; i >= 0; i--) {
+            if (pList[i] >= arrList[i].length) {
+                if (i > 0) {
+                    pList[i] = 0;
+                    pList[i - 1] += 1;
+                }
+                else
+                    break;
+            }
+            else
+                break;
+        }
+        if (pList[0] >= arrList[0].length)
+            break;
+    }
+    return res;
+}
+
+function chunk(array, size = 2) {
+    const res = [];
+    if (size < 1 || isNaN(size))
+        return res;
+    let start = 0, end = size;
+    while (start < array.length) {
+        res.push(Array.prototype.slice.call(array, start, end));
+        start = end;
+        end += size;
+    }
+    return res;
+}
+
 function range(start, end, stepOrOptions) {
     if (!isFinite(start))
         throw new Error('start must be finite');
@@ -200,6 +247,22 @@ function isNumber(value) {
     return typeof value === 'number';
 }
 
+const fnToString = Function.prototype.toString;
+const objProtoContString = fnToString.call(Object.prototype.constructor);
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === null)
+        return true;
+    if (!Object.prototype.hasOwnProperty.call(prototype, "constructor"))
+        return false;
+    const constructorFn = prototype.constructor;
+    if (!isFunction(constructorFn) || fnToString.call(constructorFn) !== objProtoContString)
+        return false;
+    return (Object.getPrototypeOf(prototype) === null);
+}
+
 function isPrimitive(value) {
     return value === undefined || value === null || (typeof value !== 'object' && typeof value !== 'function');
 }
@@ -372,6 +435,178 @@ function clamp(num, min, max, options) {
     return num < min ? defaultMin : num > max ? defaultMax : num;
 }
 
+function decimalNotation(num) {
+    const n = isNumber(num) ? num : Number(num);
+    if (!isFinite(n))
+        return String(n);
+    let str = String(n);
+    if (!/e/i.test(str))
+        return str;
+    const match = str.match(/^(-?)(\d+)\.?(\d*)e([+-]?)(\d+)$/);
+    const [_, sign, mantissaI, mantissaF, expSign, _exponent] = match;
+    const exponent = Number(_exponent);
+    let mantissa = mantissaI + mantissaF;
+    let dotPos = mantissaI.length;
+    if (expSign === '-') {
+        const zeroCount = exponent - dotPos + 1;
+        if (zeroCount > 0)
+            mantissa = '0'.repeat(zeroCount) + mantissa;
+        return sign + mantissa[0] + '.' + mantissa.substring(1);
+    }
+    else {
+        const zeroCount = exponent + dotPos - mantissa.length;
+        if (zeroCount > 0)
+            mantissa = mantissa + '0'.repeat(zeroCount);
+        return sign + mantissa.substring(0, exponent + dotPos);
+    }
+}
+
+function isOdd(num) {
+    return !!(num & 1);
+}
+function isEven(num) {
+    return !(num & 1);
+}
+
+function round(num, precision, type) {
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    let [_integer, _fractional] = str.split('.');
+    let sign = '';
+    if (/^-/.test(_integer)) {
+        _integer = _integer.substring(1);
+        sign = '-';
+    }
+    _fractional = _fractional !== null && _fractional !== void 0 ? _fractional : '';
+    const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+    const [integer, fractional] = (roundMap[type || 'round'] || roundBase)(_integer, _fractional, precision, !!sign);
+    if (precision > 0)
+        return sign + integer + '.' + fractional;
+    else
+        return sign + integer;
+}
+function roundBase(integer, fractional, precision) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (Number(fractional[precision]) > 4)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundBank(integer, fractional, precision) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        const rightNumber = Number(fractional[precision]);
+        if (rightNumber < 5)
+            return [integer, splitF];
+        if (rightNumber > 5)
+            return increase(integer, splitF);
+        const rightNumbers = fractional.substring(precision);
+        if (!/^50*$/.test(rightNumbers))
+            return increase(integer, splitF);
+        const leftNumber = Number(precision ? fractional[precision - 1] : integer[integer.length - 1]);
+        if (isEven(leftNumber))
+            return [integer, splitF];
+        else
+            return increase(integer, splitF);
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundFloor(integer, fractional, precision, isNegative) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (isNegative)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function roundCeil(integer, fractional, precision, isNegative) {
+    if (fractional.length > precision) {
+        const splitF = fractional.substring(0, precision);
+        if (!isNegative)
+            return increase(integer, splitF);
+        return [integer, splitF];
+    }
+    if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    return [integer, fractional];
+}
+function increase(integer, fractional) {
+    if (fractional) {
+        const _fractional = _increase(fractional);
+        if (_fractional.length > fractional.length) {
+            return [_increase(integer), _fractional.substring(1)];
+        }
+        return [integer, _fractional];
+    }
+    return [_increase(integer), ''];
+}
+function _increase(num) {
+    const numList = num.split('').map(Number).reverse();
+    numList[0] += 1;
+    numList.push(0);
+    for (let i = 0; i < numList.length; i++) {
+        if (numList[i] > 9) {
+            numList[i] -= 10;
+            numList[i + 1] += 1;
+        }
+        else
+            break;
+    }
+    if (numList[numList.length - 1] === 0)
+        numList.pop();
+    return numList.reverse().map(String).join('');
+}
+
+function format(num, options) {
+    var _a;
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    const separator = (options || {}).separator || ',';
+    const separate = clamp((options || {}).separate || 3, 1, Infinity);
+    const decimal = (options || {}).decimal || '.';
+    const precision = clamp((_a = (options || {}).precision) !== null && _a !== void 0 ? _a : 2, 0, Infinity);
+    const round = (options || {}).round || 'round';
+    let [integer, fractional] = str.split('.');
+    let sign = '';
+    if (/^-/.test(integer)) {
+        integer = integer.substring(1);
+        sign = '-';
+    }
+    fractional = fractional !== null && fractional !== void 0 ? fractional : '';
+    if (fractional.length > precision) {
+        const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+        [integer, fractional] = (roundMap[round] || roundBase)(integer, fractional, precision, !!sign);
+    }
+    else if (fractional.length < precision) {
+        fractional += '0'.repeat(precision - fractional.length);
+    }
+    if (integer.length > separate) {
+        integer = chunk(Array.from(integer).reverse(), separate)
+            .map((part) => part.join(''))
+            .join(separator);
+        integer = Array.from(integer).reverse().join('');
+    }
+    if (precision > 0)
+        return sign + integer + decimal + fractional;
+    else
+        return sign + integer;
+}
+
 function parallel(args, fn, options) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!args.length)
@@ -2040,4 +2275,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, clamp, compose, _curryMore as curry, debounce, dedent, deepClone, deepMerge, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, chunk, clamp, compose, _curryMore as curry, debounce, decimalNotation, dedent, deepClone, deepMerge, defer, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, 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, memo, noop, not, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, round, roundBank, roundBase, roundCeil, roundFloor, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };

package/lib/index.umd.js

@@ -15,6 +15,53 @@ See the Mulan PSL v2 for more details.
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.foreslash = {}));
 })(this, (function (exports) { 'use strict';
 
+  function cartesianProduct(...arrList) {
+      const arrLen = arrList.length;
+      const pList = Array(arrLen).fill(0);
+      const lastIndex = arrLen - 1;
+      const res = [];
+      for (let i = 0; i < arrLen; i++) {
+          if (!arrList[i].length)
+              return [];
+      }
+      while (1) {
+          const temp = [];
+          for (let i = 0; i < arrLen; i++) {
+              temp.push(arrList[i][pList[i]]);
+          }
+          res.push(temp);
+          pList[lastIndex] += 1;
+          for (let i = lastIndex; i >= 0; i--) {
+              if (pList[i] >= arrList[i].length) {
+                  if (i > 0) {
+                      pList[i] = 0;
+                      pList[i - 1] += 1;
+                  }
+                  else
+                      break;
+              }
+              else
+                  break;
+          }
+          if (pList[0] >= arrList[0].length)
+              break;
+      }
+      return res;
+  }
+
+  function chunk(array, size = 2) {
+      const res = [];
+      if (size < 1 || isNaN(size))
+          return res;
+      let start = 0, end = size;
+      while (start < array.length) {
+          res.push(Array.prototype.slice.call(array, start, end));
+          start = end;
+          end += size;
+      }
+      return res;
+  }
+
   function range(start, end, stepOrOptions) {
       if (!isFinite(start))
           throw new Error('start must be finite');
@@ -206,6 +253,22 @@ See the Mulan PSL v2 for more details.
       return typeof value === 'number';
   }
 
+  const fnToString = Function.prototype.toString;
+  const objProtoContString = fnToString.call(Object.prototype.constructor);
+  function isPlainObject(value) {
+      if (typeof value !== 'object' || value === null)
+          return false;
+      const prototype = Object.getPrototypeOf(value);
+      if (prototype === null)
+          return true;
+      if (!Object.prototype.hasOwnProperty.call(prototype, "constructor"))
+          return false;
+      const constructorFn = prototype.constructor;
+      if (!isFunction(constructorFn) || fnToString.call(constructorFn) !== objProtoContString)
+          return false;
+      return (Object.getPrototypeOf(prototype) === null);
+  }
+
   function isPrimitive(value) {
       return value === undefined || value === null || (typeof value !== 'object' && typeof value !== 'function');
   }
@@ -378,6 +441,178 @@ See the Mulan PSL v2 for more details.
       return num < min ? defaultMin : num > max ? defaultMax : num;
   }
 
+  function decimalNotation(num) {
+      const n = isNumber(num) ? num : Number(num);
+      if (!isFinite(n))
+          return String(n);
+      let str = String(n);
+      if (!/e/i.test(str))
+          return str;
+      const match = str.match(/^(-?)(\d+)\.?(\d*)e([+-]?)(\d+)$/);
+      const [_, sign, mantissaI, mantissaF, expSign, _exponent] = match;
+      const exponent = Number(_exponent);
+      let mantissa = mantissaI + mantissaF;
+      let dotPos = mantissaI.length;
+      if (expSign === '-') {
+          const zeroCount = exponent - dotPos + 1;
+          if (zeroCount > 0)
+              mantissa = '0'.repeat(zeroCount) + mantissa;
+          return sign + mantissa[0] + '.' + mantissa.substring(1);
+      }
+      else {
+          const zeroCount = exponent + dotPos - mantissa.length;
+          if (zeroCount > 0)
+              mantissa = mantissa + '0'.repeat(zeroCount);
+          return sign + mantissa.substring(0, exponent + dotPos);
+      }
+  }
+
+  function isOdd(num) {
+      return !!(num & 1);
+  }
+  function isEven(num) {
+      return !(num & 1);
+  }
+
+  function round(num, precision, type) {
+      const str = decimalNotation(num);
+      if (/NaN|Inf/.test(str))
+          return str;
+      let [_integer, _fractional] = str.split('.');
+      let sign = '';
+      if (/^-/.test(_integer)) {
+          _integer = _integer.substring(1);
+          sign = '-';
+      }
+      _fractional = _fractional !== null && _fractional !== void 0 ? _fractional : '';
+      const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+      const [integer, fractional] = (roundMap[type || 'round'] || roundBase)(_integer, _fractional, precision, !!sign);
+      if (precision > 0)
+          return sign + integer + '.' + fractional;
+      else
+          return sign + integer;
+  }
+  function roundBase(integer, fractional, precision) {
+      if (fractional.length > precision) {
+          const splitF = fractional.substring(0, precision);
+          if (Number(fractional[precision]) > 4)
+              return increase(integer, splitF);
+          return [integer, splitF];
+      }
+      if (fractional.length < precision) {
+          fractional += '0'.repeat(precision - fractional.length);
+      }
+      return [integer, fractional];
+  }
+  function roundBank(integer, fractional, precision) {
+      if (fractional.length > precision) {
+          const splitF = fractional.substring(0, precision);
+          const rightNumber = Number(fractional[precision]);
+          if (rightNumber < 5)
+              return [integer, splitF];
+          if (rightNumber > 5)
+              return increase(integer, splitF);
+          const rightNumbers = fractional.substring(precision);
+          if (!/^50*$/.test(rightNumbers))
+              return increase(integer, splitF);
+          const leftNumber = Number(precision ? fractional[precision - 1] : integer[integer.length - 1]);
+          if (isEven(leftNumber))
+              return [integer, splitF];
+          else
+              return increase(integer, splitF);
+      }
+      if (fractional.length < precision) {
+          fractional += '0'.repeat(precision - fractional.length);
+      }
+      return [integer, fractional];
+  }
+  function roundFloor(integer, fractional, precision, isNegative) {
+      if (fractional.length > precision) {
+          const splitF = fractional.substring(0, precision);
+          if (isNegative)
+              return increase(integer, splitF);
+          return [integer, splitF];
+      }
+      if (fractional.length < precision) {
+          fractional += '0'.repeat(precision - fractional.length);
+      }
+      return [integer, fractional];
+  }
+  function roundCeil(integer, fractional, precision, isNegative) {
+      if (fractional.length > precision) {
+          const splitF = fractional.substring(0, precision);
+          if (!isNegative)
+              return increase(integer, splitF);
+          return [integer, splitF];
+      }
+      if (fractional.length < precision) {
+          fractional += '0'.repeat(precision - fractional.length);
+      }
+      return [integer, fractional];
+  }
+  function increase(integer, fractional) {
+      if (fractional) {
+          const _fractional = _increase(fractional);
+          if (_fractional.length > fractional.length) {
+              return [_increase(integer), _fractional.substring(1)];
+          }
+          return [integer, _fractional];
+      }
+      return [_increase(integer), ''];
+  }
+  function _increase(num) {
+      const numList = num.split('').map(Number).reverse();
+      numList[0] += 1;
+      numList.push(0);
+      for (let i = 0; i < numList.length; i++) {
+          if (numList[i] > 9) {
+              numList[i] -= 10;
+              numList[i + 1] += 1;
+          }
+          else
+              break;
+      }
+      if (numList[numList.length - 1] === 0)
+          numList.pop();
+      return numList.reverse().map(String).join('');
+  }
+
+  function format(num, options) {
+      var _a;
+      const str = decimalNotation(num);
+      if (/NaN|Inf/.test(str))
+          return str;
+      const separator = (options || {}).separator || ',';
+      const separate = clamp((options || {}).separate || 3, 1, Infinity);
+      const decimal = (options || {}).decimal || '.';
+      const precision = clamp((_a = (options || {}).precision) !== null && _a !== void 0 ? _a : 2, 0, Infinity);
+      const round = (options || {}).round || 'round';
+      let [integer, fractional] = str.split('.');
+      let sign = '';
+      if (/^-/.test(integer)) {
+          integer = integer.substring(1);
+          sign = '-';
+      }
+      fractional = fractional !== null && fractional !== void 0 ? fractional : '';
+      if (fractional.length > precision) {
+          const roundMap = { round: roundBase, banker: roundBank, floor: roundFloor, ceil: roundCeil };
+          [integer, fractional] = (roundMap[round] || roundBase)(integer, fractional, precision, !!sign);
+      }
+      else if (fractional.length < precision) {
+          fractional += '0'.repeat(precision - fractional.length);
+      }
+      if (integer.length > separate) {
+          integer = chunk(Array.from(integer).reverse(), separate)
+              .map((part) => part.join(''))
+              .join(separator);
+          integer = Array.from(integer).reverse().join('');
+      }
+      if (precision > 0)
+          return sign + integer + decimal + fractional;
+      else
+          return sign + integer;
+  }
+
   function parallel(args, fn, options) {
       return __awaiter(this, void 0, void 0, function* () {
           if (!args.length)
@@ -2052,20 +2287,24 @@ See the Mulan PSL v2 for more details.
   exports.acceptableFileType = acceptableFileType;
   exports.camelCase = camelCase;
   exports.capitalize = capitalize;
+  exports.cartesianProduct = cartesianProduct;
   exports.caseCamel = caseCamel;
   exports.caseConvert = caseConvert;
   exports.caseKebab = caseKebab;
   exports.casePascal = casePascal;
   exports.caseSnake = caseSnake;
+  exports.chunk = chunk;
   exports.clamp = clamp;
   exports.compose = compose;
   exports.curry = _curryMore;
   exports.debounce = debounce;
+  exports.decimalNotation = decimalNotation;
   exports.dedent = dedent;
   exports.deepClone = deepClone;
   exports.deepMerge = deepMerge;
   exports.defer = defer;
   exports.fastClone = fastClone;
+  exports.format = format;
   exports.getAcceptableExtByMIME = getAcceptableExtByMIME;
   exports.getAcceptableMIMEByExt = getAcceptableMIMEByExt;
   exports.getGlobalThis = getGlobalThis;
@@ -2083,6 +2322,7 @@ See the Mulan PSL v2 for more details.
   exports.isDataView = isDataView;
   exports.isDate = isDate;
   exports.isEmpty = isEmpty;
+  exports.isEven = isEven;
   exports.isFile = isFile;
   exports.isFloat32Array = isFloat32Array;
   exports.isFloat64Array = isFloat64Array;
@@ -2099,7 +2339,9 @@ See the Mulan PSL v2 for more details.
   exports.isNull = isNull;
   exports.isNumber = isNumber;
   exports.isObject = isObject;
+  exports.isOdd = isOdd;
   exports.isPlaceholder = isPlaceholder;
+  exports.isPlainObject = isPlainObject;
   exports.isPrimitive = isPrimitive;
   exports.isPromise = isPromise;
   exports.isPromiseLike = isPromiseLike;
@@ -2139,6 +2381,11 @@ See the Mulan PSL v2 for more details.
   exports.range = range;
   exports.remove = remove;
   exports.retry = retry;
+  exports.round = round;
+  exports.roundBank = roundBank;
+  exports.roundBase = roundBase;
+  exports.roundCeil = roundCeil;
+  exports.roundFloor = roundFloor;
   exports.shuffle = shuffle;
   exports.sleep = sleep;
   exports.snakeCase = snakeCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",
@@ -35,11 +35,11 @@
   "scripts": {
     "dev": "rollup -c -w",
     "build": "rollup -c",
-    "test": "jest --coverage",
-    "prepublishOnly": "npm run build && npm run test",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "test": "tsd --files /test/**/*.test-d.ts && jest --coverage",
+    "prepublishOnly": "jest --coverage && npm run build",
+    "docs:dev": "rollup -c && vitepress dev docs",
+    "docs:build": "rollup -c && vitepress build docs",
+    "docs:preview": "rollup -c && vitepress preview docs"
   },
   "keywords": [
     "foreslash",
@@ -57,6 +57,7 @@
     "rollup-plugin-dts": "^6.2.1",
     "sass-embedded": "^1.90.0",
     "ts-jest": "^29.2.5",
+    "tsd": "^0.33.0",
     "tslib": "^2.7.0",
     "typescript": "^5.5.4",
     "vitepress": "^1.6.3",