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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morscherlab/mint-sdk",
-  "version": "1.3.0-beta.1",
+  "version": "1.3.0-beta.10",
   "description": "MINT Platform SDK — Vue 3 components, composables, and types for plugin development. MINT = Mass-spec INtegrated Toolkit.",
   "type": "module",
   "main": "./dist/index.js",
@@ -67,16 +67,12 @@
     "story:preview": "histoire preview"
   },
   "peerDependencies": {
-    "@simplewebauthn/browser": "^14.0.0",
     "pinia": "^4.0.3",
     "tailwindcss": "^4.3.3",
     "vue": "^3.5.43",
     "vue-router": "^5.3.1"
   },
   "peerDependenciesMeta": {
-    "@simplewebauthn/browser": {
-      "optional": true
-    },
     "vue-router": {
       "optional": true
     }
@@ -89,7 +85,6 @@
   },
   "devDependencies": {
     "@histoire/plugin-vue": "1.0.0-beta.1",
-    "@simplewebauthn/browser": "14.0.0",
     "@types/node": "22.20.4",
     "@vitejs/plugin-vue": "6.0.9",
     "@vue/language-core": "3.3.11",

package/src/__tests__/components/ActionMenu.test.ts

@@ -267,4 +267,14 @@ describe('ActionMenu', () => {
 
     expect(document.activeElement).toBe(trigger.element)
   })
+
+  it('should render a checked item as a checked menu radio when checked is set', async () => {
+    const wrapper = mount(ActionMenu, {
+      attachTo: document.body,
+      props: { label: 'Sort', items: [{ id: 'a', label: 'A', checked: true }, { id: 'b', label: 'B', checked: false }] },
+    })
+    await wrapper.get('button').trigger('click')
+    const radios = [...document.body.querySelectorAll('[role="menuitemradio"]')]
+    expect(radios.map((item) => item.getAttribute('aria-checked'))).toEqual(['true', 'false'])
+  })
 })

package/src/__tests__/components/AppTopBar.test.ts

@@ -1211,12 +1211,20 @@ describe('AppTopBar', () => {
         expect(wrapper.get('.mint-topbar__plugin-name').text()).toBe('LC-MS Analysis')
       })
 
