@angular/compiler-cli 16.2.0-next.1 → 16.2.0-next.3

package/linker/babel/src/ast/babel_ast_factory.d.ts

@@ -29,6 +29,7 @@ export declare class BabelAstFactory implements AstFactory<t.Statement, t.Expres
     createFunctionExpression(functionName: string | null, parameters: string[], body: t.Statement): t.Expression;
     createIdentifier: typeof t.identifier;
     createIfStatement: typeof t.ifStatement;
+    createDynamicImport(url: string): t.Expression;
     createLiteral(value: string | number | boolean | null | undefined): t.Expression;
     createNewExpression: typeof t.newExpression;
     createObjectLiteral(properties: ObjectLiteralProperty<t.Expression>[]): t.Expression;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/compiler-cli",
-  "version": "16.2.0-next.1",
+  "version": "16.2.0-next.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": "16.2.0-next.1",
+    "@angular/compiler": "16.2.0-next.3",
     "typescript": ">=4.9.3 <5.2"
   },
   "repository": {

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

@@ -17,7 +17,7 @@ import { PartialEvaluator } from '../../../partial_evaluator';
 import { PerfRecorder } from '../../../perf';
 import { ClassDeclaration, Decorator, ReflectionHost } from '../../../reflection';
 import { ComponentScopeReader, DtsModuleScopeResolver, LocalModuleScopeRegistry, TypeCheckScopeRegistry } from '../../../scope';
-import { AnalysisOutput, CompileResult, DecoratorHandler, DetectResult, HandlerPrecedence, ResolveResult } from '../../../transform';
+import { AnalysisOutput, CompilationMode, CompileResult, DecoratorHandler, DetectResult, HandlerPrecedence, ResolveResult } from '../../../transform';
 import { TypeCheckContext } from '../../../typecheck/api';
 import { ExtendedTemplateChecker } from '../../../typecheck/extended/api';
 import { Xi18nContext } from '../../../xi18n';
@@ -46,6 +46,7 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     private enableI18nLegacyMessageIdFormat;
     private usePoisonedData;
     private i18nNormalizeLineEndingsInICUs;
+    private enabledBlockTypes;
     private moduleResolver;
     private cycleAnalyzer;
     private cycleHandlingStrategy;
@@ -58,7 +59,8 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     private perf;
     private hostDirectivesResolver;
     private includeClassMetadata;
-    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);
+    private readonly compilationMode;
+    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, enabledBlockTypes: Set<string>, 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);
     private literalCache;
     private elementSchemaRegistry;
     /**
@@ -84,6 +86,7 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     updateResources(node: ClassDeclaration, analysis: ComponentAnalysisData): void;
     compileFull(node: ClassDeclaration, analysis: Readonly<ComponentAnalysisData>, resolution: Readonly<ComponentResolutionData>, pool: ConstantPool): CompileResult[];
     compilePartial(node: ClassDeclaration, analysis: Readonly<ComponentAnalysisData>, resolution: Readonly<ComponentResolutionData>): CompileResult[];
+    compileLocal(node: ClassDeclaration, analysis: Readonly<ComponentAnalysisData>, pool: ConstantPool): CompileResult[];
     /**
      * Check whether adding an import from `origin` to the source-file corresponding to `expr` would
      * create a cyclic import.

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

@@ -98,6 +98,7 @@ export interface ExtractTemplateOptions {
     usePoisonedData: boolean;
     enableI18nLegacyMessageIdFormat: boolean;
     i18nNormalizeLineEndingsInICUs: boolean;
+    enabledBlockTypes: Set<string>;
 }
 export declare function extractTemplate(node: ClassDeclaration, template: TemplateDeclaration, evaluator: PartialEvaluator, depTracker: DependencyTracker | null, resourceLoader: ResourceLoader, options: ExtractTemplateOptions): ParsedTemplateWithSource;
 export declare function parseTemplateDeclaration(node: ClassDeclaration, decorator: Decorator, component: Map<string, ts.Expression>, containingFile: string, evaluator: PartialEvaluator, depTracker: DependencyTracker | null, resourceLoader: ResourceLoader, defaultPreserveWhitespaces: boolean): TemplateDeclaration;

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

@@ -56,6 +56,7 @@ export declare class DirectiveDecoratorHandler implements DecoratorHandler<Decor
     resolve(node: ClassDeclaration, analysis: DirectiveHandlerData, symbol: DirectiveSymbol): ResolveResult<unknown>;
     compileFull(node: ClassDeclaration, analysis: Readonly<DirectiveHandlerData>, resolution: Readonly<unknown>, pool: ConstantPool): CompileResult[];
     compilePartial(node: ClassDeclaration, analysis: Readonly<DirectiveHandlerData>, resolution: Readonly<unknown>): CompileResult[];
+    compileLocal(node: ClassDeclaration, analysis: Readonly<DirectiveHandlerData>, pool: ConstantPool): CompileResult[];
     /**
      * Checks if a given class uses Angular features and returns the TypeScript node
      * that indicated the usage. Classes are considered using Angular features if they

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

@@ -14,7 +14,7 @@ import { PartialEvaluator } from '../../../partial_evaluator';
 import { PerfRecorder } from '../../../perf';
 import { ClassDeclaration, Decorator, ReflectionHost } from '../../../reflection';
 import { LocalModuleScopeRegistry } from '../../../scope';
-import { AnalysisOutput, CompileResult, DecoratorHandler, DetectResult, HandlerPrecedence, ResolveResult } from '../../../transform';
+import { AnalysisOutput, CompilationMode, CompileResult, DecoratorHandler, DetectResult, HandlerPrecedence, ResolveResult } from '../../../transform';
 import { InjectableClassRegistry, ReferencesRegistry } from '../../common';
 export interface NgModuleAnalysis {
     mod: R3NgModuleMetadata;
@@ -81,7 +81,9 @@ export declare class NgModuleDecoratorHandler implements DecoratorHandler<Decora
     private injectableRegistry;
     private perf;
     private includeClassMetadata;
-    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaReader: MetadataReader, metaRegistry: MetadataRegistry, scopeRegistry: LocalModuleScopeRegistry, referencesRegistry: ReferencesRegistry, exportedProviderStatusResolver: ExportedProviderStatusResolver, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, isCore: boolean, refEmitter: ReferenceEmitter, annotateForClosureCompiler: boolean, onlyPublishPublicTypings: boolean, injectableRegistry: InjectableClassRegistry, perf: PerfRecorder, includeClassMetadata: boolean);
+    private includeSelectorScope;
+    private readonly compilationMode;
+    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaReader: MetadataReader, metaRegistry: MetadataRegistry, scopeRegistry: LocalModuleScopeRegistry, referencesRegistry: ReferencesRegistry, exportedProviderStatusResolver: ExportedProviderStatusResolver, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, isCore: boolean, refEmitter: ReferenceEmitter, annotateForClosureCompiler: boolean, onlyPublishPublicTypings: boolean, injectableRegistry: InjectableClassRegistry, perf: PerfRecorder, includeClassMetadata: boolean, includeSelectorScope: boolean, compilationMode: CompilationMode);
     readonly precedence = HandlerPrecedence.PRIMARY;
     readonly name = "NgModuleDecoratorHandler";
     detect(node: ClassDeclaration, decorators: Decorator[] | null): DetectResult<Decorator> | undefined;
@@ -91,6 +93,7 @@ export declare class NgModuleDecoratorHandler implements DecoratorHandler<Decora
     resolve(node: ClassDeclaration, analysis: Readonly<NgModuleAnalysis>): ResolveResult<NgModuleResolution>;
     compileFull(node: ClassDeclaration, { inj, mod, fac, classMetadata, declarations, remoteScopesMayRequireCycleProtection }: Readonly<NgModuleAnalysis>, { injectorImports }: Readonly<NgModuleResolution>): CompileResult[];
     compilePartial(node: ClassDeclaration, { inj, fac, mod, classMetadata }: Readonly<NgModuleAnalysis>, { injectorImports }: Readonly<NgModuleResolution>): CompileResult[];
+    compileLocal(node: ClassDeclaration, { inj, mod, fac, classMetadata, declarations, remoteScopesMayRequireCycleProtection }: Readonly<NgModuleAnalysis>): CompileResult[];
     /**
      * Add class metadata statements, if provided, to the `ngModuleStatements`.
      */

package/src/ngtsc/annotations/src/injectable.d.ts

@@ -52,5 +52,6 @@ export declare class InjectableDecoratorHandler implements DecoratorHandler<Deco
     resolve(node: ClassDeclaration, analysis: Readonly<InjectableHandlerData>, symbol: null): ResolveResult<unknown>;
     compileFull(node: ClassDeclaration, analysis: Readonly<InjectableHandlerData>): CompileResult[];
     compilePartial(node: ClassDeclaration, analysis: Readonly<InjectableHandlerData>): CompileResult[];
+    compileLocal(node: ClassDeclaration, analysis: Readonly<InjectableHandlerData>): CompileResult[];
     private compile;
 }

package/src/ngtsc/annotations/src/pipe.d.ts

@@ -49,4 +49,5 @@ export declare class PipeDecoratorHandler implements DecoratorHandler<Decorator,
     resolve(node: ClassDeclaration): ResolveResult<unknown>;
     compileFull(node: ClassDeclaration, analysis: Readonly<PipeHandlerData>): CompileResult[];
     compilePartial(node: ClassDeclaration, analysis: Readonly<PipeHandlerData>): CompileResult[];
+    compileLocal(node: ClassDeclaration, analysis: Readonly<PipeHandlerData>): CompileResult[];
 }

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

