@whity/ui 0.5.0 → 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 +107 -107
  2. package/package.json +221 -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 +123 -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 +398 -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 +1686 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +456 -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 +50 -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 +90 -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-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -180
  152. package/src/plugin-card.tsx +931 -848
  153. package/src/popover.stories.tsx +48 -48
  154. package/src/popover.tsx +55 -55
  155. package/src/radio-group.stories.tsx +26 -26
  156. package/src/radio-group.tsx +44 -44
  157. package/src/route-flow/editor.tsx +1087 -1014
  158. package/src/route-flow/model.ts +771 -716
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -139
  161. package/src/screen-too-small.stories.tsx +61 -61
  162. package/src/screen-too-small.tsx +104 -104
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -44
  165. package/src/select.tsx +197 -197
  166. package/src/separator.stories.tsx +34 -34
  167. package/src/separator.tsx +34 -34
  168. package/src/sheet.stories.tsx +49 -49
  169. package/src/sheet.tsx +168 -168
  170. package/src/skeleton.stories.tsx +28 -28
  171. package/src/skeleton.tsx +19 -19
  172. package/src/slider.stories.tsx +78 -78
  173. package/src/slider.tsx +300 -300
  174. package/src/spinner.stories.tsx +33 -33
  175. package/src/spinner.tsx +55 -55
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -42
  178. package/src/switch.tsx +41 -41
  179. package/src/switcher.stories.tsx +111 -111
  180. package/src/switcher.tsx +131 -131
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -48
  183. package/src/table.tsx +121 -121
  184. package/src/tabs.stories.tsx +74 -74
  185. package/src/tabs.tsx +90 -90
  186. package/src/tag-input.stories.tsx +67 -67
  187. package/src/tag-input.tsx +117 -117
  188. package/src/tenant-logo.tsx +63 -63
  189. package/src/tenant-switcher.stories.tsx +38 -38
  190. package/src/tenant-switcher.tsx +164 -164
  191. package/src/textarea.stories.tsx +27 -27
  192. package/src/textarea.tsx +18 -18
  193. package/src/theme-mode.ts +52 -52
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -62
  196. package/src/time-picker.tsx +615 -615
  197. package/src/toggle-group.tsx +138 -138
  198. package/src/tooltip.stories.tsx +43 -43
  199. package/src/tooltip.tsx +73 -73
  200. package/src/top-nav.stories.tsx +58 -58
  201. package/src/top-nav.tsx +324 -324
  202. package/src/undo-bar.tsx +107 -107
  203. package/src/utils.ts +45 -45
  204. package/src/view-toggle.stories.tsx +84 -84
  205. package/src/view-toggle.tsx +110 -110
