@whity/ui 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/README.md +106 -2
  2. package/package.json +219 -4
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +338 -0
  6. package/src/actor-chip.tsx +71 -0
  7. package/src/agent-activity.tsx +163 -0
  8. package/src/agent-collaboration.stories.tsx +156 -0
  9. package/src/agent-run-status.tsx +196 -0
  10. package/src/alert-dialog.stories.tsx +45 -0
  11. package/src/alert-dialog.tsx +147 -0
  12. package/src/alert.stories.tsx +91 -0
  13. package/src/alert.tsx +89 -0
  14. package/src/app-sidebar.stories.tsx +195 -0
  15. package/src/app-sidebar.tsx +604 -0
  16. package/src/approval-queue.tsx +109 -0
  17. package/src/audience-group-picker.stories.tsx +198 -0
  18. package/src/audience-group-picker.tsx +362 -0
  19. package/src/audience-people-picker.stories.tsx +102 -0
  20. package/src/audience-people-picker.tsx +279 -0
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -0
  23. package/src/badge.stories.tsx +105 -0
  24. package/src/badge.tsx +68 -0
  25. package/src/beta-warning.stories.tsx +79 -0
  26. package/src/beta-warning.tsx +189 -0
  27. package/src/bilingual-input.stories.tsx +82 -0
  28. package/src/bilingual-input.tsx +188 -0
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -0
  31. package/src/breadcrumb.tsx +90 -0
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -0
  34. package/src/button.tsx +123 -0
  35. package/src/card.stories.tsx +423 -0
  36. package/src/card.tsx +180 -0
  37. package/src/chart.stories.tsx +66 -0
  38. package/src/chart.tsx +228 -0
  39. package/src/checkbox.stories.tsx +62 -0
  40. package/src/checkbox.tsx +54 -0
  41. package/src/collapsible.stories.tsx +48 -0
  42. package/src/collapsible.tsx +34 -0
  43. package/src/color-card.stories.tsx +61 -0
  44. package/src/color-card.tsx +270 -0
  45. package/src/color-picker.stories.tsx +65 -0
  46. package/src/color-picker.tsx +425 -0
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +398 -0
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -0
  51. package/src/copy-block.tsx +85 -0
  52. package/src/data-table.stories.tsx +200 -0
  53. package/src/data-table.tsx +1686 -0
  54. package/src/date-picker.stories.tsx +61 -0
  55. package/src/date-picker.tsx +456 -0
  56. package/src/design-cards.stories.tsx +551 -0
  57. package/src/dialog.stories.tsx +48 -0
  58. package/src/dialog.tsx +179 -0
  59. package/src/display-preferences.tsx +50 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -0
  61. package/src/documents/barcode-svg.tsx +79 -0
  62. package/src/dropdown-menu.stories.tsx +77 -0
  63. package/src/dropdown-menu.tsx +271 -0
  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 -0
  68. package/src/editor/block-ids.ts +44 -0
  69. package/src/editor/block-list.tsx +104 -0
  70. package/src/editor/block-toolbar.tsx +490 -0
  71. package/src/editor/bubble.tsx +119 -0
  72. package/src/editor/catalogue.ts +169 -0
  73. package/src/editor/collab-rail.tsx +746 -0
  74. package/src/editor/collab.stories.tsx +207 -0
  75. package/src/editor/collab.ts +87 -0
  76. package/src/editor/contract.ts +476 -0
  77. package/src/editor/convert.ts +414 -0
  78. package/src/editor/doc-editor.stories.tsx +98 -0
  79. package/src/editor/doc-editor.tsx +1492 -0
  80. package/src/editor/editor.css +636 -0
  81. package/src/editor/extensions.ts +86 -0
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -0
  84. package/src/editor/fields.ts +100 -0
  85. package/src/editor/gutter.tsx +443 -0
  86. package/src/editor/index.ts +23 -0
  87. package/src/editor/label-sheet.tsx +289 -0
  88. package/src/editor/labels.ts +394 -0
  89. package/src/editor/link-tools.tsx +141 -0
  90. package/src/editor/node-views.tsx +461 -0
  91. package/src/editor/page-view.tsx +372 -0
  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 -0
  97. package/src/editor/rich-blocks.stories.tsx +146 -0
  98. package/src/editor/sample.ts +40 -0
  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 -0
  104. package/src/editor/schema.ts +368 -0
  105. package/src/editor/services.tsx +205 -0
  106. package/src/editor/slash.ts +64 -0
  107. package/src/editor/suggesting.ts +372 -0
  108. package/src/editor/suggestions.ts +763 -0
  109. package/src/editor/table-keys.ts +66 -0
  110. package/src/editor/templates.stories.tsx +324 -0
  111. package/src/editor/toolbar.tsx +364 -0
  112. package/src/empty-state.stories.tsx +51 -0
  113. package/src/empty-state.tsx +126 -0
  114. package/src/empty-state.usage-notes.md +30 -0
  115. package/src/form.stories.tsx +112 -0
  116. package/src/form.tsx +176 -0
  117. package/src/globals.css +20 -0
  118. package/src/icon-button.tsx +85 -0
  119. package/src/icon-map.ts +335 -0
  120. package/src/icon.tsx +41 -0
  121. package/src/index.ts +90 -0
  122. package/src/input.stories.tsx +157 -0
  123. package/src/input.tsx +768 -0
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -0
  127. package/src/locked-screen.tsx +75 -0
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -0
  131. package/src/math-text.stories.tsx +33 -0
  132. package/src/math-text.tsx +43 -0
  133. package/src/menu-bar.stories.tsx +198 -0
  134. package/src/menu-bar.tsx +373 -0
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -0
  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 -0
  142. package/src/page-header.tsx +122 -0
  143. package/src/page-shell.stories.tsx +42 -0
  144. package/src/page-shell.tsx +32 -0
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -0
  147. package/src/pagination.tsx +98 -0
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -0
  152. package/src/plugin-card.tsx +931 -0
  153. package/src/popover.stories.tsx +48 -0
  154. package/src/popover.tsx +55 -0
  155. package/src/radio-group.stories.tsx +26 -0
  156. package/src/radio-group.tsx +44 -0
  157. package/src/route-flow/editor.tsx +1087 -0
  158. package/src/route-flow/model.ts +771 -0
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -0
  161. package/src/screen-too-small.stories.tsx +61 -0
  162. package/src/screen-too-small.tsx +104 -0
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -0
  165. package/src/select.tsx +197 -0
  166. package/src/separator.stories.tsx +34 -0
  167. package/src/separator.tsx +34 -0
  168. package/src/sheet.stories.tsx +49 -0
  169. package/src/sheet.tsx +168 -0
  170. package/src/skeleton.stories.tsx +28 -0
  171. package/src/skeleton.tsx +19 -0
  172. package/src/slider.stories.tsx +78 -0
  173. package/src/slider.tsx +300 -0
  174. package/src/spinner.stories.tsx +33 -0
  175. package/src/spinner.tsx +55 -0
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -0
  178. package/src/switch.tsx +41 -0
  179. package/src/switcher.stories.tsx +111 -0
  180. package/src/switcher.tsx +131 -0
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -0
  183. package/src/table.tsx +121 -0
  184. package/src/tabs.stories.tsx +74 -0
  185. package/src/tabs.tsx +90 -0
  186. package/src/tag-input.stories.tsx +67 -0
  187. package/src/tag-input.tsx +117 -0
  188. package/src/tenant-logo.tsx +63 -0
  189. package/src/tenant-switcher.stories.tsx +38 -0
  190. package/src/tenant-switcher.tsx +164 -0
  191. package/src/textarea.stories.tsx +27 -0
  192. package/src/textarea.tsx +18 -0
  193. package/src/theme-mode.ts +52 -0
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -0
  196. package/src/time-picker.tsx +615 -0
  197. package/src/toggle-group.tsx +138 -0
  198. package/src/tooltip.stories.tsx +43 -0
  199. package/src/tooltip.tsx +73 -0
  200. package/src/top-nav.stories.tsx +58 -0
  201. package/src/top-nav.tsx +324 -0
  202. package/src/undo-bar.tsx +107 -0
  203. package/src/utils.ts +45 -0
  204. package/src/view-toggle.stories.tsx +84 -0
  205. package/src/view-toggle.tsx +110 -0
