npm - befly-admin - Versions diffs - 3.10.4 → 3.11.0 - Mend

befly-admin 3.10.4 → 3.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/index.html +1 -1
package/package.json +3 -3
package/src/layouts/default.vue +1 -1
package/src/main.ts +17 -0
package/src/plugins/{config.js → config.ts} +12 -10
package/src/plugins/{global.js → global.ts} +5 -4
package/src/plugins/http.ts +181 -0
package/src/plugins/{router.js → router.ts} +7 -6
package/src/plugins/storage.ts +160 -0
package/src/types/auto-imports.d.ts +21 -11
package/src/types/befly-vite.d.ts +9 -0
package/src/types/shims-vue.d.ts +6 -0
package/src/types/vite-env.d.ts +1 -0
package/src/utils/cleanParams.ts +39 -0
package/src/utils/getViteEnvString.ts +4 -0
package/src/main.js +0 -47
package/src/plugins/http.js +0 -86
package/src/plugins/storage.js +0 -137

package/index.html CHANGED Viewed

@@ -8,6 +8,6 @@
     </head>
     <body>
         <div id="app"></div>
-        <script type="module" src="/src/main.js"></script>
+        <script type="module" src="/src/main.ts"></script>
     </body>
 </html>

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
     "name": "befly-admin",
