befly-vite 1.2.9 → 1.2.11

package/README.md

@@ -5,7 +5,7 @@ Befly Vite 配置预设和插件集合，专为 Vue 3 项目优化。
 ## 特性
 
 - ✅ 开箱即用的 Vite + Vue 3 配置
-- ✅ 集成常用插件（路由、自动导入、图标、UnoCSS 等）
+- ✅ 集成常用插件（路由、自动导入、图标等）
 - ✅ 优化的构建配置（分包、压缩、分析）
 - ✅ 支持自定义扩展
 
@@ -35,8 +35,11 @@ import { fileURLToPath } from "node:url";
 export default createBeflyViteConfig({
     root: fileURLToPath(new URL(".", import.meta.url)),
 
+    // 说明：项目 views 固定扫描 "src/views"；如需扫描 addon 内的视图目录，可配置 addonView（单级目录名）
+    // addonView: "adminViews",
+
     // 自定义配置
-    userConfig: {
+    viteConfig: {
         server: {
             port: 5600
         }

package/{utils/layouts.js → index.browser.js}

@@ -1,9 +1,5 @@
 /**
- * 自定义布局处理函数
- * 根据文件名后缀 _数字 判断使用哪个布局
- */
-
-/**
+ * auto-routes 的 route 结构（我们只依赖以下字段）。
  * @typedef {Object} RouteConfig
  * @property {string=} path
  * @property {any=} component
@@ -12,6 +8,7 @@
  */
 
 /**
+ * 内部扁平结构：一条“最终路由 path + 选用布局 + 页面组件”。
  * @typedef {Object} LayoutConfig
  * @property {string} path
  * @property {string} layoutName
@@ -20,11 +17,15 @@
  */
 
 /**
+ * 内部实现：根据文件名后缀 _数字 判断使用哪个布局，输出扁平布局配置。
+ *
+ * 注意：该函数仅供 befly-vite 包内部使用，不作为对外 API。
+ *
  * @param {RouteConfig[]} routes
  * @param {string=} inheritLayout
  * @returns {LayoutConfig[]}
  */
-export function Layouts(routes, inheritLayout = "") {
+function buildLayoutConfigs(routes, inheritLayout = "") {
     /** @type {LayoutConfig[]} */
     const result = [];
 
@@ -37,7 +38,7 @@ export function Layouts(routes, inheritLayout = "") {
         // 中间节点：递归处理子路由，不包裹布局
         if (route.children && route.children.length > 0) {
             const cleanPath = pathMatch ? currentPath.replace(/_\d+$/, "") : currentPath;
-            const childConfigs = Layouts(route.children, currentLayout);
+            const childConfigs = buildLayoutConfigs(route.children, currentLayout);
 
             for (const child of childConfigs) {
                 const mergedPath = cleanPath ? `${cleanPath}/${child.path}`.replace(/\/+/, "/") : child.path;
@@ -77,14 +78,23 @@ export function Layouts(routes, inheritLayout = "") {
 }
 
 /**
- * 将 Layouts 输出的扁平配置转换为 Vue Router 的 RouteRecordRaw
- * 说明：resolveLayoutComponent 由业务方提供，以避免 utils 强耦合具体项目的布局路径。
+ * 将 auto-routes 的 routes 按 `_数字` 规则套用布局组件，并输出 Vue Router 的 RouteRecordRaw[]。
  *
- * @param {LayoutConfig[]} configs
+ * @param {any[]} routes
  * @param {(layoutName: string) => any} resolveLayoutComponent
  * @returns {import('vue-router').RouteRecordRaw[]}
  */
-export function applyLayouts(configs, resolveLayoutComponent) {
+export function Layouts(routes, resolveLayoutComponent) {
+    if (!Array.isArray(routes)) {
+        throw new Error("Layouts(routes, resolveLayoutComponent) 中 routes 必须是数组。");
+    }
+
+    if (typeof resolveLayoutComponent !== "function") {
+        throw new Error("Layouts(routes, resolveLayoutComponent) 中 resolveLayoutComponent 必须是函数。");
+    }
+
+    const configs = buildLayoutConfigs(routes);
+
     return configs.map((config) => {
         const layoutComponent = resolveLayoutComponent(config.layoutName);
 

package/index.js

@@ -1,3 +1,5 @@
+import { existsSync, readdirSync, realpathSync } from "node:fs";
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { defineConfig, mergeConfig } from "vite";
@@ -5,12 +7,10 @@ import { defineConfig, mergeConfig } from "vite";
 import { createAnalyzerPlugin } from "./plugins/analyzer.js";
 import { createAutoImportPlugin } from "./plugins/auto-import.js";
 import { createComponentsPlugin } from "./plugins/components.js";
-import { createCompressionPlugin } from "./plugins/compression.js";
 import { createDevToolsPlugin } from "./plugins/devtools.js";
 import { createIconsPlugin } from "./plugins/icons.js";
 import { createReactivityTransformPlugin } from "./plugins/reactivity-transform.js";
 import { createRouterPlugin } from "./plugins/router.js";
-import { createUnoCSSPlugin } from "./plugins/unocss.js";
 import { createVuePlugin } from "./plugins/vue.js";
 
 /**
@@ -66,48 +66,60 @@ function defaultManualChunks(id) {
         return "vue-macros";
     }
 
-    // befly-addon（必须在 Vue 判断之后）
-    if (id.includes("@befly-addon/") || id.includes("packages/addonAdmin/") || id.includes("packages\\addonAdmin\\")) {
-        return "befly-addon";
-    }
-
-    // 其他 node_modules 依赖
-    if (id.includes("node_modules/")) {
-        return "vendor";
-    }
+    // 注意：不要把所有 addon 或 node_modules 强制合并到单个 chunk。
+    // - addon 路由（importMode: async）应按页面懒加载自然拆分。
+    // - node_modules 让 Rollup 按共享与动态导入边界自动拆分即可。
+    // 如需进一步细分，可通过 createBeflyViteConfig({ manualChunks }) 注入自定义策略。
 }
 
 /**
  * 创建 Befly Vite 配置
  * @param {Object} options - 配置选项
  * @param {string} options.root - 项目根目录（可选）
- * @param {Function} options.scanViews - 扫描视图函数（可选）
+ * @param {string} options.addonView - addon 内要扫描的视图目录名（可选，默认 "adminViews"）
  * @param {Object} options.resolvers - 自定义 resolvers（可选）
  * @param {Function} options.manualChunks - 自定义分包配置（可选）
- * @param {Object} options.userConfig - 用户自定义配置（可选）
+ * @param {Object} options.viteConfig - 用户自定义配置（可选）
  * @returns {Object} Vite 配置对象
  */
 export function createBeflyViteConfig(options = {}) {
-    const { root, scanViews, resolvers = {}, manualChunks, userConfig = {} } = options;
+    const { root, addonView = "adminViews", resolvers = {}, manualChunks, viteConfig = {} } = options;
 
     // 计算根目录（如果未提供）
     const appRoot = root || process.cwd();
 
+    if (typeof addonView !== "string") {
+        throw new Error('createBeflyViteConfig({ addonView }) 中 addonView 必须是字符串目录名。\n例如：addonView: "adminViews"');
+    }
+
+    if (addonView.trim() !== addonView) {
+        throw new Error('createBeflyViteConfig({ addonView }) 中 addonView 不能包含首尾空格。\n例如：addonView: "adminViews"');
+    }
+
+    if (!addonView) {
+        throw new Error('createBeflyViteConfig({ addonView }) 中 addonView 不能为空。\n例如：addonView: "adminViews"');
+    }
+
+    // 只能是单级目录名：禁止多级路径与路径穿越
+    if (addonView === "." || addonView === ".." || addonView.includes("/") || addonView.includes("\\") || addonView.includes("..") || addonView.includes("\0")) {
+        throw new Error('createBeflyViteConfig({ addonView }) 中 addonView 必须是单级目录名（不能是多级路径）。\n例如：addonView: "adminViews"');
+    }
+
+    const routesFolders = scanViewsInternal(appRoot, addonView);
+
     const baseConfig = defineConfig({
         base: "./",
 
         plugins: [
             //
-            createUnoCSSPlugin(),
-            createRouterPlugin({ scanViews: scanViews }),
+            createRouterPlugin({ routesFolders: routesFolders }),
             createVuePlugin(),
             createReactivityTransformPlugin(),
             createDevToolsPlugin(),
             createAutoImportPlugin({ resolvers: resolvers }),
             createComponentsPlugin({ resolvers: resolvers }),
             createIconsPlugin(),
-            createAnalyzerPlugin(),
-            createCompressionPlugin()
+            createAnalyzerPlugin()
         ],
 
         resolve: {
@@ -153,5 +165,57 @@ export function createBeflyViteConfig(options = {}) {
         }
     });
 
-    return mergeConfig(baseConfig, userConfig);
+    return mergeConfig(baseConfig, viteConfig);
+}
+
+/**
+ * 内部实现：扫描项目和所有 @befly-addon 包的视图目录
+ * @param {string} appRoot
+ * @param {string} addonView
+ * @returns {Array<{ src: string, path: string, exclude: string[] }>}
+ */
+function scanViewsInternal(appRoot, addonView = "adminViews") {
+    const addonBasePath = join(appRoot, "node_modules", "@befly-addon");
+
+    /** @type {Array<{ src: string, path: string, exclude: string[] }>} */
+    const routesFolders = [];
+
+    // 1. 项目自身 views
+    const appViewsPath = join(appRoot, "src", "views");
+    if (existsSync(appViewsPath)) {
+        routesFolders.push({
+            src: realpathSync(appViewsPath),
+            path: "",
+            exclude: ["**/components/**"]
+        });
+    }
+
+    // 2. 扫描 @befly-addon/*/<addonView>（仅此目录允许生成 addon 路由）
+    if (!existsSync(addonBasePath)) {
+        return routesFolders;
+    }
+
+    try {
+        const addonDirs = readdirSync(addonBasePath);
+
+        for (const addonName of addonDirs) {
+            const addonPath = join(addonBasePath, addonName);
+            if (!existsSync(addonPath)) {
+                continue;
+            }
+
+            const addonViewPath = join(addonPath, addonView);
+            if (existsSync(addonViewPath)) {
+                routesFolders.push({
+                    src: realpathSync(addonViewPath),
+                    path: `addon/${addonName}/`,
+                    exclude: ["**/components/**"]
+                });
+            }
+        }
+    } catch {
+        // 扫描失败保持静默，避免影响 Vite 启动
+    }
+
+    return routesFolders;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly-vite",
-    "version": "1.2.9",
-    "gitHead": "b2a7116ecbf488ef3e7e74c5cb1da1ff33a64f2c",
+    "version": "1.2.11",
+    "gitHead": "f5d17c019a58e82cfacec5ce3a1f04e3225ba838",
     "private": false,
     "description": "Befly Vite 配置预设和插件集合",
     "keywords": [
@@ -15,41 +15,34 @@
     "license": "Apache-2.0",
     "author": "chensuiyi <bimostyle@qq.com>",
     "files": [
+        "index.browser.js",
         "index.js",
         "package.json",
         "README.md",
-        "bin/",
-        "configs/",
-        "plugins/",
-        "utils/"
+        "plugins/"
     ],
     "type": "module",
-    "main": "index.js",
     "exports": {
-        ".": "./index.js",
-        "./utils/*": "./utils/*.js"
+        ".": {
+            "browser": "./index.browser.js",
+            "import": "./index.js",
+            "default": "./index.js"
+        }
     },
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org"
     },
-    "scripts": {
-        "scanViewsDir": "bun ./bin/scanViewsDir.ts"
-    },
     "dependencies": {
-        "@unocss/preset-attributify": "^66.5.11",
-        "@unocss/preset-uno": "^66.5.11",
         "@vitejs/plugin-vue": "^6.0.3",
         "@vue-macros/reactivity-transform": "^3.1.1",
-        "befly-shared": "^1.3.8",
+        "befly-shared": "^1.3.9",
         "sass": "^1.97.1",
-        "unocss": "^66.5.11",
         "unplugin-auto-import": "^20.3.0",
         "unplugin-icons": "^22.5.0",
         "unplugin-vue-components": "^30.0.0",
-        "unplugin-vue-router": "^0.19.0",
+        "unplugin-vue-router": "^0.19.2",
         "vite-bundle-analyzer": "^1.3.1",
-        "vite-plugin-compression2": "^2.4.0",
         "vite-plugin-vue-devtools": "^8.0.5"
     },
     "peerDependencies": {

package/plugins/router.js

@@ -4,10 +4,10 @@ import VueRouter from "unplugin-vue-router/vite";
  * 创建路由插件配置
  */
 export function createRouterPlugin(options = {}) {
-    const { scanViews } = options;
+    const { routesFolders } = options;
 
     return VueRouter({
-        routesFolder: scanViews(),
+        routesFolder: routesFolders,
         dts: "./src/types/typed-router.d.ts",
         extensions: [".vue"],
         importMode: "async",

package/bin/scanViewsDir.ts

@@ -1,114 +0,0 @@
-import type { ViewDirMeta } from "befly-shared/utils/scanViewsDir";
-
-import { existsSync } from "node:fs";
-import { readFile, readdir, writeFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { cleanDirName, extractDefinePageMetaFromScriptSetup, extractScriptSetupBlock, normalizeMenuTree } from "befly-shared/utils/scanViewsDir";
-
-type MenuConfig = {
-    name: string;
-    path: string;
-    icon?: string;
-    sort?: number;
-    children?: MenuConfig[];
-};
-
-/**
- * 扫描 views 目录，构建菜单树（与 core/sync/syncMenu.ts 中的 scanViewsDir 逻辑一致）
- */
-export async function scanViewsDir(viewsDir: string, prefix: string, parentPath: string = ""): Promise<MenuConfig[]> {
-    if (!existsSync(viewsDir)) {
-        return [];
-    }
-
-    const menus: MenuConfig[] = [];
-    const entries = await readdir(viewsDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-        if (!entry.isDirectory() || entry.name === "components") {
-            continue;
-        }
-
-        const dirPath = join(viewsDir, entry.name);
-        const indexVuePath = join(dirPath, "index.vue");
-
-        if (!existsSync(indexVuePath)) {
-            continue;
-        }
-
-        let meta: ViewDirMeta | null = null;
-        try {
-            const content = await readFile(indexVuePath, "utf-8");
-
-            const scriptSetup = extractScriptSetupBlock(content);
-            if (!scriptSetup) {
-                continue;
-            }
-
-            meta = extractDefinePageMetaFromScriptSetup(scriptSetup);
-            if (!meta?.title) {
-                continue;
-            }
-        } catch {
-            continue;
-        }
-
-        if (!meta?.title) {
-            continue;
-        }
-
-        const cleanName = cleanDirName(entry.name);
-        let menuPath: string;
-        if (cleanName === "index") {
-            menuPath = parentPath;
-        } else {
-            menuPath = parentPath ? `${parentPath}/${cleanName}` : `/${cleanName}`;
-        }
-
-        const fullPath = prefix ? (menuPath ? `${prefix}${menuPath}` : prefix) : menuPath || "/";
-
-        const menu: MenuConfig = {
-            name: meta.title,
-            path: fullPath,
-            sort: meta.order ?? 999999
-        };
-
-        const children = await scanViewsDir(dirPath, prefix, menuPath);
-        if (children.length > 0) {
-            menu.children = children;
-        }
-
-        menus.push(menu);
-    }
-
-    menus.sort((a, b) => (a.sort ?? 999999) - (b.sort ?? 999999));
-    return menus;
-}
-
-async function main(): Promise<void> {
-    // 固定扫描目录：仓库 packages/admin/src/views
-    // 固定输出：同目录下的 menu.json
-    const fileDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
-    const repoRoot = resolve(fileDir, "..", "..", "..");
-
-    const absDir = resolve(repoRoot, "packages", "admin", "src", "views");
-    const outPath = join(absDir, "menu.json");
-
-    if (!existsSync(absDir)) {
-        process.stderr.write(`Missing views dir: ${absDir}\n`);
-        process.exitCode = 1;
-        return;
-    }
-
-    const menus = await scanViewsDir(absDir, "");
-    const normalized = normalizeMenuTree(menus);
-
-    const content = `${JSON.stringify(normalized, null, 4)}\n`;
-    await writeFile(outPath, content, { encoding: "utf-8" });
-
-    process.stdout.write(`Wrote ${normalized.length} root menus to ${outPath}\n`);
-}
-
-await main();

package/configs/uno.config.js

@@ -1,37 +0,0 @@
-import { defineConfig, presetAttributify, presetUno } from "unocss";
-
-/**
- * 创建 UnoCSS 配置
- */
-export function createUnoConfig(userConfig = {}) {
-    const defaultConfig = {
-        presets: [presetUno(), presetAttributify()],
-        shortcuts: {
-            "flex-center": "flex items-center justify-center",
-            "flex-between": "flex items-center justify-between",
-            "flex-col-center": "flex flex-col items-center justify-center"
-        },
-        theme: {
-            colors: {
-                primary: "#1890ff",
-                success: "#52c41a",
-                warning: "#faad14",
-                danger: "#ff4d4f",
-                info: "#1890ff"
-            }
-        }
-    };
-
-    return defineConfig({
-        ...defaultConfig,
-        ...userConfig,
-        theme: {
-            ...defaultConfig.theme,
-            ...userConfig.theme
-        },
-        shortcuts: {
-            ...defaultConfig.shortcuts,
-            ...userConfig.shortcuts
-        }
-    });
-}

package/plugins/compression.js

@@ -1,15 +0,0 @@
-import { compression } from "vite-plugin-compression2";
-
-/**
- * 创建文件压缩插件配置
- */
-export function createCompressionPlugin(options = {}) {
-    const { threshold = 10240, algorithms = ["gzip", "brotliCompress"] } = options;
-
-    return compression({
-        include: /\.(html|xml|css|json|js|mjs|svg)$/i,
-        threshold: threshold,
-        algorithms: algorithms,
-        deleteOriginalAssets: false
-    });
-}

package/plugins/unocss.js

@@ -1,8 +0,0 @@
-import UnoCSS from "unocss/vite";
-
-/**
- * 创建 UnoCSS 插件配置
- */
-export function createUnoCSSPlugin() {
-    return UnoCSS();
-}

package/utils/arrayToTree.js

@@ -1,100 +0,0 @@
-/**
- * @typedef {Object} ArrayToTreeOptions
- * @property {string=} idField
- * @property {string=} pidField
- * @property {string=} childrenField
- * @property {any=} rootPid
- * @property {string=} sortField
- * @property {(node: any) => any=} mapFn
- */
-
-/**
- * @template T
- * @param {T[]} items
- * @param {ArrayToTreeOptions=} options
- * @returns {T[]}
- */
-export function arrayToTree(items, options = {}) {
-    const idField = typeof options.idField === "string" ? options.idField : "id";
-    const pidField = typeof options.pidField === "string" ? options.pidField : "pid";
-    const childrenField = typeof options.childrenField === "string" ? options.childrenField : "children";
-    const rootPid = "rootPid" in options ? options.rootPid : 0;
-    const sortField = "sortField" in options ? (typeof options.sortField === "string" && options.sortField.length > 0 ? options.sortField : null) : "sort";
-    const mapFn = typeof options.mapFn === "function" ? options.mapFn : null;
-
-    /**
-     * pid -> items[]
-     * @type {Map<any, T[]>}
-     */
-    const pidMap = new Map();
-
-    for (const item of items) {
-        // @ts-ignore
-        const pid = item ? item[pidField] : undefined;
-        const list = pidMap.get(pid);
-        if (list) {
-            list.push(item);
-        } else {
-            pidMap.set(pid, [item]);
-        }
-    }
-
-    /**
-     * @param {any} pid
-     * @param {Set<any>} stack
-     * @returns {T[]}
-     */
-    const build = (pid, stack) => {
-        /** @type {T[]} */
-        const tree = [];
-        const list = pidMap.get(pid) || [];
-
-        for (const item of list) {
-            const node = Object.assign({}, item);
-            const mappedNode = mapFn ? mapFn(node) : node;
-
-            // 子节点 rootPid = node[id]
-            // @ts-ignore
-            const nextRootPid = mappedNode ? mappedNode[idField] : undefined;
-
-            let children = [];
-            if (!stack.has(nextRootPid)) {
-                stack.add(nextRootPid);
-                children = build(nextRootPid, stack);
-                stack.delete(nextRootPid);
-            }
-
-            if (children.length > 0) {
-                // @ts-ignore
-                mappedNode[childrenField] = children;
-            }
-
-            tree.push(mappedNode);
-        }
-
-        if (sortField) {
-            tree.sort((a, b) => {
-                // @ts-ignore
-                const av = a ? a[sortField] : undefined;
-                // @ts-ignore
-                const bv = b ? b[sortField] : undefined;
-
-                const aMissing = av === undefined || av === null;
-                const bMissing = bv === undefined || bv === null;
-                if (aMissing && bMissing) return 0;
-                if (aMissing) return 1;
-                if (bMissing) return -1;
-
-                if (typeof av === "number" && typeof bv === "number") {
-                    return av - bv;
-                }
-
-                return String(av).localeCompare(String(bv), undefined, { numeric: true, sensitivity: "base" });
-            });
-        }
-
-        return tree;
-    };
-
-    return build(rootPid, new Set());
-}

package/utils/createUnoConfig.js

@@ -1,7 +0,0 @@
-/**
- * UnoCSS 配置创建函数（对外稳定导出）
- *
- * 注意：befly-vite 不再从主入口导出 configs/plugins，统一通过 utils 子路径导入。
- */
-
-export { createUnoConfig } from "../configs/uno.config.js";

package/utils/fieldClear.js

@@ -1,94 +0,0 @@
-/**
- * @typedef {Object} FieldClearOptions
- * @property {string[]=} pickKeys
- * @property {string[]=} omitKeys
- * @property {any[]=} keepValues
- * @property {any[]=} excludeValues
- * @property {Record<string, any>=} keepMap
- */
-
-function isObject(val) {
-    return val !== null && typeof val === "object" && !Array.isArray(val);
-}
-
-function isArray(val) {
-    return Array.isArray(val);
-}
-
-/**
- * 清理对象/数组字段
- * - 支持 pick/omit/keepValues/excludeValues
- * - 支持 keepMap 强制保留
- * @template T
- * @param {T|T[]} data
- * @param {FieldClearOptions=} options
- * @returns {any}
- */
-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) => {
-        /** @type {Record<string, any>} */
-        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.prototype.hasOwnProperty.call(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/hashPassword.js

@@ -1,21 +0,0 @@
-/**
- * 密码哈希工具（浏览器侧）
- * 使用 SHA-256 + 盐值对密码进行单向哈希
- * @param {string} password
- * @param {string=} salt
- * @returns {Promise<string>} 十六进制哈希
- */
-export async function hashPassword(password, salt = "befly") {
-    const data = String(password) + String(salt);
-
-    const encoder = new TextEncoder();
-    const dataBuffer = encoder.encode(data);
-
-    // Web Crypto API
-    const hashBuffer = await crypto.subtle.digest("SHA-256", dataBuffer);
-
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
-    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
-
-    return hashHex;
-}

package/utils/router.js

@@ -1,109 +0,0 @@
-/**
- * 路由相关工具函数（守卫 / 布局装配 / resolver 等）
- */
-
-import { Layouts, applyLayouts } from "./layouts.js";
-
-/**
- * 规范化路由 path：去尾随 "/"（根路径 "/" 例外）。
- *
- * @param {any} path
- * @returns {any}
- */
-export function normalizeRoutePath(path) {
-    if (typeof path !== "string") {
-        return path;
-    }
-
-    const normalized = path.replace(/\/+$/, "");
-    return normalized.length === 0 ? "/" : normalized;
-}
-
-/**
- * 应用一个最小可用的 token 鉴权守卫（业务方提供 token 获取方式与路径）。
- *
- * 约定：当路由 meta.public === true 时认为是公开路由。
- *
- * @param {import('vue-router').Router} router
- * @param {{
- *   getToken: () => any,
- *   loginPath: string,
- *   homePath: string
- * }} options
- */
-export function applyTokenAuthGuard(router, options) {
-    const normalizedLoginPath = normalizeRoutePath(options.loginPath);
-    const normalizedHomePath = normalizeRoutePath(options.homePath);
-
-    router.beforeEach(async (to, _from, next) => {
-        const token = options.getToken();
-        const toPath = normalizeRoutePath(to.path);
-
-        // 0. 根路径重定向
-        if (toPath === "/") {
-            return next(token ? normalizedHomePath : normalizedLoginPath);
-        }
-
-        // 1. 未登录且访问非公开路由 → 跳转登录
-        if (!token && to.meta?.public !== true && toPath !== normalizedLoginPath) {
-            return next(normalizedLoginPath);
-        }
-
-        // 2. 已登录访问登录页 → 跳转首页
-        if (token && toPath === normalizedLoginPath) {
-            return next(normalizedHomePath);
-        }
-
-        next();
-    });
-}
-
-/**
- * 将“组件/懒加载函数/Promise”统一转换为 Vue Router 可接受的懒加载 component 函数。
- *
- * - 如果已经是函数（通常是 `() => import(...)`），直接返回。
- * - 否则包一层函数（使其变成 lazy component）。
- *
- * @param {any} value
- * @returns {any}
- */
-function toLazyComponent(value) {
-    if (typeof value === "function") {
-        return value;
-    }
-
-    return () => value;
-}
-
-/**
- * 创建布局组件解析器（resolver）。
- *
- * @param {{
- *   resolveDefaultLayout: () => any,
- *   resolveNamedLayout: (layoutName: string) => any,
- *   defaultLayoutName?: string
- * }} options
- * @returns {(layoutName: string) => any}
- */
-export function createLayoutComponentResolver(options) {
-    const defaultLayoutName = options.defaultLayoutName || "default";
-
-    return (layoutName) => {
-        if (layoutName === defaultLayoutName) {
-            return toLazyComponent(options.resolveDefaultLayout());
-        }
-
-        return toLazyComponent(options.resolveNamedLayout(layoutName));
-    };
-}
-
-/**
- * 将 auto-routes 的 routes 按 `_数字` 规则套用布局组件，并输出 Vue Router 的 RouteRecordRaw[]。
- *
- * @param {any[]} routes
- * @param {(layoutName: string) => any} resolveLayoutComponent
- * @returns {import('vue-router').RouteRecordRaw[]}
- */
-export function buildLayoutRoutes(routes, resolveLayoutComponent) {
-    return applyLayouts(Layouts(routes), resolveLayoutComponent);
-}

package/utils/scanViews.js

@@ -1,59 +0,0 @@
-import { existsSync, readdirSync, realpathSync } from "node:fs";
-import { join } from "node:path";
-
-/**
- * 扫描项目和所有 @befly-addon 包的视图目录
- * 用于 unplugin-vue-router 的 routesFolder 配置
- *
- * 约定：addon 只允许从 adminViews 扫描路由：
- * - <addonRoot>/adminViews
- *
- * 注意：此函数只能在 vite.config.js 中使用（Node.js 环境），不能在浏览器中使用
- * @returns {Array<{ src: string, path: string, exclude: string[] }>} 路由文件夹配置数组
- */
-export function scanViews() {
-    const appRoot = process.cwd();
-    const addonBasePath = join(appRoot, "node_modules", "@befly-addon");
-
-    /** @type {Array<{ src: string, path: string, exclude: string[] }>} */
-    const routesFolders = [];
-
-    // 1. 项目自身 views
-    const appViewsPath = join(appRoot, "src", "views");
-    if (existsSync(appViewsPath)) {
-        routesFolders.push({
-            src: realpathSync(appViewsPath),
-            path: "",
-            exclude: ["**/components/**"]
-        });
-    }
-
-    // 2. 扫描 @befly-addon/*/adminViews（仅此目录允许生成 addon 路由）
-    if (!existsSync(addonBasePath)) {
-        return routesFolders;
-    }
-
-    try {
-        const addonDirs = readdirSync(addonBasePath);
-
-        for (const addonName of addonDirs) {
-            const addonPath = join(addonBasePath, addonName);
-            if (!existsSync(addonPath)) {
-                continue;
-            }
-
-            const adminViewsPath = join(addonPath, "adminViews");
-            if (existsSync(adminViewsPath)) {
-                routesFolders.push({
-                    src: realpathSync(adminViewsPath),
-                    path: `addon/${addonName}/`,
-                    exclude: ["**/components/**"]
-                });
-            }
-        }
-    } catch {
-        // 扫描失败保持静默，避免影响 Vite 启动
-    }
-
-    return routesFolders;
-}

package/utils/withDefaultColumns.js

@@ -1,41 +0,0 @@
-/**
- * 为表格列添加默认配置
- * @param {any[]} columns
- * @param {Record<string, any>=} customConfig
- * @returns {any[]}
- */
-export function withDefaultColumns(columns, customConfig = {}) {
-    /** @type {Record<string, any>} */
-    const specialColumnConfig = Object.assign(
-        {
-            operation: { width: 100, align: "center", fixed: "right" },
-            state: { width: 100, align: "center" },
-            sort: { width: 100, align: "center" },
-            id: { width: 200, align: "center" }
-        },
-        customConfig
-    );
-
-    return columns.map((col) => {
-        const colKey = col && col.colKey;
-
-        let specialConfig = colKey ? specialColumnConfig[colKey] : undefined;
-
-        if (!specialConfig && colKey && (colKey.endsWith("At") || colKey.endsWith("At2"))) {
-            specialConfig = { align: "center" };
-        }
-
-        const base = {
-            width: 150,
-            ellipsis: true
-        };
-
-        const merged = Object.assign({}, base);
-        if (specialConfig) {
-            Object.assign(merged, specialConfig);
-        }
-        Object.assign(merged, col);
-
-        return merged;
-    });
-}