@morscherlab/mint-sdk 1.0.0-beta.7 → 1.0.0-rc.2

package/src/styles/components/settings-modal.css

@@ -94,6 +94,15 @@ html.dark .mint-settings-modal__option-btn--active {
   padding: 0 !important;
 }
 
+.mint-settings-modal__footer {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  margin-top: 1rem;
+  padding-top: 1rem;
+  border-top: 1px solid var(--border-light);
+}
+
 /* ─────────────────────────────────────────────────────────────────────
  * Schema-driven content grid (used by both layouts)
  * Cols come from `--mint-settings-cols` set inline by the component;

package/src/styles/components/tabs.css

@@ -9,10 +9,13 @@
 }
 
 .mint-tabs--pills {
+  width: fit-content;
+  max-width: 100%;
   gap: 0.5rem;
   padding: 0.25rem;
   background-color: var(--bg-tertiary);
   border-radius: var(--radius-md);
+  overflow-x: auto;
 }
 
 .mint-tab {
@@ -84,6 +87,12 @@
   color: currentColor;
 }
 
+.mint-tab__icon--svg {
+  width: 1rem;
+  height: 1rem;
+  flex-shrink: 0;
+}
+
 .mint-tab__badge {
   margin-left: 0.25rem;
   padding: 0.125rem 0.375rem;

package/src/styles/components/well-edit-popup.css

@@ -120,7 +120,7 @@
 /* Sample type buttons */
 .mint-well-edit-popup__type-grid {
   display: grid;
-  grid-template-columns: repeat(3, 1fr);
+  grid-template-columns: repeat(4, 1fr);
   gap: 0.25rem;
 }
 
@@ -154,6 +154,12 @@
   color: #8b5cf6;
 }
 
+.mint-well-edit-popup__type-btn--iqc {
+  background-color: rgba(236, 72, 153, 0.15);
+  border-color: rgba(236, 72, 153, 0.4);
+  color: #ec4899;
+}
+
 /* Injection count buttons */
 .mint-well-edit-popup__count-grid {
   display: grid;

package/src/styles/components/well-plate.css

@@ -183,6 +183,11 @@
   border: 1px solid rgba(139, 92, 246, 0.4);
 }
 
