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

package/dist/composables/experiment-utils.d.ts

@@ -1,8 +1,16 @@
 import { DatePreset, ExperimentStatus, SelectOption, PillVariant } from '../types';
+interface ExperimentCodeSource {
+    id?: number | null;
+    experiment_code?: string | null;
+}
 export declare function formatExperimentDate(dateStr: string): string;
 export declare function datePresetToISO(preset: DatePreset): string;
 export declare const EXPERIMENT_STATUS_OPTIONS: SelectOption<string>[];
 export declare const EXPERIMENT_STATUS_VARIANT_MAP: Record<ExperimentStatus, PillVariant>;
 export declare const EXPERIMENT_STATUS_LABELS: Record<ExperimentStatus, string>;
+export declare function formatExperimentStatus(status?: ExperimentStatus | string | null): string;
+export declare function getExperimentStatusVariant(status?: ExperimentStatus | string | null): PillVariant;
+export declare function resolveExperimentCode(experiment: ExperimentCodeSource): string | undefined;
 export declare const DATE_PRESET_OPTIONS: SelectOption<string>[];
 export declare const SORT_OPTIONS: SelectOption<string>[];
+export {};

package/dist/composables/index.d.ts

@@ -22,10 +22,10 @@ export { useAutoGroup, DEFAULT_COLORS, extractSamplesFromDesignData } from './us
 export { useReagentSeries, generateDilutionSeries, DEFAULT_PRESETS, DEFAULT_UNITS, type LevelEntry, type DilutionPreset, type UseReagentSeriesReturn, } from './useReagentSeries';
 export { usePluginConfig, type UsePluginConfigReturn } from './usePluginConfig';
 export { useExperimentSelector, type UseExperimentSelectorOptions, type UseExperimentSelectorReturn, } from './useExperimentSelector';
-export { formatExperimentDate, datePresetToISO, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, EXPERIMENT_STATUS_LABELS, DATE_PRESET_OPTIONS, SORT_OPTIONS, } from './experiment-utils';
+export { formatExperimentDate, formatExperimentStatus, getExperimentStatusVariant, resolveExperimentCode, datePresetToISO, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, EXPERIMENT_STATUS_LABELS, DATE_PRESET_OPTIONS, SORT_OPTIONS, } from './experiment-utils';
 export { useExperimentData, type UseExperimentDataOptions, type UseExperimentDataReturn, } from './useExperimentData';
 export { getFieldRegistryEntry, getTypeDefault, type RegistryEntry, } from './formBuilderRegistry';
