foreslash 0.3.7 → 0.3.8

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # Change Log
 
+## Version 0.3.8 - 2026-01-25
+
+- Feat 🥥 Function(s) added: `constantCase`
+- Feat 🥥 Function(s) exposed: `transferNumberToSupUniCode`
+- Other fixes and improvements
+
+- 功能 🥥 添加函数: `constantCase`
+- 功能 🥥 公开函数: `transferNumberToSupUniCode`
+- 其他修复与优化
+
 ## Version 0.3.7 - 2026-01-24
 
 Add a method to convert numbers to Chinese numerals
 
-- Feat 🥥 Functions added: `chinaNumerals`
+- Feat 🥥 Function(s) added: `chinaNumerals`
 
 添加了将数字转换为中文的方法
 

package/lib/index.cmn.cjs

@@ -451,7 +451,7 @@ function decimalNotation(num) {
 }
 
 function chinaNumerals(num, options) {
-    var _a, _b, _c;
+    var _a, _b;
     const str = decimalNotation(num);
     if (/NaN|Inf/.test(str))
         return str;
@@ -530,15 +530,15 @@ function chinaNumerals(num, options) {
         const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
         integerPart = result === '' ? numberChar[0] : result;
     }
+    integerPart += (_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '';
     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 : '');
+        : integerPart;
 }
 function getNormalUnits(units, index) {
     if (index === 0)
@@ -913,13 +913,13 @@ function scientificNotation(num, options) {
             return `{"number":"${n}","exp":${exp}}`;
         case 'unicode':
         default:
-            return `${n}×10${transferNumberToUniCode(String(exp))}`;
+            return `${n}×10${transferNumberToSupUniCode(String(exp))}`;
     }
 }
-function transferNumberToUniCode(n) {
-    const strMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+const supMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+function transferNumberToSupUniCode(n) {
     return Array.from(n)
-        .map((s) => (strMap[s] ? strMap[s] : s))
+        .map((s) => (supMap[s] ? supMap[s] : s))
         .join('');
 }
 
@@ -1827,6 +1827,14 @@ function camelCase(str, options) {
         });
 }
 
