@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.
Files changed (205) hide show
  1. package/README.md +106 -2
  2. package/package.json +219 -4
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +338 -0
  6. package/src/actor-chip.tsx +71 -0
  7. package/src/agent-activity.tsx +163 -0
  8. package/src/agent-collaboration.stories.tsx +156 -0
  9. package/src/agent-run-status.tsx +196 -0
  10. package/src/alert-dialog.stories.tsx +45 -0
  11. package/src/alert-dialog.tsx +147 -0
  12. package/src/alert.stories.tsx +91 -0
  13. package/src/alert.tsx +89 -0
  14. package/src/app-sidebar.stories.tsx +195 -0
  15. package/src/app-sidebar.tsx +604 -0
  16. package/src/approval-queue.tsx +109 -0
  17. package/src/audience-group-picker.stories.tsx +198 -0
  18. package/src/audience-group-picker.tsx +362 -0
  19. package/src/audience-people-picker.stories.tsx +102 -0
  20. package/src/audience-people-picker.tsx +279 -0
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -0
  23. package/src/badge.stories.tsx +105 -0
  24. package/src/badge.tsx +68 -0
  25. package/src/beta-warning.stories.tsx +79 -0
  26. package/src/beta-warning.tsx +189 -0
  27. package/src/bilingual-input.stories.tsx +82 -0
  28. package/src/bilingual-input.tsx +188 -0
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -0
  31. package/src/breadcrumb.tsx +90 -0
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -0
  34. package/src/button.tsx +123 -0
  35. package/src/card.stories.tsx +423 -0
  36. package/src/card.tsx +180 -0
  37. package/src/chart.stories.tsx +66 -0
  38. package/src/chart.tsx +228 -0
  39. package/src/checkbox.stories.tsx +62 -0
  40. package/src/checkbox.tsx +54 -0
  41. package/src/collapsible.stories.tsx +48 -0
  42. package/src/collapsible.tsx +34 -0
  43. package/src/color-card.stories.tsx +61 -0
  44. package/src/color-card.tsx +270 -0
  45. package/src/color-picker.stories.tsx +65 -0
  46. package/src/color-picker.tsx +425 -0
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +398 -0
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -0
  51. package/src/copy-block.tsx +85 -0
  52. package/src/data-table.stories.tsx +200 -0
  53. package/src/data-table.tsx +1686 -0
  54. package/src/date-picker.stories.tsx +61 -0
  55. package/src/date-picker.tsx +456 -0
  56. package/src/design-cards.stories.tsx +551 -0
  57. package/src/dialog.stories.tsx +48 -0
  58. package/src/dialog.tsx +179 -0
  59. package/src/display-preferences.tsx +50 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -0
  61. package/src/documents/barcode-svg.tsx +79 -0
  62. package/src/dropdown-menu.stories.tsx +77 -0
  63. package/src/dropdown-menu.tsx +271 -0
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -0
  68. package/src/editor/block-ids.ts +44 -0
  69. package/src/editor/block-list.tsx +104 -0
  70. package/src/editor/block-toolbar.tsx +490 -0
  71. package/src/editor/bubble.tsx +119 -0
  72. package/src/editor/catalogue.ts +169 -0
  73. package/src/editor/collab-rail.tsx +746 -0
  74. package/src/editor/collab.stories.tsx +207 -0
  75. package/src/editor/collab.ts +87 -0
  76. package/src/editor/contract.ts +476 -0
  77. package/src/editor/convert.ts +414 -0
  78. package/src/editor/doc-editor.stories.tsx +98 -0
  79. package/src/editor/doc-editor.tsx +1492 -0
  80. package/src/editor/editor.css +636 -0
  81. package/src/editor/extensions.ts +86 -0
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -0
  84. package/src/editor/fields.ts +100 -0
  85. package/src/editor/gutter.tsx +443 -0
  86. package/src/editor/index.ts +23 -0
  87. package/src/editor/label-sheet.tsx +289 -0
  88. package/src/editor/labels.ts +394 -0
  89. package/src/editor/link-tools.tsx +141 -0
  90. package/src/editor/node-views.tsx +461 -0
  91. package/src/editor/page-view.tsx +372 -0
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -0
  97. package/src/editor/rich-blocks.stories.tsx +146 -0
  98. package/src/editor/sample.ts +40 -0
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -0
  104. package/src/editor/schema.ts +368 -0
  105. package/src/editor/services.tsx +205 -0
  106. package/src/editor/slash.ts +64 -0
  107. package/src/editor/suggesting.ts +372 -0
  108. package/src/editor/suggestions.ts +763 -0
  109. package/src/editor/table-keys.ts +66 -0
  110. package/src/editor/templates.stories.tsx +324 -0
  111. package/src/editor/toolbar.tsx +364 -0
  112. package/src/empty-state.stories.tsx +51 -0
  113. package/src/empty-state.tsx +126 -0
  114. package/src/empty-state.usage-notes.md +30 -0
  115. package/src/form.stories.tsx +112 -0
  116. package/src/form.tsx +176 -0
  117. package/src/globals.css +20 -0
  118. package/src/icon-button.tsx +85 -0
  119. package/src/icon-map.ts +335 -0
  120. package/src/icon.tsx +41 -0
  121. package/src/index.ts +90 -0
  122. package/src/input.stories.tsx +157 -0
  123. package/src/input.tsx +768 -0
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -0
  127. package/src/locked-screen.tsx +75 -0
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -0
  131. package/src/math-text.stories.tsx +33 -0
  132. package/src/math-text.tsx +43 -0
  133. package/src/menu-bar.stories.tsx +198 -0
  134. package/src/menu-bar.tsx +373 -0
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -0
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -0
  142. package/src/page-header.tsx +122 -0
  143. package/src/page-shell.stories.tsx +42 -0
  144. package/src/page-shell.tsx +32 -0
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -0
  147. package/src/pagination.tsx +98 -0
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -0
  152. package/src/plugin-card.tsx +931 -0
  153. package/src/popover.stories.tsx +48 -0
  154. package/src/popover.tsx +55 -0
  155. package/src/radio-group.stories.tsx +26 -0
  156. package/src/radio-group.tsx +44 -0
  157. package/src/route-flow/editor.tsx +1087 -0
  158. package/src/route-flow/model.ts +771 -0
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -0
  161. package/src/screen-too-small.stories.tsx +61 -0
  162. package/src/screen-too-small.tsx +104 -0
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -0
  165. package/src/select.tsx +197 -0
  166. package/src/separator.stories.tsx +34 -0
  167. package/src/separator.tsx +34 -0
  168. package/src/sheet.stories.tsx +49 -0
  169. package/src/sheet.tsx +168 -0
  170. package/src/skeleton.stories.tsx +28 -0
  171. package/src/skeleton.tsx +19 -0
  172. package/src/slider.stories.tsx +78 -0
  173. package/src/slider.tsx +300 -0
  174. package/src/spinner.stories.tsx +33 -0
  175. package/src/spinner.tsx +55 -0
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -0
  178. package/src/switch.tsx +41 -0
  179. package/src/switcher.stories.tsx +111 -0
  180. package/src/switcher.tsx +131 -0
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -0
  183. package/src/table.tsx +121 -0
  184. package/src/tabs.stories.tsx +74 -0
  185. package/src/tabs.tsx +90 -0
  186. package/src/tag-input.stories.tsx +67 -0
  187. package/src/tag-input.tsx +117 -0
  188. package/src/tenant-logo.tsx +63 -0
  189. package/src/tenant-switcher.stories.tsx +38 -0
  190. package/src/tenant-switcher.tsx +164 -0
  191. package/src/textarea.stories.tsx +27 -0
  192. package/src/textarea.tsx +18 -0
  193. package/src/theme-mode.ts +52 -0
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -0
  196. package/src/time-picker.tsx +615 -0
  197. package/src/toggle-group.tsx +138 -0
  198. package/src/tooltip.stories.tsx +43 -0
  199. package/src/tooltip.tsx +73 -0
  200. package/src/top-nav.stories.tsx +58 -0
  201. package/src/top-nav.tsx +324 -0
  202. package/src/undo-bar.tsx +107 -0
  203. package/src/utils.ts +45 -0
  204. package/src/view-toggle.stories.tsx +84 -0
  205. 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)} &middot; {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 }