rudiment-ui 0.2.0 → 0.3.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 (52) hide show
  1. package/README.md +119 -100
  2. package/dist/components/AppShell/AppShell.d.ts +48 -0
  3. package/dist/components/AppShell/AppShell.d.ts.map +1 -0
  4. package/dist/components/Breadcrumb/Breadcrumb.d.ts +14 -0
  5. package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -0
  6. package/dist/components/Charts/BarChart/BarChart.d.ts +5 -1
  7. package/dist/components/Charts/BarChart/BarChart.d.ts.map +1 -1
  8. package/dist/components/Charts/LineChart/LineChart.d.ts +6 -1
  9. package/dist/components/Charts/LineChart/LineChart.d.ts.map +1 -1
  10. package/dist/components/Divider/Divider.d.ts +15 -0
  11. package/dist/components/Divider/Divider.d.ts.map +1 -0
  12. package/dist/components/Dot/Dot.d.ts +20 -0
  13. package/dist/components/Dot/Dot.d.ts.map +1 -0
  14. package/dist/components/Footer/Footer.d.ts +31 -0
  15. package/dist/components/Footer/Footer.d.ts.map +1 -0
  16. package/dist/components/Image/Image.d.ts +18 -0
  17. package/dist/components/Image/Image.d.ts.map +1 -0
  18. package/dist/components/Link/Link.d.ts +16 -0
  19. package/dist/components/Link/Link.d.ts.map +1 -0
  20. package/dist/components/Menu/MenuItem.d.ts +10 -1
  21. package/dist/components/Menu/MenuItem.d.ts.map +1 -1
  22. package/dist/components/Menu/MenuSeparator.d.ts +5 -0
  23. package/dist/components/Menu/MenuSeparator.d.ts.map +1 -0
  24. package/dist/components/Menu/SubmenuTrigger.d.ts +5 -0
  25. package/dist/components/Menu/SubmenuTrigger.d.ts.map +1 -0
  26. package/dist/components/PageHeader/PageHeader.d.ts +12 -0
  27. package/dist/components/PageHeader/PageHeader.d.ts.map +1 -0
  28. package/dist/components/Pagination/Pagination.d.ts +14 -0
  29. package/dist/components/Pagination/Pagination.d.ts.map +1 -0
  30. package/dist/components/ProgressBar/ProgressBar.d.ts +14 -2
  31. package/dist/components/ProgressBar/ProgressBar.d.ts.map +1 -1
  32. package/dist/components/Rating/Rating.d.ts +18 -0
  33. package/dist/components/Rating/Rating.d.ts.map +1 -0
  34. package/dist/components/SectionHeader/SectionHeader.d.ts +12 -0
  35. package/dist/components/SectionHeader/SectionHeader.d.ts.map +1 -0
  36. package/dist/components/Select/Option.d.ts +3 -0
  37. package/dist/components/Select/Option.d.ts.map +1 -0
  38. package/dist/components/Stepper/Stepper.d.ts +17 -0
  39. package/dist/components/Stepper/Stepper.d.ts.map +1 -0
  40. package/dist/components/Textarea/Textarea.d.ts +17 -0
  41. package/dist/components/Textarea/Textarea.d.ts.map +1 -0
  42. package/dist/components/TopBar/TopBar.d.ts +18 -0
  43. package/dist/components/TopBar/TopBar.d.ts.map +1 -0
  44. package/dist/index.css +1 -1
  45. package/dist/index.d.ts +27 -3
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +1289 -810
  48. package/dist/typography/Heading/Heading.d.ts +9 -0
  49. package/dist/typography/Heading/Heading.d.ts.map +1 -1
  50. package/dist/typography/Text/Text.d.ts +11 -0
  51. package/dist/typography/Text/Text.d.ts.map +1 -1
  52. package/package.json +3 -3
package/README.md CHANGED
@@ -1,21 +1,23 @@
1
1
  # Rudiment UI
2
2
 
