foreslash 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## Version 0.3.4 - 2025-11-
+
+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

@@ -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 = '';
@@ -2489,6 +2489,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 +2520,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 +2659,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;

package/lib/index.d.ts

@@ -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 的部分才使用上划线区分
@@ -2245,6 +2245,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 +2301,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 +2459,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, 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

@@ -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 = '';
@@ -2487,6 +2487,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 +2518,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 +2568,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, withResolvers };

package/lib/index.umd.js

@@ -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 = '';
@@ -2493,6 +2493,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 +2524,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 +2663,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;

package/package.json

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