@softarc/native-federation-orchestrator 4.2.1 → 4.2.2

package/types/lib/init-federation.node.d.ts

@@ -1,6 +1,32 @@
 import type { FederationManifest } from './1.domain';
 import type { NFOptions } from './2.app/config/config.contract';
 import type { NativeFederationResult } from './init-federation.contract';
-export type InitNodeFederationOptions = NFOptions;
+import { type HostInstancesOption } from './4.config/import-map/resolve-host-instances';
+export type { HostInstancesOption, HostInstancesAuto } from './4.config/import-map/resolve-host-instances';
+export type InitNodeFederationOptions = NFOptions & {
+    /**
+     * Bridge specifiers to instances already loaded in the host process (dev).
+     *
+     * The host's instances are published on `globalThis.__NF_HOST_INSTANCES__`
+     * and the node loader synthesizes a re-export module for each specifier
+     * instead of resolving it through the import map, so remotes share the host's
+     * singletons. Three forms:
+     *
+     * - **Explicit map** — `{ '@angular/core': await import('@angular/core') }`.
+     * - **`'all'`** — auto-derive every shared singleton from the host remoteEntry
+     *   and import each in the host realm. Needs `hostRemoteEntry`.
+     * - **`{ include, exclude }`** — auto-derive, filtered by exact/prefix match,
+     *   e.g. `{ include: ['@angular/', 'rxjs', 'zone.js'] }`.
+     *
+     * This is an escape hatch that bypasses the version resolver, the import map,
+     * and integrity checks entirely. Exports are value snapshots, not live
+     * bindings — fine for packages whose exports are stable refs (Angular's
+     * classes/functions), not for packages that reassign their exports after init.
+     *
+     * Omit in production: with no `hostInstances`, nothing is published and the
+     * loader never routes to the bridge — resolution is import-map only.
+     */
+    hostInstances?: HostInstancesOption;
+};
 declare const initNodeFederation: (remotesOrManifestUrl: string | FederationManifest, options?: InitNodeFederationOptions) => Promise<NativeFederationResult>;
 export { initNodeFederation };