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

package/dist/composables/useListReorder.d.ts

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

package/dist/composables/useMenuKeyboard.d.ts

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

package/dist/composables/usePlatformFilePickerAdapter.d.ts

@@ -0,0 +1,11 @@
+import { PickerAdapter } from '../types/filePicker';
+/** Opaque picker identity; decode before passing a selection to a mount-scoped API. */
+export declare function encodePlatformPickerPath(mountId: string, path?: string): string;
+export declare function decodePlatformPickerPath(path: string): {
+    mountId: string;
+    path: string;
+};
+/** Adapt the authenticated MINT mount API without exposing absolute host paths. */
+export declare function usePlatformFilePickerAdapter(options?: {
+    apiBaseUrl?: string;
+}): PickerAdapter;

package/dist/composables/usePluginConfig.d.ts

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

package/dist/composables/useRequestSyncState.d.ts

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

package/dist/composables/useScheduleDrag.d.ts

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

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

@@ -1,8 +1,10 @@
-import { r as useRequestSyncState } from "./EmptyState-NBqf2_8z.js";
-import { B as currentExperimentFromContext, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, et as useEventStream, lt as PLUGIN_SECRET_FORMAT_KEY } from "./useControlSchema-_OVhavKq.js";
-import { i as useAuthStore, n as authenticationRequiredError, o as useSettingsStore, r as useApi, t as AuthenticationRequiredError } from "./useApi-CDBq6z23.js";
-import { i as usePlatformContext } from "./useFormBuilder-Bd714C7y.js";
-import { computed, getCurrentInstance, onMounted, onUnmounted, ref, shallowRef, toValue, watch } from "vue";
+import { a as useAuthStore, d as useSettingsStore, i as useApi, n as AuthenticationRequiredError, r as authenticationRequiredError, t as readErrorMessage } from "./errors-BLuqMee5.js";
+import { n as useRequestSyncState } from "./Skeleton-BAF3CKY7.js";
+import { B as currentExperimentFromContext, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, et as useEventStream, lt as PLUGIN_SECRET_FORMAT_KEY } from "./useControlSchema-DldpxNOP.js";
+import { n as pickerFormat } from "./validation-uwoJGEb6.js";
+import { i as usePlatformContext } from "./useFormBuilder-z5L_dUIy.js";
+import { bn as rowLabel, pn as PLATE_CONFIGS, yn as rowIndex } from "./templates-CmGfmBRA.js";
+import { computed, getCurrentInstance, getCurrentScope, onMounted, onScopeDispose, onUnmounted, ref, shallowRef, toValue, watch } from "vue";
 import axios from "axios";
 //#region src/composables/useAuth.ts
 var TOKEN_REFRESH_MARGIN_MS = 300 * 1e3;
