@angular/compiler-cli 17.2.1 → 17.2.3

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

@@ -7,7 +7,7 @@
  */
 import { MaybeForwardRefExpression, outputAst as o, R3DeclareDependencyMetadata, R3DependencyMetadata, R3Reference } from '@angular/compiler';
 import { AstObject, AstValue } from '../../ast/ast_value';
-export declare const PLACEHOLDER_VERSION = "17.2.1";
+export declare const PLACEHOLDER_VERSION = "17.2.3";
 export declare const SHOULD_USE_TEMPLATE_PIPELINE_FOR_LINKER = false;
 export declare function wrapReference<TExpression>(wrapped: o.WrappedNodeExpr<TExpression>): R3Reference;
 /**

package/package.json

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

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
@@ -38,7 +39,5 @@ 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<FnNames extends InitializerApiFunction[]>(fnNames: FnNames, member: Pick<ClassMember, 'value'>, reflector: ReflectionHost, importTracker: ImportedSymbolsTracker): InitializerFunctionMetadata | 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/docs/src/constant_extractor.d.ts

@@ -6,8 +6,8 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import ts from 'typescript';
-import { ConstantEntry } from './entities';
+import { ConstantEntry, EnumEntry } from './entities';
 /** Extracts documentation entry for a constant. */
-export declare function extractConstant(declaration: ts.VariableDeclaration, typeChecker: ts.TypeChecker): ConstantEntry;
+export declare function extractConstant(declaration: ts.VariableDeclaration, typeChecker: ts.TypeChecker): ConstantEntry | EnumEntry;
 /** Gets whether a given constant is an Angular-added const that should be ignored for docs. */
 export declare function isSyntheticAngularConstant(declaration: ts.VariableDeclaration): 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/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