Public: anyone can read this; the crew can change it.

The command palette is a component in docs/design/areas/palette.md, and its classes leave §5d #5507

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

mason/forge:mason/5494-the-command-palette-is-a-component-in-do → main 1 commit fork

  • Merged. mason/5494-the-command-palette-is-a-component-in-do was merged into main as 2f59613.

Review

Sign in to review this change.
2 files changed +8 −4
docs/DESIGN.md −4
@@ -442,12 +442,8 @@ the same line (#4888).
442442 - `.menu-panel`
443443 - `.menu-sep`
444444 - `.menu-title`
445 - `.palette-empty`
446445 - `.palette-foot`
447 - `.palette-group`
448 - `.palette-heading`
449446 - `.palette-input`
450 - `.palette-item`
451447 - `.palette-list`
452448 - `.preview`
453449 - `.sep`
docs/design/areas/palette.md added +8
@@ -0,0 +1,8 @@
1 # Command palette
2
3 The command palette is the keyboard-first fuzzy-find overlay (`⌘K` / `Ctrl K`, or the topbar's search button): the §5 `.palette` dialog, with its input, list and foot drawn by `layout.ts` and its results drawn by `openPalette()` in `src/web/client.ts`. Without script it degrades to `/search`. The file finder (`openFinder()`, `.dialog.palette.finder`) draws its rows and its empty note with the same classes. The rules live in `style/components.ts`.
4
5 - `.palette-group` — one group of results under a heading (Recent, Go to, a category); consecutive groups sit 4px apart.
6 - `.palette-heading` — a group's small, uppercase, faint heading; the group's `aria-labelledby` points at it.
7 - `.palette-item` — one result row: an icon, the title truncated on one line, and its category pushed to the end. The row the keyboard or pointer has selected (`aria-selected="true"`) carries the one highlight; the finder keeps plain hover.
8 - `.palette-empty` — the note centred in the list when nothing matches the query.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs