@t007/utils 0.0.28 → 0.0.30

package/README.md

@@ -151,10 +151,10 @@ All defaults are exposed as root-level, `t007`-prefixed variables:
   /** default scroll assist values */
   --t007-scroll-assist-color: rgb(0 0 0 / 1);
   --t007-scroll-assist-opacity: 0.07;
-  --t007-scroll-assist-min-width: 2rem;
+  --t007-scroll-assist-width: 2rem;
   --t007-scroll-assist-height: 2rem;
-  --t007-scroll-assist-inline-offset: -0.35rem;
-  --t007-scroll-assist-block-offset: 0;
+  --t007-scroll-assist-inset-x: -0.35rem;
+  --t007-scroll-assist-inset-y: 0;
 }
 
 /** custom pre-requisites */

package/dist/{chunk-OGFBI6PS.js → chunk-RXMKMD3E.js}

@@ -1,4 +1,4 @@
-// src/hooks/react/useHighlight.ts
+// src/ts/hooks/react/useHighlight.ts
 import { useMemo } from "react";
 function useHighlight(text, query, ignoreCase = true, options) {
   const { trimQuery = true, wholeWord = false } = options ?? {};

package/dist/{chunk-N5KX6IW4.js → chunk-Y5YJMRXD.js}

@@ -1,4 +1,4 @@
-// src/core/dom.ts
+// src/ts/core/dom.ts
 import { createEl, assignEl } from "sia-reactor/utils";
 import { getActiveEl } from "sia-reactor/utils";
 var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable='true'],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
@@ -31,11 +31,14 @@ function loadResource(req, type = "style", { module, media, crossOrigin, integri
   });
   return w.t007._resourceCache[src];
 }
+function getWindow(el = window) {
+  return (el instanceof Window ? el : el instanceof Document ? el?.defaultView : el?.ownerDocument?.defaultView) ?? void 0;
+}
 
-// src/index.ts
+// src/ts/index.ts
 import { NIL, NOOP } from "sia-reactor";
 
-// src/core/obj.ts
+// src/ts/core/obj.ts
 import { isObj } from "sia-reactor/utils";
 function isDef(val) {
   return "undefined" !== typeof val;
@@ -68,10 +71,10 @@ function inBoolArrOpt(opt, str) {
   return opt?.includes?.(str) ?? opt;
 }
 
-// src/core/num.ts
+// src/ts/core/num.ts
 import { clamp } from "sia-reactor/utils";
 
-// src/core/str.ts
+// src/ts/core/str.ts
 function uid(prefix = "") {
   return prefix + Date.now().toString(36) + "_" + performance.now().toString(36).replace(".", "") + "_" + Math.random().toString(36).slice(2);
 }
@@ -97,7 +100,7 @@ function isSameURL(src1, src2) {
   }
 }
 
-// src/core/fn.ts
+// src/ts/core/fn.ts
 import { setTimeout as setTimeout2, setInterval, requestAnimationFrame } from "sia-reactor/utils";
 function limited(FN_KEY, fn, opts = {}) {
   let count = 0, { key, maxTimes: max = 1 } = isStr(opts) ? { key: opts } : opts;
@@ -121,20 +124,20 @@ function bindCleanupToSignal(cleanup, signal) {
   return cleanup;
 }
 
-// src/core/keys.ts
+// src/ts/core/keys.ts
 import { parseKeyCombo, stringifyKeyEvent, cleanKeyCombo, matchKeys, getTermsForKey, keyEventAllowed, formatKeyForDisplay, formatKeyShortcutsForDisplay, parseForARIAKS } from "sia-reactor/utils";
 
-// src/core/file.ts
+// src/ts/core/file.ts
 function formatSize(bytes, decimals = 3, base = 1e3) {
   if (bytes < base) return `${bytes} byte${bytes == 1 ? "" : "s"}`;
   const units = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"], exponent = Math.min(Math.floor(Math.log(bytes) / Math.log(base)), units.length - 1);
   return `${(bytes / Math.pow(base, exponent)).toFixed(decimals).replace(/\.0+$/, "")} ${units[exponent]}`;
 }
 
-// src/mixins/methd.ts
+// src/ts/mixins/methd.ts
 import { onAllMethods, bindAllMethods, guardAllMethods, guardMethod } from "sia-reactor/utils";
 
-// src/index.ts
+// src/ts/index.ts
 if ("undefined" !== typeof window) {
   (window.t007 ??= {}).VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
   window.T007_TOAST_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest`;
@@ -152,6 +155,7 @@ export {
   isInteractive,
   VIRTUAL_RESOURCE,
   loadResource,
+  getWindow,
   getActiveEl,
   isObj,
   isDef,

package/dist/{chunk-NLR4ANGT.js → chunk-YDARUYLO.js}

@@ -4,9 +4,9 @@ import {
   createEl,
   getActiveEl,
   isInteractive
-} from "./chunk-N5KX6IW4.js";
+} from "./chunk-Y5YJMRXD.js";
 
-// src/hooks/vanilla/outsideClick.ts
+// src/ts/hooks/vanilla/outsideClick.ts
 import { NIL, NOOP } from "sia-reactor";
 function initOutsideClick(el, { enabled = false, onOutsideClick = NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = NIL) {
   const stacks = t007._outsiders_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._outsiders ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -29,7 +29,7 @@ function initOutsideClick(el, { enabled = false, onOutsideClick = NOOP, outOnCli
 }
 var removeOutsideClick = (el) => t007._outsiders?.get(el)?.();
 
-// src/hooks/vanilla/focusTrap.ts
+// src/ts/hooks/vanilla/focusTrap.ts
 import { NIL as NIL2 } from "sia-reactor";
 function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true } = NIL2) {
   const stacks = t007._ftrappers_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._ftrappers ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -40,9 +40,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
     if (rt.hasAttribute("tabindex")) return rt.focus();
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
-    const ceiling = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
-    let p = rt.parentElement || ceiling, all = getFocusable(p);
-    while (p !== ceiling && (!all.length || rt.contains(all[0]) && rt.contains(all.at(-1)))) all = getFocusable(p = p.parentElement || ceiling);
+    const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
+    let p = rt.parentElement || ceil, all = getFocusable(p);
+    while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
     for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
     (pre ? first : last).blur();
   }, handleFocusIn = () => {
@@ -64,7 +64,7 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
 }
 var removeFocusTrap = (el) => t007._ftrappers?.get(el)?.();
 
-// src/hooks/vanilla/ripple.ts
+// src/ts/hooks/vanilla/ripple.ts
 import { NIL as NIL3 } from "sia-reactor";
 function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t007-ripple-wrapper", className = "t007-ripple", holdClassName = "t007-ripple-hold", fadeClassName = "t007-ripple-fade" } = NIL3) {
   const el = target || e.currentTarget;
@@ -83,7 +83,7 @@ function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t00
   for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).addEventListener(evt, release);
 }
 
-// src/hooks/react/useArrowNavigation/utils.ts
+// src/ts/hooks/react/useArrowNavigation/utils.ts
 var getTargetIndex = ({ key, currIndex, length, gridX, gridY, vGridY, loop, ctrlKey = false, rtl }) => {
   const rowStart = currIndex - currIndex % gridX, rowEnd = Math.min(rowStart + gridX - 1, length - 1), colStart = currIndex % gridX, colEnd = Math.min(colStart + gridX * (gridY - 1), length - 1), canX = gridX > 1, canY = gridY > 1, horizontalMove = rtl ? { ArrowRight: canX ? -1 : 0, ArrowLeft: canX ? 1 : 0 } : { ArrowRight: canX ? 1 : 0, ArrowLeft: canX ? -1 : 0 }, move = { ...horizontalMove, ArrowDown: canY ? gridX : 0, ArrowUp: canY ? -gridX : 0, Home: ctrlKey ? 0 : rowStart, End: ctrlKey ? length - 1 : rowEnd, PageDown: (vGridY - 1) * gridX, PageUp: -(vGridY - 1) * gridX }[key] ?? 0;
   let targetIndex = key === "Home" || key === "End" ? move : currIndex + move;
@@ -127,7 +127,7 @@ var getGrid = (all, x = true, y = true, vY = true) => {
   return grid;
 };
 
-// src/hooks/react/useArrowNavigation/consts.ts
+// src/ts/hooks/react/useArrowNavigation/consts.ts
 import { NOOP as NOOP2 } from "sia-reactor";
 var H_NAV_KEYS = ["ArrowRight", "ArrowLeft", "Home", "End"];
 var V_NAV_KEYS = ["ArrowUp", "ArrowDown", "PageDown", "PageUp"];

package/dist/components/react.cjs

@@ -17,14 +17,14 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/components/react.ts
+// src/ts/components/react.ts
 var react_exports = {};
 __export(react_exports, {
   HighlightText: () => HighlightText
 });
 module.exports = __toCommonJS(react_exports);
 
-// src/hooks/react/useHighlight.ts
+// src/ts/hooks/react/useHighlight.ts
 var import_react = require("react");
 function useHighlight(text, query, ignoreCase = true, options) {
   const { trimQuery = true, wholeWord = false } = options ?? {};
@@ -37,7 +37,7 @@ function useHighlight(text, query, ignoreCase = true, options) {
   }, [text, query, ignoreCase, trimQuery, wholeWord]);
 }
 
-// src/components/react/HighlightText.tsx
+// src/ts/components/react/HighlightText.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var HighlightText = ({ children = "", query = "", className = "highlight", ignoreCase = true, trimQuery = true, wholeWord = false }) => {
   const chunks = useHighlight(children, query, ignoreCase, { trimQuery, wholeWord });

package/dist/components/react.js

@@ -1,8 +1,8 @@
 import {
   useHighlight
-} from "../chunk-OGFBI6PS.js";
+} from "../chunk-RXMKMD3E.js";
 
-// src/components/react/HighlightText.tsx
+// src/ts/components/react/HighlightText.tsx
 import { Fragment, jsx } from "react/jsx-runtime";
 var HighlightText = ({ children = "", query = "", className = "highlight", ignoreCase = true, trimQuery = true, wholeWord = false }) => {
   const chunks = useHighlight(children, query, ignoreCase, { trimQuery, wholeWord });

package/dist/hooks/react.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/hooks/react.ts
+// src/ts/hooks/react.ts
 var react_exports = {};
 __export(react_exports, {
   useArrowNavigation: () => useArrowNavigation,
@@ -29,19 +29,19 @@ __export(react_exports, {
 });
 module.exports = __toCommonJS(react_exports);
 
-// src/hooks/react/useScrollAssist.ts
+// src/ts/hooks/react/useScrollAssist.ts
 var import_react = require("react");
 
-// src/core/num.ts
+// src/ts/core/num.ts
 var import_utils = require("sia-reactor/utils");
 
-// src/core/dom.ts
+// src/ts/core/dom.ts
 var import_utils2 = require("sia-reactor/utils");
 var import_utils3 = require("sia-reactor/utils");
 var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable='true'],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
 var isInteractive = (target) => target instanceof HTMLElement && target.matches(INTERACTIVE_SELECTOR);
 
-// src/hooks/react/useScrollAssist.ts
+// src/ts/hooks/react/useScrollAssist.ts
 var import_sia_reactor = require("sia-reactor");
 function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = import_sia_reactor.NIL) {
   const scrollId = (0, import_react.useRef)(null), last = (0, import_react.useRef)(performance.now()), assists = (0, import_react.useRef)({}), assistWidth = (0, import_react.useRef)(20), assistHeight = (0, import_react.useRef)(20);
@@ -120,10 +120,10 @@ function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassNam
   return { update };
 }
 
-// src/hooks/react/useOutsideClick.ts
+// src/ts/hooks/react/useOutsideClick.ts
 var import_react2 = require("react");
 
-// src/hooks/vanilla/outsideClick.ts
+// src/ts/hooks/vanilla/outsideClick.ts
 var import_sia_reactor2 = require("sia-reactor");
 function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_reactor2.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor2.NIL) {
   const stacks = t007._outsiders_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._outsiders ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -145,16 +145,16 @@ function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_rea
   return t007._outsiders.set(el, destroy), destroy;
 }
 
-// src/hooks/react/useOutsideClick.ts
+// src/ts/hooks/react/useOutsideClick.ts
 var import_sia_reactor3 = require("sia-reactor");
 function useOutsideClick(ref, config = import_sia_reactor3.NIL) {
   (0, import_react2.useEffect)(() => ref.current ? initOutsideClick(ref.current, config) : void 0, [ref, config.enabled, config.onOutsideClick, config.outOnEscape, config.outOnClick, config.outOnFocusOut, config.allowInputs, config.root, config.scoped, config.capture]);
 }
 
-// src/hooks/react/useArrowNavigation/index.ts
+// src/ts/hooks/react/useArrowNavigation/index.ts
 var import_react3 = require("react");
 
-// src/hooks/react/useArrowNavigation/utils.ts
+// src/ts/hooks/react/useArrowNavigation/utils.ts
 var getTargetIndex = ({ key, currIndex, length, gridX, gridY, vGridY, loop, ctrlKey = false, rtl }) => {
   const rowStart = currIndex - currIndex % gridX, rowEnd = Math.min(rowStart + gridX - 1, length - 1), colStart = currIndex % gridX, colEnd = Math.min(colStart + gridX * (gridY - 1), length - 1), canX = gridX > 1, canY = gridY > 1, horizontalMove = rtl ? { ArrowRight: canX ? -1 : 0, ArrowLeft: canX ? 1 : 0 } : { ArrowRight: canX ? 1 : 0, ArrowLeft: canX ? -1 : 0 }, move = { ...horizontalMove, ArrowDown: canY ? gridX : 0, ArrowUp: canY ? -gridX : 0, Home: ctrlKey ? 0 : rowStart, End: ctrlKey ? length - 1 : rowEnd, PageDown: (vGridY - 1) * gridX, PageUp: -(vGridY - 1) * gridX }[key] ?? 0;
   let targetIndex = key === "Home" || key === "End" ? move : currIndex + move;
@@ -198,7 +198,7 @@ var getGrid = (all, x = true, y = true, vY = true) => {
   return grid;
 };
 
-// src/hooks/react/useArrowNavigation/consts.ts
+// src/ts/hooks/react/useArrowNavigation/consts.ts
 var import_sia_reactor4 = require("sia-reactor");
 var H_NAV_KEYS = ["ArrowRight", "ArrowLeft", "Home", "End"];
 var V_NAV_KEYS = ["ArrowUp", "ArrowDown", "PageDown", "PageUp"];
@@ -224,9 +224,9 @@ var DEFAULT_CONFIG = {
   onFocusOut: import_sia_reactor4.NOOP
 };
 
-// src/hooks/react/useArrowNavigation/index.ts
+// src/ts/hooks/react/useArrowNavigation/index.ts
 function useArrowNavigation(containerRef, config = {}) {
-  const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, rovingTab, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut } = { ...DEFAULT_CONFIG, ...config }, [gridX, setGridX] = (0, import_react3.useState)(grid.x || 1), [gridY, setGridY] = (0, import_react3.useState)(grid.y || 1), [vGridY, setVGridY] = (0, import_react3.useState)(grid.vY || 1), [activeIndex, setActiveIndex] = (0, import_react3.useState)(-1), buffer = (0, import_react3.useRef)(""), timeout = (0, import_react3.useRef)(null), itemsRef = (0, import_react3.useRef)([]), enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = (0, import_react3.useMemo)(() => isRtl !== null ? isRtl : getComputedStyle(containerRef.current || document.body).direction === "rtl", [containerRef, isRtl]), mutationObserverRef = (0, import_react3.useRef)(null), shouldSnub = (0, import_react3.useCallback)(() => !enabled || !containerRef.current, [enabled, containerRef]), isItemDisabled = (0, import_react3.useCallback)((el) => !el ? true : el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), []), getItems = (0, import_react3.useCallback)(() => itemsRef.current = Array.from(containerRef.current?.querySelectorAll(selector) || []), [containerRef, selector]);
+  const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, rovingTab, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut } = { ...DEFAULT_CONFIG, ...config }, [gridX, setGridX] = (0, import_react3.useState)(grid.x || 1), [gridY, setGridY] = (0, import_react3.useState)(grid.y || 1), [vGridY, setVGridY] = (0, import_react3.useState)(grid.vY || 1), [activeIndex, setActiveIndex] = (0, import_react3.useState)(-1), buffer = (0, import_react3.useRef)(""), timeout = (0, import_react3.useRef)(null), itemsRef = (0, import_react3.useRef)([]), enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = (0, import_react3.useMemo)(() => isRtl ?? ("undefined" === typeof document ? false : getComputedStyle(containerRef.current || document.body).direction === "rtl"), [containerRef, isRtl]), mutationObserverRef = (0, import_react3.useRef)(null), shouldSnub = (0, import_react3.useCallback)(() => !enabled || !containerRef.current, [enabled, containerRef]), isItemDisabled = (0, import_react3.useCallback)((el) => !el ? true : el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), []), getItems = (0, import_react3.useCallback)(() => itemsRef.current = Array.from(containerRef.current?.querySelectorAll(selector) || []), [containerRef, selector]);
   const getAbleIndex = (0, import_react3.useCallback)(
     (targetIndex, e = { key: "ArrowRight", ctrlKey: false }) => {
       if (shouldSnub()) return;
@@ -373,10 +373,10 @@ function useArrowNavigation(containerRef, config = {}) {
   return { gridX, gridY, vGridY, activeIndex, activeItem: (0, import_react3.useCallback)(() => itemsRef.current[activeIndex] ?? null, [activeIndex]), items: (0, import_react3.useCallback)(() => itemsRef.current, []), getAbleIndex, typeAhead, goToIndex, simulateKey };
 }
 
-// src/hooks/react/useFocusTrap.ts
+// src/ts/hooks/react/useFocusTrap.ts
 var import_react4 = require("react");
 
-// src/hooks/vanilla/focusTrap.ts
+// src/ts/hooks/vanilla/focusTrap.ts
 var import_sia_reactor5 = require("sia-reactor");
 function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true } = import_sia_reactor5.NIL) {
   const stacks = t007._ftrappers_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._ftrappers ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -387,9 +387,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
     if (rt.hasAttribute("tabindex")) return rt.focus();
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
-    const ceiling = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
-    let p = rt.parentElement || ceiling, all = getFocusable(p);
-    while (p !== ceiling && (!all.length || rt.contains(all[0]) && rt.contains(all.at(-1)))) all = getFocusable(p = p.parentElement || ceiling);
+    const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
+    let p = rt.parentElement || ceil, all = getFocusable(p);
+    while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
     for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
     (pre ? first : last).blur();
   }, handleFocusIn = () => {
@@ -410,13 +410,13 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
   return t007._ftrappers.set(el, destroy), destroy;
 }
 
-// src/hooks/react/useFocusTrap.ts
+// src/ts/hooks/react/useFocusTrap.ts
 var import_sia_reactor6 = require("sia-reactor");
 function useFocusTrap(ref, config = import_sia_reactor6.NIL) {
   (0, import_react4.useEffect)(() => ref.current ? initFocusTrap(ref.current, config) : void 0, [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture]);
 }
 
-// src/hooks/react/useHighlight.ts
+// src/ts/hooks/react/useHighlight.ts
 var import_react5 = require("react");
 function useHighlight(text, query, ignoreCase = true, options) {
   const { trimQuery = true, wholeWord = false } = options ?? {};
@@ -429,10 +429,10 @@ function useHighlight(text, query, ignoreCase = true, options) {
   }, [text, query, ignoreCase, trimQuery, wholeWord]);
 }
 
-// src/hooks/react/useRipple.ts
+// src/ts/hooks/react/useRipple.ts
 var import_react6 = require("react");
 
-// src/hooks/vanilla/ripple.ts
+// src/ts/hooks/vanilla/ripple.ts
 var import_sia_reactor7 = require("sia-reactor");
 function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t007-ripple-wrapper", className = "t007-ripple", holdClassName = "t007-ripple-hold", fadeClassName = "t007-ripple-fade" } = import_sia_reactor7.NIL) {
   const el = target || e.currentTarget;
@@ -451,7 +451,7 @@ function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t00
   for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).addEventListener(evt, release);
 }
 
-// src/hooks/react/useRipple.ts
+// src/ts/hooks/react/useRipple.ts
 var import_sia_reactor8 = require("sia-reactor");
 function useRipple() {
   return (0, import_react6.useCallback)((e, config = import_sia_reactor8.NIL) => rippleHandler(e.nativeEvent, config), []);

package/dist/hooks/react.js

@@ -1,6 +1,6 @@
 import {
   useHighlight
-} from "../chunk-OGFBI6PS.js";
+} from "../chunk-RXMKMD3E.js";
 import {
   DEFAULT_CONFIG,
   H_NAV_KEYS,
@@ -11,13 +11,13 @@ import {
   initFocusTrap,
   initOutsideClick,
   rippleHandler
-} from "../chunk-NLR4ANGT.js";
+} from "../chunk-YDARUYLO.js";
 import {
   INTERACTIVE_SELECTOR,
   getActiveEl
-} from "../chunk-N5KX6IW4.js";
+} from "../chunk-Y5YJMRXD.js";
 
-// src/hooks/react/useScrollAssist.ts
+// src/ts/hooks/react/useScrollAssist.ts
 import { useEffect, useRef, useCallback } from "react";
 import { NIL } from "sia-reactor";
 function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = NIL) {
@@ -97,17 +97,17 @@ function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassNam
   return { update };
 }
 
-// src/hooks/react/useOutsideClick.ts
+// src/ts/hooks/react/useOutsideClick.ts
 import { useEffect as useEffect2 } from "react";
 import { NIL as NIL2 } from "sia-reactor";
 function useOutsideClick(ref, config = NIL2) {
   useEffect2(() => ref.current ? initOutsideClick(ref.current, config) : void 0, [ref, config.enabled, config.onOutsideClick, config.outOnEscape, config.outOnClick, config.outOnFocusOut, config.allowInputs, config.root, config.scoped, config.capture]);
 }
 
-// src/hooks/react/useArrowNavigation/index.ts
+// src/ts/hooks/react/useArrowNavigation/index.ts
 import { useEffect as useEffect3, useState, useCallback as useCallback2, useRef as useRef2, useMemo } from "react";
 function useArrowNavigation(containerRef, config = {}) {
-  const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, rovingTab, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut } = { ...DEFAULT_CONFIG, ...config }, [gridX, setGridX] = useState(grid.x || 1), [gridY, setGridY] = useState(grid.y || 1), [vGridY, setVGridY] = useState(grid.vY || 1), [activeIndex, setActiveIndex] = useState(-1), buffer = useRef2(""), timeout = useRef2(null), itemsRef = useRef2([]), enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = useMemo(() => isRtl !== null ? isRtl : getComputedStyle(containerRef.current || document.body).direction === "rtl", [containerRef, isRtl]), mutationObserverRef = useRef2(null), shouldSnub = useCallback2(() => !enabled || !containerRef.current, [enabled, containerRef]), isItemDisabled = useCallback2((el) => !el ? true : el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), []), getItems = useCallback2(() => itemsRef.current = Array.from(containerRef.current?.querySelectorAll(selector) || []), [containerRef, selector]);
+  const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, rovingTab, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut } = { ...DEFAULT_CONFIG, ...config }, [gridX, setGridX] = useState(grid.x || 1), [gridY, setGridY] = useState(grid.y || 1), [vGridY, setVGridY] = useState(grid.vY || 1), [activeIndex, setActiveIndex] = useState(-1), buffer = useRef2(""), timeout = useRef2(null), itemsRef = useRef2([]), enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = useMemo(() => isRtl ?? ("undefined" === typeof document ? false : getComputedStyle(containerRef.current || document.body).direction === "rtl"), [containerRef, isRtl]), mutationObserverRef = useRef2(null), shouldSnub = useCallback2(() => !enabled || !containerRef.current, [enabled, containerRef]), isItemDisabled = useCallback2((el) => !el ? true : el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), []), getItems = useCallback2(() => itemsRef.current = Array.from(containerRef.current?.querySelectorAll(selector) || []), [containerRef, selector]);
   const getAbleIndex = useCallback2(
     (targetIndex, e = { key: "ArrowRight", ctrlKey: false }) => {
       if (shouldSnub()) return;
@@ -254,14 +254,14 @@ function useArrowNavigation(containerRef, config = {}) {
   return { gridX, gridY, vGridY, activeIndex, activeItem: useCallback2(() => itemsRef.current[activeIndex] ?? null, [activeIndex]), items: useCallback2(() => itemsRef.current, []), getAbleIndex, typeAhead, goToIndex, simulateKey };
 }
 
-// src/hooks/react/useFocusTrap.ts
+// src/ts/hooks/react/useFocusTrap.ts
 import { useEffect as useEffect4 } from "react";
 import { NIL as NIL3 } from "sia-reactor";
 function useFocusTrap(ref, config = NIL3) {
   useEffect4(() => ref.current ? initFocusTrap(ref.current, config) : void 0, [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture]);
 }
 
-// src/hooks/react/useRipple.ts
+// src/ts/hooks/react/useRipple.ts
 import { useCallback as useCallback3 } from "react";
 import { NIL as NIL4 } from "sia-reactor";
 function useRipple() {

package/dist/hooks/vanilla.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/hooks/vanilla.ts
+// src/ts/hooks/vanilla.ts
 var vanilla_exports = {};
 __export(vanilla_exports, {
   initArrowNavigation: () => initArrowNavigation,
@@ -33,19 +33,19 @@ __export(vanilla_exports, {
 });
 module.exports = __toCommonJS(vanilla_exports);
 
-// src/hooks/vanilla/scrollAssist.ts
+// src/ts/hooks/vanilla/scrollAssist.ts
 var import_sia_reactor = require("sia-reactor");
 
-// src/core/dom.ts
+// src/ts/core/dom.ts
 var import_utils = require("sia-reactor/utils");
 var import_utils2 = require("sia-reactor/utils");
 var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable='true'],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
 var isInteractive = (target) => target instanceof HTMLElement && target.matches(INTERACTIVE_SELECTOR);
 
-// src/core/num.ts
+// src/ts/core/num.ts
 var import_utils3 = require("sia-reactor/utils");
 
-// src/hooks/vanilla/scrollAssist.ts
+// src/ts/hooks/vanilla/scrollAssist.ts
 function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = import_sia_reactor.NIL) {
   const parent = el?.parentElement, existing = (t007._scrollers ??= /* @__PURE__ */ new WeakMap()).get(el);
   if (!parent || existing) return existing ? existing : void 0;
@@ -117,7 +117,7 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll
 }
 var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
 
-// src/hooks/vanilla/scrollerator.ts
+// src/ts/hooks/vanilla/scrollerator.ts
 var import_sia_reactor2 = require("sia-reactor");
 function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = import_sia_reactor2.NIL) {
   let linesPerSec = baseSpeed, accelId = null, lastTime = null;
@@ -134,7 +134,7 @@ function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, base
   return { drive, reset };
 }
 
-// src/hooks/vanilla/outsideClick.ts
+// src/ts/hooks/vanilla/outsideClick.ts
 var import_sia_reactor3 = require("sia-reactor");
 function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_reactor3.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor3.NIL) {
   const stacks = t007._outsiders_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._outsiders ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -157,7 +157,7 @@ function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_rea
 }
 var removeOutsideClick = (el) => t007._outsiders?.get(el)?.();
 
-// src/hooks/vanilla/focusTrap.ts
+// src/ts/hooks/vanilla/focusTrap.ts
 var import_sia_reactor4 = require("sia-reactor");
 function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true } = import_sia_reactor4.NIL) {
   const stacks = t007._ftrappers_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._ftrappers ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -168,9 +168,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
     if (rt.hasAttribute("tabindex")) return rt.focus();
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
-    const ceiling = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
-    let p = rt.parentElement || ceiling, all = getFocusable(p);
-    while (p !== ceiling && (!all.length || rt.contains(all[0]) && rt.contains(all.at(-1)))) all = getFocusable(p = p.parentElement || ceiling);
+    const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
+    let p = rt.parentElement || ceil, all = getFocusable(p);
+    while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
     for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
     (pre ? first : last).blur();
   }, handleFocusIn = () => {
@@ -192,7 +192,7 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
 }
 var removeFocusTrap = (el) => t007._ftrappers?.get(el)?.();
 
-// src/hooks/react/useArrowNavigation/consts.ts
+// src/ts/hooks/react/useArrowNavigation/consts.ts
 var import_sia_reactor5 = require("sia-reactor");
 var H_NAV_KEYS = ["ArrowRight", "ArrowLeft", "Home", "End"];
 var V_NAV_KEYS = ["ArrowUp", "ArrowDown", "PageDown", "PageUp"];
@@ -218,7 +218,7 @@ var DEFAULT_CONFIG = {
   onFocusOut: import_sia_reactor5.NOOP
 };
 
-// src/hooks/react/useArrowNavigation/utils.ts
+// src/ts/hooks/react/useArrowNavigation/utils.ts
 var getTargetIndex = ({ key, currIndex, length, gridX, gridY, vGridY, loop, ctrlKey = false, rtl }) => {
   const rowStart = currIndex - currIndex % gridX, rowEnd = Math.min(rowStart + gridX - 1, length - 1), colStart = currIndex % gridX, colEnd = Math.min(colStart + gridX * (gridY - 1), length - 1), canX = gridX > 1, canY = gridY > 1, horizontalMove = rtl ? { ArrowRight: canX ? -1 : 0, ArrowLeft: canX ? 1 : 0 } : { ArrowRight: canX ? 1 : 0, ArrowLeft: canX ? -1 : 0 }, move = { ...horizontalMove, ArrowDown: canY ? gridX : 0, ArrowUp: canY ? -gridX : 0, Home: ctrlKey ? 0 : rowStart, End: ctrlKey ? length - 1 : rowEnd, PageDown: (vGridY - 1) * gridX, PageUp: -(vGridY - 1) * gridX }[key] ?? 0;
   let targetIndex = key === "Home" || key === "End" ? move : currIndex + move;
@@ -262,13 +262,13 @@ var getGrid = (all, x = true, y = true, vY = true) => {
   return grid;
 };
 
-// src/hooks/vanilla/arrowNavigation.ts
+// src/ts/hooks/vanilla/arrowNavigation.ts
 function initArrowNavigation(container, config = {}) {
   const existing = (t007._arrownavs ??= /* @__PURE__ */ new WeakMap()).get(container);
   if (!config.enabled || existing) return existing ? existing : void 0;
   const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut, rovingTab } = { ...DEFAULT_CONFIG, ...config };
   let gridX = grid.x || 1, gridY = grid.y || 1, vGridY = grid.vY || 1, activeIndex = -1, buffer = "", timeout = null, items = [];
-  const enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = isRtl ?? getComputedStyle(container).direction === "rtl", shouldSnub = () => !enabled || !container, isItemDisabled = (el) => !el || el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), getItems = () => items = Array.from(container.querySelectorAll(selector));
+  const enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = isRtl ?? ("undefined" === typeof document ? false : getComputedStyle(container).direction === "rtl"), shouldSnub = () => !enabled || !container, isItemDisabled = (el) => !el || el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), getItems = () => items = Array.from(container.querySelectorAll(selector));
   const getAbleIndex = (targetIndex, e = { key: "ArrowRight", ctrlKey: false }) => {
     if (shouldSnub() || !items.length) return null;
     let index = targetIndex;
@@ -375,7 +375,7 @@ function initArrowNavigation(container, config = {}) {
 }
 var removeArrowNavigation = (container) => t007._arrownavs?.get(container)?.destroy();
 
-// src/hooks/vanilla/ripple.ts
+// src/ts/hooks/vanilla/ripple.ts
 var import_sia_reactor6 = require("sia-reactor");
 function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t007-ripple-wrapper", className = "t007-ripple", holdClassName = "t007-ripple-hold", fadeClassName = "t007-ripple-fade" } = import_sia_reactor6.NIL) {
   const el = target || e.currentTarget;

package/dist/hooks/vanilla.js

@@ -10,14 +10,14 @@ import {
   removeFocusTrap,
   removeOutsideClick,
   rippleHandler
-} from "../chunk-NLR4ANGT.js";
+} from "../chunk-YDARUYLO.js";
 import {
   INTERACTIVE_SELECTOR,
   createEl,
   getActiveEl
-} from "../chunk-N5KX6IW4.js";
+} from "../chunk-Y5YJMRXD.js";
 
-// src/hooks/vanilla/scrollAssist.ts
+// src/ts/hooks/vanilla/scrollAssist.ts
 import { NIL } from "sia-reactor";
 function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = NIL) {
   const parent = el?.parentElement, existing = (t007._scrollers ??= /* @__PURE__ */ new WeakMap()).get(el);
@@ -90,7 +90,7 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll
 }
 var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
 
-// src/hooks/vanilla/scrollerator.ts
+// src/ts/hooks/vanilla/scrollerator.ts
 import { NIL as NIL2 } from "sia-reactor";
 function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = NIL2) {
   let linesPerSec = baseSpeed, accelId = null, lastTime = null;
@@ -107,13 +107,13 @@ function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, base
   return { drive, reset };
 }
 
-// src/hooks/vanilla/arrowNavigation.ts
+// src/ts/hooks/vanilla/arrowNavigation.ts
 function initArrowNavigation(container, config = {}) {
   const existing = (t007._arrownavs ??= /* @__PURE__ */ new WeakMap()).get(container);
   if (!config.enabled || existing) return existing ? existing : void 0;
   const { enabled: isEnabled, selector, focusOnHover, loop, virtual, typeahead, resetMs, activeClass, inputSelector, defaultTabbableIndex, baseTabIndex, grid, rtl: isRtl, focusOptions, scrollIntoView, onSelect, onFocusOut, rovingTab } = { ...DEFAULT_CONFIG, ...config };
   let gridX = grid.x || 1, gridY = grid.y || 1, vGridY = grid.vY || 1, activeIndex = -1, buffer = "", timeout = null, items = [];
-  const enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = isRtl ?? getComputedStyle(container).direction === "rtl", shouldSnub = () => !enabled || !container, isItemDisabled = (el) => !el || el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), getItems = () => items = Array.from(container.querySelectorAll(selector));
+  const enabled = isEnabled ?? virtual, roving = rovingTab ?? !virtual, rtl = isRtl ?? ("undefined" === typeof document ? false : getComputedStyle(container).direction === "rtl"), shouldSnub = () => !enabled || !container, isItemDisabled = (el) => !el || el.hasAttribute("disabled") || el.hasAttribute("aria-disabled"), getItems = () => items = Array.from(container.querySelectorAll(selector));
   const getAbleIndex = (targetIndex, e = { key: "ArrowRight", ctrlKey: false }) => {
     if (shouldSnub() || !items.length) return null;
     let index = targetIndex;

package/dist/index.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/index.ts
+// src/ts/index.ts
 var index_exports = {};
 __export(index_exports, {
   INTERACTIVE_SELECTOR: () => INTERACTIVE_SELECTOR,
@@ -37,6 +37,7 @@ __export(index_exports, {
   formatSize: () => formatSize,
   getActiveEl: () => import_utils2.getActiveEl,
   getTermsForKey: () => import_utils6.getTermsForKey,
+  getWindow: () => getWindow,
   guardAllMethods: () => import_utils7.guardAllMethods,
   guardMethod: () => import_utils7.guardMethod,
   inBoolArrOpt: () => inBoolArrOpt,
@@ -72,7 +73,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/core/dom.ts
+// src/ts/core/dom.ts
 var import_utils = require("sia-reactor/utils");
 var import_utils2 = require("sia-reactor/utils");
 var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable='true'],iframe,audio[controls],video[controls],[tabindex]):not([disabled],[tabindex='-1'],[data-focus-guard],[inert],[inert] *)";
@@ -105,11 +106,14 @@ function loadResource(req, type = "style", { module: module2, media, crossOrigin
   });
   return w.t007._resourceCache[src];
 }
+function getWindow(el = window) {
+  return (el instanceof Window ? el : el instanceof Document ? el?.defaultView : el?.ownerDocument?.defaultView) ?? void 0;
+}
 
-// src/index.ts
+// src/ts/index.ts
 var import_sia_reactor = require("sia-reactor");
 
-// src/core/obj.ts
+// src/ts/core/obj.ts
 var import_utils3 = require("sia-reactor/utils");
 function isDef(val) {
   return "undefined" !== typeof val;
@@ -142,10 +146,10 @@ function inBoolArrOpt(opt, str) {
   return opt?.includes?.(str) ?? opt;
 }
 
-// src/core/num.ts
+// src/ts/core/num.ts
 var import_utils4 = require("sia-reactor/utils");
 
-// src/core/str.ts
+// src/ts/core/str.ts
 function uid(prefix = "") {
   return prefix + Date.now().toString(36) + "_" + performance.now().toString(36).replace(".", "") + "_" + Math.random().toString(36).slice(2);
 }
@@ -171,7 +175,7 @@ function isSameURL(src1, src2) {
   }
 }
 
-// src/core/fn.ts
+// src/ts/core/fn.ts
 var import_utils5 = require("sia-reactor/utils");
 function limited(FN_KEY, fn, opts = {}) {
   let count = 0, { key, maxTimes: max = 1 } = isStr(opts) ? { key: opts } : opts;
@@ -195,20 +199,20 @@ function bindCleanupToSignal(cleanup, signal) {
   return cleanup;
 }
 
-// src/core/keys.ts
+// src/ts/core/keys.ts
 var import_utils6 = require("sia-reactor/utils");
 
-// src/core/file.ts
+// src/ts/core/file.ts
 function formatSize(bytes, decimals = 3, base = 1e3) {
   if (bytes < base) return `${bytes} byte${bytes == 1 ? "" : "s"}`;
   const units = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"], exponent = Math.min(Math.floor(Math.log(bytes) / Math.log(base)), units.length - 1);
   return `${(bytes / Math.pow(base, exponent)).toFixed(decimals).replace(/\.0+$/, "")} ${units[exponent]}`;
 }
 
-// src/mixins/methd.ts
+// src/ts/mixins/methd.ts
 var import_utils7 = require("sia-reactor/utils");
 
-// src/index.ts
+// src/ts/index.ts
 if ("undefined" !== typeof window) {
   (window.t007 ??= {}).VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
   window.T007_TOAST_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest`;
@@ -237,6 +241,7 @@ if ("undefined" !== typeof window) {
   formatSize,
   getActiveEl,
   getTermsForKey,
+  getWindow,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,

package/dist/index.d.cts

@@ -70,13 +70,13 @@ declare function pxToRem(px: number, el?: HTMLElement): number;
  * @param time The CSS time string to parse.
  * @returns The equivalent time in milliseconds.
  */
-declare function parseCSSTime(time: string): number;
+declare function parseCSSTime(time: any): number;
 /** Parse a CSS size value (i.e. "16px" or "1.5rem") into pixels.
  * @param size The CSS size string to parse.
  * @param el The element to use for rem reference if needed. Defaults to the root element.
  * @returns The equivalent value in pixels.
  */
-declare function parseCSSSize(size: string, el?: HTMLElement): number;
+declare function parseCSSSize(size: any, el?: HTMLElement): number;
 /** Compare two URLs after normalizing origin, pathname, and separators.
  * @param src1 First URL or path.
  * @param src2 Second URL or path.
@@ -169,6 +169,12 @@ declare const VIRTUAL_RESOURCE: symbol;
  */
 declare function loadResource(req: string | symbol, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
 
+/** Get the window object associated with a given element.
+ * @param el The element to get the window for, defaults to the main window.
+ * @returns The window object or undefined if none found.
+ */
+declare function getWindow(el?: any): (Window & typeof globalThis) | undefined;
+
 /** Format a file size for display.
  * @param size Size in bytes.
  * @param decimals Decimal precision.
@@ -177,4 +183,4 @@ declare function loadResource(req: string | symbol, type?: ResourceType, { modul
  */
 declare function formatSize(bytes: number, decimals?: number, base?: number): string;
 
-export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };
+export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };

package/dist/index.d.ts

@@ -70,13 +70,13 @@ declare function pxToRem(px: number, el?: HTMLElement): number;
  * @param time The CSS time string to parse.
  * @returns The equivalent time in milliseconds.
  */
-declare function parseCSSTime(time: string): number;
+declare function parseCSSTime(time: any): number;
 /** Parse a CSS size value (i.e. "16px" or "1.5rem") into pixels.
  * @param size The CSS size string to parse.
  * @param el The element to use for rem reference if needed. Defaults to the root element.
  * @returns The equivalent value in pixels.
  */
-declare function parseCSSSize(size: string, el?: HTMLElement): number;
+declare function parseCSSSize(size: any, el?: HTMLElement): number;
 /** Compare two URLs after normalizing origin, pathname, and separators.
  * @param src1 First URL or path.
  * @param src2 Second URL or path.
@@ -169,6 +169,12 @@ declare const VIRTUAL_RESOURCE: symbol;
  */
 declare function loadResource(req: string | symbol, type?: ResourceType, { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts, retryKey }?: LoadResourceOptions, w?: Window & typeof globalThis): Promise<HTMLElement | void>;
 
+/** Get the window object associated with a given element.
+ * @param el The element to get the window for, defaults to the main window.
+ * @returns The window object or undefined if none found.
+ */
+declare function getWindow(el?: any): (Window & typeof globalThis) | undefined;
+
 /** Format a file size for display.
  * @param size Size in bytes.
  * @param decimals Decimal precision.
@@ -177,4 +183,4 @@ declare function loadResource(req: string | symbol, type?: ResourceType, { modul
  */
 declare function formatSize(bytes: number, decimals?: number, base?: number): string;
 
-export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };
+export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };

package/dist/index.js

@@ -16,6 +16,7 @@ import {
   formatSize,
   getActiveEl,
   getTermsForKey,
+  getWindow,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,
@@ -48,7 +49,7 @@ import {
   setTimeout,
   stringifyKeyEvent,
   uid
-} from "./chunk-N5KX6IW4.js";
+} from "./chunk-Y5YJMRXD.js";
 export {
   INTERACTIVE_SELECTOR,
   NIL,
@@ -67,6 +68,7 @@ export {
   formatSize,
   getActiveEl,
   getTermsForKey,
+  getWindow,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,

package/dist/styles/scroll-assist.css

@@ -1,44 +1,44 @@
 :root {
-  --t007-scroll-assist-color: rgb(0 0 0 / 1);
+  --t007-scroll-assist-color: black;
   --t007-scroll-assist-opacity: 0.5;
-  --t007-scroll-assist-min-width: 2rem;
-  --t007-scroll-assist-height: 2rem;
-  --t007-scroll-assist-inline-offset: -0.35rem;
-  --t007-scroll-assist-block-offset: 0;
+  --t007-scroll-assist-width: 2rem;
+  --t007-scroll-assist-height: var(--t007-scroll-assist-width);
+  --t007-scroll-assist-inset-x: calc(var(--t007-scroll-assist-width) * -0.25);
+  --t007-scroll-assist-inset-y: 0;
 }
 
 .t007-scroll-assist {
-  --t007-scroll-assist-gradient-dir: to right;
+  --t007-gradient-dir: to right;
   position: absolute;
-  min-width: var(--t007-scroll-assist-min-width);
+  min-width: var(--t007-scroll-assist-width);
   height: 100%;
   opacity: var(--t007-scroll-assist-opacity);
-  background: linear-gradient(var(--t007-scroll-assist-gradient-dir), transparent 0, var(--t007-scroll-assist-color) 30%, transparent);
+  background: linear-gradient(var(--t007-gradient-dir), transparent 0, var(--t007-scroll-assist-color) 30%, transparent);
   z-index: 2;
 }
 
 .t007-scroll-assist[data-scroll-direction="left"] {
-  --t007-scroll-assist-gradient-dir: to right;
+  --t007-gradient-dir: to right;
   top: 0;
-  left: var(--t007-scroll-assist-inline-offset);
+  left: var(--t007-scroll-assist-inset-x);
 }
 
 .t007-scroll-assist[data-scroll-direction="right"] {
-  --t007-scroll-assist-gradient-dir: to left;
+  --t007-gradient-dir: to left;
   top: 0;
-  right: var(--t007-scroll-assist-inline-offset);
+  right: var(--t007-scroll-assist-inset-x);
 }
 
 .t007-scroll-assist[data-scroll-direction="up"] {
-  --t007-scroll-assist-gradient-dir: to bottom;
-  top: var(--t007-scroll-assist-block-offset);
+  --t007-gradient-dir: to bottom;
+  top: var(--t007-scroll-assist-inset-y);
   height: var(--t007-scroll-assist-height);
   width: 100%;
 }
 
 .t007-scroll-assist[data-scroll-direction="down"] {
-  --t007-scroll-assist-gradient-dir: to top;
-  bottom: var(--t007-scroll-assist-block-offset);
+  --t007-gradient-dir: to top;
+  bottom: var(--t007-scroll-assist-inset-y);
   height: var(--t007-scroll-assist-height);
   width: 100%;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@t007/utils",
-  "version": "0.0.28",
-  "description": "High-performance, zero-dependency utility functions for the t007 ecosystem.",
+  "version": "0.0.30",
+  "description": "High-performance utilities for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -50,7 +50,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts && shx cp src/styles/ripple.css dist/styles/ripple.css && shx cp src/styles/scroll-assist.css dist/styles/scroll-assist.css",
+    "build": "tsup --config tsup.config.ts",
     "prepublishOnly": "shx cp ../../LICENSE ."
   },
   "files": [
@@ -70,12 +70,12 @@
   "devDependencies": {
     "@types/react": "^18.0.0",
     "@types/react-dom": "^18.0.0",
+    "esbuild-sass-plugin": "^3.7.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@t007/input": "^0.0.26",
-    "sia-reactor": "^0.0.32"
+    "sia-reactor": "^0.0.33"
   },
   "peerDependencies": {
     "react": "^18.0.0"