@dnd-kit/dom 0.2.3 → 0.2.4-beta-20260118161656

package/utilities.d.cts

@@ -35,9 +35,11 @@ declare function getDocuments(rootDoc?: Document, seen?: Set<Document>): Documen
 
 declare function isSafari(): boolean;
 
+declare function getRoot(target: Event['target'] | undefined): Document | ShadowRoot;
+
 declare function cloneElement(element: Element): Element;
 
-declare function getElementFromPoint(document: Document, { x, y }: Coordinates): Element | null;
+declare function getElementFromPoint(root: Document | ShadowRoot, { x, y }: Coordinates): Element | null;
 
 declare const ProxiedElements: WeakMap<Element, Element>;
 
@@ -97,6 +99,7 @@ declare function canScroll(scrollableElement: Element, by?: Coordinates): {
 interface Options {
     limit?: number;
     excludeElement?: boolean;
+    escapeShadowDOM?: boolean;
 }
 declare function getScrollableAncestors(element: Node | null, options?: Options): Set<Element>;
 declare function getFirstScrollableAncestor(node: Node | null): Element | null;
@@ -196,6 +199,8 @@ declare class Styles {
  */
 declare function getComputedStyles(element: Element, cached?: boolean): CSSStyleDeclaration;
 
+declare function isDocument(node: Node): node is Document;
+
 declare function isElement(target: EventTarget | null): target is Element;
 
 declare function isHTMLElement(node: Node | Window | null | undefined): node is HTMLElement;
@@ -206,6 +211,8 @@ declare function isKeyboardEvent(event: Event | null | undefined): event is Keyb
 
 declare function isPointerEvent(event: Event | null | undefined): event is PointerEvent;
 
+declare function isShadowRoot(target: EventTarget | null): target is ShadowRoot;
+
 interface ViewTransition {
     ready: Promise<void>;
     updateCallbackDone: Promise<void>;
@@ -228,4 +235,4 @@ declare function getFrameElement(el: Element | undefined): Element | null | unde
 
 declare function getFrameTransform(el: Element | undefined, boundary?: Element | null): Transform;
 
-export { DOMRectangle, type DOMRectangleOptions, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, type Transform, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };
+export { DOMRectangle, type DOMRectangleOptions, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, type Transform, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getRoot, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocument, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isShadowRoot, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };

package/utilities.d.ts

@@ -35,9 +35,11 @@ declare function getDocuments(rootDoc?: Document, seen?: Set<Document>): Documen
 
 declare function isSafari(): boolean;
 
+declare function getRoot(target: Event['target'] | undefined): Document | ShadowRoot;
+
 declare function cloneElement(element: Element): Element;
 
-declare function getElementFromPoint(document: Document, { x, y }: Coordinates): Element | null;
+declare function getElementFromPoint(root: Document | ShadowRoot, { x, y }: Coordinates): Element | null;
 
 declare const ProxiedElements: WeakMap<Element, Element>;
 
@@ -97,6 +99,7 @@ declare function canScroll(scrollableElement: Element, by?: Coordinates): {
 interface Options {
     limit?: number;
     excludeElement?: boolean;
+    escapeShadowDOM?: boolean;
 }
 declare function getScrollableAncestors(element: Node | null, options?: Options): Set<Element>;
 declare function getFirstScrollableAncestor(node: Node | null): Element | null;
@@ -196,6 +199,8 @@ declare class Styles {
  */
 declare function getComputedStyles(element: Element, cached?: boolean): CSSStyleDeclaration;
 
+declare function isDocument(node: Node): node is Document;
+
 declare function isElement(target: EventTarget | null): target is Element;
 
 declare function isHTMLElement(node: Node | Window | null | undefined): node is HTMLElement;
@@ -206,6 +211,8 @@ declare function isKeyboardEvent(event: Event | null | undefined): event is Keyb
 
 declare function isPointerEvent(event: Event | null | undefined): event is PointerEvent;
 
+declare function isShadowRoot(target: EventTarget | null): target is ShadowRoot;
+
 interface ViewTransition {
     ready: Promise<void>;
     updateCallbackDone: Promise<void>;
@@ -228,4 +235,4 @@ declare function getFrameElement(el: Element | undefined): Element | null | unde
 
 declare function getFrameTransform(el: Element | undefined, boundary?: Element | null): Transform;
 
-export { DOMRectangle, type DOMRectangleOptions, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, type Transform, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };
+export { DOMRectangle, type DOMRectangleOptions, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, type Transform, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getRoot, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocument, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isShadowRoot, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };

package/utilities.js

@@ -71,8 +71,8 @@ function getWindow(target) {
 
 // src/utilities/type-guards/isDocument.ts
 function isDocument(node) {
-  const { Document } = getWindow(node);
-  return node instanceof Document || "nodeType" in node && node.nodeType === Node.DOCUMENT_NODE;
+  const { Document: Document2 } = getWindow(node);
+  return node instanceof Document2 || "nodeType" in node && node.nodeType === Node.DOCUMENT_NODE;
 }
 
 // src/utilities/type-guards/isHTMLElement.ts
@@ -232,6 +232,25 @@ function isSafari() {
   return /^((?!chrome|android).)*safari/i.test(navigator.userAgent);
 }
 
+// src/utilities/type-guards/isShadowRoot.ts
+function isShadowRoot(target) {
+  if (!target || !isNode(target)) return false;
+  return target instanceof getWindow(target).ShadowRoot;
+}
+
+// src/utilities/execution-context/getRoot.ts
+function getRoot(target) {
+  if (target && isNode(target)) {
+    let root = target.getRootNode();
+    if (isShadowRoot(root)) {
+      return root;
+    } else if (root instanceof Document) {
+      return root;
+    }
+  }
+  return getDocument(target);
+}
+
 // src/utilities/element/cloneElement.ts
 function cloneElement(element) {
   const selector = "input, textarea, select, canvas, [contenteditable]";
@@ -263,8 +282,8 @@ function isCanvasElement(element) {
 }
 
 // src/utilities/element/getElementFromPoint.ts
-function getElementFromPoint(document2, { x, y }) {
-  const element = document2.elementFromPoint(x, y);
+function getElementFromPoint(root, { x, y }) {
+  const element = root.elementFromPoint(x, y);
   if (isIFrameElement(element)) {
     const { contentDocument } = element;
     if (contentDocument) {
@@ -829,10 +848,11 @@ function isScrollable(element, computedStyle = getComputedStyles(element, true))
 
 // src/utilities/scroll/getScrollableAncestors.ts
 var defaultOptions = {
-  excludeElement: true
+  excludeElement: true,
+  escapeShadowDOM: true
 };
 function getScrollableAncestors(element, options = defaultOptions) {
-  const { limit, excludeElement } = options;
+  const { limit, excludeElement, escapeShadowDOM } = options;
   const scrollParents = /* @__PURE__ */ new Set();
   function findScrollableAncestors(node) {
     if (limit != null && scrollParents.size >= limit) {
@@ -845,6 +865,9 @@ function getScrollableAncestors(element, options = defaultOptions) {
       scrollParents.add(node.scrollingElement);
       return scrollParents;
     }
+    if (escapeShadowDOM && isShadowRoot(node)) {
+      return findScrollableAncestors(node.host);
+    }
     if (!isHTMLElement(node)) {
       if (isSVGElement(node)) {
         return findScrollableAncestors(node.parentElement);
@@ -1410,6 +1433,6 @@ function generateUniqueId(prefix) {
   return `${prefix}-${id}`;
 }
 
-export { DOMRectangle, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };
+export { DOMRectangle, Listeners, FrameObserver as PositionObserver, ProxiedElements, ResizeNotifier, Scheduler, ScrollDirection, Styles, animateTransform, canScroll, canUseDOM, cloneElement, computeTranslate, detectScrollIntent, generateUniqueId, getBoundingRectangle, getComputedStyles, getDocument, getDocuments, getElementFromPoint, getEventCoordinates, getFinalKeyframe, getFirstScrollableAncestor, getFrameElement, getFrameTransform, getRoot, getScrollableAncestors, getViewportBoundingRectangle, getVisibleBoundingRectangle, getWindow, hidePopover, inverseTransform, isDocument, isDocumentScrollingElement, isElement, isHTMLElement, isInteractiveElement, isKeyboardEvent, isKeyframeEffect, isPointerEvent, isSafari, isShadowRoot, isTextInput, parseTransform, parseTranslate, scheduler, scrollIntoViewIfNeeded, showPopover, supportsPopover, supportsStyle, supportsViewTransition, timeout };
 //# sourceMappingURL=utilities.js.map
 //# sourceMappingURL=utilities.js.map