fsbrowser

type Column struct {
	Header    string
	Width     float32
	Resizable bool
	// Cell draws the cell for e. Emit labels Selectable(false): the row's
	// click sense sits behind its cells, and a selectable label would take
	// the click.
	Cell func(e Entry)
	// WidthType discriminates this column for width persistence (ADR-0151
	// keys the column tier on name and render type); empty means "host".
	WidthType string
}

type Entry struct {
	// Name is the base name; Path the io/fs path from the root ("a/b/c").
	Name string
	Path string
	// IsDir and IsSymlink come off the entry's type bits — a symlink is
	// reported as recorded, not resolved, which is the Lstat reading an
	// [fs.ReadDirFS] gives.
	IsDir     bool
	IsSymlink bool
	Size      int64
	ModTime   time.Time
	Mode      fs.FileMode
	// InfoErr is the error [fs.DirEntry.Info] returned, when it did; the entry
	// still lists, with zero size and time, because a name that cannot be
	// stat'ed is still a name.
	InfoErr error
	// Ord is the entry's ordinal in its directory's listing, stable for as
	// long as the listing is cached. Widget ids key on it, so sorting and
	// filtering move rows without moving identities.
	Ord int
}

type Input struct {
	Ids      *c.WidgetIdStack
	ScopeKey string
	// FS is the tree to browse. nil renders a placeholder.
	FS fs.FS
	// RootLabel names the root in the breadcrumb ("/" when empty).
	RootLabel string
	// CacheKey scopes the directory cache; a change drops it and the
	// selection and keeps the directory.
	CacheKey string
	State    *State
	Mode     ModeE
	Columns  []Column
	// ShowHidden includes dot-names.
	ShowHidden bool
	// RowHeight, MaxHeight and Striped are passed to the table; zero means
	// the defaults (one text line; fill; plain).
	RowHeight float32
	MaxHeight float32
	Striped   bool
	// HideBreadcrumb and HideFilter drop those rows when the host draws its
	// own location and filter chrome.
	HideBreadcrumb bool
	HideFilter     bool
	// Widths persists the columns' widths (ADR-0151): the widget resolves
	// them through the resolver before the table is emitted and reports the
	// table's settled widths back after, under WidthTag (ScopeKey when
	// empty). The host flushes the resolver once per frame. nil keeps the
	// defaults and persists nothing.
	Widths   *colwidth.Resolver
	WidthTag string
}

type ModeE uint8

type Result struct {
	// Rows is what was shown: the filtered, sorted listing in list mode, one
	// entry per outline node in outline mode. Indices below refer to it. The
	// slice is the State's scratch and is valid until the next Render; a host
	// that keeps entries copies them.
	Rows []Entry
	// Clicked is the row clicked this frame, -1 for none.
	Clicked int
	// Activated is the file row double-clicked or Enter-ed, -1 for none. A
	// directory activation is consumed by the widget (entered or toggled)
	// and reported as Navigated instead.
	Activated int
	// Navigated is true when the current directory changed this frame.
	Navigated bool
	// SelectionChanged is true when the selection or cursor moved.
	SelectionChanged bool
	Err              error
}

type SortByE uint8

type State struct {
	// contains filtered or unexported fields
}