add(examples): split main.zig into examples which can be executed and reviewed independently

examples/container.zig

@@ -0,0 +1,114 @@
+const std = @import("std");
+const zterm = @import("zterm");
+
+const App = zterm.App(
+    union(enum) {},
+    zterm.Renderer.Direct,
+    true,
+);
+const Key = zterm.Key;
+const Layout = App.Layout;
+const Widget = App.Widget;
+
+const log = std.log.scoped(.container);
+
+pub fn main() !void {
+    errdefer |err| log.err("Application Error: {any}", .{err});
+
+    var gpa: std.heap.GeneralPurposeAllocator(.{}) = .{};
+    defer {
+        const deinit_status = gpa.deinit();
+        // fail test; can't try in defer as defer is executed after we return
+        if (deinit_status == .leak) {
+            log.err("memory leak", .{});
+        }
+    }
+    const allocator = gpa.allocator();
+
+    var app: App = .{};
+    var renderer: App.Renderer = .{};
+    // TODO: when not running fullscreen, the application needs to screen down accordingly to display the contents
+    // -> size hint how much should it use?
+
+    var layout = Layout.createFrom(layout: {
+        var stack = Layout.HContainer.init(allocator, .{
+            .{
+                Widget.createFrom(blk: {
+                    var spacer = Widget.Spacer.init();
+                    break :blk &spacer;
+                }),
+                15,
+            },
+            .{
+                Layout.createFrom(container: {
+                    var container = Layout.VContainer.init(allocator, .{
+                        .{
+                            Widget.createFrom(blk: {
+                                var spacer = Widget.Spacer.init();
+                                break :blk &spacer;
+                            }),
+                            25,
+                        },
+                        .{
+                            Widget.createFrom(blk: {
+                                const file = try std.fs.cwd().openFile("./src/app.zig", .{});
+                                defer file.close();
+                                var widget = Widget.RawText.init(allocator, file);
+                                break :blk &widget;
+                            }),
+                            50,
+                        },
+                        .{
+                            Widget.createFrom(blk: {
+                                var spacer = Widget.Spacer.init();
+                                break :blk &spacer;
+                            }),
+                            25,
+                        },
+                    });
+                    break :container &container;
+                }),
+                70,
+            },
+            .{
+                Widget.createFrom(blk: {
+                    var spacer = Widget.Spacer.init();
+                    break :blk &spacer;
+                }),
+                15,
+            },
+        });
+        break :layout &stack;
+    });
+    defer layout.deinit();
+
+    try app.start();
+    defer app.stop() catch unreachable;
+
+    // App.Event loop
+    while (true) {
+        const event = app.nextEvent();
+        log.debug("received event: {s}", .{@tagName(event)});
+
+        switch (event) {
+            .quit => break,
+            .resize => |size| {
+                renderer.resize(size);
+            },
+            .key => |key| {
+                // ctrl+c to quit
+                if (Key.matches(key, .{ .cp = 'c', .mod = .{ .ctrl = true } })) {
+                    app.quit();
+                }
+            },
+            .err => |err| {
+                log.err("Received {any} with message: {s}", .{ err.err, err.msg });
+            },
+        }
+        const events = try layout.handle(event);
+        for (events.items) |e| {
+            app.postEvent(e);
+        }
+        try layout.render(&renderer);
+    }
+}