@axiapps/axi-design 1.16.0 → 1.18.0

package/README.md

@@ -138,6 +138,9 @@ not "what does the system look like". Everything else is
 | `--axi-check-size` | the size of an `.axi-check` or `.axi-radio` box | `22px` | `<input type="checkbox" class="axi-check" style="--axi-check-size: 16px">` |
 | `--axi-check-fill` | the fill a checked `.axi-check` takes, and the colour of a checked `.axi-radio`'s diamond | `var(--axi-accent)` | `<input type="checkbox" class="axi-check" style="--axi-check-fill: var(--axi-danger)">` |
 | `--axi-textarea-h` | the minimum height of a `<textarea class="axi-input">` | `90px` | `<textarea class="axi-input" style="--axi-textarea-h: 200px">` |
+| `--axi-well-pad` | the padding inside an `.axi-well` | `10px` | `<div class="axi-well" style="--axi-well-pad: 18px">` |
+| `--axi-rail-w` | an `.axi-rail`'s width, for labels longer than the default holds | `208px` | `<aside class="axi-rail" style="--axi-rail-w: 260px">` |
+| `--axi-rail-pad` | the padding inside an `.axi-rail` | `10px` | `<aside class="axi-rail" style="--axi-rail-pad: 6px">` |
 | `--axi-avatar-size` | the size of an `.axi-avatar` square | `40px` | `<span class="axi-avatar" style="--axi-avatar-size: 28px">MS</span>` |
 | `--axi-modal-width` | the maximum width of an `.axi-modal`, before the viewport clamp | `560px` | `<dialog class="axi-modal" style="--axi-modal-width: 760px">` |
 | `--axi-card-strip` | the colour of `.axi-card--strip`'s top strip | `var(--axi-accent)` | `<a class="axi-card axi-card--strip" style="--axi-card-strip: var(--axi-ok)">` |
@@ -146,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
@@ -43,6 +57,28 @@
      --axi-ink-on-fill below, on the other side of the same token. */
   --axi-ground-deep: var(--axi-ink-line);
   --axi-rule: #3a4250;            /* internal rules, inside an outlined panel */
+  /* --- the well --- */
+  /* A field sunk INTO a surface rather than raised off one: a table picker's
+     list, a bar's trough, a column of cards standing on the page. The language
+     had no name for it, and every consumer that needed one reached for a second
+     .axi-panel inside the first - two identical fills parted by a line, which
+     reads as one field with a stray rule through it.
+
+     Two tokens because a well is the exact inverse of a panel on both counts.
+     The fill is a SUBTRACTION from whatever is behind it, not a colour of its
+     own: spelled as --axi-ground it is right in this theme, where surfaces are
+     opaque and the page really is what shows through a hole in one, and wrong
+     in a glass theme, where an opaque page colour inside a translucent pane is
+     a black patch rather than a recess. A theme restates it as a darkening at
+     alpha and the panel's own tint carries through.
+
+     The line is --axi-rule and not --axi-ink-line, because ink only reads
+     against a fill lighter than itself. Every outline in this language is
+     near-black on the assumption of a ground the lines can be darker than; a
+     well IS at ground level, so an ink edge round one is a black line on a
+     black field. Raised takes ink, sunk takes the rule. */
+  --axi-well-fill: var(--axi-ground);
+  --axi-well-line: var(--axi-rule);
   --axi-text: #f4f6f9;
   --axi-text-dim: #a7b0be;
   --axi-text-faint: #7c8695;
@@ -251,6 +287,22 @@ a { color: inherit; }
   padding: var(--axi-panel-pad, 26px);
 }
 
