ut2 1.15.0 → 1.17.0

package/lib/pathPairs.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var tslib = require('tslib');
+var forEach = require('./forEach.js');
+var isObjectLike = require('./isObjectLike.js');
+
+function basePathPairs(object, parentPath) {
+    if (parentPath === void 0) { parentPath = []; }
+    var result = [];
+    if (isObjectLike(object)) {
+        forEach(object, function (v, k) {
+            var currentPath = parentPath.concat([k]);
+            if (isObjectLike(v)) {
+                result.push.apply(result, tslib.__spreadArray([], tslib.__read(basePathPairs(v, currentPath)), false));
+            }
+            else {
+                result.push([currentPath, v]);
+            }
+        });
+    }
+    return result;
+}
+function pathPairs(object) {
+    return basePathPairs(object);
+}
+
+module.exports = pathPairs;

package/lib/set.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var isIndex = require('./internals/isIndex.js');
+var native = require('./internals/native.js');
+var isObject = require('./isObject.js');
+var toPath = require('./toPath.js');
+
+function set(object, path, value, customizer) {
+    if (!isObject(object)) {
+        return object;
+    }
+    var paths = toPath(path, object);
+    var length = paths.length;
+    var lastIndex = length - 1;
+    var index = -1;
+    var nested = object;
+    while (++index < length) {
+        var key = paths[index];
+        if (index === lastIndex) {
+            nested[key] = value;
+        }
+        else {
+            var objValue = nested[key];
+            var newValue = customizer ? customizer(objValue, key, nested) : native.nativeUndefined;
+            if (!isObject(newValue)) {
+                newValue = isObject(objValue) ? objValue : isIndex(paths[index + 1]) ? [] : {};
+            }
+            nested[key] = newValue;
+            nested = nested[key];
+        }
+    }
+    return object;
+}
+
+module.exports = set;

package/lib/toPath.js

@@ -0,0 +1,22 @@
+'use strict';
+
+var stringToPath = require('./internals/stringToPath.js');
+var isArray = require('./isArray.js');
+var isObject = require('./isObject.js');
+var isSymbol = require('./isSymbol.js');
+var toString = require('./toString.js');
+
+function toKey(value) {
+    return isSymbol(value) ? value : toString(value);
+}
+function toPath(value, object) {
+    if (isArray(value)) {
+        return value.map(toKey);
+    }
+    if (isSymbol(value) || (typeof value === 'string' && isObject(object) && value in object)) {
+        return [value];
+    }
+    return stringToPath(toString(value));
+}
+
+module.exports = toPath;

package/lib/unset.js

@@ -0,0 +1,17 @@
+'use strict';
+
+var get = require('./get.js');
+var isNil = require('./isNil.js');
+var nth = require('./nth.js');
+var toPath = require('./toPath.js');
+
+function unset(object, path) {
+    if (isNil(object)) {
+        return true;
+    }
+    var paths = toPath(path, object);
+    var parent = paths.length < 2 ? object : get(object, paths.slice(0, -1));
+    return isNil(parent) ? true : delete parent[nth(paths, -1)];
+}
+
+module.exports = unset;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ut2",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "author": "caijf",
   "license": "MIT",
   "main": "lib/index.js",
@@ -13,16 +13,14 @@
     "test:coverage": "jest --coverage",
     "test:coverage:local": "cross-env COVERAGE_LOCAL=1 jest --coverage --detectOpenHandles && open ./coverage/lcov-report/index.html",
     "benchmark": "node benchmark/node.js",
-    "build": "npm run build:module && npm run build:umd && npm run build:types",
-    "build:module": "rm -rf es && rm -rf lib && rollup -c rollup.module.config.mjs",
-    "build:umd": "rm -rf dist && rollup -c rollup.umd.config.mjs",
+    "build": "rm -rf es lib dist && rollup -c && npm run build:types",
     "build:types": "rm -rf types && tsc -p tsconfig.build.json -d --outDir types --emitDeclarationOnly",
     "build:doc": "npm run doc",
     "doc": "rm -rf docs && rm -rf docs-src && tsc -p tsconfig.build.json -t esnext --outDir docs-src && jsdoc -c conf.json && rm -rf docs-src",
     "doc:open": "open ./docs/index.html",
     "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
     "lint:fix": "npm run lint:js -- --fix",
-    "prettier": "prettier --write **/*",
+    "prettier": "prettier -w **/*",
     "commit": "cz",
     "prepublishOnly": "npm test && npm run build",
     "tsc": "tsc --noEmit",
