@morscherlab/mint-sdk 1.2.0-beta.1 → 1.2.0-beta.11

package/src/stores/index.ts

@@ -1,3 +1,11 @@
 export { useAuthStore } from './auth'
-export { useSettingsStore, colorPalettes, type SettingsState } from './settings'
+export {
+  useSettingsStore,
+  tryUseSettingsStore,
+  colorPalettes,
+  paletteCssVariables,
+  tableDensityToSize,
+  PALETTE_CSS_VARIABLES,
+  type SettingsState,
+} from './settings'
 export { useExperimentStore } from './experiment'

package/src/stores/settings.ts

@@ -1,4 +1,4 @@
-import { defineStore } from 'pinia'
+import { defineStore, getActivePinia } from 'pinia'
 import { ref, watch } from 'vue'
 import type { ThemeMode, ColorPalette, TableDensity } from '../types'
 
@@ -62,6 +62,46 @@ export const colorPalettes: Record<ColorPalette, { name: string; hues: [number,
   pastel: { name: 'Pastel', hues: [200, 340] },
 }
 
+/**
+ * Custom properties a non-default palette overrides on `<html>`.
+ *
+ * The saturation/lightness pairs are lifted from the canonical indigo/orange
+ * tokens in `styles/variables.css` so only the hue moves; the `default`
+ * palette writes nothing at all and the stylesheet values stand.
+ */
+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%)`,
+  }
+}
+
+/** `DataFrame`-style size that each table density maps onto. */
+const DENSITY_TABLE_SIZE: Record<TableDensity, 'sm' | 'md' | 'lg'> = {
+  compact: 'sm',
+  normal: 'md',
+  comfortable: 'lg',
+}
+
+/** Map a table density onto the `size` prop shared by the SDK table components. */
+export function tableDensityToSize(density: TableDensity): 'sm' | 'md' | 'lg' {
+  return DENSITY_TABLE_SIZE[density]
+}
+
 function loadSettings(): SettingsState {
   try {
     const stored = localStorage.getItem(STORAGE_KEY)
@@ -152,6 +192,8 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     tableDensity.value = loaded.tableDensity
 
     applyTheme()
+    applyPalette()
+    applyDensity()
   }
 
   function applyTheme() {
@@ -160,11 +202,36 @@ 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.
+   */
+  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)
+    }
+  }
+
+  /** Mirror the table density onto `<html data-density>` for CSS consumers. */
+  function applyDensity() {
+    if (typeof document === 'undefined') return
+    document.documentElement.dataset.density = tableDensity.value
+  }
+
   watch(theme, () => {
     applyTheme()
     persistSettings()
   })
 
+  watch(colorPalette, applyPalette)
+  watch(tableDensity, applyDensity)
+
   if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
     window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (event) => {
       systemPrefersDark.value = event.matches
@@ -206,6 +273,11 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     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)
+  }
+
   function isDark(): boolean {
     return theme.value === 'system' ? systemPrefersDark.value : theme.value === 'dark'
   }
@@ -222,11 +294,31 @@ export const useSettingsStore = defineStore('mint-settings', () => {
     tableDensity,
     initialize,
     applyTheme,
+    applyPalette,
+    applyDensity,
     persistSettings,
     resetToDefaults,
     getPaletteHues,
+    getTableSize,
     isDark,
     getApiBaseUrl,
     getWsBaseUrl,
   }
 })
+
+/**
+ * Read the settings store without requiring Pinia to be installed.
+ *
+ * SDK components are mounted standalone (unit tests, Histoire stories, plugin
+ * previews) where no Pinia instance exists. They use this to pick up a user's
+ * preferences when the platform is running and fall back to their own defaults
+ * otherwise, instead of throwing.
+ */
+export function tryUseSettingsStore(): ReturnType<typeof useSettingsStore> | null {
+  if (!getActivePinia()) return null
+  try {
+    return useSettingsStore()
+  } catch {
+    return null
+  }
+}

package/src/styles/components/audit-trail.css

@@ -126,11 +126,11 @@
   margin-right: 0.125rem;
 }
 
-.mint-audit-trail__empty {
-  text-align: center;
-  padding: 2rem;
-  color: var(--text-muted);
-  font-size: 0.875rem;
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-audit-trail__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
 }
 
 /* Size variants */

package/src/styles/components/batch-progress-list.css

@@ -194,3 +194,10 @@
   background-color: var(--bg-hover);
   color: var(--text-primary);
 }
+
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-batch-progress__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}

package/src/styles/components/color-slider.css

@@ -61,7 +61,7 @@
   border-radius: 50%;
   background: white;
   cursor: pointer;
-  border: 2px solid var(--mint-primary, #6366f1);
+  border: 2px solid var(--color-primary);
   box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
   transition: transform 0.15s ease;
 }
@@ -80,7 +80,7 @@
   border-radius: 50%;
   background: white;
   cursor: pointer;
-  border: 2px solid var(--mint-primary, #6366f1);
+  border: 2px solid var(--color-primary);
   box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
   transition: transform 0.15s ease;
 }

package/src/styles/components/data-state.css

@@ -0,0 +1,30 @@
+/* DataStateInternal — shared loading / error / empty presentation for data components */
+
+.mint-data-state {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  background-color: var(--bg-primary);
+}
+
+.mint-data-state--loading {
+  gap: 0.75rem;
+  padding: 2.5rem 2rem;
+  color: var(--text-muted);
+}
+
+.mint-data-state--loading.mint-data-state--sm {
+  padding: 1.25rem 1rem;
+}
+
+.mint-data-state--loading.mint-data-state--lg {
+  padding: 3.5rem 2rem;
+}
+
+.mint-data-state__loading-text {
+  font-size: 0.875rem;
+  color: var(--text-muted);
+  margin: 0 !important;
+  padding: 0 !important;
+}

package/src/styles/components/dataframe.css

@@ -187,6 +187,23 @@
   text-align: center;
 }
 
+/* Sortable headers are real buttons; strip the native chrome so the cell keeps
+   its table-header appearance while staying keyboard-operable. */
+.mint-dataframe__th-button {
+  display: block;
+  width: 100%;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: inherit;
+  font: inherit;
+  letter-spacing: inherit;
+  text-transform: inherit;
+  text-align: inherit;
+  cursor: inherit;
+}
+
 .mint-dataframe__th-content {
   display: inline-flex;
   align-items: center;
@@ -308,7 +325,7 @@
 }
 
 .mint-dataframe__row--clickable:focus-visible {
-  outline: 2px solid var(--focus-ring-color, var(--color-primary));
+  outline: 2px solid var(--color-primary);
   outline-offset: -2px;
 }
 
@@ -352,32 +369,15 @@ html.dark .mint-dataframe__row--selected > .mint-dataframe__td {
   border-bottom: none;
 }
 
-/* Empty state */
-.mint-dataframe__empty {
+/* Empty / error placeholder host (content comes from EmptyState) */
+.mint-dataframe__state {
   display: flex;
-  flex-direction: column;
   align-items: center;
   justify-content: center;
   min-height: 12rem;
-  padding: 2.5rem 2rem;
-  color: var(--text-muted);
   background-color: var(--bg-primary);
 }
 
-.mint-dataframe__empty-icon {
-  width: 2.5rem;
-  height: 2.5rem;
-  opacity: 0.5;
-  margin-bottom: 0.5rem;
-}
-
-.mint-dataframe__empty-text {
-  font-size: 0.875rem;
-  margin-top: 0 !important;
-  margin-bottom: 0 !important;
-  padding: 0 !important;
-}
-
 /* Loading overlay */
 .mint-dataframe__loading {
   position: absolute;
@@ -395,18 +395,6 @@ html.dark .mint-dataframe__loading {
   background-color: rgba(0, 0, 0, 0.4);
 }
 
-.mint-dataframe__loading-spinner {
-  width: 1.5rem;
-  height: 1.5rem;
-  color: var(--color-primary);
-  animation: mint-dataframe-spin 1s linear infinite;
-}
-
-@keyframes mint-dataframe-spin {
-  from { transform: rotate(0deg); }
-  to { transform: rotate(360deg); }
-}
-
 /* Footer / Pagination */
 .mint-dataframe__footer {
   display: flex;
@@ -502,11 +490,17 @@ html.dark .mint-dataframe__loading {
   transition: background-color 0.15s ease;
 }
 
-.mint-dataframe__resize-handle:hover::after {
+.mint-dataframe__resize-handle:hover::after,
+.mint-dataframe__resize-handle:focus-visible::after {
   width: 2px;
   background-color: var(--color-primary);
 }
 
+.mint-dataframe__resize-handle:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring);
+}
+
 /* Row delete action column */
 .mint-dataframe__th--actions,
 .mint-dataframe__td--actions {
@@ -539,8 +533,8 @@ html.dark .mint-dataframe__loading {
 }
 
 .mint-dataframe__delete-btn:hover {
-  background-color: color-mix(in srgb, var(--color-error, #ef4444) 14%, transparent);
-  color: var(--color-error, #ef4444);
+  background-color: color-mix(in srgb, var(--mint-error) 14%, transparent);
+  color: var(--mint-error);
 }
 
 .mint-dataframe__delete-btn:focus-visible {

package/src/styles/components/experiment-data-viewer.css

@@ -27,10 +27,10 @@
   flex-direction: column;
   gap: 12px;
 }
-.mint-data-viewer__empty {
-  text-align: center;
-  padding: 32px;
-  color: var(--text-muted);
+.mint-data-viewer__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
 }
 
 /* Summary view */

package/src/styles/components/experiment-timeline.css

@@ -291,7 +291,7 @@
 .mint-timeline__expanded {
   margin-top: 0.75rem;
   padding-top: 0.75rem;
-  border-top: 1px solid rgba(var(--border-color-rgb, 0, 0, 0), 0.5);
+  border-top: 1px solid color-mix(in srgb, var(--border-color) 50%, transparent);
 }
 
 .mint-timeline__description {
@@ -434,42 +434,15 @@
   width: 2rem;
 }
 
-/* Empty state */
-.mint-timeline__empty {
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-timeline__state {
   display: flex;
   align-items: center;
   justify-content: center;
-  padding: 2rem;
   border: 2px dashed var(--border-color);
   border-radius: var(--radius-md);
 }
 
-.mint-timeline__empty-content {
-  text-align: center;
-}
-
-.mint-timeline__empty-text {
-  color: var(--text-muted);
-  margin-top: 0 !important;
-  margin-bottom: 0.5rem !important;
-  padding: 0 !important;
-}
-
-.mint-timeline__empty-btn {
-  padding: 0.375rem 0.75rem;
-  font-size: 0.875rem;
-  background-color: var(--color-primary);
-  color: white;
-  border: none;
-  border-radius: var(--radius-md);
-  cursor: pointer;
-  transition: background-color 0.15s ease;
-}
-
-.mint-timeline__empty-btn:hover {
-  opacity: 0.9;
-}
-
 /* Add step button (end) */
 .mint-timeline__add-end {
   display: flex;

package/src/styles/components/form-builder.css

@@ -40,16 +40,16 @@
 }
 
 .mint-form-section__title {
-  font-size: var(--font-size-base, 0.9375rem);
+  font-size: 0.9375rem;
   font-weight: 600;
-  color: var(--color-text, #1a1a2e);
+  color: var(--text-primary);
   margin: 0;
   line-height: 1.4;
 }
 
 .mint-form-section__description {
-  font-size: var(--font-size-sm, 0.8125rem);
-  color: var(--color-text-secondary, #6b7280);
+  font-size: 0.8125rem;
+  color: var(--text-secondary);
   margin: 0;
   line-height: 1.5;
 }
@@ -65,5 +65,5 @@
   align-items: center;
   gap: 0.75rem;
   padding-top: 1rem;
-  border-top: 1px solid var(--color-border, #e5e7eb);
+  border-top: 1px solid var(--border-color);
 }

package/src/styles/components/lcms-sequence-table.css

@@ -64,7 +64,11 @@
   padding-right: 0.25rem;
 }
 
+/* The handle is a button so it can also take Alt+Arrow keyboard reordering. */
 .mint-lcms-sequence-table__drag-handle {
+  padding: 0;
+  border: 0;
+  background: none;
   color: var(--text-muted, #64748b);
   cursor: grab;
   font-family: var(--font-mono, 'Fira Code', monospace);
@@ -72,6 +76,11 @@
   letter-spacing: -0.08em;
 }
 
+.mint-lcms-sequence-table__drag-handle:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring);
+}
+
 .mint-lcms-sequence-table__td {
   min-width: 0;
   color: var(--text-primary, #0f172a);
@@ -168,7 +177,6 @@
   background: color-mix(in srgb, var(--mint-error, #ef4444) 10%, transparent);
 }
 
-.mint-lcms-sequence-table__empty,
 .mint-lcms-sequence-table__more {
   color: var(--text-muted, #64748b);
   font-size: 0.875rem;
@@ -176,6 +184,13 @@
   text-align: center;
 }
 
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-lcms-sequence-table__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
 .mint-lcms-sequence-table__more {
   border-top: 1px solid var(--border-color, #e2e8f0);
   padding: 0.625rem 1rem;

package/src/styles/components/multi-select.css

@@ -64,7 +64,7 @@
 }
 
 .mint-multi-select__chip--active:hover {
-  background-color: var(--color-primary-dark, #4338ca);
+  background-color: var(--color-primary-hover);
 }
 
 .mint-multi-select__chip--disabled {

package/src/styles/components/reagent-list.css

@@ -138,6 +138,24 @@
   color: var(--text-secondary);
 }
 
+/* Sortable headers are real buttons; strip the native chrome so the cell keeps
+   its table-header look while staying keyboard-operable. */
+.mint-reagent-list__sort-btn {
+  display: inline-flex;
+  align-items: center;
+  width: 100%;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: inherit;
+  font: inherit;
+  letter-spacing: inherit;
+  text-transform: inherit;
+  text-align: inherit;
+  cursor: inherit;
+}
+
 .mint-reagent-list__sort-icon {
   display: inline-block;
   width: 0.75rem;
@@ -332,45 +350,34 @@
   height: 1rem;
 }
 
-/* Empty state */
-.mint-reagent-list__empty {
-  padding: 2rem;
-  text-align: center;
-}
-
-.mint-reagent-list__empty-icon {
-  width: 2.5rem;
-  height: 2.5rem;
-  margin: 0 auto 0.75rem;
-  color: var(--text-muted);
-  opacity: 0.5;
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-reagent-list__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
 }
 
-.mint-reagent-list__empty-text {
-  font-size: 0.875rem;
-  color: var(--text-muted);
-  margin-top: 0 !important;
-  margin-bottom: 0.75rem !important;
-  padding: 0 !important;
+/* Drag handle */
+/* The drag handle doubles as the keyboard reorder target (Alt+Arrow). */
+.mint-reagent-list__drag-handle-btn {
+  display: inline-flex;
+  align-items: center;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: inherit;
+  cursor: grab;
 }
 
-.mint-reagent-list__empty-btn {
-  padding: 0.375rem 0.75rem;
-  font-size: 0.875rem;
-  font-weight: 500;
-  color: white;
-  background-color: var(--color-primary);
-  border: none;
-  border-radius: var(--radius);
-  cursor: pointer;
-  transition: background-color 0.15s ease;
+.mint-reagent-list__drag-handle-btn:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring);
 }
 
-.mint-reagent-list__empty-btn:hover {
-  background-color: var(--color-primary-hover);
+.mint-reagent-list__drag-handle-btn:focus-visible .mint-reagent-list__drag-handle {
+  opacity: 1;
 }
 
-/* Drag handle */
 .mint-reagent-list__drag-handle {
   width: 1rem;
   color: var(--text-muted);

package/src/styles/components/sample-hierarchy-tree.css

@@ -288,23 +288,9 @@
   }
 }
 
-/* Empty state */
-.mint-sample-tree__empty {
-  padding: 1rem;
-  text-align: center;
-  color: var(--text-muted);
-}
-
-.mint-sample-tree__empty-icon {
-  width: 2rem;
-  height: 2rem;
-  margin: 0 auto 0.5rem;
-  opacity: 0.5;
-}
-
-.mint-sample-tree__empty-text {
-  font-size: 0.875rem;
-  margin-top: 0 !important;
-  margin-bottom: 0 !important;
-  padding: 0 !important;
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-sample-tree__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
 }

package/src/styles/components/sample-selector.css

@@ -468,14 +468,21 @@
   height: 0.625rem;
 }
 
-/* Empty State */
-.mint-sample-selector__empty {
+/* Inline hint shown inside the grouped/flat sub-lists */
+.mint-sample-selector__hint {
   text-align: center;
   padding: 1rem;
   font-size: 0.875rem;
   color: var(--text-muted);
 }
 
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-sample-selector__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
 /* Ungrouped Section */
 .mint-sample-selector__ungrouped {
   margin-top: 0.75rem;

package/src/styles/components/schedule-calendar.css

@@ -470,3 +470,11 @@
 .mint-schedule__month-more:hover {
   text-decoration: underline;
 }
+
+/* Empty / loading / error placeholder host (content comes from EmptyState) */
+.mint-schedule__state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 12rem;
+}

package/src/styles/components/scientific-number.css

@@ -59,5 +59,5 @@
 }
 
 .mint-sci-number__copy-btn--copied {
-  color: var(--color-success, #10b981);
+  color: var(--mint-success);
 }