@angular/core 19.0.0-next.8 → 19.0.0-rc.0

package/fesm2022/primitives/event-dispatch.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0-next.8
+ * @license Angular v19.0.0-rc.0
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -455,9 +455,11 @@ function getBrowserEventType(eventType) {
  * @param element The element.
  * @param eventType The event type.
  * @param handler The handler function to install.
+ * @param passive A boolean value that, if `true`, indicates that the function
+ *     specified by `handler` will never call `preventDefault()`.
  * @return Information needed to uninstall the event handler eventually.
  */
-function addEventListener(element, eventType, handler) {
+function addEventListener(element, eventType, handler, passive) {
     // All event handlers are registered in the bubbling
     // phase.
     //
@@ -476,8 +478,9 @@ function addEventListener(element, eventType, handler) {
     if (isCaptureEventType(eventType)) {
         capture = true;
     }
-    element.addEventListener(eventType, handler, capture);
-    return { eventType, handler, capture };
+    const options = typeof passive === 'boolean' ? { capture, passive } : capture;
+    element.addEventListener(eventType, handler, options);
+    return { eventType, handler, capture, passive };
 }
 /**
  * Removes the event handler for the given event from the element.
@@ -489,7 +492,11 @@ function addEventListener(element, eventType, handler) {
  */
 function removeEventListener(element, info) {
     if (element.removeEventListener) {
-        element.removeEventListener(info.eventType, info.handler, info.capture);
+        // It's worth noting that some browser releases have been inconsistent on this, and unless
+        // you have specific reasons otherwise, it's probably wise to use the same values used for
+        // the call to addEventListener() when calling removeEventListener().
+        const options = typeof info.passive === 'boolean' ? { capture: info.capture } : info.capture;
+        element.removeEventListener(info.eventType, info.handler, options);
         // `detachEvent` is an old DOM API.
         // tslint:disable-next-line:no-any
     }
@@ -1059,24 +1066,25 @@ const isIos = typeof navigator !== 'undefined' && /iPhone|iPad|iPod/.test(naviga
  * container is removed from the contract.
  */
 class EventContractContainer {
+    element;
+    /**
+     * Array of event handlers and their corresponding event types that are
+     * installed on this container.
+     *
+     */
+    handlerInfos = [];
     /**
      * @param element The container Element.
      */
     constructor(element) {
         this.element = element;
-        /**
-         * Array of event handlers and their corresponding event types that are
-         * installed on this container.
-         *
-         */
-        this.handlerInfos = [];
     }
     /**
      * Installs the provided installer on the element owned by this container,
      * and maintains a reference to resulting handler in order to remove it
      * later if desired.
      */
-    addEventListener(eventType, getHandler) {
+    addEventListener(eventType, getHandler, passive) {
         // In iOS, event bubbling doesn't happen automatically in any DOM element,
         // unless it has an onclick attribute or DOM event handler attached to it.
         // This breaks JsAction in some cases. See "Making Elements Clickable"
@@ -1091,7 +1099,7 @@ class EventContractContainer {
         if (isIos) {
             this.element.style.cursor = 'pointer';
         }
-        this.handlerInfos.push(addEventListener(this.element, eventType, getHandler(this.element)));
+        this.handlerInfos.push(addEventListener(this.element, eventType, getHandler(this.element), passive));
     }
     /**
      * Removes all the handlers installed on this container.
@@ -1258,6 +1266,7 @@ function createEventInfo({ eventType, event, targetElement, container, timestamp
  * size.
  */
 class EventInfoWrapper {
+    eventInfo;
     constructor(eventInfo) {
         this.eventInfo = eventInfo;
     }
@@ -1337,12 +1346,13 @@ const REGEXP_SEMICOLON = /\s*;\s*/;
 const DEFAULT_EVENT_TYPE = EventType.CLICK;
 /** Resolves actions for Events. */
 class ActionResolver {
+    a11yClickSupport = false;
+    clickModSupport = true;
+    syntheticMouseEventSupport;
+    updateEventInfoForA11yClick = undefined;
+    preventDefaultForA11yClick = undefined;
+    populateClickOnlyAction = undefined;
     constructor({ syntheticMouseEventSupport = false, clickModSupport = true, } = {}) {
-        this.a11yClickSupport = false;
-        this.clickModSupport = true;
-        this.updateEventInfoForA11yClick = undefined;
-        this.preventDefaultForA11yClick = undefined;
-        this.populateClickOnlyAction = undefined;
         this.syntheticMouseEventSupport = syntheticMouseEventSupport;
         this.clickModSupport = clickModSupport;
     }
@@ -1568,6 +1578,15 @@ var Restriction;
  * jsaction.
  */
 class Dispatcher {
+    dispatchDelegate;
+    // The ActionResolver to use to resolve actions.
+    actionResolver;
+    /** The replayer function to be called when there are queued events. */
+    eventReplayer;
+    /** Whether the event replay is scheduled. */
+    eventReplayScheduled = false;
+    /** The queue of events. */
+    replayEventInfoWrappers = [];
     /**
      * Options are:
      *   - `eventReplayer`: When the event contract dispatches replay events
@@ -1577,10 +1596,6 @@ class Dispatcher {
      */
     constructor(dispatchDelegate, { actionResolver, eventReplayer, } = {}) {
         this.dispatchDelegate = dispatchDelegate;
-        /** Whether the event replay is scheduled. */
-        this.eventReplayScheduled = false;
-        /** The queue of events. */
-        this.replayEventInfoWrappers = [];
         this.actionResolver = actionResolver;
         this.eventReplayer = eventReplayer;
     }
@@ -1688,6 +1703,10 @@ const COMPOSED_PATH_ERROR_MESSAGE = `\`composedPath\` called during event replay
  * `currentTarget`, etc.
  */
 class EventDispatcher {
+    dispatchDelegate;
+    clickModSupport;
+    actionResolver;
+    dispatcher;
     constructor(dispatchDelegate, clickModSupport = true) {
         this.dispatchDelegate = dispatchDelegate;
         this.clickModSupport = clickModSupport;
@@ -1803,6 +1822,7 @@ function registerDispatcher$1(eventContract, dispatcher) {
  * late-loaded EventContract.
  */
 class EarlyEventContract {
+    dataContainer;
     constructor(dataContainer = window, container = window.document.documentElement) {
         this.dataContainer = dataContainer;
         dataContainer._ejsa = createEarlyJsactionData(container);
@@ -1910,30 +1930,31 @@ const MOUSE_SPECIAL_SUPPORT = false;
  * be delay loaded in a generic way.
  */
 class EventContract {
-    static { this.MOUSE_SPECIAL_SUPPORT = MOUSE_SPECIAL_SUPPORT; }
+    static MOUSE_SPECIAL_SUPPORT = MOUSE_SPECIAL_SUPPORT;
+    containerManager;
+    /**
+     * The DOM events which this contract covers. Used to prevent double
+     * registration of event types. The value of the map is the
+     * internally created DOM event handler function that handles the
+     * DOM events. See addEvent().
+     *
+     */
+    eventHandlers = {};
+    browserEventTypeToExtraEventTypes = {};
+    /**
+     * The dispatcher function. Events are passed to this function for
+     * handling once it was set using the registerDispatcher() method. This is
+     * done because the function is passed from another jsbinary, so passing the
+     * instance and invoking the method here would require to leave the method
+     * unobfuscated.
+     */
+    dispatcher = null;
+    /**
+     * The list of suspended `EventInfo` that will be dispatched
+     * as soon as the `Dispatcher` is registered.
+     */
+    queuedEventInfos = [];
     constructor(containerManager) {
-        /**
-         * The DOM events which this contract covers. Used to prevent double
-         * registration of event types. The value of the map is the
-         * internally created DOM event handler function that handles the
-         * DOM events. See addEvent().
-         *
-         */
-        this.eventHandlers = {};
-        this.browserEventTypeToExtraEventTypes = {};
-        /**
-         * The dispatcher function. Events are passed to this function for
-         * handling once it was set using the registerDispatcher() method. This is
-         * done because the function is passed from another jsbinary, so passing the
-         * instance and invoking the method here would require to leave the method
-         * unobfuscated.
-         */
-        this.dispatcher = null;
-        /**
-         * The list of suspended `EventInfo` that will be dispatched
-         * as soon as the `Dispatcher` is registered.
-         */
-        this.queuedEventInfos = [];
         this.containerManager = containerManager;
     }
     handleEvent(eventType, event, container) {
@@ -1969,8 +1990,11 @@ class EventContract {
      *     to subscribe to jsaction="transitionEnd:foo" while the underlying
      *     event is webkitTransitionEnd in one browser and mozTransitionEnd
      *     in another.
+     *
+     * @param passive A boolean value that, if `true`, indicates that the event
+     *     handler will never call `preventDefault()`.
      */
-    addEvent(eventType, prefixedEventType) {
+    addEvent(eventType, prefixedEventType, passive) {
         if (eventType in this.eventHandlers || !this.containerManager) {
             return;
         }
@@ -1992,7 +2016,7 @@ class EventContract {
             return (event) => {
                 eventHandler(eventType, event, element);
             };
-        });
+        }, passive);
     }
     /**
      * Gets the queued early events and replay them using the appropriate handler