ut2 1.15.0 → 1.17.0

package/types/omitBy.d.ts

@@ -6,7 +6,7 @@ import { ObjectPredicate, WithNullable } from './internals/types';
  *
  * @alias module:Object.omitBy
  * @since 1.0.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/orderBy.d.ts

@@ -16,7 +16,7 @@ interface OrderBy {
  * @function
  * @alias module:Collection.orderBy
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/sort | sort}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/sort sort}
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol | Array} [iteratees] 排序的迭代函数。
  * @param {'asc' | 'desc' | Array} [orders] 迭代函数的排序顺序。

package/types/partition.d.ts

@@ -12,8 +12,8 @@ interface Partition {
  *
  * @alias module:Collection.partition
  * @since 1.0.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy | Truthy}
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy | Falsy}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy Falsy}
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol | Array} [predicate=identity] 每次迭代调用的断言函数。默认 `identity`。
  * @returns {Array} 分组后的数组。

package/types/pascalCase.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:String.pascalCase
  * @since 1.8.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/pathPairs.d.ts

@@ -0,0 +1,30 @@
+import { TPath } from './internals/types';
+/**
+ * 将对象转为属性路径/值对的数组。与 [`fromPathPairs`](#.fromPathPairs) 相反。
+ *
+ * @alias module:Object.pathPairs
+ * @since 1.16.0
+ * @param {Object|Array} object 对象或数组。
+ * @returns {Array} 属性路径/值对的数组。
+ * @example
+ * pathPairs({ date: { start: '2024-10-10', end: '2024-12-31' } });
+ * // [
+ * //   [['date', 'start'], '2024-10-10'],
+ * //   [['date', 'end'], '2024-12-31']
+ * // ]
+ *
+ * pathPairs({ date: ['2024-10-10', '2024-12-31'] });
+ * // [
+ * //   [['date', 0], '2024-10-10'],
+ * //   [['date', 1], '2024-12-31']
+ * // ]
+ *
+ * pathPairs([{ date: '2024-10-10' }, { date: '2024-12-31' }]);
+ * // [
+ * //   [[0, 'date'], '2024-10-10'],
+ * //   [[1, 'date'], '2024-12-31']
+ * // ]
+ *
+ */
+declare function pathPairs(object: Record<string, any> | any[]): [TPath[], any][];
+export default pathPairs;

package/types/pickBy.d.ts

@@ -6,7 +6,7 @@ import { ObjectPredicate, WithNullable } from './internals/types';
  *
  * @alias module:Object.pickBy
  * @since 1.0.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} obj 来源对象。
  * @param {Function} [predicate] 调用每一个属性的函数，返回 `Truthy` 表示要提取该属性，否则不提取。
  * @returns {Object} 新对象。

package/types/round.d.ts

@@ -5,7 +5,7 @@
  *
  * @alias module:Math.round
  * @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/set.d.ts

@@ -0,0 +1,24 @@
+import { Many, TPath } from './internals/types';
+type TCustomizer = (objValue: any, key: TPath, nested: any) => any;
+/**
+ * 设置对象属性路径值。
+ *
+ * @alias module:Object.set
+ * @since 1.16.0
+ * @param {Object | Array} object 对象或数组。
+ * @param {string | number | symbol | Array} path 属性路径字符串或数组。
+ * @param {*} value 要设置的值。
+ * @param {Function} [customizer] 自定义指定值。
+ * @returns `object`。
+ * @example
+ * const obj = {};
+ *
+ * set(obj, 'a.b', 1);
+ * console.log(obj); // { a: { b: 1 } }
+ *
+ * set(obj, ['x', '0', 'y'], 2);
+ * console.log(obj); // { a: { b: 1 }, x: [{ y: 2 }] }
+ *
+ */
+declare function set<T extends object>(object: T, path: Many<TPath>, value: any, customizer?: TCustomizer): T;
+export default set;

package/types/snakeCase.d.ts

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

package/types/toLength.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:Util.toLength
  * @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}
  * @param {*} value 要转换的值。
  * @returns {number} 转换后的整数。
  * @example

package/types/toPath.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 将值转为属性路径数组。
+ *
+ * @alias module:Util.toPath
+ * @since 1.16.0
+ * @param {*} value 要转换的值。
+ * @param {Object} [object] 用于查询键的对象，可选。
+ * @returns {Array} 一个新的属性路径数组。
+ * @example
+ * toPath('a.b.c'); // ['a', 'b', 'c']
+ *
+ * toPath('a[0].b.c'); // ['a', '0', 'b', 'c']
+ *
+ * toPath(['a', 'b', 'c']); // ['a', 'b', 'c']
+ */
+declare function toPath(value: any, object?: object): (string | symbol)[];
+export default toPath;

package/types/unset.d.ts

@@ -0,0 +1,20 @@
+import { Many, TPath } from './internals/types';
+/**
+ * 删除对象路径的属性。
+ *
+ * @alias module:Object.unset
+ * @since 1.16.0
+ * @param {*} object 要修改的对象。
+ * @param {string | number | symbol | Array} path 属性路径字符串或数组。
+ * @returns {boolean} 如果删除成功返回`true`，否则返回`false`。
+ * @example
+ * const obj = { a: [{ b: { c: 1 } }] };
+ *
+ * unset(obj, 'a[0].b.c'); // true
+ * console.log(obj); // { a: [{ b: {} }] }
+ *
+ * unset(obj, ['a', '0', 'b', 'c']); // true
+ * console.log(obj); // { a: [{ b: {} }] }
+ */
+declare function unset(object: any, path: Many<TPath>): boolean;
+export default unset;

package/types/words.d.ts

@@ -3,7 +3,7 @@
  *
  * @alias module:String.words
  * @since 1.0.0
- * @see {@link https://zh.wikipedia.org/wiki/ASCII | ASCII}
+ * @see {@link https://zh.wikipedia.org/wiki/ASCII ASCII}
  * @param {string} string 要拆分的字符串。
  * @param {RegExp | string} [pattern=/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g] 匹配模式。默认 `/[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g`。
  * @returns {string[]} 拆分后的数组。