befly-admin-ui 1.8.14

package/utils/arrayToTree.js

@@ -0,0 +1,115 @@
+/**
+ * 将一维数组按 { id, pid } 组装为树形结构（纯函数 / 无副作用）。
+ *
+ * - 默认字段：id / pid / children / sort
+ * - pid 为空字符串或父节点不存在时，视为根节点
+ * - 内部会 clone 一份节点对象，并写入 children: []
+ * - 默认自带递归排序：按 sort 升序；sort 缺省/非法或 < 1 视为 999999；sort 相同按 id 自然序
+ */
+export function arrayToTree(items, id = "id", pid = "pid", children = "children", sort = "sort") {
+    const idKey = typeof id === "string" && id.length > 0 ? id : "id";
+    const pidKey = typeof pid === "string" && pid.length > 0 ? pid : "pid";
+    const childrenKey = typeof children === "string" && children.length > 0 ? children : "children";
+    const sortKey = typeof sort === "string" && sort.length > 0 ? sort : "sort";
+    const map = new Map();
+    const flat = [];
+    const safeItems = Array.isArray(items) ? items : [];
+    const normalizeKey = (value) => {
+        if (typeof value === "string") {
+            return value;
+        }
+        if (typeof value === "number" && Number.isFinite(value)) {
+            return String(value);
+        }
+        return "";
+    };
+    for (const item of safeItems) {
+        const itemObj = typeof item === "object" && item !== null ? item : null;
+        const rawId = itemObj ? itemObj[idKey] : undefined;
+        const rawPid = itemObj ? itemObj[pidKey] : undefined;
+        const normalizedId = normalizeKey(rawId);
+        const normalizedPid = normalizeKey(rawPid);
+        const nextNode = Object.assign({}, item);
+        const nextNodeObj = nextNode;
+        nextNodeObj[idKey] = normalizedId;
+        nextNodeObj[pidKey] = normalizedPid;
+        nextNodeObj[childrenKey] = [];
+        flat.push(nextNode);
+        if (normalizedId.length > 0) {
+            map.set(normalizedId, nextNode);
+        }
+    }
+    const tree = [];
+    for (const node of flat) {
+        const nodeObj = node;
+        const selfId = normalizeKey(nodeObj[idKey]);
+        const parentId = normalizeKey(nodeObj[pidKey]);
+        if (parentId.length > 0 && parentId !== selfId) {
+            const parent = map.get(parentId);
+            if (parent) {
+                const parentObj = parent;
+                const childrenValue = parentObj[childrenKey];
+                if (Array.isArray(childrenValue)) {
+                    childrenValue.push(node);
+                    continue;
+                }
+            }
+        }
+        tree.push(node);
+    }
+    const collator = new Intl.Collator(undefined, { numeric: true, sensitivity: "base" });
+    const getSortValue = (node) => {
+        const nodeObj = node;
+        const raw = nodeObj[sortKey];
+        if (typeof raw !== "number") {
+            return 999999;
+        }
+        if (!Number.isFinite(raw)) {
+            return 999999;
+        }
+        if (raw < 1) {
+            return 999999;
+        }
+        return raw;
+    };
+    const compareNode = (a, b) => {
+        const aSort = getSortValue(a);
+        const bSort = getSortValue(b);
+        if (aSort !== bSort) {
+            return aSort - bSort;
+        }
+        const aObj = a;
+        const bObj = b;
+        const aId = aObj[idKey];
+        const bId = bObj[idKey];
+        return collator.compare(typeof aId === "string" ? aId : "", typeof bId === "string" ? bId : "");
+    };
+    const sortTreeInPlace = (nodes, seen) => {
+        if (!Array.isArray(nodes)) {
+            return;
+        }
+        if (nodes.length > 1) {
+            nodes.sort(compareNode);
+        }
+        for (const node of nodes) {
+            if (typeof node !== "object" || node === null) {
+                continue;
+            }
+            if (seen.has(node)) {
+                continue;
+            }
+            seen.add(node);
+            const nodeObj = node;
+            const childNodes = nodeObj[childrenKey];
+            if (Array.isArray(childNodes) && childNodes.length > 0) {
+                sortTreeInPlace(childNodes, seen);
+            }
+        }
+    };
+    sortTreeInPlace(tree, new WeakSet());
+    return {
+        flat: flat,
+        tree: tree,
+        map: map
+    };
+}

package/utils/cleanParams.js

