@morscherlab/mint-sdk 1.1.25 → 1.2.0-beta.10

package/dist/{useProtocolTemplates-DHwSveE6.js → useProtocolTemplates-BmX_iVBR.js}

@@ -1,10 +1,114 @@
-import { d as resolveExperimentCode } from "./experiment-utils-CLnzPPq5.js";
-import { r as useRequestSyncState } from "./EmptyState-p90quq8Z.js";
-import { A as useConcentrationUnits, H as parseExperimentId, J as isActiveJobStatus, Q as normalizeJobState, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, u as useControlWorkspace } from "./useControlSchema-BhoJzWzx.js";
-import { o as useSettingsStore, r as useApi } from "./useApi-CDBq6z23.js";
-import { t as useExperimentStore } from "./experiment-Y9Iz7KYi.js";
-import { B as toBioTemplateComponentProps, F as getBioTemplateComponentProps$1, H as toBioTemplateComponentPropsById, Jt as getBioTemplatePresetInfo, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, Qt as getBioTemplatePackInfo, R as toBioTemplateComponentBindingsById, U as toBioTemplateComponentSnippets, V as toBioTemplateComponentPropsByComponent$1, W as toBioTemplateComponentUsage, d as createBioTemplatePresetCollectionFromControls, dn as extractTemplateCollection, i as createBioTemplateControlToolkit, p as createBioTemplatePackCollection, sn as createTemplateCollection, u as createBioTemplatePresetCollection, un as ensureTemplateFromCollection, z as toBioTemplateComponentImports } from "./templates-CovvRZ-9.js";
-import { computed, effectScope, getCurrentScope, inject, onMounted, onScopeDispose, onUnmounted, provide, reactive, readonly, ref, shallowRef, toRaw, toValue, unref, watch } from "vue";
+import { d as resolveExperimentCode } from "./experiment-utils-DV3DrvE_.js";
+import { n as useRequestSyncState } from "./Skeleton-DxtwJ5gt.js";
+import { A as useConcentrationUnits, H as parseExperimentId, J as isActiveJobStatus, Q as normalizeJobState, T as getDefaultControlView, U as resolveCurrentExperimentId, V as getInjectedPlatformContext, f as resolveControlModel, g as mergeControlWorkspaceOptions, h as controlValuesToComponentProps, m as controlValuesToComponentBindingsById, p as controlValuesToComponentBindings, r as getControlDefaults, rt as isRecord, u as useControlWorkspace, w as controlsToViewItems } from "./useControlSchema-aMZlb4Sc.js";
+import { d as useSettingsStore, i as useApi, t as readErrorMessage } from "./errors-_W0-LbA6.js";
+import { t as useExperimentStore } from "./experiment-Cwl9AYxw.js";
+import { B as toBioTemplateComponentProps, F as getBioTemplateComponentProps$1, H as toBioTemplateComponentPropsById, Jt as getBioTemplatePresetInfo, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, Qt as getBioTemplatePackInfo, R as toBioTemplateComponentBindingsById, U as toBioTemplateComponentSnippets, V as toBioTemplateComponentPropsByComponent$1, W as toBioTemplateComponentUsage, bn as rowLabel, d as createBioTemplatePresetCollectionFromControls, dn as extractTemplateCollection, i as createBioTemplateControlToolkit, p as createBioTemplatePackCollection, pn as PLATE_CONFIGS, sn as createTemplateCollection, u as createBioTemplatePresetCollection, un as ensureTemplateFromCollection, wn as deriveShade, xn as SAMPLE_COLOR_SCALE, z as toBioTemplateComponentImports } from "./templates-Qq113pyZ.js";
+import { computed, effectScope, getCurrentScope, inject, nextTick, onMounted, onScopeDispose, onUnmounted, provide, reactive, readonly, ref, shallowRef, toRaw, toValue, unref, watch } from "vue";
+//#region src/composables/useRovingFocus.ts
+/**
+* WAI-ARIA roving-tabindex navigation with automatic activation (the tabs pattern):
+* Left/Right (or Up/Down when `orientation` is `'vertical'`) move to the adjacent item
+* and activate it immediately, wrapping past the ends; Home/End jump to the first/last
+* item. Only the active item should carry `tabindex="0"`; give every other item
+* `tabindex="-1"`. Used by BaseTabs.
+*/
+function useRovingFocus(options) {
+	const orientation = options.orientation ?? "horizontal";
+	const prevKey = orientation === "vertical" ? "ArrowUp" : "ArrowLeft";
+	const nextKey = orientation === "vertical" ? "ArrowDown" : "ArrowRight";
+	function moveTo(id) {
+		if (id === void 0) return;
+		options.activate(id);
+		nextTick(() => options.getElement(id)?.focus());
+	}
+	function handleKeydown(event) {
+		const ids = options.ids();
+		if (ids.length === 0) return;
+		const currentIndex = ids.indexOf(options.activeId() ?? "");
+		if (event.key === "Home") {
+			event.preventDefault();
+			moveTo(ids[0]);
+			return;
+		}
+		if (event.key === "End") {
+			event.preventDefault();
+			moveTo(ids[ids.length - 1]);
+			return;
+		}
+		if (event.key === prevKey) {
+			event.preventDefault();
+			moveTo(ids[currentIndex <= 0 ? ids.length - 1 : currentIndex - 1]);
+			return;
+		}
+		if (event.key === nextKey) {
+			event.preventDefault();
+			moveTo(ids[currentIndex === -1 || currentIndex >= ids.length - 1 ? 0 : currentIndex + 1]);
+		}
+	}
+	return { handleKeydown };
+}
+//#endregion
+//#region src/composables/useMenuKeyboard.ts
+/**
+* Shared keyboard contract for menu- and listbox-style disclosure panels (the
+* WAI-ARIA menu button pattern). Used by ActionMenu, AppAvatarMenu and DropdownButton,
+* each pairing it with `useDropdownState` for the disclosure state itself.
+*/
+function useMenuKeyboard(options) {
+	function focusItem(position) {
+		nextTick(() => {
+			const items = options.items();
+			(position === "first" ? items[0] : items[items.length - 1])?.focus();
+		});
+	}
+	function handleTriggerKeydown(event) {
+		if (options.isOpen()) return;
+		if (event.key === "ArrowDown" || event.key === "Enter" || event.key === " ") {
+			event.preventDefault();
+			options.open();
+			focusItem("first");
+			return;
+		}
+		if (event.key === "ArrowUp") {
+			event.preventDefault();
+			options.open();
+			focusItem("last");
+		}
+	}
+	function handlePanelKeydown(event) {
+		const items = options.items();
+		const currentIndex = items.indexOf(document.activeElement);
+		if (event.key === "Escape") {
+			event.preventDefault();
+			options.close(true);
+			return;
+		}
+		if (event.key === "Tab") {
+			options.close();
+			return;
+		}
+		if (event.key === "Home") {
+			event.preventDefault();
+			items[0]?.focus();
+			return;
+		}
+		if (event.key === "End") {
+			event.preventDefault();
+			items[items.length - 1]?.focus();
+			return;
+		}
+		if (event.key !== "ArrowDown" && event.key !== "ArrowUp") return;
+		event.preventDefault();
+		const direction = event.key === "ArrowDown" ? 1 : -1;
+		items[(Math.max(currentIndex, 0) + direction + items.length) % items.length]?.focus();
+	}
+	return {
+		handleTriggerKeydown,
+		handlePanelKeydown
+	};
+}
+//#endregion
 //#region src/composables/useSortedItems.ts
 /** Shared sorting for SDK tables and lists with stable empty-value handling. */
 function useSortedItems(options) {
@@ -528,6 +632,310 @@ function useMobileSupportGate(options = {}) {
 	};
 }
 //#endregion
