ut2 1.7.2 → 1.8.1

package/README.md

@@ -8,7 +8,7 @@
 
 **与其他工具库对比（[`lodash`]、[`underscore`]）**
 
-- 基于 ES2015+ 标准，无需原生支持的方法（`forEach`、`filter`、`Object.keys`、`Object.entries` ……）。
+- 大部分是基于 ES2015+ 标准实现的纯函数，没有过多的包装嵌套。
 - 使用 TypeScript 实现，提供类型定义。
 - 导出 `es`、`cjs`、`umd` 模块格式，支持不同开发环境使用。
 
@@ -91,6 +91,7 @@ const debounced = debounce(() => {
 - [Function](https://caijf.github.io/ut2/module-Function.html) 函数
   - [after](https://caijf.github.io/ut2/module-Function.html#.after) - 调用 `n` 或更多次之后触发。
   - [before](https://caijf.github.io/ut2/module-Function.html#.before) - 调用次数少于 `n` 次之前触发。
+  - [curry](https://caijf.github.io/ut2/module-Function.html#.curry) - 柯里化函数。
   - [debounce](https://caijf.github.io/ut2/module-Function.html#.debounce) - 防抖函数。
   - [delay](https://caijf.github.io/ut2/module-Function.html#.delay) - 延迟触发。
   - [negate](https://caijf.github.io/ut2/module-Function.html#.negate) - 否定断言。
@@ -103,6 +104,7 @@ const debounced = debounce(() => {
   - [isArrayBuffer](https://caijf.github.io/ut2/module-Language.html#.isArrayBuffer) - `ArrayBuffer` 对象。
   - [isArrayLike](https://caijf.github.io/ut2/module-Language.html#.isArrayLike) - 类数组。
   - [isArrayLikeObject](https://caijf.github.io/ut2/module-Language.html#.isArrayLikeObject) - 类数组对象。
+  - [isBigInt](https://caijf.github.io/ut2/module-Language.html#.isBigInt) - `bigint` 类型或对象。
   - [isBlob](https://caijf.github.io/ut2/module-Language.html#.isBlob) - `Blob` 对象。
   - [isBoolean](https://caijf.github.io/ut2/module-Language.html#.isBoolean) - 布尔类型或对象。
   - [isBuffer](https://caijf.github.io/ut2/module-Language.html#.isBuffer) - `Buffer` 对象。
@@ -149,6 +151,7 @@ const debounced = debounce(() => {
 - [Object](https://caijf.github.io/ut2/module-Object.html) 对象
   - [allKeys](https://caijf.github.io/ut2/module-Object.html#.allKeys) - 对象自身的可枚举属性（包含 `Symbol` 属性）。
   - [allKeysIn](https://caijf.github.io/ut2/module-Object.html#.allKeysIn) - 对象自身及继承的可枚举属性（包含 `Symbol` 属性）。
+  - [invert](https://caijf.github.io/ut2/module-Object.html#.invert) - 对象自身的可枚举属性（不包含 `Symbol` 属性）和值反转。
   - [keys](https://caijf.github.io/ut2/module-Object.html#.keys) - 对象自身的可枚举属性（不包含 `Symbol` 属性）。
   - [keysIn](https://caijf.github.io/ut2/module-Object.html#.keysIn) - 对象自身及继承的可枚举属性（不包含 `Symbol` 属性）。
   - [merge](https://caijf.github.io/ut2/module-Object.html#.merge) - 递归对象或数组进行合并。
@@ -164,7 +167,8 @@ const debounced = debounce(() => {
   - [kebabCase](https://caijf.github.io/ut2/module-String.html#.kebabCase) - 连接符分隔小写。
   - [lowerCase](https://caijf.github.io/ut2/module-String.html#.lowerCase) - 空格分隔小写。
   - [lowerFirst](https://caijf.github.io/ut2/module-String.html#.lowerFirst) - 首字母小写。
-  - [snakeCase](https://caijf.github.io/ut2/module-String.html#.snakeCase) - 下划线分隔小写
+  - [pascalCase](https://caijf.github.io/ut2/module-String.html#.pascalCase) - 帕斯卡小写。又名大驼峰。
+  - [snakeCase](https://caijf.github.io/ut2/module-String.html#.snakeCase) - 下划线分隔小写。
   - [unescape](https://caijf.github.io/ut2/module-String.html#.unescape) - 转义字符串中的 HTML 实体字符 `&` `<` `"` `'`。
   - [upperCase](https://caijf.github.io/ut2/module-String.html#.upperCase) - 空格分隔大写。
   - [upperFirst](https://caijf.github.io/ut2/module-String.html#.upperFirst) - 首字母大写。

package/dist/ut2.js

@@ -4,6 +4,9 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.ut2 = {}));
 })(this, (function (exports) { 'use strict';
 
+    var nativeUndefined = void 0;
+    var stringUndefined = 'undefined';
+    var stringObject = 'object';
     var objectProto = Object.prototype;
     var objectProtoToString = objectProto.toString;
     var objectProtoHasOwnProperty = objectProto.hasOwnProperty;
@@ -13,8 +16,8 @@
     var objectKeys = Object.keys;
     var functionProto = Function.prototype;
     var functionProtoToString = functionProto.toString;
-    var symbolExisted = typeof Symbol !== 'undefined';
-    var symbolProto = symbolExisted ? Symbol.prototype : undefined;
+    var symbolExisted = typeof Symbol !== stringUndefined;
+    var symbolProto = symbolExisted ? Symbol.prototype : nativeUndefined;
     var arrayProto = Array.prototype;
     var arrayProtoSlice = arrayProto.slice;
     var mathMin = Math.min;
@@ -26,12 +29,13 @@
     var numberIsFinite = Number.isFinite;
     var numberIsInteger = Number.isInteger;
     var numberIsSafeInteger = Number.isSafeInteger;
-    var globalThisExisted = typeof globalThis === 'object' && globalThis;
-    var globalExisted = typeof global === 'object' && global;
-    var selfExisted = typeof self === 'object' && self;
+    var globalThisExisted = typeof globalThis === stringObject && globalThis;
+    var globalExisted = typeof global === stringObject && global;
+    var selfExisted = typeof self === stringObject && self;
     var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
     var MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER || -9007199254740991;
     var MAX_ARRAY_LENGTH = 4294967295;
+    var bigIntTag = '[object BigInt]';
     var numberTag = '[object Number]';
     var booleanTag = '[object Boolean]';
     var stringTag = '[object String]';
@@ -224,7 +228,7 @@
     function nth(array, n) {
         if (n === void 0) { n = 0; }
         if (!isArrayLike(array)) {
-            return undefined;
+            return nativeUndefined;
         }
         n += n < 0 ? array.length : 0;
         return array[n];
@@ -459,7 +463,7 @@
         return value == null;
     }
 
-    var symbolToString = symbolProto ? symbolProto.toString : undefined;
+    var symbolToString = symbolProto ? symbolProto.toString : nativeUndefined;
     function baseToString(value) {
         if (typeof value === 'string') {
             return value;
@@ -521,8 +525,8 @@
 
     var orderBy = function (collection, iteratees, orders) {
         var result = [];
-        iteratees = (isArray(iteratees) ? iteratees : iteratees !== undefined ? [iteratees] : [identity]);
-        orders = (isArray(orders) ? orders : orders !== undefined ? [orders] : []);
+        iteratees = (isArray(iteratees) ? iteratees : iteratees !== nativeUndefined ? [iteratees] : [identity]);
+        orders = (isArray(orders) ? orders : orders !== nativeUndefined ? [orders] : []);
         var index = -1;
         forEach(collection, function (item) {
             var criteria = iteratees.map(function (iteratee) { return createIteratee(iteratee)(item); });
@@ -598,7 +602,7 @@
         return value == null || value !== value ? defaultValue : value;
     };
 
-    var VERSION = "1.7.2";
+    var VERSION = "1.8.1";
     var supportedArgumentsType = getTag((function () { return arguments; })()) === argumentsTag;
     var FUNC_ERROR_TEXT = 'Expected a function';
     function toSource(func) {
@@ -617,6 +621,7 @@
         return '';
     }
     var stubFlase = function () { return false; };
+    var stubTrue = function () { return true; };
 
     function after(n, func) {
         if (typeof func !== 'function') {
@@ -641,12 +646,42 @@
                 result = func.apply(this, arguments);
             }
             if (n <= 1) {
-                func = undefined;
+                func = nativeUndefined;
             }
             return result;
         };
     }
 
+    function isUndefined(value) {
+        return value === nativeUndefined;
+    }
+
+    var PLACEHOLDER$1 = {
+        __ut2_curry_ph__: null
+    };
+    var curry = function (func, arity) {
+        arity = isUndefined(arity) ? func.length : mathMax(toInteger(arity), 0);
+        function wrap() {
+            var args = arrayProtoSlice.call(arguments);
+            var context = this;
+            function inner() {
+                var argsInner = arrayProtoSlice.call(arguments);
+                for (var i = 0; i < args.length; i++) {
+                    args[i] = args[i] === PLACEHOLDER$1 && argsInner.length > 0 ? argsInner.shift() : args[i];
+                }
+                args = args.concat(argsInner);
+                var realArgsLength = args.filter(function (arg) { return arg !== PLACEHOLDER$1; }).length;
+                if (realArgsLength >= arity) {
+                    return func.apply(context, args);
+                }
+                return inner;
+            }
+            return inner();
+        }
+        return wrap;
+    };
+    curry.placeholder = curry._ = PLACEHOLDER$1;
+
     function baseDebounce(func, wait, immediate, __throttle__) {
         if (__throttle__ === void 0) { __throttle__ = false; }
         if (typeof func !== 'function') {
@@ -655,7 +690,7 @@
         var timer, lastCallTime, lastInvokeTime, lastArgs, lastThis, result;
         wait = defaultTo(toNumber(wait), 0);
         function shouldInvoke(time) {
-            if (lastCallTime === undefined) {
+            if (lastCallTime === nativeUndefined) {
                 return true;
             }
             var timeSinceLastCall = time - lastCallTime;
@@ -665,7 +700,7 @@
         function invokeFunc(time) {
             lastInvokeTime = time;
             result = func.apply(lastThis, lastArgs);
-            lastThis = lastArgs = undefined;
+            lastThis = lastArgs = nativeUndefined;
             return result;
         }
         function debounced() {
@@ -677,36 +712,36 @@
             lastArgs = args;
             var time = Date.now();
             var isInvoke = shouldInvoke(time);
-            var waitTime = !__throttle__ ? wait : !isInvoke && lastCallTime !== undefined && timer === undefined ? wait - (time - lastCallTime) : wait;
+            var waitTime = !__throttle__ ? wait : !isInvoke && lastCallTime !== nativeUndefined && timer === nativeUndefined ? wait - (time - lastCallTime) : wait;
             lastCallTime = time;
             if (isInvoke) {
-                if (immediate && timer === undefined) {
+                if (immediate && timer === nativeUndefined) {
                     return invokeFunc(time);
                 }
             }
-            if (timer !== undefined && !__throttle__) {
+            if (timer !== nativeUndefined && !__throttle__) {
                 clearTimeout(timer);
-                timer = undefined;
+                timer = nativeUndefined;
             }
-            if (timer === undefined) {
+            if (timer === nativeUndefined) {
                 timer = setTimeout(function () {
-                    timer = undefined;
+                    timer = nativeUndefined;
                     invokeFunc(Date.now());
                 }, waitTime);
             }
             return result;
         }
         function cancel() {
-            if (timer !== undefined) {
+            if (timer !== nativeUndefined) {
                 clearTimeout(timer);
-                timer = undefined;
+                timer = nativeUndefined;
             }
-            lastCallTime = timer = lastArgs = lastThis = undefined;
+            lastCallTime = timer = lastArgs = lastThis = nativeUndefined;
         }
         function flush() {
-            if (timer !== undefined) {
+            if (timer !== nativeUndefined) {
                 clearTimeout(timer);
-                timer = undefined;
+                timer = nativeUndefined;
                 if (lastArgs) {
                     return invokeFunc(Date.now());
                 }
@@ -714,7 +749,7 @@
             return result;
         }
         function pending() {
-            return timer !== undefined;
+            return timer !== nativeUndefined;
         }
         debounced.cancel = cancel;
         debounced.flush = flush;
@@ -762,7 +797,7 @@
     }
 
     var PLACEHOLDER = {
-        __ut2_partial__: 1
+        __ut2_partial_ph__: null
     };
     var partial = function (func) {
         var argsOrig = arrayProtoSlice.call(arguments, 1);
@@ -790,8 +825,8 @@
         return isObjectLike(value) && objectProtoHasOwnProperty.call(value, 'callee') && !objectProtoPropertyIsEnumerable.call(value, 'callee');
     }
 
-    var freeExports = typeof exports === 'object' && exports && !exports.nodeType && exports;
-    var freeModule = freeExports && typeof module === 'object' && module && !module.nodeType && module;
+    var freeExports = typeof exports === stringObject && exports && !exports.nodeType && exports;
+    var freeModule = freeExports && typeof module === stringObject && module && !module.nodeType && module;
     var nodeUtil = (function () {
         try {
             var types = freeModule && freeModule.require && freeModule.require('util').types;
@@ -813,7 +848,11 @@
         return nodeIsArrayBuffer ? nodeIsArrayBuffer(value) : getTag(value) === arrayBufferTag;
     }
 
-    var blobExisted = typeof Blob !== 'undefined';
+    function isBigInt(value) {
+        return typeof value === 'bigint' || getTag(value) === bigIntTag;
+    }
+
+    var blobExisted = typeof Blob !== stringUndefined;
     function isBlob(value) {
         if (blobExisted && value instanceof Blob) {
             return true;
@@ -835,11 +874,11 @@
         return false;
     }
 
-    var dataViewExisted = typeof DataView !== 'undefined';
-    var mapExisted = typeof Map !== 'undefined';
-    var promiseExisted = typeof Promise !== 'undefined';
-    var setExisted = typeof Set !== 'undefined';
-    var weakMapExisted = typeof WeakMap !== 'undefined';
+    var dataViewExisted = typeof DataView !== stringUndefined;
+    var mapExisted = typeof Map !== stringUndefined;
+    var promiseExisted = typeof Promise !== stringUndefined;
+    var setExisted = typeof Set !== stringUndefined;
+    var weakMapExisted = typeof WeakMap !== stringUndefined;
     var dataViewCtorString = toSource(DataView);
     var mapCtorString = toSource(Map);
     var promiseCtorString = toSource(Promise);
@@ -853,7 +892,7 @@
         (weakMapExisted && getTag(new WeakMap()) !== weakMapTag)) {
         getTagWithBugfix = function (value) {
             var result = getTag(value);
-            var Ctor = result === objectTag ? value.constructor : undefined;
+            var Ctor = result === objectTag ? value.constructor : nativeUndefined;
             var ctorString = Ctor ? toSource(Ctor) : '';
             if (ctorString) {
                 switch (ctorString) {
@@ -963,7 +1002,7 @@
         return false;
     }
 
-    var symbolValueOf = symbolProto ? symbolProto.valueOf : undefined;
+    var symbolValueOf = symbolProto ? symbolProto.valueOf : nativeUndefined;
     function mapToArray(map) {
         var result = [];
         map.forEach(function (value, key) {
@@ -1076,7 +1115,7 @@
             while (length--) {
                 if (hasCustomizer) {
                     var compared = customizer(value[length], other[length], length, value, other, valueStack, otherStack);
-                    if (compared !== undefined) {
+                    if (compared !== nativeUndefined) {
                         if (!compared) {
                             return false;
                         }
@@ -1099,7 +1138,7 @@
                 var key = keys[length];
                 if (hasCustomizer) {
                     var compared = customizer(value[key], other[key], key, value, other, valueStack, otherStack);
-                    if (compared !== undefined) {
+                    if (compared !== nativeUndefined) {
                         if (!compared) {
                             return false;
                         }
@@ -1133,7 +1172,7 @@
         if (strictCheck === void 0) { strictCheck = false; }
         if (typeof customizer === 'function') {
             var result = customizer(value, other);
-            if (result !== undefined) {
+            if (result !== nativeUndefined) {
                 return !!result;
             }
         }
@@ -1196,7 +1235,7 @@
                 }
                 if (hasCustomizer) {
                     var compared = customizer(object[key], source[key], key, object, source, objStack, srcStack);
-                    if (compared !== undefined) {
+                    if (compared !== nativeUndefined) {
                         if (!compared) {
                             return false;
                         }
@@ -1214,7 +1253,7 @@
         var result = isEqualDeep(object, source, function (objValue, srcValue, k, obj, src) {
             if (hasCustomizer) {
                 var compared = customizer(objValue, srcValue, k, obj, src, objStack, srcStack);
-                if (compared !== undefined) {
+                if (compared !== nativeUndefined) {
                     return compared;
                 }
             }
@@ -1228,11 +1267,11 @@
         if (strictCheck === void 0) { strictCheck = false; }
         if (typeof customizer === 'function') {
             var compared = customizer(object, source);
-            if (compared !== undefined) {
+            if (compared !== nativeUndefined) {
                 return !!compared;
             }
         }
-        return baseIsMatch(object, source, customizer, strictCheck, undefined, undefined);
+        return baseIsMatch(object, source, customizer, strictCheck, nativeUndefined, nativeUndefined);
     }
 
     function isNumber(value) {
@@ -1267,10 +1306,6 @@
         return typeof value === 'string' || getTag(value) === stringTag;
     }
 
-    function isUndefined(value) {
-        return value === void 0;
-    }
-
     function isWeakMap(value) {
         return getTagWithBugfix$1(value) === weakMapTag;
     }
@@ -1331,7 +1366,7 @@
         var internalIteratee = createIteratee(iteratee);
         array.forEach(function (value) {
             var current = internalIteratee(value);
-            if (current != null && (computed === undefined ? current === current && !isSymbol(current) : comparator(current, computed))) {
+            if (current != null && (computed === nativeUndefined ? current === current && !isSymbol(current) : comparator(current, computed))) {
                 computed = current;
                 result = value;
             }
@@ -1352,22 +1387,22 @@
     }
 
     var clamp = function (number, lower, upper) {
-        if (upper === undefined) {
+        if (upper === nativeUndefined) {
             upper = lower;
-            lower = undefined;
+            lower = nativeUndefined;
         }
-        if (upper !== undefined) {
+        if (upper !== nativeUndefined) {
             upper = defaultTo(toNumber(upper), 0);
         }
-        if (lower !== undefined) {
+        if (lower !== nativeUndefined) {
             lower = defaultTo(toNumber(lower), 0);
         }
         number = toNumber(number);
         if (number === number) {
-            if (upper !== undefined) {
+            if (upper !== nativeUndefined) {
                 number = number <= upper ? number : upper;
             }
-            if (lower !== undefined) {
+            if (lower !== nativeUndefined) {
                 number = number >= lower ? number : lower;
             }
         }
@@ -1421,6 +1456,23 @@
         return getKeysIn(object).concat(getSymbolsIn(object));
     }
 
+    function invert(object, predicate) {
+        if (predicate === void 0) { predicate = stubTrue; }
+        var _keys = keys$1(object);
+        var result = {};
+        _keys.forEach(function (key) {
+            var value = object[key];
+            if (predicate(value, key)) {
+                var valueStr = value != null && typeof value.toString != 'function' ? objectProtoToString.call(value) : value;
+                result[valueStr] = key;
+            }
+            else {
+                result[key] = value;
+            }
+        });
+        return result;
+    }
+
     function keysIn(object) {
         if (!isObject(object)) {
             return [];
@@ -1443,8 +1495,8 @@
                 obj[key] = srcValue;
             }
             else {
-                var newValue = hasCustomizer ? customizer(obj[key], srcValue, key, obj, source) : undefined;
-                if (newValue !== undefined) {
+                var newValue = hasCustomizer ? customizer(obj[key], srcValue, key, obj, source) : nativeUndefined;
+                if (newValue !== nativeUndefined) {
                     obj[key] = newValue;
                 }
                 else {
@@ -1462,7 +1514,7 @@
                     if (newObjValue) {
                         obj[key] = baseMerge(newObjValue, srcValue, getKeys, customizer, stack);
                     }
-                    else if (srcValue !== undefined || !(key in obj)) {
+                    else if (srcValue !== nativeUndefined || !(key in obj)) {
                         obj[key] = srcValue;
                     }
                 }
@@ -1482,7 +1534,7 @@
         return isArray(value) ? value : [value];
     }
 
-    function omit(object, fields) {
+    var omit = function (object, fields) {
         if (fields === void 0) { fields = []; }
         var keys = allKeysIn(object);
         var fieldArr = castArray(fields);
@@ -1493,7 +1545,7 @@
             }
         });
         return result;
-    }
+    };
 
     function pickBy(object, predicate) {
         if (predicate === void 0) { predicate = stubFlase; }
@@ -1515,7 +1567,7 @@
         return pickBy(object, negate(predicate));
     }
 
-    function pick(object, fields) {
+    var pick = function (object, fields) {
         if (fields === void 0) { fields = []; }
         var result = {};
         var fieldArr = castArray(fields);
@@ -1525,7 +1577,7 @@
             }
         });
         return result;
-    }
+    };
 
     var reAsciiWord = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
     function words(string, pattern) {
@@ -1596,6 +1648,13 @@
 
     var lowerFirst = createCaseFirst('toLowerCase');
 
+    function pascalCase(string, pattern) {
+        return splitCaseWords(string, pattern).reduce(function (prev, cur) {
+            cur = cur.toLowerCase();
+            return prev + upperFirst(cur);
+        }, '');
+    }
+
     function snakeCase(string, pattern) {
         return splitCaseWords(string, pattern).reduce(function (prev, cur, index) { return prev + (index ? '_' : '') + cur.toLowerCase(); }, '');
     }
@@ -1635,18 +1694,18 @@
             var key = props[i];
             var predicate = source[key];
             var value = object[key];
-            if ((value === undefined && !(key in object)) || !predicate(value)) {
+            if ((value === nativeUndefined && !(key in object)) || !predicate(value)) {
                 return false;
             }
         }
         return true;
     };
 
-    function conforms(source) {
+    var conforms = function (source) {
         return function (object) {
             return conformsTo(object, source);
         };
-    }
+    };
 
     function constant(value) {
         return function () {
@@ -1761,6 +1820,7 @@
     exports.conformsTo = conformsTo;
     exports.constant = constant;
     exports.countBy = countBy;
+    exports.curry = curry;
     exports.debounce = debounce;
     exports.defaultTo = defaultTo;
     exports.delay = delay;
@@ -1781,11 +1841,13 @@
     exports.identity = identity;
     exports.inRange = inRange;
     exports.intersection = intersection;
+    exports.invert = invert;
     exports.isArguments = isArguments;
     exports.isArray = isArray;
     exports.isArrayBuffer = isArrayBuffer;
     exports.isArrayLike = isArrayLike;
     exports.isArrayLikeObject = isArrayLikeObject;
+    exports.isBigInt = isBigInt;
     exports.isBlob = isBlob;
     exports.isBoolean = isBoolean;
     exports.isBuffer = isBuffer;
@@ -1840,6 +1902,7 @@
     exports.orderBy = orderBy;
     exports.partial = partial;
     exports.partition = partition;
+    exports.pascalCase = pascalCase;
     exports.pick = pick;
     exports.pickBy = pickBy;
     exports.random = random;