@morscherlab/mint-sdk 1.4.0-beta.9 → 1.4.1

package/dist/styles.css

@@ -48,36 +48,35 @@
   margin: 0 auto;
 }
 
-.mint-generated-result[data-v-d4b8e2aa] {
+.mint-generated-result[data-v-f242a75c] {
   width: 100%;
 }
-.mint-generated-result__text[data-v-d4b8e2aa],
-.mint-generated-result__json[data-v-d4b8e2aa] {
+.mint-generated-result__text[data-v-f242a75c],
+.mint-generated-result__json[data-v-f242a75c] {
   margin: 0;
   color: var(--text-primary);
 }
-.mint-generated-result__text[data-v-d4b8e2aa] {
+.mint-generated-result__text[data-v-f242a75c] {
   max-width: 72ch;
   white-space: pre-wrap;
   line-height: 1.65;
 }
-.mint-generated-result__json[data-v-d4b8e2aa] {
+.mint-generated-result__json[data-v-f242a75c] {
   overflow: auto;
-  padding: 1rem;
-  border: 1px solid var(--border-color);
-  border-radius: 0.75rem;
-  background: var(--bg-secondary);
+  padding: 0.75rem 1rem;
+  border-radius: var(--radius-md);
+  background: var(--bg-tertiary);
   font-size: 0.8125rem;
   line-height: 1.55;
   white-space: pre-wrap;
 }
-.mint-generated-result__image[data-v-d4b8e2aa] {
+.mint-generated-result__image[data-v-f242a75c] {
   display: block;
   max-width: 100%;
   height: auto;
   margin: 0 auto;
 }
-.mint-generated-result__artifact[data-v-d4b8e2aa] {
+.mint-generated-result__artifact[data-v-f242a75c] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -122,14 +121,14 @@
   overflow-wrap: anywhere;
 }
 
-.mint-generated-workspace[data-v-41f5ec2e] {
+.mint-generated-workspace[data-v-c8ff991b] {
   position: relative;
   min-width: 0;
   min-height: calc(100vh - 5rem);
   padding: clamp(1rem, 2.5vw, 2.5rem);
   background: var(--bg-primary);
 }
-.mint-generated-workspace__loading[data-v-41f5ec2e] {
+.mint-generated-workspace__loading[data-v-c8ff991b] {
   display: flex;
   min-height: 24rem;
   align-items: center;
@@ -137,7 +136,7 @@
   gap: 0.75rem;
   color: var(--text-secondary);
 }
-.mint-generated-workspace__header[data-v-41f5ec2e] {
+.mint-generated-workspace__header[data-v-c8ff991b] {
   display: flex;
   align-items: flex-start;
   justify-content: space-between;
@@ -145,29 +144,29 @@
   max-width: 76rem;
   margin: 0 auto 1.25rem;
 }
-.mint-generated-workspace__header h1[data-v-41f5ec2e] {
+.mint-generated-workspace__header h1[data-v-c8ff991b] {
   margin: 0;
   color: var(--text-primary);
   font-size: clamp(1.35rem, 2vw, 1.8rem);
   line-height: 1.2;
 }
-.mint-generated-workspace__header p[data-v-41f5ec2e]:not(.mint-generated-workspace__eyebrow) {
+.mint-generated-workspace__header p[data-v-c8ff991b]:not(.mint-generated-workspace__eyebrow) {
   margin: 0.4rem 0 0;
   color: var(--text-secondary);
 }
-.mint-generated-workspace__eyebrow[data-v-41f5ec2e] {
+.mint-generated-workspace__eyebrow[data-v-c8ff991b] {
   margin: 0 0 0.35rem;
   color: var(--text-secondary);
   font-size: 0.72rem;
   font-weight: 700;
 }
-.mint-generated-workspace__resources[data-v-41f5ec2e] {
+.mint-generated-workspace__resources[data-v-c8ff991b] {
   display: flex;
   flex-wrap: wrap;
   justify-content: flex-end;
   gap: 0.4rem;
 }
-.mint-generated-workspace__resources span[data-v-41f5ec2e] {
+.mint-generated-workspace__resources span[data-v-c8ff991b] {
   padding: 0.3rem 0.55rem;
   border: 1px solid var(--border-color);
   border-radius: 999px;
@@ -176,7 +175,7 @@
   font-size: 0.75rem;
   font-weight: 600;
 }
-.mint-generated-workspace__result[data-v-41f5ec2e] {
+.mint-generated-workspace__result[data-v-c8ff991b] {
   max-width: 76rem;
   min-height: 24rem;
   margin: 0 auto;
@@ -187,10 +186,10 @@
   box-shadow: var(--shadow-sm);
 }
 @media (max-width: 640px) {
-.mint-generated-workspace__header[data-v-41f5ec2e] {
+.mint-generated-workspace__header[data-v-c8ff991b] {
     flex-direction: column;
 }
-.mint-generated-workspace__resources[data-v-41f5ec2e] {
+.mint-generated-workspace__resources[data-v-c8ff991b] {
     justify-content: flex-start;
 }
 }
@@ -303,7 +302,7 @@
 
 
 
-
+@layer theme, base, components, utilities;
 /* MINT SDK Styles - Main entry point
  * This file combines all SDK styles for proper bundling
  */
@@ -315,6 +314,9 @@
  * @import '@morscherlab/mint-sdk/styles';
  */
 
+/* Tailwind v4's layer order, declared first so the SDK's base and utilities
+   layers sort the same way with or without Tailwind in the host. */
+
 /* ==========================================================================
    CSS Variables - Light Mode
    ========================================================================== */
@@ -357,13 +359,8 @@
      where --text-secondary would drop to ~4.35:1. */
   --text-secondary-strong: #475569;
 
-  /* Brand colors — one teal accent: teal-600 fills, teal-700 hover + ink,
-     teal-800 pressed. White on #0D9488 is 3.74:1, a known AA exception. */
-  --color-primary: #0D9488;
-  --color-primary-hover: #0F766E;
-  --color-primary-pressed: #115E59;
-  --color-primary-soft: rgba(13, 148, 136, 0.10);
-  --color-primary-border: #99F6E4;
+  /* Brand colors: the accent (--color-primary*) comes from the palette
+     blocks below the dark block (html[data-palette], default teal). */
   /* Fixed teal scale, the same in both themes. */
   --color-primary-50: #F0FDFA;
   --color-primary-100: #CCFBF1;
@@ -445,6 +442,8 @@
   --form-height-md: 2rem;
   --form-height-lg: 2.5rem;
   --mint-gutter: 0.5rem;
+  /* Distance from the outermost cards to the window edge, in every density. */
+  --mint-page-inset: 1rem;
 
   /* Semantic colors */
   --mint-success: #10B981;
@@ -479,7 +478,7 @@
   /* Soft focus rings — 3px translucent. Used by all form primitives
      post-0.16 visual refresh. Solid variants above kept for legacy
      components that haven't migrated yet. */
-  --focus-ring-soft: 0 0 0 3px rgba(13, 148, 136, 0.18);
+  --focus-ring-soft: 0 0 0 3px color-mix(in srgb, var(--color-primary) 18%, transparent);
   /* Red is perceptually brighter than teal at equal alpha; drop 2pp to keep visual weight matched. */
   --focus-ring-soft-error: 0 0 0 3px rgba(239, 68, 68, 0.18);
 
@@ -501,6 +500,12 @@
   --mint-border-focus: var(--color-primary);
   /* Colour-only transitions; no lift, bounce or glow. */
   --mint-transition: 120ms ease;
+  /* Stacking layers: modal < jobs tray < onboarding tour < floating panels < tooltips and toasts. */
+  --mint-z-modal: 50;
+  --mint-z-tray: 1000;
+  --mint-z-tour: 1100;
+  --mint-z-popover: 1200;
+  --mint-z-toast: 9999;
 }
 
 /* ==========================================================================
@@ -517,12 +522,7 @@ html.dark {
   --border-light: #172033;
   --border-strong: #334155;
 
-  /* Brand colors - Dark mode (CTA, purple and entity aliases follow) */
-  --color-primary: #2DD4BF;
-  --color-primary-hover: #5EEAD4;
-  --color-primary-pressed: #99F6E4;
-  --color-primary-soft: rgba(45, 212, 191, 0.12);
-  --color-primary-border: rgba(45, 212, 191, 0.35);
+  /* Brand colors - Dark mode: the accent comes from the palette blocks below. */
   /* Dark ink on the light accent fill (10.1:1 on #2DD4BF). */
   --text-on-accent: #0B1120;
   --color-experiment-hover: #E2E8F0;
@@ -558,7 +558,7 @@ html.dark {
 
   /* Focus ring - dark mode offset uses bg-primary instead of white */
   --focus-ring-offset: 0 0 0 2px var(--bg-primary), 0 0 0 4px var(--color-primary);
-  --focus-ring-soft: 0 0 0 3px rgba(45, 212, 191, 0.22);
+  --focus-ring-soft: 0 0 0 3px color-mix(in srgb, var(--color-primary) 22%, transparent);
   --focus-ring-soft-error: 0 0 0 3px rgba(248, 113, 113, 0.26);
 
   /* Legacy aliases */
@@ -568,6 +568,122 @@ html.dark {
   color-scheme: dark;
 }
 
+/* Accent palettes (Settings → Color palette). The settings store writes
+   html[data-palette]; the palette swatches set the same attribute on their
+   strip to preview a palette. Each palette is one accent in both themes: white
+   text on the light-mode fill, dark text (--text-on-accent) on the dark-mode
+   fill. Hues come from the biology plot-style palettes. */
+
+/* Teal (default): teal-600 fill, teal-700 hover + ink, teal-800 pressed.
+   White on #0D9488 is 3.74:1, a known AA exception. */
+:root,
+[data-palette="default"] {
+  --color-primary: #0D9488;
+  --color-primary-hover: #0F766E;
+  --color-primary-pressed: #115E59;
+  --color-primary-soft: rgba(13, 148, 136, 0.10);
+  --color-primary-border: #99F6E4;
+}
+html.dark,
+html.dark [data-palette="default"] {
+  --color-primary: #2DD4BF;
+  --color-primary-hover: #5EEAD4;
+  --color-primary-pressed: #99F6E4;
+  --color-primary-soft: rgba(45, 212, 191, 0.12);
+  --color-primary-border: rgba(45, 212, 191, 0.35);
+}
+
+/* Colour-blind safe: Okabe-Ito blue accent, and Okabe-Ito bluish green,
+   vermilion and orange for status, so success and error differ for every
+   colour-vision type. White on #0072B2 is 5.19:1. */
+:root[data-palette="colorblind"],
+[data-palette="colorblind"] {
+  --color-primary: #0072B2;
+  --color-primary-hover: #005F94;
+  --color-primary-pressed: #004C77;
+  --color-primary-soft: rgba(0, 114, 178, 0.10);
+  --color-primary-border: #B3D5EA;
+  --mint-success: #009E73;
+  --mint-success-hover: #00805D;
+  --mint-success-bg: rgba(0, 158, 115, 0.1);
+  --mint-success-border: rgba(0, 158, 115, 0.3);
+  --mint-error: #D55E00;
+  --mint-error-hover: #B34E00;
+  --mint-error-bg: rgba(213, 94, 0, 0.1);
+  --mint-error-border: rgba(213, 94, 0, 0.3);
+  --mint-warning: #E69F00;
+  --mint-warning-hover: #C78800;
+  --mint-warning-bg: rgba(230, 159, 0, 0.1);
+  --mint-warning-border: rgba(230, 159, 0, 0.3);
+  --mint-warning-text: #8F5F00;
+}
+html.dark[data-palette="colorblind"],
+html.dark [data-palette="colorblind"] {
+  --color-primary: #56B4E9;
+  --color-primary-hover: #7CC5EE;
+  --color-primary-pressed: #A3D6F3;
+  --color-primary-soft: rgba(86, 180, 233, 0.14);
+  --color-primary-border: rgba(86, 180, 233, 0.38);
+  --mint-success-bg: rgba(0, 158, 115, 0.15);
+  --mint-error-bg: rgba(213, 94, 0, 0.15);
+  --mint-warning-bg: rgba(230, 159, 0, 0.15);
+  --mint-warning-text: #FCD34D;
+}
+
+/* Purple: plot-style purple #8781bd, deepened so white text is 5.15:1. */
+:root[data-palette="purple"],
+[data-palette="purple"] {
+  --color-primary: #6B64B0;
+  --color-primary-hover: #5A539E;
+  --color-primary-pressed: #4A448A;
+  --color-primary-soft: rgba(107, 100, 176, 0.10);
+  --color-primary-border: #D3D0EC;
+}
+html.dark[data-palette="purple"],
+html.dark [data-palette="purple"] {
+  --color-primary: #A9A3DB;
+  --color-primary-hover: #C2BDE7;
+  --color-primary-pressed: #D8D4F1;
+  --color-primary-soft: rgba(169, 163, 219, 0.14);
+  --color-primary-border: rgba(169, 163, 219, 0.38);
+}
+
+/* Ocean: plot-style ocean ramp, #2171B5 fill (white 5.13:1), #6BAED6 dark. */
+:root[data-palette="ocean"],
+[data-palette="ocean"] {
+  --color-primary: #2171B5;
+  --color-primary-hover: #1B5F99;
+  --color-primary-pressed: #164E7E;
+  --color-primary-soft: rgba(33, 113, 181, 0.10);
+  --color-primary-border: #BBD7EE;
+}
+html.dark[data-palette="ocean"],
+html.dark [data-palette="ocean"] {
+  --color-primary: #6BAED6;
+  --color-primary-hover: #8EC2E2;
+  --color-primary-pressed: #B0D5EC;
+  --color-primary-soft: rgba(107, 174, 214, 0.14);
+  --color-primary-border: rgba(107, 174, 214, 0.38);
+}
+
+/* Forest: plot-style forest_clay, #2F6B4F fill (white 6.29:1), #7AA874 dark. */
+:root[data-palette="forest"],
+[data-palette="forest"] {
+  --color-primary: #2F6B4F;
+  --color-primary-hover: #275A42;
+  --color-primary-pressed: #1F4935;
+  --color-primary-soft: rgba(47, 107, 79, 0.10);
+  --color-primary-border: #BFD8C6;
+}
+html.dark[data-palette="forest"],
+html.dark [data-palette="forest"] {
+  --color-primary: #7AA874;
+  --color-primary-hover: #95BC90;
+  --color-primary-pressed: #B1CFAD;
+  --color-primary-soft: rgba(122, 168, 116, 0.14);
+  --color-primary-border: rgba(122, 168, 116, 0.38);
+}
+
 /* Comfortable density (html[data-density], written by the settings store):
    the pre-v2 control heights and a wider gutter. */
 [data-density="comfortable"] {
@@ -591,6 +707,22 @@ body {
   transition: background-color 0.15s, color 0.15s;
 }
 
+/* No page-level rubber-band bounce or pull-to-refresh; overflow: hidden does
+   not stop it. Panels still scroll, and their overscroll stops at their own
+   edge. A browser tab keeps the horizontal swipe for back and forward; an
+   installed PWA has no history swipe, so it drops both axes. */
+html,
+body {
+  overscroll-behavior-y: none;
+}
+
+@media (display-mode: standalone) {
+  html,
+  body {
+    overscroll-behavior: none;
+  }
+}
+
 code, pre {
   font-family: var(--font-mono);
 }
@@ -654,6 +786,9 @@ button, input, select, textarea {
 /* ==========================================================================
    MINT Utility Classes (for Tailwind v4 compatibility)
    ========================================================================== */
+/* In Tailwind's utilities layer: unlayered, these beat every layered rule, so a
+   host's responsive variant (`lg:flex-row`) lost to the SDK's `.flex-col`. */
+@layer utilities {
 .bg-bg-hover {
   background-color: var(--bg-tertiary);
 }
@@ -1029,6 +1164,7 @@ button, input, select, textarea {
 .max-w-sm {
   max-width: 24rem;
 }
+} /* @layer utilities */
 
 /* ==========================================================================
    Reduced Motion
@@ -1215,7 +1351,7 @@ button, input, select, textarea {
 
 .mint-action-menu__panel {
   position: fixed;
-  z-index: 1000;
+  z-index: var(--mint-z-popover);
   min-width: 10rem;
   max-width: min(18rem, calc(100vw - 1rem));
 }
@@ -1490,10 +1626,11 @@ button, input, select, textarea {
 }
 
 /* Floating variant: all sections appear as separate cards on a background,
-   spaced by the density gutter (8px, 12px comfortable). */
+   16px from the window edge and spaced by the density gutter (8px, 12px
+   comfortable). */
 .mint-layout--floating {
   background-color: var(--bg-primary);
-  padding: var(--mint-gutter);
+  padding: var(--mint-page-inset);
   gap: var(--mint-gutter);
 }
 
@@ -1553,8 +1690,10 @@ button, input, select, textarea {
     transform: translateX(calc(100% + 1rem));
   }
 
+  /* `none`, not translateX(0): any transform makes the sidebar the containing
+     block of its fixed dropdown panels, and its overflow would clip them. */
   .mint-layout--responsive-sidebar.mint-layout--sidebar-open .mint-layout__sidebar {
-    transform: translateX(0);
+    transform: none;
   }
 
   .mint-layout--responsive-sidebar .mint-layout__sidebar-toggle {
@@ -2267,10 +2406,10 @@ button, input, select, textarea {
   padding: 0 0.375rem 0 0;
 }
 
-/* Variant: card - flat floating card, inset by the layout gutter */
+/* Variant: card - flat floating card, inset 16px from the window edge */
 .mint-topbar--card {
-  width: calc(100% - 2 * var(--mint-gutter));
-  margin: var(--mint-gutter) var(--mint-gutter) 0;
+  width: calc(100% - 2 * var(--mint-page-inset));
+  margin: var(--mint-page-inset) var(--mint-page-inset) 0;
   padding: 0.375rem 0.5rem 0.375rem 0.625rem;
   border-radius: var(--radius-lg);
   border: 1px solid var(--border-color);
@@ -2388,6 +2527,168 @@ button, input, select, textarea {
   white-space: nowrap;
   user-select: none;
 }
+
+/* ─── Run slot: [ experiment | job ] ───
+   While a job shows, one border wraps the experiment chip and the job
+   segment, as the experiment popover does for Save. The wrapper does not
+   clip: the popover panel and the focus rings reach outside it, so each
+   segment rounds its own outer corners. The idle Jobs button stands apart
+   with its own border. */
+.mint-topbar__run-slot {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  min-width: 0;
+}
+
+.mint-topbar__run-slot--joined {
+  gap: 0;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: var(--bg-card);
+}
+
+.mint-topbar__run-slot--joined .mint-experiment-popover,
+.mint-topbar__run-slot--joined .mint-experiment-popover__trigger {
+  border: 0;
+  border-radius: calc(var(--radius-md) - 1px) 0 0 calc(var(--radius-md) - 1px);
+}
+
+/* The job takes the name's place: the name folds away while the job grows in,
+   and the code badge stays. The name stays in the accessible name. A trigger
+   with no code, the empty placeholder and the error text keep their text. */
+.mint-topbar__run-slot .mint-experiment-popover__trigger-text {
+  transition:
+    max-width 200ms ease,
+    opacity 150ms ease,
+    margin 200ms ease;
+}
+
+.mint-topbar__run-slot--joined
+  .mint-experiment-popover__trigger:has(.mint-exp-code)
+  .mint-experiment-popover__trigger-text {
+  max-width: 0 !important; /* beats the inline maxNameWidth */
+  margin-inline-start: -0.5rem; /* takes back the trigger gap */
+  opacity: 0;
+}
+
+.mint-topbar__job {
+  display: inline-flex;
+  max-width: 6rem; /* close to the content (icon + bar, or "Jobs"), so the fold is even */
+  overflow: hidden;
+  align-items: center;
+  gap: 0.375rem;
+  flex-shrink: 0;
+  height: 30px;
+  padding: 0 0.625rem;
+  border: 0;
+  background: transparent;
+  color: var(--text-secondary);
+  font: inherit;
+  font-size: 0.75rem;
+  font-weight: 500;
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background-color var(--mint-transition);
+}
+
+.mint-topbar__run-slot--joined .mint-topbar__job {
+  border-radius: calc(var(--radius-md) - 1px);
+}
+
+.mint-topbar__run-slot--joined .mint-experiment-popover + .mint-topbar__job {
+  border-left: 1px solid var(--border-color);
+  border-radius: 0 calc(var(--radius-md) - 1px) calc(var(--radius-md) - 1px) 0;
+}
+
+.mint-topbar__job--idle {
+  height: 32px;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: var(--bg-card);
+}
+
+.mint-topbar__job--idle:hover,
+.mint-topbar__job--neutral:hover {
+  background: var(--bg-hover);
+}
+
+.mint-topbar__job:focus-visible {
+  outline: none;
+  box-shadow: inset var(--focus-ring);
+}
+
+.mint-topbar__job--primary { background: var(--color-primary-soft); color: var(--_ink-primary); }
+.mint-topbar__job--warning { background: var(--mint-warning-bg); color: var(--mint-warning-text); }
+.mint-topbar__job--success { background: var(--mint-success-bg); color: color-mix(in srgb, var(--mint-success) 50%, var(--text-primary)); }
+.mint-topbar__job--error { background: var(--mint-error-bg); color: var(--_ink-error); }
+
+.mint-topbar__job--primary:hover,
+.mint-topbar__job--warning:hover,
+.mint-topbar__job--success:hover,
+.mint-topbar__job--error:hover {
+  filter: brightness(0.97);
+}
+
+.mint-topbar__job-icon {
+  flex-shrink: 0;
+}
+
+.mint-topbar__job-count {
+  color: var(--text-muted);
+  font-family: var(--font-mono);
+  font-size: 0.6875rem;
+  font-variant-numeric: tabular-nums;
+}
+
+.mint-topbar__job-icon--spin {
+  animation: mint-topbar-job-spin 1s linear infinite;
+}
+
+@keyframes mint-topbar-job-spin {
+  to { transform: rotate(360deg); }
+}
+
+.mint-topbar__job-bar {
+  width: 2rem;
+  height: 4px;
+  border-radius: 2px;
+  background: var(--border-color);
+  overflow: hidden;
+}
+
+.mint-topbar__job-bar > span {
+  display: block;
+  height: 100%;
+  background: var(--color-primary);
+  transition: width var(--mint-transition);
+}
+
+/* Enter and leave: the job grows in from zero width and folds back out. */
+.mint-topbar-job-enter-active,
+.mint-topbar-job-leave-active {
+  transition:
+    max-width 200ms ease,
+    padding 200ms ease,
+    opacity 150ms ease;
+}
+
+.mint-topbar-job-enter-from,
+.mint-topbar-job-leave-to {
+  max-width: 0;
+  padding-inline: 0;
+  opacity: 0;
+}
+
+/* Screen-reader only: announces status changes of the shown job. */
+.mint-topbar__job-status {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+}
 /* BaseButton Component Styles */
 
 .mint-button {
@@ -2540,6 +2841,14 @@ button, input, select, textarea {
   height: 1.25rem;
 }
 
+/* Flex centring centres the line box, and Geist's ascender puts the caps
+   about 1.6px above the middle. Trim the text box to cap height and baseline
+   so the caps sit on the centre line. Browsers without text-box keep the
+   untrimmed box. */
+.mint-button__label {
+  text-box: trim-both cap alphabetic;
+}
+
 /* Spinner */
 .mint-button__spinner {
   animation: mint-button-spin 1s linear infinite;
@@ -3249,11 +3558,13 @@ button, input, select, textarea {
   height: 0.875rem;
 }
 
-/* Calendar dropdown (teleported to body, positioned via JS). */
+/* Calendar dropdown (teleported to body, positioned by useFloatingPanel). */
 .mint-date-picker__dropdown {
   position: fixed;
-  z-index: 9999;
+  z-index: var(--mint-z-popover);
   width: 252px;
+  max-height: var(--mint-floating-available-height, none);
+  overflow-y: auto;
   padding: 0.5rem;
 }
 
@@ -4033,11 +4344,9 @@ button, input, select, textarea {
   }
 }
 
+/* The compact jobs panel of design v2: opened from the top-bar run slot, one list
+   (Active, then Finished), one row per job. Non-modal: the page is not dimmed. */
 .mint-jobs-tray {
-  position: fixed;
-  right: max(1.25rem, env(safe-area-inset-right));
-  bottom: max(1.25rem, env(safe-area-inset-bottom));
-  z-index: 1000;
   color: var(--text-primary);
   font-family: var(--font-sans);
 }
@@ -4047,146 +4356,79 @@ button, input, select, textarea {
   --border-light: var(--border-color);
 }
 
-.mint-jobs-tray__trigger {
-  display: inline-flex;
-  min-height: 2.75rem;
-  align-items: center;
-  gap: 0.625rem;
-  padding: 0.5rem 1rem;
-  border: 0;
-  border-radius: var(--radius-lg);
-  background: var(--color-primary);
-  color: var(--text-on-accent);
-  box-shadow: var(--mint-shadow-pop);
-  cursor: pointer;
-  transition: background var(--mint-transition);
-}
-
-.mint-jobs-tray__trigger:hover {
-  background: var(--color-primary-hover);
-}
-
-.mint-jobs-tray__trigger:focus-visible,
-.mint-jobs-tray__panel:focus-visible,
-.mint-jobs-tray button:focus-visible {
-  outline: none;
-  box-shadow: var(--focus-ring-offset);
-}
-
-.mint-jobs-tray__trigger-icon {
-  width: 1.125rem;
-  height: 1.125rem;
-  stroke-width: 1.8;
-  stroke-linecap: round;
-  stroke-linejoin: round;
-}
-
-.mint-jobs-tray__trigger-icon--active {
-  animation: mint-jobs-tray-pulse 1.8s ease-in-out infinite;
-}
-
-.mint-jobs-tray__trigger-label {
-  font-size: 0.875rem;
-  font-weight: 600;
-}
-
-.mint-jobs-tray__count,
-.mint-jobs-tray__tab-count {
-  display: inline-flex;
-  min-width: 1.25rem;
-  height: 1.25rem;
-  align-items: center;
-  justify-content: center;
-  padding: 0 0.375rem;
-  border-radius: var(--radius-sm);
-  font: 600 0.6875rem/1 var(--font-mono);
-}
-
-/* Inverted on the accent fill: accent ink on the on-accent colour, in both themes. */
-.mint-jobs-tray__count {
-  background: var(--text-on-accent);
-  color: var(--_ink-primary);
-}
-
-.mint-jobs-tray__backdrop {
+/* Transparent: catches clicks outside the panel. */
+.mint-jobs-tray__scrim {
   position: fixed;
   inset: 0;
-  z-index: -2;
-  background: rgb(15 23 42 / 0.22);
+  z-index: calc(var(--mint-z-tray) - 1);
 }
 
 .mint-jobs-tray__panel {
-  position: absolute;
-  right: 0;
-  bottom: 3.75rem;
+  position: fixed;
+  top: calc(4.5rem + env(safe-area-inset-top));
+  right: max(1rem, env(safe-area-inset-right));
+  z-index: var(--mint-z-tray);
   display: flex;
-  width: min(21.25rem, calc(100vw - 2rem));
-  max-height: min(42rem, calc(100vh - 7rem));
+  width: min(360px, calc(100vw - 2rem));
+  max-height: 75vh;
   flex-direction: column;
   overflow: hidden;
   border: 1px solid var(--border-color);
   border-radius: var(--radius-lg);
   background: var(--bg-card);
   box-shadow: var(--mint-shadow-pop);
+  font-size: 0.8125rem;
 }
 
-.mint-jobs-tray__header,
-.mint-jobs-tray__job-heading,
-.mint-jobs-tray__job-footer,
-.mint-jobs-tray__header-actions,
-.mint-jobs-tray__clear-row {
-  display: flex;
-  align-items: center;
+/* The panel takes focus only so Escape and Tab start inside it; it shows no ring. */
+.mint-jobs-tray__panel:focus {
+  outline: none;
 }
 
-.mint-jobs-tray__header {
-  justify-content: space-between;
-  height: 2.5rem;
-  padding: 0 0.5rem 0 0.75rem;
-  border-bottom: 1px solid var(--border-color);
+.mint-jobs-tray button:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring);
 }
 
-.mint-jobs-tray__header > div:first-child {
+.mint-jobs-tray__head {
   display: flex;
-  align-items: baseline;
+  flex-shrink: 0;
+  align-items: center;
   gap: 0.5rem;
-  min-width: 0;
+  height: 40px;
+  padding: 0 0.5rem 0 0.75rem;
+  border-bottom: 1px solid var(--border-color);
 }
 
 .mint-jobs-tray__title {
-  flex-shrink: 0;
   margin: 0;
-  color: var(--text-primary);
   font-size: 0.8125rem;
   font-weight: 600;
   white-space: nowrap;
 }
 
-.mint-jobs-tray__subtitle {
+.mint-jobs-tray__head-count {
+  flex: 1;
   min-width: 0;
-  margin: 0;
   overflow: hidden;
-  color: var(--text-muted);
-  font: 0.6875rem/1.3 var(--font-mono);
+  color: var(--text-secondary);
+  font-family: var(--font-mono);
+  font-size: 0.6875rem;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
-.mint-jobs-tray__header-actions {
-  gap: 0.25rem;
-}
-
 .mint-jobs-tray__icon-button {
-  display: inline-flex;
-  width: 2rem;
-  height: 2rem;
-  align-items: center;
-  justify-content: center;
+  display: inline-grid;
+  width: 28px;
+  height: 28px;
+  flex-shrink: 0;
+  place-items: center;
   padding: 0;
   border: 0;
   border-radius: var(--radius-md);
   background: transparent;
-  color: var(--text-secondary-strong);
+  color: var(--text-secondary);
   cursor: pointer;
   transition: background var(--mint-transition), color var(--mint-transition);
 }
@@ -4196,175 +4438,143 @@ button, input, select, textarea {
   color: var(--text-primary);
 }
 
-.mint-jobs-tray__icon-button svg {
-  width: 1rem;
-  height: 1rem;
-  stroke-width: 1.8;
-  stroke-linecap: round;
-  stroke-linejoin: round;
+.mint-jobs-tray__icon-button--danger,
+.mint-jobs-tray__icon-button--danger:hover {
+  color: var(--mint-error);
 }
 
-.mint-jobs-tray__icon-button--danger {
-  color: var(--mint-error);
+.mint-jobs-tray__error {
+  margin: 0.5rem 0.75rem 0;
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--mint-error-border);
+  border-radius: var(--radius-md);
+  background: var(--mint-error-bg);
+  color: var(--_ink-error);
+  font-size: 0.75rem;
 }
 
-.mint-jobs-tray__tabs {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  border-bottom: 1px solid var(--border-color);
+.mint-jobs-tray__body {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  scrollbar-color: var(--scrollbar-thumb) transparent;
 }
 
-.mint-jobs-tray__tab {
-  position: relative;
-  display: inline-flex;
-  min-height: 2.75rem;
-  align-items: center;
-  justify-content: center;
-  gap: 0.375rem;
-  padding: 0.5rem 1rem;
-  border: 0;
-  background: transparent;
-  color: var(--text-secondary-strong);
-  font: 500 0.8125rem/1 var(--font-sans);
-  cursor: pointer;
+.mint-jobs-tray__empty {
+  margin: 0;
+  padding: 1.5rem 0.75rem;
+  color: var(--text-secondary);
+  text-align: center;
 }
 
-.mint-jobs-tray__tab--active {
-  color: var(--_ink-primary);
+.mint-jobs-tray__section {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.625rem 0.75rem 0.25rem;
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  font-weight: 600;
 }
 
-.mint-jobs-tray__tab--active::after {
-  position: absolute;
-  right: 1rem;
-  bottom: 0;
-  left: 1rem;
-  height: 2px;
-  background: var(--color-primary);
-  content: '';
+.mint-jobs-tray__section-count {
+  color: var(--text-muted);
+  font-family: var(--font-mono);
+  font-weight: 500;
 }
 
-.mint-jobs-tray__tab-count {
-  background: var(--bg-tertiary);
-  color: currentColor;
+.mint-jobs-tray__section-action {
+  margin-left: auto;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--text-secondary);
+  font: inherit;
+  font-weight: 500;
+  cursor: pointer;
 }
 
-.mint-jobs-tray__error {
-  margin: 0.75rem 1rem;
-  padding: 0.625rem 0.75rem;
-  border: 1px solid var(--mint-error-border);
-  border-radius: var(--radius-md);
-  background: var(--mint-error-bg);
+.mint-jobs-tray__section-action:hover {
   color: var(--mint-error);
-  font-size: 0.75rem;
 }
 
-.mint-jobs-tray__body {
-  flex: 1;
-  overflow-y: auto;
-  scrollbar-color: var(--scrollbar-thumb) transparent;
-}
-
-.mint-jobs-tray__empty {
-  margin: 0;
-  padding: 3rem 1rem;
-  color: var(--text-secondary);
-  text-align: center;
-  font-size: 0.8125rem;
+/* Rows + hairlines, no card per job. */
+.mint-jobs-tray__row {
+  display: grid;
+  grid-template-columns: 16px minmax(0, 1fr) auto;
+  align-items: center;
+  gap: 0.25rem 0.625rem;
+  padding: 0.5rem 0.5rem 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--border-light);
 }
 
-/* 2f: rows + hairlines, no card per job. */
-.mint-jobs-tray__job {
-  padding: 0.625rem 0.75rem;
-  border-bottom: 1px solid var(--border-light);
+.mint-jobs-tray__row:hover {
+  background: var(--bg-hover);
 }
 
 /* The one state that needs a person: tinted and pinned first. */
-.mint-jobs-tray__job--awaiting-input {
+.mint-jobs-tray__row--awaiting-input,
+.mint-jobs-tray__row--awaiting-input:hover {
   background: var(--mint-warning-bg);
 }
 
-.mint-jobs-tray__job-heading,
-.mint-jobs-tray__job-footer {
-  justify-content: space-between;
-  gap: 0.75rem;
+.mint-jobs-tray__status {
+  color: var(--text-muted);
 }
 
-.mint-jobs-tray__job-identity {
-  flex: 1;
-  min-width: 0;
+.mint-jobs-tray__status--running {
+  color: var(--color-primary);
+  animation: mint-jobs-tray-spin 1s linear infinite;
 }
 
-.mint-jobs-tray__job-select {
-  display: block;
-  max-width: 100%;
+.mint-jobs-tray__status--awaiting-input { color: var(--mint-warning); }
+.mint-jobs-tray__status--completed { color: var(--mint-success); }
+.mint-jobs-tray__status--failed { color: var(--mint-error); }
+
+@keyframes mint-jobs-tray-spin {
+  to { transform: rotate(360deg); }
+}
+
+.mint-jobs-tray__row-title {
+  min-width: 0;
   padding: 0;
   overflow: hidden;
   border: 0;
+  border-radius: var(--radius-sm);
   background: transparent;
   color: var(--text-primary);
-  cursor: pointer;
-  font-size: 0.8125rem;
+  font: inherit;
   font-weight: 500;
   text-align: left;
   text-overflow: ellipsis;
   white-space: nowrap;
+  cursor: pointer;
 }
 
-.mint-jobs-tray__kind {
-  display: block;
-  margin-top: 0.125rem;
-  color: var(--text-secondary);
-  font: 0.6875rem/1.3 var(--font-mono);
-}
-
-/* Status: tone dot + neutral text. Only "waiting for input" and "failed"
-   color their text. */
-.mint-jobs-tray__status {
-  display: inline-flex;
-  flex: 0 0 auto;
+.mint-jobs-tray__tools {
+  display: flex;
   align-items: center;
-  gap: 0.375rem;
-  color: var(--text-secondary-strong);
-  font-size: 0.75rem;
-  --mint-jobs-tray-tone: var(--text-muted);
-}
-
-.mint-jobs-tray__status-dot {
-  width: 0.375rem;
-  height: 0.375rem;
-  border-radius: 9999px;
-  background: var(--mint-jobs-tray-tone);
-}
-
-.mint-jobs-tray__status--running { --mint-jobs-tray-tone: var(--color-primary); }
-.mint-jobs-tray__status--completed { --mint-jobs-tray-tone: var(--mint-success); }
-
-.mint-jobs-tray__status--awaiting-input {
-  --mint-jobs-tray-tone: var(--mint-warning);
-  color: var(--mint-warning-text);
-  font-weight: 600;
-}
-
-.mint-jobs-tray__status--failed {
-  --mint-jobs-tray-tone: var(--mint-error);
-  color: var(--_ink-error);
+  gap: 2px;
 }
 
-.mint-jobs-tray__percent {
-  flex: 0 0 auto;
-  min-width: 2.125rem;
-  color: var(--text-primary);
+.mint-jobs-tray__value {
+  margin-right: 0.375rem;
+  color: var(--text-secondary);
   font-family: var(--font-mono);
-  font-size: 0.75rem;
+  font-size: 0.6875rem;
   font-variant-numeric: tabular-nums;
-  text-align: right;
+}
+
+.mint-jobs-tray__progress,
+.mint-jobs-tray__detail {
+  grid-column: 2 / 4;
 }
 
 .mint-jobs-tray__progress {
-  height: 4px;
-  margin-top: 0.375rem;
+  height: 2px;
   overflow: hidden;
-  border-radius: 2px;
+  border-radius: 1px;
   background: var(--bg-tertiary);
 }
 
@@ -4375,56 +4585,17 @@ button, input, select, textarea {
   transition: width var(--mint-transition);
 }
 
-.mint-jobs-tray__job-footer {
-  min-height: 1.75rem;
-  margin-top: 0.375rem;
+.mint-jobs-tray__detail {
+  min-width: 0;
+  overflow: hidden;
   color: var(--text-secondary);
   font-size: 0.75rem;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
-.mint-jobs-tray__action {
-  min-height: 1.75rem;
-  padding: 0.375rem 0.625rem;
-  border: 1px solid var(--border-color);
-  border-radius: var(--radius);
-  background: var(--bg-secondary);
-  color: var(--text-secondary-strong);
-  font: 500 0.75rem/1 var(--font-sans);
-  cursor: pointer;
-  transition: background var(--mint-transition), border-color var(--mint-transition), color var(--mint-transition);
-}
-
-.mint-jobs-tray__job-actions {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25rem;
-}
-
-/* 2f: the inline action of a row waiting for input is the primary one. */
-.mint-jobs-tray__job--awaiting-input .mint-jobs-tray__action:not(.mint-jobs-tray__action--danger) {
-  border-color: var(--color-primary);
-  background: var(--color-primary);
-  color: var(--text-on-accent);
-}
-
-.mint-jobs-tray__job--awaiting-input .mint-jobs-tray__action:not(.mint-jobs-tray__action--danger):hover {
-  border-color: var(--color-primary-hover);
-  background: var(--color-primary-hover);
-}
-
-.mint-jobs-tray__action--danger {
-  border-color: var(--mint-error-border);
-  color: var(--mint-error);
-}
-
-.mint-jobs-tray__action--danger:hover {
-  background: var(--mint-error-bg);
-}
-
-.mint-jobs-tray__clear-row {
-  justify-content: flex-end;
-  padding: 0.5rem 0.75rem;
-  border-bottom: 1px solid var(--border-light);
+.mint-jobs-tray__detail--error {
+  color: var(--_ink-error);
 }
 
 .mint-jobs-tray button:disabled {
@@ -4432,12 +4603,10 @@ button, input, select, textarea {
   cursor: not-allowed;
 }
 
-/* Overlays fade in 180ms; no lift or scale (v2). */
+/* Overlays fade in; no lift or scale (v2). */
 .mint-jobs-tray-fade-enter-active,
-.mint-jobs-tray-fade-leave-active,
-.mint-jobs-tray-slide-enter-active,
-.mint-jobs-tray-slide-leave-active {
-  transition: opacity 180ms ease;
+.mint-jobs-tray-fade-leave-active {
+  transition: opacity 150ms ease;
 }
 
 .mint-jobs-tray-fade-enter-from,
@@ -4445,31 +4614,6 @@ button, input, select, textarea {
   opacity: 0;
 }
 
-.mint-jobs-tray-slide-enter-from,
-.mint-jobs-tray-slide-leave-to {
-  opacity: 0;
-}
-
-@keyframes mint-jobs-tray-pulse {
-  50% { opacity: 0.55; }
-}
-
-@media (max-width: 480px) {
-  .mint-jobs-tray {
-    right: max(1rem, env(safe-area-inset-right));
-    bottom: max(1rem, env(safe-area-inset-bottom));
-  }
-
-  .mint-jobs-tray__panel {
-    position: fixed;
-    right: 1rem;
-    bottom: 4.75rem;
-    left: 1rem;
-    width: auto;
-    max-height: calc(100vh - 6.75rem - env(safe-area-inset-bottom));
-  }
-}
-
 @media (prefers-reduced-motion: reduce) {
   .mint-jobs-tray *,
   .mint-jobs-tray *::before,
@@ -4481,29 +4625,79 @@ button, input, select, textarea {
   }
 }
 
+/* The tray's confirm dialog sits above the tray and its scrim (BaseModal drops class fallthrough). */
+.mint-modal:has(.mint-jobs-tray__confirm) {
+  z-index: calc(var(--mint-z-tray) + 1);
+}
+/* The handle is the gap between two panels: its layout width (horizontal: height)
+   is the gap, --mint-layout-resize-gap or else --mint-gutter (8px compact, 12px
+   normal). It stretches along the panels, and its bar and a 12px hit area are
+   centred in it, the hit area drawn above the neighbouring panels. */
 .mint-layout-resize-handle {
-  display: flex;
-  flex-shrink: 0;
-  align-items: center;
-  justify-content: center;
+  --_size: var(--mint-layout-resize-gap, var(--mint-gutter, 0.75rem));
+  --_hit: 0.75rem;
+  position: relative;
+  z-index: 10;
+  flex: 0 0 auto;
+  align-self: stretch;
   background: transparent;
   cursor: col-resize;
+  outline: none;
+}
+
+.mint-layout-resize-handle--vertical {
+  justify-self: center;
+  width: var(--_size);
+  min-height: 2.75rem;
+}
+
+.mint-layout-resize-handle--horizontal {
+  justify-self: stretch;
+  min-width: 2.75rem;
+  height: var(--_size);
+  cursor: row-resize;
+}
+
+/* Hit area and focus ring. Pointer events on it go to the handle. */
+.mint-layout-resize-handle::before {
+  position: absolute;
+  border-radius: var(--radius-sm);
+  content: '';
+}
+
+.mint-layout-resize-handle--vertical::before {
+  top: 0;
+  bottom: 0;
+  left: 50%;
+  width: var(--_hit);
+  transform: translateX(-50%);
+}
+
+.mint-layout-resize-handle--horizontal::before {
+  top: 50%;
+  right: 0;
+  left: 0;
+  height: var(--_hit);
+  transform: translateY(-50%);
 }
 
-.mint-layout-resize-handle--vertical { width: 1rem; min-height: 2.75rem; }
-.mint-layout-resize-handle--horizontal { min-width: 2.75rem; height: 1rem; cursor: row-resize; }
+/* Edge handles lie outside the edge and cover exactly the gap. */
 .mint-layout-resize-handle--edge-left,
-.mint-layout-resize-handle--edge-right { position: absolute; top: 0; bottom: 0; z-index: 10; height: auto; }
+.mint-layout-resize-handle--edge-right { position: absolute; top: 0; bottom: 0; }
 .mint-layout-resize-handle--edge-left { left: 0; transform: translateX(-100%); }
 .mint-layout-resize-handle--edge-right { right: 0; transform: translateX(100%); }
 
 .mint-layout-resize-handle__bar {
+  position: absolute;
+  top: 50%;
+  left: 50%;
   display: block;
   width: 0.25rem;
   height: 2.75rem;
   border-radius: 999px;
   background: var(--border-color);
   opacity: 0.72;
+  transform: translate(-50%, -50%);
   transition: background-color 150ms ease, opacity 150ms ease, transform 150ms ease;
 }
 
@@ -4519,29 +4713,25 @@ button, input, select, textarea {
 }
 
 .mint-layout-resize-handle--vertical:hover .mint-layout-resize-handle__bar,
-.mint-layout-resize-handle--vertical:focus-visible .mint-layout-resize-handle__bar { transform: scaleX(1.35); }
+.mint-layout-resize-handle--vertical:focus-visible .mint-layout-resize-handle__bar { transform: translate(-50%, -50%) scaleX(1.35); }
 .mint-layout-resize-handle--horizontal:hover .mint-layout-resize-handle__bar,
-.mint-layout-resize-handle--horizontal:focus-visible .mint-layout-resize-handle__bar { transform: scaleY(1.35); }
+.mint-layout-resize-handle--horizontal:focus-visible .mint-layout-resize-handle__bar { transform: translate(-50%, -50%) scaleY(1.35); }
 
-.mint-layout-resize-handle:focus-visible {
+.mint-layout-resize-handle:focus-visible::before {
   outline: 2px solid var(--color-primary);
-  outline-offset: 2px;
+  outline-offset: -2px;
 }
 
-.mint-layout-resize-handle--edge-left:focus-visible,
-.mint-layout-resize-handle--edge-right:focus-visible { outline-offset: -2px; }
-
 .mint-layout-resize-handle[aria-disabled='true'] { cursor: not-allowed; opacity: 0.5; }
 
 @media (prefers-reduced-motion: reduce) {
   .mint-layout-resize-handle__bar { transition: none; }
 }
 
+/* Touch: the handle reserves its full 2.75rem hit area in the layout. */
 @media (pointer: coarse) {
-  .mint-layout-resize-handle--vertical { width: 2.75rem; }
-  .mint-layout-resize-handle--horizontal { height: 2.75rem; }
+  .mint-layout-resize-handle { --_size: 2.75rem; --_hit: 2.75rem; }
 }
-
 /* BaseInput Component Styles */
 
 .mint-input {
@@ -4711,7 +4901,7 @@ button, input, select, textarea {
 .mint-modal {
   position: fixed;
   inset: 0;
-  z-index: 50;
+  z-index: var(--mint-z-modal);
   display: flex;
   padding: 1rem;
 }
@@ -4815,7 +5005,7 @@ button, input, select, textarea {
   width: 2.5rem;
   height: 3px;
   background-color: var(--border-color);
-  border-radius: 9999px;
+  border-radius: var(--radius-sm);
   margin: 0.5rem auto 0;
   flex-shrink: 0;
 }
@@ -4863,7 +5053,7 @@ button, input, select, textarea {
   width: 1.75rem;
   height: 1.75rem;
   padding: 0;
-  border-radius: 0.4375rem;
+  border-radius: var(--radius-md);
   color: var(--text-secondary);
   background: none;
   border: none;
@@ -5477,7 +5667,7 @@ button, input, select, textarea {
 /* Horizontal padding matches BaseInput canonical scale (10/12/16) so FormField's
    12px label indent aligns with the numeric text across all input types. */
 .mint-number-input__input--sm { padding: 0.25rem 0.625rem; font-size: 0.8125rem; }
-.mint-number-input__input--md { padding: 0.375rem 0.75rem;    font-size: 0.75rem; }
+.mint-number-input__input--md { padding: 0.375rem 0.75rem;    font-size: 0.875rem; }
 .mint-number-input__input--lg { padding: 0.5rem 1rem;      font-size: 1rem; }
 
 /* ---------- Unit suffix ---------- */
@@ -5493,54 +5683,423 @@ button, input, select, textarea {
   white-space: nowrap;
 }
 
-/* ---------- Steppers — always visible, stacked (increase on top), hairline-divided ---------- */
+/* ---------- Steppers — always visible, stacked (increase on top), hairline-divided ---------- */
+
+.mint-number-input__steppers {
+  display: flex;
+  flex-direction: column-reverse; /* markup is decrease, increase */
+  flex-shrink: 0;
+  width: 22px;
+  border-left: 1px solid var(--border-color);
+}
+
+.mint-number-input__stepper {
+  display: flex;
+  flex: 1;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  background: var(--bg-primary);
+  color: var(--text-muted);
+  border: none;
+  cursor: pointer;
+  transition: background-color var(--mint-transition), color var(--mint-transition);
+}
+
+.mint-number-input__stepper--down {
+  border-top: 1px solid var(--border-color);
+}
+
+.mint-number-input__stepper:hover:not(:disabled) {
+  background: var(--bg-hover);
+  color: var(--text-primary);
+}
+
+.mint-number-input__stepper:disabled {
+  color: var(--text-muted);
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.mint-number-input__stepper svg {
+  width: 0.75rem;
+  height: 0.75rem;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .mint-number-input__field,
+  .mint-number-input__wash,
+  .mint-number-input__rule,
+  .mint-number-input__stepper {
+    transition: none;
+  }
+}
+
+/* Onboarding: the top-bar Help button and checklist chip, the Help panel,
+ * the tour layer (scrim, hole, card) and the what's-new dots. */
+
+:root {
+  --mint-onboarding-scrim: rgba(15, 23, 42, 0.45);
+}
+
+html.dark {
+  --mint-onboarding-scrim: rgba(2, 6, 23, 0.62);
+}
+
+/* ---- Top bar ---- */
+
+.mint-onboarding-help {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+}
+
+.mint-topbar__settings-btn--open {
+  background: var(--color-primary-soft);
+  color: var(--_ink-primary);
+}
+
+.mint-onboarding-help__chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  height: 2rem;
+  padding: 0 0.625rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: transparent;
+  color: var(--text-primary);
+  font: 500 0.8125rem/1 var(--font-sans);
+  white-space: nowrap;
+  cursor: pointer;
+  transition: background-color var(--mint-transition), border-color var(--mint-transition);
+}
+
+.mint-onboarding-help__chip:hover {
+  background: var(--bg-hover);
+}
+
+.mint-onboarding-help__chip--open {
+  border-color: var(--color-primary);
+  background: var(--color-primary-soft);
+  color: var(--_ink-primary);
+}
+
+.mint-onboarding-help__chip:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding-help__count {
+  color: var(--text-muted);
+  font: 500 0.75rem/1 var(--font-mono);
+}
+
+.mint-onboarding-help__bar {
+  width: 1.75rem;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--bg-tertiary);
+  overflow: hidden;
+}
+
+.mint-onboarding-help__bar > span {
+  display: block;
+  height: 100%;
+  background: var(--color-primary);
+  transition: width var(--mint-transition);
+}
+
+.mint-onboarding-help__badge {
+  position: absolute;
+  top: -4px;
+  right: -4px;
+  min-width: 16px;
+  height: 16px;
+  padding: 0 4px;
+  box-sizing: border-box;
+  border-radius: 8px;
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+  font: 600 11px/16px var(--font-sans);
+  text-align: center;
+  box-shadow: 0 0 0 2px var(--bg-card);
+}
+
+/* ---- Help panel ---- */
+
+.mint-onboarding-help__panel {
+  position: fixed;
+  z-index: var(--mint-z-tray);
+  width: 18rem;
+  padding: 0 0 4px;
+  overflow: hidden;
+}
+
+.mint-onboarding-help__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.75rem 0.75rem 0.5rem;
+}
+
+.mint-onboarding-help__heading {
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  font-weight: 600;
+}
+
+.mint-onboarding-help__progress {
+  height: 3px;
+  margin: 0 0.75rem 0.25rem;
+  border-radius: 2px;
+  background: var(--bg-tertiary);
+  overflow: hidden;
+}
+
+.mint-onboarding-help__progress > span {
+  display: block;
+  height: 100%;
+  background: var(--color-primary);
+  transition: width var(--mint-transition);
+}
+
+.mint-onboarding-help__todos {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.mint-onboarding-help__todo {
+  display: grid;
+  grid-template-columns: 1rem 1fr auto;
+  align-items: center;
+  gap: 0.5rem;
+  min-height: 1.875rem;
+  padding: 0 0.75rem;
+  color: var(--text-primary);
+  font-size: 0.8125rem;
+}
+
+.mint-onboarding-help__check {
+  display: grid;
+  place-items: center;
+  width: 1rem;
+  height: 1rem;
+  box-sizing: border-box;
+  border: 1.5px solid var(--border-color);
+  border-radius: 50%;
+}
+
+.mint-onboarding-help__todo--done .mint-onboarding-help__check {
+  border: 0;
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+}
+
+.mint-onboarding-help__todo--done .mint-onboarding-help__todo-title {
+  color: var(--text-muted);
+}
+
+.mint-onboarding-help__link {
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: var(--_ink-primary);
+  font-size: 0.75rem;
+  font-weight: 500;
+  white-space: nowrap;
+  cursor: pointer;
+}
+
+.mint-onboarding-help__link:hover {
+  text-decoration: underline;
+}
+
+.mint-onboarding-help__link:focus-visible {
+  outline: none;
+  border-radius: var(--radius-sm);
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding-help__hide {
+  display: block;
+  text-align: left;
+  margin: 0.25rem 0.75rem 0.5rem;
+  color: var(--text-secondary);
+}
+
+.mint-onboarding-help__section {
+  padding: 0.625rem 0.75rem 0.25rem;
+  border-top: 1px solid var(--border-color);
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  font-weight: 600;
+}
+
+.mint-onboarding-help__icon {
+  width: 0.8125rem;
+  height: 0.8125rem;
+  flex-shrink: 0;
+  color: var(--text-muted);
+}
+
+.mint-onboarding-help__panel > .mint-menu-item {
+  width: calc(100% - 8px);
+  margin: 0 4px;
+}
+
+.mint-onboarding-help__new {
+  margin-left: auto;
+  padding: 3px 4px;
+  border-radius: var(--radius-sm);
+  background: var(--color-primary);
+  color: var(--text-on-accent);
+  font-size: 0.6875rem;
+  font-weight: 600;
+  line-height: 1;
+}
+
+/* ---- Tour layer ---- */
+
+.mint-onboarding {
+  position: fixed;
+  inset: 0;
+  z-index: var(--mint-z-tour);
+  pointer-events: none;
+}
+
+/* Takes every click outside the card. An advanceOn 'click' step cuts the hole out of it. */
+.mint-onboarding__blocker {
+  position: absolute;
+  inset: 0;
+  pointer-events: auto;
+}
+
+.mint-onboarding__hole {
+  position: fixed;
+  border-radius: var(--radius-lg);
+  box-shadow: 0 0 0 2px var(--color-primary), 0 0 0 9999px var(--mint-onboarding-scrim);
+  pointer-events: none;
+  transition: left 200ms ease, top 200ms ease, width 200ms ease, height 200ms ease;
+}
+
+.mint-onboarding__card {
+  position: fixed;
+  display: grid;
+  gap: 0.5rem;
+  box-sizing: border-box;
+  width: 17rem;
+  max-width: calc(100vw - 24px);
+  padding: 0.875rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-lg);
+  background: var(--bg-card);
+  box-shadow: var(--shadow-lg);
+  color: var(--text-primary);
+  pointer-events: auto;
+}
+
+.mint-onboarding__card:focus {
+  outline: none;
+}
+
+.mint-onboarding__close {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  display: grid;
+  place-items: center;
+  width: 1.5rem;
+  height: 1.5rem;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius);
+  background: transparent;
+  color: var(--text-muted);
+  cursor: pointer;
+}
+
+.mint-onboarding__close:hover {
+  background: var(--bg-hover);
+  color: var(--text-primary);
+}
+
+.mint-onboarding__close:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
+}
+
+.mint-onboarding__title {
+  margin: 0;
+  padding-right: 1.5rem;
+  font-size: 0.875rem;
+  font-weight: 600;
+}
 
-.mint-number-input__steppers {
-  display: flex;
-  flex-direction: column-reverse; /* markup is decrease, increase */
-  flex-shrink: 0;
-  width: 22px;
-  border-left: 1px solid var(--border-color);
+.mint-onboarding__body {
+  margin: 0;
+  color: var(--text-secondary);
+  font-size: 0.8125rem;
+  line-height: 1.45;
 }
 
-.mint-number-input__stepper {
+.mint-onboarding__footer {
   display: flex;
-  flex: 1;
   align-items: center;
-  justify-content: center;
-  padding: 0;
-  background: var(--bg-primary);
-  color: var(--text-muted);
-  border: none;
-  cursor: pointer;
-  transition: background-color var(--mint-transition), color var(--mint-transition);
+  justify-content: flex-end;
+  gap: 0.375rem;
+  margin-top: 0.25rem;
 }
 
-.mint-number-input__stepper--down {
-  border-top: 1px solid var(--border-color);
+.mint-onboarding__count {
+  color: var(--text-muted);
+  font: 500 0.75rem/1.5rem var(--font-mono);
+  margin-top: -0.375rem;
 }
 
-.mint-number-input__stepper:hover:not(:disabled) {
-  background: var(--bg-hover);
-  color: var(--text-primary);
+/* Read by screen readers only. */
+.mint-onboarding__sr {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
 }
 
-.mint-number-input__stepper:disabled {
+.mint-onboarding__hint {
+  margin-right: auto;
   color: var(--text-muted);
-  opacity: 0.45;
-  cursor: not-allowed;
+  font-size: 0.75rem;
 }
 
-.mint-number-input__stepper svg {
-  width: 0.75rem;
-  height: 0.75rem;
+/* A dot at the top-right corner of an element with unseen news. */
+.mint-onboarding__dot {
+  position: fixed;
+  z-index: 40;
+  width: 8px;
+  height: 8px;
+  padding: 0;
+  border: 0;
+  border-radius: 50%;
+  background: var(--color-primary);
+  box-shadow: 0 0 0 2px var(--bg-card);
+  transform: translate(-50%, -50%);
+  cursor: pointer;
+}
+
+.mint-onboarding__dot:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring-offset);
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .mint-number-input__field,
-  .mint-number-input__wash,
-  .mint-number-input__rule,
-  .mint-number-input__stepper {
+  .mint-onboarding-help__chip,
+  .mint-onboarding-help__bar > span,
+  .mint-onboarding-help__progress > span,
+  .mint-onboarding__hole {
     transition: none;
   }
 }
@@ -6282,6 +6841,11 @@ button, input, select, textarea {
  */
 
 .mint-section-card {
+  /* The left grid that the header and the rows share: header icon (or row
+     lead) width, then this gap. Set --mint-section-card-gap on the card to
+     change both. */
+  --mint-section-card-lead-width: 1rem;
+  --mint-section-card-gap: 0.625rem;
   display: flex;
   flex-direction: column;
   border-radius: var(--radius-lg);
@@ -6307,10 +6871,12 @@ button, input, select, textarea {
 .mint-section-card__header {
   display: flex;
   align-items: center;
-  gap: 0.625rem;
+  gap: var(--mint-section-card-gap);
   box-sizing: border-box;
   min-height: 2.5rem;
-  padding: 0.375rem 0.625rem 0.375rem 0.75rem;
+  /* 4px block padding: a 28px header control plus padding plus the 1px rule
+     stays inside the 40px strip (6px made it 41px). */
+  padding: 0.25rem 0.625rem 0.25rem 0.75rem;
   border-bottom: 1px solid var(--border-color);
   flex-shrink: 0;
 }
@@ -6325,8 +6891,8 @@ button, input, select, textarea {
   align-items: center;
   justify-content: center;
   flex-shrink: 0;
-  width: 1rem;
-  height: 1rem;
+  width: var(--mint-section-card-lead-width);
+  height: var(--mint-section-card-lead-width);
   color: var(--text-muted);
 }
 
@@ -6386,12 +6952,27 @@ button, input, select, textarea {
 .mint-section-card__row {
   display: flex;
   align-items: center;
-  gap: 0.625rem;
+  gap: var(--mint-section-card-gap);
   padding: 0.375rem 0.75rem;
   background: var(--bg-secondary);
   transition: background-color var(--mint-transition);
 }
 
+/* Leading glyph slot of a row: as wide as the header icon, so the glyph
+ * centres under it and the row text starts at the header title. Leave it
+ * empty to keep the text on the grid. It is one title line high (1lh at the
+ * title size), so a two-line row keeps its glyph on the first line. */
+.mint-section-card__row-lead {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  align-self: flex-start;
+  width: var(--mint-section-card-lead-width);
+  height: 1lh;
+  font-size: 0.8125rem;
+}
+
 a.mint-section-card__row,
 button.mint-section-card__row {
   cursor: pointer;
@@ -6407,12 +6988,14 @@ button.mint-section-card__row:hover {
 /* Comfortable density gives the header and rows back their height. */
 [data-density="comfortable"] .mint-section-card__header {
   min-height: 2.75rem;
-  padding: 0.5rem 0.75rem 0.5rem 0.875rem;
+  padding: 0.25rem 0.75rem 0.25rem 0.875rem;
 }
 
 [data-density="comfortable"] .mint-section-card__row {
   padding-top: 0.5rem;
   padding-bottom: 0.5rem;
+  /* Same left inset as the header, so row content lines up under the header. */
+  padding-left: 0.875rem;
 }
 
 /* SecretInput — plugin secret settings field with a set / not set / environment status.
@@ -6594,14 +7177,10 @@ button.mint-section-card__row:hover {
 .mint-searchable-select__value { flex: 1; min-width: 0; overflow: hidden; text-align: left; text-overflow: ellipsis; white-space: nowrap; }
 .mint-searchable-select__value--placeholder { color: var(--text-muted); }
 
-/* Surface = .mint-popover (2d); this alias keeps only placement. */
+/* Surface = .mint-popover (2d). useFloatingPanel sets the fixed position and width. */
 .mint-searchable-select__panel {
-  position: absolute;
-  top: calc(100% + 0.25rem);
-  right: 0;
-  left: 0;
-  z-index: 30;
-  max-height: min(38rem, 80vh);
+  z-index: var(--mint-z-popover);
+  max-height: min(38rem, 80vh, var(--mint-floating-available-height, 100vh));
   overflow: hidden;
 }
 
@@ -7190,7 +7769,7 @@ button.mint-section-card__row:hover {
   /* AppTopBar publishes its bottom edge + 1rem so toasts clear its controls. */
   top: var(--mint-toast-offset-top, 1rem);
   right: 1rem;
-  z-index: 9999;
+  z-index: var(--mint-z-toast);
   display: flex;
   flex-direction: column;
   gap: 0.5rem;
@@ -7921,26 +8500,69 @@ html.dark .mint-toast__item {
   box-sizing: border-box;
   border-bottom: 1px solid var(--border-light);
   font-size: 0.8125rem;
+  /* The header compacts when it is narrow (sidebars); see the query below. */
+  container-type: inline-size;
 }
 
 .mint-sample-selector__title {
+  flex-shrink: 0;
+  white-space: nowrap;
   font-weight: 600;
   color: var(--text-primary);
 }
 
 .mint-sample-selector__selected {
+  /* Without the query (or with a long count) the count gives way, never the row. */
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
   font-size: 0.75rem;
   font-weight: 500;
   color: var(--text-muted);
 }
 
 .mint-sample-selector__header-actions {
+  flex-shrink: 0;
   display: flex;
   align-items: center;
   gap: 0.125rem;
   margin-left: auto;
 }
 
+.mint-sample-selector__selected-short {
+  display: none;
+}
+
+/* Narrow selector: the header stays one row and keeps its height. The grouping
+   button shows only its icon (the label stays its accessible name and tooltip)
+   and the count shortens to "N sel." (screen readers keep "N selected"). */
+/* Measured: the full row (title, "N selected", Smart group, Clear groups) needs
+   about 17.55rem of header content width with Fira Sans. */
+@container (max-width: 17.625rem) {
+  .mint-sample-selector__group-btn .mint-button__label,
+  .mint-sample-selector__selected-full {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
+  .mint-sample-selector__selected-short {
+    display: inline;
+  }
+
+  .mint-sample-selector__group-btn {
+    min-width: var(--form-height-sm);
+    padding-inline: 0.25rem;
+  }
+}
+
 .mint-sample-selector__grouped,
 .mint-sample-selector__flat,
 .mint-sample-selector__state {
@@ -11204,7 +11826,7 @@ html.dark .mint-pill--soft {
 }
 
 .mint-dataframe__row:last-child .mint-dataframe__td {
-  border-bottom: none;
+  border-bottom: none !important;
 }
 
 /* Empty / error placeholder host (content comes from EmptyState) */
@@ -11421,12 +12043,12 @@ html.dark .mint-dataframe__loading {
 .mint-well-edit-popup__backdrop {
   position: fixed;
   inset: 0;
-  z-index: 40;
+  z-index: calc(var(--mint-z-popover) - 1);
 }
 
 .mint-well-edit-popup {
   position: fixed;
-  z-index: 50;
+  z-index: var(--mint-z-popover);
   width: 300px;
   padding: 0;
   overflow: hidden;
@@ -11763,13 +12385,13 @@ html.dark .mint-dataframe__loading {
 }
 
 /* ========================================================================
-   Rail variant (default) — single filled track, pill ends
+   Rail variant (default) — single filled track, square-ish ends (v2: no capsules)
    ======================================================================== */
 
 .mint-progress__track {
   width: 100%;
   background-color: var(--bg-tertiary);
-  border-radius: 9999px; /* pill ends — spec */
+  border-radius: var(--radius-sm);
   overflow: hidden;
 }
 
@@ -11779,7 +12401,7 @@ html.dark .mint-dataframe__loading {
 
 .mint-progress__bar {
   height: 100%;
-  border-radius: 9999px;
+  border-radius: var(--radius-sm);
   transition: width 0.3s ease;
 }
 
@@ -12299,8 +12921,8 @@ html.dark .mint-dataframe__loading {
 }
 
 .mint-tooltip__content {
-  position: absolute;
-  z-index: 9999;
+  position: fixed;
+  z-index: var(--mint-z-toast);
   display: inline-flex;
   align-items: center;
   gap: 0.5rem;
@@ -12835,6 +13457,12 @@ html.dark .mint-stale-banner {
   border-bottom-color: var(--border-color);
 }
 
+/* The pane ends after the last group's last row: no closing hairline there,
+   it would sit on the footer rule with nothing between them. */
+.mint-settings-modal__group:last-of-type > .mint-settings-modal__group-grid > .mint-settings-modal__row:last-child {
+  border-bottom: none;
+}
+
 /* The field cell anchors the ↺ reset, which sits just left of the control (5d).
    --_settings-control-w is the control's width; stacked fields (text, custom slots)
    keep 0 and put the reset at the right end of their label line. */
@@ -13453,10 +14081,9 @@ html.dark .mint-stale-banner {
 .mint-settings-modal__density-preview {
   --_density-row: 2.125rem;
 
+  /* A hairline table in the setting row, not a bordered box inside the modal. */
   grid-column: 1 / -1;
   overflow: hidden;
-  border: 1px solid var(--border-color);
-  border-radius: var(--radius-md);
   font-size: 0.75rem;
 }
 
@@ -14271,7 +14898,7 @@ button.mint-unit-input__unit:focus-visible {
 
 .mint-unit-input__menu {
   position: fixed;
-  z-index: 1000;
+  z-index: var(--mint-z-popover);
   width: 148px;
 }
 
@@ -15058,13 +15685,10 @@ button.mint-unit-input__unit:focus-visible {
   height: 0.875rem;
 }
 
-/* Dropdown — placement only; the look is .mint-popover. Spans the field width. */
+/* Dropdown — the look is .mint-popover; useFloatingPanel sets the fixed position and the field width. */
 .mint-time-picker__dropdown {
-  position: absolute;
-  z-index: 50;
-  margin-top: 0.25rem;
-  width: 100%;
-  min-width: 100%;
+  z-index: var(--mint-z-popover);
+  max-height: var(--mint-floating-available-height, none);
   overflow: hidden;
 }
 
@@ -15247,12 +15871,12 @@ button.mint-unit-input__unit:focus-visible {
   color: var(--text-muted);
 }
 
-/* Dropdown — placement only; the look is .mint-popover. */
+/* Dropdown — the look is .mint-popover; useFloatingPanel sets the fixed position. */
 .mint-datetime-picker__dropdown {
-  position: absolute;
-  z-index: 50;
-  margin-top: 0.25rem;
+  z-index: var(--mint-z-popover);
   width: 18rem;
+  max-height: var(--mint-floating-available-height, none);
+  overflow-y: auto;
   padding: 0.625rem;
 }
 
@@ -16663,13 +17287,26 @@ button.mint-unit-input__unit:focus-visible {
 }
 
 /* Footer with clear selection */
+.mint-experiment-selector__description {
+  padding: 0 1.25rem 0.75rem;
+  font-size: 0.8125rem;
+  color: var(--text-secondary);
+}
+
 .mint-experiment-selector__footer {
   display: flex;
+  align-items: center;
+  gap: 0.75rem;
   justify-content: flex-start;
   padding: 0.5rem 1.25rem 0.75rem;
   border-top: 1px solid var(--border-light);
 }
 
+.mint-experiment-selector__footer-slot {
+  flex: 1;
+  min-width: 0;
+}
+
 .mint-experiment-selector__clear-btn {
   padding: 0.25rem 0;
   border: none;
@@ -17210,54 +17847,79 @@ button.mint-unit-input__unit:focus-visible {
     animation: none;
   }
 }
-/* AppTopBar page selector — left-side route/page dropdown.
-   Trigger speaks the field language (5a): 36px (the identity tile height), hover changes the background
-   only, open = field focus, inline 12px chevron. The menu keeps the 1.2 panel
-   (own card, tinted active row) rather than .mint-popover + .mint-menu-item. */
+/* AppTopBar page selector — design v2 option C: "<plugin> / <page>" as one switcher.
+   The crumb holds the plugin name, a slash and the tinted 32px trigger. The menu keeps its own
+   card (not .mint-popover): a "<plugin> pages" title, then one row per page with its hint and number key. */
+
+/* Shrinks with the bar: the plugin name and the page label truncate instead of overlapping the nav. */
+.mint-page-selector__crumb {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  min-width: 0;
+  flex-shrink: 1;
+}
+
+.mint-page-selector__plugin {
+  min-width: 0;
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.mint-page-selector__slash {
+  flex-shrink: 0;
+  font-size: 1.125rem;
+  font-weight: 300;
+  line-height: 1;
+  color: var(--text-muted);
+}
 
-/* Shrinks down to its inline min-width (11.25rem) so a crowded bar truncates the label instead of overlapping the nav. */
+/* Anchors the menu under the trigger, not under the plugin name. */
 .mint-page-selector {
   position: relative;
-  flex-shrink: 1;
+  display: flex;
+  min-width: 0;
 }
 
 .mint-page-selector__trigger {
   display: inline-flex;
   align-items: center;
-  gap: 0.5rem;
-  width: 100%;
-  height: 2.25rem;
-  padding: 0 0.5rem 0 0.4375rem;
-  border: 1px solid var(--border-color);
-  background: var(--bg-card);
+  gap: 0.375rem;
+  min-width: 0;
+  max-width: 100%;
+  height: 2rem;
+  padding: 0 0.5rem 0 0.375rem;
+  border: 0;
+  background: var(--color-primary-soft);
   color: var(--text-primary);
   border-radius: var(--radius-md);
   font-size: 0.8125rem;
-  font-weight: 500;
+  font-weight: 600;
   font-family: inherit;
   cursor: pointer;
   transition:
     background-color var(--mint-transition),
-    border-color var(--mint-transition),
     box-shadow var(--mint-transition);
 }
 
-.mint-page-selector__trigger:hover:not(.mint-page-selector__trigger--open) {
-  background: var(--bg-hover);
+.mint-page-selector__trigger:hover {
+  background: color-mix(in srgb, var(--color-primary) 16%, transparent);
 }
 
-.mint-page-selector__trigger:focus-visible,
-.mint-page-selector__trigger--open {
+.mint-page-selector__trigger:focus-visible {
   outline: none;
-  border-color: var(--color-primary);
-  box-shadow: var(--focus-ring-soft);
+  box-shadow: var(--focus-ring-offset);
 }
 
 /* Page icon tile is neutral; the plugin carries the color. */
 .mint-page-selector__icon {
   width: 1.25rem;
   height: 1.25rem;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius);
   background: var(--bg-tertiary);
   color: var(--text-secondary-strong);
   display: grid;
@@ -17278,7 +17940,7 @@ button.mint-unit-input__unit:focus-visible {
 .mint-page-selector__trigger-metadata-icon.mint-plugin-icon--sm {
   width: 1.25rem;
   height: 1.25rem;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius);
 }
 
 .mint-page-selector__icon-fallback {
@@ -17288,7 +17950,6 @@ button.mint-unit-input__unit:focus-visible {
 }
 
 .mint-page-selector__label {
-  flex: 1;
   min-width: 0;
   text-align: left;
   white-space: nowrap;
@@ -17296,7 +17957,6 @@ button.mint-unit-input__unit:focus-visible {
   text-overflow: ellipsis;
 }
 
-/* The chevron sits inline; the wrap no longer draws a tile. */
 .mint-page-selector__chevron-wrap {
   display: inline-flex;
   color: var(--text-secondary);
@@ -17313,38 +17973,46 @@ button.mint-unit-input__unit:focus-visible {
   transform: rotate(180deg);
 }
 
+/* max-height: 8 two-line hint rows (8 x 68px) + title (~25px) + padding (8px) = ~577px; a 9th row scrolls. A short window caps it. */
 .mint-page-selector__menu {
   position: absolute;
+  box-sizing: border-box;
   top: calc(100% + 0.375rem);
   left: 0;
-  width: 16.25rem;
+  width: 18.75rem;
+  max-height: min(36.25rem, calc(100vh - 6rem));
+  overflow-y: auto;
   background: var(--bg-card);
   border: 1px solid var(--border-color);
   border-radius: var(--radius-lg);
   box-shadow: var(--shadow-md);
-  padding: 0.375rem;
+  padding: 0.25rem;
   z-index: 50;
 }
 
+/* The mockup's 10px uppercase eyebrow breaks rules 2a (no uppercase) and 8d (UI text >= 11px): 11px, sentence case. */
 .mint-page-selector__menu-title {
-  padding: 0.375rem 0.625rem 0.5rem;
-  font-size: 0.75rem;
+  padding: 0.375rem 0.5rem 0.25rem;
+  font-family: var(--font-mono);
+  font-size: 0.6875rem;
   font-weight: 500;
-  color: var(--text-secondary);
+  letter-spacing: 0.06em;
+  color: var(--text-muted);
 }
 
 .mint-page-selector__item {
   display: flex;
-  align-items: center;
+  box-sizing: border-box;
+  align-items: flex-start;
   gap: 0.625rem;
   width: 100%;
-  padding: 0.5rem 0.625rem;
+  padding: 0.5rem;
   border: 0;
   background: transparent;
-  border-radius: 0.4375rem;
+  border-radius: var(--radius);
   color: var(--text-primary);
   font-size: 0.8125rem;
-  font-weight: 500;
+  line-height: 1.4;
   font-family: inherit;
   text-align: left;
   text-decoration: none;
@@ -17352,13 +18020,22 @@ button.mint-unit-input__unit:focus-visible {
   transition: background-color var(--mint-transition);
 }
 
-.mint-page-selector__item:hover:not(.mint-page-selector__item--disabled) {
+/* A row without a hint has one line: centre it on the icon tile. */
+.mint-page-selector__item:not(:has(.mint-page-selector__item-hint)) {
+  align-items: center;
+}
+
+.mint-page-selector__item:hover:not(.mint-page-selector__item--disabled):not(.mint-page-selector__item--active) {
   background: var(--bg-hover);
 }
 
+.mint-page-selector__item:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: -2px;
+}
+
 .mint-page-selector__item--active {
-  background: var(--bg-tertiary);
-  font-weight: 600;
+  background: var(--color-primary-soft);
 }
 
 .mint-page-selector__item--disabled {
@@ -17367,9 +18044,9 @@ button.mint-unit-input__unit:focus-visible {
 }
 
 .mint-page-selector__item-icon {
-  width: 1.375rem;
-  height: 1.375rem;
-  border-radius: 0.3125rem;
+  width: 1.75rem;
+  height: 1.75rem;
+  border-radius: var(--radius-md);
   background: var(--bg-tertiary);
   color: var(--text-secondary);
   display: grid;
@@ -17377,6 +18054,10 @@ button.mint-unit-input__unit:focus-visible {
   flex-shrink: 0;
 }
 
+.mint-page-selector__item-icon .mint-page-selector__icon-fallback {
+  font-size: 0.8125rem;
+}
+
 .mint-page-selector__item--active .mint-page-selector__item-icon {
   background: var(--color-primary-soft);
   color: var(--color-primary);
@@ -17389,24 +18070,55 @@ button.mint-unit-input__unit:focus-visible {
 }
 
 .mint-page-selector__item-icon svg {
-  width: 0.8125rem;
-  height: 0.8125rem;
+  width: 0.9375rem;
+  height: 0.9375rem;
 }
 
 .mint-page-selector__metadata-icon.mint-plugin-icon--sm {
-  width: 1.375rem;
-  height: 1.375rem;
-  border-radius: 0.3125rem;
+  width: 1.75rem;
+  height: 1.75rem;
+  border-radius: var(--radius-md);
 }
 
-.mint-page-selector__item-label {
+.mint-page-selector__item-text {
   flex: 1;
   min-width: 0;
+  display: grid;
+  gap: 1px;
+}
+
+.mint-page-selector__item-label {
+  font-weight: 600;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
+/* --_ink-primary is --color-primary-hover in light mode and stays legible in dark mode. */
+.mint-page-selector__item--active .mint-page-selector__item-label {
+  color: var(--_ink-primary);
+}
+
+.mint-page-selector__item-hint {
+  font-size: 0.75rem;
+  line-height: 1.35;
+  color: var(--text-secondary);
+}
+
+/* 11px, the rule 8d floor (the mockup has 10.5px). */
+.mint-page-selector__item-key {
+  flex-shrink: 0;
+  margin-top: 0.125rem;
+  padding: 0 0.25rem;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius);
+  font-family: var(--font-mono);
+  font-size: 0.6875rem;
+  font-weight: 500;
+  line-height: 1rem;
+  color: var(--text-muted);
+}
+
 @media (prefers-reduced-motion: reduce) {
   .mint-page-selector__trigger,
   .mint-page-selector__chevron {