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

package/src/composables/useBioTemplatePackWorkspace.ts

@@ -0,0 +1,181 @@
+import {
+  computed,
+  effectScope,
+  getCurrentScope,
+  onScopeDispose,
+  shallowRef,
+  watch,
+  type ComputedRef,
+  type EffectScope,
+  type Ref,
+} from 'vue'
+import {
+  createBioTemplatePackCollection,
+  getBioTemplatePackInfo,
+  type BioTemplatePackEntry,
+  type TemplateCollectionEnvelope,
+  type TemplatePackId,
+} from '../templates'
+import {
+  useTemplateCollection,
+  type UseTemplateCollectionOptions,
+  type UseTemplateCollectionReturn,
+} from './useTemplateCollection'
+import {
+  useBioTemplateWorkspace,
+  type BioTemplateRendererBinding,
+  type BioTemplateWorkspaceBindings,
+  type UseBioTemplateWorkspaceReturn,
+} from './useBioTemplateWorkspace'
+import type {
+  BioTemplateComponentBinding,
+  BioTemplateComponentImport,
+  BioTemplateComponentPropsByComponent,
+  BioTemplateComponentPropsBinding,
+  BioTemplateComponentPropsById,
+  BioTemplateComponentSnippet,
+  BioTemplateComponentUsage,
+} from './useBioTemplateComponents'
+
+export type UseBioTemplatePackWorkspaceOptions = UseTemplateCollectionOptions
+
+export interface UseBioTemplatePackWorkspaceReturn {
+  packId: TemplatePackId
+  pack: BioTemplatePackEntry
+  collection: Ref<TemplateCollectionEnvelope>
+  templates: UseTemplateCollectionReturn['templates']
+  templateIds: UseTemplateCollectionReturn['templateIds']
+  currentExperimentId: UseTemplateCollectionReturn['currentExperimentId']
+  hasCurrentExperiment: UseTemplateCollectionReturn['hasCurrentExperiment']
+  loading: UseTemplateCollectionReturn['isLoading']
+  saving: UseTemplateCollectionReturn['isSaving']
+  error: UseTemplateCollectionReturn['error']
+  lastLoadedAt: UseTemplateCollectionReturn['lastLoadedAt']
+  lastSavedAt: UseTemplateCollectionReturn['lastSavedAt']
+  renderer: ComputedRef<BioTemplateRendererBinding>
+  workspace: ComputedRef<UseBioTemplateWorkspaceReturn>
+  form: ComputedRef<UseBioTemplateWorkspaceReturn['form']>
+  sidebar: ComputedRef<UseBioTemplateWorkspaceReturn['sidebar']>
+  topBar: ComputedRef<UseBioTemplateWorkspaceReturn['topBar']>
+  pillNav: ComputedRef<UseBioTemplateWorkspaceReturn['pillNav']>
+  topBarSettings: ComputedRef<UseBioTemplateWorkspaceReturn['topBarSettings']>
+  bindings: ComputedRef<BioTemplateWorkspaceBindings>
+  componentBindings: ComputedRef<BioTemplateComponentBinding[]>
+  componentImports: ComputedRef<BioTemplateComponentImport[]>
+  componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>
+  componentPropsById: ComputedRef<BioTemplateComponentPropsById>
+  componentPropsByComponent: ComputedRef<BioTemplateComponentPropsByComponent>
+  componentSnippets: ComputedRef<BioTemplateComponentSnippet[]>
+  componentUsage: ComputedRef<BioTemplateComponentUsage | null>
+  getComponentProps: UseBioTemplateWorkspaceReturn['getComponentProps']
+  applyCollection: (value: unknown, metadata?: Record<string, unknown>) => TemplateCollectionEnvelope
+  resetToDefaultCollection: () => TemplateCollectionEnvelope
+  save: UseTemplateCollectionReturn['save']
+  saveCurrent: UseTemplateCollectionReturn['saveCurrent']
+  load: UseTemplateCollectionReturn['load']
+  loadCurrent: UseTemplateCollectionReturn['loadCurrent']
+  requireCurrentExperimentId: UseTemplateCollectionReturn['requireCurrentExperimentId']
+}
+
+/** Create a complete workspace for a curated biology template pack from a single pack id. */
+export function useBioTemplatePackWorkspace(
+  packId: TemplatePackId | string,
+  options: UseBioTemplatePackWorkspaceOptions = {},
+): UseBioTemplatePackWorkspaceReturn {
+  const pack = getBioTemplatePackInfo(packId)
+  if (!pack) {
+    throw new Error(`Unknown template pack '${packId}'.`)
+  }
+  const resolvedPack = pack
+
+  const templateCollection = useTemplateCollection({
+    ...options,
+    initial: createDefaultCollection,
+  })
+  const collection = templateCollection.templateCollection
+  let workspaceScope: EffectScope | undefined
+
+  function createWorkspace(value: TemplateCollectionEnvelope): UseBioTemplateWorkspaceReturn {
+    workspaceScope?.stop()
+    workspaceScope = effectScope()
+    return workspaceScope.run(() => useBioTemplateWorkspace(value))!
+  }
+
+  const workspaceRef = shallowRef<UseBioTemplateWorkspaceReturn>(createWorkspace(collection.value))
+  const workspace = computed(() => workspaceRef.value)
+  const renderer = computed<BioTemplateRendererBinding>(() => ({ target: collection.value }))
+  const form = computed(() => workspace.value.form)
+  const sidebar = computed(() => workspace.value.sidebar)
+  const topBar = computed(() => workspace.value.topBar)
+  const pillNav = computed(() => workspace.value.pillNav)
+  const topBarSettings = computed(() => workspace.value.topBarSettings)
+  const bindings = computed(() => workspace.value.bindings)
+  const componentBindings = computed(() => workspace.value.componentBindings)
+  const componentImports = computed(() => workspace.value.componentImports)
+  const componentProps = computed(() => workspace.value.componentProps)
+  const componentPropsById = computed(() => workspace.value.componentPropsById)
+  const componentPropsByComponent = computed(() => workspace.value.componentPropsByComponent)
+  const componentSnippets = computed(() => workspace.value.componentSnippets)
+  const componentUsage = computed(() => workspace.value.componentUsage)
+
+  watch(collection, value => {
+    workspaceRef.value = createWorkspace(value)
+  })
+
+  if (getCurrentScope()) {
+    onScopeDispose(() => workspaceScope?.stop())
+  }
+
+  function createDefaultCollection(): TemplateCollectionEnvelope {
+    return createBioTemplatePackCollection(resolvedPack.name)
+  }
+
+  function applyCollection(
+    value: unknown,
+    metadata?: Record<string, unknown>,
+  ): TemplateCollectionEnvelope {
+    return templateCollection.apply(value, metadata)
+  }
+
+  function resetToDefaultCollection(): TemplateCollectionEnvelope {
+    return templateCollection.apply(createDefaultCollection())
+  }
+
+  return {
+    packId: resolvedPack.name,
+    pack: resolvedPack,
+    collection,
+    templates: templateCollection.templates,
+    templateIds: templateCollection.templateIds,
+    currentExperimentId: templateCollection.currentExperimentId,
+    hasCurrentExperiment: templateCollection.hasCurrentExperiment,
+    loading: templateCollection.isLoading,
+    saving: templateCollection.isSaving,
+    error: templateCollection.error,
+    lastLoadedAt: templateCollection.lastLoadedAt,
+    lastSavedAt: templateCollection.lastSavedAt,
+    renderer,
+    workspace,
+    form,
+    sidebar,
+    topBar,
+    pillNav,
+    topBarSettings,
+    bindings,
+    componentBindings,
+    componentImports,
+    componentProps,
+    componentPropsById,
+    componentPropsByComponent,
+    componentSnippets,
+    componentUsage,
+    getComponentProps: (component, options) => workspace.value.getComponentProps(component, options),
+    applyCollection,
+    resetToDefaultCollection,
+    save: templateCollection.save,
+    saveCurrent: templateCollection.saveCurrent,
+    load: templateCollection.load,
+    loadCurrent: templateCollection.loadCurrent,
+    requireCurrentExperimentId: templateCollection.requireCurrentExperimentId,
+  }
+}

