refactor(ngcc): fix typos in comments (#37040)
This is a follow-up to #36944, because I didn't manage to finish my review before the PR got merged. PR Close #37040
This commit is contained in:
parent
31796e8e2f
commit
469d2b4640
|
@ -64,13 +64,14 @@ ts_library(
|
||||||
],
|
],
|
||||||
)
|
)
|
||||||
|
|
||||||
# As of version 10, the release packages do not contain esm2015 output anymore. The ngcc
|
# As of version 10, the release packages do not contain esm5 output anymore. The ngcc integration
|
||||||
# integration tests intend to test ES5 features though, so we downlevel the flat esm2015
|
# tests intend to test ES5 features though, so we downlevel the flat esm2015 file to ES5 using
|
||||||
# file to ES5 using Babel. We can then link that into the mock file system as if the Angular
|
# Babel. We can then link that into the mock file system as if the Angular core package is still
|
||||||
# core package is still built with previous APF versions where esm5 output was shipped. This
|
# built with previous APF versions where esm5 output was shipped. This allows us to ensure that ngcc
|
||||||
# allows us to ensure that ngcc properly processes libraries with esm5 output. **Note**: We are
|
# properly processes libraries with esm5 output.
|
||||||
# using Babel instead of `tsc` as TypeScript does not allow us to downlevel the file without
|
# **Note**: We are using Babel instead of `tsc` as TypeScript does not allow us to downlevel the
|
||||||
# setting the module resolution to either `amd` or `system`. We want to preserve ES modules.
|
# file without setting the module resolution to either `amd` or `system`. We want to preserve ES
|
||||||
|
# modules.
|
||||||
babel(
|
babel(
|
||||||
name = "fesm5_angular_core",
|
name = "fesm5_angular_core",
|
||||||
outs = ["fesm5_angular_core.js"],
|
outs = ["fesm5_angular_core.js"],
|
||||||
|
|
|
@ -20,8 +20,8 @@ export type PackageSources = {
|
||||||
/**
|
/**
|
||||||
* Instead of writing packaged code by hand, and manually describing the layout of the package, this
|
* Instead of writing packaged code by hand, and manually describing the layout of the package, this
|
||||||
* function transpiles the TypeScript sources into a flat file structure using the ES5 format. In
|
* function transpiles the TypeScript sources into a flat file structure using the ES5 format. In
|
||||||
* this package layout, all compiled sources are at the root of the package, with .d.ts files next
|
* this package layout, all compiled sources are at the root of the package, with `.d.ts` files next
|
||||||
* to the .js files. Each .js also has a corresponding .metadata.js file alongside with it.
|
* to the `.js` files. Each `.js` also has a corresponding `.metadata.json` file alongside with it.
|
||||||
*
|
*
|
||||||
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
||||||
* in testing ngcc.
|
* in testing ngcc.
|
||||||
|
@ -41,7 +41,7 @@ export function compileIntoFlatEs5Package(pkgName: string, sources: PackageSourc
|
||||||
* Instead of writing packaged code by hand, and manually describing the layout of the package,
|
* Instead of writing packaged code by hand, and manually describing the layout of the package,
|
||||||
* this function transpiles the TypeScript sources into a flat file structure using the ES2015
|
* this function transpiles the TypeScript sources into a flat file structure using the ES2015
|
||||||
* format. In this package layout, all compiled sources are at the root of the package, with
|
* format. In this package layout, all compiled sources are at the root of the package, with
|
||||||
* `.d.ts` files next to the `.js` files. Each `.js` also has a corresponding `.metadata.js`
|
* `.d.ts` files next to the `.js` files. Each `.js` also has a corresponding `.metadata.json`
|
||||||
* file alongside with it.
|
* file alongside with it.
|
||||||
*
|
*
|
||||||
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
||||||
|
@ -78,8 +78,8 @@ export interface FlatLayoutOptions {
|
||||||
/**
|
/**
|
||||||
* Instead of writing packaged code by hand, and manually describing the layout of the package, this
|
* Instead of writing packaged code by hand, and manually describing the layout of the package, this
|
||||||
* function transpiles the TypeScript sources into a flat file structure using a single format. In
|
* function transpiles the TypeScript sources into a flat file structure using a single format. In
|
||||||
* this package layout, all compiled sources are at the root of the package, with .d.ts files next
|
* this package layout, all compiled sources are at the root of the package, with `.d.ts` files next
|
||||||
* to the .js files. Each .js also has a corresponding .metadata.js file alongside with it.
|
* to the `.js` files. Each `.js` also has a corresponding `.metadata.json` file alongside with it.
|
||||||
*
|
*
|
||||||
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
* All generated code is written into the `node_modules` in the top-level filesystem, ready for use
|
||||||
* in testing ngcc.
|
* in testing ngcc.
|
||||||
|
|
Loading…
Reference in New Issue