@whity/ui 0.5.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/README.md +107 -107
  2. package/package.json +223 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +125 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +399 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1687 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +457 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +59 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +92 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-input.tsx +252 -0
  151. package/src/phone-tab-bar.tsx +152 -0
  152. package/src/plugin-card.stories.tsx +208 -180
  153. package/src/plugin-card.tsx +931 -848
  154. package/src/popover.stories.tsx +48 -48
  155. package/src/popover.tsx +55 -55
  156. package/src/radio-group.stories.tsx +26 -26
  157. package/src/radio-group.tsx +44 -44
  158. package/src/role-summary.stories.tsx +143 -0
  159. package/src/role-summary.tsx +120 -0
  160. package/src/route-flow/editor.tsx +1087 -1014
  161. package/src/route-flow/model.ts +771 -716
  162. package/src/save-bar.tsx +94 -0
  163. package/src/scope-grant.tsx +139 -139
  164. package/src/screen-too-small.stories.tsx +61 -61
  165. package/src/screen-too-small.tsx +104 -104
  166. package/src/search-field.tsx +65 -0
  167. package/src/select.stories.tsx +44 -44
  168. package/src/select.tsx +197 -197
  169. package/src/separator.stories.tsx +34 -34
  170. package/src/separator.tsx +34 -34
  171. package/src/sheet.stories.tsx +49 -49
  172. package/src/sheet.tsx +168 -168
  173. package/src/skeleton.stories.tsx +28 -28
  174. package/src/skeleton.tsx +19 -19
  175. package/src/slider.stories.tsx +78 -78
  176. package/src/slider.tsx +300 -300
  177. package/src/spinner.stories.tsx +33 -33
  178. package/src/spinner.tsx +55 -55
  179. package/src/stepper.tsx +85 -0
  180. package/src/switch.stories.tsx +42 -42
  181. package/src/switch.tsx +41 -41
  182. package/src/switcher.stories.tsx +111 -111
  183. package/src/switcher.tsx +131 -131
  184. package/src/system-state.tsx +55 -0
  185. package/src/table.stories.tsx +48 -48
  186. package/src/table.tsx +121 -121
  187. package/src/tabs.stories.tsx +74 -74
  188. package/src/tabs.tsx +90 -90
  189. package/src/tag-input.stories.tsx +67 -67
  190. package/src/tag-input.tsx +117 -117
  191. package/src/tenant-logo.tsx +63 -63
  192. package/src/tenant-switcher.stories.tsx +38 -38
  193. package/src/tenant-switcher.tsx +185 -164
  194. package/src/textarea.stories.tsx +27 -27
  195. package/src/textarea.tsx +18 -18
  196. package/src/theme-mode.ts +74 -52
  197. package/src/time-grid.tsx +163 -0
  198. package/src/time-picker.stories.tsx +62 -62
  199. package/src/time-picker.tsx +616 -615
  200. package/src/toggle-group.tsx +139 -138
  201. package/src/tooltip.stories.tsx +43 -43
  202. package/src/tooltip.tsx +73 -73
  203. package/src/top-nav.stories.tsx +58 -58
  204. package/src/top-nav.tsx +324 -324
  205. package/src/undo-bar.tsx +107 -107
  206. package/src/utils.ts +45 -45
  207. package/src/view-toggle.stories.tsx +84 -84
  208. package/src/view-toggle.tsx +111 -110
@@ -1,108 +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
- icon={<Icon name="success" size={24} />}
64
- title={L.doneTitle}
65
- description={L.doneDescription}
66
- />
67
- ) : (
68
- <>
69
- <div className="flex items-center justify-between text-[0.8125rem] text-muted-foreground">
70
- <span aria-live="polite">
71
- {L.position.replace("{index}", String(index + 1)).replace("{count}", String(items.length))} · {L.order}
72
- </span>
73
- <span className="flex items-center gap-1">
74
- <Button
75
- variant="ghost"
76
- size="sm"
77
- disabled={index <= 0}
78
- onClick={() => onCurrentChange(items[index - 1].id)}
79
- >
80
- <Icon name="chevron-left" size={16} className="rtl:-scale-x-100" />
81
- {L.previous}
82
- </Button>
83
- <Button
84
- variant="ghost"
85
- size="sm"
86
- disabled={index >= items.length - 1}
87
- onClick={() => onCurrentChange(items[index + 1].id)}
88
- >
89
- {L.next}
90
- <Icon name="chevron-right" size={16} className="rtl:-scale-x-100" />
91
- </Button>
92
- </span>
93
- </div>
94
- {/* key: a new card per proposal, so its "Show all" starts folded. */}
95
- <ActionProposal key={current.id} {...current} />
96
- {items.length > 1 && (
97
- <div aria-hidden="true" className="relative mx-3 -mt-2 h-2 rounded-b-card border border-t-0 border-border bg-card" />
98
- )}
99
- {items.length > 2 && (
100
- <div aria-hidden="true" className="relative mx-6 -mt-2 h-2 rounded-b-card border border-t-0 border-border bg-card" />
101
- )}
102
- </>
103
- )}
104
- </section>
105
- )
106
- }
107
-
108
- export { ApprovalQueue }
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 }
@@ -1,198 +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
- }
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
+ }