@tiny-codes/vite-plugin-qiankun 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# @tiny-codes/vite-plugin-qiankun
+
+## v2.0.0
+
+2024-4-1
+
+### Features
+
+- Always respect the `__INJECTED_PUBLIC_PATH_BY_QIANKUN__` to ensure correct resource loading in micro apps.
+- Add `changeScriptOrigin` option to shut down the behavior.
+- Always setup a dev server to enable running micro apps in development mode.
+
+## v1.0.15
+
+2024-4-1
+
+forked from [https://github.com/tengmaoqing/vite-plugin-qiankun](https://github.com/tengmaoqing/vite-plugin-qiankun)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 TMQ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/es/helper.d.ts

@@ -0,0 +1,17 @@
+export interface QiankunProps {
+    container?: HTMLElement;
+    [x: string]: unknown;
+}
+export interface QiankunLifeCycle {
+    bootstrap: (props?: QiankunProps) => void | Promise<void>;
+    mount: (props: QiankunProps) => void | Promise<void>;
+    unmount: (props: QiankunProps) => void | Promise<void>;
+    update: (props: QiankunProps) => void | Promise<void>;
+}
+export interface QiankunWindow {
+    __POWERED_BY_QIANKUN__?: boolean;
+    [x: string]: any;
+}
+export declare const qiankunWindow: QiankunWindow;
+export declare const renderWithQiankun: (qiankunLifeCycle: QiankunLifeCycle) => void;
+export default renderWithQiankun;

package/es/helper.js

@@ -0,0 +1,14 @@
+export var qiankunWindow = typeof window !== 'undefined' ? window.proxy || window : {};
+export var renderWithQiankun = function renderWithQiankun(qiankunLifeCycle) {
+  // 函数只有一次执行机会，需要把生命周期赋值给全局
+  if (qiankunWindow !== null && qiankunWindow !== void 0 && qiankunWindow.__POWERED_BY_QIANKUN__) {
+    if (!window.moudleQiankunAppLifeCycles) {
+      window.moudleQiankunAppLifeCycles = {};
+    }
+    if (qiankunWindow.qiankunName) {
+      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle;
+    }
+  }
+};
+export default renderWithQiankun;
+//# sourceMappingURL=helper.js.map

package/es/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["qiankunWindow","window","proxy","renderWithQiankun","qiankunLifeCycle","__POWERED_BY_QIANKUN__","moudleQiankunAppLifeCycles","qiankunName"],"sources":["../src/helper.ts"],"sourcesContent":["export interface QiankunProps {\n  container?: HTMLElement;\n  [x: string]: unknown;\n}\n\nexport interface QiankunLifeCycle {\n  bootstrap: (props?: QiankunProps) => void | Promise<void>;\n  mount: (props: QiankunProps) => void | Promise<void>;\n  unmount: (props: QiankunProps) => void | Promise<void>;\n  update: (props: QiankunProps) => void | Promise<void>;\n}\n\nexport interface QiankunWindow {\n  __POWERED_BY_QIANKUN__?: boolean;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [x: string]: any;\n}\n\nexport const qiankunWindow: QiankunWindow = typeof window !== 'undefined' ? window.proxy || window : {};\n\nexport const renderWithQiankun = (qiankunLifeCycle: QiankunLifeCycle) => {\n  // 函数只有一次执行机会，需要把生命周期赋值给全局\n  if (qiankunWindow?.__POWERED_BY_QIANKUN__) {\n    if (!window.moudleQiankunAppLifeCycles) {\n      window.moudleQiankunAppLifeCycles = {};\n    }\n    if (qiankunWindow.qiankunName) {\n      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle;\n    }\n  }\n};\n\nexport default renderWithQiankun;\n"],"mappings":"AAkBA,OAAO,IAAMA,aAA4B,GAAG,OAAOC,MAAM,KAAK,WAAW,GAAGA,MAAM,CAACC,KAAK,IAAID,MAAM,GAAG,CAAC,CAAC;AAEvG,OAAO,IAAME,iBAAiB,GAAG,SAApBA,iBAAiBA,CAAIC,gBAAkC,EAAK;EACvE;EACA,IAAIJ,aAAa,aAAbA,aAAa,eAAbA,aAAa,CAAEK,sBAAsB,EAAE;IACzC,IAAI,CAACJ,MAAM,CAACK,0BAA0B,EAAE;MACtCL,MAAM,CAACK,0BAA0B,GAAG,CAAC,CAAC;IACxC;IACA,IAAIN,aAAa,CAACO,WAAW,EAAE;MAC7BN,MAAM,CAACK,0BAA0B,CAACN,aAAa,CAACO,WAAW,CAAC,GAAGH,gBAAgB;IACjF;EACF;AACF,CAAC;AAED,eAAeD,iBAAiB"}

package/es/index.d.ts

@@ -0,0 +1,28 @@
+import type { PluginOption } from 'vite';
+export * from './helper';
+export interface MicroOption {
+    /**
+     * Whether to change the origin of entry script tag for micro frontend. It's useful when the micro
+     * frontend is deployed on a different domain or path.
+     *
+     * > If the origin by the qiankun's default algorithm is not correct for you, please try the
+     * > [getPublicPath](https://qiankun.umijs.org/zh/api) option.
+     *
+     * @default true
+     */
+    changeScriptOrigin?: boolean;
+}
+type PluginFn = (appName: string, pluginOptions?: MicroOption) => PluginOption;
+/**
+ * Vite plugin for integrating with Qiankun micro frontend.
+ *
+ * @param appName The name of the Qiankun sub app.
+ * @param pluginOptions Options for configuring the micro frontend behavior.
+ *
+ * > If the micro app is deployed on a different domain or path, you may need to adjust the public
+ *   > path. Please have a look at the [getPublicPath](https://qiankun.umijs.org/zh/api) option.
+ *
+ * @returns A Vite plugin option object.
+ */
+declare const qiankunPlugin: PluginFn;
+export default qiankunPlugin;

package/es/index.js

