2019-03-04 14:43:55 -05:00
|
|
|
/**
|
|
|
|
* @license
|
2020-05-19 15:08:49 -04:00
|
|
|
* Copyright Google LLC All Rights Reserved.
|
2019-03-04 14:43:55 -05:00
|
|
|
*
|
|
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
|
|
* found in the LICENSE file at https://angular.io/license
|
|
|
|
*/
|
fix(compiler-cli): remove the concept of an errored trait (#39923)
Previously, if a trait's analysis step resulted in diagnostics, the trait
would be considered "errored" and no further operations, including register,
would be performed. Effectively, this meant that the compiler would pretend
the class in question was actually undecorated.
However, this behavior is problematic for several reasons:
1. It leads to inaccurate diagnostics being reported downstream.
For example, if a component is put into the error state, for example due to
a template error, the NgModule which declares the component would produce a
diagnostic claiming that the declaration is neither a directive nor a pipe.
This happened because the compiler wouldn't register() the component trait,
so the component would not be recorded as actually being a directive.
2. It can cause incorrect behavior on incremental builds.
This bug is more complex, but the general issue is that if the compiler
fails to associate a component and its module, then incremental builds will
not correctly re-analyze the module when the component's template changes.
Failing to register the component as such is one link in the larger chain of
issues that result in these kinds of issues.
3. It lumps together diagnostics produced during analysis and resolve steps.
This is not causing issues currently as the dependency graph ensures the
right classes are re-analyzed when needed, instead of showing stale
diagnostics. However, the dependency graph was not intended to serve this
role, and could potentially be optimized in ways that would break this
functionality.
This commit removes the concept of an "errored" trait entirely from the
trait system. Instead, analyzed and resolved traits have corresponding (and
separate) diagnostics, in addition to potentially `null` analysis results.
Analysis (but not resolution) diagnostics are carried forward during
incremental build operations. Compilation (emit) is only performed when
a trait reaches the resolved state with no diagnostics.
This change is functionally different than before as the `register` step is
now performed even in the presence of analysis errors, as long as analysis
results are also produced. This fixes problem 1 above, and is part of the
larger solution to problem 2.
PR Close #39923
2020-11-25 18:01:24 -05:00
|
|
|
import {Trait, TraitState} from '@angular/compiler-cli/src/ngtsc/transform';
|
2019-03-04 14:43:55 -05:00
|
|
|
import * as ts from 'typescript';
|
2020-07-03 14:12:24 -04:00
|
|
|
import {CtorParameter, TypeValueReferenceKind} from '../../../src/ngtsc/reflection';
|
2019-03-04 14:43:55 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check that a given list of `CtorParameter`s has `typeValueReference`s of specific `ts.Identifier`
|
|
|
|
* names.
|
|
|
|
*/
|
|
|
|
export function expectTypeValueReferencesForParameters(
|
2020-09-01 11:49:48 -04:00
|
|
|
parameters: CtorParameter[], expectedParams: (string|null)[],
|
|
|
|
fromModule: (string|null)[] = []) {
|
2020-04-06 03:30:08 -04:00
|
|
|
parameters!.forEach((param, idx) => {
|
2019-03-04 14:43:55 -05:00
|
|
|
const expected = expectedParams[idx];
|
|
|
|
if (expected !== null) {
|
2020-07-03 14:12:24 -04:00
|
|
|
if (param.typeValueReference.kind === TypeValueReferenceKind.UNAVAILABLE) {
|
2020-09-01 11:49:48 -04:00
|
|
|
fail(`Incorrect typeValueReference generated for ${param.name}, expected "${
|
|
|
|
expected}" because "${param.typeValueReference.reason}"`);
|
2020-07-03 14:12:24 -04:00
|
|
|
} else if (
|
2020-09-01 11:49:48 -04:00
|
|
|
param.typeValueReference.kind === TypeValueReferenceKind.LOCAL &&
|
|
|
|
fromModule[idx] != null) {
|
|
|
|
fail(`Incorrect typeValueReference generated for ${param.name}, expected non-LOCAL (from ${
|
|
|
|
fromModule[idx]}) but was marked LOCAL`);
|
2020-07-03 14:12:24 -04:00
|
|
|
} else if (
|
2020-09-01 11:49:48 -04:00
|
|
|
param.typeValueReference.kind !== TypeValueReferenceKind.LOCAL &&
|
|
|
|
fromModule[idx] == null) {
|
|
|
|
fail(`Incorrect typeValueReference generated for ${
|
|
|
|
param.name}, expected LOCAL but was imported from ${
|
|
|
|
param.typeValueReference.moduleName}`);
|
2020-07-03 14:12:24 -04:00
|
|
|
} else if (param.typeValueReference.kind === TypeValueReferenceKind.LOCAL) {
|
2020-09-01 11:49:48 -04:00
|
|
|
if (!ts.isIdentifier(param.typeValueReference.expression) &&
|
|
|
|
!ts.isPropertyAccessExpression(param.typeValueReference.expression)) {
|
|
|
|
fail(`Incorrect typeValueReference generated for ${
|
|
|
|
param.name}, expected an identifier but got "${
|
|
|
|
param.typeValueReference.expression.getText()}"`);
|
2019-11-18 14:53:25 -05:00
|
|
|
} else {
|
2020-09-01 11:49:48 -04:00
|
|
|
expect(param.typeValueReference.expression.getText()).toEqual(expected);
|
2019-11-18 14:53:25 -05:00
|
|
|
}
|
2020-07-03 14:12:24 -04:00
|
|
|
} else if (param.typeValueReference.kind === TypeValueReferenceKind.IMPORTED) {
|
2020-09-01 11:49:48 -04:00
|
|
|
expect(param.typeValueReference.moduleName).toBe(fromModule[idx]!);
|
fix(compiler): handle type references to namespaced symbols correctly (#36106)
When the compiler needs to convert a type reference to a value
expression, it may encounter a type that refers to a namespaced symbol.
Such namespaces need to be handled specially as there's various forms
available. Consider a namespace named "ns":
1. One can refer to a namespace by itself: `ns`. A namespace is only
allowed to be used in a type position if it has been merged with a
class, but even if this is the case it may not be possible to convert
that type into a value expression depending on the import form. More
on this later (case a below)
2. One can refer to a type within the namespace: `ns.Foo`. An import
needs to be generated to `ns`, from which the `Foo` property can then
be read.
3. One can refer to a type in a nested namespace within `ns`:
`ns.Foo.Bar` and possibly even deeper nested. The value
representation is similar to case 2, but includes additional property
accesses.
The exact strategy of how to deal with these cases depends on the type
of import used. There's two flavors available:
a. A namespaced import like `import * as ns from 'ns';` that creates
a local namespace that is irrelevant to the import that needs to be
generated (as said import would be used instead of the original
import).
If the local namespace "ns" itself is referred to in a type position,
it is invalid to convert it into a value expression. Some JavaScript
libraries publish a value as default export using `export = MyClass;`
syntax, however it is illegal to refer to that value using "ns".
Consequently, such usage in a type position *must* be accompanied by
an `@Inject` decorator to provide an explicit token.
b. An explicit namespace declaration within a module, that can be
imported using a named import like `import {ns} from 'ns';` where the
"ns" module declares a namespace using `declare namespace ns {}`.
In this case, it's the namespace itself that needs to be imported,
after which any qualified references into the namespace are converted
into property accesses.
Before this change, support for namespaces in the type-to-value
conversion was limited and only worked correctly for a single qualified
name using a namespace import (case 2a). All other cases were either
producing incorrect code or would crash the compiler (case 1a).
Crashing the compiler is not desirable as it does not indicate where
the issue is. Moreover, the result of a type-to-value conversion is
irrelevant when an explicit injection token is provided using `@Inject`,
so referring to a namespace in a type position (case 1) could still be
valid.
This commit introduces logic to the type-to-value conversion to be able
to properly deal with all type references to namespaced symbols.
Fixes #36006
Resolves FW-1995
PR Close #36106
2020-03-17 11:23:46 -04:00
|
|
|
expect(param.typeValueReference.importedName).toBe(expected);
|
2019-03-04 14:43:55 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
fix(compiler-cli): remove the concept of an errored trait (#39923)
Previously, if a trait's analysis step resulted in diagnostics, the trait
would be considered "errored" and no further operations, including register,
would be performed. Effectively, this meant that the compiler would pretend
the class in question was actually undecorated.
However, this behavior is problematic for several reasons:
1. It leads to inaccurate diagnostics being reported downstream.
For example, if a component is put into the error state, for example due to
a template error, the NgModule which declares the component would produce a
diagnostic claiming that the declaration is neither a directive nor a pipe.
This happened because the compiler wouldn't register() the component trait,
so the component would not be recorded as actually being a directive.
2. It can cause incorrect behavior on incremental builds.
This bug is more complex, but the general issue is that if the compiler
fails to associate a component and its module, then incremental builds will
not correctly re-analyze the module when the component's template changes.
Failing to register the component as such is one link in the larger chain of
issues that result in these kinds of issues.
3. It lumps together diagnostics produced during analysis and resolve steps.
This is not causing issues currently as the dependency graph ensures the
right classes are re-analyzed when needed, instead of showing stale
diagnostics. However, the dependency graph was not intended to serve this
role, and could potentially be optimized in ways that would break this
functionality.
This commit removes the concept of an "errored" trait entirely from the
trait system. Instead, analyzed and resolved traits have corresponding (and
separate) diagnostics, in addition to potentially `null` analysis results.
Analysis (but not resolution) diagnostics are carried forward during
incremental build operations. Compilation (emit) is only performed when
a trait reaches the resolved state with no diagnostics.
This change is functionally different than before as the `register` step is
now performed even in the presence of analysis errors, as long as analysis
results are also produced. This fixes problem 1 above, and is part of the
larger solution to problem 2.
PR Close #39923
2020-11-25 18:01:24 -05:00
|
|
|
|
|
|
|
export function getTraitDiagnostics(trait: Trait<unknown, unknown, unknown>): ts.Diagnostic[]|null {
|
|
|
|
if (trait.state === TraitState.Analyzed) {
|
|
|
|
return trait.analysisDiagnostics;
|
|
|
|
} else if (trait.state === TraitState.Resolved) {
|
|
|
|
const diags = [
|
|
|
|
...(trait.analysisDiagnostics ?? []),
|
|
|
|
...(trait.resolveDiagnostics ?? []),
|
|
|
|
];
|
|
|
|
return diags.length > 0 ? diags : null;
|
|
|
|
} else {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
}
|