@@ -0,0 +1,29 @@
+export function cleanParams(data, dropValues, dropKeyValue) {
+    const globalDropValues = dropValues ?? [];
+    const perKeyDropValues = dropKeyValue ?? {};
+    const globalDropSet = new Set(globalDropValues);
+    const out = {};
+    for (const key of Object.keys(data)) {
+        const value = data[key];
+        // 默认强制移除 null / undefined
+        if (value === null || value === undefined) {
+            continue;
+        }
+        // 如果该 key 配了规则：以 key 规则为准，不再应用全局 dropValues
+        if (Object.hasOwn(perKeyDropValues, key)) {
+            const keyDropValues = perKeyDropValues[key] ?? [];
+            const keyDropSet = new Set(keyDropValues);
+            if (keyDropSet.has(value)) {
+                continue;
+            }
+            out[key] = value;
+            continue;
+        }
+        // 未配置 key 规则：应用全局 dropValues
+        if (globalDropSet.has(value)) {
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}

package/utils/fieldClear.js

@@ -0,0 +1,62 @@
+function isObject(val) {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+function isArray(val) {
+    return Array.isArray(val);
+}
+export function fieldClear(data, options = {}) {
+    const pickKeys = options.pickKeys;
+    const omitKeys = options.omitKeys;
+    const keepValues = options.keepValues;
+    const excludeValues = options.excludeValues;
+    const keepMap = options.keepMap;
+    const filterObj = (obj) => {
+        const result = {};
+        let keys = Object.keys(obj);
+        if (pickKeys && pickKeys.length) {
+            keys = keys.filter((k) => pickKeys.includes(k));
+        }
+        if (omitKeys && omitKeys.length) {
+            keys = keys.filter((k) => !omitKeys.includes(k));
+        }
+        for (const key of keys) {
+            const value = obj[key];
+            // 1. keepMap 优先
+            if (keepMap && Object.hasOwn(keepMap, key)) {
+                if (Object.is(keepMap[key], value)) {
+                    result[key] = value;
+                    continue;
+                }
+            }
+            // 2. keepValues
+            if (keepValues && keepValues.length && !keepValues.includes(value)) {
+                continue;
+            }
+            // 3. excludeValues
+            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
+                continue;
+            }
+            result[key] = value;
+        }
+        return result;
+    };
+    if (isArray(data)) {
+        return data
+            .map((item) => {
+                if (isObject(item)) {
+                    return filterObj(item);
+                }
+                return item;
+            })
+            .filter((item) => {
+                if (isObject(item)) {
+                    return Object.keys(item).length > 0;
+                }
+                return true;
+            });
+    }
+    if (isObject(data)) {
+        return filterObj(data);
+    }
+    return data;
+}

package/utils/genShortId.js

@@ -0,0 +1,12 @@
+/**
+ * 生成短 ID
+ * 由时间戳（base36）+ 随机字符组成，约 13 位
+ * - 前 8 位：时间戳（可排序）
+ * - 后 5 位：随机字符（防冲突）
+ * @returns 短 ID 字符串
+ * @example
+ * genShortId() // "lxyz1a2b3c4"
+ */
+export function genShortId() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 7);
+}

package/utils/hashPassword.js

@@ -0,0 +1,9 @@
+/**
+ * 前端密码 sha256（浏览器侧）
+ */
+export async function hashPassword(password) {
+    const dataBuffer = new TextEncoder().encode(password);
+    const hashBuffer = await crypto.subtle.digest("SHA-256", dataBuffer);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((item) => item.toString(16).padStart(2, "0")).join("");
+}

package/utils/scanViewsDir.js

