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

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.1.0-next.2
+ * @license Angular v19.1.0-next.4
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -2962,6 +2962,31 @@ export declare class DebugNode {
     get providerTokens(): any[];
 }
 
+/**
+ * A debug representation of the signal graph.
+ */
+declare interface DebugSignalGraph {
+    nodes: DebugSignalGraphNode[];
+    edges: DebugSignalGraphEdge[];
+}
+
+declare interface DebugSignalGraphEdge {
+    /**
+     * Index of a signal node in the `nodes` array that is a consumer of the signal produced by the producer node.
+     */
+    consumer: number;
+    /**
+     * Index of a signal node in the `nodes` array that is a producer of the signal consumed by the consumer node.
+     */
+    producer: number;
+}
+
+declare interface DebugSignalGraphNode {
+    kind: string;
+    label?: string;
+    value?: unknown;
+}
+
 declare const DECLARATION_COMPONENT_VIEW = 15;
 
 declare const DECLARATION_LCONTAINER = 16;
@@ -3048,6 +3073,36 @@ declare const DEFER_BLOCK_ID = "di";
 
 declare const DEFER_BLOCK_STATE = "s";
 
+/** Retrieved information about a `@defer` block. */
+declare interface DeferBlockData {
+    /** Current state of the block. */
+    state: 'placeholder' | 'loading' | 'complete' | 'error' | 'initial';
+    /** Hydration state of the block. */
+    incrementalHydrationState: 'not-configured' | 'hydrated' | 'dehydrated';
+    /** Wherther the block has a connected `@error` block. */
+    hasErrorBlock: boolean;
+    /** Information about the connected `@loading` block. */
+    loadingBlock: {
+        /** Whether the block is defined. */
+        exists: boolean;
+        /** Minimum amount of milliseconds that the block should be shown. */
+        minimumTime: number | null;
+        /** Amount of time after which the block should be shown. */
+        afterTime: number | null;
+    };
+    /** Information about the connected `@placeholder` block. */
+    placeholderBlock: {
+        /** Whether the block is defined. */
+        exists: boolean;
+        /** Minimum amount of time that block should be shown. */
+        minimumTime: number | null;
+    };
+    /** Stringified version of the block's triggers. */
+    triggers: string[];
+    /** Element root nodes that are currently being shown in the block. */
+    rootNodes: Node[];
+}
+
 /**
  * Represents defer trigger types.
  */
@@ -4584,6 +4639,14 @@ declare function getDebugNode(nativeNode: any): DebugNode | null;
 export { getDebugNode }
 export { getDebugNode as ɵgetDebugNode }
 
+/**
+ * Gets all of the `@defer` blocks that are present inside the specified DOM node.
+ * @param node Node in which to look for `@defer` blocks.
+ *
+ * @publicApi
+ */
+declare function getDeferBlocks(node: Node): DeferBlockData[];
+
 /**
  * Discovers the dependencies of an injectable instance. Provides DI information about each
  * dependency that the injectable was instantiated with, including where they were provided from.
@@ -4742,6 +4805,18 @@ export declare function getPlatform(): PlatformRef | null;
  */
 declare function getRootComponents(elementOrDir: Element | {}): {}[];
 
