@react-hive/honey-utils 3.12.0 → 3.13.1

package/dist/index.dev.cjs

@@ -2,6 +2,216 @@
 /******/ 	"use strict";
 /******/ 	var __webpack_modules__ = ({
 
+/***/ "./src/a11y/focus/get-focusable-html-elements.ts":
+/*!*******************************************************!*\
+  !*** ./src/a11y/focus/get-focusable-html-elements.ts ***!
+  \*******************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getFocusableHtmlElements: () => (/* binding */ getFocusableHtmlElements)
+/* harmony export */ });
+/* harmony import */ var _is_html_element_focusable__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./is-html-element-focusable */ "./src/a11y/focus/is-html-element-focusable.ts");
+
+/**
+ * Collects all focusable descendant elements within a container.
+ *
+ * The function queries *all* elements under the container and filters them
+ * using `isHtmlElementFocusable`, producing a reliable list of elements
+ * that can receive keyboard focus in real-world browser conditions.
+ *
+ * @param container - The root container whose focusable children will be found.
+ *
+ * @returns An array of focusable HTMLElements in DOM order.
+ */
+const getFocusableHtmlElements = (container) => Array.from(container.querySelectorAll('*')).filter(_is_html_element_focusable__WEBPACK_IMPORTED_MODULE_0__.isHtmlElementFocusable);
+
+
+/***/ }),
+
+/***/ "./src/a11y/focus/index.ts":
+/*!*********************************!*\
+  !*** ./src/a11y/focus/index.ts ***!
+  \*********************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* reexport safe */ _is_html_element_focusable__WEBPACK_IMPORTED_MODULE_0__.FOCUSABLE_HTML_TAGS),
+/* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _get_focusable_html_elements__WEBPACK_IMPORTED_MODULE_1__.getFocusableHtmlElements),
+/* harmony export */   isHtmlElementFocusable: () => (/* reexport safe */ _is_html_element_focusable__WEBPACK_IMPORTED_MODULE_0__.isHtmlElementFocusable),
+/* harmony export */   moveFocusWithinContainer: () => (/* reexport safe */ _move_focus_within_container__WEBPACK_IMPORTED_MODULE_2__.moveFocusWithinContainer)
+/* harmony export */ });
+/* harmony import */ var _is_html_element_focusable__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./is-html-element-focusable */ "./src/a11y/focus/is-html-element-focusable.ts");
+/* harmony import */ var _get_focusable_html_elements__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./get-focusable-html-elements */ "./src/a11y/focus/get-focusable-html-elements.ts");
+/* harmony import */ var _move_focus_within_container__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./move-focus-within-container */ "./src/a11y/focus/move-focus-within-container.ts");
+
+
+
+
+
+/***/ }),
+
+/***/ "./src/a11y/focus/is-html-element-focusable.ts":
+/*!*****************************************************!*\
+  !*** ./src/a11y/focus/is-html-element-focusable.ts ***!
+  \*****************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* binding */ FOCUSABLE_HTML_TAGS),
+/* harmony export */   isHtmlElementFocusable: () => (/* binding */ isHtmlElementFocusable)
+/* harmony export */ });
+/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../../dom */ "./src/dom/index.ts");
+
+const FOCUSABLE_HTML_TAGS = ['INPUT', 'SELECT', 'TEXTAREA', 'BUTTON', 'A'];
+/**
+ * Determines whether an HTMLElement is focusable under standard browser rules.
+ *
+ * The function checks a combination of factors:
+ * - The element must be rendered (not `display: none` or `visibility: hidden`).
+ * - Disabled form controls are never focusable.
+ * - Elements with `tabindex="-1"` are intentionally removed from the focus order.
+ * - Certain native HTML elements are inherently focusable (e.g. inputs, buttons, anchors with `href`).
+ * - Elements with `contenteditable="true"` are treated as focusable.
+ * - Any element with a valid `tabindex` (not null) is considered focusable.
+ *
+ * This logic approximates how browsers and the accessibility tree
+ * determine real-world focusability—not just tabindex presence.
+ *
+ * @param element - The element to test. `null` or `undefined` will return `false`.
+ *
+ * @returns Whether the element is focusable.
+ */
+const isHtmlElementFocusable = (element) => {
+    if (!element) {
+        return false;
+    }
+    const style = window.getComputedStyle(element);
+    if (style.visibility === 'hidden' || style.display === 'none') {
+        return false;
+    }
+    if ('disabled' in element && element.disabled) {
+        return false;
+    }
+    // Explicitly removed from tab order
+    const tabIndex = element.getAttribute('tabindex');
+    if (tabIndex === '-1') {
+        return false;
+    }
+    if (FOCUSABLE_HTML_TAGS.includes(element.tagName)) {
+        if ((0,_dom__WEBPACK_IMPORTED_MODULE_0__.isAnchorHtmlElement)(element)) {
+            return element.href !== '';
+        }
+        return true;
+    }
+    if ((0,_dom__WEBPACK_IMPORTED_MODULE_0__.isContentEditableHtmlElement)(element)) {
+        return true;
+    }
+    return tabIndex !== null;
+};
+
+
+/***/ }),
+
+/***/ "./src/a11y/focus/move-focus-within-container.ts":
+/*!*******************************************************!*\
+  !*** ./src/a11y/focus/move-focus-within-container.ts ***!
+  \*******************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   moveFocusWithinContainer: () => (/* binding */ moveFocusWithinContainer)
+/* harmony export */ });
+/* harmony import */ var _get_focusable_html_elements__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./get-focusable-html-elements */ "./src/a11y/focus/get-focusable-html-elements.ts");
+
+/**
+ * Moves focus to the next or previous focusable element within a container.
+ *
+ * This utility is commonly used to implement accessible keyboard navigation patterns such as:
+ * - roving tabindex
+ * - custom dropdowns
+ * - tablists
+ * - menus
+ * - horizontal or vertical navigation groups
+ *
+ * Focus movement is scoped to a container and operates on the list of
+ * focusable descendants returned by `getFocusableHtmlElements`.
+ *
+ * @param direction - Direction in which focus should move (`'next'` or `'previous'`).
+ * @param container - Optional container that defines the focus scope.
+ *  If omitted, the parent element of the currently focused element is used.
+ * @param options - Optional configuration controlling wrapping behavior and custom index resolution.
+ *
+ * @remarks
+ * - This function reads from and mutates the document's focus state.
+ * - If no active element exists, no container can be resolved,
+ *   or the active element is not part of the focusable set, no action is taken.
+ * - When `getNextIndex` is provided, it fully overrides the default wrapping and directional logic.
+ */
+const moveFocusWithinContainer = (direction, container = null, { wrap = true, getNextIndex } = {}) => {
+    const activeElement = document.activeElement;
+    const scope = container ?? activeElement?.parentElement;
+    if (!activeElement || !scope) {
+        return;
+    }
+    const focusableElements = (0,_get_focusable_html_elements__WEBPACK_IMPORTED_MODULE_0__.getFocusableHtmlElements)(scope);
+    if (focusableElements.length === 0) {
+        return;
+    }
+    const currentIndex = focusableElements.indexOf(activeElement);
+    if (currentIndex === -1) {
+        return;
+    }
+    let nextIndex;
+    if (getNextIndex) {
+        nextIndex = getNextIndex(currentIndex, direction, focusableElements);
+    }
+    else {
+        if (direction === 'next') {
+            nextIndex = currentIndex + 1;
+            if (nextIndex >= focusableElements.length) {
+                nextIndex = wrap ? 0 : null;
+            }
+        }
+        else {
+            nextIndex = currentIndex - 1;
+            if (nextIndex < 0) {
+                nextIndex = wrap ? focusableElements.length - 1 : null;
+            }
+        }
+    }
+    if (nextIndex === null) {
+        return;
+    }
+    focusableElements[nextIndex]?.focus();
+};
+
+
+/***/ }),
+
+/***/ "./src/a11y/index.ts":
+/*!***************************!*\
+  !*** ./src/a11y/index.ts ***!
+  \***************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* reexport safe */ _focus__WEBPACK_IMPORTED_MODULE_0__.FOCUSABLE_HTML_TAGS),
+/* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _focus__WEBPACK_IMPORTED_MODULE_0__.getFocusableHtmlElements),
+/* harmony export */   isHtmlElementFocusable: () => (/* reexport safe */ _focus__WEBPACK_IMPORTED_MODULE_0__.isHtmlElementFocusable),
+/* harmony export */   moveFocusWithinContainer: () => (/* reexport safe */ _focus__WEBPACK_IMPORTED_MODULE_0__.moveFocusWithinContainer)
+/* harmony export */ });
+/* harmony import */ var _focus__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./focus */ "./src/a11y/focus/index.ts");
+
+
+
+/***/ }),
+
 /***/ "./src/array.ts":
 /*!**********************!*\
   !*** ./src/array.ts ***!
@@ -406,80 +616,19 @@ const findAsync = async (array, predicate) => {
 
 /***/ }),
 
