@t007/utils 0.0.36 → 0.0.38

package/dist/{arrowNavigation-B9bEdoqR.d.ts → arrowNavigation-C5asxLP0.d.ts}

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

package/dist/{arrowNavigation-zEJbo8Er.d.cts → arrowNavigation-PxYXKmCY.d.cts}

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

package/dist/{chunk-DSDFIB5F.js → chunk-GCJ5LPEB.js}

@@ -4,7 +4,7 @@ import {
   createEl,
   getActiveEl,
   isInteractive
-} from "./chunk-ZOFWWRKV.js";
+} from "./chunk-ZFW6HNGO.js";
 
 // src/ts/hooks/vanilla/outsideClick.ts
 import { NIL, NOOP } from "sia-reactor";
@@ -31,20 +31,20 @@ var removeOutsideClick = (el) => t007._outsiders?.get(el)?.();
 
 // src/ts/hooks/vanilla/focusTrap.ts
 import { NIL as NIL2 } from "sia-reactor";
-function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true } = NIL2) {
+function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true, focusOptions } = NIL2) {
   const stack = t007._ftrappers_stack ??= [], 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;
   let recovering = false;
-  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = createEl("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = createEl("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus() : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus()), recovering = false), edgeFocus = (pre = false, rt = root) => {
+  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = createEl("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = createEl("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus(focusOptions) : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus(focusOptions)), recovering = false), edgeFocus = (pre = false, rt = root) => {
     if (!scoped) return resetFocus(pre ? -1 : 0);
-    if (rt.hasAttribute("tabindex")) return rt.focus();
+    if (rt.hasAttribute("tabindex")) return rt.focus(focusOptions);
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
     const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
     let p = rt.parentElement || ceil, all = getFocusable(p);
     while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
-    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
+    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus(focusOptions);
     (pre ? first : last).blur();
   }, handleFocusIn = (e) => {
     if (document.querySelector("dialog:modal") && !el.matches("dialog:modal")) return;
@@ -53,9 +53,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
   first.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus(true) : resetFocus(), capture), el.prepend(first);
   last.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus() : resetFocus(-1), capture), el.append(last);
   root.addEventListener("focusin", handleFocusIn, capture);
-  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(), initial.addEventListener("blur", handleInitialBlur, capture)));
+  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(focusOptions), initial.addEventListener("blur", handleInitialBlur, capture)));
   const destroy = () => {
-    focused?.isConnected && focused.focus(), first.remove(), last.remove();
+    focused?.isConnected && focused.focus(focusOptions), first.remove(), last.remove();
     root.removeEventListener("focusin", handleFocusIn, capture);
     initial?.removeEventListener("blur", handleInitialBlur, capture);
     t007._ftrappers.delete(el), stack.splice(stack.indexOf(el), 1);

package/dist/{chunk-ZOFWWRKV.js → chunk-ZFW6HNGO.js}

@@ -186,16 +186,11 @@ function throttle(key, fn, delay = 30, strict = true, signal, win) {
   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);
+function debounce(key, fn, delay = 30, strict = false, signal, win) {
+  const debounceMap = t007._debouncers ??= /* @__PURE__ */ new Map(), prevId = debounceMap.get(key), callNow = strict && prevId === void 0;
   prevId !== void 0 && (win ?? window).clearTimeout(prevId);
-  const id = setTimeout2(() => (debounceMap.delete(key), fn()), delay, signal, win);
-  return void debounceMap.set(key, id);
+  const id = setTimeout2(() => (debounceMap.delete(key), !strict && fn()), delay, signal, win);
+  return debounceMap.set(key, id), callNow ? fn() : void 0;
 }
 function RAFLoop(key, fn, signal, win) {
   const rafLoopMap = t007._RAFLoopers ??= /* @__PURE__ */ new Map();
@@ -206,10 +201,10 @@ function RAFLoop(key, fn, signal, win) {
 }
 var cancelRAFLoop = (key) => t007._RAFLoopers ? t007._RAFLoopers.delete(key) : false;
 function limited(FN_KEY, fn, opts = {}) {
-  let count = 0, { key, maxTimes: max = 1, oncePerSession = true } = isStr(opts) ? { key: opts } : opts;
+  let count = 0, { key, maxTimes: max = 1, perSession = key != null } = 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 (oncePerSession && count > 0) return void 0;
+    if (perSession && count >= +perSession) return;
     if (!key) return count++ < max ? fn(...args) : void 0;
     const r = getReg(), c = r[key] || 0;
     return c < max ? (count++, r[key] = c + 1, setReg(r), fn(...args)) : void 0;

package/dist/hooks/react.cjs

@@ -384,20 +384,20 @@ var import_react4 = require("react");
 
 // src/ts/hooks/vanilla/focusTrap.ts
 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) {
+function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true, focusOptions } = import_sia_reactor6.NIL) {
   const stack = t007._ftrappers_stack ??= [], 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;
   let recovering = false;
-  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = (0, import_utils2.createEl)("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = (0, import_utils2.createEl)("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus() : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus()), recovering = false), edgeFocus = (pre = false, rt = root) => {
+  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = (0, import_utils2.createEl)("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = (0, import_utils2.createEl)("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus(focusOptions) : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus(focusOptions)), recovering = false), edgeFocus = (pre = false, rt = root) => {
     if (!scoped) return resetFocus(pre ? -1 : 0);
-    if (rt.hasAttribute("tabindex")) return rt.focus();
+    if (rt.hasAttribute("tabindex")) return rt.focus(focusOptions);
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
     const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
     let p = rt.parentElement || ceil, all = getFocusable(p);
     while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
-    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
+    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus(focusOptions);
     (pre ? first : last).blur();
   }, handleFocusIn = (e) => {
     if (document.querySelector("dialog:modal") && !el.matches("dialog:modal")) return;
@@ -406,9 +406,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
   first.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus(true) : resetFocus(), capture), el.prepend(first);
   last.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus() : resetFocus(-1), capture), el.append(last);
   root.addEventListener("focusin", handleFocusIn, capture);
