@angular/core 19.1.0-next.1 → 19.1.0-next.3

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.1.0-next.1
+ * @license Angular v19.1.0-next.3
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -141,7 +141,7 @@ export declare interface AfterContentInit {
  * for example to initialize a non-Angular library.
  *
  * ### Example
- * ```ts
+ * ```angular-ts
  * @Component({
  *   selector: 'my-chart-cmp',
  *   template: `<div #chart>{{ ... }}</div>`,
@@ -201,7 +201,7 @@ export declare function afterNextRender<E = never, W = never, M = never>(spec: {
  * for example to initialize a non-Angular library.
  *
  * ### Example
- * ```ts
+ * ```angular-ts
  * @Component({
  *   selector: 'my-chart-cmp',
  *   template: `<div #chart>{{ ... }}</div>`,
@@ -281,7 +281,7 @@ export declare function afterNextRender(callback: VoidFunction, options?: AfterR
  * Use `afterRender` to read or write the DOM after each render.
  *
  * ### Example
- * ```ts
+ * ```angular-ts
  * @Component({
  *   selector: 'my-cmp',
  *   template: `<span #content>{{ ... }}</span>`,
@@ -340,7 +340,7 @@ export declare function afterRender<E = never, W = never, M = never>(spec: {
  * Use `afterRender` to read or write the DOM after each render.
  *
  * ### Example
- * ```ts
+ * ```angular-ts
  * @Component({
  *   selector: 'my-cmp',
  *   template: `<span #content>{{ ... }}</span>`,
@@ -704,7 +704,7 @@ export declare const APP_BOOTSTRAP_LISTENER: InjectionToken<readonly ((compRef:
  * (for example, using `bootstrapApplication` calls). In this case, ensure that those applications
  * have different `APP_ID` value setup. For example:
  *
- * ```
+ * ```ts
  * bootstrapApplication(ComponentA, {
  *   providers: [
  *     { provide: APP_ID, useValue: 'app-a' },
@@ -752,7 +752,7 @@ export declare const APP_ID: InjectionToken<string>;
  * The following example illustrates how to configure a multi-provider using `APP_INITIALIZER` token
  * and a function returning a promise.
  * ### Example with NgModule-based application
- * ```
+ * ```ts
  *  function initializeApp(): Promise<any> {
  *    const http = inject(HttpClient);
  *    return firstValueFrom(
@@ -776,7 +776,7 @@ export declare const APP_ID: InjectionToken<string>;
  * ```
  *
  * ### Example with standalone application
- * ```
+ * ```ts
  * function initializeApp() {
  *   const http = inject(HttpClient);
  *   return firstValueFrom(
@@ -806,7 +806,7 @@ export declare const APP_ID: InjectionToken<string>;
  * through DI.
  *
  * ### Example with NgModule-based application
- * ```
+ * ```ts
  * function initializeApp() {
  *   const http = inject(HttpClient);
  *   return firstValueFrom(
@@ -830,7 +830,7 @@ export declare const APP_ID: InjectionToken<string>;
  * ```
  *
  * ### Example with standalone application
- * ```
+ * ```ts
  * function initializeApp() {
  *   const http = inject(HttpClient);
  *   return firstValueFrom(
@@ -918,7 +918,7 @@ export declare class ApplicationModule {
  * (here incrementing a counter, using RxJS `interval`),
  * and at the same time subscribe to `isStable`.
  *
- * ```
+ * ```ts
  * constructor(appRef: ApplicationRef) {
  *   appRef.isStable.pipe(
  *      filter(stable => stable)
@@ -933,7 +933,7 @@ export declare class ApplicationModule {
  * you have to wait for the application to be stable
  * before starting your polling process.
  *
- * ```
+ * ```ts
  * constructor(appRef: ApplicationRef) {
  *   appRef.isStable.pipe(
  *     first(stable => stable),
@@ -953,7 +953,7 @@ export declare class ApplicationModule {
  * you update a field of your component
  * and display it in its template.
  *
- * ```
+ * ```ts
  * constructor(appRef: ApplicationRef) {
  *   appRef.isStable.pipe(
  *     first(stable => stable),
@@ -967,7 +967,7 @@ export declare class ApplicationModule {
  *
  * You'll have to manually trigger the change detection to update the template.
  *
- * ```
+ * ```ts
  * constructor(appRef: ApplicationRef, cd: ChangeDetectorRef) {
  *   appRef.isStable.pipe(
  *     first(stable => stable),
@@ -981,7 +981,7 @@ export declare class ApplicationModule {
  *
  * Or make the subscription callback run inside the zone.
  *
- * ```
+ * ```ts
  * constructor(appRef: ApplicationRef, zone: NgZone) {
  *   appRef.isStable.pipe(
  *     first(stable => stable),
@@ -1277,7 +1277,7 @@ export declare interface AttributeDecorator {
  * Intended to be used as a transform function of an input.
  *
  *  @usageNotes
- *  ```typescript
+ *  ```ts
  *  @Input({ transform: booleanAttribute }) status!: boolean;
  *  ```
  * @param value Value to be transformed.
@@ -1408,8 +1408,7 @@ declare type ChangeDetectionStrategy_2 = number;
  * (`CheckOnce`, rather than the default `CheckAlways`), then forces a second check
  * after an interval.
  *
- * <code-example path="core/ts/change_detect/change-detection.ts"
- * region="mark-for-check"></code-example>
+ * {@example core/ts/change_detect/change-detection.ts region='mark-for-check'}
  *
  * ### Detach change detector to limit how often check occurs
  *
@@ -1419,7 +1418,7 @@ declare type ChangeDetectionStrategy_2 = number;
  * less often than the changes actually occur. To do that, we detach
  * the component's change detector and perform an explicit local check every five seconds.
  *
- * <code-example path="core/ts/change_detect/change-detection.ts" region="detach"></code-example>
+ * {@example core/ts/change_detect/change-detection.ts region='detach'}
  *
  *
  * ### Reattaching a detached component
@@ -1429,7 +1428,7 @@ declare type ChangeDetectionStrategy_2 = number;
  * when the `live` property is set to false, and reattaches it when the property
  * becomes true.
  *
- * <code-example path="core/ts/change_detect/change-detection.ts" region="reattach"></code-example>
+ * {@example core/ts/change_detect/change-detection.ts region='reattach'}
  *
  * @publicApi
  */
@@ -1799,7 +1798,7 @@ export declare interface ComponentDecorator {
      * The following example creates a component with two data-bound properties,
      * specified by the `inputs` value.
      *
-     * <code-example path="core/ts/metadata/directives.ts" region="component-input"></code-example>
+     * {@example core/ts/metadata/directives.ts region='component-input'}
      *
      *
      * ### Setting component outputs
@@ -2556,7 +2555,7 @@ declare const CONTEXT = 8;
  * Note: the example uses standalone components, but the function can also be used for
  * non-standalone components (declared in an NgModule) as well.
  *
- * ```typescript
+ * ```angular-ts
  * @Component({
  *   standalone: true,
  *   template: `Hello {{ name }}!`
@@ -2963,6 +2962,31 @@ export declare class DebugNode {
     get providerTokens(): any[];
 }
 
+/**
+ * A debug representation of the signal graph.
+ */
+declare interface DebugSignalGraph {
+    nodes: DebugSignalGraphNode[];
+    edges: DebugSignalGraphEdge[];
+}
+
+declare interface DebugSignalGraphEdge {
+    /**
+     * Index of a signal node in the `nodes` array that is a consumer of the signal produced by the producer node.
+     */
+    consumer: number;
+    /**
+     * Index of a signal node in the `nodes` array that is a producer of the signal consumed by the consumer node.
+     */
+    producer: number;
+}
+
+declare interface DebugSignalGraphNode {
+    kind: string;
+    label?: string;
+    value?: unknown;
+}
+
 declare const DECLARATION_COMPONENT_VIEW = 15;
 
 declare const DECLARATION_LCONTAINER = 16;
@@ -2996,7 +3020,7 @@ declare const DECLARATION_VIEW = 14;
  * @usageNotes
  * ### Example
  *
- * ```typescript
+ * ```ts
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
  *
@@ -3342,7 +3366,7 @@ export declare abstract class DestroyRef {
      *
      * @usageNotes
      * ### Example
-     * ```typescript
+     * ```ts
      * const destroyRef = inject(DestroyRef);
      *
      * // register a destroy callback
@@ -3412,7 +3436,7 @@ export declare interface Directive {
      *
      * The following example creates a component with two data-bound properties.
      *
-     * ```typescript
+     * ```ts
      * @Component({
      *   selector: 'bank-account',
      *   inputs: ['bankName', {name: 'id', alias: 'account-id'}],
@@ -3448,7 +3472,7 @@ export declare interface Directive {
      *
      * @usageNotes
      *
-     * ```typescript
+     * ```ts
      * @Component({
      *   selector: 'child-dir',
      *   outputs: [ 'bankNameChange' ],
@@ -3832,7 +3856,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * Map of inputs for a given directive/component.
  *
  * Given:
- * ```
+ * ```ts
  * class MyComponent {
  *   @Input()
  *   publicInput1: string;
@@ -3848,7 +3872,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * ```
  *
  * is described as:
- * ```
+ * ```ts
  * {
  *   publicInput1: 'publicInput1',
  *   declaredInput2: [InputFlags.None, 'declaredInput2', 'publicInput2'],
@@ -3863,7 +3887,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * ```
  *
  * Which the minifier may translate to:
- * ```
+ * ```ts
  * {
  *   minifiedPublicInput1: 'publicInput1',
  *   minifiedDeclaredInput2: [InputFlags.None, 'publicInput2', 'declaredInput2'],
@@ -3910,7 +3934,7 @@ declare const DISCONNECTED_NODES = "d";
  * The example below uses `ApplicationRef.bootstrap()` to render the
  * `AppComponent` on the page.
  *
- * ```typescript
+ * ```ts
  * class AppModule implements DoBootstrap {
  *   ngDoBootstrap(appRef: ApplicationRef) {
  *     appRef.bootstrap(AppComponent); // Or some other component
@@ -4089,7 +4113,7 @@ declare const EMBEDDED_VIEW_INJECTOR = 20;
  * The following template breaks down into two separate `TemplateRef` instances,
  * an outer one and an inner one.
  *
- * ```
+ * ```html
  * Count: {{items.length}}
  * <ul>
  *   <li *ngFor="let  item of items">{{item}}</li>
@@ -4098,7 +4122,7 @@ declare const EMBEDDED_VIEW_INJECTOR = 20;
  *
  * This is the outer `TemplateRef`:
  *
- * ```
+ * ```html
  * Count: {{items.length}}
  * <ul>
  *   <ng-template ngFor let-item [ngForOf]="items"></ng-template>
@@ -4107,13 +4131,13 @@ declare const EMBEDDED_VIEW_INJECTOR = 20;
  *
  * This is the inner `TemplateRef`:
  *
- * ```
+ * ```html
  *   <li>{{item}}</li>
  * ```
  *
  * The outer and inner `TemplateRef` instances are assembled into views as follows:
  *
- * ```
+ * ```html
  * <!-- ViewRef: outer-0 -->
  * Count: 2
  * <ul>
@@ -4250,7 +4274,7 @@ export declare type EnvironmentProviders = {
  * @usageNotes
  * ### Example
  *
- * ```
+ * ```ts
  * class MyErrorHandler implements ErrorHandler {
  *   handleError(error) {
  *     // do something with the exception
@@ -4294,7 +4318,7 @@ declare interface EventContractDetails {
  * that create event emitters. When the title is clicked, the emitter
  * emits an open or close event to toggle the current visibility state.
  *
- * ```html
+ * ```angular-ts
  * @Component({
  *   selector: 'zippy',
  *   template: `
@@ -4497,7 +4521,7 @@ declare const FLAGS = 2;
  * {@example core/di/ts/forward_ref/forward_ref_spec.ts region='forward_ref'}
  *
  * ### Circular standalone reference import example
- * ```ts
+ * ```angular-ts
  * @Component({
  *   standalone: true,
  *   imports: [ChildComponent],
@@ -4743,6 +4767,18 @@ export declare function getPlatform(): PlatformRef | null;
  */
 declare function getRootComponents(elementOrDir: Element | {}): {}[];
 
+/**
+ * Returns a debug representation of the signal graph for the given injector.
+ *
+ * Currently only supports element injectors. Starts by discovering the consumer nodes
+ * and then traverses their producer nodes to build the signal graph.
+ *
+ * @param injector The injector to get the signal graph for.
+ * @returns A debug representation of the signal graph.
+ * @throws If the injector is an environment injector.
+ */
+declare function getSignalGraph(injector: Injector): DebugSignalGraph;
+
 /**
  * Adapter interface for retrieving the `Testability` service associated for a
  * particular context.
@@ -4783,6 +4819,7 @@ declare const globalUtilsFunctions: {
     ɵgetInjectorResolutionPath: typeof getInjectorResolutionPath;
     ɵgetInjectorMetadata: typeof getInjectorMetadata;
     ɵsetProfiler: (profiler: ɵProfiler_2 | null) => void;
+    ɵgetSignalGraph: typeof getSignalGraph;
     getDirectiveMetadata: typeof getDirectiveMetadata;
     getComponent: typeof getComponent;
     getContext: typeof getContext;
@@ -4842,7 +4879,7 @@ export declare const Host: HostDecorator;
  *
  * @usageNotes
  * ### Injecting a tag name that is known to exist
- * ```typescript
+ * ```ts
  * @Directive()
  * class MyDir {
  *   tagName: string = inject(HOST_TAG_NAME);
@@ -4850,7 +4887,7 @@ export declare const Host: HostDecorator;
  * ```
  *
  * ### Optionally injecting a tag name
- * ```typescript
+ * ```ts
  * @Directive()
  * class MyDir {
  *   tagName: string | null = inject(HOST_TAG_NAME, {optional: true});
@@ -4865,7 +4902,7 @@ export declare const HOST_TAG_NAME: InjectionToken<string>;
  *
  * @usageNotes
  * ### Injecting an attribute that is known to exist
- * ```typescript
+ * ```ts
  * @Directive()
  * class MyDir {
  *   attr: string = inject(new HostAttributeToken('some-attr'));
@@ -4873,7 +4910,7 @@ export declare const HOST_TAG_NAME: InjectionToken<string>;
  * ```
  *
  * ### Optionally injecting an attribute
- * ```typescript
+ * ```ts
  * @Directive()
  * class MyDir {
  *   attr: string | null = inject(new HostAttributeToken('some-attr'), {optional: true});
@@ -4925,7 +4962,7 @@ export declare interface HostBindingDecorator {
      * The following example creates a directive that sets the `valid` and `invalid`
      * class, a style color, and an id on the DOM element that has an `ngModel` directive on it.
      *
-     * ```typescript
+     * ```ts
      * @Directive({selector: '[ngModel]'})
      * class NgModelStatus {
      *   constructor(public control: NgModel) {}
@@ -4988,7 +5025,7 @@ export declare interface HostBindingDecorator {
  *
  * ## Example
  *
- * ```
+ * ```ts
  * const hostBindingOpCodes = [
  *   ~30,                               // Select element 30
  *   40, 45, MyDir.ɵdir.hostBindings    // Invoke host bindings on MyDir on element 30;
@@ -4999,7 +5036,7 @@ export declare interface HostBindingDecorator {
  * ```
  *
  * ## Pseudocode
- * ```
+ * ```ts
  * const hostBindingOpCodes = tView.hostBindingOpCodes;
  * if (hostBindingOpCodes === null) return;
  * for (let i = 0; i < hostBindingOpCodes.length; i++) {
@@ -5042,8 +5079,7 @@ export declare interface HostDecorator {
      *
      * The following shows use with the `@Optional` decorator, and allows for a `null` result.
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="Host">
-     * </code-example>
+     * {@example core/di/ts/metadata_spec.ts region='Host'}
      *
      * For an extended example, see ["Dependency Injection
      * Guide"](guide/di/di-in-action#optional).
@@ -5232,7 +5268,7 @@ declare const I18N_DATA = "l";
  * The number is shifted and encoded according to `I18nCreateOpCode`
  *
  * Pseudocode:
- * ```
+ * ```ts
  * const i18nCreateOpCodes = [
  *   10 << I18nCreateOpCode.SHIFT, "Text Node add to DOM",
  *   11 << I18nCreateOpCode.SHIFT | I18nCreateOpCode.COMMENT, "Comment Node add to DOM",
@@ -5523,7 +5559,7 @@ export declare type ImportedNgModuleProviders = EnvironmentProviders;
  * @usageNotes
  * The results of the `importProvidersFrom` call can be used in the `bootstrapApplication` call:
  *
- * ```typescript
+ * ```ts
  * await bootstrapApplication(RootComponent, {
  *   providers: [
  *     importProvidersFrom(NgModuleOne, NgModuleTwo)
@@ -5534,7 +5570,7 @@ export declare type ImportedNgModuleProviders = EnvironmentProviders;
  * You can also use the `importProvidersFrom` results in the `providers` field of a route, when a
  * standalone component is used:
  *
- * ```typescript
+ * ```ts
  * export const ROUTES: Route[] = [
  *   {
  *     path: 'foo',
@@ -5748,7 +5784,7 @@ export declare interface InjectableDecorator {
      * The following example shows how a service class is properly
      *  marked so that a supporting service can be injected upon creation.
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="Injectable"></code-example>
+     * {@example core/di/ts/metadata_spec.ts region='Injectable'}
      *
      */
     (): TypeDecorator;
@@ -5801,8 +5837,7 @@ export declare interface InjectDecorator {
      * When `@Inject()` is not present, the injector uses the type annotation of the
      * parameter as the provider.
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="InjectWithoutDecorator">
-     * </code-example>
+     * {@example core/di/ts/metadata_spec.ts region='InjectWithoutDecorator'}
      *
      * @see [Dependency Injection Guide](guide/di/dependency-injection
      *
@@ -5882,8 +5917,7 @@ export declare enum InjectFlags {
  *
  * </div>
  *
- * <code-example format="typescript" language="typescript" path="injection-token/src/main.ts"
- * region="InjectionToken"></code-example>
+ * {@example injection-token/src/main.ts region='InjectionToken'}
  *
  * When creating an `InjectionToken`, you can optionally specify a factory function which returns
  * (possibly by creating) a default value of the parameterized type `T`. This sets up the
@@ -6132,7 +6166,7 @@ export declare const Input: InputDecorator;
  * @usageNotes
  * To use signal-based inputs, import `input` from `@angular/core`.
  *
- * ```
+ * ```ts
  * import {input} from '@angular/core`;
  * ```
  *
@@ -6181,7 +6215,7 @@ export declare interface InputDecorator {
      * The following example creates a component with two input properties,
      * one of which is given a special binding name.
      *
-     * ```typescript
+     * ```ts
      * import { Component, Input, numberAttribute, booleanAttribute } from '@angular/core';
      * @Component({
      *   selector: 'bank-account',
@@ -6849,6 +6883,16 @@ declare interface Listener {
     type: 'dom' | 'output';
 }
 
+/**
+ * Options that can be used to configure an event listener.
+ * @publicApi
+ */
+export declare interface ListenerOptions {
+    capture?: boolean;
+    once?: boolean;
+    passive?: boolean;
+}
+
 /**
  * Provide this token to set the locale of your application.
  * It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
@@ -6859,7 +6903,7 @@ declare interface Listener {
  * @usageNotes
  * ### Example
  *
- * ```typescript
+ * ```ts
  * import { LOCALE_ID } from '@angular/core';
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
@@ -7285,7 +7329,7 @@ export declare function makeEnvironmentProviders(providers: (Provider | Environm
  *
  * Example:
  *
- * ```
+ * ```ts
  * const COUNTER_KEY = makeStateKey<number>('counter');
  * let value = 10;
  *
@@ -7317,7 +7361,7 @@ export declare function mergeApplicationConfig(...configs: ApplicationConfig[]):
  *
  * @usageNotes
  * ### Example
- * ```typescript
+ * ```ts
  * import { MissingTranslationStrategy } from '@angular/core';
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
@@ -7346,7 +7390,7 @@ export declare enum MissingTranslationStrategy {
  *
  * To use `model()`, import the function from `@angular/core`.
  *
- * ```
+ * ```ts
  * import {model} from '@angular/core`;
  * ```
  *
@@ -7788,7 +7832,7 @@ export declare class NgProbeToken {
  * @usageNotes
  * ### Example
  *
- * ```
+ * ```ts
  * import {Component, NgZone} from '@angular/core';
  * import {NgIf} from '@angular/common';
  *
@@ -8060,7 +8104,7 @@ declare const NUM_ROOT_NODES = "r";
  * @param fallbackValue Value to use if the provided value can't be parsed as a number.
  *
  *  @usageNotes
- *  ```typescript
+ *  ```ts
  *  @Input({ transform: numberAttribute }) id!: number;
  *  ```
  *
@@ -8188,8 +8232,7 @@ export declare interface OptionalDecorator {
      *
      * The following code allows the possibility of a `null` result:
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="Optional">
-     * </code-example>
+     * {@example core/di/ts/metadata_spec.ts region='Optional'}
      *
      * @see [Dependency Injection Guide](guide/di/dependency-injection.
      */
@@ -8370,7 +8413,7 @@ declare const PARENT = 3;
  * - tests might want to delay assertions until the application becomes stable;
  *
  * @usageNotes
- * ```typescript
+ * ```ts
  * const pendingTasks = inject(PendingTasks);
  * const taskCleanup = pendingTasks.add();
  * // do work that should block application's stability and then:
@@ -8413,24 +8456,6 @@ export declare class PendingTasks {
     static ɵprov: unknown;
 }
 
-/**
- * Internal implementation of the pending tasks service.
- */
-declare class PendingTasksInternal implements OnDestroy {
-    private taskId;
-    private pendingTasks;
-    private get _hasPendingTasks();
-    hasPendingTasks: BehaviorSubject<boolean>;
-    add(): number;
-    has(taskId: number): boolean;
-    remove(taskId: number): void;
-    ngOnDestroy(): void;
-    /** @nocollapse */
-    static ɵprov: unknown;
-}
-export { PendingTasksInternal as ɵPendingTasks }
-export { PendingTasksInternal as ɵPendingTasksInternal }
-
 /**
  * Type of the Pipe metadata.
  *
@@ -8484,7 +8509,7 @@ export declare interface PipeDecorator {
      * For example, if the name is "myPipe", use a template binding expression
      * such as the following:
      *
-     * ```
+     * ```html
      * {{ exp | myPipe }}
      * ```
      *
@@ -8600,7 +8625,7 @@ export declare class PlatformRef {
      * @usageNotes
      * ### Simple Example
      *
-     * ```typescript
+     * ```ts
      * @NgModule({
      *   imports: [BrowserModule]
      * })
@@ -8713,7 +8738,7 @@ declare type ProjectionSlots = (ɵCssSelectorList | '*')[];
  * @usageNotes
  * The following example illustrates how to configure an initialization function using
  * `provideAppInitializer()`
- * ```
+ * ```ts
  * bootstrapApplication(App, {
  *   providers: [
  *     provideAppInitializer(() => {
@@ -8747,7 +8772,7 @@ export declare function provideAppInitializer(initializerFn: () => Observable<un
  * @usageNotes
  * The following example illustrates how to configure an initialization function using
  * `provideEnvironmentInitializer()`
- * ```
+ * ```ts
  * createEnvironmentInjector(
  *   [
  *     provideEnvironmentInitializer(() => {
@@ -8813,7 +8838,7 @@ export declare function provideExperimentalCheckNoChangesForDebug(options: {
  * - registering a render hook (templates are only refreshed if render hooks do one of the above)
  *
  * @usageNotes
- * ```typescript
+ * ```ts
  * bootstrapApplication(MyApp, {providers: [
  *   provideExperimentalZonelessChangeDetection(),
  * ]});
@@ -8873,7 +8898,7 @@ export declare type ProviderToken<T> = Type<T> | AbstractType<T> | InjectionToke
  * `BootstrapOptions` instead.
  *
  * @usageNotes
- * ```typescript
+ * ```ts
  * bootstrapApplication(MyApp, {providers: [
  *   provideZoneChangeDetection({eventCoalescing: true}),
  * ]});
@@ -8972,7 +8997,7 @@ declare const enum QueryFlags {
  *
  * @usageNotes
  * ### Example
- * ```typescript
+ * ```ts
  * @Component({...})
  * class Container {
  *   @ViewChildren(Item) items:QueryList<Item>;
@@ -9249,7 +9274,7 @@ declare interface ReactiveLViewConsumer extends ReactiveNode {
  * The example below demonstrates how to use the function and how the fields
  * of the returned object map to the component metadata.
  *
- * ```typescript
+ * ```angular-ts
  * @Component({
  *   standalone: true,
  *   selector: 'foo-component',
@@ -9337,7 +9362,7 @@ declare interface Renderer {
     removeStyle(el: RElement, style: string, flags?: RendererStyleFlags2): void;
     setProperty(el: RElement, name: string, value: any): void;
     setValue(node: RText | RComment, value: string): void;
-    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void): () => void;
+    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void, options?: ListenerOptions): () => void;
 }
 
 /**
@@ -9509,9 +9534,10 @@ export declare abstract class Renderer2 {
      * DOM element.
      * @param eventName The event to listen for.
      * @param callback A handler function to invoke when the event occurs.
+     * @param options Options that configure how the event listener is bound.
      * @returns An "unlisten" function for disposing of this handler.
      */
-    abstract listen(target: 'window' | 'document' | 'body' | any, eventName: string, callback: (event: any) => boolean | void): () => void;
+    abstract listen(target: 'window' | 'document' | 'body' | any, eventName: string, callback: (event: any) => boolean | void, options?: ListenerOptions): () => void;
 }
 
 declare interface RendererFactory {
@@ -10011,8 +10037,7 @@ export declare interface SelfDecorator {
      * by the local injector when instantiating the class itself, but not
      * when instantiating a child.
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="Self">
-     * </code-example>
+     * {@example core/di/ts/metadata_spec.ts region='Self'}
      *
      * @see {@link SkipSelf}
      * @see {@link Optional}
@@ -10214,8 +10239,7 @@ export declare interface SkipSelfDecorator {
      * In the following example, the dependency can be resolved when
      * instantiating a child, but not when instantiating the class itself.
      *
-     * <code-example path="core/di/ts/metadata_spec.ts" region="SkipSelf">
-     * </code-example>
+     * {@example core/di/ts/metadata_spec.ts region='SkipSelf'}
      *
      * @see [Dependency Injection guide](guide/di/di-in-action#skip).
      * @see {@link Self}
@@ -10247,7 +10271,7 @@ declare interface StandaloneCompScopeData extends ScopeData {
  *
  * Example:
  *
- * ```
+ * ```ts
  * const COUNTER_KEY = makeStateKey<number>('counter');
  * let value = 10;
  *
@@ -10571,7 +10595,7 @@ declare const TEMPLATES = "t";
  * providers using the `provideProtractorTestingSupport()` function and adding them into the
  * `options.providers` array. Example:
  *
- * ```typescript
+ * ```ts
  * import {provideProtractorTestingSupport} from '@angular/platform-browser';
  *
  * await bootstrapApplication(RootComponent, providers: [provideProtractorTestingSupport()]);
@@ -11494,7 +11518,7 @@ export declare class TransferState {
  * @usageNotes
  * ### Example
  *
- * ```typescript
+ * ```ts
  * import { TRANSLATIONS } from '@angular/core';
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
@@ -11520,7 +11544,7 @@ export declare const TRANSLATIONS: InjectionToken<string>;
  * @usageNotes
  * ### Example
  *
- * ```typescript
+ * ```ts
  * import { TRANSLATIONS_FORMAT } from '@angular/core';
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
@@ -11632,7 +11656,7 @@ declare type TStylingRange = number & {
  *
  * Imagine we have:
  *
- * ```
+ * ```angular-ts
  * <div class="TEMPLATE" my-dir>
  *
  * @Directive({
@@ -11645,7 +11669,7 @@ declare type TStylingRange = number & {
  *
  * In the above case the linked list will contain one item:
  *
- * ```
+ * ```ts
  *   // assume binding location: 10 for `ɵɵclassProp('dynamic', ctx.exp);`
  *   tData[10] = <TStylingStatic>[
  *     '': 'dynamic', // This is the wrapped value of `TStylingKey`
@@ -11662,13 +11686,13 @@ declare type TStylingRange = number & {
  * `dynamic` (there is not). Therefore it is safe to remove it.
  *
  * If setting `true` case:
- * ```
+ * ```ts
  *   lView[10] = true;     // assume `ctx.exp` is `true`
  *   lView[10 + 1] = true; // Just normalized `lView[10]`
  * ```
  * So when the function is resolving styling value, it first needs to look into the linked list
  * (there is none) and than into `TNode.residualClass` (TNode.residualStyle) which contains
- * ```
+ * ```ts
  *   tNode.residualClass = [
  *     'TEMPLATE': true,
  *   ];
@@ -11986,7 +12010,7 @@ declare type Type_2 = Function;
  * An interface implemented by all Angular type decorators, which allows them to be used as
  * decorators as well as Angular syntax.
  *
- * ```
+ * ```ts
  * @ng.Component({...})
  * class MyClass {...}
  * ```
@@ -12119,7 +12143,7 @@ export declare const ViewChild: ViewChildDecorator;
  * Create a child query in your component by declaring a
  * class field and initializing it with the `viewChild()` function.
  *
- * ```ts
+ * ```angular-ts
  * @Component({template: '<div #el></div><my-component #cmp />'})
  * export class TestComponent {
  *   divEl = viewChild<ElementRef>('el');                   // Signal<ElementRef|undefined>
@@ -12356,7 +12380,7 @@ export declare interface ViewChildrenDecorator {
  * Note: the example uses standalone components, but the function can also be used for
  * non-standalone components (declared in an NgModule) as well.
  *
- * ```typescript
+ * ```angular-ts
  * @Component({
  *   standalone: true,
  *   selector: 'dynamic',
@@ -13913,7 +13937,7 @@ export declare class ɵLContext {
  *
  * Example:
  *
- * ```
+ * ```ts
  * renderComponent(AppComponent, {hostFeatures: [LifecycleHooksFeature]});
  * ```
  */
@@ -14117,6 +14141,22 @@ export declare const enum ɵNotificationSource {
  */
 export declare function ɵpatchComponentDefWithScope<C>(componentDef: ɵComponentDef<C>, transitiveScopes: ɵNgModuleTransitiveScopes): void;
 
+/**
+ * Internal implementation of the pending tasks service.
+ */
+export declare class ɵPendingTasksInternal implements OnDestroy {
+    private taskId;
+    private pendingTasks;
+    private get _hasPendingTasks();
+    hasPendingTasks: BehaviorSubject<boolean>;
+    add(): number;
+    has(taskId: number): boolean;
+    remove(taskId: number): void;
+    ngOnDestroy(): void;
+    /** @nocollapse */
+    static ɵprov: unknown;
+}
+
 
 export declare const ɵPERFORMANCE_MARK_PREFIX = "\uD83C\uDD70\uFE0F";
 
@@ -14392,7 +14432,7 @@ export declare function ɵresetJitOptions(): void;
  * Used to resolve resource URLs on `@Component` when used with JIT compilation.
  *
  * Example:
- * ```
+ * ```ts
  * @Component({
  *   selector: 'my-comp',
  *   templateUrl: 'my-comp.html', // This requires asynchronous resolution
@@ -14431,7 +14471,7 @@ export declare function ɵrestoreComponentResolutionQueue(queue: Map<Type<any>,
  * Formats and outputs the error message in a consistent way.
  *
  * Example:
- * ```
+ * ```ts
  *  throw new RuntimeError(
  *    RuntimeErrorCode.INJECTOR_ALREADY_DESTROYED,
  *    ngDevMode && 'Injector has already been destroyed.');
@@ -14871,7 +14911,7 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
      * @usageNotes
      * ### Example
      *
-     * ```typescript
+     * ```ts
      * @Component({
      *   selector: 'app-root',
      *   template: `Number of ticks: {{numberOfTicks}}`
@@ -14911,7 +14951,7 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
      * we want to check and update the list every five seconds. We can do that by detaching
      * the component's change detector and doing a local check every five seconds.
      *
-     * ```typescript
+     * ```ts
      * class DataProvider {
      *   // in a real application the returned data will be different every time
      *   get data() {
@@ -14961,7 +15001,7 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
      * its change detector from the main change detector tree when the component's live property
      * is set to false.
      *
-     * ```typescript
+     * ```ts
      * class DataProvider {
      *   data = 1;
      *
@@ -15075,18 +15115,18 @@ export declare function ɵwithIncrementalHydration(): Provider[];
  *
  * USAGE:
  * Given:
- * ```
+ * ```ts
  * interface Person {readonly name: string}
  * ```
  *
  * We would like to get a read/write version of `Person`.
- * ```
+ * ```ts
  * const WritablePerson = Writable<Person>;
  * ```
  *
  * The result is that you can do:
  *
- * ```
+ * ```ts
  * const readonlyPerson: Person = {name: 'Marry'};
  * readonlyPerson.name = 'John'; // TypeError
  * (readonlyPerson as WritablePerson).name = 'John'; // OK
@@ -15135,6 +15175,18 @@ export declare const ɵZONELESS_ENABLED: InjectionToken<boolean>;
  */
 export declare function ɵɵadvance(delta?: number): void;
 
+/**
+ * Sets the location within the source template at which
+ * each element in the current view was defined.
+ *
+ * @param index Index at which the DOM node was created.
+ * @param templatePath Path to the template at which the node was defined.
+ * @param locations Element locations to which to attach the source location.
+ *
+ * @codeGenApi
+ */
+export declare function ɵɵattachSourceLocations(templatePath: string, locations: [index: number, offset: number, line: number, column: number][]): void;
+
 /**
  * Updates the value of or removes a bound attribute on an Element.
  *
@@ -16027,7 +16079,7 @@ export declare function ɵɵdeferWhen(rawValue: unknown): void;
  *
  *
  * # Example
- * ```
+ * ```ts
  * class MyComponent {
  *   // Generated by Angular Template Compiler
  *   // [Symbol] syntax will not be supported by TypeScript until v2.7
@@ -16131,7 +16183,7 @@ export declare function ɵɵdefineNgModule<T>(def: {
  * Create a pipe definition object.
  *
  * # Example
- * ```
+ * ```ts
  * class MyPipe implements PipeTransform {
  *   // Generated by Angular Template Compiler
  *   static ɵpipe = definePipe({
@@ -16202,7 +16254,7 @@ export declare function ɵɵdirectiveInject<T>(token: ProviderToken<T>, flags: I
  * Disables directive matching on element.
  *
  *  * Example:
- * ```
+ * ```html
  * <my-comp my-directive>
  *   Should match component / directive.
  * </my-comp>
@@ -16300,7 +16352,7 @@ export declare function ɵɵelementStart(index: number, name: string, attrsIndex
  * Enables directive matching on elements.
  *
  *  * Example:
- * ```
+ * ```html
  * <my-comp my-directive>
  *   Should match component / directive.
  * </my-comp>
@@ -16807,7 +16859,7 @@ export declare type ɵɵNgModuleDeclaration<T, Declarations, Imports, Exports> =
  *
  * Example usage:
  *
- * ```
+ * ```ts
  * static ɵcmp = defineComponent({
  *   ...
  *   inputs: {name: 'publicName'},