╭─────────────╮ │scroll to top│ ╰─────────────╯ ╭ Comment.zig ──────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰───────────────────────────────────────────────────────────────╯
╭────╮ ╭ clone ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╮ │http│ ssh │ │ ╰────╯ ╰ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ╯
28 count: usize, 29 30 pub const empty: Window = .{ .comments = &.{}, .start = 0, .count = 0 }; 31 }; 32 33 pub const Permalink = struct { 34 selected: CommentWithId, 35 replies: Window, 36 }; 37 38 // read a comment permalink and one window of its immediate replies. 39 pub fn init( 40 comptime hash_kind: hash.HashKind, 41 arena: *std.heap.ArenaAllocator, 42 admin_moment: ?evt.AdminDB.HashMap(.read_only), 43 haxy_moment: evt.EventDB(hash_kind).HashMap(.read_only), 44 thread_id: []const u8, 45 selected_id: []const u8, 46 start: usize, 47 viewer: ?ui.Viewer, 48 ) !Permalink { 49 const selected = (try readOne(hash_kind, arena, admin_moment, haxy_moment, selected_id, viewer)) orelse return error.NotFound; 50 if (!std.mem.eql(u8, &selected.comment.event.thread_id, thread_id)) return error.NotFound; 51 52 return .{ 53 .selected = selected, 54 .replies = try loadWindow(hash_kind, arena, admin_moment, haxy_moment, evt.Comment.parent_id_to_comment_id_set_key, selected_id, start, viewer), 55 }; 56 } 57 58 // read one chronological comment window from an id-to-comment-set index. 59 pub fn loadWindow( 60 comptime hash_kind: hash.HashKind, 61 arena: *std.heap.ArenaAllocator, 62 admin_moment: ?evt.AdminDB.HashMap(.read_only), 63 haxy_moment: evt.EventDB(hash_kind).HashMap(.read_only), 64 index_key: []const u8, 65 owner_id: []const u8, 66 start: usize, 67 viewer: ?ui.Viewer, 68 ) !Window { 69 const DB = evt.EventDB(hash_kind); 70 const index_cursor = try haxy_moment.getCursor(hash.hashInt(hash_kind, index_key)) orelse return .{ 71 .comments = &.{}, 72 .start = start, 73 .count = 0, 74 }; 75 const index = try DB.HashMap(.read_only).init(index_cursor); 76 const set_cursor = try index.getCursor(hash.hashInt(hash_kind, owner_id)) orelse return .{ 77 .comments = &.{}, 78 .start = start, 79 .count = 0, 80 }; 81 const set = try DB.SortedSet(.read_only).init(set_cursor); 82 const count: usize = @intCast(try set.count()); 83 const end = start + @min(page_size, count -| start); 84 var iter = try set.iteratorFromIndex(start); 85 var comments: std.ArrayList(CommentWithId) = .empty; 86 var i = start; 87 while (i < end) : (i += 1) { 88 var cursor = (try iter.next()) orelse break; 89 const kv = try cursor.readKeyValuePair(); 90 var order_key: [@sizeOf(u64) + evt.event_id_size]u8 = undefined; 91 _ = try kv.key_cursor.readBytes(&order_key); 92 const id_bytes = order_key[@sizeOf(u64)..].*; 93 const entry = (try readOneBytes(hash_kind, arena, admin_moment, haxy_moment, &id_bytes, viewer)) orelse continue; 94 try comments.append(arena.allocator(), entry); 95 } 96 return .{ 97 .comments = comments.items, 98 .start = start, 99 .count = count, 100 }; 101 } 102 103 fn readOne( 104 comptime hash_kind: hash.HashKind, 105 arena: *std.heap.ArenaAllocator, 106 admin_moment: ?evt.AdminDB.HashMap(.read_only), 107 haxy_moment: evt.EventDB(hash_kind).HashMap(.read_only), 108 id: []const u8, 109 viewer: ?ui.Viewer, 110 ) !?CommentWithId { 111 const bytes = idBytes(id) orelse return null; 112 return readOneBytes(hash_kind, arena, admin_moment, haxy_moment, &bytes, viewer); 113 } 114 115 fn readOneBytes( 116 comptime hash_kind: hash.HashKind, 117 arena: *std.heap.ArenaAllocator, 118 admin_moment: ?evt.AdminDB.HashMap(.read_only), 119 haxy_moment: evt.EventDB(hash_kind).HashMap(.read_only), 120 id_bytes: *const [evt.event_id_size]u8, 121 viewer: ?ui.Viewer, 122 ) !?CommentWithId { 123 const DB = evt.EventDB(hash_kind); 124 const comment = (try evt.Comment.readById(DB, hash_kind, haxy_moment, arena, id_bytes)) orelse return null; 125 const parent_author: ?ui.Author = if (!std.mem.eql(u8, &comment.event.parent_id, &comment.event.thread_id)) blk: { 126 const parent_bytes = idBytes(&comment.event.parent_id) orelse break :blk null; 127 const parent = (try evt.readRecordSubset(evt.Comment, struct { author_email: ?[]const u8 }, DB, hash_kind, haxy_moment, arena, &parent_bytes)) orelse break :blk null; 128 break :blk try ui.Author.initFromEmail(admin_moment, arena, parent.author_email); 129 } else null; 130 return .{ 131 .id = std.fmt.bytesToHex(id_bytes.*, .lower), 132 .comment = comment, 133 .author = try ui.Author.initFromEmail(admin_moment, arena, comment.author_email), 134 .parent_author = parent_author, 135 .can_modify = if (viewer) |v| v.role.canModify(v.email, comment.author_email) else false, 136 }; 137 } 138 139 fn idBytes(id: []const u8) ?[evt.event_id_size]u8 { 140 if (id.len != evt.event_id_size * 2) return null; 141 var bytes: [evt.event_id_size]u8 = undefined; 142 _ = std.fmt.hexToBytes(&bytes, id) catch return null; 143 if (!std.mem.eql(u8, id, &std.fmt.bytesToHex(bytes, .lower))) return null; 144 return bytes; 145 } 146 147 pub const Item = struct { 148 box: wgt.Box(ui.Widget), 149 150 const metadata_index: usize = 0; 151 const body_index: usize = 1; 152 const gap_index: usize = 2; 153 154 pub fn init(allocator: std.mem.Allocator, session: *ui.Session, identity: []const u8, thread_kind: evt.EventKind, can_reply: bool, entry: CommentWithId) !Item { 155 var box = try wgt.Box(ui.Widget).init(allocator, .{ .border = null, .direction = .vert }); 156 errdefer box.deinit(allocator); 157 158 { 159 var bar = try wgt.Box(ui.Widget).init(allocator, .{ .border = null, .direction = .horiz }); 160 errdefer bar.deinit(allocator); 161 162 // the author sits on the left and the buttons on the right 163 var author = try ui.authorBox(allocator, session.page_arena, entry.author); 164 errdefer author.deinit(allocator); 165 try bar.children.put(allocator, author.getFocus().id, .{ .widget = .{ .text_box = author }, .rect = null, .min_size = null, .flex = .shrink }); 166 167 var spacer = try ui.widget.Spacer.init(allocator); 168 errdefer spacer.deinit(allocator); 169 try bar.children.put(allocator, spacer.getFocus().id, .{ .widget = .{ .spacer = spacer }, .rect = null, .min_size = null }); 170 171 if (can_reply) { 172 var reply = try linkBox(allocator, session, "new reply", commentNewRoute(thread_kind, identity, &entry.comment.event.thread_id, &entry.id) orelse return error.RouteTooLong); 173 errdefer reply.deinit(allocator); 174 try bar.children.put(allocator, reply.getFocus().id, .{ .widget = .{ .text_box = reply }, .rect = null, .min_size = .{ .width = "new reply".len + 2, .height = null } }); 175 } 176 177 if (entry.can_modify and !entry.comment.removed) { 178 var edit = try linkBox(allocator, session, "edit comment", commentEditRoute(thread_kind, identity, &entry.comment.event.thread_id, &entry.id) orelse return error.RouteTooLong); 179 errdefer edit.deinit(allocator); 180 try bar.children.put(allocator, edit.getFocus().id, .{ .widget = .{ .text_box = edit }, .rect = null, .min_size = .{ .width = "edit comment".len + 2, .height = null } }); 181 } 182 183 if (!std.mem.eql(u8, &entry.comment.event.parent_id, &entry.comment.event.thread_id)) { 184 const parent_text = if (entry.parent_author) |parent_author| switch (parent_author) { 185 .unknown => "", 186 .email, .user_name => |text| text, 187 } else ""; 188 var parent = try wgt.TextBox.init(allocator, parent_text, .{ 189 .border = .single, 190 .round_corners = true, 191 .wrap_kind = .none, 192 .top_label = .{ .text = " replying to " }, 193 }); 194 errdefer parent.deinit(allocator); 195 parent.getFocus().mode = .all; 196 const route = commentsRoute(thread_kind, identity, &entry.comment.event.thread_id, &entry.comment.event.parent_id, 0) orelse return error.RouteTooLong; 197 parent.getFocus().kind = .{ .custom = try session.page_arena.allocator().print("a:{s}", .{try route.toUrl(session.page_arena)}) }; 198 try bar.children.put(allocator, parent.getFocus().id, .{ .widget = .{ .text_box = parent }, .rect = null, .min_size = .{ .width = @max(parent_text.len, " replying to ".len) + 2, .height = null } }); 199 } 200 201 var permalink = try linkBox(allocator, session, "permalink", commentsRoute(thread_kind, identity, &entry.comment.event.thread_id, &entry.id, 0) orelse return error.RouteTooLong); 202 errdefer permalink.deinit(allocator); 203 try bar.children.put(allocator, permalink.getFocus().id, .{ .widget = .{ .text_box = permalink }, .rect = null, .min_size = .{ .width = "permalink".len + 2, .height = null } }); 204 205 if (entry.can_modify and !entry.comment.removed) { 206 var remove = try linkBox(allocator, session, "✕", removeRoute(thread_kind, identity, &entry.comment.event.thread_id, &entry.id) orelse return error.RouteTooLong); 207 errdefer remove.deinit(allocator); 208 try bar.children.put(allocator, remove.getFocus().id, .{ .widget = .{ .text_box = remove }, .rect = null, .min_size = .{ .width = 3, .height = null } }); 209 } 210 211 bar.getFocus().child_id = bar.children.keys()[0]; 212 try box.children.put(allocator, bar.getFocus().id, .{ .widget = .{ .box = bar }, .rect = null, .min_size = null }); 213 } 214 215 const body_text = if (entry.comment.removed) "(removed)" else entry.comment.event.body; 216 var body_frame = try Markdown.Frame.init(allocator, body_text, "", "", session.page_arena); 217 errdefer body_frame.deinit(allocator); 218 try box.children.put(allocator, body_frame.getFocus().id, .{ .widget = .{ .markdown_frame = body_frame }, .rect = null, .min_size = null }); 219 220 var gap = try wgt.Text.init(allocator, ""); 221 errdefer gap.deinit(allocator); 222 try box.children.put(allocator, gap.getFocus().id, .{ .widget = .{ .text = gap }, .rect = null, .min_size = null }); 223 224 box.getFocus().child_id = box.children.keys()[metadata_index]; 225 226 return .{ .box = box }; 227 } 228 229 fn metadata(self: *Item) *wgt.Box(ui.Widget) { 230 return &self.box.children.values()[metadata_index].widget.box; 231 } 232 233 pub fn body(self: *Item) *Markdown.Frame { 234 return &self.box.children.values()[body_index].widget.markdown_frame; 235 } 236 237 pub fn bodyFocused(self: *Item) bool { 238 return self.box.getFocus().child_id == self.body().getFocus().id; 239 } 240 241 pub fn focusMetadata(self: *Item, root_focus: *Focus) void { 242 const bar = self.metadata(); 243 root_focus.setFocus(bar.getFocus().child_id orelse bar.children.keys()[0]); 244 } 245 246 pub fn focusBody(self: *Item, root_focus: *Focus) void { 247 root_focus.setFocus(self.body().getFocus().id); 248 } 249 250 pub fn moveHorizontal(self: *Item, root_focus: *Focus, right: bool) bool { 251 if (self.bodyFocused()) return false; 252 const bar = self.metadata(); 253 const selected = bar.getFocus().child_id orelse return false; 254 var target = bar.children.getIndex(selected) orelse return false; 255 // step past the spacer between the author and the buttons 256 while (true) { 257 if (right) target += 1 else target = std.math.sub(usize, target, 1) catch return false; 258 if (target >= bar.children.count()) return false; 259 if (bar.children.values()[target].widget != .spacer) break; 260 } 261 root_focus.setFocus(bar.children.keys()[target]); 262 return true; 263 } 264 265 pub fn rowRect(self: *Item, body_row: bool) ?layout.IRect { 266 if (!body_row) return self.box.children.values()[metadata_index].rect; 267 var rect = self.box.children.values()[body_index].rect orelse return null; 268 if (self.box.children.values()[gap_index].rect) |gap| rect.size.height += gap.size.height; 269 return rect; 270 } 271 272 pub fn deinit(self: *Item, allocator: std.mem.Allocator) void { 273 self.box.deinit(allocator); 274 } 275 276 pub fn build(self: *Item, allocator: std.mem.Allocator, constraint: layout.Constraint, root_focus: *Focus) !void { 277 try self.box.build(allocator, constraint, root_focus); 278 } 279 280 pub fn input(self: *Item, allocator: std.mem.Allocator, key: Key, root_focus: *Focus) !void { 281 try self.box.input(allocator, key, root_focus); 282 } 283 284 pub fn clearGrid(self: *Item) void { 285 self.box.clearGrid(); 286 } 287 288 pub fn getGrid(self: Item) ?Grid { 289 return self.box.getGrid(); 290 } 291 292 pub fn getFocus(self: *Item) *Focus { 293 return self.box.getFocus(); 294 } 295 }; 296 297 // append one comment's metadata bar and body. 298 pub fn appendComment(allocator: std.mem.Allocator, box: *wgt.Box(ui.Widget), session: *ui.Session, identity: []const u8, thread_kind: evt.EventKind, can_reply: bool, entry: CommentWithId) !void { 299 var item = try Item.init(allocator, session, identity, thread_kind, can_reply, entry); 300 errdefer item.deinit(allocator); 301 try box.children.put(allocator, item.getFocus().id, .{ .widget = .{ .repo_comment = item }, .rect = null, .min_size = null }); 302 } 303 304 pub fn appendCount(allocator: std.mem.Allocator, box: *wgt.Box(ui.Widget), count: usize, singular: []const u8, plural: []const u8) !void { 305 var text_buf: [64]u8 = undefined; 306 const text = try std.fmt.bufPrint(&text_buf, "{d} {s}", .{ count, if (count == 1) singular else plural }); 307 var count_box = try wgt.TextBox.init(allocator, text, .{ .border = .hidden, .wrap_kind = .none }); 308 errdefer count_box.deinit(allocator); 309 try box.children.put(allocator, count_box.getFocus().id, .{ .widget = .{ .text_box = count_box }, .rect = null, .min_size = null }); 310 } 311 312 pub fn appendWindowNav(allocator: std.mem.Allocator, box: *wgt.Box(ui.Widget), session: *ui.Session, identity: []const u8, thread_kind: evt.EventKind, thread_id: []const u8, selected_id: ?[]const u8, window: Window) !void { 313 const has_prev = window.start > 0; 314 const has_more = window.start < window.count and window.count - window.start > page_size; 315 if (!has_prev and !has_more) return; 316 var row = try wgt.Box(ui.Widget).init(allocator, .{ .border = null, .direction = .horiz }); 317 errdefer row.deinit(allocator); 318 if (has_prev) { 319 const start = window.start -| page_size; 320 const route = commentsRoute(thread_kind, identity, thread_id, selected_id, start); 321 var previous = try linkBox(allocator, session, "← previous", route orelse return error.RouteTooLong); 322 errdefer previous.deinit(allocator); 323 try row.children.put(allocator, previous.getFocus().id, .{ .widget = .{ .text_box = previous }, .rect = null, .min_size = null }); 324 } 325 if (has_more) { 326 const start = window.start + page_size; 327 const route = commentsRoute(thread_kind, identity, thread_id, selected_id, start); 328 var next = try linkBox(allocator, session, "next →", route orelse return error.RouteTooLong); 329 errdefer next.deinit(allocator); 330 try row.children.put(allocator, next.getFocus().id, .{ .widget = .{ .text_box = next }, .rect = null, .min_size = null }); 331 } 332 row.getFocus().child_id = row.children.keys()[0]; 333 try box.children.put(allocator, row.getFocus().id, .{ .widget = .{ .box = row }, .rect = null, .min_size = null }); 334 } 335 336 fn commentsRoute(kind: evt.EventKind, identity: []const u8, thread_id: []const u8, selected_id: ?[]const u8, start: usize) ?ui.RoutablePage { 337 return if (selected_id) |id| 338 ui.RoutablePage.repoThreadCommentRoute(kind, identity, thread_id, id, start) 339 else 340 ui.RoutablePage.repoThreadCommentsRoute(kind, identity, thread_id, start); 341 } 342 343 fn commentNewRoute(kind: evt.EventKind, identity: []const u8, thread_id: []const u8, parent_id: []const u8) ?ui.RoutablePage { 344 return ui.RoutablePage.repoThreadCommentNewRoute(kind, identity, thread_id, parent_id); 345 } 346 347 fn commentEditRoute(kind: evt.EventKind, identity: []const u8, thread_id: []const u8, comment_id: []const u8) ?ui.RoutablePage { 348 return ui.RoutablePage.repoThreadCommentEditRoute(kind, identity, thread_id, comment_id); 349 } 350 351 fn removeRoute(kind: evt.EventKind, identity: []const u8, thread_id: []const u8, comment_id: []const u8) ?ui.RoutablePage { 352 return ui.RoutablePage.repoThreadRemoveRoute(kind, identity, thread_id, comment_id); 353 } 354 355 pub fn linkBox(allocator: std.mem.Allocator, session: *ui.Session, text: []const u8, route: ui.RoutablePage) !wgt.TextBox { 356 var box = try wgt.TextBox.init(allocator, text, .{ .border = .single, .round_corners = true, .wrap_kind = .none }); 357 errdefer box.deinit(allocator); 358 box.getFocus().mode = .all; 359 box.getFocus().kind = .{ .custom = try session.page_arena.allocator().print("a:{s}", .{try route.toUrl(session.page_arena)}) }; 360 return box; 361 } 362