@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.
- package/README.md +107 -107
- package/package.json +221 -192
- package/src/access-denied.stories.tsx +179 -179
- package/src/access-denied.tsx +305 -305
- package/src/action-proposal.tsx +338 -302
- package/src/actor-chip.tsx +71 -71
- package/src/agent-activity.tsx +163 -163
- package/src/agent-collaboration.stories.tsx +156 -156
- package/src/agent-run-status.tsx +196 -196
- package/src/alert-dialog.stories.tsx +45 -45
- package/src/alert-dialog.tsx +147 -147
- package/src/alert.stories.tsx +91 -91
- package/src/alert.tsx +89 -89
- package/src/app-sidebar.stories.tsx +195 -195
- package/src/app-sidebar.tsx +604 -500
- package/src/approval-queue.tsx +109 -108
- package/src/audience-group-picker.stories.tsx +198 -198
- package/src/audience-group-picker.tsx +362 -362
- package/src/audience-people-picker.stories.tsx +102 -102
- package/src/audience-people-picker.tsx +279 -279
- package/src/avatar-pattern.ts +138 -0
- package/src/avatar.tsx +125 -83
- package/src/badge.stories.tsx +105 -105
- package/src/badge.tsx +68 -68
- package/src/beta-warning.stories.tsx +79 -79
- package/src/beta-warning.tsx +189 -189
- package/src/bilingual-input.stories.tsx +82 -82
- package/src/bilingual-input.tsx +188 -183
- package/src/board.tsx +216 -0
- package/src/breadcrumb.stories.tsx +51 -51
- package/src/breadcrumb.tsx +90 -90
- package/src/built-on-whity.tsx +52 -0
- package/src/button.stories.tsx +87 -87
- package/src/button.tsx +123 -118
- package/src/card.stories.tsx +423 -423
- package/src/card.tsx +180 -180
- package/src/chart.stories.tsx +66 -66
- package/src/chart.tsx +228 -228
- package/src/checkbox.stories.tsx +62 -62
- package/src/checkbox.tsx +54 -54
- package/src/collapsible.stories.tsx +48 -48
- package/src/collapsible.tsx +34 -34
- package/src/color-card.stories.tsx +61 -61
- package/src/color-card.tsx +270 -270
- package/src/color-picker.stories.tsx +65 -65
- package/src/color-picker.tsx +425 -425
- package/src/column-matcher.tsx +84 -0
- package/src/command-palette.tsx +398 -306
- package/src/confirm-action.tsx +98 -0
- package/src/copy-block.stories.tsx +38 -38
- package/src/copy-block.tsx +85 -85
- package/src/data-table.stories.tsx +200 -200
- package/src/data-table.tsx +1686 -1106
- package/src/date-picker.stories.tsx +61 -61
- package/src/date-picker.tsx +456 -422
- package/src/design-cards.stories.tsx +551 -458
- package/src/dialog.stories.tsx +48 -48
- package/src/dialog.tsx +179 -166
- package/src/display-preferences.tsx +50 -0
- package/src/documents/barcode-svg.stories.tsx +72 -72
- package/src/documents/barcode-svg.tsx +79 -79
- package/src/dropdown-menu.stories.tsx +77 -77
- package/src/dropdown-menu.tsx +271 -271
- 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 -279
- package/src/editor/block-ids.ts +44 -44
- package/src/editor/block-list.tsx +104 -101
- package/src/editor/block-toolbar.tsx +490 -477
- package/src/editor/bubble.tsx +119 -93
- package/src/editor/catalogue.ts +169 -103
- package/src/editor/collab-rail.tsx +746 -746
- package/src/editor/collab.stories.tsx +207 -207
- package/src/editor/collab.ts +87 -87
- package/src/editor/contract.ts +476 -408
- package/src/editor/convert.ts +414 -362
- package/src/editor/doc-editor.stories.tsx +98 -98
- package/src/editor/doc-editor.tsx +1492 -1287
- package/src/editor/editor.css +636 -536
- package/src/editor/extensions.ts +86 -86
- package/src/editor/field-bar.tsx +154 -0
- package/src/editor/field-picker.tsx +109 -107
- package/src/editor/fields.ts +100 -100
- package/src/editor/gutter.tsx +443 -367
- package/src/editor/index.ts +23 -22
- package/src/editor/label-sheet.tsx +289 -289
- package/src/editor/labels.ts +394 -310
- package/src/editor/link-tools.tsx +141 -141
- package/src/editor/node-views.tsx +461 -450
- package/src/editor/page-view.tsx +372 -353
- 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 -182
- package/src/editor/rich-blocks.stories.tsx +146 -146
- package/src/editor/sample.ts +40 -40
- 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 -150
- package/src/editor/schema.ts +368 -315
- package/src/editor/services.tsx +205 -127
- package/src/editor/slash.ts +64 -64
- package/src/editor/suggesting.ts +372 -372
- package/src/editor/suggestions.ts +763 -763
- package/src/editor/table-keys.ts +66 -66
- package/src/editor/templates.stories.tsx +324 -324
- package/src/editor/toolbar.tsx +364 -358
- package/src/empty-state.stories.tsx +51 -51
- package/src/empty-state.tsx +126 -100
- package/src/empty-state.usage-notes.md +30 -30
- package/src/form.stories.tsx +112 -112
- package/src/form.tsx +176 -176
- package/src/globals.css +20 -20
- package/src/icon-button.tsx +85 -85
- package/src/icon-map.ts +335 -244
- package/src/icon.tsx +41 -41
- package/src/index.ts +90 -67
- package/src/input.stories.tsx +157 -157
- package/src/input.tsx +768 -759
- package/src/kpi-strip.tsx +47 -0
- package/src/localized-text.ts +76 -0
- package/src/locked-screen.stories.tsx +29 -29
- package/src/locked-screen.tsx +75 -61
- package/src/lockup.tsx +42 -0
- package/src/lottie.tsx +441 -0
- package/src/mark.tsx +62 -62
- package/src/math-text.stories.tsx +33 -33
- package/src/math-text.tsx +43 -43
- package/src/menu-bar.stories.tsx +198 -198
- package/src/menu-bar.tsx +373 -373
- package/src/message-thread.tsx +181 -0
- package/src/money/currency.ts +244 -230
- 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 -95
- package/src/page-header.tsx +122 -122
- package/src/page-shell.stories.tsx +42 -42
- package/src/page-shell.tsx +32 -32
- package/src/page-states.tsx +277 -0
- package/src/pagination.stories.tsx +45 -45
- package/src/pagination.tsx +98 -98
- 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 -180
- package/src/plugin-card.tsx +931 -848
- package/src/popover.stories.tsx +48 -48
- package/src/popover.tsx +55 -55
- package/src/radio-group.stories.tsx +26 -26
- package/src/radio-group.tsx +44 -44
- package/src/route-flow/editor.tsx +1087 -1014
- package/src/route-flow/model.ts +771 -716
- package/src/save-bar.tsx +94 -0
- package/src/scope-grant.tsx +139 -139
- package/src/screen-too-small.stories.tsx +61 -61
- package/src/screen-too-small.tsx +104 -104
- package/src/search-field.tsx +65 -0
- package/src/select.stories.tsx +44 -44
- package/src/select.tsx +197 -197
- package/src/separator.stories.tsx +34 -34
- package/src/separator.tsx +34 -34
- package/src/sheet.stories.tsx +49 -49
- package/src/sheet.tsx +168 -168
- package/src/skeleton.stories.tsx +28 -28
- package/src/skeleton.tsx +19 -19
- package/src/slider.stories.tsx +78 -78
- package/src/slider.tsx +300 -300
- package/src/spinner.stories.tsx +33 -33
- package/src/spinner.tsx +55 -55
- package/src/stepper.tsx +85 -0
- package/src/switch.stories.tsx +42 -42
- package/src/switch.tsx +41 -41
- package/src/switcher.stories.tsx +111 -111
- package/src/switcher.tsx +131 -131
- package/src/system-state.tsx +55 -0
- package/src/table.stories.tsx +48 -48
- package/src/table.tsx +121 -121
- package/src/tabs.stories.tsx +74 -74
- package/src/tabs.tsx +90 -90
- package/src/tag-input.stories.tsx +67 -67
- package/src/tag-input.tsx +117 -117
- package/src/tenant-logo.tsx +63 -63
- package/src/tenant-switcher.stories.tsx +38 -38
- package/src/tenant-switcher.tsx +164 -164
- package/src/textarea.stories.tsx +27 -27
- package/src/textarea.tsx +18 -18
- package/src/theme-mode.ts +52 -52
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -62
- package/src/time-picker.tsx +615 -615
- package/src/toggle-group.tsx +138 -138
- package/src/tooltip.stories.tsx +43 -43
- package/src/tooltip.tsx +73 -73
- package/src/top-nav.stories.tsx +58 -58
- package/src/top-nav.tsx +324 -324
- package/src/undo-bar.tsx +107 -107
- package/src/utils.ts +45 -45
- package/src/view-toggle.stories.tsx +84 -84
- 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
|
+
}
|
package/src/menu-bar.stories.tsx
CHANGED
|
@@ -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
|
+
}
|