-/***/ "./src/dom.ts":
-/*!********************!*\
-  !*** ./src/dom.ts ***!
-  \********************/
+/***/ "./src/dom/dom.ts":
+/*!************************!*\
+  !*** ./src/dom/dom.ts ***!
+  \************************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* binding */ FOCUSABLE_HTML_TAGS),
-/* harmony export */   calculateCenterOffset: () => (/* binding */ calculateCenterOffset),
-/* harmony export */   centerElementInContainer: () => (/* binding */ centerElementInContainer),
 /* harmony export */   cloneBlob: () => (/* binding */ cloneBlob),
-/* harmony export */   downloadFile: () => (/* binding */ downloadFile),
-/* harmony export */   getDOMRectIntersectionRatio: () => (/* binding */ getDOMRectIntersectionRatio),
 /* harmony export */   getElementOffsetRect: () => (/* binding */ getElementOffsetRect),
-/* harmony export */   getFocusableHtmlElements: () => (/* binding */ getFocusableHtmlElements),
-/* harmony export */   getLocalStorageCapabilities: () => (/* binding */ getLocalStorageCapabilities),
-/* harmony export */   getXOverflowWidth: () => (/* binding */ getXOverflowWidth),
-/* harmony export */   getYOverflowHeight: () => (/* binding */ getYOverflowHeight),
-/* harmony export */   hasXOverflow: () => (/* binding */ hasXOverflow),
-/* harmony export */   hasYOverflow: () => (/* binding */ hasYOverflow),
 /* harmony export */   isAnchorHtmlElement: () => (/* binding */ isAnchorHtmlElement),
-/* harmony export */   isContentEditableHtmlElement: () => (/* binding */ isContentEditableHtmlElement),
-/* harmony export */   isHtmlElementFocusable: () => (/* binding */ isHtmlElementFocusable),
-/* harmony export */   isLocalStorageReadable: () => (/* binding */ isLocalStorageReadable),
-/* harmony export */   moveFocusWithinContainer: () => (/* binding */ moveFocusWithinContainer),
-/* harmony export */   parse2DMatrix: () => (/* binding */ parse2DMatrix)
+/* harmony export */   isContentEditableHtmlElement: () => (/* binding */ isContentEditableHtmlElement)
 /* harmony export */ });
