@morscherlab/mint-sdk 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/{useExperimentData-BbbdI5xT.js → useProtocolTemplates-n6AJqSqv.js}

@@ -1,6 +1,6 @@
-import { Bn as useConcentrationUnits, Bt as extractTemplateCollection, Fn as useControlWorkspace, In as getFieldRegistryEntry, Ln as getTypeDefault, Nt as createTemplateCollection, _ as toBioTemplateComponentPropsByComponent$1, _t as createBioTemplatePresetCollectionFromControls, an as getBioTemplatePackInfo, b as toBioTemplateComponentUsage, d as getBioTemplateComponentProps$1, g as toBioTemplateComponentProps, gt as createBioTemplatePresetCollection, h as toBioTemplateComponentImports, ht as createBioTemplatePackCollection, i as createBioTemplateControlToolkit, m as toBioTemplateComponentBindingsById, p as toBioTemplateComponentBindings, tn as getBioTemplatePresetInfo, u as getBioTemplateComponentBindings, v as toBioTemplateComponentPropsById, y as toBioTemplateComponentSnippets, zt as ensureTemplateFromCollection } from "./templates-BSlxwV2c.js";
-import { r as useSettingsStore, t as useAuthStore } from "./auth-CBG3bWEc.js";
-import { computed, effectScope, getCurrentScope, onMounted, onScopeDispose, onUnmounted, provide, reactive, readonly, ref, shallowRef, toRaw, toValue, watch } from "vue";
+import { Bt as ensureTemplateFromCollection, In as useControlWorkspace, Ln as getFieldRegistryEntry, Pt as createTemplateCollection, Rn as getTypeDefault, Vn as useConcentrationUnits, Vt as extractTemplateCollection, _ as toBioTemplateComponentPropsByComponent$1, _t as createBioTemplatePresetCollectionFromControls, b as toBioTemplateComponentUsage, d as getBioTemplateComponentProps$1, g as toBioTemplateComponentProps, gt as createBioTemplatePresetCollection, h as toBioTemplateComponentImports, ht as createBioTemplatePackCollection, i as createBioTemplateControlToolkit, m as toBioTemplateComponentBindingsById, nn as getBioTemplatePresetInfo, on as getBioTemplatePackInfo, p as toBioTemplateComponentBindings, u as getBioTemplateComponentBindings, v as toBioTemplateComponentPropsById, y as toBioTemplateComponentSnippets } from "./templates-BorLR_7p.js";
+import { g as useSettingsStore, t as useAuthStore } from "./auth-B7g4J4ZF.js";
+import { computed, effectScope, getCurrentScope, inject, onMounted, onScopeDispose, onUnmounted, provide, reactive, readonly, ref, shallowRef, toRaw, toValue, watch } from "vue";
 import axios from "axios";
 //#region src/composables/useSortedItems.ts
 /** Shared sorting for SDK tables and lists with stable empty-value handling. */
@@ -673,6 +673,223 @@ function useFormBuilder(schema, initialData, enhancements) {
 	};
 }
 //#endregion
