@m3e/core 1.2.1 → 1.3.0

package/dist/index.js

@@ -154,6 +154,28 @@ class MonitorControllerBase {
 }
 _MonitorControllerBase_host = new WeakMap(), _MonitorControllerBase_target = new WeakMap(), _MonitorControllerBase_targets = new WeakMap();
 
+/**
+ * Computes a CSS size expression (var(), %, rem, calc(), etc.) relative to the given host element.
+ * @param {HTMLElement} host - The element whose coordinate system and CSS variables should be used to resolve the expression.
+ * @param {string} expression - The CSS expression to evaluate.
+ * @returns {number} The resolved pixel value.
+ */
+function computeCssSize(host, expression) {
+  if (!expression) return 0;
+  const temp = document.createElement("div");
+  temp.style.all = "inherit";
+  temp.style.width = expression;
+  temp.style.position = "absolute";
+  temp.style.visibility = "hidden";
+  temp.style.pointerEvents = "none";
+  host.appendChild(temp);
+  try {
+    return parseFloat(getComputedStyle(temp).width);
+  } finally {
+    temp.remove();
+  }
+}
+
 /**
  * Determines the number of textual lines presented by an element.
  * @param {HTMLElement} element The element for which to compute the number of lines.
@@ -172,8 +194,12 @@ function computeLineCount(element) {
  */
 async function focusWhenReady(element, timeout = 200) {
   element.focus();
+  function isFocused(element) {
+    const root = element.getRootNode();
+    return root instanceof ShadowRoot ? root.activeElement === element : document.activeElement === element;
+  }
   const start = performance.now();
-  while (element.shadowRoot?.activeElement !== element) {
+  while (!isFocused(element)) {
     if (!element.isConnected || performance.now() - start > timeout) {
       return false;
     }
@@ -645,6 +671,52 @@ function scrollIntoViewIfNeeded(element, scrollContainer, options) {
   }
 }
 
+var _VelocityTracker_samples, _VelocityTracker_windowMs;
+/** Utility for computing gesture velocity over a rolling time window. */
+class VelocityTracker {
+  /**
+   * @param {number} [windowMs = 100] The size of the rolling sampling window in milliseconds.
+   */
+  constructor(windowMs = 100) {
+    /** @private */_VelocityTracker_samples.set(this, []);
+    /** @private */
+    _VelocityTracker_windowMs.set(this, void 0);
+    __classPrivateFieldSet(this, _VelocityTracker_windowMs, windowMs, "f");
+  }
+  /**
+   * Adds a new sample to the tracker.
+   * @param {number} value The value in pixels.
+   * @param {number} [timestamp=performance.now()] The timestamp when `value` changed.
+   */
+  add(value, timestamp = performance.now()) {
+    __classPrivateFieldGet(this, _VelocityTracker_samples, "f").push({
+      y: value,
+      t: timestamp
+    });
+    const cutoff = timestamp - __classPrivateFieldGet(this, _VelocityTracker_windowMs, "f");
+    while (__classPrivateFieldGet(this, _VelocityTracker_samples, "f").length > 1 && __classPrivateFieldGet(this, _VelocityTracker_samples, "f")[0].t < cutoff) {
+      __classPrivateFieldGet(this, _VelocityTracker_samples, "f").shift();
+    }
+  }
+  /**
+   * Computes the current velocity in px/s.
+   * @returns The vertical velocity in pixels per second.
+   */
+  getVelocity() {
+    if (__classPrivateFieldGet(this, _VelocityTracker_samples, "f").length < 2) return 0;
+    const first = __classPrivateFieldGet(this, _VelocityTracker_samples, "f")[0];
+    const last = __classPrivateFieldGet(this, _VelocityTracker_samples, "f")[__classPrivateFieldGet(this, _VelocityTracker_samples, "f").length - 1];
+    const dy = last.y - first.y;
+    const dt = (last.t - first.t) / 1000;
+    return dt > 0 ? dy / dt : 0;
+  }
+  /** Clears all stored samples. */
+  reset() {
+    __classPrivateFieldGet(this, _VelocityTracker_samples, "f").length = 0;
+  }
+}
+_VelocityTracker_samples = new WeakMap(), _VelocityTracker_windowMs = new WeakMap();
+
 var _FocusController_instances, _FocusController_touch, _FocusController_callback, _FocusController_keyDownHandler, _FocusController_focusInHandler, _FocusController_focusOutHandler, _FocusController_touchStartHandler, _FocusController_touchEndHandler, _FocusController_hadKeydown, _FocusController_windowKeyDownHandler, _FocusController_windowPointerDownHandler, _FocusController_handleKeyDown, _FocusController_handleFocusIn, _FocusController_handleFocusOut;
 /** A `ReactiveController` used to monitor the focused state of one or more elements. */
 class FocusController extends MonitorControllerBase {
@@ -1385,6 +1457,75 @@ _ScrollController_debounce = new WeakMap(), _ScrollController_callback = new Wea
 };
 __decorate([debounce(40)], ScrollController.prototype, "_debounceCallback", null);
 
+var _ScrollLockController_instances, _ScrollLockController_locked, _ScrollLockController_scrollTop, _ScrollLockController_scrollLeft, _ScrollLockController_previousOverflow, _ScrollLockController_previousScrollbarGutter, _ScrollLockController_isVerticallyScrollable;
+/**
+ * A `ReactiveController` that provides safe, predictable scroll locking for modal UI
+ * surfaces (dialogs, bottom sheets, overlays).
+ */
+class ScrollLockController {
+  constructor(host) {
+    _ScrollLockController_instances.add(this);
+    /** @private */
+    _ScrollLockController_locked.set(this, false);
+    /** @private */
+    _ScrollLockController_scrollTop.set(this, 0);
+    /** @private */
+    _ScrollLockController_scrollLeft.set(this, 0);
+    /** @private */
+    _ScrollLockController_previousOverflow.set(this, "");
+    /** @private */
+    _ScrollLockController_previousScrollbarGutter.set(this, "");
+    host.addController(this);
+  }
+  /** Locks document scrolling only if scroll actually exists. */
+  lock() {
+    if (__classPrivateFieldGet(this, _ScrollLockController_locked, "f")) return;
+    __classPrivateFieldSet(this, _ScrollLockController_locked, true, "f");
+    // Save scroll position
+    __classPrivateFieldSet(this, _ScrollLockController_scrollTop, window.scrollY, "f");
+    __classPrivateFieldSet(this, _ScrollLockController_scrollLeft, window.scrollX, "f");
+    // Save existing inline styles
+    __classPrivateFieldSet(this, _ScrollLockController_previousOverflow, document.documentElement.style.overflow, "f");
+    __classPrivateFieldSet(this, _ScrollLockController_previousScrollbarGutter, document.documentElement.style.scrollbarGutter, "f");
+    // Only apply gutter if vertical scroll exists
+    if (__classPrivateFieldGet(this, _ScrollLockController_instances, "m", _ScrollLockController_isVerticallyScrollable).call(this)) {
+      document.documentElement.style.scrollbarGutter = "stable";
+    }
+    // Lock scroll
+    document.documentElement.style.overflow = "hidden";
+    // Freeze scroll position
+    window.scrollTo(__classPrivateFieldGet(this, _ScrollLockController_scrollLeft, "f"), __classPrivateFieldGet(this, _ScrollLockController_scrollTop, "f"));
+  }
+  /** Unlocks document scrolling and restores the previous state. */
+  unlock() {
+    if (!__classPrivateFieldGet(this, _ScrollLockController_locked, "f")) return;
+    __classPrivateFieldSet(this, _ScrollLockController_locked, false, "f");
+    // Restore previous inline styles
+    document.documentElement.style.overflow = __classPrivateFieldGet(this, _ScrollLockController_previousOverflow, "f");
+    document.documentElement.style.scrollbarGutter = __classPrivateFieldGet(this, _ScrollLockController_previousScrollbarGutter, "f");
+    // Restore scroll position
+    window.scrollTo(__classPrivateFieldGet(this, _ScrollLockController_scrollLeft, "f"), __classPrivateFieldGet(this, _ScrollLockController_scrollTop, "f"));
+  }
+  /** @inheritdoc */
+  hostDisconnected() {
+    this.unlock();
+  }
+}
+_ScrollLockController_locked = new WeakMap(), _ScrollLockController_scrollTop = new WeakMap(), _ScrollLockController_scrollLeft = new WeakMap(), _ScrollLockController_previousOverflow = new WeakMap(), _ScrollLockController_previousScrollbarGutter = new WeakMap(), _ScrollLockController_instances = new WeakSet(), _ScrollLockController_isVerticallyScrollable = function _ScrollLockController_isVerticallyScrollable() {
+  return document.documentElement.scrollHeight > document.documentElement.clientHeight;
+};
+
+/** Converts a space-separated attribute in to an array of strings. */
+const spaceSeparatedStringConverter = {
+  fromAttribute(value) {
+    if (!value) return [];
+    return value.split(/\s+/).map(d => d.trim()).filter(Boolean);
+  },
+  toAttribute(value) {
+    return value.join(" ");
+  }
+};
+
 /**
  * @license
  * Copyright 2017 Google LLC
@@ -5496,5 +5637,5 @@ __decorate([n$1({
 })], M3eTextHighlightElement.prototype, "caseSensitive", void 0);
 M3eTextHighlightElement = M3eTextHighlightElement_1 = __decorate([t$2("m3e-text-highlight")], M3eTextHighlightElement);
 
-export { ActionElementBase, AnimationLoopController, 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, M3eSlideElement, M3eStateLayerElement, M3eTextHighlightElement, M3eTextOverflowElement, MutationController, PressedController, ReadOnly, Required, RequiredConstraintValidation, ResizeController, Role, ScrollController, Selected, Touched, Vertical, checkOrSelect, computeLineCount, debounce, defaultValue, focusWhenReady, forcedColorsActive, formValue, generateClipPaths, getTextContent, guid, hasAssignedNodes, hasKeys, interceptProperty, internals, isAttachInternalsMixin, isCheckedIndeterminateMixin, isCheckedMixin, isCheckedOrSelected, isCheckedOrSelectedMixin, isConstraintValidationMixin, isDirtyMixin, isDisabledInteractiveMixin, isDisabledMixin, isFormAssociatedMixin, isFormSubmitterMixin, isHtmlForMixin, isLabelledMixin, isLinkButtonMixin, isReadOnlyMixin, isRequiredConstraintValidationMixin, isRequiredMixin, isSelectedMixin, isTouchedMixin, isVerticalMixin, prefersReducedMotion, renderPseudoLink, resolveElementById, resolveFragmentUrl, safeStyleMap, scrollIntoViewIfNeeded, updateLabels, validate };
+export { ActionElementBase, AnimationLoopController, 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, M3eSlideElement, M3eStateLayerElement, M3eTextHighlightElement, M3eTextOverflowElement, MutationController, PressedController, ReadOnly, Required, RequiredConstraintValidation, ResizeController, Role, ScrollController, ScrollLockController, Selected, Touched, VelocityTracker, Vertical, checkOrSelect, computeCssSize, computeLineCount, debounce, defaultValue, focusWhenReady, forcedColorsActive, formValue, generateClipPaths, getTextContent, guid, hasAssignedNodes, hasKeys, interceptProperty, internals, isAttachInternalsMixin, isCheckedIndeterminateMixin, isCheckedMixin, isCheckedOrSelected, isCheckedOrSelectedMixin, isConstraintValidationMixin, isDirtyMixin, isDisabledInteractiveMixin, isDisabledMixin, isFormAssociatedMixin, isFormSubmitterMixin, isHtmlForMixin, isLabelledMixin, isLinkButtonMixin, isReadOnlyMixin, isRequiredConstraintValidationMixin, isRequiredMixin, isSelectedMixin, isTouchedMixin, isVerticalMixin, prefersReducedMotion, renderPseudoLink, resolveElementById, resolveFragmentUrl, safeStyleMap, scrollIntoViewIfNeeded, spaceSeparatedStringConverter, updateLabels, validate };
 //# sourceMappingURL=index.js.map