@maxax/x-plugins-micro 1.0.3 → 1.0.4

package/dist/index.cjs

@@ -26,12 +26,63 @@ __export(index_exports, {
   getMicroApps: () => getMicroApps,
   hasMicroApps: () => hasMicroApps,
   hasValidEntry: () => hasValidEntry,
+  isPoweredByMicro: () => isPoweredByMicro,
   microAppManager: () => microAppManager,
+  qiankunWindow: () => qiankunWindow,
+  renderWithQiankun: () => renderWithQiankun,
   setupMicroPluginApps: () => setupMicroPluginApps,
-  startMicroPluginApps: () => startMicroPluginApps
+  startMicroPluginApps: () => startMicroPluginApps,
+  useMicroAppLifecycle: () => useMicroAppLifecycle
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/helper.ts
+var qiankunWindow = typeof window !== "undefined" ? window.proxy || window : {};
+var renderWithQiankun = (qiankunLifeCycle) => {
+  if (qiankunWindow == null ? void 0 : qiankunWindow.__POWERED_BY_QIANKUN__) {
+    if (!window.moudleQiankunAppLifeCycles) {
+      window.moudleQiankunAppLifeCycles = {};
+    }
+    if (qiankunWindow.qiankunName) {
+      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle;
+    }
+  }
+};
+function isPoweredByMicro() {
+  return qiankunWindow.__POWERED_BY_QIANKUN__;
+}
+function useMicroAppLifecycle({ mount, unmount, update, bootstrap }) {
+  const mountMicroApp = async (props) => {
+    await (mount == null ? void 0 : mount(props));
+  };
+  const unmountMicroApp = async (props) => {
+    await (unmount == null ? void 0 : unmount(props));
+  };
+  const updateMicroApp = async (props) => {
+    await (update == null ? void 0 : update(props));
+  };
+  const bootstrapMicroApp = async () => {
+    await (bootstrap == null ? void 0 : bootstrap());
+  };
+  if (!isPoweredByMicro()) {
+    void mountMicroApp();
+  }
+  renderWithQiankun({
+    async bootstrap() {
+      await bootstrapMicroApp();
+    },
+    async mount(props) {
+      await mountMicroApp(props);
+    },
+    async unmount(props) {
+      await unmountMicroApp(props);
+    },
+    async update(props) {
+      await updateMicroApp(props);
+    }
+  });
+}
+
 // src/setup.ts
 var import_qiankun = require("qiankun");
 var MicroAppManager = class {
@@ -189,8 +240,12 @@ function hasValidEntry(app) {
   getMicroApps,
   hasMicroApps,
   hasValidEntry,
+  isPoweredByMicro,
   microAppManager,
+  qiankunWindow,
+  renderWithQiankun,
   setupMicroPluginApps,
-  startMicroPluginApps
+  startMicroPluginApps,
+  useMicroAppLifecycle
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/setup.ts"],"sourcesContent":["export * from './setup'\nexport * from './types'\n","/**\n * 微前端应用设置和启动模块\n * @module setup\n */\n\nimport type { FrameworkConfiguration } from 'qiankun'\nimport { addGlobalUncaughtErrorHandler, registerMicroApps, start } from 'qiankun'\nimport type { MicroAppDescriptor, MicroAppSetupOptions, MicroAppStartOptions } from './types'\n\n/**\n * 微前端管理器类\n * 负责管理微应用的注册、启动和生命周期\n */\nexport class MicroAppManager {\n  /** 是否已注册微应用 */\n  private hasRegistered = false\n\n  /** 是否已启动微前端框架 */\n  private hasStarted = false\n\n  /** 微应用配置列表 */\n  private apps: MicroAppDescriptor[] = []\n\n  /** 启动配置选项 */\n  private startOptions: MicroAppStartOptions = {}\n\n  /** 自定义加载器函数 */\n  private loader?: (loading: boolean) => void\n\n  /** 自定义错误处理函数 */\n  private onError?: (event: Event | string) => void\n\n  /**\n   * 检查是否有有效的微应用配置\n   * @returns 是否存在有效的微应用\n   */\n  hasMicroApps(): boolean {\n    return this.apps.length > 0\n  }\n\n  /**\n   * 过滤出有效的微应用配置（必须有 entry）\n   * @param apps 微应用配置列表\n   * @returns 有效的微应用配置列表\n   */\n  private filterValidApps(apps: MicroAppDescriptor[]): MicroAppDescriptor[] {\n    return apps.filter((app): app is MicroAppDescriptor & { entry: string } => {\n      return typeof app.entry === 'string' && app.entry.length > 0\n    })\n  }\n\n  /**\n   * 设置微前端应用\n   * @param options 设置选项\n   */\n  setup(options: MicroAppSetupOptions): void {\n    if (this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用已经注册，跳过重复注册')\n      return\n    }\n\n    // 过滤出有效的微应用配置\n    this.apps = this.filterValidApps(options.apps)\n\n    if (!this.hasMicroApps()) {\n      console.warn('[x-micro-plugin] 没有有效的微应用配置，跳过注册')\n      return\n    }\n\n    // 保存配置选项\n    this.startOptions = options.startOptions || {}\n    this.loader = options.loader\n    this.onError = options.onError\n\n    // 注册微应用\n    this.registerMicroApps()\n\n    // 设置全局错误处理\n    this.setupErrorHandler()\n\n    this.hasRegistered = true\n  }\n\n  /**\n   * 注册微应用到 qiankun\n   */\n  private registerMicroApps(): void {\n    registerMicroApps(\n      this.apps.map(app => ({\n        name: app.name,\n        entry: app.entry!,\n        container: `#${app.containerId}`,\n        activeRule: app.activeRule,\n        props: {\n          ...app.props\n        },\n        loader: (loading: boolean) => {\n          // 调用自定义加载器\n          this.loader?.(loading)\n        }\n      }))\n    )\n  }\n\n  /**\n   * 设置全局错误处理\n   */\n  private setupErrorHandler(): void {\n    addGlobalUncaughtErrorHandler((event: Event | string) => {\n      // 调用自定义错误处理函数\n      if (this.onError) {\n        this.onError(event)\n      } else {\n        // 默认错误处理\n        console.error('[x-micro-plugin] 微应用加载错误', event)\n        // 尝试使用全局消息提示\n        if (typeof window !== 'undefined' && (window as any).$message) {\n          console.error('子应用加载失败，请稍后重试')\n        }\n      }\n    })\n  }\n\n  /**\n   * 启动微前端框架\n   */\n  start(): void {\n    if (!this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用尚未注册，请先调用 setup() 方法')\n      return\n    }\n\n    if (this.hasStarted) {\n      console.warn('[x-micro-plugin] 微前端框架已经启动，跳过重复启动')\n      return\n    }\n\n    const startOpts: FrameworkConfiguration = {\n      prefetch: this.startOptions.prefetch !== false, // 默认启用预加载\n      sandbox: {\n        experimentalStyleIsolation: this.startOptions.sandbox?.experimentalStyleIsolation ?? true,\n        strictStyleIsolation: this.startOptions.sandbox?.strictStyleIsolation ?? false,\n        ...this.startOptions.sandbox\n      },\n      ...this.startOptions\n    }\n\n    start(startOpts)\n\n    this.hasStarted = true\n  }\n\n  /**\n   * 获取已注册的微应用配置列表\n   * @returns 微应用配置列表的只读副本\n   */\n  getApps(): ReadonlyArray<MicroAppDescriptor> {\n    return [...this.apps]\n  }\n\n  /**\n   * 重置管理器状态（主要用于测试）\n   */\n  reset(): void {\n    this.hasRegistered = false\n    this.hasStarted = false\n    this.apps = []\n    this.startOptions = {}\n    this.loader = undefined\n    this.onError = undefined\n  }\n}\n\n/**\n * 全局微前端管理器实例\n */\nexport const microAppManager = new MicroAppManager()\n\n/**\n * 设置微前端应用（便捷函数）\n * @param options 设置选项\n */\nexport function setupMicroPluginApps(options: MicroAppSetupOptions): void {\n  microAppManager.setup(options)\n}\n\n/**\n * 启动微前端框架（便捷函数）\n */\nexport function startMicroPluginApps(): void {\n  microAppManager.start()\n}\n\n/**\n * 检查是否有微应用（便捷函数）\n * @returns 是否存在微应用\n */\nexport function hasMicroApps(): boolean {\n  return microAppManager.hasMicroApps()\n}\n\n/**\n * 获取微应用配置列表（便捷函数）\n * @returns 微应用配置列表\n */\nexport function getMicroApps(): ReadonlyArray<MicroAppDescriptor> {\n  return microAppManager.getApps()\n}\n\n/**\n * 类型守卫：检查微应用是否有有效的入口地址\n * @param app 微应用描述符\n * @returns 是否为有效的微应用（有入口地址）\n */\nexport function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescriptor & { entry: string } {\n  return typeof app.entry === 'string' && app.entry.length > 0\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/helper.ts","../src/setup.ts"],"sourcesContent":["export * from './helper'\nexport * from './setup'\nexport * from './types'\n","import type { QiankunLifeCycle, QiankunProps, QiankunWindow, UseMicroAppOptions } from './types'\n\n// @ts-ignore\nexport const qiankunWindow: QiankunWindow = typeof window !== 'undefined' ? window.proxy || window : {}\n\nexport const renderWithQiankun = (qiankunLifeCycle: QiankunLifeCycle) => {\n  // 函数只有一次执行机会，需要把生命周期赋值给全局\n  if (qiankunWindow?.__POWERED_BY_QIANKUN__) {\n    // @ts-ignore\n    if (!window.moudleQiankunAppLifeCycles) {\n      // @ts-ignore\n      window.moudleQiankunAppLifeCycles = {}\n    }\n    // @ts-ignore\n    if (qiankunWindow.qiankunName) {\n      // @ts-ignore\n      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle\n    }\n  }\n}\n\n/**\n * Check if the app is running under Qiankun\n * @returns Whether the app is running under Qiankun\n */\nexport function isPoweredByMicro() {\n  return qiankunWindow.__POWERED_BY_QIANKUN__\n}\n\n/**\n * Encapsulate Qiankun micro-frontend lifecycle wiring into a reusable hook\n */\nexport function useMicroAppLifecycle({ mount, unmount, update, bootstrap }: UseMicroAppOptions) {\n  /** Mount logic for the micro app */\n  const mountMicroApp = async (props?: QiankunProps) => {\n    await mount?.(props)\n  }\n\n  /** Cleanup logic when Qiankun unmounts the micro app */\n  const unmountMicroApp = async (props?: QiankunProps) => {\n    await unmount?.(props)\n  }\n\n  /** Update logic for the micro app */\n  const updateMicroApp = async (props?: QiankunProps) => {\n    await update?.(props)\n  }\n\n  /** Bootstrap logic for the micro app */\n  const bootstrapMicroApp = async () => {\n    await bootstrap?.()\n  }\n\n  if (!isPoweredByMicro()) {\n    void mountMicroApp()\n  }\n\n  renderWithQiankun({\n    async bootstrap() {\n      await bootstrapMicroApp()\n    },\n    async mount(props) {\n      await mountMicroApp(props)\n    },\n    async unmount(props) {\n      await unmountMicroApp(props)\n    },\n    async update(props) {\n      await updateMicroApp(props)\n    }\n  })\n}\n","/**\n * 微前端应用设置和启动模块\n * @module setup\n */\n\nimport type { FrameworkConfiguration } from 'qiankun'\nimport { addGlobalUncaughtErrorHandler, registerMicroApps, start } from 'qiankun'\nimport type { MicroAppDescriptor, MicroAppSetupOptions, MicroAppStartOptions } from './types'\n\n/**\n * 微前端管理器类\n * 负责管理微应用的注册、启动和生命周期\n */\nexport class MicroAppManager {\n  /** 是否已注册微应用 */\n  private hasRegistered = false\n\n  /** 是否已启动微前端框架 */\n  private hasStarted = false\n\n  /** 微应用配置列表 */\n  private apps: MicroAppDescriptor[] = []\n\n  /** 启动配置选项 */\n  private startOptions: MicroAppStartOptions = {}\n\n  /** 自定义加载器函数 */\n  private loader?: (loading: boolean) => void\n\n  /** 自定义错误处理函数 */\n  private onError?: (event: Event | string) => void\n\n  /**\n   * 检查是否有有效的微应用配置\n   * @returns 是否存在有效的微应用\n   */\n  hasMicroApps(): boolean {\n    return this.apps.length > 0\n  }\n\n  /**\n   * 过滤出有效的微应用配置（必须有 entry）\n   * @param apps 微应用配置列表\n   * @returns 有效的微应用配置列表\n   */\n  private filterValidApps(apps: MicroAppDescriptor[]): MicroAppDescriptor[] {\n    return apps.filter((app): app is MicroAppDescriptor & { entry: string } => {\n      return typeof app.entry === 'string' && app.entry.length > 0\n    })\n  }\n\n  /**\n   * 设置微前端应用\n   * @param options 设置选项\n   */\n  setup(options: MicroAppSetupOptions): void {\n    if (this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用已经注册，跳过重复注册')\n      return\n    }\n\n    // 过滤出有效的微应用配置\n    this.apps = this.filterValidApps(options.apps)\n\n    if (!this.hasMicroApps()) {\n      console.warn('[x-micro-plugin] 没有有效的微应用配置，跳过注册')\n      return\n    }\n\n    // 保存配置选项\n    this.startOptions = options.startOptions || {}\n    this.loader = options.loader\n    this.onError = options.onError\n\n    // 注册微应用\n    this.registerMicroApps()\n\n    // 设置全局错误处理\n    this.setupErrorHandler()\n\n    this.hasRegistered = true\n  }\n\n  /**\n   * 注册微应用到 qiankun\n   */\n  private registerMicroApps(): void {\n    registerMicroApps(\n      this.apps.map(app => ({\n        name: app.name,\n        entry: app.entry!,\n        container: `#${app.containerId}`,\n        activeRule: app.activeRule,\n        props: {\n          ...app.props\n        },\n        loader: (loading: boolean) => {\n          // 调用自定义加载器\n          this.loader?.(loading)\n        }\n      }))\n    )\n  }\n\n  /**\n   * 设置全局错误处理\n   */\n  private setupErrorHandler(): void {\n    addGlobalUncaughtErrorHandler((event: Event | string) => {\n      // 调用自定义错误处理函数\n      if (this.onError) {\n        this.onError(event)\n      } else {\n        // 默认错误处理\n        console.error('[x-micro-plugin] 微应用加载错误', event)\n        // 尝试使用全局消息提示\n        if (typeof window !== 'undefined' && (window as any).$message) {\n          console.error('子应用加载失败，请稍后重试')\n        }\n      }\n    })\n  }\n\n  /**\n   * 启动微前端框架\n   */\n  start(): void {\n    if (!this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用尚未注册，请先调用 setup() 方法')\n      return\n    }\n\n    if (this.hasStarted) {\n      console.warn('[x-micro-plugin] 微前端框架已经启动，跳过重复启动')\n      return\n    }\n\n    const startOpts: FrameworkConfiguration = {\n      prefetch: this.startOptions.prefetch !== false, // 默认启用预加载\n      sandbox: {\n        experimentalStyleIsolation: this.startOptions.sandbox?.experimentalStyleIsolation ?? true,\n        strictStyleIsolation: this.startOptions.sandbox?.strictStyleIsolation ?? false,\n        ...this.startOptions.sandbox\n      },\n      ...this.startOptions\n    }\n\n    start(startOpts)\n\n    this.hasStarted = true\n  }\n\n  /**\n   * 获取已注册的微应用配置列表\n   * @returns 微应用配置列表的只读副本\n   */\n  getApps(): ReadonlyArray<MicroAppDescriptor> {\n    return [...this.apps]\n  }\n\n  /**\n   * 重置管理器状态（主要用于测试）\n   */\n  reset(): void {\n    this.hasRegistered = false\n    this.hasStarted = false\n    this.apps = []\n    this.startOptions = {}\n    this.loader = undefined\n    this.onError = undefined\n  }\n}\n\n/**\n * 全局微前端管理器实例\n */\nexport const microAppManager = new MicroAppManager()\n\n/**\n * 设置微前端应用（便捷函数）\n * @param options 设置选项\n */\nexport function setupMicroPluginApps(options: MicroAppSetupOptions): void {\n  microAppManager.setup(options)\n}\n\n/**\n * 启动微前端框架（便捷函数）\n */\nexport function startMicroPluginApps(): void {\n  microAppManager.start()\n}\n\n/**\n * 检查是否有微应用（便捷函数）\n * @returns 是否存在微应用\n */\nexport function hasMicroApps(): boolean {\n  return microAppManager.hasMicroApps()\n}\n\n/**\n * 获取微应用配置列表（便捷函数）\n * @returns 微应用配置列表\n */\nexport function getMicroApps(): ReadonlyArray<MicroAppDescriptor> {\n  return microAppManager.getApps()\n}\n\n/**\n * 类型守卫：检查微应用是否有有效的入口地址\n * @param app 微应用描述符\n * @returns 是否为有效的微应用（有入口地址）\n */\nexport function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescriptor & { entry: string } {\n  return typeof app.entry === 'string' && app.entry.length > 0\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,gBAA+B,OAAO,WAAW,cAAc,OAAO,SAAS,SAAS,CAAC;AAE/F,IAAM,oBAAoB,CAAC,qBAAuC;AAEvE,MAAI,+CAAe,wBAAwB;AAEzC,QAAI,CAAC,OAAO,4BAA4B;AAEtC,aAAO,6BAA6B,CAAC;AAAA,IACvC;AAEA,QAAI,cAAc,aAAa;AAE7B,aAAO,2BAA2B,cAAc,WAAW,IAAI;AAAA,IACjE;AAAA,EACF;AACF;AAMO,SAAS,mBAAmB;AACjC,SAAO,cAAc;AACvB;AAKO,SAAS,qBAAqB,EAAE,OAAO,SAAS,QAAQ,UAAU,GAAuB;AAE9F,QAAM,gBAAgB,OAAO,UAAyB;AACpD,WAAM,+BAAQ;AAAA,EAChB;AAGA,QAAM,kBAAkB,OAAO,UAAyB;AACtD,WAAM,mCAAU;AAAA,EAClB;AAGA,QAAM,iBAAiB,OAAO,UAAyB;AACrD,WAAM,iCAAS;AAAA,EACjB;AAGA,QAAM,oBAAoB,YAAY;AACpC,WAAM;AAAA,EACR;AAEA,MAAI,CAAC,iBAAiB,GAAG;AACvB,SAAK,cAAc;AAAA,EACrB;AAEA,oBAAkB;AAAA,IAChB,MAAM,YAAY;AAChB,YAAM,kBAAkB;AAAA,IAC1B;AAAA,IACA,MAAM,MAAM,OAAO;AACjB,YAAM,cAAc,KAAK;AAAA,IAC3B;AAAA,IACA,MAAM,QAAQ,OAAO;AACnB,YAAM,gBAAgB,KAAK;AAAA,IAC7B;AAAA,IACA,MAAM,OAAO,OAAO;AAClB,YAAM,eAAe,KAAK;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;;;ACjEA,qBAAwE;AAOjE,IAAM,kBAAN,MAAsB;AAAA,EAAtB;AAEL;AAAA,wBAAQ,iBAAgB;AAGxB;AAAA,wBAAQ,cAAa;AAGrB;AAAA,wBAAQ,QAA6B,CAAC;AAGtC;AAAA,wBAAQ,gBAAqC,CAAC;AAG9C;AAAA,wBAAQ;AAGR;AAAA,wBAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,eAAwB;AACtB,WAAO,KAAK,KAAK,SAAS;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,gBAAgB,MAAkD;AACxE,WAAO,KAAK,OAAO,CAAC,QAAuD;AACzE,aAAO,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,SAAS;AAAA,IAC7D,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,SAAqC;AACzC,QAAI,KAAK,eAAe;AACtB,cAAQ,KAAK,uGAAiC;AAC9C;AAAA,IACF;AAGA,SAAK,OAAO,KAAK,gBAAgB,QAAQ,IAAI;AAE7C,QAAI,CAAC,KAAK,aAAa,GAAG;AACxB,cAAQ,KAAK,6GAAkC;AAC/C;AAAA,IACF;AAGA,SAAK,eAAe,QAAQ,gBAAgB,CAAC;AAC7C,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ;AAGvB,SAAK,kBAAkB;AAGvB,SAAK,kBAAkB;AAEvB,SAAK,gBAAgB;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAA0B;AAChC;AAAA,MACE,KAAK,KAAK,IAAI,UAAQ;AAAA,QACpB,MAAM,IAAI;AAAA,QACV,OAAO,IAAI;AAAA,QACX,WAAW,IAAI,IAAI,WAAW;AAAA,QAC9B,YAAY,IAAI;AAAA,QAChB,OAAO;AAAA,UACL,GAAG,IAAI;AAAA,QACT;AAAA,QACA,QAAQ,CAAC,YAAqB;AAhGtC;AAkGU,qBAAK,WAAL,8BAAc;AAAA,QAChB;AAAA,MACF,EAAE;AAAA,IACJ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAA0B;AAChC,sDAA8B,CAAC,UAA0B;AAEvD,UAAI,KAAK,SAAS;AAChB,aAAK,QAAQ,KAAK;AAAA,MACpB,OAAO;AAEL,gBAAQ,MAAM,+DAA4B,KAAK;AAE/C,YAAI,OAAO,WAAW,eAAgB,OAAe,UAAU;AAC7D,kBAAQ,MAAM,gFAAe;AAAA,QAC/B;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AA9HhB;AA+HI,QAAI,CAAC,KAAK,eAAe;AACvB,cAAQ,KAAK,gHAA0C;AACvD;AAAA,IACF;AAEA,QAAI,KAAK,YAAY;AACnB,cAAQ,KAAK,mHAAmC;AAChD;AAAA,IACF;AAEA,UAAM,YAAoC;AAAA,MACxC,UAAU,KAAK,aAAa,aAAa;AAAA;AAAA,MACzC,SAAS;AAAA,QACP,6BAA4B,gBAAK,aAAa,YAAlB,mBAA2B,+BAA3B,YAAyD;AAAA,QACrF,uBAAsB,gBAAK,aAAa,YAAlB,mBAA2B,yBAA3B,YAAmD;AAAA,QACzE,GAAG,KAAK,aAAa;AAAA,MACvB;AAAA,MACA,GAAG,KAAK;AAAA,IACV;AAEA,8BAAM,SAAS;AAEf,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAA6C;AAC3C,WAAO,CAAC,GAAG,KAAK,IAAI;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,gBAAgB;AACrB,SAAK,aAAa;AAClB,SAAK,OAAO,CAAC;AACb,SAAK,eAAe,CAAC;AACrB,SAAK,SAAS;AACd,SAAK,UAAU;AAAA,EACjB;AACF;AAKO,IAAM,kBAAkB,IAAI,gBAAgB;AAM5C,SAAS,qBAAqB,SAAqC;AACxE,kBAAgB,MAAM,OAAO;AAC/B;AAKO,SAAS,uBAA6B;AAC3C,kBAAgB,MAAM;AACxB;AAMO,SAAS,eAAwB;AACtC,SAAO,gBAAgB,aAAa;AACtC;AAMO,SAAS,eAAkD;AAChE,SAAO,gBAAgB,QAAQ;AACjC;AAOO,SAAS,cAAc,KAAwE;AACpG,SAAO,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,SAAS;AAC7D;","names":[]}

package/dist/index.d.cts

@@ -49,6 +49,42 @@ interface MicroAppSetupOptions {
     /** 自定义错误处理函数 */
     onError?: (event: Event | string) => void;
 }
+interface QiankunProps {
+    container?: HTMLElement;
+    [x: string]: any;
+}
+interface QiankunLifeCycle {
+    bootstrap: () => void | Promise<void>;
+    mount: (props: QiankunProps) => void | Promise<void>;
+    unmount: (props: QiankunProps) => void | Promise<void>;
+    update: (props: QiankunProps) => void | Promise<void>;
+}
+interface QiankunWindow {
+    __POWERED_BY_QIANKUN__?: boolean;
+    [x: string]: any;
+}
+interface UseMicroAppOptions {
+    /** Bootstrap logic for the micro app */
+    bootstrap?: () => Promise<void> | void;
+    /** Mount logic for the micro app, receives Qiankun props when running under Qiankun */
+    mount: (props?: QiankunProps) => Promise<void> | void;
+    /** Cleanup logic when Qiankun unmounts the micro app */
+    unmount: (props?: QiankunProps) => Promise<void> | void;
+    /** Update logic for the micro app */
+    update?: (props?: QiankunProps) => Promise<void> | void;
+}
+
+declare const qiankunWindow: QiankunWindow;
+declare const renderWithQiankun: (qiankunLifeCycle: QiankunLifeCycle) => void;
+/**
+ * Check if the app is running under Qiankun
+ * @returns Whether the app is running under Qiankun
+ */
+declare function isPoweredByMicro(): boolean | undefined;
+/**
+ * Encapsulate Qiankun micro-frontend lifecycle wiring into a reusable hook
+ */
+declare function useMicroAppLifecycle({ mount, unmount, update, bootstrap }: UseMicroAppOptions): void;
 
 /**
  * 微前端应用设置和启动模块
@@ -142,4 +178,4 @@ declare function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescript
     entry: string;
 };
 
-export { type MicroAppDescriptor, MicroAppManager, type MicroAppSetupOptions, type MicroAppStartOptions, getMicroApps, hasMicroApps, hasValidEntry, microAppManager, setupMicroPluginApps, startMicroPluginApps };
+export { type MicroAppDescriptor, MicroAppManager, type MicroAppSetupOptions, type MicroAppStartOptions, type QiankunLifeCycle, type QiankunProps, type QiankunWindow, type UseMicroAppOptions, getMicroApps, hasMicroApps, hasValidEntry, isPoweredByMicro, microAppManager, qiankunWindow, renderWithQiankun, setupMicroPluginApps, startMicroPluginApps, useMicroAppLifecycle };

package/dist/index.d.ts

@@ -49,6 +49,42 @@ interface MicroAppSetupOptions {
     /** 自定义错误处理函数 */
     onError?: (event: Event | string) => void;
 }
+interface QiankunProps {
+    container?: HTMLElement;
+    [x: string]: any;
+}
+interface QiankunLifeCycle {
+    bootstrap: () => void | Promise<void>;
+    mount: (props: QiankunProps) => void | Promise<void>;
+    unmount: (props: QiankunProps) => void | Promise<void>;
+    update: (props: QiankunProps) => void | Promise<void>;
+}
+interface QiankunWindow {
+    __POWERED_BY_QIANKUN__?: boolean;
+    [x: string]: any;
+}
+interface UseMicroAppOptions {
+    /** Bootstrap logic for the micro app */
+    bootstrap?: () => Promise<void> | void;
+    /** Mount logic for the micro app, receives Qiankun props when running under Qiankun */
+    mount: (props?: QiankunProps) => Promise<void> | void;
+    /** Cleanup logic when Qiankun unmounts the micro app */
+    unmount: (props?: QiankunProps) => Promise<void> | void;
+    /** Update logic for the micro app */
+    update?: (props?: QiankunProps) => Promise<void> | void;
+}
+
+declare const qiankunWindow: QiankunWindow;
+declare const renderWithQiankun: (qiankunLifeCycle: QiankunLifeCycle) => void;
+/**
+ * Check if the app is running under Qiankun
+ * @returns Whether the app is running under Qiankun
+ */
+declare function isPoweredByMicro(): boolean | undefined;
+/**
+ * Encapsulate Qiankun micro-frontend lifecycle wiring into a reusable hook
+ */
+declare function useMicroAppLifecycle({ mount, unmount, update, bootstrap }: UseMicroAppOptions): void;
 
 /**
  * 微前端应用设置和启动模块
@@ -142,4 +178,4 @@ declare function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescript
     entry: string;
 };
 
-export { type MicroAppDescriptor, MicroAppManager, type MicroAppSetupOptions, type MicroAppStartOptions, getMicroApps, hasMicroApps, hasValidEntry, microAppManager, setupMicroPluginApps, startMicroPluginApps };
+export { type MicroAppDescriptor, MicroAppManager, type MicroAppSetupOptions, type MicroAppStartOptions, type QiankunLifeCycle, type QiankunProps, type QiankunWindow, type UseMicroAppOptions, getMicroApps, hasMicroApps, hasValidEntry, isPoweredByMicro, microAppManager, qiankunWindow, renderWithQiankun, setupMicroPluginApps, startMicroPluginApps, useMicroAppLifecycle };

package/dist/index.mjs

@@ -2,6 +2,53 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// src/helper.ts
+var qiankunWindow = typeof window !== "undefined" ? window.proxy || window : {};
+var renderWithQiankun = (qiankunLifeCycle) => {
+  if (qiankunWindow == null ? void 0 : qiankunWindow.__POWERED_BY_QIANKUN__) {
+    if (!window.moudleQiankunAppLifeCycles) {
+      window.moudleQiankunAppLifeCycles = {};
+    }
+    if (qiankunWindow.qiankunName) {
+      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle;
+    }
+  }
+};
+function isPoweredByMicro() {
+  return qiankunWindow.__POWERED_BY_QIANKUN__;
+}
+function useMicroAppLifecycle({ mount, unmount, update, bootstrap }) {
+  const mountMicroApp = async (props) => {
+    await (mount == null ? void 0 : mount(props));
+  };
+  const unmountMicroApp = async (props) => {
+    await (unmount == null ? void 0 : unmount(props));
+  };
+  const updateMicroApp = async (props) => {
+    await (update == null ? void 0 : update(props));
+  };
+  const bootstrapMicroApp = async () => {
+    await (bootstrap == null ? void 0 : bootstrap());
+  };
+  if (!isPoweredByMicro()) {
+    void mountMicroApp();
+  }
+  renderWithQiankun({
+    async bootstrap() {
+      await bootstrapMicroApp();
+    },
+    async mount(props) {
+      await mountMicroApp(props);
+    },
+    async unmount(props) {
+      await unmountMicroApp(props);
+    },
+    async update(props) {
+      await updateMicroApp(props);
+    }
+  });
+}
+
 // src/setup.ts
 import { addGlobalUncaughtErrorHandler, registerMicroApps, start } from "qiankun";
 var MicroAppManager = class {
@@ -158,8 +205,12 @@ export {
   getMicroApps,
   hasMicroApps,
   hasValidEntry,
+  isPoweredByMicro,
   microAppManager,
+  qiankunWindow,
+  renderWithQiankun,
   setupMicroPluginApps,
-  startMicroPluginApps
+  startMicroPluginApps,
+  useMicroAppLifecycle
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/setup.ts"],"sourcesContent":["/**\n * 微前端应用设置和启动模块\n * @module setup\n */\n\nimport type { FrameworkConfiguration } from 'qiankun'\nimport { addGlobalUncaughtErrorHandler, registerMicroApps, start } from 'qiankun'\nimport type { MicroAppDescriptor, MicroAppSetupOptions, MicroAppStartOptions } from './types'\n\n/**\n * 微前端管理器类\n * 负责管理微应用的注册、启动和生命周期\n */\nexport class MicroAppManager {\n  /** 是否已注册微应用 */\n  private hasRegistered = false\n\n  /** 是否已启动微前端框架 */\n  private hasStarted = false\n\n  /** 微应用配置列表 */\n  private apps: MicroAppDescriptor[] = []\n\n  /** 启动配置选项 */\n  private startOptions: MicroAppStartOptions = {}\n\n  /** 自定义加载器函数 */\n  private loader?: (loading: boolean) => void\n\n  /** 自定义错误处理函数 */\n  private onError?: (event: Event | string) => void\n\n  /**\n   * 检查是否有有效的微应用配置\n   * @returns 是否存在有效的微应用\n   */\n  hasMicroApps(): boolean {\n    return this.apps.length > 0\n  }\n\n  /**\n   * 过滤出有效的微应用配置（必须有 entry）\n   * @param apps 微应用配置列表\n   * @returns 有效的微应用配置列表\n   */\n  private filterValidApps(apps: MicroAppDescriptor[]): MicroAppDescriptor[] {\n    return apps.filter((app): app is MicroAppDescriptor & { entry: string } => {\n      return typeof app.entry === 'string' && app.entry.length > 0\n    })\n  }\n\n  /**\n   * 设置微前端应用\n   * @param options 设置选项\n   */\n  setup(options: MicroAppSetupOptions): void {\n    if (this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用已经注册，跳过重复注册')\n      return\n    }\n\n    // 过滤出有效的微应用配置\n    this.apps = this.filterValidApps(options.apps)\n\n    if (!this.hasMicroApps()) {\n      console.warn('[x-micro-plugin] 没有有效的微应用配置，跳过注册')\n      return\n    }\n\n    // 保存配置选项\n    this.startOptions = options.startOptions || {}\n    this.loader = options.loader\n    this.onError = options.onError\n\n    // 注册微应用\n    this.registerMicroApps()\n\n    // 设置全局错误处理\n    this.setupErrorHandler()\n\n    this.hasRegistered = true\n  }\n\n  /**\n   * 注册微应用到 qiankun\n   */\n  private registerMicroApps(): void {\n    registerMicroApps(\n      this.apps.map(app => ({\n        name: app.name,\n        entry: app.entry!,\n        container: `#${app.containerId}`,\n        activeRule: app.activeRule,\n        props: {\n          ...app.props\n        },\n        loader: (loading: boolean) => {\n          // 调用自定义加载器\n          this.loader?.(loading)\n        }\n      }))\n    )\n  }\n\n  /**\n   * 设置全局错误处理\n   */\n  private setupErrorHandler(): void {\n    addGlobalUncaughtErrorHandler((event: Event | string) => {\n      // 调用自定义错误处理函数\n      if (this.onError) {\n        this.onError(event)\n      } else {\n        // 默认错误处理\n        console.error('[x-micro-plugin] 微应用加载错误', event)\n        // 尝试使用全局消息提示\n        if (typeof window !== 'undefined' && (window as any).$message) {\n          console.error('子应用加载失败，请稍后重试')\n        }\n      }\n    })\n  }\n\n  /**\n   * 启动微前端框架\n   */\n  start(): void {\n    if (!this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用尚未注册，请先调用 setup() 方法')\n      return\n    }\n\n    if (this.hasStarted) {\n      console.warn('[x-micro-plugin] 微前端框架已经启动，跳过重复启动')\n      return\n    }\n\n    const startOpts: FrameworkConfiguration = {\n      prefetch: this.startOptions.prefetch !== false, // 默认启用预加载\n      sandbox: {\n        experimentalStyleIsolation: this.startOptions.sandbox?.experimentalStyleIsolation ?? true,\n        strictStyleIsolation: this.startOptions.sandbox?.strictStyleIsolation ?? false,\n        ...this.startOptions.sandbox\n      },\n      ...this.startOptions\n    }\n\n    start(startOpts)\n\n    this.hasStarted = true\n  }\n\n  /**\n   * 获取已注册的微应用配置列表\n   * @returns 微应用配置列表的只读副本\n   */\n  getApps(): ReadonlyArray<MicroAppDescriptor> {\n    return [...this.apps]\n  }\n\n  /**\n   * 重置管理器状态（主要用于测试）\n   */\n  reset(): void {\n    this.hasRegistered = false\n    this.hasStarted = false\n    this.apps = []\n    this.startOptions = {}\n    this.loader = undefined\n    this.onError = undefined\n  }\n}\n\n/**\n * 全局微前端管理器实例\n */\nexport const microAppManager = new MicroAppManager()\n\n/**\n * 设置微前端应用（便捷函数）\n * @param options 设置选项\n */\nexport function setupMicroPluginApps(options: MicroAppSetupOptions): void {\n  microAppManager.setup(options)\n}\n\n/**\n * 启动微前端框架（便捷函数）\n */\nexport function startMicroPluginApps(): void {\n  microAppManager.start()\n}\n\n/**\n * 检查是否有微应用（便捷函数）\n * @returns 是否存在微应用\n */\nexport function hasMicroApps(): boolean {\n  return microAppManager.hasMicroApps()\n}\n\n/**\n * 获取微应用配置列表（便捷函数）\n * @returns 微应用配置列表\n */\nexport function getMicroApps(): ReadonlyArray<MicroAppDescriptor> {\n  return microAppManager.getApps()\n}\n\n/**\n * 类型守卫：检查微应用是否有有效的入口地址\n * @param app 微应用描述符\n * @returns 是否为有效的微应用（有入口地址）\n */\nexport function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescriptor & { entry: string } {\n  return typeof app.entry === 'string' && app.entry.length > 0\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/helper.ts","../src/setup.ts"],"sourcesContent":["import type { QiankunLifeCycle, QiankunProps, QiankunWindow, UseMicroAppOptions } from './types'\n\n// @ts-ignore\nexport const qiankunWindow: QiankunWindow = typeof window !== 'undefined' ? window.proxy || window : {}\n\nexport const renderWithQiankun = (qiankunLifeCycle: QiankunLifeCycle) => {\n  // 函数只有一次执行机会，需要把生命周期赋值给全局\n  if (qiankunWindow?.__POWERED_BY_QIANKUN__) {\n    // @ts-ignore\n    if (!window.moudleQiankunAppLifeCycles) {\n      // @ts-ignore\n      window.moudleQiankunAppLifeCycles = {}\n    }\n    // @ts-ignore\n    if (qiankunWindow.qiankunName) {\n      // @ts-ignore\n      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle\n    }\n  }\n}\n\n/**\n * Check if the app is running under Qiankun\n * @returns Whether the app is running under Qiankun\n */\nexport function isPoweredByMicro() {\n  return qiankunWindow.__POWERED_BY_QIANKUN__\n}\n\n/**\n * Encapsulate Qiankun micro-frontend lifecycle wiring into a reusable hook\n */\nexport function useMicroAppLifecycle({ mount, unmount, update, bootstrap }: UseMicroAppOptions) {\n  /** Mount logic for the micro app */\n  const mountMicroApp = async (props?: QiankunProps) => {\n    await mount?.(props)\n  }\n\n  /** Cleanup logic when Qiankun unmounts the micro app */\n  const unmountMicroApp = async (props?: QiankunProps) => {\n    await unmount?.(props)\n  }\n\n  /** Update logic for the micro app */\n  const updateMicroApp = async (props?: QiankunProps) => {\n    await update?.(props)\n  }\n\n  /** Bootstrap logic for the micro app */\n  const bootstrapMicroApp = async () => {\n    await bootstrap?.()\n  }\n\n  if (!isPoweredByMicro()) {\n    void mountMicroApp()\n  }\n\n  renderWithQiankun({\n    async bootstrap() {\n      await bootstrapMicroApp()\n    },\n    async mount(props) {\n      await mountMicroApp(props)\n    },\n    async unmount(props) {\n      await unmountMicroApp(props)\n    },\n    async update(props) {\n      await updateMicroApp(props)\n    }\n  })\n}\n","/**\n * 微前端应用设置和启动模块\n * @module setup\n */\n\nimport type { FrameworkConfiguration } from 'qiankun'\nimport { addGlobalUncaughtErrorHandler, registerMicroApps, start } from 'qiankun'\nimport type { MicroAppDescriptor, MicroAppSetupOptions, MicroAppStartOptions } from './types'\n\n/**\n * 微前端管理器类\n * 负责管理微应用的注册、启动和生命周期\n */\nexport class MicroAppManager {\n  /** 是否已注册微应用 */\n  private hasRegistered = false\n\n  /** 是否已启动微前端框架 */\n  private hasStarted = false\n\n  /** 微应用配置列表 */\n  private apps: MicroAppDescriptor[] = []\n\n  /** 启动配置选项 */\n  private startOptions: MicroAppStartOptions = {}\n\n  /** 自定义加载器函数 */\n  private loader?: (loading: boolean) => void\n\n  /** 自定义错误处理函数 */\n  private onError?: (event: Event | string) => void\n\n  /**\n   * 检查是否有有效的微应用配置\n   * @returns 是否存在有效的微应用\n   */\n  hasMicroApps(): boolean {\n    return this.apps.length > 0\n  }\n\n  /**\n   * 过滤出有效的微应用配置（必须有 entry）\n   * @param apps 微应用配置列表\n   * @returns 有效的微应用配置列表\n   */\n  private filterValidApps(apps: MicroAppDescriptor[]): MicroAppDescriptor[] {\n    return apps.filter((app): app is MicroAppDescriptor & { entry: string } => {\n      return typeof app.entry === 'string' && app.entry.length > 0\n    })\n  }\n\n  /**\n   * 设置微前端应用\n   * @param options 设置选项\n   */\n  setup(options: MicroAppSetupOptions): void {\n    if (this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用已经注册，跳过重复注册')\n      return\n    }\n\n    // 过滤出有效的微应用配置\n    this.apps = this.filterValidApps(options.apps)\n\n    if (!this.hasMicroApps()) {\n      console.warn('[x-micro-plugin] 没有有效的微应用配置，跳过注册')\n      return\n    }\n\n    // 保存配置选项\n    this.startOptions = options.startOptions || {}\n    this.loader = options.loader\n    this.onError = options.onError\n\n    // 注册微应用\n    this.registerMicroApps()\n\n    // 设置全局错误处理\n    this.setupErrorHandler()\n\n    this.hasRegistered = true\n  }\n\n  /**\n   * 注册微应用到 qiankun\n   */\n  private registerMicroApps(): void {\n    registerMicroApps(\n      this.apps.map(app => ({\n        name: app.name,\n        entry: app.entry!,\n        container: `#${app.containerId}`,\n        activeRule: app.activeRule,\n        props: {\n          ...app.props\n        },\n        loader: (loading: boolean) => {\n          // 调用自定义加载器\n          this.loader?.(loading)\n        }\n      }))\n    )\n  }\n\n  /**\n   * 设置全局错误处理\n   */\n  private setupErrorHandler(): void {\n    addGlobalUncaughtErrorHandler((event: Event | string) => {\n      // 调用自定义错误处理函数\n      if (this.onError) {\n        this.onError(event)\n      } else {\n        // 默认错误处理\n        console.error('[x-micro-plugin] 微应用加载错误', event)\n        // 尝试使用全局消息提示\n        if (typeof window !== 'undefined' && (window as any).$message) {\n          console.error('子应用加载失败，请稍后重试')\n        }\n      }\n    })\n  }\n\n  /**\n   * 启动微前端框架\n   */\n  start(): void {\n    if (!this.hasRegistered) {\n      console.warn('[x-micro-plugin] 微应用尚未注册，请先调用 setup() 方法')\n      return\n    }\n\n    if (this.hasStarted) {\n      console.warn('[x-micro-plugin] 微前端框架已经启动，跳过重复启动')\n      return\n    }\n\n    const startOpts: FrameworkConfiguration = {\n      prefetch: this.startOptions.prefetch !== false, // 默认启用预加载\n      sandbox: {\n        experimentalStyleIsolation: this.startOptions.sandbox?.experimentalStyleIsolation ?? true,\n        strictStyleIsolation: this.startOptions.sandbox?.strictStyleIsolation ?? false,\n        ...this.startOptions.sandbox\n      },\n      ...this.startOptions\n    }\n\n    start(startOpts)\n\n    this.hasStarted = true\n  }\n\n  /**\n   * 获取已注册的微应用配置列表\n   * @returns 微应用配置列表的只读副本\n   */\n  getApps(): ReadonlyArray<MicroAppDescriptor> {\n    return [...this.apps]\n  }\n\n  /**\n   * 重置管理器状态（主要用于测试）\n   */\n  reset(): void {\n    this.hasRegistered = false\n    this.hasStarted = false\n    this.apps = []\n    this.startOptions = {}\n    this.loader = undefined\n    this.onError = undefined\n  }\n}\n\n/**\n * 全局微前端管理器实例\n */\nexport const microAppManager = new MicroAppManager()\n\n/**\n * 设置微前端应用（便捷函数）\n * @param options 设置选项\n */\nexport function setupMicroPluginApps(options: MicroAppSetupOptions): void {\n  microAppManager.setup(options)\n}\n\n/**\n * 启动微前端框架（便捷函数）\n */\nexport function startMicroPluginApps(): void {\n  microAppManager.start()\n}\n\n/**\n * 检查是否有微应用（便捷函数）\n * @returns 是否存在微应用\n */\nexport function hasMicroApps(): boolean {\n  return microAppManager.hasMicroApps()\n}\n\n/**\n * 获取微应用配置列表（便捷函数）\n * @returns 微应用配置列表\n */\nexport function getMicroApps(): ReadonlyArray<MicroAppDescriptor> {\n  return microAppManager.getApps()\n}\n\n/**\n * 类型守卫：检查微应用是否有有效的入口地址\n * @param app 微应用描述符\n * @returns 是否为有效的微应用（有入口地址）\n */\nexport function hasValidEntry(app: MicroAppDescriptor): app is MicroAppDescriptor & { entry: string } {\n  return typeof app.entry === 'string' && app.entry.length > 0\n}\n"],"mappings":"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","names":[]}

package/dist/plugin.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugin.ts
+var plugin_exports = {};
+__export(plugin_exports, {
+  setupMicroApp: () => setupMicroApp
+});
+module.exports = __toCommonJS(plugin_exports);
+var import_cheerio = __toESM(require("cheerio"), 1);
+var createQiankunHelper = (qiankunName) => `
+  const createDeffer = (hookName) => {
+    const d = new Promise((resolve, reject) => {
+      window.proxy && (window.proxy[\`vite\${hookName}\`] = resolve)
+    })
+    return props => d.then(fn => fn(props));
+  }
+  const bootstrap = createDeffer('bootstrap');
+  const mount = createDeffer('mount');
+  const unmount = createDeffer('unmount');
+  const update = createDeffer('update');
+
+  ;(global => {
+    global.qiankunName = '${qiankunName}';
+    global['${qiankunName}'] = {
+      bootstrap,
+      mount,
+      unmount,
+      update
+    };
+  })(window);
+`;
+var createImportFinallyResolve = (qiankunName) => {
+  return `
+    const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];
+    if (qiankunLifeCycle) {
+      window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));
+      window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));
+      window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());
+      window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));
+    }
+  `;
+};
+function setupMicroApp(qiankunName, microOption = { useDevMode: true }) {
+  let isProduction;
+  let base = "";
+  const module2DynamicImport = ($, scriptTag) => {
+    if (!scriptTag) {
+      return;
+    }
+    const script$ = $(scriptTag);
+    const moduleSrc = script$.attr("src");
+    let appendBase = "";
+    if (microOption.useDevMode && !isProduction) {
+      appendBase = "(window.proxy ? (window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ + '..') : '') + ";
+    }
+    script$.removeAttr("src");
+    script$.removeAttr("type");
+    script$.html(`import(${appendBase}'${moduleSrc}')`);
+    return script$;
+  };
+  const plugin = {
+    name: "qiankun-html-transform",
+    configResolved(config) {
+      isProduction = config.command === "build" || config.isProduction;
+      base = config.base;
+    },
+    configureServer(server) {
+      return () => {
+        server.middlewares.use((req, res, next) => {
+          if (isProduction || !microOption.useDevMode) {
+            next();
+            return;
+          }
+          const end = res.end.bind(res);
+          res.end = (...args) => {
+            const [chunk, ...rest] = args;
+            let htmlStr = chunk;
+            if (typeof htmlStr === "string") {
+              const $ = import_cheerio.default.load(htmlStr);
+              module2DynamicImport($, $(`script[src=${base}@vite/client]`).get(0));
+              htmlStr = $.html();
+            }
+            end(htmlStr, ...rest);
+          };
+          next();
+        });
+      };
+    },
+    transformIndexHtml(html) {
+      const $ = import_cheerio.default.load(html);
+      const moduleTags = $('body script[type=module], head script[crossorigin=""]');
+      if (!moduleTags || !moduleTags.length) {
+        return;
+      }
+      const len = moduleTags.length;
+      moduleTags.each((i, moduleTag) => {
+        const script$ = module2DynamicImport($, moduleTag);
+        if (len - 1 === i) {
+          script$ == null ? void 0 : script$.html(`${script$.html()}.finally(() => {
+            ${createImportFinallyResolve(qiankunName)}
+          })`);
+        }
+      });
+      $("body").append(`<script>${createQiankunHelper(qiankunName)}</script>`);
+      const output = $.html();
+      return output;
+    }
+  };
+  return plugin;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setupMicroApp
+});
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { CheerioAPI } from 'cheerio'\nimport cheerio from 'cheerio'\nimport type { Element } from 'domhandler'\nimport type { Plugin } from 'vite'\n\nconst createQiankunHelper = (qiankunName: string) => `\n  const createDeffer = (hookName) => {\n    const d = new Promise((resolve, reject) => {\n      window.proxy && (window.proxy[\\`vite\\${hookName}\\`] = resolve)\n    })\n    return props => d.then(fn => fn(props));\n  }\n  const bootstrap = createDeffer('bootstrap');\n  const mount = createDeffer('mount');\n  const unmount = createDeffer('unmount');\n  const update = createDeffer('update');\n\n  ;(global => {\n    global.qiankunName = '${qiankunName}';\n    global['${qiankunName}'] = {\n      bootstrap,\n      mount,\n      unmount,\n      update\n    };\n  })(window);\n`\n\nconst createImportFinallyResolve = (qiankunName: string) => {\n  return `\n    const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];\n    if (qiankunLifeCycle) {\n      window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));\n      window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));\n      window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());\n      window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));\n    }\n  `\n}\n\nexport interface MicroOption {\n  useDevMode?: boolean\n}\n\nexport function setupMicroApp(qiankunName: string, microOption: MicroOption = { useDevMode: true }) {\n  let isProduction: boolean\n  let base = ''\n\n  const module2DynamicImport = ($: CheerioAPI, scriptTag: Element | undefined) => {\n    if (!scriptTag) {\n      return\n    }\n    const script$ = $(scriptTag)\n    const moduleSrc = script$.attr('src')\n    let appendBase = ''\n    if (microOption.useDevMode && !isProduction) {\n      appendBase = \"(window.proxy ? (window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ + '..') : '') + \"\n    }\n    script$.removeAttr('src')\n    script$.removeAttr('type')\n    script$.html(`import(${appendBase}'${moduleSrc}')`)\n    return script$\n  }\n\n  const plugin: Plugin = {\n    name: 'qiankun-html-transform',\n    configResolved(config) {\n      isProduction = config.command === 'build' || config.isProduction\n      base = config.base\n    },\n\n    configureServer(server) {\n      return () => {\n        server.middlewares.use((req, res, next) => {\n          if (isProduction || !microOption.useDevMode) {\n            next()\n            return\n          }\n          const end = res.end.bind(res)\n          // @ts-ignore\n          res.end = (...args: any[]) => {\n            const [chunk, ...rest] = args\n            let htmlStr = chunk\n            if (typeof htmlStr === 'string') {\n              const $ = cheerio.load(htmlStr)\n              module2DynamicImport($, $(`script[src=${base}@vite/client]`).get(0))\n              htmlStr = $.html()\n            }\n            end(htmlStr, ...rest)\n          }\n          next()\n        })\n      }\n    },\n    transformIndexHtml(html: string) {\n      const $ = cheerio.load(html)\n      const moduleTags = $('body script[type=module], head script[crossorigin=\"\"]')\n      if (!moduleTags || !moduleTags.length) {\n        return\n      }\n      const len = moduleTags.length\n      moduleTags.each((i, moduleTag) => {\n        const script$ = module2DynamicImport($, moduleTag)\n        if (len - 1 === i) {\n          script$?.html(`${script$.html()}.finally(() => {\n            ${createImportFinallyResolve(qiankunName)}\n          })`)\n        }\n      })\n\n      $('body').append(`<script>${createQiankunHelper(qiankunName)}</script>`)\n      const output = $.html()\n      return output\n    }\n  }\n\n  return plugin\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,qBAAoB;AAIpB,IAAM,sBAAsB,CAAC,gBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAazB,WAAW;AAAA,cACzB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASzB,IAAM,6BAA6B,CAAC,gBAAwB;AAC1D,SAAO;AAAA,uGAC8F,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQlH;AAMO,SAAS,cAAc,aAAqB,cAA2B,EAAE,YAAY,KAAK,GAAG;AAClG,MAAI;AACJ,MAAI,OAAO;AAEX,QAAM,uBAAuB,CAAC,GAAe,cAAmC;AAC9E,QAAI,CAAC,WAAW;AACd;AAAA,IACF;AACA,UAAM,UAAU,EAAE,SAAS;AAC3B,UAAM,YAAY,QAAQ,KAAK,KAAK;AACpC,QAAI,aAAa;AACjB,QAAI,YAAY,cAAc,CAAC,cAAc;AAC3C,mBAAa;AAAA,IACf;AACA,YAAQ,WAAW,KAAK;AACxB,YAAQ,WAAW,MAAM;AACzB,YAAQ,KAAK,UAAU,UAAU,IAAI,SAAS,IAAI;AAClD,WAAO;AAAA,EACT;AAEA,QAAM,SAAiB;AAAA,IACrB,MAAM;AAAA,IACN,eAAe,QAAQ;AACrB,qBAAe,OAAO,YAAY,WAAW,OAAO;AACpD,aAAO,OAAO;AAAA,IAChB;AAAA,IAEA,gBAAgB,QAAQ;AACtB,aAAO,MAAM;AACX,eAAO,YAAY,IAAI,CAAC,KAAK,KAAK,SAAS;AACzC,cAAI,gBAAgB,CAAC,YAAY,YAAY;AAC3C,iBAAK;AACL;AAAA,UACF;AACA,gBAAM,MAAM,IAAI,IAAI,KAAK,GAAG;AAE5B,cAAI,MAAM,IAAI,SAAgB;AAC5B,kBAAM,CAAC,OAAO,GAAG,IAAI,IAAI;AACzB,gBAAI,UAAU;AACd,gBAAI,OAAO,YAAY,UAAU;AAC/B,oBAAM,IAAI,eAAAA,QAAQ,KAAK,OAAO;AAC9B,mCAAqB,GAAG,EAAE,cAAc,IAAI,eAAe,EAAE,IAAI,CAAC,CAAC;AACnE,wBAAU,EAAE,KAAK;AAAA,YACnB;AACA,gBAAI,SAAS,GAAG,IAAI;AAAA,UACtB;AACA,eAAK;AAAA,QACP,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA,mBAAmB,MAAc;AAC/B,YAAM,IAAI,eAAAA,QAAQ,KAAK,IAAI;AAC3B,YAAM,aAAa,EAAE,uDAAuD;AAC5E,UAAI,CAAC,cAAc,CAAC,WAAW,QAAQ;AACrC;AAAA,MACF;AACA,YAAM,MAAM,WAAW;AACvB,iBAAW,KAAK,CAAC,GAAG,cAAc;AAChC,cAAM,UAAU,qBAAqB,GAAG,SAAS;AACjD,YAAI,MAAM,MAAM,GAAG;AACjB,6CAAS,KAAK,GAAG,QAAQ,KAAK,CAAC;AAAA,cAC3B,2BAA2B,WAAW,CAAC;AAAA;AAAA,QAE7C;AAAA,MACF,CAAC;AAED,QAAE,MAAM,EAAE,OAAO,WAAW,oBAAoB,WAAW,CAAC,WAAW;AACvE,YAAM,SAAS,EAAE,KAAK;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;","names":["cheerio"]}

package/dist/plugin.d.cts

@@ -0,0 +1,8 @@
+import { Plugin } from 'vite';
+
+interface MicroOption {
+    useDevMode?: boolean;
+}
+declare function setupMicroApp(qiankunName: string, microOption?: MicroOption): Plugin<any>;
+
+export { type MicroOption, setupMicroApp };

package/dist/plugin.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from 'vite';
+
+interface MicroOption {
+    useDevMode?: boolean;
+}
+declare function setupMicroApp(qiankunName: string, microOption?: MicroOption): Plugin<any>;
+
+export { type MicroOption, setupMicroApp };

package/dist/plugin.mjs

@@ -0,0 +1,107 @@
+// src/plugin.ts
+import cheerio from "cheerio";
+var createQiankunHelper = (qiankunName) => `
+  const createDeffer = (hookName) => {
+    const d = new Promise((resolve, reject) => {
+      window.proxy && (window.proxy[\`vite\${hookName}\`] = resolve)
+    })
+    return props => d.then(fn => fn(props));
+  }
+  const bootstrap = createDeffer('bootstrap');
+  const mount = createDeffer('mount');
+  const unmount = createDeffer('unmount');
+  const update = createDeffer('update');
+
+  ;(global => {
+    global.qiankunName = '${qiankunName}';
+    global['${qiankunName}'] = {
+      bootstrap,
+      mount,
+      unmount,
+      update
+    };
+  })(window);
+`;
+var createImportFinallyResolve = (qiankunName) => {
+  return `
+    const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];
+    if (qiankunLifeCycle) {
+      window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));
+      window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));
+      window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());
+      window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));
+    }
+  `;
+};
+function setupMicroApp(qiankunName, microOption = { useDevMode: true }) {
+  let isProduction;
+  let base = "";
+  const module2DynamicImport = ($, scriptTag) => {
+    if (!scriptTag) {
+      return;
+    }
+    const script$ = $(scriptTag);
+    const moduleSrc = script$.attr("src");
+    let appendBase = "";
+    if (microOption.useDevMode && !isProduction) {
+      appendBase = "(window.proxy ? (window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ + '..') : '') + ";
+    }
+    script$.removeAttr("src");
+    script$.removeAttr("type");
+    script$.html(`import(${appendBase}'${moduleSrc}')`);
+    return script$;
+  };
+  const plugin = {
+    name: "qiankun-html-transform",
+    configResolved(config) {
+      isProduction = config.command === "build" || config.isProduction;
+      base = config.base;
+    },
+    configureServer(server) {
+      return () => {
+        server.middlewares.use((req, res, next) => {
+          if (isProduction || !microOption.useDevMode) {
+            next();
+            return;
+          }
+          const end = res.end.bind(res);
+          res.end = (...args) => {
+            const [chunk, ...rest] = args;
+            let htmlStr = chunk;
+            if (typeof htmlStr === "string") {
+              const $ = cheerio.load(htmlStr);
+              module2DynamicImport($, $(`script[src=${base}@vite/client]`).get(0));
+              htmlStr = $.html();
+            }
+            end(htmlStr, ...rest);
+          };
+          next();
+        });
+      };
+    },
+    transformIndexHtml(html) {
+      const $ = cheerio.load(html);
+      const moduleTags = $('body script[type=module], head script[crossorigin=""]');
+      if (!moduleTags || !moduleTags.length) {
+        return;
+      }
+      const len = moduleTags.length;
+      moduleTags.each((i, moduleTag) => {
+        const script$ = module2DynamicImport($, moduleTag);
+        if (len - 1 === i) {
+          script$ == null ? void 0 : script$.html(`${script$.html()}.finally(() => {
+            ${createImportFinallyResolve(qiankunName)}
+          })`);
+        }
+      });
+      $("body").append(`<script>${createQiankunHelper(qiankunName)}</script>`);
+      const output = $.html();
+      return output;
+    }
+  };
+  return plugin;
+}
+export {
+  setupMicroApp
+};
+//# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { CheerioAPI } from 'cheerio'\nimport cheerio from 'cheerio'\nimport type { Element } from 'domhandler'\nimport type { Plugin } from 'vite'\n\nconst createQiankunHelper = (qiankunName: string) => `\n  const createDeffer = (hookName) => {\n    const d = new Promise((resolve, reject) => {\n      window.proxy && (window.proxy[\\`vite\\${hookName}\\`] = resolve)\n    })\n    return props => d.then(fn => fn(props));\n  }\n  const bootstrap = createDeffer('bootstrap');\n  const mount = createDeffer('mount');\n  const unmount = createDeffer('unmount');\n  const update = createDeffer('update');\n\n  ;(global => {\n    global.qiankunName = '${qiankunName}';\n    global['${qiankunName}'] = {\n      bootstrap,\n      mount,\n      unmount,\n      update\n    };\n  })(window);\n`\n\nconst createImportFinallyResolve = (qiankunName: string) => {\n  return `\n    const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];\n    if (qiankunLifeCycle) {\n      window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));\n      window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));\n      window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());\n      window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));\n    }\n  `\n}\n\nexport interface MicroOption {\n  useDevMode?: boolean\n}\n\nexport function setupMicroApp(qiankunName: string, microOption: MicroOption = { useDevMode: true }) {\n  let isProduction: boolean\n  let base = ''\n\n  const module2DynamicImport = ($: CheerioAPI, scriptTag: Element | undefined) => {\n    if (!scriptTag) {\n      return\n    }\n    const script$ = $(scriptTag)\n    const moduleSrc = script$.attr('src')\n    let appendBase = ''\n    if (microOption.useDevMode && !isProduction) {\n      appendBase = \"(window.proxy ? (window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ + '..') : '') + \"\n    }\n    script$.removeAttr('src')\n    script$.removeAttr('type')\n    script$.html(`import(${appendBase}'${moduleSrc}')`)\n    return script$\n  }\n\n  const plugin: Plugin = {\n    name: 'qiankun-html-transform',\n    configResolved(config) {\n      isProduction = config.command === 'build' || config.isProduction\n      base = config.base\n    },\n\n    configureServer(server) {\n      return () => {\n        server.middlewares.use((req, res, next) => {\n          if (isProduction || !microOption.useDevMode) {\n            next()\n            return\n          }\n          const end = res.end.bind(res)\n          // @ts-ignore\n          res.end = (...args: any[]) => {\n            const [chunk, ...rest] = args\n            let htmlStr = chunk\n            if (typeof htmlStr === 'string') {\n              const $ = cheerio.load(htmlStr)\n              module2DynamicImport($, $(`script[src=${base}@vite/client]`).get(0))\n              htmlStr = $.html()\n            }\n            end(htmlStr, ...rest)\n          }\n          next()\n        })\n      }\n    },\n    transformIndexHtml(html: string) {\n      const $ = cheerio.load(html)\n      const moduleTags = $('body script[type=module], head script[crossorigin=\"\"]')\n      if (!moduleTags || !moduleTags.length) {\n        return\n      }\n      const len = moduleTags.length\n      moduleTags.each((i, moduleTag) => {\n        const script$ = module2DynamicImport($, moduleTag)\n        if (len - 1 === i) {\n          script$?.html(`${script$.html()}.finally(() => {\n            ${createImportFinallyResolve(qiankunName)}\n          })`)\n        }\n      })\n\n      $('body').append(`<script>${createQiankunHelper(qiankunName)}</script>`)\n      const output = $.html()\n      return output\n    }\n  }\n\n  return plugin\n}\n"],"mappings":";AACA,OAAO,aAAa;AAIpB,IAAM,sBAAsB,CAAC,gBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAazB,WAAW;AAAA,cACzB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASzB,IAAM,6BAA6B,CAAC,gBAAwB;AAC1D,SAAO;AAAA,uGAC8F,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQlH;AAMO,SAAS,cAAc,aAAqB,cAA2B,EAAE,YAAY,KAAK,GAAG;AAClG,MAAI;AACJ,MAAI,OAAO;AAEX,QAAM,uBAAuB,CAAC,GAAe,cAAmC;AAC9E,QAAI,CAAC,WAAW;AACd;AAAA,IACF;AACA,UAAM,UAAU,EAAE,SAAS;AAC3B,UAAM,YAAY,QAAQ,KAAK,KAAK;AACpC,QAAI,aAAa;AACjB,QAAI,YAAY,cAAc,CAAC,cAAc;AAC3C,mBAAa;AAAA,IACf;AACA,YAAQ,WAAW,KAAK;AACxB,YAAQ,WAAW,MAAM;AACzB,YAAQ,KAAK,UAAU,UAAU,IAAI,SAAS,IAAI;AAClD,WAAO;AAAA,EACT;AAEA,QAAM,SAAiB;AAAA,IACrB,MAAM;AAAA,IACN,eAAe,QAAQ;AACrB,qBAAe,OAAO,YAAY,WAAW,OAAO;AACpD,aAAO,OAAO;AAAA,IAChB;AAAA,IAEA,gBAAgB,QAAQ;AACtB,aAAO,MAAM;AACX,eAAO,YAAY,IAAI,CAAC,KAAK,KAAK,SAAS;AACzC,cAAI,gBAAgB,CAAC,YAAY,YAAY;AAC3C,iBAAK;AACL;AAAA,UACF;AACA,gBAAM,MAAM,IAAI,IAAI,KAAK,GAAG;AAE5B,cAAI,MAAM,IAAI,SAAgB;AAC5B,kBAAM,CAAC,OAAO,GAAG,IAAI,IAAI;AACzB,gBAAI,UAAU;AACd,gBAAI,OAAO,YAAY,UAAU;AAC/B,oBAAM,IAAI,QAAQ,KAAK,OAAO;AAC9B,mCAAqB,GAAG,EAAE,cAAc,IAAI,eAAe,EAAE,IAAI,CAAC,CAAC;AACnE,wBAAU,EAAE,KAAK;AAAA,YACnB;AACA,gBAAI,SAAS,GAAG,IAAI;AAAA,UACtB;AACA,eAAK;AAAA,QACP,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA,mBAAmB,MAAc;AAC/B,YAAM,IAAI,QAAQ,KAAK,IAAI;AAC3B,YAAM,aAAa,EAAE,uDAAuD;AAC5E,UAAI,CAAC,cAAc,CAAC,WAAW,QAAQ;AACrC;AAAA,MACF;AACA,YAAM,MAAM,WAAW;AACvB,iBAAW,KAAK,CAAC,GAAG,cAAc;AAChC,cAAM,UAAU,qBAAqB,GAAG,SAAS;AACjD,YAAI,MAAM,MAAM,GAAG;AACjB,6CAAS,KAAK,GAAG,QAAQ,KAAK,CAAC;AAAA,cAC3B,2BAA2B,WAAW,CAAC;AAAA;AAAA,QAE7C;AAAA,MACF,CAAC;AAED,QAAE,MAAM,EAAE,OAAO,WAAW,oBAAoB,WAAW,CAAC,WAAW;AACvE,YAAM,SAAS,EAAE,KAAK;AACtB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxax/x-plugins-micro",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Reusable micro-frontend plugin based on qiankun for Maxax projects",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -11,6 +11,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.mjs",
+      "require": "./dist/plugin.cjs"
     }
   },
   "files": [
@@ -33,6 +38,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "cheerio": "^1.1.2"
+  },
   "scripts": {
     "bump-version": "maxax bump-version",
     "dev": "tsup --watch",