-  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(), initial.addEventListener("blur", handleInitialBlur, capture)));
+  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(focusOptions), initial.addEventListener("blur", handleInitialBlur, capture)));
   const destroy = () => {
-    focused?.isConnected && focused.focus(), first.remove(), last.remove();
+    focused?.isConnected && focused.focus(focusOptions), first.remove(), last.remove();
     root.removeEventListener("focusin", handleFocusIn, capture);
     initial?.removeEventListener("blur", handleInitialBlur, capture);
     t007._ftrappers.delete(el), stack.splice(stack.indexOf(el), 1);
@@ -421,10 +421,7 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
 var import_sia_reactor7 = require("sia-reactor");
 function useFocusTrap(ref, config = import_sia_reactor7.NIL) {
   const handle = (0, import_react4.useRef)(void 0);
-  (0, import_react4.useEffect)(() => {
-    if (!ref.current) return;
-    return handle.current = initFocusTrap(ref.current, config), () => handle.current?.destroy();
-  }, [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture]);
+  (0, import_react4.useEffect)(() => (!ref.current ? void 0 : handle.current = initFocusTrap(ref.current, config), () => handle.current?.destroy()), [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture, config.focusOptions]);
   return { sync: () => handle.current?.sync() };
 }
 

package/dist/hooks/react.d.cts

@@ -1,5 +1,5 @@
 import { RefObject } from 'react';
-import { a as ScrollAssistConfig, C as Config, K as KeyEvent, b as FocusTrapConfig } from '../scrollAssist-BNvPnsJq.cjs';
+import { a as ScrollAssistConfig, C as Config, K as KeyEvent, b as FocusTrapConfig } from '../scrollAssist-CGZBNw6D.cjs';
 import { O as OutsideClickConfig, R as RippleConfig } from '../ripple-D1kGErTn.cjs';
 export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DYc_GF0R.cjs';
 

package/dist/hooks/react.d.ts

@@ -1,5 +1,5 @@
 import { RefObject } from 'react';
-import { a as ScrollAssistConfig, C as Config, K as KeyEvent, b as FocusTrapConfig } from '../scrollAssist-BNvPnsJq.js';
+import { a as ScrollAssistConfig, C as Config, K as KeyEvent, b as FocusTrapConfig } from '../scrollAssist-CGZBNw6D.js';
 import { O as OutsideClickConfig, R as RippleConfig } from '../ripple-D1kGErTn.js';
 export { H as HighlightOptions, u as useHighlight } from '../useHighlight-DYc_GF0R.js';
 

package/dist/hooks/react.js

@@ -1,6 +1,3 @@
-import {
-  useHighlight
-} from "../chunk-RXMKMD3E.js";
 import {
   DEFAULT_CONFIG,
   H_NAV_KEYS,
@@ -11,11 +8,14 @@ import {
   initFocusTrap,
   initOutsideClick,
   rippleHandler
-} from "../chunk-DSDFIB5F.js";
+} from "../chunk-GCJ5LPEB.js";
 import {
   INTERACTIVE_SELECTOR,
   getActiveEl
-} from "../chunk-ZOFWWRKV.js";
+} from "../chunk-ZFW6HNGO.js";
+import {
+  useHighlight
+} from "../chunk-RXMKMD3E.js";
 
 // src/ts/hooks/react/useScrollAssist.ts
 import { useEffect, useRef, useCallback } from "react";
