@whity/ui 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +106 -2
- package/package.json +219 -4
- package/src/access-denied.stories.tsx +179 -0
- package/src/access-denied.tsx +305 -0
- package/src/action-proposal.tsx +338 -0
- package/src/actor-chip.tsx +71 -0
- package/src/agent-activity.tsx +163 -0
- package/src/agent-collaboration.stories.tsx +156 -0
- package/src/agent-run-status.tsx +196 -0
- package/src/alert-dialog.stories.tsx +45 -0
- package/src/alert-dialog.tsx +147 -0
- package/src/alert.stories.tsx +91 -0
- package/src/alert.tsx +89 -0
- package/src/app-sidebar.stories.tsx +195 -0
- package/src/app-sidebar.tsx +604 -0
- package/src/approval-queue.tsx +109 -0
- package/src/audience-group-picker.stories.tsx +198 -0
- package/src/audience-group-picker.tsx +362 -0
- package/src/audience-people-picker.stories.tsx +102 -0
- package/src/audience-people-picker.tsx +279 -0
- package/src/avatar-pattern.ts +138 -0
- package/src/avatar.tsx +125 -0
- package/src/badge.stories.tsx +105 -0
- package/src/badge.tsx +68 -0
- package/src/beta-warning.stories.tsx +79 -0
- package/src/beta-warning.tsx +189 -0
- package/src/bilingual-input.stories.tsx +82 -0
- package/src/bilingual-input.tsx +188 -0
- package/src/board.tsx +216 -0
- package/src/breadcrumb.stories.tsx +51 -0
- package/src/breadcrumb.tsx +90 -0
- package/src/built-on-whity.tsx +52 -0
- package/src/button.stories.tsx +87 -0
- package/src/button.tsx +123 -0
- package/src/card.stories.tsx +423 -0
- package/src/card.tsx +180 -0
- package/src/chart.stories.tsx +66 -0
- package/src/chart.tsx +228 -0
- package/src/checkbox.stories.tsx +62 -0
- package/src/checkbox.tsx +54 -0
- package/src/collapsible.stories.tsx +48 -0
- package/src/collapsible.tsx +34 -0
- package/src/color-card.stories.tsx +61 -0
- package/src/color-card.tsx +270 -0
- package/src/color-picker.stories.tsx +65 -0
- package/src/color-picker.tsx +425 -0
- package/src/column-matcher.tsx +84 -0
- package/src/command-palette.tsx +398 -0
- package/src/confirm-action.tsx +98 -0
- package/src/copy-block.stories.tsx +38 -0
- package/src/copy-block.tsx +85 -0
- package/src/data-table.stories.tsx +200 -0
- package/src/data-table.tsx +1686 -0
- package/src/date-picker.stories.tsx +61 -0
- package/src/date-picker.tsx +456 -0
- package/src/design-cards.stories.tsx +551 -0
- package/src/dialog.stories.tsx +48 -0
- package/src/dialog.tsx +179 -0
- package/src/display-preferences.tsx +50 -0
- package/src/documents/barcode-svg.stories.tsx +72 -0
- package/src/documents/barcode-svg.tsx +79 -0
- package/src/dropdown-menu.stories.tsx +77 -0
- package/src/dropdown-menu.tsx +271 -0
- 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 -0
- package/src/editor/block-ids.ts +44 -0
- package/src/editor/block-list.tsx +104 -0
- package/src/editor/block-toolbar.tsx +490 -0
- package/src/editor/bubble.tsx +119 -0
- package/src/editor/catalogue.ts +169 -0
- package/src/editor/collab-rail.tsx +746 -0
- package/src/editor/collab.stories.tsx +207 -0
- package/src/editor/collab.ts +87 -0
- package/src/editor/contract.ts +476 -0
- package/src/editor/convert.ts +414 -0
- package/src/editor/doc-editor.stories.tsx +98 -0
- package/src/editor/doc-editor.tsx +1492 -0
- package/src/editor/editor.css +636 -0
- package/src/editor/extensions.ts +86 -0
- package/src/editor/field-bar.tsx +154 -0
- package/src/editor/field-picker.tsx +109 -0
- package/src/editor/fields.ts +100 -0
- package/src/editor/gutter.tsx +443 -0
- package/src/editor/index.ts +23 -0
- package/src/editor/label-sheet.tsx +289 -0
- package/src/editor/labels.ts +394 -0
- package/src/editor/link-tools.tsx +141 -0
- package/src/editor/node-views.tsx +461 -0
- package/src/editor/page-view.tsx +372 -0
- 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 -0
- package/src/editor/rich-blocks.stories.tsx +146 -0
- package/src/editor/sample.ts +40 -0
- 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 -0
- package/src/editor/schema.ts +368 -0
- package/src/editor/services.tsx +205 -0
- package/src/editor/slash.ts +64 -0
- package/src/editor/suggesting.ts +372 -0
- package/src/editor/suggestions.ts +763 -0
- package/src/editor/table-keys.ts +66 -0
- package/src/editor/templates.stories.tsx +324 -0
- package/src/editor/toolbar.tsx +364 -0
- package/src/empty-state.stories.tsx +51 -0
- package/src/empty-state.tsx +126 -0
- package/src/empty-state.usage-notes.md +30 -0
- package/src/form.stories.tsx +112 -0
- package/src/form.tsx +176 -0
- package/src/globals.css +20 -0
- package/src/icon-button.tsx +85 -0
- package/src/icon-map.ts +335 -0
- package/src/icon.tsx +41 -0
- package/src/index.ts +90 -0
- package/src/input.stories.tsx +157 -0
- package/src/input.tsx +768 -0
- package/src/kpi-strip.tsx +47 -0
- package/src/localized-text.ts +76 -0
- package/src/locked-screen.stories.tsx +29 -0
- package/src/locked-screen.tsx +75 -0
- package/src/lockup.tsx +42 -0
- package/src/lottie.tsx +441 -0
- package/src/mark.tsx +62 -0
- package/src/math-text.stories.tsx +33 -0
- package/src/math-text.tsx +43 -0
- package/src/menu-bar.stories.tsx +198 -0
- package/src/menu-bar.tsx +373 -0
- package/src/message-thread.tsx +181 -0
- package/src/money/currency.ts +244 -0
- 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 -0
- package/src/page-header.tsx +122 -0
- package/src/page-shell.stories.tsx +42 -0
- package/src/page-shell.tsx +32 -0
- package/src/page-states.tsx +277 -0
- package/src/pagination.stories.tsx +45 -0
- package/src/pagination.tsx +98 -0
- package/src/paper-sheet.stories.tsx +88 -0
- package/src/paper-sheet.tsx +85 -0
- package/src/phone-tab-bar.tsx +152 -0
- package/src/plugin-card.stories.tsx +208 -0
- package/src/plugin-card.tsx +931 -0
- package/src/popover.stories.tsx +48 -0
- package/src/popover.tsx +55 -0
- package/src/radio-group.stories.tsx +26 -0
- package/src/radio-group.tsx +44 -0
- package/src/route-flow/editor.tsx +1087 -0
- package/src/route-flow/model.ts +771 -0
- package/src/save-bar.tsx +94 -0
- package/src/scope-grant.tsx +139 -0
- package/src/screen-too-small.stories.tsx +61 -0
- package/src/screen-too-small.tsx +104 -0
- package/src/search-field.tsx +65 -0
- package/src/select.stories.tsx +44 -0
- package/src/select.tsx +197 -0
- package/src/separator.stories.tsx +34 -0
- package/src/separator.tsx +34 -0
- package/src/sheet.stories.tsx +49 -0
- package/src/sheet.tsx +168 -0
- package/src/skeleton.stories.tsx +28 -0
- package/src/skeleton.tsx +19 -0
- package/src/slider.stories.tsx +78 -0
- package/src/slider.tsx +300 -0
- package/src/spinner.stories.tsx +33 -0
- package/src/spinner.tsx +55 -0
- package/src/stepper.tsx +85 -0
- package/src/switch.stories.tsx +42 -0
- package/src/switch.tsx +41 -0
- package/src/switcher.stories.tsx +111 -0
- package/src/switcher.tsx +131 -0
- package/src/system-state.tsx +55 -0
- package/src/table.stories.tsx +48 -0
- package/src/table.tsx +121 -0
- package/src/tabs.stories.tsx +74 -0
- package/src/tabs.tsx +90 -0
- package/src/tag-input.stories.tsx +67 -0
- package/src/tag-input.tsx +117 -0
- package/src/tenant-logo.tsx +63 -0
- package/src/tenant-switcher.stories.tsx +38 -0
- package/src/tenant-switcher.tsx +164 -0
- package/src/textarea.stories.tsx +27 -0
- package/src/textarea.tsx +18 -0
- package/src/theme-mode.ts +52 -0
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -0
- package/src/time-picker.tsx +615 -0
- package/src/toggle-group.tsx +138 -0
- package/src/tooltip.stories.tsx +43 -0
- package/src/tooltip.tsx +73 -0
- package/src/top-nav.stories.tsx +58 -0
- package/src/top-nav.tsx +324 -0
- package/src/undo-bar.tsx +107 -0
- package/src/utils.ts +45 -0
- package/src/view-toggle.stories.tsx +84 -0
- package/src/view-toggle.tsx +110 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
"use client"
|
|
2
|
+
|
|
3
|
+
import { ActionProposal, type ActionProposalProps } from "./action-proposal"
|
|
4
|
+
import { Button } from "./button"
|
|
5
|
+
import { EmptyState } from "./empty-state"
|
|
6
|
+
import { Icon } from "./icon"
|
|
7
|
+
import { cn } from "./utils"
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* The approvals inbox, one request at a time (docs/design/components/
|
|
11
|
+
* ApprovalQueue; register 7.5b): "1 of 3 waiting · oldest first", Previous and
|
|
12
|
+
* Next, the current proposal, and the edges of the cards behind it. When
|
|
13
|
+
* nothing is left it says so.
|
|
14
|
+
*
|
|
15
|
+
* Controlled: the caller holds the list (oldest first), which one is shown,
|
|
16
|
+
* and what deciding does. Moving on after a decision is the caller's too, so
|
|
17
|
+
* the list can shrink only once the server has answered.
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
export interface ApprovalQueueItem extends ActionProposalProps {
|
|
21
|
+
id: string
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export interface ApprovalQueueLabels {
|
|
25
|
+
/** `{index}` and `{count}`. */
|
|
26
|
+
position?: string
|
|
27
|
+
order?: string
|
|
28
|
+
previous?: string
|
|
29
|
+
next?: string
|
|
30
|
+
doneTitle?: string
|
|
31
|
+
doneDescription?: string
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface ApprovalQueueProps {
|
|
35
|
+
items: ApprovalQueueItem[]
|
|
36
|
+
currentId?: string
|
|
37
|
+
onCurrentChange: (id: string) => void
|
|
38
|
+
/** Accessible name of the section. */
|
|
39
|
+
label?: string
|
|
40
|
+
labels?: ApprovalQueueLabels
|
|
41
|
+
className?: string
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const DEFAULT_LABELS: Required<ApprovalQueueLabels> = {
|
|
45
|
+
position: "{index} of {count} waiting",
|
|
46
|
+
order: "oldest first",
|
|
47
|
+
previous: "Previous",
|
|
48
|
+
next: "Next",
|
|
49
|
+
doneTitle: "All caught up",
|
|
50
|
+
doneDescription: "Nothing is waiting for you. New requests from agents appear here.",
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function ApprovalQueue({ items, currentId, onCurrentChange, label = "Approvals", labels, className }: ApprovalQueueProps) {
|
|
54
|
+
const L = { ...DEFAULT_LABELS, ...labels }
|
|
55
|
+
const found = items.findIndex((item) => item.id === currentId)
|
|
56
|
+
const index = found >= 0 ? found : 0
|
|
57
|
+
const current = items[index]
|
|
58
|
+
|
|
59
|
+
return (
|
|
60
|
+
<section data-slot="approval-queue" aria-label={label} className={cn("grid max-w-[560px] gap-2", className)}>
|
|
61
|
+
{!current ? (
|
|
62
|
+
<EmptyState
|
|
63
|
+
moment="all-caught-up"
|
|
64
|
+
icon={<Icon name="success" size={24} />}
|
|
65
|
+
title={L.doneTitle}
|
|
66
|
+
description={L.doneDescription}
|
|
67
|
+
/>
|
|
68
|
+
) : (
|
|
69
|
+
<>
|
|
70
|
+
<div className="flex items-center justify-between text-[0.8125rem] text-muted-foreground">
|
|
71
|
+
<span aria-live="polite">
|
|
72
|
+
{L.position.replace("{index}", String(index + 1)).replace("{count}", String(items.length))} · {L.order}
|
|
73
|
+
</span>
|
|
74
|
+
<span className="flex items-center gap-1">
|
|
75
|
+
<Button
|
|
76
|
+
variant="ghost"
|
|
77
|
+
size="sm"
|
|
78
|
+
disabled={index <= 0}
|
|
79
|
+
onClick={() => onCurrentChange(items[index - 1].id)}
|
|
80
|
+
>
|
|
81
|
+
<Icon name="chevron-left" size={16} className="rtl:-scale-x-100" />
|
|
82
|
+
{L.previous}
|
|
83
|
+
</Button>
|
|
84
|
+
<Button
|
|
85
|
+
variant="ghost"
|
|
86
|
+
size="sm"
|
|
87
|
+
disabled={index >= items.length - 1}
|
|
88
|
+
onClick={() => onCurrentChange(items[index + 1].id)}
|
|
89
|
+
>
|
|
90
|
+
{L.next}
|
|
91
|
+
<Icon name="chevron-right" size={16} className="rtl:-scale-x-100" />
|
|
92
|
+
</Button>
|
|
93
|
+
</span>
|
|
94
|
+
</div>
|
|
95
|
+
{/* key: a new card per proposal, so its "Show all" starts folded. */}
|
|
96
|
+
<ActionProposal key={current.id} {...current} />
|
|
97
|
+
{items.length > 1 && (
|
|
98
|
+
<div aria-hidden="true" className="relative mx-3 -mt-2 h-2 rounded-b-card border border-t-0 border-border bg-card" />
|
|
99
|
+
)}
|
|
100
|
+
{items.length > 2 && (
|
|
101
|
+
<div aria-hidden="true" className="relative mx-6 -mt-2 h-2 rounded-b-card border border-t-0 border-border bg-card" />
|
|
102
|
+
)}
|
|
103
|
+
</>
|
|
104
|
+
)}
|
|
105
|
+
</section>
|
|
106
|
+
)
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export { ApprovalQueue }
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
import { fn } from "storybook/test"
|
|
3
|
+
import * as React from "react"
|
|
4
|
+
|
|
5
|
+
import {
|
|
6
|
+
AudienceGroupPicker,
|
|
7
|
+
type AudienceGroupOption,
|
|
8
|
+
type AudienceGroupPreview,
|
|
9
|
+
} from "./audience-group-picker"
|
|
10
|
+
|
|
11
|
+
const GROUPS: AudienceGroupOption[] = [
|
|
12
|
+
{
|
|
13
|
+
id: 1,
|
|
14
|
+
name: "Instructors",
|
|
15
|
+
description: "Everyone holding the instructor role, anywhere in the faculty.",
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
id: 2,
|
|
19
|
+
name: "Department heads",
|
|
20
|
+
description: "Everyone holding the department-head role.",
|
|
21
|
+
},
|
|
22
|
+
{ id: 3, name: "Tender committee", description: null },
|
|
23
|
+
]
|
|
24
|
+
|
|
25
|
+
const SMALL_PREVIEW: AudienceGroupPreview = {
|
|
26
|
+
total: 3,
|
|
27
|
+
truncated: false,
|
|
28
|
+
sampleSize: 10,
|
|
29
|
+
members: [
|
|
30
|
+
{ profileId: 11, displayName: "Aisha Karim" },
|
|
31
|
+
{ profileId: 12, displayName: "Omar Haddad" },
|
|
32
|
+
{ profileId: 13, displayName: "Lena Farouk" },
|
|
33
|
+
],
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const LARGE_PREVIEW: AudienceGroupPreview = {
|
|
37
|
+
total: 1043,
|
|
38
|
+
truncated: true,
|
|
39
|
+
sampleSize: 5,
|
|
40
|
+
members: [
|
|
41
|
+
{ profileId: 11, displayName: "Aisha Karim" },
|
|
42
|
+
{ profileId: 12, displayName: "Omar Haddad" },
|
|
43
|
+
{ profileId: 13, displayName: "Lena Farouk" },
|
|
44
|
+
{ profileId: 14, displayName: "Yusuf Nabil" },
|
|
45
|
+
{ profileId: 15, displayName: "Rania Saleh" },
|
|
46
|
+
],
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const meta = {
|
|
50
|
+
title: "Primitives/AudienceGroupPicker",
|
|
51
|
+
component: AudienceGroupPicker,
|
|
52
|
+
tags: ["autodocs"],
|
|
53
|
+
args: {
|
|
54
|
+
groups: GROUPS,
|
|
55
|
+
value: null,
|
|
56
|
+
onChange: fn(),
|
|
57
|
+
},
|
|
58
|
+
} satisfies Meta<typeof AudienceGroupPicker>
|
|
59
|
+
|
|
60
|
+
export default meta
|
|
61
|
+
type Story = StoryObj<typeof meta>
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* The picker is fully controlled, so the interactive stories drive it through
|
|
65
|
+
* this wrapper: the `value` arg seeds local state and `onChange` still fires so
|
|
66
|
+
* the Actions panel logs the choice.
|
|
67
|
+
*/
|
|
68
|
+
function ControlledPicker({
|
|
69
|
+
value,
|
|
70
|
+
onChange,
|
|
71
|
+
...props
|
|
72
|
+
}: React.ComponentProps<typeof AudienceGroupPicker>) {
|
|
73
|
+
const [current, setCurrent] = React.useState<number | null>(value)
|
|
74
|
+
|
|
75
|
+
return (
|
|
76
|
+
<AudienceGroupPicker
|
|
77
|
+
{...props}
|
|
78
|
+
value={current}
|
|
79
|
+
onChange={(next) => {
|
|
80
|
+
setCurrent(next)
|
|
81
|
+
onChange(next)
|
|
82
|
+
}}
|
|
83
|
+
/>
|
|
84
|
+
)
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** Nothing chosen: a placeholder, and no preview to show yet. */
|
|
88
|
+
export const Unchosen: Story = {
|
|
89
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* A small group where the sample IS the membership — the picker says so, rather
|
|
94
|
+
* than leaving the reader to compare two numbers.
|
|
95
|
+
*/
|
|
96
|
+
export const SmallGroup: Story = {
|
|
97
|
+
args: { value: 3, preview: SMALL_PREVIEW, previewStatus: "ready" },
|
|
98
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* The case the whole design exists for: four figures of people, one row. The
|
|
103
|
+
* sample is labelled as a sample, and the dynamic-membership note sits under it.
|
|
104
|
+
*/
|
|
105
|
+
export const LargeGroup: Story = {
|
|
106
|
+
args: { value: 1, preview: LARGE_PREVIEW, previewStatus: "ready" },
|
|
107
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* A rule nobody currently matches. Not an error — a fact about the organisation
|
|
112
|
+
* that the author needs before they commit, not after the document reaches
|
|
113
|
+
* nobody.
|
|
114
|
+
*/
|
|
115
|
+
export const ResolvesToNobody: Story = {
|
|
116
|
+
args: {
|
|
117
|
+
value: 2,
|
|
118
|
+
preview: { total: 0, truncated: false, sampleSize: 10, members: [] },
|
|
119
|
+
previewStatus: "ready",
|
|
120
|
+
},
|
|
121
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* The reader may see group definitions but not people's names (`groups:read`
|
|
126
|
+
* without `users:read`). Same payload shape, ids where the names would be.
|
|
127
|
+
*/
|
|
128
|
+
export const WithoutNames: Story = {
|
|
129
|
+
args: {
|
|
130
|
+
value: 1,
|
|
131
|
+
previewStatus: "ready",
|
|
132
|
+
preview: {
|
|
133
|
+
total: 2,
|
|
134
|
+
truncated: false,
|
|
135
|
+
sampleSize: 10,
|
|
136
|
+
members: [
|
|
137
|
+
{ profileId: 11, displayName: null },
|
|
138
|
+
{ profileId: 12, displayName: null },
|
|
139
|
+
],
|
|
140
|
+
},
|
|
141
|
+
},
|
|
142
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export const PreviewLoading: Story = {
|
|
146
|
+
args: { value: 1, previewStatus: "loading" },
|
|
147
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** The server's refusal, verbatim, with a way back. */
|
|
151
|
+
export const PreviewFailed: Story = {
|
|
152
|
+
args: {
|
|
153
|
+
value: 1,
|
|
154
|
+
previewStatus: "error",
|
|
155
|
+
previewError: "user group 1 does not exist in this tenant.",
|
|
156
|
+
onRetryPreview: fn(),
|
|
157
|
+
},
|
|
158
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* A reason, never an empty dropdown: the author learns the list is missing
|
|
163
|
+
* because of a permission, not because the workspace has no groups.
|
|
164
|
+
*/
|
|
165
|
+
export const Unavailable: Story = {
|
|
166
|
+
args: {
|
|
167
|
+
groups: [],
|
|
168
|
+
unavailableReason:
|
|
169
|
+
"You cannot list user groups here, so a step cannot name one. An administrator would need to grant you groups:read.",
|
|
170
|
+
},
|
|
171
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/** The catalogue is genuinely empty — a different statement, said differently. */
|
|
175
|
+
export const NoGroupsDefined: Story = {
|
|
176
|
+
args: { groups: [] },
|
|
177
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* A saved step naming a group the reader's list does not contain — deleted, or
|
|
182
|
+
* past the pages they could load. Said out loud, because Radix would otherwise
|
|
183
|
+
* draw the placeholder and the step would read as unconfigured.
|
|
184
|
+
*/
|
|
185
|
+
export const NamesAGroupNotInTheList: Story = {
|
|
186
|
+
args: { value: 404 },
|
|
187
|
+
render: (args) => <ControlledPicker {...args} />,
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/** Right-to-left: the kit ships into Arabic UIs, so every story must survive it. */
|
|
191
|
+
export const RightToLeft: Story = {
|
|
192
|
+
args: { value: 1, preview: LARGE_PREVIEW, previewStatus: "ready" },
|
|
193
|
+
render: (args) => (
|
|
194
|
+
<div dir="rtl">
|
|
195
|
+
<ControlledPicker {...args} />
|
|
196
|
+
</div>
|
|
197
|
+
),
|
|
198
|
+
}
|
|
@@ -0,0 +1,362 @@
|
|
|
1
|
+
"use client"
|
|
2
|
+
|
|
3
|
+
import { cn } from "./utils"
|
|
4
|
+
import { Badge } from "./badge"
|
|
5
|
+
import { Button } from "./button"
|
|
6
|
+
import {
|
|
7
|
+
Select,
|
|
8
|
+
SelectContent,
|
|
9
|
+
SelectItem,
|
|
10
|
+
SelectTrigger,
|
|
11
|
+
SelectValue,
|
|
12
|
+
} from "./select"
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Naming ONE user group, and seeing who it currently means (#1015, over #999's
|
|
16
|
+
* engine).
|
|
17
|
+
*
|
|
18
|
+
* WHY THIS IS A KIT PRIMITIVE AND NOT A SCREEN COMPONENT
|
|
19
|
+
* -----------------------------------------------------
|
|
20
|
+
* A route step that says "everyone in Instructors" is authored in at least two
|
|
21
|
+
* places — the linear route composer and the node-based route template editor —
|
|
22
|
+
* and both need the identical control for the identical reason. Authored inside
|
|
23
|
+
* one client, the second surface either imports across an app boundary or grows
|
|
24
|
+
* a copy, and the copy is where the two drift. `sidebar.tsx` is the cautionary
|
|
25
|
+
* case in this repo: 427 lines of hand-rolled duplicate that cost nothing until
|
|
26
|
+
* a capability had to be added twice.
|
|
27
|
+
*
|
|
28
|
+
* THE PREVIEW IS A SNAPSHOT, NOT A MEMBERSHIP LIST
|
|
29
|
+
* -----------------------------------------------
|
|
30
|
+
* There is deliberately no `user_group_members` table. A group is a RULE, and it
|
|
31
|
+
* is re-resolved against the organisation every time it is reached — which is
|
|
32
|
+
* the whole reason groups exist: the instructor hired next week is in
|
|
33
|
+
* "Instructors" without anybody editing anything, and the one who left is not.
|
|
34
|
+
*
|
|
35
|
+
* That makes the preview a fact with a timestamp attached, and this component
|
|
36
|
+
* has to say so or it teaches the wrong model. Three things do that work
|
|
37
|
+
* together and none of them is decoration:
|
|
38
|
+
*
|
|
39
|
+
* 1. the heading is phrased in the present tense — "reaches N people right now",
|
|
40
|
+
* never "has N members";
|
|
41
|
+
* 2. {@link AudienceGroupPickerProps.previewDynamicNote} states the rule
|
|
42
|
+
* outright, and is rendered with every preview rather than behind a
|
|
43
|
+
* disclosure, because a caveat nobody opens is a caveat nobody reads;
|
|
44
|
+
* 3. the sample is labelled as a sample whenever it is one, from the server's
|
|
45
|
+
* own `truncated` flag rather than from `total > members.length` — a client
|
|
46
|
+
* that re-derived that and got it wrong would present ten people as the
|
|
47
|
+
* whole group, which is the single misreading this shape exists to prevent.
|
|
48
|
+
*
|
|
49
|
+
* IT FETCHES NOTHING, LIKE EVERY OTHER `@whity/ui` INPUT
|
|
50
|
+
* ----------------------------------------------------------
|
|
51
|
+
* Groups and the preview arrive as props. That is the kit's standing convention
|
|
52
|
+
* ({@see TagInput}), and here it is also forced: the preview endpoint is
|
|
53
|
+
* `GET /api/v1/user-groups/{id}/preview`, three clients reach it three different
|
|
54
|
+
* ways, and a primitive that knew the URL could be reused by exactly one of
|
|
55
|
+
* them. The consumer owns the request; this owns everything about presenting the
|
|
56
|
+
* answer that is easy to get subtly wrong.
|
|
57
|
+
*
|
|
58
|
+
* NO TRANSLATOR IMPORT. Every user-visible string is a prop with an English
|
|
59
|
+
* default — the kit ships to clients with three different i18n stacks, and one
|
|
60
|
+
* of them has no runtime translator at all.
|
|
61
|
+
*/
|
|
62
|
+
|
|
63
|
+
/** One group a step may name. */
|
|
64
|
+
export interface AudienceGroupOption {
|
|
65
|
+
id: number
|
|
66
|
+
name: string
|
|
67
|
+
/** The group's own one-line description, when it has one. */
|
|
68
|
+
description?: string | null
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* One person in a preview sample.
|
|
73
|
+
*
|
|
74
|
+
* `displayName` is nullable rather than optional-and-absent because the server
|
|
75
|
+
* sends it that way on purpose: reading a person's NAME needs `users:read`,
|
|
76
|
+
* which reading a group's DEFINITION does not imply, so a caller without it gets
|
|
77
|
+
* the same payload shape with nulls where the names would be. One shape means a
|
|
78
|
+
* client renders an id instead of branching on which flavour it received.
|
|
79
|
+
*/
|
|
80
|
+
export interface AudienceGroupPreviewMember {
|
|
81
|
+
profileId: number
|
|
82
|
+
displayName?: string | null
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** What a group resolves to at the moment it was asked. */
|
|
86
|
+
export interface AudienceGroupPreview {
|
|
87
|
+
/** Exact, not an estimate: the server counts what the rule actually answered. */
|
|
88
|
+
total: number
|
|
89
|
+
/** The server's own flag. Never re-derive it — see the file docblock. */
|
|
90
|
+
truncated: boolean
|
|
91
|
+
/** The ceiling that produced the sample, so "that is everybody" is tellable. */
|
|
92
|
+
sampleSize: number
|
|
93
|
+
members: AudienceGroupPreviewMember[]
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export type AudienceGroupPreviewStatus = "idle" | "loading" | "ready" | "error"
|
|
97
|
+
|
|
98
|
+
export interface AudienceGroupPickerProps {
|
|
99
|
+
/** Id for the select, so a caller's own `<label htmlFor>` can address it. */
|
|
100
|
+
id?: string
|
|
101
|
+
/** The groups to choose from, already fetched by the caller. */
|
|
102
|
+
groups: AudienceGroupOption[]
|
|
103
|
+
/** The chosen group's id, or null when nothing is chosen yet. */
|
|
104
|
+
value: number | null
|
|
105
|
+
onChange: (groupId: number | null) => void
|
|
106
|
+
/**
|
|
107
|
+
* Why there is no list to show — a 403 on the group catalogue, a failed
|
|
108
|
+
* request. Rendered as an explanation IN PLACE OF the select, never as an
|
|
109
|
+
* empty dropdown: an empty picker reads as "this tenant has no groups", which
|
|
110
|
+
* is a different and wrong statement.
|
|
111
|
+
*/
|
|
112
|
+
unavailableReason?: string | null
|
|
113
|
+
/**
|
|
114
|
+
* Why the list, though populated, may not be all of them — a truncated
|
|
115
|
+
* pagination walk. Rendered BESIDE the select, because the author can still
|
|
116
|
+
* work; they just must not conclude a missing group does not exist.
|
|
117
|
+
*/
|
|
118
|
+
incompleteReason?: string | null
|
|
119
|
+
/** The chosen group's membership snapshot. */
|
|
120
|
+
preview?: AudienceGroupPreview | null
|
|
121
|
+
previewStatus?: AudienceGroupPreviewStatus
|
|
122
|
+
/** The server's refusal, verbatim. */
|
|
123
|
+
previewError?: string | null
|
|
124
|
+
/** Rendered as a retry control only when supplied. */
|
|
125
|
+
onRetryPreview?: () => void
|
|
126
|
+
disabled?: boolean
|
|
127
|
+
className?: string
|
|
128
|
+
|
|
129
|
+
// -- labels, English by default ------------------------------------------
|
|
130
|
+
|
|
131
|
+
/** Placeholder on the trigger before a group is chosen. */
|
|
132
|
+
placeholder?: string
|
|
133
|
+
/** Shown when the caller could read the catalogue and it is genuinely empty. */
|
|
134
|
+
emptyLabel?: string
|
|
135
|
+
/** While the preview request is in flight. */
|
|
136
|
+
previewLoadingLabel?: string
|
|
137
|
+
/**
|
|
138
|
+
* The count sentence. A function, not a string: the number sits INSIDE the
|
|
139
|
+
* phrase, languages put it in different places, and the caller is the only
|
|
140
|
+
* party that knows how to format a number for its locale.
|
|
141
|
+
*/
|
|
142
|
+
previewCountLabel?: (total: number) => string
|
|
143
|
+
/** When the rule resolves to nobody at all — a fact, not an error. */
|
|
144
|
+
previewEmptyLabel?: string
|
|
145
|
+
/** Introduces the sample when it is only a sample. */
|
|
146
|
+
previewSampleLabel?: (shown: number, total: number) => string
|
|
147
|
+
/** Introduces the sample when the sample IS everybody. */
|
|
148
|
+
previewAllLabel?: string
|
|
149
|
+
/** The "a group is a rule, not a list" sentence. Always rendered. */
|
|
150
|
+
previewDynamicNote?: string
|
|
151
|
+
/** For a sample row whose name the reader may not see. */
|
|
152
|
+
unnamedMemberLabel?: (profileId: number) => string
|
|
153
|
+
previewRetryLabel?: string
|
|
154
|
+
/**
|
|
155
|
+
* For a `value` that names a group the caller's list does not contain.
|
|
156
|
+
*
|
|
157
|
+
* A function, because the id sits inside the sentence and languages put it in
|
|
158
|
+
* different places.
|
|
159
|
+
*/
|
|
160
|
+
unknownGroupLabel?: (groupId: number) => string
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* A group chooser with the membership snapshot attached.
|
|
165
|
+
*
|
|
166
|
+
* Controlled. `value` is the group id; `null` means nothing chosen, which is the
|
|
167
|
+
* state a caller must treat as "this step is not configured yet".
|
|
168
|
+
*/
|
|
169
|
+
export function AudienceGroupPicker({
|
|
170
|
+
id,
|
|
171
|
+
groups,
|
|
172
|
+
value,
|
|
173
|
+
onChange,
|
|
174
|
+
unavailableReason = null,
|
|
175
|
+
incompleteReason = null,
|
|
176
|
+
preview = null,
|
|
177
|
+
previewStatus = "idle",
|
|
178
|
+
previewError = null,
|
|
179
|
+
onRetryPreview,
|
|
180
|
+
disabled = false,
|
|
181
|
+
className,
|
|
182
|
+
placeholder = "Choose a user group",
|
|
183
|
+
emptyLabel = "No user groups have been defined in this workspace yet.",
|
|
184
|
+
previewLoadingLabel = "Working out who this group reaches…",
|
|
185
|
+
previewCountLabel = (total: number) =>
|
|
186
|
+
total === 1
|
|
187
|
+
? "Reaches 1 person right now."
|
|
188
|
+
: `Reaches ${total} people right now.`,
|
|
189
|
+
previewEmptyLabel =
|
|
190
|
+
"This group resolves to nobody right now. A step naming it would reach no one.",
|
|
191
|
+
previewSampleLabel = (shown: number, total: number) =>
|
|
192
|
+
`Showing ${shown} of the ${total} — a sample, not the whole set:`,
|
|
193
|
+
previewAllLabel = "That is everybody:",
|
|
194
|
+
previewDynamicNote = "A group is a rule, not a saved list of people. Who it reaches is worked out again every time the document moves, so this is what it means right now — not a set that has been fixed in place.",
|
|
195
|
+
unnamedMemberLabel = (profileId: number) => `Profile #${profileId}`,
|
|
196
|
+
previewRetryLabel = "Try again",
|
|
197
|
+
unknownGroupLabel = (groupId: number) =>
|
|
198
|
+
`This step names user group #${groupId}, which is not in the list you can see — it may have been deleted, or you may not be able to read it. Choosing another group here would replace it.`,
|
|
199
|
+
}: AudienceGroupPickerProps) {
|
|
200
|
+
// An explanation instead of an empty dropdown (#756). The caller's sentence is
|
|
201
|
+
// rendered verbatim: it is the only party that knows WHY, and the server's own
|
|
202
|
+
// 403 names the permission slug that is missing.
|
|
203
|
+
if (unavailableReason !== null && unavailableReason !== "") {
|
|
204
|
+
return (
|
|
205
|
+
<p
|
|
206
|
+
data-slot="audience-group-picker-unavailable"
|
|
207
|
+
className={cn("text-xs text-muted-foreground", className)}
|
|
208
|
+
>
|
|
209
|
+
{unavailableReason}
|
|
210
|
+
</p>
|
|
211
|
+
)
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
if (groups.length === 0) {
|
|
215
|
+
return (
|
|
216
|
+
<p
|
|
217
|
+
data-slot="audience-group-picker-empty"
|
|
218
|
+
className={cn("text-xs text-muted-foreground", className)}
|
|
219
|
+
>
|
|
220
|
+
{emptyLabel}
|
|
221
|
+
</p>
|
|
222
|
+
)
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
const selected = groups.find((group) => group.id === value) ?? null
|
|
226
|
+
|
|
227
|
+
// A configured step whose group is NOT in the list. Radix renders the
|
|
228
|
+
// placeholder for a value it has no item for, so without this the step would
|
|
229
|
+
// read as "nothing chosen" — and an author would overwrite a perfectly good
|
|
230
|
+
// `group_id` believing they were filling in a blank.
|
|
231
|
+
//
|
|
232
|
+
// Unreachable from a composer that only ever starts steps empty, and squarely
|
|
233
|
+
// reachable from an editor that loads a SAVED step (a deleted group, or one
|
|
234
|
+
// past the pages the caller managed to load). #756: an empty state, never
|
|
235
|
+
// invented content — and never a silent one.
|
|
236
|
+
const namesMissingGroup = value !== null && selected === null
|
|
237
|
+
|
|
238
|
+
return (
|
|
239
|
+
<div
|
|
240
|
+
data-slot="audience-group-picker"
|
|
241
|
+
className={cn("space-y-2", className)}
|
|
242
|
+
>
|
|
243
|
+
<Select
|
|
244
|
+
value={value === null ? undefined : String(value)}
|
|
245
|
+
disabled={disabled}
|
|
246
|
+
onValueChange={(next) => {
|
|
247
|
+
const parsed = Number(next)
|
|
248
|
+
onChange(Number.isInteger(parsed) && parsed > 0 ? parsed : null)
|
|
249
|
+
}}
|
|
250
|
+
>
|
|
251
|
+
<SelectTrigger id={id} className="w-full">
|
|
252
|
+
<SelectValue placeholder={placeholder} />
|
|
253
|
+
</SelectTrigger>
|
|
254
|
+
<SelectContent>
|
|
255
|
+
{groups.map((group) => (
|
|
256
|
+
<SelectItem key={group.id} value={String(group.id)}>
|
|
257
|
+
{group.name}
|
|
258
|
+
</SelectItem>
|
|
259
|
+
))}
|
|
260
|
+
</SelectContent>
|
|
261
|
+
</Select>
|
|
262
|
+
|
|
263
|
+
{incompleteReason !== null && incompleteReason !== "" && (
|
|
264
|
+
<p
|
|
265
|
+
data-slot="audience-group-picker-incomplete"
|
|
266
|
+
className="text-xs text-muted-foreground"
|
|
267
|
+
>
|
|
268
|
+
{incompleteReason}
|
|
269
|
+
</p>
|
|
270
|
+
)}
|
|
271
|
+
|
|
272
|
+
{namesMissingGroup && (
|
|
273
|
+
<p
|
|
274
|
+
data-slot="audience-group-picker-unknown"
|
|
275
|
+
className="text-xs text-destructive"
|
|
276
|
+
>
|
|
277
|
+
{unknownGroupLabel(value)}
|
|
278
|
+
</p>
|
|
279
|
+
)}
|
|
280
|
+
|
|
281
|
+
{selected?.description !== undefined &&
|
|
282
|
+
selected.description !== null &&
|
|
283
|
+
selected.description !== "" && (
|
|
284
|
+
<p
|
|
285
|
+
data-slot="audience-group-picker-description"
|
|
286
|
+
className="text-xs text-muted-foreground"
|
|
287
|
+
>
|
|
288
|
+
{selected.description}
|
|
289
|
+
</p>
|
|
290
|
+
)}
|
|
291
|
+
|
|
292
|
+
{selected !== null && (
|
|
293
|
+
<div
|
|
294
|
+
data-slot="audience-group-picker-preview"
|
|
295
|
+
// `text-start`, not `text-left`: the kit ships into Arabic UIs and a
|
|
296
|
+
// physical direction would pin this block to the wrong edge there.
|
|
297
|
+
className="rounded-md border border-border bg-muted/40 p-2 text-start"
|
|
298
|
+
// Announced as it changes: choosing a group is the act, and the count
|
|
299
|
+
// arriving afterwards is the answer to it.
|
|
300
|
+
aria-live="polite"
|
|
301
|
+
>
|
|
302
|
+
{previewStatus === "loading" && (
|
|
303
|
+
<p className="text-xs text-muted-foreground">
|
|
304
|
+
{previewLoadingLabel}
|
|
305
|
+
</p>
|
|
306
|
+
)}
|
|
307
|
+
|
|
308
|
+
{previewStatus === "error" && (
|
|
309
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
310
|
+
<p className="text-xs text-destructive">{previewError}</p>
|
|
311
|
+
{onRetryPreview !== undefined && (
|
|
312
|
+
<Button variant="outline" size="sm" onClick={onRetryPreview}>
|
|
313
|
+
{previewRetryLabel}
|
|
314
|
+
</Button>
|
|
315
|
+
)}
|
|
316
|
+
</div>
|
|
317
|
+
)}
|
|
318
|
+
|
|
319
|
+
{previewStatus === "ready" && preview !== null && (
|
|
320
|
+
<div className="space-y-1">
|
|
321
|
+
<p className="text-xs font-medium text-foreground">
|
|
322
|
+
{preview.total === 0
|
|
323
|
+
? previewEmptyLabel
|
|
324
|
+
: previewCountLabel(preview.total)}
|
|
325
|
+
</p>
|
|
326
|
+
|
|
327
|
+
{preview.total > 0 && (
|
|
328
|
+
<>
|
|
329
|
+
<p className="text-xs text-muted-foreground">
|
|
330
|
+
{preview.truncated
|
|
331
|
+
? previewSampleLabel(preview.members.length, preview.total)
|
|
332
|
+
: previewAllLabel}
|
|
333
|
+
</p>
|
|
334
|
+
<ul className="flex flex-wrap gap-1">
|
|
335
|
+
{preview.members.map((member) => (
|
|
336
|
+
<li key={member.profileId}>
|
|
337
|
+
<Badge variant="secondary">
|
|
338
|
+
{member.displayName !== undefined &&
|
|
339
|
+
member.displayName !== null &&
|
|
340
|
+
member.displayName !== ""
|
|
341
|
+
? member.displayName
|
|
342
|
+
: unnamedMemberLabel(member.profileId)}
|
|
343
|
+
</Badge>
|
|
344
|
+
</li>
|
|
345
|
+
))}
|
|
346
|
+
</ul>
|
|
347
|
+
</>
|
|
348
|
+
)}
|
|
349
|
+
|
|
350
|
+
<p
|
|
351
|
+
data-slot="audience-group-picker-dynamic-note"
|
|
352
|
+
className="text-xs text-muted-foreground"
|
|
353
|
+
>
|
|
354
|
+
{previewDynamicNote}
|
|
355
|
+
</p>
|
|
356
|
+
</div>
|
|
357
|
+
)}
|
|
358
|
+
</div>
|
|
359
|
+
)}
|
|
360
|
+
</div>
|
|
361
|
+
)
|
|
362
|
+
}
|