+/**
+ * Returns a debug representation of the signal graph for the given injector.
+ *
+ * Currently only supports element injectors. Starts by discovering the consumer nodes
+ * and then traverses their producer nodes to build the signal graph.
+ *
+ * @param injector The injector to get the signal graph for.
+ * @returns A debug representation of the signal graph.
+ * @throws If the injector is an environment injector.
+ */
+declare function getSignalGraph(injector: Injector): DebugSignalGraph;
+
 /**
  * Adapter interface for retrieving the `Testability` service associated for a
  * particular context.
@@ -4782,6 +4857,8 @@ declare const globalUtilsFunctions: {
     ɵgetInjectorResolutionPath: typeof getInjectorResolutionPath;
     ɵgetInjectorMetadata: typeof getInjectorMetadata;
     ɵsetProfiler: (profiler: ɵProfiler_2 | null) => void;
+    ɵgetSignalGraph: typeof getSignalGraph;
+    ɵgetDeferBlocks: typeof getDeferBlocks;
     getDirectiveMetadata: typeof getDirectiveMetadata;
     getComponent: typeof getComponent;
     getContext: typeof getContext;
@@ -6845,6 +6922,16 @@ declare interface Listener {
     type: 'dom' | 'output';
 }
 
+/**
+ * Options that can be used to configure an event listener.
+ * @publicApi
+ */
+export declare interface ListenerOptions {
+    capture?: boolean;
+    once?: boolean;
+    passive?: boolean;
+}
+
 /**
  * Provide this token to set the locale of your application.
  * It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
@@ -7903,7 +7990,7 @@ export declare class NgZone {
      * Executes the `fn` function synchronously within the Angular zone as a task and returns value
      * returned by the function.
      *
-     * Running functions via `run` allows you to reenter Angular zone from a task that was executed
+     * Running functions via `runTask` allows you to reenter Angular zone from a task that was executed
      * outside of the Angular zone (typically started via {@link #runOutsideAngular}).
      *
      * Any future tasks or microtasks scheduled from within this function will continue executing from
@@ -8408,24 +8495,6 @@ export declare class PendingTasks {
     static ɵprov: unknown;
 }
 
-/**
- * Internal implementation of the pending tasks service.
- */
-declare class PendingTasksInternal implements OnDestroy {
-    private taskId;
-    private pendingTasks;
-    private get _hasPendingTasks();
-    hasPendingTasks: BehaviorSubject<boolean>;
-    add(): number;
-    has(taskId: number): boolean;
-    remove(taskId: number): void;
-    ngOnDestroy(): void;
-    /** @nocollapse */
-    static ɵprov: unknown;
-}
-export { PendingTasksInternal as ɵPendingTasks }
-export { PendingTasksInternal as ɵPendingTasksInternal }
-
 /**
  * Type of the Pipe metadata.
  *
@@ -9332,7 +9401,7 @@ declare interface Renderer {
     removeStyle(el: RElement, style: string, flags?: RendererStyleFlags2): void;
     setProperty(el: RElement, name: string, value: any): void;
     setValue(node: RText | RComment, value: string): void;
-    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void): () => void;
+    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void, options?: ListenerOptions): () => void;
 }
 
 /**
@@ -9504,9 +9573,10 @@ export declare abstract class Renderer2 {
      * DOM element.
      * @param eventName The event to listen for.
      * @param callback A handler function to invoke when the event occurs.
+     * @param options Options that configure how the event listener is bound.
      * @returns An "unlisten" function for disposing of this handler.
      */
