pair-mode 0.1.1 → 0.2.1

package/README.md

@@ -1,3 +1,5 @@
+<img src="https://raw.githubusercontent.com/oFrusch/pair-mode/main/docs/images/duck.png" alt="The pair-mode duck" width="120" align="right">
+
 # pair mode
 
 #### For when your agent needs a rubber ducky.
@@ -125,9 +127,13 @@ Run this command in the directory or any subdirectory of where you are working w
 pair-mode on --web
 ```
 
-![The web review in a browser, with a note popup open under a selected span](https://raw.githubusercontent.com/oFrusch/pair-mode/main/docs/images/web.png)
+![The inline web layout, with two notes in the right margin joined to their lines by a leader](https://raw.githubusercontent.com/oFrusch/pair-mode/main/docs/images/web-inline.png)
+
+That spawns a detached watcher, binds an HTTP server on `127.0.0.1`, and prints a link carrying a random token. Drag across any text in the diff. A popup opens under the selection. Type the note and press Enter.
+
+The page opens in the layout your `layout` setting names, and `u` swaps it while you read. The inline layout puts every note in the right margin and draws a leader from the marked run to the card. The split layout threads each note under the last line it covers, and it hatches the side of a row that has no line.
 
-That spawns a detached watcher, binds an HTTP server on `127.0.0.1`, and prints a link carrying a random token. Drag across any text in the diff. A popup opens under the selection. Type the note and press Enter. Same stuff as the other solutions, just within an HTML page.
+![The split web layout, with a note threaded under the line it covers](https://raw.githubusercontent.com/oFrusch/pair-mode/main/docs/images/web-split.png)
 
 ## Configuration
 
@@ -163,8 +169,9 @@ existing config with no `editor` key now opens pair mode's own pane by default.
 
 `notes` and `layout` both describe position, and they are easy to confuse. `layout`
 controls the diff itself — split into two columns, or one inline column. `notes`
-controls only where a note you write renders — in a docked panel, or anchored next to
-the span it annotates. Setting one does not affect the other.
+controls only where a note you write renders in the pair pane — in a docked panel, or
+anchored next to the span it annotates. Setting one does not affect the other. The web
+view anchors every note, so it reads `layout` and ignores `notes`.
 
 ## License
 

package/dist/cli.js

@@ -7361,7 +7361,7 @@ var require_dist = __commonJS({
 });
 
 // src/cli/index.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 import { join as join13, resolve as resolve2 } from "node:path";
 
 // src/cli/setup/setup.ts
@@ -12156,6 +12156,7 @@ function runTui(options, io, abort) {
 var TITLE = "pair-mode watch";
 var HINT = "waiting for an edit \xB7 q quits";
 var LABEL_WIDTH = 10;
+var DUCK = ["   __", " <(o )___", "  ( ._> /", "   `---'"];
 function line(label, value, truecolor) {
   return fg(theme.fold, truecolor) + label.padEnd(LABEL_WIDTH) + RESET + value;
 }
