@morscherlab/mint-sdk 1.0.0-beta.2 → 1.0.0-beta.4

package/src/components/{WellEditPopup.vue → internal/WellEditPopupInternal.vue}

@@ -1,6 +1,7 @@
 <script setup lang="ts">
-import { ref, watch, computed, onMounted, onUnmounted } from 'vue'
-import type { Well, WellEditData, WellEditField } from '../types'
+import { ref, watch, computed } from 'vue'
+import type { Well, WellEditData, WellEditField } from '../../types'
+import { useEventListener } from '../../composables/useEventListener'
 
 interface Props {
   wellId: string
@@ -83,13 +84,7 @@ function handleKeydown(e: KeyboardEvent) {
   if (e.key === 'Escape') close()
 }
 
-onMounted(() => {
-  document.addEventListener('keydown', handleKeydown)
-})
-
-onUnmounted(() => {
-  document.removeEventListener('keydown', handleKeydown)
-})
+useEventListener(() => document, 'keydown', handleKeydown)
 
 const sampleTypeButtons = [
   { type: 'sample', label: 'S', tooltip: 'Sample' },
@@ -230,5 +225,5 @@ const sampleTypeButtons = [
 </template>
 
 <style>
-@import '../styles/components/well-edit-popup.css';
+@import '../../styles/components/well-edit-popup.css';
 </style>

package/src/composables/experiment-utils.ts

@@ -1,5 +1,10 @@
 import type { DatePreset, ExperimentStatus, SelectOption, PillVariant } from '../types'
 
+interface ExperimentCodeSource {
+  id?: number | null
+  experiment_code?: string | null
+}
+
 export function formatExperimentDate(dateStr: string): string {
   try {
     return new Date(dateStr).toLocaleDateString(undefined, {
@@ -41,6 +46,27 @@ export const EXPERIMENT_STATUS_LABELS: Record<ExperimentStatus, string> = {
   cancelled: 'Cancelled',
 }
 
+export function formatExperimentStatus(status?: ExperimentStatus | string | null): string {
+  if (!status) return ''
+  if (status in EXPERIMENT_STATUS_LABELS) {
+    return EXPERIMENT_STATUS_LABELS[status as ExperimentStatus]
+  }
+  const label = String(status).replace(/[-_]+/g, ' ').trim()
+  return label ? label.replace(/^\w/, c => c.toUpperCase()) : ''
+}
+
+export function getExperimentStatusVariant(status?: ExperimentStatus | string | null): PillVariant {
+  if (status && status in EXPERIMENT_STATUS_VARIANT_MAP) {
+    return EXPERIMENT_STATUS_VARIANT_MAP[status as ExperimentStatus]
+  }
+  return 'default'
+}
+
+export function resolveExperimentCode(experiment: ExperimentCodeSource): string | undefined {
+  if (experiment.experiment_code) return experiment.experiment_code
+  return experiment.id != null ? `EXP-${experiment.id}` : undefined
+}
+
 export const DATE_PRESET_OPTIONS: SelectOption<string>[] = [
   { value: '', label: 'Any time' },
   { value: 'last_7_days', label: 'Last 7 days' },

package/src/composables/index.ts

@@ -43,6 +43,7 @@ export {
   type SerialDilutionParams,
   type SerialDilutionStep,
   type SerialDilutionResult,
+  type ConversionResult,
   type WellConcentration,
   type UseDoseCalculatorReturn,
 } from './useDoseCalculator'
@@ -75,6 +76,7 @@ export {
   useTimeUtils,
   parseTime,
   formatTime,
+  formatTimeSlot,
   generateTimeSlots,
   rangesOverlap,
   durationMinutes,
@@ -84,8 +86,30 @@ export {
   snapToSlot,
   addMinutes,
   compareTime,
+  findNearestTimeSlotIndex,
+  toMinutes,
+  fromMinutes,
 } from './useTimeUtils'
 export { useScheduleDrag } from './useScheduleDrag'
+export {
+  useEventListener,
+  type EventListenerEnabled,
+  type EventFor,
+  type EventListenerStop,
+  type EventMapFor,
+  type EventTargetGetter,
+  type EventTargetLike,
+  type UseEventListenerObjectOptions,
+  type UseEventListenerOptions,
+} from './useEventListener'
+export {
+  useDebouncedWatch,
+  type DebouncedWatchCallback,
+  type DebouncedWatchCleanup,
+  type DebouncedWatchSource,
+  type UseDebouncedWatchOptions,
+  type UseDebouncedWatchReturn,
+} from './useDebouncedWatch'
 export { useFormBuilder, evaluateCondition } from './useFormBuilder'
 export { useAutoGroup, DEFAULT_COLORS, extractSamplesFromDesignData } from './useAutoGroup'
 export {
@@ -105,6 +129,9 @@ export {
 } from './useExperimentSelector'
 export {
   formatExperimentDate,
+  formatExperimentStatus,
+  getExperimentStatusVariant,
+  resolveExperimentCode,
   datePresetToISO,
   EXPERIMENT_STATUS_OPTIONS,
   EXPERIMENT_STATUS_VARIANT_MAP,
@@ -125,9 +152,13 @@ export {
 export {
   useAppExperiment,
   APP_EXPERIMENT_KEY,
+  type AppExperimentRecord,
+  type AppExperimentSource,
   type UseAppExperimentOptions,
   type UseAppExperimentReturn,
   type AppExperimentState,
+  type AppExperimentPopoverBinding,
+  type AppExperimentSelectorModalBinding,
 } from './useAppExperiment'
 export {
   useExperimentSave,
@@ -135,6 +166,201 @@ export {
   type UseExperimentSaveReturn,
 } from './useExperimentSave'
 export {
-  usePluginApi,
-  type UsePluginApiOptions,
-} from './usePluginApi'
+  useTemplateCollection,
+  type TemplateCollectionInput,
+  type UseTemplateCollectionOptions,
+  type UseTemplateCollectionReturn,
+} from './useTemplateCollection'
+export {
+  useRequestSyncState,
+  type RequestSyncRunOptions,
+  type RequestSyncSuccessKind,
+  type UseRequestSyncStateReturn,
+} from './useRequestSyncState'
+export {
+  useSelectionLimit,
+  type SelectionLimitSource,
+  type UseSelectionLimitOptions,
+  type UseSelectionLimitReturn,
+} from './useSelectionLimit'
+export {
+  useListSelection,
+  type ListSelectionSource,
+  type ListSelectionValue,
+  type UseListSelectionOptions,
+  type UseListSelectionReturn,
+  type WidenListSelectionValue,
+} from './useListSelection'
+export {
+  useGroupAssignment,
+  type GroupAssignmentSource,
+  type GroupAssignmentState,
+  type GroupAssignmentZone,
+  type UseGroupAssignmentOptions,
+  type UseGroupAssignmentReturn,
+} from './useGroupAssignment'
+export {
+  useSampleGroups,
+  type DisplaySampleSubGroup,
+  type SampleGroupSource,
+  type SampleMajorGroup,
+  type UseSampleGroupsOptions,
+  type UseSampleGroupsReturn,
+} from './useSampleGroups'
+export {
+  useExpansionSet,
+  type ExpansionSetSource,
+  type UseExpansionSetOptions,
+  type UseExpansionSetReturn,
+} from './useExpansionSet'
+export {
+  compareSortValues,
+  useSortedItems,
+  type CompareSortValuesOptions,
+  type SortComparator,
+  type SortComparatorContext,
+  type SortDescriptor,
+  type SortedItemsSource,
+  type SortOrder,
+  type UseSortedItemsOptions,
+  type UseSortedItemsReturn,
+} from './useSortedItems'
+export {
+  candidateMatchesSearch,
+  normalizeSearchQuery,
+  useTextSearch,
+  type TextSearchCandidate,
+  type TextSearchSource,
+  type UseTextSearchOptions,
+  type UseTextSearchReturn,
+} from './useTextSearch'
+export {
+  controlsToFormSchema,
+  controlsToSectionFormSchema,
+  controlsToSectionFormSchemas,
+  controlsToSidebarPanels,
+  controlsToSettingsSchema,
+  controlsToTopBarSettingsConfig,
+  controlsToViewIds,
+  controlsToViewItems,
+  controlValuesToComponentBindings,
+  controlValuesToComponentBindingsById,
+  controlValuesToComponentProps,
+  defineControlComponentBindings,
+  defineControlModel,
+  defineDoseDesignControlModel,
+  defineDoseCalculatorControlProps,
+  defineControls,
+  defineWellPlateControlProps,
+  defineWellPlateDoseComponentBindings,
+  defineWellPlateDoseControlProps,
+  getDefaultControlView,
+  getControlDefaults,
+  useControlSchema,
+  useControlWorkspace,
+  type ControlDefinition,
+  type ControlComponentBinding,
+  type ControlComponentBindingConfig,
+  type ControlComponentBindingRecordConfig,
+  type ControlComponentBindingsById,
+  type ControlComponentBindingsConfig,
+  type ControlComponentPropSource,
+  type ControlComponentPropsByIdMap,
+  type ControlComponentPropsMap,
+  type DoseDesignControlModelOptions,
+  type DoseCalculatorControlPropsOptions,
+  type ControlFormSchema,
+  type ControlInput,
+  type ControlModel,
+  type ControlModelBinding,
+  type ControlModelSectionConfig,
+  type ControlModelViewConfig,
+  type ControlOption,
+  type ControlOptionValue,
+  type ControlPrimitive,
+  type ControlSchema,
+  type ControlSchemaOptions,
+  type ControlShorthand,
+  type ControlWorkspaceOptions,
+  type ControlFormBinding,
+  type ControlSettingsBinding,
+  type ControlSidebarBinding,
+  type ControlSectionConfig,
+  type ControlSidebarConfig,
+  type ControlTopBarSettingsBinding,
+  type ControlViewConfig,
+  type ControlValues,
+  type UseControlSchemaReturn,
+  type ControlWorkspaceAppTopBarPillBinding,
+  type ControlWorkspaceComponentBindings,
+  type ControlWorkspaceFormBinding,
+  type ControlWorkspacePillNavBinding,
+  type ControlWorkspaceSidebarBinding,
+  type ControlWorkspaceTopBarBinding,
+  type ControlWorkspaceTopBarSettingsBinding,
+  type UseControlWorkspaceReturn,
+  type WellPlateControlPropsOptions,
+  type WellPlateDoseControlPropsOptions,
+} from './useControlSchema'
+export {
+  getBioTemplateControlSchema,
+  requireBioTemplateControlSchema,
+  useBioTemplateControls,
+  type BioTemplateControlSchema,
+  type BioTemplateControlTarget,
+} from './useBioTemplateControls'
+export {
+  getBioTemplateComponentProps,
+  getBioTemplateComponentBindings,
+  toBioTemplateComponentBindings,
+  toBioTemplateComponentBindingsById,
+  toBioTemplateComponentProps,
+  toBioTemplateComponentPropsByComponent,
+  toBioTemplateComponentPropsById,
+  useBioTemplateComponents,
+  type BioTemplateComponentBinding,
+  type BioTemplateComponentBindingsById,
+  type BioTemplateComponentPropsByComponent,
+  type BioTemplateComponentPropsBinding,
+  type BioTemplateComponentPropsById,
+  type BioTemplateComponentPropsLookupOptions,
+  type BioTemplateResolvedComponentBinding,
+  type BioTemplateComponentTarget,
+  type UseBioTemplateComponentsReturn,
+} from './useBioTemplateComponents'
+export {
+  useBioTemplateWorkspace,
+  type BioTemplateRendererBinding,
+  type BioTemplateWorkspaceBindings,
+  type BioTemplateWorkspaceTarget,
+  type UseBioTemplateWorkspaceReturn,
+} from './useBioTemplateWorkspace'
+export {
+  useBioTemplatePresetWorkspace,
+  type BioTemplatePresetWorkspaceBindings,
+  type UseBioTemplatePresetWorkspaceOptions,
+  type UseBioTemplatePresetWorkspaceReturn,
+} from './useBioTemplatePresetWorkspace'
+export {
+  useBioTemplatePackWorkspace,
+  type UseBioTemplatePackWorkspaceOptions,
+  type UseBioTemplatePackWorkspaceReturn,
+} from './useBioTemplatePackWorkspace'
+export {
+  buildPluginEndpointUrl,
+  createPluginClient,
+  getPluginPageSelectorItems,
+  resolvePluginBaseUrl,
+  usePluginClient,
+  usePluginSettings,
+  useCurrentExperiment,
+  type BuildPluginEndpointUrlOptions,
+  type PluginContract,
+  type PluginEndpointContract,
+  type PluginEndpointDefinition,
+  type PluginHttpMethod,
+  type PluginNavItemContract,
+  type CreatePluginClientOptions,
+  type UseCurrentExperimentOptions,
+  type UseCurrentExperimentReturn,
+} from './usePluginClient'

package/src/composables/platformContextHelpers.ts

@@ -0,0 +1,74 @@
+import type { PlatformContext } from '../types'
+
+export type ExperimentAwarePlatformContext = PlatformContext & {
+  currentExperiment?: unknown
+  currentExperimentId?: unknown
+  experiment?: unknown
+  experimentId?: unknown
+}
+
+export function getInjectedPlatformContext(): PlatformContext | undefined {
+  if (typeof window === 'undefined') return undefined
+  return (window as unknown as { __MINT_PLATFORM__?: PlatformContext }).__MINT_PLATFORM__
+}
+
+export function getInjectedExperimentContext(): ExperimentAwarePlatformContext | undefined {
+  return getInjectedPlatformContext() as ExperimentAwarePlatformContext | undefined
+}
+
+export function currentExperimentFromContext<TExperiment>(
+  context: ExperimentAwarePlatformContext | undefined = getInjectedExperimentContext(),
+): TExperiment | undefined {
+  const candidate = context?.currentExperiment ?? context?.experiment
+  return candidate && typeof candidate === 'object'
+    ? candidate as TExperiment
+    : undefined
+}
+
+export function currentExperimentIdFromContext(
+  context: ExperimentAwarePlatformContext | undefined = getInjectedExperimentContext(),
+): number | undefined {
+  return parseExperimentId(
+    context?.currentExperimentId ??
+    context?.experimentId ??
+    context?.currentExperiment ??
+    context?.experiment,
+  )
+}
+
+export function currentExperimentIdFromUrl(): number | undefined {
+  if (typeof window === 'undefined') return undefined
+  const params = new URLSearchParams(window.location.search)
+  return parseExperimentId(params.get('experimentId') ?? params.get('experiment_id'))
+    ?? experimentIdFromPath(window.location.pathname)
+    ?? experimentIdFromPath(window.location.hash.replace(/^#\/?/, '/'))
+}
+
+export function resolveCurrentExperimentId(
+  context: ExperimentAwarePlatformContext | undefined = getInjectedExperimentContext(),
+): number | undefined {
+  return currentExperimentIdFromContext(context) ?? currentExperimentIdFromUrl()
+}
+
+export function parseExperimentId(value: unknown): number | undefined {
+  if (typeof value === 'number' && Number.isFinite(value)) return value
+  if (typeof value === 'string' && value.trim()) {
+    const parsed = Number(value)
+    return Number.isFinite(parsed) ? parsed : undefined
+  }
+  if (value && typeof value === 'object' && 'id' in value) {
+    return parseExperimentId((value as { id?: unknown }).id)
+  }
+  return undefined
+}
+
+function experimentIdFromPath(path: string): number | undefined {
+  const segments = path.split('/').filter(Boolean)
+  for (let index = 0; index < segments.length - 1; index += 1) {
+    const segment = segments[index]?.toLowerCase()
+    if (segment === 'experiment' || segment === 'experiments') {
+      return parseExperimentId(decodeURIComponent(segments[index + 1] ?? ''))
+    }
+  }
+  return undefined
+}

package/src/composables/useApi.ts

@@ -5,6 +5,13 @@ import { useAuthStore } from '../stores/auth'
 let apiClientInstance: AxiosInstance | null = null
 let interceptorAttached = false
 
+function joinUrlPath(baseUrl: string, path: string): string {
+  if (!path) return baseUrl
+  const normalizedBase = baseUrl.replace(/\/+$/, '')
+  const normalizedPath = path.replace(/^\/+/, '/')
+  return `${normalizedBase}${normalizedPath.startsWith('/') ? normalizedPath : `/${normalizedPath}`}`
+}
+
 function getApiClient(): AxiosInstance {
   if (!apiClientInstance) {
     apiClientInstance = axios.create({
@@ -144,12 +151,12 @@ export function useApi(options: ApiClientOptions = {}): UseApiReturn {
   // Build full URL for external use (e.g., <a href="...">)
   function buildUrl(path: string): string {
     const baseUrl = options.baseUrl ?? settingsStore.getApiBaseUrl()
-    return `${baseUrl}${path}`
+    return joinUrlPath(baseUrl, path)
   }
 
   // WebSocket URL builder
   function buildWsUrl(path: string): string {
-    return `${settingsStore.getWsBaseUrl()}${path}`
+    return joinUrlPath(settingsStore.getWsBaseUrl(), path)
   }
 
   return {

package/src/composables/useAppExperiment.ts

@@ -4,14 +4,28 @@ import {
   readonly,
   provide,
   toValue,
+  watch,
   onScopeDispose,
   type Ref,
   type ComputedRef,
   type InjectionKey,
 } from 'vue'
 import type { ExperimentSummary, ExperimentStatus } from '../types'
+import { resolveExperimentCode } from './experiment-utils'
+
+export type AppExperimentRecord = Pick<ExperimentSummary, 'id' | 'name' | 'status' | 'experiment_code'>
+
+export type AppExperimentSource =
+  | AppExperimentRecord
+  | null
+  | undefined
+  | Ref<AppExperimentRecord | null | undefined>
+  | ComputedRef<AppExperimentRecord | null | undefined>
+  | (() => AppExperimentRecord | null | undefined)
 
 export interface UseAppExperimentOptions {
+  /** Current experiment source to mirror into the app shell. Accepts a value, ref, computed, or getter. */
+  experiment?: AppExperimentSource
   onSelect?: (experiment: ExperimentSummary) => void | Promise<void>
   onSave?: () => string | null | Promise<string | null>
   onDetach?: () => void
@@ -19,12 +33,37 @@ export interface UseAppExperimentOptions {
   saveDisabledMessage?: string | Ref<string | undefined> | ComputedRef<string | undefined>
 }
 
+export interface AppExperimentPopoverBinding {
+  experimentName?: string
+  experimentCode?: string
+  experimentStatus?: ExperimentStatus
+  showSave: boolean
+  showDetach: boolean
+  saveDisabled: boolean
+  saveDisabledMessage?: string
+  saveLoading: boolean
+  saveSuccessMessage?: string
+}
+
+export interface AppExperimentSelectorModalBinding {
+  modelValue: boolean
+  currentExperimentId: number | null
+}
+
 export interface UseAppExperimentReturn {
-  set: (experiment: Pick<ExperimentSummary, 'id' | 'name' | 'status' | 'experiment_code'>) => void
+  set: (experiment: AppExperimentRecord) => void
   clear: () => void
   experimentName: Readonly<Ref<string | undefined>>
   experimentCode: Readonly<Ref<string | undefined>>
+  experimentStatus: Readonly<Ref<ExperimentStatus | undefined>>
   experimentId: Readonly<Ref<number | null>>
+  popover: ComputedRef<AppExperimentPopoverBinding>
+  selectorModal: ComputedRef<AppExperimentSelectorModalBinding>
+  openModal: () => void
+  closeModal: () => void
+  handleSelect: (experiment: ExperimentSummary) => void
+  handleSave: () => Promise<void>
+  handleDetach: () => void
 }
 
 export interface AppExperimentState {
@@ -40,6 +79,8 @@ export interface AppExperimentState {
   closeModal: () => void
   saveDisabled: ComputedRef<boolean>
   saveDisabledMessage: ComputedRef<string | undefined>
+  popover: ComputedRef<AppExperimentPopoverBinding>
+  selectorModal: ComputedRef<AppExperimentSelectorModalBinding>
   openModal: () => void
   handleSelect: (experiment: ExperimentSummary) => void
   handleSave: () => Promise<void>
@@ -48,7 +89,7 @@ export interface AppExperimentState {
 
 export const APP_EXPERIMENT_KEY: InjectionKey<AppExperimentState> = Symbol('app-experiment')
 
-/** Manages the active experiment selection, save flow, and detach action for a plugin's app shell. */
+/** Manages the current experiment selection, save flow, and detach action for a plugin's AppTopBar app shell. */
 export function useAppExperiment(options: UseAppExperimentOptions = {}): UseAppExperimentReturn {
   const experimentName = ref<string | undefined>()
   const experimentCode = ref<string | undefined>()
@@ -64,19 +105,26 @@ export function useAppExperiment(options: UseAppExperimentOptions = {}): UseAppE
   const showDetach = computed(() => experimentId.value !== null)
   const saveDisabled = computed(() => toValue(options.saveDisabled) ?? false)
   const saveDisabledMessage = computed(() => toValue(options.saveDisabledMessage))
-
-  function set(experiment: Pick<ExperimentSummary, 'id' | 'name' | 'status' | 'experiment_code'>) {
+  const popover = computed<AppExperimentPopoverBinding>(() => ({
+    experimentName: experimentName.value,
+    experimentCode: experimentCode.value,
+    experimentStatus: experimentStatus.value,
+    showSave: showSave.value,
+    showDetach: showDetach.value,
+    saveDisabled: saveDisabled.value,
+    saveDisabledMessage: saveDisabledMessage.value,
+    saveLoading: saveLoading.value,
+    saveSuccessMessage: saveSuccessMessage.value,
+  }))
+  const selectorModal = computed<AppExperimentSelectorModalBinding>(() => ({
+    modelValue: showModal.value,
+    currentExperimentId: experimentId.value,
+  }))
+
+  function set(experiment: AppExperimentRecord) {
     experimentId.value = experiment.id
     experimentName.value = experiment.name
-    // Fallback: if no explicit experiment_code, derive `EXP-${id}` so the
-    // topbar always has a compact identifier to show instead of the long
-    // name. Matches the `EXP-${id}` format used elsewhere (e.g., queue
-    // cards in mint-ms-planner). Callers with the real code should pass it
-    // via `experiment_code` to keep the topbar chip in sync with the
-    // formal code shown in the popover panel.
-    experimentCode.value = experiment.experiment_code ?? (
-      experiment.id != null ? `EXP-${experiment.id}` : undefined
-    )
+    experimentCode.value = resolveExperimentCode(experiment)
     experimentStatus.value = experiment.status
   }
 
@@ -87,6 +135,20 @@ export function useAppExperiment(options: UseAppExperimentOptions = {}): UseAppE
     experimentStatus.value = undefined
   }
 
+  if (options.experiment !== undefined) {
+    watch(
+      () => toValue(options.experiment),
+      (experiment) => {
+        if (experiment) {
+          set(experiment)
+        } else {
+          clear()
+        }
+      },
+      { immediate: true },
+    )
+  }
+
   function openModal() {
     showModal.value = true
   }
@@ -140,6 +202,8 @@ export function useAppExperiment(options: UseAppExperimentOptions = {}): UseAppE
     showDetach,
     saveDisabled,
     saveDisabledMessage,
+    popover,
+    selectorModal,
     openModal,
     closeModal,
     handleSelect,
@@ -154,6 +218,14 @@ export function useAppExperiment(options: UseAppExperimentOptions = {}): UseAppE
     clear,
     experimentName: readonly(experimentName),
     experimentCode: readonly(experimentCode),
+    experimentStatus: readonly(experimentStatus),
     experimentId: readonly(experimentId),
+    popover,
+    selectorModal,
+    openModal,
+    closeModal,
+    handleSelect,
+    handleSave,
+    handleDetach,
   }
 }