@morscherlab/mint-sdk 1.0.0-rc.4 → 1.0.0-rc.6

package/src/composables/useControlSchema.ts

@@ -1,27 +1,6 @@
-import type {
-  ComputedRef,
-  Ref,
-} from 'vue'
-import type {
-  PillNavItem,
-  SidebarToolSection,
-  SelectOption,
-  SettingsModalSchema,
-  TopBarSettingsConfig,
-} from '../types'
-import type { AccessPolicy, AccessAudienceInput } from '../permissions'
-import type {
-  FieldCondition,
-  FieldValidation,
-  FormFieldSchema,
-  FormFieldType,
-  FormSchema,
-  FormSectionSchema,
-} from '../types/form-builder'
 import {
   defaultValueForControl,
   normalizeControls,
-  normalizeControlDefinition,
 } from './controlSchemaNormalize'
 import {
   controlToFormField,
@@ -35,11 +14,15 @@ import {
   controlsToTopBarSettingsConfig,
   controlsToViewItems,
 } from './controlSchemaAdapters'
-import {
-  omitUndefined,
-  recordValue,
-} from './controlSchemaUtils'
-import type { WellConcentration } from './useDoseCalculator'
+import type {
+  ControlComponentBindingsConfig,
+  ControlSchema,
+  ControlSchemaOptions,
+  ControlValues,
+  UseControlSchemaReturn,
+} from './controlSchemaTypes'
+
+export type * from './controlSchemaTypes'
 
 export {
   mergeControlWorkspaceOptions,
@@ -67,348 +50,19 @@ export {
   getDefaultControlView,
 } from './controlSchemaAdapters'
 
-export type ControlOptionValue = string | number | boolean
-export type ControlOption = ControlOptionValue | SelectOption<unknown>
-export type ControlPrimitive = string | number | boolean
-export type ControlShorthand = ControlPrimitive | readonly ControlOption[]
-export type ControlInput = ControlDefinition | ControlShorthand
-
-export interface ControlSectionConfig {
-  id?: string
-  label?: string
-  title?: string
-  description?: string
-  subtitle?: string
-  icon?: string | string[]
-  iconColor?: string
-  iconBg?: string
-  columns?: 1 | 2 | 3
-  condition?: FieldCondition
-  access?: AccessPolicy
-  visibleFor?: AccessAudienceInput
-  requiresAdmin?: boolean
-  permissions?: readonly string[]
-  anyPermissions?: readonly string[]
-  defaultOpen?: boolean
-  showToggle?: boolean
-}
-
-export interface ControlViewConfig {
-  label?: string
-  icon?: string
-  to?: string
-  href?: string
-  disabled?: boolean
-  children?: PillNavItem['children']
-}
-
-export interface ControlSidebarConfig extends Omit<ControlSectionConfig, 'id' | 'title' | 'description' | 'columns'> {
-  enabled?: boolean
-}
-
-export interface ControlDefinition {
-  type?: FormFieldType
-  label?: string
-  default?: unknown
-  defaultValue?: unknown
-  placeholder?: string
-  hint?: string
-  size?: 'sm' | 'md' | 'lg'
-  disabled?: boolean
-  readonly?: boolean
-  required?: boolean | string
-  min?: number | { value: number; message: string }
-  max?: number | { value: number; message: string }
-  minLength?: number | { value: number; message: string }
-  maxLength?: number | { value: number; message: string }
-  email?: boolean | string
-  pattern?: string | { value: string; message: string }
-  validation?: FieldValidation
-  condition?: FieldCondition
-  access?: AccessPolicy
-  visibleFor?: AccessAudienceInput
-  requiresAdmin?: boolean
-  permissions?: readonly string[]
-  anyPermissions?: readonly string[]
-  options?: readonly ControlOption[]
-  section?: string
-  sectionLabel?: string
-  sectionDescription?: string
-  sectionSubtitle?: string
-  view?: string
-  order?: number
-  colSpan?: number
-  props?: Record<string, unknown>
-  sidebar?: boolean | ControlSidebarConfig
-}
-
-export type ControlSchema = Record<string, ControlInput>
-export type ControlFormSchema = Extract<FormSchema, { sections: FormSectionSchema[] }>
-
-export interface ControlSchemaOptions {
-  view?: string
-  views?: Record<string, ControlViewConfig>
-  section?: string
-  sectionLabel?: string
-  sections?: Record<string, ControlSectionConfig>
-  columns?: 1 | 2 | 3
-  submitLabel?: string
-  cancelLabel?: string
-  showCancel?: boolean
-}
-
-export interface ControlWorkspaceOptions extends ControlSchemaOptions {
-  initialValues?: Record<string, unknown>
-  topBarSettings?: Omit<TopBarSettingsConfig, 'schema' | 'controls' | 'controlOptions' | 'values'>
-}
-
-export interface ControlModelSectionConfig extends ControlSectionConfig {
-  controls: ControlSchema
-  sidebar?: boolean | ControlSidebarConfig
-}
-
-export interface ControlModelViewConfig extends ControlViewConfig {
-  controls?: ControlSchema
-  section?: string
-  sectionLabel?: string
-  sectionDescription?: string
-  sections?: Record<string, ControlModelSectionConfig>
-}
-
-export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' | 'views'> {
-  controls?: ControlSchema
-  sections?: Record<string, ControlModelSectionConfig>
-  views?: Record<string, ControlModelViewConfig>
-  /** Optional SDK component bindings returned with generated component props for custom workspace slots. */
-  componentBindings?: ControlComponentBindingsConfig
-  /** Alias for componentBindings in raw control models. */
-  components?: ControlComponentBindingsConfig
-  /** Optional ControlWorkspaceView componentProps mapping returned with the generated controls/options. */
-  componentProps?: ControlComponentPropsMap
-  /** Optional named componentProps mappings returned for multiple SDK components. */
-  componentPropsById?: ControlComponentPropsByIdMap
-}
-
-export interface ControlModelBinding {
-  controls: ControlSchema
-  controlOptions: ControlWorkspaceOptions
-  componentBindings?: ControlComponentBindingsConfig
-  componentProps?: ControlComponentPropsMap
-  componentPropsById?: ControlComponentPropsByIdMap
-}
-
-export interface ControlSidebarBinding {
-  panels: Record<string, SidebarToolSection[]>
-  forms: Record<string, ControlFormSchema>
-  viewIds: string[]
-  viewItems: PillNavItem[]
-  defaultView: string
-}
-
-export interface ControlFormBinding {
-  schema: ControlFormSchema
-}
-
-export interface ControlSettingsBinding {
-  schema: SettingsModalSchema
-}
-
-export interface ControlTopBarSettingsBinding {
-  showSettings: true
-  settingsConfig: TopBarSettingsConfig
-}
-
-export interface ControlWorkspaceFormBinding extends ControlFormBinding {
-  modelValue: Record<string, unknown>
-  'onUpdate:modelValue': (values: Record<string, unknown>) => void
-}
-
-export interface ControlWorkspaceSidebarBinding extends ControlSidebarBinding {
-  activeView: string
-  modelValue: Record<string, unknown>
-  'onUpdate:modelValue': (values: Record<string, unknown>) => void
-  values: Record<string, unknown>
-  'onUpdate:values': (values: Record<string, unknown>) => void
-}
-
-export interface ControlWorkspaceTopBarSettingsBinding extends ControlTopBarSettingsBinding {
-  onSettingsValuesChange: (values: Record<string, unknown>) => void
-}
-
-export interface ControlWorkspacePillNavBinding {
-  items: PillNavItem[]
-  currentItemId: string
-  onSelect: (item: PillNavItem) => void
-}
-
-export interface ControlWorkspaceTopBarBinding extends ControlWorkspaceTopBarSettingsBinding {
-  pillNav: PillNavItem[]
-  currentPillId: string
-  onPillSelect: (item: PillNavItem) => void
-}
-
-export type ControlWorkspaceAppTopBarPillBinding = ControlWorkspaceTopBarBinding
-
-export interface ControlWorkspaceComponentBindings {
-  form: ControlWorkspaceFormBinding
-  sidebar: ControlWorkspaceSidebarBinding
-  topBar: ComputedRef<ControlWorkspaceTopBarBinding>
-  topBarSettings: ControlWorkspaceTopBarSettingsBinding
-  pillNav: ControlWorkspacePillNavBinding
-  componentBindings: ComputedRef<ControlComponentBinding[]>
-  componentBindingsById: ComputedRef<ControlComponentBindingsById>
-  componentProps: ComputedRef<Record<string, unknown>>
-  componentPropsById: ComputedRef<Record<string, Record<string, unknown>>>
-}
-
-export type ControlComponentPropSource<TValues extends Record<string, unknown> = Record<string, unknown>> =
-  | (keyof TValues & string)
-  | ((values: TValues) => unknown)
-
-export type ControlComponentPropsMap<TValues extends Record<string, unknown> = Record<string, unknown>> =
-  | readonly (keyof TValues & string)[]
-  | Record<string, ControlComponentPropSource<TValues>>
-
-export type ControlComponentPropsByIdMap<TValues extends Record<string, unknown> = Record<string, unknown>> =
-  Record<string, ControlComponentPropsMap<TValues>>
-
-export interface ControlComponentBindingConfig<TValues extends Record<string, unknown> = Record<string, unknown>> {
-  id?: string
-  component: string
-  props?: ControlComponentPropsMap<TValues>
-}
-
-export interface ControlComponentBindingRecordConfig<TValues extends Record<string, unknown> = Record<string, unknown>> {
-  component: string
-  props?: ControlComponentPropsMap<TValues>
-}
-
-export type ControlComponentBindingsConfig<TValues extends Record<string, unknown> = Record<string, unknown>> =
-  | readonly ControlComponentBindingConfig<TValues>[]
-  | Record<string, ControlComponentBindingRecordConfig<TValues>>
-
-export interface ControlComponentBinding {
-  id: string
-  component: string
-  props: Record<string, unknown>
-}
-
-export type ControlComponentBindingsById = Record<string, ControlComponentBinding>
-
-export interface WellPlateControlPropsOptions<TValues extends Record<string, unknown> = Record<string, unknown>> {
-  selectedWells?: ControlComponentPropSource<TValues>
-  format?: ControlComponentPropSource<TValues>
-  wells?: ControlComponentPropSource<TValues>
-  disabled?: ControlComponentPropSource<TValues>
-  readonly?: ControlComponentPropSource<TValues>
-  showLegend?: ControlComponentPropSource<TValues>
-  showSampleTypeIndicator?: ControlComponentPropSource<TValues>
-  /** Listener for WellPlate v-model updates. Set false to keep generated props one-way. */
-  onUpdateModelValue?: ((values: TValues) => (wellIds: string[]) => void) | false
-}
-
-export interface DoseCalculatorControlPropsOptions<TValues extends Record<string, unknown> = Record<string, unknown>> {
-  mode?: ControlComponentPropSource<TValues>
-  targetWells?: ControlComponentPropSource<TValues>
-  /** Control value key used by the default apply-to-wells handler. */
-  wells?: ControlComponentPropSource<TValues>
-  disabled?: ControlComponentPropSource<TValues>
-  molecularWeight?: ControlComponentPropSource<TValues>
-  /** Listener for DoseCalculator apply-to-wells. Set false to keep generated props one-way. */
-  onApplyToWells?: ((values: TValues) => (results: WellConcentration[]) => void) | false
-}
-
-export interface WellPlateDoseControlPropsOptions<TValues extends Record<string, unknown> = Record<string, unknown>> {
-  plateId?: string
-  doseId?: string
-  plate?: WellPlateControlPropsOptions<TValues>
-  dose?: DoseCalculatorControlPropsOptions<TValues>
-}
-
-export interface DoseDesignControlModelOptions {
-  viewId?: string
-  viewLabel?: string
-  sectionId?: string
-  sectionLabel?: string
-  sectionDescription?: string
-  selectedWells?: readonly string[]
-  plateFormat?: number
-  plateFormats?: readonly number[]
-  doseMode?: 'serial' | 'dilution' | 'conversion'
-  doseModes?: readonly ('serial' | 'dilution' | 'conversion')[]
-  disabled?: boolean
-  includeMolecularWeight?: boolean
-  molecularWeight?: number
-  componentProps?: WellPlateDoseControlPropsOptions
-}
-
-export interface UseControlSchemaReturn<TControls extends ControlSchema> {
-  controls: TControls
-  fields: FormFieldSchema[]
-  formSchema: ControlFormSchema
-  form: ControlFormBinding
-  settingsSchema: SettingsModalSchema
-  settings: ControlSettingsBinding
-  topBarSettingsConfig: TopBarSettingsConfig
-  topBarSettings: ControlTopBarSettingsBinding
-  sidebarPanels: Record<string, SidebarToolSection[]>
-  viewIds: string[]
-  viewItems: PillNavItem[]
-  defaultView: string
-  sectionSchemas: Record<string, ControlFormSchema>
-  sidebar: ControlSidebarBinding
-  initialValues: ControlValues<TControls>
-  sectionSchema: (sectionId: string) => ControlFormSchema
-}
-
-export interface UseControlWorkspaceReturn<TControls extends ControlSchema>
-  extends Omit<UseControlSchemaReturn<TControls>, 'form' | 'sidebar' | 'topBarSettings'> {
-  schema: UseControlSchemaReturn<TControls>
-  values: ControlValues<TControls> & Record<string, unknown>
-  activeView: Ref<string>
-  form: ControlWorkspaceFormBinding
-  sidebar: ControlWorkspaceSidebarBinding
-  topBar: ComputedRef<ControlWorkspaceTopBarBinding>
-  pillNav: ControlWorkspacePillNavBinding
-  topBarSettings: ControlWorkspaceTopBarSettingsBinding
-  bindings: ControlWorkspaceComponentBindings
-  componentBindings: ComputedRef<ControlComponentBinding[]>
-  componentBindingsById: ComputedRef<ControlComponentBindingsById>
-  componentProps: ComputedRef<Record<string, unknown>>
-  componentPropsById: ComputedRef<Record<string, Record<string, unknown>>>
-  setActiveView: (viewId: string) => void
-  setValues: (values: Record<string, unknown>) => void
-  resetValues: (values?: Record<string, unknown>) => void
-  getComponentProps: (
-    mapping?: ControlComponentPropsMap<ControlValues<TControls> & Record<string, unknown>>
-  ) => Record<string, unknown>
-  getComponentPropsById: (
-    mappings?: ControlComponentPropsByIdMap<ControlValues<TControls> & Record<string, unknown>>
-  ) => Record<string, Record<string, unknown>>
-  getComponentBindings: (
-    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>
-  ) => ControlComponentBinding[]
-  getComponentBindingsById: (
-    bindings?: ControlComponentBindingsConfig<ControlValues<TControls> & Record<string, unknown>>
-  ) => ControlComponentBindingsById
-}
-
-export type ControlValues<TControls extends ControlSchema> = {
-  [K in keyof TControls]: ControlValue<TControls[K]>
-}
-
-type ControlValue<TControl> =
-  TControl extends { default: infer TDefault }
-    ? TDefault
-    : TControl extends { defaultValue: infer TDefaultValue }
-      ? TDefaultValue
-      : TControl extends readonly [infer First, ...unknown[]]
-        ? OptionValue<First>
-        : TControl extends ControlPrimitive
-          ? TControl
-          : unknown
+export {
+  defineControlModel,
+  isControlModelBinding,
+  resolveControlModel,
+} from './controlSchemaModel'
 
-type OptionValue<TOption> = TOption extends SelectOption<infer TValue> ? TValue : TOption
+export {
+  defineDoseCalculatorControlProps,
+  defineDoseDesignControlModel,
+  defineWellPlateControlProps,
+  defineWellPlateDoseComponentBindings,
+  defineWellPlateDoseControlProps,
+} from './controlSchemaDoseDesign'
 
 /** Preserve literal control keys while marking an object as a MINT control schema. */
 export function defineControls<TControls extends ControlSchema>(controls: TControls): TControls {
@@ -422,94 +76,6 @@ export function defineControlComponentBindings<TBindings extends ControlComponen
   return bindings
 }
 
-/** Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars. */
-export function defineControlModel(model: ControlModel): ControlModelBinding {
-  const {
-    controls: rootControls,
-    sections: rootSections,
-    views: modelViews,
-    components,
-    componentBindings,
-    componentProps,
-    componentPropsById,
-    ...baseOptions
-  } = model
-  const resolvedComponentBindings = componentBindings ?? components
-  const controls: ControlSchema = {}
-  const views: Record<string, ControlViewConfig> = {}
-  const sections: Record<string, ControlSectionConfig> = {}
-
-  const defaultViewId = model.view ?? 'default'
-  const defaultSectionId = model.section ?? 'controls'
-
-  if (rootControls) {
-    registerSectionOptions(sections, defaultSectionId, {
-      id: defaultSectionId,
-      label: model.sectionLabel,
-      title: model.sectionLabel,
-      columns: model.columns,
-    })
-    appendModelControls(controls, rootControls, defaultViewId, defaultSectionId)
-  }
-
-  for (const [sectionId, section] of Object.entries(rootSections ?? {})) {
-    registerSectionOptions(sections, sectionId, controlModelSectionOptions(section))
-    appendModelControls(controls, section.controls, defaultViewId, sectionId, section.sidebar)
-  }
-
-  for (const [viewId, view] of Object.entries(modelViews ?? {})) {
-    const {
-      controls: viewControls,
-      sections: viewSections,
-      section,
-      sectionLabel,
-      sectionDescription,
-      ...viewConfig
-    } = view
-
-    views[viewId] = omitUndefined(viewConfig)
-
-    if (viewControls) {
-      const sectionId = section ?? `${viewId}-controls`
-      const label = sectionLabel ?? view.label
-      registerSectionOptions(sections, sectionId, {
-        id: sectionId,
-        label,
-        title: label,
-        description: sectionDescription,
-        columns: model.columns,
-      })
-      appendModelControls(controls, viewControls, viewId, sectionId)
-    }
-
-    for (const [sectionKey, sectionConfig] of Object.entries(viewSections ?? {})) {
-      const sectionId = sectionConfig.id ?? `${viewId}-${sectionKey}`
-      registerSectionOptions(sections, sectionId, controlModelSectionOptions(sectionConfig))
-      appendModelControls(controls, sectionConfig.controls, viewId, sectionId, sectionConfig.sidebar)
-    }
-  }
-
-  const controlOptions: ControlWorkspaceOptions = {
-    ...baseOptions,
-  }
-
-  if (Object.keys(views).length > 0) {
-    controlOptions.views = views
-  }
-
-  if (Object.keys(sections).length > 0) {
-    controlOptions.sections = sections
-  }
-
-  return {
-    controls,
-    controlOptions,
-    ...(resolvedComponentBindings === undefined ? {} : { componentBindings: resolvedComponentBindings }),
-    ...(componentProps === undefined ? {} : { componentProps }),
-    ...(componentPropsById === undefined ? {} : { componentPropsById }),
-  }
-}
-
 /** Build default values for a control schema, matching FormBuilder field defaults. */
 export function getControlDefaults<TControls extends ControlSchema>(
   controls: TControls,
@@ -521,139 +87,6 @@ export function getControlDefaults<TControls extends ControlSchema>(
   return values as ControlValues<TControls>
 }
 
-/** Return a default WellPlate prop mapping for generated control workspaces. */
-export function defineWellPlateControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(
-  options: WellPlateControlPropsOptions<TValues> = {},
-): ControlComponentPropsMap<TValues> {
-  const selectedWells = options.selectedWells ?? sourceKey<TValues>('selectedWells')
-  const onUpdateModelValue = options.onUpdateModelValue === false
-    ? undefined
-    : options.onUpdateModelValue ?? updateControlValueSource(selectedWells)
-
-  return compactComponentPropsMap<TValues>({
-    modelValue: selectedWells,
-    'onUpdate:modelValue': onUpdateModelValue,
-    format: options.format ?? sourceKey<TValues>('plateFormat'),
-    wells: options.wells ?? sourceKey<TValues>('wells'),
-    disabled: options.disabled ?? sourceKey<TValues>('disabled'),
-    readonly: options.readonly ?? sourceKey<TValues>('readonly'),
-    showLegend: options.showLegend,
-    showSampleTypeIndicator: options.showSampleTypeIndicator,
-  })
-}
-
-/** Return a default DoseCalculator prop mapping for generated control workspaces. */
-export function defineDoseCalculatorControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(
-  options: DoseCalculatorControlPropsOptions<TValues> = {},
-): ControlComponentPropsMap<TValues> {
-  const targetWells = options.targetWells ?? sourceKey<TValues>('selectedWells')
-  const wells = options.wells ?? sourceKey<TValues>('wells')
-  const onApplyToWells = options.onApplyToWells === false
-    ? undefined
-    : options.onApplyToWells ?? defaultDoseApplyHandler(wells, targetWells)
-
-  return compactComponentPropsMap<TValues>({
-    mode: options.mode ?? sourceKey<TValues>('doseMode'),
-    targetWells,
-    disabled: options.disabled ?? sourceKey<TValues>('disabled'),
-    molecularWeight: options.molecularWeight,
-    onApplyToWells,
-  })
-}
-
-/** Return named WellPlate + DoseCalculator prop mappings for one dose-design control model. */
-export function defineWellPlateDoseControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(
-  options: WellPlateDoseControlPropsOptions<TValues> = {},
-): ControlComponentPropsByIdMap<TValues> {
-  return {
-    [options.plateId ?? 'plate']: defineWellPlateControlProps(options.plate),
-    [options.doseId ?? 'dose']: defineDoseCalculatorControlProps(options.dose),
-  }
-}
-
-/** Return named WellPlate + DoseCalculator component bindings for one dose-design control model. */
-export function defineWellPlateDoseComponentBindings<TValues extends Record<string, unknown> = Record<string, unknown>>(
-  options: WellPlateDoseControlPropsOptions<TValues> = {},
-): ControlComponentBindingsConfig<TValues> {
-  return [
-    {
-      id: options.plateId ?? 'plate',
-      component: 'WellPlate',
-      props: defineWellPlateControlProps(options.plate),
-    },
-    {
-      id: options.doseId ?? 'dose',
-      component: 'DoseCalculator',
-      props: defineDoseCalculatorControlProps(options.dose),
-    },
-  ]
-}
-
-/** Return a complete ControlWorkspaceView model for WellPlate + DoseCalculator dose design. */
-export function defineDoseDesignControlModel(
-  options: DoseDesignControlModelOptions = {},
-): ControlModelBinding {
-  const viewId = options.viewId ?? 'design'
-  const sectionId = options.sectionId ?? 'dose'
-  const doseControls: ControlSchema = {
-    selectedWells: {
-      type: 'tags',
-      label: 'Selected wells',
-      default: [...(options.selectedWells ?? ['A1', 'A2'])],
-    },
-    plateFormat: {
-      label: 'Plate format',
-      default: options.plateFormat ?? 96,
-      options: options.plateFormats ?? [96, 384],
-    },
-    doseMode: {
-      label: 'Dose mode',
-      default: options.doseMode ?? 'serial',
-      options: options.doseModes ?? ['serial', 'dilution', 'conversion'],
-    },
-    disabled: {
-      label: 'Disable tools',
-      default: options.disabled ?? false,
-    },
-  }
-
-  if (options.includeMolecularWeight) {
-    doseControls.molecularWeight = {
-      type: 'number',
-      label: 'Molecular weight',
-      default: options.molecularWeight ?? 300,
-      min: 0,
-    }
-  }
-
-  const componentProps: WellPlateDoseControlPropsOptions = {
-    ...options.componentProps,
-    dose: {
-      ...(options.componentProps?.dose ?? {}),
-      ...(options.includeMolecularWeight && options.componentProps?.dose?.molecularWeight === undefined
-        ? { molecularWeight: 'molecularWeight' }
-        : {}),
-    },
-  }
-
-  return defineControlModel({
-    componentBindings: defineWellPlateDoseComponentBindings(componentProps),
-    componentPropsById: defineWellPlateDoseControlProps(componentProps),
-    views: {
-      [viewId]: {
-        label: options.viewLabel ?? 'Design',
-        sections: {
-          [sectionId]: {
-            label: options.sectionLabel ?? 'Dose design',
-            description: options.sectionDescription ?? 'Well selection and dose calculator controls',
-            controls: doseControls,
-          },
-        },
-      },
-    },
-  })
-}
-
 /** Prepare FormBuilder, SettingsModal, AppTopBar settings, AppSidebar, and initial values from one compact control model. */
 export function useControlSchema<TControls extends ControlSchema>(
   controls: TControls,
@@ -700,107 +133,3 @@ export function useControlSchema<TControls extends ControlSchema>(
     sectionSchema: (sectionId: string) => controlsToSectionFormSchema(controls, sectionId, options),
   }
 }
-
-function appendModelControls(
-  target: ControlSchema,
-  source: ControlSchema,
-  viewId: string,
-  sectionId: string,
-  sidebar?: boolean | ControlSidebarConfig,
-): void {
-  for (const [name, input] of Object.entries(source)) {
-    if (Object.prototype.hasOwnProperty.call(target, name)) {
-      throw new Error(
-        `Duplicate control "${name}" in defineControlModel(). Control names must be unique across views and sections.`,
-      )
-    }
-
-    const definition = normalizeControlDefinition(input)
-    target[name] = omitUndefined({
-      ...definition,
-      view: definition.view ?? viewId,
-      section: definition.section ?? sectionId,
-      sidebar: definition.sidebar ?? sidebar,
-    })
-  }
-}
-
-function controlModelSectionOptions(section: ControlModelSectionConfig): ControlSectionConfig {
-  const { controls: _controls, sidebar: _sidebar, ...options } = section
-  return omitUndefined(options)
-}
-
-function registerSectionOptions(
-  target: Record<string, ControlSectionConfig>,
-  sectionId: string,
-  options: ControlSectionConfig,
-): void {
-  target[sectionId] = omitUndefined({
-    ...(target[sectionId] ?? {}),
-    ...options,
-    id: sectionId,
-  })
-}
-
-function compactComponentPropsMap<TValues extends Record<string, unknown>>(
-  mapping: Record<string, ControlComponentPropSource<TValues> | undefined>,
-): ControlComponentPropsMap<TValues> {
-  return Object.fromEntries(
-    Object.entries(mapping).filter((entry): entry is [string, ControlComponentPropSource<TValues>] =>
-      entry[1] !== undefined
-    ),
-  )
-}
-
-function sourceKey<TValues extends Record<string, unknown>>(key: string): keyof TValues & string {
-  return key as keyof TValues & string
-}
-
-function updateControlValueSource<TValues extends Record<string, unknown>>(
-  source: ControlComponentPropSource<TValues>,
-): ((values: TValues) => (value: string[]) => void) | undefined {
-  if (typeof source !== 'string') return undefined
-  return values => (value: string[]) => {
-    const writableValues = values as Record<string, unknown>
-    writableValues[source] = value
-  }
-}
-
-function defaultDoseApplyHandler<TValues extends Record<string, unknown>>(
-  wells: ControlComponentPropSource<TValues>,
-  targetWells: ControlComponentPropSource<TValues>,
-): ((values: TValues) => (results: WellConcentration[]) => void) | undefined {
-  if (wells === targetWells) return undefined
-  return updateWellsFromDoseResults(wells)
-}
-
-function updateWellsFromDoseResults<TValues extends Record<string, unknown>>(
-  source: ControlComponentPropSource<TValues>,
-): ((values: TValues) => (results: WellConcentration[]) => void) | undefined {
-  if (typeof source !== 'string') return undefined
-  return values => (results: WellConcentration[]) => {
-    const writableValues = values as Record<string, unknown>
-    const currentWells = recordValue(writableValues[source])
-    const nextWells: Record<string, Record<string, unknown>> = {}
-    for (const [wellId, well] of Object.entries(currentWells)) {
-      nextWells[wellId] = recordValue(well)
-    }
-
-    for (const result of results) {
-      const existing = recordValue(nextWells[result.wellId])
-      const metadata = recordValue(existing.metadata)
-      nextWells[result.wellId] = {
-        ...existing,
-        state: 'filled',
-        value: result.concentration.value,
-        metadata: {
-          ...metadata,
-          concentration: result.concentration,
-          ...(result.volume === undefined ? {} : { volume: result.volume }),
-        },
-      }
-    }
-
-    writableValues[source] = nextWells
-  }
-}