@angular/platform-browser 22.0.0-next.1 → 22.0.0-next.11

package/types/platform-browser.d.ts

@@ -1,12 +1,12 @@
 /**
- * @license Angular v22.0.0-next.1
+ * @license Angular v22.0.0-next.11
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
 export { BootstrapContext, BrowserModule, bootstrapApplication, createApplication, platformBrowser, provideProtractorTestingSupport } from './_browser-chunk.js';
 import * as i0 from '@angular/core';
-import { ComponentRef, Predicate, DebugNode, DebugElement, Type, ListenerOptions, InjectionToken, NgZone, OnDestroy, RendererFactory2, ɵTracingService as _TracingService, ɵTracingSnapshot as _TracingSnapshot, RendererType2, Renderer2, Injector, Sanitizer, SecurityContext, Provider, EnvironmentProviders, GetTestability, TestabilityRegistry, Testability, Version } from '@angular/core';
+import { ComponentRef, Predicate, DebugNode, DebugElement, Type, ListenerOptions, InjectionToken, NgZone, ɵSharedStylesHost as _SharedStylesHost, OnDestroy, RendererFactory2, ɵTracingService as _TracingService, ɵTracingSnapshot as _TracingSnapshot, RendererType2, Renderer2, Provider, EnvironmentProviders, Sanitizer, SecurityContext, GetTestability, TestabilityRegistry, Testability, Version } from '@angular/core';
 import { HttpTransferCacheOptions } from '@angular/common/http';
 import { ɵDomAdapter as _DomAdapter } from '@angular/common';
 export { ɵgetDOM } from '@angular/common';
@@ -278,7 +278,7 @@ interface UsageRecord<T> {
     elements: T[];
     usage: number;
 }
-declare class SharedStylesHost implements OnDestroy {
+declare class SharedStylesHost implements _SharedStylesHost, OnDestroy {
     private readonly doc;
     private readonly appId;
     private readonly nonce?;
@@ -297,10 +297,6 @@ declare class SharedStylesHost implements OnDestroy {
      */
     private readonly hosts;
     constructor(doc: Document, appId: string, nonce?: string | null | undefined, platformId?: object);
-    /**
-     * Adds embedded styles to the DOM via HTML `style` elements.
-     * @param styles An array of style content strings.
-     */
     addStyles(styles: string[], urls?: string[]): void;
     /**
      * Removes embedded styles from the DOM that were added as HTML `style` elements.
@@ -310,12 +306,6 @@ declare class SharedStylesHost implements OnDestroy {
     protected addUsage<T extends HTMLElement>(value: string, usages: Map<string, UsageRecord<T>>, creator: (value: string, doc: Document) => T): void;
     protected removeUsage<T extends HTMLElement>(value: string, usages: Map<string, UsageRecord<T>>): void;
     ngOnDestroy(): void;
-    /**
-     * Adds a host node to the set of style hosts and adds all existing style usage to
-     * the newly added host node.
-     *
-     * This is currently only used for Shadow DOM encapsulation mode.
-     */
     addHost(hostNode: Node): void;
     removeHost(hostNode: Node): void;
     private addElement;
@@ -356,133 +346,151 @@ declare class DomRendererFactory2 implements RendererFactory2, OnDestroy {
 }
 
 /**
- * DI token for providing [HammerJS](https://hammerjs.github.io/) support to Angular.
- * @see {@link HammerGestureConfig}
+ * The list of features as an enum to uniquely type each `HydrationFeature`.
+ * @see {@link HydrationFeature}
  *
- * @ngModule HammerModule
  * @publicApi
- *
- * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
  */