-    abstract listen(target: 'window' | 'document' | 'body' | any, eventName: string, callback: (event: any) => boolean | void): () => void;
+    abstract listen(target: 'window' | 'document' | 'body' | any, eventName: string, callback: (event: any) => boolean | void, options?: ListenerOptions): () => void;
 }
 
 declare interface RendererFactory {
@@ -10449,16 +10519,19 @@ declare interface TDeferBlockDetails {
      * List of hydrate triggers for a given block
      */
     hydrateTriggers: Map<DeferBlockTrigger, HydrateTriggerDetails | null> | null;
-    /**
-     * 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;
+    /**
+     * Tracks debugging information about the deferred block.
+     */
+    debug: {
+        /** Text representations of the block's triggers. */
+        triggers?: Set<string>;
+    } | null;
 }
 
 /**
@@ -13474,6 +13547,28 @@ export declare abstract class ɵEffectScheduler {
     static ɵprov: unknown;
 }
 
+/**
+ * InjectionToken to control root component bootstrap behavior.
+ *
+ * This token is primarily used in Angular's server-side rendering (SSR) scenarios,
+ * particularly by the `@angular/ssr` package, to manage whether the root component
+ * should be bootstrapped during the application initialization process.
+ *
+ * ## Purpose:
+ * During SSR route extraction, setting this token to `false` prevents Angular from
+ * bootstrapping the root component. This avoids unnecessary component rendering,
+ * enabling route extraction without requiring additional APIs or triggering
+ * component logic.
+ *
+ * ## Behavior:
+ * - **`false`**: Prevents the root component from being bootstrapped.
+ * - **`true`** (default): Proceeds with the normal root component bootstrap process.
+ *
+ * This mechanism ensures SSR can efficiently separate route extraction logic
+ * from component rendering.
+ */
+export declare const ɵENABLE_ROOT_COMPONENT_BOOTSTRAP: InjectionToken<boolean>;
+
 /**
  * This enables an internal performance profiler
  *
@@ -14110,6 +14205,22 @@ export declare const enum ɵNotificationSource {
  */
 export declare function ɵpatchComponentDefWithScope<C>(componentDef: ɵComponentDef<C>, transitiveScopes: ɵNgModuleTransitiveScopes): void;
 
+/**
+ * Internal implementation of the pending tasks service.
+ */
+export declare class ɵPendingTasksInternal implements OnDestroy {
+    private taskId;
+    private pendingTasks;
+    private get _hasPendingTasks();
+    hasPendingTasks: BehaviorSubject<boolean>;
+    add(): number;
+    has(taskId: number): boolean;
+    remove(taskId: number): void;
+    ngOnDestroy(): void;
+    /** @nocollapse */
+    static ɵprov: unknown;
+}
+
 
 export declare const ɵPERFORMANCE_MARK_PREFIX = "\uD83C\uDD70\uFE0F";
 
@@ -14214,7 +14325,81 @@ export declare const enum ɵProfilerEvent {
      * Corresponds to the point in time after the runtime has evaluated an expression associated with
      * an event or an output.
      */
-    OutputEnd = 7
+    OutputEnd = 7,
+    /**
+     * Corresponds to the point in time just before application bootstrap.
+     */
+    BootstrapApplicationStart = 8,
+    /**
+     * Corresponds to the point in time after application bootstrap.
+     */
+    BootstrapApplicationEnd = 9,
+    /**
+     * Corresponds to the point in time just before root component bootstrap.
+     */
+    BootstrapComponentStart = 10,
+    /**
+     * Corresponds to the point in time after root component bootstrap.
+     */
+    BootstrapComponentEnd = 11,
+    /**
+     * Corresponds to the point in time just before Angular starts a change detection tick.
+     */
+    ChangeDetectionStart = 12,
+    /**
+     * Corresponds to the point in time after Angular ended a change detection tick.
+     */
+    ChangeDetectionEnd = 13,
+    /**
+     * Corresponds to the point in time just before Angular starts a new synchronization pass of change detection tick.
+     */
+    ChangeDetectionSyncStart = 14,
+    /**
+     * Corresponds to the point in time after Angular ended a synchronization pass.
+     */
+    ChangeDetectionSyncEnd = 15,
+    /**
+     * Corresponds to the point in time just before Angular executes after render hooks.
+     */
+    AfterRenderHooksStart = 16,
+    /**
+     * Corresponds to the point in time after Angular executed after render hooks.
+     */
+    AfterRenderHooksEnd = 17,
+    /**
+     * Corresponds to the point in time just before Angular starts processing a component (create or update).
+     */
+    ComponentStart = 18,
+    /**
+     * Corresponds to the point in time after Angular finished processing a component.
+     */
+    ComponentEnd = 19,
+    /**
+     * Corresponds to the point in time just before a defer block transitions between states.
+     */
+    DeferBlockStateStart = 20,
+    /**
+     * Corresponds to the point in time after a defer block transitioned between states.
+     */
+    DeferBlockStateEnd = 21,
+    /**
+     * Corresponds to the point in time just before a component instance is created dynamically.
+     */
+    DynamicComponentStart = 22,
+    /**
+     * Corresponds to the point in time after a a component instance is created dynamically.
+     */
+    DynamicComponentEnd = 23,
+    /**
+     * Corresponds to the point in time before the runtime has called the host bindings function
+     * of a directive.
+     */
+    HostBindingsUpdateStart = 24,
+    /**
+     * Corresponds to the point in time after the runtime has called the host bindings function
+     * of a directive.
+     */
+    HostBindingsUpdateEnd = 25
 }
 
 /**
@@ -14737,6 +14922,14 @@ export declare interface ɵTracingService<T extends ɵTracingSnapshot> {
      * snapshot.
      */
     snapshot(linkedSnapshot: T | null): T;
+    /**
+     * Wrap an event listener bound by the framework for tracing.
+     * @param element Element on which the event is bound.
+     * @param eventName Name of the event.
+     * @param handler Event handler.
+     * @return A new event handler to be bound instead of the original one.
+     */
+    wrapEventListener?<T extends Function>(element: HTMLElement, eventName: string, handler: T): T;
 }
 
 /** A single tracing snapshot. */
@@ -15128,6 +15321,18 @@ export declare const ɵZONELESS_ENABLED: InjectionToken<boolean>;
  */
 export declare function ɵɵadvance(delta?: number): void;
 
+/**
+ * Sets the location within the source template at which
+ * each element in the current view was defined.
+ *
+ * @param index Index at which the DOM node was created.
+ * @param templatePath Path to the template at which the node was defined.
+ * @param locations Element locations to which to attach the source location.
+ *
+ * @codeGenApi
+ */
+export declare function ɵɵattachSourceLocations(templatePath: string, locations: [index: number, offset: number, line: number, column: number][]): void;
+
 /**
  * Updates the value of or removes a bound attribute on an Element.
  *

package/package.json

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