@4399ywkf/core 5.3.1 → 5.4.0

package/dist/{types-ZJhd87ue.d.ts → types-DZ7Nz9bQ.d.ts}

@@ -7,40 +7,40 @@ type RouterInstance = ReturnType<typeof createBrowserRouter>;
  * 应用配置
  */
 interface AppConfig {
+    /** Ant Design 配置 */
+    antd?: AntdConfig;
     /** 应用名称 */
     appName?: string;
-    /** 路由实例（手动配置时使用） */
-    router?: RouterInstance;
     /** 路由 basename */
     basename?: string;
+    /** 异步 chunk 加载失败恢复配置 */
+    chunkRecovery?: boolean | ChunkRecoveryConfig;
     /**
      * 使用约定式路由
      * 设为 true 时，框架自动从 @ywkf/routes 加载生成的路由
      * 无需手动配置 router
      */
     conventionalRoutes?: boolean;
+    /** 生命周期钩子 */
+    lifecycle?: LifecycleHooks;
+    /** 自定义 Providers */
+    providers?: ProviderConfig[];
     /** 根元素 ID */
     rootId?: string;
+    /** 路由实例（手动配置时使用） */
+    router?: RouterInstance;
     /** 是否启用严格模式 */
     strictMode?: boolean;
-    /** Ant Design 配置 */
-    antd?: AntdConfig;
-    /** 自定义 Providers */
-    providers?: ProviderConfig[];
-    /** 生命周期钩子 */
-    lifecycle?: LifecycleHooks;
-    /** 异步 chunk 加载失败恢复配置 */
-    chunkRecovery?: boolean | ChunkRecoveryConfig;
 }
 /**
  * 异步 chunk 加载失败恢复配置
  */
 interface ChunkRecoveryConfig {
     /**
-     * 是否启用自动恢复
-     * 默认仅在 production 环境启用
+     * 是否允许在微前端子应用中刷新整个页面
+     * 默认 false，避免子应用刷新宿主应用
      */
-    enabled?: boolean;
+    allowInMicroApp?: boolean;
     /**
      * 当前构建的稳定标识（可选覆盖；ywkf 构建默认自动注入）
      * 同一 build 在一个标签页内最多自动刷新一次
@@ -49,10 +49,10 @@ interface ChunkRecoveryConfig {
     /** 自动刷新冷却时间（毫秒），默认 30000 */
     cooldownMs?: number;
     /**
-     * 是否允许在微前端子应用中刷新整个页面
-     * 默认 false，避免子应用刷新宿主应用
+     * 是否启用自动恢复
+     * 默认仅在 production 环境启用
      */
-    allowInMicroApp?: boolean;
+    enabled?: boolean;
     /**
      * 是否注册 unhandledrejection / vite:preloadError 全局监听
      * 默认 false；已有应用级监听时无需开启
@@ -60,36 +60,36 @@ interface ChunkRecoveryConfig {
     globalHandlers?: boolean;
 }
 /** chunk 加载失败的来源 */
-type ChunkRecoverySource = "error-boundary" | "route-error-boundary" | "unhandled-rejection" | "vite-preload-error";
+type ChunkRecoverySource = 'error-boundary' | 'route-error-boundary' | 'unhandled-rejection' | 'vite-preload-error';
 /** chunk 恢复处理结果 */
-type ChunkRecoveryOutcome = "reload-scheduled" | "reload-skipped-already-attempted" | "reload-skipped-disabled" | "reload-skipped-micro-app" | "reload-skipped-storage-unavailable" | "reload-skipped-cooldown";
+type ChunkRecoveryOutcome = 'reload-scheduled' | 'reload-skipped-already-attempted' | 'reload-skipped-disabled' | 'reload-skipped-micro-app' | 'reload-skipped-storage-unavailable' | 'reload-skipped-cooldown';
 /** chunk 恢复事件，可用于接入业务侧监控 */
 interface ChunkRecoveryEvent {
+    /** 当前使用的刷新冷却时间 */
+    cooldownMs: number;
     /** 原始错误（非 Error 类型会被标准化） */
     error: Error;
-    /** 错误来源 */
-    source: ChunkRecoverySource;
     /** 本次处理结果 */
     outcome: ChunkRecoveryOutcome;
-    /** 事件发生时间 */
-    timestamp: number;
-    /** 当前使用的刷新冷却时间 */
-    cooldownMs: number;
     /** 用于防止同一构建重复刷新的匿名恢复标识 */
     recoveryId: string;
+    /** 错误来源 */
+    source: ChunkRecoverySource;
+    /** 事件发生时间 */
+    timestamp: number;
 }
 /**
  * Ant Design 配置
  */
 interface AntdConfig {
+    /** ConfigProvider props */
+    configProvider?: Record<string, unknown>;
     /** 是否启用 */
     enabled?: boolean;
-    /** 主题配置 */
-    theme?: Record<string, unknown>;
     /** 语言包 */
     locale?: object;
-    /** ConfigProvider props */
-    configProvider?: Record<string, unknown>;
+    /** 主题配置 */
+    theme?: Record<string, unknown>;
 }
 /**
  * Provider 配置
@@ -99,10 +99,10 @@ interface ProviderConfig {
     component: React.ComponentType<{
         children: ReactNode;
     }>;
-    /** Provider props */
-    props?: Record<string, unknown>;
     /** 排序权重（越小越外层） */
     order?: number;
+    /** Provider props */
+    props?: Record<string, unknown>;
 }
 /**
  * 生命周期钩子
@@ -110,14 +110,14 @@ interface ProviderConfig {
 interface LifecycleHooks {
     /** 应用挂载前 */
     onBeforeMount?: () => void | Promise<void>;
