@whity/ui 0.5.0 → 1.0.1
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 +223 -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 +125 -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 +399 -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 +1687 -1106
- package/src/date-picker.stories.tsx +61 -61
- package/src/date-picker.tsx +457 -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 +59 -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 +92 -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-input.tsx +252 -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/role-summary.stories.tsx +143 -0
- package/src/role-summary.tsx +120 -0
- 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 +185 -164
- package/src/textarea.stories.tsx +27 -27
- package/src/textarea.tsx +18 -18
- package/src/theme-mode.ts +74 -52
- package/src/time-grid.tsx +163 -0
- package/src/time-picker.stories.tsx +62 -62
- package/src/time-picker.tsx +616 -615
- package/src/toggle-group.tsx +139 -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 +111 -110
package/src/command-palette.tsx
CHANGED
|
@@ -1,306 +1,399 @@
|
|
|
1
|
-
"use client"
|
|
2
|
-
|
|
3
|
-
import * as React from "react"
|
|
4
|
-
|
|
5
|
-
import { cn } from "./utils"
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* A searchable, keyboard-driven command list — the `/` or Ctrl-K surface.
|
|
9
|
-
*
|
|
10
|
-
* BUILT FROM PRIMITIVES RATHER THAN `cmdk`. The platform's stated selling
|
|
11
|
-
* point is a lean, near-zero-dependency stack (ADR 0003), and what a palette
|
|
12
|
-
* actually needs — filter a list, move a cursor, run a callback — is less code
|
|
13
|
-
* than the wiring a dependency would take. Nothing here is novel; the value is
|
|
14
|
-
* in not owing anyone an upgrade for it.
|
|
15
|
-
*
|
|
16
|
-
* PRESENTATIONAL AND CONTROLLED. It holds the query and the cursor, because
|
|
17
|
-
* those die with the dialog; it holds no notion of what a command IS. The
|
|
18
|
-
* caller supplies items and decides what running one means, which is what lets
|
|
19
|
-
* the document designer feed it a flattened menu registry while another screen
|
|
20
|
-
* feeds it something else entirely.
|
|
21
|
-
*
|
|
22
|
-
* COPY ARRIVES AS PROPS, with English defaults, for the reason every component
|
|
23
|
-
* in this package does: `@whity/ui` is published standalone and may not
|
|
24
|
-
* depend on the i18n feature (#758). Translating is the consumer's job.
|
|
25
|
-
*/
|
|
26
|
-
|
|
27
|
-
export interface CommandPaletteItem {
|
|
28
|
-
id: string
|
|
29
|
-
label: string
|
|
30
|
-
/** Heading this item sits under. Items are shown in the order given, grouped by first appearance. */
|
|
31
|
-
group?: string
|
|
32
|
-
/** Rendered right-aligned, e.g. "Ctrl+S". Never used for matching. */
|
|
33
|
-
shortcut?: string
|
|
34
|
-
icon?: React.ReactNode
|
|
35
|
-
/**
|
|
36
|
-
* Extra words that should MATCH but need not be shown — a block's scope, an
|
|
37
|
-
* element's other name ("picture" finding "image").
|
|
38
|
-
*/
|
|
39
|
-
keywords?: string
|
|
40
|
-
/**
|
|
41
|
-
* Shown greyed and skipped by the cursor, never hidden.
|
|
42
|
-
*
|
|
43
|
-
* A command absent from the list reads as "this editor cannot do that"; a
|
|
44
|
-
* command present and greyed reads as "not right now", which is the true
|
|
45
|
-
* statement and the one that stops somebody hunting through menus for
|
|
46
|
-
* something that was never going to be available.
|
|
47
|
-
*/
|
|
48
|
-
disabled?: boolean
|
|
49
|
-
/**
|
|
50
|
-
* Secondary words after the label, never matched against ("
|
|
51
|
-
* overdue"): what tells two records with similar names apart.
|
|
52
|
-
*/
|
|
53
|
-
hint?: string
|
|
54
|
-
/**
|
|
55
|
-
* Shown whatever the query, and not filtered by it: the "Ask an agent" row,
|
|
56
|
-
* which takes the words as they are (register 2.1c).
|
|
57
|
-
*/
|
|
58
|
-
always?: boolean
|
|
59
|
-
/** An agent row: dashed, because nothing has happened until a person approves. */
|
|
60
|
-
agent?: boolean
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
/**
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
}
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
return
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
1
|
+
"use client"
|
|
2
|
+
|
|
3
|
+
import * as React from "react"
|
|
4
|
+
|
|
5
|
+
import { cn } from "./utils"
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* A searchable, keyboard-driven command list — the `/` or Ctrl-K surface.
|
|
9
|
+
*
|
|
10
|
+
* BUILT FROM PRIMITIVES RATHER THAN `cmdk`. The platform's stated selling
|
|
11
|
+
* point is a lean, near-zero-dependency stack (ADR 0003), and what a palette
|
|
12
|
+
* actually needs — filter a list, move a cursor, run a callback — is less code
|
|
13
|
+
* than the wiring a dependency would take. Nothing here is novel; the value is
|
|
14
|
+
* in not owing anyone an upgrade for it.
|
|
15
|
+
*
|
|
16
|
+
* PRESENTATIONAL AND CONTROLLED. It holds the query and the cursor, because
|
|
17
|
+
* those die with the dialog; it holds no notion of what a command IS. The
|
|
18
|
+
* caller supplies items and decides what running one means, which is what lets
|
|
19
|
+
* the document designer feed it a flattened menu registry while another screen
|
|
20
|
+
* feeds it something else entirely.
|
|
21
|
+
*
|
|
22
|
+
* COPY ARRIVES AS PROPS, with English defaults, for the reason every component
|
|
23
|
+
* in this package does: `@whity/ui` is published standalone and may not
|
|
24
|
+
* depend on the i18n feature (#758). Translating is the consumer's job.
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
export interface CommandPaletteItem {
|
|
28
|
+
id: string
|
|
29
|
+
label: string
|
|
30
|
+
/** Heading this item sits under. Items are shown in the order given, grouped by first appearance. */
|
|
31
|
+
group?: string
|
|
32
|
+
/** Rendered right-aligned, e.g. "Ctrl+S". Never used for matching. */
|
|
33
|
+
shortcut?: string
|
|
34
|
+
icon?: React.ReactNode
|
|
35
|
+
/**
|
|
36
|
+
* Extra words that should MATCH but need not be shown — a block's scope, an
|
|
37
|
+
* element's other name ("picture" finding "image").
|
|
38
|
+
*/
|
|
39
|
+
keywords?: string
|
|
40
|
+
/**
|
|
41
|
+
* Shown greyed and skipped by the cursor, never hidden.
|
|
42
|
+
*
|
|
43
|
+
* A command absent from the list reads as "this editor cannot do that"; a
|
|
44
|
+
* command present and greyed reads as "not right now", which is the true
|
|
45
|
+
* statement and the one that stops somebody hunting through menus for
|
|
46
|
+
* something that was never going to be available.
|
|
47
|
+
*/
|
|
48
|
+
disabled?: boolean
|
|
49
|
+
/**
|
|
50
|
+
* Secondary words after the label, never matched against ("$301.60 ·
|
|
51
|
+
* overdue"): what tells two records with similar names apart.
|
|
52
|
+
*/
|
|
53
|
+
hint?: string
|
|
54
|
+
/**
|
|
55
|
+
* Shown whatever the query, and not filtered by it: the "Ask an agent" row,
|
|
56
|
+
* which takes the words as they are (register 2.1c).
|
|
57
|
+
*/
|
|
58
|
+
always?: boolean
|
|
59
|
+
/** An agent row: dashed, because nothing has happened until a person approves. */
|
|
60
|
+
agent?: boolean
|
|
61
|
+
/**
|
|
62
|
+
* Keep the palette open after `onSelect`: picking a command that still needs
|
|
63
|
+
* its details (`/go` then a screen) only changes the query.
|
|
64
|
+
*/
|
|
65
|
+
keepOpen?: boolean
|
|
66
|
+
/**
|
|
67
|
+
* What Tab does on this row: complete it into the query (`/ne` becomes
|
|
68
|
+
* `/new `). Without it, Tab leaves the palette's own keys alone.
|
|
69
|
+
*/
|
|
70
|
+
onComplete?: () => void
|
|
71
|
+
onSelect: () => void
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export interface CommandPaletteProps {
|
|
75
|
+
open: boolean
|
|
76
|
+
onOpenChange: (open: boolean) => void
|
|
77
|
+
items: CommandPaletteItem[]
|
|
78
|
+
placeholder?: string
|
|
79
|
+
emptyLabel?: string
|
|
80
|
+
/** Accessible name for the dialog. */
|
|
81
|
+
label?: string
|
|
82
|
+
/**
|
|
83
|
+
* Called as the query changes, so the caller can fetch results (records
|
|
84
|
+
* from search) and pass them back in `items`. Items the caller supplies
|
|
85
|
+
* this way are still filtered here, so return what the server matched.
|
|
86
|
+
*/
|
|
87
|
+
onQueryChange?: (query: string) => void
|
|
88
|
+
/** The keys row at the foot. Omit to hide it. */
|
|
89
|
+
footer?: { move: string; open: string; close: string; complete?: string }
|
|
90
|
+
/**
|
|
91
|
+
* The query, when the caller owns it (commands rewrite it: Tab completes
|
|
92
|
+
* `/ne` into `/new `). Omit to let the palette keep its own. A controlled
|
|
93
|
+
* caller resets it on open itself.
|
|
94
|
+
*/
|
|
95
|
+
query?: string
|
|
96
|
+
/**
|
|
97
|
+
* False when the caller has already chosen what matches (command mode
|
|
98
|
+
* parses the query itself, so a substring test here would hide `/new
|
|
99
|
+
* document` behind the words after it).
|
|
100
|
+
*/
|
|
101
|
+
filter?: boolean
|
|
102
|
+
/** A chip before the input naming the mode, e.g. "Commands". */
|
|
103
|
+
mode?: string
|
|
104
|
+
/**
|
|
105
|
+
* Read out after the list changes ("6 results"), so a screen-reader user
|
|
106
|
+
* hears that typing did something. Omit for silence.
|
|
107
|
+
*/
|
|
108
|
+
countLabel?: (count: number) => string
|
|
109
|
+
/**
|
|
110
|
+
* Type a slash for the person when they press the slash KEY on an empty
|
|
111
|
+
* box, whatever their layout: on the Arabic layout that key types "ظ", and
|
|
112
|
+
* `/` is how commands start.
|
|
113
|
+
*/
|
|
114
|
+
slashKey?: boolean
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** Case-insensitive subsequence-free substring match over label + keywords. */
|
|
118
|
+
function matches(item: CommandPaletteItem, query: string): boolean {
|
|
119
|
+
if (query === "" || item.always === true) return true
|
|
120
|
+
const q = query.toLowerCase()
|
|
121
|
+
return (
|
|
122
|
+
item.label.toLowerCase().includes(q) ||
|
|
123
|
+
(item.group?.toLowerCase().includes(q) ?? false) ||
|
|
124
|
+
(item.keywords?.toLowerCase().includes(q) ?? false)
|
|
125
|
+
)
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
export function CommandPalette({
|
|
129
|
+
open,
|
|
130
|
+
onOpenChange,
|
|
131
|
+
items,
|
|
132
|
+
placeholder = "Type a command…",
|
|
133
|
+
emptyLabel = "No matching command",
|
|
134
|
+
label = "Command palette",
|
|
135
|
+
onQueryChange,
|
|
136
|
+
footer,
|
|
137
|
+
query: controlledQuery,
|
|
138
|
+
filter = true,
|
|
139
|
+
mode,
|
|
140
|
+
countLabel,
|
|
141
|
+
slashKey = false,
|
|
142
|
+
}: CommandPaletteProps) {
|
|
143
|
+
const [ownQuery, setOwnQuery] = React.useState("")
|
|
144
|
+
const query = controlledQuery ?? ownQuery
|
|
145
|
+
const setQuery = (next: string) => {
|
|
146
|
+
if (controlledQuery === undefined) setOwnQuery(next)
|
|
147
|
+
onQueryChange?.(next)
|
|
148
|
+
}
|
|
149
|
+
const [cursor, setCursor] = React.useState(0)
|
|
150
|
+
const inputRef = React.useRef<HTMLInputElement>(null)
|
|
151
|
+
const listRef = React.useRef<HTMLDivElement>(null)
|
|
152
|
+
|
|
153
|
+
const shown = React.useMemo(
|
|
154
|
+
() => (filter ? items.filter((i) => matches(i, query)) : items),
|
|
155
|
+
[items, query, filter]
|
|
156
|
+
)
|
|
157
|
+
|
|
158
|
+
// The indices the cursor may land on. A disabled item is displayed but never
|
|
159
|
+
// selected, so navigation skips it rather than stopping on something Enter
|
|
160
|
+
// would silently ignore.
|
|
161
|
+
const selectable = React.useMemo(
|
|
162
|
+
() => shown.map((item, index) => (item.disabled === true ? -1 : index)).filter((i) => i >= 0),
|
|
163
|
+
[shown]
|
|
164
|
+
)
|
|
165
|
+
|
|
166
|
+
// Reset on open, and whenever the query changes the previous cursor is
|
|
167
|
+
// meaningless — it pointed into a different list.
|
|
168
|
+
React.useEffect(() => {
|
|
169
|
+
if (open) {
|
|
170
|
+
setOwnQuery("")
|
|
171
|
+
setCursor(0)
|
|
172
|
+
// Focus after paint; the input does not exist until this renders.
|
|
173
|
+
const id = requestAnimationFrame(() => inputRef.current?.focus())
|
|
174
|
+
return () => cancelAnimationFrame(id)
|
|
175
|
+
}
|
|
176
|
+
return undefined
|
|
177
|
+
}, [open])
|
|
178
|
+
|
|
179
|
+
React.useEffect(() => {
|
|
180
|
+
setCursor(selectable[0] ?? 0)
|
|
181
|
+
}, [query, selectable])
|
|
182
|
+
|
|
183
|
+
// Escape at the DOCUMENT level, not only on the dialog.
|
|
184
|
+
//
|
|
185
|
+
// Focus arrives a frame late (the input does not exist until this renders),
|
|
186
|
+
// so an Escape pressed in that gap would reach whatever had focus before —
|
|
187
|
+
// in the document designer, a window handler that deselects the canvas — and
|
|
188
|
+
// the palette would stay open having eaten the keystroke. Rare, and exactly
|
|
189
|
+
// the kind of race that shows up as a flaky test rather than a bug report.
|
|
190
|
+
React.useEffect(() => {
|
|
191
|
+
if (!open) return undefined;
|
|
192
|
+
const onEscape = (e: KeyboardEvent) => {
|
|
193
|
+
if (e.key !== 'Escape') return
|
|
194
|
+
e.preventDefault()
|
|
195
|
+
e.stopPropagation()
|
|
196
|
+
onOpenChange(false)
|
|
197
|
+
}
|
|
198
|
+
// Capture phase: ahead of any window listener the host already has.
|
|
199
|
+
document.addEventListener('keydown', onEscape, true)
|
|
200
|
+
return () => document.removeEventListener('keydown', onEscape, true)
|
|
201
|
+
}, [open, onOpenChange])
|
|
202
|
+
|
|
203
|
+
// Keep the highlighted row in view when arrowing past the fold.
|
|
204
|
+
React.useEffect(() => {
|
|
205
|
+
if (!open) return
|
|
206
|
+
const el = listRef.current?.querySelector<HTMLElement>(`[data-index="${cursor}"]`)
|
|
207
|
+
el?.scrollIntoView({ block: "nearest" })
|
|
208
|
+
}, [cursor, open])
|
|
209
|
+
|
|
210
|
+
if (!open) return null
|
|
211
|
+
|
|
212
|
+
const step = (delta: number) => {
|
|
213
|
+
if (selectable.length === 0) return
|
|
214
|
+
const at = selectable.indexOf(cursor)
|
|
215
|
+
const next = at === -1 ? 0 : (at + delta + selectable.length) % selectable.length
|
|
216
|
+
setCursor(selectable[next])
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
const run = (item: CommandPaletteItem | undefined) => {
|
|
220
|
+
if (!item || item.disabled === true) return
|
|
221
|
+
// Close FIRST. A command that opens a dialog of its own would otherwise
|
|
222
|
+
// find this one still mounted and fighting it for focus.
|
|
223
|
+
if (item.keepOpen !== true) onOpenChange(false)
|
|
224
|
+
item.onSelect()
|
|
225
|
+
if (item.keepOpen === true) inputRef.current?.focus()
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
const onKeyDown = (e: React.KeyboardEvent) => {
|
|
229
|
+
if (e.key === "ArrowDown") {
|
|
230
|
+
e.preventDefault()
|
|
231
|
+
step(1)
|
|
232
|
+
return
|
|
233
|
+
}
|
|
234
|
+
if (e.key === "ArrowUp") {
|
|
235
|
+
e.preventDefault()
|
|
236
|
+
step(-1)
|
|
237
|
+
return
|
|
238
|
+
}
|
|
239
|
+
if (e.key === "Enter") {
|
|
240
|
+
e.preventDefault()
|
|
241
|
+
run(shown[cursor])
|
|
242
|
+
return
|
|
243
|
+
}
|
|
244
|
+
if (e.key === "Tab" && !e.shiftKey) {
|
|
245
|
+
const item = shown[cursor]
|
|
246
|
+
if (item?.onComplete !== undefined && item.disabled !== true) {
|
|
247
|
+
e.preventDefault()
|
|
248
|
+
item.onComplete()
|
|
249
|
+
inputRef.current?.focus()
|
|
250
|
+
}
|
|
251
|
+
return
|
|
252
|
+
}
|
|
253
|
+
if (e.key === "Home" || e.key === "End") {
|
|
254
|
+
if (selectable.length === 0 || query !== "") return
|
|
255
|
+
e.preventDefault()
|
|
256
|
+
setCursor(e.key === "Home" ? selectable[0] : selectable[selectable.length - 1])
|
|
257
|
+
return
|
|
258
|
+
}
|
|
259
|
+
if (
|
|
260
|
+
slashKey &&
|
|
261
|
+
query === "" &&
|
|
262
|
+
e.code === "Slash" &&
|
|
263
|
+
e.key !== "/" &&
|
|
264
|
+
!e.ctrlKey &&
|
|
265
|
+
!e.metaKey &&
|
|
266
|
+
!e.altKey
|
|
267
|
+
) {
|
|
268
|
+
e.preventDefault()
|
|
269
|
+
setQuery("/")
|
|
270
|
+
return
|
|
271
|
+
}
|
|
272
|
+
if (e.key === "Escape") {
|
|
273
|
+
e.preventDefault()
|
|
274
|
+
onOpenChange(false)
|
|
275
|
+
}
|
|
276
|
+
// Everything else falls through to the input, including "/" — a palette
|
|
277
|
+
// you cannot type a slash into would be unable to search for anything
|
|
278
|
+
// named with one.
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
let lastGroup: string | undefined
|
|
282
|
+
|
|
283
|
+
return (
|
|
284
|
+
<div
|
|
285
|
+
className="fixed inset-0 z-50 flex items-start justify-center bg-foreground/30 px-4 pt-[12vh]"
|
|
286
|
+
// A backdrop click closes, matching every other dismissible surface. The
|
|
287
|
+
// dialog itself stops propagation below.
|
|
288
|
+
onMouseDown={() => onOpenChange(false)}
|
|
289
|
+
data-testid="command-palette-backdrop"
|
|
290
|
+
>
|
|
291
|
+
<div
|
|
292
|
+
role="dialog"
|
|
293
|
+
aria-modal="true"
|
|
294
|
+
aria-label={label}
|
|
295
|
+
data-slot="command-palette"
|
|
296
|
+
className="w-full max-w-xl overflow-hidden rounded-2xl border border-border bg-popover text-popover-foreground shadow-float"
|
|
297
|
+
onMouseDown={(e) => e.stopPropagation()}
|
|
298
|
+
onKeyDown={onKeyDown}
|
|
299
|
+
data-testid="command-palette"
|
|
300
|
+
>
|
|
301
|
+
<div className="flex items-center gap-2 border-b border-border px-4">
|
|
302
|
+
{mode !== undefined && (
|
|
303
|
+
<span
|
|
304
|
+
className="shrink-0 rounded-md bg-primary-tint px-2 py-0.5 text-xs font-medium text-primary-tint-foreground"
|
|
305
|
+
data-testid="command-palette-mode"
|
|
306
|
+
>
|
|
307
|
+
{mode}
|
|
308
|
+
</span>
|
|
309
|
+
)}
|
|
310
|
+
<input
|
|
311
|
+
ref={inputRef}
|
|
312
|
+
value={query}
|
|
313
|
+
onChange={(e) => setQuery(e.target.value)}
|
|
314
|
+
placeholder={placeholder}
|
|
315
|
+
aria-label={label}
|
|
316
|
+
role="combobox"
|
|
317
|
+
aria-expanded
|
|
318
|
+
aria-controls="command-palette-list"
|
|
319
|
+
aria-activedescendant={shown[cursor] ? `command-item-${shown[cursor].id}` : undefined}
|
|
320
|
+
className="min-w-0 flex-1 bg-transparent py-3.5 text-base outline-none placeholder:text-muted-foreground"
|
|
321
|
+
data-testid="command-palette-input"
|
|
322
|
+
/>
|
|
323
|
+
</div>
|
|
324
|
+
{countLabel !== undefined && (
|
|
325
|
+
<span className="sr-only" aria-live="polite" data-testid="command-palette-count">
|
|
326
|
+
{countLabel(selectable.length)}
|
|
327
|
+
</span>
|
|
328
|
+
)}
|
|
329
|
+
|
|
330
|
+
<div
|
|
331
|
+
ref={listRef}
|
|
332
|
+
id="command-palette-list"
|
|
333
|
+
role="listbox"
|
|
334
|
+
aria-label={label}
|
|
335
|
+
className="max-h-80 overflow-y-auto p-1"
|
|
336
|
+
>
|
|
337
|
+
{shown.length === 0 && (
|
|
338
|
+
<p className="px-3 py-6 text-center text-sm text-muted-foreground" data-testid="command-palette-empty">
|
|
339
|
+
{emptyLabel}
|
|
340
|
+
</p>
|
|
341
|
+
)}
|
|
342
|
+
|
|
343
|
+
{shown.map((item, index) => {
|
|
344
|
+
const header = item.group !== undefined && item.group !== lastGroup ? item.group : null
|
|
345
|
+
lastGroup = item.group
|
|
346
|
+
|
|
347
|
+
return (
|
|
348
|
+
<React.Fragment key={item.id}>
|
|
349
|
+
{header !== null && (
|
|
350
|
+
<div className="px-3 pt-3 pb-1 text-[0.8125rem] font-medium text-muted-foreground">
|
|
351
|
+
{header}
|
|
352
|
+
</div>
|
|
353
|
+
)}
|
|
354
|
+
<div
|
|
355
|
+
id={`command-item-${item.id}`}
|
|
356
|
+
role="option"
|
|
357
|
+
aria-selected={index === cursor}
|
|
358
|
+
aria-disabled={item.disabled === true}
|
|
359
|
+
data-index={index}
|
|
360
|
+
data-testid={`command-item-${item.id}`}
|
|
361
|
+
onMouseEnter={() => item.disabled !== true && setCursor(index)}
|
|
362
|
+
onClick={() => run(item)}
|
|
363
|
+
className={cn(
|
|
364
|
+
"flex cursor-pointer items-center gap-2 rounded-md px-3 py-2 text-sm",
|
|
365
|
+
// The selected row is the tint with text in the main colour (7.3).
|
|
366
|
+
index === cursor && item.disabled !== true && "bg-primary-tint text-primary-tint-foreground",
|
|
367
|
+
item.agent === true && "border border-dashed border-input",
|
|
368
|
+
item.disabled === true && "cursor-not-allowed opacity-45"
|
|
369
|
+
)}
|
|
370
|
+
>
|
|
371
|
+
{item.icon !== undefined && <span className="shrink-0 text-muted-foreground">{item.icon}</span>}
|
|
372
|
+
<span className="min-w-0 flex-1 truncate">
|
|
373
|
+
{item.label}
|
|
374
|
+
{item.hint !== undefined && (
|
|
375
|
+
<span className="ms-2 text-[0.8125rem] text-muted-foreground">{item.hint}</span>
|
|
376
|
+
)}
|
|
377
|
+
</span>
|
|
378
|
+
{item.shortcut !== undefined && (
|
|
379
|
+
<span className="shrink-0 text-xs text-muted-foreground">{item.shortcut}</span>
|
|
380
|
+
)}
|
|
381
|
+
</div>
|
|
382
|
+
</React.Fragment>
|
|
383
|
+
)
|
|
384
|
+
})}
|
|
385
|
+
</div>
|
|
386
|
+
{footer !== undefined && (
|
|
387
|
+
<div className="flex gap-4 border-t border-border px-4 py-2 text-[0.8125rem] text-muted-foreground">
|
|
388
|
+
<span><kbd className="me-1 rounded border border-border px-1 font-mono text-xs">↑↓</kbd>{footer.move}</span>
|
|
389
|
+
<span><kbd className="me-1 rounded border border-border px-1 font-mono text-xs">Enter</kbd>{footer.open}</span>
|
|
390
|
+
{footer.complete !== undefined && (
|
|
391
|
+
<span><kbd className="me-1 rounded border border-border px-1 font-mono text-xs">Tab</kbd>{footer.complete}</span>
|
|
392
|
+
)}
|
|
393
|
+
<span><kbd className="me-1 rounded border border-border px-1 font-mono text-xs">Esc</kbd>{footer.close}</span>
|
|
394
|
+
</div>
|
|
395
|
+
)}
|
|
396
|
+
</div>
|
|
397
|
+
</div>
|
|
398
|
+
)
|
|
399
|
+
}
|