@kud/gh-ink 0.31.0 → 0.32.0

package/dist/index.d.ts

@@ -124,6 +124,22 @@ type GHItem = {
      * never about the PR. Left unset, the section id decides as before.
      */
     standing?: Standing;
+    /**
+     * A turn the viewer has claimed BY HAND, outranking everything inferred.
+     *
+     * The inference below is good and still gets things wrong in one direction it
+     * cannot see: a row can be genuinely yours while every signal says otherwise —
+     * nothing red, no unresolved thread, nobody waiting on a word from you — and
+     * no amount of reading the PR harder will discover it. That knowledge lives
+     * with the viewer, so this is the field where they put it.
+     *
+     * It is a PIN, not a correction: it applies whether or not the row was already
+     * yours, which is why it does not pair with an opposite. The other direction —
+     * "no reply is owed for this particular comment" — is a fact about one event
+     * and belongs where the events are read, not here; a host expresses it by
+     * handing back a `lastActor` that no longer claims a turn.
+     */
+    pinned?: boolean;
     indent: boolean;
 };
 type TaskRow = {
@@ -240,7 +256,7 @@ declare const sortItems: (items: GHItem[]) => GHItem[];
 declare const sortByRecency: (items: GHItem[]) => GHItem[];
 declare const insertRepoHeaders: (items: GHItem[]) => AnyItem[];
 type Standing = "authored" | "queued" | "spoken";
-declare const whoseMove: (health: Health, sectionId: string, standing?: Standing, theySpokeLast?: boolean) => "you" | "them";
+declare const whoseMove: (health: Health, sectionId: string, standing?: Standing, theySpokeLast?: boolean, pinned?: boolean) => "you" | "them";
 declare const layoutGHItems: (items: GHItem[], sectionId: string, login?: string) => AnyItem[];
 /**
  * A two-way repo split, when a host has one. `undefined` — the ordinary case —

package/dist/index.js

@@ -838,6 +838,10 @@ var checksSentence = (d) => {
   return `Checks: ${parts.join(", ")}.`;
 };
 var turnSentences = (item, login) => {
+  if (item.pinned)
+    return [
+      "You pinned this (!). It stays under Your move until you unpin it, whatever else the row says."
+    ];
   if (!item.lastActor) return ["Nothing has been said on it yet."];
   const d = item.detail;
   const when = d?.lastEventAt ? `${relativeTime(d.lastEventAt)} ago` : "earlier";
@@ -937,8 +941,9 @@ var YOURS = {
   queued: ["waiting", "pending", "threads", "approved"],
   spoken: ["threads"]
 };
-var whoseMove = (health, sectionId, standing, theySpokeLast) => {
+var whoseMove = (health, sectionId, standing, theySpokeLast, pinned) => {
   const position = standing ?? STANDING[sectionId] ?? "queued";
+  if (pinned) return "you";
   if (theySpokeLast && position === "authored") return "you";
   return YOURS[position].includes(health) ? "you" : "them";
 };
@@ -956,7 +961,8 @@ var layoutGHItems = (items, sectionId, login) => {
         i.health,
         sectionId,
         i.standing,
-        !!login && !!i.lastActor && i.lastActor !== login
+        !!login && !!i.lastActor && i.lastActor !== login,
+        i.pinned
       ) === side
     )
   }));
@@ -1845,7 +1851,7 @@ var ItemRow = ({
   const icon = merged ? MERGED_FRAMES[sparkFrame % MERGED_FRAMES.length] : transient === "out" ? TRANSIT_OUT_FRAMES[sparkFrame % TRANSIT_OUT_FRAMES.length] : transient === "in" ? TRANSIT_IN_FRAMES[sparkFrame % TRANSIT_IN_FRAMES.length] : healthIcon;
   const color = merged ? MERGED_COLOUR : transient ? TRANSIT_COLOUR[transient] : healthColor2;
   const spokeLast = !!login && !!item.lastActor && item.lastActor === login;
-  const [turnIcon, turnColor] = !login || !item.lastActor ? [" ", "white"] : spokeLast ? ["\u2192", "#888888"] : ["\u2190", "#FF8700"];
+  const [turnIcon, turnColor] = item.pinned ? ["!", "#FF8700"] : !login || !item.lastActor ? [" ", "white"] : spokeLast ? ["\u2192", "#888888"] : ["\u2190", "#FF8700"];
   const numStr = `#${item.number}`.padEnd(7);
   const showAuthor = !!item.author && item.author !== login;
   const unresolvedLabel = item.unresolved > 0 ? `\uF086 ${item.unresolved}` : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Ink components for rendering GitHub PR review comments and health — controlled, presentation-only, built on @kud/ink-ui and fed by @kud/gh.",
   "type": "module",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
     "react": ">=19"
   },
   "dependencies": {
-    "@kud/gh": "0.8.0",
+    "@kud/gh": "0.9.0",
     "@kud/ink-ui": "0.14.0",
     "zx": "8.8.5"
   },