@4399ywkf/core 5.3.1 → 5.4.1

package/dist/{schema-Ade9gA3U.d.ts → schema-BblOKuYl.d.ts}

@@ -1,47 +1,47 @@
 import { Configuration } from '@rspack/core';
-import { a as AppConfig, P as ProviderConfig } from './types-ZJhd87ue.js';
+import { P as ProviderConfig, a as AppConfig } from './types-DZ7Nz9bQ.js';
 
 /**
  * 路由项定义
  */
 interface RouteItem {
-    /** 路由路径 */
-    path: string;
+    /** 子路由 */
+    children?: RouteItem[];
     /** 组件文件路径（相对于 src） */
     component: string;
     /** 是否为 index 路由 */
     index?: boolean;
     /** 是否为布局组件 */
     isLayout?: boolean;
-    /** 子路由 */
-    children?: RouteItem[];
     /** 路由元信息 */
     meta?: RouteMeta;
+    /** 路由路径 */
+    path: string;
 }
 /**
  * 路由元信息
  */
 interface RouteMeta {
-    /** 页面标题 */
-    title?: string;
-    /** 是否需要登录 */
-    auth?: boolean;
     /** 自定义数据 */
     [key: string]: unknown;
+    /** 是否需要登录 */
+    auth?: boolean;
+    /** 页面标题 */
+    title?: string;
 }
 
 /**
  * 插件上下文
  */
 interface PluginContext {
+    /** 用户配置 */
+    config: Required<YwkfConfig>;
     /** 工作目录 */
     cwd: string;
     /** 是否开发模式 */
     isDev: boolean;
     /** 是否生产模式 */
     isProd: boolean;
-    /** 用户配置 */
-    config: Required<YwkfConfig>;
     /** 日志工具 */
     logger: PluginLogger;
 }
@@ -49,23 +49,15 @@ interface PluginContext {
  * 插件日志工具
  */
 interface PluginLogger {
+    debug: (message: string) => void;
+    error: (message: string) => void;
     info: (message: string) => void;
     warn: (message: string) => void;
-    error: (message: string) => void;
-    debug: (message: string) => void;
 }
 /**
  * 构建阶段钩子
  */
 interface BuildHooks {
-    /**
-     * 修改 Rspack 配置
-     */
-    modifyRspackConfig?: (config: Configuration, context: PluginContext) => Configuration | undefined | Promise<Configuration | undefined>;
-    /**
-     * 构建开始前
-     */
-    beforeBuild?: (context: PluginContext) => void | Promise<void>;
     /**
      * 构建完成后
      */
@@ -73,10 +65,6 @@ interface BuildHooks {
         success: boolean;
         errors?: string[];
     }) => void | Promise<void>;
-    /**
-     * 开发服务器启动前
-     */
-    beforeDevServer?: (context: PluginContext) => void | Promise<void>;
     /**
      * 开发服务器启动后
      */
@@ -84,104 +72,116 @@ interface BuildHooks {
         port: number;
         host: string;
     }) => void | Promise<void>;
