package mujica import ( "log/slog" "github.com/egoist/mygo/ui" "mujicaui/icons" "mujicaui/internal" "mujicaui/theme" ) // TreeOptions configure a Tree of items of type K, which are also their keys. type TreeOptions[K comparable] struct { Roots []K // Children returns an item's children: nil for a leaf, empty while unloaded; required. Children func(item K) []K // Label returns an item's text, read out and matched by typing; required. Label func(item K) string // ItemStatus returns the load state of an item's children; nil means loaded. ItemStatus func(item K) DataStatus // Load asks for an item's children when it opens DataUnloaded, and on retry. Load func(item K) Multiple bool // Empty replaces the built-in "No items" text. Empty string Status DataStatus Error string } // TreeState is a Tree's open items, selection and place. type TreeState[K comparable] struct { // Selection holds the chosen items of a Multiple tree. Selection ui.Selection[K] tree treeCore[K] } // Selected returns the chosen item, or the last chosen of a Multiple tree. func (s *TreeState[K]) Selected() (K, bool) { return s.tree.sel, s.tree.has } // SetOpen opens or closes an item. func (s *TreeState[K]) SetOpen(item K, open bool) { s.tree.setOpen(item, open) } // IsOpen reports whether an item shows its children. func (s *TreeState[K]) IsOpen(item K) bool { return s.tree.outline.Open.Has(item) } // treeCore is the outline state shared by Tree and TreeTable. type treeCore[K comparable] struct { outline ui.OutlineState[K] cursor int started bool sel K has bool // asked holds the open items whose children Load was asked for. asked map[K]bool } func (t *treeCore[K]) setOpen(item K, open bool) { if open { t.outline.Open.Add(item) } else { t.outline.Open.Remove(item) } } // begin wires the outline's selection before it is built. func (t *treeCore[K]) begin(label func(K) string, sel *ui.Selection[K], multiple bool) { if !t.started { t.started, t.cursor, t.asked = true, -1, map[K]bool{} } t.outline.List.Selected = &t.cursor t.outline.List.Label = func(i int) string { return label(t.outline.Item(i)) } t.outline.List.Selection = nil if multiple { t.outline.List.Selection = sel } } // clear drops the choice and row state when the tree has no items. func (t *treeCore[K]) clear(sel *ui.Selection[K]) { var zero K t.cursor, t.sel, t.has = -1, zero, false sel.Clear() clear(t.asked) t.outline = ui.OutlineState[K]{Open: t.outline.Open} } // end reads a new choice, or finds the chosen item again after rows moved. func (t *treeCore[K]) end(c *ui.Context, changed bool) { rows := t.outline.Rows() at := t.cursor >= 0 && t.cursor < rows if changed || !t.has { t.has = at if at { t.sel = t.outline.Item(t.cursor) } return } if at && t.outline.Item(t.cursor) == t.sel { return } t.cursor = -1 for i := range rows { if t.outline.Item(i) == t.sel { t.cursor = i break } } if t.cursor < 0 { t.has = false return } // The rows showed the old place: build them again at the new one. c.Invalidate() slog.Debug("mujica: tree selection moved", "row", t.cursor) } // chosen reports whether item shows as chosen. func (t *treeCore[K]) chosen(item K, sel *ui.Selection[K], multiple bool) bool { if multiple { return sel.Has(item) } return t.has && t.sel == item } // itemStatus asks for unloaded children of an open item and shows loading or failure. func (t *treeCore[K]) itemStatus(c *ui.Context, item K, status func(K) DataStatus, load func(K)) { if status == nil { return } st := status(item) open := t.outline.Open.Has(item) if st != DataUnloaded || !open { delete(t.asked, item) } if st == DataUnloaded && open && !t.asked[item] { if load == nil { panic("mujica: tree item unloaded without Load") } t.asked[item] = true slog.Debug("mujica: tree load", "item", item) load(item) } k := Tokens(c) u := Density(c).Unit() switch st { case DataLoading: Spinner(c, SpinnerOptions{Size: 14, Label: msg(c, "list.loading"), ShowLabel: true}) case DataFailed: ui.Row(c).Gap(u).AlignItems(ui.Center).TextColor(k.Danger).Children(func() { ui.Icon(c, icons.Must("circle-alert")).Size(14, 14) ui.Text(c, msg(c, "list.failed")).FontSize(FontSize(c, theme.CaptionSize)).SingleLine() }) if Button(c, msg(c, "list.retry"), ButtonOptions{Variant: Ghost}).MinHeight(theme.MinHitSize).Clicked() { slog.Debug("mujica: tree retry", "item", item) load(item) } } } // TreeView is a built Tree and what happened to it in this frame. type TreeView struct { Element *ui.Element changed, submitted, retry bool } // Changed reports a new selection. func (v TreeView) Changed() bool { return v.changed } // Submitted reports Enter or a double click on an item. func (v TreeView) Submitted() bool { return v.submitted } // Retried reports a click on the retry action of a failed first load. func (v TreeView) Retried() bool { return v.retry } // Tree shows items in a hierarchy, building only the rows in view. func Tree[K comparable](c *ui.Context, s *TreeState[K], opts TreeOptions[K]) TreeView { if opts.Children == nil || opts.Label == nil { panic("mujica: Tree needs Children and Label") } k := Tokens(c) d := Density(c) u := d.Unit() t := &s.tree t.begin(opts.Label, &s.Selection, opts.Multiple) var v TreeView v.Element = ui.Column(c).MinHeight(0) v.Element.Children(func() { if len(opts.Roots) == 0 { t.clear(&s.Selection) v.retry = dataPlaceholder(c, opts.Status, opts.Error, opts.Empty, msg(c, "list.empty")) return } // Outline rows pad by one unit above and below. h := d.ControlHeight() - 2*c.Theme().Space(1) restore := dataSelectTheme(c, 0) e := ui.Outline(c, &t.outline, opts.Roots, opts.Children, func(item K) { ui.Row(c).Grow(1).MinWidth(0).MinHeight(h).Gap(u * 2).AlignItems(ui.Center).Children(func() { ui.Text(c, opts.Label(item)).SingleLine().Grow(1).MinWidth(0) t.itemStatus(c, item, opts.ItemStatus, opts.Load) if t.chosen(item, &s.Selection, opts.Multiple) { ui.Icon(c, icons.Must("check")).Size(16, 16).Shrink(0).TextColor(k.AccentText) } }) }) restore() e.Grow(1).MinHeight(0).Padding(u).Background(k.Surface).Border(theme.BorderWidth, k.Border).Radius(theme.ControlRadius) internal.Ring(e, k.Focus, theme.ControlRadius) v.changed, v.submitted = e.Changed(), e.Submitted() v.retry = dataFooter(c, opts.Status, opts.Error) }) if len(opts.Roots) > 0 { t.end(c, v.changed) } if v.changed { slog.Debug("mujica: tree changed", "row", t.cursor, "count", s.Selection.Len()) } return v }