@morscherlab/mint-sdk 1.3.8 → 1.4.0-beta.1

package/dist/types/instrument.d.ts

@@ -6,6 +6,8 @@ export interface SampleInfo {
     sample_name?: string | null;
     vial_position?: string | null;
     injection_volume?: number | null;
+    /** Injection start time, ISO 8601 with a timezone. */
+    started_at?: string | null;
 }
 export interface SequenceProgress {
     sequence_name?: string | null;
@@ -38,10 +40,47 @@ export interface InstrumentStatus {
 }
 /** A state the platform derives for an instrument: its reported state, `never` (no report yet) or `inactive`. */
 export type InstrumentBadgeState = InstrumentState | 'never' | 'inactive';
+/** One per-injection metric over the current sequence; `values[i]` belongs to position `i + 1`, up to the last finished one (pad to `total_samples`). */
+export interface InjectionMetricSeries {
+    key: string;
+    label: string;
+    unit?: string | null;
+    values: (number | null)[];
+}
 /** Sequence progress in a live status report; `sample_durations` covers the current sequence only. */
 export type InstrumentLiveProgress = SequenceProgress & {
     elapsed_seconds: number;
     sample_durations: number[];
+    injection_metrics: InjectionMetricSeries[];
+};
+/** A typed panel a plugin reports with a live status; `kind` selects the renderer. */
+export type StatusPanel = {
+    kind: 'kv';
+    title: string;
+    items: [string, string | number | boolean | null][];
+} | {
+    kind: 'table';
+    title: string;
+    columns: string[];
+    rows: Record<string, unknown>[];
+} | {
+    kind: 'text';
+    title: string;
+    text: string;
+} | {
+    kind: 'json';
+    title: string;
+    value: unknown;
+} | {
+    kind: 'bar';
+    title: string;
+    categories: string[];
+    /** One value per category; the viewer shows one series at a time. */
+    series: {
+        name: string;
+        values: (number | null)[];
+        unit?: string | null;
+    }[];
 };
 /** The plugin that reported a live status, resolved from the plugin registry at read time. */
 export interface InstrumentStatusReporter {
@@ -67,6 +106,8 @@ export interface InstrumentLiveStatus {
     reported_by: string;
     /** Null when the reporting plugin is not loaded. */
     reporter: InstrumentStatusReporter | null;
+    /** Panels of the latest report; empty for plugins that send none. */
+    panels: StatusPanel[];
 }
 /** An alert served by the reporting plugin at `{route_prefix}/api/instruments/{id}/alerts`. */
 export interface InstrumentAlert {

package/dist/types/platform.d.ts

@@ -1,34 +1,11 @@
-import { RoleInfo } from '../permissions';
-export interface PluginInfo {
-    id: string;
-    name: string;
-    /** Name to show in the UI; the platform falls back to the plugin ID. Absent before MINT 1.3. */
-    display_name?: string;
-    version: string;
-    plugin_type?: string;
-    description?: string;
-    icon?: string;
-    color?: string;
-    route_prefix: string;
-    api_prefix: string;
-    /** Settings route selected by the platform for this plugin runtime. */
-    settings_api?: 'plugin' | 'platform';
-    /** Content identity of the HTML that booted this integrated plugin tab. */
-    frontend_revision?: string;
+import { PlatformContextNavItem, PlatformContextPlugin, PlatformFrontendContext } from './generated/platformContext';
+export type PluginInfo = Omit<PlatformContextPlugin, 'nav_items'> & {
     nav_items?: PluginNavItem[];
     settings?: PluginSettings;
-}
-export interface PluginNavItem {
-    id?: string;
-    label: string;
-    path: string;
-    icon?: string;
-    description?: string;
-    requiresAuth?: boolean;
-    requiresAdmin?: boolean;
-    requiresFeature?: string;
+};
+export type PluginNavItem = PlatformContextNavItem & {
     children?: PluginNavItem[];
-}
+};
 export interface PluginSettings {
     [key: string]: PluginSettingField;
 }
@@ -55,38 +32,23 @@ export interface UserSummary {
     first_name?: string;
     last_name?: string;
 }
-export interface PlatformContext {
+/**
+ * Platform authorization level a plugin endpoint, job, tool or page requires.
+ * `use` needs `plugins.use` and a role that can see the plugin, `configure`
+ * adds `plugins.configure`, and `admin` needs a platform administrator.
+ */
+export type Access = 'use' | 'configure' | 'admin';
+/**
+ * The platform context: the `window.__MINT_PLATFORM__` the platform injects
+ * (generated from `mint_sdk.frontend_context`), or the standalone default
+ * that holds only `isIntegrated` and `theme`.
+ */
+export type PlatformContext = Partial<Omit<PlatformFrontendContext, 'plugin'>> & {
     isIntegrated: boolean;
     plugin?: PluginInfo;
-    platformApiUrl?: string;
-    platformOrigin?: string;
-    user?: {
-        id: number;
-        username: string;
-        role: string;
-        role_obj?: RoleInfo | null;
-        roleObj?: RoleInfo | null;
-        shortname?: string;
-    };
-    theme: 'light' | 'dark' | 'system';
-    allowedExperimentTypes?: string[] | null;
-    features?: {
-        admin?: boolean;
-        experiments?: boolean;
-        samples?: boolean;
-        passkey?: boolean;
-        multiUser?: boolean;
-    };
-}
-export interface PlatformContextOptions {
-    allowedOrigins?: string[];
-    allowAnyOrigin?: boolean;
-}
-export type PlatformEventType = 'mint:theme-changed' | 'mint:user-changed' | 'mint:navigate' | 'mint:notification';
-export interface PlatformEvent<T = unknown> {
-    type: PlatformEventType;
-    payload: T;
-}
+    /** The SDK theme setting. The platform does not send it. */
+    theme: ThemeMode;
+};
 export type ThemeMode = 'light' | 'dark' | 'system';
 export type ColorPalette = 'default' | 'colorblind' | 'viridis' | 'pastel';
 export type TableDensity = 'compact' | 'normal' | 'comfortable';

package/dist/useDebouncedWatch-BPwyl6eS.js

@@ -0,0 +1,73 @@
+import { onScopeDispose, ref, watch } from "vue";
+//#region src/composables/useDebouncedWatch.ts
+/** Watch a Vue source with debounced callback execution and explicit cancel/flush controls. */
+function useDebouncedWatch(source, callback, options = {}) {
+	const { delay = 300, ...watchOptions } = options;
+	const isPending = ref(false);
+	let timer = null;
+	let hasLatestValue = false;
+	let latestValue;
+	let latestOldValue;
+	let callbackCleanup = null;
+	let stopped = false;
+	function clearTimer() {
+		if (timer) {
+			clearTimeout(timer);
+			timer = null;
+		}
+		isPending.value = false;
+	}
+	function runCallbackCleanup() {
+		if (!callbackCleanup) return;
+		callbackCleanup();
+		callbackCleanup = null;
+	}
+	function cancel() {
+		clearTimer();
+		hasLatestValue = false;
+		latestOldValue = void 0;
+	}
+	function flush() {
+		if (!hasLatestValue) return;
+		const value = latestValue;
+		const oldValue = latestOldValue;
+		cancel();
+		runCallbackCleanup();
+		callback(value, oldValue, (cleanup) => {
+			callbackCleanup = cleanup;
+		});
+	}
+	function schedule(value, oldValue) {
+		cancel();
+		hasLatestValue = true;
+		latestValue = value;
+		latestOldValue = oldValue;
+		isPending.value = true;
+		timer = setTimeout(flush, delay);
+	}
+	const stopWatch = watch(source, (value, oldValue, onCleanup) => {
+		schedule(value, oldValue);
+		onCleanup(() => {
+			cancel();
+			runCallbackCleanup();
+		});
+	}, watchOptions);
+	function stop() {
+		if (stopped) return;
+		stopped = true;
+		stopWatch();
+		cancel();
+		runCallbackCleanup();
+	}
+	onScopeDispose(stop);
+	return {
+		isPending,
+		cancel,
+		flush,
+		stop
+	};
+}
+//#endregion
+export { useDebouncedWatch as t };
+
+//# sourceMappingURL=useDebouncedWatch-BPwyl6eS.js.map

package/dist/useDebouncedWatch-BPwyl6eS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedWatch-BPwyl6eS.js","names":[],"sources":["../src/composables/useDebouncedWatch.ts"],"sourcesContent":["import {\n  onScopeDispose,\n  ref,\n  watch,\n  type Ref,\n  type WatchOptions,\n  type WatchSource,\n  type WatchStopHandle,\n} from 'vue'\n\nexport type DebouncedWatchCleanup = () => void\nexport type DebouncedWatchSource<T> = WatchSource<T> | WatchSource<unknown>[] | (() => T)\nexport type DebouncedWatchCallback<T> = (\n  value: T,\n  oldValue: T | undefined,\n  onCleanup: (cleanup: DebouncedWatchCleanup) => void,\n) => void | Promise<void>\n\nexport interface UseDebouncedWatchOptions extends WatchOptions {\n  /** Debounce interval in milliseconds. */\n  delay?: number\n}\n\nexport interface UseDebouncedWatchReturn {\n  /** Whether a callback is currently scheduled. */\n  isPending: Ref<boolean>\n  /** Cancel the pending callback without stopping the watcher. */\n  cancel: () => void\n  /** Run the pending callback immediately, if one is scheduled. */\n  flush: () => void\n  /** Stop the watcher and clear pending callbacks. */\n  stop: WatchStopHandle\n}\n\n/** Watch a Vue source with debounced callback execution and explicit cancel/flush controls. */\nexport function useDebouncedWatch<T>(\n  source: DebouncedWatchSource<T>,\n  callback: DebouncedWatchCallback<T>,\n  options: UseDebouncedWatchOptions = {},\n): UseDebouncedWatchReturn {\n  const { delay = 300, ...watchOptions } = options\n  const isPending = ref(false)\n\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let hasLatestValue = false\n  let latestValue: T\n  let latestOldValue: T | undefined\n  let callbackCleanup: DebouncedWatchCleanup | null = null\n  let stopped = false\n\n  function clearTimer(): void {\n    if (timer) {\n      clearTimeout(timer)\n      timer = null\n    }\n    isPending.value = false\n  }\n\n  function runCallbackCleanup(): void {\n    if (!callbackCleanup) return\n    callbackCleanup()\n    callbackCleanup = null\n  }\n\n  function cancel(): void {\n    clearTimer()\n    hasLatestValue = false\n    latestOldValue = undefined\n  }\n\n  function flush(): void {\n    if (!hasLatestValue) return\n    const value = latestValue\n    const oldValue = latestOldValue\n    cancel()\n    runCallbackCleanup()\n    void callback(value, oldValue, (cleanup) => {\n      callbackCleanup = cleanup\n    })\n  }\n\n  function schedule(value: T, oldValue: T | undefined): void {\n    cancel()\n    hasLatestValue = true\n    latestValue = value\n    latestOldValue = oldValue\n    isPending.value = true\n    timer = setTimeout(flush, delay)\n  }\n\n  const stopWatch = watch(\n    source as WatchSource<unknown> | WatchSource<unknown>[],\n    (value, oldValue, onCleanup) => {\n      schedule(value as T, oldValue as T | undefined)\n      onCleanup(() => {\n        cancel()\n        runCallbackCleanup()\n      })\n    },\n    watchOptions,\n  )\n\n  function stop(): void {\n    if (stopped) return\n    stopped = true\n    stopWatch()\n    cancel()\n    runCallbackCleanup()\n  }\n\n  onScopeDispose(stop)\n\n  return {\n    isPending,\n    cancel,\n    flush,\n    stop,\n  }\n}\n"],"mappings":";;;AAmCA,SAAgB,kBACd,QACA,UACA,UAAoC,CAAC,GACZ;CACzB,MAAM,EAAE,QAAQ,KAAK,GAAG,iBAAiB;CACzC,MAAM,YAAY,IAAI,KAAK;CAE3B,IAAI,QAA8C;CAClD,IAAI,iBAAiB;CACrB,IAAI;CACJ,IAAI;CACJ,IAAI,kBAAgD;CACpD,IAAI,UAAU;CAEd,SAAS,aAAmB;EAC1B,IAAI,OAAO;GACT,aAAa,KAAK;GAClB,QAAQ;EACV;EACA,UAAU,QAAQ;CACpB;CAEA,SAAS,qBAA2B;EAClC,IAAI,CAAC,iBAAiB;EACtB,gBAAgB;EAChB,kBAAkB;CACpB;CAEA,SAAS,SAAe;EACtB,WAAW;EACX,iBAAiB;EACjB,iBAAiB,KAAA;CACnB;CAEA,SAAS,QAAc;EACrB,IAAI,CAAC,gBAAgB;EACrB,MAAM,QAAQ;EACd,MAAM,WAAW;EACjB,OAAO;EACP,mBAAmB;EACnB,SAAc,OAAO,WAAW,YAAY;GAC1C,kBAAkB;EACpB,CAAC;CACH;CAEA,SAAS,SAAS,OAAU,UAA+B;EACzD,OAAO;EACP,iBAAiB;EACjB,cAAc;EACd,iBAAiB;EACjB,UAAU,QAAQ;EAClB,QAAQ,WAAW,OAAO,KAAK;CACjC;CAEA,MAAM,YAAY,MAChB,SACC,OAAO,UAAU,cAAc;EAC9B,SAAS,OAAY,QAAyB;EAC9C,gBAAgB;GACd,OAAO;GACP,mBAAmB;EACrB,CAAC;CACH,GACA,YACF;CAEA,SAAS,OAAa;EACpB,IAAI,SAAS;EACb,UAAU;EACV,UAAU;EACV,OAAO;EACP,mBAAmB;CACrB;CAEA,eAAe,IAAI;CAEnB,OAAO;EACL;EACA;EACA;EACA;CACF;AACF"}

package/dist/useExpansionSet-CvoNMZJi.js

@@ -0,0 +1,68 @@
+import { computed, ref, toValue, watch } from "vue";
+//#region src/composables/useExpansionSet.ts
+/** Shared expansion state for trees, grouped selectors, and disclosure lists. */
+function useExpansionSet(options = {}) {
+	const expandedIds = ref(new Set(normalizeIds(toValue(options.defaultIds))));
+	const expandedList = computed(() => [...expandedIds.value]);
+	if (options.expandAll !== void 0) watch(() => toValue(options.expandAll), (shouldExpandAll) => {
+		if (shouldExpandAll === void 0 || shouldExpandAll === null) return;
+		if (shouldExpandAll) setExpanded(normalizeIds(toValue(options.allIds)));
+		else reset();
+	}, { immediate: true });
+	if (options.allIds !== void 0) watch(() => normalizeIds(toValue(options.allIds)), (ids) => {
+		if (toValue(options.expandAll)) setExpanded(ids);
+	});
+	function isExpanded(id) {
+		return expandedIds.value.has(id);
+	}
+	function expand(id) {
+		if (expandedIds.value.has(id)) return;
+		expandedIds.value = /* @__PURE__ */ new Set([...expandedIds.value, id]);
+	}
+	function collapse(id) {
+		if (!expandedIds.value.has(id)) return;
+		const next = new Set(expandedIds.value);
+		next.delete(id);
+		expandedIds.value = next;
+	}
+	function toggle(id) {
+		if (expandedIds.value.has(id)) {
+			collapse(id);
+			return false;
+		}
+		expand(id);
+		return true;
+	}
+	function expandMany(ids) {
+		expandedIds.value = /* @__PURE__ */ new Set([...expandedIds.value, ...normalizeIds(ids)]);
+	}
+	function setExpanded(ids) {
+		expandedIds.value = new Set(normalizeIds(ids));
+	}
+	function collapseAll() {
+		expandedIds.value = /* @__PURE__ */ new Set();
+	}
+	function reset() {
+		setExpanded(normalizeIds(toValue(options.defaultIds)));
+	}
+	return {
+		expandedIds,
+		expandedList,
+		isExpanded,
+		expand,
+		collapse,
+		toggle,
+		expandMany,
+		setExpanded,
+		collapseAll,
+		reset
+	};
+}
+function normalizeIds(ids) {
+	if (!ids) return [];
+	return [...new Set(ids.filter(Boolean))];
+}
+//#endregion
+export { useExpansionSet as t };
+
+//# sourceMappingURL=useExpansionSet-CvoNMZJi.js.map

package/dist/useExpansionSet-CvoNMZJi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExpansionSet-CvoNMZJi.js","names":[],"sources":["../src/composables/useExpansionSet.ts"],"sourcesContent":["import { computed, ref, toValue, watch, type ComputedRef, type Ref } from 'vue'\n\nexport type ExpansionSetSource<T> =\n  | T\n  | Ref<T>\n  | ComputedRef<T>\n  | (() => T)\n\nexport interface UseExpansionSetOptions {\n  defaultIds?: ExpansionSetSource<readonly string[] | null | undefined>\n  allIds?: ExpansionSetSource<readonly string[] | null | undefined>\n  expandAll?: ExpansionSetSource<boolean | null | undefined>\n}\n\nexport interface UseExpansionSetReturn {\n  expandedIds: Ref<Set<string>>\n  expandedList: ComputedRef<string[]>\n  isExpanded: (id: string) => boolean\n  expand: (id: string) => void\n  collapse: (id: string) => void\n  toggle: (id: string) => boolean\n  expandMany: (ids: readonly string[]) => void\n  setExpanded: (ids: readonly string[]) => void\n  collapseAll: () => void\n  reset: () => void\n}\n\n/** Shared expansion state for trees, grouped selectors, and disclosure lists. */\nexport function useExpansionSet(options: UseExpansionSetOptions = {}): UseExpansionSetReturn {\n  const expandedIds = ref(new Set(normalizeIds(toValue(options.defaultIds))))\n  const expandedList = computed(() => [...expandedIds.value])\n\n  if (options.expandAll !== undefined) {\n    watch(\n      () => toValue(options.expandAll),\n      (shouldExpandAll) => {\n        if (shouldExpandAll === undefined || shouldExpandAll === null) return\n        if (shouldExpandAll) {\n          setExpanded(normalizeIds(toValue(options.allIds)))\n        } else {\n          reset()\n        }\n      },\n      { immediate: true },\n    )\n  }\n\n  if (options.allIds !== undefined) {\n    watch(\n      () => normalizeIds(toValue(options.allIds)),\n      (ids) => {\n        if (toValue(options.expandAll)) {\n          setExpanded(ids)\n        }\n      },\n    )\n  }\n\n  function isExpanded(id: string): boolean {\n    return expandedIds.value.has(id)\n  }\n\n  function expand(id: string) {\n    if (expandedIds.value.has(id)) return\n    expandedIds.value = new Set([...expandedIds.value, id])\n  }\n\n  function collapse(id: string) {\n    if (!expandedIds.value.has(id)) return\n    const next = new Set(expandedIds.value)\n    next.delete(id)\n    expandedIds.value = next\n  }\n\n  function toggle(id: string): boolean {\n    if (expandedIds.value.has(id)) {\n      collapse(id)\n      return false\n    }\n    expand(id)\n    return true\n  }\n\n  function expandMany(ids: readonly string[]) {\n    expandedIds.value = new Set([...expandedIds.value, ...normalizeIds(ids)])\n  }\n\n  function setExpanded(ids: readonly string[]) {\n    expandedIds.value = new Set(normalizeIds(ids))\n  }\n\n  function collapseAll() {\n    expandedIds.value = new Set()\n  }\n\n  function reset() {\n    setExpanded(normalizeIds(toValue(options.defaultIds)))\n  }\n\n  return {\n    expandedIds,\n    expandedList,\n    isExpanded,\n    expand,\n    collapse,\n    toggle,\n    expandMany,\n    setExpanded,\n    collapseAll,\n    reset,\n  }\n}\n\nfunction normalizeIds(ids: readonly string[] | null | undefined): string[] {\n  if (!ids) return []\n  return [...new Set(ids.filter(Boolean))]\n}\n"],"mappings":";;;AA4BA,SAAgB,gBAAgB,UAAkC,CAAC,GAA0B;CAC3F,MAAM,cAAc,IAAI,IAAI,IAAI,aAAa,QAAQ,QAAQ,UAAU,CAAC,CAAC,CAAC;CAC1E,MAAM,eAAe,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC;CAE1D,IAAI,QAAQ,cAAc,KAAA,GACxB,YACQ,QAAQ,QAAQ,SAAS,IAC9B,oBAAoB;EACnB,IAAI,oBAAoB,KAAA,KAAa,oBAAoB,MAAM;EAC/D,IAAI,iBACF,YAAY,aAAa,QAAQ,QAAQ,MAAM,CAAC,CAAC;OAEjD,MAAM;CAEV,GACA,EAAE,WAAW,KAAK,CACpB;CAGF,IAAI,QAAQ,WAAW,KAAA,GACrB,YACQ,aAAa,QAAQ,QAAQ,MAAM,CAAC,IACzC,QAAQ;EACP,IAAI,QAAQ,QAAQ,SAAS,GAC3B,YAAY,GAAG;CAEnB,CACF;CAGF,SAAS,WAAW,IAAqB;EACvC,OAAO,YAAY,MAAM,IAAI,EAAE;CACjC;CAEA,SAAS,OAAO,IAAY;EAC1B,IAAI,YAAY,MAAM,IAAI,EAAE,GAAG;EAC/B,YAAY,wBAAQ,IAAI,IAAI,CAAC,GAAG,YAAY,OAAO,EAAE,CAAC;CACxD;CAEA,SAAS,SAAS,IAAY;EAC5B,IAAI,CAAC,YAAY,MAAM,IAAI,EAAE,GAAG;EAChC,MAAM,OAAO,IAAI,IAAI,YAAY,KAAK;EACtC,KAAK,OAAO,EAAE;EACd,YAAY,QAAQ;CACtB;CAEA,SAAS,OAAO,IAAqB;EACnC,IAAI,YAAY,MAAM,IAAI,EAAE,GAAG;GAC7B,SAAS,EAAE;GACX,OAAO;EACT;EACA,OAAO,EAAE;EACT,OAAO;CACT;CAEA,SAAS,WAAW,KAAwB;EAC1C,YAAY,wBAAQ,IAAI,IAAI,CAAC,GAAG,YAAY,OAAO,GAAG,aAAa,GAAG,CAAC,CAAC;CAC1E;CAEA,SAAS,YAAY,KAAwB;EAC3C,YAAY,QAAQ,IAAI,IAAI,aAAa,GAAG,CAAC;CAC/C;CAEA,SAAS,cAAc;EACrB,YAAY,wBAAQ,IAAI,IAAI;CAC9B;CAEA,SAAS,QAAQ;EACf,YAAY,aAAa,QAAQ,QAAQ,UAAU,CAAC,CAAC;CACvD;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;AAEA,SAAS,aAAa,KAAqD;CACzE,IAAI,CAAC,KAAK,OAAO,CAAC;CAClB,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,OAAO,OAAO,CAAC,CAAC;AACzC"}

package/dist/useExperimentSamples-CxcnxZ8h.js

@@ -0,0 +1,366 @@
+import { o as useApi, r as readErrorMessage } from "./experiment-43OJtH7R.js";
+import { _ as APP_EXPERIMENT_KEY, a as parseExperimentId, t as isRecord } from "./records-BzTcxekG.js";
+import { t as useRequest } from "./useRequest-D5JDfsgZ.js";
+import { computed, inject, ref, shallowRef, toValue, watch } from "vue";
+//#region src/composables/experimentDesignData.ts
+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/useExperimentData.ts
+/** Fetches and normalises experiment output data (tree, table, summary) from the platform API. */
+function useExperimentData(options = {}) {
+	const data = shallowRef(null);
+	const request = useRequest("Failed to fetch experiment data");
+	const isLoading = request.isLoading;
+	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`), {
+				kind: "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/useFileImport.ts
+/** Stateful file reader for plugin import flows with shared validation and error handling. */
+function useFileImport(options = {}) {
+	const loading = shallowRef(false);
+	const error = ref(null);
+	const fileName = ref("");
+	const result = ref(null);
+	function clear() {
+		loading.value = false;
+		error.value = null;
+		fileName.value = "";
+		result.value = null;
+	}
+	async function importFile(file) {
+		loading.value = true;
+		error.value = null;
+		fileName.value = file.name;
+		try {
+			validateImportFile(file, options);
+			const text = await readFileAsText(file, options.encoding);
+			const parsed = options.parse ? await options.parse(text, file) : text;
+			result.value = parsed;
+			return parsed;
+		} catch (err) {
+			const message = readErrorMessage(err, "Failed to import file.");
+			error.value = message;
+			throw err;
+		} finally {
+			loading.value = false;
+		}
+	}
+	return {
+		loading,
+		error,
+		fileName,
+		result,
+		importFile,
+		clear
+	};
+}
+function validateImportFile(file, options = {}) {
+	if (options.maxSizeBytes !== void 0 && file.size > options.maxSizeBytes) throw new Error(`File is too large. Maximum size is ${formatBytes(options.maxSizeBytes)}.`);
+	const accept = normalizeAccept(options.accept);
+	if (accept.length === 0) return;
+	const name = file.name.toLowerCase();
+	const type = file.type.toLowerCase();
+	if (!accept.some((entry) => {
+		if (entry.startsWith(".")) return name.endsWith(entry);
+		if (entry.endsWith("/*")) return type.startsWith(entry.slice(0, -1));
+		return type === entry;
+	})) throw new Error(`Unsupported file type. Expected ${accept.join(", ")}.`);
+}
+function readFileAsText(file, encoding) {
+	if (typeof FileReader === "undefined" && typeof file.text === "function") return file.text();
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onload = () => resolve(String(reader.result ?? ""));
+		reader.onerror = () => reject(reader.error ?? /* @__PURE__ */ new Error("Failed to read file."));
+		reader.readAsText(file, encoding);
+	});
+}
+function parseDelimitedText(text, options = {}) {
+	const trim = options.trim ?? true;
+	const delimiter = options.delimiter ?? detectDelimiter(text);
+	const rawRows = parseDelimitedRows(text, delimiter).filter((row) => row.some((cell) => cell.trim().length > 0)).map((row) => trim ? row.map((cell) => cell.trim()) : row);
+	const hasHeaderRow = options.hasHeaderRow ?? !options.headers;
+	const columns = options.headers ? [...options.headers] : hasHeaderRow ? rawRows[0] ?? [] : createColumnNames(maxRowLength(rawRows));
+	return {
+		columns,
+		rows: (hasHeaderRow && !options.headers ? rawRows.slice(1) : rawRows).map((row) => Object.fromEntries(columns.map((column, index) => [column, row[index] ?? ""]))),
+		rawRows,
+		delimiter
+	};
+}
+function detectDelimiter(text) {
+	const firstLine = text.split(/\r?\n/, 1)[0] ?? "";
+	const commaCount = countChar(firstLine, ",");
+	const tabCount = countChar(firstLine, "	");
+	const semicolonCount = countChar(firstLine, ";");
+	if (tabCount > commaCount && tabCount >= semicolonCount) return "	";
+	if (semicolonCount > commaCount) return ";";
+	return ",";
+}
+function parseDelimitedRows(text, delimiter) {
+	const rows = [];
+	let row = [];
+	let field = "";
+	let quoted = false;
+	for (let index = 0; index < text.length; index++) {
+		const char = text[index];
+		const next = text[index + 1];
+		if (char === "\"") {
+			if (quoted && next === "\"") {
+				field += "\"";
+				index++;
+			} else quoted = !quoted;
+			continue;
+		}
+		if (!quoted && char === delimiter) {
+			row.push(field);
+			field = "";
+			continue;
+		}
+		if (!quoted && (char === "\n" || char === "\r")) {
+			if (char === "\r" && next === "\n") index++;
+			row.push(field);
+			rows.push(row);
+			row = [];
+			field = "";
+			continue;
+		}
+		field += char;
+	}
+	row.push(field);
+	rows.push(row);
+	return rows;
+}
+function normalizeAccept(accept) {
+	if (!accept) return [];
+	return (typeof accept === "string" ? accept.split(",") : [...accept]).map((entry) => entry.trim().toLowerCase()).filter(Boolean);
+}
+function createColumnNames(count) {
+	return Array.from({ length: count }, (_, index) => `column_${index + 1}`);
+}
+function maxRowLength(rows) {
+	return rows.reduce((max, row) => Math.max(max, row.length), 0);
+}
+function countChar(value, char) {
+	return [...value].filter((candidate) => candidate === char).length;
+}
+function formatBytes(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1048576) return `${Math.round(bytes / 1024)} KB`;
+	return `${Math.round(bytes / 1048576)} MB`;
+}
+//#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
+export { useFileImport as a, extractSampleNamesFromDesignData as c, readFileAsText as i, extractSampleOptionsFromDesignData as l, detectDelimiter as n, validateImportFile as o, parseDelimitedText as r, useExperimentData as s, useExperimentSamples as t, unwrapExperimentDesignData as u };
+
+//# sourceMappingURL=useExperimentSamples-CxcnxZ8h.js.map