@t007/utils 0.0.33 → 0.0.34

package/dist/{arrowNavigation-VenvPI4H.d.ts → arrowNavigation-DF7ul3A3.d.ts}

@@ -1,4 +1,4 @@
-import { K as KeyEvent, C as Config } from './scrollAssist-y9wFmYgt.js';
+import { K as KeyEvent, C as Config } from './scrollAssist-l0V2H-jx.js';
 
 type ArrowNavigationHandle = {
     /** Current computed horizontal grid size. */

package/dist/{arrowNavigation-DK8mqVOk.d.cts → arrowNavigation-IaWiNTa6.d.cts}

@@ -1,4 +1,4 @@
-import { K as KeyEvent, C as Config } from './scrollAssist-y9wFmYgt.cjs';
+import { K as KeyEvent, C as Config } from './scrollAssist-l0V2H-jx.cjs';
 
 type ArrowNavigationHandle = {
     /** Current computed horizontal grid size. */

package/dist/{chunk-4O76EZJ4.js → chunk-HGUYOV3P.js}

@@ -1,42 +1,77 @@
 // 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] *)";
+import { NOOP } from "sia-reactor";
+var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable],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);
 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 ??= {};
+function loadResource(req, type = "style", { module, media, crossOrigin, integrity, referrerPolicy, nonce, fetchPriority, attempts = 3, retryKey = false } = {}, win = window) {
+  win.t007 ??= {}, win.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) => {
+  if (win.t007._resourceCache[src]) return win.t007._resourceCache[src];
+  const existing = type === "script" ? Array.prototype.find.call(win.document.scripts, (s) => isSameURL(s.src, src)) : type === "style" ? Array.prototype.find.call(win.document.styleSheets, (s) => isSameURL(s.href, src)) : null;
+  if (existing) return win.t007._resourceCache[src] = Promise.resolve(existing);
+  win.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}...`);
+          console.warn(`Retrying ${type} load for "${src}" (${attempts - remaining + 1})...`);
         } else {
-          delete w.t007._resourceCache[src];
-          reject(new Error(`${type} load failed after ${attempts} attempts: ${src}`));
+          delete win.t007._resourceCache[src];
+          reject(new Error(`${capitalize(type)} load failed for "${src}" after ${attempts - 1} attempts`));
         }
       };
       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 }) || "");
+      if (type === "script") win.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") win.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];
+  return win.t007._resourceCache[src];
 }
 function getWindow(el = window) {
-  return (el instanceof Window ? el : el instanceof Document ? el?.defaultView : el?.ownerDocument?.defaultView) ?? void 0;
+  return el?.ownerDocument?.defaultView ?? el?.defaultView ?? window;
+}
+function createListRenderer({ container, getKey, createNode, updateNode = NOOP, destroyNode = NOOP }) {
+  let nodeRegistry = /* @__PURE__ */ new Map();
+  return function syncDOM(array, strict = true) {
+    const newRegistry = /* @__PURE__ */ new Map(), seenKeys = /* @__PURE__ */ new Set(), oldPositions = /* @__PURE__ */ new WeakMap(), children = Array.from(container.children);
+    for (let i = 0, len = children.length; i < len; i++) oldPositions.set(children[i], i);
+    const futureNodes = [], oldIndices = [];
+    for (let i = 0, len = array.length; i < len; i++) {
+      const item = array[i], key = getKey(item);
+      if (seenKeys.has(key)) throw new Error(`[List Renderer] Duplicate key "${key}" detected`);
+      let node = nodeRegistry.get(key);
+      if (!node) {
+        node = createNode(item);
+        if (!node) {
+          if (strict) throw new Error(`[List Renderer] No HTMLElement for key "${key}"`);
+          continue;
+        }
+        oldIndices.push(-1);
+      } else updateNode(node, item), oldIndices.push(oldPositions.get(node) ?? -1);
+      seenKeys.add(key), futureNodes.push(node), newRegistry.set(key, node);
+    }
+    for (const [key, node] of nodeRegistry.entries()) !seenKeys.has(key) && node.parentElement === container && (destroyNode(node, key), node.remove());
+    const sequence = longestIncreasingSubsequence(oldIndices), stable = new Set(sequence);
+    let anchor = null;
+    for (let i = futureNodes.length - 1; i >= 0; i--) {
+      const node = futureNodes[i];
+      if (oldIndices[i] !== -1 && stable.has(i)) {
+        anchor = node;
+        continue;
+      }
+      container.insertBefore(node, anchor), anchor = node;
+    }
+    nodeRegistry = newRegistry;
+  };
 }
 
 // src/ts/index.ts
-import { NIL, NOOP } from "sia-reactor";
+import { NIL, NOOP as NOOP2 } from "sia-reactor";
 
 // src/ts/core/obj.ts
 import { isObj } from "sia-reactor/utils";
@@ -73,11 +108,42 @@ function inBoolArrOpt(opt, str) {
 
 // src/ts/core/num.ts
 import { clamp } from "sia-reactor/utils";
+function longestIncreasingSubsequence(array) {
+  const n = array.length, parent = new Array(n), tails = [];
+  for (let i = 0; i < n; i++) {
+    const value = array[i];
+    if (value === -1) continue;
+    let left = 0;
+    let right = tails.length;
+    while (left < right) {
+      const mid = left + right >> 1;
+      if (array[tails[mid]] < value) left = mid + 1;
+      else right = mid;
+    }
+    if (left > 0) parent[i] = tails[left - 1];
+    else parent[i] = -1;
+    tails[left] = i;
+  }
+  if (!tails.length) return [];
+  const result = [];
+  let k = tails[tails.length - 1];
+  while (k >= 0) result.push(k), k = parent[k];
+  return result.reverse(), result;
+}
 
 // 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);
 }
+function capitalize(word = "") {
+  return word.replace(/^(\s*)([a-z])/i, (_, s, l) => s + l.toUpperCase());
+}
+function camelize(str = "", { source } = /[\s_-]+/, { preserveInnerCase: pIC = true, upperFirst: uF = false } = {}) {
+  return (pIC ? str : str.toLowerCase()).replace(new RegExp(source + "(\\w)", "g"), (_, c) => c.toUpperCase()).replace(/^\w/, (c) => c[uF ? "toUpperCase" : "toLowerCase"]());
+}
+function uncamelize(str, separator = " ") {
+  return str.replace(/([a-z])([A-Z])/g, `$1${separator}$2`).toLowerCase();
+}
 function remToPx(rem, el = document.documentElement) {
   return rem * parseFloat(getComputedStyle(el).fontSize);
 }
@@ -99,12 +165,42 @@ function cleanURL(url) {
   }
 }
 function isSameURL(url1, url2) {
+  if (url1 === url2) return true;
   if (!isStr(url1) || !isStr(url2) || !url1 || !url2) return false;
   return cleanURL(url1) === cleanURL(url2);
 }
 
 // src/ts/core/fn.ts
 import { setTimeout as setTimeout2, setInterval, requestAnimationFrame } from "sia-reactor/utils";
+function throttle(key, fn, delay = 30, strict = true, signal, win) {
+  const throttleMap = t007._throttlers ??= /* @__PURE__ */ new Map();
+  if (strict === true) {
+    const now = performance.now();
+    return now - (throttleMap.get(key) ?? 0) < delay ? void 0 : (throttleMap.set(key, now), fn());
+  }
+  if (throttleMap.has(key)) return;
+  const id = strict === false ? setTimeout2(() => throttleMap.delete(key), delay, signal, win) : strict(() => throttleMap.delete(key));
+  return throttleMap.set(key, id), fn();
+}
+function debounce(key, fn, delay = 30, strict = true, signal, win) {
+  const debounceMap = t007._debouncers ??= /* @__PURE__ */ new Map();
+  if (strict) {
+    const now = performance.now(), prev = debounceMap.get(key) ?? 0;
+    return debounceMap.set(key, now), now - prev < delay ? void 0 : fn();
+  }
+  const prevId = debounceMap.get(key);
+  prevId !== void 0 && (win ?? window).clearTimeout(prevId);
+  const id = setTimeout2(() => (debounceMap.delete(key), fn()), delay, signal, win);
+  return void debounceMap.set(key, id);
+}
+function RAFLoop(key, fn, signal, win) {
+  const rafLoopMap = t007._RAFLoopers ??= /* @__PURE__ */ new Map();
+  if (rafLoopMap.has(key)) return void rafLoopMap.set(key, fn);
+  rafLoopMap.set(key, fn);
+  const loop = (_ = 0, fn2 = rafLoopMap.get(key)) => fn2 && (fn2(), requestAnimationFrame(loop, signal, win));
+  loop();
+}
+var cancelRAFLoop = (key) => t007._RAFLoopers ? t007._RAFLoopers.delete(key) : false;
 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));
@@ -118,7 +214,7 @@ function limited(FN_KEY, fn, opts = {}) {
   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 mockAsync = (timeout = 250) => new Promise((resolve) => setTimeout2(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) {
@@ -128,7 +224,7 @@ function bindCleanupToSignal(cleanup, signal) {
 }
 
 // src/ts/core/keys.ts
-import { parseKeyCombo, stringifyKeyEvent, cleanKeyCombo, matchKeys, getTermsForKey, keyEventAllowed, formatKeyForDisplay, formatKeyShortcutsForDisplay, parseForARIAKS } from "sia-reactor/utils";
+import { KEYS_BLOCKS, parseKeyCombo, stringifyKeyEvent, cleanKeyCombo, matchKeys, getTermsForKey, keyEventAllowed, formatKeyForDisplay, formatKeyShortcutsForDisplay, parseForARIAKS } from "sia-reactor/utils";
 
 // src/ts/core/file.ts
 function formatSize(bytes, decimals = 3, base = 1e3) {
@@ -159,6 +255,7 @@ export {
   VIRTUAL_RESOURCE,
   loadResource,
   getWindow,
+  createListRenderer,
   getActiveEl,
   isObj,
   isDef,
@@ -171,22 +268,31 @@ export {
   isIter,
   isFunc,
   inBoolArrOpt,
+  longestIncreasingSubsequence,
   clamp,
   uid,
+  capitalize,
+  camelize,
+  uncamelize,
   remToPx,
   pxToRem,
   parseCSSTime,
   parseCSSSize,
   cleanURL,
   isSameURL,
+  setTimeout2 as setTimeout,
+  setInterval,
+  requestAnimationFrame,
+  throttle,
+  debounce,
+  RAFLoop,
+  cancelRAFLoop,
   limited,
   mockAsync,
   breath,
   deepBreath,
   bindCleanupToSignal,
-  setTimeout2 as setTimeout,
-  setInterval,
-  requestAnimationFrame,
+  KEYS_BLOCKS,
   parseKeyCombo,
   stringifyKeyEvent,
   cleanKeyCombo,
@@ -202,5 +308,5 @@ export {
   guardAllMethods,
   guardMethod,
   NIL,
-  NOOP
+  NOOP2 as NOOP
 };

package/dist/{chunk-QJ72EQCJ.js → chunk-ZRCBB5P4.js}

@@ -4,7 +4,7 @@ import {
   createEl,
   getActiveEl,
   isInteractive
-} from "./chunk-4O76EZJ4.js";
+} from "./chunk-HGUYOV3P.js";
 
 // src/ts/hooks/vanilla/outsideClick.ts
 import { NIL, NOOP } from "sia-reactor";
@@ -67,7 +67,7 @@ var removeFocusTrap = (el) => t007._ftrappers?.get(el)?.();
 
 // 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) {
+function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t007-ripple-wrapper", className = "t007-ripple", holdClassName = "t007-ripple-hold", fadeClassName = "t007-ripple-fade", maxDuration = 1e3 } = NIL3) {
   const el = target || e.currentTarget;
   if (!el || e.target !== e.currentTarget && isInteractive(e.target) || el.hasAttribute("disabled") || e.pointerType === "mouse" && e.button !== 0) return;
   e.stopPropagation?.();
@@ -75,10 +75,13 @@ function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t00
   let canRelease = false;
   ripple.addEventListener("animationend", () => canRelease = true, { once: true });
   el.append(wrapper.appendChild(ripple).parentElement);
-  const release = () => {
-    if (!canRelease) return ripple.addEventListener("animationend", release, { once: true });
+  let released = false;
+  const release = (force) => {
+    if (released) return;
+    if (!canRelease && force !== true) return ripple.addEventListener("animationend", release, { once: true }), void setTimeout(release, maxDuration, true);
+    released = true;
     ripple.classList.replace(holdClassName, fadeClassName);
-    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove()));
+    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove())), setTimeout(() => wrapper.remove(), maxDuration);
     for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).removeEventListener(evt, release);
   };
   for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).addEventListener(evt, release);
@@ -147,7 +150,7 @@ var DEFAULT_CONFIG = {
   rtl: null,
   grid: {},
   activeClass: "focus-outlined",
-  inputSelector: "input,textarea,[contenteditable='true']",
+  inputSelector: "input,textarea,[contenteditable]",
   focusOptions: { preventScroll: false },
   scrollIntoView: { block: "nearest", inline: "nearest" },
   onSelect: NOOP2,

package/dist/components/react.d.cts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { H as HighlightOptions } from '../useHighlight-DMpDCILK.cjs';
+import { H as HighlightOptions } from '../useHighlight-DYc_GF0R.cjs';
 
 interface HighlightTextProps extends HighlightOptions {
     /** The text to be processed and displayed. */

package/dist/components/react.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { H as HighlightOptions } from '../useHighlight-DMpDCILK.js';
+import { H as HighlightOptions } from '../useHighlight-DYc_GF0R.js';
 
 interface HighlightTextProps extends HighlightOptions {
     /** The text to be processed and displayed. */

package/dist/hooks/react.cjs

@@ -38,12 +38,13 @@ var import_utils = require("sia-reactor/utils");
 // 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 import_sia_reactor = require("sia-reactor");
+var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable],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/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) {
+var import_sia_reactor2 = require("sia-reactor");
+function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = import_sia_reactor2.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);
   const update = (0, import_react.useCallback)(() => {
     const el = ref.current;
@@ -124,8 +125,8 @@ function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassNam
 var import_react2 = require("react");
 
 // src/ts/hooks/vanilla/outsideClick.ts
-var import_sia_reactor2 = require("sia-reactor");
-function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor2.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowBounds = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor2.NIL) {
+var import_sia_reactor3 = require("sia-reactor");
+function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor3.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowBounds = 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);
   if (!enabled || existing) return existing ? existing : void 0;
   scoped = scoped && root instanceof HTMLElement, root = scoped ? root : root === document ? document : window;
@@ -147,8 +148,8 @@ function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor2
 }
 
 // src/ts/hooks/react/useOutsideClick.ts
-var import_sia_reactor3 = require("sia-reactor");
-function useOutsideClick(ref, config = import_sia_reactor3.NIL) {
+var import_sia_reactor4 = require("sia-reactor");
+function useOutsideClick(ref, config = import_sia_reactor4.NIL) {
   (0, import_react2.useEffect)(() => ref.current ? initOutsideClick(ref.current, config) : void 0, [ref, config.enabled, config.onOutside, config.outOnEscape, config.outOnClick, config.outOnFocusOut, config.allowBounds, config.allowInputs, config.root, config.scoped, config.capture]);
 }
 
@@ -200,7 +201,7 @@ var getGrid = (all, x = true, y = true, vY = true) => {
 };
 
 // src/ts/hooks/react/useArrowNavigation/consts.ts
-var import_sia_reactor4 = require("sia-reactor");
+var import_sia_reactor5 = require("sia-reactor");
 var H_NAV_KEYS = ["ArrowRight", "ArrowLeft", "Home", "End"];
 var V_NAV_KEYS = ["ArrowUp", "ArrowDown", "PageDown", "PageUp"];
 var NAV_KEYS = [...H_NAV_KEYS, ...V_NAV_KEYS];
@@ -218,11 +219,11 @@ var DEFAULT_CONFIG = {
   rtl: null,
   grid: {},
   activeClass: "focus-outlined",
-  inputSelector: "input,textarea,[contenteditable='true']",
+  inputSelector: "input,textarea,[contenteditable]",
   focusOptions: { preventScroll: false },
   scrollIntoView: { block: "nearest", inline: "nearest" },
-  onSelect: import_sia_reactor4.NOOP,
-  onFocusOut: import_sia_reactor4.NOOP
+  onSelect: import_sia_reactor5.NOOP,
+  onFocusOut: import_sia_reactor5.NOOP
 };
 
 // src/ts/hooks/react/useArrowNavigation/index.ts
@@ -378,8 +379,8 @@ function useArrowNavigation(containerRef, config = {}) {
 var import_react4 = require("react");
 
 // 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) {
+var import_sia_reactor6 = require("sia-reactor");
+function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true } = import_sia_reactor6.NIL) {
   const stacks = t007._ftrappers_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._ftrappers ??= /* @__PURE__ */ new WeakMap()).get(el);
   if (!enabled || existing) return existing ? existing : void 0;
   scoped = scoped && root instanceof HTMLElement, root = scoped ? root : root === document ? document : window;
@@ -412,8 +413,8 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
 }
 
 // src/ts/hooks/react/useFocusTrap.ts
-var import_sia_reactor6 = require("sia-reactor");
-function useFocusTrap(ref, config = import_sia_reactor6.NIL) {
+var import_sia_reactor7 = require("sia-reactor");
+function useFocusTrap(ref, config = import_sia_reactor7.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]);
 }
 
@@ -434,8 +435,8 @@ function useHighlight(text, query, ignoreCase = true, options) {
 var import_react6 = require("react");
 
 // 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) {
+var import_sia_reactor8 = require("sia-reactor");
+function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t007-ripple-wrapper", className = "t007-ripple", holdClassName = "t007-ripple-hold", fadeClassName = "t007-ripple-fade", maxDuration = 1e3 } = import_sia_reactor8.NIL) {
   const el = target || e.currentTarget;
   if (!el || e.target !== e.currentTarget && isInteractive(e.target) || el.hasAttribute("disabled") || e.pointerType === "mouse" && e.button !== 0) return;
   e.stopPropagation?.();
@@ -443,19 +444,22 @@ function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t00
   let canRelease = false;
   ripple.addEventListener("animationend", () => canRelease = true, { once: true });
   el.append(wrapper.appendChild(ripple).parentElement);
-  const release = () => {
-    if (!canRelease) return ripple.addEventListener("animationend", release, { once: true });
+  let released = false;
+  const release = (force) => {
+    if (released) return;
+    if (!canRelease && force !== true) return ripple.addEventListener("animationend", release, { once: true }), void setTimeout(release, maxDuration, true);
+    released = true;
     ripple.classList.replace(holdClassName, fadeClassName);
-    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove()));
+    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove())), setTimeout(() => wrapper.remove(), maxDuration);
     for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).removeEventListener(evt, release);
   };
   for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).addEventListener(evt, release);
 }
 
 // src/ts/hooks/react/useRipple.ts
-var import_sia_reactor8 = require("sia-reactor");
+var import_sia_reactor9 = require("sia-reactor");
 function useRipple() {
-  return (0, import_react6.useCallback)((e, config = import_sia_reactor8.NIL) => rippleHandler(e.nativeEvent, config), []);
+  return (0, import_react6.useCallback)((e, config = import_sia_reactor9.NIL) => rippleHandler(e.nativeEvent, config), []);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/hooks/react.d.cts

@@ -1,11 +1,11 @@
 import { RefObject } from 'react';
-import { a as ScrollAssistConfig, C as Config, K as KeyEvent } from '../scrollAssist-y9wFmYgt.cjs';
-import { O as OutsideClickConfig, F as FocusTrapConfig, R as RippleConfig } from '../ripple-C5MfEErC.cjs';
-export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DMpDCILK.cjs';
+import { a as ScrollAssistConfig, C as Config, K as KeyEvent } from '../scrollAssist-l0V2H-jx.cjs';
+import { O as OutsideClickConfig, F as FocusTrapConfig, R as RippleConfig } from '../ripple-87VO-U7A.cjs';
+export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DYc_GF0R.cjs';
 
 /** Configuration options for the `useScrollAssist` hook. */
 interface UseScrollAssistConfig extends ScrollAssistConfig {
-    /** Enables or disables the scroll assist. Defaults to `true`. */
+    /** Enables or disables the scroll assist. @default  `true`. */
     enabled?: boolean;
 }
 /** React 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.

package/dist/hooks/react.d.ts

@@ -1,11 +1,11 @@
 import { RefObject } from 'react';
-import { a as ScrollAssistConfig, C as Config, K as KeyEvent } from '../scrollAssist-y9wFmYgt.js';
-import { O as OutsideClickConfig, F as FocusTrapConfig, R as RippleConfig } from '../ripple-C5MfEErC.js';
-export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DMpDCILK.js';
+import { a as ScrollAssistConfig, C as Config, K as KeyEvent } from '../scrollAssist-l0V2H-jx.js';
+import { O as OutsideClickConfig, F as FocusTrapConfig, R as RippleConfig } from '../ripple-87VO-U7A.js';
+export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DYc_GF0R.js';
 
 /** Configuration options for the `useScrollAssist` hook. */
 interface UseScrollAssistConfig extends ScrollAssistConfig {
-    /** Enables or disables the scroll assist. Defaults to `true`. */
+    /** Enables or disables the scroll assist. @default  `true`. */
     enabled?: boolean;
 }
 /** React 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.

package/dist/hooks/react.js

@@ -11,11 +11,11 @@ import {
   initFocusTrap,
   initOutsideClick,
   rippleHandler
-} from "../chunk-QJ72EQCJ.js";
+} from "../chunk-ZRCBB5P4.js";
 import {
   INTERACTIVE_SELECTOR,
   getActiveEl
-} from "../chunk-4O76EZJ4.js";
+} from "../chunk-HGUYOV3P.js";
 
 // src/ts/hooks/react/useScrollAssist.ts
 import { useEffect, useRef, useCallback } from "react";

package/dist/hooks/vanilla.cjs

@@ -34,19 +34,20 @@ __export(vanilla_exports, {
 module.exports = __toCommonJS(vanilla_exports);
 
 // src/ts/hooks/vanilla/scrollAssist.ts
-var import_sia_reactor = require("sia-reactor");
+var import_sia_reactor2 = require("sia-reactor");
 
 // 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 import_sia_reactor = require("sia-reactor");
+var INTERACTIVE_SELECTOR = ":is(button,[href],input:not([type='hidden']),select,textarea,details>summary,[contenteditable],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/ts/core/num.ts
 var import_utils3 = require("sia-reactor/utils");
 
 // src/ts/hooks/vanilla/scrollAssist.ts
-function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = import_sia_reactor.NIL) {
+function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll-assist", vertical = true, horizontal = true } = import_sia_reactor2.NIL) {
   const parent = el?.parentElement, existing = (t007._scrollers ??= /* @__PURE__ */ new WeakMap()).get(el);
   if (!parent || existing) return existing ? existing : void 0;
   t007._scrollers_r_observer ??= new ResizeObserver((entries) => {
@@ -118,8 +119,8 @@ function initScrollAssist(el, { pxPerSecond = 80, assistClassName = "t007-scroll
 var removeScrollAssist = (el) => t007._scrollers.get(el)?.destroy();
 
 // 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) {
+var import_sia_reactor3 = require("sia-reactor");
+function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, baseRate = 16, lineHeight = 80, margin = 80, car = window } = import_sia_reactor3.NIL) {
   let linesPerSec = baseSpeed, accelId = null, lastTime = null;
   const drive = (clientY, brake = false, offsetY = 0) => {
     if (car !== window) clientY -= offsetY;
@@ -135,8 +136,8 @@ function initVScrollerator({ baseSpeed = 3, maxSpeed = 10, stepDelay = 2e3, base
 }
 
 // src/ts/hooks/vanilla/outsideClick.ts
-var import_sia_reactor3 = require("sia-reactor");
-function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor3.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowBounds = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor3.NIL) {
+var import_sia_reactor4 = require("sia-reactor");
+function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor4.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowBounds = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor4.NIL) {
   const stacks = t007._outsiders_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._outsiders ??= /* @__PURE__ */ new WeakMap()).get(el);
   if (!enabled || existing) return existing ? existing : void 0;
   scoped = scoped && root instanceof HTMLElement, root = scoped ? root : root === document ? document : window;
@@ -159,8 +160,8 @@ function initOutsideClick(el, { enabled = false, onOutside = import_sia_reactor3
 var removeOutsideClick = (el) => t007._outsiders?.get(el)?.();
 
 // 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) {
+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);
   if (!enabled || existing) return existing ? existing : void 0;
   scoped = scoped && root instanceof HTMLElement, root = scoped ? root : root === document ? document : window;
@@ -194,7 +195,7 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
 var removeFocusTrap = (el) => t007._ftrappers?.get(el)?.();
 
 // src/ts/hooks/react/useArrowNavigation/consts.ts
-var import_sia_reactor5 = require("sia-reactor");
+var import_sia_reactor6 = require("sia-reactor");
 var H_NAV_KEYS = ["ArrowRight", "ArrowLeft", "Home", "End"];
 var V_NAV_KEYS = ["ArrowUp", "ArrowDown", "PageDown", "PageUp"];
 var NAV_KEYS = [...H_NAV_KEYS, ...V_NAV_KEYS];
@@ -212,11 +213,11 @@ var DEFAULT_CONFIG = {
   rtl: null,
   grid: {},
   activeClass: "focus-outlined",
-  inputSelector: "input,textarea,[contenteditable='true']",
+  inputSelector: "input,textarea,[contenteditable]",
   focusOptions: { preventScroll: false },
   scrollIntoView: { block: "nearest", inline: "nearest" },
-  onSelect: import_sia_reactor5.NOOP,
-  onFocusOut: import_sia_reactor5.NOOP
+  onSelect: import_sia_reactor6.NOOP,
+  onFocusOut: import_sia_reactor6.NOOP
 };
 
 // src/ts/hooks/react/useArrowNavigation/utils.ts
@@ -377,8 +378,8 @@ function initArrowNavigation(container, config = {}) {
 var removeArrowNavigation = (container) => t007._arrownavs?.get(container)?.destroy();
 
 // 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) {
+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", maxDuration = 1e3 } = import_sia_reactor7.NIL) {
   const el = target || e.currentTarget;
   if (!el || e.target !== e.currentTarget && isInteractive(e.target) || el.hasAttribute("disabled") || e.pointerType === "mouse" && e.button !== 0) return;
   e.stopPropagation?.();
@@ -386,10 +387,13 @@ function rippleHandler(e, { target, forceCenter = false, wrapperClassName = "t00
   let canRelease = false;
   ripple.addEventListener("animationend", () => canRelease = true, { once: true });
   el.append(wrapper.appendChild(ripple).parentElement);
-  const release = () => {
-    if (!canRelease) return ripple.addEventListener("animationend", release, { once: true });
+  let released = false;
+  const release = (force) => {
+    if (released) return;
+    if (!canRelease && force !== true) return ripple.addEventListener("animationend", release, { once: true }), void setTimeout(release, maxDuration, true);
+    released = true;
     ripple.classList.replace(holdClassName, fadeClassName);
-    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove()));
+    ripple.addEventListener("animationend", () => setTimeout(() => wrapper.remove())), setTimeout(() => wrapper.remove(), maxDuration);
     for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).removeEventListener(evt, release);
   };
   for (const evt of ["pointerup", "pointercancel"]) (el.ownerDocument?.defaultView || window).addEventListener(evt, release);

package/dist/hooks/vanilla.d.cts

@@ -1,22 +1,22 @@
-export { a as ScrollAssistConfig, S as ScrollAssistHandle, b as ScrollDir, i as initScrollAssist, r as removeScrollAssist } from '../scrollAssist-y9wFmYgt.cjs';
-export { F as FocusTrapConfig, O as OutsideClickConfig, R as RippleConfig, i as initFocusTrap, a as initOutsideClick, r as removeFocusTrap, b as removeOutsideClick, c as rippleHandler } from '../ripple-C5MfEErC.cjs';
-export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation } from '../arrowNavigation-DK8mqVOk.cjs';
+export { a as ScrollAssistConfig, S as ScrollAssistHandle, b as ScrollDir, i as initScrollAssist, r as removeScrollAssist } from '../scrollAssist-l0V2H-jx.cjs';
+export { F as FocusTrapConfig, O as OutsideClickConfig, R as RippleConfig, i as initFocusTrap, a as initOutsideClick, r as removeFocusTrap, b as removeOutsideClick, c as rippleHandler } from '../ripple-87VO-U7A.cjs';
+export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation } from '../arrowNavigation-IaWiNTa6.cjs';
 
 /** Configuration for the vertical edge-scrolling helper. */
 interface ScrolleratorOptions {
-    /** Starting lines-per-second speed. Defaults to `3`. */
+    /** Starting lines-per-second speed. @default  `3`. */
     baseSpeed?: number;
-    /** Maximum accelerated speed. Defaults to `10`. */
+    /** Maximum accelerated speed. @default  `10`. */
     maxSpeed?: number;
-    /** Delay before acceleration kicks in. Defaults to `2000`. */
+    /** Delay before acceleration kicks in. @default  `2000`. */
     stepDelay?: number;
-    /** Base frame rate used to estimate movement. Defaults to `16`. */
+    /** Base frame rate used to estimate movement. @default  `16`. */
     baseRate?: number;
-    /** Approximate line height in pixels. Defaults to `80`. */
+    /** Approximate line height in pixels. @default  `80`. */
     lineHeight?: number;
-    /** Edge margin that triggers scrolling. Defaults to `80`. */
+    /** Edge margin that triggers scrolling. @default  `80`. */
     margin?: number;
-    /** Scroll container or window target. Defaults to `window`. */
+    /** Scroll container or window target. @default  `window`. */
     car?: Window | HTMLElement;
 }
 /** Scrolling controls returned by initVScrollerator. */