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

examples/padding.zig

@@ -0,0 +1,112 @@
+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(.padding);
+
+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 padding = Layout.Padding.init(allocator, .{
+            .padding = 15,
+        }, .{
+            .layout = Layout.createFrom(framing: {
+                var framing = Layout.Framing.init(
+                    allocator,
+                    .{
+                        .style = .{
+                            .fg = .{
+                                .index = 6,
+                            },
+                        },
+                        .frame = .round,
+                        .title = .{
+                            .str = "Content in Margin",
+                            .style = .{
+                                .ul_style = .single,
+                                .ul = .{ .index = 6 },
+                                .bold = true,
+                            },
+                        },
+                    },
+                    .{
+                        .layout = Layout.createFrom(margin: {
+                            var margin = Layout.Margin.init(
+                                allocator,
+                                .{
+                                    .margin = 10,
+                                },
+                                .{
+                                    .widget = Widget.createFrom(blk: {
+                                        const file = try std.fs.cwd().openFile("./examples/padding.zig", .{});
+                                        defer file.close();
+                                        var widget = Widget.RawText.init(allocator, file);
+                                        break :blk &widget;
+                                    }),
+                                },
+                            );
+                            break :margin &margin;
+                        }),
+                    },
+                );
+                break :framing &framing;
+            }),
+        });
+        break :layout &padding;
+    });
+    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);
+    }
+}