ut2 1.7.2 → 1.8.0

package/types/index.d.ts

@@ -44,6 +44,7 @@ export { default as some } from './some';
  */
 export { default as after } from './after';
 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 negate } from './negate';
@@ -61,6 +62,7 @@ export { default as isArray } from './isArray';
 export { default as isArrayBuffer } from './isArrayBuffer';
 export { default as isArrayLike } from './isArrayLike';
 export { default as isArrayLikeObject } from './isArrayLikeObject';
+export { default as isBigInt } from './isBigInt';
 export { default as isBlob } from './isBlob';
 export { default as isBoolean } from './isBoolean';
 export { default as isBuffer } from './isBuffer';
@@ -122,6 +124,7 @@ export { default as randomInt } from './randomInt';
  */
 export { default as allKeys } from './allKeys';
 export { default as allKeysIn } from './allKeysIn';
+export { default as invert } from './invert';
 export { default as keys } from './keys';
 export { default as keysIn } from './keysIn';
 export { default as merge } from './merge';
@@ -142,6 +145,7 @@ export { default as escapeRegExp } from './escapeRegExp';
 export { default as kebabCase } from './kebabCase';
 export { default as lowerCase } from './lowerCase';
 export { default as lowerFirst } from './lowerFirst';
+export { default as pascalCase } from './pascalCase';
 export { default as snakeCase } from './snakeCase';
 export { default as unescape } from './unescape';
 export { default as upperCase } from './upperCase';

package/types/internals/helpers.d.ts

@@ -9,3 +9,4 @@ export declare const supportedArgumentsType: boolean;
 export declare const FUNC_ERROR_TEXT = "Expected a function";
 export declare function toSource(func: any): string;
 export declare const stubFlase: () => boolean;
+export declare const stubTrue: () => boolean;

package/types/internals/native.d.ts

@@ -49,6 +49,7 @@ export declare const MIN_SAFE_INTEGER: number;
  * @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]";

package/types/internals/types.d.ts

@@ -4,6 +4,8 @@ export type FunctionAny = (...args: any[]) => any;
  */
 export type Many<T> = T | T[];
 export type WithNullable<T> = T | null | undefined;
+export type PropertyName = string | number | symbol;
+export type ObjectPredicate<T extends object, K extends keyof T = keyof T> = (value: T[K], key: K) => boolean;
 /**
  * 迭代参数
  */

package/types/invert.d.ts

@@ -0,0 +1,19 @@
+import { ObjectPredicate, PropertyName, WithNullable } from './internals/types';
+/**
+ * 创建一个对象，该对象由 `object` 自身可枚举属性（不包含 `Symbol` 属性）和值反转组成。
+ *
+ * @static
+ * @alias module:Object.invert
+ * @since 1.8.0
+ * @param {Object} object 来源对象。
+ * @param {Function} [predicate] 调用每一个属性的函数，返回 `truthy` 表示要反转，否则不反转。
+ * @returns {Object} 新对象。
+ * @example
+ *
+ * invert({ a: 1, b: 2 }); // { 1: 'a', 2: 'b' }
+ *
+ * invert({ a: undefined, b: null }); // { undefined: 'a', null: 'b' }
+ *
+ */
+declare function invert<T extends object>(object: WithNullable<T>, predicate?: ObjectPredicate<T>): Record<PropertyName, any>;
+export default invert;

package/types/isBigInt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 检查值是否为 bigint 类型或对象。
+ *
+ * @static
+ * @alias module:Language.isBigInt
+ * @since 1.8.0
+ * @param {*} value 要检查的值。
+ * @returns {boolean} 如果值为 bigint 类型或对象，返回 `true` 否则返回 `false` 。
+ * @example
+ *
+ * isBigInt(0n); // true
+ *
+ * isBigInt(1n); // true
+ *
+ * isBigInt(BigInt(1)); // true
+ *
+ * isBigInt(Object(1n)); // true
+ *
+ * isBigInt(1); // false
+ */
+declare function isBigInt(value: any): value is bigint;
+export default isBigInt;

package/types/keys.d.ts

@@ -20,5 +20,5 @@
  * keys(new Foo); // ['a']
  *
  */
-declare function keys<T extends object>(object: T): string[];
+declare function keys(object?: any): string[];
 export default keys;

package/types/keysIn.d.ts

@@ -20,5 +20,5 @@
  * keysIn(new Foo); // ['a', 'c']
  *
  */
-declare function keysIn<T extends object>(object: T): string[];
+declare function keysIn(object?: any): string[];
 export default keysIn;

package/types/omit.d.ts

@@ -1,3 +1,8 @@
+import { PropertyName, WithNullable } from './internals/types';
+interface OmitFunction {
+    <T extends object, K extends keyof T>(object: WithNullable<T>, fields?: K | K[]): Omit<T, K>;
+    <T extends object, K extends PropertyName>(object: WithNullable<T>, fields?: K | K[]): Omit<T, K>;
+}
 /**
  * 创建一个对象，该对象由忽略属性之外的 `object` 自身和继承的可枚举属性组成。与 [`pick`](#.pick) 相反。
  *
@@ -21,5 +26,5 @@
  * omit(obj, ['name', 'age']); // {}
  *
  */
