@angular/core 19.0.0 → 19.0.2

package/fesm2022/primitives/event-dispatch.mjs

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

package/fesm2022/primitives/signals.mjs

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

package/fesm2022/rxjs-interop.mjs

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

package/fesm2022/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0
+ * @license Angular v19.0.2
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -175,10 +175,10 @@ class TestBedApplicationErrorHandler {
             throw e;
         }
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: TestBedApplicationErrorHandler, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: TestBedApplicationErrorHandler });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.0.2", ngImport: i0, type: TestBedApplicationErrorHandler, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.0.2", ngImport: i0, type: TestBedApplicationErrorHandler });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.0", ngImport: i0, type: TestBedApplicationErrorHandler, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.0.2", ngImport: i0, type: TestBedApplicationErrorHandler, decorators: [{
             type: Injectable
         }] });
 

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0
+ * @license Angular v19.0.2
  * (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.
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -479,6 +479,7 @@ declare class AfterRenderImpl {
     private readonly deferredRegistrations;
     /** Whether the `AfterRenderManager` is currently executing hooks. */
     executing: boolean;
+    constructor();
     /**
      * Run the sequence of phases of hooks, once through. As a result of executing some hooks, more
      * might be scheduled.
@@ -486,6 +487,7 @@ declare class AfterRenderImpl {
     execute(): void;
     register(sequence: AfterRenderSequence): void;
     unregister(sequence: AfterRenderSequence): void;
+    protected maybeTrace<T>(fn: () => T, snapshot: ɵTracingSnapshot | null): T;
     /** @nocollapse */
     static ɵprov: unknown;
 }
@@ -512,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.
@@ -555,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.
@@ -573,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.
@@ -604,6 +606,7 @@ declare class AfterRenderSequence implements AfterRenderRef {
     readonly impl: AfterRenderImpl;
     readonly hooks: AfterRenderHooks;
     once: boolean;
+    snapshot: ɵTracingSnapshot | null;
     /**
      * Whether this sequence errored or was destroyed during this execution, and hooks should no
      * longer run for it.
@@ -615,7 +618,7 @@ declare class AfterRenderSequence implements AfterRenderRef {
      */
     pipelinedValue: unknown;
     private unregisterOnDestroy;
-    constructor(impl: AfterRenderImpl, hooks: AfterRenderHooks, once: boolean, destroyRef: DestroyRef | null);
+    constructor(impl: AfterRenderImpl, hooks: AfterRenderHooks, once: boolean, destroyRef: DestroyRef | null, snapshot?: ɵTracingSnapshot | null);
     afterRun(): void;
     destroy(): void;
 }
@@ -1014,11 +1017,13 @@ export declare class ApplicationRef {
      * Returns an Observable that indicates when the application is stable or unstable.
      */
     readonly isStable: Observable<boolean>;
+    constructor();
     /**
      * @returns A promise that resolves when the application becomes stable
      */
     whenStable(): Promise<void>;
     private readonly _injector;
+    private _rendererFactory;
     /**
      * The `EnvironmentInjector` used to create this application.
      */
@@ -2593,7 +2598,10 @@ declare const CONTEXT = 8;
  *  * `elementInjector` (optional): An `ElementInjector` instance, see additional info about it
  * [here](guide/di/hierarchical-dependency-injection#elementinjector).
  *  * `projectableNodes` (optional): A list of DOM nodes that should be projected through
- *                      [`<ng-content>`](api/core/ng-content) of the new component instance.
+ * [`<ng-content>`](api/core/ng-content) of the new component instance, e.g.,
+ * `[[element1, element2]]`: projects `element1` and `element2` into the same `<ng-content>`.
+ * `[[element1, element2], [element3]]`: projects `element1` and `element2` into one `<ng-content>`,
+ * and `element3` into a separate `<ng-content>`.
  * @returns ComponentRef instance that represents a given Component.
  *
  * @publicApi
@@ -2968,7 +2976,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:**
  *
@@ -4249,6 +4257,12 @@ export declare type EnvironmentProviders = {
  *   }
  * }
  *
+ * // Provide in standalone apps
+ * bootstrapApplication(AppComponent, {
+ *   providers: [{provide: ErrorHandler, useClass: MyErrorHandler}]
+ * })
+ *
+ * // Provide in module-based apps
  * @NgModule({
  *   providers: [{provide: ErrorHandler, useClass: MyErrorHandler}]
  * })
@@ -5859,7 +5873,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,
@@ -7026,8 +7040,8 @@ declare interface LView<T = unknown> extends Array<any> {
      * - For inline views, the context is null.
      */
     [CONTEXT]: T;
-    /** An optional Module Injector to be used as fall back after Element Injectors are consulted. */
-    readonly [INJECTOR_2]: Injector | null;
+    /** A Module Injector to be used as fall back after Element Injectors are consulted. */
+    readonly [INJECTOR_2]: Injector;
     /**
      * Contextual data that is shared across multiple instances of `LView` in the same application.
      */
@@ -7233,7 +7247,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.
@@ -7943,14 +7957,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;
     /**
@@ -10447,6 +10460,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> */
@@ -12909,6 +12941,7 @@ export declare class ɵChangeDetectionSchedulerImpl implements ɵChangeDetection
     private readonly taskService;
     private readonly ngZone;
     private readonly zonelessEnabled;
+    private readonly tracing;
     private readonly disableScheduling;
     private readonly zoneIsDefined;
     private readonly schedulerTickApplyArgs;
@@ -14681,6 +14714,45 @@ export declare const ɵTESTABILITY: InjectionToken<Testability>;
  */
 export declare const ɵTESTABILITY_GETTER: InjectionToken<GetTestability>;
 
+/** Actions that are supported by the tracing framework. */
+export declare enum ɵTracingAction {
+    CHANGE_DETECTION = 0,
+    AFTER_NEXT_RENDER = 1
+}
+
+/**
+ * Injection token for a `TracingService`, optionally provided.
+ */
+export declare const ɵTracingService: InjectionToken<ɵTracingService<ɵTracingSnapshot>>;
+
+/**
+ * Tracing mechanism which can associate causes (snapshots) with runs of
+ * subsequent operations.
+ *
+ * Not defined by Angular directly, but defined in contexts where tracing is
+ * desired.
+ */
+export declare interface ɵTracingService<T extends ɵTracingSnapshot> {
+    /**
+     * Take a snapshot of the current context which will be stored by Angular and
+     * 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;
+}
+
+/** 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;
+}
+
 /**
  * Compute the pair of transitive scopes (compilation scope and exported scope) for a given type
  * (either a NgModule or a standalone component / directive / pipe).
@@ -14965,12 +15037,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.
- */
-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
@@ -15795,10 +15861,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
@@ -17612,11 +17681,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "19.0.0",
+  "version": "19.0.2",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",

package/primitives/event-dispatch/index.d.ts

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

package/primitives/signals/index.d.ts

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

package/rxjs-interop/index.d.ts

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