dlzn-ui 1.14.0 → 1.16.0

package/package.json

@@ -58,5 +58,5 @@
     "**/*.css"
   ],
   "type": "module",
-  "version": "1.14.0"
+  "version": "1.16.0"
 }

package/utils/boolean.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description: 判断是否为空值，一般用于表单填写时的判断
+ * @example 0 和 false 是合法值
+ * @example 空格不是合法值
+ */
+export declare function isFalsy(val: any): val is '' | null | undefined;
+/**
+ * @description: 判断是否为有效的数字字符串
+ */
+export declare function isValidNumberString(val: any): val is string;

package/utils/boolean.mjs

@@ -0,0 +1,14 @@
+import { validNumberStringReg as e } from "../const/others.mjs";
+//#region src/utils/boolean.ts
+function t(e) {
+	return [
+		"",
+		null,
+		void 0
+	].includes(e) || typeof e == "string" && e.trim() === "";
+}
+function n(t) {
+	return typeof t == "string" && e.test(t);
+}
+//#endregion
+export { t as isFalsy, n as isValidNumberString };

package/utils/index.d.ts

@@ -1,3 +1,5 @@
+export * from './boolean';
 export * from './number';
 export * from './string';
 export * from './tool';
+export * from './tree';

package/utils/index.mjs

@@ -1,4 +1,6 @@
-import { formatSecondsToChinese as e } from "./number.mjs";
-import { getFilenameFromUrl as t, queryStringToObject as n } from "./string.mjs";
-import { aesDecrypt as r, aesEncrypt as i, saveAs as a } from "./tool.mjs";
-export { r as aesDecrypt, i as aesEncrypt, e as formatSecondsToChinese, t as getFilenameFromUrl, n as queryStringToObject, a as saveAs };
+import { isFalsy as e, isValidNumberString as t } from "./boolean.mjs";
+import { formatNumber as n, formatSecondsToChinese as r } from "./number.mjs";
+import { getFilenameFromUrl as i, queryStringToObject as a, stringDisplay as o } from "./string.mjs";
+import { aesDecrypt as s, aesEncrypt as c, saveAs as l } from "./tool.mjs";
+import { flatArrToTree as u, treeToFlatArr as d } from "./tree.mjs";
+export { s as aesDecrypt, c as aesEncrypt, u as flatArrToTree, n as formatNumber, r as formatSecondsToChinese, i as getFilenameFromUrl, e as isFalsy, t as isValidNumberString, a as queryStringToObject, l as saveAs, o as stringDisplay, d as treeToFlatArr };

package/utils/number.d.ts

@@ -1,7 +1,12 @@
+type FormatNumberConfig = ConstructorParameters<typeof Intl.NumberFormat>[1] & {
+    roundingMode?: 'ceil' | 'expand' | 'floor' | 'halfCeil' | 'halfEven' | 'halfExpand' | 'halfFloor' | 'halfTrunc' | 'trunc';
+    trailingZeroDisplay?: 'auto' | 'stripIfInteger';
+};
+export declare function formatNumber(n: any, config?: FormatNumberConfig): string;
 /**
  * @description: 将秒数转换为中文
  * @param {number} seconds
  * @return {string}
  */
-declare function formatSecondsToChinese(seconds: number): string;
-export { formatSecondsToChinese };
+export declare function formatSecondsToChinese(seconds: number): string;
+export {};

package/utils/number.mjs

@@ -1,5 +1,27 @@
+import { isValidNumberString as e } from "./boolean.mjs";
 //#region src/utils/number.ts
