@angular/compiler-cli 15.1.1 → 15.2.0-next.1

package/ngcc/src/packages/build_marker.d.ts

@@ -8,7 +8,7 @@
 import { AbsoluteFsPath } from '../../../src/ngtsc/file_system';
 import { PackageJsonUpdater } from '../writing/package_json_updater';
 import { EntryPointPackageJson, PackageJsonFormatProperties } from './entry_point';
-export declare const NGCC_VERSION = "15.1.1";
+export declare const NGCC_VERSION = "15.2.0-next.1";
 /**
  * Returns true if there is a format in this entry-point that was compiled with an outdated version
  * of ngcc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/compiler-cli",
-  "version": "15.1.1",
+  "version": "15.2.0-next.1",
   "description": "Angular - the compiler CLI for Node.js",
   "typings": "index.d.ts",
   "bin": {
@@ -65,7 +65,7 @@
     "yargs": "^17.2.1"
   },
   "peerDependencies": {
-    "@angular/compiler": "15.1.1",
+    "@angular/compiler": "15.2.0-next.1",
     "typescript": ">=4.8.2 <5.0"
   },
   "repository": {

package/private/migrations.d.ts

@@ -13,3 +13,4 @@ export { forwardRefResolver } from '../src/ngtsc/annotations';
 export { Reference } from '../src/ngtsc/imports';
 export { DynamicValue, PartialEvaluator, ResolvedValue, ResolvedValueMap, StaticInterpreter } from '../src/ngtsc/partial_evaluator';
 export { reflectObjectLiteral, TypeScriptReflectionHost } from '../src/ngtsc/reflection';
+export { PotentialImport, PotentialImportKind, PotentialImportMode, TemplateTypeChecker } from '../src/ngtsc/typecheck/api';

package/src/ngtsc/metadata/src/api.d.ts

@@ -215,10 +215,16 @@ export interface MetadataReader {
     getPipeMetadata(node: Reference<ClassDeclaration>): PipeMeta | null;
 }
 /**
- * A MetadataReader which also allows access to the set of all known directive classes.
+ * A MetadataReader which also allows access to the set of all known trait classes.
  */
 export interface MetadataReaderWithIndex extends MetadataReader {
-    getKnown(kind: MetaKind): Iterable<ClassDeclaration>;
+    getKnown(kind: MetaKind): Array<ClassDeclaration>;
+}
+/**
+ * An NgModuleIndex allows access to information about traits exported by NgModules.
+ */
+export interface NgModuleIndex {
+    getNgModulesExporting(directiveOrPipe: ClassDeclaration): Array<Reference<ClassDeclaration>>;
 }
 /**
  * Registers new metadata for directives, pipes, and modules.

package/src/ngtsc/metadata/src/ng_module_index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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 { Reference } from '../../imports';
+import { ClassDeclaration } from '../../reflection';
+import { MetadataReader, MetadataReaderWithIndex, NgModuleIndex } from './api';
+/**
+ * An index of all NgModules that export or re-export a given trait.
+ */
+export declare class NgModuleIndexImpl implements NgModuleIndex {
+    private metaReader;
+    private localReader;
+    constructor(metaReader: MetadataReader, localReader: MetadataReaderWithIndex);
+    private ngModuleAuthoritativeReference;
+    private typeToExportingModules;
+    private indexed;
+    private updateWith;
+    private index;
+    private indexTrait;
+    getNgModulesExporting(directiveOrPipe: ClassDeclaration): Array<Reference<ClassDeclaration>>;
+}

package/src/ngtsc/metadata/src/registry.d.ts

@@ -22,7 +22,7 @@ export declare class LocalMetadataRegistry implements MetadataRegistry, Metadata
     registerDirectiveMetadata(meta: DirectiveMeta): void;
     registerNgModuleMetadata(meta: NgModuleMeta): void;
     registerPipeMetadata(meta: PipeMeta): void;
