foreslash 0.3.6 → 0.3.7

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Change Log
 
-## Version 0.3.6 - 2026-01-
+## Version 0.3.7 - 2026-01-24
+
+Add a method to convert numbers to Chinese numerals
+
+- Feat 🥥 Functions added: `chinaNumerals`
+
+添加了将数字转换为中文的方法
+
+- 功能 🥥 添加函数: `chinaNumerals`
+
+## Version 0.3.6 - 2026-01-09
 
 Unstable version
 

package/lib/index.cmn.cjs

@@ -424,23 +424,6 @@ function defer(asyncFunction, options) {
     });
 }
 
-function clamp(num, min, max, options) {
-    var _a, _b;
-    if (isNaN(min))
-        throw new Error('Invalid min parameter');
-    if (isNaN(max))
-        throw new Error('Invalid max parameter');
-    if (max < min) {
-        [min, max] = [max, min];
-    }
-    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-    if (isNaN(num))
-        return defaultMin;
-    return num < min ? defaultMin : num > max ? defaultMax : num;
-}
-
 function decimalNotation(num) {
     const n = isNumber(num) ? num : Number(num);
     if (!isFinite(n))
@@ -467,6 +450,138 @@ function decimalNotation(num) {
     }
 }
 
+function chinaNumerals(num, options) {
+    var _a, _b, _c;
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    const type = (options || {}).type || 'normal';
+    const numeralsType = (options || {}).numeralsType || 'normal';
+    const customNumerals = (options || {}).customNumerals;
+    const customUnits = Array.from((options || {}).customUnits || (type === 'upper' ? '拾佰仟万亿兆京垓秭穰沟涧正载' : '十百千万亿兆京垓秭穰沟涧正载'));
+    customUnits.unshift('');
+    if (type === 'custom' && (!customNumerals || customNumerals.length !== 10)) {
+        throw new Error('Invalid customNumerals: customNumerals must be provided and its length must be 10.');
+    }
+    const numberChar = Array.from(type === 'normal'
+        ? '零一二三四五六七八九'
+        : type === 'lower'
+            ? '〇一二三四五六七八九'
+            : type === 'upper'
+                ? '零壹贰叁肆伍陆柒捌玖'
+                : customNumerals);
+    const zeroChar = numberChar[0];
+    const zeroRegex = new RegExp(`${zeroChar}+`, 'g');
+    const trailingZeroRegex = new RegExp(`${zeroChar}$`);
+    const [integer, fractional] = str.split('.');
+    let integerPart = '';
+    if (numeralsType === 'minio') {
+        const chunks = chunk(Array.from(integer).reverse(), customUnits.length - 1);
+        const parts = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const subChunk = chunks[i].reverse();
+            const chars = subChunk
+                .map((digit, index) => {
+                const num = Number(digit);
+                const unitIndex = subChunk.length - 1 - index;
+                if (num === 0)
+                    return numberChar[num];
+                else
+                    return numberChar[num] + customUnits[unitIndex];
+            })
+                .filter((part) => part !== '');
+            if (chars.length > 0) {
+                const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                const unitIndex = i * (customUnits.length - 1);
+                parts.unshift(stringified + (unitIndex > 0 ? customUnits[unitIndex] : ''));
+            }
+        }
+        const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+        integerPart = result === '' ? numberChar[0] : result;
+    }
+    else {
+        const chunks = chunk(Array.from(integer).reverse(), 4);
+        const parts = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const subChunk = chunks[i].reverse();
+            const chars = subChunk
+                .map((digit, index) => {
+                const num = Number(digit);
+                const unitIndex = subChunk.length - 1 - index;
+                if (num === 0)
+                    return numberChar[num];
+                else
+                    return numberChar[num] + customUnits[unitIndex];
+            })
+                .filter((part) => part !== '');
+            if (chars.length > 0) {
+                const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                let unitStr = '';
+                if (numeralsType === 'normal') {
+                    unitStr = getNormalUnits(customUnits.slice(4), i);
+                }
+                else if (numeralsType === 'mega') {
+                    unitStr = getMegaUnits(customUnits.slice(4), i);
+                }
+                if (stringified !== '')
+                    parts.unshift(stringified + unitStr);
+            }
+        }
+        const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+        integerPart = result === '' ? numberChar[0] : result;
+    }
+    return fractional
+        ? integerPart +
+            ((_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '') +
+            ((_b = options === null || options === void 0 ? void 0 : options.dot) !== null && _b !== void 0 ? _b : '点') +
+            fractional
+                .split('')
+                .map((d, i) => { var _a, _b; return numberChar[Number(d)] + ((_b = (_a = options === null || options === void 0 ? void 0 : options.fractionalUnits) === null || _a === void 0 ? void 0 : _a[i]) !== null && _b !== void 0 ? _b : ''); })
+                .join('')
+        : integerPart + ((_c = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _c !== void 0 ? _c : '');
+}
+function getNormalUnits(units, index) {
+    if (index === 0)
+        return '';
+    if (index <= units.length)
+        return units[index - 1];
+    const majorCount = Math.floor(index / units.length);
+    const minorIndex = index % units.length;
+    return (minorIndex > 0 ? units[minorIndex - 1] : '') + units[units.length - 1].repeat(majorCount);
+}
+function getMegaUnits(units, index) {
+    if (index === 0)
+        return '';
+    if (index === 1)
+        return units[0];
+    const combinations = 2 ** (units.length - 1);
+    const majorCount = Math.floor(index / combinations);
+    let minorIndex = index % combinations;
+    let result = '';
+    for (let i = 0; i < units.length; i++) {
+        if ((minorIndex & (1 << i)) !== 0)
+            result += units[i];
+    }
+    return result + units[units.length - 1].repeat(majorCount);
+}
+
+function clamp(num, min, max, options) {
+    var _a, _b;
+    if (isNaN(min))
+        throw new Error('Invalid min parameter');
+    if (isNaN(max))
+        throw new Error('Invalid max parameter');
+    if (max < min) {
+        [min, max] = [max, min];
+    }
+    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+    if (isNaN(num))
+        return defaultMin;
+    return num < min ? defaultMin : num > max ? defaultMax : num;
+}
+
 function isOdd(num) {
     return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
@@ -2652,6 +2767,7 @@ exports.caseKebab = caseKebab;
 exports.casePascal = casePascal;
 exports.caseSnake = caseSnake;
 exports.castArray = castArray;
+exports.chinaNumerals = chinaNumerals;
 exports.chunk = chunk;
 exports.clamp = clamp;
 exports.compose = compose;

package/lib/index.d.ts

@@ -958,6 +958,60 @@ declare function isWrapperSymbol(value: unknown): value is Symbol;
  */
 declare function isWrapperBigInt(value: unknown): value is BigInt;
 
+/**
+ * 将一个数字转换为汉语表达, 可以配置大写或小写, 默认使用小写(除了 0 默认使用 `零`)
+ * @param num 需要转换的数字
+ * @param options 格式化配置\
+ * `type` 类型, 默认为 `normal`
+ * - `'normal'` 习惯写法, 如 `2025` 会转换为 `二千零二十五`
+ * - `'lower'` 小写, 如 `2025` 会转换为 `二千〇二十五`
+ * - `'upper'` 大写, 如 `2025` 会转换为 `贰仟零贰拾伍`
+ * - `'custom'` 自定义, 允许传入自定义的数字和单位字符, 具体见下方 `customNumerals` 和 `customUnits`
+ *
+ * `numeralsType` 数字类型, 默认为 `normal`
+ * - `'normal'` 使用常规的中数表示法, 以万为单位, 万万为亿、万亿为兆、万兆为京
+ * - `'minio'` 古代的下数表示法, 十万为亿、十亿为兆、十兆为京
+ * - `'mega'` 古代的上数表示法, 万万为亿、亿亿为兆、兆兆为京
+ *
+ * `customNumerals` 自定义数字字符, 类型为 `ArrayLike<string>`\
+ * 分别用于表示 0-9 , 仅在 `type` 为 `'custom'` 时有效\
+ * 需要传入一个长度为 10 的字符串, 如 `'零壹贰叁肆伍陆柒捌玖'`\
+ * 如果传入的长度不为 10, 则会抛出一个错误
+ *
+ * `customUnits` 自定义单位字符, 类型为 `ArrayLike<string>`\
+ * 用于表示进位, 如 `'十百千万亿兆京垓秭穰沟涧正载'`\
+ * 前 3 个单位固定表示十(10)、百(100)、千(1000), 后续单位根据 `numeralsType` 进行调整, 仅在 `type` 为 `'custom'` 时有效
+ *
+ * `integerUnit` 自定义整数部分的单位字符, 类型为 `string`\
+ * 用于表示整数部分的单位, 如 `'元'`、`'块'` 等, 默认为空字符串 `''`\
+ * 该选项会在整数部分的数字后面添加指定的单位字符
+ *
+ * `dot` 小数点字符, 类型为 `string`\
+ * 用于表示小数点的字符, 默认为 `'点'`\
+ * 该选项会替换默认的小数点字符
+ *
+ * `fractionalUnits` 小数部分的单位字符数组, 类型为 `ArrayLike<string>`\
+ * 用于表示小数部分每一位的单位, 如 `['角', '分', '厘']` 等, 默认为空数组 `[]`\
+ * 该选项会在小数部分的每一位数字后面添加对应的单位字符, 如果小数部分的位数超过了该数组的长度, 则超出部分不添加单位字符
+ * @returns 返回一个汉语表达的数字
+ * @example
+ * ```js
+ * chinaNumerals(2025) // 二千零二十五
+ * chinaNumerals(2025, { type: 'upper' }) // 贰仟零贰拾伍
+ * chinaNumerals(1002003, { type: 'lower' }) // 一百万二千〇三
+ * ```
+ * @version 0.3.7
+ */
+declare function chinaNumerals(num: string | number, options?: {
+    type?: 'normal' | 'lower' | 'upper' | 'custom';
+    numeralsType?: 'normal' | 'minio' | 'mega';
+    customNumerals?: ArrayLike<string>;
+    customUnits?: ArrayLike<string>;
+    integerUnit?: string;
+    dot?: string;
+    fractionalUnits?: ArrayLike<string>;
+}): string;
+
 /**
  * 将一个数字限制在指定范围内
  * @param num 初始值
@@ -2569,5 +2623,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
 export type { BaseMargeType, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };

package/lib/index.mjs

@@ -422,23 +422,6 @@ function defer(asyncFunction, options) {
     });
 }
 
-function clamp(num, min, max, options) {
-    var _a, _b;
-    if (isNaN(min))
-        throw new Error('Invalid min parameter');
-    if (isNaN(max))
-        throw new Error('Invalid max parameter');
-    if (max < min) {
-        [min, max] = [max, min];
-    }
-    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-    if (isNaN(num))
-        return defaultMin;
-    return num < min ? defaultMin : num > max ? defaultMax : num;
-}
-
 function decimalNotation(num) {
     const n = isNumber(num) ? num : Number(num);
     if (!isFinite(n))
@@ -465,6 +448,138 @@ function decimalNotation(num) {
     }
 }
 
+function chinaNumerals(num, options) {
+    var _a, _b, _c;
+    const str = decimalNotation(num);
+    if (/NaN|Inf/.test(str))
+        return str;
+    const type = (options || {}).type || 'normal';
+    const numeralsType = (options || {}).numeralsType || 'normal';
+    const customNumerals = (options || {}).customNumerals;
+    const customUnits = Array.from((options || {}).customUnits || (type === 'upper' ? '拾佰仟万亿兆京垓秭穰沟涧正载' : '十百千万亿兆京垓秭穰沟涧正载'));
+    customUnits.unshift('');
+    if (type === 'custom' && (!customNumerals || customNumerals.length !== 10)) {
+        throw new Error('Invalid customNumerals: customNumerals must be provided and its length must be 10.');
+    }
+    const numberChar = Array.from(type === 'normal'
+        ? '零一二三四五六七八九'
+        : type === 'lower'
+            ? '〇一二三四五六七八九'
+            : type === 'upper'
+                ? '零壹贰叁肆伍陆柒捌玖'
+                : customNumerals);
+    const zeroChar = numberChar[0];
+    const zeroRegex = new RegExp(`${zeroChar}+`, 'g');
+    const trailingZeroRegex = new RegExp(`${zeroChar}$`);
+    const [integer, fractional] = str.split('.');
+    let integerPart = '';
+    if (numeralsType === 'minio') {
+        const chunks = chunk(Array.from(integer).reverse(), customUnits.length - 1);
+        const parts = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const subChunk = chunks[i].reverse();
+            const chars = subChunk
+                .map((digit, index) => {
+                const num = Number(digit);
+                const unitIndex = subChunk.length - 1 - index;
+                if (num === 0)
+                    return numberChar[num];
+                else
+                    return numberChar[num] + customUnits[unitIndex];
+            })
+                .filter((part) => part !== '');
+            if (chars.length > 0) {
+                const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                const unitIndex = i * (customUnits.length - 1);
+                parts.unshift(stringified + (unitIndex > 0 ? customUnits[unitIndex] : ''));
+            }
+        }
+        const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+        integerPart = result === '' ? numberChar[0] : result;
+    }
+    else {
+        const chunks = chunk(Array.from(integer).reverse(), 4);
+        const parts = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const subChunk = chunks[i].reverse();
+            const chars = subChunk
+                .map((digit, index) => {
+                const num = Number(digit);
+                const unitIndex = subChunk.length - 1 - index;
+                if (num === 0)
+                    return numberChar[num];
+                else
+                    return numberChar[num] + customUnits[unitIndex];
+            })
+                .filter((part) => part !== '');
+            if (chars.length > 0) {
+                const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                let unitStr = '';
+                if (numeralsType === 'normal') {
+                    unitStr = getNormalUnits(customUnits.slice(4), i);
+                }
+                else if (numeralsType === 'mega') {
+                    unitStr = getMegaUnits(customUnits.slice(4), i);
+                }
+                if (stringified !== '')
+                    parts.unshift(stringified + unitStr);
+            }
+        }
+        const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+        integerPart = result === '' ? numberChar[0] : result;
+    }
+    return fractional
+        ? integerPart +
+            ((_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '') +
+            ((_b = options === null || options === void 0 ? void 0 : options.dot) !== null && _b !== void 0 ? _b : '点') +
+            fractional
+                .split('')
+                .map((d, i) => { var _a, _b; return numberChar[Number(d)] + ((_b = (_a = options === null || options === void 0 ? void 0 : options.fractionalUnits) === null || _a === void 0 ? void 0 : _a[i]) !== null && _b !== void 0 ? _b : ''); })
+                .join('')
+        : integerPart + ((_c = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _c !== void 0 ? _c : '');
+}
+function getNormalUnits(units, index) {
+    if (index === 0)
+        return '';
+    if (index <= units.length)
+        return units[index - 1];
+    const majorCount = Math.floor(index / units.length);
+    const minorIndex = index % units.length;
+    return (minorIndex > 0 ? units[minorIndex - 1] : '') + units[units.length - 1].repeat(majorCount);
+}
+function getMegaUnits(units, index) {
+    if (index === 0)
+        return '';
+    if (index === 1)
+        return units[0];
+    const combinations = 2 ** (units.length - 1);
+    const majorCount = Math.floor(index / combinations);
+    let minorIndex = index % combinations;
+    let result = '';
+    for (let i = 0; i < units.length; i++) {
+        if ((minorIndex & (1 << i)) !== 0)
+            result += units[i];
+    }
+    return result + units[units.length - 1].repeat(majorCount);
+}
+
+function clamp(num, min, max, options) {
+    var _a, _b;
+    if (isNaN(min))
+        throw new Error('Invalid min parameter');
+    if (isNaN(max))
+        throw new Error('Invalid max parameter');
+    if (max < min) {
+        [min, max] = [max, min];
+    }
+    const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+    const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+    const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+    if (isNaN(num))
+        return defaultMin;
+    return num < min ? defaultMin : num > max ? defaultMax : num;
+}
+
 function isOdd(num) {
     return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
@@ -2635,4 +2750,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
+export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };

package/lib/index.umd.js

@@ -428,23 +428,6 @@ See the Mulan PSL v2 for more details.
       });
   }
 
-  function clamp(num, min, max, options) {
-      var _a, _b;
-      if (isNaN(min))
-          throw new Error('Invalid min parameter');
-      if (isNaN(max))
-          throw new Error('Invalid max parameter');
-      if (max < min) {
-          [min, max] = [max, min];
-      }
-      const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
-      const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
-      const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
-      if (isNaN(num))
-          return defaultMin;
-      return num < min ? defaultMin : num > max ? defaultMax : num;
-  }
-
   function decimalNotation(num) {
       const n = isNumber(num) ? num : Number(num);
       if (!isFinite(n))
@@ -471,6 +454,138 @@ See the Mulan PSL v2 for more details.
       }
   }
 
+  function chinaNumerals(num, options) {
+      var _a, _b, _c;
+      const str = decimalNotation(num);
+      if (/NaN|Inf/.test(str))
+          return str;
+      const type = (options || {}).type || 'normal';
+      const numeralsType = (options || {}).numeralsType || 'normal';
+      const customNumerals = (options || {}).customNumerals;
+      const customUnits = Array.from((options || {}).customUnits || (type === 'upper' ? '拾佰仟万亿兆京垓秭穰沟涧正载' : '十百千万亿兆京垓秭穰沟涧正载'));
+      customUnits.unshift('');
+      if (type === 'custom' && (!customNumerals || customNumerals.length !== 10)) {
+          throw new Error('Invalid customNumerals: customNumerals must be provided and its length must be 10.');
+      }
+      const numberChar = Array.from(type === 'normal'
+          ? '零一二三四五六七八九'
+          : type === 'lower'
+              ? '〇一二三四五六七八九'
+              : type === 'upper'
+                  ? '零壹贰叁肆伍陆柒捌玖'
+                  : customNumerals);
+      const zeroChar = numberChar[0];
+      const zeroRegex = new RegExp(`${zeroChar}+`, 'g');
+      const trailingZeroRegex = new RegExp(`${zeroChar}$`);
+      const [integer, fractional] = str.split('.');
+      let integerPart = '';
+      if (numeralsType === 'minio') {
+          const chunks = chunk(Array.from(integer).reverse(), customUnits.length - 1);
+          const parts = [];
+          for (let i = 0; i < chunks.length; i++) {
+              const subChunk = chunks[i].reverse();
+              const chars = subChunk
+                  .map((digit, index) => {
+                  const num = Number(digit);
+                  const unitIndex = subChunk.length - 1 - index;
+                  if (num === 0)
+                      return numberChar[num];
+                  else
+                      return numberChar[num] + customUnits[unitIndex];
+              })
+                  .filter((part) => part !== '');
+              if (chars.length > 0) {
+                  const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                  const unitIndex = i * (customUnits.length - 1);
+                  parts.unshift(stringified + (unitIndex > 0 ? customUnits[unitIndex] : ''));
+              }
+          }
+          const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+          integerPart = result === '' ? numberChar[0] : result;
+      }
+      else {
+          const chunks = chunk(Array.from(integer).reverse(), 4);
+          const parts = [];
+          for (let i = 0; i < chunks.length; i++) {
+              const subChunk = chunks[i].reverse();
+              const chars = subChunk
+                  .map((digit, index) => {
+                  const num = Number(digit);
+                  const unitIndex = subChunk.length - 1 - index;
+                  if (num === 0)
+                      return numberChar[num];
+                  else
+                      return numberChar[num] + customUnits[unitIndex];
+              })
+                  .filter((part) => part !== '');
+              if (chars.length > 0) {
+                  const stringified = chars.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+                  let unitStr = '';
+                  if (numeralsType === 'normal') {
+                      unitStr = getNormalUnits(customUnits.slice(4), i);
+                  }
+                  else if (numeralsType === 'mega') {
+                      unitStr = getMegaUnits(customUnits.slice(4), i);
+                  }
+                  if (stringified !== '')
+                      parts.unshift(stringified + unitStr);
+              }
+          }
+          const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
+          integerPart = result === '' ? numberChar[0] : result;
+      }
+      return fractional
+          ? integerPart +
+              ((_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '') +
+              ((_b = options === null || options === void 0 ? void 0 : options.dot) !== null && _b !== void 0 ? _b : '点') +
+              fractional
+                  .split('')
+                  .map((d, i) => { var _a, _b; return numberChar[Number(d)] + ((_b = (_a = options === null || options === void 0 ? void 0 : options.fractionalUnits) === null || _a === void 0 ? void 0 : _a[i]) !== null && _b !== void 0 ? _b : ''); })
+                  .join('')
+          : integerPart + ((_c = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _c !== void 0 ? _c : '');
+  }
+  function getNormalUnits(units, index) {
+      if (index === 0)
+          return '';
+      if (index <= units.length)
+          return units[index - 1];
+      const majorCount = Math.floor(index / units.length);
+      const minorIndex = index % units.length;
+      return (minorIndex > 0 ? units[minorIndex - 1] : '') + units[units.length - 1].repeat(majorCount);
+  }
+  function getMegaUnits(units, index) {
+      if (index === 0)
+          return '';
+      if (index === 1)
+          return units[0];
+      const combinations = 2 ** (units.length - 1);
+      const majorCount = Math.floor(index / combinations);
+      let minorIndex = index % combinations;
+      let result = '';
+      for (let i = 0; i < units.length; i++) {
+          if ((minorIndex & (1 << i)) !== 0)
+              result += units[i];
+      }
+      return result + units[units.length - 1].repeat(majorCount);
+  }
+
+  function clamp(num, min, max, options) {
+      var _a, _b;
+      if (isNaN(min))
+          throw new Error('Invalid min parameter');
+      if (isNaN(max))
+          throw new Error('Invalid max parameter');
+      if (max < min) {
+          [min, max] = [max, min];
+      }
+      const { default: def, defaultMin: _dMin, defaultMax: _dMax } = options || {};
+      const defaultMin = (_a = _dMin !== null && _dMin !== void 0 ? _dMin : def) !== null && _a !== void 0 ? _a : min;
+      const defaultMax = (_b = _dMax !== null && _dMax !== void 0 ? _dMax : def) !== null && _b !== void 0 ? _b : max;
+      if (isNaN(num))
+          return defaultMin;
+      return num < min ? defaultMin : num > max ? defaultMax : num;
+  }
+
   function isOdd(num) {
       return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
   }
@@ -2656,6 +2771,7 @@ See the Mulan PSL v2 for more details.
   exports.casePascal = casePascal;
   exports.caseSnake = caseSnake;
   exports.castArray = castArray;
+  exports.chinaNumerals = chinaNumerals;
   exports.chunk = chunk;
   exports.clamp = clamp;
   exports.compose = compose;

package/package.json

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