@@ -264,10 +264,7 @@ import { useEffect as useEffect4, useRef as useRef3 } from "react";
 import { NIL as NIL3 } from "sia-reactor";
 function useFocusTrap(ref, config = NIL3) {
   const handle = useRef3(void 0);
-  useEffect4(() => {
-    if (!ref.current) return;
-    return handle.current = initFocusTrap(ref.current, config), () => handle.current?.destroy();
-  }, [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture]);
+  useEffect4(() => (!ref.current ? void 0 : handle.current = initFocusTrap(ref.current, config), () => handle.current?.destroy()), [ref, config.enabled, config.initialSelector, config.ringClassName, config.root, config.scoped, config.capture, config.focusOptions]);
   return { sync: () => handle.current?.sync() };
 }
 

package/dist/hooks/vanilla.cjs

@@ -162,20 +162,20 @@ var removeOutsideClick = (el) => t007._outsiders?.get(el)?.();
 
 // 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) {
+function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus]", ringClassName = "focus-outline", root = window, scoped = true, capture = true, focusOptions } = import_sia_reactor5.NIL) {
   const stack = t007._ftrappers_stack ??= [], 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;
   let recovering = false;
-  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = (0, import_utils.createEl)("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = (0, import_utils.createEl)("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus() : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus()), recovering = false), edgeFocus = (pre = false, rt = root) => {
+  const focused = document.querySelector(":focus"), initial = el.querySelector(initialSelector), first = (0, import_utils.createEl)("span", { tabIndex: 0 }, { focusGuard: "start" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), last = (0, import_utils.createEl)("span", { tabIndex: 0 }, { focusGuard: "end" }, { position: "absolute", width: "0", height: "0", pointerEvents: "none" }), getFocusable = (c = el) => [...c.querySelectorAll(INTERACTIVE_SELECTOR)], resetFocus = (i = 0, els = getFocusable()) => !recovering && (recovering = true, els?.length ? els.at(i).focus(focusOptions) : (!el.hasAttribute("tabindex") && (el.tabIndex = -1), el.focus(focusOptions)), recovering = false), edgeFocus = (pre = false, rt = root) => {
     if (!scoped) return resetFocus(pre ? -1 : 0);
-    if (rt.hasAttribute("tabindex")) return rt.focus();
+    if (rt.hasAttribute("tabindex")) return rt.focus(focusOptions);
     const items = getFocusable();
     if (!items.length) return resetFocus(0, null);
     const ceil = document.fullscreenElement || document.querySelector("dialog:modal") || document.body;
     let p = rt.parentElement || ceil, all = getFocusable(p);
     while (p !== ceil && (!all.length || (pre ? rt.contains(all[0]) : rt.contains(all.at(-1))))) all = getFocusable(p = p.parentElement || ceil);
-    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus();
+    for (let target, len = all.length, i = all.indexOf(items[pre ? 0 : items.length - 1]) + (pre ? -1 : 1); pre ? i >= 0 : i < len; pre ? i-- : i++) if (!rt.contains(target = all[i])) return target.focus(focusOptions);
     (pre ? first : last).blur();
   }, handleFocusIn = (e) => {
     if (document.querySelector("dialog:modal") && !el.matches("dialog:modal")) return;
@@ -184,9 +184,9 @@ function initFocusTrap(el, { enabled = false, initialSelector = "[data-autofocus
   first.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus(true) : resetFocus(), capture), el.prepend(first);
   last.addEventListener("focus", (e) => el.contains(e.relatedTarget) ? edgeFocus() : resetFocus(-1), capture), el.append(last);
   root.addEventListener("focusin", handleFocusIn, capture);
-  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(), initial.addEventListener("blur", handleInitialBlur, capture)));
+  if (initial || !el.contains(focused)) !initial ? setTimeout(resetFocus) : setTimeout(() => (initial.classList.add(ringClassName), initial.focus(focusOptions), initial.addEventListener("blur", handleInitialBlur, capture)));
   const destroy = () => {
-    focused?.isConnected && focused.focus(), first.remove(), last.remove();
+    focused?.isConnected && focused.focus(focusOptions), first.remove(), last.remove();
     root.removeEventListener("focusin", handleFocusIn, capture);
     initial?.removeEventListener("blur", handleInitialBlur, capture);
     t007._ftrappers.delete(el), stack.splice(stack.indexOf(el), 1);

package/dist/hooks/vanilla.d.cts

@@ -1,6 +1,6 @@
-export { b as FocusTrapConfig, F as FocusTrapHandle, a as ScrollAssistConfig, S as ScrollAssistHandle, c as ScrollDir, i as initFocusTrap, d as initScrollAssist, r as removeFocusTrap, e as removeScrollAssist, s as syncFocusTrap } from '../scrollAssist-BNvPnsJq.cjs';
+export { b as FocusTrapConfig, F as FocusTrapHandle, a as ScrollAssistConfig, S as ScrollAssistHandle, c as ScrollDir, i as initFocusTrap, d as initScrollAssist, r as removeFocusTrap, e as removeScrollAssist, s as syncFocusTrap } from '../scrollAssist-CGZBNw6D.cjs';
 export { O as OutsideClickConfig, R as RippleConfig, i as initOutsideClick, r as removeOutsideClick, a as rippleHandler } from '../ripple-D1kGErTn.cjs';
-export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation, s as syncArrowNavigation } from '../arrowNavigation-zEJbo8Er.cjs';
+export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation, s as syncArrowNavigation } from '../arrowNavigation-PxYXKmCY.cjs';
 
 /** Configuration for the vertical edge-scrolling helper. */
 interface ScrolleratorOptions {

package/dist/hooks/vanilla.d.ts

@@ -1,6 +1,6 @@
-export { b as FocusTrapConfig, F as FocusTrapHandle, a as ScrollAssistConfig, S as ScrollAssistHandle, c as ScrollDir, i as initFocusTrap, d as initScrollAssist, r as removeFocusTrap, e as removeScrollAssist, s as syncFocusTrap } from '../scrollAssist-BNvPnsJq.js';
+export { b as FocusTrapConfig, F as FocusTrapHandle, a as ScrollAssistConfig, S as ScrollAssistHandle, c as ScrollDir, i as initFocusTrap, d as initScrollAssist, r as removeFocusTrap, e as removeScrollAssist, s as syncFocusTrap } from '../scrollAssist-CGZBNw6D.js';
 export { O as OutsideClickConfig, R as RippleConfig, i as initOutsideClick, r as removeOutsideClick, a as rippleHandler } from '../ripple-D1kGErTn.js';
-export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation, s as syncArrowNavigation } from '../arrowNavigation-B9bEdoqR.js';
+export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation, s as syncArrowNavigation } from '../arrowNavigation-C5asxLP0.js';
 
 /** Configuration for the vertical edge-scrolling helper. */
 interface ScrolleratorOptions {

package/dist/hooks/vanilla.js

@@ -11,12 +11,12 @@ import {
   removeOutsideClick,
   rippleHandler,
   syncFocusTrap
-} from "../chunk-DSDFIB5F.js";
+} from "../chunk-GCJ5LPEB.js";
 import {
   INTERACTIVE_SELECTOR,
   createEl,
   getActiveEl
-} from "../chunk-ZOFWWRKV.js";
+} from "../chunk-ZFW6HNGO.js";
 
 // src/ts/hooks/vanilla/scrollAssist.ts
 import { NIL } from "sia-reactor";

package/dist/index.cjs

@@ -272,16 +272,11 @@ function throttle(key, fn, delay = 30, strict = true, signal, win) {
   const id = strict === false ? (0, import_utils5.setTimeout)(() => 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);
+function debounce(key, fn, delay = 30, strict = false, signal, win) {
+  const debounceMap = t007._debouncers ??= /* @__PURE__ */ new Map(), prevId = debounceMap.get(key), callNow = strict && prevId === void 0;
   prevId !== void 0 && (win ?? window).clearTimeout(prevId);
-  const id = (0, import_utils5.setTimeout)(() => (debounceMap.delete(key), fn()), delay, signal, win);
-  return void debounceMap.set(key, id);
+  const id = (0, import_utils5.setTimeout)(() => (debounceMap.delete(key), !strict && fn()), delay, signal, win);
+  return debounceMap.set(key, id), callNow ? fn() : void 0;
 }
 function RAFLoop(key, fn, signal, win) {
   const rafLoopMap = t007._RAFLoopers ??= /* @__PURE__ */ new Map();
@@ -292,10 +287,10 @@ function RAFLoop(key, fn, signal, win) {
 }
 var cancelRAFLoop = (key) => t007._RAFLoopers ? t007._RAFLoopers.delete(key) : false;
 function limited(FN_KEY, fn, opts = {}) {
-  let count = 0, { key, maxTimes: max = 1, oncePerSession = true } = isStr(opts) ? { key: opts } : opts;
+  let count = 0, { key, maxTimes: max = 1, perSession = key != null } = 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 (oncePerSession && count > 0) return void 0;
+    if (perSession && count >= +perSession) return;
     if (!key) return count++ < max ? fn(...args) : void 0;
     const r = getReg(), c = r[key] || 0;
     return c < max ? (count++, r[key] = c + 1, setReg(r), fn(...args)) : void 0;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as ArrowNavigationHandle } from './arrowNavigation-zEJbo8Er.cjs';
-import { F as FocusTrapHandle, S as ScrollAssistHandle } from './scrollAssist-BNvPnsJq.cjs';
+import { A as ArrowNavigationHandle } from './arrowNavigation-PxYXKmCY.cjs';
+import { F as FocusTrapHandle, S as ScrollAssistHandle } from './scrollAssist-CGZBNw6D.cjs';
 export { NIL, NOOP } from 'sia-reactor';
 export { KEYS_BLOCKS, KeyStruct, KeysSettings, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getActiveEl, getTermsForKey, guardAllMethods, guardMethod, isObj, keyEventAllowed, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent } from 'sia-reactor/utils';
 
@@ -103,7 +103,7 @@ declare function camelize<T extends string>(str?: T, { source }?: RegExp, { pres
 }): CamelCase<T>;
 /** Convert a camelCase or PascalCase string to a separator-based format (e.g. "helloWorld" to "hello-world").
  * @param str The camelCase or PascalCase string to convert.
- * @param separator The string to insert between words. @default  a hyphen ("-").
+ * @param separator The string to insert between words. @default " ".
  * @returns The uncamelized version of the input string with separators.
  * @example
  * uncamelize("helloWorld") // "hello-world"
@@ -158,7 +158,7 @@ declare function throttle(key: string, fn: Function, delay?: number, strict?: ((
  * @param key Unique identifier for the debounced function, used to track pending calls.
  * @param fn Function to be debounced.
  * @param delay Time in milliseconds to wait after the latest call before invoking the function. @default  `30ms`.
- * @param strict If `true`, exact timestamp difference between calls will be used else pending timeout is reset each call for practical thread leniency. @default  `true`.
+ * @param strict If `true`, the function will execute immediately on the leading edge of the delay period instead of the trailing edge. @default  `false`.
  * @param signal Optional `AbortSignal` to automatically clear scheduled debounce execution when aborted.
  * @param win Optional `Window` object for scheduling/clearing the debounce timeout, useful for testing or if running in a non-browser environment.
  */
@@ -182,8 +182,8 @@ interface LimitedOptions {
     key?: string;
     /** Maximum number of allowed calls. @default 1 */
     maxTimes?: number;
-    /** Only allow calling once per session, regardless of maxTimes. @default true */
-    oncePerSession?: boolean;
+    /** Only allow calling x times per session, regardless of maxTimes. @default true */
+    perSession?: boolean | number;
 }
 interface LimitedHandle<T extends (...args: any[]) => any> {
     /** Call the wrapped function with the original arguments. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ArrowNavigationHandle } from './arrowNavigation-B9bEdoqR.js';
-import { F as FocusTrapHandle, S as ScrollAssistHandle } from './scrollAssist-BNvPnsJq.js';
+import { A as ArrowNavigationHandle } from './arrowNavigation-C5asxLP0.js';
+import { F as FocusTrapHandle, S as ScrollAssistHandle } from './scrollAssist-CGZBNw6D.js';
 export { NIL, NOOP } from 'sia-reactor';
 export { KEYS_BLOCKS, KeyStruct, KeysSettings, assignEl, bindAllMethods, clamp, cleanKeyCombo, createEl, formatKeyForDisplay, formatKeyShortcutsForDisplay, getActiveEl, getTermsForKey, guardAllMethods, guardMethod, isObj, keyEventAllowed, matchKeys, onAllMethods, parseForARIAKS, parseKeyCombo, requestAnimationFrame, setInterval, setTimeout, stringifyKeyEvent } from 'sia-reactor/utils';
 
@@ -103,7 +103,7 @@ declare function camelize<T extends string>(str?: T, { source }?: RegExp, { pres
 }): CamelCase<T>;
 /** Convert a camelCase or PascalCase string to a separator-based format (e.g. "helloWorld" to "hello-world").
  * @param str The camelCase or PascalCase string to convert.
- * @param separator The string to insert between words. @default  a hyphen ("-").
+ * @param separator The string to insert between words. @default " ".
  * @returns The uncamelized version of the input string with separators.
  * @example
  * uncamelize("helloWorld") // "hello-world"
@@ -158,7 +158,7 @@ declare function throttle(key: string, fn: Function, delay?: number, strict?: ((
  * @param key Unique identifier for the debounced function, used to track pending calls.
  * @param fn Function to be debounced.
  * @param delay Time in milliseconds to wait after the latest call before invoking the function. @default  `30ms`.
- * @param strict If `true`, exact timestamp difference between calls will be used else pending timeout is reset each call for practical thread leniency. @default  `true`.
+ * @param strict If `true`, the function will execute immediately on the leading edge of the delay period instead of the trailing edge. @default  `false`.
  * @param signal Optional `AbortSignal` to automatically clear scheduled debounce execution when aborted.
  * @param win Optional `Window` object for scheduling/clearing the debounce timeout, useful for testing or if running in a non-browser environment.
  */
@@ -182,8 +182,8 @@ interface LimitedOptions {
     key?: string;
     /** Maximum number of allowed calls. @default 1 */
     maxTimes?: number;
-    /** Only allow calling once per session, regardless of maxTimes. @default true */
-    oncePerSession?: boolean;
+    /** Only allow calling x times per session, regardless of maxTimes. @default true */
+    perSession?: boolean | number;
 }
 interface LimitedHandle<T extends (...args: any[]) => any> {
     /** Call the wrapped function with the original arguments. */

package/dist/index.js

@@ -60,7 +60,7 @@ import {
   throttle,
   uid,
   uncamelize
-} from "./chunk-ZOFWWRKV.js";
+} from "./chunk-ZFW6HNGO.js";
 export {
   INTERACTIVE_SELECTOR,
   KEYS_BLOCKS,

package/dist/{scrollAssist-BNvPnsJq.d.cts → scrollAssist-CGZBNw6D.d.cts}

@@ -51,13 +51,15 @@ interface FocusTrapConfig {
     scoped?: boolean;
     /** Passed down to all event listeners used. @default  `true`. */
     capture?: boolean;
+    /** Focus behavior options used in triggering focus. */
+    focusOptions?: FocusOptions;
 }
 interface FocusTrapHandle {
     destroy: () => void;
     sync: () => void;
 }
 /** Hook to keep focus trapped inside an element until disabled. */
-declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture }?: FocusTrapConfig): FocusTrapHandle | void;
+declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture, focusOptions }?: FocusTrapConfig): FocusTrapHandle | void;
 /** Remove the focus trap guard from an element. */
 declare const removeFocusTrap: (el: HTMLElement) => void | undefined;
 /** Synchronize the focus trap guards. */

package/dist/{scrollAssist-BNvPnsJq.d.ts → scrollAssist-CGZBNw6D.d.ts}

@@ -51,13 +51,15 @@ interface FocusTrapConfig {
     scoped?: boolean;
     /** Passed down to all event listeners used. @default  `true`. */
     capture?: boolean;
+    /** Focus behavior options used in triggering focus. */
+    focusOptions?: FocusOptions;
 }
 interface FocusTrapHandle {
     destroy: () => void;
     sync: () => void;
 }
 /** Hook to keep focus trapped inside an element until disabled. */
-declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture }?: FocusTrapConfig): FocusTrapHandle | void;
+declare function initFocusTrap(el: HTMLElement, { enabled, initialSelector, ringClassName, root, scoped, capture, focusOptions }?: FocusTrapConfig): FocusTrapHandle | void;
 /** Remove the focus trap guard from an element. */
 declare const removeFocusTrap: (el: HTMLElement) => void | undefined;
 /** Synchronize the focus trap guards. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t007/utils",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "description": "High-performance utilities for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",
@@ -76,7 +76,7 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "sia-reactor": "^0.0.37"
+    "sia-reactor": "^0.0.40"
   },
   "peerDependencies": {
     "react": "^18.0.0"