@morscherlab/mint-sdk 1.3.9 → 1.4.0-beta.1

package/src/types/generated/platformContext.ts

@@ -0,0 +1,59 @@
+// Generated by scripts/generate_api_types.py from mint_sdk.frontend_context.
+// Do not edit. Regenerate with: uv run python scripts/generate_api_types.py
+
+export interface PlatformContextNavItem {
+  path: string
+  label: string
+  id?: string
+  icon?: string
+  description?: string
+  requiresAuth?: boolean
+  access?: "use" | "configure" | "admin"
+  requiresFeature?: string
+}
+
+export interface PlatformContextPlugin {
+  id: string
+  name: string
+  display_name: string
+  version: string
+  plugin_type: string
+  route_prefix: string
+  api_prefix: string
+  settings_api: "plugin" | "platform"
+  description?: string
+  icon?: string
+  color?: string
+  nav_items?: PlatformContextNavItem[]
+  frontend_revision?: string
+}
+
+export interface PlatformContextRole {
+  id: number
+  slug: string
+  name: string
+  color: string
+  permissions: string[]
+  project_scope: string
+  plugin_access: string[] | "all" | null
+}
+
+export interface PlatformContextUser {
+  id: number
+  username: string
+  role: string
+  shortname?: string
+  role_obj?: PlatformContextRole
+}
+
+export interface PlatformFrontendContext {
+  contextVersion: number
+  isIntegrated: boolean
+  platformOrigin: string
+  platformApiUrl: string
+  features: Record<string, boolean>
+  authRequired: boolean
+  allowedExperimentTypes?: string[]
+  plugin?: PlatformContextPlugin
+  user?: PlatformContextUser
+}

package/src/types/generated-ui.ts