package/src/composables/useBioTemplatePresetWorkspace.ts

@@ -0,0 +1,337 @@
+import {
+  computed,
+  reactive,
+  ref,
+  watch,
+  type ComputedRef,
+  type Ref,
+} from 'vue'
+import type { PillNavItem } from '../types'
+import {
+  createBioTemplatePresetCollectionFromControls,
+  getBioTemplatePresetInfo,
+  type BioTemplateControlValues,
+  type BioTemplatePresetEntry,
+  type TemplateCollectionEnvelope,
+  type TemplatePresetId,
+} from '../templates'
+import type {
+  ControlWorkspaceAppTopBarPillBinding,
+  ControlWorkspaceAppTopBarTabsBinding,
+  ControlWorkspaceOptions,
+  ControlWorkspaceFormBinding,
+  ControlWorkspacePillNavBinding,
+  ControlWorkspaceSidebarBinding,
+  ControlWorkspaceTopBarBinding,
+  ControlWorkspaceTopBarSettingsBinding,
+  UseControlSchemaReturn,
+} from './useControlSchema'
+import {
+  useTemplateCollection,
+  type UseTemplateCollectionOptions,
+  type UseTemplateCollectionReturn,
+} from './useTemplateCollection'
+import {
+  useBioTemplateWorkspace,
+  type BioTemplateRendererBinding,
+  type UseBioTemplateWorkspaceReturn,
+} from './useBioTemplateWorkspace'
+import type {
+  BioTemplateComponentBinding,
+  BioTemplateComponentImport,
+  BioTemplateComponentPropsByComponent,
+  BioTemplateComponentPropsBinding,
+  BioTemplateComponentPropsById,
+  BioTemplateComponentSnippet,
+  BioTemplateComponentUsage,
+} from './useBioTemplateComponents'
+import type {
+  BioTemplateControlSchema,
+} from './useBioTemplateControls'
+
+export interface UseBioTemplatePresetWorkspaceOptions extends UseTemplateCollectionOptions {
+  /** Optional schema-rendering options for the generated FormBuilder/AppSidebar controls. */
+  controlOptions?: ControlWorkspaceOptions
+  /** Initial control values for the generated preset. Merged over controlOptions.initialValues. */
+  initialValues?: BioTemplateControlValues
+}
+
+export interface UseBioTemplatePresetWorkspaceReturn {
+  presetId: TemplatePresetId
+  presetInfo: ComputedRef<BioTemplatePresetEntry | undefined>
+  presetLabel: ComputedRef<string>
+  collection: Ref<TemplateCollectionEnvelope>
+  templates: UseTemplateCollectionReturn['templates']
+  templateIds: UseTemplateCollectionReturn['templateIds']
+  currentExperimentId: UseTemplateCollectionReturn['currentExperimentId']
+  hasCurrentExperiment: UseTemplateCollectionReturn['hasCurrentExperiment']
+  saving: UseTemplateCollectionReturn['isSaving']
+  error: UseTemplateCollectionReturn['error']
+  lastSavedAt: UseTemplateCollectionReturn['lastSavedAt']
+  controls: UseControlSchemaReturn<BioTemplateControlSchema>
+  controlSchema: BioTemplateControlSchema
+  controlValues: Ref<BioTemplateControlValues>
+  controlViewIds: ComputedRef<string[]>
+  controlViewItems: ComputedRef<PillNavItem[]>
+  activeControlView: Ref<string>
+  form: ControlWorkspaceFormBinding
+  sidebar: ControlWorkspaceSidebarBinding
+  topBar: ControlWorkspaceTopBarBinding
+  pillNav: ControlWorkspacePillNavBinding
+  topBarSettings: ControlWorkspaceTopBarSettingsBinding
+  bindings: BioTemplatePresetWorkspaceBindings
+  renderer: ComputedRef<BioTemplateRendererBinding>
+  workspace: ComputedRef<UseBioTemplateWorkspaceReturn>
+  componentBindings: ComputedRef<BioTemplateComponentBinding[]>
+  componentImports: ComputedRef<BioTemplateComponentImport[]>
+  componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>
+  componentPropsById: ComputedRef<BioTemplateComponentPropsById>
+  componentPropsByComponent: ComputedRef<BioTemplateComponentPropsByComponent>
+  componentSnippets: ComputedRef<BioTemplateComponentSnippet[]>
+  componentUsage: ComputedRef<BioTemplateComponentUsage | null>
+  getComponentProps: UseBioTemplateWorkspaceReturn['getComponentProps']
+  setActiveControlView: (viewId: string) => void
+  setControlValues: (values: BioTemplateControlValues) => TemplateCollectionEnvelope
+  updateControlValues: (values: Partial<BioTemplateControlValues>) => TemplateCollectionEnvelope
+  applyCollection: (value: TemplateCollectionEnvelope) => TemplateCollectionEnvelope
+  resetToDefaultCollection: () => TemplateCollectionEnvelope
+  save: UseTemplateCollectionReturn['save']
+  saveCurrent: UseTemplateCollectionReturn['saveCurrent']
+}
+
+export interface BioTemplatePresetWorkspaceBindings {
+  renderer: ComputedRef<BioTemplateRendererBinding>
+  form: ControlWorkspaceFormBinding
+  sidebar: ControlWorkspaceSidebarBinding
+  topBar: ComputedRef<ControlWorkspaceAppTopBarPillBinding>
+  topBarTabs: ComputedRef<ControlWorkspaceAppTopBarTabsBinding>
+  topBarSettings: ControlWorkspaceTopBarSettingsBinding
+  pillNav: ControlWorkspacePillNavBinding
+  componentBindings: ComputedRef<BioTemplateComponentBinding[]>
+  componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>
+  componentPropsById: ComputedRef<BioTemplateComponentPropsById>
+  componentPropsByComponent: ComputedRef<BioTemplateComponentPropsByComponent>
+  componentSnippets: ComputedRef<BioTemplateComponentSnippet[]>
+  componentUsage: ComputedRef<BioTemplateComponentUsage | null>
+  getComponentProps: UseBioTemplateWorkspaceReturn['getComponentProps']
+}
+
+/** Create a complete editable WellPlate/DoseCalculator workspace for dose design from a built-in biology template preset with current-experiment save wiring. */
+export function useBioTemplatePresetWorkspace(
+  presetId: TemplatePresetId,
+  options: UseBioTemplatePresetWorkspaceOptions = {},
+): UseBioTemplatePresetWorkspaceReturn {
+  const { controlOptions, initialValues, ...collectionOptions } = options
+  const resolvedControlOptions = mergeInitialValues(controlOptions, initialValues)
+  const presetWorkspace = useBioTemplateWorkspace(presetId, resolvedControlOptions)
+  const presetInfo = computed(() => getBioTemplatePresetInfo(presetId))
+  const presetLabel = computed(() => presetInfo.value?.label ?? humanizePresetId(presetId))
+  const controls = presetWorkspace.controls
+  const controlValues = ref<BioTemplateControlValues>({ ...controls.initialValues })
+  const controlViewIds = computed(() => controls.viewIds)
+  const controlViewItems = computed(() => controls.viewItems)
+  const activeControlView = ref(controls.defaultView)
+  const templateCollection = useTemplateCollection({
+    ...collectionOptions,
+    initial: createDefaultCollection,
+  })
+  const collection = templateCollection.templateCollection
+  const workspace = computed(() => useBioTemplateWorkspace(collection.value, resolvedControlOptions))
+  const renderer = computed<BioTemplateRendererBinding>(() => ({ target: collection.value }))
+  const componentBindings = computed(() => workspace.value.componentBindings)
+  const componentImports = computed(() => workspace.value.componentImports)
+  const componentProps = computed(() => workspace.value.componentProps)
+  const componentPropsById = computed(() => workspace.value.componentPropsById)
+  const componentPropsByComponent = computed(() => workspace.value.componentPropsByComponent)
+  const componentSnippets = computed(() => workspace.value.componentSnippets)
+  const componentUsage = computed(() => workspace.value.componentUsage)
+  const form = reactive({
+    ...controls.form,
+    modelValue: controlValues.value,
+    'onUpdate:modelValue': setControlValues,
+  }) as ControlWorkspaceFormBinding
+  const sidebar = reactive({
+    ...controls.sidebar,
+    activeView: activeControlView.value,
+    modelValue: controlValues.value,
+    'onUpdate:modelValue': setControlValues,
+    values: controlValues.value,
+    'onUpdate:values': setControlValues,
+  }) as ControlWorkspaceSidebarBinding
+  const topBar = reactive({
+    tabs: controls.topBarTabs,
+    currentTabId: activeControlView.value,
+    onTabSelect: (tab: { id: string }) => setActiveControlView(tab.id),
+  }) as ControlWorkspaceTopBarBinding
+  const pillNav = reactive({
+    items: controls.viewItems,
+    currentItemId: activeControlView.value,
+    onSelect: (item: { id: string }) => setActiveControlView(item.id),
+  }) as ControlWorkspacePillNavBinding
+  const topBarSettings = reactive({
+    showSettings: true,
+    settingsConfig: {
+      ...controls.topBarSettingsConfig,
+      values: controlValues.value,
+    },
+    onSettingsValuesChange: setControlValues,
+  }) as ControlWorkspaceTopBarSettingsBinding
+  const topBarProps = computed<ControlWorkspaceAppTopBarPillBinding>(() => ({
+    pillNav: pillNav.items,
+    currentPillId: pillNav.currentItemId,
+    onPillSelect: pillNav.onSelect,
+    ...topBarSettings,
+  }))
+  const topBarTabsProps = computed<ControlWorkspaceAppTopBarTabsBinding>(() => ({
+    tabs: topBar.tabs,
+    currentTabId: topBar.currentTabId,
+    onTabSelect: topBar.onTabSelect,
+    ...topBarSettings,
+  }))
+
+  function getComponentProps(
+    component: string,
+    options?: Parameters<UseBioTemplateWorkspaceReturn['getComponentProps']>[1],
+  ) {
+    return workspace.value.getComponentProps(component, options)
+  }
+
+  const bindings: BioTemplatePresetWorkspaceBindings = {
+    renderer,
+    form,
+    sidebar,
+    topBar: topBarProps,
+    topBarTabs: topBarTabsProps,
+    topBarSettings,
+    pillNav,
+    componentBindings,
+    componentProps,
+    componentPropsById,
+    componentPropsByComponent,
+    componentSnippets,
+    componentUsage,
+    getComponentProps,
+  }
+
+  function createDefaultCollection(): TemplateCollectionEnvelope {
+    return createBioTemplatePresetCollectionFromControls(presetId, controls.initialValues)
+  }
+
+  watch(
+    controlValues,
+    (values) => {
+      syncControlValueBindings(values)
+      templateCollection.apply(createBioTemplatePresetCollectionFromControls(presetId, values))
+    },
+    { deep: true },
+  )
+
+  watch(activeControlView, (viewId) => {
+    sidebar.activeView = viewId
+    topBar.currentTabId = viewId
+    pillNav.currentItemId = viewId
+  }, { flush: 'sync' })
+  watch(() => sidebar.activeView, setActiveControlView, { flush: 'sync' })
+  watch(() => topBar.currentTabId, setActiveControlView, { flush: 'sync' })
+  watch(() => pillNav.currentItemId, setActiveControlView, { flush: 'sync' })
+
+  function applyCollection(value: TemplateCollectionEnvelope): TemplateCollectionEnvelope {
+    return templateCollection.apply(value)
+  }
+
+  function setActiveControlView(viewId: string): void {
+    if (!controlViewIds.value.includes(viewId)) return
+    activeControlView.value = viewId
+  }
+
+  function setControlValues(values: BioTemplateControlValues): TemplateCollectionEnvelope {
+    const nextValues = { ...values }
+    controlValues.value = nextValues
+    syncControlValueBindings(nextValues)
+    return templateCollection.apply(createBioTemplatePresetCollectionFromControls(presetId, nextValues))
+  }
+
+  function updateControlValues(values: Partial<BioTemplateControlValues>): TemplateCollectionEnvelope {
+    return setControlValues({
+      ...controlValues.value,
+      ...values,
+    })
+  }
+
+  function resetToDefaultCollection(): TemplateCollectionEnvelope {
+    return setControlValues({ ...controls.initialValues })
+  }
+
+  function syncControlValueBindings(values: BioTemplateControlValues): void {
+    form.modelValue = values
+    sidebar.modelValue = values
+    sidebar.values = values
+    topBarSettings.settingsConfig = {
+      ...topBarSettings.settingsConfig,
+      values,
+    }
+  }
+
+  return {
+    presetId,
+    presetInfo,
+    presetLabel,
+    collection,
+    templates: templateCollection.templates,
+    templateIds: templateCollection.templateIds,
+    currentExperimentId: templateCollection.currentExperimentId,
+    hasCurrentExperiment: templateCollection.hasCurrentExperiment,
+    saving: templateCollection.isSaving,
+    error: templateCollection.error,
+    lastSavedAt: templateCollection.lastSavedAt,
+    controls,
+    controlSchema: controls.controls,
+    controlValues,
+    controlViewIds,
+    controlViewItems,
+    activeControlView,
+    form,
+    sidebar,
+    topBar,
+    pillNav,
+    topBarSettings,
+    bindings,
+    renderer,
+    workspace,
+    componentBindings,
+    componentImports,
+    componentProps,
+    componentPropsById,
+    componentPropsByComponent,
+    componentSnippets,
+    componentUsage,
+    getComponentProps,
+    setActiveControlView,
+    setControlValues,
+    updateControlValues,
+    applyCollection,
+    resetToDefaultCollection,
+    save: templateCollection.save,
+    saveCurrent: templateCollection.saveCurrent,
+  }
+}
+
+function humanizePresetId(value: string): string {
+  return value
+    .replace(/[-_]+/g, ' ')
+    .replace(/\b\w/g, match => match.toUpperCase())
+}
+
+function mergeInitialValues(
+  controlOptions: ControlWorkspaceOptions | undefined,
+  initialValues: BioTemplateControlValues | undefined,
+): ControlWorkspaceOptions | undefined {
+  if (initialValues === undefined) return controlOptions
+  return {
+    ...(controlOptions ?? {}),
+    initialValues: {
+      ...(controlOptions?.initialValues ?? {}),
+      ...initialValues,
+    },
+  }
+}

