@morscherlab/mint-sdk 1.3.0-beta.1 → 1.3.0-beta.10

package/src/components/SettingsModal.vue

@@ -90,6 +90,8 @@ interface Props {
   /** Manual tab descriptors. Ignored when `schema` is set (groups become tabs). */
   tabs?: SettingsTabInput[]
   showAppearance?: boolean
+  /** List Appearance before the other tabs and open on it. */
+  appearanceFirst?: boolean
   size?: 'md' | 'lg' | 'xl'
   layout?: SettingsModalLayout
   /** Declarative schema — fields auto-render via SDK form components. */
@@ -238,7 +240,7 @@ const allTabs = computed<SettingsTab[]>(() => {
   const base: SettingsTab[] = settingsSchema.value
     ? visibleSchemaGroups.value.map(settingsGroupToTab)
     : manualTabs.value
-  return buildSettingsTabs(base, props.showAppearance)
+  return buildSettingsTabs(base, props.showAppearance, props.appearanceFirst)
 })
 
 const activeTab = ref(allTabs.value[0]?.id || APPEARANCE_TAB_ID)
@@ -272,7 +274,7 @@ const modalTabs = computed<ModalTab[]>(() =>
       description: tab.description,
       meta: group ? (modified ? String(modified) : undefined) : tab.meta,
       // Sections only split plugin groups from Appearance; without it there is nothing to split.
-      section: props.showAppearance ? (tab.id === APPEARANCE_TAB_ID ? 'Personal' : 'Plugin') : undefined,
+      section: props.showAppearance ? (tab.id === APPEARANCE_TAB_ID ? 'Personal' : tab.section ?? 'Plugin') : undefined,
     }
   }),
 )

package/src/components/WellPlate.colors.ts

@@ -1,16 +1,12 @@
 import type { HeatmapConfig } from '../types'
 
-/**
- * Group color for the built-in sample types when `sampleColors` has no entry.
- * Color encodes the group and shape encodes the type (3a): blank and QC render
- * neutral markers and ignore it; iQC takes it like a sample.
- */
+/** Color for the built-in sample types when `sampleColors` has no entry. */
 export const DEFAULT_SAMPLE_TYPE_COLORS: Record<string, string> = {
-  sample: 'var(--mint-sample-1)',
-  control: 'var(--mint-sample-2)',
-  blank: 'var(--mint-sample-1)',
-  qc: 'var(--mint-sample-1)',
-  iqc: 'var(--mint-sample-1)',
+  sample: '#10b981',
+  control: '#3b82f6',
+  blank: '#f97316',
+  qc: '#8b5cf6',
+  iqc: '#ec4899',
 }
 
 export const HEATMAP_COLORS: Record<string, string[]> = {

package/src/components/WellPlate.legend.ts

@@ -1,8 +1,8 @@
 import type { WellLegendItem } from '../types'
 
 export const DEFAULT_WELL_LEGEND_ITEMS: WellLegendItem[] = [
-  { type: 'sample', label: 'Sample', color: 'var(--mint-sample-1)' },
-  { type: 'blank', label: 'Blank', color: 'var(--mint-sample-1)' },
-  { type: 'qc', label: 'QC', color: 'var(--mint-sample-1)' },
-  { type: 'iqc', label: 'IQC', color: 'var(--mint-sample-1)' },
+  { type: 'sample', label: 'Sample', color: '#10b981' },
+  { type: 'blank', label: 'Blank', color: '#f97316' },
+  { type: 'qc', label: 'QC', color: '#8b5cf6' },
+  { type: 'iqc', label: 'IQC', color: '#ec4899' },
 ]

package/src/components/WellPlate.rendering.ts

@@ -1,5 +1,4 @@
 import type { HeatmapConfig, Well, WellPlateSelectionMode, WellShape } from '../types'
-import { sampleTypeMarker } from '../utils/sampleTypeMarker'
 import {
   DEFAULT_SAMPLE_TYPE_COLORS,
   getHeatmapColor,
@@ -55,13 +54,15 @@ export function wellStyle(well: Well, state: WellStyleState): Record<string, str
       ?? state.sampleColors[well.sampleType] ?? DEFAULT_SAMPLE_TYPE_COLORS[well.sampleType])
   if (!groupColor) return {} // empty / filled wells are styled by well-plate.css
 
-  const { background, border } = sampleTypeMarker(well.sampleType!, groupColor).style
-  return { backgroundColor: background, border }
+  return sampleTint(groupColor)
 }
 
