ez-react-antd 0.2.0 → 0.2.2

package/dist/ButtonAuth/ButtonAuth.d.ts

@@ -0,0 +1,72 @@
+import { default as React } from 'react';
+/**
+ * 按钮权限控制组件属性接口
+ */
+export interface ButtonAuthProps {
+    /** 按钮编码，用于查询所需权限 */
+    code: string;
+    /** 子组件 */
+    children?: React.ReactNode;
+}
+/**
+ * 按钮权限控制组件
+ * 根据按钮编码从配置中查询所需权限，并验证用户是否拥有该权限
+ *
+ * 权限验证规则：
+ * - 未配置 - 默认不需要登录和授权，可以公开显示
+ * - requiresAuthentication: false - 公开显示，不需要登录
+ * - requiresAuthentication: true + permissionIds: undefined - 需要登录，不需要权限
+ * - requiresAuthentication: true + permissionIds: string/array - 需要登录且需要权限
+ *
+ * @example
+ * // 基本用法 - 需要权限
+ * <ButtonAuth code="user.create">
+ *   <Button>创建用户</Button>
+ * </ButtonAuth>
+ *
+ * @example
+ * // 多个权限（满足任一即可）
+ * // 配置: getButtonPermissions: () => ({
+ * //   'user.delete': {
+ * //     requiresAuthentication: true,
+ * //     permissionIds: ['user.delete', 'user.manage']
+ * //   }
+ * // })
+ * <ButtonAuth code="user.delete">
+ *   <Button>删除用户</Button>
+ * </ButtonAuth>
+ *
+ * @example
+ * // 配合 ConfigProvider 使用（函数形式）
+ * <ConfigProvider value={{
+ *   getButtonPermissions: () => {
+ *     // 从 sessionStorage 动态获取
+ *     const cached = sessionStorage.getItem('buttonPermissions');
+ *     return cached ? JSON.parse(cached) : {
+ *       'user.create': {
+ *         requiresAuthentication: true,
+ *         permissionIds: 'user.create'
+ *       },
+ *       'user.delete': {
+ *         requiresAuthentication: true,
+ *         permissionIds: ['user.delete', 'user.manage']  // 拥有任一权限即可
+ *       },
+ *       'user.export': {
+ *         requiresAuthentication: true  // 需要登录，不需要权限
+ *       },
+ *       'public.view': {
+ *         requiresAuthentication: false  // 公开显示
+ *       }
+ *     };
+ *   },
+ *   hasPermission: (permission) => checkPermission(permission),
+ *   isAuthenticated: () => !!sessionStorage.getItem('token')
+ * }}>
+ *   <ButtonAuth code="user.create">
+ *     <Button>创建用户</Button>
+ *   </ButtonAuth>
+ * </ConfigProvider>
+ */
+declare const ButtonAuth: React.FC<ButtonAuthProps>;
+export default ButtonAuth;
+//# sourceMappingURL=ButtonAuth.d.ts.map

package/dist/ButtonAuth/ButtonAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonAuth.d.ts","sourceRoot":"","sources":["../../src/ButtonAuth/ButtonAuth.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgBzC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/ButtonAuth/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './ButtonAuth';
+export type { ButtonAuthProps } from './ButtonAuth';
+//# sourceMappingURL=index.d.ts.map

package/dist/ButtonAuth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ButtonAuth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/ConfigProvider/ConfigProvider.d.ts

