@cube-dev/ui-kit 0.188.0 → 0.189.0

package/docs/components/content/Result.md

@@ -1,11 +1,12 @@
 # Result
 
-An empty state or result display with icon, title, and optional content. Supports status presets with built-in icons.
+An empty state or result display with icon, title, and optional content. Supports status presets with built-in icons and an actions slot. The `large` size with the `stacked` layout is the vertical card used as the body of a confirmation or result dialog.
 
 ## When to Use
 
 - Empty states (no data, no results)
 - Success/error feedback after actions
+- Confirmation and result dialogs (payment complete, action failed)
 - 404, 403, 500 error pages
 - Informational messages
 
@@ -19,9 +20,35 @@ An empty state or result display with icon, title, and optional content. Support
 - **`title`** `ReactNode` — Main title text
 - **`subtitle`** `ReactNode` — Secondary text below the title
 - **`subTitle`** `ReactNode` — Deprecated: use `subtitle` instead
-- **`icon`** `ReactNode` — Custom icon (overrides status icon)
-- **`isCompact`** `boolean` (default: `false`) — Compact horizontal layout
-- **`children`** `ReactNode` — Additional block content, e.g. a set of action buttons
+- **`icon`** `ReactNode` — Custom icon that replaces the status icon
+- **`size`** `'medium' | 'large'` (default: `'medium'`) — Visual scale: the icon size and the title and subtitle presets. Does not change the layout. Ignored when `isCompact` is set
+- **`layout`** `'default' | 'stacked'` (default: `'default'`) — Arrangement of the block. `stacked` fills the container and stacks the actions to the full width, as in a confirmation or result dialog. Ignored when `isCompact` is set
+- **`isCompact`** `boolean` (default: `false`) — Compact horizontal layout. Overrides `size` and `layout`
+- **`actions`** `ReactNode` — Action buttons as `Result.Action` elements: a centered row by default, a full-width column in the `stacked` layout
+- **`children`** `ReactNode` — Free content between the text and the actions
+
+The elements render in this order: icon, title, subtitle, children, actions.
+
+### Result.Action
+
+A `Button` for the `actions` slot. It takes every `Button` prop, and its `size` follows the Result's `size` unless you set one: `medium` buttons in a medium Result, `large` in a large one, `medium` when `isCompact`. A `type="link"` action keeps the `inline` size of a link `Button`. Set `type` on each action as on any `Button`.
+
+### Base Properties
+
+Supports [Base properties](../../BaseProperties.md).
+
+### Styling Properties
+
+#### styles
+
+Customizes the root element of the component.
+
+**Sub-elements:**
+
+- `Icon` - The status icon wrapper. Colored by the `status` modifier, padded on every side by `3x`, or a quarter of `--icon-size` when that is larger (an icon above `12x`), so the room never drops below the spacing between the other blocks, and that room is the whole distance to the title (no padding when `isCompact`). Wraps a custom `icon` too, with the same room and without a status color. Not rendered for a status without an icon (`404`, `403`, `500`)
+- `Title` - The text block holding the title and the subtitle
+- `Content` - The free `children` block
+- `Actions` - The `actions` block
 
 ### Style Defaults
 
@@ -29,15 +56,13 @@ An empty state or result display with icon, title, and optional content. Support
 - `flow` — `column`
 - `placeContent` — `center` (switches to `start` when `isCompact`)
 - `placeItems` — `center` (switches to `start` when `isCompact`)
