zterm/examples/layouts/grid.zig

const std = @import("std");
const zterm = @import("zterm");

const App = zterm.App(union(enum) {});

const log = std.log.scoped(.default);

const QuitText = struct {
    const text = "Press ctrl+c to quit.";

    pub fn element(this: *@This()) App.Element {
        return .{
            .ptr = this,
            .vtable = &.{ .content = content },
        };
    }

    fn content(ctx: *anyopaque, cells: []zterm.Cell, origin: zterm.Point, size: zterm.Point) !void {
        _ = ctx;
        std.debug.assert(cells.len == @as(usize, size.x) * @as(usize, size.y));
        _ = origin;

        const row = 2;
        const col = size.x / 2 -| (text.len / 2);
        const anchor = (row * size.x) + col;

        for (text, 0..) |cp, idx| {
            cells[anchor + idx].style.fg = .white;
            cells[anchor + idx].style.bg = .black;
            cells[anchor + idx].cp = cp;

            // NOTE do not write over the contents of this `Container`'s `Size`
            if (anchor + idx == cells.len - 1) break;
        }
    }
};

pub fn main() !void {
    errdefer |err| log.err("Application Error: {any}", .{err});

    var gpa: std.heap.GeneralPurposeAllocator(.{}) = .init;
    defer if (gpa.deinit() == .leak) log.err("memory leak", .{});

    const allocator = gpa.allocator();

    var app: App = .init;
    var renderer = zterm.Renderer.Buffered.init(allocator);
    defer renderer.deinit();

    var quit_text: QuitText = .{};
    const element = quit_text.element();

    var container = try App.Container.init(allocator, .{
        .layout = .{
            .separator = .{ .enabled = true },
            .padding = .{ .top = 5, .bottom = 3, .left = 3, .right = 3 },
            .direction = .horizontal,
        },
    }, element);
    for (0..3) |_| {
        var column = try App.Container.init(allocator, .{
            .layout = .{
                .separator = .{ .enabled = true },
                .direction = .vertical,
            },
        }, .{});
        try column.append(try App.Container.init(allocator, .{
            .rectangle = .{ .fill = .blue },
        }, .{}));
        try column.append(try App.Container.init(allocator, .{
            .rectangle = .{ .fill = .blue },
        }, .{}));
        try column.append(try App.Container.init(allocator, .{
            .rectangle = .{ .fill = .blue },
        }, .{}));
        try container.append(column);
    }
    defer container.deinit(); // also de-initializes the children

    try app.start();
    defer app.stop() catch |err| log.err("Failed to stop application: {any}", .{err});

    // event loop
    while (true) {
        const event = app.nextEvent();
        log.debug("received event: {s}", .{@tagName(event)});

        // pre event handling
        switch (event) {
            .key => |key| if (key.eql(.{ .cp = 'c', .mod = .{ .ctrl = true } })) app.quit(),
            // NOTE errors could be displayed in another container in case one was received, etc. to provide the user with feedback
            .err => |err| log.err("Received {s} with message: {s}", .{ @errorName(err.err), err.msg }),
            else => {},
        }

        // NOTE returned errors should be propagated back to the application
        container.handle(event) catch |err| app.postEvent(.{
            .err = .{
                .err = err,
                .msg = "Container Event handling failed",
            },
        });

        // post event handling
        switch (event) {
            .quit => break,
            else => {},
        }

        try renderer.resize();
        container.reposition(.{});
        container.resize(renderer.size);
        try renderer.render(@TypeOf(container), &container);
        try renderer.flush();
    }
}