ut2 1.9.5 → 1.10.1

package/es/index.js

@@ -3,6 +3,7 @@ export { default as compact } from './compact.js';
 export { default as difference } from './difference.js';
 export { default as fromPairs } from './fromPairs.js';
 export { default as intersection } from './intersection.js';
+export { default as move } from './move.js';
 export { default as nth } from './nth.js';
 export { default as shuffle } from './shuffle.js';
 export { default as union } from './union.js';
@@ -71,6 +72,7 @@ export { default as isTypedArray } from './isTypedArray.js';
 export { default as isUndefined } from './isUndefined.js';
 export { default as isWeakMap } from './isWeakMap.js';
 export { default as isWeakSet } from './isWeakSet.js';
+export { default as isWindow } from './isWindow.js';
 export { default as ceil } from './ceil.js';
 export { default as floor } from './floor.js';
 export { default as max } from './max.js';
@@ -127,4 +129,5 @@ export { default as toSafeInteger } from './toSafeInteger.js';
 export { default as toString } from './toString.js';
 export { default as uniqueId } from './uniqueId.js';
 export { MAX_ARRAY_LENGTH, MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from './internals/native.js';
-export { VERSION } from './internals/helpers.js';
+export { VERSION, isBrowser } from './internals/helpers.js';
+export { default as root } from './internals/root.js';

package/es/internals/helpers.js

@@ -1,7 +1,9 @@
+import isObjectLike from '../isObjectLike.js';
 import getTag from './getTag.js';
-import { argumentsTag, functionProtoToString } from './native.js';
+import { argumentsTag, stringUndefined, functionProtoToString } from './native.js';
 
-var VERSION = "1.9.5";
+var VERSION = "1.10.1";
+var isBrowser = typeof window !== stringUndefined && isObjectLike(window) && typeof document !== stringUndefined && isObjectLike(document) && window.document === document;
 var supportedArgumentsType = getTag((function () { return arguments; })()) === argumentsTag;
 var FUNC_ERROR_TEXT = 'Expected a function';
 function toSource(func) {
@@ -22,4 +24,4 @@ function toSource(func) {
 var stubFlase = function () { return false; };
 var stubTrue = function () { return true; };
 
-export { FUNC_ERROR_TEXT, VERSION, stubFlase, stubTrue, supportedArgumentsType, toSource };
+export { FUNC_ERROR_TEXT, VERSION, isBrowser, stubFlase, stubTrue, supportedArgumentsType, toSource };

package/es/internals/native.js

@@ -50,5 +50,6 @@ var mapTag = '[object Map]';
 var promiseTag = '[object Promise]';
 var setTag = '[object Set]';
 var weakMapTag = '[object WeakMap]';
+var windowTag = '[object Window]';
 
-export { MAX_ARRAY_LENGTH, MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, argumentsTag, arrayBufferTag, arrayProto, arrayProtoSlice, arrayTag, bigIntTag, blobTag, booleanTag, dataViewTag, dateTag, domExceptionTag, errorTag, functionProto, functionProtoToString, functionTags, globalExisted, globalThisExisted, mapTag, mathAbs, mathCeil, mathFloor, mathMax, mathMin, mathRandom, nativeUndefined, numberIsFinite, numberIsInteger, numberIsSafeInteger, numberTag, objectGetOwnPropertySymbols, objectGetPrototypeOf, objectKeys, objectProto, objectProtoHasOwnProperty, objectProtoPropertyIsEnumerable, objectProtoToString, objectTag, promiseTag, regExpTag, selfExisted, setTag, stringObject, stringTag, stringUndefined, symbolProto, symbolTag, weakMapTag, weakSetTag };
+export { MAX_ARRAY_LENGTH, MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, argumentsTag, arrayBufferTag, arrayProto, arrayProtoSlice, arrayTag, bigIntTag, blobTag, booleanTag, dataViewTag, dateTag, domExceptionTag, errorTag, functionProto, functionProtoToString, functionTags, globalExisted, globalThisExisted, mapTag, mathAbs, mathCeil, mathFloor, mathMax, mathMin, mathRandom, nativeUndefined, numberIsFinite, numberIsInteger, numberIsSafeInteger, numberTag, objectGetOwnPropertySymbols, objectGetPrototypeOf, objectKeys, objectProto, objectProtoHasOwnProperty, objectProtoPropertyIsEnumerable, objectProtoToString, objectTag, promiseTag, regExpTag, selfExisted, setTag, stringObject, stringTag, stringUndefined, symbolProto, symbolTag, weakMapTag, weakSetTag, windowTag };

package/es/isWindow.js

@@ -0,0 +1,9 @@
+import getTag from './internals/getTag.js';
+import { windowTag } from './internals/native.js';
+import isObjectLike from './isObjectLike.js';
+
+function isWindow(value) {
+    return isObjectLike(value) && getTag(value) === windowTag;
+}
+
+export { isWindow as default };

package/es/merge.js

@@ -51,5 +51,6 @@ function merge(object, source, customizer, getKeys) {
     if (getKeys === void 0) { getKeys = allKeys; }
     return baseMerge(object, source, getKeys, customizer);
 }
+merge.NOT_MERGE_ARRAYS = function (objValue, srcValue) { return (isArray(srcValue) ? srcValue : undefined); };
 
 export { merge as default };

package/es/move.js

@@ -0,0 +1,6 @@
+function move(arr, from, to) {
+    arr.splice(to, 0, arr.splice(from, 1)[0]);
+    return arr;
+}
+
+export { move as default };

package/lib/index.js

@@ -5,6 +5,7 @@ var compact = require('./compact.js');
 var difference = require('./difference.js');
 var fromPairs = require('./fromPairs.js');
 var intersection = require('./intersection.js');
+var move = require('./move.js');
 var nth = require('./nth.js');
 var shuffle = require('./shuffle.js');
 var union = require('./union.js');
@@ -73,6 +74,7 @@ var isTypedArray = require('./isTypedArray.js');
 var isUndefined = require('./isUndefined.js');
 var isWeakMap = require('./isWeakMap.js');
 var isWeakSet = require('./isWeakSet.js');
+var isWindow = require('./isWindow.js');
 var ceil = require('./ceil.js');
 var floor = require('./floor.js');
 var max = require('./max.js');
@@ -130,6 +132,7 @@ var toString = require('./toString.js');
 var uniqueId = require('./uniqueId.js');
 var native = require('./internals/native.js');
 var helpers = require('./internals/helpers.js');
+var root = require('./internals/root.js');
 
 
 
@@ -138,6 +141,7 @@ exports.compact = compact;
 exports.difference = difference;
 exports.fromPairs = fromPairs;
 exports.intersection = intersection;
+exports.move = move;
 exports.nth = nth;
 exports.shuffle = shuffle;
 exports.union = union;
@@ -206,6 +210,7 @@ exports.isTypedArray = isTypedArray;
 exports.isUndefined = isUndefined;
 exports.isWeakMap = isWeakMap;
 exports.isWeakSet = isWeakSet;
+exports.isWindow = isWindow;
 exports.ceil = ceil;
 exports.floor = floor;
 exports.max = max;
@@ -265,3 +270,5 @@ exports.MAX_ARRAY_LENGTH = native.MAX_ARRAY_LENGTH;
 exports.MAX_SAFE_INTEGER = native.MAX_SAFE_INTEGER;
 exports.MIN_SAFE_INTEGER = native.MIN_SAFE_INTEGER;
 exports.VERSION = helpers.VERSION;
+exports.isBrowser = helpers.isBrowser;
+exports.root = root;

package/lib/internals/helpers.js

@@ -1,9 +1,11 @@
 'use strict';
 
+var isObjectLike = require('../isObjectLike.js');
 var getTag = require('./getTag.js');
 var native = require('./native.js');
 
-var VERSION = "1.9.5";
+var VERSION = "1.10.1";
+var isBrowser = typeof window !== native.stringUndefined && isObjectLike(window) && typeof document !== native.stringUndefined && isObjectLike(document) && window.document === document;
 var supportedArgumentsType = getTag((function () { return arguments; })()) === native.argumentsTag;
 var FUNC_ERROR_TEXT = 'Expected a function';
 function toSource(func) {
@@ -26,6 +28,7 @@ var stubTrue = function () { return true; };
 
 exports.FUNC_ERROR_TEXT = FUNC_ERROR_TEXT;
 exports.VERSION = VERSION;
+exports.isBrowser = isBrowser;
 exports.stubFlase = stubFlase;
 exports.stubTrue = stubTrue;
 exports.supportedArgumentsType = supportedArgumentsType;

package/lib/internals/native.js

@@ -52,6 +52,7 @@ var mapTag = '[object Map]';
 var promiseTag = '[object Promise]';
 var setTag = '[object Set]';
 var weakMapTag = '[object WeakMap]';
+var windowTag = '[object Window]';
 
 exports.MAX_ARRAY_LENGTH = MAX_ARRAY_LENGTH;
 exports.MAX_SAFE_INTEGER = MAX_SAFE_INTEGER;
@@ -104,3 +105,4 @@ exports.symbolProto = symbolProto;
 exports.symbolTag = symbolTag;
 exports.weakMapTag = weakMapTag;
 exports.weakSetTag = weakSetTag;
+exports.windowTag = windowTag;

package/lib/isWindow.js

@@ -0,0 +1,11 @@
+'use strict';
+
+var getTag = require('./internals/getTag.js');
+var native = require('./internals/native.js');
+var isObjectLike = require('./isObjectLike.js');
+
+function isWindow(value) {
+    return isObjectLike(value) && getTag(value) === native.windowTag;
+}
+
+module.exports = isWindow;

package/lib/merge.js

@@ -53,5 +53,6 @@ function merge(object, source, customizer, getKeys) {
     if (getKeys === void 0) { getKeys = allKeys; }
     return baseMerge(object, source, getKeys, customizer);
 }
+merge.NOT_MERGE_ARRAYS = function (objValue, srcValue) { return (isArray(srcValue) ? srcValue : undefined); };
 
 module.exports = merge;

package/lib/move.js

@@ -0,0 +1,8 @@
+'use strict';
+
+function move(arr, from, to) {
+    arr.splice(to, 0, arr.splice(from, 1)[0]);
+    return arr;
+}
+
+module.exports = move;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ut2",
-  "version": "1.9.5",
+  "version": "1.10.1",
   "author": "caijf",
   "license": "MIT",
   "main": "lib/index.js",

package/types/index.d.ts

@@ -9,6 +9,7 @@ export { default as compact } from './compact';
 export { default as difference } from './difference';
 export { default as fromPairs } from './fromPairs';
 export { default as intersection } from './intersection';
+export { default as move } from './move';
 export { default as nth } from './nth';
 export { default as shuffle } from './shuffle';
 export { default as union } from './union';
@@ -95,6 +96,7 @@ export { default as isTypedArray } from './isTypedArray';
 export { default as isUndefined } from './isUndefined';
 export { default as isWeakMap } from './isWeakMap';
 export { default as isWeakSet } from './isWeakSet';
+export { default as isWindow } from './isWindow';
 /**
  * 数学
  *
@@ -181,4 +183,5 @@ export { default as toSafeInteger } from './toSafeInteger';
 export { default as toString } from './toString';
 export { default as uniqueId } from './uniqueId';
 export { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, MAX_ARRAY_LENGTH } from './internals/native';
-export { VERSION } from './internals/helpers';
+export { VERSION, isBrowser } from './internals/helpers';
+export { default as root } from './internals/root';

package/types/internals/helpers.d.ts

@@ -5,6 +5,13 @@
  * @since 1.0.0
  */
 export declare const VERSION: string;
+/**
+ * 当前运行环境是否为浏览器
+ *
+ * @static
+ * @since 1.10.0
+ */
+export declare const isBrowser: boolean;
 export declare const supportedArgumentsType: boolean;
 export declare const FUNC_ERROR_TEXT = "Expected a function";
 export declare function toSource(func: any): string;

package/types/internals/native.d.ts

@@ -73,3 +73,4 @@ 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]";

package/types/internals/root.d.ts

@@ -1,2 +1,14 @@
+/**
+ * 全局对象。
+ *
+ * 不同的 JavaScript 环境都可以获取到对应的全局对象：
+ * 1. Web 中等同于 `globalThis` / `window` / `self` / `frames` （兼容旧浏览器）
+ * 2. Node.js 中等同于 `globalThis` / `global` （兼容低版本 Node.js）
+ * 3. Web Workers 中等同于 `self`
+ *
+ * @static
+ * @since 1.10.0
+ * @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/isWindow.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 检查值是否为 `Window` 对象。
+ *
+ * @static
+ * @alias module:Language.isWindow
+ * @since 1.10.0
+ * @param {*} value 要检查的值。
+ * @returns {boolean} 如果值为 `Window` 对象，返回 `true`，否则返回 `false`。
+ * @example
+ *
+ * isWindow({}); // false
+ *
+ * // 浏览器环境
+ * isWindow(globalThis); // true
+ * isWindow(window); // true
+ * isWindow(self); // true
+ * isWindow(frames); // true
+ *
+ */
+declare function isWindow(value: any): value is Window & typeof globalThis;
+export default isWindow;

package/types/merge.d.ts

@@ -17,18 +17,27 @@ type Customizer = (objValue: any, srcValue: any, key: string | symbol, object: a
  * @returns {Object} 目标对象。
  * @example
  *
+ * merge({c: 3}, {e: 5}); // { c: 3, e: 5 }
+ * merge({ a: 1 }, { a: undefined, b: undefined }); // { a: 1, b: undefined }
+ *
  * const object = {
  *   a: [{b: 2}, {d: 4}]
  * }
- *
  * const other = {
  *   a: [{c: 3},{e: 5}]
  * }
  *
  * merge(object, other); // { a: [{b: 2, c: 3}, {d: 4, e: 5}] }
  *
- * // 自定义，数组不合并
+ * // 数组不合并
+ * merge(object, other, merge.NOT_MERGE_ARRAYS); // { a: [{c: 3},{e: 5}] }
+ *
+ * // 或自定义数组不合并方法
  * merge(object, other, (objValue, srcValue) => isArray(srcValue) ? srcValue : undefined); // { a: [{c: 3},{e: 5}] }
+ *
  */
 declare function merge<TObject, TSource>(object: TObject, source: TSource, customizer?: Customizer, getKeys?: GetKeysMethod): TObject & TSource;
+declare namespace merge {
+    var NOT_MERGE_ARRAYS: (objValue: any, srcValue: any) => any[] | undefined;
+}
 export default merge;

package/types/move.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 将数组 `from` 位置的元素移至 `to` 位置。
+ *
+ * @static
+ * @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}
+ * @param {Array} array 要处理的数组。
+ * @param {number} from 要移动的元素索引。
+ * @param {number} to 要移动目标位置的元素索引。
+ * @returns {*} 处理后的原数组。
+ * @example
+ *
+ * const arr = ['a', 'b', 'c', 'd'];
+ *
+ * move(arr, 0, 1); // ['b', 'a', 'c', 'd']
+ *
+ * // 此时 arr 已经变为 ['b', 'a', 'c', 'd']
+ * move(arr, -2, 0); // ['c', 'b', 'a', 'd']
+ *
+ */
+declare function move<T>(arr: T[], from: number, to: number): T[];
+export default move;