@softarc/native-federation 4.2.1 → 4.3.0

package/README.md

@@ -143,9 +143,78 @@ The method `federationBuilder.build` bundles the shared and exposed parts of you
 
 ### Configuring Hosts
 
-The `withNativeFederation` function sets up a configuration for your applications. This is an example configuration for a host:
+The `withNativeFederation` function sets up a configuration for your applications. This is an example configuration for a host.
 
-The `shareAll` helper shares all your dependencies defined in your `package.json`:
+#### The `fromPackageJson` helper (recommended)
+
+`fromPackageJson` is the recommended way to share your dependencies. It shares **all** dependencies found in your `package.json` and exposes a small fluent builder so you can fine-tune the result. The base options you pass are applied to every shared dependency; you then chain `.skip(...)`, `.override(...)` and `.patch(...)` as needed and finish with `.get()`:
+
+```typescript
+// shell/federation.config.js
+
+import { withNativeFederation, fromPackageJson } from '@softarc/native-federation/config';
+
+export default withNativeFederation({
+  name: 'host',
+
+  shared: fromPackageJson({
+    singleton: true,
+    strictVersion: true,
+    requiredVersion: 'auto',
+    includeSecondaries: false,
+  }).get(),
+});
+```
+
+> [!TIP]
+> If you omit the `shared` property entirely, Native Federation applies exactly this `fromPackageJson` configuration for you (with `singleton`, `strictVersion` and `requiredVersion: 'auto'`). So the snippet above is also a good description of the default behavior.
+
+The builder returned by `fromPackageJson` offers three chainable methods, each of which returns the builder so you can combine them:
+
+- **`.skip(externals)`** — exclude packages from sharing (added on top of the [default skip list](#sharing)).
+- **`.override(externals)`** — replace the configuration for specific packages entirely. Use this when a package needs a completely different set of options.
+- **`.patch(externals, cfg)`** — merge a partial configuration onto specific shared externals, keeping the base options for everything you don't touch.
+
+```typescript
+// shell/federation.config.js
+
+import { withNativeFederation, fromPackageJson } from '@softarc/native-federation/config';
+
+export default withNativeFederation({
+  name: 'host',
+
+  shared: fromPackageJson({
+    singleton: true,
+    strictVersion: true,
+    requiredVersion: 'auto',
+  })
+    // Don't share these dependencies at all
+    .skip(['my-lib', 'some-dev-only-lib'])
+    // Give a package a completely different configuration
+    .override({
+      'package-a/themes/xyz': {
+        singleton: true,
+        strictVersion: true,
+        requiredVersion: 'auto',
+        includeSecondaries: { skip: '@package-a/themes/xyz/*' },
+        build: 'package',
+      },
+    })
+    // Tweak a few options on specific packages while keeping the base config
+    .patch(['package-b'], {
+      singleton: false,
+      includeSecondaries: { skip: 'package-b/icons/*' },
+      build: 'package',
+    })
+    .get(),
+});
+```
+
+By default the closest `package.json` (relative to your `federation.config.js`) is used. You can point at a different one by passing its path as the second argument: `fromPackageJson(baseCfg, projectPath)`.
+
+#### Alternative: the `shareAll` helper
+
+`shareAll` is the older, object-spread style alternative to `fromPackageJson`. It also shares all dependencies defined in your `package.json`, but instead of a fluent builder it returns a plain object that you spread into `shared`:
 
 ```typescript
 // shell/federation.config.js
@@ -166,11 +235,9 @@ export default withNativeFederation({
 });
 ```
 
-The options passed to shareAll are applied to all dependencies found in your `package.json`.
+The options passed to `shareAll` are applied to all dependencies found in your `package.json`. This might come in handy in a monorepo scenario and when doing some experiments / troubleshooting.
 
-This might come in handy in a monorepo scenario and when doing some experiments / troubleshooting.
-
-You can also add overrides to `shareAll` for specific packages:
+You can also add overrides to `shareAll` for specific packages, via the second argument:
 
 ```typescript
 // shell/federation.config.js
@@ -475,6 +542,27 @@ module.exports = withNativeFederation({
 
 When enabled, instead of listing each chunk as a separate shared dependency, chunks are grouped by bundle name in a dedicated `chunks` object. Each shared dependency gets a `bundle` property linking it to its chunk bundle. This results in a smaller `remoteEntry.json` and allows chunks to be skipped if the dependency is not used in the final import map.
 
+#### Dense Externals
+
+The `denseExternals` feature flag reshapes the `shared` array in `remoteEntry.json` so that all entrypoints of a shared external (its primary import plus every secondary and shared mapping) are grouped under a single object:
+
+```js
+module.exports = withNativeFederation({
+  shared: {
+    ...shareAll({
+      singleton: true,
+      strictVersion: true,
+      requiredVersion: 'auto',
+    }),
+  },
+  features: {
+    denseExternals: true,
+  },
+});
+```
+
+When enabled, instead of one flat entry per entrypoint, each package becomes one object whose `entries` map keys the full import name to its output file (e.g. `{ "@angular/common": "...", "@angular/common/http": "..." }`). Entrypoints whose sharing metadata (`singleton`, `strictVersion`, `requiredVersion`, `version`, `shareScope`) diverges are split into separate groups. Bundler chunks stay flat, and `importmap.json` is unaffected. The flag is opt-in and fully backward compatible: the runtime auto-detects each entry by shape, so old and new `remoteEntry.json` both load.
+
 ### Configuring Remotes
 
 When configuring a remote, you can expose files that can be loaded into the shell at runtime:

package/dist/config.d.ts

@@ -1,4 +1,6 @@
 export * from './lib/domain/config/index.js';
 export { withNativeFederation } from './lib/config/with-native-federation.js';
-export { findRootTsConfigJson, share, shareAll, setInferVersion, } from './lib/config/share-utils.js';
+export { findRootTsConfigJson } from './lib/config/project-paths.js';
+export { setInferVersion } from './lib/config/version-lookup.js';
+export { share, shareAll, fromPackageJson } from './lib/config/share-utils.js';
 export { DEFAULT_SKIP_LIST } from './lib/config/default-skip-list.js';

package/dist/config.js

@@ -1,15 +1,13 @@
 export * from "./lib/domain/config/index.js";
 import { withNativeFederation } from "./lib/config/with-native-federation.js";
-import {
-  findRootTsConfigJson,
-  share,
-  shareAll,
-  setInferVersion
-} from "./lib/config/share-utils.js";
+import { findRootTsConfigJson } from "./lib/config/project-paths.js";
+import { setInferVersion } from "./lib/config/version-lookup.js";
+import { share, shareAll, fromPackageJson } from "./lib/config/share-utils.js";
 import { DEFAULT_SKIP_LIST } from "./lib/config/default-skip-list.js";
 export {
   DEFAULT_SKIP_LIST,
   findRootTsConfigJson,
+  fromPackageJson,
   setInferVersion,
   share,
   shareAll,

package/dist/internal.d.ts

@@ -10,5 +10,6 @@ export type { NormalizedFederationConfig } from './lib/domain/config/federation-
 export { getDefaultCachePath, getChecksum } from './lib/core/cache/cache-persistence.js';
 export { isESMExport, type ExportCondition, type ExportEntry, } from './lib/utils/package/package-info.js';
 export { isInSkipList, prepareSkipList } from './lib/config/default-skip-list.js';
-export type { NfFileWatcher, NfFileWatcherOptions } from './lib/domain/utils/file-watcher.contract.js';
+export { densifyExternals } from './lib/core/output/densify-externals.js';
+export type { NfFileWatcher, NfFileWatcherOptions, } from './lib/domain/utils/file-watcher.contract.js';
 export { syncNfFileWatcher, createNfWatcher } from './lib/utils/file-watcher.js';

package/dist/internal.js

@@ -9,10 +9,12 @@ import {
   isESMExport
 } from "./lib/utils/package/package-info.js";
 import { isInSkipList, prepareSkipList } from "./lib/config/default-skip-list.js";
+import { densifyExternals } from "./lib/core/output/densify-externals.js";
 import { syncNfFileWatcher, createNfWatcher } from "./lib/utils/file-watcher.js";
 export {
   RebuildQueue,
   createNfWatcher,
+  densifyExternals,
   getChecksum,
   getDefaultCachePath,
   hashFile,

package/dist/lib/config/project-paths.d.ts

@@ -0,0 +1,5 @@
+import type { FileReaderPort } from '../domain/utils/io-port.contract.js';
+export declare function findRootTsConfigJson(): string;
+export declare function findRootTsConfigJsonCore(io: FileReaderPort): string;
+export declare function findPackageJson(io: FileReaderPort, folder: string): string;
+export declare function inferProjectPath(projectPath: string | undefined): string;

package/dist/lib/config/project-paths.js

@@ -0,0 +1,49 @@
+import * as path from "path";
+import { cwd } from "process";
+import { getConfigContext } from "./configuration-context.js";
+import { nodeIo } from "../utils/io/node-io-adapter.js";
+function findRootTsConfigJson() {
+  return findRootTsConfigJsonCore(nodeIo);
+}
+function findRootTsConfigJsonCore(io) {
+  const packageJson = findPackageJson(io, cwd());
+  const projectRoot = path.dirname(packageJson);
+  const tsConfigBaseJson = path.join(projectRoot, "tsconfig.base.json");
+  const tsConfigJson = path.join(projectRoot, "tsconfig.json");
+  if (io.exists(tsConfigBaseJson)) {
+    return tsConfigBaseJson;
+  } else if (io.exists(tsConfigJson)) {
+    return tsConfigJson;
+  }
+  throw new Error("Neither a tsconfig.json nor a tsconfig.base.json was found");
+}
+function findPackageJson(io, folder) {
+  while (!io.exists(path.join(folder, "package.json")) && path.dirname(folder) !== folder) {
+    folder = path.dirname(folder);
+  }
+  const filePath = path.join(folder, "package.json");
+  if (io.exists(filePath)) {
+    return filePath;
+  }
+  throw new Error(
+    "no package.json found. Searched the following folder and all parents: " + folder
+  );
+}
+function inferProjectPath(projectPath) {
+  if (!projectPath && getConfigContext().packageJson) {
+    projectPath = path.dirname(getConfigContext().packageJson || "");
+  }
+  if (!projectPath && getConfigContext().workspaceRoot) {
+    projectPath = getConfigContext().workspaceRoot || "";
+  }
+  if (!projectPath) {
+    projectPath = cwd();
+  }
+  return projectPath;
+}
+export {
+  findPackageJson,
+  findRootTsConfigJson,
+  findRootTsConfigJsonCore,
+  inferProjectPath
+};

package/dist/lib/config/secondaries.d.ts

@@ -0,0 +1,5 @@
+import { type PreparedSkipList } from '../domain/config/skip-list.contract.js';
+import type { FileReaderPort, GlobPort } from '../domain/utils/io-port.contract.js';
+import type { ExternalConfig, IncludeSecondariesOptions, SharedExternalsConfig } from '../domain/config/external-config.contract.js';
+export declare function getSecondaries(io: FileReaderPort & GlobPort, includeSecondaries: IncludeSecondariesOptions, libPath: string, key: string, shareObject: ExternalConfig, preparedSkipList: PreparedSkipList): SharedExternalsConfig | null;
+export declare function addSecondaries(secondaries: Record<string, ExternalConfig>, result: Record<string, ExternalConfig>): void;

package/dist/lib/config/secondaries.js

@@ -0,0 +1,186 @@
+import * as path from "path";
+import { isInSkipList } from "./default-skip-list.js";
+import { resolvePackageJsonExportsWildcardCore } from "../utils/package/resolve-wildcard-keys.js";
+import { logger } from "../utils/logger.js";
+function _findSecondaries(io, libPath, excludes, shareObject, acc, preparedSkipList) {
+  const files = io.readDir(libPath);
+  const secondaries = files.map((f) => path.join(libPath, f)).filter((f) => io.isDirectory(f) && !f.endsWith("node_modules"));
+  for (const s of secondaries) {
+    if (io.exists(path.join(s, "package.json"))) {
+      const secondaryLibName = s.replace(/\\/g, "/").replace(/^.*node_modules[/]/, "");
+      const inCustomSkipList = excludes.some(
+        (e) => e === secondaryLibName || e.endsWith("*") && secondaryLibName.startsWith(e.slice(0, -1))
+      );
+      if (inCustomSkipList) continue;
+      if (isInSkipList(secondaryLibName, preparedSkipList)) {
+        continue;
+      }
+      acc[secondaryLibName] = { ...shareObject };
+    }
+    _findSecondaries(io, s, excludes, shareObject, acc, preparedSkipList);
+  }
+}
+function findSecondaries(io, libPath, excludes, shareObject, preparedSkipList) {
+  const acc = {};
+  _findSecondaries(io, libPath, excludes, shareObject, acc, preparedSkipList);
+  return acc;
+}
+function getSecondaries(io, includeSecondaries, libPath, key, shareObject, preparedSkipList) {
+  let exclude = [];
+  let resolveGlob = false;
+  if (typeof includeSecondaries === "object") {
+    if (includeSecondaries.skip) {
+      if (Array.isArray(includeSecondaries.skip)) {
+        exclude = includeSecondaries.skip;
+      } else if (typeof includeSecondaries.skip === "string") {
+        exclude = [includeSecondaries.skip];
+      }
+    }
+    resolveGlob = !!includeSecondaries.resolveGlob;
+  }
+  if (!io.exists(libPath)) {
+    return {};
+  }
+  const configured = readConfiguredSecondaries(
+    io,
+    key,
+    libPath,
+    exclude,
+    shareObject,
+    preparedSkipList,
+    resolveGlob
+  );
+  if (configured) {
+    return configured;
+  }
+  const secondaries = findSecondaries(io, libPath, exclude, shareObject, preparedSkipList);
+  return secondaries;
+}
+function readConfiguredSecondaries(io, parent, libPath, exclude, shareObject, preparedSkipList, resolveGlob) {
+  const libPackageJson = path.join(libPath, "package.json");
+  if (!io.exists(libPackageJson)) {
+    return null;
+  }
+  const packageJson = JSON.parse(io.readText(libPackageJson));
+  const version = packageJson["version"];
+  const esm = packageJson["type"] === "module";
+  const exports = packageJson["exports"];
+  if (!exports) {
+    return null;
+  }
+  const keys = Object.keys(exports).filter(
+    (key) => key !== "." && key !== "./package.json" && key.startsWith("./") && (exports[key]?.["default"] || exports[key]?.["import"] || typeof exports[key] === "string")
+  );
+  const result = {};
+  const discoveredFiles = /* @__PURE__ */ new Set();
+  for (const key of keys) {
+    const secondaryName = path.join(parent, key).replace(/\\/g, "/");
+    const inCustomSkipList = exclude.some(
+      (e) => e === secondaryName || e.endsWith("*") && secondaryName.startsWith(e.slice(0, -1))
+    );
+    if (inCustomSkipList) continue;
+    if (isInSkipList(secondaryName, preparedSkipList)) {
+      continue;
+    }
+    const entry = getDefaultEntry(exports, key);
+    if (typeof entry !== "string") {
+      logger.warn("No entry point found for " + secondaryName);
+      continue;
+    }
+    if (!key.includes("*") && !isJsFile(entry)) {
+      continue;
+    }
+    const items = resolveGlobSecondaries(
+      io,
+      key,
+      libPath,
+      parent,
+      secondaryName,
+      entry,
+      { discovered: discoveredFiles, skip: exclude },
+      resolveGlob
+    );
+    items.forEach((e) => discoveredFiles.add(typeof e === "string" ? e : e.value));
+    for (const item of items) {
+      if (typeof item === "object") {
+        result[item.key] = {
+          ...shareObject,
+          packageInfo: {
+            entryPoint: item.value,
+            version: shareObject.version ?? version,
+            esm
+          }
+        };
+      } else {
+        result[item] = {
+          ...shareObject
+        };
+      }
+    }
+  }
+  return result;
+}
+function resolveGlobSecondaries(io, key, libPath, parent, secondaryName, entry, excludes, resolveGlob) {
+  let items = [];
+  if (key.includes("*")) {
+    if (!resolveGlob) return items;
+    const expanded = resolvePackageJsonExportsWildcardCore(io, key, entry, libPath);
+    items = expanded.map((e) => ({
+      key: path.join(parent, e.key),
+      value: path.join(libPath, e.value)
+    })).filter((i) => {
+      if (!isJsFile(i.value)) {
+        return false;
+      }
+      if (excludes.skip.some(
+        (e) => e.endsWith("*") ? i.key.startsWith(e.slice(0, -1)) : e === i.key
+      )) {
+        return false;
+      }
+      if (excludes.discovered.has(i.value)) {
+        return false;
+      }
+      return true;
+    });
+  } else {
+    items = [secondaryName];
+  }
+  return items;
+}
+function isJsFile(file) {
+  return file.endsWith(".js") || file.endsWith(".mjs") || file.endsWith(".cjs");
+}
+function getDefaultEntry(exports, key) {
+  let entry = "";
+  if (typeof exports[key] === "string") {
+    entry = exports[key];
+  }
+  if (!entry) {
+    entry = exports[key]?.["default"];
+    if (typeof entry === "object") {
+      entry = entry["default"];
+    }
+  }
+  if (!entry) {
+    entry = exports[key]?.["import"];
+    if (typeof entry === "object") {
+      entry = entry["import"] ?? entry["default"];
+    }
+  }
+  if (!entry) {
+    entry = exports[key]?.["require"];
+    if (typeof entry === "object") {
+      entry = entry["require"] ?? entry["default"];
+    }
+  }
+  return entry;
+}
+function addSecondaries(secondaries, result) {
+  for (const key in secondaries) {
+    result[key] = secondaries[key];
+  }
+}
+export {
+  addSecondaries,
+  getSecondaries
+};

package/dist/lib/config/share-utils.d.ts

@@ -1,10 +1,13 @@
-import { type SkipList, type PreparedSkipList } from '../domain/config/skip-list.contract.js';
+import { type SkipList } from '../domain/config/skip-list.contract.js';
 import type { PackageJsonRepository } from '../domain/utils/package-json.contract.js';
 import type { FileReaderPort, GlobPort } from '../domain/utils/io-port.contract.js';
-import type { ExternalConfig, IncludeSecondariesOptions, ResolvedSharedExternalsConfig, ShareAllExternalsOptions, SharedExternalsConfig, ShareExternalsOptions } from '../domain/config/external-config.contract.js';
-export declare function findRootTsConfigJson(): string;
-export declare function findRootTsConfigJsonCore(io: FileReaderPort): string;
-export declare function getSecondaries(io: FileReaderPort & GlobPort, includeSecondaries: IncludeSecondariesOptions, libPath: string, key: string, shareObject: ExternalConfig, preparedSkipList: PreparedSkipList): SharedExternalsConfig | null;
+import type { ExternalConfig, ResolvedSharedExternalsConfig, ShareAllExternalsOptions, ShareExternalsOptions } from '../domain/config/external-config.contract.js';
+export declare const fromPackageJson: (baseCfg: ShareAllExternalsOptions, projectPath?: string) => {
+    skip(externals: SkipList): /*elided*/ any;
+    override(externals: ShareExternalsOptions): /*elided*/ any;
+    patch(externals: string[], cfg: Partial<ExternalConfig>): /*elided*/ any;
+    get(): ResolvedSharedExternalsConfig;
+};
 export declare function shareAll(config: ShareAllExternalsOptions, opts?: {
     skipList?: SkipList;
     projectPath?: string;
@@ -14,7 +17,7 @@ export declare function shareAllCore(io: FileReaderPort & GlobPort, config: Shar
     skipList?: SkipList;
     projectPath?: string;
     overrides?: ShareExternalsOptions;
+    patchList?: Record<string, Partial<ExternalConfig>>;
 }, repo?: PackageJsonRepository): ResolvedSharedExternalsConfig;
-export declare function setInferVersion(infer: boolean): void;
 export declare function share(configuredShareObjects: ShareExternalsOptions, projectPath?: string, skipList?: SkipList): ResolvedSharedExternalsConfig;
 export declare function shareCore(io: FileReaderPort & GlobPort, configuredShareObjects: ShareExternalsOptions, projectPath?: string, skipList?: SkipList, repo?: PackageJsonRepository): ResolvedSharedExternalsConfig;

package/dist/lib/config/share-utils.js

@@ -1,240 +1,48 @@
 import * as path from "path";
-import { cwd } from "process";
 import { DEFAULT_SKIP_LIST, isInSkipList, prepareSkipList } from "./default-skip-list.js";
 import {
   sharedPackageJsonRepository,
   findDepPackageJson,
   getVersionMaps
 } from "../utils/package/package-info.js";
-import { getConfigContext } from "./configuration-context.js";
 import { logger } from "../utils/logger.js";
 import { nodeIo } from "../utils/io/node-io-adapter.js";
-import { resolvePackageJsonExportsWildcardCore } from "../utils/package/resolve-wildcard-keys.js";
-let inferVersion = false;
-function findRootTsConfigJson() {
-  return findRootTsConfigJsonCore(nodeIo);
-}
-function findRootTsConfigJsonCore(io) {
-  const packageJson = findPackageJson(io, cwd());
-  const projectRoot = path.dirname(packageJson);
-  const tsConfigBaseJson = path.join(projectRoot, "tsconfig.base.json");
-  const tsConfigJson = path.join(projectRoot, "tsconfig.json");
-  if (io.exists(tsConfigBaseJson)) {
-    return tsConfigBaseJson;
-  } else if (io.exists(tsConfigJson)) {
-    return tsConfigJson;
-  }
-  throw new Error("Neither a tsconfig.json nor a tsconfig.base.json was found");
-}
-function findPackageJson(io, folder) {
-  while (!io.exists(path.join(folder, "package.json")) && path.dirname(folder) !== folder) {
-    folder = path.dirname(folder);
-  }
-  const filePath = path.join(folder, "package.json");
-  if (io.exists(filePath)) {
-    return filePath;
-  }
-  throw new Error(
-    "no package.json found. Searched the following folder and all parents: " + folder
-  );
-}
-function lookupVersion(key, workspaceRoot, repo) {
-  const versionMaps = getVersionMaps(workspaceRoot, workspaceRoot, repo);
-  for (const versionMap of versionMaps) {
-    const version = lookupVersionInMap(key, versionMap);
-    if (version) {
-      return version;
-    }
-  }
-  throw new Error(
-    `Shared Dependency ${key} has requiredVersion:'auto'. However, this dependency is not found in your package.json`
-  );
-}
-function lookupVersionInMap(key, versions) {
-  const parts = key.split("/");
-  if (parts.length >= 2 && parts[0].startsWith("@")) {
-    key = parts[0] + "/" + parts[1];
-  } else {
-    key = parts[0];
-  }
-  if (!versions[key]) {
-    return null;
-  }
-  return versions[key];
-}
-function _findSecondaries(io, libPath, excludes, shareObject, acc, preparedSkipList) {
-  const files = io.readDir(libPath);
-  const secondaries = files.map((f) => path.join(libPath, f)).filter((f) => io.isDirectory(f) && !f.endsWith("node_modules"));
-  for (const s of secondaries) {
-    if (io.exists(path.join(s, "package.json"))) {
-      const secondaryLibName = s.replace(/\\/g, "/").replace(/^.*node_modules[/]/, "");
-      const inCustomSkipList = excludes.some(
-        (e) => e === secondaryLibName || e.endsWith("*") && secondaryLibName.startsWith(e.slice(0, -1))
-      );
-      if (inCustomSkipList) continue;
-      if (isInSkipList(secondaryLibName, preparedSkipList)) {
-        continue;
-      }
-      acc[secondaryLibName] = { ...shareObject };
-    }
-    _findSecondaries(io, s, excludes, shareObject, acc, preparedSkipList);
-  }
-}
-function findSecondaries(io, libPath, excludes, shareObject, preparedSkipList) {
-  const acc = {};
-  _findSecondaries(io, libPath, excludes, shareObject, acc, preparedSkipList);
-  return acc;
-}
-function getSecondaries(io, includeSecondaries, libPath, key, shareObject, preparedSkipList) {
-  let exclude = [];
-  let resolveGlob = false;
-  if (typeof includeSecondaries === "object") {
-    if (includeSecondaries.skip) {
-      if (Array.isArray(includeSecondaries.skip)) {
-        exclude = includeSecondaries.skip;
-      } else if (typeof includeSecondaries.skip === "string") {
-        exclude = [includeSecondaries.skip];
-      }
-    }
-    resolveGlob = !!includeSecondaries.resolveGlob;
-  }
-  if (!io.exists(libPath)) {
-    return {};
-  }
-  const configured = readConfiguredSecondaries(
-    io,
-    key,
-    libPath,
-    exclude,
-    shareObject,
-    preparedSkipList,
-    resolveGlob
-  );
-  if (configured) {
-    return configured;
-  }
-  const secondaries = findSecondaries(io, libPath, exclude, shareObject, preparedSkipList);
-  return secondaries;
-}
-function readConfiguredSecondaries(io, parent, libPath, exclude, shareObject, preparedSkipList, resolveGlob) {
-  const libPackageJson = path.join(libPath, "package.json");
-  if (!io.exists(libPackageJson)) {
-    return null;
-  }
-  const packageJson = JSON.parse(io.readText(libPackageJson));
-  const version = packageJson["version"];
-  const esm = packageJson["type"] === "module";
-  const exports = packageJson["exports"];
-  if (!exports) {
-    return null;
-  }
-  const keys = Object.keys(exports).filter(
-    (key) => key !== "." && key !== "./package.json" && key.startsWith("./") && (exports[key]?.["default"] || exports[key]?.["import"] || typeof exports[key] === "string")
-  );
-  const result = {};
-  const discoveredFiles = /* @__PURE__ */ new Set();
-  for (const key of keys) {
-    const secondaryName = path.join(parent, key).replace(/\\/g, "/");
-    const inCustomSkipList = exclude.some(
-      (e) => e === secondaryName || e.endsWith("*") && secondaryName.startsWith(e.slice(0, -1))
-    );
-    if (inCustomSkipList) continue;
-    if (isInSkipList(secondaryName, preparedSkipList)) {
-      continue;
-    }
-    const entry = getDefaultEntry(exports, key);
-    if (typeof entry !== "string") {
-      console.log("No entry point found for " + secondaryName);
-      continue;
-    }
-    if (!key.includes("*") && !isJsFile(entry)) {
-      continue;
-    }
-    const items = resolveGlobSecondaries(
-      io,
-      key,
-      libPath,
-      parent,
-      secondaryName,
-      entry,
-      { discovered: discoveredFiles, skip: exclude },
-      resolveGlob
-    );
-    items.forEach((e) => discoveredFiles.add(typeof e === "string" ? e : e.value));
-    for (const item of items) {
-      if (typeof item === "object") {
-        result[item.key] = {
-          ...shareObject,
-          packageInfo: {
-            entryPoint: item.value,
-            version: shareObject.version ?? version,
-            esm
-          }
+import { findPackageJson, inferProjectPath } from "./project-paths.js";
+import { isInferVersion, lookupVersion } from "./version-lookup.js";
+import { addSecondaries, getSecondaries } from "./secondaries.js";
+const fromPackageJson = (baseCfg, projectPath) => {
+  const skipList = [...DEFAULT_SKIP_LIST];
+  let overrides = {};
+  const patchList = {};
+  const builder = {
+    skip(externals) {
+      skipList.push(...externals);
+      return builder;
+    },
+    override(externals) {
+      overrides = { ...overrides, ...externals };
+      return builder;
+    },
+    patch(externals, cfg) {
+      externals.forEach((external) => {
+        patchList[external] = {
+          ...patchList[external] ?? {},
+          ...cfg
         };
-      } else {
-        result[item] = {
-          ...shareObject
-        };
-      }
-    }
-  }
-  return result;
-}
-function resolveGlobSecondaries(io, key, libPath, parent, secondaryName, entry, excludes, resolveGlob) {
-  let items = [];
-  if (key.includes("*")) {
-    if (!resolveGlob) return items;
-    const expanded = resolvePackageJsonExportsWildcardCore(io, key, entry, libPath);
-    items = expanded.map((e) => ({
-      key: path.join(parent, e.key),
-      value: path.join(libPath, e.value)
-    })).filter((i) => {
-      if (!isJsFile(i.value)) {
-        return false;
-      }
-      if (excludes.skip.some(
-        (e) => e.endsWith("*") ? i.key.startsWith(e.slice(0, -1)) : e === i.key
-      )) {
-        return false;
-      }
-      if (excludes.discovered.has(i.value)) {
-        return false;
-      }
-      return true;
-    });
-  } else {
-    items = [secondaryName];
-  }
-  return items;
-}
-function isJsFile(file) {
-  return file.endsWith(".js") || file.endsWith(".mjs") || file.endsWith(".cjs");
-}
-function getDefaultEntry(exports, key) {
-  let entry = "";
-  if (typeof exports[key] === "string") {
-    entry = exports[key];
-  }
-  if (!entry) {
-    entry = exports[key]?.["default"];
-    if (typeof entry === "object") {
-      entry = entry["default"];
-    }
-  }
-  if (!entry) {
-    entry = exports[key]?.["import"];
-    if (typeof entry === "object") {
-      entry = entry["import"] ?? entry["default"];
-    }
-  }
-  if (!entry) {
-    entry = exports[key]?.["require"];
-    if (typeof entry === "object") {
-      entry = entry["require"] ?? entry["default"];
+      });
+      return builder;
+    },
+    get() {
+      return shareAllCore(nodeIo, baseCfg, {
+        skipList,
+        projectPath,
+        overrides,
+        patchList
+      });
     }
-  }
-  return entry;
-}
+  };
+  return builder;
+};
 function shareAll(config, opts = {}) {
   return shareAllCore(nodeIo, config, opts);
 }
@@ -251,32 +59,35 @@ function shareAllCore(io, config, opts = {}, repo = sharedPackageJsonRepository)
       if (!!opts.overrides && Object.keys(opts.overrides).some((o) => key.startsWith(o))) {
         continue;
       }
-      const inferVersion2 = !config.requiredVersion || config.requiredVersion === "auto";
-      const requiredVersion = inferVersion2 ? versions[key] : config.requiredVersion;
+      const inferVersion = !config.requiredVersion || config.requiredVersion === "auto";
+      const requiredVersion = inferVersion ? versions[key] : config.requiredVersion;
       if (!sharedExternals[key]) {
         sharedExternals[key] = { ...config, requiredVersion };
       }
     }
   }
+  const finalExternalList = applyPatchList(sharedExternals, opts.patchList, opts.overrides);
   return {
-    ...shareCore(io, sharedExternals, opts.projectPath, skipList, repo),
+    ...shareCore(io, finalExternalList, opts.projectPath, skipList, repo),
     ...!opts.overrides ? {} : shareCore(io, opts.overrides, opts.projectPath, skipList, repo)
   };
 }
-function inferProjectPath(projectPath) {
-  if (!projectPath && getConfigContext().packageJson) {
-    projectPath = path.dirname(getConfigContext().packageJson || "");
-  }
-  if (!projectPath && getConfigContext().workspaceRoot) {
-    projectPath = getConfigContext().workspaceRoot || "";
+function applyPatchList(sharedExternals, patchList, overrides) {
+  if (!patchList) {
+    return sharedExternals;
   }
-  if (!projectPath) {
-    projectPath = cwd();
+  const result = { ...sharedExternals };
+  for (const [external, cfg] of Object.entries(patchList)) {
+    if (!result[external]) {
+      const shadowedByOverride = !!overrides && Object.keys(overrides).some((o) => external.startsWith(o));
+      logger.warn(
+        shadowedByOverride ? `Ignoring patch for '${external}': it is already configured via 'overrides' ('patch' and 'overrides' are mutually exclusive per external).` : `Ignoring patch for '${external}': it is not a shared external (unknown dependency or skipped).`
+      );
+      continue;
+    }
+    result[external] = { ...result[external], ...cfg };
   }
-  return projectPath;
-}
-function setInferVersion(infer) {
-  inferVersion = infer;
+  return result;
 }
 function share(configuredShareObjects, projectPath = "", skipList = DEFAULT_SKIP_LIST) {
   return shareCore(nodeIo, configuredShareObjects, projectPath, skipList);
@@ -287,11 +98,10 @@ function shareCore(io, configuredShareObjects, projectPath = "", skipList = DEFA
   const preparedSkipList = prepareSkipList(skipList);
   const shareObjects = { ...configuredShareObjects };
   const result = {};
-  let includeSecondaries;
   for (const key in shareObjects) {
-    includeSecondaries = false;
+    let includeSecondaries = false;
     const shareObject = shareObjects[key];
-    if (shareObject.requiredVersion === "auto" || inferVersion && typeof shareObject.requiredVersion === "undefined" || shareObject.requiredVersion?.length < 1) {
+    if (shareObject.requiredVersion === "auto" || isInferVersion() && typeof shareObject.requiredVersion === "undefined" || (shareObject.requiredVersion?.length ?? 1) < 1) {
       const version = lookupVersion(key, projectPath, repo);
       shareObject.requiredVersion = version;
       shareObject.version = version.replace(/^\D*/, "");
@@ -302,7 +112,9 @@ function shareCore(io, configuredShareObjects, projectPath = "", skipList = DEFA
     if (shareObject.includeSecondaries) {
       includeSecondaries = shareObject.includeSecondaries;
       delete shareObject.includeSecondaries;
-      if (includeSecondaries?.keepAll) shareObject.includeSecondaries = true;
+      if (typeof includeSecondaries === "object" && includeSecondaries.keepAll) {
+        shareObject.includeSecondaries = true;
+      }
     }
     result[key] = shareObject;
     if (includeSecondaries) {
@@ -327,16 +139,8 @@ function shareCore(io, configuredShareObjects, projectPath = "", skipList = DEFA
   }
   return result;
 }
-function addSecondaries(secondaries, result) {
-  for (const key in secondaries) {
-    result[key] = secondaries[key];
-  }
-}
 export {
-  findRootTsConfigJson,
-  findRootTsConfigJsonCore,
-  getSecondaries,
-  setInferVersion,
+  fromPackageJson,
   share,
   shareAll,
   shareAllCore,

package/dist/lib/config/version-lookup.d.ts

@@ -0,0 +1,4 @@
+import type { PackageJsonRepository } from '../domain/utils/package-json.contract.js';
+export declare function setInferVersion(infer: boolean): void;
+export declare function isInferVersion(): boolean;
+export declare function lookupVersion(key: string, workspaceRoot: string, repo: PackageJsonRepository): string;

package/dist/lib/config/version-lookup.js

@@ -0,0 +1,37 @@
+import { getVersionMaps } from "../utils/package/package-info.js";
+let inferVersion = false;
+function setInferVersion(infer) {
+  inferVersion = infer;
+}
+function isInferVersion() {
+  return inferVersion;
+}
+function lookupVersion(key, workspaceRoot, repo) {
+  const versionMaps = getVersionMaps(workspaceRoot, workspaceRoot, repo);
+  for (const versionMap of versionMaps) {
+    const version = lookupVersionInMap(key, versionMap);
+    if (version) {
+      return version;
+    }
+  }
+  throw new Error(
+    `Shared Dependency ${key} has requiredVersion:'auto'. However, this dependency is not found in your package.json`
+  );
+}
+function lookupVersionInMap(key, versions) {
+  const parts = key.split("/");
+  if (parts.length >= 2 && parts[0].startsWith("@")) {
+    key = parts[0] + "/" + parts[1];
+  } else {
+    key = parts[0];
+  }
+  if (!versions[key]) {
+    return null;
+  }
+  return versions[key];
+}
+export {
+  isInferVersion,
+  lookupVersion,
+  setInferVersion
+};

package/dist/lib/config/with-native-federation.js

@@ -1,5 +1,6 @@
 import { getRawMappedPaths } from "./mapped-paths.js";
-import { shareAll, findRootTsConfigJson } from "./share-utils.js";
+import { fromPackageJson } from "./share-utils.js";
+import { findRootTsConfigJson } from "./project-paths.js";
 import { isInSkipList, prepareSkipList } from "./default-skip-list.js";
 import { logger } from "../utils/logger.js";
 function withNativeFederation(config) {
@@ -18,6 +19,7 @@ function withNativeFederation(config) {
       mappingVersion: config.features?.mappingVersion ?? true,
       ignoreUnusedDeps: config.features?.ignoreUnusedDeps ?? true,
       denseChunking: config.features?.denseChunking ?? false,
+      denseExternals: config.features?.denseExternals ?? false,
       integrityHashes: config.features?.integrityHashes ?? false
     },
     ...config.shareScope && { shareScope: config.shareScope }
@@ -35,12 +37,12 @@ function normalizeExposes(exposes) {
 }
 function normalizeShared(config, skip, chunks) {
   let result = {};
-  const shared = config.shared ?? shareAll({
+  const shared = config.shared ?? fromPackageJson({
     singleton: true,
     strictVersion: true,
     requiredVersion: "auto",
     platform: "browser"
-  });
+  }).get();
   result = Object.keys(shared).reduce((acc, cur) => {
     const key = cur.replace(/\\/g, "/");
     const sharedConfig = shared[cur];
@@ -60,7 +62,8 @@ function normalizeShared(config, skip, chunks) {
       packageInfo: sharedConfig.packageInfo,
       platform: sharedConfig.platform ?? config.platform ?? "browser",
       build: sharedConfig.build ?? "default",
-      ...sharedConfig.shareScope && { shareScope: sharedConfig.shareScope }
+      ...sharedConfig.shareScope && { shareScope: sharedConfig.shareScope },
+      ...sharedConfig.pool && { pool: sharedConfig.pool }
     };
     return {
       ...acc,

package/dist/lib/core/build/build-for-federation.js

@@ -4,10 +4,11 @@ import {
   describeSharedMappings
 } from "./bundle-exposed-and-mappings.js";
 import { bundleShared } from "./bundle-shared.js";
+import { densifyExternals } from "../output/densify-externals.js";
 import { writeFederationInfo } from "../output/write-federation-info.js";
 import { writeImportMap } from "../output/write-import-map.js";
 import { logger } from "../../utils/logger.js";
-import { normalizePackageName } from "../../utils/normalize.js";
+import { inferPackageFromSecondary, normalizePackageName } from "../../utils/normalize.js";
 import { AbortedError } from "../../utils/errors.js";
 import { addExternalsToCache } from "../cache/federation-cache.js";
 import path from "path";
@@ -97,10 +98,11 @@ async function buildForFederation(config, fedOptions, externals, signal) {
       if (!external.shareScope) external.shareScope = config.shareScope;
     });
   }
+  const shared = config.features.denseExternals ? densifyExternals(sharedExternals) : sharedExternals;
   const buildNotificationsEndpoint = fedOptions.buildNotifications?.enable && fedOptions.dev ? fedOptions.buildNotifications?.endpoint : void 0;
   const federationInfo = {
     name: config.name,
-    shared: sharedExternals,
+    shared,
     exposes: exposedInfo,
     buildNotificationsEndpoint
   };
@@ -120,13 +122,6 @@ async function buildForFederation(config, fedOptions, externals, signal) {
   writeImportMap(fedOptions.federationCache, fedOptions, federationInfo.integrity);
   return federationInfo;
 }
-function inferPackageFromSecondary(secondary) {
-  const parts = secondary.split("/");
-  if (secondary.startsWith("@") && parts.length >= 2) {
-    return parts[0] + "/" + parts[1];
-  }
-  return parts[0];
-}
 async function bundleSeparatePackages(separateBrowser, externals, config, fedOptions, buildOptions) {
   const groupedByPackage = {};
   for (const [key, shared] of Object.entries(separateBrowser)) {

package/dist/lib/core/build/bundle-shared.js

@@ -193,13 +193,8 @@ function buildResult(packageInfos, sharedBundles, outFileNames) {
       singleton: shared?.singleton,
       strictVersion: shared?.strictVersion,
       version: pi.version,
-      ...shared?.shareScope && { shareScope: shared.shareScope }
-      // TODO: Decide whether/when we need debug infos
-      // dev: !fedOptions.dev
-      //   ? undefined
-      //   : {
-      //       entryPoint: normalize(pi.entryPoint),
-      //     },
+      ...shared?.shareScope && { shareScope: shared.shareScope },
+      ...shared?.pool && { pool: shared.pool }
     };
   });
 }
@@ -212,14 +207,12 @@ function addChunksToResult(chunks, result) {
     result.push({
       singleton: false,
       strictVersion: false,
-      // Here, the version does not matter because
+      // Here, the version, singleton and strictversion
+      // do not matter because
       // a) a chunk split off by the bundler does
       // not have a version and b) it gets a hash
       // code as part of the file name to be unique
       // when requested via a _versioned_ package.
-      //
-      // For the same reason, we don't need to
-      // take care of singleton and strictVersion.
       version: "0.0.0",
       requiredVersion: "0.0.0",
       packageName: toChunkImport(fileName),

package/dist/lib/core/output/densify-externals.d.ts

@@ -0,0 +1,8 @@
+import type { SharedInfo, DenseSharedInfo } from '../../domain/core/federation-info.contract.js';
+/**
+ * Groups a flat `shared` array into {@link DenseSharedInfo} objects: one per shared external,
+ * with an `entries` map from each import name to its output file. Entries sharing a parent
+ * package but with differing metadata split into separate groups. Bundler chunks and
+ * already-dense entries pass through unchanged.
+ */
+export declare function densifyExternals(shared: Array<SharedInfo | DenseSharedInfo>): Array<SharedInfo | DenseSharedInfo>;

package/dist/lib/core/output/densify-externals.js

@@ -0,0 +1,49 @@
+import { CHUNK_PREFIX } from "../../domain/core/chunk.js";
+import { inferPackageFromSecondary } from "../../utils/normalize.js";
+function isDense(entry) {
+  return "entries" in entry;
+}
+function isChunk(entry) {
+  return entry.packageName.startsWith(CHUNK_PREFIX + "/");
+}
+function densifyExternals(shared) {
+  const result = [];
+  const groupIndex = /* @__PURE__ */ new Map();
+  for (const entry of shared) {
+    if (isDense(entry) || isChunk(entry)) {
+      result.push(entry);
+      continue;
+    }
+    const parent = inferPackageFromSecondary(entry.packageName);
+    const sig = JSON.stringify({
+      singleton: entry.singleton,
+      strictVersion: entry.strictVersion,
+      requiredVersion: entry.requiredVersion,
+      version: entry.version,
+      shareScope: entry.shareScope
+    });
+    const key = parent + " " + sig;
+    const existing = groupIndex.get(key);
+    if (existing === void 0) {
+      const dense = {
+        singleton: entry.singleton,
+        strictVersion: entry.strictVersion,
+        requiredVersion: entry.requiredVersion,
+        packageName: parent,
+        entries: { [entry.packageName]: entry.outFileName }
+      };
+      if (entry.version !== void 0) dense.version = entry.version;
+      if (entry.shareScope !== void 0) dense.shareScope = entry.shareScope;
+      if (entry.bundle !== void 0) dense.bundle = entry.bundle;
+      if (entry.dev !== void 0) dense.dev = entry.dev;
+      groupIndex.set(key, result.length);
+      result.push(dense);
+    } else {
+      result[existing].entries[entry.packageName] = entry.outFileName;
+    }
+  }
+  return result;
+}
+export {
+  densifyExternals
+};

package/dist/lib/domain/config/external-config.contract.d.ts

@@ -11,6 +11,7 @@ export interface ExternalConfig {
     includeSecondaries?: IncludeSecondariesOptions;
     platform?: 'browser' | 'node';
     build?: 'separate' | 'package';
+    pool?: string;
     chunks?: boolean;
     shareScope?: string;
     packageInfo?: {
@@ -26,6 +27,7 @@ export interface NormalizedExternalConfig {
     version?: string;
     includeSecondaries?: boolean;
     shareScope?: string;
+    pool?: string;
     chunks: boolean;
     platform: 'browser' | 'node';
     build: 'default' | 'separate' | 'package';

package/dist/lib/domain/config/federation-config.contract.d.ts

@@ -19,6 +19,7 @@ export interface FederationConfig {
         mappingVersion?: boolean;
         ignoreUnusedDeps?: boolean;
         denseChunking?: boolean;
+        denseExternals?: boolean;
         integrityHashes?: boolean;
     };
 }
@@ -36,6 +37,7 @@ export interface NormalizedFederationConfig {
         mappingVersion: boolean;
         ignoreUnusedDeps: boolean;
         denseChunking: boolean;
+        denseExternals: boolean;
         integrityHashes: boolean;
     };
 }

package/dist/lib/domain/core/federation-info.contract.d.ts

@@ -1,11 +1,14 @@
 export interface FederationInfo {
     name: string;
     exposes: ExposesInfo[];
-    shared: SharedInfo[];
+    shared: Array<SharedInfo | DenseSharedInfo>;
     chunks?: Record<string, string[]>;
     integrity?: IntegrityMap;
     buildNotificationsEndpoint?: string;
 }
+export type DenseSharedInfo = Omit<SharedInfo, 'outFileName'> & {
+    entries: Record<string, string>;
+};
 export type SharedInfo = {
     singleton: boolean;
     strictVersion: boolean;
@@ -13,6 +16,7 @@ export type SharedInfo = {
     version?: string;
     packageName: string;
     shareScope?: string;
+    pool?: string;
     bundle?: string;
     outFileName: string;
     dev?: {

package/dist/lib/domain/core/index.d.ts

@@ -1,4 +1,4 @@
-export type { SharedInfo, FederationInfo, ExposesInfo, ArtifactInfo, ChunkInfo, IntegrityMap, } from './federation-info.contract.js';
+export type { SharedInfo, DenseSharedInfo, FederationInfo, ExposesInfo, ArtifactInfo, ChunkInfo, IntegrityMap, } from './federation-info.contract.js';
 export { type BuildNotificationOptions, BuildNotificationType, } from './build-notification-options.contract.js';
 export type { FederationOptions, NormalizedFederationOptions, } from './federation-options.contract.js';
 export type { EntryPoint, NFBuildAdapterOptions, NFBuildAdapter, NFBuildAdapterResult, NFBuildAdapterContext, } from './build-adapter.contract.js';

package/dist/lib/utils/normalize.d.ts

@@ -1,2 +1,3 @@
 export declare function normalize(path: string, trailingSlash?: boolean): string;
 export declare function normalizePackageName(fileName: string): string;
+export declare function inferPackageFromSecondary(secondary: string): string;

package/dist/lib/utils/normalize.js

@@ -16,7 +16,15 @@ function normalizePackageName(fileName) {
   const sanitized = fileName.replace(/[^A-Za-z0-9]/g, "_");
   return sanitized.startsWith("_") ? sanitized.slice(1) : sanitized;
 }
+function inferPackageFromSecondary(secondary) {
+  const parts = secondary.split("/");
+  if (secondary.startsWith("@") && parts.length >= 2) {
+    return parts[0] + "/" + parts[1];
+  }
+  return parts[0];
+}
 export {
+  inferPackageFromSecondary,
   normalize,
   normalizePackageName
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softarc/native-federation",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "type": "module",
   "license": "MIT",
   "scripts": {