@t007/utils 0.0.24 → 0.0.26

package/dist/index.d.ts

@@ -1,74 +1,18 @@
+import { A as ArrowNavigationHandle } from './arrowNavigation-VenvPI4H.js';
+import { S as ScrollAssistHandle } from './scrollAssist-y9wFmYgt.js';
+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 };

package/dist/index.js

@@ -1,214 +1,54 @@
-// src/core/dom.ts
-import { createEl, assignEl } from "sia-reactor/utils";
-var VIRTUAL_RESOURCE = /* @__PURE__ */ Symbol.for("T007_VIRTUAL_RESOURCE");
-function loadResource(req, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, w = window) {
-  w.t007 ??= {}, w.t007._resourceCache ??= {};
-  if (req === VIRTUAL_RESOURCE || isSym(req)) return Promise.resolve();
-  const src = req;
-  if (w.t007._resourceCache[src]) return w.t007._resourceCache[src];
-  const existing = type === "script" ? Array.prototype.find.call(w.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(w.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
-  if (existing) return w.t007._resourceCache[src] = Promise.resolve(existing);
-  w.t007._resourceCache[src] = new Promise((resolve, reject) => {
-    (function tryLoad(remaining, el) {
-      const onerror = () => {
-        el?.remove?.();
-        if (remaining > 1) {
-          setTimeout(tryLoad, 1e3, remaining - 1);
-          console.warn(`Retrying ${type} load (${attempts - remaining + 1}): ${src}...`);
-        } else {
-          delete w.t007._resourceCache[src];
-          reject(new Error(`${type} load failed after ${attempts} attempts: ${src}`));
-        }
-      };
-      const url = retryKey && remaining < attempts ? `${src}${src.includes("?") ? "&" : "?"}_${retryKey}=${Date.now()}` : src;
-      if (type === "script") w.document.body.append(el = createEl("script", { src: url, type: module ? "module" : "text/javascript", crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
-      else if (type === "style") w.document.head.append(el = createEl("link", { rel: "stylesheet", href: url, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, onload: () => resolve(el), onerror }) || "");
-      else reject(new Error(`Unsupported resource type: ${type}`));
-    })(attempts);
-  });
-  return w.t007._resourceCache[src];
-}
-
-// src/core/obj.ts
-import { isObj } from "sia-reactor/utils";
-function isDef(val) {
-  return "undefined" !== typeof val;
-}
-function isSym(val) {
-  return "symbol" === typeof val;
-}
-function isBool(val) {
-  return "boolean" === typeof val;
-}
-function isNum(val) {
-  return "number" === typeof val;
-}
-function isStr(val) {
-  return "string" === typeof val;
-}
-function isArr(obj) {
-  return Array.isArray(obj);
-}
-function isPOJO(obj, crossRealms = false, typecheck = true) {
-  return (typecheck ? isObj(obj, false) : true) && (crossRealms ? Object.prototype.toString.call(obj) === "[object Object]" : obj.constructor === Object);
-}
-function isIter(obj) {
-  return obj != null && "function" === typeof obj[Symbol.iterator];
-}
-function isFunc(val) {
-  return "function" === typeof val;
-}
-function inBoolArrOpt(opt, str) {
-  return opt?.includes?.(str) ?? opt;
-}
-
-// src/core/num.ts
-import { clamp } from "sia-reactor/utils";
-
-// src/core/str.ts
-function uid(prefix = "") {
-  return prefix + Date.now().toString(36) + "_" + performance.now().toString(36).replace(".", "") + "_" + Math.random().toString(36).slice(2);
-}
-function isSameURL(src1, src2) {
-  if (!isStr(src1) || !isStr(src2) || !src1 || !src2) return false;
-  try {
-    const u1 = new URL(src1, window.location.href), u2 = new URL(src2, window.location.href);
-    return decodeURIComponent(u1.origin + u1.pathname) === decodeURIComponent(u2.origin + u2.pathname);
-  } catch {
-    return src1.replace(/\\/g, "/").split("?")[0].trim() === src2.replace(/\\/g, "/").split("?")[0].trim();
-  }
-}
-
-// src/core/fn.ts
-import { setTimeout as setTimeout2, setInterval, requestAnimationFrame as requestAnimationFrame2 } from "sia-reactor/utils";
-function limited(FN_KEY, fn, opts = {}) {
-  let count = 0, { key, maxTimes: max = 1 } = isStr(opts) ? { key: opts } : opts;
-  const getReg = () => JSON.parse(localStorage.getItem(FN_KEY) || "{}"), setReg = (r) => localStorage.setItem(FN_KEY, JSON.stringify(r));
-  const handle = (...args) => {
-    if (!key) return count++ < max ? fn(...args) : void 0;
-    const r = getReg(), c = r[key] || 0;
-    return c < max ? (r[key] = c + 1, setReg(r), fn(...args)) : void 0;
-  };
-  handle.left = max - (handle.count = count);
-  handle.reset = () => (count = 0, key && ((r) => (delete r[key], setReg(r)))(getReg()));
-  handle.block = () => (count = max, key && ((r) => (r[key] = max, setReg(r)))(getReg()));
-  return handle;
-}
-var mockAsync = (timeout = 250) => new Promise((resolve) => setTimeout(resolve, timeout));
-var breath = (w = window) => new Promise((res) => w.requestAnimationFrame(res));
-var deepBreath = (w = window) => new Promise((res) => w.requestAnimationFrame(() => w.requestAnimationFrame(res)));
-function bindCleanupToSignal(cleanup, signal) {
-  signal?.aborted ? cleanup() : signal?.addEventListener("abort", cleanup, { once: true });
-  if (signal && !signal.aborted) cleanup = (() => (signal.removeEventListener("abort", cleanup), cleanup()));
-  return cleanup;
-}
-
-// src/core/keys.ts
-import { parseKeyCombo, stringifyKeyEvent, cleanKeyCombo, matchKeys, getTermsForKey, keyEventAllowed, formatKeyForDisplay, formatKeyShortcutsForDisplay, parseForARIAKS } from "sia-reactor/utils";
-
-// src/mixins/methd.ts
-import { onAllMethods, bindAllMethods, guardAllMethods, guardMethod } from "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 = "tmg-video-controls-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 = 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_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`;
-  window.T007_TOAST_CSS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/toast@latest/dist/index.min.css`;
-  window.T007_INPUT_CSS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/input@latest/dist/index.min.css`;
-  window.T007_DIALOG_CSS_SRC ??= `https://cdn.jsdelivr.net/npm/@t007/dialog@latest/dist/index.min.css`;
-}
+import {
+  INTERACTIVE_SELECTOR,
+  NIL,
+  NOOP,
+  VIRTUAL_RESOURCE,
+  assignEl,
+  bindAllMethods,
+  bindCleanupToSignal,
+  breath,
+  clamp,
+  cleanKeyCombo,
+  createEl,
+  deepBreath,
+  formatKeyForDisplay,
+  formatKeyShortcutsForDisplay,
+  formatSize,
+  getActiveElement,
+  getTermsForKey,
+  guardAllMethods,
+  guardMethod,
+  inBoolArrOpt,
+  isArr,
+  isBool,
+  isDef,
+  isFunc,
+  isInteractive,
+  isIter,
+  isNum,
+  isObj,
+  isPOJO,
+  isSameURL,
+  isStr,
+  isSym,
+  keyEventAllowed,
+  limited,
+  loadResource,
+  matchKeys,
+  mockAsync,
+  onAllMethods,
+  parseForARIAKS,
+  parseKeyCombo,
+  requestAnimationFrame,
+  setInterval,
+  setTimeout,
+  stringifyKeyEvent,
+  uid
+} from "./chunk-XVFFZZJA.js";
 export {
+  INTERACTIVE_SELECTOR,
+  NIL,
+  NOOP,
   VIRTUAL_RESOURCE,
   assignEl,
   bindAllMethods,
@@ -220,16 +60,17 @@ export {
   deepBreath,
   formatKeyForDisplay,
   formatKeyShortcutsForDisplay,
+  formatSize,
+  getActiveElement,
   getTermsForKey,
   guardAllMethods,
   guardMethod,
   inBoolArrOpt,
-  initScrollAssist,
-  initVScrollerator,
   isArr,
   isBool,
   isDef,
   isFunc,
+  isInteractive,
   isIter,
   isNum,
   isObj,
@@ -245,10 +86,9 @@ export {
   onAllMethods,
   parseForARIAKS,
   parseKeyCombo,
-  removeScrollAssist,
-  requestAnimationFrame2 as requestAnimationFrame,
+  requestAnimationFrame,
   setInterval,
-  setTimeout2 as setTimeout,
+  setTimeout,
   stringifyKeyEvent,
   uid
 };

package/dist/ripple-DcMWw_AP.d.cts

@@ -0,0 +1,71 @@
+interface OutsideClickConfig {
+    /** Enables or disables outside-click handling. Defaults to `false`. */
+    enabled?: boolean;
+    /** Callback invoked when an outside interaction is detected. Defaults to `()=>{}`. */
+    onOutsideClick?: (e: MouseEvent | TouchEvent | KeyboardEvent | FocusEvent) => void;
+    /** Whether pointer/touch outside interactions should trigger callback. Defaults to `true`. */
+    clickOnClick?: boolean;
+    /** Whether Escape key should trigger callback. Defaults to `true`. */
+    clickOnEscape?: boolean;
+    /** Whether focus leaving the container should trigger callback. Defaults to `false`. */
+    clickOnFocusOut?: boolean;
+    /** Allow interactive elements like outsiders to bypass click callback. Defaults to `true`. */
+    allowInputs?: boolean;
+    /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
+    root?: HTMLElement | Document | Window;
+    /** Whether the outside click handling is scoped to the root provided it is an HTMLElement. Defaults to `true`. */
+    scoped?: boolean;
+    /** Passed down to all event listeners used. Defaults to `true`. */
+    capture?: boolean;
+}
+/** Hook to attach outside-click, escape, and optional focus-out handling to an element. */
+declare function initOutsideClick(el: HTMLElement, { enabled, onOutsideClick, clickOnClick, clickOnEscape, clickOnFocusOut, allowInputs, root, scoped, capture }?: OutsideClickConfig): (() => void) | void;
+/** Remove outside-click handling from an element. */
+declare const removeOutsideClick: (el: HTMLElement) => void | undefined;
+
+interface FocusTrapConfig {
+    /** Enables or disables the focus trap. Defaults to `false`. */
+    enabled?: boolean;
+    /** The preferred initial focus target selector within the element. Defaults to `[data-autofocus]`. */
+    initialSelector?: string;
+    /** The class name for the initial focus ring since programmatic focus is not always visible. Defaults to `"focus-outline"`. */
+    ringClassName?: string;
+    /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
+    root?: HTMLElement | Document | Window;
+    /** Whether the focus trap is scoped to the root provided it is an HTMLElement. Defaults to `true`. */
+    scoped?: boolean;
+    /** Passed down to all event listeners used. Defaults to `true`. */
+    capture?: boolean;
+}
+/** Hook to keep focus trapped inside an element until disabled. */
+declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture }?: FocusTrapConfig): (() => void) | void;
+/** Remove the focus trap guard from an element. */
+declare const removeFocusTrap: (el: HTMLElement) => void | undefined;
+
+interface RippleConfig {
+    /** Optional explicit ripple host element. Defaults to event currentTarget. */
+    target?: HTMLElement;
+    /** Forces the ripple origin to the center of the host. By default, the ripple will originate from the pointer event coordinates. */
+    forceCenter?: boolean;
+    /** CSS class added to the ripple wrapper element. Defaults to `"t007-ripple-wrapper"`. */
+    wrapperClassName?: string;
+    /** CSS general class added to the ripple element. Defaults to `"t007-ripple"`. */
+    className?: string;
+    /** CSS class added to the ripple element while the pointer is held down. Should contain the initial expansion animation. Defaults to `"t007-ripple-hold"`. */
+    holdClassName?: string;
+    /** CSS class added to the ripple element when released. Should contain the fade-out animation. Defaults to `"t007-ripple-fade"`. */
+    fadeClassName?: string;
+}
+/** Render and control a material-style ripple animation on an element.
+ * @param e Pointer event used to place and gate the ripple.
+ * @param options Ripple configuration options.
+ * @details
+ * The ripple will be triggered on the event's currentTarget by default, but an explicit target can be provided.
+ * The ripple will originate from the pointer coordinates relative to the target, unless forceCenter is enabled.
+ * The ripple element will receive a hold class until the pointer is released, at which point it will switch to a fade class and be removed after the animation completes.
+ * Pointer events that are not left-clicks or that originate from interactive elements other than the currentTarget will be ignored to prevent interference with native behaviors.
+ */
+declare function rippleHandler(e: RipplePointerLikeEvent, { target, forceCenter, wrapperClassName, className, holdClassName, fadeClassName }?: RippleConfig): void;
+type RipplePointerLikeEvent = Pick<PointerEvent, "target" | "currentTarget" | "pointerType" | "button" | "clientX" | "clientY" | "stopPropagation">;
+
+export { type FocusTrapConfig as F, type OutsideClickConfig as O, type RippleConfig as R, initOutsideClick as a, removeOutsideClick as b, rippleHandler as c, initFocusTrap as i, removeFocusTrap as r };

package/dist/ripple-DcMWw_AP.d.ts

@@ -0,0 +1,71 @@
+interface OutsideClickConfig {
+    /** Enables or disables outside-click handling. Defaults to `false`. */
+    enabled?: boolean;
+    /** Callback invoked when an outside interaction is detected. Defaults to `()=>{}`. */
+    onOutsideClick?: (e: MouseEvent | TouchEvent | KeyboardEvent | FocusEvent) => void;
+    /** Whether pointer/touch outside interactions should trigger callback. Defaults to `true`. */
+    clickOnClick?: boolean;
+    /** Whether Escape key should trigger callback. Defaults to `true`. */
+    clickOnEscape?: boolean;
+    /** Whether focus leaving the container should trigger callback. Defaults to `false`. */
+    clickOnFocusOut?: boolean;
+    /** Allow interactive elements like outsiders to bypass click callback. Defaults to `true`. */
+    allowInputs?: boolean;
+    /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
+    root?: HTMLElement | Document | Window;
+    /** Whether the outside click handling is scoped to the root provided it is an HTMLElement. Defaults to `true`. */
+    scoped?: boolean;
+    /** Passed down to all event listeners used. Defaults to `true`. */
+    capture?: boolean;
+}
+/** Hook to attach outside-click, escape, and optional focus-out handling to an element. */
+declare function initOutsideClick(el: HTMLElement, { enabled, onOutsideClick, clickOnClick, clickOnEscape, clickOnFocusOut, allowInputs, root, scoped, capture }?: OutsideClickConfig): (() => void) | void;
+/** Remove outside-click handling from an element. */
+declare const removeOutsideClick: (el: HTMLElement) => void | undefined;
+
+interface FocusTrapConfig {
+    /** Enables or disables the focus trap. Defaults to `false`. */
+    enabled?: boolean;
+    /** The preferred initial focus target selector within the element. Defaults to `[data-autofocus]`. */
+    initialSelector?: string;
+    /** The class name for the initial focus ring since programmatic focus is not always visible. Defaults to `"focus-outline"`. */
+    ringClassName?: string;
+    /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
+    root?: HTMLElement | Document | Window;
+    /** Whether the focus trap is scoped to the root provided it is an HTMLElement. Defaults to `true`. */
+    scoped?: boolean;
+    /** Passed down to all event listeners used. Defaults to `true`. */
+    capture?: boolean;
+}
+/** Hook to keep focus trapped inside an element until disabled. */
+declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture }?: FocusTrapConfig): (() => void) | void;
+/** Remove the focus trap guard from an element. */
+declare const removeFocusTrap: (el: HTMLElement) => void | undefined;
+
+interface RippleConfig {
+    /** Optional explicit ripple host element. Defaults to event currentTarget. */
+    target?: HTMLElement;
+    /** Forces the ripple origin to the center of the host. By default, the ripple will originate from the pointer event coordinates. */
+    forceCenter?: boolean;
+    /** CSS class added to the ripple wrapper element. Defaults to `"t007-ripple-wrapper"`. */
+    wrapperClassName?: string;
+    /** CSS general class added to the ripple element. Defaults to `"t007-ripple"`. */
+    className?: string;
+    /** CSS class added to the ripple element while the pointer is held down. Should contain the initial expansion animation. Defaults to `"t007-ripple-hold"`. */
+    holdClassName?: string;
+    /** CSS class added to the ripple element when released. Should contain the fade-out animation. Defaults to `"t007-ripple-fade"`. */
+    fadeClassName?: string;
+}
+/** Render and control a material-style ripple animation on an element.
+ * @param e Pointer event used to place and gate the ripple.
+ * @param options Ripple configuration options.
+ * @details
+ * The ripple will be triggered on the event's currentTarget by default, but an explicit target can be provided.
+ * The ripple will originate from the pointer coordinates relative to the target, unless forceCenter is enabled.
+ * The ripple element will receive a hold class until the pointer is released, at which point it will switch to a fade class and be removed after the animation completes.
+ * Pointer events that are not left-clicks or that originate from interactive elements other than the currentTarget will be ignored to prevent interference with native behaviors.
+ */
+declare function rippleHandler(e: RipplePointerLikeEvent, { target, forceCenter, wrapperClassName, className, holdClassName, fadeClassName }?: RippleConfig): void;
+type RipplePointerLikeEvent = Pick<PointerEvent, "target" | "currentTarget" | "pointerType" | "button" | "clientX" | "clientY" | "stopPropagation">;
+
+export { type FocusTrapConfig as F, type OutsideClickConfig as O, type RippleConfig as R, initOutsideClick as a, removeOutsideClick as b, rippleHandler as c, initFocusTrap as i, removeFocusTrap as r };

package/dist/scrollAssist-y9wFmYgt.d.cts

@@ -0,0 +1,72 @@
+type KeyEvent = Partial<KeyboardEvent> & Pick<KeyboardEvent, "key">;
+type Config = {
+    /** Enables or disables navigation logic. Defaults to `null`. */
+    enabled?: boolean | null;
+    /** CSS selector used to collect focusable nav items. Defaults to `"[data-arrow-item]"` */
+    selector?: string;
+    /** Whether hover should also move active selection. Defaults to `true`. */
+    focusOnHover?: boolean;
+    /** Whether directional movement wraps around edges. Defaults to `true`. */
+    loop?: boolean;
+    /** Enables virtual focus (aria-activedescendant) mode. Defaults to `false`. */
+    virtual?: boolean;
+    /** Enables alphanumeric type-ahead matching. Defaults to `false`. */
+    typeahead?: boolean;
+    /** Idle timeout before clearing type-ahead buffer (ms). Defaults to `500`. */
+    resetMs?: number;
+    /** Explicit RTL override; null auto-detects from computed style. Defaults to `null`. */
+    rtl?: boolean | null;
+    /** Enables roving tabindex when not in virtual mode. Defaults to `null`. */
+    rovingTab?: boolean | null;
+    /** Default tabbable index when no active item is selected. Defaults to `null`. */
+    defaultTabbableIndex?: number | null;
+    /** Base tabindex for non-active items, use `"-1"` to kill virtual list. Defaults to `"0"`. */
+    baseTabIndex?: string;
+    /** Class applied to active item in virtual mode. Defaults to `"focus-outlined"`. */
+    activeClass?: string;
+    /** Selector used for keyboard event source in virtual mode. Defaults to `"input[value],textarea,[contenteditable='true']"`. */
+    inputSelector?: string;
+    /** Scroll behavior options used when moving active item. Defaults to `{ block: "nearest", inline: "nearest" }`. */
+    scrollIntoView?: ScrollIntoViewOptions;
+    /** Focus behavior options used in non-virtual mode. Defaults to `{ preventScroll: false }`. */
+    focusOptions?: FocusOptions;
+    /** Explicit or computed grid dimensions for navigation math. Defaults to `{}`. */
+    grid?: Partial<Record<"x" | "y" | "vY", number>>;
+    /** Callback fired when an item becomes active/selected. */
+    onSelect?: (el: HTMLElement, e: KeyEvent) => void;
+    /** Callback fired when focus leaves the navigation container. */
+    onFocusOut?: (e: FocusEvent) => void;
+};
+
+type ScrollDir = "left" | "right" | "up" | "down";
+/** Scroll assist control object returned by initScrollAssist. */
+interface ScrollAssistHandle {
+    /** Recompute assist visibility. */
+    update: () => void;
+    /** Tear down observers and assist elements. */
+    destroy: () => void;
+}
+/** Configuration for scroll assist overlays. */
+interface ScrollAssistConfig {
+    /** Scroll speed in pixels per second. Defaults to `80`. */
+    pxPerSecond?: number;
+    /** Class name applied to assist overlays. Defaults to `"t007-scroll-assist"`. */
+    assistClassName?: string;
+    /** Enable vertical assist overlays. Defaults to `true`. */
+    vertical?: boolean;
+    /** Enable horizontal assist overlays. Defaults to `true`. */
+    horizontal?: boolean;
+}
+/** Hook to add edge-scrolling assist to an element. It creates invisible "hot zones" at the edges of the element that, when hovered or dragged into, will scroll the element in that direction.
+ * The assist is automatically disabled when the element is too small or contains interactive elements near the edges to prevent interference.
+ * @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 }?: ScrollAssistConfig): ScrollAssistHandle | void;
+/** Remove scroll assist from an element.
+ * @param el Target element.
+ */
+declare const removeScrollAssist: (el: HTMLElement) => void | undefined;
+
+export { type Config as C, type KeyEvent as K, type ScrollAssistHandle as S, type ScrollAssistConfig as a, type ScrollDir as b, initScrollAssist as i, removeScrollAssist as r };