-/** In-well glyph of the 3a sample-type marker: `Q` for QC, `i` for iQC. */
-export function sampleTypeGlyph(well: Well): string | null {
-  return well.sampleType ? sampleTypeMarker(well.sampleType, '').glyph : null
+/** 15% fill and 40% outline of a sample color; color-mix accepts hex and `var()` tokens alike. */
+export function sampleTint(color: string): { backgroundColor: string; border: string } {
+  return {
+    backgroundColor: `color-mix(in srgb, ${color} 15%, transparent)`,
+    border: `1px solid color-mix(in srgb, ${color} 40%, transparent)`,
+  }
 }
 
 let sampleTypeIndicatorWarned = false
@@ -89,10 +90,10 @@ export function wellBadge(
   if (!showBadges || !well.metadata) return null
   const count = well.metadata.injectionCount as number | undefined
   if (count && count > 1) {
-    return { text: String(count), color: 'var(--text-primary)' }
+    return { text: String(count), color: '#6366f1' }
   }
   if (well.metadata.customMethod) {
-    return { text: '', color: 'var(--color-purple)' } // custom method: a dot, no glyph
+    return { text: '+', color: '#ec4899' }
   }
   return null
 }

package/src/components/WellPlate.vue

@@ -25,7 +25,7 @@ import {
 } from './WellPlate.geometry'
 import { useWellPlateInteraction } from './WellPlate.interaction'
 import {
-  sampleTypeGlyph,
+  sampleTint,
   warnSampleTypeIndicatorDeprecated,
   wellBadge,
   wellClasses,
@@ -34,7 +34,6 @@ import {
 } from './WellPlate.rendering'
 import { DEFAULT_WELL_LEGEND_ITEMS } from './WellPlate.legend'
 import DataStateInternal from './internal/DataStateInternal.vue'
-import { sampleTypeMarker } from '../utils/sampleTypeMarker'
 
 interface Props {
   modelValue?: string[]
@@ -476,27 +475,13 @@ const tableStyle = computed(() => ({
                 >
                   {{ well.id }}
                 </span>
-                <!-- Sample-type marker glyph (Q / i) -->
-                <span
-                  v-else-if="sampleTypeGlyph(well)"
-                  class="mint-well-plate__indicator"
-                >
-                  {{ sampleTypeGlyph(well) }}
-                </span>
-                <!-- The glyph moves to a corner when a label or well ID takes the centre -->
-                <span
-                  v-if="sampleTypeGlyph(well) && (getWellLabel(well) || props.showWellIds)"
-                  class="mint-well-plate__corner-glyph"
-                >
-                  {{ sampleTypeGlyph(well) }}
-                </span>
 
                 <!-- Badge (injection count or custom method) -->
                 <span
                   v-if="getWellBadge(well)"
-                  :class="['mint-well-plate__badge', { 'mint-well-plate__badge--dot': !getWellBadge(well)?.text }]"
+                  class="mint-well-plate__badge"
                   :style="{ backgroundColor: getWellBadge(well)?.color }"
-                  :title="getWellBadge(well)?.text ? `${getWellBadge(well)?.text}x injections` : 'Custom method'"
+                  :title="getWellBadge(well)?.text === '+' ? 'Custom method' : `${getWellBadge(well)?.text ?? ''}x injections`"
                 >
                   {{ getWellBadge(well)?.text }}
                 </span>
@@ -531,11 +516,9 @@ const tableStyle = computed(() => ({
             class="mint-well-plate__sample-legend-item"
           >
             <span
-              v-for="marker in [sampleTypeMarker(item.type, item.color)]"
-              :key="item.type"
               class="mint-well-plate__sample-legend-dot"
-              :style="marker.style"
-            >{{ marker.glyph }}</span>
+              :style="sampleTint(item.color)"
+            />
             <span class="mint-well-plate__sample-legend-text">{{ item.label }}</span>
           </div>
         </div>

package/src/components/index.ts

@@ -48,7 +48,8 @@ export { default as GeneratedResultRenderer } from './GeneratedResultRenderer.vu
 export { default as GeneratedPlotlyResult } from './GeneratedPlotlyResult.vue'
 export { default as ComponentBindingRenderer } from './ComponentBindingRenderer.vue'
 export { default as ControlWorkspaceView } from './ControlWorkspaceView.vue'
-export { default as DoseDesignWorkspaceView } from './DoseDesignWorkspaceView.vue'
+/** Complete ControlWorkspaceView page shell for WellPlate + DoseCalculator dose design. @deprecated Scheduled for removal in MINT 1.4; use `ControlWorkspaceView` instead, with `defineDoseDesignControlModel()`. */
+export { /** @deprecated Removed in MINT 1.4. */ default as DoseDesignWorkspaceView } from './DoseDesignWorkspaceView.vue'
 export { default as AppContainer } from './AppContainer.vue'
 export { default as PluginIcon } from './PluginIcon.vue'
 export { default as LayoutResizeHandle } from './LayoutResizeHandle.vue'
@@ -69,30 +70,43 @@ export { default as AdductText } from './AdductText.vue'
 export { default as SettingsModal } from './SettingsModal.vue'
 
 // Biological experiment components
-export { default as BioTemplateRenderer } from './BioTemplateRenderer.vue'
-export { default as BioTemplateExperimentWorkspaceView } from './BioTemplateExperimentWorkspaceView.vue'
-export { default as BioTemplatePackWorkspaceView } from './BioTemplatePackWorkspaceView.vue'
-export { default as BioTemplatePresetWorkspaceView } from './BioTemplatePresetWorkspaceView.vue'
+/** Render biology template envelopes with matching SDK components such as WellPlate, DoseCalculator, and DataFrame. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as BioTemplateRenderer } from './BioTemplateRenderer.vue'
+/** Current-experiment template workspace with load/save/reset controls and WellPlate/DataFrame/DoseCalculator previews. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as BioTemplateExperimentWorkspaceView } from './BioTemplateExperimentWorkspaceView.vue'
+/** Complete current-experiment workspace for a curated biology template pack with save/load controls and component-prop slots. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as BioTemplatePackWorkspaceView } from './BioTemplatePackWorkspaceView.vue'
+/** Complete editable biology template preset workspace for WellPlate/DoseCalculator, LC-MS, qPCR, generated controls, preview components, and current-experiment save wiring. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as BioTemplatePresetWorkspaceView } from './BioTemplatePresetWorkspaceView.vue'
 export { default as WellPlate } from './WellPlate.vue'
 export { default as PlateEditor } from './PlateEditor.vue'
-export { default as SampleLegend } from './SampleLegend.vue'
-export { default as ExperimentTimeline } from './ExperimentTimeline.vue'
+/** Clickable color-swatch legend for plate sample types, supporting selection, count display, add/remove, and custom color assignment. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as SampleLegend } from './SampleLegend.vue'
+/** Horizontal or vertical timeline of ordered protocol steps with status indicators, drag-to-reorder, and step-type iconography. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as ExperimentTimeline } from './ExperimentTimeline.vue'
 
 // Sample management components
+/** Interactive sample list with drag-and-drop group assignment, color labeling, and smart-group support. */
 export { default as SampleSelector } from './SampleSelector.vue'
-/** Smart Group modal wired to the `useAutoGroup` engine. @deprecated Scheduled for removal in MINT 1.4; use `SmartGroupModal` instead. */
-export { default as AutoGroupModal } from './AutoGroupModal.vue'
-export { default as GroupAssigner } from './GroupAssigner.vue'
-export { default as SmartGroupModal } from './SmartGroupModal.vue'
-export { default as SmartGroupFieldRecipe } from './SmartGroupFieldRecipe.vue'
-export { default as SmartGroupManual } from './SmartGroupManual.vue'
+/** Smart Group modal wired to the `useAutoGroup` engine. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as AutoGroupModal } from './AutoGroupModal.vue'
+/** Drag-and-drop two-zone assigner for splitting sample groups into control and treatment arms. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as GroupAssigner } from './GroupAssigner.vue'
+/** Smart Group modal with the auto Field Recipe and the manual cohort builder. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as SmartGroupModal } from './SmartGroupModal.vue'
+/** Smart Group auto mode: groups samples by a field recipe. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as SmartGroupFieldRecipe } from './SmartGroupFieldRecipe.vue'
+/** Smart Group manual mode: builds cohorts from selected samples. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as SmartGroupManual } from './SmartGroupManual.vue'
 
 // Lab/Experiment components
 export { default as MoleculeInput } from './MoleculeInput.vue'
 export { default as ConcentrationInput } from './ConcentrationInput.vue'
 export { default as DoseCalculator } from './DoseCalculator.vue'
-export { default as ReagentEditor, type ReagentDefinition } from './ReagentEditor.vue'
-export { default as ReagentList } from './ReagentList.vue'
+/** Editor for a single reagent definition with axis orientation, dilution-series generator, and position-count validation for 96/384-well plates. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as ReagentEditor, type ReagentDefinition } from './ReagentEditor.vue'
+/** Sortable, searchable table of experiment reagents showing lot number, expiry, storage conditions, and stock level with low-stock warnings. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as ReagentList } from './ReagentList.vue'
 export { default as SampleHierarchyTree } from './SampleHierarchyTree.vue'
 export { default as ProtocolStepEditor } from './ProtocolStepEditor.vue'
 
@@ -100,7 +114,7 @@ export { default as ProtocolStepEditor } from './ProtocolStepEditor.vue'
 export { default as PlotlyChart } from './PlotlyChart.vue'
 export { default as ScientificNumber } from './ScientificNumber.vue'
 export { default as ChemicalFormula } from './ChemicalFormula.vue'
-/** Displays LC/MS or GC/MS acquisition sequence progress with ETA and remaining-time labels. @deprecated Scheduled for removal in MINT 1.4; instrument UI moves to the mld-ms plugins. */
+/** Displays LC/MS or GC/MS acquisition sequence progress with ETA and remaining-time labels. */
 export { default as SequenceProgressBar } from './SequenceProgressBar.vue'
 /** Status badge for instrument states: a tone dot (or dash / hollow shape for offline, never-reported and inactive) plus a label. */
 export { default as InstrumentStateBadge } from './InstrumentStateBadge.vue'
@@ -138,6 +152,7 @@ export { default as ArtifactSelectorModal } from './ArtifactSelectorModal.vue'
 export { default as GeneratedPathInput } from './GeneratedPathInput.vue'
 export { default as ArtifactSaveDialog } from './ArtifactSaveDialog.vue'
 export { default as ExperimentPopover } from './ExperimentPopover.vue'
-export { default as FitPanel } from './FitPanel.vue'
+/** Control panel for running a curve-fit job with progress bar, results table, and error display. @deprecated Scheduled for removal in MINT 1.4; no SDK replacement. */
+export { /** @deprecated Removed in MINT 1.4. */ default as FitPanel } from './FitPanel.vue'
 
 export { default as FilePicker } from './FilePicker.vue'

package/src/components/internal/FilePickerListInternal.vue

@@ -22,6 +22,8 @@ const props = defineProps<{
   loading: boolean
   error: string
   query: string
+  /** Search results stopped at a limit; the rows are the first matches only. */
+  truncated?: boolean
   mode: PickerSelectionMode
   selected: (node: PickerNode) => boolean
   selectable: (node: PickerNode) => boolean
@@ -171,6 +173,9 @@ function parts(name: string) {
     <div class="mint-picker__list-head" aria-hidden="true">
       <span /><span>Name</span><span>Size</span><span>Modified</span>
     </div>
+    <p v-if="truncated && !loading && !error && rows.length" class="mint-picker__truncated" role="status">
+      Showing the first {{ rows.length }} matches. Search a smaller folder or use a more specific search to see the rest.
+    </p>
     <div v-if="loading" class="mint-picker__skeleton">
       <Skeleton v-for="n in 6" :key="n" width="100%" height="1.25rem" />
     </div>
@@ -180,10 +185,14 @@ function parts(name: string) {
     </div>
     <div v-else-if="!rows.length" class="mint-picker__empty" role="status">
       <strong>{{
-        query ? 'No matching folders or files' : emptyTitle || 'No readable files'
+        truncated
+          ? 'Search stopped before finding a match'
+          : query ? 'No matching folders or files' : emptyTitle || 'No readable files'
       }}</strong>
       <span>{{
-        query ? 'Try a different search or include subfolders.' : 'Choose another location.'
+        truncated
+          ? 'Search a smaller folder or use a more specific search.'
+          : query ? 'Try a different search or include subfolders.' : 'Choose another location.'
       }}</span>
     </div>
     <template v-for="row in rows" v-else :key="row.node.path">

package/src/components/internal/ResourcePickerListInternal.vue

@@ -1,21 +1,25 @@
 <script setup lang="ts" generic="T">
 /**
  * Searchable, optionally grouped single-select list shared by the experiment and
- * artifact selector modals (8b): 44px two-line rows, trailing check, skeleton,
+ * artifact selector modals: two-line rows (title, then code + meta) with status and date
+ * in a right-hand column, a filled selected row, skeleton,
  * error and empty states, and the combobox keyboard model (↑ ↓ Enter).
  */
 import { computed, nextTick, reactive, ref, useId, watch } from 'vue'
 import BaseInput from '../BaseInput.vue'
 import Skeleton from '../Skeleton.vue'
 import EmptyState from '../EmptyState.vue'
+import type { PillVariant } from '../../types'
 
 export interface ResourcePickerRow {
-  /** Identifier shown in mono before the title, e.g. an experiment code. */
+  /** Identifier shown as a gray pill at the start of the second line, e.g. an experiment code. */
   code?: string
   title: string
-  /** Second-line facts, joined with " · ". */
+  /** Second-line facts after the code, joined with " · ". */
   meta?: string[]
-  /** Rendered last on the second line, in mono. */
+  /** Right column, above the date, tinted by its variant. */
+  status?: { label: string; variant: PillVariant }
+  /** Right column, in mono. */
   date?: string
 }
 
@@ -206,36 +210,26 @@ watch(
           @mouseenter="activeIndex = indexOf(item)"
         >
           <span class="mint-resource-picker__text">
-            <span class="mint-resource-picker__title"
-              ><template v-if="describe(item).code"
-                ><span class="mint-resource-picker__code">{{ describe(item).code }}</span> · </template
-              >{{ describe(item).title }}</span
+            <span class="mint-resource-picker__title">{{ describe(item).title }}</span>
+            <span v-if="describe(item).code || describe(item).meta?.length" class="mint-resource-picker__meta"
+              ><span v-if="describe(item).code" class="mint-resource-picker__code mint-exp-code mint-exp-code--sm">{{
+                describe(item).code
+              }}</span
+              ><span v-if="describe(item).meta?.length">{{ describe(item).meta!.join(' · ') }}</span></span
             >
+          </span>
+          <span v-if="describe(item).status || describe(item).date" class="mint-resource-picker__aside">
             <span
-              v-if="describe(item).meta?.length || describe(item).date"
-              class="mint-resource-picker__meta"
-              >{{ [...(describe(item).meta ?? [])].join(' · ')
-              }}<template v-if="describe(item).date"
-                >{{ describe(item).meta?.length ? ' · ' : ''
-                }}<span class="mint-resource-picker__date">{{ describe(item).date }}</span></template
-              ></span
+              v-if="describe(item).status"
+              class="mint-resource-picker__status"
+              :class="`mint-resource-picker__status--${describe(item).status!.variant}`"
+              >{{ describe(item).status!.label }}</span
             >
+            <span v-if="describe(item).date" class="mint-resource-picker__date">{{ describe(item).date }}</span>
           </span>
           <span v-if="$slots.actions" class="mint-resource-picker__actions" @click.stop>
             <slot name="actions" :item="item" />
           </span>
-          <span class="mint-resource-picker__check-slot" aria-hidden="true">
-            <svg
-              v-if="itemKey(item) === selectedKey"
-              class="mint-resource-picker__check"
-              viewBox="0 0 16 16"
-              fill="none"
-              stroke="currentColor"
-              stroke-width="2"
-            >
-              <path d="M3.5 8.5l3 3 6-7" />
-            </svg>
-          </span>
         </div>
       </template>
     </div>

package/src/composables/autoGroup/index.ts

@@ -1,5 +1,5 @@
 // Internal engine for `useAutoGroup` / `AutoGroupModal`. Deprecated: scheduled
-// for removal in MINT 1.4 together with `useAutoGroup`; `SmartGroupModal` replaces it.
+// for removal in MINT 1.4 together with `useAutoGroup`; no SDK replacement.
 
 export { splitMulti, pickPrimaryDelimiter } from './tokenize'
 export type { Delimiter } from './tokenize'

package/src/composables/createFilePickerAdapter.ts

@@ -1,10 +1,26 @@
-import type { PickerAdapter, PickerNode, PickerRequest } from '../types/filePicker'
-import type { FileBrowserLocation, FileDirectoryListing, ServerMount } from '../types/fileBrowserTypes'
+import type { PickerAdapter, PickerNode, PickerRequest, PickerSearchResult } from '../types/filePicker'
+import type {
+  FileBrowserLocation,
+  FileDirectoryListing,
+  FileDirectoryTree,
+  FileEntry,
+  FileSearchResult,
+  ServerMount,
+} from '../types/fileBrowserTypes'
 import { pickerFormat } from './filePicker/validation'
 
 export interface FilePickerTransport {
   listMounts(request?: PickerRequest): Promise<ServerMount[]>
   browse(location: FileBrowserLocation, request?: PickerRequest): Promise<FileDirectoryListing>
+  /** `GET …/filesystem/tree`: one request fills the cache for the subfolders too. */
+  tree?(location: FileBrowserLocation, request?: PickerRequest): Promise<FileDirectoryTree>
+  /** `GET …/filesystem/search`: replaces the folder-by-folder search walk. */
+  search?(
+    location: FileBrowserLocation,
+    query: string,
+    recursive: boolean,
+    request?: PickerRequest,
+  ): Promise<FileSearchResult>
 }
 export interface FilePickerAdapterOptions {
   /** Show this directory's contents directly and prevent navigation outside it. */
@@ -82,31 +98,75 @@ export function createFilePickerAdapter(
           unavailableReason: mount.available === false ? 'This mount is offline.' : undefined,
         }
       })
+    } else if (transport.tree) {
+      const tree = await transport.tree(location, request)
+      check(request, token)
+      for (const listing of tree.listings ?? []) {
+        const at = { mount_id: listing.mount_id, path: listing.path }
+        validateLocation(at)
+        if (at.mount_id !== location.mount_id) throw new Error('Invalid file picker directory entry.')
+        // A capped subfolder is read on its own when opened, and reports the cap then.
+        if (!listing.truncated) listings.set(encodePlatformPickerPath(at.mount_id, at.path), toNodes(at, listing))
+      }
+      const cached = listings.get(key)
+      if (!cached)
+        throw new Error('This directory exceeds the server listing limit. Choose a smaller data directory.')
+      return cached
     } else {
       const listing = await transport.browse(location, request)
       check(request, token)
       if (listing.truncated)
         throw new Error('This directory exceeds the server listing limit. Choose a smaller data directory.')
-      const atRoot = root && location.mount_id === root.mount_id && location.path === root.path
-      nodes = (listing.entries ?? []).map((entry): PickerNode => {
-        if (!isRelativePath(entry.path) || !entry.name ||
-          entry.path !== `${location.path ? `${location.path}/` : ''}${entry.name}` ||
-          entry.name.includes('/')) throw new Error('Invalid file picker directory entry.')
-        const common = {
-          path: encodePlatformPickerPath(location.mount_id, entry.path),
-          parentPath: atRoot ? null : key,
-          parentName: `${mountLabels.get(location.mount_id) ?? location.mount_id}${location.path ? ` / ${location.path}` : ''}`,
-          name: entry.name, bytes: entry.size_bytes, modifiedAt: entry.modified_at,
-        }
-        return entry.kind === 'directory'
-          // Counts may include only matching formats, not nested directories.
-          ? { ...common, kind: 'folder' }
-          : { ...common, kind: 'file', format: pickerFormat(entry.name) }
-      })
+      nodes = toNodes(location, listing)
     }
     listings.set(key, nodes)
     return nodes
   }
+  function toNodes(location: FileBrowserLocation, listing: FileDirectoryListing): PickerNode[] {
+    return (listing.entries ?? []).map((entry) => {
+      if (entry.path !== `${location.path ? `${location.path}/` : ''}${entry.name}`)
+        throw new Error('Invalid file picker directory entry.')
+      return toNode(location.mount_id, entry)
+    })
+  }
+  /** One entry, parented on the folder its mount-relative path names. */
+  function toNode(mountId: string, entry: FileEntry): PickerNode {
+    if (!isRelativePath(entry.path) || !entry.name || entry.name.includes('/') ||
+      (entry.path !== entry.name && !entry.path.endsWith(`/${entry.name}`)))
+      throw new Error('Invalid file picker directory entry.')
+    const parent = entry.path.slice(0, Math.max(0, entry.path.length - entry.name.length - 1))
+    const atRoot = root && mountId === root.mount_id && parent === root.path
+    const common = {
+      path: encodePlatformPickerPath(mountId, entry.path),
+      parentPath: atRoot ? null : encodePlatformPickerPath(mountId, parent),
+      parentName: `${mountLabels.get(mountId) ?? mountId}${parent ? ` / ${parent}` : ''}`,
+      name: entry.name, bytes: entry.size_bytes, modifiedAt: entry.modified_at,
+    }
+    return entry.kind === 'directory'
+      // Counts may include only matching formats, not nested directories.
+      ? { ...common, kind: 'folder' }
+      : { ...common, kind: 'file', format: pickerFormat(entry.name) }
+  }
+  async function serverSearch(
+    query: string,
+    scope: { path: string; recursive: boolean },
+    request: PickerRequest | undefined,
+  ): Promise<PickerNode[] | PickerSearchResult> {
+    const token = begin(request)
+    const decoded = scope.path ? decodePlatformPickerPath(scope.path) : undefined
+    const location = decoded ? { mount_id: decoded.mountId, path: decoded.path } : root!
+    validateLocation(location)
+    const result = await transport.search!(location, query, scope.recursive, request)
+    check(request, token)
+    const prefix = location.path ? `${location.path}/` : ''
+    const nodes = (result.entries ?? []).map((entry) => {
+      // "This folder" searches may return direct children only.
+      if (!entry.path.startsWith(prefix) || (!scope.recursive && entry.path.slice(prefix.length).includes('/')))
+        throw new Error('Invalid file picker directory entry.')
+      return toNode(location.mount_id, entry)
+    })
+    return result.truncated ? { nodes, truncated: true } : nodes
+  }
   return {
     mounts: !root,
     mountOf(path) {
@@ -120,6 +180,8 @@ export function createFilePickerAdapter(
     listRoot: async (request) => read('', request, begin(request)),
     listChildren: async (path, request) => read(path, request, begin(request)),
     async search(query, scope, request) {
+      // The mount list itself has no server to search, so it keeps the walk.
+      if (transport.search && (scope.path || root)) return serverSearch(query, scope, request)
       const token = begin(request)
       const matches: PickerNode[] = []
       const queue = [scope.path]
@@ -131,8 +193,7 @@ export function createFilePickerAdapter(
         const path = queue.shift()!
         if (visited.has(path)) continue
         visited.add(path)
-        if (visited.size > 500)
-          throw new Error('Search reached its folder limit. Search a smaller location or turn off Subfolders.')
+        if (visited.size > 500) return { nodes: matches, truncated: true }
         const nodes = await read(path, currentRequest, token)
         check(request, token)
         if (currentRequest?.refresh) {
@@ -144,8 +205,7 @@ export function createFilePickerAdapter(
           if (scope.recursive && node.kind === 'folder' && !node.unavailableReason)
             queue.push(node.path)
         }
-        if (matches.length > 10000)
-          throw new Error('Too many search results. Use a more specific search.')
+        if (matches.length > 10000) return { nodes: matches.slice(0, 10000), truncated: true }
       }
       return matches
     },

package/src/composables/filePicker/usePickerNavigation.ts

@@ -3,13 +3,33 @@ import type {
   PickerAdapter,
   PickerNode,
   PickerRequest,
+  PickerSort,
   PickerTreeRow,
 } from '../../types/filePicker'
 
+const byName = new Intl.Collator(undefined, { numeric: true, sensitivity: 'base' }).compare
+/** Folders first; undated rows go last in either time order. */
+function ordered(items: PickerNode[], sort: PickerSort | undefined): PickerNode[] {
+  if (!sort) return items
+  // Parse each timestamp once rather than on every comparison.
+  const times = new Map(items.map((node) => [node, node.modifiedAt ? Date.parse(node.modifiedAt) : NaN]))
+  const time = (node: PickerNode) => times.get(node)!
+  return [...items].sort((a, b) => {
+    if (a.kind !== b.kind) return a.kind === 'folder' ? -1 : 1
+    if (sort === 'name') return byName(a.name, b.name)
+    if (sort === 'name-desc') return byName(b.name, a.name)
+    const [ta, tb] = [time(a), time(b)]
+    if (Number.isNaN(ta) || Number.isNaN(tb))
+      return Number.isNaN(ta) === Number.isNaN(tb) ? byName(a.name, b.name) : Number.isNaN(ta) ? 1 : -1
+    return (sort === 'newest' ? tb - ta : ta - tb) || byName(a.name, b.name)
+  })
+}
+
 export function usePickerNavigation(
   adapter: () => PickerAdapter,
   request: () => PickerRequest,
   systemFilter: (node: PickerNode) => boolean = () => true,
+  sort: () => PickerSort | undefined = () => undefined,
 ) {
   const path = shallowRef('')
   const trail = ref<{ path: string; label: string }[]>([])
@@ -21,6 +41,8 @@ export function usePickerNavigation(
   const expansionErrors = ref(new Map<string, string>())
   const loading = shallowRef(false)
   const error = shallowRef('')
+  /** True when the current search results stopped at an adapter limit. */
+  const truncated = shallowRef(false)
   let epoch = 0
   let navigation = 0
   let controller: AbortController | undefined
@@ -154,14 +176,17 @@ export function usePickerNavigation(
     const options = { ...request(), ...(refresh && { refresh }), signal: controller.signal }
     loading.value = true
     error.value = ''
+    truncated.value = false
     entries.value = []
     try {
-      const items = query.trim()
+      const found = query.trim()
         ? await adapter().search(query.trim(), { path: path.value, recursive }, options)
         : path.value
           ? await loadChildren(path.value, [], refresh)
           : await adapter().listRoot(options)
       if (token !== navigation) return
+      const items = Array.isArray(found) ? found : found.nodes
+      truncated.value = !Array.isArray(found) && found.truncated
       register(items, query.trim() ? undefined : path.value)
       entries.value = items
       if (!query.trim()) prefetch(items)
@@ -215,8 +240,9 @@ export function usePickerNavigation(
   }
   const rows = computed(() => {
     const result: PickerTreeRow[] = []
+    const order = sort()
     function visit(items: PickerNode[], depth: number, ancestors: Set<string>) {
-      for (const item of items) {
+      for (const item of ordered(items, order)) {
         if (ancestors.has(item.path) || depth > 30) continue
         const node = nodes.value.get(item.path) ?? item
         if (!isAllowed(node)) continue
@@ -246,6 +272,7 @@ export function usePickerNavigation(
     expansionErrors,
     loading,
     error,
+    truncated,
     rows,
     isAllowed,
     clear,

package/src/composables/index.ts

@@ -4,8 +4,6 @@ export {
   type ApiClientOptions,
   type UseApiReturn,
 } from './useApi'
-export { useAuth } from './useAuth'
-export { usePasskey } from './usePasskey'
 export { useTheme } from './useTheme'
 export { useToast } from './useToast'
 export { usePlatformContext } from './usePlatformContext'
@@ -32,11 +30,6 @@ export {
   type FieldState,
   type UseFormReturn,
 } from './useForm'
-export {
-  useWellPlateEditor,
-  type UseWellPlateEditorOptions,
-  type UseWellPlateEditorReturn,
-} from './useWellPlateEditor'
 export {
   useConcentrationUnits,
   type ConcentrationValue,

package/src/composables/useAutoGroup.ts

@@ -62,7 +62,7 @@ export { parseCSV } from './autoGroup/csv-shim'
 /**
  * Sample-grouping engine behind `AutoGroupModal`.
  *
- * @deprecated Scheduled for removal in MINT 1.4; use `SmartGroupModal` instead.
+ * @deprecated Scheduled for removal in MINT 1.4; no SDK replacement.
  */
 export function useAutoGroup() {
   const inputMode = ref<InputMode>('paste')