-/* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./guards */ "./src/guards.ts");
-/* harmony import */ var _string__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./string */ "./src/string.ts");
-
-
-const FOCUSABLE_HTML_TAGS = ['INPUT', 'SELECT', 'TEXTAREA', 'BUTTON', 'A'];
-/**
- * Extracts transformation values (translate, scale, skew) from the 2D transformation matrix of a given HTML element.
- *
- * Only works with 2D transforms (i.e., `matrix(a, b, c, d, e, f)`).
- *
- * @param element - The element with a CSS transform applied.
- * @returns An object with parsed transformation values.
- *
- * @example
- * ```ts
- * const values = parse2DMatrix(myElement);
- * console.log(values.translateX);
- * console.log(values.scaleX);
- * ```
- */
-const parse2DMatrix = (element) => {
-    const computedStyles = window.getComputedStyle(element);
-    const transformValue = computedStyles.getPropertyValue('transform');
-    const matrixMatch = transformValue.match(/^matrix\((.+)\)$/);
-    if (!matrixMatch) {
-        return {
-            translateX: 0,
-            translateY: 0,
-            scaleX: 1,
-            scaleY: 1,
-            skewX: 0,
-            skewY: 0,
-        };
-    }
-    const [scaleX, skewY, skewX, scaleY, translateX, translateY] = matrixMatch[1]
-        .split(', ')
-        .map(parseFloat);
-    return {
-        translateX,
-        translateY,
-        scaleX,
-        scaleY,
-        skewX,
-        skewY,
-    };
-};
 /**
  * Creates a clone of a Blob object.
  *
@@ -488,24 +637,6 @@ const parse2DMatrix = (element) => {
  * @returns A new Blob with the same content and type as the original.
  */
 const cloneBlob = (blob) => new Blob([blob], { type: blob.type });
-/**
- * Calculates the intersection ratio between two DOM rectangles.
- *
- * The ratio represents the proportion of the `targetRect` that is covered by `sourceRect`.
- * A value of `1` means `sourceRect` completely covers `targetRect`, and `0` means no overlap.
- *
- * @param sourceRect - The rectangle used to measure overlap against the target.
- * @param targetRect - The rectangle whose covered area is measured.
- *
- * @returns A number between `0` and `1` representing the intersection ratio.
- */
-const getDOMRectIntersectionRatio = (sourceRect, targetRect) => {
-    const xOverlap = Math.max(0, Math.min(sourceRect.right, targetRect.right) - Math.max(sourceRect.left, targetRect.left));
-    const yOverlap = Math.max(0, Math.min(sourceRect.bottom, targetRect.bottom) - Math.max(sourceRect.top, targetRect.top));
-    const intersectionArea = xOverlap * yOverlap;
-    const targetArea = targetRect.width * targetRect.height;
-    return intersectionArea / targetArea;
-};
 /**
  * Returns the bounding DOMRect of an element based on offset and client dimensions.
  *
@@ -540,125 +671,219 @@ const isAnchorHtmlElement = (element) => element.tagName === 'A';
  * @returns True if `contenteditable="true"` is set.
  */
 const isContentEditableHtmlElement = (element) => element.getAttribute('contenteditable') === 'true';
+
+
+/***/ }),
+
+/***/ "./src/dom/file/download-file.ts":
+/*!***************************************!*\
+  !*** ./src/dom/file/download-file.ts ***!
+  \***************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   downloadFile: () => (/* binding */ downloadFile)
+/* harmony export */ });
+/* harmony import */ var _string__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../../string */ "./src/string.ts");
+/* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../../guards */ "./src/guards.ts");
+
+
 /**
- * Determines whether an HTMLElement is focusable under standard browser rules.
+ * Initiates a file download in a browser environment.
  *
- * The function checks a combination of factors:
- * - The element must be rendered (not `display: none` or `visibility: hidden`).
- * - Disabled form controls are never focusable.
- * - Elements with `tabindex="-1"` are intentionally removed from the focus order.
- * - Certain native HTML elements are inherently focusable (e.g. inputs, buttons, anchors with `href`).
- * - Elements with `contenteditable="true"` are treated as focusable.
- * - Any element with a valid `tabindex` (not null) is considered focusable.
+ * This utility supports downloading from:
+ * - a URL string
+ * - a `Blob`
+ * - a `MediaSource`
  *
- * This logic approximates how browsers and the accessibility tree
- * determine real-world focusability—not just tabindex presence.
+ * For non-string inputs, an object URL is created temporarily and
+ * automatically revoked after the download is triggered.
  *
- * @param element - The element to test. `null` or `undefined` will return `false`.
+ * @remarks
+ * - This function performs direct DOM manipulation and must be executed  in a browser environment.
+ * - In non-DOM contexts (e.g. SSR), the function exits without side effects.
+ * - Object URLs are revoked asynchronously to avoid Safari-related issues.
  *
- * @returns Whether the element is focusable.
+ * @param file - The file source to download (URL string or binary object).
+ * @param options - Optional configuration controlling filename and link target.
  */