+//#region src/components/PluginWorkspaceView.controls.ts
+function usePluginWorkspaceControls(options) {
+	const resolvedModel = computed(() => resolveControlModel(options.model()));
+	const resolvedControls = computed(() => options.controls() ?? resolvedModel.value?.controls);
+	const resolvedControlOptions = computed(() => mergeControlWorkspaceOptions(resolvedModel.value?.controlOptions ?? {}, options.controlOptions()));
+	const externalControlValues = computed(() => options.modelValue() ?? options.values());
+	const internalControlValues = reactive({});
+	let syncingControlValues = false;
+	const generatedControlDefaults = computed(() => {
+		if (!resolvedControls.value) return {};
+		return {
+			...getControlDefaults(resolvedControls.value),
+			...resolvedControlOptions.value.initialValues ?? {}
+		};
+	});
+	function replaceControlValues(values) {
+		for (const key of Object.keys(internalControlValues)) if (!(key in values)) delete internalControlValues[key];
+		Object.assign(internalControlValues, values);
+	}
+	function emitControlValues() {
+		options.emitValues({ ...internalControlValues });
+	}
+	function syncResolvedControlValues() {
+		syncingControlValues = true;
+		replaceControlValues({
+			...generatedControlDefaults.value,
+			...externalControlValues.value === void 0 ? internalControlValues : externalControlValues.value
+		});
+		syncingControlValues = false;
+	}
+	function handleControlValuesUpdate(values) {
+		syncingControlValues = true;
+		replaceControlValues({
+			...generatedControlDefaults.value,
+			...values
+		});
+		syncingControlValues = false;
+		emitControlValues();
+	}
+	const resolvedComponentBindings = computed(() => controlValuesToComponentBindings(internalControlValues, options.componentBindings() ?? resolvedModel.value?.componentBindings));
+	const resolvedComponentBindingsById = computed(() => controlValuesToComponentBindingsById(internalControlValues, options.componentBindings() ?? resolvedModel.value?.componentBindings));
+	const resolvedComponentProps = computed(() => {
+		const mapping = options.componentProps() ?? resolvedModel.value?.componentProps;
+		return mapping === void 0 ? {} : controlValuesToComponentProps(internalControlValues, mapping);
+	});
+	const resolvedComponentPropsById = computed(() => {
+		const mappings = options.componentPropsById() ?? resolvedModel.value?.componentPropsById;
+		if (mappings === void 0) return {};
+		return Object.fromEntries(Object.entries(mappings).map(([id, mapping]) => [id, controlValuesToComponentProps(internalControlValues, mapping)]));
+	});
+	const generatedPillNav = computed(() => {
+		if (!resolvedControls.value) return [];
+		return controlsToViewItems(resolvedControls.value, resolvedControlOptions.value);
+	});
+	const generatedDefaultView = computed(() => {
+		if (!resolvedControls.value) return "";
+		return getDefaultControlView(resolvedControls.value, resolvedControlOptions.value);
+	});
+	syncResolvedControlValues();
+	watch([generatedControlDefaults, externalControlValues], syncResolvedControlValues, { deep: true });
+	watch(internalControlValues, () => {
+		if (syncingControlValues) return;
+		emitControlValues();
+	}, {
+		deep: true,
+		flush: "sync"
+	});
+	return {
+		resolvedModel,
+		resolvedControls,
+		resolvedControlOptions,
+		generatedPillNav,
+		generatedDefaultView,
+		internalControlValues,
+		resolvedComponentBindings,
+		resolvedComponentBindingsById,
+		resolvedComponentProps,
+		resolvedComponentPropsById,
+		handleControlValuesUpdate
+	};
+}
+//#endregion
+//#region src/components/PluginWorkspaceView.navigation.ts
+function usePluginWorkspaceNavigation(options) {
+	const internalActiveView = ref(options.defaultActiveView());
+	const resolvedPillNav = computed(() => {
+		if (options.pillNav() !== void 0) return options.pillNav();
+		return options.generatedPillNav.value.length > 0 ? [...options.generatedPillNav.value] : void 0;
+	});
+	const firstConfiguredViewId = computed(() => options.defaultActiveView() ?? firstItemId(options.pillNav()) ?? options.generatedDefaultView.value ?? firstItemId(options.pageSelector()) ?? options.panelIds()[0] ?? "");
+	const resolvedActiveView = computed({
+		get: () => options.activeView() ?? options.currentPillId() ?? options.currentPageSelectorId() ?? internalActiveView.value ?? firstConfiguredViewId.value,
+		set: (value) => {
+			internalActiveView.value = value;
+			options.emitActiveView(value);
+		}
+	});
+	const resolvedCurrentPillId = computed(() => options.currentPillId() ?? resolvedActiveView.value);
+	const resolvedCurrentPageSelectorId = computed(() => options.currentPageSelectorId() ?? resolvedActiveView.value);
+	function setActiveView(viewId) {
+		resolvedActiveView.value = viewId;
+	}
+	function handlePageSelectorSelect(page) {
+		setActiveView(page.id);
+		options.emitPageSelectorSelect(page);
+	}
+	function handlePillSelect(item) {
+		setActiveView(item.id);
+		options.emitPillSelect(item);
+	}
+	return {
+		resolvedPillNav,
+		firstConfiguredViewId,
+		resolvedActiveView,
+		resolvedCurrentPillId,
+		resolvedCurrentPageSelectorId,
+		setActiveView,
+		handlePageSelectorSelect,
+		handlePillSelect
+	};
+}
+function firstItemId(items) {
+	const item = items?.[0];
+	if (item === void 0) return void 0;
+	return typeof item === "string" ? item : item.id;
+}
+//#endregion
+//#region src/components/PluginWorkspaceView.shell.ts
+var topBarForwardedSlots = new Set([
+	"icon",
+	"logo",
+	"page-selector-icon",
+	"page-selector-item-icon",
+	"nav",
+	"center",
+	"actions",
+	"account-menu-items",
+	"account-menu-item-icon",
+	"settings-appearance"
+]);
+var sidebarForwardedSlots = new Set([
+	"header",
+	"collapsed",
+	"collapsed-footer",
+	"footer"
+]);
+function getPluginWorkspaceTopBarSlotNames(slots) {
+	return Object.keys(slots).filter((name) => topBarForwardedSlots.has(name) || name.startsWith("settings-tab-"));
+}
+function getPluginWorkspaceSidebarSlotNames(slots) {
+	return Object.keys(slots).filter((name) => sidebarForwardedSlots.has(name) || name.startsWith("section-"));
+}
+function hasPluginWorkspaceSidebarSurface(options) {
+	if (!options.showSidebar) return false;
+	return Object.keys(options.panels).length > 0 || Object.keys(options.forms).length > 0 || options.model !== void 0 || options.controls !== void 0 || options.showSidebarWhenEmpty || options.sidebarContentId !== void 0 || options.sidebarTitle !== void 0 || options.sidebarSubtitle !== void 0 || options.sidebarBadge !== void 0 || options.hasSidebarSlot || options.sidebarSlotCount > 0;
+}
+//#endregion
+//#region src/composables/usePluginWorkspace.ts
+/**
+* Maps PluginWorkspaceView's flat 72-prop surface into the three typed model objects
+* (`shell`, `sidebar`, `controls`) rendered by its internal pieces
+* (WorkspaceShellInternal, WorkspaceSidebarInternal, WorkspaceControlsInternal). Reuses the
+* existing `usePluginWorkspaceControls` / `usePluginWorkspaceNavigation` composables and the
+* PluginWorkspaceView.shell slot-detection helpers, so it changes only how that state is
+* assembled and exposed, not the underlying behavior.
+*
+* @example Recommended
+* ```ts
+* const props = withDefaults(defineProps<PluginWorkspaceViewProps>(), { ... })
+* const emit = defineEmits<PluginWorkspaceViewEmits>()
+* const slots = useSlots()
+* const { shell, sidebar, controls } = usePluginWorkspace({ props, slots, emit })
+* ```
+*/
+function usePluginWorkspace(options) {
+	const { props, slots, emit } = options;
+	const controlsState = usePluginWorkspaceControls({
+		model: () => props.model,
+		controls: () => props.controls,
+		controlOptions: () => props.controlOptions ?? {},
+		modelValue: () => props.modelValue,
+		values: () => props.values,
+		componentBindings: () => props.componentBindings,
+		componentProps: () => props.componentProps,
+		componentPropsById: () => props.componentPropsById,
+		emitValues: (values) => {
+			emit("update:modelValue", values);
+			emit("update:values", values);
+		}
+	});
+	const navigationState = usePluginWorkspaceNavigation({
+		activeView: () => props.activeView,
+		defaultActiveView: () => props.defaultActiveView,
+		currentPillId: () => props.currentPillId,
+		currentPageSelectorId: () => props.currentPageSelectorId,
+		pillNav: () => props.pillNav,
+		pageSelector: () => props.pageSelector,
+		panelIds: () => Object.keys(props.panels ?? {}),
+		generatedPillNav: controlsState.generatedPillNav,
+		generatedDefaultView: controlsState.generatedDefaultView,
+		emitActiveView: (viewId) => emit("update:activeView", viewId),
+		emitPageSelectorSelect: (page) => emit("page-selector-select", page),
+		emitPillSelect: (item) => emit("pill-select", item)
+	});
+	const topBarSlotNames = computed(() => getPluginWorkspaceTopBarSlotNames(slots));
+	const sidebarSlotNames = computed(() => getPluginWorkspaceSidebarSlotNames(slots));
+	const hasSidebarSurface = computed(() => hasPluginWorkspaceSidebarSurface({
+		showSidebar: props.showSidebar ?? true,
+		panels: props.panels ?? {},
+		forms: props.forms ?? {},
+		model: props.model,
+		controls: props.controls,
+		showSidebarWhenEmpty: props.showSidebarWhenEmpty ?? false,
+		sidebarContentId: props.sidebarContentId,
+		sidebarTitle: props.sidebarTitle,
+		sidebarSubtitle: props.sidebarSubtitle,
+		sidebarBadge: props.sidebarBadge,
+		hasSidebarSlot: Boolean(slots.sidebar),
+		sidebarSlotCount: sidebarSlotNames.value.length
+	}));
+	const controls = computed(() => ({
+		activeView: navigationState.resolvedActiveView.value,
+		setActiveView: navigationState.setActiveView,
+		values: controlsState.internalControlValues,
+		componentBindings: controlsState.resolvedComponentBindings.value,
+		componentBindingsById: controlsState.resolvedComponentBindingsById.value,
+		componentProps: controlsState.resolvedComponentProps.value,
+		componentPropsById: controlsState.resolvedComponentPropsById.value
+	}));
+	return {
+		shell: computed(() => ({
+			sidebarPosition: props.sidebarPosition ?? "left",
+			sidebarWidth: props.sidebarWidth,
+			floating: props.floating ?? true,
+			responsiveSidebar: props.responsiveSidebar ?? true,
+			sidebarToggleLabel: props.sidebarToggleLabel ?? "Open workspace sidebar",
+			sidebarCloseLabel: props.sidebarCloseLabel ?? "Close workspace sidebar",
+			hasSidebarSurface: hasSidebarSurface.value,
+			title: props.title ?? "Workspace",
+			subtitle: props.subtitle,
+			topBarVariant: props.topBarVariant ?? "card",
+			homePath: props.homePath ?? "/",
+			showLogo: props.showLogo ?? true,
+			pageSelector: props.pageSelector,
+			currentPageSelectorId: navigationState.resolvedCurrentPageSelectorId.value,
+			pluginSwitcher: props.pluginSwitcher,
+			pillNav: navigationState.resolvedPillNav.value,
+			currentPillId: navigationState.resolvedCurrentPillId.value,
+			showThemeToggle: props.showThemeToggle ?? true,
+			showSettings: props.showSettings ?? true,
+			settingsConfig: props.settingsConfig,
+			showStandaloneLabel: props.showStandaloneLabel ?? false,
+			standaloneLabel: props.standaloneLabel ?? "Standalone",
+			accountMenu: props.accountMenu,
+			showNotifications: props.showNotifications ?? false,
+			hasNotificationDot: props.hasNotificationDot ?? false,
+			showAdmin: props.showAdmin ?? false,
+			adminPath: props.adminPath ?? "/admin",
+			userName: props.userName,
+			userInitial: props.userInitial,
+			userEmail: props.userEmail,
+			topBarSlotNames: topBarSlotNames.value,
+			controls: controls.value
+		})),
+		sidebar: computed(() => ({
+			title: props.sidebarTitle,
+			subtitle: props.sidebarSubtitle,
+			badge: props.sidebarBadge,
+			variant: props.sidebarVariant ?? "analysis",
+			panels: props.panels ?? {},
+			activeView: navigationState.resolvedActiveView.value,
+			floating: false,
+			dense: props.dense ?? true,
+			width: props.sidebarWidth,
+			side: props.sidebarPosition ?? "left",
+			forms: props.forms ?? {},
+			contentId: props.sidebarContentId,
+			showWhenEmpty: (props.showSidebarWhenEmpty ?? false) || props.sidebarContentId !== void 0,
+			model: props.model,
+			controlSchema: props.controls,
+			controlOptions: props.controlOptions ?? {},
+			values: controlsState.internalControlValues,
+			formEnhancements: props.formEnhancements,
+			showFormActions: props.showFormActions ?? false,
+			formLoading: props.formLoading ?? false,
+			formDisabled: props.formDisabled ?? false,
+			formReadonly: props.formReadonly ?? false,
+			formSize: props.formSize ?? "sm",
+			collapsible: props.sidebarCollapsible,
+			collapsed: props.sidebarCollapsed,
+			defaultCollapsed: props.defaultSidebarCollapsed ?? false,
+			collapsedWidth: props.sidebarCollapsedWidth ?? "3rem",
+			collapseButtonLabel: props.sidebarCollapseButtonLabel ?? "Collapse sidebar",
+			expandButtonLabel: props.sidebarExpandButtonLabel ?? "Expand sidebar",
+			slotNames: sidebarSlotNames.value
+		})),
+		controls,
+		hasSidebarSurface,
+		handleControlValuesUpdate: controlsState.handleControlValuesUpdate,
+		handlePageSelectorSelect: navigationState.handlePageSelectorSelect,
+		handlePillSelect: navigationState.handlePillSelect
+	};
+}
+//#endregion
 //#region src/composables/useJobsStatusTray.ts
 /**
 * Combines independent job runtimes without copying their reactive state.
@@ -823,7 +1231,7 @@ function usePluginJobCenter(options = {}) {
 		isPending: (job) => pendingJobIds.value.has(job.job_id)
 	};
 }
-/** Backward-compatible name for the plugin job-center controller. */
+/** @deprecated Use `usePluginJobCenter()` for the plugin job-center controller. */
 function useJobsStatusTray(options = {}) {
 	return usePluginJobCenter(options);
 }
