foreslash 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Change Log
 
+## 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
+
+- Feat 🥥 Functions added: `omit` `pick`
+- Other fixes and improvements
+
+不稳定版本
+
+- 功能 🥥 添加函数: `omit` `pick`
+- 其他修复与优化
+
 ## Version 0.3.3 - 2025-11-05
 
 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) {
@@ -749,7 +749,7 @@ function scientificNotation(num, options) {
         return str;
     const type = (options || {}).type || 'unicode';
     const _precision = (options || {}).precision;
-    const precision = isNumber(_precision) ? clamp(_precision !== null && _precision !== void 0 ? _precision : 2, 0, Infinity) : null;
+    const precision = isNumber(_precision) ? clamp(_precision, 0, Infinity) : null;
     const round = (options || {}).round || 'round';
     let [integer, fractional] = str.split('.');
     let sign = '';
@@ -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]/);
@@ -2489,6 +2498,27 @@ function not(value) {
     return !Boolean(value);
 }
 
+function omit(obj, keys) {
+    const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+    const ownKeys = Reflect.ownKeys(obj);
+    if (isFunction(keys)) {
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (!keys(obj[key], key, obj))
+                res[key] = obj[key];
+        }
+    }
+    else {
+        const keysSet = new Set((isArray(keys) ? keys : [keys]).map((k) => (isNumber(k) ? String(k) : k)));
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (!keysSet.has(key))
+                res[key] = obj[key];
+        }
+    }
+    return res;
+}
+
 function pass(value) {
     return value;
 }
@@ -2499,6 +2529,31 @@ function passWith(fn) {
     });
 }
 
