@lemon-fe/vite-plugin-micro-frontend 1.1.3 → 1.1.5

package/dist/index.d.ts

@@ -1,7 +1,37 @@
 import { Plugin, PluginOption } from 'vite';
 export { default as cssInjectedByJsPlugin } from 'vite-plugin-css-injected-by-js';
-import { VitePluginFederationOptions } from '@originjs/vite-plugin-federation';
-import { ComponentType } from 'react';
+import { ModuleFederationOptions } from '@module-federation/vite/lib/utils/normalizeModuleFederationOptions';
+
+interface DevHmrPluginOptions {
+    /** 入口文件路径，相对于项目根目录，默认为 src/main.tsx */
+    entry?: string;
+}
+/**
+ * 微前端开发环境 HMR 插件（合并版）
+ * 1. HTML 转换：仅移除 @vitejs/plugin-react 注入的默认 refresh 脚本，避免乾坤下路径错误和控制台报错（不在此注入替换脚本）
+ * 2. 入口注入：在入口最顶部自动注入 react-refresh-init，由它统一负责 preamble、@react-refresh 加载、proxy 注入和 HMR 监听
+ * 仅开发环境生效，通过 microFrontendPlugins 的 htmlTransform 配置项启用，无需在 vite.config 中显式添加
+ */
+declare function devHmrPlugin(options?: DevHmrPluginOptions): Plugin;
+
+/**
+ * 页面路由自动生成插件
+ */
+declare function pagesRoutesPlugin(options?: RoutesPluginOptions): VitePlugin;
+
+/**
+ * mf.tsx 文件生成器插件
+ * 根据配置的远程模块自动生成模块联邦工具文件
+ */
+declare function mfGeneratorPlugin(options: MfGeneratorOptions): VitePlugin;
+
+/**
+ * 模块联邦插件
+ * 整合了 federation 配置、exposes 自动扫描、remotes URL 构建等功能
+ */
+declare function federationPlugin(federationOptions: FederationConfig): PluginOption[];
+
+declare function autoExternalAntd(): Plugin;
 
 /**
  * 远程模块配置
@@ -19,11 +49,10 @@ interface RemoteConfig {
 /**
  * 模块联邦配置
  */
-interface FederationConfig extends Omit<VitePluginFederationOptions, "remotes"> {
-    /** 应用名称 */
-    name: string;
-    /** 远程入口文件名 */
-    filename?: string;
+interface FederationConfig extends Omit<ModuleFederationOptions, "remotes"> {
+    /** 暴露的模块 */
+    shared?: Record<string, string>;
+    exposes?: Record<string, string>;
     /**
      * exposes 目录路径，默认为 src/exposes
      * 插件会自动扫描该目录下的子目录作为暴露的模块
@@ -114,7 +143,7 @@ interface MicroFrontendPluginOptions {
     /** 路由插件选项 */
     routes?: RoutesPluginOptions;
     /** 是否启用 HTML 转换（移除 refresh 脚本） */
-    htmlTransform?: boolean;
+    htmlTransform?: boolean | DevHmrPluginOptions;
     /** qiankun 配置 */
     qiankun?: {
         /** 是否启用 qiankun */
@@ -125,45 +154,6 @@ interface MicroFrontendPluginOptions {
 }
 type VitePlugin = Plugin;
 
-/**
- * HTML 转换插件 - 开发环境下处理 React Refresh 脚本
- * 在乾坤微前端场景下，需要替换默认的 refresh 脚本以支持沙箱环境
- * 只在开发环境（vite dev）下生效，生产环境不做任何处理
- */
-declare function htmlRemoveFreshPlugin(): VitePlugin;
-
-/**
- * 页面路由自动生成插件
- */
-declare function pagesRoutesPlugin(options?: RoutesPluginOptions): VitePlugin;
-
-/**
- * mf.tsx 文件生成器插件
- * 根据配置的远程模块自动生成模块联邦工具文件
- */
-declare function mfGeneratorPlugin(options: MfGeneratorOptions): VitePlugin;
-
-/**
- * 模块联邦插件
- * 整合了 federation 配置、exposes 自动扫描、remotes URL 构建等功能
- */
-declare function federationPlugin(federationOptions: FederationConfig): PluginOption[];
-
-declare function autoExternalAntd(): Plugin;
-
-interface DynamicOptions<P = Record<string, unknown>> {
-    /** 动态加载函数，返回一个包含 default 导出的 Promise */
-    loader: () => Promise<{
-        default: ComponentType<P>;
-    }>;
-    /** 加载中/加载失败时显示的组件 */
-    loading?: ComponentType<any>;
-}
-/**
- * 封装动态导入函数，兼容 Umi 的 dynamic
- */
-declare function dynamic<P = Record<string, unknown>>(options: DynamicOptions<P>): ComponentType<P>;
-
 type WithFalse<T> = {
   [P in keyof T]?: T[P] | false;
 };
@@ -211,5 +201,5 @@ declare function getRoutes(opts: IOpts): IRoute[];
  */
 declare function microFrontendPlugins(options: MicroFrontendPluginOptions): PluginOption[];
 
-export { autoExternalAntd, dynamic, federationPlugin, getRoutes, htmlRemoveFreshPlugin, mfGeneratorPlugin, microFrontendPlugins, pagesRoutesPlugin };
-export type { ComponentMetadata, DynamicOptions, FederationConfig, IRoute, MfGeneratorOptions, MicroFrontendPluginOptions, RemoteConfig, RouteConfig, RoutesPluginOptions, RoutesTemplateOptions, VitePlugin };
+export { autoExternalAntd, devHmrPlugin, federationPlugin, getRoutes, mfGeneratorPlugin, microFrontendPlugins, pagesRoutesPlugin };
+export type { ComponentMetadata, FederationConfig, IRoute, MfGeneratorOptions, MicroFrontendPluginOptions, RemoteConfig, RouteConfig, RoutesPluginOptions, RoutesTemplateOptions, VitePlugin };