HAXY

▄ ▄▀▀▀▀ ▀ ▄▀▀▀▀▀ ▄▀▀▀ ▄▀▀▀▄▀▀ ▄▄▀▀▀▀▄▀ ▄▀▀▄▀▀▀▀ ▀▀▀▀▀▀▀▀▄ ▀▀▀▀▀▀▀▀▀ ▄ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▄▄▀▄▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀ ▄ ▀▀▀▄▀▀▀▀▀▀▀ ▀▀▀▀▀ ▄▀▀▀▀▀▀▀▀▀▄▀▀▄ ▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▄ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▄ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▄ ▀▀▄ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ ▀▀▀▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▄▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▄▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▄▀▄ ▀▀ ▀▀▀▀▀▀▄▀▀▀▀▀▄▄▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▄▀▄▄▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀▀ ▀▀ ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀ ▀ ▀▀▀▀▀▀▀▄▄▀▀▀▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▄▄▀▀▀▄▄▀▄▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄▄▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▄▀▀▄ ▀▀▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▀

╭─────────────╮ │scroll to top│ ╰─────────────╯ ╭ ui.zig ───────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰───────────────────────────────────────────────────────────────╯

╭────╮ ╭ clone ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╮ │http│ ssh │ │ ╰────╯ ╰ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╯

.. embed/ event/ test/ ui/ command.zig diff3.zig event.zig fork.zig lib.zig main.zig main_wasm.zig patch.zig serve.zig serve_common.zig serve_http.zig serve_ssh.zig serve_ssh_protocol.zig test.zig testnet.zig try.zig ╭─────────────────────────────────╮ │ui.zig │ ╰─────────────────────────────────╯ web.zig