-function e(e) {
+function t(t, n) {
+	if (typeof t != "number" && typeof t != "string" || typeof t == "string" && e(t) === !1 || typeof t == "number" && Number.isFinite(t) === !1) return "";
+	let r = Number(t), i = {
+		currency: "CNY",
+		currencyDisplay: "symbol",
+		localeMatcher: "lookup",
+		maximumFractionDigits: 2,
+		minimumFractionDigits: 0,
+		notation: "standard",
+		numberingSystem: "latn",
+		style: "decimal",
+		trailingZeroDisplay: "stripIfInteger",
+		useGrouping: !0,
+		...n ?? {}
+	};
+	try {
+		return new Intl.NumberFormat("zh-CN", i).format(r);
+	} catch (e) {
+		return console.error(e?.message ?? "格式化数字失败"), String(r);
+	}
+}
+function n(e) {
 	let t = "", n = Math.floor(e / 3600);
 	n > 0 && (t += `${n}时`);
 	let r = Math.floor(e % 3600 / 60);
@@ -8,4 +30,4 @@ function e(e) {
 	return i > 0 && (t += `${i}秒`), t;
 }
 //#endregion
-export { e as formatSecondsToChinese };
+export { t as formatNumber, n as formatSecondsToChinese };

package/utils/string.d.ts

@@ -4,6 +4,11 @@
  * @param {boolean} withExt 是否包含扩展名
  * @return {string}
  */
-declare function getFilenameFromUrl(url: string, withExt?: boolean): string;
-declare function queryStringToObject(queryString: string): Record<string, any>;
-export { getFilenameFromUrl, queryStringToObject };
+export declare function getFilenameFromUrl(url: string, withExt?: boolean): string;
+export declare function queryStringToObject(queryString: string): Record<string, any>;
+/**
+ * @description: 将值转换为字符串，如果值为 null 或 undefined，则返回空字符串
+ * @example String(123n) -> '123' BigInt
+ * @return {string}
+ */
+export declare function stringDisplay(val: any): string;

package/utils/string.mjs

@@ -10,5 +10,8 @@ function e(e, t = !1) {
 function t(e) {
 	return Object.fromEntries(new URLSearchParams(e));
 }
+function n(e) {
+	return [null, void 0].includes(e) ? "" : String(e);
+}
 //#endregion
-export { e as getFilenameFromUrl, t as queryStringToObject };
+export { e as getFilenameFromUrl, t as queryStringToObject, n as stringDisplay };

package/utils/tool.d.ts

@@ -1,5 +1,4 @@
 import { default as FileSaver } from 'file-saver';
-declare function aesDecrypt(word: string, keyWord: string): Promise<string>;
-declare function aesEncrypt(word: string, keyWord: string): Promise<string>;
-declare function saveAs(arg1: Parameters<typeof FileSaver.saveAs>[0], arg2?: Parameters<typeof FileSaver.saveAs>[1], arg3?: FileSaver.FileSaverOptions): Promise<void>;
-export { aesDecrypt, aesEncrypt, saveAs };
+export declare function aesDecrypt(word: string, keyWord: string): Promise<string>;
+export declare function aesEncrypt(word: string, keyWord: string): Promise<string>;
+export declare function saveAs(arg1: Parameters<typeof FileSaver.saveAs>[0], arg2?: Parameters<typeof FileSaver.saveAs>[1], arg3?: FileSaver.FileSaverOptions): Promise<void>;

package/utils/tree.d.ts

@@ -0,0 +1,26 @@
+interface TreeNode {
+    [key: string]: any;
+    children?: TreeNode[];
+}
+/**
+ * 将扁平数组转换为树形结构
+ * @param data 扁平数据数组
+ * @param options 配置选项
+ * @param options.childrenKey 子节点键名
+ * @param options.idKey 节点ID键名
+ * @param options.parentKey 节点父ID键名
+ * @param options.rootParentId 根节点ID键名
+ * @returns 树形结构数组
+ */
+export declare function flatArrToTree(data: Record<string, any>[], options?: {
+    childrenKey?: string;
+    idKey?: string;
+    parentKey?: string;
+    rootParentId?: null | string;
+}): TreeNode[];
+export declare function treeToFlatArr(tree: TreeNode[], options?: {
+    idKey?: string;
+    includeLevel?: boolean;
+    includeParent?: boolean;
+}): Record<string, any>[];
+export {};

package/utils/tree.mjs

@@ -0,0 +1,36 @@
+//#region src/utils/tree.ts
+function e(e, t = {}) {
+	let { childrenKey: n = "children", idKey: r = "id", parentKey: i = "parentId", rootParentId: a = null } = t;
+	if (!Array.isArray(e)) throw TypeError("flatArrToTree: 输入参数 data 必须是数组");
+	if (e.length === 0) return [];
+	let o = [], s = /* @__PURE__ */ new Map();
+	for (let t of e) {
+		let e = t[r];
+		if (e == null) {
+			console.warn(`flatArrToTree: 数据项缺少 ${r} 属性`, t);
+			continue;
+		}
+		let n = {
+			...t,
+			children: []
+		};
+		s.has(e) && console.warn(`flatArrToTree: 检测到重复的 ${r}: ${e}`), s.set(e, n);
+	}
+	for (let [e, t] of s) {
+		let e = t[i];
+		e == null || e === a || !s.has(e) ? o.push(t) : s.get(e)[n].push(t);
+	}
+	return o;
+}
+function t(e, t) {
+	let { idKey: n = "id", includeLevel: r = !1, includeParent: i = !1 } = t ?? {}, a = [];
+	function o(e, t = 0, s = null) {
+		Array.isArray(e) && e.forEach((e) => {
+			let { children: c, ...l } = e;
+			r && (l.level = t), i && (l.parentId = s), a.push(l), Array.isArray(c) && o(c, t + 1, e[n]);
+		});
+	}
+	return o(e), a;
+}
+//#endregion
+export { e as flatArrToTree, t as treeToFlatArr };