+    /**
+     * 构建开始前
+     */
+    beforeBuild?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * 开发服务器启动前
+     */
+    beforeDevServer?: (context: PluginContext) => void | Promise<void>;
+    /**
+     * 修改 Rspack 配置
+     */
+    modifyRspackConfig?: (config: Configuration, context: PluginContext) => Configuration | undefined | Promise<Configuration | undefined>;
 }
 /**
  * 路由阶段钩子
  */
 interface RouterHooks {
-    /**
-     * 修改路由配置
-     */
-    modifyRoutes?: (routes: RouteItem[], context: PluginContext) => RouteItem[] | undefined | Promise<RouteItem[] | undefined>;
     /**
      * 路由生成后
      */
     afterRoutesGenerated?: (routes: RouteItem[], context: PluginContext) => void | Promise<void>;
+    /**
+     * 修改路由配置
+     */
+    modifyRoutes?: (routes: RouteItem[], context: PluginContext) => RouteItem[] | undefined | Promise<RouteItem[] | undefined>;
 }
 /**
  * 运行时阶段钩子
  */
 interface RuntimeHooks {
-    /**
-     * 修改运行时配置
-     */
-    modifyAppConfig?: (appConfig: AppConfig, context: PluginContext) => AppConfig | undefined;
     /**
      * 添加 Provider
      */
     addProvider?: (context: PluginContext) => ProviderConfig | ProviderConfig[];
+    /**
+     * 应用渲染后
+     */
+    afterRender?: (context: PluginContext) => void;
     /**
      * 应用渲染前
      */
     beforeRender?: (context: PluginContext) => void;
     /**
-     * 应用渲染后
+     * 修改运行时配置
      */
-    afterRender?: (context: PluginContext) => void;
+    modifyAppConfig?: (appConfig: AppConfig, context: PluginContext) => AppConfig | undefined;
 }
 /**
  * 生成的文件
  */
 interface GeneratedFile {
-    /** 文件路径（相对于 .ywkf 目录） */
-    path: string;
     /** 文件内容 */
     content: string;
+    /** 文件路径（相对于 .ywkf 目录） */
+    path: string;
 }
 /**
  * 代码生成器上下文
  */
 interface GeneratorContext {
-    /** 工作目录 */
-    cwd: string;
-    /** 输出目录（.ywkf） */
-    outputDir: string;
     /** 用户配置 */
     config: Required<YwkfConfig>;
+    /** 工作目录 */
+    cwd: string;
     /** 是否开发模式 */
     isDev: boolean;
+    /** 输出目录（.ywkf） */
+    outputDir: string;
 }
 /**
  * 代码注入点
  */
 interface CodeInjection {
+    /** 导出语句 */
+    exports?: string[];
     /** 导入语句 */
     imports?: string[];
     /** 顶层代码（在函数外部） */
     topLevel?: string[];
-    /** 导出语句 */
-    exports?: string[];
 }
 /**
  * 代码生成阶段钩子
  */
 interface GeneratorHooks {
     /**
-     * 修改入口文件代码
-     */
-    modifyEntryCode?: (code: string, context: GeneratorContext) => string | undefined;
-    /**
-     * 修改启动文件代码
+     * 代码生成完成后
      */
-    modifyBootstrapCode?: (code: string, context: GeneratorContext) => string | undefined;
+    afterGenerate?: (context: GeneratorContext) => void | Promise<void>;
     /**
-     * 注入入口代码
-     * 返回需要注入到入口文件的代码片段
+     * 生成额外文件
      */
-    injectEntry?: (context: GeneratorContext) => CodeInjection | undefined;
+    generateFiles?: (context: GeneratorContext) => GeneratedFile[] | undefined;
     /**
      * 注入启动代码
      * 返回需要注入到启动文件的代码片段
      */
     injectBootstrap?: (context: GeneratorContext) => CodeInjection | undefined;
     /**
-     * 生成额外文件
+     * 注入入口代码
+     * 返回需要注入到入口文件的代码片段
      */
-    generateFiles?: (context: GeneratorContext) => GeneratedFile[] | undefined;
+    injectEntry?: (context: GeneratorContext) => CodeInjection | undefined;
     /**
-     * 代码生成完成后
+     * 修改启动文件代码
      */
-    afterGenerate?: (context: GeneratorContext) => void | Promise<void>;
+    modifyBootstrapCode?: (code: string, context: GeneratorContext) => string | undefined;
+    /**
+     * 修改入口文件代码
+     */
+    modifyEntryCode?: (code: string, context: GeneratorContext) => string | undefined;
 }
 /**
  * 插件钩子集合
@@ -192,17 +192,17 @@ interface PluginHooks extends BuildHooks, RouterHooks, RuntimeHooks, GeneratorHo
  * 插件定义
  */
 interface YwkfPlugin {
-    /** 插件名称 */
-    name: string;
-    /** 插件版本 */
-    version?: string;
     /** 插件描述 */
     description?: string;
+    /** 插件名称 */
+    name: string;
     /**
      * 插件初始化
      * @returns 插件钩子
      */
     setup: (context: PluginContext) => PluginHooks | Promise<PluginHooks>;
+    /** 插件版本 */
+    version?: string;
 }
 /**
  * 插件配置（用户在 ywkf.config.ts 中使用）
@@ -216,14 +216,14 @@ type DefinePlugin = (options?: Record<string, unknown>) => YwkfPlugin;
  * 插件 API（传递给插件的 setup 函数）
  */
 interface PluginAPI {
+    /** 添加 Rspack 插件 */
+    addRspackPlugin: (plugin: unknown) => void;
     /** 获取配置 */
     getConfig: () => Required<YwkfConfig>;
     /** 获取工作目录 */
     getCwd: () => string;
     /** 是否开发环境 */
     isDev: () => boolean;
-    /** 添加 Rspack 插件 */
-    addRspackPlugin: (plugin: unknown) => void;
     /** 修改 Rspack 配置 */
     modifyRspackConfig: (modifier: (config: Configuration) => Configuration | undefined) => void;
 }
