@jsenv/dom 0.17.35 → 0.17.37

package/dist/jsenv_dom.js

@@ -7524,6 +7524,29 @@ const getScrollbarState = (
  * @param {"start"|"center"|"end"|"nearest"} [options.inline="nearest"] - Horizontal alignment.
  */
 const scrollIntoViewScoped = (
+  el,
+  { container = getScrollContainer(el), ...rest } = {},
+) => {
+  if (!container) {
+    return;
+  }
+  container.scrollTo(
+    getScrollIntoViewScopedOffsets(el, { container, ...rest }),
+  );
+};
+
+/**
+ * Where the container would have to be scrolled for `el` to be in view — the
+ * measure scrollIntoViewScoped acts on, handed out on its own for whoever must
+ * stand BETWEEN two such answers rather than land on one: a row of tabs
+ * scrolled the same fraction of the way as the slides it names are travelling
+ * (see navi's <Nav>).
+ *
+ * @param {Element} el
+ * @param {object} options - the same as scrollIntoViewScoped's.
+ * @returns {{left: number, top: number}}
+ */
+const getScrollIntoViewScopedOffsets = (
   el,
   {
     container = getScrollContainer(el),
@@ -7531,10 +7554,6 @@ const scrollIntoViewScoped = (
     inline = "nearest",
   } = {},
 ) => {
-  if (!container) {
-    return;
-  }
-
   const containerRect = container.getBoundingClientRect();
   const elRect = el.getBoundingClientRect();
   const style = getComputedStyle(el);
@@ -7609,10 +7628,10 @@ const scrollIntoViewScoped = (
     }
   }
 
-  container.scrollTo({
+  return {
     left: newScrollLeft,
     top: newScrollTop,
-  });
+  };
 };
 
 /**
@@ -9482,7 +9501,7 @@ const css$4 = /* css */`[data-drag-handle], [data-drag-source] {
   touch-action: pinch-zoom;
 }
 
-[data-drag-ignore], [data-own-target], [data-drag-source] [popover], [data-drag-source] dialog {
+[data-drag-ignore], [data-self-interactions~="drag"], [data-self-interactions~="*"], [data-drag-source] [popover], [data-drag-source] dialog {
   -webkit-touch-callout: default;
   touch-action: auto;
 }
@@ -11881,7 +11900,7 @@ const css$1 = /* css */`.navi_drop_hint {
   cursor: default;
 }
 
-[data-drag-ignore], [data-own-target], [data-drag-source] [popover], [data-drag-source] dialog {
+[data-drag-ignore], [data-self-interactions~="drag"], [data-self-interactions~="*"], [data-drag-source] [popover], [data-drag-source] dialog {
   cursor: auto;
 }
 
@@ -11946,15 +11965,19 @@ import.meta.css = [css$1, "@jsenv/dom/src/interaction/drag/drag_to.js"];
 
 // What a press must not be read from at all. `data-drag-ignore` is said by
 // something whose press is its own business — a text one wants to select, a
-// control that reads the pointer itself. `data-own-target` is the same fact said
-// once for every gesture there is: an element declaring that a press landing on
-// it is aimed AT it, whatever it happens to sit inside (see also
-// DRAG_EXCLUDED_SELECTOR in drag_to_travel.js). A popover or a dialog says it
-// without being asked: it is a layer OVER the surface, so a press in it is aimed
-// at the layer — yet it stays a descendant of whatever it is anchored in (a
-// callout next to a button, in the card that carries both), and the press
-// bubbles through the surface as if it had landed on it.
-const DRAG_IGNORED_SELECTOR = "[data-drag-ignore],[data-own-target],[popover],dialog";
+// control that reads the pointer itself — and it means every gesture at once.
+// `data-self-interactions` says a narrower thing, and says which: an element
+// declaring the interactions that are ITS own, whatever it happens to sit
+// inside, the rest being left to what it sits in. Only the ones naming `drag`
+// take the grab away from the surface (see also DRAG_EXCLUDED_SELECTOR in
+// drag_to_travel.js) — an affordance that took the click alone is one a finger
+// may still pick the object up by, which is what it is for when it covers a real
+// part of that object. A popover or a dialog says it without being asked: it is
+// a layer OVER the surface, so a press in it is aimed at the layer — yet it
+// stays a descendant of whatever it is anchored in (a callout next to a button,
+// in the card that carries both), and the press bubbles through the surface as
+// if it had landed on it.
+const DRAG_IGNORED_SELECTOR = '[data-drag-ignore],[data-self-interactions~="drag"],[data-self-interactions~="*"],[popover],dialog';
 
 /**
  * Starts a drag-to-reorder interaction on a list item.
@@ -13403,12 +13426,21 @@ const DRAG_RESISTANCE = 0.3;
 // out. A drag SOURCE is not either: it says which way it goes and only takes
 // that (see DRAG_SOURCE_AXES_ATTRIBUTE) — but a dedicated handle is, being a
 // place whose only purpose is to be taken hold of, from the first pixel. And so
-// is an OWN TARGET: an element saying a press landing on it is aimed at IT,
-// which is the same sentence said to every gesture at once rather than to this
-// one (see DRAG_IGNORED_SELECTOR in drag_to.js). And so is a popover or a
-// dialog: a layer OVER the box, whose press only bubbles through the box because
-// the layer is anchored in it.
-const DRAG_EXCLUDED_SELECTOR = ["input", "textarea", "select", '[contenteditable=""]', '[contenteditable="true"]', "[data-drag-handle]", "[data-no-drag-travel]", "[data-own-target]", "[popover]", "dialog"].join(",");
+// is an element naming `drag` among its own interactions: it said the grab is
+// ITS, here, rather than the box's — and one that named only the click said
+// nothing to this gesture and is passed through (see DRAG_IGNORED_SELECTOR in
+// drag_to.js). And so is a popover or a dialog: a layer OVER the box, whose
+// press only bubbles through the box because the layer is anchored in it.
+const DRAG_EXCLUDED_SELECTOR = [
+// The fields that read the pointer as it MOVES: a caret dragged through text,
+// a thumb pushed along its rail, a spinner. The ones that only read the
+// press — a checkbox, a radio, a colour, a file — are buttons by another
+// name, and like a button they let the drag through, the click they would
+// have made swallowed on the way out. Which matters more than the list makes
+// it look: a selectable row is covered by an invisible radio of its own, so
+// excluding every input at once means a list of rows inside a travelling box
+// that no finger can push.
+'input:not([type="checkbox"], [type="radio"], [type="button"], [type="submit"], [type="reset"], [type="image"], [type="color"], [type="file"])', "textarea", "select", '[contenteditable=""]', '[contenteditable="true"]', "[data-drag-handle]", "[data-no-drag-travel]", '[data-self-interactions~="drag"]', '[data-self-interactions~="*"]', "[popover]", "dialog"].join(",");
 
 // Which axes a box travels on, one attribute per gesture, said in the DOM by
 // whoever owns the box: it is what a box ABOVE another reads to know the
@@ -20055,4 +20087,4 @@ const useResizeStatus = (elementRef, { as = "number" } = {}) => {
   };
 };
 
-export { EASING, ELEMENT_SIZE_CHANGE, activeElementSignal, addActiveElementEffect, addAttributeEffect, allowWheelThrough, appendStyles, applyNewPosition, canScroll, captureScrollState, chainEvent, claimWheelGesture, clickIsSuppressed, closestOpenableAncestor, contrastColor, createBackgroundColorTransition, createBackgroundTransition, createBorderRadiusTransition, createBorderTransition, createDragGestureController, createDragToMoveGestureController, createEventGroupLogger, createGroupTransitionController, createHeightTransition, createIterableWeakSet, createOpacityTransition, createPubSub, createStyleController, createTimelineTransition, createTransition, createTranslateXTransition, createValueEffect, createWidthTransition, cubicBezier, dispatchCustomEvent, dispatchInternalCustomEvent, dispatchPublicCustomEvent, dragAfterIntent, elementIsFocusable, elementIsVisibleForFocus, elementIsVisuallyVisible, findAfter, findAncestor, findBefore, findDescendant, findEvent, findFocusDelegateTarget, findFocusable, findSelfOrAncestorFixedPosition, formatEventSideEffect, getAncestorOpenType, getAvailableHeight, getAvailableWidth, getBackground, getBackgroundColor, getBorder, getBorderRadius, getBorderSizes, getContrastRatio, getDefaultStyles, getDragCoordinates, getDropTargetInfo, getElementSignature, getFirstVisuallyVisibleAncestor, getFocusVisibilityInfo, getHeight, getHeightWithoutTransition, getInnerHeight, getInnerWidth, getKeyboardEventDefaultAction, getLuminance, getMarginSizes, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpacity, getOpacityWithoutTransition, getPaddingSizes, getPositionedParent, getPositioningScrollOffset, getPreferedColorScheme, getScrollBox, getScrollContainer, getScrollContainerSet, getScrollRelativeRect, getSelfAndAncestorScrolls, getStyle, getTranslateX, getTranslateXWithoutTransition, getTranslateY, getVirtualKeyboardOverlayHeight, getVisuallyVisibleInfo, getWidth, getWidthWithoutTransition, hasCSSSizeUnit, initFlexDetailsSet, initFocusGroup, initPositionSticky, isAncestorOpen, isDisplayedDespiteClosedAncestor, isPrimaryButtonEvent, isSameColor, isScrollable, isTouchDrivenEvent, markDragSource, measureLongestVisualLineWidth, measureScrollbar, measureWidestChildRow, mergeOneStyle, mergeTwoStyles, normalizeKeyboardKey, normalizeStyle, normalizeStyles, observeAncestorOpenState, onAncestorReopen, parsePositionArea, parseStyle, performTabNavigation, pickPositionRelativeTo, prefersDarkColors, prefersLightColors, preventFocusNav, preventFocusNavViaKeyboard, preventIntermediateScrollbar, releaseWheelGesture, resolveCSSColor, resolveCSSSize, resolveColorLuminance, resolveOklchLightness, scrollIntoViewScoped, scrollIntoViewWithStickyAwareness, scrollRoomTowards, setAttribute, setAttributes, setStyles, setVirtualKeyboardOverlaysContent, snapToPixel, startDragTo, startDragToResizeGesture, startDragToTravel, stickyAsRelativeCoords, stringifyStyle, subscribeVirtualKeyboardGeometryChange, subscribeVisualViewportResizeSettled, subscribeWindowResizeSettled, suppressClickAfterGesture, trapFocusInside, trapScrollInside, useActiveElement, useAvailableHeight, useAvailableWidth, useMaxHeight, useMaxWidth, useResizeStatus, visibleRectEffect, waitForPressHeld, watchWheelTravel, wheelGestureIsTakenFrom };
+export { EASING, ELEMENT_SIZE_CHANGE, activeElementSignal, addActiveElementEffect, addAttributeEffect, allowWheelThrough, appendStyles, applyNewPosition, canScroll, captureScrollState, chainEvent, claimWheelGesture, clickIsSuppressed, closestOpenableAncestor, contrastColor, createBackgroundColorTransition, createBackgroundTransition, createBorderRadiusTransition, createBorderTransition, createDragGestureController, createDragToMoveGestureController, createEventGroupLogger, createGroupTransitionController, createHeightTransition, createIterableWeakSet, createOpacityTransition, createPubSub, createStyleController, createTimelineTransition, createTransition, createTranslateXTransition, createValueEffect, createWidthTransition, cubicBezier, dispatchCustomEvent, dispatchInternalCustomEvent, dispatchPublicCustomEvent, dragAfterIntent, elementIsFocusable, elementIsVisibleForFocus, elementIsVisuallyVisible, findAfter, findAncestor, findBefore, findDescendant, findEvent, findFocusDelegateTarget, findFocusable, findSelfOrAncestorFixedPosition, formatEventSideEffect, getAncestorOpenType, getAvailableHeight, getAvailableWidth, getBackground, getBackgroundColor, getBorder, getBorderRadius, getBorderSizes, getContrastRatio, getDefaultStyles, getDragCoordinates, getDropTargetInfo, getElementSignature, getFirstVisuallyVisibleAncestor, getFocusVisibilityInfo, getHeight, getHeightWithoutTransition, getInnerHeight, getInnerWidth, getKeyboardEventDefaultAction, getLuminance, getMarginSizes, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpacity, getOpacityWithoutTransition, getPaddingSizes, getPositionedParent, getPositioningScrollOffset, getPreferedColorScheme, getScrollBox, getScrollContainer, getScrollContainerSet, getScrollIntoViewScopedOffsets, getScrollRelativeRect, getSelfAndAncestorScrolls, getStyle, getTranslateX, getTranslateXWithoutTransition, getTranslateY, getVirtualKeyboardOverlayHeight, getVisuallyVisibleInfo, getWidth, getWidthWithoutTransition, hasCSSSizeUnit, initFlexDetailsSet, initFocusGroup, initPositionSticky, isAncestorOpen, isDisplayedDespiteClosedAncestor, isPrimaryButtonEvent, isSameColor, isScrollable, isTouchDrivenEvent, markDragSource, measureLongestVisualLineWidth, measureScrollbar, measureWidestChildRow, mergeOneStyle, mergeTwoStyles, normalizeKeyboardKey, normalizeStyle, normalizeStyles, observeAncestorOpenState, onAncestorReopen, parsePositionArea, parseStyle, performTabNavigation, pickPositionRelativeTo, prefersDarkColors, prefersLightColors, preventFocusNav, preventFocusNavViaKeyboard, preventIntermediateScrollbar, releaseWheelGesture, resolveCSSColor, resolveCSSSize, resolveColorLuminance, resolveOklchLightness, scrollIntoViewScoped, scrollIntoViewWithStickyAwareness, scrollRoomTowards, setAttribute, setAttributes, setStyles, setVirtualKeyboardOverlaysContent, snapToPixel, startDragTo, startDragToResizeGesture, startDragToTravel, stickyAsRelativeCoords, stringifyStyle, subscribeVirtualKeyboardGeometryChange, subscribeVisualViewportResizeSettled, subscribeWindowResizeSettled, suppressClickAfterGesture, trapFocusInside, trapScrollInside, useActiveElement, useAvailableHeight, useAvailableWidth, useMaxHeight, useMaxWidth, useResizeStatus, visibleRectEffect, waitForPressHeld, watchWheelTravel, wheelGestureIsTakenFrom };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/dom",
-  "version": "0.17.35",
+  "version": "0.17.37",
   "type": "module",
   "description": "DOM utilities for writing frontend code",
   "repository": {