+/* ---------- well ---------- */
+/* The panel's inverse: a field sunk into the surface around it rather than
+   raised off it. No block, because a recess casts nothing, and the rule rather
+   than the ink for its edge - see --axi-well-fill in src/tokens.css for why
+   both of those follow from the same fact. Reach for this wherever a second
+   panel inside a panel was the instinct: a picker list beside a table, a column
+   of cards standing on the page, a trough a bar fills. */
+.axi-well {
+  background: var(--axi-well-fill);
+  border: var(--axi-border-control) solid var(--axi-well-line);
+  border-radius: var(--axi-radius);
+  /* Tighter than a panel's 26px: a well is a container for objects that carry
+     their own padding, not a page margin. */
+  padding: var(--axi-well-pad, 10px);
+}
+
 /* ---------- button ---------- */
 .axi-btn {
   display: inline-flex; align-items: center; gap: 8px;
@@ -463,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
@@ -935,6 +1008,107 @@ textarea.axi-input {
 }
 .axi-tabs .axi-tabs__close:hover { color: var(--axi-text); border-color: transparent; }
 
+/* ---------- rail ---------- */
+/* Vertical navigation, for a set too large for a tab strip to hold. Same
+   grammar as .axi-tabs deliberately - the item you are on is filled with the
+   accent and blocked, the rest are transparent until hovered - because "where
+   am I" is one question and should have one answer however the app happens to
+   be laying it out.
+
+   What a rail adds over a strip is a second level. A category is a place and
+   takes the fill; a section under it is where the page is scrolled to, which is
+   a smaller claim and is drawn as one: brightened text against the dim list
+   around it, no fill, no edge. Two fills at two levels would leave the reader
+   deciding which of them is the answer.
+
+   --axi-rail-w is declared nowhere and read with a fallback, i.e. it is the hook
+   a consumer overrides to widen the rail for longer labels. */
+.axi-rail {
+  display: flex;
+  flex-direction: column;
+  width: var(--axi-rail-w, 208px);
+  flex: none;
+  overflow-y: auto;
+  padding: var(--axi-rail-pad, 10px);
+  background: var(--axi-surface);
+  backdrop-filter: var(--axi-surface-filter);
+  border: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius);
+}
+/* A rail that IS the edge of the page rather than a panel standing in the
+   layout - pinned to the viewport, or a drawer's contents. It keeps the one
+   border that faces the content and drops everything that says "this is an
+   object with space around it": no radius on the flush side, and no block,
+   because a block needs somewhere to fall.
+
+   The block is stated as what a free-standing rail has rather than as
+   something the flush one turns off, so there is exactly one box-shadow here
+   and it names the panel block. `box-shadow: none` would be a second spelling
+   of the raise for a theme to miss. */
+.axi-rail:not(.axi-rail--flush) { box-shadow: var(--axi-shadow-panel); }
+.axi-rail--flush {
+  border: 0;
+  border-right: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: 0;
+}
+.axi-rail__nav { display: flex; flex-direction: column; gap: 2px; }
+.axi-rail__item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  width: 100%;
+  padding: 8px 10px;
+  font: 800 12.5px/1 var(--axi-sans);
+  color: var(--axi-text-dim);
+  text-align: left;
+  background: transparent;
+  border: var(--axi-border-control) solid transparent;
+  border-radius: var(--axi-radius-sm);
+  cursor: pointer;
+}
+.axi-rail__item:hover { color: var(--axi-text); background: var(--axi-surface-raised); }
+/* The same treatment a pressed pill and a current tab get. Only ever one of
+   these on screen. Any aria-current value, because the right one depends on
+   what the rail navigates - `page` for a view, `location` for a place within
+   one - and the fill means the same thing either way. */
+.axi-rail__item[aria-current],
+.axi-rail__item[aria-current]:hover {
+  background: var(--axi-accent);
+  color: var(--axi-accent-ink);
+  border-color: var(--axi-ink-line);
+  box-shadow: var(--axi-shadow-control);
+}
+/* An icon beside a label is a label for it, not a second accent - so it takes
+   the faint tone, and inside a filled item it follows the item's ink. */
+.axi-rail__item .axi-icon { color: var(--axi-text-faint); }
+.axi-rail__item[aria-current] .axi-icon { color: var(--axi-accent-ink); }
+/* The second level, indented under the item it belongs to. */
+.axi-rail__sub { display: flex; flex-direction: column; margin: 3px 0 5px 10px; }
+.axi-rail__subitem {
+  padding: 5px 8px;
+  font: 700 11.5px/1.3 var(--axi-sans);
+  text-align: left;
+  color: var(--axi-text-faint);
+  background: transparent;
+  border: 0;
+  border-radius: var(--axi-radius-sm);
+  cursor: pointer;
+}
+.axi-rail__subitem:hover { color: var(--axi-text-dim); background: var(--axi-surface-raised); }
+.axi-rail__subitem[aria-current] { color: var(--axi-text); }
+/* An annotation on an item, not a measurement of it, so rule 5 draws it
+   outlined rather than filled. */
+.axi-rail__mark {
+  margin-left: auto;
+  padding: 2px 5px;
+  font: var(--axi-t-micro);
+  letter-spacing: .04em;
+  text-transform: uppercase;
+  color: var(--axi-meta);
+  border: var(--axi-border-hairline) solid var(--axi-meta);
+  border-radius: var(--axi-radius-sm);
+}
+
 /* ---------- notice ---------- */
 .axi-notice {
   display: flex; gap: 14px; padding: 15px 18px;
@@ -992,6 +1166,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,10 +6,12 @@
   --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);
   --axi-ground-deep: #0c0e12;
