@whity/ui 0.0.0-stage → 0.5.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 (169) hide show
  1. package/README.md +107 -3
  2. package/package.json +192 -6
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +302 -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 +500 -0
  16. package/src/approval-queue.tsx +108 -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.tsx +83 -0
  22. package/src/badge.stories.tsx +105 -0
  23. package/src/badge.tsx +68 -0
  24. package/src/beta-warning.stories.tsx +79 -0
  25. package/src/beta-warning.tsx +189 -0
  26. package/src/bilingual-input.stories.tsx +82 -0
  27. package/src/bilingual-input.tsx +183 -0
  28. package/src/breadcrumb.stories.tsx +51 -0
  29. package/src/breadcrumb.tsx +90 -0
  30. package/src/button.stories.tsx +87 -0
  31. package/src/button.tsx +118 -0
  32. package/src/card.stories.tsx +423 -0
  33. package/src/card.tsx +180 -0
  34. package/src/chart.stories.tsx +66 -0
  35. package/src/chart.tsx +228 -0
  36. package/src/checkbox.stories.tsx +62 -0
  37. package/src/checkbox.tsx +54 -0
  38. package/src/collapsible.stories.tsx +48 -0
  39. package/src/collapsible.tsx +34 -0
  40. package/src/color-card.stories.tsx +61 -0
  41. package/src/color-card.tsx +270 -0
  42. package/src/color-picker.stories.tsx +65 -0
  43. package/src/color-picker.tsx +425 -0
  44. package/src/command-palette.tsx +306 -0
  45. package/src/copy-block.stories.tsx +38 -0
  46. package/src/copy-block.tsx +85 -0
  47. package/src/data-table.stories.tsx +200 -0
  48. package/src/data-table.tsx +1106 -0
  49. package/src/date-picker.stories.tsx +61 -0
  50. package/src/date-picker.tsx +422 -0
  51. package/src/design-cards.stories.tsx +458 -0
  52. package/src/dialog.stories.tsx +48 -0
  53. package/src/dialog.tsx +166 -0
  54. package/src/documents/barcode-svg.stories.tsx +72 -0
  55. package/src/documents/barcode-svg.tsx +79 -0
  56. package/src/dropdown-menu.stories.tsx +77 -0
  57. package/src/dropdown-menu.tsx +271 -0
  58. package/src/editor/behaviour.ts +279 -0
  59. package/src/editor/block-ids.ts +44 -0
  60. package/src/editor/block-list.tsx +101 -0
  61. package/src/editor/block-toolbar.tsx +477 -0
  62. package/src/editor/bubble.tsx +93 -0
  63. package/src/editor/catalogue.ts +103 -0
  64. package/src/editor/collab-rail.tsx +746 -0
  65. package/src/editor/collab.stories.tsx +207 -0
  66. package/src/editor/collab.ts +87 -0
  67. package/src/editor/contract.ts +408 -0
  68. package/src/editor/convert.ts +362 -0
  69. package/src/editor/doc-editor.stories.tsx +98 -0
  70. package/src/editor/doc-editor.tsx +1287 -0
  71. package/src/editor/editor.css +536 -0
  72. package/src/editor/extensions.ts +86 -0
  73. package/src/editor/field-picker.tsx +107 -0
  74. package/src/editor/fields.ts +100 -0
  75. package/src/editor/gutter.tsx +367 -0
  76. package/src/editor/index.ts +22 -0
  77. package/src/editor/label-sheet.tsx +289 -0
  78. package/src/editor/labels.ts +310 -0
  79. package/src/editor/link-tools.tsx +141 -0
  80. package/src/editor/node-views.tsx +450 -0
  81. package/src/editor/page-view.tsx +353 -0
  82. package/src/editor/publish-check.tsx +182 -0
  83. package/src/editor/rich-blocks.stories.tsx +146 -0
  84. package/src/editor/sample.ts +40 -0
  85. package/src/editor/schema-rich.ts +150 -0
  86. package/src/editor/schema.ts +315 -0
  87. package/src/editor/services.tsx +127 -0
  88. package/src/editor/slash.ts +64 -0
  89. package/src/editor/suggesting.ts +372 -0
  90. package/src/editor/suggestions.ts +763 -0
  91. package/src/editor/table-keys.ts +66 -0
  92. package/src/editor/templates.stories.tsx +324 -0
  93. package/src/editor/toolbar.tsx +358 -0
  94. package/src/empty-state.stories.tsx +51 -0
  95. package/src/empty-state.tsx +100 -0
  96. package/src/empty-state.usage-notes.md +30 -0
  97. package/src/form.stories.tsx +112 -0
  98. package/src/form.tsx +176 -0
  99. package/src/globals.css +20 -0
  100. package/src/icon-button.tsx +85 -0
  101. package/src/icon-map.ts +244 -0
  102. package/src/icon.tsx +41 -0
  103. package/src/index.ts +67 -0
  104. package/src/input.stories.tsx +157 -0
  105. package/src/input.tsx +759 -0
  106. package/src/locked-screen.stories.tsx +29 -0
  107. package/src/locked-screen.tsx +61 -0
  108. package/src/mark.tsx +62 -0
  109. package/src/math-text.stories.tsx +33 -0
  110. package/src/math-text.tsx +43 -0
  111. package/src/menu-bar.stories.tsx +198 -0
  112. package/src/menu-bar.tsx +373 -0
  113. package/src/money/currency.ts +230 -0
  114. package/src/page-header.stories.tsx +95 -0
  115. package/src/page-header.tsx +122 -0
  116. package/src/page-shell.stories.tsx +42 -0
  117. package/src/page-shell.tsx +32 -0
  118. package/src/pagination.stories.tsx +45 -0
  119. package/src/pagination.tsx +98 -0
  120. package/src/plugin-card.stories.tsx +180 -0
  121. package/src/plugin-card.tsx +848 -0
  122. package/src/popover.stories.tsx +48 -0
  123. package/src/popover.tsx +55 -0
  124. package/src/radio-group.stories.tsx +26 -0
  125. package/src/radio-group.tsx +44 -0
  126. package/src/route-flow/editor.tsx +1014 -0
  127. package/src/route-flow/model.ts +716 -0
  128. package/src/scope-grant.tsx +139 -0
  129. package/src/screen-too-small.stories.tsx +61 -0
  130. package/src/screen-too-small.tsx +104 -0
  131. package/src/select.stories.tsx +44 -0
  132. package/src/select.tsx +197 -0
  133. package/src/separator.stories.tsx +34 -0
  134. package/src/separator.tsx +34 -0
  135. package/src/sheet.stories.tsx +49 -0
  136. package/src/sheet.tsx +168 -0
  137. package/src/skeleton.stories.tsx +28 -0
  138. package/src/skeleton.tsx +19 -0
  139. package/src/slider.stories.tsx +78 -0
  140. package/src/slider.tsx +300 -0
  141. package/src/spinner.stories.tsx +33 -0
  142. package/src/spinner.tsx +55 -0
  143. package/src/switch.stories.tsx +42 -0
  144. package/src/switch.tsx +41 -0
  145. package/src/switcher.stories.tsx +111 -0
  146. package/src/switcher.tsx +131 -0
  147. package/src/table.stories.tsx +48 -0
  148. package/src/table.tsx +121 -0
  149. package/src/tabs.stories.tsx +74 -0
  150. package/src/tabs.tsx +90 -0
  151. package/src/tag-input.stories.tsx +67 -0
  152. package/src/tag-input.tsx +117 -0
  153. package/src/tenant-logo.tsx +63 -0
  154. package/src/tenant-switcher.stories.tsx +38 -0
  155. package/src/tenant-switcher.tsx +164 -0
  156. package/src/textarea.stories.tsx +27 -0
  157. package/src/textarea.tsx +18 -0
  158. package/src/theme-mode.ts +52 -0
  159. package/src/time-picker.stories.tsx +62 -0
  160. package/src/time-picker.tsx +615 -0
  161. package/src/toggle-group.tsx +138 -0
  162. package/src/tooltip.stories.tsx +43 -0
  163. package/src/tooltip.tsx +73 -0
  164. package/src/top-nav.stories.tsx +58 -0
  165. package/src/top-nav.tsx +324 -0
  166. package/src/undo-bar.tsx +107 -0
  167. package/src/utils.ts +45 -0
  168. package/src/view-toggle.stories.tsx +84 -0
  169. package/src/view-toggle.tsx +110 -0
@@ -0,0 +1,306 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { cn } from "./utils"
6
+
7
+ /**
8
+ * A searchable, keyboard-driven command list — the `/` or Ctrl-K surface.
9
+ *
10
+ * BUILT FROM PRIMITIVES RATHER THAN `cmdk`. The platform's stated selling
11
+ * point is a lean, near-zero-dependency stack (ADR 0003), and what a palette
12
+ * actually needs — filter a list, move a cursor, run a callback — is less code
13
+ * than the wiring a dependency would take. Nothing here is novel; the value is
14
+ * in not owing anyone an upgrade for it.
15
+ *
16
+ * PRESENTATIONAL AND CONTROLLED. It holds the query and the cursor, because
17
+ * those die with the dialog; it holds no notion of what a command IS. The
18
+ * caller supplies items and decides what running one means, which is what lets
19
+ * the document designer feed it a flattened menu registry while another screen
20
+ * feeds it something else entirely.
21
+ *
22
+ * COPY ARRIVES AS PROPS, with English defaults, for the reason every component
23
+ * in this package does: `@whity/ui` is published standalone and may not
24
+ * depend on the i18n feature (#758). Translating is the consumer's job.
25
+ */
26
+
27
+ export interface CommandPaletteItem {
28
+ id: string
29
+ label: string
30
+ /** Heading this item sits under. Items are shown in the order given, grouped by first appearance. */
31
+ group?: string
32
+ /** Rendered right-aligned, e.g. "Ctrl+S". Never used for matching. */
33
+ shortcut?: string
34
+ icon?: React.ReactNode
35
+ /**
36
+ * Extra words that should MATCH but need not be shown — a block's scope, an
37
+ * element's other name ("picture" finding "image").
38
+ */
39
+ keywords?: string
40
+ /**
41
+ * Shown greyed and skipped by the cursor, never hidden.
42
+ *
43
+ * A command absent from the list reads as "this editor cannot do that"; a
44
+ * command present and greyed reads as "not right now", which is the true
45
+ * statement and the one that stops somebody hunting through menus for
46
+ * something that was never going to be available.
47
+ */
48
+ disabled?: boolean
49
+ /**
50
+ * Secondary words after the label, never matched against ("JOD 301.600 ·
51
+ * overdue"): what tells two records with similar names apart.
52
+ */
53
+ hint?: string
54
+ /**
55
+ * Shown whatever the query, and not filtered by it: the "Ask an agent" row,
56
+ * which takes the words as they are (register 2.1c).
57
+ */
58
+ always?: boolean
59
+ /** An agent row: dashed, because nothing has happened until a person approves. */
60
+ agent?: boolean
61
+ onSelect: () => void
62
+ }
63
+
64
+ export interface CommandPaletteProps {
65
+ open: boolean
66
+ onOpenChange: (open: boolean) => void
67
+ items: CommandPaletteItem[]
68
+ placeholder?: string
69
+ emptyLabel?: string
70
+ /** Accessible name for the dialog. */
71
+ label?: string
72
+ /**
73
+ * Called as the query changes, so the caller can fetch results (records
74
+ * from search) and pass them back in `items`. Items the caller supplies
75
+ * this way are still filtered here, so return what the server matched.
76
+ */
77
+ onQueryChange?: (query: string) => void
78
+ /** The keys row at the foot. Omit to hide it. */
79
+ footer?: { move: string; open: string; close: string }
80
+ }
81
+
82
+ /** Case-insensitive subsequence-free substring match over label + keywords. */
83
+ function matches(item: CommandPaletteItem, query: string): boolean {
84
+ if (query === "" || item.always === true) return true
85
+ const q = query.toLowerCase()
86
+ return (
87
+ item.label.toLowerCase().includes(q) ||
88
+ (item.group?.toLowerCase().includes(q) ?? false) ||
89
+ (item.keywords?.toLowerCase().includes(q) ?? false)
90
+ )
91
+ }
92
+
93
+ export function CommandPalette({
94
+ open,
95
+ onOpenChange,
96
+ items,
97
+ placeholder = "Type a command…",
98
+ emptyLabel = "No matching command",
99
+ label = "Command palette",
100
+ onQueryChange,
101
+ footer,
102
+ }: CommandPaletteProps) {
103
+ const [query, setQuery] = React.useState("")
104
+ const [cursor, setCursor] = React.useState(0)
105
+ const inputRef = React.useRef<HTMLInputElement>(null)
106
+ const listRef = React.useRef<HTMLDivElement>(null)
107
+
108
+ const shown = React.useMemo(() => items.filter((i) => matches(i, query)), [items, query])
109
+
110
+ // The indices the cursor may land on. A disabled item is displayed but never
111
+ // selected, so navigation skips it rather than stopping on something Enter
112
+ // would silently ignore.
113
+ const selectable = React.useMemo(
114
+ () => shown.map((item, index) => (item.disabled === true ? -1 : index)).filter((i) => i >= 0),
115
+ [shown]
116
+ )
117
+
118
+ // Reset on open, and whenever the query changes the previous cursor is
119
+ // meaningless — it pointed into a different list.
120
+ React.useEffect(() => {
121
+ if (open) {
122
+ setQuery("")
123
+ setCursor(0)
124
+ // Focus after paint; the input does not exist until this renders.
125
+ const id = requestAnimationFrame(() => inputRef.current?.focus())
126
+ return () => cancelAnimationFrame(id)
127
+ }
128
+ return undefined
129
+ }, [open])
130
+
131
+ React.useEffect(() => {
132
+ setCursor(selectable[0] ?? 0)
133
+ }, [query, selectable])
134
+
135
+ // Escape at the DOCUMENT level, not only on the dialog.
136
+ //
137
+ // Focus arrives a frame late (the input does not exist until this renders),
138
+ // so an Escape pressed in that gap would reach whatever had focus before —
139
+ // in the document designer, a window handler that deselects the canvas — and
140
+ // the palette would stay open having eaten the keystroke. Rare, and exactly
141
+ // the kind of race that shows up as a flaky test rather than a bug report.
142
+ React.useEffect(() => {
143
+ if (!open) return undefined;
144
+ const onEscape = (e: KeyboardEvent) => {
145
+ if (e.key !== 'Escape') return
146
+ e.preventDefault()
147
+ e.stopPropagation()
148
+ onOpenChange(false)
149
+ }
150
+ // Capture phase: ahead of any window listener the host already has.
151
+ document.addEventListener('keydown', onEscape, true)
152
+ return () => document.removeEventListener('keydown', onEscape, true)
153
+ }, [open, onOpenChange])
154
+
155
+ // Keep the highlighted row in view when arrowing past the fold.
156
+ React.useEffect(() => {
157
+ if (!open) return
158
+ const el = listRef.current?.querySelector<HTMLElement>(`[data-index="${cursor}"]`)
159
+ el?.scrollIntoView({ block: "nearest" })
160
+ }, [cursor, open])
161
+
162
+ if (!open) return null
163
+
164
+ const step = (delta: number) => {
165
+ if (selectable.length === 0) return
166
+ const at = selectable.indexOf(cursor)
167
+ const next = at === -1 ? 0 : (at + delta + selectable.length) % selectable.length
168
+ setCursor(selectable[next])
169
+ }
170
+
171
+ const run = (item: CommandPaletteItem | undefined) => {
172
+ if (!item || item.disabled === true) return
173
+ // Close FIRST. A command that opens a dialog of its own would otherwise
174
+ // find this one still mounted and fighting it for focus.
175
+ onOpenChange(false)
176
+ item.onSelect()
177
+ }
178
+
179
+ const onKeyDown = (e: React.KeyboardEvent) => {
180
+ if (e.key === "ArrowDown") {
181
+ e.preventDefault()
182
+ step(1)
183
+ return
184
+ }
185
+ if (e.key === "ArrowUp") {
186
+ e.preventDefault()
187
+ step(-1)
188
+ return
189
+ }
190
+ if (e.key === "Enter") {
191
+ e.preventDefault()
192
+ run(shown[cursor])
193
+ return
194
+ }
195
+ if (e.key === "Escape") {
196
+ e.preventDefault()
197
+ onOpenChange(false)
198
+ }
199
+ // Everything else falls through to the input, including "/" — a palette
200
+ // you cannot type a slash into would be unable to search for anything
201
+ // named with one.
202
+ }
203
+
204
+ let lastGroup: string | undefined
205
+
206
+ return (
207
+ <div
208
+ className="fixed inset-0 z-50 flex items-start justify-center bg-foreground/30 px-4 pt-[12vh]"
209
+ // A backdrop click closes, matching every other dismissible surface. The
210
+ // dialog itself stops propagation below.
211
+ onMouseDown={() => onOpenChange(false)}
212
+ data-testid="command-palette-backdrop"
213
+ >
214
+ <div
215
+ role="dialog"
216
+ aria-modal="true"
217
+ aria-label={label}
218
+ className="w-full max-w-xl overflow-hidden rounded-2xl border border-border bg-popover text-popover-foreground shadow-float"
219
+ onMouseDown={(e) => e.stopPropagation()}
220
+ onKeyDown={onKeyDown}
221
+ data-testid="command-palette"
222
+ >
223
+ <input
224
+ ref={inputRef}
225
+ value={query}
226
+ onChange={(e) => {
227
+ setQuery(e.target.value)
228
+ onQueryChange?.(e.target.value)
229
+ }}
230
+ placeholder={placeholder}
231
+ aria-label={label}
232
+ role="combobox"
233
+ aria-expanded
234
+ aria-controls="command-palette-list"
235
+ aria-activedescendant={shown[cursor] ? `command-item-${shown[cursor].id}` : undefined}
236
+ className="w-full border-b border-border bg-transparent px-4 py-3.5 text-base outline-none placeholder:text-muted-foreground"
237
+ data-testid="command-palette-input"
238
+ />
239
+
240
+ <div
241
+ ref={listRef}
242
+ id="command-palette-list"
243
+ role="listbox"
244
+ aria-label={label}
245
+ className="max-h-80 overflow-y-auto p-1"
246
+ >
247
+ {shown.length === 0 && (
248
+ <p className="px-3 py-6 text-center text-sm text-muted-foreground" data-testid="command-palette-empty">
249
+ {emptyLabel}
250
+ </p>
251
+ )}
252
+
253
+ {shown.map((item, index) => {
254
+ const header = item.group !== undefined && item.group !== lastGroup ? item.group : null
255
+ lastGroup = item.group
256
+
257
+ return (
258
+ <React.Fragment key={item.id}>
259
+ {header !== null && (
260
+ <div className="px-3 pt-3 pb-1 text-[0.8125rem] font-medium text-muted-foreground">
261
+ {header}
262
+ </div>
263
+ )}
264
+ <div
265
+ id={`command-item-${item.id}`}
266
+ role="option"
267
+ aria-selected={index === cursor}
268
+ aria-disabled={item.disabled === true}
269
+ data-index={index}
270
+ data-testid={`command-item-${item.id}`}
271
+ onMouseEnter={() => item.disabled !== true && setCursor(index)}
272
+ onClick={() => run(item)}
273
+ className={cn(
274
+ "flex cursor-pointer items-center gap-2 rounded-md px-3 py-2 text-sm",
275
+ // The selected row is the tint with text in the main colour (7.3).
276
+ index === cursor && item.disabled !== true && "bg-primary-tint text-primary-tint-foreground",
277
+ item.agent === true && "border border-dashed border-input",
278
+ item.disabled === true && "cursor-not-allowed opacity-45"
279
+ )}
280
+ >
281
+ {item.icon !== undefined && <span className="shrink-0 text-muted-foreground">{item.icon}</span>}
282
+ <span className="min-w-0 flex-1 truncate">
283
+ {item.label}
284
+ {item.hint !== undefined && (
285
+ <span className="ms-2 text-[0.8125rem] text-muted-foreground">{item.hint}</span>
286
+ )}
287
+ </span>
288
+ {item.shortcut !== undefined && (
289
+ <span className="shrink-0 text-xs text-muted-foreground">{item.shortcut}</span>
290
+ )}
291
+ </div>
292
+ </React.Fragment>
293
+ )
294
+ })}
295
+ </div>
296
+ {footer !== undefined && (
297
+ <div className="flex gap-4 border-t border-border px-4 py-2 text-[0.8125rem] text-muted-foreground">
298
+ <span><kbd className="me-1 rounded border border-border px-1 font-mono text-[0.6875rem]">↑↓</kbd>{footer.move}</span>
299
+ <span><kbd className="me-1 rounded border border-border px-1 font-mono text-[0.6875rem]">Enter</kbd>{footer.open}</span>
300
+ <span><kbd className="me-1 rounded border border-border px-1 font-mono text-[0.6875rem]">Esc</kbd>{footer.close}</span>
301
+ </div>
302
+ )}
303
+ </div>
304
+ </div>
305
+ )
306
+ }
@@ -0,0 +1,38 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import { CopyBlock } from "./copy-block"
4
+
5
+ const meta = {
6
+ title: "Primitives/CopyBlock",
7
+ component: CopyBlock,
8
+ tags: ["autodocs"],
9
+ } satisfies Meta<typeof CopyBlock>
10
+
11
+ export default meta
12
+ type Story = StoryObj<typeof meta>
13
+
14
+ export const Command: Story = {
15
+ args: {
16
+ value: 'claude mcp add --transport http whity "https://api.example.com/mcp" --header "Authorization: Bearer eyJ…"',
17
+ },
18
+ }
19
+
20
+ export const File: Story = {
21
+ args: {
22
+ caption: "~/.cursor/mcp.json",
23
+ multiline: true,
24
+ value: JSON.stringify(
25
+ { mcpServers: { whity: { url: "https://api.example.com/mcp", headers: { Authorization: "Bearer eyJ…" } } } },
26
+ null,
27
+ 2
28
+ ),
29
+ },
30
+ }
31
+
32
+ export const MaskedSecret: Story = {
33
+ args: {
34
+ caption: "Token",
35
+ value: "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJ4In0.signature",
36
+ display: "eyJhbGci••••••••••••",
37
+ },
38
+ }
@@ -0,0 +1,85 @@
1
+ import * as React from "react"
2
+ import { IconCheck, IconCopy } from "@tabler/icons-react"
3
+
4
+ import { Button } from "./button"
5
+ import { cn } from "./utils"
6
+
7
+ export interface CopyBlockProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onCopy"> {
8
+ /** The exact text copied, and shown unless `display` is given. */
9
+ value: string
10
+ /** What to show instead of `value` — a masked secret, say. The copy is still `value`. */
11
+ display?: string
12
+ /** A caption above the block: a file path, a field name. */
13
+ caption?: React.ReactNode
14
+ /** Render as a multi-line code block (a command or file) rather than one line. */
15
+ multiline?: boolean
16
+ copyLabel?: string
17
+ copiedLabel?: string
18
+ /** Called after a copy attempt, so the consumer can toast. */
19
+ onCopy?: (copied: boolean) => void
20
+ }
21
+
22
+ /**
23
+ * Text the user is meant to copy somewhere else — a command, a config file, a
24
+ * token — with a copy button.
25
+ *
26
+ * Shown as code: left-to-right and monospaced even in an RTL layout, because
27
+ * the text is read by a program, not a person.
28
+ */
29
+ export function CopyBlock({
30
+ value,
31
+ display,
32
+ caption,
33
+ multiline = false,
34
+ copyLabel = "Copy",
35
+ copiedLabel = "Copied",
36
+ onCopy,
37
+ className,
38
+ ...props
39
+ }: CopyBlockProps) {
40
+ const [copied, setCopied] = React.useState(false)
41
+
42
+ React.useEffect(() => {
43
+ if (!copied) return
44
+ const timer = setTimeout(() => setCopied(false), 2000)
45
+ return () => clearTimeout(timer)
46
+ }, [copied])
47
+
48
+ const copy = async () => {
49
+ try {
50
+ await navigator.clipboard.writeText(value)
51
+ setCopied(true)
52
+ onCopy?.(true)
53
+ } catch {
54
+ onCopy?.(false)
55
+ }
56
+ }
57
+
58
+ return (
59
+ <div data-slot="copy-block" className={cn("space-y-1", className)} {...props}>
60
+ {caption !== undefined && <div className="text-xs font-medium text-muted-foreground">{caption}</div>}
61
+ <div className="relative rounded-md border border-border bg-muted">
62
+ <pre
63
+ dir="ltr"
64
+ className={cn(
65
+ "overflow-x-auto py-2 ps-3 pe-12 text-start font-mono text-xs text-foreground",
66
+ multiline ? "whitespace-pre" : "whitespace-nowrap"
67
+ )}
68
+ >
69
+ <code>{display ?? value}</code>
70
+ </pre>
71
+ <Button
72
+ type="button"
73
+ variant="ghost"
74
+ size="icon-sm"
75
+ onClick={copy}
76
+ aria-label={copied ? copiedLabel : copyLabel}
77
+ title={copied ? copiedLabel : copyLabel}
78
+ className="absolute end-1.5 top-1.5"
79
+ >
80
+ {copied ? <IconCheck size={14} /> : <IconCopy size={14} />}
81
+ </Button>
82
+ </div>
83
+ </div>
84
+ )
85
+ }
@@ -0,0 +1,200 @@
1
+ import { useState, type ReactElement } from "react"
2
+ import type { Meta, StoryObj } from "@storybook/react-vite"
3
+ import { IconDatabaseOff } from "@tabler/icons-react"
4
+
5
+ import { Button } from "./button"
6
+ import { Badge } from "./badge"
7
+ import { DataTable, type DataTableColumn, type DataTableProps } from "./data-table"
8
+
9
+ interface UserRow {
10
+ id: number
11
+ name: string
12
+ email: string
13
+ role: string
14
+ createdAt: string
15
+ }
16
+
17
+ const columns: DataTableColumn<UserRow>[] = [
18
+ { accessorKey: "name", header: "Name", enableSorting: true, enableColumnFilter: true },
19
+ { accessorKey: "email", header: "Email", enableSorting: true, enableColumnFilter: true },
20
+ { accessorKey: "role", header: "Role", enableSorting: true },
21
+ { accessorKey: "createdAt", header: "Created" },
22
+ ]
23
+
24
+ const rows: UserRow[] = [
25
+ { id: 1, name: "Ada Lovelace", email: "ada@acme.test", role: "admin", createdAt: "2026-01-04" },
26
+ { id: 2, name: "Alan Turing", email: "alan@acme.test", role: "editor", createdAt: "2026-02-11" },
27
+ { id: 3, name: "Grace Hopper", email: "grace@acme.test", role: "viewer", createdAt: "2026-03-20" },
28
+ { id: 4, name: "Margaret Hamilton", email: "margaret@acme.test", role: "editor", createdAt: "2026-04-02" },
29
+ { id: 5, name: "Katherine Johnson", email: "katherine@acme.test", role: "viewer", createdAt: "2026-05-18" },
30
+ ]
31
+
32
+ // DataTable is generic (`<T>`); casting `component` to a monomorphic UserRow
33
+ // signature makes Storybook's `args` infer as UserRow instead of `unknown`.
34
+ const meta = {
35
+ title: "Primitives/DataTable",
36
+ component: DataTable as (props: DataTableProps<UserRow>) => ReactElement,
37
+ tags: ["autodocs"],
38
+ parameters: { layout: "padded" },
39
+ } satisfies Meta<(props: DataTableProps<UserRow>) => ReactElement>
40
+
41
+ export default meta
42
+ type Story = StoryObj<typeof meta>
43
+
44
+ export const Default: Story = {
45
+ args: { columns, data: rows },
46
+ }
47
+
48
+ export const WithRowActions: Story = {
49
+ args: {
50
+ columns,
51
+ data: rows,
52
+ rowActions: () => (
53
+ <div className="flex justify-end gap-2">
54
+ <Button size="xs" variant="outline">Edit</Button>
55
+ <Button size="xs" variant="destructive">Delete</Button>
56
+ </div>
57
+ ),
58
+ },
59
+ }
60
+
61
+ export const WithCustomCells: Story = {
62
+ args: {
63
+ columns: [
64
+ ...columns.slice(0, 2),
65
+ {
66
+ id: "role",
67
+ header: "Role",
68
+ cell: (row) => (
69
+ <Badge variant={row.role === "admin" ? "default" : "secondary"}>{row.role}</Badge>
70
+ ),
71
+ },
72
+ ],
73
+ data: rows,
74
+ },
75
+ }
76
+
77
+ export const WithFilteringAndSearch: Story = {
78
+ args: {
79
+ columns,
80
+ data: rows,
81
+ enableGlobalFilter: true,
82
+ globalFilterPlaceholder: "Search users…",
83
+ },
84
+ }
85
+
86
+ export const WithColumnVisibility: Story = {
87
+ args: { columns, data: rows, enableColumnVisibility: true },
88
+ }
89
+
90
+ export const WithClientPagination: Story = {
91
+ args: { columns, data: rows, pagination: { pageSize: 2 } },
92
+ }
93
+
94
+ function ServerPaginatedExample() {
95
+ const pageSize = 2
96
+ const pageCount = Math.ceil(rows.length / pageSize)
97
+ const [pageIndex, setPageIndex] = useState(0)
98
+ const page = rows.slice(pageIndex * pageSize, pageIndex * pageSize + pageSize)
99
+ return (
100
+ <DataTable
101
+ columns={columns}
102
+ data={page}
103
+ pagination={{
104
+ pageIndex,
105
+ pageSize,
106
+ pageCount,
107
+ total: rows.length,
108
+ onPaginationChange: (nextPageIndex) => setPageIndex(nextPageIndex),
109
+ }}
110
+ />
111
+ )
112
+ }
113
+
114
+ export const WithServerPagination: Story = {
115
+ args: { columns, data: rows },
116
+ render: () => <ServerPaginatedExample />,
117
+ }
118
+
119
+ /**
120
+ * The whole server-side story: page, sort and search all owned by the caller.
121
+ *
122
+ * The sorting and searching here are stand-ins for what a real caller's API
123
+ * would do — the point of the story is that the TABLE does neither. It renders
124
+ * the chevrons and the box, reports the clicks and the keystrokes, and shows
125
+ * the rows in the order it was handed them.
126
+ */
127
+ function ServerDrivenExample() {
128
+ const pageSize = 2
129
+ const [pageIndex, setPageIndex] = useState(0)
130
+ const [sortKey, setSortKey] = useState<string | null>("name")
131
+ const [direction, setDirection] = useState<"asc" | "desc">("asc")
132
+ const [search, setSearch] = useState("")
133
+
134
+ // Stands in for the endpoint. A real caller re-fetches instead.
135
+ const matched = search
136
+ ? rows.filter((row) =>
137
+ `${row.name} ${row.email} ${row.role}`.toLowerCase().includes(search.toLowerCase())
138
+ )
139
+ : rows
140
+ const ordered = sortKey
141
+ ? [...matched].sort((a, b) => {
142
+ const [x, y] = [a, b].map((row) => String(row[sortKey as keyof UserRow]))
143
+ return direction === "asc" ? x.localeCompare(y) : y.localeCompare(x)
144
+ })
145
+ : matched
146
+ const page = ordered.slice(pageIndex * pageSize, pageIndex * pageSize + pageSize)
147
+
148
+ return (
149
+ <DataTable
150
+ columns={columns}
151
+ data={page}
152
+ pagination={{
153
+ pageIndex,
154
+ pageSize,
155
+ pageCount: Math.max(1, Math.ceil(ordered.length / pageSize)),
156
+ total: ordered.length,
157
+ onPaginationChange: (nextPageIndex) => setPageIndex(nextPageIndex),
158
+ }}
159
+ sorting={{
160
+ sortKey,
161
+ direction,
162
+ onSortingChange: (nextKey, nextDirection) => {
163
+ setSortKey(nextKey)
164
+ setDirection(nextDirection)
165
+ // Changing the sort invalidates the offset — the caller's job.
166
+ setPageIndex(0)
167
+ },
168
+ }}
169
+ search={{
170
+ value: search,
171
+ onSearchChange: (value) => {
172
+ setSearch(value)
173
+ setPageIndex(0)
174
+ },
175
+ }}
176
+ />
177
+ )
178
+ }
179
+
180
+ export const WithServerSortingAndSearch: Story = {
181
+ args: { columns, data: rows },
182
+ render: () => <ServerDrivenExample />,
183
+ }
184
+
185
+ export const Loading: Story = {
186
+ args: { columns, data: [], isLoading: true },
187
+ }
188
+
189
+ export const Empty: Story = {
190
+ args: {
191
+ columns,
192
+ data: [],
193
+ emptyState: {
194
+ icon: <IconDatabaseOff />,
195
+ title: "No users yet",
196
+ description: "Invite your first teammate to get started.",
197
+ action: <Button size="sm">Invite user</Button>,
198
+ },
199
+ },
200
+ }