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.
- package/README.md +119 -100
- package/dist/components/AppShell/AppShell.d.ts +48 -0
- package/dist/components/AppShell/AppShell.d.ts.map +1 -0
- package/dist/components/Breadcrumb/Breadcrumb.d.ts +14 -0
- package/dist/components/Breadcrumb/Breadcrumb.d.ts.map +1 -0
- package/dist/components/Charts/BarChart/BarChart.d.ts +5 -1
- package/dist/components/Charts/BarChart/BarChart.d.ts.map +1 -1
- package/dist/components/Charts/LineChart/LineChart.d.ts +6 -1
- package/dist/components/Charts/LineChart/LineChart.d.ts.map +1 -1
- package/dist/components/Divider/Divider.d.ts +15 -0
- package/dist/components/Divider/Divider.d.ts.map +1 -0
- package/dist/components/Dot/Dot.d.ts +20 -0
- package/dist/components/Dot/Dot.d.ts.map +1 -0
- package/dist/components/Footer/Footer.d.ts +31 -0
- package/dist/components/Footer/Footer.d.ts.map +1 -0
- package/dist/components/Image/Image.d.ts +18 -0
- package/dist/components/Image/Image.d.ts.map +1 -0
- package/dist/components/Link/Link.d.ts +16 -0
- package/dist/components/Link/Link.d.ts.map +1 -0
- package/dist/components/Menu/MenuItem.d.ts +10 -1
- package/dist/components/Menu/MenuItem.d.ts.map +1 -1
- package/dist/components/Menu/MenuSeparator.d.ts +5 -0
- package/dist/components/Menu/MenuSeparator.d.ts.map +1 -0
- package/dist/components/Menu/SubmenuTrigger.d.ts +5 -0
- package/dist/components/Menu/SubmenuTrigger.d.ts.map +1 -0
- package/dist/components/PageHeader/PageHeader.d.ts +12 -0
- package/dist/components/PageHeader/PageHeader.d.ts.map +1 -0
- package/dist/components/Pagination/Pagination.d.ts +14 -0
- package/dist/components/Pagination/Pagination.d.ts.map +1 -0
- package/dist/components/ProgressBar/ProgressBar.d.ts +14 -2
- package/dist/components/ProgressBar/ProgressBar.d.ts.map +1 -1
- package/dist/components/Rating/Rating.d.ts +18 -0
- package/dist/components/Rating/Rating.d.ts.map +1 -0
- package/dist/components/SectionHeader/SectionHeader.d.ts +12 -0
- package/dist/components/SectionHeader/SectionHeader.d.ts.map +1 -0
- package/dist/components/Select/Option.d.ts +3 -0
- package/dist/components/Select/Option.d.ts.map +1 -0
- package/dist/components/Stepper/Stepper.d.ts +17 -0
- package/dist/components/Stepper/Stepper.d.ts.map +1 -0
- package/dist/components/Textarea/Textarea.d.ts +17 -0
- package/dist/components/Textarea/Textarea.d.ts.map +1 -0
- package/dist/components/TopBar/TopBar.d.ts +18 -0
- package/dist/components/TopBar/TopBar.d.ts.map +1 -0
- package/dist/index.css +1 -1
- package/dist/index.d.ts +27 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1289 -810
- package/dist/typography/Heading/Heading.d.ts +9 -0
- package/dist/typography/Heading/Heading.d.ts.map +1 -1
- package/dist/typography/Text/Text.d.ts +11 -0
- package/dist/typography/Text/Text.d.ts.map +1 -1
- 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
|
|
10
|
-
|
|
11
|
-
| **UI Components**
|
|
12
|
-
| **Charts**
|
|
13
|
-
| **Kanban**
|
|
14
|
-
| **Typography**
|
|
15
|
-
| **Layout Primitives** | Box, Stack, Cluster, Grid, Sidebar, Center, Cover, Switcher
|
|
16
|
-
| **Page Examples**
|
|
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,
|
|
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
|
|
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
|
-
|
|
75
|
+
Eight themes ship in the stylesheet. Set `data-theme` on a root element to switch:
|
|
74
76
|
|
|
75
|
-
| Theme
|
|
76
|
-
|
|
77
|
-
| Default (light) |
|
|
78
|
-
| Dark
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
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 =
|
|
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;
|
|
115
|
-
--rudi-color-brand-primary: var(--rudi-color-neutral-900);
|
|
116
|
-
--rudi-component-button-primary-bg: var(
|
|
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
|
|
133
|
-
|
|
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
|
|
139
|
-
|
|
140
|
-
| **Brand**
|
|
141
|
-
| **Surfaces** | `--rudi-color-background-surface`, `-raised`, `-sunken`, `-overlay`, `--rudi-color-background-disabled`, `-inverted`
|
|
142
|
-
| **Text**
|
|
143
|
-
| **Borders**
|
|
144
|
-
| **Feedback** | `--rudi-color-feedback-{error,success,warning,info}` each with `-surface`, `-border`, `-text`
|
|
145
|
-
| **Charts**
|
|
146
|
-
| **Spacing**
|
|
147
|
-
| **Radius**
|
|
148
|
-
| **Type**
|
|
149
|
-
| **Motion**
|
|
150
|
-
| **Layout**
|
|
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
|
|
184
|
-
|
|
185
|
-
| `Button`
|
|
186
|
-
| `IconButton` | `aria-label` **(required)**, `variant?` (`'secondary'`), `size?: 'sm' \| 'md' \| 'lg'` (`'md'`), `isLoading?`, `onPress?`; `children` is a single element
|
|
187
|
-
| `NavItem`
|
|
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
|
|
192
|
-
|
|
193
|
-
| `Input`
|
|
194
|
-
| `Checkbox`
|
|
195
|
-
| `CheckboxGroup` | `label` **(required)**, `description?`, `value?: string[]`, `defaultValue?`, `onChange?: (value: string[]) => void`, `errorMessage?`, `isDisabled?`
|
|
196
|
-
| `Switch`
|
|
197
|
-
| `Select`
|
|
198
|
-
| `RadioGroup`
|
|
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
|
|
220
|
-
|
|
221
|
-
| `Alert`
|
|
222
|
-
| `Badge`
|
|
223
|
-
| `Tag`
|
|
224
|
-
| `Avatar`
|
|
225
|
-
| `Icon`
|
|
226
|
-
| `ProgressBar`
|
|
227
|
-
| `CircularProgress` | same as ProgressBar plus `size?: 'sm' \| 'md' \| 'lg'` and `children?` for custom center content
|
|
228
|
-
| `StatCard`
|
|
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
|
|
235
|
-
|
|
236
|
-
| `Card`
|
|
237
|
-
| `Dialog`
|
|
238
|
-
| `TooltipTrigger` / `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"
|
|
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
|
|
276
|
-
|
|
277
|
-
| `Box`
|
|
278
|
-
| `Stack`
|
|
279
|
-
| `Cluster`
|
|
280
|
-
| `Grid`
|
|
281
|
-
| `Sidebar`
|
|
282
|
-
| `Center`
|
|
283
|
-
| `Cover`
|
|
284
|
-
| `Switcher` | `threshold?`, `space?`
|
|
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`
|
|
307
|
-
| `Prose`
|
|
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
|
|
316
|
-
|
|
317
|
-
| `BarChart`
|
|
318
|
-
| `LineChart`
|
|
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
|
-
|
|
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
|
|
374
|
-
|
|
375
|
-
| `npm run dev`
|
|
376
|
-
| `npm run build`
|
|
377
|
-
| `npm run build-storybook` | Build a static Storybook site
|
|
378
|
-
| `npm run build:tokens`
|
|
379
|
-
| `npm run test`
|
|
380
|
-
| `npm run test:coverage`
|
|
381
|
-
| `npm run test:watch`
|
|
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
|
-
|
|
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;
|
|
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
|
-
|
|
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;
|
|
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
|