@morscherlab/mint-sdk 1.3.0 → 1.3.2

package/src/__tests__/fixtures/auto-group/share-exp114.txt

@@ -0,0 +1,123 @@
+exp114_250730_YY_HEK_DFMO_Put_blank_01
+exp114_250730_YY_HEK_DFMO_Put_blank_05
+exp114_250730_YY_HEK_DFMO_Put_blank_05_b
+exp114_250730_YY_HEK_DFMO_Put_blank_119
+exp114_250730_YY_HEK_DFMO_Put_blank_120
+exp114_250730_YY_HEK_DFMO_Put_blank_33
+exp114_250730_YY_HEK_DFMO_Put_blank_58b_postCrash
+exp114_250730_YY_HEK_DFMO_Put_blank_61
+exp114_250730_YY_HEK_DFMO_Put_blank_90
+exp114_250730_YY_HEK_DFMO_Put_DigestControl_91
+exp114_250730_YY_HEK_DFMO_Put_HMW_1-1_35
+exp114_250730_YY_HEK_DFMO_Put_HMW_1-2_44
+exp114_250730_YY_HEK_DFMO_Put_HMW_1-3_52
+exp114_250730_YY_HEK_DFMO_Put_HMW_2-1_36
+exp114_250730_YY_HEK_DFMO_Put_HMW_2-2_45
+exp114_250730_YY_HEK_DFMO_Put_HMW_2-3_53
+exp114_250730_YY_HEK_DFMO_Put_HMW_3-1_37
+exp114_250730_YY_HEK_DFMO_Put_HMW_3-2_46
+exp114_250730_YY_HEK_DFMO_Put_HMW_3-3_54
+exp114_250730_YY_HEK_DFMO_Put_HMW_4-1_09
+exp114_250730_YY_HEK_DFMO_Put_HMW_4-1_38
+exp114_250730_YY_HEK_DFMO_Put_HMW_4-2_47
+exp114_250730_YY_HEK_DFMO_Put_HMW_4-3_55
+exp114_250730_YY_HEK_DFMO_Put_HMW_5-1_39
+exp114_250730_YY_HEK_DFMO_Put_HMW_5-2_48
+exp114_250730_YY_HEK_DFMO_Put_HMW_5-3_56
+exp114_250730_YY_HEK_DFMO_Put_HMW_6-1_40
+exp114_250730_YY_HEK_DFMO_Put_HMW_6-2_49
+exp114_250730_YY_HEK_DFMO_Put_HMW_6-3_57
+exp114_250730_YY_HEK_DFMO_Put_HMW_7-1_41
+exp114_250730_YY_HEK_DFMO_Put_HMW_7-2_50
+exp114_250730_YY_HEK_DFMO_Put_HMW_7-3_rep2_89
+exp114_250730_YY_HEK_DFMO_Put_HMW_8-1_42
+exp114_250730_YY_HEK_DFMO_Put_HMW_8-3_59
+exp114_250730_YY_HEK_DFMO_Put_HMW_8-3_59_20250731221931
+exp114_250730_YY_HEK_DFMO_Put_HMW_9-1_43
+exp114_250730_YY_HEK_DFMO_Put_HMW_9-2_51
+exp114_250730_YY_HEK_DFMO_Put_HMW_9-3_60
+exp114_250730_YY_HEK_DFMO_Put_HMW_DigestControl_34
+exp114_250730_YY_HEK_DFMO_Put_MMW_1-1_63
+exp114_250730_YY_HEK_DFMO_Put_MMW_1-2_72
+exp114_250730_YY_HEK_DFMO_Put_MMW_1-3_80
+exp114_250730_YY_HEK_DFMO_Put_MMW_2-1_64
+exp114_250730_YY_HEK_DFMO_Put_MMW_2-2_73
+exp114_250730_YY_HEK_DFMO_Put_MMW_2-3_81
+exp114_250730_YY_HEK_DFMO_Put_MMW_3-1_65
+exp114_250730_YY_HEK_DFMO_Put_MMW_3-2_74
+exp114_250730_YY_HEK_DFMO_Put_MMW_3-3_82
+exp114_250730_YY_HEK_DFMO_Put_MMW_4-1_66
+exp114_250730_YY_HEK_DFMO_Put_MMW_4-3_83
+exp114_250730_YY_HEK_DFMO_Put_MMW_5-1_67
+exp114_250730_YY_HEK_DFMO_Put_MMW_5-2_75
+exp114_250730_YY_HEK_DFMO_Put_MMW_5-3_84
+exp114_250730_YY_HEK_DFMO_Put_MMW_6-1_68
+exp114_250730_YY_HEK_DFMO_Put_MMW_6-2_76
+exp114_250730_YY_HEK_DFMO_Put_MMW_6-3_85
+exp114_250730_YY_HEK_DFMO_Put_MMW_7-1_69
+exp114_250730_YY_HEK_DFMO_Put_MMW_7-2_77
+exp114_250730_YY_HEK_DFMO_Put_MMW_7-3_86
+exp114_250730_YY_HEK_DFMO_Put_MMW_8-1_70
+exp114_250730_YY_HEK_DFMO_Put_MMW_8-2_78
+exp114_250730_YY_HEK_DFMO_Put_MMW_8-3_87
+exp114_250730_YY_HEK_DFMO_Put_MMW_9-1_71
+exp114_250730_YY_HEK_DFMO_Put_MMW_9-2_79
+exp114_250730_YY_HEK_DFMO_Put_MMW_9-3_88
+exp114_250730_YY_HEK_DFMO_Put_MMW_DigestControl_62
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-1_06
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-1_250ng_03
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-1_500ng_04
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-1_92
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-2_101
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-2_15
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-3_110
+exp114_250730_YY_HEK_DFMO_Put_tRNA_1-3_24
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-1_07
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-1_93
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-2_102
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-2_16
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-3_111
+exp114_250730_YY_HEK_DFMO_Put_tRNA_2-3_25
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-1_08
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-1_94
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-2_103
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-2_17
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-3_112
+exp114_250730_YY_HEK_DFMO_Put_tRNA_3-3_26
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-1_09
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-1_95
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-2_104
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-2_18
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-3_113
+exp114_250730_YY_HEK_DFMO_Put_tRNA_4-3_27
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-1_10
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-1_96
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-2_105
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-2_19
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-3_114
+exp114_250730_YY_HEK_DFMO_Put_tRNA_5-3_28
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-1_11
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-1_97
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-2_106
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-2_20
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-3_115
+exp114_250730_YY_HEK_DFMO_Put_tRNA_6-3_29
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-1_12
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-1_98
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-2_107
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-2_21
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-3_116
+exp114_250730_YY_HEK_DFMO_Put_tRNA_7-3_30
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-1_13
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-1_99
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-2_108
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-2_22
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-3_117
+exp114_250730_YY_HEK_DFMO_Put_tRNA_8-3_31
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-1_100
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-1_14
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-2_109
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-2_23
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-3_118
+exp114_250730_YY_HEK_DFMO_Put_tRNA_9-3_32
+exp114_250730_YY_HEK_DFMO_Put_tRNA_DigControl_02