@@ -637,7 +639,9 @@ function platformOwnedConfigPatch(config) {
 function responseConfigPayload(response) {
 	return response.config ?? response.settings ?? {};
 }
-/** @deprecated Use `usePluginSettings()` for typed plugin settings. */
+/**
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `usePluginSettings()` for typed plugin settings.
+*/
 function usePluginConfig(pluginName) {
 	const injectedContext = getInjectedPlatformContext();
 	const { plugin } = usePlatformContext();
@@ -746,6 +750,212 @@ function usePluginConfig(pluginName) {
 	};
 }
 //#endregion
+//#region src/composables/useFileBrowser.ts
+/**
+* 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.
+*/
+function useFileBrowser(options = {}) {
+	const injectedContext = getInjectedPlatformContext();
+	const api = useApi({ baseUrl: options.apiBaseUrl ?? injectedContext?.platformApiUrl });
+	const sync = useRequestSyncState("Could not read the server mounts.");
+	const mounts = ref([]);
+	const mountId = shallowRef("");
+	const path = shallowRef("");
+	const parent = ref(null);
+	const entries = ref([]);
+	const breadcrumbs = ref([]);
+	const totalCount = ref(null);
+	const matchCount = ref(null);
+	const shownCount = ref(null);
+	const truncated = ref(false);
+	const search = shallowRef("");
+	const sort = shallowRef("name");
+	const selected = ref([]);
+	const mountsLoading = shallowRef(false);
+	const listingLoading = shallowRef(false);
+	const listingReady = shallowRef(false);
+	const isLoading = computed(() => mountsLoading.value || listingLoading.value);
+	let listToken = 0;
+	let mountsToken = 0;
+	let disposed = false;
+	let listingController;
+	let mountsController;
+	let searchTimer;
+	function resetListing() {
+		listingReady.value = false;
+		entries.value = [];
+		breadcrumbs.value = [];
+		parent.value = null;
+		totalCount.value = null;
+		matchCount.value = null;
+		shownCount.value = null;
+		truncated.value = false;
+	}
+	function typeRuleParams() {
+		return (toValue(options.typeRules) ?? []).map((rule) => `&type_rules=${encodeURIComponent(rule)}`).join("");
+	}
+	/** Prefer the API's own `detail` over axios's "Request failed with status N". */
+	function describe(cause, fallback) {
+		const detail = cause?.response?.data?.detail;
+		return typeof detail === "string" && detail ? detail : sync.readErrorMessage(cause, fallback);
+	}
+	function fail(cause, fallback) {
+		sync.setError(new Error(describe(cause, fallback)), fallback);
+	}
+	function statusOf(cause) {
+		return cause?.response?.status;
+	}
+	async function loadMounts() {
+		const token = ++mountsToken;
+		mountsController?.abort();
+		mountsController = new AbortController();
+		mountsLoading.value = true;
+		try {
+			const data = await api.get("/filesystem/mounts", { signal: mountsController.signal });
+			if (disposed || token !== mountsToken) return false;
+			mounts.value = data.mounts ?? [];
+			sync.clearError();
+			sync.markLoaded();
+			return true;
+		} catch (cause) {
+			if (disposed || token !== mountsToken) return false;
+			if (statusOf(cause) === 404) {
+				mounts.value = [];
+				sync.clearError();
+				sync.markLoaded();
+				return true;
+			}
+			mounts.value = [];
+			fail(cause, "Could not read the server mounts.");
+			return false;
+		} finally {
+			if (token === mountsToken) mountsLoading.value = false;
+		}
+	}
+	async function navigate(location) {
+		if (disposed || !location.mount_id) return;
+		clearTimeout(searchTimer);
+		const token = ++listToken;
+		listingController?.abort();
+		listingController = new AbortController();
+		listingLoading.value = true;
+		mountId.value = location.mount_id;
+		path.value = location.path;
+		resetListing();
+		sync.clearError();
+		try {
+			const query = `mount_id=${encodeURIComponent(location.mount_id)}&path=${encodeURIComponent(location.path)}&sort=${sort.value}` + (search.value ? `&search=${encodeURIComponent(search.value)}` : "") + typeRuleParams();
+			const listing = await api.get(`/filesystem/browse?${query}`, { signal: listingController.signal });
+			if (disposed || token !== listToken) return;
+			mountId.value = listing.mount_id;
+			path.value = listing.path;
+			parent.value = listing.parent ?? null;
+			entries.value = listing.entries ?? [];
+			breadcrumbs.value = listing.breadcrumbs ?? [];
+			totalCount.value = listing.total_count ?? null;
+			matchCount.value = listing.match_count ?? null;
+			shownCount.value = listing.shown_count ?? listing.entries?.length ?? null;
+			truncated.value = listing.truncated ?? false;
+			listingReady.value = true;
+			sync.clearError();
+			sync.markLoaded();
+		} catch (cause) {
+			if (disposed || token !== listToken) return;
+			entries.value = [];
+			fail(cause, "Could not read that folder.");
+		} finally {
+			if (token === listToken) listingLoading.value = false;
+		}
+	}
+	async function init() {
+		if (disposed) return;
+		const navigationToken = listToken;
+		if (!await loadMounts() || disposed || navigationToken !== listToken) return;
+		const preferred = toValue(options.initialMountId);
+		const reachable = (mount) => mount.available !== false;
+		const target = mounts.value.find((mount) => mount.id === preferred && reachable(mount)) ?? mounts.value.find(reachable);
+		if (target) await navigate({
+			mount_id: target.id,
+			path: ""
+		});
+		else {
+			mountId.value = "";
+			path.value = "";
+			resetListing();
+		}
+	}
+	async function refresh() {
+		if (disposed) return;
+		if (mountId.value) await navigate({
+			mount_id: mountId.value,
+			path: path.value
+		});
+		else await init();
+	}
+	function selectCurrentFolder() {
+		if (!mountId.value || !listingReady.value || isLoading.value || sync.error.value) return;
+		const crumb = breadcrumbs.value[breadcrumbs.value.length - 1];
+		const key = JSON.stringify([mountId.value, path.value]);
+		if (selected.value.some((item) => JSON.stringify([item.mount_id, item.path]) === key)) return;
+		selected.value = [...selected.value, {
+			mount_id: mountId.value,
+			path: path.value,
+			name: crumb?.label ?? path.value,
+			kind: "directory",
+			child_count: totalCount.value
+		}];
+	}
+	function clear() {
+		selected.value = [];
+	}
+	watch(search, () => {
+		if (!mountId.value) return;
+		clearTimeout(searchTimer);
+		searchTimer = setTimeout(() => {
+			refresh();
+		}, 250);
+	});
+	watch(sort, () => {
+		if (mountId.value) refresh();
+	});
+	watch(() => toValue(options.typeRules), () => {
+		if (mountId.value) refresh();
+	}, { deep: true });
+	if (getCurrentScope()) onScopeDispose(() => {
+		disposed = true;
+		++listToken;
+		++mountsToken;
+		clearTimeout(searchTimer);
+		listingController?.abort();
+		mountsController?.abort();
+	});
+	return {
+		mounts,
+		mountId,
+		path,
+		parent,
+		entries,
+		breadcrumbs,
+		totalCount,
+		matchCount,
+		shownCount,
+		truncated,
+		search,
+		sort,
+		selected,
+		isLoading,
+		error: sync.error,
+		init,
+		navigate,
+		refresh,
+		selectCurrentFolder,
+		clear
+	};
+}
+//#endregion
 //#region src/composables/analysisArtifactTarget.ts
 var EXPERIMENT_ID = "experiment_id";
 var ARTIFACT_PLUGIN_ID = "artifact_plugin_id";
@@ -887,7 +1097,7 @@ function useOptimisticMutation(options) {
 			return result;
 		} catch (err) {
 			options.rollback?.(snapshot, variables, err);
-			error.value = options.readErrorMessage?.(err) ?? readErrorMessage$1(err);
+			error.value = options.readErrorMessage?.(err) ?? readErrorMessage(err);
 			options.onError?.(err, context);
 			throw err;
 		} finally {
@@ -906,12 +1116,6 @@ function useOptimisticMutation(options) {
 		reset
 	};
 }
-function readErrorMessage$1(value) {
-	if (value instanceof Error && value.message) return value.message;
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "object" && value !== null && "message" in value && typeof value.message === "string" && value.message.trim()) return value.message;
-	return "Request failed.";
-}
 //#endregion
 //#region src/composables/useResourceCrud.ts
 /**
@@ -1046,45 +1250,8 @@ function resolveKey(keyOrItem, getKey) {
 	if (typeof keyOrItem === "string" || typeof keyOrItem === "number") return keyOrItem;
 	return getKey(keyOrItem);
 }
-function readErrorMessage(value) {
-	if (value instanceof Error && value.message) return value.message;
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "object" && value !== null && "message" in value && typeof value.message === "string" && value.message.trim()) return value.message;
-	return "Request failed.";
-}
 //#endregion
 //#region src/composables/useWellPainting.ts
-var ROW_LABELS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-var PLATE_DIMENSIONS = {
-	6: {
-		rows: 2,
-		cols: 3
-	},
-	12: {
-		rows: 3,
-		cols: 4
-	},
-	24: {
-		rows: 4,
-		cols: 6
-	},
-	48: {
-		rows: 6,
-		cols: 8
-	},
-	54: {
-		rows: 6,
-		cols: 9
-	},
-	96: {
-		rows: 8,
-		cols: 12
-	},
-	384: {
-		rows: 16,
-		cols: 24
-	}
-};
 /**
 * Pointer painting/rectangle selection state for WellPlate-based editors.
 *
@@ -1164,15 +1331,15 @@ function wellIdToCoordinate(wellId) {
 	const match = /^([A-Z]+)(\d+)$/i.exec(wellId.trim());
 	if (!match) return null;
 	return {
-		row: rowLabelToIndex$1(match[1].toUpperCase()),
+		row: rowIndex(match[1].toUpperCase()),
 		col: Number(match[2]) - 1
 	};
 }
 function coordinateToWellId(coord) {
-	return `${indexToRowLabel$1(coord.row)}${coord.col + 1}`;
+	return `${rowLabel(coord.row)}${coord.col + 1}`;
 }
 function wellIdsInRectangle(start, end, format) {
-	const dimensions = PLATE_DIMENSIONS[format];
+	const dimensions = PLATE_CONFIGS[format];
 	const minRow = Math.max(0, Math.min(start.row, end.row));
 	const maxRow = Math.min(dimensions.rows - 1, Math.max(start.row, end.row));
 	const minCol = Math.max(0, Math.min(start.col, end.col));
@@ -1184,22 +1351,6 @@ function wellIdsInRectangle(start, end, format) {
 	}));
 	return ids;
 }
-function rowLabelToIndex$1(label) {
-	let result = 0;
-	for (const char of label) result = result * 26 + (char.charCodeAt(0) - 64);
-	return result - 1;
-}
-function indexToRowLabel$1(index) {
-	if (index < 26) return ROW_LABELS[index];
-	let value = index + 1;
-	let label = "";
-	while (value > 0) {
-		value--;
-		label = ROW_LABELS[value % 26] + label;
-		value = Math.floor(value / 26);
-	}
-	return label;
-}
 //#endregion
 //#region src/composables/useWellPlateAdapter.ts
 /**
@@ -1578,7 +1729,8 @@ function createPluginClient(contract, options) {
 		const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 		const api = useApi({
 			baseUrl: parts.baseUrl,
-			withAuth: endpoint.requiresAuth !== false
+			withAuth: endpoint.requiresAuth !== false,
+			typedErrors: true
 		});
 		const config = endpointRequestConfig(endpoint, parts.query, callOptions);
 		if (endpoint.method === "get") return api.get(parts.path, config);
@@ -1609,7 +1761,8 @@ async function uploadPluginEndpoint(contract, endpoint, payload, options = {}) {
 	const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 	const api = useApi({
 		baseUrl: parts.baseUrl,
-		withAuth: endpoint.requiresAuth !== false
+		withAuth: endpoint.requiresAuth !== false,
+		typedErrors: true
 	});
 	const body = endpoint.hasBody ? requestBodyFromPayload(payload, parts.requestPayload, endpoint) : payload;
 	if (endpoint.requestContentType === OCTET_STREAM) {
@@ -1634,7 +1787,8 @@ async function downloadPluginEndpoint(contract, endpoint, payload, options = {})
 	const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 	const api = useApi({
 		baseUrl: parts.baseUrl,
-		withAuth: endpoint.requiresAuth !== false
+		withAuth: endpoint.requiresAuth !== false,
+		typedErrors: true
 	});
 	const config = {
 		...endpointRequestConfig(endpoint, parts.query, { signal: options.signal }) ?? {},
@@ -1946,6 +2100,85 @@ function useCurrentExperiment(options = {}) {
 	};
 }
 //#endregion
-export { useAsync as A, createPluginResourceClient as C, buildAnalysisArtifactTargetQuery as D, useCommandHistory as E, resolvePluginFrontendBase as M, usePasskey as N, parseAnalysisArtifactTarget as O, useAuth as P, wellIdsInRectangle as S, useOptimisticMutation as T, createWellPlateWells as _, pluginFormDataFromPayload as a, useWellPainting as b, usePluginClient as c, buildPluginEndpointUrl as d, resolvePluginBaseUrl as f, createRowConditions as g, createColumnConditions as h, getPluginPageSelectorItems as i, useAsyncBatch as j, usePluginConfig as k, usePluginEventStream as l, useWellPlateValidation as m, downloadBlob as n, uploadPluginEndpoint as o, runWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, usePluginSettings as u, useWellPlateAdapter as v, useResourceCrud as w, wellIdToCoordinate as x, coordinateToWellId as y };
+//#region src/composables/usePlatformFilePickerAdapter.ts
+/** Opaque picker identity; decode before passing a selection to a mount-scoped API. */
+function encodePlatformPickerPath(mountId, path = "") {
+	return JSON.stringify([mountId, path]);
+}
+function decodePlatformPickerPath(path) {
+	const decoded = JSON.parse(path);
+	if (!Array.isArray(decoded) || decoded.length !== 2 || !decoded.every((item) => typeof item === "string") || !decoded[0]) throw new Error("Invalid platform picker path.");
+	return {
+		mountId: decoded[0],
+		path: decoded[1]
+	};
+}
+/** Adapt the authenticated MINT mount API without exposing absolute host paths. */
+function usePlatformFilePickerAdapter(options = {}) {
+	const api = useApi({ baseUrl: options.apiBaseUrl ?? getInjectedPlatformContext()?.platformApiUrl });
+	const mountLabels = /* @__PURE__ */ new Map();
+	async function listRoot(request) {
+		try {
+			const { mounts } = await api.get("/filesystem/mounts", { signal: request?.signal });
+			return mounts.map((mount) => {
+				mountLabels.set(mount.id, mount.label);
+				return {
+					kind: "folder",
+					path: encodePlatformPickerPath(mount.id),
+					name: mount.label,
+					parentPath: null,
+					parentName: "Server mounts",
+					unavailableReason: mount.available === false ? "This mount is offline." : void 0
+				};
+			});
+		} catch (cause) {
+			if (cause.response?.status === 404) return [];
+			throw cause;
+		}
+	}
+	async function listChildren(path, request) {
+		const location = decodePlatformPickerPath(path);
+		const query = new URLSearchParams({
+			mount_id: location.mountId,
+			path: location.path
+		});
+		const listing = await api.get(`/filesystem/browse?${query}`, { signal: request?.signal });
+		if (listing.truncated) throw new Error("This directory exceeds the server listing limit. Choose a smaller data directory.");
+		return (listing.entries ?? []).map((entry) => ({
+			kind: entry.kind === "directory" ? "folder" : "file",
+			path: encodePlatformPickerPath(location.mountId, entry.path),
+			parentPath: path,
+			parentName: `${mountLabels.get(location.mountId) ?? location.mountId}${location.path ? ` / ${location.path}` : ""}`,
+			name: entry.name,
+			bytes: entry.size_bytes,
+			...entry.kind === "directory" ? { hasChildren: entry.child_count !== 0 } : { format: pickerFormat(entry.name) }
+		}));
+	}
+	return {
+		listRoot,
+		listChildren,
+		async search(query, scope, request) {
+			const matches = [];
+			const queue = [scope.path];
+			const visited = /* @__PURE__ */ new Set();
+			while (queue.length) {
+				request?.signal?.throwIfAborted();
+				const path = queue.shift();
+				if (visited.has(path)) continue;
+				visited.add(path);
+				if (visited.size > 500) throw new Error("Search reached its folder limit. Search a smaller location or turn off Subfolders.");
+				const nodes = path ? await listChildren(path, request) : await listRoot(request);
+				for (const node of nodes) {
+					if (node.name.toLowerCase().includes(query.toLowerCase())) matches.push(node);
+					if (scope.recursive && node.kind === "folder" && !node.unavailableReason) queue.push(node.path);
+				}
+				if (matches.length > 1e4) throw new Error("Too many search results. Use a more specific search.");
+			}
+			return matches;
+		}
+	};
+}
+//#endregion
+export { buildAnalysisArtifactTargetQuery as A, useWellPainting as C, useResourceCrud as D, createPluginResourceClient as E, useAsyncBatch as F, resolvePluginFrontendBase as I, usePasskey as L, useFileBrowser as M, usePluginConfig as N, useOptimisticMutation as O, useAsync as P, useAuth as R, coordinateToWellId as S, wellIdsInRectangle as T, useWellPlateValidation as _, downloadBlob as a, createWellPlateWells as b, pluginFormDataFromPayload as c, usePluginClient as d, usePluginEventStream as f, runWellPlateValidation as g, resolvePluginBaseUrl as h, createPluginClient as i, parseAnalysisArtifactTarget as j, useCommandHistory as k, uploadPluginEndpoint as l, buildPluginEndpointUrl as m, encodePlatformPickerPath as n, downloadPluginEndpoint as o, usePluginSettings as p, usePlatformFilePickerAdapter as r, getPluginPageSelectorItems as s, decodePlatformPickerPath as t, useCurrentExperiment as u, createColumnConditions as v, wellIdToCoordinate as w, useWellPlateAdapter as x, createRowConditions as y };
 
-//# sourceMappingURL=composables-C8mmD5ta.js.map
+//# sourceMappingURL=composables-mFXsTA4g.js.map