@morscherlab/mint-sdk 1.2.0-beta.8 → 1.2.0

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

@@ -0,0 +1,3 @@
+import { PickerAdapter } from '../../types/filePicker';
+/** Construct metadata only: no FileReader, arrayBuffer or upload. */
+export declare function localFilesAdapter(files: File[], relativePaths?: (string | undefined)[]): PickerAdapter;

package/dist/composables/filePicker/usePickerNavigation.d.ts

@@ -0,0 +1,96 @@
+import { PickerAdapter, PickerNode, PickerRequest, PickerTreeRow } from '../../types/filePicker';
+export declare function usePickerNavigation(adapter: () => PickerAdapter, request: () => PickerRequest, systemFilter?: (node: PickerNode) => boolean): {
+    path: import('vue').ShallowRef<string, string>;
+    trail: import('vue').Ref<{
+        path: string;
+        label: string;
+    }[], {
+        path: string;
+        label: string;
+    }[] | {
+        path: string;
+        label: string;
+    }[]>;
+    entries: import('vue').ShallowRef<PickerNode[], PickerNode[]>;
+    nodes: import('vue').Ref<Map<string, {
+        kind: "folder";
+        fileCount?: number | null | undefined;
+        formats?: Record<string, number> | undefined;
+        hasChildren?: boolean | undefined;
+        path: string;
+        name: string;
+        parentPath?: string | null | undefined;
+        parentName?: string | undefined;
+        bytes?: number | null | undefined;
+        unavailableReason?: string | undefined;
+    } | {
+        kind: "file";
+        format: string;
+        file?: {
+            readonly lastModified: number;
+            readonly name: string;
+            readonly webkitRelativePath: string;
+            readonly size: number;
+            readonly type: string;
+            arrayBuffer: () => Promise<ArrayBuffer>;
+            bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+            slice: (start?: number, end?: number, contentType?: string) => Blob;
+            stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+            text: () => Promise<string>;
+        } | undefined;
+        path: string;
+        name: string;
+        parentPath?: string | null | undefined;
+        parentName?: string | undefined;
+        bytes?: number | null | undefined;
+        unavailableReason?: string | undefined;
+    }> & Omit<Map<string, PickerNode>, keyof Map<any, any>>, Map<string, PickerNode> | (Map<string, {
+        kind: "folder";
+        fileCount?: number | null | undefined;
+        formats?: Record<string, number> | undefined;
+        hasChildren?: boolean | undefined;
+        path: string;
+        name: string;
+        parentPath?: string | null | undefined;
+        parentName?: string | undefined;
+        bytes?: number | null | undefined;
+        unavailableReason?: string | undefined;
+    } | {
+        kind: "file";
+        format: string;
+        file?: {
+            readonly lastModified: number;
+            readonly name: string;
+            readonly webkitRelativePath: string;
+            readonly size: number;
+            readonly type: string;
+            arrayBuffer: () => Promise<ArrayBuffer>;
+            bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+            slice: (start?: number, end?: number, contentType?: string) => Blob;
+            stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+            text: () => Promise<string>;
+        } | undefined;
+        path: string;
+        name: string;
+        parentPath?: string | null | undefined;
+        parentName?: string | undefined;
+        bytes?: number | null | undefined;
+        unavailableReason?: string | undefined;
+    }> & Omit<Map<string, PickerNode>, keyof Map<any, any>>)>;
+    children: import('vue').ShallowRef<Map<string, PickerNode[]>, Map<string, PickerNode[]>>;
+    expanded: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    expanding: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    expansionErrors: import('vue').Ref<Map<string, string> & Omit<Map<string, string>, keyof Map<any, any>>, Map<string, string> | (Map<string, string> & Omit<Map<string, string>, keyof Map<any, any>>)>;
+    loading: import('vue').ShallowRef<boolean, boolean>;
+    error: import('vue').ShallowRef<string, string>;
+    rows: import('vue').ComputedRef<PickerTreeRow[]>;
+    isAllowed: (node: PickerNode) => boolean;
+    clear: () => void;
+    invalidate: () => void;
+    register: (items: PickerNode[], parent?: string) => void;
+    loadChildren: (folder: string, ancestors?: string[], refresh?: boolean) => Promise<PickerNode[]>;
+    load: (query?: string, recursive?: boolean, refresh?: boolean) => Promise<void>;
+    expand: (node: PickerNode) => Promise<void>;
+    enter: (node: PickerNode) => void;
+    up: (target?: string) => void;
+};

package/dist/composables/filePicker/usePickerSelection.d.ts

@@ -0,0 +1,31 @@
+import { PickerCapability, PickerExcluded, PickerFile, PickerNode, PickerSelection, PickerSelectionMode } from '../../types/filePicker';
+import { usePickerNavigation } from './usePickerNavigation';
+type Navigation = ReturnType<typeof usePickerNavigation>;
+export declare function usePickerSelection(nav: Navigation, mode: () => PickerSelectionMode, capability: () => PickerCapability | undefined, skipBlanks: () => boolean): {
+    keys: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    dropped: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    focusPath: import('vue').ShallowRef<string, string>;
+    resolving: import('vue').ShallowRef<boolean, boolean>;
+    resolutionError: import('vue').ShallowRef<string, string>;
+    roots: import('vue').ComputedRef<PickerNode[]>;
+    chosen: import('vue').ComputedRef<{
+        files: PickerFile[];
+        excluded: PickerExcluded[];
+        bytes: number;
+    }>;
+    focused: import('vue').ComputedRef<PickerNode>;
+    select: (node: PickerNode, modifiers?: {
+        metaKey?: boolean;
+        ctrlKey?: boolean;
+        shiftKey?: boolean;
+        toggle?: boolean;
+    }) => void;
+    selected: (node: PickerNode) => boolean;
+    selectable: (node: PickerNode) => boolean;
+    exclusion: (node: PickerNode) => PickerExcluded | null;
+    reset: (selection?: PickerSelection | null) => void;
+    resolve: () => Promise<void>;
+    folderProgress: (node: PickerNode) => string;
+    ancestorSelected: (node: PickerNode, candidates?: Set<string> & Omit<Set<string>, keyof Set<any>>) => boolean;
+};
+export {};

package/dist/composables/filePicker/validation.d.ts

@@ -0,0 +1,5 @@
+import { PickerCapability, PickerExcluded, PickerNode } from '../../types/filePicker';
+export declare function normalizePickerFormat(format: string): string;
+export declare function pickerExclusion(node: PickerNode, capability?: PickerCapability, skipBlanks?: boolean): PickerExcluded | null;
+export declare function pickerReason(excluded: PickerExcluded | null, node?: PickerNode): string;
+export declare function pickerFormat(name: string): string;

package/dist/composables/index.d.ts

@@ -28,6 +28,7 @@ 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';
+export { useFileBrowser, type UseFileBrowserOptions, type UseFileBrowserReturn, } from './useFileBrowser';
 export { buildAnalysisArtifactTargetQuery, parseAnalysisArtifactTarget, } from './analysisArtifactTarget';
 export { resolveCurrentPluginId } from './platformContextHelpers';
 export { formatExperimentDate, formatExperimentStatus, getExperimentStatusVariant, resolveExperimentCode, experimentIdFromRoute, datePresetToISO, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, EXPERIMENT_STATUS_LABELS, DATE_PRESET_OPTIONS, SORT_OPTIONS, } from './experiment-utils';
@@ -65,4 +66,6 @@ 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';
+export { usePlatformFilePickerAdapter, encodePlatformPickerPath, decodePlatformPickerPath } from './usePlatformFilePickerAdapter';

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 { i as useApi, n as AuthenticationRequiredError } from "../errors-BLuqMee5.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-CV2Wza3z.js";
+import { n as useRequestSyncState } from "../Skeleton-BAF3CKY7.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-DldpxNOP.js";
+import { $ as getInjectedFrontendRevision, A as useFileImport, B as REORDER_ANNOUNCER_STYLE, C as useExpansionSet, D as detectDelimiter, F as extractSampleNamesFromDesignData, G as combinePluginJobSources, H as useListReorder, I as extractSampleOptionsFromDesignData, J as usePluginWorkspace, K as useJobsStatusTray, L as unwrapExperimentDesignData, M as extractSamplesFromDesignData, N as useAutoGroup, O as parseDelimitedText, Q as useAppExperiment, R as DEFAULT_COLORS, S as useExperimentData, U as useReorderAnnouncer, V as reorderList, W as useDoseCalculator, X as useMobileSupportGate, Y as DEFAULT_MOBILE_VIEWPORT_QUERY, Z as APP_EXPERIMENT_KEY, _ as useBioTemplateControls, a as DEFAULT_PRESETS, at as candidateMatchesSearch, b as useScheduleDrag, c as useReagentSeries, ct as compareSortValues, d as useBioTemplatePresetWorkspace, dt as useRovingFocus, et as useRuntimeAlignment, f as useBioTemplatePackWorkspace, g as useBioTemplateComponents, h as toBioTemplateComponentPropsByComponent, i as useProtocolTemplates, it as useToast, j as validateImportFile, k as readFileAsText, l as useGroupAssignment, lt as useSortedItems, m as getBioTemplateComponentProps, nt as usePresenceHeartbeat, o as DEFAULT_UNITS, ot as normalizeSearchQuery, p as useBioTemplateWorkspace, q as usePluginJobCenter, rt as useTheme, s as generateDilutionSeries, st as useTextSearch, tt as getPresenceClientId, u as useRackEditor, ut as useMenuKeyboard, v as useTemplateCollection, w as useSampleGroups, x as useExperimentSamples, y as useExperimentSave, z as useWellPlateEditor } from "../validation-uwoJGEb6.js";
+import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-z5L_dUIy.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-CmGfmBRA.js";
+import { n as useDebouncedWatch, t as useExperimentSelector } from "../useExperimentSelector-CEcIaueJ.js";
+import { A as buildAnalysisArtifactTargetQuery, C as useWellPainting, D as useResourceCrud, E as createPluginResourceClient, F as useAsyncBatch, I as resolvePluginFrontendBase, L as usePasskey, M as useFileBrowser, N as usePluginConfig, O as useOptimisticMutation, P as useAsync, R as useAuth, S as coordinateToWellId, T as wellIdsInRectangle, _ as useWellPlateValidation, a as downloadBlob, b as createWellPlateWells, c as pluginFormDataFromPayload, d as usePluginClient, f as usePluginEventStream, g as runWellPlateValidation, h as resolvePluginBaseUrl, i as createPluginClient, j as parseAnalysisArtifactTarget, k as useCommandHistory, l as uploadPluginEndpoint, m as buildPluginEndpointUrl, n as encodePlatformPickerPath, o as downloadPluginEndpoint, p as usePluginSettings, r as usePlatformFilePickerAdapter, s as getPluginPageSelectorItems, t as decodePlatformPickerPath, u as useCurrentExperiment, v as createColumnConditions, w as wellIdToCoordinate, x as useWellPlateAdapter, y as createRowConditions } from "../composables-mFXsTA4g.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, decodePlatformPickerPath, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, encodePlatformPickerPath, 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, useFileBrowser, useFileImport, useFocusTrap, useForm, useFormBuilder, useGeneratedAnalysis, useGroupAssignment, useJobsStatusTray, useListReorder, useListSelection, useMenuKeyboard, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePlatformFilePickerAdapter, 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/useApi.d.ts

@@ -1,17 +1,24 @@
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
-/** Raised when an authenticated SDK request is rejected because the login is no longer valid. */
-export declare class AuthenticationRequiredError extends Error {
-    readonly cause?: unknown | undefined;
-    readonly code = "AUTHENTICATION_REQUIRED";
-    readonly status = 401;
-    constructor(cause?: unknown | undefined);
+import { MintApiError } from '../apiErrors';
+/**
+ * Raised when an authenticated SDK request is rejected because the login is no
+ * longer valid. It is also a `MintApiError` (status 401), so typed-error callers
+ * and `instanceof AuthenticationRequiredError` callers both recognise it.
+ */
+export declare class AuthenticationRequiredError extends MintApiError {
+    readonly name: string;
+    readonly code: 'AUTHENTICATION_REQUIRED';
+    readonly status: 401;
+    constructor(cause?: unknown, envelope?: MintApiError);
 }
 /** @internal Convert a rejected authenticated request into the SDK's public auth error. */
-export declare function authenticationRequiredError(cause: unknown, rejectedToken?: string): AuthenticationRequiredError;
+export declare function authenticationRequiredError(cause: unknown, rejectedToken?: string, envelope?: MintApiError): AuthenticationRequiredError;
 export interface ApiClientOptions {
     baseUrl?: string;
     timeout?: number;
     withAuth?: boolean;
+    /** Normalize failed responses into MintApiError. Generated clients enable this by default. */
+    typedErrors?: boolean;
 }
 export interface UseApiReturn {
     client: AxiosInstance;

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

@@ -0,0 +1,55 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { FileBrowserSortKey, FileEntry, FilePathCrumb, FileSelection, ServerMount } from '../types/fileBrowserTypes';
+export interface UseFileBrowserOptions {
+    /** Extensions the caller cares about; entries are flagged, never removed. */
+    typeRules?: MaybeRefOrGetter<string[] | undefined>;
+    /** Mount to open first; defaults to the first available one. */
+    initialMountId?: MaybeRefOrGetter<string | undefined>;
+    /** Override the platform API base URL (standalone plugin dev). */
+    apiBaseUrl?: string;
+}
+export interface UseFileBrowserReturn {
+    /** Every configured mount, offline ones included. */
+    mounts: Ref<ServerMount[]>;
+    /** Mount the current listing belongs to. */
+    mountId: Ref<string>;
+    /** Mount-relative path of the current listing. */
+    path: Ref<string>;
+    /** Parent path, or null at a mount root. */
+    parent: Ref<string | null>;
+    entries: Ref<FileEntry[]>;
+    breadcrumbs: Ref<FilePathCrumb[]>;
+    /** Directory size before any search filter. */
+    totalCount: Ref<number | null>;
+    /** How many entries satisfy the type rules. */
+    matchCount: Ref<number | null>;
+    /** How many rows this listing carries, after search and any cap. */
+    shownCount: Ref<number | null>;
+    /** True when the server capped the listing. */
+    truncated: Ref<boolean>;
+    search: Ref<string>;
+    sort: Ref<FileBrowserSortKey>;
+    /** Controlled selection, ready to bind to FileBrowserModal. */
+    selected: Ref<FileSelection[]>;
+    isLoading: ComputedRef<boolean>;
+    error: Ref<string | null>;
+    /** Load the mount list and open the first available mount. */
+    init: () => Promise<void>;
+    /** Open a directory, or a mount root when path is empty. */
+    navigate: (location: {
+        mount_id: string;
+        path: string;
+    }) => Promise<void>;
+    /** Re-read the current directory. */
+    refresh: () => Promise<void>;
+    /** Take the directory currently being viewed as the input. */
+    selectCurrentFolder: () => void;
+    clear: () => void;
+}
+/**
+ * Drives FileBrowserModal against the platform's `/api/filesystem` routes.
+ *
+ * Requires the `filesystem.browse` permission and a deployment that declares
+ * mounts; with none configured the routes are absent and `mounts` stays empty.
+ */
+export declare function useFileBrowser(options?: UseFileBrowserOptions): UseFileBrowserReturn;

package/dist/composables/useFilePicker.d.ts

@@ -0,0 +1,189 @@
+import { PickerAdapter, PickerCapabilities, PickerNode, PickerSelection, PickerSelectionMode, PickerSource } from '../types/filePicker';
+interface PickerStateProps {
+    open: boolean;
+    adapter: PickerAdapter;
+    selectionMode: PickerSelectionMode;
+    sources: PickerSource[];
+    capabilities: PickerCapabilities;
+    initialPath: string;
+    initialSelection: PickerSelection | null;
+    systemFilter?: (node: PickerNode, source: PickerSource) => boolean;
+}
+type PickerEmit = {
+    (event: 'update:open', value: boolean): void;
+    (event: 'select', value: PickerSelection): void;
+    (event: 'cancel'): void;
+};
+/** Internal orchestration; public consumers use FilePicker's props and events. */
+export declare function useFilePicker(props: PickerStateProps, emit: PickerEmit): {
+    previewNode: import('vue').ComputedRef<PickerNode>;
+    sourceNames: Record<PickerSource, string>;
+    sourceIcons: Record<PickerSource, string>;
+    allowedSources: import('vue').ComputedRef<PickerSource[]>;
+    source: import('vue').ShallowRef<PickerSource, PickerSource>;
+    query: import('vue').ShallowRef<string, string>;
+    recursive: import('vue').ShallowRef<boolean, boolean>;
+    skipBlanks: import('vue').ShallowRef<boolean, boolean>;
+    reviewing: import('vue').ShallowRef<boolean, boolean>;
+    nav: {
+        path: import('vue').ShallowRef<string, string>;
+        trail: import('vue').Ref<{
+            path: string;
+            label: string;
+        }[], {
+            path: string;
+            label: string;
+        }[] | {
+            path: string;
+            label: string;
+        }[]>;
+        entries: import('vue').ShallowRef<PickerNode[], PickerNode[]>;
+        nodes: import('vue').Ref<Map<string, {
+            kind: "folder";
+            fileCount?: number | null | undefined;
+            formats?: Record<string, number> | undefined;
+            hasChildren?: boolean | undefined;
+            path: string;
+            name: string;
+            parentPath?: string | null | undefined;
+            parentName?: string | undefined;
+            bytes?: number | null | undefined;
+            unavailableReason?: string | undefined;
+        } | {
+            kind: "file";
+            format: string;
+            file?: {
+                readonly lastModified: number;
+                readonly name: string;
+                readonly webkitRelativePath: string;
+                readonly size: number;
+                readonly type: string;
+                arrayBuffer: () => Promise<ArrayBuffer>;
+                bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+                slice: (start?: number, end?: number, contentType?: string) => Blob;
+                stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+                text: () => Promise<string>;
+            } | undefined;
+            path: string;
+            name: string;
+            parentPath?: string | null | undefined;
+            parentName?: string | undefined;
+            bytes?: number | null | undefined;
+            unavailableReason?: string | undefined;
+        }> & Omit<Map<string, PickerNode>, keyof Map<any, any>>, Map<string, PickerNode> | (Map<string, {
+            kind: "folder";
+            fileCount?: number | null | undefined;
+            formats?: Record<string, number> | undefined;
+            hasChildren?: boolean | undefined;
+            path: string;
+            name: string;
+            parentPath?: string | null | undefined;
+            parentName?: string | undefined;
+            bytes?: number | null | undefined;
+            unavailableReason?: string | undefined;
+        } | {
+            kind: "file";
+            format: string;
+            file?: {
+                readonly lastModified: number;
+                readonly name: string;
+                readonly webkitRelativePath: string;
+                readonly size: number;
+                readonly type: string;
+                arrayBuffer: () => Promise<ArrayBuffer>;
+                bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+                slice: (start?: number, end?: number, contentType?: string) => Blob;
+                stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+                text: () => Promise<string>;
+            } | undefined;
+            path: string;
+            name: string;
+            parentPath?: string | null | undefined;
+            parentName?: string | undefined;
+            bytes?: number | null | undefined;
+            unavailableReason?: string | undefined;
+        }> & Omit<Map<string, PickerNode>, keyof Map<any, any>>)>;
+        children: import('vue').ShallowRef<Map<string, PickerNode[]>, Map<string, PickerNode[]>>;
+        expanded: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+        expanding: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+        expansionErrors: import('vue').Ref<Map<string, string> & Omit<Map<string, string>, keyof Map<any, any>>, Map<string, string> | (Map<string, string> & Omit<Map<string, string>, keyof Map<any, any>>)>;
+        loading: import('vue').ShallowRef<boolean, boolean>;
+        error: import('vue').ShallowRef<string, string>;
+        rows: import('vue').ComputedRef<import('..').PickerTreeRow[]>;
+        isAllowed: (node: PickerNode) => boolean;
+        clear: () => void;
+        invalidate: () => void;
+        register: (items: PickerNode[], parent?: string) => void;
+        loadChildren: (folder: string, ancestors?: string[], refresh?: boolean) => Promise<PickerNode[]>;
+        load: (query?: string, recursive?: boolean, refresh?: boolean) => Promise<void>;
+        expand: (node: PickerNode) => Promise<void>;
+        enter: (node: PickerNode) => void;
+        up: (target?: string) => void;
+    };
+    selection: {
+        keys: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+        dropped: import('vue').Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+        focusPath: import('vue').ShallowRef<string, string>;
+        resolving: import('vue').ShallowRef<boolean, boolean>;
+        resolutionError: import('vue').ShallowRef<string, string>;
+        roots: import('vue').ComputedRef<PickerNode[]>;
+        chosen: import('vue').ComputedRef<{
+            files: import('..').PickerFile[];
+            excluded: import('..').PickerExcluded[];
+            bytes: number;
+        }>;
+        focused: import('vue').ComputedRef<PickerNode>;
+        select: (node: PickerNode, modifiers?: {
+            metaKey?: boolean;
+            ctrlKey?: boolean;
+            shiftKey?: boolean;
+            toggle?: boolean;
+        }) => void;
+        selected: (node: PickerNode) => boolean;
+        selectable: (node: PickerNode) => boolean;
+        exclusion: (node: PickerNode) => import('..').PickerExcluded | null;
+        reset: (selection?: PickerSelection | null) => void;
+        resolve: () => Promise<void>;
+        folderProgress: (node: PickerNode) => string;
+        ancestorSelected: (node: PickerNode, candidates?: Set<string> & Omit<Set<string>, keyof Set<any>>) => boolean;
+    };
+    capability: import('vue').ComputedRef<import('..').PickerCapability | undefined>;
+    path: import('vue').ShallowRef<string, string>;
+    trail: import('vue').Ref<{
+        path: string;
+        label: string;
+    }[], {
+        path: string;
+        label: string;
+    }[] | {
+        path: string;
+        label: string;
+    }[]>;
+    loading: import('vue').ShallowRef<boolean, boolean>;
+    error: import('vue').ShallowRef<string, string>;
+    rows: import('vue').ComputedRef<import('..').PickerTreeRow[]>;
+    roots: import('vue').ComputedRef<PickerNode[]>;
+    chosen: import('vue').ComputedRef<{
+        files: import('..').PickerFile[];
+        excluded: import('..').PickerExcluded[];
+        bytes: number;
+    }>;
+    focused: import('vue').ComputedRef<PickerNode>;
+    resolving: import('vue').ShallowRef<boolean, boolean>;
+    resolutionError: import('vue').ShallowRef<string, string>;
+    searchArea: import('vue').Ref<HTMLElement | null, HTMLElement | null>;
+    confirmLabel: import('vue').ComputedRef<string>;
+    folderCount: import('vue').ComputedRef<number>;
+    canConfirm: import('vue').ComputedRef<boolean>;
+    switchSource: (next: PickerSource) => Promise<void>;
+    selectNode: (node: PickerNode, event: MouseEvent | KeyboardEvent) => void;
+    enter: (node: PickerNode) => Promise<void>;
+    up: (target?: string) => Promise<void>;
+    refresh: () => Promise<void>;
+    selectParent: (node: PickerNode) => void;
+    chooseLocal: (files: File[], _rootName?: string, relativePaths?: string[]) => Promise<void>;
+    cancel: () => void;
+    confirm: () => void;
+    keyboard: (event: KeyboardEvent) => void;
+};
+export {};