-declare function omit<T extends object, K extends keyof T>(object: T, fields?: K | K[]): Omit<T, K>;
+declare const omit: OmitFunction;
 export default omit;

package/types/omitBy.d.ts

@@ -1,3 +1,4 @@
+import { ObjectPredicate, WithNullable } from './internals/types';
 /**
  * 创建一个对象，该对象忽略 `predicate` （断言函数）判断不是真值的属性后，`object` 自身和继承的可枚举属性组成。与 [`pickBy`](#.pickBy) 相反。
  *
@@ -7,7 +8,7 @@
  * @alias module:Object.omitBy
  * @since 1.0.0
  * @param {Object} object 来源对象。
- * @param {Function} [predicate] 调用每一个属性的函数。
+ * @param {Function} [predicate] 调用每一个属性的函数，返回 `truthy` 表示要忽略该属性，否则不忽略。
  * @returns {Object} 新对象。
  * @example
  *
@@ -20,5 +21,5 @@
  * omitBy(obj, (value) => value); // {}
  *
  */
-declare function omitBy<T extends object>(object: T, predicate?: (value: any, key: any) => any): Partial<T>;
+declare function omitBy<T extends object>(object: WithNullable<T>, predicate?: ObjectPredicate<T>): Partial<T>;
 export default omitBy;

package/types/partial.d.ts

@@ -1,7 +1,7 @@
-interface PartialPlaceholder {
-    __ut2_partial__: number;
-}
-type Placeholder = PartialPlaceholder;
+declare const PLACEHOLDER: {
+    __ut2_partial_ph__: null;
+};
+type Placeholder = typeof PLACEHOLDER;
 type Function0<R> = () => R;
 type Function1<T1, R> = (t1: T1) => R;
 type Function2<T1, T2, R> = (t1: T1, t2: T2) => R;
@@ -39,7 +39,7 @@ interface Partial {
 /**
  * 创建一个函数。该函数调用 `func` ，并传入预设的 `args` 参数。
  *
- *  `partial._` 或 `partial.placeholder` 可用作部分参数的占位符。
+ *  `partial._` 或 `partial.placeholder` 可用作参数的占位符。
  *
  * @function
  * @alias module:Function.partial

package/types/pascalCase.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 转换字符串为帕斯卡写法。又名为大驼峰写法。
+ *
+ * @static
+ * @alias module:String.pascalCase
+ * @since 1.8.0
+ * @see {@link https://en.wikipedia.org/wiki/Camel_case | Camel_case}
+ * @param {string} string 要转换的字符串。
+ * @param {RegExp | string} [pattern] 拆分词组的匹配模式。
+ * @returns {string} 帕斯卡写法的字符串。
+ * @example
+ *
+ * pascalCase('foo bar'); // 'FooBar'
+ *
+ * pascalCase('foo-bar'); // 'FooBar'
+ *
+ * pascalCase('Foo Bar'); // 'FooBar'
+ *
+ * pascalCase('FOO BAR'); // 'FooBar'
+ *
+ * pascalCase('--FOO-BAR--'); // 'FooBar'
+ *
+ * pascalCase('__FOO_BAR__'); // 'FooBar'
+ *
+ */
+declare function pascalCase(string: string, pattern?: RegExp | string): string;
+export default pascalCase;

package/types/pick.d.ts

@@ -1,3 +1,8 @@
+import { PropertyName, WithNullable } from './internals/types';
+interface PickFunction {
+    <T extends object, K extends keyof T>(object: WithNullable<T>, fields?: K | K[]): Pick<T, K>;
+    <T extends object, K extends PropertyName>(object: WithNullable<T>, fields?: K | K[]): Record<PropertyName, any>;
+}
 /**
  * 创建一个从 `object` 选中的属性的对象。
  *
@@ -21,5 +26,5 @@
  * // 选取多个属性
  * pick(obj, ['name', 'age']); // { name: "jeff", age: 18 }
  */
-declare function pick<T extends object, K extends keyof T>(object: T, fields?: K | K[]): Pick<T, K>;
+declare const pick: PickFunction;
 export default pick;

package/types/pickBy.d.ts

@@ -1,3 +1,4 @@
+import { ObjectPredicate, WithNullable } from './internals/types';
 /**
  * 创建一个对象，该对象的属性从 `object` 中经 `predicate` （断言函数）判断为真值的属性。
  *
@@ -7,7 +8,7 @@
  * @alias module:Object.pickBy
  * @since 1.0.0
  * @param {Object} obj 来源对象。
- * @param {Function} [predicate] 调用每一个属性的函数。
+ * @param {Function} [predicate] 调用每一个属性的函数，返回 `truthy` 表示要提取该属性，否则不提取。
  * @returns {Object} 新对象。
  * @example
  *
@@ -20,5 +21,5 @@
  * pickBy(obj, (value) => value); // { name: "jeff", age: 18 }
  *
  */
-declare function pickBy<T extends object>(object: T, predicate?: (value: any, key: any) => any): Partial<T>;
+declare function pickBy<T extends object>(object: WithNullable<T>, predicate?: ObjectPredicate<T>): Partial<T>;
 export default pickBy;