@@ -1074,18 +1482,153 @@ function useDoseCalculator() {
 	};
 }
 //#endregion
+//#region src/composables/useListReorder.ts
+/** Inline style for a visually hidden `aria-live` region (no global utility class in the SDK). */
+var REORDER_ANNOUNCER_STYLE = Object.freeze({
+	position: "absolute",
+	width: "1px",
+	height: "1px",
+	padding: "0",
+	margin: "-1px",
+	overflow: "hidden",
+	clip: "rect(0, 0, 0, 0)",
+	whiteSpace: "nowrap",
+	border: "0"
+});
+/**
+* Screen-reader announcements for drag/keyboard move interactions. Bind
+* `announcement` to a `role="status" aria-live="polite"` element styled with
+* `announcerStyle`.
+*/
+function useReorderAnnouncer() {
+	const announcement = ref("");
+	function announce(message) {
+		if (announcement.value === message) announcement.value = "";
+		nextTick(() => {
+			announcement.value = message;
+		});
+	}
+	return {
+		announcement,
+		announce,
+		announcerStyle: REORDER_ANNOUNCER_STYLE
+	};
+}
+/** Pure helper: a copy of `items` with the entry at `from` moved to `to`. */
+function reorderList(items, from, to) {
+	const next = [...items];
+	const [moved] = next.splice(from, 1);
+	next.splice(to, 0, moved);
+	return next;
+}
+/**
+* Keyboard-accessible list reordering shared by the SDK's drag-to-reorder lists.
+* It owns the HTML5 drag state, the drop-index maths, and an Alt+Arrow keyboard
+* alternative that announces every move through a polite live region — so a
+* reorder never depends on a pointer.
+*/
+function useListReorder(options) {
+	const draggingId = ref(null);
+	const dragOverId = ref(null);
+	const { announcement, announce, announcerStyle } = useReorderAnnouncer();
+	const noun = options.itemNoun ?? "Item";
+	function isDisabled() {
+		return options.disabled?.() === true;
+	}
+	function idFor(item, index) {
+		return options.getId(item, index);
+	}
+	/** Index within `items()`, resolved by id so filtered/sorted renders still map back. */
+	function indexOf(item, renderIndex) {
+		const id = idFor(item, renderIndex);
+		const found = options.items().findIndex((candidate, index) => idFor(candidate, index) === id);
+		return found === -1 ? renderIndex : found;
+	}
+	function labelFor(index) {
+		const item = options.items()[index];
+		if (item === void 0) return noun;
+		return options.getLabel?.(item, index) ?? idFor(item, index);
+	}
+	function clearDragState() {
+		draggingId.value = null;
+		dragOverId.value = null;
+	}
+	function move(fromIndex, toIndex, source = "keyboard") {
+		if (isDisabled()) return;
+		const items = options.items();
+		if (fromIndex === toIndex || fromIndex < 0 || toIndex < 0 || fromIndex >= items.length || toIndex >= items.length) return;
+		const movedId = idFor(items[fromIndex], fromIndex);
+		const label = labelFor(fromIndex);
+		options.onReorder({
+			fromIndex,
+			toIndex,
+			items: reorderList(items, fromIndex, toIndex),
+			source
+		});
+		announce(`${label} moved to position ${toIndex + 1} of ${items.length}.`);
+		nextTick(() => options.getElement?.(movedId)?.focus());
+	}
+	function onDragStart(event, item, index) {
+		if (isDisabled()) return;
+		const id = idFor(item, index);
+		draggingId.value = id;
+		if (event.dataTransfer) {
+			event.dataTransfer.effectAllowed = "move";
+			event.dataTransfer.setData("text/plain", id);
+		}
+	}
+	function onDragOver(event, item, index) {
+		if (isDisabled() || draggingId.value === null) return;
+		event.preventDefault();
+		if (event.dataTransfer) event.dataTransfer.dropEffect = "move";
+		const id = idFor(item, index);
+		dragOverId.value = id === draggingId.value ? null : id;
+	}
+	function onDragLeave() {
+		dragOverId.value = null;
+	}
+	function onDrop(event, item, index) {
+		if (isDisabled() || draggingId.value === null) {
+			clearDragState();
+			return;
+		}
+		event.preventDefault();
+		const fromIndex = options.items().findIndex((candidate, i) => idFor(candidate, i) === draggingId.value);
+		const toIndex = indexOf(item, index);
+		clearDragState();
+		if (fromIndex === -1) return;
+		move(fromIndex, toIndex, "drag");
+	}
+	function onDragEnd() {
+		clearDragState();
+	}
+	function onKeydown(event, item, index) {
+		if (isDisabled() || !event.altKey) return;
+		const direction = event.key === "ArrowUp" || event.key === "ArrowLeft" ? -1 : event.key === "ArrowDown" || event.key === "ArrowRight" ? 1 : 0;
+		if (direction === 0) return;
+		event.preventDefault();
+		const fromIndex = indexOf(item, index);
+		move(fromIndex, fromIndex + direction, "keyboard");
+	}
+	return {
+		draggingId,
+		dragOverId,
+		isDragging: (id) => draggingId.value === id,
+		isDragOver: (id) => dragOverId.value === id,
+		announcement,
+		announcerStyle,
+		announce,
+		onDragStart,
+		onDragOver,
+		onDragLeave,
+		onDrop,
+		onDragEnd,
+		onKeydown,
+		move
+	};
+}
+//#endregion
 //#region src/composables/useWellPlateEditor.ts
