@angular/compiler-cli 17.0.0-rc.0 → 17.0.0-rc.2

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.0.0-rc.0";
+export declare const PLACEHOLDER_VERSION = "17.0.0-rc.2";
 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.0.0-rc.0",
+  "version": "17.0.0-rc.2",
   "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.0.0-rc.0",
+    "@angular/compiler": "17.0.0-rc.2",
     "typescript": ">=5.2 <5.3"
   },
   "repository": {
@@ -67,7 +67,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=18.13.0"
+    "node": "^18.13.0 || >=20.9.0"
   },
   "bugs": {
     "url": "https://github.com/angular/angular/issues"

package/src/ngtsc/docs/src/decorator_extractor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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';
+import { DecoratorEntry } from './entities';
+/** Extracts an API documentation entry for an Angular decorator. */
+export declare function extractorDecorator(declaration: ts.VariableDeclaration, typeChecker: ts.TypeChecker): DecoratorEntry;
+/** Gets whether the given variable declaration is an Angular decorator declaration. */
+export declare function isDecoratorDeclaration(declaration: ts.VariableDeclaration): boolean;
+/** Gets whether an interface is the options interface for a decorator in the same file. */
+export declare function isDecoratorOptionsInterface(declaration: ts.InterfaceDeclaration): boolean;

package/src/ngtsc/docs/src/entities.d.ts

@@ -7,7 +7,7 @@
  */
 /** Type of top-level documentation entry. */
 export declare enum EntryType {
-    Block = "Block",
+    Block = "block",
     Component = "component",
     Constant = "constant",
     Decorator = "decorator",
@@ -29,6 +29,11 @@ export declare enum MemberType {
     Setter = "setter",
     EnumItem = "enum_item"
 }
+export declare enum DecoratorType {
+    Class = "class",
+    Member = "member",
+    Parameter = "parameter"
+}
 /** Informational tags applicable to class members. */
 export declare enum MemberTags {
     Abstract = "abstract",
@@ -37,7 +42,8 @@ export declare enum MemberTags {
     Protected = "protected",
     Optional = "optional",
     Input = "input",
-    Output = "output"
+    Output = "output",
+    Inherited = "override"
 }
 /** Documentation entity for single JsDoc tag. */
 export interface JsDocTagEntry {
@@ -76,6 +82,11 @@ export type InterfaceEntry = ClassEntry;
 export interface EnumEntry extends DocEntry {
     members: EnumMemberEntry[];
 }
+/** Documentation entity for an Angular decorator. */
+export interface DecoratorEntry extends DocEntry {
+    decoratorType: DecoratorType;
+    members: PropertyEntry[];
+}
 /** Documentation entity for an Angular directives and components. */
 export interface DirectiveEntry extends ClassEntry {
     selector: string;

package/src/ngtsc/docs/src/jsdoc_extractor.d.ts

@@ -15,7 +15,7 @@ export declare function extractJsDocTags(node: ts.HasJSDoc): JsDocTagEntry[];
  */
 export declare function extractJsDocDescription(node: ts.HasJSDoc): string;
 /**
- * Gets the raw JsDoc applied to a node. If the node does not have a JsDoc block,
- * returns the empty string.
+ * Gets the raw JsDoc applied to a node.
+ * If the node does not have a JsDoc block, returns the empty string.
  */
 export declare function extractRawJsDoc(node: ts.HasJSDoc): string;

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

@@ -119,7 +119,7 @@ export type InputMapping = InputOrOutput & {
 /** Metadata for an input's transform function. */
 export interface InputTransform {
     node: ts.Node;
-    type: ts.TypeNode;
+    type: Reference<ts.TypeNode>;
 }
 /**
  * Metadata collected for a directive within an NgModule's scope.

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

@@ -10,6 +10,7 @@ export { ImportGenerator, NamedImport } from './src/api/import_generator';
 export { Context } from './src/context';
 export { Import, ImportManager } from './src/import_manager';
 export { ExpressionTranslatorVisitor, RecordWrappedNodeFn, TranslatorOptions } from './src/translator';
+export { canEmitType, TypeEmitter, TypeReferenceTranslator } from './src/type_emitter';
 export { translateType } from './src/type_translator';
 export { attachComments, createTemplateMiddle, createTemplateTail, TypeScriptAstFactory } from './src/typescript_ast_factory';
 export { translateExpression, translateStatement } from './src/typescript_translator';

package/src/ngtsc/typecheck/extended/checks/missing_control_flow_directive/index.d.ts

@@ -16,5 +16,8 @@ import { TemplateCheckFactory } from '../../api';
  * are used as structural directives and a warning would be generated. Once the
  * `CommonModule` is included, the `ngSwitch` would also be covered.
  */
-export declare const KNOWN_CONTROL_FLOW_DIRECTIVES: Map<string, string>;
+export declare const KNOWN_CONTROL_FLOW_DIRECTIVES: Map<string, {
+    directive: string;
+    builtIn: string;
+}>;
 export declare const factory: TemplateCheckFactory<ErrorCode.MISSING_CONTROL_FLOW_DIRECTIVE, ExtendedTemplateDiagnosticName.MISSING_CONTROL_FLOW_DIRECTIVE>;

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

@@ -67,8 +67,8 @@ export declare class Environment implements ReferenceEmitEnvironment {
     /**
      * Generates a `ts.TypeNode` representing a type that is being referenced from a different place
      * in the program. Any type references inside the transplanted type will be rewritten so that
-     * they can be imported in the context fiel.
+     * they can be imported in the context file.
      */
-    referenceTransplantedType(type: TransplantedType<ts.TypeNode>): ts.TypeNode;
+    referenceTransplantedType(type: TransplantedType<Reference<ts.TypeNode>>): ts.TypeNode;
     getPreludeStatements(): ts.Statement[];
 }