-const isHtmlElementFocusable = (element) => {
-    if (!element) {
-        return false;
-    }
-    // Hidden or not rendered
-    const style = window.getComputedStyle(element);
-    if (style.visibility === 'hidden' || style.display === 'none') {
-        return false;
-    }
-    if ('disabled' in element && element.disabled) {
-        return false;
-    }
-    // Explicitly removed from tab order
-    const tabIndex = element.getAttribute('tabindex');
-    if (tabIndex === '-1') {
-        return false;
+const downloadFile = (file, { fileName, target } = {}) => {
+    // Browser guard (SSR / non-DOM environments)
+    if ((0,_guards__WEBPACK_IMPORTED_MODULE_1__.isUndefined)(document)) {
+        return;
     }
-    if (FOCUSABLE_HTML_TAGS.includes(element.tagName)) {
-        if (isAnchorHtmlElement(element)) {
-            return element.href !== '';
+    const link = document.createElement('a');
+    let objectUrl = null;
+    try {
+        const href = (0,_string__WEBPACK_IMPORTED_MODULE_0__.isString)(file) ? file : (objectUrl = URL.createObjectURL(file));
+        link.href = href;
+        if (fileName) {
+            link.download = fileName;
         }
-        return true;
+        if (target) {
+            link.target = target;
+        }
+        // Required for Firefox / Safari
+        document.body.appendChild(link);
+        link.click();
     }
-    if (isContentEditableHtmlElement(element)) {
-        return true;
+    finally {
+        link.remove();
+        if (objectUrl) {
+            // Delay revocation to avoid Safari issues
+            setTimeout(() => {
+                (0,_guards__WEBPACK_IMPORTED_MODULE_1__.assert)(objectUrl, 'Object URL should not be null');
+                URL.revokeObjectURL(objectUrl);
+            }, 0);
+        }
     }
-    return tabIndex !== null;
 };
+
+
+/***/ }),
+
+/***/ "./src/dom/file/index.ts":
+/*!*******************************!*\
+  !*** ./src/dom/file/index.ts ***!
+  \*******************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   downloadFile: () => (/* reexport safe */ _download_file__WEBPACK_IMPORTED_MODULE_0__.downloadFile)
+/* harmony export */ });
+/* harmony import */ var _download_file__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./download-file */ "./src/dom/file/download-file.ts");
+
+
+
+/***/ }),
+
+/***/ "./src/dom/index.ts":
+/*!**************************!*\
+  !*** ./src/dom/index.ts ***!
+  \**************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   centerElementInContainer: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.centerElementInContainer),
+/* harmony export */   cloneBlob: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.cloneBlob),
+/* harmony export */   downloadFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_1__.downloadFile),
+/* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.getElementOffsetRect),
+/* harmony export */   getXOverflowWidth: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.getXOverflowWidth),
+/* harmony export */   getYOverflowHeight: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.getYOverflowHeight),
+/* harmony export */   hasXOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.hasXOverflow),
+/* harmony export */   hasYOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.hasYOverflow),
+/* harmony export */   isAnchorHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.isAnchorHtmlElement),
+/* harmony export */   isContentEditableHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.isContentEditableHtmlElement),
+/* harmony export */   parse2DMatrix: () => (/* reexport safe */ _transform__WEBPACK_IMPORTED_MODULE_3__.parse2DMatrix)
+/* harmony export */ });
+/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./dom */ "./src/dom/dom.ts");
+/* harmony import */ var _file__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./file */ "./src/dom/file/index.ts");
+/* harmony import */ var _layout__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./layout */ "./src/dom/layout/index.ts");
+/* harmony import */ var _transform__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./transform */ "./src/dom/transform/index.ts");
+
+
+
+
+
+
+/***/ }),
+
+/***/ "./src/dom/layout/center-element-in-container.ts":
+/*!*******************************************************!*\
+  !*** ./src/dom/layout/center-element-in-container.ts ***!
+  \*******************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   centerElementInContainer: () => (/* binding */ centerElementInContainer)
+/* harmony export */ });
+/* harmony import */ var _overflow__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./overflow */ "./src/dom/layout/overflow.ts");
+/* harmony import */ var _geometry__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../../geometry */ "./src/geometry/index.ts");
+
+
 /**
- * Collects all focusable descendant elements within a container.
- *
- * The function queries *all* elements under the container and filters them
- * using `isHtmlElementFocusable`, producing a reliable list of elements
- * that can receive keyboard focus in real-world browser conditions.
- *
- * @param container - The root container whose focusable children will be found.
- *
- * @returns An array of focusable HTMLElements in DOM order.
- */
-const getFocusableHtmlElements = (container) => Array.from(container.querySelectorAll('*')).filter(isHtmlElementFocusable);
-/**
- * Moves focus to the next or previous focusable element within a container.
+ * Translates a container so that a target element is visually centered within its visible bounds.
  *
- * This utility is commonly used to implement accessible keyboard navigation patterns such as:
- * - roving tabindex
- * - custom dropdowns
- * - tablists
- * - menus
- * - horizontal or vertical navigation groups
+ * Centering is achieved by applying a CSS `transform: translate(...)` to the
+ * container element rather than using native scrolling.
  *
- * Focus movement is scoped to a container and operates on the list of
- * focusable descendants returned by `getFocusableHtmlElements`.
+ * ### Behavior
+ * - Centering is calculated independently for each enabled axis.
+ * - Translation is applied only when the container content overflows on that axis.
+ * - When no overflow exists, the container remains untransformed for that axis.
  *
- * @param direction - Direction in which focus should move (`'next'` or `'previous'`).
- * @param container - Optional container that defines the focus scope.
- *  If omitted, the parent element of the currently focused element is used.
- * @param options - Optional configuration controlling wrapping behavior and custom index resolution.
+ * ### Notes
+ * - This function performs immediate DOM reads and writes.
+ * - The resulting transform is clamped to valid scrollable bounds.
  *
- * @remarks
- * - This function reads from and mutates the document's focus state.
- * - If no active element exists, no container can be resolved,
- *   or the active element is not part of the focusable set, no action is taken.
- * - When `getNextIndex` is provided, it fully overrides the default wrapping and directional logic.
+ * @param containerElement - The container whose content is translated.
+ * @param elementToCenter - The descendant element to align to the container’s center.
+ * @param options - Optional configuration controlling which axis or axes are centered.
  */
-const moveFocusWithinContainer = (direction, container = null, { wrap = true, getNextIndex } = {}) => {
-    const activeElement = document.activeElement;
-    const scope = container ?? activeElement?.parentElement;
-    if (!activeElement || !scope) {
-        return;
-    }
-    const focusableElements = getFocusableHtmlElements(scope);
-    if (focusableElements.length === 0) {
-        return;
-    }
-    const currentIndex = focusableElements.indexOf(activeElement);
-    if (currentIndex === -1) {
-        return;
-    }
-    let nextIndex;
-    if (getNextIndex) {
-        nextIndex = getNextIndex(currentIndex, direction, focusableElements);
-    }
-    else {
-        if (direction === 'next') {
-            nextIndex = currentIndex + 1;
-            if (nextIndex >= focusableElements.length) {
-                nextIndex = wrap ? 0 : null;
-            }
-        }
-        else {
-            nextIndex = currentIndex - 1;
-            if (nextIndex < 0) {
-                nextIndex = wrap ? focusableElements.length - 1 : null;
-            }
-        }
+const centerElementInContainer = (containerElement, elementToCenter, { axis = 'both' } = {}) => {
+    let translateX = 0;
+    let translateY = 0;
+    if (axis === 'x' || axis === 'both') {
+        translateX = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
+            overflowSize: (0,_overflow__WEBPACK_IMPORTED_MODULE_0__.getXOverflowWidth)(containerElement),
+            containerSize: containerElement.clientWidth,
+            elementOffset: elementToCenter.offsetLeft,
+            elementSize: elementToCenter.clientWidth,
+        });
     }
-    if (nextIndex === null) {
-        return;
+    if (axis === 'y' || axis === 'both') {
+        translateY = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
+            overflowSize: (0,_overflow__WEBPACK_IMPORTED_MODULE_0__.getYOverflowHeight)(containerElement),
+            containerSize: containerElement.clientHeight,
+            elementOffset: elementToCenter.offsetTop,
+            elementSize: elementToCenter.clientHeight,
+        });
     }
-    focusableElements[nextIndex]?.focus();
+    containerElement.style.transform = `translate(${translateX}px, ${translateY}px)`;
 };
+
+
+/***/ }),
+
+/***/ "./src/dom/layout/index.ts":
+/*!*********************************!*\
+  !*** ./src/dom/layout/index.ts ***!
+  \*********************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   centerElementInContainer: () => (/* reexport safe */ _center_element_in_container__WEBPACK_IMPORTED_MODULE_1__.centerElementInContainer),
+/* harmony export */   getXOverflowWidth: () => (/* reexport safe */ _overflow__WEBPACK_IMPORTED_MODULE_0__.getXOverflowWidth),
+/* harmony export */   getYOverflowHeight: () => (/* reexport safe */ _overflow__WEBPACK_IMPORTED_MODULE_0__.getYOverflowHeight),
+/* harmony export */   hasXOverflow: () => (/* reexport safe */ _overflow__WEBPACK_IMPORTED_MODULE_0__.hasXOverflow),
+/* harmony export */   hasYOverflow: () => (/* reexport safe */ _overflow__WEBPACK_IMPORTED_MODULE_0__.hasYOverflow)
+/* harmony export */ });
+/* harmony import */ var _overflow__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./overflow */ "./src/dom/layout/overflow.ts");
+/* harmony import */ var _center_element_in_container__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./center-element-in-container */ "./src/dom/layout/center-element-in-container.ts");
+
+
+
+
+/***/ }),
+
+/***/ "./src/dom/layout/overflow.ts":
+/*!************************************!*\
+  !*** ./src/dom/layout/overflow.ts ***!
+  \************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getXOverflowWidth: () => (/* binding */ getXOverflowWidth),
+/* harmony export */   getYOverflowHeight: () => (/* binding */ getYOverflowHeight),
+/* harmony export */   hasXOverflow: () => (/* binding */ hasXOverflow),
+/* harmony export */   hasYOverflow: () => (/* binding */ hasYOverflow)
+/* harmony export */ });
 /**
  * Checks whether an element has horizontal overflow.
  *
@@ -697,66 +922,126 @@ const hasYOverflow = (element) => element.scrollHeight > element.clientHeight;
  * @returns The overflow height in pixels. Returns `0` when the content does not overflow vertically.
  */
 const getYOverflowHeight = (element) => Math.max(0, element.scrollHeight - element.clientHeight);
+
+
+/***/ }),
+
+/***/ "./src/dom/transform/index.ts":
+/*!************************************!*\
+  !*** ./src/dom/transform/index.ts ***!
+  \************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   parse2DMatrix: () => (/* reexport safe */ _parse_2d_matrix__WEBPACK_IMPORTED_MODULE_0__.parse2DMatrix)
+/* harmony export */ });
+/* harmony import */ var _parse_2d_matrix__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./parse-2d-matrix */ "./src/dom/transform/parse-2d-matrix.ts");
+
+
+
+/***/ }),
+
+/***/ "./src/dom/transform/parse-2d-matrix.ts":
+/*!**********************************************!*\
+  !*** ./src/dom/transform/parse-2d-matrix.ts ***!
+  \**********************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   parse2DMatrix: () => (/* binding */ parse2DMatrix)
+/* harmony export */ });
 /**
- * Calculates the offset required to center an element within a container along a single axis.
- *
- * The returned value is clamped so that the resulting translation does not
- * exceed the container's scrollable bounds.
- *
- * This function performs pure math only and does not access the DOM.
- *
- * @returns A negative offset value suitable for use in a CSS `translate`
- * transform, or `0` when no overflow exists on the axis.
- */
-const calculateCenterOffset = ({ overflowSize, containerSize, elementOffset, elementSize, }) => {
-    if (overflowSize <= 0) {
-        return 0;
-    }
-    const containerCenter = containerSize / 2;
-    const elementCenter = elementOffset + elementSize / 2;
-    const targetOffset = elementCenter - containerCenter;
-    return -Math.max(0, Math.min(targetOffset, overflowSize));
-};
-/**
- * Translates a container so that a target element is visually centered within its visible bounds.
- *
- * Centering is achieved by applying a CSS `transform: translate(...)` to the
- * container element rather than using native scrolling.
+ * Extracts transformation values (translate, scale, skew) from the 2D transformation matrix of a given HTML element.
  *
- * ### Behavior
- * - Centering is calculated independently for each enabled axis.
- * - Translation is applied only when the container content overflows on that axis.
- * - When no overflow exists, the container remains untransformed for that axis.
+ * Only works with 2D transforms (i.e., `matrix(a, b, c, d, e, f)`).
  *
- * ### Notes
- * - This function performs immediate DOM reads and writes.
- * - The resulting transform is clamped to valid scrollable bounds.
+ * @param element - The element with a CSS transform applied.
+ * @returns An object with parsed transformation values.
  *
- * @param containerElement - The container whose content is translated.
- * @param elementToCenter - The descendant element to align to the container’s center.
- * @param options - Optional configuration controlling which axis or axes are centered.
+ * @example
+ * ```ts
+ * const values = parse2DMatrix(myElement);
+ * console.log(values.translateX);
+ * console.log(values.scaleX);
+ * ```
  */
