@fulgurjs/federation 5.9.3 → 6.1.0

package/dist/cli.js

@@ -215,18 +215,18 @@ function validateHostPages(value) {
   }
   return hp;
 }
-function validatePathsInsideApp(options, appRoot, fs4, path3) {
+function validatePathsInsideApp(options, appRoot, fs5, path4) {
   const checkModule = (field, value) => {
     if (typeof value !== "string" || value.trim() === "") return;
-    if (/^(https?:)?\/\//.test(value) || path3.isAbsolute(value)) {
+    if (/^(https?:)?\/\//.test(value) || path4.isAbsolute(value)) {
       appConfigError(
         `${field} "${value}" \u4E0D\u662F\u672C\u9879\u76EE\u5185\u7684\u6A21\u5757\u8DEF\u5F84`,
         "exposes/setup \u7684\u503C\u662F\u76F8\u5BF9\u672C\u5E94\u7528\u6839\u76EE\u5F55\u7684\u6E90\u6587\u4EF6\u8DEF\u5F84\uFF08URL/\u7EDD\u5BF9\u8DEF\u5F84\u65E0\u6CD5\u5728\u72EC\u7ACB\u4ED3\u5E93\u95F4\u79FB\u690D\uFF09",
         `\u6539\u4E3A\u76F8\u5BF9\u8DEF\u5F84\uFF0C\u5982 './src/views/Home.vue'\uFF08\u914D\u7F6E\u6587\u4EF6\u76EE\u5F55 = \u5E94\u7528\u6839 ${appRoot}\uFF09`
       );
     }
-    const abs = path3.resolve(appRoot, value);
-    if (!fs4.existsSync(abs)) {
+    const abs = path4.resolve(appRoot, value);
+    if (!fs5.existsSync(abs)) {
       appConfigError(
         `${field} \u6307\u5411\u7684\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${value}`,
         `\u6309\u5E94\u7528\u6839 ${appRoot} \u89E3\u6790\u540E\u672A\u627E\u5230\u8BE5\u6587\u4EF6`,
@@ -295,11 +295,11 @@ function resolveEsbuild(configPath) {
   );
 }
 async function loadAppConfig(configPath) {
-  const fs4 = await import("node:fs");
+  const fs5 = await import("node:fs");
   const os = await import("node:os");
-  const path3 = await import("node:path");
-  const abs = path3.resolve(configPath);
-  if (!fs4.existsSync(abs)) {
+  const path4 = await import("node:path");
+  const abs = path4.resolve(configPath);
+  if (!fs5.existsSync(abs)) {
     appConfigError(
       `\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${abs}`,
       "--config \u6307\u5411\u7684\u8DEF\u5F84\u5728\u672C\u673A\u4E0D\u5B58\u5728\uFF08\u76F8\u5BF9\u8DEF\u5F84\u4EE5 CLI \u8FDB\u7A0B cwd \u89E3\u6790\uFF09",
@@ -307,11 +307,11 @@ async function loadAppConfig(configPath) {
     );
   }
   if (abs.endsWith(".json")) {
-    const parsed = JSON.parse(fs4.readFileSync(abs, "utf8"));
+    const parsed = JSON.parse(fs5.readFileSync(abs, "utf8"));
     if (isAggregateShape(parsed)) aggregateMigrationError();
-    return finishAppShape(parsed, {}, abs, path3.dirname(abs), fs4, path3);
+    return finishAppShape(parsed, {}, abs, path4.dirname(abs), fs5, path4);
   }
-  const rawSource = fs4.readFileSync(abs, "utf8");
+  const rawSource = fs5.readFileSync(abs, "utf8");
   if (/@fulgurjs\/federation\/config/.test(rawSource)) {
     appConfigError(
       `\u914D\u7F6E\u5BFC\u5165\u4E86\u5DF2\u5220\u9664\u7684\u5B50\u8DEF\u5F84 "@fulgurjs/federation/config"`,
@@ -342,21 +342,21 @@ async function loadAppConfig(configPath) {
     plugins: [selfRedirect],
     logLevel: "silent"
   });
-  const tmpDir = fs4.mkdtempSync(path3.join(os.tmpdir(), "fulgurjs-appcfg-"));
+  const tmpDir = fs5.mkdtempSync(path4.join(os.tmpdir(), "fulgurjs-appcfg-"));
   try {
-    const bundleFile = path3.join(tmpDir, "fulgurjs.config.bundle.mjs");
-    fs4.writeFileSync(bundleFile, out.outputFiles[0].text);
+    const bundleFile = path4.join(tmpDir, "fulgurjs.config.bundle.mjs");
+    fs5.writeFileSync(bundleFile, out.outputFiles[0].text);
     const mod = await import(
       /* @vite-ignore */
       `${pathToFileURL(bundleFile).href}?t=${Date.now()}`
     );
     if (isAggregateShape(mod.default)) aggregateMigrationError();
-    return finishAppShape(mod.default, { hostPages: mod.hostPages }, abs, path3.dirname(abs), fs4, path3);
+    return finishAppShape(mod.default, { hostPages: mod.hostPages }, abs, path4.dirname(abs), fs5, path4);
   } finally {
-    fs4.rmSync(tmpDir, { recursive: true, force: true });
+    fs5.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
-function finishAppShape(def, named, configPath, appRoot, fs4, path3) {
+function finishAppShape(def, named, configPath, appRoot, fs5, path4) {
   if (def === void 0 || def === null) {
     appConfigError(
       "fulgurjs.config.ts \u6CA1\u6709\u53EF\u7528\u7684\u9ED8\u8BA4\u5BFC\u51FA",
@@ -369,7 +369,7 @@ function finishAppShape(def, named, configPath, appRoot, fs4, path3) {
   }
   const options = def;
   validateAppOptions(options);
-  validatePathsInsideApp(options, appRoot, fs4, path3);
+  validatePathsInsideApp(options, appRoot, fs5, path4);
   const hostPages = named.hostPages !== void 0 ? validateHostPages(named.hostPages) : void 0;
   return {
     kind: "app",
@@ -396,18 +396,82 @@ var init_app_config = __esm({
 // src/init.ts
 var init_exports = {};
 __export(init_exports, {
+  COMMON_CHECKLIST: () => COMMON_CHECKLIST,
   STARTER_CONFIG: () => STARTER_CONFIG,
+  checklistFor: () => checklistFor,
+  detectFrameworkFromPackageJson: () => detectFrameworkFromPackageJson,
   inspectConfig: () => inspectConfig,
+  starterConfigFor: () => starterConfigFor,
   writeConfigTemplate: () => writeConfigTemplate
 });
 import fs from "node:fs";
 import path from "node:path";
-async function writeConfigTemplate(target, force = false) {
+function detectFrameworkFromPackageJson(pkg) {
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  const hasVue = "vue" in deps;
+  const hasReact = "react" in deps;
+  if (hasVue && !hasReact) return "vue";
+  if (hasReact && !hasVue) return "react";
+  return null;
+}
+function sharedExample(framework) {
+  if (framework === "vue") {
+    return `  // \u8DE8\u5E94\u7528\u5171\u4EAB\u7684\u5E93 singleton: true\uFF08\u5168\u5C40\u54CD\u5E94\u6027/\u8DEF\u7531/store \u6CE8\u5165\u8981\u6C42\u540C\u5B9E\u4F8B\uFF09\u3002
+  // \u53EA\u5217\u9879\u76EE\u5B9E\u9645\u5B89\u88C5\u4E14\u8981\u8DE8\u5E94\u7528\u5171\u4EAB\u7684\u5E93\uFF1BrequiredVersion \u6309\u9879\u76EE\u5B9E\u9645\u7248\u672C\u6536\u655B\uFF08\u53EF\u7701\u7565\uFF09\u3002
+  shared: {
+    vue: { singleton: true },
+  },`;
+  }
+  return `  // \u8DE8\u5E94\u7528\u5171\u4EAB\u7684\u5E93 singleton: true\uFF08Hooks \u72B6\u6001/renderer \u8981\u6C42\u540C\u5B9E\u4F8B\uFF09\u3002
+  // \u53EA\u5217\u9879\u76EE\u5B9E\u9645\u5B89\u88C5\u4E14\u8981\u8DE8\u5E94\u7528\u5171\u4EAB\u7684\u5E93\uFF1BrequiredVersion \u6309\u9879\u76EE\u5B9E\u9645\u7248\u672C\u6536\u655B\uFF08\u53EF\u7701\u7565\uFF09\u3002
+  // react-dom \u4E5F\u6309\u9700\u5171\u4EAB\uFF08\u8FDC\u7A0B\u6E32\u67D3\u8FDB\u5BBF\u4E3B DOM \u65F6\u5FC5\u987B\u540C renderer\uFF09\u3002
+  shared: {
+    react: { singleton: true },
+    'react-dom': { singleton: true },
+  },`;
+}
+function starterConfigFor(scenario) {
+  const { framework, role } = scenario;
+  const wantRemotes = role === "consumer" || role === "dual";
+  const wantExposes = role === "provider" || role === "dual";
+  const lines = [];
+  lines.push(`// fulgurjs.config.ts \u2014\u2014 @fulgurjs/federation \u5355\u9879\u76EE\u63A5\u5165\u914D\u7F6E\uFF08\u4E00\u9879\u76EE\u4E00\u4EFD\uFF0C\u53EF\u5165\u5E93\u3001\u53EF\u590D\u8DD1\uFF09`);
+  lines.push(`//`);
+  lines.push(`// Vite \u63A5\u5165\uFF08\u672C\u9879\u76EE vite.config.ts \u53EA\u9700\u4E24\u884C\u8054\u90A6\u76F8\u5173\u4EE3\u7801\uFF09\uFF1A`);
+  lines.push(`//   import federation from '@fulgurjs/federation'`);
+  lines.push(`//   import fulgurjsConfig from './fulgurjs.config'`);
+  lines.push(`//   // plugins: [ ...\u539F\u6709\u63D2\u4EF6, federation(fulgurjsConfig) ]`);
+  lines.push(`//`);
+  lines.push(`// CLI\uFF08\u7EAF\u672C\u5730\uFF0C\u65E0\u7F51\u7EDC\uFF09\uFF1A`);
+  lines.push(`//   npx fulgurjs explain                      # \u89E3\u91CA\u672C\u5E94\u7528\u6709\u6548\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE`);
+  lines.push(`//   npx fulgurjs check-pages                  # \u9010\u9875\u63A5\u5165\u7684\u5BBF\u4E3B\uFF1A\u9875\u9762\u8868 \u2194 \u8FDC\u7A0B manifest \u5951\u7EA6\u6838\u5BF9`);
+  lines.push(`//   npx fulgurjs doctor --base http://<\u7AD9\u70B9> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55>   # \u90E8\u7F72\u4F53\u68C0`);
+  lines.push(`import type { FederationOptions } from '@fulgurjs/federation'`);
+  lines.push("");
+  lines.push("export default {");
+  lines.push("  // \u8054\u90A6\u5BB9\u5668\u540D\uFF08\u8FDC\u7A0B\u5F15\u7528\u5B83\u65F6\u7528\u8FD9\u4E2A\u540D\uFF1B\u540C\u4E00\u9875\u9762\u5185\u552F\u4E00\uFF09");
+  lines.push("  name: 'my-app',");
+  if (wantExposes) lines.push(EXPOSES_EXAMPLE[framework]);
+  if (wantRemotes) lines.push(REMOTES_EXAMPLE);
+  lines.push("  // \u53EF\u9009\uFF1A\u8FDC\u7A0B\u9700\u8981\u542F\u52A8\u671F\u521D\u59CB\u5316\uFF08\u5168\u5C40\u6837\u5F0F/\u7EC4\u4EF6/locale\uFF09\u65F6\u58F0\u660E\u5165\u53E3\u6587\u4EF6\u2014\u2014");
+  lines.push("  // \u9ED8\u8BA4\u5BFC\u51FA setup(context) \u5E94\u7528\u7EA7\u6267\u884C\u4E00\u6B21\uFF1B\u53EF\u9009\u5177\u540D\u5BFC\u51FA onSession(context)");
+  lines.push("  // \u6309\u5BBF\u4E3B sessionKey \u53BB\u91CD\u6267\u884C\u3002\u7F3A\u7701 = \u65E0\u521D\u59CB\u5316\u884C\u4E3A\uFF08\u666E\u901A expose \u8BED\u4E49\u4E0D\u53D8\uFF09");
+  lines.push("  // setup: './src/fulgurjs/setup.ts',");
+  lines.push(sharedExample(framework));
+  lines.push(`} satisfies FederationOptions`);
+  if (role === "consumer" || role === "dual") {
+    lines.push("");
+    lines.push(HOST_PAGES_COMMENT);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+async function writeConfigTemplate(target, force = false, scenario = { framework: "vue", role: "dual" }) {
   if (fs.existsSync(target) && !force) {
     return "exists";
   }
   fs.mkdirSync(path.dirname(path.resolve(target)), { recursive: true });
-  fs.writeFileSync(path.resolve(target), STARTER_CONFIG);
+  fs.writeFileSync(path.resolve(target), starterConfigFor(scenario));
   return "written";
 }
 function viteSnippetForAppMode(appRoot) {
@@ -422,6 +486,42 @@ export default defineConfig({
   ],
 })`;
 }
+function checklistFor(scenario) {
+  const { framework, role } = scenario;
+  const out = [];
+  const provide = role === "provider" || role === "dual";
+  const consume = role === "consumer" || role === "dual";
+  out.push("1. \u5B89\u88C5\u4F9D\u8D56\uFF1Anpm/pnpm add @fulgurjs/federation");
+  if (provide) {
+    out.push("2. expose \u76EE\u6807\u6309\u7528\u9014\u5206\u7C7B\uFF1A\u666E\u901A\u7EC4\u4EF6/\u51FD\u6570\u6A21\u5757\u53EF\u76F4\u63A5 expose\uFF08\u4F7F\u7528\u65B9 remoteComponent/loadRemote \u6D88\u8D39\uFF09\uFF1B");
+    out.push("   \u4F5C\u4E3A\u300C\u9875\u9762\u300D\u63A5\u5165\u5BBF\u4E3B\u9875\u9762\u8DEF\u7531\u8868\u65F6\u624D\u8981\u6C42\u72EC\u7ACB\u9875\uFF08\u9875\u9762\u4ECE\u8DEF\u7531\u53D6\u53C2\uFF09\uFF1B\u7EC4\u4EF6\u5FC5\u586B props \u7ED9\u9ED8\u8BA4\u503C\uFF08BLD-003\uFF09");
+  }
+  if (consume) {
+    out.push("3. \u6D88\u8D39\u65B9\u5F0F\u6309\u9700\u9009\u62E9\uFF1A\u666E\u901A\u7EC4\u4EF6/\u6A21\u5757\u7528 remoteComponent/loadRemote\uFF08\u4E0D\u9700\u8981\u9875\u9762\u8868\u3001\u4E0D\u9700\u8981\u6865\u63A5\u914D\u7F6E\uFF09\uFF1B");
+    out.push("   \u5B8C\u6574\u5B50\u5E94\u7528\uFF08\u81EA\u5E26 Router/store\uFF09\u7528\u6865\u63A5 createVueBridgeApp/createReactBridgeApp\u2014\u2014\u5BBF\u4E3B\u53EA\u914D\u6302\u8F7D\u524D\u7F00\u4E0E\u5165\u53E3\uFF0C");
+    out.push("   \u5B50\u5E94\u7528\u4FDD\u7559\u81EA\u5DF1\u7684 Router \u4E0E\u4E1A\u52A1\u83DC\u5355\uFF0C\u4E0D\u9010\u9875\u767B\u8BB0\u5185\u90E8\u9875\u9762");
+  }
+  out.push("4. shared \u91CC\u53EA\u5217\u300C\u9879\u76EE\u5B9E\u9645\u5B89\u88C5\u4E14\u8DE8\u5E94\u7528\u5171\u4EAB\u300D\u7684\u5E93\uFF0C\u8DE8\u5E94\u7528\u540C\u5B9E\u4F8B\u7684\uFF08vue/react/react-dom/router/store\uFF09\u914D singleton: true\uFF1B");
+  out.push("   \u72EC\u7ACB Router/store \u7684\u5B8C\u6574\u5B50\u5E94\u7528\u9694\u79BB\u8BBE\u8BA1\u662F\u5408\u6CD5\u7684\u2014\u2014\u4E0D\u662F\u6240\u6709\u5171\u4EAB\u9879\u90FD\u5FC5\u987B singleton");
+  if (consume) {
+    out.push("5. \u8FDC\u7A0B\u9700\u8981\u542F\u52A8\u671F\u521D\u59CB\u5316\uFF08\u5168\u5C40\u7EC4\u4EF6/\u6837\u5F0F/locale \u7B49\uFF09\u65F6\uFF0C\u5728 fulgurjs.config.ts \u7684 setup \u58F0\u660E\u5165\u53E3\u6587\u4EF6\uFF1A");
+    out.push("   \u9ED8\u8BA4\u5BFC\u51FA setup(context) \u5E94\u7528\u7EA7\u6267\u884C\u4E00\u6B21\uFF08\u5BB9\u5668\u9996\u6B21\u88AB\u52A0\u8F7D\u4E1A\u52A1\u6A21\u5757\u524D\uFF09\uFF1B\u53EF\u9009\u5177\u540D\u5BFC\u51FA onSession(context)");
+    out.push("   \u6309\u5BBF\u4E3B sessionKey \u53BB\u91CD\u6267\u884C\uFF08\u6362\u8D26\u53F7/\u91CD\u767B\u81EA\u52A8\u91CD\u8DD1\uFF09\u3002\u8DE8\u5E94\u7528\u4F20\u503C\u8D70 context \u51FD\u6570\uFF1A\u5BBF\u4E3B provideAppContext \u5199\u5165");
+    out.push("   \uFF08\u9000\u51FA\u65F6 clearAppContext \u6E05\u7406\uFF09\uFF0C\u8FDC\u7A0B setup/onSession \u7528 getAppContext / requireAppContext \u6D88\u8D39");
+  }
+  out.push(APP_ENTRY_NOTE[framework]);
+  out.push('6. dev \u51B7\u542F\u52A8\u9996\u8F6E 30~60s \u6709\u9884\u6784\u5EFA\u7A97\u53E3\uFF08\u77AC\u65F6 504/"ce"\uFF0CDEV-010\uFF09\uFF1A\u5148\u771F\u5B9E\u6253\u5F00\u9875\u9762\u9884\u70ED\u518D\u505A\u65AD\u8A00');
+  out.push("7. \u914D\u7F6E\u89E3\u91CA\uFF1Afulgurjs explain\uFF1B\u90E8\u7F72\u4F53\u68C0\uFF1Afulgurjs doctor --base <URL> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55...>");
+  if (consume) {
+    out.push("   \uFF08--apps \u662F\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF0C\u4E0D\u662F\u5BB9\u5668\u540D\uFF09");
+    out.push("8. \u4EC5\u9010\u9875\u63A5\u5165\u7684\u5BBF\u4E3B\uFF1A\u9875\u9762\u5951\u7EA6\u6838\u5BF9 fulgurjs check-pages\uFF08--manifest/--site \u6307\u5B9A\u8FDC\u7A0B manifest \u6765\u6E90\uFF09\uFF1B");
+    out.push("   \u672A\u914D\u7F6E hostPages \u7684\u5DE5\u7A0B\u8FD0\u884C check-pages \u4F1A\u660E\u786E\u63D0\u793A\u300C\u672A\u914D\u7F6E\u8BE5\u80FD\u529B\u300D\uFF0C\u4E0D\u4EA7\u51FA\u4F2A\u6838\u5BF9");
+  } else {
+    out.push("8. \u9010\u9875\u63A5\u5165\uFF08\u5BBF\u4E3B\u9875\u9762\u8DEF\u7531\u8868\uFF09\u662F\u53EF\u9009\u9879\u2014\u2014\u7EAF\u63D0\u4F9B\u65B9\u65E0\u9700 check-pages/hostPages");
+  }
+  out.push("9. \u90E8\u7F72\u8BED\u4E49\uFF1AremoteEntry/manifest/index.html \u5FC5\u987B no-cache\uFF08\u4E25\u7981 immutable\uFF09\uFF1B\u5E26 hash \u7684 assets \u957F\u7F13\u5B58");
+  return out;
+}
 function appModeSummary(loaded) {
   const options = loaded.options;
   const roleText = { host: "\u5BBF\u4E3B", remote: "\u8FDC\u7A0B", dual: "\u5BBF\u4E3B+\u8FDC\u7A0B\uFF08\u53CC\u89D2\u8272\uFF09" }[Object.keys(options.remotes ?? {}).length > 0 && (Object.keys(options.exposes ?? {}).length > 0 || !!options.setup) ? "dual" : Object.keys(options.remotes ?? {}).length > 0 ? "host" : "remote"];
@@ -440,87 +540,81 @@ function appModeSummary(loaded) {
   if (loaded.hostPages) {
     lines.push(`    \u9875\u9762\u8DEF\u7531\u8868\uFF08hostPages \u5177\u540D\u5BFC\u51FA\uFF09\uFF1A${loaded.hostPages.pages.length} \u6761`);
   } else {
-    lines.push("    \u9875\u9762\u8DEF\u7531\u8868\uFF1A\uFF08\u65E0 hostPages \u5BFC\u51FA\u2014\u2014\u7EAF\u8FDC\u7A0B\u5E94\u7528\u65E0\u9700\uFF1B\u5BBF\u4E3B\u5EFA\u8BAE\u63D0\u4F9B\uFF09");
+    lines.push("    \u9875\u9762\u8DEF\u7531\u8868\uFF1A\uFF08\u65E0 hostPages \u5BFC\u51FA\u2014\u2014\u672A\u7528\u9010\u9875\u63A5\u5165\uFF0Ccheck-pages \u4E0D\u9002\u7528\uFF09");
   }
   return lines;
 }
 async function inspectConfig(configPath) {
   const loaded = await loadAppConfig(configPath);
+  const options = loaded.options;
+  const isHost = Object.keys(options.remotes ?? {}).length > 0;
+  const isRemote = Object.keys(options.exposes ?? {}).length > 0 || !!options.setup;
+  const role = isHost && isRemote ? "dual" : isHost ? "consumer" : "provider";
+  let framework = "vue";
+  let frameworkNote = "";
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(loaded.appRoot, "package.json"), "utf8"));
+    const detected = detectFrameworkFromPackageJson(pkg);
+    if (detected) framework = detected;
+    else frameworkNote = "\n   \uFF08\u672A\u80FD\u4ECE package.json \u5224\u65AD\u6846\u67B6\u2014\u2014\u4EE5\u4E0B\u5165\u53E3\u63D0\u793A\u6309 Vue \u7ED9\u51FA\uFF1BReact \u9879\u76EE\u8BF7\u6539\u7528 @fulgurjs/federation/react\uFF09";
+  } catch {
+    frameworkNote = "\n   \uFF08\u672A\u8BFB\u53D6\u5230\u5E94\u7528 package.json\u2014\u2014\u4EE5\u4E0B\u5165\u53E3\u63D0\u793A\u6309 Vue \u7ED9\u51FA\uFF1BReact \u9879\u76EE\u8BF7\u6539\u7528 @fulgurjs/federation/react\uFF09";
+  }
   const out = [];
   out.push(`${MARK} \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF1A\u5355\u9879\u76EE\u5F62\u6001\uFF08\u9ED8\u8BA4\u5BFC\u51FA = federation() \u9009\u9879\uFF09`);
   out.push("\u5E94\u7528\u6458\u8981\uFF1A");
   out.push(...appModeSummary(loaded));
   out.push("\n\u2500\u2500 vite.config.ts plugins \u63A5\u5165\u5757\uFF08\u8FD9\u5C31\u662F\u5168\u90E8\u8054\u90A6\u63A5\u5165\u4EE3\u7801\uFF09 \u2500\u2500");
   out.push(viteSnippetForAppMode(loaded.appRoot));
-  out.push("\n\u2500\u2500 \u63A5\u5165\u6838\u5BF9\u6E05\u5355\uFF08\u8054\u90A6\u901A\u7528\u9879\uFF0C\u4E0E\u5177\u4F53\u9879\u76EE\u65E0\u5173\uFF09 \u2500\u2500");
-  out.push(...COMMON_CHECKLIST);
+  out.push("\n\u2500\u2500 \u63A5\u5165\u6838\u5BF9\u6E05\u5355\uFF08\u6309\u672C\u914D\u7F6E\u7684\u89D2\u8272\u751F\u6210\uFF0C\u4E0E\u5177\u4F53\u9879\u76EE\u65E0\u5173\uFF09 \u2500\u2500");
+  out.push(...checklistFor({ framework, role }).map((line) => line.startsWith("5.") ? line + frameworkNote : line));
   return out.join("\n");
 }
-var MARK, STARTER_CONFIG, COMMON_CHECKLIST;
+var MARK, REMOTES_EXAMPLE, EXPOSES_EXAMPLE, HOST_PAGES_COMMENT, STARTER_CONFIG, APP_ENTRY_NOTE, COMMON_CHECKLIST;
 var init_init = __esm({
   "src/init.ts"() {
     "use strict";
     init_app_config();
     MARK = "[fulgurjs:init]";
-    STARTER_CONFIG = `// fulgurjs.config.ts \u2014\u2014 @fulgurjs/federation \u5355\u9879\u76EE\u63A5\u5165\u914D\u7F6E\uFF08\u4E00\u9879\u76EE\u4E00\u4EFD\uFF0C\u53EF\u5165\u5E93\u3001\u53EF\u590D\u8DD1\uFF09
-//
-// Vite \u63A5\u5165\uFF08\u672C\u9879\u76EE vite.config.ts \u53EA\u9700\u4E24\u884C\u8054\u90A6\u76F8\u5173\u4EE3\u7801\uFF09\uFF1A
-//   import federation from '@fulgurjs/federation'
-//   import fulgurjsConfig from './fulgurjs.config'
-//   // plugins: [ ...\u539F\u6709\u63D2\u4EF6, federation(fulgurjsConfig) ]
-//
-// CLI\uFF08\u7EAF\u672C\u5730\uFF0C\u65E0\u7F51\u7EDC\uFF09\uFF1A
-//   npx fulgurjs explain                      # \u89E3\u91CA\u672C\u5E94\u7528\u6709\u6548\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE
-//   npx fulgurjs check-pages                  # \u5BBF\u4E3B\u9875\u9762\u8868 \u2194 \u8FDC\u7A0B manifest \u5951\u7EA6\u6838\u5BF9
-//   npx fulgurjs doctor --base http://<\u7AD9\u70B9> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55>   # \u90E8\u7F72\u4F53\u68C0\uFF08\u90E8\u7F72\u5728 /my-remote/ \u5C31\u5199 my-remote\uFF09
-import type { FederationOptions } from '@fulgurjs/federation'
-
-export default {
-  // \u8054\u90A6\u5BB9\u5668\u540D\uFF08\u8FDC\u7A0B\u5F15\u7528\u5B83\u65F6\u7528\u8FD9\u4E2A\u540D\uFF1B\u540C\u4E00\u9875\u9762\u5185\u552F\u4E00\uFF09
-  name: 'my-app',
-  // \u672C\u5E94\u7528\u5BF9\u5916\u66B4\u9732\u7684\u6A21\u5757\uFF1A'./\u952E' \u2192 \u76F8\u5BF9\u672C\u9879\u76EE\u6839\u7684\u6E90\u6587\u4EF6\u8DEF\u5F84
-  exposes: {
-    './pages/home': './src/views/Home.vue',
-  },
-  // \u672C\u5E94\u7528\u6D88\u8D39\u7684\u8FDC\u7A0B\uFF08\u952E = import \u524D\u7F00\uFF1Bdev/prod \u5730\u5740\u4E8C\u6BB5\u5F0F\uFF0C\u5355\u5730\u5740\u5B57\u7B26\u4E32\u4E5F\u884C\uFF09
+    REMOTES_EXAMPLE = `  // \u672C\u5E94\u7528\u6D88\u8D39\u7684\u8FDC\u7A0B\uFF08\u952E = import \u524D\u7F00\uFF1Bdev/prod \u5730\u5740\u4E8C\u6BB5\u5F0F\uFF0C\u5355\u5730\u5740\u5B57\u7B26\u4E32\u4E5F\u884C\uFF09
   remotes: {
     'remote-a': { dev: 'http://localhost:5174/remote-a', prod: '/remote-a' },
-  },
-  // \u53EF\u9009\uFF1A\u8FDC\u7A0B\u9700\u8981\u542F\u52A8\u671F\u521D\u59CB\u5316\uFF08\u5168\u5C40\u6837\u5F0F/\u7EC4\u4EF6/locale\uFF09\u65F6\u58F0\u660E\u5165\u53E3\u6587\u4EF6\u2014\u2014
-  // \u9ED8\u8BA4\u5BFC\u51FA setup(context) \u5E94\u7528\u7EA7\u6267\u884C\u4E00\u6B21\uFF1B\u53EF\u9009\u5177\u540D\u5BFC\u51FA onSession(context)
-  // \u6309\u5BBF\u4E3B sessionKey \u53BB\u91CD\u6267\u884C\u3002\u7F3A\u7701 = \u65E0\u521D\u59CB\u5316\u884C\u4E3A\uFF08\u666E\u901A expose \u8BED\u4E49\u4E0D\u53D8\uFF09
-  // setup: './src/fulgurjs/setup.ts',
-  shared: {
-    vue: { singleton: true, requiredVersion: '^3.4.0' },
-    'vue-router': { singleton: true, requiredVersion: '^4.4.5' },
-    pinia: { singleton: true, requiredVersion: '^2.1.7' },
-  },
-} satisfies FederationOptions
-
-// \u2500\u2500 \u4EE5\u4E0B\u4EC5\u4F9B CLI explain/check-pages \u8BFB\u53D6\uFF08\u4E0D\u662F federation() \u7684\u53C2\u6570\uFF09\u2500\u2500
-// \u5BBF\u4E3B\u5E94\u7528\uFF1A\u628A\u9875\u9762\u8DEF\u7531\u8868\u4EE5\u5177\u540D\u5BFC\u51FA hostPages \u63D0\u4F9B\u7ED9 CLI\uFF0C\u4E0E\u8FD0\u884C\u65F6 createHostPages
-// \u6D88\u8D39\u540C\u4E00\u4EFD\u6570\u636E\u6A21\u5757\uFF08\u552F\u4E00\u624B\u5DE5\u7EF4\u62A4\u4F4D\u7F6E\uFF1B\u7EAF\u8FDC\u7A0B\u5E94\u7528\u5220\u9664\u672C\u6BB5\u5373\u53EF\uFF09\u3002
+  },`;
+    EXPOSES_EXAMPLE = {
+      vue: `  // \u672C\u5E94\u7528\u5BF9\u5916\u66B4\u9732\u7684\u6A21\u5757\uFF1A'./\u952E' \u2192 \u76F8\u5BF9\u672C\u9879\u76EE\u6839\u7684\u6E90\u6587\u4EF6\u8DEF\u5F84
+  // \u666E\u901A\u7EC4\u4EF6/\u51FD\u6570\u6A21\u5757\u53EF\u76F4\u63A5 expose\uFF08\u4F7F\u7528\u65B9 remoteComponent/loadRemote \u6D88\u8D39\uFF0Cprops \u89C1\u7EC4\u4EF6\u5951\u7EA6\uFF09\uFF1B
+  // \u53EA\u6709\u4F5C\u4E3A\u300C\u9875\u9762\u300D\u63A5\u5165\uFF08\u5BBF\u4E3B\u9875\u9762\u8DEF\u7531\u8868\uFF09\u65F6\u624D\u8981\u6C42\u72EC\u7ACB\u9875\uFF08\u4ECE\u8DEF\u7531\u53D6\u53C2\uFF09
+  exposes: {
+    './shared/user-badge': './src/components/UserBadge.vue',
+  },`,
+      react: `  // \u672C\u5E94\u7528\u5BF9\u5916\u66B4\u9732\u7684\u6A21\u5757\uFF1A'./\u952E' \u2192 \u76F8\u5BF9\u672C\u9879\u76EE\u6839\u7684\u6E90\u6587\u4EF6\u8DEF\u5F84
+  // \u666E\u901A\u7EC4\u4EF6/\u51FD\u6570\u6A21\u5757\u53EF\u76F4\u63A5 expose\uFF08\u4F7F\u7528\u65B9 remoteComponent/loadRemote \u6D88\u8D39\uFF0Cprops \u89C1\u7EC4\u4EF6\u5951\u7EA6\uFF09\uFF1B
+  // \u53EA\u6709\u4F5C\u4E3A\u300C\u9875\u9762\u300D\u63A5\u5165\uFF08\u5BBF\u4E3B\u9875\u9762\u8DEF\u7531\u8868\uFF09\u65F6\u624D\u8981\u6C42\u72EC\u7ACB\u9875\uFF08\u4ECE\u8DEF\u7531\u53D6\u53C2\uFF09
+  exposes: {
+    './shared/user-badge': './src/components/UserBadge.tsx',
+  },`
+    };
+    HOST_PAGES_COMMENT = `// \u2500\u2500 \u4EE5\u4E0B\u4EC5\u4F9B\u9010\u9875\u63A5\u5165\u7684\u5BBF\u4E3B\u4F7F\u7528\uFF08\u4E0D\u662F federation() \u7684\u53C2\u6570\uFF09\u2500\u2500
+// \u9010\u9875\u63A5\u5165\uFF08\u5BBF\u4E3B\u9875\u9762\u8DEF\u7531\u8868 \u2192 \u8FDC\u7A0B\u9875\u9762\uFF09\u65F6\uFF0C\u628A\u9875\u9762\u8DEF\u7531\u8868\u4EE5\u5177\u540D\u5BFC\u51FA hostPages \u63D0\u4F9B\u7ED9 CLI\uFF0C
+// \u4E0E\u8FD0\u884C\u65F6 createHostPages \u6D88\u8D39\u540C\u4E00\u4EFD\u6570\u636E\u6A21\u5757\uFF08\u552F\u4E00\u624B\u5DE5\u7EF4\u62A4\u4F4D\u7F6E\uFF09\u3002
 // \u7EAF\u6570\u636E\u6A21\u5757\u793A\u4F8B src/fulgurjs/host/pages.data.ts\uFF1A
 //   export const remotePrefixes = { '/remote-a/': 'remote-a' }
 //   export const pages = [{ route: '/remote-a/home', name: 'Home', title: '\u9996\u9875' }]
 // import { pages, remotePrefixes } from './src/fulgurjs/host/pages.data'
 // export const hostPages = { pages, remotePrefixes }
-`;
-    COMMON_CHECKLIST = [
-      "1. \u5B89\u88C5\u4F9D\u8D56\uFF1Anpm/pnpm add @fulgurjs/federation",
-      "2. expose \u4E00\u5F8B\u6307\u5411\u72EC\u7ACB\u9875\uFF08\u9875\u9762\u4ECE\u8DEF\u7531\u53D6\u53C2\uFF09\uFF1B\u7EC4\u4EF6\u9700\u8981\u5FC5\u586B props \u65F6\u7ED9\u9ED8\u8BA4\u503C\uFF08BLD-003\uFF09",
-      "3. shared \u91CC vue / vue-router / pinia \u5EFA\u8BAE singleton: true\u2014\u2014\u8DE8\u5E94\u7528\u5FC5\u987B\u540C\u5B9E\u4F8B\uFF08\u5168\u5C40\u54CD\u5E94\u6027\u3001getActivePinia\u3001\u8DEF\u7531\u6CE8\u5165\uFF09",
-      "4. \u8FDC\u7A0B\u9700\u8981\u542F\u52A8\u671F\u521D\u59CB\u5316\uFF08\u5168\u5C40\u7EC4\u4EF6/\u6837\u5F0F/locale \u7B49\uFF09\u65F6\uFF0C\u5728 fulgurjs.config.ts \u7684 setup \u58F0\u660E\u5165\u53E3\u6587\u4EF6\uFF1A",
-      "   \u9ED8\u8BA4\u5BFC\u51FA setup(context) \u5E94\u7528\u7EA7\u6267\u884C\u4E00\u6B21\uFF08\u5BB9\u5668\u9996\u6B21\u88AB\u52A0\u8F7D\u4E1A\u52A1\u6A21\u5757\u524D\uFF09\uFF1B\u53EF\u9009\u5177\u540D\u5BFC\u51FA onSession(context)",
-      "   \u6309\u5BBF\u4E3B sessionKey \u53BB\u91CD\u6267\u884C\uFF08\u6362\u8D26\u53F7/\u91CD\u767B\u81EA\u52A8\u91CD\u8DD1\uFF09\u3002\u5BBF\u4E3B\u65E0\u9700\u518D\u624B\u5199\u300CloadRemote \u542F\u52A8\u5668\u5E76\u8C03\u7528\u300D\uFF1B",
-      "   \u8DE8\u5E94\u7528\u4F20\u503C\u7EDF\u4E00\u8D70 @fulgurjs/federation/runtime \u7684 context \u51FD\u6570\uFF1A\u5BBF\u4E3B provideAppContext \u5199\u5165",
-      "   \uFF08\u9000\u51FA\u65F6 clearAppContext \u6E05\u7406\uFF09\uFF0C\u8FDC\u7A0B setup/onSession \u7528 getAppContext / requireAppContext \u6D88\u8D39",
-      "5. \u5E94\u7528\u4EE3\u7801\u552F\u4E00 API \u5165\u53E3\uFF1Aimport { loadRemote, provideAppContext, getAppContext, clearAppContext, definePages, createHostPages, remoteSchema, remoteComponent } from '@fulgurjs/federation/runtime'",
-      '6. dev \u51B7\u542F\u52A8\u9996\u8F6E 30~60s \u6709\u9884\u6784\u5EFA\u7A97\u53E3\uFF08\u77AC\u65F6 504/"ce"\uFF0CDEV-010\uFF09\uFF1A\u5148\u771F\u5B9E\u6253\u5F00\u9875\u9762\u9884\u70ED\u518D\u505A\u65AD\u8A00',
-      "7. \u914D\u7F6E\u89E3\u91CA\uFF1Afulgurjs explain\uFF1B\u9875\u9762\u5951\u7EA6\u6838\u5BF9\uFF1Afulgurjs check-pages\uFF08\u5BBF\u4E3B\u9879\u76EE\u8FD0\u884C\uFF0C--manifest/--site \u6307\u5B9A\u8FDC\u7A0B manifest \u6765\u6E90\uFF09\uFF1B",
-      "   \u90E8\u7F72\u4F53\u68C0\uFF1Afulgurjs doctor --base <URL> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55...>\uFF08--apps \u662F\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF0C\u4E0D\u662F\u5BB9\u5668\u540D\uFF09",
-      "8. \u90E8\u7F72\u8BED\u4E49\uFF1AremoteEntry/manifest/index.html \u5FC5\u987B no-cache\uFF08\u4E25\u7981 immutable\uFF09\uFF1B\u5E26 hash \u7684 assets \u957F\u7F13\u5B58"
-    ];
+//
+// \u4E0D\u7528\u9010\u9875\u63A5\u5165\uFF08\u5B8C\u6574\u5B50\u5E94\u7528\u6865\u63A5 / \u666E\u901A\u7EC4\u4EF6\u6D88\u8D39\uFF09\u5219\u5220\u9664\u672C\u6BB5\u2014\u2014\u4E1A\u52A1\u83DC\u5355\u4E0E\u4E1A\u52A1 Router
+// \u4ECD\u5F52\u5E94\u7528\u81EA\u5DF1\u7BA1\u7406\uFF0C\u8054\u90A6\u4E0D\u63A5\u7BA1\u3002`;
+    STARTER_CONFIG = starterConfigFor({ framework: "vue", role: "dual" });
+    APP_ENTRY_NOTE = {
+      vue: `5. Vue \u5E94\u7528\u4EE3\u7801\u552F\u4E00 API \u5165\u53E3\uFF1Aimport { loadRemote, remoteComponent, createHostPages, provideAppContext, getAppContext, clearAppContext, definePages, remoteSchema } from '@fulgurjs/federation/vue'
+   \uFF08\u5B8C\u6574\u5B50\u5E94\u7528\u6865\u63A5\u53E6\u52A0 createVueBridgeApp / defineBridgeApp\uFF1BURL \u540C\u6B65\u53E6\u52A0 createVueBridgeNavigation / connectVueBridgeRouter\u2014\u2014\u540C\u4E00\u5165\u53E3\u3002
+    \u6846\u67B6\u65E0\u5173\u6A21\u5757\uFF08\u7EAF JS/TS \u6D88\u8D39\u3001\u65E0 Vue\uFF09\u7528 @fulgurjs/federation/runtime\uFF09`,
+      react: `5. React \u5E94\u7528\u4EE3\u7801\u552F\u4E00 API \u5165\u53E3\uFF1Aimport { loadRemote, remoteComponent, useLoadRemote, RemoteErrorBoundary, createReactHostPages, provideAppContext, getAppContext, clearAppContext, definePages, remoteSchema } from '@fulgurjs/federation/react'
+   \uFF08\u5B8C\u6574\u5B50\u5E94\u7528\u6865\u63A5\u53E6\u52A0 createReactBridgeApp / defineBridgeApp\uFF1BURL \u540C\u6B65\u53E6\u52A0 createReactBridgeNavigation / createReactBridgeRouter\u2014\u2014\u540C\u4E00\u5165\u53E3\u3002
+    \u6846\u67B6\u65E0\u5173\u6A21\u5757\uFF08\u7EAF JS/TS \u6D88\u8D39\u3001\u65E0 React\uFF09\u7528 @fulgurjs/federation/runtime\uFF09`
+    };
+    COMMON_CHECKLIST = checklistFor({ framework: "vue", role: "dual" });
   }
 });
 
@@ -535,11 +629,13 @@ __export(create_exports, {
   defaultInstall: () => defaultInstall,
   formatCreateResult: () => formatCreateResult,
   isExcluded: () => isExcluded,
-  nodeVersionWarning: () => nodeVersionWarning,
+  nodeEnginesViolation: () => nodeEnginesViolation,
   packageRootOf: () => packageRootOf,
+  pnpmUnavailableReason: () => pnpmUnavailableReason,
   readDevConfig: () => readDevConfig,
   resolveTemplatesRoot: () => resolveTemplatesRoot,
   scanTemplateConflicts: () => scanTemplateConflicts,
+  templateEnginesNode: () => templateEnginesNode,
   validateTemplateDir: () => validateTemplateDir
 });
 import fs2 from "node:fs";
@@ -669,15 +765,18 @@ function formatCreateResult(result) {
     for (const c of result.skippedConflicts) lines.push(`  ${c.rel} \u2014 ${c.reason}`);
   }
   lines.push("\u540E\u7EED\u6B65\u9AA4\uFF1A");
-  lines.push(`  cd ${result.target}`);
+  lines.push(`  cd "${result.target}"`);
   if (!result.installRan) lines.push("  pnpm install --frozen-lockfile");
   lines.push("  pnpm dev                # \u6309\u542F\u52A8\u987A\u5E8F\u62C9\u8D77\u5168\u90E8\u5E94\u7528\uFF0C\u5931\u8D25\u4F1A\u6574\u7EC4\u9000\u51FA\u5E76\u8BF4\u660E\u539F\u56E0");
   lines.push("\u8BBF\u95EE\u5165\u53E3\uFF08\u8FDC\u7A0B\u5148\u4E8E\u5BBF\u4E3B\u5C31\u7EEA\uFF09\uFF1A");
   for (const app of apps) {
     lines.push(`  http://localhost:${app.port}/    ${app.name}${app.dir !== app.name ? `\uFF08\u76EE\u5F55 ${app.dir}\uFF09` : ""}`);
   }
-  const hosts = apps.slice().reverse();
-  lines.push(`\u6D4F\u89C8\u5668\u6253\u5F00\u5BBF\u4E3B\u5165\u53E3\uFF1A${hosts.length ? `http://localhost:${hosts[0].port}/` : "\uFF08\u89C1\u6A21\u677F README\uFF09"}`);
+  const hosts = apps.filter((a) => a.host);
+  const hostList = hosts.length ? hosts : apps.slice(-1);
+  lines.push(
+    "\u6D4F\u89C8\u5668\u6253\u5F00\u5BBF\u4E3B\u5165\u53E3\uFF1A" + hostList.map((a) => `http://localhost:${a.port}/\uFF08${a.name}\uFF09`).join("  ")
+  );
   lines.push("  pnpm build              # \u5404\u5B50\u5E94\u7528\u751F\u4EA7\u6784\u5EFA\uFF08\u8FDC\u7A0B\u751F\u6210 fulgurjs-remoteEntry.js / fulgurjs-manifest.json\uFF09");
   lines.push("  \u90E8\u7F72\u89C4\u5219\uFF08no-cache / SPA \u56DE\u9000 / base \u5BF9\u9F50\uFF09\u89C1\u6A21\u677F\u5185\u5404\u5B50\u5E94\u7528 README\uFF1B\u90E8\u7F72\u540E\u53EF\u7528 npx fulgurjs doctor --base <\u7AD9\u70B9> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55> \u4F53\u68C0");
   lines.push("  \u6539\u7AEF\u53E3\uFF08\u56DB\u5904\u540C\u6B65\uFF0C\u6F0F\u4E00\u5904\u542F\u52A8\u5668\u4F1A\u88AB\u65E7\u7AEF\u53E3\u5361\u4F4F\uFF09\uFF1A");
@@ -708,10 +807,23 @@ function formatCreateJson(result) {
     2
   );
 }
-function nodeVersionWarning(nodeVersion) {
+function nodeEnginesViolation(nodeVersion, range) {
+  if (!range) return void 0;
+  const m = range.trim().match(/^>=?(\d+)\.(\d+)(?:\.(\d+))?/);
+  if (!m) return void 0;
+  const parse = (v) => v.replace(/^v/, "").split(/[.-]/).map((x) => Number(x) || 0);
+  const [curMajor, curMinor = 0, curPatch = 0] = parse(nodeVersion);
+  const [minMajor, minMinor = 0, minPatch = 0] = [Number(m[1]), Number(m[2] ?? 0), Number(m[3] ?? 0)];
+  const ge = (a, b) => a[0] !== b[0] ? a[0] > b[0] : a[1] !== b[1] ? a[1] > b[1] : (a[2] ?? 0) >= (b[2] ?? 0);
+  if (range.startsWith(">=")) {
+    if (!ge([curMajor, curMinor, curPatch], [minMajor, minMinor, minPatch])) {
+      return `\u5F53\u524D Node ${nodeVersion} \u4E0D\u6EE1\u8DB3\u6A21\u677F\u8981\u6C42 engines.node ${range}`;
+    }
+    return void 0;
+  }
   const major = Number(nodeVersion.replace(/^v/, "").split(".")[0]);
-  if (Number.isFinite(major) && major < 20) {
-    return `\u5F53\u524D Node ${nodeVersion} \u4F4E\u4E8E\u6A21\u677F\u8981\u6C42\uFF08Node \u2265 20\uFF0C\u5B9E\u6D4B 24.x\uFF09\u2014\u2014\u5B89\u88C5\u53EF\u80FD\u6210\u529F\uFF0C\u4F46\u4E0E\u6A21\u677F\u9A8C\u8BC1\u73AF\u5883\u4E0D\u7B26`;
+  if (Number.isFinite(major) && major < minMajor) {
+    return `\u5F53\u524D Node ${nodeVersion} \u4F4E\u4E8E\u6A21\u677F\u8981\u6C42 engines.node ${range}`;
   }
   return void 0;
 }
@@ -746,9 +858,22 @@ async function createProject(opts, io) {
       );
     }
   }
-  const warnings = [];
-  const nodeWarn = nodeVersionWarning(process.version);
-  if (nodeWarn) warnings.push(nodeWarn);
+  const enginesViolation = nodeEnginesViolation(process.version, templateEnginesNode(templateDir));
+  if (enginesViolation) {
+    throw new Error(
+      `[fulgurjs:create] \u73AF\u5883\u6821\u9A8C\u5931\u8D25\uFF1A${enginesViolation}
+  \u4FEE\u6CD5\uFF1A\u5347\u7EA7 Node\uFF08nvm install <\u7248\u672C> && nvm use <\u7248\u672C>\uFF0C\u6216\u4ECE https://nodejs.org \u5B89\u88C5 LTS\uFF09\u540E\u91CD\u8BD5\uFF1B\u672A\u5199\u5165\u4EFB\u4F55\u6587\u4EF6`
+    );
+  }
+  if (opts.install) {
+    const pnpmMissing = await pnpmUnavailableReason();
+    if (pnpmMissing) {
+      throw new Error(
+        `[fulgurjs:create] \u73AF\u5883\u6821\u9A8C\u5931\u8D25\uFF1A${pnpmMissing}
+  \u4FEE\u6CD5\uFF1Acorepack enable\uFF08Node \u81EA\u5E26\uFF09\uFF0C\u6216 npm i -g pnpm\uFF1B\u672A\u5199\u5165\u4EFB\u4F55\u6587\u4EF6`
+      );
+    }
+  }
   let outcome;
   try {
     if (fs2.existsSync(target) && fs2.readdirSync(target).length > 0) {
@@ -791,7 +916,6 @@ async function createProject(opts, io) {
   } else {
     io.log("[fulgurjs:create] \u6309\u8981\u6C42\u8DF3\u8FC7\u5B89\u88C5\uFF08--no-install\uFF09\uFF1A\u8FDB\u5165\u76EE\u5F55\u540E\u5148\u6267\u884C pnpm install --frozen-lockfile");
   }
-  for (const w of warnings) io.log(`[fulgurjs:create] \u8B66\u544A\uFF1A${w}`);
   const result = {
     template: templateName,
     target,
@@ -806,6 +930,24 @@ async function createProject(opts, io) {
   else io.log(formatCreateResult(result));
   return result;
 }
+function templateEnginesNode(templateDir) {
+  try {
+    const pkg = JSON.parse(fs2.readFileSync(path2.join(templateDir, "package.json"), "utf8"));
+    return pkg.engines?.node;
+  } catch {
+    return void 0;
+  }
+}
+async function pnpmUnavailableReason() {
+  const code = await new Promise((resolve2) => {
+    const child = spawn("pnpm", ["--version"], { stdio: "ignore" });
+    child.once("error", () => resolve2(127));
+    child.once("close", (c) => resolve2(c ?? 1));
+  });
+  if (code === 127) return "pnpm \u672A\u5B89\u88C5\u6216\u4E0D\u5728 PATH";
+  if (code !== 0) return `pnpm --version \u9000\u51FA\u7801 ${code}\uFF08pnpm \u5B89\u88C5\u5F02\u5E38\uFF09`;
+  return void 0;
+}
 function defaultInstall(cwd, output = "inherit") {
   return new Promise((resolve2) => {
     const child = output === "inherit" ? spawn("pnpm", ["install", "--frozen-lockfile"], { cwd, stdio: "inherit" }) : spawn("pnpm", ["install", "--frozen-lockfile"], { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -1284,6 +1426,110 @@ var init_commands = __esm({
   }
 });
 
+// src/port.ts
+var port_exports = {};
+__export(port_exports, {
+  applyPortChange: () => applyPortChange,
+  formatPortPlan: () => formatPortPlan,
+  planPortChange: () => planPortChange
+});
+import fs4 from "node:fs";
+import path3 from "node:path";
+function readDevConfig2(root) {
+  const file = path3.join(root, "scripts", "dev.config.json");
+  if (!fs4.existsSync(file)) {
+    throw new Error(
+      "[fulgurjs:port] \u672A\u627E\u5230 scripts/dev.config.json\u2014\u2014\u672C\u547D\u4EE4\u7528\u4E8E\u6A21\u677F\u5DE5\u7A0B\uFF08create \u751F\u6210\uFF09\u3002\n  \u4FEE\u6CD5\uFF1A\u5728\u6A21\u677F\u5DE5\u7A0B\u6839\u76EE\u5F55\u8FD0\u884C\uFF1B\u81EA\u5EFA\u5DE5\u7A0B\u8BF7\u6309\u6587\u6863\u56DB\u5904\u6E05\u5355\u624B\u5DE5\u6539\u7AEF\u53E3"
+    );
+  }
+  return JSON.parse(fs4.readFileSync(file, "utf8"));
+}
+function replacePort(text, from, to) {
+  const re = new RegExp(`(?<![0-9])${from}(?![0-9])`, "g");
+  let hits = 0;
+  const out = text.replace(re, () => {
+    hits++;
+    return String(to);
+  });
+  return { text: out, hits };
+}
+function planPortChange(root, app, to) {
+  const cfg = readDevConfig2(root);
+  const target = cfg.apps.find((a) => a.name === app || a.dir === app);
+  if (!target) {
+    throw new Error(
+      `[fulgurjs:port] dev.config.json \u4E2D\u6CA1\u6709\u5E94\u7528\u300C${app}\u300D\u3002\u73B0\u6709\u5E94\u7528\uFF1A${cfg.apps.map((a) => a.name).join("\u3001")}`
+    );
+  }
+  const from = target.port;
+  if (from === to) {
+    throw new Error(`[fulgurjs:port] ${app} \u5DF2\u662F\u7AEF\u53E3 ${to}\uFF0C\u65E0\u9700\u53D8\u66F4`);
+  }
+  const notes = [];
+  const candidates = [
+    { file: path3.join(root, target.dir, "package.json"), required: true },
+    { file: path3.join(root, "scripts", "dev.config.json"), required: true },
+    { file: path3.join(root, "fulgurjs.config.ts"), required: false },
+    { file: path3.join(root, "README.md"), required: false }
+  ];
+  for (const a of cfg.apps) {
+    if (a.host && a.dir !== target.dir) {
+      candidates.push({ file: path3.join(root, a.dir, "fulgurjs.config.ts"), required: false });
+    }
+  }
+  const plans = [];
+  for (const c of candidates) {
+    if (!fs4.existsSync(c.file)) {
+      if (c.required) plans.push({ file: c.file, hits: 0, status: "missing-file" });
+      continue;
+    }
+    const text = fs4.readFileSync(c.file, "utf8");
+    const { hits } = replacePort(text, from, to);
+    plans.push({ file: c.file, hits, status: hits > 0 ? "planned" : "not-found" });
+  }
+  if (!plans.some((p) => p.status === "planned")) {
+    throw new Error(
+      `[fulgurjs:port] \u65E7\u7AEF\u53E3 ${from} \u672A\u5728\u4EFB\u4F55\u53D7\u5F71\u54CD\u6587\u4EF6\u4E2D\u51FA\u73B0\u2014\u2014\u5DE5\u7A0B\u53EF\u80FD\u5DF2\u624B\u5DE5\u6539\u8FC7\u3002\u8BF7\u6838\u5BF9 scripts/dev.config.json \u4E0E\u6587\u6863`
+    );
+  }
+  const notFound = plans.filter((p) => p.status === "not-found" || p.status === "missing-file");
+  if (notFound.length) {
+    notes.push(`\u4EE5\u4E0B\u6587\u4EF6\u672A\u53D1\u73B0\u65E7\u7AEF\u53E3 ${from}\uFF08\u53EF\u80FD\u5DF2\u6539\u6216\u5F62\u6001\u4E0D\u540C\uFF0C\u8BF7\u4EBA\u5DE5\u786E\u8BA4\uFF09\uFF1A${notFound.map((p) => path3.relative(root, p.file)).join("\u3001")}`);
+  }
+  return { app: target.name, dir: target.dir, from, to, plans, notes };
+}
+function applyPortChange(root, plan) {
+  let written = 0;
+  for (const p of plan.plans) {
+    if (p.status !== "planned" || p.hits === 0) continue;
+    const text = fs4.readFileSync(p.file, "utf8");
+    const { text: out, hits } = replacePort(text, plan.from, plan.to);
+    if (hits > 0) {
+      fs4.writeFileSync(p.file, out);
+      written++;
+    }
+  }
+  return written;
+}
+function formatPortPlan(root, plan) {
+  const lines = [];
+  lines.push(`[fulgurjs:port] \u8BA1\u5212\uFF1A${plan.app}\uFF08\u76EE\u5F55 ${plan.dir}\uFF09\u7AEF\u53E3 ${plan.from} \u2192 ${plan.to}`);
+  for (const p of plan.plans) {
+    const rel = path3.relative(root, p.file);
+    if (p.status === "planned") lines.push(`  \u6539\u5199 ${rel}\uFF08${p.hits} \u5904\uFF09`);
+    else if (p.status === "not-found") lines.push(`  \u8DF3\u8FC7 ${rel}\uFF08\u672A\u53D1\u73B0\u65E7\u7AEF\u53E3 ${plan.from}\uFF09`);
+    else lines.push(`  \u8DF3\u8FC7 ${rel}\uFF08\u6587\u4EF6\u4E0D\u5B58\u5728\uFF09`);
+  }
+  for (const n of plan.notes) lines.push(`  \u6CE8\uFF1A${n}`);
+  lines.push("\u9884\u89C8\u6A21\u5F0F\u672A\u5199\u76D8\uFF1B\u786E\u8BA4\u65E0\u8BEF\u540E\u52A0 --write \u6267\u884C\u3002\u5199\u5165\u53EF\u7528 git checkout <file> \u56DE\u9000\u3002");
+  return lines.join("\n");
+}
+var init_port = __esm({
+  "src/port.ts"() {
+    "use strict";
+  }
+});
+
 // src/cli.ts
 import { resolve } from "node:path";
 
@@ -1434,8 +1680,9 @@ async function runDoctor(opts) {
   const perAppShared = [];
   const chunkSample = opts.chunkSample ?? 16;
   for (const app of opts.apps) {
-    const root = `${opts.base.replace(/\/$/, "")}/${app.replace(/^\//, "")}`;
-    const entry = await checkStatus(`${root}/fulgurjs-remoteEntry.js`, app, "fulgurjs-remoteEntry.js", {
+    const root = /^(https?:)?\/\//.test(app) ? app.replace(/\/$/, "") : app === "." || app === "" ? opts.base.replace(/\/$/, "") : `${opts.base.replace(/\/$/, "")}/${app.replace(/^\//, "")}`;
+    const entryName = opts.entry ?? "fulgurjs-remoteEntry.js";
+    const entry = opts.noEntry ? { res: void 0, check: void 0 } : await checkStatus(`${root}/${entryName}`, app, entryName, {
       expectJs: true,
       expectNoCache: !opts.dev
     });
@@ -1451,7 +1698,7 @@ async function runDoctor(opts) {
         fix: acao ? void 0 : 'nginx \u5BF9 remoteEntry add_header Access-Control-Allow-Origin "*"'
       });
     }
-    const manifestRes = await checkStatus(`${root}/fulgurjs-manifest.json`, app, "fulgurjs-manifest.json", {
+    const manifestRes = opts.noManifest ? { res: void 0, check: void 0 } : await checkStatus(`${root}/fulgurjs-manifest.json`, app, "fulgurjs-manifest.json", {
       expectNoCache: !opts.dev
     });
     if (manifestRes.check) checks.push(manifestRes.check);
@@ -1493,12 +1740,12 @@ async function runDoctor(opts) {
       }
     }
     let htmlBody = "";
-    if (!opts.dev) {
+    if (!opts.dev && !opts.noHtml) {
       const html = await checkStatus(`${root}/index.html`, app, "index.html", { expectNoCache: true });
       if (html.check) checks.push(html.check);
       htmlBody = html.res?.body ?? "";
     }
-    if (opts.dev) {
+    if (opts.dev && !opts.noEntry) {
       const devEntry = await checkStatus(`${root}/@fulgurjs-entry.js`, app, "@fulgurjs-entry.js\uFF08dev \u5BB9\u5668\u5165\u53E3\uFF09", {
         expectJs: true
       });
@@ -1597,6 +1844,9 @@ function formatDoctorReport(checks) {
 // src/cli.ts
 var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
 
+\u5165\u53E3\u9009\u62E9\uFF08\u5E94\u7528\u4EE3\u7801\u5BFC\u5165\uFF09\uFF1AVue \u5E94\u7528 @fulgurjs/federation/vue \uFF5C React \u5E94\u7528 /react \uFF5C
+\u6846\u67B6\u65E0\u5173\u6A21\u5757 /runtime \uFF5C Vite \u914D\u7F6E\u7528\u5305\u6839\uFF08federation(options)\uFF09\u3002
+
 \u65B0\u9879\u76EE\uFF1A\u4ECE\u5B8C\u6574\u6A21\u677F\u521B\u5EFA\u53EF\u72EC\u7ACB\u8FD0\u884C\u7684\u8054\u90A6\u5DE5\u7A0B\uFF08\u590D\u5236\u540E pnpm install + pnpm dev\uFF09\uFF1A
   fulgurjs create [--list]                         \u4EA4\u4E92\u9009\u62E9\u6A21\u677F\uFF08TTY\uFF09
   fulgurjs create <\u6A21\u677F> [--dir <\u8DEF\u5F84>] [--no-install] [--force] [--json]
@@ -1606,28 +1856,42 @@ var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
                                                    \u4FDD\u7559\u4F60\u7684\u7248\u672C\uFF08\u7EDD\u4E0D\u6539\u5199\uFF09\uFF1B--json \u65F6 stdout \u4EC5\u8F93\u51FA\u7ED3\u679C
                                                    JSON\uFF0C\u8FDB\u5EA6\u4E0E\u5B89\u88C5\u65E5\u5FD7\u8D70 stderr
 \u5DF2\u6709\u9879\u76EE\uFF08\u5355\u9879\u76EE fulgurjs.config.ts \u5728\u5E94\u7528\u6839\u76EE\u5F55\uFF1B\u547D\u4EE4\u9ED8\u8BA4\u8BFB ./fulgurjs.config.ts\uFF09\uFF1A
-  fulgurjs init [--template <path>] [--force]      \u751F\u6210\u5355\u9879\u76EE fulgurjs.config.ts \u8D77\u6B65\u6A21\u677F
-                                                   \uFF08\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF1B--template \u662F\u8F93\u51FA\u8DEF\u5F84\uFF09
+  fulgurjs init [--out <\u8DEF\u5F84>] [--framework vue|react] [--role consumer|provider|dual] [--force]
+                                                   \u751F\u6210\u5355\u9879\u76EE fulgurjs.config.ts \u8D77\u6B65\u6A21\u677F\uFF08\u6700\u5C0F\u6709\u6548\u914D\u7F6E\uFF09\uFF1A
+                                                   \u6846\u67B6\u9ED8\u8BA4\u4ECE package.json \u4F9D\u8D56\u5224\u65AD\uFF08\u5224\u65AD\u4E0D\u4E86\u8981\u6C42\u663E\u5F0F --framework\uFF09\uFF1B
+                                                   \u89D2\u8272\u7F3A\u7701 dual\uFF1B--out \u662F\u8F93\u51FA\u8DEF\u5F84\uFF08\u9ED8\u8BA4 ./fulgurjs.config.ts\uFF1B
+                                                   \u65E7 --template \u5199\u6CD5\u4ECD\u63A5\u53D7\uFF0C\u89C1\u8FC1\u79FB\u6307\u5357\uFF09\uFF1B--force \u8986\u76D6\u5DF2\u5B58\u5728\u7684\u6A21\u677F
   fulgurjs init --config <path>                    \u6821\u9A8C\u914D\u7F6E\uFF1B\u8F93\u51FA federation(fulgurjsConfig) \u63A5\u5165\u5757
-                                                 \u4E0E\u63A5\u5165\u6838\u5BF9\u6E05\u5355
+                                                 \u4E0E\u6309\u89D2\u8272\u7684\u63A5\u5165\u6838\u5BF9\u6E05\u5355
   fulgurjs explain [--config <path>] [--json]      \u89E3\u91CA\u672C\u5E94\u7528\u6709\u6548\u8054\u90A6\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE\uFF08\u7EAF\u672C\u5730\uFF0C\u65E0\u7F51\u7EDC\uFF09
   fulgurjs check-pages [--config <path>] [--site <URL>]
                         [--manifest <remote>=<\u8DEF\u5F84|URL>]... [--require-verified] [--json]
-                                                 \u6838\u5BF9\u5BBF\u4E3B\u9875\u9762\u8868\u4E0E\u8FDC\u7A0B exposes\uFF08\u5BBF\u4E3B\u9879\u76EE\u8FD0\u884C\uFF1B
+                                                 \u6838\u5BF9\u5BBF\u4E3B\u9875\u9762\u8868\u4E0E\u8FDC\u7A0B exposes\uFF08\u9010\u9875\u63A5\u5165\u7684\u5BBF\u4E3B\u8FD0\u884C\uFF1B
+                                                 \u672A\u914D\u7F6E hostPages \u65F6\u660E\u786E\u63D0\u793A\u4E0D\u9002\u7528\uFF1B
                                                  manifest \u6765\u6E90\u4F18\u5148\u7EA7 --manifest > --site/prod \u63A8\u5BFC\uFF0C
                                                  \u663E\u5F0F\u6307\u5B9A\u6765\u6E90\u5931\u8D25\u4E0D\u56DE\u9000\uFF1B\u786E\u5B9A\u6027\u9519\u8BEF\u975E\u96F6\u9000\u51FA\uFF1B
                                                  --require-verified \u65F6\u65E0\u6CD5\u9A8C\u8BC1\u4E5F\u975E\u96F6\uFF09
-\u90E8\u7F72\u4F53\u68C0\uFF08--apps \u662F\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF0C\u8FDC\u7A0B\u90E8\u7F72\u5728 /remote-a/ \u5C31\u5199 remote-a\uFF09\uFF1A
-  fulgurjs doctor --base <URL> --apps <a,b,c> [--dev] [--json] [--chunk-sample N]
+\u7AEF\u53E3\u53D8\u66F4\uFF08\u6A21\u677F\u5DE5\u7A0B\uFF1B\u9ED8\u8BA4\u9884\u89C8\uFF0C--write \u624D\u5199\u5165\uFF09\uFF1A
+  fulgurjs port <\u5E94\u7528> <\u65B0\u7AEF\u53E3> [--write]           \u4E00\u6B21\u66F4\u65B0\u56DB\u5904\uFF1A\u5E94\u7528 package.json dev/preview\u3001
+                                                   \u5BBF\u4E3B fulgurjs.config.ts \u8BE5\u8FDC\u7A0B dev \u5730\u5740\u3001
+                                                   scripts/dev.config.json\u3001README \u7AEF\u53E3\u8868
+\u90E8\u7F72\u4F53\u68C0\uFF08--apps \u5FC5\u586B\uFF1A\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF0C\u8FDC\u7A0B\u90E8\u7F72\u5728 /remote-a/ \u5C31\u5199 remote-a\uFF1B
+          '.' \u8868\u793A\u90E8\u7F72\u5728\u7AD9\u70B9\u6839\uFF1B\u6761\u76EE\u53EF\u5199\u5B8C\u6574 URL \u68C0\u67E5\u591A origin\uFF1B\u4E0D\u505A\u4EFB\u4F55\u9ED8\u8BA4\u731C\u6D4B\uFF09\uFF1A
+  fulgurjs doctor --base <URL> --apps <a,b,c> [--entry <\u6587\u4EF6\u540D>] [--no-entry]
+                  [--no-manifest] [--no-html] [--dev] [--json] [--chunk-sample N]
+                                                 \u9ED8\u8BA4\u68C0\u67E5 remoteEntry/manifest/index.html\uFF1B
+                                                 \u7EAF\u5BBF\u4E3B\u7528 --no-entry\uFF0C\u81EA\u5B9A\u4E49\u5165\u53E3\u6587\u4EF6\u540D\u7528 --entry\uFF0C
+                                                 \u5408\u6CD5\u5173\u95ED manifest \u7528 --no-manifest\uFF0C\u65E0\u9875\u9762\u7528 --no-html
   fulgurjs --help
 
 \u793A\u4F8B\uFF1A
   fulgurjs create vue-vue --dir my-federation      # \u521B\u5EFA\u5B8C\u6574\u5DE5\u7A0B\u5E76\u5B89\u88C5\u4F9D\u8D56\uFF08\u63A8\u8350\u7684\u65B0\u9879\u76EE\u8D77\u70B9\uFF09
-  fulgurjs init                                    # \u5DF2\u6709\u9879\u76EE\uFF1A\u5F53\u524D\u76EE\u5F55\u5199 fulgurjs.config.ts\uFF08\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF0C--force \u8986\u76D6\uFF09
+  fulgurjs init --framework react --role consumer  # \u5DF2\u6709 React \u9879\u76EE\u6309\u6D88\u8D39\u65B9\u751F\u6210\u8D77\u6B65\u914D\u7F6E
   fulgurjs explain                                 # \u89E3\u91CA\u672C\u5E94\u7528\uFF08--config \u6307\u5411\u5176\u4ED6\u8DEF\u5F84\u65F6\u663E\u5F0F\u4F20\uFF09
   fulgurjs check-pages --site http://your-site     # \u6309 remotes prod \u5730\u5740\u63A8\u5BFC\u8FDC\u7A0B manifest \u6838\u5BF9
   fulgurjs check-pages --manifest remote-a=https://cdn.example.com/remote-a/fulgurjs-manifest.json
   fulgurjs doctor --base http://your-site --apps my-app,remote-a
+
 `;
 async function main() {
   const argv = process.argv.slice(2);
@@ -1653,7 +1917,7 @@ async function main() {
     return out;
   };
   if (cmd === "init") {
-    const { writeConfigTemplate: writeConfigTemplate2, inspectConfig: inspectConfig2 } = await Promise.resolve().then(() => (init_init(), init_exports));
+    const { writeConfigTemplate: writeConfigTemplate2, inspectConfig: inspectConfig2, detectFrameworkFromPackageJson: detectFrameworkFromPackageJson2 } = await Promise.resolve().then(() => (init_init(), init_exports));
     const configPath = argOf("--config");
     if (configPath) {
       try {
@@ -1664,15 +1928,56 @@ async function main() {
         return 2;
       }
     }
-    const target = resolve(argOf("--template") ?? "fulgurjs.config.ts");
-    const result = await writeConfigTemplate2(target, has("--force"));
+    if (has("--template")) {
+      console.error(
+        "[fulgurjs:init] --template \u5DF2\u66F4\u540D --out\uFF08\u8F93\u51FA\u8DEF\u5F84\uFF09\n\u6839\u56E0\uFF1A--template \u5728 create \u91CC\u6307\u6A21\u677F\u540D\uFF0C\u5728 init \u91CC\u5374\u662F\u8F93\u51FA\u8DEF\u5F84\u2014\u2014\u540C\u540D\u4E0D\u540C\u4E49\uFF086.0.0 \u53C2\u6570\u6536\u655B\uFF09\n\u4FEE\u6CD5\uFF1Afulgurjs init --out <\u8DEF\u5F84>\uFF08\u672C\u8F6E\u4ECD\u63A5\u53D7 --template \u4F46\u6309 --out \u89E3\u91CA\uFF0C\u540E\u7EED\u7248\u672C\u79FB\u9664\uFF09"
+      );
+    }
+    const roleArg = argOf("--role") ?? "dual";
+    if (!["consumer", "provider", "dual"].includes(roleArg)) {
+      console.error(`[fulgurjs:init] \u672A\u77E5\u89D2\u8272\uFF1A${roleArg}\uFF08\u53EF\u9009 consumer=\u7EAF\u6D88\u8D39\u65B9 / provider=\u7EAF\u63D0\u4F9B\u65B9 / dual=\u53CC\u89D2\u8272\uFF09`);
+      return 2;
+    }
+    let framework = argOf("--framework");
+    if (framework && !["vue", "react"].includes(framework)) {
+      console.error(`[fulgurjs:init] \u672A\u77E5\u6846\u67B6\uFF1A${framework}\uFF08\u53EF\u9009 vue / react\uFF09`);
+      return 2;
+    }
+    if (!framework) {
+      try {
+        const pkg = JSON.parse(await import("node:fs").then((m) => m.promises.readFile(resolve("package.json"), "utf8")));
+        framework = detectFrameworkFromPackageJson2(pkg) ?? void 0;
+      } catch {
+      }
+    }
+    if (!framework) {
+      if (process.stdin.isTTY) {
+        const readline = await import("node:readline/promises");
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = (await rl.question("\u65E0\u6CD5\u4ECE package.json \u5224\u65AD\u6846\u67B6\uFF0C\u8BF7\u9009\u62E9\uFF08vue / react\uFF09\uFF1A")).trim();
+        rl.close();
+        if (answer !== "vue" && answer !== "react") {
+          console.error("[fulgurjs:init] \u53EA\u652F\u6301 vue / react\uFF1B\u8BF7\u663E\u5F0F\u91CD\u8DD1 fulgurjs init --framework vue|react");
+          return 2;
+        }
+        framework = answer;
+      } else {
+        console.error(
+          "[fulgurjs:init] \u65E0\u6CD5\u4ECE package.json \u5224\u65AD\u6846\u67B6\uFF08vue/react \u4F9D\u8D56\u7F3A\u5931\u6216\u5E76\u5B58\uFF09\u3002\n  \u4FEE\u6CD5\uFF1A\u663E\u5F0F\u6307\u5B9A fulgurjs init --framework vue|react\uFF08--role consumer|provider|dual \u53EF\u9009\uFF0C\u9ED8\u8BA4 dual\uFF09"
+        );
+        return 2;
+      }
+    }
+    const target = resolve(argOf("--out") ?? argOf("--template") ?? "fulgurjs.config.ts");
+    const result = await writeConfigTemplate2(target, has("--force"), { framework, role: roleArg });
     if (result === "exists") {
       console.error(`[fulgurjs:init] ${target} \u5DF2\u5B58\u5728\uFF0C\u62D2\u7EDD\u8986\u76D6\uFF08--force \u5F3A\u5236\u8986\u76D6\uFF09`);
       return 2;
     }
-    console.log(`[fulgurjs:init] \u5DF2\u751F\u6210\u5355\u9879\u76EE\u8D77\u6B65\u6A21\u677F ${target}
+    const entry = framework === "react" ? "@fulgurjs/federation/react" : "@fulgurjs/federation/vue";
+    console.log(`[fulgurjs:init] \u5DF2\u751F\u6210${framework === "react" ? " React" : " Vue"} ${roleArg === "dual" ? "\u53CC\u89D2\u8272" : roleArg === "consumer" ? "\u7EAF\u6D88\u8D39\u65B9" : "\u7EAF\u63D0\u4F9B\u65B9"}\u8D77\u6B65\u6A21\u677F ${target}
 \u540E\u7EED\u6B65\u9AA4\uFF1A
-  1. \u7F16\u8F91 fulgurjs.config.ts\uFF1A\u586B\u5165\u5BB9\u5668\u540D/exposes/remotes/shared\uFF08\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF09
+  1. \u7F16\u8F91 fulgurjs.config.ts\uFF1A\u586B\u5165\u5BB9\u5668\u540D/${roleArg === "provider" ? "exposes" : roleArg === "consumer" ? "remotes" : "exposes/remotes"}/shared\uFF08\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF09
   2. vite.config.ts \u63A5\u5165\uFF08\u4EC5\u4E24\u884C\u8054\u90A6\u76F8\u5173\u4EE3\u7801\uFF09\uFF1A
        import federation from '@fulgurjs/federation'
        import fulgurjsConfig from './fulgurjs.config'
@@ -1680,8 +1985,10 @@ async function main() {
   3. npx fulgurjs explain   # \u6838\u5BF9\u6709\u6548\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE
   4. \u90E8\u7F72\u540E\uFF1Anpx fulgurjs doctor --base <URL> --apps <\u90E8\u7F72\u5B50\u76EE\u5F55>
      \uFF08--apps \u662F\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF0C\u5982\u8FDC\u7A0B\u90E8\u7F72\u5728 /my-remote/ \u5C31\u5199 my-remote\uFF0C\u4E0D\u662F\u5BB9\u5668\u540D\uFF09
-\u8BF4\u660E\uFF1A\u52A0\u8F7D\u666E\u901A\u7EC4\u4EF6/\u6A21\u5757\u4E0D\u9700\u8981\u9875\u9762\u8868\u3002\u53EA\u6709\u5F53\u5BBF\u4E3B\u7528\u300C\u9875\u9762\u8DEF\u7531\u8868 \u2192 \u8FDC\u7A0B\u9875\u9762\u300D\u65B9\u5F0F\u63A5\u5165\u65F6\uFF0C
-\u624D\u5728 fulgurjs.config.ts \u8FFD\u52A0\u5177\u540D\u5BFC\u51FA hostPages\uFF0C\u5E76\u8FD0\u884C npx fulgurjs check-pages --site <\u7AD9\u70B9> \u6838\u5BF9\u3002`);
+\u5E94\u7528\u4EE3\u7801 API \u5165\u53E3\uFF1A${entry}\uFF08\u6846\u67B6\u65E0\u5173\u6A21\u5757\u7528 /runtime\uFF1B\u8BF4\u660E\u89C1\u6A21\u677F\u5934\u6CE8\u91CA\u4E0E docs \u6587\u6863\u4E2D\u5FC3\uFF09\u3002
+\u8BF4\u660E\uFF1A\u52A0\u8F7D\u666E\u901A\u7EC4\u4EF6/\u6A21\u5757\u4E0D\u9700\u8981\u9875\u9762\u8868\u3002\u53EA\u6709\u5F53\u5BBF\u4E3B\u7528\u300C\u9875\u9762\u8DEF\u7531\u8868 \u2192 \u8FDC\u7A0B\u9875\u9762\u300D\u65B9\u5F0F\u9010\u9875\u63A5\u5165\u65F6\uFF0C
+\u624D\u5728 fulgurjs.config.ts \u8FFD\u52A0\u5177\u540D\u5BFC\u51FA hostPages\uFF0C\u5E76\u8FD0\u884C npx fulgurjs check-pages --site <\u7AD9\u70B9> \u6838\u5BF9\uFF1B
+\u5B8C\u6574\u5B50\u5E94\u7528\u6865\u63A5\u4E0D\u9010\u9875\u767B\u8BB0\u5185\u90E8\u9875\u9762\uFF0C\u4E1A\u52A1\u83DC\u5355\u4E0E Router \u5F52\u5E94\u7528\u81EA\u5DF1\u7BA1\u7406\u3002`);
     return 0;
   }
   if (cmd === "create") {
@@ -1760,22 +2067,66 @@ async function main() {
       return 2;
     }
   }
+  if (cmd === "port") {
+    const app = argv[1] && !argv[1].startsWith("-") ? argv[1] : void 0;
+    const portArg = argv[2] && !argv[2].startsWith("-") ? argv[2] : void 0;
+    if (!app || !portArg || !/^\d+$/.test(portArg)) {
+      console.error("[fulgurjs:port] \u7528\u6CD5\uFF1Afulgurjs port <\u5E94\u7528\u540D> <\u65B0\u7AEF\u53E3> [--write]\uFF08\u9ED8\u8BA4\u53EA\u9884\u89C8\uFF09");
+      return 2;
+    }
+    const { planPortChange: planPortChange2, applyPortChange: applyPortChange2, formatPortPlan: formatPortPlan2 } = await Promise.resolve().then(() => (init_port(), port_exports));
+    try {
+      const plan = planPortChange2(process.cwd(), app, Number(portArg));
+      if (has("--write")) {
+        const written = applyPortChange2(process.cwd(), plan);
+        console.log(`[fulgurjs:port] \u5DF2\u5199\u5165 ${written} \u4E2A\u6587\u4EF6\uFF08${app} ${plan.from} \u2192 ${plan.to}\uFF09\u3002\u56DE\u9000\uFF1Agit checkout <file>`);
+        for (const n of plan.notes) console.log(`  \u6CE8\uFF1A${n}`);
+      } else {
+        console.log(formatPortPlan2(process.cwd(), plan));
+      }
+      return 0;
+    } catch (e) {
+      console.error(String(e.message ?? e));
+      return 2;
+    }
+  }
   if (cmd === "doctor") {
     const base = argOf("--base");
-    const appsRaw = argOf("--apps") ?? "main";
+    const appsRaw = argOf("--apps");
     if (!base) {
       console.error("[fulgurjs:doctor] \u7F3A\u5C11 --base <URL>\uFF08\u7AD9\u70B9\u6839\u5730\u5740\uFF0C\u5982 http://your-site\uFF09");
       return 2;
     }
+    if (!appsRaw) {
+      console.error(
+        '[fulgurjs:doctor] \u7F3A\u5C11 --apps <\u5B50\u76EE\u5F55,...>\u2014\u2014doctor \u4E0D\u731C\u9ED8\u8BA4\u5E94\u7528\u540D\u3002\n  \u4FEE\u6CD5\uFF1A--apps \u4F20\u7AD9\u70B9\u6839\u4E0B\u7684\u90E8\u7F72\u5B50\u76EE\u5F55\uFF08\u8FDC\u7A0B\u90E8\u7F72\u5728 /remote-a/ \u5C31\u5199 remote-a\uFF1B\u90E8\u7F72\u5728\u7AD9\u70B9\u6839\u5199 "."\uFF1B\n  \u591A origin \u76F4\u63A5\u5199\u5B8C\u6574 URL\uFF09\u3002\u7EAF\u5BBF\u4E3B\u52A0 --no-entry\uFF0C\u81EA\u5B9A\u4E49\u5165\u53E3\u6587\u4EF6\u540D\u7528 --entry <\u6587\u4EF6\u540D>'
+      );
+      return 2;
+    }
     const apps = appsRaw.split(",").map((s) => s.trim()).filter(Boolean);
     const { checks, failed } = await runDoctor({
       base,
       apps,
       dev: has("--dev"),
-      chunkSample: argOf("--chunk-sample") ? Number(argOf("--chunk-sample")) : void 0
+      chunkSample: argOf("--chunk-sample") ? Number(argOf("--chunk-sample")) : void 0,
+      ...argOf("--entry") ? { entry: argOf("--entry") } : {},
+      noEntry: has("--no-entry"),
+      noManifest: has("--no-manifest"),
+      noHtml: has("--no-html")
     });
     if (has("--json")) {
-      console.log(JSON.stringify({ base, apps, dev: has("--dev"), checks, failed }, null, 2));
+      console.log(JSON.stringify({
+        base,
+        apps,
+        dev: has("--dev"),
+        mode: {
+          entry: has("--no-entry") ? "(no-entry)" : argOf("--entry") ?? "fulgurjs-remoteEntry.js",
+          manifest: has("--no-manifest") ? "(disabled)" : "fulgurjs-manifest.json",
+          html: has("--no-html") ? "(skipped)" : "index.html"
+        },
+        checks,
+        failed
+      }, null, 2));
     } else {
       console.log(formatDoctorReport(checks));
     }