fix(cdk/platform): preserve compatibility with angular versions less than 19.1 (angular#30401)

Fixes that we were importing a symbol only available in Angular 19.1, even though our peer dependencies allow 19.0.x.

Fixes angular#30388.

Author: crisbeto

src/cdk/drag-drop/drag-drop-registry.ts

@@ -10,7 +10,6 @@ import {
   ChangeDetectionStrategy,
   Component,
   Injectable,
-  ListenerOptions,
   NgZone,
   OnDestroy,
   RendererFactory2,
@@ -20,7 +19,7 @@ import {
   signal,
 } from '@angular/core';
 import {DOCUMENT} from '@angular/common';
-import {_bindEventWithOptions} from '@angular/cdk/platform';
+import {_bindEventWithOptions, _ListenerOptions} from '@angular/cdk/platform';
 import {_CdkPrivateStyleLoader} from '@angular/cdk/private';
 import {Observable, Observer, Subject, merge} from 'rxjs';
 import type {DropListRef} from './drop-list-ref';
@@ -178,7 +177,7 @@ export class DragDropRegistry<_ = unknown, __ = unknown> implements OnDestroy {
       const isTouchEvent = event.type.startsWith('touch');
       const endEventHandler = (e: Event) => this.pointerUp.next(e as TouchEvent | MouseEvent);
 
-      const toBind: [name: string, handler: (event: Event) => void, options: ListenerOptions][] = [
+      const toBind: [name: string, handler: (event: Event) => void, options: _ListenerOptions][] = [
         // Use capturing so that we pick up scroll changes in any scrollable nodes that aren't
         // the document. See https://github.com/angular/components/issues/17144.
         ['scroll', (e: Event) => this.scroll.next(e), capturingEventOptions],

src/cdk/platform/features/backwards-compatibility.ts

@@ -6,7 +6,15 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
-import {Renderer2, VERSION, ListenerOptions} from '@angular/core';
+import {Renderer2, VERSION} from '@angular/core';
+
+// TODO(crisbeto): replace interface with the one from core when making breaking changes for v20.
+/** Options when binding events manually. */
+export interface _ListenerOptions {
+  capture?: boolean;
+  once?: boolean;
+  passive?: boolean;
+}
 
 // TODO(crisbeto): remove this function when making breaking changes for v20.
 /**
@@ -20,7 +28,7 @@ export function _bindEventWithOptions(
   target: EventTarget,
   eventName: string,
   callback: (event: any) => boolean | void,
-  options: ListenerOptions,
+  options: _ListenerOptions,
 ): () => void {
   const major = parseInt(VERSION.major);
   const minor = parseInt(VERSION.minor);

tools/public_api_guard/cdk/platform.md

@@ -5,11 +5,10 @@
 ```ts
 
 import * as i0 from '@angular/core';
-import { ListenerOptions } from '@angular/core';
 import { Renderer2 } from '@angular/core';
 
 // @public
-export function _bindEventWithOptions(renderer: Renderer2, target: EventTarget, eventName: string, callback: (event: any) => boolean | void, options: ListenerOptions): () => void;
+export function _bindEventWithOptions(renderer: Renderer2, target: EventTarget, eventName: string, callback: (event: any) => boolean | void, options: _ListenerOptions): () => void;
 
 // @public
 export function _getEventTarget<T extends EventTarget>(event: Event): T | null;
@@ -29,6 +28,16 @@ export function getSupportedInputTypes(): Set<string>;
 // @public
 export function _isTestEnvironment(): boolean;
 
+// @public
+export interface _ListenerOptions {
+    // (undocumented)
+    capture?: boolean;
+    // (undocumented)
+    once?: boolean;
+    // (undocumented)
+    passive?: boolean;
+}
+
 // @public
 export function normalizePassiveListenerOptions(options: AddEventListenerOptions): AddEventListenerOptions | boolean;