@@ -0,0 +1,119 @@
+import { load } from 'cheerio';
+import { detectIndent, space } from "./utils";
+export * from "./helper";
+/**
+ * Vite plugin for integrating with Qiankun micro frontend.
+ *
+ * @param appName The name of the Qiankun sub app.
+ * @param pluginOptions Options for configuring the micro frontend behavior.
+ *
+ * > If the micro app is deployed on a different domain or path, you may need to adjust the public
+ *   > path. Please have a look at the [getPublicPath](https://qiankun.umijs.org/zh/api) option.
+ *
+ * @returns A Vite plugin option object.
+ */
+var qiankunPlugin = function qiankunPlugin(appName) {
+  var pluginOptions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _pluginOptions$change = pluginOptions.changeScriptOrigin,
+    changeScriptOrigin = _pluginOptions$change === void 0 ? true : _pluginOptions$change;
+  return {
+    name: 'vite-plugin-qiankun',
+    transformIndexHtml: function transformIndexHtml(html, context) {
+      var _$$get;
+      var $ = load(html, {
+        sourceCodeLocationInfo: true
+      });
+      var entryScript = (_$$get = $('script[entry]').get(0)) !== null && _$$get !== void 0 ? _$$get : $('body script[type=module], head script[crossorigin=""]').get(0);
+      if (entryScript) {
+        var _script$$html;
+        var scriptBaseIndent = detectIndent(html, entryScript);
+        var S0 = scriptBaseIndent;
+        var S1 = scriptBaseIndent + space(2);
+        var S2 = S1 + space(2);
+        var script$ = module2DynamicImport({
+          $: $,
+          scriptTag: entryScript,
+          changeScriptOrigin: changeScriptOrigin,
+          ident: S1
+        });
+        script$ === null || script$ === void 0 || script$.html("".concat((_script$$html = script$.html()) === null || _script$$html === void 0 ? void 0 : _script$$html.trimEnd(), ".finally(() => {\n").concat(S2).concat(createImportFinallyResolve(appName, {
+          indent: S2
+        }).trim(), "\n").concat(S1, "});\n").concat(S0));
+        var bodyBaseIndent = detectIndent(html, $('body').get(0));
+        var B1 = bodyBaseIndent + space(2);
+        var B2 = B1 + space(2);
+        $('body').append("\n".concat(B1, "<script>\n").concat(B2).concat(createQiankunHelper(appName, {
+          indent: B2 + space(2)
+        }).trim(), "\n").concat(B1, "</script>\n"));
+        var output = $.html();
+        return output;
+      } else {
+        console.warn('\x1b[33m%s\x1b[0m', '⚠️ Patch for qiankun failed, because the entry script was not found.');
+        return html;
+      }
+    },
+    configureServer: function configureServer(server) {
+      var base = server.config.base;
+      return function () {
+        var patchFiles = ["".concat(base, "@vite/client")];
+        patchFiles.forEach(function (file) {
+          server.middlewares.use(file, function (req, res, next) {
+            var end = res.end.bind(res);
+            res.end = function (chunk) {
+              if (typeof chunk === 'string') {
+                var $ = load(chunk);
+                module2DynamicImport({
+                  $: $,
+                  scriptTag: $("script[src=\"".concat(file, "\"]")).get(0),
+                  changeScriptOrigin: changeScriptOrigin
+                });
+                chunk = $.html();
+              }
+              for (var _len = arguments.length, rest = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+                rest[_key - 1] = arguments[_key];
+              }
+              end.apply(void 0, [chunk].concat(rest));
+              return this;
+            };
+            next();
+          });
+        });
+      };
+    }
+  };
+};
+function module2DynamicImport(options) {
+  var $ = options.$,
+    scriptTag = options.scriptTag,
+    changeScriptOrigin = options.changeScriptOrigin,
+    _options$ident = options.ident,
+    ident = _options$ident === void 0 ? '' : _options$ident;
+  if (!scriptTag) {
+    return;
+  }
+  var script$ = $(scriptTag);
+  var moduleSrc = script$.attr('src');
+  var appendBase = "''";
+  if (changeScriptOrigin) {
+    appendBase = "window.proxy ? window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ || '' : ''";
+  }
+  script$.removeAttr('src');
+  script$.removeAttr('type');
+  var space = ident;
+  script$.html("\n".concat(space, "const publicUrl = ").concat(appendBase, ";\n").concat(space, "let assetUrl = '").concat(moduleSrc, "';\n").concat(space, "if (!assetUrl.match(/^https?/i)) {\n").concat(space, "  assetUrl = publicUrl + assetUrl;\n").concat(space, "}\n").concat(space, "import(assetUrl)"));
+  return script$;
+}
+function createImportFinallyResolve(qiankunName, options) {
+  var _ref = options !== null && options !== void 0 ? options : {},
+    _ref$indent = _ref.indent,
+    space = _ref$indent === void 0 ? '      ' : _ref$indent;
+  return "\n".concat(space, "const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['").concat(qiankunName, "'];\n").concat(space, "if (qiankunLifeCycle) {\n").concat(space, "  window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));\n").concat(space, "  window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));\n").concat(space, "  window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());\n").concat(space, "  window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));\n").concat(space, "}\n");
+}
+function createQiankunHelper(qiankunName, options) {
+  var _ref2 = options !== null && options !== void 0 ? options : {},
+    _ref2$indent = _ref2.indent,
+    space = _ref2$indent === void 0 ? '      ' : _ref2$indent;
+  return "\n".concat(space, "const createDeffer = (hookName) => {\n").concat(space, "  const d = new Promise((resolve, reject) => {\n").concat(space, "    window.proxy && (window.proxy[`vite${hookName}`] = resolve)\n").concat(space, "  })\n").concat(space, "  return props => d.then(fn => fn(props));\n").concat(space, "}\n").concat(space, "const bootstrap = createDeffer('bootstrap');\n").concat(space, "const mount = createDeffer('mount');\n").concat(space, "const unmount = createDeffer('unmount');\n").concat(space, "const update = createDeffer('update');\n\n").concat(space, ";(global => {\n").concat(space, "  global.qiankunName = '").concat(qiankunName, "';\n").concat(space, "  global['").concat(qiankunName, "'] = {\n").concat(space, "    bootstrap,\n").concat(space, "    mount,\n").concat(space, "    unmount,\n").concat(space, "    update\n").concat(space, "  };\n").concat(space, "})(window);\n");
+}
+export default qiankunPlugin;
+//# sourceMappingURL=index.js.map

package/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["load","detectIndent","space","qiankunPlugin","appName","pluginOptions","arguments","length","undefined","_pluginOptions$change","changeScriptOrigin","name","transformIndexHtml","html","context","_$$get","$","sourceCodeLocationInfo","entryScript","get","_script$$html","scriptBaseIndent","S0","S1","S2","script$","module2DynamicImport","scriptTag","ident","concat","trimEnd","createImportFinallyResolve","indent","trim","bodyBaseIndent","B1","B2","append","createQiankunHelper","output","console","warn","configureServer","server","base","config","patchFiles","forEach","file","middlewares","use","req","res","next","end","bind","chunk","_len","rest","Array","_key","apply","options","_options$ident","moduleSrc","attr","appendBase","removeAttr","qiankunName","_ref","_ref$indent","_ref2","_ref2$indent"],"sources":["../src/index.ts"],"sourcesContent":["import type { CheerioAPI } from 'cheerio';\nimport { load } from 'cheerio';\nimport type { Element } from 'domhandler';\nimport type { PluginOption } from 'vite';\nimport { detectIndent, space } from './utils';\n\nexport * from './helper';\n\nexport interface MicroOption {\n  /**\n   * Whether to change the origin of entry script tag for micro frontend. It's useful when the micro\n   * frontend is deployed on a different domain or path.\n   *\n   * > If the origin by the qiankun's default algorithm is not correct for you, please try the\n   * > [getPublicPath](https://qiankun.umijs.org/zh/api) option.\n   *\n   * @default true\n   */\n  changeScriptOrigin?: boolean;\n}\ntype PluginFn = (appName: string, pluginOptions?: MicroOption) => PluginOption;\n\n/**\n * Vite plugin for integrating with Qiankun micro frontend.\n *\n * @param appName The name of the Qiankun sub app.\n * @param pluginOptions Options for configuring the micro frontend behavior.\n *\n * > If the micro app is deployed on a different domain or path, you may need to adjust the public\n *   > path. Please have a look at the [getPublicPath](https://qiankun.umijs.org/zh/api) option.\n *\n * @returns A Vite plugin option object.\n */\nconst qiankunPlugin: PluginFn = (appName, pluginOptions = {}) => {\n  const { changeScriptOrigin = true } = pluginOptions;\n\n  return {\n    name: 'vite-plugin-qiankun',\n\n    transformIndexHtml(html: string, context) {\n      const $ = load(html, { sourceCodeLocationInfo: true });\n      const entryScript =\n        $('script[entry]').get(0) ?? $('body script[type=module], head script[crossorigin=\"\"]').get(0);\n      if (entryScript) {\n        const scriptBaseIndent = detectIndent(html, entryScript);\n        const S0 = scriptBaseIndent;\n        const S1 = scriptBaseIndent + space(2);\n        const S2 = S1 + space(2);\n        const script$ = module2DynamicImport({\n          $,\n          scriptTag: entryScript,\n          changeScriptOrigin,\n          ident: S1,\n        });\n        script$?.html(`${script$.html()?.trimEnd()}.finally(() => {\n${S2}${createImportFinallyResolve(appName, { indent: S2 }).trim()}\n${S1}});\n${S0}`);\n\n        const bodyBaseIndent = detectIndent(html, $('body').get(0));\n        const B1 = bodyBaseIndent + space(2);\n        const B2 = B1 + space(2);\n        $('body').append(`\n${B1}<script>\n${B2}${createQiankunHelper(appName, { indent: B2 + space(2) }).trim()}\n${B1}</script>\n`);\n        const output = $.html();\n        return output;\n      } else {\n        console.warn('\\x1b[33m%s\\x1b[0m', '⚠️ Patch for qiankun failed, because the entry script was not found.');\n        return html;\n      }\n    },\n    configureServer(server) {\n      const base = server.config.base;\n      return () => {\n        const patchFiles = [`${base}@vite/client`];\n        patchFiles.forEach((file) => {\n          server.middlewares.use(file, (req, res, next) => {\n            const end = res.end.bind(res);\n            res.end = function (this: typeof res, chunk: unknown, ...rest: any[]) {\n              if (typeof chunk === 'string') {\n                const $ = load(chunk);\n                module2DynamicImport({ $, scriptTag: $(`script[src=\"${file}\"]`).get(0), changeScriptOrigin });\n                chunk = $.html();\n              }\n              end(chunk, ...rest);\n              return this;\n            } as unknown as typeof res.end;\n            next();\n          });\n        });\n      };\n    },\n  };\n};\n\nfunction module2DynamicImport(\n  options: { $: CheerioAPI; scriptTag: Element | undefined; ident?: string } & Pick<MicroOption, 'changeScriptOrigin'>,\n) {\n  const { $, scriptTag, changeScriptOrigin, ident = '' } = options;\n  if (!scriptTag) {\n    return;\n  }\n  const script$ = $(scriptTag);\n  const moduleSrc = script$.attr('src');\n  let appendBase = \"''\";\n  if (changeScriptOrigin) {\n    appendBase = \"window.proxy ? window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ || '' : ''\";\n  }\n  script$.removeAttr('src');\n  script$.removeAttr('type');\n  const space = ident;\n  script$.html(`\n${space}const publicUrl = ${appendBase};\n${space}let assetUrl = '${moduleSrc}';\n${space}if (!assetUrl.match(/^https?/i)) {\n${space}  assetUrl = publicUrl + assetUrl;\n${space}}\n${space}import(assetUrl)`);\n  return script$;\n}\n\nfunction createImportFinallyResolve(qiankunName: string, options?: { indent?: string }) {\n  const { indent: space = '      ' } = options ?? {};\n  return `\n${space}const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];\n${space}if (qiankunLifeCycle) {\n${space}  window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));\n${space}  window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));\n${space}  window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());\n${space}  window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));\n${space}}\n`;\n}\n\nfunction createQiankunHelper(qiankunName: string, options?: { indent?: string }) {\n  const { indent: space = '      ' } = options ?? {};\n  return `\n${space}const createDeffer = (hookName) => {\n${space}  const d = new Promise((resolve, reject) => {\n${space}    window.proxy && (window.proxy[\\`vite\\${hookName}\\`] = resolve)\n${space}  })\n${space}  return props => d.then(fn => fn(props));\n${space}}\n${space}const bootstrap = createDeffer('bootstrap');\n${space}const mount = createDeffer('mount');\n${space}const unmount = createDeffer('unmount');\n${space}const update = createDeffer('update');\n\n${space};(global => {\n${space}  global.qiankunName = '${qiankunName}';\n${space}  global['${qiankunName}'] = {\n${space}    bootstrap,\n${space}    mount,\n${space}    unmount,\n${space}    update\n${space}  };\n${space}})(window);\n`;\n}\n\nexport default qiankunPlugin;\n"],"mappings":"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"}

package/es/utils.d.ts

@@ -0,0 +1,3 @@
+import type { Element } from 'domhandler';
+export declare function detectIndent(html: string, entryScript: Element | undefined): string;
+export declare function space(num: number): string;

package/es/utils.js

@@ -0,0 +1,26 @@
+export function detectIndent(html, entryScript) {
+  var baseIndent = '';
+  if (entryScript !== null && entryScript !== void 0 && entryScript.sourceCodeLocation) {
+    var newline = html.includes('\r\n') ? '\r\n' : '\n';
+    var lines = html.split(newline);
+    var lineStr = lines[entryScript.sourceCodeLocation.startLine - 1];
+    if (lineStr) {
+      var startTag = '<script';
+      var tagNameFromHtml = lineStr.substring(entryScript.sourceCodeLocation.startCol - 1, entryScript.sourceCodeLocation.startCol - 1 + startTag.length);
+      if (tagNameFromHtml === startTag) {
+        for (var i = 0; i < entryScript.sourceCodeLocation.startCol - 1; i++) {
+          if (/\s/.test(lineStr[i])) {
+            baseIndent += lineStr[i];
+          } else {
+            break;
+          }
+        }
+      }
+    }
+  }
+  return baseIndent;
+}
+export function space(num) {
+  return new Array(num + 1).join(' ');
+}
+//# sourceMappingURL=utils.js.map

package/es/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["detectIndent","html","entryScript","baseIndent","sourceCodeLocation","newline","includes","lines","split","lineStr","startLine","startTag","tagNameFromHtml","substring","startCol","length","i","test","space","num","Array","join"],"sources":["../src/utils.ts"],"sourcesContent":["import type { Element } from 'domhandler';\n\nexport function detectIndent(html: string, entryScript: Element | undefined) {\n  let baseIndent = '';\n  if (entryScript?.sourceCodeLocation) {\n    const newline = html.includes('\\r\\n') ? '\\r\\n' : '\\n';\n    const lines = html.split(newline);\n    const lineStr = lines[entryScript.sourceCodeLocation.startLine - 1];\n    if (lineStr) {\n      const startTag = '<script';\n      const tagNameFromHtml = lineStr.substring(\n        entryScript.sourceCodeLocation.startCol - 1,\n        entryScript.sourceCodeLocation.startCol - 1 + startTag.length,\n      );\n      if (tagNameFromHtml === startTag) {\n        for (let i = 0; i < entryScript.sourceCodeLocation.startCol - 1; i++) {\n          if (/\\s/.test(lineStr[i])) {\n            baseIndent += lineStr[i];\n          } else {\n            break;\n          }\n        }\n      }\n    }\n  }\n  return baseIndent;\n}\n\nexport function space(num: number) {\n  return new Array(num + 1).join(' ');\n}\n"],"mappings":"AAEA,OAAO,SAASA,YAAYA,CAACC,IAAY,EAAEC,WAAgC,EAAE;EAC3E,IAAIC,UAAU,GAAG,EAAE;EACnB,IAAID,WAAW,aAAXA,WAAW,eAAXA,WAAW,CAAEE,kBAAkB,EAAE;IACnC,IAAMC,OAAO,GAAGJ,IAAI,CAACK,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IACrD,IAAMC,KAAK,GAAGN,IAAI,CAACO,KAAK,CAACH,OAAO,CAAC;IACjC,IAAMI,OAAO,GAAGF,KAAK,CAACL,WAAW,CAACE,kBAAkB,CAACM,SAAS,GAAG,CAAC,CAAC;IACnE,IAAID,OAAO,EAAE;MACX,IAAME,QAAQ,GAAG,SAAS;MAC1B,IAAMC,eAAe,GAAGH,OAAO,CAACI,SAAS,CACvCX,WAAW,CAACE,kBAAkB,CAACU,QAAQ,GAAG,CAAC,EAC3CZ,WAAW,CAACE,kBAAkB,CAACU,QAAQ,GAAG,CAAC,GAAGH,QAAQ,CAACI,MACzD,CAAC;MACD,IAAIH,eAAe,KAAKD,QAAQ,EAAE;QAChC,KAAK,IAAIK,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGd,WAAW,CAACE,kBAAkB,CAACU,QAAQ,GAAG,CAAC,EAAEE,CAAC,EAAE,EAAE;UACpE,IAAI,IAAI,CAACC,IAAI,CAACR,OAAO,CAACO,CAAC,CAAC,CAAC,EAAE;YACzBb,UAAU,IAAIM,OAAO,CAACO,CAAC,CAAC;UAC1B,CAAC,MAAM;YACL;UACF;QACF;MACF;IACF;EACF;EACA,OAAOb,UAAU;AACnB;AAEA,OAAO,SAASe,KAAKA,CAACC,GAAW,EAAE;EACjC,OAAO,IAAIC,KAAK,CAACD,GAAG,GAAG,CAAC,CAAC,CAACE,IAAI,CAAC,GAAG,CAAC;AACrC"}

package/lib/helper.d.ts

@@ -0,0 +1,17 @@
+export interface QiankunProps {
+    container?: HTMLElement;
+    [x: string]: unknown;
+}
+export interface QiankunLifeCycle {
+    bootstrap: (props?: QiankunProps) => void | Promise<void>;
+    mount: (props: QiankunProps) => void | Promise<void>;
+    unmount: (props: QiankunProps) => void | Promise<void>;
+    update: (props: QiankunProps) => void | Promise<void>;
+}
+export interface QiankunWindow {
+    __POWERED_BY_QIANKUN__?: boolean;
+    [x: string]: any;
+}
+export declare const qiankunWindow: QiankunWindow;
+export declare const renderWithQiankun: (qiankunLifeCycle: QiankunLifeCycle) => void;
+export default renderWithQiankun;

package/lib/helper.js

