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

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,61 @@ 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 (!__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 +813,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 +886,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 +931,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 +969,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 +1046,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 +1101,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 +1785,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 +1827,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 +1838,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 +1894,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 +1937,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 +1970,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 +2004,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 +2027,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 +2040,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 +2059,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 +2095,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 +2124,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 +2145,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 +2230,7 @@ function ConstraintValidation(base) {
  */
 function EventAttribute(base, ...types) {
     class _EventAttribute extends base {
+        /** @inheritdoc */
         dispatchEvent(event) {
             if (types.includes(event.type)) {
                 const eventAttribute = this.getAttribute(`on${event.type}`);
@@ -2145,6 +2256,7 @@ function Focusable(base) {
     class _FocusableMixin extends base {
         constructor() {
             super(...arguments);
+            /** @private */
             this[_a] = 0;
         }
         /** @inheritdoc */
@@ -2152,12 +2264,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,7 +2314,12 @@ 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)) {
                     return;
@@ -2229,6 +2348,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 +2363,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,10 +2375,12 @@ 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]);
@@ -2296,15 +2422,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 +2454,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,12 +2486,15 @@ 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"));
@@ -2441,10 +2579,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 +2615,7 @@ function LinkButton(base) {
                 this.requestUpdate("download", old);
             }
         }
+        /** @inheritdoc */
         connectedCallback() {
             super.connectedCallback();
             this.addEventListener("click", this[_clickHandler]);
@@ -2467,10 +2623,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 +2700,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 +2738,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 +2778,7 @@ function isRequiredConstraintValidationMixin(value) {
  */
 function RequiredConstraintValidation(base) {
     class _RequiredConstraintValidation extends base {
+        /** @internal */
         [validate]() {
             const validity = super[validate]();
             if (!validity && this.required) {
@@ -2635,6 +2805,7 @@ function RequiredConstraintValidation(base) {
  */
 function Role(base, role) {
     class _RoleMixin extends base {
+        /** @inheritdoc */
         connectedCallback() {
             this.role = this.role || role;
             super.connectedCallback();
@@ -2661,8 +2832,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 +2916,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 +2951,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 +3106,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 +3359,6 @@ const FocusRingToken = {
 
 var _M3eFocusRingElement_instances, _M3eFocusRingElement_focusController, _M3eFocusRingElement_handleFocusChange;
 /**
- * @summary
  * A focus ring used to depict a strong focus indicator.
  *
  * @description
@@ -3372,7 +3546,6 @@ M3eFocusRingElement = __decorate([
 ], M3eFocusRingElement);
 
 /**
- * @summary
  * An element which looks like a checkbox.
  *
  * @description
@@ -3477,7 +3650,6 @@ M3ePseudoCheckboxElement = __decorate([
 ], M3ePseudoCheckboxElement);
 
 /**
- * @summary
  * An element which looks like a radio button.
  *
  * @description
@@ -3562,7 +3734,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 +3782,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 +4009,6 @@ M3eRippleElement = __decorate([
 
 var _M3eScrollContainerElement_scrollHandler;
 /**
- * @summary
  * A vertically oriented content container which presents dividers above and below content when scrolled.
  *
  * @description
@@ -3867,7 +4038,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 +4171,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 +4281,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 +4456,6 @@ M3eStateLayerElement = __decorate([
 ], M3eStateLayerElement);
 
 /**
- * @summary
  * An inline container which presents an ellipsis when content overflows.
  *
  * @description