@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,279 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { IconX } from "@tabler/icons-react"
5
+
6
+ import { cn } from "./utils"
7
+ import { Badge } from "./badge"
8
+ import { Button } from "./button"
9
+ import { Input } from "./input"
10
+
11
+ /**
12
+ * Naming PEOPLE, one at a time, for the hand-picked case (#1015, over #999's
13
+ * `explicit` rule kind).
14
+ *
15
+ * WHY A ROSTER IS ALLOWED HERE AND NOWHERE ELSE
16
+ * ---------------------------------------------
17
+ * Everything else about document routing argues against enumerating people: a
18
+ * step names a rule, and a stored list of names is wrong the moment somebody is
19
+ * hired. `explicit` is the deliberate exception, and it is an exception with a
20
+ * meaning rather than an escape hatch — "the tender committee is Aisha, Omar and
21
+ * Lena" is a real requirement that no computed rule expresses, and it MEANS
22
+ * those three. A fourth person joining the department must not silently join the
23
+ * committee.
24
+ *
25
+ * So this control is for choosing a handful, and its shape says so: a search box
26
+ * and a bounded result list rather than a scrollable roster of the whole
27
+ * organisation. A picker that renders four thousand rows has rebuilt the problem
28
+ * user groups exist to remove — the thousand nodes standing in for the one that
29
+ * says "instructors" — on the screen where somebody is trying to name three
30
+ * people.
31
+ *
32
+ * NO CEILING IS MIRRORED HERE, ON PURPOSE
33
+ * ---------------------------------------
34
+ * The server refuses an `explicit` rule naming more people than it will accept,
35
+ * and its refusal names the number and says what to do instead. This component
36
+ * does not carry a copy of that number. A mirrored limit is a second copy of a
37
+ * value that only the server actually enforces: wrong on the first install that
38
+ * changes it, and wrong in the direction that blocks legitimate work. The same
39
+ * position the route composer already takes for the per-step recipient ceiling —
40
+ * limits are surfaced, not mirrored.
41
+ *
42
+ * FETCHES NOTHING, TRANSLATES NOTHING. People arrive as a prop and every visible
43
+ * string is a label prop with an English default, like every other
44
+ * `@whity/ui` input.
45
+ */
46
+
47
+ /** One person who may be named. */
48
+ export interface AudiencePersonOption {
49
+ /** Profile id — what the rule stores, and what survives a rename. */
50
+ id: number
51
+ name: string
52
+ /** An email or unit, shown to tell two people of the same name apart. */
53
+ secondary?: string | null
54
+ }
55
+
56
+ export interface AudiencePeoplePickerProps {
57
+ id?: string
58
+ /** The catalogue to search, already fetched by the caller. */
59
+ people: AudiencePersonOption[]
60
+ /** Chosen profile ids, in the order they were chosen. */
61
+ value: number[]
62
+ onChange: (profileIds: number[]) => void
63
+ /**
64
+ * Why there is nobody to choose from — typically a 403 on the people
65
+ * catalogue. Rendered instead of an empty search box, which would read as "this
66
+ * workspace has no people".
67
+ */
68
+ unavailableReason?: string | null
69
+ /** Why the catalogue may be incomplete, when it loaded but only partly. */
70
+ incompleteReason?: string | null
71
+ /**
72
+ * How many matches to render at once. A bound, not a page: somebody who cannot
73
+ * find their person in this many should type more, not scroll further.
74
+ */
75
+ maxResults?: number
76
+ disabled?: boolean
77
+ className?: string
78
+
79
+ // -- labels, English by default ------------------------------------------
80
+
81
+ searchPlaceholder?: string
82
+ /** No people in the catalogue at all. */
83
+ emptyLabel?: string
84
+ /** Nothing chosen yet. */
85
+ nothingSelectedLabel?: string
86
+ /** The query matched nobody. */
87
+ noMatchesLabel?: string
88
+ /** More matched than are being shown. */
89
+ moreMatchesLabel?: (shown: number, total: number) => string
90
+ /** Accessible name for a chip's remove button. */
91
+ removeLabel?: (name: string) => string
92
+ /** For a chosen id that is not in the catalogue the caller supplied. */
93
+ unknownPersonLabel?: (profileId: number) => string
94
+ }
95
+
96
+ /**
97
+ * A searchable multi-person picker.
98
+ *
99
+ * Controlled: `value` is the list of chosen profile ids, and an empty list is
100
+ * the state a caller must treat as "not configured yet" — the server refuses an
101
+ * `explicit` rule that names nobody rather than accepting it as "nobody".
102
+ */
103
+ export function AudiencePeoplePicker({
104
+ id,
105
+ people,
106
+ value,
107
+ onChange,
108
+ unavailableReason = null,
109
+ incompleteReason = null,
110
+ maxResults = 8,
111
+ disabled = false,
112
+ className,
113
+ searchPlaceholder = "Search people by name",
114
+ emptyLabel = "There is nobody here to name.",
115
+ nothingSelectedLabel = "Nobody chosen yet.",
116
+ noMatchesLabel = "Nobody matches that.",
117
+ moreMatchesLabel = (shown: number, total: number) =>
118
+ `Showing ${shown} of ${total} matches — keep typing to narrow it down.`,
119
+ removeLabel = (name: string) => `Remove ${name}`,
120
+ unknownPersonLabel = (profileId: number) => `Profile #${profileId}`,
121
+ }: AudiencePeoplePickerProps) {
122
+ const [query, setQuery] = React.useState("")
123
+
124
+ const byId = React.useMemo(() => {
125
+ const map = new Map<number, AudiencePersonOption>()
126
+ for (const person of people) map.set(person.id, person)
127
+ return map
128
+ }, [people])
129
+
130
+ const chosen = React.useMemo(() => new Set(value), [value])
131
+
132
+ const matches = React.useMemo(() => {
133
+ const needle = query.trim().toLocaleLowerCase()
134
+ // An empty query shows nothing rather than everybody. This is a picker for
135
+ // naming a few, and opening it with the whole organisation already listed
136
+ // invites scrolling through it, which is the reading the `explicit` kind is
137
+ // deliberately not for.
138
+ if (needle === "") return []
139
+ return people.filter((person) => {
140
+ if (chosen.has(person.id)) return false
141
+ const secondary = person.secondary ?? ""
142
+ return (
143
+ person.name.toLocaleLowerCase().includes(needle) ||
144
+ secondary.toLocaleLowerCase().includes(needle)
145
+ )
146
+ })
147
+ }, [people, query, chosen])
148
+
149
+ if (unavailableReason !== null && unavailableReason !== "") {
150
+ return (
151
+ <p
152
+ data-slot="audience-people-picker-unavailable"
153
+ className={cn("text-xs text-muted-foreground", className)}
154
+ >
155
+ {unavailableReason}
156
+ </p>
157
+ )
158
+ }
159
+
160
+ if (people.length === 0) {
161
+ return (
162
+ <p
163
+ data-slot="audience-people-picker-empty"
164
+ className={cn("text-xs text-muted-foreground", className)}
165
+ >
166
+ {emptyLabel}
167
+ </p>
168
+ )
169
+ }
170
+
171
+ const add = (profileId: number): void => {
172
+ if (chosen.has(profileId)) return
173
+ onChange([...value, profileId])
174
+ setQuery("")
175
+ }
176
+
177
+ const remove = (profileId: number): void => {
178
+ onChange(value.filter((existing) => existing !== profileId))
179
+ }
180
+
181
+ const shown = matches.slice(0, maxResults)
182
+
183
+ return (
184
+ <div
185
+ data-slot="audience-people-picker"
186
+ className={cn("space-y-2", className)}
187
+ >
188
+ <div className="flex flex-wrap gap-1.5" data-slot="audience-people-picker-chosen">
189
+ {value.length === 0 ? (
190
+ <span className="text-xs text-muted-foreground">
191
+ {nothingSelectedLabel}
192
+ </span>
193
+ ) : (
194
+ value.map((profileId) => {
195
+ const person = byId.get(profileId)
196
+ const name = person?.name ?? unknownPersonLabel(profileId)
197
+ return (
198
+ <Badge key={profileId} variant="secondary" className="gap-1 pe-1">
199
+ {name}
200
+ {!disabled && (
201
+ <button
202
+ type="button"
203
+ aria-label={removeLabel(name)}
204
+ onClick={() => remove(profileId)}
205
+ className="rounded-full p-0.5 outline-none hover:bg-muted-foreground/20 focus-visible:ring-2 focus-visible:ring-ring/30"
206
+ >
207
+ <IconX className="size-2.5" />
208
+ </button>
209
+ )}
210
+ </Badge>
211
+ )
212
+ })
213
+ )}
214
+ </div>
215
+
216
+ {!disabled && (
217
+ <>
218
+ <Input
219
+ id={id}
220
+ type="search"
221
+ value={query}
222
+ aria-label={searchPlaceholder}
223
+ placeholder={searchPlaceholder}
224
+ onChange={(event) => setQuery(event.target.value)}
225
+ />
226
+
227
+ {query.trim() !== "" && (
228
+ <div data-slot="audience-people-picker-results">
229
+ {matches.length === 0 ? (
230
+ <p className="text-xs text-muted-foreground">{noMatchesLabel}</p>
231
+ ) : (
232
+ <>
233
+ <ul className="space-y-1">
234
+ {shown.map((person) => (
235
+ <li key={person.id}>
236
+ <Button
237
+ variant="ghost"
238
+ size="sm"
239
+ // `justify-start` is a flex alignment on the writing
240
+ // axis, so it follows the document direction — the
241
+ // reason this is not `justify-left`.
242
+ className="w-full justify-start"
243
+ onClick={() => add(person.id)}
244
+ >
245
+ <span className="truncate">{person.name}</span>
246
+ {person.secondary !== undefined &&
247
+ person.secondary !== null &&
248
+ person.secondary !== "" && (
249
+ <span className="ms-2 truncate text-xs text-muted-foreground">
250
+ {person.secondary}
251
+ </span>
252
+ )}
253
+ </Button>
254
+ </li>
255
+ ))}
256
+ </ul>
257
+ {matches.length > shown.length && (
258
+ <p className="mt-1 text-xs text-muted-foreground">
259
+ {moreMatchesLabel(shown.length, matches.length)}
260
+ </p>
261
+ )}
262
+ </>
263
+ )}
264
+ </div>
265
+ )}
266
+ </>
267
+ )}
268
+
269
+ {incompleteReason !== null && incompleteReason !== "" && (
270
+ <p
271
+ data-slot="audience-people-picker-incomplete"
272
+ className="text-xs text-muted-foreground"
273
+ >
274
+ {incompleteReason}
275
+ </p>
276
+ )}
277
+ </div>
278
+ )
279
+ }
package/src/avatar.tsx ADDED
@@ -0,0 +1,83 @@
1
+ import { Icon } from "./icon"
2
+ import { Mark } from "./mark"
3
+ import { cn } from "./utils"
4
+
5
+ export type ActorKind = "person" | "agent" | "system"
6
+
7
+ /** Up to two initials, from the first letters of the first two words. */
8
+ function initials(name: string): string {
9
+ return (
10
+ name
11
+ .split(/\s+/)
12
+ .filter(Boolean)
13
+ .slice(0, 2)
14
+ .map((word) => word.charAt(0))
15
+ .join("")
16
+ .toUpperCase() || "?"
17
+ )
18
+ }
19
+
20
+ /**
21
+ * Who did something, at a glance: people get their initials on grey (or a
22
+ * photo), agents the robot face on the tint, and the system the Whity mark.
23
+ * Agents never get a human face or a photo (stage 8). An optional dot shows
24
+ * presence. The reference is docs/design/components/Avatar (`.wy-avatar`).
25
+ */
26
+ function Avatar({
27
+ name,
28
+ kind = "person",
29
+ src,
30
+ size = 32,
31
+ status,
32
+ labels,
33
+ className,
34
+ }: {
35
+ name: string
36
+ kind?: ActorKind
37
+ /** A photo, for people only. */
38
+ src?: string
39
+ size?: number
40
+ status?: "online" | "busy" | "offline"
41
+ /** Overrides for the accessible name suffixes, e.g. Arabic. */
42
+ labels?: { agent?: string }
43
+ className?: string
44
+ }) {
45
+ const L = { agent: "agent", ...labels }
46
+ return (
47
+ <span
48
+ data-slot="avatar"
49
+ data-kind={kind}
50
+ role="img"
51
+ aria-label={kind === "agent" ? `${name} (${L.agent})` : name}
52
+ style={{ width: size, height: size, fontSize: Math.max(11, Math.round(size * 0.36)) }}
53
+ className={cn(
54
+ "relative inline-grid shrink-0 place-items-center rounded-full leading-none font-semibold",
55
+ kind === "agent" && "bg-primary-tint text-primary-tint-foreground",
56
+ kind === "system" && "bg-card shadow-[inset_0_0_0_1px_var(--border)]",
57
+ kind === "person" && "bg-muted text-foreground",
58
+ className
59
+ )}
60
+ >
61
+ {kind === "agent" ? (
62
+ <Icon name="robot" size={Math.round(size * 0.56)} stroke={2} />
63
+ ) : kind === "system" ? (
64
+ <Mark size={Math.round(size * 0.62)} label="" />
65
+ ) : src ? (
66
+ <img src={src} alt="" className="size-full rounded-full object-cover" />
67
+ ) : (
68
+ initials(name)
69
+ )}
70
+ {status && (
71
+ <span
72
+ aria-hidden="true"
73
+ className={cn(
74
+ "absolute -end-px -bottom-px box-border size-[32%] min-h-2 min-w-2 rounded-full border-2 border-card",
75
+ status === "online" ? "bg-success" : status === "busy" ? "bg-warning" : "bg-muted-foreground"
76
+ )}
77
+ />
78
+ )}
79
+ </span>
80
+ )
81
+ }
82
+
83
+ export { Avatar, initials }
@@ -0,0 +1,105 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { IconAlertTriangle, IconCheck, IconInfoCircle, IconSparkles } from "@tabler/icons-react"
3
+
4
+ import { Badge } from "./badge"
5
+
6
+ const meta = {
7
+ title: "Primitives/Badge",
8
+ component: Badge,
9
+ tags: ["autodocs"],
10
+ argTypes: {
11
+ variant: {
12
+ control: "select",
13
+ options: [
14
+ "default",
15
+ "secondary",
16
+ "info",
17
+ "success",
18
+ "warning",
19
+ "destructive",
20
+ "outline",
21
+ ],
22
+ },
23
+ },
24
+ args: { children: "Badge", variant: "default" },
25
+ } satisfies Meta<typeof Badge>
26
+
27
+ export default meta
28
+ type Story = StoryObj<typeof meta>
29
+
30
+ export const Playground: Story = {}
31
+
32
+ const VARIANTS = [
33
+ "default",
34
+ "secondary",
35
+ "info",
36
+ "success",
37
+ "warning",
38
+ "destructive",
39
+ "outline",
40
+ ] as const
41
+
42
+ export const AllVariants: Story = {
43
+ render: () => (
44
+ <div className="flex flex-wrap items-center gap-3">
45
+ {VARIANTS.map((variant) => (
46
+ <Badge key={variant} variant={variant}>
47
+ {variant}
48
+ </Badge>
49
+ ))}
50
+ </div>
51
+ ),
52
+ }
53
+
54
+ export const SubtleVsSolid: Story = {
55
+ render: () => (
56
+ <div className="flex flex-col gap-3">
57
+ <div className="flex flex-wrap items-center gap-3">
58
+ <Badge variant="info">
59
+ <IconInfoCircle data-icon="inline-start" />
60
+ Info Subtle
61
+ </Badge>
62
+ <Badge variant="info">
63
+ <IconInfoCircle data-icon="inline-start" />
64
+ Info Solid
65
+ </Badge>
66
+ <Badge variant="success">
67
+ <IconCheck data-icon="inline-start" />
68
+ Success Subtle
69
+ </Badge>
70
+ <Badge variant="success">
71
+ <IconCheck data-icon="inline-start" />
72
+ Success Solid
73
+ </Badge>
74
+ </div>
75
+ <div className="flex flex-wrap items-center gap-3">
76
+ <Badge variant="warning">
77
+ <IconAlertTriangle data-icon="inline-start" />
78
+ Warning Subtle
79
+ </Badge>
80
+ <Badge variant="warning">
81
+ <IconAlertTriangle data-icon="inline-start" />
82
+ Warning Solid
83
+ </Badge>
84
+ <Badge variant="destructive">
85
+ <IconAlertTriangle data-icon="inline-start" />
86
+ Destructive Subtle
87
+ </Badge>
88
+ <Badge variant="destructive">
89
+ <IconAlertTriangle data-icon="inline-start" />
90
+ Destructive Solid
91
+ </Badge>
92
+ </div>
93
+ <div className="flex flex-wrap items-center gap-3">
94
+ <Badge variant="secondary">
95
+ <IconSparkles data-icon="inline-start" />
96
+ Purple Subtle
97
+ </Badge>
98
+ <Badge variant="secondary">
99
+ <IconSparkles data-icon="inline-start" />
100
+ Purple Solid
101
+ </Badge>
102
+ </div>
103
+ </div>
104
+ ),
105
+ }
package/src/badge.tsx ADDED
@@ -0,0 +1,68 @@
1
+ import * as React from "react"
2
+ import { cva, type VariantProps } from "class-variance-authority"
3
+ import { Slot } from "radix-ui"
4
+
5
+ import { Icon, type IconName } from "./icon"
6
+ import { cn } from "./utils"
7
+
8
+ /**
9
+ * The reference is docs/design/components/Badge (bundle.css `.wy-badge`).
10
+ * State badges are tinted pills: the status tint behind the status text
11
+ * colour (decision 7.4), never a solid fill. `outline` and `secondary` are
12
+ * for counts and categories; `default` sparingly, for a plan.
13
+ */
14
+ const badgeVariants = cva(
15
+ "group/badge inline-flex h-[22px] w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-full border border-transparent px-[9px] text-xs leading-none font-medium whitespace-nowrap focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring [&>svg]:pointer-events-none [&>svg]:size-3!",
16
+ {
17
+ variants: {
18
+ variant: {
19
+ default: "bg-primary text-primary-foreground",
20
+ secondary: "bg-info-tint text-info-text",
21
+ outline: "border-input bg-card text-foreground",
22
+ success: "bg-success-tint text-success-text",
23
+ info: "bg-info-tint text-info-text",
24
+ warning: "bg-warning-tint text-warning-text",
25
+ destructive: "bg-error-tint text-error-text",
26
+ },
27
+ },
28
+ defaultVariants: {
29
+ variant: "default",
30
+ },
31
+ }
32
+ )
33
+
34
+ function Badge({
35
+ className,
36
+ variant = "default",
37
+ asChild = false,
38
+ icon,
39
+ children,
40
+ ...props
41
+ }: React.ComponentProps<"span"> &
42
+ VariantProps<typeof badgeVariants> & {
43
+ asChild?: boolean
44
+ /** A curated icon before the word. A state badge always carries its word too. */
45
+ icon?: IconName
46
+ }) {
47
+ const Comp = asChild ? Slot.Root : "span"
48
+
49
+ return (
50
+ <Comp
51
+ data-slot="badge"
52
+ data-variant={variant}
53
+ className={cn(badgeVariants({ variant }), className)}
54
+ {...props}
55
+ >
56
+ {icon && !asChild ? (
57
+ <>
58
+ <Icon name={icon} size={12} />
59
+ {children}
60
+ </>
61
+ ) : (
62
+ children
63
+ )}
64
+ </Comp>
65
+ )
66
+ }
67
+
68
+ export { Badge, badgeVariants }
@@ -0,0 +1,79 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import { BetaWarning } from "./beta-warning"
4
+
5
+ const meta = {
6
+ title: "Primitives/BetaWarning",
7
+ component: BetaWarning,
8
+ tags: ["autodocs"],
9
+ argTypes: {
10
+ variant: {
11
+ control: "select",
12
+ options: ["card", "banner", "inline"],
13
+ },
14
+ color: {
15
+ control: "select",
16
+ options: ["purple", "amber", "blue"],
17
+ },
18
+ badgeText: { control: "text" },
19
+ title: { control: "text" },
20
+ description: { control: "text" },
21
+ dismissible: { control: "boolean" },
22
+ },
23
+ } satisfies Meta<typeof BetaWarning>
24
+
25
+ export default meta
26
+ type Story = StoryObj<typeof meta>
27
+
28
+ export const DefaultCard: Story = {
29
+ args: {
30
+ variant: "card",
31
+ title: "AI Analytics Assistant",
32
+ description: "This feature uses experimental LLM models to generate predictive reports. Results should be verified independently.",
33
+ action: {
34
+ label: "Give Feedback",
35
+ onClick: () => {},
36
+ },
37
+ dismissible: true,
38
+ },
39
+ }
40
+
41
+ export const AmberWarning: Story = {
42
+ args: {
43
+ variant: "card",
44
+ color: "amber",
45
+ badgeText: "EXPERIMENTAL",
46
+ title: "Real-time Multi-Region Sync",
47
+ description: "Data replication latency may vary during peak load while this feature is in open preview.",
48
+ action: {
49
+ label: "View Docs",
50
+ href: "#",
51
+ },
52
+ dismissible: true,
53
+ },
54
+ }
55
+
56
+ export const BlueInfoBanner: Story = {
57
+ args: {
58
+ variant: "banner",
59
+ color: "blue",
60
+ badgeText: "PREVIEW",
61
+ title: "New Admin Dashboard v2.5",
62
+ description: "You are previewing the redesigned administrative portal. Switch back anytime from account settings.",
63
+ action: {
64
+ label: "Provide Feedback",
65
+ onClick: () => {},
66
+ },
67
+ dismissible: true,
68
+ },
69
+ }
70
+
71
+ export const InlineBadgeStrip: Story = {
72
+ render: () => (
73
+ <div className="flex flex-wrap items-center gap-3">
74
+ <BetaWarning variant="inline" title="AI Search" color="purple" badgeText="BETA" />
75
+ <BetaWarning variant="inline" title="GraphQL V2 API" color="amber" badgeText="PREVIEW" />
76
+ <BetaWarning variant="inline" title="Automated Export" color="blue" badgeText="LABS" dismissible />
77
+ </div>
78
+ ),
79
+ }