-export { useAppExperiment, APP_EXPERIMENT_KEY, type UseAppExperimentOptions, type UseAppExperimentReturn, type AppExperimentState, } from './useAppExperiment';
+export { useAppExperiment, APP_EXPERIMENT_KEY, type AppExperimentRecord, type AppExperimentSource, type UseAppExperimentOptions, type UseAppExperimentReturn, type AppExperimentState, type AppExperimentPopoverBinding, type AppExperimentSelectorModalBinding, } from './useAppExperiment';
 export { useExperimentSave, 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';
@@ -36,12 +36,10 @@ export { useSampleGroups, type DisplaySampleSubGroup, type SampleGroupSource, ty
 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 { controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSidebarPanels, controlsToSettingsSchema, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, defineControlComponentBindings, defineControlModel, defineDoseDesignControlModel, defineDoseCalculatorControlProps, defineControls, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, getDefaultControlView, getControlDefaults, useControlSchema, useControlWorkspace, type ControlDefinition, type ControlComponentBinding, type ControlComponentBindingConfig, type ControlComponentBindingRecordConfig, type ControlComponentBindingsById, type ControlComponentBindingsConfig, 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 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 { getBioTemplateComponentProps, getBioTemplateComponentBindings, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, useBioTemplateComponents, type BioTemplateComponentBinding, type BioTemplateComponentBindingsById, type BioTemplateComponentPropsByComponent, type BioTemplateComponentPropsBinding, type BioTemplateComponentPropsById, type BioTemplateComponentPropsLookupOptions, type BioTemplateResolvedComponentBinding, 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';
+export { buildPluginEndpointUrl, createPluginClient, getPluginPageSelectorItems, 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/dist/composables/index.js

@@ -1,4 +1,4 @@
-import { $n as generateTimeSlots, Cn as getControlDefaults, Dn as useControlWorkspace, En as useControlSchema, Fn as useSequenceUtils, Gn as compareTime, Jn as findNearestTimeSlotIndex, Kn as durationMinutes, Ln as ATOMIC_WEIGHTS, Mn as useConcentrationUnits, On as getFieldRegistryEntry, Qn as fromMinutes, Rn as useChemicalFormula, Sn as defineWellPlateDoseControlProps, Wn as addMinutes, Xn as formatTime, Yn as formatDuration, Zn as formatTimeSlot, _n as defineControlModel, ar as useTimeUtils, bn as defineDoseDesignControlModel, cn as controlsToFormSchema, dn as controlsToSettingsSchema, dr as useEventListener, er as isTimeInRange, fn as controlsToSidebarPanels, g as toBioTemplateComponentPropsById, gn as controlsToViewItems, hn as controlsToViewIds, ir as toMinutes, kn as getTypeDefault, l as requireBioTemplateControlSchema, ln as controlsToSectionFormSchema, lr as useListSelection, m as toBioTemplateComponentProps, mn as controlsToTopBarTabs, nr as rangesOverlap, o as getBioTemplateControlSchema, pn as controlsToTopBarSettingsConfig, qn as findAvailableSlots, rr as snapToSlot, sn as controlValuesToComponentProps, tr as parseTime, u as getBioTemplateComponentBindings, un as controlsToSectionFormSchemas, ur as useSelectionLimit, vn as defineControls, wn as getDefaultControlView, xn as defineWellPlateControlProps, yn as defineDoseCalculatorControlProps } from "../templates-50NPjaxL.js";
-import { $ as normalizeSearchQuery, A as useAutoGroup, B as EXPERIMENT_STATUS_VARIANT_MAP, C as useSampleGroups, D as DEFAULT_COLORS, F as usePlatformContext, G as useDebouncedWatch, H as datePresetToISO, I as useExperimentSelector, J as useFormBuilder, K as useApi, L as DATE_PRESET_OPTIONS, M as useDoseCalculator, N as APP_EXPERIMENT_KEY, O as extractSamplesFromDesignData, P as useAppExperiment, Q as candidateMatchesSearch, R as EXPERIMENT_STATUS_LABELS, S as useExpansionSet, U as formatExperimentDate, V as SORT_OPTIONS, W as useRequestSyncState, X as useTheme, Y as useForm, Z as useToast, _ as useTemplateCollection, a as DEFAULT_UNITS, c as useGroupAssignment, d as useBioTemplatePackWorkspace, et as useTextSearch, f as useBioTemplateWorkspace, g as useBioTemplateControls, h as useBioTemplateComponents, i as DEFAULT_PRESETS, j as useWellPlateEditor, l as useRackEditor, m as toBioTemplateComponentPropsByComponent, n as useExperimentData, nt as useSortedItems, o as generateDilutionSeries, p as getBioTemplateComponentProps, q as evaluateCondition, r as useProtocolTemplates, s as useReagentSeries, t as useScheduleDrag, tt as compareSortValues, u as useBioTemplatePresetWorkspace, v as useExperimentSave, z as EXPERIMENT_STATUS_OPTIONS } from "../useScheduleDrag-D4oWdh41.js";
-import { a as usePluginClient, c as usePluginConfig, d as usePasskey, f as useAuth, i as useCurrentExperiment, l as useAsync, n as createPluginClient, o as usePluginSettings, r as resolvePluginBaseUrl, s as usePluginApi, t as buildPluginEndpointUrl, u as useAsyncBatch } from "../composables-C3dpXQN5.js";
-export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToTopBarTabs, controlsToViewIds, controlsToViewItems, createPluginClient, datePresetToISO, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseControlProps, durationMinutes, evaluateCondition, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getFieldRegistryEntry, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseTime, rangesOverlap, requireBioTemplateControlSchema, resolvePluginBaseUrl, snapToSlot, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSave, useExperimentSelector, useForm, useFormBuilder, useGroupAssignment, useListSelection, usePasskey, usePlatformContext, usePluginApi, usePluginClient, usePluginConfig, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPlateEditor };
+import { $n as findNearestTimeSlotIndex, Bn as useSequenceUtils, Cn as defineDoseCalculatorControlProps, Dn as defineWellPlateDoseControlProps, En as defineWellPlateDoseComponentBindings, Hn as ATOMIC_WEIGHTS, Ln as useConcentrationUnits, Mn as useControlWorkspace, Nn as getFieldRegistryEntry, On as getControlDefaults, Pn as getTypeDefault, Qn as findAvailableSlots, Sn as defineControls, Tn as defineWellPlateControlProps, Un as useChemicalFormula, Xn as compareTime, Yn as addMinutes, Zn as durationMinutes, _n as controlsToTopBarSettingsConfig, ar as isTimeInRange, bn as defineControlComponentBindings, cr as snapToSlot, dn as controlValuesToComponentProps, er as formatDuration, fn as controlsToFormSchema, g as toBioTemplateComponentProps, gn as controlsToSidebarPanels, gr as useEventListener, hn as controlsToSettingsSchema, hr as useSelectionLimit, ir as generateTimeSlots, jn as useControlSchema, kn as getDefaultControlView, l as requireBioTemplateControlSchema, ln as controlValuesToComponentBindings, lr as toMinutes, m as toBioTemplateComponentBindingsById, mn as controlsToSectionFormSchemas, mr as useListSelection, nr as formatTimeSlot, o as getBioTemplateControlSchema, or as parseTime, p as toBioTemplateComponentBindings, pn as controlsToSectionFormSchema, rr as fromMinutes, sr as rangesOverlap, tr as formatTime, u as getBioTemplateComponentBindings, un as controlValuesToComponentBindingsById, ur as useTimeUtils, v as toBioTemplateComponentPropsById, vn as controlsToViewIds, wn as defineDoseDesignControlModel, xn as defineControlModel, yn as controlsToViewItems } from "../templates-B5jmTWuk.js";
+import { $ as useTheme, A as useAutoGroup, B as DATE_PRESET_OPTIONS, C as useSampleGroups, D as DEFAULT_COLORS, F as usePlatformContext, G as datePresetToISO, H as EXPERIMENT_STATUS_OPTIONS, I as useExperimentSelector, J as getExperimentStatusVariant, K as formatExperimentDate, L as useRequestSyncState, M as useDoseCalculator, N as APP_EXPERIMENT_KEY, O as extractSamplesFromDesignData, P as useAppExperiment, Q as useForm, R as useDebouncedWatch, S as useExpansionSet, U as EXPERIMENT_STATUS_VARIANT_MAP, V as EXPERIMENT_STATUS_LABELS, W as SORT_OPTIONS, X as evaluateCondition, Y as resolveExperimentCode, Z as useFormBuilder, _ as useTemplateCollection, a as DEFAULT_UNITS, at as useSortedItems, c as useGroupAssignment, d as useBioTemplatePackWorkspace, et as useToast, f as useBioTemplateWorkspace, g as useBioTemplateControls, h as useBioTemplateComponents, i as DEFAULT_PRESETS, it as compareSortValues, j as useWellPlateEditor, l as useRackEditor, m as toBioTemplateComponentPropsByComponent, n as useExperimentData, nt as normalizeSearchQuery, o as generateDilutionSeries, p as getBioTemplateComponentProps, q as formatExperimentStatus, r as useProtocolTemplates, rt as useTextSearch, s as useReagentSeries, t as useScheduleDrag, tt as candidateMatchesSearch, u as useBioTemplatePresetWorkspace, v as useExperimentSave, z as useApi } from "../useScheduleDrag-BgzpQT53.js";
+import { a as useCurrentExperiment, c as usePluginConfig, d as usePasskey, f as useAuth, i as resolvePluginBaseUrl, l as useAsync, n as createPluginClient, o as usePluginClient, r as getPluginPageSelectorItems, s as usePluginSettings, t as buildPluginEndpointUrl, u as useAsyncBatch } from "../composables-CHsME9H1.js";
+export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, createPluginClient, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, durationMinutes, evaluateCondition, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseTime, rangesOverlap, requireBioTemplateControlSchema, resolveExperimentCode, resolvePluginBaseUrl, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSave, useExperimentSelector, useForm, useFormBuilder, useGroupAssignment, useListSelection, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPlateEditor };

package/dist/composables/useAppExperiment.d.ts

@@ -1,18 +1,45 @@
 import { Ref, ComputedRef, InjectionKey } from 'vue';
 import { ExperimentSummary, ExperimentStatus } from '../types';
+export type AppExperimentRecord = Pick<ExperimentSummary, 'id' | 'name' | 'status' | 'experiment_code'>;
+export type AppExperimentSource = AppExperimentRecord | null | undefined | Ref<AppExperimentRecord | null | undefined> | ComputedRef<AppExperimentRecord | null | undefined> | (() => AppExperimentRecord | null | undefined);
 export interface UseAppExperimentOptions {
+    /** Current experiment source to mirror into the app shell. Accepts a value, ref, computed, or getter. */
+    experiment?: AppExperimentSource;
     onSelect?: (experiment: ExperimentSummary) => void | Promise<void>;
     onSave?: () => string | null | Promise<string | null>;
     onDetach?: () => void;
     saveDisabled?: Ref<boolean> | ComputedRef<boolean>;
     saveDisabledMessage?: string | Ref<string | undefined> | ComputedRef<string | undefined>;
 }
+export interface AppExperimentPopoverBinding {
+    experimentName?: string;
+    experimentCode?: string;
+    experimentStatus?: ExperimentStatus;
+    showSave: boolean;
+    showDetach: boolean;
+    saveDisabled: boolean;
+    saveDisabledMessage?: string;
+    saveLoading: boolean;
+    saveSuccessMessage?: string;
+}
+export interface AppExperimentSelectorModalBinding {
+    modelValue: boolean;
+    currentExperimentId: number | null;
+}
 export interface UseAppExperimentReturn {
-    set: (experiment: Pick<ExperimentSummary, 'id' | 'name' | 'status' | 'experiment_code'>) => void;
+    set: (experiment: AppExperimentRecord) => void;
     clear: () => void;
     experimentName: Readonly<Ref<string | undefined>>;
     experimentCode: Readonly<Ref<string | undefined>>;
+    experimentStatus: Readonly<Ref<ExperimentStatus | undefined>>;
     experimentId: Readonly<Ref<number | null>>;
+    popover: ComputedRef<AppExperimentPopoverBinding>;
+    selectorModal: ComputedRef<AppExperimentSelectorModalBinding>;
+    openModal: () => void;
+    closeModal: () => void;
+    handleSelect: (experiment: ExperimentSummary) => void;
+    handleSave: () => Promise<void>;
+    handleDetach: () => void;
 }
 export interface AppExperimentState {
     experimentName: Ref<string | undefined>;
@@ -27,11 +54,13 @@ export interface AppExperimentState {
     closeModal: () => void;
     saveDisabled: ComputedRef<boolean>;
     saveDisabledMessage: ComputedRef<string | undefined>;
+    popover: ComputedRef<AppExperimentPopoverBinding>;
+    selectorModal: ComputedRef<AppExperimentSelectorModalBinding>;
     openModal: () => void;
     handleSelect: (experiment: ExperimentSummary) => void;
     handleSave: () => Promise<void>;
     handleDetach: () => void;
 }
 export declare const APP_EXPERIMENT_KEY: InjectionKey<AppExperimentState>;
-/** Manages the active experiment selection, save flow, and detach action for a plugin's app shell. */
+/** Manages the current experiment selection, save flow, and detach action for a plugin's AppTopBar app shell. */
 export declare function useAppExperiment(options?: UseAppExperimentOptions): UseAppExperimentReturn;

package/dist/composables/useBioTemplateComponents.d.ts

@@ -1,10 +1,12 @@
-import { getBioTemplateComponentBindings, toBioTemplateComponentImports, toBioTemplateComponentProps, toBioTemplateComponentPropsById, toBioTemplateComponentSnippets, toBioTemplateComponentUsage, BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, BioTemplateComponentSnippet, BioTemplateComponentTarget, BioTemplateComponentUsage } from '../templates/componentBindings';
+import { getBioTemplateComponentBindings, toBioTemplateComponentImports, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsById, toBioTemplateComponentSnippets, toBioTemplateComponentUsage, BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, BioTemplateResolvedComponentBinding, BioTemplateComponentSnippet, BioTemplateComponentTarget, BioTemplateComponentUsage } from '../templates/componentBindings';
 import { BioTemplateEnvelope, TemplateCollectionEnvelope } from '../templates/types';
-export { getBioTemplateComponentBindings, toBioTemplateComponentImports, toBioTemplateComponentProps, toBioTemplateComponentPropsById, toBioTemplateComponentSnippets, toBioTemplateComponentUsage, };
-export type { BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, BioTemplateComponentSnippet, BioTemplateComponentTarget, BioTemplateComponentUsage, };
+export { getBioTemplateComponentBindings, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentImports, toBioTemplateComponentProps, toBioTemplateComponentPropsById, toBioTemplateComponentSnippets, toBioTemplateComponentUsage, };
+export type { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, BioTemplateResolvedComponentBinding, BioTemplateComponentSnippet, BioTemplateComponentTarget, BioTemplateComponentUsage, };
 export interface UseBioTemplateComponentsReturn {
     bindings: BioTemplateComponentBinding[];
     imports: BioTemplateComponentImport[];
+    componentBindings: BioTemplateResolvedComponentBinding[];
+    componentBindingsById: BioTemplateComponentBindingsById;
     componentProps: BioTemplateComponentPropsBinding[];
     componentPropsById: BioTemplateComponentPropsById;
     componentPropsByComponent: BioTemplateComponentPropsByComponent;

package/dist/composables/useBioTemplatePackWorkspace.d.ts

@@ -2,7 +2,7 @@ import { ComputedRef, Ref } from 'vue';
 import { BioTemplatePackEntry, TemplateCollectionEnvelope, TemplatePackId } from '../templates';
 import { UseTemplateCollectionOptions, UseTemplateCollectionReturn } from './useTemplateCollection';
 import { BioTemplateRendererBinding, BioTemplateWorkspaceBindings, UseBioTemplateWorkspaceReturn } from './useBioTemplateWorkspace';
-import { BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage } from './useBioTemplateComponents';
+import { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage } from './useBioTemplateComponents';
 export type UseBioTemplatePackWorkspaceOptions = UseTemplateCollectionOptions;
 export interface UseBioTemplatePackWorkspaceReturn {
     packId: TemplatePackId;
@@ -21,11 +21,12 @@ export interface UseBioTemplatePackWorkspaceReturn {
     workspace: ComputedRef<UseBioTemplateWorkspaceReturn>;
     form: ComputedRef<UseBioTemplateWorkspaceReturn['form']>;
     sidebar: ComputedRef<UseBioTemplateWorkspaceReturn['sidebar']>;
-    topBar: ComputedRef<UseBioTemplateWorkspaceReturn['topBar']>;
+    topBar: ComputedRef<UseBioTemplateWorkspaceReturn['topBar']['value']>;
     pillNav: ComputedRef<UseBioTemplateWorkspaceReturn['pillNav']>;
     topBarSettings: ComputedRef<UseBioTemplateWorkspaceReturn['topBarSettings']>;
     bindings: ComputedRef<BioTemplateWorkspaceBindings>;
     componentBindings: ComputedRef<BioTemplateComponentBinding[]>;
+    componentBindingsById: ComputedRef<BioTemplateComponentBindingsById>;
     componentImports: ComputedRef<BioTemplateComponentImport[]>;
     componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>;
     componentPropsById: ComputedRef<BioTemplateComponentPropsById>;

package/dist/composables/useBioTemplatePresetWorkspace.d.ts

@@ -1,10 +1,10 @@
 import { ComputedRef, Ref } from 'vue';
 import { PillNavItem } from '../types';
 import { BioTemplateControlValues, BioTemplatePresetEntry, TemplateCollectionEnvelope, TemplatePresetId } from '../templates';
-import { ControlWorkspaceAppTopBarPillBinding, ControlWorkspaceAppTopBarTabsBinding, ControlWorkspaceOptions, ControlWorkspaceFormBinding, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn } from './useControlSchema';
+import { ControlWorkspaceOptions, ControlWorkspaceFormBinding, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn } from './useControlSchema';
 import { UseTemplateCollectionOptions, UseTemplateCollectionReturn } from './useTemplateCollection';
 import { BioTemplateRendererBinding, UseBioTemplateWorkspaceReturn } from './useBioTemplateWorkspace';
-import { BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage } from './useBioTemplateComponents';
+import { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage } from './useBioTemplateComponents';
 import { BioTemplateControlSchema } from './useBioTemplateControls';
 export interface UseBioTemplatePresetWorkspaceOptions extends UseTemplateCollectionOptions {
     /** Optional schema-rendering options for the generated FormBuilder/AppSidebar controls. */
@@ -32,13 +32,14 @@ export interface UseBioTemplatePresetWorkspaceReturn {
     activeControlView: Ref<string>;
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
-    topBar: ControlWorkspaceTopBarBinding;
+    topBar: ComputedRef<ControlWorkspaceTopBarBinding>;
     pillNav: ControlWorkspacePillNavBinding;
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     bindings: BioTemplatePresetWorkspaceBindings;
     renderer: ComputedRef<BioTemplateRendererBinding>;
     workspace: ComputedRef<UseBioTemplateWorkspaceReturn>;
     componentBindings: ComputedRef<BioTemplateComponentBinding[]>;
+    componentBindingsById: ComputedRef<BioTemplateComponentBindingsById>;
     componentImports: ComputedRef<BioTemplateComponentImport[]>;
     componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>;
     componentPropsById: ComputedRef<BioTemplateComponentPropsById>;
@@ -58,11 +59,11 @@ export interface BioTemplatePresetWorkspaceBindings {
     renderer: ComputedRef<BioTemplateRendererBinding>;
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
-    topBar: ComputedRef<ControlWorkspaceAppTopBarPillBinding>;
-    topBarTabs: ComputedRef<ControlWorkspaceAppTopBarTabsBinding>;
+    topBar: ComputedRef<ControlWorkspaceTopBarBinding>;
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     pillNav: ControlWorkspacePillNavBinding;
     componentBindings: ComputedRef<BioTemplateComponentBinding[]>;
+    componentBindingsById: ComputedRef<BioTemplateComponentBindingsById>;
     componentProps: ComputedRef<BioTemplateComponentPropsBinding[]>;
     componentPropsById: ComputedRef<BioTemplateComponentPropsById>;
     componentPropsByComponent: ComputedRef<BioTemplateComponentPropsByComponent>;

package/dist/composables/useBioTemplateWorkspace.d.ts

@@ -1,7 +1,7 @@
 import { BioTemplateEnvelope, TemplateCollectionEnvelope } from '../templates';
-import { ControlWorkspaceFormBinding, ControlWorkspaceOptions, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn, UseControlWorkspaceReturn } from './useControlSchema';
+import { ControlWorkspaceFormBinding, ControlWorkspaceOptions, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn, UseControlWorkspaceReturn } from './useControlSchema';
 import { BioTemplateControlSchema, BioTemplateControlTarget } from './useBioTemplateControls';
-import { BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage, UseBioTemplateComponentsReturn } from './useBioTemplateComponents';
+import { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage, UseBioTemplateComponentsReturn } from './useBioTemplateComponents';
 export type BioTemplateWorkspaceTarget = BioTemplateControlTarget;
 export interface BioTemplateRendererBinding {
     target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope;
@@ -11,10 +11,10 @@ export interface BioTemplateWorkspaceBindings {
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
     topBar: UseControlWorkspaceReturn<BioTemplateControlSchema>['bindings']['topBar'];
-    topBarTabs: UseControlWorkspaceReturn<BioTemplateControlSchema>['bindings']['topBarTabs'];
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     pillNav: ControlWorkspacePillNavBinding;
     componentBindings: BioTemplateComponentBinding[];
+    componentBindingsById: BioTemplateComponentBindingsById;
     componentProps: BioTemplateComponentPropsBinding[];
     componentPropsById: BioTemplateComponentPropsById;
     componentPropsByComponent: BioTemplateComponentPropsByComponent;
@@ -32,12 +32,13 @@ export interface UseBioTemplateWorkspaceReturn {
     activeView: UseControlWorkspaceReturn<BioTemplateControlSchema>['activeView'];
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
-    topBar: ControlWorkspaceTopBarBinding;
+    topBar: UseControlWorkspaceReturn<BioTemplateControlSchema>['topBar'];
     pillNav: ControlWorkspacePillNavBinding;
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     bindings: BioTemplateWorkspaceBindings;
     renderer: BioTemplateRendererBinding | null;
     componentBindings: BioTemplateComponentBinding[];
+    componentBindingsById: BioTemplateComponentBindingsById;
     componentImports: BioTemplateComponentImport[];
     componentProps: BioTemplateComponentPropsBinding[];
     componentPropsById: BioTemplateComponentPropsById;

package/dist/composables/useControlSchema.d.ts

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref } from 'vue';
-import { PillNavItem, SidebarToolSection, SelectOption, SettingsModalSchema, TopBarSettingsConfig, TopBarTab } from '../types';
+import { PillNavItem, SidebarToolSection, SelectOption, SettingsModalSchema, TopBarSettingsConfig } from '../types';
 import { FieldCondition, FieldValidation, FormFieldSchema, FormFieldType, FormSchema, FormSectionSchema } from '../types/form-builder';
 import { WellConcentration } from './useDoseCalculator';
 export type ControlOptionValue = string | number | boolean;
@@ -27,7 +27,7 @@ export interface ControlViewConfig {
     to?: string;
     href?: string;
     disabled?: boolean;
-    children?: TopBarTab['children'];
+    children?: PillNavItem['children'];
 }
 export interface ControlSidebarConfig extends Omit<ControlSectionConfig, 'id' | 'title' | 'description' | 'columns'> {
     enabled?: boolean;
@@ -111,6 +111,10 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
     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. */
@@ -119,6 +123,7 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
 export interface ControlModelBinding {
     controls: ControlSchema;
     controlOptions: ControlWorkspaceOptions;
+    componentBindings?: ControlComponentBindingsConfig;
     componentProps?: ControlComponentPropsMap;
     componentPropsById?: ControlComponentPropsByIdMap;
 }
@@ -153,39 +158,47 @@ export interface ControlWorkspaceSidebarBinding extends ControlSidebarBinding {
 export interface ControlWorkspaceTopBarSettingsBinding extends ControlTopBarSettingsBinding {
     onSettingsValuesChange: (values: Record<string, unknown>) => void;
 }
-export interface ControlWorkspaceTopBarBinding {
-    tabs: TopBarTab[];
-    currentTabId: string;
-    onTabSelect: (tab: TopBarTab) => void;
-}
 export interface ControlWorkspacePillNavBinding {
     items: PillNavItem[];
     currentItemId: string;
     onSelect: (item: PillNavItem) => void;
 }
-export interface ControlWorkspaceAppTopBarPillBinding extends ControlWorkspaceTopBarSettingsBinding {
+export interface ControlWorkspaceTopBarBinding extends ControlWorkspaceTopBarSettingsBinding {
     pillNav: PillNavItem[];
     currentPillId: string;
     onPillSelect: (item: PillNavItem) => void;
 }
-export interface ControlWorkspaceAppTopBarTabsBinding extends ControlWorkspaceTopBarSettingsBinding {
-    tabs: TopBarTab[];
-    currentTabId: string;
-    onTabSelect: (tab: TopBarTab) => void;
-}
+export type ControlWorkspaceAppTopBarPillBinding = ControlWorkspaceTopBarBinding;
 export interface ControlWorkspaceComponentBindings {
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
-    topBar: ComputedRef<ControlWorkspaceAppTopBarPillBinding>;
-    topBarTabs: ComputedRef<ControlWorkspaceAppTopBarTabsBinding>;
+    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>;
@@ -241,7 +254,6 @@ export interface UseControlSchemaReturn<TControls extends ControlSchema> {
     sidebarPanels: Record<string, SidebarToolSection[]>;
     viewIds: string[];
     viewItems: PillNavItem[];
-    topBarTabs: TopBarTab[];
     defaultView: string;
     sectionSchemas: Record<string, ControlFormSchema>;
     sidebar: ControlSidebarBinding;
@@ -254,10 +266,12 @@ export interface UseControlWorkspaceReturn<TControls extends ControlSchema> exte
     activeView: Ref<string>;
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
-    topBar: ControlWorkspaceTopBarBinding;
+    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;
@@ -265,6 +279,8 @@ export interface UseControlWorkspaceReturn<TControls extends ControlSchema> exte
     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]>;
@@ -277,18 +293,26 @@ type ControlValue<TControl> = TControl extends {
 type OptionValue<TOption> = TOption extends SelectOption<infer TValue> ? TValue : TOption;
 /** Preserve literal control keys while marking an object as a MINT control schema. */
 export declare function defineControls<TControls extends ControlSchema>(controls: TControls): TControls;
-/** Flatten a simple view/section control data model into ControlWorkspaceView props for generated forms and sidebars. */
+/** Preserve literal SDK component binding ids while marking an object as generated workspace component bindings. */
+export declare function defineControlComponentBindings<TBindings extends ControlComponentBindingsConfig>(bindings: TBindings): TBindings;
+/** Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars. */
 export declare function defineControlModel(model: ControlModel): ControlModelBinding;
 /** Build default values for a control schema, matching FormBuilder field defaults. */
 export declare function getControlDefaults<TControls extends ControlSchema>(controls: TControls): ControlValues<TControls>;
 /** Map control workspace values into component props for direct `v-bind` usage. */
 export declare function controlValuesToComponentProps<TValues extends Record<string, unknown>>(values: TValues, mapping?: ControlComponentPropsMap<TValues>): Record<string, unknown>;
+/** Map control workspace values into named SDK component bindings for direct slot rendering. */
+export declare function controlValuesToComponentBindings<TValues extends Record<string, unknown>>(values: TValues, bindings?: ControlComponentBindingsConfig<TValues>): ControlComponentBinding[];
+/** Map control workspace values into SDK component bindings keyed by binding id. */
+export declare function controlValuesToComponentBindingsById<TValues extends Record<string, unknown>>(values: TValues, bindings?: ControlComponentBindingsConfig<TValues>): ControlComponentBindingsById;
 /** Return a default WellPlate prop mapping for generated control workspaces. */
 export declare function defineWellPlateControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: WellPlateControlPropsOptions<TValues>): ControlComponentPropsMap<TValues>;
 /** Return a default DoseCalculator prop mapping for generated control workspaces. */
 export declare function defineDoseCalculatorControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: DoseCalculatorControlPropsOptions<TValues>): ControlComponentPropsMap<TValues>;
 /** Return named WellPlate + DoseCalculator prop mappings for one dose-design control model. */
 export declare function defineWellPlateDoseControlProps<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: WellPlateDoseControlPropsOptions<TValues>): ControlComponentPropsByIdMap<TValues>;
+/** Return named WellPlate + DoseCalculator component bindings for one dose-design control model. */
+export declare function defineWellPlateDoseComponentBindings<TValues extends Record<string, unknown> = Record<string, unknown>>(options?: WellPlateDoseControlPropsOptions<TValues>): ControlComponentBindingsConfig<TValues>;
 /** Return a complete ControlWorkspaceView model for WellPlate + DoseCalculator dose design. */
 export declare function defineDoseDesignControlModel(options?: DoseDesignControlModelOptions): ControlModelBinding;
 export declare function mergeControlWorkspaceOptions(base?: ControlWorkspaceOptions, override?: ControlWorkspaceOptions): ControlWorkspaceOptions;
@@ -302,10 +326,8 @@ export declare function controlsToSettingsSchema(controls: ControlSchema, option
 export declare function controlsToTopBarSettingsConfig(controls: ControlSchema, options?: ControlSchemaOptions, config?: Omit<TopBarSettingsConfig, 'schema' | 'controls' | 'controlOptions'>): TopBarSettingsConfig;
 /** Return generated control view IDs that have at least one sidebar panel. */
 export declare function controlsToViewIds(controls: ControlSchema, options?: ControlSchemaOptions): string[];
-/** Return AppPillNav-compatible view items for switching generated control sidebars. */
+/** Return AppTopBar pillNav-compatible view items for switching generated control sidebars. */
 export declare function controlsToViewItems(controls: ControlSchema, options?: ControlSchemaOptions): PillNavItem[];
-/** Return AppTopBar-compatible tabs for the same views that drive generated AppSidebar panels. */
-export declare function controlsToTopBarTabs(controls: ControlSchema, options?: ControlSchemaOptions): TopBarTab[];
 /** Return the first generated sidebar view ID, or an empty string when controls render no sidebar panels. */
 export declare function getDefaultControlView(controls: ControlSchema, options?: ControlSchemaOptions): string;
 /** Return a headerless single-section FormBuilder schema for rendering inside an AppSidebar section slot. */

package/dist/composables/usePluginClient.d.ts

@@ -1,4 +1,5 @@
 import { ComputedRef, Ref } from 'vue';
+import { ExperimentSummary, PageSelectorItem } from '../types';
 export type PluginHttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 export interface PluginEndpointContract {
     name: string;
@@ -71,7 +72,7 @@ export interface UseCurrentExperimentOptions {
     apiBaseUrl?: string;
     immediate?: boolean;
 }
-export interface UseCurrentExperimentReturn<TExperiment = unknown> {
+export interface UseCurrentExperimentReturn<TExperiment = ExperimentSummary> {
     /** Current experiment id resolved from platform injection or URL conventions. */
     experimentId: ComputedRef<number | undefined>;
     /** Whether a current experiment id is available. */
@@ -93,6 +94,8 @@ export interface UseCurrentExperimentReturn<TExperiment = unknown> {
 }
 export type PluginEndpointCaller = (payload?: unknown) => Promise<unknown>;
 export type GeneratedPluginClient = Record<string, (...args: any[]) => Promise<any>>;
+/** Convert PluginMetadata.nav_items into AppTopBar pageSelector items for topbar page switches, homepage PluginCards, and fallback views. */
+export declare function getPluginPageSelectorItems(contract: PluginContract): PageSelectorItem[];
 /** Resolve the runtime plugin API base URL from env, explicit options, platform injection, or contract metadata. */
 export declare function resolvePluginBaseUrl(contract: PluginContract, explicitBaseUrl?: string): string;
 /** Build the concrete URL for a generated plugin endpoint without making a request. */
@@ -106,4 +109,4 @@ export declare function usePluginSettings<TSettings = Record<string, unknown>>()
     settings: ComputedRef<TSettings | undefined>;
 };
 /** Read and optionally load the current platform experiment for integrated plugin views. */
-export declare function useCurrentExperiment<TExperiment = unknown>(options?: UseCurrentExperimentOptions): UseCurrentExperimentReturn<TExperiment>;
+export declare function useCurrentExperiment<TExperiment = ExperimentSummary>(options?: UseCurrentExperimentOptions): UseCurrentExperimentReturn<TExperiment>;

package/dist/{composables-C3dpXQN5.js → composables-CHsME9H1.js}

@@ -1,4 +1,4 @@
-import { F as usePlatformContext, K as useApi, W as useRequestSyncState, b as getInjectedPlatformContext, x as resolveCurrentExperimentId, y as currentExperimentFromContext } from "./useScheduleDrag-D4oWdh41.js";
+import { F as usePlatformContext, L as useRequestSyncState, b as getInjectedPlatformContext, x as resolveCurrentExperimentId, y as currentExperimentFromContext, z as useApi } from "./useScheduleDrag-BgzpQT53.js";
 import { r as useSettingsStore, t as useAuthStore } from "./auth-QQj2kkze.js";
 import { computed, getCurrentInstance, onMounted, onUnmounted, ref, shallowRef, watch } from "vue";
 import axios from "axios";
@@ -659,40 +659,52 @@ function usePluginConfig(pluginName) {
 	};
 }
 //#endregion
-//#region src/composables/usePluginApi.ts
-/**
-* Legacy plugin API client resolving the plugin base URL from VITE_API_PREFIX or a fallback prefix.
-*
-* @deprecated Use `useGeneratedPluginClient()` from `mint sdk generate` for new
-* plugin frontends. This helper remains as a compatibility shim for older
-* plugins that still hand-wire API prefixes.
-*
-* Migration shape for generated plugins:
-* ```ts
-* import { useGeneratedPluginClient } from '../generated/mint-plugin'
-*
-* const pluginClient = useGeneratedPluginClient()
-* ```
-*/
-function usePluginApi(options = {}) {
-	return useApi({ baseUrl: options.fallbackPrefix || "/api" });
-}
-//#endregion
 //#region src/composables/usePluginClient.ts
+function normalizeApiBaseUrl(baseUrl) {
+	if (!baseUrl) return void 0;
+	return baseUrl.length > 1 ? baseUrl.replace(/\/+$/, "") : baseUrl;
+}
 function normalizeApiPrefix(prefix) {
 	if (!prefix) return void 0;
-	if (prefix.startsWith("/api/")) return prefix;
+	if (prefix.startsWith("/api/")) return normalizeApiBaseUrl(prefix);
 	if (prefix === "/api") return prefix;
-	if (prefix.startsWith("/")) return `/api${prefix}`;
-	return `/api/${prefix}`;
+	if (prefix.startsWith("/")) return normalizeApiBaseUrl(`/api${prefix}`);
+	return normalizeApiBaseUrl(`/api/${prefix}`);
+}
+function normalizePluginNavPath(path) {
+	const raw = path.trim() || "/";
+	return (raw.startsWith("/") ? raw : `/${raw}`).replace(/\/+$/, "") || "/";
+}
+function pluginPageIdFromPath(path, fallbackIndex) {
+	const normalizedPath = normalizePluginNavPath(path);
+	if (normalizedPath === "/") return "dashboard";
+	return normalizedPath.replace(/^\/+/, "").replace(/\/+/g, "-") || `page-${fallbackIndex + 1}`;
+}
+/** Convert PluginMetadata.nav_items into AppTopBar pageSelector items for topbar page switches, homepage PluginCards, and fallback views. */
+function getPluginPageSelectorItems(contract) {
+	const pluginIcon = contract.plugin.icon ?? "";
+	const navItems = contract.plugin.navItems ?? [];
+	return (navItems.length > 0 ? navItems : [{
+		path: "/",
+		label: contract.plugin.name ?? "Dashboard",
+		id: "dashboard",
+		icon: pluginIcon || void 0,
+		description: contract.plugin.description
+	}]).map((item, index) => ({
+		id: item.id || pluginPageIdFromPath(item.path, index),
+		label: item.label,
+		to: normalizePluginNavPath(item.path),
+		icon: item.icon || pluginIcon || void 0,
+		hint: item.description || contract.plugin.name
+	}));
 }
 /** Resolve the runtime plugin API base URL from env, explicit options, platform injection, or contract metadata. */
 function resolvePluginBaseUrl(contract, explicitBaseUrl) {
-	if (explicitBaseUrl) return explicitBaseUrl;
+	if (explicitBaseUrl) return normalizeApiBaseUrl(explicitBaseUrl) ?? explicitBaseUrl;
 	const injected = getInjectedPlatformContext();
-	const platformPrefix = injected?.plugin?.api_prefix || normalizeApiPrefix(injected?.plugin?.route_prefix);
+	const platformPrefix = normalizeApiBaseUrl(injected?.plugin?.api_prefix) || normalizeApiPrefix(injected?.plugin?.route_prefix);
 	if (platformPrefix) return platformPrefix;
-	return contract.plugin.apiPrefix || "/api";
+	return normalizeApiBaseUrl(contract.plugin.apiPrefix) || "/api";
 }
 function encodePath(path, payload, pathParams) {
 	let nextPath = path;
@@ -882,6 +894,6 @@ function useCurrentExperiment(options = {}) {
 	};
 }
 //#endregion
-export { usePluginClient as a, usePluginConfig as c, usePasskey as d, useAuth as f, useCurrentExperiment as i, useAsync as l, createPluginClient as n, usePluginSettings as o, resolvePluginBaseUrl as r, usePluginApi as s, buildPluginEndpointUrl as t, useAsyncBatch as u };
+export { useCurrentExperiment as a, usePluginConfig as c, usePasskey as d, useAuth as f, resolvePluginBaseUrl as i, useAsync as l, createPluginClient as n, usePluginClient as o, getPluginPageSelectorItems as r, usePluginSettings as s, buildPluginEndpointUrl as t, useAsyncBatch as u };
 
-//# sourceMappingURL=composables-C3dpXQN5.js.map
+//# sourceMappingURL=composables-CHsME9H1.js.map