Paul Gschwendtner
4886585875
Creates, a currently still unused, Bazel transition that will control a build setting that is enabling the partial compilation mode for `ng_module` rule targets. This is in preparation of implementing the Angular Package Format v13 (which should ship in partial compilation). Note: Various other approaches aside from the `transition` has been considered. Here is a small summary of the largest ideas that have been tried for the APF v13 partial compilation refactor. **Using an aspect for partial compilation in `ng_package`** Similar to how we had an aspect for ESM5 compilation in the past, an aspect could be used to create partial compilation prodmode output for packaging. The aspect would take the existing prodmode compilation details and "replay" the compilation with a modified tsconfig that enables partial compilation. This _can_ work but requires lots of caution and is very prone to issues. In order to avoid conflicts with the existing prodmode output, the partial compilation outputs would need to be written to a sub-directory. This makes module resolution extremely difficult when `ng_package` creates the FESM bundles. Also it is difficult to merge multiple of these aspect-compiled folders into a single one for exposing the non-bundled ESM output. It becomes especially difficult to ensure that such an aspect target will actually use the _correct_ dependency type definition when compiled. e.g. consider a case where a partial compiled target relies on another Angular target. The dependency will be compiled partially first, but the other target _needs_ to rely on the partial compilation `d.ts` output of the dependency (and *NOT* the devmode `.d.ts` output). This is incorrect and can cause other type-checking issues / or invalid output. To make this work, the module resolution when invoking tsc_wrapped would also need to be updated/patched. This is out of scope and not reasonable to maintain. **Exposing a third output flavor directly in the rule** Instead of replying a compilation, we could expose an output flavor next to `devmode` and `prodmode`. This sounded like the easiest solution at first, but it will have the same problems as the aspect approach (in terms of module resoltion and avoiding conflicts of files). We cannot control how TS emits `.d.ts` or `.js` files (without patching into the compiler host), so we would need to store the compilation output in a sub-folder similar to the aspect.. resulting in the same issues. This is do-able but would require module resolution to be patched and we do not have control over `@bazel/typescript`. Also, `@bazel/typescript` does not forsee a third output flavor, so that logic would need to be changed significantly as well. PR Close #43431
Angular - The modern web developer's platform.
Angular is a development platform for building mobile and desktop web applications
using Typescript/JavaScript and other languages.
Contributing Guidelines
·
Submit an Issue
·
Blog
Documentation
Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.
Advanced
Development Setup
Prerequisites
- Install Node.js which includes Node Package Manager
Setting Up a Project
Install the Angular CLI globally:
npm install -g @angular/cli
Create workspace:
ng new [PROJECT NAME]
Run the application:
cd [PROJECT NAME]
ng serve
Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.
Quickstart
Ecosystem
Changelog
Learn about the latest improvements.
Upgrading
Check out our upgrade guide to find out the best way to upgrade your project.
Contributing
Contributing Guidelines
Read through our contributing guidelines to learn about our submission process, coding rules and more.
Want to Help?
Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.
Code of Conduct
Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.
Community
Join the conversation and help the community.
Love Angular? Give our repo a star ⭐ ⬆️.