@m3e/core 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/index.js

@@ -429,7 +429,7 @@ class MutationController extends MonitorControllerBase {
 }
 _MutationController_host = new WeakMap(), _MutationController_callback = new WeakMap(), _MutationController_skipInitial = new WeakMap(), _MutationController_config = new WeakMap(), _MutationController_observer = new WeakMap(), _MutationController_unobservedUpdate = new WeakMap();
 
-var _PressedController_instances, _PressedController_capture, _PressedController_callback, _PressedController_isPressedKey, _PressedController_pressedTargets, _PressedController_pointerDownHandler, _PressedController_pointerUpHandler, _PressedController_keyDownHandler, _PressedController_keyUpHandler, _PressedController_handlePointerDown, _PressedController_handlePointerUp, _PressedController_handleKeyDown, _PressedController_handleKeyUp;
+var _PressedController_instances, _PressedController_capture, _PressedController_callback, _PressedController_isPressedKey, _PressedController_pressedTargets, _PressedController_minPressedDuration, _PressedController_pointerDownHandler, _PressedController_pointerUpHandler, _PressedController_keyDownHandler, _PressedController_keyUpHandler, _PressedController_handlePointerDown, _PressedController_handlePointerUp, _PressedController_handleKeyDown, _PressedController_handleKeyUp;
 /** A `ReactiveController` used to monitor the pressed state of one or more elements. */
 class PressedController extends MonitorControllerBase {
     /**
@@ -443,7 +443,8 @@ class PressedController extends MonitorControllerBase {
         /** @private */ _PressedController_capture.set(this, void 0);
         /** @private */ _PressedController_callback.set(this, void 0);
         /** @private */ _PressedController_isPressedKey.set(this, void 0);
-        /** @private */ _PressedController_pressedTargets.set(this, new Set());
+        /** @private */ _PressedController_pressedTargets.set(this, new Map());
+        /** @private */ _PressedController_minPressedDuration.set(this, void 0);
         /** @private */ _PressedController_pointerDownHandler.set(this, (e) => __classPrivateFieldGet(this, _PressedController_instances, "m", _PressedController_handlePointerDown).call(this, e));
         /** @private */ _PressedController_pointerUpHandler.set(this, (e) => __classPrivateFieldGet(this, _PressedController_instances, "m", _PressedController_handlePointerUp).call(this, e));
         /** @private */ _PressedController_keyDownHandler.set(this, (e) => __classPrivateFieldGet(this, _PressedController_instances, "m", _PressedController_handleKeyDown).call(this, e));
@@ -451,6 +452,7 @@ class PressedController extends MonitorControllerBase {
         __classPrivateFieldSet(this, _PressedController_capture, options.capture, "f");
         __classPrivateFieldSet(this, _PressedController_callback, options.callback, "f");
         __classPrivateFieldSet(this, _PressedController_isPressedKey, options.isPressedKey, "f");
+        __classPrivateFieldSet(this, _PressedController_minPressedDuration, options.minPressedDuration ?? 0, "f");
     }
     /** @inheritdoc */
     hostConnected() {
@@ -486,37 +488,63 @@ class PressedController extends MonitorControllerBase {
         }
     }
 }
-_PressedController_capture = new WeakMap(), _PressedController_callback = new WeakMap(), _PressedController_isPressedKey = new WeakMap(), _PressedController_pressedTargets = new WeakMap(), _PressedController_pointerDownHandler = new WeakMap(), _PressedController_pointerUpHandler = new WeakMap(), _PressedController_keyDownHandler = new WeakMap(), _PressedController_keyUpHandler = new WeakMap(), _PressedController_instances = new WeakSet(), _PressedController_handlePointerDown = function _PressedController_handlePointerDown(e) {
+_PressedController_capture = new WeakMap(), _PressedController_callback = new WeakMap(), _PressedController_isPressedKey = new WeakMap(), _PressedController_pressedTargets = new WeakMap(), _PressedController_minPressedDuration = new WeakMap(), _PressedController_pointerDownHandler = new WeakMap(), _PressedController_pointerUpHandler = new WeakMap(), _PressedController_keyDownHandler = new WeakMap(), _PressedController_keyUpHandler = new WeakMap(), _PressedController_instances = new WeakSet(), _PressedController_handlePointerDown = function _PressedController_handlePointerDown(e) {
     if (e.pointerType === "mouse" && e.button > 1)
         return;
     for (const target of e.composedPath()) {
         if (target instanceof HTMLElement && this.isObserving(target)) {
-            __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").add(target);
-            __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, true, { x: e.x, y: e.y }, target);
+            if (!__classPrivateFieldGet(this, _PressedController_pressedTargets, "f").has(target)) {
+                __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").set(target, performance.now());
+                __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, true, { x: e.x, y: e.y }, target);
+            }
             break;
         }
     }
 }, _PressedController_handlePointerUp = function _PressedController_handlePointerUp(e) {
     if (e.pointerType === "mouse" && e.button > 1)
         return;
-    __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").forEach((x) => __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x: e.x, y: e.y }, x));
-    __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").clear();
+    const x = e.x;
+    const y = e.y;
+    for (const target of __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").keys()) {
+        const remainingTime = __classPrivateFieldGet(this, _PressedController_minPressedDuration, "f") - (performance.now() - __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").get(target));
+        if (remainingTime > 0) {
+            setTimeout(() => {
+                __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").delete(target);
+                __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x, y }, target);
+            }, remainingTime);
+        }
+        else {
+            __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").delete(target);
+            __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x, y }, target);
+        }
+    }
 }, _PressedController_handleKeyDown = function _PressedController_handleKeyDown(e) {
-    const target = e.target;
+    if (e.target !== e.currentTarget)
+        return;
+    const target = e.currentTarget;
     if (!__classPrivateFieldGet(this, _PressedController_pressedTargets, "f").has(target) && __classPrivateFieldGet(this, _PressedController_isPressedKey, "f")?.call(this, e.key)) {
         if (e.key === " ") {
             e.preventDefault();
         }
-        __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").add(target);
+        __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").set(target, performance.now());
         const bounds = target.getBoundingClientRect();
         __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, true, { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 }, target);
     }
 }, _PressedController_handleKeyUp = function _PressedController_handleKeyUp(e) {
     const target = e.target;
     if (__classPrivateFieldGet(this, _PressedController_pressedTargets, "f").has(target) && __classPrivateFieldGet(this, _PressedController_isPressedKey, "f")?.call(this, e.key)) {
-        __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").delete(target);
+        const remainingTime = __classPrivateFieldGet(this, _PressedController_minPressedDuration, "f") - (performance.now() - __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").get(target));
         const bounds = target.getBoundingClientRect();
-        __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 }, target);
+        if (remainingTime > 0) {
+            setTimeout(() => {
+                __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").delete(target);
+                __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 }, target);
+            }, remainingTime);
+        }
+        else {
+            __classPrivateFieldGet(this, _PressedController_pressedTargets, "f").delete(target);
+            __classPrivateFieldGet(this, _PressedController_callback, "f").call(this, false, { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 }, target);
+        }
     }
 };
 
