foreslash 0.3.0 → 0.3.2

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;
@@ -196,8 +252,7 @@ declare function retry<T>(asyncFunction: RetryFunction<T>, option?: RetryOption)
  */
 declare function sleep(time?: number): Promise<unknown>;
 
-type TryitResultType<Res, Err> = [undefined, Res] | [Err, undefined];
-type TryitResult<Res, Err extends Error> = Res extends Promise<infer R> ? Promise<TryitResultType<R, Err>> : TryitResultType<Res, Err>;
+type TryitResult<Res, Err> = [undefined, Res] | [Err, undefined];
 /**
  * 将一个函数处理为 `error-first` 的函数
  * @param fn 需要处理的函数, 可以是异步函数
@@ -207,11 +262,6 @@ type TryitResult<Res, Err extends Error> = Res extends Promise<infer R> ? Promis
  * 如果出现异常则 `result` 为 `undefined`, `error` 是原函数抛出的错误
  * @example
  * ```js
- * // Sync Function
- * const normalFn = () => { return 1 }
- * const errorFn = () => { throw new Error('1') }
- * tryit(normalFn)() // [undefined, 1]
- * tryit(errorFn)() // [Error('1'), undefined]
  * // Async Function
  * const normalAsyncFn = () => { return Promise.resolve(1) }
  * const errorAsyncFn = () => { return Promise.reject('1') }
@@ -220,6 +270,24 @@ type TryitResult<Res, Err extends Error> = Res extends Promise<infer R> ? Promis
  * ```
  * @version 0.2.0
  */
