@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,51 +1,51 @@
1
- import type { Meta, StoryObj } from "@storybook/react-vite"
2
- import { IconPlus, IconRefresh } from "@tabler/icons-react"
3
-
4
- import { EmptyState, ErrorState } from "./empty-state"
5
- import { Button } from "./button"
6
-
7
- const meta = {
8
- title: "Primitives/EmptyState",
9
- component: EmptyState,
10
- tags: ["autodocs"],
11
- argTypes: {
12
- variant: { control: "select", options: ["empty", "error"] },
13
- },
14
- } satisfies Meta<typeof EmptyState>
15
-
16
- export default meta
17
- type Story = StoryObj<typeof meta>
18
-
19
- export const Default: Story = {
20
- args: {
21
- title: "No tenants yet",
22
- description: "Create your first tenant to get started.",
23
- },
24
- render: (args) => <EmptyState {...args} className="max-w-sm" />,
25
- }
26
-
27
- export const WithAction: Story = {
28
- args: {
29
- title: "No roles found",
30
- description: "Roles you create will show up here.",
31
- action: (
32
- <Button size="sm" variant="outline">
33
- <IconPlus /> Create role
34
- </Button>
35
- ),
36
- },
37
- render: (args) => <EmptyState {...args} className="max-w-sm" />,
38
- }
39
-
40
- export const Error: Story = {
41
- args: {
42
- title: "Couldn't load audit logs",
43
- description: "The request failed. Check your connection and try again.",
44
- action: (
45
- <Button size="sm" variant="outline">
46
- <IconRefresh /> Retry
47
- </Button>
48
- ),
49
- },
50
- render: (args) => <ErrorState {...args} className="max-w-sm" />,
51
- }
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { IconPlus, IconRefresh } from "@tabler/icons-react"
3
+
4
+ import { EmptyState, ErrorState } from "./empty-state"
5
+ import { Button } from "./button"
6
+
7
+ const meta = {
8
+ title: "Primitives/EmptyState",
9
+ component: EmptyState,
10
+ tags: ["autodocs"],
11
+ argTypes: {
12
+ variant: { control: "select", options: ["empty", "error"] },
13
+ },
14
+ } satisfies Meta<typeof EmptyState>
15
+
16
+ export default meta
17
+ type Story = StoryObj<typeof meta>
18
+
19
+ export const Default: Story = {
20
+ args: {
21
+ title: "No tenants yet",
22
+ description: "Create your first tenant to get started.",
23
+ },
24
+ render: (args) => <EmptyState {...args} className="max-w-sm" />,
25
+ }
26
+
27
+ export const WithAction: Story = {
28
+ args: {
29
+ title: "No roles found",
30
+ description: "Roles you create will show up here.",
31
+ action: (
32
+ <Button size="sm" variant="outline">
33
+ <IconPlus /> Create role
34
+ </Button>
35
+ ),
36
+ },
37
+ render: (args) => <EmptyState {...args} className="max-w-sm" />,
38
+ }
39
+
40
+ export const Error: Story = {
41
+ args: {
42
+ title: "Couldn't load audit logs",
43
+ description: "The request failed. Check your connection and try again.",
44
+ action: (
45
+ <Button size="sm" variant="outline">
46
+ <IconRefresh /> Retry
47
+ </Button>
48
+ ),
49
+ },
50
+ render: (args) => <ErrorState {...args} className="max-w-sm" />,
51
+ }
@@ -1,100 +1,126 @@
1
- import * as React from "react"
2
- import { cva, type VariantProps } from "class-variance-authority"
3
- import { IconInbox, IconAlertTriangle } from "@tabler/icons-react"
4
-
5
- import { cn } from "./utils"
6
-
7
- /**
8
- * Shared shape for EmptyState ("nothing here yet") and ErrorState ("something
9
- * went wrong") — the two states share every prop; only the tone/default icon
10
- * and the announced ARIA role differ. Kept as one variant-driven component so
11
- * the two never drift apart visually.
12
- *
13
- * PLATFORM NOTE: `icon` and `action` are optional slot overrides (web-only —
14
- * arbitrary React nodes cannot cross to a future Flutter/Dart port). Every
15
- * OTHER prop (`variant`, `title`, `description`) is a plain string/enum, so a
16
- * Flutter implementation can mirror the same contract and supply its own
17
- * platform-appropriate default icon/action per variant.
18
- */
19
- const emptyStateVariants = cva(
20
- "flex flex-col items-center justify-center gap-2 rounded-lg border border-dashed border-border p-8 text-center",
21
- {
22
- variants: {
23
- variant: {
24
- empty: "text-muted-foreground",
25
- error: "border-destructive/30 text-destructive",
26
- },
27
- },
28
- defaultVariants: {
29
- variant: "empty",
30
- },
31
- }
32
- )
33
-
34
- export interface EmptyStateProps
35
- extends Omit<React.ComponentProps<"div">, "title">,
36
- VariantProps<typeof emptyStateVariants> {
37
- /** Slot override for the icon; falls back to a sensible per-variant default. */
38
- icon?: React.ReactNode
39
- title: string
40
- description?: string
41
- /** Slot for a retry/create/etc. control — typically a <Button>. */
42
- action?: React.ReactNode
43
- }
44
-
45
- function EmptyState({
46
- className,
47
- variant,
48
- icon,
49
- title,
50
- description,
51
- action,
52
- ...props
53
- }: EmptyStateProps) {
54
- const resolvedVariant = variant ?? "empty"
55
- const defaultIcon =
56
- resolvedVariant === "error" ? <IconAlertTriangle /> : <IconInbox />
57
-
58
- return (
59
- <div
60
- data-slot="empty-state"
61
- // Errors interrupt (assertive); an empty list is just informational
62
- // (polite) — matches the same distinction Alert/ErrorState conventions
63
- // draw elsewhere in this package.
64
- role={resolvedVariant === "error" ? "alert" : "status"}
65
- className={cn(emptyStateVariants({ variant }), className)}
66
- {...props}
67
- >
68
- <div
69
- data-slot="empty-state-icon"
70
- aria-hidden="true"
71
- className="text-muted-foreground [&>svg]:size-8 [&>svg]:stroke-1"
72
- >
73
- {icon ?? defaultIcon}
74
- </div>
75
- <div data-slot="empty-state-title" className="text-sm font-medium text-foreground">
76
- {title}
77
- </div>
78
- {description ? (
79
- <div
80
- data-slot="empty-state-description"
81
- className="max-w-sm text-xs/relaxed text-muted-foreground text-balance"
82
- >
83
- {description}
84
- </div>
85
- ) : null}
86
- {action ? (
87
- <div data-slot="empty-state-action" className="mt-2">
88
- {action}
89
- </div>
90
- ) : null}
91
- </div>
92
- )
93
- }
94
-
95
- /** ErrorState is EmptyState pinned to variant="error" — same contract, error tone. */
96
- function ErrorState(props: Omit<EmptyStateProps, "variant">) {
97
- return <EmptyState {...props} variant="error" />
98
- }
99
-
100
- export { EmptyState, ErrorState, emptyStateVariants }
1
+ import * as React from "react"
2
+ import { cva, type VariantProps } from "class-variance-authority"
3
+ import { IconInbox, IconAlertTriangle } from "@tabler/icons-react"
4
+
5
+ import { Lottie, type MomentName } from "./lottie"
6
+ import { cn } from "./utils"
7
+
8
+ /**
9
+ * Shared shape for EmptyState ("nothing here yet") and ErrorState ("something
10
+ * went wrong") — the two states share every prop; only the tone/default icon
11
+ * and the announced ARIA role differ. Kept as one variant-driven component so
12
+ * the two never drift apart visually.
13
+ *
14
+ * PLATFORM NOTE: `icon` and `action` are optional slot overrides (web-only —
15
+ * arbitrary React nodes cannot cross to a future Flutter/Dart port). Every
16
+ * OTHER prop (`variant`, `title`, `description`) is a plain string/enum, so a
17
+ * Flutter implementation can mirror the same contract and supply its own
18
+ * platform-appropriate default icon/action per variant.
19
+ */
20
+ const emptyStateVariants = cva(
21
+ "flex flex-col items-center justify-center gap-2 rounded-lg border border-dashed border-border p-8 text-center",
22
+ {
23
+ variants: {
24
+ variant: {
25
+ empty: "text-muted-foreground",
26
+ error: "border-destructive/30 text-destructive",
27
+ },
28
+ },
29
+ defaultVariants: {
30
+ variant: "empty",
31
+ },
32
+ }
33
+ )
34
+
35
+ export interface EmptyStateProps
36
+ extends Omit<React.ComponentProps<"div">, "title">,
37
+ VariantProps<typeof emptyStateVariants> {
38
+ /** Slot override for the icon; falls back to a sensible per-variant default. */
39
+ icon?: React.ReactNode
40
+ title: string
41
+ description?: string
42
+ /** Slot for a retry/create/etc. control — typically a <Button>. */
43
+ action?: React.ReactNode
44
+ /**
45
+ * A Lottie moment in place of the icon (LT.4): `empty-*` the first time a list
46
+ * is empty, `no-results` after a search, `all-caught-up` when nothing waits.
47
+ * One scene at most on a screen; the icon shows until it is ready.
48
+ */
49
+ moment?: MomentName
50
+ /** Play the moment once a session under this key (empty lists), then show it still. */
51
+ once?: string
52
+ /** Play the moment once ever on this device (first-run scenes such as `agents-propose`). */
53
+ onceEver?: string
54
+ }
55
+
56
+ function EmptyState({
57
+ className,
58
+ variant,
59
+ icon,
60
+ title,
61
+ description,
62
+ action,
63
+ moment,
64
+ once,
65
+ onceEver,
66
+ ...props
67
+ }: EmptyStateProps) {
68
+ const resolvedVariant = variant ?? "empty"
69
+ const defaultIcon =
70
+ resolvedVariant === "error" ? <IconAlertTriangle /> : <IconInbox />
71
+
72
+ return (
73
+ <div
74
+ data-slot="empty-state"
75
+ // Errors interrupt (assertive); an empty list is just informational
76
+ // (polite) — matches the same distinction Alert/ErrorState conventions
77
+ // draw elsewhere in this package.
78
+ role={resolvedVariant === "error" ? "alert" : "status"}
79
+ className={cn(emptyStateVariants({ variant }), className)}
80
+ {...props}
81
+ >
82
+ {moment ? (
83
+ <Lottie
84
+ name={moment}
85
+ once={once}
86
+ onceEver={onceEver}
87
+ className="h-[120px] w-[160px]"
88
+ fallback={
89
+ <span className="text-muted-foreground [&>svg]:size-8 [&>svg]:stroke-1">{icon ?? defaultIcon}</span>
90
+ }
91
+ />
92
+ ) : (
93
+ <div
94
+ data-slot="empty-state-icon"
95
+ aria-hidden="true"
96
+ className="text-muted-foreground [&>svg]:size-8 [&>svg]:stroke-1"
97
+ >
98
+ {icon ?? defaultIcon}
99
+ </div>
100
+ )}
101
+ <div data-slot="empty-state-title" className="text-sm font-medium text-foreground">
102
+ {title}
103
+ </div>
104
+ {description ? (
105
+ <div
106
+ data-slot="empty-state-description"
107
+ className="max-w-sm text-xs/relaxed text-muted-foreground text-balance"
108
+ >
109
+ {description}
110
+ </div>
111
+ ) : null}
112
+ {action ? (
113
+ <div data-slot="empty-state-action" className="mt-2">
114
+ {action}
115
+ </div>
116
+ ) : null}
117
+ </div>
118
+ )
119
+ }
120
+
121
+ /** ErrorState is EmptyState pinned to variant="error" — same contract, error tone. */
122
+ function ErrorState(props: Omit<EmptyStateProps, "variant">) {
123
+ return <EmptyState {...props} variant="error" />
124
+ }
125
+
126
+ export { EmptyState, ErrorState, emptyStateVariants }
@@ -1,30 +1,30 @@
1
- # EmptyState / ErrorState — usage notes (for the gallery/showcase task)
2
-
3
- Import: `import { EmptyState, ErrorState } from '@whity/ui/empty-state'` (or the root barrel).
4
-
5
- `ErrorState` is `EmptyState` pinned to `variant="error"` — identical props minus `variant`.
6
-
7
- ## Props
8
-
9
- | Prop | Type | Required | Notes |
10
- |---|---|---|---|
11
- | `variant` | `'empty' \| 'error'` | no (default `'empty'`) | Not settable on `ErrorState` (always `'error'`). Drives tone + default icon + ARIA role. |
12
- | `icon` | `React.ReactNode` | no | Slot override. Falls back to `IconInbox` (empty) / `IconAlertTriangle` (error) from `@tabler/icons-react`. Web-only slot — see platform note below. |
13
- | `title` | `string` | **yes** | |
14
- | `description` | `string` | no | |
15
- | `action` | `React.ReactNode` | no | Typically a `<Button>` (e.g. "Retry" / "Create X"). |
16
- | ...rest | `React.ComponentProps<'div'>` | no | Spread onto the root element (e.g. `className`). |
17
-
18
- ## Accessibility
19
-
20
- - `EmptyState` renders `role="status"` (polite announcement — informational).
21
- - `ErrorState` renders `role="alert"` (assertive announcement — interrupts, matching real error semantics).
22
- - Verified via a real axe-core scan in `web/__tests__/empty-state.a11y.test.tsx` (0 violations across default, error, and with-action renders).
23
-
24
- ## Platform note (Flutter-forward design)
25
-
26
- `variant`, `title`, and `description` are plain string/enum props — directly mirrorable by a future Flutter/Dart component. `icon` and `action` are React-node slots and are **web-only**; a Flutter implementation should supply its own platform-appropriate default icon/action per `variant` rather than trying to accept an arbitrary widget through the same prop name.
27
-
28
- ## Gallery / Storybook
29
-
30
- Story file: `packages/ui/src/empty-state.stories.tsx` — `Default`, `WithAction`, `Error` stories under `Primitives/EmptyState`.
1
+ # EmptyState / ErrorState — usage notes (for the gallery/showcase task)
2
+
3
+ Import: `import { EmptyState, ErrorState } from '@whity/ui/empty-state'` (or the root barrel).
4
+
5
+ `ErrorState` is `EmptyState` pinned to `variant="error"` — identical props minus `variant`.
6
+
7
+ ## Props
8
+
9
+ | Prop | Type | Required | Notes |
10
+ |---|---|---|---|
11
+ | `variant` | `'empty' \| 'error'` | no (default `'empty'`) | Not settable on `ErrorState` (always `'error'`). Drives tone + default icon + ARIA role. |
12
+ | `icon` | `React.ReactNode` | no | Slot override. Falls back to `IconInbox` (empty) / `IconAlertTriangle` (error) from `@tabler/icons-react`. Web-only slot — see platform note below. |
13
+ | `title` | `string` | **yes** | |
14
+ | `description` | `string` | no | |
15
+ | `action` | `React.ReactNode` | no | Typically a `<Button>` (e.g. "Retry" / "Create X"). |
16
+ | ...rest | `React.ComponentProps<'div'>` | no | Spread onto the root element (e.g. `className`). |
17
+
18
+ ## Accessibility
19
+
20
+ - `EmptyState` renders `role="status"` (polite announcement — informational).
21
+ - `ErrorState` renders `role="alert"` (assertive announcement — interrupts, matching real error semantics).
22
+ - Verified via a real axe-core scan in `web/__tests__/empty-state.a11y.test.tsx` (0 violations across default, error, and with-action renders).
23
+
24
+ ## Platform note (Flutter-forward design)
25
+
26
+ `variant`, `title`, and `description` are plain string/enum props — directly mirrorable by a future Flutter/Dart component. `icon` and `action` are React-node slots and are **web-only**; a Flutter implementation should supply its own platform-appropriate default icon/action per `variant` rather than trying to accept an arbitrary widget through the same prop name.
27
+
28
+ ## Gallery / Storybook
29
+
30
+ Story file: `packages/ui/src/empty-state.stories.tsx` — `Default`, `WithAction`, `Error` stories under `Primitives/EmptyState`.
@@ -1,112 +1,112 @@
1
- import type { Meta, StoryObj } from "@storybook/react-vite"
2
- import { fn } from "storybook/test"
3
- import { useForm } from "react-hook-form"
4
-
5
- import {
6
- Form,
7
- FormField,
8
- FormItem,
9
- FormLabel,
10
- FormControl,
11
- FormDescription,
12
- FormMessage,
13
- } from "./form"
14
- import { Input } from "./input"
15
- import { Button } from "./button"
16
-
17
- type Values = { name: string; email: string }
18
-
19
- interface TenantFormProps {
20
- /** Seeds the fields — the shape a real screen would hydrate from the API. */
21
- defaultValues?: Values
22
- /** Label of the submit button. */
23
- submitLabel?: string
24
- /** Fired with the validated values once the form submits cleanly. */
25
- onSubmit?: (values: Values) => void
26
- }
27
-
28
- /**
29
- * A representative form assembled from this module's primitives. `Form` is
30
- * react-hook-form's `FormProvider`, whose props are a live `useForm()` return
31
- * value — it can only be produced by a hook at render time, never by static
32
- * story args — so the stories document the composition through this wrapper
33
- * instead of the provider itself.
34
- */
35
- function TenantForm({
36
- defaultValues = { name: "", email: "" },
37
- submitLabel = "Create tenant",
38
- onSubmit = () => {},
39
- }: TenantFormProps) {
40
- const form = useForm<Values>({ defaultValues, mode: "onTouched" })
41
-
42
- return (
43
- <Form {...form}>
44
- <form onSubmit={form.handleSubmit(onSubmit)} className="flex w-80 flex-col gap-4">
45
- <FormField
46
- control={form.control}
47
- name="name"
48
- rules={{ required: "Name is required" }}
49
- render={({ field }) => (
50
- <FormItem>
51
- <FormLabel>Tenant name</FormLabel>
52
- <FormControl>
53
- <Input placeholder="Acme" {...field} />
54
- </FormControl>
55
- <FormDescription>Shown across the dashboard.</FormDescription>
56
- <FormMessage />
57
- </FormItem>
58
- )}
59
- />
60
- <FormField
61
- control={form.control}
62
- name="email"
63
- rules={{
64
- required: "Email is required",
65
- pattern: { value: /^[^@]+@[^@]+$/, message: "Enter a valid email" },
66
- }}
67
- render={({ field }) => (
68
- <FormItem>
69
- <FormLabel>Admin email</FormLabel>
70
- <FormControl>
71
- <Input type="email" placeholder="admin@acme.com" {...field} />
72
- </FormControl>
73
- <FormMessage />
74
- </FormItem>
75
- )}
76
- />
77
- <Button type="submit">{submitLabel}</Button>
78
- </form>
79
- </Form>
80
- )
81
- }
82
-
83
- const meta = {
84
- title: "Primitives/Form",
85
- component: TenantForm,
86
- tags: ["autodocs"],
87
- parameters: {
88
- layout: "padded",
89
- docs: {
90
- description: {
91
- component:
92
- "`Form`, `FormField`, `FormItem`, `FormLabel`, `FormControl`, `FormDescription` and `FormMessage` are the react-hook-form bindings shipped by this package. The stories exercise them through a representative tenant-creation form.",
93
- },
94
- },
95
- },
96
- args: {
97
- onSubmit: fn(),
98
- },
99
- } satisfies Meta<typeof TenantForm>
100
-
101
- export default meta
102
- type Story = StoryObj<typeof meta>
103
-
104
- export const Default: Story = {}
105
-
106
- /** Prefilled the way an edit screen hydrates the form from an existing record. */
107
- export const Prefilled: Story = {
108
- args: {
109
- defaultValues: { name: "Acme Inc.", email: "admin@acme.com" },
110
- submitLabel: "Save changes",
111
- },
112
- }
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { fn } from "storybook/test"
3
+ import { useForm } from "react-hook-form"
4
+
5
+ import {
6
+ Form,
7
+ FormField,
8
+ FormItem,
9
+ FormLabel,
10
+ FormControl,
11
+ FormDescription,
12
+ FormMessage,
13
+ } from "./form"
14
+ import { Input } from "./input"
15
+ import { Button } from "./button"
16
+
17
+ type Values = { name: string; email: string }
18
+
19
+ interface TenantFormProps {
20
+ /** Seeds the fields — the shape a real screen would hydrate from the API. */
21
+ defaultValues?: Values
22
+ /** Label of the submit button. */
23
+ submitLabel?: string
24
+ /** Fired with the validated values once the form submits cleanly. */
25
+ onSubmit?: (values: Values) => void
26
+ }
27
+
28
+ /**
29
+ * A representative form assembled from this module's primitives. `Form` is
30
+ * react-hook-form's `FormProvider`, whose props are a live `useForm()` return
31
+ * value — it can only be produced by a hook at render time, never by static
32
+ * story args — so the stories document the composition through this wrapper
33
+ * instead of the provider itself.
34
+ */
35
+ function TenantForm({
36
+ defaultValues = { name: "", email: "" },
37
+ submitLabel = "Create tenant",
38
+ onSubmit = () => {},
39
+ }: TenantFormProps) {
40
+ const form = useForm<Values>({ defaultValues, mode: "onTouched" })
41
+
42
+ return (
43
+ <Form {...form}>
44
+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex w-80 flex-col gap-4">
45
+ <FormField
46
+ control={form.control}
47
+ name="name"
48
+ rules={{ required: "Name is required" }}
49
+ render={({ field }) => (
50
+ <FormItem>
51
+ <FormLabel>Tenant name</FormLabel>
52
+ <FormControl>
53
+ <Input placeholder="Acme" {...field} />
54
+ </FormControl>
55
+ <FormDescription>Shown across the dashboard.</FormDescription>
56
+ <FormMessage />
57
+ </FormItem>
58
+ )}
59
+ />
60
+ <FormField
61
+ control={form.control}
62
+ name="email"
63
+ rules={{
64
+ required: "Email is required",
65
+ pattern: { value: /^[^@]+@[^@]+$/, message: "Enter a valid email" },
66
+ }}
67
+ render={({ field }) => (
68
+ <FormItem>
69
+ <FormLabel>Admin email</FormLabel>
70
+ <FormControl>
71
+ <Input type="email" placeholder="admin@acme.com" {...field} />
72
+ </FormControl>
73
+ <FormMessage />
74
+ </FormItem>
75
+ )}
76
+ />
77
+ <Button type="submit">{submitLabel}</Button>
78
+ </form>
79
+ </Form>
80
+ )
81
+ }
82
+
83
+ const meta = {
84
+ title: "Primitives/Form",
85
+ component: TenantForm,
86
+ tags: ["autodocs"],
87
+ parameters: {
88
+ layout: "padded",
89
+ docs: {
90
+ description: {
91
+ component:
92
+ "`Form`, `FormField`, `FormItem`, `FormLabel`, `FormControl`, `FormDescription` and `FormMessage` are the react-hook-form bindings shipped by this package. The stories exercise them through a representative tenant-creation form.",
93
+ },
94
+ },
95
+ },
96
+ args: {
97
+ onSubmit: fn(),
98
+ },
99
+ } satisfies Meta<typeof TenantForm>
100
+
101
+ export default meta
102
+ type Story = StoryObj<typeof meta>
103
+
104
+ export const Default: Story = {}
105
+
106
+ /** Prefilled the way an edit screen hydrates the form from an existing record. */
107
+ export const Prefilled: Story = {
108
+ args: {
109
+ defaultValues: { name: "Acme Inc.", email: "admin@acme.com" },
110
+ submitLabel: "Save changes",
111
+ },
112
+ }