package/src/composables/useBioTemplateWorkspace.ts

@@ -0,0 +1,139 @@
+import type {
+  BioTemplateEnvelope,
+  TemplateCollectionEnvelope,
+} from '../templates'
+import type {
+  ControlWorkspaceFormBinding,
+  ControlWorkspaceOptions,
+  ControlWorkspacePillNavBinding,
+  ControlWorkspaceSidebarBinding,
+  ControlWorkspaceTopBarBinding,
+  ControlWorkspaceTopBarSettingsBinding,
+  UseControlSchemaReturn,
+  UseControlWorkspaceReturn,
+} from './useControlSchema'
+import {
+  useControlWorkspace,
+} from './useControlSchema'
+import {
+  useBioTemplateControls,
+  type BioTemplateControlSchema,
+  type BioTemplateControlTarget,
+} from './useBioTemplateControls'
+import {
+  useBioTemplateComponents,
+  type BioTemplateComponentBinding,
+  type BioTemplateComponentImport,
+  type BioTemplateComponentPropsByComponent,
+  type BioTemplateComponentPropsBinding,
+  type BioTemplateComponentPropsById,
+  type BioTemplateComponentSnippet,
+  type BioTemplateComponentUsage,
+  type UseBioTemplateComponentsReturn,
+} from './useBioTemplateComponents'
+
+export type BioTemplateWorkspaceTarget = BioTemplateControlTarget
+
+export interface BioTemplateRendererBinding {
+  target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope
+}
+
+export interface BioTemplateWorkspaceBindings {
+  renderer: BioTemplateRendererBinding | null
+  form: ControlWorkspaceFormBinding
+  sidebar: ControlWorkspaceSidebarBinding
+  topBar: UseControlWorkspaceReturn<BioTemplateControlSchema>['bindings']['topBar']
+  topBarTabs: UseControlWorkspaceReturn<BioTemplateControlSchema>['bindings']['topBarTabs']
+  topBarSettings: ControlWorkspaceTopBarSettingsBinding
+  pillNav: ControlWorkspacePillNavBinding
+  componentBindings: BioTemplateComponentBinding[]
+  componentProps: BioTemplateComponentPropsBinding[]
+  componentPropsById: BioTemplateComponentPropsById
+  componentPropsByComponent: BioTemplateComponentPropsByComponent
+  componentSnippets: BioTemplateComponentSnippet[]
+  componentUsage: BioTemplateComponentUsage | null
+  getComponentProps: UseBioTemplateComponentsReturn['getComponentProps']
+}
+
+export interface UseBioTemplateWorkspaceReturn {
+  target: BioTemplateWorkspaceTarget
+  controls: UseControlSchemaReturn<BioTemplateControlSchema>
+  workspace: UseControlWorkspaceReturn<BioTemplateControlSchema>
+  controlSchema: BioTemplateControlSchema
+  components: UseBioTemplateComponentsReturn
+  values: UseControlWorkspaceReturn<BioTemplateControlSchema>['values']
+  activeView: UseControlWorkspaceReturn<BioTemplateControlSchema>['activeView']
+  form: ControlWorkspaceFormBinding
+  sidebar: ControlWorkspaceSidebarBinding
+  topBar: ControlWorkspaceTopBarBinding
+  pillNav: ControlWorkspacePillNavBinding
+  topBarSettings: ControlWorkspaceTopBarSettingsBinding
+  bindings: BioTemplateWorkspaceBindings
+  renderer: BioTemplateRendererBinding | null
+  componentBindings: BioTemplateComponentBinding[]
+  componentImports: BioTemplateComponentImport[]
+  componentProps: BioTemplateComponentPropsBinding[]
+  componentPropsById: BioTemplateComponentPropsById
+  componentPropsByComponent: BioTemplateComponentPropsByComponent
+  componentSnippets: BioTemplateComponentSnippet[]
+  componentUsage: BioTemplateComponentUsage | null
+  getComponentProps: UseBioTemplateComponentsReturn['getComponentProps']
+}
+
+/** One-stop wiring for BioTemplateRenderer, FormBuilder, AppSidebar, and template-aware SDK components. */
+export function useBioTemplateWorkspace(
+  target: BioTemplateWorkspaceTarget,
+  options: ControlWorkspaceOptions = {}
+): UseBioTemplateWorkspaceReturn {
+  const controls = useBioTemplateControls(target, options)
+  const workspace = useControlWorkspace(controls.controls, options)
+  const components = useBioTemplateComponents(target)
+  const renderer = isTemplateObjectTarget(target) ? { target } : null
+  const bindings: BioTemplateWorkspaceBindings = {
+    renderer,
+    form: workspace.bindings.form,
+    sidebar: workspace.bindings.sidebar,
+    topBar: workspace.bindings.topBar,
+    topBarTabs: workspace.bindings.topBarTabs,
+    topBarSettings: workspace.bindings.topBarSettings,
+    pillNav: workspace.bindings.pillNav,
+    componentBindings: components.bindings,
+    componentProps: components.componentProps,
+    componentPropsById: components.componentPropsById,
+    componentPropsByComponent: components.componentPropsByComponent,
+    componentSnippets: components.snippets,
+    componentUsage: components.usage,
+    getComponentProps: components.getComponentProps,
+  }
+
+  return {
+    target,
+    controls,
+    workspace,
+    controlSchema: controls.controls,
+    components,
+    values: workspace.values,
+    activeView: workspace.activeView,
+    form: workspace.form,
+    sidebar: workspace.sidebar,
+    topBar: workspace.topBar,
+    pillNav: workspace.pillNav,
+    topBarSettings: workspace.topBarSettings,
+    bindings,
+    renderer,
+    componentBindings: components.bindings,
+    componentImports: components.imports,
+    componentProps: components.componentProps,
+    componentPropsById: components.componentPropsById,
+    componentPropsByComponent: components.componentPropsByComponent,
+    componentSnippets: components.snippets,
+    componentUsage: components.usage,
+    getComponentProps: components.getComponentProps,
+  }
+}
+
+function isTemplateObjectTarget(
+  target: BioTemplateWorkspaceTarget
+): target is BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope {
+  return typeof target !== 'string'
+}