List

import com.williamcallahan.tui4j.compat.bubbles.list.*;

// 1. Define items — implement DefaultItem for the built-in renderer
record Product(String title, String description) implements DefaultItem {
    @Override
    public String filterValue() { return title(); }
}

// 2. Create the list (width=40, height=10)
Item[] items = {
    new Product("Laptop", "High-performance laptop"),
    new Product("Smartphone", "Latest model smartphone"),
    new Product("Headphones", "Noise-canceling headphones")
};

List list = new List(items, 40, 10);

public class App implements Model {
    private List list;

    public App() {
        list = new List(items, 40, 10);
        list.setTitle("Products");
    }

    @Override
    public Command init() { return list.init(); }

    @Override
    public UpdateResult<App> update(Message msg) {
        UpdateResult<List> result = list.update(msg);
        list = result.model();
        return UpdateResult.from(this, result.command());
    }

    @Override
    public String view() { return list.view(); }
}

Item                       DefaultItem extends Item
└── filterValue()          ├── filterValue()
                           ├── title()
                           └── description()

// Minimal Item — works with a custom delegate
record SimpleItem(String name) implements Item {
    @Override
    public String filterValue() { return name(); }
}

// Full DefaultItem — works with DefaultDelegate out of the box
record ProductItem(String title, String description) implements DefaultItem {
    @Override
    public String filterValue() { return title(); }
}

import com.williamcallahan.tui4j.compat.bubbles.list.*;

public class ProductDataSource implements ListDataSource {

    private final ProductRepository repo;

    public ProductDataSource(ProductRepository repo) {
        this.repo = repo;
    }

    @Override
    public FetchedItems fetchItems(int page, int perPage, String filterValue) {
        var pageReq = PageRequest.of(page, perPage);

        var products = (filterValue == null || filterValue.isEmpty())
            ? repo.findAll(pageReq).getContent()
            : repo.findByNameContaining(filterValue, pageReq);

        var items = products.stream()
            .map(p -> new ProductItem(p.getName(), p.getDescription()))
            .map(FilteredItem::new)
            .toList();

        long total = repo.count();
        long matched = (filterValue == null || filterValue.isEmpty())
            ? total
            : repo.countByNameContaining(filterValue);
        int totalPages = (int) Math.ceil((double) total / perPage);

        return new FetchedItems(items, matched, total, totalPages);
    }
}

// Usage
List list = new List(new ProductDataSource(repo), 40, 10);

public class CompactDelegate implements ItemDelegate {

    @Override
    public String render(Item item, int index, boolean isSelected, int width) {
        String prefix = isSelected ? "> " : "  ";
        return prefix + item.filterValue();
    }

    @Override
    public int height() {
        return 1; // Lines consumed per item
    }

    @Override
    public int spacing() {
        return 0; // Blank lines between items
    }
}

// Pass the delegate at construction time
List list = new List(items, new CompactDelegate(), 40, 10);

list.setTitle("Products");
list.setShowTitle(true);
list.setShowFilter(true);
list.setFilteringEnabled(true);
list.setShowStatusBar(true);
list.setShowPagination(true);
list.setShowHelp(true);
list.setStatusMessageLifetime(Duration.ofSeconds(5));