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

package/linker/src/ast/ast_value.d.ts

@@ -107,7 +107,7 @@ export declare class AstObject<T extends object, TExpression> {
      * Converts the AstObject to a raw JavaScript object, mapping each property value (as an
      * `AstValue`) to the generic type (`T`) via the `mapper` function.
      */
-    toLiteral<V>(mapper: (value: AstValue<ObjectValueType<T>, TExpression>) => V): Record<string, V>;
+    toLiteral<V>(mapper: (value: AstValue<ObjectValueType<T>, TExpression>, key: string) => V): Record<string, V>;
     /**
      * Converts the AstObject to a JavaScript Map, mapping each property value (as an
      * `AstValue`) to the generic type (`T`) via the `mapper` function.

package/package.json

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

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

@@ -8,7 +8,7 @@
 import { AnimationTriggerNames, R3ClassMetadata, R3ComponentMetadata, R3TemplateDependencyMetadata, SchemaMetadata } from '@angular/compiler';
 import ts from 'typescript';
 import { Reference } from '../../../imports';
-import { ClassPropertyMapping, ComponentResources, DirectiveTypeCheckMeta, HostDirectiveMeta } from '../../../metadata';
+import { ClassPropertyMapping, ComponentResources, DirectiveTypeCheckMeta, HostDirectiveMeta, InputMapping } from '../../../metadata';
 import { ClassDeclaration } from '../../../reflection';
 import { SubsetOfKeys } from '../../../util/src/typescript';
 import { ParsedTemplateWithSource, StyleUrlMeta } from './resources';
@@ -29,7 +29,7 @@ export interface ComponentAnalysisData {
     typeCheckMeta: DirectiveTypeCheckMeta;
     template: ParsedTemplateWithSource;
     classMetadata: R3ClassMetadata | null;
-    inputs: ClassPropertyMapping;
+    inputs: ClassPropertyMapping<InputMapping>;
     outputs: ClassPropertyMapping;
     /**
      * Providers extracted from the `providers` field of the component annotation which will require

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

@@ -9,7 +9,7 @@ import { ConstantPool, R3ClassMetadata, R3DirectiveMetadata } from '@angular/com
 import ts from 'typescript';
 import { Reference, ReferenceEmitter } from '../../../imports';
 import { SemanticDepGraphUpdater } from '../../../incremental/semantic_graph';
-import { ClassPropertyMapping, DirectiveTypeCheckMeta, HostDirectiveMeta, MetadataReader, MetadataRegistry } from '../../../metadata';
+import { ClassPropertyMapping, DirectiveTypeCheckMeta, HostDirectiveMeta, InputMapping, MetadataReader, MetadataRegistry } from '../../../metadata';
 import { PartialEvaluator } from '../../../partial_evaluator';
 import { PerfRecorder } from '../../../perf';
 import { ClassDeclaration, Decorator, ReflectionHost } from '../../../reflection';
@@ -23,7 +23,7 @@ export interface DirectiveHandlerData {
     meta: R3DirectiveMetadata;
     classMetadata: R3ClassMetadata | null;
     providersRequiringFactory: Set<Reference<ClassDeclaration>> | null;
-    inputs: ClassPropertyMapping;
+    inputs: ClassPropertyMapping<InputMapping>;
     outputs: ClassPropertyMapping;
     isPoisoned: boolean;
     isStructural: boolean;

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

@@ -8,7 +8,7 @@
 import { ParsedHostBindings, R3DirectiveMetadata, R3QueryMetadata } from '@angular/compiler';
 import ts from 'typescript';
 import { ReferenceEmitter } from '../../../imports';
-import { ClassPropertyMapping, HostDirectiveMeta } from '../../../metadata';
+import { ClassPropertyMapping, HostDirectiveMeta, InputMapping } from '../../../metadata';
 import { PartialEvaluator } from '../../../partial_evaluator';
 import { ClassDeclaration, ClassMember, Decorator, ReflectionHost } from '../../../reflection';
 import { HandlerFlags } from '../../../transform';
@@ -21,7 +21,7 @@ import { HandlerFlags } from '../../../transform';
 export declare function extractDirectiveMetadata(clazz: ClassDeclaration, decorator: Readonly<Decorator | null>, reflector: ReflectionHost, evaluator: PartialEvaluator, refEmitter: ReferenceEmitter, isCore: boolean, flags: HandlerFlags, annotateForClosureCompiler: boolean, defaultSelector?: string | null): {
     decorator: Map<string, ts.Expression>;
     metadata: R3DirectiveMetadata;
-    inputs: ClassPropertyMapping;
+    inputs: ClassPropertyMapping<InputMapping>;
     outputs: ClassPropertyMapping;
     isStructural: boolean;
     hostDirectives: HostDirectiveMeta[] | null;
@@ -29,4 +29,4 @@ export declare function extractDirectiveMetadata(clazz: ClassDeclaration, decora
 } | undefined;
 export declare function extractQueryMetadata(exprNode: ts.Node, name: string, args: ReadonlyArray<ts.Expression>, propertyName: string, reflector: ReflectionHost, evaluator: PartialEvaluator): R3QueryMetadata;
 export declare function extractHostBindings(members: ClassMember[], evaluator: PartialEvaluator, coreModule: string | undefined, metadata?: Map<string, ts.Expression>): ParsedHostBindings;
-export declare function parseFieldArrayValue(directive: Map<string, ts.Expression>, field: string, evaluator: PartialEvaluator): null | string[];
+export declare function parseFieldStringArrayValue(directive: Map<string, ts.Expression>, field: string, evaluator: PartialEvaluator): null | string[];

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

@@ -6,7 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { SemanticSymbol, SemanticTypeParameter } from '../../../incremental/semantic_graph';
-import { ClassPropertyMapping, DirectiveTypeCheckMeta } from '../../../metadata';
+import { ClassPropertyMapping, DirectiveTypeCheckMeta, InputMapping } from '../../../metadata';
 import { ClassDeclaration } from '../../../reflection';
 /**
  * Represents an Angular directive. Components are represented by `ComponentSymbol`, which inherits
@@ -14,13 +14,13 @@ import { ClassDeclaration } from '../../../reflection';
  */
 export declare class DirectiveSymbol extends SemanticSymbol {
     readonly selector: string | null;
-    readonly inputs: ClassPropertyMapping;
+    readonly inputs: ClassPropertyMapping<InputMapping>;
     readonly outputs: ClassPropertyMapping;
     readonly exportAs: string[] | null;
     readonly typeCheckMeta: DirectiveTypeCheckMeta;
     readonly typeParameters: SemanticTypeParameter[] | null;
     baseClass: SemanticSymbol | null;
-    constructor(decl: ClassDeclaration, selector: string | null, inputs: ClassPropertyMapping, outputs: ClassPropertyMapping, exportAs: string[] | null, typeCheckMeta: DirectiveTypeCheckMeta, typeParameters: SemanticTypeParameter[] | null);
+    constructor(decl: ClassDeclaration, selector: string | null, inputs: ClassPropertyMapping<InputMapping>, outputs: ClassPropertyMapping, exportAs: string[] | null, typeCheckMeta: DirectiveTypeCheckMeta, typeParameters: SemanticTypeParameter[] | null);
     isPublicApiAffected(previousSymbol: SemanticSymbol): boolean;
     isTypeCheckApiAffected(previousSymbol: SemanticSymbol): boolean;
 }

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

@@ -9,7 +9,7 @@ import { DirectiveMeta as T2DirectiveMeta, SchemaMetadata } from '@angular/compi
 import ts from 'typescript';
 import { Reference } from '../../imports';
 import { ClassDeclaration } from '../../reflection';
-import { ClassPropertyMapping, ClassPropertyName } from './property_mapping';
+import { ClassPropertyMapping, ClassPropertyName, InputOrOutput } from './property_mapping';
 /**
  * Metadata collected for an `NgModule`.
  */
@@ -104,6 +104,10 @@ export declare enum MatchSource {
     /** The directive was applied as a host directive. */
     HostDirective = 1
 }
+/** Metadata for a single input mapping. */
+export type InputMapping = InputOrOutput & {
+    required: boolean;
+};
 /**
  * Metadata collected for a directive within an NgModule's scope.
  */
@@ -120,7 +124,7 @@ export interface DirectiveMeta extends T2DirectiveMeta, DirectiveTypeCheckMeta {
     /**
      * A mapping of input field names to the property names.
      */
-    inputs: ClassPropertyMapping;
+    inputs: ClassPropertyMapping<InputMapping>;
     /**
      * A mapping of output field names to the property names.
      */

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

@@ -22,6 +22,7 @@ export declare class HostDirectivesResolver {
      * Filters the class property mappings so that only the allowed ones are present.
      * @param source Property mappings that should be filtered.
      * @param allowedProperties Property mappings that are allowed in the final results.
+     * @param valueResolver Function used to resolve the value that is assigned to the final mapping.
      */
     private filterMappings;
 }

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

@@ -44,7 +44,7 @@ export interface InputOrOutput {
  * Allows bidirectional querying of the mapping - looking up all inputs/outputs with a given
  * property name, or mapping from a specific class property to its binding property name.
  */
-export declare class ClassPropertyMapping implements InputOutputPropertySet {
+export declare class ClassPropertyMapping<T extends InputOrOutput = InputOrOutput> implements InputOutputPropertySet {
     /**
      * Mapping from class property names to the single `InputOrOutput` for that class property.
      */
@@ -57,20 +57,20 @@ export declare class ClassPropertyMapping implements InputOutputPropertySet {
     /**
      * Construct a `ClassPropertyMapping` with no entries.
      */
-    static empty(): ClassPropertyMapping;
+    static empty<T extends InputOrOutput>(): ClassPropertyMapping<T>;
     /**
      * Construct a `ClassPropertyMapping` from a primitive JS object which maps class property names
      * to either binding property names or an array that contains both names, which is used in on-disk
      * metadata formats (e.g. in .d.ts files).
      */
-    static fromMappedObject(obj: {
-        [classPropertyName: string]: BindingPropertyName | [ClassPropertyName, BindingPropertyName];
-    }): ClassPropertyMapping;
+    static fromMappedObject<T extends InputOrOutput>(obj: {
+        [classPropertyName: string]: BindingPropertyName | [ClassPropertyName, BindingPropertyName] | T;
+    }): ClassPropertyMapping<T>;
     /**
      * Merge two mappings into one, with class properties from `b` taking precedence over class
      * properties from `a`.
      */
-    static merge(a: ClassPropertyMapping, b: ClassPropertyMapping): ClassPropertyMapping;
+    static merge<T extends InputOrOutput>(a: ClassPropertyMapping<T>, b: ClassPropertyMapping<T>): ClassPropertyMapping<T>;
     /**
      * All class property names mapped in this mapping.
      */
@@ -86,11 +86,11 @@ export declare class ClassPropertyMapping implements InputOutputPropertySet {
     /**
      * Lookup all `InputOrOutput`s that use this `propertyName`.
      */
-    getByBindingPropertyName(propertyName: string): ReadonlyArray<InputOrOutput> | null;
+    getByBindingPropertyName(propertyName: string): ReadonlyArray<T> | null;
     /**
      * Lookup the `InputOrOutput` associated with a `classPropertyName`.
      */
-    getByClassPropertyName(classPropertyName: string): InputOrOutput | null;
+    getByClassPropertyName(classPropertyName: string): T | null;
     /**
      * Convert this mapping to a primitive JS object which maps each class property directly to the
      * binding property name associated with it.
@@ -106,11 +106,11 @@ export declare class ClassPropertyMapping implements InputOutputPropertySet {
      * This object format is used when mappings are serialized (for example into .d.ts files).
      */
     toJointMappedObject(): {
-        [classPropertyName: string]: BindingPropertyName | [BindingPropertyName, ClassPropertyName];
+        [classPropertyName: string]: T;
     };
     /**
      * Implement the iterator protocol and return entry objects which contain the class and binding
      * property names (and are useful for destructuring).
      */
-    [Symbol.iterator](): IterableIterator<[ClassPropertyName, BindingPropertyName]>;
+    [Symbol.iterator](): IterableIterator<T>;
 }

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

@@ -8,7 +8,7 @@
 import ts from 'typescript';
 import { OwningModule, Reference } from '../../imports';
 import { ClassDeclaration, ReflectionHost } from '../../reflection';
-import { DirectiveMeta, DirectiveTypeCheckMeta, MetadataReader, NgModuleMeta, PipeMeta } from './api';
+import { DirectiveMeta, DirectiveTypeCheckMeta, InputMapping, MetadataReader, NgModuleMeta, PipeMeta } from './api';
 import { ClassPropertyMapping } from './property_mapping';
 export declare function extractReferencesFromType(checker: ts.TypeChecker, def: ts.TypeNode, bestGuessOwningModule: OwningModule | null): Reference<ClassDeclaration>[];
 export declare function extraReferenceFromTypeQuery(checker: ts.TypeChecker, typeNode: ts.TypeQueryNode, origin: ts.TypeNode, bestGuessOwningModule: OwningModule | null): Reference<ClassDeclaration<ts.ClassDeclaration>>;
@@ -23,7 +23,7 @@ export declare function readStringArrayType(type: ts.TypeNode): string[];
  * that use the directive. This metadata does not contain information from a base class, if any,
  * making this metadata invariant to changes of inherited classes.
  */
-export declare function extractDirectiveTypeCheckMeta(node: ClassDeclaration, inputs: ClassPropertyMapping, reflector: ReflectionHost): DirectiveTypeCheckMeta;
+export declare function extractDirectiveTypeCheckMeta(node: ClassDeclaration, inputs: ClassPropertyMapping<InputMapping>, reflector: ReflectionHost): DirectiveTypeCheckMeta;
 /**
  * A `MetadataReader` that reads from an ordered set of child readers until it obtains the requested
  * metadata.

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

@@ -9,7 +9,7 @@ import { AbsoluteSourceSpan, BoundTarget, DirectiveMeta, ParseSourceSpan, Schema
 import ts from 'typescript';
 import { ErrorCode } from '../../diagnostics';
 import { Reference } from '../../imports';
-import { ClassPropertyMapping, DirectiveTypeCheckMeta, HostDirectiveMeta } from '../../metadata';
+import { ClassPropertyMapping, DirectiveTypeCheckMeta, HostDirectiveMeta, InputMapping } from '../../metadata';
 import { ClassDeclaration } from '../../reflection';
 /**
  * Extension of `DirectiveMeta` that includes additional information required to type-check the
@@ -18,7 +18,7 @@ import { ClassDeclaration } from '../../reflection';
 export interface TypeCheckableDirectiveMeta extends DirectiveMeta, DirectiveTypeCheckMeta {
     ref: Reference<ClassDeclaration>;
     queries: string[];
-    inputs: ClassPropertyMapping;
+    inputs: ClassPropertyMapping<InputMapping>;
     outputs: ClassPropertyMapping;
     isStandalone: boolean;
     hostDirectives: HostDirectiveMeta[] | null;

package/src/transformers/downlevel_decorators_transform/downlevel_decorators_transform.d.ts

@@ -8,17 +8,15 @@
 import ts from 'typescript';
 import { ReflectionHost } from '../../ngtsc/reflection';
 /**
- * Gets a transformer for downleveling Angular decorators.
+ * Gets a transformer for downleveling Angular constructor parameter and property decorators.
+ *
+ * Note that Angular class decorators are never processed as those rely on side effects that
+ * would otherwise no longer be executed. i.e. the creation of a component definition.
+ *
  * @param typeChecker Reference to the program's type checker.
  * @param host Reflection host that is used for determining decorators.
  * @param diagnostics List which will be populated with diagnostics if any.
  * @param isCore Whether the current TypeScript program is for the `@angular/core` package.
  * @param isClosureCompilerEnabled Whether closure annotations need to be added where needed.
- * @param skipClassDecorators Whether class decorators should be skipped from downleveling.
- *   This is useful for JIT mode where class decorators should be preserved as they could rely
- *   on immediate execution. e.g. downleveling `@Injectable` means that the injectable factory
- *   is not created, and injecting the token will not work. If this decorator would not be
- *   downleveled, the `Injectable` decorator will execute immediately on file load, and
- *   Angular will generate the corresponding injectable factory.
  */
-export declare function getDownlevelDecoratorsTransform(typeChecker: ts.TypeChecker, host: ReflectionHost, diagnostics: ts.Diagnostic[], isCore: boolean, isClosureCompilerEnabled: boolean, skipClassDecorators: boolean): ts.TransformerFactory<ts.SourceFile>;
+export declare function getDownlevelDecoratorsTransform(typeChecker: ts.TypeChecker, host: ReflectionHost, diagnostics: ts.Diagnostic[], isCore: boolean, isClosureCompilerEnabled: boolean): ts.TransformerFactory<ts.SourceFile>;