@t007/utils 0.0.30 → 0.0.32

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

@@ -90,15 +90,18 @@ function parseCSSTime(time) {
 function parseCSSSize(size, el) {
   return size?.endsWith?.("px") ? parseFloat(size) : remToPx(parseFloat(size), el);
 }
-function isSameURL(src1, src2) {
-  if (!isStr(src1) || !isStr(src2) || !src1 || !src2) return false;
+function cleanURL(url) {
   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);
+    const u = new URL(url, window.location.href);
+    return decodeURIComponent(u.origin + u.pathname);
   } catch {
-    return src1.replace(/\\/g, "/").split("?")[0].trim() === src2.replace(/\\/g, "/").split("?")[0].trim();
+    return url.replace(/\\/g, "/").split("?")[0].trim();
   }
 }
+function isSameURL(url1, url2) {
+  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";
@@ -174,6 +177,7 @@ export {
   pxToRem,
   parseCSSTime,
   parseCSSSize,
+  cleanURL,
   isSameURL,
   limited,
   mockAsync,

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

@@ -4,20 +4,21 @@ import {
   createEl,
   getActiveEl,
   isInteractive
-} from "./chunk-Y5YJMRXD.js";
+} from "./chunk-4O76EZJ4.js";
 
 // src/ts/hooks/vanilla/outsideClick.ts
 import { NIL, NOOP } from "sia-reactor";
-function initOutsideClick(el, { enabled = false, onOutsideClick = NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = NIL) {
+function initOutsideClick(el, { enabled = false, onOutside = NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowBounds = false, allowInputs = false, root = window, scoped = true, capture = true } = NIL) {
   const stacks = t007._outsiders_stacks ??= /* @__PURE__ */ new WeakMap(), existing = (t007._outsiders ??= /* @__PURE__ */ new WeakMap()).get(el);
   if (!enabled || existing) return existing ? existing : void 0;
   scoped = scoped && root instanceof HTMLElement, root = scoped ? root : root === document ? document : window;
-  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = el.getBoundingClientRect()) => {
-    if (stack.at(-1) !== el || p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom) return false;
-    return (!scoped ? true : root.contains(t)) && onOutsideClick(e);
-  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutsideClick(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
+  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = allowBounds ? el.getBoundingClientRect() : null) => {
+    if (stack.at(-1) !== el || (allowBounds ? p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom : el.contains(t))) return false;
+    return (!scoped ? true : root.contains(t)) && onOutside(e);
+  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutside(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
   root.addEventListener("mousedown", handleClick, capture), root.addEventListener("touchstart", handleClick, { passive: true, capture });
-  root.addEventListener("keydown", handleEscape, capture), el.addEventListener("focusout", handleFocusOut, capture);
+  root.addEventListener("keydown", handleEscape, capture);
+  el.addEventListener("focusout", handleFocusOut, capture);
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     root.removeEventListener("mousedown", handleClick, capture), root.removeEventListener("touchstart", handleClick, capture);
@@ -52,7 +53,7 @@ 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 (!el.querySelector(":focus")) !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(), initial.addEventListener("blur", handleInitialBlur, capture)));
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     focused?.isConnected && focused.focus(), first.remove(), last.remove();

package/dist/hooks/react.cjs

@@ -125,16 +125,17 @@ var import_react2 = require("react");
 
 // src/ts/hooks/vanilla/outsideClick.ts
 var import_sia_reactor2 = require("sia-reactor");
-function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_reactor2.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor2.NIL) {
+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) {
   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;
-  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = el.getBoundingClientRect()) => {
-    if (stack.at(-1) !== el || p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom) return false;
-    return (!scoped ? true : root.contains(t)) && onOutsideClick(e);
-  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutsideClick(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
+  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = allowBounds ? el.getBoundingClientRect() : null) => {
+    if (stack.at(-1) !== el || (allowBounds ? p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom : el.contains(t))) return false;
+    return (!scoped ? true : root.contains(t)) && onOutside(e);
+  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutside(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
   root.addEventListener("mousedown", handleClick, capture), root.addEventListener("touchstart", handleClick, { passive: true, capture });
-  root.addEventListener("keydown", handleEscape, capture), el.addEventListener("focusout", handleFocusOut, capture);
+  root.addEventListener("keydown", handleEscape, capture);
+  el.addEventListener("focusout", handleFocusOut, capture);
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     root.removeEventListener("mousedown", handleClick, capture), root.removeEventListener("touchstart", handleClick, capture);
@@ -148,7 +149,7 @@ function initOutsideClick(el, { enabled = false, onOutsideClick = import_sia_rea
 // src/ts/hooks/react/useOutsideClick.ts
 var import_sia_reactor3 = require("sia-reactor");
 function useOutsideClick(ref, config = import_sia_reactor3.NIL) {
-  (0, import_react2.useEffect)(() => ref.current ? initOutsideClick(ref.current, config) : void 0, [ref, config.enabled, config.onOutsideClick, config.outOnEscape, config.outOnClick, config.outOnFocusOut, config.allowInputs, config.root, config.scoped, config.capture]);
+  (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]);
 }
 
 // src/ts/hooks/react/useArrowNavigation/index.ts
@@ -399,7 +400,7 @@ 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 (!el.querySelector(":focus")) !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(), initial.addEventListener("blur", handleInitialBlur, capture)));
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     focused?.isConnected && focused.focus(), first.remove(), last.remove();

package/dist/hooks/react.d.cts

@@ -1,6 +1,6 @@
 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-CVQx46Xq.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';
 
 /** Configuration options for the `useScrollAssist` hook. */

package/dist/hooks/react.d.ts

@@ -1,6 +1,6 @@
 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-CVQx46Xq.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';
 
 /** Configuration options for the `useScrollAssist` hook. */

package/dist/hooks/react.js

@@ -11,11 +11,11 @@ import {
   initFocusTrap,
   initOutsideClick,
   rippleHandler
-} from "../chunk-YDARUYLO.js";
+} from "../chunk-QJ72EQCJ.js";
 import {
   INTERACTIVE_SELECTOR,
   getActiveEl
-} from "../chunk-Y5YJMRXD.js";
+} from "../chunk-4O76EZJ4.js";
 
 // src/ts/hooks/react/useScrollAssist.ts
 import { useEffect, useRef, useCallback } from "react";
@@ -101,7 +101,7 @@ function useScrollAssist(ref, { enabled = true, pxPerSecond = 80, assistClassNam
 import { useEffect as useEffect2 } from "react";
 import { NIL as NIL2 } from "sia-reactor";
 function useOutsideClick(ref, config = NIL2) {
-  useEffect2(() => ref.current ? initOutsideClick(ref.current, config) : void 0, [ref, config.enabled, config.onOutsideClick, config.outOnEscape, config.outOnClick, config.outOnFocusOut, config.allowInputs, config.root, config.scoped, config.capture]);
+  useEffect2(() => 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]);
 }
 
 // src/ts/hooks/react/useArrowNavigation/index.ts

package/dist/hooks/vanilla.cjs

@@ -136,16 +136,17 @@ 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, onOutsideClick = import_sia_reactor3.NOOP, outOnClick = true, outOnEscape = true, outOnFocusOut = false, allowInputs = false, root = window, scoped = true, capture = true } = import_sia_reactor3.NIL) {
+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;
-  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = el.getBoundingClientRect()) => {
-    if (stack.at(-1) !== el || p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom) return false;
-    return (!scoped ? true : root.contains(t)) && onOutsideClick(e);
-  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutsideClick(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
+  const stack = stacks.get(root) ?? [], onScopedOut = (e, t, p = e.touches?.[0] || e, rect = allowBounds ? el.getBoundingClientRect() : null) => {
+    if (stack.at(-1) !== el || (allowBounds ? p.clientX >= rect.left && p.clientX <= rect.right && p.clientY >= rect.top && p.clientY <= rect.bottom : el.contains(t))) return false;
+    return (!scoped ? true : root.contains(t)) && onOutside(e);
+  }, handleClick = ((e) => outOnClick && !(allowInputs && isInteractive(e.target)) && onScopedOut(e, e.target)), handleEscape = ((e) => outOnEscape && e.key === "Escape" && !e.ctrlKey && !e.shiftKey && !e.altKey && !e.metaKey && stack.at(-1) === el && onOutside(e)), handleFocusOut = (e) => outOnFocusOut && !el.contains(e.relatedTarget) && onScopedOut(e, e.relatedTarget);
   root.addEventListener("mousedown", handleClick, capture), root.addEventListener("touchstart", handleClick, { passive: true, capture });
-  root.addEventListener("keydown", handleEscape, capture), el.addEventListener("focusout", handleFocusOut, capture);
+  root.addEventListener("keydown", handleEscape, capture);
+  el.addEventListener("focusout", handleFocusOut, capture);
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     root.removeEventListener("mousedown", handleClick, capture), root.removeEventListener("touchstart", handleClick, capture);
@@ -180,7 +181,7 @@ 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 (!el.querySelector(":focus")) !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(), initial.addEventListener("blur", handleInitialBlur, capture)));
   if (!stack.includes(el)) stack.push(el), stacks.set(root, stack);
   const destroy = () => {
     focused?.isConnected && focused.focus(), first.remove(), last.remove();

package/dist/hooks/vanilla.d.cts

@@ -1,5 +1,5 @@
 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-CVQx46Xq.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';
 
 /** Configuration for the vertical edge-scrolling helper. */

package/dist/hooks/vanilla.d.ts

@@ -1,5 +1,5 @@
 export { a as ScrollAssistConfig, S as ScrollAssistHandle, b as ScrollDir, i as initScrollAssist, r as removeScrollAssist } from '../scrollAssist-y9wFmYgt.js';
-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-CVQx46Xq.js';
+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.js';
 export { A as ArrowNavigationHandle, i as initArrowNavigation, r as removeArrowNavigation } from '../arrowNavigation-VenvPI4H.js';
 
 /** Configuration for the vertical edge-scrolling helper. */

package/dist/hooks/vanilla.js

@@ -10,12 +10,12 @@ import {
   removeFocusTrap,
   removeOutsideClick,
   rippleHandler
-} from "../chunk-YDARUYLO.js";
+} from "../chunk-QJ72EQCJ.js";
 import {
   INTERACTIVE_SELECTOR,
   createEl,
   getActiveEl
-} from "../chunk-Y5YJMRXD.js";
+} from "../chunk-4O76EZJ4.js";
 
 // src/ts/hooks/vanilla/scrollAssist.ts
 import { NIL } from "sia-reactor";

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   breath: () => breath,
   clamp: () => import_utils4.clamp,
   cleanKeyCombo: () => import_utils6.cleanKeyCombo,
+  cleanURL: () => cleanURL,
   createEl: () => import_utils.createEl,
   deepBreath: () => deepBreath,
   formatKeyForDisplay: () => import_utils6.formatKeyForDisplay,
@@ -165,15 +166,18 @@ function parseCSSTime(time) {
 function parseCSSSize(size, el) {
   return size?.endsWith?.("px") ? parseFloat(size) : remToPx(parseFloat(size), el);
 }
-function isSameURL(src1, src2) {
-  if (!isStr(src1) || !isStr(src2) || !src1 || !src2) return false;
+function cleanURL(url) {
   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);
+    const u = new URL(url, window.location.href);
+    return decodeURIComponent(u.origin + u.pathname);
   } catch {
-    return src1.replace(/\\/g, "/").split("?")[0].trim() === src2.replace(/\\/g, "/").split("?")[0].trim();
+    return url.replace(/\\/g, "/").split("?")[0].trim();
   }
 }
+function isSameURL(url1, url2) {
+  if (!isStr(url1) || !isStr(url2) || !url1 || !url2) return false;
+  return cleanURL(url1) === cleanURL(url2);
+}
 
 // src/ts/core/fn.ts
 var import_utils5 = require("sia-reactor/utils");
@@ -234,6 +238,7 @@ if ("undefined" !== typeof window) {
   breath,
   clamp,
   cleanKeyCombo,
+  cleanURL,
   createEl,
   deepBreath,
   formatKeyForDisplay,

package/dist/index.d.cts

@@ -20,18 +20,18 @@ declare global {
   interface Window {
     /** Shared T007 namespace. */
     t007: T007Namespace;
-    /** CDN entrypoint for @t007/toast. */
-    T007_TOAST_JS_SRC?: string;
-    /** CDN entrypoint for @t007/input. */
-    T007_INPUT_JS_SRC?: string;
-    /** CDN entrypoint for @t007/dialog. */
-    T007_DIALOG_JS_SRC?: string;
-    /** CDN stylesheet for @t007/toast. */
-    T007_TOAST_CSS_SRC?: string;
-    /** CDN stylesheet for @t007/input. */
-    T007_INPUT_CSS_SRC?: string;
-    /** CDN stylesheet for @t007/dialog. */
-    T007_DIALOG_CSS_SRC?: string;
+    /** CDN js entrypoint for `@t007/toast`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_TOAST_JS_SRC?: string | symbol;
+    /** CDN js entrypoint for `@t007/input`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_INPUT_JS_SRC?: string | symbol;
+    /** CDN js entrypoint for `@t007/dialog`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_DIALOG_JS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/toast`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_TOAST_CSS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/input`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_INPUT_CSS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/dialog`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_DIALOG_CSS_SRC?: string | symbol;
   }
   /** Shared T007 namespace on the global object. */
   var t007: T007Namespace;
@@ -77,12 +77,17 @@ declare function parseCSSTime(time: any): number;
  * @returns The equivalent value in pixels.
  */
 declare function parseCSSSize(size: any, el?: HTMLElement): number;
+/** Normalize a URL by decoding it and removing query parameters and hash fragments.
+ * @param url The URL string to clean.
+ * @returns A normalized URL string for comparison.
+ */
+declare function cleanURL(url: string): string;
 /** Compare two URLs after normalizing origin, pathname, and separators.
- * @param src1 First URL or path.
- * @param src2 Second URL or path.
+ * @param url1 First URL or path.
+ * @param url2 Second URL or path.
  * @returns True when both references point to the same resource.
  */
-declare function isSameURL(src1: unknown, src2: unknown): boolean;
+declare function isSameURL(url1: unknown, url2: unknown): boolean;
 
 interface LimitedOptions {
     /** Storage key used to persist call counts. */
@@ -134,7 +139,7 @@ declare function bindCleanupToSignal<Cb extends () => any>(cleanup: Cb, signal?:
 /** Exhaustive Selector used for interactive, tabbable UI controls. */
 declare const 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] *)";
 /** Check whether an event target points to an interactive element. */
-declare const isInteractive: (target: EventTarget | null) => target is HTMLElement;
+declare const isInteractive: (target: EventTarget | null) => boolean;
 /** Resource type accepted by loadResource. */
 type ResourceType = "style" | "script" | string;
 /** Options used when loading a script or stylesheet resource. */
@@ -183,4 +188,4 @@ declare function getWindow(el?: any): (Window & typeof globalThis) | undefined;
  */
 declare function formatSize(bytes: number, decimals?: number, base?: number): string;
 
-export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };
+export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, cleanURL, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };

package/dist/index.d.ts

@@ -20,18 +20,18 @@ declare global {
   interface Window {
     /** Shared T007 namespace. */
     t007: T007Namespace;
-    /** CDN entrypoint for @t007/toast. */
-    T007_TOAST_JS_SRC?: string;
-    /** CDN entrypoint for @t007/input. */
-    T007_INPUT_JS_SRC?: string;
-    /** CDN entrypoint for @t007/dialog. */
-    T007_DIALOG_JS_SRC?: string;
-    /** CDN stylesheet for @t007/toast. */
-    T007_TOAST_CSS_SRC?: string;
-    /** CDN stylesheet for @t007/input. */
-    T007_INPUT_CSS_SRC?: string;
-    /** CDN stylesheet for @t007/dialog. */
-    T007_DIALOG_CSS_SRC?: string;
+    /** CDN js entrypoint for `@t007/toast`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_TOAST_JS_SRC?: string | symbol;
+    /** CDN js entrypoint for `@t007/input`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_INPUT_JS_SRC?: string | symbol;
+    /** CDN js entrypoint for `@t007/dialog`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_DIALOG_JS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/toast`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_TOAST_CSS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/input`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_INPUT_CSS_SRC?: string | symbol;
+    /** CDN stylesheet for `@t007/dialog`, assign a symbol if bundling, e.g. `VIRTUAL_RESOURCE` from `@t007/utils`. */
+    T007_DIALOG_CSS_SRC?: string | symbol;
   }
   /** Shared T007 namespace on the global object. */
   var t007: T007Namespace;
@@ -77,12 +77,17 @@ declare function parseCSSTime(time: any): number;
  * @returns The equivalent value in pixels.
  */
 declare function parseCSSSize(size: any, el?: HTMLElement): number;
+/** Normalize a URL by decoding it and removing query parameters and hash fragments.
+ * @param url The URL string to clean.
+ * @returns A normalized URL string for comparison.
+ */
+declare function cleanURL(url: string): string;
 /** Compare two URLs after normalizing origin, pathname, and separators.
- * @param src1 First URL or path.
- * @param src2 Second URL or path.
+ * @param url1 First URL or path.
+ * @param url2 Second URL or path.
  * @returns True when both references point to the same resource.
  */
-declare function isSameURL(src1: unknown, src2: unknown): boolean;
+declare function isSameURL(url1: unknown, url2: unknown): boolean;
 
 interface LimitedOptions {
     /** Storage key used to persist call counts. */
@@ -134,7 +139,7 @@ declare function bindCleanupToSignal<Cb extends () => any>(cleanup: Cb, signal?:
 /** Exhaustive Selector used for interactive, tabbable UI controls. */
 declare const 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] *)";
 /** Check whether an event target points to an interactive element. */
-declare const isInteractive: (target: EventTarget | null) => target is HTMLElement;
+declare const isInteractive: (target: EventTarget | null) => boolean;
 /** Resource type accepted by loadResource. */
 type ResourceType = "style" | "script" | string;
 /** Options used when loading a script or stylesheet resource. */
@@ -183,4 +188,4 @@ declare function getWindow(el?: any): (Window & typeof globalThis) | undefined;
  */
 declare function formatSize(bytes: number, decimals?: number, base?: number): string;
 
-export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };
+export { INTERACTIVE_SELECTOR, type LimitedHandle, type LimitedOptions, type LoadResourceOptions, type ResourceType, VIRTUAL_RESOURCE, bindCleanupToSignal, breath, cleanURL, deepBreath, formatSize, getWindow, inBoolArrOpt, isArr, isBool, isDef, isFunc, isInteractive, isIter, isNum, isPOJO, isSameURL, isStr, isSym, limited, loadResource, mockAsync, parseCSSSize, parseCSSTime, pxToRem, remToPx, uid };

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   breath,
   clamp,
   cleanKeyCombo,
+  cleanURL,
   createEl,
   deepBreath,
   formatKeyForDisplay,
@@ -49,7 +50,7 @@ import {
   setTimeout,
   stringifyKeyEvent,
   uid
-} from "./chunk-Y5YJMRXD.js";
+} from "./chunk-4O76EZJ4.js";
 export {
   INTERACTIVE_SELECTOR,
   NIL,
@@ -61,6 +62,7 @@ export {
   breath,
   clamp,
   cleanKeyCombo,
+  cleanURL,
   createEl,
   deepBreath,
   formatKeyForDisplay,

package/dist/{ripple-CVQx46Xq.d.cts → ripple-C5MfEErC.d.cts}

@@ -2,13 +2,15 @@ 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;
+    onOutside?: (e: MouseEvent | TouchEvent | KeyboardEvent | FocusEvent) => void;
     /** Whether pointer/touch outside interactions should trigger callback. Defaults to `true`. */
     outOnClick?: boolean;
     /** Whether Escape key should trigger callback. Defaults to `true`. */
     outOnEscape?: boolean;
     /** Whether focus leaving the container should trigger callback. Defaults to `false`. */
     outOnFocusOut?: boolean;
+    /** Allow only clicks inside `el` bounding client rectangle to be considered valid, otherwise uses `el.contains(target)`. Defaults to `false . */
+    allowBounds?: boolean;
     /** Allow interactive elements including outsiders to bypass click callback. Defaults to `false`. */
     allowInputs?: boolean;
     /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
@@ -19,16 +21,16 @@ interface OutsideClickConfig {
     capture?: boolean;
 }
 /** Hook to attach outside-click, escape, and optional focus-out handling to an element. */
-declare function initOutsideClick(el: HTMLElement, { enabled, onOutsideClick, outOnClick, outOnEscape, outOnFocusOut, allowInputs, root, scoped, capture }?: OutsideClickConfig): (() => void) | void;
+declare function initOutsideClick(el: HTMLElement, { enabled, onOutside, outOnClick, outOnEscape, outOnFocusOut, allowBounds, 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]`. */
+    /** The preferred initial focus target selector within the element, overrides whatever was focused. Try `autofocus` attribute if working with dialogs before this. 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"`. */
+    /** The class name for the initial focus ring since programmatic focus is not always visible, `autofocus` attribute in dialogs might work fine as an alternative. 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;

package/dist/{ripple-CVQx46Xq.d.ts → ripple-C5MfEErC.d.ts}

@@ -2,13 +2,15 @@ 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;
+    onOutside?: (e: MouseEvent | TouchEvent | KeyboardEvent | FocusEvent) => void;
     /** Whether pointer/touch outside interactions should trigger callback. Defaults to `true`. */
     outOnClick?: boolean;
     /** Whether Escape key should trigger callback. Defaults to `true`. */
     outOnEscape?: boolean;
     /** Whether focus leaving the container should trigger callback. Defaults to `false`. */
     outOnFocusOut?: boolean;
+    /** Allow only clicks inside `el` bounding client rectangle to be considered valid, otherwise uses `el.contains(target)`. Defaults to `false . */
+    allowBounds?: boolean;
     /** Allow interactive elements including outsiders to bypass click callback. Defaults to `false`. */
     allowInputs?: boolean;
     /** Optional root used to scope focus listeners to an element instead of the window. Defaults to `window`. */
@@ -19,16 +21,16 @@ interface OutsideClickConfig {
     capture?: boolean;
 }
 /** Hook to attach outside-click, escape, and optional focus-out handling to an element. */
-declare function initOutsideClick(el: HTMLElement, { enabled, onOutsideClick, outOnClick, outOnEscape, outOnFocusOut, allowInputs, root, scoped, capture }?: OutsideClickConfig): (() => void) | void;
+declare function initOutsideClick(el: HTMLElement, { enabled, onOutside, outOnClick, outOnEscape, outOnFocusOut, allowBounds, 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]`. */
+    /** The preferred initial focus target selector within the element, overrides whatever was focused. Try `autofocus` attribute if working with dialogs before this. 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"`. */
+    /** The class name for the initial focus ring since programmatic focus is not always visible, `autofocus` attribute in dialogs might work fine as an alternative. 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t007/utils",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "description": "High-performance utilities for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",