@@ -231,12 +231,12 @@ interface PluginAPI {
 interface AnalyticsPluginOptions {
     /** 是否启用构建分析 */
     buildAnalysis?: boolean;
-    /** 是否输出构建时间 */
-    timing?: boolean;
     /** 是否分析 bundle 大小 */
     bundleSize?: boolean;
     /** 大文件警告阈值（KB） */
     sizeWarningThreshold?: number;
+    /** 是否输出构建时间 */
+    timing?: boolean;
 }
 /**
  * 构建分析插件
@@ -260,26 +260,26 @@ declare const analyticsPlugin: (options?: AnalyticsPluginOptions | undefined) =>
 
 interface BiomePluginOptions {
     /**
-     * 是否在项目根目录生成 biome.json（仅在文件不存在时）
-     * @default true
+     * 自定义 formatter 覆盖
      */
-    scaffold?: boolean;
+    formatter?: Record<string, unknown>;
     /**
      * 额外忽略的文件 glob
      */
     ignore?: string[];
     /**
-     * 自定义 linter 规则覆盖（浅合并到继承的规则上）
+     * 自定义 javascript formatter 覆盖
      */
-    rules?: Record<string, Record<string, string>>;
+    javascript?: Record<string, unknown>;
     /**
-     * 自定义 formatter 覆盖
+     * 自定义 linter 规则覆盖（浅合并到继承的规则上）
      */
-    formatter?: Record<string, unknown>;
+    rules?: Record<string, Record<string, string>>;
     /**
-     * 自定义 javascript formatter 覆盖
+     * 是否在项目根目录生成 biome.json（仅在文件不存在时）
+     * @default true
      */
-    javascript?: Record<string, unknown>;
+    scaffold?: boolean;
 }
 /**
  * Biome 代码规范插件
@@ -327,14 +327,6 @@ interface BrowserCheckPluginOptions {
      * @example ["Object.hasOwn", "Array.prototype.at", "structuredClone"]
      */
     features?: string[];
-    /**
-     * 最低浏览器版本要求（基于 UA 解析）
-     *
-     * 优先级：`minVersions` > `fromBrowserslist` 解析结果 > 内置默认值
-     *
-     * @default { chrome: 93, edge: 93, firefox: 92, safari: 15.4 }
-     */
-    minVersions?: BrowserMinVersions;
     /**
      * 从 `.browserslistrc` 文件或 `package.json` 的 `browserslist` 字段中
      * 自动读取最低浏览器版本要求。
@@ -360,21 +352,19 @@ interface BrowserCheckPluginOptions {
      * ```
      */
     fromBrowserslist?: boolean | string;
-    /**
-     * 警告页面标题
-     * @default "浏览器版本过低"
-     */
-    title?: string;
     /**
      * 警告页面描述信息
      * @default "您当前的浏览器版本不支持本应用所需的功能。请升级到以下推荐浏览器的最新版本："
      */
     message?: string;
     /**
-     * 是否显示推荐浏览器下载链接
-     * @default true
+     * 最低浏览器版本要求（基于 UA 解析）
+     *
+     * 优先级：`minVersions` > `fromBrowserslist` 解析结果 > 内置默认值
+     *
+     * @default { chrome: 93, edge: 93, firefox: 92, safari: 15.4 }
      */
-    showDownloadLinks?: boolean;
+    minVersions?: BrowserMinVersions;
     /**
      * 自定义渲染 HTML 的函数。如果提供，将替代默认的警告页面。
      */
@@ -389,6 +379,16 @@ interface BrowserCheckPluginOptions {
      * 注意：这段代码会在不支持的浏览器中执行，请使用 ES5 语法。
      */
     renderScript?: string;
+    /**
+     * 是否显示推荐浏览器下载链接
+     * @default true
+     */
+    showDownloadLinks?: boolean;
+    /**
+     * 警告页面标题
+     * @default "浏览器版本过低"
+     */
+    title?: string;
 }
 /**
  * 浏览器最低版本检查插件
@@ -444,8 +444,6 @@ declare const browserCheckPlugin: (options?: BrowserCheckPluginOptions | undefin
 interface GarfishPluginOptions {
     /** 应用名称（微前端标识） */
     appName?: string;