+function pick(obj, keys) {
+    const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+    const ownKeys = Reflect.ownKeys(obj);
+    if (isFunction(keys)) {
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (keys(obj[key], key, obj))
+                res[key] = obj[key];
+        }
+    }
+    else if (isArray(keys)) {
+        const keysSet = new Set(ownKeys);
+        for (let i = 0; i < keys.length; i++) {
+            const key = keys[i];
+            if (keysSet.has(isNumber(key) ? String(key) : key))
+                res[key] = obj[key];
+        }
+    }
+    else if (isString(keys) || isNumber(keys) || isSymbol(keys)) {
+        if (ownKeys.includes(isNumber(keys) ? String(keys) : keys))
+            res[keys] = obj[keys];
+    }
+    return res;
+}
+
 function pipe(...pipeFunc) {
     if (pipeFunc.length === 0) {
         throw new Error('Invalid pipeFunc parameter: pipeFunc is empty');
@@ -2613,10 +2668,12 @@ exports.lerp = lerp;
 exports.memo = memo;
 exports.noop = noop;
 exports.not = not;
+exports.omit = omit;
 exports.parallel = parallel;
 exports.pascalCase = pascalCase;
 exports.pass = pass;
 exports.passWith = passWith;
+exports.pick = pick;
 exports.pipe = pipe;
 exports.randomBase32String = randomBase32String;
 exports.randomChoice = randomChoice;
@@ -2646,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;
 
 /**
  * 用线性插值法求取一个中间值
@@ -1095,7 +1095,7 @@ declare function lerp(val1: number[][], val2: number[][], t: number): number[][]
  *   - `'unicode'` 使用 Unicode 表示 `'I̅V̅XC'`
  *   - `'js'` 适合用于 JavaScript 代码字符串 `'I\\u0305V\\u0305XC'`
  *   - `'html'` 适合用于 HTML 展示的字符串 `'I̅V̅XC'`
- *   - `'json'` 一个 JSON 字符串, 具体数值是下标^1000 `["XC", "IV"]`
+ *   - `'json'` 一个 JSON 字符串, 具体数值是下标^1000 `'["XC", "IV"]'`
  *
  * `thousand` 千分位类型, 默认为 `normal`
  *   - `'normal'` 习惯用法, 超过 3999 的部分才使用上划线区分
@@ -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;
 
 /**
  * 将输入的字符串处理成小驼峰格式
@@ -2245,6 +2258,34 @@ declare const noop: (...args: any[]) => void;
  */
 declare function not(value: unknown): boolean;
 
+type KeyOf<T extends object> = object extends T ? keyof any : keyof T;
+type ValueOf<T extends object> = object extends T ? unknown : T[keyof T];
+type PickPredicate<T extends object> = (value: ValueOf<T>, key: KeyOf<T>, obj: T) => any;
+type OmitPredicate<T extends object> = (value: ValueOf<T>, key: KeyOf<T>, obj: T) => any;
+
+/**
+ * 给定一个对象和对象中键的列表, 返回一个**排除**给定键的新对象(是传入对象的浅拷贝)\
+ * 如果你希望深拷贝一个对象, 请使用 `deepClone` 或 `fastClone`
+ * @param obj 需要处理的对象
+ * @param keys 需要**排除**的键, 可以是一个数组、字符串或谓词函数
+ * @returns 传入对象的浅拷贝, 与传入对象不同的是新对象**排除了**指定的键
+ * @example
+ * ```ts
+ * omit({ a: 1, b: 2, c: '' }, ['a', 'c']) // { b: 2 }
+ * omit({ a: 1, b: 2, c: '' }, 'b') // { a: 1, c: '' }
+ * // 谓词函数
+ * omit({ a: 1, b: 2, c: '' }, (value, key) => value === 2 || key === 'c') // { a: 1 }
+ * // 需要注意的是传入谓词函数时可能会有类型不匹配的问题
+ * // Typescript 无法得知最终过滤的结果, 而是认为过滤结果与原类型一致
+ * const obj = omit({ a: 1, b: 2 }, (value, key) => value === 2) // { a: 1 }
+ * type typeofObj = typeof obj // { a: number; b: number } <- Typescript 没有推导出正确结果
+ * ```
+ * @version 0.3.4
+ */
+declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+declare function omit<T extends object, K extends keyof T>(obj: T, keys: OmitPredicate<T>): T;
+declare function omit<T extends object, K extends keyof T>(obj: T, key: K): Omit<T, K>;
+
 /**
  * 不做任何操作，返回第一个参数，一般用于函数式编程
  * @param value 任意值
@@ -2273,6 +2314,29 @@ declare function pass(): undefined;
  */
 declare function passWith<T>(fn: (arg: T) => any): typeof pass;
 
+/**
+ * 给定一个对象和对象中键的列表, 返回一个**只包含**给定键的新对象(是传入对象的浅拷贝)\
+ * 如果你希望深拷贝一个对象, 请使用 `deepClone` 或 `fastClone`
+ * @param obj 需要处理的对象
+ * @param keys 需要**取出**的键, 可以是一个数组、字符串或谓词函数
+ * @returns 传入对象的浅拷贝, 与传入对象不同的是新对象仅包含指定的键
+ * @example
+ * ```ts
+ * pick({ a: 1, b: 2, c: '' }, ['a', 'c']) // { a: 1, c: '' }
+ * pick({ a: 1, b: 2, c: '' }, 'b') // { b: 2 }
+ * // 谓词函数
+ * pick({ a: 1, b: 2, c: '' }, (value, key) => value === 2 || key === 'c') // { b: 2, c: '' }
+ * // 需要注意的是传入谓词函数时可能会有类型不匹配的问题
+ * // Typescript 无法得知最终过滤的结果, 而是认为过滤结果与原类型一致
+ * const obj = pick({ a: 1, b: 2 }, (value, key) => value === 2) // { b: 2 }
+ * type typeofObj = typeof obj // { a: number; b: number } <- Typescript 没有推导出正确结果
+ * ```
+ * @version 0.3.4
+ */
+declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+declare function pick<T extends object, K extends keyof T>(obj: T, keys: PickPredicate<T>): T;
+declare function pick<T extends object, K extends keyof T>(obj: T, key: K): Pick<T, K>;
+
 // pipe
 type PipeFuncList1<PipeArgs extends any[], PipeResult> = [(...args: PipeArgs) => PipeResult]
 type PipeFuncList2<PipeArgs extends any[], PipeResult, Mid1 = any> = [
@@ -2408,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, 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 { $$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) {
@@ -747,7 +747,7 @@ function scientificNotation(num, options) {
         return str;
     const type = (options || {}).type || 'unicode';
     const _precision = (options || {}).precision;
-    const precision = isNumber(_precision) ? clamp(_precision !== null && _precision !== void 0 ? _precision : 2, 0, Infinity) : null;
+    const precision = isNumber(_precision) ? clamp(_precision, 0, Infinity) : null;
     const round = (options || {}).round || 'round';
     let [integer, fractional] = str.split('.');
     let sign = '';
@@ -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]/);
@@ -2487,6 +2496,27 @@ function not(value) {
     return !Boolean(value);
 }
 
+function omit(obj, keys) {
+    const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+    const ownKeys = Reflect.ownKeys(obj);
+    if (isFunction(keys)) {
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (!keys(obj[key], key, obj))
+                res[key] = obj[key];
+        }
+    }
+    else {
+        const keysSet = new Set((isArray(keys) ? keys : [keys]).map((k) => (isNumber(k) ? String(k) : k)));
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (!keysSet.has(key))
+                res[key] = obj[key];
+        }
+    }
+    return res;
+}
+
 function pass(value) {
     return value;
 }
@@ -2497,6 +2527,31 @@ function passWith(fn) {
     });
 }
 
