@kud/gh-ink 0.34.0 → 0.35.0

package/dist/index.d.ts

@@ -140,6 +140,31 @@ type GHItem = {
      * handing back a `lastActor` that no longer claims a turn.
      */
     pinned?: boolean;
+    /**
+     * What this row STANDS FOR, when that differs from what it is. Absent means
+     * the row is a unit of work and is counted as one.
+     *
+     * `"container"` marks a row that exists to carry context rather than to be
+     * done: the initiative a story hangs under, drawn as a real row because it is
+     * still selectable, openable, and worth seeing until it closes — but not
+     * itself a thing on anyone's plate. Four stories under one container is four
+     * items, not five.
+     *
+     * Deliberately not `uncounted`. A host knows what a row IS; it should not have
+     * to know what the tab badge does with that, and a field named after one
+     * consumer starts lying the moment a second one reads it.
+     *
+     * Orthogonal to `depth`, which says where the row hangs rather than what it
+     * stands for. A container is a genuine depth-0 row with genuine depth-1
+     * children; spelling it as a depth would mean lying about the tree to fix a
+     * number, and every site that draws indentation reads that lie as truth.
+     *
+     * A union with one member rather than a boolean. `indent` was a boolean that
+     * turned out to need a scalar, and widening it cost a deprecation that is
+     * still in this file. Adding a second role here is additive; turning a boolean
+     * into a union is not.
+     */
+    role?: "container";
     /**
      * How deep this row hangs in the tree: 0 top level, 1 a child, 2 a
      * grandchild. Absent means 0.
@@ -165,6 +190,8 @@ type TaskRow = {
     url: string;
     status: string;
     age: string;
+    /** What this row stands for. See `GHItem.role`. */
+    role?: "container";
     /** How deep this row hangs. See `GHItem.depth`; read it through `depthOf`. */
     depth?: number;
     /** @deprecated Legacy spelling of `depth: 1`. See `GHItem.indent`. */
@@ -375,6 +402,24 @@ declare const openInTab: (cmd: string) => Promise<void>;
 declare const runInPaneHorizontal: (cmd: string) => Promise<void>;
 declare const runHere: (cmd: string) => void;
 declare const COLS: number;
+/**
+ * What the tab badge and the header total both count: rows that are somebody's
+ * work, at the top level.
+ *
+ * The exclusions are two different kinds of thing. Headers and the
+ * show-more/show-less affordances are furniture — not entities at all, which is
+ * why the search and repo filters drop them too. This function used to exclude
+ * only the two header kinds while its three siblings excluded all four, so a
+ * collapsed tail sitting at the top level counted as an item.
+ * `role: "container"` rows ARE entities, selectable and openable; they simply
+ * are not work. An epic is the case that forced the distinction: real, owned,
+ * and on screen until it closes, but the work is the stories under it, and
+ * counting it as well reported five things to do where there were four.
+ *
+ * One function, both consumers, on purpose. The badge and the whole-board total
+ * are the same claim at two scales; computed apart they drift, and a header that
+ * disagrees with the sum of its own tabs is worse than either number alone.
+ */
 declare const topLevelCount: (s: Section) => number;
 declare const drillCmd: (item: AnyItem) => string | null;
 declare const explainGhAction: (e: unknown) => string;

package/dist/index.js

@@ -1391,7 +1391,7 @@ var Backdrop = ({
   }
 ) : children });
 var topLevelCount = (s) => s.items.filter(
-  (i) => i.kind !== "repo-header" && i.kind !== "subgroup-header" && depthOf(i) === 0
+  (i) => i.kind !== "repo-header" && i.kind !== "subgroup-header" && i.kind !== "show-more" && i.kind !== "show-less" && !("role" in i && i.role === "container") && depthOf(i) === 0
 ).length;
 var drillCmd = (item) => {
   if (item.kind === "task")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.34.0",
+  "version": "0.35.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",