@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,305 @@
1
+ import * as React from "react"
2
+ import {
3
+ IconAlertCircle,
4
+ IconAlertTriangle,
5
+ IconArrowRight,
6
+ IconCircleCheck,
7
+ IconFileText,
8
+ IconLock,
9
+ IconSearch,
10
+ IconTools,
11
+ } from "@tabler/icons-react"
12
+
13
+ import { cn } from "./utils"
14
+ import { Button } from "./button"
15
+ import { Input } from "./input"
16
+ import { Badge } from "./badge"
17
+
18
+ export type AccessDeniedVariant =
19
+ | "forbidden"
20
+ | "unauthorized"
21
+ | "not-found"
22
+ | "error"
23
+ | "success"
24
+ | "maintenance"
25
+
26
+ export interface ActionConfig {
27
+ label: string
28
+ onClick?: () => void
29
+ href?: string
30
+ icon?: React.ReactNode
31
+ }
32
+
33
+ export interface SearchResultItem {
34
+ id: string
35
+ title: string
36
+ description?: string
37
+ href: string
38
+ category?: string
39
+ icon?: React.ReactNode
40
+ }
41
+
42
+ export interface AccessDeniedProps extends Omit<React.ComponentProps<"div">, "title"> {
43
+ /** Visual & semantic state variant. Defaults to "forbidden". */
44
+ variant?: AccessDeniedVariant
45
+ icon?: React.ReactNode
46
+ title?: React.ReactNode
47
+ description: React.ReactNode
48
+ /** Enable an inline site search form (automatically true for "not-found"). */
49
+ showSearch?: boolean
50
+ /** Placeholder text for the search input. */
51
+ searchPlaceholder?: string
52
+ /** Text of the search submit button. Defaults to "Search". */
53
+ searchButtonLabel?: string
54
+ /** Callback fired when search form is submitted or query changes. */
55
+ onSearch?: (query: string) => void
56
+ /** Optional pre-populated or filtered search results list. */
57
+ searchResults?: SearchResultItem[]
58
+ /** Primary action (the one filled, large button on the plane). */
59
+ primaryAction?: ActionConfig | React.ReactNode
60
+ /** Secondary action (rendered as a larger outline button). */
61
+ secondaryAction?: ActionConfig | React.ReactNode
62
+ /** Legacy action slot for custom action rendering. */
63
+ action?: React.ReactNode
64
+ }
65
+
66
+ const VARIANT_CONFIGS: Record<
67
+ AccessDeniedVariant,
68
+ {
69
+ title: string
70
+ defaultIcon: React.ReactNode
71
+ iconWrapper: string
72
+ }
73
+ > = {
74
+ forbidden: {
75
+ title: "Access Denied",
76
+ defaultIcon: <IconAlertCircle />,
77
+ iconWrapper: "bg-error-tint text-error-text",
78
+ },
79
+ unauthorized: {
80
+ title: "Authentication Required",
81
+ defaultIcon: <IconLock />,
82
+ iconWrapper: "bg-warning-tint text-warning-text",
83
+ },
84
+ "not-found": {
85
+ title: "Page Not Found",
86
+ defaultIcon: <IconSearch />,
87
+ iconWrapper: "bg-primary-tint text-primary-tint-foreground",
88
+ },
89
+ error: {
90
+ title: "System Error",
91
+ defaultIcon: <IconAlertTriangle />,
92
+ iconWrapper: "bg-error-tint text-error-text",
93
+ },
94
+ success: {
95
+ title: "Action Complete",
96
+ defaultIcon: <IconCircleCheck />,
97
+ iconWrapper: "bg-success-tint text-success-text",
98
+ },
99
+ maintenance: {
100
+ title: "Under Maintenance",
101
+ defaultIcon: <IconTools />,
102
+ iconWrapper: "bg-primary-tint text-primary-tint-foreground",
103
+ },
104
+ }
105
+
106
+ function renderAction(
107
+ action: ActionConfig | React.ReactNode,
108
+ defaultButtonVariant: "default" | "outline",
109
+ key: string
110
+ ) {
111
+ if (!action) return null
112
+
113
+ if (React.isValidElement(action)) {
114
+ return action
115
+ }
116
+
117
+ const config = action as ActionConfig
118
+
119
+ return (
120
+ <Button
121
+ key={key}
122
+ asChild={Boolean(config.href)}
123
+ size="lg"
124
+ variant={defaultButtonVariant}
125
+ onClick={config.onClick}
126
+ >
127
+ {config.href ? (
128
+ <a href={config.href}>
129
+ {config.icon && <span data-icon="inline-start">{config.icon}</span>}
130
+ {config.label}
131
+ </a>
132
+ ) : (
133
+ <>
134
+ {config.icon && <span data-icon="inline-start">{config.icon}</span>}
135
+ {config.label}
136
+ </>
137
+ )}
138
+ </Button>
139
+ )
140
+ }
141
+
142
+ /**
143
+ * Generic full-screen status and permission-denied feedback screen (AccessDenied / StatusPage).
144
+ * Supports semantic variants (forbidden, unauthorized, not-found, error, success, maintenance),
145
+ * integrated site search for Page Not Found (404), live search results list, and matching color larger action buttons.
146
+ */
147
+ function AccessDenied({
148
+ className,
149
+ variant = "forbidden",
150
+ icon,
151
+ title,
152
+ description,
153
+ showSearch = variant === "not-found",
154
+ searchPlaceholder = "Search site pages, resources, or docs...",
155
+ searchButtonLabel = "Search",
156
+ onSearch,
157
+ searchResults,
158
+ primaryAction,
159
+ secondaryAction,
160
+ action,
161
+ ...props
162
+ }: AccessDeniedProps) {
163
+ const [searchQuery, setSearchQuery] = React.useState("")
164
+ const [hasSearched, setHasSearched] = React.useState(false)
165
+ const config = VARIANT_CONFIGS[variant] ?? VARIANT_CONFIGS.forbidden
166
+ const resolvedTitle = title ?? config.title
167
+ const resolvedIcon = icon ?? config.defaultIcon
168
+
169
+ const handleSearchSubmit = (e: React.FormEvent) => {
170
+ e.preventDefault()
171
+ if (searchQuery.trim()) {
172
+ setHasSearched(true)
173
+ if (onSearch) {
174
+ onSearch(searchQuery.trim())
175
+ }
176
+ }
177
+ }
178
+
179
+ const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
180
+ const val = e.target.value
181
+ setSearchQuery(val)
182
+ if (!val.trim()) {
183
+ setHasSearched(false)
184
+ } else if (onSearch) {
185
+ onSearch(val)
186
+ }
187
+ }
188
+
189
+ const activeResults = searchResults ?? []
190
+
191
+ return (
192
+ <div
193
+ data-slot="access-denied"
194
+ data-variant={variant}
195
+ role="alert"
196
+ className={cn(
197
+ "flex min-h-[420px] w-full flex-col items-center justify-center rounded-2xl border border-border bg-card p-8 text-center shadow-xs transition-all",
198
+ className
199
+ )}
200
+ {...props}
201
+ >
202
+ <div
203
+ data-slot="access-denied-icon"
204
+ aria-hidden="true"
205
+ className={cn(
206
+ "mb-5 flex items-center justify-center rounded-full p-4 [&>svg]:size-10 md:[&>svg]:size-12 transition-all",
207
+ config.iconWrapper
208
+ )}
209
+ >
210
+ {resolvedIcon}
211
+ </div>
212
+
213
+ <h2 data-slot="access-denied-title" className="mb-2 text-xl font-semibold tracking-tight text-foreground md:text-2xl">
214
+ {resolvedTitle}
215
+ </h2>
216
+
217
+ <div
218
+ data-slot="access-denied-description"
219
+ className="mb-6 max-w-md text-xs/relaxed text-muted-foreground md:text-sm/relaxed"
220
+ >
221
+ {description}
222
+ </div>
223
+
224
+ {showSearch && (
225
+ <div className="mb-6 flex w-full max-w-md flex-col gap-3">
226
+ <form onSubmit={handleSearchSubmit} className="flex w-full items-center gap-2">
227
+ <div className="relative flex-1">
228
+ <Input
229
+ type="search"
230
+ placeholder={searchPlaceholder}
231
+ value={searchQuery}
232
+ onChange={handleInputChange}
233
+ className="h-8 text-xs"
234
+ />
235
+ </div>
236
+ <Button type="submit" size="default" variant="default">
237
+ <IconSearch data-icon="inline-start" />
238
+ {searchButtonLabel}
239
+ </Button>
240
+ </form>
241
+
242
+ {/* Inline Search Results List */}
243
+ {(activeResults.length > 0 || (hasSearched && searchQuery.trim())) && (
244
+ <div className="flex flex-col gap-2 rounded-xl border border-border/80 bg-muted/30 p-3 text-start transition-all">
245
+ <div className="flex items-center justify-between px-1 text-xs font-semibold text-muted-foreground uppercase tracking-wider">
246
+ <span>Search Results ({activeResults.length})</span>
247
+ {searchQuery && <span className="normal-case italic opacity-80">&quot;{searchQuery}&quot;</span>}
248
+ </div>
249
+
250
+ {activeResults.length > 0 ? (
251
+ <div className="flex flex-col gap-1.5">
252
+ {activeResults.map((result) => (
253
+ <a
254
+ key={result.id}
255
+ href={result.href}
256
+ className="group/res flex items-center justify-between gap-3 rounded-lg border border-border/50 bg-card p-2.5 transition-all hover:border-primary/40 hover:bg-card hover:shadow-2xs active:scale-[0.99]"
257
+ >
258
+ <div className="flex items-start gap-2.5 min-w-0">
259
+ <div className="mt-0.5 shrink-0 text-muted-foreground group-hover/res:text-primary [&_svg]:size-4">
260
+ {result.icon ?? <IconFileText />}
261
+ </div>
262
+ <div className="space-y-0.5 min-w-0">
263
+ <div className="flex items-center gap-2">
264
+ <span className="font-semibold text-xs text-foreground group-hover/res:text-primary truncate">
265
+ {result.title}
266
+ </span>
267
+ {result.category && (
268
+ <Badge variant="outline" className="text-xs px-1.5 py-0">
269
+ {result.category}
270
+ </Badge>
271
+ )}
272
+ </div>
273
+ {result.description && (
274
+ <p className="text-xs text-muted-foreground truncate">
275
+ {result.description}
276
+ </p>
277
+ )}
278
+ </div>
279
+ </div>
280
+ <IconArrowRight className="size-4 shrink-0 text-muted-foreground/60 transition-transform group-hover/res:translate-x-0.5 group-hover/res:text-primary rtl:rotate-180" />
281
+ </a>
282
+ ))}
283
+ </div>
284
+ ) : (
285
+ <p className="py-2 text-center text-xs text-muted-foreground">
286
+ No matching pages or resources found for &quot;{searchQuery}&quot;.
287
+ </p>
288
+ )}
289
+ </div>
290
+ )}
291
+ </div>
292
+ )}
293
+
294
+ {(primaryAction || secondaryAction || action) && (
295
+ <div className="flex flex-wrap items-center justify-center gap-3">
296
+ {renderAction(primaryAction, "default", "primary")}
297
+ {renderAction(secondaryAction, "outline", "secondary")}
298
+ {action}
299
+ </div>
300
+ )}
301
+ </div>
302
+ )
303
+ }
304
+
305
+ export { AccessDenied }
@@ -0,0 +1,338 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { ActorChip } from "./actor-chip"
6
+ import { Badge } from "./badge"
7
+ import { Button } from "./button"
8
+ import { Icon } from "./icon"
9
+ import { Lottie } from "./lottie"
10
+ import { TechnicalDetails } from "./display-preferences"
11
+ import { cn } from "./utils"
12
+
13
+ /**
14
+ * The approve-before-act card (docs/design/components/ActionProposal; register
15
+ * 7.5a, 5.4, 4.3). A waiting proposal is a loose sheet: dashed and flat,
16
+ * because nothing has happened yet. Approving sets it down on the plane (solid
17
+ * brand edge, 200 ms); declined goes grey with the title struck through;
18
+ * expired goes grey with Ask again; undone is dashed again and says by whom.
19
+ * The plane never sits under something that has not happened.
20
+ *
21
+ * Summary first: the title says what will happen and how much, then at most
22
+ * two changes and "Show all" past three. The footer always names the
23
+ * permissions used and whether, and for how long, it can be undone.
24
+ *
25
+ * Controlled: `status` is whatever the server says. Every visible string is a
26
+ * label with an English default.
27
+ */
28
+
29
+ export type ActionProposalStatus = "waiting" | "approved" | "declined" | "expired" | "undone"
30
+
31
+ export interface ActionProposalChange {
32
+ label: string
33
+ /** The value now; omitted for something new. */
34
+ before?: React.ReactNode
35
+ after: React.ReactNode
36
+ }
37
+
38
+ export interface ActionProposalLabels {
39
+ for?: string
40
+ waiting?: string
41
+ approved?: string
42
+ declined?: string
43
+ expired?: string
44
+ /** `{name}` is who undid it. */
45
+ undoneBy?: string
46
+ undone?: string
47
+ approve?: string
48
+ decline?: string
49
+ edit?: string
50
+ undo?: string
51
+ askAgain?: string
52
+ uses?: string
53
+ reversible?: string
54
+ /** `{window}` is the undo window, e.g. "30 minutes". */
55
+ reversibleFor?: string
56
+ irreversible?: string
57
+ before?: string
58
+ after?: string
59
+ /** `{count}` is the number of changes. */
60
+ showAll?: string
61
+ showLess?: string
62
+ }
63
+
64
+ export interface ActionProposalProps {
65
+ /** The agent's role name ("Billing assistant"). */
66
+ agent: string
67
+ /** The person it acts for. */
68
+ onBehalfOf?: string
69
+ title: string
70
+ summary?: React.ReactNode
71
+ changes?: ActionProposalChange[]
72
+ /** The permissions it uses (`resource:action`). */
73
+ scope?: string[]
74
+ /** False when it can't be undone; then there is no undo window. */
75
+ reversible?: boolean
76
+ /** How long it can be undone for, already worded ("30 minutes"). */
77
+ undoWindow?: string
78
+ status?: ActionProposalStatus
79
+ /** When it was decided, already formatted ("14:02"). */
80
+ decidedAt?: string
81
+ undoneBy?: string
82
+ /** Disables the actions while a decision is on its way. */
83
+ busy?: boolean
84
+ onApprove?: () => void
85
+ onDecline?: () => void
86
+ onEdit?: () => void
87
+ onUndo?: () => void
88
+ onAskAgain?: () => void
89
+ labels?: ActionProposalLabels
90
+ /**
91
+ * More than rows of changes, under them: an impact plan with its tests and
92
+ * the tick a destructive one needs (TplImpactPlan).
93
+ */
94
+ children?: React.ReactNode
95
+ /** Approve stays off, such as until a tick is given or while tests fail. */
96
+ approveDisabled?: boolean
97
+ /** Other buttons beside Decline, such as "Ask Whity Builder to fix it". */
98
+ actions?: React.ReactNode
99
+ /** Replaces the undo line, such as "Can be rolled back to version 1.3". */
100
+ undoText?: string
101
+ /**
102
+ * Play `approve-set-down` above the card (LT.4): forwards on Approve, backwards
103
+ * on Undo. Only where one proposal is decided on its own; a list or bulk
104
+ * approval keeps the 200 ms set-down in code.
105
+ */
106
+ moment?: boolean
107
+ className?: string
108
+ }
109
+
110
+ const DEFAULT_LABELS: Required<ActionProposalLabels> = {
111
+ for: "for",
112
+ waiting: "Waiting for your approval",
113
+ approved: "Approved",
114
+ declined: "Declined",
115
+ expired: "Expired",
116
+ undoneBy: "Undone by {name}",
117
+ undone: "Undone",
118
+ approve: "Approve",
119
+ decline: "Decline",
120
+ edit: "Edit",
121
+ undo: "Undo",
122
+ askAgain: "Ask again",
123
+ uses: "Uses",
124
+ reversible: "Can be undone",
125
+ reversibleFor: "Can be undone for {window}",
126
+ irreversible: "Can't be undone",
127
+ before: "Now",
128
+ after: "After",
129
+ showAll: "Show all {count} changes",
130
+ showLess: "Show less",
131
+ }
132
+
133
+ const NEUTRAL_BADGE = "bg-muted text-muted-foreground"
134
+
135
+ function ActionProposal({
136
+ agent,
137
+ onBehalfOf,
138
+ title,
139
+ summary,
140
+ changes = [],
141
+ scope = [],
142
+ reversible = true,
143
+ undoWindow,
144
+ status = "waiting",
145
+ decidedAt,
146
+ undoneBy,
147
+ busy = false,
148
+ onApprove,
149
+ onDecline,
150
+ onEdit,
151
+ onUndo,
152
+ onAskAgain,
153
+ labels,
154
+ children,
155
+ approveDisabled = false,
156
+ actions,
157
+ undoText: undoTextOverride,
158
+ moment = false,
159
+ className,
160
+ }: ActionProposalProps) {
161
+ const L = { ...DEFAULT_LABELS, ...labels }
162
+ const [showAll, setShowAll] = React.useState(false)
163
+ const folded = changes.length > 3 && !showAll
164
+ const shown = folded ? changes.slice(0, 2) : changes
165
+ const titleId = React.useId()
166
+
167
+ const badge = {
168
+ waiting: (
169
+ <Badge variant="outline">
170
+ <span aria-hidden="true" className="size-2 rounded-full border-[1.5px] border-dashed border-brand" />
171
+ {L.waiting}
172
+ </Badge>
173
+ ),
174
+ approved: (
175
+ <Badge variant="success" icon="check">
176
+ {decidedAt ? `${L.approved} · ${decidedAt}` : L.approved}
177
+ </Badge>
178
+ ),
179
+ declined: (
180
+ <Badge icon="close" className={NEUTRAL_BADGE}>
181
+ {L.declined}
182
+ </Badge>
183
+ ),
184
+ expired: (
185
+ <Badge icon="clock" className={NEUTRAL_BADGE}>
186
+ {L.expired}
187
+ </Badge>
188
+ ),
189
+ undone: (
190
+ <Badge icon="undo" className={NEUTRAL_BADGE}>
191
+ {undoneBy ? L.undoneBy.replace("{name}", undoneBy) : L.undone}
192
+ </Badge>
193
+ ),
194
+ }[status]
195
+
196
+ const undoText = undoTextOverride ?? (!reversible
197
+ ? L.irreversible
198
+ : undoWindow
199
+ ? L.reversibleFor.replace("{window}", undoWindow)
200
+ : L.reversible)
201
+
202
+ return (
203
+ <article
204
+ data-slot="action-proposal"
205
+ data-status={status}
206
+ aria-labelledby={titleId}
207
+ className={cn(
208
+ "grid max-w-[560px] gap-3 rounded-card border-[1.5px] bg-card p-4 text-card-foreground",
209
+ "transition-[box-shadow,border-color,margin] duration-200 ease-out-whity",
210
+ status === "waiting" && "border-dashed border-brand/60",
211
+ // Set down: solid brand edge on the plane (4.3). The plane never mirrors.
212
+ status === "approved" && "mb-(--plane-offset) ml-(--plane-offset) border-solid border-brand shadow-plane",
213
+ status === "declined" && "border-solid border-border",
214
+ status === "expired" && "border-solid border-border bg-muted",
215
+ status === "undone" && "border-dashed border-input",
216
+ className
217
+ )}
218
+ >
219
+ {moment && (status === "waiting" || status === "approved" || status === "undone") && (
220
+ <Lottie
221
+ name="approve-set-down"
222
+ play="manual"
223
+ approved={status === "approved"}
224
+ className="mx-auto h-[100px] w-[150px]"
225
+ />
226
+ )}
227
+ <header className="flex flex-wrap items-center justify-between gap-2">
228
+ <ActorChip kind="agent" name={agent} onBehalfOf={onBehalfOf} labels={{ for: L.for }} />
229
+ {badge}
230
+ </header>
231
+ <h3
232
+ id={titleId}
233
+ className={cn(
234
+ "m-0 text-base leading-snug font-semibold text-balance",
235
+ (status === "declined" || status === "expired") && "text-muted-foreground",
236
+ status === "declined" && "line-through decoration-1"
237
+ )}
238
+ >
239
+ {title}
240
+ </h3>
241
+ {summary && <p className="m-0 text-sm text-muted-foreground">{summary}</p>}
242
+ {shown.length > 0 && (
243
+ <dl className="m-0 grid overflow-hidden rounded-control border border-divider">
244
+ {shown.map((change, index) => (
245
+ <div
246
+ key={index}
247
+ className="grid grid-cols-[minmax(96px,30%)_1fr] gap-3 border-t border-border px-3 py-2 first:border-t-0"
248
+ >
249
+ <dt className="text-muted-foreground">{change.label}</dt>
250
+ <dd className="m-0 flex min-w-0 flex-wrap items-center gap-1.5 tabular-nums">
251
+ {change.before != null && (
252
+ <>
253
+ <span className="text-muted-foreground line-through">
254
+ <span className="sr-only">{L.before}: </span>
255
+ {change.before}
256
+ </span>
257
+ <Icon name="arrow-right" size={12} className="text-muted-foreground rtl:-scale-x-100" />
258
+ </>
259
+ )}
260
+ <span className="min-w-0 font-semibold break-words">
261
+ {change.before != null && <span className="sr-only">{L.after}: </span>}
262
+ {change.after}
263
+ </span>
264
+ </dd>
265
+ </div>
266
+ ))}
267
+ </dl>
268
+ )}
269
+ {changes.length > 3 && (
270
+ <button
271
+ type="button"
272
+ aria-expanded={showAll}
273
+ onClick={() => setShowAll(!showAll)}
274
+ className="justify-self-start border-0 bg-transparent p-0 text-[0.8125rem] font-medium text-primary outline-none focus-visible:underline"
275
+ >
276
+ {showAll ? L.showLess : L.showAll.replace("{count}", String(changes.length))}
277
+ </button>
278
+ )}
279
+ {children}
280
+ <footer className="flex flex-wrap items-center justify-between gap-3">
281
+ <div className="grid min-w-0 gap-0.5 text-sm text-muted-foreground">
282
+ {scope.length > 0 && (
283
+ <TechnicalDetails>
284
+ <span>
285
+ {L.uses}{" "}
286
+ {scope.map((permission) => (
287
+ <code
288
+ key={permission}
289
+ className="me-1 rounded-sm bg-muted px-[5px] py-px font-mono text-xs text-foreground"
290
+ >
291
+ {permission}
292
+ </code>
293
+ ))}
294
+ </span>
295
+ </TechnicalDetails>
296
+ )}
297
+ <span>{undoText}</span>
298
+ </div>
299
+ {status === "waiting" && (
300
+ <div className="flex flex-wrap items-center gap-2">
301
+ {onDecline && (
302
+ <Button variant="ghost" size="sm" disabled={busy} onClick={onDecline}>
303
+ {L.decline}
304
+ </Button>
305
+ )}
306
+ {actions}
307
+ {onEdit && (
308
+ <Button variant="outline" size="sm" disabled={busy} onClick={onEdit}>
309
+ <Icon name="edit" size={16} />
310
+ {L.edit}
311
+ </Button>
312
+ )}
313
+ {onApprove && (
314
+ <Button size="sm" disabled={busy || approveDisabled} onClick={onApprove}>
315
+ <Icon name="check" size={16} />
316
+ {L.approve}
317
+ </Button>
318
+ )}
319
+ </div>
320
+ )}
321
+ {status === "approved" && reversible && onUndo && (
322
+ <Button variant="ghost" size="sm" disabled={busy} onClick={onUndo}>
323
+ <Icon name="undo" size={16} />
324
+ {L.undo}
325
+ </Button>
326
+ )}
327
+ {status === "expired" && onAskAgain && (
328
+ <Button variant="outline" size="sm" disabled={busy} onClick={onAskAgain}>
329
+ <Icon name="sync" size={16} />
330
+ {L.askAgain}
331
+ </Button>
332
+ )}
333
+ </footer>
334
+ </article>
335
+ )
336
+ }
337
+
338
+ export { ActionProposal }