@morscherlab/mint-sdk 1.2.0-beta.2 → 1.2.0-beta.20

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

@@ -1,8 +1,10 @@
-import { r as useRequestSyncState } from "./EmptyState-p90quq8Z.js";
-import { B as currentExperimentFromContext, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, et as useEventStream } from "./useControlSchema-BDx2Olha.js";
-import { i as useAuthStore, n as authenticationRequiredError, o as useSettingsStore, r as useApi, t as AuthenticationRequiredError } from "./useApi-J6zFkHmn.js";
-import { i as usePlatformContext } from "./useFormBuilder-BLxG3BOX.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;
@@ -26,6 +28,7 @@ function useAuth() {
 				passkeyEnabled: response.data.passkey_enabled,
 				passkeyRegistered: response.data.passkey_registered ?? false,
 				registrationEnabled: response.data.registration_enabled ?? false,
+				databaseMode: response.data.database_mode ?? "none",
 				experimentVisibilityMode: response.data.access?.experiment_visibility_mode ?? response.data.access?.experimentVisibilityMode ?? "open"
 			};
 			authStore.setAuthConfig(config);
@@ -37,6 +40,7 @@ function useAuth() {
 				passkeyEnabled: false,
 				passkeyRegistered: false,
 				registrationEnabled: false,
+				databaseMode: "none",
 				experimentVisibilityMode: "open"
 			};
 		}
