/**
 * 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
}

/** 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
}