@fulgurjs/federation 4.3.1 → 5.0.0

package/dist/chunk-NOMYWDZN.js

@@ -1,141 +0,0 @@
-import {
-  definePages
-} from "./chunk-TSXZ7TWA.js";
-
-// src/vue-adapter.ts
-import { defineAsyncComponent, defineComponent, h } from "vue";
-var ERROR_STYLE = {
-  padding: "16px",
-  border: "1px solid #fde2e2",
-  borderRadius: "4px",
-  background: "#fef0f0",
-  color: "#c45656",
-  fontSize: "13px",
-  lineHeight: "1.6"
-};
-var RemoteErrorPlaceholder = defineComponent({
-  name: "FulgurjsRemoteError",
-  props: { error: { type: Object, default: void 0 } },
-  setup(props) {
-    return () => {
-      const err = props.error;
-      const code = err?.code ?? "UNKNOWN";
-      const message = err?.message ?? String(props.error ?? "unknown error");
-      return h("div", { style: ERROR_STYLE }, [
-        h("p", { style: "margin:0 0 4px;font-weight:600" }, `\u8FDC\u7A0B\u7EC4\u4EF6\u52A0\u8F7D\u5931\u8D25\uFF08\u9519\u8BEF\u7801 ${code}\uFF09`),
-        h("p", { style: "margin:0 0 8px;word-break:break-all" }, message),
-        h("p", { style: "margin:0" }, "\u4FEE\u6CD5\uFF1A\u2460 \u6838\u5BF9 spec \u7684\u300C\u8FDC\u7A0B\u540D/expose \u540D\u300D\u4E0E\u8FDC\u7A0B\u5E94\u7528 exposes \u662F\u5426\u4E00\u81F4\uFF08MFU-006/008\uFF09\uFF1B\u2461 \u6838\u5BF9 remotes \u5730\u5740\u7AEF\u53E3\u4E0E\u8FDC\u7A0B\u670D\u52A1\u53EF\u8FBE\u6027\u3001remoteEntry \u662F\u5426\u53EF\u8BBF\u95EE\uFF08MFU-001\uFF09\uFF1B\u2462 \u67E5\u770B window \u7684 fulgurjs:error \u4E8B\u4EF6\u4E0E console \u540C\u6E90\u9519\u8BEF\u5B9A\u4F4D\u6839\u56E0\u3002")
-      ]);
-    };
-  }
-});
-function createRemoteComponent(loadRemote) {
-  return function remoteComponent(spec, opts = {}) {
-    return defineAsyncComponent({
-      loader: () => loadRemote(spec, { retries: opts.retries }).then((m) => m.default ?? m),
-      loadingComponent: opts.loadingComponent,
-      errorComponent: opts.errorComponent ?? RemoteErrorPlaceholder,
-      delay: opts.delay,
-      timeout: opts.timeout
-    });
-  };
-}
-var cleanCompName = (spec) => "Fulgurjs_" + spec.replace(/[^A-Za-z0-9_-]/g, "_");
-function defaultDeriveSpec(route) {
-  return route.split("/").filter(Boolean).slice(1).filter((seg) => !seg.startsWith(":")).join("/");
-}
-function createHostPages(options, load) {
-  const { pages, remotePrefixes, deriveSpec, schema, strict, base, beforeLoad, loadingComponent, errorComponent, delay } = options;
-  definePages(pages, { deriveSpec, remotes: remotePrefixes, schema, strict });
-  const prefixes = Object.entries(remotePrefixes).map(([p, name]) => [p.endsWith("/") ? p : `${p}/`, name]).sort((a, b) => b[0].length - a[0].length);
-  const remoteOf = (route) => {
-    for (const [prefix, name] of prefixes) {
-      if (route.startsWith(prefix) || `${route}/` === prefix) return name;
-    }
-    throw new Error(
-      `[fulgurjs] \u9875\u9762\u8DEF\u7531 "${route}" \u672A\u5339\u914D\u4EFB\u4F55 remotePrefixes\uFF1A{ ${Object.entries(remotePrefixes).map(([k, v]) => `'${k}': '${v}'`).join(", ")} }
-  \u6839\u56E0: \u9875\u9762\u8868\u6761\u76EE\u7684\u8DEF\u7531\u4E0D\u5728\u4EFB\u4F55\u5DF2\u58F0\u660E\u7684\u8FDC\u7A0B\u524D\u7F00\u4E0B\u3002
-  \u4FEE\u6CD5: \u5728 remotePrefixes \u8865\u5145\u8BE5\u8DEF\u7531\u524D\u7F00 \u2192 \u8FDC\u7A0B\u540D\u7684\u6620\u5C04\uFF0C\u6216\u4FEE\u6B63\u9875\u9762\u8868 route\u3002`
-    );
-  };
-  for (const page of pages) remoteOf(page.route);
-  const specOf = (page) => {
-    const s = page.spec ?? (deriveSpec ? deriveSpec(page.route) : defaultDeriveSpec(page.route));
-    return `${remoteOf(page.route)}/${String(s).replace(/^[./]+/, "")}`;
-  };
-  const baseNorm = base && base !== "/" ? base.endsWith("/") ? base : `${base}/` : "";
-  const matchSegments = (pattern, path) => {
-    const patSegs = pattern.split("/").filter(Boolean);
-    const pathSegs = path.split("/").filter(Boolean);
-    if (patSegs.length !== pathSegs.length) return null;
-    const params = {};
-    for (let i = 0; i < patSegs.length; i++) {
-      const seg = patSegs[i];
-      if (seg.startsWith(":")) {
-        try {
-          params[seg.slice(1)] = decodeURIComponent(pathSegs[i]);
-        } catch {
-          return null;
-        }
-      } else if (seg !== pathSegs[i]) {
-        return null;
-      }
-    }
-    return params;
-  };
-  let cacheSession;
-  const compCache = /* @__PURE__ */ new Map();
-  const resolve = (rawPath) => {
-    let clean = String(rawPath ?? "");
-    if (baseNorm) {
-      if (clean === baseNorm.replace(/\/$/, "")) clean = "/";
-      else if (clean.startsWith(baseNorm)) clean = `/${clean.slice(baseNorm.length)}`;
-    }
-    clean = (clean.replace(/\/+$/, "") || "/").split("?")[0].split("#")[0];
-    for (const page of pages) {
-      const params = matchSegments(page.route, clean);
-      if (params) return { page, remote: remoteOf(page.route), spec: specOf(page), params };
-    }
-    return null;
-  };
-  const component = (spec) => {
-    const sk = (globalThis.__FULGURJS_APP_CONFIG__ ?? {}).sessionKey;
-    const sessionKey = typeof sk === "string" && sk !== "" ? sk : void 0;
-    if (sessionKey !== void 0 && sessionKey !== cacheSession) {
-      compCache.clear();
-      cacheSession = sessionKey;
-    }
-    let comp = compCache.get(spec);
-    if (!comp) {
-      const name = cleanCompName(spec);
-      const asyncComp = defineAsyncComponent({
-        loader: async () => {
-          await beforeLoad?.();
-          const mod = await load(spec);
-          const inner = mod?.default ?? mod;
-          if (!inner) {
-            throw new Error(
-              `[fulgurjs] \u8FDC\u7A0B\u6A21\u5757 "${spec}" \u6CA1\u6709\u5BFC\u51FA\u53EF\u6E32\u67D3\u7EC4\u4EF6\uFF1B\u5F53\u524D\u503C\u7C7B\u578B\u4E3A ${inner === null ? "null" : typeof inner}\u3002
-  \u4FEE\u6CD5: \u6838\u5BF9\u8FDC\u7A0B exposes \u952E\u540D\u4E0E\u9875\u9762\u8868 spec \u662F\u5426\u4E00\u81F4\uFF08MFU-006 \u8BED\u4E49\uFF09`
-            );
-          }
-          return inner;
-        },
-        loadingComponent,
-        errorComponent: errorComponent ?? RemoteErrorPlaceholder,
-        delay
-      });
-      asyncComp.name = name;
-      comp = asyncComp;
-      compCache.set(spec, comp);
-    }
-    return comp;
-  };
-  const keepAliveNames = pages.filter((p) => p.keepAlive).map((p) => cleanCompName(specOf(p)));
-  return { pages, resolve, component, keepAliveNames };
-}
-
-export {
-  createRemoteComponent,
-  createHostPages
-};