-    /** 是否作为主应用 */
-    master?: boolean;
     /** 子应用列表（主应用模式） */
     apps?: {
         name: string;
@@ -453,6 +451,8 @@ interface GarfishPluginOptions {
         activeRule: string;
         basename?: string;
     }[];
+    /** 是否作为主应用 */
+    master?: boolean;
     /** 沙箱配置 */
     sandbox?: {
         /** 是否开启 JS 沙箱 */
@@ -502,11 +502,21 @@ interface GarfishPluginOptions {
 declare const garfishPlugin: (options?: GarfishPluginOptions | undefined) => YwkfPlugin;
 
 interface I18nPluginOptions {
+    /**
+     * 是否自动生成初始脚手架文件
+     * @default true
+     */
+    autoScaffold?: boolean;
     /**
      * 默认语言
      * @default "zh-CN"
      */
     defaultLocale?: string;
+    /**
+     * 默认命名空间
+     * @default ["common"]
+     */
+    defaultNS?: string[];
     /**
      * 支持的语言列表
      * @default ["zh-CN", "en-US"]
@@ -524,16 +534,6 @@ interface I18nPluginOptions {
      * @default "src/locales/default"
      */
     sourceDir?: string;
-    /**
-     * 默认命名空间
-     * @default ["common"]
-     */
-    defaultNS?: string[];
-    /**
-     * 是否自动生成初始脚手架文件
-     * @default true
-     */
-    autoScaffold?: boolean;
 }
 /**
  * 国际化插件（TS-first 工作流）
@@ -561,12 +561,12 @@ interface I18nPluginOptions {
 declare const i18nPlugin: (options?: I18nPluginOptions | undefined) => YwkfPlugin;
 
 interface MockPluginOptions {
-    /** Mock 文件目录 */
-    mockDir?: string;
-    /** 是否在生产环境启用 */
-    enableInProd?: boolean;
     /** 延迟时间（模拟网络延迟） */
     delay?: number;
+    /** 是否在生产环境启用 */
+    enableInProd?: boolean;
+    /** Mock 文件目录 */
+    mockDir?: string;
     /** 前缀路径 */
     prefix?: string;
 }
@@ -604,10 +604,15 @@ declare const mockPlugin: (options?: MockPluginOptions | undefined) => YwkfPlugi
 
 interface ReactQueryPluginOptions {
     /**
-     * 默认 staleTime（毫秒）
-     * @default 5 * 60 * 1000 (5 分钟)
+     * axios baseURL
+     * @default ""
      */
-    staleTime?: number;
+    baseURL?: string;
+    /**
+     * 是否开启 React Query DevTools（仅开发模式生效）
+     * @default true
+     */
+    devtools?: boolean;
     /**
      * 默认 gcTime（毫秒）
      * @default 10 * 60 * 1000 (10 分钟)
@@ -619,15 +624,10 @@ interface ReactQueryPluginOptions {
      */
     retry?: number | boolean;
     /**
-     * 是否开启 React Query DevTools（仅开发模式生效）
-     * @default true
-     */
-    devtools?: boolean;
-    /**
-     * axios baseURL
-     * @default ""
+     * 默认 staleTime（毫秒）
+     * @default 5 * 60 * 1000 (5 分钟)
      */
-    baseURL?: string;
+    staleTime?: number;
     /**
      * 请求超时时间（毫秒）
      * @default 15000
@@ -656,16 +656,16 @@ interface ReactQueryPluginOptions {
 declare const reactQueryPlugin: (options?: ReactQueryPluginOptions | undefined) => YwkfPlugin;
 
 interface TailwindPluginOptions {
-    /**
-     * 自定义暗色模式选择器
-     * @default '&:where([data-theme="dark"], [data-theme="dark"] *)'
-     */
-    darkModeSelector?: string;
     /**
      * 是否生成 postcss.config.js（如果不存在）
      * @default true
      */
     autoConfig?: boolean;
+    /**
+     * 自定义暗色模式选择器
+     * @default '&:where([data-theme="dark"], [data-theme="dark"] *)'
+     */
+    darkModeSelector?: string;
     /**
      * 额外的 CSS 内容（追加到 index.css 之后）
      */
@@ -693,6 +693,11 @@ interface TailwindPluginOptions {
 declare const tailwindPlugin: (options?: TailwindPluginOptions | undefined) => YwkfPlugin;
 
 interface ThemePluginOptions {
+    /**
+     * 是否启用 CSS 变量
+     * @default true
+     */
+    cssVar?: boolean;
     /**
      * 是否启用暗色模式切换能力
      * @default true
@@ -702,17 +707,39 @@ interface ThemePluginOptions {
      * 默认主题模式（运行时可通过 useThemeStore 动态切换）
      * @default "light"
      */
-    defaultAppearance?: "light" | "dark" | "auto";
+    defaultAppearance?: 'light' | 'dark' | 'auto';
     /**
-     * 主色调（Lobe-UI 命名预设，运行时可通过 useThemeStore 动态切换）
+     * 是否启用外部主题注入（微前端场景）
      *
-     * 不设置时使用 Lobe-UI 默认 primary 色阶（黑色系），
-     * 可选值："blue" | "cyan" | "geekblue" | "gold" | "green" | "lime"
-     *       | "magenta" | "orange" | "purple" | "red" | "volcano" | "yellow"
+     * 启用后：
+     * - 应用启动时读取 window.__YWKF_THEME__ 作为初始覆盖
+     * - 监听 ywkf:theme-change 自定义事件，实现运行时主题同步
      *
-     * @default undefined
+     * @default false
      */
-    primaryColor?: string;
+    externalTheme?: boolean;
+    /**
+     * 是否注入全局样式重置
+     * @default true
+     */
+    globalReset?: boolean;
+    /**
+     * antd 国际化 locale 配置
+     *
+     * - `"auto"`（默认）：运行时自动检测并动态加载对应的 antd 语言包，兜底 zhCN。
+     *   检测优先级：`window.__YWKF_LOCALE__`（微前端注入）> `navigator.language` > `"zh-CN"`
+     *
+     *   auto 模式下 locale 被纳入 ThemeStore，支持：
+     *   - 用户代码通过 `useThemeStore.getState().setLocale("en-US")` 运行时切换
+     *   - 微前端主应用通过 `ywkf:locale-change` 自定义事件同步 locale
+     *   - 便捷 hook `useLocale()` 获取当前 locale（BCP 47 tag）
+     *
+     * - 指定具体名称（如 `"zhCN"` / `"enUS"`）：静态导入该语言包，无运行时开销，
+     *   locale 仍会写入 ThemeStore 但不会自动检测或监听外部事件
+     *
+     * @default "auto"
+     */
+    locale?: 'zhCN' | 'enUS' | 'zhTW' | 'jaJP' | 'koKR' | 'auto';
     /**
      * 中性色（Lobe-UI 命名预设）
      *
@@ -733,42 +760,15 @@ interface ThemePluginOptions {
      */
     prefixCls?: string;
     /**
-     * 是否启用 CSS 变量
-     * @default true
-     */
-    cssVar?: boolean;
-    /**
-     * 是否注入全局样式重置
-     * @default true
-     */
-    globalReset?: boolean;
-    /**
-     * 是否启用外部主题注入（微前端场景）
-     *
-     * 启用后：
-     * - 应用启动时读取 window.__YWKF_THEME__ 作为初始覆盖
-     * - 监听 ywkf:theme-change 自定义事件，实现运行时主题同步
-     *
-     * @default false
-     */
-    externalTheme?: boolean;
-    /**
-     * antd 国际化 locale 配置
-     *
-     * - `"auto"`（默认）：运行时自动检测并动态加载对应的 antd 语言包，兜底 zhCN。
-     *   检测优先级：`window.__YWKF_LOCALE__`（微前端注入）> `navigator.language` > `"zh-CN"`
-     *
-     *   auto 模式下 locale 被纳入 ThemeStore，支持：
-     *   - 用户代码通过 `useThemeStore.getState().setLocale("en-US")` 运行时切换
-     *   - 微前端主应用通过 `ywkf:locale-change` 自定义事件同步 locale
-     *   - 便捷 hook `useLocale()` 获取当前 locale（BCP 47 tag）
+     * 主色调（Lobe-UI 命名预设，运行时可通过 useThemeStore 动态切换）
      *
-     * - 指定具体名称（如 `"zhCN"` / `"enUS"`）：静态导入该语言包，无运行时开销，
-     *   locale 仍会写入 ThemeStore 但不会自动检测或监听外部事件
+     * 不设置时使用 Lobe-UI 默认 primary 色阶（黑色系），
+     * 可选值："blue" | "cyan" | "geekblue" | "gold" | "green" | "lime"
+     *       | "magenta" | "orange" | "purple" | "red" | "volcano" | "yellow"
      *
-     * @default "auto"
+     * @default undefined
      */
-    locale?: "zhCN" | "enUS" | "zhTW" | "jaJP" | "koKR" | "auto";
+    primaryColor?: string;
     /**
      * 将 Tooltip / Dropdown / Modal 等弹层的挂载节点限定在 ThemeWrapper 容器内
      *
@@ -849,38 +849,38 @@ declare const zustandPlugin: (options?: ZustandPluginOptions | undefined) => Ywk
  * 开发服务器配置
  */
 interface DevServerConfig {
-    /** 开发服务器端口 */
-    port?: number;
     /** 开发服务器主机 */
     host?: string;
-    /** 代理配置 */
-    proxy?: Record<string, string | object>;
     /** 是否开启 HTTPS */
     https?: boolean;
+    /** 开发服务器端口 */
+    port?: number;
+    /** 代理配置 */
+    proxy?: Record<string, string | object>;
 }
 /**
  * 输出配置
  */
 interface OutputConfig {
+    /** 是否清理输出目录 */
+    clean?: boolean;
     /** 输出目录 */
     path?: string;
     /** 公共路径 */
     publicPath?: string;
-    /** 是否清理输出目录 */
-    clean?: boolean;
 }
 /**
  * HTML 配置
  */
 interface HtmlConfig {
-    /** 页面标题 */
-    title?: string;
-    /** HTML 模板路径 */
-    template?: string;
     /** favicon 路径 */
     favicon?: string;
     /** 挂载根元素 ID */
     mountRoot?: string;
+    /** HTML 模板路径 */
+    template?: string;
+    /** 页面标题 */
+    title?: string;
 }
 /**
  * 样式配置
@@ -913,8 +913,6 @@ interface RouterConfig {
     basename?: string;
     /** 是否启用约定式路由 */
     conventional?: boolean;
-    /** 约定式路由扫描目录 */
-    pagesDir?: string;
     /** 排除的文件/目录模式 */
     exclude?: (string | RegExp)[];
     /**
@@ -934,6 +932,8 @@ interface RouterConfig {
     loading?: false | {
         component: string;
     };
+    /** 约定式路由扫描目录 */
+    pagesDir?: string;
 }
 /**
  * 微前端配置
@@ -941,21 +941,21 @@ interface RouterConfig {
 interface MicroFrontendConfig {
     /** 是否启用微前端模式 */
     enabled?: boolean;
+    /** 微前端框架类型 */
+    framework?: 'qiankun' | 'garfish';
     /** 应用名称（用于 UMD 导出） */
     name?: string;
-    /** 微前端框架类型 */
-    framework?: "qiankun" | "garfish";
 }
 /**
  * 性能配置
  */
 interface PerformanceConfig {
+    /** 是否移除 console */
+    dropConsole?: boolean;
     /** 是否启用 Rsdoctor 分析 */
     rsdoctor?: boolean;
     /** 是否开启代码分割 */
     splitChunks?: boolean;
-    /** 是否移除 console */
-    dropConsole?: boolean;
 }
 /**
  * 工具链配置
@@ -976,8 +976,6 @@ interface ToolsConfig {
  * 环境变量配置
  */
 interface EnvConfig {
-    /** 公共环境变量文件路径 */
-    publicEnvFile?: string;
     /** 环境特定的变量文件目录 */
     envDir?: string;
     /**
@@ -995,6 +993,8 @@ interface EnvConfig {
      * @default ["YWKF_PUBLIC_", "NEXT_PUBLIC_"]
      */
     exposePrefixes?: string[];
+    /** 公共环境变量文件路径 */
+    publicEnvFile?: string;
 }
 /**
  * 内置插件快捷配置
@@ -1021,19 +1021,19 @@ interface BuiltinPluginConfig {
      */
     reactQuery?: ReactQueryPluginOptions | false;
     /**
-     * Zustand 状态管理（默认启用）
+     * Tailwind CSS（默认启用）
      *
      * 设为 `false` 禁用；传入配置对象自定义参数。
      * @default {} (启用，使用默认配置)
      */
-    zustand?: ZustandPluginOptions | false;
+    tailwind?: TailwindPluginOptions | false;
     /**
-     * Tailwind CSS（默认启用）
+     * Zustand 状态管理（默认启用）
      *
      * 设为 `false` 禁用；传入配置对象自定义参数。
      * @default {} (启用，使用默认配置)
      */
-    tailwind?: TailwindPluginOptions | false;
+    zustand?: ZustandPluginOptions | false;
 }
 /**
  * 可选插件快捷配置
@@ -1051,23 +1051,17 @@ interface BuiltinPluginConfig {
  */
 interface OptionalPluginConfig {
     /**
-     * antd-style 主题系统
-     *
-     * 设为 `true` 使用默认配置启用，或传入 ThemePluginOptions 自定义。
-     */
-    theme?: ThemePluginOptions | true;
-    /**
-     * 国际化 (i18next)
+     * 构建分析
      *
-     * 设为 `true` 使用默认配置启用，或传入 I18nPluginOptions 自定义。
+     * 设为 `true` 使用默认配置启用，或传入 AnalyticsPluginOptions 自定义。
      */
-    i18n?: I18nPluginOptions | true;
+    analytics?: AnalyticsPluginOptions | true;
     /**
-     * 微前端 (Garfish)
+     * Biome 代码规范
      *
-     * 传入 GarfishPluginOptions 配置。
+     * 设为 `true` 使用默认配置启用，或传入 BiomePluginOptions 自定义。
      */
-    garfish?: GarfishPluginOptions;
+    biome?: BiomePluginOptions | true;
     /**
      * 浏览器兼容性检查
      *
@@ -1075,11 +1069,17 @@ interface OptionalPluginConfig {
      */
     browserCheck?: BrowserCheckPluginOptions | true;
     /**
-     * Biome 代码规范
+     * 微前端 (Garfish)
      *
-     * 设为 `true` 使用默认配置启用，或传入 BiomePluginOptions 自定义。
+     * 传入 GarfishPluginOptions 配置。
      */
-    biome?: BiomePluginOptions | true;
+    garfish?: GarfishPluginOptions;
+    /**
+     * 国际化 (i18next)
+     *
+     * 设为 `true` 使用默认配置启用，或传入 I18nPluginOptions 自定义。
+     */
+    i18n?: I18nPluginOptions | true;
     /**
      * Mock 数据服务
      *
@@ -1087,11 +1087,11 @@ interface OptionalPluginConfig {
      */
     mock?: MockPluginOptions | true;
     /**
-     * 构建分析
+     * antd-style 主题系统
      *
-     * 设为 `true` 使用默认配置启用，或传入 AnalyticsPluginOptions 自定义。
+     * 设为 `true` 使用默认配置启用，或传入 ThemePluginOptions 自定义。
      */
-    analytics?: AnalyticsPluginOptions | true;
+    theme?: ThemePluginOptions | true;
 }
 /**
  * 框架内部配置（不含插件快捷键）
@@ -1099,39 +1099,39 @@ interface OptionalPluginConfig {
  * 内部模块使用此类型，通过 `Required<YwkfConfig>` 确保所有字段有值。
  */
 interface YwkfConfig {
-    /** 应用名称 */
-    appName?: string;
+    /** 路径别名 */
+    alias?: Record<string, string>;
     /** 应用中文名 */
     appCName?: string;
-    /** 是否启用 React StrictMode @default true */
-    strictMode?: boolean;
-    /** 是否启用 SWC 原生 React Compiler(需 rspack ≥2.1、React 19;React 18 用 { target: "18" } 并安装 react-compiler-runtime) @default false */
-    reactCompiler?: boolean | {
-        compilationMode?: "infer" | "annotation" | "all";
-        target?: "17" | "18" | "19";
-    };
+    /** 应用名称 */
+    appName?: string;
     /** 开发服务器配置 */
     dev?: DevServerConfig;
-    /** 输出配置 */
-    output?: OutputConfig;
+    /** 环境变量配置 */
+    env?: EnvConfig;
     /** HTML 配置 */
     html?: HtmlConfig;
-    /** 样式配置 */
-    style?: StyleConfig;
-    /** 路由配置 */
-    router?: RouterConfig;
     /** 微前端配置 */
     microFrontend?: MicroFrontendConfig;
+    /** 输出配置 */
+    output?: OutputConfig;
     /** 性能配置 */
     performance?: PerformanceConfig;
-    /** 工具链配置 */
-    tools?: ToolsConfig;
-    /** 环境变量配置 */
-    env?: EnvConfig;
-    /** 路径别名 */
-    alias?: Record<string, string>;
     /** 插件列表 */
     plugins?: PluginConfig[];
+    /** 是否启用 SWC 原生 React Compiler(需 rspack ≥2.1、React 19;React 18 用 { target: "18" } 并安装 react-compiler-runtime) @default false */
+    reactCompiler?: boolean | {
+        compilationMode?: 'infer' | 'annotation' | 'all';
+        target?: '17' | '18' | '19';
+    };
+    /** 路由配置 */
+    router?: RouterConfig;
+    /** 是否启用 React StrictMode @default true */
+    strictMode?: boolean;
+    /** 样式配置 */
+    style?: StyleConfig;
+    /** 工具链配置 */
+    tools?: ToolsConfig;
 }
 /**
  * 用户输入配置（支持插件快捷键）
@@ -1172,4 +1172,4 @@ declare function defineConfig(config: YwkfUserConfig): YwkfConfig;
  */
 declare const defaultConfig: Required<YwkfConfig>;
 
-export { type AnalyticsPluginOptions as A, type BuiltinPluginConfig as B, type CodeInjection as C, type DevServerConfig as D, type EnvConfig as E, type GeneratedFile as F, type GeneratorContext as G, type HtmlConfig as H, type I18nPluginOptions as I, type GeneratorHooks as J, type PluginContext as K, type RouterHooks as L, type MicroFrontendConfig as M, type RuntimeHooks as N, type OptionalPluginConfig as O, type PerformanceConfig as P, type YwkfPlugin as Q, type RouterConfig as R, type StyleConfig as S, type ToolsConfig as T, type RouteItem as U, type DefinePlugin as V, type PluginAPI as W, type PluginLogger as X, type YwkfConfig as Y, type ZustandPluginOptions as Z, defineConfig as a, type OutputConfig as b, type YwkfUserConfig as c, defaultConfig as d, type PluginHooks as e, type PluginConfig as f, analyticsPlugin as g, type BiomePluginOptions as h, biomePlugin as i, type BrowserCheckPluginOptions as j, type BrowserMinVersions as k, browserCheckPlugin as l, type GarfishPluginOptions as m, garfishPlugin as n, getDefaultBiomeConfig as o, i18nPlugin as p, type MockPluginOptions as q, mockPlugin as r, type ReactQueryPluginOptions as s, reactQueryPlugin as t, type TailwindPluginOptions as u, type ThemePluginOptions as v, tailwindPlugin as w, themePlugin as x, type BuildHooks as y, zustandPlugin as z };
+export { type AnalyticsPluginOptions as A, type BuiltinPluginConfig as B, type CodeInjection as C, type DevServerConfig as D, type EnvConfig as E, type GeneratedFile as F, type GeneratorContext as G, type HtmlConfig as H, type I18nPluginOptions as I, type GeneratorHooks as J, type PluginContext as K, type RouterHooks as L, type MicroFrontendConfig as M, type RuntimeHooks as N, type OptionalPluginConfig as O, type PerformanceConfig as P, type YwkfPlugin as Q, type RouterConfig as R, type StyleConfig as S, type ToolsConfig as T, type RouteItem as U, type DefinePlugin as V, type PluginAPI as W, type PluginLogger as X, type YwkfConfig as Y, type ZustandPluginOptions as Z, defineConfig as a, type OutputConfig as b, type YwkfUserConfig as c, defaultConfig as d, type PluginHooks as e, type PluginConfig as f, analyticsPlugin as g, biomePlugin as h, type BiomePluginOptions as i, browserCheckPlugin as j, type BrowserCheckPluginOptions as k, type BrowserMinVersions as l, garfishPlugin as m, type GarfishPluginOptions as n, getDefaultBiomeConfig as o, i18nPlugin as p, mockPlugin as q, type MockPluginOptions as r, reactQueryPlugin as s, type ReactQueryPluginOptions as t, tailwindPlugin as u, type TailwindPluginOptions as v, themePlugin as w, type ThemePluginOptions as x, type BuildHooks as y, zustandPlugin as z };