+function pick(obj, keys) {
+    const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+    const ownKeys = Reflect.ownKeys(obj);
+    if (isFunction(keys)) {
+        for (let i = 0; i < ownKeys.length; i++) {
+            const key = ownKeys[i];
+            if (keys(obj[key], key, obj))
+                res[key] = obj[key];
+        }
+    }
+    else if (isArray(keys)) {
+        const keysSet = new Set(ownKeys);
+        for (let i = 0; i < keys.length; i++) {
+            const key = keys[i];
+            if (keysSet.has(isNumber(key) ? String(key) : key))
+                res[key] = obj[key];
+        }
+    }
+    else if (isString(keys) || isNumber(keys) || isSymbol(keys)) {
+        if (ownKeys.includes(isNumber(keys) ? String(keys) : keys))
+            res[keys] = obj[keys];
+    }
+    return res;
+}
+
 function pipe(...pipeFunc) {
     if (pipeFunc.length === 0) {
         throw new Error('Invalid pipeFunc parameter: pipeFunc is empty');
@@ -2522,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, 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 { $$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) {
@@ -753,7 +753,7 @@ See the Mulan PSL v2 for more details.
           return str;
       const type = (options || {}).type || 'unicode';
       const _precision = (options || {}).precision;
-      const precision = isNumber(_precision) ? clamp(_precision !== null && _precision !== void 0 ? _precision : 2, 0, Infinity) : null;
+      const precision = isNumber(_precision) ? clamp(_precision, 0, Infinity) : null;
       const round = (options || {}).round || 'round';
       let [integer, fractional] = str.split('.');
       let sign = '';
@@ -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]/);
@@ -2493,6 +2502,27 @@ See the Mulan PSL v2 for more details.
       return !Boolean(value);
   }
 
+  function omit(obj, keys) {
+      const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+      const ownKeys = Reflect.ownKeys(obj);
+      if (isFunction(keys)) {
+          for (let i = 0; i < ownKeys.length; i++) {
+              const key = ownKeys[i];
+              if (!keys(obj[key], key, obj))
+                  res[key] = obj[key];
+          }
+      }
+      else {
+          const keysSet = new Set((isArray(keys) ? keys : [keys]).map((k) => (isNumber(k) ? String(k) : k)));
+          for (let i = 0; i < ownKeys.length; i++) {
+              const key = ownKeys[i];
+              if (!keysSet.has(key))
+                  res[key] = obj[key];
+          }
+      }
+      return res;
+  }
+
   function pass(value) {
       return value;
   }
@@ -2503,6 +2533,31 @@ See the Mulan PSL v2 for more details.
       });
   }
 
+  function pick(obj, keys) {
+      const res = (Object.getPrototypeOf(obj) ? {} : Object.create(null));
+      const ownKeys = Reflect.ownKeys(obj);
+      if (isFunction(keys)) {
+          for (let i = 0; i < ownKeys.length; i++) {
+              const key = ownKeys[i];
+              if (keys(obj[key], key, obj))
+                  res[key] = obj[key];
+          }
+      }
+      else if (isArray(keys)) {
+          const keysSet = new Set(ownKeys);
+          for (let i = 0; i < keys.length; i++) {
+              const key = keys[i];
+              if (keysSet.has(isNumber(key) ? String(key) : key))
+                  res[key] = obj[key];
+          }
+      }
+      else if (isString(keys) || isNumber(keys) || isSymbol(keys)) {
+          if (ownKeys.includes(isNumber(keys) ? String(keys) : keys))
+              res[keys] = obj[keys];
+      }
+      return res;
+  }
+
   function pipe(...pipeFunc) {
       if (pipeFunc.length === 0) {
           throw new Error('Invalid pipeFunc parameter: pipeFunc is empty');
@@ -2617,10 +2672,12 @@ See the Mulan PSL v2 for more details.
   exports.memo = memo;
   exports.noop = noop;
   exports.not = not;
+  exports.omit = omit;
   exports.parallel = parallel;
   exports.pascalCase = pascalCase;
   exports.pass = pass;
   exports.passWith = passWith;
+  exports.pick = pick;
   exports.pipe = pipe;
   exports.randomBase32String = randomBase32String;
   exports.randomChoice = randomChoice;
@@ -2650,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.3",
+  "version": "0.3.5",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",