v4.9.0

[Aukevanoost]

Highlights

This minor is focussed on stabilizing our new 4.8.0 direction (check out the non-stitching announcement), and at the same time generalizing the core into something usable for all bundlers/adapters. This was already the case but we're working towards improving the build flows and making them a bit more adaper agnostic.

Declare shared mapping packages

Until now, a shared mapping's package came from its name: @shared/components/table and @shared/components/collapse counted as two entry points of one package, @shared/components. In a workspace where slashes mark a domain rather than a package, that grouped independent libraries together. With mappingsFromWorkspace().package(prefix, cfg) you declare the boundaries yourself. Every mapping at or under the prefix belongs to that package, the longest declaration wins, and mappings outside any declaration keep the name rule. A declared package gets one config, and its entry points are checked for a matching version before anything is bundled.

chunks per shared mapping

chunks can now be set on a shared mapping and applies to the bundle the mapping is built in. Mappings that don't set it follow the global value, and two mappings in one bundle t]hat disagree fail the build instead of one setting being silently dropped. A chunks setting on a shared external that can't take effect now warns, and is part of the cache key.

A sturdier adapter contract

Adapters get more ways to tell core what they did, and core checks more of what they write:

• an adapter can declare the externals it adds itself, such as a dev client or polyfill, so users don't have to list them;
• an adapter can name the entry each output was built from, so core no longer has to guess from hashed file names;
• setup is told which kind of bundle it builds (shared, mapping or exposed);
• an adapter can store data alongside a cached shared bundle and read it back when the cache is hit;
• output is checked where core reads it and once more before remoteEntry.json is written, so a missing or misplaced file fails early.

More reliable builds

• Every file a build writes is reported (federationBuilder.outputFiles). The check for bare imports the import map can't resolve now scans all of them, chunks not named in remoteEntry.json included, and in watch mode no longer repeats unchanged warnings.
• A failed shared bundle run keeps the last complete set of externals, and initialising federationBuilder again runs a full build.
• Nested exposes with the same file name (./a/Cmp, ./b/Cmp) each get their own file. A build also warns when two mappings would write the same file.
• Source maps stay valid when chunks are renamed by content.

Heads-up

• esbuild is no longer a dependency of core. Adapters that use it must depend on it themselves.
• isMappingOrExposed and optimizedMappings are deprecated in favour of the bundle kind, and will be removed in v5.

What's Changed

• fix: Report every file a federation build writes and scan non-dense chunks by @Aukevanoost in fix: Report every file a federation build writes and scan non-dense chunks #178
• fix: Keep the last complete externals when a shared bundle run fails by @Aukevanoost in fix: Keep the last complete externals when a shared bundle run fails #190
• fix: Report output files the bare import check could not scan by @Aukevanoost in fix: Report output files the bare import check could not scan #181
• refactor: Define how core matches externals in one helper by @Aukevanoost in refactor: Define how core matches externals in one helper #183
• fix: Clean up the bare import diagnosis and stop repeating unchanged warnings by @Aukevanoost in fix: Clean up the bare import diagnosis and stop repeating unchanged warnings #184
• feat: Let an adapter declare externals of its own by @Aukevanoost in feat: Let an adapter declare externals of its own #185
• fix: Run a full build after federationBuilder is initialised again by @Aukevanoost in fix: Run a full build after federationBuilder is initialised again #199
• fix: Give nested exposes their own file, and let an adapter name its entries by @Aukevanoost in fix: Give nested exposes their own file, and let an adapter name its entries #200
• fix: Rewrite only reported chunks, and follow backtick chunk imports by @Aukevanoost in fix: Rewrite only reported chunks, and follow backtick chunk imports #201
• fix: Keep source maps valid when chunks are renamed by content, and read base64url hashes by @Aukevanoost in fix: Keep source maps valid when chunks are renamed by content, and read base64url hashes #202
• fix: Dispose a failed shared build, and state the adapter lifecycle in the contract by @Aukevanoost in fix: Dispose a failed shared build, and state the adapter lifecycle in the contract #203
• fix: Check adapter output where core reads it, and before remoteEntry.json by @Aukevanoost in fix: Check adapter output where core reads it, and before remoteEntry.json #204
• refactor: Let each mapping bundle plan carry its chunks setting by @Aukevanoost in refactor: Let each mapping bundle plan carry its chunks setting #205
• fix: Warn when two mappings, or a mapping and an exposed module, share an output file by @Aukevanoost in fix: Warn when two mappings, or a mapping and an exposed module, share an output file #209
• feat: Take a shared mapping's package from the tsconfig paths keys with build: 'paths' by @Aukevanoost in feat: Take a shared mapping's package from the tsconfig paths keys with build: 'paths' #208
• chore(deps): update dependency vite to ^8.3.4 by @renovate[bot] in chore(deps): update dependency vite to ^8.3.4 #211
• feat!: Declare shared mapping packages with mappingsFromWorkspace().package(prefix, cfg), replacing build: 'paths' by @Aukevanoost in feat!: Declare shared mapping packages with mappingsFromWorkspace().package(prefix, cfg), replacing build: 'paths' #214
• feat: chunks on shared mappings; declared packages bundle like any other mapping by @Aukevanoost in feat: chunks on shared mappings; declared packages bundle like any other mapping #215
• fix: Report chunks a shared external cannot apply, and key the cache on it by @Aukevanoost in fix: Report chunks a shared external cannot apply, and key the cache on it #217
• feat: Tell the adapter which kind of bundle it builds, and deprecate isMappingOrExposed and optimizedMappings by @Aukevanoost in feat: Tell the adapter which kind of bundle it builds, and deprecate isMappingOrExposed and optimizedMappings #218
• chore: Core no longer depends on esbuild by @Aukevanoost in chore: Core no longer depends on esbuild #219
• feat: Let the adapter store data with a cached shared bundle by @Aukevanoost in feat: Let the adapter store data with a cached shared bundle #220
• chore(deps): update pnpm to v11.28.8 by @renovate[bot] in chore(deps): update pnpm to v11.28.8 #212

Full Changelog: v4.8.1...v4.9.0

---

This discussion was created from the release v4.9.0.