@vokality/design-system 6.0.1 → 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.
- package/CHANGELOG.md +24 -0
- package/README.md +13 -4
- package/dist/appearance.d.ts +2 -2
- package/dist/components/ChatPanel/transcript.js +1 -1
- package/dist/components/Menu/Menu.js +1 -1
- package/dist/components.css +475 -359
- package/dist/tailwind.css +3 -0
- package/dist/tokens.css +20 -3
- package/dist/tokens.dtcg.json +98 -13
- package/dist/tokens.json +99 -14
- package/dist/vokality.css +495 -362
- package/dist/vokality.iife.js +2 -1
- package/docs/brand.md +3 -3
- package/docs/components/Button/README.md +16 -15
- package/docs/components/ChatWidget/README.md +1 -1
- package/docs/components/Checkbox/README.md +1 -1
- package/docs/components/Combobox/README.md +1 -1
- package/docs/components/DatePicker/README.md +1 -1
- package/docs/components/IconButton/README.md +2 -2
- package/docs/components/Input/README.md +3 -3
- package/docs/components/Link/README.md +1 -1
- package/docs/components/Menu/README.md +1 -1
- package/docs/components/MultiSelect/README.md +1 -1
- package/docs/components/NumberInput/README.md +1 -1
- package/docs/components/OtpInput/README.md +1 -1
- package/docs/components/PasswordInput/README.md +1 -1
- package/docs/components/Popover/README.md +1 -1
- package/docs/components/Radio/README.md +1 -1
- package/docs/components/RadioGroup/README.md +1 -1
- package/docs/components/SearchInput/README.md +1 -1
- package/docs/components/SegmentedControl/README.md +2 -2
- package/docs/components/Select/README.md +2 -2
- package/docs/components/Switch/README.md +1 -1
- package/docs/components/Tag/README.md +1 -1
- package/docs/components/Textarea/README.md +2 -2
- package/docs/components/TimePicker/README.md +1 -1
- package/package.json +1 -1
- package/skills/vokality-design-system/SKILL.md +1 -1
package/dist/vokality.iife.js
CHANGED
|
@@ -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, {
|
|
@@ -45843,7 +45844,7 @@ Defaulting to \`null\`.`;
|
|
|
45843
45844
|
]
|
|
45844
45845
|
}, undefined, true, undefined, this),
|
|
45845
45846
|
/* @__PURE__ */ jsx_dev_runtime90.jsxDEV("div", {
|
|
45846
|
-
className: "vk-prose vk-chat-message-content",
|
|
45847
|
+
className: cx("vk-prose vk-chat-message-content", typeof message.content === "string" && "vk-chat-message-text"),
|
|
45847
45848
|
children: message.content
|
|
45848
45849
|
}, undefined, false, undefined, this),
|
|
45849
45850
|
/* @__PURE__ */ jsx_dev_runtime90.jsxDEV(MessageDelivery, {
|
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,
|
|
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
|
-
-
|
|
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,
|
|
7
|
-
2. **Label**: IBM Plex Sans, `
|
|
8
|
-
3. **Glyph cell** (optional, `arrow`): a
|
|
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 |
|
|
23
|
-
| --- | --- | --- | --- |
|
|
24
|
-
| omitted | Follows density (
|
|
25
|
-
| `
|
|
26
|
-
| `
|
|
27
|
-
| `
|
|
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
|
|
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 `
|
|
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
|
|
54
|
-
- With `
|
|
55
|
-
-
|
|
56
|
-
- With a coarse pointer, every button and icon button
|
|
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`.
|
|
@@ -30,7 +30,7 @@ const items: ChatItem[] = [{
|
|
|
30
30
|
- `author.source: { label, mark? }` names the channel the message came through ("Linear", "Pull request") in a small ruled tag beside the author. `mark` is a decorative 12px image; the label carries the meaning.
|
|
31
31
|
- `actions: ChatAction[]` draws extra-small buttons under the message: `{ id, label, onSelect, disabled?, variant? }`, where `variant` is `outline` (default), `primary`, `ghost` or `danger`. Keep to one primary action per message.
|
|
32
32
|
|
|
33
|
-
The application owns the transcript items, transport, authentication, async sending, retries and persistence. Content is a React node; strings are displayed as text. The component does not parse incoming Markdown or inject HTML. Render formatted content in your application, including through an existing read-only `RichTextEditor` if useful.
|
|
33
|
+
The application owns the transcript items, transport, authentication, async sending, retries and persistence. Content is a React node; plain strings are displayed as text with their line breaks preserved. Formatted React content uses normal HTML whitespace, so newline text nodes between paragraphs or list items do not add empty lines. Use semantic `<br>` and `<pre>` elements for intentional breaks and preformatted text. The component does not parse incoming Markdown or inject HTML. Render formatted content in your application, including through an existing read-only `RichTextEditor` if useful.
|
|
34
34
|
|
|
35
35
|
## Agent activity
|
|
36
36
|
|
|
@@ -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
|
|
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
|
|
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
|
|
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**:
|
|
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 `
|
|
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,
|
|
7
|
-
2. **Value**: IBM Plex Sans
|
|
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
|
|
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
|
|
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 `
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 `
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 `
|
|
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,
|
|
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
|
|
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
|
|
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**: `
|
|
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,
|
|
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
|
|
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
|
|
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
|
@@ -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.
|
|
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
|