@morscherlab/mint-sdk 1.3.0-beta.3 → 1.3.0-beta.4

package/dist/styles.css

@@ -1836,6 +1836,15 @@ button, input, select, textarea {
   max-width: min(18rem, calc(100vw - 1rem));
 }
 
+.mint-action-menu__check {
+  flex-shrink: 0;
+  color: var(--color-primary);
+}
+
+/* Unchecked radio rows keep the check's width so labels stay aligned. */
+.mint-action-menu__check--off {
+  visibility: hidden;
+}
 .mint-adduct-text {
   display: inline-flex;
   align-items: center;
@@ -20590,6 +20599,7 @@ html.dark .mint-experiment-selector__filters-toggle--active {
   white-space: nowrap;
 }
 .mint-picker__scope,
+.mint-picker__sort,
 .mint-picker__link {
   padding: 2px 6px;
   border: 0;
@@ -20600,10 +20610,20 @@ html.dark .mint-experiment-selector__filters-toggle--active {
   cursor: pointer;
   transition: background-color 150ms ease;
 }
-.mint-picker__scope {
+.mint-picker__scope,
+.mint-picker__sort {
   flex-shrink: 0;
   color: var(--text-secondary-strong);
 }
+.mint-picker__sort {
+  display: inline-flex;
+  align-items: center;
+  gap: 2px;
+}
+.mint-picker__sort svg {
+  width: 12px;
+  height: 12px;
+}
 .mint-picker__link {
   color: var(--_ink-primary);
 }
@@ -20622,10 +20642,13 @@ html.dark .mint-experiment-selector__filters-toggle--active {
   cursor: not-allowed;
 }
 .mint-picker__scope:hover,
+.mint-picker__sort:hover,
+.mint-picker__sort[aria-expanded='true'],
 .mint-picker__link:hover {
   background: var(--bg-hover);
 }
 .mint-picker__scope:focus-visible,
+.mint-picker__sort:focus-visible,
 .mint-picker__link:focus-visible {
   outline: none;
   box-shadow: var(--focus-ring-offset);
@@ -20669,6 +20692,14 @@ html.dark .mint-experiment-selector__filters-toggle--active {
 .mint-picker__list-head > span:nth-child(n + 3) {
   text-align: right;
 }
+.mint-picker__truncated {
+  margin: 0;
+  padding: 6px 12px;
+  border-bottom: 1px solid var(--border-light);
+  background: var(--bg-secondary);
+  font-size: 12px;
+  color: var(--text-secondary);
+}
 .mint-picker__row {
   box-sizing: border-box;
   height: 34px;

package/dist/types/auth.d.ts

@@ -25,6 +25,10 @@ export interface TokenVerifyResponse {
     valid: boolean;
     username: string | null;
     expires_at: string | null;
+    /** Platform 1.3+: `access_token` for a personal access token. */
+    token_type?: 'session' | 'access_token';
+    /** Platform 1.3+: true for a read-only personal access token. */
+    read_only?: boolean;
 }
 export interface RegisterRequest {
     username: string;

package/dist/types/components.d.ts

@@ -7,6 +7,8 @@ interface ActionMenuItemBase {
     label: string;
     disabled?: boolean;
     danger?: boolean;
+    /** Set on every item to make the menu a single choice (`menuitemradio`); true marks the current one. */
+    checked?: boolean;
 }
 export type ActionMenuItem = (ActionMenuItemBase & {
     href?: never;
@@ -14,6 +16,8 @@ export type ActionMenuItem = (ActionMenuItemBase & {
 }) | (ActionMenuItemBase & {
     href: string;
     target?: '_self' | '_blank' | '_parent' | '_top';
+    /** Links navigate; only buttons can be single-choice items. */
+    checked?: never;
 });
 export type InputType = 'text' | 'password' | 'email' | 'number' | 'search' | 'tel' | 'url';
 export type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';

package/dist/types/fileBrowserTypes.d.ts

@@ -75,3 +75,16 @@ export interface FileBrowserLocation {
     mount_id: string;
     path: string;
 }
+/** Several directory levels in one response, parents before children. */
+export interface FileDirectoryTree {
+    listings?: FileDirectoryListing[];
+    /** True when the server's entry budget stopped before the requested depth. */
+    truncated?: boolean;
+}
+/** Entries whose name contains a query, below one directory. */
+export interface FileSearchResult {
+    entries?: FileEntry[];
+    searched_directories?: number;
+    /** True when a directory, result or time budget ended the search early. */
+    truncated?: boolean;
+}

package/dist/types/filePicker.d.ts

@@ -3,6 +3,8 @@ export type PickerSource = 'server' | 'localFile';
 export type PickerSelectionMode = 'single-file' | 'multi-file' | 'folder' | 'folder+files';
 /** `list` shows one folder at a time (the default); `tree` adds disclosure triangles. */
 export type PickerView = 'list' | 'tree';
+/** Row order inside each folder; folders always come before files. */
+export type PickerSort = 'newest' | 'oldest' | 'name' | 'name-desc';
 interface PickerNodeBase {
     path: string;
     name: string;
@@ -38,6 +40,11 @@ export interface PickerRequest {
      */
     refresh?: true;
 }
+/** What a search found before a server or walk limit stopped it. */
+export interface PickerSearchResult {
+    nodes: PickerNode[];
+    truncated: boolean;
+}
 export interface PickerAdapter {
     /**
      * `listRoot()` returns mount points. FilePicker then shows them as header
@@ -53,7 +60,7 @@ export interface PickerAdapter {
     search(query: string, scope: {
         path: string;
         recursive: boolean;
-    }, request?: PickerRequest): Promise<PickerNode[]>;
+    }, request?: PickerRequest): Promise<PickerNode[] | PickerSearchResult>;
 }
 export interface PickerCapability {
     /** Case-insensitive suffixes, including compound extensions such as mzML.gz. */

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export type { ContainerDirection, ButtonVariant, ButtonSize, ActionMenuItem, Inp
 export type * from './generated-ui';
 export type { AnalysisArtifactStatus, AnalysisArtifactStatusFilter, AnalysisArtifactSummary, AnalysisArtifactDetail, AnalysisArtifactListResponse, AnalysisArtifactTarget, AnalysisArtifactMetadataUpdate, ArtifactSaveMode, ArtifactFileSource, JsonArtifactSavePayload, FileArtifactCreatePayload, FileArtifactUpdatePayload, HandlerFileArtifactCreatePayload, HandlerFileArtifactUpdatePayload, ArtifactSavePayload, HandlerArtifactSavePayload, ArtifactSaveDialogPayload, ArtifactSaveResult, ArtifactSaveHandler, HandlerArtifactSaveHandler, ArtifactSaveDialogHandler, } from './analysisArtifactTypes';
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from './analysisArtifactTypes';
-export type { FileBrowserLocation, FileBrowserSortKey, FileDirectoryListing, FileEntry, FileEntryKind, FilePathCrumb, FileSelection, ServerMount, } from './fileBrowserTypes';
+export type { FileBrowserLocation, FileBrowserSortKey, FileDirectoryListing, FileDirectoryTree, FileEntry, FileEntryKind, FilePathCrumb, FileSearchResult, FileSelection, ServerMount, } from './fileBrowserTypes';
 export type { JobListPayload, JobProgress, JobSnapshotPayload, JobState, JobStateInput, JobStatus, JobStreamData, } from './jobs';
 export type { InstrumentAlert, InstrumentAlertLevel, InstrumentAlertList, InstrumentBadgeState, InstrumentLiveProgress, InstrumentLiveStatus, InstrumentState, InstrumentStatus, InstrumentStatusReporter, SampleInfo, SampleInfo as InstrumentSampleInfo, SequenceProgress, } from './instrument';
 export type { LcmsContainerType, LcmsPolarity, LcmsSequenceItem, LcmsSequenceTableColumn, } from '../lcms';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morscherlab/mint-sdk",
-  "version": "1.3.0-beta.3",
+  "version": "1.3.0-beta.4",
   "description": "MINT Platform SDK — Vue 3 components, composables, and types for plugin development. MINT = Mass-spec INtegrated Toolkit.",
   "type": "module",
   "main": "./dist/index.js",

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/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__/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/)
+})

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

@@ -1,7 +1,7 @@
 import { afterEach, expect, it, vi } from 'vitest'
 import { effectScope, type EffectScope } from 'vue'
 import { usePickerNavigation } from '../../composables/filePicker/usePickerNavigation'
-import type { PickerAdapter, PickerNode } from '../../types/filePicker'
+import type { PickerAdapter, PickerNode, PickerSort } from '../../types/filePicker'
 
 const scopes: EffectScope[] = []
 afterEach(() => {
@@ -147,3 +147,63 @@ it('restarts prefetch after reopening even if old requests ignore cancellation',
   finish[4]!()
   await vi.advanceTimersByTimeAsync(100)
 })
+
+const dated = (kind: 'folder' | 'file', name: string, modifiedAt?: string): PickerNode =>
+  kind === 'folder'
+    ? { kind, path: name, name, modifiedAt }
+    : { kind, path: name, name, modifiedAt, format: 'raw' }
+const mixed = () => [
+  dated('file', 'b.raw', '2026-09-01T00:00:00Z'),
+  dated('folder', 'old', '2026-01-01T00:00:00Z'),
+  dated('file', 'a.raw', '2026-09-29T00:00:00Z'),
+  dated('folder', 'new', '2026-09-28T00:00:00Z'),
+  dated('file', 'undated.raw'),
+]
+async function sortedNames(sort: PickerSort | undefined) {
+  vi.useFakeTimers()
+  const adapter: PickerAdapter = {
+    listRoot: vi.fn(async () => mixed()),
+    listChildren: vi.fn(async () => []),
+    search: vi.fn(async () => []),
+  }
+  const scope = effectScope()
+  scopes.push(scope)
+  const nav = scope.run(() => usePickerNavigation(() => adapter, () => ({}), () => true, () => sort))!
+  await nav.load()
+  return nav.rows.value.map((row) => row.node.name)
+}
+
+it('should list folders first, newest first, when sorted by newest', async () => {
+  expect(await sortedNames('newest')).toEqual(['new', 'old', 'a.raw', 'b.raw', 'undated.raw'])
+})
+
+it('should list folders first, oldest first, when sorted by oldest', async () => {
+  expect(await sortedNames('oldest')).toEqual(['old', 'new', 'b.raw', 'a.raw', 'undated.raw'])
+})
+
+it('should list folders first by name when sorted by name', async () => {
+  expect(await sortedNames('name')).toEqual(['new', 'old', 'a.raw', 'b.raw', 'undated.raw'])
+})
+
+it('should list folders first by reverse name when sorted by name-desc', async () => {
+  expect(await sortedNames('name-desc')).toEqual(['old', 'new', 'undated.raw', 'b.raw', 'a.raw'])
+})
+
+it('should keep the adapter order when no sort is given', async () => {
+  expect(await sortedNames(undefined)).toEqual(['b.raw', 'old', 'a.raw', 'new', 'undated.raw'])
+})
+
+it('should show partial results and flag them when the adapter search is truncated', async () => {
+  const { nav, adapter } = setup([folder('a')])
+  vi.mocked(adapter.search).mockResolvedValueOnce({ nodes: [folder('a')], truncated: true })
+  await nav.load('a', true)
+  expect([nav.entries.value.length, nav.truncated.value]).toEqual([1, true])
+})
+
+it('should clear the truncated flag on the next plain listing', async () => {
+  const { nav, adapter } = setup([folder('a')])
+  vi.mocked(adapter.search).mockResolvedValueOnce({ nodes: [], truncated: true })
+  await nav.load('a', true)
+  await nav.load()
+  expect(nav.truncated.value).toBe(false)
+})

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

@@ -26,7 +26,10 @@ it('passes cancellation, marks offline mounts, and maps compound extensions', as
       ],
     })
     .mockResolvedValueOnce({
-      entries: [{ kind: 'file', path: 'run.mzML.gz', name: 'run.mzML.gz', size_bytes: 7 }],
+      listings: [{
+        mount_id: 'online', path: '',
+        entries: [{ kind: 'file', path: 'run.mzML.gz', name: 'run.mzML.gz', size_bytes: 7 }],
+      }],
     })
   const adapter = usePlatformFilePickerAdapter({ apiBaseUrl: '/api' })
   const signal = new AbortController().signal
@@ -42,7 +45,7 @@ it('passes cancellation, marks offline mounts, and maps compound extensions', as
   expect(get.mock.calls.every((call) => call[1].signal === signal)).toBe(true)
 })
 it('refuses truncated listings rather than returning a partial folder selection', async () => {
-  get.mockResolvedValue({ truncated: true, entries: [] })
+  get.mockResolvedValue({ listings: [{ mount_id: 'a', path: '', truncated: true, entries: [] }] })
   await expect(
     usePlatformFilePickerAdapter({ apiBaseUrl: '/api' }).listChildren(
       encodePlatformPickerPath('a'),
@@ -58,22 +61,22 @@ it('scopes shallow search to one level and recursive search skips offline mounts
             { id: 'b', label: 'NAS', available: false },
           ],
         }
-      : { entries: [{ kind: 'file', path: 'run.raw', name: 'run.raw', size_bytes: 1 }] },
+      : { listings: [{ mount_id: 'a', path: '', entries: [{ kind: 'file', path: 'run.raw', name: 'run.raw', size_bytes: 1 }] }] },
   )
   const adapter = usePlatformFilePickerAdapter({ apiBaseUrl: '/api' })
   expect(await adapter.search('run', { path: '', recursive: false })).toEqual([])
   expect(await adapter.search('run', { path: '', recursive: true })).toHaveLength(1)
-  expect(get.mock.calls.filter((call) => call[0].includes('/browse'))).toHaveLength(1)
+  expect(get.mock.calls.filter((call) => call[0].includes('/tree'))).toHaveLength(1)
 })
 it('forwards explicit refresh to mount browsing and supports a scoped root', async () => {
-  get.mockResolvedValue({ entries: [] })
+  get.mockResolvedValue({ listings: [{ mount_id: 'raw', path: 'study', entries: [] }] })
   const adapter = usePlatformFilePickerAdapter({
     apiBaseUrl: '/api', rootLocation: { mount_id: 'raw', path: 'study' },
   })
   const signal = new AbortController().signal
   await adapter.listRoot({ refresh: true, signal })
   expect(get).toHaveBeenCalledExactlyOnceWith(
-    '/filesystem/browse?mount_id=raw&path=study&refresh=true', { signal },
+    '/filesystem/tree?mount_id=raw&path=study&refresh=true', { signal },
   )
 })
 it('forwards a mount-list refresh so server directory snapshots are invalidated too', async () => {
@@ -83,3 +86,12 @@ it('forwards a mount-list refresh so server directory snapshots are invalidated
   await adapter.listRoot({ refresh: true, signal })
   expect(get).toHaveBeenCalledExactlyOnceWith('/filesystem/mounts?refresh=true', { signal })
 })
+
+it('should search a folder on the server with the query and scope', async () => {
+  get.mockResolvedValue({ entries: [], truncated: false })
+  await usePlatformFilePickerAdapter({ apiBaseUrl: '/api' })
+    .search('run', { path: encodePlatformPickerPath('raw', 'study'), recursive: false })
+  expect(get).toHaveBeenCalledExactlyOnceWith(
+    '/filesystem/search?mount_id=raw&path=study&q=run&recursive=false', { signal: undefined },
+  )
+})

package/src/components/ActionMenu.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 /** Compact overflow actions with an IconButton trigger and a viewport-safe teleported menu. */
 import { computePosition, flip, offset, shift } from '@floating-ui/dom'
-import { Ellipsis } from 'lucide-vue-next'
+import { Check, Ellipsis } from 'lucide-vue-next'
 import { nextTick, onMounted, ref, watch } from 'vue'
 import { useDropdownState } from '../composables/useDropdownState'
 import { useMenuKeyboard } from '../composables/useMenuKeyboard'
@@ -167,10 +167,18 @@ watch(isOpen, async (opened) => {
           v-else
           type="button"
           :class="['mint-menu-item mint-action-menu__item', { 'mint-menu-item--danger mint-action-menu__item--danger': item.danger }]"
-          role="menuitem"
+          :role="item.checked === undefined ? 'menuitem' : 'menuitemradio'"
+          :aria-checked="item.checked"
           :disabled="item.disabled"
           @click="handleSelect(item)"
         >
+          <Check
+            v-if="item.checked !== undefined"
+            class="mint-action-menu__check"
+            :class="{ 'mint-action-menu__check--off': !item.checked }"
+            :size="14"
+            aria-hidden="true"
+          />
           {{ item.label }}
         </button>
       </template>

package/src/components/FilePicker.vue

@@ -12,6 +12,7 @@ import { computed, ref, useTemplateRef } from 'vue'
 import BaseModal from './BaseModal.vue'
 import BaseButton from './BaseButton.vue'
 import BaseInput from './BaseInput.vue'
+import ActionMenu from './ActionMenu.vue'
 import SegmentedControl from './SegmentedControl.vue'
 import FileUploader from './FileUploader.vue'
 import FilePickerListInternal from './internal/FilePickerListInternal.vue'
@@ -24,6 +25,7 @@ import type {
   PickerNode,
   PickerSelection,
   PickerSelectionMode,
+  PickerSort,
   PickerSource,
   PickerView,
 } from '../types/filePicker'
@@ -39,6 +41,8 @@ interface Props {
   title?: string
   /** `list` shows one folder at a time; `tree` adds disclosure triangles. */
   view?: PickerView
+  /** Row order on each open; the user can change it from the path bar until closing. */
+  defaultSort?: PickerSort
   /** Host-owned visibility/selection filter; backend must still enforce access. */
   systemFilter?: (node: PickerNode, source: PickerSource) => boolean
 }
@@ -50,6 +54,7 @@ const props = withDefaults(defineProps<Props>(), {
   initialSelection: null,
   title: 'Choose data',
   view: 'list',
+  defaultSort: 'newest',
 })
 const emit = defineEmits<{
   'update:open': [open: boolean]
@@ -68,6 +73,7 @@ const {
   source,
   query,
   recursive,
+  sort,
   skipBlanks,
   reviewing,
   nav,
@@ -109,6 +115,19 @@ const sourceLabel = computed(() => {
   }
   return mounts.value.find((item) => item.path === props.adapter.mountOf?.(node.path))?.name ?? sourceNames.server
 })
+const SORT_LABELS: Record<PickerSort, string> = {
+  newest: 'Newest first',
+  oldest: 'Oldest first',
+  name: 'Name A–Z',
+  'name-desc': 'Name Z–A',
+}
+const sortItems = computed(() =>
+  (Object.keys(SORT_LABELS) as PickerSort[]).map((id) => ({
+    id,
+    label: SORT_LABELS[id],
+    checked: sort.value === id,
+  })),
+)
 const accepts = computed(() =>
   (capability.value?.formats ?? []).map((format) => `.${format.replace(/^\./, '')}`).join(' '),
 )
@@ -198,6 +217,28 @@ const summary = computed(() => {
           </template>
         </nav>
         <span v-if="accepts" class="mint-picker__accepts">Accepts {{ accepts }}</span>
+        <ActionMenu
+          label="Sort"
+          :items="sortItems"
+          @select="sort = $event.id as PickerSort"
+        >
+          <template #trigger="{ open: menuOpen, toggle, keydown }">
+            <button
+              type="button"
+              class="mint-picker__sort"
+              aria-haspopup="menu"
+              :aria-expanded="menuOpen"
+              :aria-label="`Sort: ${SORT_LABELS[sort]}`"
+              @click="toggle"
+              @keydown="keydown"
+            >
+              {{ SORT_LABELS[sort] }}
+              <svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true">
+                <path d="M4 6l4 4 4-4" />
+              </svg>
+            </button>
+          </template>
+        </ActionMenu>
         <button
           type="button"
           class="mint-picker__scope"
@@ -255,6 +296,7 @@ const summary = computed(() => {
             :loading="loading"
             :error="error"
             :query="query"
+            :truncated="nav.truncated.value"
             :mode="selectionMode"
             :selected="selection.selected"
             :selectable="selection.selectable"