-- `gap` — `3x` (switches to `2x 1x` when `isCompact`)
-- `padding` — `6x 4x` (switches to `0` when `isCompact`)
+- `gap` — `0`; `Content` and `Actions` keep `3x` from the block above with a top margin (`2x 1x` and no margins when `isCompact`)
+- `padding` — `6x 4x` (`0` when `isCompact`; `1.5x` when `layout="stacked"`, and `0` for a stacked Result inside a `Dialog`, whose `Content` already pads it. The `@in-dialog` state is the Result's own, so `styles={{ padding: { 'layout=stacked & @in-dialog': '1x' } }}` sets it and keeps the rest of the default padding)
 - `textAlign` — `center` (switches to `left` when `isCompact`)
-- `width` — `max 80ch` (caps the readable line length; override via the `width` prop)
+- `boxSizing` — `border-box`
+- `width` — `max 80ch` (caps the readable line length; override via the `width` prop). `100%` up to `80ch` when `layout="stacked"`, so the stacked actions share one width wherever the card sits
 - `margin` — `0 auto` (centers Result horizontally within its parent; switches to `0` when `isCompact`)
-
-### Base Properties
-
-Supports [Base properties](../../BaseProperties.md).
+- `--icon-size` — `6x` (`10x` when `size="large"`)
 
 ### Style Properties
 
@@ -50,8 +75,51 @@ These properties allow direct style application without using the `styles` prop:
 - **Color:** `color`, `fill`, `fade`, `image`
 - **Flow:** `flow`, `place`, `placeItems`, `placeContent`, `alignItems`, `alignContent`, `justifyItems`, `justifyContent`, `align`, `justify`, `gap`, `columnGap`, `rowGap`, `gridColumns`, `gridRows`, `gridTemplate`, `gridAreas`
 
+### Modifiers
+
+The root element exposes these modifiers as `data-*` attributes:
+
+| Modifier | Type | Description |
+| --- | --- | --- |
+| `compact` | `boolean` | Set by `isCompact`: horizontal icon + title layout |
+| `size` | `'medium' \| 'large'` | Set by `size`; `medium` when `isCompact` |
+| `layout` | `'default' \| 'stacked'` | Set by `layout`; `default` when `isCompact` |
+| `status` | `CubeResultStatus` | Set by `status`, `info` by default; drives the icon color. Not set when a custom `icon` is passed |
+
+## Variants
+
+### Sizes
+
+The size scales the content and never changes the arrangement. `isCompact` has its own scale and ignores it.
+
+- `medium` - Default. Icon `6x`, title `h4`, subtitle `t2m`
+- `large` - Icon `10x`, title `h2`, subtitle `t2`, `Result.Action` buttons `large`
+
+### Layouts
+
+The layout arranges the block and never changes the scale. `isCompact` has its own arrangement and ignores it.
+
+- `default` - A centered column capped at `80ch`, actions in a centered row that wraps
+- `stacked` - Fills the container up to `80ch` with a `1.5x` padding of its own (none inside a `Dialog`), actions stacked to the full width, free `children` stretched. Combine with `size="large"` for the vertical card of a confirmation or result dialog
+
 ## Examples
 
+### Basic Usage
+
+```jsx
+<Result
+  status="success"
+  title="Successfully Purchased Cloud Server ECS!"
+  subtitle="Cloud server configuration takes 1-5 minutes, please wait."
+  actions={
+    <>
+      <Result.Action type="primary">Go Console</Result.Action>
+      <Result.Action>Buy Again</Result.Action>
+    </>
+  }
+/>
+```
+
 ### Info
 
 ### Warning
@@ -60,14 +128,136 @@ These properties allow direct style application without using the `styles` prop:
 
 ### Custom Icon
 
+```jsx
+<Result
+  title="Access is denied!"
+  subtitle="Request access from the administrator."
+  icon={
+    <Icon color="#warning">
+      <IconLock />
+    </Icon>
+  }
+  actions={<Result.Action>Request</Result.Action>}
+/>
+```
+
 ### Custom Title
 
 ### Compact
 
+### Large
+
+The `large` size scales the icon and the text. The actions stay in a centered row.
+
+```jsx
+<Result
+  size="large"
+  status="success"
+  title="Payment complete"
+  subtitle="Charged $1,234.00 to Visa **** 4242"
+  actions={
+    <>
+      <Result.Action type="primary">
+        Done
+      </Result.Action>
+      <Result.Action>
+        View invoice
+      </Result.Action>
+    </>
+  }
+/>
+```
+
+### Stacked
+
+The `stacked` layout fills the container and stacks the actions to the full width. With `size="large"` it is the vertical card for confirmation and result dialogs.
+
+```jsx
+<Result
+  size="large"
+  layout="stacked"
+  status="success"
+  title="Payment complete"
+  subtitle="Charged $1,234.00 to Visa **** 4242"
+  actions={
+    <Result.Action type="primary">
+      Done
+    </Result.Action>
+  }
+/>
+```
+
+Free `children` (an alert, details) stretch to the full width in this layout.
+
+### In a Dialog
+
+Inside a `Dialog` the stacked large Result is the whole body: no `Header` and no `Footer`. Its title takes the dialog `title` slot, so the dialog is labelled by it automatically.
+
+```jsx
+<DialogContainer isOpen={isOpen} onDismiss={close}>
+  <Dialog size="S">
+    <Content>
+      <Result
+        size="large"
+        layout="stacked"
+        status="success"
+        title="Payment complete"
+        subtitle="Charged $1,234.00 to Visa **** 4242"
+        actions={
+          <Result.Action type="primary" onPress={close}>
+            Done
+          </Result.Action>
+        }
+      />
+    </Content>
+  </Dialog>
+</DialogContainer>
+```
+
 ### Width Limit
 
 The default `width: max 80ch` keeps long copy in a comfortable reading column even inside a much wider parent. Override the cap by passing your own `width`.
 
+## Accessibility
+
+### Keyboard Navigation
+
+- The component itself is not focusable; the `Result.Action` buttons keep the keyboard behavior of `Button`
+
+### Screen Reader Support
+
+- The title renders as an `h2` heading and the subtitle as an `h3`, so the result is reachable through heading navigation
+- Inside a `Dialog` without a `Header`, the title takes the dialog's `title` slot and becomes its accessible name
+
+## Best Practices
+
+1. **Do**: Put `Result.Action` buttons in `actions` and keep `children` for content
+
+   ```jsx
+   <Result title="Payment failed" actions={<Result.Action>Update card</Result.Action>}>
+     <Alert>Nothing was charged.</Alert>
+   </Result>
+   ```
+
+2. **Don't**: Combine a Result with a dialog `Header`. Both titles would take the dialog `title` slot and share one id
+
+   ```jsx
+   <Dialog>
+     <Header>
+       <Title>Payment</Title>
+     </Header>
+     <Content>
+       <Result size="large" layout="stacked" title="Payment complete" />
+     </Content>
+   </Dialog>
+   ```
+
+## Related Components
+
+- [Dialog](../overlays/Dialog.md) - Host for the stacked large Result card
+- [AlertDialog](../overlays/AlertDialog.md) - Confirmation with a header and footer instead of a result card
+- [Alert](./Alert.md) - Inline status message for the `children` slot
+
 ## Differences from Ant Design
 
 | There are differences | Ant Design property | Cube UIKit property |
@@ -76,4 +266,4 @@ The default `width: max 80ch` keeps long copy in a comfortable reading column ev
 |          No           |       `title`       |       `title`       |
 |          Yes          |     `subTitle`      |     `subtitle`      |
 |          No           |       `icon`        |       `icon`        |
-|          Yes          |       `extra`       |     `children`      |
+|          Yes          |       `extra`       |      `actions`      |

package/docs/components/content/Title.md

@@ -11,6 +11,7 @@ A heading component for section titles. Renders as `h1`–`h6` based on the `lev
 ## Properties
 
 - **`level`** `1 | 2 | 3 | 4 | 5 | 6` (default: `1`) — Heading level (maps to `h1`–`h6` tag and corresponding preset `h1`–`h6`)
+- **`slot`** `string` (default: `'title'`) — The slot to read provided props from, e.g. the `title` slot a `Dialog` labels itself with. Pass another name to opt out
 - **`ellipsis`** `boolean` — Truncate overflow with ellipsis
 - **`nowrap`** `boolean` — Prevent text wrapping
 - **`monospace`** `boolean` — Use monospace font

package/docs/components/overlays/AlertDialog.md

@@ -65,3 +65,100 @@ These properties allow direct style application without using the `styles` prop:
   content="A new version is available. Please refresh to update."
 />
 ```
+
+## Imperative API
+
+`useAlertDialogAPI()` opens an alert dialog from code, such as an event handler, with no `DialogTrigger` to render. It works anywhere under `<Root>`.
+
+- **`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:
+
+- **`type`** — The dialog container type, as on `DialogContainer`
+- **`isDismissable`** `boolean` (default: `true`) — Whether Escape and a click outside close the dialog
+- **`onDismiss`** `(action?: string) => void` — Called when an action button, Escape or a click outside closes the dialog. An action button passes its name: `'confirm'`, `'secondary'` or `'cancel'`
+- **`content`** can also be a function `({ resolve, reject }) => ReactNode`, for content that closes the dialog itself
+
+`params` takes:
+
+- **`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 | 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` |
+
+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 { open } = useAlertDialogAPI();
+
+const onDelete = async () => {
+  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>;
+```
+
+Keep the action itself outside the `try`, so its own errors are not mistaken for a dialog result.
+
+### Closing the dialog from code
+
+```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;
+  });
+};
+
+// Later, for example when the approval arrives:
+controllerRef.current?.abort();
+```
+
+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/docs/tasty/dsl.md

@@ -538,13 +538,16 @@ Container style queries use `$prop` (boolean) or `$prop=value` syntax, which map
 
 ### `@supports(...)` — Feature Queries
 
-Feature queries test CSS property support. Use `$` as the first argument to test selector support:
+Feature queries test CSS property support and accept CSS support functions such
+as `at-rule()`. Use `$` as the first argument to test selector support:
 
-| Tasty syntax                | CSS output                        |
-| --------------------------- | --------------------------------- |
-| `@supports(display: grid)`  | `@supports (display: grid)`       |
-| `@supports($, :has(*))`     | `@supports selector(:has(*))`     |
-| `!@supports(display: grid)` | `@supports (not (display: grid))` |
+| Tasty syntax                 | CSS output                         |
+| ---------------------------- | ---------------------------------- |
+| `@supports(display: grid)`   | `@supports (display: grid)`        |
+| `@supports($, :has(*))`       | `@supports selector(:has(*))`      |
+| `@supports(at-rule(@scope))`  | `@supports (at-rule(@scope))`      |
+| `!@supports(display: grid)`  | `@supports (not (display: grid))`  |
+| `!@supports(at-rule(@scope))` | `@supports (not (at-rule(@scope)))` |
 
 ```jsx
 display: {
@@ -553,6 +556,25 @@ display: {
 }
 ```
 
+`at-rule()` tests whether the browser supports the named at-rule. Its surrounding
+parentheses in Tasty's CSS output are valid CSS. Negation and combinations with
+other states use the same syntax as property queries:
+
+```jsx
+color: {
+  _: 'red',
+  '@supports(at-rule(@scope)) & @supports(display: grid)': 'blue',
+}
+```
+
+Use `_` to keep a base value when a browser cannot evaluate a query. A support
+query only detects a browser feature; it does not add an API for authoring the
+queried at-rule in a Tasty style object. For conditional stylesheet imports such
+as `@import url("scoped.css") supports(at-rule(@scope));`, use an ordinary CSS
+stylesheet or document-level `useRawCSS()`. Put imports before other rules in
+that stylesheet. Imports cannot be used in constructable stylesheets, including
+Tasty's adopted-sheet mode for Shadow DOM.
+
 ### `_` — Fallback Floor
 
 By default Tasty makes states **mutually exclusive**: a higher-priority state

package/docs/tasty/styles.md

@@ -37,6 +37,24 @@ Use these instead of their raw CSS counterparts:
 
 ## Layout
 
+### `overscrollBehavior`
+
+The native `overscrollBehavior` shorthand and its `overscrollBehaviorBlock`,
+`overscrollBehaviorInline`, `overscrollBehaviorX`, and `overscrollBehaviorY`
+longhands support `auto`, `contain`, `none`, and `chain`. The shorthand can set
+separate X and Y values, for example `overscrollBehavior: 'chain contain'`.
+
+`chain` allows scroll chaining to another scrollable area while suppressing
+boundary effects such as bounce. It requires browser support; use a feature
+query and a fallback floor when targeting browsers without it:
+
+```jsx
+overscrollBehaviorBlock: {
+  _: 'auto',
+  '@supports(overscroll-behavior-block: chain)': 'chain',
+}
+```
+
 ### `display`
 
 Standard CSS display values. Handled together with `hide`, `textOverflow`, `overflow`, and `whiteSpace` for priority resolution.
@@ -566,6 +584,8 @@ When easing is provided without a duration, the default timing variable is used
 | `zIndex` | `z-index` |
 | `inset` | `inset`, `top`, `right`, `bottom`, `left` |
 
+When two entries cover the same property, an entry that names that one property wins over a group such as `theme`, in either order: `opacity 120ms ease-in-out, theme` keeps the opacity timing. Otherwise the later entry wins, as in CSS.
+
 Default timing: `$transition` (or `${name}-transition` with `$transition` fallback per semantic name). Prefer omitting the duration or using a duration token instead of repeating raw time values across components. Explicit zero can disable motion.
 
 ```jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.188.0",
+  "version": "0.189.0",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -59,7 +59,7 @@
     "@tabler/icons-react": "^3.31.0",
     "@tanstack/react-virtual": "^3.13.12",
     "@tenphi/glaze": "2.0.0",
-    "@tenphi/tasty": "^3.9.3",
+    "@tenphi/tasty": "^3.9.6",
     "clipboard-copy": "^4.0.1",
     "clsx": "^1.1.1",
     "diff": "^8.0.3",
@@ -98,7 +98,7 @@
     "@statoscope/cli": "^5.20.1",
     "@storybook/addon-docs": "^10.3.6",
     "@storybook/react-vite": "^10.3.6",
-    "@tenphi/eslint-plugin-tasty": "^1.3.0",
+    "@tenphi/eslint-plugin-tasty": "^1.5.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.7.0",
     "@testing-library/react": "^16.3.0",