@@ -0,0 +1,44 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/helper.ts
+var helper_exports = {};
+__export(helper_exports, {
+  default: () => helper_default,
+  qiankunWindow: () => qiankunWindow,
+  renderWithQiankun: () => renderWithQiankun
+});
+module.exports = __toCommonJS(helper_exports);
+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;
+    }
+  }
+};
+var helper_default = renderWithQiankun;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  qiankunWindow,
+  renderWithQiankun
+});
+//# sourceMappingURL=helper.js.map

package/lib/helper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/helper.ts"],
+  "sourcesContent": ["export interface QiankunProps {\n  container?: HTMLElement;\n  [x: string]: unknown;\n}\n\nexport interface QiankunLifeCycle {\n  bootstrap: (props?: QiankunProps) => void | Promise<void>;\n  mount: (props: QiankunProps) => void | Promise<void>;\n  unmount: (props: QiankunProps) => void | Promise<void>;\n  update: (props: QiankunProps) => void | Promise<void>;\n}\n\nexport interface QiankunWindow {\n  __POWERED_BY_QIANKUN__?: boolean;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [x: string]: any;\n}\n\nexport const qiankunWindow: QiankunWindow = typeof window !== 'undefined' ? window.proxy || window : {};\n\nexport const renderWithQiankun = (qiankunLifeCycle: QiankunLifeCycle) => {\n  // 函数只有一次执行机会，需要把生命周期赋值给全局\n  if (qiankunWindow?.__POWERED_BY_QIANKUN__) {\n    if (!window.moudleQiankunAppLifeCycles) {\n      window.moudleQiankunAppLifeCycles = {};\n    }\n    if (qiankunWindow.qiankunName) {\n      window.moudleQiankunAppLifeCycles[qiankunWindow.qiankunName] = qiankunLifeCycle;\n    }\n  }\n};\n\nexport default renderWithQiankun;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,IAAM,gBAA+B,OAAO,WAAW,cAAc,OAAO,SAAS,SAAS,CAAC;AAE/F,IAAM,oBAAoB,CAAC,qBAAuC;AAEvE,MAAI,+CAAe,wBAAwB;AACzC,QAAI,CAAC,OAAO,4BAA4B;AACtC,aAAO,6BAA6B,CAAC;AAAA,IACvC;AACA,QAAI,cAAc,aAAa;AAC7B,aAAO,2BAA2B,cAAc,WAAW,IAAI;AAAA,IACjE;AAAA,EACF;AACF;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/lib/index.d.ts

@@ -0,0 +1,28 @@
+import type { PluginOption } from 'vite';
+export * from './helper';
+export interface MicroOption {
+    /**
+     * Whether to change the origin of entry script tag for micro frontend. It's useful when the micro
+     * frontend is deployed on a different domain or path.
+     *
+     * > If the origin by the qiankun's default algorithm is not correct for you, please try the
+     * > [getPublicPath](https://qiankun.umijs.org/zh/api) option.
+     *
+     * @default true
+     */
+    changeScriptOrigin?: boolean;
+}
+type PluginFn = (appName: string, pluginOptions?: MicroOption) => PluginOption;
+/**
+ * Vite plugin for integrating with Qiankun micro frontend.
+ *
+ * @param appName The name of the Qiankun sub app.
+ * @param pluginOptions Options for configuring the micro frontend behavior.
+ *
+ * > If the micro app is deployed on a different domain or path, you may need to adjust the public
+ *   > path. Please have a look at the [getPublicPath](https://qiankun.umijs.org/zh/api) option.
+ *
+ * @returns A Vite plugin option object.
+ */
+declare const qiankunPlugin: PluginFn;
+export default qiankunPlugin;

package/lib/index.js

@@ -0,0 +1,155 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  default: () => src_default
+});
+module.exports = __toCommonJS(src_exports);
+var import_cheerio = require("cheerio");
+var import_utils = require("./utils");
+__reExport(src_exports, require("./helper"), module.exports);
+var qiankunPlugin = (appName, pluginOptions = {}) => {
+  const { changeScriptOrigin = true } = pluginOptions;
+  return {
+    name: "vite-plugin-qiankun",
+    transformIndexHtml(html, context) {
+      var _a;
+      const $ = (0, import_cheerio.load)(html, { sourceCodeLocationInfo: true });
+      const entryScript = $("script[entry]").get(0) ?? $('body script[type=module], head script[crossorigin=""]').get(0);
+      if (entryScript) {
+        const scriptBaseIndent = (0, import_utils.detectIndent)(html, entryScript);
+        const S0 = scriptBaseIndent;
+        const S1 = scriptBaseIndent + (0, import_utils.space)(2);
+        const S2 = S1 + (0, import_utils.space)(2);
+        const script$ = module2DynamicImport({
+          $,
+          scriptTag: entryScript,
+          changeScriptOrigin,
+          ident: S1
+        });
+        script$ == null ? void 0 : script$.html(`${(_a = script$.html()) == null ? void 0 : _a.trimEnd()}.finally(() => {
+${S2}${createImportFinallyResolve(appName, { indent: S2 }).trim()}
+${S1}});
+${S0}`);
+        const bodyBaseIndent = (0, import_utils.detectIndent)(html, $("body").get(0));
+        const B1 = bodyBaseIndent + (0, import_utils.space)(2);
+        const B2 = B1 + (0, import_utils.space)(2);
+        $("body").append(`
+${B1}<script>
+${B2}${createQiankunHelper(appName, { indent: B2 + (0, import_utils.space)(2) }).trim()}
+${B1}</script>
+`);
+        const output = $.html();
+        return output;
+      } else {
+        console.warn("\x1B[33m%s\x1B[0m", "⚠️ Patch for qiankun failed, because the entry script was not found.");
+        return html;
+      }
+    },
+    configureServer(server) {
+      const base = server.config.base;
+      return () => {
+        const patchFiles = [`${base}@vite/client`];
+        patchFiles.forEach((file) => {
+          server.middlewares.use(file, (req, res, next) => {
+            const end = res.end.bind(res);
+            res.end = function(chunk, ...rest) {
+              if (typeof chunk === "string") {
+                const $ = (0, import_cheerio.load)(chunk);
+                module2DynamicImport({ $, scriptTag: $(`script[src="${file}"]`).get(0), changeScriptOrigin });
+                chunk = $.html();
+              }
+              end(chunk, ...rest);
+              return this;
+            };
+            next();
+          });
+        });
+      };
+    }
+  };
+};
+function module2DynamicImport(options) {
+  const { $, scriptTag, changeScriptOrigin, ident = "" } = options;
+  if (!scriptTag) {
+    return;
+  }
+  const script$ = $(scriptTag);
+  const moduleSrc = script$.attr("src");
+  let appendBase = "''";
+  if (changeScriptOrigin) {
+    appendBase = "window.proxy ? window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ || '' : ''";
+  }
+  script$.removeAttr("src");
+  script$.removeAttr("type");
+  const space2 = ident;
+  script$.html(`
+${space2}const publicUrl = ${appendBase};
+${space2}let assetUrl = '${moduleSrc}';
+${space2}if (!assetUrl.match(/^https?/i)) {
+${space2}  assetUrl = publicUrl + assetUrl;
+${space2}}
+${space2}import(assetUrl)`);
+  return script$;
+}
+function createImportFinallyResolve(qiankunName, options) {
+  const { indent: space2 = "      " } = options ?? {};
+  return `
+${space2}const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];
+${space2}if (qiankunLifeCycle) {
+${space2}  window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));
+${space2}  window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));
+${space2}  window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());
+${space2}  window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));
+${space2}}
+`;
+}
+function createQiankunHelper(qiankunName, options) {
+  const { indent: space2 = "      " } = options ?? {};
+  return `
+${space2}const createDeffer = (hookName) => {
+${space2}  const d = new Promise((resolve, reject) => {
+${space2}    window.proxy && (window.proxy[\`vite\${hookName}\`] = resolve)
+${space2}  })
+${space2}  return props => d.then(fn => fn(props));
+${space2}}
+${space2}const bootstrap = createDeffer('bootstrap');
+${space2}const mount = createDeffer('mount');
+${space2}const unmount = createDeffer('unmount');
+${space2}const update = createDeffer('update');
+
+${space2};(global => {
+${space2}  global.qiankunName = '${qiankunName}';
+${space2}  global['${qiankunName}'] = {
+${space2}    bootstrap,
+${space2}    mount,
+${space2}    unmount,
+${space2}    update
+${space2}  };
+${space2}})(window);
+`;
+}
+var src_default = qiankunPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./helper")
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["import type { CheerioAPI } from 'cheerio';\nimport { load } from 'cheerio';\nimport type { Element } from 'domhandler';\nimport type { PluginOption } from 'vite';\nimport { detectIndent, space } from './utils';\n\nexport * from './helper';\n\nexport interface MicroOption {\n  /**\n   * Whether to change the origin of entry script tag for micro frontend. It's useful when the micro\n   * frontend is deployed on a different domain or path.\n   *\n   * > If the origin by the qiankun's default algorithm is not correct for you, please try the\n   * > [getPublicPath](https://qiankun.umijs.org/zh/api) option.\n   *\n   * @default true\n   */\n  changeScriptOrigin?: boolean;\n}\ntype PluginFn = (appName: string, pluginOptions?: MicroOption) => PluginOption;\n\n/**\n * Vite plugin for integrating with Qiankun micro frontend.\n *\n * @param appName The name of the Qiankun sub app.\n * @param pluginOptions Options for configuring the micro frontend behavior.\n *\n * > If the micro app is deployed on a different domain or path, you may need to adjust the public\n *   > path. Please have a look at the [getPublicPath](https://qiankun.umijs.org/zh/api) option.\n *\n * @returns A Vite plugin option object.\n */\nconst qiankunPlugin: PluginFn = (appName, pluginOptions = {}) => {\n  const { changeScriptOrigin = true } = pluginOptions;\n\n  return {\n    name: 'vite-plugin-qiankun',\n\n    transformIndexHtml(html: string, context) {\n      const $ = load(html, { sourceCodeLocationInfo: true });\n      const entryScript =\n        $('script[entry]').get(0) ?? $('body script[type=module], head script[crossorigin=\"\"]').get(0);\n      if (entryScript) {\n        const scriptBaseIndent = detectIndent(html, entryScript);\n        const S0 = scriptBaseIndent;\n        const S1 = scriptBaseIndent + space(2);\n        const S2 = S1 + space(2);\n        const script$ = module2DynamicImport({\n          $,\n          scriptTag: entryScript,\n          changeScriptOrigin,\n          ident: S1,\n        });\n        script$?.html(`${script$.html()?.trimEnd()}.finally(() => {\n${S2}${createImportFinallyResolve(appName, { indent: S2 }).trim()}\n${S1}});\n${S0}`);\n\n        const bodyBaseIndent = detectIndent(html, $('body').get(0));\n        const B1 = bodyBaseIndent + space(2);\n        const B2 = B1 + space(2);\n        $('body').append(`\n${B1}<script>\n${B2}${createQiankunHelper(appName, { indent: B2 + space(2) }).trim()}\n${B1}</script>\n`);\n        const output = $.html();\n        return output;\n      } else {\n        console.warn('\\x1b[33m%s\\x1b[0m', '⚠️ Patch for qiankun failed, because the entry script was not found.');\n        return html;\n      }\n    },\n    configureServer(server) {\n      const base = server.config.base;\n      return () => {\n        const patchFiles = [`${base}@vite/client`];\n        patchFiles.forEach((file) => {\n          server.middlewares.use(file, (req, res, next) => {\n            const end = res.end.bind(res);\n            res.end = function (this: typeof res, chunk: unknown, ...rest: any[]) {\n              if (typeof chunk === 'string') {\n                const $ = load(chunk);\n                module2DynamicImport({ $, scriptTag: $(`script[src=\"${file}\"]`).get(0), changeScriptOrigin });\n                chunk = $.html();\n              }\n              end(chunk, ...rest);\n              return this;\n            } as unknown as typeof res.end;\n            next();\n          });\n        });\n      };\n    },\n  };\n};\n\nfunction module2DynamicImport(\n  options: { $: CheerioAPI; scriptTag: Element | undefined; ident?: string } & Pick<MicroOption, 'changeScriptOrigin'>,\n) {\n  const { $, scriptTag, changeScriptOrigin, ident = '' } = options;\n  if (!scriptTag) {\n    return;\n  }\n  const script$ = $(scriptTag);\n  const moduleSrc = script$.attr('src');\n  let appendBase = \"''\";\n  if (changeScriptOrigin) {\n    appendBase = \"window.proxy ? window.proxy.__INJECTED_PUBLIC_PATH_BY_QIANKUN__ || '' : ''\";\n  }\n  script$.removeAttr('src');\n  script$.removeAttr('type');\n  const space = ident;\n  script$.html(`\n${space}const publicUrl = ${appendBase};\n${space}let assetUrl = '${moduleSrc}';\n${space}if (!assetUrl.match(/^https?/i)) {\n${space}  assetUrl = publicUrl + assetUrl;\n${space}}\n${space}import(assetUrl)`);\n  return script$;\n}\n\nfunction createImportFinallyResolve(qiankunName: string, options?: { indent?: string }) {\n  const { indent: space = '      ' } = options ?? {};\n  return `\n${space}const qiankunLifeCycle = window.moudleQiankunAppLifeCycles && window.moudleQiankunAppLifeCycles['${qiankunName}'];\n${space}if (qiankunLifeCycle) {\n${space}  window.proxy.vitemount((props) => qiankunLifeCycle.mount(props));\n${space}  window.proxy.viteunmount((props) => qiankunLifeCycle.unmount(props));\n${space}  window.proxy.vitebootstrap(() => qiankunLifeCycle.bootstrap());\n${space}  window.proxy.viteupdate((props) => qiankunLifeCycle.update(props));\n${space}}\n`;\n}\n\nfunction createQiankunHelper(qiankunName: string, options?: { indent?: string }) {\n  const { indent: space = '      ' } = options ?? {};\n  return `\n${space}const createDeffer = (hookName) => {\n${space}  const d = new Promise((resolve, reject) => {\n${space}    window.proxy && (window.proxy[\\`vite\\${hookName}\\`] = resolve)\n${space}  })\n${space}  return props => d.then(fn => fn(props));\n${space}}\n${space}const bootstrap = createDeffer('bootstrap');\n${space}const mount = createDeffer('mount');\n${space}const unmount = createDeffer('unmount');\n${space}const update = createDeffer('update');\n\n${space};(global => {\n${space}  global.qiankunName = '${qiankunName}';\n${space}  global['${qiankunName}'] = {\n${space}    bootstrap,\n${space}    mount,\n${space}    unmount,\n${space}    update\n${space}  };\n${space}})(window);\n`;\n}\n\nexport default qiankunPlugin;\n"],
+  "mappings": "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",
+  "names": ["space"]
+}

