@morscherlab/mint-sdk 1.3.9 → 1.4.0-beta.1

package/dist/composables/controlSchemaTypes.d.ts

@@ -1,8 +1,8 @@
 import { ComputedRef, Ref } from 'vue';
-import { PillNavItem, SidebarBadgeTone, SidebarToolSection, SidebarToolSectionAction, SelectOption, SettingsModalSchema, TopBarSettingsConfig } from '../types';
+import { PillNavItem, SidebarToolSection, SidebarToolSectionAction, SelectOption, SettingsModalSchema, TopBarSettingsConfig, Tone } from '../types';
 import { AccessPolicy } from '../permissions';
-import { FieldCondition, FieldValidation, FormFieldSchema, FormFieldType, FormSchema, FormSectionSchema } from '../types/form-builder';
-import { WellConcentration } from './useDoseCalculator';
+import { FieldCondition, FieldValidation, FormEnhancements, FormFieldSchema, FormFieldType, FormSchema, FormSectionSchema } from '../types/form-builder';
+import { WellConcentration } from '../utils/dose';
 export type ControlOptionValue = string | number | boolean;
 export type ControlOption = ControlOptionValue | SelectOption<unknown>;
 export type ControlPrimitive = string | number | boolean;
@@ -18,7 +18,7 @@ export interface ControlSectionConfig {
     iconColor?: string;
     iconBg?: string;
     badge?: string | number;
-    badgeTone?: SidebarBadgeTone;
+    badgeTone?: Tone;
     actions?: SidebarToolSectionAction[];
     columns?: 1 | 2 | 3;
     condition?: FieldCondition;
@@ -99,13 +99,20 @@ export interface ControlSchemaOptions {
     sectionLabel?: string;
     sections?: Record<string, ControlSectionConfig>;
     columns?: 1 | 2 | 3;
+    /** Submit / cancel bar of the generated form; unset or `false` hides it. */
+    actions?: boolean | ControlFormActions;
+}
+/** Labels of the generated form's submit / cancel bar. */
+export interface ControlFormActions {
     submitLabel?: string;
     cancelLabel?: string;
     showCancel?: boolean;
 }
 export interface ControlWorkspaceOptions extends ControlSchemaOptions {
     initialValues?: Record<string, unknown>;
-    topBarSettings?: Omit<TopBarSettingsConfig, 'schema' | 'controls' | 'controlOptions' | 'values'>;
+    /** Validators, dynamic options, a submit handler and field callbacks that JSON cannot express. */
+    enhancements?: FormEnhancements<Record<string, unknown>>;
+    topBarSettings?: Omit<TopBarSettingsConfig, 'spec' | 'values'>;
 }
 export interface ControlModelSectionConfig extends ControlSectionConfig {
     controls: ControlSchema;
@@ -126,7 +133,7 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
     componentBindings?: ControlComponentBindingsConfig;
     /** Alias for componentBindings in raw control models. */
     components?: ControlComponentBindingsConfig;
-    /** Optional ControlWorkspaceView componentProps mapping returned with the generated controls/options. */
+    /** Optional componentProps mapping returned with the generated controls/options. */
     componentProps?: ControlComponentPropsMap;
     /** Optional named componentProps mappings returned for multiple SDK components. */
     componentPropsById?: ControlComponentPropsByIdMap;
@@ -138,31 +145,33 @@ export interface ControlModelBinding {
     componentProps?: ControlComponentPropsMap;
     componentPropsById?: ControlComponentPropsByIdMap;
 }
+/** AppSidebar props (`v-bind`) for the generated sections and forms. */
 export interface ControlSidebarBinding {
-    panels: Record<string, SidebarToolSection[]>;
-    forms: Record<string, ControlFormSchema>;
-    viewIds: string[];
-    viewItems: PillNavItem[];
-    defaultView: string;
+    spec: {
+        panels: Record<string, SidebarToolSection[]>;
+        forms: Record<string, ControlFormSchema>;
+    };
+    activeView: string;
 }
+/** FormBuilder props (`v-bind`) for the generated form. */
 export interface ControlFormBinding {
-    schema: ControlFormSchema;
+    spec: ControlModelBinding;
 }
+/** SettingsModal props (`v-bind`) for the generated settings. */
 export interface ControlSettingsBinding {
-    schema: SettingsModalSchema;
+    spec: SettingsModalSchema;
 }
+/** AppTopBar props (`v-bind`) for the generated settings button. */
 export interface ControlTopBarSettingsBinding {
-    showSettings: true;
-    settingsConfig: TopBarSettingsConfig;
+    spec: {
+        settings: TopBarSettingsConfig;
+    };
 }
 export interface ControlWorkspaceFormBinding extends ControlFormBinding {
     modelValue: Record<string, unknown>;
     'onUpdate:modelValue': (values: Record<string, unknown>) => void;
 }
 export interface ControlWorkspaceSidebarBinding extends ControlSidebarBinding {
-    activeView: string;
-    modelValue: Record<string, unknown>;
-    'onUpdate:modelValue': (values: Record<string, unknown>) => void;
     values: Record<string, unknown>;
     'onUpdate:values': (values: Record<string, unknown>) => void;
 }
@@ -174,10 +183,15 @@ export interface ControlWorkspacePillNavBinding {
     currentItemId: string;
     onSelect: (item: PillNavItem) => void;
 }
-export interface ControlWorkspaceTopBarBinding extends ControlWorkspaceTopBarSettingsBinding {
-    pillNav: PillNavItem[];
-    currentPillId: string;
+/** AppTopBar props (`v-bind`) for the generated view pills and settings button. */
+export interface ControlWorkspaceTopBarBinding {
+    spec: {
+        pills: PillNavItem[];
+        settings: TopBarSettingsConfig;
+    };
+    pill: string;
     onPillSelect: (item: PillNavItem) => void;
+    onSettingsValuesChange: (values: Record<string, unknown>) => void;
 }
 export type ControlWorkspaceAppTopBarPillBinding = ControlWorkspaceTopBarBinding;
 export interface ControlWorkspaceComponentBindings {
@@ -217,8 +231,6 @@ export interface WellPlateControlPropsOptions<TValues extends Record<string, unk
     disabled?: ControlComponentPropSource<TValues>;
     readonly?: ControlComponentPropSource<TValues>;
     showLegend?: ControlComponentPropSource<TValues>;
-    /** @deprecated WellPlate `showSampleTypeIndicator` is a no-op since MINT 1.3; removed in MINT 1.4. */
-    showSampleTypeIndicator?: ControlComponentPropSource<TValues>;
     /** Listener for WellPlate v-model updates. Set false to keep generated props one-way. */
     onUpdateModelValue?: ((values: TValues) => (wellIds: string[]) => void) | false;
 }

package/dist/composables/{usePluginClient.d.ts → createClient.d.ts}

@@ -1,7 +1,7 @@
 import { ComputedRef, Ref } from 'vue';
-import { EventStreamMessage, UseEventStreamReturn } from './useEventStream';
-import { ExperimentSummary, GeneratedJobDefinition, PageSelectorItem, SettingsModalSchema, TopBarSettingsConfig } from '../types';
-export { buildPluginEndpointUrl, resolvePluginBaseUrl, } from './pluginEndpointBuilder';
+import { EventStreamMessage, UseEventStreamReturn } from './eventStream';
+import { GeneratedJobDefinition, SettingsModalSchema, TopBarSettingsConfig } from '../types';
+export { buildEndpointUrl, resolvePluginBaseUrl, } from './pluginEndpointBuilder';
 export type PluginHttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 export interface PluginEndpointContract {
     name: string;
@@ -30,7 +30,7 @@ export interface PluginNavItemContract {
     icon?: string;
     description?: string;
     requiresAuth?: boolean;
-    requiresAdmin?: boolean;
+    access?: 'use' | 'configure' | 'admin';
     requiresFeature?: string;
 }
 export interface PluginContractSettings {
@@ -82,11 +82,11 @@ export type PluginEndpointParamDefinition = string | {
     type?: string;
     required?: boolean;
 };
-export interface CreatePluginClientOptions {
+export interface CreateClientOptions {
     endpoints: Record<string, PluginEndpointDefinition>;
     baseUrl?: string;
 }
-export interface BuildPluginEndpointUrlOptions {
+export interface BuildEndpointUrlOptions {
     /** Override the generated or platform-injected API base URL. */
     baseUrl?: string;
     /** Return only the endpoint path and query string instead of base URL + path. */
@@ -102,9 +102,11 @@ export interface PluginClientRequestOptions {
     /** Cancel the generated endpoint request. */
     signal?: AbortSignal;
 }
-export interface DownloadPluginEndpointOptions extends PluginEndpointRequestOptions {
+export interface DownloadEndpointOptions extends PluginEndpointRequestOptions {
     /** Browser download filename. When omitted, the blob is returned without triggering a download. */
     filename?: string;
+    /** Save the blob as `filename` in the browser. Default true; `false` only returns the blob. */
+    save?: boolean;
     /** Delay before revoking the object URL after a browser download is triggered. */
     revokeObjectUrlDelayMs?: number;
 }
@@ -113,7 +115,7 @@ export interface DownloadBlobOptions {
     revokeObjectUrlDelayMs?: number;
 }
 export type PluginSettingsValues<TSettings> = Partial<TSettings> & Record<string, unknown>;
-export interface UsePluginSettingsOptions {
+export interface UseSettingsEndpointOptions {
     /** Plugin name for platform persistence. Defaults to the integrated platform plugin name. */
     pluginName?: string;
     /** Plugin API base URL for standalone/local settings routes. Generated clients pass pluginApiPrefix. */
@@ -129,7 +131,7 @@ export interface UsePluginSettingsOptions {
     /** Load persisted values on component mount. */
     loadOnMount?: boolean;
 }
-export interface UsePluginSettingsReturn<TSettings = Record<string, unknown>> {
+export interface UseSettingsEndpointReturn<TSettings = Record<string, unknown>> {
     /** Current typed settings values. */
     settings: ComputedRef<PluginSettingsValues<TSettings>>;
     /** Editable settings values for SettingsModal. */
@@ -149,8 +151,8 @@ export interface UsePluginSettingsReturn<TSettings = Record<string, unknown>> {
     save: (values?: Record<string, unknown>) => Promise<boolean>;
     reset: () => void;
 }
-export type PluginEventStreamMessage<TData = string> = EventStreamMessage<TData>;
-export interface PluginEventStreamOptions<TData = string> {
+export type { EventStreamMessage, UseEventStreamReturn } from './eventStream';
+export interface StreamOptions<TData = string> {
     /** Override the generated or platform-injected API base URL. */
     baseUrl?: string;
     /** Start the stream immediately. Defaults to true. */
@@ -166,56 +168,25 @@ export interface PluginEventStreamOptions<TData = string> {
     /** Extra request headers. Authorization is injected unless already supplied. */
     headers?: Record<string, string>;
     onOpen?: () => void;
-    onMessage?: (message: PluginEventStreamMessage<TData>) => void;
+    onMessage?: (message: EventStreamMessage<TData>) => void;
     onError?: (error: unknown) => void;
 }
-export type UsePluginEventStreamReturn<TData = string> = UseEventStreamReturn<TData>;
 export type PluginFormDataValue = string | number | boolean | Blob | null | undefined | Record<string, unknown>;
 export type PluginFormDataPayload = Record<string, PluginFormDataValue | PluginFormDataValue[]>;
-export interface UseCurrentExperimentOptions {
-    apiBaseUrl?: string;
-    immediate?: boolean;
-}
-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. */
-    hasExperiment: ComputedRef<boolean>;
-    /** Current experiment payload, if injected or successfully fetched. */
-    experiment: Ref<TExperiment | undefined>;
-    /** Whether the current experiment is currently loading. */
-    isLoading: Ref<boolean>;
-    /** Error message from the last failed current-experiment fetch, or null. */
-    error: Ref<string | null>;
-    /** Timestamp of the last successful current-experiment fetch, or null. */
-    lastLoadedAt: Ref<Date | null>;
-    /** Return the current experiment id or throw a clear SDK error when absent. */
-    requireExperimentId: () => number;
-    /** Fetch a specific experiment id, defaulting to the current experiment id. */
-    fetch: (experimentId?: number) => Promise<TExperiment | undefined>;
-    /** Refetch the currently resolved experiment id. */
-    refresh: () => Promise<TExperiment | undefined>;
-}
 export type PluginEndpointCaller = (payloadOrOptions?: unknown, options?: PluginClientRequestOptions) => Promise<unknown>;
 export type GeneratedPluginClient = Record<string, (...args: any[]) => Promise<any>>;
 /** Convert plain upload payloads into FormData using the same encoding across generated plugin clients. */
 export declare function pluginFormDataFromPayload(payload: unknown): FormData;
 /** Trigger a browser download for an already-created Blob. */
 export declare function downloadBlob(blob: Blob, filename: string, options?: DownloadBlobOptions): void;
-/** Convert resolved @mint_plugin nav_items into page selectors for the topbar and homepage PluginCards. */
-export declare function getPluginPageSelectorItems(contract: PluginContract): PageSelectorItem[];
 /** Create a typed plugin API client from a generated MINT plugin contract. */
-export declare function createPluginClient<TClient extends object = GeneratedPluginClient>(contract: PluginContract, options: CreatePluginClientOptions): TClient;
+export declare function createClient<TClient extends object = GeneratedPluginClient>(contract: PluginContract, options: CreateClientOptions): TClient;
 /** Send multipart or raw binary data to a generated endpoint with contract URL, cancellation, and auth handling. */
-export declare function uploadPluginEndpoint<TResponse = unknown>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: PluginEndpointRequestOptions): Promise<TResponse>;
+export declare function uploadEndpoint<TResponse = unknown>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: PluginEndpointRequestOptions): Promise<TResponse>;
 /** Fetch a generated plugin endpoint as a Blob and optionally trigger a browser download. */
-export declare function downloadPluginEndpoint(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: DownloadPluginEndpointOptions): Promise<Blob>;
-/** @deprecated Removed in MINT 1.4; use `useGeneratedPluginClient()` for generated clients. */
-export declare function usePluginClient<TClient>(client: TClient): TClient;
+export declare function downloadEndpoint(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: DownloadEndpointOptions): Promise<Blob>;
 /** Load, edit, and persist plugin settings from platform config or the plugin-local settings router. */
-export declare function usePluginSettings<TSettings = Record<string, unknown>>(options?: UsePluginSettingsOptions | string): UsePluginSettingsReturn<TSettings>;
+export declare function useSettingsEndpoint<TSettings = Record<string, unknown>>(options?: UseSettingsEndpointOptions | string): UseSettingsEndpointReturn<TSettings>;
 /** Consume a generated plugin SSE endpoint with auth headers, reconnect, and teardown. */
-export declare function usePluginEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, options?: PluginEventStreamOptions<TData>): UsePluginEventStreamReturn<TData>;
-export declare function usePluginEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: PluginEventStreamOptions<TData>): UsePluginEventStreamReturn<TData>;
-/** Read and optionally load the current platform experiment for integrated plugin views. */
-export declare function useCurrentExperiment<TExperiment = ExperimentSummary>(options?: UseCurrentExperimentOptions): UseCurrentExperimentReturn<TExperiment>;
+export declare function useEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, options?: StreamOptions<TData>): UseEventStreamReturn<TData>;
+export declare function useEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: StreamOptions<TData>): UseEventStreamReturn<TData>;

package/dist/composables/{useEventStream.d.ts → eventStream.d.ts}

@@ -7,7 +7,7 @@ export interface EventStreamMessage<TData = string> {
     retry?: number;
     raw: string;
 }
-export interface EventStreamOptions<TData = string> {
+export interface CreateEventStreamOptions<TData = string> {
     transport?: EventStreamTransport;
     headers?: HeadersInit;
     credentials?: RequestCredentials;
@@ -48,5 +48,5 @@ interface ParsedEventStreamBlock<TData> {
 /** Parse one complete SSE block without owning connection policy. */
 export declare function parseEventStreamBlock<TData>(block: string, parseJson: boolean): ParsedEventStreamBlock<TData> | null;
 /** Shared fetch-based SSE lifecycle with cancellation and reconnect safety. */
-export declare function useEventStream<TData = string>(url: string | (() => string), options?: EventStreamOptions<TData>): UseEventStreamReturn<TData>;
+export declare function createEventStream<TData = string>(url: string | (() => string), options?: CreateEventStreamOptions<TData>): UseEventStreamReturn<TData>;
 export {};

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

@@ -1,15 +1,10 @@
-import { DatePreset, ExperimentStatus, SelectOption, PillVariant } from '../types';
+import { DatePreset, SelectOption } 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;
 type RouteQueryValue = string | null | undefined | readonly (string | null | undefined)[];
 type RouteQueryLike = Record<string, RouteQueryValue>;

package/dist/composables/index.d.ts

@@ -1,63 +1,10 @@
-export { AuthenticationRequiredError, useApi, type ApiClientOptions, type UseApiReturn, } from './useApi';
 export { useTheme } from './useTheme';
 export { useToast } from './useToast';
-export { usePlatformContext } from './usePlatformContext';
+export { usePlatform } from './usePlatform';
+export { useExperiment, type ExperimentLoadStatus, type UseExperimentReturn } from './useExperiment';
 export { resolvePluginFrontendBase } from './pluginFrontendBase';
-export { getPresenceClientId, usePresenceHeartbeat, type PresenceHeartbeatOptions, type PresenceHeartbeatPayload, type PresenceHeartbeatResponse, type UsePresenceHeartbeatReturn, } from './usePresenceHeartbeat';
-export { getInjectedFrontendRevision, useRuntimeAlignment, type RuntimeAlignmentOptions, type RuntimeRevisionResponse, type UseRuntimeAlignmentReturn, } from './useRuntimeAlignment';
-export { useForm, type ValidationRule, type FieldRules, type FieldState, type UseFormReturn, } from './useForm';
-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 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, type PlateEditorListeners, } from './useRackEditor';
-export { useChemicalFormula, ATOMIC_WEIGHTS, type ParsedElement, type FormulaParseResult, type FormulaPart, type FormulaPartType, } from './useChemicalFormula';
-export { useSequenceUtils, type SequenceType, type SequenceStats, type SequenceProblems, } from './useSequenceUtils';
-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 { DEFAULT_MOBILE_VIEWPORT_QUERY, useMobileSupportGate, type MobileSupportSource, type MobileViewportQuerySource, type UseMobileSupportGateOptions, type UseMobileSupportGateReturn, } from './useMobileSupportGate';
-export { useDebouncedWatch, type DebouncedWatchCallback, type DebouncedWatchCleanup, type DebouncedWatchSource, type UseDebouncedWatchOptions, type UseDebouncedWatchReturn, } from './useDebouncedWatch';
-export { resizedLeadingPanelWidth, resizedTrailingPanelWidth, resizedVerticalSplitPercent, useManualLayoutResize, type ManualLayoutResizeContext, type ManualLayoutResizeTarget, type ResizePanelWidthConstraints, type ResizePercentConstraints, } from './useManualLayoutResize';
-export { useFormBuilder, evaluateCondition } from './useFormBuilder';
-export { createGeneratedAnalysisTransport, useGeneratedAnalysis, usePluginJobs, type GeneratedAnalysisTransport, type GeneratedAnalysisOptions, type PluginJobRequestOptions, type PluginJobWaitOptions, type UsePluginJobsOptions, type UsePluginJobsReturn, type UseGeneratedAnalysisReturn, } from './useGeneratedAnalysis';
-export { useAutoGroup, DEFAULT_COLORS, extractSamplesFromDesignData } from './useAutoGroup';
-export { useReagentSeries, generateDilutionSeries, DEFAULT_PRESETS, DEFAULT_UNITS, type LevelEntry, type DilutionPreset, type UseReagentSeriesReturn, } from './useReagentSeries';
-export { useExperimentSelector, type UseExperimentSelectorOptions, type UseExperimentSelectorReturn, } from './useExperimentSelector';
-export { useAnalysisArtifacts, ANALYSIS_FILE_ARTIFACT_SCHEMA, type UseAnalysisArtifactsOptions, type UseAnalysisArtifactsReturn, } from './useAnalysisArtifacts';
-export { useFileBrowser, type UseFileBrowserOptions, type UseFileBrowserReturn, } from './useFileBrowser';
-export { buildAnalysisArtifactTargetQuery, parseAnalysisArtifactTarget, } from './analysisArtifactTarget';
-export { resolveCurrentPluginId } from './platformContextHelpers';
-export { formatExperimentDate, formatExperimentStatus, getExperimentStatusVariant, resolveExperimentCode, experimentIdFromRoute, 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 { extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, unwrapExperimentDesignData, type ExperimentDesignDataResponse, type ExtractExperimentSamplesOptions, } from './experimentDesignData';
-export { useExperimentSamples, type ExperimentDesignDataSource, type ExperimentIdSource, type UseExperimentSamplesOptions, type UseExperimentSamplesReturn, } from './useExperimentSamples';
-export { getFieldRegistryEntry, getTypeDefault, type RegistryEntry, } from './formBuilderRegistry';
-export { useAppExperiment, APP_EXPERIMENT_KEY, 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';
-export { detectDelimiter, parseDelimitedText, readFileAsText, useFileImport, validateImportFile, type DelimitedTable, type FileImportOptions, type FileImportValidationOptions, type ParseDelimitedTextOptions, type UseFileImportReturn, } from './useFileImport';
-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 SampleGroupNode, 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';
-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, 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, downloadBlob, downloadPluginEndpoint, getPluginPageSelectorItems, pluginFormDataFromPayload, resolvePluginBaseUrl, uploadPluginEndpoint, usePluginClient, usePluginEventStream, usePluginSettings, useCurrentExperiment, type BuildPluginEndpointUrlOptions, type DownloadBlobOptions, type DownloadPluginEndpointOptions, type PluginContract, type PluginContractSettings, type PluginClientRequestOptions, type PluginEndpointContract, type PluginEndpointDefinition, type PluginHttpMethod, type PluginNavItemContract, type PluginEndpointRequestOptions, type PluginEventStreamMessage, type PluginEventStreamOptions, type PluginFormDataPayload, type PluginFormDataValue, type CreatePluginClientOptions, type UseCurrentExperimentOptions, type UseCurrentExperimentReturn, type UsePluginEventStreamReturn, type UsePluginSettingsOptions, type UsePluginSettingsReturn, } from './usePluginClient';
-export { combinePluginJobSources, usePluginJobCenter, useJobsStatusTray, type CombinedPluginJobCenterSource, type JobsStatusTrayAdapter, type JobStreamMessage, type PluginJobCenterSource, type JobsStatusTrayTab, type UseJobsStatusTrayOptions, type UseJobsStatusTrayReturn, type UsePluginJobCenterOptions, type UsePluginJobCenterReturn, } from './useJobsStatusTray';
-export { usePluginWorkspace, type PluginWorkspaceSlotsLike, type UsePluginWorkspaceOptions, type UsePluginWorkspaceReturn, } from './usePluginWorkspace';
+export { useRequest, type RequestKind, type RequestOperation, type RequestRunOptions, type UseRequestReturn, } from './useRequest';
+export { downloadBlob, type DownloadBlobOptions } from './createClient';
+export { defineControlModel, type ControlDefinition, type ControlComponentBinding, type ControlComponentBindingConfig, type ControlComponentBindingRecordConfig, type ControlComponentBindingsById, type ControlComponentBindingsConfig, type ControlComponentPropSource, type ControlComponentPropsByIdMap, type ControlComponentPropsMap, 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 ControlFormActions, type ControlSectionConfig, type ControlSidebarConfig, type ControlViewConfig, } from './useControlSchema';
+export { defineDataFrame, definePluginWorkspaceView } from './componentSpecs';
 export { type PluginWorkspaceControlsModel, type PluginWorkspaceShellModel, type PluginWorkspaceSidebarModel, } from './pluginWorkspaceModel';
-export { useFocusTrap, type UseFocusTrapOptions, type UseFocusTrapReturn, } from './useFocusTrap';
-export { useRovingFocus, type UseRovingFocusOptions, type UseRovingFocusReturn, } from './useRovingFocus';
-export { reorderList, useListReorder, useReorderAnnouncer, REORDER_ANNOUNCER_STYLE, type ListReorderMove, type UseListReorderOptions, type UseListReorderReturn, type UseReorderAnnouncerReturn, } from './useListReorder';
-export { useMenuKeyboard, type UseMenuKeyboardOptions, type UseMenuKeyboardReturn, } from './useMenuKeyboard';
-export { usePlatformFilePickerAdapter, encodePlatformPickerPath, decodePlatformPickerPath } from './usePlatformFilePickerAdapter';
-export { createFilePickerAdapter } from './createFilePickerAdapter';
-export type { FilePickerTransport, FilePickerAdapterOptions } from './createFilePickerAdapter';

package/dist/composables/platformContextHelpers.d.ts

@@ -1,16 +1,5 @@
 import { PlatformContext } from '../types';
-export type ExperimentAwarePlatformContext = PlatformContext & {
-    currentExperiment?: unknown;
-    currentExperimentId?: unknown;
-    experiment?: unknown;
-    experimentId?: unknown;
-};
 export declare function getInjectedPlatformContext(): PlatformContext | undefined;
 /** Return the platform's canonical plugin identity for the mounted frontend. */
 export declare function resolveCurrentPluginId(): string | 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/pluginEndpointBuilder.d.ts

@@ -1,4 +1,4 @@
-import { BuildPluginEndpointUrlOptions, PluginContract, PluginEndpointDefinition } from './usePluginClient';
+import { BuildEndpointUrlOptions, PluginContract, PluginEndpointDefinition } from './createClient';
 /** 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;
 export declare function hasKeys(value: Record<string, unknown>): boolean;
@@ -10,4 +10,4 @@ export declare function pluginEndpointRequestParts(contract: PluginContract, end
     requestPayload: Record<string, unknown>;
 };
 /** Build the concrete URL for a generated plugin endpoint without making a request. */
-export declare function buildPluginEndpointUrl(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: BuildPluginEndpointUrlOptions): string;
+export declare function buildEndpointUrl(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: BuildEndpointUrlOptions): string;

package/dist/composables/pluginWorkspaceModel.d.ts

@@ -1,16 +1,15 @@
-import { AccountMenuItem, PageSelectorItemInput, PillNavItemInput, SidebarToolSection, TopBarSettingsConfig, TopBarVariant } from '../types';
-import { FormEnhancements, FormSchema } from '../types/form-builder';
-import { ControlComponentBinding, ControlComponentBindingsById, ControlModel, ControlModelBinding, ControlSchema, ControlWorkspaceOptions } from './useControlSchema';
+import { PluginWorkspaceSidebarSpec, PluginWorkspaceTopBarSpec } from '../types';
+import { ControlComponentBinding, ControlComponentBindingsById } from './useControlSchema';
 /**
  * Scoped-slot payload shared by PluginWorkspaceView's `default`, `topbar`, and `sidebar`
  * slots: the resolved active view plus the values and component bindings/props derived
- * from the compact control schema. WorkspaceControlsInternal renders a component's default
+ * from the sidebar control model. WorkspaceControlsInternal renders a component's default
  * slot bound to exactly this shape.
  */
 export interface PluginWorkspaceControlsModel {
     /** Currently resolved workspace view id. */
     activeView: string;
-    /** Sets the active view, updating any uncontrolled state and emitting `update:activeView`. */
+    /** Sets the active view, updating any uncontrolled state and emitting `update:view`. */
     setActiveView: (viewId: string) => void;
     /** Current control values, shared between the auto-rendered sidebar form and the default slot. */
     values: Record<string, unknown>;
@@ -25,8 +24,8 @@ export interface PluginWorkspaceControlsModel {
 }
 /**
  * Resolved AppLayout + AppTopBar configuration consumed by WorkspaceShellInternal: top bar
- * chrome and navigation, plus the AppLayout layout/collapse props that own the responsive
- * mobile sidebar toggle.
+ * spec and active pill, plus the AppLayout layout props that own the responsive mobile
+ * sidebar toggle.
  */
 export interface PluginWorkspaceShellModel {
     /** AppLayout sidebar position. */
@@ -47,113 +46,31 @@ export interface PluginWorkspaceShellModel {
     title: string;
     /** Secondary copy shown under the title. */
     subtitle?: string;
-    /** Top bar visual treatment. */
-    topBarVariant: TopBarVariant;
-    /** Home link used by the top bar brand icon. */
-    homePath: string;
-    /** Show the default MINT logo when no icon/logo slot is provided. */
-    showLogo: boolean;
-    /** Preferred route-level page selector entries. */
-    pageSelector?: PageSelectorItemInput[];
-    /** Resolved active page selector id. */
-    currentPageSelectorId: string;
-    /** Resolved centered pill navigation, generated from the control schema when omitted. */
-    pillNav?: PillNavItemInput[];
+    /** AppTopBar spec with the workspace defaults applied and the generated pills filled in; `false` removes the top bar. */
+    topBar: false | PluginWorkspaceTopBarSpec;
     /** Resolved active centered pill id. */
-    currentPillId: string;
-    /** Show the theme toggle button. */
-    showThemeToggle: boolean;
-    /** Show the settings button and modal. */
-    showSettings: boolean;
-    /** Built-in settings modal configuration. */
-    settingsConfig?: TopBarSettingsConfig;
-    /** Show the standalone badge when not integrated into the platform. */
-    showStandaloneLabel: boolean;
-    /** Custom standalone badge label. */
-    standaloneLabel: string;
-    /** Account dropdown entries. */
-    accountMenu?: AccountMenuItem[];
-    /** Show the notifications icon button. */
-    showNotifications: boolean;
-    /** Draw a notification dot on the notifications icon. */
-    hasNotificationDot: boolean;
-    /** Show the admin shortcut. */
-    showAdmin: boolean;
-    /** Route used by the admin shortcut. */
-    adminPath: string;
-    /** Account display name. */
-    userName?: string;
-    /** Explicit account avatar initial. */
-    userInitial?: string;
-    /** Account email shown in the avatar menu. */
-    userEmail?: string;
+    pill: string;
     /** Names of AppTopBar passthrough slots the caller actually provided. */
     topBarSlotNames: string[];
     /** Scoped-slot payload exposed to the `topbar` override slot. */
     controls: PluginWorkspaceControlsModel;
 }
-/**
- * Resolved AppSidebar configuration consumed by WorkspaceSidebarInternal: sidebar chrome,
- * panels/forms, collapse behavior, and the compact control-schema props that drive
- * AppSidebar's auto-generated form.
- */
+/** Resolved AppSidebar configuration consumed by WorkspaceSidebarInternal. */
 export interface PluginWorkspaceSidebarModel {
-    /** Sidebar chrome title. */
-    title?: string;
-    /** Sidebar chrome subtitle. */
-    subtitle?: string;
-    /** Optional compact badge/count rendered in the sidebar header. */
-    badge?: string | number;
-    /** Map of view IDs to sidebar tool sections. */
-    panels: Record<string, SidebarToolSection[]>;
+    /** AppSidebar spec with the workspace defaults applied. */
+    spec: PluginWorkspaceSidebarSpec;
     /** Resolved active view, used to pick which panels/forms render. */
     activeView: string;
-    /** AppSidebar floating style (always false: PluginWorkspaceView docks the sidebar inside AppLayout). */
-    floating: boolean;
-    /** Compact AppSidebar density. */
-    dense: boolean;
-    /** Sidebar CSS width. */
-    width?: string;
-    /** Sidebar position, mirrors the shell's `sidebarPosition`. */
-    side: 'left' | 'right';
-    /** Optional FormBuilder schemas keyed by section ID. */
-    forms: Record<string, FormSchema>;
-    /** DOM id for the AppSidebar scrollable content area. */
-    contentId?: string;
-    /** Render the sidebar shell even when no panel matches the active view. */
-    showWhenEmpty: boolean;
-    /** Optional compact control model for the generated sidebar form. */
-    model?: ControlModel | ControlModelBinding;
-    /** Compact control schema for the generated sidebar form. */
-    controlSchema?: ControlSchema;
-    /** Options passed to compact control schema generation. */
-    controlOptions: ControlWorkspaceOptions;
     /** Shared values for the auto-rendered sidebar form. */
     values: Record<string, unknown>;
-    /** Runtime FormBuilder enhancements for the auto-rendered sidebar form. */
-    formEnhancements?: FormEnhancements<Record<string, unknown>>;
-    /** Show submit/cancel actions inside the auto-rendered sidebar form. */
-    showFormActions: boolean;
+    /** Controlled sidebar collapsed state. */
+    collapsed?: boolean;
     /** Loading/saving state for the auto-rendered sidebar form. */
     formLoading: boolean;
     /** Disabled state for the auto-rendered sidebar form. */
     formDisabled: boolean;
     /** Readonly state for the auto-rendered sidebar form. */
     formReadonly: boolean;
-    /** Size passed to the auto-rendered sidebar form. */
-    formSize: 'sm' | 'md' | 'lg';
-    /** Show a built-in collapse/expand button in the sidebar chrome. */
-    collapsible?: boolean;
-    /** Controlled sidebar collapsed state. */
-    collapsed?: boolean;
-    /** Initial sidebar collapsed state when uncontrolled. */
-    defaultCollapsed: boolean;
-    /** Sidebar width when collapsed. */
-    collapsedWidth: string;
-    /** Accessible label for the sidebar collapse action. */
-    collapseButtonLabel: string;
-    /** Accessible label for the sidebar expand action. */
-    expandButtonLabel: string;
     /** Names of AppSidebar passthrough slots the caller actually provided. */
     slotNames: string[];
 }

package/dist/composables/useApi.d.ts

@@ -17,8 +17,6 @@ export interface ApiClientOptions {
     baseUrl?: string;
     timeout?: number;
     withAuth?: boolean;
-    /** Normalize failed responses into MintApiError. Generated clients enable this by default. */
-    typedErrors?: boolean;
 }
 export interface UseApiReturn {
     client: AxiosInstance;
@@ -32,5 +30,5 @@ export interface UseApiReturn {
     buildUrl: (path: string) => string;
     buildWsUrl: (path: string) => string;
 }
-/** Axios-based API client that injects the plugin base URL and JWT auth header on every request. */
+/** Axios-based API client that injects the plugin base URL and JWT auth header on every request. A failed response rejects with a `MintApiError`. */
 export declare function useApi(options?: ApiClientOptions): UseApiReturn;

package/dist/composables/useAppExperiment.d.ts

@@ -27,7 +27,7 @@ export interface AppExperimentPopoverBinding {
     saveSuccessMessage?: string;
 }
 export interface AppExperimentSelectorModalBinding {
-    modelValue: boolean;
+    open: boolean;
     currentExperimentId: number | null;
 }
 export interface UseAppExperimentReturn {