@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,94 @@
1
+ import * as React from "react"
2
+
3
+ import { Button } from "./button"
4
+ import { cn } from "./utils"
5
+
6
+ /**
7
+ * The record page's save bar (decision P.3): it appears as soon as something
8
+ * changes, names the changes, and holds Discard and Save changes, the page's one
9
+ * main button. While it shows, leaving or reloading the page asks first.
10
+ */
11
+ export interface SaveBarProps {
12
+ /** Whether anything changed. The bar renders nothing otherwise. */
13
+ dirty: boolean
14
+ /** Names the changes: "Unit and role changed". */
15
+ summary: React.ReactNode
16
+ discardLabel: string
17
+ saveLabel: string
18
+ saving?: boolean
19
+ onDiscard: () => void
20
+ onSave: () => void
21
+ className?: string
22
+ }
23
+
24
+ function SaveBar({ dirty, summary, discardLabel, saveLabel, saving = false, onDiscard, onSave, className }: SaveBarProps) {
25
+ useLeaveGuard(dirty)
26
+ if (!dirty) return null
27
+ return (
28
+ <div
29
+ data-slot="save-bar"
30
+ role="region"
31
+ aria-live="polite"
32
+ className={cn(
33
+ // On a phone the bar docks to the bottom edge across the full width
34
+ // (M.4: the main action sits in a bar at the bottom, under the thumb),
35
+ // the summary takes its own line and the two buttons share the next.
36
+ "sticky bottom-4 z-[5] mt-5 flex flex-wrap items-center gap-3 rounded-card border border-border bg-popover py-2.5 ps-4 pe-3 text-sm text-popover-foreground shadow-float",
37
+ "max-sm:-mx-4 max-sm:bottom-0 max-sm:rounded-none max-sm:border-x-0 max-sm:border-b-0 max-sm:px-4 max-sm:py-3",
38
+ className
39
+ )}
40
+ >
41
+ <span className="min-w-0 flex-1 max-sm:basis-full">{summary}</span>
42
+ <Button type="button" variant="outline" onClick={onDiscard} disabled={saving} className="max-sm:flex-1">
43
+ {discardLabel}
44
+ </Button>
45
+ <Button type="button" loading={saving} onClick={onSave} className="max-sm:flex-[2]">
46
+ {saveLabel}
47
+ </Button>
48
+ </div>
49
+ )
50
+ }
51
+
52
+ /** Ask before reloading or closing the page while `active`. */
53
+ function useLeaveGuard(active: boolean) {
54
+ React.useEffect(() => {
55
+ if (!active) return
56
+ const beforeUnload = (event: BeforeUnloadEvent) => {
57
+ event.preventDefault()
58
+ }
59
+ window.addEventListener("beforeunload", beforeUnload)
60
+ return () => window.removeEventListener("beforeunload", beforeUnload)
61
+ }, [active])
62
+ }
63
+
64
+ /**
65
+ * A changed field's ring and its "Was …" note (P.3). Wrap the field; the ring
66
+ * lands on whatever control sits inside.
67
+ */
68
+ function ChangedField({
69
+ changed,
70
+ wasLabel,
71
+ children,
72
+ className,
73
+ }: {
74
+ changed: boolean
75
+ /** "Was Sweifieh" */
76
+ wasLabel?: string
77
+ children: React.ReactNode
78
+ className?: string
79
+ }) {
80
+ return (
81
+ <div
82
+ data-changed={changed ? "" : undefined}
83
+ className={cn(
84
+ "grid gap-1 data-changed:[&_input]:border-primary data-changed:[&_input]:ring-3 data-changed:[&_input]:ring-primary-tint data-changed:[&_[data-slot=select-trigger]]:border-primary data-changed:[&_[data-slot=select-trigger]]:ring-3 data-changed:[&_[data-slot=select-trigger]]:ring-primary-tint",
85
+ className
86
+ )}
87
+ >
88
+ {children}
89
+ {changed && wasLabel && <span className="text-xs text-muted-foreground">{wasLabel}</span>}
90
+ </div>
91
+ )
92
+ }
93
+
94
+ export { ChangedField, SaveBar, useLeaveGuard }
@@ -0,0 +1,139 @@
1
+ "use client"
2
+
3
+ import { ActorChip } from "./actor-chip"
4
+ import { cn } from "./utils"
5
+
6
+ /**
7
+ * What an agent may do, per `resource:action` permission: Off, Ask first or
8
+ * Allowed (docs/design/components/ScopeGrant; register "Scope grant"). Ask
9
+ * first routes the action through a proposal, so it wears the dashed outline;
10
+ * Allowed is the tint (7.3). The note states the hard rule: an agent never
11
+ * does more than the person who granted it.
12
+ *
13
+ * Controlled: `modes` maps each permission key to its mode. An action can
14
+ * narrow the modes it offers (`modes` on the action), e.g. a write that can't
15
+ * be undone offers no Allowed; `hint` says why.
16
+ */
17
+
18
+ export type ScopeGrantMode = "off" | "ask" | "allow"
19
+
20
+ export interface ScopeGrantAction {
21
+ /** The permission key, e.g. `invoices:send`. */
22
+ key: string
23
+ label: string
24
+ /** The modes this action offers; all three when omitted. */
25
+ modes?: ScopeGrantMode[]
26
+ hint?: string
27
+ }
28
+
29
+ export interface ScopeGrantGroup {
30
+ key: string
31
+ label: string
32
+ actions: ScopeGrantAction[]
33
+ }
34
+
35
+ export interface ScopeGrantLabels {
36
+ off?: string
37
+ ask?: string
38
+ allow?: string
39
+ note?: string
40
+ for?: string
41
+ }
42
+
43
+ export interface ScopeGrantProps {
44
+ agent: string
45
+ onBehalfOf?: string
46
+ groups: ScopeGrantGroup[]
47
+ modes: Record<string, ScopeGrantMode>
48
+ onChange?: (permission: string, mode: ScopeGrantMode) => void
49
+ disabled?: boolean
50
+ labels?: ScopeGrantLabels
51
+ className?: string
52
+ }
53
+
54
+ const ALL_MODES: ScopeGrantMode[] = ["off", "ask", "allow"]
55
+
56
+ const DEFAULT_LABELS: Required<ScopeGrantLabels> = {
57
+ off: "Off",
58
+ ask: "Ask first",
59
+ allow: "Allowed",
60
+ note: "The agent can never do more than the person who granted it.",
61
+ for: "for",
62
+ }
63
+
64
+ function ScopeGrant({ agent, onBehalfOf, groups, modes, onChange, disabled = false, labels, className }: ScopeGrantProps) {
65
+ const L = { ...DEFAULT_LABELS, ...labels }
66
+
67
+ return (
68
+ <div data-slot="scope-grant" className={cn("grid max-w-[640px] gap-3 rounded-card border border-border bg-card p-4", className)}>
69
+ <div className="flex flex-wrap items-center gap-3">
70
+ <ActorChip kind="agent" name={agent} onBehalfOf={onBehalfOf} labels={{ for: L.for }} />
71
+ <span className="text-muted-foreground">{L.note}</span>
72
+ </div>
73
+ <table className="w-full border-collapse">
74
+ <tbody>
75
+ {groups.map((group) =>
76
+ group.actions.map((action, index) => {
77
+ const offered = action.modes ?? ALL_MODES
78
+ const current = modes[action.key] ?? "off"
79
+ return (
80
+ <tr key={action.key}>
81
+ {index === 0 && (
82
+ <th
83
+ scope="row"
84
+ rowSpan={group.actions.length}
85
+ className="w-[22%] border-t border-border p-2 text-start align-middle text-sm font-semibold"
86
+ >
87
+ {group.label}
88
+ </th>
89
+ )}
90
+ <td className="border-t border-border p-2 align-middle">
91
+ <span className="grid gap-0.5">
92
+ <span>{action.label}</span>
93
+ <code className="justify-self-start rounded-sm bg-muted px-[5px] py-px font-mono text-xs text-foreground">
94
+ {action.key}
95
+ </code>
96
+ {action.hint && <span className="text-xs text-muted-foreground">{action.hint}</span>}
97
+ </span>
98
+ </td>
99
+ <td className="border-t border-border p-2 text-end align-middle">
100
+ <div
101
+ role="radiogroup"
102
+ aria-label={`${group.label} · ${action.label}`}
103
+ className="inline-flex gap-0.5 rounded-control-sm border border-border bg-muted p-0.5"
104
+ >
105
+ {ALL_MODES.map((mode) => {
106
+ const on = current === mode
107
+ const available = offered.includes(mode)
108
+ return (
109
+ <button
110
+ key={mode}
111
+ type="button"
112
+ role="radio"
113
+ aria-checked={on}
114
+ disabled={disabled || !available}
115
+ onClick={() => !on && onChange?.(action.key, mode)}
116
+ className={cn(
117
+ "rounded-[4px] px-2 py-[3px] text-xs font-medium whitespace-nowrap text-muted-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
118
+ on && "bg-card font-semibold text-foreground shadow-[0_0_0_1px_var(--border)]",
119
+ on && mode === "allow" && "bg-primary-tint text-primary-tint-foreground shadow-[0_0_0_1px_var(--primary)]",
120
+ on && mode === "ask" && "outline-[1.5px] -outline-offset-[1.5px] outline-brand outline-dashed"
121
+ )}
122
+ >
123
+ {L[mode]}
124
+ </button>
125
+ )
126
+ })}
127
+ </div>
128
+ </td>
129
+ </tr>
130
+ )
131
+ })
132
+ )}
133
+ </tbody>
134
+ </table>
135
+ </div>
136
+ )
137
+ }
138
+
139
+ export { ScopeGrant }
@@ -0,0 +1,61 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { IconRulerMeasure } from "@tabler/icons-react"
3
+
4
+ import { ScreenTooSmall } from "./screen-too-small"
5
+ import { Button } from "./button"
6
+
7
+ const meta = {
8
+ title: "ScreenTooSmall",
9
+ component: ScreenTooSmall,
10
+ tags: ["autodocs"],
11
+ parameters: {
12
+ layout: "fullscreen",
13
+ docs: {
14
+ description: {
15
+ component:
16
+ "Full-page \"this screen is too small\" state, for a workspace that genuinely cannot be made useful on a phone — a canvas editor with a millimetre-accurate page and a properties rail, say. A sibling of `AccessDenied` and `LockedScreen`: domain-free, presentational, `role=\"alert\"`. Deliberately a GATE rather than responsive layout, because some tools are worse squeezed than honestly withheld — so reach for it only where that is true, and let the rest of the app adapt. Pair it with the `useViewportAtLeast(minWidth)` hook exported alongside, which returns `undefined` until the first client measurement so neither branch is guessed during SSR.",
17
+ },
18
+ },
19
+ },
20
+ } satisfies Meta<typeof ScreenTooSmall>
21
+
22
+ export default meta
23
+ type Story = StoryObj<typeof meta>
24
+
25
+ /** Defaults — the minimum a caller has to supply is nothing at all. */
26
+ export const Default: Story = {}
27
+
28
+ /** The real document-editor copy: what's blocked, why, and where to go instead.
29
+ * An `action` keeps it from being a dead end. */
30
+ export const DocumentEditorGate: Story = {
31
+ args: {
32
+ title: "The document editor needs a larger screen",
33
+ description:
34
+ "Designing print-accurate labels and documents needs room for the page plus its layers and properties panels. Open this on a tablet in landscape, laptop or desktop.",
35
+ minWidth: 1024,
36
+ action: (
37
+ <Button variant="outline" size="sm" className="mt-2">
38
+ Back to dashboard
39
+ </Button>
40
+ ),
41
+ },
42
+ }
43
+
44
+ /** Without `minWidth` the pixel hint is omitted — use it when the threshold is
45
+ * a detail the reader can't act on. */
46
+ export const WithoutWidthHint: Story = {
47
+ args: {
48
+ title: "Not available on this screen",
49
+ description: "This view needs a wider window.",
50
+ },
51
+ }
52
+
53
+ /** A custom icon, for a gate about something other than screen size. */
54
+ export const CustomIcon: Story = {
55
+ args: {
56
+ icon: <IconRulerMeasure />,
57
+ title: "Window too narrow",
58
+ description: "Widen the window to at least 1280px to use the side-by-side comparison.",
59
+ minWidth: 1280,
60
+ },
61
+ }
@@ -0,0 +1,104 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { IconDeviceDesktop } from "@tabler/icons-react"
5
+
6
+ import { cn } from "./utils"
7
+
8
+ /**
9
+ * Full-page "this screen is too small" state — for a workspace that genuinely
10
+ * cannot be made useful on a phone (a canvas editor with two side rails and a
11
+ * millimetre-accurate page, say). A sibling of `AccessDenied` and
12
+ * `LockedScreen`: domain-free, presentational, `role="alert"`.
13
+ *
14
+ * This is deliberately a GATE, not responsive layout: some tools are worse when
15
+ * squeezed than when honestly withheld. Use it only where that is true — the
16
+ * rest of the app should still adapt.
17
+ */
18
+ export interface ScreenTooSmallProps extends Omit<React.ComponentProps<"div">, "title"> {
19
+ icon?: React.ReactNode
20
+ title?: React.ReactNode
21
+ description?: React.ReactNode
22
+ /** Minimum width the feature needs, in px — shown to explain the gate. */
23
+ minWidth?: number
24
+ /**
25
+ * The "needs a wider window" line. A function because the pixel count sits
26
+ * inside the sentence and languages order it differently.
27
+ */
28
+ minWidthHint?: (minWidth: number) => string
29
+ /** e.g. a "Back to dashboard" link, so the screen is never a dead end. */
30
+ action?: React.ReactNode
31
+ }
32
+
33
+ function ScreenTooSmall({
34
+ className,
35
+ icon,
36
+ title = "This screen is too small",
37
+ description,
38
+ minWidth,
39
+ minWidthHint = (px: number) => `Needs a window at least ${px}px wide.`,
40
+ action,
41
+ ...props
42
+ }: ScreenTooSmallProps) {
43
+ return (
44
+ <div
45
+ role="alert"
46
+ data-slot="screen-too-small"
47
+ data-testid="screen-too-small"
48
+ className={cn(
49
+ "flex min-h-svh flex-col items-center justify-center gap-3 p-8 text-center",
50
+ className
51
+ )}
52
+ {...props}
53
+ >
54
+ <span className="flex size-12 items-center justify-center rounded-full bg-muted text-muted-foreground [&_svg:not([class*='size-'])]:size-6">
55
+ {icon ?? <IconDeviceDesktop />}
56
+ </span>
57
+ <h1 className="text-base font-semibold text-foreground">{title}</h1>
58
+ <p className="max-w-sm text-sm text-muted-foreground">
59
+ {description ?? "Please switch to a larger screen to continue."}
60
+ </p>
61
+ {minWidth !== undefined && (
62
+ <p className="text-xs text-muted-foreground/80">{minWidthHint(minWidth)}</p>
63
+ )}
64
+ {action}
65
+ </div>
66
+ )
67
+ }
68
+
69
+ const hasMatchMedia = () => typeof window !== "undefined" && typeof window.matchMedia === "function"
70
+
71
+ /**
72
+ * Whether the viewport is at least `minWidth` CSS px, tracked live.
73
+ *
74
+ * Returns `undefined` for the hydration render — i.e. "not measured yet" — so a
75
+ * caller can hold off rendering EITHER branch for one paint instead of guessing.
76
+ * Guessing is what goes wrong here: assume wide and phones flash the editor;
77
+ * assume narrow and desktops flash the gate.
78
+ *
79
+ * A media query IS an external store, so this uses `useSyncExternalStore` rather
80
+ * than measuring in an effect: React swaps from the server snapshot to the live
81
+ * value immediately after hydration, with no setState cascade and no mismatch.
82
+ */
83
+ function useViewportAtLeast(minWidth: number): boolean | undefined {
84
+ const subscribe = React.useCallback(
85
+ (onChange: () => void) => {
86
+ if (!hasMatchMedia()) return () => {}
87
+ const query = window.matchMedia(`(min-width: ${minWidth}px)`)
88
+ query.addEventListener("change", onChange)
89
+ return () => query.removeEventListener("change", onChange)
90
+ },
91
+ [minWidth]
92
+ )
93
+
94
+ const getSnapshot = React.useCallback(
95
+ // No matchMedia (very old browser / non-DOM env): fail OPEN rather than
96
+ // permanently gating someone out of the feature.
97
+ () => (hasMatchMedia() ? window.matchMedia(`(min-width: ${minWidth}px)`).matches : true),
98
+ [minWidth]
99
+ )
100
+
101
+ return React.useSyncExternalStore(subscribe, getSnapshot, () => undefined)
102
+ }
103
+
104
+ export { ScreenTooSmall, useViewportAtLeast }
@@ -0,0 +1,65 @@
1
+ import * as React from "react"
2
+
3
+ import { Icon } from "./icon"
4
+ import { cn } from "./utils"
5
+
6
+ /**
7
+ * The search box for lists and the top bar (docs/design/components/SearchField).
8
+ * Shows the shortcut until you type, then a clear button. Escape clears; Enter
9
+ * calls `onSearch`.
10
+ */
11
+ export interface SearchFieldProps extends Omit<React.ComponentProps<"input">, "value" | "onChange" | "type"> {
12
+ value: string
13
+ onValueChange: (value: string) => void
14
+ onSearch?: (value: string) => void
15
+ /** Names the box for assistive technology. */
16
+ label: string
17
+ clearLabel: string
18
+ /** The shortcut hint, such as "Ctrl K". Leave out in lists. */
19
+ shortcut?: string
20
+ }
21
+
22
+ function SearchField({ value, onValueChange, onSearch, label, clearLabel, shortcut, className, onKeyDown, ...props }: SearchFieldProps) {
23
+ return (
24
+ <div data-slot="search-field" className={cn("relative flex min-w-0 items-center", className)}>
25
+ <Icon name="search" size={16} className="pointer-events-none absolute start-2.5 text-muted-foreground" />
26
+ <input
27
+ {...props}
28
+ type="search"
29
+ aria-label={label}
30
+ value={value}
31
+ onChange={(event) => onValueChange(event.target.value)}
32
+ onKeyDown={(event) => {
33
+ onKeyDown?.(event)
34
+ if (event.defaultPrevented) return
35
+ if (event.key === "Escape" && value !== "") {
36
+ event.preventDefault()
37
+ onValueChange("")
38
+ } else if (event.key === "Enter") {
39
+ onSearch?.(value)
40
+ }
41
+ }}
42
+ className="h-10 w-full min-w-0 rounded-control border border-input bg-card ps-8.5 pe-12 text-sm outline-none transition-colors placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 [&::-webkit-search-cancel-button]:hidden"
43
+ />
44
+ {value !== "" ? (
45
+ <button
46
+ type="button"
47
+ aria-label={clearLabel}
48
+ title={clearLabel}
49
+ onClick={() => onValueChange("")}
50
+ className="absolute end-2 grid rounded-sm p-1 text-muted-foreground outline-none hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring/30"
51
+ >
52
+ <Icon name="close" size={16} />
53
+ </button>
54
+ ) : (
55
+ shortcut && (
56
+ <kbd className="absolute end-2 rounded-sm border border-border bg-muted px-1 font-mono text-xs text-muted-foreground">
57
+ {shortcut}
58
+ </kbd>
59
+ )
60
+ )}
61
+ </div>
62
+ )
63
+ }
64
+
65
+ export { SearchField }
@@ -0,0 +1,44 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import {
4
+ Select,
5
+ SelectGroup,
6
+ SelectValue,
7
+ SelectTrigger,
8
+ SelectContent,
9
+ SelectLabel,
10
+ SelectItem,
11
+ SelectSeparator,
12
+ } from "./select"
13
+
14
+ const meta = {
15
+ title: "Primitives/Select",
16
+ component: Select,
17
+ tags: ["autodocs"],
18
+ } satisfies Meta<typeof Select>
19
+
20
+ export default meta
21
+ type Story = StoryObj<typeof meta>
22
+
23
+ export const Default: Story = {
24
+ render: () => (
25
+ <Select>
26
+ <SelectTrigger className="w-56">
27
+ <SelectValue placeholder="Select a region" />
28
+ </SelectTrigger>
29
+ <SelectContent>
30
+ <SelectGroup>
31
+ <SelectLabel>Europe</SelectLabel>
32
+ <SelectItem value="eu-central">eu-central</SelectItem>
33
+ <SelectItem value="eu-west">eu-west</SelectItem>
34
+ </SelectGroup>
35
+ <SelectSeparator />
36
+ <SelectGroup>
37
+ <SelectLabel>Americas</SelectLabel>
38
+ <SelectItem value="us-east">us-east</SelectItem>
39
+ <SelectItem value="us-west" disabled>us-west (soon)</SelectItem>
40
+ </SelectGroup>
41
+ </SelectContent>
42
+ </Select>
43
+ ),
44
+ }