@whity/ui 0.5.0 → 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 +107 -107
  2. package/package.json +221 -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 +123 -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 +398 -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 +1686 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +456 -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 +50 -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 +90 -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-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -180
  152. package/src/plugin-card.tsx +931 -848
  153. package/src/popover.stories.tsx +48 -48
  154. package/src/popover.tsx +55 -55
  155. package/src/radio-group.stories.tsx +26 -26
  156. package/src/radio-group.tsx +44 -44
  157. package/src/route-flow/editor.tsx +1087 -1014
  158. package/src/route-flow/model.ts +771 -716
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -139
  161. package/src/screen-too-small.stories.tsx +61 -61
  162. package/src/screen-too-small.tsx +104 -104
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -44
  165. package/src/select.tsx +197 -197
  166. package/src/separator.stories.tsx +34 -34
  167. package/src/separator.tsx +34 -34
  168. package/src/sheet.stories.tsx +49 -49
  169. package/src/sheet.tsx +168 -168
  170. package/src/skeleton.stories.tsx +28 -28
  171. package/src/skeleton.tsx +19 -19
  172. package/src/slider.stories.tsx +78 -78
  173. package/src/slider.tsx +300 -300
  174. package/src/spinner.stories.tsx +33 -33
  175. package/src/spinner.tsx +55 -55
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -42
  178. package/src/switch.tsx +41 -41
  179. package/src/switcher.stories.tsx +111 -111
  180. package/src/switcher.tsx +131 -131
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -48
  183. package/src/table.tsx +121 -121
  184. package/src/tabs.stories.tsx +74 -74
  185. package/src/tabs.tsx +90 -90
  186. package/src/tag-input.stories.tsx +67 -67
  187. package/src/tag-input.tsx +117 -117
  188. package/src/tenant-logo.tsx +63 -63
  189. package/src/tenant-switcher.stories.tsx +38 -38
  190. package/src/tenant-switcher.tsx +164 -164
  191. package/src/textarea.stories.tsx +27 -27
  192. package/src/textarea.tsx +18 -18
  193. package/src/theme-mode.ts +52 -52
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -62
  196. package/src/time-picker.tsx +615 -615
  197. package/src/toggle-group.tsx +138 -138
  198. package/src/tooltip.stories.tsx +43 -43
  199. package/src/tooltip.tsx +73 -73
  200. package/src/top-nav.stories.tsx +58 -58
  201. package/src/top-nav.tsx +324 -324
  202. package/src/undo-bar.tsx +107 -107
  203. package/src/utils.ts +45 -45
  204. package/src/view-toggle.stories.tsx +84 -84
  205. package/src/view-toggle.tsx +110 -110
@@ -1,279 +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
- }
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
+ }