@t007/utils 0.0.30 → 0.0.31

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

@@ -8,16 +8,17 @@ import {
 
 // 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,7 +11,7 @@ import {
   initFocusTrap,
   initOutsideClick,
   rippleHandler
-} from "../chunk-YDARUYLO.js";
+} from "../chunk-LBDWVTYF.js";
 import {
   INTERACTIVE_SELECTOR,
   getActiveEl
@@ -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,7 +10,7 @@ import {
   removeFocusTrap,
   removeOutsideClick,
   rippleHandler
-} from "../chunk-YDARUYLO.js";
+} from "../chunk-LBDWVTYF.js";
 import {
   INTERACTIVE_SELECTOR,
   createEl,

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.31",
   "description": "High-performance utilities for the t007 ecosystem.",
   "author": "Oketade Oluwatobiloba <tobioketade007@gmail.com>",
   "license": "MIT",