@angular/core 19.0.0-next.2 → 19.0.0-next.4

package/fesm2022/primitives/event-dispatch.mjs

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

package/fesm2022/primitives/signals.mjs

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

package/fesm2022/rxjs-interop.mjs

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

package/fesm2022/testing.mjs

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

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0-next.2
+ * @license Angular v19.0.0-next.4
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -362,6 +362,104 @@ export declare function afterRender<E = never, W = never, M = never>(spec: {
  */
 export declare function afterRender(callback: VoidFunction, options?: AfterRenderOptions): AfterRenderRef;
 
+/**
+ * Register an effect that, when triggered, is invoked when the application finishes rendering, during the
+ * `mixedReadWrite` phase.
+ *
+ * <div class="alert is-critical">
+ *
+ * You should prefer specifying an explicit phase for the effect instead, or you risk significant
+ * performance degradation.
+ *
+ * </div>
+ *
+ * Note that callback-based `afterRenderEffect`s will run
+ * - in the order it they are registered
+ * - only when dirty
+ * - on browser platforms only
+ * - during the `mixedReadWrite` phase
+ *
+ * <div class="alert is-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.
+ *
+ * </div>
+ *
+ * @param callback An effect callback function to register
+ * @param options Options to control the behavior of the callback
+ *
+ * @experimental
+ */
+export declare function afterRenderEffect(callback: (onCleanup: EffectCleanupRegisterFn) => void, options?: Omit<AfterRenderOptions, 'phase'>): AfterRenderRef;
+
+/**
+ * Register effects that, when triggered, are invoked when the application finishes rendering,
+ * during the specified phases. The available phases are:
+ * - `earlyRead`
+ *   Use this phase to **read** from the DOM before a subsequent `write` callback, for example to
+ *   perform custom layout that the browser doesn't natively support. Prefer the `read` phase if
+ *   reading can wait until after the write phase. **Never** write to the DOM in this phase.
+ * - `write`
+ *    Use this phase to **write** to the DOM. **Never** read from the DOM in this phase.
+ * - `mixedReadWrite`
+ *    Use this phase to read from and write to the DOM simultaneously. **Never** use this phase if
+ *    it is possible to divide the work among the other phases instead.
+ * - `read`
+ *    Use this phase to **read** from the DOM. **Never** write to the DOM in this phase.
+ *
+ * <div class="alert is-critical">
+ *
+ * You should prefer using the `read` and `write` phases over the `earlyRead` and `mixedReadWrite`
+ * phases when possible, to avoid performance degradation.
+ *
+ * </div>
+ *
+ * Note that:
+ * - Effects run in the following phase order, only when dirty through signal dependencies:
+ *   1. `earlyRead`
+ *   2. `write`
+ *   3. `mixedReadWrite`
+ *   4. `read`
+ * - `afterRenderEffect`s in the same phase run in the order they are registered.
+ * - `afterRenderEffect`s run on browser platforms only, they will not run on the server.
+ * - `afterRenderEffect`s will run at least once.
+ *
+ * The first phase callback to run as part of this spec will receive no parameters. Each
+ * subsequent phase callback in this spec will receive the return value of the previously run
+ * phase callback as a `Signal`. This can be used to coordinate work across multiple phases.
+ *
+ * Angular is unable to verify or enforce that phases are used correctly, and instead
+ * relies on each developer to follow the guidelines documented for each value and
+ * carefully choose the appropriate one, refactoring their code if necessary. By doing
+ * so, Angular is better able to minimize the performance degradation associated with
+ * manual DOM access, ensuring the best experience for the end users of your application
+ * or library.
+ *
+ * <div class="alert is-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.
+ *
+ * </div>
+ *
+ * @param spec The effect functions to register
+ * @param options Options to control the behavior of the effects
+ *
+ * @usageNotes
+ *
+ * Use `afterRenderEffect` to create effects that will read or write from the DOM and thus should
+ * run after rendering.
+ *
+ * @experimental
+ */
+export declare function afterRenderEffect<E = never, W = never, M = never>(spec: {
+    earlyRead?: (onCleanup: EffectCleanupRegisterFn) => E;
+    write?: (...args: [...ɵFirstAvailableSignal<[E]>, EffectCleanupRegisterFn]) => W;
+    mixedReadWrite?: (...args: [...ɵFirstAvailableSignal<[W, E]>, EffectCleanupRegisterFn]) => M;
+    read?: (...args: [...ɵFirstAvailableSignal<[M, W, E]>, EffectCleanupRegisterFn]) => void;
+}, options?: Omit<AfterRenderOptions, 'phase'>): AfterRenderRef;
+
 declare type AfterRenderHook = (value?: unknown) => unknown;
 
 declare type AfterRenderHooks = [
@@ -1458,11 +1556,11 @@ export declare class Compiler {
      */
     compileModuleAsync<T>(moduleType: Type<T>): Promise<NgModuleFactory<T>>;
     /**
-     * Same as {@link #compileModuleSync} but also creates ComponentFactories for all components.
+     * Same as {@link Compiler#compileModuleSync compileModuleSync} but also creates ComponentFactories for all components.
      */
     compileModuleAndAllComponentsSync<T>(moduleType: Type<T>): ModuleWithComponentFactories<T>;
     /**
-     * Same as {@link #compileModuleAsync} but also creates ComponentFactories for all components.
+     * Same as {@link Compiler#compileModuleAsync compileModuleAsync} but also creates ComponentFactories for all components.
      */
     compileModuleAndAllComponentsAsync<T>(moduleType: Type<T>): Promise<ModuleWithComponentFactories<T>>;
     /**
@@ -3962,6 +4060,9 @@ declare const ENVIRONMENT = 10;
  * A multi-provider token for initialization functions that will run upon construction of an
  * environment injector.
  *
+ * Note: As opposed to the `APP_INITIALIZER` token, the `ENVIRONMENT_INITIALIZER` functions are not awaited,
+ * hence they should not be `async`.
+ *
  * @publicApi
  */
 export declare const ENVIRONMENT_INITIALIZER: InjectionToken<readonly (() => void)[]>;
@@ -4232,6 +4333,7 @@ export declare interface ExistingSansProvider {
  */
 export declare class ExperimentalPendingTasks {
     private internalPendingTasks;
+    private scheduler;
     /**
      * Adds a new task that should block application's stability.
      * @returns A cleanup function that removes a task when called.
@@ -12854,6 +12956,12 @@ export declare function ɵfindLocaleData(locale: string): any;
  */
 export declare type ɵFirstAvailable<T extends unknown[]> = T extends [infer H, ...infer R] ? [H] extends [never] ? ɵFirstAvailable<R> : [H] : [];
 
+/**
+ * An argument list containing the first non-never type in the given type array, or an empty
+ * argument list if there are no non-never types in the type array.
+ */
+export declare type ɵFirstAvailableSignal<T extends unknown[]> = T extends [infer H, ...infer R] ? [H] extends [never] ? ɵFirstAvailableSignal<R> : [Signal<H>] : [];
+
 /**
  * Loops over queued module definitions, if a given module definition has all of its
  * declarations resolved, it dequeues that module definition and sets the scope on
@@ -13392,7 +13500,8 @@ export declare const enum ɵNotificationSource {
     DeferredRenderHook = 8,
     ViewAttached = 9,
     ViewDetachedFromDOM = 10,
-    AsyncAnimationsLoaded = 11
+    AsyncAnimationsLoaded = 11,
+    PendingTaskRemoved = 12
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "19.0.0-next.2",
+  "version": "19.0.0-next.4",
   "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-next.2
+ * @license Angular v19.0.0-next.4
  * (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-next.2
+ * @license Angular v19.0.0-next.4
  * (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-next.2
+ * @license Angular v19.0.0-next.4
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */