@cube-dev/ui-kit 0.180.0 → 0.182.0

package/dist/shared/form.d.ts

@@ -1,5 +1,7 @@
 
+import { FormPath } from "../components/form/Form/modern/values.js";
 import { ModernValidationContext, ModernValidationRule } from "../components/form/Form/modern/validation.js";
+import { FormField } from "../components/form/Form/modern/field.js";
 import { Props } from "../props.js";
 import { Styles } from "@tenphi/tasty";
 import { ReactNode } from "react";
@@ -41,21 +43,27 @@ interface FieldValidationRule extends Omit<ModernValidationRule<any>, 'validator
   validator?: (rule: any, value: any, context: ModernValidationContext<any>) => any;
 }
 /** Core field identity and validation props */
-interface FieldCoreProps {
+interface FieldCoreProps<Value = unknown> {
+  /** Typed modern descriptor. Its form, path, and supplied options override matching input props. */
+  field?: FormField<Value>;
   /** The unique ID of the field */
   id?: string;
   /** The id prefix for the field to avoid collisions between forms */
   idPrefix?: string;
-  /** The field name */
-  name?: string;
+  /** Literal name, or a nested tuple path with a modern form controller. */
+  name?: FormPath;
   /** The form instance */
   form?: any;
   /** Function that checks whether to perform update of the form state. */
   shouldUpdate?: boolean | ((prevValues: any, nextValues: any) => boolean);
   /** Validation rules */
   rules?: (FieldValidationRule | any[])[];
-  /** Explicit revision key for modern validators with captured dependencies. */
+  /** Manual modern function revision, skipping source comparison. Declarative constraints are always compared. */
   rulesKey?: string;
+  /** Modern field paths that trigger revalidation. Declare conditional validator reads too. */
+  dependsOn?: readonly FormPath[];
+  /** External modern validator inputs, compared by Object.is (e.g. organizationId). */
+  deps?: readonly unknown[];
   /** Modern rule error ordering policy; defaults to the controller policy. */
   errorPolicy?: 'first' | 'all';
   /** Debounce in milliseconds for validation */
@@ -114,7 +122,7 @@ interface ToggleSelectionProps {
   /** Handler that is called when the selection state changes. */
   onChange?: (isSelected: boolean) => void;
 }
-interface FieldBaseProps extends FormBaseProps, FieldCoreProps {
+interface FieldBaseProps<Value = unknown> extends FormBaseProps, FieldCoreProps<Value> {
   /** The label of the field */
   label?: ReactNode;
   /** An additional content next to the label */

package/dist/tokens/all-tokens.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/base.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/base.ts
 /**
 * Base design system tokens.
@@ -21,7 +21,7 @@ const BASE_TOKENS = {
 	"$large-radius": "(1r + .5x)",
 	"$card-radius": "(1r + .5x)",
 	"$sharp-radius": "0px",
-	"$min-dialog-size": "min(288px, calc(100vw - (2 * var(--gap))))",
+	"$min-dialog-size": "min(288px, calc(100dvw - (8 * var(--gap))))",
 	$transition: "80ms",
 	"$disclosure-transition": "120ms",
 	"$tab-transition": "120ms",

package/dist/tokens/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","names":[],"sources":["../../src/tokens/base.ts"],"sourcesContent":["import type { Styles } from '@tenphi/tasty';\n\n/**\n * Base design system tokens.\n * These define the fundamental units and values used throughout the system.\n *\n * Keys use $ prefix for CSS custom properties.\n */\nexport const BASE_TOKENS: Styles = {\n  // Typography base\n  /** @deprecated Use preset tokens instead */\n  '$font-size': '14px',\n  /** @deprecated Use preset tokens instead */\n  '$line-height': '20px',\n\n  // Input typography\n  '$input-font-size': '14px',\n  '$input-line-height': '20px',\n  '$input-letter-spacing': '0.02em',\n\n  // Opacity & dimensions\n  /** Opacity for disabled elements */\n  '$disabled-opacity': '.4',\n  /** Base gap unit for spacing (used with `.5x`, `1x`, `2x` etc.) */\n  $gap: '8px',\n  /** Stroke width for icons */\n  '$stroke-width': 1.5,\n  /** Focus outline width */\n  '$outline-width': 'calc(1rem / 16 * 3)',\n  /** Border width for bordered elements */\n  '$border-width': '1px',\n\n  // Border radius\n  /** Base border radius (used with `1r`, `2r` etc.) */\n  $radius: '6px',\n  /** Larger radius using tasty calc: 1r + 0.5x */\n  '$large-radius': '(1r + .5x)',\n  /** Card border radius */\n  '$card-radius': '(1r + .5x)',\n  /** Sharp corner for leaf shapes */\n  '$sharp-radius': '0px',\n\n  // Misc dimensions\n  /** Minimum dialog width (responsive) */\n  '$min-dialog-size': 'min(288px, calc(100vw - (2 * var(--gap))))',\n\n  // Transitions\n  /** Default transition duration */\n  $transition: '80ms',\n  /** Transition for disclosure animations */\n  '$disclosure-transition': '120ms',\n  /** Transition for tab animations */\n  '$tab-transition': '120ms',\n  /** Transition for fade animations */\n  '$fade-transition': '200ms',\n\n  /**\n   * Marks an element as carrying the token block. Not a design value — nothing\n   * styles against it.\n   *\n   * `resolveTokenValue()` reads it to answer the one question a computed value\n   * cannot: \"are the kit's tokens in effect here?\" Tasty registers `@property`\n   * defaults with real initial values — `--gap` is `4px` off the block, not\n   * `0px` — so a token read from outside `<Root>` comes back plausible and\n   * wrong, and no amount of inspecting the value would reveal it. This is\n   * declared alongside the tokens, so it is present exactly where they are.\n   */\n  '$tokens-applied': '1',\n\n  // Scrollbar tokens\n  '$scrollbar-width': '1.5x',\n  '$scrollbar-outline-width': '1ow',\n  '$scrollbar-radius': '1.5r',\n  '#scrollbar-thumb': '#text.5',\n  '#scrollbar-outline': '#clear',\n  '#scrollbar-bg': '#surface-2',\n  '#scrollbar-corner': '#clear',\n};\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAsB;CAGjC,cAAc;CAEd,gBAAgB;CAGhB,oBAAoB;CACpB,sBAAsB;CACtB,yBAAyB;CAIzB,qBAAqB;CAErB,MAAM;CAEN,iBAAiB;CAEjB,kBAAkB;CAElB,iBAAiB;CAIjB,SAAS;CAET,iBAAiB;CAEjB,gBAAgB;CAEhB,iBAAiB;CAIjB,oBAAoB;CAIpB,aAAa;CAEb,0BAA0B;CAE1B,mBAAmB;CAEnB,oBAAoB;CAapB,mBAAmB;CAGnB,oBAAoB;CACpB,4BAA4B;CAC5B,qBAAqB;CACrB,oBAAoB;CACpB,sBAAsB;CACtB,iBAAiB;CACjB,qBAAqB;CACtB"}
+{"version":3,"file":"base.js","names":[],"sources":["../../src/tokens/base.ts"],"sourcesContent":["import type { Styles } from '@tenphi/tasty';\n\n/**\n * Base design system tokens.\n * These define the fundamental units and values used throughout the system.\n *\n * Keys use $ prefix for CSS custom properties.\n */\nexport const BASE_TOKENS: Styles = {\n  // Typography base\n  /** @deprecated Use preset tokens instead */\n  '$font-size': '14px',\n  /** @deprecated Use preset tokens instead */\n  '$line-height': '20px',\n\n  // Input typography\n  '$input-font-size': '14px',\n  '$input-line-height': '20px',\n  '$input-letter-spacing': '0.02em',\n\n  // Opacity & dimensions\n  /** Opacity for disabled elements */\n  '$disabled-opacity': '.4',\n  /** Base gap unit for spacing (used with `.5x`, `1x`, `2x` etc.) */\n  $gap: '8px',\n  /** Stroke width for icons */\n  '$stroke-width': 1.5,\n  /** Focus outline width */\n  '$outline-width': 'calc(1rem / 16 * 3)',\n  /** Border width for bordered elements */\n  '$border-width': '1px',\n\n  // Border radius\n  /** Base border radius (used with `1r`, `2r` etc.) */\n  $radius: '6px',\n  /** Larger radius using tasty calc: 1r + 0.5x */\n  '$large-radius': '(1r + .5x)',\n  /** Card border radius */\n  '$card-radius': '(1r + .5x)',\n  /** Sharp corner for leaf shapes */\n  '$sharp-radius': '0px',\n\n  // Misc dimensions\n  /**\n   * Minimum dialog width (responsive).\n   *\n   * The viewport term must match the `100dvw - 8x` max-width that `Dialog`,\n   * `Modal` and `Tray` set, because CSS resolves `min-width` *after*\n   * `max-width`: if this floor can exceed that ceiling, the floor wins and the\n   * dialog overflows its own viewport. It did, below ~352px — an Excel/Sheets\n   * task pane is 300-350px, so every dialog there rendered 288px wide inside a\n   * 236px box.\n   */\n  '$min-dialog-size': 'min(288px, calc(100dvw - (8 * var(--gap))))',\n\n  // Transitions\n  /** Default transition duration */\n  $transition: '80ms',\n  /** Transition for disclosure animations */\n  '$disclosure-transition': '120ms',\n  /** Transition for tab animations */\n  '$tab-transition': '120ms',\n  /** Transition for fade animations */\n  '$fade-transition': '200ms',\n\n  /**\n   * Marks an element as carrying the token block. Not a design value — nothing\n   * styles against it.\n   *\n   * `resolveTokenValue()` reads it to answer the one question a computed value\n   * cannot: \"are the kit's tokens in effect here?\" Tasty registers `@property`\n   * defaults with real initial values — `--gap` is `4px` off the block, not\n   * `0px` — so a token read from outside `<Root>` comes back plausible and\n   * wrong, and no amount of inspecting the value would reveal it. This is\n   * declared alongside the tokens, so it is present exactly where they are.\n   */\n  '$tokens-applied': '1',\n\n  // Scrollbar tokens\n  '$scrollbar-width': '1.5x',\n  '$scrollbar-outline-width': '1ow',\n  '$scrollbar-radius': '1.5r',\n  '#scrollbar-thumb': '#text.5',\n  '#scrollbar-outline': '#clear',\n  '#scrollbar-bg': '#surface-2',\n  '#scrollbar-corner': '#clear',\n};\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAsB;CAGjC,cAAc;CAEd,gBAAgB;CAGhB,oBAAoB;CACpB,sBAAsB;CACtB,yBAAyB;CAIzB,qBAAqB;CAErB,MAAM;CAEN,iBAAiB;CAEjB,kBAAkB;CAElB,iBAAiB;CAIjB,SAAS;CAET,iBAAiB;CAEjB,gBAAgB;CAEhB,iBAAiB;CAajB,oBAAoB;CAIpB,aAAa;CAEb,0BAA0B;CAE1B,mBAAmB;CAEnB,oBAAoB;CAapB,mBAAmB;CAGnB,oBAAoB;CACpB,4BAA4B;CAC5B,qBAAqB;CACrB,oBAAoB;CACpB,sBAAsB;CACtB,iBAAiB;CACjB,qBAAqB;CACtB"}

package/dist/tokens/color-seed.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { glaze } from "@tenphi/glaze";
 
 //#region src/tokens/color-seed.ts

package/dist/tokens/color-theme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { DEFAULT_HUE, DEFAULT_SATURATION, getPaletteConfig, getPaletteVersion, usePaletteVersion } from "./palette-config.js";
 import { tintRecipe } from "./palette.js";

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/lazy-styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/legacy-color.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { parseSrgbColor } from "../utils/colors.js";
 import { srgbToHex } from "@tenphi/glaze";
 

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { useSyncExternalStore } from "react";
 

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { SURFACE_SATURATION_SHARE, getPaletteConfig, getPaletteVersion, resolvePaletteConfig } from "./palette-config.js";
 import { lazyStyles } from "./lazy-styles.js";
 import { apcaContrast, glaze, okhslToLinearSrgb, variantToOkhsl } from "@tenphi/glaze";

package/dist/tokens/resolve.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../utils/react/useLayoutEffect.js";
 import { subscribeScheme } from "../utils/react/useScheme.js";
 import { warn } from "../utils/warnings.js";

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/shadows.ts
 /**
 * Shadow tokens using tasty shorthand syntax.

package/dist/tokens/sizes.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/sizes.ts
 /**
 * Component size values in pixels.

package/dist/tokens/spacing.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/spacing.ts
 /**
 * Spacing tokens using tasty multiplier syntax.

package/dist/tokens/typography.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/tokens/typography.ts
 /**
 * Typography presets for headings, text, and special styles.

package/dist/utils/ResizeSensor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { hslToSrgb, okhslToOklch, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHexAlpha } from "@tenphi/glaze";
 
 //#region src/utils/colors.ts

package/dist/utils/dotize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { Children, cloneElement, createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/utils/react/disabledProps.ts
 /**
 * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch

package/dist/utils/react/escapePropagation.js

@@ -0,0 +1,39 @@
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+//#region src/utils/react/escapePropagation.ts
+/**
+* Let `Escape` keep travelling out of a trigger or list, and hold every other
+* key exactly as before (CUB-4839).
+*
+* `Escape` is how whatever surrounds a control — a Dialog, most often — gets
+* dismissed, and these handlers never act on it. Every other key stays
+* contained: releasing them too would let `Enter` and typeahead reach ancestor
+* shortcuts and form submits, which callers have always had held here.
+*
+* Shape-aware because the same `onKeyDown` is reached two ways and the DEFAULT
+* is opposite between them:
+*
+* - Wrapped by `useKeyboard`, the event is augmented and propagation is
+*   stopped unless the handler opts out. `createEventHandler` also keeps that
+*   decision for the LIFE of the handler rather than per event — nothing
+*   resets it when the next key arrives — so an earlier opt-out would keep
+*   releasing later keys until a render replaced the handler. Re-asserting the
+*   default here is what keeps the opt-out from outliving its own event.
+* - Spread straight onto an element, the event is an ordinary React one and
+*   propagation is the default, so containment is what has to be asked for.
+*
+* Getting this backwards is silent in one direction and loud in the other:
+* calling `stopPropagation()` on a plain event really does stop it.
+*/
+function allowEscapeToPropagate(event) {
+	const isEscape = event.key === "Escape";
+	if (typeof event.continuePropagation === "function") {
+		if (isEscape) event.continuePropagation();
+		else if (event.isPropagationStopped?.() === false) event.stopPropagation();
+		return;
+	}
+	if (!isEscape) event.stopPropagation();
+}
+
+//#endregion
+export { allowEscapeToPropagate };
+//# sourceMappingURL=escapePropagation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escapePropagation.js","names":[],"sources":["../../../src/utils/react/escapePropagation.ts"],"sourcesContent":["import type { KeyboardEvent } from 'react';\n\n/**\n * A key event as it reaches a handler that may or may not have been wrapped by\n * React Aria's `useKeyboard`.\n */\ntype MaybeAugmentedKeyboardEvent = KeyboardEvent<any> & {\n  continuePropagation?: () => void;\n  isPropagationStopped?: () => boolean;\n};\n\n/**\n * Let `Escape` keep travelling out of a trigger or list, and hold every other\n * key exactly as before (CUB-4839).\n *\n * `Escape` is how whatever surrounds a control — a Dialog, most often — gets\n * dismissed, and these handlers never act on it. Every other key stays\n * contained: releasing them too would let `Enter` and typeahead reach ancestor\n * shortcuts and form submits, which callers have always had held here.\n *\n * Shape-aware because the same `onKeyDown` is reached two ways and the DEFAULT\n * is opposite between them:\n *\n * - Wrapped by `useKeyboard`, the event is augmented and propagation is\n *   stopped unless the handler opts out. `createEventHandler` also keeps that\n *   decision for the LIFE of the handler rather than per event — nothing\n *   resets it when the next key arrives — so an earlier opt-out would keep\n *   releasing later keys until a render replaced the handler. Re-asserting the\n *   default here is what keeps the opt-out from outliving its own event.\n * - Spread straight onto an element, the event is an ordinary React one and\n *   propagation is the default, so containment is what has to be asked for.\n *\n * Getting this backwards is silent in one direction and loud in the other:\n * calling `stopPropagation()` on a plain event really does stop it.\n */\nexport function allowEscapeToPropagate(event: MaybeAugmentedKeyboardEvent) {\n  const isEscape = event.key === 'Escape';\n\n  if (typeof event.continuePropagation === 'function') {\n    if (isEscape) {\n      event.continuePropagation();\n    } else if (event.isPropagationStopped?.() === false) {\n      // Only ever called when the flag is already clear, which is the one case\n      // `stopPropagation` does not warn about.\n      event.stopPropagation();\n    }\n\n    return;\n  }\n\n  if (!isEscape) event.stopPropagation();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,uBAAuB,OAAoC;CACzE,MAAM,WAAW,MAAM,QAAQ;AAE/B,KAAI,OAAO,MAAM,wBAAwB,YAAY;AACnD,MAAI,SACF,OAAM,qBAAqB;WAClB,MAAM,wBAAwB,KAAK,MAG5C,OAAM,iBAAiB;AAGzB;;AAGF,KAAI,CAAC,SAAU,OAAM,iBAAiB"}

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useState } from "react";
 import { useFocus, useFocusVisible } from "react-aria";
 

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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

@@ -0,0 +1,58 @@
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+//#region src/utils/react/programmaticFocus.ts
+/**
+* Telling focus the user moved from focus a component moved for them.
+*
+* Handing focus back to a trigger after its overlay closes is not the same
+* event as a user tabbing onto that trigger, but the DOM cannot tell them
+* apart: `.focus()` produces an ordinary focus event, and the modality is
+* still "keyboard" from whatever the user just did, so anything keyed off
+* focus-visible treats it as a deliberate arrival. A trigger's tooltip pops up
+* unasked — and then absorbs the user's next `Escape` from its own
+* document-level listener (CUB-4839).
+*
+* Two mechanisms, because restoration reaches us two ways:
+*
+* - `focusProgrammatically` for restores WE perform. `focus()` dispatches
+*   `focus`/`focusin` synchronously, so a flag set around the call is readable
+*   by every handler that runs for it and gone immediately afterwards. Exact,
+*   with no window to tune.
+*
+* - `markFocusRestoreWindow` for restores React Aria performs. A `FocusScope`
+*   restores on unmount, from inside React's own commit, and offers no hook to
+*   wrap — so an overlay that is closing declares the window instead. Coarser
+*   on purpose: it can only make a tooltip skip one arrival that lands while
+*   an overlay is going away, which is the case it exists for.
+*/
+let depth = 0;
+let restoreWindowEndsAt = 0;
+/**
+* Focus `element` without the UI reading it as the user arriving there.
+*/
+function focusProgrammatically(element, options) {
+	if (!element) return;
+	depth++;
+	try {
+		element.focus(options);
+	} finally {
+		depth--;
+	}
+}
+/**
+* Declare that focus is about to be restored by machinery we cannot wrap, for
+* roughly `duration` ms. Called by a closing overlay.
+*/
+function markFocusRestoreWindow(duration) {
+	restoreWindowEndsAt = Math.max(restoreWindowEndsAt, Date.now() + duration);
+}
+/**
+* Whether the focus being handled right now is a restoration rather than the
+* user arriving. Only meaningful inside a focus handler.
+*/
+function isFocusRestoration() {
+	return depth > 0 || Date.now() < restoreWindowEndsAt;
+}
+
+//#endregion
+export { focusProgrammatically, isFocusRestoration, markFocusRestoreWindow };
+//# sourceMappingURL=programmaticFocus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"programmaticFocus.js","names":[],"sources":["../../../src/utils/react/programmaticFocus.ts"],"sourcesContent":["/**\n * Telling focus the user moved from focus a component moved for them.\n *\n * Handing focus back to a trigger after its overlay closes is not the same\n * event as a user tabbing onto that trigger, but the DOM cannot tell them\n * apart: `.focus()` produces an ordinary focus event, and the modality is\n * still \"keyboard\" from whatever the user just did, so anything keyed off\n * focus-visible treats it as a deliberate arrival. A trigger's tooltip pops up\n * unasked — and then absorbs the user's next `Escape` from its own\n * document-level listener (CUB-4839).\n *\n * Two mechanisms, because restoration reaches us two ways:\n *\n * - `focusProgrammatically` for restores WE perform. `focus()` dispatches\n *   `focus`/`focusin` synchronously, so a flag set around the call is readable\n *   by every handler that runs for it and gone immediately afterwards. Exact,\n *   with no window to tune.\n *\n * - `markFocusRestoreWindow` for restores React Aria performs. A `FocusScope`\n *   restores on unmount, from inside React's own commit, and offers no hook to\n *   wrap — so an overlay that is closing declares the window instead. Coarser\n *   on purpose: it can only make a tooltip skip one arrival that lands while\n *   an overlay is going away, which is the case it exists for.\n */\nlet depth = 0;\nlet restoreWindowEndsAt = 0;\n\n/**\n * Focus `element` without the UI reading it as the user arriving there.\n */\nexport function focusProgrammatically(\n  element: HTMLElement | null | undefined,\n  options?: FocusOptions,\n) {\n  if (!element) return;\n\n  depth++;\n\n  try {\n    element.focus(options);\n  } finally {\n    depth--;\n  }\n}\n\n/**\n * Declare that focus is about to be restored by machinery we cannot wrap, for\n * roughly `duration` ms. Called by a closing overlay.\n */\nexport function markFocusRestoreWindow(duration: number) {\n  restoreWindowEndsAt = Math.max(restoreWindowEndsAt, Date.now() + duration);\n}\n\n/**\n * Whether the focus being handled right now is a restoration rather than the\n * user arriving. Only meaningful inside a focus handler.\n */\nexport function isFocusRestoration() {\n  return depth > 0 || Date.now() < restoreWindowEndsAt;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAI,QAAQ;AACZ,IAAI,sBAAsB;;;;AAK1B,SAAgB,sBACd,SACA,SACA;AACA,KAAI,CAAC,QAAS;AAEd;AAEA,KAAI;AACF,UAAQ,MAAM,QAAQ;WACd;AACR;;;;;;;AAQJ,SAAgB,uBAAuB,UAAkB;AACvD,uBAAsB,KAAK,IAAI,qBAAqB,KAAK,KAAK,GAAG,SAAS;;;;;;AAO5E,SAAgB,qBAAqB;AACnC,QAAO,QAAQ,KAAK,KAAK,KAAK,GAAG"}

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useEffect, useRef } from "react";
 
 //#region src/utils/react/useCombinedRefs.ts

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useIsDarwin.ts

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useCallback, useSyncExternalStore } from "react";
 

package/dist/utils/react/useMergeStyles.js

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

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -0,0 +1,41 @@
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+import { useEvent } from "../../_internal/hooks/use-event.js";
+
+//#region src/utils/react/useOverlayEscapeGuard.ts
+/**
+* Stops a CLOSED overlay from answering for `Escape` (CUB-4839).
+*
+* `useOverlay`'s `Escape` handler calls `stopPropagation()` and
+* `preventDefault()` for every `Escape` it sees, and only THEN asks whether
+* this overlay is the topmost one allowed to act on it — unlike
+* `onInteractOutside`, which it gates on `isOpen` up front. An overlay that has
+* already closed therefore consumes the key and does nothing with it, so the
+* `Escape` meant for the Dialog around it closes nothing at all.
+*
+* That is reachable here because our overlays stay mounted for their exit
+* transition while still holding DOM focus: pick an option from a list inside a
+* Dialog and the very next `Escape` lands in the closing list.
+*
+* Passing `useOverlay` an `isKeyboardDismissDisabled` of its own does NOT work,
+* and that is the reason this exists. `DisplayTransition` preserves content
+* across an exit by replaying the children it stored while the overlay was
+* open, so every value that subtree captured — `isKeyboardDismissDisabled`
+* included — stays frozen at its open-state reading for exactly the window
+* this has to guard. `useEvent` gets around it by returning a handler whose
+* identity never changes while its body always runs the latest render's
+* closure, so the frozen copy still sees the current `isOpen`.
+*/
+function useOverlayEscapeGuard(overlayProps, isOpen) {
+	const onKeyDown = useEvent((event) => {
+		if (event.key === "Escape" && !isOpen) return;
+		overlayProps.onKeyDown?.(event);
+	});
+	return {
+		...overlayProps,
+		onKeyDown
+	};
+}
+
+//#endregion
+export { useOverlayEscapeGuard };
+//# sourceMappingURL=useOverlayEscapeGuard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayEscapeGuard.js","names":[],"sources":["../../../src/utils/react/useOverlayEscapeGuard.ts"],"sourcesContent":["import { 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    overlayProps.onKeyDown?.(event);\n  });\n\n  return { ...overlayProps, onKeyDown };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,sBACd,cACA,QACG;CACH,MAAM,YAAY,UAAU,UAA8B;AAExD,MAAI,MAAM,QAAQ,YAAY,CAAC,OAAQ;AAEvC,eAAa,YAAY,MAAM;GAC/B;AAEF,QAAO;EAAE,GAAG;EAAc;EAAW"}

package/dist/utils/react/usePopoverSync.js

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

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | 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.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts