@cube-dev/ui-kit 0.0.0-canary-dcac044 → 0.0.0-canary-dc34c88

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { c } from "react-compiler-runtime";
 import { useSyncExternalStore } from "react";

package/dist/tokens/palette.js

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useRef, useState } from "react";
 import { useFocus } from "react-aria";

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | 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.0.0-canary-dcac044 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-dc34c88 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-dcac044";
+const VERSION = "0.0.0-canary-dc34c88";
 const TASTY_VERSION = "3.9.6";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/overlays/AlertDialog.md

@@ -68,10 +68,9 @@ These properties allow direct style application without using the `styles` prop:
 
 ## Imperative API
 
-`useAlertDialogAPI()` opens an alert dialog from an event handler or an effect, with no `DialogTrigger` to render. It works anywhere under `<Root>`, and only one alert dialog can be open at a time.
+`useAlertDialogAPI()` opens an alert dialog from code, such as an event handler, with no `DialogTrigger` to render. It works anywhere under `<Root>`.
 
-- **`confirm(props, params?)`** `Promise<'confirm' | 'secondary' | 'cancel'>` — Resolves with the action the user picked, or `'cancel'` when the dialog closes without one. Prefer it: there is no rejection to forget to catch.
-- **`open(props, params?)`** `Promise<'confirm' | 'secondary'>` — The same, but a dialog closed without an action rejects with `undefined`. A caller with no `.catch` leaves an unhandled rejection.
+- **`open(props, params?)`** `Promise<'confirm' | 'secondary'>` — Opens the dialog. Resolves with the action the user picked, and rejects when the dialog closes without one or cannot open.
 
 `props` takes the properties above, plus:
 
@@ -84,58 +83,82 @@ These properties allow direct style application without using the `styles` prop:
 
 - **`cancelToken`** `AbortSignal` — Closes the dialog when aborted
 
+The confirm button resolves `'confirm'` whether you configure `actions.confirm` or leave the default Ok button. Set it to `false` to hide it.
+
 ### How the promise settles
 
-| Event | `confirm` | `open` |
-| --- | --- | --- |
-| Confirm or secondary action | resolves `'confirm'` / `'secondary'` | resolves `'confirm'` / `'secondary'` |
-| Cancel action | resolves `'cancel'` | rejects with `undefined` |
-| Escape or a click outside | resolves `'cancel'` | rejects with `undefined` |
-| `cancelToken` aborted, before or while the dialog is open | resolves `'cancel'` | rejects with `undefined` |
-| `content` calls `reject()` | resolves `'cancel'` | rejects with `undefined` |
-| `content` calls `reject(reason)` | rejects with `reason` | rejects with `reason` |
-| Another alert dialog is already open | rejects with an `Error` | rejects with an `Error` |
+| Event | Promise |
+| --- | --- |
+| Confirm or secondary action | resolves `'confirm'` / `'secondary'` |
+| Cancel action | rejects with `undefined` |
+| Escape or a click outside | rejects with `undefined` |
+| `cancelToken` aborted, before or while the dialog is open | rejects with `undefined` |
+| `content` calls `resolve(status)` | resolves `status` |
+| `content` calls `reject(reason)` | rejects with `reason` (`undefined` for `reject()`) |
+| Another alert dialog is open | rejects with an `Error` |
 
-`'cancel'` is truthy, so compare the status rather than testing it: `if (status === 'confirm')`, not `if (status)`. Otherwise Cancel runs the action.
+A rejection with `undefined` is a cancel: the user chose not to act, so return quietly. Anything else is a real failure; rethrow it or report it. A caller with no rejection handler leaves an unhandled rejection on every cancel.
 
 ### Confirming an action
 
 ```jsx
-const { confirm } = useAlertDialogAPI();
+const { open } = useAlertDialogAPI();
 
 const onDelete = async () => {
-  const status = await confirm({
-    title: 'Delete the item?',
-    content: 'This cannot be undone.',
-    danger: true,
-    actions: { confirm: { children: 'Delete' }, cancel: true },
-  });
-
-  if (status !== 'confirm') return;
-
-  await deleteItem();
+  let status;
+
+  try {
+    status = await open({
+      title: 'Delete the item?',
+      content: 'This cannot be undone.',
+      danger: true,
+      actions: { confirm: { children: 'Delete' }, cancel: true },
+    });
+  } catch (reason) {
+    // Cancel, Escape or a click outside
+    if (reason === undefined) return;
+
+    // A real failure, such as another dialog being open
+    throw reason;
+  }
+
+  if (status === 'confirm') await deleteItem();
 };
 
 <Button onPress={onDelete}>Delete</Button>;
 ```
 
-### Closing the dialog from an effect
-
-```jsx
-const { confirm } = useAlertDialogAPI();
+Keep the action itself outside the `try`, so its own errors are not mistaken for a dialog result.
 
-useEffect(() => {
-  const controller = new AbortController();
+### Closing the dialog from code
 
-  confirm(
-    { title: 'Session expired', content: 'Sign in again to continue.' },
-    { cancelToken: controller.signal },
-  ).then((status) => {
-    if (status === 'confirm') signIn();
+```jsx
+const { open } = useAlertDialogAPI();
+const controllerRef = useRef(null);
+
+const onRequestApproval = () => {
+  // A signal stays aborted, so each dialog needs a fresh controller.
+  controllerRef.current = new AbortController();
+
+  open(
+    {
+      title: 'Waiting for approval',
+      content: 'The dialog closes when the approval arrives.',
+      actions: { confirm: { children: 'Hide' } },
+    },
+    { cancelToken: controllerRef.current.signal },
+  ).catch((reason) => {
+    // Aborting rejects with `undefined`, like Cancel does
+    if (reason !== undefined) throw reason;
   });
+};
 
-  return () => controller.abort();
-}, []);
+// Later, for example when the approval arrives:
+controllerRef.current?.abort();
 ```
 
-Create an `AbortController` for each dialog. A signal stays aborted, so reusing one settles every later dialog as a cancel without showing it.
+Passing a signal that is already aborted rejects with `undefined` right away, without showing the dialog.
+
+### One dialog at a time
+
+Only one alert dialog can be open: while one is, `open` rejects with an `Error`. A dialog that is already closing gives way to the new one, so a follow-up dialog opened from the previous one's result, such as a second confirmation, shows normally.

package/package.json

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