@morscherlab/mint-sdk 1.2.0-beta.11 → 1.2.0-beta.13

package/src/styles/components/file-picker.css

@@ -0,0 +1,501 @@
+/* Unified picker: search-first header, Finder tree, metadata preview and receipt. */
+.mint-picker-dialog {
+  width: 800px;
+}
+.mint-picker-dialog .mint-file-browser-dialog__header {
+  padding: 15px 18px;
+  gap: 12px;
+}
+.mint-picker-dialog .mint-file-browser-dialog__footer {
+  padding: 12px 18px;
+  background: var(--bg-primary);
+}
+.mint-picker__search {
+  display: flex;
+  align-items: center;
+  position: relative;
+  flex: 1;
+  min-width: 0;
+}
+.mint-picker__search > svg {
+  position: absolute;
+  left: 12px;
+  width: 16px;
+  height: 16px;
+  color: var(--text-muted);
+  pointer-events: none;
+}
+.mint-picker__search .mint-input {
+  width: 100%;
+  padding-left: 36px;
+  padding-right: 36px;
+  background: var(--bg-primary);
+  font-size: 13px;
+}
+.mint-picker__search > kbd {
+  position: absolute;
+  right: 12px;
+  font-family: var(--font-mono);
+  font-size: 11px;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-sm);
+  padding: 1px 5px;
+  color: var(--text-secondary);
+  background: var(--bg-secondary);
+}
+.mint-picker__sources {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: 2px;
+  background: var(--bg-primary);
+  padding: 2px;
+  border-radius: var(--radius-md);
+  flex-shrink: 0;
+}
+.mint-picker {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+.mint-picker__pathbar {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 7px 18px;
+  border-block: 1px solid var(--border-color);
+  background: var(--bg-primary);
+  flex-shrink: 0;
+}
+.mint-picker__breadcrumbs {
+  display: flex;
+  align-items: center;
+  min-width: 0;
+  flex: 1;
+  overflow-x: auto;
+  color: var(--text-muted);
+}
+.mint-picker__breadcrumbs .mint-button {
+  font-family: var(--font-mono);
+  font-size: 11px;
+  padding-inline: 5px;
+  flex-shrink: 0;
+}
+.mint-picker__scope {
+  font-size: 11px;
+  flex-shrink: 0;
+}
+.mint-picker__scope[aria-pressed='true'] {
+  color: var(--color-primary);
+  background: var(--color-primary-soft);
+}
+.mint-picker__workspace {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) 208px;
+  height: 344px;
+  min-height: 0;
+}
+.mint-picker__tree {
+  padding: 7px;
+  background: var(--bg-primary);
+  overflow-y: auto;
+  min-height: 0;
+  min-width: 0;
+}
+.mint-picker__row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-height: 40px;
+  padding: 5px 10px 5px calc(2px + var(--picker-depth, 0) * 14px);
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  margin-bottom: 2px;
+  border: 1px solid transparent;
+}
+.mint-picker__row:hover {
+  background: var(--bg-hover);
+}
+.mint-picker__row--selected,
+.mint-picker__row--selected:hover {
+  background: var(--color-primary-soft);
+  border-color: color-mix(in srgb, var(--color-primary) 40%, transparent);
+  color: var(--text-primary);
+}
+.mint-picker__row:focus-visible {
+  outline: none;
+  box-shadow: inset 0 0 0 2px var(--color-primary);
+}
+.mint-picker__row--child {
+  min-height: 30px;
+  padding-block: 1px;
+}
+.mint-picker__disclosure {
+  flex-shrink: 0;
+}
+.mint-picker__disclosure-spacer {
+  width: var(--form-height-sm);
+  flex-shrink: 0;
+}
+.mint-picker__disclosure svg {
+  width: 10px;
+  height: 10px;
+  transition: transform 120ms;
+}
+.mint-picker__chevron--open {
+  transform: rotate(90deg);
+}
+.mint-picker__node-icon {
+  width: 16px;
+  height: 16px;
+  flex-shrink: 0;
+  color: var(--text-muted);
+}
+.mint-picker__row--selected .mint-picker__node-icon {
+  color: var(--color-primary);
+}
+.mint-picker__row-name {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+}
+.mint-picker__name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 13px;
+}
+.mint-picker__row--selected .mint-picker__name {
+  font-weight: 600;
+}
+.mint-picker__name mark {
+  background: color-mix(in srgb, var(--mint-warning) 32%, transparent);
+  color: inherit;
+  border-radius: 2px;
+}
+.mint-picker__formats {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+}
+.mint-picker__formats > span {
+  color: var(--text-secondary);
+  background: var(--bg-secondary);
+  padding: 1px 4px;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-sm);
+  font: 10px var(--font-mono);
+}
+.mint-picker__row-meta {
+  display: flex;
+  align-items: flex-end;
+  flex-direction: column;
+  gap: 3px;
+  flex-shrink: 0;
+  font: 10px var(--font-mono);
+  color: var(--text-muted);
+}
+.mint-picker__partial {
+  background: var(--mint-warning-bg);
+  color: var(--mint-warning-text);
+  padding: 2px 5px;
+  border-radius: var(--radius-sm);
+}
+.mint-picker__parent-name {
+  font: 10px var(--font-mono);
+  color: var(--text-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mint-picker__row--unreadable,
+.mint-picker__row--unreadable:hover {
+  cursor: not-allowed;
+  color: var(--text-muted);
+  background: repeating-linear-gradient(
+    135deg,
+    transparent,
+    transparent 5px,
+    color-mix(in srgb, var(--text-muted) 6%, transparent) 5px,
+    color-mix(in srgb, var(--text-muted) 6%, transparent) 10px
+  );
+}
+.mint-picker__row--unreadable .mint-picker__name {
+  text-decoration: line-through;
+}
+.mint-picker__branch-error {
+  padding: 6px 12px;
+  color: var(--mint-error);
+  font-size: 12px;
+}
+.mint-picker__skeleton {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 8px;
+}
+.mint-picker__empty {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  gap: 12px;
+  min-height: 180px;
+  padding: 24px;
+  font-size: 12px;
+  color: var(--text-secondary);
+  text-align: center;
+}
+.mint-picker__preview {
+  border-left: 1px solid var(--border-color);
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  background: var(--bg-secondary);
+}
+.mint-picker__preview-heading {
+  padding: 10px 13px;
+  border-bottom: 1px solid var(--border-color);
+  font-size: 10px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  color: var(--text-muted);
+}
+.mint-picker__preview-content {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 14px 13px;
+  overflow-y: auto;
+  min-height: 0;
+  flex: 1;
+}
+.mint-picker__preview-icon {
+  display: grid;
+  place-items: center;
+  width: 52px;
+  height: 52px;
+  flex-shrink: 0;
+  border-radius: 13px;
+  background: linear-gradient(135deg, var(--color-primary), var(--color-purple));
+  color: white;
+  margin: 0 auto;
+}
+.mint-picker__preview-icon svg {
+  width: 26px;
+  height: 26px;
+}
+.mint-picker__preview-name {
+  font-size: 12px;
+  text-align: center;
+  overflow-wrap: anywhere;
+}
+.mint-picker__metadata {
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+  margin: 0;
+  font-size: 11px;
+}
+.mint-picker__metadata > div {
+  display: grid;
+  grid-template-columns: 44px minmax(0, 1fr);
+  gap: 5px;
+}
+.mint-picker__metadata dt {
+  color: var(--text-muted);
+}
+.mint-picker__metadata dd {
+  margin: 0;
+  font: 10px/1.5 var(--font-mono);
+  overflow-wrap: anywhere;
+}
+.mint-picker__ready {
+  margin-top: auto;
+  border: 1px solid var(--mint-success);
+  border-radius: 999px;
+  background: var(--mint-success-bg);
+  color: var(--mint-success-hover);
+  text-align: center;
+  padding: 4px;
+  font-size: 10px;
+}
+.mint-picker__preview-empty {
+  color: var(--text-muted);
+  font-size: 12px;
+  text-align: center;
+  padding: 32px 16px;
+}
+.mint-picker__skipped {
+  background: var(--mint-warning-bg);
+  color: var(--mint-warning-text);
+  white-space: normal;
+}
+.mint-picker__exclusion {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 11px;
+  overflow-wrap: anywhere;
+  padding-bottom: 8px;
+  border-bottom: 1px solid var(--border-color);
+}
+.mint-picker__exclusion span {
+  color: var(--text-muted);
+}
+.mint-picker__preview-error {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  font-size: 11px;
+  color: var(--mint-error);
+}
+.mint-picker__footer {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  width: 100%;
+}
+.mint-picker__receipt {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex: 1;
+  min-width: 0;
+  flex-wrap: wrap;
+  font-size: 11px;
+  color: var(--text-secondary);
+}
+.mint-picker__receipt > span {
+  overflow-wrap: anywhere;
+}
+.mint-picker__badge {
+  padding: 3px 7px;
+  border-radius: var(--radius-sm);
+  color: var(--color-primary);
+  border: 1px solid color-mix(in srgb, var(--color-primary) 40%, transparent);
+  background: var(--color-primary-soft);
+  font: 10px var(--font-mono);
+}
+.mint-picker__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+.mint-picker__local-actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 14px;
+  flex-shrink: 0;
+}
+.mint-picker__local-actions > span {
+  color: var(--text-muted);
+  font-size: 11px;
+}
+@media (max-width: 600px) {
+  .mint-picker-dialog .mint-file-browser-dialog__header {
+    padding: 10px;
+    gap: 6px;
+    flex-wrap: nowrap;
+  }
+  .mint-picker__search .mint-input {
+    font-size: 12px;
+    padding-right: 8px;
+  }
+  .mint-picker__search > kbd {
+    display: none;
+  }
+  .mint-picker__pathbar {
+    padding-inline: 8px;
+    gap: 2px;
+  }
+  .mint-picker__workspace {
+    grid-template-columns: minmax(0, 1fr);
+    height: 390px;
+  }
+  .mint-picker__preview {
+    display: none;
+  }
+  .mint-picker__workspace:has(.mint-picker__exclusion) {
+    grid-template-columns: minmax(0, 1fr) 160px;
+  }
+  .mint-picker__workspace:has(.mint-picker__exclusion) .mint-picker__preview {
+    display: flex;
+  }
+  .mint-picker__row {
+    gap: 4px;
+    padding-right: 5px;
+  }
+  .mint-picker__name {
+    font-size: 12px;
+  }
+  .mint-picker__footer {
+    align-items: stretch;
+    flex-direction: column;
+    gap: 8px;
+  }
+  .mint-picker__actions {
+    justify-content: flex-end;
+  }
+  .mint-picker__receipt {
+    min-height: 24px;
+  }
+}
+@media (max-height: 600px) {
+  .mint-picker {
+    overflow-y: auto;
+  }
+  .mint-picker__workspace {
+    min-height: 220px;
+  }
+}
+
+/* The source highlight slides between fixed-size SDK icon buttons. */
+.mint-picker__source-indicator {
+  box-sizing: border-box;
+  position: absolute;
+  inset: 2px auto 2px 2px;
+  width: 32px;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  background: var(--bg-secondary);
+  box-shadow: var(--shadow-sm);
+  pointer-events: none;
+  transform: translateX(calc(var(--picker-source-index, 0) * 34px));
+  transition: transform 180ms ease-out;
+}
+.mint-picker__sources .mint-icon-button {
+  position: relative;
+  width: 32px;
+  height: 32px;
+}
+.mint-picker__sources .mint-icon-button[aria-pressed='true'] {
+  color: var(--text-primary);
+  background: transparent;
+}
+.mint-picker__source-panel {
+  animation: mint-picker-source-in 180ms ease-out;
+}
+@keyframes mint-picker-source-in {
+  from {
+    opacity: 0;
+    transform: translateY(4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .mint-picker__source-indicator {
+    transition: none;
+  }
+  .mint-picker__source-panel {
+    animation: none;
+  }
+}

package/src/styles/index.css

@@ -90,6 +90,7 @@
 @import './components/experiment-code-badge.css';
 @import './components/experiment-selector-modal.css';
 @import './components/artifact-selector-modal.css';
+@import './components/file-browser-modal.css';
 @import './components/artifact-save-dialog.css';
 @import './components/experiment-popover.css';
 @import './components/fit-panel.css';
@@ -100,3 +101,5 @@
 @import './components/mobile-support-gate.css';
 @import './components/plugin-icon.css';
 @import './components/reagent-editor.css';
+
+@import './components/file-picker.css';

package/src/types/fileBrowserTypes.ts

@@ -0,0 +1,85 @@
+/**
+ * Types for browsing read-only server mounts.
+ *
+ * These mirror the `mint_sdk.filesystem` wire models. MINT records the path of
+ * data that already sits on a mount; it never copies it.
+ */
+
+/** What a listing row is. */
+export type FileEntryKind = 'file' | 'directory'
+
+/** Field a listing is ordered by, after directories are grouped first. */
+export type FileBrowserSortKey = 'name' | 'size' | 'modified'
+
+/** One read-only directory tree exposed by the server. */
+export interface ServerMount {
+  id: string
+  label: string
+  read_only?: boolean
+  /** False when the mount is configured but currently unreachable. */
+  available?: boolean
+  /** Child mounts, used to render the sidebar tree. */
+  children?: ServerMount[]
+  /** Item count shown beside the mount; free-form so callers can send "1.2k". */
+  count?: string | number
+}
+
+/** One step of the trail from a mount root to the current directory. */
+export interface FilePathCrumb {
+  label: string
+  path: string
+}
+
+/** A single file or directory inside a mount. */
+export interface FileEntry {
+  name: string
+  /** Mount-relative POSIX path. */
+  path: string
+  kind: FileEntryKind
+  /** Null for directories. */
+  size_bytes?: number | null
+  modified_at?: string | null
+  extension?: string
+  /**
+   * False when the entry fails the active type rules. Non-matching entries are
+   * still listed — they dim rather than vanish.
+   */
+  matches_type_rules?: boolean
+  /** Directories only. */
+  child_count?: number | null
+}
+
+/** The contents of one directory inside a mount. */
+export interface FileDirectoryListing {
+  mount_id: string
+  path: string
+  /** Null at the mount root. */
+  parent?: string | null
+  breadcrumbs?: FilePathCrumb[]
+  entries?: FileEntry[]
+  /** Directory size before any search filter. */
+  total_count?: number
+  /** How many entries satisfy the type rules. */
+  match_count?: number
+  /** How many entries this response carries, after search and any cap. */
+  shown_count?: number
+  /** True when the directory held more entries than the server will return. */
+  truncated?: boolean
+}
+
+/** One item the user has picked. */
+export interface FileSelection {
+  mount_id: string
+  path: string
+  name: string
+  kind: FileEntryKind
+  /** For a directory pick, how many files it contains. */
+  child_count?: number | null
+  size_bytes?: number | null
+}
+
+/** Where the user is standing in the browser. */
+export interface FileBrowserLocation {
+  mount_id: string
+  path: string
+}

package/src/types/filePicker.ts

@@ -0,0 +1,65 @@
+/** Sources are supplied by the host; the SDK never infers a host filesystem path. */
+export type PickerSource = 'server' | 'localFile'
+export type PickerSelectionMode = 'single-file' | 'multi-file' | 'folder' | 'folder+files'
+
+interface PickerNodeBase {
+  path: string
+  name: string
+  parentPath?: string | null
+  parentName?: string
+  bytes?: number | null
+  /** An explicit adapter failure makes a row inert, including its disclosure. */
+  unavailableReason?: string
+}
+export interface PickerFolder extends PickerNodeBase {
+  kind: 'folder'
+  fileCount?: number | null
+  formats?: Record<string, number>
+  hasChildren?: boolean
+}
+export interface PickerFile extends PickerNodeBase {
+  kind: 'file'
+  format: string
+  /** Present only for browser-selected files. The picker does not read its bytes. */
+  file?: File
+}
+export type PickerNode = PickerFolder | PickerFile
+export interface PickerRequest {
+  signal?: AbortSignal
+  source?: PickerSource
+}
+export interface PickerAdapter {
+  listRoot(request?: PickerRequest): Promise<PickerNode[]>
+  listChildren(path: string, request?: PickerRequest): Promise<PickerNode[]>
+  search(
+    query: string,
+    scope: { path: string; recursive: boolean },
+    request?: PickerRequest,
+  ): Promise<PickerNode[]>
+}
+export interface PickerCapability {
+  /** Case-insensitive suffixes, including compound extensions such as mzML.gz. */
+  formats: string[]
+  maxBytes?: number
+  /** Optional host-owned blank classification; no filename heuristics in the SDK. */
+  isBlank?: (node: PickerNode) => boolean
+}
+export type PickerCapabilities = Partial<Record<PickerSource, PickerCapability>>
+export type PickerExclusionReason =
+  'deselected' | 'unsupported' | 'tooLarge' | 'blank' | 'unreadable'
+export interface PickerExcluded {
+  /** Opaque identity prevents collisions between equal filenames in different folders. */
+  path: string
+  name: string
+  reason: PickerExclusionReason
+}
+export type PickerSelection =
+  | { source: 'server'; folders: string[]; files: PickerFile[]; excluded: PickerExcluded[] }
+  | { source: 'localFile'; files: File[] }
+export interface PickerTreeRow {
+  node: PickerNode
+  depth: number
+  expanded: boolean
+  loading: boolean
+  error?: string
+}

package/src/types/index.ts

@@ -208,6 +208,18 @@ export type {
 } from './analysisArtifactTypes'
 export { ANALYSIS_FILE_ARTIFACT_SCHEMA } from './analysisArtifactTypes'
 
+// File browser types
+export type {
+  FileBrowserLocation,
+  FileBrowserSortKey,
+  FileDirectoryListing,
+  FileEntry,
+  FileEntryKind,
+  FilePathCrumb,
+  FileSelection,
+  ServerMount,
+} from './fileBrowserTypes'
+
 export type {
   JobListPayload,
   JobProgress,
@@ -297,3 +309,5 @@ export type {
   TableDensity,
   UserSummary,
 } from './platform'
+
+export type * from './filePicker'