2151 2152 // each retained page keeps its own arena, freed when the page leaves the 2153 // stack (popped on back, evicted at cap, or on deinit). this is what keeps a 2154 // long-lived session from accumulating every page it ever visited. 2155 const Entry = struct { root: Widget, route: RoutablePage, arena: *std.heap.ArenaAllocator }; 2156 2157 // cap on retained back-history so the chain can't grow memory without bound 2158 const max_history: usize = 16; 2159 2160 pub fn init(allocator: std.mem.Allocator, session: *Session) !Nav { 2161 const arena = try allocator.create(std.heap.ArenaAllocator); 2162 arena.* = std.heap.ArenaAllocator.init(allocator); 2163 errdefer { 2164 arena.deinit(); 2165 allocator.destroy(arena); 2166 } 2167 2168 session.page_arena = arena; 2169 const route = session.data.current_page; 2170 2171 const page = try arena.allocator().create(Page); 2172 page.* = try Page.init(arena, session, route); 2173 return .{ 2174 .root = try initRoot(allocator, page, session), 2175 .route = route, 2176 .arena = arena, 2177 .history = .empty, 2178 }; 2179 } 2180 2181 pub fn deinit(self: *Nav, allocator: std.mem.Allocator) void { 2182 self.root.deinit(allocator); 2183 freeArena(allocator, self.arena); 2184 for (self.history.items) |*entry| { 2185 entry.root.deinit(allocator); 2186 freeArena(allocator, entry.arena); 2187 } 2188 self.history.deinit(allocator); 2189 } 2190 2191 fn freeArena(allocator: std.mem.Allocator, arena: *std.heap.ArenaAllocator) void { 2192 arena.deinit(); 2193 allocator.destroy(arena); 2194 } 2195 2196 // reconcile the displayed root with the session's navigation state. a 2197 // forward nav (current_page moved to a different parent page) pushes the 2198 // current root and builds the new page in a fresh arena; a back request 2199 // frees the current page and restores the previous one. when escape is 2200 // pressed with no history left we switch to the quit tab instead of quitting. 2201 pub fn sync(self: *Nav, allocator: std.mem.Allocator, session: *Session) !void { 2202 // refresh: rebuild the current page in place from a current moment 2203 if (session.refresh_requested) { 2204 session.refresh_requested = false; 2205 if (session.haxy_moment != null or session.local != null) { 2206 const arena = try allocator.create(std.heap.ArenaAllocator); 2207 arena.* = std.heap.ArenaAllocator.init(allocator); 2208 errdefer freeArena(allocator, arena); 2209 2210 session.page_arena = arena; 2211 2212 const route = session.data.current_page; 2213 const page = try arena.allocator().create(Page); 2214 page.* = try Page.init(arena, session, route); 2215 const new_root = try initRoot(allocator, page, session); 2216 2217 self.root.deinit(allocator); 2218 freeArena(allocator, self.arena); 2219 self.root = new_root; 2220 self.route = route; 2221 self.arena = arena; 2222 } 2223 return; 2224 } 2225 2226 if (session.nav_back) { 2227 session.nav_back = false; 2228 if (self.history.pop()) |entry| { 2229 self.root.deinit(allocator); 2230 freeArena(allocator, self.arena); 2231 self.root = entry.root; 2232 self.route = entry.route; 2233 self.arena = entry.arena; 2234 session.page_arena = entry.arena; 2235 session.data.current_page = entry.route; 2236 chooseAnsiArtForNavigation(session); 2237 return; 2238 } 2239 // nothing to go back to; switch to the quit confirmation 2240 const root_focus = self.root.getFocus(); 2241 var iter = root_focus.children.iterator(); 2242 while (iter.next()) |entry| { 2243 switch (entry.value_ptr.focus.kind) { 2244 .custom => |custom| if (std.mem.eql(u8, custom, Quit.tab_kind)) { 2245 root_focus.setFocus(entry.key_ptr.*); 2246 // a Stack only builds its selected child, so the quit 2247 // button isn't in the focus tree until a build runs with 2248 // the quit tab selected. build once, then send a 2249 // synthetic arrow_down to drop focus from the tab onto 2250 // the button so it's ready to confirm. 2251 try self.root.build(allocator, .{ 2252 .min_size = .{ .width = null, .height = 40 }, 2253 .max_size = .{ .width = 80, .height = null }, 2254 }, root_focus); 2255 try self.root.input(allocator, .arrow_down, root_focus); 2256 break; 2257 }, 2258 else => {}, 2259 } 2260 } 2261 return; 2262 } 2263 2264 // forward navigation: navigate() set next_page to the page to move to (a 2265 // cross-page link or tab change crossing pages) 2266 if (session.next_page) |route| { 2267 session.next_page = null; 2268 if (session.haxy_moment == null and session.local == null) return; 2269 // the page we navigated to becomes the current page 2270 session.data.current_page = route; 2271 2272 const arena = try allocator.create(std.heap.ArenaAllocator); 2273 arena.* = std.heap.ArenaAllocator.init(allocator); 2274 errdefer freeArena(allocator, arena); 2275 2276 session.page_arena = arena; 2277 2278 const page = try arena.allocator().create(Page); 2279 page.* = try Page.init(arena, session, route); 2280 const new_root = try initRoot(allocator, page, session); 2281 2282 try self.history.append(allocator, .{ .root = self.root, .route = self.route, .arena = self.arena }); 2283 // drop the oldest entry (freeing its widget tree and arena) once over cap 2284 if (self.history.items.len > max_history) { 2285 var oldest = self.history.orderedRemove(0); 2286 oldest.root.deinit(allocator); 2287 freeArena(allocator, oldest.arena); 2288 } 2289 self.root = new_root; 2290 self.route = route; 2291 self.arena = arena; 2292 } 2293 } 2294 }; 2295 2296 pub fn initRoot(allocator: std.mem.Allocator, page: *const Page, session: *Session) !Widget { 2297 const page_widget: Widget = switch (page.*) { 2298 .home => |*p| .{ .home = try .init(allocator, p, session) }, 2299 .user => |*p| .{ .user = try .init(allocator, p, session) }, 2300 .repo => |*p| .{ .repo = try .init(allocator, p, session) }, 2301 .fork => |*p| .{ .fork = try .init(allocator, p, session) }, 2302 }; 2303 2304 chooseAnsiArtForNavigation(session); 2305 2306 // on the TUI/SSH, the page sits above a one-row footer showing the url 2307 var root = if (session.is_terminal) blk: { 2308 var box = try wgt.Box(Widget).init(allocator, .{ .border_style = null, .direction = .vert }); 2309 errdefer box.deinit(allocator); 2310 const bg_id = bg_blk: { 2311 var background = try widget.AnsiBackground.init(allocator, page_widget, session); 2312 errdefer background.deinit(allocator); 2313 const id = background.getFocus().id; 2314 try box.children.put(allocator, id, .{ .widget = .{ .background = background }, .rect = null, .min_size = null }); 2315 break :bg_blk id; 2316 }; 2317 { 2318 var footer = try widget.Footer.init(allocator, session); 2319 errdefer footer.deinit(allocator); 2320 try box.children.put(allocator, footer.getFocus().id, .{ .widget = .{ .footer = footer }, .rect = null, .min_size = .{ .width = null, .height = 1 } }); 2321 } 2322 box.getFocus().child_id = bg_id; 2323 break :blk Widget{ .box = box }; 2324 } else Widget{ .background = try widget.AnsiBackground.init(allocator, page_widget, session) }; 2325 errdefer root.deinit(allocator); 2326 2327 // input-owning views build their TextInputs in init, so reset their 2328 // registrations here 2329 session.text_inputs.clearRetainingCapacity(); 2330 2331 try root.build(allocator, .{ 2332 .min_size = .{ .width = null, .height = 40 }, 2333 .max_size = .{ .width = 100, .height = null }, 2334 }, root.getFocus()); 2335 2336 return root; 2337 } 2338 2339 // native and server-side sessions choose from the embedded collection. WASM 2340 // keeps the art serialized by the server instead. 2341 fn chooseAnsiArtForNavigation(session: *Session) void { 2342 if (comptime ansi_arts.len == 0) return; 2343 const io = session.io orelse return; 2344 var random: usize = undefined; 2345 io.random(std.mem.asBytes(&random)); 2346 session.data.ansi_art = ansi_arts[random % ansi_arts.len]; 2347 } 2348