@morscherlab/mint-sdk 1.3.11 → 1.4.0-beta.10

package/src/install.ts

@@ -1,4 +1,16 @@
-import * as components from './components'
+import * as rootComponents from './components'
+import * as dataComponents from './data'
+import * as labComponents from './lab'
+import * as runtimeComponents from './runtime'
+import * as shellComponents from './shell'
+
+const components = {
+  ...rootComponents,
+  ...labComponents,
+  ...shellComponents,
+  ...dataComponents,
+  ...runtimeComponents,
+}
 
 type ComponentRegistryApp = {
   component: (name: string, component: any) => unknown
@@ -9,7 +21,8 @@ export interface MINTSdkPlugin {
 }
 
 /**
- * Vue plugin that registers all MINT SDK components globally.
+ * Vue plugin that registers all MINT SDK components globally, including the
+ * components of the `lab`, `shell`, `data` and `runtime` subpaths.
  *
  * @example
  * ```typescript

package/src/instrument.ts

@@ -1,18 +1,16 @@
+// Private SequenceProgressBar helpers; not part of the public SDK surface since MINT 1.4.
 import type { SequenceProgress } from './types'
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function sequenceProgressPercent(progress: SequenceProgress | null | undefined): number {
   if (!progress || progress.total_samples <= 0) return 0
   return Math.round(clamp((progress.current_sample / progress.total_samples) * 100, 0, 100))
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function sequenceSamplesRemaining(progress: SequenceProgress | null | undefined): number {
   if (!progress) return 0
   return Math.max(0, progress.total_samples - progress.current_sample)
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function estimateSequenceRemainingSeconds(
   progress: SequenceProgress | null | undefined,
 ): number | null {
@@ -34,7 +32,6 @@ export function estimateSequenceRemainingSeconds(
   return null
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function estimateSequenceFinishDate(
   progress: SequenceProgress | null | undefined,
   now = new Date(),
@@ -49,7 +46,6 @@ export function estimateSequenceFinishDate(
   return new Date(now.getTime() + remaining * 1000)
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function formatSequenceRemaining(progress: SequenceProgress | null | undefined): string | null {
   const remaining = estimateSequenceRemainingSeconds(progress)
   if (remaining == null || remaining <= 0) return null
@@ -63,7 +59,6 @@ export function formatSequenceRemaining(progress: SequenceProgress | null | unde
   return mins > 0 ? `~${hours}h ${mins}m left` : `~${hours}h left`
 }
 
-/** @deprecated Scheduled for removal in MINT 1.4; instrument monitor helpers move to the mld-ms plugins. */
 export function formatSequenceEta(
   progress: SequenceProgress | null | undefined,
   locale?: Intl.LocalesArgument,

package/src/lab.ts

@@ -0,0 +1,128 @@
+// Lab, plate, chemistry, scheduling and scientific display components (`@morscherlab/mint-sdk/lab`).
+
+// Biological experiment components
+export { default as WellPlate } from './components/WellPlate.vue'
+export { default as PlateEditor } from './components/PlateEditor.vue'
+export { defineWellPlate, definePlateEditor } from './composables/componentSpecs'
+
+// Sample management components
+/** Interactive sample list with drag-and-drop group assignment, color labeling, and smart-group support. */
+export { default as SampleSelector } from './components/SampleSelector.vue'
+
+// Lab/Experiment components
+export { default as MoleculeInput } from './components/MoleculeInput.vue'
+export { default as ConcentrationInput } from './components/ConcentrationInput.vue'
+export { default as DoseCalculator } from './components/DoseCalculator.vue'
+export { default as SampleHierarchyTree } from './components/SampleHierarchyTree.vue'
+export { default as ProtocolStepEditor } from './components/ProtocolStepEditor.vue'
+
+// Scientific display components
+export { default as PlotlyChart } from './components/PlotlyChart.vue'
+export { default as ChartContainer } from './components/ChartContainer.vue'
+export { default as ScientificNumber } from './components/ScientificNumber.vue'
+export { default as ChemicalFormula } from './components/ChemicalFormula.vue'
+export { default as AdductText } from './components/AdductText.vue'
+/** Displays LC/MS or GC/MS acquisition sequence progress with ETA and remaining-time labels. */
+export { default as SequenceProgressBar } from './components/SequenceProgressBar.vue'
+/** Status badge for instrument states: a tone dot (or dash / hollow shape for offline, never-reported and inactive) plus a label. */
+export { default as InstrumentStateBadge } from './components/InstrumentStateBadge.vue'
+/** Live-data card for an instrument status: one tab per typed panel (key/value, table, text, JSON, bar chart). */
+export { default as InstrumentStatusPanels } from './components/InstrumentStatusPanels.vue'
+
+// Scientific input components
+export { default as FormulaInput } from './components/FormulaInput.vue'
+export { default as SequenceInput } from './components/SequenceInput.vue'
+
+// Scheduling / booking components
+export { default as TimeRangeInput } from './components/TimeRangeInput.vue'
+export { default as ScheduleCalendar } from './components/ScheduleCalendar.vue'
+export { default as ResourceCard } from './components/ResourceCard.vue'
+
+// Workflow components
+export { default as StepWizard } from './components/StepWizard.vue'
+
+// Time, dose and chemical formula helpers
+export * as time from './utils/time'
+export * as dose from './utils/dose'
+export * as formula from './utils/formula'
+
+// Dose control recipes
+export {
+  defineDoseCalculatorControlProps,
+  defineDoseDesignControlModel,
+  defineWellPlateControlProps,
+  defineWellPlateDoseComponentBindings,
+  defineWellPlateDoseControlProps,
+} from './composables/controlSchemaDoseDesign'
+export type {
+  DoseCalculatorControlPropsOptions,
+  DoseDesignControlModelOptions,
+  WellPlateControlPropsOptions,
+  WellPlateDoseControlPropsOptions,
+} from './composables/controlSchemaTypes'
+
+// Lab composables and helpers
+export {
+  useConcentrationUnits,
+  type ConcentrationValue,
+  type ConcentrationUnit,
+  type MolarityUnit,
+  type MassVolumeUnit,
+  type PercentageUnit,
+  type UnitCategory,
+  type UseConcentrationUnitsReturn,
+} from './composables/useConcentrationUnits'
+export {
+  useProtocolTemplates,
+  type ParameterDefinition,
+  type StepTemplate,
+  type ValidationResult,
+  type UseProtocolTemplatesReturn,
+} from './composables/useProtocolTemplates'
+export {
+  useRackEditor,
+  type UseRackEditorOptions,
+  type UseRackEditorReturn,
+  type PlateEditorListeners,
+} from './composables/useRackEditor'
+export {
+  useSequenceUtils,
+  type SequenceType,
+  type SequenceStats,
+  type SequenceProblems,
+} from './composables/useSequenceUtils'
+export {
+  useScheduleDrag,
+} from './composables/useScheduleDrag'
+export {
+  useReagentSeries,
+  generateDilutionSeries,
+  DEFAULT_PRESETS,
+  DEFAULT_UNITS,
+  type LevelEntry,
+  type DilutionPreset,
+  type UseReagentSeriesReturn,
+} from './composables/useReagentSeries'
+export {
+  useSampleGroups,
+  type DisplaySampleSubGroup,
+  type SampleGroupNode,
+  type SampleGroupSource,
+  type SampleMajorGroup,
+  type UseSampleGroupsOptions,
+  type UseSampleGroupsReturn,
+} from './composables/useSampleGroups'
+export {
+  hexToHsl,
+  hslToHex,
+  deriveShade,
+  type Hsl,
+} from './utils/color'
+export {
+  sampleTypeMarker,
+  type SampleMarkerType,
+  type SampleTypeMarker,
+} from './utils/sampleTypeMarker'
+export {
+  mintPlotlyTemplate,
+} from './utils/plotlyTemplate'

package/src/permissions.ts

@@ -1,15 +1,5 @@
 export const ADMIN_ROLE = 'admin'
 
-export const ADMIN_PANEL_PERMISSIONS = [
-  'users.view',
-  'users.manage',
-  'platform.configure',
-  'platform.view_logs',
-  'plugins.configure',
-  'plugins.install',
-  'notices.publish',
-] as const
-
 export type AccessAudience = 'all' | 'admin' | 'user'
 export type AccessAudienceInput = AccessAudience | readonly AccessAudience[]
 
@@ -37,7 +27,6 @@ export interface AccessPolicy {
   requiresAdmin?: boolean
   permissions?: readonly string[]
   anyPermissions?: readonly string[]
-  plugin?: string
 }
 
 /** An object that carries an access rule in its nested `access` policy. */
@@ -87,21 +76,6 @@ export function hasAnyPermission(
   return permissions.some(permission => granted.has(permission))
 }
 
-export function canAccessAdmin(user: PermissionUser | null | undefined): boolean {
-  return isAdminUser(user) || hasAnyPermission(user, ADMIN_PANEL_PERMISSIONS)
-}
-
-export function canAccessPlugin(
-  user: PermissionUser | null | undefined,
-  pluginName: string | null | undefined,
-): boolean {
-  if (!pluginName || isAdminUser(user)) return true
-  const access = getRoleInfo(user)?.plugin_access
-  // As on the platform: a value that is not null, 'all' or a list allows no plugin.
-  if (access == null || access === 'all') return true
-  return Array.isArray(access) && access.includes(pluginName)
-}
-
 export function canAccessByPolicy(
   user: PermissionUser | null | undefined,
   policy: AccessPolicy = {},
@@ -112,7 +86,6 @@ export function canAccessByPolicy(
   if (!audienceAllowsUser(policy.visibleFor ?? policy.audience, user)) return false
   if (!hasAllPermissions(user, policy.permissions)) return false
   if (!hasAnyPermission(user, policy.anyPermissions)) return false
-  if (policy.plugin && !canAccessPlugin(user, policy.plugin)) return false
   return true
 }
 

package/src/runtime.ts

@@ -0,0 +1,145 @@
+// Generated-UI runtime components (`@morscherlab/mint-sdk/runtime`).
+
+// Layout components
+export { default as GeneratedPluginView } from './components/GeneratedPluginView.vue'
+export { default as GeneratedResultRenderer } from './components/GeneratedResultRenderer.vue'
+export { default as GeneratedPlotlyResult } from './components/GeneratedPlotlyResult.vue'
+export { default as ComponentBindingRenderer } from './components/ComponentBindingRenderer.vue'
+/** Modal picker over the read-only server mounts, recording paths rather than copying data. */
+export { default as GeneratedPathInput } from './components/GeneratedPathInput.vue'
+
+// Feedback components
+export { default as RuntimeUpdateNotice } from './components/RuntimeUpdateNotice.vue'
+
+// The realtime event stream (`GET /api/events`, behind the `realtime` feature flag).
+export {
+  useRealtime,
+  type RealtimeEvent,
+  type RealtimeHandler,
+  type UseRealtimeReturn,
+} from './composables/useRealtime'
+export {
+  usePresence,
+  type PresenceActivity,
+  type PresenceViewer,
+  type UsePresenceReturn,
+} from './composables/usePresence'
+/** Avatar stack of the other people on a presence topic, with a list of each person and activity. */
+export { default as PresenceAvatars } from './components/PresenceAvatars.vue'
+export type { PresencePerson } from './utils/presenceAvatars'
+
+// HTTP client and plugin endpoint helpers. Generated clients (`@/generated/mint-plugin`)
+// build on these; plugin code uses the generated `useClient`, `useSettings` and `useJobs`.
+export {
+  AuthenticationRequiredError,
+  useApi,
+  type ApiClientOptions,
+  type UseApiReturn,
+} from './composables/useApi'
+export {
+  buildEndpointUrl,
+  createClient,
+  downloadEndpoint,
+  pluginFormDataFromPayload,
+  resolvePluginBaseUrl,
+  uploadEndpoint,
+  useEventStream,
+  useSettingsEndpoint,
+  type BuildEndpointUrlOptions,
+  type CreateClientOptions,
+  type DownloadEndpointOptions,
+  type EventStreamMessage,
+  type PluginClientRequestOptions,
+  type PluginContract,
+  type PluginContractSettings,
+  type PluginEndpointContract,
+  type PluginEndpointDefinition,
+  type PluginEndpointRequestOptions,
+  type PluginFormDataPayload,
+  type PluginFormDataValue,
+  type PluginHttpMethod,
+  type PluginNavItemContract,
+  type StreamOptions,
+  type UseEventStreamReturn,
+  type UseSettingsEndpointOptions,
+  type UseSettingsEndpointReturn,
+} from './composables/createClient'
+export {
+  createGeneratedAnalysisTransport,
+  useJobsEndpoint,
+  type GeneratedAnalysisTransport,
+  type PluginJobRequestOptions,
+  type PluginJobWaitOptions,
+  type UseJobsEndpointOptions,
+  type UseJobsEndpointReturn,
+} from './composables/useJobsEndpoint'
+export {
+  combinePluginJobSources,
+  useJobCenter,
+  type CombinedPluginJobCenterSource,
+  type JobsStatusTrayTab,
+  type PluginJobCenterSource,
+  type UseJobCenterOptions,
+  type UseJobCenterReturn,
+} from './composables/useJobCenter'
+export { controlsTo, type ControlsTarget } from './composables/controlSchemaAdapters'
+export { controlBindings } from './composables/controlComponentBindings'
+
+// Forms, control schemas, job helpers and platform context helpers
+export {
+  useForm,
+  type ValidationRule,
+  type FieldRules,
+  type FieldState,
+  type UseFormReturn,
+} from './composables/useForm'
+export {
+  useFormBuilder,
+  evaluateCondition,
+} from './composables/useFormBuilder'
+export {
+  getFieldRegistryEntry,
+  getTypeDefault,
+  type RegistryEntry,
+} from './composables/formBuilderRegistry'
+export {
+  defineControlComponentBindings,
+  defineControls,
+  getDefaultControlView,
+  getControlDefaults,
+  useControlSchema,
+  useControlWorkspace,
+  type ControlFormSchema,
+  type ControlFormBinding,
+  type ControlSettingsBinding,
+  type ControlSidebarBinding,
+  type ControlTopBarSettingsBinding,
+  type ControlValues,
+  type UseControlSchemaReturn,
+  type ControlWorkspaceAppTopBarPillBinding,
+  type ControlWorkspaceComponentBindings,
+  type ControlWorkspaceFormBinding,
+  type ControlWorkspacePillNavBinding,
+  type ControlWorkspaceSidebarBinding,
+  type ControlWorkspaceTopBarBinding,
+  type ControlWorkspaceTopBarSettingsBinding,
+  type UseControlWorkspaceReturn,
+} from './composables/useControlSchema'
+export {
+  resolveCurrentPluginId,
+} from './composables/platformContextHelpers'
+export {
+  resolveJobCapabilities,
+  normalizeJobPercent,
+  normalizeJobState,
+  isActiveJobStatus,
+  isTerminalJobStatus,
+  jobStatusLabel,
+  type JobCapabilityInput,
+  type JobCapabilities,
+} from './jobs'
+export {
+  generatedJobFormSchema,
+  generatedJobDefaults,
+  normalizeGeneratedJobInput,
+} from './generated/schema'

package/src/shell.ts

@@ -0,0 +1,103 @@
+// Application shell components (`@morscherlab/mint-sdk/shell`).
+
+// Layout components
+export { default as AppTopBar } from './components/AppTopBar.vue'
+export { default as AppSidebar } from './components/AppSidebar.vue'
+export { default as AppLayout } from './components/AppLayout.vue'
+export { default as LayoutResizeHandle } from './components/LayoutResizeHandle.vue'
+
+// Headless interaction composables
+export {
+  useEventListener,
+  type EventListenerEnabled,
+  type EventFor,
+  type EventListenerStop,
+  type EventMapFor,
+  type EventTargetGetter,
+  type EventTargetLike,
+  type UseEventListenerObjectOptions,
+  type UseEventListenerOptions,
+} from './composables/useEventListener'
+export {
+  useDebouncedWatch,
+  type DebouncedWatchCallback,
+  type DebouncedWatchCleanup,
+  type DebouncedWatchSource,
+  type UseDebouncedWatchOptions,
+  type UseDebouncedWatchReturn,
+} from './composables/useDebouncedWatch'
+export {
+  useFocusTrap,
+  type UseFocusTrapOptions,
+  type UseFocusTrapReturn,
+} from './composables/useFocusTrap'
+export {
+  useRovingFocus,
+  type UseRovingFocusOptions,
+  type UseRovingFocusReturn,
+} from './composables/useRovingFocus'
+export {
+  reorderList,
+  useListReorder,
+  useReorderAnnouncer,
+  REORDER_ANNOUNCER_STYLE,
+  type ListReorderMove,
+  type UseListReorderOptions,
+  type UseListReorderReturn,
+  type UseReorderAnnouncerReturn,
+} from './composables/useListReorder'
+export {
+  useMenuKeyboard,
+  type UseMenuKeyboardOptions,
+  type UseMenuKeyboardReturn,
+} from './composables/useMenuKeyboard'
+
+// Layout, selection, expansion and sort primitives
+export {
+  resizedLeadingPanelWidth,
+  resizedTrailingPanelWidth,
+  resizedVerticalSplitPercent,
+  useManualLayoutResize,
+  type ManualLayoutResizeContext,
+  type ManualLayoutResizeTarget,
+  type ResizePanelWidthConstraints,
+  type ResizePercentConstraints,
+} from './composables/useManualLayoutResize'
+export {
+  useSelectionLimit,
+  type SelectionLimitSource,
+  type UseSelectionLimitOptions,
+  type UseSelectionLimitReturn,
+} from './composables/useSelectionLimit'
+export {
+  useListSelection,
+  type ListSelectionSource,
+  type ListSelectionValue,
+  type UseListSelectionOptions,
+  type UseListSelectionReturn,
+  type WidenListSelectionValue,
+} from './composables/useListSelection'
+export {
+  useExpansionSet,
+  type ExpansionSetSource,
+  type UseExpansionSetOptions,
+  type UseExpansionSetReturn,
+} from './composables/useExpansionSet'
+export {
+  compareSortValues,
+  useSortedItems,
+  type CompareSortValuesOptions,
+  type SortComparator,
+  type SortComparatorContext,
+  type SortDescriptor,
+  type SortedItemsSource,
+  type SortOrder,
+  type UseSortedItemsOptions,
+  type UseSortedItemsReturn,
+} from './composables/useSortedItems'
+export {
+  usePluginWorkspace,
+  type PluginWorkspaceSlotsLike,
+  type UsePluginWorkspaceOptions,
+  type UsePluginWorkspaceReturn,
+} from './composables/usePluginWorkspace'