+  --axi-well-fill: rgba(6, 8, 14, .32);
   --axi-accent-ink: #0c0e12;
   --axi-ink-on-fill: #0c0e12;
   --axi-text: #f2f5fb;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiapps/axi-design",
-  "version": "1.16.0",
+  "version": "1.18.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

@@ -29,6 +29,22 @@
   padding: var(--axi-panel-pad, 26px);
 }
 
+/* ---------- well ---------- */
+/* The panel's inverse: a field sunk into the surface around it rather than
+   raised off it. No block, because a recess casts nothing, and the rule rather
+   than the ink for its edge - see --axi-well-fill in src/tokens.css for why
+   both of those follow from the same fact. Reach for this wherever a second
+   panel inside a panel was the instinct: a picker list beside a table, a column
+   of cards standing on the page, a trough a bar fills. */
+.axi-well {
+  background: var(--axi-well-fill);
+  border: var(--axi-border-control) solid var(--axi-well-line);
+  border-radius: var(--axi-radius);
+  /* Tighter than a panel's 26px: a well is a container for objects that carry
+     their own padding, not a page margin. */
+  padding: var(--axi-well-pad, 10px);
+}
+
 /* ---------- button ---------- */
 .axi-btn {
   display: inline-flex; align-items: center; gap: 8px;
@@ -241,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

@@ -109,6 +109,107 @@
 }
 .axi-tabs .axi-tabs__close:hover { color: var(--axi-text); border-color: transparent; }
 