-var DEFAULT_PALETTE = [
-	"#3B82F6",
-	"#10B981",
-	"#EF4444",
-	"#F59E0B",
-	"#8B5CF6",
-	"#F97316",
-	"#06B6D4",
-	"#14B8A6",
-	"#6B7280"
-];
 var MAX_HISTORY = 50;
 function createEmptyPlate(name, format, id) {
 	return {
@@ -1169,7 +1712,7 @@ function useWellPlateEditor(initialState, options = {}) {
 		const sample = {
 			id: generateSampleId(),
 			name,
-			color: color || DEFAULT_PALETTE[internalState.value.samples.length % DEFAULT_PALETTE.length],
+			color: color || SAMPLE_COLOR_SCALE[internalState.value.samples.length % SAMPLE_COLOR_SCALE.length],
 			count: 0
 		};
 		internalState.value.samples.push(sample);
@@ -1277,7 +1820,7 @@ function useWellPlateEditor(initialState, options = {}) {
 				if (sampleId && !sampleMap.has(sampleId)) sampleMap.set(sampleId, {
 					id: sampleId,
 					name: sampleName || sampleId,
-					color: DEFAULT_PALETTE[sampleMap.size % DEFAULT_PALETTE.length],
+					color: SAMPLE_COLOR_SCALE[sampleMap.size % SAMPLE_COLOR_SCALE.length],
 					count: 0
 				});
 				const plate = plateMap.get(plateName);
@@ -2270,9 +2813,6 @@ function splitByTokenLength(classes, tokenized) {
 }
 //#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);
 }
@@ -2986,7 +3526,7 @@ function useFileImport(options = {}) {
 			result.value = parsed;
 			return parsed;
 		} catch (err) {
-			error.value = readErrorMessage(err);
+			error.value = readErrorMessage(err, "Failed to import file.");
 			throw err;
 		} finally {
 			loading.value = false;
@@ -3096,108 +3636,6 @@ function formatBytes(bytes) {
 	if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;
 	return `${Math.round(bytes / (1024 * 1024))} MB`;
 }
-function readErrorMessage(value) {
-	if (value instanceof Error && value.message) return value.message;
-	if (typeof value === "string" && value.trim()) return value;
-	return "Failed to import file.";
-}
-//#endregion
-//#region src/utils/color.ts
-var HEX_RE = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i;
-function clamp(n, min, max) {
-	return Math.min(max, Math.max(min, n));
-}
-function hexToHsl(hex) {
-	const match = HEX_RE.exec(hex.trim());
-	if (!match) return {
-		h: 0,
-		s: 0,
-		l: 50
-	};
-	let raw = match[1];
-	if (raw.length === 3) raw = raw.split("").map((c) => c + c).join("");
-	const r = parseInt(raw.slice(0, 2), 16) / 255;
-	const g = parseInt(raw.slice(2, 4), 16) / 255;
-	const b = parseInt(raw.slice(4, 6), 16) / 255;
-	const max = Math.max(r, g, b);
-	const min = Math.min(r, g, b);
-	const delta = max - min;
-	let h = 0;
-	if (delta !== 0) if (max === r) h = (g - b) / delta % 6;
-	else if (max === g) h = (b - r) / delta + 2;
-	else h = (r - g) / delta + 4;
-	h = (h * 60 + 360) % 360;
-	const l = (max + min) / 2;
-	const s = delta === 0 ? 0 : delta / (1 - Math.abs(2 * l - 1));
-	return {
-		h,
-		s: s * 100,
-		l: l * 100
-	};
-}
-function hslToHex(h, s, l) {
-	const sNorm = clamp(s, 0, 100) / 100;
-	const lNorm = clamp(l, 0, 100) / 100;
-	const hNorm = (h % 360 + 360) % 360;
-	const c = (1 - Math.abs(2 * lNorm - 1)) * sNorm;
-	const x = c * (1 - Math.abs(hNorm / 60 % 2 - 1));
-	const m = lNorm - c / 2;
-	let r = 0, g = 0, b = 0;
-	if (hNorm < 60) [r, g, b] = [
-		c,
-		x,
-		0
-	];
-	else if (hNorm < 120) [r, g, b] = [
-		x,
-		c,
-		0
-	];
-	else if (hNorm < 180) [r, g, b] = [
-		0,
-		c,
-		x
-	];
-	else if (hNorm < 240) [r, g, b] = [
-		0,
-		x,
-		c
-	];
-	else if (hNorm < 300) [r, g, b] = [
-		x,
-		0,
-		c
-	];
-	else [r, g, b] = [
-		c,
-		0,
-		x
-	];
-	const toHex = (n) => Math.round((n + m) * 255).toString(16).padStart(2, "0");
-	return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
-}
-/**
-* Derive a same-hue-family shade of `parentHex` for child at `index` of `total`.
-*
-* Lightness is distributed evenly within [35, 75] so all children remain
-* readable on light/dark backgrounds. Hue and saturation are inherited from
-* the parent. With `total <= 1`, returns the parent unchanged.
-*
-* Children are ordered light → dark by index, so index 0 is the brightest
-* sibling and index `total - 1` is the darkest.
-*/
-function deriveShade(parentHex, index, total) {
-	if (total <= 1) return parentHex;
-	const { h, s, l } = hexToHsl(parentHex);
-	const L_MIN = 35;
-	const L_MAX = 75;
-	const spread = Math.min(L_MAX - L_MIN, 40);
-	const center = clamp(l, L_MIN + spread / 2, L_MAX - spread / 2);
-	const top = center + spread / 2;
-	const bot = center - spread / 2;
-	const childL = top - (total === 1 ? .5 : index / (total - 1)) * (top - bot);
-	return hslToHex(h, clamp(s, 35, 100), childL);
-}
 //#endregion
 //#region src/utils/sampleGroupPath.ts
 /** Split a group name into normalized hierarchy segments. */
@@ -3657,6 +4095,30 @@ function useScheduleDrag(options) {
 		else if ((state.type === "resize-top" || state.type === "resize-bottom") && state.event && options.onResizeComplete) options.onResizeComplete(state.event, g.start, g.end);
 		cleanup();
 	}
+	/**
+	* Keyboard alternative to the pointer drag: shifts an event by one slot
+	* (`mode: 'move'`) or grows/shrinks its end by one slot (`mode: 'resize'`),
+	* staying inside the visible day. Returns whether the nudge was applied.
+	*/
+	function nudgeEvent(event, direction, mode = "move") {
+		if (options.readonly.value) return false;
+		if (mode === "move" && event.draggable === false) return false;
+		if (mode === "resize" && event.resizable === false) return false;
+		const slotMin = options.slotDuration.value;
+		const dayStart = options.dayStartHour.value * 60;
+		const dayEnd = options.dayEndHour.value * 60;
+		const start = dateToMinutes(new Date(event.start));
+		const end = dateToMinutes(new Date(event.end));
+		const nextStart = mode === "move" ? start + direction * slotMin : start;
+		const nextEnd = mode === "move" ? end + direction * slotMin : Math.max(start + slotMin, end + direction * slotMin);
+		if (nextStart < dayStart || nextEnd > dayEnd || nextEnd <= nextStart) return false;
+		const base = new Date(event.start);
+		const newStart = minutesToDate(base, nextStart);
+		const newEnd = minutesToDate(base, nextEnd);
+		if (mode === "move") options.onMoveComplete?.(event, newStart, newEnd);
+		else options.onResizeComplete?.(event, newStart, newEnd);
+		return true;
+	}
 	function addListeners() {
 		document.addEventListener("pointermove", onPointerMove);
 		document.addEventListener("pointerup", onPointerUp);
@@ -3674,7 +4136,8 @@ function useScheduleDrag(options) {
 		ghost,
 		startCreate,
 		startMove,
-		startResize
+		startResize,
+		nudgeEvent
 	};
 }
 function snapMinutes(minutes, step) {
@@ -4031,6 +4494,57 @@ function useBioTemplateComponents(target) {
 	};
 }
 //#endregion
+//#region src/composables/flattenWorkspaceBindings.ts
+/**
+* Pick the shared template-component binding keys off a resolved bio-template workspace
+* (or its `components` source directly), so composables that build on `useBioTemplateWorkspace`
+* spread one object instead of re-listing all 9 keys by hand.
+*
+* @example Recommended
+* ```ts
+* const bindings = { renderer, ...flattenWorkspaceComponentBindings(components) }
+* ```
+*/
+function flattenWorkspaceComponentBindings(source) {
+	return {
+		componentBindings: source.componentBindings,
+		componentBindingsById: source.componentBindingsById,
+		componentImports: source.componentImports,
+		componentProps: source.componentProps,
+		componentPropsById: source.componentPropsById,
+		componentPropsByComponent: source.componentPropsByComponent,
+		componentSnippets: source.componentSnippets,
+		componentUsage: source.componentUsage,
+		getComponentProps: source.getComponentProps
+	};
+}
+/**
+* `computed()`-lifted version of {@link flattenWorkspaceComponentBindings} for composables
+* that hold their resolved workspace behind a `ComputedRef` (e.g. a regenerated workspace
+* swapped in via `shallowRef`/`effectScope`), so each key stays independently reactive
+* instead of forcing consumers to unwrap the whole workspace to read one field.
+* `getComponentProps` stays a plain callable function, matching the un-lifted composables.
+*
+* @example Recommended
+* ```ts
+* const workspace = computed(() => workspaceRef.value)
+* const { componentBindings, componentProps, getComponentProps } = liftWorkspaceComponentBindings(workspace)
+* ```
+*/
+function liftWorkspaceComponentBindings(workspace) {
+	return {
+		componentBindings: computed(() => workspace.value.componentBindings),
+		componentBindingsById: computed(() => workspace.value.componentBindingsById),
+		componentImports: computed(() => workspace.value.componentImports),
+		componentProps: computed(() => workspace.value.componentProps),
+		componentPropsById: computed(() => workspace.value.componentPropsById),
+		componentPropsByComponent: computed(() => workspace.value.componentPropsByComponent),
+		componentSnippets: computed(() => workspace.value.componentSnippets),
+		componentUsage: computed(() => workspace.value.componentUsage),
+		getComponentProps: (component, options) => workspace.value.getComponentProps(component, options)
+	};
+}
+//#endregion
 //#region src/composables/useBioTemplateWorkspace.ts
 /** One-stop wiring for BioTemplateRenderer, FormBuilder, AppSidebar, and template-aware SDK components. */
 function useBioTemplateWorkspace(target, options = {}) {
@@ -4038,21 +4552,25 @@ function useBioTemplateWorkspace(target, options = {}) {
 	const workspace = useControlWorkspace(controls.controls, options);
 	const components = useBioTemplateComponents(target);
 	const renderer = isTemplateObjectTarget(target) ? { target } : null;
-	const bindings = {
-		renderer,
-		form: workspace.bindings.form,
-		sidebar: workspace.bindings.sidebar,
-		topBar: workspace.bindings.topBar,
-		topBarSettings: workspace.bindings.topBarSettings,
-		pillNav: workspace.bindings.pillNav,
+	const componentBindings = flattenWorkspaceComponentBindings({
 		componentBindings: components.bindings,
 		componentBindingsById: components.componentBindingsById,
+		componentImports: components.imports,
 		componentProps: components.componentProps,
 		componentPropsById: components.componentPropsById,
 		componentPropsByComponent: components.componentPropsByComponent,
 		componentSnippets: components.snippets,
 		componentUsage: components.usage,
 		getComponentProps: components.getComponentProps
+	});
+	const bindings = {
+		renderer,
+		form: workspace.bindings.form,
+		sidebar: workspace.bindings.sidebar,
+		topBar: workspace.bindings.topBar,
+		topBarSettings: workspace.bindings.topBarSettings,
+		pillNav: workspace.bindings.pillNav,
+		...componentBindings
 	};
 	return {
 		target,
@@ -4069,15 +4587,7 @@ function useBioTemplateWorkspace(target, options = {}) {
 		topBarSettings: workspace.topBarSettings,
 		bindings,
 		renderer,
-		componentBindings: components.bindings,
-		componentBindingsById: components.componentBindingsById,
-		componentImports: components.imports,
-		componentProps: components.componentProps,
-		componentPropsById: components.componentPropsById,
-		componentPropsByComponent: components.componentPropsByComponent,
-		componentSnippets: components.snippets,
-		componentUsage: components.usage,
-		getComponentProps: components.getComponentProps
+		...componentBindings
 	};
 }
 function isTemplateObjectTarget(target) {
@@ -4118,14 +4628,7 @@ function useBioTemplatePackWorkspace(packId, options = {}) {
 	const pillNav = computed(() => workspace.value.pillNav);
 	const topBarSettings = computed(() => workspace.value.topBarSettings);
 	const bindings = computed(() => workspace.value.bindings);
-	const componentBindings = computed(() => workspace.value.componentBindings);
-	const componentBindingsById = computed(() => workspace.value.componentBindingsById);
-	const componentImports = computed(() => workspace.value.componentImports);
-	const componentProps = computed(() => workspace.value.componentProps);
-	const componentPropsById = computed(() => workspace.value.componentPropsById);
-	const componentPropsByComponent = computed(() => workspace.value.componentPropsByComponent);
-	const componentSnippets = computed(() => workspace.value.componentSnippets);
-	const componentUsage = computed(() => workspace.value.componentUsage);
+	const { componentBindings, componentBindingsById, componentImports, componentProps, componentPropsById, componentPropsByComponent, componentSnippets, componentUsage, getComponentProps: getWorkspaceComponentProps } = liftWorkspaceComponentBindings(workspace);
 	watch(collection, (value) => {
 		workspaceRef.value = createWorkspace(value);
 	});
@@ -4168,7 +4671,7 @@ function useBioTemplatePackWorkspace(packId, options = {}) {
 		componentPropsByComponent,
 		componentSnippets,
 		componentUsage,
-		getComponentProps: (component, options) => workspace.value.getComponentProps(component, options),
+		getComponentProps: getWorkspaceComponentProps,
 		applyCollection,
 		resetToDefaultCollection,
 		save: templateCollection.save,
@@ -4199,14 +4702,7 @@ function useBioTemplatePresetWorkspace(presetId, options = {}) {
 	const collection = templateCollection.templateCollection;
 	const workspace = computed(() => useBioTemplateWorkspace(collection.value, resolvedControlOptions));
 	const renderer = computed(() => ({ target: collection.value }));
-	const componentBindings = computed(() => workspace.value.componentBindings);
-	const componentBindingsById = computed(() => workspace.value.componentBindingsById);
-	const componentImports = computed(() => workspace.value.componentImports);
-	const componentProps = computed(() => workspace.value.componentProps);
-	const componentPropsById = computed(() => workspace.value.componentPropsById);
-	const componentPropsByComponent = computed(() => workspace.value.componentPropsByComponent);
-	const componentSnippets = computed(() => workspace.value.componentSnippets);
-	const componentUsage = computed(() => workspace.value.componentUsage);
+	const { componentBindings, componentBindingsById, componentImports, componentProps, componentPropsById, componentPropsByComponent, componentSnippets, componentUsage, getComponentProps } = liftWorkspaceComponentBindings(workspace);
 	const form = reactive({
 		...controls.form,
 		modelValue: controlValues.value,
@@ -4239,9 +4735,6 @@ function useBioTemplatePresetWorkspace(presetId, options = {}) {
 		onPillSelect: pillNav.onSelect,
 		...topBarSettings
 	}));
-	function getComponentProps(component, options) {
-		return workspace.value.getComponentProps(component, options);
-	}
 	const bindings = {
 		renderer,
 		form,
@@ -4367,36 +4860,6 @@ var SLOT_CYCLE = [
 	"B",
 	"Y"
 ];
-var PLATE_CONFIGS = {
-	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
-	}
-};
 var globalIdCounter = 0;
 function generateId() {
 	globalIdCounter++;
@@ -4480,7 +4943,7 @@ function useRackEditor(initialRacks, options) {
 		if (!config) return;
 		let counter = 1;
 		for (let row = 0; row < config.rows; row++) for (let col = 0; col < config.cols; col++) {
-			const wellId = `${String.fromCharCode(65 + row)}${col + 1}`;
+			const wellId = `${rowLabel(row)}${col + 1}`;
 			if (!rack.wells[wellId]?.sampleType) {
 				const paddedNum = String(counter).padStart(3, "0");
 				rack.wells[wellId] = {
@@ -5144,6 +5607,6 @@ function useProtocolTemplates() {
 	};
 }
 //#endregion
-export { useToast as $, useFileImport as A, useDoseCalculator as B, getSampleGroupParentPath as C, detectDelimiter as D, hslToHex as E, extractSampleNamesFromDesignData as F, useMobileSupportGate as G, useJobsStatusTray as H, extractSampleOptionsFromDesignData as I, getInjectedFrontendRevision as J, APP_EXPERIMENT_KEY as K, unwrapExperimentDesignData as L, extractSamplesFromDesignData as M, useAutoGroup as N, parseDelimitedText as O, parseCSV as P, useTheme as Q, DEFAULT_COLORS as R, getSampleGroupMajorPrefix as S, hexToHsl as T, usePluginJobCenter as U, combinePluginJobSources as V, DEFAULT_MOBILE_VIEWPORT_QUERY as W, getPresenceClientId as X, useRuntimeAlignment as Y, usePresenceHeartbeat as Z, useScheduleDrag as _, useReagentSeries as a, useExpansionSet as b, useBioTemplatePresetWorkspace as c, getBioTemplateComponentProps as d, candidateMatchesSearch as et, toBioTemplateComponentPropsByComponent as f, useExperimentSave as g, useTemplateCollection as h, generateDilutionSeries as i, useSortedItems as it, validateImportFile as j, readFileAsText as k, useBioTemplatePackWorkspace as l, useBioTemplateControls as m, DEFAULT_PRESETS as n, useTextSearch as nt, useGroupAssignment as o, useBioTemplateComponents as p, useAppExperiment as q, DEFAULT_UNITS as r, compareSortValues as rt, useRackEditor as s, useProtocolTemplates as t, normalizeSearchQuery as tt, useBioTemplateWorkspace as u, useExperimentSamples as v, deriveShade as w, useSampleGroups as x, useExperimentData as y, useWellPlateEditor as z };
+export { usePresenceHeartbeat as $, useAutoGroup as A, useReorderAnnouncer as B, getSampleGroupParentPath as C, useFileImport as D, readFileAsText as E, DEFAULT_COLORS as F, usePluginWorkspace as G, combinePluginJobSources as H, useWellPlateEditor as I, APP_EXPERIMENT_KEY as J, DEFAULT_MOBILE_VIEWPORT_QUERY as K, REORDER_ANNOUNCER_STYLE as L, extractSampleNamesFromDesignData as M, extractSampleOptionsFromDesignData as N, validateImportFile as O, unwrapExperimentDesignData as P, getPresenceClientId as Q, reorderList as R, getSampleGroupMajorPrefix as S, parseDelimitedText as T, useJobsStatusTray as U, useDoseCalculator as V, usePluginJobCenter as W, getInjectedFrontendRevision as X, useAppExperiment as Y, useRuntimeAlignment as Z, useScheduleDrag as _, useReagentSeries as a, compareSortValues as at, useExpansionSet as b, useBioTemplatePresetWorkspace as c, useRovingFocus as ct, getBioTemplateComponentProps as d, useTheme as et, toBioTemplateComponentPropsByComponent as f, useExperimentSave as g, useTemplateCollection as h, generateDilutionSeries as i, useTextSearch as it, parseCSV as j, extractSamplesFromDesignData as k, useBioTemplatePackWorkspace as l, useBioTemplateControls as m, DEFAULT_PRESETS as n, candidateMatchesSearch as nt, useGroupAssignment as o, useSortedItems as ot, useBioTemplateComponents as p, useMobileSupportGate as q, DEFAULT_UNITS as r, normalizeSearchQuery as rt, useRackEditor as s, useMenuKeyboard as st, useProtocolTemplates as t, useToast as tt, useBioTemplateWorkspace as u, useExperimentSamples as v, detectDelimiter as w, useSampleGroups as x, useExperimentData as y, useListReorder as z };
 
-//# sourceMappingURL=useProtocolTemplates-DHwSveE6.js.map
+//# sourceMappingURL=useProtocolTemplates-BmX_iVBR.js.map