+declare function tryit<Args extends any[], Res, Err extends Error>(fn: (...args: Args) => Promise<Res>): (...args: Args) => Promise<TryitResult<Res, Err>>;
+/**
+ * 将一个函数处理为 `error-first` 的函数
+ * @param fn 需要处理的函数, 可以是异步函数
+ * @returns 处理过的函数, 调用后返回一个 `error-first` 的元组 `[error, result]`;\
+ * 如果原函数是异步函数, 则返回值会是 `Promise<[error, result]>`;\
+ * 如果运行正常则 `result` 是原函数的返回值, `error` 为 `undefined`;\
+ * 如果出现异常则 `result` 为 `undefined`, `error` 是原函数抛出的错误
+ * @example
+ * ```js
+ * // Sync Function
+ * const normalFn = () => { return 1 }
+ * const errorFn = () => { throw new Error('1') }
+ * tryit(normalFn)() // [undefined, 1]
+ * tryit(errorFn)() // [Error('1'), undefined]
+ * ```
+ * @version 0.2.0
+ */
 declare function tryit<Args extends any[], Res, Err extends Error>(fn: (...args: Args) => Res): (...args: Args) => TryitResult<Res, Err>;
 
 interface PromiseLikeConstructor {
@@ -527,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`
@@ -864,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`
@@ -1264,6 +1506,74 @@ declare function caseKebab(str: string, keepLetterCase?: boolean, keepNumber?: b
  */
 declare function caseSnake(str: string, keepLetterCase?: boolean, keepNumber?: boolean): string;
 
+/**
+ * 给一个多行的字符串清除缩进效果
+ * @param str 需要处理的字符串
+ * @param count 缩进数量, 默认为 `2`
+ * @param indentStr 缩进字符串, 默认为 ` `(一个空格)
+ * @returns 处理过的字符串
+ * @example
+ * ```js
+ * dedent(`  a\n  b\n    c`) // `a\nb\n  c`
+ * dedent(`*a\n**b\n****c`, 3, '*') // `a\nb\n*c`
+ * ```
+ * @version 0.3.1
+ */
+declare function dedent(str: string, count?: number | null, indentStr?: string): string;
+/**
+ * 给一个多行的字符串清除缩进效果
+ * @param str 需要处理的字符串
+ * @param option 缩进效果配置
+ * - `count` 缩进数量, 默认为 `2`
+ * - `indentStr` 缩进字符串, 默认为 ` `(一个空格)
+ * @returns 处理过的字符串
+ * @example
+ * ```js
+ * dedent(`  a\n  b\n    c`) // `a\nb\n  c`
+ * dedent(`*a\n**b\n****c`, { count: 3, indentStr: '*' }) // `a\nb\n*c`
+ * ```
+ * @version 0.3.1
+ */
+declare function dedent(str: string, option?: {
+    count?: number;
+    indentStr?: string;
+}): string;
+
+/**
+ * 给一个多行的字符串添加缩进效果
+ * @param str 需要处理的字符串
+ * @param count 缩进数量, 默认为 `2`
+ * @param indentStr 缩进字符串, 默认为 ` `(一个空格)
+ * @returns 处理过的字符串
+ * @example
+ * ```js
+ * indent(`a\nb\n  c`) // `  a\n  b\n    c`
+ * indent(`a\nb\n  c`, 1, '*') // `*a\n*b\n*  c`
+ * ```
+ * @version 0.3.1
+ */
+declare function indent(str: string, count?: number | null, indentStr?: string): string;
+/**
+ * 给一个多行的字符串添加缩进效果
+ * @param str 需要处理的字符串
+ * @param option 缩进效果配置
+ * - `count` 缩进数量, 默认为 `2`
+ * - `indentStr` 缩进字符串, 默认为 ` `(一个空格)
+ * - `ignoreEmptyLine` 是否忽略空行, 默认为是
+ * @returns 处理过的字符串
+ * @example
+ * ```js
+ * indent(`a\nb\n  c`) // `  a\n  b\n    c`
+ * indent(`a\nb\n  c`, { count: 1, indentStr: '*' }) // `*a\n*b\n*  c`
+ * ```
+ * @version 0.3.1
+ */
+declare function indent(str: string, option?: {
+    count?: number;
+    indentStr?: string;
+    ignoreEmptyLine?: boolean;
+}): string;
+
 /**
  * 分割单词, 适用于分割、转换变量名的场景
  * - 任何非英文字母、数字的字符均会视为分割符
@@ -1906,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, deepClone, deepMerge, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, 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)
@@ -1304,6 +1539,45 @@ function caseSnake(str, keepLetterCase = false, keepNumber = true) {
     return _caseConvert(tokens, '_', keepLetterCase ? ({ code }) => code : ({ code }) => code.toLowerCase());
 }
 
+function dedent(str, option, indentStr) {
+    if (typeof option === 'number' || indentStr) {
+        return _dedent(str, option || 2, indentStr || ' ');
+    }
+    else {
+        const { count = 2, indentStr = ' ' } = option || {};
+        return _dedent(str, count, indentStr);
+    }
+}
+function _dedent(str, count, indentStr) {
+    return str
+        .split('\n')
+        .map((s) => {
+        let i = count;
+        while (s && s.startsWith(indentStr) && i > 0) {
+            s = s.slice(indentStr.length);
+            i--;
+        }
+        return s;
+    })
+        .join('\n');
+}
+
+function indent(str, option, indentStr) {
+    if (typeof option === 'number' || indentStr) {
+        return _indent(str, option || 2, indentStr || ' ', true);
+    }
+    else {
+        const { count = 2, indentStr = ' ', ignoreEmptyLine = true } = option || {};
+        return _indent(str, count, indentStr, ignoreEmptyLine);
+    }
+}
+function _indent(str, count, indentStr, ignoreEmptyLine) {
+    return str
+        .split('\n')
+        .map((s) => `${s || !ignoreEmptyLine ? indentStr.repeat(count) : ''}${s}`)
+        .join('\n');
+}
+
 function splitWords(str) {
     return _splitVar(str).map(({ code }) => code);
 }
@@ -2001,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, deepClone, deepMerge, defer, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, 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 };