@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,138 +1,139 @@
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 }
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
+ : // TH.18: a selected chip goes from pill to rounded when the theme morphs.
117
+ cn("h-[30px] rounded-control-sm text-sm transition-[border-radius] duration-(--dur-morph) data-[state=on]:rounded-control-selected", iconOnly ? "w-[30px]" : "px-2.5")
118
+ )}
119
+ >
120
+ {option.icon && <Icon name={option.icon} />}
121
+ {!iconOnly && option.label}
122
+ </button>
123
+ {iconOnly && (
124
+ <span
125
+ aria-hidden="true"
126
+ 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"
127
+ >
128
+ {option.label}
129
+ {option.shortcut && <kbd className="font-mono text-2xs opacity-75">{option.shortcut}</kbd>}
130
+ </span>
131
+ )}
132
+ </span>
133
+ )
134
+ })}
135
+ </div>
136
+ )
137
+ }
138
+
139
+ export { ToggleGroup }
@@ -1,43 +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
- }
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 CHANGED
@@ -1,73 +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 }
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 }
@@ -1,58 +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
- }
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
+ }