@morscherlab/mint-sdk 1.4.0-beta.11 → 1.4.0-beta.13

package/src/stores/settings.ts

@@ -55,39 +55,24 @@ const defaultSettings: SettingsState = {
   tableDensity: 'normal',
 }
 
-export const colorPalettes: Record<ColorPalette, { name: string; hues: [number, number] }> = {
-  default: { name: 'Default (Cyan-Pink)', hues: [180, 320] },
-  colorblind: { name: 'Colorblind-friendly', hues: [45, 260] },
-  viridis: { name: 'Viridis', hues: [280, 80] },
-  pastel: { name: 'Pastel', hues: [200, 340] },
-}
-
 /**
- * Custom properties a non-default palette overrides on `<html>`.
- *
- * The saturation/lightness pairs are lifted from the original indigo/orange
- * tokens in `styles/variables.css` so only the hue moves; the `default`
- * palette writes nothing at all and the stylesheet values stand.
+ * Accent palettes. `styles/variables.css` holds each palette's light and dark
+ * tokens under `[data-palette]`; the store only writes the attribute.
  */
-export const PALETTE_CSS_VARIABLES = [
-  '--color-primary',
-  '--color-primary-hover',
-  '--color-primary-soft',
-  '--color-cta',
-  '--color-cta-hover',
-] as const
-
-/** Build the `<html>` custom-property overrides for a palette. */
-export function paletteCssVariables(palette: ColorPalette): Record<string, string> {
-  if (palette === 'default') return {}
-  const [primaryHue, accentHue] = colorPalettes[palette].hues
-  return {
-    '--color-primary': `hsl(${primaryHue} 84% 67%)`,
-    '--color-primary-hover': `hsl(${primaryHue} 75% 59%)`,
-    '--color-primary-soft': `hsl(${primaryHue} 84% 67% / 0.12)`,
-    '--color-cta': `hsl(${accentHue} 95% 53%)`,
-    '--color-cta-hover': `hsl(${accentHue} 90% 48%)`,
-  }
+export const colorPalettes: Record<ColorPalette, { name: string }> = {
+  default: { name: 'Teal' },
+  colorblind: { name: 'Colour-blind safe' },
+  purple: { name: 'Purple' },
+  ocean: { name: 'Ocean' },
+  forest: { name: 'Forest' },
+}
+
+/** Pre-v2 palette ids and the palette that replaces each one. */
+const RETIRED_PALETTES: Record<string, ColorPalette> = { viridis: 'purple', pastel: 'default' }
+
+function knownPalette(value: unknown): ColorPalette {
+  if (typeof value === 'string' && value in colorPalettes) return value as ColorPalette
+  return (typeof value === 'string' && RETIRED_PALETTES[value]) || 'default'
 }
 
 /** `DataFrame`-style size that each table density maps onto. */
@@ -107,13 +92,13 @@ function loadSettings(): SettingsState {
     const stored = localStorage.getItem(STORAGE_KEY)
     if (stored) {
       const parsed = JSON.parse(stored)
-      return { ...defaultSettings, ...parsed }
+      return { ...defaultSettings, ...parsed, colorPalette: knownPalette(parsed.colorPalette) }
     }
 
     const legacyStored = localStorage.getItem(LEGACY_STORAGE_KEY)
     if (legacyStored) {
       const parsed = JSON.parse(legacyStored)
-      const migrated = { ...defaultSettings, ...parsed }
+      const migrated = { ...defaultSettings, ...parsed, colorPalette: knownPalette(parsed.colorPalette) }
       localStorage.setItem(STORAGE_KEY, JSON.stringify(migrated))
       localStorage.removeItem(LEGACY_STORAGE_KEY)
       return migrated
@@ -202,20 +187,10 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     document.documentElement.classList.toggle('dark', dark)
   }
 
-  /**
-   * Write the selected palette's hues onto `<html>` as custom-property
-   * overrides. The `default` palette clears them so `styles/variables.css`
-   * keeps ownership of the brand colors.
-   */
+  /** Mirror the palette onto `<html data-palette>`; `styles/variables.css` maps it to tokens. */
   function applyPalette() {
     if (typeof document === 'undefined') return
-    const style = document.documentElement.style
-    const overrides = paletteCssVariables(colorPalette.value)
-    for (const name of PALETTE_CSS_VARIABLES) {
-      const value = overrides[name]
-      if (value) style.setProperty(name, value)
-      else style.removeProperty(name)
-    }
+    document.documentElement.dataset.palette = colorPalette.value
   }
 
   /** Mirror the table density onto `<html data-density>` for CSS consumers. */
@@ -269,10 +244,6 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     tableDensity.value = defaultSettings.tableDensity
   }
 
-  function getPaletteHues(): [number, number] {
-    return colorPalettes[colorPalette.value].hues
-  }
-
   /** The `size` the SDK table components default to for the current density. */
   function getTableSize(): 'sm' | 'md' | 'lg' {
     return tableDensityToSize(tableDensity.value)
@@ -298,7 +269,6 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     applyDensity,
     persistSettings,
     resetToDefaults,
-    getPaletteHues,
     getTableSize,
     isDark,
     getApiBaseUrl,

package/src/styles/components/app-page-selector.css

@@ -1,51 +1,76 @@
-/* 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 down to its inline min-width (11.25rem) so a crowded bar truncates the label instead of overlapping the nav. */
+/* 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);
+}
+
+/* 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;
@@ -66,7 +91,7 @@
 .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 {
@@ -76,7 +101,6 @@
 }
 
 .mint-page-selector__label {
-  flex: 1;
   min-width: 0;
   text-align: left;
   white-space: nowrap;
@@ -84,7 +108,6 @@
   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);
@@ -101,38 +124,46 @@
   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;
@@ -140,13 +171,22 @@
   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 {
@@ -155,9 +195,9 @@
 }
 
 .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;
@@ -165,6 +205,10 @@
   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);
@@ -177,24 +221,55 @@
 }
 
 .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 {

package/src/styles/components/app-top-bar.css

@@ -231,3 +231,158 @@
   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-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;
+}

package/src/styles/components/experiment-selector-modal.css

@@ -112,13 +112,26 @@
 }
 
 /* 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;