-declare const HAMMER_GESTURE_CONFIG: InjectionToken<HammerGestureConfig>;
+declare enum HydrationFeatureKind {
+    NoHttpTransferCache = 0,
+    HttpTransferCacheOptions = 1,
+    I18nSupport = 2,
+    EventReplay = 3,
+    IncrementalHydration = 4,
+    NoIncrementalHydration = 5
+}
 /**
- * Function that loads HammerJS, returning a promise that is resolved once HammerJs is loaded.
+ * Helper type to represent a Hydration feature.
  *
  * @publicApi
+ */
+interface HydrationFeature<FeatureKind extends HydrationFeatureKind> {
+    ɵkind: FeatureKind;
+    ɵproviders: Provider[];
+}
+/**
+ * Disables HTTP transfer cache. Effectively causes HTTP requests to be performed twice: once on the
+ * server and other one on the browser.
  *
- * @deprecated The hammerjs integration is deprecated. Replace it by your own implementation.
+ * @see [Disabling Caching](guide/ssr#disabling-caching)
+ *
+ * @publicApi
  */
-type HammerLoader = () => Promise<void>;
+declare function withNoHttpTransferCache(): HydrationFeature<HydrationFeatureKind.NoHttpTransferCache>;
 /**
- * Injection token used to provide a HammerLoader to Angular.
+ * The function accepts an object, which allows to configure cache parameters,
+ * such as which headers should be included (no headers are included by default),
+ * whether POST requests should be cached or a callback function to determine if a
+ * particular request should be cached.
  *
- * @see {@link HammerLoader}
+ * @see [Configuring HTTP transfer cache options](guide/ssr#caching-data-when-using-httpclient)
  *
  * @publicApi
+ */
+declare function withHttpTransferCacheOptions(options: HttpTransferCacheOptions): HydrationFeature<HydrationFeatureKind.HttpTransferCacheOptions>;
+/**
+ * Enables support for hydrating i18n blocks.
  *
- * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
+ * @publicApi 20.0
  */
-declare const HAMMER_LOADER: InjectionToken<HammerLoader>;
-interface HammerInstance {
-    on(eventName: string, callback?: Function): void;
-    off(eventName: string, callback?: Function): void;
-    destroy?(): void;
-}
+declare function withI18nSupport(): HydrationFeature<HydrationFeatureKind.I18nSupport>;
 /**
- * An injectable [HammerJS Manager](https://hammerjs.github.io/api/#hammermanager)
- * for gesture recognition. Configures specific event recognition.
+ * Enables support for replaying user events (e.g. `click`s) that happened on a page
+ * before hydration logic has completed. Once an application is hydrated, all captured
+ * events are replayed and relevant event listeners are executed.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can enable event replay in your application when
+ * `bootstrapApplication` function is used:
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideClientHydration(withEventReplay())]
+ * });
+ * ```
  * @publicApi
+ * @see {@link provideClientHydration}
+ */
+declare function withEventReplay(): HydrationFeature<HydrationFeatureKind.EventReplay>;
+/**
+ * Enables support for incremental hydration using the `hydrate` trigger syntax.
+ *
+ * @usageNotes
  *
- * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
+ * Basic example of how you can enable incremental hydration in your application when
+ * the `bootstrapApplication` function is used:
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideClientHydration(withIncrementalHydration())]
+ * });
+ * ```
+ * @publicApi 20.0
+ * @see {@link provideClientHydration}
+ *
+ * @deprecated Since v22.0.0, incremental hydration is enabled by default with `provideClientHydration`.
+ * Intent to remove in v24.
  */
