@morscherlab/mint-sdk 1.2.0-beta.4 → 1.2.0-beta.7

package/src/components/PluginWorkspaceView.vue

@@ -12,26 +12,19 @@
 import { computed, useSlots } from 'vue'
 import type {
   AccountMenuItem,
-  ExperimentSummary,
-  PageSelectorItem,
   PillNavItem,
   PluginSwitcherPlugin,
   PillNavOption,
 } from '../types'
 import { useAppExperiment } from '../composables/useAppExperiment'
-import AppLayout from './AppLayout.vue'
-import AppSidebar from './AppSidebar.vue'
-import AppTopBar from './AppTopBar.vue'
-import { usePluginWorkspaceControls } from './PluginWorkspaceView.controls'
-import { usePluginWorkspaceNavigation } from './PluginWorkspaceView.navigation'
-import {
-  getPluginWorkspaceSidebarSlotNames,
-  getPluginWorkspaceTopBarSlotNames,
-  hasPluginWorkspaceSidebarSurface,
-} from './PluginWorkspaceView.shell'
+import { usePluginWorkspace } from '../composables/usePluginWorkspace'
+import WorkspaceControlsInternal from './internal/WorkspaceControlsInternal.vue'
+import WorkspaceShellInternal from './internal/WorkspaceShellInternal.vue'
+import WorkspaceSidebarInternal from './internal/WorkspaceSidebarInternal.vue'
 import type {
   PluginWorkspaceForwardedSlotProps,
   PluginWorkspaceSlotProps,
+  PluginWorkspaceViewEmits,
   PluginWorkspaceViewProps,
 } from './PluginWorkspaceView.props'
 
@@ -103,28 +96,7 @@ const props = withDefaults(defineProps<PluginWorkspaceViewProps>(), {
   sidebarCloseLabel: 'Close workspace sidebar',
 })
 
-const emit = defineEmits<{
-  'update:activeView': [value: string]
-  'page-selector-select': [page: PageSelectorItem]
-  'pill-select': [item: PillNavItem]
-  'pill-option-select': [option: PillNavOption, item: PillNavItem]
-  'plugin-switcher-select': [plugin: PluginSwitcherPlugin]
-  'plugin-switcher-install': []
-  'account-menu-select': [item: AccountMenuItem]
-  'sign-out': []
-  'notifications-click': []
-  'settings-values-change': [data: Record<string, unknown>]
-  'admin-click': []
-  'experiment-select': [experiment: ExperimentSummary]
-  'experiment-detach': []
-  'update:modelValue': [values: Record<string, unknown>]
-  'update:values': [values: Record<string, unknown>]
-  'update:sidebarCollapsed': [value: boolean]
-  'update:toggle': [sectionId: string, value: boolean]
-  'section-action': [sectionId: string, actionId: string]
-  'form-submit': [sectionId: string, values: Record<string, unknown>]
-  'form-cancel': [sectionId: string]
-}>()
+const emit = defineEmits<PluginWorkspaceViewEmits>()
 
 defineSlots<{
   default?: (props: PluginWorkspaceSlotProps) => unknown
@@ -158,82 +130,19 @@ if (props.experimentShell) {
   })
 }
 
-const topBarSlotNames = computed<string[]>(() =>
-  getPluginWorkspaceTopBarSlotNames(slots),
-)
-
-const sidebarSlotNames = computed<string[]>(() =>
-  getPluginWorkspaceSidebarSlotNames(slots),
-)
-
 const {
-  generatedPillNav,
-  generatedDefaultView,
-  internalControlValues,
-  resolvedComponentBindings,
-  resolvedComponentBindingsById,
-  resolvedComponentProps,
-  resolvedComponentPropsById,
+  shell,
+  sidebar,
+  controls,
   handleControlValuesUpdate,
-} = 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 {
-  resolvedPillNav,
-  resolvedActiveView,
-  resolvedCurrentPillId,
-  resolvedCurrentPageSelectorId,
-  setActiveView,
   handlePageSelectorSelect,
   handlePillSelect,
-} = 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,
-  generatedDefaultView,
-  emitActiveView: (viewId) => emit('update:activeView', viewId),
-  emitPageSelectorSelect: (page) => emit('page-selector-select', page),
-  emitPillSelect: (item) => emit('pill-select', item),
+} = usePluginWorkspace({
+  props,
+  slots,
+  emit,
 })
 
