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

package/dist/composables/index.d.ts

@@ -8,13 +8,15 @@ export { useForm, type ValidationRule, type FieldRules, type FieldState, type Us
 export { useAsync, useAsyncBatch, type AsyncError, type AsyncState, type UseAsyncReturn, type UseAsyncOptions, } from './useAsync';
 export { useWellPlateEditor, type UseWellPlateEditorOptions, type UseWellPlateEditorReturn, } from './useWellPlateEditor';
 export { useConcentrationUnits, type ConcentrationValue, type ConcentrationUnit, type MolarityUnit, type MassVolumeUnit, type PercentageUnit, type UnitCategory, type UseConcentrationUnitsReturn, } from './useConcentrationUnits';
-export { useDoseCalculator, type VolumeUnit, type VolumeValue, type DilutionParams, type DilutionResult, type SerialDilutionParams, type SerialDilutionStep, type SerialDilutionResult, type WellConcentration, type UseDoseCalculatorReturn, } from './useDoseCalculator';
+export { useDoseCalculator, type VolumeUnit, type VolumeValue, type DilutionParams, type DilutionResult, type SerialDilutionParams, type SerialDilutionStep, type SerialDilutionResult, type ConversionResult, type WellConcentration, type UseDoseCalculatorReturn, } from './useDoseCalculator';
 export { useProtocolTemplates, type ParameterDefinition, type StepTemplate, type ValidationResult, type UseProtocolTemplatesReturn, } from './useProtocolTemplates';
 export { useRackEditor, type UseRackEditorOptions, type UseRackEditorReturn, } from './useRackEditor';
 export { useChemicalFormula, ATOMIC_WEIGHTS, type ParsedElement, type FormulaParseResult, type FormulaPart, type FormulaPartType, } from './useChemicalFormula';
 export { useSequenceUtils, type SequenceType, type SequenceStats, } from './useSequenceUtils';
-export { useTimeUtils, parseTime, formatTime, generateTimeSlots, rangesOverlap, durationMinutes, formatDuration, isTimeInRange, findAvailableSlots, snapToSlot, addMinutes, compareTime, } from './useTimeUtils';
+export { useTimeUtils, parseTime, formatTime, formatTimeSlot, generateTimeSlots, rangesOverlap, durationMinutes, formatDuration, isTimeInRange, findAvailableSlots, 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 { useReagentSeries, generateDilutionSeries, DEFAULT_PRESETS, DEFAULT_UNITS, type LevelEntry, type DilutionPreset, type UseReagentSeriesReturn, } from './useReagentSeries';
@@ -25,4 +27,21 @@ export { useExperimentData, type UseExperimentDataOptions, type UseExperimentDat
 export { getFieldRegistryEntry, getTypeDefault, type RegistryEntry, } from './formBuilderRegistry';
 export { useAppExperiment, APP_EXPERIMENT_KEY, type UseAppExperimentOptions, type UseAppExperimentReturn, type AppExperimentState, } 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';
+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/dist/composables/index.js

@@ -1,3 +1,4 @@
-import { $ as formatTime, A as getFieldRegistryEntry, B as useChemicalFormula, C as SORT_OPTIONS, D as evaluateCondition, E as useApi, H as useTheme, J as addMinutes, L as useSequenceUtils, O as useFormBuilder, P as useConcentrationUnits, Q as formatDuration, S as EXPERIMENT_STATUS_VARIANT_MAP, T as formatExperimentDate, U as useToast, X as durationMinutes, Y as compareTime, Z as findAvailableSlots, _ as usePlatformContext, a as DEFAULT_UNITS, at as useTimeUtils, b as EXPERIMENT_STATUS_LABELS, c as useDoseCalculator, et as generateTimeSlots, f as useAutoGroup, g as useAppExperiment, h as APP_EXPERIMENT_KEY, i as DEFAULT_PRESETS, it as snapToSlot, j as getTypeDefault, k as useForm, l as DEFAULT_COLORS, m as useRackEditor, n as useExperimentData, nt as parseTime, o as generateDilutionSeries, p as useWellPlateEditor, r as useProtocolTemplates, rt as rangesOverlap, s as useReagentSeries, t as useScheduleDrag, tt as isTimeInRange, u as extractSamplesFromDesignData, v as useExperimentSelector, w as datePresetToISO, x as EXPERIMENT_STATUS_OPTIONS, y as DATE_PRESET_OPTIONS, z as ATOMIC_WEIGHTS } from "../useScheduleDrag-CA9sGNJG.js";
-import { a as useAsyncBatch, i as useAsync, n as useExperimentSave, o as usePasskey, r as usePluginConfig, s as useAuth, t as usePluginApi } from "../composables-tiZqLu1M.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, compareTime, datePresetToISO, durationMinutes, evaluateCondition, extractSamplesFromDesignData, findAvailableSlots, formatDuration, formatExperimentDate, formatTime, generateDilutionSeries, generateTimeSlots, getFieldRegistryEntry, getTypeDefault, isTimeInRange, parseTime, rangesOverlap, snapToSlot, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useChemicalFormula, useConcentrationUnits, useDoseCalculator, useExperimentData, useExperimentSave, useExperimentSelector, useForm, useFormBuilder, usePasskey, usePlatformContext, usePluginApi, usePluginConfig, useProtocolTemplates, useRackEditor, useReagentSeries, useScheduleDrag, useSequenceUtils, useTheme, useTimeUtils, useToast, useWellPlateEditor };
+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 };

package/dist/composables/platformContextHelpers.d.ts

@@ -0,0 +1,14 @@
+import { PlatformContext } from '../types';
+export type ExperimentAwarePlatformContext = PlatformContext & {
+    currentExperiment?: unknown;
+    currentExperimentId?: unknown;
+    experiment?: unknown;
+    experimentId?: unknown;
+};
+export declare function getInjectedPlatformContext(): PlatformContext | undefined;
+export declare function getInjectedExperimentContext(): ExperimentAwarePlatformContext | undefined;
+export declare function currentExperimentFromContext<TExperiment>(context?: ExperimentAwarePlatformContext | undefined): TExperiment | undefined;
+export declare function currentExperimentIdFromContext(context?: ExperimentAwarePlatformContext | undefined): number | undefined;
+export declare function currentExperimentIdFromUrl(): number | undefined;
+export declare function resolveCurrentExperimentId(context?: ExperimentAwarePlatformContext | undefined): number | undefined;
+export declare function parseExperimentId(value: unknown): number | undefined;

package/dist/composables/useBioTemplateComponents.d.ts

@@ -0,0 +1,20 @@
+import { getBioTemplateComponentBindings, toBioTemplateComponentImports, toBioTemplateComponentProps, toBioTemplateComponentPropsById, toBioTemplateComponentSnippets, toBioTemplateComponentUsage, BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, 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 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 declare function toBioTemplateComponentPropsByComponent(target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope): BioTemplateComponentPropsByComponent;
+/** Return the first props object for an SDK component, optionally restricted by template id or binding id. */
+export declare function getBioTemplateComponentProps(target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope, component: string, options?: BioTemplateComponentPropsLookupOptions): Record<string, unknown> | undefined;
+/** Map built-in biology templates to SDK components such as WellPlate, DataFrame, DoseCalculator, and PlateMapEditor. */
+export declare function useBioTemplateComponents(target: BioTemplateComponentTarget): UseBioTemplateComponentsReturn;

package/dist/composables/useBioTemplateControls.d.ts

@@ -0,0 +1,6 @@
+import { getBioTemplateControlSchema, requireBioTemplateControlSchema, BioTemplateControlSchema, BioTemplateControlTarget } from '../templates/controlSchemas';
+import { 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 declare function useBioTemplateControls(target: BioTemplateControlTarget, options?: ControlWorkspaceOptions): UseControlSchemaReturn<BioTemplateControlSchema>;

package/dist/composables/useBioTemplatePackWorkspace.d.ts

@@ -0,0 +1,45 @@
+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';
+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 declare function useBioTemplatePackWorkspace(packId: TemplatePackId | string, options?: UseBioTemplatePackWorkspaceOptions): UseBioTemplatePackWorkspaceReturn;

package/dist/composables/useBioTemplatePresetWorkspace.d.ts

@@ -0,0 +1,74 @@
+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 { UseTemplateCollectionOptions, UseTemplateCollectionReturn } from './useTemplateCollection';
+import { BioTemplateRendererBinding, UseBioTemplateWorkspaceReturn } from './useBioTemplateWorkspace';
+import { BioTemplateComponentBinding, 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. */
+    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 declare function useBioTemplatePresetWorkspace(presetId: TemplatePresetId, options?: UseBioTemplatePresetWorkspaceOptions): UseBioTemplatePresetWorkspaceReturn;

package/dist/composables/useBioTemplateWorkspace.d.ts

@@ -0,0 +1,50 @@
+import { BioTemplateEnvelope, TemplateCollectionEnvelope } from '../templates';
+import { ControlWorkspaceFormBinding, ControlWorkspaceOptions, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn, UseControlWorkspaceReturn } from './useControlSchema';
+import { BioTemplateControlSchema, BioTemplateControlTarget } from './useBioTemplateControls';
+import { BioTemplateComponentBinding, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage, 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 declare function useBioTemplateWorkspace(target: BioTemplateWorkspaceTarget, options?: ControlWorkspaceOptions): UseBioTemplateWorkspaceReturn;

package/dist/composables/useCalendarGrid.d.ts

@@ -0,0 +1,26 @@
+import { ComputedRef, Ref } from 'vue';
+export interface CalendarGridDay {
+    date: Date;
+    isCurrentMonth: boolean;
+    isDisabled: boolean;
+}
+export interface UseCalendarGridOptions {
+    min?: () => string | undefined;
+    max?: () => string | undefined;
+    locale?: () => string | undefined;
+}
+export interface UseCalendarGridReturn {
+    currentMonth: Ref<Date>;
+    weekDays: readonly string[];
+    monthYear: ComputedRef<string>;
+    calendarDays: ComputedRef<CalendarGridDay[]>;
+    isDateDisabled: (date: Date) => boolean;
+    isSameDay: (date: Date, other: Date | null | undefined) => boolean;
+    isToday: (date: Date) => boolean;
+    formatDateValue: (date: Date) => string;
+    setCurrentMonthFromDate: (date: Date) => void;
+    prevMonth: () => void;
+    nextMonth: () => void;
+}
+/** Shared calendar grid state for date and datetime pickers. */
+export declare function useCalendarGrid(options?: UseCalendarGridOptions): UseCalendarGridReturn;