Add Bubble Tea TUI with interactive treemap

Cell canvas renderer with frame cache and a perceptual 256-colour quantizer; responsive geometry (large/medium/small/too-small); squarified treemap with nested previews, LOD grouping, category colouring and adaptive labels; spatial arrow navigation with stable NodeID selection; zoom and breadcrumbs; modal system (info, help, confirm, save); list, file-type, top-N, scan-info, duplicate and comparison views; live search/filter; mouse support; move-to-trash.
2026-10-02 08:25:35 +01:00
parent e8c831cb47
commit df8b10c6dd
35 changed files with 5294 additions and 25 deletions
@@ -0,0 +1,113 @@
+package platform
+
+import (
+	"errors"
+	"fmt"
+	"net/url"
+	"os"
+	"path/filepath"
+	"strconv"
+	"syscall"
+	"time"
+)
+
+// TrashName is the user-facing name of the trash.
+const TrashName = "trash"
+
+// Reveal opens the item's directory in the desktop file manager.
+func Reveal(path string) error {
+	if err := checkAbs(path); err != nil {
+		return err
+	}
+	fi, err := os.Lstat(path)
+	if err == nil && !fi.IsDir() {
+		path = filepath.Dir(path)
+	}
+	return startDetached("xdg-open", path)
+}
+
+// Trash moves path to the freedesktop.org trash: the home trash when on the
+// same filesystem, otherwise $topdir/.Trash-$uid on the item's filesystem.
+// It never copies across filesystems and never deletes.
+func Trash(path string) error {
+	if err := checkAbs(path); err != nil {
+		return err
+	}
+	st, err := os.Lstat(path)
+	if err != nil {
+		return err
+	}
+	dev := st.Sys().(*syscall.Stat_t).Dev
+	dataHome := os.Getenv("XDG_DATA_HOME")
+	if dataHome == "" {
+		home, err := os.UserHomeDir()
+		if err != nil {
+			return err
+		}
+		dataHome = filepath.Join(home, ".local", "share")
+	}
+	home := filepath.Join(dataHome, "Trash")
+	var trash, infoPath string
+	if hs, err := os.Stat(dataHome); err == nil && hs.Sys().(*syscall.Stat_t).Dev == dev {
+		trash, infoPath = home, path
+	} else {
+		top := mountTop(path, dev)
+		trash = filepath.Join(top, ".Trash-"+strconv.Itoa(os.Getuid()))
+		rel, err := filepath.Rel(top, path)
+		if err != nil {
+			return err
+		}
+		infoPath = rel
+	}
+	files, info := filepath.Join(trash, "files"), filepath.Join(trash, "info")
+	if err := os.MkdirAll(files, 0o700); err != nil {
+		return err
+	}
+	if err := os.MkdirAll(info, 0o700); err != nil {
+		return err
+	}
+	base := filepath.Base(path)
+	for i := 1; i < 10000; i++ {
+		name := base
+		if i > 1 {
+			name = fmt.Sprintf("%s.%d", base, i)
+		}
+		ip := filepath.Join(info, name+".trashinfo")
+		f, err := os.OpenFile(ip, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0o600)
+		if errors.Is(err, os.ErrExist) {
+			continue
+		}
+		if err != nil {
+			return err
+		}
+		u := (&url.URL{Path: infoPath}).EscapedPath()
+		_, werr := fmt.Fprintf(f, "[Trash Info]\nPath=%s\nDeletionDate=%s\n", u, time.Now().Format("2006-01-02T15:04:05"))
+		cerr := f.Close()
+		if werr != nil || cerr != nil {
+			os.Remove(ip)
+			return errors.Join(werr, cerr)
+		}
+		if err := os.Rename(path, filepath.Join(files, name)); err != nil {
+			os.Remove(ip)
+			return err
+		}
+		return nil
+	}
+	return errors.New("trash: too many items with the same name")
+}
+
+// mountTop returns the top directory of the filesystem containing path.
+func mountTop(path string, dev uint64) string {
+	cur := filepath.Dir(path)
+	for {
+		parent := filepath.Dir(cur)
+		if parent == cur {
+			return cur
+		}
+		st, err := os.Stat(parent)
+		if err != nil || st.Sys().(*syscall.Stat_t).Dev != dev {
+			return cur
+		}
+		cur = parent
+	}
+}