@vokality/design-system 6.0.2 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +13 -4
  3. package/dist/appearance.d.ts +2 -2
  4. package/dist/components/Menu/Menu.js +1 -1
  5. package/dist/components.css +474 -359
  6. package/dist/tailwind.css +3 -0
  7. package/dist/tokens.css +20 -3
  8. package/dist/tokens.dtcg.json +98 -13
  9. package/dist/tokens.json +99 -14
  10. package/dist/vokality.css +494 -362
  11. package/dist/vokality.iife.js +1 -0
  12. package/docs/brand.md +3 -3
  13. package/docs/components/Button/README.md +16 -15
  14. package/docs/components/Checkbox/README.md +1 -1
  15. package/docs/components/Combobox/README.md +1 -1
  16. package/docs/components/DatePicker/README.md +1 -1
  17. package/docs/components/IconButton/README.md +2 -2
  18. package/docs/components/Input/README.md +3 -3
  19. package/docs/components/Link/README.md +1 -1
  20. package/docs/components/Menu/README.md +1 -1
  21. package/docs/components/MultiSelect/README.md +1 -1
  22. package/docs/components/NumberInput/README.md +1 -1
  23. package/docs/components/OtpInput/README.md +1 -1
  24. package/docs/components/PasswordInput/README.md +1 -1
  25. package/docs/components/Popover/README.md +1 -1
  26. package/docs/components/Radio/README.md +1 -1
  27. package/docs/components/RadioGroup/README.md +1 -1
  28. package/docs/components/SearchInput/README.md +1 -1
  29. package/docs/components/SegmentedControl/README.md +2 -2
  30. package/docs/components/Select/README.md +2 -2
  31. package/docs/components/Switch/README.md +1 -1
  32. package/docs/components/Tag/README.md +1 -1
  33. package/docs/components/Textarea/README.md +2 -2
  34. package/docs/components/TimePicker/README.md +1 -1
  35. package/package.json +1 -1
  36. package/skills/vokality-design-system/SKILL.md +1 -1
@@ -17061,6 +17061,7 @@ Defaulting to \`null\`.`;
17061
17061
  collisionPadding: 8,
17062
17062
  ...contentProps,
17063
17063
  className: "vk-menu",
17064
+ "data-vk-size": size,
17064
17065
  side,
17065
17066
  align,
