@angular/compiler-cli 17.3.0-next.0 → 17.3.0-rc.0

package/linker/src/file_linker/partial_linkers/util.d.ts

@@ -7,8 +7,8 @@
  */
 import { MaybeForwardRefExpression, outputAst as o, R3DeclareDependencyMetadata, R3DependencyMetadata, R3Reference } from '@angular/compiler';
 import { AstObject, AstValue } from '../../ast/ast_value';
-export declare const PLACEHOLDER_VERSION = "17.3.0-next.0";
-export declare const SHOULD_USE_TEMPLATE_PIPELINE_FOR_LINKER = false;
+export declare const PLACEHOLDER_VERSION = "17.3.0-rc.0";
+export declare const SHOULD_USE_TEMPLATE_PIPELINE_FOR_LINKER = true;
 export declare function wrapReference<TExpression>(wrapped: o.WrappedNodeExpr<TExpression>): R3Reference;
 /**
  * Parses the value of an enum from the AST value's symbol name.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/compiler-cli",
-  "version": "17.3.0-next.0",
+  "version": "17.3.0-rc.0",
   "description": "Angular - the compiler CLI for Node.js",
   "typings": "index.d.ts",
   "bin": {
@@ -53,8 +53,8 @@
     "yargs": "^17.2.1"
   },
   "peerDependencies": {
-    "@angular/compiler": "17.3.0-next.0",
-    "typescript": ">=5.2 <5.4"
+    "@angular/compiler": "17.3.0-rc.0",
+    "typescript": ">=5.2 <5.5"
   },
   "repository": {
     "type": "git",

package/src/ngtsc/annotations/component/src/handler.d.ts

@@ -8,7 +8,7 @@
 import { ConstantPool } from '@angular/compiler';
 import ts from 'typescript';
 import { CycleAnalyzer, CycleHandlingStrategy } from '../../../cycles';
-import { DeferredSymbolTracker, LocalCompilationExtraImportsTracker, ModuleResolver, ReferenceEmitter } from '../../../imports';
+import { DeferredSymbolTracker, ImportedSymbolsTracker, LocalCompilationExtraImportsTracker, ModuleResolver, ReferenceEmitter } from '../../../imports';
 import { DependencyTracker } from '../../../incremental/api';
 import { SemanticDepGraphUpdater } from '../../../incremental/semantic_graph';
 import { IndexingContext } from '../../../indexer';
@@ -57,6 +57,7 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     private annotateForClosureCompiler;
     private perf;
     private hostDirectivesResolver;
+    private importTracker;
     private includeClassMetadata;
     private readonly compilationMode;
     private readonly deferredSymbolTracker;
@@ -64,7 +65,7 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     private readonly enableBlockSyntax;
     private readonly useTemplatePipeline;
     private readonly localCompilationExtraImportsTracker;
-    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, metaReader: MetadataReader, scopeReader: ComponentScopeReader, dtsScopeReader: DtsModuleScopeResolver, scopeRegistry: LocalModuleScopeRegistry, typeCheckScopeRegistry: TypeCheckScopeRegistry, resourceRegistry: ResourceRegistry, isCore: boolean, strictCtorDeps: boolean, resourceLoader: ResourceLoader, rootDirs: ReadonlyArray<string>, defaultPreserveWhitespaces: boolean, i18nUseExternalIds: boolean, enableI18nLegacyMessageIdFormat: boolean, usePoisonedData: boolean, i18nNormalizeLineEndingsInICUs: boolean, moduleResolver: ModuleResolver, cycleAnalyzer: CycleAnalyzer, cycleHandlingStrategy: CycleHandlingStrategy, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, depTracker: DependencyTracker | null, injectableRegistry: InjectableClassRegistry, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, hostDirectivesResolver: HostDirectivesResolver, includeClassMetadata: boolean, compilationMode: CompilationMode, deferredSymbolTracker: DeferredSymbolTracker, forbidOrphanRendering: boolean, enableBlockSyntax: boolean, useTemplatePipeline: boolean, localCompilationExtraImportsTracker: LocalCompilationExtraImportsTracker | null);
+    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, metaReader: MetadataReader, scopeReader: ComponentScopeReader, dtsScopeReader: DtsModuleScopeResolver, scopeRegistry: LocalModuleScopeRegistry, typeCheckScopeRegistry: TypeCheckScopeRegistry, resourceRegistry: ResourceRegistry, isCore: boolean, strictCtorDeps: boolean, resourceLoader: ResourceLoader, rootDirs: ReadonlyArray<string>, defaultPreserveWhitespaces: boolean, i18nUseExternalIds: boolean, enableI18nLegacyMessageIdFormat: boolean, usePoisonedData: boolean, i18nNormalizeLineEndingsInICUs: boolean, moduleResolver: ModuleResolver, cycleAnalyzer: CycleAnalyzer, cycleHandlingStrategy: CycleHandlingStrategy, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, depTracker: DependencyTracker | null, injectableRegistry: InjectableClassRegistry, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, hostDirectivesResolver: HostDirectivesResolver, importTracker: ImportedSymbolsTracker, includeClassMetadata: boolean, compilationMode: CompilationMode, deferredSymbolTracker: DeferredSymbolTracker, forbidOrphanRendering: boolean, enableBlockSyntax: boolean, useTemplatePipeline: boolean, localCompilationExtraImportsTracker: LocalCompilationExtraImportsTracker | null);
     private literalCache;
     private elementSchemaRegistry;
     /**

package/src/ngtsc/annotations/directive/src/handler.d.ts

@@ -7,7 +7,7 @@
  */
 import { ConstantPool, R3ClassMetadata, R3DirectiveMetadata } from '@angular/compiler';
 import ts from 'typescript';