-const centerElementInContainer = (containerElement, elementToCenter, { axis = 'both' } = {}) => {
-    let translateX = 0;
-    let translateY = 0;
-    if (axis === 'x' || axis === 'both') {
-        translateX = calculateCenterOffset({
-            overflowSize: getXOverflowWidth(containerElement),
-            containerSize: containerElement.clientWidth,
-            elementOffset: elementToCenter.offsetLeft,
-            elementSize: elementToCenter.clientWidth,
-        });
-    }
-    if (axis === 'y' || axis === 'both') {
-        translateY = calculateCenterOffset({
-            overflowSize: getYOverflowHeight(containerElement),
-            containerSize: containerElement.clientHeight,
-            elementOffset: elementToCenter.offsetTop,
-            elementSize: elementToCenter.clientHeight,
-        });
+const parse2DMatrix = (element) => {
+    const computedStyles = window.getComputedStyle(element);
+    const transformValue = computedStyles.getPropertyValue('transform');
+    const matrixMatch = transformValue.match(/^matrix\((.+)\)$/);
+    if (!matrixMatch) {
+        return {
+            translateX: 0,
+            translateY: 0,
+            scaleX: 1,
+            scaleY: 1,
+            skewX: 0,
+            skewY: 0,
+        };
     }
-    containerElement.style.transform = `translate(${translateX}px, ${translateY}px)`;
+    const [scaleX, skewY, skewX, scaleY, translateX, translateY] = matrixMatch[1]
+        .split(', ')
+        .map(parseFloat);
+    return {
+        translateX,
+        translateY,
+        scaleX,
+        scaleY,
+        skewX,
+        skewY,
+    };
 };
+
+
+/***/ }),
+
+/***/ "./src/env/index.ts":
+/*!**************************!*\
+  !*** ./src/env/index.ts ***!
+  \**************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getLocalStorageCapabilities: () => (/* reexport safe */ _storage__WEBPACK_IMPORTED_MODULE_0__.getLocalStorageCapabilities),
+/* harmony export */   isLocalStorageReadable: () => (/* reexport safe */ _storage__WEBPACK_IMPORTED_MODULE_0__.isLocalStorageReadable)
+/* harmony export */ });
+/* harmony import */ var _storage__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./storage */ "./src/env/storage/index.ts");
+
+
+
+/***/ }),
+
+/***/ "./src/env/storage/index.ts":
+/*!**********************************!*\
+  !*** ./src/env/storage/index.ts ***!
+  \**********************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getLocalStorageCapabilities: () => (/* reexport safe */ _local_storage__WEBPACK_IMPORTED_MODULE_0__.getLocalStorageCapabilities),
+/* harmony export */   isLocalStorageReadable: () => (/* reexport safe */ _local_storage__WEBPACK_IMPORTED_MODULE_0__.isLocalStorageReadable)
+/* harmony export */ });
+/* harmony import */ var _local_storage__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./local-storage */ "./src/env/storage/local-storage.ts");
+
+
+
+/***/ }),
+
+/***/ "./src/env/storage/local-storage.ts":
+/*!******************************************!*\
+  !*** ./src/env/storage/local-storage.ts ***!
+  \******************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getLocalStorageCapabilities: () => (/* binding */ getLocalStorageCapabilities),
+/* harmony export */   isLocalStorageReadable: () => (/* binding */ isLocalStorageReadable)
+/* harmony export */ });
 /**
  * Determines whether the browser environment allows safe read access to
  * `localStorage`. Some platforms (e.g., Safari Private Mode, sandboxed iframes)
@@ -823,56 +1108,6 @@ const getLocalStorageCapabilities = () => {
         writable: false,
     };
 };
-/**
- * Initiates a file download in a browser environment.
- *
- * This utility supports downloading from:
- * - a URL string
- * - a `Blob`
- * - a `MediaSource`
- *
- * For non-string inputs, an object URL is created temporarily and
- * automatically revoked after the download is triggered.
- *
- * @remarks
- * - This function performs direct DOM manipulation and must be executed  in a browser environment.
- * - In non-DOM contexts (e.g. SSR), the function exits without side effects.
- * - Object URLs are revoked asynchronously to avoid Safari-related issues.
- *
- * @param file - The file source to download (URL string or binary object).
- * @param options - Optional configuration controlling filename and link target.
- */
-const downloadFile = (file, { fileName, target } = {}) => {
-    // Browser guard (SSR / non-DOM environments)
-    if ((0,_guards__WEBPACK_IMPORTED_MODULE_0__.isUndefined)(document)) {
-        return;
-    }
-    const link = document.createElement('a');
-    let objectUrl = null;
-    try {
-        const href = (0,_string__WEBPACK_IMPORTED_MODULE_1__.isString)(file) ? file : (objectUrl = URL.createObjectURL(file));
-        link.href = href;
-        if (fileName) {
-            link.download = fileName;
-        }
-        if (target) {
-            link.target = target;
-        }
-        // Required for Firefox / Safari
-        document.body.appendChild(link);
-        link.click();
-    }
-    finally {
-        link.remove();
-        if (objectUrl) {
-            // Delay revocation to avoid Safari issues
-            setTimeout(() => {
-                (0,_guards__WEBPACK_IMPORTED_MODULE_0__.assert)(objectUrl, 'Object URL should not be null');
-                URL.revokeObjectURL(objectUrl);
-            }, 0);
-        }
-    }
-};
 
 
 /***/ }),
