@whity/ui 0.5.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +107 -107
- package/package.json +221 -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 +123 -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 +398 -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 +1686 -1106
- package/src/date-picker.stories.tsx +61 -61
- package/src/date-picker.tsx +456 -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 +50 -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 +90 -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-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/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 +164 -164
- package/src/textarea.stories.tsx +27 -27
- package/src/textarea.tsx +18 -18
- package/src/theme-mode.ts +52 -52
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -62
- package/src/time-picker.tsx +615 -615
- package/src/toggle-group.tsx +138 -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 +110 -110
package/src/page-header.tsx
CHANGED
|
@@ -1,122 +1,122 @@
|
|
|
1
|
-
import * as React from "react"
|
|
2
|
-
|
|
3
|
-
import { cn } from "./utils"
|
|
4
|
-
|
|
5
|
-
export interface PageHeaderProps {
|
|
6
|
-
/**
|
|
7
|
-
* Main page title text or node.
|
|
8
|
-
*/
|
|
9
|
-
title: React.ReactNode
|
|
10
|
-
/**
|
|
11
|
-
* Subtitle or description explaining the page context.
|
|
12
|
-
*/
|
|
13
|
-
description?: React.ReactNode
|
|
14
|
-
/**
|
|
15
|
-
* Optional icon displayed in a rounded container next to the title.
|
|
16
|
-
*/
|
|
17
|
-
icon?: React.ReactNode
|
|
18
|
-
/**
|
|
19
|
-
* Optional status or version badge node displayed next to the title.
|
|
20
|
-
*/
|
|
21
|
-
badge?: React.ReactNode
|
|
22
|
-
/**
|
|
23
|
-
* Action buttons or controls rendered on the right side of the header.
|
|
24
|
-
*/
|
|
25
|
-
action?: React.ReactNode
|
|
26
|
-
/**
|
|
27
|
-
* Breadcrumb navigation trail rendered above the title.
|
|
28
|
-
*/
|
|
29
|
-
breadcrumb?: React.ReactNode
|
|
30
|
-
/**
|
|
31
|
-
* Secondary controls rendered below the header (e.g. tabs, search bar, filters).
|
|
32
|
-
*/
|
|
33
|
-
children?: React.ReactNode
|
|
34
|
-
/**
|
|
35
|
-
* Visual layout style: "default" (clean section with border) or "card" (elevated card container).
|
|
36
|
-
*/
|
|
37
|
-
variant?: "default" | "card"
|
|
38
|
-
className?: string
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
export function PageHeader({
|
|
42
|
-
title,
|
|
43
|
-
description,
|
|
44
|
-
icon,
|
|
45
|
-
badge,
|
|
46
|
-
action,
|
|
47
|
-
breadcrumb,
|
|
48
|
-
children,
|
|
49
|
-
variant = "default",
|
|
50
|
-
className,
|
|
51
|
-
}: PageHeaderProps) {
|
|
52
|
-
if (variant === "card") {
|
|
53
|
-
return (
|
|
54
|
-
<div
|
|
55
|
-
data-slot="page-header"
|
|
56
|
-
className={cn(
|
|
57
|
-
"mb-6 flex flex-col gap-4 rounded-xl border border-border bg-card p-5 md:p-6 shadow-2xs transition-colors",
|
|
58
|
-
className
|
|
59
|
-
)}
|
|
60
|
-
>
|
|
61
|
-
{breadcrumb && <div className="text-xs text-muted-foreground">{breadcrumb}</div>}
|
|
62
|
-
<div className="flex flex-col gap-4 md:flex-row md:items-center md:justify-between">
|
|
63
|
-
<div className="flex items-start gap-3.5 min-w-0">
|
|
64
|
-
{icon && (
|
|
65
|
-
<div className="flex size-10 shrink-0 items-center justify-center rounded-xl bg-primary/10 text-primary shadow-2xs">
|
|
66
|
-
<span className="[&_svg]:size-5">{icon}</span>
|
|
67
|
-
</div>
|
|
68
|
-
)}
|
|
69
|
-
<div className="flex flex-col gap-1 min-w-0">
|
|
70
|
-
<div className="flex flex-wrap items-center gap-2">
|
|
71
|
-
<h1 className="text-xl md:text-2xl font-semibold tracking-tight text-foreground truncate">
|
|
72
|
-
{title}
|
|
73
|
-
</h1>
|
|
74
|
-
{badge && <div className="shrink-0">{badge}</div>}
|
|
75
|
-
</div>
|
|
76
|
-
{description && (
|
|
77
|
-
<p className="text-xs md:text-sm text-muted-foreground leading-relaxed max-w-3xl">
|
|
78
|
-
{description}
|
|
79
|
-
</p>
|
|
80
|
-
)}
|
|
81
|
-
</div>
|
|
82
|
-
</div>
|
|
83
|
-
{action && <div className="flex items-center gap-2
|
|
84
|
-
</div>
|
|
85
|
-
{children && <div className="pt-2 border-t border-border/50">{children}</div>}
|
|
86
|
-
</div>
|
|
87
|
-
)
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
return (
|
|
91
|
-
<div
|
|
92
|
-
data-slot="page-header"
|
|
93
|
-
className={cn("mb-6 flex flex-col gap-3.5 border-b border-border pb-5", className)}
|
|
94
|
-
>
|
|
95
|
-
{breadcrumb && <div className="text-xs text-muted-foreground">{breadcrumb}</div>}
|
|
96
|
-
<div className="flex flex-col gap-4 md:flex-row md:items-center md:justify-between">
|
|
97
|
-
<div className="flex items-start gap-3.5 min-w-0">
|
|
98
|
-
{icon && (
|
|
99
|
-
<div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10 text-primary shadow-2xs mt-0.5">
|
|
100
|
-
<span className="[&_svg]:size-4.5">{icon}</span>
|
|
101
|
-
</div>
|
|
102
|
-
)}
|
|
103
|
-
<div className="flex flex-col gap-1 min-w-0">
|
|
104
|
-
<div className="flex flex-wrap items-center gap-2">
|
|
105
|
-
<h1 className="text-xl md:text-2xl font-semibold tracking-tight text-foreground truncate">
|
|
106
|
-
{title}
|
|
107
|
-
</h1>
|
|
108
|
-
{badge && <div className="shrink-0">{badge}</div>}
|
|
109
|
-
</div>
|
|
110
|
-
{description && (
|
|
111
|
-
<p className="text-xs md:text-sm text-muted-foreground leading-relaxed max-w-3xl">
|
|
112
|
-
{description}
|
|
113
|
-
</p>
|
|
114
|
-
)}
|
|
115
|
-
</div>
|
|
116
|
-
</div>
|
|
117
|
-
{action && <div className="flex items-center gap-2
|
|
118
|
-
</div>
|
|
119
|
-
{children && <div className="pt-2">{children}</div>}
|
|
120
|
-
</div>
|
|
121
|
-
)
|
|
122
|
-
}
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
|
|
3
|
+
import { cn } from "./utils"
|
|
4
|
+
|
|
5
|
+
export interface PageHeaderProps {
|
|
6
|
+
/**
|
|
7
|
+
* Main page title text or node.
|
|
8
|
+
*/
|
|
9
|
+
title: React.ReactNode
|
|
10
|
+
/**
|
|
11
|
+
* Subtitle or description explaining the page context.
|
|
12
|
+
*/
|
|
13
|
+
description?: React.ReactNode
|
|
14
|
+
/**
|
|
15
|
+
* Optional icon displayed in a rounded container next to the title.
|
|
16
|
+
*/
|
|
17
|
+
icon?: React.ReactNode
|
|
18
|
+
/**
|
|
19
|
+
* Optional status or version badge node displayed next to the title.
|
|
20
|
+
*/
|
|
21
|
+
badge?: React.ReactNode
|
|
22
|
+
/**
|
|
23
|
+
* Action buttons or controls rendered on the right side of the header.
|
|
24
|
+
*/
|
|
25
|
+
action?: React.ReactNode
|
|
26
|
+
/**
|
|
27
|
+
* Breadcrumb navigation trail rendered above the title.
|
|
28
|
+
*/
|
|
29
|
+
breadcrumb?: React.ReactNode
|
|
30
|
+
/**
|
|
31
|
+
* Secondary controls rendered below the header (e.g. tabs, search bar, filters).
|
|
32
|
+
*/
|
|
33
|
+
children?: React.ReactNode
|
|
34
|
+
/**
|
|
35
|
+
* Visual layout style: "default" (clean section with border) or "card" (elevated card container).
|
|
36
|
+
*/
|
|
37
|
+
variant?: "default" | "card"
|
|
38
|
+
className?: string
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export function PageHeader({
|
|
42
|
+
title,
|
|
43
|
+
description,
|
|
44
|
+
icon,
|
|
45
|
+
badge,
|
|
46
|
+
action,
|
|
47
|
+
breadcrumb,
|
|
48
|
+
children,
|
|
49
|
+
variant = "default",
|
|
50
|
+
className,
|
|
51
|
+
}: PageHeaderProps) {
|
|
52
|
+
if (variant === "card") {
|
|
53
|
+
return (
|
|
54
|
+
<div
|
|
55
|
+
data-slot="page-header"
|
|
56
|
+
className={cn(
|
|
57
|
+
"mb-6 flex flex-col gap-4 rounded-xl border border-border bg-card p-5 md:p-6 shadow-2xs transition-colors",
|
|
58
|
+
className
|
|
59
|
+
)}
|
|
60
|
+
>
|
|
61
|
+
{breadcrumb && <div className="text-xs text-muted-foreground">{breadcrumb}</div>}
|
|
62
|
+
<div className="flex flex-col gap-4 md:flex-row md:items-center md:justify-between">
|
|
63
|
+
<div className="flex items-start gap-3.5 min-w-0">
|
|
64
|
+
{icon && (
|
|
65
|
+
<div className="flex size-10 shrink-0 items-center justify-center rounded-xl bg-primary/10 text-primary shadow-2xs">
|
|
66
|
+
<span className="[&_svg]:size-5">{icon}</span>
|
|
67
|
+
</div>
|
|
68
|
+
)}
|
|
69
|
+
<div className="flex flex-col gap-1 min-w-0">
|
|
70
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
71
|
+
<h1 className="text-xl md:text-2xl font-semibold tracking-tight text-foreground break-words md:truncate">
|
|
72
|
+
{title}
|
|
73
|
+
</h1>
|
|
74
|
+
{badge && <div className="shrink-0">{badge}</div>}
|
|
75
|
+
</div>
|
|
76
|
+
{description && (
|
|
77
|
+
<p className="text-xs md:text-sm text-muted-foreground leading-relaxed max-w-3xl">
|
|
78
|
+
{description}
|
|
79
|
+
</p>
|
|
80
|
+
)}
|
|
81
|
+
</div>
|
|
82
|
+
</div>
|
|
83
|
+
{action && <div className="flex min-w-0 flex-wrap items-center gap-2 self-start md:shrink-0 md:self-center">{action}</div>}
|
|
84
|
+
</div>
|
|
85
|
+
{children && <div className="pt-2 border-t border-border/50">{children}</div>}
|
|
86
|
+
</div>
|
|
87
|
+
)
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
return (
|
|
91
|
+
<div
|
|
92
|
+
data-slot="page-header"
|
|
93
|
+
className={cn("mb-6 flex flex-col gap-3.5 border-b border-border pb-5", className)}
|
|
94
|
+
>
|
|
95
|
+
{breadcrumb && <div className="text-xs text-muted-foreground">{breadcrumb}</div>}
|
|
96
|
+
<div className="flex flex-col gap-4 md:flex-row md:items-center md:justify-between">
|
|
97
|
+
<div className="flex items-start gap-3.5 min-w-0">
|
|
98
|
+
{icon && (
|
|
99
|
+
<div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10 text-primary shadow-2xs mt-0.5">
|
|
100
|
+
<span className="[&_svg]:size-4.5">{icon}</span>
|
|
101
|
+
</div>
|
|
102
|
+
)}
|
|
103
|
+
<div className="flex flex-col gap-1 min-w-0">
|
|
104
|
+
<div className="flex flex-wrap items-center gap-2">
|
|
105
|
+
<h1 className="text-xl md:text-2xl font-semibold tracking-tight text-foreground break-words md:truncate">
|
|
106
|
+
{title}
|
|
107
|
+
</h1>
|
|
108
|
+
{badge && <div className="shrink-0">{badge}</div>}
|
|
109
|
+
</div>
|
|
110
|
+
{description && (
|
|
111
|
+
<p className="text-xs md:text-sm text-muted-foreground leading-relaxed max-w-3xl">
|
|
112
|
+
{description}
|
|
113
|
+
</p>
|
|
114
|
+
)}
|
|
115
|
+
</div>
|
|
116
|
+
</div>
|
|
117
|
+
{action && <div className="flex min-w-0 flex-wrap items-center gap-2 self-start md:shrink-0 md:self-center">{action}</div>}
|
|
118
|
+
</div>
|
|
119
|
+
{children && <div className="pt-2">{children}</div>}
|
|
120
|
+
</div>
|
|
121
|
+
)
|
|
122
|
+
}
|
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
-
|
|
3
|
-
import { PageShell } from "./page-shell"
|
|
4
|
-
|
|
5
|
-
const DemoSidebar = () => (
|
|
6
|
-
<div className="w-56 shrink-0 border-e border-sidebar-border bg-sidebar p-4 text-sm text-sidebar-foreground">
|
|
7
|
-
Sidebar
|
|
8
|
-
</div>
|
|
9
|
-
)
|
|
10
|
-
|
|
11
|
-
const DemoTopBar = () => (
|
|
12
|
-
<div className="flex h-12 items-center border-b border-border px-4 text-sm text-foreground">Top bar</div>
|
|
13
|
-
)
|
|
14
|
-
|
|
15
|
-
const meta = {
|
|
16
|
-
title: "Layout/PageShell",
|
|
17
|
-
component: PageShell,
|
|
18
|
-
tags: ["autodocs"],
|
|
19
|
-
args: {
|
|
20
|
-
sidebar: <DemoSidebar />,
|
|
21
|
-
className: "h-full min-h-0",
|
|
22
|
-
children: <p className="text-sm text-foreground">Page content goes here.</p>,
|
|
23
|
-
},
|
|
24
|
-
// The shell fills its parent, so every story is framed by a fixed-height box
|
|
25
|
-
// the way a real app viewport frames it.
|
|
26
|
-
decorators: [
|
|
27
|
-
(Story) => (
|
|
28
|
-
<div className="h-80 overflow-hidden rounded-lg border border-border">
|
|
29
|
-
<Story />
|
|
30
|
-
</div>
|
|
31
|
-
),
|
|
32
|
-
],
|
|
33
|
-
} satisfies Meta<typeof PageShell>
|
|
34
|
-
|
|
35
|
-
export default meta
|
|
36
|
-
type Story = StoryObj<typeof meta>
|
|
37
|
-
|
|
38
|
-
export const Default: Story = {}
|
|
39
|
-
|
|
40
|
-
export const WithTopBar: Story = {
|
|
41
|
-
args: { topBar: <DemoTopBar /> },
|
|
42
|
-
}
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
|
|
3
|
+
import { PageShell } from "./page-shell"
|
|
4
|
+
|
|
5
|
+
const DemoSidebar = () => (
|
|
6
|
+
<div className="w-56 shrink-0 border-e border-sidebar-border bg-sidebar p-4 text-sm text-sidebar-foreground">
|
|
7
|
+
Sidebar
|
|
8
|
+
</div>
|
|
9
|
+
)
|
|
10
|
+
|
|
11
|
+
const DemoTopBar = () => (
|
|
12
|
+
<div className="flex h-12 items-center border-b border-border px-4 text-sm text-foreground">Top bar</div>
|
|
13
|
+
)
|
|
14
|
+
|
|
15
|
+
const meta = {
|
|
16
|
+
title: "Layout/PageShell",
|
|
17
|
+
component: PageShell,
|
|
18
|
+
tags: ["autodocs"],
|
|
19
|
+
args: {
|
|
20
|
+
sidebar: <DemoSidebar />,
|
|
21
|
+
className: "h-full min-h-0",
|
|
22
|
+
children: <p className="text-sm text-foreground">Page content goes here.</p>,
|
|
23
|
+
},
|
|
24
|
+
// The shell fills its parent, so every story is framed by a fixed-height box
|
|
25
|
+
// the way a real app viewport frames it.
|
|
26
|
+
decorators: [
|
|
27
|
+
(Story) => (
|
|
28
|
+
<div className="h-80 overflow-hidden rounded-lg border border-border">
|
|
29
|
+
<Story />
|
|
30
|
+
</div>
|
|
31
|
+
),
|
|
32
|
+
],
|
|
33
|
+
} satisfies Meta<typeof PageShell>
|
|
34
|
+
|
|
35
|
+
export default meta
|
|
36
|
+
type Story = StoryObj<typeof meta>
|
|
37
|
+
|
|
38
|
+
export const Default: Story = {}
|
|
39
|
+
|
|
40
|
+
export const WithTopBar: Story = {
|
|
41
|
+
args: { topBar: <DemoTopBar /> },
|
|
42
|
+
}
|
package/src/page-shell.tsx
CHANGED
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
import * as React from "react"
|
|
2
|
-
|
|
3
|
-
import { cn } from "./utils"
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* PRESENTATIONAL application-frame layout only — slots for a sidebar, an
|
|
7
|
-
* optional top bar, and a content region. No auth/redirect/onboarding logic
|
|
8
|
-
* (that's the app-specific route layout wrapping this, e.g.
|
|
9
|
-
* web/app/(protected)/layout.tsx) — this component only owns the chrome
|
|
10
|
-
* arrangement so every client's "logged-in app frame" matches without
|
|
11
|
-
* re-implementing the flex/scroll layout by hand.
|
|
12
|
-
*/
|
|
13
|
-
export interface PageShellProps {
|
|
14
|
-
sidebar: React.ReactNode
|
|
15
|
-
topBar?: React.ReactNode
|
|
16
|
-
children: React.ReactNode
|
|
17
|
-
className?: string
|
|
18
|
-
/** Class applied to the scrollable content region (defaults to standard page padding). */
|
|
19
|
-
contentClassName?: string
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
export function PageShell({ sidebar, topBar, children, className, contentClassName }: PageShellProps) {
|
|
23
|
-
return (
|
|
24
|
-
<div data-slot="page-shell" className={cn("flex min-h-screen bg-background", className)}>
|
|
25
|
-
{sidebar}
|
|
26
|
-
<div className="flex min-w-0 flex-1 flex-col">
|
|
27
|
-
{topBar}
|
|
28
|
-
<main className={cn("flex-1 overflow-y-auto p-6", contentClassName)}>{children}</main>
|
|
29
|
-
</div>
|
|
30
|
-
</div>
|
|
31
|
-
)
|
|
32
|
-
}
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
|
|
3
|
+
import { cn } from "./utils"
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* PRESENTATIONAL application-frame layout only — slots for a sidebar, an
|
|
7
|
+
* optional top bar, and a content region. No auth/redirect/onboarding logic
|
|
8
|
+
* (that's the app-specific route layout wrapping this, e.g.
|
|
9
|
+
* web/app/(protected)/layout.tsx) — this component only owns the chrome
|
|
10
|
+
* arrangement so every client's "logged-in app frame" matches without
|
|
11
|
+
* re-implementing the flex/scroll layout by hand.
|
|
12
|
+
*/
|
|
13
|
+
export interface PageShellProps {
|
|
14
|
+
sidebar: React.ReactNode
|
|
15
|
+
topBar?: React.ReactNode
|
|
16
|
+
children: React.ReactNode
|
|
17
|
+
className?: string
|
|
18
|
+
/** Class applied to the scrollable content region (defaults to standard page padding). */
|
|
19
|
+
contentClassName?: string
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function PageShell({ sidebar, topBar, children, className, contentClassName }: PageShellProps) {
|
|
23
|
+
return (
|
|
24
|
+
<div data-slot="page-shell" className={cn("flex min-h-screen bg-background", className)}>
|
|
25
|
+
{sidebar}
|
|
26
|
+
<div className="flex min-w-0 flex-1 flex-col">
|
|
27
|
+
{topBar}
|
|
28
|
+
<main className={cn("flex-1 overflow-y-auto p-6", contentClassName)}>{children}</main>
|
|
29
|
+
</div>
|
|
30
|
+
</div>
|
|
31
|
+
)
|
|
32
|
+
}
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
import * as React from "react"
|
|
2
|
+
|
|
3
|
+
import { Alert, AlertDescription, AlertTitle } from "./alert"
|
|
4
|
+
import { Button } from "./button"
|
|
5
|
+
import { Icon, type IconName } from "./icon"
|
|
6
|
+
import { Lottie, type MomentName } from "./lottie"
|
|
7
|
+
import { Skeleton } from "./skeleton"
|
|
8
|
+
import { cn } from "./utils"
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The six page states every list and record page uses (docs/design/components/
|
|
12
|
+
* PatternStates, V.2). A screen supplies its own wording; the shapes stay.
|
|
13
|
+
* Strings come from the caller through `t()`: this package holds no translations.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
/** Loading: the real layout with skeleton rows, never a spinner or "Loading…". */
|
|
17
|
+
function LoadingRows({
|
|
18
|
+
headers,
|
|
19
|
+
rows = 5,
|
|
20
|
+
label,
|
|
21
|
+
className,
|
|
22
|
+
}: {
|
|
23
|
+
/** The table's real column headers, which render at once. */
|
|
24
|
+
headers: string[]
|
|
25
|
+
rows?: number
|
|
26
|
+
/** Announced to assistive technology. */
|
|
27
|
+
label: string
|
|
28
|
+
className?: string
|
|
29
|
+
}) {
|
|
30
|
+
return (
|
|
31
|
+
<div role="status" aria-busy="true" aria-label={label} className={cn("overflow-hidden rounded-card border border-border bg-card", className)}>
|
|
32
|
+
<div className="flex h-10 items-center justify-between gap-3 bg-table-header px-3 text-xs font-medium text-muted-foreground">
|
|
33
|
+
{headers.map((header) => (
|
|
34
|
+
<span key={header} className="flex-1 last:flex-none">
|
|
35
|
+
{header}
|
|
36
|
+
</span>
|
|
37
|
+
))}
|
|
38
|
+
</div>
|
|
39
|
+
{Array.from({ length: rows }, (_, row) => (
|
|
40
|
+
<div key={row} className="flex h-(--row-h) items-center gap-3 border-t border-divider px-3">
|
|
41
|
+
{headers.map((header, column) => (
|
|
42
|
+
<span key={header} className="flex-1">
|
|
43
|
+
<Skeleton className="h-2.5 rounded-full" style={{ width: `${40 + ((row * 17 + column * 23) % 45)}%` }} />
|
|
44
|
+
</span>
|
|
45
|
+
))}
|
|
46
|
+
</div>
|
|
47
|
+
))}
|
|
48
|
+
</div>
|
|
49
|
+
)
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The dashed box shared by the two empty states: a tinted icon tile, or a Lottie
|
|
54
|
+
* moment (LT.4) with the tile as its fallback.
|
|
55
|
+
*/
|
|
56
|
+
function EmptyBox({
|
|
57
|
+
icon,
|
|
58
|
+
title,
|
|
59
|
+
description,
|
|
60
|
+
action,
|
|
61
|
+
moment,
|
|
62
|
+
once,
|
|
63
|
+
onceEver,
|
|
64
|
+
className,
|
|
65
|
+
}: {
|
|
66
|
+
icon: IconName
|
|
67
|
+
title: string
|
|
68
|
+
description?: string
|
|
69
|
+
action?: React.ReactNode
|
|
70
|
+
moment?: MomentName
|
|
71
|
+
once?: string
|
|
72
|
+
onceEver?: string
|
|
73
|
+
className?: string
|
|
74
|
+
}) {
|
|
75
|
+
const tile = (
|
|
76
|
+
<span className="grid size-12 place-items-center rounded-card bg-muted text-muted-foreground">
|
|
77
|
+
<Icon name={icon} size={24} />
|
|
78
|
+
</span>
|
|
79
|
+
)
|
|
80
|
+
return (
|
|
81
|
+
<div
|
|
82
|
+
className={cn(
|
|
83
|
+
"flex flex-col items-center gap-2 rounded-card border border-dashed border-border px-6 py-8 text-center",
|
|
84
|
+
className
|
|
85
|
+
)}
|
|
86
|
+
>
|
|
87
|
+
{moment ? <Lottie name={moment} once={once} onceEver={onceEver} className="h-[120px] w-[160px]" fallback={tile} /> : tile}
|
|
88
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
89
|
+
{description && <p className="max-w-prose text-sm text-muted-foreground">{description}</p>}
|
|
90
|
+
{action && <div className="mt-1">{action}</div>}
|
|
91
|
+
</div>
|
|
92
|
+
)
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Empty for the first time: what this place is for and the one action that fills it. */
|
|
96
|
+
function EmptyFirstTime({
|
|
97
|
+
icon = "inbox",
|
|
98
|
+
title,
|
|
99
|
+
description,
|
|
100
|
+
action,
|
|
101
|
+
moment,
|
|
102
|
+
once,
|
|
103
|
+
onceEver,
|
|
104
|
+
className,
|
|
105
|
+
}: {
|
|
106
|
+
icon?: IconName
|
|
107
|
+
title: string
|
|
108
|
+
description?: string
|
|
109
|
+
/** The page's main button. */
|
|
110
|
+
action?: React.ReactNode
|
|
111
|
+
/** `empty-documents`, `empty-people`, `empty-invoices`, `empty-stock`, `all-caught-up`, or a first-run scene (LT.4). */
|
|
112
|
+
moment?: MomentName
|
|
113
|
+
/** Plays once a session under this key; defaults to the moment's name. */
|
|
114
|
+
once?: string
|
|
115
|
+
/** Plays once ever on this device under this key instead (first-run scenes). */
|
|
116
|
+
onceEver?: string
|
|
117
|
+
className?: string
|
|
118
|
+
}) {
|
|
119
|
+
return (
|
|
120
|
+
<EmptyBox
|
|
121
|
+
icon={icon}
|
|
122
|
+
title={title}
|
|
123
|
+
description={description}
|
|
124
|
+
action={action}
|
|
125
|
+
moment={moment}
|
|
126
|
+
once={moment && !onceEver ? (once ?? moment) : undefined}
|
|
127
|
+
onceEver={onceEver}
|
|
128
|
+
className={className}
|
|
129
|
+
/>
|
|
130
|
+
)
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Empty after a filter: names the search or filter and offers Clear filters. */
|
|
134
|
+
function EmptyFiltered({
|
|
135
|
+
title,
|
|
136
|
+
description,
|
|
137
|
+
clearLabel,
|
|
138
|
+
onClear,
|
|
139
|
+
className,
|
|
140
|
+
}: {
|
|
141
|
+
/** Names the filter: "No one matches “Khalda”". */
|
|
142
|
+
title: string
|
|
143
|
+
description?: string
|
|
144
|
+
clearLabel: string
|
|
145
|
+
onClear: () => void
|
|
146
|
+
className?: string
|
|
147
|
+
}) {
|
|
148
|
+
return (
|
|
149
|
+
<EmptyBox
|
|
150
|
+
icon="search"
|
|
151
|
+
moment="no-results"
|
|
152
|
+
title={title}
|
|
153
|
+
description={description}
|
|
154
|
+
className={className}
|
|
155
|
+
action={
|
|
156
|
+
<Button type="button" variant="outline" onClick={onClear}>
|
|
157
|
+
{clearLabel}
|
|
158
|
+
</Button>
|
|
159
|
+
}
|
|
160
|
+
/>
|
|
161
|
+
)
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** Error: what failed in plain words, inside the area that failed, with Try again. */
|
|
165
|
+
function AreaError({
|
|
166
|
+
message,
|
|
167
|
+
retryLabel,
|
|
168
|
+
onRetry,
|
|
169
|
+
className,
|
|
170
|
+
}: {
|
|
171
|
+
message: string
|
|
172
|
+
retryLabel: string
|
|
173
|
+
onRetry: () => void
|
|
174
|
+
className?: string
|
|
175
|
+
}) {
|
|
176
|
+
return (
|
|
177
|
+
<div role="alert" className={cn("flex flex-col items-center gap-2 px-3 py-6 text-center", className)}>
|
|
178
|
+
<Icon name="alert" size={16} className="text-error-text" />
|
|
179
|
+
<p className="text-sm text-error-text">{message}</p>
|
|
180
|
+
<Button type="button" variant="outline" size="sm" onClick={onRetry}>
|
|
181
|
+
{retryLabel}
|
|
182
|
+
</Button>
|
|
183
|
+
</div>
|
|
184
|
+
)
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Waiting on something real (an upload, an import, an outside system): a looping
|
|
189
|
+
* moment while `active`, then still on its last frame. The words say what is
|
|
190
|
+
* happening and that the person can keep working; nothing waits for the picture.
|
|
191
|
+
*/
|
|
192
|
+
function WaitingState({
|
|
193
|
+
moment = "updating",
|
|
194
|
+
active = true,
|
|
195
|
+
title,
|
|
196
|
+
description,
|
|
197
|
+
action,
|
|
198
|
+
className,
|
|
199
|
+
}: {
|
|
200
|
+
/** `uploading`, `waiting-reply`, `updating` (loops) or `offline` (plays once, then still). */
|
|
201
|
+
moment?: MomentName
|
|
202
|
+
/** False once the waiting is over. */
|
|
203
|
+
active?: boolean
|
|
204
|
+
title: string
|
|
205
|
+
description?: React.ReactNode
|
|
206
|
+
action?: React.ReactNode
|
|
207
|
+
className?: string
|
|
208
|
+
}) {
|
|
209
|
+
return (
|
|
210
|
+
<div role="status" aria-busy={active} className={cn("flex flex-col items-center gap-2 px-6 py-8 text-center", className)}>
|
|
211
|
+
<Lottie
|
|
212
|
+
name={moment}
|
|
213
|
+
play={moment === "offline" ? "view" : "loop"}
|
|
214
|
+
active={active}
|
|
215
|
+
className="size-[120px]"
|
|
216
|
+
fallback={<Icon name={moment === "offline" ? "alert" : "clock"} size={24} className="text-muted-foreground" />}
|
|
217
|
+
/>
|
|
218
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
219
|
+
{description && <div className="max-w-prose text-sm text-muted-foreground">{description}</div>}
|
|
220
|
+
{action && <div className="mt-1">{action}</div>}
|
|
221
|
+
</div>
|
|
222
|
+
)
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/** Read-only: names the permission and who grants it. Fields disabled, actions hidden. */
|
|
226
|
+
function ReadOnlyNotice({
|
|
227
|
+
title,
|
|
228
|
+
description,
|
|
229
|
+
className,
|
|
230
|
+
}: {
|
|
231
|
+
title: string
|
|
232
|
+
description?: string
|
|
233
|
+
className?: string
|
|
234
|
+
}) {
|
|
235
|
+
return (
|
|
236
|
+
<Alert className={cn("border-transparent bg-muted", className)}>
|
|
237
|
+
<Icon name="info" size={16} />
|
|
238
|
+
<AlertTitle>{title}</AlertTitle>
|
|
239
|
+
{description && <AlertDescription className="text-sm text-foreground opacity-100">{description}</AlertDescription>}
|
|
240
|
+
</Alert>
|
|
241
|
+
)
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Access denied, in place of the page content with the shell still there: what's
|
|
246
|
+
* behind it, the permission in plain words, who can give it, and Ask for access.
|
|
247
|
+
*/
|
|
248
|
+
function AccessDeniedPanel({
|
|
249
|
+
title,
|
|
250
|
+
description,
|
|
251
|
+
askLabel,
|
|
252
|
+
onAsk,
|
|
253
|
+
className,
|
|
254
|
+
}: {
|
|
255
|
+
title: string
|
|
256
|
+
description: string
|
|
257
|
+
askLabel?: string
|
|
258
|
+
onAsk?: () => void
|
|
259
|
+
className?: string
|
|
260
|
+
}) {
|
|
261
|
+
return (
|
|
262
|
+
<div className={cn("flex flex-col items-center gap-2 px-6 py-10 text-center", className)}>
|
|
263
|
+
<span className="grid size-11 place-items-center rounded-card bg-muted text-foreground">
|
|
264
|
+
<Icon name="lock" size={20} />
|
|
265
|
+
</span>
|
|
266
|
+
<p className="mt-1 text-base font-semibold text-foreground">{title}</p>
|
|
267
|
+
<p className="max-w-prose text-sm text-muted-foreground">{description}</p>
|
|
268
|
+
{askLabel && onAsk && (
|
|
269
|
+
<Button type="button" variant="outline" onClick={onAsk} className="mt-1">
|
|
270
|
+
{askLabel}
|
|
271
|
+
</Button>
|
|
272
|
+
)}
|
|
273
|
+
</div>
|
|
274
|
+
)
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
export { AccessDeniedPanel, AreaError, EmptyFiltered, EmptyFirstTime, LoadingRows, ReadOnlyNotice, WaitingState }
|