@@ -0,0 +1,120 @@
+/**
+ * 清理目录名中的数字后缀
+ * 如：login_1 → login, index_2 → index
+ */
+export function cleanDirName(name) {
+    return name.replace(/_\d+$/, "");
+}
+/**
+ * 约束：统一 path 形态，避免隐藏菜单匹配、DB 同步出现重复
+ * - 必须以 / 开头
+ * - 折叠多个 /
+ * - 去掉尾随 /（根 / 除外）
+ */
+export function normalizeMenuPath(path) {
+    let result = path;
+    if (!result) {
+        return "/";
+    }
+    if (!result.startsWith("/")) {
+        result = `/${result}`;
+    }
+    result = result.replace(/\/+?/g, "/");
+    if (result.length > 1) {
+        result = result.replace(/\/+$/, "");
+    }
+    return result;
+}
+/**
+ * 递归规范化并按 path 去重（同 path 的 children 合并）
+ *
+ * 说明：该函数是纯函数，不依赖任何运行时环境；会返回新数组，但会在内部对克隆对象做合并赋值。
+ */
+export function normalizeMenuTree(menus) {
+    const map = new Map();
+    for (const menu of menus) {
+        const rawPath = menu.path;
+        const menuPath = rawPath ? normalizeMenuPath(rawPath) : "";
+        if (!menuPath) {
+            continue;
+        }
+        // 不使用 structuredClone：
+        // - 结构中可能出现函数/类实例等不可 clone 的值
+        // - 这里我们只需要“保留额外字段 + 递归 children 生成新数组”
+        // 用浅拷贝即可满足需求
+        const cloned = Object.assign({}, menu);
+        cloned.path = menuPath;
+        const rawChildren = menu.children;
+        if (rawChildren && rawChildren.length > 0) {
+            cloned.children = normalizeMenuTree(rawChildren);
+        }
+        const existing = map.get(menuPath);
+        if (existing) {
+            const clonedChildren = cloned.children;
+            if (clonedChildren && clonedChildren.length > 0) {
+                let existingChildren = existing.children;
+                if (!existingChildren) {
+                    existingChildren = [];
+                    existing.children = existingChildren;
+                }
+                for (const child of clonedChildren) {
+                    existingChildren.push(child);
+                }
+                existing.children = normalizeMenuTree(existingChildren);
+            }
+            if (typeof cloned.sort === "number") {
+                existing.sort = cloned.sort;
+            }
+            if (typeof cloned.name === "string" && cloned.name) {
+                existing.name = cloned.name;
+            }
+        } else {
+            map.set(menuPath, cloned);
+        }
+    }
+    const result = Array.from(map.values());
+    result.sort((a, b) => (a.sort ?? 999999) - (b.sort ?? 999999));
+    return result;
+}
+/**
+ * 只取第一个 <script ... setup ...> 块
+ */
+export function extractScriptSetupBlock(vueContent) {
+    const openTag = /<script\b[^>]*\bsetup\b[^>]*>/i.exec(vueContent);
+    if (!openTag) {
+        return null;
+    }
+    const start = openTag.index + openTag[0].length;
+    const closeIndex = vueContent.indexOf("</script>", start);
+    if (closeIndex < 0) {
+        return null;
+    }
+    return vueContent.slice(start, closeIndex);
+}
+/**
+ * 从 <script setup> 中提取 definePage({ meta })
+ *
+ * 简化约束：
+ * - 每个页面只有一个 definePage
+ * - title 是纯字符串字面量
+ * - order 是数字字面量（可选）
+ * - 不考虑变量/表达式/多段 meta 组合
+ */
+export function extractDefinePageMetaFromScriptSetup(scriptSetup) {
+    const titleMatch = scriptSetup.match(/definePage\s*\([\s\S]*?meta\s*:\s*\{[\s\S]*?title\s*:\s*(["'`])([^"'`]+)\1/);
+    if (!titleMatch) {
+        return null;
+    }
+    const title = titleMatch[2];
+    if (typeof title !== "string") {
+        return null;
+    }
+    const orderMatch = scriptSetup.match(/definePage\s*\([\s\S]*?meta\s*:\s*\{[\s\S]*?order\s*:\s*(\d+)/);
+    if (!orderMatch) {
+        return { title: title };
+    }
+    return {
+        title: title,
+        order: Number(orderMatch[1])
+    };
+}

package/utils/withDefaultColumns.js

@@ -0,0 +1,46 @@
+/**
+ * 为表格列添加默认配置（纯函数）。
+ *
+ * 默认行为：
+ * - base 默认：{ width: 200, ellipsis: true }
+ * - 特殊列：operation/state/id
+ * - colKey 以 At/At2 结尾时：默认 { align: "center" }
+ * - customConfig 可覆盖/扩展默认 specialColumnConfig
+ */
+export function withDefaultColumns(columns, customConfig) {
+    const safeColumns = Array.isArray(columns) ? columns : [];
+    const specialColumnConfig = Object.assign(
+        {
+            operation: { width: 100, align: "center", fixed: "right" },
+            sort: { width: 80, align: "center" },
+            state: { width: 100, align: "center" },
+            result: { width: 80, align: "center" },
+            duration: { width: 100, align: "center" },
+            createTime: { width: 170, align: "center" },
+            updateTime: { width: 170, align: "center" },
+            operateTime: { width: 170, align: "center" },
+            createdAt: { width: 170, align: "center" },
+            updatedAt: { width: 170, align: "center" },
+            id: { width: 200, align: "center" }
+        },
+        customConfig || {}
+    );
+    return safeColumns.map((col) => {
+        const colObj = typeof col === "object" && col !== null ? col : {};
+        const colKey = typeof colObj["colKey"] === "string" ? colObj["colKey"] : undefined;
+        let specialConfig = colKey ? specialColumnConfig[colKey] : undefined;
+        if (!specialConfig && typeof colKey === "string" && (colKey.endsWith("At") || colKey.endsWith("At2"))) {
+            specialConfig = { align: "center" };
+        }
+        const base = {
+            width: 200,
+            ellipsis: true
+        };
+        const merged = Object.assign({}, base);
+        if (specialConfig) {
+            Object.assign(merged, specialConfig);
+        }
+        Object.assign(merged, colObj);
+        return merged;
+    });
+}

package/views/config/dict/components/edit.vue

@@ -0,0 +1,120 @@
+<template>
+    <PageDialog v-model="visible" :title="actionType === 'add' ? '添加字典项' : '编辑字典项'" @confirm="handleSubmit">
+        <TForm :data="$Data.formData" :rules="$Data.rules" label-width="100px" ref="formRef">
+            <TFormItem label="字典类型" name="typeCode">
+                <TSelect v-model="$Data.formData.typeCode" placeholder="请选择字典类型" filterable>
+                    <TOption v-for="item in typeList" :key="item.code" :value="item.code" :label="item.name" />
+                </TSelect>
+            </TFormItem>
+            <TFormItem label="键值" name="key">
+                <TInput v-model="$Data.formData.key" placeholder="请输入键名（英文/数字/下划线）" />
+            </TFormItem>
+            <TFormItem label="标签" name="label">
+                <TInput v-model="$Data.formData.label" placeholder="请输入标签（显示名称）" />
+            </TFormItem>
+            <TFormItem label="排序" name="sort">
+                <TInputNumber v-model="$Data.formData.sort" :min="0" placeholder="请输入排序值" />
+            </TFormItem>
+            <TFormItem label="备注" name="remark">
+                <TTextarea v-model="$Data.formData.remark" placeholder="请输入备注信息" :autosize="{ minRows: 3, maxRows: 6 }" />
+            </TFormItem>
+        </TForm>
+    </PageDialog>
+</template>
+
+<script setup lang="ts">
+import { computed, reactive, ref } from "vue";
+
+import { Form as TForm, FormItem as TFormItem, Input as TInput, Select as TSelect, Option as TOption, Textarea as TTextarea, InputNumber as TInputNumber, MessagePlugin } from "tdesign-vue-next";
+import PageDialog from "@/components/pageDialog.vue";
+import { $Http } from "@/plugins/http";
+
+const props = defineProps({
+    modelValue: Boolean,
+    actionType: String,
+    rowData: Object,
+    typeList: Array
+});
+
+const $Emit = defineEmits<{
+    (e: "update:modelValue", value: boolean): void;
+    (e: "success"): void;
+}>();
+
+const visible = computed({
+    get: () => props.modelValue,
+    set: (val) => $Emit("update:modelValue", val)
+});
+
+type TDesignFormInstance = {
+    validate: () => Promise<unknown>;
+};
+
+const formRef = ref<TDesignFormInstance | null>(null);
+
+const $Data = reactive({
+    formData: {
+        typeCode: "",
+        key: "",
+        label: "",
+        sort: 0,
+        remark: ""
+    },
+    rules: {
+        typeCode: [{ required: true, message: "请选择字典类型" }],
+        key: [{ required: true, message: "请输入键值" }],
+        label: [{ required: true, message: "请输入标签" }]
+    }
+});
+
+async function handleSubmit(): Promise<void> {
+    try {
+        const form = formRef.value;
+        if (!form) {
+            MessagePlugin.warning("表单未就绪");
+            return;
+        }
+
+        const valid = await form.validate();
+        if (valid !== true) return;
+        const apiUrl = props.actionType === "add" ? "/core/dict/ins" : "/core/dict/upd";
+        const params: Record<string, unknown> = {
+            typeCode: $Data.formData.typeCode,
+            key: $Data.formData.key,
+            label: $Data.formData.label,
+            sort: $Data.formData.sort,
+            remark: $Data.formData.remark
+        };
+        if (props.actionType === "upd" && props.rowData) {
+            const row = props.rowData as Record<string, unknown>;
+            params["id"] = row["id"];
+        }
+
+        const res = await $Http.post(apiUrl, params);
+        if (res.code === 0) {
+            MessagePlugin.success(props.actionType === "add" ? "添加成功" : "更新成功");
+            visible.value = false;
+            $Emit("success");
+        } else {
+            MessagePlugin.error(res.msg || "操作失败");
+        }
+    } catch (_error) {
+        MessagePlugin.error("操作失败");
+    }
+}
+
+// 该组件由父组件 v-if 控制挂载/卸载，因此无需 watch：创建时初始化一次即可
+if (props.actionType === "upd" && props.rowData) {
+    $Data.formData.typeCode = props.rowData.typeCode || "";
+    $Data.formData.key = props.rowData.key || "";
+    $Data.formData.label = props.rowData.label || "";
+    $Data.formData.sort = props.rowData.sort || 0;
+    $Data.formData.remark = props.rowData.remark || "";
+} else {
+    $Data.formData.typeCode = "";
+    $Data.formData.key = "";
+    $Data.formData.label = "";
+    $Data.formData.sort = 0;
+    $Data.formData.remark = "";
+}
+</script>