@cube-dev/ui-kit 0.0.0-canary-6df2b58 → 0.0.0-canary-afff9bd

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/tasty/dsl.md

@@ -538,16 +538,13 @@ Container style queries use `$prop` (boolean) or `$prop=value` syntax, which map
 
 ### `@supports(...)` — Feature Queries
 
-Feature queries test CSS property support and accept CSS support functions such
-as `at-rule()`. Use `$` as the first argument to test selector support:
+Feature queries test CSS property support. 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(at-rule(@scope))`  | `@supports (at-rule(@scope))`      |
-| `!@supports(display: grid)`  | `@supports (not (display: grid))`  |
-| `!@supports(at-rule(@scope))` | `@supports (not (at-rule(@scope)))` |
+| Tasty syntax                | CSS output                        |
+| --------------------------- | --------------------------------- |
+| `@supports(display: grid)`  | `@supports (display: grid)`       |
+| `@supports($, :has(*))`     | `@supports selector(:has(*))`     |
+| `!@supports(display: grid)` | `@supports (not (display: grid))` |
 
 ```jsx
 display: {
@@ -556,25 +553,6 @@ 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,24 +37,6 @@ 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.

package/package.json

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