angular/packages/compiler-cli/src/ngcc
Alex Rickabaugh c1392ce618 feat(ivy): produce and consume ES2015 re-exports for NgModule re-exports (#28852)
In certain configurations (such as the g3 repository) which have lots of
small compilation units as well as strict dependency checking on generated
code, ngtsc's default strategy of directly importing directives/pipes into
components will not work. To handle these cases, an additional mode is
introduced, and is enabled when using the FileToModuleHost provided by such
compilation environments.

In this mode, when ngtsc encounters an NgModule which re-exports another
from a different file, it will re-export all the directives it contains at
the ES2015 level. The exports will have a predictable name based on the
FileToModuleHost. For example, if the host says that a directive Foo is
from the 'root/external/foo' module, ngtsc will add:

```
export {Foo as ɵng$root$external$foo$$Foo} from 'root/external/foo';
```

Consumers of the re-exported directive will then import it via this path
instead of directly from root/external/foo, preserving strict dependency
semantics.

PR Close #28852
2019-02-22 12:15:58 -08:00
..
src feat(ivy): produce and consume ES2015 re-exports for NgModule re-exports (#28852) 2019-02-22 12:15:58 -08:00
test feat(ivy): use fileNameToModuleName to emit imports when it's available (#28523) 2019-02-13 19:13:11 -08:00
BUILD.bazel refactor(ivy): extract selector scope logic to a new ngtsc package (#28852) 2019-02-22 12:15:58 -08:00
index.ts feat(ivy): ngcc project skeleton (#24897) 2018-07-27 17:15:31 -07:00
main-ngcc.ts feat(ivy): ngcc project skeleton (#24897) 2018-07-27 17:15:31 -07:00
README.md style: change to American English (#27266) 2019-01-29 16:30:25 -08:00

Angular Compatibility Compiler (ngcc)

This compiler will convert node_modules compiled with ngc, into node_modules which appear to have been compiled with ngtsc.

This conversion will allow such "legacy" packages to be used by the Ivy rendering engine.

Building

The project is built using Bazel:

yarn bazel build //packages/compiler-cli/src/ngcc

Unit Testing

The unit tests are built and run using Bazel:

yarn bazel test //packages/compiler-cli/src/ngcc/test

Integration Testing

There are tests that check the behavior of the overall executable:

yarn bazel test //packages/compiler-cli/test/ngcc