17066
17067
  children: /* @__PURE__ */ jsx_dev_runtime40.jsxDEV(MenuEntries, {
package/docs/brand.md CHANGED
@@ -23,7 +23,7 @@ Build screens from **primitives** first. **Patterns** are primitives already com
23
23
 
24
24
  | Layer | Group | Components |
25
25
  | --- | --- | --- |
26
- | Primitives | Actions | `Button` (semantic `color`, visual `variant`, `xs`/`sm`/`md`; `loading`, `block`), `IconButton`, `Link`, `Menu` (submenus, checkbox and radio items), `ContextMenu` |
26
+ | Primitives | Actions | `Button` (semantic `color`, visual `variant`, `xs`/`sm`/`md`/`lg`; `loading`, `block`), `IconButton`, `Link`, `Menu` (submenus, checkbox and radio items), `ContextMenu` |
27
27
  | Primitives | Form controls | `Field` (label, hint, error), `Input` (prefix, suffix, character count), `Textarea`, `RichTextEditor` (Markdown, emoji, attachment uploads), `PasswordInput`, `NumberInput`, `Slider`, `OtpInput`, `SearchInput`, `Select`, `Combobox`, `MultiSelect`, `DatePicker` (typed or picked), `Calendar`, `TimePicker`, `Checkbox`, `Radio`, `RadioGroup`, `Switch`, `SegmentedControl`, `FileUpload`, `ErrorSummary` |
28
28
  | Primitives | Feedback | `Alert`, `Toaster` + `toast()`, `Progress`, `Spinner`, `Skeleton`, `EmptyState` |
29
29
  | Primitives | Overlays | `Dialog` (and alert dialog), `Drawer`, `Popover`, `Tooltip`, `CommandPalette` (⌘K) |
@@ -36,7 +36,7 @@ Build screens from **primitives** first. **Patterns** are primitives already com
36
36
  | Patterns | Content | `SectionHeader`, `Card`, `MediaCard`, `Quote`, `FaqList`, `TileGrid` |
37
37
  | Templates | Pages | Sign in, Settings, List and detail, Form, Dashboard, Error |
38
38
 
39
- Every form control shares one box: `card` fill, 1px `input-border` edge, square corners, 44px tall (`--control-height`). Focus adds a `primary` edge and the 2px `ring`; an invalid control gets a `primary` edge and its message; a disabled one turns transparent with a dashed edge and `muted-subtle` text. Checkboxes, radios and switches are square too, edged in `muted-subtle`, and fill `primary` when on.
39
+ Every form control and action shares one box scale: `card` fill on fields, 1px `input-border` edge, square corners, and `--control-height` (36px `md` by default on fine pointers, 32px `sm` in compact density, 24px `xs` in toolbars, 44px `lg` for spacious layouts and as the universal coarse-pointer floor). Focus adds a `primary` edge and the 2px `ring`; an invalid control gets a `primary` edge and its message; a disabled one turns transparent with a dashed edge and `muted-subtle` text. Checkboxes, radios and switches are square too, edged in `muted-subtle`, and fill `primary` when on.
40
40
 
41
41
  Nothing renders as a native browser widget. The interactive components are built on Radix Primitives, which supply the WAI-ARIA keyboard, focus and screen-reader behaviour; `Select`, `Combobox`, `MultiSelect`, `DatePicker` and `TimePicker` draw their own panels, so every control looks and behaves the same in every browser. Exchange dates as `YYYY-MM-DD` strings and times as `HH:mm`.
42
42
 
@@ -98,7 +98,7 @@ The test suite checks these pairs in every theme and fails the build if one slip
98
98
 
99
99
  ## Space and layout
100
100
 
101
- - Dense operational apps opt in with `density="compact"` on `ThemeProvider`. The shared compact scale is 20px page titles, 16px section titles, 14px body and fine-pointer controls (16px input text with a coarse pointer, which stops iOS focus zoom), 24px statistics; smaller text (metadata, captions) keeps its size. Table cells, list and navigation rows, menus and cards tighten too. Headers add no trailing section margin; compose vertical rhythm with `Stack`. Actions align with the page title. Controls share a 32px height for fine pointers and retain 44px when a coarse pointer is available. Actions, fields and choices can choose `size="xs"`, `"sm"` or `"md"` independently of the application density; fine-pointer single-line heights are 24px, 32px and 44px. The default scale is unchanged.
101
+ - **Control scale, density and font-size pairing:** Actions, fields and choices share a single 4-step fine-pointer scale: `xs` (24px), `sm` (32px), `md` (36px) and `lg` (44px). Sentence-case control text scales `12px / 13px / 14px / 16px` (`--text-xs`, `--text-compact`, `--text-sm`, `--text-base`), uppercase tracked action labels sit two steps lower (`10px / 11px / 12px / 13px`), and secondary descriptions inside controls sit one step lower (`11px / 12px / 13px / 14px`). Default density resolves omitted sizes to `md` (36px); `density="compact"` on `ThemeProvider` shifts everything one step down so controls resolve to `sm` (32px, identical to explicit `size="sm"`), typography shifts down one step (20px page titles, 16px section titles, 14px body/prose, 13px UI rows, 12px secondary descriptions, 11px field labels, 24px stats; never enlarging smaller text), and surface/cell/gap tokens tighten cards, dialogs, fieldsets, alerts, tables, lists, tabs, navigation and menus together. Headers add no trailing section margin; compose vertical rhythm with `Stack`, and actions align with the page title. Coarse pointers retain 44px targets and 16px field text (preventing iOS focus zoom) in every size and density.
102
102
 
103
103
  - Apps: wrap the screen in `AppShell` (56px top bar, 15rem sidebar that collapses to icons and becomes an overlay below 48rem), put a `PageHeader` at the top of each page, and lay out content with `Stack`, `Inline` and `Grid`. Start new pages from the templates.
104
104
  - Sites and documents: set content in one frame, max-width 80rem (`--content-max`), outlined left, right and bottom by `border-subtle`, over a faint 10px dot grid (`.vk-dot-grid`) on marketing pages.
@@ -3,9 +3,9 @@
3
3
  The button for actions and record names, with square corners and a visible keyboard focus ring.
4
4
 
5
5
  ## Anatomy
6
- 1. **Container**: square (`radius`), 1px border, 40px minimum height (32px at `sm`).
7
- 2. **Label**: IBM Plex Sans, `button` style (12px, 0.14em tracking, uppercase); 11px at `sm`.
8
- 3. **Glyph cell** (optional, `arrow`): a 2.25rem cell on the right holding `arrow-up-right`, for links that leave the product.
6
+ 1. **Container**: square (`radius`), 1px border, height from `--control-height` (`md` 36px in default density, `sm` 32px in compact density, `xs` 24px, `lg` 44px on fine pointers; 44px on coarse pointers).
7
+ 2. **Label**: IBM Plex Sans uppercase tracked label (`--control-label-font-size`), paired two steps below sentence-case control text (`10px` at `xs`, `11px` at `sm`, `12px` at `md`, `13px` at `lg`). `variant="text"` uses sentence-case `--control-font-size` (`12px` / `13px` / `14px` / `16px`).
8
+ 3. **Glyph cell** (optional, `arrow`): a square cell matching `--control-height` on the right holding `arrow-up-right`, for links that leave the product.
9
9
 
10
10
  ## Variants
11
11
  | Variant | Use | Fill | Border | Label |
@@ -19,14 +19,15 @@ The button for actions and record names, with square corners and a visible keybo
19
19
  Color is independent of treatment: `color="primary"` (default), `neutral`, `info`, `success`, `warning`, or `danger`. For example, `<Button color="danger" variant="outline">Delete invoice</Button>`. Color uses the active theme's semantic tokens.
20
20
 
21
21
  ## Sizes
22
- | Size | Min height | Label | Padding |
23
- | --- | --- | --- | --- |
24
- | omitted | Follows density (40px normally) | 12px | 0.65rem 1.25rem |
25
- | `md` | 44px | 12px | 0.65rem 1.25rem |
26
- | `sm` | 32px | 11px | 0.4rem 0.85rem |
27
- | `xs` | 24px (44px with a coarse pointer) | 11px; 12px for `text` | 0 `space-sm` |
22
+ | Size | Fine-pointer height | Action label (UPPERCASE) | `variant="text"` label | Inline padding |
23
+ | --- | --- | --- | --- | --- |
24
+ | omitted | Follows density (`md` 36px default, `sm` 32px compact) | 12px default, 11px compact | 14px default, 13px compact | 16px default, 12px compact |
25
+ | `lg` | 44px | 13px (`--text-compact`, 0.14em) | 16px (`--text-base`) | 20px (`1.25rem`) |
26
+ | `md` | 36px | 12px (`--text-xs`, 0.14em) | 14px (`--text-sm`) | 16px (`1rem`) |
27
+ | `sm` | 32px | 11px (`--text-2xs`, 0.12em) | 13px (`--text-compact`) | 12px (`0.75rem`) |
28
+ | `xs` | 24px (44px with a coarse pointer) | 10px (`--text-3xs`, 0.10em) | 12px (`--text-xs`) | 8px (`--space-sm`) |
28
29
 
29
- Use `xs` in toolbars, record rows and status lines where a 32px control crowds the content. `IconButton`, `Menu`, `Popover` and `SegmentedControl` use the same `xs`, `sm`, and `md` control sizes. Explicit sizes take precedence over density; coarse pointers keep a 44px target.
30
+ Use `xs` in toolbars, record rows and status lines where a 32px control crowds the content, and `lg` for spacious pages or hero forms. `IconButton`, `Menu`, `Popover`, `SegmentedControl`, form fields and choices all share the exact same `xs`, `sm`, `md` and `lg` scale. Explicit sizes take precedence over density; coarse pointers keep a 44px target.
30
31
 
31
32
  ## States
32
33
  | State | Primary | Outline | Ghost |
@@ -42,7 +43,7 @@ Every disabled variant drops its color fill instead of fading it, so an unavaila
42
43
  ## Props
43
44
  - `children`: the label in sentence case, starting with a verb.
44
45
  - `variant`: `solid` (default), `soft`, `outline`, `ghost`, or `text`. `color` chooses the semantic palette independently.
45
- - `size`: `xs`, `sm`, or `md`. Omit to follow density.
46
+ - `size`: `xs`, `sm`, `md`, or `lg`. Omit to follow density (`md` default, `sm` compact).
46
47
  - Native button attributes and an `HTMLButtonElement` ref pass through. Pass `type="submit"` in forms. Navigation uses `Link`, which accepts the same appearance props.
47
48
  - `arrow` adds a trailing arrow glyph cell.
48
49
  - `loading` disables the button, sets `aria-busy` and shows a spinner before the label; `loadingLabel` replaces the label while it runs ("Saving…"). Use it instead of building the spinner yourself.
@@ -50,8 +51,8 @@ Every disabled variant drops its color fill instead of fading it, so an unavaila
50
51
 
51
52
  ## Rules
52
53
  - One main `variant="solid" color="primary"` action per view. Put it first in a row and last in a dialog footer.
53
- - Under 40rem, buttons stretch to the column width; `text` stays content-sized. Text buttons support multiline labels and keep a 32px minimum target.
54
- - With `data-density="compact"` on `html`, record names use 14px and action labels keep their size (12px, 11px at `sm`). Unspecified control sizes follow compact density; an explicit `size` keeps its chosen height. Coarse pointers keep a 44px target.
55
- - Beside a field in an `Inline` row, a button without an explicit size takes the field height (44px by default, 32px compact with a fine pointer).
56
- - With a coarse pointer, every button and icon button is 44px in any density (`--button-height` and `--button-height-sm` follow `--control-height`).
54
+ - Under 40rem, buttons stretch to the column width; `text` stays content-sized. Text buttons support multiline labels and keep `--control-height` minimum target.
55
+ - With `density="compact"`, controls without an explicit `size` shift one step down from `md` (36px) to `sm` (32px, 11px uppercase label, 13px text-variant label), matching explicit `size="sm"` identically. An explicit `size` always wins over density.
56
+ - Buttons and form fields share `--control-height` in every density and size, so inline rows sit flush automatically.
57
+ - With a coarse pointer, every button and icon button retains the 44px (`lg`) touch target in any size or density.
57
58
  - Don't use a button for navigation inside running text; use `Link`.
@@ -35,4 +35,4 @@ See [Radix Checkbox](https://www.radix-ui.com/primitives/docs/components/checkbo
35
35
 
36
36
  ## Appearance
37
37
 
38
- `size="xs" | "sm" | "md"` controls the choice dimensions and label typography; touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
38
+ `size="xs" | "sm" | "md" | "lg"` controls the choice box (`14 / 16 / 18 / 20px`), label typography (`12 / 13 / 14 / 16px`) and description (`11 / 12 / 13 / 14px`); omit `size` to follow density (`md` default, `sm` compact). Touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
@@ -44,6 +44,6 @@ WAI-ARIA combobox with list autocomplete: `aria-autocomplete="list"`, `aria-expa
44
44
 
45
45
  ## Sizes
46
46
 
47
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
47
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
48
48
 
49
49
  The portalled option list carries the same size for its text and option spacing. Options with descriptions can grow beyond the minimum row height.
@@ -35,6 +35,6 @@ A field that opens a `Calendar` in a popover to choose a date or a date range. T
35
35
 
36
36
  ## Sizes
37
37
 
38
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
38
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
39
39
 
40
40
  The calendar panel carries the size tokens across its portal; calendar days keep their component-specific geometry.
@@ -3,7 +3,7 @@
3
3
  A square button that shows only an icon, for compact controls: close, menu, previous and next, more actions.
4
4
 
5
5
  ## Anatomy
6
- 1. **Container**: 40×40px square, 1px border (transparent for `ghost`).
6
+ 1. **Container**: square matching `--control-height` (36×36px `md` default, 32×32px `sm` compact, 24×24px `xs`, 44×44px `lg` and coarse pointers), 1px border (transparent for `ghost`).
7
7
  2. **Icon**: one `Icon` at its default size, `currentColor` (`foreground`).
8
8
 
9
9
  ## Appearance
@@ -24,7 +24,7 @@ A square button that shows only an icon, for compact controls: close, menu, prev
24
24
 
25
25
  ## Props
26
26
  - `icon` (required): an `Icon` name. `label` (required): the action in words; it becomes `aria-label` and the tooltip.
27
- - `variant`, `color`, and `size` (`xs`, `sm`, or `md`). Omit `size` to follow application density; explicit sizes take precedence. Fine-pointer targets are 24px, 32px, and 44px; coarse pointers keep 44px.
27
+ - `variant`, `color`, and `size` (`xs`, `sm`, `md`, or `lg`). Omit `size` to follow application density (`md` default, `sm` compact); explicit sizes take precedence. Fine-pointer targets are 24px, 32px, 36px, and 44px (with 14px, 16px, 16px, and 18px icons); coarse pointers keep 44px.
28
28
  - Native button attributes and an `HTMLButtonElement` ref pass through. Navigation uses `Link` with appearance props and an `Icon` child.
29
29
 
30
30
  ## Rules
@@ -3,8 +3,8 @@
3
3
  A single-line text control for names, emails, numbers, search and other short values.
4
4
 
5
5
  ## Anatomy
6
- 1. **Box**: `card` fill, 1px `input-border` edge (3:1 or more on every surface), square, 44px minimum height, 0.6rem 0.75rem padding.
7
- 2. **Value**: IBM Plex Sans 16px (`text-base`) in `foreground`.
6
+ 1. **Box**: `card` fill, 1px `input-border` edge (3:1 or more on every surface), square, height and padding from `--control-height` (36px `md` default, 32px `sm` compact, 24px `xs`, 44px `lg` and coarse pointers).
7
+ 2. **Value**: IBM Plex Sans from `--control-font-size` (`14px` default `md`, `13px` compact `sm`, `12px` `xs`, `16px` `lg` and coarse pointers) in `foreground`.
8
8
  3. **Placeholder**: `muted-subtle`.
9
9
 
10
10
  ## States
@@ -32,6 +32,6 @@ A single-line text control for names, emails, numbers, search and other short va
32
32
 
33
33
  ## Sizes
34
34
 
35
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
35
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
36
36
 
37
37
  `htmlSize` sets the native input width in characters. It is independent of visual `size`; the component still fills its available container width.
@@ -30,4 +30,4 @@ An inline text link for navigation inside or beside running text.
30
30
  ## Client-side navigation
31
31
  Wrap the app in `LinkProvider` with your router's link component (for example `next/link`) and internal links in `Link`, `Button`, `IconButton`, `Card`, `MediaCard`, `NavList`, `Breadcrumbs` and `ListItem` render with it. Hash, external, `mailto:` and `tel:` links, and links with `target` or `download`, stay plain `<a>`.
32
32
 
33
- Inline links accept `emphasis`. An explicit `variant` selects action geometry and enables `size`; those action links use `color` and `variant` for their foreground treatment. The type contract rejects visual props that would have no effect.
33
+ Inline links accept `emphasis`. An explicit `variant` selects action geometry and enables `size` (`xs` 24px, `sm` 32px, `md` 36px, `lg` 44px on fine pointers; omit to follow density); those action links use `color` and `variant` for their foreground treatment. The type contract rejects visual props that would have no effect.
@@ -42,7 +42,7 @@ WAI-ARIA menu button: the trigger has `aria-haspopup="menu"`, `aria-expanded` an
42
42
  ## Props
43
43
  - `items`: `{ label, onSelect, icon, shortcut, danger, disabled }`, checkable and submenu items as above, `{ type: 'separator' }` or `{ type: 'label', label }`.
44
44
  - `label` or `icon` + `triggerLabel`, `variant` (`solid`, `soft`, `outline`, `ghost`, or `text`), and semantic `color` (`neutral`, `primary`, `info`, `success`, `warning`, or `danger`). Labelled triggers default to `outline`; icon-only triggers default to `ghost` and support `solid`, `soft`, `outline`, and `ghost`. The type contract requires either a label or an icon.
45
- - `size`: `xs`, `sm`, or `md` for either trigger kind. Omit to follow density; explicit sizes win. Fine-pointer targets are 24px, 32px, and 44px; coarse pointers keep 44px.
45
+ - `size`: `xs`, `sm`, `md`, or `lg` for either trigger kind (forwarded to the portalled menu items too). Omit to follow density (`md` default, `sm` compact); explicit sizes win. Fine-pointer targets are 24px, 32px, 36px, and 44px; coarse pointers keep 44px.
46
46
  - `align`, `disabled`, and native Radix root props including `open`, `defaultOpen`, `onOpenChange`, `modal`, and `dir`. `text` draws a labelled trigger in sentence case.
47
47
 
48
48
  ## Rules
@@ -42,7 +42,7 @@ Mouse: click anywhere in the field to open; click options to toggle; click a tag
42
42
 
43
43
  ## Sizes
44
44
 
45
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
45
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
46
46
 
47
47
  The portalled option list carries the same size for its text and option spacing. Options with descriptions can grow beyond the minimum row height.
48
48
 
@@ -20,6 +20,6 @@ The `Input` box with the value in Space Grotesk (tabular), an optional unit, and
20
20
 
21
21
  ## Sizes
22
22
 
23
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
23
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
24
24
 
25
25
  `htmlSize` sets the native input width in characters. It is independent of visual `size`; the component still fills its available container width.
@@ -26,4 +26,4 @@ Labels use `LocaleProvider`; `label` overrides the per-box noun. See the [Radix
26
26
 
27
27
  ## Sizes
28
28
 
29
- `size="xs" | "sm" | "md"` selects 24px, 32px or 44px boxes on fine pointers, with matching text sizes. Boxes still share the available width and wrap on narrow screens. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density and existing digit style.
29
+ `size="xs" | "sm" | "md" | "lg"` selects 24px, 32px, 36px or 44px boxes on fine pointers, with matching tabular numeral sizes (`14 / 16 / 18 / 20px`). Boxes still share the available width and wrap on narrow screens. A coarse pointer keeps 44px targets and 20px digits. Omit `size` to follow application density (`md` default, `sm` compact).
@@ -23,6 +23,6 @@ See the [Radix Password Toggle Field documentation](https://www.radix-ui.com/pri
23
23
 
24
24
  ## Sizes
25
25
 
26
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
26
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
27
27
 
28
28
  `htmlSize` sets the native input width in characters. It is independent of visual `size`; the component still fills its available container width.
@@ -14,7 +14,7 @@ A small non-modal panel attached to a button, for interactive content that doesn
14
14
  ## Props
15
15
  - `label`, `title`, `icon`, and `variant` (`solid`, `soft`, `outline` by default, `ghost`, or `text`).
16
16
  - `color`: `neutral`, `primary` (default), `info`, `success`, `warning`, or `danger`, independent of variant.
17
- - `size`: `xs`, `sm`, or `md`. Omit to follow density; explicit sizes take precedence. Fine-pointer targets are 24px, 32px, and 44px; coarse pointers keep 44px. `align`, `width`.
17
+ - `size`: `xs`, `sm`, `md`, or `lg`. Omit to follow density (`md` default, `sm` compact); explicit sizes take precedence. Fine-pointer targets are 24px, 32px, 36px, and 44px; coarse pointers keep 44px. `align`, `width`.
18
18
  - Native Radix state and mode: `open`, `defaultOpen`, `onOpenChange`, `modal`. `disabled` disables the native trigger button.
19
19
  - `children`: panel content. `close`: one focusable element rendered through Radix Close. The former render-function child is replaced by native Close composition; for more application-specific actions, control `open` through `onOpenChange`.
20
20
 
@@ -26,4 +26,4 @@ A single option in a set where exactly one can be chosen. Use it through `RadioG
26
26
 
27
27
  ## Appearance
28
28
 
29
- `size="xs" | "sm" | "md"` controls the choice dimensions and label typography; touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
29
+ `size="xs" | "sm" | "md" | "lg"` controls the choice box (`14 / 16 / 18 / 20px`), label typography (`12 / 13 / 14 / 16px`) and description (`11 / 12 / 13 / 14px`); omit `size` to follow density (`md` default, `sm` compact). Touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
@@ -27,4 +27,4 @@ See [Radix RadioGroup](https://www.radix-ui.com/primitives/docs/components/radio
27
27
 
28
28
  ## Appearance
29
29
 
30
- `size="xs" | "sm" | "md"` controls the choice dimensions and label typography; touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
30
+ `size="xs" | "sm" | "md" | "lg"` controls the choice box (`14 / 16 / 18 / 20px`), label typography (`12 / 13 / 14 / 16px`) and description (`11 / 12 / 13 / 14px`); omit `size` to follow density (`md` default, `sm` compact). Touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
@@ -24,6 +24,6 @@ Same as `Input` (focus, disabled). The clear button gets a `primary-tint` hover
24
24
 
25
25
  ## Sizes
26
26
 
27
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
27
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
28
28
 
29
29
  `htmlSize` sets the native input width in characters. It is independent of visual `size`; the component still fills its available container width.
@@ -3,7 +3,7 @@
3
3
  A compact set of two to five mutually exclusive options, for switching a view or a period: Week / Month / Quarter, Chart / Table.
4
4
 
5
5
  ## Anatomy
6
- A 1px `border-subtle` outline holding buttons divided by 1px rules, 38px tall (30px at `sm`). Labels are `small` 500 in `muted-foreground`, with optional 16px icons. The selected segment gets `primary-tint`, `foreground` text and a 2px `primary` bar along its bottom edge.
6
+ A 1px `border-subtle` outline holding buttons divided by 1px rules matching `--control-height` (36px `md` default, 32px `sm` compact, 24px `xs`, 44px `lg` and coarse pointers). Labels use `--control-font-size` 500 in `muted-foreground`, with optional `--control-icon-size` icons. The selected segment gets `primary-tint`, `foreground` text and a 2px `primary` bar along its bottom edge.
7
7
 
8
8
  ## Keyboard
9
9
  Arrow keys move the selection (wrapping); one Tab stop for the whole control.
@@ -13,7 +13,7 @@ Built on Radix RadioGroup: `role="radiogroup"` (named by `label`) with `radio` b
13
13
 
14
14
  ## Props
15
15
  - `options`: strings or `{ value, label, icon, disabled }`. `value` + Radix `onValueChange`, or `defaultValue`.
16
- - `size`: `xs`, `sm`, or `md`. Omit to follow density; explicit sizes take precedence. Fine-pointer outer heights are 24px, 32px, and 44px; coarse pointers keep 44px.
16
+ - `size`: `xs`, `sm`, `md`, or `lg`. Omit to follow density (`md` default, `sm` compact); explicit sizes take precedence. Fine-pointer outer heights are 24px, 32px, 36px, and 44px (with 12px, 13px, 14px, and 16px labels); coarse pointers keep 44px.
17
17
  - `color`: `neutral`, `primary` (default), `info`, `success`, `warning`, or `danger`. `variant`: `solid`, `soft` (default), or `outline`, applied to the selected segment.
18
18
  - `label` or standard ARIA naming, an `HTMLDivElement` ref, and native Radix root props: `name`, `required`, `disabled`, `orientation`, `dir`, `loop`, and DOM attributes/events.
19
19
 
@@ -3,7 +3,7 @@
3
3
  A custom drop-down for picking one option from a known list. Trigger and option list are drawn entirely by the system, so it looks the same in every browser and OS. Built on Radix Select (popper position).
4
4
 
5
5
  ## Anatomy
6
- 1. **Trigger**: the `Input` box (`card` fill, 1px `input-border`, square, 44px tall) showing the chosen label, or the placeholder in `muted-subtle`.
6
+ 1. **Trigger**: the `Input` box (`card` fill, 1px `input-border`, square, `--control-height`) showing the chosen label, or the placeholder in `muted-subtle`.
7
7
  2. **Chevron**: `chevron-down` 0.75rem from the right in `muted-foreground`; it turns 180° while the list is open.
8
8
  3. **List**: a panel 4px below the trigger (above it when there's no room below), starting at its left edge and at least its width (wider for long labels, up to the room in the window), `surface-elevated` fill, 1px `border`, square, at most 16rem tall (less if the window has less room) and scrolling beyond that with a thin scrollbar. It rises 0.5rem and fades in over `motion-normal` (not under reduced motion) and closes at once. The list is portalled to the end of `<body>` at `z-popover`, so it is never cut off inside a dialog, drawer or scrolling table.
9
9
  4. **Option**: 0.6rem 0.75rem padding, `text-base` in `foreground`, an optional `description` line in `muted-foreground`. The chosen option is `primary-hover` with a `check` icon on the right (`primary` would drop to 3.97:1 on the active row).
@@ -49,6 +49,6 @@ Implements the WAI-ARIA *select-only combobox* pattern with Radix Select: the tr
49
49
 
50
50
  ## Sizes
51
51
 
52
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
52
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
53
53
 
54
54
  The portalled option list carries the same size for its text and option spacing. Options with descriptions can grow beyond the minimum row height.
@@ -31,4 +31,4 @@ See [Radix Switch](https://www.radix-ui.com/primitives/docs/components/switch) f
31
31
 
32
32
  ## Appearance
33
33
 
34
- `size="xs" | "sm" | "md"` controls the choice dimensions and label typography; touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
34
+ `size="xs" | "sm" | "md" | "lg"` controls the choice box (`14 / 16 / 18 / 20px`), label typography (`12 / 13 / 14 / 16px`) and description (`11 / 12 / 13 / 14px`); omit `size` to follow density (`md` default, `sm` compact). Touch targets retain 44px. `color` selects a shared semantic palette independently of checked state, disabled state and validation. Radix/native callbacks and refs retain their upstream contracts. Forced colors use the system selection palette.
@@ -4,7 +4,7 @@ A compact chip for a chosen value, a filter or a label. It can carry a remove bu
4
4
 
5
5
  ## Anatomy
6
6
  1. **Chip**: `surface-elevated` fill, 1px `border`, square, at least 26px tall, 0.1rem 0.5rem padding.
7
- 2. **Label**: `small` (14px) in `foreground`; long labels truncate with an ellipsis.
7
+ 2. **Label**: `--density-font-secondary` (`13px` default, `12px` compact) in `foreground`; long labels truncate with an ellipsis.
8
8
  3. **Remove button** (optional): a 20px square with a 12px `x` in `muted-foreground`.
9
9
 
10
10
  ## States
@@ -3,7 +3,7 @@
3
3
  A multi-line text control for notes, descriptions and messages.
4
4
 
5
5
  ## Anatomy
6
- Same box as `Input` (`card` fill, `input-border` edge, square, 0.6rem 0.75rem padding), 5 rows by default, line height 1.6, resizable vertically only. Default density keeps an 8rem minimum. Compact density follows native `rows` with a minimum of two readable lines plus shared field padding and borders, never smaller than the control target.
6
+ Same box as `Input` (`card` fill, `input-border` edge, square, shared `--control-padding-*`), 5 rows by default, line height 1.6, resizable vertically only. Default density keeps an 8rem minimum. Compact density follows native `rows` with a minimum of two readable lines plus shared field padding and borders, never smaller than the control target.
7
7
 
8
8
  ## States
9
9
  Identical to `Input`: focus adds a `primary` border and the 2px `ring` outline; invalid gets a `primary` border; disabled is transparent with a dashed edge and `muted-subtle` text.
@@ -21,4 +21,4 @@ Identical to `Input`: focus adds a `primary` border and the 2px `ring` outline;
21
21
 
22
22
  ## Sizes
23
23
 
24
- `size="xs" | "sm" | "md"` controls text size and padding, using the same scale as other fields. `rows` controls the initial multiline height within the density's minimum, including with `showCount`. In compact density, `rows={2}` starts smaller than `rows={5}` without an application height override. On fine pointers, the text sizes are 12px, 14px and 16px. A coarse pointer keeps 16px field text and a target of at least 44px. Native vertical resizing and scrolling remain available. Omit `size` to follow the app's density.
24
+ `size="xs" | "sm" | "md" | "lg"` controls text size and padding, using the shared 4-step control scale. `rows` controls the initial multiline height within the density's minimum, including with `showCount`. In compact density, `rows={2}` starts smaller than `rows={5}` without an application height override. On fine pointers, the text sizes are 12px, 13px, 14px and 16px. A coarse pointer keeps 16px field text and a target of at least 44px. Native vertical resizing and scrolling remain available. Omit `size` to follow application density (`md` default, `sm` compact).
@@ -20,6 +20,6 @@ Accepts `9`, `930`, `9:30`, `9.30`, `9:30pm`, `21:30`. On Enter or leaving the f
20
20
 
21
21
  ## Sizes
22
22
 
23
- `size="xs" | "sm" | "md"` uses the same scale as buttons and other fields: 24px, 32px or 44px minimum height on fine pointers, with 12px, 14px or 16px field text. A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow the app's density. Icons, add-ons and trailing controls follow the selected geometry.
23
+ `size="xs" | "sm" | "md" | "lg"` uses the shared 4-step control scale: 24px, 32px, 36px or 44px minimum height on fine pointers, with 12px, 13px, 14px or 16px field text (and secondary descriptions one step below). A coarse pointer keeps 44px targets and 16px field text. Omit `size` to follow application density (`md` default, `sm` compact). Icons, add-ons and trailing controls follow the selected geometry.
24
24
 
25
25
  The portalled option list carries the same size for its text and option spacing. Options with descriptions can grow beyond the minimum row height.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vokality/design-system",
3
- "version": "6.0.2",
3
+ "version": "6.1.0",
4
4
  "description": "Vokality's design system: tokens, themes and React components for every Vokality project.",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -23,7 +23,7 @@ Do not deep-import `src/` or `dist/`, invent props from another component librar
23
23
  - Use the direct entrypoints `@vokality/design-system/localization`, `@vokality/design-system/rich-text`, `@vokality/design-system/chat-widget`, `@vokality/design-system/chat-inbox`, and `@vokality/design-system/chat-models` for those features. Keep type imports explicit. These features are not root exports.
24
24
  - Use existing tokens such as `var(--background)`, `var(--foreground)`, `var(--primary)`, `var(--border-subtle)`, and `var(--space-lg)` for application CSS. Prefer component variants and layout props over overriding internal selectors. Corners are square, surfaces have thin outlines, and orange identifies the primary action or selection. Avoid decorative shadows and gradients.
25
25
  - Write labels in sentence case; styles provide uppercase presentation. Use the supplied icons and accessible labels. User-authored emoji belong in rich text; interface copy follows the brand guide.
26
- - Set theme and density once with [ThemeProvider](../../docs/components/ThemeProvider/README.md) at the top of `<body>` in the root layout (`density="compact"` for dense apps); never set `data-theme` or `data-density` yourself. Themes are `dark`, `light`, and `contrast`; switch them with `useTheme()`, which takes no options. Use `size="xs"` on `Button`, `IconButton`, `Menu`, `Popover` and `SegmentedControl` for actions in toolbars, record rows and status lines; fields accept the same explicit sizes. Use semantic `color` independently of `variant`, `Link` for navigation, and native Radix callbacks such as `onValueChange`. Typography `size` and layout `gap` accept token names; text hierarchy uses `emphasis`. Shared types live in the direct `/appearance` and `/typography` entrypoints.
26
+ - Set theme and density once with [ThemeProvider](../../docs/components/ThemeProvider/README.md) at the top of `<body>` in the root layout (`density="compact"` for dense apps); never set `data-theme` or `data-density` yourself. Themes are `dark`, `light`, and `contrast`; switch them with `useTheme()`, which takes no options. Actions, fields, and choices share one 4-step fine-pointer control scale: `xs` (24px), `sm` (32px), `md` (36px), and `lg` (44px), with sentence-case text scaling 12/13/14/16px and uppercase action labels two steps below (10/11/12/13px). Omitted sizes follow density (`md` default, `sm` compact); coarse pointers retain 44px targets and 16px field text. Use semantic `color` independently of `variant`, `Link` for navigation, and native Radix callbacks such as `onValueChange`. Typography `size` and layout `gap` accept token names; text hierarchy uses `emphasis`. Shared types live in the direct `/appearance` and `/typography` entrypoints.
27
27
  - In Tailwind v4 applications, follow the README's stylesheet order and token mapping. Do not introduce Tailwind or replace the application's styling setup merely to use the package.
28
28
 
29
29
  ## Behavior, forms, and React