@@ -6,6 +6,7 @@ This benchmark measures build time metrics for Angular libraries.
66
77Angular CLI is in the process of transitioning from ` ng-packagr ` to Angular CLI's native library builder.
88Both library build systems are registered Architect builders:
9+
910- ` @angular/build:ng-packagr ` : runs library builds through the legacy ` ng-packagr ` build pipeline.
1011- ` @angular/build:library ` : runs library builds through Angular CLI's native library builder.
1112
@@ -22,6 +23,7 @@ as the number of entry points scale past a certain N (in the test runs N=200+).
2223[ Landing Angular CLI's native ` @angular/build:library ` builder] ( https://github.com/angular/angular-cli/pull/34106#issuecomment-5744311681 ) ,
2324indicated very favourable performance metrics for the new library builder that can be explained by number of
2425architectural changes in the library build pipeline:
26+
2527- Shared Stylesheet Bundling
2628- Public API Invalidation via Declaration Hashing
2729- Dedicated Worker Pool for Production Builds
@@ -83,13 +85,13 @@ pnpm admin benchmark library-builder [options]
8385
8486### Options
8587
86- | Option | Description | Default |
87- | :--------------------- | :----------------------------------------------- | :- --------------------------------------- |
88- | ` --layout=<flat\|deep> ` | Fixture layout | ` flat ` |
89- | ` --count=<n,n,...> ` | Entry-point count targets, drives both layouts | ` 10,20,50,100,200,300,400,500,1000,2000 ` |
90- | ` --depth=<n,n,...> ` | ** ` layout=deep ` only.** Explicit tree depths, overriding the depths otherwise derived from ` --count ` | derived from ` --count ` |
91- | ` --iterations=<n> ` | Measured iterations per size | ` 3 ` |
92- | ` --json ` | Output raw measurements as JSON | N/A |
88+ | Option | Description | Default |
89+ | :---------------------- | :--------------------------------------------------------------------------------------------------- | :--------------------------------------- |
90+ | ` --layout=<flat\|deep> ` | Fixture layout | ` flat ` |
91+ | ` --count=<n,n,...> ` | Entry-point count targets, drives both layouts | ` 10,20,50,100,200,300,400,500,1000,2000 ` |
92+ | ` --depth=<n,n,...> ` | ** ` layout=deep ` only.** Explicit tree depths, overriding the depths otherwise derived from ` --count ` | derived from ` --count ` |
93+ | ` --iterations=<n> ` | Measured iterations per size | ` 3 ` |
94+ | ` --json ` | Output raw measurements as JSON | N/A |
9395
9496> ` --count ` and ` --depth ` are not independent sweep axes for ` layout=deep ` : ` --count ` is translated
9597> into depths (smallest ` depth ` with ` 2^depth >= n ` per target, de-duplicated); ` --depth ` only
0 commit comments