@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.
- package/README.md +107 -107
- package/package.json +223 -192
- package/src/access-denied.stories.tsx +179 -179
- package/src/access-denied.tsx +305 -305
- package/src/action-proposal.tsx +338 -302
- package/src/actor-chip.tsx +71 -71
- package/src/agent-activity.tsx +163 -163
- package/src/agent-collaboration.stories.tsx +156 -156
- package/src/agent-run-status.tsx +196 -196
- package/src/alert-dialog.stories.tsx +45 -45
- package/src/alert-dialog.tsx +147 -147
- package/src/alert.stories.tsx +91 -91
- package/src/alert.tsx +89 -89
- package/src/app-sidebar.stories.tsx +195 -195
- package/src/app-sidebar.tsx +604 -500
- package/src/approval-queue.tsx +109 -108
- package/src/audience-group-picker.stories.tsx +198 -198
- package/src/audience-group-picker.tsx +362 -362
- package/src/audience-people-picker.stories.tsx +102 -102
- package/src/audience-people-picker.tsx +279 -279
- package/src/avatar-pattern.ts +138 -0
- package/src/avatar.tsx +125 -83
- package/src/badge.stories.tsx +105 -105
- package/src/badge.tsx +68 -68
- package/src/beta-warning.stories.tsx +79 -79
- package/src/beta-warning.tsx +189 -189
- package/src/bilingual-input.stories.tsx +82 -82
- package/src/bilingual-input.tsx +188 -183
- package/src/board.tsx +216 -0
- package/src/breadcrumb.stories.tsx +51 -51
- package/src/breadcrumb.tsx +90 -90
- package/src/built-on-whity.tsx +52 -0
- package/src/button.stories.tsx +87 -87
- package/src/button.tsx +125 -118
- package/src/card.stories.tsx +423 -423
- package/src/card.tsx +180 -180
- package/src/chart.stories.tsx +66 -66
- package/src/chart.tsx +228 -228
- package/src/checkbox.stories.tsx +62 -62
- package/src/checkbox.tsx +54 -54
- package/src/collapsible.stories.tsx +48 -48
- package/src/collapsible.tsx +34 -34
- package/src/color-card.stories.tsx +61 -61
- package/src/color-card.tsx +270 -270
- package/src/color-picker.stories.tsx +65 -65
- package/src/color-picker.tsx +425 -425
- package/src/column-matcher.tsx +84 -0
- package/src/command-palette.tsx +399 -306
- package/src/confirm-action.tsx +98 -0
- package/src/copy-block.stories.tsx +38 -38
- package/src/copy-block.tsx +85 -85
- package/src/data-table.stories.tsx +200 -200
- package/src/data-table.tsx +1687 -1106
- package/src/date-picker.stories.tsx +61 -61
- package/src/date-picker.tsx +457 -422
- package/src/design-cards.stories.tsx +551 -458
- package/src/dialog.stories.tsx +48 -48
- package/src/dialog.tsx +179 -166
- package/src/display-preferences.tsx +59 -0
- package/src/documents/barcode-svg.stories.tsx +72 -72
- package/src/documents/barcode-svg.tsx +79 -79
- package/src/dropdown-menu.stories.tsx +77 -77
- package/src/dropdown-menu.tsx +271 -271
- package/src/editor/agent-panel.tsx +222 -0
- package/src/editor/agents.stories.tsx +81 -0
- package/src/editor/agents.ts +55 -0
- package/src/editor/behaviour.ts +279 -279
- package/src/editor/block-ids.ts +44 -44
- package/src/editor/block-list.tsx +104 -101
- package/src/editor/block-toolbar.tsx +490 -477
- package/src/editor/bubble.tsx +119 -93
- package/src/editor/catalogue.ts +169 -103
- package/src/editor/collab-rail.tsx +746 -746
- package/src/editor/collab.stories.tsx +207 -207
- package/src/editor/collab.ts +87 -87
- package/src/editor/contract.ts +476 -408
- package/src/editor/convert.ts +414 -362
- package/src/editor/doc-editor.stories.tsx +98 -98
- package/src/editor/doc-editor.tsx +1492 -1287
- package/src/editor/editor.css +636 -536
- package/src/editor/extensions.ts +86 -86
- package/src/editor/field-bar.tsx +154 -0
- package/src/editor/field-picker.tsx +109 -107
- package/src/editor/fields.ts +100 -100
- package/src/editor/gutter.tsx +443 -367
- package/src/editor/index.ts +23 -22
- package/src/editor/label-sheet.tsx +289 -289
- package/src/editor/labels.ts +394 -310
- package/src/editor/link-tools.tsx +141 -141
- package/src/editor/node-views.tsx +461 -450
- package/src/editor/page-view.tsx +372 -353
- package/src/editor/phone.tsx +310 -0
- package/src/editor/plugin-block-view.tsx +230 -0
- package/src/editor/plugin-blocks.stories.tsx +96 -0
- package/src/editor/plugin-blocks.ts +52 -0
- package/src/editor/publish-check.tsx +201 -182
- package/src/editor/rich-blocks.stories.tsx +146 -146
- package/src/editor/sample.ts +40 -40
- package/src/editor/save-block-dialog.tsx +141 -0
- package/src/editor/saved-block-view.tsx +205 -0
- package/src/editor/saved-blocks.stories.tsx +105 -0
- package/src/editor/saved-parts.ts +192 -0
- package/src/editor/schema-rich.ts +156 -150
- package/src/editor/schema.ts +368 -315
- package/src/editor/services.tsx +205 -127
- package/src/editor/slash.ts +64 -64
- package/src/editor/suggesting.ts +372 -372
- package/src/editor/suggestions.ts +763 -763
- package/src/editor/table-keys.ts +66 -66
- package/src/editor/templates.stories.tsx +324 -324
- package/src/editor/toolbar.tsx +364 -358
- package/src/empty-state.stories.tsx +51 -51
- package/src/empty-state.tsx +126 -100
- package/src/empty-state.usage-notes.md +30 -30
- package/src/form.stories.tsx +112 -112
- package/src/form.tsx +176 -176
- package/src/globals.css +20 -20
- package/src/icon-button.tsx +85 -85
- package/src/icon-map.ts +335 -244
- package/src/icon.tsx +41 -41
- package/src/index.ts +92 -67
- package/src/input.stories.tsx +157 -157
- package/src/input.tsx +768 -759
- package/src/kpi-strip.tsx +47 -0
- package/src/localized-text.ts +76 -0
- package/src/locked-screen.stories.tsx +29 -29
- package/src/locked-screen.tsx +75 -61
- package/src/lockup.tsx +42 -0
- package/src/lottie.tsx +441 -0
- package/src/mark.tsx +62 -62
- package/src/math-text.stories.tsx +33 -33
- package/src/math-text.tsx +43 -43
- package/src/menu-bar.stories.tsx +198 -198
- package/src/menu-bar.tsx +373 -373
- package/src/message-thread.tsx +181 -0
- package/src/money/currency.ts +244 -230
- package/src/money/money-input.tsx +131 -0
- package/src/money/money.tsx +33 -0
- package/src/open-on-computer.tsx +150 -0
- package/src/otp-input.tsx +161 -0
- package/src/page-header.stories.tsx +95 -95
- package/src/page-header.tsx +122 -122
- package/src/page-shell.stories.tsx +42 -42
- package/src/page-shell.tsx +32 -32
- package/src/page-states.tsx +277 -0
- package/src/pagination.stories.tsx +45 -45
- package/src/pagination.tsx +98 -98
- package/src/paper-sheet.stories.tsx +88 -0
- package/src/paper-sheet.tsx +85 -0
- package/src/phone-input.tsx +252 -0
- package/src/phone-tab-bar.tsx +152 -0
- package/src/plugin-card.stories.tsx +208 -180
- package/src/plugin-card.tsx +931 -848
- package/src/popover.stories.tsx +48 -48
- package/src/popover.tsx +55 -55
- package/src/radio-group.stories.tsx +26 -26
- package/src/radio-group.tsx +44 -44
- package/src/role-summary.stories.tsx +143 -0
- package/src/role-summary.tsx +120 -0
- package/src/route-flow/editor.tsx +1087 -1014
- package/src/route-flow/model.ts +771 -716
- package/src/save-bar.tsx +94 -0
- package/src/scope-grant.tsx +139 -139
- package/src/screen-too-small.stories.tsx +61 -61
- package/src/screen-too-small.tsx +104 -104
- package/src/search-field.tsx +65 -0
- package/src/select.stories.tsx +44 -44
- package/src/select.tsx +197 -197
- package/src/separator.stories.tsx +34 -34
- package/src/separator.tsx +34 -34
- package/src/sheet.stories.tsx +49 -49
- package/src/sheet.tsx +168 -168
- package/src/skeleton.stories.tsx +28 -28
- package/src/skeleton.tsx +19 -19
- package/src/slider.stories.tsx +78 -78
- package/src/slider.tsx +300 -300
- package/src/spinner.stories.tsx +33 -33
- package/src/spinner.tsx +55 -55
- package/src/stepper.tsx +85 -0
- package/src/switch.stories.tsx +42 -42
- package/src/switch.tsx +41 -41
- package/src/switcher.stories.tsx +111 -111
- package/src/switcher.tsx +131 -131
- package/src/system-state.tsx +55 -0
- package/src/table.stories.tsx +48 -48
- package/src/table.tsx +121 -121
- package/src/tabs.stories.tsx +74 -74
- package/src/tabs.tsx +90 -90
- package/src/tag-input.stories.tsx +67 -67
- package/src/tag-input.tsx +117 -117
- package/src/tenant-logo.tsx +63 -63
- package/src/tenant-switcher.stories.tsx +38 -38
- package/src/tenant-switcher.tsx +185 -164
- package/src/textarea.stories.tsx +27 -27
- package/src/textarea.tsx +18 -18
- package/src/theme-mode.ts +74 -52
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -62
- package/src/time-picker.tsx +616 -615
- package/src/toggle-group.tsx +139 -138
- package/src/tooltip.stories.tsx +43 -43
- package/src/tooltip.tsx +73 -73
- package/src/top-nav.stories.tsx +58 -58
- package/src/top-nav.tsx +324 -324
- package/src/undo-bar.tsx +107 -107
- package/src/utils.ts +45 -45
- package/src/view-toggle.stories.tsx +84 -84
- package/src/view-toggle.tsx +111 -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
|
+
}
|