@gx-design-vue/pro-utils 0.2.0-beta.86 → 0.2.0-beta.88

package/dist/is/browser.js

@@ -0,0 +1,14 @@
+//#region src/is/browser.ts
+const isNode = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
+/**
+* 检查是否为浏览器环境
+*
+* @returns 是否为浏览器
+*/
+function isBrowser() {
+	if (process.env.NODE_ENV === "TEST") return true;
+	return typeof window !== "undefined" && typeof window.document !== "undefined" && typeof window.matchMedia !== "undefined" && !isNode;
+}
+
+//#endregion
+export { isBrowser };

package/dist/is/deepEqual.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/deepEqual.d.ts
+declare function isDeepEqualReact(a: any, b: any, ignoreKeys?: string[], debug?: boolean): boolean;
+//#endregion
+export { isDeepEqualReact };

package/dist/is/deepEqual.js

@@ -0,0 +1,62 @@
+//#region src/is/deepEqual.ts
+/**
+* React 深度比较
+*
+* @param a - 第一个值
+* @param b - 第二个值
+* @param ignoreKeys - 忽略的键
+* @param debug - 是否调试
+* @returns 是否相等
+*/
+function isDeepEqualReact(a, b, ignoreKeys, debug) {
+	if (a === b) return true;
+	if (a && b && typeof a === "object" && typeof b === "object") {
+		if (a.constructor !== b.constructor) return false;
+		let length;
+		let i;
+		if (Array.isArray(a)) {
+			length = a.length;
+			if (length != b.length) return false;
+			for (i = length; i-- !== 0;) if (!isDeepEqualReact(a[i], b[i], ignoreKeys, debug)) return false;
+			return true;
+		}
+		if (a instanceof Map && b instanceof Map) {
+			if (a.size !== b.size) return false;
+			for (i of a.entries()) if (!b.has(i[0])) return false;
+			for (i of a.entries()) if (!isDeepEqualReact(i[1], b.get(i[0]), ignoreKeys, debug)) return false;
+			return true;
+		}
+		if (a instanceof Set && b instanceof Set) {
+			if (a.size !== b.size) return false;
+			for (i of a.entries()) if (!b.has(i[0])) return false;
+			return true;
+		}
+		if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b)) {
+			length = a.length;
+			if (length != b.length) return false;
+			for (i = length; i-- !== 0;) if (a[i] !== b[i]) return false;
+			return true;
+		}
+		if (a.constructor === RegExp) return a.source === b.source && a.flags === b.flags;
+		if (a.valueOf !== Object.prototype.valueOf && a.valueOf) return a.valueOf() === b.valueOf();
+		if (a.toString !== Object.prototype.toString && a.toString) return a.toString() === b.toString();
+		const keys = Object.keys(a);
+		length = keys.length;
+		if (length !== Object.keys(b).length) return false;
+		for (i = length; i-- !== 0;) if (!Object.prototype.hasOwnProperty.call(b, keys[i])) return false;
+		for (i = length; i-- !== 0;) {
+			const key = keys[i];
+			if (ignoreKeys?.includes(key)) continue;
+			if (key === "_owner" && a.$$typeof) continue;
+			if (!isDeepEqualReact(a[key], b[key], ignoreKeys, debug)) {
+				if (debug) console.log(key);
+				return false;
+			}
+		}
+		return true;
+	}
+	return a !== a && b !== b;
+}
+
+//#endregion
+export { isDeepEqualReact };

package/dist/is/device.d.ts

@@ -0,0 +1,6 @@
+//#region src/is/device.d.ts
+declare function isMobile(): boolean;
+declare function isTablet(): boolean;
+declare function isWindowsOs(): boolean;
+//#endregion
+export { isMobile, isTablet, isWindowsOs };

package/dist/is/device.js

@@ -0,0 +1,37 @@
+//#region src/is/device.ts
+/**
+* 判断是否为移动端
+*
+* @returns 是否为移动端
+*/
+function isMobile() {
+	const userAgent = navigator.userAgent || navigator.vendor;
+	if (/iPhone/.test(userAgent)) return true;
+	if (/Android/.test(userAgent) && /Mobile/.test(userAgent)) return true;
+	if (/Windows Phone/.test(userAgent)) return true;
+	if (/Mobile/.test(userAgent) && !isTablet()) return true;
+	return false;
+}
+/**
+* 判断是否为平板
+*
+* @returns 是否为平板
+*/
+function isTablet() {
+	const userAgent = navigator.userAgent || navigator.vendor;
+	if (/iPad/.test(userAgent)) return true;
+	if (/Macintosh/.test(userAgent) && "ontouchend" in document) return true;
+	if (/Android/.test(userAgent) && !/Mobile/.test(userAgent)) return true;
+	return false;
+}
+/**
+* 检查当前运行环境是否为 Windows OS
+*
+* @returns 是否为 Windows 系统
+*/
+function isWindowsOs() {
+	return /windows|win32/i.test(navigator.userAgent);
+}
+
+//#endregion
+export { isMobile, isTablet, isWindowsOs };

package/dist/is/equal.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/equal.d.ts
+declare function isEqual(obj1: any, obj2: any, shallow?: boolean): boolean;
+//#endregion
+export { isEqual };

package/dist/is/equal.js

@@ -0,0 +1,34 @@
+//#region src/is/equal.ts
+/**
+* 深度比较两个对象
+*
+* @param obj1 - 第一个对象
+* @param obj2 - 第二个对象
+* @param shallow - 是否浅比较
+* @returns 是否相等
+*/
+function isEqual(obj1, obj2, shallow = false) {
+	const refSet = /* @__PURE__ */ new Set();
+	function deepEqual(a, b, level = 1) {
+		if (refSet.has(a)) return false;
+		if (a === b) return true;
+		if (shallow && level > 1) return false;
+		refSet.add(a);
+		const newLevel = level + 1;
+		if (Array.isArray(a)) {
+			if (!Array.isArray(b) || a.length !== b.length) return false;
+			for (let i = 0; i < a.length; i++) if (!deepEqual(a[i], b[i], newLevel)) return false;
+			return true;
+		}
+		if (a && b && typeof a === "object" && typeof b === "object") {
+			const keys = Object.keys(a);
+			if (keys.length !== Object.keys(b).length) return false;
+			return keys.every((key) => deepEqual(a[key], b[key], newLevel));
+		}
+		return false;
+	}
+	return deepEqual(obj1, obj2);
+}
+
+//#endregion
+export { isEqual };

package/dist/is/img.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/img.d.ts
+declare function isImg(path: string): boolean;
+//#endregion
+export { isImg };

package/dist/is/img.js

@@ -0,0 +1,13 @@
+//#region src/is/img.ts
+/**
+* 判断是否是图片链接
+*
+* @param path - 图片路径
+* @returns 是否为图片
+*/
+function isImg(path) {
+	return /\w.(?:png|jpg|jpeg|svg|webp|gif|bmp)$/i.test(path);
+}
+
+//#endregion
+export { isImg };

package/dist/is/index.d.ts

@@ -0,0 +1,16 @@
+import { isBase64, isDataURLBase64 } from "./base64.js";
+import { isBrowser } from "./browser.js";
+import { isDeepEqualReact } from "./deepEqual.js";
+import { isMobile, isTablet, isWindowsOs } from "./device.js";
+import { isEqual } from "./equal.js";
+import { isImg } from "./img.js";
+import { isNil, isNotNil } from "./nil.js";
+import { isObjectWithSymbols, isPlainObject } from "./plainObject.js";
+import { isPrimitive } from "./primitive.js";
+import { isServer } from "./server.js";
+import { is, isArray, isBoolean, isFunction, isJSONStr, isNumber, isObject, isString } from "./type.js";
+import { isTypedArray } from "./typedArray.js";
+import { isUnsafeProperty } from "./unsafeProperty.js";
+import { isUrl } from "./url.js";
+import { convertValueBoolean, isValid } from "./valid.js";
+export { convertValueBoolean, is, isArray, isBase64, isBoolean, isBrowser, isDataURLBase64, isDeepEqualReact, isEqual, isFunction, isImg, isJSONStr, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindowsOs };

package/dist/is/index.js

@@ -0,0 +1,17 @@
+import { isBase64, isDataURLBase64 } from "./base64.js";
+import { isBrowser } from "./browser.js";
+import { isDeepEqualReact } from "./deepEqual.js";
+import { isMobile, isTablet, isWindowsOs } from "./device.js";
+import { isEqual } from "./equal.js";
+import { isImg } from "./img.js";
+import { isNil, isNotNil } from "./nil.js";
+import { is, isArray, isBoolean, isFunction, isJSONStr, isNumber, isObject, isString } from "./type.js";
+import { isObjectWithSymbols, isPlainObject } from "./plainObject.js";
+import { isPrimitive } from "./primitive.js";
+import { isServer } from "./server.js";
+import { isTypedArray } from "./typedArray.js";
+import { isUnsafeProperty } from "./unsafeProperty.js";
+import { isUrl } from "./url.js";
+import { convertValueBoolean, isValid } from "./valid.js";
+
+export { convertValueBoolean, is, isArray, isBase64, isBoolean, isBrowser, isDataURLBase64, isDeepEqualReact, isEqual, isFunction, isImg, isJSONStr, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindowsOs };

package/dist/is/nil.d.ts

@@ -0,0 +1,5 @@
+//#region src/is/nil.d.ts
+declare function isNil<T>(val: T): val is Extract<T, null | undefined>;
+declare function isNotNil<T>(val: T): val is Exclude<T, null | undefined>;
+//#endregion
+export { isNil, isNotNil };

package/dist/is/nil.js

@@ -0,0 +1,22 @@
+//#region src/is/nil.ts
+/**
+* 判断值是否为 null 或 undefined
+*
+* @param val - 要判断的值
+* @returns 是否为 null 或 undefined
+*/
+function isNil(val) {
+	return val === null || val === void 0;
+}
+/**
+* 判断值是否不为 null 且不为 undefined
+*
+* @param val - 要判断的值
+* @returns 是否不为 null 且不为 undefined
+*/
+function isNotNil(val) {
+	return val !== null && val !== void 0;
+}
+
+//#endregion
+export { isNil, isNotNil };

package/dist/is/plainObject.d.ts

@@ -0,0 +1,5 @@
+//#region src/is/plainObject.d.ts
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+declare function isObjectWithSymbols(value: unknown): boolean;
+//#endregion
+export { isObjectWithSymbols, isPlainObject };

package/dist/is/plainObject.js

@@ -0,0 +1,30 @@
+import { getSymbols } from "../function/object.js";
+import { isObject } from "./type.js";
+
+//#region src/is/plainObject.ts
+/**
+* 判断是否为纯对象（plain object）
+*
+* @param value - 要判断的值
+* @returns 是否为纯对象
+*/
+function isPlainObject(value) {
+	if (!isObject(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	if (proto === null) return true;
+	const ctor = Object.prototype.hasOwnProperty.call(proto, "constructor") && proto.constructor;
+	return typeof ctor === "function" && ctor instanceof ctor && Function.prototype.toString.call(ctor) === Function.prototype.toString.call(Object);
+}
+/**
+* 检查对象是否有 Symbol 属性
+*
+* @param value - 要检查的值
+* @returns 是否有 Symbol 属性
+*/
+function isObjectWithSymbols(value) {
+	if (!isObject(value)) return false;
+	return getSymbols(value).length > 0;
+}
+
+//#endregion
+export { isObjectWithSymbols, isPlainObject };

package/dist/is/primitive.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/primitive.d.ts
+declare function isPrimitive(value: unknown): value is string | number | boolean | null | undefined | symbol | bigint;
+//#endregion
+export { isPrimitive };

package/dist/is/primitive.js

@@ -0,0 +1,13 @@
+//#region src/is/primitive.ts
+/**
+* 判断是否为原始类型
+*
+* @param value - 要判断的值
+* @returns 是否为原始类型
+*/
+function isPrimitive(value) {
+	return value === null || typeof value !== "object" && typeof value !== "function";
+}
+
+//#endregion
+export { isPrimitive };

package/dist/is/server.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/server.d.ts
+declare const isServer: boolean;
+//#endregion
+export { isServer };

package/dist/is/server.js

@@ -0,0 +1,10 @@
+//#region src/is/server.ts
+/**
+* 检查是否为服务端环境
+*
+* @returns 是否为服务端
+*/
+const isServer = typeof window === "undefined";
+
+//#endregion
+export { isServer };

package/dist/is/type.d.ts

@@ -0,0 +1,11 @@
+//#region src/is/type.d.ts
+declare function is(val: unknown, type: string): boolean;
+declare function isBoolean(val: unknown): val is boolean;
+declare function isNumber(val: unknown): val is number;
+declare function isArray(val: any): val is Array<any>;
+declare function isObject(val: any): val is Record<any, any>;
+declare function isString(value: unknown): value is string;
+declare function isFunction(func: unknown): func is (...args: any[]) => any;
+declare function isJSONStr(str: any): boolean;
+//#endregion
+export { is, isArray, isBoolean, isFunction, isJSONStr, isNumber, isObject, isString };

package/dist/is/type.js

@@ -0,0 +1,84 @@
+//#region src/is/type.ts
+/**
+* 基础类型判断
+*
+* @param val - 要判断的值
+* @param type - 类型名称
+* @returns 是否为该类型
+*/
+function is(val, type) {
+	return Object.prototype.toString.call(val) === `[object ${type}]`;
+}
+/**
+* 判断是否为布尔值
+*
+* @param val - 要判断的值
+* @returns 是否为布尔值
+*/
+function isBoolean(val) {
+	return typeof val === "boolean";
+}
+/**
+* 判断是否为数字
+*
+* @param val - 要判断的值
+* @returns 是否为数字
+*/
+function isNumber(val) {
+	return typeof val === "number";
+}
+/**
+* 判断是否为数组
+*
+* @param val - 要判断的值
+* @returns 是否为数组
+*/
+function isArray(val) {
+	if (typeof Array.isArray === "undefined") return Object.prototype.toString.call(val) === "[object Array]";
+	return Array.isArray(val);
+}
+/**
+* 判断是否为对象
+*
+* @param val - 要判断的值
+* @returns 是否为对象
+*/
+function isObject(val) {
+	return val !== null && is(val, "Object");
+}
+/**
+* 判断是否为字符串
+*
+* @param value - 要判断的值
+* @returns 是否为字符串
+*/
+function isString(value) {
+	return typeof value === "string";
+}
+/**
+* 判断是否为函数
+*
+* @param func - 要判断的值
+* @returns 是否为函数
+*/
+function isFunction(func) {
+	return typeof func === "function" || Object.prototype.toString.call(func) === "[object Function]";
+}
+/**
+* 判断是否为 JSON 字符串
+*
+* @param str - 要判断的字符串
+* @returns 是否为 JSON 字符串
+*/
+function isJSONStr(str) {
+	if (typeof str !== "string") return false;
+	try {
+		const obj = JSON.parse(str);
+		return typeof obj === "object" && obj !== null;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { is, isArray, isBoolean, isFunction, isJSONStr, isNumber, isObject, isString };

package/dist/is/typedArray.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/typedArray.d.ts
+declare function isTypedArray(x: unknown): x is Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | BigUint64Array | Int8Array | Int16Array | Int32Array | BigInt64Array | Float32Array | Float64Array;
+//#endregion
+export { isTypedArray };

package/dist/is/typedArray.js

@@ -0,0 +1,33 @@
+//#region src/is/typedArray.ts
+/**
+* Checks if a value is a TypedArray.
+* @param {unknown} x The value to check.
+* @returns {x is
+*     Uint8Array
+*   | Uint8ClampedArray
+*   | Uint16Array
+*   | Uint32Array
+*   | BigUint64Array
+*   | Int8Array
+*   | Int16Array
+*   | Int32Array
+*   | BigInt64Array
+*   | Float32Array
+*   | Float64Array} Returns true if `x` is a TypedArray, false otherwise.
+*
+* @example
+* const arr = new Uint8Array([1, 2, 3]);
+* isTypedArray(arr); // true
+*
+* const regularArray = [1, 2, 3];
+* isTypedArray(regularArray); // false
+*
+* const buffer = new ArrayBuffer(16);
+* isTypedArray(buffer); // false
+*/
+function isTypedArray(x) {
+	return ArrayBuffer.isView(x) && !(x instanceof DataView);
+}
+
+//#endregion
+export { isTypedArray };

package/dist/is/unsafeProperty.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/unsafeProperty.d.ts
+declare function isUnsafeProperty(property: string | symbol): boolean;
+//#endregion
+export { isUnsafeProperty };

package/dist/is/unsafeProperty.js

@@ -0,0 +1,18 @@
+//#region src/is/unsafeProperty.ts
+/**
+* 检查属性名是否为不安全的属性名（原型链上的属性或构造函数）
+*
+* @param property - 属性名
+* @returns 是否为不安全的属性名
+*/
+function isUnsafeProperty(property) {
+	if (typeof property === "symbol") return false;
+	return [
+		"__proto__",
+		"constructor",
+		"prototype"
+	].includes(property);
+}
+
+//#endregion
+export { isUnsafeProperty };

package/dist/is/url.d.ts

@@ -0,0 +1,4 @@
+//#region src/is/url.d.ts
+declare function isUrl(path: string | undefined): boolean;
+//#endregion
+export { isUrl };

package/dist/is/url.js

@@ -0,0 +1,20 @@
+//#region src/is/url.ts
+/**
+* 判断是否为 URL
+*
+* @param path - 路径
+* @returns 是否为 URL
+*/
+function isUrl(path) {
+	if (!path) return false;
+	if (!path.startsWith("http")) return false;
+	try {
+		return !!new URL(path);
+	} catch (_) {
+		console.error("isUrl error", _);
+		return false;
+	}
+}
+
+//#endregion
+export { isUrl };

package/dist/is/valid.d.ts

@@ -0,0 +1,5 @@
+//#region src/is/valid.d.ts
+declare function isValid(value: any): boolean;
+declare function convertValueBoolean(value: any): boolean;
+//#endregion
+export { convertValueBoolean, isValid };

package/dist/is/valid.js

@@ -0,0 +1,23 @@
+//#region src/is/valid.ts
+/**
+* 判断值是否有效（不为 undefined、null 或空字符串）
+*
+* @param value - 要判断的值
+* @returns 是否有效
+*/
+function isValid(value) {
+	return value !== void 0 && value !== null && value !== "";
+}
+/**
+* 将值转换为布尔值
+*
+* @param value - 要转换的值
+* @returns 转换后的布尔值
+*/
+function convertValueBoolean(value) {
+	if (typeof value === "boolean") return value;
+	return !!value;
+}
+
+//#endregion
+export { convertValueBoolean, isValid };

package/dist/merge/index.d.ts

@@ -1,50 +1,7 @@
-/**
- * 用于合并 n 个对象
- * @param  {any[]} ...rest
- * @returns T
- */
-declare const merge: <T = any>(...rest: any[]) => T;
-/**
- * Merges the properties of the source object into a deep clone of the target object.
- * Unlike `merge`, This function does not modify the original target object.
- *
- * This function performs a deep merge, meaning nested objects and arrays are merged recursively.
- *
- * - If a property in the source object is an array or object and the corresponding property in the target object is also an array or object, they will be merged.
- * - If a property in the source object is undefined, it will not overwrite a defined property in the target object.
- *
- * Note that this function does not mutate the target object.
- *
- * @param {T} target - The target object to be cloned and merged into. This object is not modified directly.
- * @param {S} source - The source object whose properties will be merged into the cloned target object.
- * @returns {T & S} A new object with properties from the source object merged into a deep clone of the target object.
- *
- * @template T - Type of the target object.
- * @template S - Type of the source object.
- *
- * @example
- * const target = { a: 1, b: { x: 1, y: 2 } };
- * const source = { b: { y: 3, z: 4 }, c: 5 };
- *
- * const result = toMerged(target, source);
- * console.log(result);
- * // Output: { a: 1, b: { x: 1, y: 3, z: 4 }, c: 5 }
- *
- * @example
- * const target = { a: [1, 2], b: { x: 1 } };
- * const source = { a: [3], b: { y: 2 } };
- *
- * const result = toMerged(target, source);
- * console.log(result);
- * // Output: { a: [3, 2], b: { x: 1, y: 2 } }
- *
- * @example
- * const target = { a: null };
- * const source = { a: [1, 2, 3] };
- *
- * const result = toMerged(target, source);
- * console.log(result);
- * // Output: { a: [1, 2, 3] }
- */
+import { mergeWith } from "./mergeWith.js";
+
+//#region src/merge/index.d.ts
+declare function merge<T = any>(...rest: any[]): T;
 declare function deepMerge<T extends Record<PropertyKey, any>, S extends Record<PropertyKey, any>>(target: T, source: S): T & S;
-export { deepMerge, merge };
+//#endregion
+export { deepMerge, merge, mergeWith };

package/dist/merge/index.js

@@ -0,0 +1,41 @@
+import { isPlainObject } from "../is/plainObject.js";
+import "../is/index.js";
+import { cloneDeep } from "../clone/cloneDeep.js";
+import "../clone/index.js";
+import { mergeWith } from "./mergeWith.js";
+
+//#region src/merge/index.ts
+/**
+* 合并多个对象
+*
+* @param rest - 要合并的对象
+* @returns 合并后的对象
+*/
+function merge(...rest) {
+	const obj = {};
+	const il = rest.length;
+	let key;
+	let i = 0;
+	for (; i < il; i += 1) for (key in rest[i]) if (Object.prototype.hasOwnProperty.call(rest[i], key)) if (typeof obj[key] === "object" && typeof rest[i][key] === "object" && obj[key] !== void 0 && obj[key] !== null && !Array.isArray(obj[key]) && !Array.isArray(rest[i][key])) obj[key] = {
+		...obj[key],
+		...rest[i][key]
+	};
+	else obj[key] = rest[i][key];
+	return obj;
+}
+/**
+* 深度合并对象
+*
+* @param target - 目标对象
+* @param source - 源对象(一般是 default 对象)
+* @returns 合并后的对象
+*/
+function deepMerge(target, source) {
+	return mergeWith(cloneDeep(target), source, function mergeRecursively(targetValue, sourceValue) {
+		if (isPlainObject(sourceValue)) if (isPlainObject(targetValue)) return mergeWith(cloneDeep(targetValue), sourceValue, mergeRecursively);
+		else return mergeWith({}, sourceValue, mergeRecursively);
+	});
+}
+
+//#endregion
+export { deepMerge, merge, mergeWith };