@@ -61,41 +59,40 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@commitlint/cli": "^19.3.0",
-    "@commitlint/config-conventional": "^19.2.2",
-    "@commitlint/cz-commitlint": "^19.2.0",
-    "@rollup/plugin-commonjs": "^25.0.8",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-replace": "^5.0.7",
+    "@commitlint/cli": "^19.8.0",
+    "@commitlint/config-conventional": "^19.8.0",
+    "@commitlint/cz-commitlint": "^19.8.0",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-replace": "^6.0.2",
     "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^11.1.6",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.14.9",
-    "@typescript-eslint/eslint-plugin": "^7.14.1",
-    "@typescript-eslint/parser": "^7.14.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.17.24",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
     "benchmark": "^2.1.4",
-    "commitizen": "^4.3.0",
+    "commitizen": "^4.3.1",
     "cross-env": "^7.0.3",
-    "dayjs": "^1.11.11",
+    "dayjs": "^1.11.13",
     "docdash": "^2.0.2",
-    "eslint": "^8.57.0",
-    "husky": "^9.0.11",
-    "inquirer": "^9.3.2",
+    "eslint": "^8.57.1",
+    "husky": "^9.1.7",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "jsdoc": "^4.0.3",
-    "lint-staged": "^15.2.7",
+    "jsdoc": "^4.0.4",
+    "lint-staged": "^15.5.0",
     "lodash": "^4.17.21",
-    "prettier": "^3.3.2",
-    "rollup": "^4.18.0",
-    "ts-jest": "^29.1.5",
-    "typescript": "^5.5.2",
-    "underscore": "^1.13.6"
+    "prettier": "^3.5.3",
+    "rollup": "^4.35.0",
+    "ts-jest": "^29.2.6",
+    "typescript": "^5.8.2",
+    "underscore": "^1.13.7"
   },
   "engines": {
     "node": ">=10"
   },
   "dependencies": {
-    "tslib": "^2.8.0"
+    "tslib": "^2.8.1"
   }
 }

package/types/camelCase.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:String.camelCase
  * @since 1.0.0
- * @see {@link https://en.wikipedia.org/wiki/Camel_case | Camel_case}
+ * @see {@link https://en.wikipedia.org/wiki/Camel_case Camel_case}
  * @param {string} string 要转换的字符串。
  * @param {RegExp | string} [pattern] 拆分词组的匹配模式。
  * @returns {string} 驼峰写法的字符串。

package/types/ceil.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Math.ceil
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/round#小数舍入 | 小数舍入}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/round#小数舍入 小数舍入}
  * @param {number} number 要向上舍入的值。
  * @param {number} [precision=0] 向上舍入的精度。默认 `0`。
  * @returns {number} 向上舍入的值。

package/types/compact.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Array.compact
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy | Falsy}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy Falsy}
  * @param {Array} array 待处理的数组。
  * @returns {Array} 过滤掉假值的新数组。
  * @example

