foreslash 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Change Log
 
-## Version 0.3.4 - 2025-11-
+## Version 0.3.5 - 2025-11-30
+
+Unstable version
+
+- Feat 🥥 Functions added: `uuidV7`
+- Feat 🥥 Function change: `isOdd` and `isEven` now support BigInt
+- Fix 🥕 Document: Added version tags to several methods
+- Other fixes and improvements
+
+不稳定版本
+
+- 功能 🥥 添加函数: `uuidV7`
+- 功能 🥥 变更函数: `isOdd` 和 `isEven` 现在支持 BigInt
+- 修复 🥕 文档: 补充部分方法的版本标签
+- 其他修复与优化
+
+## Version 0.3.4 - 2025-11-17
 
 Unstable version
 

package/lib/index.cmn.cjs

@@ -468,10 +468,10 @@ function decimalNotation(num) {
 }
 
 function isOdd(num) {
-    return !!(num & 1);
+    return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 function isEven(num) {
-    return !(num & 1);
+    return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 
 function round(num, precision, type) {
@@ -1607,6 +1607,15 @@ function uuidV4() {
     return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
         `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
 }
+function uuidV7() {
+    const r = randomHexString(18);
+    let t = Date.now().toString(16);
+    if (t.length < 12)
+        t = '0'.repeat(12 - t.length) + t;
+    t = t.slice(t.length - 12, t.length);
+    return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+        `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+}
 
 const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
 const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -2694,4 +2703,5 @@ exports.ulid = ulid;
 exports.uncapitalize = uncapitalize;
 exports.uuidNil = uuidNil;
 exports.uuidV4 = uuidV4;
+exports.uuidV7 = uuidV7;
 exports.withResolvers = withResolvers;

package/lib/index.d.ts

@@ -1031,14 +1031,14 @@ declare function format(num: number | string, options?: {
  * @returns 如果是奇数则返回 true 否则返回 false
  * @version 0.3.2
  */
-declare function isOdd(num: number): boolean;
+declare function isOdd(num: number | bigint): boolean;
 /**
  * 检查一个数字是否为偶数
  * @param num 需要检查的数字
  * @returns 如果是偶数则返回 true 否则返回 false
  * @version 0.3.2
  */
-declare function isEven(num: number): boolean;
+declare function isEven(num: number | bigint): boolean;
 
 /**
  * 用线性插值法求取一个中间值
@@ -1456,6 +1456,7 @@ declare function randomBase32String(length: number, isCrockford?: boolean): stri
  * shuffle('abcdefg') // ['d', 'e', 'a', 'c', 'g', 'f', 'b']
  * shuffle([1, 2, 3, 4, 5, 6, 7, 8]) // [3, 2, 6, 5, 8, 1, 7, 4]
  * ```
+ * @version 0.1.1
  */
 declare function shuffle<T>(arr: ArrayLike<T> | Iterable<T>): Array<T>;
 
@@ -1474,20 +1475,32 @@ declare function shuffle<T>(arr: ArrayLike<T> | Iterable<T>): Array<T>;
  * ulid(true, 0) // 0000000000D64N3ZR75CXM1J83 同一时间戳单调递增
  * ulid(false, 0) // 0000000000Z3VJ5THVXV4ZE6CO 取消单调性
  * ```
+ * @version 0.1.2
  */
 declare function ulid(monotonic?: boolean, time?: number): string;
 
-/** 空 UUID [见标准第 4.1.7 节](https://www.ietf.org/rfc/rfc4122.txt) */
+/** 空 UUID [见标准第 5.9 节](https://www.rfc-editor.org/rfc/rfc9562.html#name-nil-uuid) */
 declare const uuidNil = "00000000-0000-0000-0000-000000000000";
 /**
- * 生成 [UUID V4](https://www.ietf.org/rfc/rfc4122.txt) 字符串（小写）
- * @returns 一个标准的 UUID V4 字符串
+ * 生成 [UUID V4](https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-4) 字符串（小写）
+ * @returns 一个 RFC 9562 标准的 UUID V4 字符串
  * @example
  * ```js
  * uuidV4() // "ea64fb4f-a0a2-4193-8374-d291a522d8b3"
  * ```
+ * @version 0.1.2
  */
 declare function uuidV4(): string;
+/**
+ * 生成 [UUID V7](https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-7) 字符串（小写）
+ * @returns 一个 RFC 9562 标准的 UUID V7 字符串
+ * @example
+ * ```js
+ * uuidV7() // "019aba02-45ad-703c-a17e-05f8d7ebe357"
+ * ```
+ * @version 0.3.4
+ */
+declare function uuidV7(): string;
 
 /**
  * 将输入的字符串处理成小驼峰格式
@@ -2459,5 +2472,5 @@ declare function throttle<T extends any[]>(fn: (...args: T) => any, delay: numbe
     reset: () => void;
 };
 
-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, 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, withResolvers };
+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, 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

@@ -466,10 +466,10 @@ function decimalNotation(num) {
 }
 
 function isOdd(num) {
-    return !!(num & 1);
+    return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 function isEven(num) {
-    return !(num & 1);
+    return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
 }
 
 function round(num, precision, type) {
@@ -1605,6 +1605,15 @@ function uuidV4() {
     return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
         `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
 }
+function uuidV7() {
+    const r = randomHexString(18);
+    let t = Date.now().toString(16);
+    if (t.length < 12)
+        t = '0'.repeat(12 - t.length) + t;
+    t = t.slice(t.length - 12, t.length);
+    return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+        `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+}
 
 const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
 const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -2568,4 +2577,4 @@ function throttle(fn, delay, options) {
     return _throttle(fn, delay, Object.assign({ trailing: false, leading: true }, options));
 }
 
-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, 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, withResolvers };
+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, 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

@@ -472,10 +472,10 @@ See the Mulan PSL v2 for more details.
   }
 
   function isOdd(num) {
-      return !!(num & 1);
+      return !!(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
   }
   function isEven(num) {
-      return !(num & 1);
+      return !(typeof num === 'bigint' ? num & BigInt(1) : num & 1);
   }
 
   function round(num, precision, type) {
@@ -1611,6 +1611,15 @@ See the Mulan PSL v2 for more details.
       return (`${r.slice(0, 8)}-${r.slice(8, 12)}-4${r.slice(12, 15)}-` +
           `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(15, 18)}-${r.slice(18)}`);
   }
+  function uuidV7() {
+      const r = randomHexString(18);
+      let t = Date.now().toString(16);
+      if (t.length < 12)
+          t = '0'.repeat(12 - t.length) + t;
+      t = t.slice(t.length - 12, t.length);
+      return (`${t.slice(0, 8)}-${t.slice(8, 12)}-7${r.slice(0, 3)}-` +
+          `${'89ab'[Math.floor(Math.random() * 4)]}${r.slice(3, 6)}-${r.slice(6)}`);
+  }
 
   const getDefaultVarCase = () => ({ code: '', upperCase: false, number: false });
   const isUpperCase = RegExp.prototype.test.bind(/[A-Z]/);
@@ -2698,6 +2707,7 @@ See the Mulan PSL v2 for more details.
   exports.uncapitalize = uncapitalize;
   exports.uuidNil = uuidNil;
   exports.uuidV4 = uuidV4;
+  exports.uuidV7 = uuidV7;
   exports.withResolvers = withResolvers;
 
 }));

package/package.json

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