-const hasSidebarSurface = computed(() => {
-  return hasPluginWorkspaceSidebarSurface({
-    showSidebar: props.showSidebar,
-    panels: props.panels,
-    forms: props.forms,
-    model: props.model,
-    controls: props.controls,
-    showSidebarWhenEmpty: props.showSidebarWhenEmpty,
-    sidebarContentId: props.sidebarContentId,
-    sidebarTitle: props.sidebarTitle,
-    sidebarSubtitle: props.sidebarSubtitle,
-    sidebarBadge: props.sidebarBadge,
-    hasSidebarSlot: Boolean(slots.sidebar),
-    sidebarSlotCount: sidebarSlotNames.value.length,
-  })
-})
-
-function handlePillOptionSelect(option: PillNavOption, item: PillNavItem) {
-  emit('pill-option-select', option, item)
-}
-
 function handleToggle(sectionId: string, value: boolean) {
   emit('update:toggle', sectionId, value)
 }
@@ -249,126 +158,48 @@ function handleFormCancel(sectionId: string) {
 </script>
 
 <template>
-  <AppLayout
-    class="mint-plugin-workspace-view"
-    :sidebar-position="sidebarPosition"
-    :sidebar-width="sidebarWidth"
-    :floating="floating"
-    :responsive-sidebar="responsiveSidebar"
-    :sidebar-toggle-label="sidebarToggleLabel"
-    :sidebar-close-label="sidebarCloseLabel"
+  <WorkspaceShellInternal
+    :shell="shell"
+    @page-selector-select="handlePageSelectorSelect"
+    @pill-select="handlePillSelect"
+    @pill-option-select="(option: PillNavOption, item: PillNavItem) => emit('pill-option-select', option, item)"
+    @plugin-switcher-select="(plugin: PluginSwitcherPlugin) => emit('plugin-switcher-select', plugin)"
+    @plugin-switcher-install="emit('plugin-switcher-install')"
+    @account-menu-select="(item: AccountMenuItem) => emit('account-menu-select', item)"
+    @sign-out="emit('sign-out')"
+    @notifications-click="emit('notifications-click')"
+    @settings-values-change="emit('settings-values-change', $event)"
+    @admin-click="emit('admin-click')"
   >
-    <template #topbar>
-      <slot
-        name="topbar"
-        :active-view="resolvedActiveView"
-        :set-active-view="setActiveView"
-        :values="internalControlValues"
-        :component-bindings="resolvedComponentBindings"
-        :component-bindings-by-id="resolvedComponentBindingsById"
-        :component-props="resolvedComponentProps"
-        :component-props-by-id="resolvedComponentPropsById"
-      >
-        <AppTopBar
-          :title="title"
-          :subtitle="subtitle"
-          :variant="topBarVariant"
-          :home-path="homePath"
-          :show-logo="showLogo"
-          :page-selector="pageSelector"
-          :current-page-selector-id="resolvedCurrentPageSelectorId"
-          :plugin-switcher="pluginSwitcher"
-          :pill-nav="resolvedPillNav"
-          :current-pill-id="resolvedCurrentPillId"
-          :show-theme-toggle="showThemeToggle"
-          :show-settings="showSettings"
-          :settings-config="settingsConfig"
-          :show-standalone-label="showStandaloneLabel"
-          :standalone-label="standaloneLabel"
-          :account-menu="accountMenu"
-          :show-notifications="showNotifications"
-          :has-notification-dot="hasNotificationDot"
-          :show-admin="showAdmin"
-          :admin-path="adminPath"
-          :user-name="userName"
-          :user-initial="userInitial"
-          :user-email="userEmail"
-          @page-selector-select="handlePageSelectorSelect"
-          @pill-select="handlePillSelect"
-          @pill-option-select="handlePillOptionSelect"
-          @plugin-switcher-select="emit('plugin-switcher-select', $event)"
-          @plugin-switcher-install="emit('plugin-switcher-install')"
-          @account-menu-select="emit('account-menu-select', $event)"
-          @sign-out="emit('sign-out')"
-          @notifications-click="emit('notifications-click')"
-          @settings-values-change="emit('settings-values-change', $event)"
-          @admin-click="emit('admin-click')"
-        >
-          <template
-            v-for="slotName in topBarSlotNames"
-            :key="slotName"
-            #[slotName]="slotProps"
-          >
-            <!-- @vue-ignore dynamic SDK slot forwarding for AppTopBar passthrough slots -->
-            <slot
-              :name="slotName"
-              v-bind="slotProps ?? {}"
-            />
-          </template>
-        </AppTopBar>
-      </slot>
+    <template v-if="slots.topbar" #topbar="scope">
+      <slot name="topbar" v-bind="scope" />
     </template>
 
-    <template v-if="hasSidebarSurface" #sidebar>
+    <template
+      v-for="slotName in shell.topBarSlotNames"
+      :key="slotName"
+      #[slotName]="slotProps"
+    >
+      <!-- @vue-ignore dynamic SDK slot forwarding for AppTopBar passthrough slots -->
       <slot
-        name="sidebar"
-        :active-view="resolvedActiveView"
-        :set-active-view="setActiveView"
-        :values="internalControlValues"
-        :component-bindings="resolvedComponentBindings"
-        :component-bindings-by-id="resolvedComponentBindingsById"
-        :component-props="resolvedComponentProps"
-        :component-props-by-id="resolvedComponentPropsById"
-      >
-        <AppSidebar
-          :title="sidebarTitle"
-          :subtitle="sidebarSubtitle"
-          :badge="sidebarBadge"
-          :variant="sidebarVariant"
-          :panels="panels"
-          :active-view="resolvedActiveView"
-          :floating="false"
-          :dense="dense"
-          :width="sidebarWidth"
-          :side="sidebarPosition"
-          :forms="forms"
-          :content-id="sidebarContentId"
-          :show-when-empty="showSidebarWhenEmpty || sidebarContentId !== undefined"
-          :model="model"
-          :controls="controls"
-          :control-options="controlOptions"
-          :values="internalControlValues"
-          :form-enhancements="formEnhancements"
-          :show-form-actions="showFormActions"
-          :form-loading="formLoading"
-          :form-disabled="formDisabled"
-          :form-readonly="formReadonly"
-          :form-size="formSize"
-          :collapsible="sidebarCollapsible"
-          :collapsed="sidebarCollapsed"
-          :default-collapsed="defaultSidebarCollapsed"
-          :collapsed-width="sidebarCollapsedWidth"
-          :collapse-button-label="sidebarCollapseButtonLabel"
-          :expand-button-label="sidebarExpandButtonLabel"
+        :name="slotName"
+        v-bind="slotProps ?? {}"
+      />
+    </template>
+
+    <template v-if="shell.hasSidebarSurface" #sidebar="scope">
+      <slot name="sidebar" v-bind="scope">
+        <WorkspaceSidebarInternal
+          :sidebar="sidebar"
           @update:model-value="handleControlValuesUpdate"
           @update:collapsed="emit('update:sidebarCollapsed', $event)"
           @update:toggle="handleToggle"
-          @section-action="(sectionId, actionId) => emit('section-action', sectionId, actionId)"
+          @section-action="(sectionId: string, actionId: string) => emit('section-action', sectionId, actionId)"
           @form-submit="handleFormSubmit"
           @form-cancel="handleFormCancel"
         >
           <template
-            v-for="slotName in sidebarSlotNames"
+            v-for="slotName in sidebar.slotNames"
             :key="slotName"
             #[slotName]="slotProps"
           >
@@ -378,18 +209,16 @@ function handleFormCancel(sectionId: string) {
               v-bind="slotProps ?? {}"
             />
           </template>
-        </AppSidebar>
+        </WorkspaceSidebarInternal>
       </slot>
     </template>
 
-    <slot
-      :active-view="resolvedActiveView"
-      :set-active-view="setActiveView"
-      :values="internalControlValues"
-      :component-bindings="resolvedComponentBindings"
-      :component-bindings-by-id="resolvedComponentBindingsById"
-      :component-props="resolvedComponentProps"
-      :component-props-by-id="resolvedComponentPropsById"
-    />
-  </AppLayout>
+    <template #default>
+      <WorkspaceControlsInternal :controls="controls">
+        <template #default="controlsScope">
+          <slot v-bind="controlsScope" />
+        </template>
+      </WorkspaceControlsInternal>
+    </template>
+  </WorkspaceShellInternal>
 </template>

package/src/components/SecretInput.story.vue

@@ -0,0 +1,79 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+import SecretInput from './SecretInput.vue'
+import type { PluginSecretRef } from '../utils/pluginSecrets'
+
+const sizes = ['sm', 'md', 'lg'] as const
+
+const storedRef: PluginSecretRef = { $secret: 'sec_0f2a4c6e8a0c2e4a6c8e0a2c4e6a8c0e', set: true }
+const lockedRef: PluginSecretRef = { $secret: null, locked: true }
+
+const stored = ref<PluginSecretRef | string | null>({ ...storedRef })
+const unset = ref<PluginSecretRef | string | null>(null)
+const locked = ref<PluginSecretRef | string | null>({ ...lockedRef })
+</script>
+
+<template>
+  <Story title="Base Inputs/SecretInput">
+    <Variant title="Playground">
+      <template #default="{ state }">
+        <div style="padding: 2rem; max-width: 600px;">
+          <SecretInput
+            v-model="state.value"
+            :placeholder="state.placeholder"
+            :disabled="state.disabled"
+            :error="state.error"
+            :size="state.size"
+          />
+          <p style="margin-top: 1rem; font-size: 0.875rem; color: var(--text-muted, #94a3b8);">
+            Submits: <code>{{ JSON.stringify(state.value) }}</code>
+          </p>
+        </div>
+      </template>
+
+      <template #controls="{ state }">
+        <HstText v-model="state.placeholder" title="Placeholder" />
+        <HstSelect
+          v-model="state.size"
+          title="Size"
+          :options="sizes.map(size => ({ label: size, value: size }))"
+        />
+        <HstCheckbox v-model="state.disabled" title="Disabled" />
+        <HstCheckbox v-model="state.error" title="Error" />
+      </template>
+
+      <template #initState>
+        {{ {
+          value: { $secret: 'sec_0f2a4c6e8a0c2e4a6c8e0a2c4e6a8c0e', set: true },
+          placeholder: 'Enter a new value',
+          disabled: false,
+          error: false,
+          size: 'md',
+        } }}
+      </template>
+    </Variant>
+
+    <Variant title="States">
+      <div style="padding: 2rem; max-width: 600px; display: flex; flex-direction: column; gap: 1.5rem;">
+        <div>
+          <p style="margin: 0 0 0.5rem; font-size: 0.75rem; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.05em;">
+            Stored
+          </p>
+          <SecretInput v-model="stored" />
+        </div>
+        <div>
+          <p style="margin: 0 0 0.5rem; font-size: 0.75rem; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.05em;">
+            Not set
+          </p>
+          <SecretInput v-model="unset" />
+        </div>
+        <div>
+          <p style="margin: 0 0 0.5rem; font-size: 0.75rem; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.05em;">
+            Provided by environment
+          </p>
+          <SecretInput v-model="locked" />
+        </div>
+      </div>
+    </Variant>
+  </Story>
+</template>

package/src/components/SecretInput.vue

@@ -0,0 +1,150 @@
+<script setup lang="ts">
+/** Edits one plugin secret setting: shows set / not set / provided by environment, and submits a `$secret` reference, a new value, or `null`. */
+import { computed, ref, watch } from 'vue'
+import BaseInput from './BaseInput.vue'
+import BaseButton from './BaseButton.vue'
+import {
+  clearPluginSecret,
+  isPluginSecretLocked,
+  isPluginSecretRef,
+  keepPluginSecret,
+  pluginSecretLabel,
+  pluginSecretState,
+  setPluginSecret,
+  type PluginSecretRef,
+  type PluginSecretState,
+} from '../utils/pluginSecrets'
+
+type SecretValue = PluginSecretRef | string | null
+
+interface Props {
+  /** The `$secret` marker from the settings response, a typed string, or `null`. */
+  modelValue?: SecretValue
+  placeholder?: string
+  disabled?: boolean
+  error?: boolean
+  size?: 'sm' | 'md' | 'lg'
+  /** Label on the control that starts entering a replacement value. */
+  changeLabel?: string
+  /** Label on the control that clears a stored secret. */
+  clearLabel?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  modelValue: null,
+  placeholder: 'Enter a new value',
+  disabled: false,
+  error: false,
+  size: 'md',
+  changeLabel: 'Change',
+  clearLabel: 'Clear',
+})
+
+const emit = defineEmits<{
+  'update:modelValue': [value: SecretValue]
+}>()
+
+/** The reference this field started from, so an abandoned edit can restore it. */
+const storedReference = ref<PluginSecretRef | null>(keepPluginSecret(props.modelValue))
+const isEditing = ref(typeof props.modelValue === 'string')
+
+watch(
+  () => props.modelValue,
+  (value) => {
+    if (isPluginSecretRef(value)) {
+      storedReference.value = keepPluginSecret(value)
+      isEditing.value = false
+    }
+  },
+)
+
+const state = computed<PluginSecretState>(() => pluginSecretState(props.modelValue))
+const locked = computed(() => isPluginSecretLocked(props.modelValue)
+  || isPluginSecretLocked(storedReference.value))
+const statusLabel = computed(() => isEditing.value
+  ? 'New value'
+  : pluginSecretLabel(props.modelValue))
+const typedValue = computed(() => typeof props.modelValue === 'string' ? props.modelValue : '')
+const canClear = computed(() => !locked.value && (state.value === 'set' || isEditing.value))
+
+function startEditing(): void {
+  if (props.disabled || locked.value) return
+  isEditing.value = true
+  emit('update:modelValue', setPluginSecret(''))
+}
+
+function updateTyped(value: string | number | null): void {
+  emit('update:modelValue', setPluginSecret(value == null ? '' : String(value)))
+}
+
+function cancelEditing(): void {
+  isEditing.value = false
+  emit('update:modelValue', storedReference.value ? { ...storedReference.value } : null)
+}
+
+function clear(): void {
+  if (props.disabled || locked.value) return
+  isEditing.value = false
+  storedReference.value = null
+  emit('update:modelValue', clearPluginSecret())
+}
+</script>
+
+<template>
+  <div class="mint-secret-input" :class="{ 'mint-secret-input--error': error }">
+    <div class="mint-secret-input__status">
+      <span
+        class="mint-secret-input__badge"
+        :class="`mint-secret-input__badge--${isEditing ? 'pending' : state}`"
+      >{{ statusLabel }}</span>
+      <span v-if="locked" class="mint-secret-input__hint">
+        This value comes from the environment and cannot be edited here.
+      </span>
+    </div>
+
+    <BaseInput
+      v-if="isEditing"
+      type="password"
+      autocomplete="new-password"
+      :model-value="typedValue"
+      :placeholder="placeholder"
+      :disabled="disabled"
+      :error="error"
+      :size="size"
+      @update:model-value="updateTyped"
+    />
+
+    <div class="mint-secret-input__actions">
+      <BaseButton
+        v-if="!isEditing"
+        type="button"
+        variant="secondary"
+        :size="size === 'lg' ? 'md' : 'sm'"
+        :disabled="disabled || locked"
+        @click="startEditing"
+      >
+        {{ changeLabel }}
+      </BaseButton>
+      <BaseButton
+        v-else
+        type="button"
+        variant="ghost"
+        :size="size === 'lg' ? 'md' : 'sm'"
+        :disabled="disabled"
+        @click="cancelEditing"
+      >
+        Cancel
+      </BaseButton>
+      <BaseButton
+        v-if="canClear"
+        type="button"
+        variant="ghost"
+        :size="size === 'lg' ? 'md' : 'sm'"
+        :disabled="disabled"
+        @click="clear"
+      >
+        {{ clearLabel }}
+      </BaseButton>
+    </div>
+  </div>
+</template>

package/src/components/index.ts

@@ -7,12 +7,14 @@ export { default as BaseCheckbox } from './BaseCheckbox.vue'
 export { default as BaseToggle } from './BaseToggle.vue'
 export { default as BaseRadioGroup } from './BaseRadioGroup.vue'
 export { default as BaseSlider } from './BaseSlider.vue'
+/** Range slider with a gradient color track and color-coded value badge for threshold visualization. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `BaseSlider` instead. */
 export { default as ColorSlider } from './ColorSlider.vue'
 export { default as BaseTabs } from './BaseTabs.vue'
 export { default as BaseModal } from './BaseModal.vue'
 export { default as SegmentedControl } from './SegmentedControl.vue'
 export { default as MultiSelect } from './MultiSelect.vue'
 export { default as BasePill } from './BasePill.vue'
+/** Button that opens a dropdown menu for selecting one option from a list. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `ActionMenu` instead. */
 export { default as DropdownButton } from './DropdownButton.vue'
 export { default as Calendar } from './Calendar.vue'
 export { default as DataFrame } from './DataFrame.vue'
@@ -22,6 +24,7 @@ export { default as FormField } from './FormField.vue'
 export { default as DatePicker } from './DatePicker.vue'
 export { default as TimePicker } from './TimePicker.vue'
 export { default as TagsInput } from './TagsInput.vue'
+export { default as SecretInput } from './SecretInput.vue'
 export { default as NumberInput } from './NumberInput.vue'
 export { default as FileUploader } from './FileUploader.vue'
 
@@ -97,11 +100,15 @@ export { default as ProtocolStepEditor } from './ProtocolStepEditor.vue'
 
 // Scientific display components
 export { default as ScientificNumber } from './ScientificNumber.vue'
+/** Renders a chemical formula string (H₂O, C₆H₁₂O₆, Ca(OH)₂) with typographically correct subscripts and superscripts for charges. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; no platform replacement is planned. */
 export { default as ChemicalFormula } from './ChemicalFormula.vue'
 export { default as SequenceProgressBar } from './SequenceProgressBar.vue'
+/** Filterable instrument alert/event list keyed by each alert's required stable event_key. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; instrument UI moves to the mld-ms plugins. */
 export { default as InstrumentAlertLog } from './InstrumentAlertLog.vue'
 export { default as InstrumentStateBadge } from './InstrumentStateBadge.vue'
+/** Compact card for live instrument monitor status, sample, method, sequence progress, and ETA. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; instrument UI moves to the mld-ms plugins. */
 export { default as InstrumentStatusCard } from './InstrumentStatusCard.vue'
+/** Table for Xcalibur-compatible LCMS sequence rows with optional reorder/remove/duplicate controls. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; instrument UI moves to the mld-ms plugins. */
 export { default as LcmsSequenceTable } from './LcmsSequenceTable.vue'
 
 // Scientific input components
@@ -125,8 +132,10 @@ export { default as ExperimentCodeBadge } from './ExperimentCodeBadge.vue'
 
 // Scheduling / booking components
 export { default as DateTimePicker } from './DateTimePicker.vue'
+/** Paired start/end time pickers that validate range order and display computed duration. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; use `TimePicker` instead. */
 export { default as TimeRangeInput } from './TimeRangeInput.vue'
 export { default as ScheduleCalendar } from './ScheduleCalendar.vue'
+/** Card displaying a lab resource with availability status, specs, tags, and a book action. @deprecated Unused by the MINT platform and scheduled for removal in MINT 1.3; no platform replacement is planned. */
 export { default as ResourceCard } from './ResourceCard.vue'
 export { default as SectionCard } from './SectionCard.vue'
 

package/src/components/internal/WellEditPopupInternal.vue

@@ -1,7 +1,8 @@
 <script setup lang="ts">
-import { ref, watch, computed } from 'vue'
+import { onBeforeUnmount, onMounted, ref, watch, computed } from 'vue'
 import type { Well, WellEditData, WellEditField } from '../../types'
 import { useEventListener } from '../../composables/useEventListener'
+import { useFocusTrap } from '../../composables/useFocusTrap'
 
 interface Props {
   wellId: string
@@ -86,6 +87,22 @@ function handleKeydown(e: KeyboardEvent) {
 
 useEventListener(() => document, 'keydown', handleKeydown)
 
+// The popup has no open/close prop of its own — the parent mounts and unmounts it —
+// so the trap activates on mount and releases (restoring focus) just before unmount,
+// the same lifecycle BaseModal drives off `modelValue`.
+const containerRef = ref<HTMLElement | null>(null)
+const trapActive = ref(false)
+
+useFocusTrap({ containerRef, active: trapActive })
+
+onMounted(() => {
+  trapActive.value = true
+})
+
+onBeforeUnmount(() => {
+  trapActive.value = false
+})
+
 const sampleTypeButtons = [
   { type: 'sample', label: 'S', tooltip: 'Sample' },
   { type: 'blank', label: 'B', tooltip: 'Blank' },
@@ -101,8 +118,10 @@ const sampleTypeButtons = [
 
     <!-- Popup -->
     <div
+      ref="containerRef"
       class="mint-well-edit-popup"
       :style="popupStyle"
+      tabindex="-1"
       @click.stop
     >
       <!-- Header -->