-    "version": "3.10.4",
-    "gitHead": "5a041666725189792d66b994d4d35a28822637ad",
+    "version": "3.11.0",
+    "gitHead": "3a9dc64d2eb69e646f4fd6eebd5d8dbe6516cb69",
     "private": false,
     "description": "Befly Admin - 基于 Vue3 + TDesign Vue Next 的后台管理系统",
     "files": [
@@ -28,7 +28,7 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "@befly-addon/admin": "^1.6.3",
+        "@befly-addon/admin": "^1.7.0",
         "@iconify-json/lucide": "^1.2.83",
         "axios": "^1.13.2",
         "befly-vite": "^1.4.4",

package/src/layouts/default.vue CHANGED Viewed

@@ -135,7 +135,7 @@ const $Method = {
     // 获取用户菜单权限
     async fetchUserMenus() {
         try {
-            const { data } = await $Http("/addon/admin/menu/all");
+            const { data } = await $Http.post("/addon/admin/menu/all");
             const lists = Array.isArray(data?.lists) ? data.lists : [];
             const bizMenus = [];

package/src/main.ts ADDED Viewed

@@ -0,0 +1,17 @@
+// 引入 TDesign 样式
+import "tdesign-vue-next/es/style/index.css";
+// 引入 addonAdmin 的 CSS 变量
+import "@befly-addon/admin/styles/variables.scss";
+// 引入全局基础样式（reset、通用类、滚动条等）
+import "./styles/global.scss";
+import App from "./App.vue";
+const app = createApp(App);
+// 安装基础插件
+app.use(createPinia());
+// 使用路由
+app.use($Router);
+app.mount("#app");

package/src/plugins/{config.js → config.ts} RENAMED Viewed

@@ -3,27 +3,29 @@
  * 存放框架内置的配置变量，不建议修改
  */
+export type BeflyAdminConfig = {
+    appTitle: string;
+    apiBaseUrl: string;
+    uploadUrl: string;
+    storageNamespace: string;
+    loginPath: string;
+    homePath: string;
+    isDev: boolean;
+    isProd: boolean;
+};
 /**
  * 内置配置对象
  */
-export const $Config = {
-    /** 应用标题 */
+export const $Config: BeflyAdminConfig = {
     appTitle: import.meta.env.VITE_APP_TITLE || "野蜂飞舞",
-    /** API 基础地址 */
     apiBaseUrl: import.meta.env.VITE_API_BASE_URL || "",
-    /** 上传地址（优先使用 VITE_UPLOAD_URL；否则基于 VITE_API_BASE_URL 拼接 /upload） */
     uploadUrl: import.meta.env.VITE_UPLOAD_URL || ((import.meta.env.VITE_API_BASE_URL || "").length > 0 ? `${import.meta.env.VITE_API_BASE_URL}/upload` : "/upload"),
-    /** 存储命名空间 */
     storageNamespace: import.meta.env.VITE_STORAGE_NAMESPACE || "befly_admin",
-    /** 登录页路径（可通过 VITE_LOGIN_PATH 覆盖） */
     loginPath: import.meta.env.VITE_LOGIN_PATH || "/addon/admin/login",
-    /** 首页路径（可通过 VITE_HOME_PATH 覆盖） */
     homePath: import.meta.env.VITE_HOME_PATH || "/addon/admin",
-    /** 是否开发环境 */
     isDev: import.meta.env.DEV,
-    /** 是否生产环境 */
     isProd: import.meta.env.PROD
 };

package/src/plugins/{global.js → global.ts} RENAMED Viewed

@@ -2,16 +2,17 @@
  * 全局状态管理
  * 集中管理所有全局数据，避免分散到多个 store 文件
  */
 export const useGlobal = defineStore("global", () => {
     // ==================== 全局数据 ====================
-    const data = $ref({});
+    const data = reactive<Record<string, unknown>>({});
     // ==================== 全局方法 ====================
-    const method = {};
+    const method: Record<string, unknown> = {};
     // ==================== 返回 ====================
     return {
-        data,
-        method
+        data: data,
+        method: method
     };
 });

package/src/plugins/http.ts ADDED Viewed

@@ -0,0 +1,181 @@
+import axios, { AxiosHeaders, type AxiosRequestConfig, type AxiosResponse, type InternalAxiosRequestConfig } from "axios";
+import { cleanParams } from "../utils/cleanParams";
+import { getViteEnvString } from "../utils/getViteEnvString";
+import { $Storage } from "./storage";
+export type HttpApiResponse<TData> = {
+    code: number;
+    msg?: string;
+    data?: TData;
+};
+export type HttpCleanParamsOptions = {
+    dropValues?: readonly unknown[];
+    dropKeyValue?: Record<string, readonly unknown[]>;
+};
+export type HttpClientOptions = AxiosRequestConfig & HttpCleanParamsOptions;
+export type HttpGetData = Record<string, unknown>;
+export type HttpPostData = Record<string, unknown> | FormData;
+function toAxiosRequestConfig(options: HttpClientOptions | undefined): AxiosRequestConfig | undefined {
+    if (!options) {
+        return undefined;
+    }
+    const out = Object.assign({}, options) as Record<string, unknown>;
+    delete out["dropValues"];
+    delete out["dropKeyValue"];
+    if (Object.keys(out).length === 0) {
+        return undefined;
+    }
+    return out as AxiosRequestConfig;
+}
+function isPlainRecord(value: unknown): value is Record<string, unknown> {
+    if (typeof value !== "object" || value === null) return false;
+    if (Array.isArray(value)) return false;
+    if (value instanceof FormData) return false;
+    return true;
+}
+function maybeCleanRequestData(data: Record<string, unknown>, cleanOptions: HttpCleanParamsOptions | undefined): Record<string, unknown> {
+    if (!isPlainRecord(data)) {
+        return data;
+    }
+    const dropValues = cleanOptions?.dropValues;
+    const dropKeyValue = cleanOptions?.dropKeyValue;
+    return cleanParams(data, dropValues ?? [], dropKeyValue);
+}
+class HttpError extends Error {
+    public code: number;
+    public data?: unknown;
+    public rawError?: unknown;
+    public constructor(code: number, msg: string, data?: unknown, rawError?: unknown) {
+        super(msg);
+        this.name = "HttpError";
+        this.code = code;
+        this.data = data;
+        this.rawError = rawError;
+    }
+}
+function isNormalizedHttpError(value: unknown): value is HttpError {
+    return value instanceof HttpError;
+}
+async function showNetworkErrorToast(): Promise<void> {
+    // 在测试/非浏览器环境下，tdesign-vue-next 可能不可用；仅在需要展示提示时再加载。
+    try {
+        const mod = await import("tdesign-vue-next");
+        mod.MessagePlugin.error("网络连接失败");
+    } catch {
+        // ignore
+    }
+}
+async function unwrapApiResponse<TData>(promise: Promise<AxiosResponse<HttpApiResponse<TData>>>): Promise<HttpApiResponse<TData>> {
+    try {
+        const response = await promise;
+        const res = response.data;
+        if (res.code !== 0) {
+            throw new HttpError(res.code, res.msg || "请求失败", res.data);
+        }
+        return res;
+    } catch (error) {
+        // 业务错误：不显示提示，由业务层处理
+        if (isNormalizedHttpError(error)) {
+            throw error;
+        }
+        await showNetworkErrorToast();
+        throw new HttpError(-1, "网络连接失败", undefined, error);
+    }
+}
+// 创建 axios 实例
+const request = axios.create({
+    baseURL: getViteEnvString("VITE_API_BASE_URL") || "",
+    timeout: 10000,
+    headers: {
+        "Content-Type": "application/json"
+    }
+});
+// 请求拦截器
+request.interceptors.request.use(
+    (config: InternalAxiosRequestConfig) => {
+        const token = $Storage.local.get("token");
+        if (token) {
+            const headers = new AxiosHeaders(config.headers);
+            headers.set("Authorization", `Bearer ${token}`);
+            config.headers = headers;
+        }
+        return config;
+    },
+    (error: unknown) => {
+        return Promise.reject(error);
+    }
+);
+async function httpGet<TData>(url: string, data?: HttpGetData, options?: HttpClientOptions): Promise<HttpApiResponse<TData>> {
+    const axiosConfig = toAxiosRequestConfig(options);
+    const inputData = data ?? {};
+    const cleanedData = maybeCleanRequestData(inputData, options);
+    // 规则：GET 必须传 params；为空也传空对象
+    const finalConfig = Object.assign({}, axiosConfig);
+    (finalConfig as { params?: unknown }).params = cleanedData;
+    return unwrapApiResponse<TData>(request.get<HttpApiResponse<TData>>(url, finalConfig));
+}
+async function httpPost<TData>(url: string, data?: HttpPostData, options?: HttpClientOptions): Promise<HttpApiResponse<TData>> {
+    const axiosConfig = toAxiosRequestConfig(options);
+    if (data === undefined) {
+        // 规则：POST 必须传 body；为空也传空对象
+        return unwrapApiResponse<TData>(request.post<HttpApiResponse<TData>>(url, {}, axiosConfig));
+    }
+    if (data instanceof FormData) {
+        return unwrapApiResponse<TData>(request.post<HttpApiResponse<TData>>(url, data, axiosConfig));
+    }
+    const cleanedData = maybeCleanRequestData(data, options);
+    if (Object.keys(cleanedData).length === 0) {
+        // 规则：POST 必须传 body；清洗为空则传空对象
+        return unwrapApiResponse<TData>(request.post<HttpApiResponse<TData>>(url, {}, axiosConfig));
+    }
+    return unwrapApiResponse<TData>(request.post<HttpApiResponse<TData>>(url, cleanedData, axiosConfig));
+}
+/**
+ * 统一的 HTTP 请求对象（仅支持 GET 和 POST）
+ * - 调用方式：$Http.get(url, data?, options?) / $Http.post(url, data?, options?)
+ * - 重要行为：
+ *   - 未传 data / 清洗为空时：仍会发送空对象（GET: params={}, POST: body={}）
+ *     - 原因：部分后端接口会基于“参数结构存在”触发默认逻辑/签名校验/中间件约束；
+ *       因此这里不做“省略空对象”的优化。
+ *   - 传入 plain object 时：默认强制移除 null / undefined
+ * - 可选参数清洗（第三参，且可与 axios config 混用）：
+ *   - dropValues：全局丢弃值列表（仅对未配置 dropKeyValue 的 key 生效）
+ *   - dropKeyValue：按 key 精确配置丢弃值列表（覆盖全局 dropValues）
+ *
+ *   例子：保留 page=0，但丢弃 keyword=""，并且其它字段应用全局 dropValues
+ *   - dropValues: [0, ""]
+ *   - dropKeyValue: { page: [], keyword: [""] }
+ */
+export const $Http = {
+    get: httpGet,
+    post: httpPost
+};

package/src/plugins/{router.js → router.ts} RENAMED Viewed

@@ -1,20 +1,21 @@
-import { $Storage } from "@/plugins/storage";
 import { Layouts } from "befly-vite";
 import { createRouter, createWebHashHistory } from "vue-router";
 import { routes } from "vue-router/auto-routes";
+import { $Storage } from "./storage";
 // 应用自定义布局系统（同时可选注入根路径重定向）
-const finalRoutes = Layouts(routes, $Config.homePath, (layoutName) => {
+const finalRoutes = Layouts(routes, $Config.homePath, (layoutName: string) => {
     if (layoutName === "default") {
-        return () => import("@/layouts/default.vue");
+        return () => import("../layouts/default.vue");
     }
-    return () => import(`@/layouts/${layoutName}.vue`);
+    return () => import(`../layouts/${layoutName}.vue`);
 });
 /**
  * 创建并导出路由实例
- * 可直接在 main.js 中使用 app.use($Router)
+ * 可直接在 main.ts 中使用 app.use($Router)
  */
 export const $Router = createRouter({
     history: createWebHashHistory(import.meta.env.BASE_URL),
@@ -32,7 +33,7 @@ $Router.beforeEach((to, _from, next) => {
     }
     // 公开路由放行
-    if (to.meta?.public === true) {
+    if (to.meta?.["public"] === true) {
         return next();
     }

package/src/plugins/storage.ts ADDED Viewed

@@ -0,0 +1,160 @@
+/**
+ * Storage 封装
+ * 支持命名空间隔离，统一管理 localStorage 和 sessionStorage
+ */
+import { getViteEnvString } from "../utils/getViteEnvString";
+// 获取命名空间
+const NAMESPACE = getViteEnvString("VITE_STORAGE_NAMESPACE") || "befly";
+class MemoryStorage implements Storage {
+    private map: Map<string, string>;
+    public constructor() {
+        this.map = new Map<string, string>();
+    }
+    public get length(): number {
+        return this.map.size;
+    }
+    public clear(): void {
+        for (const key of this.map.keys()) {
+            delete (this as unknown as Record<string, unknown>)[key];
+        }
+        this.map.clear();
+    }
+    public getItem(key: string): string | null {
+        return this.map.get(key) ?? null;
+    }
+    public key(index: number): string | null {
+        const keys = Array.from(this.map.keys());
+        return keys[index] ?? null;
+    }
+    public removeItem(key: string): void {
+        this.map.delete(key);
+        delete (this as unknown as Record<string, unknown>)[key];
+    }
+    public setItem(key: string, value: string): void {
+        this.map.set(key, value);
+        (this as unknown as Record<string, unknown>)[key] = value;
+    }
+}
+function getBrowserStorage(kind: "localStorage" | "sessionStorage"): Storage {
+    const win = globalThis as unknown as { window?: { localStorage?: Storage; sessionStorage?: Storage } };
+    const storage = win.window?.[kind];
+    if (storage) {
+        return storage;
+    }
+    return new MemoryStorage();
+}
+type StorageOps = {
+    set: (key: string, value: unknown) => void;
+    get: {
+        (key: string): string | null;
+        (key: string, defaultValue: string | null): string | null;
+        <T>(key: string, defaultValue: T): T;
+    };
+    remove: (key: string) => void;
+    clear: () => void;
+    has: (key: string) => boolean;
+    keys: () => string[];
+};
+/**
+ * 存储操作类
+ */
+class StorageManager {
+    private localStorage: Storage;
+    private sessionStorage: Storage;
+    private namespace: string;
+    public constructor(namespace: string = NAMESPACE) {
+        this.localStorage = getBrowserStorage("localStorage");
+        this.sessionStorage = getBrowserStorage("sessionStorage");
+        this.namespace = namespace;
+    }
+    private getKey(key: string): string {
+        return `${this.namespace}:${key}`;
+    }
+    private createStorageOps(storage: Storage): StorageOps {
+        return {
+            set: (key: string, value: unknown) => {
+                try {
+                    const fullKey = this.getKey(key);
+                    const serializedValue = JSON.stringify(value);
+                    storage.setItem(fullKey, serializedValue);
+                } catch {
+                    // ignore
+                }
+            },
+            get: ((key: string, defaultValue?: unknown) => {
+                try {
+                    const fullKey = this.getKey(key);
+                    const value = storage.getItem(fullKey);
+                    if (value === null) {
+                        return defaultValue ?? null;
+                    }
+                    return JSON.parse(value) as unknown;
+                } catch {
+                    return defaultValue ?? null;
+                }
+            }) as StorageOps["get"],
+            remove: (key: string) => {
+                try {
+                    const fullKey = this.getKey(key);
+                    storage.removeItem(fullKey);
+                } catch {
+                    // ignore
+                }
+            },
+            clear: () => {
+                try {
+                    const keys = Object.keys(storage);
+                    const prefix = `${this.namespace}:`;
+                    keys.forEach((key) => {
+                        if (key.startsWith(prefix)) {
+                            storage.removeItem(key);
+                        }
+                    });
+                } catch {
+                    // ignore
+                }
+            },
+            has: (key: string) => {
+                const fullKey = this.getKey(key);
+                return storage.getItem(fullKey) !== null;
+            },
+            keys: () => {
+                const keys = Object.keys(storage);
+                const prefix = `${this.namespace}:`;
+                return keys.filter((key) => key.startsWith(prefix)).map((key) => key.substring(prefix.length));
+            }
+        };
+    }
+    public get local(): StorageOps {
+        return this.createStorageOps(this.localStorage);
+    }
+    public get session(): StorageOps {
+        return this.createStorageOps(this.sessionStorage);
+    }
+}
+// 导出单例
+export const $Storage = new StorageManager();

package/src/types/auto-imports.d.ts CHANGED Viewed

@@ -6,15 +6,16 @@
 // biome-ignore lint: disable
 export {}
 declare global {
-  const $Config: typeof import('../plugins/config.js').$Config
-  const $Http: typeof import('../plugins/http.js').$Http
-  const $Router: typeof import('../plugins/router.js').$Router
-  const $Storage: typeof import('../plugins/storage.js').$Storage
+  const $Config: typeof import('../plugins/config').$Config
+  const $Http: typeof import('../plugins/http').$Http
+  const $Router: typeof import('../plugins/router').$Router
+  const $Storage: typeof import('../plugins/storage').$Storage
   const DialogPlugin: typeof import("tdesign-vue-next").DialogPlugin
   const EffectScope: typeof import('vue').EffectScope
   const MessagePlugin: typeof import('tdesign-vue-next').MessagePlugin
   const acceptHMRUpdate: typeof import('pinia').acceptHMRUpdate
   const arrayToTree: typeof import('../utils/arrayToTree').arrayToTree
+  const cleanParams: typeof import('../utils/cleanParams').cleanParams
   const computed: typeof import('vue').computed
   const createApp: typeof import('vue').createApp
   const createPinia: typeof import('pinia').createPinia
@@ -27,6 +28,7 @@ declare global {
   const getCurrentInstance: typeof import('vue').getCurrentInstance
   const getCurrentScope: typeof import('vue').getCurrentScope
   const getCurrentWatcher: typeof import('vue').getCurrentWatcher
+  const getViteEnvString: typeof import('../utils/getViteEnvString').getViteEnvString
   const h: typeof import('vue').h
   const inject: typeof import('vue').inject
   const isProxy: typeof import('vue').isProxy
@@ -62,7 +64,7 @@ declare global {
   const readonly: typeof import('vue').readonly
   const ref: typeof import('vue').ref
   const resolveComponent: typeof import('vue').resolveComponent
-  const router: typeof import('../plugins/router.js').router
+  const router: typeof import('../plugins/router').router
   const setActivePinia: typeof import('pinia').setActivePinia
   const setMapStoreSuffix: typeof import('pinia').setMapStoreSuffix
   const shallowReactive: typeof import('vue').shallowReactive
@@ -78,7 +80,7 @@ declare global {
   const useAttrs: typeof import('vue').useAttrs
   const useCssModule: typeof import('vue').useCssModule
   const useCssVars: typeof import('vue').useCssVars
-  const useGlobal: typeof import('../plugins/global.js').useGlobal
+  const useGlobal: typeof import('../plugins/global').useGlobal
   const useId: typeof import('vue').useId
   const useModel: typeof import('vue').useModel
   const useRoute: typeof import('vue-router').useRoute
@@ -98,6 +100,12 @@ declare global {
   // @ts-ignore
   export type { ArrayToTreeResult } from '../utils/arrayToTree'
   import('../utils/arrayToTree')
+  // @ts-ignore
+  export type { BeflyAdminConfig } from '../plugins/config'
+  import('../plugins/config')
+  // @ts-ignore
+  export type { HttpApiResponse, HttpCleanParamsOptions, HttpClientOptions, HttpGetData, HttpPostData } from '../plugins/http'
+  import('../plugins/http')
 }
 // for vue template auto import
@@ -105,14 +113,15 @@ import { UnwrapRef } from 'vue'
 declare module 'vue' {
   interface GlobalComponents {}
   interface ComponentCustomProperties {
-    readonly $Config: UnwrapRef<typeof import('../plugins/config.js')['$Config']>
-    readonly $Http: UnwrapRef<typeof import('../plugins/http.js')['$Http']>
-    readonly $Router: UnwrapRef<typeof import('../plugins/router.js')['$Router']>
-    readonly $Storage: UnwrapRef<typeof import('../plugins/storage.js')['$Storage']>
+    readonly $Config: UnwrapRef<typeof import('../plugins/config')['$Config']>
+    readonly $Http: UnwrapRef<typeof import('../plugins/http')['$Http']>
+    readonly $Router: UnwrapRef<typeof import('../plugins/router')['$Router']>
+    readonly $Storage: UnwrapRef<typeof import('../plugins/storage')['$Storage']>
     readonly EffectScope: UnwrapRef<typeof import('vue')['EffectScope']>
     readonly MessagePlugin: UnwrapRef<typeof import('tdesign-vue-next')['MessagePlugin']>
     readonly acceptHMRUpdate: UnwrapRef<typeof import('pinia')['acceptHMRUpdate']>
     readonly arrayToTree: UnwrapRef<typeof import('../utils/arrayToTree')['arrayToTree']>
+    readonly cleanParams: UnwrapRef<typeof import('../utils/cleanParams')['cleanParams']>
     readonly computed: UnwrapRef<typeof import('vue')['computed']>
     readonly createApp: UnwrapRef<typeof import('vue')['createApp']>
     readonly createPinia: UnwrapRef<typeof import('pinia')['createPinia']>
@@ -125,6 +134,7 @@ declare module 'vue' {
     readonly getCurrentInstance: UnwrapRef<typeof import('vue')['getCurrentInstance']>
     readonly getCurrentScope: UnwrapRef<typeof import('vue')['getCurrentScope']>
     readonly getCurrentWatcher: UnwrapRef<typeof import('vue')['getCurrentWatcher']>
+    readonly getViteEnvString: UnwrapRef<typeof import('../utils/getViteEnvString')['getViteEnvString']>
     readonly h: UnwrapRef<typeof import('vue')['h']>
     readonly inject: UnwrapRef<typeof import('vue')['inject']>
     readonly isProxy: UnwrapRef<typeof import('vue')['isProxy']>
@@ -175,7 +185,7 @@ declare module 'vue' {
     readonly useAttrs: UnwrapRef<typeof import('vue')['useAttrs']>
     readonly useCssModule: UnwrapRef<typeof import('vue')['useCssModule']>
     readonly useCssVars: UnwrapRef<typeof import('vue')['useCssVars']>
-    readonly useGlobal: UnwrapRef<typeof import('../plugins/global.js')['useGlobal']>
+    readonly useGlobal: UnwrapRef<typeof import('../plugins/global')['useGlobal']>
     readonly useId: UnwrapRef<typeof import('vue')['useId']>
     readonly useModel: UnwrapRef<typeof import('vue')['useModel']>
     readonly useRoute: UnwrapRef<typeof import('vue-router')['useRoute']>

package/src/types/befly-vite.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+declare module "befly-vite" {
+    import type { RouteRecordRaw } from "vue-router";
+    export function Layouts(
+        routes: readonly RouteRecordRaw[],
+        homePath?: string,
+        resolver?: (layoutName: string) => unknown
+    ): readonly RouteRecordRaw[];
+}

package/src/types/shims-vue.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+declare module "*.vue" {
+    import type { DefineComponent } from "vue";
+    const component: DefineComponent<Record<string, unknown>, Record<string, unknown>, unknown>;
+    export default component;
+}

package/src/types/vite-env.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ /// <reference types="vite/client" />

package/src/utils/cleanParams.ts ADDED Viewed

@@ -0,0 +1,39 @@
+export function cleanParams<TData extends Record<string, unknown>>(data: TData, dropValues?: readonly unknown[], dropKeyValue?: Record<string, readonly unknown[]>): Partial<TData> {
+    const globalDropValues = dropValues ?? [];
+    const perKeyDropValues = dropKeyValue ?? {};
+    const globalDropSet = new Set<unknown>(globalDropValues);
+    const out: Record<string, unknown> = {};
+    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<unknown>(keyDropValues);
+            if (keyDropSet.has(value)) {
+                continue;
+            }
+            out[key] = value;
+            continue;
+        }
+        // 未配置 key 规则：应用全局 dropValues
+        if (globalDropSet.has(value)) {
+            continue;
+        }
+        out[key] = value;
+    }
+    return out as Partial<TData>;
+}

package/src/utils/getViteEnvString.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export function getViteEnvString(key: string): string | undefined {
+    const env = (import.meta as unknown as { env?: Record<string, string> }).env;
+    return env?.[key];
+}

package/src/main.js DELETED Viewed

@@ -1,47 +0,0 @@
-// 引入 TDesign 组件
-import { Table as TTable } from "tdesign-vue-next";
-// 引入 TDesign 样式
-import "tdesign-vue-next/es/style/index.css";
-// 引入 addonAdmin 的 CSS 变量
-import "@befly-addon/admin/styles/variables.scss";
-// 引入全局基础样式（reset、通用类、滚动条等）
-import "@/styles/global.scss";
-import App from "./App.vue";
-const app = createApp(App);
-// 安装基础插件
-app.use(createPinia());
-// 使用路由
-app.use($Router);
-// 全局配置 TTable 默认属性
-app.component("TTable", {
-    ...TTable,
-    props: {
-        ...TTable.props,
-        bordered: {
-            type: [Boolean, Object],
-            default: () => ({ cell: "horizontal" })
-        },
-        size: {
-            type: String,
-            default: "small"
-        },
-        height: {
-            type: [String, Number],
-            default: "100%"
-        },
-        selectOnRowClick: {
-            type: Boolean,
-            default: true
-        },
-        activeRowType: {
-            type: String,
-            default: "single"
-        }
-    }
-});
-app.mount("#app");

package/src/plugins/http.js DELETED Viewed

@@ -1,86 +0,0 @@
-import axios from "axios";
-import { MessagePlugin } from "tdesign-vue-next";
-import { $Storage } from "./storage";
-/**
- * @typedef {Object} ApiResponse
- * @property {0 | 1} code
- * @property {string} msg
- * @property {any} data
- */
-// 创建 axios 实例
-const request = axios.create({
-    baseURL: import.meta.env.VITE_API_BASE_URL,
-    timeout: 10000,
-    headers: {
-        "Content-Type": "application/json"
-    }
-});
-// 请求拦截器
-request.interceptors.request.use(
-    (config) => {
-        // 添加 token
-        const token = $Storage.local.get("token");
-        if (token) {
-            config.headers.Authorization = `Bearer ${token}`;
-        }
-        return config;
-    },
-    (error) => {
-        return Promise.reject(error);
-    }
-);
-// 响应拦截器
-request.interceptors.response.use(
-    (response) => {
-        const res = response.data;
-        // 如果code不是0,说明业务失败（不显示提示，由业务层处理）
-        if (res.code !== 0) {
-            return Promise.reject({
-                code: res.code,
-                msg: res.msg || "请求失败",
-                data: res.data
-            });
-        }
-        // 成功时返回 data
-        return res;
-    },
-    (error) => {
-        MessagePlugin.error("网络连接失败");
-        return Promise.reject({
-            code: -1,
-            msg: "网络连接失败",
-            error: error
-        });
-    }
-);
-/**
- * 统一的 HTTP 请求方法（仅支持 GET 和 POST）
- * @template T
- * @param {string} url - 请求路径
- * @param {any} [data={}] - 请求数据，默认为空对象
- * @param {'get' | 'post'} [method='post'] - 请求方法，默认为 'post'，可选 'get' | 'post'
- * @param {import('axios').AxiosRequestConfig} [config] - axios 请求配置
- * @returns {Promise<any>} 成功返回 data，失败抛出 {code, msg, data} 对象
- */
-export function $Http(url, data = {}, method = "post", config) {
-    const methodLower = method.toLowerCase();
-    // GET 请求将 data 作为 params
-    if (methodLower === "get") {
-        return request.get(url, {
-            ...config,
-            params: data
-        });
-    }
-    // POST 请求将 data 作为 body
-    return request.post(url, data, config);
-}

package/src/plugins/storage.js DELETED Viewed

@@ -1,137 +0,0 @@
-/**
- * Storage 封装
- * 支持命名空间隔离，统一管理 localStorage 和 sessionStorage
- */
-// 获取命名空间
-const NAMESPACE = import.meta.env.VITE_STORAGE_NAMESPACE || "befly";
-/**
- * 存储操作类
- */
-class StorageManager {
-    /**
-     * @param {string} namespace
-     */
-    constructor(namespace = NAMESPACE) {
-        this.localStorage = window.localStorage;
-        this.sessionStorage = window.sessionStorage;
-        this.namespace = namespace;
-    }
-    /**
-     * 生成带命名空间的key
-     * @param {string} key
-     * @returns {string}
-     */
-    getKey(key) {
-        return `${this.namespace}:${key}`;
-    }
-    /**
-     * 创建存储操作方法
-     * @param {Storage} storage
-     */
-    createStorageOps(storage) {
-        return {
-            /**
-             * 设置存储
-             * @param {string} key - 键名
-             * @param {any} value - 值（自动序列化）
-             * @returns {void}
-             */
-            set: (key, value) => {
-                try {
-                    const fullKey = this.getKey(key);
-                    const serializedValue = JSON.stringify(value);
-                    storage.setItem(fullKey, serializedValue);
-                } catch {}
-            },
-            /**
-             * 获取存储
-             * @template T
-             * @param {string} key - 键名
-             * @param {T | null} [defaultValue=null] - 默认值
-             * @returns {T | null} 解析后的值
-             */
-            get: (key, defaultValue = null) => {
-                try {
-                    const fullKey = this.getKey(key);
-                    const value = storage.getItem(fullKey);
-                    if (value === null) {
-                        return defaultValue;
-                    }
-                    return JSON.parse(value);
-                } catch {
-                    return defaultValue;
-                }
-            },
-            /**
-             * 删除存储
-             * @param {string} key - 键名
-             * @returns {void}
-             */
-            remove: (key) => {
-                try {
-                    const fullKey = this.getKey(key);
-                    storage.removeItem(fullKey);
-                } catch {}
-            },
-            /**
-             * 清空当前命名空间下的所有存储
-             * @returns {void}
-             */
-            clear: () => {
-                try {
-                    const keys = Object.keys(storage);
-                    const prefix = `${this.namespace}:`;
-                    keys.forEach((key) => {
-                        if (key.startsWith(prefix)) {
-                            storage.removeItem(key);
-                        }
-                    });
-                } catch {}
-            },
-            /**
-             * 判断是否存在某个键
-             * @param {string} key - 键名
-             * @returns {boolean}
-             */
-            has: (key) => {
-                const fullKey = this.getKey(key);
-                return storage.getItem(fullKey) !== null;
-            },
-            /**
-             * 获取所有键名
-             * @returns {string[]} 去除命名空间前缀的键名列表
-             */
-            keys: () => {
-                const keys = Object.keys(storage);
-                const prefix = `${this.namespace}:`;
-                return keys.filter((key) => key.startsWith(prefix)).map((key) => key.substring(prefix.length));
-            }
-        };
-    }
-    /**
-     * localStorage 操作方法
-     */
-    get local() {
-        return this.createStorageOps(this.localStorage);
-    }
-    /**
-     * sessionStorage 操作方法
-     */
-    get session() {
-        return this.createStorageOps(this.sessionStorage);
-    }
-}
-// 导出单例
-export const $Storage = new StorageManager();