-    getKnown(kind: MetaKind): Iterable<ClassDeclaration>;
+    getKnown(kind: MetaKind): Array<ClassDeclaration>;
 }
 /**
  * A `MetadataRegistry` which registers metadata with multiple delegate `MetadataRegistry`

package/src/ngtsc/typecheck/api/api.d.ts

@@ -22,6 +22,7 @@ export interface TypeCheckableDirectiveMeta extends DirectiveMeta, DirectiveType
     outputs: ClassPropertyMapping;
     isStandalone: boolean;
     hostDirectives: HostDirectiveMeta[] | null;
+    decorator: ts.Decorator | null;
 }
 export type TemplateId = string & {
     __brand: 'TemplateId';

package/src/ngtsc/typecheck/api/checker.d.ts

@@ -9,9 +9,12 @@ import { AST, LiteralPrimitive, ParseSourceSpan, PropertyRead, SafePropertyRead,
 import ts from 'typescript';
 import { AbsoluteFsPath } from '../../../../src/ngtsc/file_system';
 import { ErrorCode } from '../../diagnostics';
+import { Reference } from '../../imports';
+import { NgModuleMeta, PipeMeta } from '../../metadata';
+import { ClassDeclaration } from '../../reflection';
 import { FullTemplateMapping, NgTemplateDiagnostic, TypeCheckableDirectiveMeta } from './api';
 import { GlobalCompletion } from './completion';
-import { PotentialDirective, PotentialImport, PotentialPipe } from './scope';
+import { PotentialDirective, PotentialImport, PotentialImportMode, PotentialPipe } from './scope';
 import { ElementSymbol, Symbol, TcbLocation, TemplateSymbol } from './symbols';
 /**
  * Interface to the Angular Template Type Checker to extract diagnostics and intelligence from the
@@ -125,7 +128,7 @@ export interface TemplateTypeChecker {
     /**
      * In the context of an Angular trait, generate potential imports for a directive.
      */
-    getPotentialImportsFor(directive: PotentialDirective, inComponent: ts.ClassDeclaration): ReadonlyArray<PotentialImport>;
+    getPotentialImportsFor(toImport: Reference<ClassDeclaration>, inComponent: ts.ClassDeclaration, importMode: PotentialImportMode): ReadonlyArray<PotentialImport>;
     /**
      * Get the primary decorator for an Angular class (such as @Component). This does not work for
      * `@Injectable`.
@@ -155,6 +158,22 @@ export interface TemplateTypeChecker {
      * Retrieve the type checking engine's metadata for the given directive class, if available.
      */
     getDirectiveMetadata(dir: ts.ClassDeclaration): TypeCheckableDirectiveMeta | null;
+    /**
+     * Retrieve the type checking engine's metadata for the given NgModule class, if available.
+     */
+    getNgModuleMetadata(module: ts.ClassDeclaration): NgModuleMeta | null;
+    /**
+     * Retrieve the type checking engine's metadata for the given pipe class, if available.
+     */
+    getPipeMetadata(pipe: ts.ClassDeclaration): PipeMeta | null;
+    /**
+     * Gets the directives that have been used in a component's template.
+     */
+    getUsedDirectives(component: ts.ClassDeclaration): TypeCheckableDirectiveMeta[] | null;
+    /**
+     * Gets the pipes that have been used in a component's template.
+     */
+    getUsedPipes(component: ts.ClassDeclaration): string[] | null;
     /**
      * Reset the `TemplateTypeChecker`'s state for the given class, so that it will be recomputed on
      * the next request.

package/src/ngtsc/typecheck/api/scope.d.ts

@@ -73,3 +73,16 @@ export interface PotentialPipe {
      */
     isInScope: boolean;
 }
+/**
+ * Possible modes in which to look up a potential import.
+ */
+export declare enum PotentialImportMode {
+    /** Whether an import is standalone is inferred based on its metadata. */
+    Normal = 0,
+    /**
+     * An import is assumed to be standalone and is imported directly. This is useful for migrations
+     * where a declaration wasn't standalone when the program was created, but will become standalone
+     * as a part of the migration.
+     */
+    ForceDirect = 1
+}

package/src/ngtsc/typecheck/src/checker.d.ts

