@whity/ui 0.0.0-stage → 0.5.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 -3
- package/package.json +192 -6
- package/src/access-denied.stories.tsx +179 -0
- package/src/access-denied.tsx +305 -0
- package/src/action-proposal.tsx +302 -0
- package/src/actor-chip.tsx +71 -0
- package/src/agent-activity.tsx +163 -0
- package/src/agent-collaboration.stories.tsx +156 -0
- package/src/agent-run-status.tsx +196 -0
- package/src/alert-dialog.stories.tsx +45 -0
- package/src/alert-dialog.tsx +147 -0
- package/src/alert.stories.tsx +91 -0
- package/src/alert.tsx +89 -0
- package/src/app-sidebar.stories.tsx +195 -0
- package/src/app-sidebar.tsx +500 -0
- package/src/approval-queue.tsx +108 -0
- package/src/audience-group-picker.stories.tsx +198 -0
- package/src/audience-group-picker.tsx +362 -0
- package/src/audience-people-picker.stories.tsx +102 -0
- package/src/audience-people-picker.tsx +279 -0
- package/src/avatar.tsx +83 -0
- package/src/badge.stories.tsx +105 -0
- package/src/badge.tsx +68 -0
- package/src/beta-warning.stories.tsx +79 -0
- package/src/beta-warning.tsx +189 -0
- package/src/bilingual-input.stories.tsx +82 -0
- package/src/bilingual-input.tsx +183 -0
- package/src/breadcrumb.stories.tsx +51 -0
- package/src/breadcrumb.tsx +90 -0
- package/src/button.stories.tsx +87 -0
- package/src/button.tsx +118 -0
- package/src/card.stories.tsx +423 -0
- package/src/card.tsx +180 -0
- package/src/chart.stories.tsx +66 -0
- package/src/chart.tsx +228 -0
- package/src/checkbox.stories.tsx +62 -0
- package/src/checkbox.tsx +54 -0
- package/src/collapsible.stories.tsx +48 -0
- package/src/collapsible.tsx +34 -0
- package/src/color-card.stories.tsx +61 -0
- package/src/color-card.tsx +270 -0
- package/src/color-picker.stories.tsx +65 -0
- package/src/color-picker.tsx +425 -0
- package/src/command-palette.tsx +306 -0
- package/src/copy-block.stories.tsx +38 -0
- package/src/copy-block.tsx +85 -0
- package/src/data-table.stories.tsx +200 -0
- package/src/data-table.tsx +1106 -0
- package/src/date-picker.stories.tsx +61 -0
- package/src/date-picker.tsx +422 -0
- package/src/design-cards.stories.tsx +458 -0
- package/src/dialog.stories.tsx +48 -0
- package/src/dialog.tsx +166 -0
- package/src/documents/barcode-svg.stories.tsx +72 -0
- package/src/documents/barcode-svg.tsx +79 -0
- package/src/dropdown-menu.stories.tsx +77 -0
- package/src/dropdown-menu.tsx +271 -0
- package/src/editor/behaviour.ts +279 -0
- package/src/editor/block-ids.ts +44 -0
- package/src/editor/block-list.tsx +101 -0
- package/src/editor/block-toolbar.tsx +477 -0
- package/src/editor/bubble.tsx +93 -0
- package/src/editor/catalogue.ts +103 -0
- package/src/editor/collab-rail.tsx +746 -0
- package/src/editor/collab.stories.tsx +207 -0
- package/src/editor/collab.ts +87 -0
- package/src/editor/contract.ts +408 -0
- package/src/editor/convert.ts +362 -0
- package/src/editor/doc-editor.stories.tsx +98 -0
- package/src/editor/doc-editor.tsx +1287 -0
- package/src/editor/editor.css +536 -0
- package/src/editor/extensions.ts +86 -0
- package/src/editor/field-picker.tsx +107 -0
- package/src/editor/fields.ts +100 -0
- package/src/editor/gutter.tsx +367 -0
- package/src/editor/index.ts +22 -0
- package/src/editor/label-sheet.tsx +289 -0
- package/src/editor/labels.ts +310 -0
- package/src/editor/link-tools.tsx +141 -0
- package/src/editor/node-views.tsx +450 -0
- package/src/editor/page-view.tsx +353 -0
- package/src/editor/publish-check.tsx +182 -0
- package/src/editor/rich-blocks.stories.tsx +146 -0
- package/src/editor/sample.ts +40 -0
- package/src/editor/schema-rich.ts +150 -0
- package/src/editor/schema.ts +315 -0
- package/src/editor/services.tsx +127 -0
- package/src/editor/slash.ts +64 -0
- package/src/editor/suggesting.ts +372 -0
- package/src/editor/suggestions.ts +763 -0
- package/src/editor/table-keys.ts +66 -0
- package/src/editor/templates.stories.tsx +324 -0
- package/src/editor/toolbar.tsx +358 -0
- package/src/empty-state.stories.tsx +51 -0
- package/src/empty-state.tsx +100 -0
- package/src/empty-state.usage-notes.md +30 -0
- package/src/form.stories.tsx +112 -0
- package/src/form.tsx +176 -0
- package/src/globals.css +20 -0
- package/src/icon-button.tsx +85 -0
- package/src/icon-map.ts +244 -0
- package/src/icon.tsx +41 -0
- package/src/index.ts +67 -0
- package/src/input.stories.tsx +157 -0
- package/src/input.tsx +759 -0
- package/src/locked-screen.stories.tsx +29 -0
- package/src/locked-screen.tsx +61 -0
- package/src/mark.tsx +62 -0
- package/src/math-text.stories.tsx +33 -0
- package/src/math-text.tsx +43 -0
- package/src/menu-bar.stories.tsx +198 -0
- package/src/menu-bar.tsx +373 -0
- package/src/money/currency.ts +230 -0
- package/src/page-header.stories.tsx +95 -0
- package/src/page-header.tsx +122 -0
- package/src/page-shell.stories.tsx +42 -0
- package/src/page-shell.tsx +32 -0
- package/src/pagination.stories.tsx +45 -0
- package/src/pagination.tsx +98 -0
- package/src/plugin-card.stories.tsx +180 -0
- package/src/plugin-card.tsx +848 -0
- package/src/popover.stories.tsx +48 -0
- package/src/popover.tsx +55 -0
- package/src/radio-group.stories.tsx +26 -0
- package/src/radio-group.tsx +44 -0
- package/src/route-flow/editor.tsx +1014 -0
- package/src/route-flow/model.ts +716 -0
- package/src/scope-grant.tsx +139 -0
- package/src/screen-too-small.stories.tsx +61 -0
- package/src/screen-too-small.tsx +104 -0
- package/src/select.stories.tsx +44 -0
- package/src/select.tsx +197 -0
- package/src/separator.stories.tsx +34 -0
- package/src/separator.tsx +34 -0
- package/src/sheet.stories.tsx +49 -0
- package/src/sheet.tsx +168 -0
- package/src/skeleton.stories.tsx +28 -0
- package/src/skeleton.tsx +19 -0
- package/src/slider.stories.tsx +78 -0
- package/src/slider.tsx +300 -0
- package/src/spinner.stories.tsx +33 -0
- package/src/spinner.tsx +55 -0
- package/src/switch.stories.tsx +42 -0
- package/src/switch.tsx +41 -0
- package/src/switcher.stories.tsx +111 -0
- package/src/switcher.tsx +131 -0
- package/src/table.stories.tsx +48 -0
- package/src/table.tsx +121 -0
- package/src/tabs.stories.tsx +74 -0
- package/src/tabs.tsx +90 -0
- package/src/tag-input.stories.tsx +67 -0
- package/src/tag-input.tsx +117 -0
- package/src/tenant-logo.tsx +63 -0
- package/src/tenant-switcher.stories.tsx +38 -0
- package/src/tenant-switcher.tsx +164 -0
- package/src/textarea.stories.tsx +27 -0
- package/src/textarea.tsx +18 -0
- package/src/theme-mode.ts +52 -0
- package/src/time-picker.stories.tsx +62 -0
- package/src/time-picker.tsx +615 -0
- package/src/toggle-group.tsx +138 -0
- package/src/tooltip.stories.tsx +43 -0
- package/src/tooltip.tsx +73 -0
- package/src/top-nav.stories.tsx +58 -0
- package/src/top-nav.tsx +324 -0
- package/src/undo-bar.tsx +107 -0
- package/src/utils.ts +45 -0
- package/src/view-toggle.stories.tsx +84 -0
- package/src/view-toggle.tsx +110 -0
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
"use client"
|
|
2
|
+
|
|
3
|
+
import * as React from "react"
|
|
4
|
+
|
|
5
|
+
import { Icon, type IconName } from "./icon"
|
|
6
|
+
import { cn } from "./utils"
|
|
7
|
+
|
|
8
|
+
export interface ToggleOption {
|
|
9
|
+
value: string
|
|
10
|
+
label: string
|
|
11
|
+
icon?: IconName
|
|
12
|
+
/** Show the icon alone; the label becomes the accessible name and the tooltip. */
|
|
13
|
+
iconOnly?: boolean
|
|
14
|
+
shortcut?: string
|
|
15
|
+
disabled?: boolean
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
type ToggleValue = string | string[] | null
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Buttons that stay pressed: a view switch (`single`) or filters (`multiple`).
|
|
22
|
+
* A pressed toggle is the tint with text in the main colour, never a solid
|
|
23
|
+
* fill (decision 7.3). Every button reports `aria-pressed`; arrow keys move
|
|
24
|
+
* between them. The reference is docs/design/components/ToggleGroup
|
|
25
|
+
* (`.wy-toggles`, `.wy-toggle`).
|
|
26
|
+
*/
|
|
27
|
+
function ToggleGroup({
|
|
28
|
+
options,
|
|
29
|
+
type = "single",
|
|
30
|
+
defaultValue = null,
|
|
31
|
+
value,
|
|
32
|
+
required = false,
|
|
33
|
+
size = "default",
|
|
34
|
+
label,
|
|
35
|
+
onChange,
|
|
36
|
+
className,
|
|
37
|
+
}: {
|
|
38
|
+
options: ToggleOption[]
|
|
39
|
+
type?: "single" | "multiple"
|
|
40
|
+
defaultValue?: ToggleValue
|
|
41
|
+
value?: ToggleValue
|
|
42
|
+
/** A single group can't be emptied by pressing its pressed toggle again. */
|
|
43
|
+
required?: boolean
|
|
44
|
+
/** `sm` is 28px overall, for toolbars. */
|
|
45
|
+
size?: "sm" | "default"
|
|
46
|
+
/** The group's accessible name. */
|
|
47
|
+
label?: string
|
|
48
|
+
onChange?: (value: ToggleValue) => void
|
|
49
|
+
className?: string
|
|
50
|
+
}) {
|
|
51
|
+
const [inner, setInner] = React.useState<ToggleValue>(defaultValue)
|
|
52
|
+
const current = value !== undefined ? value : inner
|
|
53
|
+
const pressed = (v: string) => (Array.isArray(current) ? current.includes(v) : current === v)
|
|
54
|
+
const buttons = React.useRef<(HTMLButtonElement | null)[]>([])
|
|
55
|
+
|
|
56
|
+
const toggle = (v: string) => {
|
|
57
|
+
let next: ToggleValue
|
|
58
|
+
if (type === "multiple") {
|
|
59
|
+
const list = Array.isArray(current) ? current : []
|
|
60
|
+
next = list.includes(v) ? list.filter((x) => x !== v) : [...list, v]
|
|
61
|
+
} else {
|
|
62
|
+
next = current === v ? (required ? v : null) : v
|
|
63
|
+
}
|
|
64
|
+
if (value === undefined) setInner(next)
|
|
65
|
+
onChange?.(next)
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
const move = (from: number, step: number) => {
|
|
69
|
+
const enabled = options.map((o, i) => (o.disabled ? -1 : i)).filter((i) => i >= 0)
|
|
70
|
+
const at = enabled.indexOf(from)
|
|
71
|
+
const to = enabled[(at + step + enabled.length) % enabled.length]
|
|
72
|
+
buttons.current[to]?.focus()
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
return (
|
|
76
|
+
<div
|
|
77
|
+
role="group"
|
|
78
|
+
aria-label={label}
|
|
79
|
+
data-slot="toggle-group"
|
|
80
|
+
className={cn(
|
|
81
|
+
"inline-flex w-fit gap-0.5 border border-border bg-card p-0.5",
|
|
82
|
+
size === "sm" ? "rounded-control-sm" : "rounded-control",
|
|
83
|
+
className
|
|
84
|
+
)}
|
|
85
|
+
>
|
|
86
|
+
{options.map((option, i) => {
|
|
87
|
+
const on = pressed(option.value)
|
|
88
|
+
const iconOnly = option.iconOnly && option.icon
|
|
89
|
+
return (
|
|
90
|
+
<span key={option.value} className="group/tip relative inline-flex">
|
|
91
|
+
<button
|
|
92
|
+
ref={(el) => {
|
|
93
|
+
buttons.current[i] = el
|
|
94
|
+
}}
|
|
95
|
+
type="button"
|
|
96
|
+
aria-pressed={on}
|
|
97
|
+
aria-label={iconOnly ? option.label : undefined}
|
|
98
|
+
disabled={option.disabled}
|
|
99
|
+
onClick={() => toggle(option.value)}
|
|
100
|
+
onKeyDown={(e) => {
|
|
101
|
+
const forward = e.key === "ArrowRight" || e.key === "ArrowDown"
|
|
102
|
+
const back = e.key === "ArrowLeft" || e.key === "ArrowUp"
|
|
103
|
+
if (!forward && !back) return
|
|
104
|
+
e.preventDefault()
|
|
105
|
+
const rtl = getComputedStyle(e.currentTarget).direction === "rtl"
|
|
106
|
+
const horizontal = e.key === "ArrowRight" || e.key === "ArrowLeft"
|
|
107
|
+
move(i, (forward ? 1 : -1) * (rtl && horizontal ? -1 : 1))
|
|
108
|
+
}}
|
|
109
|
+
data-state={on ? "on" : "off"}
|
|
110
|
+
className={cn(
|
|
111
|
+
"inline-flex items-center justify-center gap-1.5 border-0 bg-transparent font-medium text-muted-foreground outline-none select-none",
|
|
112
|
+
"hover:bg-muted hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring disabled:pointer-events-none disabled:opacity-45",
|
|
113
|
+
"data-[state=on]:bg-primary-tint data-[state=on]:text-primary-tint-foreground",
|
|
114
|
+
size === "sm"
|
|
115
|
+
? cn("h-[22px] rounded-[5px] text-[0.8125rem]", iconOnly ? "w-[22px]" : "px-2")
|
|
116
|
+
: cn("h-[30px] rounded-control-sm text-sm", iconOnly ? "w-[30px]" : "px-2.5")
|
|
117
|
+
)}
|
|
118
|
+
>
|
|
119
|
+
{option.icon && <Icon name={option.icon} />}
|
|
120
|
+
{!iconOnly && option.label}
|
|
121
|
+
</button>
|
|
122
|
+
{iconOnly && (
|
|
123
|
+
<span
|
|
124
|
+
aria-hidden="true"
|
|
125
|
+
className="pointer-events-none absolute start-1/2 bottom-[calc(100%+6px)] z-40 inline-flex -translate-x-1/2 items-center gap-1.5 rounded-md bg-foreground px-2 py-[5px] text-xs leading-tight font-medium whitespace-nowrap text-background opacity-0 transition-opacity duration-(--dur-fast) ease-out-whity group-hover/tip:opacity-100 group-hover/tip:delay-500 group-focus-within/tip:opacity-100 group-focus-within/tip:delay-0 rtl:translate-x-1/2"
|
|
126
|
+
>
|
|
127
|
+
{option.label}
|
|
128
|
+
{option.shortcut && <kbd className="font-mono text-2xs opacity-75">{option.shortcut}</kbd>}
|
|
129
|
+
</span>
|
|
130
|
+
)}
|
|
131
|
+
</span>
|
|
132
|
+
)
|
|
133
|
+
})}
|
|
134
|
+
</div>
|
|
135
|
+
)
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
export { ToggleGroup }
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
|
|
3
|
+
import { Tooltip, TooltipTrigger, TooltipContent } from "./tooltip"
|
|
4
|
+
import { Button } from "./button"
|
|
5
|
+
|
|
6
|
+
const meta = {
|
|
7
|
+
title: "Primitives/Tooltip",
|
|
8
|
+
component: Tooltip,
|
|
9
|
+
tags: ["autodocs"],
|
|
10
|
+
} satisfies Meta<typeof Tooltip>
|
|
11
|
+
|
|
12
|
+
export default meta
|
|
13
|
+
type Story = StoryObj<typeof meta>
|
|
14
|
+
|
|
15
|
+
export const Default: Story = {
|
|
16
|
+
render: () => (
|
|
17
|
+
<Tooltip>
|
|
18
|
+
<TooltipTrigger asChild>
|
|
19
|
+
<Button variant="outline" size="sm">
|
|
20
|
+
Hover or focus me
|
|
21
|
+
</Button>
|
|
22
|
+
</TooltipTrigger>
|
|
23
|
+
<TooltipContent>Add to library</TooltipContent>
|
|
24
|
+
</Tooltip>
|
|
25
|
+
),
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export const Sides: Story = {
|
|
29
|
+
render: () => (
|
|
30
|
+
<div className="flex gap-4">
|
|
31
|
+
{(["top", "right", "bottom", "left"] as const).map((side) => (
|
|
32
|
+
<Tooltip key={side}>
|
|
33
|
+
<TooltipTrigger asChild>
|
|
34
|
+
<Button variant="outline" size="sm">
|
|
35
|
+
{side}
|
|
36
|
+
</Button>
|
|
37
|
+
</TooltipTrigger>
|
|
38
|
+
<TooltipContent side={side}>Tooltip on the {side}</TooltipContent>
|
|
39
|
+
</Tooltip>
|
|
40
|
+
))}
|
|
41
|
+
</div>
|
|
42
|
+
),
|
|
43
|
+
}
|
package/src/tooltip.tsx
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
"use client"
|
|
2
|
+
|
|
3
|
+
import * as React from "react"
|
|
4
|
+
import { Tooltip as TooltipPrimitive } from "radix-ui"
|
|
5
|
+
|
|
6
|
+
import { cn } from "./utils"
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Compound Tooltip (Provider/Root/Trigger/Content), matching the same Radix-
|
|
10
|
+
* wrapping convention as Dialog/DropdownMenu/Select in this package —
|
|
11
|
+
* PLATFORM NOTE: this compound shape (Provider+Root+Trigger+Content) is a
|
|
12
|
+
* WEB/Radix idiom. A future Flutter/Dart port has no equivalent multi-part
|
|
13
|
+
* API — it would flatten this to a single `Tooltip(message, child)` widget.
|
|
14
|
+
* What DOES carry over is the semantic content: `side` (top/right/bottom/
|
|
15
|
+
* left) and the delay duration are plain, portable concepts a Flutter
|
|
16
|
+
* tooltip can express with its own props of the same meaning.
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
function TooltipProvider({
|
|
20
|
+
// Tooltips appear after 500 ms on hover and at once on keyboard focus (stage 8).
|
|
21
|
+
delayDuration = 500,
|
|
22
|
+
...props
|
|
23
|
+
}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
|
|
24
|
+
return (
|
|
25
|
+
<TooltipPrimitive.Provider
|
|
26
|
+
data-slot="tooltip-provider"
|
|
27
|
+
delayDuration={delayDuration}
|
|
28
|
+
{...props}
|
|
29
|
+
/>
|
|
30
|
+
)
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function Tooltip({
|
|
34
|
+
...props
|
|
35
|
+
}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
|
|
36
|
+
return (
|
|
37
|
+
<TooltipProvider>
|
|
38
|
+
<TooltipPrimitive.Root data-slot="tooltip" {...props} />
|
|
39
|
+
</TooltipProvider>
|
|
40
|
+
)
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function TooltipTrigger({
|
|
44
|
+
...props
|
|
45
|
+
}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
|
|
46
|
+
return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function TooltipContent({
|
|
50
|
+
className,
|
|
51
|
+
sideOffset = 6,
|
|
52
|
+
children,
|
|
53
|
+
...props
|
|
54
|
+
}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
|
|
55
|
+
return (
|
|
56
|
+
<TooltipPrimitive.Portal>
|
|
57
|
+
<TooltipPrimitive.Content
|
|
58
|
+
data-slot="tooltip-content"
|
|
59
|
+
sideOffset={sideOffset}
|
|
60
|
+
className={cn(
|
|
61
|
+
// The reference is docs/design/components/Tooltip (`.wy-tip__bubble`): ink on the page colour.
|
|
62
|
+
"z-50 inline-flex max-w-64 items-center gap-1.5 rounded-md bg-foreground px-2 py-[5px] text-xs leading-tight font-medium text-balance text-background data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0 motion-reduce:animate-none [&_kbd]:font-mono [&_kbd]:text-2xs [&_kbd]:opacity-75",
|
|
63
|
+
className
|
|
64
|
+
)}
|
|
65
|
+
{...props}
|
|
66
|
+
>
|
|
67
|
+
{children}
|
|
68
|
+
</TooltipPrimitive.Content>
|
|
69
|
+
</TooltipPrimitive.Portal>
|
|
70
|
+
)
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from "@storybook/react-vite"
|
|
2
|
+
|
|
3
|
+
import { TopNav } from "./top-nav"
|
|
4
|
+
import { Breadcrumb } from "./breadcrumb"
|
|
5
|
+
|
|
6
|
+
const meta = {
|
|
7
|
+
title: "Layout/TopNav",
|
|
8
|
+
component: TopNav,
|
|
9
|
+
tags: ["autodocs"],
|
|
10
|
+
} satisfies Meta<typeof TopNav>
|
|
11
|
+
|
|
12
|
+
export default meta
|
|
13
|
+
type Story = StoryObj<typeof meta>
|
|
14
|
+
|
|
15
|
+
export const Default: Story = {
|
|
16
|
+
args: {
|
|
17
|
+
leftContent: <Breadcrumb items={[{ label: "Dashboard", href: "#" }, { label: "Overview" }]} />,
|
|
18
|
+
user: {
|
|
19
|
+
name: "Amro K. Saleh",
|
|
20
|
+
email: "amro@example.com",
|
|
21
|
+
initials: "AS",
|
|
22
|
+
},
|
|
23
|
+
notificationCount: 3,
|
|
24
|
+
language: "en",
|
|
25
|
+
theme: "light",
|
|
26
|
+
onSearchClick: () => alert("Opened Command Palette (⌘K)"),
|
|
27
|
+
onNotificationClick: () => alert("Opened Notifications Drawer"),
|
|
28
|
+
onLanguageToggle: () => alert("Toggled Language"),
|
|
29
|
+
onThemeToggle: () => alert("Toggled Theme Mode"),
|
|
30
|
+
onProfileClick: () => alert("Opened Profile"),
|
|
31
|
+
onSettingsClick: () => alert("Opened Settings"),
|
|
32
|
+
onLogoutClick: () => alert("Signed Out"),
|
|
33
|
+
},
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export const SimpleWithTitle: Story = {
|
|
37
|
+
args: {
|
|
38
|
+
leftContent: <h2 className="text-sm font-semibold tracking-tight text-foreground">Analytics Overview</h2>,
|
|
39
|
+
user: {
|
|
40
|
+
name: "Jane Doe",
|
|
41
|
+
email: "jane@example.com",
|
|
42
|
+
initials: "JD",
|
|
43
|
+
},
|
|
44
|
+
notificationCount: 0,
|
|
45
|
+
},
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export const MobileView: Story = {
|
|
49
|
+
args: {
|
|
50
|
+
leftContent: <span className="text-xs font-semibold">Whity Dashboard</span>,
|
|
51
|
+
onMobileMenuToggle: () => alert("Toggled Mobile Sidebar"),
|
|
52
|
+
user: {
|
|
53
|
+
name: "Amro K. Saleh",
|
|
54
|
+
email: "amro@example.com",
|
|
55
|
+
},
|
|
56
|
+
notificationCount: 5,
|
|
57
|
+
},
|
|
58
|
+
}
|
package/src/top-nav.tsx
ADDED
|
@@ -0,0 +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
|
+
}
|