@@ -130,8 +130,8 @@ export interface GeneratedJobDefinition {
   title: string
   description: string
   cpu: number
-  /** Whether integrated submission requires a platform or current-plugin administrator. */
-  requires_admin?: boolean
+  /** Who may submit the job when integrated: `use`, `configure` (`plugins.configure`) or `admin`. */
+  access?: 'use' | 'configure' | 'admin'
   /** Defaults to process for manifests generated before lifecycle profiles. */
   lifecycle?: GeneratedJobLifecycle
   /** Defaults to `{ kind: 'process' }` for older manifests. */

package/src/types/index.ts

@@ -1,5 +1,6 @@
 // Component types
 export type {
+  Tone,
   ContainerDirection,
   ButtonVariant,
   ButtonSize,
@@ -9,21 +10,15 @@ export type {
   ModalVariant,
   ModalLayout,
   ModalTab,
-  AlertType,
   Toast,
   ToastAction,
   ToastOptions,
-  TabItem,
-  TabItemInput,
   OptionPrimitive,
   SelectOption,
   SelectOptionInput,
-  RadioOption,
-  RadioOptionInput,
   FormFieldProps,
   SectionCardAccent,
   SectionCardDivider,
-  SidebarBadgeTone,
   SidebarToolSection,
   SidebarToolSectionAction,
   CollapsibleState,
@@ -35,7 +30,9 @@ export type {
   PillNavItemInput,
   PageSelectorItem,
   PageSelectorItemInput,
-  AccountMenuItem,
+  PluginWorkspaceTopBarSpec,
+  PluginWorkspaceSidebarSpec,
+  PluginWorkspaceViewSpec,
   // Well Plate types
   WellPlateFormat,
   WellState,
@@ -62,32 +59,23 @@ export type {
   RowCondition,
   Rack,
   PlateEditorClearConfirm,
-  // Sample Legend types
+  WellPlateSpec,
+  PlateEditorSpec,
+  // Sample group types
   SampleType,
-  // Plate Map Editor types
-  PlateMap,
-  PlateMapEditorState,
-  // Experiment Timeline types
+  // Protocol step types
   ProtocolStepType,
   ProtocolStepStatus,
   ProtocolStep,
   // Sample management types
   SampleGroup,
-  GroupItem,
   FileUploaderMode,
   // SegmentedControl types
-  SegmentedOption,
-  SegmentedOptionInput,
   ChartLegendItem,
   SegmentedControlVariant,
   SegmentedControlSize,
-  // MultiSelect types
-  MultiSelectOption,
-  MultiSelectOptionInput,
-  MultiSelectSize,
   // Pill types
   PillVariant,
-  PillColor,
   PillSize,
   // Calendar types
   CalendarSelectionMode,
@@ -97,28 +85,22 @@ export type {
   SortDirection,
   SortState,
   DataFrameColumn,
-  PaginationState,
+  DataFrameSpec,
   // LoadingSpinner types
   SpinnerSize,
-  SpinnerVariant,
   // Divider types
   DividerSpacing,
-  // StatusIndicator types
-  StatusType,
   // ProgressBar types
   ProgressSize,
   // Avatar types
   AvatarSize,
   // EmptyState types
-  EmptyStateColor,
   EmptyStateSize,
   // Breadcrumb types
   BreadcrumbItem,
   BreadcrumbItemInput,
   // Tooltip types
   TooltipPosition,
-  // ConfirmDialog types
-  ConfirmVariant,
   // SettingsModal types
   SettingsTab,
   SettingsTabInput,
@@ -130,7 +112,7 @@ export type {
   SettingsAudienceInput,
   // ScientificNumber types
   NumberNotation,
-  // UnitInput types
+  // NumberInput unit types
   UnitOption,
   // StepWizard types
   WizardStep,
@@ -142,8 +124,7 @@ export type {
   BatchItemStatus,
   BatchItem,
   BatchSummary,
-  // TimePicker types
-  TimePickerFormat,
+  // DatePicker time slot types
   TimeSlotDisabledFn,
   TimeRange,
   // Schedule types
@@ -171,15 +152,6 @@ export type {
   ExperimentSummary,
   ExperimentListResponse,
   ExperimentFilters,
-  // FitPanel types
-  FitState,
-  FitResultSummary,
-  FitSeries,
-  FitColumnLabels,
-  // ReagentList types
-  StorageCondition,
-  ReagentColumn,
-  Reagent,
   // SampleHierarchyTree types
   TreeNodeType,
   BadgeVariant,
@@ -238,6 +210,7 @@ export type {
 } from './jobs'
 
 export type {
+  InjectionMetricSeries,
   InstrumentAlert,
   InstrumentAlertLevel,
   InstrumentAlertList,
@@ -250,15 +223,9 @@ export type {
   SampleInfo,
   SampleInfo as InstrumentSampleInfo,
   SequenceProgress,
+  StatusPanel,
 } from './instrument'
 
-export type {
-  LcmsContainerType,
-  LcmsPolarity,
-  LcmsSequenceItem,
-  LcmsSequenceTableColumn,
-} from '../lcms'
-
 export type {
   AccessAudience,
   AccessAudienceInput,
@@ -295,21 +262,16 @@ export type {
 } from './auto-group'
 
 // Auth types
-export type {
-  AuthConfig,
-  UserInfo,
-} from './auth'
+export type { UserInfo } from './auth'
 
 // Platform types
 export type {
+  Access,
   PluginInfo,
   PluginNavItem,
   PluginSettings,
   PluginSettingField,
   PlatformContext,
-  PlatformContextOptions,
-  PlatformEventType,
-  PlatformEvent,
   ThemeMode,
   ColorPalette,
   TableDensity,

package/src/types/instrument.ts

@@ -7,6 +7,8 @@ export interface SampleInfo {
   sample_name?: string | null
   vial_position?: string | null
   injection_volume?: number | null
+  /** Injection start time, ISO 8601 with a timezone. */
+  started_at?: string | null
 }
 
 export interface SequenceProgress {
@@ -43,12 +45,35 @@ export interface InstrumentStatus {
 /** A state the platform derives for an instrument: its reported state, `never` (no report yet) or `inactive`. */
 export type InstrumentBadgeState = InstrumentState | 'never' | 'inactive'
 
+/** One per-injection metric over the current sequence; `values[i]` belongs to position `i + 1`, up to the last finished one (pad to `total_samples`). */
+export interface InjectionMetricSeries {
+  key: string
+  label: string
+  unit?: string | null
+  values: (number | null)[]
+}
+
 /** Sequence progress in a live status report; `sample_durations` covers the current sequence only. */
 export type InstrumentLiveProgress = SequenceProgress & {
   elapsed_seconds: number
   sample_durations: number[]
+  injection_metrics: InjectionMetricSeries[]
 }
 
+/** A typed panel a plugin reports with a live status; `kind` selects the renderer. */
+export type StatusPanel =
+  | { kind: 'kv'; title: string; items: [string, string | number | boolean | null][] }
+  | { kind: 'table'; title: string; columns: string[]; rows: Record<string, unknown>[] }
+  | { kind: 'text'; title: string; text: string }
+  | { kind: 'json'; title: string; value: unknown }
+  | {
+      kind: 'bar'
+      title: string
+      categories: string[]
+      /** One value per category; the viewer shows one series at a time. */
+      series: { name: string; values: (number | null)[]; unit?: string | null }[]
+    }
+
 /** The plugin that reported a live status, resolved from the plugin registry at read time. */
 export interface InstrumentStatusReporter {
   name: string
@@ -74,6 +99,8 @@ export interface InstrumentLiveStatus {
   reported_by: string
   /** Null when the reporting plugin is not loaded. */
   reporter: InstrumentStatusReporter | null
+  /** Panels of the latest report; empty for plugins that send none. */
+  panels: StatusPanel[]
 }
 
 /** An alert served by the reporting plugin at `{route_prefix}/api/instruments/{id}/alerts`. */

package/src/types/platform.ts

@@ -1,36 +1,17 @@
-import type { RoleInfo } from '../permissions'
-
-// Plugin information provided by the platform
-export interface PluginInfo {
-  id: string
-  name: string
-  /** Name to show in the UI; the platform falls back to the plugin ID. Absent before MINT 1.3. */
-  display_name?: string
-  version: string
-  plugin_type?: string
-  description?: string
-  icon?: string
-  color?: string
-  route_prefix: string
-  api_prefix: string
-  /** Settings route selected by the platform for this plugin runtime. */
-  settings_api?: 'plugin' | 'platform'
-  /** Content identity of the HTML that booted this integrated plugin tab. */
-  frontend_revision?: string
+import type {
+  PlatformContextNavItem,
+  PlatformContextPlugin,
+  PlatformFrontendContext,
+} from './generated/platformContext'
+
+// Plugin information provided by the platform. The platform does not send `settings`.
+export type PluginInfo = Omit<PlatformContextPlugin, 'nav_items'> & {
   nav_items?: PluginNavItem[]
   settings?: PluginSettings
 }
 
-// Plugin navigation item
-export interface PluginNavItem {
-  id?: string
-  label: string
-  path: string
-  icon?: string
-  description?: string
-  requiresAuth?: boolean
-  requiresAdmin?: boolean
-  requiresFeature?: string
+// Plugin navigation item. The platform does not send `children`.
+export type PluginNavItem = PlatformContextNavItem & {
   children?: PluginNavItem[]
 }
 
@@ -64,68 +45,23 @@ export interface UserSummary {
   last_name?: string
 }
 
-// Platform context - available to plugins when running under MINT Platform
-export interface PlatformContext {
-  // Is running under the MINT Platform
+/**
+ * Platform authorization level a plugin endpoint, job, tool or page requires.
+ * `use` needs `plugins.use` and a role that can see the plugin, `configure`
+ * adds `plugins.configure`, and `admin` needs a platform administrator.
+ */
+export type Access = 'use' | 'configure' | 'admin'
+
+/**
+ * The platform context: the `window.__MINT_PLATFORM__` the platform injects
+ * (generated from `mint_sdk.frontend_context`), or the standalone default
+ * that holds only `isIntegrated` and `theme`.
+ */
+export type PlatformContext = Partial<Omit<PlatformFrontendContext, 'plugin'>> & {
   isIntegrated: boolean
-
-  // Plugin info (only available when integrated)
   plugin?: PluginInfo
-
-  // Platform API base URL
-  platformApiUrl?: string
-
-  // Platform origin for message validation
-  // Used to verify postMessage sources and targets
-  platformOrigin?: string
-
-  // Current user info (if authenticated)
-  user?: {
-    id: number
-    username: string
-    role: string
-    role_obj?: RoleInfo | null
-    roleObj?: RoleInfo | null
-    shortname?: string
-  }
-
-  // Theme preference
-  theme: 'light' | 'dark' | 'system'
-
-  // Allowed experiment types for this plugin (from admin config)
-  allowedExperimentTypes?: string[] | null
-
-  // Features enabled in platform
-  features?: {
-    admin?: boolean
-    experiments?: boolean
-    samples?: boolean
-    passkey?: boolean
-    multiUser?: boolean
-  }
-}
-
-// Configuration options for usePlatformContext
-export interface PlatformContextOptions {
-  // Allowed origins for postMessage communication
-  // If not specified, derives from platformApiUrl or uses same-origin only
-  allowedOrigins?: string[]
-
-  // Whether to allow messages from any origin (UNSAFE - only for development)
-  // Default: false
-  allowAnyOrigin?: boolean
-}
-
-// Platform event types for communication between plugin and platform
-export type PlatformEventType =
-  | 'mint:theme-changed'
-  | 'mint:user-changed'
-  | 'mint:navigate'
-  | 'mint:notification'
-
-export interface PlatformEvent<T = unknown> {
-  type: PlatformEventType
-  payload: T
+  /** The SDK theme setting. The platform does not send it. */
+  theme: ThemeMode
 }
 
 // Settings state types

package/src/utils/color.ts

@@ -4,7 +4,7 @@
  * ## Why the exported values are hex, not `var(--…)`
  *
  * Every scale below is mirrored by a CSS custom property in
- * `styles/variables.css` (`--mint-sample-1…9`, `--mint-slot-r/g/b/y`), so
+ * `styles/variables.css` (`--mint-sample-1…9`), so
  * stylesheets and `:style` bindings can stay theme-aware by referencing the
  * token. The JavaScript constants deliberately carry the plain hex **fallback**
  * for the same slot, because these values are also
@@ -50,17 +50,6 @@ export const SAMPLE_GROUP_TOKENS: readonly string[] = [
   'var(--mint-sample-8)',
 ]
 
-/**
- * Slot-position colors (R/G/B/Y rack positions).
- * Mirrors `--mint-slot-r`, `--mint-slot-g`, `--mint-slot-b`, `--mint-slot-y`.
- */
-export const SLOT_COLORS: Record<SlotPosition, string> = {
-  R: '#ef4444', // red
-  G: '#22c55e', // green
-  B: '#3b82f6', // blue
-  Y: '#eab308', // yellow
-}
-
 /** Slot positions in their canonical display order. */
 export const SLOT_ORDER: readonly SlotPosition[] = ['R', 'G', 'B', 'Y']