@fulgurjs/federation 5.8.0 → 5.9.0

package/dist/cli.js

@@ -215,18 +215,18 @@ function validateHostPages(value) {
   }
   return hp;
 }
-function validatePathsInsideApp(options, appRoot, fs3, path2) {
+function validatePathsInsideApp(options, appRoot, fs4, path3) {
   const checkModule = (field, value) => {
     if (typeof value !== "string" || value.trim() === "") return;
-    if (/^(https?:)?\/\//.test(value) || path2.isAbsolute(value)) {
+    if (/^(https?:)?\/\//.test(value) || path3.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 = path2.resolve(appRoot, value);
-    if (!fs3.existsSync(abs)) {
+    const abs = path3.resolve(appRoot, value);
+    if (!fs4.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 fs3 = await import("node:fs");
+  const fs4 = await import("node:fs");
   const os = await import("node:os");
-  const path2 = await import("node:path");
-  const abs = path2.resolve(configPath);
-  if (!fs3.existsSync(abs)) {
+  const path3 = await import("node:path");
+  const abs = path3.resolve(configPath);
+  if (!fs4.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(fs3.readFileSync(abs, "utf8"));
+    const parsed = JSON.parse(fs4.readFileSync(abs, "utf8"));
     if (isAggregateShape(parsed)) aggregateMigrationError();
-    return finishAppShape(parsed, {}, abs, path2.dirname(abs), fs3, path2);
+    return finishAppShape(parsed, {}, abs, path3.dirname(abs), fs4, path3);
   }
-  const rawSource = fs3.readFileSync(abs, "utf8");
+  const rawSource = fs4.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 = fs3.mkdtempSync(path2.join(os.tmpdir(), "fulgurjs-appcfg-"));
+  const tmpDir = fs4.mkdtempSync(path3.join(os.tmpdir(), "fulgurjs-appcfg-"));
   try {
-    const bundleFile = path2.join(tmpDir, "fulgurjs.config.bundle.mjs");
-    fs3.writeFileSync(bundleFile, out.outputFiles[0].text);
+    const bundleFile = path3.join(tmpDir, "fulgurjs.config.bundle.mjs");
+    fs4.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, path2.dirname(abs), fs3, path2);
+    return finishAppShape(mod.default, { hostPages: mod.hostPages }, abs, path3.dirname(abs), fs4, path3);
   } finally {
-    fs3.rmSync(tmpDir, { recursive: true, force: true });
+    fs4.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
-function finishAppShape(def, named, configPath, appRoot, fs3, path2) {
+function finishAppShape(def, named, configPath, appRoot, fs4, path3) {
   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, fs3, path2) {
   }
   const options = def;
   validateAppOptions(options);
-  validatePathsInsideApp(options, appRoot, fs3, path2);
+  validatePathsInsideApp(options, appRoot, fs4, path3);
   const hostPages = named.hostPages !== void 0 ? validateHostPages(named.hostPages) : void 0;
   return {
     kind: "app",
@@ -472,7 +472,7 @@ var init_init = __esm({
 // 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 <\u5BB9\u5668\u540D>   # \u90E8\u7F72\u4F53\u68C0
+//   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 {
@@ -518,12 +518,214 @@ export default {
       "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 <\u5BB9\u5668\u540D...>",
+      "   \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"
     ];
   }
 });
 
+// src/create.ts
+var create_exports = {};
+__export(create_exports, {
+  COPY_EXCLUDED: () => COPY_EXCLUDED,
+  TEMPLATE_CATALOG: () => TEMPLATE_CATALOG,
+  copyTemplate: () => copyTemplate,
+  createProject: () => createProject,
+  defaultInstall: () => defaultInstall,
+  formatCreateResult: () => formatCreateResult,
+  isExcluded: () => isExcluded,
+  nodeVersionWarning: () => nodeVersionWarning,
+  packageRootOf: () => packageRootOf,
+  readDevConfig: () => readDevConfig,
+  resolveTemplatesRoot: () => resolveTemplatesRoot,
+  validateTemplateDir: () => validateTemplateDir
+});
+import fs2 from "node:fs";
+import path2 from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+function packageRootOf(moduleUrl) {
+  return fileURLToPath(new URL("..", moduleUrl));
+}
+function resolveTemplatesRoot(moduleUrl) {
+  const root = path2.join(packageRootOf(moduleUrl), "examples", "templates");
+  if (!fs2.existsSync(root)) {
+    throw new Error(
+      "[fulgurjs:create] \u5F53\u524D\u5B89\u88C5\u7F3A\u5C11\u6A21\u677F\u8D44\u4EA7\uFF08examples/templates\uFF09\u3002\n  \u6839\u56E0\uFF1A\u6A21\u677F\u7531 npm \u6B63\u5F0F\u5305\u9644\u5E26\uFF1B\u4ECE\u4ED3\u5E93\u6E90\u7801\u76F4\u63A5\u8FD0\u884C CLI \u65F6\u8BE5\u76EE\u5F55\u53EA\u5728 build \u540E\u751F\u6210\u3002\n  \u4FEE\u6CD5\uFF1A\u7528 npm \u6B63\u5F0F\u5305\u8FD0\u884C\uFF08npx @fulgurjs/federation create\uFF09\uFF0C\u6216\u5728\u63D2\u4EF6\u4ED3\u5E93\u6267\u884C npm --prefix packages/plugin run build \u540E\u91CD\u8BD5"
+    );
+  }
+  return root;
+}
+function isExcluded(name) {
+  if (COPY_EXCLUDED.has(name)) return true;
+  return name.endsWith(".log");
+}
+function copyTemplate(from, to) {
+  fs2.mkdirSync(to, { recursive: true });
+  for (const entry of fs2.readdirSync(from, { withFileTypes: true })) {
+    if (isExcluded(entry.name)) continue;
+    const src = path2.join(from, entry.name);
+    const dest = path2.join(to, entry.name);
+    if (entry.isDirectory()) copyTemplate(src, dest);
+    else fs2.copyFileSync(src, dest);
+  }
+}
+function validateTemplateDir(dir) {
+  const required = ["package.json", "pnpm-workspace.yaml", "pnpm-lock.yaml", "scripts/dev.mjs", "scripts/dev.config.json"];
+  return required.filter((f) => !fs2.existsSync(path2.join(dir, f)));
+}
+function readDevConfig(templateDir) {
+  const file = path2.join(templateDir, "scripts", "dev.config.json");
+  const parsed = JSON.parse(fs2.readFileSync(file, "utf8"));
+  if (!Array.isArray(parsed.apps) || parsed.apps.length === 0) {
+    throw new Error(`[fulgurjs:create] ${file} \u7F3A\u5C11 apps \u6570\u7EC4`);
+  }
+  for (const app of parsed.apps) {
+    if (typeof app.name !== "string" || typeof app.dir !== "string" || typeof app.port !== "number") {
+      throw new Error(`[fulgurjs:create] ${file} \u7684 apps \u6761\u76EE\u9700\u8981 name/dir/port \u4E09\u4E2A\u5B57\u6BB5`);
+    }
+  }
+  return parsed;
+}
+function pluginVersionOf(templateDir, apps) {
+  for (const app of apps) {
+    try {
+      const pkg = JSON.parse(fs2.readFileSync(path2.join(templateDir, app.dir, "package.json"), "utf8"));
+      const version = pkg.dependencies?.["@fulgurjs/federation"];
+      if (version) return version;
+    } catch {
+    }
+  }
+  return "\uFF08\u672A\u5728\u5B50\u5E94\u7528\u58F0\u660E\u4E2D\u627E\u5230 @fulgurjs/federation\uFF09";
+}
+function formatCreateResult(result) {
+  const apps = result.apps;
+  const lines = [];
+  lines.push(`[fulgurjs:create] \u5DF2\u521B\u5EFA\u5B8C\u6574\u5DE5\u7A0B ${result.target}\uFF08\u6A21\u677F ${result.template}\uFF0C\u63D2\u4EF6\u4F9D\u8D56 ${result.pluginVersion}\uFF09`);
+  lines.push("\u540E\u7EED\u6B65\u9AA4\uFF1A");
+  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"}`);
+  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\uFF1A\u6539 <\u8FDC\u7A0B|\u5BBF\u4E3B>/package.json \u7684 dev/preview \u7AEF\u53E3\uFF0C\u5E76\u540C\u6B65\u5BBF\u4E3B fulgurjs.config.ts \u7684 remotes dev \u5730\u5740");
+  return lines.join("\n");
+}
+function formatCreateJson(result) {
+  return JSON.stringify(
+    {
+      template: result.template,
+      target: result.target,
+      pluginVersion: result.pluginVersion,
+      apps: result.apps,
+      installRan: result.installRan,
+      ...result.installCode !== void 0 ? { installCode: result.installCode } : {},
+      next: {
+        cd: result.target,
+        dev: "pnpm dev",
+        build: "pnpm build"
+      }
+    },
+    null,
+    2
+  );
+}
+function nodeVersionWarning(nodeVersion) {
+  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`;
+  }
+  return void 0;
+}
+async function createProject(opts, io) {
+  const templateName = opts.template ?? await io.prompt("\u9009\u62E9\u6A21\u677F\uFF08" + TEMPLATE_CATALOG.map((t) => t.name).join(" / ") + "\uFF09\uFF1A");
+  const info = TEMPLATE_CATALOG.find((t) => t.name === templateName);
+  if (!info) {
+    throw new Error(
+      `[fulgurjs:create] \u672A\u77E5\u6A21\u677F\uFF1A${templateName}
+\u53EF\u7528\u6A21\u677F\uFF1A${TEMPLATE_CATALOG.map((t) => t.name).join("\u3001")}
+\u4FEE\u6CD5\uFF1Afulgurjs create --list \u67E5\u770B\u8BF4\u660E\uFF0C\u6216 fulgurjs create <\u6A21\u677F\u540D> --dir <\u76EE\u6807\u76EE\u5F55>`
+    );
+  }
+  const templateDir = path2.join(opts.templatesRoot, templateName);
+  if (!fs2.existsSync(path2.join(templateDir, "package.json"))) {
+    throw new Error(`[fulgurjs:create] \u5305\u5185\u6A21\u677F\u4E0D\u5B8C\u6574\uFF1A${templateDir} \u7F3A\u5C11 package.json`);
+  }
+  const target = path2.resolve(opts.cwd, opts.dir ?? templateName);
+  if (fs2.existsSync(target)) {
+    const existing = fs2.readdirSync(target);
+    if (existing.length > 0 && !opts.force) {
+      throw new Error(
+        `[fulgurjs:create] \u76EE\u6807\u76EE\u5F55\u975E\u7A7A\uFF0C\u62D2\u7EDD\u8986\u76D6\uFF1A${target}
+  \u6839\u56E0\uFF1A\u9759\u9ED8\u5408\u5E76\u53EF\u80FD\u63A9\u76D6\u4E0E\u4F60\u5DF2\u6709\u6587\u4EF6\u7684\u51B2\u7A81\u3002
+  \u4FEE\u6CD5\uFF1A\u6362\u4E00\u4E2A\u76EE\u5F55\uFF08--dir\uFF09\uFF0C\u6216\u786E\u8BA4\u540E\u52A0 --force\uFF08\u53EA\u65B0\u589E\u6A21\u677F\u6587\u4EF6\uFF0C\u4E0D\u5220\u9664/\u6539\u5199\u4F60\u5DF2\u6709\u7684\u6587\u4EF6\uFF09`
+      );
+    }
+    if (existing.length > 0) {
+      io.log(`[fulgurjs:create] --force\uFF1A\u5411\u975E\u7A7A\u76EE\u5F55 ${target} \u589E\u91CF\u590D\u5236\uFF08\u4E0D\u5220\u9664\u5DF2\u6709\u6587\u4EF6\uFF09`);
+    }
+  }
+  const warnings = [];
+  const nodeWarn = nodeVersionWarning(process.version);
+  if (nodeWarn) warnings.push(nodeWarn);
+  copyTemplate(templateDir, target);
+  const missing = validateTemplateDir(target);
+  if (missing.length > 0) {
+    throw new Error(`[fulgurjs:create] \u590D\u5236\u540E\u7684\u6A21\u677F\u7F3A\u5C11\u5173\u952E\u6587\u4EF6\uFF1A${missing.join("\u3001")}\u2014\u2014\u5305\u5185\u6A21\u677F\u8D44\u4EA7\u4E0D\u5B8C\u6574\uFF0C\u8BF7\u53CD\u9988\u7248\u672C\u53F7`);
+  }
+  const apps = readDevConfig(target).apps;
+  const pluginVersion = pluginVersionOf(target, apps);
+  let installRan = false;
+  let installCode;
+  if (opts.install) {
+    installRan = true;
+    io.log(`[fulgurjs:create] \u5B89\u88C5\u4F9D\u8D56\uFF08pnpm install --frozen-lockfile\uFF0C\u76EE\u5F55 ${target}\uFF09\u2026`);
+    installCode = await io.install(target);
+    if (installCode !== 0) {
+      throw new Error(
+        `[fulgurjs:create] \u4F9D\u8D56\u5B89\u88C5\u5931\u8D25\uFF08\u9000\u51FA\u7801 ${installCode}\uFF09\u3002\u4E0A\u9762\u7684\u8F93\u51FA\u5305\u542B\u5177\u4F53\u539F\u56E0\uFF1B\u5E38\u89C1\u539F\u56E0\uFF1Apnpm \u672A\u5B89\u88C5\uFF08corepack enable \u6216 npm i -g pnpm\uFF09\u3001registry \u4E0D\u53EF\u8FBE\u3001Node \u7248\u672C\u8FC7\u4F4E\u3002
+\u4F9D\u8D56\u672A\u88AB\u5047\u88C5\u6210\u529F\uFF1A\u4FEE\u590D\u540E\u8FDB\u5165 ${target} \u624B\u52A8\u6267\u884C pnpm install --frozen-lockfile \u518D pnpm dev`
+      );
+    }
+  } 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, pluginVersion, apps, installRan, installCode };
+  io.log(opts.json ? formatCreateJson(result) : formatCreateResult(result));
+  return result;
+}
+function defaultInstall(cwd) {
+  return new Promise((resolve2) => {
+    const child = spawn("pnpm", ["install", "--frozen-lockfile"], { cwd, stdio: "inherit" });
+    child.once("error", (e) => {
+      console.error(`[fulgurjs:create] \u65E0\u6CD5\u542F\u52A8 pnpm\uFF1A${e.message}\uFF08corepack enable \u6216 npm i -g pnpm\uFF09`);
+      resolve2(1);
+    });
+    child.once("close", (code) => resolve2(code ?? 1));
+  });
+}
+var TEMPLATE_CATALOG, COPY_EXCLUDED;
+var init_create = __esm({
+  "src/create.ts"() {
+    "use strict";
+    TEMPLATE_CATALOG = [
+      { name: "vue-vue", summary: "Vue \u5BBF\u4E3B \xD7 Vue \u8FDC\u7A0B\uFF1A\u8FDC\u7A0B\u7EC4\u4EF6/TS \u6A21\u5757/\u9875\u9762\u63A5\u5165\u3001\u9519\u8BEF\u6062\u590D\u3001\u751F\u4EA7\u90E8\u7F72" },
+      { name: "react-react", summary: "React \u5BBF\u4E3B \xD7 React \u8FDC\u7A0B\uFF1AremoteComponent/useLoadRemote/ErrorBoundary" },
+      { name: "vue-host-react-remote", summary: "Vue \u5BBF\u4E3B \xD7 React \u5B50\u5E94\u7528\uFF1A\u8DE8\u6846\u67B6\u6865\u63A5\uFF08\u6302\u8F7D/\u5378\u8F7D/appProps \u5FEB\u7167\uFF09" },
+      { name: "react-host-vue-remote", summary: "React \u5BBF\u4E3B \xD7 Vue \u5B50\u5E94\u7528\uFF1A\u53CD\u65B9\u5411\u6865\u63A5" },
+      { name: "showcase", summary: "\u53CC\u5411\u6865\u63A5 + URL \u540C\u6B65 showcase\uFF1AVue/React \u53CC\u5BBF\u4E3B \xD7 \u53CC\u8FDC\u7A0B\uFF0C\u6DF1\u94FE\u5237\u65B0/\u524D\u8FDB\u540E\u9000" }
+    ];
+    COPY_EXCLUDED = /* @__PURE__ */ new Set(["node_modules", "dist", ".vite", ".run", ".DS_Store"]);
+  }
+});
+
 // src/pages.ts
 function defaultDeriveSpec(route) {
   return segs(route).slice(1).filter((seg) => !seg.startsWith(":")).join("/");
@@ -646,6 +848,7 @@ var init_pages = __esm({
 // src/commands.ts
 var commands_exports = {};
 __export(commands_exports, {
+  bridgeWarningsOf: () => bridgeWarningsOf,
   checkPages: () => checkPages,
   explainApp: () => explainApp,
   formatCheckPages: () => formatCheckPages,
@@ -653,7 +856,7 @@ __export(commands_exports, {
   manifestUrlForRemoteAddress: () => manifestUrlForRemoteAddress,
   stripRemoteNamePrefix: () => stripRemoteNamePrefix
 });
-import fs2 from "node:fs";
+import fs3 from "node:fs";
 function mappingsOf(hp, deriveFallback) {
   const pages = hp.pages ?? [];
   const prefixes = Object.entries(hp.remotePrefixes ?? {}).sort((a, b) => b[0].length - a[0].length);
@@ -705,6 +908,50 @@ function chainLines(options, role) {
   }
   return chain;
 }
+function bridgeWarningsOf(options) {
+  const warns = [];
+  const rawShared = options.shared;
+  const shared = rawShared && !Array.isArray(rawShared) ? rawShared : {};
+  const hintOf = (name) => {
+    const v = shared[name];
+    if (v === void 0) return void 0;
+    if (typeof v === "string") return { singleton: false };
+    return v;
+  };
+  const isSingleton = (name) => hintOf(name)?.singleton === true;
+  const exposeKeys = Object.keys(options.exposes ?? {}).map((k) => k.replace(/^\.\//, ""));
+  const hasVue = hintOf("vue") !== void 0;
+  const hasReact = hintOf("react") !== void 0;
+  if (exposeKeys.includes("bridge")) {
+    if (hasVue && !hasReact && !isSingleton("vue")) {
+      warns.push(
+        "WARN \u6865\u63A5\u5B50\u5E94\u7528 shared.vue \u7F3A\u5C11 singleton: true\u2014\u2014\u5BBF\u4E3B\u4E0E\u5B50\u5E94\u7528\u4F1A\u5404\u6301\u4E00\u4EFD Vue \u5B9E\u4F8B\uFF08\u75C7\u72B6\uFF1Aprovide/inject \u5931\u6548\u3001\u72B6\u6001\u4E0D\u4E92\u901A\uFF09\u3002\n  \u4FEE\u6CD5: fulgurjs.config.ts \u7684 shared \u6539\u4E3A vue: { singleton: true }"
+      );
+    }
+    if (hasReact && !hasVue && (!isSingleton("react") || !isSingleton("react-dom"))) {
+      warns.push(
+        `WARN \u6865\u63A5\u5B50\u5E94\u7528 React \u4FA7\u9700 react \u4E0E react-dom \u53CC singleton\uFF08\u5F53\u524D react=${String(isSingleton("react"))}\uFF0Creact-dom=${hintOf("react-dom") === void 0 ? "\u672A\u5171\u4EAB" : String(isSingleton("react-dom"))}\uFF09\u2014\u2014\u7F3A\u4E00\u4F1A\u51FA\u73B0\u4E24\u5957 React/renderer\uFF08\u75C7\u72B6\uFF1AInvalid hook call\uFF09\u3002
+  \u4FEE\u6CD5: shared \u52A0 react: { singleton: true }, 'react-dom': { singleton: true }`
+      );
+    }
+    if (!hasVue && !hasReact) {
+      warns.push(
+        "WARN exposes \u542B ./bridge\uFF08\u6865\u63A5\u5B50\u5E94\u7528\u5951\u7EA6\uFF09\u4F46 shared \u672A\u58F0\u660E\u4EFB\u4F55\u6846\u67B6\u2014\u2014\u5BBF\u4E3B\u65E0\u6CD5\u4E0E\u5B50\u5E94\u7528\u6536\u655B\u5230\u540C\u4E00\u6846\u67B6\u5B9E\u4F8B\u3002\n  \u4FEE\u6CD5: \u5728 shared \u58F0\u660E\u672C\u5E94\u7528\u6846\u67B6\uFF08Vue \u5B50\u5E94\u7528\uFF1Avue\uFF1BReact \u5B50\u5E94\u7528\uFF1Areact + react-dom\uFF09\uFF0C\u5168\u90E8 singleton: true"
+      );
+    }
+  }
+  if (hasVue && hasReact) {
+    const missing = ["vue", "react", "react-dom"].filter((k) => hintOf(k) !== void 0 && !isSingleton(k));
+    const absent = ["vue", "react", "react-dom"].filter((k) => hintOf(k) === void 0);
+    if (missing.length > 0 || absent.length > 0) {
+      warns.push(
+        `WARN \u8DE8\u6846\u67B6\u6865\u63A5\u5BBF\u4E3B\u9700 vue\u3001react\u3001react-dom \u4E09\u952E\u5168\u90E8 singleton: true\uFF08\u672A singleton\uFF1A${missing.join("\u3001") || "\u65E0"}\uFF1B\u672A\u5171\u4EAB\uFF1A${absent.join("\u3001") || "\u65E0"}\uFF09\u2014\u2014\u7F3A\u4E00\u4F1A\u5BFC\u81F4\u8DE8\u6846\u67B6\u6302\u8F7D\u65F6\u51FA\u73B0\u53CC\u5B9E\u4F8B\u6216\u534F\u5546\u9519\u4E71\u3002
+  \u4FEE\u6CD5: shared \u58F0\u660E\u4E09\u952E\u5E76\u5404\u914D singleton: true\uFF08\u53C2\u89C1 API \u624B\u518C \xA78.2 \u53CC\u6846\u67B6\u5B89\u88C5\u5408\u540C\uFF09`
+      );
+    }
+  }
+  return warns;
+}
 function explainAppMode(loaded) {
   const options = loaded.options;
   const role = roleOfOptions(options);
@@ -722,6 +969,7 @@ function explainAppMode(loaded) {
     devSharedSelf: { value: devSharedSelfValue, source: devSharedSelfExplicit ? "explicit" : "inferred" },
     pages: hp ? mappingsOf(hp, DEFAULT_DERIVE) : [],
     pagesSource: hp ? `fulgurjs.config.ts \u7684 hostPages \u5177\u540D\u5BFC\u51FA\uFF08${hp.pages.length} \u6761\uFF1B\u8FD0\u884C\u65F6\u771F\u6E90\u4E3A\u5E94\u7528\u5185\u540C\u4E00\u6570\u636E\u6A21\u5757\uFF09` : "\u672A\u627E\u5230 hostPages \u5177\u540D\u5BFC\u51FA\uFF08\u7EAF\u8FDC\u7A0B\u5E94\u7528\u65E0\u9700\u9875\u9762\u8868\uFF1B\u5BBF\u4E3B\u82E5\u8981\u8DD1 check-pages \u8BF7\u5728 fulgurjs.config.ts \u8865\u5177\u540D\u5BFC\u51FA hostPages\uFF09",
+    bridgeWarnings: bridgeWarningsOf(options),
     chain: chainLines(options, role)
   };
 }
@@ -747,6 +995,10 @@ function formatExplain(r) {
     }
   }
   L.push(`devSharedSelf\uFF1A${r.devSharedSelf.value}\uFF08\u6765\u6E90\uFF1A${r.devSharedSelf.source === "explicit" ? "\u663E\u5F0F\u914D\u7F6E" : "\u6309\u89D2\u8272\u63A8\u65AD\u2014\u2014\u63D0\u4F9B exposes/setup \u7684\u5E94\u7528\u4E3A true\uFF0C\u7EAF\u5BBF\u4E3B\u4E3A false"}\uFF09`);
+  if (r.bridgeWarnings?.length) {
+    L.push("\u6865\u63A5\u5B8C\u5907\u6027\uFF1A");
+    for (const w of r.bridgeWarnings) L.push(`  ${w.replaceAll("\n", "\n  ")}`);
+  }
   if (r.pages.length) {
     L.push(`\u9875\u9762 spec \u6620\u5C04\uFF08${r.pages.length}\uFF09\u2014\u2014\u6765\u6E90\uFF1A${r.pagesSource}\uFF1A`);
     for (const p of r.pages) L.push(`  ${p.route} \u2192 ${p.spec}${p.title ? `\uFF08${p.title}\uFF09` : ""}`);
@@ -759,7 +1011,7 @@ function formatExplain(r) {
 }
 function manifestFromFile(p) {
   try {
-    const parsed = parseManifest(JSON.parse(fs2.readFileSync(p, "utf8")));
+    const parsed = parseManifest(JSON.parse(fs3.readFileSync(p, "utf8")));
     if (parsed.manifest && !parsed.unsupportedVersion) return parsed.manifest;
   } catch {
   }
@@ -1236,9 +1488,14 @@ function formatDoctorReport(checks) {
 // src/cli.ts
 var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
 
-\u7528\u6CD5\uFF08\u5355\u9879\u76EE fulgurjs.config.ts \u5728\u5E94\u7528\u6839\u76EE\u5F55\uFF1B\u547D\u4EE4\u9ED8\u8BA4\u8BFB ./fulgurjs.config.ts\uFF09\uFF1A
+\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]
+                                                   \u975E\u4EA4\u4E92\u521B\u5EFA\uFF1B\u6A21\u677F\uFF1Avue-vue / react-react /
+                                                   vue-host-react-remote / react-host-vue-remote / showcase
+\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\uFF09
+                                                   \uFF08\u9ED8\u8BA4\u5BFC\u51FA\u76F4\u63A5\u662F federation() \u9009\u9879\uFF1B--template \u662F\u8F93\u51FA\u8DEF\u5F84\uFF09
   fulgurjs init --config <path>                    \u6821\u9A8C\u914D\u7F6E\uFF1B\u8F93\u51FA federation(fulgurjsConfig) \u63A5\u5165\u5757
                                                  \u4E0E\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
@@ -1248,11 +1505,13 @@ var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
                                                  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]
   fulgurjs --help
 
-\u793A\u4F8B\uFF08\u5E94\u7528\u6839\u76EE\u5F55\u5185\u8FD0\u884C\uFF09\uFF1A
-  fulgurjs init                                    # \u5F53\u524D\u76EE\u5F55\u5199 fulgurjs.config.ts\uFF08\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF0C--force \u8986\u76D6\uFF09
+\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 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
@@ -1307,11 +1566,50 @@ async function main() {
        import fulgurjsConfig from './fulgurjs.config'
        // plugins: [ ...\u539F\u6709\u63D2\u4EF6, federation(fulgurjsConfig) ]
   3. npx fulgurjs explain   # \u6838\u5BF9\u6709\u6548\u5F62\u6001\u4E0E\u52A0\u8F7D\u94FE
-  4. \u5BBF\u4E3B\u5E94\u7528\u53E6\u5728 fulgurjs.config.ts \u5177\u540D\u5BFC\u51FA hostPages\uFF08\u4E0E\u8FD0\u884C\u65F6\u9875\u9762\u6570\u636E\u6A21\u5757\u540C\u6E90\uFF09\uFF0C
-     \u8FD0\u884C npx fulgurjs check-pages --site <\u7AD9\u70B9> \u6838\u5BF9\u9875\u9762\u5951\u7EA6
-  5. \u90E8\u7F72\u540E\uFF1Anpx fulgurjs doctor --base <URL> --apps <\u5BB9\u5668\u540D>`);
+  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`);
     return 0;
   }
+  if (cmd === "create") {
+    if (has("--list")) {
+      const { TEMPLATE_CATALOG: TEMPLATE_CATALOG2 } = await Promise.resolve().then(() => (init_create(), create_exports));
+      for (const t of TEMPLATE_CATALOG2) console.log(`${t.name.padEnd(24)} ${t.summary}`);
+      return 0;
+    }
+    const { createProject: createProject2, resolveTemplatesRoot: resolveTemplatesRoot2, defaultInstall: defaultInstall2 } = await Promise.resolve().then(() => (init_create(), create_exports));
+    let promptImpl;
+    if (process.stdin.isTTY) {
+      const readline = await import("node:readline/promises");
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      promptImpl = (q) => rl.question(q);
+    } else {
+      promptImpl = async () => {
+        throw new Error(
+          "[fulgurjs:create] \u5F53\u524D\u4E0D\u662F\u4EA4\u4E92\u7EC8\u7AEF\uFF0C\u7F3A\u5C11\u6A21\u677F\u53C2\u6570\u3002\n  \u4FEE\u6CD5\uFF1A\u663E\u5F0F\u4F20\u6A21\u677F\u4E0E\u76EE\u5F55\uFF0C\u4F8B\u5982 fulgurjs create vue-vue --dir my-federation\uFF08--no-install \u53EF\u8DF3\u8FC7\u5B89\u88C5\uFF09"
+        );
+      };
+    }
+    try {
+      await createProject2(
+        {
+          template: argv[1] && !argv[1].startsWith("-") ? argv[1] : void 0,
+          dir: argOf("--dir"),
+          install: !has("--no-install"),
+          force: has("--force"),
+          json: has("--json"),
+          templatesRoot: resolveTemplatesRoot2(import.meta.url),
+          cwd: process.cwd()
+        },
+        { log: (m) => console.log(m), error: (m) => console.error(m), prompt: promptImpl, install: defaultInstall2 }
+      );
+      return 0;
+    } catch (e) {
+      console.error(String(e.message ?? e));
+      return 2;
+    }
+  }
   if (cmd === "explain" || cmd === "check-pages") {
     if (has("--app")) {
       console.error(