@fulgurjs/federation 0.4.2

package/dist/config.cjs

@@ -0,0 +1,114 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  defineFulgurConfig: () => defineFulgurConfig,
+  loadFulgurConfig: () => loadFulgurConfig
+});
+module.exports = __toCommonJS(config_exports);
+var import_meta = {};
+function defineFulgurConfig(config) {
+  return config;
+}
+async function loadFulgurConfig(configPath) {
+  const { pathToFileURL, fileURLToPath } = await import("url");
+  const { createRequire } = await import("module");
+  const fs = await import("fs");
+  const os = await import("os");
+  const path = await import("path");
+  const selfDir = path.dirname(fileURLToPath(import_meta.url));
+  const selfConfigJs = path.join(selfDir, "config.js");
+  const SELF_SPEC = fs.existsSync(selfConfigJs) ? pathToFileURL(selfConfigJs).href : "@fulgur-federation-config-unavailable";
+  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgur\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
+  const importConfigs = async (cacheKey) => {
+    return await import(`${cacheKey}?t=${Date.now()}`);
+  };
+  let mod;
+  if (configPath.endsWith(".json")) {
+    mod = { default: JSON.parse(fs.readFileSync(configPath, "utf8")) };
+  } else {
+    const source = rewriteSelfImports(fs.readFileSync(configPath, "utf8"));
+    const tmpBase = path.join(os.tmpdir(), `fulgur-config-${Date.now()}`);
+    if (/\.(ts|mts|cts)$/.test(configPath)) {
+      try {
+        const tmpTs = `${tmpBase}.ts`;
+        fs.writeFileSync(tmpTs, source);
+        mod = await importConfigs(pathToFileURL(tmpTs).href);
+      } catch (e) {
+        if (!/Unexpected|SyntaxError|ERR_UNSUPPORTED_NODE_MODULES|ERR_UNKNOWN_FILE_EXTENSION|ERR_IMPORT_ATTRIBUTE/.test(String(e)) && process.version.startsWith("v2")) {
+          throw e;
+        }
+        const requireFromConfig = createRequire(configPath);
+        let esbuild;
+        try {
+          esbuild = requireFromConfig("esbuild");
+        } catch {
+          const requireFromSelf = createRequire(import_meta.url);
+          esbuild = requireFromSelf("esbuild");
+        }
+        const out = esbuild.buildSync({ entryPoints: [configPath], bundle: false, write: false, format: "esm", target: "node18" });
+        const jsFile = `${tmpBase}.mjs`;
+        fs.writeFileSync(jsFile, rewriteSelfImports(out.outputFiles[0].text));
+        mod = await importConfigs(pathToFileURL(jsFile).href);
+      }
+    } else {
+      const jsFile = `${tmpBase}.mjs`;
+      fs.writeFileSync(jsFile, source);
+      mod = await importConfigs(pathToFileURL(jsFile).href);
+    }
+  }
+  const cfg = mod.default;
+  if (!cfg?.root) {
+    throw new Error(
+      `[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 root\uFF08\u5DE5\u7A0B\u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF09
+\u6839\u56E0\uFF1ACLI \u9700\u8981\u77E5\u9053\u5728\u54EA\u4E2A\u5DE5\u7A0B\u4E0A\u505A\u96C6\u6210
+\u4FEE\u6CD5\uFF1Afulgur.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgur init\uFF09`
+    );
+  }
+  if (!Array.isArray(cfg.apps) || cfg.apps.length === 0) {
+    throw new Error("[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 apps\uFF08\u81F3\u5C11\u4E00\u4E2A\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u5E94\u7528\uFF09");
+  }
+  for (const app of cfg.apps) {
+    if (!app.host && !app.remote) {
+      throw new Error(
+        `[fulgur:init] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
+\u6839\u56E0\uFF1A\u5E94\u7528\u5FC5\u987B\u81F3\u5C11\u58F0\u660E\u4E00\u4E2A\u89D2\u8272
+\u4FEE\u6CD5\uFF1A\u5BBF\u4E3B\u8865 host: { pages, remotePrefixes, remotes }\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
+      );
+    }
+  }
+  return cfg;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineFulgurConfig,
+  loadFulgurConfig
+});

package/dist/config.d.cts

@@ -0,0 +1,79 @@
+/**
+ * W1 fulgur.config.ts：单配置文件驱动的 schema + 加载器（项目无关，决策见排期文档 §4：
+ * 主包内置 bin + 单配置文件驱动，可入库可复跑）。
+ * init 只消费该配置生成通用样板（见 init.ts）；插件运行时（federation()）不读取本文件。
+ */
+interface FulgurPageEntry {
+    /** 宿主路由路径（参数段用 :xx） */
+    route: string;
+    /** 路由 name（命名跳转依赖） */
+    name?: string;
+    /** 远程 exposes 键（显式覆盖默认推导 pages/<去前缀去参数段>） */
+    spec?: string;
+    /** 页签标题 */
+    title?: string;
+}
+interface FulgurRemoteAddress {
+    dev: string;
+    prod: string;
+}
+interface FulgurHostConfig {
+    /** 页面路由表 */
+    pages: FulgurPageEntry[];
+    /** 路由前缀 → 远程名 */
+    remotePrefixes: Record<string, string>;
+    /** 消费的远程地址（键 = import 前缀；裸 URL，对象形式不支持 name@ 前缀） */
+    remotes: Record<string, FulgurRemoteAddress>;
+}
+interface FulgurRemoteConfig {
+    /** exposes：./键 → 源文件（独立页） */
+    exposes: Record<string, string>;
+    /** 反向消费的远程（双向联邦时；dev 下自身源码参与协商需 devSharedSelf: true） */
+    remotes?: Record<string, FulgurRemoteAddress>;
+}
+interface FulgurAppConfig {
+    /** 相对 root 的应用目录 */
+    path: string;
+    /** 联邦容器名 */
+    name: string;
+    /** dev 端口 */
+    port: number;
+    /** 部署/dev 的 URL 前缀，如 /main */
+    base: string;
+    /** 部署目录名（缺省取 base 去斜杠） */
+    deployDir?: string;
+    /** 宿主角色 */
+    host?: FulgurHostConfig;
+    /** 远程角色 */
+    remote?: FulgurRemoteConfig;
+    /** 该应用的 shared 表（缺省建议 vue/vue-router/pinia singleton，见 init 输出的样板） */
+    shared?: Record<string, {
+        singleton?: boolean;
+        requiredVersion?: string;
+    }>;
+}
+interface FulgurDeployConfig {
+    /** NGINX 站点根（样板输出用，可选） */
+    webRoot?: string;
+    /** 监听端口（样板输出用，可选） */
+    listen?: number;
+}
+interface FulgurRepoConfig {
+    /** 工程根（monorepo 根或单应用仓库根） */
+    root: string;
+    apps: FulgurAppConfig[];
+    deploy?: FulgurDeployConfig;
+}
+type FulgurUserConfig = Partial<FulgurRepoConfig>;
+/** 用户配置文件入口：仅做类型收窄（identity），不引入运行时逻辑 */
+declare function defineFulgurConfig(config: FulgurUserConfig): FulgurUserConfig;
+/**
+ * 加载 fulgur.config.ts（或 .js/.json）。
+ * - 配置内的 `@fulgurjs/federation/config` 导入被重写为本包 dist/config.js 绝对路径——
+ *   init 之前工程依赖尚未安装（鸡生蛋），重写后零依赖可加载；
+ * - TS 走 Node 原生类型剥离（Node ≥23.6 默认开启；配置文件须用可擦除语法——纯对象无 enum/namespace）；
+ *   老版本 Node 回退 esbuild 转译（先试配置工程，再试 CLI 自带依赖树）。
+ */
+declare function loadFulgurConfig(configPath: string): Promise<FulgurRepoConfig>;
+
+export { type FulgurAppConfig, type FulgurDeployConfig, type FulgurHostConfig, type FulgurPageEntry, type FulgurRemoteAddress, type FulgurRemoteConfig, type FulgurRepoConfig, type FulgurUserConfig, defineFulgurConfig, loadFulgurConfig };

package/dist/config.d.ts

@@ -0,0 +1,79 @@
+/**
+ * W1 fulgur.config.ts：单配置文件驱动的 schema + 加载器（项目无关，决策见排期文档 §4：
+ * 主包内置 bin + 单配置文件驱动，可入库可复跑）。
+ * init 只消费该配置生成通用样板（见 init.ts）；插件运行时（federation()）不读取本文件。
+ */
+interface FulgurPageEntry {
+    /** 宿主路由路径（参数段用 :xx） */
+    route: string;
+    /** 路由 name（命名跳转依赖） */
+    name?: string;
+    /** 远程 exposes 键（显式覆盖默认推导 pages/<去前缀去参数段>） */
+    spec?: string;
+    /** 页签标题 */
+    title?: string;
+}
+interface FulgurRemoteAddress {
+    dev: string;
+    prod: string;
+}
+interface FulgurHostConfig {
+    /** 页面路由表 */
+    pages: FulgurPageEntry[];
+    /** 路由前缀 → 远程名 */
+    remotePrefixes: Record<string, string>;
+    /** 消费的远程地址（键 = import 前缀；裸 URL，对象形式不支持 name@ 前缀） */
+    remotes: Record<string, FulgurRemoteAddress>;
+}
+interface FulgurRemoteConfig {
+    /** exposes：./键 → 源文件（独立页） */
+    exposes: Record<string, string>;
+    /** 反向消费的远程（双向联邦时；dev 下自身源码参与协商需 devSharedSelf: true） */
+    remotes?: Record<string, FulgurRemoteAddress>;
+}
+interface FulgurAppConfig {
+    /** 相对 root 的应用目录 */
+    path: string;
+    /** 联邦容器名 */
+    name: string;
+    /** dev 端口 */
+    port: number;
+    /** 部署/dev 的 URL 前缀，如 /main */
+    base: string;
+    /** 部署目录名（缺省取 base 去斜杠） */
+    deployDir?: string;
+    /** 宿主角色 */
+    host?: FulgurHostConfig;
+    /** 远程角色 */
+    remote?: FulgurRemoteConfig;
+    /** 该应用的 shared 表（缺省建议 vue/vue-router/pinia singleton，见 init 输出的样板） */
+    shared?: Record<string, {
+        singleton?: boolean;
+        requiredVersion?: string;
+    }>;
+}
+interface FulgurDeployConfig {
+    /** NGINX 站点根（样板输出用，可选） */
+    webRoot?: string;
+    /** 监听端口（样板输出用，可选） */
+    listen?: number;
+}
+interface FulgurRepoConfig {
+    /** 工程根（monorepo 根或单应用仓库根） */
+    root: string;
+    apps: FulgurAppConfig[];
+    deploy?: FulgurDeployConfig;
+}
+type FulgurUserConfig = Partial<FulgurRepoConfig>;
+/** 用户配置文件入口：仅做类型收窄（identity），不引入运行时逻辑 */
+declare function defineFulgurConfig(config: FulgurUserConfig): FulgurUserConfig;
+/**
+ * 加载 fulgur.config.ts（或 .js/.json）。
+ * - 配置内的 `@fulgurjs/federation/config` 导入被重写为本包 dist/config.js 绝对路径——
+ *   init 之前工程依赖尚未安装（鸡生蛋），重写后零依赖可加载；
+ * - TS 走 Node 原生类型剥离（Node ≥23.6 默认开启；配置文件须用可擦除语法——纯对象无 enum/namespace）；
+ *   老版本 Node 回退 esbuild 转译（先试配置工程，再试 CLI 自带依赖树）。
+ */
+declare function loadFulgurConfig(configPath: string): Promise<FulgurRepoConfig>;
+
+export { type FulgurAppConfig, type FulgurDeployConfig, type FulgurHostConfig, type FulgurPageEntry, type FulgurRemoteAddress, type FulgurRemoteConfig, type FulgurRepoConfig, type FulgurUserConfig, defineFulgurConfig, loadFulgurConfig };

package/dist/config.js

@@ -0,0 +1,77 @@
+// src/config.ts
+function defineFulgurConfig(config) {
+  return config;
+}
+async function loadFulgurConfig(configPath) {
+  const { pathToFileURL, fileURLToPath } = await import("url");
+  const { createRequire } = await import("module");
+  const fs = await import("fs");
+  const os = await import("os");
+  const path = await import("path");
+  const selfDir = path.dirname(fileURLToPath(import.meta.url));
+  const selfConfigJs = path.join(selfDir, "config.js");
+  const SELF_SPEC = fs.existsSync(selfConfigJs) ? pathToFileURL(selfConfigJs).href : "@fulgur-federation-config-unavailable";
+  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgur\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
+  const importConfigs = async (cacheKey) => {
+    return await import(`${cacheKey}?t=${Date.now()}`);
+  };
+  let mod;
+  if (configPath.endsWith(".json")) {
+    mod = { default: JSON.parse(fs.readFileSync(configPath, "utf8")) };
+  } else {
+    const source = rewriteSelfImports(fs.readFileSync(configPath, "utf8"));
+    const tmpBase = path.join(os.tmpdir(), `fulgur-config-${Date.now()}`);
+    if (/\.(ts|mts|cts)$/.test(configPath)) {
+      try {
+        const tmpTs = `${tmpBase}.ts`;
+        fs.writeFileSync(tmpTs, source);
+        mod = await importConfigs(pathToFileURL(tmpTs).href);
+      } catch (e) {
+        if (!/Unexpected|SyntaxError|ERR_UNSUPPORTED_NODE_MODULES|ERR_UNKNOWN_FILE_EXTENSION|ERR_IMPORT_ATTRIBUTE/.test(String(e)) && process.version.startsWith("v2")) {
+          throw e;
+        }
+        const requireFromConfig = createRequire(configPath);
+        let esbuild;
+        try {
+          esbuild = requireFromConfig("esbuild");
+        } catch {
+          const requireFromSelf = createRequire(import.meta.url);
+          esbuild = requireFromSelf("esbuild");
+        }
+        const out = esbuild.buildSync({ entryPoints: [configPath], bundle: false, write: false, format: "esm", target: "node18" });
+        const jsFile = `${tmpBase}.mjs`;
+        fs.writeFileSync(jsFile, rewriteSelfImports(out.outputFiles[0].text));
+        mod = await importConfigs(pathToFileURL(jsFile).href);
+      }
+    } else {
+      const jsFile = `${tmpBase}.mjs`;
+      fs.writeFileSync(jsFile, source);
+      mod = await importConfigs(pathToFileURL(jsFile).href);
+    }
+  }
+  const cfg = mod.default;
+  if (!cfg?.root) {
+    throw new Error(
+      `[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 root\uFF08\u5DE5\u7A0B\u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF09
+\u6839\u56E0\uFF1ACLI \u9700\u8981\u77E5\u9053\u5728\u54EA\u4E2A\u5DE5\u7A0B\u4E0A\u505A\u96C6\u6210
+\u4FEE\u6CD5\uFF1Afulgur.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgur init\uFF09`
+    );
+  }
+  if (!Array.isArray(cfg.apps) || cfg.apps.length === 0) {
+    throw new Error("[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 apps\uFF08\u81F3\u5C11\u4E00\u4E2A\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u5E94\u7528\uFF09");
+  }
+  for (const app of cfg.apps) {
+    if (!app.host && !app.remote) {
+      throw new Error(
+        `[fulgur:init] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
+\u6839\u56E0\uFF1A\u5E94\u7528\u5FC5\u987B\u81F3\u5C11\u58F0\u660E\u4E00\u4E2A\u89D2\u8272
+\u4FEE\u6CD5\uFF1A\u5BBF\u4E3B\u8865 host: { pages, remotePrefixes, remotes }\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
+      );
+    }
+  }
+  return cfg;
+}
+export {
+  defineFulgurConfig,
+  loadFulgurConfig
+};