@morscherlab/mint-sdk 1.3.0-beta.9 → 1.3.1

package/dist/__tests__/components/AutoGroupModal.anatomy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/components/AutoGroupModal.wiring.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/composables/autoGroup/fieldEdits.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/composables/autoGroup/golden.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/AutoGroupModal.adapter.d.ts

@@ -1,13 +1,36 @@
-import { AutoGroupResult, ClassSchema, ColumnInfo, ColumnRole } from '../types/auto-group';
+import { AutoGroupResult, ClassSchema, ColumnInfo, ColumnRole, SampleClass } from '../types/auto-group';
 import { SampleGroup } from '../types';
 import { FieldRecipeGroup, QcRoute, SmartGroupField } from './SmartGroupFieldRecipe.groups';
 import { ManualSample } from './SmartGroupManual.cohorts';
-import { SmartGroupSeed } from './SmartGroup.types';
+import { FieldRecipeAnatomyToken, FieldRecipeQcChip, SmartGroupSeed } from './SmartGroup.types';
+import { ExperimentHeader } from '../composables/autoGroup';
+/** Value preview of a field card: the first three values, then the count of the rest. */
+export declare function previewValues(values: string[]): string;
+/** Experiment line of the modal header: `exp157 · 2025-10-13 · LT`. */
+export declare function experimentLabel(header: ExperimentHeader): string;
+/**
+ * Names of all columns of the experimental classes. A field cannot take one
+ * of them: the engine merges fields by name.
+ */
+export declare function engineColumnNames(schemas: Record<string, ClassSchema>): string[];
+/** One chip for each QC-type class, with its sample count. */
+export declare function engineQcChips(classes: SampleClass[]): FieldRecipeQcChip[];
+/**
+ * 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 declare function engineAnatomy(classes: SampleClass[], schemas: Record<string, ClassSchema>, tokenized: string[][], cards: {
+    fields: SmartGroupField[];
+    layers: (number | null)[];
+}): FieldRecipeAnatomyToken[];
 /** Human label for a column role; defaults to `Factor` when unset. */
 export declare 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.
  */

package/dist/components/SmartGroup.types.d.ts

