@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.
- package/README.md +106 -2
- package/package.json +219 -4
- package/src/access-denied.stories.tsx +179 -0
- package/src/access-denied.tsx +305 -0
- package/src/action-proposal.tsx +338 -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 +604 -0
- package/src/approval-queue.tsx +109 -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-pattern.ts +138 -0
- package/src/avatar.tsx +125 -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 +188 -0
- package/src/board.tsx +216 -0
- package/src/breadcrumb.stories.tsx +51 -0
- package/src/breadcrumb.tsx +90 -0
- package/src/built-on-whity.tsx +52 -0
- package/src/button.stories.tsx +87 -0
- package/src/button.tsx +123 -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/column-matcher.tsx +84 -0
- package/src/command-palette.tsx +398 -0
- package/src/confirm-action.tsx +98 -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 +1686 -0
- package/src/date-picker.stories.tsx +61 -0
- package/src/date-picker.tsx +456 -0
- package/src/design-cards.stories.tsx +551 -0
- package/src/dialog.stories.tsx +48 -0
- package/src/dialog.tsx +179 -0
- package/src/display-preferences.tsx +50 -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/agent-panel.tsx +222 -0
- package/src/editor/agents.stories.tsx +81 -0
- package/src/editor/agents.ts +55 -0
- package/src/editor/behaviour.ts +279 -0
- package/src/editor/block-ids.ts +44 -0
- package/src/editor/block-list.tsx +104 -0
- package/src/editor/block-toolbar.tsx +490 -0
- package/src/editor/bubble.tsx +119 -0
- package/src/editor/catalogue.ts +169 -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 +476 -0
- package/src/editor/convert.ts +414 -0
- package/src/editor/doc-editor.stories.tsx +98 -0
- package/src/editor/doc-editor.tsx +1492 -0
- package/src/editor/editor.css +636 -0
- package/src/editor/extensions.ts +86 -0
- package/src/editor/field-bar.tsx +154 -0
- package/src/editor/field-picker.tsx +109 -0
- package/src/editor/fields.ts +100 -0
- package/src/editor/gutter.tsx +443 -0
- package/src/editor/index.ts +23 -0
- package/src/editor/label-sheet.tsx +289 -0
- package/src/editor/labels.ts +394 -0
- package/src/editor/link-tools.tsx +141 -0
- package/src/editor/node-views.tsx +461 -0
- package/src/editor/page-view.tsx +372 -0
- package/src/editor/phone.tsx +310 -0
- package/src/editor/plugin-block-view.tsx +230 -0
- package/src/editor/plugin-blocks.stories.tsx +96 -0
- package/src/editor/plugin-blocks.ts +52 -0
- package/src/editor/publish-check.tsx +201 -0
- package/src/editor/rich-blocks.stories.tsx +146 -0
- package/src/editor/sample.ts +40 -0
- package/src/editor/save-block-dialog.tsx +141 -0
- package/src/editor/saved-block-view.tsx +205 -0
- package/src/editor/saved-blocks.stories.tsx +105 -0
- package/src/editor/saved-parts.ts +192 -0
- package/src/editor/schema-rich.ts +156 -0
- package/src/editor/schema.ts +368 -0
- package/src/editor/services.tsx +205 -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 +364 -0
- package/src/empty-state.stories.tsx +51 -0
- package/src/empty-state.tsx +126 -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 +335 -0
- package/src/icon.tsx +41 -0
- package/src/index.ts +90 -0
- package/src/input.stories.tsx +157 -0
- package/src/input.tsx +768 -0
- package/src/kpi-strip.tsx +47 -0
- package/src/localized-text.ts +76 -0
- package/src/locked-screen.stories.tsx +29 -0
- package/src/locked-screen.tsx +75 -0
- package/src/lockup.tsx +42 -0
- package/src/lottie.tsx +441 -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/message-thread.tsx +181 -0
- package/src/money/currency.ts +244 -0
- package/src/money/money-input.tsx +131 -0
- package/src/money/money.tsx +33 -0
- package/src/open-on-computer.tsx +150 -0
- package/src/otp-input.tsx +161 -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/page-states.tsx +277 -0
- package/src/pagination.stories.tsx +45 -0
- package/src/pagination.tsx +98 -0
- package/src/paper-sheet.stories.tsx +88 -0
- package/src/paper-sheet.tsx +85 -0
- package/src/phone-tab-bar.tsx +152 -0
- package/src/plugin-card.stories.tsx +208 -0
- package/src/plugin-card.tsx +931 -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 +1087 -0
- package/src/route-flow/model.ts +771 -0
- package/src/save-bar.tsx +94 -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/search-field.tsx +65 -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/stepper.tsx +85 -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/system-state.tsx +55 -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-grid.tsx +163 -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
package/src/save-bar.tsx
ADDED
|
@@ -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
|
+
}
|