@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,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 shrink-0 self-start 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 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 shrink-0 self-start md:self-center">{action}</div>}
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
+ }
@@ -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 }