@whity/ui 0.0.0-stage → 1.0.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 +106 -2
- package/package.json +219 -4
- package/src/access-denied.stories.tsx +179 -0
- package/src/access-denied.tsx +305 -0
- package/src/action-proposal.tsx +338 -0
- package/src/actor-chip.tsx +71 -0
- package/src/agent-activity.tsx +163 -0
- package/src/agent-collaboration.stories.tsx +156 -0
- package/src/agent-run-status.tsx +196 -0
- package/src/alert-dialog.stories.tsx +45 -0
- package/src/alert-dialog.tsx +147 -0
- package/src/alert.stories.tsx +91 -0
- package/src/alert.tsx +89 -0
- package/src/app-sidebar.stories.tsx +195 -0
- package/src/app-sidebar.tsx +604 -0
- package/src/approval-queue.tsx +109 -0
- package/src/audience-group-picker.stories.tsx +198 -0
- package/src/audience-group-picker.tsx +362 -0
- package/src/audience-people-picker.stories.tsx +102 -0
- package/src/audience-people-picker.tsx +279 -0
- package/src/avatar-pattern.ts +138 -0
- package/src/avatar.tsx +125 -0
- package/src/badge.stories.tsx +105 -0
- package/src/badge.tsx +68 -0
- package/src/beta-warning.stories.tsx +79 -0
- package/src/beta-warning.tsx +189 -0
- package/src/bilingual-input.stories.tsx +82 -0
- package/src/bilingual-input.tsx +188 -0
- package/src/board.tsx +216 -0
- package/src/breadcrumb.stories.tsx +51 -0
- package/src/breadcrumb.tsx +90 -0
- package/src/built-on-whity.tsx +52 -0
- package/src/button.stories.tsx +87 -0
- package/src/button.tsx +123 -0
- package/src/card.stories.tsx +423 -0
- package/src/card.tsx +180 -0
- package/src/chart.stories.tsx +66 -0
- package/src/chart.tsx +228 -0
- package/src/checkbox.stories.tsx +62 -0
- package/src/checkbox.tsx +54 -0
- package/src/collapsible.stories.tsx +48 -0
- package/src/collapsible.tsx +34 -0
- package/src/color-card.stories.tsx +61 -0
- package/src/color-card.tsx +270 -0
- package/src/color-picker.stories.tsx +65 -0
- package/src/color-picker.tsx +425 -0
- package/src/column-matcher.tsx +84 -0
- package/src/command-palette.tsx +398 -0
- package/src/confirm-action.tsx +98 -0
- package/src/copy-block.stories.tsx +38 -0
- package/src/copy-block.tsx +85 -0
- package/src/data-table.stories.tsx +200 -0
- package/src/data-table.tsx +1686 -0
- package/src/date-picker.stories.tsx +61 -0
- package/src/date-picker.tsx +456 -0
- package/src/design-cards.stories.tsx +551 -0
- package/src/dialog.stories.tsx +48 -0
- package/src/dialog.tsx +179 -0
- package/src/display-preferences.tsx +50 -0
- package/src/documents/barcode-svg.stories.tsx +72 -0
- package/src/documents/barcode-svg.tsx +79 -0
- package/src/dropdown-menu.stories.tsx +77 -0
- package/src/dropdown-menu.tsx +271 -0
- package/src/editor/agent-panel.tsx +222 -0
- package/src/editor/agents.stories.tsx +81 -0
- package/src/editor/agents.ts +55 -0
- package/src/editor/behaviour.ts +279 -0
- package/src/editor/block-ids.ts +44 -0
- package/src/editor/block-list.tsx +104 -0
- package/src/editor/block-toolbar.tsx +490 -0
- package/src/editor/bubble.tsx +119 -0
- package/src/editor/catalogue.ts +169 -0
- package/src/editor/collab-rail.tsx +746 -0
- package/src/editor/collab.stories.tsx +207 -0
- package/src/editor/collab.ts +87 -0
- package/src/editor/contract.ts +476 -0
- package/src/editor/convert.ts +414 -0
- package/src/editor/doc-editor.stories.tsx +98 -0
- package/src/editor/doc-editor.tsx +1492 -0
- package/src/editor/editor.css +636 -0
- package/src/editor/extensions.ts +86 -0
- package/src/editor/field-bar.tsx +154 -0
- package/src/editor/field-picker.tsx +109 -0
- package/src/editor/fields.ts +100 -0
- package/src/editor/gutter.tsx +443 -0
- package/src/editor/index.ts +23 -0
- package/src/editor/label-sheet.tsx +289 -0
- package/src/editor/labels.ts +394 -0
- package/src/editor/link-tools.tsx +141 -0
- package/src/editor/node-views.tsx +461 -0
- package/src/editor/page-view.tsx +372 -0
- package/src/editor/phone.tsx +310 -0
- package/src/editor/plugin-block-view.tsx +230 -0
- package/src/editor/plugin-blocks.stories.tsx +96 -0
- package/src/editor/plugin-blocks.ts +52 -0
- package/src/editor/publish-check.tsx +201 -0
- package/src/editor/rich-blocks.stories.tsx +146 -0
- package/src/editor/sample.ts +40 -0
- package/src/editor/save-block-dialog.tsx +141 -0
- package/src/editor/saved-block-view.tsx +205 -0
- package/src/editor/saved-blocks.stories.tsx +105 -0
- package/src/editor/saved-parts.ts +192 -0
- package/src/editor/schema-rich.ts +156 -0
- package/src/editor/schema.ts +368 -0
- package/src/editor/services.tsx +205 -0
- package/src/editor/slash.ts +64 -0
- package/src/editor/suggesting.ts +372 -0
- package/src/editor/suggestions.ts +763 -0
- package/src/editor/table-keys.ts +66 -0
- package/src/editor/templates.stories.tsx +324 -0
- package/src/editor/toolbar.tsx +364 -0
- package/src/empty-state.stories.tsx +51 -0
- package/src/empty-state.tsx +126 -0
- package/src/empty-state.usage-notes.md +30 -0
- package/src/form.stories.tsx +112 -0
- package/src/form.tsx +176 -0
- package/src/globals.css +20 -0
- package/src/icon-button.tsx +85 -0
- package/src/icon-map.ts +335 -0
- package/src/icon.tsx +41 -0
- package/src/index.ts +90 -0
- package/src/input.stories.tsx +157 -0
- package/src/input.tsx +768 -0
- package/src/kpi-strip.tsx +47 -0
- package/src/localized-text.ts +76 -0
- package/src/locked-screen.stories.tsx +29 -0
- package/src/locked-screen.tsx +75 -0
- package/src/lockup.tsx +42 -0
- package/src/lottie.tsx +441 -0
- package/src/mark.tsx +62 -0
- package/src/math-text.stories.tsx +33 -0
- package/src/math-text.tsx +43 -0
- package/src/menu-bar.stories.tsx +198 -0
- package/src/menu-bar.tsx +373 -0
- package/src/message-thread.tsx +181 -0
- package/src/money/currency.ts +244 -0
- package/src/money/money-input.tsx +131 -0
- package/src/money/money.tsx +33 -0
- package/src/open-on-computer.tsx +150 -0
- package/src/otp-input.tsx +161 -0
- package/src/page-header.stories.tsx +95 -0
- package/src/page-header.tsx +122 -0
- package/src/page-shell.stories.tsx +42 -0
- package/src/page-shell.tsx +32 -0
- package/src/page-states.tsx +277 -0
- package/src/pagination.stories.tsx +45 -0
- package/src/pagination.tsx +98 -0
- package/src/paper-sheet.stories.tsx +88 -0
- package/src/paper-sheet.tsx +85 -0
- package/src/phone-tab-bar.tsx +152 -0
- package/src/plugin-card.stories.tsx +208 -0
- package/src/plugin-card.tsx +931 -0
- package/src/popover.stories.tsx +48 -0
- package/src/popover.tsx +55 -0
- package/src/radio-group.stories.tsx +26 -0
- package/src/radio-group.tsx +44 -0
- package/src/route-flow/editor.tsx +1087 -0
- package/src/route-flow/model.ts +771 -0
- package/src/save-bar.tsx +94 -0
- package/src/scope-grant.tsx +139 -0
- package/src/screen-too-small.stories.tsx +61 -0
- package/src/screen-too-small.tsx +104 -0
- package/src/search-field.tsx +65 -0
- package/src/select.stories.tsx +44 -0
- package/src/select.tsx +197 -0
- package/src/separator.stories.tsx +34 -0
- package/src/separator.tsx +34 -0
- package/src/sheet.stories.tsx +49 -0
- package/src/sheet.tsx +168 -0
- package/src/skeleton.stories.tsx +28 -0
- package/src/skeleton.tsx +19 -0
- package/src/slider.stories.tsx +78 -0
- package/src/slider.tsx +300 -0
- package/src/spinner.stories.tsx +33 -0
- package/src/spinner.tsx +55 -0
- package/src/stepper.tsx +85 -0
- package/src/switch.stories.tsx +42 -0
- package/src/switch.tsx +41 -0
- package/src/switcher.stories.tsx +111 -0
- package/src/switcher.tsx +131 -0
- package/src/system-state.tsx +55 -0
- package/src/table.stories.tsx +48 -0
- package/src/table.tsx +121 -0
- package/src/tabs.stories.tsx +74 -0
- package/src/tabs.tsx +90 -0
- package/src/tag-input.stories.tsx +67 -0
- package/src/tag-input.tsx +117 -0
- package/src/tenant-logo.tsx +63 -0
- package/src/tenant-switcher.stories.tsx +38 -0
- package/src/tenant-switcher.tsx +164 -0
- package/src/textarea.stories.tsx +27 -0
- package/src/textarea.tsx +18 -0
- package/src/theme-mode.ts +52 -0
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -0
- package/src/time-picker.tsx +615 -0
- package/src/toggle-group.tsx +138 -0
- package/src/tooltip.stories.tsx +43 -0
- package/src/tooltip.tsx +73 -0
- package/src/top-nav.stories.tsx +58 -0
- package/src/top-nav.tsx +324 -0
- package/src/undo-bar.tsx +107 -0
- package/src/utils.ts +45 -0
- package/src/view-toggle.stories.tsx +84 -0
- package/src/view-toggle.tsx +110 -0
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
|
|
3
|
+
import { Alert, AlertDescription, AlertTitle } from "./alert"
|
|
4
|
+
import { Button } from "./button"
|
|
5
|
+
import { Icon, type IconName } from "./icon"
|
|
6
|
+
import { Lottie, type MomentName } from "./lottie"
|
|
7
|
+
import { Skeleton } from "./skeleton"
|
|
8
|
+
import { cn } from "./utils"
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The six page states every list and record page uses (docs/design/components/
|
|
12
|
+
* PatternStates, V.2). A screen supplies its own wording; the shapes stay.
|
|
13
|
+
* Strings come from the caller through `t()`: this package holds no translations.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
/** Loading: the real layout with skeleton rows, never a spinner or "Loading…". */
|
|
17
|
+
function LoadingRows({
|
|
18
|
+
headers,
|
|
19
|
+
rows = 5,
|
|
20
|
+
label,
|
|
21
|
+
className,
|
|
22
|
+
}: {
|
|
23
|
+
/** The table's real column headers, which render at once. */
|
|
24
|
+
headers: string[]
|
|
25
|
+
rows?: number
|
|
26
|
+
/** Announced to assistive technology. */
|
|
27
|
+
label: string
|
|
28
|
+
className?: string
|
|
29
|
+
}) {
|
|
30
|
+
return (
|
|
31
|
+
<div role="status" aria-busy="true" aria-label={label} className={cn("overflow-hidden rounded-card border border-border bg-card", className)}>
|
|
32
|
+
<div className="flex h-10 items-center justify-between gap-3 bg-table-header px-3 text-xs font-medium text-muted-foreground">
|
|
33
|
+
{headers.map((header) => (
|
|
34
|
+
<span key={header} className="flex-1 last:flex-none">
|
|
35
|
+
{header}
|
|
36
|
+
</span>
|
|
37
|
+
))}
|
|
38
|
+
</div>
|
|
39
|
+
{Array.from({ length: rows }, (_, row) => (
|
|
40
|
+
<div key={row} className="flex h-(--row-h) items-center gap-3 border-t border-divider px-3">
|
|
41
|
+
{headers.map((header, column) => (
|
|
42
|
+
<span key={header} className="flex-1">
|
|
43
|
+
<Skeleton className="h-2.5 rounded-full" style={{ width: `${40 + ((row * 17 + column * 23) % 45)}%` }} />
|
|
44
|
+
</span>
|
|
45
|
+
))}
|
|
46
|
+
</div>
|
|
47
|
+
))}
|
|
48
|
+
</div>
|
|
49
|
+
)
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The dashed box shared by the two empty states: a tinted icon tile, or a Lottie
|
|
54
|
+
* moment (LT.4) with the tile as its fallback.
|
|
55
|
+
*/
|
|
56
|
+
function EmptyBox({
|
|
57
|
+
icon,
|
|
58
|
+
title,
|
|
59
|
+
description,
|
|
60
|
+
action,
|
|
61
|
+
moment,
|
|
62
|
+
once,
|
|
63
|
+
onceEver,
|
|
64
|
+
className,
|
|
65
|
+
}: {
|
|
66
|
+
icon: IconName
|
|
67
|
+
title: string
|
|
68
|
+
description?: string
|
|
69
|
+
action?: React.ReactNode
|
|
70
|
+
moment?: MomentName
|
|
71
|
+
once?: string
|
|
72
|
+
onceEver?: string
|
|
73
|
+
className?: string
|
|
74
|
+
}) {
|
|
75
|
+
const tile = (
|
|
76
|
+
<span className="grid size-12 place-items-center rounded-card bg-muted text-muted-foreground">
|
|
77
|
+
<Icon name={icon} size={24} />
|
|
78
|
+
</span>
|
|
79
|
+
)
|
|
80
|
+
return (
|
|
81
|
+
<div
|
|
82
|
+
className={cn(
|
|
83
|
+
"flex flex-col items-center gap-2 rounded-card border border-dashed border-border px-6 py-8 text-center",
|
|
84
|
+
className
|
|
85
|
+
)}
|
|
86
|
+
>
|
|
87
|
+
{moment ? <Lottie name={moment} once={once} onceEver={onceEver} className="h-[120px] w-[160px]" fallback={tile} /> : tile}
|
|
88
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
89
|
+
{description && <p className="max-w-prose text-sm text-muted-foreground">{description}</p>}
|
|
90
|
+
{action && <div className="mt-1">{action}</div>}
|
|
91
|
+
</div>
|
|
92
|
+
)
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Empty for the first time: what this place is for and the one action that fills it. */
|
|
96
|
+
function EmptyFirstTime({
|
|
97
|
+
icon = "inbox",
|
|
98
|
+
title,
|
|
99
|
+
description,
|
|
100
|
+
action,
|
|
101
|
+
moment,
|
|
102
|
+
once,
|
|
103
|
+
onceEver,
|
|
104
|
+
className,
|
|
105
|
+
}: {
|
|
106
|
+
icon?: IconName
|
|
107
|
+
title: string
|
|
108
|
+
description?: string
|
|
109
|
+
/** The page's main button. */
|
|
110
|
+
action?: React.ReactNode
|
|
111
|
+
/** `empty-documents`, `empty-people`, `empty-invoices`, `empty-stock`, `all-caught-up`, or a first-run scene (LT.4). */
|
|
112
|
+
moment?: MomentName
|
|
113
|
+
/** Plays once a session under this key; defaults to the moment's name. */
|
|
114
|
+
once?: string
|
|
115
|
+
/** Plays once ever on this device under this key instead (first-run scenes). */
|
|
116
|
+
onceEver?: string
|
|
117
|
+
className?: string
|
|
118
|
+
}) {
|
|
119
|
+
return (
|
|
120
|
+
<EmptyBox
|
|
121
|
+
icon={icon}
|
|
122
|
+
title={title}
|
|
123
|
+
description={description}
|
|
124
|
+
action={action}
|
|
125
|
+
moment={moment}
|
|
126
|
+
once={moment && !onceEver ? (once ?? moment) : undefined}
|
|
127
|
+
onceEver={onceEver}
|
|
128
|
+
className={className}
|
|
129
|
+
/>
|
|
130
|
+
)
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Empty after a filter: names the search or filter and offers Clear filters. */
|
|
134
|
+
function EmptyFiltered({
|
|
135
|
+
title,
|
|
136
|
+
description,
|
|
137
|
+
clearLabel,
|
|
138
|
+
onClear,
|
|
139
|
+
className,
|
|
140
|
+
}: {
|
|
141
|
+
/** Names the filter: "No one matches “Khalda”". */
|
|
142
|
+
title: string
|
|
143
|
+
description?: string
|
|
144
|
+
clearLabel: string
|
|
145
|
+
onClear: () => void
|
|
146
|
+
className?: string
|
|
147
|
+
}) {
|
|
148
|
+
return (
|
|
149
|
+
<EmptyBox
|
|
150
|
+
icon="search"
|
|
151
|
+
moment="no-results"
|
|
152
|
+
title={title}
|
|
153
|
+
description={description}
|
|
154
|
+
className={className}
|
|
155
|
+
action={
|
|
156
|
+
<Button type="button" variant="outline" onClick={onClear}>
|
|
157
|
+
{clearLabel}
|
|
158
|
+
</Button>
|
|
159
|
+
}
|
|
160
|
+
/>
|
|
161
|
+
)
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** Error: what failed in plain words, inside the area that failed, with Try again. */
|
|
165
|
+
function AreaError({
|
|
166
|
+
message,
|
|
167
|
+
retryLabel,
|
|
168
|
+
onRetry,
|
|
169
|
+
className,
|
|
170
|
+
}: {
|
|
171
|
+
message: string
|
|
172
|
+
retryLabel: string
|
|
173
|
+
onRetry: () => void
|
|
174
|
+
className?: string
|
|
175
|
+
}) {
|
|
176
|
+
return (
|
|
177
|
+
<div role="alert" className={cn("flex flex-col items-center gap-2 px-3 py-6 text-center", className)}>
|
|
178
|
+
<Icon name="alert" size={16} className="text-error-text" />
|
|
179
|
+
<p className="text-sm text-error-text">{message}</p>
|
|
180
|
+
<Button type="button" variant="outline" size="sm" onClick={onRetry}>
|
|
181
|
+
{retryLabel}
|
|
182
|
+
</Button>
|
|
183
|
+
</div>
|
|
184
|
+
)
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Waiting on something real (an upload, an import, an outside system): a looping
|
|
189
|
+
* moment while `active`, then still on its last frame. The words say what is
|
|
190
|
+
* happening and that the person can keep working; nothing waits for the picture.
|
|
191
|
+
*/
|
|
192
|
+
function WaitingState({
|
|
193
|
+
moment = "updating",
|
|
194
|
+
active = true,
|
|
195
|
+
title,
|
|
196
|
+
description,
|
|
197
|
+
action,
|
|
198
|
+
className,
|
|
199
|
+
}: {
|
|
200
|
+
/** `uploading`, `waiting-reply`, `updating` (loops) or `offline` (plays once, then still). */
|
|
201
|
+
moment?: MomentName
|
|
202
|
+
/** False once the waiting is over. */
|
|
203
|
+
active?: boolean
|
|
204
|
+
title: string
|
|
205
|
+
description?: React.ReactNode
|
|
206
|
+
action?: React.ReactNode
|
|
207
|
+
className?: string
|
|
208
|
+
}) {
|
|
209
|
+
return (
|
|
210
|
+
<div role="status" aria-busy={active} className={cn("flex flex-col items-center gap-2 px-6 py-8 text-center", className)}>
|
|
211
|
+
<Lottie
|
|
212
|
+
name={moment}
|
|
213
|
+
play={moment === "offline" ? "view" : "loop"}
|
|
214
|
+
active={active}
|
|
215
|
+
className="size-[120px]"
|
|
216
|
+
fallback={<Icon name={moment === "offline" ? "alert" : "clock"} size={24} className="text-muted-foreground" />}
|
|
217
|
+
/>
|
|
218
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
219
|
+
{description && <div className="max-w-prose text-sm text-muted-foreground">{description}</div>}
|
|
220
|
+
{action && <div className="mt-1">{action}</div>}
|
|
221
|
+
</div>
|
|
222
|
+
)
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/** Read-only: names the permission and who grants it. Fields disabled, actions hidden. */
|
|
226
|
+
function ReadOnlyNotice({
|
|
227
|
+
title,
|
|
228
|
+
description,
|
|
229
|
+
className,
|
|
230
|
+
}: {
|
|
231
|
+
title: string
|
|
232
|
+
description?: string
|
|
233
|
+
className?: string
|
|
234
|
+
}) {
|
|
235
|
+
return (
|
|
236
|
+
<Alert className={cn("border-transparent bg-muted", className)}>
|
|
237
|
+
<Icon name="info" size={16} />
|
|
238
|
+
<AlertTitle>{title}</AlertTitle>
|
|
239
|
+
{description && <AlertDescription className="text-sm text-foreground opacity-100">{description}</AlertDescription>}
|
|
240
|
+
</Alert>
|
|
241
|
+
)
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Access denied, in place of the page content with the shell still there: what's
|
|
246
|
+
* behind it, the permission in plain words, who can give it, and Ask for access.
|
|
247
|
+
*/
|
|
248
|
+
function AccessDeniedPanel({
|
|
249
|
+
title,
|
|
250
|
+
description,
|
|
251
|
+
askLabel,
|
|
252
|
+
onAsk,
|
|
253
|
+
className,
|
|
254
|
+
}: {
|
|
255
|
+
title: string
|
|
256
|
+
description: string
|
|
257
|
+
askLabel?: string
|
|
258
|
+
onAsk?: () => void
|
|
259
|
+
className?: string
|
|
260
|
+
}) {
|
|
261
|
+
return (
|
|
262
|
+
<div className={cn("flex flex-col items-center gap-2 px-6 py-10 text-center", className)}>
|
|
263
|
+
<span className="grid size-11 place-items-center rounded-card bg-muted text-foreground">
|
|
264
|
+
<Icon name="lock" size={20} />
|
|
265
|
+
</span>
|
|
266
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
267
|
+
<p className="max-w-prose text-sm text-muted-foreground">{description}</p>
|
|
268
|
+
{askLabel && onAsk && (
|
|
269
|
+
<Button type="button" variant="outline" onClick={onAsk} className="mt-1">
|
|
270
|
+
{askLabel}
|
|
271
|
+
</Button>
|
|
272
|
+
)}
|
|
273
|
+
</div>
|
|
274
|
+
)
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
export { AccessDeniedPanel, AreaError, EmptyFiltered, EmptyFirstTime, LoadingRows, ReadOnlyNotice, WaitingState }
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
import * as React from "react"
|
|
3
|
+
|
|
4
|
+
import { Pagination } from "./pagination"
|
|
5
|
+
|
|
6
|
+
const meta = {
|
|
7
|
+
title: "Primitives/Pagination",
|
|
8
|
+
component: Pagination,
|
|
9
|
+
tags: ["autodocs"],
|
|
10
|
+
} satisfies Meta<typeof Pagination>
|
|
11
|
+
|
|
12
|
+
export default meta
|
|
13
|
+
type Story = StoryObj<typeof meta>
|
|
14
|
+
|
|
15
|
+
export const Default: Story = {
|
|
16
|
+
args: { page: 2, perPage: 25, total: 214, onPageChange: () => {} },
|
|
17
|
+
render: (args) => {
|
|
18
|
+
const [page, setPage] = React.useState(args.page)
|
|
19
|
+
return <Pagination {...args} page={page} onPageChange={setPage} />
|
|
20
|
+
},
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export const FirstPage: Story = {
|
|
24
|
+
args: { page: 1, perPage: 25, total: 214, onPageChange: () => {} },
|
|
25
|
+
render: (args) => {
|
|
26
|
+
const [page, setPage] = React.useState(args.page)
|
|
27
|
+
return <Pagination {...args} page={page} onPageChange={setPage} />
|
|
28
|
+
},
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export const LastPage: Story = {
|
|
32
|
+
args: { page: 9, perPage: 25, total: 214, onPageChange: () => {} },
|
|
33
|
+
render: (args) => {
|
|
34
|
+
const [page, setPage] = React.useState(args.page)
|
|
35
|
+
return <Pagination {...args} page={page} onPageChange={setPage} />
|
|
36
|
+
},
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export const SinglePage: Story = {
|
|
40
|
+
args: { page: 1, perPage: 25, total: 12, onPageChange: () => {} },
|
|
41
|
+
render: (args) => {
|
|
42
|
+
const [page, setPage] = React.useState(args.page)
|
|
43
|
+
return <Pagination {...args} page={page} onPageChange={setPage} />
|
|
44
|
+
},
|
|
45
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
import { IconChevronLeft, IconChevronRight } from "@tabler/icons-react"
|
|
3
|
+
|
|
4
|
+
import { cn } from "./utils"
|
|
5
|
+
import { Button } from "./button"
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Routing-agnostic prev/next pagination — modeled on the ad-hoc pattern
|
|
9
|
+
* already used on the audit-logs page (total/page/totalPages + prev/next
|
|
10
|
+
* buttons disabled at the boundaries), promoted to a shared, token-styled
|
|
11
|
+
* primitive. Migrating that page's inline markup onto this component is a
|
|
12
|
+
* follow-up, not in scope here.
|
|
13
|
+
*
|
|
14
|
+
* PLATFORM NOTE: `page`/`perPage`/`total`/`onPageChange` are plain
|
|
15
|
+
* numbers/callbacks — no coupling to Next.js routing (no useRouter/
|
|
16
|
+
* useSearchParams anywhere here) — directly mirrorable by a future Flutter
|
|
17
|
+
* pagination widget.
|
|
18
|
+
*/
|
|
19
|
+
export interface PaginationProps extends Omit<React.ComponentProps<"nav">, "onChange"> {
|
|
20
|
+
/** 1-indexed current page. */
|
|
21
|
+
page: number
|
|
22
|
+
perPage: number
|
|
23
|
+
/** Total row count across all pages (not just the current page). */
|
|
24
|
+
total: number
|
|
25
|
+
onPageChange: (page: number) => void
|
|
26
|
+
/** Optional override for the "N entries" label (e.g. singular/plural, i18n). */
|
|
27
|
+
entriesLabel?: (total: number) => string
|
|
28
|
+
/**
|
|
29
|
+
* Optional override for "page 2 of 7".
|
|
30
|
+
*
|
|
31
|
+
* A function, not a string, for the same reason `entriesLabel` is one: the
|
|
32
|
+
* numbers sit INSIDE the sentence, and word order around them differs
|
|
33
|
+
* between languages. A caller that could only supply "page" and "of"
|
|
34
|
+
* separately would be pinned to English order.
|
|
35
|
+
*/
|
|
36
|
+
pageLabel?: (page: number, totalPages: number) => string
|
|
37
|
+
/** Accessible name for the surrounding <nav>. */
|
|
38
|
+
navLabel?: string
|
|
39
|
+
/** Accessible name for the previous-page button. */
|
|
40
|
+
previousLabel?: string
|
|
41
|
+
/** Accessible name for the next-page button. */
|
|
42
|
+
nextLabel?: string
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function Pagination({
|
|
46
|
+
className,
|
|
47
|
+
page,
|
|
48
|
+
perPage,
|
|
49
|
+
total,
|
|
50
|
+
onPageChange,
|
|
51
|
+
entriesLabel,
|
|
52
|
+
pageLabel,
|
|
53
|
+
navLabel = "Pagination",
|
|
54
|
+
previousLabel = "Previous page",
|
|
55
|
+
nextLabel = "Next page",
|
|
56
|
+
...props
|
|
57
|
+
}: PaginationProps) {
|
|
58
|
+
const totalPages = Math.max(1, Math.ceil(total / perPage))
|
|
59
|
+
const label = entriesLabel ?? ((n: number) => (n === 1 ? "1 entry" : `${n} entries`))
|
|
60
|
+
const pages = pageLabel ?? ((current: number, last: number) => `page ${current} of ${last}`)
|
|
61
|
+
|
|
62
|
+
return (
|
|
63
|
+
<nav
|
|
64
|
+
data-slot="pagination"
|
|
65
|
+
aria-label={navLabel}
|
|
66
|
+
className={cn("flex items-center justify-between", className)}
|
|
67
|
+
{...props}
|
|
68
|
+
>
|
|
69
|
+
<p className="text-sm text-muted-foreground">
|
|
70
|
+
{label(total)} · {pages(page, totalPages)}
|
|
71
|
+
</p>
|
|
72
|
+
<div className="flex gap-2">
|
|
73
|
+
<Button
|
|
74
|
+
type="button"
|
|
75
|
+
variant="outline"
|
|
76
|
+
size="icon-sm"
|
|
77
|
+
disabled={page <= 1}
|
|
78
|
+
onClick={() => onPageChange(Math.max(1, page - 1))}
|
|
79
|
+
aria-label={previousLabel}
|
|
80
|
+
>
|
|
81
|
+
<IconChevronLeft className="rtl:rotate-180" />
|
|
82
|
+
</Button>
|
|
83
|
+
<Button
|
|
84
|
+
type="button"
|
|
85
|
+
variant="outline"
|
|
86
|
+
size="icon-sm"
|
|
87
|
+
disabled={page >= totalPages}
|
|
88
|
+
onClick={() => onPageChange(Math.min(totalPages, page + 1))}
|
|
89
|
+
aria-label={nextLabel}
|
|
90
|
+
>
|
|
91
|
+
<IconChevronRight className="rtl:rotate-180" />
|
|
92
|
+
</Button>
|
|
93
|
+
</div>
|
|
94
|
+
</nav>
|
|
95
|
+
)
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export { Pagination }
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
import { IconQrcode } from "@tabler/icons-react"
|
|
3
|
+
|
|
4
|
+
import { PaperEyebrow, PaperGround, PaperHeadline, PaperSheet } from "./paper-sheet"
|
|
5
|
+
import { Lockup } from "./lockup"
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Sheets on paper (docs/design/10-patterns.md): white sheets on the grey
|
|
9
|
+
* ground, one on its plane under the one thing that matters.
|
|
10
|
+
*/
|
|
11
|
+
const meta = {
|
|
12
|
+
title: "Brand/Sheets on paper",
|
|
13
|
+
component: PaperSheet,
|
|
14
|
+
tags: ["autodocs"],
|
|
15
|
+
parameters: { layout: "fullscreen" },
|
|
16
|
+
} satisfies Meta<typeof PaperSheet>
|
|
17
|
+
|
|
18
|
+
export default meta
|
|
19
|
+
type Story = StoryObj<typeof meta>
|
|
20
|
+
|
|
21
|
+
export const Sheet: Story = {
|
|
22
|
+
render: () => (
|
|
23
|
+
<PaperGround className="p-10">
|
|
24
|
+
<PaperSheet className="max-w-md space-y-3 p-8">
|
|
25
|
+
<PaperEyebrow>Example Bakery · Documents</PaperEyebrow>
|
|
26
|
+
<PaperHeadline>Every paper you issue can be checked.</PaperHeadline>
|
|
27
|
+
<p className="text-muted-foreground">Scan the code on a printed document to see that it is genuine.</p>
|
|
28
|
+
</PaperSheet>
|
|
29
|
+
</PaperGround>
|
|
30
|
+
),
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export const OnThePlane: Story = {
|
|
34
|
+
name: "On the plane (clickable)",
|
|
35
|
+
render: () => (
|
|
36
|
+
<PaperGround className="p-10">
|
|
37
|
+
<PaperSheet as="button" type="button" plane className="flex max-w-sm items-center gap-4 p-5">
|
|
38
|
+
<span className="grid size-11 shrink-0 place-items-center rounded-control-lg bg-primary-tint text-primary-tint-foreground">
|
|
39
|
+
<IconQrcode className="size-6" aria-hidden />
|
|
40
|
+
</span>
|
|
41
|
+
<span className="space-y-0.5">
|
|
42
|
+
<span className="block font-semibold">Verify a document</span>
|
|
43
|
+
<span className="block text-sm text-muted-foreground">Scan the QR code on a printed page.</span>
|
|
44
|
+
</span>
|
|
45
|
+
</PaperSheet>
|
|
46
|
+
</PaperGround>
|
|
47
|
+
),
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export const NotYet: Story = {
|
|
51
|
+
name: "Dashed (not yet)",
|
|
52
|
+
render: () => (
|
|
53
|
+
<PaperGround className="p-10">
|
|
54
|
+
<PaperSheet dashed className="max-w-sm p-5 text-muted-foreground">
|
|
55
|
+
An optional step that has not happened yet.
|
|
56
|
+
</PaperSheet>
|
|
57
|
+
</PaperGround>
|
|
58
|
+
),
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export const Composition: Story = {
|
|
62
|
+
render: () => (
|
|
63
|
+
<PaperGround className="flex min-h-[32rem] flex-col justify-between gap-10 p-10">
|
|
64
|
+
<div className="max-w-md space-y-8">
|
|
65
|
+
<PaperSheet className="space-y-3 p-8">
|
|
66
|
+
<PaperEyebrow>Open source · White-label · MCP</PaperEyebrow>
|
|
67
|
+
<PaperHeadline>Agents propose. Your team decides.</PaperHeadline>
|
|
68
|
+
<p className="text-muted-foreground">One sheet carries the message; the plane sits under the one thing that matters.</p>
|
|
69
|
+
</PaperSheet>
|
|
70
|
+
<PaperSheet as="button" type="button" plane className="ml-6 block w-[calc(100%-1.5rem)] p-5 font-semibold">
|
|
71
|
+
Verify a document
|
|
72
|
+
</PaperSheet>
|
|
73
|
+
</div>
|
|
74
|
+
<Lockup size={28} />
|
|
75
|
+
</PaperGround>
|
|
76
|
+
),
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export const LockupSizes: Story = {
|
|
80
|
+
name: "Lockup",
|
|
81
|
+
render: () => (
|
|
82
|
+
<PaperGround className="flex flex-col items-start gap-6 p-10">
|
|
83
|
+
<Lockup size={20} />
|
|
84
|
+
<Lockup size={32} />
|
|
85
|
+
<Lockup size={48} />
|
|
86
|
+
</PaperGround>
|
|
87
|
+
),
|
|
88
|
+
}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
import { cn } from "./utils"
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* The everyday brand pattern, "sheets on paper" (docs/design/10-patterns.md):
|
|
6
|
+
* white sheets with soft corners on the grey ground, and one of them resting
|
|
7
|
+
* on its plane, the way the mark's sheet rests on the platform.
|
|
8
|
+
*
|
|
9
|
+
* - `PaperGround` is the grey ground the sheets lie on.
|
|
10
|
+
* - `PaperSheet` is one sheet. `plane` sets it on the brand-coloured plane, a
|
|
11
|
+
* hard offset down and to the left that never mirrors in RTL (decision 4.3).
|
|
12
|
+
* Use it under the one thing that matters on the piece, and only once.
|
|
13
|
+
* `dashed` is the "not yet" sheet: something optional or still waiting.
|
|
14
|
+
*
|
|
15
|
+
* A clickable sheet on the plane lifts on hover like any clickable card.
|
|
16
|
+
* Brand surfaces only (sign-in, covers, social): product screens use `Card`.
|
|
17
|
+
* Never on a white-label tenant's pages, which carry their own brand.
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
function PaperGround({ className, ...props }: React.ComponentProps<"div">) {
|
|
21
|
+
return <div data-slot="paper-ground" className={cn("bg-background", className)} {...props} />
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
type SheetProps<T extends React.ElementType> = {
|
|
25
|
+
as?: T
|
|
26
|
+
/** Rest the sheet on its plane. One per piece. */
|
|
27
|
+
plane?: boolean
|
|
28
|
+
/** The "not yet" sheet: dashed and flat. Ignored with `plane`. */
|
|
29
|
+
dashed?: boolean
|
|
30
|
+
className?: string
|
|
31
|
+
} & Omit<React.ComponentPropsWithoutRef<T>, "as" | "className">
|
|
32
|
+
|
|
33
|
+
/*
|
|
34
|
+
* The plane at sheet scale: 12px (0.75rem) down and to the start, in the brand
|
|
35
|
+
* colour, growing to 16px on hover for something clickable. The shadow keeps
|
|
36
|
+
* the sheet's corners, so the plane is the same rounded shape, like the mark.
|
|
37
|
+
*/
|
|
38
|
+
const PLANE = "shadow-[-0.75rem_0.75rem_0_0_var(--brand)]"
|
|
39
|
+
const PLANE_LIFT =
|
|
40
|
+
"transition-[box-shadow,translate] duration-[var(--dur-fast)] ease-[var(--ease-out)] hover:translate-x-px hover:-translate-y-px hover:shadow-[-1rem_1rem_0_0_var(--brand)] focus-visible:translate-x-px focus-visible:-translate-y-px focus-visible:shadow-[-1rem_1rem_0_0_var(--brand)] motion-reduce:transition-none"
|
|
41
|
+
|
|
42
|
+
function PaperSheet<T extends React.ElementType = "div">({ as, plane = false, dashed = false, className, ...props }: SheetProps<T>) {
|
|
43
|
+
const Comp: React.ElementType = as ?? "div"
|
|
44
|
+
const interactive = Comp === "button" || Comp === "a"
|
|
45
|
+
return (
|
|
46
|
+
<Comp
|
|
47
|
+
data-slot="paper-sheet"
|
|
48
|
+
data-plane={plane || undefined}
|
|
49
|
+
data-dashed={(!plane && dashed) || undefined}
|
|
50
|
+
className={cn(
|
|
51
|
+
"rounded-dialog bg-card text-card-foreground",
|
|
52
|
+
plane ? PLANE : dashed ? "border border-dashed border-input" : "border border-border",
|
|
53
|
+
plane && interactive && PLANE_LIFT,
|
|
54
|
+
interactive &&
|
|
55
|
+
"cursor-pointer text-start outline-none focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-ring",
|
|
56
|
+
className
|
|
57
|
+
)}
|
|
58
|
+
{...props}
|
|
59
|
+
/>
|
|
60
|
+
)
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** The mono eyebrow above a brand headline: Geist Mono, uppercase, tracked +6%. Arabic has no mono cut or case, so in RTL it is plain Noto Sans. */
|
|
64
|
+
function PaperEyebrow({ className, ...props }: React.ComponentProps<"p">) {
|
|
65
|
+
return (
|
|
66
|
+
<p
|
|
67
|
+
data-slot="paper-eyebrow"
|
|
68
|
+
className={cn("font-mono text-xs font-medium tracking-[0.06em] text-primary uppercase rtl:font-sans rtl:tracking-normal", className)}
|
|
69
|
+
{...props}
|
|
70
|
+
/>
|
|
71
|
+
)
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** A brand headline: Readex Pro 600, sentence case. Brand surfaces only, never product screens. */
|
|
75
|
+
function PaperHeadline({ className, ...props }: React.ComponentProps<"h2">) {
|
|
76
|
+
return (
|
|
77
|
+
<h2
|
|
78
|
+
data-slot="paper-headline"
|
|
79
|
+
className={cn("font-display text-2xl leading-tight font-semibold text-balance text-foreground sm:text-3xl", className)}
|
|
80
|
+
{...props}
|
|
81
|
+
/>
|
|
82
|
+
)
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export { PaperGround, PaperSheet, PaperEyebrow, PaperHeadline }
|