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

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v18.0.0-next.4
+ * @license Angular v18.0.0-next.6
  * (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;
 }
 
 
@@ -3915,6 +3926,43 @@ export declare interface ExistingSansProvider {
     useExisting: any;
 }
 
+/**
+ * Experimental service that keeps track of pending tasks contributing to the stableness of Angular
+ * application. While several existing Angular services (ex.: `HttpClient`) will internally manage
+ * tasks influencing stability, this API gives control over stability to library and application
+ * developers for specific cases not covered by Angular internals.
+ *
+ * The concept of stability comes into play in several important scenarios:
+ * - SSR process needs to wait for the application stability before serializing and sending rendered
+ * HTML;
+ * - tests might want to delay assertions until the application becomes stable;
+ *
+ * @usageNotes
+ * ```typescript
+ * const pendingTasks = inject(ExperimentalPendingTasks);
+ * const taskCleanup = pendingTasks.add();
+ * // do work that should block application's stability and then:
+ * taskCleanup();
+ * ```
+ *
+ * This API is experimental. Neither the shape, nor the underlying behavior is stable and can change
+ * in patch versions. We will iterate on the exact API based on the feedback and our understanding
+ * of the problem and solution space.
+ *
+ * @publicApi
+ * @experimental
+ */
+export declare class ExperimentalPendingTasks {
+    internalPendingTasks: ɵPendingTasks;
+    /**
+     * Adds a new task that should block application's stability.
+     * @returns A cleanup function that removes a task when called.
+     */
+    add(): () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExperimentalPendingTasks, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ExperimentalPendingTasks>;
+}
+
 /**
  * Definition of what a factory function should look like.
  */
@@ -4344,6 +4392,29 @@ export declare interface Host {
  */
 export declare const Host: HostDecorator;
 
+/**
+ * A token that can be used to inject the tag name of the host node.
+ *
+ * @usageNotes
+ * ### Injecting a tag name that is known to exist
+ * ```typescript
+ * @Directive()
+ * class MyDir {
+ *   tagName: string = inject(HOST_TAG_NAME);
+ * }
+ * ```
+ *
+ * ### Optionally injecting a tag name
+ * ```typescript
+ * @Directive()
+ * class MyDir {
+ *   tagName: string | null = inject(HOST_TAG_NAME, {optional: true});
+ * }
+ * ```
+ * @publicApi
+ */
+export declare const HOST_TAG_NAME: InjectionToken<string>;
+
 /**
  * Creates a token that can be used to inject static attributes of the host node.
  *
@@ -4585,67 +4656,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 +4675,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 +7540,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 +8137,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 +8172,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 and API ergonomic considerations. We will iterate
+ * on the exact API based on the feedback and our understanding of the problem and solution space.
+ *
+ * @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 +9740,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 +9765,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
@@ -11741,8 +11841,9 @@ export declare const enum ɵAnimationRendererType {
  *
  * @param appRef An instance of an ApplicationRef.
  * @param doc A reference to the current Document instance.
+ * @return event types that need to be replayed
  */
-export declare function ɵannotateForHydration(appRef: ApplicationRef, doc: Document): void;
+export declare function ɵannotateForHydration(appRef: ApplicationRef, doc: Document): Set<string> | undefined;
 
 
 /**
@@ -11942,7 +12043,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>;
@@ -12995,14 +13096,7 @@ export declare const ɵNOT_FOUND_CHECK_ONLY_ELEMENT_INJECTOR: {};
 export declare function ɵpatchComponentDefWithScope<C>(componentDef: ɵComponentDef<C>, transitiveScopes: ɵNgModuleTransitiveScopes): void;
 
 /**
- * *Internal* service that keeps track of pending tasks happening in the system.
- *
- * This information is needed to make sure that the serialization on the server
- * is delayed until all tasks in the queue (such as an initial navigation or a
- * pending HTTP request) are completed.
- *
- * Pending tasks continue to contribute to the stableness of `ApplicationRef`
- * throughout the lifetime of the application.
+ * Internal implementation of the pending tasks service.
  */
 export declare class ɵPendingTasks implements OnDestroy {
     private taskId;
@@ -13145,8 +13239,6 @@ export declare interface ɵProviderRecord {
     importPath?: Type<unknown>[];
 }
 
-export declare function ɵprovideZonelessChangeDetection(): EnvironmentProviders;
-
 /**
  * Queue a state update to be performed asynchronously.
  *
@@ -13435,6 +13527,8 @@ export declare const enum ɵRuntimeErrorCode {
     REQUIRED_QUERY_NO_VALUE = -951,
     REQUIRED_MODEL_NO_VALUE = -952,
     OUTPUT_REF_DESTROYED = 953,
+    LOOP_TRACK_DUPLICATE_KEYS = 955,
+    LOOP_TRACK_RECREATE = 956,
     RUNTIME_DEPS_INVALID_IMPORTED_TYPE = 1000,
     RUNTIME_DEPS_ORPHAN_COMPONENT = 1001
 }
@@ -13487,23 +13581,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.
@@ -13623,7 +13700,7 @@ export declare function ɵtransitiveScopesFor<T>(type: Type<T>): ɵNgModuleTrans
  * @param tDetails Static information about this defer block.
  * @param lView LView of a host view.
  */
-export declare function ɵtriggerResourceLoading(tDetails: TDeferBlockDetails, lView: LView, tNode: TNode): void;
+export declare function ɵtriggerResourceLoading(tDetails: TDeferBlockDetails, lView: LView, tNode: TNode): Promise<unknown>;
 
 /**
  * Ellipses the string in the middle when longer than the max length
@@ -13908,6 +13985,12 @@ export declare function ɵwhenStable(applicationRef: ApplicationRef): Promise<vo
  */
 export declare function ɵwithDomHydration(): EnvironmentProviders;
 
+/**
+ * Returns a set of providers required to setup support for event replay.
+ * Requires hydration to be enabled separately.
+ */
+export declare function ɵwithEventReplay(): Provider[];
+
 /**
  * Returns a set of providers required to setup support for i18n hydration.
  * Requires hydration to be enabled separately.
@@ -14629,11 +14712,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.6",
   "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"
     },
@@ -20,6 +23,12 @@
       "esm": "./esm2022/core.mjs",
       "default": "./fesm2022/core.mjs"
     },
+    "./primitives/event-dispatch": {
+      "types": "./primitives/event-dispatch/index.d.ts",
+      "esm2022": "./esm2022/primitives/event-dispatch/index.mjs",
+      "esm": "./esm2022/primitives/event-dispatch/index.mjs",
+      "default": "./fesm2022/primitives/event-dispatch.mjs"
+    },
     "./primitives/signals": {
       "types": "./primitives/signals/index.d.ts",
       "esm2022": "./esm2022/primitives/signals/index.mjs",