package/types/eq.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Util.eq
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness | JavaScript 中的相等性判断}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness JavaScript 中的相等性判断}
  * @param {*} value 要比较的值。
  * @param {*} other 另一个要比较的值。
  * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`。默认 `false`。

package/types/escape.d.ts

@@ -9,7 +9,7 @@
  *
  * @alias module:String.escape
  * @since 1.0.0
- * @see {@link https://mathiasbynens.be/notes/ambiguous-ampersands | ambiguous-ampersands}
+ * @see {@link https://mathiasbynens.be/notes/ambiguous-ampersands ambiguous-ampersands}
  * @param {string} string 要转义的字符串。
  * @returns {string} 转义后的字符串。
  * @example

package/types/escapeRegExp.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:String.escapeRegExp
  * @since 1.0.0
- * @see {@link https://tc39.es/ecma262/multipage/text-processing.html#sec-patterns | syntax characters}
+ * @see {@link https://tc39.es/ecma262/multipage/text-processing.html#sec-patterns syntax characters}
  * @param {string} string 要转义的字符串。
  * @returns {string} 转义后的字符串。
  * @example

package/types/floor.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Math.floor
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/round#小数舍入 | 小数舍入}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/round#小数舍入 小数舍入}
  * @param {number} number 要向下舍入的值。
  * @param {number} [precision=0] 向下舍入的精度。默认 `0`。
  * @returns {number} 向下舍入的值。

package/types/fromPathPairs.d.ts

@@ -0,0 +1,42 @@
+import set from './set';
+/**
+ * 将属性路径/值对的数组转为对象。与 [`pathPairs`](#.pathPairs) 相反。
+ *
+ * 如果属性路径为有效索引数字（数字或字符串）且没有值时，将创建数组，否则创建对象。例如：
+ *
+ * ```typescript
+ * fromPathPairs([[[0], 42], [["foo"], "baz"]]);
+ * // [42, foo: 'baz']
+ *
+ * // 调整顺序后
+ * fromPathPairs([[["foo"], "baz"], [[0], 42]]);
+ * // { foo: 'baz', '0': 42 }
+ * ```
+ *
+ * @alias module:Object.fromPathPairs
+ * @since 1.16.0
+ * @param {Array} value 属性路径/值对的数组。
+ * @returns {Object | Array} 转换后的对象或数组。
+ * @param {Function} [customizer] 自定义指定值。
+ * @example
+ * fromPathPairs([
+ *   [['date', 'start'], '2024-10-10'],
+ *   [['date', 'end'], '2024-12-31']
+ * ]);
+ * // { date: { start: '2024-10-10', end: '2024-12-31' } }
+ *
+ * fromPathPairs([
+ *   [['date', 0], '2024-10-10'],
+ *   [['date', 1], '2024-12-31']
+ * ]);
+ * // { date: ['2024-10-10', '2024-12-31'] }
+ *
+ * fromPathPairs([
+ *   [[0, 'date'], '2024-10-10'],
+ *   [[1, 'date'], '2024-12-31']
+ * ]);
+ * // [{ date: '2024-10-10' }, { date: '2024-12-31' }]
+ *
+ */
+declare function fromPathPairs(value: any[], customizer?: Parameters<typeof set>[3]): any;
+export default fromPathPairs;

package/types/get.d.ts

@@ -0,0 +1,21 @@
+import { Many, TPath } from './internals/types';
+/**
+ * 获取对象路径的值。
+ *
+ * @alias module:Object.get
+ * @since 1.16.0
+ * @param {*} object 要查询的对象。
+ * @param {string | number | symbol | Array} path 属性路径字符串或数组。
+ * @param {*} [defaultValue] 替代返回 `undefined` 的默认值。
+ * @returns {*} 属性值。
+ * @example
+ * const obj = { a: [{ b: { c: 1 } }] };
+ *
+ * get(obj, 'a[0].b.c'); // 1
+ *
+ * get(obj, ['a', '0', 'b', 'c']); // 1
+ *
+ * get(obj, 'a.b.c', 'default'); // 'default'
+ */
+declare function get<TDefault = unknown>(object: any, key: Many<TPath>, defaultValue?: TDefault): TDefault | undefined;
+export default get;

package/types/index.d.ts

@@ -48,6 +48,7 @@ export { default as before } from './before';
 export { default as curry } from './curry';
 export { default as debounce } from './debounce';
 export { default as delay } from './delay';
+export { default as memoize } from './memoize';
 export { default as negate } from './negate';
 export { default as once } from './once';
 export { default as partial } from './partial';
@@ -128,6 +129,8 @@ export { default as randomInt } from './randomInt';
 export { default as allKeys } from './allKeys';
 export { default as allKeysIn } from './allKeysIn';
 export { default as findKey } from './findKey';
+export { default as fromPathPairs } from './fromPathPairs';
+export { default as get } from './get';
 export { default as invert } from './invert';
 export { default as keys } from './keys';
 export { default as keysIn } from './keysIn';
@@ -137,6 +140,9 @@ export { default as omit } from './omit';
 export { default as omitBy } from './omitBy';
 export { default as pick } from './pick';
 export { default as pickBy } from './pickBy';
+export { default as pathPairs } from './pathPairs';
+export { default as set } from './set';
+export { default as unset } from './unset';
 /**
  * 字符串
  *
@@ -185,6 +191,7 @@ export { default as toFinite } from './toFinite';
 export { default as toInteger } from './toInteger';
 export { default as toLength } from './toLength';
 export { default as toNumber } from './toNumber';
+export { default as toPath } from './toPath';
 export { default as toSafeInteger } from './toSafeInteger';
 export { default as toString } from './toString';
 export { default as tryit } from './tryit';

package/types/internals/isIndex.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 检查值是否为有效的数组索引值。
+ *
+ * @private
+ * @param value 要检查的值。
+ * @returns {boolean} 值是否为有效的数组索引值。
+ * @example
+ * isIndex(0); // true
+ * isIndex('0'); // true
+ * isIndex('42'); // true
+ *
+ * isIndex('a'); // false
+ * isIndex(0.1); // false
+ * isIndex(Infinity); // false
+ */
+declare function isIndex(value: any): boolean;
+export default isIndex;

package/types/internals/native.d.ts

@@ -31,41 +31,41 @@ export declare const selfExisted: false | (Window & typeof globalThis);
 /**
  * @summary 最大安全整数。
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER | MAX_SAFE_INTEGER}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER MAX_SAFE_INTEGER}
  */
 export declare const MAX_SAFE_INTEGER: number;
 /**
  * @summary 最小安全整数。
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MIN_SAFE_INTEGER | MIN_SAFE_INTEGER}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MIN_SAFE_INTEGER MIN_SAFE_INTEGER}
  */
 export declare const MIN_SAFE_INTEGER: number;
 /**
  * @summary 最大数组长度 `Math.pow(2,32) - 1`。
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/length | length}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/length length}
  */
 export declare const MAX_ARRAY_LENGTH = 4294967295;
-export declare const bigIntTag = "[object BigInt]";
-export declare const numberTag = "[object Number]";
-export declare const booleanTag = "[object Boolean]";
-export declare const stringTag = "[object String]";
-export declare const dateTag = "[object Date]";
-export declare const regExpTag = "[object RegExp]";
-export declare const symbolTag = "[object Symbol]";
-export declare const errorTag = "[object Error]";
-export declare const arrayBufferTag = "[object ArrayBuffer]";
-export declare const argumentsTag = "[object Arguments]";
-export declare const arrayTag = "[object Array]";
+export declare const bigIntTag: string;
+export declare const numberTag: string;
+export declare const booleanTag: string;
+export declare const stringTag: string;
+export declare const dateTag: string;
+export declare const regExpTag: string;
+export declare const symbolTag: string;
+export declare const errorTag: string;
+export declare const arrayBufferTag: string;
+export declare const argumentsTag: string;
+export declare const arrayTag: string;
 export declare const functionTags: string[];
-export declare const weakSetTag = "[object WeakSet]";
-export declare const blobTag = "[object Blob]";
-export declare const fileTag = "[object File]";
-export declare const domExceptionTag = "[object DOMException]";
-export declare const objectTag = "[object Object]";
-export declare const dataViewTag = "[object DataView]";
-export declare const mapTag = "[object Map]";
-export declare const promiseTag = "[object Promise]";
-export declare const setTag = "[object Set]";
-export declare const weakMapTag = "[object WeakMap]";
-export declare const windowTag = "[object Window]";
+export declare const weakSetTag: string;
+export declare const blobTag: string;
+export declare const fileTag: string;
+export declare const domExceptionTag: string;
+export declare const objectTag: string;
+export declare const dataViewTag: string;
+export declare const mapTag: string;
+export declare const promiseTag: string;
+export declare const setTag: string;
+export declare const weakMapTag: string;
+export declare const windowTag: string;

package/types/internals/root.d.ts

@@ -7,7 +7,7 @@
  * 3. Web Workers 中等同于 `self`
  *
  * @since 1.10.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/globalThis | globalThis}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/globalThis globalThis}
  */
 declare const root: typeof globalThis;
 export default root;

package/types/internals/stringToPath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 将字符串路径转为数组路径
+ *
+ * @private
+ * @param {string} value 字符串路径
+ * @returns {string[]} 路径数组
+ */
+declare function stringToPath(value: string): string[];
+export default stringToPath;

package/types/internals/types.d.ts

@@ -3,6 +3,7 @@ export type SyncFn<P extends any[], R> = (...args: P) => R;
 export type AsyncFn<P extends any[], R> = (...args: P) => Promise<R>;
 export type SingleSyncFn<R> = () => R;
 export type SingleAsyncFn<R> = () => Promise<R>;
+export type TPath = string | symbol | number;
 /**
  * 工具辅助类型
  */

package/types/invert.d.ts

@@ -4,7 +4,7 @@ import { ObjectPredicate, PropertyName, WithNullable } from './internals/types';
  *
  * @alias module:Object.invert
  * @since 1.8.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy | Truthy}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
  * @param {Object} object 来源对象。
  * @param {Function} [predicate] 调用每一个属性的函数，返回 `Truthy` 表示要反转，否则不反转。
  * @returns {Object} 新对象。

package/types/isBlob.d.ts

@@ -5,8 +5,8 @@
  *
  * @alias module:Language.isBlob
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Blob | Blob}
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File | File}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Blob Blob}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File File}
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Blob` 对象，返回 `true`，否则返回 `false`。
  * @example