-declare class HammerGestureConfig {
-    /**
-     * A set of supported event names for gestures to be used in Angular.
-     * Angular supports all built-in recognizers, as listed in
-     * [HammerJS documentation](https://hammerjs.github.io/).
-     */
-    events: string[];
-    /**
-     * Maps gesture event names to a set of configuration options
-     * that specify overrides to the default values for specific properties.
-     *
-     * The key is a supported event name to be configured,
-     * and the options object contains a set of properties, with override values
-     * to be applied to the named recognizer event.
-     * For example, to disable recognition of the rotate event, specify
-     *  `{"rotate": {"enable": false}}`.
-     *
-     * Properties that are not present take the HammerJS default values.
-     * For information about which properties are supported for which events,
-     * and their allowed and default values, see
-     * [HammerJS documentation](https://hammerjs.github.io/).
-     *
-     */
-    overrides: {
-        [key: string]: Object;
-    };
-    /**
-     * Properties whose default values can be overridden for a given event.
-     * Different sets of properties apply to different events.
-     * For information about which properties are supported for which events,
-     * and their allowed and default values, see
-     * [HammerJS documentation](https://hammerjs.github.io/).
-     */
-    options?: {
-        cssProps?: any;
-        domEvents?: boolean;
-        enable?: boolean | ((manager: any) => boolean);
-        preset?: any[];
-        touchAction?: string;
-        recognizers?: any[];
-        inputClass?: any;
-        inputTarget?: EventTarget;
-    };
-    /**
-     * Creates a [HammerJS Manager](https://hammerjs.github.io/api/#hammermanager)
-     * and attaches it to a given HTML element.
-     * @param element The element that will recognize gestures.
-     * @returns A HammerJS event-manager object.
-     */
-    buildHammer(element: HTMLElement): HammerInstance;
-    static ɵfac: i0.ɵɵFactoryDeclaration<HammerGestureConfig, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<HammerGestureConfig>;
-}
+declare function withIncrementalHydration(): HydrationFeature<HydrationFeatureKind.IncrementalHydration>;
 /**
- * Event plugin that adds Hammer support to an application.
+ * Disables support for incremental hydration (which is enabled by default).
  *
- * @ngModule HammerModule
+ * @publicApi 22.0
+ * @see {@link provideClientHydration}
  */