@@ -126,6 +126,7 @@ export declare class NgCompiler {
     private moduleResolver;
     private resourceManager;
     private cycleAnalyzer;
+    private enabledBlockTypes;
     readonly ignoreForDiagnostics: Set<ts.SourceFile>;
     readonly ignoreForEmit: Set<ts.SourceFile>;
     readonly enableTemplateTypeChecker: boolean;

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

@@ -150,8 +150,8 @@ export interface DecoratorHandler<D, A, S extends SemanticSymbol | null, R> {
      * Generate a description of the field which should be added to the class, including any
      * initialization code to be generated.
      *
-     * If the compilation mode is configured as partial, and an implementation of `compilePartial` is
-     * provided, then this method is not called.
+     * If the compilation mode is configured as other than full but an implementation of the
+     * corresponding method is not provided, then this method is called as a fallback.
      */
     compileFull(node: ClassDeclaration, analysis: Readonly<A>, resolution: Readonly<R>, constantPool: ConstantPool): CompileResult | CompileResult[];
     /**
@@ -163,6 +163,11 @@ export interface DecoratorHandler<D, A, S extends SemanticSymbol | null, R> {
      * `compileFull` is.
      */
     compilePartial?(node: ClassDeclaration, analysis: Readonly<A>, resolution: Readonly<R>): CompileResult | CompileResult[];
+    /**
+     * Generates code based on each individual source file without using its
+     * dependencies (suitable for local dev edit/refresh workflow)
+     */
+    compileLocal(node: ClassDeclaration, analysis: Readonly<A>, constantPool: ConstantPool): CompileResult | CompileResult[];
 }
 /**
  * The output of detecting a trait for a declaration as the result of the first phase of the

package/src/ngtsc/transform/src/compilation.d.ts

@@ -90,7 +90,8 @@ export declare class TraitCompiler implements ProgramTypeCheckAdapter {
     recordFor(clazz: ClassDeclaration): ClassRecord | null;
     getAnalyzedRecords(): Map<ts.SourceFile, ClassRecord[]>;
     /**
-     * Import a `ClassRecord` from a previous compilation.
+     * Import a `ClassRecord` from a previous compilation (only to be used in global compilation
+     * modes)
      *
      * Traits from the `ClassRecord` have accurate metadata, but the `handler` is from the old program
      * and needs to be updated (matching is done by name). A new pending trait is created and then

package/src/ngtsc/translator/src/api/ast_factory.d.ts

@@ -93,6 +93,13 @@ export interface AstFactory<TStatement, TExpression> {
      * @param body a statement (or a block of statements) that are the body of the function.
      */
     createFunctionExpression(functionName: string | null, parameters: string[], body: TStatement): TExpression;
+    /**
+     * Creates an expression that represents a dynamic import
+     * (e.g. `import('./some/path')`)
+     *
+     * @param url the URL that should by used in the dynamic import
+     */
+    createDynamicImport(url: string): TExpression;
     /**
      * Create an identifier.
      *

package/src/ngtsc/translator/src/translator.d.ts

@@ -45,6 +45,7 @@ export declare class ExpressionTranslatorVisitor<TStatement, TExpression> implem
     private createES5TaggedTemplateFunctionCall;
     visitExternalExpr(ast: o.ExternalExpr, _context: Context): TExpression;
     visitConditionalExpr(ast: o.ConditionalExpr, context: Context): TExpression;
+    visitDynamicImportExpr(ast: o.DynamicImportExpr, context: any): TExpression;
     visitNotExpr(ast: o.NotExpr, context: Context): TExpression;
     visitFunctionExpr(ast: o.FunctionExpr, context: Context): TExpression;
     visitBinaryOperatorExpr(ast: o.BinaryOperatorExpr, context: Context): TExpression;

package/src/ngtsc/translator/src/typescript_ast_factory.d.ts

@@ -23,6 +23,7 @@ export declare class TypeScriptAstFactory implements AstFactory<ts.Statement, ts
     createConditional(condition: ts.Expression, whenTrue: ts.Expression, whenFalse: ts.Expression): ts.Expression;
     createElementAccess: (expression: ts.Expression, index: number | ts.Expression) => ts.ElementAccessExpression;
     createExpressionStatement: (expression: ts.Expression) => ts.ExpressionStatement;
+    createDynamicImport(url: string): ts.CallExpression;
     createFunctionDeclaration(functionName: string, parameters: string[], body: ts.Statement): ts.Statement;
     createFunctionExpression(functionName: string | null, parameters: string[], body: ts.Statement): ts.Expression;
     createIdentifier: (text: string) => ts.Identifier;