@@ -9,14 +9,14 @@ import { AST, LiteralPrimitive, ParseSourceSpan, PropertyRead, SafePropertyRead,
 import ts from 'typescript';
 import { ErrorCode } from '../../diagnostics';
 import { AbsoluteFsPath } from '../../file_system';
-import { ReferenceEmitter } from '../../imports';
+import { Reference, ReferenceEmitter } from '../../imports';
 import { IncrementalBuild } from '../../incremental/api';
-import { MetadataReader, MetadataReaderWithIndex } from '../../metadata';
+import { MetadataReader, MetadataReaderWithIndex, NgModuleIndex, NgModuleMeta, PipeMeta } from '../../metadata';
 import { PerfRecorder } from '../../perf';
 import { ProgramDriver } from '../../program_driver';
-import { ReflectionHost } from '../../reflection';
+import { ClassDeclaration, ReflectionHost } from '../../reflection';
 import { ComponentScopeReader, TypeCheckScopeRegistry } from '../../scope';
-import { ElementSymbol, FullTemplateMapping, GlobalCompletion, NgTemplateDiagnostic, OptimizeFor, PotentialDirective, PotentialImport, PotentialPipe, ProgramTypeCheckAdapter, TcbLocation, TemplateSymbol, TemplateTypeChecker, TypeCheckableDirectiveMeta, TypeCheckingConfig } from '../api';
+import { ElementSymbol, FullTemplateMapping, GlobalCompletion, NgTemplateDiagnostic, OptimizeFor, PotentialDirective, PotentialImport, PotentialImportMode, PotentialPipe, ProgramTypeCheckAdapter, TcbLocation, TemplateSymbol, TemplateTypeChecker, TypeCheckableDirectiveMeta, TypeCheckingConfig } from '../api';
 import { ShimTypeCheckingData } from './context';
 import { TemplateSourceManager } from './source';
 /**
@@ -35,6 +35,7 @@ export declare class TemplateTypeCheckerImpl implements TemplateTypeChecker {
     private priorBuild;
     private readonly metaReader;
     private readonly localMetaReader;
+    private readonly ngModuleIndex;
     private readonly componentScopeReader;
     private readonly typeCheckScopeRegistry;
     private readonly perf;
@@ -73,8 +74,10 @@ export declare class TemplateTypeCheckerImpl implements TemplateTypeChecker {
      */
     private elementTagCache;
     private isComplete;
-    constructor(originalProgram: ts.Program, programDriver: ProgramDriver, typeCheckAdapter: ProgramTypeCheckAdapter, config: TypeCheckingConfig, refEmitter: ReferenceEmitter, reflector: ReflectionHost, compilerHost: Pick<ts.CompilerHost, 'getCanonicalFileName'>, priorBuild: IncrementalBuild<unknown, FileTypeCheckingData>, metaReader: MetadataReader, localMetaReader: MetadataReaderWithIndex, componentScopeReader: ComponentScopeReader, typeCheckScopeRegistry: TypeCheckScopeRegistry, perf: PerfRecorder);
+    constructor(originalProgram: ts.Program, programDriver: ProgramDriver, typeCheckAdapter: ProgramTypeCheckAdapter, config: TypeCheckingConfig, refEmitter: ReferenceEmitter, reflector: ReflectionHost, compilerHost: Pick<ts.CompilerHost, 'getCanonicalFileName'>, priorBuild: IncrementalBuild<unknown, FileTypeCheckingData>, metaReader: MetadataReader, localMetaReader: MetadataReaderWithIndex, ngModuleIndex: NgModuleIndex, componentScopeReader: ComponentScopeReader, typeCheckScopeRegistry: TypeCheckScopeRegistry, perf: PerfRecorder);
     getTemplate(component: ts.ClassDeclaration): TmplAstNode[] | null;
+    getUsedDirectives(component: ts.ClassDeclaration): TypeCheckableDirectiveMeta[] | null;
+    getUsedPipes(component: ts.ClassDeclaration): string[] | null;
     private getLatestComponentState;
     isTrackedTypeCheckFile(filePath: AbsoluteFsPath): boolean;
     private getFileRecordForTcbLocation;
@@ -119,6 +122,8 @@ export declare class TemplateTypeCheckerImpl implements TemplateTypeChecker {
     getPotentialTemplateDirectives(component: ts.ClassDeclaration): PotentialDirective[];
     getPotentialPipes(component: ts.ClassDeclaration): PotentialPipe[];
     getDirectiveMetadata(dir: ts.ClassDeclaration): TypeCheckableDirectiveMeta | null;
+    getNgModuleMetadata(module: ts.ClassDeclaration): NgModuleMeta | null;
+    getPipeMetadata(pipe: ts.ClassDeclaration): PipeMeta | null;
     getPotentialElementTags(component: ts.ClassDeclaration): Map<string, PotentialDirective | null>;
     getPotentialDomBindings(tagName: string): {
         attribute: string;
@@ -127,7 +132,8 @@ export declare class TemplateTypeCheckerImpl implements TemplateTypeChecker {
     getPotentialDomEvents(tagName: string): string[];
     getPrimaryAngularDecorator(target: ts.ClassDeclaration): ts.Decorator | null;
     getOwningNgModule(component: ts.ClassDeclaration): ts.ClassDeclaration | null;
-    getPotentialImportsFor(toImport: PotentialDirective, inContext: ts.ClassDeclaration): ReadonlyArray<PotentialImport>;
+    private emit;
+    getPotentialImportsFor(toImport: Reference<ClassDeclaration>, inContext: ts.ClassDeclaration, importMode: PotentialImportMode): ReadonlyArray<PotentialImport>;
     private getScopeData;
     private scopeDataOfDirectiveMeta;
     private scopeDataOfPipeMeta;