@morscherlab/mint-sdk 1.2.0-beta.3 → 1.2.0-beta.5

package/src/components/ReagentList.vue

@@ -0,0 +1,392 @@
+<script setup lang="ts">
+/** Sortable, searchable table of experiment reagents showing lot number, expiry, storage conditions, and stock level with low-stock warnings. */
+import { ref, computed } from 'vue'
+import type { ReagentColumn, Reagent } from '../types'
+import { useSortedItems } from '../composables/useSortedItems'
+import { useTextSearch } from '../composables/useTextSearch'
+import {
+  REAGENT_COLUMN_LABELS as columnLabels,
+  formatReagentExpiryDate as formatExpiryDate,
+  getReagentColumnValue,
+  getReagentRowClasses,
+  getReagentStockFillClass as getStockFillClass,
+  getReagentStockLevel as getStockLevel,
+  isReagentExpired as isExpired,
+  isReagentExpiringSoon as isExpiringSoon,
+} from './ReagentList.presentation'
+
+interface Props {
+  modelValue?: Reagent[]
+  readonly?: boolean
+  showStockLevel?: boolean
+  lowStockThreshold?: number
+  columns?: ReagentColumn[]
+  sortable?: boolean
+  searchable?: boolean
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  modelValue: () => [],
+  readonly: false,
+  showStockLevel: true,
+  lowStockThreshold: 10,
+  columns: () => ['name', 'lot', 'expiry', 'storage', 'stock'],
+  sortable: true,
+  searchable: true,
+})
+
+const emit = defineEmits<{
+  'update:modelValue': [reagents: Reagent[]]
+  'add': []
+  'edit': [reagent: Reagent]
+  'remove': [reagentId: string]
+  'reorder': [reagentId: string, fromIndex: number, toIndex: number]
+}>()
+
+// State
+const searchQuery = ref('')
+const sortColumn = ref<ReagentColumn | null>(null)
+const sortDirection = ref<'asc' | 'desc'>('asc')
+const draggedId = ref<string | null>(null)
+const dragOverId = ref<string | null>(null)
+
+const reagentSearch = useTextSearch({
+  items: () => props.modelValue || [],
+  query: searchQuery,
+  enabled: () => props.searchable,
+  getText: (reagent) => [
+    reagent.name,
+    reagent.catalogNumber,
+    reagent.lotNumber,
+    reagent.supplier,
+  ],
+})
+
+const reagentSort = computed(() => {
+  if (!sortColumn.value) return null
+  return {
+    key: sortColumn.value,
+    direction: sortDirection.value,
+  }
+})
+
+const sortedReagents = useSortedItems<Reagent, ReagentColumn>({
+  items: reagentSearch.filteredItems,
+  sort: reagentSort,
+  caseSensitive: false,
+  getValue: (reagent, column) => getReagentColumnValue(reagent, column),
+})
+const filteredReagents = sortedReagents.sortedItems
+
+function getRowClass(reagent: Reagent): string[] {
+  return getReagentRowClasses(reagent, {
+    lowStockThreshold: props.lowStockThreshold,
+    draggedId: draggedId.value,
+    dragOverId: dragOverId.value,
+  })
+}
+
+// Actions
+function handleSort(column: ReagentColumn) {
+  if (!props.sortable) return
+  if (sortColumn.value === column) {
+    sortDirection.value = sortDirection.value === 'asc' ? 'desc' : 'asc'
+  } else {
+    sortColumn.value = column
+    sortDirection.value = 'asc'
+  }
+}
+
+function handleEdit(reagent: Reagent) {
+  emit('edit', reagent)
+}
+
+function handleRemove(reagentId: string) {
+  emit('remove', reagentId)
+  const updated = (props.modelValue || []).filter((r) => r.id !== reagentId)
+  emit('update:modelValue', updated)
+}
+
+function handleAdd() {
+  emit('add')
+}
+
+// Drag and drop
+function handleDragStart(event: DragEvent, reagent: Reagent) {
+  if (props.readonly || !props.sortable) return
+  draggedId.value = reagent.id
+  if (event.dataTransfer) {
+    event.dataTransfer.effectAllowed = 'move'
+    event.dataTransfer.setData('text/plain', reagent.id)
+  }
+}
+
+function handleDragOver(event: DragEvent, reagent: Reagent) {
+  if (props.readonly || !props.sortable || !draggedId.value) return
+  event.preventDefault()
+  dragOverId.value = reagent.id
+}
+
+function handleDragLeave() {
+  dragOverId.value = null
+}
+
+function handleDrop(event: DragEvent, targetReagent: Reagent) {
+  if (props.readonly || !props.sortable || !draggedId.value) return
+  event.preventDefault()
+
+  const reagents = [...(props.modelValue || [])]
+  const fromIndex = reagents.findIndex((r) => r.id === draggedId.value)
+  const toIndex = reagents.findIndex((r) => r.id === targetReagent.id)
+
+  if (fromIndex === -1 || toIndex === -1 || fromIndex === toIndex) {
+    draggedId.value = null
+    dragOverId.value = null
+    return
+  }
+
+  const [removed] = reagents.splice(fromIndex, 1)
+  reagents.splice(toIndex, 0, removed)
+
+  emit('reorder', draggedId.value, fromIndex, toIndex)
+  emit('update:modelValue', reagents)
+
+  draggedId.value = null
+  dragOverId.value = null
+}
+
+function handleDragEnd() {
+  draggedId.value = null
+  dragOverId.value = null
+}
+</script>
+
+<template>
+  <div class="mint-reagent-list">
+    <!-- Header -->
+    <div class="mint-reagent-list__header">
+      <!-- Search -->
+      <div v-if="searchable" class="mint-reagent-list__search">
+        <svg class="mint-reagent-list__search-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
+        </svg>
+        <input
+          v-model="searchQuery"
+          type="text"
+          class="mint-reagent-list__search-input"
+          placeholder="Search reagents..."
+        />
+      </div>
+
+      <!-- Add button -->
+      <button
+        v-if="!readonly"
+        type="button"
+        class="mint-reagent-list__add-btn"
+        @click="handleAdd"
+      >
+        <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+        </svg>
+        Add
+      </button>
+    </div>
+
+    <!-- Table -->
+    <table v-if="filteredReagents.length > 0" class="mint-reagent-list__table">
+      <thead>
+        <tr>
+          <th v-if="sortable && !readonly" style="width: 24px" />
+          <th
+            v-for="col in columns"
+            :key="col"
+            :class="[sortable ? 'mint-reagent-list__col--sortable' : '']"
+            @click="handleSort(col)"
+          >
+            {{ columnLabels[col] }}
+            <svg
+              v-if="sortable"
+              :class="[
+                'mint-reagent-list__sort-icon',
+                sortColumn === col ? 'mint-reagent-list__sort-icon--active' : '',
+              ]"
+              fill="none"
+              stroke="currentColor"
+              viewBox="0 0 24 24"
+            >
+              <path
+                v-if="sortColumn === col && sortDirection === 'desc'"
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                stroke-width="2"
+                d="M19 9l-7 7-7-7"
+              />
+              <path
+                v-else
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                stroke-width="2"
+                d="M5 15l7-7 7 7"
+              />
+            </svg>
+          </th>
+          <th v-if="!readonly" style="width: 80px" />
+        </tr>
+      </thead>
+      <tbody>
+        <tr
+          v-for="reagent in filteredReagents"
+          :key="reagent.id"
+          :class="getRowClass(reagent)"
+          :draggable="sortable && !readonly"
+          @dragstart="handleDragStart($event, reagent)"
+          @dragover="handleDragOver($event, reagent)"
+          @dragleave="handleDragLeave"
+          @drop="handleDrop($event, reagent)"
+          @dragend="handleDragEnd"
+        >
+          <!-- Drag handle -->
+          <td v-if="sortable && !readonly">
+            <svg class="mint-reagent-list__drag-handle" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 8h16M4 16h16" />
+            </svg>
+          </td>
+
+          <!-- Name -->
+          <td v-if="columns.includes('name')" class="mint-reagent-list__cell mint-reagent-list__cell--name">
+            <a
+              v-if="reagent.url"
+              :href="reagent.url"
+              target="_blank"
+              rel="noopener noreferrer"
+              class="mint-reagent-list__link"
+            >
+              {{ reagent.name }}
+            </a>
+            <span v-else>{{ reagent.name }}</span>
+          </td>
+
+          <!-- Catalog number -->
+          <td v-if="columns.includes('catalog')" class="mint-reagent-list__cell mint-reagent-list__cell--muted">
+            {{ reagent.catalogNumber || '-' }}
+          </td>
+
+          <!-- Lot number -->
+          <td v-if="columns.includes('lot')" class="mint-reagent-list__cell mint-reagent-list__cell--muted">
+            {{ reagent.lotNumber || '-' }}
+          </td>
+
+          <!-- Expiry -->
+          <td v-if="columns.includes('expiry')" class="mint-reagent-list__cell">
+            <span v-if="isExpired(reagent)" class="mint-reagent-list__expired-text">
+              {{ formatExpiryDate(reagent.expiryDate) }}
+            </span>
+            <span v-else-if="isExpiringSoon(reagent)" class="mint-reagent-list__expiring-text">
+              {{ formatExpiryDate(reagent.expiryDate) }}
+            </span>
+            <span v-else>
+              {{ formatExpiryDate(reagent.expiryDate) }}
+            </span>
+
+            <!-- Expiry badge -->
+            <span v-if="isExpired(reagent)" class="mint-reagent-list__badge mint-reagent-list__badge--error">
+              <svg class="mint-reagent-list__badge-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+              </svg>
+              Expired
+            </span>
+            <span v-else-if="isExpiringSoon(reagent)" class="mint-reagent-list__badge mint-reagent-list__badge--warning">
+              <svg class="mint-reagent-list__badge-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+              </svg>
+              Soon
+            </span>
+          </td>
+
+          <!-- Storage -->
+          <td v-if="columns.includes('storage')" class="mint-reagent-list__cell">
+            <span
+              v-if="reagent.storageCondition"
+              :class="['mint-reagent-list__storage', `mint-reagent-list__storage--${reagent.storageCondition}`]"
+            >
+              {{ reagent.storageCondition }}
+            </span>
+            <span v-else class="mint-reagent-list__cell--muted">-</span>
+          </td>
+
+          <!-- Location -->
+          <td v-if="columns.includes('location')" class="mint-reagent-list__cell mint-reagent-list__cell--muted">
+            {{ reagent.location || '-' }}
+          </td>
+
+          <!-- Stock -->
+          <td v-if="columns.includes('stock') && showStockLevel" class="mint-reagent-list__cell">
+            <div v-if="reagent.stockLevel !== undefined" class="mint-reagent-list__stock">
+              <div class="mint-reagent-list__stock-bar">
+                <div
+                  :class="['mint-reagent-list__stock-fill', getStockFillClass(getStockLevel(reagent))]"
+                  :style="{ width: `${Math.min(100, getStockLevel(reagent))}%` }"
+                />
+              </div>
+              <span class="mint-reagent-list__stock-text">
+                {{ getStockLevel(reagent) }}%
+              </span>
+            </div>
+            <span v-else class="mint-reagent-list__cell--muted">-</span>
+          </td>
+
+          <!-- Supplier -->
+          <td v-if="columns.includes('supplier')" class="mint-reagent-list__cell mint-reagent-list__cell--muted">
+            {{ reagent.supplier || '-' }}
+          </td>
+
+          <!-- Actions -->
+          <td v-if="!readonly" class="mint-reagent-list__cell mint-reagent-list__cell--actions">
+            <button
+              type="button"
+              class="mint-reagent-list__action-btn"
+              aria-label="Edit"
+              @click="handleEdit(reagent)"
+            >
+              <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+              </svg>
+            </button>
+            <button
+              type="button"
+              class="mint-reagent-list__action-btn mint-reagent-list__action-btn--danger"
+              aria-label="Remove"
+              @click="handleRemove(reagent.id)"
+            >
+              <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
+              </svg>
+            </button>
+          </td>
+        </tr>
+      </tbody>
+    </table>
+
+    <!-- Empty state -->
+    <div v-else class="mint-reagent-list__empty">
+      <svg class="mint-reagent-list__empty-icon" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19.428 15.428a2 2 0 00-1.022-.547l-2.387-.477a6 6 0 00-3.86.517l-.318.158a6 6 0 01-3.86.517L6.05 15.21a2 2 0 00-1.806.547M8 4h8l-1 1v5.172a2 2 0 00.586 1.414l5 5c1.26 1.26.367 3.414-1.415 3.414H4.828c-1.782 0-2.674-2.154-1.414-3.414l5-5A2 2 0 009 10.172V5L8 4z" />
+      </svg>
+      <p class="mint-reagent-list__empty-text">
+        {{ searchQuery ? 'No reagents found' : 'No reagents added yet' }}
+      </p>
+      <button
+        v-if="!readonly && !searchQuery"
+        type="button"
+        class="mint-reagent-list__empty-btn"
+        @click="handleAdd"
+      >
+        Add Reagent
+      </button>
+    </div>
+  </div>
+</template>
+
+<style>
+@import '../styles/components/reagent-list.css';
+</style>

package/src/components/ResourceCard.story.vue

@@ -0,0 +1,150 @@
+<script setup lang="ts">
+import ResourceCard from './ResourceCard.vue'
+import type { ResourceSpec } from '../types/components'
+
+const plateReaderSpecs: ResourceSpec[] = [
+  { label: 'Detection', value: 'Absorbance, Fluorescence, Luminescence' },
+  { label: 'Plate formats', value: '6 to 384-well' },
+  { label: 'Temperature', value: 'RT to 45 C' },
+]
+
+const flowCytoSpecs: ResourceSpec[] = [
+  { label: 'Lasers', value: '405nm, 488nm, 561nm, 640nm' },
+  { label: 'Detectors', value: '14 fluorescence + FSC/SSC' },
+  { label: 'Throughput', value: 'Up to 10,000 events/sec' },
+]
+
+function initState() {
+  return {
+    name: 'BMG CLARIOstar Plus',
+    description: 'Multi-mode microplate reader with UV/Vis absorbance, fluorescence, and luminescence detection.',
+    status: 'available' as const,
+    location: 'Lab 204, Bench 3',
+    specs: plateReaderSpecs,
+    tags: ['Plate Reader', 'High-throughput'],
+    nextAvailable: undefined as string | undefined,
+    showBookAction: true,
+    compact: false,
+    size: 'md' as const,
+  }
+}
+</script>
+
+<template>
+  <Story title="Scheduling/ResourceCard">
+    <Variant title="Playground" :init-state="initState">
+      <template #default="{ state }">
+        <div style="padding: 2rem; max-width: 500px;">
+          <ResourceCard
+            :name="state.name"
+            :description="state.description"
+            :status="state.status"
+            :location="state.location"
+            :specs="state.specs"
+            :tags="state.tags"
+            :next-available="state.nextAvailable"
+            :show-book-action="state.showBookAction"
+            :compact="state.compact"
+            :size="state.size"
+            @book="() => console.log('Book clicked')"
+            @click="() => console.log('Card clicked')"
+          />
+        </div>
+      </template>
+      <template #controls="{ state }">
+        <HstText v-model="state.name" title="Name" />
+        <HstText v-model="state.description" title="Description" />
+        <HstSelect
+          v-model="state.status"
+          title="Status"
+          :options="[
+            { value: 'available', label: 'Available' },
+            { value: 'in-use', label: 'In Use' },
+            { value: 'maintenance', label: 'Maintenance' },
+            { value: 'offline', label: 'Offline' },
+          ]"
+        />
+        <HstText v-model="state.location" title="Location" />
+        <HstCheckbox v-model="state.showBookAction" title="Show Book Action" />
+        <HstCheckbox v-model="state.compact" title="Compact" />
+        <HstSelect
+          v-model="state.size"
+          title="Size"
+          :options="[
+            { value: 'sm', label: 'Small' },
+            { value: 'md', label: 'Medium' },
+            { value: 'lg', label: 'Large' },
+          ]"
+        />
+      </template>
+    </Variant>
+
+    <Variant title="In Use">
+      <div style="padding: 2rem; max-width: 500px;">
+        <ResourceCard
+          name="BD FACSCanto II"
+          description="Flow cytometer with 3-laser, 8-color capability for cell analysis."
+          status="in-use"
+          location="Lab 201, Room B"
+          :specs="flowCytoSpecs"
+          :tags="['Flow Cytometry', 'Cell Analysis']"
+          next-available="Today at 15:30"
+        />
+      </div>
+    </Variant>
+
+    <Variant title="Maintenance">
+      <div style="padding: 2rem; max-width: 500px;">
+        <ResourceCard
+          name="Thermo Fisher Centrifuge"
+          description="High-speed refrigerated centrifuge for sample processing."
+          status="maintenance"
+          location="Lab 203"
+          :tags="['Centrifuge']"
+          next-available="Tomorrow at 09:00"
+        />
+      </div>
+    </Variant>
+
+    <Variant title="Compact Mode">
+      <div style="padding: 2rem; max-width: 500px; display: flex; flex-direction: column; gap: 0.5rem;">
+        <ResourceCard name="Plate Reader" status="available" compact />
+        <ResourceCard name="Flow Cytometer" status="in-use" compact />
+        <ResourceCard name="Centrifuge" status="maintenance" compact />
+        <ResourceCard name="Mass Spec" status="offline" compact />
+      </div>
+    </Variant>
+
+    <Variant title="All Statuses (Card)">
+      <div style="padding: 2rem; display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; max-width: 900px;">
+        <ResourceCard
+          name="Available Resource"
+          description="This resource is available for booking."
+          status="available"
+          :tags="['Lab Equipment']"
+        />
+        <ResourceCard
+          name="In-Use Resource"
+          description="Currently being used by another researcher."
+          status="in-use"
+          next-available="In 2 hours"
+          :tags="['Lab Equipment']"
+        />
+        <ResourceCard
+          name="Maintenance Resource"
+          description="Undergoing scheduled maintenance."
+          status="maintenance"
+          next-available="Next Monday"
+          :tags="['Lab Equipment']"
+        />
+        <ResourceCard
+          name="Offline Resource"
+          description="Currently offline and unavailable."
+          status="offline"
+          :tags="['Lab Equipment']"
+          :show-book-action="false"
+        />
+      </div>
+    </Variant>
+  </Story>
+</template>