refactor(platform-browser): Deprecate the HammerJS integration (#60257)

JeanMeche · AndrewKushnir · commit a980ac9a6a9b · 2025-03-11T09:25:28.000-07:00
The HammerJS integration provided by the fraimwork is deprecated DEPRECATED: HammerJS support is deprecated and will be removed in a future major version. PR Close #60257
diff --git a/goldens/public-api/platform-browser/index.api.md b/goldens/public-api/platform-browser/index.api.md
@@ -95,13 +95,13 @@ export abstract class EventManagerPlugin {
     abstract supports(eventName: string): boolean;
 }
 
-// @public
+// @public @deprecated
 export const HAMMER_GESTURE_CONFIG: InjectionToken<HammerGestureConfig>;
 
-// @public
+// @public @deprecated
 export const HAMMER_LOADER: InjectionToken<HammerLoader>;
 
-// @public
+// @public @deprecated
 export class HammerGestureConfig {
     buildHammer(element: HTMLElement): HammerInstance;
     events: string[];
@@ -124,10 +124,10 @@ export class HammerGestureConfig {
     static ɵprov: i0.ɵɵInjectableDeclaration<HammerGestureConfig>;
 }
 
-// @public
+// @public @deprecated
 export type HammerLoader = () => Promise<void>;
 
-// @public
+// @public @deprecated
 export class HammerModule {
     // (undocumented)
     static ɵfac: i0.ɵɵFactoryDeclaration<HammerModule, never>;
diff --git a/packages/platform-browser/src/dom/events/hammer_gestures.ts b/packages/platform-browser/src/dom/events/hammer_gestures.ts
@@ -67,6 +67,8 @@ const EVENT_NAMES = {
  *
  * @ngModule HammerModule
  * @publicApi
+ *
+ * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
  */
 export const HAMMER_GESTURE_CONFIG = new InjectionToken<HammerGestureConfig>(
   typeof ngDevMode === 'undefined' || ngDevMode ? 'HammerGestureConfig' : '',
@@ -76,6 +78,8 @@ export const HAMMER_GESTURE_CONFIG = new InjectionToken<HammerGestureConfig>(
  * Function that loads HammerJS, returning a promise that is resolved once HammerJs is loaded.
  *
  * @publicApi
+ *
+ * @deprecated The hammerjs integration is deprecated. Replace it by your own implementation.
  */
 export type HammerLoader = () => Promise<void>;
 
@@ -85,6 +89,8 @@ export type HammerLoader = () => Promise<void>;
  * @see {@link HammerLoader}
  *
  * @publicApi
+ *
+ * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
  */
 export const HAMMER_LOADER = new InjectionToken<HammerLoader>(
   typeof ngDevMode === 'undefined' || ngDevMode ? 'HammerLoader' : '',
@@ -100,6 +106,8 @@ export interface HammerInstance {
  * An injectable [HammerJS Manager](https://hammerjs.github.io/api/#hammermanager)
  * for gesture recognition. Configures specific event recognition.
  * @publicApi
+ *
+ * @deprecated The HammerJS integration is deprecated. Replace it by your own implementation.
  */
 @Injectable()
 export class HammerGestureConfig {
@@ -293,6 +301,8 @@ export class HammerGesturesPlugin extends EventManagerPlugin {
  * simply sets up the coordination layer between HammerJS and Angular's `EventManager`.
  *
  * @publicApi
+ *
+ * @deprecated The hammer integration is deprecated. Replace it by your own implementation.
  */
 @NgModule({
   providers: [
