@gx-design-vue/pro-utils 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/file/convert.d.ts

@@ -36,6 +36,10 @@ declare function dataURLtoFile(url: string, filename: string): File;
  * @param fileType - 文件类型
  * @returns File 对象
  */
-declare function blobToDataURL(blob: Blob, fileName: string, fileType: string): File;
+declare function blobToFile(blob: Blob, fileName: string, fileType: string): File;
+/**
+ * @deprecated 请使用 blobToFile，该函数实际返回 File 对象而非 Data URL
+ */
+declare const blobToDataURL: typeof blobToFile;
 //#endregion
-export { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl };
+export { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl };

package/dist/file/convert.js

@@ -61,8 +61,13 @@ function dataURLtoFile(url, filename) {
 * @param fileType - 文件类型
 * @returns File 对象
 */
-function blobToDataURL(blob, fileName, fileType) {
+function blobToFile(blob, fileName, fileType) {
+	if (typeof window === "undefined") return null;
 	return new window.File([blob], fileName, { type: fileType });
 }
+/**
+* @deprecated 请使用 blobToFile，该函数实际返回 File 对象而非 Data URL
+*/
+const blobToDataURL = blobToFile;
 //#endregion
-export { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl };
+export { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl };

package/dist/file/index.d.ts

@@ -1,5 +1,4 @@
 import { fileTypes } from "./config.js";
-import { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./convert.js";
-import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./media.js";
+import { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./convert.js";
 import { checkFileType, getFileSuffix, getVideoFileUrl } from "./type.js";
-export { blobToDataURL, checkFileType, dataURLtoBlob, dataURLtoFile, fileTypes, generateVideoPicture, getBase64, getBlobUrl, getFileSuffix, getMediaInfos, getVideoCoverPicture, getVideoFileUrl };
+export { blobToDataURL, blobToFile, checkFileType, dataURLtoBlob, dataURLtoFile, fileTypes, getBase64, getBlobUrl, getFileSuffix, getVideoFileUrl };

package/dist/file/index.js

@@ -1,5 +1,4 @@
 import { fileTypes } from "./config.js";
-import { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./convert.js";
 import { checkFileType, getFileSuffix, getVideoFileUrl } from "./type.js";
-import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./media.js";
-export { blobToDataURL, checkFileType, dataURLtoBlob, dataURLtoFile, fileTypes, generateVideoPicture, getBase64, getBlobUrl, getFileSuffix, getMediaInfos, getVideoCoverPicture, getVideoFileUrl };
+import { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./convert.js";
+export { blobToDataURL, blobToFile, checkFileType, dataURLtoBlob, dataURLtoFile, fileTypes, getBase64, getBlobUrl, getFileSuffix, getVideoFileUrl };

package/dist/file/type.js

@@ -1,5 +1,4 @@
-import { isBase64 } from "../is/base64.js";
-import "../is/index.js";
+import { isMediaDataURI } from "../is/base64.js";
 import { fileTypes } from "./config.js";
 //#region src/file/type.ts
 /**
@@ -37,15 +36,15 @@ function checkFileType(url, type) {
 	if (!url) return "4";
 	if (url === "data:") return "4";
 	let fileType = "4";
-	if (isBase64(url)) {
+	if (isMediaDataURI(url)) {
 		if (url.includes("data:image/")) fileType = "png";
 		else if (url.includes("data:video/")) fileType = "mp4";
 		else if (url.includes("data:audio/")) fileType = "mp3";
 	} else if (url instanceof Blob) {
-		url = String(url);
-		if (url.includes("image")) fileType = "png";
-		else if (url.includes("video")) fileType = "mp4";
-		else if (url.includes("audio")) fileType = "mp3";
+		const mimeType = url.type || "";
+		if (mimeType.startsWith("image/")) fileType = "png";
+		else if (mimeType.startsWith("video/")) fileType = "mp4";
+		else if (mimeType.startsWith("audio/")) fileType = "mp3";
 	} else fileType = getFileSuffix(url).toLowerCase();
 	if (fileTypes.imageType.includes(fileType)) return "1";
 	if (fileTypes.videoType.includes(fileType)) return "3";

package/dist/function/copy.d.ts

@@ -4,6 +4,13 @@ import { RecordType } from "../typing.js";
 /**
  * 简单深拷贝（使用 JSON 序列化）
  *
+ * 注意：基于 `JSON.parse(JSON.stringify())` 实现，存在以下限制：
+ * - `undefined`、函数、`Symbol` 会丢失
+ * - `Date` 会变为字符串、`RegExp`/`Map`/`Set` 会变为空对象
+ * - 含循环引用时会抛错
+ *
+ * 如需完整深拷贝，请使用 {@link cloneDeep}。
+ *
  * @param data - 要拷贝的数据
  * @returns 拷贝后的数据
  */

package/dist/function/copy.js

@@ -2,6 +2,13 @@
 /**
 * 简单深拷贝（使用 JSON 序列化）
 *
+* 注意：基于 `JSON.parse(JSON.stringify())` 实现，存在以下限制：
+* - `undefined`、函数、`Symbol` 会丢失
+* - `Date` 会变为字符串、`RegExp`/`Map`/`Set` 会变为空对象
+* - 含循环引用时会抛错
+*
+* 如需完整深拷贝，请使用 {@link cloneDeep}。
+*
 * @param data - 要拷贝的数据
 * @returns 拷贝后的数据
 */

package/dist/function/getValue.d.ts

@@ -1,10 +1,10 @@
 //#region src/function/getValue.d.ts
-type DeepValueOf<T, K> = K extends `${infer First}:${infer Rest}` ? First extends keyof T ? Rest extends '' ? T[First] : DeepValueOf<T[First], Rest> : undefined : K extends keyof T ? T[K] : undefined;
+type DeepValueOf<T, K> = K extends `${infer First}.${infer Rest}` ? First extends keyof T ? Rest extends '' ? T[First] : DeepValueOf<T[First], Rest> : undefined : K extends `${infer First}:${infer Rest}` ? First extends keyof T ? Rest extends '' ? T[First] : DeepValueOf<T[First], Rest> : undefined : K extends keyof T ? T[K] : undefined;
 /**
  * 根据 key 从对象中获取值（支持嵌套路径）
  *
  * @param object - 目标对象
- * @param key - 键路径（支持用冒号分隔的嵌套路径）
+ * @param key - 键路径（支持 `.` 或 `:` 分隔的嵌套路径）
  * @returns 获取的值
  */
 declare function getValueFromObjectByKey<T extends object, K extends string | string[] = string>(object: T, key: K): DeepValueOf<T, K extends string ? K : string> | undefined;

package/dist/function/getValue.js

@@ -3,14 +3,14 @@
 * 根据 key 从对象中获取值（支持嵌套路径）
 *
 * @param object - 目标对象
-* @param key - 键路径（支持用冒号分隔的嵌套路径）
+* @param key - 键路径（支持 `.` 或 `:` 分隔的嵌套路径）
 * @returns 获取的值
 */
 function getValueFromObjectByKey(object, key) {
 	if (typeof key !== "string" && !Array.isArray(key)) return;
-	const keys = Array.isArray(key) ? key : key.split(":");
+	const keys = Array.isArray(key) ? key : key.split(/[.:]/);
 	let currentValue = object;
-	for (let i = 0; i < keys.length; i++) if (currentValue && Object.prototype.hasOwnProperty.call(currentValue, keys[i])) currentValue = currentValue[keys[i]];
+	for (let i = 0; i < keys.length; i++) if (currentValue && Object.hasOwn(currentValue, keys[i])) currentValue = currentValue[keys[i]];
 	else return;
 	return currentValue;
 }

package/dist/index.d.ts

@@ -1,26 +1,27 @@
 import { arraySlice } from "./array/slice.js";
 import { compareArray, compareArraySort, compareArrayTimeSort, compareTime } from "./array/sort.js";
-import { AlignType, BasicTablePageConfig, Breakpoint, CustomRender, DeepPartial, EmptyEmit, ExtendIfDefined, Fn, LimitDeepPartial, MediaOptions, Nullable, OmitUndefined, RecordType, SemanticClassNames, SemanticStyles, SizeType, VueNode, WithFalse, WithIfDefault, WithRequired } from "./typing.js";
+import { AlignType, BasicTablePageConfig, Breakpoint, CustomRender, DeepPartial, EmptyEmit, EmptyObject, ExtendIfDefined, Fn, LimitDeepPartial, MediaOptions, Nullable, OmitUndefined, RecordType, RenderNodeFn, SemanticClassNames, SemanticStyles, SizeType, WithFalse, WithIfDefault, WithRequired } from "./typing.js";
 import { filterTree, findSourceByTree, findValueAndAncestors, getArrayLast, getLevelData, getMaxFloor, getSortIndex, treeData } from "./array/tree.js";
-import { arrayUnique } from "./array/unique.js";
+import { arrayUnique, arrayUniqueBy } from "./array/unique.js";
 import { PrefixCls, getPrefixCls } from "./class/prefix.js";
 import { cloneDeep } from "./clone/cloneDeep.js";
 import { cloneDeepWith, cloneDeepWithImpl, copyProperties } from "./clone/cloneDeepWith.js";
 import { off, on } from "./dom/event.js";
 import { getTextWidth } from "./dom/measure.js";
-import wrapperRaf from "./dom/raf.js";
+import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./dom/media.js";
+import { wrapperRaf } from "./dom/raf.js";
 import { ScrollToOptions, easeInOutCubic, getScroll, getScrollContainer, isInContainer, isScroll, isWindow, scrollTo } from "./dom/scroll.js";
+import { Base64 } from "./encoding/base64.js";
 import { fileTypes } from "./file/config.js";
-import { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./file/convert.js";
-import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./file/media.js";
+import { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./file/convert.js";
 import { checkFileType, getFileSuffix, getVideoFileUrl } from "./file/type.js";
 import { deepCopy } from "./function/copy.js";
 import { getValueFromObjectByKey } from "./function/getValue.js";
 import { forInObject, getSymbols, keysOf } from "./function/object.js";
 import { runFunction } from "./function/run.js";
-import { isBase64, isDataURLBase64 } from "./is/base64.js";
+import { isDataURLBase64, isMediaDataURI } from "./is/base64.js";
 import { isBrowser } from "./is/browser.js";
-import { isDeepEqualReact } from "./is/deepEqual.js";
+import { isDeepEqual, isDeepEqualReact } from "./is/deepEqual.js";
 import { isMobile, isTablet, isWindowsOs } from "./is/device.js";
 import { isEqual } from "./is/equal.js";
 import { isImg } from "./is/img.js";
@@ -33,7 +34,7 @@ import { isTypedArray } from "./is/typedArray.js";
 import { isUnsafeProperty } from "./is/unsafeProperty.js";
 import { isUrl } from "./is/url.js";
 import { convertValueBoolean, isValid } from "./is/valid.js";
-import { useDeepMerge } from "./merge/useDeepMege.js";
+import { useDeepMerge } from "./merge/deepCloneMerge.js";
 import { mergeWith } from "./merge/mergeWith.js";
 import { deepMerge, merge } from "./merge/index.js";
 import { toChinesNum } from "./number/chinese.js";
@@ -42,11 +43,11 @@ import classNames from "./object/classNames.js";
 import { omitBoolean } from "./object/omitBoolean.js";
 import { omitUndefined } from "./object/omitUndefined.js";
 import { omitUndefinedAndEmptyArr } from "./object/omitUndefinedAndEmptyArr.js";
+import { RenderResult, SlotsPropsResult, filterEmpty, getKeys, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, isEmptyElement, slotRender } from "./slots/index.js";
 import { formatDuration } from "./string/duration.js";
 import { handleEmptyField } from "./string/empty.js";
 import { nanoid } from "./string/nanoid.js";
-import { getRandomNumber } from "./string/uuid.js";
+import { createUUIDFactory } from "./string/uuid.js";
 import { genColumnKey, handleShowIndex } from "./table/column.js";
 import { handleCurrentPage } from "./table/page.js";
-import { RenderResult, SlotsPropsResult, filterEmpty, getKeys, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, isEmptyElement, slotRender } from "./vue/slots.js";
-export { AlignType, BasicTablePageConfig, Breakpoint, CustomRender, DeepPartial, EmptyEmit, ExtendIfDefined, Fn, LimitDeepPartial, MediaOptions, Nullable, OmitUndefined, PrefixCls, RecordType, RenderResult, ScrollToOptions, SemanticClassNames, SemanticStyles, SizeType, SlotsPropsResult, VueNode, WithFalse, WithIfDefault, WithRequired, arraySlice, arrayUnique, blobToDataURL, checkFileType, classNames, cloneDeep, cloneDeepWith, cloneDeepWithImpl, compareArray, compareArraySort, compareArrayTimeSort, compareTime, convertValueBoolean, copyProperties, dataURLtoBlob, dataURLtoFile, deepCopy, deepMerge, easeInOutCubic, fileTypes, filterEmpty, filterTree, findSourceByTree, findValueAndAncestors, forInObject, formatDuration, formatNumber, genColumnKey, generateVideoPicture, getArrayLast, getBase64, getBlobUrl, getFileSuffix, getKeys, getLevelData, getMaxFloor, getMediaInfos, getPrefixCls, getRandomNumber, getScroll, getScrollContainer, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, getSortIndex, getSymbols, getTextWidth, getValueFromObjectByKey, getVideoCoverPicture, getVideoFileUrl, handleCurrentPage, handleEmptyField, handleShowIndex, is, isArray, isBase64, isBoolean, isBrowser, isDataURLBase64, isDeepEqualReact, isEmptyElement, isEqual, isFunction, isImg, isInContainer, isJSONStr, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isScroll, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindow, isWindowsOs, keysOf, merge, mergeWith, nanoid, off, omitBoolean, omitUndefined, omitUndefinedAndEmptyArr, on, wrapperRaf as raf, runFunction, scrollTo, slotRender, toChinesNum, toConvertNumberShow, treeData, useDeepMerge };
+export { AlignType, Base64, BasicTablePageConfig, Breakpoint, CustomRender, DeepPartial, EmptyEmit, EmptyObject, ExtendIfDefined, Fn, LimitDeepPartial, MediaOptions, Nullable, OmitUndefined, PrefixCls, RecordType, RenderNodeFn, RenderResult, ScrollToOptions, SemanticClassNames, SemanticStyles, SizeType, SlotsPropsResult, WithFalse, WithIfDefault, WithRequired, arraySlice, arrayUnique, arrayUniqueBy, blobToDataURL, blobToFile, checkFileType, classNames, cloneDeep, cloneDeepWith, cloneDeepWithImpl, compareArray, compareArraySort, compareArrayTimeSort, compareTime, convertValueBoolean, copyProperties, createUUIDFactory, dataURLtoBlob, dataURLtoFile, deepCopy, deepMerge, easeInOutCubic, fileTypes, filterEmpty, filterTree, findSourceByTree, findValueAndAncestors, forInObject, formatDuration, formatNumber, genColumnKey, generateVideoPicture, getArrayLast, getBase64, getBlobUrl, getFileSuffix, getKeys, getLevelData, getMaxFloor, getMediaInfos, getPrefixCls, getScroll, getScrollContainer, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, getSortIndex, getSymbols, getTextWidth, getValueFromObjectByKey, getVideoCoverPicture, getVideoFileUrl, handleCurrentPage, handleEmptyField, handleShowIndex, is, isArray, isBoolean, isBrowser, isDataURLBase64, isDeepEqual, isDeepEqualReact, isEmptyElement, isEqual, isFunction, isImg, isInContainer, isJSONStr, isMediaDataURI, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isScroll, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindow, isWindowsOs, keysOf, merge, mergeWith, nanoid, off, omitBoolean, omitUndefined, omitUndefinedAndEmptyArr, on, wrapperRaf as raf, runFunction, scrollTo, slotRender, toChinesNum, toConvertNumberShow, treeData, useDeepMerge };

package/dist/index.js

@@ -1,6 +1,6 @@
-import { isBase64, isDataURLBase64 } from "./is/base64.js";
+import { isDataURLBase64, isMediaDataURI } from "./is/base64.js";
 import { isBrowser } from "./is/browser.js";
-import { isDeepEqualReact } from "./is/deepEqual.js";
+import { isDeepEqual, isDeepEqualReact } from "./is/deepEqual.js";
 import { isMobile, isTablet, isWindowsOs } from "./is/device.js";
 import { isEqual } from "./is/equal.js";
 import { isImg } from "./is/img.js";
@@ -14,47 +14,39 @@ import { isTypedArray } from "./is/typedArray.js";
 import { isUnsafeProperty } from "./is/unsafeProperty.js";
 import { isUrl } from "./is/url.js";
 import { convertValueBoolean, isValid } from "./is/valid.js";
-import "./is/index.js";
 import { arraySlice } from "./array/slice.js";
 import { compareArray, compareArraySort, compareArrayTimeSort, compareTime } from "./array/sort.js";
 import { filterTree, findSourceByTree, findValueAndAncestors, getArrayLast, getLevelData, getMaxFloor, getSortIndex, treeData } from "./array/tree.js";
-import { arrayUnique } from "./array/unique.js";
-import "./array/index.js";
+import { arrayUnique, arrayUniqueBy } from "./array/unique.js";
 import { getPrefixCls } from "./class/prefix.js";
 import { cloneDeepWith, cloneDeepWithImpl, copyProperties } from "./clone/cloneDeepWith.js";
 import { cloneDeep } from "./clone/cloneDeep.js";
-import "./clone/index.js";
 import { off, on } from "./dom/event.js";
 import { getTextWidth } from "./dom/measure.js";
-import wrapperRaf from "./dom/raf.js";
-import { easeInOutCubic, getScroll, getScrollContainer, isInContainer, isScroll, isWindow, scrollTo } from "./dom/scroll.js";
-import "./dom/index.js";
 import { fileTypes } from "./file/config.js";
-import { blobToDataURL, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./file/convert.js";
 import { checkFileType, getFileSuffix, getVideoFileUrl } from "./file/type.js";
-import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./file/media.js";
-import "./file/index.js";
+import { generateVideoPicture, getMediaInfos, getVideoCoverPicture } from "./dom/media.js";
+import { wrapperRaf } from "./dom/raf.js";
+import { easeInOutCubic, getScroll, getScrollContainer, isInContainer, isScroll, isWindow, scrollTo } from "./dom/scroll.js";
+import { Base64 } from "./encoding/base64.js";
+import { blobToDataURL, blobToFile, dataURLtoBlob, dataURLtoFile, getBase64, getBlobUrl } from "./file/convert.js";
 import { deepCopy } from "./function/copy.js";
 import { getValueFromObjectByKey } from "./function/getValue.js";
 import { runFunction } from "./function/run.js";
 import { mergeWith } from "./merge/mergeWith.js";
-import { useDeepMerge } from "./merge/useDeepMege.js";
+import { useDeepMerge } from "./merge/deepCloneMerge.js";
 import { deepMerge, merge } from "./merge/index.js";
 import { toChinesNum } from "./number/chinese.js";
 import { formatNumber, toConvertNumberShow } from "./number/format.js";
-import "./number/index.js";
 import classNames from "./object/classNames.js";
 import { omitBoolean } from "./object/omitBoolean.js";
 import { omitUndefined } from "./object/omitUndefined.js";
 import { omitUndefinedAndEmptyArr } from "./object/omitUndefinedAndEmptyArr.js";
-import "./object/index.js";
+import { filterEmpty, getKeys, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, isEmptyElement, slotRender } from "./slots/index.js";
 import { formatDuration } from "./string/duration.js";
 import { handleEmptyField } from "./string/empty.js";
 import { nanoid } from "./string/nanoid.js";
-import { getRandomNumber } from "./string/uuid.js";
+import { createUUIDFactory } from "./string/uuid.js";
 import { genColumnKey, handleShowIndex } from "./table/column.js";
 import { handleCurrentPage } from "./table/page.js";
-import "./table/index.js";
-import { filterEmpty, getKeys, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, isEmptyElement, slotRender } from "./vue/slots.js";
-import "./vue/index.js";
-export { arraySlice, arrayUnique, blobToDataURL, checkFileType, classNames, cloneDeep, cloneDeepWith, cloneDeepWithImpl, compareArray, compareArraySort, compareArrayTimeSort, compareTime, convertValueBoolean, copyProperties, dataURLtoBlob, dataURLtoFile, deepCopy, deepMerge, easeInOutCubic, fileTypes, filterEmpty, filterTree, findSourceByTree, findValueAndAncestors, forInObject, formatDuration, formatNumber, genColumnKey, generateVideoPicture, getArrayLast, getBase64, getBlobUrl, getFileSuffix, getKeys, getLevelData, getMaxFloor, getMediaInfos, getPrefixCls, getRandomNumber, getScroll, getScrollContainer, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, getSortIndex, getSymbols, getTextWidth, getValueFromObjectByKey, getVideoCoverPicture, getVideoFileUrl, handleCurrentPage, handleEmptyField, handleShowIndex, is, isArray, isBase64, isBoolean, isBrowser, isDataURLBase64, isDeepEqualReact, isEmptyElement, isEqual, isFunction, isImg, isInContainer, isJSONStr, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isScroll, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindow, isWindowsOs, keysOf, merge, mergeWith, nanoid, off, omitBoolean, omitUndefined, omitUndefinedAndEmptyArr, on, wrapperRaf as raf, runFunction, scrollTo, slotRender, toChinesNum, toConvertNumberShow, treeData, useDeepMerge };
+export { Base64, arraySlice, arrayUnique, arrayUniqueBy, blobToDataURL, blobToFile, checkFileType, classNames, cloneDeep, cloneDeepWith, cloneDeepWithImpl, compareArray, compareArraySort, compareArrayTimeSort, compareTime, convertValueBoolean, copyProperties, createUUIDFactory, dataURLtoBlob, dataURLtoFile, deepCopy, deepMerge, easeInOutCubic, fileTypes, filterEmpty, filterTree, findSourceByTree, findValueAndAncestors, forInObject, formatDuration, formatNumber, genColumnKey, generateVideoPicture, getArrayLast, getBase64, getBlobUrl, getFileSuffix, getKeys, getLevelData, getMaxFloor, getMediaInfos, getPrefixCls, getScroll, getScrollContainer, getSlot, getSlotVNode, getSlotsChildren, getSlotsProps, getSortIndex, getSymbols, getTextWidth, getValueFromObjectByKey, getVideoCoverPicture, getVideoFileUrl, handleCurrentPage, handleEmptyField, handleShowIndex, is, isArray, isBoolean, isBrowser, isDataURLBase64, isDeepEqual, isDeepEqualReact, isEmptyElement, isEqual, isFunction, isImg, isInContainer, isJSONStr, isMediaDataURI, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isScroll, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindow, isWindowsOs, keysOf, merge, mergeWith, nanoid, off, omitBoolean, omitUndefined, omitUndefinedAndEmptyArr, on, wrapperRaf as raf, runFunction, scrollTo, slotRender, toChinesNum, toConvertNumberShow, treeData, useDeepMerge };

package/dist/is/base64.d.ts

@@ -1,11 +1,14 @@
 //#region src/is/base64.d.ts
 /**
- * 判断是否为 base64 编码的字符串
+ * 判断是否为媒体类型（image/video/audio）的 Data URL（data URI）
+ *
+ * 仅检测媒体类型 Data URL 的前缀（`data:image/`、`data:video/`、`data:audio/`），
+ * 不校验 Base64 编码内容。如需校验完整 Base64 编码，请使用 {@link isDataURLBase64}。
  *
  * @param str - 要判断的字符串
- * @returns 是否为 base64 编码
+ * @returns 是否为媒体类型 Data URL
  */
-declare function isBase64(str?: string): boolean;
+declare function isMediaDataURI(str?: any): boolean;
 /**
  * 判断是否为 Data URL 格式的 base64 字符串
  *
@@ -14,4 +17,4 @@ declare function isBase64(str?: string): boolean;
  */
 declare function isDataURLBase64(str: string): boolean;
 //#endregion
-export { isBase64, isDataURLBase64 };
+export { isDataURLBase64, isMediaDataURI };

package/dist/is/base64.js

@@ -1,16 +1,20 @@
 //#region src/is/base64.ts
 /**
-* 判断是否为 base64 编码的字符串
+* 判断是否为媒体类型（image/video/audio）的 Data URL（data URI）
+*
+* 仅检测媒体类型 Data URL 的前缀（`data:image/`、`data:video/`、`data:audio/`），
+* 不校验 Base64 编码内容。如需校验完整 Base64 编码，请使用 {@link isDataURLBase64}。
 *
 * @param str - 要判断的字符串
-* @returns 是否为 base64 编码
+* @returns 是否为媒体类型 Data URL
 */
-function isBase64(str = "") {
+function isMediaDataURI(str = "") {
+	if (typeof str !== "string") return false;
 	if (str && [
 		"data:image/",
 		"data:video/",
 		"data:audio/"
-	].find((item) => str.includes(item))) return true;
+	].some((item) => str.includes(item))) return true;
 	return false;
 }
 /**
@@ -23,4 +27,4 @@ function isDataURLBase64(str) {
 	return typeof str === "string" && /^data:(?:image|video|audio)\/[A-Za-z]+;base64,[A-Za-z0-9+/=]+$/.test(str);
 }
 //#endregion
-export { isBase64, isDataURLBase64 };
+export { isDataURLBase64, isMediaDataURI };

package/dist/is/browser.js

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

package/dist/is/deepEqual.d.ts

@@ -1,13 +1,19 @@
 //#region src/is/deepEqual.d.ts
 /**
- * React 深度比较
+ * 深度比较两个值是否相等
+ *
+ * 支持数组、Map、Set、TypedArray、RegExp 及普通对象的递归比较。
  *
  * @param a - 第一个值
  * @param b - 第二个值
  * @param ignoreKeys - 忽略的键
- * @param debug - 是否调试
+ * @param debug - 是否调试（打印首个不相等的键）
  * @returns 是否相等
  */
-declare function isDeepEqualReact(a: any, b: any, ignoreKeys?: string[], debug?: boolean): boolean;
+declare function isDeepEqual(a: any, b: any, ignoreKeys?: string[], debug?: boolean): boolean;
+/**
+ * @deprecated 请使用 isDeepEqual，该名称为历史遗留（早期移植自 React 实现）
+ */
+declare const isDeepEqualReact: typeof isDeepEqual;
 //#endregion
-export { isDeepEqualReact };
+export { isDeepEqual, isDeepEqualReact };

package/dist/is/deepEqual.js

@@ -1,14 +1,16 @@
 //#region src/is/deepEqual.ts
 /**
-* React 深度比较
+* 深度比较两个值是否相等
+*
+* 支持数组、Map、Set、TypedArray、RegExp 及普通对象的递归比较。
 *
 * @param a - 第一个值
 * @param b - 第二个值
 * @param ignoreKeys - 忽略的键
-* @param debug - 是否调试
+* @param debug - 是否调试（打印首个不相等的键）
 * @returns 是否相等
 */
-function isDeepEqualReact(a, b, ignoreKeys, debug) {
+function isDeepEqual(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;
@@ -17,13 +19,13 @@ function isDeepEqualReact(a, b, ignoreKeys, debug) {
 		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;
+			for (i = length; i-- !== 0;) if (!isDeepEqual(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;
+			for (i of a.entries()) if (!isDeepEqual(i[1], b.get(i[0]), ignoreKeys, debug)) return false;
 			return true;
 		}
 		if (a instanceof Set && b instanceof Set) {
@@ -43,12 +45,12 @@ function isDeepEqualReact(a, b, ignoreKeys, debug) {
 		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;) if (!Object.hasOwn(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 (!isDeepEqual(a[key], b[key], ignoreKeys, debug)) {
 				if (debug) console.log(key);
 				return false;
 			}
@@ -57,5 +59,9 @@ function isDeepEqualReact(a, b, ignoreKeys, debug) {
 	}
 	return a !== a && b !== b;
 }
+/**
+* @deprecated 请使用 isDeepEqual，该名称为历史遗留（早期移植自 React 实现）
+*/
+const isDeepEqualReact = isDeepEqual;
 //#endregion
-export { isDeepEqualReact };
+export { isDeepEqual, isDeepEqualReact };

package/dist/is/device.js

@@ -5,6 +5,7 @@
 * @returns 是否为移动端
 */
 function isMobile() {
+	if (typeof navigator === "undefined") return false;
 	const userAgent = navigator.userAgent || navigator.vendor;
 	if (/iPhone/.test(userAgent)) return true;
 	if (/Android/.test(userAgent) && /Mobile/.test(userAgent)) return true;
@@ -18,6 +19,7 @@ function isMobile() {
 * @returns 是否为平板
 */
 function isTablet() {
+	if (typeof navigator === "undefined" || typeof document === "undefined") return false;
 	const userAgent = navigator.userAgent || navigator.vendor;
 	if (/iPad/.test(userAgent)) return true;
 	if (/Macintosh/.test(userAgent) && "ontouchend" in document) return true;
@@ -30,6 +32,7 @@ function isTablet() {
 * @returns 是否为 Windows 系统
 */
 function isWindowsOs() {
+	if (typeof navigator === "undefined") return false;
 	return /windows|win32/i.test(navigator.userAgent);
 }
 //#endregion

package/dist/is/index.d.ts

@@ -1,6 +1,6 @@
-import { isBase64, isDataURLBase64 } from "./base64.js";
+import { isDataURLBase64, isMediaDataURI } from "./base64.js";
 import { isBrowser } from "./browser.js";
-import { isDeepEqualReact } from "./deepEqual.js";
+import { isDeepEqual, isDeepEqualReact } from "./deepEqual.js";
 import { isMobile, isTablet, isWindowsOs } from "./device.js";
 import { isEqual } from "./equal.js";
 import { isImg } from "./img.js";
@@ -13,4 +13,4 @@ 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 };
+export { convertValueBoolean, is, isArray, isBoolean, isBrowser, isDataURLBase64, isDeepEqual, isDeepEqualReact, isEqual, isFunction, isImg, isJSONStr, isMediaDataURI, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindowsOs };

package/dist/is/index.js

@@ -1,6 +1,6 @@
-import { isBase64, isDataURLBase64 } from "./base64.js";
+import { isDataURLBase64, isMediaDataURI } from "./base64.js";
 import { isBrowser } from "./browser.js";
-import { isDeepEqualReact } from "./deepEqual.js";
+import { isDeepEqual, isDeepEqualReact } from "./deepEqual.js";
 import { isMobile, isTablet, isWindowsOs } from "./device.js";
 import { isEqual } from "./equal.js";
 import { isImg } from "./img.js";
@@ -13,4 +13,4 @@ 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 };
+export { convertValueBoolean, is, isArray, isBoolean, isBrowser, isDataURLBase64, isDeepEqual, isDeepEqualReact, isEqual, isFunction, isImg, isJSONStr, isMediaDataURI, isMobile, isNil, isNotNil, isNumber, isObject, isObjectWithSymbols, isPlainObject, isPrimitive, isServer, isString, isTablet, isTypedArray, isUnsafeProperty, isUrl, isValid, isWindowsOs };

package/dist/is/plainObject.js

@@ -11,7 +11,7 @@ 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;
+	const ctor = Object.hasOwn(proto, "constructor") && proto.constructor;
 	return typeof ctor === "function" && ctor instanceof ctor && Function.prototype.toString.call(ctor) === Function.prototype.toString.call(Object);
 }
 /**

package/dist/is/url.js

@@ -10,8 +10,7 @@ function isUrl(path) {
 	if (!path.startsWith("http")) return false;
 	try {
 		return !!new URL(path);
-	} catch (_) {
-		console.error("isUrl error", _);
+	} catch {
 		return false;
 	}
 }

package/dist/merge/{useDeepMege.d.ts → deepCloneMerge.d.ts}

@@ -1,4 +1,4 @@
-//#region src/merge/useDeepMege.d.ts
+//#region src/merge/deepCloneMerge.d.ts
 /**
  * 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.
@@ -10,6 +10,8 @@
  *
  * Note that this function does not mutate the target object.
  *
+ * 注意：函数名保留 `use` 前缀为历史命名，本函数是**纯函数**、非 Vue composable，无响应式副作用。
+ *
  * @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.

package/dist/merge/{useDeepMege.js → deepCloneMerge.js}

@@ -1,7 +1,7 @@
 import { isPlainObject } from "../is/plainObject.js";
-import "../is/index.js";
+import { cloneDeep } from "../clone/cloneDeep.js";
 import { mergeWith } from "./mergeWith.js";
-//#region src/merge/useDeepMege.ts
+//#region src/merge/deepCloneMerge.ts
 /**
 * 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.
@@ -13,6 +13,8 @@ import { mergeWith } from "./mergeWith.js";
 *
 * Note that this function does not mutate the target object.
 *
+* 注意：函数名保留 `use` 前缀为历史命名，本函数是**纯函数**、非 Vue composable，无响应式副作用。
+*
 * @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.
@@ -45,7 +47,7 @@ import { mergeWith } from "./mergeWith.js";
 * // Output: { a: [1, 2, 3] }
 */
 function useDeepMerge(target, source) {
-	return mergeWith(target, source, function mergeRecursively(targetValue, sourceValue) {
+	return mergeWith(cloneDeep(target), source, function mergeRecursively(targetValue, sourceValue) {
 		if (isPlainObject(sourceValue)) if (isPlainObject(targetValue)) return mergeWith(targetValue, sourceValue, mergeRecursively);
 		else return mergeWith({}, sourceValue, mergeRecursively);
 	});

package/dist/merge/index.d.ts

@@ -1,4 +1,4 @@
-import { useDeepMerge } from "./useDeepMege.js";
+import { useDeepMerge } from "./deepCloneMerge.js";
 import { mergeWith } from "./mergeWith.js";
 
 //#region src/merge/index.d.ts

package/dist/merge/index.js

@@ -1,9 +1,7 @@
 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";
-import { useDeepMerge } from "./useDeepMege.js";
+import { useDeepMerge } from "./deepCloneMerge.js";
 //#region src/merge/index.ts
 /**
 * 合并多个对象

package/dist/merge/mergeWith.js

@@ -1,6 +1,5 @@
 import { isPlainObject } from "../is/plainObject.js";
 import { isUnsafeProperty } from "../is/unsafeProperty.js";
-import "../is/index.js";
 //#region src/merge/mergeWith.ts
 /**
 * 合并对象（带自定义处理）

package/dist/number/chinese.js

@@ -1,5 +1,4 @@
 import { isNumber } from "../is/type.js";
-import "../is/index.js";
 //#region src/number/chinese.ts
 /**
 * 数字转中文

package/dist/number/format.js

@@ -1,6 +1,6 @@
 import { isNumber } from "../is/type.js";
-import "../is/index.js";
 //#region src/number/format.ts
+const formatNumberRegexCache = /* @__PURE__ */ new Map();
 /**
 * 格式化数字，保留指定小数位
 *
@@ -9,8 +9,11 @@ import "../is/index.js";
 * @returns 格式化后的字符串
 */
 function formatNumber(fixedNum, value) {
-	const regexPattern = `^\\d+(?:\\.\\d{0,${fixedNum}})?`;
-	const match = new RegExp(regexPattern);
+	let match = formatNumberRegexCache.get(fixedNum);
+	if (!match) {
+		match = new RegExp(`^\\d+(?:\\.\\d{0,${fixedNum}})?`);
+		formatNumberRegexCache.set(fixedNum, match);
+	}
 	const result = value.toString().match(match);
 	if (result) {
 		const formattedValue = result[0];

package/dist/object/classNames.js

@@ -1,5 +1,4 @@
 import { isArray, isObject, isString } from "../is/type.js";
-import "../is/index.js";
 //#region src/object/classNames.ts
 /**
 * 类名合并工具