@cube-dev/ui-kit 0.189.0 → 0.190.1

package/dist/utils/dotize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/dotize.ts
 /**
 * Flattens a nested object into dot paths: `{ a: { b: 1 } }` becomes

package/dist/utils/is-dev-env.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 /**
 * `NODE_ENV` as the environment that is actually running reports it, or

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/modules.ts
 function extractModule(promise) {
 	return promise.then((module) => module.default || module);

package/dist/utils/promise.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/promise.ts
 function timeout(ms = 30) {
 	return new Promise((resolve) => {

package/dist/utils/raf.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/raf.ts
 /**
 * Chains N requestAnimationFrame calls and returns a cancel function.

package/dist/utils/random.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/random.ts
 function random(min, max) {
 	const realMin = min < max ? min : max;

package/dist/utils/range.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/range.ts
 function range(count) {
 	return Array.from({ length: count }, (_, i) => i);

package/dist/utils/react/RenderCache.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useRef } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/utils/react/Slots.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { c } from "react-compiler-runtime";
 import { Children, cloneElement, createContext, useContext } from "react";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/chain.ts
 /**
 * Calls all functions in the order they were chained with the same arguments.

package/dist/utils/react/disabledProps.d.ts

@@ -8,7 +8,8 @@ interface DisabledElementOptions {
   /**
    * Whether the element has to keep receiving pointer and focus events while
    * disabled. Set it when the element hosts a tooltip: the tooltip is there to
-   * explain why the element is unavailable, so hover has to reach it.
+   * explain why the element is unavailable, so hover has to reach it. Or when
+   * it has to keep focus, as a loading action does while a keyboard press runs.
    */
   keepEvents?: boolean;
   /** The tag the component renders. */
@@ -19,7 +20,8 @@ interface DisabledElementProps {
   isNativelyDisabled: boolean;
   /**
    * Whether the element is disabled through `aria-disabled` only and therefore
-   * has to be kept inert by hand.
+   * has to be kept inert by hand: spread `inertProps` and drop the activation
+   * handlers with `omitActivationEventProps`.
    */
   isInert: boolean;
   /** Props that mark the element disabled and inert. Spread them last. */

package/dist/utils/react/disabledProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/disabledProps.ts
 /**
 * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch
@@ -36,9 +36,14 @@ const ACTIVATION_EVENT_PROPS = [
 function preventActivation(event) {
 	event.preventDefault();
 }
+function preventKeyActivation(event) {
+	if (event.target === event.currentTarget && (event.key === "Enter" || event.key === " ")) event.preventDefault();
+}
 const INERT_PROPS = {
 	"aria-disabled": true,
-	onClick: preventActivation
+	onClick: preventActivation,
+	onKeyDown: preventKeyActivation,
+	onKeyUp: preventKeyActivation
 };
 const EMPTY_PROPS = {};
 /**

package/dist/utils/react/disabledProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"disabledProps.js","names":["SyntheticEvent","Props","FORM_CONTROL_TAGS","Set","ACTIVATION_EVENT_PROPS","const","preventActivation","event","preventDefault","INERT_PROPS","onClick","EMPTY_PROPS","DisabledElementOptions","isDisabled","keepEvents","as","DisabledElementProps","isNativelyDisabled","isInert","inertProps","getDisabledElementProps","has","omitActivationEventProps","props","T","result","prop"],"sources":["../../../src/utils/react/disabledProps.ts"],"sourcesContent":["import type { SyntheticEvent } from 'react';\nimport type { Props } from '../../props';\n\n/**\n * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch\n * mouse events on those elements while the attribute is set, so nothing that\n * listens for hover — a tooltip trigger above all — ever hears from them.\n * On every other tag the attribute is invalid markup that does nothing.\n */\nconst FORM_CONTROL_TAGS = new Set([\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'fieldset',\n  'option',\n  'optgroup',\n]);\n\n/**\n * Handlers that can activate an element. They are dropped while the element is\n * disabled through `aria-disabled` alone, so it stays as inert as a natively\n * disabled one.\n */\nconst ACTIVATION_EVENT_PROPS = [\n  'onClick',\n  'onDoubleClick',\n  'onMouseDown',\n  'onMouseUp',\n  'onPointerDown',\n  'onPointerUp',\n  'onTouchStart',\n  'onTouchEnd',\n  'onKeyDown',\n  'onKeyUp',\n  'onKeyPress',\n] as const;\n\nfunction preventActivation(event: SyntheticEvent) {\n  // Without the native attribute a click (or Enter/Space, which the browser\n  // turns into a click) still runs the default action and would submit the\n  // surrounding form.\n  event.preventDefault();\n}\n\nconst INERT_PROPS: Props = {\n  'aria-disabled': true,\n  onClick: preventActivation,\n};\n\nconst EMPTY_PROPS: Props = {};\n\nexport interface DisabledElementOptions {\n  /** Whether the component is disabled. */\n  isDisabled?: boolean;\n  /**\n   * Whether the element has to keep receiving pointer and focus events while\n   * disabled. Set it when the element hosts a tooltip: the tooltip is there to\n   * explain why the element is unavailable, so hover has to reach it.\n   */\n  keepEvents?: boolean;\n  /** The tag the component renders. */\n  as?: string;\n}\n\nexport interface DisabledElementProps {\n  /** Whether the element has to carry the native `disabled` attribute. */\n  isNativelyDisabled: boolean;\n  /**\n   * Whether the element is disabled through `aria-disabled` only and therefore\n   * has to be kept inert by hand.\n   */\n  isInert: boolean;\n  /** Props that mark the element disabled and inert. Spread them last. */\n  inertProps: Props;\n}\n\n/**\n * Decides how the disabled state reaches the DOM.\n *\n * The native `disabled` attribute is the strongest option, but it also makes\n * the browser swallow the events the element needs to open a tooltip. When\n * such an element has to stay hoverable, it is marked `aria-disabled` instead\n * and kept inert by blocking activation — the outcome a user sees is the same,\n * except the tooltip now opens and screen readers still announce the state.\n */\nexport function getDisabledElementProps({\n  isDisabled,\n  keepEvents,\n  as = 'div',\n}: DisabledElementOptions): DisabledElementProps {\n  if (!isDisabled) {\n    return {\n      isNativelyDisabled: false,\n      isInert: false,\n      inertProps: EMPTY_PROPS,\n    };\n  }\n\n  // The attribute only means something on form controls, and there it can be\n  // kept whenever nothing depends on the element's events.\n  if (FORM_CONTROL_TAGS.has(as) && !keepEvents) {\n    return {\n      isNativelyDisabled: true,\n      isInert: false,\n      inertProps: EMPTY_PROPS,\n    };\n  }\n\n  return { isNativelyDisabled: false, isInert: true, inertProps: INERT_PROPS };\n}\n\n/**\n * Removes the handlers that would activate an element which is disabled\n * without the native attribute.\n */\nexport function omitActivationEventProps<T extends Props>(props: T): T {\n  const result = { ...props };\n\n  for (const prop of ACTIVATION_EVENT_PROPS) {\n    delete result[prop];\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;AASA,MAAME,oBAAoB,IAAIC,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,MAAMC,yBAAyB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAASE,kBAAkBC,OAAuB;AAIhDA,OAAMC,gBAAgB;;AAGxB,MAAMC,cAAqB;CACzB,iBAAiB;CACjBC,SAASJ;CACV;AAED,MAAMK,cAAqB,EAAE;;;;;;;;;;AAoC7B,SAAgBS,wBAAwB,EACtCP,YACAC,YACAC,KAAK,SAC0C;AAC/C,KAAI,CAACF,WACH,QAAO;EACLI,oBAAoB;EACpBC,SAAS;EACTC,YAAYR;EACb;AAKH,KAAIT,kBAAkBmB,IAAIN,GAAG,IAAI,CAACD,WAChC,QAAO;EACLG,oBAAoB;EACpBC,SAAS;EACTC,YAAYR;EACb;AAGH,QAAO;EAAEM,oBAAoB;EAAOC,SAAS;EAAMC,YAAYV;EAAa;;;;;;AAO9E,SAAgBa,yBAA0CC,OAAa;CACrE,MAAME,SAAS,EAAE,GAAGF,OAAO;AAE3B,MAAK,MAAMG,QAAQtB,uBACjB,QAAOqB,OAAOC;AAGhB,QAAOD"}
+{"version":3,"file":"disabledProps.js","names":["KeyboardEvent","SyntheticEvent","Props","FORM_CONTROL_TAGS","Set","ACTIVATION_EVENT_PROPS","const","preventActivation","event","preventDefault","preventKeyActivation","target","currentTarget","key","INERT_PROPS","onClick","onKeyDown","onKeyUp","EMPTY_PROPS","DisabledElementOptions","isDisabled","keepEvents","as","DisabledElementProps","isNativelyDisabled","isInert","inertProps","getDisabledElementProps","has","omitActivationEventProps","props","T","result","prop"],"sources":["../../../src/utils/react/disabledProps.ts"],"sourcesContent":["import type { KeyboardEvent, SyntheticEvent } from 'react';\nimport type { Props } from '../../props';\n\n/**\n * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch\n * mouse events on those elements while the attribute is set, so nothing that\n * listens for hover — a tooltip trigger above all — ever hears from them.\n * On every other tag the attribute is invalid markup that does nothing.\n */\nconst FORM_CONTROL_TAGS = new Set([\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'fieldset',\n  'option',\n  'optgroup',\n]);\n\n/**\n * Handlers that can activate an element. They are dropped while the element is\n * disabled through `aria-disabled` alone, so it stays as inert as a natively\n * disabled one.\n */\nconst ACTIVATION_EVENT_PROPS = [\n  'onClick',\n  'onDoubleClick',\n  'onMouseDown',\n  'onMouseUp',\n  'onPointerDown',\n  'onPointerUp',\n  'onTouchStart',\n  'onTouchEnd',\n  'onKeyDown',\n  'onKeyUp',\n  'onKeyPress',\n] as const;\n\nfunction preventActivation(event: SyntheticEvent) {\n  // Without the native attribute a click still runs the default action and\n  // would submit the surrounding form or follow the link.\n  event.preventDefault();\n}\n\nfunction preventKeyActivation(event: KeyboardEvent) {\n  // Enter and Space on the focused element make the browser click it, and that\n  // click would reach the ancestors' handlers. Keys from a focused descendant\n  // are left alone.\n  if (\n    event.target === event.currentTarget &&\n    (event.key === 'Enter' || event.key === ' ')\n  ) {\n    event.preventDefault();\n  }\n}\n\nconst INERT_PROPS: Props = {\n  'aria-disabled': true,\n  onClick: preventActivation,\n  onKeyDown: preventKeyActivation,\n  onKeyUp: preventKeyActivation,\n};\n\nconst EMPTY_PROPS: Props = {};\n\nexport interface DisabledElementOptions {\n  /** Whether the component is disabled. */\n  isDisabled?: boolean;\n  /**\n   * Whether the element has to keep receiving pointer and focus events while\n   * disabled. Set it when the element hosts a tooltip: the tooltip is there to\n   * explain why the element is unavailable, so hover has to reach it. Or when\n   * it has to keep focus, as a loading action does while a keyboard press runs.\n   */\n  keepEvents?: boolean;\n  /** The tag the component renders. */\n  as?: string;\n}\n\nexport interface DisabledElementProps {\n  /** Whether the element has to carry the native `disabled` attribute. */\n  isNativelyDisabled: boolean;\n  /**\n   * Whether the element is disabled through `aria-disabled` only and therefore\n   * has to be kept inert by hand: spread `inertProps` and drop the activation\n   * handlers with `omitActivationEventProps`.\n   */\n  isInert: boolean;\n  /** Props that mark the element disabled and inert. Spread them last. */\n  inertProps: Props;\n}\n\n/**\n * Decides how the disabled state reaches the DOM.\n *\n * The native `disabled` attribute is the strongest option, but it also makes\n * the browser swallow the events the element needs to open a tooltip. When\n * such an element has to stay hoverable, it is marked `aria-disabled` instead\n * and kept inert by blocking activation — the outcome a user sees is the same,\n * except the tooltip now opens and screen readers still announce the state.\n */\nexport function getDisabledElementProps({\n  isDisabled,\n  keepEvents,\n  as = 'div',\n}: DisabledElementOptions): DisabledElementProps {\n  if (!isDisabled) {\n    return {\n      isNativelyDisabled: false,\n      isInert: false,\n      inertProps: EMPTY_PROPS,\n    };\n  }\n\n  // The attribute only means something on form controls, and there it can be\n  // kept whenever nothing depends on the element's events.\n  if (FORM_CONTROL_TAGS.has(as) && !keepEvents) {\n    return {\n      isNativelyDisabled: true,\n      isInert: false,\n      inertProps: EMPTY_PROPS,\n    };\n  }\n\n  return { isNativelyDisabled: false, isInert: true, inertProps: INERT_PROPS };\n}\n\n/**\n * Removes the handlers that would activate an element which is disabled\n * without the native attribute.\n */\nexport function omitActivationEventProps<T extends Props>(props: T): T {\n  const result = { ...props };\n\n  for (const prop of ACTIVATION_EVENT_PROPS) {\n    delete result[prop];\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;AASA,MAAMG,oBAAoB,IAAIC,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;AAOF,MAAMC,yBAAyB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAASE,kBAAkBC,OAAuB;AAGhDA,OAAMC,gBAAgB;;AAGxB,SAASC,qBAAqBF,OAAsB;AAIlD,KACEA,MAAMG,WAAWH,MAAMI,kBACtBJ,MAAMK,QAAQ,WAAWL,MAAMK,QAAQ,KAExCL,OAAMC,gBAAgB;;AAI1B,MAAMK,cAAqB;CACzB,iBAAiB;CACjBC,SAASR;CACTS,WAAWN;CACXO,SAASP;CACV;AAED,MAAMQ,cAAqB,EAAE;;;;;;;;;;AAsC7B,SAAgBS,wBAAwB,EACtCP,YACAC,YACAC,KAAK,SAC0C;AAC/C,KAAI,CAACF,WACH,QAAO;EACLI,oBAAoB;EACpBC,SAAS;EACTC,YAAYR;EACb;AAKH,KAAIf,kBAAkByB,IAAIN,GAAG,IAAI,CAACD,WAChC,QAAO;EACLG,oBAAoB;EACpBC,SAAS;EACTC,YAAYR;EACb;AAGH,QAAO;EAAEM,oBAAoB;EAAOC,SAAS;EAAMC,YAAYZ;EAAa;;;;;;AAO9E,SAAgBe,yBAA0CC,OAAa;CACrE,MAAME,SAAS,EAAE,GAAGF,OAAO;AAE3B,MAAK,MAAMG,QAAQ5B,uBACjB,QAAO2B,OAAOC;AAGhB,QAAOD"}

package/dist/utils/react/escapePropagation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/escapePropagation.ts
 /**
 * Let `Escape` keep travelling out of a trigger or list, and hold every other

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { getDisabledElementProps, omitActivationEventProps } from "./disabledProps.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";

package/dist/utils/react/interactions.js

@@ -1,55 +1,80 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
+import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react-compiler-runtime";
 import { useRef, useState } from "react";
 import { useFocus } from "react-aria";
 import { isFocusVisible, useFocusVisibleListener } from "@react-aria/interactions";
+import { getActiveElement, getOwnerDocument } from "@react-aria/utils";
 
 //#region src/utils/react/interactions.ts
-function useFocus$1(t0, t1) {
+/**
+* Whether the element holds focus, disabled or not: a control that keeps
+* focus while `aria-disabled` still shows where focus is.
+*/
+function useFocus$1(t0) {
 	const $ = c(10);
-	const { isDisabled } = t0;
-	const onlyVisible = t1 === void 0 ? false : t1;
+	const onlyVisible = t0 === void 0 ? false : t0;
 	const [isFocused, setIsFocused] = useState(false);
 	const [isFocusVisible$1, setIsFocusVisible] = useState(false);
-	if (isDisabled && isFocused) setIsFocused(false);
-	let t2;
+	const focusedElementRef = useRef(null);
+	let t1;
 	if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+		t1 = () => {
+			const element = focusedElementRef.current;
+			if (element && element !== getActiveElement(getOwnerDocument(element))) {
+				focusedElementRef.current = null;
+				setIsFocused(false);
+			}
+		};
+		$[0] = t1;
+	} else t1 = $[0];
+	const dropLostFocus = t1;
+	let t2;
+	if ($[1] === Symbol.for("react.memo_cache_sentinel")) {
 		t2 = isFocusVisible();
-		$[0] = t2;
-	} else t2 = $[0];
+		$[1] = t2;
+	} else t2 = $[1];
 	const focusVisibleRef = useRef(t2);
 	const isListening = onlyVisible && isFocused;
 	let t3;
 	let t4;
-	if ($[1] !== isListening) {
+	if ($[2] !== isListening) {
 		t3 = (visible) => {
 			focusVisibleRef.current = visible;
+			dropLostFocus();
 			if (isListening) setIsFocusVisible(visible);
 		};
 		t4 = [isListening];
-		$[1] = isListening;
-		$[2] = t3;
-		$[3] = t4;
+		$[2] = isListening;
+		$[3] = t3;
+		$[4] = t4;
 	} else {
-		t3 = $[2];
-		t4 = $[3];
+		t3 = $[3];
+		t4 = $[4];
 	}
 	useFocusVisibleListener(t3, t4);
 	let t5;
-	if ($[4] === Symbol.for("react.memo_cache_sentinel")) {
-		t5 = (focused) => {
-			setIsFocused(focused);
-			if (focused) setIsFocusVisible(focusVisibleRef.current);
+	if ($[5] === Symbol.for("react.memo_cache_sentinel")) {
+		t5 = () => {
+			dropLostFocus();
 		};
-		$[4] = t5;
-	} else t5 = $[4];
+		$[5] = t5;
+	} else t5 = $[5];
+	useLayoutEffect$1(t5);
 	let t6;
-	if ($[5] !== isDisabled) {
+	if ($[6] === Symbol.for("react.memo_cache_sentinel")) {
 		t6 = {
-			isDisabled,
-			onFocusChange: t5
+			onFocus: (event) => {
+				focusedElementRef.current = event.target;
+			},
+			onBlur: () => {
+				focusedElementRef.current = null;
+			},
+			onFocusChange: (focused) => {
+				setIsFocused(focused);
+				if (focused) setIsFocusVisible(focusVisibleRef.current);
+			}
 		};
-		$[5] = isDisabled;
 		$[6] = t6;
 	} else t6 = $[6];
 	const { focusProps } = useFocus(t6);

package/dist/utils/react/interactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.js","names":["isFocusVisible","getIsFocusVisible","useFocusVisibleListener","useRef","useState","useFocus","reactAriaUseFocus","t0","t1","$","_c","isDisabled","onlyVisible","undefined","isFocused","setIsFocused","setIsFocusVisible","t2","Symbol","for","focusVisibleRef","isListening","t3","t4","visible","current","t5","focused","t6","onFocusChange","focusProps","t7","t8"],"sources":["../../../src/utils/react/interactions.ts"],"sourcesContent":["import {\n  isFocusVisible as getIsFocusVisible,\n  useFocusVisibleListener,\n} from '@react-aria/interactions';\nimport { useRef, useState } from 'react';\nimport { useFocus as reactAriaUseFocus } from 'react-aria';\n\nexport function useFocus(\n  { isDisabled }: { isDisabled?: boolean },\n  onlyVisible = false,\n) {\n  let [isFocused, setIsFocused] = useState(false);\n  let [isFocusVisible, setIsFocusVisible] = useState(false);\n\n  // React-aria detaches focus handlers when disabled, so blur events\n  // aren't captured. Clear stale focus synchronously during render\n  // to avoid a one-frame glitch (useEffect would be too late).\n  if (isDisabled && isFocused) {\n    setIsFocused(false);\n  }\n\n  // Keep the listener's value, not the raw global modality: react-aria ignores keys\n  // typed in a text input, so focus moved after typing there shows no ring.\n  let focusVisibleRef = useRef(getIsFocusVisible());\n  // Only a focused element takes it into state: updating state on every button\n  // re-rendered all of them on each keyboard/pointer switch.\n  let isListening = onlyVisible && isFocused;\n\n  useFocusVisibleListener(\n    (visible) => {\n      focusVisibleRef.current = visible;\n\n      if (isListening) {\n        setIsFocusVisible(visible);\n      }\n    },\n    [isListening],\n  );\n\n  let { focusProps } = reactAriaUseFocus({\n    isDisabled,\n    onFocusChange: (focused) => {\n      setIsFocused(focused);\n\n      if (focused) {\n        setIsFocusVisible(focusVisibleRef.current);\n      }\n    },\n  });\n\n  return {\n    focusProps,\n    isFocused: isFocused && (onlyVisible ? isFocusVisible : true),\n  };\n}\n"],"mappings":";;;;;;;AAOA,SAAOK,WAAAE,IAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,GAAA;CACL,MAAA,EAAAC,eAAAJ;CACA,MAAAK,cAAAJ,OAAAK,SAAA,QAAAL;CAEA,MAAA,CAAAM,WAAAC,gBAAgCX,SAAS,MAAM;CAC/C,MAAA,CAAAJ,kBAAAgB,qBAA0CZ,SAAS,MAAM;AAKzD,KAAIO,cAAAG,UACFC,cAAa,MAAM;CACpB,IAAAE;AAAA,KAAAR,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAI4BF,OAAAhB,gBAAmB;AAAAQ,IAAA,KAAAQ;OAAAA,MAAAR,EAAA;CAAhD,MAAAW,kBAAsBjB,OAAOc,GAAoB;CAGjD,MAAAI,cAAkBT,eAAAE;CAAyB,IAAAQ;CAAA,IAAAC;AAAA,KAAAd,EAAA,OAAAY,aAAA;AAGzCC,QAAAE,YAAA;AACEJ,mBAAeK,UAAWD;AAE1B,OAAIH,YACFL,mBAAkBQ,QAAQ;;AAG9BD,OAAA,CAACF,YAAY;AAAAZ,IAAA,KAAAY;AAAAZ,IAAA,KAAAa;AAAAb,IAAA,KAAAc;QAAA;AAAAD,OAAAb,EAAA;AAAAc,OAAAd,EAAA;;AARfP,yBACEoB,IAOAC,GACD;CAAA,IAAAG;AAAA,KAAAjB,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAIgBO,QAAAC,YAAA;AACbZ,gBAAaY,QAAQ;AAErB,OAAIA,QACFX,mBAAkBI,gBAAeK,QAAS;;AAE7ChB,IAAA,KAAAiB;OAAAA,MAAAjB,EAAA;CAAA,IAAAmB;AAAA,KAAAnB,EAAA,OAAAE,YAAA;AARoCiB,OAAA;GAAAjB;GAAAkB,eAEtBH;GAOhB;AAAAjB,IAAA,KAAAE;AAAAF,IAAA,KAAAmB;OAAAA,MAAAnB,EAAA;CATD,MAAA,EAAAqB,eAAqBxB,SAAkBsB,GASrC;CAIW,MAAAG,KAAAjB,cAAcF,cAAAZ,mBAAA;CAAoC,IAAAgC;AAAA,KAAAvB,EAAA,OAAAqB,cAAArB,EAAA,OAAAsB,IAAA;AAFxDC,OAAA;GAAAF;GAAAhB,WAEMiB;GACZ;AAAAtB,IAAA,KAAAqB;AAAArB,IAAA,KAAAsB;AAAAtB,IAAA,KAAAuB;OAAAA,MAAAvB,EAAA;AAAA,QAHMuB"}
+{"version":3,"file":"interactions.js","names":["isFocusVisible","getIsFocusVisible","useFocusVisibleListener","getActiveElement","getOwnerDocument","useRef","useState","useFocus","reactAriaUseFocus","useLayoutEffect","t0","$","_c","onlyVisible","undefined","isFocused","setIsFocused","setIsFocusVisible","focusedElementRef","t1","Symbol","for","element","current","dropLostFocus","t2","focusVisibleRef","isListening","t3","t4","visible","t5","t6","onFocus","event","target","onBlur","onFocusChange","focused","focusProps","t7","t8"],"sources":["../../../src/utils/react/interactions.ts"],"sourcesContent":["import {\n  isFocusVisible as getIsFocusVisible,\n  useFocusVisibleListener,\n} from '@react-aria/interactions';\nimport { getActiveElement, getOwnerDocument } from '@react-aria/utils';\nimport { useRef, useState } from 'react';\nimport { useFocus as reactAriaUseFocus } from 'react-aria';\n\nimport { useLayoutEffect } from './useLayoutEffect';\n\n/**\n * Whether the element holds focus, disabled or not: a control that keeps\n * focus while `aria-disabled` still shows where focus is.\n */\nexport function useFocus(onlyVisible = false) {\n  let [isFocused, setIsFocused] = useState(false);\n  let [isFocusVisible, setIsFocusVisible] = useState(false);\n\n  // No blur reaches React when the focused element is replaced (a tooltip\n  // wrapper added or dropped), disabled through a `fieldset` or stripped of its\n  // tabIndex. So a focus the element no longer holds is dropped after each\n  // render of this control and, when the change came from elsewhere without\n  // re-rendering it, on the next key or pointer press React Aria reports (keys\n  // typed in a text field don't count).\n  let focusedElementRef = useRef<Element | null>(null);\n\n  let dropLostFocus = () => {\n    let element = focusedElementRef.current;\n\n    // React Aria's own check, which also looks inside a shadow root.\n    if (element && element !== getActiveElement(getOwnerDocument(element))) {\n      focusedElementRef.current = null;\n      setIsFocused(false);\n    }\n  };\n\n  // Keep the listener's value, not the raw global modality: react-aria ignores keys\n  // typed in a text input, so focus moved after typing there shows no ring.\n  let focusVisibleRef = useRef(getIsFocusVisible());\n  // Only a focused element takes it into state: updating state on every button\n  // re-rendered all of them on each keyboard/pointer switch.\n  let isListening = onlyVisible && isFocused;\n\n  useFocusVisibleListener(\n    (visible) => {\n      focusVisibleRef.current = visible;\n      dropLostFocus();\n\n      if (isListening) {\n        setIsFocusVisible(visible);\n      }\n    },\n    [isListening],\n  );\n\n  useLayoutEffect(() => {\n    dropLostFocus();\n  });\n\n  let { focusProps } = reactAriaUseFocus({\n    onFocus: (event) => {\n      focusedElementRef.current = event.target;\n    },\n    onBlur: () => {\n      focusedElementRef.current = null;\n    },\n    onFocusChange: (focused) => {\n      setIsFocused(focused);\n\n      if (focused) {\n        setIsFocusVisible(focusVisibleRef.current);\n      }\n    },\n  });\n\n  return {\n    focusProps,\n    isFocused: isFocused && (onlyVisible ? isFocusVisible : true),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAOO,WAAAG,IAAA;CAAA,MAAAC,IAAAC,EAAA,GAAA;CAAkB,MAAAC,cAAAH,OAAAI,SAAA,QAAAJ;CACvB,MAAA,CAAAK,WAAAC,gBAAgCV,SAAS,MAAM;CAC/C,MAAA,CAAAN,kBAAAiB,qBAA0CX,SAAS,MAAM;CAQzD,MAAAY,oBAAwBb,OAAuB,KAAK;CAAC,IAAAc;AAAA,KAAAR,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEjCF,aAAA;GAClB,MAAAG,UAAcJ,kBAAiBK;AAG/B,OAAID,WAAWA,YAAYnB,iBAAiBC,iBAAiBkB,QAAQ,CAAC,EAAA;AACpEJ,sBAAiBK,UAAW;AAC5BP,iBAAa,MAAM;;;AAEtBL,IAAA,KAAAQ;OAAAA,MAAAR,EAAA;CARD,MAAAa,gBAAoBL;CAQlB,IAAAM;AAAA,KAAAd,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAI2BI,OAAAxB,gBAAmB;AAAAU,IAAA,KAAAc;OAAAA,MAAAd,EAAA;CAAhD,MAAAe,kBAAsBrB,OAAOoB,GAAoB;CAGjD,MAAAE,cAAkBd,eAAAE;CAAyB,IAAAa;CAAA,IAAAC;AAAA,KAAAlB,EAAA,OAAAgB,aAAA;AAGzCC,QAAAE,YAAA;AACEJ,mBAAeH,UAAWO;AAC1BN,kBAAe;AAEf,OAAIG,YACFV,mBAAkBa,QAAQ;;AAG9BD,OAAA,CAACF,YAAY;AAAAhB,IAAA,KAAAgB;AAAAhB,IAAA,KAAAiB;AAAAjB,IAAA,KAAAkB;QAAA;AAAAD,OAAAjB,EAAA;AAAAkB,OAAAlB,EAAA;;AATfT,yBACE0B,IAQAC,GACD;CAAA,IAAAE;AAAA,KAAApB,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEeU,aAAA;AACdP,kBAAe;;AAChBb,IAAA,KAAAoB;OAAAA,MAAApB,EAAA;AAFDF,mBAAgBsB,GAEd;CAAA,IAAAC;AAAA,KAAArB,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEqCW,OAAA;GAAAC,UAC5BC,UAAA;AACPhB,sBAAiBK,UAAWW,MAAKC;;GAClCC,cACO;AACNlB,sBAAiBK,UAAW;;GAC7Bc,gBACcC,YAAA;AACbtB,iBAAasB,QAAQ;AAErB,QAAIA,QACFrB,mBAAkBS,gBAAeH,QAAS;;GAG/C;AAAAZ,IAAA,KAAAqB;OAAAA,MAAArB,EAAA;CAdD,MAAA,EAAA4B,eAAqB/B,SAAkBwB,GAcrC;CAIW,MAAAQ,KAAAzB,cAAcF,cAAAb,mBAAA;CAAoC,IAAAyC;AAAA,KAAA9B,EAAA,OAAA4B,cAAA5B,EAAA,OAAA6B,IAAA;AAFxDC,OAAA;GAAAF;GAAAxB,WAEMyB;GACZ;AAAA7B,IAAA,KAAA4B;AAAA5B,IAAA,KAAA6B;AAAA7B,IAAA,KAAA8B;OAAAA,MAAA9B,EAAA;AAAA,QAHM8B"}

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { Children, isValidElement } from "react";
 
 //#region src/utils/react/isTextOnly.ts

package/dist/utils/react/mapProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/mapProps.ts
 /** Converts AriaButtonProps to CubeButtonProps */
 function ariaToCubeButtonProps(props) {

package/dist/utils/react/mergeProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));

package/dist/utils/react/programmaticFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/programmaticFocus.ts
 /**
 * Telling focus the user moved from focus a component moved for them.

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.

package/dist/utils/react/sharedStore.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { c } from "react-compiler-runtime";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useCallback, useRef, useState } from "react";
 

package/dist/utils/react/useCombinedRefs.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef } from "react";
 

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { c } from "react-compiler-runtime";
 import { useEffect } from "react";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef, useState } from "react";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react-compiler-runtime";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { c } from "react-compiler-runtime";
 import { useContext, useEffect, useRef } from "react";

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { Fragment, isValidElement } from "react";
 
 //#region src/utils/react/wrapNodeIfPlain.ts

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { isSelector, mergeStyles } from "@tenphi/tasty";
 
 //#region src/utils/styles.ts

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
 
 //#region src/utils/warnings.ts

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.189.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.1 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.189.0";
+const VERSION = "0.190.1";
 const TASTY_VERSION = "3.9.6";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/actions/Button.md

@@ -195,7 +195,7 @@ import { IconPlus } from '@tabler/icons-react';
 </Button>;
 ```
 
-A disabled button keeps showing its tooltip. Browsers stop dispatching mouse events on elements carrying the native `disabled` attribute, so a button that has a tooltip is marked with `aria-disabled` instead and kept inert: `onPress` never fires and clicks (including the ones Enter and Space produce) do nothing. Such a button also stays in the tab order, so keyboard users can focus it and read the tooltip. Buttons rendered as links (`to`) are always marked this way, since `disabled` is not a valid attribute on an anchor.
+A disabled button keeps showing its tooltip. Browsers stop dispatching mouse events on elements carrying the native `disabled` attribute, so a button that has a tooltip is marked with `aria-disabled` instead and kept inert: `onPress` never fires and clicks (including the ones Enter and Space produce) do nothing. Such a button also stays in the tab order, so keyboard users can focus it, see its focus ring and read the tooltip, and the keys that would open a `MenuTrigger` menu do nothing. Buttons rendered as links (`to`) are always marked this way, since `disabled` is not a valid attribute on an anchor.
 
 ### Custom Size
 

package/docs/components/actions/ItemAction.md

@@ -19,9 +19,9 @@ Each host re-exports it as its own `.Action` — `Item.Action`, `ItemButton.Acti
 - **`icon`** `ReactNode | 'checkmark'` — Icon element or `'checkmark'` for a selection indicator
 - **`type`** `'primary' | 'outline' | 'clear'` (default: `'clear'`) — Visual type. `clear` is borderless and paints nothing at rest, so a row full of actions does not read as busy.
 - **`theme`** `'current' | 'default' | 'danger' | 'success' | 'warning' | 'note' | 'special'` (default: `'current'`) — Color theme. `current` derives every color from the inherited `currentcolor`, so the action tracks whatever row hosts it without being told the row's type or theme. Name any other theme to have the action paint itself instead.
-- **`isLoading`** `boolean` (default: `false`) — Shows loading spinner
+- **`isLoading`** `boolean` (default: `false`) — Shows a loading spinner in the icon slot and disables the action, like `Button`, so a second press does not run it again. `isDisabled={false}` does not re-enable a loading action.
 - **`isSelected`** `boolean` (default: `false`) — Selected state (works with `icon="checkmark"`)
-- **`isDisabled`** `boolean` (default: `false`) — Disables the action. Inherits from parent; use `isDisabled={false}` to override.
+- **`isDisabled`** `boolean` (default: `false`) — Disables the action. Inherits from parent; use `isDisabled={false}` to override. Which disabled actions keyboard users can still reach is covered under Accessibility.
 - **`tooltip`** `string | object` — Tooltip content (shown for icon-only buttons)
 - **`onPress`** `() => void` — Press event handler
 
@@ -38,6 +38,14 @@ Supports [Base properties](../../BaseProperties.md).
 <ItemAction icon={<IconTrash />} tooltip="Delete" theme="danger" />
 ```
 
+### Loading action
+
+`isLoading` replaces the icon with a spinner and disables the action until the work ends, so there is no need to pair it with `isDisabled`.
+
+```jsx
+<ItemAction icon={<IconRefresh />} tooltip="Refresh" isLoading={isFetching} onPress={refetch} />
+```
+
 ### Checkmark action
 
 ```jsx
@@ -60,3 +68,23 @@ Supports [Base properties](../../BaseProperties.md).
   Document.pdf
 </ItemButton>
 ```
+
+## Accessibility
+
+### Keyboard Navigation
+
+- `Tab` – Moves focus to the action.
+- `Space` / `Enter` – Activates the action.
+
+A disabled or loading action stays reachable only where keyboard users need it:
+
+- As on `Button`, a disabled action leaves the tab order, unless it is an icon-only action with a tooltip that disables itself. That one stays a Tab stop and shows its focus ring, so keyboard users can read the tooltip.
+- Inside a disabled parent, every disabled button action leaves the tab order.
+- A disabled link action (`to`) stays a Tab stop, even inside a disabled parent.
+- A loading action keeps focus it already has, and its focus ring, so a keyboard press keeps its place, but Tab skips it until loading ends.
+- A disabled or loading action that holds focus ignores the keys that would open a `MenuTrigger` menu.
+
+### ARIA Properties
+
+- `aria-label` – Taken from a plain-text `tooltip` when none is passed.
+- `aria-disabled` – Announces the disabled state where the native `disabled` attribute would drop focus or hover: on a loading action, an icon-only action with a tooltip that disables itself, and a link action. The action is kept inert: activation handlers are dropped and clicks do nothing.

package/docs/components/content/InfoBadge.md

@@ -22,8 +22,8 @@ Every field's `labelTooltip` prop already renders an `InfoBadge` next to the lab
 - **`theme`** `'default' | 'danger' | 'success'` (default: `'default'`) — Color theme. The default `default` + `clear` combination is brand-tinted; any other combination uses the theme's own colors.
 - **`to`** `string | number | object` — Navigation target. Renders the badge as a link. Supports the `!` (new tab) and `@` (native navigation) prefixes.
 - **`onPress`** `(e: PressEvent) => void` — Press handler. Renders the badge as a button.
-- **`isLoading`** `boolean` — Replace the icon with a loading spinner
-- **`isDisabled`** `boolean` — Disable the badge
+- **`isLoading`** `boolean` — Replace the icon with a loading spinner. An interactive badge can't be pressed or followed while loading.
+- **`isDisabled`** `boolean` — Disable the badge. An interactive badge stays reachable by keyboard and shows its focus ring, so its tooltip can still be read.
 
 ### Accessibility
 

package/docs/components/helpers/DisplayTransition.md

@@ -24,7 +24,7 @@ A headless helper component that manages enter and exit animation states for sho
 - **`onRest`** `(transition: 'enter' | 'exit') => void` — Fires after enter settles or after exit completes (unmount)
 - **`onPhaseChange`** `(phase: ReportedPhase) => void` — Fires when the transition phase changes
 - **`onToggle`** `(isShown: boolean) => void` — Fires when the derived `isShown` value changes
-- **`children`** `(props: { phase, isShown, ref }) => ReactNode` — Render prop receiving the current phase, visibility state, and a ref callback to bind to the transitioned element
+- **`children`** `(props: { phase, isShown, isExiting, ref }) => ReactNode` — Render prop receiving the current phase, visibility state, whether the content is exiting, and a ref callback to bind to the transitioned element
 
 ### Base Properties
 
@@ -41,6 +41,8 @@ The component manages four distinct phases:
 
 The render prop receives an object `{ phase, isShown }` where `isShown` is only `true` during the `entered` phase.
 
+It also receives `isExiting`, which is `true` from the render where the `isShown` prop turns `false` until the phase reaches `unmounted`. `phase` still reports `entered`, and `isShown` stays `true`, for the two frames before the exit starts, and values the render prop closes over stay at their shown-state reading while `preserveContent` replays it, so `isExiting` is the way to tell closing content from shown content. The kit's overlays use it to mark a closing overlay with `data-react-aria-top-layer`, so a press on it never counts as a press outside the overlay underneath.
+
 ## Examples
 
 ### Basic Usage