@angular/core 19.0.1 → 19.0.3

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.1
+ * @license Angular v19.0.3
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -98,7 +98,7 @@ export declare interface AfterContentInit {
  * - `read`
  *    Use this phase to **read** from the DOM. **Never** write to the DOM in this phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer using the `read` and `write` phases over the `earlyRead` and `mixedReadWrite`
  * phases when possible, to avoid performance degradation.
@@ -125,7 +125,7 @@ export declare interface AfterContentInit {
  * manual DOM access, ensuring the best experience for the end users of your application
  * or library.
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -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>`,
@@ -173,7 +173,7 @@ export declare function afterNextRender<E = never, W = never, M = never>(spec: {
  * Register a callback to be invoked the next time the application finishes rendering, during the
  * `mixedReadWrite` phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer specifying an explicit phase for the callback instead, or you risk significant
  * performance degradation.
@@ -185,7 +185,7 @@ export declare function afterNextRender<E = never, W = never, M = never>(spec: {
  * - on browser platforms only
  * - during the `mixedReadWrite` phase
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -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>`,
@@ -239,7 +239,7 @@ export declare function afterNextRender(callback: VoidFunction, options?: AfterR
  * - `read`
  *    Use this phase to **read** from the DOM. **Never** write to the DOM in this phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer using the `read` and `write` phases over the `earlyRead` and `mixedReadWrite`
  * phases when possible, to avoid performance degradation.
@@ -266,7 +266,7 @@ export declare function afterNextRender(callback: VoidFunction, options?: AfterR
  * manual DOM access, ensuring the best experience for the end users of your application
  * or library.
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -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>`,
@@ -312,7 +312,7 @@ export declare function afterRender<E = never, W = never, M = never>(spec: {
  * Register a callback to be invoked each time the application finishes rendering, during the
  * `mixedReadWrite` phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer specifying an explicit phase for the callback instead, or you risk significant
  * performance degradation.
@@ -325,7 +325,7 @@ export declare function afterRender<E = never, W = never, M = never>(spec: {
  * - on browser platforms only
  * - during the `mixedReadWrite` phase
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -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>`,
@@ -366,7 +366,7 @@ export declare function afterRender(callback: VoidFunction, options?: AfterRende
  * Register an effect that, when triggered, is invoked when the application finishes rendering, during the
  * `mixedReadWrite` phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer specifying an explicit phase for the effect instead, or you risk significant
  * performance degradation.
@@ -379,7 +379,7 @@ export declare function afterRender(callback: VoidFunction, options?: AfterRende
  * - on browser platforms only
  * - during the `mixedReadWrite` phase
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -408,7 +408,7 @@ export declare function afterRenderEffect(callback: (onCleanup: EffectCleanupReg
  * - `read`
  *    Use this phase to **read** from the DOM. **Never** write to the DOM in this phase.
  *
- * <div class="alert is-critical">
+ * <div class="docs-alert docs-alert-critical">
  *
  * You should prefer using the `read` and `write` phases over the `earlyRead` and `mixedReadWrite`
  * phases when possible, to avoid performance degradation.
@@ -436,7 +436,7 @@ export declare function afterRenderEffect(callback: (onCleanup: EffectCleanupReg
  * manual DOM access, ensuring the best experience for the end users of your application
  * or library.
  *
- * <div class="alert is-important">
+ * <div class="docs-alert docs-alert-important">
  *
  * Components are not guaranteed to be [hydrated](guide/hydration) before the callback runs.
  * You must use caution when directly reading or writing the DOM and layout.
@@ -514,7 +514,7 @@ export declare interface AfterRenderOptions {
     /**
      * The phase the callback should be invoked in.
      *
-     * <div class="alert is-critical">
+     * <div class="docs-alert docs-alert-critical">
      *
      * Defaults to `AfterRenderPhase.MixedReadWrite`. You should choose a more specific
      * phase instead. See `AfterRenderPhase` for more information.
@@ -557,7 +557,7 @@ export declare enum AfterRenderPhase {
      * `AfterRenderPhase.EarlyRead` phase if reading can wait until after the write phase.
      * **Never** write to the DOM in this phase.
      *
-     * <div class="alert is-important">
+     * <div class="docs-alert docs-alert-important">
      *
      * Using this value can degrade performance.
      * Instead, prefer using built-in browser functionality when possible.
@@ -575,7 +575,7 @@ export declare enum AfterRenderPhase {
      * DOM, that haven't been refactored to use a different phase. **Never** use this phase if
      * it is possible to divide the work among the other phases instead.
      *
-     * <div class="alert is-critical">
+     * <div class="docs-alert docs-alert-critical">
      *
      * Using this value can **significantly** degrade performance.
      * Instead, prefer dividing work into the appropriate phase callbacks.
@@ -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),
@@ -1023,6 +1023,7 @@ export declare class ApplicationRef {
      */
     whenStable(): Promise<void>;
     private readonly _injector;
+    private _rendererFactory;
     /**
      * The `EnvironmentInjector` used to create this application.
      */
@@ -1276,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.
@@ -1407,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
  *
@@ -1418,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
@@ -1428,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
  */
@@ -1798,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
@@ -2555,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 }}!`
@@ -2975,7 +2975,7 @@ declare const DECLARATION_VIEW = 14;
  *
  * See the [i18n guide](guide/i18n/locale-id) for more information.
  *
- * <div class="alert is-helpful">
+ * <div class="docs-alert docs-alert-helpful">
  *
  * **Deprecation notice:**
  *
@@ -2995,7 +2995,7 @@ declare const DECLARATION_VIEW = 14;
  * @usageNotes
  * ### Example
  *
- * ```typescript
+ * ```ts
  * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { AppModule } from './app/app.module';
  *
@@ -3341,7 +3341,7 @@ export declare abstract class DestroyRef {
      *
      * @usageNotes
      * ### Example
-     * ```typescript
+     * ```ts
      * const destroyRef = inject(DestroyRef);
      *
      * // register a destroy callback
@@ -3411,7 +3411,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'}],
@@ -3447,7 +3447,7 @@ export declare interface Directive {
      *
      * @usageNotes
      *
-     * ```typescript
+     * ```ts
      * @Component({
      *   selector: 'child-dir',
      *   outputs: [ 'bankNameChange' ],
@@ -3831,7 +3831,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * Map of inputs for a given directive/component.
  *
  * Given:
- * ```
+ * ```ts
  * class MyComponent {
  *   @Input()
  *   publicInput1: string;
@@ -3847,7 +3847,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * ```
  *
  * is described as:
- * ```
+ * ```ts
  * {
  *   publicInput1: 'publicInput1',
  *   declaredInput2: [InputFlags.None, 'declaredInput2', 'publicInput2'],
@@ -3862,7 +3862,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  * ```
  *
  * Which the minifier may translate to:
- * ```
+ * ```ts
  * {
  *   minifiedPublicInput1: 'publicInput1',
  *   minifiedDeclaredInput2: [InputFlags.None, 'publicInput2', 'declaredInput2'],
@@ -3909,7 +3909,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
@@ -4088,7 +4088,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>
@@ -4097,7 +4097,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>
@@ -4106,13 +4106,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>
@@ -4249,7 +4249,7 @@ export declare type EnvironmentProviders = {
  * @usageNotes
  * ### Example
  *
- * ```
+ * ```ts
  * class MyErrorHandler implements ErrorHandler {
  *   handleError(error) {
  *     // do something with the exception
@@ -4293,7 +4293,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: `
@@ -4496,7 +4496,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],
@@ -4841,7 +4841,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);
@@ -4849,7 +4849,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});
@@ -4864,7 +4864,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'));
@@ -4872,7 +4872,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});
@@ -4924,7 +4924,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) {}
@@ -4987,7 +4987,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;
@@ -4998,7 +4998,7 @@ export declare interface HostBindingDecorator {
  * ```
  *
  * ## Pseudocode
- * ```
+ * ```ts
  * const hostBindingOpCodes = tView.hostBindingOpCodes;
  * if (hostBindingOpCodes === null) return;
  * for (let i = 0; i < hostBindingOpCodes.length; i++) {
@@ -5041,8 +5041,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).
@@ -5231,7 +5230,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",
@@ -5522,7 +5521,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)
@@ -5533,7 +5532,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',
@@ -5747,7 +5746,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;
@@ -5800,8 +5799,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
      *
@@ -5872,7 +5870,7 @@ export declare enum InjectFlags {
  * `InjectionToken` is parameterized on `T` which is the type of object which will be returned by
  * the `Injector`. This provides an additional level of type safety.
  *
- * <div class="alert is-helpful">
+ * <div class="docs-alert docs-alert-helpful">
  *
  * **Important Note**: Ensure that you use the same instance of the `InjectionToken` in both the
  * provider and the injection call. Creating a new instance of `InjectionToken` in different places,
@@ -5881,8 +5879,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
@@ -6131,7 +6128,7 @@ export declare const Input: InputDecorator;
  * @usageNotes
  * To use signal-based inputs, import `input` from `@angular/core`.
  *
- * ```
+ * ```ts
  * import {input} from '@angular/core`;
  * ```
  *
@@ -6180,7 +6177,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',
@@ -6858,7 +6855,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';
@@ -7246,7 +7243,7 @@ declare const enum LViewFlags {
     /** Whether or not this view is the root view */
     IsRoot = 512,
     /**
-     * Whether this moved LView was needs to be refreshed. Similar to the Dirty flag, but used for
+     * Whether this moved LView needs to be refreshed. Similar to the Dirty flag, but used for
      * transplanted and signal views where the parent/ancestor views are not marked dirty as well.
      * i.e. "Refresh just this view". Used in conjunction with the HAS_CHILD_VIEWS_TO_REFRESH
      * flag.
@@ -7284,7 +7281,7 @@ export declare function makeEnvironmentProviders(providers: (Provider | Environm
  *
  * Example:
  *
- * ```
+ * ```ts
  * const COUNTER_KEY = makeStateKey<number>('counter');
  * let value = 10;
  *
@@ -7316,7 +7313,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';
@@ -7345,7 +7342,7 @@ export declare enum MissingTranslationStrategy {
  *
  * To use `model()`, import the function from `@angular/core`.
  *
- * ```
+ * ```ts
  * import {model} from '@angular/core`;
  * ```
  *
@@ -7787,7 +7784,7 @@ export declare class NgProbeToken {
  * @usageNotes
  * ### Example
  *
- * ```
+ * ```ts
  * import {Component, NgZone} from '@angular/core';
  * import {NgIf} from '@angular/common';
  *
@@ -7956,14 +7953,13 @@ export declare interface NgZoneOptions {
      *
      * When button is clicked, because of the event bubbling, both
      * event handlers will be called and 2 change detections will be
-     * triggered. We can coalesce such kind of events to only trigger
+     * triggered. We can coalesce such kind of events to trigger
      * change detection only once.
      *
-     * By default, this option will be false. So the events will not be
-     * coalesced and the change detection will be triggered multiple times.
-     * And if this option be set to true, the change detection will be
-     * triggered async by scheduling a animation frame. So in the case above,
-     * the change detection will only be triggered once.
+     * By default, this option is set to false, meaning events will
+     * not be coalesced, and change detection will be triggered multiple times.
+     * If this option is set to true, change detection will be triggered
+     * once in the scenario described above.
      */
     eventCoalescing?: boolean;
     /**
@@ -8060,7 +8056,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 +8184,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 +8365,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:
@@ -8484,7 +8479,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 +8595,7 @@ export declare class PlatformRef {
      * @usageNotes
      * ### Simple Example
      *
-     * ```typescript
+     * ```ts
      * @NgModule({
      *   imports: [BrowserModule]
      * })
@@ -8713,7 +8708,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 +8742,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 +8808,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 +8868,7 @@ export declare type ProviderToken<T> = Type<T> | AbstractType<T> | InjectionToke
  * `BootstrapOptions` instead.
  *
  * @usageNotes
- * ```typescript
+ * ```ts
  * bootstrapApplication(MyApp, {providers: [
  *   provideZoneChangeDetection({eventCoalescing: true}),
  * ]});
@@ -8972,7 +8967,7 @@ declare const enum QueryFlags {
  *
  * @usageNotes
  * ### Example
- * ```typescript
+ * ```ts
  * @Component({...})
  * class Container {
  *   @ViewChildren(Item) items:QueryList<Item>;
@@ -9249,7 +9244,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',
@@ -10011,8 +10006,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 +10208,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 +10240,7 @@ declare interface StandaloneCompScopeData extends ScopeData {
  *
  * Example:
  *
- * ```
+ * ```ts
  * const COUNTER_KEY = makeStateKey<number>('counter');
  * let value = 10;
  *
@@ -10460,6 +10453,25 @@ declare interface TDeferBlockDetails {
      * List of prefetch triggers for a given block
      */
     prefetchTriggers: Set<DeferBlockTrigger> | null;
+    /**
+     * Defer block flags, which should be used for all
+     * instances of a given defer block (the flags that should be
+     * placed into the `TDeferDetails` at runtime).
+     */
+    flags: TDeferDetailsFlags;
+}
+
+/**
+ * Specifies defer block flags, which should be used for all
+ * instances of a given defer block (the flags that should be
+ * placed into the `TDeferDetails` at runtime).
+ */
+declare const enum TDeferDetailsFlags {
+    Default = 0,
+    /**
+     * Whether or not the defer block has hydrate triggers.
+     */
+    HasHydrateTriggers = 1
 }
 
 /** Static data for an <ng-container> */
@@ -10552,7 +10564,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()]);
@@ -11475,7 +11487,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';
@@ -11501,7 +11513,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';
@@ -11613,7 +11625,7 @@ declare type TStylingRange = number & {
  *
  * Imagine we have:
  *
- * ```
+ * ```angular-ts
  * <div class="TEMPLATE" my-dir>
  *
  * @Directive({
@@ -11626,7 +11638,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`
@@ -11643,13 +11655,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,
  *   ];
@@ -11967,7 +11979,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 {...}
  * ```
@@ -12100,7 +12112,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>
@@ -12337,7 +12349,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',
@@ -13894,7 +13906,7 @@ export declare class ɵLContext {
  *
  * Example:
  *
- * ```
+ * ```ts
  * renderComponent(AppComponent, {hostFeatures: [LifecycleHooksFeature]});
  * ```
  */
@@ -14373,7 +14385,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
@@ -14412,7 +14424,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.');
@@ -14719,6 +14731,10 @@ export declare interface ɵTracingService<T extends ɵTracingSnapshot> {
      * used when additional work is performed that was scheduled in this context.
      *
      * @param linkedSnapshot Optional snapshot to use link to the current context.
+     * The caller is no longer responsible for calling dispose on the linkedSnapshot.
+     *
+     * @return The tracing snapshot. The caller is responsible for diposing of the
+     * snapshot.
      */
     snapshot(linkedSnapshot: T | null): T;
 }
@@ -14726,6 +14742,8 @@ export declare interface ɵTracingService<T extends ɵTracingSnapshot> {
 /** A single tracing snapshot. */
 export declare interface ɵTracingSnapshot {
     run<T>(action: ɵTracingAction, fn: () => T): T;
+    /** Disposes of the tracing snapshot. Must be run exactly once per TracingSnapshot. */
+    dispose(): void;
 }
 
 /**
@@ -14846,7 +14864,7 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
      * @usageNotes
      * ### Example
      *
-     * ```typescript
+     * ```ts
      * @Component({
      *   selector: 'app-root',
      *   template: `Number of ticks: {{numberOfTicks}}`
@@ -14886,7 +14904,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() {
@@ -14936,7 +14954,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;
      *
@@ -15012,16 +15030,6 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
     attachToAppRef(appRef: ApplicationRef): void;
 }
 
-/**
- * Returns a Promise that resolves when the application becomes stable after this method is called
- * the first time.
- *
- * Note: this function is unused in the FW code, but it's still present since the CLI code relies
- * on it currently (see https://github.com/angular/angular-cli/blob/20411f696eb52c500e096e3dfc5e195185794edc/packages/angular/ssr/src/routes/ng-routes.ts#L435).
- * Remove this function once CLI code is updated to use `ApplicationRef.whenStable` instead.
- */
-export declare function ɵwhenStable(applicationRef: ApplicationRef): Promise<void>;
-
 /**
  * Returns a set of providers required to setup hydration support
  * for an application that is server side rendered. This function is
@@ -15060,18 +15068,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
@@ -15846,10 +15854,13 @@ export declare function ɵɵdeclareLet(index: number): typeof ɵɵdeclareLet;
  *     placeholder block.
  * @param enableTimerScheduling Function that enables timer-related scheduling if `after`
  *     or `minimum` parameters are setup on the `@loading` or `@placeholder` blocks.
+ * @param flags A set of flags to define a particular behavior (e.g. to indicate that
+ *              hydrate triggers are present and regular triggers should be deactivated
+ *              in certain scenarios).
  *
  * @codeGenApi
  */
-export declare function ɵɵdefer(index: number, primaryTmplIndex: number, dependencyResolverFn?: DependencyResolverFn | null, loadingTmplIndex?: number | null, placeholderTmplIndex?: number | null, errorTmplIndex?: number | null, loadingConfigIndex?: number | null, placeholderConfigIndex?: number | null, enableTimerScheduling?: typeof ɵɵdeferEnableTimerScheduling): void;
+export declare function ɵɵdefer(index: number, primaryTmplIndex: number, dependencyResolverFn?: DependencyResolverFn | null, loadingTmplIndex?: number | null, placeholderTmplIndex?: number | null, errorTmplIndex?: number | null, loadingConfigIndex?: number | null, placeholderConfigIndex?: number | null, enableTimerScheduling?: typeof ɵɵdeferEnableTimerScheduling, flags?: TDeferDetailsFlags | null): void;
 
 /**
  * Enables timer-related scheduling if `after` or `minimum` parameters are setup
@@ -16009,7 +16020,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
@@ -16113,7 +16124,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({
@@ -16184,7 +16195,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>
@@ -16282,7 +16293,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>
@@ -16789,7 +16800,7 @@ export declare type ɵɵNgModuleDeclaration<T, Declarations, Imports, Exports> =
  *
  * Example usage:
  *
- * ```
+ * ```ts
  * static ɵcmp = defineComponent({
  *   ...
  *   inputs: {name: 'publicName'},
@@ -17663,11 +17674,11 @@ export declare function ɵɵrepeaterTrackByIndex(index: number): number;
  * Replaces the metadata of a component type and re-renders all live instances of the component.
  * @param type Class whose metadata will be replaced.
  * @param applyMetadata Callback that will apply a new set of metadata on the `type` when invoked.
- * @param environment Core runtime environment to use when applying the HMR update.
+ * @param environment Syntehtic namespace imports that need to be passed along to the callback.
  * @param locals Local symbols from the source location that have to be exposed to the callback.
  * @codeGenApi
  */
-export declare function ɵɵreplaceMetadata(type: Type<unknown>, applyMetadata: (...args: [Type<unknown>, Record<string, unknown>, ...unknown[]]) => void, environment: Record<string, unknown>, locals: unknown[]): void;
+export declare function ɵɵreplaceMetadata(type: Type<unknown>, applyMetadata: (...args: [Type<unknown>, unknown[], ...unknown[]]) => void, namespaces: unknown[], locals: unknown[]): void;
 
 /**
  * Clears the view set in `ɵɵrestoreView` from memory. Returns the passed in