@morscherlab/mint-sdk 1.2.0-beta.7 → 1.2.0-beta.9

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/index.d.ts

@@ -65,4 +65,5 @@ export { usePluginWorkspace, type PluginWorkspaceSlotsLike, type UsePluginWorksp
 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, 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 { r as useRequestSyncState } from "../EmptyState-NBqf2_8z.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-_OVhavKq.js";
-import { $ as useTheme, A as useFileImport, B as useDoseCalculator, D as detectDelimiter, F as extractSampleNamesFromDesignData, G as DEFAULT_MOBILE_VIEWPORT_QUERY, H as useJobsStatusTray, I as extractSampleOptionsFromDesignData, J as useAppExperiment, K as useMobileSupportGate, L as unwrapExperimentDesignData, M as extractSamplesFromDesignData, N as useAutoGroup, O as parseDelimitedText, Q as usePresenceHeartbeat, R as DEFAULT_COLORS, U as usePluginJobCenter, V as combinePluginJobSources, W as usePluginWorkspace, X as useRuntimeAlignment, Y as getInjectedFrontendRevision, Z as getPresenceClientId, _ as useScheduleDrag, a as useReagentSeries, at as useSortedItems, b as useExpansionSet, c as useBioTemplatePresetWorkspace, d as getBioTemplateComponentProps, et as useToast, f as toBioTemplateComponentPropsByComponent, g as useExperimentSave, h as useTemplateCollection, i as generateDilutionSeries, it as compareSortValues, j as validateImportFile, k as readFileAsText, l as useBioTemplatePackWorkspace, m as useBioTemplateControls, n as DEFAULT_PRESETS, nt as normalizeSearchQuery, o as useGroupAssignment, ot as useMenuKeyboard, p as useBioTemplateComponents, q as APP_EXPERIMENT_KEY, r as DEFAULT_UNITS, rt as useTextSearch, s as useRackEditor, st as useRovingFocus, t as useProtocolTemplates, tt as candidateMatchesSearch, u as useBioTemplateWorkspace, v as useExperimentSamples, x as useSampleGroups, y as useExperimentData, z as useWellPlateEditor } from "../useProtocolTemplates-Dq5Pzwyd.js";
-import { r as useApi, t as AuthenticationRequiredError } from "../useApi-CDBq6z23.js";
-import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-Bd714C7y.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-CK72aKO1.js";
-import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-DSEckf_g.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-C8mmD5ta.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, useFocusTrap, useForm, useFormBuilder, useGeneratedAnalysis, useGroupAssignment, useJobsStatusTray, useListSelection, useMenuKeyboard, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginEventStream, usePluginJobCenter, usePluginJobs, usePluginSettings, usePluginWorkspace, usePresenceHeartbeat, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useRovingFocus, 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/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/useListReorder.d.ts

@@ -0,0 +1,90 @@
+import { Ref } from 'vue';
+/** Inline style for a visually hidden `aria-live` region (no global utility class in the SDK). */
+export declare const REORDER_ANNOUNCER_STYLE: Readonly<{
+    position: "absolute";
+    width: "1px";
+    height: "1px";
+    padding: "0";
+    margin: "-1px";
+    overflow: "hidden";
+    clip: "rect(0, 0, 0, 0)";
+    whiteSpace: "nowrap";
+    border: "0";
+}>;
+export interface UseReorderAnnouncerReturn {
+    /** Bind to a polite live region's text content. */
+    announcement: Ref<string>;
+    /** Publishes a message to the live region. */
+    announce: (message: string) => void;
+    /** Bind to the live region's `style` so it stays visually hidden. */
+    announcerStyle: typeof REORDER_ANNOUNCER_STYLE;
+}
+/**
+ * Screen-reader announcements for drag/keyboard move interactions. Bind
+ * `announcement` to a `role="status" aria-live="polite"` element styled with
+ * `announcerStyle`.
+ */
+export declare function useReorderAnnouncer(): UseReorderAnnouncerReturn;
+export interface ListReorderMove<T> {
+    /** Index the item moved from, within `items()`. */
+    fromIndex: number;
+    /** Index the item moved to, within `items()`. */
+    toIndex: number;
+    /** The reordered array (a copy — `items()` is never mutated). */
+    items: T[];
+    /** Whether the move came from the keyboard or a pointer drag. */
+    source: 'keyboard' | 'drag';
+}
+export interface UseListReorderOptions<T> {
+    /** The list being reordered, in its canonical (not merely rendered) order. */
+    items: () => T[];
+    /** Stable id for an item; falls back to the render index when ids repeat. */
+    getId: (item: T, index: number) => string;
+    /** Applies the move. The composable never mutates the source array. */
+    onReorder: (move: ListReorderMove<T>) => void;
+    /** Human-readable name used in announcements. Defaults to the item's id. */
+    getLabel?: (item: T, index: number) => string;
+    /** Blocks every reorder while it returns `true` (readonly / non-sortable lists). */
+    disabled?: () => boolean;
+    /** Resolves the focusable element for an id so keyboard moves keep focus on the item. */
+    getElement?: (id: string) => HTMLElement | null | undefined;
+    /** Noun used in announcements, e.g. `'Reagent'`. Default `'Item'`. */
+    itemNoun?: string;
+}
+export interface UseListReorderReturn<T> {
+    /** Id of the item currently being dragged, or `null`. */
+    draggingId: Ref<string | null>;
+    /** Id of the item the pointer is hovering as a drop target, or `null`. */
+    dragOverId: Ref<string | null>;
+    isDragging: (id: string) => boolean;
+    isDragOver: (id: string) => boolean;
+    announcement: Ref<string>;
+    announcerStyle: typeof REORDER_ANNOUNCER_STYLE;
+    announce: (message: string) => void;
+    /** Bind to the draggable element's `@dragstart`. */
+    onDragStart: (event: DragEvent, item: T, index: number) => void;
+    /** Bind to `@dragover` — calls `preventDefault()` so the drop is accepted. */
+    onDragOver: (event: DragEvent, item: T, index: number) => void;
+    /** Bind to `@dragleave`. */
+    onDragLeave: () => void;
+    /** Bind to `@drop`. */
+    onDrop: (event: DragEvent, item: T, index: number) => void;
+    /** Bind to `@dragend`. */
+    onDragEnd: () => void;
+    /**
+     * Bind to the item's (or its drag handle's) `@keydown`: Alt+ArrowUp / Alt+ArrowLeft
+     * moves the item one position earlier, Alt+ArrowDown / Alt+ArrowRight one later.
+     */
+    onKeydown: (event: KeyboardEvent, item: T, index: number) => void;
+    /** Moves an item between two indices of `items()` programmatically. */
+    move: (fromIndex: number, toIndex: number, source?: 'keyboard' | 'drag') => void;
+}
+/** Pure helper: a copy of `items` with the entry at `from` moved to `to`. */
+export declare function reorderList<T>(items: T[], from: number, to: number): T[];
+/**
+ * Keyboard-accessible list reordering shared by the SDK's drag-to-reorder lists.
+ * It owns the HTML5 drag state, the drop-index maths, and an Alt+Arrow keyboard
+ * alternative that announces every move through a polite live region — so a
+ * reorder never depends on a pointer.
+ */
+export declare function useListReorder<T>(options: UseListReorderOptions<T>): UseListReorderReturn<T>;

package/dist/composables/useMenuKeyboard.d.ts

@@ -23,7 +23,7 @@ export interface UseMenuKeyboardReturn {
 }
 /**
  * Shared keyboard contract for menu- and listbox-style disclosure panels (the
- * WAI-ARIA menu button pattern). Used by AppAvatarMenu and DropdownButton; ActionMenu
- * implements the same contract inline.
+ * WAI-ARIA menu button pattern). Used by ActionMenu, AppAvatarMenu and DropdownButton,
+ * each pairing it with `useDropdownState` for the disclosure state itself.
  */
 export declare function useMenuKeyboard(options: UseMenuKeyboardOptions): UseMenuKeyboardReturn;

package/dist/composables/usePluginConfig.d.ts

@@ -21,5 +21,7 @@ export interface UsePluginConfigReturn {
     /** Restore the last loaded or saved configuration snapshot. */
     reset: () => void;
 }
-/** @deprecated Use `usePluginSettings()` for typed plugin settings. */
+/**
+ * @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `usePluginSettings()` for typed plugin settings.
+ */
 export declare function usePluginConfig(pluginName?: string): UsePluginConfigReturn;

package/dist/composables/useRequestSyncState.d.ts

@@ -1,8 +1,24 @@
 import { Ref } from 'vue';
 export type RequestSyncSuccessKind = 'load' | 'save' | 'run';
+/**
+ * The unit of work `run()` drives.
+ *
+ * It receives an `AbortSignal` that fires when the run is superseded by a
+ * newer `run()` or by `cancel()`. Zero-argument operations stay valid and
+ * simply ignore it.
+ */
+export type RequestSyncOperation<T> = (signal: AbortSignal) => Promise<T>;
 export interface RequestSyncRunOptions {
     success?: RequestSyncSuccessKind;
     errorMessage?: string;
+    /**
+     * Abort the previously started run when this one starts. Default `true`;
+     * pass `false` to let overlapping runs finish their own work (the stale
+     * guard on shared state still applies either way).
+     */
+    abortPrevious?: boolean;
+    /** Caller-owned signal; aborting it aborts this run's signal too. */
+    signal?: AbortSignal;
 }
 export interface UseRequestSyncStateReturn {
     /** Whether a request is in progress. */
@@ -27,8 +43,32 @@ export interface UseRequestSyncStateReturn {
     markSaved: (date?: Date) => void;
     /** Mark the operation as successfully run. */
     markRun: (date?: Date) => void;
-    /** Run a request with shared loading/error handling and optional sync marking. */
-    run: <T>(operation: () => Promise<T>, options?: RequestSyncRunOptions) => Promise<T>;
+    /**
+     * Run a request with shared loading/error handling and optional sync marking.
+     *
+     * ## Stale-response semantics
+     *
+     * Every call takes a monotonically increasing token. Starting a run
+     * supersedes any run started before it, and a superseded run writes **no**
+     * shared state when it finally settles: it does not clear `loading`, does not
+     * set `error`, and does not move `lastLoadedAt` / `lastSavedAt` / `lastRunAt`.
+     * Only the newest run owns those.
+     *
+     * The caller's own promise is untouched by the guard — a superseded run still
+     * resolves with its value or rejects with its own error, exactly as the
+     * operation did. The guard never invents a rejection, so a caller awaiting
+     * `run()` never sees a "superseded" error it did not cause.
+     *
+     * The operation additionally receives an `AbortSignal` that fires when its
+     * run is superseded or `cancel()` is called, so an operation that forwards
+     * the signal (`fetch(url, { signal })`) stops work instead of racing.
+     */
+    run: <T>(operation: RequestSyncOperation<T>, options?: RequestSyncRunOptions) => Promise<T>;
+    /**
+     * Abort the in-flight run and drop `loading`. The aborted run's completion
+     * is treated as stale and writes no state.
+     */
+    cancel: () => void;
 }
 /** Shared loading/error/timestamp state for generated plugin request helpers. */
 export declare function useRequestSyncState(defaultErrorMessage?: string): UseRequestSyncStateReturn;

package/dist/composables/useScheduleDrag.d.ts

@@ -75,4 +75,5 @@ export declare function useScheduleDrag(options: UseScheduleDragOptions): {
     startCreate: (date: Date, y: number, dayIndex: number) => void;
     startMove: (event: ScheduleEvent, y: number, dayIndex: number) => void;
     startResize: (event: ScheduleEvent, edge: "top" | "bottom", y: number, dayIndex: number) => void;
+    nudgeEvent: (event: ScheduleEvent, direction: -1 | 1, mode?: "move" | "resize") => boolean;
 };

package/dist/{composables-C8mmD5ta.js → composables-B_pia3hO.js}

@@ -1,7 +1,8 @@
-import { r as useRequestSyncState } from "./EmptyState-NBqf2_8z.js";
-import { B as currentExperimentFromContext, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, et as useEventStream, lt as PLUGIN_SECRET_FORMAT_KEY } from "./useControlSchema-_OVhavKq.js";
-import { i as useAuthStore, n as authenticationRequiredError, o as useSettingsStore, r as useApi, t as AuthenticationRequiredError } from "./useApi-CDBq6z23.js";
-import { i as usePlatformContext } from "./useFormBuilder-Bd714C7y.js";
+import { n as useRequestSyncState } from "./Skeleton-DxtwJ5gt.js";
+import { B as currentExperimentFromContext, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, et as useEventStream, lt as PLUGIN_SECRET_FORMAT_KEY } from "./useControlSchema-aMZlb4Sc.js";
+import { a as useAuthStore, d as useSettingsStore, i as useApi, n as AuthenticationRequiredError, r as authenticationRequiredError, t as readErrorMessage } from "./errors-_W0-LbA6.js";
+import { i as usePlatformContext } from "./useFormBuilder-TCxNnqeb.js";
+import { bn as rowLabel, pn as PLATE_CONFIGS, yn as rowIndex } from "./templates-Qq113pyZ.js";
 import { computed, getCurrentInstance, onMounted, onUnmounted, ref, shallowRef, toValue, watch } from "vue";
 import axios from "axios";
 //#region src/composables/useAuth.ts
@@ -637,7 +638,9 @@ function platformOwnedConfigPatch(config) {
 function responseConfigPayload(response) {
 	return response.config ?? response.settings ?? {};
 }
-/** @deprecated Use `usePluginSettings()` for typed plugin settings. */
+/**
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `usePluginSettings()` for typed plugin settings.
+*/
 function usePluginConfig(pluginName) {
 	const injectedContext = getInjectedPlatformContext();
 	const { plugin } = usePlatformContext();
@@ -887,7 +890,7 @@ function useOptimisticMutation(options) {
 			return result;
 		} catch (err) {
 			options.rollback?.(snapshot, variables, err);
-			error.value = options.readErrorMessage?.(err) ?? readErrorMessage$1(err);
+			error.value = options.readErrorMessage?.(err) ?? readErrorMessage(err);
 			options.onError?.(err, context);
 			throw err;
 		} finally {
@@ -906,12 +909,6 @@ function useOptimisticMutation(options) {
 		reset
 	};
 }
-function readErrorMessage$1(value) {
-	if (value instanceof Error && value.message) return value.message;
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "object" && value !== null && "message" in value && typeof value.message === "string" && value.message.trim()) return value.message;
-	return "Request failed.";
-}
 //#endregion
 //#region src/composables/useResourceCrud.ts
 /**
@@ -1046,45 +1043,8 @@ function resolveKey(keyOrItem, getKey) {
 	if (typeof keyOrItem === "string" || typeof keyOrItem === "number") return keyOrItem;
 	return getKey(keyOrItem);
 }
-function readErrorMessage(value) {
-	if (value instanceof Error && value.message) return value.message;
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "object" && value !== null && "message" in value && typeof value.message === "string" && value.message.trim()) return value.message;
-	return "Request failed.";
-}
 //#endregion
 //#region src/composables/useWellPainting.ts
-var ROW_LABELS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-var PLATE_DIMENSIONS = {
-	6: {
-		rows: 2,
-		cols: 3
-	},
-	12: {
-		rows: 3,
-		cols: 4
-	},
-	24: {
-		rows: 4,
-		cols: 6
-	},
-	48: {
-		rows: 6,
-		cols: 8
-	},
-	54: {
-		rows: 6,
-		cols: 9
-	},
-	96: {
-		rows: 8,
-		cols: 12
-	},
-	384: {
-		rows: 16,
-		cols: 24
-	}
-};
 /**
 * Pointer painting/rectangle selection state for WellPlate-based editors.
 *
@@ -1164,15 +1124,15 @@ function wellIdToCoordinate(wellId) {
 	const match = /^([A-Z]+)(\d+)$/i.exec(wellId.trim());
 	if (!match) return null;
 	return {
-		row: rowLabelToIndex$1(match[1].toUpperCase()),
+		row: rowIndex(match[1].toUpperCase()),
 		col: Number(match[2]) - 1
 	};
 }
 function coordinateToWellId(coord) {
-	return `${indexToRowLabel$1(coord.row)}${coord.col + 1}`;
+	return `${rowLabel(coord.row)}${coord.col + 1}`;
 }
 function wellIdsInRectangle(start, end, format) {
-	const dimensions = PLATE_DIMENSIONS[format];
+	const dimensions = PLATE_CONFIGS[format];
 	const minRow = Math.max(0, Math.min(start.row, end.row));
 	const maxRow = Math.min(dimensions.rows - 1, Math.max(start.row, end.row));
 	const minCol = Math.max(0, Math.min(start.col, end.col));
@@ -1184,22 +1144,6 @@ function wellIdsInRectangle(start, end, format) {
 	}));
 	return ids;
 }
-function rowLabelToIndex$1(label) {
-	let result = 0;
-	for (const char of label) result = result * 26 + (char.charCodeAt(0) - 64);
-	return result - 1;
-}
-function indexToRowLabel$1(index) {
-	if (index < 26) return ROW_LABELS[index];
-	let value = index + 1;
-	let label = "";
-	while (value > 0) {
-		value--;
-		label = ROW_LABELS[value % 26] + label;
-		value = Math.floor(value / 26);
-	}
-	return label;
-}
 //#endregion
 //#region src/composables/useWellPlateAdapter.ts
 /**
@@ -1948,4 +1892,4 @@ function useCurrentExperiment(options = {}) {
 //#endregion
 export { useAsync as A, createPluginResourceClient as C, buildAnalysisArtifactTargetQuery as D, useCommandHistory as E, resolvePluginFrontendBase as M, usePasskey as N, parseAnalysisArtifactTarget as O, useAuth as P, wellIdsInRectangle as S, useOptimisticMutation as T, createWellPlateWells as _, pluginFormDataFromPayload as a, useWellPainting as b, usePluginClient as c, buildPluginEndpointUrl as d, resolvePluginBaseUrl as f, createRowConditions as g, createColumnConditions as h, getPluginPageSelectorItems as i, useAsyncBatch as j, usePluginConfig as k, usePluginEventStream as l, useWellPlateValidation as m, downloadBlob as n, uploadPluginEndpoint as o, runWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, usePluginSettings as u, useWellPlateAdapter as v, useResourceCrud as w, wellIdToCoordinate as x, coordinateToWellId as y };
 
-//# sourceMappingURL=composables-C8mmD5ta.js.map
+//# sourceMappingURL=composables-B_pia3hO.js.map