@axiapps/axi-design 1.17.0 → 1.18.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
@@ -1131,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,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.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

@@ -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

@@ -267,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