@@ -0,0 +1,106 @@
+import { default as React } from 'react';
+import { EzAntdConfig } from './types';
+/** 全局配置 Context */
+export declare const ConfigContext: React.Context<EzAntdConfig>;
+/** 更新配置的方法类型 */
+export type UpdateConfigFunction = (newConfig: Partial<EzAntdConfig>) => void;
+/**
+ * 获取全局配置的 Hook
+ * @returns 全局配置对象
+ * @example
+ * const { request, responseIsSuccess } = useConfig();
+ */
+export declare const useConfig: () => EzAntdConfig;
+/**
+ * 获取更新配置方法的 Hook
+ * @returns 更新配置的函数
+ * @example
+ * const updateConfig = useUpdateConfig();
+ * updateConfig({ buttonPermissions: {...} });
+ */
+export declare const useUpdateConfig: () => UpdateConfigFunction;
+/**
+ * 全局配置提供者组件
+ * 用于为整个应用提供全局配置，支持动态更新配置
+ *
+ * @example
+ * // 基本用法
+ * import { ConfigProvider } from 'ez-react-antd';
+ * import request from './utils/request';
+ * import session from './utils/session';
+ *
+ * <ConfigProvider value={{
+ *   request: request,
+ *   isAuthenticated: () => session.isAuthenticated(),
+ *   hasPermission: (permission) => session.hasPermission(permission),
+ *   hasRole: (role) => session.hasRole(role),
+ *   loginPath: '/login',
+ *   forbiddenPath: '/403',
+ * }}>
+ *   <App />
+ * </ConfigProvider>
+ *
+ * @example
+ * // 方案 1：应用启动时加载权限配置（适合已登录用户刷新页面）
+ * import { ConfigProvider } from 'ez-react-antd';
+ *
+ * <ConfigProvider value={{
+ *   isAuthenticated: () => session.isAuthenticated(),
+ *   hasPermission: (permission) => session.hasPermission(permission),
+ *   // 使用函数形式，从 sessionStorage 动态获取
+ *   getRoutePermissions: () => {
+ *     const cached = sessionStorage.getItem('routePermissions');
+ *     return cached ? JSON.parse(cached) : {};
+ *   },
+ *   getButtonPermissions: () => {
+ *     const cached = sessionStorage.getItem('buttonPermissions');
+ *     return cached ? JSON.parse(cached) : {};
+ *   },
+ * }}>
+ *   <App />
+ * </ConfigProvider>
+ *
+ * @example
+ * // 方案 2：登录后保存权限配置到 sessionStorage
+ * import { useUpdateConfig } from 'ez-react-antd';
+ *
+ * function LoginPage() {
+ *   const handleLogin = async (values) => {
+ *     // 1. 登录
+ *     await loginAPI(values);
+ *
+ *     // 2. 加载权限配置
+ *     const routePermissions = await loadRoutePermissions();
+ *     const buttonPermissions = await loadButtonPermissions();
+ *
+ *     // 3. 保存到 sessionStorage（页面刷新时可恢复）
+ *     sessionStorage.setItem('routePermissions', JSON.stringify(routePermissions));
+ *     sessionStorage.setItem('buttonPermissions', JSON.stringify(buttonPermissions));
+ *
+ *     // 4. 跳转
+ *     navigate('/dashboard');
+ *   };
+ *
+ *   return <LoginForm onSubmit={handleLogin} />;
+ * }
+ *
+ * @example
+ * // 退出登录时清空权限配置
+ * function UserMenu() {
+ *   const handleLogout = () => {
+ *     session.clearUserInfo();
+ *     sessionStorage.removeItem('routePermissions');
+ *     sessionStorage.removeItem('buttonPermissions');
+ *     navigate('/login');
+ *   };
+ *
+ *   return <Button onClick={handleLogout}>退出登录</Button>;
+ * }
+ */
+export declare const ConfigProvider: React.FC<{
+    /** 子组件 */
+    children: React.ReactNode;
+    /** 初始配置对象 */
+    value: EzAntdConfig;
+}>;
+//# sourceMappingURL=ConfigProvider.d.ts.map

package/dist/ConfigProvider/ConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProvider.d.ts","sourceRoot":"","sources":["../../src/ConfigProvider/ConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,mBAAmB;AACnB,eAAO,MAAM,aAAa,6BAA6C,CAAC;AAExE,gBAAgB;AAChB,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;AAO9E;;;;;GAKG;AACH,eAAO,MAAM,SAAS,oBAAkC,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,4BAAwC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;IACpC,UAAU;IACV,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,aAAa;IACb,KAAK,EAAE,YAAY,CAAC;CACrB,CAsBA,CAAC"}

package/dist/ConfigProvider/defaults.d.ts

@@ -0,0 +1,7 @@
+import { EzAntdConfig } from './types';
+/**
+ * 默认配置
+ * 提供组件库的默认行为
+ */
+export declare const defaultConfig: EzAntdConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/ConfigProvider/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/ConfigProvider/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,SAAS,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,YAqC3B,CAAC"}

package/dist/ConfigProvider/index.d.ts