package/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import type { Element } from 'domhandler';
+export declare function detectIndent(html: string, entryScript: Element | undefined): string;
+export declare function space(num: number): string;

package/lib/utils.js

@@ -0,0 +1,59 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  detectIndent: () => detectIndent,
+  space: () => space
+});
+module.exports = __toCommonJS(utils_exports);
+function detectIndent(html, entryScript) {
+  let baseIndent = "";
+  if (entryScript == null ? void 0 : entryScript.sourceCodeLocation) {
+    const newline = html.includes("\r\n") ? "\r\n" : "\n";
+    const lines = html.split(newline);
+    const lineStr = lines[entryScript.sourceCodeLocation.startLine - 1];
+    if (lineStr) {
+      const startTag = "<script";
+      const tagNameFromHtml = lineStr.substring(
+        entryScript.sourceCodeLocation.startCol - 1,
+        entryScript.sourceCodeLocation.startCol - 1 + startTag.length
+      );
+      if (tagNameFromHtml === startTag) {
+        for (let i = 0; i < entryScript.sourceCodeLocation.startCol - 1; i++) {
+          if (/\s/.test(lineStr[i])) {
+            baseIndent += lineStr[i];
+          } else {
+            break;
+          }
+        }
+      }
+    }
+  }
+  return baseIndent;
+}
+function space(num) {
+  return new Array(num + 1).join(" ");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectIndent,
+  space
+});
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/utils.ts"],
+  "sourcesContent": ["import type { Element } from 'domhandler';\n\nexport function detectIndent(html: string, entryScript: Element | undefined) {\n  let baseIndent = '';\n  if (entryScript?.sourceCodeLocation) {\n    const newline = html.includes('\\r\\n') ? '\\r\\n' : '\\n';\n    const lines = html.split(newline);\n    const lineStr = lines[entryScript.sourceCodeLocation.startLine - 1];\n    if (lineStr) {\n      const startTag = '<script';\n      const tagNameFromHtml = lineStr.substring(\n        entryScript.sourceCodeLocation.startCol - 1,\n        entryScript.sourceCodeLocation.startCol - 1 + startTag.length,\n      );\n      if (tagNameFromHtml === startTag) {\n        for (let i = 0; i < entryScript.sourceCodeLocation.startCol - 1; i++) {\n          if (/\\s/.test(lineStr[i])) {\n            baseIndent += lineStr[i];\n          } else {\n            break;\n          }\n        }\n      }\n    }\n  }\n  return baseIndent;\n}\n\nexport function space(num: number) {\n  return new Array(num + 1).join(' ');\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,SAAS,aAAa,MAAc,aAAkC;AAC3E,MAAI,aAAa;AACjB,MAAI,2CAAa,oBAAoB;AACnC,UAAM,UAAU,KAAK,SAAS,MAAM,IAAI,SAAS;AACjD,UAAM,QAAQ,KAAK,MAAM,OAAO;AAChC,UAAM,UAAU,MAAM,YAAY,mBAAmB,YAAY,CAAC;AAClE,QAAI,SAAS;AACX,YAAM,WAAW;AACjB,YAAM,kBAAkB,QAAQ;AAAA,QAC9B,YAAY,mBAAmB,WAAW;AAAA,QAC1C,YAAY,mBAAmB,WAAW,IAAI,SAAS;AAAA,MACzD;AACA,UAAI,oBAAoB,UAAU;AAChC,iBAAS,IAAI,GAAG,IAAI,YAAY,mBAAmB,WAAW,GAAG,KAAK;AACpE,cAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,GAAG;AACzB,0BAAc,QAAQ,CAAC;AAAA,UACzB,OAAO;AACL;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,MAAM,KAAa;AACjC,SAAO,IAAI,MAAM,MAAM,CAAC,EAAE,KAAK,GAAG;AACpC;",
+  "names": []
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@tiny-codes/vite-plugin-qiankun",
+  "version": "2.0.0",
+  "description": "vite for qiankun. This is a forked version of vite-plugin-qiankun.",
+  "keywords": [
+    "qiankun",
+    "vite",
+    "esm",
+    "esModule"
+  ],
+  "homepage": "https://github.com/shijistar/vite-plugin-qiankun",
+  "bugs": {
+    "url": "https://github.com/shijistar/vite-plugin-qiankun/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shijistar/vite-plugin-qiankun.git"
+  },
+  "license": "MIT",
+  "author": "李凤宝(Leo) <shijistar@gmail.com>",
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "module": "es/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "es",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "scripts": {
+    "build": "run-s build-task",
+    "build-task": "father build",
+    "example:install": "cd example/main && npm install && cd ../viteapp && npm install && cd ../vue && npm install && cd ../react18 && npm install && cd ../vue3sub && npm install",
+    "example:start": "npm run build && cd example/viteapp && npm run build && cd ../../ && npm-run-all --parallel start:main start:viteapp start:vue start:react18dev start:vue3sub",
+    "example:start-vite-dev": "npm run build && npm-run-all --parallel start:main start:vitedev start:vue start:react18dev start:vue3sub",
+    "init-husky": "husky",
+    "prepare": "run-s init-husky",
+    "prepublishOnly": "run-s build",
+    "start:main": "cd example/main && npm run start",
+    "start:react18dev": "cd example/react18 && npm run dev",
+    "start:viteapp": "cd example/viteapp && npm run start",
+    "start:vitedev": "cd example/viteapp && npm run dev",
+    "start:vue": "cd example/vue && npm run start",
+    "start:vue3sub": "cd example/vue3sub && npm run dev",
+    "vite:test": "npm run build && cd example/viteapp && npm run dev"
+  },
+  "dependencies": {
+    "cheerio": "^1.0.0"
+  },
+  "devDependencies": {
+    "@tiny-codes/code-style-all-in-one": "^2.0.0",
+    "@types/node": "^22.19.15",
+    "father": "^4.6.17",
+    "npm-run-all2": "^8.0.4",
+    "qiankun": "^2.10.16",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^2.9.9"
+  },
+  "peerDependencies": {
+    "vite": "^2.0.0 | ^3.0.0 | ^4.0.0 | ^5.0.0 | ^6.0.0 | ^7.0.0 | ^8.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/readme.md

@@ -0,0 +1,119 @@
+#### 简介
+
+forked from [vite-plugin-qiankun](https://github.com/tengmaoqing/vite-plugin-qiankun)
+
+> vite-plugin-qiankun: 帮助应用快速接入乾坤的vite插件
+
+- 保留vite构建es模块的优势
+- 一键配置，不影响已有的vite配置
+- 支持vite开发环境
+
+#### 快速开始
+
+###### 1、在 `vite.config.ts` 中安装插件
+
+```typescript
+// vite.config.ts
+import qiankun from 'vite-plugin-qiankun';
+
+export default {
+  // 这里的 'myMicroAppName' 是子应用名，主应用注册时AppName需保持一致
+  plugins: [qiankun('myMicroAppName')],
+  // 生产环境需要指定运行域名作为base
+  base: 'http://xxx.com/',
+};
+```
+
+###### 2、在入口文件里面写入乾坤的生命周期配置
+
+```typescript
+// main.ts
+import { qiankunWindow, renderWithQiankun } from 'vite-plugin-qiankun';
+
+// some code
+renderWithQiankun({
+  mount(props) {
+    console.log('mount');
+    render(props);
+  },
+  bootstrap() {
+    console.log('bootstrap');
+  },
+  unmount(props: any) {
+    console.log('unmount');
+    const { container } = props;
+    const mountRoot = container?.querySelector('#root');
+    ReactDOM.unmountComponentAtNode(mountRoot || document.querySelector('#root'));
+  },
+});
+
+if (!qiankunWindow.__POWERED_BY_QIANKUN__) {
+  render({});
+}
+```
+
+###### 3、dev下作为子应用调试
+
+> 因为开发环境作为子应用时与热更新插件（可能与其他修改html的插件也会存在冲突）有冲突，所以需要额外的调试配置
+
+```typescript
+// useDevMode 开启时与热更新插件冲突,使用变量切换
+const useDevMode = true;
+
+const baseConfig: UserConfig = {
+  plugins: [
+    ...(useDevMode ? [] : [reactRefresh()]),
+    qiankun('viteapp', {
+      useDevMode,
+    }),
+  ],
+};
+```
+
+上面例子中 `useDevMode = true` 则不使用热更新插件，`useDevMode = false` 则能使用热更新，但无法作为子应用加载。
+
+###### 4、子应用部署的域名不同
+
+如果子应用与主应用部署的域名不同，并且子应用的`base`使用了相对路径，例如`/sub-app`，此时可能会导致子应用入口script加载失败。在子应用的页面里，入口script可能会是`/sub-app/index.js`，qiankun会尝试加载该路径，但由于当前域名是主应用，就会导致浏览器尝试从主应用的域名下去加载资源，肯定会失败。
+
+要解决这个问题，可以使用 [getPublicPath](https://qiankun.umijs.org/zh/api) 选项，返回子应用的域名。
+
+```tsx
+loadMicroApp(
+  {
+    name: 'sub-app',
+    entry: `https://www.sub-app.com/path/to/page`,
+  },
+  {
+    getPublicPath: () => `https://www.sub-app.com`,
+  },
+);
+```
+
+###### 5、其它使用注意点 `qiankunWindow`
+
+因为es模块加载与`qiankun`的实现方式有些冲突，所以使用本插件实现的`qiankun`微应用里面没有运行在js沙盒中。所以在不可避免需要设置window上的属性时，尽量显示的操作js沙盒，否则可能会对其它子应用产生副作用。qiankun沙盒使用方式
+
+```typescript
+import { qiankunWindow } from 'vite-plugin-qiankun';
+
+qiankunWindow.customxxx = 'ssss';
+
+if (qiankunWindow.__POWERED_BY_QIANKUN__) {
+  console.log('我正在作为子应用运行');
+}
+```
+
+#### 例子
+
+详细的信息可以参考例子里面的使用方式
+
+```
+git clone xx
+npm install
+npm run example:install
+# 生产环境调试demo
+npm run example:start
+# vite开发环境demo, demo中热更新已经关闭
+npm run example:start-vite-dev
+```