@angular/core 19.0.0-next.5 → 19.0.0-next.7

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0-next.5
+ * @license Angular v19.0.0-next.7
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -980,6 +980,7 @@ export declare class ApplicationRef {
     private readonly internalErrorHandler;
     private readonly afterRenderManager;
     private readonly zonelessEnabled;
+    private readonly rootEffectScheduler;
     private externalTestViews;
     /**
      * Indicates whether this instance was destroyed.
@@ -1762,9 +1763,10 @@ export declare interface ComponentDecorator {
      * Unlike other directives, only one component can be instantiated for a given element in a
      * template.
      *
-     * A component must belong to an NgModule in order for it to be available
-     * to another component or application. To make it a member of an NgModule,
-     * list it in the `declarations` field of the `NgModule` metadata.
+     * Standalone components can be directly imported in any other standalone component or NgModule.
+     * NgModule based apps on the other hand require components to belong to an NgModule in
+     * order for them to be available to another component or application. To make a component a
+     * member of an NgModule, list it in the `declarations` field of the `NgModule` metadata.
      *
      * Note that, in addition to these options for configuring a directive,
      * you can control a component's runtime behavior by implementing
@@ -2282,7 +2284,7 @@ export declare const ContentChild: ContentChildDecorator;
  * ```
  *
  * @initializerApiFunction
- * @developerPreview
+ * @publicAPI
  */
 export declare const contentChild: ContentChildFunction;
 
@@ -2369,7 +2371,7 @@ export declare interface ContentChildDecorator {
  * The contentChild function creates a singular content query. It is a special function that also
  * provides access to required query results via the `.required` property.
  *
- * @developerPreview
+ * @publicAPI
  * @docsPrivate Ignored because `contentChild` is the canonical API entry.
  */
 export declare interface ContentChildFunction {
@@ -2377,7 +2379,7 @@ export declare interface ContentChildFunction {
      * Initializes a content child query.
      *
      * Consider using `contentChild.required` for queries that should always match.
-     * @developerPreview
+     * @publicAPI
      */
     <LocatorT>(locator: ProviderToken<LocatorT> | string, opts?: {
         descendants?: boolean;
@@ -2614,10 +2616,12 @@ export declare interface CreateEffectOptions {
      */
     manualCleanup?: boolean;
     /**
-     * Whether the `effect` should allow writing to signals.
-     *
-     * Using effects to synchronize data by writing to signals can lead to confusing and potentially
-     * incorrect behavior, and should be enabled only when necessary.
+     * Always create a root effect (which is scheduled as a microtask) regardless of whether `effect`
+     * is called within a component.
+     */
+    forceRoot?: true;
+    /**
+     * @deprecated no longer required, signal writes are allowed by default.
      */
     allowSignalWrites?: boolean;
 }
@@ -3255,7 +3259,6 @@ declare type DestroyHookData = (HookEntry | HookData)[];
  */
 export declare function destroyPlatform(): void;
 
-
 /**
  * `DestroyRef` lets you set callbacks to run for any cleanup or destruction behavior.
  * The scope of this destruction depends on where `DestroyRef` is injected. If `DestroyRef`
@@ -3892,7 +3895,20 @@ export declare interface DoCheck {
 }
 
 /**
- * Create a global `Effect` for the given reactive function.
+ * Registers an "effect" that will be scheduled & executed whenever the signals that it reads
+ * changes.
+ *
+ * Angular has two different kinds of effect: component effects and root effects. Component effects
+ * are created when `effect()` is called from a component, directive, or within a service of a
+ * component/directive. Root effects are created when `effect()` is called from outside the
+ * component tree, such as in a root service, or when the `forceRoot` option is provided.
+ *
+ * The two effect types differ in their timing. Component effects run as a component lifecycle
+ * event during Angular's synchronization (change detection) process, and can safely read input
+ * signals or create/destroy views that depend on component state. Root effects run as microtasks
+ * and have no connection to the component tree or change detection.
+ *
+ * `effect()` must be run in injection context, unless the `injector` option is manually specified.
  *
  * @developerPreview
  */
@@ -3914,6 +3930,17 @@ export declare type EffectCleanupFn = () => void;
  */
 export declare type EffectCleanupRegisterFn = (cleanupFn: EffectCleanupFn) => void;
 
+declare interface EffectNode extends ReactiveNode, SchedulableEffect {
+    hasRun: boolean;
+    cleanupFns: EffectCleanupFn[] | undefined;
+    injector: Injector;
+    onDestroyFn: () => void;
+    fn: (cleanupFn: EffectCleanupRegisterFn) => void;
+    run(): void;
+    destroy(): void;
+    maybeCleanup(): void;
+}
+
 /**
  * A global reactive effect, which can be manually destroyed.
  *
@@ -3926,6 +3953,8 @@ export declare interface EffectRef {
     destroy(): void;
 }
 
+declare const EFFECTS = 23;
+
 declare const EFFECTS_TO_SCHEDULE = 22;
 
 /**
@@ -4305,44 +4334,6 @@ export declare interface ExistingSansProvider {
     useExisting: any;
 }
 
-/**
- * Experimental service that keeps track of pending tasks contributing to the stableness of Angular
- * application. While several existing Angular services (ex.: `HttpClient`) will internally manage
- * tasks influencing stability, this API gives control over stability to library and application
- * developers for specific cases not covered by Angular internals.
- *
- * The concept of stability comes into play in several important scenarios:
- * - SSR process needs to wait for the application stability before serializing and sending rendered
- * HTML;
- * - tests might want to delay assertions until the application becomes stable;
- *
- * @usageNotes
- * ```typescript
- * const pendingTasks = inject(ExperimentalPendingTasks);
- * const taskCleanup = pendingTasks.add();
- * // do work that should block application's stability and then:
- * taskCleanup();
- * ```
- *
- * This API is experimental. Neither the shape, nor the underlying behavior is stable and can change
- * in patch versions. We will iterate on the exact API based on the feedback and our understanding
- * of the problem and solution space.
- *
- * @publicApi
- * @experimental
- */
-export declare class ExperimentalPendingTasks {
-    private internalPendingTasks;
-    private scheduler;
-    /**
-     * Adds a new task that should block application's stability.
-     * @returns A cleanup function that removes a task when called.
-     */
-    add(): () => void;
-    /** @nocollapse */
-    static ɵprov: unknown;
-}
-
 /**
  * Definition of what a factory function should look like.
  */
@@ -6099,7 +6090,7 @@ export declare const Input: InputDecorator;
  * <span>{{firstName()}}</span>
  * ```
  *
- * @developerPreview
+ * @publicAPI
  * @initializerApiFunction
  */
 export declare const input: InputFunction;
@@ -6179,7 +6170,7 @@ declare enum InputFlags {
  * The function exposes an API for also declaring required inputs via the
  * `input.required` function.
  *
- * @developerPreview
+ * @publicAPI
  * @docsPrivate Ignored because `input` is the canonical API entry.
  */
 export declare interface InputFunction {
@@ -6213,7 +6204,7 @@ export declare interface InputFunction {
      * Consumers of your directive/component need to bind to this
      * input. If unset, a compile time error will be reported.
      *
-     * @developerPreview
+     * @publicAPI
      */
     required: {
         /** Declares a required input of type `T`. */
@@ -6229,7 +6220,7 @@ export declare interface InputFunction {
 }
 
 /**
- * @developerPreview
+ * @publicAPI
  *
  * Options for signal inputs.
  */
@@ -6252,7 +6243,7 @@ export declare interface InputOptions<T, TransformT> {
 /**
  * Signal input options without the transform option.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare type InputOptionsWithoutTransform<T> = Omit<InputOptions<T, T>, 'transform'> & {
     transform?: undefined;
@@ -6261,7 +6252,7 @@ export declare type InputOptionsWithoutTransform<T> = Omit<InputOptions<T, T>, '
 /**
  * Signal input options with the transform option required.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare type InputOptionsWithTransform<T, TransformT> = Required<Pick<InputOptions<T, TransformT>, 'transform'>> & InputOptions<T, TransformT>;
 
@@ -6274,7 +6265,7 @@ export declare type InputOptionsWithTransform<T, TransformT> = Required<Pick<Inp
  *
  * @see {@link InputOptionsWithTransform} for inputs with transforms.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface InputSignal<T> extends InputSignalWithTransform<T, T> {
 }
@@ -6322,7 +6313,7 @@ declare interface InputSignalNode<T, TransformT> extends SignalNode<T> {
  *
  * @see {@link InputSignal} for additional information.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface InputSignalWithTransform<T, TransformT> extends Signal<T> {
     [SIGNAL]: InputSignalNode<T, TransformT>;
@@ -7122,6 +7113,7 @@ declare interface LView<T = unknown> extends Array<any> {
      * Effect scheduling operations that need to run during this views's update pass.
      */
     [EFFECTS_TO_SCHEDULE]: Array<() => void> | null;
+    [EFFECTS]: Set<ViewEffectNode> | null;
     /**
      * A collection of callbacks functions that are executed when a given LView is destroyed. Those
      * are user defined, LView-specific destroy callbacks that don't have any corresponding TView
@@ -7145,8 +7137,6 @@ declare interface LViewEnvironment {
     rendererFactory: RendererFactory;
     /** An optional custom sanitizer. */
     sanitizer: Sanitizer | null;
-    /** Container for reactivity system `effect`s. */
-    inlineEffectRunner: ɵEffectScheduler | null;
     /** Scheduler for change detection to notify when application state changes. */
     changeDetectionScheduler: ɵChangeDetectionScheduler | null;
 }
@@ -7318,7 +7308,7 @@ export declare enum MissingTranslationStrategy {
  * }
  * ```
  *
- * @developerPreview
+ * @publicAPI
  * @initializerApiFunction
  */
 export declare const model: ModelFunction;
@@ -7331,7 +7321,7 @@ export declare const model: ModelFunction;
  * The function exposes an API for also declaring required models via the
  * `model.required` function.
  *
- * @developerPreview
+ * @publicAPI
  * @docsPrivate Ignored because `model` is the canonical API entry.
  */
 export declare interface ModelFunction {
@@ -7354,7 +7344,7 @@ export declare interface ModelFunction {
 }
 
 /**
- * @developerPreview
+ * @publicAPI
  *
  * Options for model signals.
  */
@@ -7372,7 +7362,7 @@ export declare interface ModelOptions {
  * A model signal is a writeable signal that can be exposed as an output.
  * Whenever its value is updated, it emits to the output.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface ModelSignal<T> extends WritableSignal<T>, InputSignal<T>, OutputRef<T> {
     [SIGNAL]: InputSignalNode<T, T>;
@@ -8192,9 +8182,8 @@ export declare const Output: OutputDecorator;
  *   this.nameChange.emit(newName);
  * }
  * ```
- *
- * @developerPreview
  * @initializerApiFunction {"showTypesInSignaturePreview": true}
+ * @publicAPI
  */
 export declare function output<T = void>(opts?: OutputOptions): OutputEmitterRef<T>;
 
@@ -8236,7 +8225,7 @@ export declare interface OutputDecorator {
  * <my-comp (valueChange)="processNewValue($event)" />
  * ```
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare class OutputEmitterRef<T> implements OutputRef<T> {
     private destroyed;
@@ -8251,7 +8240,7 @@ export declare class OutputEmitterRef<T> implements OutputRef<T> {
 /**
  * Options for declaring an output.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface OutputOptions {
     alias?: string;
@@ -8260,7 +8249,7 @@ export declare interface OutputOptions {
 /**
  * A reference to an Angular output.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface OutputRef<T> {
     /**
@@ -8281,7 +8270,7 @@ export declare interface OutputRef<T> {
  * Note: Angular will automatically clean up subscriptions
  * when the directive/component of the output is destroyed.
  *
- * @developerPreview
+ * @publicAPI
  */
 export declare interface OutputRefSubscription {
     unsubscribe(): void;
@@ -8297,6 +8286,78 @@ export declare const PACKAGE_ROOT_URL: InjectionToken<string>;
 
 declare const PARENT = 3;
 
+/**
+ * Service that keeps track of pending tasks contributing to the stableness of Angular
+ * application. While several existing Angular services (ex.: `HttpClient`) will internally manage
+ * tasks influencing stability, this API gives control over stability to library and application
+ * developers for specific cases not covered by Angular internals.
+ *
+ * The concept of stability comes into play in several important scenarios:
+ * - SSR process needs to wait for the application stability before serializing and sending rendered
+ * HTML;
+ * - tests might want to delay assertions until the application becomes stable;
+ *
+ * @usageNotes
+ * ```typescript
+ * const pendingTasks = inject(PendingTasks);
+ * const taskCleanup = pendingTasks.add();
+ * // do work that should block application's stability and then:
+ * taskCleanup();
+ * ```
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare class PendingTasks {
+    private internalPendingTasks;
+    private scheduler;
+    /**
+     * Adds a new task that should block application's stability.
+     * @returns A cleanup function that removes a task when called.
+     */
+    add(): () => void;
+    /**
+     * Runs an asynchronous function and blocks the application's stability until the function completes.
+     *
+     * ```
+     * pendingTasks.run(async () => {
+     *   const userData = await fetch('/api/user');
+     *   this.userData.set(userData);
+     * });
+     * ```
+     *
+     * Application stability is at least delayed until the next tick after the `run` method resolves
+     * so it is safe to make additional updates to application state that would require UI synchronization:
+     *
+     * ```
+     * const userData = await pendingTasks.run(() => fetch('/api/user'));
+     * this.userData.set(userData);
+     * ```
+     *
+     * @param fn The asynchronous function to execute
+     */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    /** @nocollapse */
+    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;
+    remove(taskId: number): void;
+    ngOnDestroy(): void;
+    /** @nocollapse */
+    static ɵprov: unknown;
+}
+export { PendingTasksInternal as ɵPendingTasks }
+export { PendingTasksInternal as ɵPendingTasksInternal }
+
 /**
  * Type of the Pipe metadata.
  *
@@ -9010,7 +9071,7 @@ declare interface RDomTokenList {
     remove(token: string): void;
 }
 
-declare const REACTIVE_TEMPLATE_CONSUMER = 23;
+declare const REACTIVE_TEMPLATE_CONSUMER = 24;
 
 declare interface ReactiveLViewConsumer extends ReactiveNode {
     lView: LView | null;
@@ -9460,9 +9521,15 @@ export declare abstract class Sanitizer {
  */
 declare type SanitizerFn = (value: any, tagName?: string, propName?: string) => string | TrustedHTML | TrustedScript | TrustedScriptURL;
 
+
+/**
+ * Abstraction that encompasses any kind of effect that can be scheduled.
+ */
 declare interface SchedulableEffect {
     run(): void;
-    creationZone: unknown;
+    zone: {
+        run<T>(fn: () => T): T;
+    } | null;
 }
 
 
@@ -11647,7 +11714,7 @@ export declare const ViewChild: ViewChildDecorator;
  * }
  * ```
  *
- * @developerPreview
+ * @publicAPI
  * @initializerApiFunction
  */
 export declare const viewChild: ViewChildFunction;
@@ -11729,7 +11796,7 @@ export declare interface ViewChildDecorator {
  * It is a special function that also provides access to required query results via the `.required`
  * property.
  *
- * @developerPreview
+ * @publicAPI
  * @docsPrivate Ignored because `viewChild` is the canonical API entry.
  */
 export declare interface ViewChildFunction {
@@ -11737,7 +11804,7 @@ export declare interface ViewChildFunction {
      * Initializes a view child query. Consider using `viewChild.required` for queries that should
      * always match.
      *
-     * @developerPreview
+     * @publicAPI
      */
     <LocatorT>(locator: ProviderToken<LocatorT> | string): Signal<LocatorT | undefined>;
     <LocatorT, ReadT>(locator: ProviderToken<LocatorT> | string, opts: {
@@ -11746,7 +11813,7 @@ export declare interface ViewChildFunction {
     /**
      * Initializes a view child query that is expected to always match an element.
      *
-     * @developerPreview
+     * @publicAPI
      */
     required: {
         <LocatorT>(locator: ProviderToken<LocatorT> | string): Signal<LocatorT>;
@@ -12044,6 +12111,10 @@ export declare abstract class ViewContainerRef {
     abstract detach(index?: number): ViewRef | null;
 }
 
+declare interface ViewEffectNode extends EffectNode {
+    view: LView;
+}
+
 
 /**
  * Defines the CSS styles encapsulation policies for the {@link Component} decorator's
@@ -12150,6 +12221,27 @@ export declare interface WritableSignal<T> extends Signal<T> {
     asReadonly(): Signal<T>;
 }
 
+/**
+ * A wrapper around `ZoneAwareQueueingScheduler` that schedules flushing via the microtask queue
+ * when.
+ */
+declare class ZoneAwareEffectScheduler implements ɵEffectScheduler {
+    private queuedEffectCount;
+    private queues;
+    private readonly pendingTasks;
+    protected taskId: number | null;
+    schedule(handle: SchedulableEffect): void;
+    private enqueue;
+    /**
+     * Run all scheduled effects.
+     *
+     * Execution order of effects within the same zone is guaranteed to be FIFO, but there is no
+     * ordering guarantee between effects scheduled in different zones.
+     */
+    flush(): void;
+    private flushQueue;
+}
+
 /**
  * Sanitizes the given unsafe, untrusted HTML fragment, and returns HTML text that is safe to add to
  * the DOM in a browser environment.
@@ -12932,7 +13024,7 @@ export declare abstract class ɵEffectScheduler {
      *
      * It is an error to attempt to execute any effects synchronously during a scheduling operation.
      */
-    abstract scheduleEffect(e: SchedulableEffect): void;
+    abstract schedule(e: SchedulableEffect): void;
     /**
      * Run any scheduled effects.
      */
@@ -13365,6 +13457,17 @@ export declare enum ɵLocaleDataIndex {
     ExtraData = 21
 }
 
+/**
+ * Create a global `Effect` for the given reactive function.
+ */
+export declare function ɵmicrotaskEffect(effectFn: (onCleanup: EffectCleanupRegisterFn) => void, options?: CreateEffectOptions): EffectRef;
+
+export declare class ɵMicrotaskEffectScheduler extends ZoneAwareEffectScheduler {
+    schedule(effect: SchedulableEffect): void;
+    /** @nocollapse */
+    static ɵprov: unknown;
+}
+
 
 export declare const ɵNG_COMP_DEF: string;
 
@@ -13510,7 +13613,8 @@ export declare const enum ɵNotificationSource {
     ViewAttached = 9,
     ViewDetachedFromDOM = 10,
     AsyncAnimationsLoaded = 11,
-    PendingTaskRemoved = 12
+    PendingTaskRemoved = 12,
+    RootEffect = 13
 }
 
 /**
@@ -13519,21 +13623,6 @@ 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 ɵPendingTasks implements OnDestroy {
-    private taskId;
-    private pendingTasks;
-    private get _hasPendingTasks();
-    hasPendingTasks: BehaviorSubject<boolean>;
-    add(): number;
-    remove(taskId: number): void;
-    ngOnDestroy(): void;
-    /** @nocollapse */
-    static ɵprov: unknown;
-}
-
 
 /**
  * A guarded `performance.mark` for feature marking.
@@ -15229,6 +15318,22 @@ export declare function ɵɵdefer(index: number, primaryTmplIndex: number, depen
  */
 export declare function ɵɵdeferEnableTimerScheduling(tView: TView, tDetails: TDeferBlockDetails, placeholderConfigIndex?: number | null, loadingConfigIndex?: number | null): void;
 
+export declare function ɵɵdeferHydrateNever(): void;
+
+export declare function ɵɵdeferHydrateOnHover(): void;
+
+export declare function ɵɵdeferHydrateOnIdle(): void;
+
+export declare function ɵɵdeferHydrateOnImmediate(): void;
+
+export declare function ɵɵdeferHydrateOnInteraction(): void;
+
+export declare function ɵɵdeferHydrateOnTimer(): void;
+
+export declare function ɵɵdeferHydrateOnViewport(): void;
+
+export declare function ɵɵdeferHydrateWhen(): void;
+
 /**
  * Creates runtime data structures for the `on hover` deferred trigger.
  * @param triggerIndex Index at which to find the trigger element.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "19.0.0-next.5",
+  "version": "19.0.0-next.7",
   "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.5
+ * @license Angular v19.0.0-next.7
  * (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.5
+ * @license Angular v19.0.0-next.7
  * (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.5
+ * @license Angular v19.0.0-next.7
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -164,4 +164,6 @@ export declare interface ToSignalOptions<T> {
     equal?: ValueEqualityFn<T>;
 }
 
+export declare function ɵtoObservableMicrotask<T>(source: Signal<T>, options?: ToObservableOptions): Observable<T>;
+
 export { }