-import { Reference, ReferenceEmitter } from '../../../imports';
+import { ImportedSymbolsTracker, Reference, ReferenceEmitter } from '../../../imports';
 import { SemanticDepGraphUpdater } from '../../../incremental/semantic_graph';
 import { ClassPropertyMapping, DirectiveTypeCheckMeta, HostDirectiveMeta, InputMapping, MetadataReader, MetadataRegistry } from '../../../metadata';
 import { PartialEvaluator } from '../../../partial_evaluator';
@@ -45,11 +45,12 @@ export declare class DirectiveDecoratorHandler implements DecoratorHandler<Decor
     private semanticDepGraphUpdater;
     private annotateForClosureCompiler;
     private perf;
+    private importTracker;
     private includeClassMetadata;
     private readonly compilationMode;
     private readonly useTemplatePipeline;
     private readonly generateExtraImportsInLocalMode;
-    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, scopeRegistry: LocalModuleScopeRegistry, metaReader: MetadataReader, injectableRegistry: InjectableClassRegistry, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, isCore: boolean, strictCtorDeps: boolean, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, includeClassMetadata: boolean, compilationMode: CompilationMode, useTemplatePipeline: boolean, generateExtraImportsInLocalMode: boolean);
+    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, scopeRegistry: LocalModuleScopeRegistry, metaReader: MetadataReader, injectableRegistry: InjectableClassRegistry, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, isCore: boolean, strictCtorDeps: boolean, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, importTracker: ImportedSymbolsTracker, includeClassMetadata: boolean, compilationMode: CompilationMode, useTemplatePipeline: boolean, generateExtraImportsInLocalMode: boolean);
     readonly precedence = HandlerPrecedence.PRIMARY;
     readonly name = "DirectiveDecoratorHandler";
     detect(node: ClassDeclaration, decorators: Decorator[] | null): DetectResult<Decorator | null> | undefined;

package/src/ngtsc/annotations/directive/src/initializer_functions.d.ts

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import ts from 'typescript';
+import { ImportedSymbolsTracker } from '../../../imports';
 import { ClassMember, ReflectionHost } from '../../../reflection';
 /**
  * @fileoverview
@@ -18,14 +19,17 @@ import { ClassMember, ReflectionHost } from '../../../reflection';
  * Similarly, signal-based queries follow the same pattern and are also
  * declared through initializer APIs.
  */
-export type InitializerApiFunction = 'input' | 'model' | 'ɵoutput' | 'output' | 'viewChild' | 'viewChildren' | 'contentChild' | 'contentChildren';
+export interface InitializerApiFunction {
+    owningModule: '@angular/core' | '@angular/core/rxjs-interop';
+    functionName: ('input' | 'model' | 'ɵoutput' | 'output' | 'outputFromObservable' | 'viewChild' | 'viewChildren' | 'contentChild' | 'contentChildren');
+}
 /**
  * Metadata describing an Angular class member that was recognized through
  * a function initializer. Like `input`, `input.required` or `viewChild`.
  */
 interface InitializerFunctionMetadata {
-    /** Name of the initializer API function that was recognized. */
-    apiName: InitializerApiFunction;
+    /** Initializer API function that was recognized. */
+    api: InitializerApiFunction;
     /** Node referring to the call expression. */
     call: ts.CallExpression;
     /** Whether the initializer is required or not. E.g. `input.required` was used. */
@@ -38,7 +42,7 @@ interface InitializerFunctionMetadata {
  * Note that multiple possible initializer API function names can be specified,
  * allowing for checking multiple types in one pass.
  */
-export declare function tryParseInitializerApiMember<FnNames extends InitializerApiFunction[]>(fnNames: FnNames, member: Pick<ClassMember, 'value'>, reflector: ReflectionHost, isCore: boolean): InitializerFunctionMetadata & {
-    apiName: FnNames[number];
-} | null;
+export declare function tryParseInitializerApiMember<Functions extends InitializerApiFunction[]>(functions: Functions, member: Pick<ClassMember, 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): (InitializerFunctionMetadata & {
+    api: Functions[number];
+} | null);
 export {};

package/src/ngtsc/annotations/directive/src/input_function.d.ts

@@ -5,10 +5,11 @@
  * 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
  */
+import { ImportedSymbolsTracker } from '../../../imports';
 import { InputMapping } from '../../../metadata';
 import { ClassMember, ReflectionHost } from '../../../reflection';
 /**
  * Attempts to parse a signal input class member. Returns the parsed
  * input mapping if possible.
  */
-export declare function tryParseSignalInputMapping(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, isCore: boolean): InputMapping | null;
+export declare function tryParseSignalInputMapping(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): InputMapping | null;

package/src/ngtsc/annotations/directive/src/model_function.d.ts

@@ -5,9 +5,10 @@
  * 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
  */
+import { ImportedSymbolsTracker } from '../../../imports';
 import { ModelMapping } from '../../../metadata';
 import { ClassMember, ReflectionHost } from '../../../reflection';
 /**
  * Attempts to parse a model class member. Returns the parsed model mapping if possible.
  */
-export declare function tryParseSignalModelMapping(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, isCore: boolean): ModelMapping | null;
+export declare function tryParseSignalModelMapping(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): ModelMapping | null;

package/src/ngtsc/annotations/directive/src/output_function.d.ts

@@ -6,13 +6,14 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import ts from 'typescript';
+import { ImportedSymbolsTracker } from '../../../imports';
 import { InputOrOutput } from '../../../metadata';
 import { ClassMember, ReflectionHost } from '../../../reflection';
 /**
  * Attempts to parse a signal output class member. Returns the parsed
  * input mapping if possible.
  */
-export declare function tryParseInitializerBasedOutput(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, isCore: boolean): {
+export declare function tryParseInitializerBasedOutput(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): {
     call: ts.CallExpression;
     metadata: InputOrOutput;
 } | null;

package/src/ngtsc/annotations/directive/src/query_functions.d.ts

@@ -7,6 +7,7 @@
  */
 import { R3QueryMetadata } from '@angular/compiler';
 import ts from 'typescript';
+import { ImportedSymbolsTracker } from '../../../imports';
 import { ClassMember, ReflectionHost } from '../../../reflection';
 /** Possible query initializer API functions. */
 export type QueryFunctionName = 'viewChild' | 'contentChild' | 'viewChildren' | 'contentChildren';
@@ -18,7 +19,7 @@ export type QueryFunctionName = 'viewChild' | 'contentChild' | 'viewChildren' |
  *
  * @returns Resolved query metadata, or null if no query is declared.
  */
-export declare function tryParseSignalQueryFromInitializer(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, isCore: boolean): {
+export declare function tryParseSignalQueryFromInitializer(member: Pick<ClassMember, 'name' | 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): {
     name: QueryFunctionName;
     metadata: R3QueryMetadata;
     call: ts.CallExpression;

package/src/ngtsc/annotations/directive/src/shared.d.ts

@@ -7,7 +7,7 @@
  */
 import { ParsedHostBindings, R3DirectiveMetadata, R3QueryMetadata } from '@angular/compiler';
 import ts from 'typescript';
-import { Reference, ReferenceEmitter } from '../../../imports';
+import { ImportedSymbolsTracker, Reference, ReferenceEmitter } from '../../../imports';
 import { ClassPropertyMapping, DecoratorInputTransform, HostDirectiveMeta, InputMapping } from '../../../metadata';
 import { DynamicValue, PartialEvaluator } from '../../../partial_evaluator';
 import { ClassDeclaration, ClassMember, Decorator, ReflectionHost } from '../../../reflection';
@@ -21,7 +21,7 @@ export declare const queryDecoratorNames: QueryDecoratorName[];
  * appear in the declarations of an `NgModule` and additional verification is done when processing
  * the module.
  */
-export declare function extractDirectiveMetadata(clazz: ClassDeclaration, decorator: Readonly<Decorator>, reflector: ReflectionHost, evaluator: PartialEvaluator, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, isCore: boolean, annotateForClosureCompiler: boolean, compilationMode: CompilationMode, defaultSelector: string | null, useTemplatePipeline: boolean): {
+export declare function extractDirectiveMetadata(clazz: ClassDeclaration, decorator: Readonly<Decorator>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker, evaluator: PartialEvaluator, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, isCore: boolean, annotateForClosureCompiler: boolean, compilationMode: CompilationMode, defaultSelector: string | null, useTemplatePipeline: boolean): {
     decorator: Map<string, ts.Expression>;
     metadata: R3DirectiveMetadata;
     inputs: ClassPropertyMapping<InputMapping>;

package/src/ngtsc/core/src/feature_detection.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+/**
+ * Whether a version of `@angular/core` supports a specific feature.
+ * @param coreVersion Current version of core.
+ * @param minVersion Minimum required version for the feature.
+ */
+export declare function coreVersionSupportsFeature(coreVersion: string, minVersion: string): boolean;

package/src/ngtsc/imports/index.d.ts

@@ -10,6 +10,7 @@ export { ImportRewriter, NoopImportRewriter, R3SymbolsImportRewriter, validateAn
 export { DefaultImportTracker } from './src/default';
 export { DeferredSymbolTracker } from './src/deferred_symbol_tracker';
 export { AbsoluteModuleStrategy, assertSuccessfulReferenceEmit, EmittedReference, FailedEmitResult, ImportedFile, ImportFlags, LocalIdentifierStrategy, LogicalProjectStrategy, ReferenceEmitKind, ReferenceEmitResult, ReferenceEmitStrategy, ReferenceEmitter, RelativePathStrategy, UnifiedModulesStrategy } from './src/emitter';
+export { ImportedSymbolsTracker } from './src/imported_symbols_tracker';
 export { LocalCompilationExtraImportsTracker } from './src/local_compilation_extra_imports_tracker';
 export { isAliasImportDeclaration, loadIsReferencedAliasDeclarationPatch } from './src/patch_alias_reference_resolution';
 export { Reexport } from './src/reexport';

package/src/ngtsc/imports/src/imported_symbols_tracker.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+import ts from 'typescript';
+/**
+ * Tracks which symbols are imported in specific files and under what names. Allows for efficient
+ * querying for references to those symbols without having to consult the type checker early in the
+ * process.
+ *
+ * Note that the tracker doesn't account for variable shadowing so a final verification with the
+ * type checker may be necessary, depending on the context. Also does not track dynamic imports.
+ */
+export declare class ImportedSymbolsTracker {
+    private fileToNamedImports;
+    private fileToNamespaceImports;
+    /**
+     * Checks if an identifier is a potential reference to a specific named import within the same
+     * file.
+     * @param node Identifier to be checked.
+     * @param exportedName Name of the exported symbol that is being searched for.
+     * @param moduleName Module from which the symbol should be imported.
+     */
+    isPotentialReferenceToNamedImport(node: ts.Identifier, exportedName: string, moduleName: string): boolean;
+    /**
+     * Checks if an identifier is a potential reference to a specific namespace import within the same
+     * file.
+     * @param node Identifier to be checked.
+     * @param moduleName Module from which the namespace is imported.
+     */
+    isPotentialReferenceToNamespaceImport(node: ts.Identifier, moduleName: string): boolean;
+    /** Scans a `SourceFile` for import statements and caches them for later use. */
+    private scanImports;
+}

package/src/ngtsc/reflection/index.d.ts

@@ -6,6 +6,6 @@
  * found in the LICENSE file at https://angular.io/license
  */
 export * from './src/host';
-export { typeNodeToValueExpr } from './src/type_to_value';
+export { typeNodeToValueExpr, entityNameToValue } from './src/type_to_value';
 export { TypeScriptReflectionHost, filterToMembersWithDecorator, reflectIdentifierOfDeclaration, reflectNameOfDeclaration, reflectObjectLiteral, reflectTypeEntityToDeclaration } from './src/typescript';
 export { isNamedClassDeclaration, isNamedFunctionDeclaration, isNamedVariableDeclaration } from './src/util';

package/src/ngtsc/reflection/src/type_to_value.d.ts

@@ -22,3 +22,4 @@ export declare function typeToValue(typeNode: ts.TypeNode | null, checker: ts.Ty
  * This will return `null` if an equivalent expression cannot be constructed.
  */
 export declare function typeNodeToValueExpr(node: ts.TypeNode): ts.Expression | null;
+export declare function entityNameToValue(node: ts.EntityName): ts.Expression | null;

package/src/transformers/jit_transforms/initializer_api_transforms/transform.d.ts

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import ts from 'typescript';
+import { ImportedSymbolsTracker } from '../../../ngtsc/imports';
 import { ReflectionHost } from '../../../ngtsc/reflection';
 /**
  * Creates an AST transform that looks for Angular classes and transforms
@@ -14,4 +15,4 @@ import { ReflectionHost } from '../../../ngtsc/reflection';
  * For example, an `input()` member may be transformed to add an `@Input`
  * decorator for JIT.
  */
-export declare function getInitializerApiJitTransform(host: ReflectionHost, isCore: boolean): ts.TransformerFactory<ts.SourceFile>;
+export declare function getInitializerApiJitTransform(host: ReflectionHost, importTracker: ImportedSymbolsTracker, isCore: boolean): ts.TransformerFactory<ts.SourceFile>;

package/src/transformers/jit_transforms/initializer_api_transforms/transform_api.d.ts

@@ -6,12 +6,13 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import ts from 'typescript';
-import { Decorator, ReflectionHost } from '../../..//ngtsc/reflection';
+import { ImportedSymbolsTracker } from '../../../ngtsc/imports';
+import { Decorator, ReflectionHost } from '../../../ngtsc/reflection';
 import { ImportManager } from '../../../ngtsc/translator';
 /** Function that can be used to transform class properties. */
 export type PropertyTransform = (node: ts.PropertyDeclaration & {
     name: ts.Identifier | ts.StringLiteralLike;
-}, host: ReflectionHost, factory: ts.NodeFactory, importManager: ImportManager, classDecorator: Decorator, isCore: boolean) => ts.PropertyDeclaration;
+}, host: ReflectionHost, factory: ts.NodeFactory, importTracker: ImportedSymbolsTracker, importManager: ImportManager, classDecorator: Decorator, isCore: boolean) => ts.PropertyDeclaration;
 /**
  * Creates an import and access for a given Angular core import while
  * ensuring the decorator symbol access can be traced back to an Angular core