@whity/ui 0.5.0 → 1.0.1

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 (208) hide show
  1. package/README.md +107 -107
  2. package/package.json +223 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +125 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +399 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1687 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +457 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +59 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  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 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  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 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  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 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +92 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  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 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-input.tsx +252 -0
  151. package/src/phone-tab-bar.tsx +152 -0
  152. package/src/plugin-card.stories.tsx +208 -180
  153. package/src/plugin-card.tsx +931 -848
  154. package/src/popover.stories.tsx +48 -48
  155. package/src/popover.tsx +55 -55
  156. package/src/radio-group.stories.tsx +26 -26
  157. package/src/radio-group.tsx +44 -44
  158. package/src/role-summary.stories.tsx +143 -0
  159. package/src/role-summary.tsx +120 -0
  160. package/src/route-flow/editor.tsx +1087 -1014
  161. package/src/route-flow/model.ts +771 -716
  162. package/src/save-bar.tsx +94 -0
  163. package/src/scope-grant.tsx +139 -139
  164. package/src/screen-too-small.stories.tsx +61 -61
  165. package/src/screen-too-small.tsx +104 -104
  166. package/src/search-field.tsx +65 -0
  167. package/src/select.stories.tsx +44 -44
  168. package/src/select.tsx +197 -197
  169. package/src/separator.stories.tsx +34 -34
  170. package/src/separator.tsx +34 -34
  171. package/src/sheet.stories.tsx +49 -49
  172. package/src/sheet.tsx +168 -168
  173. package/src/skeleton.stories.tsx +28 -28
  174. package/src/skeleton.tsx +19 -19
  175. package/src/slider.stories.tsx +78 -78
  176. package/src/slider.tsx +300 -300
  177. package/src/spinner.stories.tsx +33 -33
  178. package/src/spinner.tsx +55 -55
  179. package/src/stepper.tsx +85 -0
  180. package/src/switch.stories.tsx +42 -42
  181. package/src/switch.tsx +41 -41
  182. package/src/switcher.stories.tsx +111 -111
  183. package/src/switcher.tsx +131 -131
  184. package/src/system-state.tsx +55 -0
  185. package/src/table.stories.tsx +48 -48
  186. package/src/table.tsx +121 -121
  187. package/src/tabs.stories.tsx +74 -74
  188. package/src/tabs.tsx +90 -90
  189. package/src/tag-input.stories.tsx +67 -67
  190. package/src/tag-input.tsx +117 -117
  191. package/src/tenant-logo.tsx +63 -63
  192. package/src/tenant-switcher.stories.tsx +38 -38
  193. package/src/tenant-switcher.tsx +185 -164
  194. package/src/textarea.stories.tsx +27 -27
  195. package/src/textarea.tsx +18 -18
  196. package/src/theme-mode.ts +74 -52
  197. package/src/time-grid.tsx +163 -0
  198. package/src/time-picker.stories.tsx +62 -62
  199. package/src/time-picker.tsx +616 -615
  200. package/src/toggle-group.tsx +139 -138
  201. package/src/tooltip.stories.tsx +43 -43
  202. package/src/tooltip.tsx +73 -73
  203. package/src/top-nav.stories.tsx +58 -58
  204. package/src/top-nav.tsx +324 -324
  205. package/src/undo-bar.tsx +107 -107
  206. package/src/utils.ts +45 -45
  207. package/src/view-toggle.stories.tsx +84 -84
  208. package/src/view-toggle.tsx +111 -110
@@ -1,302 +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 { cn } from "./utils"
10
-
11
- /**
12
- * The approve-before-act card (docs/design/components/ActionProposal; register
13
- * 7.5a, 5.4, 4.3). A waiting proposal is a loose sheet: dashed and flat,
14
- * because nothing has happened yet. Approving sets it down on the plane (solid
15
- * brand edge, 200 ms); declined goes grey with the title struck through;
16
- * expired goes grey with Ask again; undone is dashed again and says by whom.
17
- * The plane never sits under something that has not happened.
18
- *
19
- * Summary first: the title says what will happen and how much, then at most
20
- * two changes and "Show all" past three. The footer always names the
21
- * permissions used and whether, and for how long, it can be undone.
22
- *
23
- * Controlled: `status` is whatever the server says. Every visible string is a
24
- * label with an English default.
25
- */
26
-
27
- export type ActionProposalStatus = "waiting" | "approved" | "declined" | "expired" | "undone"
28
-
29
- export interface ActionProposalChange {
30
- label: string
31
- /** The value now; omitted for something new. */
32
- before?: React.ReactNode
33
- after: React.ReactNode
34
- }
35
-
36
- export interface ActionProposalLabels {
37
- for?: string
38
- waiting?: string
39
- approved?: string
40
- declined?: string
41
- expired?: string
42
- /** `{name}` is who undid it. */
43
- undoneBy?: string
44
- undone?: string
45
- approve?: string
46
- decline?: string
47
- edit?: string
48
- undo?: string
49
- askAgain?: string
50
- uses?: string
51
- reversible?: string
52
- /** `{window}` is the undo window, e.g. "30 minutes". */
53
- reversibleFor?: string
54
- irreversible?: string
55
- before?: string
56
- after?: string
57
- /** `{count}` is the number of changes. */
58
- showAll?: string
59
- showLess?: string
60
- }
61
-
62
- export interface ActionProposalProps {
63
- /** The agent's role name ("Billing assistant"). */
64
- agent: string
65
- /** The person it acts for. */
66
- onBehalfOf?: string
67
- title: string
68
- summary?: React.ReactNode
69
- changes?: ActionProposalChange[]
70
- /** The permissions it uses (`resource:action`). */
71
- scope?: string[]
72
- /** False when it can't be undone; then there is no undo window. */
73
- reversible?: boolean
74
- /** How long it can be undone for, already worded ("30 minutes"). */
75
- undoWindow?: string
76
- status?: ActionProposalStatus
77
- /** When it was decided, already formatted ("14:02"). */
78
- decidedAt?: string
79
- undoneBy?: string
80
- /** Disables the actions while a decision is on its way. */
81
- busy?: boolean
82
- onApprove?: () => void
83
- onDecline?: () => void
84
- onEdit?: () => void
85
- onUndo?: () => void
86
- onAskAgain?: () => void
87
- labels?: ActionProposalLabels
88
- className?: string
89
- }
90
-
91
- const DEFAULT_LABELS: Required<ActionProposalLabels> = {
92
- for: "for",
93
- waiting: "Waiting for your approval",
94
- approved: "Approved",
95
- declined: "Declined",
96
- expired: "Expired",
97
- undoneBy: "Undone by {name}",
98
- undone: "Undone",
99
- approve: "Approve",
100
- decline: "Decline",
101
- edit: "Edit",
102
- undo: "Undo",
103
- askAgain: "Ask again",
104
- uses: "Uses",
105
- reversible: "Can be undone",
106
- reversibleFor: "Can be undone for {window}",
107
- irreversible: "Can't be undone",
108
- before: "Now",
109
- after: "After",
110
- showAll: "Show all {count} changes",
111
- showLess: "Show less",
112
- }
113
-
114
- const NEUTRAL_BADGE = "bg-muted text-muted-foreground"
115
-
116
- function ActionProposal({
117
- agent,
118
- onBehalfOf,
119
- title,
120
- summary,
121
- changes = [],
122
- scope = [],
123
- reversible = true,
124
- undoWindow,
125
- status = "waiting",
126
- decidedAt,
127
- undoneBy,
128
- busy = false,
129
- onApprove,
130
- onDecline,
131
- onEdit,
132
- onUndo,
133
- onAskAgain,
134
- labels,
135
- className,
136
- }: ActionProposalProps) {
137
- const L = { ...DEFAULT_LABELS, ...labels }
138
- const [showAll, setShowAll] = React.useState(false)
139
- const folded = changes.length > 3 && !showAll
140
- const shown = folded ? changes.slice(0, 2) : changes
141
- const titleId = React.useId()
142
-
143
- const badge = {
144
- waiting: (
145
- <Badge variant="outline">
146
- <span aria-hidden="true" className="size-2 rounded-full border-[1.5px] border-dashed border-brand" />
147
- {L.waiting}
148
- </Badge>
149
- ),
150
- approved: (
151
- <Badge variant="success" icon="check">
152
- {decidedAt ? `${L.approved} · ${decidedAt}` : L.approved}
153
- </Badge>
154
- ),
155
- declined: (
156
- <Badge icon="close" className={NEUTRAL_BADGE}>
157
- {L.declined}
158
- </Badge>
159
- ),
160
- expired: (
161
- <Badge icon="clock" className={NEUTRAL_BADGE}>
162
- {L.expired}
163
- </Badge>
164
- ),
165
- undone: (
166
- <Badge icon="undo" className={NEUTRAL_BADGE}>
167
- {undoneBy ? L.undoneBy.replace("{name}", undoneBy) : L.undone}
168
- </Badge>
169
- ),
170
- }[status]
171
-
172
- const undoText = !reversible
173
- ? L.irreversible
174
- : undoWindow
175
- ? L.reversibleFor.replace("{window}", undoWindow)
176
- : L.reversible
177
-
178
- return (
179
- <article
180
- data-slot="action-proposal"
181
- data-status={status}
182
- aria-labelledby={titleId}
183
- className={cn(
184
- "grid max-w-[560px] gap-3 rounded-card border-[1.5px] bg-card p-4 text-card-foreground",
185
- "transition-[box-shadow,border-color,margin] duration-200 ease-out-whity",
186
- status === "waiting" && "border-dashed border-brand/60",
187
- // Set down: solid brand edge on the plane (4.3). The plane never mirrors.
188
- status === "approved" && "mb-(--plane-offset) ml-(--plane-offset) border-solid border-brand shadow-plane",
189
- status === "declined" && "border-solid border-border",
190
- status === "expired" && "border-solid border-border bg-muted",
191
- status === "undone" && "border-dashed border-input",
192
- className
193
- )}
194
- >
195
- <header className="flex flex-wrap items-center justify-between gap-2">
196
- <ActorChip kind="agent" name={agent} onBehalfOf={onBehalfOf} labels={{ for: L.for }} />
197
- {badge}
198
- </header>
199
- <h3
200
- id={titleId}
201
- className={cn(
202
- "m-0 text-base leading-snug font-semibold text-balance",
203
- (status === "declined" || status === "expired") && "text-muted-foreground",
204
- status === "declined" && "line-through decoration-1"
205
- )}
206
- >
207
- {title}
208
- </h3>
209
- {summary && <p className="m-0 text-sm text-muted-foreground">{summary}</p>}
210
- {shown.length > 0 && (
211
- <dl className="m-0 grid overflow-hidden rounded-control border border-divider">
212
- {shown.map((change, index) => (
213
- <div
214
- key={index}
215
- className="grid grid-cols-[minmax(96px,30%)_1fr] gap-3 border-t border-border px-3 py-2 first:border-t-0"
216
- >
217
- <dt className="text-muted-foreground">{change.label}</dt>
218
- <dd className="m-0 flex min-w-0 flex-wrap items-center gap-1.5 tabular-nums">
219
- {change.before != null && (
220
- <>
221
- <span className="text-muted-foreground line-through">
222
- <span className="sr-only">{L.before}: </span>
223
- {change.before}
224
- </span>
225
- <Icon name="arrow-right" size={12} className="text-muted-foreground rtl:-scale-x-100" />
226
- </>
227
- )}
228
- <span className="min-w-0 font-semibold break-words">
229
- {change.before != null && <span className="sr-only">{L.after}: </span>}
230
- {change.after}
231
- </span>
232
- </dd>
233
- </div>
234
- ))}
235
- </dl>
236
- )}
237
- {changes.length > 3 && (
238
- <button
239
- type="button"
240
- aria-expanded={showAll}
241
- onClick={() => setShowAll(!showAll)}
242
- className="justify-self-start border-0 bg-transparent p-0 text-[0.8125rem] font-medium text-primary outline-none focus-visible:underline"
243
- >
244
- {showAll ? L.showLess : L.showAll.replace("{count}", String(changes.length))}
245
- </button>
246
- )}
247
- <footer className="flex flex-wrap items-center justify-between gap-3">
248
- <div className="grid min-w-0 gap-0.5 text-sm text-muted-foreground">
249
- {scope.length > 0 && (
250
- <span>
251
- {L.uses}{" "}
252
- {scope.map((permission) => (
253
- <code
254
- key={permission}
255
- className="me-1 rounded-sm bg-muted px-[5px] py-px font-mono text-xs text-foreground"
256
- >
257
- {permission}
258
- </code>
259
- ))}
260
- </span>
261
- )}
262
- <span>{undoText}</span>
263
- </div>
264
- {status === "waiting" && (
265
- <div className="flex flex-wrap items-center gap-2">
266
- {onDecline && (
267
- <Button variant="ghost" size="sm" disabled={busy} onClick={onDecline}>
268
- {L.decline}
269
- </Button>
270
- )}
271
- {onEdit && (
272
- <Button variant="outline" size="sm" disabled={busy} onClick={onEdit}>
273
- <Icon name="edit" size={16} />
274
- {L.edit}
275
- </Button>
276
- )}
277
- {onApprove && (
278
- <Button size="sm" disabled={busy} onClick={onApprove}>
279
- <Icon name="check" size={16} />
280
- {L.approve}
281
- </Button>
282
- )}
283
- </div>
284
- )}
285
- {status === "approved" && reversible && onUndo && (
286
- <Button variant="ghost" size="sm" disabled={busy} onClick={onUndo}>
287
- <Icon name="undo" size={16} />
288
- {L.undo}
289
- </Button>
290
- )}
291
- {status === "expired" && onAskAgain && (
292
- <Button variant="outline" size="sm" disabled={busy} onClick={onAskAgain}>
293
- <Icon name="sync" size={16} />
294
- {L.askAgain}
295
- </Button>
296
- )}
297
- </footer>
298
- </article>
299
- )
300
- }
301
-
302
- export { ActionProposal }
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 }