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