docs(nf): remove infos about transient flag from readme and share-faq

Author: manfredsteyer

libs/native-federation-core/src/lib/config/share-utils.ts

@@ -385,12 +385,8 @@ function findTransientDeps(
       logger.warn(
         'is deprecated. Please remove it. Meanwhile, Native Federation'
       );
-      logger.warn(
-        'uses the underlying bundler for splitting transient'
-      );
-      logger.warn(
-        'dependencies into separate chunks, _when_ necessary.'
-      )
+      logger.warn('uses the underlying bundler for splitting transient');
+      logger.warn('dependencies into separate chunks, _when_ necessary.');
       const packagePath = path.join(
         projectRoot,
         'node_modules',

libs/native-federation-core/src/lib/core/build-adapter.js

@@ -249,6 +249,14 @@ function addChunksToResult(
     result.push({
       singleton: false,
       strictVersion: false,
+      // Here, the version does 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.
       requiredVersion: '0.0.0',
       version: '0.0.0',
       packageName: fileName,

libs/native-federation-core/src/lib/core/build-adapter.js.map

@@ -391,28 +391,6 @@ For this, there are several reasons:
 
 The good message is, that the official Angular Package Format defines the usage of ECMA Script Modules (ESM) for years. This is the future-proof standard, Native Federation is built upon and all npm packages created with the Angular CLI follow. If you use older CommonJS-based packages, Native Federation automatically converts them to ESM. Depending on the package, this might change some details. Here, you find some [information for dealing with CommonJS packages](https://shorturl.at/jmzH0).
 
-### How to Deal with Transitive Dependencies?
-
-Since version >=18.2.7, transitive dependencies can also be shared. For instance, `primeng` uses a lib `@primeuix/styled` for theming. The latter one is now shared too if `primeng` is. This prevents possible challenges but also results in more bundles.
-
-To activate sharing transient dependencies, set the new `transient` flag provided by `share` and `shareAll` to `true`:
-
-```js
-module.exports = withNativeFederation({
-  shared: {
-    ...shareAll({
-      singleton: true,
-      strictVersion: true,
-      requiredVersion: 'auto',
-      transient: true
-    }),
-  },
-  [...]
-});
-```
-
-The `skip` list will also be used for filtering transient dependencies. Hence, you can combine it with `shareAll` and `transient: true`.
-
 ### How to Manually Define a Package's Entry Point?
 
 Usually, Native Federation automatically detects entry points in shared packages. If the packages neither align with the official standard nor with typical conventions beyond these standards, you can also directly provide the entry point:

libs/native-federation-core/src/lib/core/bundle-shared.ts

@@ -68,28 +68,6 @@ skip: [
 
 Please note, that a provided string is fully compared (not with startsWith semantic). Hence, in this example shown, `this-package` is excluded but not secondary entry points like `this-package/interop`.
 
-## Transitive Dependencies
-
-Since version 18@latest, also transitive dependencies can be shared. For instance, `primeng` uses a lib `@primeuix/styled` for theming. The latter one is now shared too if `primeng` is. This prevents possible challanges but also results in more bundles. 
-
-To activate sharing transient dependencies, set the new `transient` flag provided by `share` and `shareAll` to `true`:
-
-```js
-module.exports = withNativeFederation({
-  shared: {
-    ...shareAll({ 
-      singleton: true, 
-      strictVersion: true, 
-      requiredVersion: 'auto', 
-      transient: true 
-    }),
-  },
-  [...]
-});
-```
-
-The `skip` list will also be used for filtering transient dependencies. Hence, you can combine it with `shareAll` and `transient: true`.
-
 ## Manually Providing a Package's Entry Point
 
 Usually, Native Federation automatically detects entry points into shared packages. If the packages neither align with the official standard nor with typical conventions beyond these standards, you can also directly provide the entry point:

libs/native-federation/README.md

@@ -1,6 +1,6 @@
 {
   "name": "@angular-architects/native-federation",
-  "version": "19.0.19",
+  "version": "19.0.20",
   "main": "src/index.js",
   "generators": "./collection.json",
   "builders": "./builders.json",