summaryrefslogtreecommitdiff
path: root/src/ninep
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-06 00:02:06 -0300
committerGabriel Schneider <[email protected]>2026-11-06 01:21:34 -0300
commite9b4f0e1c37c5c1f369d152d0a70b672433c94b5 (patch)
treef49224e1467153c8a464bb62eb2d8b5529bc88d0 /src/ninep
parent423440f25b4b23b56162008bba35218d438767fe (diff)
downloadpardes-e9b4f0e1c37c5c1f369d152d0a70b672433c94b5.tar.gz
pardes-e9b4f0e1c37c5c1f369d152d0a70b672433c94b5.zip
kinds #3, addons: src/Addon.zig loads a library that brings a kind (each *.so of $XDG_DATA_HOME/pardes/addons, then <prefix>/lib/pardes/addons at start; `Addon load <path>`, `Addon unload <name>` refused while a pane of the kind is open, `Addon reload <name>`; bare, the kinds here), from a copy of its bytes in a memfd so a reload is the file as it is now, its BLAKE3 kept; a load is marked on disk while it runs and a start that finds the mark skips that library until `Addon load` asks again; the crash record says `in addon <file>, <call>`; Kind.zig checks a head before taking it (size, ABI major, a paint, a name, words, leader paths and extensions none else has, the core's or another addon's: refused whole, in words; ctl with words; jobs paired), and a reload checks the new library beside the old (the old kind's own names looked past), opens every pane of the kind again in a fresh arena from the old state's dump and the new load (or its place and its words' last values), and only then swaps, dropping the old library's jobs; any failure says why and leaves the old one running; /addons lists `<kind> <version> <abi> <panes open> <path> <blake3> static|loaded|refused: why`; the tail: an addon's words join /commands and Help marked `(addon <name>)`, run from exec, a ctl and a leader path after the core's, a word that opens its kind opens a pane of it from anywhere and any other goes to a pane of its kind, its ctl read ends with the kind's fields, its body is the kind's text over 9P, its keys (all but Esc, as a raw terminal's) and clicks go to it, a 9P request steps its ticks and jobs as an event does; the dump record keeps the words' last values; the size of every record is asserted in the header and seen again from Kind.zig; pa_api gains `seed` (a number the same for a pane on every machine, for a game's board), and a zero cell is an unpainted one (PA_PAINTED, which pa_put sets), so a window is cleared by one memset; the hook in the settings agent's files is one arm each: exec.zig executeBuiltinLine's miss goes to Kind.runLine, builtins.zig gains the Addon word, config.zig its leader path (none); the tree gains /addons (README and reference.typ's tree, and an Addons section), builtins-<tui|gui>.json the Addon row; no golden changes; tests: a crash mark skipped at two starts and cleared by a load (Addon.zig), the tree listing tests (tree.zig and the process suite's) with /addons; the README keeps its 45 lines
Co-Authored-By: Claude Fable 5.1 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'src/ninep')
-rw-r--r--src/ninep/ctl.zig17
-rw-r--r--src/ninep/pane.zig2
-rw-r--r--src/ninep/tree.zig27
3 files changed, 36 insertions, 10 deletions
diff --git a/src/ninep/ctl.zig b/src/ninep/ctl.zig
index 68fefbc5..a65b3562 100644
--- a/src/ninep/ctl.zig
+++ b/src/ninep/ctl.zig
@@ -408,7 +408,7 @@ fn writeQuoted(w: *std.Io.Writer, s: []const u8) !void {
try w.writeByte('\'');
}
-pub const pane_text_cap = 9 * 12 + 2 * 256 + 4 + "notcurrent ".len + 48 + "collapsed fit:height tint:filtered mode:insert ".len;
+pub const pane_text_cap = 9 * 12 + 2 * 256 + 4 + "notcurrent ".len + 48 + "collapsed fit:height tint:filtered mode:insert ".len + 129;
/// acme's winctlprint (plan9port wind.c), field for field: serial, tag
/// length, body length, isdir (1 for a directory pane), the dirty flag,
@@ -444,6 +444,11 @@ pub fn paneText(p: *Pardes, pane: *Pane, buf: []u8) []const u8 {
// PdfTint, in the words they take.
if (pane.collapsed) w.writeAll("collapsed ") catch {};
if (comptime pardes.pdf_enabled) if (pane.pdf) |pv| w.print("fit:{s} tint:{s} ", .{ @tagName(pv.fit), @tagName(pv.tint) }) catch {};
+ if (pane.addon != null) {
+ var fields: [128]u8 = undefined;
+ const kind_fields = pardes.Kind.ctlRead(pane, &fields);
+ if (kind_fields.len > 0) w.print("{s} ", .{kind_fields}) catch {};
+ }
// Last, the body's mode, which the tag shows as a box: helix's select
// is normal mode extending.
w.print("mode:{s} ", .{if (pane.body.mode == .normal and pane.body.select) "select" else @tagName(pane.body.mode)}) catch {};
@@ -521,6 +526,8 @@ fn checkBuiltin(p: *Pardes, req: Req, line: []const u8, scope: builtins.Scope) ?
const arg = if (sp) |s| std.mem.trim(u8, line[s + 1 ..], " \t") else "";
const here = if (std.meta.stringToEnum(Builtin, word)) |b| builtins.registry.here(p, b) else false;
const b = (if (here) std.meta.stringToEnum(Builtin, word) else null) orelse {
+ // An addon's word: its kind's to take or refuse as it runs.
+ if (pardes.Kind.word(word) != null) return null;
// A setting this build's frontend cannot show (Lift, GripWidth on a
// terminal, the window's own words in a terminal's view) is known,
// and says so rather than sound misspelt.
@@ -890,6 +897,14 @@ fn writeCommands(p: *const Pardes, w: *std.Io.Writer) !void {
}
try w.writeByte('\n');
}
+ // The addons' words, after the core's: `(addon <name>)` says whose.
+ for (pardes.Kind.wordsOf()) |kw| try w.print("{s}{s} {s} -- {s} (addon {s})\n", .{
+ std.mem.span(kw.w.name),
+ if (kw.w.arg != pardes.Kind.c.PA_ARG_NONE) " arg" else "",
+ if (kw.w.opens != 0) "both" else "pane",
+ if (kw.w.doc == null) "" else std.mem.span(kw.w.doc),
+ pardes.Kind.headName(kw.ops),
+ });
}
/// /commands' text (`writeCommands`), in the step's scratch.
diff --git a/src/ninep/pane.zig b/src/ninep/pane.zig
index 49fa46c6..3b982803 100644
--- a/src/ninep/pane.zig
+++ b/src/ninep/pane.zig
@@ -454,7 +454,9 @@ fn readFlag(p: *Pardes, req: Req, on: bool) Reply {
/// The text layer of the page a PDF pane shows (MuPDF's extraction, kept
/// with the page), null for any other pane.
+/// A document's text, read-only: a PDF's text layer, a kind's `body`.
fn pdfText(p: *Pardes, pane: *Pane) ?[]const u8 {
+ if (pane.addon != null) return pardes.Kind.body(pane, p.scratch.allocator()) catch null;
if (comptime !pardes.pdf_enabled) return null;
const pv = pane.pdf orelse return null;
return pv.ensureText(p.pdf_gpa);
diff --git a/src/ninep/tree.zig b/src/ninep/tree.zig
index 1b6c242e..9c3de708 100644
--- a/src/ninep/tree.zig
+++ b/src/ninep/tree.zig
@@ -265,6 +265,10 @@ pub const TopFile = enum(u5) {
/// first: `<label> <date> <size> <panes>`; `Restore <label>` brings one
/// back.
dumps,
+ /// The kinds of pane this session has, compiled in or an addon's, and
+ /// the addons refused, a line each: `<kind> <version> <abi>
+ /// static|loaded|refused: why [path]`.
+ addons,
pub fn fileName(f: TopFile) []const u8 {
return if (f == .root) "/" else @tagName(f);
@@ -274,7 +278,7 @@ pub const TopFile = enum(u5) {
return switch (f) {
.root, .pane, .col => 0o755,
.look, .exec, .log, .focus, .ctl, .tag, .tagexec, .pager => 0o666,
- .README, .index, .status, .screen, .listeners, .new, .commands, .layout, .recent, .dumps, .sessions => 0o444,
+ .README, .index, .status, .screen, .listeners, .new, .commands, .layout, .recent, .dumps, .sessions, .addons => 0o444,
.kbdin, .mousein => 0o222,
};
}
@@ -675,7 +679,7 @@ fn topSize(p: *Pardes, f: TopFile) u64 {
// frame, /pane/new until an open has a pane to name, and the index,
// layout, recent list and listeners, which a stat would otherwise
// have to build to count.
- .root, .pane, .col, .screen, .new, .layout, .index, .recent, .dumps, .listeners, .sessions, .kbdin, .mousein => 0,
+ .root, .pane, .col, .screen, .new, .layout, .index, .recent, .dumps, .addons, .listeners, .sessions, .kbdin, .mousein => 0,
.tag => cols.headerText(p, null).?.len,
.README => fs.help.len,
.status => ctl.statusText(p).len,
@@ -759,7 +763,7 @@ fn readdir(p: *Pardes, req: Req, target: Target) Reply {
.root => {
// The guide, then what describes the session, then the
// files that act, then the directories.
- inline for (.{ TopFile.README, TopFile.index, TopFile.status, TopFile.focus, TopFile.ctl, TopFile.commands, TopFile.recent, TopFile.dumps, TopFile.look, TopFile.exec, TopFile.pager, TopFile.log, TopFile.screen, TopFile.listeners, TopFile.sessions, TopFile.layout, TopFile.tag, TopFile.tagexec, TopFile.kbdin, TopFile.mousein, TopFile.pane, TopFile.col }) |t| {
+ inline for (.{ TopFile.README, TopFile.index, TopFile.status, TopFile.focus, TopFile.ctl, TopFile.commands, TopFile.recent, TopFile.dumps, TopFile.addons, TopFile.look, TopFile.exec, TopFile.pager, TopFile.log, TopFile.screen, TopFile.listeners, TopFile.sessions, TopFile.layout, TopFile.tag, TopFile.tagexec, TopFile.kbdin, TopFile.mousein, TopFile.pane, TopFile.col }) |t| {
if (skip > 0) skip -= 1 else stageDirent(out, p.gpa, @backingInt(t), t.dir(), t.fileName());
}
if (skip > 0) skip -= 1 else stageDirent(out, p.gpa, fs.os_root, true, "os");
@@ -847,7 +851,7 @@ fn open(p: *Pardes, req: Req, target: Target) Reply {
},
.screen => .{ .snapshot = null },
.log => .{ .log = .{} },
- .index, .layout, .recent, .dumps, .commands, .status, .listeners, .sessions => .{ .frozen = &.{} },
+ .index, .layout, .recent, .dumps, .addons, .commands, .status, .listeners, .sessions => .{ .frozen = &.{} },
// The root's ctl opened only to read: its settings, frozen.
.ctl => if (linesOpen(target, req)) .lines else .{ .frozen = &.{} },
else => if (linesOpen(target, req)) .lines else return .{ .tag = req.tag },
@@ -1107,6 +1111,11 @@ fn readFile(p: *Pardes, req: Req, target: Target) Reply {
pardes.panes.Output.recentText(p, &text.writer, false) catch break :recent Reply.fail(req.tag, E.NOMEM);
break :recent window(p, req, text.written());
},
+ .addons => addons: {
+ var text: std.ArrayList(u8) = .empty;
+ pardes.Kind.list(p, &text, p.scratch.allocator()) catch break :addons Reply.fail(req.tag, E.NOMEM);
+ break :addons window(p, req, text.items);
+ },
.dumps => dumps: {
// The state file read now, unless a step is out mid-syscall
// (its database is the step's): then none.
@@ -1546,13 +1555,13 @@ test "readdir lists the root and a pane directory without creating anything" {
@memcpy(top_bytes[0..top_reply.bytes.len], top_reply.bytes);
const top = th.dirents(top_bytes[0..top_reply.bytes.len], &buf);
try testing.expect(top.len >= 10);
- for ([_][]const u8{ "README", "index", "status", "focus", "ctl", "commands", "recent", "dumps", "look", "exec", "pager", "log", "screen", "listeners", "sessions", "layout", "tag", "tagexec", "kbdin", "mousein", "pane", "col", "os" }, 0..) |name, i| {
+ for ([_][]const u8{ "README", "index", "status", "focus", "ctl", "commands", "recent", "dumps", "addons", "look", "exec", "pager", "log", "screen", "listeners", "sessions", "layout", "tag", "tagexec", "kbdin", "mousein", "pane", "col", "os" }, 0..) |name, i| {
try testing.expectEqualStrings(name, top[i].name);
- try testing.expectEqual(i >= 20, top[i].dir);
+ try testing.expectEqual(i >= 21, top[i].dir);
}
- try testing.expectEqual(@backingInt(TopFile.pane), top[20].node);
- try testing.expectEqual(@backingInt(TopFile.col), top[21].node);
- try testing.expectEqual(fs.os_root, top[22].node);
+ try testing.expectEqual(@backingInt(TopFile.pane), top[21].node);
+ try testing.expectEqual(@backingInt(TopFile.col), top[22].node);
+ try testing.expectEqual(fs.os_root, top[23].node);
var idbuf: [16]u8 = undefined;
try testing.expect(th.nameAt(top, try std.fmt.bufPrint(&idbuf, "{d}", .{serial})) == null);
try testing.expect(th.nameAt(top, "self") == null);