+function constantCase(str, options) {
+    const { keepNumber = true } = options || {};
+    let tokens = _splitVar(str);
+    if (!keepNumber)
+        tokens = tokens.filter(({ number }) => !number);
+    return _caseConvert(tokens, '_', ({ code }) => code.toUpperCase());
+}
+
 function kebabCase(str, options) {
     const { keepLetterCase = false, keepNumber = true } = options || {};
     let tokens = _splitVar(str);
@@ -2771,6 +2779,7 @@ exports.chinaNumerals = chinaNumerals;
 exports.chunk = chunk;
 exports.clamp = clamp;
 exports.compose = compose;
+exports.constantCase = constantCase;
 exports.curry = _curryMore;
 exports.dataUrlToBlob = dataUrlToBlob;
 exports.debounce = debounce;
@@ -2878,6 +2887,7 @@ exports.snakeCase = snakeCase;
 exports.splitWords = splitWords;
 exports.throttle = throttle;
 exports.titleCase = titleCase;
+exports.transferNumberToSupUniCode = transferNumberToSupUniCode;
 exports.tryit = tryit;
 exports.ulid = ulid;
 exports.uncapitalize = uncapitalize;

package/lib/index.d.ts

@@ -1321,6 +1321,22 @@ declare function scientificNotation(num: string | number, options?: {
     precision?: number;
     round?: 'round' | 'banker' | 'floor' | 'ceil';
 }): string;
+/**
+ * 将数字字符串转换为上标 Unicode 字符串\
+ * 无法处理的字符将原样返回\
+ * 此方法在 0.3.3 版本就已存在, 但直到 0.3.8 版本才对外公开
+ * @param n 数字字符串(可以带加减号)
+ * @returns 上标 Unicode 字符串
+ * @example
+ * ```js
+ * transferNumberToSupUniCode("123") // "¹²³"
+ * transferNumberToSupUniCode("-45") // "⁻⁴⁵"
+ * transferNumberToSupUniCode("+67") // "⁺⁶⁷"
+ * transferNumberToSupUniCode("123 + 456") // "¹²³ ⁺ ⁴⁵⁶"
+ * ```
+ * @version 0.3.8
+ */
+declare function transferNumberToSupUniCode(n: ArrayLike<string>): string;
 
 /**
  * 根据文件名称判断是否匹配支持的文件类型，需要注意 `.C` 与 `.c` 的区别
@@ -1578,6 +1594,24 @@ declare function camelCase(str: string, options?: {
     keepNumber?: boolean;
 }): string;
 
+/**
+ * 将输入的字符串处理成常量格式(全大写下划线分割)
+ * @param str 想要转换的字符串
+ * @param options.keepNumber 是否保留数字, 默认保留
+ * @returns 转换为常量格式的字符串
+ * @example
+ * ```js
+ * // 默认情况 保留数字
+ * constantCase("getTestUuid1234") // "GET_TEST_UUID_1234"
+ * // 不保留数字
+ * constantCase("getTestUuid1234", { keepNumber: false }) // "GET_TEST_UUID"
+ * ```
+ * @version 0.3.8
+ */
+declare function constantCase(str: string, options?: {
+    keepNumber?: boolean;
+}): string;
+
 /**
  * 将输入的字符串处理成串行格式(短横线分割)
  * @param str 想要转换的字符串
@@ -2623,5 +2657,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, _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, constantCase, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };
 export type { BaseMargeType, CastArray, Chunked, CloneOptions, CustomCloner, IsNegative, IsPositive, IsZero, MergeOption, MergeStrategy, MergeStrategyFunction, MergeType, MergeTypeStrategy, Not, RangeOptions, SourceMergeType, Stringify, TargetMergeType, TypedArray };

package/lib/index.mjs

@@ -449,7 +449,7 @@ function decimalNotation(num) {
 }
 
 function chinaNumerals(num, options) {
-    var _a, _b, _c;
+    var _a, _b;
     const str = decimalNotation(num);
     if (/NaN|Inf/.test(str))
         return str;
@@ -528,15 +528,15 @@ function chinaNumerals(num, options) {
         const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
         integerPart = result === '' ? numberChar[0] : result;
     }
+    integerPart += (_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '';
     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 : '');
+        : integerPart;
 }
 function getNormalUnits(units, index) {
     if (index === 0)
@@ -911,13 +911,13 @@ function scientificNotation(num, options) {
             return `{"number":"${n}","exp":${exp}}`;
         case 'unicode':
         default:
-            return `${n}×10${transferNumberToUniCode(String(exp))}`;
+            return `${n}×10${transferNumberToSupUniCode(String(exp))}`;
     }
 }
-function transferNumberToUniCode(n) {
-    const strMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+const supMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+function transferNumberToSupUniCode(n) {
     return Array.from(n)
-        .map((s) => (strMap[s] ? strMap[s] : s))
+        .map((s) => (supMap[s] ? supMap[s] : s))
         .join('');
 }
 
@@ -1825,6 +1825,14 @@ function camelCase(str, options) {
         });
 }
 
+function constantCase(str, options) {
+    const { keepNumber = true } = options || {};
+    let tokens = _splitVar(str);
+    if (!keepNumber)
+        tokens = tokens.filter(({ number }) => !number);
+    return _caseConvert(tokens, '_', ({ code }) => code.toUpperCase());
+}
+
 function kebabCase(str, options) {
     const { keepLetterCase = false, keepNumber = true } = options || {};
     let tokens = _splitVar(str);
@@ -2750,4 +2758,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-export { $$Empty, _, acceptableFileName, acceptableFileType, base64ToBlob, blobToBase64, camelCase, capitalize, cartesianProduct, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, castArray, chinaNumerals, chunk, clamp, compose, _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, constantCase, _curryMore as curry, dataUrlToBlob, debounce, decimalNotation, decodeBase64, dedent, deepClone, deepMerge, defer, deprecate, encodeBase64, fastClone, format, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getInitP, getTag, indent, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBlob, isBoolean, isBuffer, isDataView, isDate, isEmpty, isEven, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isMergeEmptyPlaceholder, isNil, isNull, isNumber, isObject, isOdd, isPlaceholder, isPlainObject, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, lerp, memo, noop, not, omit, parallel, pascalCase, pass, passWith, pick, pipe, randomBase32String, randomChoice, randomDistribution, randomHexString, randomInt, randomIntFloor, randomString, range, remove, retry, romanNumerals, round, roundBank, roundBase, roundCeil, roundFloor, scientificNotation, shuffle, sleep, snakeCase, splitWords, throttle, titleCase, transferNumberToSupUniCode, tryit, ulid, uncapitalize, uuidNil, uuidV4, uuidV7, withResolvers };

package/lib/index.umd.js

@@ -455,7 +455,7 @@ See the Mulan PSL v2 for more details.
   }
 
   function chinaNumerals(num, options) {
-      var _a, _b, _c;
+      var _a, _b;
       const str = decimalNotation(num);
       if (/NaN|Inf/.test(str))
           return str;
@@ -534,15 +534,15 @@ See the Mulan PSL v2 for more details.
           const result = parts.join('').replace(zeroRegex, zeroChar).replace(trailingZeroRegex, '');
           integerPart = result === '' ? numberChar[0] : result;
       }
+      integerPart += (_a = options === null || options === void 0 ? void 0 : options.integerUnit) !== null && _a !== void 0 ? _a : '';
       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 : '');
+          : integerPart;
   }
   function getNormalUnits(units, index) {
       if (index === 0)
@@ -917,13 +917,13 @@ See the Mulan PSL v2 for more details.
               return `{"number":"${n}","exp":${exp}}`;
           case 'unicode':
           default:
-              return `${n}×10${transferNumberToUniCode(String(exp))}`;
+              return `${n}×10${transferNumberToSupUniCode(String(exp))}`;
       }
   }
-  function transferNumberToUniCode(n) {
-      const strMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+  const supMap = Object.assign(Object.assign({}, Array.from('⁰¹²³⁴⁵⁶⁷⁸⁹')), { '-': '⁻', '+': '⁺' });
+  function transferNumberToSupUniCode(n) {
       return Array.from(n)
-          .map((s) => (strMap[s] ? strMap[s] : s))
+          .map((s) => (supMap[s] ? supMap[s] : s))
           .join('');
   }
 
@@ -1831,6 +1831,14 @@ See the Mulan PSL v2 for more details.
           });
   }
 
+  function constantCase(str, options) {
+      const { keepNumber = true } = options || {};
+      let tokens = _splitVar(str);
+      if (!keepNumber)
+          tokens = tokens.filter(({ number }) => !number);
+      return _caseConvert(tokens, '_', ({ code }) => code.toUpperCase());
+  }
+
   function kebabCase(str, options) {
       const { keepLetterCase = false, keepNumber = true } = options || {};
       let tokens = _splitVar(str);
@@ -2775,6 +2783,7 @@ See the Mulan PSL v2 for more details.
   exports.chunk = chunk;
   exports.clamp = clamp;
   exports.compose = compose;
+  exports.constantCase = constantCase;
   exports.curry = _curryMore;
   exports.dataUrlToBlob = dataUrlToBlob;
   exports.debounce = debounce;
@@ -2882,6 +2891,7 @@ See the Mulan PSL v2 for more details.
   exports.splitWords = splitWords;
   exports.throttle = throttle;
   exports.titleCase = titleCase;
+  exports.transferNumberToSupUniCode = transferNumberToSupUniCode;
   exports.tryit = tryit;
   exports.ulid = ulid;
   exports.uncapitalize = uncapitalize;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",
@@ -35,8 +35,9 @@
   "scripts": {
     "dev": "rollup -c -w",
     "build": "rollup -c",
-    "test": "tsd --files /test/**/*.test-d.ts && jest --coverage",
-    "test:slow": "tsd --files /test/**/*.test-d.ts && jest --coverage --runInBand",
+    "tsd": "tsd --files /test/**/*.test-d.ts",
+    "test": "jest --coverage",
+    "test:slow": "jest --coverage --runInBand",
     "prepublishOnly": "jest --coverage && npm run build",
     "docs:dev": "rollup -c && vitepress dev docs",
     "docs:build": "rollup -c && vitepress build docs",