foreslash 0.3.1 → 0.3.3

package/lib/index.d.ts

@@ -1,5 +1,111 @@
 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[][];
+
+/**
+ * 将值转换为一个数组
+ * @param value 需要处理的值
+ * @returns 一个数组, 如果输入值是数组, 则输出的数组是其**浅拷贝**; 如果输入不是数组，则将输入包进一个新数组里
+ * @example
+ * ```js
+ * // 如果输入不是数组，则将输入包进一个新数组里
+ * castArray(1) // [1]
+ * castArray('1') // ['1']
+ * castArray(null) // [null]
+ *
+ * // 如果输入值是数组, 则输出的数组是其浅拷贝
+ * castArray([1, 2, 3, 4, 5]) // [1, 2, 3, 4, 5]
+ * ```
+ * @version 0.3.3
+ */
+declare function castArray<T>(value: T): CastArray<T>;
+/**
+ * 将任意输入处理为数组:
+ * 1. `never` 类型判断, 确保 `castArray<never>` 返回 `never[]` 而不是 `unknown[]`
+ * 2. `unknown` 类型判断, `unknown` 是顶级类型, 需要特殊处理
+ * 3. `readonly any[]` 类型判断, 输出的类型需要去除 `readonly`
+ * 4. 非数组类型判断, 处理联合类型
+ *
+ * 数组类型判据:
+ * - 如果 `Exclude<T, readonly any[]> extends never` 意味着 `T` 的类型与 `any[]` 兼容, 此时应该走逻辑 3
+ *
+ * @example
+ * ```ts
+ * type T = CastArray<string> // string[]
+ * type T = CastArray<string[]> // string[]
+ * type T = CastArray<readonly string[]> // string[]
+ * // 特殊类型
+ * type T = CastArray<any> // any[]
+ * type T = CastArray<unknown> // unknown[]
+ * type T = CastArray<never> // never[]
+ * // 联合类型
+ * type T = CastArray<string | number> // (string | number)[]
+ * type T = CastArray<string[] | number> // string[] | number[]
+ * type T = CastArray<string | number | never> // (string | number)[]
+ * type T = CastArray<string | number[] | never[]> // never[] | number[] | string[]
+ * type T = CastArray<string | number | never[]> // never[] | (string | number)[]
+ * ```
+ */
+type CastArray<T> = [
+    T
+] extends [never] ? never[] : [
+    unknown
+] extends [T] ? unknown[] : (T extends readonly (infer U)[] ? U[] : never) | (Exclude<T, readonly any[]> extends never ? never : Exclude<T, readonly 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;
@@ -197,24 +303,6 @@ declare function retry<T>(asyncFunction: RetryFunction<T>, option?: RetryOption)
 declare function sleep(time?: number): Promise<unknown>;
 
 type TryitResult<Res, Err> = [undefined, Res] | [Err, undefined];
-/**
- * 将一个函数处理为 `error-first` 的函数
- * @param fn 需要处理的函数, 可以是异步函数
- * @returns 处理过的函数, 调用后返回一个 `error-first` 的元组 `[error, result]`;\
- * 如果原函数是异步函数, 则返回值会是 `Promise<[error, result]>`;\
- * 如果运行正常则 `result` 是原函数的返回值, `error` 为 `undefined`;\
- * 如果出现异常则 `result` 为 `undefined`, `error` 是原函数抛出的错误
- * @example
- * ```js
- * // Async Function
- * const normalAsyncFn = () => { return Promise.resolve(1) }
- * const errorAsyncFn = () => { return Promise.reject('1') }
- * tryit(normalAsyncFn)() // Promise<[undefined, 1]>
- * tryit(errorAsyncFn)() // Promise<[Error('1'), undefined]>
- * ```
- * @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 需要处理的函数, 可以是异步函数
@@ -229,9 +317,15 @@ declare function tryit<Args extends any[], Res, Err extends Error>(fn: (...args:
  * 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(new Error('1')) }
+ * tryit(normalAsyncFn)() // Promise<[undefined, 1]>
+ * tryit(errorAsyncFn)() // Promise<[Error('1'), undefined]>
  * ```
  * @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>>;
 declare function tryit<Args extends any[], Res, Err extends Error>(fn: (...args: Args) => Res): (...args: Args) => TryitResult<Res, Err>;
 
 interface PromiseLikeConstructor {
@@ -539,6 +633,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 +985,289 @@ 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;
+
+/**
+ * 将一个数字转换为指定的格式(如千分位逗号分隔)\
+ * 如果想要将数字转换为科学计数法, 请使用 `scientificNotation`
+ * @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;
+
+/**
+ * 用线性插值法求取一个中间值
+ * @param val1 第一个值, 当 权重=0 时返回的将是这个值, 可以是数组或二维数组
+ * @param val2 第二个值, 当 权重=0 时返回的将是这个值, 可以是数组或二维数组
+ * @param t 权重
+ * @example
+ * ```js
+ * // 传入数值
+ * lerp(1, 2, 0) // 1
+ * lerp(1, 2, 0.5) // 1.5
+ * lerp(1, 2, 1) // 2
+ * lerp(1, 2, 3) // 4
+ *
+ * // 传入数组(数组长度必须一致否则会报错)
+ * lerp([1, 2], [2, 4], 0.5) // [1.5, 3]
+ *
+ * // 传入二维数组(数组长度必须一致否则会报错)
+ * lerp(
+ *   [
+ *     [1, 2],
+ *     [3, 4],
+ *   ],
+ *   [
+ *     [11, 12],
+ *     [13, 14],
+ *   ],
+ *   0.5
+ * )
+ * // [
+ * //   [6, 7],
+ * //   [8, 9],
+ * // ]
+ * ```
+ * @version 0.3.3
+ */
+declare function lerp(val1: number, val2: number, t: number): number;
+declare function lerp(val1: [number], val2: [number], t: number): [number];
+declare function lerp(val1: [number, number], val2: [number, number], t: number): [number, number];
+declare function lerp(val1: [number, number, number], val2: [number, number, number], t: number): [number, number, number];
+declare function lerp(val1: [number, number, number, number], val2: [number, number, number, number], t: number): [number, number, number, number];
+declare function lerp(val1: [number, number, number, number, number], val2: [number, number, number, number, number], t: number): [number, number, number, number, number];
+declare function lerp(val1: [number, number, number, number, number, number], val2: [number, number, number, number, number, number], t: number): [number, number, number, number, number, number];
+declare function lerp(val1: [number, number, number, number, number, number, number], val2: [number, number, number, number, number, number, number], t: number): [number, number, number, number, number, number, number];
+declare function lerp(val1: [number, number, number, number, number, number, number, number], val2: [number, number, number, number, number, number, number, number], t: number): [number, number, number, number, number, number, number, number];
+declare function lerp(val1: number[], val2: number[], t: number): number[];
+declare function lerp(val1: number[][], val2: number[][], t: number): number[][];
+
+/**
+ * 将一个数字转换为罗马数字, 罗马数字没有 `0`、小数和负数
+ * @param num 需要转换的数字
+ * @param options 格式化配置\
+ * `type` 类型, 默认为 `unicode`, 以数字 `4090` 为例
+ *   - `'unicode'` 使用 Unicode 表示 `'I̅V̅XC'`
+ *   - `'js'` 适合用于 JavaScript 代码字符串 `'I\\u0305V\\u0305XC'`
+ *   - `'html'` 适合用于 HTML 展示的字符串 `'I&#x0305;V&#x0305;XC'`
+ *   - `'json'` 一个 JSON 字符串, 具体数值是下标^1000 `["XC", "IV"]`
+ *
+ * `thousand` 千分位类型, 默认为 `normal`
+ *   - `'normal'` 习惯用法, 超过 3999 的部分才使用上划线区分
+ *   - `'strict'` 严格区分千分位
+ *
+ * `zero` 用什么字符串表示 `0` (罗马数字里没有 `0`), 不填默认为 `'0'`\
+ * `one` 用什么字符串表示 `1` (你可以设置一个彩蛋, 比如输出 `Yo`), 不填默认为 `'I'`, 这项**只会影响数字 1**
+ * @returns 返回一个罗马数字表示的数字
+ * @example
+ * ```js
+ * romanNumerals(2025) // MMXXV
+ * romanNumerals(2025, { thousand: 'strict' }) // I̅I̅XXV
+ * ```
+ * @version 0.3.3
+ */
+declare function romanNumerals(num: string | number, options?: {
+    type?: 'unicode' | 'js' | 'html' | 'json';
+    thousand?: 'normal' | 'strict';
+    zero?: string;
+    one?: string;
+}): string;
+
+/**
+ * 数值修约, 可以使用 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];
+
+/**
+ * 将一个数字转换为科学计数法
+ * @param num 需要转换的数字
+ * @param options 格式化配置\
+ * `type` 类型, 默认为 `unicode`
+ *   - `'unicode'` 指数部分使用 Unicode 表示 `1.23×10⁴⁵⁶`
+ *   - `'exp'` 用指数表示法, 用 `e` 替换 `×10` 部分 `1.23e+456`
+ *   - `'js'` 适合用于 JavaScript 的算式 `1.23*10**456`
+ *   - `'code'` 适合用于其他计算机语言的算式 `1.23*10^456`
+ *   - `'html'` 适合用于 HTML 展示的字符串 `1.23&#x00d7;10<sup>456</sup>`
+ *   - `'json'` 一个 JSON 字符串, 可以自由处理 `{"number":1.23,"exp":456}`
+ *
+ * `precision` 小数精度, 默认不作数值修约\
+ * `round` 数值修约规则
+ *   - `'round'` 四舍五入
+ *   - `'banker'` 四舍六入五成双
+ *   - `'floor'` 向下取整
+ *   - `'ceil'` 向上取整
+ * @returns 返回一个科学计数法表示的数字
+ * @example
+ * ```js
+ * scientificNotation(1e12) // 1×10¹²
+ * scientificNotation(-2.33e-8) // -2.33×10⁻⁸
+ * // 可以指定输出类型
+ * scientificNotation(1.234e-6, { type: 'exp' }) // 1.234e-6
+ * scientificNotation(1.234e6, { type: 'exp' }) // 1.234e+6
+ * scientificNotation(6.534e-6, { type: 'code' }) // 6.534*10^-6
+ * scientificNotation(6.534e6, { type: 'code' }) // 6.534*10^6
+ * scientificNotation(-4.321e-8, { type: 'html' }) // -4.321&#x00d7;10<sup>-8</sup>
+ * scientificNotation(-4.321e8, { type: 'html' }) // -4.321&#x00d7;10<sup>8</sup>
+ * scientificNotation(-9.87e-9, { type: 'json' }) // {"number":"-9.87","exp":-9}
+ * scientificNotation(-9.87e9, { type: 'json' }) // {"number":"-9.87","exp":9}
+ * // 可以指定小数点后的位数及数值修约规则
+ * scientificNotation(1.235e6, { type: 'exp', precision: 2 }) // 1.24e+6
+ * scientificNotation(6.545e-6, { type: 'code', precision: 2, round: 'banker' }) // 6.54*10^-6
+ * scientificNotation(-9.87e9, { type: 'json', precision: 1, round: 'floor' }) // {"number":"-9.9","exp":9}
+ * ```
+ * @version 0.3.3
+ */
+declare function scientificNotation(num: string | number, options?: {
+    type?: 'unicode' | 'exp' | 'js' | 'code' | 'html' | 'json';
+    precision?: number;
+    round?: 'round' | 'banker' | 'floor' | 'ceil';
+}): string;
+
 /**
  * 根据文件名称判断是否匹配支持的文件类型，需要注意 `.C` 与 `.c` 的区别
  * - `text/x-c++src` 对应 `.C`
@@ -970,6 +1362,35 @@ declare function getAcceptableMIMEByExt(ext: string): string[];
  */
 declare function randomChoice<T>(arr: ArrayLike<T>, weights?: ArrayLike<number>): T;
 
+/**
+ * 一个广泛使用的[伪随机数生成算法(PRD)](https://github.com/Moushudyx/pseudo-random-distribution)\
+ * 返回一个方法, 输出为布尔型, 可以生成一个比正常随机序列分布更加均匀的伪随机数列\
+ * 可以极大地避免罕见牌型出现, 缺点是初始概率很低(即第一次命中的概率远远小于输入的 `p`)\
+ * 建议在投入使用之前, 先调用 `ceil(1 / p)` 次作为初始化\
+ * 此外需要注意的是, 这个算法的最终的精度并不是完全等于输入的 `p` 值
+ * @param p 整体概率值, 即概率的数学期望
+ * @param options 相关配置
+ * - `threshold` 精度, 数值越小, 精度越高, 序列越接近目标 `p` 值, 默认为 `5e-6`
+ * @returns 一个方法, 按给定的概率值返回 `true` 和 `false`
+ * @example
+ * ```js
+ * const p0_5 = pipe(randomDistribution(0.5), Number)
+ * p0_5() // 0, 1, 0, 0, 1, 1 ...
+ * ```
+ * @version 0.3.3
+ */
+declare function randomDistribution(p: number, options?: {
+    threshold: number;
+}): () => boolean;
+/**
+ * 内部方法, 用于实现 `randomDistribution` 中的 PRD 算法部分, 根据目标概率, 给出一个初始概率
+ * @param targetP 目标概率
+ * @param threshold 精度, 数值越小, 精度越高
+ * @returns PRD 算法需要的初始概率
+ * @version 0.3.3
+ */
+declare function getInitP(targetP: number, threshold?: number): number;
+
 /**
  * 生成指定范围内的随机整数
  * @param min 随机数的下界，包含于此范围内
@@ -1799,6 +2220,7 @@ declare function isEmpty(value: unknown): boolean;
  *   return fib(n - 1) + fib(n - 2)
  * })
  * ```
+ * @version 0.2.1
  */
 declare function memo<TArgs extends any[], TRes>(fn: (...args: TArgs) => TRes, options?: {
     getKey?: (...args: TArgs) => string | number;
@@ -1986,5 +2408,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, castArray, chunk, clamp, compose, _curryMore as curry, debounce, decimalNotation, dedent, deepClone, deepMerge, defer, 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, parallel, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, withResolvers };
+export type { BaseMargeType, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };