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

package/dist/types/fileBrowserTypes.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Types for browsing read-only server mounts.
+ *
+ * These mirror the `mint_sdk.filesystem` wire models. MINT records the path of
+ * data that already sits on a mount; it never copies it.
+ */
+/** What a listing row is. */
+export type FileEntryKind = 'file' | 'directory';
+/** Field a listing is ordered by, after directories are grouped first. */
+export type FileBrowserSortKey = 'name' | 'size' | 'modified';
+/** One read-only directory tree exposed by the server. */
+export interface ServerMount {
+    id: string;
+    label: string;
+    read_only?: boolean;
+    /** False when the mount is configured but currently unreachable. */
+    available?: boolean;
+    /** Child mounts, used to render the sidebar tree. */
+    children?: ServerMount[];
+    /** Item count shown beside the mount; free-form so callers can send "1.2k". */
+    count?: string | number;
+}
+/** One step of the trail from a mount root to the current directory. */
+export interface FilePathCrumb {
+    label: string;
+    path: string;
+}
+/** A single file or directory inside a mount. */
+export interface FileEntry {
+    name: string;
+    /** Mount-relative POSIX path. */
+    path: string;
+    kind: FileEntryKind;
+    /** Null for directories. */
+    size_bytes?: number | null;
+    modified_at?: string | null;
+    extension?: string;
+    /**
+     * False when the entry fails the active type rules. Non-matching entries are
+     * still listed — they dim rather than vanish.
+     */
+    matches_type_rules?: boolean;
+    /** Directories only. */
+    child_count?: number | null;
+}
+/** The contents of one directory inside a mount. */
+export interface FileDirectoryListing {
+    mount_id: string;
+    path: string;
+    /** Null at the mount root. */
+    parent?: string | null;
+    breadcrumbs?: FilePathCrumb[];
+    entries?: FileEntry[];
+    /** Directory size before any search filter. */
+    total_count?: number;
+    /** How many entries satisfy the type rules. */
+    match_count?: number;
+    /** How many entries this response carries, after search and any cap. */
+    shown_count?: number;
+    /** True when the directory held more entries than the server will return. */
+    truncated?: boolean;
+}
+/** One item the user has picked. */
+export interface FileSelection {
+    mount_id: string;
+    path: string;
+    name: string;
+    kind: FileEntryKind;
+    /** For a directory pick, how many files it contains. */
+    child_count?: number | null;
+    size_bytes?: number | null;
+}
+/** Where the user is standing in the browser. */
+export interface FileBrowserLocation {
+    mount_id: string;
+    path: string;
+}

package/dist/types/filePicker.d.ts

@@ -0,0 +1,77 @@
+/** Sources are supplied by the host; the SDK never infers a host filesystem path. */
+export type PickerSource = 'server' | 'localFile';
+export type PickerSelectionMode = 'single-file' | 'multi-file' | 'folder' | 'folder+files';
+interface PickerNodeBase {
+    path: string;
+    name: string;
+    parentPath?: string | null;
+    parentName?: string;
+    bytes?: number | null;
+    /** An explicit adapter failure makes a row inert, including its disclosure. */
+    unavailableReason?: string;
+}
+export interface PickerFolder extends PickerNodeBase {
+    kind: 'folder';
+    fileCount?: number | null;
+    formats?: Record<string, number>;
+    hasChildren?: boolean;
+}
+export interface PickerFile extends PickerNodeBase {
+    kind: 'file';
+    format: string;
+    /** Present only for browser-selected files. The picker does not read its bytes. */
+    file?: File;
+}
+export type PickerNode = PickerFolder | PickerFile;
+export interface PickerRequest {
+    signal?: AbortSignal;
+    source?: PickerSource;
+    /**
+     * Set only when the user pressed Refresh. Adapters that cache listings (or
+     * ask a server to bypass its own cache) should re-read the location then and
+     * serve cached data otherwise; the picker keeps folder contents while it is
+     * open and re-reads the current location on each open.
+     */
+    refresh?: true;
+}
+export interface PickerAdapter {
+    listRoot(request?: PickerRequest): Promise<PickerNode[]>;
+    listChildren(path: string, request?: PickerRequest): Promise<PickerNode[]>;
+    search(query: string, scope: {
+        path: string;
+        recursive: boolean;
+    }, request?: PickerRequest): Promise<PickerNode[]>;
+}
+export interface PickerCapability {
+    /** Case-insensitive suffixes, including compound extensions such as mzML.gz. */
+    formats: string[];
+    maxBytes?: number;
+    /** Optional host-owned blank classification; no filename heuristics in the SDK. */
+    isBlank?: (node: PickerNode) => boolean;
+}
+export type PickerCapabilities = Partial<Record<PickerSource, PickerCapability>>;
+export type PickerExclusionReason = 'deselected' | 'unsupported' | 'tooLarge' | 'blank' | 'unreadable' | 'forbidden';
+export interface PickerExcluded {
+    /** Opaque identity prevents collisions between equal filenames in different folders. */
+    path: string;
+    name: string;
+    reason: PickerExclusionReason;
+}
+export type PickerSelection = {
+    source: 'server';
+    folders: string[];
+    files: PickerFile[];
+    excluded: PickerExcluded[];
+} | {
+    source: 'localFile';
+    files: File[];
+    relativePaths?: string[];
+};
+export interface PickerTreeRow {
+    node: PickerNode;
+    depth: number;
+    expanded: boolean;
+    loading: boolean;
+    error?: string;
+}
+export {};

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ export type { ContainerDirection, ButtonVariant, ButtonSize, ActionMenuItem, Inp
 export type * from './generated-ui';
 export type { AnalysisArtifactStatus, AnalysisArtifactStatusFilter, AnalysisArtifactSummary, AnalysisArtifactDetail, AnalysisArtifactListResponse, AnalysisArtifactTarget, AnalysisArtifactMetadataUpdate, ArtifactSaveMode, ArtifactFileSource, JsonArtifactSavePayload, FileArtifactCreatePayload, FileArtifactUpdatePayload, HandlerFileArtifactCreatePayload, HandlerFileArtifactUpdatePayload, ArtifactSavePayload, HandlerArtifactSavePayload, ArtifactSaveDialogPayload, ArtifactSaveResult, ArtifactSaveHandler, HandlerArtifactSaveHandler, ArtifactSaveDialogHandler, } from './analysisArtifactTypes';
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from './analysisArtifactTypes';
+export type { FileBrowserLocation, FileBrowserSortKey, FileDirectoryListing, FileEntry, FileEntryKind, FilePathCrumb, FileSelection, ServerMount, } from './fileBrowserTypes';
 export type { JobListPayload, JobProgress, JobSnapshotPayload, JobState, JobStateInput, JobStatus, JobStreamData, } from './jobs';
 export type { InstrumentAlert, InstrumentAlertBody, InstrumentAlertLevel, InstrumentState, InstrumentStatus, SampleInfo, SampleInfo as InstrumentSampleInfo, SequenceProgress, } from './instrument';
 export type { LcmsContainerType, LcmsPolarity, LcmsSequenceItem, LcmsSequenceTableColumn, } from '../lcms';
@@ -10,3 +11,4 @@ export type { FormFieldType, FieldCondition, FieldValidation, FormFieldSchema, F
 export type { OutlierAction, InputMode, OutlierInfo, ColumnInfo, MetadataRow, AutoGroupResult, ParsedCsvData, } from './auto-group';
 export type { AuthConfig, UserInfo, LoginResponse, TokenVerifyResponse, RegisterRequest, UpdateProfileRequest, CredentialInfo, } from './auth';
 export type { PluginInfo, PluginNavItem, PluginSettings, PluginSettingField, PlatformContext, PlatformContextOptions, PlatformEventType, PlatformEvent, ThemeMode, ColorPalette, TableDensity, UserSummary, } from './platform';
+export type * from './filePicker';

package/dist/{useControlSchema-aMZlb4Sc.js → useControlSchema-DldpxNOP.js}

@@ -1,7 +1,7 @@
-import { c as formatExperimentDate, f as BaseModal_default, h as BaseButton_default, m as useEventListener, p as useFocusTrap } from "./experiment-utils-DV3DrvE_.js";
-import { a as BaseSelect_default, i as BasePill_default, n as useRequestSyncState, o as normalizeOptionInput, r as EmptyState_default, s as BaseInput_default, t as Skeleton_default } from "./Skeleton-DxtwJ5gt.js";
-import { t as useDropdownState } from "./useDropdownState-DitCtrTT.js";
-import { i as useApi, u as tryUseSettingsStore } from "./errors-_W0-LbA6.js";
+import { f as MintApiError, i as useApi, p as mintApiErrorFromResponse, u as tryUseSettingsStore } from "./errors-BLuqMee5.js";
+import { c as formatExperimentDate, f as BaseModal_default, h as BaseButton_default, m as useEventListener, p as useFocusTrap } from "./experiment-utils-CV2Wza3z.js";
+import { a as BaseSelect_default, i as BasePill_default, n as useRequestSyncState, o as normalizeOptionInput, r as EmptyState_default, s as BaseInput_default, t as Skeleton_default } from "./Skeleton-BAF3CKY7.js";
+import { t as useDropdownState } from "./useDropdownState-C7hRiVQf.js";
 import { hasAllPermissions } from "./permissions.js";
 import { Fragment, Teleport, Transition, TransitionGroup, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createStaticVNode, createTextVNode, createVNode, defineComponent, getCurrentInstance, getCurrentScope, isRef, nextTick, normalizeClass, normalizeStyle, onBeforeUnmount, onMounted, onScopeDispose, onUnmounted, openBlock, reactive, ref, renderList, renderSlot, shallowRef, toDisplayString, toValue, unref, useId, useSlots, vModelText, watch, withCtx, withDirectives, withKeys, withModifiers } from "vue";
 import { autoUpdate, computePosition, flip, offset, shift } from "@floating-ui/dom";
@@ -2382,7 +2382,11 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 			default: false
 		},
 		size: { default: "md" },
-		mode: { default: "file" }
+		mode: { default: "file" },
+		showFiles: {
+			type: Boolean,
+			default: true
+		}
 	},
 	emits: [
 		"upload",
@@ -2398,8 +2402,9 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 		const selectedFiles = ref([]);
 		const folderName = ref(null);
 		const isFolder = computed(() => props.mode === "folder");
+		const isMixed = computed(() => props.mode === "file+folder");
 		const acceptLabel = computed(() => {
-			if (!props.accept) return "any file";
+			if (!props.accept) return isFolder.value ? "a folder" : "any file";
 			return props.accept.split(",").map((a) => a.trim().replace(".", "").toUpperCase()).join(", ");
 		});
 		const maxSizeLabel = computed(() => {
@@ -2560,28 +2565,36 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 			if (firstPath) return firstPath.split("/")[0];
 			return null;
 		}
-		function handleDrop(event) {
+		async function handleDrop(event) {
 			event.preventDefault();
 			isDragOver.value = false;
 			if (props.disabled) return;
-			if (isFolder.value && event.dataTransfer?.items) handleFolderDrop(event.dataTransfer.items);
-			else if (event.dataTransfer?.files) handleFiles(event.dataTransfer.files);
+			try {
+				if (props.mode !== "file" && event.dataTransfer?.items?.length) await handleFolderDrop(event.dataTransfer.items);
+				else if (event.dataTransfer?.files) handleFiles(event.dataTransfer.files);
+			} catch (cause) {
+				emit("error", cause instanceof Error ? cause.message : "Could not read the dropped folder.");
+			}
 		}
 		async function handleFolderDrop(items) {
 			const files = [];
 			const relativePaths = [];
 			let folderNameFromDrop;
-			for (const item of Array.from(items)) {
+			const dropped = Array.from(items, (item) => {
 				const entry = item.webkitGetAsEntry?.();
-				if (entry?.isDirectory) {
-					folderNameFromDrop = entry.name;
-					await readDirectory(entry, files, relativePaths, entry.name);
-				} else if (entry?.isFile) {
-					const file = await getFile(entry);
-					if (file) {
-						files.push(file);
-						relativePaths.push(file.name);
-					}
+				return {
+					entry,
+					file: entry ? null : item.getAsFile?.()
+				};
+			});
+			for (const { entry, file: droppedFile } of dropped) if (entry?.isDirectory) {
+				folderNameFromDrop = entry.name;
+				await readDirectory(entry, files, relativePaths, entry.name);
+			} else {
+				const file = entry?.isFile ? await getFile(entry) : droppedFile;
+				if (file) {
+					files.push(file);
+					relativePaths.push(file.name);
 				}
 			}
 			if (files.length > 0) handleFiles(files, folderNameFromDrop, relativePaths);
@@ -2644,7 +2657,7 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 				createElementVNode("div", {
 					role: "button",
 					tabindex: "0",
-					"aria-label": __props.disabled ? "File upload disabled" : "Click or drag files to upload",
+					"aria-label": __props.disabled ? "File upload disabled" : isMixed.value ? "Drop files or a folder, or click to choose files" : isFolder.value ? "Click or drag a folder to upload" : "Click or drag files to upload",
 					"aria-disabled": __props.disabled,
 					class: normalizeClass([
 						"mint-file-uploader__dropzone",
@@ -2672,9 +2685,9 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 					createElementVNode("path", { d: "M20.39 18.39A5 5 0 0 0 18 9h-1.26A8 8 0 1 0 3 16.3" }, null, -1),
 					createElementVNode("path", { d: "m16 16-4-4-4 4" }, null, -1),
 					createElementVNode("path", { d: "M12 12v9" }, null, -1)
-				])])), createElementVNode("p", _hoisted_7$6, " Drop " + toDisplayString(acceptLabel.value) + " or click ", 1)])], 42, _hoisted_2$8),
+				])])), createElementVNode("p", _hoisted_7$6, toDisplayString(isMixed.value ? "Drop files or a folder, or click to choose files" : `Drop ${acceptLabel.value} or click`), 1)])], 42, _hoisted_2$8),
 				_ctx.$slots.actions ? (openBlock(), createElementBlock("div", _hoisted_8$5, [renderSlot(_ctx.$slots, "actions")])) : createCommentVNode("", true),
-				isFolder.value && folderName.value && selectedFiles.value.length > 0 ? (openBlock(), createElementBlock("div", _hoisted_9$3, [createElementVNode("div", _hoisted_10$3, [_cache[2] || (_cache[2] = createElementVNode("div", { class: "mint-file-uploader__folder-icon-wrapper" }, [createElementVNode("svg", {
+				__props.showFiles && isFolder.value && folderName.value && selectedFiles.value.length > 0 ? (openBlock(), createElementBlock("div", _hoisted_9$3, [createElementVNode("div", _hoisted_10$3, [_cache[2] || (_cache[2] = createElementVNode("div", { class: "mint-file-uploader__folder-icon-wrapper" }, [createElementVNode("svg", {
 					class: "mint-file-uploader__folder-icon",
 					fill: "none",
 					stroke: "currentColor",
@@ -2696,7 +2709,7 @@ var FileUploader_default = /* @__PURE__ */ defineComponent({
 					"stroke-linejoin": "round",
 					viewBox: "0 0 24 24"
 				}, [createElementVNode("path", { d: "M18 6 6 18" }), createElementVNode("path", { d: "m6 6 12 12" })], -1)])])])) : createCommentVNode("", true),
-				!isFolder.value && selectedFiles.value.length > 0 ? (openBlock(), createBlock(TransitionGroup, {
+				__props.showFiles && !isFolder.value && selectedFiles.value.length > 0 ? (openBlock(), createBlock(TransitionGroup, {
 					key: 2,
 					tag: "ul",
 					name: "mint-file-uploader-item",
@@ -3406,14 +3419,6 @@ var SESSION_NOT_FOUND_DETAIL = "Session not found";
 var MAX_RESULT_CACHE_ENTRIES = 32;
 var MAX_RESULT_RETRIES = 3;
 var DOWNLOAD_URL_REFRESH_SKEW_MS = 3e4;
-var GeneratedAnalysisRequestError = class extends Error {
-	constructor(status, detail) {
-		super(typeof detail === "string" ? detail : `Request failed (${status})`);
-		this.status = status;
-		this.detail = detail;
-		this.name = "GeneratedAnalysisRequestError";
-	}
-};
 function createGeneratedAnalysisTransport(options = {}) {
 	const fetcher = options.fetcher ?? globalThis.fetch.bind(globalThis);
 	const getAccessToken = options.getAccessToken ?? readStoredAccessToken;
@@ -3894,7 +3899,7 @@ function createPluginJobs(options, manifestPath) {
 		downloadRefreshTimers.delete(jobId);
 	}
 	function handleManagedDownloadRefreshFailure(job, cause) {
-		if (cause instanceof GeneratedAnalysisRequestError) {
+		if (cause instanceof MintApiError) {
 			if (cause.status === 404 || cause.status === 410) {
 				discardCachedResult(job.job_id);
 				jobs.value = jobs.value.map((candidate) => candidate.job_id === job.job_id ? {
@@ -4047,7 +4052,7 @@ function createPluginJobs(options, manifestPath) {
 		});
 		if (!response.ok) {
 			const payload = await response.json().catch(() => null);
-			throw new GeneratedAnalysisRequestError(response.status, payload?.detail);
+			throw mintApiErrorFromResponse(response.status, payload, { requestId: response.headers.get("X-Request-ID") });
 		}
 		return await response.json();
 	}
@@ -4151,13 +4156,13 @@ function createGeneratedSessionStorage(candidate) {
 	};
 }
 function isSessionNotFoundError(error) {
-	return error instanceof GeneratedAnalysisRequestError && error.status === 404 && error.detail === SESSION_NOT_FOUND_DETAIL;
+	return error instanceof MintApiError && error.status === 404 && (error.detail === SESSION_NOT_FOUND_DETAIL || error.message === SESSION_NOT_FOUND_DETAIL);
 }
 function isRetryableResultError(error) {
-	return !(error instanceof GeneratedAnalysisRequestError) || error.status === 409 || error.status === 429 || error.status >= 500;
+	return !(error instanceof MintApiError) || error.status === 409 || error.status === 429 || error.status >= 500;
 }
 function isRetryableJobLookupError(error) {
-	return !(error instanceof GeneratedAnalysisRequestError) || error.status === 408 || error.status === 429 || error.status >= 500;
+	return !(error instanceof MintApiError) || error.status === 408 || error.status === 429 || error.status >= 500;
 }
 function isManagedDownloadResult(result) {
 	return result.kind === "artifact" && result.managed === true;
@@ -7183,4 +7188,4 @@ function useControlSchema(controls, options = {}) {
 //#endregion
 export { resolveJobCapabilities as $, useConcentrationUnits as A, formatTimeSlot as At, currentExperimentFromContext as B, MultiSelect_default as Bt, controlsToViewIds as C, addMinutes as Ct, getTypeDefault as D, findNearestTimeSlotIndex as Dt, getFieldRegistryEntry as E, findAvailableSlots as Et, ATOMIC_WEIGHTS as F, rangesOverlap as Ft, createGeneratedAnalysisTransport as G, BaseToggle_default as Gt, parseExperimentId as H, useSelectionLimit as Ht, useChemicalFormula as I, snapToSlot as It, isActiveJobStatus as J, BaseTextarea_default as Jt, useGeneratedAnalysis as K, BaseCheckbox_default as Kt, GeneratedPathInput_default as L, toMinutes as Lt, SequenceInput_default as M, generateTimeSlots as Mt, useSequenceUtils as N, isTimeInRange as Nt, ConcentrationInput_default as O, formatDuration as Ot, FormulaInput_default as P, parseTime as Pt, normalizeJobState as Q, ArtifactSelectorModal_default as R, useTimeUtils as Rt, controlsToTopBarSettingsConfig as S, TimePicker_default as St, getDefaultControlView as T, durationMinutes as Tt, resolveCurrentExperimentId as U, BaseSlider_default as Ut, getInjectedPlatformContext as V, useListSelection as Vt, resolveCurrentPluginId as W, BaseRadioGroup_default as Wt, jobStatusLabel as X, isTerminalJobStatus as Y, normalizeJobPercent as Z, controlsToFormSchema as _, pluginSecretLabel as _t, defineDoseCalculatorControlProps as a, AlertBox_default as at, controlsToSettingsSchema as b, usesPluginSecretReferences as bt, defineWellPlateDoseComponentBindings as c, SecretInput_default as ct, defineControlModel as d, PLUGIN_SECRET_REF_KEY as dt, useEventStream as et, resolveControlModel as f, clearPluginSecret as ft, mergeControlWorkspaceOptions as g, pluginSecretId as gt, controlValuesToComponentProps as h, keepPluginSecret as ht, useControlSchema as i, _plugin_vue_export_helper_default as it, MoleculeInput_default as j, fromMinutes as jt, UnitInput_default as k, formatTime as kt, defineWellPlateDoseControlProps as l, PLUGIN_SECRET_FORMAT_KEY as lt, controlValuesToComponentBindingsById as m, isPluginSecretRef as mt, defineControls as n, isObjectLike as nt, defineDoseDesignControlModel as o, FileUploader_default as ot, controlValuesToComponentBindings as p, isPluginSecretLocked as pt, usePluginJobs as q, Tooltip_default as qt, getControlDefaults as r, isRecord as rt, defineWellPlateControlProps as s, NumberInput_default as st, defineControlComponentBindings as t, DateTimePicker_default as tt, useControlWorkspace as u, PLUGIN_SECRET_FORMAT_REF as ut, controlsToSectionFormSchema as v, pluginSecretState as vt, controlsToViewItems as w, compareTime as wt, controlsToSidebarPanels as x, TagsInput_default as xt, controlsToSectionFormSchemas as y, setPluginSecret as yt, useAnalysisArtifacts as z, DatePicker_default as zt };
 
-//# sourceMappingURL=useControlSchema-aMZlb4Sc.js.map
+//# sourceMappingURL=useControlSchema-DldpxNOP.js.map