+//#region src/composables/usePlatformContext.ts
+var DEFAULT_CONTEXT = {
+	isIntegrated: false,
+	theme: "system"
+};
+var platformContext = ref({ ...DEFAULT_CONTEXT });
+var inferredOrigins = /* @__PURE__ */ new Set();
+var allowedOrigins = /* @__PURE__ */ new Set();
+var allowAnyOrigin = false;
+var initialized = false;
+var listenerCount = 0;
+var nextConsumerId = 0;
+var currentHandler = null;
+var consumerOrigins = /* @__PURE__ */ new Map();
+var allowAnyOriginConsumers = /* @__PURE__ */ new Set();
+/**
+* Derive origin from URL (protocol + host)
+*/
+function getOriginFromUrl(url) {
+	try {
+		return new URL(url).origin;
+	} catch {
+		return null;
+	}
+}
+function normalizeAllowedOrigins(origins) {
+	const normalized = /* @__PURE__ */ new Set();
+	if (!origins) return normalized;
+	for (const origin of origins) normalized.add(getOriginFromUrl(origin) || origin);
+	return normalized;
+}
+function recomputeOriginPolicy() {
+	allowedOrigins = new Set(inferredOrigins);
+	for (const origins of consumerOrigins.values()) for (const origin of origins) allowedOrigins.add(origin);
+	allowAnyOrigin = allowAnyOriginConsumers.size > 0;
+}
+function resetPlatformContextState() {
+	inferredOrigins = /* @__PURE__ */ new Set();
+	allowedOrigins = /* @__PURE__ */ new Set();
+	allowAnyOrigin = false;
+	initialized = false;
+	listenerCount = 0;
+	currentHandler = null;
+	consumerOrigins.clear();
+	allowAnyOriginConsumers.clear();
+	platformContext.value = { ...DEFAULT_CONTEXT };
+}
+/**
+* Check if an origin is allowed for postMessage communication
+*/
+function isOriginAllowed(origin) {
+	if (allowAnyOrigin) {
+		console.warn("[MINT SDK] postMessage origin validation disabled - only use in development");
+		return true;
+	}
+	if (origin === window.location.origin) return true;
+	return allowedOrigins.has(origin);
+}
+/**
+* Platform context composable for plugin integration with MINT Platform.
+*
+* Provides secure communication with the parent platform via postMessage.
+*
+* @param options - Configuration options
+* @param options.allowedOrigins - List of allowed origins for postMessage
+* @param options.allowAnyOrigin - Allow any origin (UNSAFE, development only)
+*
+* @example
+* ```typescript
+* // Basic usage - derives origin from platform injection
+* const { isIntegrated, user, theme } = usePlatformContext()
+*
+* // With explicit allowed origins
+* const { isIntegrated } = usePlatformContext({
+*   allowedOrigins: ['https://mint.example.com']
+* })
+*
+* // Development mode (UNSAFE)
+* const { isIntegrated } = usePlatformContext({
+*   allowAnyOrigin: import.meta.env.DEV
+* })
+* ```
+*/
+/** Connects a plugin to the MINT platform via postMessage, exposing user, theme, and experiment context. */
+function usePlatformContext(options = {}) {
+	const consumerId = ++nextConsumerId;
+	const instanceOrigins = normalizeAllowedOrigins(options.allowedOrigins);
+	const instanceAllowAnyOrigin = options.allowAnyOrigin === true;
+	function detectPlatform() {
+		const detectedOrigins = /* @__PURE__ */ new Set();
+		const platformData = window.__MINT_PLATFORM__;
+		if (platformData) {
+			platformContext.value = {
+				...platformData,
+				isIntegrated: true
+			};
+			if (platformData.platformOrigin) detectedOrigins.add(platformData.platformOrigin);
+			else if (platformData.platformApiUrl) {
+				const origin = getOriginFromUrl(platformData.platformApiUrl);
+				if (origin) detectedOrigins.add(origin);
+			}
+		} else {
+			const urlParams = new URLSearchParams(window.location.search);
+			const hasPluginParam = urlParams.has("mint-plugin");
+			const platformOrigin = urlParams.get("mint-origin");
+			if (platformOrigin) {
+				const origin = getOriginFromUrl(platformOrigin);
+				if (origin) detectedOrigins.add(origin);
+			}
+			platformContext.value = {
+				isIntegrated: hasPluginParam,
+				theme: (() => {
+					try {
+						const s = localStorage.getItem("mint-settings");
+						if (s) return JSON.parse(s).theme || "system";
+					} catch {}
+					return "system";
+				})(),
+				platformOrigin: platformOrigin || void 0
+			};
+		}
+		inferredOrigins = detectedOrigins;
+	}
+	function handlePlatformMessage(event) {
+		if (event.source !== window.parent) return;
+		if (!isOriginAllowed(event.origin)) {
+			console.warn(`[MINT SDK] Rejected postMessage from untrusted origin: ${event.origin}`);
+			return;
+		}
+		try {
+			const platformEvent = event.data;
+			if (!platformEvent.type?.startsWith("mint:")) return;
+			switch (platformEvent.type) {
+				case "mint:theme-changed":
+					platformContext.value.theme = platformEvent.payload;
+					break;
+				case "mint:user-changed":
+					platformContext.value.user = platformEvent.payload;
+					break;
+			}
+		} catch {}
+	}
+	/**
+	* Send a message to the parent platform.
+	* Uses validated target origin for security.
+	*/
+	function sendToPlatform(event) {
+		if (!platformContext.value.isIntegrated || window.parent === window) return;
+		let targetOrigin;
+		if (platformContext.value.platformOrigin) targetOrigin = platformContext.value.platformOrigin;
+		else if (allowedOrigins.size > 0) targetOrigin = allowedOrigins.values().next().value;
+		else if (allowAnyOrigin) {
+			targetOrigin = "*";
+			console.warn("[MINT SDK] Using wildcard origin for postMessage - only use in development");
+		} else {
+			console.warn("[MINT SDK] Cannot send postMessage: no platform origin configured");
+			return;
+		}
+		window.parent.postMessage(event, targetOrigin);
+	}
+	/**
+	* Request navigation to a path in the platform.
+	*/
+	function navigate(path) {
+		sendToPlatform({
+			type: "mint:navigate",
+			payload: path
+		});
+	}
+	/**
+	* Show a notification in the platform.
+	*/
+	function notify(message, type = "info") {
+		sendToPlatform({
+			type: "mint:notification",
+			payload: {
+				message,
+				type
+			}
+		});
+	}
+	onMounted(() => {
+		consumerOrigins.set(consumerId, instanceOrigins);
+		if (instanceAllowAnyOrigin) allowAnyOriginConsumers.add(consumerId);
+		if (!initialized) {
+			detectPlatform();
+			currentHandler = handlePlatformMessage;
+			window.addEventListener("message", handlePlatformMessage);
+			initialized = true;
+		}
+		listenerCount++;
+		recomputeOriginPolicy();
+	});
+	onUnmounted(() => {
+		consumerOrigins.delete(consumerId);
+		allowAnyOriginConsumers.delete(consumerId);
+		listenerCount = Math.max(0, listenerCount - 1);
+		if (listenerCount === 0) {
+			if (currentHandler) window.removeEventListener("message", currentHandler);
+			resetPlatformContextState();
+			return;
+		}
+		recomputeOriginPolicy();
+	});
+	return {
+		context: platformContext,
+		isIntegrated: computed(() => platformContext.value.isIntegrated),
+		plugin: computed(() => platformContext.value.plugin),
+		user: computed(() => platformContext.value.user),
+		theme: computed(() => platformContext.value.theme),
+		features: computed(() => platformContext.value.features),
+		navigate,
+		notify,
+		sendToPlatform
+	};
+}
+//#endregion
 //#region src/composables/experiment-utils.ts
 function formatExperimentDate(dateStr) {
 	try {
@@ -1191,270 +1408,53 @@ function useExperimentSelector(options = {}) {
 	const groupedByProject = computed(() => {
 		const groups = /* @__PURE__ */ new Map();
 		for (const exp of experiments.value) {
-			const key = exp.project_name ?? exp.project ?? "No project";
-			const list = groups.get(key);
-			if (list) list.push(exp);
-			else groups.set(key, [exp]);
-		}
-		return [...groups.entries()].sort(([a], [b]) => {
-			if (a === "No project") return 1;
-			if (b === "No project") return -1;
-			return a.localeCompare(b);
-		});
-	});
-	const searchWatch = useDebouncedWatch(() => filters.search, () => {
-		page.value = 0;
-		fetchExperiments();
-	}, { delay: 300 });
-	watch(() => [
-		filters.status,
-		filters.project,
-		filters.experimentType,
-		filters.datePreset,
-		sortKey.value
-	], () => {
-		searchWatch.cancel();
-		page.value = 0;
-		fetchExperiments();
-	});
-	if (immediate) fetchExperiments();
-	return {
-		experiments,
-		total,
-		selectedExperiment,
-		filters,
-		isLoading,
-		error,
-		lastLoadedAt,
-		page,
-		hasMore,
-		sortKey,
-		experimentTypes,
-		projects,
-		groupedByProject,
-		fetch: fetchExperiments,
-		loadMore,
-		reset,
-		select,
-		clear,
-		fetchFilterOptions
-	};
-}
-//#endregion
-//#region src/composables/usePlatformContext.ts
-var DEFAULT_CONTEXT = {
-	isIntegrated: false,
-	theme: "system"
-};
-var platformContext = ref({ ...DEFAULT_CONTEXT });
-var inferredOrigins = /* @__PURE__ */ new Set();
-var allowedOrigins = /* @__PURE__ */ new Set();
-var allowAnyOrigin = false;
-var initialized = false;
-var listenerCount = 0;
-var nextConsumerId = 0;
-var currentHandler = null;
-var consumerOrigins = /* @__PURE__ */ new Map();
-var allowAnyOriginConsumers = /* @__PURE__ */ new Set();
-/**
-* Derive origin from URL (protocol + host)
-*/
-function getOriginFromUrl(url) {
-	try {
-		return new URL(url).origin;
-	} catch {
-		return null;
-	}
-}
-function normalizeAllowedOrigins(origins) {
-	const normalized = /* @__PURE__ */ new Set();
-	if (!origins) return normalized;
-	for (const origin of origins) normalized.add(getOriginFromUrl(origin) || origin);
-	return normalized;
-}
-function recomputeOriginPolicy() {
-	allowedOrigins = new Set(inferredOrigins);
-	for (const origins of consumerOrigins.values()) for (const origin of origins) allowedOrigins.add(origin);
-	allowAnyOrigin = allowAnyOriginConsumers.size > 0;
-}
-function resetPlatformContextState() {
-	inferredOrigins = /* @__PURE__ */ new Set();
-	allowedOrigins = /* @__PURE__ */ new Set();
-	allowAnyOrigin = false;
-	initialized = false;
-	listenerCount = 0;
-	currentHandler = null;
-	consumerOrigins.clear();
-	allowAnyOriginConsumers.clear();
-	platformContext.value = { ...DEFAULT_CONTEXT };
-}
-/**
-* Check if an origin is allowed for postMessage communication
-*/
-function isOriginAllowed(origin) {
-	if (allowAnyOrigin) {
-		console.warn("[MINT SDK] postMessage origin validation disabled - only use in development");
-		return true;
-	}
-	if (origin === window.location.origin) return true;
-	return allowedOrigins.has(origin);
-}
-/**
-* Platform context composable for plugin integration with MINT Platform.
-*
-* Provides secure communication with the parent platform via postMessage.
-*
-* @param options - Configuration options
-* @param options.allowedOrigins - List of allowed origins for postMessage
-* @param options.allowAnyOrigin - Allow any origin (UNSAFE, development only)
-*
-* @example
-* ```typescript
-* // Basic usage - derives origin from platform injection
-* const { isIntegrated, user, theme } = usePlatformContext()
-*
-* // With explicit allowed origins
-* const { isIntegrated } = usePlatformContext({
-*   allowedOrigins: ['https://mint.example.com']
-* })
-*
-* // Development mode (UNSAFE)
-* const { isIntegrated } = usePlatformContext({
-*   allowAnyOrigin: import.meta.env.DEV
-* })
-* ```
-*/
-/** Connects a plugin to the MINT platform via postMessage, exposing user, theme, and experiment context. */
-function usePlatformContext(options = {}) {
-	const consumerId = ++nextConsumerId;
-	const instanceOrigins = normalizeAllowedOrigins(options.allowedOrigins);
-	const instanceAllowAnyOrigin = options.allowAnyOrigin === true;
-	function detectPlatform() {
-		const detectedOrigins = /* @__PURE__ */ new Set();
-		const platformData = window.__MINT_PLATFORM__;
-		if (platformData) {
-			platformContext.value = {
-				...platformData,
-				isIntegrated: true
-			};
-			if (platformData.platformOrigin) detectedOrigins.add(platformData.platformOrigin);
-			else if (platformData.platformApiUrl) {
-				const origin = getOriginFromUrl(platformData.platformApiUrl);
-				if (origin) detectedOrigins.add(origin);
-			}
-		} else {
-			const urlParams = new URLSearchParams(window.location.search);
-			const hasPluginParam = urlParams.has("mint-plugin");
-			const platformOrigin = urlParams.get("mint-origin");
-			if (platformOrigin) {
-				const origin = getOriginFromUrl(platformOrigin);
-				if (origin) detectedOrigins.add(origin);
-			}
-			platformContext.value = {
-				isIntegrated: hasPluginParam,
-				theme: (() => {
-					try {
-						const s = localStorage.getItem("mint-settings");
-						if (s) return JSON.parse(s).theme || "system";
-					} catch {}
-					return "system";
-				})(),
-				platformOrigin: platformOrigin || void 0
-			};
-		}
-		inferredOrigins = detectedOrigins;
-	}
-	function handlePlatformMessage(event) {
-		if (event.source !== window.parent) return;
-		if (!isOriginAllowed(event.origin)) {
-			console.warn(`[MINT SDK] Rejected postMessage from untrusted origin: ${event.origin}`);
-			return;
-		}
-		try {
-			const platformEvent = event.data;
-			if (!platformEvent.type?.startsWith("mint:")) return;
-			switch (platformEvent.type) {
-				case "mint:theme-changed":
-					platformContext.value.theme = platformEvent.payload;
-					break;
-				case "mint:user-changed":
-					platformContext.value.user = platformEvent.payload;
-					break;
-			}
-		} catch {}
-	}
-	/**
-	* Send a message to the parent platform.
-	* Uses validated target origin for security.
-	*/
-	function sendToPlatform(event) {
-		if (!platformContext.value.isIntegrated || window.parent === window) return;
-		let targetOrigin;
-		if (platformContext.value.platformOrigin) targetOrigin = platformContext.value.platformOrigin;
-		else if (allowedOrigins.size > 0) targetOrigin = allowedOrigins.values().next().value;
-		else if (allowAnyOrigin) {
-			targetOrigin = "*";
-			console.warn("[MINT SDK] Using wildcard origin for postMessage - only use in development");
-		} else {
-			console.warn("[MINT SDK] Cannot send postMessage: no platform origin configured");
-			return;
-		}
-		window.parent.postMessage(event, targetOrigin);
-	}
-	/**
-	* Request navigation to a path in the platform.
-	*/
-	function navigate(path) {
-		sendToPlatform({
-			type: "mint:navigate",
-			payload: path
-		});
-	}
-	/**
-	* Show a notification in the platform.
-	*/
-	function notify(message, type = "info") {
-		sendToPlatform({
-			type: "mint:notification",
-			payload: {
-				message,
-				type
-			}
-		});
-	}
-	onMounted(() => {
-		consumerOrigins.set(consumerId, instanceOrigins);
-		if (instanceAllowAnyOrigin) allowAnyOriginConsumers.add(consumerId);
-		if (!initialized) {
-			detectPlatform();
-			currentHandler = handlePlatformMessage;
-			window.addEventListener("message", handlePlatformMessage);
-			initialized = true;
-		}
-		listenerCount++;
-		recomputeOriginPolicy();
-	});
-	onUnmounted(() => {
-		consumerOrigins.delete(consumerId);
-		allowAnyOriginConsumers.delete(consumerId);
-		listenerCount = Math.max(0, listenerCount - 1);
-		if (listenerCount === 0) {
-			if (currentHandler) window.removeEventListener("message", currentHandler);
-			resetPlatformContextState();
-			return;
+			const key = exp.project_name ?? exp.project ?? "No project";
+			const list = groups.get(key);
+			if (list) list.push(exp);
+			else groups.set(key, [exp]);
 		}
-		recomputeOriginPolicy();
+		return [...groups.entries()].sort(([a], [b]) => {
+			if (a === "No project") return 1;
+			if (b === "No project") return -1;
+			return a.localeCompare(b);
+		});
+	});
+	const searchWatch = useDebouncedWatch(() => filters.search, () => {
+		page.value = 0;
+		fetchExperiments();
+	}, { delay: 300 });
+	watch(() => [
+		filters.status,
+		filters.project,
+		filters.experimentType,
+		filters.datePreset,
+		sortKey.value
+	], () => {
+		searchWatch.cancel();
+		page.value = 0;
+		fetchExperiments();
 	});
+	if (immediate) fetchExperiments();
 	return {
-		context: platformContext,
-		isIntegrated: computed(() => platformContext.value.isIntegrated),
-		plugin: computed(() => platformContext.value.plugin),
-		user: computed(() => platformContext.value.user),
-		theme: computed(() => platformContext.value.theme),
-		features: computed(() => platformContext.value.features),
-		navigate,
-		notify,
-		sendToPlatform
+		experiments,
+		total,
+		selectedExperiment,
+		filters,
+		isLoading,
+		error,
+		lastLoadedAt,
+		page,
+		hasMore,
+		sortKey,
+		experimentTypes,
+		projects,
+		groupedByProject,
+		fetch: fetchExperiments,
+		loadMore,
+		reset,
+		select,
+		clear,
+		fetchFilterOptions
 	};
 }
 //#endregion
@@ -2098,6 +2098,108 @@ function useWellPlateEditor(initialState, options = {}) {
 	};
 }
 //#endregion
+//#region src/composables/experimentDesignData.ts
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isPlatformDesignDataResponse(value) {
+	return "data" in value && ("experiment_id" in value || "plugin_id" in value || "schema_version" in value || "updated_at" in value);
+}
+/** Return the plugin-defined design_data payload from common platform and plugin response shapes. */
+function unwrapExperimentDesignData(rawData) {
+	if (!rawData) return null;
+	if (isRecord(rawData.data) && isPlatformDesignDataResponse(rawData)) return rawData.data;
+	if (isRecord(rawData.design_data)) return rawData.design_data;
+	if (isRecord(rawData.designData)) return rawData.designData;
+	return rawData;
+}
+function shouldIncludeSample(record, options) {
+	if (options.includeControls) return true;
+	const rawType = record.sample_type ?? record.sampleType ?? record.type ?? record.well_type ?? record.wellType;
+	const type = typeof rawType === "string" ? rawType.toLowerCase() : "";
+	return !["blank", "qc"].includes(type);
+}
+function readSampleValue(record) {
+	const candidates = [
+		record.sample_name,
+		record.sampleName,
+		record.sample_id,
+		record.sampleId,
+		record.name,
+		record.id,
+		record.label
+	];
+	for (const candidate of candidates) {
+		if (typeof candidate === "string" && candidate.trim()) return candidate;
+		if (typeof candidate === "number" && Number.isFinite(candidate)) return String(candidate);
+	}
+	return null;
+}
+function readSampleLabel(record, fallback) {
+	const label = record.name ?? record.label ?? record.sample_name ?? record.sampleName;
+	return typeof label === "string" && label.trim() ? label : fallback;
+}
+function readSampleDescription(record) {
+	const parts = [
+		record.group,
+		record.batch,
+		record.batch_id,
+		record.batchId,
+		record.plate_id,
+		record.plateId,
+		record.well_id,
+		record.wellId
+	].filter((value) => typeof value === "string" && value.trim().length > 0 || typeof value === "number");
+	return parts.length > 0 ? parts.map(String).join(" / ") : void 0;
+}
+function addSampleRecord(options, seen, value, extractOptions) {
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		if (trimmed && !seen.has(trimmed)) {
+			seen.add(trimmed);
+			options.push({
+				value: trimmed,
+				label: trimmed
+			});
+		}
+		return;
+	}
+	if (!isRecord(value) || !shouldIncludeSample(value, extractOptions)) return;
+	const sampleValue = readSampleValue(value);
+	if (!sampleValue || seen.has(sampleValue)) return;
+	seen.add(sampleValue);
+	options.push({
+		value: sampleValue,
+		label: readSampleLabel(value, sampleValue),
+		description: readSampleDescription(value)
+	});
+}
+function addSampleArray(options, seen, value, extractOptions) {
+	if (!Array.isArray(value)) return;
+	for (const sample of value) addSampleRecord(options, seen, sample, extractOptions);
+}
+/** Extract selectable sample options from raw or wrapped experiment design_data. */
+function extractSampleOptionsFromDesignData(rawData, options = {}) {
+	const designData = unwrapExperimentDesignData(rawData);
+	if (!designData) return [];
+	const sampleOptions = [];
+	const seen = /* @__PURE__ */ new Set();
+	addSampleArray(sampleOptions, seen, designData.samples, options);
+	if (isRecord(designData.templates)) for (const template of Object.values(designData.templates)) {
+		if (!isRecord(template)) continue;
+		addSampleArray(sampleOptions, seen, (isRecord(template.data) ? template.data : template).samples, options);
+	}
+	if (Array.isArray(designData.plates)) for (const plate of designData.plates) {
+		if (!isRecord(plate)) continue;
+		addSampleArray(sampleOptions, seen, plate.samples, options);
+	}
+	return sampleOptions;
+}
+/** Extract SampleSelector-compatible string values from raw or wrapped experiment design_data. */
+function extractSampleNamesFromDesignData(rawData, options = {}) {
+	return extractSampleOptionsFromDesignData(rawData, options).map((sample) => sample.value);
+}
+//#endregion
 //#region src/composables/useAutoGroup.ts
 var DEFAULT_COLORS = [
 	"#3B82F6",
@@ -2323,7 +2425,9 @@ function computeGroups(allSamples, columns, enabledFields, outlierActions, delim
 * Returns null if no samples with conditions are found.
 */
 function extractSamplesFromDesignData(rawData) {
-	const samples = rawData.samples;
+	const designData = unwrapExperimentDesignData(rawData);
+	if (!designData) return null;
+	const samples = designData.samples;
 	if (!Array.isArray(samples) || samples.length === 0) return null;
 	const allConditionKeys = [];
 	const keySet = /* @__PURE__ */ new Set();
@@ -2772,6 +2876,169 @@ function normalizeIds(ids) {
 	return [...new Set(ids.filter(Boolean))];
 }
 //#endregion
+//#region src/composables/platformContextHelpers.ts
+function getInjectedPlatformContext() {
+	if (typeof window === "undefined") return void 0;
+	return window.__MINT_PLATFORM__;
+}
+function getInjectedExperimentContext() {
+	return getInjectedPlatformContext();
+}
+function currentExperimentFromContext(context = getInjectedExperimentContext()) {
+	const candidate = context?.currentExperiment ?? context?.experiment;
+	return candidate && typeof candidate === "object" ? candidate : void 0;
+}
+function currentExperimentIdFromContext(context = getInjectedExperimentContext()) {
+	return parseExperimentId(context?.currentExperimentId ?? context?.experimentId ?? context?.currentExperiment ?? context?.experiment);
+}
+function currentExperimentIdFromUrl() {
+	if (typeof window === "undefined") return void 0;
+	const params = new URLSearchParams(window.location.search);
+	return parseExperimentId(params.get("experimentId") ?? params.get("experiment_id")) ?? experimentIdFromPath(window.location.pathname) ?? experimentIdFromPath(window.location.hash.replace(/^#\/?/, "/"));
+}
+function resolveCurrentExperimentId(context = getInjectedExperimentContext()) {
+	return currentExperimentIdFromContext(context) ?? currentExperimentIdFromUrl();
+}
+function parseExperimentId(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim()) {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) ? parsed : void 0;
+	}
+	if (value && typeof value === "object" && "id" in value) return parseExperimentId(value.id);
+}
+function experimentIdFromPath(path) {
+	const segments = path.split("/").filter(Boolean);
+	for (let index = 0; index < segments.length - 1; index += 1) {
+		const segment = segments[index]?.toLowerCase();
+		if (segment === "experiment" || segment === "experiments") return parseExperimentId(decodeURIComponent(segments[index + 1] ?? ""));
+	}
+}
+//#endregion
+//#region src/composables/useExperimentData.ts
+/** Fetches and normalises experiment output data (tree, table, summary) from the platform API. */
+function useExperimentData(options = {}) {
+	const data = shallowRef(null);
+	const request = useRequestSyncState("Failed to fetch experiment data");
+	const isLoading = request.loading;
+	const error = request.error;
+	const lastLoadedAt = request.lastLoadedAt;
+	let lastExperimentId = null;
+	let api = null;
+	function getApi() {
+		api ??= useApi({ baseUrl: options.apiBaseUrl });
+		return api;
+	}
+	const designData = computed(() => unwrapExperimentDesignData(data.value));
+	const sampleNames = computed(() => extractSampleNamesFromDesignData(designData.value));
+	const sampleOptions = computed(() => extractSampleOptionsFromDesignData(designData.value));
+	const treeData = computed(() => {
+		if (!designData.value) return [];
+		const tree = designData.value.tree_data ?? designData.value.treeData;
+		return Array.isArray(tree) ? tree : [];
+	});
+	const tableData = computed(() => {
+		if (!designData.value) return [];
+		const table = designData.value.table_data ?? designData.value.tableData;
+		return Array.isArray(table) ? table : [];
+	});
+	const summaryData = computed(() => {
+		if (!designData.value) return null;
+		const summary = designData.value.summary_data ?? designData.value.summaryData;
+		if (summary && typeof summary === "object" && "metadata" in summary) return summary;
+		return null;
+	});
+	async function fetchData(experimentId) {
+		lastExperimentId = experimentId;
+		try {
+			data.value = await request.run(() => getApi().get(`/experiments/${experimentId}/data`), {
+				success: "load",
+				errorMessage: "Failed to fetch experiment data"
+			});
+			return data.value;
+		} catch {
+			data.value = null;
+			return null;
+		}
+	}
+	async function refresh() {
+		if (lastExperimentId !== null) await fetchData(lastExperimentId);
+	}
+	function clear() {
+		data.value = null;
+		lastExperimentId = null;
+		request.clearError();
+	}
+	return {
+		data,
+		designData,
+		sampleNames,
+		sampleOptions,
+		treeData,
+		tableData,
+		summaryData,
+		isLoading,
+		error,
+		lastLoadedAt,
+		fetch: fetchData,
+		refresh,
+		clear
+	};
+}
+//#endregion
+//#region src/composables/useExperimentSamples.ts
+/** Loads experiment design_data and derives samples for SampleSelector-style UIs. */
+function useExperimentSamples(options = {}) {
+	const appExperiment = options.syncAppExperiment === false ? void 0 : inject(APP_EXPERIMENT_KEY, void 0);
+	const experimentData = useExperimentData({ apiBaseUrl: options.apiBaseUrl });
+	const experimentId = computed(() => {
+		return parseExperimentId(toValue(options.experimentId)) ?? parseExperimentId(appExperiment?.experimentId.value);
+	});
+	const explicitDesignData = computed(() => unwrapExperimentDesignData(toValue(options.designData) ?? null));
+	const designData = computed(() => explicitDesignData.value ?? experimentData.designData.value);
+	const extractOptions = computed(() => ({ includeControls: options.includeControls }));
+	const samples = computed(() => extractSampleNamesFromDesignData(designData.value, extractOptions.value));
+	const sampleOptions = computed(() => extractSampleOptionsFromDesignData(designData.value, extractOptions.value));
+	const enabled = computed(() => toValue(options.enabled) ?? true);
+	async function fetchSamples(id = experimentId.value) {
+		const parsedId = parseExperimentId(id);
+		if (parsedId === void 0) {
+			experimentData.clear();
+			return null;
+		}
+		return experimentData.fetch(parsedId);
+	}
+	watch(() => ({
+		designData: explicitDesignData.value,
+		enabled: enabled.value,
+		experimentId: experimentId.value
+	}), ({ designData: currentDesignData, enabled: isEnabled, experimentId: currentExperimentId }) => {
+		if (options.immediate === false || !isEnabled) return;
+		if (currentDesignData) {
+			experimentData.clear();
+			return;
+		}
+		if (currentExperimentId === void 0) {
+			experimentData.clear();
+			return;
+		}
+		experimentData.fetch(currentExperimentId);
+	}, { immediate: options.immediate !== false });
+	return {
+		experimentId,
+		data: experimentData.data,
+		designData,
+		samples,
+		sampleOptions,
+		isLoading: experimentData.isLoading,
+		error: experimentData.error,
+		lastLoadedAt: experimentData.lastLoadedAt,
+		fetch: fetchSamples,
+		refresh: experimentData.refresh,
+		clear: experimentData.clear
+	};
+}
+//#endregion
 //#region src/composables/useScheduleDrag.ts
 /** Handles pointer-driven create, move, and resize drag interactions for the ScheduleCalendar grid. */
 function useScheduleDrag(options) {
@@ -2952,45 +3219,6 @@ function clampRange(start, end, min, max) {
 	};
 }
 //#endregion
-//#region src/composables/platformContextHelpers.ts
-function getInjectedPlatformContext() {
-	if (typeof window === "undefined") return void 0;
-	return window.__MINT_PLATFORM__;
-}
-function getInjectedExperimentContext() {
-	return getInjectedPlatformContext();
-}
-function currentExperimentFromContext(context = getInjectedExperimentContext()) {
-	const candidate = context?.currentExperiment ?? context?.experiment;
-	return candidate && typeof candidate === "object" ? candidate : void 0;
-}
-function currentExperimentIdFromContext(context = getInjectedExperimentContext()) {
-	return parseExperimentId(context?.currentExperimentId ?? context?.experimentId ?? context?.currentExperiment ?? context?.experiment);
-}
-function currentExperimentIdFromUrl() {
-	if (typeof window === "undefined") return void 0;
-	const params = new URLSearchParams(window.location.search);
-	return parseExperimentId(params.get("experimentId") ?? params.get("experiment_id")) ?? experimentIdFromPath(window.location.pathname) ?? experimentIdFromPath(window.location.hash.replace(/^#\/?/, "/"));
-}
-function resolveCurrentExperimentId(context = getInjectedExperimentContext()) {
-	return currentExperimentIdFromContext(context) ?? currentExperimentIdFromUrl();
-}
-function parseExperimentId(value) {
-	if (typeof value === "number" && Number.isFinite(value)) return value;
-	if (typeof value === "string" && value.trim()) {
-		const parsed = Number(value);
-		return Number.isFinite(parsed) ? parsed : void 0;
-	}
-	if (value && typeof value === "object" && "id" in value) return parseExperimentId(value.id);
-}
-function experimentIdFromPath(path) {
-	const segments = path.split("/").filter(Boolean);
-	for (let index = 0; index < segments.length - 1; index += 1) {
-		const segment = segments[index]?.toLowerCase();
-		if (segment === "experiment" || segment === "experiments") return parseExperimentId(decodeURIComponent(segments[index + 1] ?? ""));
-	}
-}
-//#endregion
 //#region src/composables/useExperimentSave.ts
 /** Persists experiment design, analysis, and built-in template preset data through the platform API. */
 function useExperimentSave(options = {}) {
@@ -4428,59 +4656,6 @@ function useProtocolTemplates() {
 	};
 }
 //#endregion
-//#region src/composables/useExperimentData.ts
-/** Fetches and normalises experiment output data (tree, table, summary) from the platform API. */
-function useExperimentData(options = {}) {
-	const api = useApi({ baseUrl: options.apiBaseUrl });
-	const data = ref(null);
-	const request = useRequestSyncState("Failed to fetch experiment data");
-	const isLoading = request.loading;
-	const error = request.error;
-	const lastLoadedAt = request.lastLoadedAt;
-	let lastExperimentId = null;
-	const treeData = computed(() => {
-		if (!data.value) return [];
-		const tree = data.value.tree_data ?? data.value.treeData;
-		return Array.isArray(tree) ? tree : [];
-	});
-	const tableData = computed(() => {
-		if (!data.value) return [];
-		const table = data.value.table_data ?? data.value.tableData;
-		return Array.isArray(table) ? table : [];
-	});
-	const summaryData = computed(() => {
-		if (!data.value) return null;
-		const summary = data.value.summary_data ?? data.value.summaryData;
-		if (summary && typeof summary === "object" && "metadata" in summary) return summary;
-		return null;
-	});
-	async function fetchData(experimentId) {
-		lastExperimentId = experimentId;
-		try {
-			data.value = await request.run(() => api.get(`/experiments/${experimentId}/data`), {
-				success: "load",
-				errorMessage: "Failed to fetch experiment data"
-			});
-		} catch {
-			data.value = null;
-		}
-	}
-	async function refresh() {
-		if (lastExperimentId !== null) await fetchData(lastExperimentId);
-	}
-	return {
-		data,
-		treeData,
-		tableData,
-		summaryData,
-		isLoading,
-		error,
-		lastLoadedAt,
-		fetch: fetchData,
-		refresh
-	};
-}
-//#endregion
-export { useTheme as $, useAutoGroup as A, DATE_PRESET_OPTIONS as B, useSampleGroups as C, DEFAULT_COLORS as D, hslToHex as E, usePlatformContext as F, datePresetToISO as G, EXPERIMENT_STATUS_OPTIONS as H, useExperimentSelector as I, getExperimentStatusVariant as J, formatExperimentDate as K, useRequestSyncState as L, useDoseCalculator as M, APP_EXPERIMENT_KEY as N, extractSamplesFromDesignData as O, useAppExperiment as P, useForm as Q, useDebouncedWatch as R, useExpansionSet as S, hexToHsl as T, EXPERIMENT_STATUS_VARIANT_MAP as U, EXPERIMENT_STATUS_LABELS as V, SORT_OPTIONS as W, evaluateCondition as X, resolveExperimentCode as Y, useFormBuilder as Z, useExperimentSave as _, generateDilutionSeries as a, useSortedItems as at, resolveCurrentExperimentId as b, useRackEditor as c, useBioTemplateWorkspace as d, useToast as et, getBioTemplateComponentProps as f, useTemplateCollection as g, useBioTemplateControls as h, DEFAULT_UNITS as i, compareSortValues as it, useWellPlateEditor as j, parseCSV as k, useBioTemplatePresetWorkspace as l, useBioTemplateComponents as m, useProtocolTemplates as n, normalizeSearchQuery as nt, useReagentSeries as o, toBioTemplateComponentPropsByComponent as p, formatExperimentStatus as q, DEFAULT_PRESETS as r, useTextSearch as rt, useGroupAssignment as s, useExperimentData as t, candidateMatchesSearch as tt, useBioTemplatePackWorkspace as u, currentExperimentFromContext as v, deriveShade as w, useScheduleDrag as x, getInjectedPlatformContext as y, useApi as z };
+export { usePlatformContext as $, parseCSV as A, useRequestSyncState as B, useExpansionSet as C, hslToHex as D, hexToHsl as E, useWellPlateEditor as F, EXPERIMENT_STATUS_OPTIONS as G, useApi as H, useDoseCalculator as I, datePresetToISO as J, EXPERIMENT_STATUS_VARIANT_MAP as K, APP_EXPERIMENT_KEY as L, extractSampleNamesFromDesignData as M, extractSampleOptionsFromDesignData as N, DEFAULT_COLORS as O, unwrapExperimentDesignData as P, resolveExperimentCode as Q, useAppExperiment as R, resolveCurrentExperimentId as S, deriveShade as T, DATE_PRESET_OPTIONS as U, useDebouncedWatch as V, EXPERIMENT_STATUS_LABELS as W, formatExperimentStatus as X, formatExperimentDate as Y, getExperimentStatusVariant as Z, useScheduleDrag as _, useReagentSeries as a, candidateMatchesSearch as at, currentExperimentFromContext as b, useBioTemplatePresetWorkspace as c, compareSortValues as ct, getBioTemplateComponentProps as d, evaluateCondition as et, toBioTemplateComponentPropsByComponent as f, useExperimentSave as g, useTemplateCollection as h, generateDilutionSeries as i, useToast as it, useAutoGroup as j, extractSamplesFromDesignData as k, useBioTemplatePackWorkspace as l, useSortedItems as lt, useBioTemplateControls as m, DEFAULT_PRESETS as n, useForm as nt, useGroupAssignment as o, normalizeSearchQuery as ot, useBioTemplateComponents as p, SORT_OPTIONS as q, DEFAULT_UNITS as r, useTheme as rt, useRackEditor as s, useTextSearch as st, useProtocolTemplates as t, useFormBuilder as tt, useBioTemplateWorkspace as u, useExperimentSamples as v, useSampleGroups as w, getInjectedPlatformContext as x, useExperimentData as y, useExperimentSelector as z };
 
-//# sourceMappingURL=useExperimentData-BbbdI5xT.js.map
+//# sourceMappingURL=useProtocolTemplates-n6AJqSqv.js.map