@@ -12167,9 +12168,12 @@ function queueText(waiting) {
 }
 function renderIdle(status, width, truecolor) {
   const heading = bg(theme.chrome, truecolor) + fg(theme.statusText, truecolor) + TITLE.padEnd(width).slice(0, width) + RESET;
+  const duck = DUCK.map((row) => fg(theme.chrome, truecolor) + row + RESET);
   return [
     heading,
     "",
+    ...duck,
+    "",
     line("session", status.directory, truecolor),
     line("socket", status.socketPath, truecolor),
     line("clients", plural(status.clients, "client"), truecolor),
@@ -12597,6 +12601,8 @@ function runConfig(args, path) {
 // src/web/server.ts
 import { createServer as createServer2 } from "node:http";
 import { randomBytes as randomBytes4 } from "node:crypto";
+import { existsSync as existsSync10, readFileSync as readFileSync7 } from "node:fs";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 
 // src/web/client/bundle.ts
 var CLIENT_BUNDLE = `"use strict";
@@ -12626,10 +12632,11 @@ var PairClient = (() => {
     draftRange: () => draftRange,
     escapeHtml: () => escapeHtml,
     hiddenRows: () => hiddenRows,
+    inlineHtml: () => inlineHtml,
     labelOf: () => labelOf,
+    marginNotesHtml: () => marginNotesHtml,
     markRange: () => markRange,
     marksFor: () => marksFor,
-    notesHtml: () => notesHtml,
     numberOf: () => numberOf,
     paintCell: () => paintCell,
     quoteOf: () => quoteOf,
@@ -12661,6 +12668,9 @@ var PairClient = (() => {
   function tokensOf(row, pane) {
     return pane === "right" ? row.rightTokens : row.leftTokens;
   }
+  function other(pane) {
+    return pane === "right" ? "left" : "right";
+  }
   function numberOf(row, pane) {
     return pane === "right" ? row.rightNumber : row.leftNumber;
   }
@@ -12719,25 +12729,36 @@ var PairClient = (() => {
     });
     return hidden;
   }
+  function signOf(kind, pane) {
+    if (pane === "left") {
+      return kind === "del" || kind === "replace" ? "-" : " ";
+    }
+    return kind === "add" || kind === "replace" ? "+" : " ";
+  }
   function cellHtml(notes, row, rowIndex, pane) {
     const text = textOf(row, pane);
     const body = paintCell(text, tokensOf(row, pane), marksFor(notes, rowIndex, pane, text.length));
-    return '<td class="num ' + pane + '">' + (numberOf(row, pane) ?? "") + '</td><td class="bar ' + pane + '"></td><td class="code ' + pane + '" data-row="' + rowIndex + '" data-pane="' + pane + '">' + body + "</td>";
+    const number = numberOf(row, pane);
+    const void_ = number === null ? " void" : "";
+    return '<td class="num ' + pane + void_ + '">' + (number ?? "") + '</td><td class="sign ' + pane + void_ + '">' + signOf(row.kind, pane) + '</td><td class="code ' + pane + void_ + '" data-row="' + rowIndex + '" data-pane="' + pane + '">' + body + "</td>";
   }
   function foldsByStart(review) {
     return new Map(review.folds.map((fold, foldIndex) => [fold.start, foldIndex]));
   }
+  var SPLIT_COLUMNS = 6;
+  var INLINE_COLUMNS = 4;
+  function foldHtml(foldIndex, count, columns) {
+    return '<tr class="fold" data-fold="' + foldIndex + '"><td colspan="' + columns + '">' + count + " unchanged lines</td></tr>";
+  }
   function tableHtml(review, notes, expanded) {
     const hidden = hiddenRows(review, expanded);
     const byStart = foldsByStart(review);
-    const parts = ["<table>"];
+    const parts = ['<table class="split">'];
     review.rows.forEach((row, index) => {
       const foldIndex = byStart.get(index);
       const fold = foldIndex === void 0 ? void 0 : review.folds[foldIndex];
       if (foldIndex !== void 0 && fold !== void 0 && !expanded.has(foldIndex)) {
-        parts.push(
-          '<tr class="fold" data-fold="' + foldIndex + '"><td colspan="6">' + fold.count + " unchanged lines</td></tr>"
-        );
+        parts.push(foldHtml(foldIndex, fold.count, SPLIT_COLUMNS));
       }
       if (hidden.has(index)) {
         return;
@@ -12745,6 +12766,77 @@ var PairClient = (() => {
       parts.push(
         '<tr class="' + escapeHtml(row.kind) + '">' + cellHtml(notes, row, index, "left") + cellHtml(notes, row, index, "right") + "</tr>"
       );
+      parts.push(threadsAt(review, notes, index, SPLIT_COLUMNS));
+    });
+    parts.push("</table>");
+    return parts.join("");
+  }
+  function inlineLines(kind) {
+    if (kind === "del") {
+      return [{ pane: "left", sign: "-", kind: "del" }];
+    }
+    if (kind === "add") {
+      return [{ pane: "right", sign: "+", kind: "add" }];
+    }
+    if (kind === "replace") {
+      return [
+        { pane: "left", sign: "-", kind: "del" },
+        { pane: "right", sign: "+", kind: "add" }
+      ];
+    }
+    return [{ pane: "right", sign: " ", kind: "context" }];
+  }
+  function inlineMarks(notes, rowIndex, kind, pane, length) {
+    if (kind !== "context") {
+      return marksFor(notes, rowIndex, pane, length);
+    }
+    return [
+      ...marksFor(notes, rowIndex, "left", length),
+      ...marksFor(notes, rowIndex, "right", length)
+    ];
+  }
+  function anchorsHere(line, panes, notePane) {
+    return line.pane === notePane || !panes.includes(notePane);
+  }
+  function anchorsAt(notes, rowIndex, line, panes) {
+    return notes.map((note, index) => ({ note, index })).filter(
+      (entry) => entry.note.startRow === rowIndex && anchorsHere(line, panes, entry.note.pane)
+    ).map((entry) => entry.index);
+  }
+  function inlineRowHtml(review, notes, rowIndex, line, panes) {
+    const row = review.rows[rowIndex];
+    if (row === void 0) {
+      return "";
+    }
+    const text = textOf(row, line.pane);
+    const body = paintCell(
+      text,
+      tokensOf(row, line.pane),
+      inlineMarks(notes, rowIndex, row.kind, line.pane, text.length)
+    );
+    const anchors = anchorsAt(notes, rowIndex, line, panes);
+    const leftNumber = line.pane === "left" ? row.leftNumber ?? "" : "";
+    const rightNumber = line.pane === "right" ? row.rightNumber ?? "" : "";
+    return '<tr class="' + line.kind + '"' + (anchors.length === 0 ? "" : ' data-anchor="' + anchors.join(" ") + '"') + '><td class="num old">' + leftNumber + '</td><td class="num new">' + rightNumber + '</td><td class="sign ' + line.pane + '">' + line.sign + '</td><td class="code ' + line.pane + '" data-row="' + rowIndex + '" data-pane="' + line.pane + '">' + body + "</td></tr>";
+  }
+  function inlineHtml(review, notes, expanded) {
+    const hidden = hiddenRows(review, expanded);
+    const byStart = foldsByStart(review);
+    const parts = ['<table class="inline">'];
+    review.rows.forEach((row, index) => {
+      const foldIndex = byStart.get(index);
+      const fold = foldIndex === void 0 ? void 0 : review.folds[foldIndex];
+      if (foldIndex !== void 0 && fold !== void 0 && !expanded.has(foldIndex)) {
+        parts.push(foldHtml(foldIndex, fold.count, INLINE_COLUMNS));
+      }
+      if (hidden.has(index)) {
+        return;
+      }
+      const lines = inlineLines(row.kind);
+      const panes = lines.map((line) => line.pane);
+      lines.forEach((line) => {
+        parts.push(inlineRowHtml(review, notes, index, line, panes));
+      });
     });
     parts.push("</table>");
     return parts.join("");
@@ -12764,13 +12856,21 @@ var PairClient = (() => {
     if (startRow === void 0 || endRow === void 0) {
       return "";
     }
-    const start = numberOf(startRow, note.pane);
+    const start = numberOf(startRow, note.pane) ?? numberOf(startRow, other(note.pane));
     const end = numberOf(endRow, note.pane);
+    if (start === null) {
+      return "";
+    }
     return start === end || end === null ? "L" + start : "L" + start + "-" + end;
   }
-  function notesHtml(review, notes) {
+  function threadsAt(review, notes, rowIndex, columns) {
+    return notes.map((note, index) => ({ note, index })).filter((entry) => entry.note.endRow === rowIndex).map(
+      (entry) => '<tr class="thread"><td colspan="' + columns + '"><button class="drop" data-drop="' + entry.index + '" aria-label="Remove note">&times;</button><div class="at">' + escapeHtml(labelOf(review, entry.note)) + "</div><p>" + escapeHtml(entry.note.text) + "</p></td></tr>"
+    ).join("");
+  }
+  function marginNotesHtml(review, notes) {
     return notes.map(
-      (note, index) => '<div class="note"><button class="drop" data-drop="' + index + '">&times;</button><div class="where">' + escapeHtml(labelOf(review, note)) + '</div><div class="quote">' + escapeHtml(quoteOf(review, note)) + '</div><div class="body">' + escapeHtml(note.text) + "</div></div>"
+      (note, index) => '<div class="note" data-card="' + index + '"><button class="drop" data-drop="' + index + '" aria-label="Remove note">&times;</button><div class="at">' + escapeHtml(labelOf(review, note)) + "</div><p>" + escapeHtml(note.text) + "</p></div>"
     ).join("");
   }
   function sortedNotes(notes) {
@@ -12810,157 +12910,238 @@ var PairClient = (() => {
 var STYLE = `
 :root {
   --bg: #0d1117;
-  --panel: #12171f;
-  --line: #21262d;
+  --chrome: #10141a;
+  --rule: #1e242c;
   --text: #c9d1d9;
   --muted: ${theme.fold};
-  --chrome: ${theme.chrome};
+  --dim: #39424d;
   --add-bar: ${theme.addBar};
   --del-bar: ${theme.delBar};
-  --add-tint: rgba(63, 185, 80, 0.09);
-  --del-tint: rgba(248, 81, 73, 0.09);
+  --add-tint: rgba(63, 185, 80, 0.08);
+  --del-tint: rgba(248, 81, 73, 0.08);
   --note: ${theme.note};
-  --note-tint: rgba(210, 168, 255, 0.22);
+  --note-tint: rgba(210, 168, 255, 0.16);
+  --amber: ${theme.chrome};
+  --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
 }
 
 * { box-sizing: border-box; }
 
 body {
   margin: 0;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
   background: var(--bg);
   color: var(--text);
-  font: 13px/1.6 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font: 13px/1.6 var(--mono);
+  -webkit-font-smoothing: antialiased;
 }
 
+/* ---- chrome ---- */
+
 header {
   position: sticky;
   top: 0;
-  z-index: 3;
+  z-index: 6;
   display: flex;
-  align-items: center;
-  gap: 12px;
-  padding: 9px 14px;
+  align-items: stretch;
   background: var(--chrome);
-  color: #1f1a12;
-  font-weight: 600;
+  border-bottom: 1px solid var(--rule);
+  font-size: 12px;
 }
 
-header .path { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+header .seg { padding: 6px 13px; white-space: nowrap; }
+header .mode { display: flex; align-items: center; gap: 7px; color: var(--amber); font-weight: 700; letter-spacing: 0.1em; }
+header .mark { border-radius: 4px; }
+header .path { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; color: var(--muted); }
+header .plus { color: var(--add-bar); }
+header .minus { color: var(--del-bar); }
+header .tally { color: var(--note); }
 
-button {
-  font: inherit;
-  padding: 4px 12px;
-  border: 1px solid rgba(0, 0, 0, 0.35);
-  border-radius: 5px;
-  background: #1f1a12;
-  color: #f0e6d2;
+footer {
+  position: sticky;
+  bottom: 0;
+  z-index: 6;
+  display: flex;
+  align-items: stretch;
+  background: var(--chrome);
+  border-top: 1px solid var(--rule);
+  font-size: 11.5px;
+}
+
+footer .seg { padding: 6px 12px; color: var(--muted); white-space: nowrap; }
+footer .seg .key { color: var(--text); font-weight: 700; }
+footer .fill { flex: 1; }
+
+footer .swap { display: flex; }
+
+footer .swap button {
+  font: 400 11.5px/1.6 var(--mono);
+  padding: 6px 11px;
+  border: 0;
+  background: none;
+  color: var(--muted);
+  cursor: pointer;
+}
+
+footer .swap button:hover { color: var(--text); }
+footer .swap button[aria-pressed="true"] { background: var(--note-tint); color: var(--note); font-weight: 700; }
+
+footer .act {
+  font: 700 11.5px/1.6 var(--mono);
+  padding: 6px 14px;
+  border: 0;
   cursor: pointer;
 }
 
-button:disabled { opacity: 0.4; cursor: default; }
+footer .act:disabled { opacity: 0.35; cursor: default; }
+footer .act.ok { background: rgba(63, 185, 80, 0.16); color: var(--add-bar); }
+footer .act.ok:enabled:hover { background: var(--add-bar); color: #06140a; }
+footer .act.send { background: var(--note); color: #170f1e; }
+footer .act.send:enabled:hover { filter: brightness(1.12); }
+
+button:focus-visible, [tabindex]:focus-visible { outline: 2px solid var(--note); outline-offset: -2px; }
+
+/* ---- diff, both layouts ---- */
 
-main { display: flex; align-items: flex-start; }
+main { position: relative; flex: 1; display: flex; align-items: flex-start; }
 
 #diff { flex: 1; min-width: 0; overflow-x: auto; }
 
 table { width: 100%; border-collapse: collapse; }
 
-td { padding: 0 8px; vertical-align: top; white-space: pre; }
+td { padding: 0; vertical-align: top; white-space: pre; }
 
 td.num {
   width: 1%;
-  padding: 0 6px;
+  padding: 0 8px;
   text-align: right;
-  color: var(--muted);
+  color: var(--dim);
+  font-variant-numeric: tabular-nums;
   user-select: none;
 }
 
-td.bar { width: 3px; padding: 0; }
+td.sign { width: 1%; padding: 0 6px 0 0; text-align: center; color: var(--dim); user-select: none; }
+td.code { cursor: text; padding-right: 18px; }
 
-tr.add td.bar.right, tr.replace td.bar.right { background: var(--add-bar); }
-tr.del td.bar.left, tr.replace td.bar.left { background: var(--del-bar); }
+table.split td.code { width: 50%; }
+table.inline td.code { width: auto; }
 
-tr.add td.code.right, tr.replace td.code.right { background: var(--add-tint); }
-tr.del td.code.left, tr.replace td.code.left { background: var(--del-tint); }
+tr.add td.sign.right, tr.replace td.sign.right { color: var(--add-bar); }
+tr.del td.sign.left, tr.replace td.sign.left { color: var(--del-bar); }
+tr.add td.sign, tr.add td.code { background: var(--add-tint); }
+tr.del td.sign, tr.del td.code { background: var(--del-tint); }
+tr.replace td.sign.right, tr.replace td.code.right { background: var(--add-tint); }
+tr.replace td.sign.left, tr.replace td.code.left { background: var(--del-tint); }
 
-td.code { width: 50%; cursor: text; }
+tr.add td.void, tr.del td.void, tr.replace td.void {
+  background: repeating-linear-gradient(-45deg, transparent 0 5px, rgba(255, 255, 255, 0.022) 5px 10px);
+  cursor: default;
+}
 
 ::selection { background: rgba(88, 166, 255, 0.35); }
 
 mark.noted {
   background: var(--note-tint);
-  border-bottom: 2px solid var(--note);
   color: inherit;
-  border-radius: 2px;
+  box-shadow: inset 0 -2px 0 var(--note);
 }
 
 tr.fold td {
-  padding: 2px 8px;
-  color: var(--muted);
-  background: var(--panel);
+  padding: 3px 0 3px 18px;
+  color: var(--dim);
+  background: rgba(255, 255, 255, 0.016);
+  border-top: 1px solid var(--rule);
+  border-bottom: 1px solid var(--rule);
   cursor: pointer;
-  text-align: center;
   user-select: none;
 }
 
 tr.fold td:hover { color: var(--text); }
 
-aside {
-  position: sticky;
-  top: 40px;
-  width: 300px;
-  flex: none;
-  max-height: calc(100vh - 40px);
-  overflow-y: auto;
-  padding: 12px;
-  border-left: 1px solid var(--line);
-  background: var(--panel);
+/* ---- notes threaded under a split row ---- */
+
+tr.thread td {
+  padding: 9px 22px 10px 60px;
+  border-left: 2px solid var(--note);
+  background: rgba(210, 168, 255, 0.05);
+  white-space: normal;
 }
 
-aside h2 {
-  margin: 0 0 10px;
-  font-size: 11px;
-  letter-spacing: 0.08em;
-  color: var(--muted);
+tr.thread .at {
+  font-family: var(--mono);
+  font-size: 10.5px;
+  letter-spacing: 0.11em;
   text-transform: uppercase;
+  color: var(--note);
+}
+
+tr.thread p, .note p {
+  margin: 3px 0 0;
+  max-width: 62ch;
+  font-size: 13px;
+  line-height: 1.5;
+  color: #e7e2ea;
+}
+
+/* ---- notes in the inline margin ---- */
+
+#margin {
+  position: relative;
+  width: 320px;
+  flex: none;
+  align-self: stretch;
+  padding: 0 20px 0 4px;
 }
 
+#margin.hidden { display: none; }
+
 .note {
-  margin-bottom: 10px;
-  padding: 8px 10px;
-  border-left: 3px solid var(--note);
-  border-radius: 0 4px 4px 0;
-  background: var(--bg);
+  position: absolute;
+  left: 4px;
+  right: 20px;
+  padding-left: 14px;
+  border-left: 1px solid var(--note);
 }
 
-.note .where { color: var(--note); font-size: 11px; }
-.note .quote { margin: 3px 0; color: var(--muted); font-size: 11px; }
-.note .body { white-space: pre-wrap; }
+.note .at {
+  font-size: 10.5px;
+  letter-spacing: 0.11em;
+  text-transform: uppercase;
+  color: var(--note);
+}
+
+#leaders { position: absolute; inset: 0; pointer-events: none; z-index: 1; }
 
-.note .drop {
+.drop {
   float: right;
-  padding: 0 6px;
+  padding: 0 4px;
   border: 0;
   background: none;
-  color: var(--muted);
+  color: var(--dim);
+  font: 400 14px/1 var(--mono);
+  cursor: pointer;
 }
 
-.note .drop:hover { color: var(--del-bar); }
+.drop:hover { color: var(--del-bar); }
+
+/* ---- popup ---- */
 
 #popup {
   position: absolute;
-  z-index: 5;
+  z-index: 8;
   display: none;
-  width: 300px;
-  padding: 10px;
+  width: 320px;
+  padding: 11px;
   border: 1px solid var(--note);
-  border-radius: 6px;
-  background: var(--panel);
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
+  border-radius: 5px;
+  background: var(--chrome);
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.6);
 }
 
 #popup .quote {
-  margin-bottom: 6px;
+  margin-bottom: 7px;
   overflow: hidden;
   color: var(--muted);
   font-size: 11px;
@@ -12970,27 +13151,57 @@ aside h2 {
 
 #popup .row { display: flex; gap: 8px; margin-top: 8px; }
 
+#popup button {
+  font: 500 12px/1 var(--mono);
+  padding: 6px 12px;
+  border: 1px solid var(--rule);
+  border-radius: 4px;
+  background: none;
+  color: var(--text);
+  cursor: pointer;
+}
+
+#popup button.save { background: var(--note); border-color: var(--note); color: #170f1e; font-weight: 700; }
+
 textarea {
   width: 100%;
-  min-height: 62px;
-  padding: 6px;
-  border: 1px solid var(--line);
+  min-height: 66px;
+  padding: 7px;
+  border: 1px solid var(--rule);
   border-radius: 4px;
   background: var(--bg);
   color: var(--text);
-  font: inherit;
+  font: 13px/1.5 var(--mono);
   resize: vertical;
 }
 
-.hint { color: var(--muted); font-size: 11px; }
+.hint { color: var(--dim); font-size: 11px; }
+
+#idle { padding: 72px 24px; color: var(--dim); text-align: center; }
+#idle img { border-radius: 14px; opacity: 0.75; animation: bob 3.2s ease-in-out infinite; }
+#idle p { margin: 16px 0 0; }
 
-#idle { padding: 48px; color: var(--muted); text-align: center; }
+@keyframes bob { 50% { transform: translateY(-6px); } }
+
+@media (prefers-reduced-motion: reduce) {
+  #idle img { animation: none; }
+}
+
+@media (max-width: 900px) {
+  main { flex-wrap: wrap; }
+  #leaders { display: none; }
+  #margin { width: 100%; padding: 12px 16px; border-top: 1px solid var(--rule); }
+  .note { position: static; margin-bottom: 12px; }
+}
 `;
 var WIRING = String.raw`
 const C = PairClient;
+const assets = document.body.dataset.assets ?? "";
 const token = location.pathname.split("/")[2];
+const main = document.querySelector("main");
 const diff = document.getElementById("diff");
-const notesPanel = document.getElementById("notes");
+const margin = document.getElementById("margin");
+const leaders = document.getElementById("leaders");
 const popup = document.getElementById("popup");
 const popupQuote = document.getElementById("popup-quote");
 const popupText = document.getElementById("popup-text");
@@ -12999,37 +13210,152 @@ const popupCancel = document.getElementById("popup-cancel");
 const sendButton = document.getElementById("send");
 const approveButton = document.getElementById("approve");
 const pathLabel = document.getElementById("path");
+const tallyLabel = document.getElementById("tally");
+const plusLabel = document.getElementById("plus");
+const minusLabel = document.getElementById("minus");
 
 let review = null;
 let notes = [];
 let expanded = new Set();
 let draft = null;
+let layout = document.body.dataset.layout === "inline" ? "inline" : "split";
+
+function isInline() {
+  return layout === "inline";
+}
+
+function countKinds() {
+  let plus = 0;
+  let minus = 0;
 
-function renderNotes() {
-  if (review === null || notes.length === 0) {
-    notesPanel.innerHTML = '<div class="hint">Select any text in the diff to leave a note.</div>';
+  review.rows.forEach((row) => {
+    if (row.kind === "add" || row.kind === "replace") { plus += 1; }
+    if (row.kind === "del" || row.kind === "replace") { minus += 1; }
+  });
+
+  return { plus, minus };
+}
+
+// A leader line joins a marked run to its card, so it redraws whenever either one moves.
+function drawLeaders() {
+  if (!isInline() || review === null || notes.length === 0) {
+    leaders.innerHTML = "";
+    return;
+  }
+
+  const base = main.getBoundingClientRect();
+
+  leaders.setAttribute("viewBox", "0 0 " + base.width + " " + base.height);
+  leaders.setAttribute("width", base.width);
+  leaders.setAttribute("height", base.height);
+
+  leaders.innerHTML = notes.map((_note, index) => {
+    const row = diff.querySelector('[data-anchor~="' + index + '"]');
+    const card = margin.querySelector('[data-card="' + index + '"]');
+
+    if (row === null || card === null) {
+      return "";
+    }
+
+    // The line leaves from under the marked run, so it continues that underline and crosses no glyph.
+    const marks = row.querySelectorAll("mark.noted");
+    const ordinal = (row.dataset.anchor ?? "").split(" ").indexOf(String(index));
+    const source = marks[ordinal] ?? marks[marks.length - 1] ?? row;
+    const a = source.getBoundingClientRect();
+    const b = card.getBoundingClientRect();
+    const x1 = a.right - base.left + 5;
+    const y1 = a.bottom - base.top - 0.5;
+    const x2 = b.left - base.left;
+    const y2 = b.top - base.top;
+    const mid = x1 + (x2 - x1) * 0.55;
+
+    return '<path d="M ' + x1 + ' ' + y1 + ' C ' + mid + ' ' + y1 + ', ' + mid + ' ' + y2 + ', ' + x2 + ' ' + y2 +
+      '" fill="none" stroke="var(--note)" stroke-width="1" stroke-opacity="0.5" />' +
+      '<circle cx="' + x1 + '" cy="' + y1 + '" r="2" fill="var(--note)" fill-opacity="0.9" />';
+  }).join("");
+}
+
+// Two notes on nearby lines would overlap, so each card starts below the one before it.
+function placeCards() {
+  if (!isInline()) {
     return;
   }
 
-  notesPanel.innerHTML = C.notesHtml(review, notes);
+  const base = margin.getBoundingClientRect();
+  let floor = 0;
+
+  notes.forEach((_note, index) => {
+    const row = diff.querySelector('[data-anchor~="' + index + '"]');
+    const card = margin.querySelector('[data-card="' + index + '"]');
+
+    if (row === null || card === null) {
+      return;
+    }
+
+    const top = Math.max(row.getBoundingClientRect().bottom - base.top, floor);
+    card.style.top = top + "px";
+    floor = top + card.offsetHeight + 18;
+  });
+}
+
+function renderMargin() {
+  const wanted = isInline() && review !== null && notes.length > 0;
+
+  margin.classList.toggle("hidden", !wanted);
+  margin.innerHTML = wanted ? C.marginNotesHtml(review, notes) : "";
 }
 
 function render() {
   if (review === null) {
-    diff.innerHTML = '<div id="idle">waiting for an edit</div>';
+    diff.innerHTML =
+      '<div id="idle"><img src="' + assets + '/duck.png" alt="" width="88" height="88"><p>waiting for an edit</p></div>';
     pathLabel.textContent = "no review open";
+    plusLabel.textContent = "";
+    minusLabel.textContent = "";
+    tallyLabel.textContent = "";
     sendButton.disabled = true;
     approveButton.disabled = true;
     hidePopup();
-    renderNotes();
+    renderMargin();
+    refreshLeaders();
     return;
   }
 
+  const counts = countKinds();
+
   pathLabel.textContent = review.path;
+  plusLabel.textContent = "+" + counts.plus;
+  minusLabel.textContent = "−" + counts.minus;
+  tallyLabel.textContent = notes.length === 0 ? "" : notes.length + (notes.length === 1 ? " note" : " notes");
   sendButton.disabled = notes.length === 0;
+  sendButton.textContent = "^S send" + (notes.length === 0 ? "" : " " + notes.length);
   approveButton.disabled = false;
-  diff.innerHTML = C.tableHtml(review, notes, expanded);
-  renderNotes();
+
+  diff.innerHTML = isInline()
+    ? C.inlineHtml(review, notes, expanded)
+    : C.tableHtml(review, notes, expanded);
+
+  renderMargin();
+  refreshLeaders();
+}
+
+// A card needs its final height before anything measures it, so the placement waits for the paint.
+function refreshLeaders() {
+  requestAnimationFrame(() => {
+    placeCards();
+    drawLeaders();
+  });
+}
+
+function setLayout(next) {
+  layout = next;
+
+  document.querySelectorAll(".swap button").forEach((button) => {
+    button.setAttribute("aria-pressed", String(button.dataset.layout === next));
+  });
+
+  hidePopup();
+  render();
 }
 
 function cellOf(node) {
@@ -13063,9 +13389,11 @@ function readSelection() {
   return span === null ? null : { span, rect: range.getBoundingClientRect() };
 }
 
+// A hidden textarea still holds focus, and the key handler ignores every key while it does.
 function hidePopup() {
   popup.style.display = "none";
   popupText.value = "";
+  popupText.blur();
   draft = null;
 }
 
@@ -13074,7 +13402,7 @@ function showPopup(selected) {
   popupQuote.textContent = C.quoteOf(review, selected.span) || "(whole line)";
 
   const top = window.scrollY + selected.rect.bottom + 8;
-  const left = Math.max(8, Math.min(window.scrollX + selected.rect.left, window.innerWidth - 320));
+  const left = Math.max(8, Math.min(window.scrollX + selected.rect.left, window.innerWidth - 340));
 
   popup.style.top = top + "px";
   popup.style.left = left + "px";
@@ -13093,7 +13421,7 @@ diff.addEventListener("mouseup", () => {
 });
 
 diff.addEventListener("click", (event) => {
-  const fold = event.target.closest("[data-fold]");
+  const fold = event.target instanceof Element ? event.target.closest("[data-fold]") : null;
 
   if (fold === null) {
     return;
@@ -13131,8 +13459,8 @@ popupText.addEventListener("keydown", (event) => {
   }
 });
 
-notesPanel.addEventListener("click", (event) => {
-  const drop = event.target.closest("[data-drop]");
+document.addEventListener("click", (event) => {
+  const drop = event.target instanceof Element ? event.target.closest("[data-drop]") : null;
 
   if (drop === null) {
     return;
@@ -13143,6 +13471,44 @@ notesPanel.addEventListener("click", (event) => {
   render();
 });
 
+document.querySelectorAll(".swap button").forEach((button) => {
+  button.addEventListener("click", () => setLayout(button.dataset.layout));
+});
+
+// The pane binds u to the same swap, so the browser answers the key a pair mode user already knows.
+document.addEventListener("keydown", (event) => {
+  if (event.target === popupText || event.metaKey || event.ctrlKey || event.altKey) {
+    return;
+  }
+
+  if (event.key === "u") {
+    setLayout(isInline() ? "split" : "inline");
+  }
+});
+
+// The footer names ^S and ^Q, so both keys act rather than reaching the browser.
+document.addEventListener("keydown", (event) => {
+  if (!event.ctrlKey || event.metaKey || event.altKey || review === null) {
+    return;
+  }
+
+  if (event.key === "s" && notes.length > 0) {
+    event.preventDefault();
+    post({ id: review.id, notes });
+    return;
+  }
+
+  if (event.key === "q") {
+    event.preventDefault();
+    post({ id: review.id, notes: [] });
+  }
+});
+
+window.addEventListener("resize", () => {
+  placeCards();
+  drawLeaders();
+});
+
 function warn(message) {
   pathLabel.textContent = message;
 }
@@ -13211,34 +13577,48 @@ function inlineScript(source) {
 }
 var SCRIPT = inlineScript(`${CLIENT_BUNDLE}
 ${WIRING}`);
-function renderPage() {
+function pressed(layout, wanted) {
+  return layout === wanted ? "true" : "false";
+}
+function renderPage(layout = "split", assetBase = "") {
   return `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
+<link rel="icon" type="image/png" href="${assetBase}/favicon.png">
 <title>pair mode</title>
 <style>${STYLE}</style>
 </head>
-<body>
+<body data-layout="${layout}" data-assets="${assetBase}">
 <header>
-  <span>pair mode</span>
-  <span class="path" id="path">no review open</span>
-  <button id="approve">Approve</button>
-  <button id="send">Send notes</button>
+  <span class="seg mode"><img class="mark" src="${assetBase}/duck.png" alt="" width="18" height="18">pair</span>
+  <span class="seg path" id="path">no review open</span>
+  <span class="seg plus" id="plus"></span>
+  <span class="seg minus" id="minus"></span>
+  <span class="seg tally" id="tally"></span>
 </header>
 <main>
+  <svg id="leaders" aria-hidden="true"></svg>
   <div id="diff"></div>
-  <aside>
-    <h2>Notes</h2>
-    <div id="notes"></div>
-  </aside>
+  <div id="margin"></div>
 </main>
+<footer>
+  <span class="seg">drag to <span class="key">note</span></span>
+  <span class="seg">click a fold to <span class="key">open</span></span>
+  <span class="swap" role="group" aria-label="Layout">
+    <button data-layout="inline" aria-pressed="${pressed(layout, "inline")}">u inline</button>
+    <button data-layout="split" aria-pressed="${pressed(layout, "split")}">u split</button>
+  </span>
+  <span class="fill"></span>
+  <button class="act ok" id="approve">^Q approve</button>
+  <button class="act send" id="send">^S send</button>
+</footer>
 <div id="popup">
   <div class="quote" id="popup-quote"></div>
   <textarea id="popup-text" placeholder="What do you want to ask?"></textarea>
   <div class="row">
-    <button id="popup-save">Add note</button>
+    <button class="save" id="popup-save">Add note</button>
     <button id="popup-cancel">Cancel</button>
   </div>
   <div class="hint">Enter saves. Shift-Enter makes a new line.</div>
@@ -13285,6 +13665,15 @@ function webNotesToQuestions(review, notes) {
 var HOST = "127.0.0.1";
 var TOKEN_BYTES = 16;
 var MAX_BODY_BYTES = 1e6;
+function readAsset(name) {
+  const bundled = fileURLToPath4(new URL(`../assets/${name}`, import.meta.url));
+  const source = fileURLToPath4(new URL(`../../assets/${name}`, import.meta.url));
+  return readFileSync7(existsSync10(bundled) ? bundled : source);
+}
+var IMAGES = {
+  "favicon.png": readAsset("favicon.png"),
+  "duck.png": readAsset("duck.png")
+};
 var NOT_FOUND = 404;
 var OK = 200;
 var BAD_REQUEST = 400;
@@ -13416,7 +13805,13 @@ data: ${data}
     const url = request.url ?? "";
     if (url === base && request.method === "GET") {
       response.writeHead(OK, { "content-type": "text/html; charset=utf-8" });
-      response.end(renderPage());
+      response.end(renderPage(options.layout, base));
+      return;
+    }
+    const image = url.startsWith(`${base}/`) ? IMAGES[url.slice(base.length + 1)] : void 0;
+    if (image !== void 0 && request.method === "GET") {
+      response.writeHead(OK, { "content-type": "image/png" });
+      response.end(image);
       return;
     }
     if (url === `${base}/events` && request.method === "GET") {
@@ -13516,6 +13911,7 @@ async function startWebWatch(options, config) {
   const web = await startWebServer({
     port: options.port,
     token: options.token,
+    layout: config.layout,
     onVerdict(id, questions) {
       client.write(encode({ type: "verdict", id, questions }));
     }
@@ -13584,7 +13980,7 @@ Commands:
 function readVersion() {
   const pkgPath = join13(installRoot(), "package.json");
   try {
-    const raw = JSON.parse(readFileSync7(pkgPath, "utf-8"));
+    const raw = JSON.parse(readFileSync8(pkgPath, "utf-8"));
     if (isRecord(raw) && typeof raw["version"] === "string") {
       return raw["version"];
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pair-mode",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Annotate a coding agent's proposed edits line by line, in your terminal.",
   "keywords": [
     "ai",