@fulgurjs/federation 0.4.2

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+import { Plugin } from 'vite';
+
+interface SharedHint {
+    /** 放入共享作用域的本地模块；false 表示不提供本地副本 */
+    import?: string | false;
+    /** 用于从 package.json 推断 requiredVersion 的包名 */
+    packageName?: string;
+    /** 期望版本（完整 semver 语法 / false 接受任意） */
+    requiredVersion?: string | false;
+    /** 只允许单实例 */
+    singleton?: boolean;
+    /** 版本无效时抛运行时错误（默认：有本地副本且非 singleton 时为 true，对齐 webpack） */
+    strictVersion?: boolean;
+    /** 在共享作用域中的键（导入名与共享名不同时使用） */
+    shareKey?: string;
+    /** 共享作用域命名空间 */
+    shareScope?: string;
+    /** 同步提供（打进初始 chunk，总是被下载） */
+    eager?: boolean;
+    /** 提供版本显式指定 */
+    version?: string;
+}
+type SharedConfig = string[] | Record<string, string | SharedHint>;
+interface ExposeHint {
+    import: string;
+    /** 稳定 chunk 文件名（不写则内部 id，随构建变化） */
+    name?: string;
+}
+interface RemoteEntryConfig {
+    external?: string;
+    shareScope?: string;
+    /** dev 专用地址（缺省回落 external） */
+    dev?: string;
+    /** prod 专用地址（缺省回落 external） */
+    prod?: string;
+    timeout?: number;
+    retries?: number;
+    /** 备用 remoteEntry 地址 */
+    fallback?: string[];
+    breaker?: {
+        threshold?: number;
+        resetMs?: number;
+    };
+}
+interface FulgurOptions {
+    name: string;
+    filename?: string;
+    exposes?: Record<string, string | ExposeHint>;
+    remotes?: Record<string, string | RemoteEntryConfig | (() => Promise<any>)>;
+    shared?: SharedConfig;
+    shareScope?: string;
+    remoteType?: string;
+    library?: {
+        type?: string;
+        name?: string;
+    };
+    runtime?: string | false;
+    runtimeChunk?: boolean | 'single';
+    manifest?: boolean | Record<string, unknown>;
+    runtimePlugins?: string[];
+    dts?: boolean | {
+        dir?: string;
+    };
+    /** 接受并恒为 true：TLA 天然异步边界，无需手工 bootstrap（比 webpack 更进一步） */
+    automaticAsyncBoundary?: boolean;
+    /** 接受并恒为 true：preloadRemote 能力始终可用 */
+    dataPrefetch?: boolean;
+    /** 接受 no-op：Rollup/Rolldown 原生 tree-shaking 已覆盖 */
+    usedExports?: boolean;
+    ignoreUnusedSharedExports?: boolean;
+    /**
+     * dev 下自身源码（含依赖，需配合 optimizeDeps.exclude）是否参与 shared 协商改写。
+     * 默认：纯 remote（无 remotes）为 true——被宿主消费的组件需协商到宿主实例；
+     * 有 remotes 的宿主为 false——自身 import 即自身 provide，避免巨型工程 TLA/循环依赖风险。
+     * 双向联邦（宿主同时 expose 组件给更高层消费）显式设 true。
+     */
+    devSharedSelf?: boolean;
+}
+
+declare function federation(options: FulgurOptions): Plugin[];
+
+export { type FulgurOptions, federation as default, federation };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import { Plugin } from 'vite';
+
+interface SharedHint {
+    /** 放入共享作用域的本地模块；false 表示不提供本地副本 */
+    import?: string | false;
+    /** 用于从 package.json 推断 requiredVersion 的包名 */
+    packageName?: string;
+    /** 期望版本（完整 semver 语法 / false 接受任意） */
+    requiredVersion?: string | false;
+    /** 只允许单实例 */
+    singleton?: boolean;
+    /** 版本无效时抛运行时错误（默认：有本地副本且非 singleton 时为 true，对齐 webpack） */
+    strictVersion?: boolean;
+    /** 在共享作用域中的键（导入名与共享名不同时使用） */
+    shareKey?: string;
+    /** 共享作用域命名空间 */
+    shareScope?: string;
+    /** 同步提供（打进初始 chunk，总是被下载） */
+    eager?: boolean;
+    /** 提供版本显式指定 */
+    version?: string;
+}
+type SharedConfig = string[] | Record<string, string | SharedHint>;
+interface ExposeHint {
+    import: string;
+    /** 稳定 chunk 文件名（不写则内部 id，随构建变化） */
+    name?: string;
+}
+interface RemoteEntryConfig {
+    external?: string;
+    shareScope?: string;
+    /** dev 专用地址（缺省回落 external） */
+    dev?: string;
+    /** prod 专用地址（缺省回落 external） */
+    prod?: string;
+    timeout?: number;
+    retries?: number;
+    /** 备用 remoteEntry 地址 */
+    fallback?: string[];
+    breaker?: {
+        threshold?: number;
+        resetMs?: number;
+    };
+}
+interface FulgurOptions {
+    name: string;
+    filename?: string;
+    exposes?: Record<string, string | ExposeHint>;
+    remotes?: Record<string, string | RemoteEntryConfig | (() => Promise<any>)>;
+    shared?: SharedConfig;
+    shareScope?: string;
+    remoteType?: string;
+    library?: {
+        type?: string;
+        name?: string;
+    };
+    runtime?: string | false;
+    runtimeChunk?: boolean | 'single';
+    manifest?: boolean | Record<string, unknown>;
+    runtimePlugins?: string[];
+    dts?: boolean | {
+        dir?: string;
+    };
+    /** 接受并恒为 true：TLA 天然异步边界，无需手工 bootstrap（比 webpack 更进一步） */
+    automaticAsyncBoundary?: boolean;
+    /** 接受并恒为 true：preloadRemote 能力始终可用 */
+    dataPrefetch?: boolean;
+    /** 接受 no-op：Rollup/Rolldown 原生 tree-shaking 已覆盖 */
+    usedExports?: boolean;
+    ignoreUnusedSharedExports?: boolean;
+    /**
+     * dev 下自身源码（含依赖，需配合 optimizeDeps.exclude）是否参与 shared 协商改写。
+     * 默认：纯 remote（无 remotes）为 true——被宿主消费的组件需协商到宿主实例；
+     * 有 remotes 的宿主为 false——自身 import 即自身 provide，避免巨型工程 TLA/循环依赖风险。
+     * 双向联邦（宿主同时 expose 组件给更高层消费）显式设 true。
+     */
+    devSharedSelf?: boolean;
+}
+
+declare function federation(options: FulgurOptions): Plugin[];
+
+export { type FulgurOptions, federation as default, federation };