igniteui-webcomponents 7.3.1 → 7.4.0

package/internals/controllers/focus-ring.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-ring.js","sourceRoot":"","sources":["../../../src/internals/controllers/focus-ring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmBxD,MAAM,2BAA2B;aACP,YAAO,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAU,AAA9C,CAA+C;IAS9E,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,YAAY,IAA0C;QAVrC,iBAAY,GAAG,iBAAiB,EAAE,CAAC;QAC5C,uBAAkB,GAAG,KAAK,CAAC;QAUjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAGM,aAAa;QAClB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QAErC,KAAK,MAAM,KAAK,IAAI,2BAA2B,CAAC,OAAO,EAAE,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAGM,WAAW,CAAC,KAAY;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;QAEvC,IAAI,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;;AAWH,MAAM,UAAU,oBAAoB,CAClC,IAA0C;IAE1C,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport { createAbortHandle } from '../abort-handler.js';\n\n/**\n * A controller class which determines whether a focus ring should be shown to indicate keyboard focus.\n * Focus rings are visible only when the user is interacting with a keyboard, not with a mouse, touch, or other input methods.\n *\n * By default the class attaches a keyup event handler on the component host and will update its keyboard focus\n * state based on it.\n *\n * **Important Note:** This controller is designed for use with **atomic web components** that represent single,\n * interactive elements (e.g., buttons, form fields, interactive icons). It helps these components correctly\n * display a focus indicator *only* when keyboard navigation is occurring, improving accessibility without\n * visual clutter during mouse or touch interactions.\n *\n * **Do not use this controller as a general-purpose shortcut for managing focus state in complex components or layouts.**\n * Misusing it in this way can lead to incorrect focus ring behavior, accessibility issues, and make your\n * application harder to maintain. For managing focus within larger, composite components, consider alternative\n * strategies like ARIA attributes, managing `tabindex`, or a bespoke implementation if needed.\n */\nclass KeyboardFocusRingController implements ReactiveController {\n  private static readonly _events = ['keyup', 'focusout', 'pointerup'] as const;\n\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private readonly _abortHandle = createAbortHandle();\n  private _isKeyboardFocused = false;\n\n  /**\n   * Gets whether the current focus state is activated through a keyboard interaction.\n   */\n  public get focused(): boolean {\n    return this._isKeyboardFocused;\n  }\n\n  constructor(host: ReactiveControllerHost & HTMLElement) {\n    this._host = host;\n    host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    for (const event of KeyboardFocusRingController._events) {\n      this._host.addEventListener(event, this, { passive: true, signal });\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    const focused = event.type === 'keyup';\n\n    if (focused !== this._isKeyboardFocused) {\n      this._isKeyboardFocused = focused;\n      this._host.requestUpdate();\n    }\n  }\n}\n\nexport type { KeyboardFocusRingController };\n\n/**\n * Adds a {@link KeyboardFocusRingController} responsible for managing keyboard focus state.\n *\n * This utility function is intended for use with **atomic web components** that require\n * dynamic focus ring visibility based on keyboard interaction.\n */\nexport function addKeyboardFocusRing(\n  host: ReactiveControllerHost & HTMLElement\n): KeyboardFocusRingController {\n  return new KeyboardFocusRingController(host);\n}\n"]}
+{"version":3,"file":"focus-ring.js","sourceRoot":"","sources":["../../../src/internals/controllers/focus-ring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,2BAA2B;aACP,YAAO,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAU,AAA9C,CAA+C;IAM9E,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,YAAY,IAA0C;QAP9C,uBAAkB,GAAG,KAAK,CAAC;QAQjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,gBAAgB,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,2BAA2B,CAAC,OAAO;YAC3C,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAGM,WAAW,CAAC,KAAY;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;QAEvC,IAAI,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;;AAcH,MAAM,UAAU,oBAAoB,CAClC,IAA0C;IAE1C,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ReactiveControllerHost } from 'lit';\nimport { addHostListeners } from './host-listeners.js';\n\n/** Tracks the keyboard focus state. See {@link addKeyboardFocusRing}. */\nclass KeyboardFocusRingController {\n  private static readonly _events = ['keyup', 'focusout', 'pointerup'] as const;\n\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private _isKeyboardFocused = false;\n\n  /** Whether a keyboard interaction activated the current focus state. */\n  public get focused(): boolean {\n    return this._isKeyboardFocused;\n  }\n\n  constructor(host: ReactiveControllerHost & HTMLElement) {\n    this._host = host;\n\n    addHostListeners(host, {\n      events: KeyboardFocusRingController._events,\n      listener: this,\n      options: { passive: true },\n    });\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    const focused = event.type === 'keyup';\n\n    if (focused !== this._isKeyboardFocused) {\n      this._isKeyboardFocused = focused;\n      this._host.requestUpdate();\n    }\n  }\n}\n\nexport type { KeyboardFocusRingController };\n\n/**\n * Adds a controller that reports whether the host has focus from the\n * keyboard. A component shows its focus ring only in that condition.\n *\n * @remarks\n * Use it for an atomic component, such as a button or a form field. A\n * composite component or a layout needs ARIA attributes, a managed\n * `tabindex`, or an implementation of its own.\n */\nexport function addKeyboardFocusRing(\n  host: ReactiveControllerHost & HTMLElement\n): KeyboardFocusRingController {\n  return new KeyboardFocusRingController(host);\n}\n"]}

package/internals/controllers/fullscreen.d.ts

@@ -1,41 +1,25 @@
-import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ReactiveControllerHost } from 'lit';
 /**
- * Callback invoked when the host element is about to enter/leave fullscreen mode.
- *
- * The callback is passed the current fullscreen `state`.
- * Returning a falsy value from the callback will stop the current fullscreen state change.
+ * Runs before the host enters or leaves fullscreen mode, with the requested
+ * `state`. A falsy return value stops the change.
  */
 type FullscreenControllerCallback = (state: boolean) => boolean;
-/** Configuration object for the fullscreen controller. */
 type FullscreenControllerConfiguration = {
-    /**
-     * Invoked when the host element is entering fullscreen mode.
-     * See the {@link FullscreenControllerCallback} for details.
-     */
+    /** Runs before the host enters fullscreen mode. */
     enter?: FullscreenControllerCallback;
-    /**
-     * Invoked when the host element is leaving fullscreen mode.
-     * See the {@link FullscreenControllerCallback} for details.
-     */
+    /** Runs before the host leaves fullscreen mode. */
     exit?: FullscreenControllerCallback;
 };