package/dist/chunk-WBCXLR2N.js

@@ -1,46 +0,0 @@
-// src/runtime/errors.ts
-var FgError = class extends Error {
-  code;
-  details;
-  constructor(code, message, details) {
-    super(`[fulgurjs:${code}] ${message}`);
-    this.name = "FgError";
-    this.code = code;
-    this.details = details;
-  }
-};
-var ErrorCodes = {
-  /** 远程容器加载失败（网络/超时/重试耗尽/熔断） */
-  REMOTE_LOAD_FAILED: "MFU-001",
-  /** remoteEntry 自报名与 remotes 配置的名称不匹配 */
-  REMOTE_NAME_MISMATCH: "MFU-002",
-  /** strictVersion 开启且共享版本不满足 */
-  SHARE_STRICT_VERSION: "MFU-003",
-  /** 共享模块缺失且无本地 fallback（import: false） */
-  SHARE_NOT_AVAILABLE: "MFU-004",
-  /** 同一容器用不同 share scope 重复 init */
-  CONTAINER_REINIT_CONFLICT: "MFU-005",
-  /** 请求的模块未被该远程 exposes */
-  MODULE_NOT_EXPOSED: "MFU-006",
-  /** 预加载失败 */
-  PRELOAD_FAILED: "MFU-007",
-  /** 未知远程 */
-  REMOTE_UNKNOWN: "MFU-008",
-  /** 加载到的模块没有任何导出（常见：exposes 指向了不导出内容的文件） */
-  EMPTY_EXPORTS: "MFU-009",
-  /** singleton 共享协商版本与消费方 requiredVersion 不一致（使用作用域版本，仅告警） */
-  SINGLETON_SKEW: "MFU-010",
-  /** setup 生命周期入口导出形态非法（默认导出不是函数，或具名 onSession 不是函数） */
-  SETUP_INVALID_EXPORT: "MFU-011",
-  /** setup/onSession 执行抛错（该次 loadRemote 拒绝；仅清失败阶段缓存，允许重试） */
-  SETUP_RUN_FAILED: "MFU-012",
-  /** 远程声明了 onSession 但宿主 AppContext 未提供 sessionKey（登录代次） */
-  SETUP_SESSION_KEY_MISSING: "MFU-013",
-  /** setup/onSession 执行的同步段内递归 loadRemote 同一远程 */
-  SETUP_RECURSION: "MFU-014"
-};
-
-export {
-  FgError,
-  ErrorCodes
-};

