@gravity-ui/app-builder 0.32.0 → 0.32.2

package/README.md

@@ -407,12 +407,22 @@ Module Federation is a Webpack 5 feature that enables micro-frontend architectur
     - Allows selective enabling/disabling of specific remotes during development
     - Useful for debugging, testing individual micro-frontends, or working with partial system setups
     - Helps reduce development startup time by loading only needed remotes
-    - Can be overridden via CLI flag: `--mf-remotes=header,footer`
+    - Can be overridden via CLI flag: `--mf-remotes header footer`
 
     **Loading behavior:**
 
-    - **Enabled remotes**: Loaded from local development server (auto-started by app-builder)
-    - **Disabled remotes**: Loaded from CDN (if `publicPathPrefix` or CDN configuration is available), allowing you to use stable production versions while developing specific parts locally
+    **When CDN is disabled:**
+
+    - **Enabled remotes**: Loaded from local development server with version-specific paths
+    - **Disabled remotes**: Loaded from `cdnPublicPath` (if configured), otherwise fallback to local paths
+
+    **When CDN is enabled:**
+
+    - **All remotes**: Use common public path, `enabledRemotes` selection has no effect on URLs
+
+    **In production builds:**
+
+    - This option is completely ignored, all configured remotes are included in the bundle
 
     **Example:**
 
@@ -428,7 +438,7 @@ Module Federation is a Webpack 5 feature that enables micro-frontend architectur
 
     ```bash
     # Override enabledRemotes from command line
-    npx app-builder dev --mf-remotes=header,navigation
+    npx app-builder dev --mf-remotes header navigation
     ```
 
     **Note:** This option has no effect in production builds - all configured remotes will be included in the production bundle configuration.
@@ -475,6 +485,12 @@ Module Federation is a Webpack 5 feature that enables micro-frontend architectur
     - **Rollback capability**: Can load specific versions of remotes
     - **Deployment safety**: Gradual rollouts with version-specific remote loading
 
+    **Important considerations:**
+
+    - **Without CDN**: Version is inlined immediately during build time, as single build cannot contain multiple application versions
+    - **With CDN**: True runtime versioning is possible, versions are resolved dynamically at runtime
+    - **Recommendation**: Use `remotesRuntimeVersioning` together with CDN configuration for full dynamic versioning capabilities
+
     **Example with versioning enabled:**
 
     ```ts
@@ -690,7 +706,7 @@ export default defineConfig({
 npx app-builder dev
 
 # Start host with only specific remotes (faster development)
-npx app-builder dev --mf-remotes=header,sidebar
+npx app-builder dev --mf-remotes header sidebar
 
 # The above is equivalent to setting enabledRemotes in config:
 # enabledRemotes: ['header', 'sidebar']

package/dist/common/config.js

@@ -196,8 +196,8 @@ async function normalizeClientConfig(client, mode) {
     let publicPath = client.publicPath || path.normalize(`${client.publicPathPrefix || ''}/build/`);
     let browserPublicPath = (mode !== 'dev' && cdnConfig?.publicPath) || publicPath;
     if (client.moduleFederation) {
-        publicPath = path.normalize(`${publicPath}${client.moduleFederation.name}/`);
-        browserPublicPath = path.normalize(`${browserPublicPath}${client.moduleFederation.name}/`);
+        publicPath = `${publicPath}${client.moduleFederation.name}/`;
+        browserPublicPath = `${browserPublicPath}${client.moduleFederation.name}/`;
     }
     let transformCssWithLightningCss = Boolean(client.transformCssWithLightningCss);
     if (client.moduleFederation?.isolateStyles && transformCssWithLightningCss) {

package/dist/common/webpack/config.js

@@ -963,8 +963,9 @@ function configureCommonPlugins(options, bundlerPlugins) {
         }
         plugins.push(createMomentTimezoneDataPlugin(config.momentTz));
         if (config.moduleFederation) {
-            const { name, version, disableManifest, remotes, enabledRemotes = remotes, originalRemotes, remotesRuntimeVersioning, isolateStyles: _isolateStyles, // Omit isolateStyles from restOptions
+            const { name, version, disableManifest, remotes, originalRemotes, remotesRuntimeVersioning, isolateStyles: _isolateStyles, // Omit isolateStyles from restOptions
             runtimePlugins, ...restOptions } = config.moduleFederation;
+            const enabledRemotes = (isEnvDevelopment && config.moduleFederation.enabledRemotes) || remotes;
             let actualRemotes = originalRemotes;
             if (!actualRemotes && remotes && enabledRemotes) {
                 // Remove micro-frontend name from public path
@@ -986,7 +987,8 @@ function configureCommonPlugins(options, bundlerPlugins) {
                 }
                 actualRemotes = remotes.reduce((acc, remote) => {
                     let remotePath;
-                    if (isEnvDevelopment) {
+                    // Use local paths when CDN is disabled, regardless of environment
+                    if (!config.cdn) {
                         if (enabledRemotes.includes(remote)) {
                             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                             remotePath = `${commonPublicPath}${remote}/${remoteFile.replace('[version]', version)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravity-ui/app-builder",
-  "version": "0.32.0",
+  "version": "0.32.2",
   "description": "Develop and build your React client-server projects, powered by typescript and webpack",
   "license": "MIT",
   "type": "commonjs",