-      it('should render the plugin version in mono after the name when integrated', () => {
+      it('should render the platform display name when integrated', () => {
+        mockPlatformCtx({ isIntegrated: true, plugin: { ...integratedPlugin, display_name: 'LC-MS Peak Review' } })
+
+        const wrapper = createWrapper()
+
+        expect(wrapper.get('.mint-topbar__plugin-name').text()).toBe('LC-MS Peak Review')
+      })
+
+      it('should not render the plugin version when integrated', () => {
         mockPlatformCtx({ isIntegrated: true, plugin: integratedPlugin })
 
         const wrapper = createWrapper()
 
-        expect(wrapper.get('.mint-topbar__plugin-version').text()).toBe('v2.4.0')
+        expect(wrapper.text()).not.toContain('v2.4.0')
       })
 
       it('should not render the plugin identity text when standalone', () => {
@@ -1225,21 +1233,29 @@ describe('AppTopBar', () => {
         expect(wrapper.find('.mint-topbar__plugin-name').exists()).toBe(false)
       })
 
-      it('should render a divider between the identity and the page selector', () => {
+      it('should hide the plugin name when a page selector is shown', () => {
         mockPlatformCtx({ isIntegrated: true, plugin: integratedPlugin })
 
         const wrapper = createWrapper({ pageSelector: pages, currentPageSelectorId: 'peaks' })
 
-        expect(wrapper.get('.mint-topbar__divider').element.nextElementSibling?.classList)
-          .toContain('mint-page-selector')
+        expect(wrapper.find('.mint-topbar__plugin-name').exists()).toBe(false)
       })
 
-      it('should not render the divider without a page selector', () => {
-        mockPlatformCtx({ isIntegrated: true, plugin: integratedPlugin })
+      it('should hide the plugin name when the plugin declares several nav items', () => {
+        mockPlatformCtx({
+          isIntegrated: true,
+          plugin: {
+            ...integratedPlugin,
+            nav_items: [
+              { id: 'peaks', path: '/', label: 'Peaks' },
+              { id: 'report', path: '/report', label: 'Report' },
+            ],
+          },
+        })
 
         const wrapper = createWrapper()
 
-        expect(wrapper.find('.mint-topbar__divider').exists()).toBe(false)
+        expect(wrapper.find('.mint-topbar__plugin-name').exists()).toBe(false)
       })
 
       it('should not repeat the title next to the integrated identity', () => {

package/src/__tests__/components/EmptyState.test.ts

@@ -20,4 +20,19 @@ describe('EmptyState', () => {
 
     expect(wrapper.emitted('action')).toHaveLength(1)
   })
+
+  it('should wrap default-slot content in the spaced content block', () => {
+    const wrapper = mount(EmptyState, {
+      props: { title: 'No instruments yet', description: 'Add the lab systems.' },
+      slots: { default: '<button class="slot-action">New instrument</button>' },
+    })
+
+    expect(wrapper.find('.mint-empty-state__content .slot-action').exists()).toBe(true)
+  })
+
+  it('should not render the content block without default-slot content', () => {
+    const wrapper = mount(EmptyState, { props: { title: 'Empty' } })
+
+    expect(wrapper.find('.mint-empty-state__content').exists()).toBe(false)
+  })
 })

package/src/__tests__/components/ExperimentSelectorModal.test.ts

@@ -129,25 +129,32 @@ describe('ExperimentSelectorModal', () => {
     expect(wrapper.emitted('update:modelValue')).toEqual([[false]])
   })
 
-  it('should lead the row title with the experiment code in mono', () => {
+  it('should show the experiment code as a pill on the second line', () => {
     experiments.value = [experiment()]
     const wrapper = mountModal({ modelValue: true })
 
     expect(wrapper.get('.mint-resource-picker__code').text()).toBe('EXP-007')
   })
 
-  it('should state the status as text on the second row line', () => {
+  it('should state the status as text in the right-hand column', () => {
     experiments.value = [experiment()]
     const wrapper = mountModal({ modelValue: true })
 
-    expect(wrapper.get('.mint-resource-picker__meta').text()).toContain('Ongoing')
+    expect(wrapper.get('.mint-resource-picker__aside').text()).toContain('Ongoing')
   })
 
-  it('should check the current experiment row', () => {
+  it('should tint the status with the experiment status variant', () => {
+    experiments.value = [experiment()]
+    const wrapper = mountModal({ modelValue: true })
+
+    expect(wrapper.get('.mint-resource-picker__status').classes()).toContain('mint-resource-picker__status--primary')
+  })
+
+  it('should fill the current experiment row', () => {
     experiments.value = [experiment()]
     const wrapper = mountModal({ modelValue: true, currentExperimentId: 7 })
 
-    expect(wrapper.find('.mint-resource-picker__check').exists()).toBe(true)
+    expect(wrapper.find('.mint-resource-picker__row--selected').exists()).toBe(true)
   })
 
   it('clears the shared store from the clear-selection footer', async () => {

package/src/__tests__/components/FilePicker.test.ts

@@ -548,9 +548,10 @@ describe('FilePicker list view', () => {
     await row(wrapper, folder.path).trigger('dblclick')
     await flushPromises()
     expect(wrapper.findAll('[role="option"]').map((item) => item.attributes('data-path'))).toEqual([
+      // Undated rows fall back to name order under the default newest-first sort.
+      unsupported.path,
       one.path,
       two.path,
-      unsupported.path,
     ])
   })
 
@@ -767,4 +768,67 @@ describe('formatModified', () => {
   it('should show the full date outside the current year', () => {
     expect(formatModified('2025-01-02T08:00:00', now)).toBe('2025-01-02')
   })
+
+  it('should list the newest folder first when opened', async () => {
+    const wrapper = await setup({
+      adapter: {
+        ...adapter(),
+        listRoot: vi.fn(async () => [
+          { ...folder, modifiedAt: '2026-01-01T00:00:00Z' },
+          { ...other, modifiedAt: '2026-09-29T00:00:00Z' },
+        ]),
+      },
+    })
+    expect(wrapper.findAll('[role="treeitem"]').map((item) => item.attributes('data-path'))).toEqual([
+      other.path, folder.path,
+    ])
+  })
+
+  it('should reorder rows by name when Name A–Z is chosen from the sort menu', async () => {
+    const wrapper = await setup({ defaultSort: 'name-desc' })
+    await wrapper.get('.mint-picker__sort').trigger('click')
+    await wrapper.findAll('[role="menuitemradio"]').find((item) => item.text() === 'Name A–Z')!.trigger('click')
+    expect(wrapper.findAll('[role="treeitem"]').map((item) => item.attributes('data-path'))).toEqual([
+      other.path, folder.path,
+    ])
+  })
+
+  it('should label the sort trigger with the active order', async () => {
+    const wrapper = await setup()
+    expect(wrapper.get('.mint-picker__sort').text()).toContain('Newest first')
+  })
+
+  it('should tell the user when search results are partial', async () => {
+    vi.useFakeTimers()
+    const base = adapter()
+    const wrapper = await setup({
+      adapter: { ...base, search: vi.fn(async () => ({ nodes: [one], truncated: true })) },
+    })
+    await wrapper.get('[aria-label="Search folders and files"]').setValue('sample')
+    await vi.advanceTimersByTimeAsync(400)
+    await flushPromises()
+    expect(wrapper.get('.mint-picker__truncated').text()).toContain('first 1')
+  })
+
+  it('should still list the partial search results', async () => {
+    vi.useFakeTimers()
+    const wrapper = await setup({
+      adapter: { ...adapter(), search: vi.fn(async () => ({ nodes: [one], truncated: true })) },
+    })
+    await wrapper.get('[aria-label="Search folders and files"]').setValue('sample')
+    await vi.advanceTimersByTimeAsync(400)
+    await flushPromises()
+    expect(wrapper.findAll('[role="treeitem"]').map((item) => item.attributes('data-path'))).toEqual([one.path])
+  })
+
+  it('should say the search stopped early when a truncated search found nothing', async () => {
+    vi.useFakeTimers()
+    const wrapper = await setup({
+      adapter: { ...adapter(), search: vi.fn(async () => ({ nodes: [], truncated: true })) },
+    })
+    await wrapper.get('[aria-label="Search folders and files"]').setValue('sample')
+    await vi.advanceTimersByTimeAsync(400)
+    await flushPromises()
+    expect(wrapper.get('.mint-picker__empty').text()).toContain('stopped')
+  })
 })

package/src/__tests__/components/FileUploader.test.ts

@@ -3,16 +3,13 @@ import { describe, expect, it } from 'vitest'
 import FileUploader from '../../components/FileUploader.vue'
 
 describe('FileUploader', () => {
-  it('should prompt to release with the dragged file count when files are dragged over', async () => {
-    const wrapper = mount(FileUploader, { props: { multiple: true } })
-    await wrapper.get('.mint-file-uploader__dropzone').trigger('dragover', {
-      dataTransfer: { items: { length: 3 } },
-    })
-    expect(wrapper.get('.mint-file-uploader__text').text()).toBe('Release to add 3 files')
+  it('should name the accepted formats in the prompt when accept is set', () => {
+    const wrapper = mount(FileUploader, { props: { accept: '.raw, .mzML' } })
+    expect(wrapper.get('.mint-file-uploader__text').text()).toBe('Drop RAW, MZML or click')
   })
 
-  it('should list accepted formats as written when accept and maxSize are set', () => {
-    const wrapper = mount(FileUploader, { props: { accept: '.raw, .mzML', maxSize: 2 * 1024 ** 3 } })
-    expect(wrapper.get('.mint-file-uploader__formats').text()).toBe('.raw .mzML · max 2.0 GB')
+  it('should prompt for any file when accept is not set', () => {
+    const wrapper = mount(FileUploader)
+    expect(wrapper.get('.mint-file-uploader__text').text()).toBe('Drop any file or click')
   })
 })

package/src/__tests__/components/ResourcePickerListInternal.test.ts

@@ -40,8 +40,27 @@ describe('ResourcePickerListInternal', () => {
     expect(setup().get('.mint-resource-picker__code').text()).toBe('EXP-042')
   })
 
-  it('should join the meta and date on the second line', () => {
-    expect(setup().get('.mint-resource-picker__meta').text()).toBe('Zhang · 09-24')
+  it('should render the code as the shared gray code pill', () => {
+    expect(setup().get('.mint-resource-picker__code').classes()).toContain('mint-exp-code')
+  })
+
+  it('should tint the status by its variant', () => {
+    const wrapper = setup({
+      describe: (item: unknown) => ({ title: (item as Item).name, status: { label: 'Completed', variant: 'success' } }),
+    })
+    expect(wrapper.get('.mint-resource-picker__status').classes()).toContain('mint-resource-picker__status--success')
+  })
+
+  it('should keep the title line to the title alone', () => {
+    expect(setup().get('.mint-resource-picker__title').text()).toBe('Liver microsome stability')
+  })
+
+  it('should lead the second line with the code and meta', () => {
+    expect(setup().get('.mint-resource-picker__meta').text()).toBe('EXP-042Zhang')
+  })
+
+  it('should put the date in the right-hand column', () => {
+    expect(setup().get('.mint-resource-picker__aside .mint-resource-picker__date').text()).toBe('09-24')
   })
 
   it('should mark the selected row', () => {
@@ -49,8 +68,8 @@ describe('ResourcePickerListInternal', () => {
     expect(wrapper.findAll('[role="option"]')[1]!.attributes('aria-selected')).toBe('true')
   })
 
-  it('should draw a trailing check on the selected row only', () => {
-    expect(setup({ selectedKey: 2 }).findAll('.mint-resource-picker__check')).toHaveLength(1)
+  it('should fill the selected row only', () => {
+    expect(setup({ selectedKey: 2 }).findAll('.mint-resource-picker__row--selected')).toHaveLength(1)
   })
 
   it('should emit select when a row is clicked', async () => {

package/src/__tests__/components/SettingsModal.test.ts

@@ -540,6 +540,28 @@ describe('SettingsModal', () => {
       expect(wrapper.findAll('.mint-modal__rail-section').map(heading => heading.text())).toEqual(['Plugin', 'Personal'])
     })
 
+    it('should list and open Appearance first when appearanceFirst is set', () => {
+      const wrapper = mountSettingsModal({
+        tabs: [{ id: 'plugins', label: 'Plugins' }],
+        showAppearance: true,
+        appearanceFirst: true,
+        layout: 'vertical',
+      })
+
+      expect(wrapper.get('.mint-modal__rail-item--active').text()).toContain('Appearance')
+    })
+
+    it('should label a manual tab rail section from its section', () => {
+      const wrapper = mountSettingsModal({
+        tabs: [{ id: 'plugins', label: 'Plugins', section: 'Platform' }],
+        showAppearance: true,
+        appearanceFirst: true,
+        layout: 'vertical',
+      })
+
+      expect(wrapper.findAll('.mint-modal__rail-section').map(heading => heading.text())).toEqual(['Personal', 'Platform'])
+    })
+
     it('should not render rail section headings when appearance is hidden', () => {
       const wrapper = mountSettingsModal({ schema: railSchema })
 

package/src/__tests__/components/WellPlate.decoration.test.ts

@@ -26,7 +26,7 @@ describe('WellPlate per-well decoration', () => {
       .toEqual(['2px', 'solid', 'var(--mint-warning)'])
   })
 
-  it('should render the QC marker glyph when a QC well has no label or id', () => {
+  it('should render no glyph when a QC well has no label or id', () => {
     const wrapper = mount(WellPlate, {
       props: {
         format: 6,
@@ -34,37 +34,13 @@ describe('WellPlate per-well decoration', () => {
       },
     })
 
-    expect(wrapper.findAll('.mint-well-plate__well')[0].text()).toBe('Q')
+    expect(wrapper.findAll('.mint-well-plate__well')[0].text()).toBe('')
   })
 
-  it('should keep the iQC marker glyph when well IDs are shown', () => {
-    const wrapper = mount(WellPlate, {
-      props: {
-        format: 6,
-        showWellIds: true,
-        wells: { A1: { id: 'A1', row: 0, col: 0, state: 'filled', sampleType: 'iqc' } },
-      },
-    })
-
-    expect(wrapper.findAll('.mint-well-plate__well')[0].find('.mint-well-plate__corner-glyph').text()).toBe('i')
-  })
-
-  it('should keep the iQC marker glyph when a custom label is shown', () => {
-    const wrapper = mount(WellPlate, {
-      props: {
-        format: 6,
-        showWellLabels: true,
-        wells: { A1: { id: 'A1', row: 0, col: 0, state: 'filled', sampleType: 'iqc', metadata: { label: 'Std 1' } } },
-      },
-    })
-
-    expect(wrapper.findAll('.mint-well-plate__well')[0].find('.mint-well-plate__corner-glyph').text()).toBe('i')
-  })
-
-  it('should draw legend swatches with the sample-type marker when the legend is shown', () => {
+  it('should draw plain legend swatches when the legend is shown', () => {
     const wrapper = mount(WellPlate, { props: { format: 6, showLegend: true } })
 
     const dots = wrapper.findAll('.mint-well-plate__sample-legend-dot')
-    expect(dots.map(dot => dot.text())).toEqual(['', '', 'Q', 'i'])
+    expect(dots.map(dot => dot.text())).toEqual(['', '', '', ''])
   })
 })

package/src/__tests__/components/WellPlate.rendering.test.ts

@@ -1,6 +1,5 @@
 import { describe, expect, it } from 'vitest'
 import {
-  sampleTypeGlyph,
   wellBadge,
   wellClasses,
   wellLabel,
@@ -70,45 +69,45 @@ describe('WellPlate rendering helpers', () => {
       heatmap: { enabled: false },
       sampleColors: { treated: '#123456' },
     })).toEqual({
-      backgroundColor: 'color-mix(in srgb, #123456 28%, var(--bg-card))',
-      border: '1px solid #123456',
+      backgroundColor: 'color-mix(in srgb, #123456 15%, transparent)',
+      border: '1px solid color-mix(in srgb, #123456 40%, transparent)',
     })
 
     expect(wellStyle(well({ sampleType: 'qc' }), {
       heatmap: { enabled: false },
       sampleColors: {},
     })).toEqual({
-      backgroundColor: 'var(--bg-card)',
-      border: '1.5px solid var(--text-secondary-strong)',
+      backgroundColor: 'color-mix(in srgb, #8b5cf6 15%, transparent)',
+      border: '1px solid color-mix(in srgb, #8b5cf6 40%, transparent)',
     })
   })
 
-  it('should fill a sample well with its group token when no custom color is set', () => {
+  it('should tint a sample well green when no custom color is set', () => {
     expect(wellStyle(well({ sampleType: 'sample' }), {
       heatmap: { enabled: false },
       sampleColors: {},
-    }).border).toBe('1px solid var(--mint-sample-1)')
+    }).border).toBe('1px solid color-mix(in srgb, #10b981 40%, transparent)')
   })
 
-  it('should color a well by its group before its sample type', () => {
-    expect(wellStyle(well({ sampleType: 'iqc', group: 'trt' }), {
+  it('should tint a blank well orange when no custom color is set', () => {
+    expect(wellStyle(well({ sampleType: 'blank' }), {
       heatmap: { enabled: false },
-      sampleColors: { trt: '#123456' },
-    }).border).toBe('1px solid #123456')
+      sampleColors: {},
+    }).border).toBe('1px solid color-mix(in srgb, #f97316 40%, transparent)')
   })
 
-  it('should keep a grouped blank well neutral', () => {
-    expect(wellStyle(well({ sampleType: 'blank', group: 'trt' }), {
+  it('should color a well by its group before its sample type', () => {
+    expect(wellStyle(well({ sampleType: 'iqc', group: 'trt' }), {
       heatmap: { enabled: false },
       sampleColors: { trt: '#123456' },
-    }).border).toBe('1.5px dashed var(--_control-border-strong)')
+    }).border).toBe('1px solid color-mix(in srgb, #123456 40%, transparent)')
   })
 
-  it('should keep QC neutral when a custom QC color is set', () => {
-    expect(wellStyle(well({ sampleType: 'qc' }), {
+  it('should tint a well with a group color token', () => {
+    expect(wellStyle(well({ sampleType: 'sample', group: 'trt' }), {
       heatmap: { enabled: false },
-      sampleColors: { qc: '#8b5cf6' },
-    }).border).toBe('1.5px solid var(--text-secondary-strong)')
+      sampleColors: { trt: 'var(--mint-sample-3)' },
+    }).backgroundColor).toBe('color-mix(in srgb, var(--mint-sample-3) 15%, transparent)')
   })
 
   it('should leave empty wells to the stylesheet when the well has no sample type', () => {
@@ -125,29 +124,17 @@ describe('WellPlate rendering helpers', () => {
     })).toEqual({})
   })
 
-  it('should return the Q glyph when the well is QC', () => {
-    expect(sampleTypeGlyph(well({ sampleType: 'qc' }))).toBe('Q')
-  })
-
-  it('should return the i glyph when the well is iQC', () => {
-    expect(sampleTypeGlyph(well({ sampleType: 'iqc' }))).toBe('i')
-  })
-
-  it('should return no glyph when the well is a sample', () => {
-    expect(sampleTypeGlyph(well({ sampleType: 'sample' }))).toBeNull()
-  })
-
   it('formats labels and badges for optional overlays', () => {
     expect(wellLabel(well({ metadata: { label: 'Dose A' } }), true)).toBe('Dose A')
     expect(wellLabel(well({ metadata: { label: 'Dose A' } }), false)).toBeUndefined()
 
     expect(wellBadge(well({ metadata: { injectionCount: 3 } }), true)).toEqual({
       text: '3',
-      color: 'var(--text-primary)',
+      color: '#6366f1',
     })
     expect(wellBadge(well({ metadata: { customMethod: 'LCMS-2' } }), true)).toEqual({
-      text: '',
-      color: 'var(--color-purple)',
+      text: '+',
+      color: '#ec4899',
     })
     expect(wellBadge(well({ metadata: { injectionCount: 1 } }), true)).toBeNull()
   })

package/src/__tests__/components/WellPlate.sampleTypeIndicator.test.ts

@@ -4,9 +4,9 @@ import { afterEach, describe, expect, it, vi } from 'vitest'
 import WellPlate from '../../components/WellPlate.vue'
 import type { Well } from '../../types'
 
-// `showSampleTypeIndicator` is deprecated (3a): shape encodes the type, only
-// QC `Q` and iQC `i` carry glyphs. The warning fires once per module, so the
-// order of the first two tests matters.
+// `showSampleTypeIndicator` is deprecated (3a): wells carry no letters, color
+// encodes the type. The warning fires once per module, so the order of the
+// first two tests matters.
 
 function mountPlate(sampleType: string, showSampleTypeIndicator: boolean) {
   const wells: Record<string, Partial<Well>> = {
@@ -48,11 +48,11 @@ describe('WellPlate showSampleTypeIndicator (deprecated)', () => {
     expect(firstWellText('blank')).toBe('')
   })
 
-  it('should keep the QC marker glyph when showSampleTypeIndicator is on', () => {
-    expect(firstWellText('qc')).toBe('Q')
+  it('should render no letter for a QC well when showSampleTypeIndicator is on', () => {
+    expect(firstWellText('qc')).toBe('')
   })
 
-  it('should keep the iQC marker glyph when showSampleTypeIndicator is on', () => {
-    expect(firstWellText('iqc')).toBe('i')
+  it('should render no letter for an iQC well when showSampleTypeIndicator is on', () => {
+    expect(firstWellText('iqc')).toBe('')
   })
 })

package/src/__tests__/composables/createFilePickerAdapter.test.ts

@@ -110,7 +110,7 @@ it('bounds recursive traversal and rejects truncated listings', async () => {
     mount_id, path,
     entries: [{ kind: 'directory', name: 'next', path: path ? `${path}/next` : 'next' }],
   }))
-  await expect(adapter.search('missing', { path: '', recursive: true })).rejects.toThrow('folder limit')
+  expect(await adapter.search('missing', { path: '', recursive: true })).toEqual({ nodes: [], truncated: true })
   expect(transport.browse).toHaveBeenCalledTimes(500)
   vi.mocked(transport.browse).mockResolvedValue({ mount_id: 'raw', path: '', entries: [], truncated: true })
   await expect(adapter.listRoot({ refresh: true })).rejects.toThrow('listing limit')
@@ -162,3 +162,94 @@ it('names the mount holding a path and nothing for a path it cannot decode', ()
   const adapter = createFilePickerAdapter(setup().transport)
   expect([adapter.mountOf!(identity('study/run')), adapter.mountOf!('not-json')]).toEqual([identity(), undefined])
 })
+
+function treeSetup() {
+  const study = { kind: 'directory' as const, name: 'study', path: 'study' }
+  const run = { kind: 'file' as const, name: 'run.raw', path: 'study/run.raw' }
+  const transport: FilePickerTransport = {
+    listMounts: vi.fn(async () => [{ id: 'raw', label: 'Raw files' }]),
+    browse: vi.fn(async ({ mount_id, path }) => ({ mount_id, path, entries: [] })),
+    tree: vi.fn(async ({ mount_id }) => ({
+      listings: [
+        { mount_id, path: '', entries: [study] },
+        { mount_id, path: 'study', entries: [run] },
+      ],
+      truncated: false,
+    })),
+    search: vi.fn(async ({ path }) => ({
+      entries: [study, run].filter((entry) => !path || entry.path.startsWith(`${path}/`)),
+      searched_directories: 2,
+      truncated: false,
+    })),
+  }
+  return { transport, adapter: createFilePickerAdapter(transport, { rootLocation: { mount_id: 'raw', path: '' } }) }
+}
+
+it('should serve a subfolder from the tree response when the transport has tree', async () => {
+  const { adapter, transport } = treeSetup()
+  await adapter.listRoot()
+  await adapter.listChildren(identity('study'))
+  expect(transport.tree).toHaveBeenCalledTimes(1)
+})
+
+it('should not call browse when the transport has tree', async () => {
+  const { adapter, transport } = treeSetup()
+  await adapter.listRoot()
+  expect(transport.browse).not.toHaveBeenCalled()
+})
+
+it('should map tree listings to their own parent folders', async () => {
+  const { adapter } = treeSetup()
+  await adapter.listRoot()
+  expect(await adapter.listChildren(identity('study'))).toMatchObject([
+    { path: identity('study/run.raw'), parentPath: identity('study'), kind: 'file' },
+  ])
+})
+
+it('should search on the server when the transport has search', async () => {
+  const { adapter, transport } = treeSetup()
+  await adapter.search('ru', { path: identity('study'), recursive: true })
+  expect(transport.search).toHaveBeenCalledWith({ mount_id: 'raw', path: 'study' }, 'ru', true, undefined)
+})
+
+it('should give server search results their parent folder', async () => {
+  const { adapter } = treeSetup()
+  expect(await adapter.search('ru', { path: '', recursive: true })).toMatchObject([
+    { path: identity('study'), parentPath: null },
+    { path: identity('study/run.raw'), parentPath: identity('study') },
+  ])
+})
+
+it('should return partial server results marked truncated when the server stops early', async () => {
+  const { adapter, transport } = treeSetup()
+  vi.mocked(transport.search!).mockResolvedValueOnce({
+    entries: [{ kind: 'file', name: 'run.raw', path: 'study/run.raw' }], searched_directories: 5000, truncated: true,
+  })
+  expect(await adapter.search('ru', { path: '', recursive: true })).toMatchObject({
+    nodes: [{ path: identity('study/run.raw') }], truncated: true,
+  })
+})
+
+it('should reject a search entry whose name is only a suffix of its last path segment', async () => {
+  const { adapter, transport } = treeSetup()
+  vi.mocked(transport.search!).mockResolvedValueOnce({
+    entries: [{ kind: 'file', name: 'b', path: 'study/ab' }], searched_directories: 1, truncated: false,
+  })
+  await expect(adapter.search('b', { path: '', recursive: true })).rejects.toThrow(/Invalid/)
+})
+
+it('should reject a server search entry outside the searched folder', async () => {
+  const { adapter, transport } = treeSetup()
+  vi.mocked(transport.search!).mockResolvedValueOnce({
+    entries: [{ kind: 'file', name: 'x.raw', path: 'other/x.raw' }], searched_directories: 1, truncated: false,
+  })
+  await expect(adapter.search('x', { path: identity('study'), recursive: true })).rejects.toThrow(/Invalid/)
+})
+
+it('should reject a nested entry from a search limited to this folder', async () => {
+  const { adapter, transport } = treeSetup()
+  vi.mocked(transport.search!).mockResolvedValueOnce({
+    entries: [{ kind: 'file', name: 'x.raw', path: 'study/private/x.raw' }], searched_directories: 1, truncated: false,
+  })
+  await expect(adapter.search('x', { path: identity('study'), recursive: false })).rejects.toThrow(/Invalid/)
+})