@morscherlab/mint-sdk 1.2.0-beta.1 → 1.2.0-beta.11

package/dist/composables/controlSchemaTypes.d.ts

@@ -22,10 +22,27 @@ export interface ControlSectionConfig {
     actions?: SidebarToolSectionAction[];
     columns?: 1 | 2 | 3;
     condition?: FieldCondition;
+    /** The access policy. Preferred over the flat fields below. */
     access?: AccessPolicy;
+    /**
+     * @deprecated Since MINT 1.2; use `access.visibleFor` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     visibleFor?: AccessAudienceInput;
+    /**
+     * @deprecated Since MINT 1.2; use `access.requiresAdmin` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     requiresAdmin?: boolean;
+    /**
+     * @deprecated Since MINT 1.2; use `access.permissions` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     permissions?: readonly string[];
+    /**
+     * @deprecated Since MINT 1.2; use `access.anyPermissions` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     anyPermissions?: readonly string[];
     defaultOpen?: boolean;
     showToggle?: boolean;
@@ -78,10 +95,27 @@ export interface ControlDefinition {
     };
     validation?: FieldValidation;
     condition?: FieldCondition;
+    /** The access policy. Preferred over the flat fields below. */
     access?: AccessPolicy;
+    /**
+     * @deprecated Since MINT 1.2; use `access.visibleFor` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     visibleFor?: AccessAudienceInput;
+    /**
+     * @deprecated Since MINT 1.2; use `access.requiresAdmin` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     requiresAdmin?: boolean;
+    /**
+     * @deprecated Since MINT 1.2; use `access.permissions` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     permissions?: readonly string[];
+    /**
+     * @deprecated Since MINT 1.2; use `access.anyPermissions` instead. The flat
+     * duplicate is removed in 1.3.
+     */
     anyPermissions?: readonly string[];
     options?: readonly ControlOption[];
     section?: string;

package/dist/composables/flattenWorkspaceBindings.d.ts

@@ -0,0 +1,61 @@
+import { ComputedRef } from 'vue';
+import { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentPropsLookupOptions, BioTemplateComponentSnippet, BioTemplateComponentUsage } from './useBioTemplateComponents';
+/**
+ * The template-component slice of `UseBioTemplateWorkspaceReturn`: the ~9 keys every
+ * bio-template workspace composable (`useBioTemplateWorkspace`, `useBioTemplatePackWorkspace`,
+ * `useBioTemplatePresetWorkspace`) re-exposes verbatim from `useBioTemplateComponents()`.
+ */
+export interface BioTemplateWorkspaceComponentBindings {
+    componentBindings: BioTemplateComponentBinding[];
+    componentBindingsById: BioTemplateComponentBindingsById;
+    componentImports: BioTemplateComponentImport[];
+    componentProps: BioTemplateComponentPropsBinding[];
+    componentPropsById: BioTemplateComponentPropsById;
+    componentPropsByComponent: BioTemplateComponentPropsByComponent;
+    componentSnippets: BioTemplateComponentSnippet[];
+    componentUsage: BioTemplateComponentUsage | null;
+    getComponentProps: (component: string, options?: BioTemplateComponentPropsLookupOptions) => Record<string, unknown> | undefined;
+}
+/** Structural source shape accepted by {@link flattenWorkspaceComponentBindings}. */
+export interface BioTemplateWorkspaceComponentSource {
+    componentBindings: BioTemplateComponentBinding[];
+    componentBindingsById: BioTemplateComponentBindingsById;
+    componentImports: BioTemplateComponentImport[];
+    componentProps: BioTemplateComponentPropsBinding[];
+    componentPropsById: BioTemplateComponentPropsById;
+    componentPropsByComponent: BioTemplateComponentPropsByComponent;
+    componentSnippets: BioTemplateComponentSnippet[];
+    componentUsage: BioTemplateComponentUsage | null;
+    getComponentProps: (component: string, options?: BioTemplateComponentPropsLookupOptions) => Record<string, unknown> | undefined;
+}
+/**
+ * Pick the shared template-component binding keys off a resolved bio-template workspace
+ * (or its `components` source directly), so composables that build on `useBioTemplateWorkspace`
+ * spread one object instead of re-listing all 9 keys by hand.
+ *
+ * @example Recommended
+ * ```ts
+ * const bindings = { renderer, ...flattenWorkspaceComponentBindings(components) }
+ * ```
+ */
+export declare function flattenWorkspaceComponentBindings(source: BioTemplateWorkspaceComponentSource): BioTemplateWorkspaceComponentBindings;
+/** Keys of {@link BioTemplateWorkspaceComponentBindings} that are plain (non-reactive) values, lifted to `ComputedRef`s by {@link liftWorkspaceComponentBindings}. */
+export type LiftedBioTemplateWorkspaceComponentBindings = {
+    [K in Exclude<keyof BioTemplateWorkspaceComponentBindings, 'getComponentProps'>]: ComputedRef<BioTemplateWorkspaceComponentBindings[K]>;
+} & {
+    getComponentProps: BioTemplateWorkspaceComponentBindings['getComponentProps'];
+};
+/**
+ * `computed()`-lifted version of {@link flattenWorkspaceComponentBindings} for composables
+ * that hold their resolved workspace behind a `ComputedRef` (e.g. a regenerated workspace
+ * swapped in via `shallowRef`/`effectScope`), so each key stays independently reactive
+ * instead of forcing consumers to unwrap the whole workspace to read one field.
+ * `getComponentProps` stays a plain callable function, matching the un-lifted composables.
+ *
+ * @example Recommended
+ * ```ts
+ * const workspace = computed(() => workspaceRef.value)
+ * const { componentBindings, componentProps, getComponentProps } = liftWorkspaceComponentBindings(workspace)
+ * ```
+ */
+export declare function liftWorkspaceComponentBindings<TSource extends BioTemplateWorkspaceComponentSource>(workspace: ComputedRef<TSource>): LiftedBioTemplateWorkspaceComponentBindings;

package/dist/composables/index.d.ts

@@ -24,6 +24,7 @@ export { useDebouncedWatch, type DebouncedWatchCallback, type DebouncedWatchClea
 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 { usePluginConfig, type UsePluginConfigReturn } from './usePluginConfig';
 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';
@@ -58,5 +59,11 @@ export { getBioTemplateComponentProps, getBioTemplateComponentBindings, toBioTem
 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, 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, type CombinedPluginJobCenterSource, type PluginJobCenterSource, type JobsStatusTrayTab, type UsePluginJobCenterOptions, type UsePluginJobCenterReturn, } from './useJobsStatusTray';
+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 { 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';

package/dist/composables/index.js

@@ -1,11 +1,11 @@
-import { a as SORT_OPTIONS, c as formatExperimentDate, d as resolveExperimentCode, i as EXPERIMENT_STATUS_VARIANT_MAP, l as formatExperimentStatus, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, p as useEventListener, r as EXPERIMENT_STATUS_OPTIONS, s as experimentIdFromRoute, t as DATE_PRESET_OPTIONS, u as getExperimentStatusVariant } from "../experiment-utils-CLnzPPq5.js";
-import { r as useRequestSyncState } from "../EmptyState-p90quq8Z.js";
-import { A as useConcentrationUnits, C as controlsToViewIds, Ct as useTimeUtils, D as getTypeDefault, Dt as useSelectionLimit, E as getFieldRegistryEntry, Et as useListSelection, F as ATOMIC_WEIGHTS, G as createGeneratedAnalysisTransport, I as useChemicalFormula, K as useGeneratedAnalysis, N as useSequenceUtils, S as controlsToTopBarSettingsConfig, St as toMinutes, T as getDefaultControlView, W as resolveCurrentPluginId, _ as controlsToFormSchema, _t as generateTimeSlots, a as defineDoseCalculatorControlProps, b as controlsToSettingsSchema, bt as rangesOverlap, c as defineWellPlateDoseComponentBindings, ct as addMinutes, d as defineControlModel, dt as findAvailableSlots, ft as findNearestTimeSlotIndex, gt as fromMinutes, h as controlValuesToComponentProps, ht as formatTimeSlot, i as useControlSchema, l as defineWellPlateDoseControlProps, lt as compareTime, m as controlValuesToComponentBindingsById, mt as formatTime, n as defineControls, o as defineDoseDesignControlModel, p as controlValuesToComponentBindings, pt as formatDuration, q as usePluginJobs, r as getControlDefaults, s as defineWellPlateControlProps, t as defineControlComponentBindings, u as useControlWorkspace, ut as durationMinutes, v as controlsToSectionFormSchema, vt as isTimeInRange, w as controlsToViewItems, x as controlsToSidebarPanels, xt as snapToSlot, y as controlsToSectionFormSchemas, yt as parseTime, z as useAnalysisArtifacts } from "../useControlSchema-BDx2Olha.js";
-import { $ as candidateMatchesSearch, A as useFileImport, B as useDoseCalculator, D as detectDelimiter, F as extractSampleNamesFromDesignData, G as APP_EXPERIMENT_KEY, H as usePluginJobCenter, I as extractSampleOptionsFromDesignData, J as useRuntimeAlignment, K as useAppExperiment, L as unwrapExperimentDesignData, M as extractSamplesFromDesignData, N as useAutoGroup, O as parseDelimitedText, Q as useToast, R as DEFAULT_COLORS, U as DEFAULT_MOBILE_VIEWPORT_QUERY, V as combinePluginJobSources, W as useMobileSupportGate, X as usePresenceHeartbeat, Y as getPresenceClientId, Z as useTheme, _ as useScheduleDrag, a as useReagentSeries, b as useExpansionSet, c as useBioTemplatePresetWorkspace, d as getBioTemplateComponentProps, et as normalizeSearchQuery, f as toBioTemplateComponentPropsByComponent, g as useExperimentSave, h as useTemplateCollection, i as generateDilutionSeries, j as validateImportFile, k as readFileAsText, l as useBioTemplatePackWorkspace, m as useBioTemplateControls, n as DEFAULT_PRESETS, nt as compareSortValues, o as useGroupAssignment, p as useBioTemplateComponents, q as getInjectedFrontendRevision, r as DEFAULT_UNITS, rt as useSortedItems, s as useRackEditor, t as useProtocolTemplates, tt as useTextSearch, u as useBioTemplateWorkspace, v as useExperimentSamples, x as useSampleGroups, y as useExperimentData, z as useWellPlateEditor } from "../useProtocolTemplates-CS_SQl6U.js";
-import { r as useApi, t as AuthenticationRequiredError } from "../useApi-J6zFkHmn.js";
-import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-BLxG3BOX.js";
+import { a as SORT_OPTIONS, c as formatExperimentDate, d as resolveExperimentCode, i as EXPERIMENT_STATUS_VARIANT_MAP, l as formatExperimentStatus, m as useEventListener, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, p as useFocusTrap, r as EXPERIMENT_STATUS_OPTIONS, s as experimentIdFromRoute, t as DATE_PRESET_OPTIONS, u as getExperimentStatusVariant } from "../experiment-utils-DV3DrvE_.js";
+import { n as useRequestSyncState } from "../Skeleton-DxtwJ5gt.js";
+import { A as useConcentrationUnits, At as formatTimeSlot, C as controlsToViewIds, Ct as addMinutes, D as getTypeDefault, Dt as findNearestTimeSlotIndex, E as getFieldRegistryEntry, Et as findAvailableSlots, F as ATOMIC_WEIGHTS, Ft as rangesOverlap, G as createGeneratedAnalysisTransport, Ht as useSelectionLimit, I as useChemicalFormula, It as snapToSlot, K as useGeneratedAnalysis, Lt as toMinutes, Mt as generateTimeSlots, N as useSequenceUtils, Nt as isTimeInRange, Ot as formatDuration, Pt as parseTime, Rt as useTimeUtils, S as controlsToTopBarSettingsConfig, T as getDefaultControlView, Tt as durationMinutes, Vt as useListSelection, W as resolveCurrentPluginId, _ as controlsToFormSchema, a as defineDoseCalculatorControlProps, b as controlsToSettingsSchema, c as defineWellPlateDoseComponentBindings, d as defineControlModel, h as controlValuesToComponentProps, i as useControlSchema, jt as fromMinutes, kt as formatTime, l as defineWellPlateDoseControlProps, m as controlValuesToComponentBindingsById, n as defineControls, o as defineDoseDesignControlModel, p as controlValuesToComponentBindings, q as usePluginJobs, r as getControlDefaults, s as defineWellPlateControlProps, t as defineControlComponentBindings, u as useControlWorkspace, v as controlsToSectionFormSchema, w as controlsToViewItems, wt as compareTime, x as controlsToSidebarPanels, y as controlsToSectionFormSchemas, z as useAnalysisArtifacts } from "../useControlSchema-aMZlb4Sc.js";
+import { $ as usePresenceHeartbeat, A as useAutoGroup, B as useReorderAnnouncer, D as useFileImport, E as readFileAsText, F as DEFAULT_COLORS, G as usePluginWorkspace, H as combinePluginJobSources, I as useWellPlateEditor, J as APP_EXPERIMENT_KEY, K as DEFAULT_MOBILE_VIEWPORT_QUERY, L as REORDER_ANNOUNCER_STYLE, M as extractSampleNamesFromDesignData, N as extractSampleOptionsFromDesignData, O as validateImportFile, P as unwrapExperimentDesignData, Q as getPresenceClientId, R as reorderList, T as parseDelimitedText, U as useJobsStatusTray, V as useDoseCalculator, W as usePluginJobCenter, X as getInjectedFrontendRevision, Y as useAppExperiment, Z as useRuntimeAlignment, _ as useScheduleDrag, a as useReagentSeries, at as compareSortValues, b as useExpansionSet, c as useBioTemplatePresetWorkspace, ct as useRovingFocus, d as getBioTemplateComponentProps, et as useTheme, f as toBioTemplateComponentPropsByComponent, g as useExperimentSave, h as useTemplateCollection, i as generateDilutionSeries, it as useTextSearch, k as extractSamplesFromDesignData, l as useBioTemplatePackWorkspace, m as useBioTemplateControls, n as DEFAULT_PRESETS, nt as candidateMatchesSearch, o as useGroupAssignment, ot as useSortedItems, p as useBioTemplateComponents, q as useMobileSupportGate, r as DEFAULT_UNITS, rt as normalizeSearchQuery, s as useRackEditor, st as useMenuKeyboard, t as useProtocolTemplates, tt as useToast, u as useBioTemplateWorkspace, v as useExperimentSamples, w as detectDelimiter, x as useSampleGroups, y as useExperimentData, z as useListReorder } from "../useProtocolTemplates-BmX_iVBR.js";
+import { i as useApi, n as AuthenticationRequiredError } from "../errors-_W0-LbA6.js";
+import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-TCxNnqeb.js";
 import { t as ANALYSIS_FILE_ARTIFACT_SCHEMA } from "../analysisArtifactTypes-DQ0MjwHZ.js";
-import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-DsP51i-S.js";
-import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-CV4iNfMS.js";
-import { A as resolvePluginFrontendBase, C as useResourceCrud, D as parseAnalysisArtifactTarget, E as buildAnalysisArtifactTargetQuery, M as useAuth, O as useAsync, S as createPluginResourceClient, T as useCommandHistory, _ as useWellPlateAdapter, a as pluginFormDataFromPayload, b as wellIdToCoordinate, c as usePluginEventStream, d as resolvePluginBaseUrl, f as runWellPlateValidation, g as createWellPlateWells, h as createRowConditions, i as getPluginPageSelectorItems, j as usePasskey, k as useAsyncBatch, l as usePluginSettings, m as createColumnConditions, n as downloadBlob, o as uploadPluginEndpoint, p as useWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as buildPluginEndpointUrl, v as coordinateToWellId, w as useOptimisticMutation, x as wellIdsInRectangle, y as useWellPainting } from "../composables-C_i90sGS.js";
-export { ANALYSIS_FILE_ARTIFACT_SCHEMA, APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, AuthenticationRequiredError, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_MOBILE_VIEWPORT_QUERY, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildAnalysisArtifactTargetQuery, buildPluginEndpointUrl, candidateMatchesSearch, combinePluginJobSources, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createGeneratedAnalysisTransport, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, experimentIdFromRoute, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getInjectedFrontendRevision, getPluginPageSelectorItems, getPresenceClientId, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseAnalysisArtifactTarget, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, requireBioTemplateControlSchema, resolveCurrentPluginId, resolveExperimentCode, resolvePluginBaseUrl, resolvePluginFrontendBase, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useAnalysisArtifacts, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useForm, useFormBuilder, useGeneratedAnalysis, useGroupAssignment, useListSelection, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginEventStream, usePluginJobCenter, usePluginJobs, usePluginSettings, usePresenceHeartbeat, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useRuntimeAlignment, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };
+import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-Qq113pyZ.js";
+import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-I8HC8hUu.js";
+import { A as useAsync, C as createPluginResourceClient, D as buildAnalysisArtifactTargetQuery, E as useCommandHistory, M as resolvePluginFrontendBase, N as usePasskey, O as parseAnalysisArtifactTarget, P as useAuth, S as wellIdsInRectangle, T as useOptimisticMutation, _ as createWellPlateWells, a as pluginFormDataFromPayload, b as useWellPainting, c as usePluginClient, d as buildPluginEndpointUrl, f as resolvePluginBaseUrl, g as createRowConditions, h as createColumnConditions, i as getPluginPageSelectorItems, j as useAsyncBatch, k as usePluginConfig, l as usePluginEventStream, m as useWellPlateValidation, n as downloadBlob, o as uploadPluginEndpoint, p as runWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as usePluginSettings, v as useWellPlateAdapter, w as useResourceCrud, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-B_pia3hO.js";
+export { ANALYSIS_FILE_ARTIFACT_SCHEMA, APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, AuthenticationRequiredError, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_MOBILE_VIEWPORT_QUERY, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, REORDER_ANNOUNCER_STYLE, SORT_OPTIONS, addMinutes, buildAnalysisArtifactTargetQuery, buildPluginEndpointUrl, candidateMatchesSearch, combinePluginJobSources, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createGeneratedAnalysisTransport, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, experimentIdFromRoute, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getInjectedFrontendRevision, getPluginPageSelectorItems, getPresenceClientId, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseAnalysisArtifactTarget, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, reorderList, requireBioTemplateControlSchema, resolveCurrentPluginId, resolveExperimentCode, resolvePluginBaseUrl, resolvePluginFrontendBase, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useAnalysisArtifacts, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useFocusTrap, useForm, useFormBuilder, useGeneratedAnalysis, useGroupAssignment, useJobsStatusTray, useListReorder, useListSelection, useMenuKeyboard, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginEventStream, usePluginJobCenter, usePluginJobs, usePluginSettings, usePluginWorkspace, usePresenceHeartbeat, useProtocolTemplates, useRackEditor, useReagentSeries, useReorderAnnouncer, useRequestSyncState, useResourceCrud, useRovingFocus, useRuntimeAlignment, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };

package/dist/composables/pluginWorkspaceModel.d.ts

@@ -0,0 +1,164 @@
+import { AccountMenuItem, PageSelectorItemInput, PillNavItemInput, PluginSwitcherInfo, SidebarToolSection, TopBarSettingsConfig, TopBarVariant } from '../types';
+import { FormEnhancements, FormSchema } from '../types/form-builder';
+import { ControlComponentBinding, ControlComponentBindingsById, ControlModel, ControlModelBinding, ControlSchema, ControlWorkspaceOptions } from './useControlSchema';
+import { PluginWorkspaceSidebarVariant } from '../components/PluginWorkspaceView.props';
+/**
+ * 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
+ * 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`. */
+    setActiveView: (viewId: string) => void;
+    /** Current control values, shared between the auto-rendered sidebar form and the default slot. */
+    values: Record<string, unknown>;
+    /** Ordered SDK component bindings resolved from the current control values. */
+    componentBindings: ControlComponentBinding[];
+    /** SDK component bindings resolved from the current control values, keyed by binding id. */
+    componentBindingsById: ControlComponentBindingsById;
+    /** Flat component props resolved from the current control values. */
+    componentProps: Record<string, unknown>;
+    /** Named component prop mappings resolved from the current control values. */
+    componentPropsById: Record<string, Record<string, unknown>>;
+}
+/**
+ * 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.
+ */
+export interface PluginWorkspaceShellModel {
+    /** AppLayout sidebar position. */
+    sidebarPosition: 'left' | 'right';
+    /** AppLayout sidebar width, forwarded so the layout can reserve space before AppSidebar mounts. */
+    sidebarWidth?: string;
+    /** AppLayout floating style. */
+    floating: boolean;
+    /** Convert the sidebar into an SDK-owned mobile overlay below the AppLayout breakpoint. */
+    responsiveSidebar: boolean;
+    /** Accessible label for the mobile sidebar toggle. */
+    sidebarToggleLabel: string;
+    /** Accessible label used when the mobile sidebar is open. */
+    sidebarCloseLabel: string;
+    /** Whether AppLayout should render a `#sidebar` template at all. */
+    hasSidebarSurface: boolean;
+    /** App or plugin title shown in the top bar. */
+    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;
+    /** Optional plugin switcher shown in the left navigation position. */
+    pluginSwitcher?: PluginSwitcherInfo;
+    /** Resolved centered pill navigation, generated from the control schema when omitted. */
+    pillNav?: PillNavItemInput[];
+    /** 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;
+    /** 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.
+ */
+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;
+    /** AppSidebar visual preset. */
+    variant: PluginWorkspaceSidebarVariant;
+    /** Map of view IDs to sidebar tool sections. */
+    panels: Record<string, SidebarToolSection[]>;
+    /** 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;
+    /** 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/useAsync.d.ts

@@ -100,7 +100,11 @@ export interface UseAsyncOptions<T> {
  * const handleSubmit = () => submit(new FormData(formRef.value))
  * ```
  */
-/** Wraps an async function with reactive loading, error, and success state plus optional auto-execute. */
+/**
+ * Wraps an async function with reactive loading, error, and success state plus optional auto-execute.
+ *
+ * @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useRequestSyncState()` instead.
+ */
 export declare function useAsync<T>(asyncFn: (...args: unknown[]) => Promise<T>, options?: UseAsyncOptions<T>): UseAsyncReturn<T>;
 /**
  * Create a batch of async operations that can be executed in parallel.

package/dist/composables/useBioTemplateWorkspace.d.ts

@@ -1,28 +1,21 @@
 import { BioTemplateEnvelope, TemplateCollectionEnvelope } from '../templates';
 import { ControlWorkspaceFormBinding, ControlWorkspaceOptions, ControlWorkspacePillNavBinding, ControlWorkspaceSidebarBinding, ControlWorkspaceTopBarSettingsBinding, UseControlSchemaReturn, UseControlWorkspaceReturn } from './controlSchemaTypes';
 import { BioTemplateControlSchema, BioTemplateControlTarget } from './useBioTemplateControls';
-import { BioTemplateComponentBinding, BioTemplateComponentBindingsById, BioTemplateComponentImport, BioTemplateComponentPropsByComponent, BioTemplateComponentPropsBinding, BioTemplateComponentPropsById, BioTemplateComponentSnippet, BioTemplateComponentUsage, UseBioTemplateComponentsReturn } from './useBioTemplateComponents';
+import { UseBioTemplateComponentsReturn } from './useBioTemplateComponents';
+import { BioTemplateWorkspaceComponentBindings } from './flattenWorkspaceBindings';
 export type BioTemplateWorkspaceTarget = BioTemplateControlTarget;
 export interface BioTemplateRendererBinding {
     target: BioTemplateEnvelope<unknown> | TemplateCollectionEnvelope;
 }
-export interface BioTemplateWorkspaceBindings {
+export interface BioTemplateWorkspaceBindings extends BioTemplateWorkspaceComponentBindings {
     renderer: BioTemplateRendererBinding | null;
     form: ControlWorkspaceFormBinding;
     sidebar: ControlWorkspaceSidebarBinding;
     topBar: UseControlWorkspaceReturn<BioTemplateControlSchema>['bindings']['topBar'];
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     pillNav: ControlWorkspacePillNavBinding;
-    componentBindings: BioTemplateComponentBinding[];
-    componentBindingsById: BioTemplateComponentBindingsById;
-    componentProps: BioTemplateComponentPropsBinding[];
-    componentPropsById: BioTemplateComponentPropsById;
-    componentPropsByComponent: BioTemplateComponentPropsByComponent;
-    componentSnippets: BioTemplateComponentSnippet[];
-    componentUsage: BioTemplateComponentUsage | null;
-    getComponentProps: UseBioTemplateComponentsReturn['getComponentProps'];
 }
-export interface UseBioTemplateWorkspaceReturn {
+export interface UseBioTemplateWorkspaceReturn extends BioTemplateWorkspaceComponentBindings {
     target: BioTemplateWorkspaceTarget;
     controls: UseControlSchemaReturn<BioTemplateControlSchema>;
     workspace: UseControlWorkspaceReturn<BioTemplateControlSchema>;
@@ -37,15 +30,6 @@ export interface UseBioTemplateWorkspaceReturn {
     topBarSettings: ControlWorkspaceTopBarSettingsBinding;
     bindings: BioTemplateWorkspaceBindings;
     renderer: BioTemplateRendererBinding | null;
-    componentBindings: BioTemplateComponentBinding[];
-    componentBindingsById: BioTemplateComponentBindingsById;
-    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/useCommandHistory.d.ts

@@ -25,5 +25,9 @@ export interface UseCommandHistoryReturn<TCommand extends CommandHistoryCommand
     redo: () => CommandHistoryResult;
     clear: () => void;
 }
-/** Generic command-stack state for plugin editors with undo/redo controls. */
+/**
+ * Generic command-stack state for plugin editors with undo/redo controls.
+ *
+ * @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; keep command stacks plugin-local.
+ */
 export declare function useCommandHistory<TCommand extends CommandHistoryCommand = CommandHistoryCommand>(options?: UseCommandHistoryOptions): UseCommandHistoryReturn<TCommand>;

package/dist/composables/useDropdownState.d.ts

@@ -2,18 +2,34 @@ import { Ref } from 'vue';
 export interface UseDropdownStateOptions {
     closeOnOutsideClick?: boolean;
     closeOnEscape?: boolean;
+    /** Close the panel when the page scrolls or the viewport resizes. Default `false`. */
+    closeOnScroll?: boolean;
     insideRefs?: Array<Ref<HTMLElement | null>>;
+    /**
+     * Element focus returns to when the panel closes with `close(true)` (Escape).
+     * Pass one when the trigger lives outside `rootRef`; otherwise bind the
+     * returned `triggerRef` to the trigger element.
+     */
+    triggerRef?: Ref<HTMLElement | null>;
     onOpen?: () => void;
     onClose?: () => void;
 }
 export interface UseDropdownStateReturn {
     isOpen: Ref<boolean>;
     rootRef: Ref<HTMLElement | null>;
+    /** Bind to the trigger element so Escape can return focus to it. */
+    triggerRef: Ref<HTMLElement | null>;
     open: () => void;
-    close: () => void;
+    /** Closes the panel; `returnFocus` moves focus back to `triggerRef`. */
+    close: (returnFocus?: boolean) => void;
     toggle: () => void;
     handleClickOutside: (event: MouseEvent) => void;
     handleKeydown: (event: KeyboardEvent) => void;
 }
-/** Shared disclosure state for dropdown-style SDK components. */
+/**
+ * Shared disclosure state for dropdown-style SDK components: open/close state,
+ * outside-click and Escape closing, optional scroll/resize closing, and focus
+ * return to the trigger. `close(returnFocus)` mirrors `useMenuKeyboard`'s
+ * contract, so the two compose directly.
+ */
 export declare function useDropdownState(options?: UseDropdownStateOptions): UseDropdownStateReturn;

package/dist/composables/useEventStream.d.ts

@@ -12,7 +12,16 @@ export interface EventStreamOptions<TData = string> {
     headers?: HeadersInit;
     credentials?: RequestCredentials;
     immediate?: boolean;
+    /**
+     * Reconnect after a dropped stream. Left unset, it follows the platform's
+     * `wsAutoReconnect` setting, defaulting to `true` without a settings store.
+     */
     reconnect?: boolean;
+    /**
+     * Delay before the first reconnect attempt. Left unset, it follows the
+     * platform's `wsReconnectInterval` setting, defaulting to 2000 ms without a
+     * settings store. A server-sent `retry:` field still overrides it.
+     */
     reconnectDelayMs?: number;
     parseJson?: boolean;
     shouldReconnect?: (cause?: unknown) => boolean;

package/dist/composables/useFocusTrap.d.ts

@@ -0,0 +1,21 @@
+import { Ref } from 'vue';
+export interface UseFocusTrapOptions {
+    /** Ref to the trap's container element. Focusable elements are queried within it. */
+    containerRef: Ref<HTMLElement | null>;
+    /** Reactive flag — the trap activates when this becomes `true` and releases when it becomes `false`. */
+    active: Ref<boolean>;
+    /** Restore focus to the element that was focused before activation, when the trap releases. Default `true`. */
+    restoreFocus?: boolean;
+}
+export interface UseFocusTrapReturn {
+    /** Focusable descendants of the container, in DOM order, excluding roving-tabindex (`tabindex="-1"`) elements. */
+    getFocusableElements: () => HTMLElement[];
+}
+/**
+ * Traps Tab focus within a container while `active` is true: Tab wraps from the last
+ * focusable element back to the first (and Shift+Tab from the first to the last), the
+ * first focusable element (or the container itself, if none) receives focus when the
+ * trap activates, and focus returns to whatever was focused beforehand when it releases.
+ * Used by BaseModal and WellEditPopupInternal.
+ */
+export declare function useFocusTrap(options: UseFocusTrapOptions): UseFocusTrapReturn;

package/dist/composables/useGeneratedAnalysis.d.ts

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref, ShallowRef } from 'vue';
-import { PluginJobCenterSource } from './useJobsStatusTray';
+import { JobsStatusTrayAdapter, PluginJobCenterSource } from './useJobsStatusTray';
 import { GeneratedAnalysisJob, GeneratedAnalysisResult, GeneratedSession, GeneratedAnalysisManifest, PluginJobPathInput, PluginJobPathUpload, PluginJobStagedPartInput, PluginJobStagedPartUploadResult, PluginJobStaging, PluginJobStagingPagination } from '../types/generated-ui';
 export type GeneratedAnalysisTransport = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 export interface GeneratedAnalysisTransportOptions {
@@ -53,6 +53,8 @@ export interface UsePluginJobsReturn extends PluginJobCenterSource {
     pause: () => void;
     resume: () => void;
     dispose: () => void;
+    /** @deprecated Pass the runtime itself to SDK job UI as its source. */
+    jobsAdapter: JobsStatusTrayAdapter;
 }
 export type UseGeneratedAnalysisReturn = UsePluginJobsReturn;
 export declare function createGeneratedAnalysisTransport(options?: GeneratedAnalysisTransportOptions): GeneratedAnalysisTransport;

package/dist/composables/useJobsStatusTray.d.ts

@@ -1,5 +1,6 @@
 import { ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
-import { JobListPayload, JobState, JobStateInput } from '../types/jobs';
+import { JobListPayload, JobState, JobStateInput, JobStreamData } from '../types/jobs';
+import { UsePluginEventStreamReturn } from './usePluginClient';
 export type JobsStatusTrayTab = 'active' | 'history';
 /**
  * The canonical owner of a collection of plugin jobs.
@@ -26,10 +27,29 @@ export interface CombinedPluginJobCenterSource extends PluginJobCenterSource {
  * dispatching a mutation to the wrong owner.
  */
 export declare function combinePluginJobSources(sources: readonly PluginJobCenterSource[]): CombinedPluginJobCenterSource;
+/** @deprecated Prefer a {@link PluginJobCenterSource}. */
+export interface JobsStatusTrayAdapter {
+    listJobs?: () => Promise<JobListPayload | readonly JobStateInput[]>;
+    cancelJob?: (job: JobState) => Promise<JobStateInput | void>;
+    deleteJob?: (job: JobState) => Promise<boolean | void>;
+    clearFinishedJobs?: (jobs: readonly JobState[]) => Promise<number | void>;
+}
 export interface UsePluginJobCenterOptions {
     source?: MaybeRefOrGetter<PluginJobCenterSource | undefined>;
+    /** @deprecated Pass a source with its canonical jobs ref. */
+    jobs?: MaybeRefOrGetter<readonly JobStateInput[] | undefined>;
+    /** @deprecated Pass source actions instead. */
+    adapter?: MaybeRefOrGetter<JobsStatusTrayAdapter | undefined>;
+    /** @deprecated Event handling belongs to the source runtime. */
+    eventStream?: MaybeRefOrGetter<UsePluginEventStreamReturn<JobStreamData> | undefined>;
     loadOnMount?: boolean;
 }
+export interface UseJobsStatusTrayOptions extends UsePluginJobCenterOptions {
+}
+export interface JobStreamMessage {
+    event: string;
+    data: JobStreamData;
+}
 export interface UsePluginJobCenterReturn {
     jobs: ComputedRef<JobState[]>;
     activeJobs: ComputedRef<JobState[]>;
@@ -49,11 +69,13 @@ export interface UsePluginJobCenterReturn {
     close: () => void;
     toggle: () => void;
     refresh: () => Promise<boolean>;
+    applyStreamMessage: (message: JobStreamMessage) => void;
     cancelJob: (job: JobState) => Promise<boolean>;
     deleteJob: (job: JobState) => Promise<boolean>;
     clearFinished: () => Promise<boolean>;
     isPending: (job: JobState) => boolean;
 }
+export type UseJobsStatusTrayReturn = UsePluginJobCenterReturn;
 /**
  * Headless controller for plugin job presentation and actions.
  *
@@ -61,3 +83,5 @@ export interface UsePluginJobCenterReturn {
  * source. The controller never mirrors source jobs into another ref.
  */
 export declare function usePluginJobCenter(options?: UsePluginJobCenterOptions): UsePluginJobCenterReturn;
+/** @deprecated Use `usePluginJobCenter()` for the plugin job-center controller. */
+export declare function useJobsStatusTray(options?: UseJobsStatusTrayOptions): UseJobsStatusTrayReturn;