@@ -504,7 +508,11 @@ function defaultTransformError(error) {
 * const handleSubmit = () => submit(new FormData(formRef.value))
 * ```
 */
-/** Wraps an async function with reactive loading, error, and success state plus optional auto-execute. */
+/**
+* Wraps an async function with reactive loading, error, and success state plus optional auto-execute.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useRequestSyncState()` instead.
+*/
 function useAsync(asyncFn, options = {}) {
 	const { initialData = null, immediate = false, immediateArgs = [], transformError = defaultTransformError, onSuccess, onError, resetOnExecute = false } = options;
 	const data = ref(initialData);
@@ -611,6 +619,343 @@ function useAsyncBatch(asyncFns) {
 	};
 }
 //#endregion
+//#region src/composables/usePluginConfig.ts
+var PLATFORM_OWNED_SETTINGS_KEY$1 = "allowed_experiment_types";
+function cloneConfig(config) {
+	return JSON.parse(JSON.stringify(config));
+}
+function hasOwnConfig(config, key) {
+	return Object.prototype.hasOwnProperty.call(config, key);
+}
+function changedTopLevelKeys(current, saved) {
+	return new Set([...new Set([...Object.keys(current), ...Object.keys(saved)])].filter((key) => JSON.stringify(current[key]) !== JSON.stringify(saved[key])));
+}
+function topLevelConfigPatch(current, keys) {
+	return Object.fromEntries([...keys].map((key) => [key, hasOwnConfig(current, key) ? current[key] : null]));
+}
+function platformOwnedConfigPatch(config) {
+	return { [PLATFORM_OWNED_SETTINGS_KEY$1]: hasOwnConfig(config, PLATFORM_OWNED_SETTINGS_KEY$1) ? config[PLATFORM_OWNED_SETTINGS_KEY$1] : null };
+}
+function responseConfigPayload(response) {
+	return response.config ?? response.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();
+	const platformApi = useApi();
+	const pluginApi = useApi({ baseUrl: injectedContext?.plugin?.api_prefix ?? plugin.value?.api_prefix });
+	const resolvedName = computed(() => pluginName ?? plugin.value?.name ?? injectedContext?.plugin?.name ?? "");
+	const usesPluginSettingsApi = computed(() => {
+		const currentPlugin = injectedContext?.plugin ?? plugin.value;
+		return currentPlugin?.settings_api === "plugin" && resolvedName.value === currentPlugin.name;
+	});
+	const config = ref({});
+	const savedConfig = ref({});
+	const revision = ref(null);
+	const request = useRequestSyncState("Plugin config request failed.");
+	const isLoading = ref(false);
+	const isSaving = ref(false);
+	const error = request.error;
+	const lastLoadedAt = request.lastLoadedAt;
+	const lastSavedAt = request.lastSavedAt;
+	const isDirty = computed(() => {
+		return JSON.stringify(config.value) !== JSON.stringify(savedConfig.value);
+	});
+	async function load() {
+		const name = resolvedName.value;
+		if (!name) return;
+		isLoading.value = true;
+		try {
+			const response = usesPluginSettingsApi.value ? await request.run(() => pluginApi.get("/settings"), {
+				success: "load",
+				errorMessage: "Failed to load plugin config"
+			}) : await request.run(() => platformApi.get(`/plugins/${encodeURIComponent(name)}/config`), {
+				success: "load",
+				errorMessage: "Failed to load plugin config"
+			});
+			const responseConfig = responseConfigPayload(response);
+			config.value = cloneConfig(responseConfig);
+			savedConfig.value = cloneConfig(responseConfig);
+			revision.value = response.revision ?? null;
+		} catch {} finally {
+			isLoading.value = false;
+		}
+	}
+	async function save() {
+		const name = resolvedName.value;
+		if (!name) return false;
+		isSaving.value = true;
+		try {
+			const payload = cloneConfig(config.value);
+			let response;
+			let nextRevision = revision.value;
+			if (usesPluginSettingsApi.value) {
+				response = await request.run(() => pluginApi.put("/settings", payload, revision.value ? { headers: { "If-Match": `"${revision.value}"` } } : void 0), {
+					success: "save",
+					errorMessage: "Failed to save plugin config"
+				});
+				nextRevision = response.revision ?? nextRevision;
+			} else {
+				const dirtyKeys = changedTopLevelKeys(payload, savedConfig.value);
+				const platformOwnedChanged = dirtyKeys.has(PLATFORM_OWNED_SETTINGS_KEY$1);
+				const typedKeys = [...dirtyKeys].filter((key) => key !== PLATFORM_OWNED_SETTINGS_KEY$1);
+				if (typedKeys.length) {
+					response = await request.run(() => platformApi.patch(`/plugins/${encodeURIComponent(name)}/config`, { config: topLevelConfigPatch(payload, typedKeys) }), {
+						success: "save",
+						errorMessage: "Failed to save plugin config"
+					});
+					nextRevision = response.revision ?? nextRevision;
+				}
+				if (platformOwnedChanged) {
+					response = await request.run(() => platformApi.patch(`/plugins/${encodeURIComponent(name)}/config`, { config: platformOwnedConfigPatch(payload) }), {
+						success: "save",
+						errorMessage: "Failed to save plugin config"
+					});
+					nextRevision = response.revision ?? nextRevision;
+				}
+			}
+			if (!response) return true;
+			const responseConfig = responseConfigPayload(response);
+			config.value = cloneConfig(responseConfig);
+			savedConfig.value = cloneConfig(responseConfig);
+			revision.value = response.revision ?? nextRevision;
+			return true;
+		} catch {
+			return false;
+		} finally {
+			isSaving.value = false;
+		}
+	}
+	function reset() {
+		config.value = cloneConfig(savedConfig.value);
+		request.clearError();
+	}
+	onMounted(() => {
+		load();
+	});
+	return {
+		config,
+		isLoading,
+		isSaving,
+		error,
+		lastLoadedAt,
+		lastSavedAt,
+		isDirty,
+		load,
+		save,
+		reset
+	};
+}
+//#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";
@@ -647,7 +992,11 @@ function parseAnalysisArtifactTarget(query) {
 }
 //#endregion
 //#region src/composables/useCommandHistory.ts
-/** Generic command-stack state for plugin editors with undo/redo controls. */
+/**
+* Generic command-stack state for plugin editors with undo/redo controls.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; keep command stacks plugin-local.
+*/
 function useCommandHistory(options = {}) {
 	const maxDepth = Math.max(1, options.maxDepth ?? 50);
 	const undoStack = ref([]);
@@ -710,7 +1059,11 @@ function isPromiseLike(value) {
 }
 //#endregion
 //#region src/composables/useOptimisticMutation.ts
-/** Run async mutations with optional optimistic local updates and rollback. */
+/**
+* Run async mutations with optional optimistic local updates and rollback.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useRequestSyncState()` instead.
+*/
 function useOptimisticMutation(options) {
 	const loading = shallowRef(false);
 	const error = ref(null);
@@ -744,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 {
@@ -763,15 +1116,13 @@ 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
-/** Common list/create/update/delete state wrapper for generated plugin clients. */
+/**
+* Common list/create/update/delete state wrapper for generated plugin clients.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useGeneratedPluginClient()` instead.
+*/
 function useResourceCrud(options) {
 	const items = ref([...options.initialItems ?? []]);
 	const loading = shallowRef(false);
@@ -899,46 +1250,13 @@ 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. */
+/**
+* Pointer painting/rectangle selection state for WellPlate-based editors.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useWellPlateEditor()` instead.
+*/
 function useWellPainting(options) {
 	const activeMode = ref(options.initialMode ?? "select");
 	const activePayload = ref(options.initialPayload);
@@ -1013,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));
@@ -1033,25 +1351,13 @@ 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
-/** Convert domain rows into WellPlate's wells prop without hand-written adapters. */
+/**
+* Convert domain rows into WellPlate's wells prop without hand-written adapters.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useWellPlateEditor()` instead.
+*/
 function useWellPlateAdapter(options) {
 	return { wells: computed(() => createWellPlateWells(toValue(options.entries), options)) };
 }
@@ -1137,7 +1443,11 @@ function indexToRowLabel(index) {
 }
 //#endregion
 //#region src/composables/useWellPlateValidation.ts
-/** Rule-driven validation state for WellPlate layout/design screens. */
+/**
+* Rule-driven validation state for WellPlate layout/design screens.
+*
+* @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `useWellPlateEditor()` instead.
+*/
 function useWellPlateValidation(options) {
 	const warnings = computed(() => runWellPlateValidation(toValue(options.context), toValue(options.rules)));
 	return {
@@ -1419,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);
@@ -1450,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) {
@@ -1475,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 }) ?? {},
@@ -1499,7 +1812,29 @@ async function downloadPluginEndpoint(contract, endpoint, payload, options = {})
 function normalizePluginSettingsOptions(options = {}) {
 	return typeof options === "string" ? { pluginName: options } : options;
 }
+/** @deprecated Use `useGeneratedPluginClient()` for generated clients. */
+function usePluginClient(client) {
+	return client;
+}
 var PLATFORM_OWNED_SETTINGS_KEY = "allowed_experiment_types";
+/**
+* Secret settings travel as `{ "$secret": "<id>" }` references, so an untouched
+* secret round-trips without ever exposing its value. Declaring the format on
+* every write keeps a `null` unambiguous: it clears the stored secret instead of
+* meaning "unchanged", which is what the deprecated placeholder form meant.
+*/
+function withSecretFormat(payload, secretFormat) {
+	if (!secretFormat) return payload;
+	return {
+		...payload,
+		[PLUGIN_SECRET_FORMAT_KEY]: secretFormat
+	};
+}
+function responseSecretFormat(response) {
+	if (!response || typeof response !== "object") return null;
+	const format = response[PLUGIN_SECRET_FORMAT_KEY];
+	return typeof format === "string" && format ? format : null;
+}
 function cloneRecord(value) {
 	return JSON.parse(JSON.stringify(value));
 }
@@ -1537,6 +1872,7 @@ function usePluginSettings(options = {}) {
 	const values = ref({});
 	const savedValues = shallowRef({});
 	const revision = ref(null);
+	const secretFormat = ref(null);
 	const request = useRequestSyncState("Plugin settings request failed.");
 	const isLoading = ref(false);
 	const isSaving = ref(false);
@@ -1557,11 +1893,12 @@ function usePluginSettings(options = {}) {
 	function setValues(nextValues) {
 		values.value = cloneRecord(nextValues);
 	}
-	function applyLoaded(nextValues, nextRevision) {
+	function applyLoaded(nextValues, nextRevision, nextSecretFormat = secretFormat.value) {
 		const cloned = cloneRecord(nextValues);
 		values.value = cloned;
 		savedValues.value = cloneRecord(cloned);
 		revision.value = nextRevision;
+		secretFormat.value = nextSecretFormat;
 	}
 	async function load() {
 		isLoading.value = true;
@@ -1573,7 +1910,7 @@ function usePluginSettings(options = {}) {
 				success: "load",
 				errorMessage: "Failed to load plugin settings"
 			});
-			applyLoaded(responseSettingsPayload(response), responseSettingsRevision(response));
+			applyLoaded(responseSettingsPayload(response), responseSettingsRevision(response), responseSecretFormat(response));
 		} catch {} finally {
 			isLoading.value = false;
 		}
@@ -1590,7 +1927,7 @@ function usePluginSettings(options = {}) {
 				const typedKeys = [...dirtyKeys].filter((key) => key !== PLATFORM_OWNED_SETTINGS_KEY);
 				let nextRevision = revision.value;
 				if (typedKeys.length) {
-					response = await request.run(() => platformApi.patch(`/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`, { config: topLevelSettingsPatch(payload, typedKeys) }), {
+					response = await request.run(() => platformApi.patch(`/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`, { config: withSecretFormat(topLevelSettingsPatch(payload, typedKeys), secretFormat.value) }), {
 						success: "save",
 						errorMessage: "Failed to save plugin settings"
 					});
@@ -1604,16 +1941,16 @@ function usePluginSettings(options = {}) {
 					nextRevision = responseSettingsRevision(response) ?? nextRevision;
 				}
 				if (!response) return true;
-				applyLoaded(responseSettingsPayload(response), nextRevision);
+				applyLoaded(responseSettingsPayload(response), nextRevision, responseSecretFormat(response) ?? secretFormat.value);
 				return true;
 			} else {
 				const ifMatch = revision.value ? { headers: { "If-Match": `"${revision.value}"` } } : void 0;
-				response = await request.run(() => pluginApi.put("/settings", payload, ifMatch), {
+				response = await request.run(() => pluginApi.put("/settings", withSecretFormat(payload, secretFormat.value), ifMatch), {
 					success: "save",
 					errorMessage: "Failed to save plugin settings"
 				});
 			}
-			applyLoaded(responseSettingsPayload(response), responseSettingsRevision(response) ?? revision.value);
+			applyLoaded(responseSettingsPayload(response), responseSettingsRevision(response) ?? revision.value, responseSecretFormat(response) ?? secretFormat.value);
 			return true;
 		} catch {
 			return false;
@@ -1763,6 +2100,85 @@ function useCurrentExperiment(options = {}) {
 	};
 }
 //#endregion
-export { resolvePluginFrontendBase as A, useResourceCrud as C, parseAnalysisArtifactTarget as D, buildAnalysisArtifactTargetQuery as E, useAuth as M, useAsync as O, createPluginResourceClient as S, useCommandHistory as T, useWellPlateAdapter as _, pluginFormDataFromPayload as a, wellIdToCoordinate as b, usePluginEventStream as c, resolvePluginBaseUrl as d, runWellPlateValidation as f, createWellPlateWells as g, createRowConditions as h, getPluginPageSelectorItems as i, usePasskey as j, useAsyncBatch as k, usePluginSettings as l, createColumnConditions as m, downloadBlob as n, uploadPluginEndpoint as o, useWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, buildPluginEndpointUrl as u, coordinateToWellId as v, useOptimisticMutation as w, wellIdsInRectangle as x, useWellPainting 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-C_i90sGS.js.map
+//# sourceMappingURL=composables-mFXsTA4g.js.map