@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
package/src/top-nav.tsx CHANGED
@@ -1,324 +1,324 @@
1
- "use client"
2
-
3
- import * as React from "react"
4
- import {
5
- IconBell,
6
- IconCommand,
7
- IconLanguage,
8
- IconLogout,
9
- IconMenu2,
10
- IconMoon,
11
- IconSearch,
12
- IconSettings,
13
- IconSun,
14
- IconUser,
15
- } from "@tabler/icons-react"
16
-
17
- import { cn } from "./utils"
18
- import {
19
- DropdownMenu,
20
- DropdownMenuContent,
21
- DropdownMenuGroup,
22
- DropdownMenuItem,
23
- DropdownMenuLabel,
24
- DropdownMenuSeparator,
25
- DropdownMenuTrigger,
26
- } from "./dropdown-menu"
27
- import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
28
-
29
- export interface TopNavUser {
30
- name: string
31
- email?: string
32
- avatarUrl?: string
33
- initials?: string
34
- }
35
-
36
- export interface TopNavProps {
37
- /**
38
- * Called when the mobile menu toggle button is clicked.
39
- */
40
- onMobileMenuToggle?: () => void
41
- /**
42
- * Slot for left-aligned content (e.g. breadcrumb, logo, or page title snippet).
43
- */
44
- leftContent?: React.ReactNode
45
- /**
46
- * Custom search bar or command palette trigger button. Defaults to a standard Ctrl+K trigger.
47
- */
48
- searchContent?: React.ReactNode
49
- /**
50
- * Placeholder for default command palette search trigger. Defaults to "Search or press ⌘K...".
51
- */
52
- searchPlaceholder?: string
53
- /** Accessible name for the mobile-menu button. */
54
- mobileMenuLabel?: string
55
- /** Accessible name for the notifications button. */
56
- notificationsLabel?: string
57
- /**
58
- * Tooltip on the theme toggle, given the theme it would switch TO.
59
- * A function because the mode name sits inside the phrase.
60
- */
61
- themeToggleLabel?: (next: "light" | "dark") => string
62
- /** Tooltip on the language toggle, given the language it would switch TO. */
63
- languageToggleLabel?: (next: string) => string
64
- /**
65
- * Notification-count summary. A function for the same reason `Pagination`'s
66
- * `entriesLabel` is one: the number is inside the sentence, and plural rules
67
- * differ between languages.
68
- */
69
- notificationSummary?: (count: number) => string
70
- /** Labels of the DEFAULT user-menu items (ignored when `userMenuItems` is given). */
71
- profileLabel?: string
72
- settingsLabel?: string
73
- signOutLabel?: string
74
- /**
75
- * Called when the default search trigger is clicked.
76
- */
77
- onSearchClick?: () => void
78
- /**
79
- * User profile information displayed in the right dropdown menu.
80
- */
81
- user?: TopNavUser
82
- /**
83
- * Called when "Profile" item is selected in user dropdown.
84
- */
85
- onProfileClick?: () => void
86
- /**
87
- * Called when "Settings" item is selected in user dropdown.
88
- */
89
- onSettingsClick?: () => void
90
- /**
91
- * Called when "Sign out" item is selected in user dropdown.
92
- */
93
- onLogoutClick?: () => void
94
- /**
95
- * Custom items slot to override or append to the user dropdown menu.
96
- */
97
- userMenuItems?: React.ReactNode
98
- /**
99
- * Unread notifications badge count. Renders a dot/badge over the notification bell icon.
100
- */
101
- notificationCount?: number
102
- /**
103
- * Called when the notification bell button is clicked.
104
- */
105
- onNotificationClick?: () => void
106
- /**
107
- * Active language code e.g. "en" or "ar".
108
- */
109
- language?: "en" | "ar"
110
- /**
111
- * Called when language toggle is clicked.
112
- */
113
- onLanguageToggle?: () => void
114
- /**
115
- * Active theme mode e.g. "light" or "dark".
116
- */
117
- theme?: "light" | "dark"
118
- /**
119
- * Called when theme mode toggle is clicked.
120
- */
121
- onThemeToggle?: () => void
122
- /**
123
- * Additional custom action controls rendered before user profile.
124
- */
125
- rightContent?: React.ReactNode
126
- className?: string
127
- }
128
-
129
- export function TopNav({
130
- onMobileMenuToggle,
131
- leftContent,
132
- searchContent,
133
- searchPlaceholder = "Search or press ⌘K...",
134
- mobileMenuLabel = "Open mobile navigation",
135
- notificationsLabel = "Notifications",
136
- themeToggleLabel = (next: "light" | "dark") =>
137
- next === "light" ? "Switch to Light mode" : "Switch to Dark mode",
138
- languageToggleLabel = (next: string) => `Switch to ${next}`,
139
- notificationSummary = (count: number) =>
140
- count > 0 ? `${count} new notifications` : "No new notifications",
141
- profileLabel = "Profile",
142
- settingsLabel = "Settings",
143
- signOutLabel = "Sign out",
144
- onSearchClick,
145
- user,
146
- onProfileClick,
147
- onSettingsClick,
148
- onLogoutClick,
149
- userMenuItems,
150
- notificationCount = 0,
151
- onNotificationClick,
152
- language,
153
- onLanguageToggle,
154
- theme,
155
- onThemeToggle,
156
- rightContent,
157
- className,
158
- }: TopNavProps) {
159
- const userInitials = user?.initials ?? (user?.name ? user.name.slice(0, 2).toUpperCase() : "U")
160
-
161
- return (
162
- <header
163
- data-slot="top-nav"
164
- className={cn(
165
- "sticky top-0 z-30 flex h-14 w-full items-center justify-between gap-4 border-b border-border bg-card px-4 shadow-2xs transition-colors",
166
- className
167
- )}
168
- >
169
- {/* Left Section: Mobile Menu Toggle & Left Content / Breadcrumbs */}
170
- <div className="flex items-center gap-3 min-w-0">
171
- {onMobileMenuToggle && (
172
- <button
173
- type="button"
174
- aria-label={mobileMenuLabel}
175
- onClick={onMobileMenuToggle}
176
- className="flex size-8 shrink-0 items-center justify-center rounded-md border border-input text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/30 md:hidden"
177
- >
178
- <IconMenu2 className="size-4" />
179
- </button>
180
- )}
181
- {leftContent && <div className="min-w-0 truncate">{leftContent}</div>}
182
- </div>
183
-
184
- {/* Center Section: Command Palette / Search Trigger */}
185
- <div className="flex-1 max-w-md hidden sm:block">
186
- {searchContent ?? (
187
- <button
188
- type="button"
189
- onClick={onSearchClick}
190
- className="flex h-8 w-full items-center justify-between gap-2 rounded-md border border-input bg-background/60 px-3 text-xs text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30"
191
- >
192
- <div className="flex items-center gap-2 min-w-0 truncate">
193
- <IconSearch className="size-3.5 shrink-0 text-muted-foreground" aria-hidden="true" />
194
- <span className="truncate">{searchPlaceholder}</span>
195
- </div>
196
- <kbd className="pointer-events-none inline-flex h-5 select-none items-center gap-0.5 rounded border border-border/80 bg-muted px-1.5 font-mono text-[0.625rem] font-semibold text-muted-foreground">
197
- <IconCommand className="size-2.5" />K
198
- </kbd>
199
- </button>
200
- )}
201
- </div>
202
-
203
- {/* Right Section: Language, Theme, Notifications & User Dropdown */}
204
- <div className="flex items-center gap-1.5 shrink-0">
205
- {/* Language Switcher */}
206
- {language && onLanguageToggle && (
207
- <TooltipProvider>
208
- <Tooltip>
209
- <TooltipTrigger asChild>
210
- <button
211
- type="button"
212
- onClick={onLanguageToggle}
213
- aria-label={`Switch language, current: ${language.toUpperCase()}`}
214
- className="flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
215
- >
216
- <IconLanguage className="size-4" />
217
- </button>
218
- </TooltipTrigger>
219
- <TooltipContent>{languageToggleLabel(language === "en" ? "Arabic (العربية)" : "English")}</TooltipContent>
220
- </Tooltip>
221
- </TooltipProvider>
222
- )}
223
-
224
- {/* Theme Mode Toggle */}
225
- {theme && onThemeToggle && (
226
- <TooltipProvider>
227
- <Tooltip>
228
- <TooltipTrigger asChild>
229
- <button
230
- type="button"
231
- onClick={onThemeToggle}
232
- aria-label={`Switch theme, current: ${theme}`}
233
- className="flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
234
- >
235
- {theme === "dark" ? <IconSun className="size-4" /> : <IconMoon className="size-4" />}
236
- </button>
237
- </TooltipTrigger>
238
- <TooltipContent>{themeToggleLabel(theme === "dark" ? "light" : "dark")}</TooltipContent>
239
- </Tooltip>
240
- </TooltipProvider>
241
- )}
242
-
243
- {/* Notification Bell */}
244
- {onNotificationClick && (
245
- <TooltipProvider>
246
- <Tooltip>
247
- <TooltipTrigger asChild>
248
- <button
249
- type="button"
250
- onClick={onNotificationClick}
251
- aria-label={notificationsLabel}
252
- className="relative flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
253
- >
254
- <IconBell className="size-4" />
255
- {notificationCount > 0 && (
256
- <span className="absolute top-1.5 end-1.5 flex size-2 rounded-full bg-destructive ring-2 ring-card" />
257
- )}
258
- </button>
259
- </TooltipTrigger>
260
- <TooltipContent>
261
- {notificationSummary(notificationCount)}
262
- </TooltipContent>
263
- </Tooltip>
264
- </TooltipProvider>
265
- )}
266
-
267
- {rightContent}
268
-
269
- {/* User Profile Dropdown */}
270
- {user && (
271
- <DropdownMenu>
272
- <DropdownMenuTrigger asChild>
273
- <button
274
- type="button"
275
- aria-label={`User menu for ${user.name}`}
276
- className="flex items-center gap-2 rounded-full p-0.5 outline-none focus-visible:ring-2 focus-visible:ring-ring/30 transition-transform hover:scale-105"
277
- >
278
- {user.avatarUrl ? (
279
- <img
280
- src={user.avatarUrl}
281
- alt={user.name}
282
- className="size-8 rounded-full border border-border object-cover shadow-2xs"
283
- />
284
- ) : (
285
- <div className="flex size-8 items-center justify-center rounded-full bg-primary/10 text-primary font-semibold text-xs ring-1 ring-border shadow-2xs">
286
- {userInitials}
287
- </div>
288
- )}
289
- </button>
290
- </DropdownMenuTrigger>
291
- <DropdownMenuContent align="end" className="w-56 p-1.5 shadow-lg border border-border bg-popover text-popover-foreground rounded-xl">
292
- <DropdownMenuLabel className="font-normal p-2">
293
- <div className="flex flex-col gap-0.5">
294
- <p className="text-xs font-semibold text-foreground truncate">{user.name}</p>
295
- {user.email && <p className="text-[0.6875rem] text-muted-foreground truncate">{user.email}</p>}
296
- </div>
297
- </DropdownMenuLabel>
298
- <DropdownMenuSeparator />
299
- {userMenuItems ?? (
300
- <>
301
- <DropdownMenuGroup>
302
- <DropdownMenuItem onClick={onProfileClick}>
303
- <IconUser className="me-2 size-3.5 text-muted-foreground" />
304
- <span>{profileLabel}</span>
305
- </DropdownMenuItem>
306
- <DropdownMenuItem onClick={onSettingsClick}>
307
- <IconSettings className="me-2 size-3.5 text-muted-foreground" />
308
- <span>{settingsLabel}</span>
309
- </DropdownMenuItem>
310
- </DropdownMenuGroup>
311
- <DropdownMenuSeparator />
312
- <DropdownMenuItem onClick={onLogoutClick} className="text-destructive focus:text-destructive">
313
- <IconLogout className="me-2 size-3.5" />
314
- <span>{signOutLabel}</span>
315
- </DropdownMenuItem>
316
- </>
317
- )}
318
- </DropdownMenuContent>
319
- </DropdownMenu>
320
- )}
321
- </div>
322
- </header>
323
- )
324
- }
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import {
5
+ IconBell,
6
+ IconCommand,
7
+ IconLanguage,
8
+ IconLogout,
9
+ IconMenu2,
10
+ IconMoon,
11
+ IconSearch,
12
+ IconSettings,
13
+ IconSun,
14
+ IconUser,
15
+ } from "@tabler/icons-react"
16
+
17
+ import { cn } from "./utils"
18
+ import {
19
+ DropdownMenu,
20
+ DropdownMenuContent,
21
+ DropdownMenuGroup,
22
+ DropdownMenuItem,
23
+ DropdownMenuLabel,
24
+ DropdownMenuSeparator,
25
+ DropdownMenuTrigger,
26
+ } from "./dropdown-menu"
27
+ import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
28
+
29
+ export interface TopNavUser {
30
+ name: string
31
+ email?: string
32
+ avatarUrl?: string
33
+ initials?: string
34
+ }
35
+
36
+ export interface TopNavProps {
37
+ /**
38
+ * Called when the mobile menu toggle button is clicked.
39
+ */
40
+ onMobileMenuToggle?: () => void
41
+ /**
42
+ * Slot for left-aligned content (e.g. breadcrumb, logo, or page title snippet).
43
+ */
44
+ leftContent?: React.ReactNode
45
+ /**
46
+ * Custom search bar or command palette trigger button. Defaults to a standard Ctrl+K trigger.
47
+ */
48
+ searchContent?: React.ReactNode
49
+ /**
50
+ * Placeholder for default command palette search trigger. Defaults to "Search or press ⌘K...".
51
+ */
52
+ searchPlaceholder?: string
53
+ /** Accessible name for the mobile-menu button. */
54
+ mobileMenuLabel?: string
55
+ /** Accessible name for the notifications button. */
56
+ notificationsLabel?: string
57
+ /**
58
+ * Tooltip on the theme toggle, given the theme it would switch TO.
59
+ * A function because the mode name sits inside the phrase.
60
+ */
61
+ themeToggleLabel?: (next: "light" | "dark") => string
62
+ /** Tooltip on the language toggle, given the language it would switch TO. */
63
+ languageToggleLabel?: (next: string) => string
64
+ /**
65
+ * Notification-count summary. A function for the same reason `Pagination`'s
66
+ * `entriesLabel` is one: the number is inside the sentence, and plural rules
67
+ * differ between languages.
68
+ */
69
+ notificationSummary?: (count: number) => string
70
+ /** Labels of the DEFAULT user-menu items (ignored when `userMenuItems` is given). */
71
+ profileLabel?: string
72
+ settingsLabel?: string
73
+ signOutLabel?: string
74
+ /**
75
+ * Called when the default search trigger is clicked.
76
+ */
77
+ onSearchClick?: () => void
78
+ /**
79
+ * User profile information displayed in the right dropdown menu.
80
+ */
81
+ user?: TopNavUser
82
+ /**
83
+ * Called when "Profile" item is selected in user dropdown.
84
+ */
85
+ onProfileClick?: () => void
86
+ /**
87
+ * Called when "Settings" item is selected in user dropdown.
88
+ */
89
+ onSettingsClick?: () => void
90
+ /**
91
+ * Called when "Sign out" item is selected in user dropdown.
92
+ */
93
+ onLogoutClick?: () => void
94
+ /**
95
+ * Custom items slot to override or append to the user dropdown menu.
96
+ */
97
+ userMenuItems?: React.ReactNode
98
+ /**
99
+ * Unread notifications badge count. Renders a dot/badge over the notification bell icon.
100
+ */
101
+ notificationCount?: number
102
+ /**
103
+ * Called when the notification bell button is clicked.
104
+ */
105
+ onNotificationClick?: () => void
106
+ /**
107
+ * Active language code e.g. "en" or "ar".
108
+ */
109
+ language?: "en" | "ar"
110
+ /**
111
+ * Called when language toggle is clicked.
112
+ */
113
+ onLanguageToggle?: () => void
114
+ /**
115
+ * Active theme mode e.g. "light" or "dark".
116
+ */
117
+ theme?: "light" | "dark"
118
+ /**
119
+ * Called when theme mode toggle is clicked.
120
+ */
121
+ onThemeToggle?: () => void
122
+ /**
123
+ * Additional custom action controls rendered before user profile.
124
+ */
125
+ rightContent?: React.ReactNode
126
+ className?: string
127
+ }
128
+
129
+ export function TopNav({
130
+ onMobileMenuToggle,
131
+ leftContent,
132
+ searchContent,
133
+ searchPlaceholder = "Search or press ⌘K...",
134
+ mobileMenuLabel = "Open mobile navigation",
135
+ notificationsLabel = "Notifications",
136
+ themeToggleLabel = (next: "light" | "dark") =>
137
+ next === "light" ? "Switch to Light mode" : "Switch to Dark mode",
138
+ languageToggleLabel = (next: string) => `Switch to ${next}`,
139
+ notificationSummary = (count: number) =>
140
+ count > 0 ? `${count} new notifications` : "No new notifications",
141
+ profileLabel = "Profile",
142
+ settingsLabel = "Settings",
143
+ signOutLabel = "Sign out",
144
+ onSearchClick,
145
+ user,
146
+ onProfileClick,
147
+ onSettingsClick,
148
+ onLogoutClick,
149
+ userMenuItems,
150
+ notificationCount = 0,
151
+ onNotificationClick,
152
+ language,
153
+ onLanguageToggle,
154
+ theme,
155
+ onThemeToggle,
156
+ rightContent,
157
+ className,
158
+ }: TopNavProps) {
159
+ const userInitials = user?.initials ?? (user?.name ? user.name.slice(0, 2).toUpperCase() : "U")
160
+
161
+ return (
162
+ <header
163
+ data-slot="top-nav"
164
+ className={cn(
165
+ "sticky top-0 z-30 flex h-14 w-full items-center justify-between gap-4 border-b border-border bg-card px-4 shadow-2xs transition-colors",
166
+ className
167
+ )}
168
+ >
169
+ {/* Left Section: Mobile Menu Toggle & Left Content / Breadcrumbs */}
170
+ <div className="flex items-center gap-3 min-w-0">
171
+ {onMobileMenuToggle && (
172
+ <button
173
+ type="button"
174
+ aria-label={mobileMenuLabel}
175
+ onClick={onMobileMenuToggle}
176
+ className="flex size-8 shrink-0 items-center justify-center rounded-md border border-input text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/30 md:hidden"
177
+ >
178
+ <IconMenu2 className="size-4" />
179
+ </button>
180
+ )}
181
+ {leftContent && <div className="min-w-0 truncate">{leftContent}</div>}
182
+ </div>
183
+
184
+ {/* Center Section: Command Palette / Search Trigger */}
185
+ <div className="flex-1 max-w-md hidden sm:block">
186
+ {searchContent ?? (
187
+ <button
188
+ type="button"
189
+ onClick={onSearchClick}
190
+ className="flex h-10 w-full items-center justify-between gap-2 rounded-md border border-input bg-background/60 px-3 text-xs text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30"
191
+ >
192
+ <div className="flex items-center gap-2 min-w-0 truncate">
193
+ <IconSearch className="size-3.5 shrink-0 text-muted-foreground" aria-hidden="true" />
194
+ <span className="truncate">{searchPlaceholder}</span>
195
+ </div>
196
+ <kbd className="pointer-events-none inline-flex h-5 select-none items-center gap-0.5 rounded border border-border/80 bg-muted px-1.5 font-mono text-xs font-semibold text-muted-foreground">
197
+ <IconCommand className="size-2.5" />K
198
+ </kbd>
199
+ </button>
200
+ )}
201
+ </div>
202
+
203
+ {/* Right Section: Language, Theme, Notifications & User Dropdown */}
204
+ <div className="flex items-center gap-1.5 shrink-0">
205
+ {/* Language Switcher */}
206
+ {language && onLanguageToggle && (
207
+ <TooltipProvider>
208
+ <Tooltip>
209
+ <TooltipTrigger asChild>
210
+ <button
211
+ type="button"
212
+ onClick={onLanguageToggle}
213
+ aria-label={`Switch language, current: ${language.toUpperCase()}`}
214
+ className="flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
215
+ >
216
+ <IconLanguage className="size-4" />
217
+ </button>
218
+ </TooltipTrigger>
219
+ <TooltipContent>{languageToggleLabel(language === "en" ? "Arabic (العربية)" : "English")}</TooltipContent>
220
+ </Tooltip>
221
+ </TooltipProvider>
222
+ )}
223
+
224
+ {/* Theme Mode Toggle */}
225
+ {theme && onThemeToggle && (
226
+ <TooltipProvider>
227
+ <Tooltip>
228
+ <TooltipTrigger asChild>
229
+ <button
230
+ type="button"
231
+ onClick={onThemeToggle}
232
+ aria-label={`Switch theme, current: ${theme}`}
233
+ className="flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
234
+ >
235
+ {theme === "dark" ? <IconSun className="size-4" /> : <IconMoon className="size-4" />}
236
+ </button>
237
+ </TooltipTrigger>
238
+ <TooltipContent>{themeToggleLabel(theme === "dark" ? "light" : "dark")}</TooltipContent>
239
+ </Tooltip>
240
+ </TooltipProvider>
241
+ )}
242
+
243
+ {/* Notification Bell */}
244
+ {onNotificationClick && (
245
+ <TooltipProvider>
246
+ <Tooltip>
247
+ <TooltipTrigger asChild>
248
+ <button
249
+ type="button"
250
+ onClick={onNotificationClick}
251
+ aria-label={notificationsLabel}
252
+ className="relative flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
253
+ >
254
+ <IconBell className="size-4" />
255
+ {notificationCount > 0 && (
256
+ <span className="absolute top-1.5 end-1.5 flex size-2 rounded-full bg-destructive ring-2 ring-card" />
257
+ )}
258
+ </button>
259
+ </TooltipTrigger>
260
+ <TooltipContent>
261
+ {notificationSummary(notificationCount)}
262
+ </TooltipContent>
263
+ </Tooltip>
264
+ </TooltipProvider>
265
+ )}
266
+
267
+ {rightContent}
268
+
269
+ {/* User Profile Dropdown */}
270
+ {user && (
271
+ <DropdownMenu>
272
+ <DropdownMenuTrigger asChild>
273
+ <button
274
+ type="button"
275
+ aria-label={`User menu for ${user.name}`}
276
+ className="flex items-center gap-2 rounded-full p-0.5 outline-none focus-visible:ring-2 focus-visible:ring-ring/30 transition-transform hover:scale-105"
277
+ >
278
+ {user.avatarUrl ? (
279
+ <img
280
+ src={user.avatarUrl}
281
+ alt={user.name}
282
+ className="size-8 rounded-full border border-border object-cover shadow-2xs"
283
+ />
284
+ ) : (
285
+ <div className="flex size-8 items-center justify-center rounded-full bg-primary/10 text-primary font-semibold text-xs ring-1 ring-border shadow-2xs">
286
+ {userInitials}
287
+ </div>
288
+ )}
289
+ </button>
290
+ </DropdownMenuTrigger>
291
+ <DropdownMenuContent align="end" className="w-56 p-1.5 shadow-lg border border-border bg-popover text-popover-foreground rounded-xl">
292
+ <DropdownMenuLabel className="font-normal p-2">
293
+ <div className="flex flex-col gap-0.5">
294
+ <p className="text-xs font-semibold text-foreground truncate">{user.name}</p>
295
+ {user.email && <p className="text-xs text-muted-foreground truncate">{user.email}</p>}
296
+ </div>
297
+ </DropdownMenuLabel>
298
+ <DropdownMenuSeparator />
299
+ {userMenuItems ?? (
300
+ <>
301
+ <DropdownMenuGroup>
302
+ <DropdownMenuItem onClick={onProfileClick}>
303
+ <IconUser className="me-2 size-3.5 text-muted-foreground" />
304
+ <span>{profileLabel}</span>
305
+ </DropdownMenuItem>
306
+ <DropdownMenuItem onClick={onSettingsClick}>
307
+ <IconSettings className="me-2 size-3.5 text-muted-foreground" />
308
+ <span>{settingsLabel}</span>
309
+ </DropdownMenuItem>
310
+ </DropdownMenuGroup>
311
+ <DropdownMenuSeparator />
312
+ <DropdownMenuItem onClick={onLogoutClick} className="text-destructive focus:text-destructive">
313
+ <IconLogout className="me-2 size-3.5" />
314
+ <span>{signOutLabel}</span>
315
+ </DropdownMenuItem>
316
+ </>
317
+ )}
318
+ </DropdownMenuContent>
319
+ </DropdownMenu>
320
+ )}
321
+ </div>
322
+ </header>
323
+ )
324
+ }