@@ -1,146 +1,5 @@
-import { default as React } from 'react';
-/**
- * HTTP 请求配置接口
- */
-export interface RequestConfig {
-    /** 请求头 */
-    headers?: {
-        [name: string]: string;
-    };
-    /** 其他配置项 */
-    [key: string]: any;
-}
-/**
- * 请求参数接口
- */
-export interface RequestParam {
-    [name: string]: any;
-}
-/**
- * Axios 响应接口
- * 模拟 Axios 的响应结构
- */
-export interface AxiosResponse<T = any> {
-    /** 响应数据 */
-    data: T;
-    /** HTTP 状态码 */
-    status: number;
-    /** HTTP 状态文本 */
-    statusText: string;
-    /** 原始请求对象 */
-    request?: any;
-    /** 其他属性 */
-    [key: string]: any;
-}
-/**
- * 请求方法接口
- * 定义基本的 HTTP 请求方法
- */
-export interface Request {
-    /**
-     * GET 请求
-     * @param url 请求 URL
-     * @param params 查询参数
-     * @param config 请求配置
-     * @returns Promise 响应
-     */
-    getRequest: (url: string, params?: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
-    /**
-     * PUT 请求
-     * @param url 请求 URL
-     * @param data 请求体数据
-     * @param config 请求配置
-     * @returns Promise 响应
-     */
-    putRequest: (url: string, data: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
-    /**
-     * DELETE 请求
-     * @param url 请求 URL
-     * @param params 查询参数
-     * @param config 请求配置
-     * @returns Promise 响应
-     */
-    deleteRequest: (url: string, params?: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
-    /**
-     * POST 请求
-     * @param url 请求 URL
-     * @param data 请求体数据
-     * @param config 请求配置
-     * @returns Promise 响应
-     */
-    postRequest: (url: string, data: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
-}
-/**
- * EzAntd 全局配置接口
- * 用于配置组件库的全局行为
- */
-export interface EzAntdConfig {
-    /** 全局请求方法对象，提供 GET/POST/PUT/DELETE 方法 */
-    request?: Request;
-    /**
-     * 判断请求响应是否成功
-     * @param response 响应对象
-     * @returns 是否成功
-     */
-    responseIsSuccess?: (response: any) => boolean;
-    /**
-     * 文件上传方法
-     * @param url 上传 URL
-     * @param formData 表单数据
-     * @returns Promise 响应
-     */
-    upload?: (url: string, formData: FormData) => Promise<any>;
-    /**
-     * 判断用户是否已登录
-     * @returns 是否已登录
-     */
-    isAuthenticated?: () => boolean;
-    /**
-     * 判断是否拥有权限
-     * @param permission 权限标识,支持单个权限、权限数组、undefined 或 null
-     * @returns 是否拥有权限
-     */
-    hasPermission?: (permission: string | string[] | undefined | null) => boolean;
-    /**
-     * 判断是否拥有角色
-     * @param role 角色标识,支持单个角色、角色数组、undefined 或 null
-     * @returns 是否拥有角色
-     */
-    hasRole?: (role: string | string[] | undefined | null) => boolean;
-}
-/** 全局配置 Context */
-export declare const ConfigContext: React.Context<EzAntdConfig>;
-/**
- * 获取全局配置的 Hook
- * @returns 全局配置对象
- * @example
- * const { request, responseIsSuccess } = useConfig();
- */
-export declare const useConfig: () => EzAntdConfig;
-/**
- * 全局配置提供者组件
- * 用于为整个应用提供全局配置
- *
- * @example
- * import { ConfigProvider } from 'ez-react-antd';
- * import request from './utils/request';
- * import { isAuthenticated, hasPermission, hasRole } from './utils/auth';
- *
- * <ConfigProvider value={{
- *   request: request,
- *   responseIsSuccess: (res) => res.status === 200 && res.data.code === 0,
- *   upload: (url, formData) => request.postRequest(url, formData),
- *   isAuthenticated: () => isAuthenticated(),
- *   hasPermission: (permission) => hasPermission(permission),
- *   hasRole: (role) => hasRole(role)
- * }}>
- *   <App />
- * </ConfigProvider>
- */
-export declare const ConfigProvider: React.FC<{
-    /** 子组件 */
-    children: React.ReactNode;
-    /** 配置对象 */
-    value: EzAntdConfig;
-}>;
+export type { RequestConfig, RequestParam, AxiosResponse, Request, EzAntdConfig, RoutePermissionMap, ButtonPermissionMap, } from './types';
+export { defaultConfig } from './defaults';
+export { ConfigProvider, ConfigContext, useConfig, useUpdateConfig, type UpdateConfigFunction } from './ConfigProvider';
+export { getRoutePermission, getButtonPermission, getFirstAccessibleRoute, hasButtonPermission, hasRoutePermission } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/ConfigProvider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ConfigProvider/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,OAAO,CAAC,EAAE;QACR,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACxB,CAAC;IACF,YAAY;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,WAAW;IACX,IAAI,EAAE,CAAC,CAAC;IACR,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,WAAW;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,UAAU,EAAE,CACV,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,CACV,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,aAAa,EAAE,CACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,WAAW,EAAE,CACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC;AAGD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC;IAC/C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC;IAC9E;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC;CACnE;AAwCD,mBAAmB;AACnB,eAAO,MAAM,aAAa,6BAA6C,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,SAAS,oBAAkC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC;IACpC,UAAU;IACV,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW;IACX,KAAK,EAAE,YAAY,CAAC;CACrB,CAMA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ConfigProvider/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,eAAe,EACf,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,SAAS,CAAC"}

package/dist/ConfigProvider/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * HTTP 请求配置接口
+ */
+export interface RequestConfig {
+    /** 请求头 */
+    headers?: {
+        [name: string]: string;
+    };
+    /** 其他配置项 */
+    [key: string]: any;
+}
+/**
+ * 请求参数接口
+ */
+export interface RequestParam {
+    [name: string]: any;
+}
+/**
+ * Axios 响应接口
+ * 模拟 Axios 的响应结构
+ */
+export interface AxiosResponse<T = any> {
+    /** 响应数据 */
+    data: T;
+    /** HTTP 状态码 */
+    status: number;
+    /** HTTP 状态文本 */
+    statusText: string;
+    /** 原始请求对象 */
+    request?: any;
+    /** 其他属性 */
+    [key: string]: any;
+}
+/**
+ * 请求方法接口
+ * 定义基本的 HTTP 请求方法
+ */
+export interface Request {
+    /**
+     * GET 请求
+     * @param url 请求 URL
+     * @param params 查询参数
+     * @param config 请求配置
+     * @returns Promise 响应
+     */
+    getRequest: (url: string, params?: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
+    /**
+     * PUT 请求
+     * @param url 请求 URL
+     * @param data 请求体数据
+     * @param config 请求配置
+     * @returns Promise 响应
+     */
+    putRequest: (url: string, data: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
+    /**
+     * DELETE 请求
+     * @param url 请求 URL
+     * @param params 查询参数
+     * @param config 请求配置
+     * @returns Promise 响应
+     */
+    deleteRequest: (url: string, params?: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
+    /**
+     * POST 请求
+     * @param url 请求 URL
+     * @param data 请求体数据
+     * @param config 请求配置
+     * @returns Promise 响应
+     */
+    postRequest: (url: string, data: RequestParam, config?: RequestConfig) => Promise<AxiosResponse<any>>;
+}
+/**
+ * 路由权限配置对象
+ */
+export interface RoutePermissionConfig {
+    /**
+     * 是否需要登录
+     * - true: 需要登录才能访问（默认值）
+     * - false: 不需要登录，公开访问
+     */
+    requiresAuthentication: boolean;
+    /**
+     * 所需权限 ID
+     * - string: 必须拥有该权限
+     * - string[]: 拥有其中任意一个权限即可
+     * - undefined: 不需要权限验证（但可能需要登录，取决于 requiresAuthentication）
+     */
+    permissionIds?: string | string[];
+}
+/**
+ * 路由权限映射配置
+ * 用于配置路由路径与所需权限的映射关系
+ */
+export interface RoutePermissionMap {
+    /**
+     * 路由路径到权限配置的映射
+     *
+     * @example
+     * {
+     *   '/login': {
+     *     requiresAuthentication: false            // 公开访问，不需要登录
+     *   },
+     *   '/public': {
+     *     requiresAuthentication: false,           // 公开访问
+     *     permissionIds: undefined
+     *   },
+     *   '/dashboard': {
+     *     requiresAuthentication: true,            // 需要登录，不需要权限
+     *     permissionIds: undefined
+     *   },
+     *   '/admin': {
+     *     requiresAuthentication: true,            // 需要登录 + 需要权限
+     *     permissionIds: 'admin.view'
+     *   },
+     *   '/admin/users': {
+     *     requiresAuthentication: true,            // 需要登录 + 需要任一权限
+     *     permissionIds: ['user.view', 'user.manage']
+     *   }
+     *   // 未配置的路由默认需要登录但不需要权限
+     * }
+     */
+    [path: string]: undefined | RoutePermissionConfig;
+}
+/**
+ * 按钮权限配置对象
+ */
+export interface ButtonPermissionConfig {
+    /**
+     * 是否需要登录
+     * - true: 需要登录才能显示（默认值）
+     * - false: 不需要登录，公开显示
+     */
+    requiresAuthentication: boolean;
+    /**
+     * 所需权限 ID
+     * - string: 必须拥有该权限
+     * - string[]: 拥有其中任意一个权限即可
+     * - undefined: 不需要权限验证（但可能需要登录，取决于 requiresAuthentication）
+     */
+    permissionIds?: string | string[];
+}
+/**
+ * 按钮权限映射配置
+ * 用于配置按钮编码与所需权限的映射关系
+ */
+export interface ButtonPermissionMap {
+    /**
+     * 按钮编码到权限配置的映射
+     *
+     * @example
+     * {
+     *   'user.create': {
+     *     requiresAuthentication: true,
+     *     permissionIds: 'user.create'
+     *   },
+     *   'user.delete': {
+     *     requiresAuthentication: true,
+     *     permissionIds: ['user.delete', 'user.manage']  // 任一权限即可
+     *   },
+     *   'user.export': {
+     *     requiresAuthentication: true  // 需要登录，不需要权限
+     *   },
+     *   'public.view': {
+     *     requiresAuthentication: false  // 公开显示
+     *   }
+     *   // 未配置的按钮默认需要登录但不需要权限
+     * }
+     */
+    [code: string]: undefined | ButtonPermissionConfig;
+}
+/**
+ * EzAntd 全局配置接口
+ * 用于配置组件库的全局行为
+ */
+export interface EzAntdConfig {
+    /** 全局请求方法对象，提供 GET/POST/PUT/DELETE 方法 */
+    request?: Request;
+    /**
+     * 判断请求响应是否成功
+     * @param response 响应对象
+     * @returns 是否成功
+     */
+    responseIsSuccess?: (response: any) => boolean;
+    /**
+     * 文件上传方法
+     * @param url 上传 URL
+     * @param formData 表单数据
+     * @returns Promise 响应
+     */
+    upload?: (url: string, formData: FormData) => Promise<any>;
+    /**
+     * 判断用户是否已登录
+     * @returns 是否已登录
+     */
+    isAuthenticated?: () => boolean;
+    /**
+     * 判断是否拥有权限
+     * @param permission 权限标识,支持单个权限、权限数组、undefined 或 null
+     * @returns 是否拥有权限
+     */
+    hasPermission?: (permission: string | string[] | undefined | null) => boolean;
+    /**
+     * 判断是否拥有角色
+     * @param role 角色标识,支持单个角色、角色数组、undefined 或 null
+     * @returns 是否拥有角色
+     */
+    hasRole?: (role: string | string[] | undefined | null) => boolean;
+    /**
+     * 获取路由权限映射配置（函数形式）
+     * 动态获取路由路径与所需权限的映射关系
+     * 使用函数形式可以避免页面刷新后配置丢失
+     *
+     * @returns 路由权限映射对象
+     * @example
+     * getRoutePermissions: () => {
+     *   const cached = sessionStorage.getItem('routePermissions');
+     *   return cached ? JSON.parse(cached) : {};
+     * }
+     */
+    getRoutePermissions?: () => RoutePermissionMap;
+    /**
+     * 获取按钮权限映射配置（函数形式）
+     * 动态获取按钮编码与所需权限的映射关系
+     * 使用函数形式可以避免页面刷新后配置丢失
+     *
+     * @returns 按钮权限映射对象
+     * @example
+     * getButtonPermissions: () => {
+     *   const cached = sessionStorage.getItem('buttonPermissions');
+     *   return cached ? JSON.parse(cached) : {};
+     * }
+     */
+    getButtonPermissions?: () => ButtonPermissionMap;
+    /**
+     * 登录页面路径
+     * 未登录时重定向到此路径
+     * @default '/login'
+     */
+    loginPath?: string;
+    /**
+     * 无权限页面路径
+     * 没有权限时重定向到此路径
+     * @default '/403'
+     */
+    forbiddenPath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ConfigProvider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ConfigProvider/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU;IACV,OAAO,CAAC,EAAE;QACR,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACxB,CAAC;IACF,YAAY;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,WAAW;IACX,IAAI,EAAE,CAAC,CAAC;IACR,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,WAAW;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,UAAU,EAAE,CACV,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,CACV,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,aAAa,EAAE,CACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,WAAW,EAAE,CACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,aAAa,KACnB,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC;AAGD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,CAAC;CACnD;AAID;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,sBAAsB,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC;IAC/C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC;IAC9E;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC;IAClE;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,MAAM,kBAAkB,CAAC;IAC/C;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,EAAE,MAAM,mBAAmB,CAAC;IACjD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}