@axiapps/axi-design 1.17.0 → 1.19.0

package/README.md

@@ -149,6 +149,8 @@ not "what does the system look like". Everything else is
 | `--axi-stack-gap` | gap between `.axi-stack` children | `12px` | `<div class="axi-stack" style="--axi-stack-gap: 20px">` |
 | `--axi-panel-pad` | `.axi-panel`'s own padding | `26px` | `<div class="axi-panel" style="--axi-panel-pad: 14px">` |
 | `--axi-page-pad` | `.axi-page`'s horizontal gutter | `var(--axi-gutter)` | `<div class="axi-page axi-page--narrow" style="--axi-page-pad: 0">` |
+| `--axi-palette-w` | the widest an `.axi-palette__panel` gets (it fills the room below that) | `560px` | `<div class="axi-palette__panel" style="--axi-palette-w: 720px">` |
+| `--axi-palette-top` | how far down the screen an `.axi-palette` opens | `12vh` | `<div class="axi-scrim axi-palette" style="--axi-palette-top: 6vh">` |
 | `--axi-menu-width` | width of `.axi-menu__pop` | `310px` | `<div class="axi-menu__pop" style="--axi-menu-width: 380px">` |
 | `--axi-drawer-width` | width of `.axi-drawer` (capped at `100vw`) | `560px` | `<aside class="axi-drawer" style="--axi-drawer-width: 720px">` |
 | `--axi-series` | the ink a meter fill, bar, plot line or `.axi-diamond--series` is drawn in | `var(--axi-accent)` | `<span class="axi-meter__fill" style="--axi-series: var(--axi-ok)">` |

package/dist/axi.css

@@ -32,6 +32,20 @@
   --axi-ground-image: none;
   --axi-surface: #222731;         /* a panel raised off the page */
   --axi-surface-raised: #2b313d;  /* a chip or popover raised off a panel */