3
+ > Rudiment is still in beta (not even beta, really) and should not be used in production. I'm happy to accept pull requests that help improve this tool.
4
+
3
5
  A complete, accessible React component library template built on [React Aria](https://react-spectrum.adobe.com/react-aria/), styled with [Tailwind CSS 4](https://tailwindcss.com/), and documented in [Storybook](https://storybook.js.org/).
4
6
 
5
7
  Clone it. Swap the tokens. Ship your design system.
6
8
 
7
9
  ## What's included
8
10
 
9
- | Category | Components |
10
- |----------|-----------|
11
- | **UI Components** | Button, Input, Checkbox, CheckboxGroup, Select, Dialog, Switch, RadioGroup, Tooltip, Alert, IconButton, Badge, Tag, Avatar, Card, Icon, NavItem, ProgressBar, StatCard, CircularProgress |
12
- | **Charts** | BarChart, LineChart, DonutChart |
13
- | **Kanban** | KanbanBoard, KanbanColumn, KanbanCard |
14
- | **Typography** | Heading, Text, Prose |
15
- | **Layout Primitives** | Box, Stack, Cluster, Grid, Sidebar, Center, Cover, Switcher |
16
- | **Page Examples** | App Shell, App Header, App Footer, Settings Page, Sign-In Form, Marketing Hero, Sidebar Layout, Article Page, Simple Form, Empty State |
11
+ | Category | Components |
12
+ | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
13
+ | **UI Components** | Button, Input, Checkbox, CheckboxGroup, Select, Dialog, Switch, RadioGroup, Tooltip, Alert, IconButton, Badge, Tag, Avatar, Card, Icon, NavItem, ProgressBar, StatCard, CircularProgress |
14
+ | **Charts** | BarChart, LineChart, DonutChart |
15
+ | **Kanban** | KanbanBoard, KanbanColumn, KanbanCard |
16
+ | **Typography** | Heading, Text, Prose |
17
+ | **Layout Primitives** | Box, Stack, Cluster, Grid, Sidebar, Center, Cover, Switcher |
18
+ | **Page Examples** | App Shell, App Header, App Footer, Settings Page, Sign-In Form, Marketing Hero, Sidebar Layout, Article Page, Simple Form, Empty State |
17
19
 
18
- Also included: a three-tier design token architecture, six built-in themes (Default, Teal, and Cyberpunk in light and dark variants), motion tokens, a data visualization palette, surface tokens, a Vitest test suite with accessibility checks, and interactive Storybook documentation.
20
+ Also included: a three-tier design token architecture, eight built-in themes (Default plus the Roomy, Soft, and Compressed modifier themes, each in light and dark variants), motion tokens, a data visualization palette, surface tokens, a Vitest test suite with accessibility checks, and interactive Storybook documentation.
19
21
 
20
22
  ## Quick start
21
23
 
@@ -51,7 +53,7 @@ Import the stylesheet once at your app's entry point:
51
53
  import 'rudiment-ui/styles'
52
54
  ```
53
55
 
54
- This ships the component styles plus all six themes. It does **not** include Tailwind — components are styled with plain BEM classes and CSS custom properties, and the bundle contains no bare-element selectors, so it will not reset or clobber your app's own styles.
56
+ This ships the component styles plus all eight themes. It does **not** include Tailwind — components are styled with plain BEM classes and CSS custom properties, and the bundle contains no bare-element selectors, so it will not reset or clobber your app's own styles.
55
57
 
56
58
  Every export is marked `"use client"`, so the package can be imported directly into a Next.js App Router Server Component without a re-export barrel.
57
59
 
@@ -70,21 +72,31 @@ That single import is the whole setup. There is no provider to mount — `Dialog
70
72
 
71
73
  ## Themes
72
74
 
73
- Six themes ship in the stylesheet. Set `data-theme` on a root element to switch:
75
+ Eight themes ship in the stylesheet. Set `data-theme` on a root element to switch:
74
76
 
75
- | Theme | Attribute |
76
- |-------|-----------|
77
- | Default (light) | *no attribute* |
78
- | Dark | `data-theme="dark"` |
79
- | Teal | `data-theme="teal"` |
80
- | Teal Dark | `data-theme="teal-dark"` |
81
- | Cyberpunk | `data-theme="cyberpunk"` |
82
- | Cyberpunk Dark | `data-theme="cyberpunk-dark"` |
77
+ | Theme | Attribute |
78
+ | --------------- | ------------------------------ |
79
+ | Default (light) | _no attribute_ |
80
+ | Dark | `data-theme="dark"` |
81
+ | Roomy | `data-theme="roomy"` |
82
+ | Roomy Dark | `data-theme="roomy-dark"` |
83
+ | Soft | `data-theme="soft"` |
84
+ | Soft Dark | `data-theme="soft-dark"` |
85
+ | Compressed | `data-theme="compressed"` |
86
+ | Compressed Dark | `data-theme="compressed-dark"` |
83
87
 
84
88
  The default theme lives on `:root`, so **omit the attribute for it** — there is no `data-theme="light"`. Remove the attribute to return to default.
85
89
 
86
90
  ```tsx
87
- type Theme = 'default' | 'dark' | 'teal' | 'teal-dark' | 'cyberpunk' | 'cyberpunk-dark'
91
+ type Theme =
92
+ | 'default'
93
+ | 'dark'
94
+ | 'roomy'
95
+ | 'roomy-dark'
96
+ | 'soft'
97
+ | 'soft-dark'
98
+ | 'compressed'
99
+ | 'compressed-dark'
88
100
 
89
101
  function applyTheme(theme: Theme) {
90
102
  if (theme === 'default') {
@@ -111,9 +123,11 @@ Charts follow theme changes automatically — `useChartTheme` watches `data-them
111
123
  Every visual value is a CSS custom property prefixed `--rudi-`, arranged in three tiers that resolve through `var()` chains. Overriding a tier cascades to everything below it.
112
124
 
113
125
  ```css
114
- --rudi-color-neutral-900: #171717; /* 1. primitive */
115
- --rudi-color-brand-primary: var(--rudi-color-neutral-900); /* 2. semantic */
116
- --rudi-component-button-primary-bg: var(--rudi-color-brand-primary); /* 3. component */
126
+ --rudi-color-neutral-900: #171717; /* 1. primitive */
127
+ --rudi-color-brand-primary: var(--rudi-color-neutral-900); /* 2. semantic */
128
+ --rudi-component-button-primary-bg: var(
129
+ --rudi-color-brand-primary
130
+ ); /* 3. component */
117
131
  ```
118
132
 
119
133
  Rebrand by overriding tier 2 in your own stylesheet, loaded after `rudiment-ui/styles`:
@@ -129,25 +143,29 @@ Rebrand by overriding tier 2 in your own stylesheet, loaded after `rudiment-ui/s
129
143
  **Scope overrides per theme.** `:root` and `[data-theme="dark"]` have equal specificity, and the theme blocks come later in the stylesheet — so a plain `:root` override loses inside a themed subtree. Repeat it under each theme you use:
130
144
 
131
145
  ```css
132
- :root { --rudi-color-brand-primary: #7c3aed; }
133
- [data-theme="dark"] { --rudi-color-brand-primary: #a78bfa; }
146
+ :root {
147
+ --rudi-color-brand-primary: #7c3aed;
148
+ }
149
+ [data-theme='dark'] {
150
+ --rudi-color-brand-primary: #a78bfa;
151
+ }
134
152
  ```
135
153
 
136
154
  The tokens worth reaching for most often:
137
155
 
138
- | Purpose | Tokens |
139
- |---------|--------|
140
- | **Brand** | `--rudi-color-brand-primary`, `-hover`, `-active` |
141
- | **Surfaces** | `--rudi-color-background-surface`, `-raised`, `-sunken`, `-overlay`, `--rudi-color-background-disabled`, `-inverted` |
142
- | **Text** | `--rudi-color-text-default`, `-subtle`, `-disabled`, `-on-brand`, `-on-inverted` |
143
- | **Borders** | `--rudi-color-border-default`, `-focus`, `-error` |
144
- | **Feedback** | `--rudi-color-feedback-{error,success,warning,info}` each with `-surface`, `-border`, `-text` |
145
- | **Charts** | `--rudi-color-dataviz-series-1` … `-8` |
146
- | **Spacing** | `--rudi-spacing-{0,1,2,3,4,6,8,12}` (`0.25rem` steps — note 5, 7, 9–11 don't exist) |
147
- | **Radius** | `--rudi-radius-{none,sm,md,lg,full}` |
148
- | **Type** | `--rudi-font-family-{sans,mono}`, `--rudi-font-size-{xs…4xl}`, `--rudi-font-weight-{regular,medium,semibold,bold}` |
149
- | **Motion** | `--rudi-motion-duration-{fast,base,slow}`, `--rudi-motion-easing-standard` |
150
- | **Layout** | `--rudi-layout-sidebar-width`, `--rudi-layout-grid-min-cell`, `--rudi-layout-center-max-width`, `--rudi-layout-switcher-threshold` |
156
+ | Purpose | Tokens |
157
+ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
158
+ | **Brand** | `--rudi-color-brand-primary`, `-hover`, `-active` |
159
+ | **Surfaces** | `--rudi-color-background-surface`, `-raised`, `-sunken`, `-overlay`, `--rudi-color-background-disabled`, `-inverted` |
160
+ | **Text** | `--rudi-color-text-default`, `-subtle`, `-disabled`, `-on-brand`, `-on-inverted` |
161
+ | **Borders** | `--rudi-color-border-default`, `-focus`, `-error` |
162
+ | **Feedback** | `--rudi-color-feedback-{error,success,warning,info}` each with `-surface`, `-border`, `-text` |
163
+ | **Charts** | `--rudi-color-dataviz-series-1` … `-8` |
164
+ | **Spacing** | `--rudi-spacing-{0,1,2,3,4,6,8,12}` (`0.25rem` steps — note 5, 7, 9–11 don't exist) |
165
+ | **Radius** | `--rudi-radius-{none,sm,md,lg,full}` |
166
+ | **Type** | `--rudi-font-family-{sans,mono}`, `--rudi-font-size-{xs…4xl}`, `--rudi-font-weight-{regular,medium,semibold,bold}` |
167
+ | **Motion** | `--rudi-motion-duration-{fast,base,slow}`, `--rudi-motion-easing-standard` |
168
+ | **Layout** | `--rudi-layout-sidebar-width`, `--rudi-layout-grid-min-cell`, `--rudi-layout-center-max-width`, `--rudi-layout-switcher-threshold` |
151
169
 
152
170
  Component-level tokens (`--rudi-component-*`) are available for surgical changes — `--rudi-component-button-primary-bg`, `--rudi-component-card-bg`, `--rudi-component-input-bg`, and so on — but prefer semantic overrides so the change carries across every component.
153
171
 
@@ -180,22 +198,22 @@ function LoginForm() {
180
198
 
181
199
  **Actions**
182
200
 
183
- | Component | Props |
184
- |-----------|-------|
185
- | `Button` | `variant?: 'primary' \| 'secondary' \| 'destructive' \| 'ghost'` (`'primary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `iconBefore?`, `iconAfter?`, `onPress?`, `isDisabled?` |
186
- | `IconButton` | `aria-label` **(required)**, `variant?` (`'secondary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `onPress?`; `children` is a single element |
187
- | `NavItem` | `label` **(required)**, `icon?`, `isActive?`, `href?` (renders `<a>`, else `<button>`), `onPress?`, `badge?`, `isDisabled?` |
201
+ | Component | Props |
202
+ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
203
+ | `Button` | `variant?: 'primary' \| 'secondary' \| 'destructive' \| 'ghost'` (`'primary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `iconBefore?`, `iconAfter?`, `onPress?`, `isDisabled?` |
204
+ | `IconButton` | `aria-label` **(required)**, `variant?` (`'secondary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `onPress?`; `children` is a single element |
205
+ | `NavItem` | `label` **(required)**, `icon?`, `isActive?`, `href?` (renders `<a>`, else `<button>`), `onPress?`, `badge?`, `isDisabled?` |
188
206
 
189
207
  **Forms**
190
208
 
191
- | Component | Props |
192
- |-----------|-------|
193
- | `Input` | `label` **(required)**, `type?: 'text' \| 'email' \| 'password' \| 'url' \| 'tel' \| 'search' \| 'number'` (`'text'`), `placeholder?`, `description?`, `errorMessage?` (sets invalid state), `isRequired?`, `isDisabled?`, `value?`, `defaultValue?`, `onChange?: (value: string) => void` |
194
- | `Checkbox` | `children` (label), `isSelected?`, `defaultSelected?`, `isIndeterminate?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?`, `value?` |
195
- | `CheckboxGroup` | `label` **(required)**, `description?`, `value?: string[]`, `defaultValue?`, `onChange?: (value: string[]) => void`, `errorMessage?`, `isDisabled?` |
196
- | `Switch` | `children` (label), `isSelected?`, `defaultSelected?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?` |
197
- | `Select` | `label`, `items`, `children: (item) => ReactNode`, `selectedKey?`, `defaultSelectedKey?`, `onSelectionChange?: (key) => void`, `placeholder?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?` |
198
- | `RadioGroup` | `label`, `orientation?: 'horizontal' \| 'vertical'`, `value?`, `defaultValue?`, `onChange?: (value: string) => void`, `errorMessage?`, `isDisabled?` |
209
+ | Component | Props |
210
+ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
211
+ | `Input` | `label` **(required)**, `type?: 'text' \| 'email' \| 'password' \| 'url' \| 'tel' \| 'search' \| 'number'` (`'text'`), `placeholder?`, `description?`, `errorMessage?` (sets invalid state), `isRequired?`, `isDisabled?`, `value?`, `defaultValue?`, `onChange?: (value: string) => void` |
212
+ | `Checkbox` | `children` (label), `isSelected?`, `defaultSelected?`, `isIndeterminate?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?`, `value?` |
213
+ | `CheckboxGroup` | `label` **(required)**, `description?`, `value?: string[]`, `defaultValue?`, `onChange?: (value: string[]) => void`, `errorMessage?`, `isDisabled?` |
214
+ | `Switch` | `children` (label), `isSelected?`, `defaultSelected?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?` |
215
+ | `Select` | `label`, `items`, `children: (item) => ReactNode`, `selectedKey?`, `defaultSelectedKey?`, `onSelectionChange?: (key) => void`, `placeholder?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?` |
216
+ | `RadioGroup` | `label`, `orientation?: 'horizontal' \| 'vertical'`, `value?`, `defaultValue?`, `onChange?: (value: string) => void`, `errorMessage?`, `isDisabled?` |
199
217
 
200
218
  `Select` renders its options from an `items` collection plus a render function. The item element comes from `react-stately`:
201
219
 
@@ -216,27 +234,27 @@ const roles = [
216
234
 
217
235
  **Feedback & display**
218
236
 
219
- | Component | Props |
220
- |-----------|-------|
221
- | `Alert` | `variant: 'info' \| 'success' \| 'warning' \| 'error'` **(required)**, `title?`, `icon?`, `isPolite?` (`role="status"` instead of `"alert"`), `dismissible?`, `onDismiss?` |
222
- | `Badge` | `variant?: 'default' \| 'success' \| 'warning' \| 'error' \| 'info'` (`'default'`), `size?: 'sm' \| 'md'` (`'md'`), `dot?` (hides children) |
223
- | `Tag` | `variant?` (as Badge), `dismissible?`, `onDismiss?`, `onPress?` (switches root to `<button>`), `isDisabled?` |
224
- | `Avatar` | `src?`, `alt?`, `name?` (derives initials), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `status?: 'success' \| 'warning' \| 'error' \| 'info'` |
225
- | `Icon` | `icon` **(required)**, `size?: 'sm' \| 'md' \| 'lg' \| number` (`'md'`), `color?`, `label?` (sets `role="img"`; without it the icon is `aria-hidden`) |
226
- | `ProgressBar` | `value` + `label` **(required)**, `minValue?` (`0`), `maxValue?` (`100`), `showValueLabel?`, `variant?: 'default' \| 'success' \| 'warning' \| 'error'`, `size?: 'sm' \| 'md'` |
227
- | `CircularProgress` | same as ProgressBar plus `size?: 'sm' \| 'md' \| 'lg'` and `children?` for custom center content |
228
- | `StatCard` | `label`, `value: string \| number`, `delta?: string`, `trend?: 'up' \| 'down' \| 'neutral'` (`'neutral'`), `children?` |
237
+ | Component | Props |
238
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
239
+ | `Alert` | `variant: 'info' \| 'success' \| 'warning' \| 'error'` **(required)**, `title?`, `icon?`, `isPolite?` (`role="status"` instead of `"alert"`), `dismissible?`, `onDismiss?` |
240
+ | `Badge` | `variant?: 'default' \| 'success' \| 'warning' \| 'error' \| 'info'` (`'default'`), `size?: 'sm' \| 'md'` (`'md'`), `dot?` (hides children) |
241
+ | `Tag` | `variant?` (as Badge), `dismissible?`, `onDismiss?`, `onPress?` (switches root to `<button>`), `isDisabled?` |
242
+ | `Avatar` | `src?`, `alt?`, `name?` (derives initials), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `status?: 'success' \| 'warning' \| 'error' \| 'info'` |
243
+ | `Icon` | `icon` **(required)**, `size?: 'sm' \| 'md' \| 'lg' \| number` (`'md'`), `color?`, `label?` (sets `role="img"`; without it the icon is `aria-hidden`) |
244
+ | `ProgressBar` | `value` + `label` **(required)**, `minValue?` (`0`), `maxValue?` (`100`), `showValueLabel?`, `variant?: 'default' \| 'success' \| 'warning' \| 'error'`, `size?: 'sm' \| 'md'` |
245
+ | `CircularProgress` | same as ProgressBar plus `size?: 'sm' \| 'md' \| 'lg'` and `children?` for custom center content |
246
+ | `StatCard` | `label`, `value: string \| number`, `delta?: string`, `trend?: 'up' \| 'down' \| 'neutral'` (`'neutral'`), `children?` |
229
247
 
230
248
  `Alert` and `Tag` handle dismissal with internal state — once dismissed they render `null` and can't be reopened via props. Control visibility yourself if you need it back.
231
249
 
232
250
  **Containers & overlays**
233
251
 
234
- | Component | Props |
235
- |-----------|-------|
236
- | `Card` | `variant?: 'default' \| 'outlined' \| 'elevated'` (`'default'`), `padding?: 'none' \| 'sm' \| 'md' \| 'lg'` (`'md'`) |
237
- | `Dialog` | `isOpen`, `onClose`, `title` **(all required)**, `isDismissable?` (`true`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`) |
238
- | `TooltipTrigger` / `Tooltip` | `delay?` (`500`ms), `closeDelay?` (`0`ms); children must be exactly `[trigger, tooltip]` |
239
- | `MenuTrigger` / `Menu` / `MenuItem` / `MenuSection` / `Keyboard` | React Aria menu primitives; `MenuItem` adds `isDestructive?` |
252
+ | Component | Props |
253
+ | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
254
+ | `Card` | `variant?: 'default' \| 'outlined' \| 'elevated'` (`'default'`), `padding?: 'none' \| 'sm' \| 'md' \| 'lg'` (`'md'`) |
255
+ | `Dialog` | `isOpen`, `onClose`, `title` **(all required)**, `isDismissable?` (`true`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`) |
256
+ | `TooltipTrigger` / `Tooltip` | `delay?` (`500`ms), `closeDelay?` (`0`ms); children must be exactly `[trigger, tooltip]` |
257
+ | `MenuTrigger` / `Menu` / `MenuItem` / `MenuSection` / `Keyboard` | React Aria menu primitives; `MenuItem` adds `isDestructive?` |
240
258
 
241
259
  `Card` is compound — use the dot subcomponents:
242
260
 
@@ -263,7 +281,9 @@ const [isOpen, setIsOpen] = useState(false)
263
281
 
264
282
  ```tsx
265
283
  <TooltipTrigger>
266
- <IconButton aria-label="Delete"><Icon icon="mdi:trash-can" /></IconButton>
284
+ <IconButton aria-label="Delete">
285
+ <Icon icon="mdi:trash-can" />
286
+ </IconButton>
267
287
  <Tooltip>Delete this item</Tooltip>
268
288
  </TooltipTrigger>
269
289
  ```
@@ -272,16 +292,16 @@ const [isOpen, setIsOpen] = useState(false)
272
292
 
273
293
  Eight primitives handle spacing and composition. **Every spacing prop takes a raw CSS length string** — `"1rem"`, `"2rem"`, or `var(--rudi-spacing-6)` — not a numeric scale. The prop is `space` everywhere (never `gap`); `Box` uses `padding`. All accept `as`, `className`, and any DOM attribute.
274
294
 
275
- | Component | Props | Default |
276
- |-----------|-------|---------|
277
- | `Box` | `padding?`, `bordered?`, `invert?` | padding `1rem` |
278
- | `Stack` | `space?`, `recursive?`, `splitAfter?: number` | space `1.5rem` |
279
- | `Cluster` | `space?`, `justify?: 'flex-start' \| 'flex-end' \| 'center' \| 'space-between' \| 'space-around'`, `align?: 'flex-start' \| 'flex-end' \| 'center' \| 'baseline' \| 'stretch'` | space `1rem`, justify `flex-start`, align `center` |
280
- | `Grid` | `minCellWidth?`, `space?` | min cell `15rem`, space `1.5rem` |
281
- | `Sidebar` | `side?: 'left' \| 'right'`, `sideWidth?`, `contentMin?`, `space?`, `noStretch?` | side `left`, width `20rem`, content min `50%` |
282
- | `Center` | `maxWidth?`, `gutters?`, `intrinsic?` | max width `60rem`, gutters `1rem` |
283
- | `Cover` | `minHeight?`, `space?` | min height `100vh` |
284
- | `Switcher` | `threshold?`, `space?` | threshold `30rem`, space `1.5rem` |
295
+ | Component | Props | Default |
296
+ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------- |
297
+ | `Box` | `padding?`, `bordered?`, `invert?` | padding `1rem` |
298
+ | `Stack` | `space?`, `recursive?`, `splitAfter?: number` | space `1.5rem` |
299
+ | `Cluster` | `space?`, `justify?: 'flex-start' \| 'flex-end' \| 'center' \| 'space-between' \| 'space-around'`, `align?: 'flex-start' \| 'flex-end' \| 'center' \| 'baseline' \| 'stretch'` | space `1rem`, justify `flex-start`, align `center` |
300
+ | `Grid` | `minCellWidth?`, `space?` | min cell `15rem`, space `1.5rem` |
301
+ | `Sidebar` | `side?: 'left' \| 'right'`, `sideWidth?`, `contentMin?`, `space?`, `noStretch?` | side `left`, width `20rem`, content min `50%` |
302
+ | `Center` | `maxWidth?`, `gutters?`, `intrinsic?` | max width `60rem`, gutters `1rem` |
303
+ | `Cover` | `minHeight?`, `space?` | min height `100vh` |
304
+ | `Switcher` | `threshold?`, `space?` | threshold `30rem`, space `1.5rem` |
285
305
 
286
306
  ```tsx
287
307
  <Sidebar side="left" sideWidth="16rem" space="2rem">
@@ -300,11 +320,11 @@ Eight primitives handle spacing and composition. **Every spacing prop takes a ra
300
320
 
301
321
  ## Typography
302
322
 
303
- | Component | Props |
304
- |-----------|-------|
305
- | `Heading` | `level: 1–6` **(required, sets the tag)**, `size?: 1–6` (visual size, defaults to `level`) |
306
- | `Text` | `variant?: 'body' \| 'body-sm' \| 'caption' \| 'overline' \| 'code'` (`'body'`), `as?` (`'p'`) |
307
- | `Prose` | `size?: 'sm' \| 'base' \| 'lg'` (`'base'`), `as?` (`'div'`) |
323
+ | Component | Props |
324
+ | --------- | ---------------------------------------------------------------------------------------------- |
325
+ | `Heading` | `level: 1–6` **(required, sets the tag)**, `size?: 1–6` (visual size, defaults to `level`) |
326
+ | `Text` | `variant?: 'body' \| 'body-sm' \| 'caption' \| 'overline' \| 'code'` (`'body'`), `as?` (`'p'`) |
327
+ | `Prose` | `size?: 'sm' \| 'base' \| 'lg'` (`'base'`), `as?` (`'div'`) |
308
328
 
309
329
  `level` and `size` are separate so you can keep a correct document outline while styling freely — `<Heading level={2} size={4}>` renders an `<h2>` that looks like an h4. `Prose` styles a block of unstyled HTML (CMS content, rendered Markdown).
310
330
 
@@ -312,11 +332,11 @@ Eight primitives handle spacing and composition. **Every spacing prop takes a ra
312
332
 
313
333
  All three wrap Recharts, size themselves to their container, and require a `label` for the accessible name. Series colors come from the dataviz tokens and follow the active theme automatically.
314
334
 
315
- | Component | Props |
316
- |-----------|-------|
317
- | `BarChart` | `data`, `dataKeys: string[]`, `indexKey`, `label`, `layout?: 'vertical' \| 'horizontal'` (`'vertical'`), `stacked?`, `showLegend?` (`true`), `showGrid?` (`true`), `height?` (`300`) |
318
- | `LineChart` | `data`, `dataKeys`, `indexKey`, `label`, `curved?` (`true`), `showDots?` (`true`), `showGrid?`, `showLegend?`, `height?` |
319
- | `DonutChart` | `data: { name, value }[]`, `label`, `innerRadius?` (`60`), `showLabels?` (`false`), `showLegend?`, `height?` |
335
+ | Component | Props |
336
+ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
337
+ | `BarChart` | `data`, `dataKeys: string[]`, `indexKey`, `label`, `layout?: 'vertical' \| 'horizontal'` (`'vertical'`), `stacked?`, `showLegend?` (`true`), `showGrid?` (`true`), `height?` (`300`) |
338
+ | `LineChart` | `data`, `dataKeys`, `indexKey`, `label`, `curved?` (`true`), `showDots?` (`true`), `showGrid?`, `showLegend?`, `height?` |
339
+ | `DonutChart` | `data: { name, value }[]`, `label`, `innerRadius?` (`60`), `showLabels?` (`false`), `showLegend?`, `height?` |
320
340
 
321
341
  ```tsx
322
342
  <BarChart
@@ -339,9 +359,8 @@ Note that `BarChart`'s `layout` describes the bars, not the Recharts axis: the d
339
359
 
340
360
  ```tsx
341
361
  import { KanbanBoard, KanbanCard, type KanbanCardMoveEvent } from 'rudiment-ui'
342
-
343
- <KanbanBoard
344
- columns={columns} // { id, title, items: { id, ... }[] }[]
362
+ ;<KanbanBoard
363
+ columns={columns} // { id, title, items: { id, ... }[] }[]
345
364
  renderCard={(item) => <KanbanCard id={item.id}>{item.title}</KanbanCard>}
346
365
  onCardMove={(e: KanbanCardMoveEvent) => {
347
366
  // e: { cardId, fromColumnId, toColumnId, fromIndex, toIndex }
@@ -370,15 +389,15 @@ If you cloned the template rather than installing the package:
370
389
 
371
390
  ## Available scripts
372
391
 
373
- | Command | Description |
374
- |---------|------------|
375
- | `npm run dev` | Start Storybook dev server on port 6006 |
376
- | `npm run build` | Build the component library for distribution |
377
- | `npm run build-storybook` | Build a static Storybook site |
378
- | `npm run build:tokens` | Generate CSS from design token JSON files |
379
- | `npm run test` | Run the test suite |
380
- | `npm run test:coverage` | Run tests with coverage report |
381
- | `npm run test:watch` | Run tests in watch mode |
392
+ | Command | Description |
393
+ | ------------------------- | -------------------------------------------- |
394
+ | `npm run dev` | Start Storybook dev server on port 6006 |
395
+ | `npm run build` | Build the component library for distribution |
396
+ | `npm run build-storybook` | Build a static Storybook site |
397
+ | `npm run build:tokens` | Generate CSS from design token JSON files |
398
+ | `npm run test` | Run the test suite |
399
+ | `npm run test:coverage` | Run tests with coverage report |
400
+ | `npm run test:watch` | Run tests in watch mode |
382
401
 
383
402
  ## Project structure
384
403
 
@@ -0,0 +1,48 @@
1
+ import { default as React } from 'react';
2
+ export interface RudiAppShellProps extends React.HTMLAttributes<HTMLDivElement> {
3
+ /** Controlled open state of the responsive sidebar drawer. */
4
+ isSidebarOpen?: boolean;
5
+ /** Called when the drawer requests an open-state change. */
6
+ onSidebarOpenChange?: (open: boolean) => void;
7
+ /** Initial open state when uncontrolled. */
8
+ defaultSidebarOpen?: boolean;
9
+ children: React.ReactNode;
10
+ className?: string;
11
+ }
12
+ export interface RudiAppShellSidebarProps extends React.HTMLAttributes<HTMLElement> {
13
+ /** Overrides the sidebar width (defaults to the app-shell token). */
14
+ width?: string;
15
+ 'aria-label'?: string;
16
+ children: React.ReactNode;
17
+ className?: string;
18
+ }
19
+ export interface RudiAppShellContentProps extends React.HTMLAttributes<HTMLDivElement> {
20
+ children: React.ReactNode;
21
+ className?: string;
22
+ }
23
+ export interface RudiAppShellMainProps extends React.HTMLAttributes<HTMLElement> {
24
+ /** Max width of the centered content column (defaults to the token). */
25
+ maxWidth?: string;
26
+ /** Padding around the content column (defaults to the token). */
27
+ padding?: string;
28
+ children: React.ReactNode;
29
+ className?: string;
30
+ }
31
+ export interface RudiAppShellMenuButtonProps {
32
+ 'aria-label'?: string;
33
+ /** Iconify icon name for the hamburger. */
34
+ icon?: string;
35
+ className?: string;
36
+ }
37
+ declare function AppShellSidebar({ width, className, style, children, 'aria-label': ariaLabel, ...props }: RudiAppShellSidebarProps): import("react/jsx-runtime").JSX.Element;
38
+ declare function AppShellContent({ className, children, ...props }: RudiAppShellContentProps): import("react/jsx-runtime").JSX.Element;
39
+ declare function AppShellMain({ maxWidth, padding, className, style, children, ...props }: RudiAppShellMainProps): import("react/jsx-runtime").JSX.Element;
40
+ declare function AppShellMenuButton({ 'aria-label': ariaLabel, icon, className, }: RudiAppShellMenuButtonProps): import("react/jsx-runtime").JSX.Element;
41
+ export declare const RudiAppShell: React.ForwardRefExoticComponent<RudiAppShellProps & React.RefAttributes<HTMLDivElement>> & {
42
+ Sidebar: typeof AppShellSidebar;
43
+ Content: typeof AppShellContent;
44
+ Main: typeof AppShellMain;
45
+ MenuButton: typeof AppShellMenuButton;
46
+ };
47
+ export {};
48
+ //# sourceMappingURL=AppShell.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0D,MAAM,OAAO,CAAA;AAI9E,OAAO,iBAAiB,CAAA;AAoBxB,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC7E,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,wBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACzC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,wBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACzC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA+CD,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,SAAS,EACT,KAAK,EACL,QAAQ,EACR,YAAY,EAAE,SAAqB,EACnC,GAAG,KAAK,EACT,EAAE,wBAAwB,2CAwB1B;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,wBAAwB,2CAM1B;AAED,iBAAS,YAAY,CAAC,EACpB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,qBAAqB,2CAcvB;AAED,iBAAS,kBAAkB,CAAC,EAC1B,YAAY,EAAE,SAA6B,EAC3C,IAAoB,EACpB,SAAS,GACV,EAAE,2BAA2B,2CAa7B;AAED,eAAO,MAAM,YAAY;;;;;CAKvB,CAAA"}
@@ -0,0 +1,14 @@
1
+ export interface RudiBreadcrumbItem {
2
+ label: string;
3
+ href?: string;
4
+ }
5
+ export interface RudiBreadcrumbProps {
6
+ items: RudiBreadcrumbItem[];
7
+ /** Iconify name for the separator between items. */
8
+ separator?: string;
9
+ /** Accessible label for the nav landmark. */
10
+ label?: string;
11
+ className?: string;
12
+ }
13
+ export declare function RudiBreadcrumb({ items, separator, label, className, }: RudiBreadcrumbProps): import("react/jsx-runtime").JSX.Element;
14
+ //# sourceMappingURL=Breadcrumb.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/Breadcrumb.tsx"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAA;AAEzB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,SAAkC,EAClC,KAAoB,EACpB,SAAS,GACV,EAAE,mBAAmB,2CAiCrB"}
@@ -1,5 +1,9 @@
1
1
  export interface RudiBarChartProps {
2
- data: Array<Record<string, string | number>>;
2
+ /**
3
+ * Row data. Values may be `null` to represent gaps in a series. Strongly-typed
4
+ * data objects are accepted directly — no cast required.
5
+ */
6
+ data: Array<Record<string, string | number | null>>;
3
7
  dataKeys: string[];
4
8
  indexKey: string;
5
9
  layout?: 'vertical' | 'horizontal';
@@ -1 +1 @@
1
- {"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/BarChart/BarChart.tsx"],"names":[],"mappings":"AAYA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAmB,EACnB,OAAe,EACf,UAAiB,EACjB,QAAe,EACf,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,iBAAiB,2CAiEnB"}
1
+ {"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/BarChart/BarChart.tsx"],"names":[],"mappings":"AAYA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAmB,EACnB,OAAe,EACf,UAAiB,EACjB,QAAe,EACf,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,iBAAiB,2CAiEnB"}
@@ -1,5 +1,10 @@
1
1
  export interface RudiLineChartProps {
2
- data: Array<Record<string, string | number>>;
2
+ /**
3
+ * Row data. Values may be `null` to represent gaps in a series (e.g. a
4
+ * burndown line that stops partway through the sprint). Strongly-typed data
5
+ * objects are accepted directly — no cast required.
6
+ */
7
+ data: Array<Record<string, string | number | null>>;
3
8
  dataKeys: string[];
4
9
  indexKey: string;
5
10
  curved?: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/LineChart/LineChart.tsx"],"names":[],"mappings":"AAYA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAA;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAa,EACb,QAAe,EACf,QAAe,EACf,UAAiB,EACjB,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,kBAAkB,2CA+CpB"}
1
+ {"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/LineChart/LineChart.tsx"],"names":[],"mappings":"AAYA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAa,EACb,QAAe,EACf,QAAe,EACf,UAAiB,EACjB,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,kBAAkB,2CA+CpB"}
@@ -0,0 +1,15 @@
1
+ import { ReactNode } from 'react';
2
+ export interface RudiDividerProps {
3
+ /** Layout direction of the rule. */
4
+ orientation?: 'horizontal' | 'vertical';
5
+ /** Margin applied on the block/inline axis around the rule. */
6
+ spacing?: 'none' | 'sm' | 'md' | 'lg';
7
+ /**
8
+ * Optional centered label. Only meaningful for a horizontal divider — it
9
+ * renders a rule / text / rule row instead of a bare line.
10
+ */
11
+ label?: ReactNode;
12
+ className?: string;
13
+ }
14
+ export declare function RudiDivider({ orientation, spacing, label, className, }: RudiDividerProps): import("react/jsx-runtime").JSX.Element;
15
+ //# sourceMappingURL=Divider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../../../src/components/Divider/Divider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAC1B,WAA0B,EAC1B,OAAc,EACd,KAAK,EACL,SAAS,GACV,EAAE,gBAAgB,2CA8BlB"}
@@ -0,0 +1,20 @@
1
+ export interface RudiDotProps {
2
+ /** Semantic color of the dot. Ignored when `color` is set. */
3
+ tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
4
+ /**
5
+ * Explicit color (any CSS color or design token, e.g.
6
+ * `var(--rudi-color-dataviz-3)`) for domain accents. Overrides `tone`.
7
+ */
8
+ color?: string;
9
+ size?: 'sm' | 'md' | 'lg';
10
+ /** Renders an animated halo to draw attention (e.g. "live"). */
11
+ pulse?: boolean;
12
+ /**
13
+ * Accessible label. When provided the dot is exposed as a status with
14
+ * visually-hidden text; otherwise it is decorative (`aria-hidden`).
15
+ */
16
+ label?: string;
17
+ className?: string;
18
+ }
19
+ export declare function RudiDot({ tone, color, size, pulse, label, className, }: RudiDotProps): import("react/jsx-runtime").JSX.Element;
20
+ //# sourceMappingURL=Dot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Dot.d.ts","sourceRoot":"","sources":["../../../src/components/Dot/Dot.tsx"],"names":[],"mappings":"AAEA,OAAO,WAAW,CAAA;AAElB,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IAC3D;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAgB,EAChB,KAAK,EACL,IAAW,EACX,KAAa,EACb,KAAK,EACL,SAAS,GACV,EAAE,YAAY,2CAqBd"}
@@ -0,0 +1,31 @@
1
+ import { default as React } from 'react';
2
+ export interface RudiFooterProps extends React.HTMLAttributes<HTMLElement> {
3
+ children: React.ReactNode;
4
+ className?: string;
5
+ }
6
+ export interface RudiFooterColumnsProps extends React.HTMLAttributes<HTMLDivElement> {
7
+ /** Minimum column width before wrapping (defaults to the footer token). */
8
+ minColumnWidth?: string;
9
+ children: React.ReactNode;
10
+ className?: string;
11
+ }
12
+ export interface RudiFooterColumnProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
13
+ /** Optional heading rendered above the column content. */
14
+ title?: React.ReactNode;
15
+ children?: React.ReactNode;
16
+ className?: string;
17
+ }
18
+ export interface RudiFooterBottomBarProps extends React.HTMLAttributes<HTMLDivElement> {
19
+ children: React.ReactNode;
20
+ className?: string;
21
+ }
22
+ declare function FooterColumns({ minColumnWidth, className, style, children, ...props }: RudiFooterColumnsProps): import("react/jsx-runtime").JSX.Element;
23
+ declare function FooterColumn({ title, className, children, ...props }: RudiFooterColumnProps): import("react/jsx-runtime").JSX.Element;
24
+ declare function FooterBottomBar({ className, children, ...props }: RudiFooterBottomBarProps): import("react/jsx-runtime").JSX.Element;
25
+ export declare const RudiFooter: React.ForwardRefExoticComponent<RudiFooterProps & React.RefAttributes<HTMLElement>> & {
26
+ Columns: typeof FooterColumns;
27
+ Column: typeof FooterColumn;
28
+ BottomBar: typeof FooterBottomBar;
29
+ };
30
+ export {};
31
+ //# sourceMappingURL=Footer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Footer.d.ts","sourceRoot":"","sources":["../../../src/components/Footer/Footer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAEzC,OAAO,cAAc,CAAA;AAErB,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC;IACxE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,sBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC3D,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,wBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAaD,iBAAS,aAAa,CAAC,EACrB,cAAc,EACd,SAAS,EACT,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,sBAAsB,2CAaxB;AAED,iBAAS,YAAY,CAAC,EACpB,KAAK,EACL,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,qBAAqB,2CASvB;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,wBAAwB,2CAM1B;AAED,eAAO,MAAM,UAAU;;;;CAIrB,CAAA"}
@@ -0,0 +1,18 @@
1
+ import { CSSProperties, ReactNode } from 'react';
2
+ export interface RudiImageProps {
3
+ src: string;
4
+ alt: string;
5
+ /** CSS aspect ratio for the frame, e.g. `'16 / 9'`, `'1 / 1'`, `'4 / 3'`. */
6
+ aspectRatio?: CSSProperties['aspectRatio'];
7
+ fit?: 'cover' | 'contain';
8
+ radius?: 'none' | 'sm' | 'md' | 'lg' | 'full';
9
+ loading?: 'lazy' | 'eager';
10
+ /**
11
+ * Content layered over the image (badges, wishlist button, gradient scrim,
12
+ * duotone wash). Rendered in a positioned layer above the picture.
13
+ */
14
+ overlay?: ReactNode;
15
+ className?: string;
16
+ }
17
+ export declare function RudiImage({ src, alt, aspectRatio, fit, radius, loading, overlay, className, }: RudiImageProps): import("react/jsx-runtime").JSX.Element;
18
+ //# sourceMappingURL=Image.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../src/components/Image/Image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,aAAa,CAAA;AAEpB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,6EAA6E;IAC7E,WAAW,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAC1C,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,SAAS,CAAC,EACxB,GAAG,EACH,GAAG,EACH,WAAW,EACX,GAAa,EACb,MAAa,EACb,OAAgB,EAChB,OAAO,EACP,SAAS,GACV,EAAE,cAAc,2CAehB"}
@@ -0,0 +1,16 @@
1
+ import { default as React } from 'react';
2
+ export interface RudiLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
3
+ href: string;
4
+ /**
5
+ * `default` — inherits weight, brand color; `subtle` — muted until hover;
6
+ * `standalone` — a self-contained link (e.g. "Learn more") with an inline icon slot.
7
+ */
8
+ variant?: 'default' | 'subtle' | 'standalone';
9
+ underline?: 'always' | 'hover' | 'none';
10
+ /** Opens in a new tab with safe `rel` and appends an external-link icon. */
11
+ external?: boolean;
12
+ children: React.ReactNode;
13
+ className?: string;
14
+ }
15
+ export declare const RudiLink: React.ForwardRefExoticComponent<RudiLinkProps & React.RefAttributes<HTMLAnchorElement>>;
16
+ //# sourceMappingURL=Link.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/components/Link/Link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,YAAY,CAAA;AAEnB,MAAM,WAAW,aACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAA;IAC7C,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,QAAQ,yFAyCpB,CAAA"}
@@ -1,6 +1,15 @@
1
+ import { ReactNode } from 'react';
1
2
  import { MenuItemProps as AriaMenuItemProps } from 'react-aria-components';
2
3
  export interface RudiMenuItemProps extends AriaMenuItemProps {
3
4
  isDestructive?: boolean;
5
+ /** Iconify icon name rendered before the label. */
6
+ icon?: string;
7
+ /** Primary text. When set, content is composed for you (no need to pass children). */
8
+ label?: string;
9
+ /** Secondary text shown beneath the label. */
10
+ description?: ReactNode;
11
+ /** Keyboard shortcut hint shown at the trailing edge. */
12
+ shortcut?: ReactNode;
4
13
  }
5
- export declare function RudiMenuItem({ isDestructive, className, ...props }: RudiMenuItemProps): import("react/jsx-runtime").JSX.Element;
14
+ export declare function RudiMenuItem({ isDestructive, icon, label, description, shortcut, className, textValue, children, ...props }: RudiMenuItemProps): import("react/jsx-runtime").JSX.Element;
6
15
  //# sourceMappingURL=MenuItem.d.ts.map