package/src/__tests__/fixtures/auto-group/share-exp214.txt

@@ -0,0 +1,63 @@
+exp214_251220_SK_RNA_blank_002
+exp214_251220_SK_RNA_blank_002_B
+exp214_251220_SK_RNA_blank_015
+exp214_251220_SK_RNA_blank_029
+exp214_251220_SK_RNA_blank_043
+exp214_251220_SK_RNA_blank_057
+exp214_251220_SK_RNA_NB1_AML_D6_C1_019
+exp214_251220_SK_RNA_NB1_AML_D6_C2_061
+exp214_251220_SK_RNA_NB1_AML_D6_C3_014
+exp214_251220_SK_RNA_NB1_AML_D6_H1_034
+exp214_251220_SK_RNA_NB1_AML_D6_H2_056
+exp214_251220_SK_RNA_NB1_AML_D6_H3_038
+exp214_251220_SK_RNA_NB1_AML_D6_L1_036
+exp214_251220_SK_RNA_NB1_AML_D6_L2_005
+exp214_251220_SK_RNA_NB1_AML_D6_L3_050
+exp214_251220_SK_RNA_NB1_D1_A1_053
+exp214_251220_SK_RNA_NB1_D1_A2_052
+exp214_251220_SK_RNA_NB1_D1_A3_054
+exp214_251220_SK_RNA_NB1_D1_AS1_011
+exp214_251220_SK_RNA_NB1_D1_AS2_007
+exp214_251220_SK_RNA_NB1_D1_AS3_033
+exp214_251220_SK_RNA_NB1_D1_C1_030
+exp214_251220_SK_RNA_NB1_D1_C2_055
+exp214_251220_SK_RNA_NB1_D1_C3_031
+exp214_251220_SK_RNA_NB1_D1_S1_003
+exp214_251220_SK_RNA_NB1_D1_S2_044
+exp214_251220_SK_RNA_NB1_D1_S3_035
+exp214_251220_SK_RNA_NB1_D3_A1_021
+exp214_251220_SK_RNA_NB1_D3_A2_028
+exp214_251220_SK_RNA_NB1_D3_A3_013
+exp214_251220_SK_RNA_NB1_D3_AS1_027
+exp214_251220_SK_RNA_NB1_D3_AS2_049
+exp214_251220_SK_RNA_NB1_D3_AS3_025
+exp214_251220_SK_RNA_NB1_D3_C1_045
+exp214_251220_SK_RNA_NB1_D3_C2_023
+exp214_251220_SK_RNA_NB1_D3_C3_059
+exp214_251220_SK_RNA_NB1_D3_S1_032
+exp214_251220_SK_RNA_NB1_D3_S2_008
+exp214_251220_SK_RNA_NB1_D3_S3_016
+exp214_251220_SK_RNA_NB1_D6_A1_037
+exp214_251220_SK_RNA_NB1_D6_A2_017
+exp214_251220_SK_RNA_NB1_D6_A3_012
+exp214_251220_SK_RNA_NB1_D6_AS1_024
+exp214_251220_SK_RNA_NB1_D6_AS2_060
+exp214_251220_SK_RNA_NB1_D6_AS3_048
+exp214_251220_SK_RNA_NB1_D6_AzaC1_004
+exp214_251220_SK_RNA_NB1_D6_AzaC2_010
+exp214_251220_SK_RNA_NB1_D6_AzaC3_051
+exp214_251220_SK_RNA_NB1_D6_C1_039
+exp214_251220_SK_RNA_NB1_D6_C2_022
+exp214_251220_SK_RNA_NB1_D6_C3_046
+exp214_251220_SK_RNA_NB1_D6_Ona1_058
+exp214_251220_SK_RNA_NB1_D6_Ona2_020
+exp214_251220_SK_RNA_NB1_D6_Ona3_042
+exp214_251220_SK_RNA_NB1_D6_S1_041
+exp214_251220_SK_RNA_NB1_D6_S2_026
+exp214_251220_SK_RNA_NB1_D6_S3_006
+exp214_251220_SK_RNA_NB1_D6_STC1_018
+exp214_251220_SK_RNA_NB1_D6_STC2_009
+exp214_251220_SK_RNA_NB1_D6_STC3_040
+exp214_251220_SK_RNA_NB1_DigControl_047
+exp214_251220_SK_RNA_NucleosideMix_10nM_001
+exp214_251220_SK_RNA_NucleosideMix_10nM_062

package/src/__tests__/utils/permissions.test.ts

@@ -39,6 +39,21 @@ describe('permission helpers', () => {
     expect(canAccessPlugin(member, 'reports')).toBe(false)
   })
 
+  it.each(['none', '', {}, { dose: true }, 42])(
+    'should deny every plugin when plugin_access is malformed (%j)',
+    (access) => {
+      const user = { role: 'member', role_obj: { slug: 'member', plugin_access: access as never } }
+
+      expect(canAccessPlugin(user, 'dose')).toBe(false)
+    },
+  )
+
+  it('should allow every plugin when the user is an administrator', () => {
+    const admin = { role: 'admin', role_obj: { slug: 'admin', plugin_access: ['dose'] } }
+
+    expect(canAccessPlugin(admin, 'reports')).toBe(true)
+  })
+
   it('allows notice publishers to enter the admin panel', () => {
     const publisher = {
       role: 'notice-publisher',

package/src/components/AutoGroupModal.adapter.ts

@@ -4,17 +4,85 @@
  * `AutoGroupResult`. Framework-free so the mapping is unit-testable in isolation
  * from `AutoGroupModal.vue`.
  */
-import type { AutoGroupResult, ClassSchema, ColumnInfo, ColumnRole } from '../types/auto-group'
+import type { AutoGroupResult, ClassSchema, ColumnInfo, ColumnRole, SampleClass } from '../types/auto-group'
 import type { SampleGroup } from '../types'
 import type { FieldRecipeGroup, QcRoute, SmartGroupField } from './SmartGroupFieldRecipe.groups'
 import type { ManualSample } from './SmartGroupManual.cohorts'
-import type { SmartGroupSeed } from './SmartGroup.types'
+import type { FieldRecipeAnatomyToken, FieldRecipeQcChip, SmartGroupSeed } from './SmartGroup.types'
+import { GROUPING_FIELD_ROLES, classKey, isExperimentalKind } from '../composables/autoGroup'
+import type { ExperimentHeader } from '../composables/autoGroup'
+
+const PREVIEW_VALUES = 3
+
+/** Value preview of a field card: the first three values, then the count of the rest. */
+export function previewValues(values: string[]): string {
+  const shown = values.slice(0, PREVIEW_VALUES).join(', ')
+  return values.length > PREVIEW_VALUES ? `${shown} … +${values.length - PREVIEW_VALUES}` : shown
+}
+
+/** Experiment line of the modal header: `exp157 · 2025-10-13 · LT`. */
+export function experimentLabel(header: ExperimentHeader): string {
+  return [header.code, header.date, header.operator].filter(Boolean).join(' · ')
+}
+
+/**
+ * Names of all columns of the experimental classes. A field cannot take one
+ * of them: the engine merges fields by name.
+ */
+export function engineColumnNames(schemas: Record<string, ClassSchema>): string[] {
+  const names = Object.values(schemas)
+    .filter(schema => isExperimentalKind(schema.classKind))
+    .flatMap(schema => schema.columns.map(column => column.displayName ?? column.name))
+  return [...new Set(names)]
+}
+
+/** One chip for each QC-type class, with its sample count. */
+export function engineQcChips(classes: SampleClass[]): FieldRecipeQcChip[] {
+  return classes
+    .filter(c => !isExperimentalKind(c.kind))
+    .map(c => ({ name: c.label, count: c.members.length }))
+}
+
+/**
+ * The tokens of one study sample with the role the engine gave each of them,
+ * so the user sees how the names were read. The sample is the first member of
+ * the largest experimental class. `cards` supplies the on/off state and the
+ * layer of the tokens that are grouping fields.
+ */
+export function engineAnatomy(
+  classes: SampleClass[],
+  schemas: Record<string, ClassSchema>,
+  tokenized: string[][],
+  cards: { fields: SmartGroupField[]; layers: (number | null)[] },
+): FieldRecipeAnatomyToken[] {
+  const cls = classes
+    .filter(c => isExperimentalKind(c.kind) && schemas[classKey(c)])
+    .sort((a, b) => b.members.length - a.members.length)[0]
+  if (!cls) return []
+  const tokens = tokenized[cls.members[0]] ?? []
+  return schemas[classKey(cls)].columns.flatMap((column): FieldRecipeAnatomyToken[] => {
+    const text = column.sourceIndices.map(index => tokens[index] ?? '').join('_')
+    if (!text) return []
+    const name = column.displayName ?? column.name
+    const card = cards.fields.findIndex(field => field.key === name)
+    if (card === -1) {
+      // A token that is not a field shows an inferred name only when the
+      // name says something (Date, Injection #); `Username` or `Matrix 2` on a
+      // constant token does not.
+      const caption = /^(Field \d+|Username.*|.* \d+)$/.test(name) ? roleLabel(column.role).toLowerCase() : name
+      return [{ text, caption, state: 'fixed' }]
+    }
+    const layer = cards.layers[card]
+    return [layer === null ? { text, caption: name, state: 'off' } : { text, caption: String(layer), state: 'on' }]
+  })
+}
 
 const ROLE_LABELS: Record<ColumnRole, string> = {
   'constant': 'Constant',
   'factor': 'Factor',
   'replicate': 'Replicate',
   'run-order': 'Run',
+  'id': 'Sample ID',
   'numeric': 'Numeric',
   'class-tag': 'Class tag',
   'ignore': 'Ignore',
@@ -26,14 +94,15 @@ export function roleLabel(role?: ColumnRole): string {
 }
 
 /**
- * Columns worth offering as grouping toggles: factors and replicates, plus any
- * column already enabled in `groupBy` (so a manual group-by choice still shows).
+ * Columns worth offering as grouping toggles: factors, numerics, replicates and
+ * sample IDs (the last two are off by default), plus any column already enabled
+ * in `groupBy` (so a manual group-by choice still shows).
  * Preserves the engine's column order. `groupBy` is the schema's ORDERED layer
  * list — entry N is hierarchy layer N of the composed group names.
  */
 export function candidateColumns(columns: ColumnInfo[], groupBy: readonly number[]): ColumnInfo[] {
   const enabled = new Set(groupBy)
-  return columns.filter(c => c.role === 'factor' || c.role === 'replicate' || enabled.has(c.index))
+  return columns.filter(c => GROUPING_FIELD_ROLES.has(c.role) || enabled.has(c.index))
 }
 
 /**
@@ -50,8 +119,8 @@ export function engineFieldsToCards(
     fields: candidates.map(c => ({
       key: c.displayName ?? c.name,
       role: roleLabel(c.role),
-      vals: c.uniqueValues.join(', '),
-      rep: c.role === 'replicate',
+      vals: previewValues(c.uniqueValues),
+      rep: c.role === 'replicate' || c.role === 'id',
     })),
     enabled: candidates.map(c => groupBy.includes(c.index)),
     layers: candidates.map(c => {
@@ -81,6 +150,8 @@ export function engineSchemasToCards(
   const enabled = new Set<string>()
 
   for (const [, schema] of ordered) {
+    // An overlay class (QC, blank, standard) is one group; its columns are not fields.
+    if (!isExperimentalKind(schema.classKind)) continue
     for (const index of schema.groupBy) {
       const column = schema.columns.find(candidate => candidate.index === index)
       if (!column) continue
@@ -101,8 +172,8 @@ export function engineSchemasToCards(
     fields: cards.map(([key, column]) => ({
       key,
       role: roleLabel(column.role),
-      vals: column.uniqueValues.join(', '),
-      rep: column.role === 'replicate',
+      vals: previewValues(column.uniqueValues),
+      rep: column.role === 'replicate' || column.role === 'id',
     })),
     enabled: cards.map(([key]) => enabled.has(key)),
     layers: cards.map(([key]) => {

package/src/components/AutoGroupModal.vue

@@ -17,15 +17,19 @@ import { useAutoGroup, parseCSV } from '../composables/useAutoGroup'
 import { useApi } from '../composables/useApi'
 import { readFileAsText } from '../composables/useFileImport'
 import {
+  engineAnatomy,
+  engineColumnNames,
   engineGroupsToRail,
+  engineQcChips,
   engineSchemasToCards,
   engineToQcRoute,
+  experimentLabel,
   manualSamplesToResult,
   qcRouteToEngine,
   seedFromGroups,
 } from './AutoGroupModal.adapter'
 import { SAMPLE_GROUP_COLOR_OPTIONS } from './SampleSelector.colors'
-import type { QcRoute } from './SmartGroupFieldRecipe.groups'
+import { mostlySingletons, type QcRoute } from './SmartGroupFieldRecipe.groups'
 import type { ManualSample } from './SmartGroupManual.cohorts'
 import type { ManualPaletteEntry } from './SmartGroup.types'
 import type { AutoGroupResult } from '../types/auto-group'
@@ -95,13 +99,32 @@ const qcSampleCount = computed(() =>
     .filter(c => c.kind !== 'biological' && c.kind !== 'unknown')
     .reduce((acc, c) => acc + c.members.length, 0),
 )
-const qcChip = computed(() =>
-  qcRouting.value !== 'mix' && qcSampleCount.value > 0
-    ? { name: 'QC_Pool', count: qcSampleCount.value }
-    : null,
-)
+const qcChips = computed(() => (qcRouting.value === 'mix' ? [] : engineQcChips(autoGroup.classes.value)))
 const fieldRecipeRoute = computed<QcRoute>(() => engineToQcRoute(qcRouting.value))
 const headerCount = computed(() => autoGroup.samples.value.length)
+const headerLabel = computed(() => experimentLabel(autoGroup.experiment.value))
+const reservedNames = computed(() => engineColumnNames(autoGroup.schemas.value))
+// The example name is shown for pasted names only: CSV and experiment input
+// have columns, not name tokens.
+const anatomy = computed(() =>
+  autoGroup.inputMode.value === 'paste'
+    ? engineAnatomy(autoGroup.classes.value, autoGroup.schemas.value, autoGroup.tokenized.value, fieldCards.value)
+    : [],
+)
+// A design with no replicate in the names gives groups of one sample. Each
+// field that is on then shows how many groups remain when the user switches
+// it off, so the user can find the field that is not part of the condition.
+// The rule is the one of the summary callout, so the two show together.
+const fieldHints = computed(() => {
+  const needsHelp = mostlySingletons(railGroups.value)
+  // ponytail: one full composeGroups for each field that is on (a few ms for
+  // 200 samples). Count distinct group keys instead if a large batch is slow.
+  return fieldCards.value.fields.map((field, index) => {
+    if (!needsHelp || !fieldCards.value.enabled[index]) return null
+    const remaining = autoGroup.groupCountWithout(field.key)
+    return `off → ${remaining} ${remaining === 1 ? 'group' : 'groups'}`
+  })
+})
 
 // The cards describe the batch, not one class, so edits fan out to every class
 // exposing the field — otherwise a multi-class batch (e.g. a Liver class and a
@@ -116,6 +139,11 @@ function onMoveField(cardIndex: number, direction: 'up' | 'down') {
   if (!field) return
   autoGroup.moveGroupByField(field.key, direction)
 }
+function onRenameField(cardIndex: number, name: string) {
+  const field = fieldCards.value.fields[cardIndex]
+  if (!field) return
+  autoGroup.renameGroupByField(field.key, name)
+}
 function onRouteChange(route: QcRoute) {
   setQcRouting(qcRouteToEngine(route))
 }
@@ -257,15 +285,20 @@ watch(
       :enabled="fieldCards.enabled"
       :layers="fieldCards.layers"
       :groups="railGroups"
-      :qc-chip="qcChip"
+      :qc-chips="qcChips"
       :route="fieldRecipeRoute"
       :header-count="headerCount"
       :qc-count="qcSampleCount"
       :can-download-template="autoGroup.canDownloadTemplate.value"
       :loading="experimentLoading"
-      experiment-label=""
+      :experiment-label="headerLabel"
+      :anatomy="anatomy"
+      :hints="fieldHints"
+      :reserved-names="reservedNames"
+      renamable
       @toggle="onToggleField"
       @move="onMoveField"
+      @rename="onRenameField"
       @update:route="onRouteChange"
       @csv-file="onCsvFile"
       @download-template="onDownloadTemplate"

package/src/components/PlateEditor.vue

@@ -92,6 +92,8 @@ interface Props {
   /** No editing controls; well clicks still emit `well-click`. */
   readonly?: boolean
   size?: WellPlateSize
+  /** Footer text while nothing is selected; replaces the built-in selection hint. */
+  hint?: string
 }
 
 const props = withDefaults(defineProps<Props>(), {
@@ -446,6 +448,7 @@ function assign(groupId: string | undefined) {
 
 const hint = computed(() => {
   if (dragMode.value) return 'Drag a filled well onto another to move or swap it.'
+  if (props.hint) return props.hint
   if (!props.groups) return ''
   if (railOn.value) {
     return inspectorOn.value

package/src/components/SmartGroup.types.ts

@@ -35,6 +35,16 @@ export interface FieldRecipeQcChip {
   count: number
 }
 
+/** One token of the example sample name, with the role it was read as. */
+export interface FieldRecipeAnatomyToken {
+  /** The token as written in the sample name. */
+  text: string
+  /** The layer number for a grouped field; the field name or role for any other token. */
+  caption: string
+  /** `on`: a grouped field. `off`: a field that is switched off. `fixed`: not a grouping field. */
+  state: 'on' | 'off' | 'fixed'
+}
+
 export interface SmartGroupFieldRecipeProps {
   /** Sample records behind the experiment (one row per real sample). */
   samples?: SmartGroupSampleRecord[]
@@ -75,6 +85,19 @@ export interface SmartGroupFieldRecipeProps {
   canDownloadTemplate?: boolean
   /** Show a loading state in the main body (e.g. while experiment data loads). */
   loading?: boolean
+  /** Tokens of one example sample name; shown above the fields when not empty. */
+  anatomy?: FieldRecipeAnatomyToken[]
+  /**
+   * Per-card hint for a field that is on, for example the groups that remain
+   * when the user switches it off. `null` shows no hint for that card.
+   */
+  hints?: (string | null)[]
+  /** One chip for each QC class; when set it replaces the single `qcChip`. */
+  qcChips?: FieldRecipeQcChip[]
+  /** Show the rename control on each field; a new name emits `rename`. */
+  renamable?: boolean
+  /** Names that a rename must refuse, in addition to the names of the other fields. */
+  reservedNames?: string[]
 }
 
 export interface FieldRecipeApplyPayload {

package/src/components/SmartGroupFieldRecipe.groups.ts

@@ -34,8 +34,11 @@ export const QC_POOL_NAME = 'QC_Pool'
 /** How QC samples are routed relative to the biological groups. */
 export type QcRoute = 'Overlay only' | 'Exclude' | 'Mix into groups'
 
-/** Kind of inline summary callout to render. */
-export type FieldRecipeSummaryKind = 'mute' | 'warn' | 'info'
+/**
+ * Kind of inline summary callout to render. `warn`: a replicate field is on.
+ * `singletons`: no replicate field is on, but half or more of the groups have one sample.
+ */
+export type FieldRecipeSummaryKind = 'mute' | 'warn' | 'singletons' | 'info'
 
 export interface FieldRecipeSummary {
   kind: FieldRecipeSummaryKind
@@ -99,6 +102,14 @@ export function sampleTotalFor(route: QcRoute, realCount = 9, qcCount = 3): numb
   return route === 'Exclude' ? realCount : realCount + qcCount
 }
 
+/**
+ * True when half or more of the groups have one sample: the design has no
+ * replicate in the names, or a field that is on is not part of the condition.
+ */
+export function mostlySingletons(groups: FieldRecipeGroup[]): boolean {
+  return groups.length > 1 && groups.filter(group => group.count === 1).length * 2 >= groups.length
+}
+
 /** Decide which inline summary callout the Field Recipe should show. */
 export function fieldRecipeSummary(input: {
   activeFactors: string[]
@@ -108,5 +119,6 @@ export function fieldRecipeSummary(input: {
   const groupCount = input.baseGroups.length
   if (input.activeFactors.length === 0) return { kind: 'mute', groupCount }
   if (input.repOn) return { kind: 'warn', groupCount }
+  if (mostlySingletons(input.baseGroups)) return { kind: 'singletons', groupCount }
   return { kind: 'info', groupCount }
 }