+  /* The fill for a surface that FLOATS over content which scrolls behind it: a
+     command palette, a menu popover, a modal. Holds --axi-surface, because for
+     a theme whose panels are opaque a floating panel is just a panel and there
+     is nothing to decide.
+
+     It exists for the theme whose panels are not. A translucent pane is legible
+     standing still on the page and stops being legible the moment a table
+     scrolls under it - the text it is carrying now has text behind it. The blur
+     that was supposed to rescue that is not something a language can promise:
+     backdrop-filter is unavailable or switched off on whole platforms, and
+     where it is missing the alpha is the only thing left. So the float gets its
+     own token, and a theme that goes translucent restates it near-opaque
+     without giving up the tint on everything that merely sits still. */
+  --axi-surface-float: var(--axi-surface);
   --axi-ink-line: #0c0e12;        /* the outline every raised element is drawn with */
   /* The tone a shape is made of when it is made of the line ink rather than
      outlined in it - the tooltip, the titlebar strip, the switch's slug. Holds
@@ -501,6 +515,27 @@ a { color: inherit; }
   color: var(--axi-accent); font-weight: 900; pointer-events: none;
 }
 
+/* ---------- keyboard key ---------- */
+/* A key on the keyboard, named in the interface: the Esc that closes a
+   palette, the Ctrl K that opens it. Drawn as a small control rather than as a
+   label, because what it depicts is a thing you press - so it takes the
+   control edge and the control radius, and every consumer that has a shortcut
+   to show stops having to invent a box for it.
+
+   It sits on --axi-surface, not --axi-ground: a key is raised out of whatever
+   it is printed on, and the fields and bars these appear in are already the
+   recessed thing. */
+.axi-kbd {
+  display: inline-block;
+  padding: 2px 5px;
+  background: var(--axi-surface);
+  border: var(--axi-border-control) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  color: var(--axi-text-dim);
+  font: 700 10px/1 var(--axi-sans);
+  white-space: nowrap;
+}
+
 /* ---------- select ---------- */
 /* The closed box is ours everywhere: strip the native control and draw the
    caret, so a select sits alongside the other controls as just another
@@ -887,6 +922,29 @@ textarea.axi-input {
   padding-inline: var(--axi-gutter);
   display: flex; align-items: center; gap: 22px; min-height: 66px; flex-wrap: wrap;
 }
+/* Above --axi-page the row stops growing: the cap is on this box, not on the
+   window, so from 1280px up the masthead has exactly one width to fit in and
+   wrapping there is not a fallback, it is a permanent second line - one tab
+   too many and the last item in source order drops, on a 4K display as surely
+   as on a laptop. So the wide row does not wrap; it takes the width out of the
+   search field instead (below), and the strip scrolls only if that runs out.
+   Under the cap the window really is too narrow and wrapping is the honest
+   answer, which is why this is a floor and not a blanket `nowrap`. */
+@media (min-width: 1280px) {
+  .axi-mast__in { flex-wrap: nowrap; }
+}
+/* Nothing in the row gives up width unless it is named below. */
+.axi-mast__in > * { flex-shrink: 0; }
+/* The field is the one control here that is still entirely itself 70px
+   narrower - a placeholder that elides costs nothing, where a clipped tab
+   costs a destination. Flexbox shrinks proportionally, not in order, and a
+   merely-larger factor still took a couple of pixels off the last tab; the
+   number is this big to make that share round to nothing, so the effect is
+   the ordering CSS has no other way to say. Once the field is at its floor -
+   still wide enough to read as a search box rather than a smudge - whatever
+   is left over goes to the strip, which scrolls. */
+.axi-mast .axi-search,
+.axi-mast .docs-search { flex-shrink: 1000; min-width: 200px; }
 .axi-brand { display: flex; align-items: center; gap: 12px; text-decoration: none; }
 /* The sigil is the diamond motif scaled up with a glyph on top. The diamond is
    a rotated pseudo-element behind the text rather than a rotated box, so the
@@ -920,8 +978,14 @@ textarea.axi-input {
 .axi-tabs { display: flex; gap: 8px; }
 /* The auto margin belongs to the masthead, not to the strip: it is a statement
    about where the tabs sit in that row, and a strip standing on its own -
-   spanning a view instead of ending a header - has nothing to push away from. */
-.axi-mast .axi-tabs { margin-left: auto; }
+   spanning a view instead of ending a header - has nothing to push away from.
+   The overflow belongs to the masthead for the same reason. This row is capped
+   at --axi-page, so the brand, the strip, the search field and the two selects
+   divide 1244px however wide the window is, and flex-wrap breaks a line before
+   it shrinks an item - so one tab too many sent the last item in source order
+   to a second row instead of taking width off the widest one. The strip is the
+   item that can give: it scrolls, and the row stays a row. */
+.axi-mast .axi-tabs { margin-left: auto; flex-shrink: 1; min-width: 0; overflow-x: auto; }
 .axi-tabs a,
 .axi-tabs button {
   padding: 8px 16px;
@@ -1016,6 +1080,14 @@ textarea.axi-input {
   border-right: var(--axi-border-panel) solid var(--axi-ink-line);
   border-radius: 0;
 }
+/* A rail the page scrolls behind, rather than one the page sits beside.
+   It is the same object, so it keeps every other rule; the one thing that
+   changes is the surface it is printed on. --axi-surface is a translucent
+   tint under a theme like glass, which reads as a pane only while the
+   content behind it holds still — the moment a table scrolls past, the
+   rows show through the nav. --axi-surface-float is the surface for
+   exactly that case, so say it once here instead of in each consumer. */
+.axi-rail--float { background: var(--axi-surface-float); }
 .axi-rail__nav { display: flex; flex-direction: column; gap: 2px; }
 .axi-rail__item {
   display: flex;
@@ -1131,6 +1203,144 @@ textarea.axi-input {
 .axi-menu__pop label:hover { background: var(--axi-ground); color: var(--axi-text); }
 .axi-menu__pop input { margin: 3px 0 0; }
 
+/* ---------- command palette ---------- */
+/* Everything in an app, reachable by typing its name. Not .axi-modal, which is
+   a <dialog> with a head, a body and a foot and asks you a question: a palette
+   has no question and no buttons, it is a field with a list under it, and it
+   sits near the top of the screen because the list has to grow downward
+   without moving the field you are typing into.
+
+   Two things travel with it. The panel is .axi-surface-float, not
+   .axi-surface: whatever the app was showing is still behind it and still
+   scrolling, and that is the case the float token exists for. And the host
+   element wears .axi-scrim alongside .axi-palette - the scrim already knows
+   what darkening the page looks like, and a second spelling of it here is one
+   more place for a theme to be restated in only one of them.
+
+   The cursor is not the hover. A palette is driven from the keyboard, so the
+   row Enter would take is marked with the accent fill outright, while hover is
+   the quieter raised-surface wash - both visible at once, saying different
+   things, with the filled one winning on sight. The consumer sets
+   `data-active` on the cursor row and keeps it scrolled into view. */
+.axi-palette {
+  display: flex; align-items: flex-start; justify-content: center;
+  padding: var(--axi-palette-top, 12vh) 16px 16px;
+}
+.axi-palette__panel {
+  display: flex; flex-direction: column;
+  width: 100%; max-width: var(--axi-palette-w, 560px);
+  max-height: 70vh; overflow: hidden;
+  background: var(--axi-surface-float);
+  backdrop-filter: var(--axi-surface-filter);
+  border: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius);
+  box-shadow: var(--axi-shadow-panel);
+}
+/* The bar holds the field and the filters. It is the raised surface so the
+   list below it reads as the panel's contents rather than as more bar. */
+.axi-palette__bar {
+  flex: none; padding: 8px 10px;
+  background: var(--axi-surface-raised);
+  border-bottom: var(--axi-border-control) solid var(--axi-ink-line);
+}
+/* The field is an .axi-search wrapping an .axi-input, same as anywhere else;
+   only the height comes down, because a palette's field is a row in a bar and
+   not a form control standing on a page. No focus ring: the palette opens with
+   the caret already here, so a permanent outline says nothing, and it would
+   argue with the one mark that does - the accent on the cursor row. */
+.axi-palette__bar .axi-input { padding-top: 7px; padding-bottom: 7px; font-size: 13px; }
+.axi-palette__bar .axi-input:focus-visible { outline: none; }
+.axi-palette__filters { display: flex; align-items: center; gap: 6px; margin-top: 8px; }
+/* What the list is not showing. Meta, at the end of the filter row, because it
+   is a reading about the results and not another control among them. */
+.axi-palette__count {
+  margin-left: auto; flex: none;
+  color: var(--axi-text-faint);
+  font: var(--axi-t-label); font-size: 10px; letter-spacing: var(--axi-ls-label);
+  text-transform: uppercase;
+}
+/* min-height: 0 because the panel is a flex column and a list that cannot
+   shrink below its content pushes the panel past its own max-height. The
+   scrollbar is hidden: at twelve rows behind a fixed cap the bar is a channel
+   carved down the side of a small panel to report a fact the row count in the
+   bar has already given. */
+.axi-palette__list {
+  flex: 1; min-height: 0; overflow-y: auto; padding: 4px 0;
+  scrollbar-width: none;
+}
+.axi-palette__list::-webkit-scrollbar { width: 0; height: 0; }
+/* One .axi-palette__section per group of rows, each opening with a
+   .axi-palette__group heading. The section is a named part rather than left to
+   the consumer's wrapper so the rule between groups can be stated as what it
+   is - a parting between two sections - instead of guessed at from structure. */
+.axi-palette__section + .axi-palette__section {
+  border-top: var(--axi-border-hairline) solid var(--axi-rule);
+  margin-top: 4px;
+}
+.axi-palette__group {
+  padding: 8px 10px 4px;
+  color: var(--axi-text-faint);
+  font: var(--axi-t-label); font-size: 10px; letter-spacing: var(--axi-ls-label);
+  text-transform: uppercase;
+}
+.axi-palette__row {
+  display: flex; align-items: center; gap: 8px;
+  width: 100%; padding: 7px 10px;
+  background: transparent; border: 0; border-radius: 0;
+  color: var(--axi-text-dim);
+  font: var(--axi-t-small); text-align: left; cursor: pointer;
+}
+.axi-palette__row:hover { background: var(--axi-surface-raised); color: var(--axi-text); }
+.axi-palette__row[data-active] { background: var(--axi-accent); color: var(--axi-accent-ink); }
+/* The row's own ink is set above, but a row carries a glyph and a second line
+   of text that were coloured on their own; on the filled row they all become
+   the ink the fill is written in. */
+.axi-palette__row[data-active] svg,
+.axi-palette__row[data-active] .axi-palette__meta { color: var(--axi-accent-ink); }
+/* Where the row is, as against what it is. */
+.axi-palette__meta { margin-left: auto; flex: none; color: var(--axi-text-faint); font-size: 11px; }
+.axi-palette__empty {
+  padding: 24px 12px; text-align: center;
+  color: var(--axi-text-faint); font: var(--axi-t-small);
+}
+/* The palette's field at rest, wherever the app keeps the way in. It is a
+   button, and it is drawn as the field it opens - the same ground, the same
+   edge, the same magnifier at the head - so opening the palette reads as this
+   control growing rather than as a different object arriving.
+
+   It keeps the field's fill instead of a button's because what it stands for
+   is somewhere to type. What it takes from a button is the answer to the
+   cursor: the block and the lift, because it is still a thing you press. */
+.axi-palette__trigger {
+  display: flex; align-items: center; width: 100%; overflow: hidden;
+  padding: 0 10px 0 0;
+  background: var(--axi-ground);
+  border: var(--axi-border-control) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  color: var(--axi-text-dim);
+  font: var(--axi-t-label); font-size: 12px; font-weight: 600;
+  cursor: pointer;
+  transition: transform .1s, box-shadow .1s, color .1s;
+}
+.axi-palette__trigger:hover {
+  color: var(--axi-text);
+  box-shadow: var(--axi-shadow-control);
+  transform: translate(-2px, -2px);
+}
+/* The magnifier at the head of the well, carrying the accent on its own. Its
+   own element and stretched to the trigger's height so the glyph is inside the
+   outline rather than floating in the fill. It was a solid accent block once,
+   which at a 30px row spends a lot of the loudest colour in the palette on a
+   control nobody is meant to look at until they want it - the glyph says the
+   same thing at a fraction of the volume. */
+.axi-palette__mark {
+  display: flex; align-items: center; align-self: stretch; flex: none;
+  padding: 0 8px 0 10px; margin-right: 10px;
+  color: var(--axi-accent);
+}
+.axi-palette__label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.axi-palette__trigger .axi-kbd { margin-left: auto; flex: none; }
+
 /* ---------- tooltip ---------- */
 /* One line of ink on the darkest surface in the language, so it reads over
    anything it lands on. The class draws the box only; coordinates come from

package/dist/themes/glass.css

@@ -6,6 +6,7 @@
   --axi-ground-image: radial-gradient(900px 500px at 15% 0%, rgba(120, 90, 255, .30), transparent 60%), radial-gradient(700px 500px at 95% 30%, rgba(0, 190, 255, .22), transparent 62%), radial-gradient(600px 600px at 60% 100%, rgba(255, 90, 170, .20), transparent 60%);
   --axi-surface: linear-gradient(145deg, rgba(58, 68, 92, .55), rgba(28, 33, 46, .42));
   --axi-surface-raised: linear-gradient(145deg, rgba(86, 99, 130, .5), rgba(44, 52, 71, .38));
+  --axi-surface-float: linear-gradient(145deg, rgba(38, 45, 62, .97), rgba(22, 26, 36, .97));
   --axi-surface-filter: blur(18px) saturate(140%);
   --axi-ink-line: rgba(180, 200, 255, .16);
   --axi-rule: rgba(180, 200, 255, .14);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiapps/axi-design",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "The design language for the axi suite — flat and outlined, dark, drawn in saturated ink.",
   "type": "module",
   "license": "MIT",

package/src/primitives.css

@@ -257,6 +257,27 @@
   color: var(--axi-accent); font-weight: 900; pointer-events: none;
 }
 
+/* ---------- keyboard key ---------- */
+/* A key on the keyboard, named in the interface: the Esc that closes a
+   palette, the Ctrl K that opens it. Drawn as a small control rather than as a
+   label, because what it depicts is a thing you press - so it takes the
+   control edge and the control radius, and every consumer that has a shortcut
+   to show stops having to invent a box for it.
+
+   It sits on --axi-surface, not --axi-ground: a key is raised out of whatever
+   it is printed on, and the fields and bars these appear in are already the
+   recessed thing. */
+.axi-kbd {
+  display: inline-block;
+  padding: 2px 5px;
+  background: var(--axi-surface);
+  border: var(--axi-border-control) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  color: var(--axi-text-dim);
+  font: 700 10px/1 var(--axi-sans);
+  white-space: nowrap;
+}
+
 /* ---------- select ---------- */
 /* The closed box is ours everywhere: strip the native control and draw the
    caret, so a select sits alongside the other controls as just another

package/src/shells.css

@@ -23,6 +23,29 @@
   padding-inline: var(--axi-gutter);
   display: flex; align-items: center; gap: 22px; min-height: 66px; flex-wrap: wrap;
 }
+/* Above --axi-page the row stops growing: the cap is on this box, not on the
+   window, so from 1280px up the masthead has exactly one width to fit in and
+   wrapping there is not a fallback, it is a permanent second line - one tab
+   too many and the last item in source order drops, on a 4K display as surely
+   as on a laptop. So the wide row does not wrap; it takes the width out of the
+   search field instead (below), and the strip scrolls only if that runs out.
+   Under the cap the window really is too narrow and wrapping is the honest
+   answer, which is why this is a floor and not a blanket `nowrap`. */
+@media (min-width: 1280px) {
+  .axi-mast__in { flex-wrap: nowrap; }
+}
+/* Nothing in the row gives up width unless it is named below. */
+.axi-mast__in > * { flex-shrink: 0; }
+/* The field is the one control here that is still entirely itself 70px
+   narrower - a placeholder that elides costs nothing, where a clipped tab
+   costs a destination. Flexbox shrinks proportionally, not in order, and a
+   merely-larger factor still took a couple of pixels off the last tab; the
+   number is this big to make that share round to nothing, so the effect is
+   the ordering CSS has no other way to say. Once the field is at its floor -
+   still wide enough to read as a search box rather than a smudge - whatever
+   is left over goes to the strip, which scrolls. */
+.axi-mast .axi-search,
+.axi-mast .docs-search { flex-shrink: 1000; min-width: 200px; }
 .axi-brand { display: flex; align-items: center; gap: 12px; text-decoration: none; }
 /* The sigil is the diamond motif scaled up with a glyph on top. The diamond is
    a rotated pseudo-element behind the text rather than a rotated box, so the
@@ -56,8 +79,14 @@
 .axi-tabs { display: flex; gap: 8px; }
 /* The auto margin belongs to the masthead, not to the strip: it is a statement
    about where the tabs sit in that row, and a strip standing on its own -
-   spanning a view instead of ending a header - has nothing to push away from. */
-.axi-mast .axi-tabs { margin-left: auto; }
+   spanning a view instead of ending a header - has nothing to push away from.
+   The overflow belongs to the masthead for the same reason. This row is capped
+   at --axi-page, so the brand, the strip, the search field and the two selects
+   divide 1244px however wide the window is, and flex-wrap breaks a line before
+   it shrinks an item - so one tab too many sent the last item in source order
+   to a second row instead of taking width off the widest one. The strip is the
+   item that can give: it scrolls, and the row stays a row. */
+.axi-mast .axi-tabs { margin-left: auto; flex-shrink: 1; min-width: 0; overflow-x: auto; }
 .axi-tabs a,
 .axi-tabs button {
   padding: 8px 16px;
@@ -152,6 +181,14 @@
   border-right: var(--axi-border-panel) solid var(--axi-ink-line);
   border-radius: 0;
 }
+/* A rail the page scrolls behind, rather than one the page sits beside.
+   It is the same object, so it keeps every other rule; the one thing that
+   changes is the surface it is printed on. --axi-surface is a translucent
+   tint under a theme like glass, which reads as a pane only while the
+   content behind it holds still — the moment a table scrolls past, the
+   rows show through the nav. --axi-surface-float is the surface for
+   exactly that case, so say it once here instead of in each consumer. */
+.axi-rail--float { background: var(--axi-surface-float); }
 .axi-rail__nav { display: flex; flex-direction: column; gap: 2px; }
 .axi-rail__item {
   display: flex;
@@ -267,6 +304,144 @@
 .axi-menu__pop label:hover { background: var(--axi-ground); color: var(--axi-text); }
 .axi-menu__pop input { margin: 3px 0 0; }
 
+/* ---------- command palette ---------- */
+/* Everything in an app, reachable by typing its name. Not .axi-modal, which is
+   a <dialog> with a head, a body and a foot and asks you a question: a palette
+   has no question and no buttons, it is a field with a list under it, and it
+   sits near the top of the screen because the list has to grow downward
+   without moving the field you are typing into.
+
+   Two things travel with it. The panel is .axi-surface-float, not
+   .axi-surface: whatever the app was showing is still behind it and still
+   scrolling, and that is the case the float token exists for. And the host
+   element wears .axi-scrim alongside .axi-palette - the scrim already knows
+   what darkening the page looks like, and a second spelling of it here is one
+   more place for a theme to be restated in only one of them.
+
+   The cursor is not the hover. A palette is driven from the keyboard, so the
+   row Enter would take is marked with the accent fill outright, while hover is
+   the quieter raised-surface wash - both visible at once, saying different
+   things, with the filled one winning on sight. The consumer sets
+   `data-active` on the cursor row and keeps it scrolled into view. */
+.axi-palette {
+  display: flex; align-items: flex-start; justify-content: center;
+  padding: var(--axi-palette-top, 12vh) 16px 16px;
+}
+.axi-palette__panel {
+  display: flex; flex-direction: column;
+  width: 100%; max-width: var(--axi-palette-w, 560px);
+  max-height: 70vh; overflow: hidden;
+  background: var(--axi-surface-float);
+  backdrop-filter: var(--axi-surface-filter);
+  border: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius);
+  box-shadow: var(--axi-shadow-panel);
+}
+/* The bar holds the field and the filters. It is the raised surface so the
+   list below it reads as the panel's contents rather than as more bar. */
+.axi-palette__bar {
+  flex: none; padding: 8px 10px;
+  background: var(--axi-surface-raised);
+  border-bottom: var(--axi-border-control) solid var(--axi-ink-line);
+}
+/* The field is an .axi-search wrapping an .axi-input, same as anywhere else;
+   only the height comes down, because a palette's field is a row in a bar and
+   not a form control standing on a page. No focus ring: the palette opens with
+   the caret already here, so a permanent outline says nothing, and it would
+   argue with the one mark that does - the accent on the cursor row. */
+.axi-palette__bar .axi-input { padding-top: 7px; padding-bottom: 7px; font-size: 13px; }
+.axi-palette__bar .axi-input:focus-visible { outline: none; }
+.axi-palette__filters { display: flex; align-items: center; gap: 6px; margin-top: 8px; }
+/* What the list is not showing. Meta, at the end of the filter row, because it
+   is a reading about the results and not another control among them. */
+.axi-palette__count {
+  margin-left: auto; flex: none;
+  color: var(--axi-text-faint);
+  font: var(--axi-t-label); font-size: 10px; letter-spacing: var(--axi-ls-label);
+  text-transform: uppercase;
+}
+/* min-height: 0 because the panel is a flex column and a list that cannot
+   shrink below its content pushes the panel past its own max-height. The
+   scrollbar is hidden: at twelve rows behind a fixed cap the bar is a channel
+   carved down the side of a small panel to report a fact the row count in the
+   bar has already given. */
+.axi-palette__list {
+  flex: 1; min-height: 0; overflow-y: auto; padding: 4px 0;
+  scrollbar-width: none;
+}
+.axi-palette__list::-webkit-scrollbar { width: 0; height: 0; }
+/* One .axi-palette__section per group of rows, each opening with a
+   .axi-palette__group heading. The section is a named part rather than left to
+   the consumer's wrapper so the rule between groups can be stated as what it
+   is - a parting between two sections - instead of guessed at from structure. */
+.axi-palette__section + .axi-palette__section {
+  border-top: var(--axi-border-hairline) solid var(--axi-rule);
+  margin-top: 4px;
+}
+.axi-palette__group {
+  padding: 8px 10px 4px;
+  color: var(--axi-text-faint);
+  font: var(--axi-t-label); font-size: 10px; letter-spacing: var(--axi-ls-label);
+  text-transform: uppercase;
+}
+.axi-palette__row {
+  display: flex; align-items: center; gap: 8px;
+  width: 100%; padding: 7px 10px;
+  background: transparent; border: 0; border-radius: 0;
+  color: var(--axi-text-dim);
+  font: var(--axi-t-small); text-align: left; cursor: pointer;
+}
+.axi-palette__row:hover { background: var(--axi-surface-raised); color: var(--axi-text); }
+.axi-palette__row[data-active] { background: var(--axi-accent); color: var(--axi-accent-ink); }
+/* The row's own ink is set above, but a row carries a glyph and a second line
+   of text that were coloured on their own; on the filled row they all become
+   the ink the fill is written in. */
+.axi-palette__row[data-active] svg,
+.axi-palette__row[data-active] .axi-palette__meta { color: var(--axi-accent-ink); }
+/* Where the row is, as against what it is. */
+.axi-palette__meta { margin-left: auto; flex: none; color: var(--axi-text-faint); font-size: 11px; }
+.axi-palette__empty {
+  padding: 24px 12px; text-align: center;
+  color: var(--axi-text-faint); font: var(--axi-t-small);
+}
+/* The palette's field at rest, wherever the app keeps the way in. It is a
+   button, and it is drawn as the field it opens - the same ground, the same
+   edge, the same magnifier at the head - so opening the palette reads as this
+   control growing rather than as a different object arriving.
+
+   It keeps the field's fill instead of a button's because what it stands for
+   is somewhere to type. What it takes from a button is the answer to the
+   cursor: the block and the lift, because it is still a thing you press. */
+.axi-palette__trigger {
+  display: flex; align-items: center; width: 100%; overflow: hidden;
+  padding: 0 10px 0 0;
+  background: var(--axi-ground);
+  border: var(--axi-border-control) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius-sm);
+  color: var(--axi-text-dim);
+  font: var(--axi-t-label); font-size: 12px; font-weight: 600;
+  cursor: pointer;
+  transition: transform .1s, box-shadow .1s, color .1s;
+}
+.axi-palette__trigger:hover {
+  color: var(--axi-text);
+  box-shadow: var(--axi-shadow-control);
+  transform: translate(-2px, -2px);
+}
+/* The magnifier at the head of the well, carrying the accent on its own. Its
+   own element and stretched to the trigger's height so the glyph is inside the
+   outline rather than floating in the fill. It was a solid accent block once,
+   which at a 30px row spends a lot of the loudest colour in the palette on a
+   control nobody is meant to look at until they want it - the glyph says the
+   same thing at a fraction of the volume. */
+.axi-palette__mark {
+  display: flex; align-items: center; align-self: stretch; flex: none;
+  padding: 0 8px 0 10px; margin-right: 10px;
+  color: var(--axi-accent);
+}
+.axi-palette__label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.axi-palette__trigger .axi-kbd { margin-left: auto; flex: none; }
+
 /* ---------- tooltip ---------- */
 /* One line of ink on the darkest surface in the language, so it reads over
    anything it lands on. The class draws the box only; coordinates come from

package/src/tokens.css

@@ -28,6 +28,20 @@
   --axi-ground-image: none;
   --axi-surface: #222731;         /* a panel raised off the page */
   --axi-surface-raised: #2b313d;  /* a chip or popover raised off a panel */
+  /* The fill for a surface that FLOATS over content which scrolls behind it: a
+     command palette, a menu popover, a modal. Holds --axi-surface, because for
+     a theme whose panels are opaque a floating panel is just a panel and there
+     is nothing to decide.
+
+     It exists for the theme whose panels are not. A translucent pane is legible
+     standing still on the page and stops being legible the moment a table
+     scrolls under it - the text it is carrying now has text behind it. The blur
+     that was supposed to rescue that is not something a language can promise:
+     backdrop-filter is unavailable or switched off on whole platforms, and
+     where it is missing the alpha is the only thing left. So the float gets its
+     own token, and a theme that goes translucent restates it near-opaque
+     without giving up the tint on everything that merely sits still. */
+  --axi-surface-float: var(--axi-surface);
   --axi-ink-line: #0c0e12;        /* the outline every raised element is drawn with */
   /* The tone a shape is made of when it is made of the line ink rather than
      outlined in it - the tooltip, the titlebar strip, the switch's slug. Holds