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

package/dist/components/ExperimentDataViewer.vue.d.ts

@@ -10,11 +10,29 @@ interface Props {
     pluginRoutePrefix?: string;
     experimentId?: number;
     loading?: boolean;
+    /**
+     * Error message. When set (or when the auto-fetch fails), the content area
+     * renders an error state instead of the data views.
+     */
+    error?: string | null;
     downloadJsonUrl?: string;
     downloadCsvUrl?: string;
     autoFetch?: boolean;
 }
-declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "open-plugin": () => any;
     "download-json": () => any;
     "download-csv": () => any;
@@ -23,9 +41,16 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     "onDownload-json"?: (() => any) | undefined;
     "onDownload-csv"?: (() => any) | undefined;
 }>, {
+    error: string | null;
     title: string;
     loading: boolean;
     defaultView: "summary" | "tree" | "table";
     autoFetch: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ExperimentPopover.vue.d.ts

@@ -33,5 +33,6 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     confirmSave: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     popoverRef: HTMLDivElement;
+    triggerRef: HTMLButtonElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/ExperimentTimeline.vue.d.ts

@@ -10,8 +10,28 @@ interface Props {
     size?: 'sm' | 'md' | 'lg';
     colorByStatus?: boolean;
     colorByType?: boolean;
+    /** Replace the timeline with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the timeline is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
 }
-declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (steps: ProtocolStep[]) => any;
     "step-click": (step: ProtocolStep) => any;
     "step-expand": (stepId: string | undefined) => any;
@@ -30,8 +50,10 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     "onStep-reorder"?: ((stepId: string, newOrder: number) => any) | undefined;
     "onStep-status-change"?: ((stepId: string, status: ProtocolStepStatus) => any) | undefined;
 }>, {
+    error: string | null;
     size: "sm" | "md" | "lg";
     modelValue: ProtocolStep[];
+    loading: boolean;
     orientation: "horizontal" | "vertical";
     collapsible: boolean;
     editable: boolean;
@@ -41,4 +63,10 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     colorByStatus: boolean;
     colorByType: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FitPanel.vue.d.ts

@@ -30,9 +30,9 @@ declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {},
 }>, {
     disabled: boolean;
     progress: number;
+    state: FitState;
     results: FitResultSummary[];
     indeterminate: boolean;
-    state: FitState;
     cancelLabel: string;
     progressLabel: string;
     runLabel: string;

package/dist/components/JobsStatusTray.vue.d.ts

@@ -1,7 +1,14 @@
-import { PluginJobCenterSource } from '../composables/useJobsStatusTray';
-import { JobState } from '../types/jobs';
+import { JobsStatusTrayAdapter, PluginJobCenterSource } from '../composables/useJobsStatusTray';
+import { UsePluginEventStreamReturn } from '../composables/usePluginClient';
+import { JobState, JobStateInput, JobStreamData } from '../types/jobs';
 interface Props {
     source?: PluginJobCenterSource;
+    /** @deprecated Pass a source instead. */
+    jobs?: readonly JobStateInput[];
+    /** @deprecated Pass source actions instead. */
+    adapter?: JobsStatusTrayAdapter;
+    /** @deprecated Event streams belong to the source runtime. */
+    eventStream?: UsePluginEventStreamReturn<JobStreamData>;
     loadOnMount?: boolean;
     title?: string;
     teleportTo?: string | HTMLElement | false;

package/dist/components/LcmsSequenceTable.vue.d.ts

@@ -6,8 +6,28 @@ interface Props {
     maxRows?: number;
     showMoreLabel?: boolean;
     emptyMessage?: string;
+    /** Replace the table with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the table is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
 }
-declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     remove: (index: number) => any;
     reorder: (fromIndex: number, toIndex: number) => any;
     duplicate: (index: number) => any;
@@ -16,6 +36,8 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     onReorder?: ((fromIndex: number, toIndex: number) => any) | undefined;
     onDuplicate?: ((index: number) => any) | undefined;
 }>, {
+    error: string | null;
+    loading: boolean;
     items: LcmsSequenceItem[];
     columns: LcmsSequenceTableColumn[];
     emptyMessage: string;
@@ -23,4 +45,10 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     maxRows: number;
     showMoreLabel: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/PluginWorkspaceView.props.d.ts

@@ -1,4 +1,4 @@
-import { AccountMenuItem, PageSelectorItemInput, PillNavItemInput, PluginSwitcherInfo, SidebarToolSection, TopBarSettingsConfig, TopBarVariant } from '../types';
+import { AccountMenuItem, ExperimentSummary, PageSelectorItem, PageSelectorItemInput, PillNavItem, PillNavItemInput, PillNavOption, PluginSwitcherInfo, PluginSwitcherPlugin, SidebarToolSection, TopBarSettingsConfig, TopBarVariant } from '../types';
 import { FormEnhancements, FormSchema } from '../types/form-builder';
 import { ControlComponentBinding, ControlComponentBindingsById, ControlComponentBindingsConfig, ControlComponentPropsByIdMap, ControlComponentPropsMap, ControlModel, ControlModelBinding, ControlSchema, ControlWorkspaceOptions } from '../composables/useControlSchema';
 export type PluginWorkspaceSidebarVariant = 'default' | 'analysis';
@@ -134,6 +134,34 @@ export interface PluginWorkspaceViewProps {
     /** Accessible label used when the mobile sidebar is open. */
     sidebarCloseLabel?: string;
 }
+/**
+ * Event map for PluginWorkspaceView, shared with the {@link usePluginWorkspace} composable
+ * so its internal pieces can emit through the exact same typed contract as the public component.
+ */
+export interface PluginWorkspaceViewEmits {
+    'update:activeView': [value: string];
+    'page-selector-select': [page: PageSelectorItem];
+    'pill-select': [item: PillNavItem];
+    'pill-option-select': [option: PillNavOption, item: PillNavItem];
+    'plugin-switcher-select': [plugin: PluginSwitcherPlugin];
+    'plugin-switcher-install': [];
+    'account-menu-select': [item: AccountMenuItem];
+    'sign-out': [];
+    'notifications-click': [];
+    'settings-values-change': [data: Record<string, unknown>];
+    'admin-click': [];
+    'experiment-select': [experiment: ExperimentSummary];
+    'experiment-detach': [];
+    'update:modelValue': [values: Record<string, unknown>];
+    'update:values': [values: Record<string, unknown>];
+    'update:sidebarCollapsed': [value: boolean];
+    'update:toggle': [sectionId: string, value: boolean];
+    'section-action': [sectionId: string, actionId: string];
+    'form-submit': [sectionId: string, values: Record<string, unknown>];
+    'form-cancel': [sectionId: string];
+}
+/** Typed `emit` function shape produced by `defineEmits<PluginWorkspaceViewEmits>()`. */
+export type PluginWorkspaceViewEmit = <K extends keyof PluginWorkspaceViewEmits>(event: K, ...args: PluginWorkspaceViewEmits[K]) => void;
 export interface PluginWorkspaceSlotProps {
     activeView: string;
     setActiveView: (viewId: string) => void;

package/dist/components/PluginWorkspaceView.vue.d.ts

@@ -1,4 +1,4 @@
-import { AccountMenuItem, ExperimentSummary, PageSelectorItem, PillNavItem, PluginSwitcherPlugin, PillNavOption } from '../types';
+import { AccountMenuItem, PillNavItem, PluginSwitcherPlugin, PillNavOption } from '../types';
 import { PluginWorkspaceForwardedSlotProps, PluginWorkspaceSlotProps, PluginWorkspaceViewProps } from './PluginWorkspaceView.props';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -48,7 +48,7 @@ declare const __VLS_component: import('vue').DefineComponent<PluginWorkspaceView
     "sign-out": () => any;
     "update:values": (values: Record<string, unknown>) => any;
     "admin-click": () => any;
-    "page-selector-select": (page: PageSelectorItem) => any;
+    "page-selector-select": (page: import('..').PageSelectorItem) => any;
     "pill-select": (item: PillNavItem) => any;
     "pill-option-select": (option: PillNavOption, item: PillNavItem) => any;
     "plugin-switcher-select": (plugin: PluginSwitcherPlugin) => any;
@@ -61,7 +61,7 @@ declare const __VLS_component: import('vue').DefineComponent<PluginWorkspaceView
     "form-submit": (sectionId: string, values: Record<string, unknown>) => any;
     "form-cancel": (sectionId: string) => any;
     "update:activeView": (value: string) => any;
-    "experiment-select": (experiment: ExperimentSummary) => any;
+    "experiment-select": (experiment: import('..').ExperimentSummary) => any;
     "experiment-detach": () => any;
     "update:sidebarCollapsed": (value: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<PluginWorkspaceViewProps> & Readonly<{
@@ -69,7 +69,7 @@ declare const __VLS_component: import('vue').DefineComponent<PluginWorkspaceView
     "onSign-out"?: (() => any) | undefined;
     "onUpdate:values"?: ((values: Record<string, unknown>) => any) | undefined;
     "onAdmin-click"?: (() => any) | undefined;
-    "onPage-selector-select"?: ((page: PageSelectorItem) => any) | undefined;
+    "onPage-selector-select"?: ((page: import('..').PageSelectorItem) => any) | undefined;
     "onPill-select"?: ((item: PillNavItem) => any) | undefined;
     "onPill-option-select"?: ((option: PillNavOption, item: PillNavItem) => any) | undefined;
     "onPlugin-switcher-select"?: ((plugin: PluginSwitcherPlugin) => any) | undefined;
@@ -82,7 +82,7 @@ declare const __VLS_component: import('vue').DefineComponent<PluginWorkspaceView
     "onForm-submit"?: ((sectionId: string, values: Record<string, unknown>) => any) | undefined;
     "onForm-cancel"?: ((sectionId: string) => any) | undefined;
     "onUpdate:activeView"?: ((value: string) => any) | undefined;
-    "onExperiment-select"?: ((experiment: ExperimentSummary) => any) | undefined;
+    "onExperiment-select"?: ((experiment: import('..').ExperimentSummary) => any) | undefined;
     "onExperiment-detach"?: (() => any) | undefined;
     "onUpdate:sidebarCollapsed"?: ((value: boolean) => any) | undefined;
 }>, {

package/dist/components/ProgressBar.vue.d.ts

@@ -11,10 +11,10 @@ interface Props {
     ariaLabel?: string;
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+    value: number;
     label: string;
     size: "sm" | "md" | "lg";
     color: "primary" | "success" | "warning" | "error" | "info";
-    value: number;
     variant: "rail" | "segmented";
     showValue: boolean;
     indeterminate: boolean;

package/dist/components/ProtocolStepEditor.vue.d.ts

@@ -22,5 +22,6 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     showPreview: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     templateDropdownRef: HTMLDivElement;
+    templateTriggerRef: HTMLButtonElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/ReagentList.vue.d.ts

@@ -7,8 +7,28 @@ interface Props {
     columns?: ReagentColumn[];
     sortable?: boolean;
     searchable?: boolean;
+    /** Replace the table with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the table is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
 }
-declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     add: () => any;
     "update:modelValue": (reagents: Reagent[]) => any;
     remove: (reagentId: string) => any;
@@ -21,12 +41,20 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     onEdit?: ((reagent: Reagent) => any) | undefined;
     onReorder?: ((reagentId: string, fromIndex: number, toIndex: number) => any) | undefined;
 }>, {
+    error: string | null;
     readonly: boolean;
     modelValue: Reagent[];
+    loading: boolean;
     columns: ReagentColumn[];
     sortable: boolean;
     searchable: boolean;
     showStockLevel: boolean;
     lowStockThreshold: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/SampleHierarchyTree.vue.d.ts

@@ -7,8 +7,28 @@ interface Props {
     showCounts?: boolean;
     maxDepth?: number;
     size?: 'sm' | 'md' | 'lg';
+    /** Replace the tree with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the tree is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
 }
-declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     collapse: (nodeId: string) => any;
     "node-click": (node: TreeNode) => any;
     expand: (nodeId: string) => any;
@@ -17,10 +37,18 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     "onNode-click"?: ((node: TreeNode) => any) | undefined;
     onExpand?: ((nodeId: string) => any) | undefined;
 }>, {
+    error: string | null;
     size: "sm" | "md" | "lg";
+    loading: boolean;
     showCounts: boolean;
     defaultExpandedIds: string[];
     expandAll: boolean;
     showIcons: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/SampleLegend.vue.d.ts

@@ -24,8 +24,8 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     size: "sm" | "md" | "lg";
     modelValue: string;
     colorPalette: string[];
-    orientation: "vertical" | "horizontal";
     samples: SampleType[];
+    orientation: "vertical" | "horizontal";
     editable: boolean;
     showCounts: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/SampleSelector.drag.d.ts

@@ -4,6 +4,19 @@ interface MutableSampleGroups {
     value: SampleGroup[];
 }
 export declare function useSampleSelectorDrag(groups: MutableSampleGroups): {
+    announcement: import('vue').Ref<string, string>;
+    announcerStyle: Readonly<{
+        position: "absolute";
+        width: "1px";
+        height: "1px";
+        padding: "0";
+        margin: "-1px";
+        overflow: "hidden";
+        clip: "rect(0, 0, 0, 0)";
+        whiteSpace: "nowrap";
+        border: "0";
+    }>;
+    handleGroupReorderKeydown: (name: string, kind: GroupDragKind, event: KeyboardEvent) => void;
     draggingSample: import('vue').Ref<string | null, string | null>;
     dragOverGroup: import('vue').Ref<string | null, string | null>;
     draggingGroup: import('vue').Ref<string | null, string | null>;

package/dist/components/SampleSelector.tree.d.ts

@@ -32,6 +32,8 @@ export interface SampleGroupTreeContext {
     onGroupDragOver: (name: string, kind: GroupDragKind, event: DragEvent) => void;
     onGroupDragLeave: (event: DragEvent) => void;
     onGroupDrop: (name: string, kind: GroupDragKind, event: DragEvent) => void;
+    /** Alt+ArrowUp / Alt+ArrowDown reorder a group among its siblings. */
+    onGroupReorderKeydown: (name: string, kind: GroupDragKind, event: KeyboardEvent) => void;
 }
 /** Every concrete group name beneath a node, in tree order. */
 export declare function collectLeafGroupNames(node: SampleGroupNode): string[];

package/dist/components/SampleSelector.vue.d.ts

@@ -9,9 +9,33 @@ interface Props {
     experimentId?: number;
     designData?: Record<string, unknown>;
     autoloadExperimentData?: boolean;
+    /** Replace the selector body with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the selector body is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
+    /** Empty-state headline shown when there are no samples to select from. */
+    emptyMessage?: string;
 }
 declare function handleSmartGroupApply(result: AutoGroupResult): void;
-declare const _default: import('vue').DefineComponent<Props, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {
+        colorPickerInput: HTMLInputElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {
     handleSmartGroupApply: typeof handleSmartGroupApply;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (samples: string[]) => any;
@@ -22,9 +46,12 @@ declare const _default: import('vue').DefineComponent<Props, {
     "onUpdate:groups"?: ((groups: SampleGroup[]) => any) | undefined;
     onSmartGroup?: ((result: AutoGroupResult) => any) | undefined;
 }>, {
+    error: string | null;
+    loading: boolean;
+    samples: string[];
     experimentId: number;
     groups: SampleGroup[];
-    samples: string[];
+    emptyMessage: string;
     designData: Record<string, unknown>;
     enableGrouping: boolean;
     enableSmartGroup: boolean;
@@ -32,4 +59,10 @@ declare const _default: import('vue').DefineComponent<Props, {
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     colorPickerInput: HTMLInputElement;
 }, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ScheduleCalendar.vue.d.ts

@@ -14,10 +14,28 @@ interface Props {
     showNavigation?: boolean;
     statusColors?: Record<string, string>;
     locale?: string;
+    /** Replace the calendar grid with a loading placeholder. */
+    loading?: boolean;
+    /**
+     * Error message. When set, the calendar grid is replaced by an error state.
+     * `null`/`undefined` renders normally.
+     */
+    error?: string | null;
+    /**
+     * Opt-in empty-state headline. An empty grid is meaningful on a calendar, so
+     * the empty state only replaces it when this message is supplied and there
+     * are no events.
+     */
+    emptyMessage?: string;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
+        error?(_: {
+            error: string;
+        }): any;
+        loading?(_: {}): any;
+        empty?(_: {}): any;
         'day-header'?(_: {
             date: Date;
             isToday: boolean;
@@ -86,8 +104,10 @@ declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {},
         minute: number;
     }) => any) | undefined;
 }>, {
+    error: string | null;
     readonly: boolean;
     view: ScheduleView;
+    loading: boolean;
     locale: string;
     weekStartsOn: 0 | 1;
     showNavigation: boolean;

package/dist/components/SecretInput.vue.d.ts

@@ -0,0 +1,28 @@
+import { PluginSecretRef } from '../utils/pluginSecrets';
+type SecretValue = PluginSecretRef | string | null;
+interface Props {
+    /** The `$secret` marker from the settings response, a typed string, or `null`. */
+    modelValue?: SecretValue;
+    placeholder?: string;
+    disabled?: boolean;
+    error?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    /** Label on the control that starts entering a replacement value. */
+    changeLabel?: string;
+    /** Label on the control that clears a stored secret. */
+    clearLabel?: string;
+}
+declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: SecretValue) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: SecretValue) => any) | undefined;
+}>, {
+    disabled: boolean;
+    error: boolean;
+    size: "sm" | "md" | "lg";
+    placeholder: string;
+    modelValue: SecretValue;
+    changeLabel: string;
+    clearLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/SettingsModal.vue.d.ts

@@ -57,9 +57,9 @@ declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {},
 }>, {
     size: "md" | "lg" | "xl";
     title: string;
+    showAppearance: boolean;
     tabs: SettingsTabInput[];
     layout: SettingsModalLayout;
-    showAppearance: boolean;
     model: ControlModel | ControlModelBinding;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/components/SmartGroupFieldRecipe.vue.d.ts

@@ -24,8 +24,8 @@ declare const _default: import('vue').DefineComponent<SmartGroupFieldRecipeProps
     "onDownload-prefilled"?: (() => any) | undefined;
 }>, {
     loading: boolean;
-    fields: SmartGroupField[];
     samples: SmartGroupSampleRecord[];
+    fields: SmartGroupField[];
     palette: string[];
     experimentLabel: string;
     headerCount: number;
@@ -34,6 +34,7 @@ declare const _default: import('vue').DefineComponent<SmartGroupFieldRecipeProps
     canDownloadTemplate: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     csvMenuRoot: HTMLDivElement;
+    csvMenuTrigger: HTMLButtonElement;
     fileInput: HTMLInputElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/TimePicker.vue.d.ts

@@ -24,6 +24,7 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
     format: "12h" | "24h";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;
+    triggerRef: HTMLInputElement;
     listRef: HTMLUListElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/WellPlate.geometry.d.ts

@@ -17,7 +17,22 @@ export interface WellPlateSizeConfig {
 }
 export declare const PLATE_CONFIGS: Record<WellPlateFormat, WellPlateConfig>;
 export declare const WELL_PLATE_SIZE_CONFIGS: Record<WellPlateSize, WellPlateSizeConfig>;
+/**
+ * Spreadsheet-style row label for a zero-based row index: A…Z, then AA, AB, …
+ *
+ * This is the single row-label generator for the SDK — plate grids, rack
+ * grids, well-id parsing and the template builders all go through it.
+ */
+export declare function rowLabel(index: number): string;
+/** Inverse of {@link rowLabel}: 'A' → 0, 'Z' → 25, 'AA' → 26. */
+export declare function rowIndex(label: string): number;
 export declare function createPlateRowLabels(config: WellPlateConfig): string[];
+/** Every well id of a plate, row-major (A1, A2, … B1, …). */
+export declare function wellIdsForFormat(format: number): string[];
+/** Throw unless `wellId` names a well that exists on a `format`-well plate. */
+export declare function assertWellInFormat(wellId: string, format: number): void;
+/** Coerce an unknown value to a supported plate format, else `fallback`. */
+export declare function readPlateFormat(value: unknown, fallback: WellPlateFormat): WellPlateFormat;
 export declare function createPlateColumnLabels(config: WellPlateConfig): number[];
 export declare function createWellGrid(config: WellPlateConfig, rowLabels: string[], wells: Record<string, Partial<Well>>): Well[][];
 export declare function getRectangleWellIds(start: WellPlateCoordinate, end: WellPlateCoordinate, rowLabels: string[]): Set<string>;

package/dist/components/WellPlate.interaction.d.ts

@@ -67,5 +67,18 @@ export declare function useWellPlateInteraction(options: WellPlateInteractionOpt
     handleDragLeave: () => void;
     handleDrop: (well: Well, event: DragEvent) => void;
     handleDragEnd: () => void;
+    handleWellMoveKeydown: (well: Well, event: KeyboardEvent) => void;
     handleKeyDown: (event: KeyboardEvent) => void;
+    moveAnnouncement: import('vue').Ref<string, string>;
+    moveAnnouncerStyle: Readonly<{
+        position: "absolute";
+        width: "1px";
+        height: "1px";
+        padding: "0";
+        margin: "-1px";
+        overflow: "hidden";
+        clip: "rect(0, 0, 0, 0)";
+        whiteSpace: "nowrap";
+        border: "0";
+    }>;
 };