+/* ---------- rail ---------- */
+/* Vertical navigation, for a set too large for a tab strip to hold. Same
+   grammar as .axi-tabs deliberately - the item you are on is filled with the
+   accent and blocked, the rest are transparent until hovered - because "where
+   am I" is one question and should have one answer however the app happens to
+   be laying it out.
+
+   What a rail adds over a strip is a second level. A category is a place and
+   takes the fill; a section under it is where the page is scrolled to, which is
+   a smaller claim and is drawn as one: brightened text against the dim list
+   around it, no fill, no edge. Two fills at two levels would leave the reader
+   deciding which of them is the answer.
+
+   --axi-rail-w is declared nowhere and read with a fallback, i.e. it is the hook
+   a consumer overrides to widen the rail for longer labels. */
+.axi-rail {
+  display: flex;
+  flex-direction: column;
+  width: var(--axi-rail-w, 208px);
+  flex: none;
+  overflow-y: auto;
+  padding: var(--axi-rail-pad, 10px);
+  background: var(--axi-surface);
+  backdrop-filter: var(--axi-surface-filter);
+  border: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: var(--axi-radius);
+}
+/* A rail that IS the edge of the page rather than a panel standing in the
+   layout - pinned to the viewport, or a drawer's contents. It keeps the one
+   border that faces the content and drops everything that says "this is an
+   object with space around it": no radius on the flush side, and no block,
+   because a block needs somewhere to fall.
+
+   The block is stated as what a free-standing rail has rather than as
+   something the flush one turns off, so there is exactly one box-shadow here
+   and it names the panel block. `box-shadow: none` would be a second spelling
+   of the raise for a theme to miss. */
+.axi-rail:not(.axi-rail--flush) { box-shadow: var(--axi-shadow-panel); }
+.axi-rail--flush {
+  border: 0;
+  border-right: var(--axi-border-panel) solid var(--axi-ink-line);
+  border-radius: 0;
+}
+.axi-rail__nav { display: flex; flex-direction: column; gap: 2px; }
+.axi-rail__item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  width: 100%;
+  padding: 8px 10px;
+  font: 800 12.5px/1 var(--axi-sans);
+  color: var(--axi-text-dim);
+  text-align: left;
+  background: transparent;
+  border: var(--axi-border-control) solid transparent;
+  border-radius: var(--axi-radius-sm);
+  cursor: pointer;
+}
+.axi-rail__item:hover { color: var(--axi-text); background: var(--axi-surface-raised); }
+/* The same treatment a pressed pill and a current tab get. Only ever one of
+   these on screen. Any aria-current value, because the right one depends on
+   what the rail navigates - `page` for a view, `location` for a place within
+   one - and the fill means the same thing either way. */
+.axi-rail__item[aria-current],
+.axi-rail__item[aria-current]:hover {
+  background: var(--axi-accent);
+  color: var(--axi-accent-ink);
+  border-color: var(--axi-ink-line);
+  box-shadow: var(--axi-shadow-control);
+}
+/* An icon beside a label is a label for it, not a second accent - so it takes
+   the faint tone, and inside a filled item it follows the item's ink. */
+.axi-rail__item .axi-icon { color: var(--axi-text-faint); }
+.axi-rail__item[aria-current] .axi-icon { color: var(--axi-accent-ink); }
+/* The second level, indented under the item it belongs to. */
+.axi-rail__sub { display: flex; flex-direction: column; margin: 3px 0 5px 10px; }
+.axi-rail__subitem {
+  padding: 5px 8px;
+  font: 700 11.5px/1.3 var(--axi-sans);
+  text-align: left;
+  color: var(--axi-text-faint);
+  background: transparent;
+  border: 0;
+  border-radius: var(--axi-radius-sm);
+  cursor: pointer;
+}
+.axi-rail__subitem:hover { color: var(--axi-text-dim); background: var(--axi-surface-raised); }
+.axi-rail__subitem[aria-current] { color: var(--axi-text); }
+/* An annotation on an item, not a measurement of it, so rule 5 draws it
+   outlined rather than filled. */
+.axi-rail__mark {
+  margin-left: auto;
+  padding: 2px 5px;
+  font: var(--axi-t-micro);
+  letter-spacing: .04em;
+  text-transform: uppercase;
+  color: var(--axi-meta);
+  border: var(--axi-border-hairline) solid var(--axi-meta);
+  border-radius: var(--axi-radius-sm);
+}
+
 /* ---------- notice ---------- */
 .axi-notice {
   display: flex; gap: 14px; padding: 15px 18px;
@@ -166,6 +267,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
@@ -39,6 +53,28 @@
      --axi-ink-on-fill below, on the other side of the same token. */
   --axi-ground-deep: var(--axi-ink-line);
   --axi-rule: #3a4250;            /* internal rules, inside an outlined panel */
+  /* --- the well --- */
+  /* A field sunk INTO a surface rather than raised off one: a table picker's
+     list, a bar's trough, a column of cards standing on the page. The language
+     had no name for it, and every consumer that needed one reached for a second
+     .axi-panel inside the first - two identical fills parted by a line, which
+     reads as one field with a stray rule through it.
+
+     Two tokens because a well is the exact inverse of a panel on both counts.
+     The fill is a SUBTRACTION from whatever is behind it, not a colour of its
+     own: spelled as --axi-ground it is right in this theme, where surfaces are
+     opaque and the page really is what shows through a hole in one, and wrong
+     in a glass theme, where an opaque page colour inside a translucent pane is
+     a black patch rather than a recess. A theme restates it as a darkening at
+     alpha and the panel's own tint carries through.
+
+     The line is --axi-rule and not --axi-ink-line, because ink only reads
+     against a fill lighter than itself. Every outline in this language is
+     near-black on the assumption of a ground the lines can be darker than; a
+     well IS at ground level, so an ink edge round one is a black line on a
+     black field. Raised takes ink, sunk takes the rule. */
+  --axi-well-fill: var(--axi-ground);
+  --axi-well-line: var(--axi-rule);
   --axi-text: #f4f6f9;
   --axi-text-dim: #a7b0be;
   --axi-text-faint: #7c8695;