@angular/core 18.0.0-next.4 → 18.0.0-next.5

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v18.0.0-next.4
+ * @license Angular v18.0.0-next.5
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -639,7 +639,6 @@ export declare class ApplicationModule {
  * @publicApi
  */
 export declare class ApplicationRef {
-    private _runningTick;
     private _destroyed;
     private _destroyListeners;
     private readonly internalErrorHandler;
@@ -647,7 +646,6 @@ export declare class ApplicationRef {
     private readonly zonelessEnabled;
     private externalTestViews;
     private beforeRender;
-    private afterTick;
     /**
      * Indicates whether this instance was destroyed.
      */
@@ -961,6 +959,19 @@ export declare interface BootstrapOptions {
      *
      */
     ngZoneRunCoalescing?: boolean;
+    /**
+     * When false, change detection is scheduled when Angular receives
+     * a clear indication that templates need to be refreshed. This includes:
+     *
+     * - calling `ChangeDetectorRef.markForCheck`
+     * - calling `ComponentRef.setInput`
+     * - updating a signal that is read in a template
+     * - when bound host or template listeners are triggered
+     * - attaching a view that is marked dirty
+     * - removing a view
+     * - registering a render hook (templates are only refreshed if render hooks do one of the above)
+     */
+    ignoreChangesOutsideZone?: boolean;
 }
 
 
@@ -4585,67 +4596,6 @@ export declare interface HostListener {
 }
 
 /**
- * Decorator that binds a DOM event to a host listener and supplies configuration metadata.
- * Angular invokes the supplied handler method when the host element emits the specified event,
- * and updates the bound element with the result.
- *
- * If the handler method returns false, applies `preventDefault` on the bound element.
- *
- * @usageNotes
- *
- * The following example declares a directive
- * that attaches a click listener to a button and counts clicks.
- *
- * ```ts
- * @Directive({selector: 'button[counting]'})
- * class CountClicks {
- *   numberOfClicks = 0;
- *
- *   @HostListener('click', ['$event.target'])
- *   onClick(btn) {
- *     console.log('button', btn, 'number of clicks:', this.numberOfClicks++);
- *   }
- * }
- *
- * @Component({
- *   selector: 'app',
- *   template: '<button counting>Increment</button>',
- * })
- * class App {}
- *
- * ```
- *
- * The following example registers another DOM event handler that listens for `Enter` key-press
- * events on the global `window`.
- * ``` ts
- * import { HostListener, Component } from "@angular/core";
- *
- * @Component({
- *   selector: 'app',
- *   template: `<h1>Hello, you have pressed enter {{counter}} number of times!</h1> Press enter key
- * to increment the counter.
- *   <button (click)="resetCounter()">Reset Counter</button>`
- * })
- * class AppComponent {
- *   counter = 0;
- *   @HostListener('window:keydown.enter', ['$event'])
- *   handleKeyDown(event: KeyboardEvent) {
- *     this.counter++;
- *   }
- *   resetCounter() {
- *     this.counter = 0;
- *   }
- * }
- * ```
- * The list of valid key names for `keydown` and `keyup` events
- * can be found here:
- * https://www.w3.org/TR/DOM-Level-3-Events-key/#named-key-attribute-values
- *
- * Note that keys can also be combined, e.g. `@HostListener('keydown.shift.a')`.
- *
- * The global target names that can be used to prefix an event name are
- * `document:`, `window:` and `body:`.
- *
  * @Annotation
  * @publicApi
  */
@@ -4665,6 +4615,60 @@ export declare interface HostListenerDecorator {
      * and updates the bound element with the result.
      *
      * If the handler method returns false, applies `preventDefault` on the bound element.
+     *
+     * @usageNotes
+     *
+     * The following example declares a directive
+     * that attaches a click listener to a button and counts clicks.
+     *
+     * ```ts
+     * @Directive({selector: 'button[counting]'})
+     * class CountClicks {
+     *   numberOfClicks = 0;
+     *
+     *   @HostListener('click', ['$event.target'])
+     *   onClick(btn) {
+     *     console.log('button', btn, 'number of clicks:', this.numberOfClicks++);
+     *   }
+     * }
+     *
+     * @Component({
+     *   selector: 'app',
+     *   template: '<button counting>Increment</button>',
+     * })
+     * class App {}
+     * ```
+     *
+     * The following example registers another DOM event handler that listens for `Enter` key-press
+     * events on the global `window`.
+     * ```ts
+     * import { HostListener, Component } from "@angular/core";
+     *
+     * @Component({
+     *   selector: 'app',
+     *   template: `<h1>Hello, you have pressed enter {{counter}} number of times!</h1> Press enter
+     * key to increment the counter. <button (click)="resetCounter()">Reset Counter</button>`
+     * })
+     * class AppComponent {
+     *   counter = 0;
+     *   @HostListener('window:keydown.enter', ['$event'])
+     *   handleKeyDown(event: KeyboardEvent) {
+     *     this.counter++;
+     *   }
+     *   resetCounter() {
+     *     this.counter = 0;
+     *   }
+     * }
+     * ```
+     * The list of valid key names for `keydown` and `keyup` events
+     * can be found here:
+     * https://www.w3.org/TR/DOM-Level-3-Events-key/#named-key-attribute-values
+     *
+     * Note that keys can also be combined, e.g. `@HostListener('keydown.shift.a')`.
+     *
+     * The global target names that can be used to prefix an event name are
+     * `document:`, `window:` and `body:`.
+     *
      */
     (eventName: string, args?: string[]): any;
     new (eventName: string, args?: string[]): any;
@@ -7476,6 +7480,19 @@ export declare interface NgZoneOptions {
      *
      */
     runCoalescing?: boolean;
+    /**
+     * When false, change detection is scheduled when Angular receives
+     * a clear indication that templates need to be refreshed. This includes:
+     *
+     * - calling `ChangeDetectorRef.markForCheck`
+     * - calling `ComponentRef.setInput`
+     * - updating a signal that is read in a template
+     * - when bound host or template listeners are triggered
+     * - attaching a view that is marked dirty
+     * - removing a view
+     * - registering a render hook (templates are only refreshed if render hooks do one of the above)
+     */
+    ignoreChangesOutsideZone?: boolean;
 }
 
 /**
@@ -8060,9 +8077,7 @@ declare interface PlatformReflectionCapabilities {
  *
  * @publicApi
  */
-export declare interface Predicate<T> {
-    (value: T): boolean;
-}
+export declare type Predicate<T> = (value: T) => boolean;
 
 declare const PREORDER_HOOK_FLAGS = 17;
 
@@ -8097,6 +8112,47 @@ declare type ProcessProvidersFunction = (providers: Provider[]) => Provider[];
  */
 declare type ProjectionSlots = (ɵCssSelectorList | '*')[];
 
+/**
+ * Provides change detection without ZoneJS for the application bootstrapped using
+ * `bootstrapApplication`.
+ *
+ * This function allows you to configure the application to not use the state/state changes of
+ * ZoneJS to schedule change detection in the application. This will work when ZoneJS is not present
+ * on the page at all or if it exists because something else is using it (either another Angular
+ * application which uses ZoneJS for scheduling or some other library that relies on ZoneJS).
+ *
+ * This can also be added to the `TestBed` providers to configure the test environment to more
+ * closely match production behavior. This will help give higher confidence that components are
+ * compatible with zoneless change detection.
+ *
+ * ZoneJS uses browser events to trigger change detection. When using this provider, Angular will
+ * instead use Angular APIs to schedule change detection. These APIs include:
+ *
+ * - `ChangeDetectorRef.markForCheck`
+ * - `ComponentRef.setInput`
+ * - updating a signal that is read in a template
+ * - when bound host or template listeners are triggered
+ * - attaching a view that was marked dirty by one of the above
+ * - removing a view
+ * - registering a render hook (templates are only refreshed if render hooks do one of the above)
+ *
+ * @usageNotes
+ * ```typescript
+ * bootstrapApplication(MyApp, {providers: [
+ *   provideExperimentalZonelessChangeDetection(),
+ * ]});
+ * ```
+ *
+ * This API is experimental. Neither the shape, nor the underlying behavior is stable and can change
+ * in patch versions. There are known feature gaps, including the lack of a public zoneless API
+ * which prevents the application from serializing too early with SSR.
+ *
+ * @publicApi
+ * @experimental
+ * @see {@link bootstrapApplication}
+ */
+export declare function provideExperimentalZonelessChangeDetection(): EnvironmentProviders;
+
 /**
  * Describes how the `Injector` should be configured.
  * @see [Dependency Injection Guide](guide/di/dependency-injection.
@@ -9624,22 +9680,11 @@ declare const TEMPLATES = "t";
 export declare class Testability implements PublicTestability {
     private _ngZone;
     private registry;
-    private _pendingCount;
     private _isZoneStable;
     private _callbacks;
     private taskTrackingZone;
     constructor(_ngZone: NgZone, registry: TestabilityRegistry, testabilityGetter: GetTestability);
     private _watchAngularEvents;
-    /**
-     * Increases the number of pending request
-     * @deprecated pending requests are now tracked with zones.
-     */
-    increasePendingRequestCount(): number;
-    /**
-     * Decreases the number of pending request
-     * @deprecated pending requests are now tracked with zones
-     */
-    decreasePendingRequestCount(): number;
     /**
      * Whether an associated application is stable
      */
@@ -9660,11 +9705,6 @@ export declare class Testability implements PublicTestability {
      *    and no further updates will be issued.
      */
     whenStable(doneCb: Function, timeout?: number, updateCb?: Function): void;
-    /**
-     * Get the number of pending requests
-     * @deprecated pending requests are now tracked with zones
-     */
-    getPendingRequestCount(): number;
     /**
      * Find providers by name
      * @param using The root element to search from
@@ -11942,7 +11982,7 @@ export declare const enum ɵBypassType {
  */
 export declare abstract class ɵChangeDetectionScheduler {
     abstract notify(source?: NotificationType): void;
-    abstract tick(shouldRefreshViews: boolean): void;
+    abstract runningTick: boolean;
 }
 
 export declare function ɵclearResolutionOfComponentResourcesQueue(): Map<Type<any>, Component>;
@@ -13145,8 +13185,6 @@ export declare interface ɵProviderRecord {
     importPath?: Type<unknown>[];
 }
 
-export declare function ɵprovideZonelessChangeDetection(): EnvironmentProviders;
-
 /**
  * Queue a state update to be performed asynchronously.
  *
@@ -13487,23 +13525,6 @@ export declare interface ɵSafeUrl extends ɵSafeValue {
 export declare interface ɵSafeValue {
 }
 
-/**
- * Configures change detection scheduling when using ZoneJS.
- */
-export declare enum ɵSchedulingMode {
-    /**
-     * Change detection will run when the `NgZone.onMicrotaskEmpty` observable emits.
-     * Change detection will also be scheduled to run whenever Angular is notified
-     * of a change. This includes calling `ChangeDetectorRef.markForCheck`,
-     * setting a `signal` value, and attaching a view.
-     */
-    Hybrid = 0,
-    /**
-     * Change detection will only run when the `NgZone.onMicrotaskEmpty` observable emits.
-     */
-    NgZoneOnly = 1
-}
-
 /**
  * Control whether the NgModule registration system enforces that each NgModule type registered has
  * a unique id.
@@ -14629,11 +14650,12 @@ export declare function ɵɵcomponentInstance(): unknown;
  * built-in "if" and "switch". On the high level this instruction is responsible for adding and
  * removing views selected by a conditional expression.
  *
- * @param matchingTemplateIndex index of a template TNode representing a conditional view to be
+ * @param matchingTemplateIndex Index of a template TNode representing a conditional view to be
  *     inserted; -1 represents a special case when there is no view to insert.
+ * @param contextValue Value that should be exposed as the context of the conditional.
  * @codeGenApi
  */
-export declare function ɵɵconditional<T>(containerIndex: number, matchingTemplateIndex: number, value?: T): void;
+export declare function ɵɵconditional<T>(matchingTemplateIndex: number, contextValue?: T): void;
 
 /**
  * Registers a QueryList, associated with a content query, for later refresh (part of a view

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "18.0.0-next.4",
+  "version": "18.0.0-next.5",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",
@@ -11,6 +11,9 @@
     "./schematics/*": {
       "default": "./schematics/*.js"
     },
+    "./event-dispatch-contract.min.js": {
+      "default": "./event-dispatch-contract.min.js"
+    },
     "./package.json": {
       "default": "./package.json"
     },

package/primitives/signals/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v18.0.0-next.4
+ * @license Angular v18.0.0-next.5
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */

package/rxjs-interop/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v18.0.0-next.4
+ * @license Angular v18.0.0-next.5
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */

package/schematics/migrations/block-template-entities/bundle.js

@@ -6280,11 +6280,10 @@ function createAdvanceOp(delta, sourceSpan) {
     sourceSpan
   }, NEW_OP);
 }
-function createConditionalOp(target, targetSlot, test, conditions, sourceSpan) {
+function createConditionalOp(target, test, conditions, sourceSpan) {
   return __spreadValues(__spreadValues(__spreadValues({
     kind: OpKind.Conditional,
     target,
-    targetSlot,
     test,
     conditions,
     processed: null,
@@ -16547,19 +16546,7 @@ function pipeBindV(slot, varOffset, args) {
   ]);
 }
 function textInterpolate(strings, expressions, sourceSpan) {
-  if (strings.length < 1 || expressions.length !== strings.length - 1) {
-    throw new Error(`AssertionError: expected specific shape of args for strings/expressions in interpolation`);
-  }
-  const interpolationArgs = [];
-  if (expressions.length === 1 && strings[0] === "" && strings[1] === "") {
-    interpolationArgs.push(expressions[0]);
-  } else {
-    let idx;
-    for (idx = 0; idx < expressions.length; idx++) {
-      interpolationArgs.push(literal(strings[idx]), expressions[idx]);
-    }
-    interpolationArgs.push(literal(strings[idx]));
-  }
+  const interpolationArgs = collateInterpolationArgs(strings, expressions);
   return callVariadicInstruction(TEXT_INTERPOLATE_CONFIG, [], interpolationArgs, [], sourceSpan);
 }
 function i18nExp(expr, sourceSpan) {
@@ -16636,8 +16623,8 @@ function call(instruction, args, sourceSpan) {
   const expr = importExpr(instruction).callFn(args, sourceSpan);
   return createStatementOp(new ExpressionStatement(expr, sourceSpan));
 }
-function conditional(slot, condition, contextValue, sourceSpan) {
-  const args = [literal(slot), condition];
+function conditional(condition, contextValue, sourceSpan) {
+  const args = [condition];
   if (contextValue !== null) {
     args.push(contextValue);
   }
@@ -17063,10 +17050,7 @@ function reifyUpdateOperations(_unit, ops) {
         if (op.processed === null) {
           throw new Error(`Conditional test was not set.`);
         }
-        if (op.targetSlot.slot === null) {
-          throw new Error(`Conditional slot was not set.`);
-        }
-        OpList.replace(op, conditional(op.targetSlot.slot, op.processed, op.contextValue, op.sourceSpan));
+        OpList.replace(op, conditional(op.processed, op.contextValue, op.sourceSpan));
         break;
       case OpKind.Repeater:
         OpList.replace(op, repeater(op.collection, op.sourceSpan));
@@ -17648,49 +17632,22 @@ function transformTwoWayBindingSet(job) {
     for (const op of unit.create) {
       if (op.kind === OpKind.TwoWayListener) {
         transformExpressionsInOp(op, (expr) => {
-          if (expr instanceof TwoWayBindingSetExpr) {
-            return wrapAction(expr.target, expr.value);
+          if (!(expr instanceof TwoWayBindingSetExpr)) {
+            return expr;
           }
-          return expr;
+          const { target, value } = expr;
+          if (target instanceof ReadPropExpr || target instanceof ReadKeyExpr) {
+            return twoWayBindingSet(target, value).or(target.set(value));
+          }
+          if (target instanceof ReadVariableExpr) {
+            return twoWayBindingSet(target, value);
+          }
+          throw new Error(`Unsupported expression in two-way action binding.`);
         }, VisitorContextFlag.InChildOperation);
       }
     }
   }
 }
-function wrapSetOperation(target, value) {
-  if (target instanceof ReadVariableExpr) {
-    return twoWayBindingSet(target, value);
-  }
-  return twoWayBindingSet(target, value).or(target.set(value));
-}
-function isReadExpression(value) {
-  return value instanceof ReadPropExpr || value instanceof ReadKeyExpr || value instanceof ReadVariableExpr;
-}
-function wrapAction(target, value) {
-  if (isReadExpression(target)) {
-    return wrapSetOperation(target, value);
-  }
-  if (target instanceof BinaryOperatorExpr && isReadExpression(target.rhs)) {
-    return new BinaryOperatorExpr(target.operator, target.lhs, wrapSetOperation(target.rhs, value));
-  }
-  if (target instanceof ConditionalExpr && isReadExpression(target.falseCase)) {
-    return new ConditionalExpr(target.condition, target.trueCase, wrapSetOperation(target.falseCase, value));
-  }
-  if (target instanceof NotExpr) {
-    let expr = target.condition;
-    while (true) {
-      if (expr instanceof NotExpr) {
-        expr = expr.condition;
-      } else {
-        if (isReadExpression(expr)) {
-          return wrapSetOperation(expr, value);
-        }
-        break;
-      }
-    }
-  }
-  throw new Error(`Unsupported expression in two-way action binding.`);
-}
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/template/pipeline/src/phases/save_restore_view.mjs
 function saveAndRestoreView(job) {
@@ -18701,7 +18658,6 @@ function ingestBoundText(unit, text2, icuPlaceholder) {
 function ingestIfBlock(unit, ifBlock) {
   var _a2;
   let firstXref = null;
-  let firstSlotHandle = null;
   let conditions = [];
   for (let i = 0; i < ifBlock.branches.length; i++) {
     const ifCase = ifBlock.branches[i];
@@ -18721,15 +18677,13 @@ function ingestIfBlock(unit, ifBlock) {
     unit.create.push(templateOp);
     if (firstXref === null) {
       firstXref = cView.xref;
-      firstSlotHandle = templateOp.handle;
     }
     const caseExpr = ifCase.expression ? convertAst(ifCase.expression, unit.job, null) : null;
     const conditionalCaseExpr = new ConditionalCaseExpr(caseExpr, templateOp.xref, templateOp.handle, ifCase.expressionAlias);
     conditions.push(conditionalCaseExpr);
     ingestNodes(cView, ifCase.children);
   }
-  const conditional2 = createConditionalOp(firstXref, firstSlotHandle, null, conditions, ifBlock.sourceSpan);
-  unit.update.push(conditional2);
+  unit.update.push(createConditionalOp(firstXref, null, conditions, ifBlock.sourceSpan));
 }
 function ingestSwitchBlock(unit, switchBlock) {
   var _a2;
@@ -18737,7 +18691,6 @@ function ingestSwitchBlock(unit, switchBlock) {
     return;
   }
   let firstXref = null;
-  let firstSlotHandle = null;
   let conditions = [];
   for (const switchCase of switchBlock.cases) {
     const cView = unit.job.allocateView(unit.xref);
@@ -18753,15 +18706,13 @@ function ingestSwitchBlock(unit, switchBlock) {
     unit.create.push(templateOp);
     if (firstXref === null) {
       firstXref = cView.xref;
-      firstSlotHandle = templateOp.handle;
     }
     const caseExpr = switchCase.expression ? convertAst(switchCase.expression, unit.job, switchBlock.startSourceSpan) : null;
     const conditionalCaseExpr = new ConditionalCaseExpr(caseExpr, templateOp.xref, templateOp.handle);
     conditions.push(conditionalCaseExpr);
     ingestNodes(cView, switchCase.children);
   }
-  const conditional2 = createConditionalOp(firstXref, firstSlotHandle, convertAst(switchBlock.expression, unit.job, null), conditions, switchBlock.sourceSpan);
-  unit.update.push(conditional2);
+  unit.update.push(createConditionalOp(firstXref, convertAst(switchBlock.expression, unit.job, null), conditions, switchBlock.sourceSpan));
 }
 function ingestDeferView(unit, suffix, i18nMeta, children, sourceSpan) {
   if (i18nMeta !== void 0 && !(i18nMeta instanceof BlockPlaceholder)) {
@@ -19456,11 +19407,12 @@ var STYLE_PREFIX = "style";
 var TEMPLATE_ATTR_PREFIX = "*";
 var ANIMATE_PROP_PREFIX = "animate-";
 var BindingParser = class {
-  constructor(_exprParser, _interpolationConfig, _schemaRegistry, errors) {
+  constructor(_exprParser, _interpolationConfig, _schemaRegistry, errors, _allowInvalidAssignmentEvents = false) {
     this._exprParser = _exprParser;
     this._interpolationConfig = _interpolationConfig;
     this._schemaRegistry = _schemaRegistry;
     this.errors = errors;
+    this._allowInvalidAssignmentEvents = _allowInvalidAssignmentEvents;
   }
   get interpolationConfig() {
     return this._interpolationConfig;
@@ -19764,6 +19716,9 @@ var BindingParser = class {
     if (ast instanceof PropertyRead || ast instanceof KeyedRead) {
       return true;
     }
+    if (!this._allowInvalidAssignmentEvents) {
+      return false;
+    }
     if (ast instanceof Binary) {
       return (ast.operation === "&&" || ast.operation === "||" || ast.operation === "??") && (ast.right instanceof PropertyRead || ast.right instanceof KeyedRead);
     }
@@ -21009,8 +20964,8 @@ function textContents(node) {
 var LEADING_TRIVIA_CHARS = [" ", "\n", "\r", "	"];
 function parseTemplate(template2, templateUrl, options = {}) {
   var _a2;
-  const { interpolationConfig, preserveWhitespaces, enableI18nLegacyMessageIdFormat } = options;
-  const bindingParser = makeBindingParser(interpolationConfig);
+  const { interpolationConfig, preserveWhitespaces, enableI18nLegacyMessageIdFormat, allowInvalidAssignmentEvents } = options;
+  const bindingParser = makeBindingParser(interpolationConfig, allowInvalidAssignmentEvents);
   const htmlParser = new HtmlParser();
   const parseResult = htmlParser.parse(template2, templateUrl, __spreadProps(__spreadValues({
     leadingTriviaChars: LEADING_TRIVIA_CHARS
@@ -21075,8 +21030,8 @@ function parseTemplate(template2, templateUrl, options = {}) {
   return parsedTemplate;
 }
 var elementRegistry = new DomElementSchemaRegistry();
-function makeBindingParser(interpolationConfig = DEFAULT_INTERPOLATION_CONFIG) {
-  return new BindingParser(new Parser(new Lexer()), interpolationConfig, elementRegistry, []);
+function makeBindingParser(interpolationConfig = DEFAULT_INTERPOLATION_CONFIG, allowInvalidAssignmentEvents = false) {
+  return new BindingParser(new Parser(new Lexer()), interpolationConfig, elementRegistry, [], allowInvalidAssignmentEvents);
 }
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/render3/view/compiler.mjs
@@ -22640,7 +22595,7 @@ function publishFacade(global) {
 }
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/version.mjs
-var VERSION2 = new Version("18.0.0-next.4");
+var VERSION2 = new Version("18.0.0-next.5");
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/i18n/extractor_merger.mjs
 var _VisitorMode;