@morscherlab/mint-sdk 1.3.11 → 1.4.0-beta.10

package/dist/composables/controlSchemaAdapters.d.ts

@@ -7,10 +7,10 @@ export declare function controlsToSidebarPanels(controls: ControlSchema, options
 /** Convert controls into a SettingsModal schema grouped by the same sections. */
 export declare function controlsToSettingsSchema(controls: ControlSchema, options?: ControlSchemaOptions): SettingsModalSchema;
 /** Convert controls into an AppTopBar settingsConfig object that passes compact controls through to SettingsModal. */
-export declare function controlsToTopBarSettingsConfig(controls: ControlSchema, options?: ControlSchemaOptions, config?: Omit<TopBarSettingsConfig, 'schema' | 'controls' | 'controlOptions'>): TopBarSettingsConfig;
+export declare function controlsToTopBarSettingsConfig(controls: ControlSchema, options?: ControlSchemaOptions, config?: Omit<TopBarSettingsConfig, 'spec'>): TopBarSettingsConfig;
 /** Return generated control view IDs that have at least one sidebar panel. */
 export declare function controlsToViewIds(controls: ControlSchema, options?: ControlSchemaOptions): string[];
-/** Return AppTopBar pillNav-compatible view items for switching generated control sidebars. */
+/** Return AppTopBar `spec.pills` view items for switching generated control sidebars. */
 export declare function controlsToViewItems(controls: ControlSchema, options?: ControlSchemaOptions): PillNavItem[];
 /** 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;
@@ -18,3 +18,29 @@ export declare function getDefaultControlView(controls: ControlSchema, options?:
 export declare function controlsToSectionFormSchema(controls: ControlSchema, sectionId: string, options?: ControlSchemaOptions): ControlFormSchema;
 /** Return headerless FormBuilder schemas keyed by section ID for AppSidebar auto-rendering. */
 export declare function controlsToSectionFormSchemas(controls: ControlSchema, options?: ControlSchemaOptions): Record<string, ControlFormSchema>;
+declare const CONTROL_TARGETS: {
+    readonly form: typeof controlsToFormSchema;
+    readonly sectionForm: typeof controlsToSectionFormSchema;
+    readonly sectionForms: typeof controlsToSectionFormSchemas;
+    readonly settings: typeof controlsToSettingsSchema;
+    readonly sidebarPanels: typeof controlsToSidebarPanels;
+    readonly topBarSettings: typeof controlsToTopBarSettingsConfig;
+    readonly viewIds: typeof controlsToViewIds;
+    readonly viewItems: typeof controlsToViewItems;
+};
+/** What `controlsTo()` can build from a control schema. */
+export type ControlsTarget = keyof typeof CONTROL_TARGETS;
+/**
+ * Build one target shape from a control schema: a FormBuilder schema (`form`,
+ * `sectionForm`, `sectionForms`), a settings modal schema (`settings`), sidebar
+ * panels (`sidebarPanels`), a top-bar settings config (`topBarSettings`) or the
+ * view list (`viewIds`, `viewItems`).
+ *
+ * @example
+ * ```ts
+ * const schema = controlsTo('form', controls)
+ * const section = controlsTo('sectionForm', controls, 'analysis')
+ * ```
+ */
+export declare function controlsTo<T extends ControlsTarget>(target: T, ...args: Parameters<(typeof CONTROL_TARGETS)[T]>): ReturnType<(typeof CONTROL_TARGETS)[T]>;
+export {};

package/dist/composables/controlSchemaDoseDesign.d.ts

@@ -8,7 +8,7 @@ export declare function defineWellPlateDoseControlProps<TValues extends Record<s
 /** 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.
+ * Return a complete PluginWorkspaceView sidebar model for WellPlate + DoseCalculator dose design.
  *
  * @example Recommended
  * ```ts

package/dist/composables/controlSchemaModel.d.ts

@@ -2,7 +2,7 @@ import { ControlModel, ControlModelBinding } from './controlSchemaTypes';
 export declare function isControlModelBinding<TBinding extends ControlModelBinding = ControlModelBinding>(model: unknown): model is TBinding;
 export declare function resolveControlModel(model: ControlModel | ControlModelBinding | undefined): ControlModelBinding | undefined;
 /**
- * Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars.
+ * Create a complete control model binding for FormBuilder, SettingsModal and the PluginWorkspaceView sidebar from a simple controls data model.
  *
  * @example Recommended
  * ```ts

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 {
@@ -44,6 +44,8 @@ export interface PluginContract {
     schemaVersion: 2;
     plugin: {
         name?: string;
+        displayName?: string;
+        subtitle?: string;
         packageName?: string;
         version?: string;
         description?: string;
@@ -82,11 +84,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 +104,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 +117,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 +133,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 +153,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 +170,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,11 @@
-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 { providePluginIdentity, type PluginIdentityContract } from './pluginIdentity';
+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/pluginIdentity.d.ts

@@ -0,0 +1,24 @@
+import { PluginContract } from './createClient';
+/** The `plugin` block of the generated contract (`./generated/mint-plugin`) that `providePluginIdentity` reads. */
+export interface PluginIdentityContract {
+    plugin: Pick<PluginContract['plugin'], 'name' | 'displayName' | 'subtitle' | 'description' | 'icon'>;
+}
+/** The seeded identity AppTopBar shows in standalone mode. Internal: not exported from the package. */
+export declare const pluginIdentity: {
+    readonly name?: string | undefined;
+    readonly subtitle?: string | undefined;
+    readonly icon?: string | undefined;
+};
+/**
+ * Seed the standalone AppTopBar with the plugin name, subtitle and icon. In integrated
+ * mode the platform supplies them. Explicit `title`/`subtitle` props and the `#icon` slot still win.
+ *
+ * @example
+ * ```typescript
+ * import { providePluginIdentity } from '@morscherlab/mint-sdk'
+ * import { contract } from './generated/mint-plugin'
+ *
+ * providePluginIdentity(contract)
+ * ```
+ */
+export declare function providePluginIdentity(contract: PluginIdentityContract): void;