@@ -0,0 +1,107 @@
1
+ "use client"
2
+
3
+ import { Button } from "./button"
4
+ import { Icon } from "./icon"
5
+ import { cn } from "./utils"
6
+
7
+ /**
8
+ * Undo that stays on an activity item for the tool's own window, after the
9
+ * 10-second toast has gone (docs/design/components/UndoBar; register 7.5c).
10
+ * It says what happened and how long is left, with a thin meter. Once undone
11
+ * it turns dashed, because an undone action is loose again like a proposal;
12
+ * when the window closes it says it can no longer be undone.
13
+ */
14
+
15
+ export type UndoBarState = "open" | "undone" | "expired"
16
+
17
+ export interface UndoBarLabels {
18
+ undo?: string
19
+ /** `{time}` is what is left, e.g. "24 minutes". */
20
+ left?: string
21
+ expired?: string
22
+ undone?: string
23
+ /** `{name}` is who undid it. */
24
+ undoneBy?: string
25
+ }
26
+
27
+ export interface UndoBarProps {
28
+ text?: string
29
+ state?: UndoBarState
30
+ /** What is left, already worded ("24 minutes"). */
31
+ remainingLabel?: string
32
+ /** Seconds left and the whole window, for the meter. */
33
+ remaining?: number
34
+ total?: number
35
+ undoneBy?: string
36
+ busy?: boolean
37
+ onUndo?: () => void
38
+ labels?: UndoBarLabels
39
+ className?: string
40
+ }
41
+
42
+ const DEFAULT_LABELS: Required<UndoBarLabels> = {
43
+ undo: "Undo",
44
+ left: "{time} left to undo",
45
+ expired: "Can no longer be undone",
46
+ undone: "Undone",
47
+ undoneBy: "Undone by {name}",
48
+ }
49
+
50
+ function UndoBar({
51
+ text,
52
+ state = "open",
53
+ remainingLabel = "",
54
+ remaining,
55
+ total,
56
+ undoneBy,
57
+ busy = false,
58
+ onUndo,
59
+ labels,
60
+ className,
61
+ }: UndoBarProps) {
62
+ const L = { ...DEFAULT_LABELS, ...labels }
63
+ const share = total ? Math.max(0, Math.min(1, (remaining ?? 0) / total)) : null
64
+ const status =
65
+ state === "open"
66
+ ? L.left.replace("{time}", remainingLabel)
67
+ : state === "expired"
68
+ ? L.expired
69
+ : undoneBy
70
+ ? L.undoneBy.replace("{name}", undoneBy)
71
+ : L.undone
72
+
73
+ return (
74
+ <div
75
+ role="group"
76
+ aria-label={text}
77
+ data-slot="undo-bar"
78
+ data-state={state}
79
+ className={cn(
80
+ "relative flex flex-wrap items-center gap-2 overflow-hidden rounded-md border border-border bg-card pt-1.5 pe-2 pb-2 ps-2.5 text-[0.8125rem] text-muted-foreground",
81
+ state === "undone" && "border-dashed text-foreground",
82
+ state === "expired" && "bg-muted",
83
+ className
84
+ )}
85
+ >
86
+ <Icon name={state === "undone" ? "undo" : state === "expired" ? "lock" : "clock"} size={16} className="shrink-0" />
87
+ <span className="min-w-0 flex-1">
88
+ {text && <span className="text-foreground">{text}</span>}
89
+ {text && " · "}
90
+ {status}
91
+ </span>
92
+ {state === "open" && onUndo && (
93
+ <Button variant="outline" size="xs" disabled={busy} onClick={onUndo}>
94
+ <Icon name="undo" size={12} />
95
+ {L.undo}
96
+ </Button>
97
+ )}
98
+ {state === "open" && share !== null && (
99
+ <span aria-hidden="true" className="absolute inset-x-0 bottom-0 h-0.5 bg-muted">
100
+ <span className="block h-full bg-primary" style={{ width: `${share * 100}%` }} />
101
+ </span>
102
+ )}
103
+ </div>
104
+ )
105
+ }
106
+
107
+ export { UndoBar }
package/src/utils.ts ADDED
@@ -0,0 +1,45 @@
1
+ import * as React from "react"
2
+ import { clsx, type ClassValue } from "clsx"
3
+ import { twMerge } from "tailwind-merge"
4
+
5
+ export function cn(...inputs: ClassValue[]) {
6
+ return twMerge(clsx(inputs))
7
+ }
8
+
9
+ /**
10
+ * Hook to detect if dark mode is active anywhere in the document (on <html>,
11
+ * <body>, or any ancestor container like Storybook root). Essential for
12
+ * portaled overlays (Popover, DropdownMenu, Select, Tooltip, Sheet) mounting
13
+ * outside of the main DOM tree.
14
+ */
15
+ export function useIsDarkMode(): boolean {
16
+ const [isDark, setIsDark] = React.useState(false)
17
+
18
+ React.useEffect(() => {
19
+ const checkDark = () => {
20
+ if (typeof document === "undefined") return
21
+ const dark =
22
+ document.documentElement.classList.contains("dark") ||
23
+ document.body.classList.contains("dark") ||
24
+ !!document.querySelector(".dark")
25
+ setIsDark(dark)
26
+ }
27
+
28
+ checkDark()
29
+
30
+ if (typeof document !== "undefined") {
31
+ const observer = new MutationObserver(checkDark)
32
+ observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] })
33
+ observer.observe(document.body, { attributes: true, attributeFilter: ["class"] })
34
+
35
+ const sbRoot = document.getElementById("storybook-root")
36
+ if (sbRoot) {
37
+ observer.observe(sbRoot, { attributes: true, attributeFilter: ["class"] })
38
+ }
39
+
40
+ return () => observer.disconnect()
41
+ }
42
+ }, [])
43
+
44
+ return isDark
45
+ }
@@ -0,0 +1,84 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { fn } from "storybook/test"
3
+ import * as React from "react"
4
+ import { IconLayoutGrid, IconList, IconTable } from "@tabler/icons-react"
5
+
6
+ import { ViewToggle } from "./view-toggle"
7
+
8
+ const LAYOUTS = [
9
+ { value: "list", label: "List", icon: <IconList size={16} aria-hidden /> },
10
+ { value: "grid", label: "Grid", icon: <IconLayoutGrid size={16} aria-hidden /> },
11
+ ]
12
+
13
+ const meta = {
14
+ title: "Inputs/ViewToggle",
15
+ component: ViewToggle,
16
+ tags: ["autodocs"],
17
+ args: {
18
+ options: LAYOUTS,
19
+ value: "list",
20
+ label: "Layout",
21
+ onChange: fn(),
22
+ },
23
+ } satisfies Meta<typeof ViewToggle>
24
+
25
+ export default meta
26
+ type Story = StoryObj<typeof meta>
27
+
28
+ /**
29
+ * Controlled, so the stories drive it through this wrapper: the selection is
30
+ * held locally and the `onChange` arg still fires, so the Actions panel logs it.
31
+ */
32
+ function Controlled({ value, onChange, ...props }: React.ComponentProps<typeof ViewToggle>) {
33
+ const [current, setCurrent] = React.useState(value)
34
+ return (
35
+ <ViewToggle
36
+ {...props}
37
+ value={current}
38
+ onChange={(next) => {
39
+ setCurrent(next)
40
+ onChange(next)
41
+ }}
42
+ />
43
+ )
44
+ }
45
+
46
+ /** The document library's list/grid switch — the case this was extracted from. */
47
+ export const Default: Story = { render: (args) => <Controlled {...args} /> }
48
+
49
+ /** Labels beside the icons, for a toolbar with room and options that are not obvious. */
50
+ export const WithLabels: Story = {
51
+ args: { showLabels: true },
52
+ render: (args) => <Controlled {...args} />,
53
+ }
54
+
55
+ /** Three options, to show the control is not hard-wired to a pair. */
56
+ export const ThreeOptions: Story = {
57
+ args: {
58
+ options: [
59
+ ...LAYOUTS,
60
+ { value: "table", label: "Table", icon: <IconTable size={16} aria-hidden /> },
61
+ ],
62
+ },
63
+ render: (args) => <Controlled {...args} />,
64
+ }
65
+
66
+ /**
67
+ * An option the viewer cannot pick keeps its place and carries the CAUSE, rather
68
+ * than disappearing — a hidden option makes "not available to you", "removed"
69
+ * and "broken" pixel-identical.
70
+ */
71
+ export const OneOptionUnavailable: Story = {
72
+ args: {
73
+ options: [
74
+ ...LAYOUTS,
75
+ {
76
+ value: "table",
77
+ label: "Table",
78
+ icon: <IconTable size={16} aria-hidden />,
79
+ disabledReason: "The table view needs column definitions this screen does not supply.",
80
+ },
81
+ ],
82
+ },
83
+ render: (args) => <Controlled {...args} />,
84
+ }
@@ -0,0 +1,110 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { cn } from "./utils"
6
+
7
+ /**
8
+ * PRESENTATIONAL single-choice toggle — a small set of mutually exclusive
9
+ * options rendered as one segmented control.
10
+ *
11
+ * WHY THIS IS IN THE KIT AND NOT IN A SCREEN
12
+ * ------------------------------------------
13
+ * It arrived as a hand-rolled list/grid switch inside the document library's
14
+ * toolbar. Nothing about it is about documents: it is "pick exactly one of these
15
+ * two or three, and show me which is on", which is the same control a media
16
+ * browser, a report view and a settings density picker each want. Left in the
17
+ * screen it would have been copied the second time somebody needed one, and the
18
+ * two copies would have disagreed about the accessible name, the pressed state,
19
+ * or which corner gets rounded.
20
+ *
21
+ * WHY BUTTONS WITH `aria-pressed` AND NOT A RADIO GROUP
22
+ * ----------------------------------------------------
23
+ * Both are defensible and this picks one deliberately. A radio group is for
24
+ * choosing a VALUE that is submitted; this changes the view immediately, which
25
+ * is what a toggle button is for. `aria-pressed` announces on/off per option, so
26
+ * a screen reader hears "Grid, pressed" rather than having to walk the group to
27
+ * discover the selection. The wrapper still carries `role="group"` and a name,
28
+ * so the options are announced as belonging together.
29
+ *
30
+ * WHY EVERY OPTION MUST CARRY A LABEL
31
+ * -----------------------------------
32
+ * `label` is required, not optional, and it is used as the accessible name even
33
+ * when `icon` is supplied. An icon-only toggle whose buttons have no name is the
34
+ * single most common way this control ships broken — it looks finished, and it
35
+ * is two unlabelled buttons to anybody not looking at it.
36
+ *
37
+ * DIRECTION
38
+ * ---------
39
+ * Nothing here is direction-aware and that is intentional: the group is a flex
40
+ * row, so it flows along the inline axis and reverses under `dir="rtl"` on its
41
+ * own. Callers should pass symmetrical icons, or icons they are happy to see
42
+ * unmirrored — an icon with an intrinsic direction (an arrow) is a caller
43
+ * decision, not something a generic control can flip safely.
44
+ */
45
+ export interface ViewToggleOption<TValue extends string> {
46
+ value: TValue
47
+ /** The accessible name. Required — see the note above about icon-only groups. */
48
+ label: string
49
+ /** Optional glyph. Decorative: mark it `aria-hidden` at the call site. */
50
+ icon?: React.ReactNode
51
+ /** When set, the option is disabled and this is why. Shown on hover and announced. */
52
+ disabledReason?: string
53
+ }
54
+
55
+ export interface ViewToggleProps<TValue extends string> {
56
+ options: ViewToggleOption<TValue>[]
57
+ value: TValue
58
+ onChange: (value: TValue) => void
59
+ /** Names the group, e.g. "Layout". Required: an unnamed group is an orphan. */
60
+ label: string
61
+ /** Show each option's label beside its icon rather than relying on the icon alone. */
62
+ showLabels?: boolean
63
+ className?: string
64
+ }
65
+
66
+ function ViewToggle<TValue extends string>({
67
+ options,
68
+ value,
69
+ onChange,
70
+ label,
71
+ showLabels = false,
72
+ className,
73
+ }: ViewToggleProps<TValue>) {
74
+ return (
75
+ <div
76
+ role="group"
77
+ aria-label={label}
78
+ className={cn("flex items-center rounded-md border border-border", className)}
79
+ >
80
+ {options.map((option) => {
81
+ const active = option.value === value
82
+ const disabled = option.disabledReason !== undefined
83
+ return (
84
+ <button
85
+ key={option.value}
86
+ type="button"
87
+ onClick={() => onChange(option.value)}
88
+ disabled={disabled}
89
+ aria-pressed={active}
90
+ aria-label={option.label}
91
+ title={option.disabledReason ?? option.label}
92
+ className={cn(
93
+ "flex h-9 items-center justify-center gap-2 text-sm transition-colors",
94
+ showLabels ? "px-3" : "w-9",
95
+ active
96
+ ? "bg-accent text-accent-foreground"
97
+ : "text-muted-foreground hover:bg-accent/60",
98
+ disabled && "cursor-not-allowed opacity-50 hover:bg-transparent"
99
+ )}
100
+ >
101
+ {option.icon}
102
+ {showLabels && <span>{option.label}</span>}
103
+ </button>
104
+ )
105
+ })}
106
+ </div>
107
+ )
108
+ }
109
+
110
+ export { ViewToggle }