package/types/isFile.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Language.isFile
  * @since 1.11.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File | File}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/File File}
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `File` 对象，返回 `true`，否则返回 `false`。
  * @example

package/types/isLength.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:Language.isLength
  * @since 1.0.0
- * @see {@link https://tc39.es/ecma262/#sec-tolength | ToLength}
+ * @see {@link https://tc39.es/ecma262/#sec-tolength ToLength}
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为有效的类数组长度，返回 `true`，否则返回 `false`。
  * @example

package/types/isObject.d.ts

@@ -4,7 +4,7 @@ import { FunctionAny } from './internals/types';
  *
  * @alias module:Language.isObject
  * @since 1.0.0
- * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types | language type}
+ * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types language type}
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为对象，返回 `true`，否则返回 `false`。
  * @example

package/types/isTypedArray.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:Language.isTypedArray
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays | Typed_arrays}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays Typed_arrays}
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为类型化数组，返回 `true`，否则返回 `false`。
  * @example

package/types/kebabCase.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:String.kebabCase
  * @since 1.0.0
- * @see {@link https://en.wikipedia.org/wiki/Letter_case#Special_case_styles | kebab case}
+ * @see {@link https://en.wikipedia.org/wiki/Letter_case#Special_case_styles kebab case}
  * @param {string} string 要转换的字符串。
  * @param {RegExp | string} [pattern] 拆分词组的匹配模式。
  * @returns {string} 转换后的字符串。

package/types/memoize.d.ts

@@ -0,0 +1,50 @@
+type EqualFn<TFunc extends (...args: any[]) => any> = (newArgs: Parameters<TFunc>, lastArgs: Parameters<TFunc>) => boolean;
+/**
+ * 创建一个缓存 `func` 结果的函数。
+ *
+ * 如果上下文和参数一致，直接返回缓存结果，否则执行函数并缓存。
+ *
+ * 返回的函数含有一个 `clear` 方法，用于清除缓存。
+ *
+ * @alias module:Function.memoize
+ * @since 1.17.0
+ * @param {Function} func 要缓存结果的函数。
+ * @param {Object} [options] 配置项。
+ * @param {Function} [options.isEqual] 自定义比较参数方法。默认函数遍历参数并使用 `===` 进行比较。
+ * @param {number} [options.max] 最大缓存数量，`0`表示不限制。默认`0`。
+ * @returns 缓存 `func` 结果的函数。
+ * @example
+ * const memoizedValues = memoize(Object.values);
+ * const object = { a: 1, b: 2 };
+ * const other = { a: 3, b: 4 };
+ *
+ * memoizedValues(object); // [1, 2]
+ * memoizedValues(other); // [3, 4]
+ *
+ * object.a = 2;
+ * memoizedValues(object); // [1, 2]
+ *
+ * // 清空缓存
+ * memoizedValues.clear();
+ *
+ * memoizedValues(object); // [2, 2]
+ *
+ * // 限制缓存数量。如限制缓存数量为1时，效果同 memoize-one 。
+ * const memoizedOneValues = memoize(Object.values, { max: 1 });
+ *
+ * // 自定义比较函数。如深比较。
+ * import { isEqual } from 'ut2'
+ * const deepMemoizedValues = memoize(Object.values, { isEqual });
+ * const result1 = deepMemoizedValues({ a: 1 });
+ * const result2 = deepMemoizedValues({ a: 1 });
+ * console.log(result1 === result2); // true
+ *
+ */
+declare function memoize<TFunc extends (...args: any[]) => any>(func: TFunc, options?: {
+    isEqual?: EqualFn<TFunc>;
+    max?: number;
+}): {
+    (this: any, ...newArgs: Parameters<TFunc>): any;
+    clear(): void;
+};
+export default memoize;

package/types/merge.d.ts

@@ -7,7 +7,7 @@ type Customizer = (objValue: any, srcValue: any, key: string | symbol, object: a
  *
  * 如果不需要合并数组，第三个参数传入 `merge.NOT_MERGE_ARRAYS` 。
  *
- * 如果需要合并继承的属性，第四个参数传入 {@link https://caijf.github.io/ut2/module-Object.html#.allKeysIn allKeysIn} 方法， `merge(object, source, undefined, allKeysIn)`。
+ * 如果需要合并继承的属性，第四个参数传入 {@link https://caijf.github.io/ut2/module-Object.html#.allKeys allKeys} 方法， `merge(object, source, undefined, allKeys)`。
  *
  * @alias module:Object.merge
  * @since 1.0.0

package/types/mergeObject.d.ts

@@ -21,7 +21,7 @@ interface MergeObject {
  * @alias module:Object.mergeObject
  * @since 1.15.0
  * @param {Object | Array} object 目标对象。
- * @param {...object} args 展开的来源对象。
+ * @param {...object} args 来源对象。
  * @returns 目标对象。
  * @example
  *

package/types/move.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:Array.move
  * @since 1.10.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | splice}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/splice splice}
  * @param {Array} array 要处理的数组。
  * @param {number} from 要移动的元素索引。
  * @param {number} to 要移动目标位置的元素索引。