anentrypoint-design 0.0.381 → 0.0.383

package/src/css/app-shell/kits-appended.css

@@ -30,9 +30,15 @@
    app scale (--fs-h1-app, 22-30px) is what these tokens exist for. Applied
    here rather than as a data-attribute on each kit shell so any surface using
    this root gets the app voice without a per-kit opt-in that kits forget. */
-.ds-app-surface > h1, .ds-app-surface > .t-h1 { font-size: var(--fs-h1-app); line-height: 1.15; }
-.ds-app-surface > h2, .ds-app-surface > .t-h2 { font-size: var(--fs-h2-app); }
-.ds-app-surface > h3, .ds-app-surface > .t-h3 { font-size: var(--fs-h3-app); }
+/* Descendant, not direct-child: a kit that wraps its title in a head row (an
+   h1 beside a theme toggle, say) still gets the app voice. The direct-child
+   form silently missed exactly that shape and left those titles at the 64px
+   display ceiling -- the surface opted in but the rule did not reach the
+   heading. Nested .ds-section content is unaffected because nothing re-raises
+   the size below this point. */
+.ds-app-surface h1, .ds-app-surface .t-h1 { font-size: var(--fs-h1-app); line-height: 1.15; }
+.ds-app-surface h2, .ds-app-surface .t-h2 { font-size: var(--fs-h2-app); }
+.ds-app-surface h3, .ds-app-surface .t-h3 { font-size: var(--fs-h3-app); }
 /* The lede is supporting chrome under an app title, not a marketing stand-first:
    it drops to body size and keeps a readable measure instead of --fs-xl. */
 .ds-app-surface > .lede, .ds-app-surface > .t-lede { font-size: var(--fs-body); max-width: 60ch; }
@@ -138,7 +144,7 @@
   margin: var(--space-3) auto;
   background: var(--bg-2);
   border-radius: var(--r-2);
-  padding: clamp(16px, 5vw, 64px);
+  padding: clamp(var(--space-3), 5vw, var(--space-7));
   box-sizing: border-box;
   display: flex;
   overflow: hidden;
@@ -153,8 +159,10 @@
 }
 .ds-deck-slide { flex: 1; display: flex; min-width: 0; }
 .ds-deck-controls {
+  /* 14px sits between --space-2-75 (12) and --space-3 (16) with no tier; it is
+     the deck control spacing tuned against the mono glyph run. */
   display: flex; align-items: center; justify-content: center; gap: 14px;
-  padding: 8px; font-family: var(--ff-mono); font-size: var(--fs-sm);
+  padding: var(--space-2); font-family: var(--ff-mono); font-size: var(--fs-sm);
 }
 .ds-deck-count { color: var(--fg-3); }
 @media (pointer: coarse) {
@@ -181,9 +189,9 @@
    full-bleed slide chrome, not panel chrome) and owns its own bottom gutter. */
 .ds-slide-eyebrow {
   color: var(--fg-3);
-  margin-bottom: clamp(12px, 2.5cqw, 24px);
+  margin-bottom: clamp(var(--space-2-75), 2.5cqw, var(--space-4));
 }
-.ds-slide-col { display: flex; flex-direction: column; justify-content: center; gap: clamp(12px, 2.5cqw, 24px); min-width: 0; }
+.ds-slide-col { display: flex; flex-direction: column; justify-content: center; gap: clamp(var(--space-2-75), 2.5cqw, var(--space-4)); min-width: 0; }
 .ds-slide-col--start { align-items: flex-start; }
 .ds-slide-col--narrow { max-width: 38ch; }
 .ds-slide-col--quote { max-width: 42ch; }
@@ -197,15 +205,17 @@
   font-size: clamp(var(--fs-h3), 4.5cqw, var(--fs-h1));
   line-height: var(--lh-snug); color: var(--fg); font-weight: 500; min-width: 0;
 }
-.ds-slide-h1--lead { margin-bottom: 12px; }
+.ds-slide-h1--lead { margin-bottom: var(--space-2-75); }
 .ds-slide-quote-body {
   font-size: clamp(var(--fs-lg), 3.5cqw, var(--fs-h2));
   line-height: var(--lh-snug); color: var(--fg); font-weight: 400; font-style: italic;
 }
 .ds-slide-cite { font-family: var(--ff-mono); font-size: var(--fs-sm); color: var(--fg-3); }
 .ds-slide-bullet {
-  display: flex; gap: clamp(8px, 2vw, 18px); align-items: baseline;
-  border-bottom: 1px solid var(--rule); padding: 12px 0; flex-wrap: wrap;
+  /* 18px ceiling has no tier (--space-3 is 16, --space-3-5 is 20); it is the
+     bullet key/value split tuned against the clamp(56px,18%,100px) key column. */
+  display: flex; gap: clamp(var(--space-2), 2vw, 18px); align-items: baseline;
+  border-bottom: 1px solid var(--rule); padding: var(--space-2-75) 0; flex-wrap: wrap;
 }
 .ds-slide-bullet-key {
   flex: 0 1 clamp(56px, 18%, 100px); min-width: 0;
@@ -213,7 +223,7 @@
   color: var(--slide-accent, var(--accent-ink));
 }
 .ds-slide-bullet-val { color: var(--fg-2); font-size: var(--fs-lg); min-width: 0; }
-.ds-slide-split { display: grid; grid-template-columns: 1fr 1fr; gap: clamp(12px, 3vw, 32px); margin-top: 12px; }
+.ds-slide-split { display: grid; grid-template-columns: 1fr 1fr; gap: clamp(var(--space-2-75), 3vw, var(--space-5)); margin-top: var(--space-2-75); }
 @media (max-width: 760px) {
   .ds-slide-split { grid-template-columns: 1fr; }
 }
@@ -239,7 +249,10 @@
 
 /* --- error 404 --------------------------------------------- */
 .ds-err-hero {
-  padding: clamp(16px, 5vw, 36px) clamp(12px, 4vw, 22px);
+  /* 36px/22px clamp ceilings and the 14px gap are off-scale on purpose: this
+     hero is centred around a clamp(56px,20vw,120px) numeral and the insets are
+     tuned to it, not to the panel rhythm the --space-* scale encodes. */
+  padding: clamp(var(--space-3), 5vw, 36px) clamp(var(--space-2-75), 4vw, 22px);
   text-align: center; display: flex; flex-direction: column; gap: 14px; align-items: center;
 }
 .ds-err-numeral {
@@ -247,25 +260,25 @@
   line-height: 1; color: var(--panel-text-3); letter-spacing: -0.03em;
 }
 .ds-err-path {
-  display: inline-flex; gap: 6px; align-items: baseline; flex-wrap: wrap; max-width: 100%;
+  display: inline-flex; gap: var(--space-1-75); align-items: baseline; flex-wrap: wrap; max-width: 100%;
   font-family: var(--ff-mono); font-size: 13px; color: var(--panel-text-2);
-  background: var(--panel-1); padding: 6px 12px; border-radius: var(--r-0);
+  background: var(--panel-1); padding: var(--space-1-75) var(--space-2-75); border-radius: var(--r-0);
   overflow-wrap: anywhere; word-break: break-all;
 }
 
 /* --- gallery ------------------------------------------------ */
 .ds-tile-grid {
-  padding: clamp(8px, 2.5vw, 16px);
-  display: grid; grid-template-columns: repeat(auto-fill, minmax(min(180px, 100%), 1fr)); gap: 8px;
+  padding: clamp(var(--space-2), 2.5vw, var(--space-3));
+  display: grid; grid-template-columns: repeat(auto-fill, minmax(min(180px, 100%), 1fr)); gap: var(--space-2);
 }
 .ds-tile-grid--tight { grid-template-columns: repeat(auto-fill, minmax(min(140px, 100%), 1fr)); }
 .ds-swatch-grid {
-  padding: clamp(8px, 2.5vw, 16px);
-  display: grid; grid-template-columns: repeat(auto-fill, minmax(min(160px, 100%), 1fr)); gap: 12px;
+  padding: clamp(var(--space-2), 2.5vw, var(--space-3));
+  display: grid; grid-template-columns: repeat(auto-fill, minmax(min(160px, 100%), 1fr)); gap: var(--space-2-75);
 }
 .ds-gallery-tile {
-  cursor: pointer; display: flex; flex-direction: column; gap: 6px;
-  padding: 12px; border-radius: var(--r-1); min-height: clamp(120px, 18vw, 160px);
+  cursor: pointer; display: flex; flex-direction: column; gap: var(--space-1-75);
+  padding: var(--space-2-75); border-radius: var(--r-1); min-height: clamp(120px, 18vw, 160px);
   border: 0; text-align: left; font: inherit; color: inherit;
   background: var(--tile-tone, var(--panel-1));
   transition: transform var(--dur-base) var(--ease), box-shadow var(--dur-base) var(--ease);
@@ -279,20 +292,23 @@
 .ds-lightbox {
   position: fixed; inset: 0; background: var(--scrim);
   display: flex; align-items: center; justify-content: center;
-  padding: clamp(12px, 4vw, 32px);
-  padding-bottom: max(clamp(12px, 4vw, 32px), env(safe-area-inset-bottom));
+  padding: clamp(var(--space-2-75), 4vw, var(--space-5));
+  padding-bottom: max(clamp(var(--space-2-75), 4vw, var(--space-5)), env(safe-area-inset-bottom));
   z-index: var(--z-modal);
 }
 .ds-lightbox-card {
-  background: var(--panel-0); border-radius: var(--r-2); padding: clamp(16px, 4vw, 28px);
+  /* 28px ceiling has no tier (--space-4 is 24, --space-5 is 32); it is the
+     lightbox card inset tuned against the min(520px,100%) card width. */
+  background: var(--panel-0); border-radius: var(--r-2); padding: clamp(var(--space-3), 4vw, 28px);
   width: min(520px, 100%); min-width: 0;
   max-height: calc(100vh - 24px);
   max-height: calc(100dvh - 24px);
   overflow: auto;
-  display: flex; flex-direction: column; gap: 14px;
+  display: flex; flex-direction: column; gap: 14px; /* off-scale, matches the card inset above */
 }
 .ds-lightbox-preview {
-  padding: clamp(16px, 6vw, 36px); border-radius: var(--r-1); text-align: center;
+  /* 36px ceiling has no tier (--space-5 is 32, --space-6 is 48). */
+  padding: clamp(var(--space-3), 6vw, 36px); border-radius: var(--r-1); text-align: center;
   font-family: var(--ff-mono); white-space: pre-line; font-size: clamp(16px, 5vw, 24px);
   background: var(--tile-tone, var(--panel-1));
 }
@@ -302,25 +318,31 @@
 @media (max-width: 480px) {
   .ds-topbar-search { flex-basis: 100%; }
 }
-.ds-empty-state { padding: clamp(16px, 5vw, 24px); text-align: center; color: var(--panel-text-3); }
+.ds-empty-state { padding: clamp(var(--space-3), 5vw, var(--space-4)); text-align: center; color: var(--panel-text-3); }
 .ds-empty-state-glyph { font-size: clamp(24px, 6vw, 32px); }
-.ds-empty-state-msg { margin: 6px 0; }
+.ds-empty-state-msg { margin: var(--space-1-75) 0; }
 .ds-empty-state-hint { margin: 0; font-size: var(--fs-sm); }
 
 /* --- system primer ------------------------------------------ */
+/* The three primer panels below share one fluid inset,
+   clamp(10px, 2.5vw, 14px) clamp(10px, 3vw, 18px), and a 14/18px gap. None of
+   10/14/18 is a --space-* tier (the scale jumps 8 -> 10 -> 12 -> 16 -> 20) and
+   the three values are tuned as a set against the 64px label columns, so the
+   panels stay optically identical to each other. Snapping any one of them
+   desyncs the family; they are deliberate literals, not un-migrated drift. */
 .ds-swatch-grid-sm {
   display: grid; grid-template-columns: repeat(auto-fill, minmax(min(110px, 100%), 1fr));
-  gap: 12px; padding: clamp(10px, 2.5vw, 14px) clamp(10px, 3vw, 18px);
+  gap: var(--space-2-75); padding: clamp(10px, 2.5vw, 14px) clamp(10px, 3vw, 18px);
 }
 .ds-swatch-grid-lg { grid-template-columns: repeat(auto-fill, minmax(min(150px, 100%), 1fr)); }
-.ds-swatch-col { display: flex; flex-direction: column; gap: 6px; }
+.ds-swatch-col { display: flex; flex-direction: column; gap: var(--space-1-75); }
 .ds-swatch-chip { height: 48px; border-radius: var(--r-1); border: 1px solid var(--rule); background: var(--swatch, var(--panel-1)); }
 .ds-swatch-chip--big { height: 64px; }
 .ds-swatch-name { font-family: var(--ff-mono); font-size: 11px; color: var(--fg-3); }
 .ds-type-panel { padding: clamp(10px, 2.5vw, 14px) clamp(10px, 3vw, 18px); display: flex; flex-direction: column; gap: 14px; }
 .ds-type-row {
   display: flex; align-items: baseline; gap: 14px;
-  border-bottom: 1px solid var(--rule); padding-bottom: 8px; flex-wrap: wrap;
+  border-bottom: 1px solid var(--rule); padding-bottom: var(--space-2); flex-wrap: wrap;
 }
 .ds-type-row-label { flex: 0 0 64px; font-family: var(--ff-mono); font-size: 11px; color: var(--fg-3); }
 .ds-type-sample {
@@ -328,7 +350,7 @@
   font-size: var(--sample-size, var(--fs-body));
 }
 .ds-prim-panel { padding: clamp(10px, 2.5vw, 14px) clamp(10px, 3vw, 18px); display: flex; flex-direction: column; gap: 18px; }
-.ds-prim-row { display: flex; gap: 10px; flex-wrap: wrap; align-items: center; }
+.ds-prim-row { display: flex; gap: var(--space-2-5); flex-wrap: wrap; align-items: center; }
 .ds-prim-label { flex: 0 0 64px; font-family: var(--ff-mono); font-size: 11px; color: var(--fg-3); }
 
 /* == appended: content-site == */
@@ -384,7 +406,7 @@
    matching the "color reserved for meaning, not decoration" pattern seen in
    docstudio's admin table. */
 .ds-table-sort-btn {
-  display: inline-flex; align-items: center; gap: 4px;
+  display: inline-flex; align-items: center; gap: var(--space-1);
   background: none; border: none; padding: 0; margin: 0;
   font: inherit; font-weight: inherit; color: inherit; cursor: pointer;
 }
@@ -457,55 +479,56 @@
 /* == appended: signin kit cleanup == */
 /* -- signin kit (ui_kits/signin) -- */
 .ds-auth-wrap { padding: var(--space-2, 8px); display: flex; flex-direction: column; align-items: center; }
-.ds-auth-col { width: 100%; max-width: 440px; display: flex; flex-direction: column; gap: 8px; margin: clamp(12px, 4vw, 24px) 0; min-width: 0; }
-.ds-auth-form { padding: clamp(12px, 3vw, 18px); display: flex; flex-direction: column; gap: 10px; }
+.ds-auth-col { width: 100%; max-width: 440px; display: flex; flex-direction: column; gap: var(--space-2); margin: clamp(var(--space-2-75), 4vw, var(--space-4)) 0; min-width: 0; }
+/* 18px ceiling: no tier between --space-3 (16) and --space-3-5 (20). */
+.ds-auth-form { padding: clamp(var(--space-2-75), 3vw, 18px); display: flex; flex-direction: column; gap: var(--space-2-5); }
 .ds-auth-sent { align-items: center; text-align: center; }
 .ds-auth-sent-glyph { font-size: 32px; color: var(--panel-accent); }
 .ds-auth-sent-title { margin: 0; font-weight: 600; }
 .ds-auth-sent-sub { margin: 0; color: var(--panel-text-2); overflow-wrap: anywhere; }
-.ds-auth-field { display: flex; flex-direction: column; gap: 4px; }
+.ds-auth-field { display: flex; flex-direction: column; gap: var(--space-1); }
 /* .ds-auth-field-label joins the kit small-label voice above, no overrides. */
-.ds-auth-row-between { display: flex; align-items: center; justify-content: space-between; gap: 8px; flex-wrap: wrap; }
-.ds-auth-remember { display: flex; align-items: center; gap: 6px; cursor: pointer; }
+.ds-auth-row-between { display: flex; align-items: center; justify-content: space-between; gap: var(--space-2); flex-wrap: wrap; }
+.ds-auth-remember { display: flex; align-items: center; gap: var(--space-1-75); cursor: pointer; }
 .ds-auth-remember-text { color: var(--panel-text-2); font-size: 13px; }
 .ds-auth-forgot { font-size: 13px; }
-.ds-auth-error { padding: 8px 10px; background: var(--panel-1); border-radius: var(--r-0); color: var(--danger); font-size: 13px; overflow-wrap: anywhere; }
-.ds-auth-providers { display: flex; gap: 8px; flex-wrap: wrap; }
-.ds-auth-provider-btn { flex: 1 1 100px; min-width: 0; display: flex; align-items: center; justify-content: center; gap: 8px; padding: 10px; }
+.ds-auth-error { padding: var(--space-2) var(--space-2-5); background: var(--panel-1); border-radius: var(--r-0); color: var(--danger); font-size: 13px; overflow-wrap: anywhere; }
+.ds-auth-providers { display: flex; gap: var(--space-2); flex-wrap: wrap; }
+.ds-auth-provider-btn { flex: 1 1 100px; min-width: 0; display: flex; align-items: center; justify-content: center; gap: var(--space-2); padding: var(--space-2-5); }
 .ds-auth-provider-btn--loading { opacity: 0.7; pointer-events: none; }
 .ds-auth-provider-glyph { font-family: var(--ff-mono); color: var(--panel-text-3); display: inline-flex; }
-.ds-auth-modes { display: flex; justify-content: center; gap: 14px; margin-top: 8px; font-size: 13px; flex-wrap: wrap; }
+.ds-auth-modes { display: flex; justify-content: center; gap: 14px; /* off-scale, matches the auth form inset */ margin-top: var(--space-2); font-size: 13px; flex-wrap: wrap; }
 .ds-auth-mode-link { color: var(--panel-text-3); text-decoration: none; }
 .ds-auth-mode-link--active { color: var(--panel-text); text-decoration: underline; }
-.ds-auth-fineprint { text-align: center; font-size: 12px; color: var(--panel-text-3); margin: 6px 0; }
+.ds-auth-fineprint { text-align: center; font-size: 12px; color: var(--panel-text-3); margin: var(--space-1-75) 0; }
 
 /* == appended: gallery-misc kit cleanup == */
 /* --- shared helpers (converted from inline styles) --- */
 .ds-m0 { margin: 0; }
 .ds-text-2 { color: var(--panel-text-2); }
 .ds-text-3 { color: var(--panel-text-3); }
-.ds-kit-head { display: flex; align-items: center; justify-content: space-between; gap: clamp(8px, 2vw, 16px); flex-wrap: wrap; }
+.ds-kit-head { display: flex; align-items: center; justify-content: space-between; gap: clamp(var(--space-2), 2vw, var(--space-3)); flex-wrap: wrap; }
 
 /* --- gallery kit --- */
 .ds-tile-cap { flex: 1; display: flex; align-items: center; justify-content: center; font-family: var(--ff-mono); white-space: pre-line; color: var(--panel-text-2); font-size: 18px; min-width: 0; text-align: center; }
-.ds-tile-meta { display: flex; align-items: center; justify-content: space-between; gap: 6px; font-size: 12px; flex-wrap: wrap; min-width: 0; }
+.ds-tile-meta { display: flex; align-items: center; justify-content: space-between; gap: var(--space-1-75); font-size: 12px; flex-wrap: wrap; min-width: 0; }
 .ds-tile-glyph { font-family: var(--ff-mono); color: var(--panel-text-3); }
 .ds-tile-label { color: var(--panel-text); overflow-wrap: anywhere; }
 .ds-gal-swatch { height: 64px; border-radius: var(--r-0); background: var(--swatch, var(--panel-1)); }
-.ds-gal-swatch-meta { display: flex; justify-content: space-between; gap: 6px; flex-wrap: wrap; font-family: var(--ff-mono); font-size: 11px; min-width: 0; }
+.ds-gal-swatch-meta { display: flex; justify-content: space-between; gap: var(--space-1-75); flex-wrap: wrap; font-family: var(--ff-mono); font-size: 11px; min-width: 0; }
 .ds-gal-swatch-name { color: var(--panel-text); }
 .ds-gal-swatch-hint { color: var(--panel-text-3); overflow-wrap: anywhere; }
-.ds-lightbox-head { display: flex; justify-content: space-between; align-items: center; gap: 8px; flex-wrap: wrap; }
+.ds-lightbox-head { display: flex; justify-content: space-between; align-items: center; gap: var(--space-2); flex-wrap: wrap; }
 /* .ds-lightbox-tag joins the kit small-label voice above, no overrides. */
 
 /* --- error_404 kit --- */
-.ds-err-actions { display: flex; gap: 8px; flex-wrap: wrap; justify-content: center; margin-top: 6px; }
-.ds-err-chips { display: flex; gap: 6px; flex-wrap: wrap; justify-content: center; margin-top: 4px; }
+.ds-err-actions { display: flex; gap: var(--space-2); flex-wrap: wrap; justify-content: center; margin-top: var(--space-1-75); }
+.ds-err-chips { display: flex; gap: var(--space-1-75); flex-wrap: wrap; justify-content: center; margin-top: var(--space-1); }
 
 /* == appended: terminal-capp kit cleanup == */
 /* --- terminal kit ------------------------------------------ */
-.ds-section-pad-sm { padding: 8px; }
-.ds-kit-head-row { display: flex; align-items: center; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
+.ds-section-pad-sm { padding: var(--space-2); }
+.ds-kit-head-row { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); flex-wrap: wrap; }
 .ds-cli-cmt .cmd { color: var(--fg-3); }
 .ds-cli-out .cmd { color: var(--fg-2); }
 .ds-cli-ok .prompt, .ds-cli-ok .cmd { color: var(--accent-ink); }
@@ -783,3 +806,22 @@
   .cursor-blink { animation: ds-cursor-blink 1s step-end infinite; }
   @keyframes ds-cursor-blink { 50% { opacity: 0; } }
 }