package/src/math-text.tsx CHANGED
@@ -1,43 +1,43 @@
1
- 'use client';
2
-
3
- import 'katex/dist/katex.min.css';
4
- import katex from 'katex';
5
-
6
- export interface MathTextProps {
7
- /** LaTeX expression without surrounding $ signs */
8
- expression: string;
9
- /** Render as display (block) math; defaults to inline */
10
- block?: boolean;
11
- /** Color applied to render errors; defaults to 'inherit' */
12
- errorColor?: string;
13
- }
14
-
15
- /**
16
- * Renders a LaTeX math expression using KaTeX.
17
- *
18
- * dangerouslySetInnerHTML is safe here: KaTeX's renderToString escapes text
19
- * content and, with `trust` disabled (the default, set explicitly below),
20
- * refuses the only commands that can emit markup/URLs (\href, \url,
21
- * \includegraphics). So even a hostile `expression` cannot inject executable
22
- * HTML — KaTeX's own XSS model covers it, and no user-supplied raw HTML is ever
23
- * passed through.
24
- */
25
- export function MathText({ expression, block = false, errorColor = 'inherit' }: MathTextProps) {
26
- const html = katex.renderToString(expression, {
27
- throwOnError: false,
28
- displayMode: block,
29
- errorColor,
30
- // Explicit (KaTeX default): keep HTML/URL-emitting commands disabled so the
31
- // output stays XSS-safe. Do not enable without a sanitization pass.
32
- trust: false,
33
- });
34
-
35
- return (
36
- <span
37
- className={block ? 'block' : undefined}
38
- // KaTeX output with trust:false is XSS-safe to inject (see the doc comment).
39
- // nosemgrep: typescript.react.security.audit.react-dangerouslysetinnerhtml.react-dangerouslysetinnerhtml
40
- dangerouslySetInnerHTML={{ __html: html }}
41
- />
42
- );
43
- }
1
+ 'use client';
2
+
3
+ import 'katex/dist/katex.min.css';
4
+ import katex from 'katex';
5
+
6
+ export interface MathTextProps {
7
+ /** LaTeX expression without surrounding $ signs */
8
+ expression: string;
9
+ /** Render as display (block) math; defaults to inline */
10
+ block?: boolean;
11
+ /** Color applied to render errors; defaults to 'inherit' */
12
+ errorColor?: string;
13
+ }
14
+
15
+ /**
16
+ * Renders a LaTeX math expression using KaTeX.
17
+ *
18
+ * dangerouslySetInnerHTML is safe here: KaTeX's renderToString escapes text
19
+ * content and, with `trust` disabled (the default, set explicitly below),
20
+ * refuses the only commands that can emit markup/URLs (\href, \url,
21
+ * \includegraphics). So even a hostile `expression` cannot inject executable
22
+ * HTML — KaTeX's own XSS model covers it, and no user-supplied raw HTML is ever
23
+ * passed through.
24
+ */
25
+ export function MathText({ expression, block = false, errorColor = 'inherit' }: MathTextProps) {
26
+ const html = katex.renderToString(expression, {
27
+ throwOnError: false,
28
+ displayMode: block,
29
+ errorColor,
30
+ // Explicit (KaTeX default): keep HTML/URL-emitting commands disabled so the
31
+ // output stays XSS-safe. Do not enable without a sanitization pass.
32
+ trust: false,
33
+ });
34
+
35
+ return (
36
+ <span
37
+ className={block ? 'block' : undefined}
38
+ // KaTeX output with trust:false is XSS-safe to inject (see the doc comment).
39
+ // nosemgrep: typescript.react.security.audit.react-dangerouslysetinnerhtml.react-dangerouslysetinnerhtml
40
+ dangerouslySetInnerHTML={{ __html: html }}
41
+ />
42
+ );
43
+ }
@@ -1,198 +1,198 @@
1
- import * as React from "react"
2
- import type { Meta, StoryObj } from "@storybook/react-vite"
3
- import { IconFilePlus, IconPrinter, IconTrash, IconTypography } from "@tabler/icons-react"
4
-
5
- import { MenuBar, type MenuBarMenu } from "./menu-bar"
6
-
7
- /**
8
- * A live model: the toggles and the "last command" readout prove the menu bar is
9
- * driven entirely by the `menus` array it's handed — every `checked` and
10
- * `disabled` state below comes from this state, not from anything the menu bar
11
- * keeps for itself.
12
- */
13
- function Demo({
14
- build,
15
- }: {
16
- build: (state: {
17
- grid: boolean
18
- setGrid: (v: boolean) => void
19
- snap: boolean
20
- setSnap: (v: boolean) => void
21
- hasSelection: boolean
22
- setHasSelection: (v: boolean) => void
23
- run: (id: string) => void
24
- }) => MenuBarMenu[]
25
- }) {
26
- const [grid, setGrid] = React.useState(true)
27
- const [snap, setSnap] = React.useState(false)
28
- const [hasSelection, setHasSelection] = React.useState(false)
29
- const [last, setLast] = React.useState<string | null>(null)
30
-
31
- const menus = build({ grid, setGrid, snap, setSnap, hasSelection, setHasSelection, run: setLast })
32
-
33
- return (
34
- <div className="w-full">
35
- <div className="rounded-lg border border-border bg-card">
36
- <MenuBar menus={menus} aria-label="Demo menu" className="px-1 py-1" />
37
- </div>
38
- <p className="mt-3 text-xs text-muted-foreground">
39
- Last command: <span className="font-medium text-foreground">{last ?? "—"}</span> · grid {grid ? "on" : "off"} ·
40
- snap {snap ? "on" : "off"}
41
- </p>
42
- <button
43
- type="button"
44
- className="mt-2 rounded-md border border-input px-2 py-1 text-xs"
45
- onClick={() => setHasSelection((v) => !v)}
46
- >
47
- {hasSelection ? "Clear selection" : "Simulate a selection"} (drives the disabled items)
48
- </button>
49
- </div>
50
- )
51
- }
52
-
53
- const meta = {
54
- title: "MenuBar",
55
- component: MenuBar,
56
- tags: ["autodocs"],
57
- parameters: {
58
- docs: {
59
- description: {
60
- component:
61
- "A desktop-application menu bar (File / Edit / …) for command sets far too large for one toolbar. Built on Radix `Menubar`, so it behaves natively: roving tab focus across the menus, arrow-key traversal, hover-to-switch once a menu is open, character typeahead, Escape/click-outside dismissal and focus restoration. Prefer the declarative `menus` prop — describe commands once (a registry) and render them here, in a toolbar and in a shortcuts sheet without restating any of them.",
62
- },
63
- },
64
- },
65
- } satisfies Meta<typeof MenuBar>
66
-
67
- export default meta
68
- type Story = StoryObj<typeof meta>
69
-
70
- /** The full vocabulary: actions with shortcut hints, checkable toggles, nested
71
- * submenus, group labels, separators, disabled and destructive items. */
72
- export const Default: Story = {
73
- args: { menus: [] },
74
- render: () => (
75
- <Demo
76
- build={({ grid, setGrid, snap, setSnap, hasSelection, run }) => [
77
- {
78
- id: "file",
79
- label: "File",
80
- items: [
81
- { id: "new", label: "New", icon: <IconFilePlus />, shortcut: "Ctrl+N", onSelect: () => run("new") },
82
- { id: "save", label: "Save", shortcut: "Ctrl+S", onSelect: () => run("save") },
83
- { kind: "separator", id: "s1" },
84
- { id: "print", label: "Print…", icon: <IconPrinter />, shortcut: "Ctrl+P", onSelect: () => run("print") },
85
- { kind: "separator", id: "s2" },
86
- { id: "delete", label: "Delete document", icon: <IconTrash />, destructive: true, onSelect: () => run("delete") },
87
- ],
88
- },
89
- {
90
- id: "edit",
91
- label: "Edit",
92
- items: [
93
- { id: "undo", label: "Undo", shortcut: "Ctrl+Z", onSelect: () => run("undo") },
94
- { id: "redo", label: "Redo", shortcut: "Ctrl+Shift+Z", disabled: true, onSelect: () => run("redo") },
95
- { kind: "separator", id: "s1" },
96
- { id: "cut", label: "Cut", shortcut: "Ctrl+X", disabled: !hasSelection, onSelect: () => run("cut") },
97
- { id: "copy", label: "Copy", shortcut: "Ctrl+C", disabled: !hasSelection, onSelect: () => run("copy") },
98
- ],
99
- },
100
- {
101
- id: "insert",
102
- label: "Insert",
103
- items: [
104
- { id: "text", label: "Text", icon: <IconTypography />, onSelect: () => run("insert text") },
105
- { kind: "separator", id: "s1" },
106
- {
107
- kind: "submenu",
108
- id: "block",
109
- label: "Block",
110
- items: [
111
- { kind: "label", id: "l-sys", label: "System" },
112
- { id: "b-header", label: "Company header", onSelect: () => run("insert header block") },
113
- { kind: "label", id: "l-mine", label: "Personal" },
114
- { id: "b-addr", label: "Return address", onSelect: () => run("insert address block") },
115
- ],
116
- },
117
- {
118
- kind: "submenu",
119
- id: "empty",
120
- label: "Nothing in here",
121
- items: [],
122
- emptyLabel: "No blocks in your library",
123
- },
124
- ],
125
- },
126
- {
127
- id: "view",
128
- label: "View",
129
- items: [
130
- { kind: "checkbox", id: "grid", label: "Grid", checked: grid, onCheckedChange: setGrid },
131
- { kind: "checkbox", id: "snap", label: "Snap to grid", checked: snap, onCheckedChange: setSnap },
132
- ],
133
- },
134
- { id: "disabled-menu", label: "Unavailable", disabled: true, items: [] },
135
- ]}
136
- />
137
- ),
138
- }
139
-
140
- /** Checkable items keep the menu OPEN when toggled, so several view options can
141
- * be flipped in one visit. */
142
- export const CheckableToggles: Story = {
143
- args: { menus: [] },
144
- render: () => (
145
- <Demo
146
- build={({ grid, setGrid, snap, setSnap }) => [
147
- {
148
- id: "view",
149
- label: "View",
150
- items: [
151
- { kind: "checkbox", id: "grid", label: "Grid", checked: grid, onCheckedChange: setGrid },
152
- { kind: "checkbox", id: "snap", label: "Snap to grid & guides", checked: snap, onCheckedChange: setSnap },
153
- { kind: "separator", id: "s1" },
154
- { kind: "checkbox", id: "locked", label: "Disabled toggle", checked: false, disabled: true, onCheckedChange: () => {} },
155
- ],
156
- },
157
- ]}
158
- />
159
- ),
160
- }
161
-
162
- /** An empty submenu renders a disabled placeholder rather than opening onto
163
- * nothing — a dead end reads as a bug. */
164
- export const EmptySubmenu: Story = {
165
- args: {
166
- menus: [
167
- {
168
- id: "templates",
169
- label: "Templates",
170
- items: [
171
- {
172
- kind: "submenu",
173
- id: "open-saved",
174
- label: "Open saved",
175
- items: [],
176
- emptyLabel: "No saved templates yet",
177
- },
178
- ],
179
- },
180
- ],
181
- },
182
- }
183
-
184
- /** Many menus, as a real editor has — the bar wraps nothing and keyboard
185
- * traversal covers all of them. */
186
- export const ManyMenus: Story = {
187
- args: {
188
- menus: ["File", "Edit", "Insert", "Format", "Page", "View", "Data", "Templates", "Help"].map((label) => ({
189
- id: label.toLowerCase(),
190
- label,
191
- items: [
192
- { id: `${label}-a`, label: `${label} action`, onSelect: () => {} },
193
- { kind: "separator", id: `${label}-s` },
194
- { id: `${label}-b`, label: `Another ${label.toLowerCase()} action`, shortcut: "Ctrl+K", onSelect: () => {} },
195
- ],
196
- })),
197
- },
198
- }
1
+ import * as React from "react"
2
+ import type { Meta, StoryObj } from "@storybook/react-vite"
3
+ import { IconFilePlus, IconPrinter, IconTrash, IconTypography } from "@tabler/icons-react"
4
+
5
+ import { MenuBar, type MenuBarMenu } from "./menu-bar"
6
+
7
+ /**
8
+ * A live model: the toggles and the "last command" readout prove the menu bar is
9
+ * driven entirely by the `menus` array it's handed — every `checked` and
10
+ * `disabled` state below comes from this state, not from anything the menu bar
11
+ * keeps for itself.
12
+ */
13
+ function Demo({
14
+ build,
15
+ }: {
16
+ build: (state: {
17
+ grid: boolean
18
+ setGrid: (v: boolean) => void
19
+ snap: boolean
20
+ setSnap: (v: boolean) => void
21
+ hasSelection: boolean
22
+ setHasSelection: (v: boolean) => void
23
+ run: (id: string) => void
24
+ }) => MenuBarMenu[]
25
+ }) {
26
+ const [grid, setGrid] = React.useState(true)
27
+ const [snap, setSnap] = React.useState(false)
28
+ const [hasSelection, setHasSelection] = React.useState(false)
29
+ const [last, setLast] = React.useState<string | null>(null)
30
+
31
+ const menus = build({ grid, setGrid, snap, setSnap, hasSelection, setHasSelection, run: setLast })
32
+
33
+ return (
34
+ <div className="w-full">
35
+ <div className="rounded-lg border border-border bg-card">
36
+ <MenuBar menus={menus} aria-label="Demo menu" className="px-1 py-1" />
37
+ </div>
38
+ <p className="mt-3 text-xs text-muted-foreground">
39
+ Last command: <span className="font-medium text-foreground">{last ?? "—"}</span> · grid {grid ? "on" : "off"} ·
40
+ snap {snap ? "on" : "off"}
41
+ </p>
42
+ <button
43
+ type="button"
44
+ className="mt-2 rounded-md border border-input px-2 py-1 text-xs"
45
+ onClick={() => setHasSelection((v) => !v)}
46
+ >
47
+ {hasSelection ? "Clear selection" : "Simulate a selection"} (drives the disabled items)
48
+ </button>
49
+ </div>
50
+ )
51
+ }
52
+
53
+ const meta = {
54
+ title: "MenuBar",
55
+ component: MenuBar,
56
+ tags: ["autodocs"],
57
+ parameters: {
58
+ docs: {
59
+ description: {
60
+ component:
61
+ "A desktop-application menu bar (File / Edit / …) for command sets far too large for one toolbar. Built on Radix `Menubar`, so it behaves natively: roving tab focus across the menus, arrow-key traversal, hover-to-switch once a menu is open, character typeahead, Escape/click-outside dismissal and focus restoration. Prefer the declarative `menus` prop — describe commands once (a registry) and render them here, in a toolbar and in a shortcuts sheet without restating any of them.",
62
+ },
63
+ },
64
+ },
65
+ } satisfies Meta<typeof MenuBar>
66
+
67
+ export default meta
68
+ type Story = StoryObj<typeof meta>
69
+
70
+ /** The full vocabulary: actions with shortcut hints, checkable toggles, nested
71
+ * submenus, group labels, separators, disabled and destructive items. */
72
+ export const Default: Story = {
73
+ args: { menus: [] },
74
+ render: () => (
75
+ <Demo
76
+ build={({ grid, setGrid, snap, setSnap, hasSelection, run }) => [
77
+ {
78
+ id: "file",
79
+ label: "File",
80
+ items: [
81
+ { id: "new", label: "New", icon: <IconFilePlus />, shortcut: "Ctrl+N", onSelect: () => run("new") },
82
+ { id: "save", label: "Save", shortcut: "Ctrl+S", onSelect: () => run("save") },
83
+ { kind: "separator", id: "s1" },
84
+ { id: "print", label: "Print…", icon: <IconPrinter />, shortcut: "Ctrl+P", onSelect: () => run("print") },
85
+ { kind: "separator", id: "s2" },
86
+ { id: "delete", label: "Delete document", icon: <IconTrash />, destructive: true, onSelect: () => run("delete") },
87
+ ],
88
+ },
89
+ {
90
+ id: "edit",
91
+ label: "Edit",
92
+ items: [
93
+ { id: "undo", label: "Undo", shortcut: "Ctrl+Z", onSelect: () => run("undo") },
94
+ { id: "redo", label: "Redo", shortcut: "Ctrl+Shift+Z", disabled: true, onSelect: () => run("redo") },
95
+ { kind: "separator", id: "s1" },
96
+ { id: "cut", label: "Cut", shortcut: "Ctrl+X", disabled: !hasSelection, onSelect: () => run("cut") },
97
+ { id: "copy", label: "Copy", shortcut: "Ctrl+C", disabled: !hasSelection, onSelect: () => run("copy") },
98
+ ],
99
+ },
100
+ {
101
+ id: "insert",
102
+ label: "Insert",
103
+ items: [
104
+ { id: "text", label: "Text", icon: <IconTypography />, onSelect: () => run("insert text") },
105
+ { kind: "separator", id: "s1" },
106
+ {
107
+ kind: "submenu",
108
+ id: "block",
109
+ label: "Block",
110
+ items: [
111
+ { kind: "label", id: "l-sys", label: "System" },
112
+ { id: "b-header", label: "Company header", onSelect: () => run("insert header block") },
113
+ { kind: "label", id: "l-mine", label: "Personal" },
114
+ { id: "b-addr", label: "Return address", onSelect: () => run("insert address block") },
115
+ ],
116
+ },
117
+ {
118
+ kind: "submenu",
119
+ id: "empty",
120
+ label: "Nothing in here",
121
+ items: [],
122
+ emptyLabel: "No blocks in your library",
123
+ },
124
+ ],
125
+ },
126
+ {
127
+ id: "view",
128
+ label: "View",
129
+ items: [
130
+ { kind: "checkbox", id: "grid", label: "Grid", checked: grid, onCheckedChange: setGrid },
131
+ { kind: "checkbox", id: "snap", label: "Snap to grid", checked: snap, onCheckedChange: setSnap },
132
+ ],
133
+ },
134
+ { id: "disabled-menu", label: "Unavailable", disabled: true, items: [] },
135
+ ]}
136
+ />
137
+ ),
138
+ }
139
+
140
+ /** Checkable items keep the menu OPEN when toggled, so several view options can
141
+ * be flipped in one visit. */
142
+ export const CheckableToggles: Story = {
143
+ args: { menus: [] },
144
+ render: () => (
145
+ <Demo
146
+ build={({ grid, setGrid, snap, setSnap }) => [
147
+ {
148
+ id: "view",
149
+ label: "View",
150
+ items: [
151
+ { kind: "checkbox", id: "grid", label: "Grid", checked: grid, onCheckedChange: setGrid },
152
+ { kind: "checkbox", id: "snap", label: "Snap to grid & guides", checked: snap, onCheckedChange: setSnap },
153
+ { kind: "separator", id: "s1" },
154
+ { kind: "checkbox", id: "locked", label: "Disabled toggle", checked: false, disabled: true, onCheckedChange: () => {} },
155
+ ],
156
+ },
157
+ ]}
158
+ />
159
+ ),
160
+ }
161
+
162
+ /** An empty submenu renders a disabled placeholder rather than opening onto
163
+ * nothing — a dead end reads as a bug. */
164
+ export const EmptySubmenu: Story = {
165
+ args: {
166
+ menus: [
167
+ {
168
+ id: "templates",
169
+ label: "Templates",
170
+ items: [
171
+ {
172
+ kind: "submenu",
173
+ id: "open-saved",
174
+ label: "Open saved",
175
+ items: [],
176
+ emptyLabel: "No saved templates yet",
177
+ },
178
+ ],
179
+ },
180
+ ],
181
+ },
182
+ }
183
+
184
+ /** Many menus, as a real editor has — the bar wraps nothing and keyboard
185
+ * traversal covers all of them. */
186
+ export const ManyMenus: Story = {
187
+ args: {
188
+ menus: ["File", "Edit", "Insert", "Format", "Page", "View", "Data", "Templates", "Help"].map((label) => ({
189
+ id: label.toLowerCase(),
190
+ label,
191
+ items: [
192
+ { id: `${label}-a`, label: `${label} action`, onSelect: () => {} },
193
+ { kind: "separator", id: `${label}-s` },
194
+ { id: `${label}-b`, label: `Another ${label.toLowerCase()} action`, shortcut: "Ctrl+K", onSelect: () => {} },
195
+ ],
196
+ })),
197
+ },
198
+ }