@@ -1294,6 +1529,72 @@ const once = (fn) => {
 };
 
 
+/***/ }),
+
+/***/ "./src/geometry/index.ts":
+/*!*******************************!*\
+  !*** ./src/geometry/index.ts ***!
+  \*******************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_0__.calculateCenterOffset)
+/* harmony export */ });
+/* harmony import */ var _layout__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./layout */ "./src/geometry/layout/index.ts");
+
+
+
+/***/ }),
+
+/***/ "./src/geometry/layout/calculate-center-offset.ts":
+/*!********************************************************!*\
+  !*** ./src/geometry/layout/calculate-center-offset.ts ***!
+  \********************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   calculateCenterOffset: () => (/* binding */ calculateCenterOffset)
+/* harmony export */ });
+/**
+ * Calculates the offset required to center an element within a container along a single axis.
+ *
+ * The returned value is clamped so that the resulting translation does not
+ * exceed the container's scrollable bounds.
+ *
+ * This function performs pure math only and does not access the DOM.
+ *
+ * @returns A negative offset value suitable for use in a CSS `translate`
+ * transform, or `0` when no overflow exists on the axis.
+ */
+const calculateCenterOffset = ({ overflowSize, containerSize, elementOffset, elementSize, }) => {
+    if (overflowSize <= 0) {
+        return 0;
+    }
+    const containerCenter = containerSize / 2;
+    const elementCenter = elementOffset + elementSize / 2;
+    const targetOffset = elementCenter - containerCenter;
+    return -Math.max(0, Math.min(targetOffset, overflowSize));
+};
+
+
+/***/ }),
+
+/***/ "./src/geometry/layout/index.ts":
+/*!**************************************!*\
+  !*** ./src/geometry/layout/index.ts ***!
+  \**************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _calculate_center_offset__WEBPACK_IMPORTED_MODULE_0__.calculateCenterOffset)
+/* harmony export */ });
+/* harmony import */ var _calculate_center_offset__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./calculate-center-offset */ "./src/geometry/layout/calculate-center-offset.ts");
+
+
+
 /***/ }),
 
 /***/ "./src/guards.ts":
@@ -1536,6 +1837,120 @@ const isInteger = (value) => isNumber(value) && Number.isInteger(value);
 const isDecimal = (value) => isFiniteNumber(value) && !Number.isInteger(value);
 
 
+/***/ }),
+
+/***/ "./src/intersection/get-dom-rect-intersection-ratio.ts":
+/*!*************************************************************!*\
+  !*** ./src/intersection/get-dom-rect-intersection-ratio.ts ***!
+  \*************************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getDOMRectIntersectionRatio: () => (/* binding */ getDOMRectIntersectionRatio)
+/* harmony export */ });
+/**
+ * Calculates the intersection ratio between two DOM rectangles.
+ *
+ * The ratio represents the proportion of the `targetRect` that is covered by `sourceRect`.
+ * A value of `1` means `sourceRect` completely covers `targetRect`, and `0` means no overlap.
+ *
+ * @param sourceRect - The rectangle used to measure overlap against the target.
+ * @param targetRect - The rectangle whose covered area is measured.
+ *
+ * @returns A number between `0` and `1` representing the intersection ratio.
+ */
+const getDOMRectIntersectionRatio = (sourceRect, targetRect) => {
+    const xOverlap = Math.max(0, Math.min(sourceRect.right, targetRect.right) - Math.max(sourceRect.left, targetRect.left));
+    const yOverlap = Math.max(0, Math.min(sourceRect.bottom, targetRect.bottom) - Math.max(sourceRect.top, targetRect.top));
+    const intersectionArea = xOverlap * yOverlap;
+    const targetArea = targetRect.width * targetRect.height;
+    return intersectionArea / targetArea;
+};
+
+
+/***/ }),
+
+/***/ "./src/intersection/index.ts":
+/*!***********************************!*\
+  !*** ./src/intersection/index.ts ***!
+  \***********************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _get_dom_rect_intersection_ratio__WEBPACK_IMPORTED_MODULE_0__.getDOMRectIntersectionRatio),
+/* harmony export */   resolveAxisDelta: () => (/* reexport safe */ _resolve_axis_delta__WEBPACK_IMPORTED_MODULE_1__.resolveAxisDelta)
+/* harmony export */ });
+/* harmony import */ var _get_dom_rect_intersection_ratio__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./get-dom-rect-intersection-ratio */ "./src/intersection/get-dom-rect-intersection-ratio.ts");
+/* harmony import */ var _resolve_axis_delta__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./resolve-axis-delta */ "./src/intersection/resolve-axis-delta.ts");
+
+
+
+
+/***/ }),
+
+/***/ "./src/intersection/resolve-axis-delta.ts":
+/*!************************************************!*\
+  !*** ./src/intersection/resolve-axis-delta.ts ***!
+  \************************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   resolveAxisDelta: () => (/* binding */ resolveAxisDelta)
+/* harmony export */ });
+/**
+ * Resolves a raw two-dimensional input delta into an axis-aligned delta
+ * according to the specified axis and resolution rules.
+ *
+ * This function is input-agnostic and does not perform any DOM mutations.
+ * It is intended to be used as a normalization step for wheel, drag,
+ * touch, or other pointer-based input before applying scroll physics.
+ *
+ * ### Resolution rules
+ * - `'x'`:
+ *   - Uses horizontal input when available.
+ *   - Optionally falls back to vertical input when horizontal input is zero.
+ * - `'y'`:
+ *   - Uses vertical input only.
+ * - `'both'`:
+ *   - Preserves both horizontal and vertical input.
+ *
+ * ### Direction handling
+ * - When `invert` is enabled, the resolved delta direction is inverted
+ *   to match typical synthetic scrolling behavior.
+ *
+ * @param delta - Raw input movement delta.
+ * @param axis - Axis along which movement should be resolved.
+ * @param options - Resolution behavior configuration.
+ *
+ * @returns A normalized, axis-aligned delta suitable for further scroll or movement processing.
+ */
+const resolveAxisDelta = (delta, axis, { allowFallback = true, invert = true } = {}) => {
+    const sign = invert ? -1 : 1;
+    switch (axis) {
+        case 'x': {
+            const value = delta.deltaX !== 0 ? delta.deltaX : allowFallback ? delta.deltaY : 0;
+            return {
+                deltaX: sign * value,
+                deltaY: 0,
+            };
+        }
+        case 'y':
+            return {
+                deltaX: 0,
+                deltaY: sign * delta.deltaY,
+            };
+        default:
+            return {
+                deltaX: sign * delta.deltaX,
+                deltaY: sign * delta.deltaY,
+            };
+    }
+};
+
+
 /***/ }),
 
 /***/ "./src/math.ts":
@@ -1834,10 +2249,10 @@ var __webpack_exports__ = {};
   \**********************/
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.FOCUSABLE_HTML_TAGS),
+/* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_11__.FOCUSABLE_HTML_TAGS),
 /* harmony export */   assert: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.assert),
 /* harmony export */   blobToFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.blobToFile),
-/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.calculateCenterOffset),
+/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _geometry__WEBPACK_IMPORTED_MODULE_9__.calculateCenterOffset),
 /* harmony export */   calculateEuclideanDistance: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_5__.calculateEuclideanDistance),
 /* harmony export */   calculateMovingSpeed: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_5__.calculateMovingSpeed),
 /* harmony export */   calculatePercentage: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_5__.calculatePercentage),
@@ -1857,10 +2272,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   filterParallel: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.filterParallel),
 /* harmony export */   filterSequential: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.filterSequential),
 /* harmony export */   findAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.findAsync),
-/* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getDOMRectIntersectionRatio),
+/* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_10__.getDOMRectIntersectionRatio),
 /* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getElementOffsetRect),
-/* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getFocusableHtmlElements),
-/* harmony export */   getLocalStorageCapabilities: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getLocalStorageCapabilities),
+/* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_11__.getFocusableHtmlElements),
+/* harmony export */   getLocalStorageCapabilities: () => (/* reexport safe */ _env__WEBPACK_IMPORTED_MODULE_12__.getLocalStorageCapabilities),
 /* harmony export */   getXOverflowWidth: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getXOverflowWidth),
 /* harmony export */   getYOverflowHeight: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.getYOverflowHeight),
 /* harmony export */   hasXOverflow: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.hasXOverflow),
@@ -1882,9 +2297,9 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.isFile),
 /* harmony export */   isFiniteNumber: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isFiniteNumber),
 /* harmony export */   isFunction: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.isFunction),
-/* harmony export */   isHtmlElementFocusable: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.isHtmlElementFocusable),
+/* harmony export */   isHtmlElementFocusable: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_11__.isHtmlElementFocusable),
 /* harmony export */   isInteger: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isInteger),
-/* harmony export */   isLocalStorageReadable: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.isLocalStorageReadable),
+/* harmony export */   isLocalStorageReadable: () => (/* reexport safe */ _env__WEBPACK_IMPORTED_MODULE_12__.isLocalStorageReadable),
 /* harmony export */   isMap: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isMap),
 /* harmony export */   isNil: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isNil),
 /* harmony export */   isNilOrEmptyString: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_1__.isNilOrEmptyString),
@@ -1898,7 +2313,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isSymbol: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isSymbol),
 /* harmony export */   isUndefined: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isUndefined),
 /* harmony export */   isValidDate: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_4__.isValidDate),
-/* harmony export */   moveFocusWithinContainer: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_6__.moveFocusWithinContainer),
+/* harmony export */   moveFocusWithinContainer: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_11__.moveFocusWithinContainer),
 /* harmony export */   noop: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.noop),
 /* harmony export */   not: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.not),
 /* harmony export */   once: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.once),
@@ -1907,6 +2322,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   pipe: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_2__.pipe),
 /* harmony export */   readFilesFromDataTransfer: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_7__.readFilesFromDataTransfer),
 /* harmony export */   reduceAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.reduceAsync),
+/* harmony export */   resolveAxisDelta: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_10__.resolveAxisDelta),
 /* harmony export */   retry: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_3__.retry),
 /* harmony export */   runParallel: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.runParallel),
 /* harmony export */   runSequential: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_0__.runSequential),
@@ -1923,9 +2339,17 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _function__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./function */ "./src/function.ts");
 /* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./guards */ "./src/guards.ts");
 /* harmony import */ var _math__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./math */ "./src/math.ts");
-/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./dom */ "./src/dom.ts");
+/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./dom */ "./src/dom/index.ts");
 /* harmony import */ var _file__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./file */ "./src/file.ts");
 /* harmony import */ var _object__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./object */ "./src/object.ts");
+/* harmony import */ var _geometry__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./geometry */ "./src/geometry/index.ts");
+/* harmony import */ var _intersection__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./intersection */ "./src/intersection/index.ts");
+/* harmony import */ var _a11y__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./a11y */ "./src/a11y/index.ts");
+/* harmony import */ var _env__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./env */ "./src/env/index.ts");
+
+
+
+