+
+/* == appended: panel width modifier == */
+/* .panel.panel-inline-wide — a width-capped inline note panel. Companion to
+   the .panel-inline / .panel-wide modifiers in panel-row.css: those two change
+   the panel's SURFACE (tonal fill / chrome-stripped), this one changes only
+   its MEASURE, so it composes with either. Introduced when ui_kits/docs's
+   `[!] note` panel traded `style="max-width:640px"` for a class (the inline-
+   style sweep) but never got a rule written, leaving that panel to run the
+   full column width. 640px is the note measure, deliberately narrower than
+   --measure-narrow (760px): the aside is meant to read as a set-aside block
+   against the surrounding prose, not to match its column. It is a literal
+   rather than a new token because it has exactly one consumer — promote it to
+   --measure-note the moment a second surface wants the same cap.
+   `margin-right: auto` (not `margin: 0 auto`) keeps the panel left-aligned to
+   the prose it interrupts and preserves .panel's own --space-4 stack margin. */
+.panel.panel-inline-wide {
+  max-width: 640px;
+  margin-right: auto;
+}

package/src/css/app-shell/responsive.css

@@ -14,7 +14,7 @@
      brand and let it scroll horizontally. The brand stays on the first row;
      nav wraps to a second row at 100% width (flex-wrap on .app-topbar). */
   .app-topbar {
-    gap: var(--space-2); padding: 12px var(--space-3);
+    gap: var(--space-2); padding: var(--space-2-75) var(--space-3);
   }
   /* When the topbar is folded into .app-chrome it is a flex:0 0 auto child, so
      it sizes to its nav's content and overflows the viewport instead of letting
@@ -23,7 +23,7 @@
   .app-chrome > .app-topbar { max-width: 100%; min-width: 0; flex-basis: 100%; }
   .app-topbar > nav {
     flex: 1 1 100%; margin-left: 0; order: 3; min-width: 0; max-width: 100%;
-    display: flex; gap: 2px; flex-wrap: nowrap;
+    display: flex; gap: var(--space-hair); flex-wrap: nowrap;
     overflow-x: auto; scrollbar-width: none; -webkit-overflow-scrolling: touch;
     /* Fade the trailing edge so a clipped last item (e.g. "source ->" cut to
        "sour") reads as scrollable content, not a broken/truncated label. */