-declare class FullscreenController implements ReactiveController {
+declare class FullscreenController {
     private _host;
     private _options;
     private _fullscreen;
     get fullscreen(): boolean;
     constructor(host: ReactiveControllerHost & HTMLElement, options?: FullscreenControllerConfiguration);
-    /**
-     * Transitions the host element to/from fullscreen mode.
-     * This method **will invoke** enter/exit callbacks if present.
-     */
+    /** Moves the host element into or out of fullscreen mode. */
     setState(fullscreen: boolean): void;
     /** @internal */
     handleEvent(): void;
-    /** @internal */
-    hostConnected(): void;
-    /** @internal */
-    hostDisconnected(): void;
 }
 export declare function addFullscreenController(host: ReactiveControllerHost & HTMLElement, options?: FullscreenControllerConfiguration): FullscreenController;
 export {};

package/internals/controllers/fullscreen.js

@@ -1,13 +1,13 @@
+import { addHostListeners } from './host-listeners.js';
 class FullscreenController {
     get fullscreen() {
         return this._fullscreen;
     }
     constructor(host, options) {
-        this._options = {};
         this._fullscreen = false;
         this._host = host;
-        Object.assign(this._options, options);
-        host.addController(this);
+        this._options = { ...options };
+        addHostListeners(host, { events: ['fullscreenchange'], listener: this });
     }
     setState(fullscreen) {
         const callback = fullscreen ? this._options.enter : this._options.exit;
@@ -30,12 +30,6 @@ class FullscreenController {
             this.setState(false);
         }
     }
-    hostConnected() {
-        this._host.addEventListener('fullscreenchange', this);
-    }
-    hostDisconnected() {
-        this._host.removeEventListener('fullscreenchange', this);
-    }
 }
 export function addFullscreenController(host, options) {
     return new FullscreenController(host, options);

package/internals/controllers/fullscreen.js.map

@@ -1 +1 @@
-{"version":3,"file":"fullscreen.js","sourceRoot":"","sources":["../../../src/internals/controllers/fullscreen.ts"],"names":[],"mappings":"AAwBA,MAAM,oBAAoB;IAMxB,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,YACE,IAA0C,EAC1C,OAA2C;QAVrC,aAAQ,GAAsC,EAAE,CAAC;QAEjD,gBAAW,GAAG,KAAK,CAAC;QAU1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAMM,QAAQ,CAAC,UAAmB;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEvE,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAE9B,IAAI,UAAU,EAAE,CAAC;YAGf,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACxC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACtC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAGM,WAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAGM,aAAa;QAClB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA0C,EAC1C,OAA2C;IAE3C,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\n\n/**\n * Callback invoked when the host element is about to enter/leave fullscreen mode.\n *\n * The callback is passed the current fullscreen `state`.\n * Returning a falsy value from the callback will stop the current fullscreen state change.\n */\ntype FullscreenControllerCallback = (state: boolean) => boolean;\n\n/** Configuration object for the fullscreen controller. */\ntype FullscreenControllerConfiguration = {\n  /**\n   * Invoked when the host element is entering fullscreen mode.\n   * See the {@link FullscreenControllerCallback} for details.\n   */\n  enter?: FullscreenControllerCallback;\n  /**\n   * Invoked when the host element is leaving fullscreen mode.\n   * See the {@link FullscreenControllerCallback} for details.\n   */\n  exit?: FullscreenControllerCallback;\n};\n\nclass FullscreenController implements ReactiveController {\n  private _host: ReactiveControllerHost & HTMLElement;\n  private _options: FullscreenControllerConfiguration = {};\n\n  private _fullscreen = false;\n\n  public get fullscreen(): boolean {\n    return this._fullscreen;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: FullscreenControllerConfiguration\n  ) {\n    this._host = host;\n    Object.assign(this._options, options);\n    host.addController(this);\n  }\n\n  /**\n   * Transitions the host element to/from fullscreen mode.\n   * This method **will invoke** enter/exit callbacks if present.\n   */\n  public setState(fullscreen: boolean): void {\n    const callback = fullscreen ? this._options.enter : this._options.exit;\n\n    if (callback && !callback.call(this._host, fullscreen)) {\n      return;\n    }\n\n    this._fullscreen = fullscreen;\n\n    if (fullscreen) {\n      // Rejects when the request is not user activated or the element is not\n      // allowed to go fullscreen - roll the state back so the host re-renders.\n      this._host.requestFullscreen().catch(() => {\n        this._fullscreen = false;\n        this._host.requestUpdate();\n      });\n    } else if (document.fullscreenElement) {\n      document.exitFullscreen().catch(() => {});\n    }\n  }\n\n  /** @internal */\n  public handleEvent(): void {\n    if (!document.fullscreenElement && this._fullscreen) {\n      this.setState(false);\n    }\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._host.addEventListener('fullscreenchange', this);\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._host.removeEventListener('fullscreenchange', this);\n  }\n}\n\nexport function addFullscreenController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: FullscreenControllerConfiguration\n): FullscreenController {\n  return new FullscreenController(host, options);\n}\n"]}
+{"version":3,"file":"fullscreen.js","sourceRoot":"","sources":["../../../src/internals/controllers/fullscreen.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAevD,MAAM,oBAAoB;IAMxB,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,YACE,IAA0C,EAC1C,OAA2C;QARrC,gBAAW,GAAG,KAAK,CAAC;QAU1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAE/B,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAGM,QAAQ,CAAC,UAAmB;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEvE,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAE9B,IAAI,UAAU,EAAE,CAAC;YAGf,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACxC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACtC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAGM,WAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA0C,EAC1C,OAA2C;IAE3C,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC","sourcesContent":["import type { ReactiveControllerHost } from 'lit';\nimport { addHostListeners } from './host-listeners.js';\n\n/**\n * Runs before the host enters or leaves fullscreen mode, with the requested\n * `state`. A falsy return value stops the change.\n */\ntype FullscreenControllerCallback = (state: boolean) => boolean;\n\ntype FullscreenControllerConfiguration = {\n  /** Runs before the host enters fullscreen mode. */\n  enter?: FullscreenControllerCallback;\n  /** Runs before the host leaves fullscreen mode. */\n  exit?: FullscreenControllerCallback;\n};\n\nclass FullscreenController {\n  private _host: ReactiveControllerHost & HTMLElement;\n  private _options: FullscreenControllerConfiguration;\n\n  private _fullscreen = false;\n\n  public get fullscreen(): boolean {\n    return this._fullscreen;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: FullscreenControllerConfiguration\n  ) {\n    this._host = host;\n    this._options = { ...options };\n\n    addHostListeners(host, { events: ['fullscreenchange'], listener: this });\n  }\n\n  /** Moves the host element into or out of fullscreen mode. */\n  public setState(fullscreen: boolean): void {\n    const callback = fullscreen ? this._options.enter : this._options.exit;\n\n    if (callback && !callback.call(this._host, fullscreen)) {\n      return;\n    }\n\n    this._fullscreen = fullscreen;\n\n    if (fullscreen) {\n      // The request rejects without user activation, or for an element that\n      // cannot go fullscreen. The state then rolls back.\n      this._host.requestFullscreen().catch(() => {\n        this._fullscreen = false;\n        this._host.requestUpdate();\n      });\n    } else if (document.fullscreenElement) {\n      document.exitFullscreen().catch(() => {});\n    }\n  }\n\n  /** @internal */\n  public handleEvent(): void {\n    if (!document.fullscreenElement && this._fullscreen) {\n      this.setState(false);\n    }\n  }\n}\n\nexport function addFullscreenController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: FullscreenControllerConfiguration\n): FullscreenController {\n  return new FullscreenController(host, options);\n}\n"]}

package/internals/controllers/gestures.d.ts

@@ -1,28 +1,16 @@
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
 import type { Ref } from 'lit/directives/ref.js';
-/**
- * Configuration object for a {@link GesturesController} instance.
- * @hidden
- */
+/** @hidden */
 export interface GesturesOptions {
     /**
-     * By default, the controller listens for pointer/touch events in the context of the host element.
-     * If you pass a `ref`, you can limit the observation to a certain DOM part of the host scope.
+     * The element that the controller observes. Defaults to the host element.
      */
     ref?: Ref<HTMLElement>;
-    /**
-     * The maximum amount of milliseconds between the start and end of a gesture combination
-     * before it is recognized as such.
-     */
+    /** The maximum time in milliseconds of a recognized gesture. */
     thresholdTime?: number;
-    /**
-     * The minimum amount a "pointer" should travel in pixels, before being recognized as a
-     * gesture.
-     */
+    /** The minimum pointer travel in pixels of a recognized gesture. */
     thresholdDistance?: number;
-    /**
-     * When enabled, the controller will skip events generated by a mouse device.
-     */
+    /** Whether the controller ignores the events of a mouse device. */
     touchOnly?: boolean;
 }
 type GestureDirection = 'left' | 'up' | 'right' | 'down';
@@ -37,22 +25,19 @@ export type GestureData = {
 };
 export declare class SwipeEvent extends Event {
     readonly data: GestureData;
-    readonly name: string;
     constructor(name: string, data: GestureData, initOptions?: EventInit);
 }
 declare class GesturesController extends EventTarget implements ReactiveController {
     private readonly _host;
     private readonly _ref?;
     private readonly _abortHandle;
+    /** The options of the controller, with the defaults applied. */
     private _options;
     private _pointerState;
-    protected get _element(): HTMLElement;
-    /** Get the current configuration object */
+    private get _element();
     get options(): GesturesOptions;
     constructor(host: ReactiveControllerHost & HTMLElement, options?: GesturesOptions);
-    /**
-     * Add an event listener for a given swipe event.
-     */
+    /** Adds an event listener for the given swipe event. */
     set(type: SwipeEvents, callback: (event: SwipeEvent) => void, options?: AddEventListenerOptions): this;
     /** @internal */
     handleEvent(event: PointerEvent): void;
@@ -60,7 +45,6 @@ declare class GesturesController extends EventTarget implements ReactiveControll
     hostConnected(): void;
     /** @internal */
     hostDisconnected(): void;
-    /** Updates the configuration of the controller */
     updateOptions(options: Omit<GesturesOptions, 'ref'>): void;
     private _getGestureState;
     private _setTouchActionState;
@@ -70,12 +54,9 @@ declare class GesturesController extends EventTarget implements ReactiveControll
     private _handlePointerMove;
     private _emit;
     private _createEventArgs;
-    protected _recognize(): GestureDirection | false;
+    private _recognize;
     private _handleLostPointerCapture;
 }
-/**
- * Adds a {@link GesturesController} responsible for managing gesture behaviors
- * for the given host element.
- */
+/** Creates a {@link GesturesController} and adds it to `host`. */
 export declare function addGesturesController(host: ReactiveControllerHost & HTMLElement, options?: GesturesOptions): GesturesController;
 export {};

package/internals/controllers/gestures.js

@@ -9,7 +9,6 @@ const defaultState = Object.freeze({ x: 0, y: 0, time: 0 });
 export class SwipeEvent extends Event {
     constructor(name, data, initOptions) {
         super(name, initOptions);
-        this.name = name;
         this.data = data;
     }
 }
@@ -118,11 +117,10 @@ class GesturesController extends EventTarget {
     }
     _recognize() {
         const { start, current } = this._pointerState;
+        const { thresholdTime: time, thresholdDistance: distance } = this._options;
         const dt = current.time - start.time;
         const dx = current.x - start.x;
         const dy = current.y - start.y;
-        const time = this._options.thresholdTime ?? 500;
-        const distance = this._options.thresholdDistance ?? 100;
         if (dt > time) {
             return false;
         }

package/internals/controllers/gestures.js.map

@@ -1 +1 @@
-{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../../src/internals/controllers/gestures.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,GAAG;IACb,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,eAAe;CACP,CAAC;AACX,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAoD1E,MAAM,OAAO,UAAW,SAAQ,KAAK;IAInC,YAAY,IAAY,EAAE,IAAiB,EAAE,WAAuB;QAClE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,kBAAmB,SAAQ,WAAW;IAiB1C,IAAc,QAAQ;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IACnD,CAAC;IAGD,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,YACE,IAA0C,EAC1C,OAAyB;QAEzB,KAAK,EAAE,CAAC;QA3BO,iBAAY,GAAG,iBAAiB,EAAE,CAAC;QAE5C,aAAQ,GAAoB;YAClC,iBAAiB,EAAE,GAAG;YACtB,aAAa,EAAE,GAAG;YAClB,SAAS,EAAE,KAAK;SACjB,CAAC;QAEM,kBAAa,GAAG;YACtB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,YAAY;SACtB,CAAC;QAiBA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAE9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAKM,GAAG,CACR,IAAiB,EACjB,QAAqC,EACrC,OAAiC;QAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAkB,CAAC;QAEzD,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAGM,WAAW,CAAC,KAAmB;QACpC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,aAAa;gBAChB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,oBAAoB,CAAC;YAC1B,KAAK,eAAe;gBAClB,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAGM,aAAa;QAClB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QAErC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE;YAClC,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrC,OAAO;YACT,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAGM,aAAa,CAAC,OAAqC;QACxD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAEO,gBAAgB,CAAC,EACvB,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,CAAC,GACG;QACb,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACpC,CAAC;IAEO,oBAAoB,CAAC,QAAiB;QAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,aAAa,CAAC,KAAK,GAAG,YAAY,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,OAAO,GAAG,YAAY,CAAC;IAC5C,CAAC;IAEO,uBAAuB,CAAC,KAAmB,EAAE,KAAc;QACjE,IAAI,CAAC,aAAa,CAAC,QAAQ,GAAG,KAAK,CAAC;QACpC,KAAK;YACH,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAEO,kBAAkB,CAAC,KAAmB;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAGhC,IAAI,CAAC,aAAa,CAAC,KAAK,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAEO,kBAAkB,CAAC,KAAmB;QAC5C,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAiB,EAAE,IAAiB;QAChD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;IAEO,gBAAgB;QACtB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAE9C,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,CAAC;YACf,IAAI,EAAE,OAAO,CAAC,CAAC;YACf,MAAM,EAAE,KAAK,CAAC,CAAC;YACf,IAAI,EAAE,OAAO,CAAC,CAAC;SAChB,CAAC;IACJ,CAAC;IAES,UAAU;QAClB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAE9C,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACrC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,GAAG,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,GAAG,CAAC;QAExD,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC7C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,yBAAyB,CAAC,KAAmB;QACnD,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAEhC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAgB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;gBAC/D,IAAI,EAAE,KAAK,CAAC,WAAW;gBACvB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF;AAMD,MAAM,UAAU,qBAAqB,CACnC,IAA0C,EAC1C,OAAyB;IAEzB,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\nimport { createAbortHandle } from '../abort-handler.js';\n\nconst Events = [\n  'pointerdown',\n  'pointermove',\n  'lostpointercapture',\n  'pointercancel',\n] as const;\nconst defaultState: GestureState = Object.freeze({ x: 0, y: 0, time: 0 });\n\n/**\n * Configuration object for a {@link GesturesController} instance.\n * @hidden\n */\nexport interface GesturesOptions {\n  /**\n   * By default, the controller listens for pointer/touch events in the context of the host element.\n   * If you pass a `ref`, you can limit the observation to a certain DOM part of the host scope.\n   */\n  ref?: Ref<HTMLElement>;\n  /**\n   * The maximum amount of milliseconds between the start and end of a gesture combination\n   * before it is recognized as such.\n   */\n  thresholdTime?: number;\n  /**\n   * The minimum amount a \"pointer\" should travel in pixels, before being recognized as a\n   * gesture.\n   */\n  thresholdDistance?: number;\n  /**\n   * When enabled, the controller will skip events generated by a mouse device.\n   */\n  touchOnly?: boolean;\n}\n\ntype GestureState = {\n  x: number;\n  y: number;\n  time: number;\n};\n\ntype GestureDirection = 'left' | 'up' | 'right' | 'down';\ntype SwipeEvents =\n  | 'swipe'\n  | 'swipe-left'\n  | 'swipe-up'\n  | 'swipe-right'\n  | 'swipe-down';\n\nexport type GestureData = {\n  direction: GestureDirection;\n  type: string;\n  xStart: number;\n  xEnd: number;\n  yStart: number;\n  yEnd: number;\n};\n\n/* blazorSuppress */\nexport class SwipeEvent extends Event {\n  public readonly data: GestureData;\n  public readonly name: string;\n\n  constructor(name: string, data: GestureData, initOptions?: EventInit) {\n    super(name, initOptions);\n    this.name = name;\n    this.data = data;\n  }\n}\n\nclass GesturesController extends EventTarget implements ReactiveController {\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private readonly _ref?: Ref<HTMLElement>;\n  private readonly _abortHandle = createAbortHandle();\n\n  private _options: GesturesOptions = {\n    thresholdDistance: 100,\n    thresholdTime: 500,\n    touchOnly: false,\n  };\n\n  private _pointerState = {\n    captured: false,\n    start: defaultState,\n    current: defaultState,\n  };\n\n  protected get _element() {\n    return this._ref ? this._ref.value! : this._host;\n  }\n\n  /** Get the current configuration object */\n  public get options(): GesturesOptions {\n    return this._options;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: GesturesOptions\n  ) {\n    super();\n\n    Object.assign(this._options, options);\n    this._ref = this._options.ref;\n\n    this._host = host;\n    this._host.addController(this);\n  }\n\n  /**\n   * Add an event listener for a given swipe event.\n   */\n  public set(\n    type: SwipeEvents,\n    callback: (event: SwipeEvent) => void,\n    options?: AddEventListenerOptions\n  ): this {\n    const bound = callback.bind(this._host) as EventListener;\n\n    this.addEventListener(type, bound, options);\n    return this;\n  }\n\n  /** @internal */\n  public handleEvent(event: PointerEvent): void {\n    if (this._options.touchOnly && event.pointerType === 'mouse') {\n      return;\n    }\n\n    switch (event.type) {\n      case 'pointerdown':\n        this._handlePointerDown(event);\n        break;\n      case 'pointermove':\n        this._handlePointerMove(event);\n        break;\n      case 'lostpointercapture':\n      case 'pointercancel':\n        this._handleLostPointerCapture(event);\n    }\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    this._host.updateComplete.then(() => {\n      if (signal.aborted || !this._element) {\n        return;\n      }\n\n      for (const event of Events) {\n        this._element.addEventListener(event, this, { passive: true, signal });\n      }\n    });\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  /** Updates the configuration of the controller */\n  public updateOptions(options: Omit<GesturesOptions, 'ref'>): void {\n    Object.assign(this._options, options);\n  }\n\n  private _getGestureState({\n    clientX: x,\n    clientY: y,\n  }: PointerEvent): GestureState {\n    return { x, y, time: Date.now() };\n  }\n\n  private _setTouchActionState(disabled: boolean) {\n    this._element.style.touchAction = disabled ? 'none' : '';\n  }\n\n  private _resetState() {\n    this._pointerState.start = defaultState;\n    this._pointerState.current = defaultState;\n  }\n\n  private _setPointerCaptureState(event: PointerEvent, state: boolean) {\n    this._pointerState.captured = state;\n    state\n      ? this._element.setPointerCapture(event.pointerId)\n      : this._element.releasePointerCapture(event.pointerId);\n  }\n\n  private _handlePointerDown(event: PointerEvent) {\n    const state = this._getGestureState(event);\n\n    this._setTouchActionState(true);\n    // Seeded so that a press without any movement resolves to a zero delta\n    // instead of being measured against the zeroed default state.\n    this._pointerState.start = state;\n    this._pointerState.current = state;\n    this._setPointerCaptureState(event, true);\n  }\n\n  private _handlePointerMove(event: PointerEvent) {\n    if (this._pointerState.captured) {\n      this._pointerState.current = this._getGestureState(event);\n    }\n  }\n\n  private _emit(name: SwipeEvents, data: GestureData) {\n    return this.dispatchEvent(new SwipeEvent(name, data));\n  }\n\n  private _createEventArgs() {\n    const { start, current } = this._pointerState;\n\n    return {\n      xStart: start.x,\n      xEnd: current.x,\n      yStart: start.y,\n      yEnd: current.y,\n    };\n  }\n\n  protected _recognize(): GestureDirection | false {\n    const { start, current } = this._pointerState;\n\n    const dt = current.time - start.time;\n    const dx = current.x - start.x;\n    const dy = current.y - start.y;\n\n    const time = this._options.thresholdTime ?? 500;\n    const distance = this._options.thresholdDistance ?? 100;\n\n    if (dt > time) {\n      return false;\n    }\n\n    if (dx > distance && Math.abs(dy) < distance) {\n      return 'right';\n    }\n\n    if (-dx > distance && Math.abs(dy) < distance) {\n      return 'left';\n    }\n\n    if (dy > distance && Math.abs(dx) < distance) {\n      return 'down';\n    }\n\n    if (-dy > distance && Math.abs(dx) < distance) {\n      return 'up';\n    }\n\n    return false;\n  }\n\n  private _handleLostPointerCapture(event: PointerEvent) {\n    this._setPointerCaptureState(event, false);\n    const state = this._recognize();\n\n    if (state) {\n      const args: GestureData = Object.assign(this._createEventArgs(), {\n        type: event.pointerType,\n        direction: state,\n      });\n\n      this._emit('swipe', args);\n      this._emit(`swipe-${state}`, args);\n    }\n\n    this._resetState();\n    this._setTouchActionState(false);\n  }\n}\n\n/**\n * Adds a {@link GesturesController} responsible for managing gesture behaviors\n * for the given host element.\n */\nexport function addGesturesController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: GesturesOptions\n) {\n  return new GesturesController(host, options);\n}\n"]}
+{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../../src/internals/controllers/gestures.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\nimport { createAbortHandle } from '../abort-handler.js';\n\nconst Events = [\n  'pointerdown',\n  'pointermove',\n  'lostpointercapture',\n  'pointercancel',\n] as const;\nconst defaultState: GestureState = Object.freeze({ x: 0, y: 0, time: 0 });\n\n/** @hidden */\nexport interface GesturesOptions {\n  /**\n   * The element that the controller observes. Defaults to the host element.\n   */\n  ref?: Ref<HTMLElement>;\n  /** The maximum time in milliseconds of a recognized gesture. */\n  thresholdTime?: number;\n  /** The minimum pointer travel in pixels of a recognized gesture. */\n  thresholdDistance?: number;\n  /** Whether the controller ignores the events of a mouse device. */\n  touchOnly?: boolean;\n}\n\ntype ResolvedGesturesOptions = GesturesOptions &\n  Required<\n    Pick<GesturesOptions, 'thresholdTime' | 'thresholdDistance' | 'touchOnly'>\n  >;\n\ntype GestureState = {\n  x: number;\n  y: number;\n  time: number;\n};\n\ntype GestureDirection = 'left' | 'up' | 'right' | 'down';\ntype SwipeEvents =\n  | 'swipe'\n  | 'swipe-left'\n  | 'swipe-up'\n  | 'swipe-right'\n  | 'swipe-down';\n\nexport type GestureData = {\n  direction: GestureDirection;\n  type: string;\n  xStart: number;\n  xEnd: number;\n  yStart: number;\n  yEnd: number;\n};\n\n/* blazorSuppress */\nexport class SwipeEvent extends Event {\n  public readonly data: GestureData;\n\n  constructor(name: string, data: GestureData, initOptions?: EventInit) {\n    super(name, initOptions);\n    this.data = data;\n  }\n}\n\nclass GesturesController extends EventTarget implements ReactiveController {\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private readonly _ref?: Ref<HTMLElement>;\n  private readonly _abortHandle = createAbortHandle();\n\n  /** The options of the controller, with the defaults applied. */\n  private _options: ResolvedGesturesOptions = {\n    thresholdDistance: 100,\n    thresholdTime: 500,\n    touchOnly: false,\n  };\n\n  private _pointerState = {\n    captured: false,\n    start: defaultState,\n    current: defaultState,\n  };\n\n  private get _element() {\n    return this._ref ? this._ref.value! : this._host;\n  }\n\n  public get options(): GesturesOptions {\n    return this._options;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: GesturesOptions\n  ) {\n    super();\n\n    Object.assign(this._options, options);\n    this._ref = this._options.ref;\n\n    this._host = host;\n    this._host.addController(this);\n  }\n\n  /** Adds an event listener for the given swipe event. */\n  public set(\n    type: SwipeEvents,\n    callback: (event: SwipeEvent) => void,\n    options?: AddEventListenerOptions\n  ): this {\n    const bound = callback.bind(this._host) as EventListener;\n\n    this.addEventListener(type, bound, options);\n    return this;\n  }\n\n  /** @internal */\n  public handleEvent(event: PointerEvent): void {\n    if (this._options.touchOnly && event.pointerType === 'mouse') {\n      return;\n    }\n\n    switch (event.type) {\n      case 'pointerdown':\n        this._handlePointerDown(event);\n        break;\n      case 'pointermove':\n        this._handlePointerMove(event);\n        break;\n      case 'lostpointercapture':\n      case 'pointercancel':\n        this._handleLostPointerCapture(event);\n    }\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    this._host.updateComplete.then(() => {\n      if (signal.aborted || !this._element) {\n        return;\n      }\n\n      for (const event of Events) {\n        this._element.addEventListener(event, this, { passive: true, signal });\n      }\n    });\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  public updateOptions(options: Omit<GesturesOptions, 'ref'>): void {\n    Object.assign(this._options, options);\n  }\n\n  private _getGestureState({\n    clientX: x,\n    clientY: y,\n  }: PointerEvent): GestureState {\n    return { x, y, time: Date.now() };\n  }\n\n  private _setTouchActionState(disabled: boolean) {\n    this._element.style.touchAction = disabled ? 'none' : '';\n  }\n\n  private _resetState() {\n    this._pointerState.start = defaultState;\n    this._pointerState.current = defaultState;\n  }\n\n  private _setPointerCaptureState(event: PointerEvent, state: boolean) {\n    this._pointerState.captured = state;\n    state\n      ? this._element.setPointerCapture(event.pointerId)\n      : this._element.releasePointerCapture(event.pointerId);\n  }\n\n  private _handlePointerDown(event: PointerEvent) {\n    const state = this._getGestureState(event);\n\n    this._setTouchActionState(true);\n    // Seed both, so a press without movement gives a zero delta.\n    this._pointerState.start = state;\n    this._pointerState.current = state;\n    this._setPointerCaptureState(event, true);\n  }\n\n  private _handlePointerMove(event: PointerEvent) {\n    if (this._pointerState.captured) {\n      this._pointerState.current = this._getGestureState(event);\n    }\n  }\n\n  private _emit(name: SwipeEvents, data: GestureData) {\n    return this.dispatchEvent(new SwipeEvent(name, data));\n  }\n\n  private _createEventArgs() {\n    const { start, current } = this._pointerState;\n\n    return {\n      xStart: start.x,\n      xEnd: current.x,\n      yStart: start.y,\n      yEnd: current.y,\n    };\n  }\n\n  private _recognize(): GestureDirection | false {\n    const { start, current } = this._pointerState;\n    const { thresholdTime: time, thresholdDistance: distance } = this._options;\n\n    const dt = current.time - start.time;\n    const dx = current.x - start.x;\n    const dy = current.y - start.y;\n\n    if (dt > time) {\n      return false;\n    }\n\n    if (dx > distance && Math.abs(dy) < distance) {\n      return 'right';\n    }\n\n    if (-dx > distance && Math.abs(dy) < distance) {\n      return 'left';\n    }\n\n    if (dy > distance && Math.abs(dx) < distance) {\n      return 'down';\n    }\n\n    if (-dy > distance && Math.abs(dx) < distance) {\n      return 'up';\n    }\n\n    return false;\n  }\n\n  private _handleLostPointerCapture(event: PointerEvent) {\n    this._setPointerCaptureState(event, false);\n    const state = this._recognize();\n\n    if (state) {\n      const args: GestureData = Object.assign(this._createEventArgs(), {\n        type: event.pointerType,\n        direction: state,\n      });\n\n      this._emit('swipe', args);\n      this._emit(`swipe-${state}`, args);\n    }\n\n    this._resetState();\n    this._setTouchActionState(false);\n  }\n}\n\n/** Creates a {@link GesturesController} and adds it to `host`. */\nexport function addGesturesController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: GesturesOptions\n) {\n  return new GesturesController(host, options);\n}\n"]}

package/internals/controllers/group.d.ts

@@ -1,53 +1,36 @@
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
 type GroupHost = ReactiveControllerHost & Element;
-/** The object a group's identity is bound to - a root node, a container element. */
+/** The identity of a group: a root node or a container element. */
 type GroupScope = object;
 type GroupRegistryConfig<T extends GroupHost, S> = {
-    /**
-     * The group key of a host. Together with the scope it forms the identity of
-     * a group. A host with an empty key stays on its own.
-     */
+    /** The group key of a host. An empty key leaves the host on its own. */
     keyOf: (host: T) => string;
-    /**
-     * Derives the group-wide state that each member receives on sync, from the
-     * current members of the group.
-     */
+    /** Derives the state that each member receives on a sync. */
     deriveState: (members: T[]) => S;
-    /**
-     * The scope the group identity is bound to. Defaults to the host's root
-     * node (document or shadow root).
-     */
+    /** The scope of the group identity. Defaults to the host root node. */
     scopeOf?: (host: T) => GroupScope;
 };
-/** The membership of one host, attached to it as a reactive controller. */
+/** The membership of one host, added to it as a reactive controller. */
 interface GroupMemberController<T extends GroupHost> extends ReactiveController {
-    /** The hosts of this member's group, in DOM order. A host with no group is on its own. */
+    /** The hosts of the group, in DOM order. A lone host gets its own group. */
     readonly members: T[];
-    /**
-     * Moves the host to the group of its current scope and key. Does nothing
-     * while both stay the same. If not, the group that the host joins and the
-     * group that it leaves both update their state.
-     */
+    /** Moves the host to the group of its scope and key, and syncs both. */
     updateMembership(): void;
-    /** Updates the state of the host group. */
     sync(): void;
 }
 interface GroupRegistry<T extends GroupHost, S> {
-    /** Creates and attaches a membership controller to the host. */
+    /** Creates a membership controller and adds it to the host. */
     attach(host: T, onSync: (state: S) => void): GroupMemberController<T>;
     /** Returns the hosts of the group of `member`, in DOM order. */
     membersOf(member: T): T[];
 }
 /**
- * Creates a registry of groups whose members discover each other through a
- * shared scope and key instead of a common parent element - the way native
- * radio buttons group by their `name` within a form root.
+ * Creates a registry of groups.
  *
- * Each member holds its own entry for its life-cycle, so that a group read
- * reflects the actual membership and the members that stay behind derive their
- * state again when one leaves - a change a member cannot see on its own.
- *
- * One registry holds one kind of group; create it at module level:
+ * @remarks
+ * Members find each other through a shared scope and key, as native radio
+ * buttons group by `name` in a form root. Create one registry per kind of
+ * group, at module level.
  *
  * @example
  * ```typescript

package/internals/controllers/group.js.map

@@ -1 +1 @@
-{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/internals/controllers/group.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport { isEmpty } from '../utils/arrays.js';\nimport { getRoot } from '../utils/dom.js';\n\ntype GroupHost = ReactiveControllerHost & Element;\n\n/** The object a group's identity is bound to - a root node, a container element. */\ntype GroupScope = object;\n\ntype GroupRegistryConfig<T extends GroupHost, S> = {\n  /**\n   * The group key of a host. Together with the scope it forms the identity of\n   * a group. A host with an empty key stays on its own.\n   */\n  keyOf: (host: T) => string;\n  /**\n   * Derives the group-wide state that each member receives on sync, from the\n   * current members of the group.\n   */\n  deriveState: (members: T[]) => S;\n  /**\n   * The scope the group identity is bound to. Defaults to the host's root\n   * node (document or shadow root).\n   */\n  scopeOf?: (host: T) => GroupScope;\n};\n\n/** The membership of one host, attached to it as a reactive controller. */\ninterface GroupMemberController<\n  T extends GroupHost,\n> extends ReactiveController {\n  /** The hosts of this member's group, in DOM order. A host with no group is on its own. */\n  readonly members: T[];\n  /**\n   * Moves the host to the group of its current scope and key. Does nothing\n   * while both stay the same. If not, the group that the host joins and the\n   * group that it leaves both update their state.\n   */\n  updateMembership(): void;\n  /** Updates the state of the host group. */\n  sync(): void;\n}\n\ninterface GroupRegistry<T extends GroupHost, S> {\n  /** Creates and attaches a membership controller to the host. */\n  attach(host: T, onSync: (state: S) => void): GroupMemberController<T>;\n  /** Returns the hosts of the group of `member`, in DOM order. */\n  membersOf(member: T): T[];\n}\n\nfunction byDocumentOrder(a: Node, b: Node): number {\n  if (a === b) {\n    return 0;\n  }\n\n  return a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING\n    ? -1\n    : 1;\n}\n\n/**\n * Creates a registry of groups whose members discover each other through a\n * shared scope and key instead of a common parent element - the way native\n * radio buttons group by their `name` within a form root.\n *\n * Each member holds its own entry for its life-cycle, so that a group read\n * reflects the actual membership and the members that stay behind derive their\n * state again when one leaves - a change a member cannot see on its own.\n *\n * One registry holds one kind of group; create it at module level:\n *\n * @example\n * ```typescript\n * const radioGroups = createGroupRegistry<IgcRadioComponent, boolean>({\n *   keyOf: (radio) => radio.name || '',\n *   deriveState: (radios) => radios.some((radio) => radio.checked),\n * });\n *\n * // In the component:\n * private readonly _group = radioGroups.attach(this, (state) => { ... });\n * ```\n */\nexport function createGroupRegistry<T extends GroupHost, S>(\n  config: GroupRegistryConfig<T, S>\n): GroupRegistry<T, S> {\n  const groups = new WeakMap<GroupScope, Map<string, Set<Member>>>();\n  const controllers = new WeakMap<T, Member>();\n\n  function scopeOf(host: T): GroupScope {\n    return config.scopeOf?.(host) ?? getRoot(host);\n  }\n\n  /** Gives each member of the group the state that the group derives. */\n  function syncGroup(group: Iterable<Member>): void {\n    const members = Array.from(group);\n    const state = config.deriveState(members.map((member) => member.host));\n\n    for (const member of members) {\n      member.onSync(state);\n    }\n  }\n\n  class Member implements GroupMemberController<T> {\n    public readonly host: T;\n    public readonly onSync: (state: S) => void;\n\n    /** The scope the host is registered under, or null while it is not registered. */\n    private _scope: GroupScope | null = null;\n    private _key = '';\n\n    /** Whether the host still belongs to the group that holds its entry. */\n    private get _isCurrent(): boolean {\n      return (\n        config.keyOf(this.host) === this._key &&\n        scopeOf(this.host) === this._scope\n      );\n    }\n\n    private get _group(): Member[] {\n      const entries = this._scope\n        ? Array.from(groups.get(this._scope)?.get(this._key) ?? [])\n        : [];\n\n      // A host moves to its new group on its next update, so an entry can be\n      // one that has a different key or scope by now.\n      const members = entries.filter((member) => member._isCurrent);\n\n      return isEmpty(members)\n        ? [this]\n        : members.sort((a, b) => byDocumentOrder(a.host, b.host));\n    }\n\n    public get members(): T[] {\n      return this._group.map((member) => member.host);\n    }\n\n    constructor(host: T, onSync: (state: S) => void) {\n      this.host = host;\n      this.onSync = onSync;\n\n      controllers.set(host, this);\n      host.addController(this);\n    }\n\n    public hostConnected(): void {\n      this.updateMembership();\n    }\n\n    public hostDisconnected(): void {\n      this._unregister();\n    }\n\n    public updateMembership(): void {\n      const scope = this.host.isConnected ? scopeOf(this.host) : null;\n      const key = config.keyOf(this.host);\n\n      if (scope === this._scope && key === this._key) {\n        return;\n      }\n\n      this._unregister();\n\n      if (scope && key) {\n        this._scope = scope;\n        this._key = key;\n\n        const keys = groups.get(scope) ?? new Map<string, Set<Member>>();\n        const group = keys.get(key) ?? new Set<Member>();\n\n        keys.set(key, group);\n        groups.set(scope, keys);\n        group.add(this);\n      }\n\n      this.sync();\n    }\n\n    public sync(): void {\n      syncGroup(this._group);\n    }\n\n    private _unregister(): void {\n      const { _scope: scope, _key: key } = this;\n      const keys = scope ? groups.get(scope) : undefined;\n      const group = keys?.get(key);\n\n      this._scope = null;\n      this._key = '';\n\n      if (!group?.delete(this)) {\n        return;\n      }\n\n      if (isEmpty(group)) {\n        keys?.delete(key);\n      } else {\n        // The host is gone, and any state that it held goes with it. What is\n        // left of the group derives its state again.\n        syncGroup(group);\n      }\n    }\n  }\n\n  return {\n    attach(host, onSync) {\n      return new Member(host, onSync);\n    },\n\n    membersOf(member) {\n      const controller = controllers.get(member);\n\n      // Move the member first, so that a read that comes right after a change\n      // of its key or scope resolves against the correct group.\n      controller?.updateMembership();\n\n      return controller?.members ?? [member];\n    },\n  };\n}\n\nexport type { GroupMemberController, GroupRegistry, GroupRegistryConfig };\n"]}
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/internals/controllers/group.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport { isEmpty } from '../utils/arrays.js';\nimport { getRoot } from '../utils/dom.js';\n\ntype GroupHost = ReactiveControllerHost & Element;\n\n/** The identity of a group: a root node or a container element. */\ntype GroupScope = object;\n\ntype GroupRegistryConfig<T extends GroupHost, S> = {\n  /** The group key of a host. An empty key leaves the host on its own. */\n  keyOf: (host: T) => string;\n  /** Derives the state that each member receives on a sync. */\n  deriveState: (members: T[]) => S;\n  /** The scope of the group identity. Defaults to the host root node. */\n  scopeOf?: (host: T) => GroupScope;\n};\n\n/** The membership of one host, added to it as a reactive controller. */\ninterface GroupMemberController<\n  T extends GroupHost,\n> extends ReactiveController {\n  /** The hosts of the group, in DOM order. A lone host gets its own group. */\n  readonly members: T[];\n  /** Moves the host to the group of its scope and key, and syncs both. */\n  updateMembership(): void;\n  sync(): void;\n}\n\ninterface GroupRegistry<T extends GroupHost, S> {\n  /** Creates a membership controller and adds it to the host. */\n  attach(host: T, onSync: (state: S) => void): GroupMemberController<T>;\n  /** Returns the hosts of the group of `member`, in DOM order. */\n  membersOf(member: T): T[];\n}\n\nfunction byDocumentOrder(a: Node, b: Node): number {\n  if (a === b) {\n    return 0;\n  }\n\n  return a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING\n    ? -1\n    : 1;\n}\n\n/**\n * Creates a registry of groups.\n *\n * @remarks\n * Members find each other through a shared scope and key, as native radio\n * buttons group by `name` in a form root. Create one registry per kind of\n * group, at module level.\n *\n * @example\n * ```typescript\n * const radioGroups = createGroupRegistry<IgcRadioComponent, boolean>({\n *   keyOf: (radio) => radio.name || '',\n *   deriveState: (radios) => radios.some((radio) => radio.checked),\n * });\n *\n * // In the component:\n * private readonly _group = radioGroups.attach(this, (state) => { ... });\n * ```\n */\nexport function createGroupRegistry<T extends GroupHost, S>(\n  config: GroupRegistryConfig<T, S>\n): GroupRegistry<T, S> {\n  const groups = new WeakMap<GroupScope, Map<string, Set<Member>>>();\n  const controllers = new WeakMap<T, Member>();\n\n  function scopeOf(host: T): GroupScope {\n    return config.scopeOf?.(host) ?? getRoot(host);\n  }\n\n  /** Derives the group state and gives it to each member. */\n  function syncGroup(group: Iterable<Member>): void {\n    const members = Array.from(group);\n    const state = config.deriveState(members.map((member) => member.host));\n\n    for (const member of members) {\n      member.onSync(state);\n    }\n  }\n\n  class Member implements GroupMemberController<T> {\n    public readonly host: T;\n    public readonly onSync: (state: S) => void;\n\n    /** The scope of the host, or `null` while it is not registered. */\n    private _scope: GroupScope | null = null;\n    private _key = '';\n\n    /** Whether the host still belongs to the group that holds its entry. */\n    private get _isCurrent(): boolean {\n      return (\n        config.keyOf(this.host) === this._key &&\n        scopeOf(this.host) === this._scope\n      );\n    }\n\n    private get _group(): Member[] {\n      const entries = this._scope\n        ? Array.from(groups.get(this._scope)?.get(this._key) ?? [])\n        : [];\n\n      // A host moves on its next update, so an entry can hold a stale key.\n      const members = entries.filter((member) => member._isCurrent);\n\n      return isEmpty(members)\n        ? [this]\n        : members.sort((a, b) => byDocumentOrder(a.host, b.host));\n    }\n\n    public get members(): T[] {\n      return this._group.map((member) => member.host);\n    }\n\n    constructor(host: T, onSync: (state: S) => void) {\n      this.host = host;\n      this.onSync = onSync;\n\n      controllers.set(host, this);\n      host.addController(this);\n    }\n\n    public hostConnected(): void {\n      this.updateMembership();\n    }\n\n    public hostDisconnected(): void {\n      this._unregister();\n    }\n\n    public updateMembership(): void {\n      const scope = this.host.isConnected ? scopeOf(this.host) : null;\n      const key = config.keyOf(this.host);\n\n      if (scope === this._scope && key === this._key) {\n        return;\n      }\n\n      this._unregister();\n\n      if (scope && key) {\n        this._scope = scope;\n        this._key = key;\n\n        const keys = groups.get(scope) ?? new Map<string, Set<Member>>();\n        const group = keys.get(key) ?? new Set<Member>();\n\n        keys.set(key, group);\n        groups.set(scope, keys);\n        group.add(this);\n      }\n\n      this.sync();\n    }\n\n    public sync(): void {\n      syncGroup(this._group);\n    }\n\n    private _unregister(): void {\n      const { _scope: scope, _key: key } = this;\n      const keys = scope ? groups.get(scope) : undefined;\n      const group = keys?.get(key);\n\n      this._scope = null;\n      this._key = '';\n\n      if (!group?.delete(this)) {\n        return;\n      }\n\n      if (isEmpty(group)) {\n        keys?.delete(key);\n      } else {\n        // The remaining members derive their state again without this host.\n        syncGroup(group);\n      }\n    }\n  }\n\n  return {\n    attach(host, onSync) {\n      return new Member(host, onSync);\n    },\n\n    membersOf(member) {\n      const controller = controllers.get(member);\n\n      // Move first, so a read after a key or scope change resolves right.\n      controller?.updateMembership();\n\n      return controller?.members ?? [member];\n    },\n  };\n}\n\nexport type { GroupMemberController, GroupRegistry, GroupRegistryConfig };\n"]}

package/internals/controllers/host-listeners.d.ts

@@ -0,0 +1,28 @@
+import type { ReactiveControllerHost } from 'lit';
+type HostListenersHost = ReactiveControllerHost & EventTarget;
+export type HostListenersConfig = {
+    /**
+     * The target of the listeners. Defaults to the host. A function resolves
+     * when the host connects, for a target that does not exist yet, such as
+     * the render root of a Lit host.
+     */
+    target?: EventTarget | (() => EventTarget);
+    events: readonly string[];
+    /** The listener. An object receives events through `handleEvent`. */
+    listener: EventListenerOrEventListenerObject;
+    options?: AddEventListenerOptions;
+};
+/**
+ * Adds a listener set to the given host.
+ *
+ * @example
+ * ```typescript
+ * addHostListeners(this, {
+ *   events: ['keyup', 'focusout'],
+ *   listener: this,
+ *   options: { passive: true },
+ * });
+ * ```
+ */
+export declare function addHostListeners(host: HostListenersHost, config: HostListenersConfig): void;
+export {};

package/internals/controllers/host-listeners.js

@@ -0,0 +1,27 @@
+class HostListenersController {
+    constructor(host, config) {
+        this._host = host;
+        this._config = config;
+        host.addController(this);
+    }
+    hostConnected() {
+        const { target, events, listener, options } = this._config;
+        const element = (typeof target === 'function' ? target() : target) ?? this._host;
+        this._controller = new AbortController();
+        const listenerOptions = {
+            ...options,
+            signal: this._controller.signal,
+        };
+        for (const event of events) {
+            element.addEventListener(event, listener, listenerOptions);
+        }
+    }
+    hostDisconnected() {
+        this._controller?.abort();
+        this._controller = undefined;
+    }
+}
+export function addHostListeners(host, config) {
+    new HostListenersController(host, config);
+}
+//# sourceMappingURL=host-listeners.js.map

package/internals/controllers/host-listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-listeners.js","sourceRoot":"","sources":["../../../src/internals/controllers/host-listeners.ts"],"names":[],"mappings":"AAwBA,MAAM,uBAAuB;IAK3B,YAAY,IAAuB,EAAE,MAA2B;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAGM,aAAa;QAClB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3D,MAAM,OAAO,GACX,CAAC,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,MAAM,eAAe,GAA4B;YAC/C,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;SAChC,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;CACF;AAcD,MAAM,UAAU,gBAAgB,CAC9B,IAAuB,EACvB,MAA2B;IAE3B,IAAI,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\n\ntype HostListenersHost = ReactiveControllerHost & EventTarget;\n\nexport type HostListenersConfig = {\n  /**\n   * The target of the listeners. Defaults to the host. A function resolves\n   * when the host connects, for a target that does not exist yet, such as\n   * the render root of a Lit host.\n   */\n  target?: EventTarget | (() => EventTarget);\n  events: readonly string[];\n  /** The listener. An object receives events through `handleEvent`. */\n  listener: EventListenerOrEventListenerObject;\n  options?: AddEventListenerOptions;\n};\n\n/**\n * Adds a set of listeners for as long as the host is connected.\n *\n * @remarks\n * One abort signal removes every listener on a disconnect, without the\n * matching options object that a manual removal needs.\n */\nclass HostListenersController implements ReactiveController {\n  private readonly _host: HostListenersHost;\n  private readonly _config: HostListenersConfig;\n  private _controller?: AbortController;\n\n  constructor(host: HostListenersHost, config: HostListenersConfig) {\n    this._host = host;\n    this._config = config;\n    host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { target, events, listener, options } = this._config;\n    const element =\n      (typeof target === 'function' ? target() : target) ?? this._host;\n    this._controller = new AbortController();\n\n    const listenerOptions: AddEventListenerOptions = {\n      ...options,\n      signal: this._controller.signal,\n    };\n\n    for (const event of events) {\n      element.addEventListener(event, listener, listenerOptions);\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._controller?.abort();\n    this._controller = undefined;\n  }\n}\n\n/**\n * Adds a listener set to the given host.\n *\n * @example\n * ```typescript\n * addHostListeners(this, {\n *   events: ['keyup', 'focusout'],\n *   listener: this,\n *   options: { passive: true },\n * });\n * ```\n */\nexport function addHostListeners(\n  host: HostListenersHost,\n  config: HostListenersConfig\n): void {\n  new HostListenersController(host, config);\n}\n"]}

package/internals/controllers/id-resolver.d.ts

@@ -1,13 +1,11 @@
 import { type LitElement, type ReactiveController } from 'lit';
-/**
- * Reactive controller that allows a host component to resolve ID references
- * scoped to its root node, and react to changes in those references.
- */
+/** Resolves ID references in a root node. See {@link addIdRefResolver}. */
 declare class IdRefResolverController implements ReactiveController {
     private readonly _host;
     private readonly _callback;
+    /** Whether the consumer asked for the observation. */
     private _active;
-    private _connected;
+    /** The emitter of the current root node, non-null only while observing. */
     private _emitter;
     constructor(host: LitElement, callback: (ids: Set<string>) => unknown);
     private _observe;
@@ -18,14 +16,15 @@ declare class IdRefResolverController implements ReactiveController {
     hostConnected(): void;
     /** @internal */
     hostDisconnected(): void;
-    /** Start tracking ID reference changes in the document. */
     observe(): void;
-    /** Stop tracking ID reference changes in the document. */
     unobserve(): void;
 }
 /**
- * Adds an ID reference resolver controller to the host component, allowing it to resolve ID references scoped to
- * its root node and react to changes in those references.
+ * Adds a controller that resolves ID references in the root node of the host.
+ *
+ * @remarks
+ * The controller calls `callback` with the ids that changed. Call `observe`
+ * to start and `unobserve` to stop. A root node shares one observation.
  */
 export declare function addIdRefResolver(host: LitElement, callback: (ids: Set<string>) => unknown): IdRefResolverController;
 export type { IdRefResolverController };

package/internals/controllers/id-resolver.js

@@ -73,13 +73,15 @@ class IdRefChangeEmitter extends EventTarget {
 class IdRefResolverController {
     constructor(host, callback) {
         this._active = false;
-        this._connected = false;
         this._emitter = null;
         this._host = host;
         this._host.addController(this);
         this._callback = callback;
     }
     _observe() {
+        if (this._emitter) {
+            return;
+        }
         const root = this._host.getRootNode();
         this._emitter = getEmitter(root);
         this._emitter.retain();
@@ -96,32 +98,22 @@ class IdRefResolverController {
         this._callback.call(this._host, event.detail);
     }
     hostConnected() {
-        this._connected = true;
         if (this._active) {
             this._observe();
         }
     }
     hostDisconnected() {
-        if (this._active) {
-            this._unobserve();
-        }
-        this._connected = false;
+        this._unobserve();
     }
     observe() {
-        if (this._active)
-            return;
         this._active = true;
-        if (this._connected) {
+        if (this._host.isConnected) {
             this._observe();
         }
     }
     unobserve() {
-        if (!this._active)
-            return;
         this._active = false;
-        if (this._connected) {
-            this._unobserve();
-        }
+        this._unobserve();
     }
 }
 export function addIdRefResolver(host, callback) {

package/internals/controllers/id-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"id-resolver.js","sourceRoot":"","sources":["../../../src/internals/controllers/id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer, type LitElement, type ReactiveController } from 'lit';\nimport { isDocument, isElement } from '../utils/dom.js';\n\nconst ID_REF_EMITTERS = new WeakMap<Node, IdRefChangeEmitter>();\nconst ID_REF_EVENT = 'id-refs-change';\n\nfunction getEmitter(root: Node): IdRefChangeEmitter {\n  let emitter = ID_REF_EMITTERS.get(root);\n  if (!emitter) {\n    emitter = new IdRefChangeEmitter(root);\n    ID_REF_EMITTERS.set(root, emitter);\n  }\n  return emitter;\n}\n\n/** Adds the ids of `nodes` and of any of their descendants to `affected`. */\nfunction collectIds(nodes: NodeList, affected: Set<string>): void {\n  for (const node of nodes) {\n    if (!isElement(node)) continue;\n    if (node.id) affected.add(node.id);\n    for (const child of node.querySelectorAll('[id]')) {\n      if (child.id) affected.add(child.id);\n    }\n  }\n}\n\nfunction refObserverCallback(\n  mutations: MutationRecord[],\n  emitter: IdRefChangeEmitter\n): void {\n  const affected = new Set<string>();\n\n  for (const mutation of mutations) {\n    if (mutation.type === 'attributes') {\n      if (!isElement(mutation.target)) continue;\n      const oldId = mutation.oldValue;\n      const newId = mutation.target.id;\n      if (oldId) affected.add(oldId);\n      if (newId) affected.add(newId);\n    } else {\n      collectIds(mutation.addedNodes, affected);\n      collectIds(mutation.removedNodes, affected);\n    }\n  }\n\n  if (affected.size > 0) {\n    emitter.dispatchEvent(new CustomEvent(ID_REF_EVENT, { detail: affected }));\n  }\n}\n\n/**\n * Emits events when ID references in a root node change, allowing components to reactively update resolved references.\n * Uses a reference counting mechanism to avoid unnecessary observation when no components are using it.\n */\nclass IdRefChangeEmitter extends EventTarget {\n  private readonly _observer?: MutationObserver;\n  private readonly _root: Node;\n  private _refCount = 0;\n\n  constructor(root: Node) {\n    super();\n    this._root = root;\n\n    if (!isServer) {\n      this._observer = new MutationObserver((mutations) =>\n        refObserverCallback(mutations, this)\n      );\n    }\n  }\n\n  /**\n   * Increment the reference count. Starts the underlying MutationObserver on the first call.\n   */\n  public retain(): void {\n    if (this._refCount++ === 0) {\n      const root = isDocument(this._root) ? this._root.body : this._root;\n      this._observer?.observe(root, {\n        attributeFilter: ['id'],\n        attributeOldValue: true,\n        subtree: true,\n        childList: true,\n      });\n    }\n  }\n\n  /**\n   * Decrement the reference count. Stops the underlying MutationObserver when the count reaches zero.\n   */\n  public release(): void {\n    if (this._refCount > 0 && --this._refCount === 0) {\n      this._observer?.disconnect();\n    }\n  }\n}\n\n/**\n * Reactive controller that allows a host component to resolve ID references\n * scoped to its root node, and react to changes in those references.\n */\nclass IdRefResolverController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _callback: (ids: Set<string>) => unknown;\n  private _active = false;\n  private _connected = false;\n  private _emitter: IdRefChangeEmitter | null = null;\n\n  constructor(host: LitElement, callback: (ids: Set<string>) => unknown) {\n    this._host = host;\n    this._host.addController(this);\n    this._callback = callback;\n  }\n\n  private _observe(): void {\n    const root = this._host.getRootNode();\n    this._emitter = getEmitter(root);\n    this._emitter.retain();\n    this._emitter.addEventListener(ID_REF_EVENT, this);\n  }\n\n  private _unobserve(): void {\n    if (this._emitter) {\n      this._emitter.removeEventListener(ID_REF_EVENT, this);\n      this._emitter.release();\n      this._emitter = null;\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    this._callback.call(this._host, (event as CustomEvent<Set<string>>).detail);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._connected = true;\n    if (this._active) {\n      this._observe();\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    if (this._active) {\n      this._unobserve();\n    }\n    this._connected = false;\n  }\n\n  /** Start tracking ID reference changes in the document. */\n  public observe(): void {\n    if (this._active) return;\n    this._active = true;\n    if (this._connected) {\n      this._observe();\n    }\n  }\n\n  /** Stop tracking ID reference changes in the document. */\n  public unobserve(): void {\n    if (!this._active) return;\n    this._active = false;\n    if (this._connected) {\n      this._unobserve();\n    }\n  }\n}\n\n/**\n * Adds an ID reference resolver controller to the host component, allowing it to resolve ID references scoped to\n * its root node and react to changes in those references.\n */\nexport function addIdRefResolver(\n  host: LitElement,\n  callback: (ids: Set<string>) => unknown\n): IdRefResolverController {\n  return new IdRefResolverController(host, callback);\n}\n\nexport type { IdRefResolverController };\n"]}
+{"version":3,"file":"id-resolver.js","sourceRoot":"","sources":["../../../src/internals/controllers/id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer, type LitElement, type ReactiveController } from 'lit';\nimport { isDocument, isElement } from '../utils/dom.js';\n\nconst ID_REF_EMITTERS = new WeakMap<Node, IdRefChangeEmitter>();\nconst ID_REF_EVENT = 'id-refs-change';\n\nfunction getEmitter(root: Node): IdRefChangeEmitter {\n  let emitter = ID_REF_EMITTERS.get(root);\n  if (!emitter) {\n    emitter = new IdRefChangeEmitter(root);\n    ID_REF_EMITTERS.set(root, emitter);\n  }\n  return emitter;\n}\n\n/** Adds the ids of `nodes` and of any of their descendants to `affected`. */\nfunction collectIds(nodes: NodeList, affected: Set<string>): void {\n  for (const node of nodes) {\n    if (!isElement(node)) continue;\n    if (node.id) affected.add(node.id);\n    for (const child of node.querySelectorAll('[id]')) {\n      if (child.id) affected.add(child.id);\n    }\n  }\n}\n\nfunction refObserverCallback(\n  mutations: MutationRecord[],\n  emitter: IdRefChangeEmitter\n): void {\n  const affected = new Set<string>();\n\n  for (const mutation of mutations) {\n    if (mutation.type === 'attributes') {\n      if (!isElement(mutation.target)) continue;\n      const oldId = mutation.oldValue;\n      const newId = mutation.target.id;\n      if (oldId) affected.add(oldId);\n      if (newId) affected.add(newId);\n    } else {\n      collectIds(mutation.addedNodes, affected);\n      collectIds(mutation.removedNodes, affected);\n    }\n  }\n\n  if (affected.size > 0) {\n    emitter.dispatchEvent(new CustomEvent(ID_REF_EVENT, { detail: affected }));\n  }\n}\n\n/**\n * Sends an event when an ID reference in a root node changes. A reference\n * count starts the observation for the first consumer, and stops it after\n * the last one releases.\n */\nclass IdRefChangeEmitter extends EventTarget {\n  private readonly _observer?: MutationObserver;\n  private readonly _root: Node;\n  private _refCount = 0;\n\n  constructor(root: Node) {\n    super();\n    this._root = root;\n\n    if (!isServer) {\n      this._observer = new MutationObserver((mutations) =>\n        refObserverCallback(mutations, this)\n      );\n    }\n  }\n\n  /** Starts the mutation observer on the first call. */\n  public retain(): void {\n    if (this._refCount++ === 0) {\n      const root = isDocument(this._root) ? this._root.body : this._root;\n      this._observer?.observe(root, {\n        attributeFilter: ['id'],\n        attributeOldValue: true,\n        subtree: true,\n        childList: true,\n      });\n    }\n  }\n\n  /** Stops the observer when the reference count reaches zero. */\n  public release(): void {\n    if (this._refCount > 0 && --this._refCount === 0) {\n      this._observer?.disconnect();\n    }\n  }\n}\n\n/** Resolves ID references in a root node. See {@link addIdRefResolver}. */\nclass IdRefResolverController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _callback: (ids: Set<string>) => unknown;\n  /** Whether the consumer asked for the observation. */\n  private _active = false;\n\n  /** The emitter of the current root node, non-null only while observing. */\n  private _emitter: IdRefChangeEmitter | null = null;\n\n  constructor(host: LitElement, callback: (ids: Set<string>) => unknown) {\n    this._host = host;\n    this._host.addController(this);\n    this._callback = callback;\n  }\n\n  private _observe(): void {\n    if (this._emitter) {\n      return;\n    }\n\n    const root = this._host.getRootNode();\n    this._emitter = getEmitter(root);\n    this._emitter.retain();\n    this._emitter.addEventListener(ID_REF_EVENT, this);\n  }\n\n  private _unobserve(): void {\n    if (this._emitter) {\n      this._emitter.removeEventListener(ID_REF_EVENT, this);\n      this._emitter.release();\n      this._emitter = null;\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    this._callback.call(this._host, (event as CustomEvent<Set<string>>).detail);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    if (this._active) {\n      this._observe();\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._unobserve();\n  }\n\n  public observe(): void {\n    this._active = true;\n\n    if (this._host.isConnected) {\n      this._observe();\n    }\n  }\n\n  public unobserve(): void {\n    this._active = false;\n    this._unobserve();\n  }\n}\n\n/**\n * Adds a controller that resolves ID references in the root node of the host.\n *\n * @remarks\n * The controller calls `callback` with the ids that changed. Call `observe`\n * to start and `unobserve` to stop. A root node shares one observation.\n */\nexport function addIdRefResolver(\n  host: LitElement,\n  callback: (ids: Set<string>) => unknown\n): IdRefResolverController {\n  return new IdRefResolverController(host, callback);\n}\n\nexport type { IdRefResolverController };\n"]}