@@ -787,10 +815,12 @@ const _internals = Symbol("_internals");
  */
 function AttachInternals(base, formAssociated) {
     class _AttachInternals extends base {
+        /** @internal */
         get [internals]() {
             return this[_internals] ?? (this[_internals] = this.attachInternals());
         }
     }
+    /** Indicates that this custom element participates in form submission, validation, and form state restoration. */
     _AttachInternals.formAssociated = formAssociated;
     return _AttachInternals;
 }
@@ -858,8 +888,13 @@ function Checked(base) {
     class _CheckedMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * Whether the element is checked.
+             * @default false
+             */
             this.checked = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("checked")) {
@@ -898,8 +933,13 @@ function CheckedIndeterminate(base) {
     class _CheckedIndeterminateMixin extends Checked(base) {
         constructor() {
             super(...arguments);
+            /**
+             * Whether the element's checked state is indeterminate.
+             * @default false
+             */
             this.indeterminate = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("indeterminate") && this.role && this.role !== "none" && this.role !== "presentation") {
@@ -931,8 +971,13 @@ function Selected(base) {
     class _SelectedMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * Whether the element is selected.
+             * @default false
+             */
             this.selected = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("selected")) {
@@ -1003,26 +1048,33 @@ function Dirty(base) {
     class _Dirty extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = () => this.markAsDirty();
         }
+        /** Whether the user has modified the value of the element. */
         get dirty() {
             return this.classList.contains("-dirty");
         }
+        /** Whether the user has not modified the value of the element. */
         get pristine() {
             return !this.dirty;
         }
+        /** @inheritdoc */
         connectedCallback() {
             this.markAsPristine();
             super.connectedCallback();
             this.addEventListener("change", this[_eventHandler$2]);
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("change", this[_eventHandler$2]);
         }
+        /** Marks the element as pristine. */
         markAsPristine() {
             this.classList.toggle("-dirty", false);
         }
+        /** Marks the element as dirty. */
         markAsDirty() {
             this.classList.toggle("-dirty", true);
         }
@@ -1051,26 +1103,33 @@ function Touched(base) {
     class _Touched extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = () => this.markAsTouched();
         }
+        /** Whether the user has interacted when the element. */
         get touched() {
             return this.classList.contains("-touched");
         }
+        /** Whether the user has not interacted when the element. */
         get untouched() {
             return !this.touched;
         }
+        /** @inheritdoc */
         connectedCallback() {
             this.markAsUntouched();
             super.connectedCallback();
             this.addEventListener("focusout", this[_eventHandler$1]);
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("focusout", this[_eventHandler$1]);
         }
+        /** Marks the element as touched. */
         markAsTouched() {
             this.classList.toggle("-touched", true);
         }
+        /** Marks the element as untouched. */
         markAsUntouched() {
             this.classList.toggle("-touched", false);
         }
@@ -1728,8 +1787,13 @@ function Disabled(base, reflect = true) {
     class _DisabledMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * Whether the element is disabled.
+             * @default false
+             */
             this.disabled = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("disabled") && this.role && this.role !== "none" && this.role !== "presentation") {
@@ -1765,6 +1829,7 @@ function DisabledInteractive(base) {
     class _DisabledInteractiveMixin extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = (e) => {
                 if (this.disabledInteractive) {
                     // Only allow specific keys when disabled and interactive.
@@ -1775,16 +1840,23 @@ function DisabledInteractive(base) {
                     e.preventDefault();
                 }
             };
+            /**
+             * Whether the element is disabled and interactive.
+             * @default false
+             */
             this.disabledInteractive = false;
         }
+        /** @inheritdoc */
         connectedCallback() {
             SUPPRESSED_EVENTS.forEach((x) => this.addEventListener(x, this[_suppressedEventHandler], true));
             super.connectedCallback();
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             SUPPRESSED_EVENTS.forEach((x) => this.removeEventListener(x, this[_suppressedEventHandler], true));
             super.disconnectedCallback();
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if ((changedProperties.has("disabled") || changedProperties.has("disabledInteractive")) &&
@@ -1824,29 +1896,35 @@ function Labelled(base) {
     class _Labelled extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = (e) => {
                 if (!e.defaultPrevented) {
                     this[_updateLabels]();
                 }
             };
         }
+        /** The label elements that the element is associated with. */
         get labels() {
             return this[internals].labels;
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             this.addEventListener("focusout", this[_eventHandler]);
             this.addEventListener("change", this[_eventHandler]);
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("focusout", this[_eventHandler]);
             this.removeEventListener("change", this[_eventHandler]);
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             this[_updateLabels]();
         }
+        /** @private */
         [(_a = _eventHandler, _updateLabels)]() {
             const focusable = this.hasAttribute("tabindex");
             const disabled = (isDisabledMixin(this) && this.disabled) || (isDisabledInteractiveMixin(this) && this.disabledInteractive);
@@ -1861,6 +1939,7 @@ function Labelled(base) {
             }
         }
     }
+    /** Indicates that this custom element participates in form submission, validation, and form state restoration. */
     _Labelled.formAssociated = true;
     return _Labelled;
 }
@@ -1893,21 +1972,26 @@ function FormAssociated(base) {
     class _FormAssociatedMixin extends base {
         constructor() {
             super(...arguments);
-            this[_a] = false;
-            this[_b] = false;
+            /** @private */ this[_a] = false;
+            /** @private */ this[_b] = false;
         }
+        /** The `HTMLFormElement` associated with this element. */
         get form() {
             return this[internals].form;
         }
+        /** @inheritdoc */
         get labels() {
             return this[internals].labels;
         }
+        /** @internal */
         get [(_a = _defaultIndeterminate, _b = _formDisabled, formValue)]() {
             return null;
         }
+        /** @internal */
         get [defaultValue]() {
             return this[_defaultValue];
         }
+        /** The name that identifies the element when submitting the associated form. */
         get name() {
             return this.getAttribute("name") ?? "";
         }
@@ -1922,12 +2006,17 @@ function FormAssociated(base) {
         // Disabled attributes should not be reflected for form associated elements due to
         // how the formDisabledCallback overrides an element's disabled state.
         // See https://github.com/whatwg/html/issues/8365
+        /**
+         * Whether the element is disabled.
+         * @default false
+         */
         get disabled() {
             return super.disabled || this[_formDisabled];
         }
         set disabled(value) {
             super.disabled = value;
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             if (isCheckedMixin(this)) {
@@ -1940,10 +2029,12 @@ function FormAssociated(base) {
                 this[_defaultValue] = this.value;
             }
         }
+        /** @inheritdoc */
         requestUpdate(name, oldValue, options) {
             super.requestUpdate(name, oldValue, options);
             this[internals].setFormValue(this[formValue]);
         }
+        /** Called when the element is disabled or enabled via its form association. */
         formDisabledCallback(disabled) {
             const wasDisabled = this.disabled;
             this[_formDisabled] = disabled;
@@ -1951,6 +2042,7 @@ function FormAssociated(base) {
                 this.requestUpdate("disabled", wasDisabled);
             }
         }
+        /** Called when the associated form is reset. */
         formResetCallback() {
             if (isCheckedMixin(this)) {
                 this.checked = this[_defaultValue] === true;
@@ -1969,6 +2061,7 @@ function FormAssociated(base) {
             }
         }
     }
+    /** Indicates that this custom element participates in form submission, validation, and form state restoration. */
     _FormAssociatedMixin.formAssociated = true;
     __decorate([
         n$1({ noAccessor: true })
@@ -2004,20 +2097,28 @@ function ConstraintValidation(base) {
             super(...arguments);
             __ConstraintValidation_instances.add(this);
         }
+        /** Whether the element is a submittable element that is a candidate for constraint validation. */
         get willValidate() {
             return this[internals].willValidate;
         }
+        /** The validity state of the element. */
         get validity() {
             this[_updateValidity]();
             return this[internals].validity;
         }
+        /** The error message that would be displayed if the user submits the form, or an empty string if no error message. */
         get validationMessage() {
             this[_updateValidity]();
             return this[internals].validationMessage;
         }
+        /** @internal */
         [(__ConstraintValidation_instances = new WeakSet(), validate)]() {
             return this[_validityMessage] ? { customError: true } : undefined;
         }
+        /**
+         * Returns `true` if the element has no validity problems; otherwise, returns `false`, fires
+         * an invalid event, and (if the event isn't canceled) reports the problem to the user.
+         */
         reportValidity() {
             if (isTouchedMixin(this)) {
                 this.markAsTouched();
@@ -2025,10 +2126,18 @@ function ConstraintValidation(base) {
             this[_updateValidity]();
             return this[internals].reportValidity();
         }
+        /**
+         * Returns `true` if the element has no validity problems; otherwise,
+         * returns `false`, fires an invalid event.
+         */
         checkValidity() {
             this[_updateValidity]();
             return this[internals].checkValidity();
         }
+        /**
+         * Sets a custom validity message for the element.
+         * @param error The message to use for validity errors.
+         */
         setCustomValidity(error) {
             if (error) {
                 this[_validityMessage] = error;
@@ -2038,14 +2147,17 @@ function ConstraintValidation(base) {
             }
             this[_updateValidity]();
         }
+        /** @inheritdoc */
         requestUpdate(name, oldValue, options) {
             super.requestUpdate(name, oldValue, options);
             this[_updateValidity]();
         }
+        /** @inheritdoc */
         firstUpdated(_changedProperties) {
             super.firstUpdated(_changedProperties);
             this[_updateValidity]();
         }
+        /** @private */
         [_updateValidity]() {
             if (isServer || !this.isConnected)
                 return;
@@ -2120,6 +2232,7 @@ function ConstraintValidation(base) {
  */
 function EventAttribute(base, ...types) {
     class _EventAttribute extends base {
+        /** @internal */
         dispatchEvent(event) {
             if (types.includes(event.type)) {
                 const eventAttribute = this.getAttribute(`on${event.type}`);
@@ -2145,6 +2258,7 @@ function Focusable(base) {
     class _FocusableMixin extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = 0;
         }
         /** @inheritdoc */
@@ -2152,12 +2266,14 @@ function Focusable(base) {
             this[_tabindex] = Number.parseInt(this.getAttribute("tabindex") ?? "0");
             super.connectedCallback();
         }
+        /** @inheritdoc */
         firstUpdated(_changedProperties) {
             super.firstUpdated(_changedProperties);
             if (!this.hasAttribute("tabindex") && !_changedProperties.has("disabled")) {
                 this.setAttribute("tabindex", `${this[_tabindex]}`);
             }
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("disabled")) {
@@ -2200,9 +2316,16 @@ function FormSubmitter(base) {
     class _FormSubmitterMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * The type of the element.
+             * @default "button"
+             */
             this.type = "button";
+            /** @private */
             this[_a] = async (e) => {
-                if ((isDisabledMixin(this) && this.disabled) || (isDisabledInteractiveMixin(this) && this.disabledInteractive)) {
+                if (e.defaultPrevented ||
+                    (isDisabledMixin(this) && this.disabled) ||
+                    (isDisabledInteractiveMixin(this) && this.disabledInteractive)) {
                     return;
                 }
                 const form = this[internals].form;
@@ -2229,6 +2352,10 @@ function FormSubmitter(base) {
                 }
             };
         }
+        /**
+         * The name of the element, submitted as a pair with the element's `value`
+         * as part of form data, when the element is used to submit a form.
+         */
         get name() {
             return this.getAttribute("name") ?? "";
         }
@@ -2240,6 +2367,7 @@ function FormSubmitter(base) {
                 this.removeAttribute("name");
             }
         }
+        /** The value associated with the element's name when it's submitted with form data. */
         get value() {
             return this.getAttribute("value");
         }
@@ -2251,16 +2379,20 @@ function FormSubmitter(base) {
                 this.removeAttribute("value");
             }
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             this.addEventListener("click", this[_clickHandler$1]);
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("click", this[_clickHandler$1]);
         }
     }
     _a = _clickHandler$1;
+    /** Indicates that this custom element participates in form submission, validation, and form state restoration. */
+    _FormSubmitterMixin.formAssociated = true;
     __decorate([
         n$1()
     ], _FormSubmitterMixin.prototype, "name", null);
@@ -2296,15 +2428,19 @@ function HtmlFor(base) {
             super(...arguments);
             /** @private */ this[_a] = null;
             /** @private */ this[_b] = false;
+            /** The identifier of the interactive control to which this element is attached. */
             this.htmlFor = null;
         }
+        /** The interactive element to which this element is attached. */
         get control() {
             return this[_control];
         }
+        /** @inheritdoc */
         firstUpdated(_changedProperties) {
             super.firstUpdated(_changedProperties);
             this[_firstUpdated] = true;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("htmlFor")) {
@@ -2324,9 +2460,14 @@ function HtmlFor(base) {
                 }
             }
         }
+        /**
+         * Attaches the element to an interactive control.
+         * @param {HTMLElement} control The element that controls the attachable element.
+         */
         attach(control) {
             this[_control] = control;
         }
+        /** Detaches the element from its current interactive control. */
         detach() {
             this[_control] = null;
         }
@@ -2351,19 +2492,25 @@ function KeyboardClick(base, allowEnter = true) {
         constructor() {
             super(...arguments);
             __KeyboardClickMixin_instances.add(this);
+            /** @private */
             __KeyboardClickMixin_keyUpHandler.set(this, (e) => __classPrivateFieldGet(this, __KeyboardClickMixin_instances, "m", __KeyboardClickMixin_handleKeyUp).call(this, e));
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             this.addEventListener("keyup", __classPrivateFieldGet(this, __KeyboardClickMixin_keyUpHandler, "f"));
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("keyup", __classPrivateFieldGet(this, __KeyboardClickMixin_keyUpHandler, "f"));
         }
     }
     __KeyboardClickMixin_keyUpHandler = new WeakMap(), __KeyboardClickMixin_instances = new WeakSet(), __KeyboardClickMixin_handleKeyUp = function __KeyboardClickMixin_handleKeyUp(e) {
-        if ((isDisabledMixin(this) && this.disabled) || (isDisabledInteractiveMixin(this) && this.disabledInteractive)) {
+        if (e.defaultPrevented ||
+            e.target !== e.currentTarget ||
+            (isDisabledMixin(this) && this.disabled) ||
+            (isDisabledInteractiveMixin(this) && this.disabledInteractive)) {
             return;
         }
         if (e.key === " " || (allowEnter && e.key === "Enter")) {
@@ -2441,10 +2588,27 @@ function LinkButton(base) {
                     link.click();
                 }
             };
+            /**
+             * The URL to which the link button points.
+             * @default ""
+             */
             this.href = "";
+            /**
+             * The target of the link button.
+             * @default ""
+             */
             this.target = "";
+            /**
+             * The relationship between the `target` of the link button and the document.
+             * @default ""
+             */
             this.rel = "";
         }
+        /**
+         * A value indicating whether the `target` of the link button will be downloaded,
+         * optionally specifying the new name of the file.
+         * @default null
+         */
         get download() {
             return this.getAttribute("download");
         }
@@ -2460,6 +2624,7 @@ function LinkButton(base) {
                 this.requestUpdate("download", old);
             }
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             this.addEventListener("click", this[_clickHandler]);
@@ -2467,10 +2632,12 @@ function LinkButton(base) {
                 this.role = "link";
             }
         }
+        /** @inheritdoc */
         disconnectedCallback() {
             super.disconnectedCallback();
             this.removeEventListener("click", this[_clickHandler]);
         }
+        /** @internal */
         [(__LinkButtonMixin_instances = new WeakSet(), _a = _clickHandler, renderPseudoLink)]() {
             const disabled = isDisabledMixin(this) && this.disabled;
             const disabledInteractive = isDisabledInteractiveMixin(this) && this.disabledInteractive;
@@ -2542,8 +2709,13 @@ function ReadOnly(base, reflect = true) {
     class _ReadOnlyMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * A value indicating whether the element is read-only.
+             * @default false
+             */
             this.readOnly = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("readOnly")) {
@@ -2575,11 +2747,17 @@ function Required(base) {
     class _RequiredMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * Whether a value is required for the element.
+             * @default false
+             */
             this.required = false;
         }
+        /** Whether a value is not required for the element. */
         get optional() {
             return !this.required;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("required")) {
@@ -2609,6 +2787,7 @@ function isRequiredConstraintValidationMixin(value) {
  */
 function RequiredConstraintValidation(base) {
     class _RequiredConstraintValidation extends base {
+        /** @internal */
         [validate]() {
             const validity = super[validate]();
             if (!validity && this.required) {
@@ -2635,6 +2814,7 @@ function RequiredConstraintValidation(base) {
  */
 function Role(base, role) {
     class _RoleMixin extends base {
+        /** @inheritdoc */
         connectedCallback() {
             this.role = this.role || role;
             super.connectedCallback();
@@ -2661,8 +2841,13 @@ function Vertical(base) {
     class _VerticalMixin extends base {
         constructor() {
             super(...arguments);
+            /**
+             * Whether the element is oriented vertically.
+             * @default false
+             */
             this.vertical = false;
         }
+        /** @inheritdoc */
         update(changedProperties) {
             super.update(changedProperties);
             if (changedProperties.has("vertical")) {
@@ -2740,13 +2925,13 @@ function prefersReducedMotion() {
  * If needed, scrolls an element into view within a given scroll container.
  * @param {HTMLElement} element The element to scroll into view.
  * @param {HTMLElement} scrollContainer The scrollable container.
- * @param {ScrollBehavior} [behavior="auto"] The scroll behavior.
+ * @param {ScrollIntoViewOptions} [options=undefined] Options used to scroll into view.
  */
-function scrollIntoViewIfNeeded(element, scrollContainer, behavior = "auto") {
-    const containerRect = scrollContainer.getBoundingClientRect();
-    const elementRect = element.getBoundingClientRect();
-    if (elementRect.top < containerRect.top || elementRect.bottom > containerRect.bottom) {
-        element.scrollIntoView({ block: "nearest", behavior: behavior });
+function scrollIntoViewIfNeeded(element, scrollContainer, options) {
+    const containerBounds = scrollContainer.getBoundingClientRect();
+    const elementBounds = element.getBoundingClientRect();
+    if (elementBounds.top < containerBounds.top || elementBounds.bottom > containerBounds.bottom) {
+        element.scrollIntoView(options);
     }
 }
 
@@ -2775,7 +2960,7 @@ var _M3eCollapsibleElement_instances, _M3eCollapsibleElement_slotChanged, _M3eCo
  *
  * @cssprop --m3e-collapsible-animation-duration - The duration of the expand / collapse animation.
  */
-let M3eCollapsibleElement = class M3eCollapsibleElement extends EventAttribute(Role(LitElement, "none"), "opening", "opened", "closing", "closed") {
+let M3eCollapsibleElement = class M3eCollapsibleElement extends EventAttribute(LitElement, "opening", "opened", "closing", "closed") {
     constructor() {
         super(...arguments);
         _M3eCollapsibleElement_instances.add(this);
@@ -2930,7 +3115,6 @@ const ElevationToken = {
 
 var _M3eElevationElement_instances, _M3eElevationElement_hoverController, _M3eElevationElement_focusController, _M3eElevationElement_pressedController, _M3eElevationElement_handleHoverChange, _M3eElevationElement_handleFocusChange, _M3eElevationElement_handlePressedChange;
 /**
- * @summary
  * Visually depicts elevation using a shadow.
  *
  * @description
@@ -3184,7 +3368,6 @@ const FocusRingToken = {
 
 var _M3eFocusRingElement_instances, _M3eFocusRingElement_focusController, _M3eFocusRingElement_handleFocusChange;
 /**
- * @summary
  * A focus ring used to depict a strong focus indicator.
  *
  * @description
@@ -3372,7 +3555,6 @@ M3eFocusRingElement = __decorate([
 ], M3eFocusRingElement);
 
 /**
- * @summary
  * An element which looks like a checkbox.
  *
  * @description
@@ -3477,7 +3659,6 @@ M3ePseudoCheckboxElement = __decorate([
 ], M3ePseudoCheckboxElement);
 
 /**
- * @summary
  * An element which looks like a radio button.
  *
  * @description
@@ -3562,7 +3743,6 @@ const RippleToken = {
 
 var _M3eRippleElement_instances, _M3eRippleElement_ripple, _M3eRippleElement_pressedController, _M3eRippleElement_destroyRipple, _M3eRippleElement_handleAnimationEnd, _M3eRippleElement_handlePressedChange;
 /**
- * @summary
  * Connects user input to screen reactions using ripples.
  *
  * @description
@@ -3611,6 +3791,7 @@ let M3eRippleElement = class M3eRippleElement extends HtmlFor(Role(LitElement, "
         /** @private */ _M3eRippleElement_ripple.set(this, null);
         /** @private */ _M3eRippleElement_pressedController.set(this, new PressedController(this, {
             target: null,
+            minPressedDuration: 150,
             isPressedKey: (key) => key === " " || (!this.disableEnter && key === "Enter"),
             callback: (pressed, { x, y }) => __classPrivateFieldGet(this, _M3eRippleElement_instances, "m", _M3eRippleElement_handlePressedChange).call(this, pressed, x, y),
         }));
@@ -3837,7 +4018,6 @@ M3eRippleElement = __decorate([
 
 var _M3eScrollContainerElement_scrollHandler;
 /**
- * @summary
  * A vertically oriented content container which presents dividers above and below content when scrolled.
  *
  * @description
@@ -3867,7 +4047,7 @@ var _M3eScrollContainerElement_scrollHandler;
  * @cssprop --m3e-focus-ring-factor - Animation factor for focus ring thickness.
  * @cssprop --m3e-focus-ring-duration - Duration of the focus ring animation.
  */
-let M3eScrollContainerElement = class M3eScrollContainerElement extends Role(LitElement, "none") {
+let M3eScrollContainerElement = class M3eScrollContainerElement extends LitElement {
     constructor() {
         super(...arguments);
         /** @private */ _M3eScrollContainerElement_scrollHandler.set(this, () => this._updateScroll());
@@ -4000,7 +4180,7 @@ var _M3eSlide_instances, _M3eSlide_updateItems;
  *
  * @cssprop --m3e-slide-animation-duration - The duration of transitions between slotted items.
  */
-let M3eSlide = class M3eSlide extends Role(LitElement, "none") {
+let M3eSlide = class M3eSlide extends LitElement {
     constructor() {
         super(...arguments);
         _M3eSlide_instances.add(this);
@@ -4110,7 +4290,6 @@ const StateLayerToken = {
 
 var _M3eStateLayerElement_instances, _M3eStateLayerElement_hoverController, _M3eStateLayerElement_focusController, _M3eStateLayerElement_handleHoverChange, _M3eStateLayerElement_handleFocusChange;
 /**
- * @summary
  * Provides focus and hover state layer treatment for an interactive element.
  *
  * @description
@@ -4286,7 +4465,6 @@ M3eStateLayerElement = __decorate([
 ], M3eStateLayerElement);
 
 /**
- * @summary
  * An inline container which presents an ellipsis when content overflows.
  *
  * @description
@@ -4338,5 +4516,211 @@ M3eTextOverflowElement = __decorate([
     t$2("m3e-text-overflow")
 ], M3eTextOverflowElement);
 
-export { AttachInternals, Checked, CheckedIndeterminate, ConstraintValidation, DesignToken, Dirty, Disabled, DisabledInteractive, EventAttribute, FocusController, Focusable, FormAssociated, FormSubmitter, HoverController, HtmlFor, IntersectionController, KeyboardClick, Labelled, LinkButton, LongPressController, M3eCollapsibleElement, M3eElevationElement, M3eFocusRingElement, M3ePseudoCheckboxElement, M3ePseudoRadioElement, M3eRippleElement, M3eScrollContainerElement, M3eSlide, M3eStateLayerElement, M3eTextOverflowElement, MutationController, PressedController, ReadOnly, Required, RequiredConstraintValidation, ResizeController, Role, ScrollController, Selected, Touched, Vertical, checkOrSelect, debounce, defaultValue, formValue, getTextContent, guid, hasAssignedNodes, hasKeys, internals, isAttachInternalsMixin, isCheckedIndeterminateMixin, isCheckedMixin, isCheckedOrSelected, isCheckedOrSelectedMixin, isConstraintValidationMixin, isDirtyMixin, isDisabledInteractiveMixin, isDisabledMixin, isFormAssociatedMixin, isFormSubmitterMixin, isHtmlForMixin, isLabelledMixin, isLinkButtonMixin, isReadOnlyMixin, isRequiredConstraintValidationMixin, isRequiredMixin, isSelectedMixin, isTouchedMixin, isVerticalMixin, prefersReducedMotion, renderPseudoLink, safeStyleMap, scrollIntoViewIfNeeded, validate };
+var _M3eTextHighlightElement_instances, _M3eTextHighlightElement_id, _M3eTextHighlightElement_ranges, _M3eTextHighlightElement_styles, _M3eTextHighlightElement_isTextNode, _M3eTextHighlightElement_findTextNodes, _M3eTextHighlightElement_highlight;
+var M3eTextHighlightElement_1;
+/**
+ * Highlights text which matches a given search term.
+ *
+ * @description
+ * Highlights all text ranges in slotted content that match a given search term using the CSS Custom Highlight API.
+ *
+ * @example
+ * The following example illustrates highlighting "Lor".
+ * ```html
+ * <m3e-text-highlight term="Lor">
+ *  <p>
+ *    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt
+ *    ut labore et dolore magna aliqua.
+ *  </p>
+ * </m3e-text-highlight>
+ * ```
+ *
+ * @tag m3e-text-highlight
+ *
+ * @slot - Renders the content to highlight.
+ *
+ * @attr case-sensitive - A value indicating whether matching is case sensitive.
+ * @attr disabled - A value indicating whether text highlighting is disabled.
+ * @attr term - The term to highlight.
+ *
+ * @fires highlight - Emitted when content is highlighted.
+ *
+ * @cssprop --m3e-text-highlight-container-color - Background color applied to highlighted text ranges.
+ * @cssprop --m3e-text-highlight-color - Foreground color of highlighted text content.
+ * @cssprop --m3e-text-highlight-decoration - Optional text decoration (e.g., underline, line-through) for highlighted text.
+ * @cssprop --m3e-text-highlight-shadow - Optional text shadow for emphasis or contrast.
+ */
+let M3eTextHighlightElement = M3eTextHighlightElement_1 = class M3eTextHighlightElement extends LitElement {
+    constructor() {
+        super();
+        _M3eTextHighlightElement_instances.add(this);
+        /** @private */ _M3eTextHighlightElement_id.set(this, `m3e-text-highlight-${M3eTextHighlightElement_1.__nextId++}`);
+        /** @private */ _M3eTextHighlightElement_ranges.set(this, new Array());
+        /** @private */ _M3eTextHighlightElement_styles.set(this, null);
+        /**
+         * A value indicating whether text highlighting is disabled.
+         * @default false
+         */
+        this.disabled = false;
+        /**
+         * The term to highlight.
+         * @default ""
+         */
+        this.term = "";
+        /**
+         * A value indicating whether matching is case sensitive.
+         * @default false
+         */
+        this.caseSensitive = false;
+        if (this.isSupported) {
+            __classPrivateFieldSet(this, _M3eTextHighlightElement_styles, new CSSStyleSheet(), "f");
+            __classPrivateFieldGet(this, _M3eTextHighlightElement_styles, "f").replaceSync(css `
+          ::highlight(${unsafeCSS(__classPrivateFieldGet(this, _M3eTextHighlightElement_id, "f"))}) {
+            background-color: var(--m3e-text-highlight-container-color, ${DesignToken.color.secondaryContainer});
+            color: var(--m3e-text-highlight-color, ${DesignToken.color.onSecondaryContainer});
+            text-decoration: var(--m3e-text-highlight-decoration);
+            text-shadow: var(--m3e-text-highlight-shadow);
+          }
+        `.toString());
+        }
+    }
+    /** A value indicating whether text highlighting is supported by the browser. */
+    get isSupported() {
+        return !isServer && CSS.highlights ? true : false;
+    }
+    /** The ranges that match the current term. */
+    get ranges() {
+        return __classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f");
+    }
+    /** @inheritdoc */
+    firstUpdated(_changedProperties) {
+        super.firstUpdated(_changedProperties);
+        if (this.shadowRoot && __classPrivateFieldGet(this, _M3eTextHighlightElement_styles, "f") && !this.shadowRoot.adoptedStyleSheets.includes(__classPrivateFieldGet(this, _M3eTextHighlightElement_styles, "f"))) {
+            this.shadowRoot.adoptedStyleSheets.push(__classPrivateFieldGet(this, _M3eTextHighlightElement_styles, "f"));
+        }
+    }
+    /** @inheritdoc */
+    updated(_changedProperties) {
+        super.updated(_changedProperties);
+        if (_changedProperties.has("term") ||
+            _changedProperties.has("caseSensitive") ||
+            _changedProperties.has("disabled")) {
+            __classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_highlight).call(this);
+        }
+    }
+    /** @inheritdoc */
+    render() {
+        return html `<slot @slotchange="${__classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_highlight)}"></slot>`;
+    }
+};
+_M3eTextHighlightElement_id = new WeakMap();
+_M3eTextHighlightElement_ranges = new WeakMap();
+_M3eTextHighlightElement_styles = new WeakMap();
+_M3eTextHighlightElement_instances = new WeakSet();
+_M3eTextHighlightElement_isTextNode = function _M3eTextHighlightElement_isTextNode(node) {
+    return /^(\\s|\\n)+$/gi.test(node.data) ? false : true;
+};
+_M3eTextHighlightElement_findTextNodes = function _M3eTextHighlightElement_findTextNodes(parent, nodes) {
+    if (parent instanceof HTMLSlotElement) {
+        parent.assignedElements({ flatten: true }).forEach((x) => {
+            switch (x.nodeType) {
+                case Node.TEXT_NODE:
+                    if (__classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_isTextNode).call(this, x)) {
+                        nodes.push(x);
+                    }
+                    break;
+                case Node.ELEMENT_NODE:
+                    __classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_findTextNodes).call(this, x, nodes);
+                    break;
+            }
+        });
+    }
+    else {
+        parent.childNodes.forEach((x) => {
+            switch (x.nodeType) {
+                case Node.TEXT_NODE:
+                    if (__classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_isTextNode).call(this, x)) {
+                        nodes.push(x);
+                    }
+                    break;
+                case Node.ELEMENT_NODE:
+                    __classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_findTextNodes).call(this, x, nodes);
+                    break;
+            }
+        });
+    }
+};
+_M3eTextHighlightElement_highlight = function _M3eTextHighlightElement_highlight() {
+    if (!this.isSupported || !this.isConnected)
+        return;
+    CSS.highlights.delete(__classPrivateFieldGet(this, _M3eTextHighlightElement_id, "f"));
+    __classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f").length = 0;
+    if (this.disabled)
+        return;
+    if (!this.term) {
+        this.dispatchEvent(new CustomEvent("highlight", {
+            detail: [...__classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f")],
+            bubbles: false,
+            composed: false,
+        }));
+        return;
+    }
+    const texts = new Array();
+    __classPrivateFieldGet(this, _M3eTextHighlightElement_instances, "m", _M3eTextHighlightElement_findTextNodes).call(this, this, texts);
+    const term = !this.caseSensitive ? this.term.toLowerCase() : this.term;
+    __classPrivateFieldSet(this, _M3eTextHighlightElement_ranges, texts
+        .map((x) => {
+        return {
+            el: x,
+            text: (!this.caseSensitive ? x.textContent?.toLowerCase() : x.textContent) ?? "",
+        };
+    })
+        .map(({ el, text }) => {
+        const indices = new Array();
+        let startPos = 0;
+        while (startPos < text.length) {
+            const index = text.indexOf(term, startPos);
+            if (index === -1)
+                break;
+            indices.push(index);
+            startPos = index + term.length;
+        }
+        return indices.map((index) => {
+            const range = new Range();
+            range.setStart(el, index);
+            range.setEnd(el, index + term.length);
+            return range;
+        });
+    })
+        .flat(), "f");
+    if (__classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f").length > 0) {
+        CSS.highlights.set(__classPrivateFieldGet(this, _M3eTextHighlightElement_id, "f"), new Highlight(...__classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f")));
+    }
+    this.dispatchEvent(new CustomEvent("highlight", {
+        detail: [...__classPrivateFieldGet(this, _M3eTextHighlightElement_ranges, "f")],
+        bubbles: false,
+        composed: false,
+    }));
+};
+/** The styles of the element. */
+M3eTextHighlightElement.styles = css `
+    :host {
+      display: contents;
+    }
+  `;
+/** @private */ M3eTextHighlightElement.__nextId = 0;
+__decorate([
+    n$1({ type: Boolean, reflect: true })
+], M3eTextHighlightElement.prototype, "disabled", void 0);
+__decorate([
+    n$1()
+], M3eTextHighlightElement.prototype, "term", void 0);
+__decorate([
+    n$1({ attribute: "case-sensitive", type: Boolean })
+], M3eTextHighlightElement.prototype, "caseSensitive", void 0);
+M3eTextHighlightElement = M3eTextHighlightElement_1 = __decorate([
+    t$2("m3e-text-highlight")
+], M3eTextHighlightElement);
+
+export { AttachInternals, Checked, CheckedIndeterminate, ConstraintValidation, DesignToken, Dirty, Disabled, DisabledInteractive, EventAttribute, FocusController, Focusable, FormAssociated, FormSubmitter, HoverController, HtmlFor, IntersectionController, KeyboardClick, Labelled, LinkButton, LongPressController, M3eCollapsibleElement, M3eElevationElement, M3eFocusRingElement, M3ePseudoCheckboxElement, M3ePseudoRadioElement, M3eRippleElement, M3eScrollContainerElement, M3eSlide, M3eStateLayerElement, M3eTextHighlightElement, M3eTextOverflowElement, MutationController, PressedController, ReadOnly, Required, RequiredConstraintValidation, ResizeController, Role, ScrollController, Selected, Touched, Vertical, checkOrSelect, debounce, defaultValue, formValue, getTextContent, guid, hasAssignedNodes, hasKeys, internals, isAttachInternalsMixin, isCheckedIndeterminateMixin, isCheckedMixin, isCheckedOrSelected, isCheckedOrSelectedMixin, isConstraintValidationMixin, isDirtyMixin, isDisabledInteractiveMixin, isDisabledMixin, isFormAssociatedMixin, isFormSubmitterMixin, isHtmlForMixin, isLabelledMixin, isLinkButtonMixin, isReadOnlyMixin, isRequiredConstraintValidationMixin, isRequiredMixin, isSelectedMixin, isTouchedMixin, isVerticalMixin, prefersReducedMotion, renderPseudoLink, safeStyleMap, scrollIntoViewIfNeeded, validate };
 //# sourceMappingURL=index.js.map