package/dist/config.cjs

@@ -1,174 +0,0 @@
-"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, {
-  defineRepoConfig: () => defineRepoConfig,
-  federationOptionsForApp: () => federationOptionsForApp,
-  loadRepoConfig: () => loadRepoConfig
-});
-module.exports = __toCommonJS(config_exports);
-var import_meta = {};
-function defineRepoConfig(config) {
-  return config;
-}
-async function loadRepoConfig(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 = await (async () => {
-    try {
-      return path.dirname(fileURLToPath(import_meta.url));
-    } catch {
-    }
-    try {
-      return __dirname;
-    } catch {
-    }
-    return "";
-  })();
-  const selfConfigJs = selfDir ? path.join(selfDir, "config.js") : "";
-  const SELF_SPEC = selfConfigJs && fs.existsSync(selfConfigJs) ? pathToFileURL(selfConfigJs).href : "@fulgurjs-federation-config-unavailable";
-  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgurjs\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
-  let cacheBust = 0;
-  const importConfigs = async (cacheKey) => {
-    return await import(`${cacheKey}?t=${Date.now()}-${++cacheBust}`);
-  };
-  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(), `fulgurjs-config-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
-    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(
-      `[fulgurjs: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\uFF1Afulgurjs.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgurjs init\uFF09`
-    );
-  }
-  if (!Array.isArray(cfg.apps) || cfg.apps.length === 0) {
-    throw new Error("[fulgurjs: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(
-        `[fulgurjs: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: { remotePrefixes, remotes }\uFF08pages \u53EF\u9009\uFF09\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
-      );
-    }
-  }
-  return cfg;
-}
-function federationOptionsForApp(config, appPathOrName) {
-  const app = config.apps.find(
-    (a) => a.path === appPathOrName || a.name === appPathOrName
-  );
-  if (!app) {
-    throw new Error(
-      `[fulgurjs] \u5E94\u7528 "${appPathOrName}" \u4E0D\u5728\u4ED3\u5E93\u914D\u7F6E\u4E2D
-  \u53EF\u7528\u5E94\u7528: ${config.apps.map((a) => `${a.path}(${a.name})`).join("\u3001")}
-  \u4FEE\u6CD5: \u4FEE\u6B63\u5E94\u7528\u76EE\u5F55\u540D\u6216\u5BB9\u5668\u540D\uFF08fulgurjs.config.ts apps \u6570\u7EC4\u5185\u4E8C\u9009\u4E00\u5339\u914D\uFF09`
-    );
-  }
-  if (!app.host && !app.remote) {
-    throw new Error(
-      `[fulgurjs] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
-  \u4FEE\u6CD5: \u5BBF\u4E3B\u8865 host: { remotePrefixes, remotes }\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
-    );
-  }
-  const remotes = {};
-  const remoteSource = /* @__PURE__ */ new Map();
-  const mergeRemotes = (from, role) => {
-    for (const [key, addr] of Object.entries(from ?? {})) {
-      const prev = remotes[key];
-      if (prev && (prev.dev !== addr.dev || prev.prod !== addr.prod)) {
-        throw new Error(
-          `[fulgurjs] \u5E94\u7528 "${app.path}" \u7684\u8FDC\u7A0B "${key}" \u5728 ${role} \u4E0E ${remoteSource.get(key)} \u4E24\u5904\u5730\u5740\u4E0D\u4E00\u81F4
-  ${remoteSource.get(key)}: dev=${prev.dev} prod=${prev.prod}
-  ${role}: dev=${addr.dev} prod=${addr.prod}
-  \u4FEE\u6CD5: \u4FEE\u6B63 fulgurjs.config.ts \u4F7F\u4E24\u5904\u4E00\u81F4\uFF08\u540C\u4E00\u8FDC\u7A0B\u5728\u4E00\u4E2A\u5E94\u7528\u5185\u53EA\u80FD\u6709\u4E00\u4E2A\u5730\u5740\uFF09`
-        );
-      }
-      remotes[key] = addr;
-      remoteSource.set(key, role);
-    }
-  };
-  mergeRemotes(app.host?.remotes, "host.remotes");
-  mergeRemotes(app.remote?.remotes, "remote.remotes");
-  const hasExposes = !!app.remote && Object.keys(app.remote.exposes).length > 0;
-  const hasRemotes = Object.keys(remotes).length > 0;
-  return {
-    name: app.name,
-    ...hasRemotes ? { remotes } : {},
-    ...hasExposes ? { exposes: app.remote.exposes } : {},
-    ...app.remote?.setup ? { setup: app.remote.setup } : {},
-    ...app.shared ? { shared: app.shared } : {},
-    devSharedSelf: app.devSharedSelf ?? (hasExposes || !!app.remote?.setup)
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  defineRepoConfig,
-  federationOptionsForApp,
-  loadRepoConfig
-});

package/dist/config.d.cts

@@ -1,106 +0,0 @@
-import { F as FederationOptions } from './options-CRGpSmVj.cjs';
-
-/**
- * W1 fulgurjs.config.ts：单配置文件驱动的 schema + 加载器（项目无关，决策见排期文档 §4：
- * 主包内置 bin + 单配置文件驱动，可入库可复跑）。
- * init 只消费该配置生成通用样板（见 init.ts）；插件运行时（federation()）不读取本文件。
- */
-interface PageEntry {
-    /** 宿主路由路径（参数段用 :xx） */
-    route: string;
-    /** 路由 name（命名跳转依赖） */
-    name?: string;
-    /** 远程 exposes 键（显式覆盖默认推导 pages/<去前缀去参数段>） */
-    spec?: string;
-    /** 页签标题 */
-    title?: string;
-    /** 页面保活开关（按页显式开启；默认关闭） */
-    keepAlive?: boolean;
-}
-interface RemoteAddress {
-    dev: string;
-    prod: string;
-}
-interface HostConfig {
-    /**
-     * 页面路由表（可选）：应用代码的页面表是运行时页面真源（供宿主路由与
-     * createHostPages 共用），仓库配置中的副本仅供 init/explain 摘要与核对。
-     * 不再强制——缺省时 CLI 摘要按实际提供数量报告。
-     */
-    pages?: PageEntry[];
-    /** 页面 spec 推导规则（与宿主 createHostPages 的 deriveSpec 保持一致；缺省 = 去首段 + 剥 :参 段） */
-    deriveSpec?: (route: string) => string;
-    /** 路由前缀 → 远程名 */
-    remotePrefixes: Record<string, string>;
-    /** 消费的远程地址（键 = import 前缀；裸 URL，对象形式不支持 name@ 前缀） */
-    remotes: Record<string, RemoteAddress>;
-}
-interface RemoteConfig {
-    /** exposes：./键 → 源文件（独立页） */
-    exposes: Record<string, string>;
-    /** 远程初始化入口（默认导出 setup(context)，可选具名导出 onSession(context)） */
-    setup?: string;
-    /** 反向消费的远程（双向联邦时） */
-    remotes?: Record<string, RemoteAddress>;
-}
-interface AppConfig {
-    /** 相对 root 的应用目录 */
-    path: string;
-    /** 联邦容器名 */
-    name: string;
-    /** dev 端口 */
-    port: number;
-    /** 部署/dev 的 URL 前缀，如 /main */
-    base: string;
-    /** 部署目录名（缺省取 base 去斜杠） */
-    deployDir?: string;
-    /** 宿主角色 */
-    host?: HostConfig;
-    /** 远程角色 */
-    remote?: RemoteConfig;
-    /** 该应用的 shared 表（缺省建议 vue/vue-router/pinia singleton，见 init 输出的样板） */
-    shared?: Record<string, {
-        singleton?: boolean;
-        requiredVersion?: string;
-    }>;
-    /** 显式覆盖 dev 下自身源码参与 shared 协商改写；缺省按角色推断（见 federationOptionsForApp） */
-    devSharedSelf?: boolean;
-}
-interface DeployConfig {
-    /** NGINX 站点根（样板输出用，可选） */
-    webRoot?: string;
-    /** 监听端口（样板输出用，可选） */
-    listen?: number;
-}
-interface RepoConfig {
-    /** 工程根（monorepo 根或单应用仓库根） */
-    root: string;
-    apps: AppConfig[];
-    deploy?: DeployConfig;
-}
-type UserConfig = Partial<RepoConfig>;
-/** 用户配置文件入口：仅做类型收窄（identity），不引入运行时逻辑 */
-declare function defineRepoConfig(config: UserConfig): UserConfig;
-/**
- * 加载 fulgurjs.config.ts（或 .js/.json）。
- * - 配置内的 `@fulgurjs/federation/config` 导入被重写为本包 dist/config.js 绝对路径——
- *   init 之前工程依赖尚未安装（鸡生蛋），重写后零依赖可加载；
- * - TS 走 Node 原生类型剥离（Node ≥23.6 默认开启；配置文件须用可擦除语法——纯对象无 enum/namespace）；
- *   老版本 Node 回退 esbuild 转译（先试配置工程，再试 CLI 自带依赖树）。
- */
-declare function loadRepoConfig(configPath: string): Promise<RepoConfig>;
-/**
- * 仓库配置 → 某应用的 federation() Vite 插件选项（§3.4 单配置驱动）。
- *
- * 转换范围：name、宿主/反向 remotes（两处同键冲突即报错，带两边值）、exposes、
- * 可选 setup、shared、devSharedSelf。build.target/base/端口/代理/插件顺序等仍归各应用
- * vite.config.ts 管理——本函数只生成 federation({...}) 的入参。
- *
- * devSharedSelf 来源（优先级）：app.devSharedSelf 显式值 > 角色推断。
- * 推断规则：提供 exposes（含仅 setup）的应用为 true（其源码被宿主消费，需协商到宿主
- * 实例）；纯宿主（只消费）为 false。双向联邦漏配该项曾是已知错误配置（§12.4），
- * 推断后不再依赖背诵。
- */
-declare function federationOptionsForApp(config: RepoConfig, appPathOrName: string): FederationOptions;
-
-export { type AppConfig, type DeployConfig, type HostConfig, type PageEntry, type RemoteAddress, type RemoteConfig, type RepoConfig, type UserConfig, defineRepoConfig, federationOptionsForApp, loadRepoConfig };

package/dist/config.d.ts

@@ -1,106 +0,0 @@
-import { F as FederationOptions } from './options-CRGpSmVj.js';
-
-/**
- * W1 fulgurjs.config.ts：单配置文件驱动的 schema + 加载器（项目无关，决策见排期文档 §4：
- * 主包内置 bin + 单配置文件驱动，可入库可复跑）。
- * init 只消费该配置生成通用样板（见 init.ts）；插件运行时（federation()）不读取本文件。
- */
-interface PageEntry {
-    /** 宿主路由路径（参数段用 :xx） */
-    route: string;
-    /** 路由 name（命名跳转依赖） */
-    name?: string;
-    /** 远程 exposes 键（显式覆盖默认推导 pages/<去前缀去参数段>） */
-    spec?: string;
-    /** 页签标题 */
-    title?: string;
-    /** 页面保活开关（按页显式开启；默认关闭） */
-    keepAlive?: boolean;
-}
-interface RemoteAddress {
-    dev: string;
-    prod: string;
-}
-interface HostConfig {
-    /**
-     * 页面路由表（可选）：应用代码的页面表是运行时页面真源（供宿主路由与
-     * createHostPages 共用），仓库配置中的副本仅供 init/explain 摘要与核对。
-     * 不再强制——缺省时 CLI 摘要按实际提供数量报告。
-     */
-    pages?: PageEntry[];
-    /** 页面 spec 推导规则（与宿主 createHostPages 的 deriveSpec 保持一致；缺省 = 去首段 + 剥 :参 段） */
-    deriveSpec?: (route: string) => string;
-    /** 路由前缀 → 远程名 */
-    remotePrefixes: Record<string, string>;
-    /** 消费的远程地址（键 = import 前缀；裸 URL，对象形式不支持 name@ 前缀） */
-    remotes: Record<string, RemoteAddress>;
-}
-interface RemoteConfig {
-    /** exposes：./键 → 源文件（独立页） */
-    exposes: Record<string, string>;
-    /** 远程初始化入口（默认导出 setup(context)，可选具名导出 onSession(context)） */
-    setup?: string;
-    /** 反向消费的远程（双向联邦时） */
-    remotes?: Record<string, RemoteAddress>;
-}
-interface AppConfig {
-    /** 相对 root 的应用目录 */
-    path: string;
-    /** 联邦容器名 */
-    name: string;
-    /** dev 端口 */
-    port: number;
-    /** 部署/dev 的 URL 前缀，如 /main */
-    base: string;
-    /** 部署目录名（缺省取 base 去斜杠） */
-    deployDir?: string;
-    /** 宿主角色 */
-    host?: HostConfig;
-    /** 远程角色 */
-    remote?: RemoteConfig;
-    /** 该应用的 shared 表（缺省建议 vue/vue-router/pinia singleton，见 init 输出的样板） */
-    shared?: Record<string, {
-        singleton?: boolean;
-        requiredVersion?: string;
-    }>;
-    /** 显式覆盖 dev 下自身源码参与 shared 协商改写；缺省按角色推断（见 federationOptionsForApp） */
-    devSharedSelf?: boolean;
-}
-interface DeployConfig {
-    /** NGINX 站点根（样板输出用，可选） */
-    webRoot?: string;
-    /** 监听端口（样板输出用，可选） */
-    listen?: number;
-}
-interface RepoConfig {
-    /** 工程根（monorepo 根或单应用仓库根） */
-    root: string;
-    apps: AppConfig[];
-    deploy?: DeployConfig;
-}
-type UserConfig = Partial<RepoConfig>;
-/** 用户配置文件入口：仅做类型收窄（identity），不引入运行时逻辑 */
-declare function defineRepoConfig(config: UserConfig): UserConfig;
-/**
- * 加载 fulgurjs.config.ts（或 .js/.json）。
- * - 配置内的 `@fulgurjs/federation/config` 导入被重写为本包 dist/config.js 绝对路径——
- *   init 之前工程依赖尚未安装（鸡生蛋），重写后零依赖可加载；
- * - TS 走 Node 原生类型剥离（Node ≥23.6 默认开启；配置文件须用可擦除语法——纯对象无 enum/namespace）；
- *   老版本 Node 回退 esbuild 转译（先试配置工程，再试 CLI 自带依赖树）。
- */
-declare function loadRepoConfig(configPath: string): Promise<RepoConfig>;
-/**
- * 仓库配置 → 某应用的 federation() Vite 插件选项（§3.4 单配置驱动）。
- *
- * 转换范围：name、宿主/反向 remotes（两处同键冲突即报错，带两边值）、exposes、
- * 可选 setup、shared、devSharedSelf。build.target/base/端口/代理/插件顺序等仍归各应用
- * vite.config.ts 管理——本函数只生成 federation({...}) 的入参。
- *
- * devSharedSelf 来源（优先级）：app.devSharedSelf 显式值 > 角色推断。
- * 推断规则：提供 exposes（含仅 setup）的应用为 true（其源码被宿主消费，需协商到宿主
- * 实例）；纯宿主（只消费）为 false。双向联邦漏配该项曾是已知错误配置（§12.4），
- * 推断后不再依赖背诵。
- */
-declare function federationOptionsForApp(config: RepoConfig, appPathOrName: string): FederationOptions;
-
-export { type AppConfig, type DeployConfig, type HostConfig, type PageEntry, type RemoteAddress, type RemoteConfig, type RepoConfig, type UserConfig, defineRepoConfig, federationOptionsForApp, loadRepoConfig };