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

package/linker/src/file_linker/declaration_scope.d.ts

@@ -10,7 +10,7 @@
  *
  * For example, if you had the following code:
  *
- * ```
+ * ```ts
  * function foo() {
  *   function bar () {
  *     ɵɵngDeclareDirective({...});

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 = "19.1.0-next.1";
+export declare const PLACEHOLDER_VERSION = "19.1.0-next.3";
 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": "19.1.0-next.1",
+  "version": "19.1.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": "19.1.0-next.1",
+    "@angular/compiler": "19.1.0-next.3",
     "typescript": ">=5.5 <5.8"
   },
   "repository": {

package/src/ngtsc/core/api/src/options.d.ts

@@ -34,6 +34,10 @@ export interface TestOnlyOptions {
  * Internal only options for compiler.
  */
 export interface InternalOptions {
+    /**
+     * Whether to check the event side of two-way bindings.
+     */
+    _checkTwoWayBoundEvents?: boolean;
 }
 /**
  * A merged interface of all of the various Angular compiler options, as well as the standard

package/src/ngtsc/core/api/src/public_options.d.ts

@@ -265,14 +265,14 @@ export interface BazelAndG3Options {
      *
      * A consumer of such a path-mapped library will write an import like:
      *
-     * ```typescript
+     * ```ts
      * import {LibModule} from 'lib/deep/path/to/module';
      * ```
      *
      * The compiler will attempt to generate imports of directives/pipes from that same module
      * specifier (the compiler does not rewrite the user's given import path, unlike View Engine).
      *
-     * ```typescript
+     * ```ts
      * import {LibDir, LibCmp, LibPipe} from 'lib/deep/path/to/module';
      * ```
      *

package/src/ngtsc/diagnostics/src/error_code.d.ts

@@ -255,7 +255,7 @@ export declare enum ErrorCode {
      * The tracking expression of a `for` loop block is accessing a variable that is unavailable,
      * for example:
      *
-     * ```
+     * ```angular-html
      * <ng-template let-ref>
      *   @for (item of items; track ref) {}
      * </ng-template>
@@ -266,7 +266,7 @@ export declare enum ErrorCode {
      * The trigger of a `defer` block cannot access its trigger element,
      * either because it doesn't exist or it's in a different view.
      *
-     * ```
+     * ```angular-html
      * @defer (on interaction(trigger)) {...}
      *
      * <ng-template>
@@ -279,7 +279,7 @@ export declare enum ErrorCode {
      * A control flow node is projected at the root of a component and is preventing its direct
      * descendants from being projected, because it has more than one root node.
      *
-     * ```
+     * ```angular-html
      * <comp>
      *  @if (expr) {
      *    <div projectsIntoSlot></div>
@@ -314,7 +314,7 @@ export declare enum ErrorCode {
      * A two way binding in a template has an incorrect syntax,
      * parentheses outside brackets. For example:
      *
-     * ```
+     * ```html
      * <div ([foo])="bar" />
      * ```
      */
@@ -322,7 +322,7 @@ export declare enum ErrorCode {
     /**
      * The left side of a nullish coalescing operation is not nullable.
      *
-     * ```
+     * ```html
      * {{ foo ?? bar }}
      * ```
      * When the type of foo doesn't include `null` or `undefined`.
@@ -337,7 +337,7 @@ export declare enum ErrorCode {
      * A text attribute is not interpreted as a binding but likely intended to be.
      *
      * For example:
-     * ```
+     * ```html
      * <div
      *   attr.x="value"
      *   class.blue="true"
@@ -354,7 +354,7 @@ export declare enum ErrorCode {
      * in their statement.
      *
      * For example:
-     * ```
+     * ```html
      * <ul><li *ngFor="item of items">{{item["name"]}};</li></ul>
      * ```
      */
@@ -373,7 +373,7 @@ export declare enum ErrorCode {
     /**
      * The left side of an optional chain operation is not nullable.
      *
-     * ```
+     * ```html
      * {{ foo?.bar }}
      * {{ foo?.['bar'] }}
      * {{ foo?.() }}
@@ -385,7 +385,7 @@ export declare enum ErrorCode {
      * `ngSkipHydration` should not be a binding (it should be a static attribute).
      *
      * For example:
-     * ```
+     * ```html
      * <my-cmp [ngSkipHydration]="someTruthyVar" />
      * ```
      *
@@ -397,7 +397,7 @@ export declare enum ErrorCode {
      * Signal functions should be invoked when interpolated in templates.
      *
      * For example:
-     * ```
+     * ```html
      * {{ mySignal() }}
      * ```
      */
@@ -405,7 +405,7 @@ export declare enum ErrorCode {
     /**
      * Initializer-based APIs can only be invoked from inside of an initializer.
      *
-     * ```
+     * ```ts
      * // Allowed
      * myInput = input();
      *
@@ -420,7 +420,7 @@ export declare enum ErrorCode {
      * A function in an event binding is not called.
      *
      * For example:
-     * ```
+     * ```html
      * <button (click)="myFunc"></button>
      * ```
      *
@@ -432,7 +432,7 @@ export declare enum ErrorCode {
      * A `@let` declaration in a template isn't used.
      *
      * For example:
-     * ```
+     * ```angular-html
      * @let used = 1; <!-- Not an error -->
      * @let notUsed = 2; <!-- Error -->
      *

package/src/ngtsc/partial_evaluator/src/interpreter.d.ts

@@ -8,7 +8,7 @@
 import ts from 'typescript';
 import { DependencyTracker } from '../../incremental/api';
 import { ReflectionHost } from '../../reflection';
-import { ForeignFunctionResolver } from './interface';
+import type { ForeignFunctionResolver } from './interface';
 import { ResolvedValue } from './result';
 /**
  * Tracks the scope of a function body, which includes `ResolvedValue`s for the parameters of that

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

@@ -27,7 +27,7 @@ export declare function canEmitType(type: ts.TypeNode, canEmit: (type: ts.TypeRe
  *
  * For example, consider the following code:
  *
- * ```
+ * ```ts
  * import {NgIterable} from '@angular/core';
  *
  * class NgForOf<T, U extends NgIterable<T>> {}
@@ -39,7 +39,7 @@ export declare function canEmitType(type: ts.TypeNode, canEmit: (type: ts.TypeRe
  * `NgIterable` type reference to a type reference that is valid in the context in which it is
  * emitted, for example:
  *
- * ```
+ * ```ts
  * import * as i0 from '@angular/core';
  * import * as i1 from '@angular/common';
  *

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

@@ -304,6 +304,10 @@ export interface TypeCheckingConfig {
      * Whether to descend into the bodies of control flow blocks (`@if`, `@switch` and `@for`).
      */
     checkControlFlowBodies: boolean;
+    /**
+     * Whether the event side of a two-way binding should be type checked.
+     */
+    checkTwoWayBoundEvents: boolean;
 }
 export type TemplateSourceMapping = DirectTemplateSourceMapping | IndirectTemplateSourceMapping | ExternalTemplateSourceMapping;
 /**

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

@@ -2,10 +2,10 @@ import ts from 'typescript';
 export declare function relativePathBetween(from: string, to: string): string | null;
 export declare function normalizeSeparators(path: string): string;
 /**
- * Attempts to generate a project-relative path
- * @param sourceFile
- * @param rootDirs
- * @param compilerHost
+ * Attempts to generate a project-relative path for a file.
+ * @param fileName Absolute path to the file.
+ * @param rootDirs Root directories of the project.
+ * @param compilerHost Host used to resolve file names.
  * @returns
  */
-export declare function getProjectRelativePath(sourceFile: ts.SourceFile, rootDirs: readonly string[], compilerHost: Pick<ts.CompilerHost, 'getCanonicalFileName'>): string | null;
+export declare function getProjectRelativePath(fileName: string, rootDirs: readonly string[], compilerHost: Pick<ts.CompilerHost, 'getCanonicalFileName'>): string | null;