@morscherlab/mint-sdk 1.4.13 → 1.5.0-beta.10

package/src/types/components.ts

@@ -220,6 +220,7 @@ export type PillNavItemInput = (Omit<PillNavItem, 'children'> & {
 export interface PageSelectorItem {
   id: string
   label: string
+  /** A Lucide icon name (`'activity'`, `'flask-conical'`) or a plugin icon (path, data URL, `mint-icon` JSON). Without one the page shows its first letter. */
   icon?: string
   hint?: string
   to?: string
@@ -239,12 +240,32 @@ export interface PluginWorkspaceTopBarSpec {
   logo?: boolean
   /** Centered pill navigation for the local modes of the current route (bind `v-model:pill`). */
   pills?: PillNavItemInput[]
-  /** Show the theme toggle. */
+  /** @deprecated Ignored: the theme toggle always shows. Removed in 2.0. */
   themeToggle?: boolean
-  /** Settings button and modal; `false` hides the button. A getter can switch it per user. */
+  /**
+   * Settings modal of the always-present settings button. `false` (or a getter that returns it)
+   * gives the modal only its Appearance tab; it no longer hides the button.
+   */
   settings?: import('vue').MaybeRefOrGetter<false | TopBarSettingsConfig>
   /** Standalone badge text when the plugin runs outside the platform; `false` hides it. */
   standaloneLabel?: false | string
+  /** Plugin buttons, before the theme and settings buttons. The first two show; the rest go into a More menu. */
+  actions?: TopBarAction[]
+}
+
+/** One plugin button of the top bar. With `icon` it is an icon button and `label` is its accessible name and tooltip. */
+export interface TopBarAction {
+  id: string
+  label: string
+  /** A Lucide icon name, such as `'database'`. */
+  icon?: string
+  /** A small status dot on the button. */
+  dot?: Tone
+  /** Tooltip; defaults to `label`. */
+  title?: string
+  loading?: boolean
+  disabled?: boolean
+  onSelect: () => void
 }
 
 /** Sidebar part of a PluginWorkspaceView spec; also the `:spec` of AppSidebar. */

package/src/types/generated-ui.ts

@@ -132,6 +132,8 @@ export interface GeneratedJobDefinition {
   cpu: number
   /** Who may submit the job when integrated: `use`, `configure` (`plugins.configure`) or `admin`. */
   access?: 'use' | 'configure' | 'admin'
+  /** The plugins that may start the job through the platform: `'readers'` or plugin names. Absent before SDK 1.5. */
+  callers?: 'readers' | string[]
   /** Defaults to process for manifests generated before lifecycle profiles. */
   lifecycle?: GeneratedJobLifecycle
   /** Defaults to `{ kind: 'process' }` for older manifests. */

package/src/types/index.ts

@@ -31,6 +31,7 @@ export type {
   PageSelectorItem,
   PageSelectorItemInput,
   PluginWorkspaceTopBarSpec,
+  TopBarAction,
   PluginWorkspaceSidebarSpec,
   PluginWorkspaceViewSpec,
   // Well Plate types
@@ -219,7 +220,6 @@ export type {
   InstrumentLiveProgress,
   InstrumentLiveStatus,
   InstrumentState,
-  InstrumentStatus,
   InstrumentStatusReporter,
   SampleInfo,
   SampleInfo as InstrumentSampleInfo,

package/src/types/instrument.ts

@@ -24,24 +24,6 @@ export interface SequenceProgress {
   sample_durations?: readonly number[]
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor types move to the mld-ms plugins. */
-export interface InstrumentStatus {
-  instrument_id: string
-  instrument_name?: string | null
-  monitor_id?: string | null
-  state: InstrumentState
-  active_method?: string | null
-  current_sample?: SampleInfo | null
-  sequence_progress?: SequenceProgress | null
-  timestamp?: string | Date
-  last_seen?: string | Date | null
-  connected?: boolean
-  sequence_file?: string | null
-  sequence_row_index?: number | null
-  current_raw_file?: string | null
-  method_elapsed_pct?: number | null
-}
-
 /** A state the platform derives for an instrument: its reported state, `never` (no report yet) or `inactive`. */
 export type InstrumentBadgeState = InstrumentState | 'never' | 'inactive'
 

package/src/utils/deprecation.ts

@@ -0,0 +1,8 @@
+const warned = new Set<string>()
+
+/** Warn once per page load that a deprecated SDK option or slot is in use. */
+export function warnDeprecatedOnce(key: string, message: string): void {
+  if (warned.has(key)) return
+  warned.add(key)
+  console.warn(`[mint-sdk] ${message}`)
+}

package/src/utils/lucideIcon.ts

@@ -0,0 +1,25 @@
+/// <reference path="./lucideIconIndex.d.ts" />
+import type { Component } from 'vue'
+
+/** A Lucide icon name in kebab case, such as `activity` or `flask-conical`. */
+const LUCIDE_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/
+
+export function isLucideIconName(value?: string): value is string {
+  return !!value && LUCIDE_NAME.test(value)
+}
+
+function pascalCase(name: string): string {
+  return name.replace(/(^|-)([a-z0-9])/g, (_, __, char: string) => char.toUpperCase())
+}
+
+// ponytail: loads the whole Lucide set (~150 KB gzip) as one lazy chunk on first use;
+// switch to a per-icon import map if page icons become common on first paint.
+// The icon index, not the package root: the root is statically imported elsewhere,
+// so a dynamic import of it would put the whole set in the startup bundle.
+let iconSet: Promise<Record<string, Component>> | undefined
+
+/** The Lucide component for `name`, or undefined when Lucide has no such icon. */
+export async function loadLucideIcon(name: string): Promise<Component | undefined> {
+  iconSet ??= import('lucide-vue-next/dist/esm/icons/index.js') as Promise<Record<string, Component>>
+  return (await iconSet)[pascalCase(name)]
+}

package/src/utils/lucideIconIndex.d.ts

@@ -0,0 +1,2 @@
+// The Lucide icon index ships without types; utils/lucideIcon.ts loads it on first use.
+declare module 'lucide-vue-next/dist/esm/icons/index.js'