@@ -20,6 +20,15 @@ export interface FieldRecipeQcChip {
     name: string;
     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[];
@@ -56,6 +65,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 {
     groups: FieldRecipeGroup[];

package/dist/components/SmartGroupFieldRecipe.groups.d.ts

@@ -28,8 +28,11 @@ export interface FieldRecipeGroup {
 export declare 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;
     /** Number of base (non-QC) groups the current toggles produce. */
@@ -48,6 +51,11 @@ export declare function computeFieldGroups(samples: SmartGroupSampleRecord[], fi
 export declare function appendQcGroup(groups: FieldRecipeGroup[], route: QcRoute, qcColor: string, qcCount?: number): FieldRecipeGroup[];
 /** Total samples the grouping applies to: QC is dropped only when excluded. */
 export declare function sampleTotalFor(route: QcRoute, realCount?: number, qcCount?: number): number;
+/**
+ * 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 declare function mostlySingletons(groups: FieldRecipeGroup[]): boolean;
 /** Decide which inline summary callout the Field Recipe should show. */
 export declare function fieldRecipeSummary(input: {
     activeFactors: string[];

package/dist/components/SmartGroupFieldRecipe.vue.d.ts

@@ -9,6 +9,7 @@ declare const __VLS_export: import('vue').DefineComponent<SmartGroupFieldRecipeP
     move: (index: number, direction: "up" | "down") => any;
     apply: (payload: FieldRecipeApplyPayload) => any;
     manual: () => any;
+    rename: (index: number, name: string) => any;
     "update:route": (route: QcRoute) => any;
     "csv-file": (file: File) => any;
     "download-template": () => any;
@@ -20,6 +21,7 @@ declare const __VLS_export: import('vue').DefineComponent<SmartGroupFieldRecipeP
     onMove?: ((index: number, direction: "up" | "down") => any) | undefined;
     onApply?: ((payload: FieldRecipeApplyPayload) => any) | undefined;
     onManual?: (() => any) | undefined;
+    onRename?: ((index: number, name: string) => any) | undefined;
     "onUpdate:route"?: ((route: QcRoute) => any) | undefined;
     "onCsv-file"?: ((file: File) => any) | undefined;
     "onDownload-template"?: (() => any) | undefined;
@@ -34,4 +36,5 @@ declare const __VLS_export: import('vue').DefineComponent<SmartGroupFieldRecipeP
     initialRoute: QcRoute;
     qcColor: string;
     canDownloadTemplate: boolean;
+    renamable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/index.js

@@ -1,4 +1,4 @@
-import { $ as PlateEditor_default, A as SampleLegend_default, At as AppToastContainer_default, B as StatusIndicator_default, C as ChemicalFormula_default, Ct as AppAvatarMenu_default, D as ReagentEditor_default, Dt as ActionMenu_default, E as SampleHierarchyTree_default, Et as ThemeToggle_default, F as SettingsModal_default, Ft as Calendar_default, G as ControlWorkspaceView_default, H as LayoutResizeHandle_default, I as AdductText_default, It as BasePill_default, J as SampleSelector_default, K as ComponentBindingRenderer_default, L as Breadcrumb_default, Lt as SegmentedControl_default, M as BioTemplatePackWorkspaceView_default, Mt as FormField_default, N as BioTemplateExperimentWorkspaceView_default, Nt as DataFrame_default, O as SmartGroupModal_default, Ot as IconButton_default, P as BioTemplateRenderer_default, Pt as LoadingSpinner_default, Q as ReagentList_default, R as Avatar_default, Rt as BaseTabs_default, St as AppTopBar_default, T as ProtocolStepEditor_default, Tt as CollapsibleCard_default, U as AppContainer_default, V as Divider_default, W as DoseDesignWorkspaceView_default, X as SmartGroupManual_default, Y as AutoGroupModal_default, Z as SmartGroupFieldRecipe_default, _t as AppLayout_default, a as ArtifactSaveDialog_default, at as GeneratedPluginView_default, bt as FormActions_default, c as SectionCard_default, ct as GeneratedPlotlyResult_default, d as ExperimentCodeBadge_default, dt as ChartContainer_default, et as ConfirmDialog_default, f as ExperimentDataViewer_default, g as SequenceProgressBar_default, gt as MobileSupportGate_default, h as InstrumentStateBadge_default, ht as PluginWorkspaceView_default, i as ExperimentPopover_default, it as DoseCalculator_default, j as BioTemplatePresetWorkspaceView_default, jt as AlertBox_default, k as GroupAssigner_default, kt as RuntimeUpdateNotice_default, l as ResourceCard_default, lt as PlotlyChart_default, m as AuditTrail_default, n as FilePicker_default, o as ArtifactSelectorModal_default, ot as JobsStatusTray_default, p as BatchProgressList_default, q as ScheduleCalendar_default, r as FitPanel_default, rt as ExperimentTimeline_default, s as ExperimentSelectorModal_default, st as GeneratedResultRenderer_default, tt as WellPlate_default, u as TimeRangeInput_default, vt as AppSidebar_default, w as ScientificNumber_default, wt as PluginIcon_default, xt as StepWizard_default, yt as FormBuilder_default, z as ProgressBar_default, zt as SearchableSelect_default } from "../components-GDDvof8D.js";
+import { $ as PlateEditor_default, A as SampleLegend_default, At as AppToastContainer_default, B as StatusIndicator_default, C as ChemicalFormula_default, Ct as AppAvatarMenu_default, D as ReagentEditor_default, Dt as ActionMenu_default, E as SampleHierarchyTree_default, Et as ThemeToggle_default, F as SettingsModal_default, Ft as Calendar_default, G as ControlWorkspaceView_default, H as LayoutResizeHandle_default, I as AdductText_default, It as BasePill_default, J as SampleSelector_default, K as ComponentBindingRenderer_default, L as Breadcrumb_default, Lt as SegmentedControl_default, M as BioTemplatePackWorkspaceView_default, Mt as FormField_default, N as BioTemplateExperimentWorkspaceView_default, Nt as DataFrame_default, O as SmartGroupModal_default, Ot as IconButton_default, P as BioTemplateRenderer_default, Pt as LoadingSpinner_default, Q as ReagentList_default, R as Avatar_default, Rt as BaseTabs_default, St as AppTopBar_default, T as ProtocolStepEditor_default, Tt as CollapsibleCard_default, U as AppContainer_default, V as Divider_default, W as DoseDesignWorkspaceView_default, X as SmartGroupManual_default, Y as AutoGroupModal_default, Z as SmartGroupFieldRecipe_default, _t as AppLayout_default, a as ArtifactSaveDialog_default, at as GeneratedPluginView_default, bt as FormActions_default, c as SectionCard_default, ct as GeneratedPlotlyResult_default, d as ExperimentCodeBadge_default, dt as ChartContainer_default, et as ConfirmDialog_default, f as ExperimentDataViewer_default, g as SequenceProgressBar_default, gt as MobileSupportGate_default, h as InstrumentStateBadge_default, ht as PluginWorkspaceView_default, i as ExperimentPopover_default, it as DoseCalculator_default, j as BioTemplatePresetWorkspaceView_default, jt as AlertBox_default, k as GroupAssigner_default, kt as RuntimeUpdateNotice_default, l as ResourceCard_default, lt as PlotlyChart_default, m as AuditTrail_default, n as FilePicker_default, o as ArtifactSelectorModal_default, ot as JobsStatusTray_default, p as BatchProgressList_default, q as ScheduleCalendar_default, r as FitPanel_default, rt as ExperimentTimeline_default, s as ExperimentSelectorModal_default, st as GeneratedResultRenderer_default, tt as WellPlate_default, u as TimeRangeInput_default, vt as AppSidebar_default, w as ScientificNumber_default, wt as PluginIcon_default, xt as StepWizard_default, yt as FormBuilder_default, z as ProgressBar_default, zt as SearchableSelect_default } from "../components-bbanLd1u.js";
 import { f as BaseModal_default, h as BaseButton_default } from "../experiment-utils-DTANyVKV.js";
 import { i as BaseSelect_default, n as Skeleton_default, o as BaseInput_default, r as EmptyState_default } from "../ResourcePickerListInternal-CFAw4vTZ.js";
 import { $n as FormulaInput_default, Cr as FileUploader_default, Jn as UnitInput_default, Rr as TagsInput_default, Tr as SecretInput_default, Xn as MoleculeInput_default, Zn as SequenceInput_default, ci as BaseRadioGroup_default, di as Tooltip_default, fi as BaseTextarea_default, ii as MultiSelect_default, li as BaseToggle_default, ni as DatePicker_default, nr as GeneratedPathInput_default, qn as ConcentrationInput_default, si as BaseSlider_default, ui as BaseCheckbox_default, wr as NumberInput_default, yr as DateTimePicker_default, zr as TimePicker_default } from "../templates-BU1pet28.js";