@@ -32,7 +32,7 @@
   }
   .app-topbar nav::-webkit-scrollbar { display: none; }
   .app-topbar nav a {
-    flex: 0 0 auto; padding: 10px 12px; min-height: 44px; white-space: nowrap;
+    flex: 0 0 auto; padding: var(--space-2-5) var(--space-2-75); min-height: 44px; white-space: nowrap;
   }
   .brand { font-size: var(--fs-tiny); font-weight: 600; }
 
@@ -53,21 +53,36 @@
   .panel-body { padding: var(--space-2); overflow-x: auto; -webkit-overflow-scrolling: touch; }
   .panel-body > table { min-width: 100%; }
 
-  .row {
-    grid-template-columns: minmax(0, 1fr) auto !important;
-    gap: var(--space-2); padding: 12px 16px;
-    row-gap: 4px !important;
+  /* Scoped to the `.app` shell so this wins on SPECIFICITY (0,2,0) rather than
+     on an !important flag. Three rules would otherwise beat a bare `.row`
+     (0,1,0) here: `.row.row-nocode` (0,2,0, panel-row.css) out-specifies it,
+     and the `@media(481-1024)` + `@media(max-width:768px)` `.row` rules later
+     in THIS file win on source order (a media query adds no specificity).
+     `.app` is safe to require: `.app-body`/`.row` only ever render inside it
+     (single call site, shell.js AppShell). */
+  .app .row {
+    grid-template-columns: minmax(0, 1fr) auto;
+    gap: var(--space-2); padding: var(--space-2-75) var(--space-3);
+    row-gap: var(--space-1);
   }
   .row .sub { grid-column: 1 / -1; order: 3; }
   .row .title { font-size: var(--fs-sm); }
   /* Changelog carries 3 children: give date+ver line one, message wraps below
-     (the generic 2-col .row override staggers it into an implicit row). */
-  .ds-changelog-row { grid-template-columns: minmax(70px, 10ch) minmax(0, 1fr) !important; }
+     (the generic 2-col .row override staggers it into an implicit row).
+     Needs (0,3,0) to clear BOTH the `.app .row` rule directly above and
+     `.ds-changelog-row`'s own !important base in hero-content.css — an
+     !important base can only be beaten by another !important, so this one
+     stays until that upstream flag is removed (hero-content.css is outside
+     this change's scope). */
+  .app .row.ds-changelog-row { grid-template-columns: minmax(70px, 10ch) minmax(0, 1fr) !important; }
   .ds-changelog-row .title { grid-column: 1 / -1; }
 
   /* Buttons */
   .btn, .btn-primary, .btn-ghost {
-    padding: 11px 16px; font-size: var(--fs-tiny);
+    /* 11px vertical is optical, not scale drift: --space-2-75 (12) would tip
+       the intrinsic box past the 44px min-height floor below and make the
+       floor dead, changing the mobile button rhythm. */
+    padding: 11px var(--space-3); font-size: var(--fs-tiny);
     min-height: 44px; /* Touch target minimum */
   }
 
@@ -75,13 +90,13 @@
   .ds-file-grid {
     display: flex;
     flex-direction: column;
-    gap: 3px;
+    gap: var(--space-half);
   }
   .ds-file-row {
-    gap: 8px; padding: 10px 12px;
+    gap: var(--space-2); padding: var(--space-2-5) var(--space-2-75);
     font-size: var(--fs-xs);
   }
-  .ds-file-open { gap: 10px; }
+  .ds-file-open { gap: var(--space-2-5); }
   /* At mobile row widths, a fixed-size meta column (date/size) plus the
      always-visible action buttons leave the flexible title only a few px —
      not enough for even one legible character before the two collide. Drop
@@ -98,12 +113,12 @@
   /* Chat */
   .chat-stack { max-width: 100%; min-width: 0; }
   .chat-bubble {
-    padding: 10px 12px; font-size: var(--fs-sm);
+    padding: var(--space-2-5) var(--space-2-75); font-size: var(--fs-sm);
   }
   .chat-avatar { width: 28px; height: 28px; font-size: 11px; }
-  .chat-msg:hover { padding: 4px 0; margin: 0; background: transparent; }
-  .chat-composer { padding: 8px; gap: 6px; }
-  .chat-composer textarea { padding: 10px 12px; font-size: var(--fs-sm); }
+  .chat-msg:hover { padding: var(--space-1) 0; margin: 0; background: transparent; }
+  .chat-composer { padding: var(--space-2); gap: var(--space-1-75); }
+  .chat-composer textarea { padding: var(--space-2-5) var(--space-2-75); font-size: var(--fs-sm); }
 
   /* KPI Cards */
   .kpi {
@@ -119,9 +134,11 @@
   .empty { padding: var(--space-5); font-size: var(--fs-xs); }
 
   /* Form */
-  .row-form { gap: 10px; padding: var(--space-3); }
+  .row-form { gap: var(--space-2-5); padding: var(--space-3); }
   .row-form input,
-  .row-form textarea { padding: 11px 12px; font-size: var(--fs-sm); }
+  /* 11px block is the tuned inset that lines the textarea baseline up with the
+     sibling input; --space-2-75 (12) would offset the two by 1px each side. */
+  .row-form textarea { padding: 11px var(--space-2-75); font-size: var(--fs-sm); }
 
   /* Hero Section — keep fluid base font-size, just unconstrain width on mobile. */
   .ds-hero { padding: var(--space-6) 0 var(--space-5); }
@@ -131,26 +148,34 @@
   /* Table Responsiveness */
   table { font-size: var(--fs-xs); }
   table th,
-  table td { padding: 10px 12px; }
+  table td { padding: var(--space-2-5) var(--space-2-75); }
 
   /* CLI Block */
   .cli {
-    flex-direction: column; align-items: flex-start; gap: 10px;
-    padding: 16px 12px; font-size: var(--fs-xs);
+    flex-direction: column; align-items: flex-start; gap: var(--space-2-5);
+    padding: var(--space-3) var(--space-2-75); font-size: var(--fs-xs);
   }
-  .cli .copy { padding: 6px 12px; font-size: var(--fs-micro); }
+  .cli .copy { padding: var(--space-1-75) var(--space-2-75); font-size: var(--fs-micro); }
 }
 
 /* --------------------------------------------------------------------
    Container Query Responsive (720px and below)
    ---------------------------------------------------------------------- */
 @container (max-width: 760px) {
-  .app-body { grid-template-columns: 1fr !important; }
+  /* `.app`-scoped for specificity, not an !important flag: the bare `.app-body`
+     (0,1,0) was out-specified by `.app-body.no-side` (0,2,0) in topbar.css, so
+     a sidebar-less shell kept its base template. `.app .app-body` is (0,2,0)
+     and lands later in source, beating both topbar.css rules on merit. */
+  .app .app-body { grid-template-columns: 1fr; }
   .app-side-shell { border-right: 0; border-bottom: 1px solid var(--rule); }
-  .app-topbar nav { font-size: var(--fs-xs); gap: 14px; }
-  .row { grid-template-columns: minmax(0, 1fr) auto !important; row-gap: 4px !important; }
+  .app-topbar nav { font-size: var(--fs-xs); gap: var(--space-2-75); }
+  /* Same (0,2,0) lift as the 480px block above — clears `.row.row-nocode` and
+     the later `@media` `.row` rules in this file without a flag. */
+  .app .row { grid-template-columns: minmax(0, 1fr) auto; row-gap: var(--space-1); }
   .row .sub { grid-column: 1 / -1; order: 3; }
-  .ds-changelog-row { grid-template-columns: minmax(70px, 10ch) minmax(0, 1fr) !important; }
+  /* (0,3,0) + !important: still required to beat `.ds-changelog-row`'s
+     !important base in hero-content.css (see the 480px block). */
+  .app .row.ds-changelog-row { grid-template-columns: minmax(70px, 10ch) minmax(0, 1fr) !important; }
   .ds-changelog-row .title { grid-column: 1 / -1; }
 }
 
@@ -160,7 +185,7 @@
 @media (min-width: 481px) and (max-width: 1024px) {
   /* App Layout — side handled by 900px drawer block; restore for 901-1024 */
   .app-side a {
-    padding: 12px 12px; gap: 8px;
+    padding: var(--space-2-75) var(--space-2-75); gap: var(--space-2);
     grid-template-columns: 16px 1fr auto;
     font-size: var(--fs-xs);
     min-height: 44px;
@@ -168,14 +193,14 @@
 
   /* Topbar Navigation (flex container — no grid-template here) */
   .app-topbar {
-    gap: var(--space-3); padding: 12px var(--space-4);
+    gap: var(--space-3); padding: var(--space-2-75) var(--space-4);
   }
   .app-topbar nav {
-    display: flex; gap: 8px; font-size: var(--fs-xs);
+    display: flex; gap: var(--space-2); font-size: var(--fs-xs);
     flex-wrap: wrap;
   }
   .app-topbar nav a {
-    padding: 12px 12px; font-size: var(--fs-xs);
+    padding: var(--space-2-75) var(--space-2-75); font-size: var(--fs-xs);
     min-height: 44px;
   }
   .brand { font-size: var(--fs-sm); }
@@ -184,7 +209,10 @@
   .app-search {
     display: inline-flex;
     max-width: 280px; font-size: var(--fs-xs);
-    padding: 8px 14px;
+    /* 14px inline is between --space-2-75 (12) and --space-3 (16) with no tier;
+       it is the width that centers the search glyph against the 280px max-width
+       field. Snapping either way reads as a mis-centered control. */
+    padding: var(--space-2) 14px;
   }
 
   /* Main Content */
@@ -196,12 +224,17 @@
   /* File list — single column rows on tablet (cards only via data-columns) */
   .ds-file-row {
     grid-template-columns: 24px minmax(0, 1fr) auto auto;
-    gap: 12px; padding: 12px 14px;
+    /* 14px inline (no tier between 12 and 16) is the tablet row inset that
+       keeps the 24px icon column optically flush with the panel edge. */
+    gap: var(--space-2-75); padding: var(--space-2-75) 14px;
   }
 
   /* Chat Bubbles */
   .chat-stack { max-width: min(75%, 420px); }
   .chat-bubble {
+    /* 11px/14px are the tuned tablet bubble insets; neither is on the scale
+       (11 sits between --space-2-5 and --space-2-75, 14 between --space-2-75
+       and --space-3) and snapping visibly re-pitches every bubble in a thread. */
     padding: 11px 14px; font-size: var(--fs-sm);
   }
   .chat-avatar { width: 32px; height: 32px; font-size: 12px; }
@@ -214,7 +247,10 @@
 
   /* Buttons */
   .btn, .btn-primary, .btn-ghost {
-    padding: 12px 18px; font-size: var(--fs-sm);
+    /* 18px inline has no tier (--space-3 is 16, --space-3-5 is 20); it is the
+       tablet CTA width tuned against the 12px vertical, so snapping changes
+       the button aspect on the most visible control in the kit. */
+    padding: var(--space-2-75) 18px; font-size: var(--fs-sm);
   }
 
   /* Panel - keep the head on the body's left axis at laptop widths too. */
@@ -228,7 +264,9 @@
   /* Row */
   .row {
     grid-template-columns: minmax(90px, 12ch) minmax(0, 1fr) auto;
-    gap: var(--space-2); padding: 14px 16px;
+    /* 14px block (no tier between 12 and 16) is the tablet row height tuned
+       against the 12ch code column; snapping re-pitches the whole list. */
+    gap: var(--space-2); padding: 14px var(--space-3);
   }
 }
 

package/src/css/app-shell/responsive2-workspace.css

@@ -10,8 +10,16 @@
    even on a wide desktop. Drawer/scrim/toggle are absolute (anchored to .app), so
    they overlay the window, not the page. */
 @container (max-width: 900px) {
-  .app-body,
-  .app-body.no-side { grid-template-columns: 1fr !important; }
+  /* `.app`-scoped for specificity instead of an !important flag. The bare
+     `.app-body` half of this list is (0,1,0) and was out-specified by
+     `.app-body.no-side` (0,2,0) in topbar.css; scoping lifts both halves to
+     (0,2,0)/(0,3,0), which also lands later in source than topbar.css, so the
+     drawer collapse wins on merit. `.app` is guaranteed: `.app-body` is
+     emitted only as a direct child of `.app` (single call site, shell.js
+     AppShell), and this @container query already requires `.app` as its
+     container ancestor. */
+  .app .app-body,
+  .app .app-body.no-side { grid-template-columns: 1fr; }
   .app-side-shell {
     position: absolute;
     /* Full-height overlay drawer: the merged .app-chrome wraps and its real
@@ -36,9 +44,13 @@
   .app-side-shell.open,
   .app-side.open,
   .app-body.side-open .app-side-shell { transform: translateX(0); }
+  /* No flags needed: the ONLY other rule that touches these properties is the
+     `.app-side` base in topbar.css, which already sets `flex-direction: column`
+     and never sets `flex-wrap` (nowrap is the initial value anyway). This rule
+     is equal-specificity and later in source, so it wins unaided. */
   .app-side {
-    flex-direction: column !important;
-    flex-wrap: nowrap !important;
+    flex-direction: column;
+    flex-wrap: nowrap;
     gap: var(--space-2);
     padding: var(--space-3);
     font-size: var(--fs-sm);

package/src/css/app-shell/states-interactions.css

@@ -56,11 +56,16 @@ button:disabled, [disabled] {
   animation: spinner-rotate 0.8s linear infinite;
 }
 
-/* Error state */
+/* Error state.
+   No !important: the only rule in the kit that also resets a matching element's
+   border-color is the bare-control base below (`textarea:where(:not(.input))`
+   et al, which use the `border: 0` shorthand). Those selectors are (0,0,1) —
+   the :where() guard adds nothing — so every selector in this list out-specifies
+   them on merit, and specificity beats the later source position. */
 .error, [data-state="error"],
 .row.error, input.error,
 textarea.error {
-  border-color: var(--warn) !important;
+  border-color: var(--warn);
   background-color: color-mix(in oklab, var(--warn) 6%, var(--bg));
 }
 .error::placeholder { color: color-mix(in oklab, var(--warn) 60%, var(--fg-3)); }
@@ -576,7 +581,17 @@ input[type="password"]:not(:placeholder-shown) + .input-clear {
 .skip-to-main:focus { top: 10px; }
 
 /* Reduced motion preferences — scoped to the DS surface so it doesn't reach
-   into and neutralize the host document's own motion. */
+   into and neutralize the host document's own motion.
+   The !important flags here are LOAD-BEARING and must not be "cleaned up":
+   `.ds-247420 *` / `.app *` is only (0,1,0) — the universal selector adds
+   nothing — yet it has to defeat every animation/transition declaration in the
+   kit, many of which are strictly more specific. Concrete rules it would
+   otherwise lose to: `.ds-dropzone.dragover` (0,2,0, files.css),
+   `.ds-upload-bar.indeterminate .ds-upload-fill` (0,3,0, files.css),
+   `.list-item.drag-after::after` (0,2,1, this file). Raising this selector to
+   out-specify an open-ended set of future component rules is not possible, so
+   the flag is the only correct mechanism — this is a WCAG 2.3.3 guarantee,
+   not a stylistic preference. */
 @media (prefers-reduced-motion: reduce) {
   .ds-247420 *, .app * {
     animation-duration: 0.01ms !important;
@@ -584,7 +599,9 @@ input[type="password"]:not(:placeholder-shown) + .input-clear {
     transition-duration: 0.01ms !important;
   }
   /* Kill the residual paint frame of looping skeleton/shimmer placeholders and
-     give reduced-motion users a steady placeholder fill instead. */
+     give reduced-motion users a steady placeholder fill instead.
+     Also load-bearing: `.skeleton` is (0,1,0) and must override
+     `.ds-session-row-skeleton .ds-skel` (0,2,0), which sets its own shimmer. */
   .skeleton, .ds-skeleton, .ds-session-row-skeleton .ds-skel {
     animation: none !important;
     background: var(--bg-2) !important;

package/src/css/app-shell/topbar.css

@@ -201,7 +201,11 @@ body.canvas-host { background: transparent !important; }
   border-radius: var(--r-pill);
 }
 /* The lime active pill is the sidebar's one accent moment; its own count
-   chip rides the ink-on-accent pair instead of a second competing hue. */
+   chip rides the ink-on-accent pair instead of a second competing hue.
+   The bare --accent here is deliberate and is NOT the usual accent-as-text
+   defect: the chip's own background is --accent-fg (ink), so this is the
+   INVERTED pair -- lime on ink, which is the high-contrast direction. Only
+   accent-coloured text on a normal background needs --accent-ink. */
 .app-side a.active .count {
   background: color-mix(in oklab, var(--accent-fg) 82%, transparent);
   color: var(--accent);