rudiment-ui 0.3.0 → 0.4.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/LICENSE +1 -1
- package/README.md +142 -99
- package/dist/components/AppShell/AppShell.d.ts.map +1 -1
- package/dist/components/Brand/Brand.d.ts +16 -0
- package/dist/components/Brand/Brand.d.ts.map +1 -0
- package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -1
- package/dist/components/Charts/BarChart/BarChart.d.ts.map +1 -1
- package/dist/components/Charts/DonutChart/DonutChart.d.ts.map +1 -1
- package/dist/components/Charts/LineChart/LineChart.d.ts +12 -1
- package/dist/components/Charts/LineChart/LineChart.d.ts.map +1 -1
- package/dist/components/Checkbox/Checkbox.d.ts +7 -0
- package/dist/components/Checkbox/Checkbox.d.ts.map +1 -1
- package/dist/components/Checkbox/CheckboxGroup.d.ts.map +1 -1
- package/dist/components/Checkbox/CheckboxGroupContext.d.ts +4 -0
- package/dist/components/Checkbox/CheckboxGroupContext.d.ts.map +1 -0
- package/dist/components/ComboBox/ComboBox.d.ts +41 -0
- package/dist/components/ComboBox/ComboBox.d.ts.map +1 -0
- package/dist/components/DatePicker/CalendarParts.d.ts +21 -0
- package/dist/components/DatePicker/CalendarParts.d.ts.map +1 -0
- package/dist/components/DatePicker/DatePicker.d.ts +34 -0
- package/dist/components/DatePicker/DatePicker.d.ts.map +1 -0
- package/dist/components/DatePicker/DateRangePicker.d.ts +33 -0
- package/dist/components/DatePicker/DateRangePicker.d.ts.map +1 -0
- package/dist/components/DatePicker/dateUtils.d.ts +14 -0
- package/dist/components/DatePicker/dateUtils.d.ts.map +1 -0
- package/dist/components/Dialog/Dialog.d.ts +11 -1
- package/dist/components/Dialog/Dialog.d.ts.map +1 -1
- package/dist/components/EmptyState/EmptyState.d.ts +18 -0
- package/dist/components/EmptyState/EmptyState.d.ts.map +1 -0
- package/dist/components/Form/Form.d.ts +17 -0
- package/dist/components/Form/Form.d.ts.map +1 -0
- package/dist/components/Input/Input.d.ts +11 -0
- package/dist/components/Input/Input.d.ts.map +1 -1
- package/dist/components/Kanban/KanbanBoard.d.ts +3 -1
- package/dist/components/Kanban/KanbanBoard.d.ts.map +1 -1
- package/dist/components/Kanban/KanbanCard.d.ts +6 -1
- package/dist/components/Kanban/KanbanCard.d.ts.map +1 -1
- package/dist/components/Link/Link.d.ts.map +1 -1
- package/dist/components/NavItem/NavItem.d.ts.map +1 -1
- package/dist/components/NumberField/NumberField.d.ts +37 -0
- package/dist/components/NumberField/NumberField.d.ts.map +1 -0
- package/dist/components/RadioGroup/Radio.d.ts +15 -0
- package/dist/components/RadioGroup/Radio.d.ts.map +1 -0
- package/dist/components/RadioGroup/RadioGroup.d.ts.map +1 -1
- package/dist/components/RouterProvider/RouterProvider.d.ts +15 -0
- package/dist/components/RouterProvider/RouterProvider.d.ts.map +1 -0
- package/dist/components/Switch/Switch.d.ts +5 -1
- package/dist/components/Switch/Switch.d.ts.map +1 -1
- package/dist/components/Table/Table.d.ts +30 -0
- package/dist/components/Table/Table.d.ts.map +1 -0
- package/dist/components/Table/TableBody.d.ts +10 -0
- package/dist/components/Table/TableBody.d.ts.map +1 -0
- package/dist/components/Table/TableCell.d.ts +11 -0
- package/dist/components/Table/TableCell.d.ts.map +1 -0
- package/dist/components/Table/TableColumn.d.ts +15 -0
- package/dist/components/Table/TableColumn.d.ts.map +1 -0
- package/dist/components/Table/TableHeader.d.ts +10 -0
- package/dist/components/Table/TableHeader.d.ts.map +1 -0
- package/dist/components/Table/TableRow.d.ts +10 -0
- package/dist/components/Table/TableRow.d.ts.map +1 -0
- package/dist/components/Table/TableSelectionCheckbox.d.ts +3 -0
- package/dist/components/Table/TableSelectionCheckbox.d.ts.map +1 -0
- package/dist/components/Tabs/Tab.d.ts +15 -0
- package/dist/components/Tabs/Tab.d.ts.map +1 -0
- package/dist/components/Tabs/TabList.d.ts +10 -0
- package/dist/components/Tabs/TabList.d.ts.map +1 -0
- package/dist/components/Tabs/TabPanel.d.ts +8 -0
- package/dist/components/Tabs/TabPanel.d.ts.map +1 -0
- package/dist/components/Tabs/Tabs.d.ts +15 -0
- package/dist/components/Tabs/Tabs.d.ts.map +1 -0
- package/dist/components/Toast/Toast.d.ts +15 -0
- package/dist/components/Toast/Toast.d.ts.map +1 -0
- package/dist/components/Toast/toastQueue.d.ts +40 -0
- package/dist/components/Toast/toastQueue.d.ts.map +1 -0
- package/dist/hooks/useChartTheme.d.ts +2 -0
- package/dist/hooks/useChartTheme.d.ts.map +1 -1
- package/dist/index.css +1 -1
- package/dist/index.d.ts +52 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2109 -993
- package/dist/layouts/Box/Box.d.ts +2 -0
- package/dist/layouts/Box/Box.d.ts.map +1 -1
- package/dist/layouts/Cover/Cover.d.ts +7 -1
- package/dist/layouts/Cover/Cover.d.ts.map +1 -1
- package/package.json +9 -4
- package/styles.d.ts +3 -0
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -68,7 +68,7 @@ Every export is marked `"use client"`, so the package can be imported directly i
|
|
|
68
68
|
import 'rudiment-ui/styles'
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
That single import is the whole setup. There is no provider to mount — `
|
|
71
|
+
That single import is the whole setup. There is no provider to mount — `RudiDialog` portals itself, and `useChartTheme` reads tokens straight off `document.documentElement`.
|
|
72
72
|
|
|
73
73
|
## Themes
|
|
74
74
|
|
|
@@ -109,14 +109,9 @@ function applyTheme(theme: Theme) {
|
|
|
109
109
|
|
|
110
110
|
Themes are scoped by attribute rather than element, so you can theme a subtree — a dark sidebar inside a light page — by putting `data-theme` on any wrapper.
|
|
111
111
|
|
|
112
|
-
|
|
112
|
+
For OS-driven dark mode, set `data-theme="auto"`: it applies the dark tokens when the system prefers dark and the default tokens otherwise, in pure CSS.
|
|
113
113
|
|
|
114
|
-
|
|
115
|
-
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches
|
|
116
|
-
applyTheme(prefersDark ? 'dark' : 'default')
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
Charts follow theme changes automatically — `useChartTheme` watches `data-theme` on `<html>` with a `MutationObserver` and re-resolves its colors.
|
|
114
|
+
Charts follow theme changes automatically: `useChartTheme` re-resolves its colors when `data-theme` on `<html>` changes or the OS color scheme flips.
|
|
120
115
|
|
|
121
116
|
## Tokens
|
|
122
117
|
|
|
@@ -172,27 +167,27 @@ Component-level tokens (`--rudi-component-*`) are available for surgical changes
|
|
|
172
167
|
## Components
|
|
173
168
|
|
|
174
169
|
```tsx
|
|
175
|
-
import {
|
|
170
|
+
import { RudiButton, RudiInput, RudiStack } from 'rudiment-ui'
|
|
176
171
|
|
|
177
172
|
function LoginForm() {
|
|
178
173
|
return (
|
|
179
|
-
<
|
|
180
|
-
<
|
|
181
|
-
<
|
|
182
|
-
<
|
|
183
|
-
</
|
|
174
|
+
<RudiStack space="1.5rem">
|
|
175
|
+
<RudiInput label="Email" type="email" />
|
|
176
|
+
<RudiInput label="Password" type="password" />
|
|
177
|
+
<RudiButton variant="primary">Sign in</RudiButton>
|
|
178
|
+
</RudiStack>
|
|
184
179
|
)
|
|
185
180
|
}
|
|
186
181
|
```
|
|
187
182
|
|
|
188
183
|
### Conventions worth knowing up front
|
|
189
184
|
|
|
190
|
-
- **`onPress`, not `onClick`.** `
|
|
191
|
-
- **`onChange` gives you a value, not an event.** `
|
|
192
|
-
- **Labels are required props, not children.** `
|
|
185
|
+
- **`onPress`, not `onClick`.** `RudiButton`, `RudiIconButton`, `RudiTag`, and `RudiNavItem` are built on React Aria and take `onPress`. React Aria handles pointer, touch, and keyboard activation in one event.
|
|
186
|
+
- **`onChange` gives you a value, not an event.** `RudiInput` calls `onChange(value: string)`, `RudiCheckbox` calls `onChange(isSelected: boolean)`, `RudiCheckboxGroup` calls `onChange(value: string[])`.
|
|
187
|
+
- **Labels are required props, not children.** `RudiInput`, `RudiSelect`, `RudiRadioGroup`, `RudiCheckboxGroup`, `RudiProgressBar`, and the charts all take `label` as a string — it wires up the accessible name for you.
|
|
193
188
|
- **Icons are Iconify names.** Any prop typed as an icon takes a `"collection:name"` string, e.g. `icon="mdi:close"`. No icon imports needed.
|
|
194
189
|
- **`className` is merged, not replaced** — every component runs it through `clsx` + `tailwind-merge`. `cn` is exported if you want the same helper.
|
|
195
|
-
- **Layout primitives are polymorphic and spread props**; components are not. `
|
|
190
|
+
- **Layout primitives are polymorphic and spread props**; components are not. `RudiStack`, `RudiBox`, `RudiText` etc. accept `as` plus any DOM attribute. `RudiButton`, `RudiCard`, `RudiAlert` have closed prop interfaces.
|
|
196
191
|
|
|
197
192
|
### Component reference
|
|
198
193
|
|
|
@@ -200,26 +195,30 @@ function LoginForm() {
|
|
|
200
195
|
|
|
201
196
|
| Component | Props |
|
|
202
197
|
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
203
|
-
| `
|
|
204
|
-
| `
|
|
205
|
-
| `
|
|
198
|
+
| `RudiButton` | `variant?: 'primary' \| 'secondary' \| 'destructive' \| 'ghost'` (`'primary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `iconBefore?`, `iconAfter?`, `onPress?`, `isDisabled?` |
|
|
199
|
+
| `RudiIconButton` | `aria-label` **(required)**, `variant?` (`'secondary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `onPress?`; `children` is a single element |
|
|
200
|
+
| `RudiNavItem` | `label` **(required)**, `icon?`, `isActive?`, `href?` (renders `<a>`, else `<button>`), `onPress?`, `badge?`, `isDisabled?` |
|
|
206
201
|
|
|
207
202
|
**Forms**
|
|
208
203
|
|
|
209
204
|
| Component | Props |
|
|
210
205
|
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
211
|
-
| `
|
|
212
|
-
| `
|
|
213
|
-
| `
|
|
214
|
-
| `
|
|
215
|
-
| `
|
|
216
|
-
| `
|
|
217
|
-
|
|
218
|
-
`
|
|
206
|
+
| `RudiInput` | `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`, `onBlur?`, `name?`, `autoComplete?`, `inputMode?`, `maxLength?`, `isReadOnly?`, `autoFocus?` |
|
|
207
|
+
| `RudiNumberField` | `label` **(required)**, `value?` / `defaultValue?: number \| null`, `onChange?: (value: number \| null) => void`, `minValue?`, `maxValue?`, `step?`, `formatOptions?: Intl.NumberFormatOptions`, `placeholder?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?`, `isReadOnly?`, `name?`, `hideStepper?` |
|
|
208
|
+
| `RudiDatePicker` | `label` **(required)**, `value?` / `defaultValue?: string \| null`, `onChange?: (value: string \| null) => void`, `granularity?: 'day' \| 'minute'` (`'day'`), `minValue?`, `maxValue?`, `isDateUnavailable?: (date: string) => boolean`, `hourCycle?: 12 \| 24`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?`, `isReadOnly?`, `name?` |
|
|
209
|
+
| `RudiDateRangePicker` | `label` **(required)**, `value?` / `defaultValue?: { start: string; end: string } \| null`, `onChange?`, `minValue?`, `maxValue?`, `isDateUnavailable?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?`, `isReadOnly?`, `startName?`, `endName?` |
|
|
210
|
+
| `RudiCheckbox` | `children` (label), `isSelected?`, `defaultSelected?`, `isIndeterminate?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?`, `value?` |
|
|
211
|
+
| `RudiCheckboxGroup` | `label` **(required)**, `description?`, `value?: string[]`, `defaultValue?`, `onChange?: (value: string[]) => void`, `errorMessage?`, `isDisabled?` |
|
|
212
|
+
| `RudiSwitch` | `children` (label), `isSelected?`, `defaultSelected?`, `onChange?: (isSelected: boolean) => void`, `isDisabled?` |
|
|
213
|
+
| `RudiSelect` | `label`, `items`, `children: (item) => ReactNode`, `selectedKey?`, `defaultSelectedKey?`, `onSelectionChange?: (key) => void`, `placeholder?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?` |
|
|
214
|
+
| `RudiComboBox` | `label`, `items`, `children: (item) => RudiOption`, `selectedKey?`, `defaultSelectedKey?`, `onSelectionChange?: (key) => void`, `inputValue?`, `onInputChange?`, `menuTrigger?`, `allowsCustomValue?`, `emptyMessage?`, `placeholder?`, `description?`, `errorMessage?`, `isRequired?`, `isDisabled?`, `name?` |
|
|
215
|
+
| `RudiRadio` | `value`, `children`, `isDisabled?` — must be rendered inside `RudiRadioGroup` |
|
|
216
|
+
| `RudiRadioGroup` | `label`, `orientation?: 'horizontal' \| 'vertical'`, `value?`, `defaultValue?`, `onChange?: (value: string) => void`, `errorMessage?`, `isDisabled?` |
|
|
217
|
+
|
|
218
|
+
`RudiSelect` renders its options from an `items` collection plus a render function that returns a `RudiOption` for each item:
|
|
219
219
|
|
|
220
220
|
```tsx
|
|
221
|
-
import {
|
|
222
|
-
import { Select } from 'rudiment-ui'
|
|
221
|
+
import { RudiSelect, RudiOption } from 'rudiment-ui'
|
|
223
222
|
|
|
224
223
|
const roles = [
|
|
225
224
|
{ id: 'viewer', label: 'Viewer' },
|
|
@@ -227,106 +226,150 @@ const roles = [
|
|
|
227
226
|
{ id: 'admin', label: 'Admin' },
|
|
228
227
|
]
|
|
229
228
|
|
|
230
|
-
<
|
|
231
|
-
{(item) => <
|
|
232
|
-
</
|
|
229
|
+
<RudiSelect label="Role" items={roles} placeholder="Choose a role" onSelectionChange={setRole}>
|
|
230
|
+
{(item) => <RudiOption key={item.id}>{item.label}</RudiOption>}
|
|
231
|
+
</RudiSelect>
|
|
233
232
|
```
|
|
234
233
|
|
|
235
234
|
**Feedback & display**
|
|
236
235
|
|
|
237
236
|
| Component | Props |
|
|
238
237
|
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
239
|
-
| `
|
|
240
|
-
| `
|
|
241
|
-
| `
|
|
242
|
-
| `
|
|
243
|
-
| `
|
|
244
|
-
| `
|
|
245
|
-
| `
|
|
246
|
-
| `
|
|
238
|
+
| `RudiAlert` | `variant: 'info' \| 'success' \| 'warning' \| 'error'` **(required)**, `title?`, `icon?`, `isPolite?` (`role="status"` instead of `"alert"`), `dismissible?`, `onDismiss?` |
|
|
239
|
+
| `RudiBadge` | `variant?: 'default' \| 'success' \| 'warning' \| 'error' \| 'info'` (`'default'`), `size?: 'sm' \| 'md'` (`'md'`), `dot?` (hides children) |
|
|
240
|
+
| `RudiTag` | `variant?` (as Badge), `dismissible?`, `onDismiss?`, `onPress?` (switches root to `<button>`), `isDisabled?` |
|
|
241
|
+
| `RudiAvatar` | `src?`, `alt?`, `name?` (derives initials), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `status?: 'success' \| 'warning' \| 'error' \| 'info'` |
|
|
242
|
+
| `RudiIcon` | `icon` **(required)**, `size?: 'sm' \| 'md' \| 'lg' \| number` (`'md'`), `color?`, `label?` (sets `role="img"`; without it the icon is `aria-hidden`) |
|
|
243
|
+
| `RudiProgressBar` | `value` + `label` **(required)**, `minValue?` (`0`), `maxValue?` (`100`), `showValueLabel?`, `variant?: 'default' \| 'success' \| 'warning' \| 'error'`, `size?: 'sm' \| 'md'` |
|
|
244
|
+
| `RudiCircularProgress` | same as ProgressBar plus `size?: 'sm' \| 'md' \| 'lg'` and `children?` for custom center content |
|
|
245
|
+
| `RudiStatCard` | `label`, `value: string \| number`, `delta?: string`, `trend?: 'up' \| 'down' \| 'neutral'` (`'neutral'`), `children?` |
|
|
247
246
|
|
|
248
|
-
`
|
|
247
|
+
`RudiAlert` and `RudiTag` 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.
|
|
249
248
|
|
|
250
249
|
**Containers & overlays**
|
|
251
250
|
|
|
252
251
|
| Component | Props |
|
|
253
252
|
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
254
|
-
| `
|
|
255
|
-
| `
|
|
256
|
-
| `
|
|
257
|
-
| `
|
|
253
|
+
| `RudiCard` | `variant?: 'default' \| 'outlined' \| 'elevated'` (`'default'`), `padding?: 'none' \| 'sm' \| 'md' \| 'lg'` (`'md'`) |
|
|
254
|
+
| `RudiDialog` | `isOpen`, `onClose`, `title` **(all required)**, `isDismissable?` (`true`, adds a close button), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`); part `RudiDialog.Footer` for actions |
|
|
255
|
+
| `RudiTooltipTrigger` / `RudiTooltip` | `delay?` (`500`ms), `closeDelay?` (`0`ms); children must be exactly `[trigger, tooltip]` |
|
|
256
|
+
| `RudiMenuTrigger` / `RudiMenu` / `RudiMenuItem` / `RudiMenuSection` / `RudiKeyboard` | React Aria menu primitives; `RudiMenuItem` adds `isDestructive?` |
|
|
258
257
|
|
|
259
|
-
`
|
|
258
|
+
`RudiCard` is compound — use the dot subcomponents:
|
|
260
259
|
|
|
261
260
|
```tsx
|
|
262
|
-
<
|
|
263
|
-
<
|
|
264
|
-
<
|
|
265
|
-
<
|
|
266
|
-
</
|
|
261
|
+
<RudiCard variant="elevated" padding="lg">
|
|
262
|
+
<RudiCard.Header>Monthly revenue</RudiCard.Header>
|
|
263
|
+
<RudiCard.Body>…</RudiCard.Body>
|
|
264
|
+
<RudiCard.Footer>…</RudiCard.Footer>
|
|
265
|
+
</RudiCard>
|
|
267
266
|
```
|
|
268
267
|
|
|
269
|
-
`
|
|
268
|
+
`RudiDialog` is fully controlled — it has no internal open state:
|
|
270
269
|
|
|
271
270
|
```tsx
|
|
272
271
|
const [isOpen, setIsOpen] = useState(false)
|
|
273
272
|
|
|
274
|
-
<
|
|
275
|
-
<
|
|
276
|
-
<
|
|
277
|
-
</
|
|
273
|
+
<RudiButton onPress={() => setIsOpen(true)}>Delete account</RudiButton>
|
|
274
|
+
<RudiDialog isOpen={isOpen} onClose={() => setIsOpen(false)} title="Are you sure?" size="sm">
|
|
275
|
+
<RudiButton variant="destructive" onPress={confirmDelete}>Delete</RudiButton>
|
|
276
|
+
</RudiDialog>
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
`RudiTooltipTrigger` takes exactly two children, in order:
|
|
280
|
+
|
|
281
|
+
```tsx
|
|
282
|
+
<RudiTooltipTrigger>
|
|
283
|
+
<RudiIconButton aria-label="Delete">
|
|
284
|
+
<RudiIcon icon="mdi:trash-can" />
|
|
285
|
+
</RudiIconButton>
|
|
286
|
+
<RudiTooltip>Delete this item</RudiTooltip>
|
|
287
|
+
</RudiTooltipTrigger>
|
|
278
288
|
```
|
|
279
289
|
|
|
280
|
-
|
|
290
|
+
**App chrome**
|
|
291
|
+
|
|
292
|
+
| Component | Key props |
|
|
293
|
+
| ------------------- | --------- |
|
|
294
|
+
| `RudiForm` | `onSubmit?: (data: FormData, event) => void`, `errors?: string[]` (shows and focuses a summary), `errorTitle?` |
|
|
295
|
+
| `RudiAppShell` | `isSidebarOpen?`, `onSidebarOpenChange?`, `defaultSidebarOpen?`; parts `.Sidebar` (`width?`, `aria-label?`), `.Content`, `.Main` (`maxWidth?`, `padding?`), `.MenuButton` |
|
|
296
|
+
| `RudiTopBar` | `start?`, `end?`, `children` (center), `announcement?`, `sticky?` (`true`), `as?` (`'header'`) |
|
|
297
|
+
| `RudiPageHeader` | `title` **(required)**, `subtitle?`, `actions?`, `headingLevel?` (`1`) |
|
|
298
|
+
| `RudiBrand` | `name` **(required)**, `mark?`, `hideName?`, `href?`, `size?: 'sm' \| 'md' \| 'lg'` (`'md'`) |
|
|
299
|
+
| `RudiSectionHeader` | `title` **(required)**, `description?`, `action?`, `headingLevel?` (`2`) |
|
|
300
|
+
| `RudiTabs` | `selectedKey?`, `defaultSelectedKey?`, `onSelectionChange?`, `orientation?: 'horizontal' \| 'vertical'` (`'horizontal'`), `disabledKeys?`, `keyboardActivation?` |
|
|
301
|
+
| `RudiTabList` | `aria-label` **(required)**, `variant?: 'underline' \| 'pill'` (`'underline'`) |
|
|
302
|
+
| `RudiTab` | `id` **(required)**, `children` (label), `icon?`, `badge?`, `href?`, `isDisabled?` |
|
|
303
|
+
| `RudiTabPanel` | `id` **(required, matches its tab)**, `shouldForceMount?` |
|
|
304
|
+
| `RudiToastRegion` | `placement?: 'top-end' \| 'bottom-end' \| 'bottom-center'`, `aria-label?`; queue with `rudiToast.success(title, { description?, timeout?, onClose? })` (and `info`, `warning`, `error`), `.add({...})`, `.close(key)` |
|
|
305
|
+
| `RudiEmptyState` | `title` **(required)**, `icon?`, `description?`, `action?`, `headingLevel?: 2–6` (`3`), `size?: 'sm' \| 'md'` (`'md'`) |
|
|
306
|
+
| `RudiTable` (+ `Header`, `Column`, `Body`, `Row`, `Cell` parts) | `aria-label` **(required)**, `density?: 'compact' \| 'regular'`, `striped?`, `stickyHeader?`, `maxHeight?`, `sortDescriptor?`, `onSortChange?`, `onRowAction?`, `selectionMode?`; columns take `align?`, `allowsSorting?`, `isRowHeader?`, `width?`, `minWidth?`; rows take `href?`; body takes `renderEmptyState?` |
|
|
281
307
|
|
|
282
308
|
```tsx
|
|
283
|
-
<
|
|
284
|
-
<
|
|
285
|
-
<
|
|
286
|
-
</
|
|
287
|
-
<
|
|
288
|
-
|
|
309
|
+
<RudiAppShell>
|
|
310
|
+
<RudiAppShell.Sidebar aria-label="Main navigation">
|
|
311
|
+
<RudiNavItem label="Shipments" icon="lucide:package" href="/shipments" isActive />
|
|
312
|
+
</RudiAppShell.Sidebar>
|
|
313
|
+
<RudiAppShell.Content>
|
|
314
|
+
<RudiTopBar start={<RudiAppShell.MenuButton />} end={<RudiAvatar name="Ada Admin" />} />
|
|
315
|
+
<RudiAppShell.Main>
|
|
316
|
+
<RudiPageHeader title="Shipments" actions={<RudiButton>New shipment</RudiButton>} />
|
|
317
|
+
</RudiAppShell.Main>
|
|
318
|
+
</RudiAppShell.Content>
|
|
319
|
+
</RudiAppShell>
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
**Routing.** In a single-page app, wrap the tree in `RudiRouterProvider` so Rudi links navigate client-side:
|
|
323
|
+
|
|
324
|
+
```tsx
|
|
325
|
+
import { useHref, useNavigate } from 'react-router'
|
|
326
|
+
import { RudiRouterProvider } from 'rudiment-ui'
|
|
327
|
+
|
|
328
|
+
function Providers({ children }) {
|
|
329
|
+
const navigate = useNavigate()
|
|
330
|
+
return <RudiRouterProvider navigate={navigate} useHref={useHref}>{children}</RudiRouterProvider>
|
|
331
|
+
}
|
|
289
332
|
```
|
|
290
333
|
|
|
291
334
|
## Layout primitives
|
|
292
335
|
|
|
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`); `
|
|
336
|
+
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`); `RudiBox` uses `padding`. All accept `as`, `className`, and any DOM attribute.
|
|
294
337
|
|
|
295
338
|
| Component | Props | Default |
|
|
296
339
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------- |
|
|
297
|
-
| `
|
|
298
|
-
| `
|
|
299
|
-
| `
|
|
300
|
-
| `
|
|
301
|
-
| `
|
|
302
|
-
| `
|
|
303
|
-
| `
|
|
304
|
-
| `
|
|
340
|
+
| `RudiBox` | `padding?`, `bordered?`, `invert?` | padding `1rem` |
|
|
341
|
+
| `RudiStack` | `space?`, `recursive?`, `splitAfter?: number` | space `1.5rem` |
|
|
342
|
+
| `RudiCluster` | `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` |
|
|
343
|
+
| `RudiGrid` | `minCellWidth?`, `space?` | min cell `15rem`, space `1.5rem` |
|
|
344
|
+
| `RudiSidebar` | `side?: 'left' \| 'right'`, `sideWidth?`, `contentMin?`, `space?`, `noStretch?` | side `left`, width `20rem`, content min `50%` |
|
|
345
|
+
| `RudiCenter` | `maxWidth?`, `gutters?`, `intrinsic?` | max width `60rem`, gutters `1rem` |
|
|
346
|
+
| `RudiCover` | `minHeight?`, `space?` | min height `100vh` |
|
|
347
|
+
| `RudiSwitcher` | `threshold?`, `space?` | threshold `30rem`, space `1.5rem` |
|
|
305
348
|
|
|
306
349
|
```tsx
|
|
307
|
-
<
|
|
350
|
+
<RudiSidebar side="left" sideWidth="16rem" space="2rem">
|
|
308
351
|
<nav>…</nav>
|
|
309
|
-
<
|
|
310
|
-
<
|
|
311
|
-
<
|
|
312
|
-
<
|
|
313
|
-
<
|
|
314
|
-
</
|
|
315
|
-
</
|
|
316
|
-
</
|
|
352
|
+
<RudiStack space="1.5rem">
|
|
353
|
+
<RudiHeading level={1}>Dashboard</RudiHeading>
|
|
354
|
+
<RudiGrid minCellWidth="18rem" space="1rem">
|
|
355
|
+
<RudiStatCard label="Revenue" value="$48.2k" delta="+12.5%" trend="up" />
|
|
356
|
+
<RudiStatCard label="Users" value="1,284" delta="+3.1%" trend="up" />
|
|
357
|
+
</RudiGrid>
|
|
358
|
+
</RudiStack>
|
|
359
|
+
</RudiSidebar>
|
|
317
360
|
```
|
|
318
361
|
|
|
319
|
-
`
|
|
362
|
+
`RudiStack` deserves a note: `recursive` applies the spacing to all nested descendants rather than direct children, and `splitAfter={n}` pushes everything after the nth child to the bottom — useful for pinning a footer inside a sidebar.
|
|
320
363
|
|
|
321
364
|
## Typography
|
|
322
365
|
|
|
323
366
|
| Component | Props |
|
|
324
367
|
| --------- | ---------------------------------------------------------------------------------------------- |
|
|
325
|
-
| `
|
|
326
|
-
| `
|
|
327
|
-
| `
|
|
368
|
+
| `RudiHeading` | `level: 1–6` **(required, sets the tag)**, `size?: 1–6` (visual size, defaults to `level`) |
|
|
369
|
+
| `RudiText` | `variant?: 'body' \| 'body-sm' \| 'caption' \| 'overline' \| 'code'` (`'body'`), `as?` (`'p'`) |
|
|
370
|
+
| `RudiProse` | `size?: 'sm' \| 'base' \| 'lg'` (`'base'`), `as?` (`'div'`) |
|
|
328
371
|
|
|
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. `
|
|
372
|
+
`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. `RudiProse` styles a block of unstyled HTML (CMS content, rendered Markdown).
|
|
330
373
|
|
|
331
374
|
## Charts
|
|
332
375
|
|
|
@@ -334,12 +377,12 @@ All three wrap Recharts, size themselves to their container, and require a `labe
|
|
|
334
377
|
|
|
335
378
|
| Component | Props |
|
|
336
379
|
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
337
|
-
| `
|
|
338
|
-
| `
|
|
339
|
-
| `
|
|
380
|
+
| `RudiBarChart` | `data`, `dataKeys: string[]`, `indexKey`, `label`, `layout?: 'vertical' \| 'horizontal'` (`'vertical'`), `stacked?`, `showLegend?` (`true`), `showGrid?` (`true`), `height?` (`300`) |
|
|
381
|
+
| `RudiLineChart` | `data`, `dataKeys`, `indexKey`, `label`, `curved?` (`true`), `showDots?` (`true`), `showGrid?`, `showLegend?`, `height?` |
|
|
382
|
+
| `RudiDonutChart` | `data: { name, value }[]`, `label`, `innerRadius?` (`60`), `showLabels?` (`false`), `showLegend?`, `height?` |
|
|
340
383
|
|
|
341
384
|
```tsx
|
|
342
|
-
<
|
|
385
|
+
<RudiBarChart
|
|
343
386
|
label="Revenue by month"
|
|
344
387
|
data={[
|
|
345
388
|
{ month: 'Jan', revenue: 4200, costs: 2400 },
|
|
@@ -351,18 +394,18 @@ All three wrap Recharts, size themselves to their container, and require a `labe
|
|
|
351
394
|
/>
|
|
352
395
|
```
|
|
353
396
|
|
|
354
|
-
Note that `
|
|
397
|
+
Note that `RudiBarChart`'s `layout` describes the bars, not the Recharts axis: the default `"vertical"` gives you vertical bars, and `"horizontal"` gives horizontal ones.
|
|
355
398
|
|
|
356
399
|
## Kanban
|
|
357
400
|
|
|
358
|
-
`
|
|
401
|
+
`RudiKanbanBoard` is fully controlled — it never mutates `columns`. Apply the move yourself in `onCardMove`:
|
|
359
402
|
|
|
360
403
|
```tsx
|
|
361
|
-
import {
|
|
362
|
-
;<
|
|
404
|
+
import { RudiKanbanBoard, RudiKanbanCard, type RudiKanbanCardMoveEvent } from 'rudiment-ui'
|
|
405
|
+
;<RudiKanbanBoard
|
|
363
406
|
columns={columns} // { id, title, items: { id, ... }[] }[]
|
|
364
|
-
renderCard={(item) => <
|
|
365
|
-
onCardMove={(e:
|
|
407
|
+
renderCard={(item) => <RudiKanbanCard id={item.id}>{item.title}</RudiKanbanCard>}
|
|
408
|
+
onCardMove={(e: RudiKanbanCardMoveEvent) => {
|
|
366
409
|
// e: { cardId, fromColumnId, toColumnId, fromIndex, toIndex }
|
|
367
410
|
setColumns((prev) => applyMove(prev, e))
|
|
368
411
|
}}
|
|
@@ -375,7 +418,7 @@ import { KanbanBoard, KanbanCard, type KanbanCardMoveEvent } from 'rudiment-ui'
|
|
|
375
418
|
|
|
376
419
|
**`useChartTheme()`** returns the resolved chart palette for the active theme — `{ colors, axisColor, gridColor, labelColor, legendColor, tooltipBg, tooltipText, tooltipBorder, chartBg }`. Use it to style custom Recharts compositions so they match the built-in charts. It's SSR-safe and re-resolves on theme change.
|
|
377
420
|
|
|
378
|
-
**`useLoadingButton(ariaProps, isLoading, ref)`** returns `{ buttonProps }` with disabled and `aria-busy` handled. Useful if you're building a custom button rather than using `
|
|
421
|
+
**`useLoadingButton(ariaProps, isLoading, ref)`** returns `{ buttonProps }` with disabled and `aria-busy` handled. Useful if you're building a custom button rather than using `RudiButton`.
|
|
379
422
|
|
|
380
423
|
## Customizing the tokens at source
|
|
381
424
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/components/AppShell/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoF,MAAM,OAAO,CAAA;AAIxG,OAAO,iBAAiB,CAAA;AAsBxB,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;AAiED,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,SAAS,EACT,KAAK,EACL,QAAQ,EACR,YAAY,EAAE,SAAqB,EACnC,GAAG,KAAK,EACT,EAAE,wBAAwB,2CAyB1B;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,2CAe7B;AAED,eAAO,MAAM,YAAY;;;;;CAKvB,CAAA"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
export interface RudiBrandProps {
|
|
3
|
+
/** Product or company name. Always the accessible name; visible unless `hideName`. */
|
|
4
|
+
name: string;
|
|
5
|
+
/** Logo mark (an icon, `<svg>` or `<img>`). Decorative: hidden from assistive tech. */
|
|
6
|
+
mark?: React.ReactNode;
|
|
7
|
+
/** Hide the visible name when the mark already includes the wordmark. */
|
|
8
|
+
hideName?: boolean;
|
|
9
|
+
/** Makes the lockup a link (usually home). Routes client-side under `RudiRouterProvider`. */
|
|
10
|
+
href?: string;
|
|
11
|
+
size?: 'sm' | 'md' | 'lg';
|
|
12
|
+
className?: string;
|
|
13
|
+
}
|
|
14
|
+
/** Logo lockup: a mark plus the product name, optionally linking home. */
|
|
15
|
+
export declare function RudiBrand({ name, mark, hideName, href, size, className }: RudiBrandProps): import("react/jsx-runtime").JSX.Element;
|
|
16
|
+
//# sourceMappingURL=Brand.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../../src/components/Brand/Brand.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiB,MAAM,OAAO,CAAA;AAGrC,OAAO,aAAa,CAAA;AAEpB,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAyBD,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAgB,EAAE,IAAI,EAAE,IAAW,EAAE,SAAS,EAAE,EAAE,cAAc,2CAUvG"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/Breadcrumb.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/Breadcrumb/Breadcrumb.tsx"],"names":[],"mappings":"AAIA,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;AAaD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,SAAkC,EAClC,KAAoB,EACpB,SAAS,GACV,EAAE,mBAAmB,2CA+BrB"}
|
|
@@ -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;;;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,
|
|
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,2CA8EnB"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"DonutChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/DonutChart/DonutChart.tsx"],"names":[],"mappings":"AAUA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,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,cAAc,CAAC,EAC7B,IAAI,EACJ,WAAgB,EAChB,UAAkB,EAClB,UAAiB,EACjB,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,
|
|
1
|
+
{"version":3,"file":"DonutChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/DonutChart/DonutChart.tsx"],"names":[],"mappings":"AAUA,OAAO,eAAe,CAAA;AAEtB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,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,cAAc,CAAC,EAC7B,IAAI,EACJ,WAAgB,EAChB,UAAkB,EAClB,UAAiB,EACjB,MAAY,EACZ,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,2CAiDrB"}
|
|
@@ -13,7 +13,18 @@ export interface RudiLineChartProps {
|
|
|
13
13
|
showLegend?: boolean;
|
|
14
14
|
height?: number;
|
|
15
15
|
label: string;
|
|
16
|
+
/** Horizontal guide lines, e.g. a temperature set-point or a target. */
|
|
17
|
+
referenceLines?: RudiChartReferenceLine[];
|
|
18
|
+
/** Y-axis range; use `'auto'` for either end. Keeps reference lines in view. */
|
|
19
|
+
yDomain?: [number | 'auto', number | 'auto'];
|
|
20
|
+
/** Unit suffix for y-axis ticks and tooltip values, e.g. `°C`. */
|
|
21
|
+
unit?: string;
|
|
16
22
|
className?: string;
|
|
17
23
|
}
|
|
18
|
-
export
|
|
24
|
+
export interface RudiChartReferenceLine {
|
|
25
|
+
y: number;
|
|
26
|
+
label: string;
|
|
27
|
+
tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
|
|
28
|
+
}
|
|
29
|
+
export declare function RudiLineChart({ data, dataKeys, indexKey, curved, showDots, showGrid, showLegend, height, label, referenceLines, yDomain, unit, className, }: RudiLineChartProps): import("react/jsx-runtime").JSX.Element;
|
|
19
30
|
//# sourceMappingURL=LineChart.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/LineChart/LineChart.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../../src/components/Charts/LineChart/LineChart.tsx"],"names":[],"mappings":"AAaA,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,wEAAwE;IACxE,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAA;IACzC,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IAC5C,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;CAC5D;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAa,EACb,QAAe,EACf,QAAe,EACf,UAAiB,EACjB,MAAY,EACZ,KAAK,EACL,cAAmB,EACnB,OAAO,EACP,IAAI,EACJ,SAAS,GACV,EAAE,kBAAkB,2CA6DpB"}
|
|
@@ -5,8 +5,15 @@ export interface RudiCheckboxProps {
|
|
|
5
5
|
isIndeterminate?: boolean;
|
|
6
6
|
onChange?: (isSelected: boolean) => void;
|
|
7
7
|
isDisabled?: boolean;
|
|
8
|
+
/** Required inside a RudiCheckboxGroup: the value added to the group's array when checked. */
|
|
8
9
|
value?: string;
|
|
10
|
+
/** Error shown under a standalone checkbox (e.g. an unaccepted agreement); marks it invalid. */
|
|
11
|
+
errorMessage?: string;
|
|
9
12
|
className?: string;
|
|
10
13
|
}
|
|
14
|
+
/**
|
|
15
|
+
* A checkbox. Inside a `RudiCheckboxGroup` it reads and updates the group's value (give it a `value`);
|
|
16
|
+
* on its own it's controlled with `isSelected` / `onChange`.
|
|
17
|
+
*/
|
|
11
18
|
export declare const RudiCheckbox: import('react').ForwardRefExoticComponent<RudiCheckboxProps & import('react').RefAttributes<HTMLInputElement>>;
|
|
12
19
|
//# sourceMappingURL=Checkbox.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/Checkbox.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/Checkbox.tsx"],"names":[],"mappings":"AAOA,OAAO,gBAAgB,CAAA;AAEvB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAmED;;;GAGG;AACH,eAAO,MAAM,YAAY,gHASxB,CAAA"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"CheckboxGroup.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/CheckboxGroup.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"CheckboxGroup.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/CheckboxGroup.tsx"],"names":[],"mappings":"AAIA,OAAO,gBAAgB,CAAA;AAEvB,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACpC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,2CAiC9D"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { CheckboxGroupState } from 'react-stately';
|
|
2
|
+
/** Shared by RudiCheckboxGroup and the RudiCheckbox items inside it. */
|
|
3
|
+
export declare const CheckboxGroupContext: import('react').Context<CheckboxGroupState | null>;
|
|
4
|
+
//# sourceMappingURL=CheckboxGroupContext.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CheckboxGroupContext.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/CheckboxGroupContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,oDAAiD,CAAA"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { ReactNode } from 'react';
|
|
2
|
+
import { Key } from 'react-aria';
|
|
3
|
+
export interface RudiComboBoxProps<T extends object> {
|
|
4
|
+
/** Visible label. Required for accessibility. */
|
|
5
|
+
label: string;
|
|
6
|
+
/** The options. Render each with `RudiOption`; give rich content a `textValue` so it can be filtered. */
|
|
7
|
+
items: Iterable<T>;
|
|
8
|
+
children: (item: T) => ReactNode;
|
|
9
|
+
/** The selected option key (controlled). */
|
|
10
|
+
selectedKey?: Key | null;
|
|
11
|
+
/** The initially selected option key (uncontrolled). */
|
|
12
|
+
defaultSelectedKey?: Key | null;
|
|
13
|
+
/** Called with the newly selected key, or `null` when the selection is cleared. */
|
|
14
|
+
onSelectionChange?: (key: Key | null) => void;
|
|
15
|
+
/** The text in the input (controlled). */
|
|
16
|
+
inputValue?: string;
|
|
17
|
+
/** The initial text in the input (uncontrolled). */
|
|
18
|
+
defaultInputValue?: string;
|
|
19
|
+
/** Called with the input text whenever it changes. */
|
|
20
|
+
onInputChange?: (value: string) => void;
|
|
21
|
+
placeholder?: string;
|
|
22
|
+
description?: string;
|
|
23
|
+
errorMessage?: string;
|
|
24
|
+
isRequired?: boolean;
|
|
25
|
+
isDisabled?: boolean;
|
|
26
|
+
/** Form field name. The input's text is submitted under this name. */
|
|
27
|
+
name?: string;
|
|
28
|
+
/** What opens the list: typing (`input`, default), focusing the field (`focus`), or only the arrow keys / chevron button (`manual`). */
|
|
29
|
+
menuTrigger?: 'focus' | 'input' | 'manual';
|
|
30
|
+
/** Keep typed text that matches no option instead of reverting to the selected option on blur. */
|
|
31
|
+
allowsCustomValue?: boolean;
|
|
32
|
+
/** Message shown in the popover when the typed text matches no option. */
|
|
33
|
+
emptyMessage?: string;
|
|
34
|
+
className?: string;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* A searchable select: a text input that filters a list of options.
|
|
38
|
+
* Options are `RudiOption` elements, the same as `RudiSelect`.
|
|
39
|
+
*/
|
|
40
|
+
export declare function RudiComboBox<T extends object>(props: RudiComboBoxProps<T>): import("react/jsx-runtime").JSX.Element;
|
|
41
|
+
//# sourceMappingURL=ComboBox.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ComboBox.d.ts","sourceRoot":"","sources":["../../../src/components/ComboBox/ComboBox.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAiB,SAAS,EAAa,MAAM,OAAO,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAGrC,OAAO,iBAAiB,CAAA;AAExB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACjD,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,yGAAyG;IACzG,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;IAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAA;IAChC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IACxB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,GAAG,GAAG,IAAI,CAAA;IAC/B,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,sDAAsD;IACtD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wIAAwI;IACxI,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC1C,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiFD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,2CAwGzE"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/** Month heading flanked by previous / next buttons. Shared by both calendars. */
|
|
2
|
+
export declare function RudiCalendarHeader(): import("react/jsx-runtime").JSX.Element;
|
|
3
|
+
/** Weekday header + day cells. Works inside `Calendar` and `RangeCalendar`. */
|
|
4
|
+
export declare function RudiCalendarMonth(): import("react/jsx-runtime").JSX.Element;
|
|
5
|
+
/** The calendar trigger button that sits at the end of the field. */
|
|
6
|
+
export declare function RudiCalendarTrigger(): import("react/jsx-runtime").JSX.Element;
|
|
7
|
+
interface FieldChromeProps {
|
|
8
|
+
label: string;
|
|
9
|
+
isRequired?: boolean;
|
|
10
|
+
}
|
|
11
|
+
/** Label with the same required asterisk treatment as `RudiInput`. */
|
|
12
|
+
export declare function RudiFieldLabel({ label, isRequired }: FieldChromeProps): import("react/jsx-runtime").JSX.Element;
|
|
13
|
+
interface FieldFooterProps {
|
|
14
|
+
description?: string;
|
|
15
|
+
errorMessage?: string;
|
|
16
|
+
isInvalid: boolean;
|
|
17
|
+
}
|
|
18
|
+
/** Description (hidden while invalid, as in `RudiInput`) and error text. */
|
|
19
|
+
export declare function RudiFieldFooter({ description, errorMessage, isInvalid, }: FieldFooterProps): import("react/jsx-runtime").JSX.Element;
|
|
20
|
+
export {};
|
|
21
|
+
//# sourceMappingURL=CalendarParts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CalendarParts.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/CalendarParts.tsx"],"names":[],"mappings":"AAaA,OAAO,mBAAmB,CAAA;AAE1B,kFAAkF;AAClF,wBAAgB,kBAAkB,4CAYjC;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,4CAiBhC;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,4CAMlC;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,gBAAgB,2CAYrE;AAED,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,YAAY,EACZ,SAAS,GACV,EAAE,gBAAgB,2CAalB"}
|