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

package/src/composables/useVersionedSave.ts

@@ -0,0 +1,165 @@
+import { readonly, ref, toValue, watch, type MaybeRefOrGetter, type Ref } from 'vue'
+import { MintApiError } from '../apiErrors'
+import { useRealtime, type RealtimeEvent } from './useRealtime'
+
+/** A save the platform refused with 412 `<entity>.version_conflict`. */
+export interface VersionConflict {
+  /** The entity's current version from the 412 body; `null` when the body has none. */
+  version: number | null
+}
+
+/** Writes by other users that reached the open entity while the form held unsaved edits. */
+export interface StaleChange {
+  /** Display names of the writers, in order of arrival, without repeats. */
+  actors: readonly string[]
+  /** Labels of the changed fields, without repeats; empty when no event named them. */
+  fields: readonly string[]
+  /** ISO time of the latest write. */
+  at: string
+}
+
+export interface UseVersionedSaveOptions<T> {
+  /** The entity version the form was loaded at; sent as `If-Match: "v<version>"`. */
+  version: MaybeRefOrGetter<number | null | undefined>
+  /** Send the write. Pass `headers` on to the request. */
+  save: (headers: Record<string, string>) => Promise<T>
+  /**
+   * Refetch the entity and reset the form to it. The user's edits are discarded.
+   * Reject when no fresh record arrives: the form then keeps the edits and the conflict.
+   */
+  reload: () => unknown
+  /**
+   * The realtime topic of the open entity (`experiment:42`). `null` turns the
+   * stale banner off: pass it while the form is closed or the platform's
+   * `realtime` feature flag is off. A change of topic also clears `conflict`.
+   */
+  topic?: MaybeRefOrGetter<string | null | undefined>
+  /** True while the form holds unsaved edits. */
+  dirty?: MaybeRefOrGetter<boolean>
+  /** The display name of an event's `actor_id`; unknown users show as "Someone". */
+  userName?: (userId: string) => string | null | undefined
+  /** The label of an event field name; defaults to `end_date` → "End date". */
+  fieldLabel?: (field: string) => string
+}
+
+export interface UseVersionedSaveReturn<T> {
+  /** Save with `If-Match`. Resolves `undefined` on a 412: `conflict` is then set. Other errors reject. */
+  save: () => Promise<T | undefined>
+  /** Save again on top of the version the 412 reported. Resolves `undefined` on another 412. */
+  overwrite: () => Promise<T | undefined>
+  /** Run the `reload` option, then clear `conflict` and `stale`. Rejects, and keeps both, when the reload rejects. */
+  reload: () => Promise<void>
+  /** Close the conflict dialog and keep editing. */
+  dismissConflict: () => void
+  /** Hide the stale banner until the next write arrives. */
+  dismissStale: () => void
+  saving: Readonly<Ref<boolean>>
+  conflict: Readonly<Ref<VersionConflict | null>>
+  stale: Readonly<Ref<StaleChange | null>>
+}
+
+/** `end_date` → "End date". */
+export function fieldNameLabel(field: string): string {
+  const words = field.replace(/_/g, ' ').trim()
+  return words.charAt(0).toUpperCase() + words.slice(1)
+}
+
+function conflictVersion(cause: unknown): VersionConflict | null {
+  if (!(cause instanceof MintApiError) || cause.status !== 412) return null
+  const version = (cause.details as { version?: unknown } | null)?.version
+  return { version: typeof version === 'number' ? version : null }
+}
+
+function union(list: readonly string[], items: readonly string[]): string[] {
+  return [...new Set([...list, ...items])]
+}
+
+/**
+ * Optimistic-concurrency save for a form on a versioned entity (RFC #439).
+ *
+ * `save()` sends `If-Match` with the loaded version. A 412 sets `conflict`;
+ * show `VersionConflictDialog` for it, whose Reload calls `reload()` and
+ * whose Overwrite calls `overwrite()` (the same save, with the version from
+ * the 412). With a `topic`, a realtime write by someone else on the entity
+ * sets `stale` while the form is dirty (show `StaleFormBanner`); on a clean
+ * form it runs the `reload` option instead. Several writes merge into one
+ * `stale`.
+ *
+ * @example
+ * const versioned = useVersionedSave({
+ *   version: () => experiment.value?.version,
+ *   save: headers => api.patch(`/experiments/${id}`, payload(), { headers }),
+ *   reload: () => refetchAndResetForm(),
+ *   topic: () => (realtime && open.value ? `experiment:${id}` : null),
+ *   dirty: () => changeCount.value > 0,
+ * })
+ */
+export function useVersionedSave<T>(options: UseVersionedSaveOptions<T>): UseVersionedSaveReturn<T> {
+  const saving = ref(false)
+  const conflict = ref<VersionConflict | null>(null)
+  const stale = ref<StaleChange | null>(null)
+  const fieldLabel = options.fieldLabel ?? fieldNameLabel
+
+  async function send(version: number | null | undefined): Promise<T | undefined> {
+    saving.value = true
+    try {
+      const headers: Record<string, string> = version == null ? {} : { 'If-Match': `"v${version}"` }
+      const result = await options.save(headers)
+      conflict.value = null
+      stale.value = null
+      return result
+    } catch (cause) {
+      const refused = conflictVersion(cause)
+      if (!refused) throw cause
+      conflict.value = refused
+      return undefined
+    } finally {
+      saving.value = false
+    }
+  }
+
+  async function reload(): Promise<void> {
+    await options.reload()
+    conflict.value = null
+    stale.value = null
+  }
+
+  function onEvent(event: RealtimeEvent): void {
+    // A resync names no writer, and the user's own save echoes back while it runs.
+    if (event.type === 'resync' || saving.value || event.topic !== toValue(options.topic)) return
+    if (!toValue(options.dirty)) {
+      // A failed background refetch leaves a clean form as it is; the host reports its own faults.
+      reload().catch(() => {})
+      return
+    }
+    const actor = (event.actor_id && options.userName?.(event.actor_id)) || 'Someone'
+    const previous = stale.value
+    stale.value = {
+      actors: union(previous?.actors ?? [], [actor]),
+      fields: union(previous?.fields ?? [], (event.fields ?? []).map(fieldLabel)),
+      at: event.at ?? new Date().toISOString(),
+    }
+  }
+
+  useRealtime(() => {
+    const topic = toValue(options.topic)
+    return topic ? [topic] : []
+  }, onEvent)
+  // Another entity, or a closed form: the old writes and the old 412 no longer apply.
+  watch(() => toValue(options.topic), () => {
+    conflict.value = null
+    stale.value = null
+  })
+
+  return {
+    save: () => send(toValue(options.version)),
+    // Without a version in the 412, a save with no If-Match is the overwrite.
+    overwrite: () => send(conflict.value?.version),
+    reload,
+    dismissConflict: () => { conflict.value = null },
+    dismissStale: () => { stale.value = null },
+    saving: readonly(saving),
+    conflict: readonly(conflict),
+    stale: readonly(stale),
+  }
+}

package/src/data.ts

@@ -0,0 +1,130 @@
+// Experiment, artifact, file and job data components (`@morscherlab/mint-sdk/data`).
+
+// Experiment / analysis components
+export { default as ExperimentSelectorModal } from './components/ExperimentSelectorModal.vue'
+export { default as ArtifactSelectorModal } from './components/ArtifactSelectorModal.vue'
+export { default as ArtifactSaveDialog } from './components/ArtifactSaveDialog.vue'
+export { default as ExperimentPopover } from './components/ExperimentPopover.vue'
+export { default as ExperimentCodeBadge } from './components/ExperimentCodeBadge.vue'
+export { default as FilePicker } from './components/FilePicker.vue'
+
+// Workflow components
+export { default as AuditTrail } from './components/AuditTrail.vue'
+export { default as BatchProgressList } from './components/BatchProgressList.vue'
+export { default as JobsStatusTray } from './components/JobsStatusTray.vue'
+
+// Form components
+export { default as TagsInput } from './components/TagsInput.vue'
+export { default as SecretInput } from './components/SecretInput.vue'
+
+// Versioned save (RFC #439): the 412 conflict dialog and the stale-form banner
+export { default as VersionConflictDialog } from './components/VersionConflictDialog.vue'
+export { default as StaleFormBanner } from './components/StaleFormBanner.vue'
+export {
+  useVersionedSave,
+  fieldNameLabel,
+  type StaleChange,
+  type UseVersionedSaveOptions,
+  type UseVersionedSaveReturn,
+  type VersionConflict,
+} from './composables/useVersionedSave'
+
+// Experiment and artifact data
+export {
+  useExperimentData,
+  type UseExperimentDataOptions,
+  type UseExperimentDataReturn,
+} from './composables/useExperimentData'
+export {
+  useArtifacts,
+  ANALYSIS_FILE_ARTIFACT_SCHEMA,
+  type UseArtifactsOptions,
+  type UseArtifactsReturn,
+} from './composables/useArtifacts'
+export { experimentIdFromRoute } from './composables/experiment-utils'
+export * as experimentStatus from './utils/experimentStatus'
+export * as pluginSecret from './utils/pluginSecrets'
+export type { PluginSecretRef, PluginSecretState } from './utils/pluginSecrets'
+
+// Text import and search
+export {
+  parseDelimitedText,
+  type DelimitedTable,
+  type ParseDelimitedTextOptions,
+} from './composables/useFileImport'
+export {
+  candidateMatchesSearch,
+  normalizeSearchQuery,
+  useTextSearch,
+  type TextSearchCandidate,
+  type TextSearchSource,
+  type UseTextSearchOptions,
+  type UseTextSearchReturn,
+} from './composables/useTextSearch'
+
+// File picker adapters
+export {
+  usePlatformFilePickerAdapter,
+  encodePlatformPickerPath,
+  decodePlatformPickerPath,
+} from './composables/usePlatformFilePickerAdapter'
+export {
+  createFilePickerAdapter,
+  type FilePickerTransport,
+  type FilePickerAdapterOptions,
+} from './composables/createFilePickerAdapter'
+
+// Experiment, sample and file helpers
+export {
+  useExperimentSelector,
+  type UseExperimentSelectorOptions,
+  type UseExperimentSelectorReturn,
+} from './composables/useExperimentSelector'
+export {
+  useFileBrowser,
+  type UseFileBrowserOptions,
+  type UseFileBrowserReturn,
+} from './composables/useFileBrowser'
+export {
+  buildAnalysisArtifactTargetQuery,
+  parseAnalysisArtifactTarget,
+} from './composables/analysisArtifactTarget'
+export {
+  formatExperimentDate,
+  resolveExperimentCode,
+  datePresetToISO,
+  DATE_PRESET_OPTIONS,
+  SORT_OPTIONS,
+} from './composables/experiment-utils'
+export {
+  extractSampleNamesFromDesignData,
+  extractSampleOptionsFromDesignData,
+  unwrapExperimentDesignData,
+  type ExperimentDesignDataResponse,
+  type ExtractExperimentSamplesOptions,
+} from './composables/experimentDesignData'
+export {
+  useExperimentSamples,
+  type ExperimentDesignDataSource,
+  type ExperimentIdSource,
+  type UseExperimentSamplesOptions,
+  type UseExperimentSamplesReturn,
+} from './composables/useExperimentSamples'
+export {
+  useAppExperiment,
+  APP_EXPERIMENT_KEY,
+  type UseAppExperimentOptions,
+  type UseAppExperimentReturn,
+  type AppExperimentState,
+  type AppExperimentPopoverBinding,
+  type AppExperimentSelectorModalBinding,
+} from './composables/useAppExperiment'
+export {
+  detectDelimiter,
+  readFileAsText,
+  useFileImport,
+  validateImportFile,
+  type FileImportOptions,
+  type FileImportValidationOptions,
+  type UseFileImportReturn,
+} from './composables/useFileImport'

package/src/deprecatedRootExports.ts

@@ -0,0 +1,226 @@
+// Package-root names that spec 3.1 and 3.3 do not list as L1 or L2 (maintainer decision
+// 2026-10-23). Each name is also exported from the subpath in its tag. Removed in MINT 1.5.
+// `export *` keeps the tags, so editors mark a root import of these names as deprecated.
+
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useConcentrationUnits,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type ConcentrationValue,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type ConcentrationUnit,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type MolarityUnit,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type MassVolumeUnit,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type PercentageUnit,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UnitCategory,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseConcentrationUnitsReturn,
+} from './composables/useConcentrationUnits'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useProtocolTemplates,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type ParameterDefinition,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type StepTemplate,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type ValidationResult,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseProtocolTemplatesReturn,
+} from './composables/useProtocolTemplates'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useRackEditor,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseRackEditorOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseRackEditorReturn,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type PlateEditorListeners,
+} from './composables/useRackEditor'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useSequenceUtils,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SequenceType,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SequenceStats,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SequenceProblems,
+} from './composables/useSequenceUtils'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useScheduleDrag,
+} from './composables/useScheduleDrag'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useReagentSeries,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ generateDilutionSeries,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ DEFAULT_PRESETS,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ DEFAULT_UNITS,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type LevelEntry,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type DilutionPreset,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseReagentSeriesReturn,
+} from './composables/useReagentSeries'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ useSampleGroups,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type DisplaySampleSubGroup,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SampleGroupNode,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SampleGroupSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SampleMajorGroup,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseSampleGroupsOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type UseSampleGroupsReturn,
+} from './composables/useSampleGroups'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ hexToHsl,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ hslToHex,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ deriveShade,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type Hsl,
+} from './utils/color'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ sampleTypeMarker,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SampleMarkerType,
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ type SampleTypeMarker,
+} from './utils/sampleTypeMarker'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/lab'. Removed in MINT 1.5. */ mintPlotlyTemplate,
+} from './utils/plotlyTemplate'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ resizedLeadingPanelWidth,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ resizedTrailingPanelWidth,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ resizedVerticalSplitPercent,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ useManualLayoutResize,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ManualLayoutResizeContext,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ManualLayoutResizeTarget,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ResizePanelWidthConstraints,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ResizePercentConstraints,
+} from './composables/useManualLayoutResize'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ useSelectionLimit,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SelectionLimitSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseSelectionLimitOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseSelectionLimitReturn,
+} from './composables/useSelectionLimit'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ useListSelection,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ListSelectionSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ListSelectionValue,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseListSelectionOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseListSelectionReturn,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type WidenListSelectionValue,
+} from './composables/useListSelection'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ useExpansionSet,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type ExpansionSetSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseExpansionSetOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseExpansionSetReturn,
+} from './composables/useExpansionSet'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ compareSortValues,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ useSortedItems,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type CompareSortValuesOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SortComparator,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SortComparatorContext,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SortDescriptor,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SortedItemsSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type SortOrder,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseSortedItemsOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UseSortedItemsReturn,
+} from './composables/useSortedItems'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ usePluginWorkspace,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type PluginWorkspaceSlotsLike,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UsePluginWorkspaceOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/shell'. Removed in MINT 1.5. */ type UsePluginWorkspaceReturn,
+} from './composables/usePluginWorkspace'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ useExperimentSelector,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseExperimentSelectorOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseExperimentSelectorReturn,
+} from './composables/useExperimentSelector'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ useFileBrowser,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseFileBrowserOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseFileBrowserReturn,
+} from './composables/useFileBrowser'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ buildAnalysisArtifactTargetQuery,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ parseAnalysisArtifactTarget,
+} from './composables/analysisArtifactTarget'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ formatExperimentDate,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ resolveExperimentCode,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ datePresetToISO,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ DATE_PRESET_OPTIONS,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ SORT_OPTIONS,
+} from './composables/experiment-utils'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ extractSampleNamesFromDesignData,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ extractSampleOptionsFromDesignData,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ unwrapExperimentDesignData,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type ExperimentDesignDataResponse,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type ExtractExperimentSamplesOptions,
+} from './composables/experimentDesignData'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ useExperimentSamples,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type ExperimentDesignDataSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type ExperimentIdSource,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseExperimentSamplesOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseExperimentSamplesReturn,
+} from './composables/useExperimentSamples'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ useAppExperiment,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ APP_EXPERIMENT_KEY,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseAppExperimentOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseAppExperimentReturn,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type AppExperimentState,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type AppExperimentPopoverBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type AppExperimentSelectorModalBinding,
+} from './composables/useAppExperiment'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ detectDelimiter,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ readFileAsText,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ useFileImport,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ validateImportFile,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type FileImportOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type FileImportValidationOptions,
+  /** @deprecated Import from '@morscherlab/mint-sdk/data'. Removed in MINT 1.5. */ type UseFileImportReturn,
+} from './composables/useFileImport'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ useForm,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ValidationRule,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type FieldRules,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type FieldState,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type UseFormReturn,
+} from './composables/useForm'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ useFormBuilder,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ evaluateCondition,
+} from './composables/useFormBuilder'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ getFieldRegistryEntry,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ getTypeDefault,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type RegistryEntry,
+} from './composables/formBuilderRegistry'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ defineControlComponentBindings,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ defineControls,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ getDefaultControlView,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ getControlDefaults,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ useControlSchema,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ useControlWorkspace,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlFormSchema,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlFormBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlSettingsBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlSidebarBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlTopBarSettingsBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlValues,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type UseControlSchemaReturn,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceAppTopBarPillBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceComponentBindings,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceFormBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspacePillNavBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceSidebarBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceTopBarBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type ControlWorkspaceTopBarSettingsBinding,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type UseControlWorkspaceReturn,
+} from './composables/useControlSchema'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ resolveCurrentPluginId,
+} from './composables/platformContextHelpers'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ resolveJobCapabilities,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ normalizeJobPercent,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ normalizeJobState,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ isActiveJobStatus,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ isTerminalJobStatus,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ jobStatusLabel,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type JobCapabilityInput,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ type JobCapabilities,
+} from './jobs'
+export {
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ generatedJobFormSchema,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ generatedJobDefaults,
+  /** @deprecated Import from '@morscherlab/mint-sdk/runtime'. Removed in MINT 1.5. */ normalizeGeneratedJobInput,
+} from './generated/schema'

package/src/generated/schema.ts

@@ -31,6 +31,7 @@ export function generatedJobFormSchema(definition: GeneratedJobDefinition): Form
       columns: 1,
       fields,
     }],
+    actions: true,
     submitLabel: 'Run analysis',
   }
 }

package/src/host.ts

@@ -0,0 +1,27 @@
+// Platform-only entry (`@morscherlab/mint-sdk/host`). Plugins do not import it.
+// The platform writes its session into the SDK session bridge through these functions.
+
+import { AUTH_EXPIRES_STORAGE_KEY, AUTH_TOKEN_STORAGE_KEY, useAuthStore } from './stores/auth'
+import type { UserInfo } from './types'
+
+export { AUTH_EXPIRES_STORAGE_KEY, AUTH_TOKEN_STORAGE_KEY }
+export type { ExperimentStoreBinding, MintIntegrationHost } from './utils/integrationHost'
+
+/** Set the session token SDK clients send. `null` signs the bridge out. */
+export function setSession(token: string | null, expiresAt: Date | null = null): void {
+  useAuthStore().$patch((state) => {
+    state.token = token
+    state.tokenExpires = token ? expiresAt : null
+    state.isInitialized = true
+  })
+}
+
+/** Set the signed-in user SDK components read. */
+export function setSessionUser(user: UserInfo | null): void {
+  useAuthStore().$patch((state) => { state.userInfo = user })
+}
+
+/** Tell SDK components whether the platform requires sign-in. */
+export function setAuthRequired(required: boolean): void {
+  useAuthStore().$patch((state) => { state.authRequired = required })
+}

package/src/index.ts

@@ -12,81 +12,12 @@ export * from './components'
 
 // Composables
 export * from './composables'
-// Resolve names shared by composables and templates so root exports stay unambiguous.
-export {
-  getBioTemplateComponentProps,
-  toBioTemplateComponentPropsByComponent,
-  type ControlDefinition,
-} from './composables'
 
 // Stores
 export * from './stores'
 
-// Permissions
-export * from './permissions'
-
-// Instrument monitoring. Deprecated: scheduled for removal in MINT 1.4 (moves to the mld-ms plugins).
-export * from './instrument'
-
-// Job state helpers
-export * from './jobs'
-
-// Experimental generated analysis workspace
-export * from './generated/schema'
-
-// LCMS sequence helpers. Deprecated: scheduled for removal in MINT 1.4, no SDK replacement.
-export * from './lcms'
-
-// Utils
-export {
-  hexToHsl,
-  hslToHex,
-  deriveShade,
-  type Hsl,
-} from './utils/color'
-export {
-  PLUGIN_SECRET_FORMAT_KEY,
-  PLUGIN_SECRET_FORMAT_REF,
-  PLUGIN_SECRET_REF_KEY,
-  clearPluginSecret,
-  isPluginSecretLocked,
-  isPluginSecretRef,
-  keepPluginSecret,
-  pluginSecretId,
-  pluginSecretLabel,
-  pluginSecretState,
-  setPluginSecret,
-  usesPluginSecretReferences,
-  type PluginSecretRef,
-  type PluginSecretState,
-} from './utils/pluginSecrets'
-export {
-  sampleTypeMarker,
-  type SampleMarkerType,
-  type SampleTypeMarker,
-} from './utils/sampleTypeMarker'
-export { mintPlotlyTemplate } from './utils/plotlyTemplate'
-export {
-  LCMS_DEFAULT_CONTROL_POSITIONS,
-  createLcmsControlWellEditData,
-  getLcmsDefaultControlWellId,
-  lcmsPlateCellsToRack,
-  lcmsPlateCellsToRacks,
-  lcmsPlateTypeToRackFormat,
-  lcmsWellId,
-  parseLcmsWellId,
-  rackFormatToLcmsPlateType,
-  rackToLcmsPlateCells,
-  racksToLcmsPlateCells,
-  type LcmsControlSampleType,
-  type LcmsPlateCell,
-  type LcmsPlateCellsToRackOptions,
-  type LcmsPlateCellsToRacksOptions,
-  type LcmsPlateType,
-} from './utils/rack'
-
-// Biology data templates. Deprecated: scheduled for removal from the core SDK in MINT 1.4.
-export * from './templates'
+// Root names outside L1 and L2, deprecated until MINT 1.5
+export * from './deprecatedRootExports'
 
 // Types
 export type * from './types'