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

package/src/components/WellPlate.vue

@@ -1,7 +1,8 @@
 <script setup lang="ts">
 /** Interactive 96/384-well plate grid with drag-to-select, heatmap overlays, per-well editing, and sample-color mapping. */
-import { ref, computed, onMounted, onUnmounted } from 'vue'
+import { ref, computed } from 'vue'
 import type { WellPlateFormat, WellPlateSelectionMode, WellPlateSize, Well, HeatmapConfig, WellShape, WellEditField, WellEditData, WellLegendItem, ColumnCondition, RowCondition } from '../types'
+import { useEventListener } from '../composables/useEventListener'
 import WellEditPopup from './WellEditPopup.vue'
 
 interface Props {
@@ -562,15 +563,8 @@ function handleKeyDown(event: KeyboardEvent) {
   }
 }
 
-onMounted(() => {
-  document.addEventListener('mouseup', handleMouseUp)
-  document.addEventListener('keydown', handleKeyDown)
-})
-
-onUnmounted(() => {
-  document.removeEventListener('mouseup', handleMouseUp)
-  document.removeEventListener('keydown', handleKeyDown)
-})
+useEventListener(() => document, 'mouseup', handleMouseUp)
+useEventListener(() => document, 'keydown', handleKeyDown)
 
 const containerStyle = computed(() =>
   isFillMode.value ? {} : {

package/src/components/index.ts

@@ -27,12 +27,14 @@ export { default as FileUploader } from './FileUploader.vue'
 
 // Feedback components
 export { default as AlertBox } from './AlertBox.vue'
+/** @deprecated Use AppToastContainer instead. */
 export { default as ToastNotification } from './ToastNotification.vue'
-export { default as AppToastContainer } from './ToastNotification.vue'
+export { default as AppToastContainer } from './AppToastContainer.vue'
 
 // Action components
 export { default as IconButton } from './IconButton.vue'
 export { default as ThemeToggle } from './ThemeToggle.vue'
+/** @deprecated Use AppTopBar instead. */
 export { default as SettingsButton } from './SettingsButton.vue'
 
 // Layout components
@@ -44,6 +46,7 @@ export { default as AppAvatarMenu } from './AppAvatarMenu.vue'
 export { default as AppPluginSwitcher } from './AppPluginSwitcher.vue'
 export { default as AppSidebar } from './AppSidebar.vue'
 export { default as AppLayout } from './AppLayout.vue'
+export { default as ControlWorkspaceView } from './ControlWorkspaceView.vue'
 export { default as AppContainer } from './AppContainer.vue'
 export { default as PluginIcon } from './PluginIcon.vue'
 
@@ -62,6 +65,10 @@ export { default as ChartContainer } from './ChartContainer.vue'
 export { default as SettingsModal } from './SettingsModal.vue'
 
 // Biological experiment components
+export { default as BioTemplateRenderer } from './BioTemplateRenderer.vue'
+export { default as BioTemplateExperimentWorkspaceView } from './BioTemplateExperimentWorkspaceView.vue'
+export { default as BioTemplatePackWorkspaceView } from './BioTemplatePackWorkspaceView.vue'
+export { default as BioTemplatePresetWorkspaceView } from './BioTemplatePresetWorkspaceView.vue'
 export { default as WellPlate } from './WellPlate.vue'
 export { default as RackEditor } from './RackEditor.vue'
 export { default as SampleLegend } from './SampleLegend.vue'
@@ -70,6 +77,7 @@ export { default as ExperimentTimeline } from './ExperimentTimeline.vue'
 
 // Sample management components
 export { default as SampleSelector } from './SampleSelector.vue'
+/** @deprecated Use AutoGroupModal instead. */
 export { default as GroupingModal } from './GroupingModal.vue'
 export { default as AutoGroupModal } from './AutoGroupModal.vue'
 export { default as GroupAssigner } from './GroupAssigner.vue'
@@ -99,8 +107,10 @@ export { default as BatchProgressList } from './BatchProgressList.vue'
 
 // Form builder components
 export { default as FormBuilder } from './FormBuilder.vue'
+/** @deprecated Use FormBuilder instead. */
 export { default as FormSection } from './FormSection.vue'
 export { default as FormActions } from './FormActions.vue'
+/** @deprecated Use FormBuilder instead. */
 export { default as FormFieldRenderer } from './FormFieldRenderer.vue'
 
 // Experiment data display components

package/src/components/internal/FormFieldRendererInternal.vue

@@ -0,0 +1,50 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import type { FormFieldSchema } from '../../types/form-builder'
+import type { UseFormReturn } from '../../composables/useForm'
+import { getFieldRegistryEntry } from '../../composables/formBuilderRegistry'
+import FormField from '../FormField.vue'
+
+interface Props {
+  field: FormFieldSchema
+  resolvedProps: Record<string, unknown>
+  form: UseFormReturn<Record<string, unknown>>
+}
+
+const props = defineProps<Props>()
+
+const entry = computed(() => getFieldRegistryEntry(props.field.type))
+
+const errorMessage = computed(() => {
+  const name = props.field.name
+  return props.form.touched[name] ? props.form.errors[name] : null
+})
+
+function handleUpload(files: File[]) {
+  props.form.setFieldValue(props.field.name, files)
+}
+</script>
+
+<template>
+  <FormField
+    :label="field.label"
+    :error="errorMessage ?? undefined"
+    :hint="field.hint"
+    :required="!!field.validation?.required"
+    :html-for="field.name"
+  >
+    <slot :name="`field:${field.name}`" :field="field" :form="form" :field-props="form.getFieldProps(field.name)">
+      <component
+        :is="entry.component"
+        v-if="entry.vModel"
+        v-bind="resolvedProps"
+      />
+      <component
+        :is="entry.component"
+        v-else
+        v-bind="resolvedProps"
+        @upload="handleUpload"
+      />
+    </slot>
+  </FormField>
+</template>

package/src/components/internal/FormSectionRenderer.vue

@@ -0,0 +1,78 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import type { FormSectionSchema, UseFormBuilderReturn } from '../../types/form-builder'
+import CollapsibleCard from '../CollapsibleCard.vue'
+import FormFieldRendererInternal from './FormFieldRendererInternal.vue'
+
+interface Props {
+  section: FormSectionSchema
+  builder: UseFormBuilderReturn<Record<string, unknown>>
+}
+
+const props = defineProps<Props>()
+
+const visibleFields = computed(() =>
+  props.section.fields.filter((f) => props.builder.isFieldVisible(f.name)),
+)
+
+const gridStyle = computed(() => ({
+  gridTemplateColumns: `repeat(${props.section.columns ?? 1}, 1fr)`,
+}))
+</script>
+
+<template>
+  <div v-if="visibleFields.length > 0" class="mint-form-section">
+    <slot :name="`section:${section.id}`" :section="section" :form="builder.form">
+      <CollapsibleCard
+        v-if="section.collapsible"
+        :title="section.title"
+        :subtitle="section.description"
+        :default-open="section.defaultOpen ?? true"
+      >
+        <div class="mint-form-section__grid" :style="gridStyle">
+          <div
+            v-for="field in visibleFields"
+            :key="field.name"
+            :style="field.colSpan ? { gridColumn: `span ${field.colSpan}` } : undefined"
+          >
+            <slot :name="`field:${field.name}`" :field="field" :form="builder.form" :field-props="builder.form.getFieldProps(field.name)">
+              <FormFieldRendererInternal
+                :field="field"
+                :resolved-props="builder.getResolvedFieldProps(field)"
+                :form="builder.form"
+              />
+            </slot>
+          </div>
+        </div>
+      </CollapsibleCard>
+
+      <div v-else class="mint-form-section--static">
+        <div v-if="section.title || section.description" class="mint-form-section__header">
+          <h3 v-if="section.title" class="mint-form-section__title">{{ section.title }}</h3>
+          <p v-if="section.description" class="mint-form-section__description">{{ section.description }}</p>
+        </div>
+        <div class="mint-form-section__grid" :style="gridStyle">
+          <div
+            v-for="field in visibleFields"
+            :key="field.name"
+            :style="field.colSpan ? { gridColumn: `span ${field.colSpan}` } : undefined"
+          >
+            <slot :name="`field:${field.name}`" :field="field" :form="builder.form" :field-props="builder.form.getFieldProps(field.name)">
+              <FormFieldRendererInternal
+                :field="field"
+                :resolved-props="builder.getResolvedFieldProps(field)"
+                :form="builder.form"
+              />
+            </slot>
+          </div>
+        </div>
+      </div>
+    </slot>
+
+    <slot :name="`section:${section.id}:after`" :form="builder.form" />
+  </div>
+</template>
+
+<style>
+@import '../../styles/components/form-builder.css';
+</style>

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 {
@@ -134,7 +158,195 @@ export {
   type UseExperimentSaveOptions,
   type UseExperimentSaveReturn,
 } from './useExperimentSave'
+export {
+  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'
+/** @deprecated Use generated plugin clients from `mint sdk generate` instead. */
 export {
   usePluginApi,
   type UsePluginApiOptions,
 } from './usePluginApi'
+export {
+  controlsToFormSchema,
+  controlsToSectionFormSchema,
+  controlsToSectionFormSchemas,
+  controlsToSidebarPanels,
+  controlsToSettingsSchema,
+  controlsToTopBarSettingsConfig,
+  controlsToTopBarTabs,
+  controlsToViewIds,
+  controlsToViewItems,
+  controlValuesToComponentProps,
+  defineControlModel,
+  defineDoseDesignControlModel,
+  defineDoseCalculatorControlProps,
+  defineControls,
+  defineWellPlateControlProps,
+  defineWellPlateDoseControlProps,
+  getDefaultControlView,
+  getControlDefaults,
+  useControlSchema,
+  useControlWorkspace,
+  type ControlDefinition,
+  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 ControlWorkspaceAppTopBarTabsBinding,
+  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,
+  toBioTemplateComponentProps,
+  toBioTemplateComponentPropsByComponent,
+  toBioTemplateComponentPropsById,
+  useBioTemplateComponents,
+  type BioTemplateComponentBinding,
+  type BioTemplateComponentPropsByComponent,
+  type BioTemplateComponentPropsBinding,
+  type BioTemplateComponentPropsById,
+  type BioTemplateComponentPropsLookupOptions,
+  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,
+  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/useBioTemplateComponents.ts

@@ -0,0 +1,93 @@
+import {
+  getBioTemplateComponentBindings,
+  getBioTemplateComponentProps as getTemplateComponentProps,
+  toBioTemplateComponentImports,
+  toBioTemplateComponentProps,
+  toBioTemplateComponentPropsByComponent as toTemplateComponentPropsByComponent,
+  toBioTemplateComponentPropsById,
+  toBioTemplateComponentSnippets,
+  toBioTemplateComponentUsage,
+  type BioTemplateComponentBinding,
+  type BioTemplateComponentImport,
+  type BioTemplateComponentPropsByComponent,
+  type BioTemplateComponentPropsBinding,
+  type BioTemplateComponentPropsById,
+  type BioTemplateComponentPropsLookupOptions,
+  type BioTemplateComponentSnippet,
+  type BioTemplateComponentTarget,
+  type BioTemplateComponentUsage,
+} from '../templates/componentBindings'
+import type {
+  BioTemplateEnvelope,
+  TemplateCollectionEnvelope,
+} from '../templates/types'
+
+export {
+  getBioTemplateComponentBindings,
+  toBioTemplateComponentImports,
+  toBioTemplateComponentProps,
+  toBioTemplateComponentPropsById,
+  toBioTemplateComponentSnippets,
+  toBioTemplateComponentUsage,
+}
+
+export type {
+  BioTemplateComponentBinding,
+  BioTemplateComponentImport,
+  BioTemplateComponentPropsByComponent,
+  BioTemplateComponentPropsBinding,
+  BioTemplateComponentPropsById,
+  BioTemplateComponentPropsLookupOptions,
+  BioTemplateComponentSnippet,
+  BioTemplateComponentTarget,
+  BioTemplateComponentUsage,
+}
+
+export interface UseBioTemplateComponentsReturn {
+  bindings: BioTemplateComponentBinding[]
+  imports: BioTemplateComponentImport[]
+  componentProps: BioTemplateComponentPropsBinding[]
+  componentPropsById: BioTemplateComponentPropsById
+  componentPropsByComponent: BioTemplateComponentPropsByComponent
+  snippets: BioTemplateComponentSnippet[]
+  usage: BioTemplateComponentUsage | null
+  getComponentProps: (
+    component: string,
+    options?: BioTemplateComponentPropsLookupOptions,
+  ) => Record<string, unknown> | undefined
+}
+
+/** Return component props grouped by SDK component name for direct WellPlate/DoseCalculator binding. */
+export function toBioTemplateComponentPropsByComponent(
+  target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope,
+): BioTemplateComponentPropsByComponent {
+  return toTemplateComponentPropsByComponent(target)
+}
+
+/** Return the first props object for an SDK component, optionally restricted by template id or binding id. */
+export function getBioTemplateComponentProps(
+  target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope,
+  component: string,
+  options: BioTemplateComponentPropsLookupOptions = {},
+): Record<string, unknown> | undefined {
+  return getTemplateComponentProps(target, component, options)
+}
+
+/** Map built-in biology templates to SDK components such as WellPlate, DataFrame, DoseCalculator, and PlateMapEditor. */
+export function useBioTemplateComponents(
+  target: BioTemplateComponentTarget
+): UseBioTemplateComponentsReturn {
+  return {
+    bindings: getBioTemplateComponentBindings(target),
+    imports: toBioTemplateComponentImports(target),
+    componentProps: typeof target === 'string' ? [] : toBioTemplateComponentProps(target),
+    componentPropsById: typeof target === 'string' ? {} : toBioTemplateComponentPropsById(target),
+    componentPropsByComponent: typeof target === 'string' ? {} : toBioTemplateComponentPropsByComponent(target),
+    snippets: typeof target === 'string' ? [] : toBioTemplateComponentSnippets(target),
+    usage: typeof target === 'string' ? null : toBioTemplateComponentUsage(target),
+    getComponentProps: (component, options) =>
+      typeof target === 'string'
+        ? undefined
+        : getBioTemplateComponentProps(target, component, options),
+  }
+}

package/src/composables/useBioTemplateControls.ts

@@ -0,0 +1,41 @@
+import {
+  createBioTemplateControlToolkit,
+  getBioTemplateControlSchema,
+  requireBioTemplateControlSchema,
+  type BioTemplateControlSchema,
+  type BioTemplateControlTarget,
+} from '../templates/controlSchemas'
+import type {
+  ControlSchemaOptions,
+  ControlWorkspaceOptions,
+  UseControlSchemaReturn,
+} from './useControlSchema'
+
+export {
+  getBioTemplateControlSchema,
+  requireBioTemplateControlSchema,
+}
+
+export type {
+  BioTemplateControlSchema,
+  BioTemplateControlTarget,
+}
+
+/** Build FormBuilder schema, AppSidebar panels, and defaults for a built-in biology template or preset. */
+export function useBioTemplateControls(
+  target: BioTemplateControlTarget,
+  options: ControlWorkspaceOptions = {},
+): UseControlSchemaReturn<BioTemplateControlSchema> {
+  const { initialValues, topBarSettings: _topBarSettings, ...schemaOptions } = options
+  const controls = createBioTemplateControlToolkit(target, schemaOptions as ControlSchemaOptions)
+
+  if (initialValues === undefined) return controls
+
+  return {
+    ...controls,
+    initialValues: {
+      ...controls.initialValues,
+      ...initialValues,
+    },
+  }
+}