+.mint-well-plate__well--iqc {
+  background-color: rgba(236, 72, 153, 0.15);
+  border: 1px solid rgba(236, 72, 153, 0.4);
+}
+
 /* Condition header - drug label row */
 .mint-well-plate__condition-label {
   font-weight: 600;

package/src/styles/index.css

@@ -20,6 +20,7 @@
 @import './components/file-uploader.css';
 @import './components/form-field.css';
 @import './components/icon-button.css';
+@import './components/instrument-monitor.css';
 @import './components/input.css';
 @import './components/modal.css';
 @import './components/number-input.css';
@@ -46,6 +47,7 @@
 @import './components/sample-hierarchy-tree.css';
 @import './components/protocol-step-editor.css';
 @import './components/segmented-control.css';
+@import './components/sequence-progress-bar.css';
 @import './components/multi-select.css';
 @import './components/pill.css';
 @import './components/dropdown-button.css';
@@ -54,6 +56,7 @@
 @import './components/well-edit-popup.css';
 @import './components/rack-editor.css';
 @import './components/loading-spinner.css';
+@import './components/lcms-sequence-table.css';
 @import './components/divider.css';
 @import './components/status-indicator.css';
 @import './components/progress-bar.css';

package/src/templates/builders.ts

@@ -14,6 +14,7 @@ import type {
   CreateBioTemplatePackCollectionOptions,
   CreateElisaAssayCollectionOptions,
   CreateLcmsBatchCollectionOptions,
+  CreateTargetedMetabolomicsCollectionOptions,
   CreateAssayMatrixTemplateOptions,
   CreateCalibrationCurveTemplateOptions,
   CreateDoseResponseTemplateOptions,
@@ -38,6 +39,7 @@ import type {
   FlowPanelMarker,
   InstrumentMethod,
   InstrumentRunItem,
+  InstrumentRunItemInput,
   InstrumentRunTemplate,
   InstrumentRunTemplateData,
   PlateMapTemplate,
@@ -858,6 +860,67 @@ export function createLcmsBatchCollection(
   )
 }
 
+export function createTargetedMetabolomicsCollection(
+  options: CreateTargetedMetabolomicsCollectionOptions = {}
+): TemplateCollectionEnvelope {
+  const sampleRecords = presetSampleRecords(options.samples ?? ['S001', 'S002'])
+  const responseUnit = options.responseUnit ?? 'peak area ratio'
+  const concentrationUnit = options.concentrationUnit ?? 'uM'
+  const metaboliteFeatures = normalizeMetaboliteFeatures(
+    options.metabolites ?? ['Glucose', 'Lactate', 'Pyruvate'],
+    responseUnit,
+  )
+  const sampleSheet = createSampleSheetTemplate({ samples: sampleRecords })
+  const samplePrep = createSamplePrepTemplate({
+    samples: sampleRecords.map(sample => sample.sampleId),
+    prepType: options.prepType ?? 'extraction',
+    protocolName: 'Metabolomics sample preparation',
+    outputVolume: options.outputVolume ?? 50,
+    metadata: { assay: 'targeted-metabolomics' },
+  })
+  const reagents = createReagentListTemplate({
+    reagents: normalizeInternalStandardReagents(
+      options.internalStandards ?? ['Stable isotope internal standard mix'],
+    ),
+    metadata: { assay: 'targeted-metabolomics' },
+  })
+  const calibrationCurve = createCalibrationCurveTemplate({
+    concentrations: options.standardConcentrations ?? [0.1, 1, 10, 100],
+    analyte: options.calibrationAnalyte ?? firstFeatureName(metaboliteFeatures, 'Metabolite panel'),
+    unit: concentrationUnit,
+    responseUnit,
+    model: 'linear-weighted-1-x',
+    includeQc: options.includeQc,
+    metadata: { assay: 'targeted-metabolomics' },
+  })
+  const instrumentRun = createInstrumentRunTemplate({
+    items: targetedMetabolomicsRunItems(
+      sampleRecords,
+      calibrationCurve.data.points,
+      options.includeQc !== false,
+    ),
+    method: options.method ?? 'Targeted metabolomics',
+    instrument: options.instrument ?? 'LC-MS',
+    includeBlanks: false,
+    includeQc: false,
+    metadata: { assay: 'targeted-metabolomics' },
+  })
+  const assayMatrix = createAssayMatrixTemplate({
+    samples: sampleRecords.map(sample => ({
+      sampleId: sample.sampleId,
+      name: sample.name,
+      group: sample.group,
+      metadata: sample.metadata ?? {},
+    })),
+    features: metaboliteFeatures,
+    metadata: { assay: 'targeted-metabolomics', responseUnit },
+  })
+  return createTemplateCollection(
+    [sampleSheet, samplePrep, reagents, instrumentRun, calibrationCurve, assayMatrix],
+    { preset: 'targeted-metabolomics', ...(options.metadata ?? {}) }
+  )
+}
+
 export function createElisaAssayCollection(
   options: CreateElisaAssayCollectionOptions = {}
 ): TemplateCollectionEnvelope {
@@ -1009,6 +1072,10 @@ export function createBioTemplatePresetCollection(
   name: 'lcms-batch',
   options?: CreateLcmsBatchCollectionOptions
 ): TemplateCollectionEnvelope
+export function createBioTemplatePresetCollection(
+  name: 'targeted-metabolomics',
+  options?: CreateTargetedMetabolomicsCollectionOptions
+): TemplateCollectionEnvelope
 export function createBioTemplatePresetCollection(
   name: 'elisa-assay',
   options?: CreateElisaAssayCollectionOptions
@@ -1027,6 +1094,7 @@ export function createBioTemplatePresetCollection(
     | CreateWellPlateScreenCollectionOptions
     | CreateQpcrExpressionCollectionOptions
     | CreateLcmsBatchCollectionOptions
+    | CreateTargetedMetabolomicsCollectionOptions
     | CreateElisaAssayCollectionOptions
     | CreateFlowCytometryAssayCollectionOptions
     | CreateWesternBlotAssayCollectionOptions
@@ -1037,6 +1105,7 @@ export function createBioTemplatePresetCollection(
     | CreateWellPlateScreenCollectionOptions
     | CreateQpcrExpressionCollectionOptions
     | CreateLcmsBatchCollectionOptions
+    | CreateTargetedMetabolomicsCollectionOptions
     | CreateElisaAssayCollectionOptions
     | CreateFlowCytometryAssayCollectionOptions
     | CreateWesternBlotAssayCollectionOptions = {}
@@ -1054,6 +1123,9 @@ export function createBioTemplatePresetCollection(
   if (preset.name === 'lcms-batch') {
     return createLcmsBatchCollection(options as CreateLcmsBatchCollectionOptions)
   }
+  if (preset.name === 'targeted-metabolomics') {
+    return createTargetedMetabolomicsCollection(options as CreateTargetedMetabolomicsCollectionOptions)
+  }
   if (preset.name === 'elisa-assay') {
     return createElisaAssayCollection(options as CreateElisaAssayCollectionOptions)
   }
@@ -1080,6 +1152,10 @@ export function bioTemplatePresetControlValuesToOptions(
   name: 'lcms-batch',
   values: BioTemplateControlValues
 ): CreateLcmsBatchCollectionOptions
+export function bioTemplatePresetControlValuesToOptions(
+  name: 'targeted-metabolomics',
+  values: BioTemplateControlValues
+): CreateTargetedMetabolomicsCollectionOptions
 export function bioTemplatePresetControlValuesToOptions(
   name: 'elisa-assay',
   values: BioTemplateControlValues
@@ -1099,6 +1175,7 @@ export function bioTemplatePresetControlValuesToOptions(
   | CreateWellPlateScreenCollectionOptions
   | CreateQpcrExpressionCollectionOptions
   | CreateLcmsBatchCollectionOptions
+  | CreateTargetedMetabolomicsCollectionOptions
   | CreateElisaAssayCollectionOptions
   | CreateFlowCytometryAssayCollectionOptions
   | CreateWesternBlotAssayCollectionOptions
@@ -1109,6 +1186,7 @@ export function bioTemplatePresetControlValuesToOptions(
   | CreateWellPlateScreenCollectionOptions
   | CreateQpcrExpressionCollectionOptions
   | CreateLcmsBatchCollectionOptions
+  | CreateTargetedMetabolomicsCollectionOptions
   | CreateElisaAssayCollectionOptions
   | CreateFlowCytometryAssayCollectionOptions
   | CreateWesternBlotAssayCollectionOptions {
@@ -1149,6 +1227,26 @@ export function bioTemplatePresetControlValuesToOptions(
     }
   }
 
+  if (preset.name === 'targeted-metabolomics') {
+    return {
+      samples: readStringList(values.sampleNames, ['S001', 'S002']),
+      metabolites: readStringList(values.metaboliteNames, ['Glucose', 'Lactate', 'Pyruvate']),
+      internalStandards: readStringList(
+        values.internalStandards,
+        ['Stable isotope internal standard mix'],
+      ),
+      standardConcentrations: readNumberList(values.standardConcentrations, [0.1, 1, 10, 100]),
+      concentrationUnit: readString(values.concentrationUnit, 'uM'),
+      responseUnit: readString(values.responseUnit, 'peak area ratio'),
+      calibrationAnalyte: readOptionalString(values.calibrationAnalyte),
+      instrument: readString(values.instrument, 'LC-MS'),
+      method: readString(values.method, 'Targeted metabolomics'),
+      prepType: readString(values.prepType, 'extraction') as CreateSamplePrepTemplateOptions['prepType'],
+      outputVolume: readNumber(values.outputVolume, 50),
+      includeQc: readBoolean(values.includeQc, true),
+    }
+  }
+
   if (preset.name === 'elisa-assay') {
     return {
       samples: readStringList(values.sampleNames, ['Control', 'Treatment']),
@@ -1194,6 +1292,10 @@ export function createBioTemplatePresetCollectionFromControls(
   name: 'lcms-batch',
   values: BioTemplateControlValues
 ): TemplateCollectionEnvelope
+export function createBioTemplatePresetCollectionFromControls(
+  name: 'targeted-metabolomics',
+  values: BioTemplateControlValues
+): TemplateCollectionEnvelope
 export function createBioTemplatePresetCollectionFromControls(
   name: 'elisa-assay',
   values: BioTemplateControlValues
@@ -1863,6 +1965,96 @@ function normalizeReagent(reagent: ReagentTemplateInput): ReagentRecord {
   }
 }
 
+function normalizeMetaboliteFeatures(
+  metabolites: Array<string | AssayFeature>,
+  responseUnit: string,
+): AssayFeature[] {
+  return metabolites.map((metabolite, index) => {
+    if (typeof metabolite === 'string') {
+      return {
+        id: idFromName(metabolite, `metabolite-${index + 1}`),
+        name: metabolite,
+        type: 'metabolite',
+        unit: responseUnit,
+        metadata: { quantitation: 'targeted' },
+      }
+    }
+
+    const feature = normalizeAssayFeature(metabolite)
+    return {
+      ...feature,
+      type: feature.type ?? 'metabolite',
+      unit: feature.unit ?? responseUnit,
+      metadata: {
+        quantitation: 'targeted',
+        ...feature.metadata,
+      },
+    }
+  })
+}
+
+function normalizeInternalStandardReagents(
+  internalStandards: Array<string | ReagentTemplateInput>,
+): ReagentTemplateInput[] {
+  return internalStandards.map((standard, index) => {
+    if (typeof standard === 'string') {
+      return {
+        id: idFromName(standard, `internal-standard-${index + 1}`),
+        name: standard,
+        kind: 'compound',
+        metadata: { role: 'internal-standard' },
+      }
+    }
+
+    const reagent = normalizeReagent(standard)
+    return {
+      ...reagent,
+      kind: standard.kind ?? 'compound',
+      metadata: {
+        role: 'internal-standard',
+        ...reagent.metadata,
+      },
+    }
+  })
+}
+
+function targetedMetabolomicsRunItems(
+  samples: SampleRecord[],
+  calibrationPoints: CalibrationPoint[],
+  includeQc: boolean,
+): InstrumentRunItemInput[] {
+  const calibrationItems = calibrationPoints
+    .filter(point => point.role !== 'qc' || includeQc)
+    .filter(point => point.role === 'blank' || point.role === 'standard' || point.role === 'qc')
+    .map((point): InstrumentRunItemInput => ({
+      id: `${point.id}-run`,
+      kind: calibrationRunItemKind(point.role),
+      name: point.level,
+      metadata: {
+        concentration: point.concentration,
+        unit: point.unit,
+        role: point.role,
+      },
+    }))
+
+  const sampleItems = samples.map((sample): InstrumentRunItemInput => ({
+    sampleId: sample.sampleId,
+    name: sample.name ?? sample.sampleId,
+    kind: 'sample',
+  }))
+
+  return [...calibrationItems, ...sampleItems]
+}
+
+function calibrationRunItemKind(role: CalibrationPoint['role']): 'blank' | 'standard' | 'qc' {
+  if (role === 'blank' || role === 'standard' || role === 'qc') return role
+  return 'standard'
+}
+
+function firstFeatureName(features: AssayFeature[], fallback: string): string {
+  return features.find(feature => feature.name)?.name ?? fallback
+}
+
 function normalizeDateString(value: Date | string | null | undefined): string | undefined {
   if (value === undefined || value === null) return undefined
   return value instanceof Date ? value.toISOString() : value
@@ -2114,6 +2306,15 @@ function readInteger(value: unknown, fallback: number): number {
   return Number.isFinite(parsed) ? Math.max(1, Math.round(parsed)) : fallback
 }
 
+function readNumber(value: unknown, fallback: number): number {
+  const parsed = typeof value === 'number'
+    ? value
+    : typeof value === 'string'
+      ? Number(value)
+      : Number.NaN
+  return Number.isFinite(parsed) ? parsed : fallback
+}
+
 function readBoolean(value: unknown, fallback: boolean): boolean {
   return typeof value === 'boolean' ? value : fallback
 }

package/src/templates/controlSchemas.ts

@@ -412,6 +412,74 @@ const presetControlSchemas = {
     ...templateControlSchemas['instrument-run'],
     ...templateControlSchemas['assay-matrix'],
   },
+  'targeted-metabolomics': {
+    sampleNames: {
+      type: 'tags',
+      label: 'Samples',
+      default: ['S001', 'S002'],
+      section: 'samples',
+      sectionLabel: 'Samples',
+      sectionSubtitle: 'Unknowns and QC pool',
+      view: 'run',
+      sidebar: { icon: ICONS.samples, iconColor: '#10b981', iconBg: '#d1fae5' },
+    },
+    metaboliteNames: {
+      type: 'tags',
+      label: 'Metabolites',
+      default: ['Glucose', 'Lactate', 'Pyruvate'],
+      section: 'features',
+      sectionLabel: 'Metabolites',
+      sectionSubtitle: 'Quantitation panel',
+      view: 'analysis',
+      sidebar: { icon: ICONS.table, iconColor: '#0ea5e9', iconBg: '#e0f2fe' },
+    },
+    internalStandards: {
+      type: 'tags',
+      label: 'Internal standards',
+      default: ['Stable isotope internal standard mix'],
+      section: 'standards',
+      sectionLabel: 'Standards',
+      sectionSubtitle: 'Calibration and internal standards',
+      view: 'analysis',
+      sidebar: { icon: ICONS.dose, iconColor: '#8b5cf6', iconBg: '#ede9fe' },
+    },
+    standardConcentrations: {
+      type: 'tags',
+      label: 'Calibration levels',
+      default: ['0.1', '1', '10', '100'],
+      section: 'standards',
+      view: 'analysis',
+    },
+    concentrationUnit: {
+      label: 'Concentration unit',
+      default: 'uM',
+      options: CONCENTRATION_UNITS,
+      section: 'standards',
+      view: 'analysis',
+    },
+    responseUnit: {
+      label: 'Response unit',
+      default: 'peak area ratio',
+      section: 'readout',
+      sectionLabel: 'Readout',
+      view: 'analysis',
+      sidebar: { icon: ICONS.table, iconColor: '#0ea5e9', iconBg: '#e0f2fe' },
+    },
+    instrument: {
+      ...templateControlSchemas['instrument-run'].instrument,
+      default: 'LC-MS',
+    },
+    method: {
+      ...templateControlSchemas['instrument-run'].method,
+      default: 'Targeted metabolomics',
+    },
+    prepType: {
+      ...templateControlSchemas['sample-prep'].prepType,
+      default: 'extraction',
+    },
+    outputVolume: templateControlSchemas['sample-prep'].outputVolume,
+    includeQc: templateControlSchemas['instrument-run'].includeQc,
+  },
   'elisa-assay': {
     sampleNames: {
       type: 'tags',

package/src/templates/index.ts

@@ -20,6 +20,7 @@ export {
   createReagentListTemplate,
   createSampleSheetTemplate,
   createSamplePrepTemplate,
+  createTargetedMetabolomicsCollection,
   createTemplateCollection,
   createDefaultBioTemplate,
   createTimeCourseTemplate,
@@ -186,6 +187,7 @@ export type {
   CreateFlowCytometryPanelTemplateOptions,
   CreateInstrumentRunTemplateOptions,
   CreateLcmsBatchCollectionOptions,
+  CreateTargetedMetabolomicsCollectionOptions,
   CreatePlateMapTemplateOptions,
   CreateProtocolStepsTemplateOptions,
   CreateQpcrExpressionCollectionOptions,

package/src/templates/presets.ts

@@ -74,6 +74,29 @@ export const bioTemplatePresets = [
     frontend_adapters: ['toTemplateDataFrame', 'toInstrumentRunDataFrame', 'toInstrumentRunSteps', 'toInstrumentRunScheduleEvents', 'toAssayMatrixDataFrame', 'toAssayMatrixSampleOptions'],
     components: ['DataFrame', 'ExperimentTimeline', 'ScheduleCalendar', 'ChartContainer', 'SampleSelector'],
   },
+  {
+    name: 'targeted-metabolomics',
+    label: 'Targeted metabolomics',
+    category: 'bio-template-preset',
+    purpose: 'Sample metadata, extraction prep, internal standards, LC/GC-MS sequence, calibration curve, and metabolite readout matrix for quantitative metabolomics.',
+    templates: ['sample-sheet', 'sample-prep', 'reagent-list', 'instrument-run', 'calibration-curve', 'assay-matrix'],
+    aliases: [
+      'targeted metabolomics',
+      'quantitative metabolomics',
+      'lc-ms metabolomics',
+      'gc-ms metabolomics',
+      'targeted lcms',
+      'metabolite quantitation',
+      'mass spec quantitation',
+      'internal standards',
+      'peak area ratio',
+    ],
+    python_import: 'from mint_sdk.templates import create_targeted_metabolomics_collection, save_template_collection',
+    python_example: 'create_targeted_metabolomics_collection(samples=["S001", "S002"], metabolites=["Glucose", "Lactate"], internal_standards=["13C Glucose"], instrument="LC-MS")',
+    frontend_import: "import { createTargetedMetabolomicsCollection, toInstrumentRunDataFrame, toCalibrationCurveDataFrame, toAssayMatrixDataFrame, toTemplateDataFrame } from '@morscherlab/mint-sdk/templates'",
+    frontend_adapters: ['toTemplateDataFrame', 'toSamplePrepDataFrame', 'toReagentDataFrame', 'toInstrumentRunDataFrame', 'toInstrumentRunSteps', 'toInstrumentRunScheduleEvents', 'toCalibrationCurveDataFrame', 'toAssayMatrixDataFrame', 'toAssayMatrixSampleOptions'],
+    components: ['DataFrame', 'ReagentList', 'ExperimentTimeline', 'ScheduleCalendar', 'FitPanel', 'ChartContainer', 'SampleSelector'],
+  },
   {
     name: 'elisa-assay',
     label: 'ELISA assay',

package/src/templates/types.ts

@@ -31,6 +31,7 @@ export type TemplatePresetId =
   | 'wellplate-screen'
   | 'qpcr-expression'
   | 'lcms-batch'
+  | 'targeted-metabolomics'
   | 'elisa-assay'
   | 'flow-cytometry-assay'
   | 'western-blot-assay'
@@ -596,6 +597,22 @@ export interface CreateLcmsBatchCollectionOptions {
   metadata?: Record<string, unknown>
 }
 
+export interface CreateTargetedMetabolomicsCollectionOptions {
+  samples?: Array<string | SampleRecord>
+  metabolites?: Array<string | AssayFeature>
+  internalStandards?: Array<string | ReagentTemplateInput>
+  standardConcentrations?: number[]
+  concentrationUnit?: string
+  responseUnit?: string
+  calibrationAnalyte?: string
+  instrument?: string
+  method?: string | InstrumentMethodInput
+  prepType?: SamplePrepStepType
+  outputVolume?: number
+  includeQc?: boolean
+  metadata?: Record<string, unknown>
+}
+
 export interface CreateElisaAssayCollectionOptions {
   samples?: Array<string | SampleRecord>
   analyte?: string

package/src/types/auth.ts

@@ -1,3 +1,5 @@
+import type { RoleInfo } from '../permissions'
+
 // Authentication configuration
 export interface AuthConfig {
   authRequired: boolean
@@ -14,6 +16,7 @@ export interface UserInfo {
   shortname: string | null
   email: string | null
   role: string
+  roleObj?: RoleInfo | null
   isActive: boolean
 }
 

package/src/types/components.ts

@@ -1,4 +1,5 @@
 import type { UserSummary } from './platform'
+import type { AccessControlled, AccessAudience, AccessAudienceInput } from '../permissions'
 
 // Container types
 export type ContainerDirection = 'row' | 'column'
@@ -29,7 +30,7 @@ export interface Toast {
 export interface TabItem {
   id: string
   label: string
-  icon?: string
+  icon?: string | string[]
   disabled?: boolean
   badge?: string | number
 }
@@ -121,6 +122,8 @@ export interface TopBarSettingsConfig {
   values?: Record<string, unknown>
   /** Dynamic enhancements (validators, dynamic options, callbacks). Forwarded to SettingsModal. */
   enhancements?: import('./form-builder').FormEnhancements
+  /** Optional user type override for permission-filtered settings content. Defaults to SDK auth/platform context. */
+  userType?: SettingsUserType
 }
 
 // TopBar pill-nav items (centered top-level navigation)
@@ -232,6 +235,29 @@ export interface WellEditData {
 // Fields shown in the edit popup
 export type WellEditField = 'label' | 'sampleType' | 'injectionVolume' | 'injectionCount' | 'customMethod'
 
+// External sample drop payloads for WellPlate / RackEditor
+export interface WellSampleDropData {
+  id?: string
+  sampleName?: string
+  label?: string
+  sampleType?: string
+  injectionVolume?: number
+  injectionCount?: number
+  customMethod?: string | null
+  metadata?: Record<string, unknown>
+  raw?: unknown
+}
+
+export interface WellSampleDropContext {
+  wellId: string
+  event: DragEvent
+}
+
+export type WellSampleDropParser = (
+  event: DragEvent,
+  context: WellSampleDropContext
+) => WellSampleDropData | null | undefined
+
 // Legend item for sample type display
 export interface WellLegendItem {
   type: string
@@ -265,6 +291,18 @@ export interface Rack {
   wells: Record<string, Partial<Well>>
 }
 
+export interface RackSampleDropContext {
+  rack: Rack
+  rackId: string
+  wellId: string
+  event: DragEvent
+}
+
+export type RackSampleDropMapper = (
+  data: WellSampleDropData,
+  context: RackSampleDropContext
+) => WellEditData | null | undefined
+
 // Sample Legend types
 export interface SampleType {
   id: string
@@ -531,7 +569,7 @@ export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right'
 export type ConfirmVariant = 'danger' | 'warning' | 'info'
 
 // SettingsModal types
-export interface SettingsTab {
+export interface SettingsTab extends AccessControlled {
   id: string
   label: string
   /**
@@ -553,7 +591,7 @@ export type SettingsModalLayout = 'horizontal' | 'vertical'
  * SDK form components (BaseInput / BaseSelect / NumberInput / Toggle / …)
  * via the same registry that powers FormBuilder.
  */
-export interface SettingsGroup {
+export interface SettingsGroup extends AccessControlled {
   id: string
   label: string
   description?: string
@@ -574,6 +612,10 @@ export interface SettingsModalSchema {
   groups: SettingsGroup[]
 }
 
+export type SettingsUserType = Exclude<AccessAudience, 'all'>
+export type SettingsAudience = AccessAudience
+export type SettingsAudienceInput = AccessAudienceInput
+
 // ScientificNumber types
 export type NumberNotation = 'auto' | 'scientific' | 'engineering' | 'compact'
 

package/src/types/form-builder.ts

@@ -1,5 +1,6 @@
 import type { FieldRules } from '../composables/useForm'
 import type { OptionPrimitive, SelectOption } from './components'
+import type { AccessControlled } from '../permissions'
 
 // ---------------------------------------------------------------------------
 // Field types
@@ -71,7 +72,7 @@ export interface FieldValidation {
 // Field schema
 // ---------------------------------------------------------------------------
 
-export interface FormFieldSchema {
+export interface FormFieldSchema extends AccessControlled {
   name: string
   label: string
   type: FormFieldType