-declare class HammerGesturesPlugin extends EventManagerPlugin {
-    private _config;
-    private _injector;
-    private loader?;
-    private _loaderPromise;
-    constructor(doc: any, _config: HammerGestureConfig, _injector: Injector, loader?: (HammerLoader | null) | undefined);
-    supports(eventName: string): boolean;
-    addEventListener(element: HTMLElement, eventName: string, handler: Function): Function;
-    isCustomEvent(eventName: string): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<HammerGesturesPlugin, [null, null, null, { optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<HammerGesturesPlugin>;
-}
+declare function withNoIncrementalHydration(): HydrationFeature<HydrationFeatureKind.NoIncrementalHydration>;
 /**
- * Adds support for HammerJS.
+ * Sets up providers necessary to enable hydration functionality for the application.
  *
- * Import this module at the root of your application so that Angular can work with
- * HammerJS to detect gesture events.
+ * By default, the function enables the recommended set of features for the optimal
+ * performance for most of the applications. It includes the following features:
  *
- * Note that applications still need to include the HammerJS script itself. This module
- * simply sets up the coordination layer between HammerJS and Angular's `EventManager`.
+ * * Reconciling DOM hydration. Learn more about it [here](guide/hydration).
+ * * [`HttpClient`](api/common/http/HttpClient) response caching while running on the server and
+ * transferring this cache to the client to avoid extra HTTP requests. Learn more about data caching
+ * [here](guide/ssr#caching-data-when-using-httpclient).
+ * Incremental hydration. [Learn more](guide/incremental-hydration).
  *
- * @publicApi
+ * These functions allow you to disable some of the default features or enable new ones:
+ *
+ * * {@link withNoHttpTransferCache} to disable HTTP transfer cache
+ * * {@link withHttpTransferCacheOptions} to configure some HTTP transfer cache options
+ * * {@link withI18nSupport} to enable hydration support for i18n blocks
+ * * {@link withEventReplay} to enable support for replaying user events
+ * * {@link withNoIncrementalHydration} to disable incremental hydration
+ *
+ * @usageNotes
  *
- * @deprecated The hammer integration is deprecated. Replace it by your own implementation.
+ * Basic example of how you can enable hydration in your application when
+ * `bootstrapApplication` function is used:
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideClientHydration()]
+ * });
+ * ```
+ *
+ * Alternatively if you are using NgModules, you would add `provideClientHydration`
+ * to your root app module's provider list.
+ * ```ts
+ * @NgModule({
+ *   declarations: [RootCmp],
+ *   bootstrap: [RootCmp],
+ *   providers: [provideClientHydration()],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @see {@link withNoHttpTransferCache}
+ * @see {@link withHttpTransferCacheOptions}
+ * @see {@link withI18nSupport}
+ * @see {@link withEventReplay}
+ * @see {@link withNoIncrementalHydration}
+ *
+ * @param features Optional features to configure additional hydration behaviors.
+ * @returns A set of providers to enable hydration.
+ *
+ * @publicApi 17.0
  */
-declare class HammerModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<HammerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<HammerModule, never, never, never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<HammerModule>;
-}
+declare function provideClientHydration(...features: HydrationFeature<HydrationFeatureKind>[]): EnvironmentProviders;
 
 /**
  * Marker interface for a value that's safe to use in a particular context.
@@ -623,139 +631,6 @@ declare class DomSanitizerImpl extends DomSanitizer {
     static ɵprov: i0.ɵɵInjectableDeclaration<DomSanitizerImpl>;
 }
 
-/**
- * The list of features as an enum to uniquely type each `HydrationFeature`.
- * @see {@link HydrationFeature}
- *
- * @publicApi
- */
-declare enum HydrationFeatureKind {
-    NoHttpTransferCache = 0,
-    HttpTransferCacheOptions = 1,
-    I18nSupport = 2,
-    EventReplay = 3,
-    IncrementalHydration = 4
-}
-/**
- * Helper type to represent a Hydration feature.
- *
- * @publicApi
- */
-interface HydrationFeature<FeatureKind extends HydrationFeatureKind> {
-    ɵkind: FeatureKind;
-    ɵproviders: Provider[];
-}
-/**
- * Disables HTTP transfer cache. Effectively causes HTTP requests to be performed twice: once on the
- * server and other one on the browser.
- *
- * @see [Disabling Caching](guide/ssr#disabling-caching)
- *
- * @publicApi
- */
-declare function withNoHttpTransferCache(): HydrationFeature<HydrationFeatureKind.NoHttpTransferCache>;
-/**
- * The function accepts an object, which allows to configure cache parameters,
- * such as which headers should be included (no headers are included by default),
- * whether POST requests should be cached or a callback function to determine if a
- * particular request should be cached.
- *
- * @see [Configuring HTTP transfer cache options](guide/ssr#caching-data-when-using-httpclient)
- *
- * @publicApi
- */
-declare function withHttpTransferCacheOptions(options: HttpTransferCacheOptions): HydrationFeature<HydrationFeatureKind.HttpTransferCacheOptions>;
-/**
- * Enables support for hydrating i18n blocks.
- *
- * @publicApi 20.0
- */
-declare function withI18nSupport(): HydrationFeature<HydrationFeatureKind.I18nSupport>;
-/**
- * Enables support for replaying user events (e.g. `click`s) that happened on a page
- * before hydration logic has completed. Once an application is hydrated, all captured
- * events are replayed and relevant event listeners are executed.
- *
- * @usageNotes
- *
- * Basic example of how you can enable event replay in your application when
- * `bootstrapApplication` function is used:
- * ```ts
- * bootstrapApplication(AppComponent, {
- *   providers: [provideClientHydration(withEventReplay())]
- * });
- * ```
- * @publicApi
- * @see {@link provideClientHydration}
- */
-declare function withEventReplay(): HydrationFeature<HydrationFeatureKind.EventReplay>;
-/**
- * Enables support for incremental hydration using the `hydrate` trigger syntax.
- *
- * @usageNotes
- *
- * Basic example of how you can enable incremental hydration in your application when
- * the `bootstrapApplication` function is used:
- * ```ts
- * bootstrapApplication(AppComponent, {
- *   providers: [provideClientHydration(withIncrementalHydration())]
- * });
- * ```
- * @publicApi 20.0
- * @see {@link provideClientHydration}
- */
-declare function withIncrementalHydration(): HydrationFeature<HydrationFeatureKind.IncrementalHydration>;
-/**
- * Sets up providers necessary to enable hydration functionality for the application.
- *
- * By default, the function enables the recommended set of features for the optimal
- * performance for most of the applications. It includes the following features:
- *
- * * Reconciling DOM hydration. Learn more about it [here](guide/hydration).
- * * [`HttpClient`](api/common/http/HttpClient) response caching while running on the server and
- * transferring this cache to the client to avoid extra HTTP requests. Learn more about data caching
- * [here](guide/ssr#caching-data-when-using-httpclient).
- *
- * These functions allow you to disable some of the default features or enable new ones:
- *
- * * {@link withNoHttpTransferCache} to disable HTTP transfer cache
- * * {@link withHttpTransferCacheOptions} to configure some HTTP transfer cache options
- * * {@link withI18nSupport} to enable hydration support for i18n blocks
- * * {@link withEventReplay} to enable support for replaying user events
- *
- * @usageNotes
- *
- * Basic example of how you can enable hydration in your application when
- * `bootstrapApplication` function is used:
- * ```ts
- * bootstrapApplication(AppComponent, {
- *   providers: [provideClientHydration()]
- * });
- * ```
- *
- * Alternatively if you are using NgModules, you would add `provideClientHydration`
- * to your root app module's provider list.
- * ```ts
- * @NgModule({
- *   declarations: [RootCmp],
- *   bootstrap: [RootCmp],
- *   providers: [provideClientHydration()],
- * })
- * export class AppModule {}
- * ```
- *
- * @see {@link withNoHttpTransferCache}
- * @see {@link withHttpTransferCacheOptions}
- * @see {@link withI18nSupport}
- * @see {@link withEventReplay}
- *
- * @param features Optional features to configure additional hydration behaviors.
- * @returns A set of providers to enable hydration.
- *
- * @publicApi 17.0
- */
-declare function provideClientHydration(...features: HydrationFeature<HydrationFeatureKind>[]): EnvironmentProviders;
-
 /**
  * A `DomAdapter` powered by full browser DOM APIs.
  *
@@ -885,5 +760,5 @@ declare const enum RuntimeErrorCode {
  */
 declare const VERSION: Version;
 
-export { By, DomSanitizer, EVENT_MANAGER_PLUGINS, EventManager, EventManagerPlugin, HAMMER_GESTURE_CONFIG, HAMMER_LOADER, HammerGestureConfig, HammerModule, HydrationFeatureKind, Meta, REMOVE_STYLES_ON_COMPONENT_DESTROY, Title, VERSION, disableDebugTools, enableDebugTools, provideClientHydration, withEventReplay, withHttpTransferCacheOptions, withI18nSupport, withIncrementalHydration, withNoHttpTransferCache, BrowserDomAdapter as ɵBrowserDomAdapter, BrowserGetTestability as ɵBrowserGetTestability, DomEventsPlugin as ɵDomEventsPlugin, DomRendererFactory2 as ɵDomRendererFactory2, DomSanitizerImpl as ɵDomSanitizerImpl, HammerGesturesPlugin as ɵHammerGesturesPlugin, KeyEventsPlugin as ɵKeyEventsPlugin, RuntimeErrorCode as ɵRuntimeErrorCode, SharedStylesHost as ɵSharedStylesHost };
-export type { HammerLoader, HydrationFeature, MetaDefinition, SafeHtml, SafeResourceUrl, SafeScript, SafeStyle, SafeUrl, SafeValue };
+export { By, DomSanitizer, EVENT_MANAGER_PLUGINS, EventManager, EventManagerPlugin, HydrationFeatureKind, Meta, REMOVE_STYLES_ON_COMPONENT_DESTROY, Title, VERSION, disableDebugTools, enableDebugTools, provideClientHydration, withEventReplay, withHttpTransferCacheOptions, withI18nSupport, withIncrementalHydration, withNoHttpTransferCache, withNoIncrementalHydration, BrowserDomAdapter as ɵBrowserDomAdapter, BrowserGetTestability as ɵBrowserGetTestability, DomEventsPlugin as ɵDomEventsPlugin, DomRendererFactory2 as ɵDomRendererFactory2, DomSanitizerImpl as ɵDomSanitizerImpl, KeyEventsPlugin as ɵKeyEventsPlugin, RuntimeErrorCode as ɵRuntimeErrorCode, SharedStylesHost as ɵSharedStylesHost };
+export type { HydrationFeature, MetaDefinition, SafeHtml, SafeResourceUrl, SafeScript, SafeStyle, SafeUrl, SafeValue };

package/types/testing.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v22.0.0-next.1
+ * @license Angular v22.0.0-next.11
  * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */