@t007/utils 0.0.25 → 0.0.26

package/dist/hooks/vanilla.js

@@ -0,0 +1,232 @@
+import {
+  DEFAULT_CONFIG,
+  H_NAV_KEYS,
+  NAV_KEYS,
+  getCommonAncestor,
+  getGrid,
+  getTargetIndex,
+  initFocusTrap,
+  initOutsideClick,
+  removeFocusTrap,
+  removeOutsideClick,
+  rippleHandler
+} from "../chunk-AI5O3OGE.js";
+import {
+  INTERACTIVE_SELECTOR,
+  createEl,
+  getActiveElement
+} from "../chunk-XVFFZZJA.js";
+
+// src/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);
+  if (!parent || existing) return existing ? existing : void 0;
+  t007._scroller_r_observer ??= new ResizeObserver((entries) => {
+    for (const { target } of entries) t007._scrollers.get(target)?.update();
+  });
+  t007._scroller_m_observer ??= new MutationObserver((entries) => {
+    const els = /* @__PURE__ */ new Set();
+    for (const entry of entries) {
+      let node = entry.target instanceof Element ? entry.target : null;
+      while (node && !t007._scrollers.has(node)) node = node.parentElement;
+      if (node) els.add(node);
+    }
+    for (const el2 of els) t007._scrollers.get(el2)?.update();
+  });
+  const assist = {};
+  let scrollId = null, last = performance.now(), assistWidth = 20, assistHeight = 20;
+  const update = () => {
+    const hasInteractive = !!parent.querySelector(INTERACTIVE_SELECTOR);
+    if (horizontal) {
+      const w = assist.left?.offsetWidth || assistWidth, check = hasInteractive ? el.clientWidth < w * 2 : false;
+      assist.left.style.display = check ? "none" : el.scrollLeft > 0 ? "block" : "none";
+      assist.right.style.display = check ? "none" : el.scrollLeft + el.clientWidth < el.scrollWidth - 1 ? "block" : "none";
+      assistWidth = w;
+    }
+    if (vertical) {
+      const h = assist.up?.offsetHeight || assistHeight, check = hasInteractive ? el.clientHeight < h * 2 : false;
+      assist.up.style.display = check ? "none" : el.scrollTop > 0 ? "block" : "none";
+      assist.down.style.display = check ? "none" : el.scrollTop + el.clientHeight < el.scrollHeight - 1 ? "block" : "none";
+      assistHeight = h;
+    }
+  };
+  const scroll = (dir) => {
+    const frame = () => {
+      const now = performance.now(), dt = now - last;
+      last = now;
+      const d = pxPerSecond * dt / 1e3;
+      if (dir === "left") el.scrollLeft = Math.max(0, el.scrollLeft - d);
+      if (dir === "right") el.scrollLeft = Math.min(el.scrollWidth - el.clientWidth, el.scrollLeft + d);
+      if (dir === "up") el.scrollTop = Math.max(0, el.scrollTop - d);
+      if (dir === "down") el.scrollTop = Math.min(el.scrollHeight - el.clientHeight, el.scrollTop + d);
+      scrollId = requestAnimationFrame(frame);
+    };
+    last = performance.now();
+    frame();
+  };
+  const stop = () => (cancelAnimationFrame(scrollId ?? 0), scrollId = null);
+  const addAssist = (dir) => {
+    const div = createEl("div", { className: assistClassName }, { scrollDirection: dir }, { display: "none" });
+    if (!div) return;
+    for (const evt of ["pointerenter", "dragenter"]) div.addEventListener(evt, () => scroll(dir));
+    for (const evt of ["pointerleave", "pointerup", "pointercancel", "dragleave", "dragend"]) div.addEventListener(evt, stop);
+    dir === "left" || dir === "up" ? parent.insertBefore(div, el) : parent.append(div);
+    assist[dir] = div;
+  };
+  if (horizontal) for (const dir of ["left", "right"]) addAssist(dir);
+  if (vertical) for (const dir of ["up", "down"]) addAssist(dir);
+  const handle = {
+    update,
+    destroy() {
+      stop(), el.removeEventListener("scroll", update);
+      t007._scroller_r_observer.unobserve(el), t007._scrollers.delete(el);
+      for (const a of Object.values(assist)) a.remove();
+    }
+  };
+  update(), el.addEventListener("scroll", update);
+  t007._scroller_r_observer.observe(el), t007._scroller_m_observer.observe(el, { childList: true, subtree: true, characterData: true });
+  return t007._scrollers.set(el, handle), handle;
+}
+var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
+
+// src/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;
+  const drive = (clientY, brake = false, offsetY = 0) => {
+    if (car !== window) clientY -= offsetY;
+    const now = performance.now(), speed = linesPerSec * lineHeight * ((lastTime ? now - lastTime : baseRate) / 1e3);
+    if (!brake && (clientY < margin || clientY > (car.innerHeight ?? car.offsetHeight) - margin)) {
+      accelId === null ? accelId = setTimeout(() => linesPerSec += 1, stepDelay) : linesPerSec > baseSpeed && (linesPerSec = Math.min(linesPerSec + 1, maxSpeed));
+      car.scrollBy?.(0, clientY < margin ? -speed : speed);
+    } else reset();
+    return lastTime = !brake ? now : null, speed;
+  };
+  const reset = () => (accelId && clearTimeout(accelId), accelId = null, linesPerSec = baseSpeed, lastTime = null);
+  return { drive, reset };
+}
+
+// src/hooks/vanilla/arrowNavigation.ts
+function initArrowNavigation(container, config = {}) {
+  const existing = (t007._ashooters ??= /* @__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 getAbleIndex = (targetIndex, e = { key: "ArrowRight", ctrlKey: false }) => {
+    if (shouldSnub() || !items.length) return null;
+    let index = targetIndex;
+    let attempts = 0;
+    while (attempts < items.length) {
+      if (!isItemDisabled(items[index])) return index;
+      index = getTargetIndex({ key: e.key, currIndex: index, gridX, gridY, vGridY, length: items.length, loop, ctrlKey: e.ctrlKey, rtl });
+      attempts++;
+    }
+    return null;
+  };
+  const goToIndex = (targetIndex, e = { key: "ArrowRight" }) => {
+    if (shouldSnub()) return;
+    const idx = getAbleIndex(targetIndex, e);
+    if (idx === null) return;
+    resetActiveIndex(idx);
+    onSelect?.(items[idx], e), updateDOM();
+    if (virtual) {
+      items[idx]?.scrollIntoView(scrollIntoView);
+      container.setAttribute("aria-activedescendant", items[idx].id || "");
+    } else items[idx]?.focus(focusOptions);
+  };
+  const updateDOM = () => {
+    if (shouldSnub() || !virtual && !roving || !items.length) return;
+    const hasDefaultTabbable = defaultTabbableIndex !== null && defaultTabbableIndex !== void 0, tabbableIndex = hasDefaultTabbable && !isItemDisabled(items[defaultTabbableIndex]) ? defaultTabbableIndex : getAbleIndex(0);
+    for (let i = 0, len = items.length; i < len; i++) {
+      const el = items[i], isActive = i === activeIndex;
+      if (roving) el.setAttribute("tabindex", i === activeIndex || activeIndex === -1 && i === tabbableIndex ? baseTabIndex : "-1");
+      else if (virtual && activeIndex > 0) el.setAttribute("tabindex", i > activeIndex ? baseTabIndex : "-1");
+      else el.setAttribute("tabindex", baseTabIndex);
+      if (virtual) el.setAttribute("aria-selected", String(isActive)), el.classList.toggle(activeClass, isActive);
+    }
+  };
+  const resetActiveIndex = (index = -1) => (activeIndex = index, updateDOM());
+  const typeAhead = (key) => {
+    if (shouldSnub() || !typeahead) return;
+    buffer += key.toLowerCase();
+    if (timeout) clearTimeout(timeout);
+    timeout = setTimeout(() => buffer = "", resetMs);
+    const start = activeIndex >= 0 ? activeIndex + 1 : 0;
+    for (let i = 0; i < items.length; i++) {
+      const idx = (start + i) % items.length, label = (items[idx].getAttribute("data-label") || items[idx].innerText || "").trim().toLowerCase();
+      if (label.startsWith(buffer)) return goToIndex(idx);
+    }
+  };
+  const simulateKey = (e) => {
+    if (shouldSnub() || getActiveElement()?.matches("option")) return;
+    const { key } = e;
+    if (!items.length) return;
+    if (virtual && (key === " " || key === "Enter")) return items[activeIndex]?.click();
+    if (e.target?.matches(DEFAULT_CONFIG.inputSelector) && !virtual) return;
+    if (typeahead && key.length === 1 && /^[a-z0-9]$/i.test(key)) return typeAhead(key);
+    if (!NAV_KEYS.includes(key)) return;
+    if (!(e.currentTarget?.matches(DEFAULT_CONFIG.inputSelector) && gridX <= 1 && H_NAV_KEYS.includes(key))) e.preventDefault?.(), e.stopPropagation?.();
+    const currIndex = virtual ? activeIndex : items.indexOf(getActiveElement()), targetIndex = getTargetIndex({ currIndex, gridX, gridY, vGridY, length: items.length, loop, rtl, key, ctrlKey: e.ctrlKey });
+    goToIndex(targetIndex, e);
+  };
+  getItems(), updateDOM();
+  const interactiveEls = !virtual ? [container] : [container.querySelector(inputSelector)];
+  for (const el of interactiveEls) el?.addEventListener("keydown", simulateKey);
+  const handleFocusOut = (e) => {
+    if (!container.contains(e.relatedTarget)) return resetActiveIndex(), updateDOM(), onFocusOut?.(e);
+    const among = items.includes(e.relatedTarget);
+    if (!among && (defaultTabbableIndex ?? -1) >= 0) return resetActiveIndex(), updateDOM();
+    if (virtual) resetActiveIndex(), updateDOM();
+  };
+  container.addEventListener("focusout", handleFocusOut);
+  const handleHover = (e) => {
+    if (!enabled || !focusOnHover) return;
+    const el = e.currentTarget, idx = items.indexOf(el);
+    if (idx !== -1) goToIndex(idx);
+  };
+  for (const el of items) el.addEventListener("mouseenter", handleHover);
+  const mutationObserver = new MutationObserver(() => {
+    const oldEl = items[activeIndex];
+    getItems();
+    const newEl = items[activeIndex];
+    updateDOM();
+    if (oldEl && newEl && oldEl === newEl) return;
+    resetActiveIndex();
+    updateDOM();
+  });
+  mutationObserver.observe(container, { childList: true, subtree: true });
+  const setGrid = (g) => {
+    if (g.x !== void 0) gridX = g.x;
+    if (g.y !== void 0) gridY = g.y;
+    if (g.vY !== void 0) vGridY = g.vY;
+  };
+  const calcGrid = () => setGrid(getGrid(items, !grid.x, !grid.y, !grid.vY));
+  setGrid(grid), calcGrid();
+  const ancestor = items.length > 1 ? getCommonAncestor(items[0], items[1]) : container;
+  const resizeObserver = new ResizeObserver(calcGrid);
+  if (ancestor) resizeObserver.observe(ancestor);
+  const destroy = () => {
+    for (const el of interactiveEls) el?.removeEventListener("keydown", simulateKey);
+    container.removeEventListener("focusout", handleFocusOut);
+    for (const el of items) el.removeEventListener("mouseenter", handleHover);
+    mutationObserver.disconnect(), resizeObserver.disconnect();
+    if (timeout) clearTimeout(timeout);
+  };
+  const handle = { gridX: () => gridX, gridY: () => gridY, vGridY: () => vGridY, items: () => items, activeIndex: () => activeIndex, activeItem: () => items[activeIndex] ?? null, getAbleIndex, typeAhead, goToIndex, simulateKey, destroy };
+  return t007._ashooters.set(container, handle), handle;
+}
+var removeArrowNavigation = (container) => t007._ashooters?.get(container)?.destroy();
+export {
+  initArrowNavigation,
+  initFocusTrap,
+  initOutsideClick,
+  initScrollAssist,
+  initVScrollerator,
+  removeArrowNavigation,
+  removeFocusTrap,
+  removeOutsideClick,
+  removeScrollAssist,
+  rippleHandler
+};

package/dist/index.cjs

@@ -20,6 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  INTERACTIVE_SELECTOR: () => INTERACTIVE_SELECTOR,
+  NIL: () => import_sia_reactor.NIL,
+  NOOP: () => import_sia_reactor.NOOP,
   VIRTUAL_RESOURCE: () => VIRTUAL_RESOURCE,
   assignEl: () => import_utils.assignEl,
   bindAllMethods: () => import_utils6.bindAllMethods,
@@ -31,16 +34,17 @@ __export(index_exports, {
   deepBreath: () => deepBreath,
   formatKeyForDisplay: () => import_utils5.formatKeyForDisplay,
   formatKeyShortcutsForDisplay: () => import_utils5.formatKeyShortcutsForDisplay,
+  formatSize: () => formatSize,
+  getActiveElement: () => getActiveElement,
   getTermsForKey: () => import_utils5.getTermsForKey,
   guardAllMethods: () => import_utils6.guardAllMethods,
   guardMethod: () => import_utils6.guardMethod,
   inBoolArrOpt: () => inBoolArrOpt,
-  initScrollAssist: () => initScrollAssist,
-  initVScrollerator: () => initVScrollerator,
   isArr: () => isArr,
   isBool: () => isBool,
   isDef: () => isDef,
   isFunc: () => isFunc,
+  isInteractive: () => isInteractive,
   isIter: () => isIter,
   isNum: () => isNum,
   isObj: () => import_utils2.isObj,
@@ -56,7 +60,6 @@ __export(index_exports, {
   onAllMethods: () => import_utils6.onAllMethods,
   parseForARIAKS: () => import_utils5.parseForARIAKS,
   parseKeyCombo: () => import_utils5.parseKeyCombo,
-  removeScrollAssist: () => removeScrollAssist,
   requestAnimationFrame: () => import_utils4.requestAnimationFrame,
   setInterval: () => import_utils4.setInterval,
   setTimeout: () => import_utils4.setTimeout,
@@ -67,6 +70,8 @@ module.exports = __toCommonJS(index_exports);
 
 // src/core/dom.ts
 var import_utils = require("sia-reactor/utils");
+var INTERACTIVE_SELECTOR = 'button,[href],input,label,select,textarea,details>summary,[contenteditable],iframe,audio[controls],video[controls],[tabindex]:not([tabindex="-1"])';
+var isInteractive = (target) => target instanceof HTMLElement && target.matches(INTERACTIVE_SELECTOR);
 var VIRTUAL_RESOURCE = /* @__PURE__ */ Symbol.for("T007_VIRTUAL_RESOURCE");
 function loadResource(req, type = "style", { module: module2, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
   w.t007 ??= {}, w.t007._resourceCache ??= {};
@@ -95,6 +100,13 @@ function loadResource(req, type = "style", { module: module2, media, crossOrigin
   });
   return w.t007._resourceCache[src];
 }
+function getActiveElement(root = document) {
+  const activeEl = root.activeElement;
+  return !activeEl ? null : activeEl.shadowRoot ? getActiveElement(activeEl.shadowRoot) : activeEl;
+}
+
+// src/index.ts
+var import_sia_reactor = require("sia-reactor");
 
 // src/core/obj.ts
 var import_utils2 = require("sia-reactor/utils");
@@ -173,101 +185,19 @@ function bindCleanupToSignal(cleanup, signal) {
 // src/core/keys.ts
 var import_utils5 = require("sia-reactor/utils");
 
+// src/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
 var import_utils6 = require("sia-reactor/utils");
 
-// src/quirks/scroll.ts
-function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = {}) {
-  let linesPerSec = baseSpeed, accelId = null, lastTime = null;
-  const drive = (clientY, brake = false, offsetY = 0) => {
-    if (car !== window) clientY -= offsetY;
-    const now = performance.now(), speed = linesPerSec * lineHeight * ((lastTime ? now - lastTime : baseRate) / 1e3);
-    if (!brake && (clientY < margin || clientY > (car.innerHeight ?? car.offsetHeight) - margin)) {
-      accelId === null ? accelId = setTimeout(() => linesPerSec += 1, stepDelay) : linesPerSec > baseSpeed && (linesPerSec = Math.min(linesPerSec + 1, maxSpeed));
-      car.scrollBy?.(0, clientY < margin ? -speed : speed);
-    } else reset();
-    return lastTime = !brake ? now : null, speed;
-  };
-  const reset = () => (accelId && clearTimeout(accelId), accelId = null, linesPerSec = baseSpeed, lastTime = null);
-  return { drive, reset };
-}
-function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = {}) {
-  t007._scrollers ??= /* @__PURE__ */ new WeakMap();
-  t007._scroller_r_observer ??= new ResizeObserver((entries) => entries.forEach(({ target }) => t007._scrollers.get(target)?.update()));
-  t007._scroller_m_observer ??= new MutationObserver((entries) => {
-    const els = /* @__PURE__ */ new Set();
-    for (const entry of entries) {
-      let node = entry.target instanceof Element ? entry.target : null;
-      while (node && !t007._scrollers.has(node)) node = node.parentElement;
-      if (node) els.add(node);
-    }
-    for (const el2 of els) t007._scrollers.get(el2)?.update();
-  });
-  const parent = el?.parentElement;
-  if (!parent || t007._scrollers.has(el)) return;
-  const assist = {};
-  let scrollId = null, last = performance.now(), assistWidth = 20, assistHeight = 20;
-  const update = () => {
-    const hasInteractive = !!parent.querySelector('button, a[href], input, select, textarea, [contenteditable="true"], [tabindex]:not([tabindex="-1"])');
-    if (horizontal) {
-      const w = assist.left?.offsetWidth || assistWidth, check = hasInteractive ? el.clientWidth < w * 2 : false;
-      assist.left.style.display = check ? "none" : el.scrollLeft > 0 ? "block" : "none";
-      assist.right.style.display = check ? "none" : el.scrollLeft + el.clientWidth < el.scrollWidth - 1 ? "block" : "none";
-      assistWidth = w;
-    }
-    if (vertical) {
-      const h = assist.up?.offsetHeight || assistHeight, check = hasInteractive ? el.clientHeight < h * 2 : false;
-      assist.up.style.display = check ? "none" : el.scrollTop > 0 ? "block" : "none";
-      assist.down.style.display = check ? "none" : el.scrollTop + el.clientHeight < el.scrollHeight - 1 ? "block" : "none";
-      assistHeight = h;
-    }
-  };
-  const scroll = (dir) => {
-    const frame = () => {
-      const now = performance.now(), dt = now - last;
-      last = now;
-      const d = pxPerSecond * dt / 1e3;
-      if (dir === "left") el.scrollLeft = Math.max(0, el.scrollLeft - d);
-      if (dir === "right") el.scrollLeft = Math.min(el.scrollWidth - el.clientWidth, el.scrollLeft + d);
-      if (dir === "up") el.scrollTop = Math.max(0, el.scrollTop - d);
-      if (dir === "down") el.scrollTop = Math.min(el.scrollHeight - el.clientHeight, el.scrollTop + d);
-      scrollId = requestAnimationFrame(frame);
-    };
-    last = performance.now();
-    frame();
-  };
-  const stop = () => (cancelAnimationFrame(scrollId ?? 0), scrollId = null);
-  const addAssist = (dir) => {
-    const div = (0, import_utils.createEl)("div", { className: assistClassName }, { scrollDirection: dir }, { display: "none" });
-    if (!div) return;
-    ["pointerenter", "dragenter"].forEach((evt) => div.addEventListener(evt, () => scroll(dir)));
-    ["pointerleave", "pointerup", "pointercancel", "dragleave", "dragend"].forEach((evt) => div.addEventListener(evt, stop));
-    dir === "left" || dir === "up" ? parent.insertBefore(div, el) : parent.append(div);
-    assist[dir] = div;
-  };
-  if (horizontal) ["left", "right"].forEach(addAssist);
-  if (vertical) ["up", "down"].forEach(addAssist);
-  el.addEventListener("scroll", update);
-  t007._scroller_r_observer.observe(el);
-  t007._scroller_m_observer.observe(el, { childList: true, subtree: true, characterData: true });
-  t007._scrollers.set(el, {
-    update,
-    destroy() {
-      stop();
-      el.removeEventListener("scroll", update);
-      t007._scroller_r_observer.unobserve(el);
-      t007._scrollers.delete(el);
-      Object.values(assist).forEach((a) => a.remove());
-    }
-  });
-  return update(), t007._scrollers.get(el);
-}
-var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
-
 // src/index.ts
 if ("undefined" !== typeof window) {
-  window.t007 ??= {};
-  t007.VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
+  (window.t007 ??= {}).VIRTUAL_RESOURCE = VIRTUAL_RESOURCE;
   window.T007_TOAST_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest`;
   window.T007_INPUT_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/input@latest`;
   window.T007_DIALOG_JS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/dialog@latest`;
@@ -277,6 +207,9 @@ if ("undefined" !== typeof window) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  INTERACTIVE_SELECTOR,
+  NIL,
+  NOOP,
   VIRTUAL_RESOURCE,
   assignEl,
   bindAllMethods,
@@ -288,16 +221,17 @@ if ("undefined" !== typeof window) {
   deepBreath,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
+  formatSize,
+  getActiveElement,
   getTermsForKey,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,
-  initScrollAssist,
-  initVScrollerator,
   isArr,
   isBool,
   isDef,
   isFunc,
+  isInteractive,
   isIter,
   isNum,
   isObj,
@@ -313,7 +247,6 @@ if ("undefined" !== typeof window) {
   onAllMethods,
   parseForARIAKS,
   parseKeyCombo,
-  removeScrollAssist,
   requestAnimationFrame,
   setInterval,
   setTimeout,

package/dist/index.d.cts

@@ -1,74 +1,18 @@
+import { A as ArrowNavigationHandle } from './arrowNavigation-DK8mqVOk.cjs';
+import { S as ScrollAssistHandle } from './scrollAssist-y9wFmYgt.cjs';
+export { NIL, NOOP } from 'sia-reactor';
 export { KeyStruct, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getTermsForKey, guardAllMethods, guardMethod, isObj, keyEventAllowed, keysSettings, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent } from 'sia-reactor/utils';
 
-/** Configuration for the vertical edge-scrolling helper. */
-interface ScrolleratorOptions {
-    /** Starting lines-per-second speed. */
-    baseSpeed?: number;
-    /** Maximum accelerated speed. */
-    maxSpeed?: number;
-    /** Delay before acceleration kicks in. */
-    stepDelay?: number;
-    /** Base frame rate used to estimate movement. */
-    baseRate?: number;
-    /** Approximate line height in pixels. */
-    lineHeight?: number;
-    /** Edge margin that triggers scrolling. */
-    margin?: number;
-    /** Scroll container or window target. */
-    car?: Window | HTMLElement;
-}
-/** Scrolling controls returned by initVScrollerator. */
-interface Scrollerator {
-    /** Trigger a scroll frame and return the computed distance. */
-    drive: (clientY: number, brake?: boolean, offsetY?: number) => number;
-    /** Reset speed and timers. */
-    reset: () => void;
-}
-/** Create an edge-driven vertical scrolling controller.
- * @param options Scrollerator configuration.
- * @returns Drive and reset controls for the controller.
- */
-declare function initVScrollerator({ baseSpeed, maxSpeed, stepDelay, baseRate, lineHeight, margin, car }?: ScrolleratorOptions): Scrollerator;
-/** Scroll assist control object returned by initScrollAssist. */
-interface ScrollAssistControl {
-    /** Recompute assist visibility. */
-    update: () => void;
-    /** Tear down observers and assist elements. */
-    destroy: () => void;
-}
-/** Configuration for scroll assist overlays. */
-interface ScrollAssistOptions {
-    /** Scroll speed in pixels per second. */
-    pxPerSecond?: number;
-    /** Class name applied to assist overlays. */
-    assistClassName?: string;
-    /** Enable vertical assist overlays. */
-    vertical?: boolean;
-    /** Enable horizontal assist overlays. */
-    horizontal?: boolean;
-}
-/** Attach directional scroll assist overlays to an element.
- * @param el Scrollable element to enhance.
- * @param options Scroll assist configuration.
- * @returns Scroll assist controls or void when the element is already managed.
- */
-declare function initScrollAssist(el: HTMLElement, { pxPerSecond, assistClassName, vertical, horizontal }?: ScrollAssistOptions): ScrollAssistControl | void;
-/** Remove scroll assist from an element.
- * @param el Target element.
- */
-declare const removeScrollAssist: (el: HTMLElement) => void | undefined;
-
 declare global {
   interface T007Namespace {
     /** Symbol used to mark virtual resources that should not load a real asset. */
     VIRTUAL_RESOURCE: symbol;
-    /** Cache used to deduplicate resource loading promises. */
     _resourceCache: Partial<Record<string, Promise<HTMLElement | void>>>;
-    /** Active scroll assist controllers keyed by element. */
-    _scrollers?: WeakMap<HTMLElement, ScrollAssistControl>;
-    /** Resize observer used by scroll assist controllers. */
+    _ftrappers?: WeakMap<HTMLElement, () => void>;
+    _outsiders?: WeakMap<HTMLElement, () => void>;
+    _ashooters?: WeakMap<HTMLElement, ArrowNavigationHandle>;
+    _scrollers?: WeakMap<HTMLElement, ScrollAssistHandle>;
     _scroller_r_observer?: ResizeObserver;
-    /** Mutation observer used by scroll assist controllers. */
     _scroller_m_observer?: MutationObserver;
   }
   interface Window {
@@ -162,6 +106,10 @@ declare const deepBreath: (w?: Window & typeof globalThis) => Promise<unknown>;
  */
 declare function bindCleanupToSignal<Cb extends () => any>(cleanup: Cb, signal?: AbortSignal): Cb;
 
+/** Exhaustive Selector used for interactive, tabbable UI controls. */
+declare const INTERACTIVE_SELECTOR = "button,[href],input,label,select,textarea,details>summary,[contenteditable],iframe,audio[controls],video[controls],[tabindex]:not([tabindex=\"-1\"])";
+/** Check whether an event target points to an interactive element. */
+declare const isInteractive: (target: EventTarget | null) => target is HTMLElement;
 /** Resource type accepted by loadResource. */
 type ResourceType = "style" | "script" | string;
 /** Options used when loading a script or stylesheet resource. */
@@ -185,7 +133,6 @@ type LoadResourceOptions = Partial<{
     /** Cache-busting retry token key. */
     retryKey: boolean | string;
 }>;
-
 /** Virtual resource marker used to skip real network loading. */
 declare const VIRTUAL_RESOURCE: symbol;
 /** Load a stylesheet or script into the current document with retry support.
@@ -196,5 +143,18 @@ declare const VIRTUAL_RESOURCE: symbol;
  * @returns Promise resolving to the created element or void.
  */
 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 currently active element, traversing into shadow roots if necessary.
+ * @param root Root node to start searching from, defaults to the main document.
+ * @returns The active element or null if none found.
+ */
+declare function getActiveElement(root?: Document | ShadowRoot): Element | null;
+
+/** Format a file size for display.
+ * @param size Size in bytes.
+ * @param decimals Decimal precision.
+ * @param base Size base, usually 1000 or 1024.
+ * @returns Human-readable size string, i.e., "1.234 KB".
+ */
+declare function formatSize(bytes: number, decimals?: number, base?: number): string;
 
-export { type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, type ScrollAssistControl, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, inBoolArrOpt, initScrollAssist, initVScrollerator, isArr, isBool, isDef, isFunc, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, removeScrollAssist, uid };
+export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, getActiveElement, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, uid };