@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.
- package/README.md +107 -3
- package/package.json +192 -6
- package/src/access-denied.stories.tsx +179 -0
- package/src/access-denied.tsx +305 -0
- package/src/action-proposal.tsx +302 -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 +500 -0
- package/src/approval-queue.tsx +108 -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.tsx +83 -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 +183 -0
- package/src/breadcrumb.stories.tsx +51 -0
- package/src/breadcrumb.tsx +90 -0
- package/src/button.stories.tsx +87 -0
- package/src/button.tsx +118 -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/command-palette.tsx +306 -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 +1106 -0
- package/src/date-picker.stories.tsx +61 -0
- package/src/date-picker.tsx +422 -0
- package/src/design-cards.stories.tsx +458 -0
- package/src/dialog.stories.tsx +48 -0
- package/src/dialog.tsx +166 -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/behaviour.ts +279 -0
- package/src/editor/block-ids.ts +44 -0
- package/src/editor/block-list.tsx +101 -0
- package/src/editor/block-toolbar.tsx +477 -0
- package/src/editor/bubble.tsx +93 -0
- package/src/editor/catalogue.ts +103 -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 +408 -0
- package/src/editor/convert.ts +362 -0
- package/src/editor/doc-editor.stories.tsx +98 -0
- package/src/editor/doc-editor.tsx +1287 -0
- package/src/editor/editor.css +536 -0
- package/src/editor/extensions.ts +86 -0
- package/src/editor/field-picker.tsx +107 -0
- package/src/editor/fields.ts +100 -0
- package/src/editor/gutter.tsx +367 -0
- package/src/editor/index.ts +22 -0
- package/src/editor/label-sheet.tsx +289 -0
- package/src/editor/labels.ts +310 -0
- package/src/editor/link-tools.tsx +141 -0
- package/src/editor/node-views.tsx +450 -0
- package/src/editor/page-view.tsx +353 -0
- package/src/editor/publish-check.tsx +182 -0
- package/src/editor/rich-blocks.stories.tsx +146 -0
- package/src/editor/sample.ts +40 -0
- package/src/editor/schema-rich.ts +150 -0
- package/src/editor/schema.ts +315 -0
- package/src/editor/services.tsx +127 -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 +358 -0
- package/src/empty-state.stories.tsx +51 -0
- package/src/empty-state.tsx +100 -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 +244 -0
- package/src/icon.tsx +41 -0
- package/src/index.ts +67 -0
- package/src/input.stories.tsx +157 -0
- package/src/input.tsx +759 -0
- package/src/locked-screen.stories.tsx +29 -0
- package/src/locked-screen.tsx +61 -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/money/currency.ts +230 -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/pagination.stories.tsx +45 -0
- package/src/pagination.tsx +98 -0
- package/src/plugin-card.stories.tsx +180 -0
- package/src/plugin-card.tsx +848 -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 +1014 -0
- package/src/route-flow/model.ts +716 -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/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/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/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-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,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
|
+
}
|