-    /** 应用挂载后 */
-    onMounted?: () => void;
-    /** 应用卸载时 */
-    onUnmount?: () => void;
     /** 全局错误处理 */
     onError?: (error: Error, errorInfo?: React.ErrorInfo) => void;
+    /** 应用挂载后 */
+    onMounted?: () => void;
     /** chunk 加载恢复事件 */
     onRecoveryEvent?: (event: ChunkRecoveryEvent) => void;
+    /** 应用卸载时 */
+    onUnmount?: () => void;
 }
 /**
  * 应用上下文数据
@@ -127,19 +127,19 @@ interface AppContextValue {
     appName: string;
     /** 路由 basename */
     basename: string;
-    /** 是否开发环境 */
-    isDev: boolean;
     /** 环境变量 */
     env: Record<string, string | undefined>;
+    /** 是否开发环境 */
+    isDev: boolean;
 }
 /**
  * 微前端相关配置
  */
 interface MicroAppConfig {
+    /** 微前端框架类型 */
+    framework?: 'qiankun' | 'garfish';
     /** 是否作为子应用运行 */
     isMicroApp?: boolean;
-    /** 微前端框架类型 */
-    framework?: "qiankun" | "garfish";
     /** 主应用传递的 props */
     masterProps?: Record<string, unknown>;
 }
@@ -155,10 +155,10 @@ interface MicroAppConfig {
 interface Result<T = unknown> {
     /** 业务状态码，0 表示成功 */
     code: number;
-    /** 提示信息 */
-    message: string;
     /** 业务数据 */
     data: T;
+    /** 提示信息 */
+    message: string;
 }
 /**
  * 请求配置
@@ -184,23 +184,19 @@ interface Result<T = unknown> {
 interface RequestConfig {
     /** API 基础路径 */
     baseURL?: string;
-    /** 超时时间（毫秒），默认 15000 */
-    timeout?: number;
-    /** 额外请求头 */
-    headers?: Record<string, string>;
-    /** 是否携带 Cookie，默认 false */
-    withCredentials?: boolean;
+    /**
+     * 错误处理器
+     * 处理非 2xx 响应和网络错误
+     */
+    errorHandler?: (error: Record<string, unknown>) => unknown;
     /**
      * Token 获取函数
      * 返回值将被设置到 `Authorization` 请求头
      * 返回 null/undefined 则不注入
      */
     getToken?: () => string | null | undefined;
-    /**
-     * Token 前缀，默认 "Bearer"
-     * 设为空字符串则不添加前缀
-     */
-    tokenPrefix?: string;
+    /** 额外请求头 */
+    headers?: Record<string, string>;
     /**
      * 请求拦截器
      * 在 Token 注入之后执行，可用于添加签名、自定义 header 等
@@ -212,11 +208,15 @@ interface RequestConfig {
      * 返回值将作为请求的最终结果
      */
     responseInterceptor?: (response: Record<string, unknown>) => unknown;
+    /** 超时时间（毫秒），默认 15000 */
+    timeout?: number;
     /**
-     * 错误处理器
-     * 处理非 2xx 响应和网络错误
+     * Token 前缀，默认 "Bearer"
+     * 设为空字符串则不添加前缀
      */
-    errorHandler?: (error: Record<string, unknown>) => unknown;
+    tokenPrefix?: string;
+    /** 是否携带 Cookie，默认 false */
+    withCredentials?: boolean;
 }
 
 export type { AntdConfig as A, ChunkRecoveryConfig as C, LifecycleHooks as L, MicroAppConfig as M, ProviderConfig as P, RequestConfig as R, AppConfig as a, AppContextValue as b, ChunkRecoveryEvent as c, ChunkRecoveryOutcome as d, ChunkRecoverySource as e, Result as f };

package/package.json

@@ -1,10 +1,8 @@
 {
   "name": "@4399ywkf/core",
-  "version": "5.3.1",
+  "version": "5.4.0",
   "description": "4399运维开发前端框架核心",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -32,6 +30,8 @@
     },
     "./biome": "./biome.json"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
     "ywkf": "./dist/cli/index.js"
   },
@@ -74,6 +74,7 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
+    "@4399ywkf/biome-config": "^1.1.0",
     "@types/node": "^22.13.10",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
@@ -100,10 +101,10 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
     "release": "npm version patch && npm publish --access public",
+    "release:major": "npm version major && npm publish --access public",
     "release:minor": "npm version minor && npm publish --access public",
-    "release:major": "npm version major && npm publish --access public"
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }