@cube-dev/ui-kit 0.200.0 → 0.200.1

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.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.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 //#region src/utils/react/useMergeStyles.ts

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,10 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { getEventTarget, nodeContains } from "@react-aria/utils";
 //#region src/utils/react/useOverlayEscapeGuard.ts
 /**
-* Stops a CLOSED overlay from answering for `Escape` (CUB-4839).
+* Stops a CLOSED overlay from answering for `Escape` (CUB-4839), and keeps an
+* Escape already handled by a child inside its open overlay.
 *
 * `useOverlay`'s `Escape` handler calls `stopPropagation()` and
 * `preventDefault()` for every `Escape` it sees, and only THEN asks whether
@@ -32,6 +33,10 @@ function useOverlayEscapeGuard(overlayProps, isOpen) {
 	if ($[0] !== isOpen || $[1] !== overlayProps) {
 		t0 = (event) => {
 			if (event.key === "Escape" && !isOpen) return;
+			if (event.key === "Escape" && event.isDefaultPrevented()) {
+				event.stopPropagation();
+				return;
+			}
 			const target = getEventTarget(event);
 			if (event.key === "Escape" && !nodeContains(event.currentTarget, target)) {
 				overlayProps.onKeyDown?.({

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

@@ -1 +1 @@
-{"version":3,"file":"useOverlayEscapeGuard.js","names":["getEventTarget","nodeContains","useEvent","DOMAttributes","KeyboardEvent","OverlayDOMProps","useOverlayEscapeGuard","overlayProps","isOpen","$","_c","t0","event","key","target","currentTarget","onKeyDown","preventDefault","stopPropagation","t1","_c"],"sources":["../../../src/utils/react/useOverlayEscapeGuard.ts"],"sourcesContent":["import { getEventTarget, nodeContains } from '@react-aria/utils';\n\nimport { useEvent } from '../../_internal';\n\nimport type { DOMAttributes, KeyboardEvent } from 'react';\n\ntype OverlayDOMProps = DOMAttributes<any>;\n\n/**\n * Stops a CLOSED overlay from answering for `Escape` (CUB-4839).\n *\n * `useOverlay`'s `Escape` handler calls `stopPropagation()` and\n * `preventDefault()` for every `Escape` it sees, and only THEN asks whether\n * this overlay is the topmost one allowed to act on it — unlike\n * `onInteractOutside`, which it gates on `isOpen` up front. An overlay that has\n * already closed therefore consumes the key and does nothing with it, so the\n * `Escape` meant for the Dialog around it closes nothing at all.\n *\n * That is reachable here because our overlays stay mounted for their exit\n * transition while still holding DOM focus: pick an option from a list inside a\n * Dialog and the very next `Escape` lands in the closing list.\n *\n * Passing `useOverlay` an `isKeyboardDismissDisabled` of its own does NOT work,\n * and that is the reason this exists. `DisplayTransition` preserves content\n * across an exit by replaying the children it stored while the overlay was\n * open, so every value that subtree captured — `isKeyboardDismissDisabled`\n * included — stays frozen at its open-state reading for exactly the window\n * this has to guard. `useEvent` gets around it by returning a handler whose\n * identity never changes while its body always runs the latest render's\n * closure, so the frozen copy still sees the current `isOpen`.\n */\nexport function useOverlayEscapeGuard<T extends OverlayDOMProps>(\n  overlayProps: T,\n  isOpen: boolean | undefined,\n): T {\n  const onKeyDown = useEvent((event: KeyboardEvent<any>) => {\n    // Decline it, so it reaches whoever can actually act on it.\n    if (event.key === 'Escape' && !isOpen) return;\n\n    // Aria's shortcut handler ignores physical DOM outsiders. A closing\n    // popup still bubbles Escape through its logical React portal ancestry.\n    // Let the open ancestor's handler retain its topmost-overlay check.\n    const target = getEventTarget(event);\n    if (event.key === 'Escape' && !nodeContains(event.currentTarget, target)) {\n      overlayProps.onKeyDown?.({\n        ...event,\n        currentTarget: target,\n        preventDefault: () => event.preventDefault(),\n        stopPropagation: () => event.stopPropagation(),\n      });\n      return;\n    }\n\n    overlayProps.onKeyDown?.(event);\n  });\n\n  return { ...overlayProps, onKeyDown };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAOM,sBAAAC,cAAAC,QAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,UAAAC,EAAA,OAAAF,cAAA;EAIsBI,MAAAC,UAAA;GAEzB,IAAIA,MAAKC,QAAS,YAAd,CAA2BL,QAAM;GAKrC,MAAAM,SAAed,eAAeY,KAAK;GACnC,IAAIA,MAAKC,QAAS,YAAd,CAA2BZ,aAAaW,MAAKG,eAAgBD,MAAM,GAAC;IACtEP,aAAYS,YAAa;KAAA,GACpBJ;KAAKG,eACOD;KAAMG,sBACCL,MAAKK,eAAgB;KAACC,uBACrBN,MAAKM,gBAAiB;IAC/C,CAAC;IAAC;GAAA;GAIJX,aAAYS,YAAaJ,KAAK;EAAC;EAChCH,EAAA,KAAAD;EAAAC,EAAA,KAAAF;EAAAE,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAnBD,MAAAO,YAAkBd,SAASS,EAmB1B;CAAE,IAAAQ;CAAA,IAAAV,EAAA,OAAAO,aAAAP,EAAA,OAAAF,cAAA;EAEIY,KAAA;GAAA,GAAKZ;GAAYS;EAAY;EAACP,EAAA,KAAAO;EAAAP,EAAA,KAAAF;EAAAE,EAAA,KAAAU;CAAA,OAAAA,KAAAV,EAAA;CAAA,OAA9BU;AAA8B"}
+{"version":3,"file":"useOverlayEscapeGuard.js","names":["getEventTarget","nodeContains","useEvent","DOMAttributes","KeyboardEvent","OverlayDOMProps","useOverlayEscapeGuard","overlayProps","isOpen","$","_c","t0","event","key","isDefaultPrevented","stopPropagation","target","currentTarget","onKeyDown","preventDefault","t1","_c"],"sources":["../../../src/utils/react/useOverlayEscapeGuard.ts"],"sourcesContent":["import { getEventTarget, nodeContains } from '@react-aria/utils';\n\nimport { useEvent } from '../../_internal';\n\nimport type { DOMAttributes, KeyboardEvent } from 'react';\n\ntype OverlayDOMProps = DOMAttributes<any>;\n\n/**\n * Stops a CLOSED overlay from answering for `Escape` (CUB-4839), and keeps an\n * Escape already handled by a child inside its open overlay.\n *\n * `useOverlay`'s `Escape` handler calls `stopPropagation()` and\n * `preventDefault()` for every `Escape` it sees, and only THEN asks whether\n * this overlay is the topmost one allowed to act on it — unlike\n * `onInteractOutside`, which it gates on `isOpen` up front. An overlay that has\n * already closed therefore consumes the key and does nothing with it, so the\n * `Escape` meant for the Dialog around it closes nothing at all.\n *\n * That is reachable here because our overlays stay mounted for their exit\n * transition while still holding DOM focus: pick an option from a list inside a\n * Dialog and the very next `Escape` lands in the closing list.\n *\n * Passing `useOverlay` an `isKeyboardDismissDisabled` of its own does NOT work,\n * and that is the reason this exists. `DisplayTransition` preserves content\n * across an exit by replaying the children it stored while the overlay was\n * open, so every value that subtree captured — `isKeyboardDismissDisabled`\n * included — stays frozen at its open-state reading for exactly the window\n * this has to guard. `useEvent` gets around it by returning a handler whose\n * identity never changes while its body always runs the latest render's\n * closure, so the frozen copy still sees the current `isOpen`.\n */\nexport function useOverlayEscapeGuard<T extends OverlayDOMProps>(\n  overlayProps: T,\n  isOpen: boolean | undefined,\n): T {\n  const onKeyDown = useEvent((event: KeyboardEvent<any>) => {\n    // Decline it, so it reaches whoever can actually act on it.\n    if (event.key === 'Escape' && !isOpen) return;\n\n    // Code editors can close autocomplete by preventing default alone.\n    // Keep that Escape inside this overlay, including an enclosing dialog.\n    if (event.key === 'Escape' && event.isDefaultPrevented()) {\n      event.stopPropagation();\n      return;\n    }\n\n    // Aria's shortcut handler ignores physical DOM outsiders. A closing\n    // popup still bubbles Escape through its logical React portal ancestry.\n    // Let the open ancestor's handler retain its topmost-overlay check.\n    const target = getEventTarget(event);\n    if (event.key === 'Escape' && !nodeContains(event.currentTarget, target)) {\n      overlayProps.onKeyDown?.({\n        ...event,\n        currentTarget: target,\n        preventDefault: () => event.preventDefault(),\n        stopPropagation: () => event.stopPropagation(),\n      });\n      return;\n    }\n\n    overlayProps.onKeyDown?.(event);\n  });\n\n  return { ...overlayProps, onKeyDown };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAOM,sBAAAC,cAAAC,QAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,UAAAC,EAAA,OAAAF,cAAA;EAIsBI,MAAAC,UAAA;GAEzB,IAAIA,MAAKC,QAAS,YAAd,CAA2BL,QAAM;GAIrC,IAAII,MAAKC,QAAS,YAAYD,MAAKE,mBAAoB,GAAC;IACtDF,MAAKG,gBAAiB;IAAC;GAAA;GAOzB,MAAAC,SAAehB,eAAeY,KAAK;GACnC,IAAIA,MAAKC,QAAS,YAAd,CAA2BZ,aAAaW,MAAKK,eAAgBD,MAAM,GAAC;IACtET,aAAYW,YAAa;KAAA,GACpBN;KAAKK,eACOD;KAAMG,sBACCP,MAAKO,eAAgB;KAACJ,uBACrBH,MAAKG,gBAAiB;IAC/C,CAAC;IAAC;GAAA;GAIJR,aAAYW,YAAaN,KAAK;EAAC;EAChCH,EAAA,KAAAD;EAAAC,EAAA,KAAAF;EAAAE,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CA1BD,MAAAS,YAAkBhB,SAASS,EA0B1B;CAAE,IAAAS;CAAA,IAAAX,EAAA,OAAAS,aAAAT,EAAA,OAAAF,cAAA;EAEIa,KAAA;GAAA,GAAKb;GAAYW;EAAY;EAACT,EAAA,KAAAS;EAAAT,EAAA,KAAAF;EAAAE,EAAA,KAAAW;CAAA,OAAAA,KAAAX,EAAA;CAAA,OAA9BW;AAA8B"}

package/dist/utils/react/usePopoverSync.js

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

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.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.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.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.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
 //#region src/utils/react/useViewportSize.ts

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { Fragment, isValidElement } from "react";
 //#region src/utils/react/wrapNodeIfPlain.ts
 function wrapNodeIfPlain(children, render) {

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.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.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { isSelector, mergeStyles } from "@tenphi/tasty";
 //#region src/utils/styles.ts
 function isRecord(value) {

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.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.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.200.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.200.1 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.200.0";
+const VERSION = "0.200.1";
 const TASTY_VERSION = "3.14.0";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/overlays/Dialog.md

@@ -194,7 +194,7 @@ To clamp the width yourself, set `styles.width` (`styles={{ width: 'initial 520p
 
 - `Tab` - Moves focus between interactive elements within the dialog
 - `Shift + Tab` - Moves focus backward between interactive elements
-- `Escape` - Closes the dialog when its `DialogTrigger` or `DialogContainer` is dismissable (`isDismissable`, on by default) and `isKeyboardDismissDisabled` is not set
+- `Escape` - Closes the dialog when its `DialogTrigger` or `DialogContainer` is dismissable (`isDismissable`, on by default) and `isKeyboardDismissDisabled` is not set. If a control inside already prevents the key's default, the dialog stays open and keeps the handled Escape from reaching an enclosing dialog
 - `Enter/Space` - Activates focused buttons or interactive elements
 
 ### Screen Reader Support

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.200.0",
+  "version": "0.200.1",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {